runpane 2.4.81 → 2.4.83

package/dist/generated/contract.d.ts

@@ -22,6 +22,13 @@ export declare const RUNPANE_CONTRACT: {
         readonly dryRun: false;
         readonly yes: false;
         readonly verbose: false;
+        readonly watch: {
+            readonly format: "lines";
+            readonly heartbeatSeconds: 60;
+            readonly idleAfterMs: 600000;
+            readonly agentsOnly: true;
+            readonly includeHeldInputPresence: true;
+        };
     };
     readonly enums: {
         readonly installTargets: readonly ["client", "daemon"];
@@ -74,7 +81,7 @@ export declare const RUNPANE_CONTRACT: {
     }, {
         readonly name: "doctor";
         readonly summary: "Run platform, release, installed Pane, daemon reachability, and remote setup diagnostics.";
-        readonly usage: readonly ["runpane doctor [--json] [--pane-dir <path>] [--pane-path <path>] [--format <format>] [--verbose]"];
+        readonly usage: readonly ["runpane doctor [--json] [--pane-dir <path>] [--pane-path <path>] [--format <format>] [--verbose]", "runpane doctor --report [--title <text>] --body-file <path|-> [--yes] [--json]"];
         readonly jsonSchemas: readonly ["doctorResult"];
     }, {
         readonly name: "daemon repair";
@@ -108,6 +115,11 @@ export declare const RUNPANE_CONTRACT: {
         readonly summary: "List Pane sessions in a saved repository.";
         readonly usage: readonly ["runpane panes list [--repo <selector>] [--json]"];
         readonly jsonSchemas: readonly ["paneListResult"];
+    }, {
+        readonly name: "panes cost";
+        readonly summary: "Report estimated token cost per Pane, with per-model breakdown and cache efficiency.";
+        readonly usage: readonly ["runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]"];
+        readonly jsonSchemas: readonly ["paneCostRequest", "paneCostResult"];
     }, {
         readonly name: "workspace state";
         readonly summary: "Read one workspace snapshot of every Pane and CLI panel.";
@@ -116,7 +128,7 @@ export declare const RUNPANE_CONTRACT: {
     }, {
         readonly name: "watch";
         readonly summary: "Wait for workspace agent and Pane transitions using a daemon-held cursor.";
-        readonly usage: readonly ["runpane watch [--as <name>|--since <generation>] [--follow] [--kinds <kind,...>] [--pane <id>] [--repo <selector>] [--name-contains <text>] [--timeout-ms <ms>] [--from <now|earliest>] [--json]"];
+        readonly usage: readonly ["runpane watch [--as <name>|--since <generation>] [--follow] [--format <lines|json>] [--heartbeat <seconds>] [--idle-after <ms>] [--all-managed|--pane <id>] [--include-shells] [--self-test] [--kinds <kind,...>] [--repo <selector>] [--name-contains <text>] [--timeout-ms <ms>] [--from <now|earliest>] [--json]"];
         readonly jsonSchemas: readonly ["workspaceWaitRequest", "workspaceWaitResult"];
     }, {
         readonly name: "panes create";
@@ -378,6 +390,26 @@ export declare const RUNPANE_CONTRACT: {
             readonly name: "--name-contains";
             readonly value: "<text>";
             readonly description: "Limit workspace events to Pane names containing text.";
+        }, {
+            readonly name: "--exclude-pane";
+            readonly value: "<pane-id>";
+            readonly description: "Exclude a Pane from workspace watch results; repeatable.";
+        }, {
+            readonly name: "--format";
+            readonly value: "<lines|json>";
+            readonly description: "Watch output format; scoped to the watch command.";
+        }, {
+            readonly name: "--heartbeat";
+            readonly value: "<seconds>";
+            readonly description: "Maximum healthy silence in follow mode; 0 disables heartbeats.";
+        }, {
+            readonly name: "--idle-after";
+            readonly value: "<milliseconds>";
+            readonly description: "Emit agent.idle after this READY duration; 0 disables idle events.";
+        }, {
+            readonly name: "--body-file";
+            readonly value: "<path|->";
+            readonly description: "Read diagnostic report evidence from a file or stdin.";
         }];
         readonly localBoolean: readonly [{
             readonly name: "--json";
@@ -409,24 +441,43 @@ export declare const RUNPANE_CONTRACT: {
         }, {
             readonly name: "--include-held-input";
             readonly description: "Include up to 120 characters of unsubmitted composer text in ready events.";
+        }, {
+            readonly name: "--agents-only";
+            readonly description: "Limit workspace events to CLI agent panels.";
+        }, {
+            readonly name: "--all-managed";
+            readonly description: "Watch all non-archived, non-hidden managed panes.";
+        }, {
+            readonly name: "--include-shells";
+            readonly description: "Include ordinary shell panels in follow mode.";
+        }, {
+            readonly name: "--no-held-input";
+            readonly description: "Disable redacted STUCK detection in lines follow mode.";
+        }, {
+            readonly name: "--self-test";
+            readonly description: "Probe the current daemon watch path without advancing a named cursor.";
+        }, {
+            readonly name: "--report";
+            readonly description: "Prepare a redacted doctor report; external filing still requires --yes.";
         }];
     };
     readonly help: {
         readonly npm: {
-            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane daemon repair [--pane-dir <path>] [--yes] [--json]", "  runpane agent-context [--json]", "  runpane agents doctor --agent <codex|claude|cursor> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch [--as <name>|--since <generation>] [--follow] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] [--dry-run] --yes", "  runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] --yes", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]", "  runpane help [command]", "", "Quick start:", "  npx --yes runpane@latest", "  npm i -g runpane && runpane setup", "", "Advanced examples:", "  npx --yes runpane@latest install client", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest", "", "Common commands:", "  runpane help", "  runpane setup", "  runpane install", "  runpane doctor", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json", "  runpane agent-context --command \"<command>\" --json", "", "Run \"runpane help panes create\" for pane orchestration options."];
+            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane doctor --report --body-file <path|->", "  runpane daemon repair [--pane-dir <path>] [--yes] [--json]", "  runpane agent-context [--json]", "  runpane agents doctor --agent <codex|claude|cursor> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch --follow", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] [--dry-run] --yes", "  runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] --yes", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]", "  runpane help [command]", "", "Quick start:", "  npx --yes runpane@latest", "  npm i -g runpane && runpane setup", "", "Advanced examples:", "  npx --yes runpane@latest install client", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest", "", "Common commands:", "  runpane help", "  runpane setup", "  runpane install", "  runpane doctor", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json", "  runpane agent-context --command \"<command>\" --json", "", "Run \"runpane help panes create\" for pane orchestration options."];
             readonly 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"];
             readonly version: readonly ["Usage:", "  runpane version", "  runpane --version"];
