Added value: +{
+  "description": "Busy Codex defaults to Return steering at the next tool call; queue opts into Tab after-turn delivery. Neither pending state is delivered.",
+  "enum": [
+    "steer",
+    "queue"
+  ],
+  "type": "string"
+}

Previous value: -[
-  "submitted",
-  "typed",
-  "queued",
-  "queued_followup",
-  "rescued",
-  "failed",
-  "pending_verify",
-  "failed_confirmed",
-  "stalled_queue"
-]New value: +[
+  "submitted",
+  "typed",
+  "queued",
+  "steer_pending",
+  "queued_followup",
+  "rescued",
+  "failed",
+  "pending_verify",
+  "failed_confirmed",
+  "stalled_queue"
+]

Previous value: -[
-  "submitted",
-  "typed",
-  "queued",
-  "queued_followup",
-  "rescued",
-  "failed",
-  "pending_verify",
-  "failed_confirmed",
-  "stalled_queue"
-]New value: +[
+  "submitted",
+  "typed",
+  "queued",
+  "steer_pending",
+  "queued_followup",
+  "rescued",
+  "failed",
+  "pending_verify",
+  "failed_confirmed",
+  "stalled_queue"
+]

Previous value: -[
-  "ok",
-  "retry_count"
-]New value: +[
+  "ok"
+]

Previous value: -"Optional readable prompt-file path. Checked before spawning; multiline or over-cap files are submitted as one `Read and follow <path>` pointer and one final return after readiness. Mutually exclusive with prompt."New value: +"New spawn only; omit on resume. Optional readable prompt-file path. Checked before spawning; multiline or over-cap files are submitted as one `Read and follow <path>` pointer and one final return after readiness. Mutually exclusive with prompt."

Previous value: -"CLI tool to launch"New value: +"New spawn only; omit on resume. CLI tool to launch"

Removed value: -false

Previous value: -"Leave focus on the created agent tab instead of restoring the exact origin after initialization."New value: +"Leave focus on the created tab instead of restoring the exact origin after initialization. Resume and bare terminals: false forbids focus and fails closed if background initialization is unavailable; omitted may temporarily focus to initialize, then restore the origin. Fresh managed agents retain legacy initialization focus."

Previous value: -"Max 2-3 short lines. Longer payloads BREAK the receiving pane — write the payload to a file and send one line: `Read and follow <path>`. Inline task prompt to send after the agent is ready. Capped at 500 inline UTF-8 bytes by default; use boot_prompt_path for larger prompts. Mutually exclusive with boot_prompt_path."New value: +"Max 2-3 short lines. Longer payloads BREAK the receiving pane — write the payload to a file and send one line: `Read and follow <path>`. New spawn only; omit on resume and send a new task separately with send_to after checking readiness. Inline task prompt to send after the agent is ready. Capped at 500 inline UTF-8 bytes by default; use boot_prompt_path for larger prompts. Mutually exclusive with boot_prompt_path."

Previous value: -"Repository name (e.g. 'brainlayer', 'golems')"New value: +"New spawn only; omit on resume. Repository name (e.g. 'brainlayer', 'golems')"

Previous value: -"Optional ABSOLUTE override for the engine-issued report path. Omit in almost all cases: the engine issues ~/.cmux/agents/<agent_id>/report.md, returns it here, and verifies closure against it. Pass a distinct FILE path per child (never a directory) to place a report somewhere you already watch. Check coordination_footer_delivered. For resume_agent_id calls, false means the pointer was deliberately not re-delivered: follow coordination_footer_note and relay only if the restored session lost its original context. For new spawns, if false and contract_path is present, folded pointer submission was queued or unverified. Inspect the pane, then relay with send_to({agent_id, text:\"Read and follow <contract_path>\", press_enter:true}); do not use raw cmux send/send-key. If false and contract_path is absent, inline mode is active or the contract file could not be written, so YOU must relay report_path and done_marker."New value: +"Optional ABSOLUTE override for the engine-issued report path. Omit in almost all cases: the engine issues ~/.cmux/agents/<agent_id>/report.md and verifies closure against it. Pass a distinct FILE path per child (never a directory) to place a report somewhere you already watch. report_path, done_marker, contract_path, coordination_footer_delivered and coordination_footer_note are verbose:true-only fields; the default warning contains any required relay instruction with its exact issued paths or marker. For resume_agent_id calls, coordination_footer_note is folded into warning: the pointer was deliberately not re-delivered, so relay only if the restored session lost its original context. For new spawns, when contract_path is present and folded pointer submission was queued or unverified, warning includes the pointer. Inspect the pane, then relay with send_to({agent_id, text:\"Read and follow <contract_path>\", press_enter:true}); do not use raw cmux send/send-key. When contract_path is absent, inline mode is active or the contract file could not be written, so warning tells YOU to relay report_path and done_marker."

