runpane 2.4.29 → 2.4.34

package/dist/generated/contract.d.ts

@@ -103,6 +103,24 @@ export declare const RUNPANE_CONTRACT: {
         readonly usage: readonly ["runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--source user|agent] [--focus|--no-focus] [options]", "runpane panes create --from-json <path|-> [--yes] [--json]"];
         readonly mutates: true;
         readonly jsonSchemas: readonly ["paneCreateRequest", "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] --yes [--json]"];
+        readonly mutates: true;
+        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 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 jsonSchemas: readonly ["panePinRequest", "panePinResult"];
     }, {
         readonly name: "panels create";
         readonly summary: "Create a terminal-backed tool panel inside an existing Pane session.";
@@ -326,11 +344,17 @@ export declare const RUNPANE_CONTRACT: {
         }, {
             readonly name: "--focus";
             readonly description: "Explicitly focus the created pane or panel.";
+        }, {
+            readonly name: "--pinned";
+            readonly description: "Create the pane already pinned (the UI's favorite/pin star).";
+        }, {
+            readonly name: "--force";
+            readonly description: "Archive even if the pane's branch has uncommitted, untracked, or unpushed changes.";
         }];
     };
     readonly help: {
         readonly npm: {
-            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane agent-context [--json]", "  runpane agents doctor --agent <codex|claude> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  runpane panels create --pane <pane-id> --agent <codex|claude> [--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 agent-context [--json]", "  runpane agents doctor --agent <codex|claude> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] --yes", "  runpane panels create --pane <pane-id> --agent <codex|claude> [--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 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"];
@@ -338,9 +362,12 @@ export declare const RUNPANE_CONTRACT: {
             readonly doctor: readonly ["Usage:", "  runpane doctor [--json] [--pane-dir <path>] [--pane-path <path>] [--format <format>] [--verbose]", "", "Checks wrapper/runtime details, release metadata, installed Pane detection, and Pane daemon reachability.", "", "Options:", "  --json                         Print a machine-readable environment report", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --pane-path <path>             Inspect a specific Pane executable", "  --format <format>              Release artifact format to inspect", "  --verbose                      Print extra diagnostics", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json"];
             readonly "repos list": readonly ["Usage:", "  runpane repos list [--json] [--pane-dir <path>]", "", "Lists repositories saved in the running Pane app.", "", "Options:", "  --json                         Print machine-readable output", "  --pane-dir <path>              Connect to a specific Pane data directory"];
             readonly "repos add": readonly ["Usage:", "  runpane repos add --path <path> [--name <name>] [--json] [--yes]", "", "Registers an existing git repository with the running Pane app.", "", "Options:", "  --path <path>                  Existing git repository path", "  --name <name>                  Saved repository name; defaults to the directory name", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --dry-run                      Validate and preview without adding the repo", "  --yes                          Skip confirmation for mutating commands"];
-            readonly panes: readonly ["Pane session commands.", "", "Usage:", "  runpane panes <command> [options]", "", "Commands:", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "", "Run \"runpane help panes list\" or \"runpane help panes create\" for command-specific options."];
+            readonly panes: readonly ["Pane session commands.", "", "Usage:", "  runpane panes <command> [options]", "", "Commands:", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes archive --pane <pane-id> [--force] [--source user|agent] --yes [--json]", "  runpane panes pin --pane <pane-id> --yes [--dry-run] [--json]", "  runpane panes unpin --pane <pane-id> --yes [--dry-run] [--json]", "", "Run \"runpane help panes <command>\" for command-specific options."];
             readonly "panes list": readonly ["Usage:", "  runpane panes list [--repo <selector>] [--json]", "", "Lists Pane sessions. Pass --repo to limit results to one saved repository.", "", "Options:", "  --repo <selector>              active, id, exact path, or saved repository name", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
-            readonly "panes create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes create --from-json <path|-> [--yes] [--json]", "", "Creates user-visible Panes (Pane sessions) for feature/PR work in a saved repository and opens a terminal-backed tool tab. Pane creates and owns the worktree/branch for each new Pane.", "", "Options:", "  --repo <selector>              active, id, exact path, or saved repository name", "  --name <name>                  Pane/session name", "  --worktree-name <name>         Worktree name; defaults to --name", "  --base-branch <branch>         Base branch for the worktree", "  --agent <codex|claude>         Built-in terminal template", "  --tool-command <command>       Custom terminal command", "  --title <title>                Terminal tab title", "  --initial-input <text>         Text sent after the command is ready", "  --prompt <text>                Alias for --initial-input", "  --initial-input-file <path|->  Read initial input from a file or stdin", "  --from-json <path|->           Read a full request payload", "  --timeout-ms <milliseconds>    Pane creation timeout", "  --wait-ready                   Wait for terminal readiness before returning", "  --ready-timeout-ms <ms>        Readiness wait timeout; defaults to 30000", "  --concurrency <count>          Accepted; creation is currently serialized", "  --source <user|agent>          Mark mutation source; agent implies background creation", "  --no-focus                     Create in the background without stealing focus", "  --focus                        Explicitly focus the created pane", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --dry-run                      Validate and preview without creating panes", "  --yes                          Skip confirmation for mutating commands"];
+            readonly "panes create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes create --from-json <path|-> [--yes] [--json]", "", "Creates user-visible Panes (Pane sessions) for feature/PR work in a saved repository and opens a terminal-backed tool tab. Pane creates and owns the worktree/branch for each new Pane.", "", "Options:", "  --repo <selector>              active, id, exact path, or saved repository name", "  --name <name>                  Pane/session name", "  --worktree-name <name>         Worktree name; defaults to --name", "  --base-branch <branch>         Base branch for the worktree", "  --agent <codex|claude>         Built-in terminal template", "  --tool-command <command>       Custom terminal command", "  --title <title>                Terminal tab title", "  --initial-input <text>         Text sent after the command is ready", "  --prompt <text>                Alias for --initial-input", "  --initial-input-file <path|->  Read initial input from a file or stdin", "  --from-json <path|->           Read a full request payload", "  --timeout-ms <milliseconds>    Pane creation timeout", "  --wait-ready                   Wait for terminal readiness before returning", "  --ready-timeout-ms <ms>        Readiness wait timeout; defaults to 30000", "  --concurrency <count>          Accepted; creation is currently serialized", "  --source <user|agent>          Mark mutation source; agent implies background creation", "  --no-focus                     Create in the background without stealing focus", "  --focus                        Explicitly focus the created pane", "  --pinned                       Create already pinned (the UI's favorite/pin star)", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --dry-run                      Validate and preview without creating panes", "  --yes                          Skip confirmation for mutating commands"];
+            readonly "panes archive": readonly ["Usage:", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] --yes [--json]", "", "Archives a Pane (session) exactly like the UI Archive action, including removal of its Pane-managed git worktree. Refuses to archive a pane with uncommitted, untracked, or unpushed-to-remote changes unless --force is passed. Waits for worktree removal to finish before returning.", "", "Options:", "  --pane <pane-id>               Pane/session id to archive", "  --source <user|agent>          Mark mutation source", "  --force                        Archive even if the pane has uncommitted, untracked, or unpushed changes", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --yes                          Skip confirmation for mutating commands"];
+            readonly "panes pin": readonly ["Usage:", "  runpane panes pin --pane <pane-id> --yes [--dry-run] [--json]", "", "Declaratively pins a Pane using the Pane UI's favorite/pin star. Repeating the command is idempotent and never changes focus. Use --dry-run to validate and preview without mutating.", "", "Options:", "  --pane <pane-id>               Pane/session id to pin", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --dry-run                      Validate and preview without pinning the pane", "  --yes                          Skip confirmation for mutating commands"];
+            readonly "panes unpin": readonly ["Usage:", "  runpane panes unpin --pane <pane-id> --yes [--dry-run] [--json]", "", "Declaratively unpins a Pane using the Pane UI's favorite/pin star. Repeating the command is idempotent and never changes focus. Use --dry-run to validate and preview without mutating.", "", "Options:", "  --pane <pane-id>               Pane/session id to unpin", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --dry-run                      Validate and preview without unpinning the pane", "  --yes                          Skip confirmation for mutating commands"];
             readonly panels: readonly ["Terminal-backed panel commands.", "", "Usage:", "  runpane panels <command> [options]", "", "Commands:", "  runpane panels create --pane <pane-id> --agent <codex|claude> [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"];
@@ -354,7 +381,7 @@ export declare const RUNPANE_CONTRACT: {
             readonly "panels submit-composer": readonly ["Submit an agent composer using the panel-appropriate key sequence.", "", "Usage:", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]", "", "Options:", "  --panel <panel-id>            Terminal panel id.", "  --strategy <strategy>         Defaults to auto; Codex sends Ctrl+Enter and other panels send Enter.", "  --yes                         Skip confirmation prompts.", "  --json                        Print JSON output."];
         };
         readonly pip: {
-            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane agent-context [--json]", "  runpane agents doctor --agent <codex|claude> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  python -m runpane panels create --pane <pane-id> --agent <codex|claude> [--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 agent-context [--json]", "  runpane agents doctor --agent <codex|claude> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] --yes", "  python -m runpane panels create --pane <pane-id> --agent <codex|claude> [--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 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]"];
@@ -362,9 +389,12 @@ export declare const RUNPANE_CONTRACT: {
             readonly doctor: readonly ["Usage:", "  runpane doctor [--json] [--pane-dir <path>] [--pane-path <path>] [--format <format>] [--verbose]", "", "Checks wrapper/runtime details, release metadata, installed Pane detection, and Pane daemon reachability.", "", "Options:", "  --json", "  --pane-dir <path>", "  --pane-path <path>", "  --format <format>", "  --verbose", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json"];
             readonly "repos list": readonly ["Usage:", "  runpane repos list [--json] [--pane-dir <path>]", "", "Lists repositories saved in the running Pane app.", "", "Options:", "  --json", "  --pane-dir <path>"];
             readonly "repos add": readonly ["Usage:", "  runpane repos add --path <path> [--name <name>] [--json] [--yes]", "", "Registers an existing git repository with the running Pane app.", "", "Options:", "  --path <path>", "  --name <name>", "  --pane-dir <path>", "  --json", "  --dry-run", "  --yes"];
-            readonly panes: readonly ["Pane session commands.", "", "Usage:", "  runpane panes <command> [options]", "", "Commands:", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "", "Run \"runpane help panes list\" or \"runpane help panes create\" for command-specific options."];
+            readonly panes: readonly ["Pane session commands.", "", "Usage:", "  runpane panes <command> [options]", "", "Commands:", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes archive --pane <pane-id> [--force] [--source user|agent] --yes [--json]", "  runpane panes pin --pane <pane-id> --yes [--dry-run] [--json]", "  runpane panes unpin --pane <pane-id> --yes [--dry-run] [--json]", "", "Run \"runpane help panes <command>\" for command-specific options."];
             readonly "panes list": readonly ["Usage:", "  runpane panes list [--repo <selector>] [--json]", "", "Lists Pane sessions. Pass --repo to limit results to one saved repository.", "", "Options:", "  --repo <selector>", "  --pane-dir <path>", "  --json"];
-            readonly "panes create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes create --from-json <path|-> [--yes] [--json]", "", "Creates user-visible Panes (Pane sessions) for feature/PR work in a saved repository and opens a terminal-backed tool tab. Pane creates and owns the worktree/branch for each new Pane.", "", "Options:", "  --repo <selector>              active, id, exact path, or saved repository name", "  --name <name>                  Pane/session name", "  --worktree-name <name>         Worktree name; defaults to --name", "  --base-branch <branch>         Base branch for the worktree", "  --agent <codex|claude>         Built-in terminal template", "  --tool-command <command>       Custom terminal command", "  --title <title>                Terminal tab title", "  --initial-input <text>         Text sent after the command is ready", "  --prompt <text>                Alias for --initial-input", "  --initial-input-file <path|->  Read initial input from a file or stdin", "  --from-json <path|->           Read a full request payload", "  --timeout-ms <milliseconds>    Pane creation timeout", "  --wait-ready                   Wait for terminal readiness before returning", "  --ready-timeout-ms <ms>        Readiness wait timeout; defaults to 30000", "  --concurrency <count>          Accepted; creation is currently serialized", "  --source <user|agent>          Mark mutation source; agent implies background creation", "  --no-focus                     Create in the background without stealing focus", "  --focus                        Explicitly focus the created pane", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --dry-run                      Validate and preview without creating panes", "  --yes                          Skip confirmation for mutating commands"];
+            readonly "panes create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes create --from-json <path|-> [--yes] [--json]", "", "Creates user-visible Panes (Pane sessions) for feature/PR work in a saved repository and opens a terminal-backed tool tab. Pane creates and owns the worktree/branch for each new Pane.", "", "Options:", "  --repo <selector>              active, id, exact path, or saved repository name", "  --name <name>                  Pane/session name", "  --worktree-name <name>         Worktree name; defaults to --name", "  --base-branch <branch>         Base branch for the worktree", "  --agent <codex|claude>         Built-in terminal template", "  --tool-command <command>       Custom terminal command", "  --title <title>                Terminal tab title", "  --initial-input <text>         Text sent after the command is ready", "  --prompt <text>                Alias for --initial-input", "  --initial-input-file <path|->  Read initial input from a file or stdin", "  --from-json <path|->           Read a full request payload", "  --timeout-ms <milliseconds>    Pane creation timeout", "  --wait-ready                   Wait for terminal readiness before returning", "  --ready-timeout-ms <ms>        Readiness wait timeout; defaults to 30000", "  --concurrency <count>          Accepted; creation is currently serialized", "  --source <user|agent>          Mark mutation source; agent implies background creation", "  --no-focus                     Create in the background without stealing focus", "  --focus                        Explicitly focus the created pane", "  --pinned                       Create already pinned (the UI's favorite/pin star)", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --dry-run                      Validate and preview without creating panes", "  --yes                          Skip confirmation for mutating commands"];
+            readonly "panes archive": readonly ["Usage:", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] --yes [--json]", "", "Archives a Pane (session) exactly like the UI Archive action, including removal of its Pane-managed git worktree. Refuses to archive a pane with uncommitted, untracked, or unpushed-to-remote changes unless --force is passed. Waits for worktree removal to finish before returning.", "", "Options:", "  --pane <pane-id>", "  --source <user|agent>", "  --force", "  --pane-dir <path>", "  --json", "  --yes"];
+            readonly "panes pin": readonly ["Usage:", "  runpane panes pin --pane <pane-id> --yes [--dry-run] [--json]", "", "Declaratively pins a Pane using the Pane UI's favorite/pin star. Repeating the command is idempotent and never changes focus. Use --dry-run to validate and preview without mutating.", "", "Options:", "  --pane <pane-id>", "  --pane-dir <path>", "  --json", "  --dry-run", "  --yes"];
+            readonly "panes unpin": readonly ["Usage:", "  runpane panes unpin --pane <pane-id> --yes [--dry-run] [--json]", "", "Declaratively unpins a Pane using the Pane UI's favorite/pin star. Repeating the command is idempotent and never changes focus. Use --dry-run to validate and preview without mutating.", "", "Options:", "  --pane <pane-id>", "  --pane-dir <path>", "  --json", "  --dry-run", "  --yes"];
             readonly panels: readonly ["Terminal-backed panel commands.", "", "Usage:", "  runpane panels <command> [options]", "", "Commands:", "  runpane panels create --pane <pane-id> --agent <codex|claude> [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"];
@@ -384,8 +414,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 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 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 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 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 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 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.", "`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.", "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'`."];
+        readonly commandUsages: readonly ["runpane", "runpane setup", "runpane install", "runpane install client", "runpane install daemon", "runpane update", "runpane version", "runpane doctor", "runpane doctor --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 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 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 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 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 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.", "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` archives a Pane exactly like the UI Archive action, including removal of its Pane-managed git worktree, and refuses (unless `--force`) when the pane's branch has uncommitted, untracked, or unpushed-to-remote changes. It waits for worktree removal to finish before returning and reports the outcome in `worktreeCleanup`.", "`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'`."];
         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 list`, `runpane panes create`, 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.";
@@ -393,8 +423,8 @@ 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 ["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", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--source", "agent", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--from-json", "-", "--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 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 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 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 ["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", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--source", "agent", "--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 ["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 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"];
         readonly installHelpIncludes: readonly ["--version <latest|vX.Y.Z>", "--format <auto|appimage|deb|dmg|zip|exe>", "--download-dir <path>", "--pane-path <path>", "--label <name>", "--prefer-tunnel <tailscale|ssh|manual|auto>", "--repo-ref <ref>"];
@@ -725,6 +755,9 @@ export declare const RUNPANE_CONTRACT: {
                             readonly sessionPrompt: {
                                 readonly type: "string";
                             };
+                            readonly pinned: {
+                                readonly type: "boolean";
+                            };
                             readonly tool: {
                                 readonly oneOf: readonly [{
                                     readonly type: "object";
@@ -804,7 +837,7 @@ export declare const RUNPANE_CONTRACT: {
                     readonly items: {
                         readonly oneOf: readonly [{
                             readonly type: "object";
-                            readonly required: readonly ["ok", "index", "name"];
+                            readonly required: readonly ["ok", "index", "name", "pinned"];
                             readonly properties: {
                                 readonly ok: {
                                     readonly type: "boolean";
@@ -815,6 +848,9 @@ export declare const RUNPANE_CONTRACT: {
                                 readonly name: {
                                     readonly type: "string";
                                 };
+                                readonly pinned: {
+                                    readonly type: "boolean";
+                                };
                                 readonly sessionId: {
                                     readonly type: "string";
                                 };
@@ -904,7 +940,7 @@ export declare const RUNPANE_CONTRACT: {
                                             readonly required: readonly ["kind", "message"];
                                             readonly properties: {
                                                 readonly kind: {
-                                                    readonly enum: readonly ["codex-update", "agent-prompt", "unknown"];
+                                                    readonly enum: readonly ["codex-update", "agent-prompt", "submission_unverified", "unknown"];
                                                 };
                                                 readonly message: {
                                                     readonly type: "string";
@@ -943,6 +979,12 @@ export declare const RUNPANE_CONTRACT: {
                                         readonly verifiedSubmitted: {
                                             readonly type: "boolean";
                                         };
+                                        readonly staged: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly attempts: {
+                                            readonly type: "number";
+                                        };
                                         readonly sentAt: {
                                             readonly type: "string";
                                         };
@@ -951,7 +993,7 @@ export declare const RUNPANE_CONTRACT: {
                                             readonly required: readonly ["kind", "message"];
                                             readonly properties: {
                                                 readonly kind: {
-                                                    readonly enum: readonly ["codex-update", "agent-prompt", "unknown"];
+                                                    readonly enum: readonly ["codex-update", "agent-prompt", "submission_unverified", "unknown"];
                                                 };
                                                 readonly message: {
                                                     readonly type: "string";
@@ -1031,7 +1073,7 @@ export declare const RUNPANE_CONTRACT: {
                     readonly type: "array";
                     readonly items: {
                         readonly type: "object";
-                        readonly required: readonly ["id", "paneId", "name", "status", "worktreePath", "repoId", "panelCount"];
+                        readonly required: readonly ["id", "paneId", "name", "status", "worktreePath", "repoId", "panelCount", "pinned"];
                         readonly properties: {
                             readonly id: {
                                 readonly type: "string";
@@ -1057,6 +1099,9 @@ export declare const RUNPANE_CONTRACT: {
                             readonly panelCount: {
                                 readonly type: "number";
                             };
+                            readonly pinned: {
+                                readonly type: "boolean";
+                            };
                             readonly createdAt: {
                                 readonly type: "string";
                             };
@@ -1073,6 +1118,159 @@ export declare const RUNPANE_CONTRACT: {
             };
             readonly additionalProperties: false;
         };
+        readonly paneArchiveRequest: {
+            readonly type: "object";
+            readonly required: readonly ["paneId"];
+            readonly properties: {
+                readonly paneId: {
+                    readonly type: "string";
+                };
+                readonly force: {
+                    readonly type: "boolean";
+                };
+                readonly source: {
+                    readonly enum: readonly ["user", "agent"];
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly panePinRequest: {
+            readonly type: "object";
+            readonly required: readonly ["paneId", "pinned"];
+            readonly properties: {
+                readonly paneId: {
+                    readonly type: "string";
+                };
+                readonly pinned: {
+                    readonly type: "boolean";
+                };
+                readonly dryRun: {
+                    readonly type: "boolean";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly panePinResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "paneId", "pinned"];
+            readonly properties: {
+                readonly ok: {
+                    readonly const: true;
+                };
+                readonly paneId: {
+                    readonly type: "string";
+                };
+                readonly pinned: {
+                    readonly type: "boolean";
+                };
+                readonly dryRun: {
+                    readonly const: true;
+                };
+                readonly favoritePinnedAt: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly paneArchiveResult: {
+            readonly oneOf: readonly [{
+                readonly type: "object";
+                readonly required: readonly ["ok", "paneId", "archived", "forced", "worktreeCleanup", "safetyCheck"];
+                readonly properties: {
+                    readonly ok: {
+                        readonly type: "boolean";
+                    };
+                    readonly paneId: {
+                        readonly type: "string";
+                    };
+                    readonly archived: {
+                        readonly const: true;
+                    };
+                    readonly forced: {
+                        readonly type: "boolean";
+                    };
+                    readonly worktreeCleanup: {
+                        readonly enum: readonly ["completed", "failed", "timeout", "not-applicable"];
+                    };
+                    readonly worktreePath: {
+                        readonly type: "string";
+                    };
+                    readonly safetyCheck: {
+                        readonly type: "object";
+                        readonly required: readonly ["performed"];
+                        readonly properties: {
+                            readonly performed: {
+                                readonly type: "boolean";
+                            };
+                            readonly hasUncommittedChanges: {
+                                readonly type: "boolean";
+                            };
+                            readonly hasUntrackedFiles: {
+                                readonly type: "boolean";
+                            };
+                            readonly hasUpstream: {
+                                readonly type: "boolean";
+                            };
+                            readonly unpushedCommits: {
+                                readonly type: "number";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                };
+                readonly additionalProperties: false;
+            }, {
+                readonly type: "object";
+                readonly required: readonly ["ok", "paneId", "blocked", "nextCommand"];
+                readonly properties: {
+                    readonly ok: {
+                        readonly const: false;
+                    };
+                    readonly paneId: {
+                        readonly type: "string";
+                    };
+                    readonly blocked: {
+                        readonly type: "object";
+                        readonly required: readonly ["code", "message", "safetyCheck"];
+                        readonly properties: {
+                            readonly code: {
+                                readonly enum: readonly ["uncommitted-changes", "unpushed-commits", "uncommitted-and-unpushed", "status-unknown"];
+                            };
+                            readonly message: {
+                                readonly type: "string";
+                            };
+                            readonly safetyCheck: {
+                                readonly type: "object";
+                                readonly required: readonly ["performed"];
+                                readonly properties: {
+                                    readonly performed: {
+                                        readonly type: "boolean";
+                                    };
+                                    readonly hasUncommittedChanges: {
+                                        readonly type: "boolean";
+                                    };
+                                    readonly hasUntrackedFiles: {
+                                        readonly type: "boolean";
+                                    };
+                                    readonly hasUpstream: {
+                                        readonly type: "boolean";
+                                    };
+                                    readonly unpushedCommits: {
+                                        readonly type: "number";
+                                    };
+                                };
+                                readonly additionalProperties: false;
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly nextCommand: {
+                        readonly type: "string";
+                    };
+                };
+                readonly additionalProperties: false;
+            }];
+        };
         readonly panelListResult: {
             readonly type: "object";
             readonly required: readonly ["ok", "paneId", "panels"];
@@ -1491,7 +1689,7 @@ export declare const RUNPANE_CONTRACT: {
                     readonly required: readonly ["kind", "message"];
                     readonly properties: {
                         readonly kind: {
-                            readonly enum: readonly ["codex-update", "agent-prompt", "unknown"];
+                            readonly enum: readonly ["codex-update", "agent-prompt", "submission_unverified", "unknown"];
                         };
                         readonly message: {
                             readonly type: "string";
@@ -1702,7 +1900,7 @@ export declare const RUNPANE_CONTRACT: {
                             readonly required: readonly ["kind", "message"];
                             readonly properties: {
                                 readonly kind: {
-                                    readonly enum: readonly ["codex-update", "agent-prompt", "unknown"];
+                                    readonly enum: readonly ["codex-update", "agent-prompt", "submission_unverified", "unknown"];
                                 };
                                 readonly message: {
                                     readonly type: "string";
@@ -1771,7 +1969,7 @@ export declare const RUNPANE_CONTRACT: {
                     readonly required: readonly ["kind", "message"];
                     readonly properties: {
                         readonly kind: {
-                            readonly enum: readonly ["codex-update", "agent-prompt", "unknown"];
+                            readonly enum: readonly ["codex-update", "agent-prompt", "submission_unverified", "unknown"];
                         };
                         readonly message: {
                             readonly type: "string";
@@ -1793,7 +1991,7 @@ export declare const RUNPANE_CONTRACT: {
         readonly brief: {
             readonly title: "Pane agent context";
             readonly summary: "Pane lets a developer manage saved base repositories, user-visible Panes (Pane sessions) for feature/PR work, and terminal-backed panel tabs. A Pane is a visible workspace that normally maps to one Pane-managed git worktree and branch; a panel is a terminal tab inside one Pane and shares that Pane's worktree; an agent is a CLI process running inside a panel.";
-            readonly rules: readonly ["Start with `runpane doctor --json` to understand wrapper, platform, daemon reachability, and the next safe commands before mutating Pane state.", "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`.", "Happy path for any user request to use Pane/RunPane: run `runpane doctor --json`, read `runpane agent-context --json`, resolve or add the saved base repo, create the requested visible Pane 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 use `--tool-command <command>` instead of `--agent <agent>`), then validate with `panels wait` or `panels screen`.", "Treat Pane as the user's visible cockpit for watching/co-driving work. Do not create Panes or panels for private delegation unless the user asked for visible Pane orchestration or the result should appear in the Pane app.", "Register the saved base repository once with `repos add`; do not register a pre-created worktree as a separate repo unless the user explicitly asks.", "Use `panes create` for separate visible Panes (Pane sessions) for feature/PR work. Pane creates and owns the worktree/branch for each new Pane.", "Use `panels create` for reviewer/helper/clean-context tabs that should stay inside an existing Pane and share that Pane's worktree.", "For private background decomposition, use your normal subagent/worktree mechanism instead of Pane.", "Skill routing: when the user says `discussion`, `plan`, `simple-plan`, `create-plan`, or `implement`, or asks for those behaviors, treat three references as peer context: Pane's local skill cache under `<PANE_DIR>/skills/`, the Pane Chat orchestrator handoff at `<PANE_DIR>/skills/pane-chat/runpane-orchestrator.md` when present, and the workflow map at https://github.com/dcouple/skills/raw/main/docs/readme-workflow-map.png. For where the local cache and Pane Chat bootstrap live in Pane, reference https://github.com/dcouple/Pane/pull/291. Use GitHub reads against https://github.com/dcouple/skills/tree/main/parsa only to inspect or refresh referenced skill files; do not clone or install it unless the user asks.", "When an agent creates Panes or panels, pass `--source agent --no-focus --wait-ready --yes --json` unless the user explicitly wants focus moved.", "Use `runpane agent-context --json` for the full agent-facing CLI context, or `runpane agent-context --command <command> --json` for one detailed command definition.", "For `agent-context --command`, use canonical spaced names like `panes create`; copied forms like `panes.create` or `runpane panes create` are accepted too.", "Use `runpane repos list --json` to find the saved repository when unsure after doctor shows the daemon is reachable.", "If WSL cannot reach Pane or `runpane` resolves to a broken Windows shim, the user may be running Windows Pane; try `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane doctor --json'`.", "If the repository exists on disk but is not saved in Pane, use `runpane repos add --path <repo> --yes --json` before creating panes.", "Use `runpane agents doctor --agent <codex|claude> --repo <selector> --json` when agent availability differs across host, Windows, WSL, or repo environments.", "Use `runpane panes create --wait-ready` to create Panes and validate initial terminal readiness in one call.", "Use `runpane panels screen` for compact current state, `panels wait` for readiness/text checks, `panels submit` for ordinary Enter-submitted input, and `panels submit-composer --strategy auto` for agent composers.", "Use `runpane panels input` only when exact bytes are required, such as Ctrl-C or handcrafted terminal input.", "After creating Panes or sending terminal input, validate with `panels wait` or bounded `panels screen` before reporting success."];
+            readonly rules: readonly ["Start with `runpane doctor --json` to understand wrapper, platform, daemon reachability, and the next safe commands before mutating Pane state.", "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`.", "Happy path for any user request to use Pane/RunPane: run `runpane doctor --json`, read `runpane agent-context --json`, resolve or add the saved base repo, create the requested visible Pane with a complete command such as `runpane panes create --repo <repo> --name <name> --agent <agent> --prompt \"<task>\" --source agent --pinned --no-focus --wait-ready --yes --json` when it should stay visible (or omit `--pinned`, or use `--tool-command <command>` instead of `--agent <agent>`), then validate with `panels wait` or `panels screen`.", "Treat Pane as the user's visible cockpit for watching/co-driving work. Do not create Panes or panels for private delegation unless the user asked for visible Pane orchestration or the result should appear in the Pane app.", "Register the saved base repository once with `repos add`; do not register a pre-created worktree as a separate repo unless the user explicitly asks.", "Use `panes create` for separate visible Panes (Pane sessions) for feature/PR work. Pane creates and owns the worktree/branch for each new Pane.", "Use `panels create` for reviewer/helper/clean-context tabs that should stay inside an existing Pane and share that Pane's worktree.", "For private background decomposition, use your normal subagent/worktree mechanism instead of Pane.", "Skill routing: when the user says `discussion`, `plan`, `simple-plan`, `create-plan`, or `implement`, or asks for those behaviors, treat three references as peer context: Pane's local skill cache under `<PANE_DIR>/skills/`, the Pane Chat orchestrator handoff at `<PANE_DIR>/skills/pane-chat/runpane-orchestrator.md` when present, and the workflow map at https://github.com/dcouple/skills/raw/main/docs/readme-workflow-map.png. For where the local cache and Pane Chat bootstrap live in Pane, reference https://github.com/dcouple/Pane/pull/291. Use GitHub reads against https://github.com/dcouple/skills/tree/main/parsa only to inspect or refresh referenced skill files; do not clone or install it unless the user asks.", "When an agent creates Panes or panels, pass `--source agent --no-focus --wait-ready --yes --json` unless the user explicitly wants focus moved; add `--pinned` when declaring a Pane that should remain in the UI's favorite/pin set.", "Use `runpane agent-context --json` for the full agent-facing CLI context, or `runpane agent-context --command <command> --json` for one detailed command definition.", "For `agent-context --command`, use canonical spaced names like `panes create`; copied forms like `panes.create` or `runpane panes create` are accepted too.", "Use `runpane repos list --json` to find the saved repository when unsure after doctor shows the daemon is reachable.", "If WSL cannot reach Pane or `runpane` resolves to a broken Windows shim, the user may be running Windows Pane; try `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane doctor --json'`.", "If the repository exists on disk but is not saved in Pane, use `runpane repos add --path <repo> --yes --json` before creating panes.", "Use `runpane agents doctor --agent <codex|claude> --repo <selector> --json` when agent availability differs across host, Windows, WSL, or repo environments.", "Use `runpane panes create --wait-ready` to create Panes and validate initial terminal readiness in one call.", "Use `runpane panels screen` for compact current state, `panels wait` for readiness/text checks, `panels submit` for ordinary Enter-submitted input, and `panels submit-composer --strategy auto` for agent composers.", "Use `runpane panels input` only when exact bytes are required, such as Ctrl-C or handcrafted terminal input.", "After creating Panes or sending terminal input, validate with `panels wait` or bounded `panels screen` before reporting success."];
             readonly detailCommand: "runpane agent-context --command <command> [--json]";
             readonly tools: readonly [{
                 readonly name: "doctor";
@@ -1822,7 +2020,19 @@ export declare const RUNPANE_CONTRACT: {
             }, {
                 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 arguments: readonly ["--repo <selector>", "--name <name>", "--agent <codex|claude>", "--tool-command <command>", "--prompt <text>", "--initial-input-file <path|->", "--from-json <path|->", "--source <user|agent>", "--no-focus", "--focus", "--wait-ready", "--ready-timeout-ms <ms>", "--concurrency <count>", "--yes", "--json"];
+                readonly arguments: readonly ["--repo <selector>", "--name <name>", "--agent <codex|claude>", "--tool-command <command>", "--prompt <text>", "--initial-input-file <path|->", "--from-json <path|->", "--source <user|agent>", "--pinned", "--no-focus", "--focus", "--wait-ready", "--ready-timeout-ms <ms>", "--concurrency <count>", "--yes", "--json"];
+            }, {
+                readonly name: "panes archive";
+                readonly summary: "Archive a Pane exactly like the UI Archive action, including safe removal of its Pane-managed git worktree.";
+                readonly arguments: readonly ["--pane <pane-id>", "--source <user|agent>", "--force", "--yes", "--json"];
+            }, {
+                readonly name: "panes pin";
+                readonly summary: "Declaratively pin a Pane (the Pane UI's favorite/pin star) without changing focus.";
+                readonly arguments: readonly ["--pane <pane-id>", "--yes", "--dry-run", "--json"];
+            }, {
+                readonly name: "panes unpin";
+                readonly summary: "Declaratively unpin a Pane (the Pane UI's favorite/pin star) without changing focus.";
+                readonly arguments: readonly ["--pane <pane-id>", "--yes", "--dry-run", "--json"];
             }, {
                 readonly name: "panels create";
                 readonly summary: "Create reviewer/helper terminal tabs inside an existing Pane; they share that Pane's worktree.";
@@ -2142,10 +2352,18 @@ export declare const RUNPANE_CONTRACT: {
                     readonly name: "--focus";
                     readonly required: false;
                     readonly description: "Explicitly focus the created pane.";
+                }, {
+                    readonly name: "--pinned";
+                    readonly required: false;
+                    readonly description: "Create the pane already pinned (the Pane UI's favorite/pin star); does not imply focus.";
                 }, {
                     readonly name: "--yes";
                     readonly required: false;
                     readonly description: "Skip confirmation for mutating commands.";
+                }, {
+                    readonly name: "--dry-run";
+                    readonly required: false;
+                    readonly description: "Validate and preview without mutating.";
                 }, {
                     readonly name: "--json";
                     readonly required: false;
@@ -2167,7 +2385,96 @@ export declare const RUNPANE_CONTRACT: {
                 }];
                 readonly examples: readonly ["runpane panes create --repo active --name issue-257 --agent <agent> --prompt \"Plan this issue\" --source agent --no-focus --wait-ready --yes --json", "runpane panes create --from-json panes.json --yes --json", "runpane panes create --repo active --name issue-123 --agent <agent> --prompt \"Plan this issue\" --source agent --no-focus --wait-ready --yes --json"];
                 readonly jsonSchemas: readonly ["paneCreateRequest", "paneCreateResult"];
-                readonly notes: readonly ["At least one of --agent or --tool-command is required unless --from-json is used.", "`panes create` is for user-visible Pane orchestration, not the agent's default private delegation mechanism.", "Register the saved base repository once. Pane creates and owns the worktree/branch for each new Pane.", "Use `panels create` instead when a reviewer/helper should share an existing Pane's worktree.", "Agent-created Panes should pass `--source agent --no-focus --wait-ready --yes --json` unless the user explicitly wants focus moved.", "The built-in agent templates come from the runpane contract; custom terminal commands can pass agent-specific flags when requested by the user.", "Use --initial-input-file for multi-line prompts or shell-sensitive initial input.", "When the JSON result includes nextCommand, run it to validate that the terminal produced output before reporting success.", "Multi-pane requests are created sequentially today. The --concurrency flag is accepted for compatibility, but agents should not rely on parallel creation.", "For POSIX or WSL command chaining, use a custom terminal command like `bash -lc 'cmd1 && cmd2 && cmd3'`.", "For Windows PowerShell command chaining, use a custom terminal command like `powershell -NoProfile -Command \"cmd1; if ($LASTEXITCODE) { exit $LASTEXITCODE }; cmd2\"`.", "From WSL with Windows Pane, invoke through PowerShell and select the saved WSL repo by name or id, for example `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane panes create --repo \"WSL Pane\" --name issue-123 --agent <agent> --prompt \"Plan this issue\" --source agent --no-focus --wait-ready --yes --json'`.", "Use --wait-ready when an agent needs to verify that an agent terminal started instead of only creating a pane.", "If readiness returns blocked, inspect blocked.suggestedCommand rather than guessing which prompt to answer."];
+                readonly notes: readonly ["At least one of --agent or --tool-command is required unless --from-json is used.", "`panes create` is for user-visible Pane orchestration, not the agent's default private delegation mechanism.", "Register the saved base repository once. Pane creates and owns the worktree/branch for each new Pane.", "Use `panels create` instead when a reviewer/helper should share an existing Pane's worktree.", "Agent-created Panes should pass `--source agent --no-focus --wait-ready --yes --json` unless the user explicitly wants focus moved; add `--pinned` when the Pane should remain in the UI's favorite/pin set.", "The built-in agent templates come from the runpane contract; custom terminal commands can pass agent-specific flags when requested by the user.", "Use --initial-input-file for multi-line prompts or shell-sensitive initial input.", "With --wait-ready, verifiedSubmitted is earned from delivery evidence; routing initial input alone does not imply verified submission.", "If initialInput.blocked.kind is submission_unverified, do not submit again automatically. Inspect initialInput.staged and attempts, then run nextCommand to resolve the ambiguous composer state.", "When the JSON result includes nextCommand, run it to validate that the terminal produced output before reporting success.", "Multi-pane requests are created sequentially today. The --concurrency flag is accepted for compatibility, but agents should not rely on parallel creation.", "For POSIX or WSL command chaining, use a custom terminal command like `bash -lc 'cmd1 && cmd2 && cmd3'`.", "For Windows PowerShell command chaining, use a custom terminal command like `powershell -NoProfile -Command \"cmd1; if ($LASTEXITCODE) { exit $LASTEXITCODE }; cmd2\"`.", "From WSL with Windows Pane, invoke through PowerShell and select the saved WSL repo by name or id, for example `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane panes create --repo \"WSL Pane\" --name issue-123 --agent <agent> --prompt \"Plan this issue\" --source agent --no-focus --wait-ready --yes --json'`.", "Use --wait-ready when an agent needs to verify that an agent terminal started instead of only creating a pane.", "If readiness returns blocked, inspect blocked.suggestedCommand rather than guessing which prompt to answer."];
+            };
+            readonly "panes archive": {
+                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 details: "Use this to close out a Pane once its PR has merged. Refuses to archive (unless --force) when the pane's branch has uncommitted, untracked, or unpushed-to-remote changes, so an agent cannot silently discard work. A merged and pushed branch has no unpushed commits, so it archives cleanly. Waits for worktree removal to finish before returning.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane/session id to archive.";
+                }, {
+                    readonly name: "--source";
+                    readonly value: "<user|agent>";
+                    readonly required: false;
+                    readonly description: "Mutation source; does not change archive safety behavior.";
+                }, {
+                    readonly name: "--force";
+                    readonly required: false;
+                    readonly description: "Archive even if the pane's branch has uncommitted, untracked, or unpushed changes.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Skip confirmation for mutating commands.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }];
+                readonly examples: readonly ["runpane panes archive --pane <pane-id> --source agent --yes --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.", "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 "panes pin": {
+                readonly name: "panes pin";
+                readonly summary: "Declaratively pin a Pane; pinned is the Pane UI's favorite/pin star.";
+                readonly details: "Sets the requested pinned state to true without reading and toggling it. Repeating the command is idempotent and pinning never changes focus.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane/session id to pin.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Skip confirmation for mutating commands.";
+                }, {
+                    readonly name: "--dry-run";
+                    readonly required: false;
+                    readonly description: "Validate and preview without mutating.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }];
+                readonly examples: readonly ["runpane panes pin --pane <pane-id> --yes --json", "runpane panes pin --pane <pane-id> --dry-run --json"];
+                readonly jsonSchemas: readonly ["panePinRequest", "panePinResult"];
+                readonly notes: readonly ["This is a declarative set, not a toggle: retries leave an already-pinned Pane pinned.", "Pinning does not focus the Pane."];
+            };
+            readonly "panes unpin": {
+                readonly name: "panes unpin";
+                readonly summary: "Declaratively unpin a Pane; pinned is the Pane UI's favorite/pin star.";
+                readonly details: "Sets the requested pinned state to false without reading and toggling it. Repeating the command is idempotent and unpinning never changes focus.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: true;
+                    readonly description: "Pane/session id to unpin.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Skip confirmation for mutating commands.";
+                }, {
+                    readonly name: "--dry-run";
+                    readonly required: false;
+                    readonly description: "Validate and preview without mutating.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }];
+                readonly examples: readonly ["runpane panes unpin --pane <pane-id> --yes --json", "runpane panes unpin --pane <pane-id> --dry-run --json"];
+                readonly jsonSchemas: readonly ["panePinRequest", "panePinResult"];
+                readonly notes: readonly ["This is a declarative set, not a toggle: retries leave an already-unpinned Pane unpinned.", "Unpinning does not focus the Pane."];
             };
             readonly "panels list": {
                 readonly name: "panels list";