-            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 doctor: readonly ["Usage:", "  runpane doctor [--json] [--pane-dir <path>] [--pane-path <path>] [--format <format>] [--verbose]", "  runpane doctor --report [--title <text>] --body-file <path|-> [--yes] [--json]", "", "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", "  --report                       Prepare a redacted, inspectable report", "  --body-file <path|->           Read report evidence from a file or stdin", "  --title <text>                 Report title", "  --yes                          Confirm creating one dcouple/Pane issue", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json"];
             readonly "daemon repair": readonly ["Usage:", "  runpane daemon repair [--pane-dir <path>] [--pane-path <path>] [--yes] [--json]", "", "Repairs and restarts only the managed remote-daemon launcher and service definition.", "", "Options:", "  --pane-dir <path>              Remote daemon data directory (default: ~/.pane_remote)", "  --pane-path <path>             Existing Pane executable used to perform repair", "  --yes                         Skip the restart confirmation", "  --json                        Print one machine-readable repair result"];
             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|cursor> [options]", "  runpane panes archive --pane <pane-id> [--force] [--source user|agent] [--dry-run] --yes [--json]", "  runpane panes pin --pane <pane-id> --yes [--dry-run] [--json]", "  runpane panes unpin --pane <pane-id> --yes [--dry-run] [--json]", "  runpane panes rename --pane <pane-id> --name <new-name> --yes [--dry-run] [--json]", "", "Run \"runpane help panes <command>\" for command-specific options."];
+            readonly panes: readonly ["Pane session commands.", "", "Usage:", "  runpane panes <command> [options]", "", "Commands:", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [options]", "  runpane panes archive --pane <pane-id> [--force] [--source user|agent] [--dry-run] --yes [--json]", "  runpane panes pin --pane <pane-id> --yes [--dry-run] [--json]", "  runpane panes unpin --pane <pane-id> --yes [--dry-run] [--json]", "  runpane panes rename --pane <pane-id> --name <new-name> --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 workspace: readonly ["Workspace observation commands.", "", "Usage:", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch [--as <name>|--since <generation>] [--follow] [options]"];
+            readonly "panes cost": readonly ["Usage:", "  runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]", "", "Reports estimated token costs per Pane for the last 30 days, including per-model and cache-efficiency details.", "", "Options:", "  --repo <selector>              Limit results to one saved repository", "  --pane <pane-id>               Return one Pane, including an idle Pane with zero usage", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
+            readonly workspace: readonly ["Workspace observation commands.", "", "Usage:", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch --follow"];
             readonly "workspace state": readonly ["Usage:", "  runpane workspace state [--repo <selector>] [--json]", "", "Returns one workspace snapshot of every Pane and CLI panel."];
-            readonly watch: readonly ["Usage:", "  runpane watch [--as <name>|--since <generation>] [--follow] [options]", "", "Waits for agent state, Pane lifecycle, and panel exit transitions without polling.", "", "Options:", "  --as <name>                    Use a persisted daemon-held cursor", "  --since <generation>           Use an explicit cursor instead", "  --from <now|earliest>          Starting point for a new named cursor", "  --follow                       Continue waiting until interrupted", "  --kinds <kind,...>             Limit event kinds", "  --pane <id>                    Limit to a Pane; repeatable", "  --repo <selector>              Limit to a saved repository", "  --name-contains <text>         Limit by Pane name substring", "  --timeout-ms <ms>              Wait timeout; 0 polls once", "  --limit <count>                Maximum entries per response", "  --ack-now                      Use at-most-once named-cursor delivery", "  --include-held-input           Include unsubmitted composer text", "  --json                         Emit one NDJSON line per entry"];
+            readonly watch: readonly ["Usage:", "  runpane watch [--as <name>|--since <generation>] [--follow] [options]", "", "Waits for agent state, Pane lifecycle, and panel exit transitions without polling.", "", "Options:", "  --as <name>                    Use a persisted daemon-held cursor", "  --since <generation>           Use an explicit cursor instead", "  --from <now|earliest>          Starting point for a new named cursor", "  --follow                       Continue waiting until interrupted", "  --format <lines|json>          Output format; lines is the follow default", "  --heartbeat <seconds>          Healthy-silence bound; defaults to 60 under --follow", "  --idle-after <ms>              Re-firing READY idle interval; defaults to 600000 under --follow", "  --all-managed                  Explicitly watch all managed panes", "  --include-shells               Include ordinary shell panels", "  --agents-only                  Limit to CLI agent panels", "  --exclude-pane <id>            Exclude a Pane; repeatable", "  --self-test                    Anonymous, read-only daemon path probe", "  --kinds <kind,...>             Limit event kinds", "  --pane <id>                    Limit to a Pane; repeatable", "  --repo <selector>              Limit to a saved repository", "  --name-contains <text>         Limit by Pane name substring", "  --timeout-ms <ms>              Wait timeout; 0 polls once", "  --limit <count>                Maximum entries per response", "  --ack-now                      Use at-most-once named-cursor delivery", "  --include-held-input           Include unsubmitted composer text in JSON", "  --no-held-input                Disable redacted STUCK detection", "  --json                         Alias for --format json"];
             readonly "panes create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [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|cursor>         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                       Accepted for compatibility; creation already pins by default", "  --no-pinned                    Create unpinned instead of the default 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] [--dry-run] --yes [--json]", "", "Archives a Pane (session) exactly like the UI Archive action, including removal of its Pane-managed git worktree. Refreshes the configured upstream before checking for unpushed commits and reports exact commit evidence. Refuses unsafe archives unless --force is passed. Use --dry-run to print the evidence without mutating Pane state.", "", "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", "  --dry-run                      Refresh and print archive safety evidence without archiving", "  --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"];
@@ -445,20 +496,21 @@ 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 daemon repair [--pane-dir <path>] [--yes] [--json]", "  runpane agent-context [--json]", "  runpane agents doctor --agent <codex|claude|cursor> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch [--as <name>|--since <generation>] [--follow] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] [--dry-run] --yes", "  python -m runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] --yes", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]", "  runpane help [command]", "", "Quick start:", "  pipx run runpane", "  python -m pip install runpane && python -m runpane setup", "", "Advanced examples:", "  pipx run runpane install client", "  pipx run runpane install daemon --label \"My Server\"", "  uvx runpane@latest", "", "Common commands:", "  runpane help", "  runpane setup", "  runpane install", "  runpane doctor", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json", "  runpane agent-context --command \"<command>\" --json", "", "Run \"runpane help panes create\" for pane orchestration options."];
+            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane doctor --report --body-file <path|->", "  runpane daemon repair [--pane-dir <path>] [--yes] [--json]", "  runpane agent-context [--json]", "  runpane agents doctor --agent <codex|claude|cursor> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch --follow", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready]", "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] [--dry-run] --yes", "  python -m runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] --yes", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]", "  runpane help [command]", "", "Quick start:", "  pipx run runpane", "  python -m pip install runpane && python -m runpane setup", "", "Advanced examples:", "  pipx run runpane install client", "  pipx run runpane install daemon --label \"My Server\"", "  uvx runpane@latest", "", "Common commands:", "  runpane help", "  runpane setup", "  runpane install", "  runpane doctor", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json", "  runpane agent-context --command \"<command>\" --json", "", "Run \"runpane help panes create\" for pane orchestration options."];
             readonly 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]"];
             readonly version: readonly ["Usage:", "  runpane version", "  runpane --version"];