Previous value: -"THE way to revive an agent: resume this captured session on a fresh surface, keeping its public agent ID and re-issuing its coordination contract. cmuxlayer never revives a pane by itself (#492) -- a pane you close stays closed -- so a lead that wants an agent back asks here, by id. Refused with a reason when the session transcript is not on disk, rather than opening an empty pane. Mutually exclusive with new-spawn fields."New value: +"THE way to revive an agent: resume this captured session on a fresh surface, keeping its public agent ID and re-issuing its coordination contract. cmuxlayer never revives a pane by itself (#492) -- a pane you close stays closed -- so a lead that wants an agent back asks here, by id. Refused with a reason when the session transcript is not on disk, rather than opening an empty pane. Use {resume_agent_id:\"...\"}; omit all new-spawn fields listed in the tool description. Optional resume controls remain supported. Check current readiness before sending a new task separately with send_to; no task is automatically resent."

Previous value: -"Agent job function: implementor, reviewer, or gatherer. Legacy orchestrator/worker aliases remain accepted for compatibility. Claude requires this field explicitly."New value: +"Agent job function: implementor, reviewer, or gatherer. Lead callers may omit it to spawn an implementor with worker authority on the right by default; explicit roles and axes still apply. Legacy orchestrator/worker aliases remain accepted. Other Claude callers require an explicit role."

Previous value: -"Return the full legacy spawn response instead of the lean default."New value: +"Return the full success receipt, including contract_path, report_path, done_marker, transport, worktree, and diagnostics; defaults to at most six fields. Failures always keep full detail."

Previous value: -"string"New value: +[
+  "string",
+  "null"
+]

Previous value: -[
-  "submitted",
-  "typed",
-  "queued",
-  "queued_followup",
-  "rescued",
-  "failed",
-  "pending_verify",
-  "failed_confirmed",
-  "stalled_queue"
-]New value: +[
+  "submitted",
+  "typed",
+  "queued",
+  "steer_pending",
+  "queued_followup",
+  "rescued",
+  "failed",
+  "pending_verify",
+  "failed_confirmed",
+  "stalled_queue"
+]

Previous value: -[
-  "submitted",
-  "typed",
-  "queued",
-  "queued_followup",
-  "rescued",
-  "failed",
-  "pending_verify",
-  "failed_confirmed",
-  "stalled_queue"
-]New value: +[
+  "submitted",
+  "typed",
+  "queued",
+  "steer_pending",
+  "queued_followup",
+  "rescued",
+  "failed",
+  "pending_verify",
+  "failed_confirmed",
+  "stalled_queue"
+]

Added value: +{
+  "type": "boolean"
+}

Previous value: -[
-  "started",
-  "boot_unsubmitted"
-]New value: +[
+  "started",
+  "boot_unsubmitted",
+  "pending_verify"
+]

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}

Previous value: -[
-  "ok",
-  "retry_count"
-]New value: +[
+  "ok"
+]

Previous value: -[
-  "move",
-  "rename"
-]New value: +[
+  "move",
+  "rename",
+  "adopt_session"
+]

Added value: +{
+  "not": {}
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "pattern": "^[a-f0-9]{64}$",
+  "type": "string"
+}

Added value: +{
+  "not": {}
+}

Added value: +{
+  "not": {}
+}

