runpane 2.3.7 → 2.3.8

package/dist/generated/contract.d.ts

@@ -70,6 +70,11 @@ export declare const RUNPANE_CONTRACT: {
         readonly name: "doctor";
         readonly summary: "Run platform, release, installed Pane, and remote setup diagnostics.";
         readonly usage: readonly ["runpane doctor"];
+    }, {
+        readonly name: "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 +112,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 +260,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,11 +296,14 @@ 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", "", "Run \"runpane agent-context\" when an agent needs Pane command context.", "Run \"runpane help panes create\" for pane orchestration options."];
             readonly install: readonly ["Usage:", "  runpane install [client|daemon] [options]", "", "Examples:", "  npx --yes runpane@latest install client", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest install daemon --prefer-tunnel ssh --label \"VM\"", "", "Wrapper options:", "  --version <latest|vX.Y.Z>        Pane release to install", "  --format <auto|appimage|deb|dmg|zip|exe>", "  --download-dir <path>", "  --pane-path <path>               Use an existing Pane executable", "  --dry-run                       Print the plan without downloading", "  --yes                           Skip interactive prompts where possible", "  --verbose", "", "Daemon passthrough options:", "  --label <name>", "  --prefer-tunnel <tailscale|ssh|manual|auto>", "  --channel <stable|nightly>", "  --base-url <url>", "  --pane-dir <path>", "  --listen-port <port> / --port <port>", "  --auto-listen-port", "  --interactive-tailscale-setup", "  --no-install-service", "  --no-tailscale-serve", "  --print-only", "  --repo-ref <ref>"];
             readonly setup: readonly ["Usage:", "  runpane setup", "", "Opens the guided setup for desktop install, remote host setup, update, and diagnostics.", "", "Quick start:", "  npx --yes runpane@latest", "  npm i -g runpane && runpane setup"];
             readonly update: readonly ["Usage:", "  runpane update [options]", "", "Updates Pane using the same artifact selection as \"runpane install client\".", "", "Options:", "  --version <latest|vX.Y.Z>", "  --format <auto|appimage|deb|dmg|zip|exe>", "  --download-dir <path>", "  --pane-path <path>", "  --dry-run", "  --yes", "  --verbose"];
@@ -268,14 +312,18 @@ export declare const RUNPANE_CONTRACT: {
             readonly "repos list": readonly ["Usage:", "  runpane repos list [--json] [--pane-dir <path>]", "", "Lists repositories saved in the running Pane app.", "", "Options:", "  --json                         Print machine-readable output", "  --pane-dir <path>              Connect to a specific Pane data directory"];
             readonly "repos add": readonly ["Usage:", "  runpane repos add --path <path> [--name <name>] [--json] [--yes]", "", "Registers an existing git repository with the running Pane app.", "", "Options:", "  --path <path>                  Existing git repository path", "  --name <name>                  Saved repository name; defaults to the directory name", "  --pane-dir <path>              Connect to a specific Pane data directory", "  --json                         Print machine-readable output", "  --dry-run                      Validate and preview without adding the repo", "  --yes                          Skip confirmation for mutating commands"];
             readonly "panes 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", "", "Run \"runpane agent-context\" when an agent needs Pane command context.", "Run \"runpane help panes create\" for pane orchestration options."];
             readonly install: readonly ["Usage:", "  runpane install [client|daemon] [options]", "", "Examples:", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest install daemon --prefer-tunnel ssh --label \"VM\"", "  pipx run runpane install daemon --label \"My Server\"", "", "Wrapper options:", "  --version <latest|vX.Y.Z>", "  --format <auto|appimage|deb|dmg|zip|exe>", "  --download-dir <path>", "  --pane-path <path>", "  --dry-run", "  --yes", "  --verbose", "", "Daemon passthrough options:", "  --label <name>", "  --prefer-tunnel <tailscale|ssh|manual|auto>", "  --channel <stable|nightly>", "  --base-url <url>", "  --pane-dir <path>", "  --listen-port <port> / --port <port>", "  --auto-listen-port", "  --interactive-tailscale-setup", "  --no-install-service", "  --no-tailscale-serve", "  --print-only", "  --repo-ref <ref>"];
             readonly setup: readonly ["Usage:", "  runpane setup", "", "Opens the guided setup for desktop install, remote host setup, update, and diagnostics.", "", "Quick start:", "  pipx run runpane", "  python -m pip install runpane && python -m runpane setup"];
             readonly update: readonly ["Usage:", "  runpane update [--version <latest|vX.Y.Z>] [--dry-run] [--yes]"];
@@ -284,11 +332,15 @@ export declare const RUNPANE_CONTRACT: {
             readonly "repos list": readonly ["Usage:", "  runpane repos list [--json] [--pane-dir <path>]", "", "Lists repositories saved in the running Pane app.", "", "Options:", "  --json", "  --pane-dir <path>"];
             readonly "repos add": readonly ["Usage:", "  runpane repos add --path <path> [--name <name>] [--json] [--yes]", "", "Registers an existing git repository with the running Pane app.", "", "Options:", "  --path <path>", "  --name <name>", "  --pane-dir <path>", "  --json", "  --dry-run", "  --yes"];
             readonly "panes 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: {
@@ -306,8 +358,8 @@ export declare const RUNPANE_CONTRACT: {
         readonly publishingCredentials: readonly ["Local implementation, build, and dry-run validation do not need npm or PyPI API tokens.", "Release publishing should prefer npm Trusted Publishing and PyPI Trusted Publishing from GitHub Actions.", "Fallback `NPM_TOKEN` or `PYPI_API_TOKEN` credentials may be used for first package reservation or manual publication only. They must be supplied through local environment variables or GitHub Actions secrets, never committed, and revoked or rotated after use."];
     };
     readonly testFixtures: {
-        readonly parserSamples: readonly [readonly ["setup"], readonly ["install"], readonly ["install", "client", "--version", "v2.2.8", "--format", "dmg", "--download-dir", "/tmp/pane-downloads", "--dry-run", "--yes"], readonly ["install", "daemon", "--label", "VM", "--prefer-tunnel", "ssh", "--channel", "nightly", "--base-url", "https://example.test", "--pane-dir", "/tmp/pane", "--listen-port", "4555", "--auto-listen-port", "--print-only", "--repo-ref", "main", "--unknown-future-flag", "future-value", "--dry-run", "--verbose"], readonly ["update", "--version", "latest", "--format", "appimage", "--pane-path", "/usr/bin/pane", "--dry-run"], readonly ["doctor", "--pane-path", "/usr/bin/pane", "--format", "zip", "--verbose"], readonly ["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 ["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"];
         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>"];
@@ -519,6 +571,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 +640,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 +1055,271 @@ 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 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 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.", "Use `runpane agent-context --command <command>` for detailed command definitions only when needed."];
             readonly detailCommand: "runpane agent-context --command <command> [--json]";
             readonly tools: readonly [{
                 readonly name: "agent-context";
                 readonly summary: "Print token-efficient Pane command context for coding agents.";
                 readonly arguments: readonly ["--command <command>", "--json"];
+            }, {
+                readonly name: "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 +1335,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 +1344,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: {
@@ -1231,10 +1627,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 +1699,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 +1738,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.", "", "Use `runpane agent-context` for a brief Pane command schema. Use `runpane agent-context --command \"panels wait\"` 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 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 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. 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'];