-            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 doctor: readonly ["Usage:", "  runpane doctor [--json] [--pane-dir <path>] [--pane-path <path>] [--format <format>] [--verbose]", "  runpane doctor --report [--title <text>] --body-file <path|-> [--yes] [--json]", "", "Checks wrapper/runtime details, release metadata, installed Pane detection, and Pane daemon reachability.", "", "Options:", "  --json", "  --pane-dir <path>", "  --pane-path <path>", "  --format <format>", "  --verbose", "  --report", "  --body-file <path|->", "  --title <text>", "  --yes", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json"];
             readonly "daemon repair": readonly ["Usage:", "  runpane daemon repair [--pane-dir <path>] [--pane-path <path>] [--yes] [--json]", "", "Repairs and restarts only the managed remote-daemon launcher and service definition.", "", "Options:", "  --pane-dir <path>", "  --pane-path <path>", "  --yes", "  --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|cursor> [options]", "  runpane panes archive --pane <pane-id> [--force] [--source user|agent] [--dry-run] --yes [--json]", "  runpane panes pin --pane <pane-id> --yes [--dry-run] [--json]", "  runpane panes unpin --pane <pane-id> --yes [--dry-run] [--json]", "  runpane panes rename --pane <pane-id> --name <new-name> --yes [--dry-run] [--json]", "", "Run \"runpane help panes <command>\" for command-specific options."];
+            readonly panes: readonly ["Pane session commands.", "", "Usage:", "  runpane panes <command> [options]", "", "Commands:", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [options]", "  runpane panes archive --pane <pane-id> [--force] [--source user|agent] [--dry-run] --yes [--json]", "  runpane panes pin --pane <pane-id> --yes [--dry-run] [--json]", "  runpane panes unpin --pane <pane-id> --yes [--dry-run] [--json]", "  runpane panes rename --pane <pane-id> --name <new-name> --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 workspace: readonly ["Workspace observation commands.", "", "Usage:", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch [--as <name>|--since <generation>] [--follow] [options]"];
+            readonly "panes cost": readonly ["Usage:", "  runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]", "", "Reports estimated token costs per Pane for the last 30 days, including per-model and cache-efficiency details.", "", "Options:", "  --repo <selector>", "  --pane <pane-id>", "  --pane-dir <path>", "  --json"];
+            readonly workspace: readonly ["Workspace observation commands.", "", "Usage:", "  runpane workspace state [--repo <selector>] [--json]", "  runpane watch --follow"];
             readonly "workspace state": readonly ["Usage:", "  runpane workspace state [--repo <selector>] [--json]", "", "Returns one workspace snapshot of every Pane and CLI panel."];
-            readonly watch: readonly ["Usage:", "  runpane watch [--as <name>|--since <generation>] [--follow] [options]", "", "Waits for workspace transitions without polling.", "", "Options:", "  --as <name>", "  --since <generation>", "  --from <now|earliest>", "  --follow", "  --kinds <kind,...>", "  --pane <id>                    Repeatable", "  --repo <selector>", "  --name-contains <text>", "  --timeout-ms <ms>              0 polls once", "  --limit <count>", "  --ack-now", "  --include-held-input", "  --json"];
+            readonly watch: readonly ["Usage:", "  runpane watch [--as <name>|--since <generation>] [--follow] [options]", "", "Waits for workspace transitions without polling.", "", "Options:", "  --as <name>", "  --since <generation>", "  --from <now|earliest>", "  --follow", "  --format <lines|json>", "  --heartbeat <seconds>", "  --idle-after <ms>", "  --all-managed", "  --include-shells", "  --agents-only", "  --exclude-pane <id>            Repeatable", "  --self-test", "  --kinds <kind,...>", "  --pane <id>                    Repeatable", "  --repo <selector>", "  --name-contains <text>", "  --timeout-ms <ms>              0 polls once", "  --limit <count>", "  --ack-now", "  --include-held-input", "  --no-held-input", "  --json                         Alias for --format json"];
             readonly "panes create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [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|cursor>         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                       Accepted for compatibility; creation already pins by default", "  --no-pinned                    Create unpinned instead of the default 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] [--dry-run] --yes [--json]", "", "Archives a Pane (session) exactly like the UI Archive action, including removal of its Pane-managed git worktree. Refreshes the configured upstream before checking for unpushed commits and reports exact commit evidence. Refuses unsafe archives unless --force is passed. Use --dry-run to print the evidence without mutating Pane state.", "", "Options:", "  --pane <pane-id>", "  --source <user|agent>", "  --force", "  --pane-dir <path>", "  --json", "  --dry-run", "  --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"];
@@ -483,8 +535,8 @@ export declare const RUNPANE_CONTRACT: {
         readonly npmCommands: readonly ["npx --yes runpane@latest", "npx --yes runpane@latest setup", "npx --yes runpane@latest install client", "npx --yes runpane@latest install daemon --label \"My Server\"", "pnpm dlx runpane@latest", "pnpm dlx runpane@latest install daemon --label \"My Server\"", "npm i -g runpane && runpane", "npm i -g runpane && runpane setup", "npm i -g runpane && runpane install daemon --label \"My Server\"", "pnpm add -g runpane && runpane", "pnpm add -g runpane && runpane setup", "pnpm add -g runpane && runpane install daemon --label \"My Server\"", "yarn dlx runpane@latest install daemon --label \"My Server\"", "bunx runpane@latest install daemon --label \"My Server\""];
         readonly pythonCommands: readonly ["pipx run runpane", "pipx run runpane setup", "python -m pip install runpane", "runpane", "runpane setup", "python -m runpane setup", "runpane install daemon --label \"My Server\"", "pipx install runpane", "runpane", "runpane setup", "pipx run runpane install daemon --label \"My Server\"", "uvx runpane@latest", "uvx runpane@latest setup", "uvx runpane@latest install daemon --label \"My Server\"", "python -m runpane install daemon --label \"My Server\""];
         readonly packageManagerNotes: readonly ["Use `pnpm dlx` for one-shot pnpm execution and `pnpm add -g` for persistent CLI installation.", "Do not document `pnpm install runpane` as the public CLI install path."];
-        readonly commandUsages: readonly ["runpane", "runpane setup", "runpane install", "runpane install client", "runpane install daemon", "runpane update", "runpane version", "runpane doctor", "runpane doctor --json", "runpane daemon repair --pane-dir ~/.pane_remote --yes --json", "runpane agent-context", "runpane agent-context --command \"panes create\" --json", "runpane repos list --json", "runpane repos add --path /path/to/repo --name Pane --yes --json", "runpane panes list --repo active --json", "runpane panes create --repo active --name issue-252 --agent <agent> --prompt \"Kick off the discussion skill for issue 252\" --source agent --no-focus --wait-ready --yes --json", "runpane panes create --from-json panes.json --yes --json", "runpane panes archive --pane <pane-id> --source agent --yes --json", "runpane panes rename --pane <pane-id> --name issue-393 --yes --json", "runpane panels list --pane <pane-id> --json", "runpane panels output --panel <panel-id> --limit 200 --json", "printf 'Continue\\n' | runpane panels input --panel <panel-id> --input-file - --yes --json", "runpane help", "runpane <command> --help"];
-        readonly commandDescriptions: readonly ["`runpane` with no arguments and `runpane setup` open an interactive wizard when stdin and stdout are TTYs. In non-interactive shells or CI, both forms must print help, common commands, and agent discovery hints, then exit successfully instead of waiting for input.", "`runpane install` is an alias for `runpane install client`.", "`runpane install client` downloads the selected Pane desktop artifact and installs, opens, or launches it for the current platform.", "`runpane install daemon` downloads or installs Pane, resolves a stable Pane executable path, and spawns `<pane executable> --remote-setup <forwarded remote setup args>`.", "The wrapper must stream Pane stdout/stderr without reformatting because `pane --remote-setup` prints the one-time `pane-remote://...` connection code.", "`runpane update` uses the same release resolution and installer path as `install client`.", "`runpane version` prints only wrapper package metadata and does not contact, launch, or focus the Pane app or daemon.", "`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, daemon reachability, and remote-daemon hints. Add `--json` for a machine-readable report that agents should run before mutating Pane state. Installed app version detection must be best-effort and must not launch, focus, or configure Pane; macOS wrappers read app bundle metadata instead of executing `Pane --version`.", "`runpane daemon repair` rewrites and restarts only the managed remote-daemon launcher/service. It never creates pairing credentials, changes tunnels, or downloads Pane; doctor only recommends it and never runs it automatically.", "`runpane agent-context` prints a brief, token-efficient command schema for coding agents without connecting to the Pane daemon.", "`runpane agent-context --command \"panes create\"` prints the detailed definition for one command. Add `--json` for machine-readable output.", "`runpane repos list` connects to the running local Pane daemon and prints saved repository records.", "`runpane repos add` registers an existing git repository with the running local Pane daemon. It does not create directories or initialize git repositories by default.", "`runpane panes list` lists Pane sessions, optionally scoped to one saved repository.", "`runpane panes create` connects to the running local Pane daemon, resolves the requested saved base repository, creates user-visible Pane sessions backed by Pane-managed worktrees/branches, opens terminal-backed tool tabs, and optionally sends initial input to the started tool. Built-in agent panes and `--source agent` default to background/no-focus unless `--focus` is passed. New Panes are pinned into the UI's favorite/pin set by default; pass `--no-pinned` to opt out. Panes created interactively in the Pane UI are unaffected.", "For `panes create --wait-ready`, `initialInput.verifiedSubmitted: true` is reported only after argument attachment or composer-clear plus activity evidence. Routing input does not by itself verify submission.", "`runpane panes archive` refreshes the configured upstream, reports exact unpushed commit evidence, and refuses unsafe archive operations unless `--force` is used. Add `--dry-run` to inspect the same evidence without archiving. Successful archives wait for worktree removal and report `worktreeCleanup`.", "`runpane panes rename` trims and updates a Pane's display name without changing its worktree, branch, panels, or focus, and returns the updated pane summary.", "`runpane 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 commandUsages: readonly ["runpane", "runpane setup", "runpane install", "runpane install client", "runpane install daemon", "runpane update", "runpane version", "runpane doctor", "runpane doctor --json", "runpane daemon repair --pane-dir ~/.pane_remote --yes --json", "runpane agent-context", "runpane agent-context --command \"panes create\" --json", "runpane repos list --json", "runpane repos add --path /path/to/repo --name Pane --yes --json", "runpane panes list --repo active --json", "runpane panes cost --pane <pane-id> --json", "runpane panes create --repo active --name issue-252 --agent <agent> --prompt \"Kick off the discussion skill for issue 252\" --source agent --no-focus --wait-ready --yes --json", "runpane panes create --from-json panes.json --yes --json", "runpane panes archive --pane <pane-id> --source agent --yes --json", "runpane panes rename --pane <pane-id> --name issue-393 --yes --json", "runpane panels list --pane <pane-id> --json", "runpane panels output --panel <panel-id> --limit 200 --json", "printf 'Continue\\n' | runpane panels input --panel <panel-id> --input-file - --yes --json", "runpane help", "runpane <command> --help"];
+        readonly commandDescriptions: readonly ["`runpane` with no arguments and `runpane setup` open an interactive wizard when stdin and stdout are TTYs. In non-interactive shells or CI, both forms must print help, common commands, and agent discovery hints, then exit successfully instead of waiting for input.", "`runpane install` is an alias for `runpane install client`.", "`runpane install client` downloads the selected Pane desktop artifact and installs, opens, or launches it for the current platform.", "`runpane install daemon` downloads or installs Pane, resolves a stable Pane executable path, and spawns `<pane executable> --remote-setup <forwarded remote setup args>`.", "The wrapper must stream Pane stdout/stderr without reformatting because `pane --remote-setup` prints the one-time `pane-remote://...` connection code.", "`runpane update` uses the same release resolution and installer path as `install client`.", "`runpane version` prints only wrapper package metadata and does not contact, launch, or focus the Pane app or daemon.", "`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, daemon reachability, and remote-daemon hints. Add `--json` for a machine-readable report that agents should run before mutating Pane state. Installed app version detection must be best-effort and must not launch, focus, or configure Pane; macOS wrappers read app bundle metadata instead of executing `Pane --version`.", "`runpane daemon repair` rewrites and restarts only the managed remote-daemon launcher/service. It never creates pairing credentials, changes tunnels, or downloads Pane; doctor only recommends it and never runs it automatically.", "`runpane agent-context` prints a brief, token-efficient command schema for coding agents without connecting to the Pane daemon.", "`runpane agent-context --command \"panes create\"` prints the detailed definition for one command. Add `--json` for machine-readable output.", "`runpane repos list` connects to the running local Pane daemon and prints saved repository records.", "`runpane repos add` registers an existing git repository with the running local Pane daemon. It does not create directories or initialize git repositories by default.", "`runpane panes list` lists Pane sessions, optionally scoped to one saved repository.", "`runpane panes cost` reports estimated token costs per Pane for the last 30 days, including per-model breakdowns and cache efficiency; unscoped output includes an Unattributed bucket that reconciles against workspace totals.", "`runpane panes create` connects to the running local Pane daemon, resolves the requested saved base repository, creates user-visible Pane sessions backed by Pane-managed worktrees/branches, opens terminal-backed tool tabs, and optionally sends initial input to the started tool. Built-in agent panes and `--source agent` default to background/no-focus unless `--focus` is passed. New Panes are pinned into the UI's favorite/pin set by default; pass `--no-pinned` to opt out. Panes created interactively in the Pane UI are unaffected.", "For `panes create --wait-ready`, `initialInput.verifiedSubmitted: true` is reported only after argument attachment or composer-clear plus activity evidence. Routing input does not by itself verify submission.", "`runpane panes archive` refreshes the configured upstream, reports exact unpushed commit evidence, and refuses unsafe archive operations unless `--force` is used. Add `--dry-run` to inspect the same evidence without archiving. Successful archives wait for worktree removal and report `worktreeCleanup`.", "`runpane panes rename` trims and updates a Pane's display name without changing its worktree, branch, panels, or focus, and returns the updated pane summary.", "`runpane 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 ...`, 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.";
@@ -492,7 +544,7 @@ export declare const RUNPANE_CONTRACT: {
         readonly publishingCredentials: readonly ["Local implementation, build, and dry-run validation do not need npm or PyPI API tokens.", "Release publishing should prefer npm Trusted Publishing and PyPI Trusted Publishing from GitHub Actions.", "Fallback `NPM_TOKEN` or `PYPI_API_TOKEN` credentials may be used for first package reservation or manual publication only. They must be supplied through local environment variables or GitHub Actions secrets, never committed, and revoked or rotated after use."];
     };
     readonly testFixtures: {
-        readonly parserSamples: readonly [readonly ["setup"], readonly ["install"], readonly ["install", "client", "--version", "v2.2.8", "--format", "dmg", "--download-dir", "/tmp/pane-downloads", "--dry-run", "--yes"], readonly ["install", "daemon", "--label", "VM", "--prefer-tunnel", "ssh", "--channel", "nightly", "--base-url", "https://example.test", "--pane-dir", "/tmp/pane", "--listen-port", "4555", "--auto-listen-port", "--print-only", "--repo-ref", "main", "--unknown-future-flag", "future-value", "--dry-run", "--verbose"], readonly ["update", "--version", "latest", "--format", "appimage", "--pane-path", "/usr/bin/pane", "--dry-run"], readonly ["doctor", "--pane-path", "/usr/bin/pane", "--format", "zip", "--verbose"], readonly ["doctor", "--json", "--pane-dir", "/tmp/pane"], readonly ["daemon", "repair", "--pane-dir", "/tmp/pane-remote", "--yes", "--json"], readonly ["agent-context"], readonly ["agent-context", "--command", "panes create", "--json"], readonly ["repos", "list", "--json", "--pane-dir", "/tmp/pane"], readonly ["repos", "add", "--path", "/tmp/repo", "--name", "Repo", "--dry-run", "--yes", "--json", "--pane-dir", "/tmp/pane"], readonly ["panes", "list", "--repo", "active", "--json"], readonly ["panes", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--source", "agent", "--pinned", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--source", "agent", "--no-pinned", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--from-json", "-", "--yes", "--json"], readonly ["panes", "archive", "--pane", "session-1", "--force", "--source", "agent", "--yes", "--json"], readonly ["panes", "pin", "--pane", "session-1", "--yes", "--json"], readonly ["panes", "unpin", "--pane", "session-1", "--yes", "--json"], readonly ["panes", "rename", "--pane", "session-1", "--name", "issue-393", "--yes", "--json"], readonly ["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 parserSamples: readonly [readonly ["setup"], readonly ["install"], readonly ["install", "client", "--version", "v2.2.8", "--format", "dmg", "--download-dir", "/tmp/pane-downloads", "--dry-run", "--yes"], readonly ["install", "daemon", "--label", "VM", "--prefer-tunnel", "ssh", "--channel", "nightly", "--base-url", "https://example.test", "--pane-dir", "/tmp/pane", "--listen-port", "4555", "--auto-listen-port", "--print-only", "--repo-ref", "main", "--unknown-future-flag", "future-value", "--dry-run", "--verbose"], readonly ["update", "--version", "latest", "--format", "appimage", "--pane-path", "/usr/bin/pane", "--dry-run"], readonly ["doctor", "--pane-path", "/usr/bin/pane", "--format", "zip", "--verbose"], readonly ["doctor", "--json", "--pane-dir", "/tmp/pane"], readonly ["doctor", "--report", "--title", "watch failed", "--body-file", "/tmp/watch-evidence.txt", "--json"], readonly ["watch", "--as", "monitor", "--from", "earliest", "--follow", "--format", "lines", "--heartbeat", "60", "--idle-after", "600000", "--all-managed", "--agents-only", "--exclude-pane", "pane-old", "--kinds", "agent.ready,agent.idle", "--include-held-input", "--self-test"], readonly ["daemon", "repair", "--pane-dir", "/tmp/pane-remote", "--yes", "--json"], readonly ["agent-context"], readonly ["agent-context", "--command", "panes create", "--json"], readonly ["repos", "list", "--json", "--pane-dir", "/tmp/pane"], readonly ["repos", "add", "--path", "/tmp/repo", "--name", "Repo", "--dry-run", "--yes", "--json", "--pane-dir", "/tmp/pane"], readonly ["panes", "list", "--repo", "active", "--json"], readonly ["panes", "cost", "--pane", "session-1", "--json"], readonly ["panes", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--source", "agent", "--pinned", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--source", "agent", "--no-pinned", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--from-json", "-", "--yes", "--json"], readonly ["panes", "archive", "--pane", "session-1", "--force", "--source", "agent", "--yes", "--json"], readonly ["panes", "pin", "--pane", "session-1", "--yes", "--json"], readonly ["panes", "unpin", "--pane", "session-1", "--yes", "--json"], readonly ["panes", "rename", "--pane", "session-1", "--name", "issue-393", "--yes", "--json"], readonly ["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"];
@@ -1321,6 +1373,261 @@ export declare const RUNPANE_CONTRACT: {
             };
             readonly additionalProperties: false;
         };
+        readonly paneCostRequest: {
+            readonly type: "object";
+            readonly properties: {
+                readonly repo: {
+                    readonly oneOf: readonly [{
+                        readonly type: "string";
+                    }, {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "number";
+                            };
+                            readonly path: {
+                                readonly type: "string";
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                            };
+                            readonly active: {
+                                readonly const: true;
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    }];
+                };
+                readonly paneId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly paneCostResult: {
+            readonly $defs: {
+                readonly usageTotals: {
+                    readonly type: "object";
+                    readonly required: readonly ["inputTokens", "outputTokens", "cacheReadTokens", "cacheCreationTokens", "totalTokens", "messageCount", "estimatedCostUsd", "costIncomplete", "cacheSavingsUsd"];
+                    readonly properties: {
+                        readonly inputTokens: {
+                            readonly type: "number";
+                        };
+                        readonly outputTokens: {
+                            readonly type: "number";
+                        };
+                        readonly cacheReadTokens: {
+                            readonly type: "number";
+                        };
+                        readonly cacheCreationTokens: {
+                            readonly type: "number";
+                        };
+                        readonly totalTokens: {
+                            readonly type: "number";
+                        };
+                        readonly messageCount: {
+                            readonly type: "number";
+                        };
+                        readonly estimatedCostUsd: {
+                            readonly type: "number";
+                        };
+                        readonly costIncomplete: {
+                            readonly type: "boolean";
+                        };
+                        readonly cacheSavingsUsd: {
+                            readonly type: "number";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+                readonly usageByModel: {
+                    readonly type: "object";
+                    readonly required: readonly ["model", "provider", "inputTokens", "outputTokens", "cacheReadTokens", "cacheCreationTokens", "totalTokens", "messageCount", "estimatedCostUsd", "costIncomplete", "cacheSavingsUsd"];
+                    readonly properties: {
+                        readonly model: {
+                            readonly type: "string";
+                        };
+                        readonly provider: {
+                            readonly enum: readonly ["claude", "codex"];
+                        };
+                        readonly inputTokens: {
+                            readonly type: "number";
+                        };
+                        readonly outputTokens: {
+                            readonly type: "number";
+                        };
+                        readonly cacheReadTokens: {
+                            readonly type: "number";
+                        };
+                        readonly cacheCreationTokens: {
+                            readonly type: "number";
+                        };
+                        readonly totalTokens: {
+                            readonly type: "number";
+                        };
+                        readonly messageCount: {
+                            readonly type: "number";
+                        };
+                        readonly estimatedCostUsd: {
+                            readonly type: "number";
+                        };
+                        readonly costIncomplete: {
+                            readonly type: "boolean";
+                        };
+                        readonly cacheSavingsUsd: {
+                            readonly type: "number";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+                readonly paneCostSlice: {
+                    readonly type: "object";
+                    readonly required: readonly ["inputTokens", "outputTokens", "cacheReadTokens", "cacheCreationTokens", "totalTokens", "messageCount", "estimatedCostUsd", "costIncomplete", "cacheSavingsUsd", "uncachedCostUsd", "uncachedInputTokens", "cacheHitRate", "byModel"];
+                    readonly properties: {
+                        readonly inputTokens: {
+                            readonly type: "number";
+                        };
+                        readonly outputTokens: {
+                            readonly type: "number";
+                        };
+                        readonly cacheReadTokens: {
+                            readonly type: "number";
+                        };
+                        readonly cacheCreationTokens: {
+                            readonly type: "number";
+                        };
+                        readonly totalTokens: {
+                            readonly type: "number";
+                        };
+                        readonly messageCount: {
+                            readonly type: "number";
+                        };
+                        readonly estimatedCostUsd: {
+                            readonly type: "number";
+                        };
+                        readonly costIncomplete: {
+                            readonly type: "boolean";
+                        };
+                        readonly cacheSavingsUsd: {
+                            readonly type: "number";
+                        };
+                        readonly uncachedCostUsd: {
+                            readonly type: "number";
+                        };
+                        readonly uncachedInputTokens: {
+                            readonly type: "number";
+                        };
+                        readonly cacheHitRate: {
+                            readonly type: "number";
+                        };
+                        readonly byModel: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly $ref: "#/$defs/usageByModel";
+                            };
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+                readonly pane: {
+                    readonly type: "object";
+                    readonly required: readonly ["paneId", "paneName", "worktreePath", "repoId", "archived", "createdAtMs", "inputTokens", "outputTokens", "cacheReadTokens", "cacheCreationTokens", "totalTokens", "messageCount", "estimatedCostUsd", "costIncomplete", "cacheSavingsUsd", "uncachedCostUsd", "uncachedInputTokens", "cacheHitRate", "byModel"];
+                    readonly properties: {
+                        readonly paneId: {
+                            readonly type: "string";
+                        };
+                        readonly paneName: {
+                            readonly type: "string";
+                        };
+                        readonly worktreePath: {
+                            readonly type: "string";
+                        };
+                        readonly repoId: {
+                            readonly type: readonly ["number", "null"];
+                        };
+                        readonly archived: {
+                            readonly type: "boolean";
+                        };
+                        readonly createdAtMs: {
+                            readonly type: "number";
+                        };
+                        readonly inputTokens: {
+                            readonly type: "number";
+                        };
+                        readonly outputTokens: {
+                            readonly type: "number";
+                        };
+                        readonly cacheReadTokens: {
+                            readonly type: "number";
+                        };
+                        readonly cacheCreationTokens: {
+                            readonly type: "number";
+                        };
+                        readonly totalTokens: {
+                            readonly type: "number";
+                        };
+                        readonly messageCount: {
+                            readonly type: "number";
+                        };
+                        readonly estimatedCostUsd: {
+                            readonly type: "number";
+                        };
+                        readonly costIncomplete: {
+                            readonly type: "boolean";
+                        };
+                        readonly cacheSavingsUsd: {
+                            readonly type: "number";
+                        };
+                        readonly uncachedCostUsd: {
+                            readonly type: "number";
+                        };
+                        readonly uncachedInputTokens: {
+                            readonly type: "number";
+                        };
+                        readonly cacheHitRate: {
+                            readonly type: "number";
+                        };
+                        readonly byModel: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly $ref: "#/$defs/usageByModel";
+                            };
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+            };
+            readonly type: "object";
+            readonly required: readonly ["ok", "fromMs", "toMs", "pricingAsOf", "panes"];
+            readonly properties: {
+                readonly ok: {
+                    readonly const: true;
+                };
+                readonly fromMs: {
+                    readonly type: "number";
+                };
+                readonly toMs: {
+                    readonly type: "number";
+                };
+                readonly pricingAsOf: {
+                    readonly type: "string";
+                };
+                readonly panes: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/pane";
+                    };
+                };
+                readonly unattributed: {
+                    readonly $ref: "#/$defs/paneCostSlice";
+                };
+                readonly totals: {
+                    readonly $ref: "#/$defs/usageTotals";
+                };
+            };
+            readonly additionalProperties: false;
+        };
         readonly workspaceEntry: {
             readonly type: "object";
             readonly required: readonly ["gen", "at", "kind", "paneId", "paneName", "source"];
@@ -1332,7 +1639,7 @@ export declare const RUNPANE_CONTRACT: {
                     readonly type: "string";
                 };
                 readonly kind: {
-                    readonly enum: readonly ["agent.ready", "agent.busy", "agent.blocked", "agent.unknown", "pane.created", "pane.gone", "panel.exited"];
+                    readonly enum: readonly ["agent.ready", "agent.busy", "agent.blocked", "agent.unknown", "agent.idle", "pane.created", "pane.gone", "panel.exited"];
                 };
                 readonly paneId: {
                     readonly type: "string";
@@ -1374,9 +1681,18 @@ export declare const RUNPANE_CONTRACT: {
                 readonly settledMs: {
                     readonly type: "number";
                 };
+                readonly idleMs: {
+                    readonly type: "number";
+                };
+                readonly idleCount: {
+                    readonly type: "number";
+                };
                 readonly heldInput: {
                     readonly type: "string";
                 };
+                readonly heldInputPresent: {
+                    readonly type: "boolean";
+                };
                 readonly exitCode: {
                     readonly type: "number";
                 };
@@ -1419,6 +1735,12 @@ export declare const RUNPANE_CONTRACT: {
                         readonly type: "string";
                     };
                 };
+                readonly excludePaneIds: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
                 readonly repo: {
                     readonly oneOf: readonly [{
                         readonly type: "string";
@@ -1444,12 +1766,24 @@ export declare const RUNPANE_CONTRACT: {
                 readonly nameContains: {
                     readonly type: "string";
                 };
+                readonly agentsOnly: {
+                    readonly type: "boolean";
+                };
                 readonly ackNow: {
                     readonly type: "boolean";
                 };
                 readonly includeHeldInput: {
                     readonly type: "boolean";
                 };
+                readonly includeHeldInputPresence: {
+                    readonly type: "boolean";
+                };
+                readonly idleAfterMs: {
+                    readonly type: "number";
+                };
+                readonly idleWindowStartMs: {
+                    readonly type: "number";
+                };
             };
             readonly additionalProperties: false;
         };
@@ -2577,6 +2911,10 @@ export declare const RUNPANE_CONTRACT: {
                 readonly name: "panes list";
                 readonly summary: "List Pane sessions, optionally scoped to a saved repository.";
                 readonly arguments: readonly ["--repo <selector>", "--json", "--pane-dir <path>"];
+            }, {
+                readonly name: "panes cost";
+                readonly summary: "Report estimated token cost per Pane, with per-model breakdown and cache efficiency.";
+                readonly arguments: readonly ["--repo <selector>", "--pane <pane-id>", "--json", "--pane-dir <path>"];
             }, {
                 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.";
@@ -2754,8 +3092,26 @@ export declare const RUNPANE_CONTRACT: {
                     readonly name: "--verbose";
                     readonly required: false;
                     readonly description: "Print extra diagnostics.";
+                }, {
+                    readonly name: "--report";
+                    readonly required: false;
+                    readonly description: "Prepare a redacted, inspectable diagnostic report.";
+                }, {
+                    readonly name: "--body-file";
+                    readonly value: "<path|->";
+                    readonly required: false;
+                    readonly description: "Read report evidence from a file or stdin.";
+                }, {
+                    readonly name: "--title";
+                    readonly value: "<text>";
+                    readonly required: false;
+                    readonly description: "Report title.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Confirm creating exactly one dcouple/Pane issue.";
                 }];
-                readonly examples: readonly ["runpane doctor --json", "runpane doctor"];
+                readonly examples: readonly ["runpane doctor --json", "runpane doctor", "runpane doctor --report --title \"runpane watch failed\" --body-file ./watch.txt --json"];
                 readonly jsonSchemas: readonly ["doctorResult"];
                 readonly notes: readonly ["Agents should run `runpane doctor --json` before mutating Pane state.", "The JSON report includes daemon reachability as data; an unreachable daemon is not a reason to skip the rest of the report.", "Use `runpane agent-context --json` after doctor when full CLI context is needed."];
             };
@@ -2891,6 +3247,36 @@ export declare const RUNPANE_CONTRACT: {
                 readonly jsonSchemas: readonly ["paneListResult"];
                 readonly notes: readonly ["Without --repo, this lists sessions across saved Pane repositories."];
             };
+            readonly "panes cost": {
+                readonly name: "panes cost";
+                readonly summary: "Report estimated token cost per Pane, with per-model breakdown and cache efficiency.";
+                readonly details: "Use this to attribute estimated workspace token costs to Pane lifetimes and inspect the models and cache efficiency behind each Pane's spend.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--repo";
+                    readonly value: "<selector>";
+                    readonly required: false;
+                    readonly description: "Optional repository selector: active, id, exact path, or saved repository name.";
+                }, {
+                    readonly name: "--pane";
+                    readonly value: "<pane-id>";
+                    readonly required: false;
+                    readonly description: "Return only the selected Pane.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane panes cost --pane <pane-id> --json"];
+                readonly jsonSchemas: readonly ["paneCostRequest", "paneCostResult"];
+                readonly notes: readonly ["The report range is the last 30 days.", "Costs are estimates based on API token prices.", "The unattributed bucket reconciles the Pane rows against totals in the unscoped result."];
+            };
             readonly "panes create": {
                 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.";
@@ -3470,7 +3856,7 @@ export declare const RUNPANE_CONTRACT: {
             readonly watch: {
                 readonly name: "watch";
                 readonly summary: "Wait for workspace transitions using the daemon journal.";
-                readonly details: "Named cursors persist in the Pane data directory so separate invocations do not need local state.";
+                readonly details: "`runpane watch --follow` is the canonical zero-flag monitor: lines, 60-second heartbeats, 10-minute re-firing IDLE, managed-agent scope, and redacted STUCK detection are follow defaults. Named cursors persist in the Pane data directory.";
                 readonly requiresPaneDaemon: true;
                 readonly mutates: false;
                 readonly arguments: readonly [{
@@ -3487,13 +3873,40 @@ export declare const RUNPANE_CONTRACT: {
                     readonly name: "--follow";
                     readonly required: false;
                     readonly description: "Continue waiting until interrupted.";
+                }, {
+                    readonly name: "--format";
+                    readonly value: "<lines|json>";
+                    readonly required: false;
+                    readonly description: "Output format; lines is the follow default.";
+                }, {
+                    readonly name: "--heartbeat";
+                    readonly value: "<seconds>";
+                    readonly required: false;
+                    readonly description: "Healthy-silence bound; defaults to 60 under follow.";
+                }, {
+                    readonly name: "--idle-after";
+                    readonly value: "<milliseconds>";
+                    readonly required: false;
+                    readonly description: "Re-firing READY idle interval; defaults to 600000 under follow.";
+                }, {
+                    readonly name: "--all-managed";
+                    readonly required: false;
+                    readonly description: "Explicit spelling for the all-managed default scope.";
+                }, {
+                    readonly name: "--include-shells";
+                    readonly required: false;
+                    readonly description: "Include ordinary shell panels.";
+                }, {
+                    readonly name: "--self-test";
+                    readonly required: false;
+                    readonly description: "Probe the watch path anonymously without advancing a named cursor.";
                 }, {
                     readonly name: "--json";
                     readonly required: false;
-                    readonly description: "Emit one NDJSON line per entry.";
+                    readonly description: "Emit structured NDJSON; held-input content remains opt-in.";
                 }];
-                readonly examples: readonly ["runpane watch --as monitor --follow --json"];
-                readonly notes: readonly ["Journal loss is surfaced through reset and dropped metadata."];
+                readonly examples: readonly ["runpane watch --follow", "runpane watch --as monitor --follow --json"];
+                readonly notes: readonly ["Journal loss is surfaced through reset and dropped metadata.", "The daemon treats omitted idleAfterMs as disabled so older clients never receive agent.idle unexpectedly."];
             };
         };
         readonly managedBlock: readonly ["## Pane", "", "The developer is using Pane for this repository. Pane can manage saved repositories and create user-visible Panes with terminal-backed tools for planning, discussion, implementation, and review work.", "", "This managed guidance was created by [runpane.com](https://runpane.com) for the [Pane repository](https://github.com/dcouple/Pane). Do not delete or overwrite this block; the developer uses it for their workflow and it should remain committed to the main repository unless they explicitly ask to remove it.", "", "Pane mental model: a repository is the saved base repo; a Pane is a user-visible feature/PR workspace (Pane session) that normally maps to one Pane-managed git worktree and branch; a panel/tab is a terminal inside one Pane and shares that Pane's worktree; an agent is the CLI process running in a panel.", "", "Default happy path when the user asks you to use Pane or RunPane: run `runpane doctor --json`; read `runpane agent-context --json`; resolve the saved base repository with `runpane repos list --json` or add it once with `runpane repos add --path <repo> --yes --json`; create one visible Pane (Pane session) for the requested feature/PR with a complete command such as `runpane panes create --repo <repo> --name <name> --agent <agent> --prompt \"<task>\" --source agent --no-focus --wait-ready --yes --json` or the equivalent `--tool-command <command>` form; then validate with `runpane panels wait` or `runpane panels screen` before reporting progress.", "", "Use Pane when the user wants visible Panes or co-drivable parallel feature/PR workspaces. Do not use Pane as your default private delegation mechanism; for private background decomposition, use your normal subagent/worktree workflow.", "", "Register the main/base repository once. Do not register pre-created git worktrees as separate Pane repositories unless the user explicitly asks.", "", "Use `runpane panes create` for separate visible Panes (Pane sessions) for feature/PR work. Use `runpane panels create` for reviewer/helper tabs inside an existing Pane that should share that Pane's worktree.", "", "Typical workflow: register the saved base repository once; create one Pane (Pane session) per feature/PR; use panels/tabs inside that Pane for helper or reviewer agents that should share the worktree; archive the Pane after the PR is done to remove it from active Panes and clean up its managed worktree when applicable.", "", "Skill routing reference: when the user says `discussion`, `plan`, `simple-plan`, `create-plan`, or `implement`, or asks for the behavior those words imply, 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](https://github.com/dcouple/skills/raw/main/docs/readme-workflow-map.png).", "Use those peer references together to choose the phase: discuss/investigate until the work is clear enough to delegate, then ticket/plan/implement/review/PR-test/teach-back as appropriate. The orchestrator and workflow map may point to different skills; reconcile them with the user's request instead of hardcoding a skill list or treating one reference as subordinate.", "For the Pane implementation source of truth for where the skill cache, cached workflow assets, and Pane Chat bootstrap live, reference [PR #291](https://github.com/dcouple/Pane/pull/291): `main/src/services/skillCacheManager.ts` owns `<PANE_DIR>/skills/`, `.sources/dcouple-skills`, and `pane-chat/runpane-orchestrator.md`; `main/src/services/paneChatManager.ts` owns the tiny bootstrap prompt that tells the selected Pane Chat agent to read that guide.", "Use GitHub reads against the [Parsa skills folder](https://github.com/dcouple/skills/tree/main/parsa) only to inspect or refresh referenced skill files; do not clone/install the repo unless the user asks.", "Do not hardcode a specific assistant brand in workflow guidance. Use the Pane agent or custom tool command the user selected, and use `runpane agents doctor --agent <agent> --repo <selector> --json` only when checking a built-in agent template.", "", "Start with `runpane doctor --json` before taking Pane actions. Use it to understand wrapper/runtime details, daemon reachability, and the next safe commands.", "", "In a Pane repository checkout, if `runpane` is not on PATH, use the built local wrapper with Node 22: `PATH=/opt/homebrew/opt/node@22/bin:$PATH node packages/runpane/dist/cli.js doctor --json`.", "", "Use `runpane agent-context --json` for full Pane CLI context. Use `runpane agent-context --command \"panels wait\" --json` or another command name for detailed schema only when needed.", "", "Default to context-safe validation: after creating Panes or sending terminal input, run `runpane panels wait` or `runpane panels screen` before reporting success. Prefer `runpane panels submit` for normal text plus Enter; use `runpane panels input` only for exact bytes such as Ctrl-C or escape sequences.", "", "Pane terminals draw inline images: sixel, iTerm2 inline images, and the kitty graphics protocol. Tools that need kitty graphics, such as [terminal-browser](https://github.com/zenbu-labs/terminal-browser) and [terminal-doom](https://github.com/dcouple/terminal-doom), run inside a Pane panel. `runpane doctor --json` reports the protocol list under `terminal.graphicsProtocols`.", "", "Common commands:", "- `runpane doctor --json`", "- `runpane agent-context --json`", "- `runpane repos list --json`", "- `runpane repos add --path <repo> --yes --json`", "- `runpane agents doctor --agent <agent> --repo active --json`", "- `runpane panes create --repo active --name <name> --agent <agent> --prompt \"<task>\" --source agent --no-focus --wait-ready --yes --json`", "- `runpane panels create --pane <pane-id> --agent <agent> --source agent --no-focus --wait-ready --yes --json`", "- `runpane panels list --pane <pane-id> --json`", "- `runpane panels screen --panel <panel-id> --limit 80 --json`", "- `runpane panels wait --panel <panel-id> --for ready --timeout-ms 30000 --json`", "- `runpane panels submit --panel <panel-id> --text \"<answer>\" --yes --json`", "- `runpane panels input --panel <panel-id> --input-file <path|-> --yes --json`", "", "WSL note: if `runpane doctor --json` cannot find `/tmp/pane-daemon.../daemon.sock` or `runpane` resolves to a broken Windows shim, Pane may be running on Windows. Try `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane doctor --json'`, then create Panes through the same PowerShell form using the saved WSL repo name or id. Use `runpane agents doctor --agent <agent> --repo <selector> --json` to diagnose the repo environment Pane will actually use."];