Added value: +{
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "not": {}
+}

Added value: +{
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "not": {}
+}

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "current_owner_id": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "historical_owner_id": {
+      "minLength": 1,
+      "type": "string"
+    }
+  },
+  "required": [
+    "historical_owner_id",
+    "current_owner_id"
+  ],
+  "type": "object"
+}

Added value: +{
+  "not": {}
+}

Added value: +{
+  "not": {}
+}

Added value: +{
+  "not": {}
+}

Added value: +{
+  "minLength": 1,
+  "type": "string"
+}

Previous value: -[
-  "move",
-  "rename"
-]New value: +[
+  "move",
+  "rename",
+  "adopt_session"
+]

Previous value: -[
-  "submitted",
-  "typed",
-  "queued",
-  "queued_followup",
-  "rescued",
-  "failed",
-  "pending_verify",
-  "failed_confirmed",
-  "stalled_queue"
-]New value: +[
+  "submitted",
+  "typed",
+  "queued",
+  "steer_pending",
+  "queued_followup",
+  "rescued",
+  "failed",
+  "pending_verify",
+  "failed_confirmed",
+  "stalled_queue"
+]

Previous value: -[
-  "submitted",
-  "typed",
-  "queued",
-  "queued_followup",
-  "rescued",
-  "failed",
-  "pending_verify",
-  "failed_confirmed",
-  "stalled_queue"
-]New value: +[
+  "submitted",
+  "typed",
+  "queued",
+  "steer_pending",
+  "queued_followup",
+  "rescued",
+  "failed",
+  "pending_verify",
+  "failed_confirmed",
+  "stalled_queue"
+]

Previous value: -"Codex reasoning effort, passed to the repoGolem launcher. CHOOSE THIS DELIBERATELY PER MISSION — it is a cost decision, not a default to inherit. The installed launcher currently accepts: low, medium, high, xhigh, max, ultra. spawn_agent rejects other values before creating a worktree or surface. The live launcher defaults to HIGH when omitted (~/.config/ralphtools/golem-dispatch.zsh). Per /agent-routing, MEDIUM is the settled floor for well-specified implementation lanes — use it unless the task genuinely needs more; xhigh and above burn budget fast and are rarely warranted for a lane with a clear brief."New value: +"Required for codex new agent spawns: low, medium, high, xhigh, max, ultra. Choose deliberately: medium for well-specified lanes, high for security/open-ended; xhigh and above cost more. Omit on resume (the session keeps its effort) and for other CLIs (effort is invalid)."

Previous value: -[
-  "low",
-  "medium",
-  "high",
-  "xhigh",
-  "max",
-  "ultra"
-]New value: +[
+  "low",
+  "medium",
+  "high",
+  "xhigh",
+  "max",
+  "ultra",
+  ""
+]

Previous value: -"With resume_agent_id only: override inconclusive recorded-process liveness after the caller deliberately verifies the old agent is gone. Does not bypass session or terminal-state requirements."New value: +"With resume_agent_id only: override missing or inconclusive proof that the old session is not running (no recorded pid, an unproven pid, an unreadable topology or process table) after the caller deliberately verifies the old agent is gone. Does not bypass session or terminal-state requirements."

Previous value: -"Optional ABSOLUTE override for the engine-issued report path. Omit in almost all cases: the engine issues ~/.cmux/agents/<agent_id>/report.md, returns it here, and verifies closure against it. Pass a distinct FILE path per child (never a directory) to place a report somewhere you already watch. Check coordination_footer_delivered. For resume_agent_id calls, false means the pointer was deliberately not re-delivered: follow coordination_footer_note and relay only if the restored session lost its original context. For new spawns, if false and contract_path is present, folded pointer submission was queued or unverified, so YOU must relay contract_path, report_path, and done_marker. If false and contract_path is absent, inline mode is active or the contract file could not be written, so YOU must relay report_path and done_marker."New value: +"Optional ABSOLUTE override for the engine-issued report path. Omit in almost all cases: the engine issues ~/.cmux/agents/<agent_id>/report.md, returns it here, and verifies closure against it. Pass a distinct FILE path per child (never a directory) to place a report somewhere you already watch. Check coordination_footer_delivered. For resume_agent_id calls, false means the pointer was deliberately not re-delivered: follow coordination_footer_note and relay only if the restored session lost its original context. For new spawns, if false and contract_path is present, folded pointer submission was queued or unverified. Inspect the pane, then relay with send_to({agent_id, text:\"Read and follow <contract_path>\", press_enter:true}); do not use raw cmux send/send-key. If false and contract_path is absent, inline mode is active or the contract file could not be written, so YOU must relay report_path and done_marker."

