runpane 2.4.130 → 2.4.131

package/dist/generated/contract.d.ts

@@ -57,6 +57,19 @@ export declare const RUNPANE_CONTRACT: {
             readonly description: "Open a Cursor Agent terminal tab and allow the initial input to drive the agent.";
         };
     };
+    readonly terminalKeys: {
+        readonly enter: "\r";
+        readonly escape: "\u001B";
+        readonly tab: "\t";
+        readonly backspace: "";
+        readonly space: " ";
+        readonly up: "\u001B[A";
+        readonly down: "\u001B[B";
+        readonly right: "\u001B[C";
+        readonly left: "\u001B[D";
+        readonly "ctrl-c": "\u0003";
+        readonly "ctrl-d": "\u0004";
+    };
     readonly commands: readonly [{
         readonly name: "help";
         readonly summary: "Show help for runpane or a specific command.";
@@ -85,185 +98,485 @@ export declare const RUNPANE_CONTRACT: {
     }, {
         readonly name: "doctor";
         readonly summary: "Run platform, release, installed Pane, daemon reachability, and remote setup diagnostics.";
+        readonly openWorld: true;
         readonly usage: readonly ["runpane doctor [--json] [--pane-dir <path>] [--pane-path <path>] [--format <format>] [--verbose]", "runpane doctor --report [--title <text>] --body-file <path|-> [--yes] [--json]"];
+        readonly toolsets: readonly ["core", "admin"];
         readonly jsonSchemas: readonly ["doctorResult"];
     }, {
         readonly name: "daemon repair";
         readonly summary: "Repair and restart the managed remote-daemon launcher without changing pairing or tunnel configuration.";
         readonly usage: readonly ["runpane daemon repair [--pane-dir <path>] [--pane-path <path>] [--yes] [--json]"];
         readonly mutates: true;
+        readonly toolsets: readonly ["admin"];
         readonly jsonSchemas: readonly ["daemonRepairResult"];
     }, {
         readonly name: "agents doctor";
         readonly summary: "Diagnose whether a built-in agent command is available in a Pane repository environment.";
         readonly usage: readonly ["runpane agents doctor --agent <codex|claude|cursor> [--repo <selector>] [--json]"];
+        readonly toolsets: readonly ["admin"];
         readonly jsonSchemas: readonly ["agentDoctorResult"];
     }, {
         readonly name: "agent-context";
         readonly summary: "Print token-efficient Pane command context for coding agents.";
         readonly usage: readonly ["runpane agent-context [--json]", "runpane agent-context --command <command> [--json]"];
+        readonly toolsets: readonly ["admin", "docs"];
         readonly jsonSchemas: readonly ["agentContextBriefResult", "agentContextCommandResult"];
+    }, {
+        readonly name: "mcp";
+        readonly summary: "Run the Pane MCP server over stdio so coding agents can call runpane commands as tools.";
+        readonly usage: readonly ["runpane mcp [--toolsets <name,...>] [--read-only]"];
+        readonly wrappers: readonly ["npm"];
     }, {
         readonly name: "repos list";
         readonly summary: "List repositories saved in the running Pane app.";
         readonly usage: readonly ["runpane repos list [--json] [--pane-dir <path>]"];
+        readonly toolsets: readonly ["core", "repos"];
         readonly jsonSchemas: readonly ["repoListResult"];
     }, {
         readonly name: "repos add";
         readonly summary: "Register an existing git repository with the running Pane app.";
         readonly usage: readonly ["runpane repos add --path <path> [--name <name>] [--json] [--yes]"];
         readonly mutates: true;
+        readonly additive: true;
+        readonly idempotent: true;
+        readonly toolsets: readonly ["core", "repos"];
         readonly jsonSchemas: readonly ["repoAddRequest", "repoAddResult"];
     }, {
         readonly name: "panes list";
         readonly summary: "List Pane sessions in a saved repository.";
         readonly usage: readonly ["runpane panes list [--repo <selector>] [--json]"];
+        readonly toolsets: readonly ["core", "panes"];
         readonly jsonSchemas: readonly ["paneListResult"];
     }, {
         readonly name: "panes cost";
         readonly summary: "Report estimated token cost per Pane, with per-model breakdown and cache efficiency.";
         readonly usage: readonly ["runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]"];
+        readonly toolsets: readonly ["panes"];
         readonly jsonSchemas: readonly ["paneCostRequest", "paneCostResult"];
     }, {
         readonly name: "workspace state";
         readonly summary: "Read one workspace snapshot of every Pane and CLI panel.";
         readonly usage: readonly ["runpane workspace state [--repo <selector>] [--json]"];
+        readonly toolsets: readonly ["core", "agents"];
         readonly jsonSchemas: readonly ["workspaceStateResult"];
     }, {
         readonly name: "watch";
         readonly summary: "Wait for workspace agent and Pane transitions using a daemon-held cursor.";
         readonly usage: readonly ["runpane watch [--as <name>|--since <generation>] [--follow] [--format <lines|json>] [--heartbeat <seconds>] [--idle-after <ms>] [--settle <ms>] [--blocked-settle <ms>] [--min-interval <ms>] [--idle-backoff] [--all-managed|--pane <id>] [--include-shells] [--self-test] [--kinds <kind,...>] [--repo <selector>] [--name-contains <text>] [--timeout-ms <ms>] [--from <now|earliest>] [--json]"];
+        readonly toolsets: readonly ["agents"];
         readonly jsonSchemas: readonly ["workspaceWaitRequest", "workspaceWaitResult"];
     }, {
         readonly name: "panes create";
         readonly summary: "Create user-visible Panes (Pane sessions) backed by Pane-managed worktrees for feature/PR work and open terminal-backed tool tabs.";
         readonly usage: readonly ["runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [options]", "runpane panes create --from-json <path|-> [--yes] [--json]"];
         readonly mutates: true;
+        readonly additive: true;
+        readonly toolsets: readonly ["panes"];
         readonly jsonSchemas: readonly ["paneCreateRequest", "paneCreateResult"];
     }, {
         readonly name: "panes adopt";
         readonly summary: "Adopt an existing externally managed git worktree as a Pane without changing the worktree.";
         readonly usage: readonly ["runpane panes adopt --repo <selector> --path <dir> --name <name> --agent <codex|claude|cursor> [--resume <id>] [--folder <name>] [--launch] [--no-pinned] [--dry-run] [--yes] [--json]"];
         readonly mutates: true;
+        readonly additive: true;
+        readonly toolsets: readonly ["panes"];
         readonly jsonSchemas: readonly ["paneCreateResult"];
     }, {
         readonly name: "panes archive";
         readonly summary: "Archive a Pane (session) exactly like the UI Archive action, including safe removal of its Pane-managed git worktree.";
         readonly usage: readonly ["runpane panes archive --pane <pane-id> [--source user|agent] [--force] [--dry-run] --yes [--json]"];
         readonly mutates: true;
+        readonly toolsets: readonly ["core", "panes"];
         readonly jsonSchemas: readonly ["paneArchiveRequest", "paneArchiveResult"];
     }, {
         readonly name: "panes pin";
         readonly summary: "Declaratively pin a Pane; pinned is the Pane UI's favorite/pin star and repeated requests are idempotent.";
         readonly usage: readonly ["runpane panes pin --pane <pane-id> --yes [--dry-run] [--json]"];
         readonly mutates: true;
+        readonly idempotent: true;
+        readonly toolsets: readonly ["panes"];
         readonly jsonSchemas: readonly ["panePinRequest", "panePinResult"];
     }, {
         readonly name: "panes unpin";
         readonly summary: "Declaratively unpin a Pane; pinned is the Pane UI's favorite/pin star and repeated requests are idempotent.";
         readonly usage: readonly ["runpane panes unpin --pane <pane-id> --yes [--dry-run] [--json]"];
         readonly mutates: true;
+        readonly idempotent: true;
+        readonly toolsets: readonly ["panes"];
         readonly jsonSchemas: readonly ["panePinRequest", "panePinResult"];
     }, {
         readonly name: "panes rename";
         readonly summary: "Rename a Pane without changing its worktree, branch, panels, or focus.";
         readonly usage: readonly ["runpane panes rename --pane <pane-id> --name <new-name> --yes [--dry-run] [--json]"];
         readonly mutates: true;
+        readonly idempotent: true;
+        readonly toolsets: readonly ["panes"];
         readonly jsonSchemas: readonly ["paneRenameRequest", "paneRenameResult"];
     }, {
         readonly name: "panes focus";
         readonly summary: "Raise the Pane window and select a Pane (and optionally one of its panels) on explicit user request.";
         readonly usage: readonly ["runpane panes focus --pane <pane-id> [--panel <panel-id>] --source user|agent --yes [--json]"];
         readonly mutates: true;
+        readonly additive: true;
+        readonly idempotent: true;
+        readonly toolsets: readonly ["panes"];
         readonly jsonSchemas: readonly ["paneFocusRequest", "paneFocusResult"];
     }, {
         readonly name: "panels create";
         readonly summary: "Create a terminal-backed tool panel inside an existing Pane session.";
         readonly usage: readonly ["runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready] --yes [--json]", "runpane panels create --pane <pane-id> --tool-command <command> [--title <title>] [--focus|--no-focus] --yes [--json]"];
         readonly mutates: true;
+        readonly additive: true;
+        readonly toolsets: readonly ["panels"];
         readonly jsonSchemas: readonly ["panelCreateRequest", "panelCreateResult"];
     }, {
         readonly name: "panels list";
         readonly summary: "List tool panels inside a Pane session.";
         readonly usage: readonly ["runpane panels list --pane <pane-id> [--json]"];
+        readonly toolsets: readonly ["panels"];
         readonly jsonSchemas: readonly ["panelListResult"];
     }, {
         readonly name: "panels output";
         readonly summary: "Read recent terminal output from a panel.";
         readonly usage: readonly ["runpane panels output --panel <panel-id> [--limit <count>] [--json]"];
+        readonly toolsets: readonly ["panels"];
         readonly jsonSchemas: readonly ["panelOutputResult"];
     }, {
         readonly name: "panels screen";
         readonly summary: "Read a compact current-screen view from a terminal panel.";
         readonly usage: readonly ["runpane panels screen --panel <panel-id> [--limit <count>] [--json]"];
+        readonly toolsets: readonly ["panels"];
         readonly jsonSchemas: readonly ["panelScreenResult"];
     }, {
         readonly name: "panels input";
         readonly summary: "Send input bytes to a terminal panel.";
-        readonly usage: readonly ["runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]"];
+        readonly usage: readonly ["runpane panels input --panel <panel-id> (--text <text>|--keys <name,...>|--input-file <path|->) --yes [--json]"];
         readonly mutates: true;
+        readonly toolsets: readonly ["core", "panels"];
         readonly jsonSchemas: readonly ["panelInputRequest", "panelInputResult"];
     }, {
         readonly name: "panels submit";
         readonly summary: "Send and submit text to a terminal panel, including idle agent composers.";
         readonly usage: readonly ["runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]"];
         readonly mutates: true;
+        readonly toolsets: readonly ["panels"];
         readonly jsonSchemas: readonly ["panelSubmitRequest", "panelSubmitResult"];
     }, {
         readonly name: "panels submit-composer";
         readonly summary: "Submit an agent composer using the panel-appropriate key sequence.";
         readonly usage: readonly ["runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]"];
         readonly mutates: true;
+        readonly toolsets: readonly ["panels"];
         readonly jsonSchemas: readonly ["panelSubmitComposerRequest", "panelSubmitComposerResult"];
     }, {
         readonly name: "panels wait";
         readonly summary: "Wait for a terminal panel to initialize, become ready/idle, or contain text.";
         readonly usage: readonly ["runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--contains <text>] [--timeout-ms <ms>] [--interval-ms <ms>] [--json]"];
+        readonly toolsets: readonly ["panels"];
         readonly jsonSchemas: readonly ["panelWaitResult"];
+    }, {
+        readonly name: "panes git-status";
+        readonly summary: "Read the git status of a Pane worktree: uncommitted, unpushed, and behind-main counts.";
+        readonly usage: readonly ["runpane panes git-status --pane <pane-id> [--json] [--pane-dir <path>]"];
+        readonly daemonAction: {
+            readonly channel: "sessions:get-git-status";
+            readonly args: readonly ["--pane"];
+        };
+        readonly toolsets: readonly ["core", "git"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes commit";
+        readonly summary: "Stage all changes in a Pane worktree and commit them.";
+        readonly usage: readonly ["runpane panes commit --pane <pane-id> --message <message> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly additive: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:git-stage-and-commit";
+            readonly args: readonly ["--pane", "--message"];
+        };
+        readonly toolsets: readonly ["git"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes push";
+        readonly summary: "Push a Pane branch to its remote.";
+        readonly usage: readonly ["runpane panes push --pane <pane-id> --yes [--json] [--pane-dir <path>]"];
+        readonly openWorld: true;
+        readonly mutates: true;
+        readonly additive: true;
+        readonly idempotent: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:git-push";
+            readonly args: readonly ["--pane"];
+        };
+        readonly toolsets: readonly ["git"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes pull";
+        readonly summary: "Pull the remote branch into a Pane worktree.";
+        readonly usage: readonly ["runpane panes pull --pane <pane-id> --yes [--json] [--pane-dir <path>]"];
+        readonly openWorld: true;
+        readonly mutates: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:git-pull";
+            readonly args: readonly ["--pane"];
+        };
+        readonly toolsets: readonly ["git"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes rebase-main";
+        readonly summary: "Rebase a Pane branch onto the latest main branch.";
+        readonly usage: readonly ["runpane panes rebase-main --pane <pane-id> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:rebase-main-into-worktree";
+            readonly args: readonly ["--pane"];
+        };
+        readonly toolsets: readonly ["git"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes restore";
+        readonly summary: "Restore an archived Pane, recreating its worktree.";
+        readonly usage: readonly ["runpane panes restore --pane <pane-id> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly additive: true;
+        readonly idempotent: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:restore";
+            readonly args: readonly ["--pane"];
+        };
+        readonly toolsets: readonly ["core", "panes"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes squash-rebase";
+        readonly summary: "Squash a Pane branch into one commit and rebase it onto main.";
+        readonly usage: readonly ["runpane panes squash-rebase --pane <pane-id> --message <message> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:squash-and-rebase-to-main";
+            readonly args: readonly ["--pane", "--message"];
+        };
+        readonly toolsets: readonly ["git"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes stash";
+        readonly summary: "Stash uncommitted changes in a Pane worktree.";
+        readonly usage: readonly ["runpane panes stash --pane <pane-id> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:git-stash";
+            readonly args: readonly ["--pane"];
+        };
+        readonly toolsets: readonly ["git"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes stash-pop";
+        readonly summary: "Apply and drop the latest stash in a Pane worktree.";
+        readonly usage: readonly ["runpane panes stash-pop --pane <pane-id> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:git-stash-pop";
+            readonly args: readonly ["--pane"];
+        };
+        readonly toolsets: readonly ["git"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes soft-reset";
+        readonly summary: "Undo the last commit in a Pane, keeping its changes staged.";
+        readonly usage: readonly ["runpane panes soft-reset --pane <pane-id> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:git-soft-reset";
+            readonly args: readonly ["--pane"];
+        };
+        readonly toolsets: readonly ["git"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes fetch";
+        readonly summary: "Fetch the remote for a Pane worktree.";
+        readonly usage: readonly ["runpane panes fetch --pane <pane-id> --yes [--json] [--pane-dir <path>]"];
+        readonly openWorld: true;
+        readonly mutates: true;
+        readonly additive: true;
+        readonly idempotent: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:git-fetch";
+            readonly args: readonly ["--pane"];
+        };
+        readonly toolsets: readonly ["git"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes run-script";
+        readonly summary: "Run the repository's run script in a Pane.";
+        readonly usage: readonly ["runpane panes run-script --pane <pane-id> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly additive: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:run-script";
+            readonly args: readonly ["--pane"];
+        };
+        readonly toolsets: readonly ["panes"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes stop-script";
+        readonly summary: "Stop the run script running in a Pane.";
+        readonly usage: readonly ["runpane panes stop-script --pane <pane-id> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly idempotent: true;
+        readonly daemonAction: {
+            readonly channel: "sessions:stop-script";
+            readonly args: readonly ["--pane"];
+        };
+        readonly toolsets: readonly ["panes"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "panes move";
+        readonly summary: "Move a Pane into a sidebar folder.";
+        readonly usage: readonly ["runpane panes move --pane <pane-id> --folder <folder-id> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly idempotent: true;
+        readonly daemonAction: {
+            readonly channel: "folders:move-session";
+            readonly args: readonly ["--pane", "--folder"];
+        };
+        readonly toolsets: readonly ["panes"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "folders list";
+        readonly summary: "List the sidebar folders of a repository.";
+        readonly usage: readonly ["runpane folders list --repo <repo-id> [--json] [--pane-dir <path>]"];
+        readonly daemonAction: {
+            readonly channel: "folders:get-by-project";
+            readonly args: readonly ["--repo"];
+        };
+        readonly toolsets: readonly ["panes"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "folders create";
+        readonly summary: "Create a sidebar folder in a repository.";
+        readonly usage: readonly ["runpane folders create --repo <repo-id> --name <name> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly additive: true;
+        readonly daemonAction: {
+            readonly channel: "folders:create";
+            readonly args: readonly ["--name", "--repo"];
+        };
+        readonly toolsets: readonly ["panes"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "links create";
+        readonly summary: "Build a pane:// link that opens a Pane, panel, repository, or Session in the Pane app.";
+        readonly usage: readonly ["runpane links create --pane <pane-id> [--panel <panel-id>] [--json]", "runpane links create --repo <repo-id> [--json]", "runpane links create --session <session-id> [--json]"];
+        readonly toolsets: readonly ["core", "links"];
+        readonly jsonSchemas: readonly ["linkCreateResult"];
+    }, {
+        readonly name: "links open";
+        readonly summary: "Open a pane:// link in the running Pane app.";
+        readonly usage: readonly ["runpane links open --url <pane-url> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly additive: true;
+        readonly idempotent: true;
+        readonly daemonAction: {
+            readonly channel: "runpane:links:open";
+            readonly args: readonly ["--url"];
+        };
+        readonly toolsets: readonly ["links"];
+        readonly jsonSchemas: readonly ["daemonActionResult"];
+    }, {
+        readonly name: "docs search";
+        readonly summary: "Search Pane's docs, runpane help, and the Pane Chat skills.";
+        readonly usage: readonly ["runpane docs search --query <text> [--limit <count>] [--json]"];
+        readonly wrappers: readonly ["npm"];
+        readonly toolsets: readonly ["core", "docs"];
+        readonly jsonSchemas: readonly ["docsSearchResult"];
+    }, {
+        readonly name: "docs read";
+        readonly summary: "Read one Pane doc, help topic, or skill in full.";
+        readonly usage: readonly ["runpane docs read --doc <path> [--json]"];
+        readonly wrappers: readonly ["npm"];
+        readonly toolsets: readonly ["core", "docs"];
+        readonly jsonSchemas: readonly ["docsReadResult"];
+    }, {
+        readonly name: "agents start";
+        readonly summary: "Start an agent on a task: create a Pane in a repository, launch the agent with the prompt, and wait until it is ready.";
+        readonly usage: readonly ["runpane agents start --repo <selector> --name <name> (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task> [--base-branch <branch>] --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly additive: true;
+        readonly wrappers: readonly ["npm"];
+        readonly toolsets: readonly ["core", "agents"];
+        readonly jsonSchemas: readonly ["agentTaskResult"];
+    }, {
+        readonly name: "agents status";
+        readonly summary: "Check on an agent: whether it is working, ready, blocked, or idle, plus its current screen.";
+        readonly usage: readonly ["runpane agents status (--pane <pane-id>|--panel <panel-id>) [--limit <count>] [--json] [--pane-dir <path>]"];
+        readonly wrappers: readonly ["npm"];
+        readonly toolsets: readonly ["core", "agents"];
+        readonly jsonSchemas: readonly ["agentStatusResult"];
+    }, {
+        readonly name: "agents send";
+        readonly summary: "Send a follow-up message to an agent and confirm it was submitted.";
+        readonly usage: readonly ["runpane agents send (--pane <pane-id>|--panel <panel-id>) --text <message> --yes [--json] [--pane-dir <path>]"];
+        readonly mutates: true;
+        readonly wrappers: readonly ["npm"];
+        readonly toolsets: readonly ["core", "agents"];
+        readonly jsonSchemas: readonly ["agentSendResult"];
     }, {
         readonly name: "sessions list";
         readonly summary: "List durable named orchestration Sessions.";
         readonly usage: readonly ["runpane sessions list [--json] [--pane-dir <path>]"];
+        readonly toolsets: readonly ["sessions"];
         readonly jsonSchemas: readonly ["sessionListResult"];
     }, {
         readonly name: "sessions create";
         readonly summary: "Create a durable named orchestration Session and its hidden terminal owner.";
         readonly usage: readonly ["runpane sessions create --from-json <path|-> [--json] [--pane-dir <path>]"];
         readonly mutates: true;
+        readonly additive: true;
+        readonly toolsets: readonly ["sessions"];
         readonly jsonSchemas: readonly ["sessionResult"];
     }, {
         readonly name: "sessions get";
         readonly summary: "Read one durable named orchestration Session.";
         readonly usage: readonly ["runpane sessions get --session <id|name> [--json] [--pane-dir <path>]"];
+        readonly toolsets: readonly ["sessions"];
         readonly jsonSchemas: readonly ["sessionResult"];
     }, {
         readonly name: "sessions update";
         readonly summary: "Update a Session overview from structured JSON.";
         readonly usage: readonly ["runpane sessions update --session <id|name> --from-json <path|-> [--json] [--pane-dir <path>]"];
         readonly mutates: true;
+        readonly idempotent: true;
+        readonly toolsets: readonly ["sessions"];
         readonly jsonSchemas: readonly ["sessionResult"];
     }, {
         readonly name: "sessions set-agent";
         readonly summary: "Switch the durable terminal agent for a named Session.";
         readonly usage: readonly ["runpane sessions set-agent --session <id|name> --agent <codex|claude|cursor> [--json] [--pane-dir <path>]"];
         readonly mutates: true;
+        readonly idempotent: true;
+        readonly toolsets: readonly ["sessions"];
         readonly jsonSchemas: readonly ["sessionResult"];
     }, {
         readonly name: "sessions associate";
         readonly summary: "Associate a user-visible Pane with a named Session.";
         readonly usage: readonly ["runpane sessions associate --session <id|name> --pane <pane-id> [--json] [--pane-dir <path>]"];
         readonly mutates: true;
+        readonly additive: true;
+        readonly idempotent: true;
+        readonly toolsets: readonly ["sessions"];
         readonly jsonSchemas: readonly ["sessionResult"];
     }, {
         readonly name: "sessions detach";
         readonly summary: "Detach a Pane from a named Session.";
         readonly usage: readonly ["runpane sessions detach --session <id|name> [--pane <pane-id>] [--json] [--pane-dir <path>]"];
         readonly mutates: true;
+        readonly idempotent: true;
+        readonly toolsets: readonly ["sessions"];
         readonly jsonSchemas: readonly ["sessionResult"];
     }, {
         readonly name: "sessions overview";
         readonly summary: "Read a live status, activity, git, and pull request overview for a named Session.";
         readonly usage: readonly ["runpane sessions overview --session <id|name> [--json] [--pane-dir <path>]"];
+        readonly toolsets: readonly ["sessions"];
         readonly jsonSchemas: readonly ["sessionOverviewResult"];
     }];
     readonly flags: {
@@ -495,6 +808,30 @@ export declare const RUNPANE_CONTRACT: {
             readonly name: "--session";
             readonly value: "<id|name>";
             readonly description: "Named orchestration Session id or exact name.";
+        }, {
+            readonly name: "--message";
+            readonly value: "<message>";
+            readonly description: "Commit message for panes commit.";
+        }, {
+            readonly name: "--query";
+            readonly value: "<text>";
+            readonly description: "Search words for docs search.";
+        }, {
+            readonly name: "--doc";
+            readonly value: "<path>";
+            readonly description: "Doc path for docs read.";
+        }, {
+            readonly name: "--url";
+            readonly value: "<pane-url>";
+            readonly description: "pane:// link for links open.";
+        }, {
+            readonly name: "--toolsets";
+            readonly value: "<name,...>";
+            readonly description: "MCP toolsets for runpane mcp.";
+        }, {
+            readonly name: "--keys";
+            readonly value: "<name,...>";
+            readonly description: "Named keys for panels input, such as down,enter.";
         }];
         readonly localBoolean: readonly [{
             readonly name: "--json";
@@ -550,11 +887,14 @@ export declare const RUNPANE_CONTRACT: {
         }, {
             readonly name: "--report";
             readonly description: "Prepare a redacted doctor report; external filing still requires --yes.";
+        }, {
+            readonly name: "--read-only";
+            readonly description: "Serve only read-only MCP tools.";
         }];
     };
     readonly help: {
         readonly npm: {
-            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane doctor --report --body-file <path|->", "  runpane daemon repair [--pane-dir <path>] [--yes] [--json]", "  runpane agent-context [--json]", "  runpane agents doctor --agent <codex|claude|cursor> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane sessions list [--json] [--pane-dir <path>]", "  runpane sessions create --from-json <path|-> [--json] [--pane-dir <path>]", "  runpane sessions get --session <id|name> [--json] [--pane-dir <path>]", "  runpane sessions update --session <id|name> --from-json <path|-> [--json] [--pane-dir <path>]", "  runpane sessions set-agent --session <id|name> --agent <codex|claude|cursor> [--json] [--pane-dir <path>]", "  runpane sessions associate --session <id|name> --pane <pane-id> [--json] [--pane-dir <path>]", "  runpane sessions detach --session <id|name> [--pane <pane-id>] [--json] [--pane-dir <path>]", "  runpane sessions overview --session <id|name> [--json] [--pane-dir <path>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch --follow", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] [--dry-run] --yes", "  runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] --yes", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]", "  runpane help [command]", "", "Quick start:", "  npx --yes runpane@latest", "  npm i -g runpane && runpane setup", "", "Advanced examples:", "  npx --yes runpane@latest install client", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest", "", "Common commands:", "  runpane help", "  runpane setup", "  runpane install", "  runpane doctor", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json", "  runpane agent-context --command \"<command>\" --json", "", "Run \"runpane help panes create\" for pane orchestration options."];
+            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane doctor --report --body-file <path|->", "  runpane daemon repair [--pane-dir <path>] [--yes] [--json]", "  runpane agent-context [--json]", "  runpane mcp [--toolsets <name,...>] [--read-only]", "  runpane agents doctor --agent <codex|claude|cursor> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane sessions list [--json] [--pane-dir <path>]", "  runpane sessions create --from-json <path|-> [--json] [--pane-dir <path>]", "  runpane sessions get --session <id|name> [--json] [--pane-dir <path>]", "  runpane sessions update --session <id|name> --from-json <path|-> [--json] [--pane-dir <path>]", "  runpane sessions set-agent --session <id|name> --agent <codex|claude|cursor> [--json] [--pane-dir <path>]", "  runpane sessions associate --session <id|name> --pane <pane-id> [--json] [--pane-dir <path>]", "  runpane sessions detach --session <id|name> [--pane <pane-id>] [--json] [--pane-dir <path>]", "  runpane sessions overview --session <id|name> [--json] [--pane-dir <path>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch --follow", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] [--dry-run] --yes", "  runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] --yes", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> (--text <text>|--keys <name,...>|--input-file <path|->) --yes [--json]", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]", "  runpane panes git-status --pane <pane-id> [--json] [--pane-dir <path>]", "  runpane panes commit --pane <pane-id> --message <message> --yes [--json] [--pane-dir <path>]", "  runpane panes push --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes pull --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes rebase-main --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes restore --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane links create --pane <pane-id> [--panel <panel-id>] [--json]", "  runpane links open --url <pane-url> --yes [--json] [--pane-dir <path>]", "  runpane docs search --query <text> [--limit <count>] [--json]", "  runpane docs read --doc <path> [--json]", "  runpane agents start --repo <selector> --name <name> (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task> [--base-branch <branch>] --yes [--json] [--pane-dir <path>]", "  runpane agents status (--pane <pane-id>|--panel <panel-id>) [--limit <count>] [--json] [--pane-dir <path>]", "  runpane agents send (--pane <pane-id>|--panel <panel-id>) --text <message> --yes [--json] [--pane-dir <path>]", "  runpane panes squash-rebase --pane <pane-id> --message <message> --yes [--json] [--pane-dir <path>]", "  runpane panes stash --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes stash-pop --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes soft-reset --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes fetch --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes run-script --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes stop-script --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes move --pane <pane-id> --folder <folder-id> --yes [--json] [--pane-dir <path>]", "  runpane folders list --repo <repo-id> [--json] [--pane-dir <path>]", "  runpane folders create --repo <repo-id> --name <name> --yes [--json] [--pane-dir <path>]", "  runpane help [command]", "", "Quick start:", "  npx --yes runpane@latest", "  npm i -g runpane && runpane setup", "", "Advanced examples:", "  npx --yes runpane@latest install client", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest", "", "Common commands:", "  runpane help", "  runpane setup", "  runpane install", "  runpane doctor", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json", "  runpane agent-context --command \"<command>\" --json", "", "Run \"runpane help panes create\" for pane orchestration options."];
             readonly install: readonly ["Usage:", "  runpane install [client|daemon] [options]", "", "Examples:", "  npx --yes runpane@latest install client", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest install daemon --prefer-tunnel ssh --label \"VM\"", "", "Wrapper options:", "  --version <latest|vX.Y.Z>        Pane release to install", "  --format <auto|appimage|deb|dmg|zip|exe>", "  --download-dir <path>", "  --pane-path <path>               Use an existing Pane executable", "  --dry-run                       Print the plan without downloading", "  --yes                           Skip interactive prompts where possible", "  --verbose", "", "Daemon passthrough options:", "  --label <name>", "  --prefer-tunnel <tailscale|ssh|manual|auto>", "  --channel <stable|nightly>", "  --base-url <url>", "  --pane-dir <path>", "  --listen-port <port> / --port <port>", "  --auto-listen-port", "  --interactive-tailscale-setup", "  --no-install-service", "  --no-tailscale-serve", "  --print-only", "  --repo-ref <ref>"];
             readonly setup: readonly ["Usage:", "  runpane setup", "", "Opens the guided setup for desktop install, remote host setup, update, and diagnostics.", "", "Quick start:", "  npx --yes runpane@latest", "  npm i -g runpane && runpane setup"];
             readonly update: readonly ["Usage:", "  runpane update [options]", "", "Updates Pane using the same artifact selection as \"runpane install client\".", "", "Options:", "  --version <latest|vX.Y.Z>", "  --format <auto|appimage|deb|dmg|zip|exe>", "  --download-dir <path>", "  --pane-path <path>", "  --dry-run", "  --yes", "  --verbose"];
@@ -579,8 +919,9 @@ export declare const RUNPANE_CONTRACT: {
             readonly panels: readonly ["Terminal-backed panel commands.", "", "Usage:", "  runpane panels <command> [options]", "", "Commands:", "  runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [options]", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]", "", "Run \"runpane help panels create\" or another command-specific topic for options."];
             readonly "panels list": readonly ["Usage:", "  runpane panels list --pane <pane-id> [--json]", "", "Lists tool panels in a Pane session.", "", "Options:", "  --pane <pane-id>               Pane/session id", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
             readonly "panels output": readonly ["Usage:", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "", "Reads bounded recent terminal output from a panel.", "", "Options:", "  --panel <panel-id>             Tool panel id", "  --limit <count>                Maximum recent output lines or records to read", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
-            readonly "panels input": readonly ["Usage:", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "", "Sends exact input bytes to a terminal panel. Include a newline in the input when you mean Enter.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --text <text>                  Text bytes to send", "  --input-file <path|->          Read input from a file or stdin", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --yes                          Skip confirmation for mutating commands"];
+            readonly "panels input": readonly ["Usage:", "  runpane panels input --panel <panel-id> (--text <text>|--keys <name,...>|--input-file <path|->) --yes [--json]", "", "Sends exact input bytes to a terminal panel. Include a newline in the input when you mean Enter.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --text <text>                  Text bytes to send", "  --keys <name,...>              Keys to press: enter, escape, tab, up, down, ctrl-c, ...", "  --input-file <path|->          Read input from a file or stdin", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --yes                          Skip confirmation for mutating commands"];
             readonly "agent-context": readonly ["Usage:", "  runpane agent-context [--json]", "  runpane agent-context --command <command> [--json]", "", "Prints Pane command context for coding agents without requiring a running Pane app.", "", "Options:", "  --command <command>            Print the full definition for one runpane command", "  --json                         Print machine-readable output", "", "Examples:", "  runpane agent-context", "  runpane agent-context --json", "  runpane agent-context --command \"panes create\"", "  runpane agent-context --command \"panes create\" --json"];
+            readonly mcp: readonly ["Usage:", "  runpane mcp [--toolsets <name,...>] [--read-only]", "", "Runs the Pane MCP server over stdio. Each runpane command with a JSON result becomes a tool that returns the same JSON as `runpane <command> --json`. Commands that need --yes take `yes: true` instead.", "Pane registers this server with Claude Code and Codex automatically (Settings > AI & Agents). To register it by hand:", "  claude mcp add --scope user pane -- npx --yes runpane@latest mcp", "  codex mcp add pane -- npx --yes runpane@latest mcp", "", "The MCP server ships in the npm package and inside the Pane app. The Python package does not include it.", "", "Options:", "  --toolsets <name,...>          core (default), all, read, repos, panes, panels, agents, sessions, git, docs, links, admin", "  --read-only                    Serve only read-only tools"];
             readonly "agents doctor": readonly ["Usage:", "  runpane agents doctor --agent <codex|claude|cursor> [--repo <selector>] [--json]", "", "Diagnoses whether Codex or Claude is available in the same repository environment Pane will use.", "", "Options:", "  --agent <codex|claude|cursor>         Built-in agent command to diagnose", "  --repo <selector>              active, id, exact path, or saved repository name; defaults to active", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
             readonly "panels screen": readonly ["Usage:", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "", "Reads a compact current-screen view from a terminal panel. Prefers alternate-screen/TUI output and falls back to recent scrollback.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --limit <count>                Maximum lines to return; defaults to 80", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
             readonly "panels submit": readonly ["Usage:", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "", "Sends text to a terminal panel and normalizes the final terminal Enter to CR. Use this for ordinary prompt answers and shell commands.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --text <text>                  Text to submit before Enter", "  --input-file <path|->          Read text from a file or stdin before Enter", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --yes                          Skip confirmation for this mutating command"];
@@ -595,10 +936,33 @@ export declare const RUNPANE_CONTRACT: {
             readonly "sessions associate": readonly ["Usage:", "runpane sessions associate --session <id|name> --pane <pane-id> [--json] [--pane-dir <path>]", "", "Options:", "  --session <id|name>         Named Session id or exact name.", "  --from-json <path|->         Read structured JSON from a file or stdin.", "  --pane <pane-id>             User-visible Pane to associate or detach.", "  --agent <codex|claude|cursor>  Agent terminal to use.", "  --json                       Print JSON output."];
             readonly "sessions detach": readonly ["Usage:", "runpane sessions detach --session <id|name> [--pane <pane-id>] [--json] [--pane-dir <path>]", "", "Options:", "  --session <id|name>         Named Session id or exact name.", "  --from-json <path|->         Read structured JSON from a file or stdin.", "  --pane <pane-id>             User-visible Pane to associate or detach.", "  --agent <codex|claude|cursor>  Agent terminal to use.", "  --json                       Print JSON output."];
             readonly "sessions overview": readonly ["Usage:", "runpane sessions overview --session <id|name> [--json] [--pane-dir <path>]", "", "Options:", "  --session <id|name>         Named Session id or exact name.", "  --from-json <path|->         Read structured JSON from a file or stdin.", "  --pane <pane-id>             User-visible Pane to associate or detach.", "  --agent <codex|claude|cursor>  Agent terminal to use.", "  --json                       Print JSON output."];
+            readonly "panes git-status": readonly ["Usage:", "  runpane panes git-status --pane <pane-id> [--json] [--pane-dir <path>]", "", "Read the git status of a Pane worktree: uncommitted, unpushed, and behind-main counts.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes commit": readonly ["Usage:", "  runpane panes commit --pane <pane-id> --message <message> --yes [--json] [--pane-dir <path>]", "", "Stage all changes in a Pane worktree and commit them.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --message <message>             Commit message; the first line is the title.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes push": readonly ["Usage:", "  runpane panes push --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Push a Pane branch to its remote.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes pull": readonly ["Usage:", "  runpane panes pull --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Pull the remote branch into a Pane worktree.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes rebase-main": readonly ["Usage:", "  runpane panes rebase-main --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Rebase a Pane branch onto the latest main branch.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes restore": readonly ["Usage:", "  runpane panes restore --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Restore an archived Pane, recreating its worktree.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes squash-rebase": readonly ["Usage:", "  runpane panes squash-rebase --pane <pane-id> --message <message> --yes [--json] [--pane-dir <path>]", "", "Squash a Pane branch into one commit and rebase it onto main.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --message <message>             Commit message; the first line is the title.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes stash": readonly ["Usage:", "  runpane panes stash --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Stash uncommitted changes in a Pane worktree.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes stash-pop": readonly ["Usage:", "  runpane panes stash-pop --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Apply and drop the latest stash in a Pane worktree.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes soft-reset": readonly ["Usage:", "  runpane panes soft-reset --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Undo the last commit in a Pane, keeping its changes staged.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes fetch": readonly ["Usage:", "  runpane panes fetch --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Fetch the remote for a Pane worktree.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes run-script": readonly ["Usage:", "  runpane panes run-script --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Run the repository's run script in a Pane.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes stop-script": readonly ["Usage:", "  runpane panes stop-script --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Stop the run script running in a Pane.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes move": readonly ["Usage:", "  runpane panes move --pane <pane-id> --folder <folder-id> --yes [--json] [--pane-dir <path>]", "", "Move a Pane into a sidebar folder.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --folder <folder-id>            Folder id from folders list.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "folders list": readonly ["Usage:", "  runpane folders list --repo <repo-id> [--json] [--pane-dir <path>]", "", "List the sidebar folders of a repository.", "", "Options:", "  --repo <repo-id>                Numeric repository id from repos list.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "folders create": readonly ["Usage:", "  runpane folders create --repo <repo-id> --name <name> --yes [--json] [--pane-dir <path>]", "", "Create a sidebar folder in a repository.", "", "Options:", "  --repo <repo-id>                Numeric repository id from repos list.", "  --name <name>                   Folder name.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "links create": readonly ["Usage:", "  runpane links create --pane <pane-id> [--panel <panel-id>] [--json]", "  runpane links create --repo <repo-id> [--json]", "  runpane links create --session <session-id> [--json]", "", "Build a pane:// link that opens a Pane, panel, repository, or Session in the Pane app.", "", "Options:", "  --pane <pane-id>                Pane to open.", "  --panel <panel-id>              Panel inside the Pane to select.", "  --repo <repo-id>                Repository id from repos list.", "  --session <session-id>          Session id or name from sessions list.", "  --json                          Print machine-readable output."];
+            readonly "links open": readonly ["Usage:", "  runpane links open --url <pane-url> --yes [--json] [--pane-dir <path>]", "", "Open a pane:// link in the running Pane app.", "", "Options:", "  --url <pane-url>                A pane://open link from links create.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "docs search": readonly ["Usage:", "  runpane docs search --query <text> [--limit <count>] [--json]", "", "Search Pane's docs, runpane help, and the Pane Chat skills.", "", "Options:", "  --query <text>                  Words to search for.", "  --limit <count>                 Maximum results; defaults to 5.", "  --json                          Print machine-readable output."];
+            readonly "docs read": readonly ["Usage:", "  runpane docs read --doc <path> [--json]", "", "Read one Pane doc, help topic, or skill in full.", "", "Options:", "  --doc <path>                    Path from docs search, such as docs/PANE_MCP.md.", "  --json                          Print machine-readable output."];
+            readonly "agents start": readonly ["Usage:", "  runpane agents start --repo <selector> --name <name> (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task> [--base-branch <branch>] --yes [--json] [--pane-dir <path>]", "", "Start an agent on a task: create a Pane in a repository, launch the agent with the prompt, and wait until it is ready.", "", "Options:", "  --repo <selector>               Repository: active, id, exact path, or saved name.", "  --name <name>                   Name for the new Pane.", "  --agent <codex|claude|cursor>   Built-in agent to launch.", "  --tool-command <command>        Custom terminal command instead of a built-in agent.", "  --prompt <task>                 The task to send once the agent is ready.", "  --base-branch <branch>          Branch to start the worktree from.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "agents status": readonly ["Usage:", "  runpane agents status (--pane <pane-id>|--panel <panel-id>) [--limit <count>] [--json] [--pane-dir <path>]", "", "Check on an agent: whether it is working, ready, blocked, or idle, plus its current screen.", "", "Options:", "  --pane <pane-id>                Pane id; its agent panel is used.", "  --panel <panel-id>              Panel id.", "  --limit <count>                 Screen lines to return; defaults to 40.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "agents send": readonly ["Usage:", "  runpane agents send (--pane <pane-id>|--panel <panel-id>) --text <message> --yes [--json] [--pane-dir <path>]", "", "Send a follow-up message to an agent and confirm it was submitted.", "", "Options:", "  --pane <pane-id>                Pane id; its agent panel is used.", "  --panel <panel-id>              Panel id.", "  --text <message>                The message to submit.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
             readonly sessions: readonly ["Usage:", "  runpane sessions <list|create|get|update|set-agent|associate|detach|overview> [options]", "", "Use a named Session to keep context, activity, and evidence attached to one orchestration thread."];
         };
         readonly pip: {
-            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane doctor --report --body-file <path|->", "  runpane daemon repair [--pane-dir <path>] [--yes] [--json]", "  runpane agent-context [--json]", "  runpane agents doctor --agent <codex|claude|cursor> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch --follow", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] [--dry-run] --yes", "  python -m runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] --yes", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]", "  runpane help [command]", "", "Quick start:", "  pipx run runpane", "  python -m pip install runpane && python -m runpane setup", "", "Advanced examples:", "  pipx run runpane install client", "  pipx run runpane install daemon --label \"My Server\"", "  uvx runpane@latest", "", "Common commands:", "  runpane help", "  runpane setup", "  runpane install", "  runpane doctor", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json", "  runpane agent-context --command \"<command>\" --json", "", "Run \"runpane help panes create\" for pane orchestration options."];
+            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane doctor --report --body-file <path|->", "  runpane daemon repair [--pane-dir <path>] [--yes] [--json]", "  runpane agent-context [--json]", "  runpane mcp [--toolsets <name,...>] [--read-only]", "  runpane agents doctor --agent <codex|claude|cursor> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch --follow", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] [--dry-run] --yes", "  python -m runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] --yes", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> (--text <text>|--keys <name,...>|--input-file <path|->) --yes [--json]", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]", "  runpane panes git-status --pane <pane-id> [--json] [--pane-dir <path>]", "  runpane panes commit --pane <pane-id> --message <message> --yes [--json] [--pane-dir <path>]", "  runpane panes push --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes pull --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes rebase-main --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes restore --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane links create --pane <pane-id> [--panel <panel-id>] [--json]", "  runpane links open --url <pane-url> --yes [--json] [--pane-dir <path>]", "  runpane docs search --query <text> [--limit <count>] [--json]", "  runpane docs read --doc <path> [--json]", "  runpane agents start --repo <selector> --name <name> (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task> [--base-branch <branch>] --yes [--json] [--pane-dir <path>]", "  runpane agents status (--pane <pane-id>|--panel <panel-id>) [--limit <count>] [--json] [--pane-dir <path>]", "  runpane agents send (--pane <pane-id>|--panel <panel-id>) --text <message> --yes [--json] [--pane-dir <path>]", "  runpane panes squash-rebase --pane <pane-id> --message <message> --yes [--json] [--pane-dir <path>]", "  runpane panes stash --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes stash-pop --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes soft-reset --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes fetch --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes run-script --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes stop-script --pane <pane-id> --yes [--json] [--pane-dir <path>]", "  runpane panes move --pane <pane-id> --folder <folder-id> --yes [--json] [--pane-dir <path>]", "  runpane folders list --repo <repo-id> [--json] [--pane-dir <path>]", "  runpane folders create --repo <repo-id> --name <name> --yes [--json] [--pane-dir <path>]", "  runpane help [command]", "", "Quick start:", "  pipx run runpane", "  python -m pip install runpane && python -m runpane setup", "", "Advanced examples:", "  pipx run runpane install client", "  pipx run runpane install daemon --label \"My Server\"", "  uvx runpane@latest", "", "Common commands:", "  runpane help", "  runpane setup", "  runpane install", "  runpane doctor", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json", "  runpane agent-context --command \"<command>\" --json", "", "Run \"runpane help panes create\" for pane orchestration options."];
             readonly install: readonly ["Usage:", "  runpane install [client|daemon] [options]", "", "Examples:", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest install daemon --prefer-tunnel ssh --label \"VM\"", "  pipx run runpane install daemon --label \"My Server\"", "", "Wrapper options:", "  --version <latest|vX.Y.Z>", "  --format <auto|appimage|deb|dmg|zip|exe>", "  --download-dir <path>", "  --pane-path <path>", "  --dry-run", "  --yes", "  --verbose", "", "Daemon passthrough options:", "  --label <name>", "  --prefer-tunnel <tailscale|ssh|manual|auto>", "  --channel <stable|nightly>", "  --base-url <url>", "  --pane-dir <path>", "  --listen-port <port> / --port <port>", "  --auto-listen-port", "  --interactive-tailscale-setup", "  --no-install-service", "  --no-tailscale-serve", "  --print-only", "  --repo-ref <ref>"];
             readonly setup: readonly ["Usage:", "  runpane setup", "", "Opens the guided setup for desktop install, remote host setup, update, and diagnostics.", "", "Quick start:", "  pipx run runpane", "  python -m pip install runpane && python -m runpane setup"];
             readonly update: readonly ["Usage:", "  runpane update [--version <latest|vX.Y.Z>] [--dry-run] [--yes]"];
@@ -623,8 +987,9 @@ export declare const RUNPANE_CONTRACT: {
             readonly panels: readonly ["Terminal-backed panel commands.", "", "Usage:", "  runpane panels <command> [options]", "", "Commands:", "  runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [options]", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]", "", "Run \"runpane help panels create\" or another command-specific topic for options."];
             readonly "panels list": readonly ["Usage:", "  runpane panels list --pane <pane-id> [--json]", "", "Lists tool panels in a Pane session.", "", "Options:", "  --pane <pane-id>", "  --pane-dir <path>", "  --json"];
             readonly "panels output": readonly ["Usage:", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "", "Reads recent terminal output records from a panel.", "", "Options:", "  --panel <panel-id>", "  --limit <count>", "  --pane-dir <path>", "  --json"];
-            readonly "panels input": readonly ["Usage:", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "", "Sends exact input bytes to a terminal panel. Include a newline in the input when you mean Enter.", "", "Options:", "  --panel <panel-id>", "  --text <text>", "  --input-file <path|->", "  --pane-dir <path>", "  --json", "  --yes"];
+            readonly "panels input": readonly ["Usage:", "  runpane panels input --panel <panel-id> (--text <text>|--keys <name,...>|--input-file <path|->) --yes [--json]", "", "Sends exact input bytes to a terminal panel. Include a newline in the input when you mean Enter.", "", "Options:", "  --panel <panel-id>", "  --text <text>", "  --keys <name,...>              Keys to press: enter, escape, tab, up, down, ctrl-c, ...", "  --input-file <path|->", "  --pane-dir <path>", "  --json", "  --yes"];
             readonly "agent-context": readonly ["Usage:", "  runpane agent-context [--json]", "  runpane agent-context --command <command> [--json]", "", "Prints Pane command context for coding agents without requiring a running Pane app.", "", "Options:", "  --command <command>", "  --json", "", "Examples:", "  runpane agent-context", "  runpane agent-context --json", "  runpane agent-context --command \"panes create\"", "  runpane agent-context --command \"panes create\" --json"];
+            readonly mcp: readonly ["Usage:", "  runpane mcp", "", "The Pane MCP server ships in the npm package and inside the Pane app, not in the Python package.", "Run it with Node instead: npx --yes runpane@latest mcp"];
             readonly "agents doctor": readonly ["Usage:", "  runpane agents doctor --agent <codex|claude|cursor> [--repo <selector>] [--json]", "", "Diagnoses whether Codex or Claude is available in the same repository environment Pane will use.", "", "Options:", "  --agent <codex|claude|cursor>         Built-in agent command to diagnose", "  --repo <selector>              active, id, exact path, or saved repository name; defaults to active", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
             readonly "panels screen": readonly ["Usage:", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "", "Reads a compact current-screen view from a terminal panel. Prefers alternate-screen/TUI output and falls back to recent scrollback.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --limit <count>                Maximum lines to return; defaults to 80", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
             readonly "panels submit": readonly ["Usage:", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "", "Sends text to a terminal panel and normalizes the final terminal Enter to CR. Use this for ordinary prompt answers and shell commands.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --text <text>                  Text to submit before Enter", "  --input-file <path|->          Read text from a file or stdin before Enter", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --yes                          Skip confirmation for this mutating command"];
@@ -639,6 +1004,29 @@ export declare const RUNPANE_CONTRACT: {
             readonly "sessions associate": readonly ["Usage:", "python -m runpane sessions associate --session <id|name> --pane <pane-id> [--json] [--pane-dir <path>]", "", "Options:", "  --session <id|name>         Named Session id or exact name.", "  --from-json <path|->         Read structured JSON from a file or stdin.", "  --pane <pane-id>             User-visible Pane to associate or detach.", "  --agent <codex|claude|cursor>  Agent terminal to use.", "  --json                       Print JSON output."];
             readonly "sessions detach": readonly ["Usage:", "python -m runpane sessions detach --session <id|name> [--pane <pane-id>] [--json] [--pane-dir <path>]", "", "Options:", "  --session <id|name>         Named Session id or exact name.", "  --from-json <path|->         Read structured JSON from a file or stdin.", "  --pane <pane-id>             User-visible Pane to associate or detach.", "  --agent <codex|claude|cursor>  Agent terminal to use.", "  --json                       Print JSON output."];
             readonly "sessions overview": readonly ["Usage:", "python -m runpane sessions overview --session <id|name> [--json] [--pane-dir <path>]", "", "Options:", "  --session <id|name>         Named Session id or exact name.", "  --from-json <path|->         Read structured JSON from a file or stdin.", "  --pane <pane-id>             User-visible Pane to associate or detach.", "  --agent <codex|claude|cursor>  Agent terminal to use.", "  --json                       Print JSON output."];
+            readonly "panes git-status": readonly ["Usage:", "  runpane panes git-status --pane <pane-id> [--json] [--pane-dir <path>]", "", "Read the git status of a Pane worktree: uncommitted, unpushed, and behind-main counts.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes commit": readonly ["Usage:", "  runpane panes commit --pane <pane-id> --message <message> --yes [--json] [--pane-dir <path>]", "", "Stage all changes in a Pane worktree and commit them.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --message <message>             Commit message; the first line is the title.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes push": readonly ["Usage:", "  runpane panes push --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Push a Pane branch to its remote.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes pull": readonly ["Usage:", "  runpane panes pull --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Pull the remote branch into a Pane worktree.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes rebase-main": readonly ["Usage:", "  runpane panes rebase-main --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Rebase a Pane branch onto the latest main branch.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes restore": readonly ["Usage:", "  runpane panes restore --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Restore an archived Pane, recreating its worktree.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes squash-rebase": readonly ["Usage:", "  runpane panes squash-rebase --pane <pane-id> --message <message> --yes [--json] [--pane-dir <path>]", "", "Squash a Pane branch into one commit and rebase it onto main.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --message <message>             Commit message; the first line is the title.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes stash": readonly ["Usage:", "  runpane panes stash --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Stash uncommitted changes in a Pane worktree.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes stash-pop": readonly ["Usage:", "  runpane panes stash-pop --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Apply and drop the latest stash in a Pane worktree.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes soft-reset": readonly ["Usage:", "  runpane panes soft-reset --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Undo the last commit in a Pane, keeping its changes staged.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes fetch": readonly ["Usage:", "  runpane panes fetch --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Fetch the remote for a Pane worktree.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes run-script": readonly ["Usage:", "  runpane panes run-script --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Run the repository's run script in a Pane.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes stop-script": readonly ["Usage:", "  runpane panes stop-script --pane <pane-id> --yes [--json] [--pane-dir <path>]", "", "Stop the run script running in a Pane.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "panes move": readonly ["Usage:", "  runpane panes move --pane <pane-id> --folder <folder-id> --yes [--json] [--pane-dir <path>]", "", "Move a Pane into a sidebar folder.", "", "Options:", "  --pane <pane-id>                Pane id from panes list or agents start.", "  --folder <folder-id>            Folder id from folders list.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "folders list": readonly ["Usage:", "  runpane folders list --repo <repo-id> [--json] [--pane-dir <path>]", "", "List the sidebar folders of a repository.", "", "Options:", "  --repo <repo-id>                Numeric repository id from repos list.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "folders create": readonly ["Usage:", "  runpane folders create --repo <repo-id> --name <name> --yes [--json] [--pane-dir <path>]", "", "Create a sidebar folder in a repository.", "", "Options:", "  --repo <repo-id>                Numeric repository id from repos list.", "  --name <name>                   Folder name.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "links create": readonly ["Usage:", "  runpane links create --pane <pane-id> [--panel <panel-id>] [--json]", "  runpane links create --repo <repo-id> [--json]", "  runpane links create --session <session-id> [--json]", "", "Build a pane:// link that opens a Pane, panel, repository, or Session in the Pane app.", "", "Options:", "  --pane <pane-id>                Pane to open.", "  --panel <panel-id>              Panel inside the Pane to select.", "  --repo <repo-id>                Repository id from repos list.", "  --session <session-id>          Session id or name from sessions list.", "  --json                          Print machine-readable output."];
+            readonly "links open": readonly ["Usage:", "  runpane links open --url <pane-url> --yes [--json] [--pane-dir <path>]", "", "Open a pane:// link in the running Pane app.", "", "Options:", "  --url <pane-url>                A pane://open link from links create.", "  --yes                           Confirm this change; required in non-interactive shells.", "  --json                          Print machine-readable output.", "  --pane-dir <path>               Connect to a specific Pane data directory."];
+            readonly "docs search": readonly ["Usage:", "  runpane docs search --query <text> [--limit <count>] [--json]", "", "`runpane docs search` ships in the npm package and the Pane app, not in the Python package.", "Run it with Node instead: npx --yes runpane@latest docs search"];
+            readonly "docs read": readonly ["Usage:", "  runpane docs read --doc <path> [--json]", "", "`runpane docs read` ships in the npm package and the Pane app, not in the Python package.", "Run it with Node instead: npx --yes runpane@latest docs read"];
+            readonly "agents start": readonly ["Usage:", "  runpane agents start --repo <selector> --name <name> (--agent <codex|claude|cursor>|--tool-command <command>) --prompt <task> [--base-branch <branch>] --yes [--json] [--pane-dir <path>]", "", "`runpane agents start` ships in the npm package and the Pane app, not in the Python package.", "Run it with Node instead: npx --yes runpane@latest agents start"];
+            readonly "agents status": readonly ["Usage:", "  runpane agents status (--pane <pane-id>|--panel <panel-id>) [--limit <count>] [--json] [--pane-dir <path>]", "", "`runpane agents status` ships in the npm package and the Pane app, not in the Python package.", "Run it with Node instead: npx --yes runpane@latest agents status"];
+            readonly "agents send": readonly ["Usage:", "  runpane agents send (--pane <pane-id>|--panel <panel-id>) --text <message> --yes [--json] [--pane-dir <path>]", "", "`runpane agents send` ships in the npm package and the Pane app, not in the Python package.", "Run it with Node instead: npx --yes runpane@latest agents send"];
             readonly sessions: readonly ["Usage:", "  runpane sessions <list|create|get|update|set-agent|associate|detach|overview> [options]", "", "Use a named Session to keep context, activity, and evidence attached to one orchestration thread."];
         };
     };
@@ -648,8 +1036,8 @@ export declare const RUNPANE_CONTRACT: {
         readonly npmCommands: readonly ["npx --yes runpane@latest", "npx --yes runpane@latest setup", "npx --yes runpane@latest install client", "npx --yes runpane@latest install daemon --label \"My Server\"", "pnpm dlx runpane@latest", "pnpm dlx runpane@latest install daemon --label \"My Server\"", "npm i -g runpane && runpane", "npm i -g runpane && runpane setup", "npm i -g runpane && runpane install daemon --label \"My Server\"", "pnpm add -g runpane && runpane", "pnpm add -g runpane && runpane setup", "pnpm add -g runpane && runpane install daemon --label \"My Server\"", "yarn dlx runpane@latest install daemon --label \"My Server\"", "bunx runpane@latest install daemon --label \"My Server\""];
         readonly pythonCommands: readonly ["pipx run runpane", "pipx run runpane setup", "python -m pip install runpane", "runpane", "runpane setup", "python -m runpane setup", "runpane install daemon --label \"My Server\"", "pipx install runpane", "runpane", "runpane setup", "pipx run runpane install daemon --label \"My Server\"", "uvx runpane@latest", "uvx runpane@latest setup", "uvx runpane@latest install daemon --label \"My Server\"", "python -m runpane install daemon --label \"My Server\""];
         readonly packageManagerNotes: readonly ["Use `pnpm dlx` for one-shot pnpm execution and `pnpm add -g` for persistent CLI installation.", "Do not document `pnpm install runpane` as the public CLI install path."];
-        readonly commandUsages: readonly ["runpane", "runpane setup", "runpane install", "runpane install client", "runpane install daemon", "runpane update", "runpane version", "runpane doctor", "runpane doctor --json", "runpane daemon repair --pane-dir ~/.pane_remote --yes --json", "runpane agent-context", "runpane agent-context --command \"panes create\" --json", "runpane repos list --json", "runpane repos add --path /path/to/repo --name Pane --yes --json", "runpane panes list --repo active --json", "runpane panes cost --pane <pane-id> --json", "runpane panes create --repo active --name issue-252 --agent <agent> --prompt \"Kick off the discussion skill for issue 252\" --source agent --no-focus --wait-ready --yes --json", "runpane panes create --from-json panes.json --yes --json", "runpane panes archive --pane <pane-id> --source agent --yes --json", "runpane panes rename --pane <pane-id> --name issue-393 --yes --json", "runpane panels list --pane <pane-id> --json", "runpane panels output --panel <panel-id> --limit 200 --json", "printf 'Continue\\n' | runpane panels input --panel <panel-id> --input-file - --yes --json", "runpane watch --self-test", "runpane watch --follow", "runpane watch --follow --kinds agent.ready,agent.blocked,agent.idle,panel.exited,pane.gone --settle 180000 --blocked-settle 30000 --min-interval 600000 --idle-backoff", "runpane sessions list [--json] [--pane-dir <path>]", "runpane sessions create --from-json <path|-> [--json] [--pane-dir <path>]", "runpane sessions get --session <id|name> [--json] [--pane-dir <path>]", "runpane sessions update --session <id|name> --from-json <path|-> [--json] [--pane-dir <path>]", "runpane sessions set-agent --session <id|name> --agent <codex|claude|cursor> [--json] [--pane-dir <path>]", "runpane sessions associate --session <id|name> --pane <pane-id> [--json] [--pane-dir <path>]", "runpane sessions detach --session <id|name> [--pane <pane-id>] [--json] [--pane-dir <path>]", "runpane sessions overview --session <id|name> [--json] [--pane-dir <path>]", "runpane help", "runpane <command> --help"];
-        readonly commandDescriptions: readonly ["`runpane` with no arguments and `runpane setup` open an interactive wizard when stdin and stdout are TTYs. In non-interactive shells or CI, both forms must print help, common commands, and agent discovery hints, then exit successfully instead of waiting for input.", "`runpane install` is an alias for `runpane install client`.", "`runpane install client` downloads the selected Pane desktop artifact and installs, opens, or launches it for the current platform.", "`runpane install daemon` downloads or installs Pane, resolves a stable Pane executable path, and spawns `<pane executable> --remote-setup <forwarded remote setup args>`.", "The wrapper must stream Pane stdout/stderr without reformatting because `pane --remote-setup` prints the one-time `pane-remote://...` connection code.", "`runpane update` uses the same release resolution and installer path as `install client`.", "`runpane version` prints only wrapper package metadata and does not contact, launch, or focus the Pane app or daemon.", "`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, daemon reachability, and remote-daemon hints. Add `--json` for a machine-readable report that agents should run before mutating Pane state. Installed app version detection must be best-effort and must not launch, focus, or configure Pane; macOS wrappers read app bundle metadata instead of executing `Pane --version`.", "`runpane daemon repair` rewrites and restarts only the managed remote-daemon launcher/service. It never creates pairing credentials, changes tunnels, or downloads Pane; doctor only recommends it and never runs it automatically.", "`runpane agent-context` prints a brief, token-efficient command schema for coding agents without connecting to the Pane daemon.", "`runpane agent-context --command \"panes create\"` prints the detailed definition for one command. Add `--json` for machine-readable output.", "`runpane repos list` connects to the running local Pane daemon and prints saved repository records.", "`runpane repos add` registers an existing git repository with the running local Pane daemon. It does not create directories or initialize git repositories by default.", "`runpane panes list` lists Pane sessions, optionally scoped to one saved repository.", "`runpane panes cost` reports estimated token costs per Pane for the last 30 days, including per-model breakdowns and cache efficiency; unscoped output includes an Unattributed bucket that reconciles against workspace totals.", "`runpane panes create` connects to the running local Pane daemon, resolves the requested saved base repository, creates user-visible Pane sessions backed by Pane-managed worktrees/branches, opens terminal-backed tool tabs, and optionally sends initial input to the started tool. Built-in agent panes and `--source agent` default to background/no-focus unless `--focus` is passed. New Panes are pinned into the UI's favorite/pin set by default; pass `--no-pinned` to opt out. Panes created interactively in the Pane UI are unaffected.", "For `panes create --wait-ready`, `initialInput.verifiedSubmitted: true` is reported only after argument attachment or composer-clear plus activity evidence. Routing input does not by itself verify submission.", "`runpane panes archive` refreshes the configured upstream, reports exact unpushed commit evidence, and refuses unsafe archive operations unless `--force` is used. Add `--dry-run` to inspect the same evidence without archiving. Successful archives wait for worktree removal and report `worktreeCleanup`.", "`runpane panes rename` trims and updates a Pane's display name without changing its worktree, branch, panels, or focus, and returns the updated pane summary.", "`runpane panes focus` raises the Pane window and selects a Pane (and optionally one of its panels) exactly like clicking it in the UI. Because it steals the user's window focus, run it only on an explicit user request to open, focus, show, or switch to a Pane; never focus a Pane proactively, the same doctrine that keeps `panes create` background/no-focus for `--source agent`.", "`runpane panels list` lists tool panels inside one Pane session.", "`runpane panels output` reads bounded recent terminal output from one panel and strips common terminal control noise for agent use.", "`runpane panels input` sends exact input bytes to one terminal panel. Prefer `--input-file` for newlines, Ctrl-C, quotes, or shell-sensitive text.", "`runpane panes create --prompt` is an alias for `--initial-input`; request JSON and daemon payloads should use the canonical `initialInput` field.", "If composer submission cannot be verified without risking a duplicate, the create item is unsuccessful with `initialInput.staged`, `initialInput.attempts`, `initialInput.blocked.kind: submission_unverified`, and an actionable `nextCommand`. The CLI-facing `--prompt` alias maps to this canonical `initialInput` result.", "When running from WSL while Pane is installed on Windows, the Linux wrapper may look for a missing `/tmp/pane-daemon.../daemon.sock` or resolve to a Windows shim such as Volta. In that case invoke the Windows wrapper through PowerShell from a Windows cwd, for example `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane repos list --json'`.", "`runpane watch` waits for workspace transitions from the daemon journal without polling. `--follow` keeps waiting and prints one line per event: READY, BLOCKED, IDLE, STUCK, NEW, GONE, EXIT, plus HEARTBEAT every 60 seconds as proof of life. Defaults are responsive: no settle, no batching, all kinds, IDLE every `--idle-after`. Expensive consumers opt into `--kinds` (drop `agent.busy`; BUSY carries no action), `--settle <ms>` (READY only after a quiet window; a BUSY inside it cancels the line), `--blocked-settle <ms>`, `--min-interval <ms>` (batch non-urgent lines; BLOCKED bypasses it), and `--idle-backoff` (10m, 30m, 1h, 3h, then daily). The recommended orchestrator invocation is `runpane watch --follow --kinds agent.ready,agent.blocked,agent.idle,panel.exited,pane.gone --settle 180000 --blocked-settle 30000 --min-interval 600000 --idle-backoff`, which budgets about 6 wake-ups per active pane per hour worst case, usually 1-3. Pane Chat arms it automatically through its skill; only your own scripts need the flags. STUCK means real unsubmitted composer text, never an agent prompt suggestion. Judge a dead watch by a non-zero exit or a WATCH ERROR line, not by silence.", "`sessions list` list durable named orchestration Sessions.", "`sessions create` create a durable named orchestration Session and its hidden terminal owner.", "`sessions get` read one durable named orchestration Session.", "`sessions update` update a Session overview from structured JSON.", "`sessions set-agent` switch the durable terminal agent for a named Session.", "`sessions associate` associate a user-visible Pane with a named Session.", "`sessions detach` detach a Pane from a named Session.", "`sessions overview` read a live status, activity, git, and pull request overview for a named Session."];
+        readonly commandUsages: readonly ["runpane", "runpane setup", "runpane install", "runpane install client", "runpane install daemon", "runpane update", "runpane version", "runpane doctor", "runpane doctor --json", "runpane daemon repair --pane-dir ~/.pane_remote --yes --json", "runpane agent-context", "runpane agent-context --command \"panes create\" --json", "runpane mcp", "runpane repos list --json", "runpane repos add --path /path/to/repo --name Pane --yes --json", "runpane panes list --repo active --json", "runpane panes cost --pane <pane-id> --json", "runpane panes create --repo active --name issue-252 --agent <agent> --prompt \"Kick off the discussion skill for issue 252\" --source agent --no-focus --wait-ready --yes --json", "runpane panes create --from-json panes.json --yes --json", "runpane panes archive --pane <pane-id> --source agent --yes --json", "runpane panes rename --pane <pane-id> --name issue-393 --yes --json", "runpane panels list --pane <pane-id> --json", "runpane panels output --panel <panel-id> --limit 200 --json", "printf 'Continue\\n' | runpane panels input --panel <panel-id> --input-file - --yes --json", "runpane watch --self-test", "runpane watch --follow", "runpane watch --follow --kinds agent.ready,agent.blocked,agent.idle,panel.exited,pane.gone --settle 180000 --blocked-settle 30000 --min-interval 600000 --idle-backoff", "runpane sessions list [--json] [--pane-dir <path>]", "runpane sessions create --from-json <path|-> [--json] [--pane-dir <path>]", "runpane sessions get --session <id|name> [--json] [--pane-dir <path>]", "runpane sessions update --session <id|name> --from-json <path|-> [--json] [--pane-dir <path>]", "runpane sessions set-agent --session <id|name> --agent <codex|claude|cursor> [--json] [--pane-dir <path>]", "runpane sessions associate --session <id|name> --pane <pane-id> [--json] [--pane-dir <path>]", "runpane sessions detach --session <id|name> [--pane <pane-id>] [--json] [--pane-dir <path>]", "runpane sessions overview --session <id|name> [--json] [--pane-dir <path>]", "runpane agents start --repo active --name fix-login --agent claude --prompt \"Fix the login redirect\" --yes --json", "runpane agents status --pane <pane-id> --json", "runpane agents send --pane <pane-id> --text \"Also add a test\" --yes --json", "runpane docs search --query \"archive a pane\" --json", "runpane links create --pane <pane-id> --json", "runpane panes git-status --pane <pane-id> --json", "runpane help", "runpane <command> --help"];
+        readonly commandDescriptions: readonly ["`runpane` with no arguments and `runpane setup` open an interactive wizard when stdin and stdout are TTYs. In non-interactive shells or CI, both forms must print help, common commands, and agent discovery hints, then exit successfully instead of waiting for input.", "`runpane install` is an alias for `runpane install client`.", "`runpane install client` downloads the selected Pane desktop artifact and installs, opens, or launches it for the current platform.", "`runpane install daemon` downloads or installs Pane, resolves a stable Pane executable path, and spawns `<pane executable> --remote-setup <forwarded remote setup args>`.", "The wrapper must stream Pane stdout/stderr without reformatting because `pane --remote-setup` prints the one-time `pane-remote://...` connection code.", "`runpane update` uses the same release resolution and installer path as `install client`.", "`runpane version` prints only wrapper package metadata and does not contact, launch, or focus the Pane app or daemon.", "`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, daemon reachability, and remote-daemon hints. Add `--json` for a machine-readable report that agents should run before mutating Pane state. Installed app version detection must be best-effort and must not launch, focus, or configure Pane; macOS wrappers read app bundle metadata instead of executing `Pane --version`.", "`runpane daemon repair` rewrites and restarts only the managed remote-daemon launcher/service. It never creates pairing credentials, changes tunnels, or downloads Pane; doctor only recommends it and never runs it automatically.", "`runpane agent-context` prints a brief, token-efficient command schema for coding agents without connecting to the Pane daemon.", "`runpane agent-context --command \"panes create\"` prints the detailed definition for one command. Add `--json` for machine-readable output.", "`runpane mcp` runs a stdio MCP server whose tools are generated from this contract: every command with result `jsonSchemas` becomes a tool that runs `runpane <command> --json` and returns its output. Only the npm package and the Pane app include it; the Python wrapper prints how to run it with Node and exits non-zero.", "`runpane repos list` connects to the running local Pane daemon and prints saved repository records.", "`runpane repos add` registers an existing git repository with the running local Pane daemon. It does not create directories or initialize git repositories by default.", "`runpane panes list` lists Pane sessions, optionally scoped to one saved repository.", "`runpane panes cost` reports estimated token costs per Pane for the last 30 days, including per-model breakdowns and cache efficiency; unscoped output includes an Unattributed bucket that reconciles against workspace totals.", "`runpane panes create` connects to the running local Pane daemon, resolves the requested saved base repository, creates user-visible Pane sessions backed by Pane-managed worktrees/branches, opens terminal-backed tool tabs, and optionally sends initial input to the started tool. Built-in agent panes and `--source agent` default to background/no-focus unless `--focus` is passed. New Panes are pinned into the UI's favorite/pin set by default; pass `--no-pinned` to opt out. Panes created interactively in the Pane UI are unaffected.", "For `panes create --wait-ready`, `initialInput.verifiedSubmitted: true` is reported only after argument attachment or composer-clear plus activity evidence. Routing input does not by itself verify submission.", "`runpane panes archive` refreshes the configured upstream, reports exact unpushed commit evidence, and refuses unsafe archive operations unless `--force` is used. Add `--dry-run` to inspect the same evidence without archiving. Successful archives wait for worktree removal and report `worktreeCleanup`.", "`runpane panes rename` trims and updates a Pane's display name without changing its worktree, branch, panels, or focus, and returns the updated pane summary.", "`runpane panes focus` raises the Pane window and selects a Pane (and optionally one of its panels) exactly like clicking it in the UI. Because it steals the user's window focus, run it only on an explicit user request to open, focus, show, or switch to a Pane; never focus a Pane proactively, the same doctrine that keeps `panes create` background/no-focus for `--source agent`.", "`runpane panels list` lists tool panels inside one Pane session.", "`runpane panels output` reads bounded recent terminal output from one panel and strips common terminal control noise for agent use.", "`runpane panels input` sends exact input bytes to one terminal panel. Prefer `--input-file` for newlines, Ctrl-C, quotes, or shell-sensitive text.", "`runpane panes create --prompt` is an alias for `--initial-input`; request JSON and daemon payloads should use the canonical `initialInput` field.", "If composer submission cannot be verified without risking a duplicate, the create item is unsuccessful with `initialInput.staged`, `initialInput.attempts`, `initialInput.blocked.kind: submission_unverified`, and an actionable `nextCommand`. The CLI-facing `--prompt` alias maps to this canonical `initialInput` result.", "When running from WSL while Pane is installed on Windows, the Linux wrapper may look for a missing `/tmp/pane-daemon.../daemon.sock` or resolve to a Windows shim such as Volta. In that case invoke the Windows wrapper through PowerShell from a Windows cwd, for example `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane repos list --json'`.", "`runpane watch` waits for workspace transitions from the daemon journal without polling. `--follow` keeps waiting and prints one line per event: READY, BLOCKED, IDLE, STUCK, NEW, GONE, EXIT, plus HEARTBEAT every 60 seconds as proof of life. Defaults are responsive: no settle, no batching, all kinds, IDLE every `--idle-after`. Expensive consumers opt into `--kinds` (drop `agent.busy`; BUSY carries no action), `--settle <ms>` (READY only after a quiet window; a BUSY inside it cancels the line), `--blocked-settle <ms>`, `--min-interval <ms>` (batch non-urgent lines; BLOCKED bypasses it), and `--idle-backoff` (10m, 30m, 1h, 3h, then daily). The recommended orchestrator invocation is `runpane watch --follow --kinds agent.ready,agent.blocked,agent.idle,panel.exited,pane.gone --settle 180000 --blocked-settle 30000 --min-interval 600000 --idle-backoff`, which budgets about 6 wake-ups per active pane per hour worst case, usually 1-3. Pane Chat arms it automatically through its skill; only your own scripts need the flags. STUCK means real unsubmitted composer text, never an agent prompt suggestion. Judge a dead watch by a non-zero exit or a WATCH ERROR line, not by silence.", "`sessions list` list durable named orchestration Sessions.", "`sessions create` create a durable named orchestration Session and its hidden terminal owner.", "`sessions get` read one durable named orchestration Session.", "`sessions update` update a Session overview from structured JSON.", "`sessions set-agent` switch the durable terminal agent for a named Session.", "`sessions associate` associate a user-visible Pane with a named Session.", "`sessions detach` detach a Pane from a named Session.", "`sessions overview` read a live status, activity, git, and pull request overview for a named Session.", "`runpane agents start|status|send` finish the three common agent jobs in one call each: start an agent on a task in a repository, check on it, and send it a follow-up.", "Commands with a contract `daemonAction` (the `panes` git, script, restore, and move commands, `folders list|create`, and `links open`) call the same Pane daemon channel as the matching button in the app and print `{ ok, data, error }`. Destructive ones add a pane:// `link` to review the Pane.", "`runpane links create` builds `pane://open?...` links; opening one in Pane selects what it names and never changes Pane state.", "`runpane docs search|read` search and read Pane docs, help, and installed Pane Chat skills offline. They ship in the npm package and the Pane app only."];
         readonly wrapperFlagNote: "The top-level `runpane --version` form prints the wrapper version. The install subcommand form `runpane install --version vX.Y.Z` selects a Pane release.";
         readonly localControlFlagNote: "`runpane doctor --json`, `runpane repos list`, `runpane panes ...`, and `runpane panels ...` commands use or describe the local framed daemon socket/pipe for a running Pane app. `--pane-dir` points the wrapper at a non-default Pane data directory, such as `PANE_DIR=~/.pane_test` in development. `runpane agent-context` is local/offline and can be used before Pane is running. In a Pane repository checkout, if `runpane` is not on PATH, use the built local wrapper with Node 22, for example `PATH=/opt/homebrew/opt/node@22/bin:$PATH node packages/runpane/dist/cli.js doctor --json`. From WSL, if the user runs Windows Pane, call the Windows wrapper through `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane ...'` so the command can reach the Windows named-pipe daemon and avoid UNC cwd issues.";
         readonly daemonFlagNote: "Unknown daemon flags should be forwarded rather than dropped so newer Pane versions can extend `--remote-setup` without requiring an immediate wrapper release. Unknown flags for non-daemon commands should fail clearly.";
@@ -657,7 +1045,7 @@ export declare const RUNPANE_CONTRACT: {
         readonly publishingCredentials: readonly ["Local implementation, build, and dry-run validation do not need npm or PyPI API tokens.", "Release publishing should prefer npm Trusted Publishing and PyPI Trusted Publishing from GitHub Actions.", "Fallback `NPM_TOKEN` or `PYPI_API_TOKEN` credentials may be used for first package reservation or manual publication only. They must be supplied through local environment variables or GitHub Actions secrets, never committed, and revoked or rotated after use."];
     };
     readonly testFixtures: {
-        readonly parserSamples: readonly [readonly ["setup"], readonly ["install"], readonly ["install", "client", "--version", "v2.2.8", "--format", "dmg", "--download-dir", "/tmp/pane-downloads", "--dry-run", "--yes"], readonly ["install", "daemon", "--label", "VM", "--prefer-tunnel", "ssh", "--channel", "nightly", "--base-url", "https://example.test", "--pane-dir", "/tmp/pane", "--listen-port", "4555", "--auto-listen-port", "--print-only", "--repo-ref", "main", "--unknown-future-flag", "future-value", "--dry-run", "--verbose"], readonly ["update", "--version", "latest", "--format", "appimage", "--pane-path", "/usr/bin/pane", "--dry-run"], readonly ["doctor", "--pane-path", "/usr/bin/pane", "--format", "zip", "--verbose"], readonly ["doctor", "--json", "--pane-dir", "/tmp/pane"], readonly ["doctor", "--report", "--title", "watch failed", "--body-file", "/tmp/watch-evidence.txt", "--json"], readonly ["watch", "--as", "monitor", "--from", "earliest", "--follow", "--format", "lines", "--heartbeat", "60", "--idle-after", "600000", "--settle", "180000", "--blocked-settle", "30000", "--min-interval", "600000", "--idle-backoff", "--all-managed", "--agents-only", "--exclude-pane", "pane-old", "--kinds", "agent.ready,agent.idle", "--include-held-input", "--self-test"], readonly ["daemon", "repair", "--pane-dir", "/tmp/pane-remote", "--yes", "--json"], readonly ["agent-context"], readonly ["agent-context", "--command", "panes create", "--json"], readonly ["repos", "list", "--json", "--pane-dir", "/tmp/pane"], readonly ["repos", "add", "--path", "/tmp/repo", "--name", "Repo", "--dry-run", "--yes", "--json", "--pane-dir", "/tmp/pane"], readonly ["panes", "list", "--repo", "active", "--json"], readonly ["panes", "cost", "--pane", "session-1", "--json"], readonly ["panes", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--source", "agent", "--pinned", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--source", "agent", "--no-pinned", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--from-json", "-", "--yes", "--json"], readonly ["panes", "archive", "--pane", "session-1", "--force", "--source", "agent", "--yes", "--json"], readonly ["panes", "pin", "--pane", "session-1", "--yes", "--json"], readonly ["panes", "unpin", "--pane", "session-1", "--yes", "--json"], readonly ["panes", "rename", "--pane", "session-1", "--name", "issue-393", "--yes", "--json"], readonly ["panes", "focus", "--pane", "session-1", "--panel", "panel-1", "--source", "user", "--yes", "--json"], readonly ["panels", "list", "--pane", "session-1", "--json"], readonly ["panels", "output", "--panel", "panel-1", "--limit", "200", "--json"], readonly ["panels", "input", "--panel", "panel-1", "--text", "Continue\\n", "--yes", "--json"], readonly ["--version"], readonly ["agents", "doctor", "--agent", "codex", "--repo", "active", "--json"], readonly ["panes", "create", "--from-json", "-", "--source", "agent", "--focus", "--wait-ready", "--ready-timeout-ms", "45000", "--concurrency", "2", "--yes", "--json"], readonly ["panels", "screen", "--panel", "panel-1", "--limit", "80", "--json"], readonly ["panels", "submit", "--panel", "panel-1", "--text", "2", "--yes", "--json"], readonly ["panels", "wait", "--panel", "panel-1", "--for", "text", "--contains", "ready", "--timeout-ms", "30000", "--interval-ms", "500", "--json"], readonly ["panels", "create", "--pane", "pane-1", "--agent", "codex", "--source", "agent", "--no-focus", "--wait-ready", "--ready-timeout-ms", "15000", "--yes", "--json"], readonly ["panels", "create", "--pane", "pane-1", "--agent", "codex", "--focus", "--yes", "--json"], readonly ["panels", "submit-composer", "--panel", "panel-1", "--strategy", "auto", "--yes", "--json"], readonly ["sessions", "list", "--json"], readonly ["sessions", "get", "--session", "demo", "--json"], readonly ["sessions", "update", "--session", "demo", "--from-json", "-"]];
+        readonly parserSamples: readonly [readonly ["setup"], readonly ["install"], readonly ["install", "client", "--version", "v2.2.8", "--format", "dmg", "--download-dir", "/tmp/pane-downloads", "--dry-run", "--yes"], readonly ["install", "daemon", "--label", "VM", "--prefer-tunnel", "ssh", "--channel", "nightly", "--base-url", "https://example.test", "--pane-dir", "/tmp/pane", "--listen-port", "4555", "--auto-listen-port", "--print-only", "--repo-ref", "main", "--unknown-future-flag", "future-value", "--dry-run", "--verbose"], readonly ["update", "--version", "latest", "--format", "appimage", "--pane-path", "/usr/bin/pane", "--dry-run"], readonly ["doctor", "--pane-path", "/usr/bin/pane", "--format", "zip", "--verbose"], readonly ["doctor", "--json", "--pane-dir", "/tmp/pane"], readonly ["doctor", "--report", "--title", "watch failed", "--body-file", "/tmp/watch-evidence.txt", "--json"], readonly ["watch", "--as", "monitor", "--from", "earliest", "--follow", "--format", "lines", "--heartbeat", "60", "--idle-after", "600000", "--settle", "180000", "--blocked-settle", "30000", "--min-interval", "600000", "--idle-backoff", "--all-managed", "--agents-only", "--exclude-pane", "pane-old", "--kinds", "agent.ready,agent.idle", "--include-held-input", "--self-test"], readonly ["daemon", "repair", "--pane-dir", "/tmp/pane-remote", "--yes", "--json"], readonly ["agent-context"], readonly ["agent-context", "--command", "panes create", "--json"], readonly ["repos", "list", "--json", "--pane-dir", "/tmp/pane"], readonly ["repos", "add", "--path", "/tmp/repo", "--name", "Repo", "--dry-run", "--yes", "--json", "--pane-dir", "/tmp/pane"], readonly ["panes", "list", "--repo", "active", "--json"], readonly ["panes", "cost", "--pane", "session-1", "--json"], readonly ["panes", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--source", "agent", "--pinned", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--source", "agent", "--no-pinned", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--from-json", "-", "--yes", "--json"], readonly ["panes", "archive", "--pane", "session-1", "--force", "--source", "agent", "--yes", "--json"], readonly ["panes", "pin", "--pane", "session-1", "--yes", "--json"], readonly ["panes", "unpin", "--pane", "session-1", "--yes", "--json"], readonly ["panes", "rename", "--pane", "session-1", "--name", "issue-393", "--yes", "--json"], readonly ["panes", "focus", "--pane", "session-1", "--panel", "panel-1", "--source", "user", "--yes", "--json"], readonly ["panels", "list", "--pane", "session-1", "--json"], readonly ["panels", "output", "--panel", "panel-1", "--limit", "200", "--json"], readonly ["panels", "input", "--panel", "panel-1", "--text", "Continue\\n", "--yes", "--json"], readonly ["--version"], readonly ["agents", "doctor", "--agent", "codex", "--repo", "active", "--json"], readonly ["panes", "create", "--from-json", "-", "--source", "agent", "--focus", "--wait-ready", "--ready-timeout-ms", "45000", "--concurrency", "2", "--yes", "--json"], readonly ["panels", "screen", "--panel", "panel-1", "--limit", "80", "--json"], readonly ["panels", "submit", "--panel", "panel-1", "--text", "2", "--yes", "--json"], readonly ["panels", "wait", "--panel", "panel-1", "--for", "text", "--contains", "ready", "--timeout-ms", "30000", "--interval-ms", "500", "--json"], readonly ["panels", "create", "--pane", "pane-1", "--agent", "codex", "--source", "agent", "--no-focus", "--wait-ready", "--ready-timeout-ms", "15000", "--yes", "--json"], readonly ["panels", "create", "--pane", "pane-1", "--agent", "codex", "--focus", "--yes", "--json"], readonly ["panels", "submit-composer", "--panel", "panel-1", "--strategy", "auto", "--yes", "--json"], readonly ["sessions", "list", "--json"], readonly ["sessions", "get", "--session", "demo", "--json"], readonly ["sessions", "update", "--session", "demo", "--from-json", "-"], readonly ["panels", "submit", "--panel=panel-1", "--text=- [ ] item", "--yes", "--json"], readonly ["panes", "commit", "--pane", "pane-1", "--message", "fix: title\n\nbody", "--yes", "--json"], readonly ["links", "create", "--pane", "pane-1", "--panel", "panel-1", "--json"], readonly ["links", "open", "--url=pane://open?pane=pane-1", "--yes"], readonly ["mcp", "--toolsets", "core,git", "--read-only"], readonly ["docs", "search", "--query", "archive a pane", "--limit", "3"], readonly ["docs", "read", "--doc", "docs/PANE_MCP.md"], readonly ["agents", "start", "--repo", "active", "--name", "fix-login", "--agent", "claude", "--prompt", "Fix the login redirect", "--yes", "--json"], readonly ["agents", "send", "--pane", "pane-1", "--text=- [ ] item", "--yes"], readonly ["panels", "input", "--panel", "panel-1", "--keys", "down,enter", "--yes", "--json"], readonly ["panes", "squash-rebase", "--pane", "pane-1", "--message", "feat: land it", "--yes", "--json"], readonly ["folders", "create", "--repo", "3", "--name", "Reviews", "--yes"], readonly ["panes", "move", "--pane", "pane-1", "--folder", "folder-9", "--yes", "--json"]];
         readonly topLevelHelpIncludes: readonly ["runpane setup", "runpane install", "runpane update", "runpane version", "runpane doctor", "runpane agent-context", "runpane repos list", "runpane repos add", "runpane panes list", "runpane panes create", "runpane panes archive", "runpane panels create", "runpane panels list", "runpane panels output", "runpane panels input", "runpane agents doctor", "runpane panels screen", "runpane panels submit", "runpane panels submit-composer", "runpane panels wait", "runpane doctor --json", "runpane agent-context --json", "Agent discovery:", "Common commands:"];
         readonly npmHelpIncludes: readonly ["pnpm dlx runpane@latest", "npx --yes runpane@latest"];
         readonly pipHelpIncludes: readonly ["pipx run runpane", "python -m pip install runpane && python -m runpane setup"];
@@ -3106,6 +3494,206 @@ export declare const RUNPANE_CONTRACT: {
             };
             readonly additionalProperties: false;
         };
+        readonly daemonActionResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok"];
+            readonly properties: {
+                readonly ok: {
+                    readonly type: "boolean";
+                };
+                readonly data: {};
+                readonly error: {
+                    readonly type: "object";
+                    readonly required: readonly ["message"];
+                    readonly properties: {
+                        readonly message: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+                readonly link: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly linkCreateResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "url", "target"];
+            readonly properties: {
+                readonly ok: {
+                    readonly const: true;
+                };
+                readonly url: {
+                    readonly type: "string";
+                };
+                readonly target: {
+                    readonly type: "object";
+                    readonly required: readonly ["kind", "id"];
+                    readonly properties: {
+                        readonly kind: {
+                            readonly enum: readonly ["pane", "repo", "session"];
+                        };
+                        readonly id: {
+                            readonly type: "string";
+                        };
+                        readonly panelId: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly docsSearchResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "query", "results"];
+            readonly properties: {
+                readonly ok: {
+                    readonly const: true;
+                };
+                readonly query: {
+                    readonly type: "string";
+                };
+                readonly results: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["path", "title", "kind", "excerpt"];
+                        readonly properties: {
+                            readonly path: {
+                                readonly type: "string";
+                            };
+                            readonly title: {
+                                readonly type: "string";
+                            };
+                            readonly kind: {
+                                readonly enum: readonly ["doc", "skill", "help", "command"];
+                            };
+                            readonly excerpt: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly docsReadResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "path", "title", "kind", "text"];
+            readonly properties: {
+                readonly ok: {
+                    readonly const: true;
+                };
+                readonly path: {
+                    readonly type: "string";
+                };
+                readonly title: {
+                    readonly type: "string";
+                };
+                readonly kind: {
+                    readonly enum: readonly ["doc", "skill", "help", "command"];
+                };
+                readonly text: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly agentTaskResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "paneId", "panelId", "link", "ready"];
+            readonly properties: {
+                readonly ok: {
+                    readonly type: "boolean";
+                };
+                readonly paneId: {
+                    readonly type: "string";
+                };
+                readonly panelId: {
+                    readonly type: "string";
+                };
+                readonly name: {
+                    readonly type: "string";
+                };
+                readonly worktreePath: {
+                    readonly type: "string";
+                };
+                readonly link: {
+                    readonly type: "string";
+                };
+                readonly ready: {
+                    readonly type: "boolean";
+                };
+                readonly promptDelivered: {
+                    readonly type: "boolean";
+                };
+                readonly next: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly agentStatusResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "paneId", "panelId", "status", "screen"];
+            readonly properties: {
+                readonly ok: {
+                    readonly const: true;
+                };
+                readonly paneId: {
+                    readonly type: "string";
+                };
+                readonly panelId: {
+                    readonly type: "string";
+                };
+                readonly paneName: {
+                    readonly type: "string";
+                };
+                readonly status: {
+                    readonly enum: readonly ["working", "ready", "blocked", "idle", "exited", "unknown"];
+                };
+                readonly screen: {
+                    readonly type: "string";
+                };
+                readonly hasUndeliveredText: {
+                    readonly type: "boolean";
+                };
+                readonly link: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly agentSendResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "paneId", "panelId", "delivered"];
+            readonly properties: {
+                readonly ok: {
+                    readonly type: "boolean";
+                };
+                readonly paneId: {
+                    readonly type: "string";
+                };
+                readonly panelId: {
+                    readonly type: "string";
+                };
+                readonly delivered: {
+                    readonly type: "boolean";
+                };
+                readonly blocked: {
+                    readonly type: "string";
+                };
+                readonly next: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
     };
     readonly agentContext: {
         readonly brief: {
@@ -3398,6 +3986,25 @@ export declare const RUNPANE_CONTRACT: {
                 readonly jsonSchemas: readonly ["agentContextBriefResult", "agentContextCommandResult"];
                 readonly notes: readonly ["Default output is brief so AGENTS.md can point here without bloating context.", "`--command` accepts canonical spaced names and common copied forms, including `panes.create` and `runpane panes create`."];
             };
+            readonly mcp: {
+                readonly name: "mcp";
+                readonly summary: "Run the Pane MCP server over stdio so coding agents can call runpane commands as tools.";
+                readonly details: "Use this to register Pane with an MCP client. Pane registers it with Claude Code and Codex automatically; each tool mirrors one runpane command and returns its --json result.";
+                readonly requiresPaneDaemon: false;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--toolsets";
+                    readonly value: "<name,...>";
+                    readonly required: false;
+                    readonly description: "Comma-separated toolsets to serve: core (default), all, read, repos, panes, panels, agents, sessions, git, docs, links, admin.";
+                }, {
+                    readonly name: "--read-only";
+                    readonly required: false;
+                    readonly description: "Serve only read-only tools.";
+                }];
+                readonly examples: readonly ["claude mcp add --scope user pane -- npx --yes runpane@latest mcp", "codex mcp add pane -- npx --yes runpane@latest mcp"];
+                readonly notes: readonly ["Only the npm package and the Pane app include the MCP server; the Python package prints how to run it with Node.", "Commands that need --yes in the CLI take `yes: true` as a tool input."];
+            };
             readonly "repos list": {
                 readonly name: "repos list";
                 readonly summary: "List repositories saved in the running Pane app.";
@@ -3700,7 +4307,7 @@ export declare const RUNPANE_CONTRACT: {
                 }];
                 readonly examples: readonly ["runpane panes archive --pane <pane-id> --source agent --yes --json", "runpane panes archive --pane <pane-id> --dry-run --json", "runpane panes archive --pane <pane-id> --force --yes --json"];
                 readonly jsonSchemas: readonly ["paneArchiveRequest", "paneArchiveResult"];
-                readonly notes: readonly ["If the result has ok:false with a blocked field, the pane was NOT archived; inspect blocked.code and rerun with --force if discarding the flagged work is intentional.", "Inspect safetyCheck.unpushedCommitDetails for exact commit IDs and subjects; upstreamRefreshed confirms the tracking ref was refreshed first.", "A --dry-run result sets dryRun:true and wouldArchive without deleting the Pane or its worktree.", "A successful archive waits for the Pane-managed worktree to be removed before returning; check worktreeCleanup in the result for the final outcome.", "Archiving a main-repo Pane (no Pane-managed worktree) always succeeds immediately since nothing is deleted from disk."];
+                readonly notes: readonly ["If the result has ok:false with a blocked field, the pane was NOT archived; inspect blocked.code and rerun with --force if discarding the flagged work is intentional.", "Inspect safetyCheck.unpushedCommitDetails for exact commit IDs and subjects; upstreamRefreshed confirms the tracking ref was refreshed first.", "A --dry-run result sets dryRun:true and wouldArchive without deleting the Pane or its worktree.", "A successful archive waits for the Pane-managed worktree to be removed before returning; check worktreeCleanup in the result for the final outcome.", "Archiving a main-repo Pane (no Pane-managed worktree) always succeeds immediately since nothing is deleted from disk.", "Undo an archive with `runpane panes restore --pane <pane-id> --yes`, which recreates the worktree. `runpane links create --pane <pane-id>` gives the user a link to review the Pane first."];
             };
             readonly "panes pin": {
                 readonly name: "panes pin";
@@ -3896,6 +4503,11 @@ export declare const RUNPANE_CONTRACT: {
                     readonly value: "<text>";
                     readonly required: false;
                     readonly description: "Text bytes to send.";
+                }, {
+                    readonly name: "--keys";
+                    readonly value: "<name,...>";
+                    readonly required: false;
+                    readonly description: "Comma-separated key names to press in order: enter, escape, tab, backspace, space, up, down, left, right, ctrl-c, ctrl-d, or any single character.";
                 }, {
                     readonly name: "--input-file";
                     readonly value: "<path|->";
@@ -3915,9 +4527,9 @@ export declare const RUNPANE_CONTRACT: {
                     readonly required: false;
                     readonly description: "Connect to a specific Pane data directory.";
                 }];
-                readonly examples: readonly ["printf 'Continue\\n' | runpane panels input --panel <panel-id> --input-file - --yes", "printf '\\003' | runpane panels input --panel <panel-id> --input-file - --yes", "runpane panels input --panel <panel-id> --text \"simple text\" --yes --json"];
+                readonly examples: readonly ["printf 'Continue\\n' | runpane panels input --panel <panel-id> --input-file - --yes", "printf '\\003' | runpane panels input --panel <panel-id> --input-file - --yes", "runpane panels input --panel <panel-id> --text \"simple text\" --yes --json", "runpane panels input --panel <panel-id> --keys down,enter --yes --json"];
                 readonly jsonSchemas: readonly ["panelInputRequest", "panelInputResult"];
-                readonly notes: readonly ["Input is sent exactly as provided. Include a real newline byte when the terminal should receive Enter; across shells, `--input-file` is safer than `--text \"...\\n\"`.", "Use `--input-file -` or a temp file for multi-line input, quotes, Ctrl-C, or shell-sensitive text.", "If interrupting a running process, send Ctrl-C first, validate/read output, then send the next command in a separate `panels input` call so bytes are not dropped.", "After sending input, validate with `runpane panels output --panel <panel-id> --json` before reporting success.", "Runpane records action metadata and errors for observability, but should not log full input text by default.", "For ordinary text plus Enter, prefer `panels submit` so the terminal receives a CR Enter byte."];
+                readonly notes: readonly ["To answer a menu or prompt, prefer `--keys` (for example `--keys down,enter`) over escape sequences in `--text`.", "Input is sent exactly as provided. Include a real newline byte when the terminal should receive Enter; across shells, `--input-file` is safer than `--text \"...\\n\"`.", "Use `--input-file -` or a temp file for multi-line input, quotes, Ctrl-C, or shell-sensitive text.", "If interrupting a running process, send Ctrl-C first, validate/read output, then send the next command in a separate `panels input` call so bytes are not dropped.", "After sending input, validate with `runpane panels output --panel <panel-id> --json` before reporting success.", "Runpane records action metadata and errors for observability, but should not log full input text by default.", "For ordinary text plus Enter, prefer `panels submit` so the terminal receives a CR Enter byte."];
             };
             readonly "agents doctor": {
                 readonly name: "agents doctor";
@@ -4312,6 +4924,719 @@ export declare const RUNPANE_CONTRACT: {
                 readonly examples: readonly ["runpane watch --self-test", "runpane watch --follow", "runpane watch --as monitor --follow --json", "runpane watch --follow --kinds agent.ready,agent.blocked,agent.idle,panel.exited,pane.gone --settle 180000 --blocked-settle 30000 --min-interval 600000 --idle-backoff"];
                 readonly notes: readonly ["Defaults stay responsive: no settle, no batching, all kinds, IDLE every --idle-after. Cadence flags are opt-in for expensive consumers and require --follow.", "Recommended orchestrator invocation (what Pane Chat arms automatically): runpane watch --self-test, then runpane watch --follow --kinds agent.ready,agent.blocked,agent.idle,panel.exited,pane.gone --settle 180000 --blocked-settle 30000 --min-interval 600000 --idle-backoff. Budget: about 6 wake-ups per active pane per hour worst case, usually 1-3.", "BUSY carries no action; drop it with --kinds. HEARTBEAT is client-side proof of life, is never shaped by cadence flags, and should be filtered out of any monitor that wakes an agent.", "STUCK means real unsubmitted composer text. An agent prompt suggestion (for example a grey Try \"...\" hint) never counts.", "Dead watch: judge death by a non-zero exit or a WATCH ERROR line, not by silence. Re-arm once; if it dies again, file runpane doctor --report.", "Cadence state is held per named consumer; an anonymous --follow with a cadence flag names itself follow-<pid>. Held lines survive a reconnect of the same consumer; a changed filter re-delivers them under the new filter.", "Journal loss is surfaced through reset and dropped metadata.", "The daemon treats omitted idleAfterMs as disabled so older clients never receive agent.idle unexpectedly."];
             };
+            readonly "panes git-status": {
+                readonly name: "panes git-status";
+                readonly summary: "Read the git status of a Pane worktree: uncommitted, unpushed, and behind-main counts.";
+                readonly details: "Use this to check whether a Pane has work to commit, push, or rebase before archiving it or opening a PR.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes git-status --pane <pane-id> --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message."];
+            };
+            readonly "panes commit": {
+                readonly name: "panes commit";
+                readonly summary: "Stage all changes in a Pane worktree and commit them.";
+                readonly details: "Use this to commit a Pane's work the way the app's commit action does. The message needs a title line.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--message";
+                    readonly value: "<message>";
+                    readonly required: true;
+                    readonly description: "Commit message; the first line is the title.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes commit --pane <pane-id> --message <message> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message."];
+            };
+            readonly "panes push": {
+                readonly name: "panes push";
+                readonly summary: "Push a Pane branch to its remote.";
+                readonly details: "Use this to publish a Pane's commits, the way the app's push action does.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes push --pane <pane-id> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message."];
+            };
+            readonly "panes pull": {
+                readonly name: "panes pull";
+                readonly summary: "Pull the remote branch into a Pane worktree.";
+                readonly details: "Use this to bring remote commits into a Pane, the way the app's pull action does.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes pull --pane <pane-id> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message."];
+            };
+            readonly "panes rebase-main": {
+                readonly name: "panes rebase-main";
+                readonly summary: "Rebase a Pane branch onto the latest main branch.";
+                readonly details: "Use this to bring main's changes into a Pane. It rewrites the Pane branch history; conflicts are reported, not resolved.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes rebase-main --pane <pane-id> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message."];
+            };
+            readonly "panes restore": {
+                readonly name: "panes restore";
+                readonly summary: "Restore an archived Pane, recreating its worktree.";
+                readonly details: "Use this to undo `panes archive`.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes restore --pane <pane-id> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message."];
+            };
+            readonly "panes squash-rebase": {
+                readonly name: "panes squash-rebase";
+                readonly summary: "Squash a Pane branch into one commit and rebase it onto main.";
+                readonly details: "Use this to land a Pane's work on the repository's main branch the way the app's squash-and-rebase action does. It rewrites the Pane branch and updates main.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--message";
+                    readonly value: "<message>";
+                    readonly required: true;
+                    readonly description: "Commit message; the first line is the title.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes squash-rebase --pane <pane-id> --message <message> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message.", "The result includes `link`, a pane:// link the user can open to review the Pane."];
+            };
+            readonly "panes stash": {
+                readonly name: "panes stash";
+                readonly summary: "Stash uncommitted changes in a Pane worktree.";
+                readonly details: "Use this to set aside work in progress, the way the app's stash action does. `panes stash-pop` brings it back.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes stash --pane <pane-id> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message.", "The result includes `link`, a pane:// link the user can open to review the Pane."];
+            };
+            readonly "panes stash-pop": {
+                readonly name: "panes stash-pop";
+                readonly summary: "Apply and drop the latest stash in a Pane worktree.";
+                readonly details: "Use this to bring back work set aside with `panes stash`.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes stash-pop --pane <pane-id> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message.", "The result includes `link`, a pane:// link the user can open to review the Pane."];
+            };
+            readonly "panes soft-reset": {
+                readonly name: "panes soft-reset";
+                readonly summary: "Undo the last commit in a Pane, keeping its changes staged.";
+                readonly details: "Use this to reword or regroup the latest commit, the way the app's soft reset action does.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes soft-reset --pane <pane-id> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message.", "The result includes `link`, a pane:// link the user can open to review the Pane."];
+            };
+            readonly "panes fetch": {
+                readonly name: "panes fetch";
+                readonly summary: "Fetch the remote for a Pane worktree.";
+                readonly details: "Use this to refresh remote branches before checking git status or rebasing.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes fetch --pane <pane-id> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message."];
+            };
+            readonly "panes run-script": {
+                readonly name: "panes run-script";
+                readonly summary: "Run the repository's run script in a Pane.";
+                readonly details: "Use this to start the dev server or app for a Pane, the way the app's Run button does.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes run-script --pane <pane-id> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message."];
+            };
+            readonly "panes stop-script": {
+                readonly name: "panes stop-script";
+                readonly summary: "Stop the run script running in a Pane.";
+                readonly details: "Use this to stop what `panes run-script` started.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes stop-script --pane <pane-id> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message.", "The result includes `link`, a pane:// link the user can open to review the Pane."];
+            };
+            readonly "panes move": {
+                readonly name: "panes move";
+                readonly summary: "Move a Pane into a sidebar folder.";
+                readonly details: "Use this to organize Panes. Folder ids come from `runpane folders list`.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane id from panes list or agents start.";
+                }, {
+                    readonly name: "--folder";
+                    readonly value: "<folder-id>";
+                    readonly required: true;
+                    readonly description: "Folder id from folders list.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes move --pane <pane-id> --folder <folder-id> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message.", "The result includes `link`, a pane:// link the user can open to review the Pane."];
+            };
+            readonly "folders list": {
+                readonly name: "folders list";
+                readonly summary: "List the sidebar folders of a repository.";
+                readonly details: "Use this to find folder ids for `panes move`.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--repo";
+                    readonly value: "<repo-id>";
+                    readonly required: true;
+                    readonly description: "Numeric repository id from repos list.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane folders list --repo <repo-id> --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message."];
+            };
+            readonly "folders create": {
+                readonly name: "folders create";
+                readonly summary: "Create a sidebar folder in a repository.";
+                readonly details: "Use this to add a folder for grouping Panes.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--repo";
+                    readonly value: "<repo-id>";
+                    readonly required: true;
+                    readonly description: "Numeric repository id from repos list.";
+                }, {
+                    readonly name: "--name";
+                    readonly value: "<name>";
+                    readonly required: true;
+                    readonly description: "Folder name.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane folders create --repo <repo-id> --name <name> --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Runs the same Pane action as the button in the app, through the running Pane daemon.", "Output is `{ ok, data, error }`; `ok: false` exits non-zero with the error message."];
+            };
+            readonly "links create": {
+                readonly name: "links create";
+                readonly summary: "Build a pane:// link that opens a Pane, panel, repository, or Session in the Pane app.";
+                readonly details: "Use this to hand the user a clickable link. It only builds the URL; opening it navigates and never changes Pane state.";
+                readonly requiresPaneDaemon: false;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: false;
+                    readonly description: "Pane to open.";
+                }, {
+                    readonly name: "--panel";
+                    readonly value: "<panel-id>";
+                    readonly required: false;
+                    readonly description: "Panel inside the Pane to select.";
+                }, {
+                    readonly name: "--repo";
+                    readonly value: "<repo-id>";
+                    readonly required: false;
+                    readonly description: "Repository id from repos list.";
+                }, {
+                    readonly name: "--session";
+                    readonly value: "<session-id>";
+                    readonly required: false;
+                    readonly description: "Session id or name from sessions list.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }];
+                readonly examples: readonly ["runpane links create --pane <pane-id> --json"];
+                readonly jsonSchemas: readonly ["linkCreateResult"];
+                readonly notes: readonly ["Links look like `pane://open?pane=<pane-id>&panel=<panel-id>`. Give exactly one of --pane, --repo, or --session."];
+            };
+            readonly "links open": {
+                readonly name: "links open";
+                readonly summary: "Open a pane:// link in the running Pane app.";
+                readonly details: "Use this to navigate the app to a Pane, panel, repository, or Session. It raises the Pane window, so run it only when the user asked.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--url";
+                    readonly value: "<pane-url>";
+                    readonly required: true;
+                    readonly description: "A pane://open link from links create.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane links open --url \"pane://open?pane=<pane-id>\" --yes --json"];
+                readonly jsonSchemas: readonly ["daemonActionResult"];
+                readonly notes: readonly ["Opening a link never changes Pane state; it selects what the link names."];
+            };
+            readonly "docs search": {
+                readonly name: "docs search";
+                readonly summary: "Search Pane's docs, runpane help, and the Pane Chat skills.";
+                readonly details: "Use this before guessing how Pane works. Results are short excerpts with a path; read the full text with `runpane docs read`.";
+                readonly requiresPaneDaemon: false;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--query";
+                    readonly value: "<text>";
+                    readonly required: true;
+                    readonly description: "Words to search for.";
+                }, {
+                    readonly name: "--limit";
+                    readonly value: "<count>";
+                    readonly required: false;
+                    readonly description: "Maximum results; defaults to 5.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }];
+                readonly examples: readonly ["runpane docs search --query \"archive a pane\" --json"];
+                readonly jsonSchemas: readonly ["docsSearchResult"];
+                readonly notes: readonly ["Works offline. Skills are found in the Pane data directory when the Pane app has installed them."];
+            };
+            readonly "docs read": {
+                readonly name: "docs read";
+                readonly summary: "Read one Pane doc, help topic, or skill in full.";
+                readonly details: "Use this with a path from `runpane docs search`.";
+                readonly requiresPaneDaemon: false;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--doc";
+                    readonly value: "<path>";
+                    readonly required: true;
+                    readonly description: "Path from docs search, such as docs/PANE_MCP.md.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }];
+                readonly examples: readonly ["runpane docs read --doc docs/PANE_MCP.md --json"];
+                readonly jsonSchemas: readonly ["docsReadResult"];
+                readonly notes: readonly ["Paths come from docs search: `docs/<file>.md`, `skills/<name>/SKILL.md`, `help/<topic>`, or `command/<name>`."];
+            };
+            readonly "agents start": {
+                readonly name: "agents start";
+                readonly summary: "Start an agent on a task: create a Pane in a repository, launch the agent with the prompt, and wait until it is ready.";
+                readonly details: "Use this for the common job \"have an agent work on X in repo Y\". It returns the pane and panel ids and a pane:// link to hand the user.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--repo";
+                    readonly value: "<selector>";
+                    readonly required: true;
+                    readonly description: "Repository: active, id, exact path, or saved name.";
+                }, {
+                    readonly name: "--name";
+                    readonly value: "<name>";
+                    readonly required: true;
+                    readonly description: "Name for the new Pane.";
+                }, {
+                    readonly name: "--agent";
+                    readonly value: "<codex|claude|cursor>";
+                    readonly required: false;
+                    readonly description: "Built-in agent to launch.";
+                }, {
+                    readonly name: "--tool-command";
+                    readonly value: "<command>";
+                    readonly required: false;
+                    readonly description: "Custom terminal command instead of a built-in agent.";
+                }, {
+                    readonly name: "--prompt";
+                    readonly value: "<task>";
+                    readonly required: true;
+                    readonly description: "The task to send once the agent is ready.";
+                }, {
+                    readonly name: "--base-branch";
+                    readonly value: "<branch>";
+                    readonly required: false;
+                    readonly description: "Branch to start the worktree from.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane agents start --repo active --name fix-login --agent claude --prompt \"Fix the login redirect\" --yes --json"];
+                readonly jsonSchemas: readonly ["agentTaskResult"];
+                readonly notes: readonly ["Creates the Pane in the background (no focus change), pinned, and waits for the agent to be ready before sending the prompt.", "Check on it with `runpane agents status`; send follow-ups with `runpane agents send`."];
+            };
+            readonly "agents status": {
+                readonly name: "agents status";
+                readonly summary: "Check on an agent: whether it is working, ready, blocked, or idle, plus its current screen.";
+                readonly details: "Use this to see how an agent started with `agents start` is doing, or whether it needs input.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: false;
+                    readonly description: "Pane id; its agent panel is used.";
+                }, {
+                    readonly name: "--panel";
+                    readonly value: "<panel-id>";
+                    readonly required: false;
+                    readonly description: "Panel id.";
+                }, {
+                    readonly name: "--limit";
+                    readonly value: "<count>";
+                    readonly required: false;
+                    readonly description: "Screen lines to return; defaults to 40.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane agents status --pane <pane-id> --json"];
+                readonly jsonSchemas: readonly ["agentStatusResult"];
+                readonly notes: readonly ["`status` is `working`, `ready`, `blocked`, `idle`, `exited`, or `unknown`. `blocked` means the agent is waiting on a person."];
+            };
+            readonly "agents send": {
+                readonly name: "agents send";
+                readonly summary: "Send a follow-up message to an agent and confirm it was submitted.";
+                readonly details: "Use this to answer an agent or give it the next instruction.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: false;
+                    readonly description: "Pane id; its agent panel is used.";
+                }, {
+                    readonly name: "--panel";
+                    readonly value: "<panel-id>";
+                    readonly required: false;
+                    readonly description: "Panel id.";
+                }, {
+                    readonly name: "--text";
+                    readonly value: "<message>";
+                    readonly required: true;
+                    readonly description: "The message to submit.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm this change; required in non-interactive shells.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane agents send --pane <pane-id> --text \"Also add a test\" --yes --json"];
+                readonly jsonSchemas: readonly ["agentSendResult"];
+                readonly notes: readonly ["`delivered` is true only when Pane saw the message leave the composer.", "It types the text and presses Enter, so it is for messages, not keys. To answer a menu, use `runpane panels input --panel <panel-id> --keys down,enter --yes`, then check the screen with `runpane agents status`."];
+            };
             readonly "sessions list": {
                 readonly name: "sessions list";
                 readonly summary: "List durable named orchestration Sessions.";
@@ -4401,7 +5726,7 @@ export declare const RUNPANE_CONTRACT: {
                 readonly notes: readonly [];
             };
         };
-        readonly managedBlock: readonly ["## Pane", "", "The developer is using Pane for this repository. Pane can manage saved repositories and create user-visible Panes with terminal-backed tools for planning, discussion, implementation, and review work.", "", "This managed guidance was created by [runpane.com](https://runpane.com) for the [Pane repository](https://github.com/dcouple/Pane). Do not delete or overwrite this block; the developer uses it for their workflow and it should remain committed to the main repository unless they explicitly ask to remove it.", "", "Pane mental model: a repository is the saved base repo; a Pane is a user-visible feature/PR workspace (Pane session) that normally maps to one Pane-managed git worktree and branch; a panel/tab is a terminal inside one Pane and shares that Pane's worktree; an agent is the CLI process running in a panel.", "", "Default happy path when the user asks you to use Pane or RunPane: run `runpane doctor --json`; read `runpane agent-context --json`; resolve the saved base repository with `runpane repos list --json` or add it once with `runpane repos add --path <repo> --yes --json`; create one visible Pane (Pane session) for the requested feature/PR with a complete command such as `runpane panes create --repo <repo> --name <name> --agent <agent> --prompt \"<task>\" --source agent --no-focus --wait-ready --yes --json` or the equivalent `--tool-command <command>` form; then validate with `runpane panels wait` or `runpane panels screen` before reporting progress. For long-lived supervision, use `runpane watch --follow` instead of polling wait or screen.", "", "Use Pane when the user wants visible Panes or co-drivable parallel feature/PR workspaces. Do not use Pane as your default private delegation mechanism; for private background decomposition, use your normal subagent/worktree workflow.", "", "Register the main/base repository once. Do not register pre-created git worktrees as separate Pane repositories unless the user explicitly asks.", "", "Use `runpane panes create` for separate visible Panes (Pane sessions) for feature/PR work. Use `runpane panels create` for reviewer/helper tabs inside an existing Pane that should share that Pane's worktree.", "", "Typical workflow: register the saved base repository once; create one Pane (Pane session) per feature/PR; use panels/tabs inside that Pane for helper or reviewer agents that should share the worktree; archive the Pane after the PR is done to remove it from active Panes and clean up its managed worktree when applicable.", "", "Skill routing reference: Pane installs its skills in `<PANE_DIR>/skills/pane-chat/skills/` (also in `<PANE_DIR>/.claude/skills/` and `<PANE_DIR>/.codex/skills/`), and the Pane Chat entry point is `<PANE_DIR>/skills/pane-chat/pane-orchestrator/SKILL.md`. When the user asks to discuss, plan, implement, review, or test, read the matching skill there, for example `discussion`, `options`, `brief`, `create-ticket`, `tdd`, `quick-verify`, `prepare-pr`, `review`, or `verify-app`.", "Choose the phase from the request: discuss or investigate until the work is clear enough to delegate, then ticket, implement, review, verify, and open the PR as appropriate. Reconcile the skills with the user's request instead of treating any one list as fixed.", "For the Pane implementation source of truth: `main/src/services/skillCacheManager.ts` installs the bundle from `main/src/services/paneChatBundle/` into `<PANE_DIR>/skills/pane-chat/` and generates `pane-orchestrator`; `main/src/services/paneChatManager.ts` owns the tiny bootstrap prompt that tells the selected Pane Chat agent to read it.", "Do not hardcode a specific assistant brand in workflow guidance. Use the Pane agent or custom tool command the user selected, and use `runpane agents doctor --agent <agent> --repo <selector> --json` only when checking a built-in agent template.", "", "Start with `runpane doctor --json` before taking Pane actions. Use it to understand wrapper/runtime details, daemon reachability, and the next safe commands.", "", "In a Pane repository checkout, if `runpane` is not on PATH, use the built local wrapper with Node 22: `PATH=/opt/homebrew/opt/node@22/bin:$PATH node packages/runpane/dist/cli.js doctor --json`.", "", "Use `runpane agent-context --json` for full Pane CLI context. Use `runpane agent-context --command \"watch\" --json` or another command name for detailed schema only when needed.", "", "Default to context-safe validation: after creating Panes or sending terminal input, run `runpane panels wait` or `runpane panels screen` before reporting success. For ongoing supervision, `runpane watch --follow` is the canonical monitor; do not poll wait or screen. Prefer `runpane panels submit` for normal text plus Enter; use `runpane panels input` only for exact bytes such as Ctrl-C or escape sequences.", "", "Pane terminals draw inline images: sixel, iTerm2 inline images, and the kitty graphics protocol. Tools that need kitty graphics, such as [terminal-browser](https://github.com/zenbu-labs/terminal-browser) and [terminal-doom](https://github.com/dcouple/terminal-doom), run inside a Pane panel. `runpane doctor --json` reports the protocol list under `terminal.graphicsProtocols`.", "", "Common commands:", "- `runpane doctor --json`", "- `runpane agent-context --json`", "- `runpane repos list --json`", "- `runpane repos add --path <repo> --yes --json`", "- `runpane agents doctor --agent <agent> --repo active --json`", "- `runpane panes create --repo active --name <name> --agent <agent> --prompt \"<task>\" --source agent --no-focus --wait-ready --yes --json`", "- `runpane panels create --pane <pane-id> --agent <agent> --source agent --no-focus --wait-ready --yes --json`", "- `runpane panels list --pane <pane-id> --json`", "- `runpane panels screen --panel <panel-id> --limit 80 --json`", "- `runpane panels wait --panel <panel-id> --for ready --timeout-ms 30000 --json`", "- `runpane watch --follow --json`", "- `runpane panels submit --panel <panel-id> --text \"<answer>\" --yes --json`", "- `runpane panels input --panel <panel-id> --input-file <path|-> --yes --json`", "", "WSL note: if `runpane doctor --json` cannot find `/tmp/pane-daemon.../daemon.sock` or `runpane` resolves to a broken Windows shim, Pane may be running on Windows. Try `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane doctor --json'`, then create Panes through the same PowerShell form using the saved WSL repo name or id. Use `runpane agents doctor --agent <agent> --repo <selector> --json` to diagnose the repo environment Pane will actually use."];
+        readonly managedBlock: readonly ["## Pane", "", "This repository is used with [Pane](https://runpane.com). Drive it with the CLI or the `pane` MCP server.", "", "CLI: `npm i -g runpane` (or `npx --yes runpane@latest`), then `runpane doctor --json`. Full command reference: `runpane agent-context --json`.", "", "MCP: packaged Pane registers a stdio server named `pane` with Claude Code and Codex. Check the connection with `claude mcp list` or `codex mcp list`. If tools are missing, add it in the agent's MCP settings: Claude Code `claude mcp add --scope user pane -- npx --yes runpane@latest mcp`; Codex (`~/.codex/config.toml`) table `[mcp_servers.pane]` with `command = \"npx\"` and `args = [\"--yes\", \"runpane@latest\", \"mcp\"]`; any other stdio client uses the same command and args."];
     };
 };
 export type RunpaneCommand = typeof RUNPANE_CONTRACT.commands[number]['name'];