runpane 2.4.152 → 2.4.154

package/dist/generated/contract.d.ts

@@ -1107,7 +1107,7 @@ export declare const RUNPANE_CONTRACT: {
             readonly "panels submit": readonly ["Usage:", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) [--as-file-pointer] --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.", "", "For a Claude or Codex panel with no composer on screen, nothing is sent: the result is ok: false with blocked.kind composer-unknown.", "", "Multi-line or long (over 512 characters) text reaches a Claude or Codex composer as one bracketed paste: CRLF becomes LF, and the submit key goes as its own write once the paste has settled, even while the agent is working.", "", "For Claude, text starting with `!`, `#`, `/` or `@` is sent unchanged and the result carries a `warnings` entry (for example `leading-bang-runs-shell`), because Claude Code gives those characters a meaning of its own.", "", "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", "  --as-file-pointer              Write the text to a prompt file and submit `Read and follow <path>`", "  --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 "panels create": readonly ["Create a terminal-backed tool panel inside an existing Pane session.", "", "Usage:", "  runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--title <title>] [--initial-input <text>] [--no-focus] [--wait-ready] --yes [--json]", "  runpane panels create --pane <pane-id> --tool-command <command> [--agent <codex|claude|cursor>] [--title <title>] [--no-focus] [--wait-ready] --yes [--json]", "", "Options:", "  --pane <pane-id>              Existing Pane session to add the panel to.", "  --agent <codex|claude|cursor> Built-in agent command template, or with --tool-command the agent it runs.", "  --tool-command <command>      Custom terminal command to launch.", "  --title <title>               Panel title override.", "  --initial-input, --prompt     Initial input to send after the tool starts.", "  --initial-input-file <path|-> Read initial input from a file or stdin.", "  --as-file-pointer             Send `Read and follow <prompt file>` instead of the prompt.", "  --no-focus                    Create the panel in the background.", "  --focus                       Explicitly focus the created panel.", "  --source <user|agent>         Mark the mutation source; agent implies background creation.", "  --wait-ready                  Wait until the terminal tool is ready.", "  --ready-timeout-ms <ms>       Readiness wait timeout.", "  --yes                         Skip confirmation prompts.", "  --json                        Print JSON output."];
-            readonly "panels open": readonly ["Open a URL or file as a browser/editor tab in a Pane, in split view beside the agent by default.", "", "Usage:", "  runpane panels open [--pane <pane-id>] (--url <url>|--file <path>) [--title <title>] [--split|--tab] [--focus|--no-focus] [--source user|agent] --yes [--json]", "", "Opens a tab inside a Pane (default: the Pane of the calling panel, from PANE_SESSION_ID). Use it to show the user an HTML page, plan, report, local dev server, or file beside the conversation. --url opens a browser tab (http, https, or file). --file opens a file inside the Pane worktree: .html/.htm files render in a browser tab, other files open in an editor tab. Tabs open in split view beside the agent by default; --tab keeps them in the current group. An existing tab showing the same URL or file is reused. Never raises or focuses the Pane window.", "", "Options:", "  --pane <pane-id>              Pane to open the tab in; defaults to PANE_SESSION_ID.", "  --url <url>                   http(s) or file URL to open in a browser tab.", "  --file <path>                 File inside the Pane worktree (relative or absolute).", "  --title <title>               Tab title override.", "  --split                       Open in split view beside the agent (default).", "  --tab                         Open in the current tab group instead.", "  --no-focus                    Open without selecting the tab.", "  --focus                       Select the tab (default); never raises the window.", "  --source <user|agent>         Mutation source.", "  --pane-dir <path>             Connect to a specific Pane data directory.", "  --yes                         Skip confirmation prompts.", "  --json                        Print JSON output."];
+            readonly "panels open": readonly ["Open a URL or file as a browser/editor tab in a Pane, in split view beside the agent by default.", "", "Usage:", "  runpane panels open [--pane <pane-id>] (--url <url>|--file <path>) [--title <title>] [--split|--tab] [--focus|--no-focus] [--source user|agent] --yes [--json]", "", "Opens a tab inside a Pane (default: the Pane of the calling panel, from PANE_SESSION_ID). Use it to show the user an HTML page, plan, report, local dev server, or file beside the conversation. --url opens a browser tab (http, https, or file). --file opens a file inside the Pane worktree: .html/.htm files render in a browser tab, other files open in an editor tab. Tabs open in split view beside the agent by default; --tab keeps them in the current group. An existing tab showing the same URL or file is reused. Never raises or focuses the Pane window.", "", "Options:", "  --pane <pane-id>              Pane to open the tab in; defaults to PANE_SESSION_ID.", "  --url <url>                   http(s) or file URL to open in a browser tab.", "  --file <path>                 File inside the Pane worktree (relative, Linux, Windows, or WSL UNC path).", "  --title <title>               Tab title override.", "  --split                       Open in split view beside the agent (default).", "  --tab                         Open in the current tab group instead.", "  --no-focus                    Open without selecting the tab.", "  --focus                       Select the tab (default); never raises the window.", "  --source <user|agent>         Mutation source.", "  --pane-dir <path>             Connect to a specific Pane data directory.", "  --yes                         Skip confirmation prompts.", "  --json                        Print JSON output."];
             readonly "panels submit-composer": readonly ["Submit an agent composer using the panel-appropriate key sequence.", "", "Usage:", "  runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter|tab] --yes [--json]", "", "Options:", "  --panel <panel-id>            Terminal panel id.", "  --strategy <strategy>         Defaults to auto; Codex queues with Tab while working and submits with Enter when ready. auto retries once if the text is still in the composer.", "  --yes                         Skip confirmation prompts.", "  --json                        Print JSON output."];
             readonly "sessions list": readonly ["Usage:", "runpane sessions list [--json] [--pane-dir <path>]", "", "Options:", "  --session <id|name>         Named Session id or exact name.", "  --from-json <path|->         Read structured JSON from a file or stdin.", "  --pane <pane-id>             User-visible Pane to associate or detach.", "  --agent <codex|claude|cursor>  Agent terminal to use.", "  --json                       Print JSON output."];
             readonly "sessions create": readonly ["Usage:", "runpane sessions create --from-json <path|-> [--json] [--pane-dir <path>]", "", "Options:", "  --session <id|name>         Named Session id or exact name.", "  --from-json <path|->         Read structured JSON from a file or stdin.", "  --pane <pane-id>             User-visible Pane to associate or detach.", "  --agent <codex|claude|cursor>  Agent terminal to use.", "  --json                       Print JSON output."];
@@ -1182,7 +1182,7 @@ export declare const RUNPANE_CONTRACT: {
             readonly "panels submit": readonly ["Usage:", "  runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) [--as-file-pointer] --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.", "", "For a Claude or Codex panel with no composer on screen, nothing is sent: the result is ok: false with blocked.kind composer-unknown.", "", "Multi-line or long (over 512 characters) text reaches a Claude or Codex composer as one bracketed paste: CRLF becomes LF, and the submit key goes as its own write once the paste has settled, even while the agent is working.", "", "For Claude, text starting with `!`, `#`, `/` or `@` is sent unchanged and the result carries a `warnings` entry (for example `leading-bang-runs-shell`), because Claude Code gives those characters a meaning of its own.", "", "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", "  --as-file-pointer              Write the text to a prompt file and submit `Read and follow <path>`", "  --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 "panels create": readonly ["Create a terminal-backed tool panel inside an existing Pane session.", "", "Usage:", "  python -m runpane panels create --pane <pane-id> --agent <codex|claude|cursor> [--title <title>] [--initial-input <text>] [--no-focus] [--wait-ready] --yes [--json]", "  python -m runpane panels create --pane <pane-id> --tool-command <command> [--agent <codex|claude|cursor>] [--title <title>] [--no-focus] [--wait-ready] --yes [--json]", "", "Options:", "  --pane <pane-id>              Existing Pane session to add the panel to.", "  --agent <codex|claude|cursor> Built-in agent command template, or with --tool-command the agent it runs.", "  --tool-command <command>      Custom terminal command to launch.", "  --title <title>               Panel title override.", "  --initial-input, --prompt     Initial input to send after the tool starts.", "  --initial-input-file <path|-> Read initial input from a file or stdin.", "  --as-file-pointer             Send `Read and follow <prompt file>` instead of the prompt.", "  --no-focus                    Create the panel in the background.", "  --focus                       Explicitly focus the created panel.", "  --source <user|agent>         Mark the mutation source; agent implies background creation.", "  --wait-ready                  Wait until the terminal tool is ready.", "  --ready-timeout-ms <ms>       Readiness wait timeout.", "  --yes                         Skip confirmation prompts.", "  --json                        Print JSON output."];
-            readonly "panels open": readonly ["Open a URL or file as a browser/editor tab in a Pane, in split view beside the agent by default.", "", "Usage:", "  python -m runpane panels open [--pane <pane-id>] (--url <url>|--file <path>) [--title <title>] [--split|--tab] [--focus|--no-focus] [--source user|agent] --yes [--json]", "", "Opens a tab inside a Pane (default: the Pane of the calling panel, from PANE_SESSION_ID). Use it to show the user an HTML page, plan, report, local dev server, or file beside the conversation. --url opens a browser tab (http, https, or file). --file opens a file inside the Pane worktree: .html/.htm files render in a browser tab, other files open in an editor tab. Tabs open in split view beside the agent by default; --tab keeps them in the current group. An existing tab showing the same URL or file is reused. Never raises or focuses the Pane window.", "", "Options:", "  --pane <pane-id>              Pane to open the tab in; defaults to PANE_SESSION_ID.", "  --url <url>                   http(s) or file URL to open in a browser tab.", "  --file <path>                 File inside the Pane worktree (relative or absolute).", "  --title <title>               Tab title override.", "  --split                       Open in split view beside the agent (default).", "  --tab                         Open in the current tab group instead.", "  --no-focus                    Open without selecting the tab.", "  --focus                       Select the tab (default); never raises the window.", "  --source <user|agent>         Mutation source.", "  --pane-dir <path>             Connect to a specific Pane data directory.", "  --yes                         Skip confirmation prompts.", "  --json                        Print JSON output."];
+            readonly "panels open": readonly ["Open a URL or file as a browser/editor tab in a Pane, in split view beside the agent by default.", "", "Usage:", "  python -m runpane panels open [--pane <pane-id>] (--url <url>|--file <path>) [--title <title>] [--split|--tab] [--focus|--no-focus] [--source user|agent] --yes [--json]", "", "Opens a tab inside a Pane (default: the Pane of the calling panel, from PANE_SESSION_ID). Use it to show the user an HTML page, plan, report, local dev server, or file beside the conversation. --url opens a browser tab (http, https, or file). --file opens a file inside the Pane worktree: .html/.htm files render in a browser tab, other files open in an editor tab. Tabs open in split view beside the agent by default; --tab keeps them in the current group. An existing tab showing the same URL or file is reused. Never raises or focuses the Pane window.", "", "Options:", "  --pane <pane-id>              Pane to open the tab in; defaults to PANE_SESSION_ID.", "  --url <url>                   http(s) or file URL to open in a browser tab.", "  --file <path>                 File inside the Pane worktree (relative, Linux, Windows, or WSL UNC path).", "  --title <title>               Tab title override.", "  --split                       Open in split view beside the agent (default).", "  --tab                         Open in the current tab group instead.", "  --no-focus                    Open without selecting the tab.", "  --focus                       Select the tab (default); never raises the window.", "  --source <user|agent>         Mutation source.", "  --pane-dir <path>             Connect to a specific Pane data directory.", "  --yes                         Skip confirmation prompts.", "  --json                        Print JSON output."];
             readonly "panels submit-composer": readonly ["Submit an agent composer using the panel-appropriate key sequence.", "", "Usage:", "  python -m runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter|tab] --yes [--json]", "", "Options:", "  --panel <panel-id>            Terminal panel id.", "  --strategy <strategy>         Defaults to auto; Codex queues with Tab while working and submits with Enter when ready. auto retries once if the text is still in the composer.", "  --yes                         Skip confirmation prompts.", "  --json                        Print JSON output."];
             readonly "sessions list": readonly ["Usage:", "python -m runpane sessions list [--json] [--pane-dir <path>]", "", "Options:", "  --session <id|name>         Named Session id or exact name.", "  --from-json <path|->         Read structured JSON from a file or stdin.", "  --pane <pane-id>             User-visible Pane to associate or detach.", "  --agent <codex|claude|cursor>  Agent terminal to use.", "  --json                       Print JSON output."];
             readonly "sessions create": readonly ["Usage:", "python -m runpane sessions create --from-json <path|-> [--json] [--pane-dir <path>]", "", "Options:", "  --session <id|name>         Named Session id or exact name.", "  --from-json <path|->         Read structured JSON from a file or stdin.", "  --pane <pane-id>             User-visible Pane to associate or detach.", "  --agent <codex|claude|cursor>  Agent terminal to use.", "  --json                       Print JSON output."];
@@ -5861,12 +5861,12 @@ export declare const RUNPANE_CONTRACT: {
                     readonly name: "--url";
                     readonly value: "<url>";
                     readonly required: false;
-                    readonly description: "http(s) or file URL to open in a browser tab. Pass exactly one of --url or --file.";
+                    readonly description: "http(s) or file URL to open in a browser tab. WSL file URLs use the same automatic path conversion as --file. Pass exactly one of --url or --file.";
                 }, {
                     readonly name: "--file";
                     readonly value: "<path>";
                     readonly required: false;
-                    readonly description: "File inside the Pane worktree, relative or absolute. .html/.htm renders in a browser tab; other files open in an editor tab.";
+                    readonly description: "File inside the Pane worktree, relative or absolute. WSL panes accept Linux, Windows drive, and WSL UNC paths without manual conversion. .html/.htm renders in a browser tab; other files open in an editor tab.";
                 }, {
                     readonly name: "--title";
                     readonly value: "<title>";

package/dist/generated/contract.js

@@ -2390,7 +2390,7 @@ exports.RUNPANE_CONTRACT = {
                 "Options:",
                 "  --pane <pane-id>              Pane to open the tab in; defaults to PANE_SESSION_ID.",
                 "  --url <url>                   http(s) or file URL to open in a browser tab.",
-                "  --file <path>                 File inside the Pane worktree (relative or absolute).",
+                "  --file <path>                 File inside the Pane worktree (relative, Linux, Windows, or WSL UNC path).",
                 "  --title <title>               Tab title override.",
                 "  --split                       Open in split view beside the agent (default).",
                 "  --tab                         Open in the current tab group instead.",
@@ -3483,7 +3483,7 @@ exports.RUNPANE_CONTRACT = {
                 "Options:",
                 "  --pane <pane-id>              Pane to open the tab in; defaults to PANE_SESSION_ID.",
                 "  --url <url>                   http(s) or file URL to open in a browser tab.",
-                "  --file <path>                 File inside the Pane worktree (relative or absolute).",
+                "  --file <path>                 File inside the Pane worktree (relative, Linux, Windows, or WSL UNC path).",
                 "  --title <title>               Tab title override.",
                 "  --split                       Open in split view beside the agent (default).",
                 "  --tab                         Open in the current tab group instead.",
@@ -11300,13 +11300,13 @@ exports.RUNPANE_CONTRACT = {
                         "name": "--url",
                         "value": "<url>",
                         "required": false,
-                        "description": "http(s) or file URL to open in a browser tab. Pass exactly one of --url or --file."
+                        "description": "http(s) or file URL to open in a browser tab. WSL file URLs use the same automatic path conversion as --file. Pass exactly one of --url or --file."
                     },
                     {
                         "name": "--file",
                         "value": "<path>",
                         "required": false,
-                        "description": "File inside the Pane worktree, relative or absolute. .html/.htm renders in a browser tab; other files open in an editor tab."
+                        "description": "File inside the Pane worktree, relative or absolute. WSL panes accept Linux, Windows drive, and WSL UNC paths without manual conversion. .html/.htm renders in a browser tab; other files open in an editor tab."
                     },
                     {
                         "name": "--title",