Previous value: -"With done_marker and agent_id: file-backed done. Matches when this ABSOLUTE file's final non-empty line equals done_marker, the same report contract spawn_agent issues. After symlinks resolve it must sit under ~/.cmux/ or ~/.cmux/agents/<agent_id>/, else refused."New value: +"With done_marker and agent_id: file-backed done. Matches when this ABSOLUTE file's final non-empty line equals done_marker, the same report contract spawn_agent issues. After symlinks resolve it must be a regular file (max 1 MiB) under ~/.cmux/agents/<agent_id>/ or ~/.cmux/live-harness/, else refused. An agent in error never matches."

Added value: +{
+  "description": "Managed agent ID",
+  "type": "string"
+}

Added value: +{
+  "default": false,
+  "description": "Close even when the backing agent is still live (not done/error). This never bypasses stable surface identity checks. Without force, a live agent's surface is protected and the response returns the current pane contents instead of closing.",
+  "type": "boolean"
+}

Added value: +{
+  "default": "surface",
+  "enum": [
+    "surface",
+    "agent",
+    "workspace"
+  ],
+  "type": "string"
+}

Removed value: -[
-  "surface"
-]

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": true,
+  "properties": {
+    "agent_id": {
+      "type": "string"
+    },
+    "agents": {
+      "items": {
+        "additionalProperties": {},
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "caller_workspace": {
+      "type": "boolean"
+    },
+    "collapse_pane": {
+      "type": "boolean"
+    },
+    "force": {
+      "type": "boolean"
+    },
+    "live_agents": {
+      "items": {
+        "additionalProperties": {},
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "pane": {
+      "type": "string"
+    },
+    "refused": {
+      "type": "boolean"
+    },
+    "removed": {
+      "additionalProperties": {},
+      "type": "object"
+    },
+    "retry_count": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "scope": {
+      "enum": [
+        "surface",
+        "agent",
+        "workspace"
+      ],
+      "type": "string"
+    },
+    "state": {
+      "type": "string"
+    },
+    "surface": {
+      "type": "string"
+    },
+    "surfaces": {
+      "items": {
+        "additionalProperties": {},
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "workspace": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "ok",
+    "retry_count"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Return only these agent IDs",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Return only agents whose registry records show a live prompt blocker",
+  "type": "boolean"
+}

Added value: +{
+  "default": "summary",
+  "description": "summary (default): flat addressable scalar rows. full: provenance, health diagnostics, the full registry record, and up to 20 unresolved or attention delivery receipts.",
+  "enum": [
+    "summary",
+    "full"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Maximum acceptable snapshot age in milliseconds (0-5000); topology changes always invalidate the snapshot",
+  "maximum": 5000,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "default": false,
+  "description": "Return direct children of the calling agent",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Return direct children of this agent",
+  "type": "string"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": true,
+  "properties": {
+    "agents": {
+      "items": {
+        "additionalProperties": {},
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "count": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "derived_at": {
+      "type": "number"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "retry_count": {
+      "minimum": 0,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "ok",
+    "retry_count"
+  ],
+  "type": "object"
+}

Added value: +{
+  "default": false,
+  "description": "Return all raw cmux fields instead of the condensed default. This materially increases token usage and is rarely needed; use it only when a specific raw field is required.",
+  "type": "boolean"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": true,
+  "properties": {
+    "column_count": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "retry_count": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "surfaces": {
+      "items": {
+        "additionalProperties": {},
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "workspaces": {
+      "items": {
+        "additionalProperties": {},
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "ok",
+    "retry_count"
+  ],
+  "type": "object"
+}

Added value: +{
+  "default": false,
+  "description": "If true, return only parsed fields (omit screen content). Best for agent monitoring.",
+  "type": "boolean"
+}

Added value: +{
+  "default": false,
+  "description": "If true, include the full untrimmed terminal content (separators, status-bar art, all lines). Default false returns a compact de-chromed screen_preview instead.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Alias for `surface`, as emitted by list_agents/spawn_agent.",
+  "type": "string"
+}

Removed value: -[
-  "surface"
-]

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": true,
+  "properties": {
+    "ok": {
+      "type": "boolean"
+    },
+    "parsed": {
+      "additionalProperties": {},
+      "type": "object"
+    },
+    "retry_count": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "surface": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "ok",
+    "retry_count"
+  ],
+  "type": "object"
+}

Added value: +{
+  "default": false,
+  "description": "Bypass the inline prompt length cap for a deliberate raw boot-prompt send. Prefer boot_prompt_path for large prompts.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Authority axis, independent from job function and placement",
+  "enum": [
+    "lead",
+    "worker"
+  ],
+  "type": "string"
+}

Added value: +{
+  "default": false,
+  "description": "Deprecated compatibility flag. TASK_DONE updates agent state only; cmuxlayer does not auto-close panes.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Optional readable prompt-file path. Checked before spawning; multiline or over-cap files are submitted as one `Read and follow <path>` pointer and one final return after readiness. Mutually exclusive with prompt.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Optional timeout override in milliseconds for pane placement, initial shell readiness, agent launch readiness, and the boot prompt. When omitted, each phase keeps its established default (45s placement, 10s shell, 15s launch, 60s boot prompt).",
+  "exclusiveMinimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "Lead coordination file; workers inherit their parent lead collab_path unless explicitly supplied.",
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "Initial working directory for type=terminal",
+  "type": "string"
+}

Added value: +{
+  "description": "Codex reasoning effort, passed to the repoGolem launcher. CHOOSE THIS DELIBERATELY PER MISSION — it is a cost decision, not a default to inherit. The installed launcher currently accepts: low, medium, high, xhigh, max, ultra. spawn_agent rejects other values before creating a worktree or surface. The live launcher defaults to HIGH when omitted (~/.config/ralphtools/golem-dispatch.zsh). Per /agent-routing, MEDIUM is the settled floor for well-specified implementation lanes — use it unless the task genuinely needs more; xhigh and above burn budget fast and are rarely warranted for a lane with a clear brief.",
+  "enum": [
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+    "max",
+    "ultra"
+  ],
+  "type": "string"
+}

Added value: +{
+  "default": false,
+  "description": "Leave focus on the created agent tab instead of restoring the exact origin after initialization.",
+  "type": "boolean"
+}

Added value: +{
+  "default": false,
+  "description": "With resume_agent_id only: override inconclusive recorded-process liveness after the caller deliberately verifies the old agent is gone. Does not bypass session or terminal-state requirements.",
+  "type": "boolean"
+}

Added value: +{
+  "default": false,
+  "description": "When true, suppress same repo/workspace/role duplicate-lane warnings. Default false so collab leads see reusable existing agents before spawning another lane.",
+  "type": "boolean"
+}

Added value: +{
+  "default": true,
+  "description": "Notify the nearest live ancestor when this agent remains awaiting input, idle without done evidence, or wedged past its dwell threshold. Set false for deliberate debugging lanes.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Maximum cost cap in USD for this agent",
+  "type": "number"
+}

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "inherit",
+        "sterile",
+        "skill_eval"
+      ],
+      "type": "string"
+    },
+    {
+      "additionalProperties": false,
+      "properties": {
+        "exclude": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "include": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    }
+  ],
+  "description": "MCP profile hint for worktree launches. Defaults to inherit. Use sterile/skill_eval or include/exclude lists for narrower evals."
+}

Previous value: -"Model name (e.g. 'sonnet', 'codex', 'opus')"New value: +"OPTIONAL — leave UNSET so the launcher pins the top-tier model. For cli:'codex', an explicit model is checked against Codex's runtime model list before any worktree or surface is created, then passed through to the launcher. Never pass 'opus' for claude — the top Claude model is already the default."

Added value: +{
+  "description": "ID of the parent agent for hierarchical spawning. Normally inferred from the managed caller surface; pass explicitly only when no managed caller supplies the hierarchy. Parent must exist.",
+  "type": "string"
+}

Added value: +{
+  "description": "Physical placement axis: left or right. It must agree with authority (lead=left, worker=right). Legacy orchestrator/worker aliases remain accepted.",
+  "enum": [
+    "left",
+    "right",
+    "orchestrator",
+    "worker"
+  ],
+  "type": "string"
+}

Previous value: -"Task prompt to send after agent is ready"New value: +"Max 2-3 short lines. Longer payloads BREAK the receiving pane — write the payload to a file and send one line: `Read and follow <path>`. Inline task prompt to send after the agent is ready. Capped at 500 inline UTF-8 bytes by default; use boot_prompt_path for larger prompts. Mutually exclusive with boot_prompt_path."

Added value: +{
+  "description": "Optional ABSOLUTE override for the engine-issued report path. Omit in almost all cases: the engine issues ~/.cmux/agents/<agent_id>/report.md, returns it here, and verifies closure against it. Pass a distinct FILE path per child (never a directory) to place a report somewhere you already watch. Check coordination_footer_delivered. For resume_agent_id calls, false means the pointer was deliberately not re-delivered: follow coordination_footer_note and relay only if the restored session lost its original context. For new spawns, if false and contract_path is present, folded pointer submission was queued or unverified, so YOU must relay contract_path, report_path, and done_marker. If false and contract_path is absent, inline mode is active or the contract file could not be written, so YOU must relay report_path and done_marker.",
+  "type": "string"
+}

Added value: +{
+  "description": "THE way to revive an agent: resume this captured session on a fresh surface, keeping its public agent ID and re-issuing its coordination contract. cmuxlayer never revives a pane by itself (#492) -- a pane you close stays closed -- so a lead that wants an agent back asks here, by id. Refused with a reason when the session transcript is not on disk, rather than opening an empty pane. Mutually exclusive with new-spawn fields.",
+  "type": "string"
+}

Added value: +{
+  "description": "Agent job function: implementor, reviewer, or gatherer. Legacy orchestrator/worker aliases remain accepted for compatibility. Claude requires this field explicitly.",
+  "enum": [
+    "orchestrator",
+    "worker",
+    "implementor",
+    "reviewer",
+    "gatherer"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "The caller-supplied agent pane title is applied verbatim (for example `cmuxlayer-WORKER · run1 name-the-tabs`); when omitted or blank, the existing agent-id/surface fallback is retained. Managed identity comes from the agent registry, not this display title (#479/#492).",
+  "type": "string"
+}

Added value: +{
+  "default": "agent",
+  "description": "Spawn an AI agent or a plain terminal",
+  "enum": [
+    "agent",
+    "terminal"
+  ],
+  "type": "string"
+}

Added value: +{
+  "default": false,
+  "description": "Return the full legacy spawn response instead of the lean default.",
+  "type": "boolean"
+}

Added value: +{
+  "const": 1,
+  "default": 1,
+  "description": "SpawnSpec schema version",
+  "type": "number"
+}

Previous value: -"Target workspace ref"New value: +"Target workspace ref. Omit to use the caller/current workspace; pass only when intentionally spawning in a different workspace."

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "string"
+    },
+    {
+      "additionalProperties": false,
+      "properties": {
+        "base": {
+          "type": "string"
+        },
+        "branch": {
+          "type": "string"
+        },
+        "create": {
+          "type": "boolean"
+        },
+        "name": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "reuse": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    }
+  ],
+  "description": "When set, create or reuse a git worktree before launch. Pass a string such as \"tool-usage\" as the worktree name, true for a generated name, or an object with name, path, branch, base, create, and reuse. When repoGolem registers the repo with an absolute path, that path is the repo root; otherwise the root is resolved from CMUXLAYER_REPO_HOME, the running checkout, or ~/Gits. true uses <registered-root>/.worktrees/<generated-name> (legacy ~/Gits/<repo>.wt read-fallback until ~2026-09). If a later spawn step fails before a recoverable surface exists, a newly created worktree and branch are rolled back."
+}

Removed value: -[
-  "repo",
-  "model",
-  "cli",
-  "prompt"
-]

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": true,
+  "properties": {
+    "agent_id": {
+      "type": "string"
+    },
+    "boot_prompt_bytes": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "boot_prompt_delivered": {
+      "type": "boolean"
+    },
+    "boot_prompt_receipt": {
+      "$ref": "#/properties/cwd_receipt"
+    },
+    "boot_prompt_submit_verified": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "contract_path": {
+      "type": "string"
+    },
+    "coordination_footer_bytes": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "coordination_footer_delivered": {
+      "type": "boolean"
+    },
+    "coordination_footer_note": {
+      "type": "string"
+    },
+    "cwd": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "cwd_receipt": {
+      "additionalProperties": true,
+      "properties": {
+        "attention_reason": {
+          "type": "string"
+        },
+        "bytes": {
+          "minimum": 0,
+          "type": "integer"
+        },
+        "delivered": {
+          "type": "boolean"
+        },
+        "delivery": {
+          "enum": [
+            "submitted",
+            "typed",
+            "queued",
+            "queued_followup",
+            "rescued",
+            "failed",
+            "pending_verify",
+            "failed_confirmed",
+            "stalled_queue"
+          ],
+          "type": "string"
+        },
+        "delivery_id": {
+          "type": "string"
+        },
+        "delivery_state": {
+          "enum": [
+            "submitted",
+            "typed",
+            "queued",
+            "queued_followup",
+            "rescued",
+            "failed",
+            "pending_verify",
+            "failed_confirmed",
+            "stalled_queue"
+          ],
+          "type": "string"
+        },
+        "duplicate_of": {
+          "type": "string"
+        },
+        "needs_attention": {
+          "type": "boolean"
+        },
+        "prompt_bytes": {
+          "minimum": 0,
+          "type": "integer"
+        },
+        "prompt_sha256": {
+          "type": "string"
+        },
+        "prompt_warning": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "rpc_methods": {
+          "items": {
+            "enum": [
+              "surface.send_text",
+              "surface.send_key"
+            ],
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "submit_attempted": {
+          "type": "boolean"
+        },
+        "submit_dispatched": {
+          "type": "boolean"
+        },
+        "submit_evidence": {
+          "anyOf": [
+            {
+              "enum": [
+                "token_delta",
+                "transcript_echo",
+                "cleared_composer",
+                "status_only"
+              ],
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "submit_verified": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "terminal": {
+          "type": "boolean"
+        },
+        "typed": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "delivered_chars": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "done_marker": {
+      "type": "string"
+    },
+    "next_action": {
+      "type": "string"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "parent_agent_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "report_path": {
+      "type": "string"
+    },
+    "retry_count": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "role": {
+      "type": "string"
+    },
+    "spawn_state": {
+      "enum": [
+        "started",
+        "boot_unsubmitted"
+      ],
+      "type": "string"
+    },
+    "surface_id": {
+      "type": "string"
+    },
+    "title": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "type": {
+      "enum": [
+        "agent",
+        "terminal"
+      ],
+      "type": "string"
+    },
+    "update_menu_skipped": {
+      "type": "boolean"
+    },
+    "update_menu_text_hash": {
+      "type": "string"
+    },
+    "version": {
+      "const": 1,
+      "type": "number"
+    },
+    "workspace_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "ok",
+    "retry_count"
+  ],
+  "type": "object"
+}

Previous value: -"Agent ID from spawn_agent"New value: +"Single agent ID from spawn_agent"

Added value: +{
+  "description": "Alias for target_state",
+  "enum": [
+    "ready",
+    "working",
+    "idle",
+    "done",
+    "error"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Wait for a send_to delivery_id to reach a terminal outcome",
+  "type": "string"
+}

Added value: +{
+  "description": "Final-line marker for report_path",
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "Agent IDs to wait for together",
+  "items": {
+    "type": "string"
+  },
+  "minItems": 1,
+  "type": "array"
+}

Added value: +{
+  "default": false,
+  "description": "Wait for every direct child of the calling agent",
+  "type": "boolean"
+}

Added value: +{
+  "description": "With done_marker and agent_id: file-backed done. Matches when this ABSOLUTE file's final non-empty line equals done_marker, the same report contract spawn_agent issues. After symlinks resolve it must sit under ~/.cmux/ or ~/.cmux/agents/<agent_id>/, else refused.",
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "Declared WatchSpec alternative to agent_id/ids",
+  "properties": {
+    "change": {
+      "const": "content",
+      "description": "Persistent file-content change watch; mutually exclusive with predicate and marker",
+      "type": "string"
+    },
+    "deadline": {
+      "description": "Absolute Unix deadline in milliseconds",
+      "exclusiveMinimum": 0,
+      "type": "integer"
+    },
+    "marker": {
+      "description": "Literal file marker; mutually exclusive with predicate and change",
+      "minLength": 1,
+      "type": "string"
+    },
+    "notify": {
+      "description": "Opt in to the configured external notification transport",
+      "type": "boolean"
+    },
+    "owner": {
+      "description": "Agent/seat notified by the watch",
+      "minLength": 1,
+      "type": "string"
+    },
+    "predicate": {
+      "description": "Agent screen-state predicate: thinking, working, idle, done, error; mutually exclusive with marker and change",
+      "enum": [
+        "thinking",
+        "working",
+        "idle",
+        "done",
+        "error"
+      ],
+      "type": "string"
+    },
+    "target": {
+      "description": "Absolute file path or public agent_id",
+      "minLength": 1,
+      "type": "string"
+    },
+    "watermark": {
+      "description": "Prior marker count; defaults to count observed at arm time",
+      "minimum": 0,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "owner",
+    "target",
+    "deadline"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "agent_id",
-  "target_state"
-]

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": true,
+  "properties": {
+    "agent_id": {
+      "type": "string"
+    },
+    "attention_reason": {
+      "type": "string"
+    },
+    "delivered": {
+      "type": "boolean"
+    },
+    "delivery": {
+      "enum": [
+        "submitted",
+        "typed",
+        "queued",
+        "queued_followup",
+        "rescued",
+        "failed",
+        "pending_verify",
+        "failed_confirmed",
+        "stalled_queue"
+      ],
+      "type": "string"
+    },
+    "delivery_id": {
+      "type": "string"
+    },
+    "delivery_state": {
+      "enum": [
+        "submitted",
+        "typed",
+        "queued",
+        "queued_followup",
+        "rescued",
+        "failed",
+        "pending_verify",
+        "failed_confirmed",
+        "stalled_queue"
+      ],
+      "type": "string"
+    },
+    "duplicate_of": {
+      "type": "string"
+    },
+    "needs_attention": {
+      "type": "boolean"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "results": {
+      "items": {
+        "additionalProperties": {},
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "retry_count": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "rpc_methods": {
+      "items": {
+        "enum": [
+          "surface.send_text",
+          "surface.send_key"
+        ],
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "submit_attempted": {
+      "type": "boolean"
+    },
+    "submit_dispatched": {
+      "type": "boolean"
+    },
+    "submit_evidence": {
+      "anyOf": [
+        {
+          "enum": [
+            "token_delta",
+            "transcript_echo",
+            "cleared_composer",
+            "status_only"
+          ],
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "submit_verified": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "terminal": {
+      "type": "boolean"
+    },
+    "timed_out": {
+      "type": "boolean"
+    },
+    "typed": {
+      "type": "boolean"
+    },
+    "watch": {
+      "additionalProperties": {},
+      "type": "object"
+    }
+  },
+  "required": [
+    "ok",
+    "retry_count"
+  ],
+  "type": "object"
+}