runpane 2.3.7 → 2.3.9

package/dist/generated/contract.d.ts

@@ -68,8 +68,14 @@ export declare const RUNPANE_CONTRACT: {
         readonly usage: readonly ["runpane version", "runpane --version"];
     }, {
         readonly name: "doctor";
-        readonly summary: "Run platform, release, installed Pane, and remote setup diagnostics.";
-        readonly usage: readonly ["runpane 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 jsonSchemas: readonly ["doctorResult"];
+    }, {
+        readonly name: "agents doctor";
+        readonly summary: "Diagnose whether a built-in agent command is available in a Pane repository environment.";
+        readonly usage: readonly ["runpane agents doctor --agent <codex|claude> [--repo <selector>] [--json]"];
+        readonly jsonSchemas: readonly ["agentDoctorResult"];
     }, {
         readonly name: "agent-context";
         readonly summary: "Print token-efficient Pane command context for coding agents.";
@@ -107,12 +113,28 @@ export declare const RUNPANE_CONTRACT: {
         readonly summary: "Read recent terminal output from a panel.";
         readonly usage: readonly ["runpane panels output --panel <panel-id> [--limit <count>] [--json]"];
         readonly jsonSchemas: readonly ["panelOutputResult"];
+    }, {
+        readonly name: "panels screen";
+        readonly summary: "Read a compact current-screen view from a terminal panel.";
+        readonly usage: readonly ["runpane panels screen --panel <panel-id> [--limit <count>] [--json]"];
+        readonly jsonSchemas: readonly ["panelScreenResult"];
     }, {
         readonly name: "panels input";
         readonly summary: "Send input bytes to a terminal panel.";
         readonly usage: readonly ["runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]"];
         readonly mutates: true;
         readonly jsonSchemas: readonly ["panelInputRequest", "panelInputResult"];
+    }, {
+        readonly name: "panels submit";
+        readonly summary: "Send text to a terminal panel and append a terminal Enter byte.";
+        readonly usage: readonly ["runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]"];
+        readonly mutates: true;
+        readonly jsonSchemas: readonly ["panelSubmitRequest", "panelSubmitResult"];
+    }, {
+        readonly name: "panels wait";
+        readonly summary: "Wait for a terminal panel to initialize, become ready/idle, or contain text.";
+        readonly usage: readonly ["runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--contains <text>] [--timeout-ms <ms>] [--interval-ms <ms>] [--json]"];
+        readonly jsonSchemas: readonly ["panelWaitResult"];
     }];
     readonly flags: {
         readonly wrapper: readonly [{
@@ -239,10 +261,30 @@ export declare const RUNPANE_CONTRACT: {
             readonly name: "--timeout-ms";
             readonly value: "<milliseconds>";
             readonly description: "Maximum time to wait for each pane creation job.";
+        }, {
+            readonly name: "--ready-timeout-ms";
+            readonly value: "<milliseconds>";
+            readonly description: "Readiness wait timeout for panes create --wait-ready.";
+        }, {
+            readonly name: "--concurrency";
+            readonly value: "<count>";
+            readonly description: "Accepted for forward compatibility. Pane currently serializes multi-pane session creation so queued jobs do not time out before starting.";
         }, {
             readonly name: "--limit";
             readonly value: "<count>";
             readonly description: "Maximum recent output lines or records to read.";
+        }, {
+            readonly name: "--for";
+            readonly value: "<initialized|ready|idle|text>";
+            readonly description: "Panel wait condition.";
+        }, {
+            readonly name: "--contains";
+            readonly value: "<text>";
+            readonly description: "Text to wait for with panels wait --for text.";
+        }, {
+            readonly name: "--interval-ms";
+            readonly value: "<milliseconds>";
+            readonly description: "Polling interval for panels wait.";
         }, {
             readonly name: "--text";
             readonly value: "<text>";
@@ -255,40 +297,51 @@ export declare const RUNPANE_CONTRACT: {
         readonly localBoolean: readonly [{
             readonly name: "--json";
             readonly description: "Print machine-readable JSON output.";
+        }, {
+            readonly name: "--wait-ready";
+            readonly description: "Wait for created terminal panels to be ready before returning.";
         }];
     };
     readonly help: {
         readonly npm: {
-            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane agent-context [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude>", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> --input-file <path|-> --yes", "  runpane help [command]", "", "Quick start:", "  npx --yes runpane@latest", "  npm i -g runpane && runpane setup", "", "Advanced examples:", "  npx --yes runpane@latest install client", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest", "  pipx run runpane", "", "Run \"runpane agent-context\" when an agent needs Pane command context.", "Run \"runpane help panes create\" for pane orchestration options."];
+            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane agent-context [--json]", "  runpane agents doctor --agent <codex|claude> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--wait-ready]", "  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> --input-file <path|-> --yes", "  runpane panels submit --panel <panel-id> --text <text> --yes", "  runpane panels wait --panel <panel-id> [--for 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 [--pane-path <path>] [--format <format>] [--verbose]"];
+            readonly doctor: readonly ["Usage:", "  runpane doctor [--json] [--pane-dir <path>] [--pane-path <path>] [--format <format>] [--verbose]", "", "Checks wrapper/runtime details, release metadata, installed Pane detection, and Pane daemon reachability.", "", "Options:", "  --json                         Print a machine-readable environment report", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --pane-path <path>             Inspect a specific Pane executable", "  --format <format>              Release artifact format to inspect", "  --verbose                      Print extra diagnostics", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json"];
             readonly "repos list": readonly ["Usage:", "  runpane repos list [--json] [--pane-dir <path>]", "", "Lists repositories saved in the running Pane app.", "", "Options:", "  --json                         Print machine-readable output", "  --pane-dir <path>              Connect to a specific Pane data directory"];
             readonly "repos add": readonly ["Usage:", "  runpane repos add --path <path> [--name <name>] [--json] [--yes]", "", "Registers an existing git repository with the running Pane app.", "", "Options:", "  --path <path>                  Existing git repository path", "  --name <name>                  Saved repository name; defaults to the directory name", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --dry-run                      Validate and preview without adding the repo", "  --yes                          Skip confirmation for mutating commands"];
             readonly "panes list": readonly ["Usage:", "  runpane panes list [--repo <selector>] [--json]", "", "Lists Pane sessions. Pass --repo to limit results to one saved repository.", "", "Options:", "  --repo <selector>              active, id, exact path, or saved repository name", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
-            readonly "panes create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes create --from-json <path|-> [--yes] [--json]", "", "Creates Pane sessions in a saved repository and opens a terminal-backed tool tab.", "", "Options:", "  --repo <selector>              active, id, exact path, or saved repository name", "  --name <name>                  Pane/session name", "  --worktree-name <name>         Worktree name; defaults to --name", "  --base-branch <branch>         Base branch for the worktree", "  --agent <codex|claude>         Built-in terminal template", "  --tool-command <command>       Custom terminal command", "  --title <title>                Terminal tab title", "  --initial-input <text>         Text sent after the command is ready", "  --prompt <text>                Alias for --initial-input", "  --initial-input-file <path|->  Read initial input from a file or stdin", "  --from-json <path|->           Read a full request payload", "  --timeout-ms <milliseconds>    Pane creation timeout", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --dry-run                      Validate and preview without creating panes", "  --yes                          Skip confirmation for mutating commands"];
+            readonly "panes create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes create --from-json <path|-> [--yes] [--json]", "", "Creates Pane sessions in a saved repository and opens a terminal-backed tool tab.", "", "Options:", "  --repo <selector>              active, id, exact path, or saved repository name", "  --name <name>                  Pane/session name", "  --worktree-name <name>         Worktree name; defaults to --name", "  --base-branch <branch>         Base branch for the worktree", "  --agent <codex|claude>         Built-in terminal template", "  --tool-command <command>       Custom terminal command", "  --title <title>                Terminal tab title", "  --initial-input <text>         Text sent after the command is ready", "  --prompt <text>                Alias for --initial-input", "  --initial-input-file <path|->  Read initial input from a file or stdin", "  --from-json <path|->           Read a full request payload", "  --timeout-ms <milliseconds>    Pane creation timeout", "  --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", "  --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 "panels list": readonly ["Usage:", "  runpane panels list --pane <pane-id> [--json]", "", "Lists tool panels in a Pane session.", "", "Options:", "  --pane <pane-id>               Pane/session id", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
             readonly "panels output": readonly ["Usage:", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "", "Reads bounded recent terminal output from a panel.", "", "Options:", "  --panel <panel-id>             Tool panel id", "  --limit <count>                Maximum recent output lines or records to read", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
             readonly "panels input": readonly ["Usage:", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "", "Sends exact input bytes to a terminal panel. Include a newline in the input when you mean Enter.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --text <text>                  Text bytes to send", "  --input-file <path|->          Read input from a file or stdin", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --yes                          Skip confirmation for mutating commands"];
             readonly "agent-context": readonly ["Usage:", "  runpane agent-context [--json]", "  runpane agent-context --command <command> [--json]", "", "Prints Pane command context for coding agents without requiring a running Pane app.", "", "Options:", "  --command <command>            Print the full definition for one runpane command", "  --json                         Print machine-readable output", "", "Examples:", "  runpane agent-context", "  runpane agent-context --json", "  runpane agent-context --command \"panes create\"", "  runpane agent-context --command \"panes create\" --json"];
+            readonly "agents doctor": readonly ["Usage:", "  runpane agents doctor --agent <codex|claude> [--repo <selector>] [--json]", "", "Diagnoses whether Codex or Claude is available in the same repository environment Pane will use.", "", "Options:", "  --agent <codex|claude>         Built-in agent command to diagnose", "  --repo <selector>              active, id, exact path, or saved repository name; defaults to active", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
+            readonly "panels screen": readonly ["Usage:", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "", "Reads a compact current-screen view from a terminal panel. Prefers alternate-screen/TUI output and falls back to recent scrollback.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --limit <count>                Maximum lines to return; defaults to 80", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
+            readonly "panels submit": readonly ["Usage:", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "", "Sends text to a terminal panel and normalizes the final terminal Enter to CR. Use this for ordinary prompt answers and shell commands.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --text <text>                  Text to submit before Enter", "  --input-file <path|->          Read text from a file or stdin before Enter", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --yes                          Skip confirmation for this mutating command"];
+            readonly "panels wait": readonly ["Usage:", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--contains <text>] [--timeout-ms <ms>] [--interval-ms <ms>] [--json]", "", "Polls a terminal panel until it is initialized, ready, idle, or contains text. Output is intentionally small and includes next-step guidance.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --for <condition>              initialized, ready, idle, or text; defaults to ready for CLI panels and idle otherwise", "  --contains <text>              Text required for --for text; implies --for text when omitted", "  --timeout-ms <milliseconds>    Wait timeout; defaults to 30000", "  --interval-ms <milliseconds>   Poll interval; defaults to 500", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
         };
         readonly pip: {
-            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane agent-context [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude>", "  runpane panels list --pane <pane-id> [--json]", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "  runpane panels input --panel <panel-id> --input-file <path|-> --yes", "  runpane help [command]", "", "Quick start:", "  pipx run runpane", "  python -m pip install runpane && python -m runpane setup", "", "Advanced examples:", "  pipx run runpane install client", "  pipx run runpane install daemon --label \"My Server\"", "  uvx runpane@latest", "", "Run \"runpane agent-context\" when an agent needs Pane command context.", "Run \"runpane help panes create\" for pane orchestration options."];
+            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane agent-context [--json]", "  runpane agents doctor --agent <codex|claude> [--repo <selector>] [--json]", "  runpane repos list [--json]", "  runpane repos add --path <path> [--name <name>]", "  runpane panes list [--repo <selector>] [--json]", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--wait-ready]", "  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> --input-file <path|-> --yes", "  runpane panels submit --panel <panel-id> --text <text> --yes", "  runpane panels wait --panel <panel-id> [--for 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 [--pane-path <path>] [--format <format>] [--verbose]"];
+            readonly doctor: readonly ["Usage:", "  runpane doctor [--json] [--pane-dir <path>] [--pane-path <path>] [--format <format>] [--verbose]", "", "Checks wrapper/runtime details, release metadata, installed Pane detection, and Pane daemon reachability.", "", "Options:", "  --json", "  --pane-dir <path>", "  --pane-path <path>", "  --format <format>", "  --verbose", "", "Agent discovery:", "  runpane doctor --json", "  runpane agent-context --json"];
             readonly "repos list": readonly ["Usage:", "  runpane repos list [--json] [--pane-dir <path>]", "", "Lists repositories saved in the running Pane app.", "", "Options:", "  --json", "  --pane-dir <path>"];
             readonly "repos add": readonly ["Usage:", "  runpane repos add --path <path> [--name <name>] [--json] [--yes]", "", "Registers an existing git repository with the running Pane app.", "", "Options:", "  --path <path>", "  --name <name>", "  --pane-dir <path>", "  --json", "  --dry-run", "  --yes"];
             readonly "panes list": readonly ["Usage:", "  runpane panes list [--repo <selector>] [--json]", "", "Lists Pane sessions. Pass --repo to limit results to one saved repository.", "", "Options:", "  --repo <selector>", "  --pane-dir <path>", "  --json"];
-            readonly "panes create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes create --from-json <path|-> [--yes] [--json]", "", "Creates Pane sessions in a saved repository and opens a terminal-backed tool tab.", "", "Options:", "  --repo <selector>", "  --name <name>", "  --worktree-name <name>", "  --base-branch <branch>", "  --agent <codex|claude>", "  --tool-command <command>", "  --title <title>", "  --initial-input <text>", "  --prompt <text>", "  --initial-input-file <path|->", "  --from-json <path|->", "  --timeout-ms <milliseconds>", "  --pane-dir <path>", "  --json", "  --dry-run", "  --yes"];
+            readonly "panes create": readonly ["Usage:", "  runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]", "  runpane panes create --from-json <path|-> [--yes] [--json]", "", "Creates Pane sessions in a saved repository and opens a terminal-backed tool tab.", "", "Options:", "  --repo <selector>              active, id, exact path, or saved repository name", "  --name <name>                  Pane/session name", "  --worktree-name <name>         Worktree name; defaults to --name", "  --base-branch <branch>         Base branch for the worktree", "  --agent <codex|claude>         Built-in terminal template", "  --tool-command <command>       Custom terminal command", "  --title <title>                Terminal tab title", "  --initial-input <text>         Text sent after the command is ready", "  --prompt <text>                Alias for --initial-input", "  --initial-input-file <path|->  Read initial input from a file or stdin", "  --from-json <path|->           Read a full request payload", "  --timeout-ms <milliseconds>    Pane creation timeout", "  --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", "  --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 "panels list": readonly ["Usage:", "  runpane panels list --pane <pane-id> [--json]", "", "Lists tool panels in a Pane session.", "", "Options:", "  --pane <pane-id>", "  --pane-dir <path>", "  --json"];
             readonly "panels output": readonly ["Usage:", "  runpane panels output --panel <panel-id> [--limit <count>] [--json]", "", "Reads recent terminal output records from a panel.", "", "Options:", "  --panel <panel-id>", "  --limit <count>", "  --pane-dir <path>", "  --json"];
             readonly "panels input": readonly ["Usage:", "  runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "", "Sends exact input bytes to a terminal panel. Include a newline in the input when you mean Enter.", "", "Options:", "  --panel <panel-id>", "  --text <text>", "  --input-file <path|->", "  --pane-dir <path>", "  --json", "  --yes"];
             readonly "agent-context": readonly ["Usage:", "  runpane agent-context [--json]", "  runpane agent-context --command <command> [--json]", "", "Prints Pane command context for coding agents without requiring a running Pane app.", "", "Options:", "  --command <command>", "  --json", "", "Examples:", "  runpane agent-context", "  runpane agent-context --json", "  runpane agent-context --command \"panes create\"", "  runpane agent-context --command \"panes create\" --json"];
+            readonly "agents doctor": readonly ["Usage:", "  runpane agents doctor --agent <codex|claude> [--repo <selector>] [--json]", "", "Diagnoses whether Codex or Claude is available in the same repository environment Pane will use.", "", "Options:", "  --agent <codex|claude>         Built-in agent command to diagnose", "  --repo <selector>              active, id, exact path, or saved repository name; defaults to active", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
+            readonly "panels screen": readonly ["Usage:", "  runpane panels screen --panel <panel-id> [--limit <count>] [--json]", "", "Reads a compact current-screen view from a terminal panel. Prefers alternate-screen/TUI output and falls back to recent scrollback.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --limit <count>                Maximum lines to return; defaults to 80", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
+            readonly "panels submit": readonly ["Usage:", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]", "", "Sends text to a terminal panel and normalizes the final terminal Enter to CR. Use this for ordinary prompt answers and shell commands.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --text <text>                  Text to submit before Enter", "  --input-file <path|->          Read text from a file or stdin before Enter", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --yes                          Skip confirmation for this mutating command"];
+            readonly "panels wait": readonly ["Usage:", "  runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--contains <text>] [--timeout-ms <ms>] [--interval-ms <ms>] [--json]", "", "Polls a terminal panel until it is initialized, ready, idle, or contains text. Output is intentionally small and includes next-step guidance.", "", "Options:", "  --panel <panel-id>             Terminal panel id", "  --for <condition>              initialized, ready, idle, or text; defaults to ready for CLI panels and idle otherwise", "  --contains <text>              Text required for --for text; implies --for text when omitted", "  --timeout-ms <milliseconds>    Wait timeout; defaults to 30000", "  --interval-ms <milliseconds>   Poll interval; defaults to 500", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output"];
         };
     };
     readonly docs: {
@@ -297,17 +350,17 @@ export declare const RUNPANE_CONTRACT: {
         readonly npmCommands: readonly ["npx --yes runpane@latest", "npx --yes runpane@latest setup", "npx --yes runpane@latest install client", "npx --yes runpane@latest install daemon --label \"My Server\"", "pnpm dlx runpane@latest", "pnpm dlx runpane@latest install daemon --label \"My Server\"", "npm i -g runpane && runpane", "npm i -g runpane && runpane setup", "npm i -g runpane && runpane install daemon --label \"My Server\"", "pnpm add -g runpane && runpane", "pnpm add -g runpane && runpane setup", "pnpm add -g runpane && runpane install daemon --label \"My Server\"", "yarn dlx runpane@latest install daemon --label \"My Server\"", "bunx runpane@latest install daemon --label \"My Server\""];
         readonly pythonCommands: readonly ["pipx run runpane", "pipx run runpane setup", "python -m pip install runpane", "runpane", "runpane setup", "python -m runpane setup", "runpane install daemon --label \"My Server\"", "pipx install runpane", "runpane", "runpane setup", "pipx run runpane install daemon --label \"My Server\"", "uvx runpane@latest", "uvx runpane@latest setup", "uvx runpane@latest install daemon --label \"My Server\"", "python -m runpane install daemon --label \"My Server\""];
         readonly packageManagerNotes: readonly ["Use `pnpm dlx` for one-shot pnpm execution and `pnpm add -g` for persistent CLI installation.", "Do not document `pnpm install runpane` as the public CLI install path."];
-        readonly commandUsages: readonly ["runpane", "runpane setup", "runpane install", "runpane install client", "runpane install daemon", "runpane update", "runpane version", "runpane doctor", "runpane 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 codex --prompt \"Kick off the discussion skill for issue 252\" --yes", "runpane panes create --from-json panes.json --yes --json", "runpane panels list --pane <pane-id> --json", "runpane panels output --panel <panel-id> --limit 200 --json", "printf 'Continue\\n' | runpane panels input --panel <panel-id> --input-file - --yes --json", "runpane help", "runpane <command> --help"];
-        readonly commandDescriptions: readonly ["`runpane` with no arguments and `runpane setup` open an interactive wizard when stdin and stdout are TTYs. In non-interactive shells or CI, both forms must print help and exit successfully instead of waiting for input.", "`runpane install` is an alias for `runpane install client`.", "`runpane install client` downloads the selected Pane desktop artifact and installs, opens, or launches it for the current platform.", "`runpane install daemon` downloads or installs Pane, resolves a stable Pane executable path, and spawns `<pane executable> --remote-setup <forwarded remote setup args>`.", "The wrapper must stream Pane stdout/stderr without reformatting because `pane --remote-setup` prints the one-time `pane-remote://...` connection code.", "`runpane update` uses the same release resolution and installer path as `install client`.", "`runpane version` prints the wrapper package version, the installed Pane version when detectable, and the latest GitHub release version when reachable.", "`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, and remote-daemon hints.", "`runpane agent-context` prints a brief, token-efficient command schema for coding agents without connecting to the Pane daemon.", "`runpane agent-context --command \"panes create\"` prints the detailed definition for one command. Add `--json` for machine-readable output.", "`runpane repos list` connects to the running local Pane daemon and prints saved repository records.", "`runpane repos add` registers an existing git repository with the running local Pane daemon. It does not create directories or initialize git repositories by default.", "`runpane panes list` lists Pane sessions, optionally scoped to one saved repository.", "`runpane panes create` connects to the running local Pane daemon, resolves the requested repository, creates Pane sessions, opens terminal-backed tool tabs, and optionally sends initial input to the started tool.", "`runpane panels list` lists tool panels inside one Pane session.", "`runpane panels output` reads bounded recent terminal output from one panel and strips common terminal control noise for agent use.", "`runpane panels input` sends exact input bytes to one terminal panel. Prefer `--input-file` for newlines, Ctrl-C, quotes, or shell-sensitive text.", "`runpane panes create --prompt` is an alias for `--initial-input`; request JSON and daemon payloads should use the canonical `initialInput` field.", "When running from WSL while Pane is installed on Windows, the Linux wrapper may look for a missing `/tmp/pane-daemon.../daemon.sock` or resolve to a Windows shim such as Volta. In that case invoke the Windows wrapper through PowerShell from a Windows cwd, for example `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane repos list --json'`."];
+        readonly commandUsages: readonly ["runpane", "runpane setup", "runpane install", "runpane install client", "runpane install daemon", "runpane update", "runpane version", "runpane doctor", "runpane doctor --json", "runpane agent-context", "runpane agent-context --command \"panes create\" --json", "runpane repos list --json", "runpane repos add --path /path/to/repo --name Pane --yes --json", "runpane panes list --repo active --json", "runpane panes create --repo active --name issue-252 --agent codex --prompt \"Kick off the discussion skill for issue 252\" --yes", "runpane panes create --from-json panes.json --yes --json", "runpane panels list --pane <pane-id> --json", "runpane panels output --panel <panel-id> --limit 200 --json", "printf 'Continue\\n' | runpane panels input --panel <panel-id> --input-file - --yes --json", "runpane help", "runpane <command> --help"];
+        readonly commandDescriptions: readonly ["`runpane` with no arguments and `runpane setup` open an interactive wizard when stdin and stdout are TTYs. In non-interactive shells or CI, both forms must print help, common commands, and agent discovery hints, then exit successfully instead of waiting for input.", "`runpane install` is an alias for `runpane install client`.", "`runpane install client` downloads the selected Pane desktop artifact and installs, opens, or launches it for the current platform.", "`runpane install daemon` downloads or installs Pane, resolves a stable Pane executable path, and spawns `<pane executable> --remote-setup <forwarded remote setup args>`.", "The wrapper must stream Pane stdout/stderr without reformatting because `pane --remote-setup` prints the one-time `pane-remote://...` connection code.", "`runpane update` uses the same release resolution and installer path as `install client`.", "`runpane version` prints the wrapper package version, the installed Pane version when detectable, and the latest GitHub release version when reachable.", "`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, daemon reachability, and remote-daemon hints. Add `--json` for a machine-readable report that agents should run before mutating Pane state.", "`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 repository, creates Pane sessions, opens terminal-backed tool tabs, and optionally sends initial input to the started tool.", "`runpane panels list` lists tool panels inside one Pane session.", "`runpane panels output` reads bounded recent terminal output from one panel and strips common terminal control noise for agent use.", "`runpane panels input` sends exact input bytes to one terminal panel. Prefer `--input-file` for newlines, Ctrl-C, quotes, or shell-sensitive text.", "`runpane panes create --prompt` is an alias for `--initial-input`; request JSON and daemon payloads should use the canonical `initialInput` field.", "When running from WSL while Pane is installed on Windows, the Linux wrapper may look for a missing `/tmp/pane-daemon.../daemon.sock` or resolve to a Windows shim such as Volta. In that case invoke the Windows wrapper through PowerShell from a Windows cwd, for example `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane repos list --json'`."];
         readonly wrapperFlagNote: "The top-level `runpane --version` form prints the wrapper version. The install subcommand form `runpane install --version vX.Y.Z` selects a Pane release.";
-        readonly localControlFlagNote: "`runpane repos list`, `runpane panes list`, `runpane panes create`, and `runpane panels ...` commands use the local framed daemon socket/pipe for a running Pane app. `--pane-dir` points the wrapper at a non-default Pane data directory, such as `PANE_DIR=~/.pane_test` in development. `runpane agent-context` is local/offline and can be used before Pane is running. 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 localControlFlagNote: "`runpane doctor --json`, `runpane repos list`, `runpane panes list`, `runpane panes create`, and `runpane panels ...` commands use or describe the local framed daemon socket/pipe for a running Pane app. `--pane-dir` points the wrapper at a non-default Pane data directory, such as `PANE_DIR=~/.pane_test` in development. `runpane agent-context` is local/offline and can be used before Pane is running. 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.";
         readonly downloadAttribution: readonly ["The npm package uses `source=npm` for all npm-registry consumers, including `npx`, `pnpm dlx`, `yarn dlx`, `bunx`, and global npm/pnpm installs.", "The PyPI package uses `source=pip` for all Python consumers, including pip, pipx, uvx, and `python -m runpane`.", "Wrappers should prefer `https://runpane.com/api/download?platform=<platform>&arch=<arch>&format=<format>&version=<version>&channel=<channel>&source=<npm|pip>`.", "If the website route cannot satisfy the download, wrappers may fall back to the matching GitHub release asset and print a warning that website attribution may be incomplete for that run.", "Wrappers also emit best-effort lifecycle telemetry to `https://runpane.com/api/runpane/telemetry` for command start/success/failure, download request/success/failure, and GitHub fallback usage.", "Wrapper telemetry uses a persisted anonymous `install_id` in the form `install_<uuid>` and PostHog `distinct_id = install:<install_id>` so distinct wrapper users can be counted with `count(DISTINCT properties.install_id)`.", "Wrapper telemetry must be disabled in CI and when `RUNPANE_TELEMETRY_DISABLED` is set, and must not include raw paths, labels, prompts, raw error text, or environment values."];
         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 ["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", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--from-json", "-", "--yes", "--json"], readonly ["panels", "list", "--pane", "session-1", "--json"], readonly ["panels", "output", "--panel", "panel-1", "--limit", "200", "--json"], readonly ["panels", "input", "--panel", "panel-1", "--text", "Continue\\n", "--yes", "--json"], readonly ["--version"]];
-        readonly topLevelHelpIncludes: readonly ["runpane setup", "runpane install", "runpane update", "runpane version", "runpane doctor", "runpane agent-context", "runpane repos list", "runpane repos add", "runpane panes list", "runpane panes create", "runpane panels list", "runpane panels output", "runpane panels input"];
+        readonly parserSamples: readonly [readonly ["setup"], readonly ["install"], readonly ["install", "client", "--version", "v2.2.8", "--format", "dmg", "--download-dir", "/tmp/pane-downloads", "--dry-run", "--yes"], readonly ["install", "daemon", "--label", "VM", "--prefer-tunnel", "ssh", "--channel", "nightly", "--base-url", "https://example.test", "--pane-dir", "/tmp/pane", "--listen-port", "4555", "--auto-listen-port", "--print-only", "--repo-ref", "main", "--unknown-future-flag", "future-value", "--dry-run", "--verbose"], readonly ["update", "--version", "latest", "--format", "appimage", "--pane-path", "/usr/bin/pane", "--dry-run"], readonly ["doctor", "--pane-path", "/usr/bin/pane", "--format", "zip", "--verbose"], readonly ["doctor", "--json", "--pane-dir", "/tmp/pane"], readonly ["agent-context"], readonly ["agent-context", "--command", "panes create", "--json"], readonly ["repos", "list", "--json", "--pane-dir", "/tmp/pane"], readonly ["repos", "add", "--path", "/tmp/repo", "--name", "Repo", "--dry-run", "--yes", "--json", "--pane-dir", "/tmp/pane"], readonly ["panes", "list", "--repo", "active", "--json"], readonly ["panes", "create", "--repo", "active", "--name", "issue-252", "--agent", "codex", "--prompt", "Kick off discussion", "--dry-run", "--yes", "--json"], readonly ["panes", "create", "--from-json", "-", "--yes", "--json"], readonly ["panels", "list", "--pane", "session-1", "--json"], readonly ["panels", "output", "--panel", "panel-1", "--limit", "200", "--json"], readonly ["panels", "input", "--panel", "panel-1", "--text", "Continue\\n", "--yes", "--json"], readonly ["--version"], readonly ["agents", "doctor", "--agent", "codex", "--repo", "active", "--json"], readonly ["panes", "create", "--from-json", "-", "--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 topLevelHelpIncludes: readonly ["runpane setup", "runpane install", "runpane update", "runpane version", "runpane doctor", "runpane agent-context", "runpane repos list", "runpane repos add", "runpane panes list", "runpane panes create", "runpane panels list", "runpane panels output", "runpane panels input", "runpane agents doctor", "runpane panels screen", "runpane panels submit", "runpane panels wait", "runpane doctor --json", "runpane agent-context --json", "Agent discovery:", "Common commands:"];
         readonly npmHelpIncludes: readonly ["pnpm dlx runpane@latest", "npx --yes runpane@latest"];
         readonly pipHelpIncludes: readonly ["pipx run runpane", "python -m pip install runpane && python -m runpane setup"];
         readonly installHelpIncludes: readonly ["--version <latest|vX.Y.Z>", "--format <auto|appimage|deb|dmg|zip|exe>", "--download-dir <path>", "--pane-path <path>", "--label <name>", "--prefer-tunnel <tailscale|ssh|manual|auto>", "--repo-ref <ref>"];
@@ -336,6 +389,130 @@ export declare const RUNPANE_CONTRACT: {
             };
             readonly additionalProperties: false;
         };
+        readonly doctorResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "source", "wrapper", "release", "installedPane", "daemon", "nextCommands"];
+            readonly properties: {
+                readonly ok: {
+                    readonly type: "boolean";
+                };
+                readonly source: {
+                    readonly enum: readonly ["npm", "pip"];
+                };
+                readonly wrapper: {
+                    readonly type: "object";
+                    readonly required: readonly ["runtime", "version", "paneDir", "endpoint"];
+                    readonly properties: {
+                        readonly runtime: {
+                            readonly enum: readonly ["node", "python"];
+                        };
+                        readonly version: {
+                            readonly type: "string";
+                        };
+                        readonly paneDir: {
+                            readonly type: "string";
+                        };
+                        readonly endpoint: {
+                            readonly type: "object";
+                            readonly required: readonly ["transport", "path"];
+                            readonly properties: {
+                                readonly transport: {
+                                    readonly enum: readonly ["pipe", "unix"];
+                                };
+                                readonly path: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly additionalProperties: false;
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+                readonly platform: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly os: {
+                            readonly type: "string";
+                        };
+                        readonly arch: {
+                            readonly type: "string";
+                        };
+                        readonly error: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly additionalProperties: true;
+                };
+                readonly release: {
+                    readonly type: "object";
+                    readonly required: readonly ["ok"];
+                    readonly properties: {
+                        readonly ok: {
+                            readonly type: "boolean";
+                        };
+                        readonly error: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly additionalProperties: true;
+                };
+                readonly installedPane: {
+                    readonly type: "object";
+                    readonly required: readonly ["found"];
+                    readonly properties: {
+                        readonly found: {
+                            readonly type: "boolean";
+                        };
+                        readonly path: {
+                            readonly type: "string";
+                        };
+                        readonly version: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+                readonly daemon: {
+                    readonly type: "object";
+                    readonly required: readonly ["reachable", "endpoint"];
+                    readonly properties: {
+                        readonly reachable: {
+                            readonly type: "boolean";
+                        };
+                        readonly endpoint: {
+                            readonly type: "object";
+                            readonly required: readonly ["transport", "path"];
+                            readonly properties: {
+                                readonly transport: {
+                                    readonly enum: readonly ["pipe", "unix"];
+                                };
+                                readonly path: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly additionalProperties: false;
+                        };
+                        readonly result: {
+                            readonly type: "object";
+                        };
+                        readonly error: {
+                            readonly type: "string";
+                        };
+                        readonly nextCommand: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+                readonly nextCommands: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly additionalProperties: false;
+        };
         readonly repoListResult: {
             readonly type: "object";
             readonly required: readonly ["ok", "repos"];
@@ -519,6 +696,15 @@ export declare const RUNPANE_CONTRACT: {
                 readonly timeoutMs: {
                     readonly type: "number";
                 };
+                readonly waitReady: {
+                    readonly type: "boolean";
+                };
+                readonly readyTimeoutMs: {
+                    readonly type: "number";
+                };
+                readonly concurrency: {
+                    readonly type: "number";
+                };
             };
             readonly additionalProperties: false;
         };
@@ -579,6 +765,75 @@ export declare const RUNPANE_CONTRACT: {
                                     };
                                     readonly additionalProperties: false;
                                 };
+                                readonly readiness: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["ok", "condition", "matched", "timedOut", "elapsedMs", "state"];
+                                    readonly properties: {
+                                        readonly ok: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly condition: {
+                                            readonly enum: readonly ["initialized", "ready", "idle", "text"];
+                                        };
+                                        readonly matched: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly timedOut: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly elapsedMs: {
+                                            readonly type: "number";
+                                        };
+                                        readonly state: {
+                                            readonly type: "object";
+                                            readonly required: readonly ["initialized"];
+                                            readonly properties: {
+                                                readonly initialized: {
+                                                    readonly type: "boolean";
+                                                };
+                                                readonly isAlternateScreen: {
+                                                    readonly type: "boolean";
+                                                };
+                                                readonly activityStatus: {
+                                                    readonly enum: readonly ["active", "idle"];
+                                                };
+                                                readonly isCliReady: {
+                                                    readonly type: "boolean";
+                                                };
+                                                readonly isCliPanel: {
+                                                    readonly type: "boolean";
+                                                };
+                                                readonly agentType: {
+                                                    readonly enum: readonly ["codex", "claude"];
+                                                };
+                                                readonly lastActivity: {
+                                                    readonly type: "string";
+                                                };
+                                            };
+                                            readonly additionalProperties: false;
+                                        };
+                                        readonly blocked: {
+                                            readonly type: "object";
+                                            readonly required: readonly ["kind", "message"];
+                                            readonly properties: {
+                                                readonly kind: {
+                                                    readonly enum: readonly ["codex-update", "agent-prompt", "unknown"];
+                                                };
+                                                readonly message: {
+                                                    readonly type: "string";
+                                                };
+                                                readonly suggestedCommand: {
+                                                    readonly type: "string";
+                                                };
+                                            };
+                                            readonly additionalProperties: false;
+                                        };
+                                        readonly nextCommand: {
+                                            readonly type: "string";
+                                        };
+                                    };
+                                    readonly additionalProperties: false;
+                                };
                             };
                             readonly additionalProperties: false;
                         }, {
@@ -925,17 +1180,275 @@ export declare const RUNPANE_CONTRACT: {
             };
             readonly additionalProperties: false;
         };
+        readonly panelScreenResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "panelId", "source", "limit", "returnedLineCount", "hasMore", "text", "state"];
+            readonly properties: {
+                readonly ok: {
+                    readonly const: true;
+                };
+                readonly panelId: {
+                    readonly type: "string";
+                };
+                readonly paneId: {
+                    readonly type: "string";
+                };
+                readonly source: {
+                    readonly enum: readonly ["alternateScreen", "scrollback", "persistedOutput", "empty"];
+                };
+                readonly limit: {
+                    readonly type: "number";
+                };
+                readonly returnedLineCount: {
+                    readonly type: "number";
+                };
+                readonly hasMore: {
+                    readonly type: "boolean";
+                };
+                readonly text: {
+                    readonly type: "string";
+                };
+                readonly state: {
+                    readonly type: "object";
+                    readonly required: readonly ["initialized"];
+                    readonly properties: {
+                        readonly initialized: {
+                            readonly type: "boolean";
+                        };
+                        readonly isAlternateScreen: {
+                            readonly type: "boolean";
+                        };
+                        readonly activityStatus: {
+                            readonly enum: readonly ["active", "idle"];
+                        };
+                        readonly isCliReady: {
+                            readonly type: "boolean";
+                        };
+                        readonly isCliPanel: {
+                            readonly type: "boolean";
+                        };
+                        readonly agentType: {
+                            readonly enum: readonly ["codex", "claude"];
+                        };
+                        readonly lastActivity: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+                readonly nextCommand: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly panelSubmitRequest: {
+            readonly type: "object";
+            readonly required: readonly ["panelId", "input"];
+            readonly properties: {
+                readonly panelId: {
+                    readonly type: "string";
+                };
+                readonly input: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly panelSubmitResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "panelId", "inputBytes", "enter", "sentAt"];
+            readonly properties: {
+                readonly ok: {
+                    readonly const: true;
+                };
+                readonly panelId: {
+                    readonly type: "string";
+                };
+                readonly paneId: {
+                    readonly type: "string";
+                };
+                readonly inputBytes: {
+                    readonly type: "number";
+                };
+                readonly enter: {
+                    readonly const: "cr";
+                };
+                readonly sentAt: {
+                    readonly type: "string";
+                };
+                readonly nextCommand: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly panelWaitResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "panelId", "condition", "matched", "timedOut", "elapsedMs", "state", "screen"];
+            readonly properties: {
+                readonly ok: {
+                    readonly type: "boolean";
+                };
+                readonly panelId: {
+                    readonly type: "string";
+                };
+                readonly paneId: {
+                    readonly type: "string";
+                };
+                readonly condition: {
+                    readonly enum: readonly ["initialized", "ready", "idle", "text"];
+                };
+                readonly matched: {
+                    readonly type: "boolean";
+                };
+                readonly timedOut: {
+                    readonly type: "boolean";
+                };
+                readonly elapsedMs: {
+                    readonly type: "number";
+                };
+                readonly state: {
+                    readonly type: "object";
+                    readonly required: readonly ["initialized"];
+                    readonly properties: {
+                        readonly initialized: {
+                            readonly type: "boolean";
+                        };
+                        readonly isAlternateScreen: {
+                            readonly type: "boolean";
+                        };
+                        readonly activityStatus: {
+                            readonly enum: readonly ["active", "idle"];
+                        };
+                        readonly isCliReady: {
+                            readonly type: "boolean";
+                        };
+                        readonly isCliPanel: {
+                            readonly type: "boolean";
+                        };
+                        readonly agentType: {
+                            readonly enum: readonly ["codex", "claude"];
+                        };
+                        readonly lastActivity: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+                readonly blocked: {
+                    readonly type: "object";
+                    readonly required: readonly ["kind", "message"];
+                    readonly properties: {
+                        readonly kind: {
+                            readonly enum: readonly ["codex-update", "agent-prompt", "unknown"];
+                        };
+                        readonly message: {
+                            readonly type: "string";
+                        };
+                        readonly suggestedCommand: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+                readonly screen: {
+                    readonly type: "object";
+                    readonly required: readonly ["source", "text", "hasMore"];
+                    readonly properties: {
+                        readonly source: {
+                            readonly enum: readonly ["alternateScreen", "scrollback", "persistedOutput", "empty"];
+                        };
+                        readonly text: {
+                            readonly type: "string";
+                        };
+                        readonly hasMore: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+                readonly nextCommand: {
+                    readonly type: "string";
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly agentDoctorResult: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "agent", "command", "available", "checks"];
+            readonly properties: {
+                readonly ok: {
+                    readonly type: "boolean";
+                };
+                readonly agent: {
+                    readonly enum: readonly ["codex", "claude"];
+                };
+                readonly command: {
+                    readonly type: "string";
+                };
+                readonly repo: {
+                    readonly $ref: "#/jsonSchemas/repoListResult/properties/repos/items";
+                };
+                readonly environment: {
+                    readonly enum: readonly ["wsl", "windows", "linux", "macos"];
+                };
+                readonly available: {
+                    readonly type: "boolean";
+                };
+                readonly executablePath: {
+                    readonly type: "string";
+                };
+                readonly version: {
+                    readonly type: "string";
+                };
+                readonly checks: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["name", "ok", "message"];
+                        readonly properties: {
+                            readonly name: {
+                                readonly type: "string";
+                            };
+                            readonly ok: {
+                                readonly type: "boolean";
+                            };
+                            readonly message: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                };
+                readonly warnings: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly additionalProperties: false;
+        };
     };
     readonly agentContext: {
         readonly brief: {
             readonly title: "Pane agent context";
-            readonly summary: "Pane lets a developer manage repositories and user-visible panes. Agents can use runpane to list/add Pane repositories and create panes with terminal-backed tools.";
-            readonly rules: readonly ["Start with `runpane repos list --json` to find the saved repository when unsure.", "If WSL cannot reach Pane or `runpane` resolves to a broken Windows shim, the user may be running Windows Pane; try `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane repos list --json'`.", "If the repository exists on disk but is not saved in Pane, use `runpane repos add --path <repo> --yes --json` before creating panes.", "Use `runpane panes create` to create a Pane session and open a built-in agent or custom terminal command.", "Use `runpane panels list`, `runpane panels output`, and `runpane panels input` when you need to inspect or drive an existing Pane terminal.", "After creating panes or sending terminal input, validate with bounded panel output before reporting success.", "Prefer `--input-file` for terminal input that includes Enter, Ctrl-C, quotes, or multiple lines.", "Use `runpane agent-context --command <command>` for detailed command definitions only when needed."];
+            readonly summary: "Pane lets a developer manage repositories and user-visible terminal panes. Agents can use runpane to create panes, inspect compact terminal state, wait for readiness, and submit interactive input.";
+            readonly rules: readonly ["Start with `runpane doctor --json` to understand wrapper, platform, daemon reachability, and the next safe commands before mutating Pane state.", "Use `runpane agent-context --json` for the full agent-facing CLI context, or `runpane agent-context --command <command> --json` for one detailed command definition.", "Use `runpane repos list --json` to find the saved repository when unsure after doctor shows the daemon is reachable.", "If WSL cannot reach Pane or `runpane` resolves to a broken Windows shim, the user may be running Windows Pane; try `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane doctor --json'`.", "If the repository exists on disk but is not saved in Pane, use `runpane repos add --path <repo> --yes --json` before creating panes.", "Use `runpane agents doctor --agent <codex|claude> --repo <selector> --json` when agent availability differs across host, Windows, WSL, or repo environments.", "Use `runpane panes create --wait-ready` to create panes and validate initial terminal readiness in one call.", "Use `runpane panels screen` for compact current state, `panels wait` for readiness/text checks, and `panels submit` for ordinary Enter-submitted input.", "Use `runpane panels input` only when exact bytes are required, such as Ctrl-C or handcrafted terminal input.", "After creating panes or sending terminal input, validate with `panels wait` or bounded `panels screen` before reporting success."];
             readonly detailCommand: "runpane agent-context --command <command> [--json]";
             readonly tools: readonly [{
+                readonly name: "doctor";
+                readonly summary: "Report wrapper, platform, installed Pane, and daemon reachability before an agent mutates Pane state.";
+                readonly arguments: readonly ["--json", "--pane-dir <path>", "--pane-path <path>"];
+            }, {
                 readonly name: "agent-context";
                 readonly summary: "Print token-efficient Pane command context for coding agents.";
                 readonly arguments: readonly ["--command <command>", "--json"];
+            }, {
+                readonly name: "agents doctor";
+                readonly summary: "Check whether Codex or Claude is available in the repo environment Pane will use.";
+                readonly arguments: readonly ["--agent <codex|claude>", "--repo <selector>", "--json"];
             }, {
                 readonly name: "repos list";
                 readonly summary: "List repositories saved in the running Pane app.";
@@ -951,7 +1464,7 @@ export declare const RUNPANE_CONTRACT: {
             }, {
                 readonly name: "panes create";
                 readonly summary: "Create one or more Pane sessions in a saved repository and open a terminal-backed tool tab.";
-                readonly arguments: readonly ["--repo <selector>", "--name <name>", "--agent <codex|claude>", "--tool-command <command>", "--prompt <text>", "--initial-input-file <path|->", "--from-json <path|->", "--yes", "--json"];
+                readonly arguments: readonly ["--repo <selector>", "--name <name>", "--agent <codex|claude>", "--tool-command <command>", "--prompt <text>", "--initial-input-file <path|->", "--from-json <path|->", "--wait-ready", "--ready-timeout-ms <ms>", "--concurrency <count>", "--yes", "--json"];
             }, {
                 readonly name: "panels list";
                 readonly summary: "List tool panels inside a Pane session.";
@@ -960,10 +1473,22 @@ export declare const RUNPANE_CONTRACT: {
                 readonly name: "panels output";
                 readonly summary: "Read recent terminal output from a panel.";
                 readonly arguments: readonly ["--panel <panel-id>", "--limit <count>", "--json", "--pane-dir <path>"];
+            }, {
+                readonly name: "panels screen";
+                readonly summary: "Read a compact current-screen view from a terminal panel.";
+                readonly arguments: readonly ["--panel <panel-id>", "--limit <count>", "--json", "--pane-dir <path>"];
             }, {
                 readonly name: "panels input";
                 readonly summary: "Send input bytes to a terminal panel.";
                 readonly arguments: readonly ["--panel <panel-id>", "--text <text>", "--input-file <path|->", "--yes", "--json", "--pane-dir <path>"];
+            }, {
+                readonly name: "panels submit";
+                readonly summary: "Send text plus terminal Enter to a terminal panel.";
+                readonly arguments: readonly ["--panel <panel-id>", "--text <text>", "--input-file <path|->", "--yes", "--json", "--pane-dir <path>"];
+            }, {
+                readonly name: "panels wait";
+                readonly summary: "Wait for terminal initialized, ready, idle, or text state with compact output.";
+                readonly arguments: readonly ["--panel <panel-id>", "--for <condition>", "--contains <text>", "--timeout-ms <ms>", "--interval-ms <ms>", "--json", "--pane-dir <path>"];
             }];
         };
         readonly commands: {
@@ -1062,22 +1587,37 @@ export declare const RUNPANE_CONTRACT: {
             };
             readonly doctor: {
                 readonly name: "doctor";
-                readonly summary: "Run platform, release, installed Pane, and remote setup diagnostics.";
-                readonly details: "Use this when runpane install/update behavior needs environment diagnostics.";
+                readonly summary: "Run platform, release, installed Pane, daemon reachability, and remote setup diagnostics.";
+                readonly details: "Use this first when an agent needs to understand whether Pane is installed, which wrapper/runtime is running, what daemon endpoint is expected, and whether the running Pane app is reachable. JSON mode should return a report even when the daemon is unreachable.";
                 readonly requiresPaneDaemon: false;
                 readonly mutates: false;
                 readonly arguments: readonly [{
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print a machine-readable environment report.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }, {
                     readonly name: "--pane-path";
                     readonly value: "<path>";
                     readonly required: false;
-                    readonly description: "Use an existing Pane executable for diagnostics.";
+                    readonly description: "Inspect a specific Pane executable.";
+                }, {
+                    readonly name: "--format";
+                    readonly value: "<format>";
+                    readonly required: false;
+                    readonly description: "Release artifact format to inspect.";
                 }, {
                     readonly name: "--verbose";
                     readonly required: false;
                     readonly description: "Print extra diagnostics.";
                 }];
-                readonly examples: readonly ["runpane doctor", "runpane doctor --verbose"];
-                readonly notes: readonly [];
+                readonly examples: readonly ["runpane doctor --json", "runpane doctor"];
+                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."];
             };
             readonly "agent-context": {
                 readonly name: "agent-context";
@@ -1231,10 +1771,24 @@ export declare const RUNPANE_CONTRACT: {
                     readonly name: "--json";
                     readonly required: false;
                     readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--wait-ready";
+                    readonly required: false;
+                    readonly description: "Wait for each created terminal panel to be ready before returning.";
+                }, {
+                    readonly name: "--ready-timeout-ms";
+                    readonly value: "<ms>";
+                    readonly required: false;
+                    readonly description: "Readiness timeout per pane; defaults to 30000.";
+                }, {
+                    readonly name: "--concurrency";
+                    readonly value: "<count>";
+                    readonly required: false;
+                    readonly description: "Accepted for compatibility. Pane currently serializes multi-pane session creation so queued jobs do not time out before starting.";
                 }];
-                readonly examples: readonly ["runpane panes create --repo active --name issue-257 --agent codex --prompt \"Plan this issue\" --yes", "runpane panes create --from-json panes.json --yes --json"];
+                readonly examples: readonly ["runpane panes create --repo active --name issue-257 --agent codex --prompt \"Plan this issue\" --yes", "runpane panes create --from-json panes.json --yes --json", "runpane panes create --repo active --name issue-123 --agent codex --prompt \"Plan this issue\" --wait-ready --yes --json"];
                 readonly jsonSchemas: readonly ["paneCreateRequest", "paneCreateResult"];
-                readonly notes: readonly ["At least one of --agent or --tool-command is required unless --from-json is used.", "The built-in agent templates come from the runpane contract; custom terminal commands can pass agent-specific flags when requested by the user.", "Use --initial-input-file for multi-line prompts or shell-sensitive initial input.", "When the JSON result includes nextCommand, run it to validate that the terminal produced output before reporting success.", "For POSIX or WSL command chaining, use a custom terminal command like `bash -lc 'cmd1 && cmd2 && cmd3'`.", "For Windows PowerShell command chaining, use a custom terminal command like `powershell -NoProfile -Command \"cmd1; if ($LASTEXITCODE) { exit $LASTEXITCODE }; cmd2\"`.", "From WSL with Windows Pane, invoke through PowerShell and select the saved WSL repo by name or id, for example `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane panes create --repo \"WSL Pane\" --name issue-123 --agent codex --prompt \"Plan this issue\" --yes --json'`."];
+                readonly notes: readonly ["At least one of --agent or --tool-command is required unless --from-json is used.", "The built-in agent templates come from the runpane contract; custom terminal commands can pass agent-specific flags when requested by the user.", "Use --initial-input-file for multi-line prompts or shell-sensitive initial input.", "When the JSON result includes nextCommand, run it to validate that the terminal produced output before reporting success.", "Multi-pane requests are created sequentially today. The --concurrency flag is accepted for compatibility, but agents should not rely on parallel creation.", "For POSIX or WSL command chaining, use a custom terminal command like `bash -lc 'cmd1 && cmd2 && cmd3'`.", "For Windows PowerShell command chaining, use a custom terminal command like `powershell -NoProfile -Command \"cmd1; if ($LASTEXITCODE) { exit $LASTEXITCODE }; cmd2\"`.", "From WSL with Windows Pane, invoke through PowerShell and select the saved WSL repo by name or id, for example `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane panes create --repo \"WSL Pane\" --name issue-123 --agent codex --prompt \"Plan this issue\" --yes --json'`.", "Use --wait-ready when an agent needs to verify that an agent terminal started instead of only creating a pane.", "If readiness returns blocked, inspect blocked.suggestedCommand rather than guessing which prompt to answer."];
             };
             readonly "panels list": {
                 readonly name: "panels list";
@@ -1289,7 +1843,7 @@ export declare const RUNPANE_CONTRACT: {
                 }];
                 readonly examples: readonly ["runpane panels output --panel <panel-id> --limit 200 --json"];
                 readonly jsonSchemas: readonly ["panelOutputResult"];
-                readonly notes: readonly ["Default output is bounded to the latest 200 lines or records. Use a larger --limit only when hasMore is true and more history is needed.", "Use --json when an agent needs timestamps, record types, returnedCount, or hasMore.", "The output is intended to be agent-readable, but terminal prompts and shell echoes may still appear; use the newest relevant lines before concluding success."];
+                readonly notes: readonly ["Default output is bounded to the latest 200 lines or records. Use a larger --limit only when hasMore is true and more history is needed.", "Use --json when an agent needs timestamps, record types, returnedCount, or hasMore.", "The output is intended to be agent-readable, but terminal prompts and shell echoes may still appear; use the newest relevant lines before concluding success.", "Prefer `panels screen` for a smaller current-state read before increasing output limits."];
             };
             readonly "panels input": {
                 readonly name: "panels input";
@@ -1328,10 +1882,154 @@ export declare const RUNPANE_CONTRACT: {
                 }];
                 readonly examples: readonly ["printf 'Continue\\n' | runpane panels input --panel <panel-id> --input-file - --yes", "printf '\\003' | runpane panels input --panel <panel-id> --input-file - --yes", "runpane panels input --panel <panel-id> --text \"simple text\" --yes --json"];
                 readonly jsonSchemas: readonly ["panelInputRequest", "panelInputResult"];
-                readonly notes: readonly ["Input is sent exactly as provided. Include a real newline byte when the terminal should receive Enter; across shells, `--input-file` is safer than `--text \"...\\n\"`.", "Use `--input-file -` or a temp file for multi-line input, quotes, Ctrl-C, or shell-sensitive text.", "If interrupting a running process, send Ctrl-C first, validate/read output, then send the next command in a separate `panels input` call so bytes are not dropped.", "After sending input, validate with `runpane panels output --panel <panel-id> --json` before reporting success.", "Runpane records action metadata and errors for observability, but should not log full input text by default."];
+                readonly notes: readonly ["Input is sent exactly as provided. Include a real newline byte when the terminal should receive Enter; across shells, `--input-file` is safer than `--text \"...\\n\"`.", "Use `--input-file -` or a temp file for multi-line input, quotes, Ctrl-C, or shell-sensitive text.", "If interrupting a running process, send Ctrl-C first, validate/read output, then send the next command in a separate `panels input` call so bytes are not dropped.", "After sending input, validate with `runpane panels output --panel <panel-id> --json` before reporting success.", "Runpane records action metadata and errors for observability, but should not log full input text by default.", "For ordinary text plus Enter, prefer `panels submit` so the terminal receives a CR Enter byte."];
+            };
+            readonly "agents doctor": {
+                readonly name: "agents doctor";
+                readonly summary: "Diagnose whether a built-in agent command is available in a Pane repository environment.";
+                readonly details: "Use this before creating Codex or Claude panes when PATH may differ between macOS/Linux/Windows/WSL or between the wrapper shell and Pane. The check runs through Pane project context, not the wrapper process.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--agent";
+                    readonly value: "<codex|claude>";
+                    readonly required: true;
+                    readonly description: "Built-in agent command to diagnose.";
+                }, {
+                    readonly name: "--repo";
+                    readonly value: "<selector>";
+                    readonly required: false;
+                    readonly description: "Repository selector; defaults to the active Pane repo.";
+                }, {
+                    readonly name: "--json";
+                    readonly required: false;
+                    readonly description: "Print machine-readable output.";
+                }, {
+                    readonly name: "--pane-dir";
+                    readonly value: "<path>";
+                    readonly required: false;
+                    readonly description: "Connect to a specific Pane data directory.";
+                }];
+                readonly examples: readonly ["runpane agents doctor --agent codex --repo active --json"];
+                readonly jsonSchemas: readonly ["agentDoctorResult"];
+                readonly notes: readonly ["For WSL repos, install the agent inside the WSL distro Pane uses, not only on Windows.", "This diagnoses built-in Codex/Claude templates only; custom commands should be validated by creating a pane and reading its screen."];
+            };
+            readonly "panels screen": {
+                readonly name: "panels screen";
+                readonly summary: "Read a compact current-screen view from a terminal panel.";
+                readonly details: "Use this for token-safe current terminal state. It prefers active alternate-screen/TUI output, then live scrollback, then persisted output. Default output is bounded to 80 lines.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--panel";
+                    readonly value: "<panel-id>";
+                    readonly required: true;
+                    readonly description: "Terminal panel id.";
+                }, {
+                    readonly name: "--limit";
+                    readonly value: "<count>";
+                    readonly required: false;
+                    readonly description: "Maximum lines to return; defaults to 80.";
+                }, {
+                    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 panels screen --panel <panel-id> --limit 80 --json"];
+                readonly jsonSchemas: readonly ["panelScreenResult"];
+                readonly notes: readonly ["Use this before `panels output` when an agent only needs the latest visible/current state.", "If hasMore is true and context is missing, rerun with a larger --limit or use `panels output`."];
+            };
+            readonly "panels submit": {
+                readonly name: "panels submit";
+                readonly summary: "Send text to a terminal panel and append a terminal Enter byte.";
+                readonly details: "Use this for ordinary interactive submissions. The daemon normalizes a final LF or CRLF to CR, or appends CR if no newline is present. Exact byte workflows remain on `panels input`.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: true;
+                readonly arguments: readonly [{
+                    readonly name: "--panel";
+                    readonly value: "<panel-id>";
+                    readonly required: true;
+                    readonly description: "Terminal panel id.";
+                }, {
+                    readonly name: "--text";
+                    readonly value: "<text>";
+                    readonly required: false;
+                    readonly description: "Text to submit before Enter.";
+                }, {
+                    readonly name: "--input-file";
+                    readonly value: "<path|->";
+                    readonly required: false;
+                    readonly description: "Read text from a file or stdin before Enter.";
+                }, {
+                    readonly name: "--yes";
+                    readonly required: false;
+                    readonly description: "Skip confirmation for this mutating command.";
+                }, {
+                    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 panels submit --panel <panel-id> --text \"2\" --yes --json", "printf \"echo hello\" | runpane panels submit --panel <panel-id> --input-file - --yes --json"];
+                readonly jsonSchemas: readonly ["panelSubmitRequest", "panelSubmitResult"];
+                readonly notes: readonly ["The response includes nextCommand for validation. Run it before reporting that the input worked.", "Use `panels input` for Ctrl-C, escape sequences, or any workflow requiring exact bytes."];
+            };
+            readonly "panels wait": {
+                readonly name: "panels wait";
+                readonly summary: "Wait for a terminal panel to initialize, become ready/idle, or contain text.";
+                readonly details: "Use this to validate asynchronous terminal behavior without pulling large scrollback. It returns brief readiness state, blocker hints, a compact screen, and a next command.";
+                readonly requiresPaneDaemon: true;
+                readonly mutates: false;
+                readonly arguments: readonly [{
+                    readonly name: "--panel";
+                    readonly value: "<panel-id>";
+                    readonly required: true;
+                    readonly description: "Terminal panel id.";
+                }, {
+                    readonly name: "--for";
+                    readonly value: "<initialized|ready|idle|text>";
+                    readonly required: false;
+                    readonly description: "Condition to wait for. Defaults to ready for CLI panels and idle otherwise.";
+                }, {
+                    readonly name: "--contains";
+                    readonly value: "<text>";
+                    readonly required: false;
+                    readonly description: "Text required for --for text; implies --for text when --for is omitted.";
+                }, {
+                    readonly name: "--timeout-ms";
+                    readonly value: "<ms>";
+                    readonly required: false;
+                    readonly description: "Wait timeout; defaults to 30000.";
+                }, {
+                    readonly name: "--interval-ms";
+                    readonly value: "<ms>";
+                    readonly required: false;
+                    readonly description: "Polling interval; defaults to 500.";
+                }, {
+                    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 panels wait --panel <panel-id> --for ready --timeout-ms 30000 --json", "runpane panels wait --panel <panel-id> --contains \"Ready\" --json"];
+                readonly jsonSchemas: readonly ["panelWaitResult"];
+                readonly notes: readonly ["If blocked is present, do not assume success. Use blocked.suggestedCommand or inspect `panels screen`.", "The default timeout and screen are intentionally small for agent context safety."];
             };
         };
-        readonly managedBlock: readonly ["## Pane", "", "The developer is using Pane for this repository. Pane can manage saved repositories and create user-visible panes with terminal-backed tools for planning, discussion, and implementation work.", "", "Use `runpane agent-context` for a brief Pane command schema. Use `runpane agent-context --command \"panes create\"` or another command name for the detailed schema only when needed.", "", "After creating panes or sending terminal input, validate with bounded panel output before reporting success. Prefer `--input-file` for exact terminal bytes, newlines, Ctrl-C, quotes, or multi-line input.", "", "Common commands:", "- `runpane repos list --json`", "- `runpane repos add --path <repo> --yes --json`", "- `runpane panes create --repo active --name <name> --agent codex --prompt \"<task>\" --yes`", "- `runpane panels list --pane <pane-id> --json`", "- `runpane panels output --panel <panel-id> --limit 200 --json`", "- `runpane panels input --panel <panel-id> --input-file <path|-> --yes`", "", "WSL note: if `runpane repos list` 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 repos list --json'`, then create panes through the same PowerShell form using the saved WSL repo name or id."];
+        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.", "", "Start with `runpane doctor --json` before taking Pane actions. Use it to understand wrapper/runtime details, daemon reachability, and the next safe commands.", "", "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.", "", "Common commands:", "- `runpane doctor --json`", "- `runpane agent-context --json`", "- `runpane repos list --json`", "- `runpane repos add --path <repo> --yes --json`", "- `runpane agents doctor --agent codex --repo active --json`", "- `runpane panes create --repo active --name <name> --agent codex --prompt \"<task>\" --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 codex --repo <selector> --json` to diagnose the repo environment Pane will actually use."];
     };
 };
 export type RunpaneCommand = typeof RUNPANE_CONTRACT.commands[number]['name'];