molted agents

molted agents register --agent-name "outreach-agent" --agent-role outbound \
  --metadata '{"version": "1.0", "owner": "team-a"}'
# → { "id": "agent_...", ..., "apiKeyBinding": "bound" }
# By default this binds your API key to the new agent (#1945), so
# 'molted agents update-config' for this agent applies to this key's sends.
# Binding is PERMANENT for a key: apiKeyBinding is "already_bound" on a
# re-register, "bound_to_other_agent" if this key is already bound
# elsewhere, or "agent_has_other_key" if a different key already answers
# for this agent -- in either case nothing is re-pointed, a warning prints
# on stderr, and the command still exits 0 (registration itself succeeded).
# To use a different agent, register a new API key. "not_requested" is
# --no-bind-key; "not_applicable" means there was no API key to bind.

molted agents heartbeat --agent-id <id>
molted agents heartbeat --agent-name "outreach-agent"
# → { "ok": true }
# Only agents with a heartbeat (or register) in the last 5 minutes count
# toward a consensus majority.

molted agents lease --agent-id <id> --contact-email alice@example.com \
  --intent outbound_sales --duration 30
# → { "id": "<uuid>", "agentId": "agent_...", "contactEmail": "alice@example.com",
#     "intent": "outbound_sales", "expiresAt": "...", ... }
# → if another agent holds the lease (still a success response):
#   { "conflict": true, "leaseHolder": { "agentId": "...", "agentName": "...", "expiresAt": "..." } }
# Leasing again with the same agent extends its lease.

molted agents release-lease <leaseId>     # release early when done → { "released": true }
molted agents leases                       # list all active leases

molted agents consensus create --agent-id <id> --action "pause campaign" \
  --contact-email ceo@bigcorp.com --reason "Fatigue scores are high"
# → { "id": "<uuid>", "action": "pause campaign", "status": "pending", "timeoutAt": "...", ... }

molted agents consensus get <consensusId>
# → { "id": "<uuid>", "action": "pause campaign", "status": "pending", ... }

molted agents consensus vote <consensusId> \
  --agent-id <id> --vote "approve" --reason "Agreed"
# → { "id": "<uuid>", "vote": "approve", "consensusStatus": "pending", ... }
# consensusStatus turns "approved" or "rejected" once that side has votes from
# at least half of the active agents (rounded up). A second vote from the same
# agent replaces its first. A request still pending at timeoutAt turns
# "expired" within about 15 minutes (a background sweep); until then it stays
# "pending" and takes votes. Statuses: pending, approved, rejected, expired.
# Votes cast after a decision or expiry are still counted and can change it.

molted agents config <agentId>
molted agents update-config <agentId> --config '{"humanizer_enabled": false}'
# Keys: humanizer_enabled, humanizer_style (others are dropped; a config with
# no known key fails). Merged into the stored config. Turning the humanizer off
# is always allowed; any other change is a human decision (human gate), and
# turning it on needs a plan that includes it.

molted agents register [options]

molted agents heartbeat [options]

molted agents lease [options]

molted agents release-lease <id>

molted agents leases

molted agents consensus create [options]

molted agents consensus get <id>

molted agents consensus vote [options] <id>

molted agents config <agentId>

molted agents update-config [options] <agentId>