runpane 2.3.1 → 2.3.2

package/dist/generated/contract.d.ts

@@ -70,6 +70,11 @@ export declare const RUNPANE_CONTRACT: {
         readonly name: "doctor";
         readonly summary: "Run platform, release, installed Pane, and remote setup diagnostics.";
         readonly usage: readonly ["runpane doctor"];
+    }, {
+        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 jsonSchemas: readonly ["agentContextBriefResult", "agentContextCommandResult"];
     }, {
         readonly name: "repos list";
         readonly summary: "List repositories saved in the running Pane app.";
@@ -213,7 +218,7 @@ export declare const RUNPANE_CONTRACT: {
     };
     readonly help: {
         readonly npm: {
-            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude>", "  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", "  pipx run runpane", "", "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 repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude>", "  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", "  pipx run runpane", "", "Run \"runpane agent-context\" when an agent needs Pane command context.", "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"];
@@ -222,9 +227,10 @@ export declare const RUNPANE_CONTRACT: {
             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 create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes create --from-json <path|-> [--yes] [--json]", "", "Creates Pane sessions in a saved repository and opens a terminal-backed tool tab.", "", "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", "  --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 "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 pip: {
-            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude>", "  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", "", "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 repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude>", "  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", "", "Run \"runpane agent-context\" when an agent needs Pane command context.", "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]"];
@@ -233,6 +239,7 @@ export declare const RUNPANE_CONTRACT: {
             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 create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes create --from-json <path|-> [--yes] [--json]", "", "Creates Pane sessions in a saved repository and opens a terminal-backed tool tab.", "", "Options:", "  --repo <selector>", "  --name <name>", "  --worktree-name <name>", "  --base-branch <branch>", "  --agent <codex|claude>", "  --tool-command <command>", "  --title <title>", "  --initial-input <text>", "  --prompt <text>", "  --initial-input-file <path|->", "  --from-json <path|->", "  --timeout-ms <milliseconds>", "  --pane-dir <path>", "  --json", "  --dry-run", "  --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 docs: {
@@ -241,17 +248,17 @@ 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 repos list --json", "runpane repos add --path /path/to/repo --name Pane --yes --json", "runpane panes create --repo active --name issue-252 --agent codex --prompt \"Kick off the discussion skill for issue 252\" --yes", "runpane panes create --from-json panes.json --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 and 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 the wrapper package version, the installed Pane version when detectable, and the latest GitHub release version when reachable.", "`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, and remote-daemon hints.", "`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 create` connects to the running local Pane daemon, resolves the requested repository, creates Pane sessions, opens terminal-backed tool tabs, and optionally sends initial input to the started tool.", "`runpane panes create --prompt` is an alias for `--initial-input`; request JSON and daemon payloads should use the canonical `initialInput` field."];
+        readonly commandUsages: readonly ["runpane", "runpane setup", "runpane install", "runpane install client", "runpane install daemon", "runpane update", "runpane version", "runpane doctor", "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 create --repo active --name issue-252 --agent codex --prompt \"Kick off the discussion skill for issue 252\" --yes", "runpane panes create --from-json panes.json --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 and 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 the wrapper package version, the installed Pane version when detectable, and the latest GitHub release version when reachable.", "`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, and remote-daemon hints.", "`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 create` connects to the running local Pane daemon, resolves the requested repository, creates Pane sessions, opens terminal-backed tool tabs, and optionally sends initial input to the started tool.", "`runpane panes create --prompt` is an alias for `--initial-input`; request JSON and daemon payloads should use the canonical `initialInput` field."];
         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 repos list` and `runpane panes create` use 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.";
+        readonly localControlFlagNote: "`runpane repos list` and `runpane panes create` use 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.";
         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.";
         readonly downloadAttribution: readonly ["The npm package uses `source=npm` for all npm-registry consumers, including `npx`, `pnpm dlx`, `yarn dlx`, `bunx`, and global npm/pnpm installs.", "The PyPI package uses `source=pip` for all Python consumers, including pip, pipx, uvx, and `python -m runpane`.", "Wrappers should prefer `https://runpane.com/api/download?platform=<platform>&arch=<arch>&format=<format>&version=<version>&channel=<channel>&source=<npm|pip>`.", "If the website route cannot satisfy the download, wrappers may fall back to the matching GitHub release asset and print a warning that website attribution may be incomplete for that run."];
         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 ["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", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--from-json", "-", "--yes", "--json"], readonly ["--version"]];
-        readonly topLevelHelpIncludes: readonly ["runpane setup", "runpane install", "runpane update", "runpane version", "runpane doctor", "runpane repos list", "runpane repos add", "runpane panes create"];
+        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 ["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", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--from-json", "-", "--yes", "--json"], readonly ["--version"]];
+        readonly topLevelHelpIncludes: readonly ["runpane setup", "runpane install", "runpane update", "runpane version", "runpane doctor", "runpane agent-context", "runpane repos list", "runpane repos add", "runpane panes create"];
         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>"];
@@ -556,6 +563,390 @@ export declare const RUNPANE_CONTRACT: {
             };
             readonly additionalProperties: false;
         };
+        readonly agentContextBriefResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "mode", "source", "summary", "rules", "tools", "detailCommand"];
+            readonly properties: {
+                readonly ok: {
+                    readonly const: true;
+                };
+                readonly mode: {
+                    readonly const: "brief";
+                };
+                readonly source: {
+                    readonly const: "runpane-contract";
+                };
+                readonly summary: {
+                    readonly type: "string";
+                };
+                readonly rules: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly tools: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["name", "summary", "arguments"];
+                        readonly properties: {
+                            readonly name: {
+                                readonly type: "string";
+                            };
+                            readonly summary: {
+                                readonly type: "string";
+                            };
+                            readonly arguments: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                };
+                readonly detailCommand: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly agentContextCommandResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "mode", "source", "command"];
+            readonly properties: {
+                readonly ok: {
+                    readonly const: true;
+                };
+                readonly mode: {
+                    readonly const: "command";
+                };
+                readonly source: {
+                    readonly const: "runpane-contract";
+                };
+                readonly command: {
+                    readonly type: "object";
+                    readonly required: readonly ["name", "summary", "details", "arguments", "examples"];
+                    readonly properties: {
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly summary: {
+                            readonly type: "string";
+                        };
+                        readonly details: {
+                            readonly type: "string";
+                        };
+                        readonly requiresPaneDaemon: {
+                            readonly type: "boolean";
+                        };
+                        readonly mutates: {
+                            readonly type: "boolean";
+                        };
+                        readonly arguments: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "object";
+                            };
+                        };
+                        readonly examples: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly jsonSchemas: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly notes: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+    readonly agentContext: {
+        readonly brief: {
+            readonly title: "Pane agent context";
+            readonly summary: "Pane lets a developer manage repositories and user-visible panes. Agents can use runpane to list/add Pane repositories and create panes with terminal-backed tools.";
+            readonly rules: readonly ["Start with `runpane repos list --json` to find the saved repository when unsure.", "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 panes create` to create a Pane session and open a built-in agent or custom terminal command.", "Use `runpane agent-context --command <command>` for detailed command definitions only when needed."];
+            readonly detailCommand: "runpane agent-context --command <command> [--json]";
+            readonly tools: readonly [{
+                readonly name: "agent-context";
+                readonly summary: "Print token-efficient Pane command context for coding agents.";
+                readonly arguments: readonly ["--command <command>", "--json"];
+            }, {
+                readonly name: "repos list";
+                readonly summary: "List repositories saved in the running Pane app.";
+                readonly arguments: readonly ["--json", "--pane-dir <path>"];
+            }, {
+                readonly name: "repos add";
+                readonly summary: "Register an existing git repository with the running Pane app.";
+                readonly arguments: readonly ["--path <path>", "--name <name>", "--yes", "--json", "--dry-run", "--pane-dir <path>"];
+            }, {
+                readonly name: "panes create";
+                readonly summary: "Create one or more Pane sessions in a saved repository and open a terminal-backed tool tab.";
+                readonly arguments: readonly ["--repo <selector>", "--name <name>", "--agent <codex|claude>", "--tool-command <command>", "--prompt <text>", "--from-json <path|->", "--yes", "--json"];
+            }];
+        };
+        readonly commands: {
+            readonly help: {
+                readonly name: "help";
+                readonly summary: "Show help for runpane or a specific command.";
+                readonly details: "Use this when you need human-readable usage text for a command.";
+                readonly requiresPaneDaemon: false;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "command";
+                    readonly value: "<command>";
+                    readonly required: false;
+                    readonly description: "Optional command topic such as \"panes create\".";
+                }];
+                readonly examples: readonly ["runpane help", "runpane help panes create"];
+                readonly notes: readonly ["Help text is generated from the runpane contract."];
+            };
+            readonly setup: {
+                readonly name: "setup";
+                readonly summary: "Open the guided setup wizard for install, remote host setup, update, and diagnostics.";
+                readonly details: "Use this for a human-driven Pane setup flow, not for unattended agent orchestration.";
+                readonly requiresPaneDaemon: false;
+                readonly mutates: false;
+                readonly arguments: readonly [];
+                readonly examples: readonly ["runpane setup"];
+                readonly notes: readonly ["In non-interactive shells, setup prints help and exits successfully."];
+            };
+            readonly install: {
+                readonly name: "install";
+                readonly summary: "Install Pane on this machine or configure this machine as a remote daemon host.";
+                readonly details: "Installs or launches Pane release artifacts at command runtime. `install daemon` forwards remote setup flags to Pane.";
+                readonly requiresPaneDaemon: false;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "target";
+                    readonly value: "<client|daemon>";
+                    readonly required: false;
+                    readonly description: "Install the desktop client or configure a remote daemon host.";
+                }, {
+                    readonly name: "--version";
+                    readonly value: "<latest|vX.Y.Z>";
+                    readonly required: false;
+                    readonly description: "Pane release to install.";
+                }, {
+                    readonly name: "--format";
+                    readonly value: "<auto|appimage|deb|dmg|zip|exe>";
+                    readonly required: false;
+                    readonly description: "Release artifact format.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Skip interactive prompts where possible.";
+                }];
+                readonly examples: readonly ["runpane install client", "runpane install daemon --label \"My Server\""];
+                readonly notes: readonly ["Package install itself is inert; work begins only when runpane is executed."];
+            };
+            readonly update: {
+                readonly name: "update";
+                readonly summary: "Update the Pane desktop app using the same artifact path as install client.";
+                readonly details: "Resolves and installs the selected Pane client release.";
+                readonly requiresPaneDaemon: false;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--version";
+                    readonly value: "<latest|vX.Y.Z>";
+                    readonly required: false;
+                    readonly description: "Pane release to update to.";
+                }, {
+                    readonly name: "--format";
+                    readonly value: "<auto|appimage|deb|dmg|zip|exe>";
+                    readonly required: false;
+                    readonly description: "Release artifact format.";
+                }, {
+                    readonly name: "--dry-run";
+                    readonly required: false;
+                    readonly description: "Print the update plan without downloading.";
+                }];
+                readonly examples: readonly ["runpane update", "runpane update --version latest"];
+                readonly notes: readonly ["Equivalent artifact selection to `runpane install client`."];
+            };
+            readonly version: {
+                readonly name: "version";
+                readonly summary: "Print the runpane wrapper version and installed Pane version when detectable.";
+                readonly details: "Use this for diagnostics or to confirm which wrapper is available.";
+                readonly requiresPaneDaemon: false;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--pane-path";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Inspect a specific Pane executable.";
+                }];
+                readonly examples: readonly ["runpane version", "runpane --version"];
+                readonly notes: readonly [];
+            };
+            readonly doctor: {
+                readonly name: "doctor";
+                readonly summary: "Run platform, release, installed Pane, and remote setup diagnostics.";
+                readonly details: "Use this when runpane install/update behavior needs environment diagnostics.";
+                readonly requiresPaneDaemon: false;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--pane-path";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Use an existing Pane executable for diagnostics.";
+                }, {
+                    readonly name: "--verbose";
+                    readonly required: false;
+                    readonly description: "Print extra diagnostics.";
+                }];
+                readonly examples: readonly ["runpane doctor", "runpane doctor --verbose"];
+                readonly notes: readonly [];
+            };
+            readonly "agent-context": {
+                readonly name: "agent-context";
+                readonly summary: "Print token-efficient Pane command context for coding agents.";
+                readonly details: "Use this first when an agent needs to discover Pane primitives. It is local/offline and does not require a running Pane app.";
+                readonly requiresPaneDaemon: false;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--command";
+                    readonly value: "<command>";
+                    readonly required: false;
+                    readonly description: "Print the detailed definition for one command, for example \"panes create\".";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }];
+                readonly examples: readonly ["runpane agent-context", "runpane agent-context --command \"panes create\" --json"];
+                readonly jsonSchemas: readonly ["agentContextBriefResult", "agentContextCommandResult"];
+                readonly notes: readonly ["Default output is brief so AGENTS.md can point here without bloating context."];
+            };
+            readonly "repos list": {
+                readonly name: "repos list";
+                readonly summary: "List repositories saved in the running Pane app.";
+                readonly details: "Use this to find the right Pane-managed repository before creating panes. If the repo is missing, use `repos add` first.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable repository records.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane repos list --json"];
+                readonly jsonSchemas: readonly ["repoListResult"];
+                readonly notes: readonly ["Requires a running Pane app or daemon for the selected Pane data directory."];
+            };
+            readonly "repos add": {
+                readonly name: "repos add";
+                readonly summary: "Register an existing git repository with the running Pane app.";
+                readonly details: "Use this when the repository exists on disk but is not saved in Pane yet. It validates the path as a git repository.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--path";
+                    readonly value: "<path>";
+                    readonly required: true;
+                    readonly description: "Existing git repository path to register with Pane.";
+                }, {
+                    readonly name: "--name";
+                    readonly value: "<name>";
+                    readonly required: false;
+                    readonly description: "Saved repository name; defaults to the directory name.";
+                }, {
+                    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 name: "--dry-run";
+                    readonly required: false;
+                    readonly description: "Validate and preview without adding the repo.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane repos add --path /path/to/repo --yes --json"];
+                readonly jsonSchemas: readonly ["repoAddRequest", "repoAddResult"];
+                readonly notes: readonly ["It does not create directories or initialize git repositories by default."];
+            };
+            readonly "panes create": {
+                readonly name: "panes create";
+                readonly summary: "Create one or more Pane sessions in a saved repository and open a terminal-backed tool tab.";
+                readonly details: "Use this to set up user-visible panes for work. Select a saved repository, choose a built-in agent or custom terminal command, and optionally send initial input after the tool starts.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--repo";
+                    readonly value: "<selector>";
+                    readonly required: true;
+                    readonly description: "Repository selector: active, id, exact path, or saved repository name.";
+                }, {
+                    readonly name: "--name";
+                    readonly value: "<name>";
+                    readonly required: true;
+                    readonly description: "Pane/session name.";
+                }, {
+                    readonly name: "--agent";
+                    readonly value: "<codex|claude>";
+                    readonly required: false;
+                    readonly description: "Built-in agent terminal template to open.";
+                }, {
+                    readonly name: "--tool-command";
+                    readonly value: "<command>";
+                    readonly required: false;
+                    readonly description: "Custom terminal command to run instead of a built-in agent.";
+                }, {
+                    readonly name: "--prompt";
+                    readonly value: "<text>";
+                    readonly required: false;
+                    readonly description: "Alias for --initial-input; sends text after the command is ready.";
+                }, {
+                    readonly name: "--initial-input-file";
+                    readonly value: "<path|->";
+                    readonly required: false;
+                    readonly description: "Read initial input from a file or stdin.";
+                }, {
+                    readonly name: "--from-json";
+                    readonly value: "<path|->";
+                    readonly required: false;
+                    readonly description: "Read a full panes.create request JSON payload.";
+                }, {
+                    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 create --repo active --name issue-257 --agent codex --prompt \"Plan this issue\" --yes", "runpane panes create --from-json panes.json --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.", "The built-in agent templates come from the runpane contract; custom terminal commands can pass agent-specific flags when requested by the user."];
+            };
+        };
+        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, and implementation work.", "", "Use `runpane agent-context` for a brief Pane command schema. Use `runpane agent-context --command \"panes create\"` or another command name for the detailed schema only when needed.", "", "Common commands:", "- `runpane repos list --json`", "- `runpane repos add --path <repo> --yes --json`", "- `runpane panes create --repo active --name <name> --agent codex --prompt \"<task>\" --yes`"];
     };
 };
 export type RunpaneCommand = typeof RUNPANE_CONTRACT.commands[number]['name'];

package/dist/generated/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/generated/contract.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwqCnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9E,MAAM,MAAM,aAAa,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AACjF,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;AACnF,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC5E,MAAM,MAAM,YAAY,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/generated/contract.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwwDnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9E,MAAM,MAAM,aAAa,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AACjF,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;AACnF,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC5E,MAAM,MAAM,YAAY,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC"}