runpane 2.4.133 → 2.4.135

package/dist/generated/contract.js

@@ -317,7 +317,7 @@ exports.RUNPANE_CONTRACT = {
             "name": "panes adopt",
             "summary": "Adopt an existing externally managed git worktree as a Pane without changing the worktree.",
             "usage": [
-                "runpane panes adopt --repo <selector> --path <dir> --name <name> --agent <codex|claude|cursor> [--resume <id>] [--folder <name>] [--launch] [--no-pinned] [--dry-run] [--yes] [--json]"
+                "runpane panes adopt --repo <selector> --path <dir> --name <name> --agent <codex|claude|cursor> [--resume <id>] [--folder <name>] [--launch] [--no-pinned] [--no-associate] [--dry-run] [--yes] [--json]"
             ],
             "mutates": true,
             "additive": true,
@@ -1458,6 +1458,10 @@ exports.RUNPANE_CONTRACT = {
                 "name": "--no-pinned",
                 "description": "Create the pane unpinned instead of the default pinned (the UI's favorite/pin star)."
             },
+            {
+                "name": "--no-associate",
+                "description": "Inside a Session orchestrator, do not associate the created pane with that Session."
+            },
             {
                 "name": "--force",
                 "description": "Archive even if the pane's branch has uncommitted, untracked, or unpushed changes."
@@ -1839,6 +1843,7 @@ exports.RUNPANE_CONTRACT = {
                 "  --focus                        Explicitly focus the created pane",
                 "  --pinned                       Accepted for compatibility; creation already pins by default",
                 "  --no-pinned                    Create unpinned instead of the default pinned (the UI's favorite/pin star)",
+                "  --no-associate                 Inside a Session orchestrator, do not associate the new pane with that Session",
                 "  --pane-dir <path>              Connect to a specific Pane data directory",
                 "  --json                         Print machine-readable output",
                 "  --dry-run                      Validate and preview without creating panes",
@@ -1850,7 +1855,7 @@ exports.RUNPANE_CONTRACT = {
                 "",
                 "Adopts an existing externally managed git worktree without creating, syncing, or deleting it.",
                 "",
-                "Options: --resume <id> stages the agent resume command; --launch runs it immediately; --folder <name> groups the pane; --no-pinned opts out of pinning; --dry-run previews."
+                "Options: --resume <id> stages the agent resume command; --launch runs it immediately; --folder <name> groups the pane; --no-pinned opts out of pinning; --no-associate skips automatic Session association; --dry-run previews."
             ],
             "panes archive": [
                 "Usage:",
@@ -1999,7 +2004,7 @@ exports.RUNPANE_CONTRACT = {
                 "  runpane mcp [--toolsets <name,...>] [--read-only]",
                 "",
                 "Runs the Pane MCP server over stdio. Each runpane command with a JSON result becomes a tool that returns the same JSON as `runpane <command> --json`. Commands that need --yes take `yes: true` instead.",
-                "Pane registers this server with Claude Code and Codex automatically (Settings > AI & Agents). To register it by hand:",
+                "Pane registers this server with Claude Code, Codex, and Cursor automatically (Settings > AI & Agents). To register it by hand:",
                 "  claude mcp add --scope user pane -- npx --yes runpane@latest mcp",
                 "  codex mcp add pane -- npx --yes runpane@latest mcp",
                 "",
@@ -2784,6 +2789,7 @@ exports.RUNPANE_CONTRACT = {
                 "  --focus                        Explicitly focus the created pane",
                 "  --pinned                       Accepted for compatibility; creation already pins by default",
                 "  --no-pinned                    Create unpinned instead of the default pinned (the UI's favorite/pin star)",
+                "  --no-associate                 Inside a Session orchestrator, do not associate the new pane with that Session",
                 "  --pane-dir <path>              Connect to a specific Pane data directory",
                 "  --json                         Print machine-readable output",
                 "  --dry-run                      Validate and preview without creating panes",
@@ -2795,7 +2801,7 @@ exports.RUNPANE_CONTRACT = {
                 "",
                 "Adopts an existing externally managed git worktree without creating, syncing, or deleting it.",
                 "",
-                "Options: --resume <id> stages the agent resume command; --launch runs it immediately; --folder <name> groups the pane; --no-pinned opts out of pinning; --dry-run previews."
+                "Options: --resume <id> stages the agent resume command; --launch runs it immediately; --folder <name> groups the pane; --no-pinned opts out of pinning; --no-associate skips automatic Session association; --dry-run previews."
             ],
             "panes archive": [
                 "Usage:",
@@ -3484,7 +3490,7 @@ exports.RUNPANE_CONTRACT = {
             "runpane <command> --help"
         ],
         "commandDescriptions": [
-            "`runpane` with no arguments and `runpane setup` open an interactive wizard when stdin and stdout are TTYs. In non-interactive shells or CI, both forms must print help, common commands, and agent discovery hints, then exit successfully instead of waiting for input.",
+            "`runpane` with no arguments and `runpane setup` open an interactive wizard when stdin and stdout are TTYs. The remote-host wizard asks only for a name, then runs interactive Tailscale setup with automatic port selection; explicit install daemon flags remain available for SSH and manual URLs. In non-interactive shells or CI, both forms must print help, common commands, and agent discovery hints, then exit successfully instead of waiting for input.",
             "`runpane install` is an alias for `runpane install client`.",
             "`runpane install client` downloads the selected Pane desktop artifact and installs, opens, or launches it for the current platform.",
             "`runpane install daemon` downloads or installs Pane, resolves a stable Pane executable path, and spawns `<pane executable> --remote-setup <forwarded remote setup args>`.",
@@ -3500,7 +3506,7 @@ exports.RUNPANE_CONTRACT = {
             "`runpane repos add` registers an existing git repository with the running local Pane daemon. It does not create directories or initialize git repositories by default.",
             "`runpane panes list` lists Pane sessions, optionally scoped to one saved repository.",
             "`runpane panes cost` reports estimated token costs per Pane for the last 30 days, including per-model breakdowns and cache efficiency; unscoped output includes an Unattributed bucket that reconciles against workspace totals.",
-            "`runpane panes create` connects to the running local Pane daemon, resolves the requested saved base repository, creates user-visible Pane sessions backed by Pane-managed worktrees/branches, opens terminal-backed tool tabs, and optionally sends initial input to the started tool. Built-in agent panes and `--source agent` default to background/no-focus unless `--focus` is passed. New Panes are pinned into the UI's favorite/pin set by default; pass `--no-pinned` to opt out. Panes created interactively in the Pane UI are unaffected.",
+            "`runpane panes create` connects to the running local Pane daemon, resolves the requested saved base repository, creates user-visible Pane sessions backed by Pane-managed worktrees/branches, opens terminal-backed tool tabs, and optionally sends initial input to the started tool. Built-in agent panes and `--source agent` default to background/no-focus unless `--focus` is passed. New Panes are pinned into the UI's favorite/pin set by default; pass `--no-pinned` to opt out. Panes created interactively in the Pane UI are unaffected. Inside a Session orchestrator (`PANE_ORCHESTRATION_SESSION_ID` set), new Panes are associated with that Session automatically; `--no-associate` opts out. A failed association is reported on the item and never undoes the Pane.",
             "For `panes create --wait-ready`, `initialInput.verifiedSubmitted: true` is reported only after argument attachment or composer-clear plus activity evidence. Routing input does not by itself verify submission.",
             "`runpane panes archive` refreshes the configured upstream, reports exact unpushed commit evidence, and refuses unsafe archive operations unless `--force` is used. Add `--dry-run` to inspect the same evidence without archiving. Successful archives wait for worktree removal and report `worktreeCleanup`.",
             "`runpane panes rename` trims and updates a Pane's display name without changing its worktree, branch, panels, or focus, and returns the updated pane summary.",
@@ -3732,6 +3738,7 @@ exports.RUNPANE_CONTRACT = {
                 "--source",
                 "agent",
                 "--no-pinned",
+                "--no-associate",
                 "--dry-run",
                 "--yes",
                 "--json"
@@ -4765,6 +4772,10 @@ exports.RUNPANE_CONTRACT = {
                         "user",
                         "agent"
                     ]
+                },
+                "associateSession": {
+                    "type": "string",
+                    "description": "Session id to associate each created Pane with; the CLI sets it from PANE_ORCHESTRATION_SESSION_ID unless --no-associate."
                 }
             },
             "additionalProperties": false
@@ -5044,6 +5055,25 @@ exports.RUNPANE_CONTRACT = {
                                             }
                                         },
                                         "additionalProperties": false
+                                    },
+                                    "association": {
+                                        "type": "object",
+                                        "required": [
+                                            "sessionId",
+                                            "ok"
+                                        ],
+                                        "properties": {
+                                            "sessionId": {
+                                                "type": "string"
+                                            },
+                                            "ok": {
+                                                "type": "boolean"
+                                            },
+                                            "error": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "additionalProperties": false
                                     }
                                 },
                                 "additionalProperties": false
@@ -7622,6 +7652,7 @@ exports.RUNPANE_CONTRACT = {
                         "--source <user|agent>",
                         "--pinned",
                         "--no-pinned",
+                        "--no-associate",
                         "--no-focus",
                         "--focus",
                         "--wait-ready",
@@ -8068,7 +8099,7 @@ exports.RUNPANE_CONTRACT = {
             "mcp": {
                 "name": "mcp",
                 "summary": "Run the Pane MCP server over stdio so coding agents can call runpane commands as tools.",
-                "details": "Use this to register Pane with an MCP client. Pane registers it with Claude Code and Codex automatically; each tool mirrors one runpane command and returns its --json result.",
+                "details": "Use this to register Pane with an MCP client. Pane registers it with Claude Code, Codex, and Cursor automatically; each tool mirrors one runpane command and returns its --json result.",
                 "requiresPaneDaemon": false,
                 "mutates": false,
                 "arguments": [
@@ -8331,6 +8362,11 @@ exports.RUNPANE_CONTRACT = {
                         "required": false,
                         "description": "Create the pane unpinned instead of the default pinned (the Pane UI's favorite/pin star). Pinning never implies focus."
                     },
+                    {
+                        "name": "--no-associate",
+                        "required": false,
+                        "description": "Inside a Session orchestrator, do not associate the created pane with that Session (associated automatically by default)."
+                    },
                     {
                         "name": "--yes",
                         "required": false,
@@ -8378,7 +8414,7 @@ exports.RUNPANE_CONTRACT = {
                     "`panes create` is for user-visible Pane orchestration, not the agent's default private delegation mechanism.",
                     "Register the saved base repository once. Pane creates and owns the worktree/branch for each new Pane.",
                     "Use `panels create` instead when a reviewer/helper should share an existing Pane's worktree.",
-                    "Agent-created Panes should pass `--source agent --no-focus --wait-ready --yes --json` unless the user explicitly wants focus moved. `panes create` pins the new Pane by default, so a follow-up `panes pin` call is unnecessary; pass `--no-pinned` for throwaway shells or bulk imports. `--pinned` is still accepted and is now a no-op.",
+                    "Agent-created Panes should pass `--source agent --no-focus --wait-ready --yes --json` unless the user explicitly wants focus moved. `panes create` pins the new Pane by default, so a follow-up `panes pin` call is unnecessary; pass `--no-pinned` for throwaway shells or bulk imports. `--pinned` is still accepted and is now a no-op. Inside a Session orchestrator (`PANE_ORCHESTRATION_SESSION_ID` set), new Panes are associated with that Session automatically; `--no-associate` opts out. A failed association is reported on the item and never undoes the Pane.",
                     "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.",
                     "With --wait-ready, verifiedSubmitted is earned from delivery evidence; routing initial input alone does not imply verified submission.",
@@ -8445,6 +8481,11 @@ exports.RUNPANE_CONTRACT = {
                         "required": false,
                         "description": "Do not pin the adopted pane."
                     },
+                    {
+                        "name": "--no-associate",
+                        "required": false,
+                        "description": "Inside a Session orchestrator, do not associate the adopted pane with that Session (associated automatically by default)."
+                    },
                     {
                         "name": "--dry-run",
                         "required": false,
@@ -10474,7 +10515,7 @@ exports.RUNPANE_CONTRACT = {
             "sessions associate": {
                 "name": "sessions associate",
                 "summary": "Associate a user-visible Pane with a named Session.",
-                "details": "Associate a user-visible Pane with a named Session.",
+                "details": "Associate a user-visible Pane with a named Session. `panes create` and `panes adopt` already do this automatically when run inside a Session orchestrator; use this for existing Panes or after `--no-associate`.",
                 "requiresPaneDaemon": true,
                 "mutates": true,
                 "arguments": [],
@@ -10524,7 +10565,7 @@ exports.RUNPANE_CONTRACT = {
             "",
             "CLI: `npm i -g runpane` (or `npx --yes runpane@latest`), then `runpane doctor --json`. Full command reference: `runpane agent-context --json`.",
             "",
-            "MCP: packaged Pane registers a stdio server named `pane` with Claude Code and Codex. Check the connection with `claude mcp list` or `codex mcp list`. If tools are missing, add it in the agent's MCP settings: Claude Code `claude mcp add --scope user pane -- npx --yes runpane@latest mcp`; Codex (`~/.codex/config.toml`) table `[mcp_servers.pane]` with `command = \"npx\"` and `args = [\"--yes\", \"runpane@latest\", \"mcp\"]`; any other stdio client uses the same command and args."
+            "MCP: packaged Pane registers a stdio server named `pane` with Claude Code, Codex, and Cursor. Check the connection with `claude mcp list`, `codex mcp list`, or `agent mcp list`. Cursor may ask you to enable `pane` with `agent mcp enable pane`. If tools are missing, add it in the agent's MCP settings: Claude Code `claude mcp add --scope user pane -- npx --yes runpane@latest mcp`; Codex (`~/.codex/config.toml`) table `[mcp_servers.pane]` with `command = \"npx\"` and `args = [\"--yes\", \"runpane@latest\", \"mcp\"]`; Cursor (`~/.cursor/mcp.json`) uses `mcpServers.pane` with the same `npx` command and args; any other stdio client uses them too."
         ]
     }
 };