runpane 2.4.151 → 2.4.152

package/dist/generated/contract.js

@@ -100,7 +100,8 @@ exports.RUNPANE_CONTRACT = {
             "summary": "Show help for runpane or a specific command.",
             "usage": [
                 "runpane help [command]"
-            ]
+            ],
+            "localControl": false
         },
         {
             "name": "setup",
@@ -108,7 +109,8 @@ exports.RUNPANE_CONTRACT = {
             "usage": [
                 "runpane setup"
             ],
-            "interactiveEntrypoint": true
+            "interactiveEntrypoint": true,
+            "localControl": false
         },
         {
             "name": "install",
@@ -121,7 +123,8 @@ exports.RUNPANE_CONTRACT = {
                 "client",
                 "daemon"
             ],
-            "unknownDaemonFlagsForwarded": true
+            "unknownDaemonFlagsForwarded": true,
+            "localControl": false
         },
         {
             "name": "update",
@@ -129,7 +132,8 @@ exports.RUNPANE_CONTRACT = {
             "usage": [
                 "runpane update [options]"
             ],
-            "target": "client"
+            "target": "client",
+            "localControl": false
         },
         {
             "name": "version",
@@ -137,7 +141,8 @@ exports.RUNPANE_CONTRACT = {
             "usage": [
                 "runpane version [--pane-dir <path>]",
                 "runpane --version"
-            ]
+            ],
+            "localControl": false
         },
         {
             "name": "doctor",
@@ -153,7 +158,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "doctorResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "daemon repair",
@@ -167,7 +173,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonRepairResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "agents doctor",
@@ -180,7 +187,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "agentDoctorResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "agent-context",
@@ -196,7 +204,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "agentContextBriefResult",
                 "agentContextCommandResult"
-            ]
+            ],
+            "localControl": false
         },
         {
             "name": "mcp",
@@ -206,7 +215,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "wrappers": [
                 "npm"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "repos list",
@@ -220,7 +230,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "repoListResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "repos add",
@@ -238,7 +249,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "repoAddRequest",
                 "repoAddResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes list",
@@ -252,7 +264,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "paneListResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes cost",
@@ -266,7 +279,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "paneCostRequest",
                 "paneCostResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "workspace state",
@@ -280,7 +294,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "workspaceStateResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "watch",
@@ -294,7 +309,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "workspaceWaitRequest",
                 "workspaceWaitResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes create",
@@ -312,7 +328,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "paneCreateRequest",
                 "paneCreateResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes adopt",
@@ -328,7 +345,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "paneCreateResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes archive",
@@ -347,7 +365,8 @@ exports.RUNPANE_CONTRACT = {
                 "paneArchiveBulkRequest",
                 "paneArchiveResult",
                 "paneArchiveBulkResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes pin",
@@ -363,7 +382,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "panePinRequest",
                 "panePinResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes unpin",
@@ -379,7 +399,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "panePinRequest",
                 "panePinResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes rename",
@@ -395,7 +416,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "paneRenameRequest",
                 "paneRenameResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes focus",
@@ -412,7 +434,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "paneFocusRequest",
                 "paneFocusResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panels create",
@@ -429,7 +452,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "panelCreateRequest",
                 "panelCreateResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panels open",
@@ -441,7 +465,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "panelOpenRequest",
                 "panelOpenResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panels list",
@@ -454,7 +479,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "panelListResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panels output",
@@ -467,7 +493,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "panelOutputResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panels screen",
@@ -480,7 +507,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "panelScreenResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panels input",
@@ -496,7 +524,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "panelInputRequest",
                 "panelInputResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panels submit",
@@ -511,7 +540,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "panelSubmitRequest",
                 "panelSubmitResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panels submit-composer",
@@ -526,7 +556,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "panelSubmitComposerRequest",
                 "panelSubmitComposerResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panels wait",
@@ -539,7 +570,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "panelWaitResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panels last-message",
@@ -553,7 +585,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "panelLastMessageResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes git-status",
@@ -573,7 +606,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes commit",
@@ -595,7 +629,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes push",
@@ -618,7 +653,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes pull",
@@ -639,7 +675,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes rebase-main",
@@ -659,7 +696,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes restore",
@@ -682,7 +720,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes squash-rebase",
@@ -703,7 +742,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes stash",
@@ -723,7 +763,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes stash-pop",
@@ -743,7 +784,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes soft-reset",
@@ -763,7 +805,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes fetch",
@@ -786,7 +829,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes run-script",
@@ -807,7 +851,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes stop-script",
@@ -828,7 +873,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "panes move",
@@ -850,7 +896,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "folders list",
@@ -869,7 +916,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "folders create",
@@ -891,7 +939,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "links create",
@@ -907,7 +956,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "linkCreateResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "links open",
@@ -929,7 +979,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "daemonActionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "docs search",
@@ -946,7 +997,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "docsSearchResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "docs read",
@@ -963,7 +1015,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "docsReadResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "agents start",
@@ -982,7 +1035,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "agentTaskResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "agents status",
@@ -999,7 +1053,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "agentStatusResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "agents send",
@@ -1017,7 +1072,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "agentSendResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "report",
@@ -1033,7 +1089,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "reportResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "sessions list",
@@ -1046,7 +1103,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "sessionListResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "sessions create",
@@ -1061,7 +1119,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "sessionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "sessions get",
@@ -1074,7 +1133,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "sessionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "sessions update",
@@ -1089,7 +1149,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "sessionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "sessions set-agent",
@@ -1104,7 +1165,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "sessionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "sessions associate",
@@ -1120,7 +1182,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "sessionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "sessions detach",
@@ -1135,7 +1198,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "sessionResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "sessions overview",
@@ -1148,7 +1212,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "sessionOverviewResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "lock acquire",
@@ -1165,7 +1230,8 @@ exports.RUNPANE_CONTRACT = {
             "jsonSchemas": [
                 "lockAcquireRequest",
                 "lockAcquireResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "lock release",
@@ -1180,7 +1246,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "lockReleaseResult"
-            ]
+            ],
+            "localControl": true
         },
         {
             "name": "lock list",
@@ -1193,7 +1260,8 @@ exports.RUNPANE_CONTRACT = {
             ],
             "jsonSchemas": [
                 "lockListResult"
-            ]
+            ],
+            "localControl": true
         }
     ],
     "flags": {
@@ -4033,7 +4101,7 @@ exports.RUNPANE_CONTRACT = {
             "`runpane docs search|read` search and read Pane docs, help, and installed Pane Chat skills offline. They ship in the npm package and the Pane app only."
         ],
         "wrapperFlagNote": "The top-level `runpane --version` form prints the wrapper version. The install subcommand form `runpane install --version vX.Y.Z` selects a Pane release.",
-        "localControlFlagNote": "`runpane doctor --json`, `runpane repos list`, `runpane panes ...`, and `runpane panels ...` commands use or describe the local framed daemon socket/pipe for a running Pane app. `--pane-dir` points the wrapper at a non-default Pane data directory, such as `PANE_DIR=~/.pane_test` in development. `runpane agent-context` is local/offline and can be used before Pane is running. `agent-context` and `version` accept and ignore `--pane-dir`, so one `--pane-dir` can be passed to every runpane command. In a Pane repository checkout, if `runpane` is not on PATH, use the built local wrapper with Node 22, for example `PATH=/opt/homebrew/opt/node@22/bin:$PATH node packages/runpane/dist/cli.js doctor --json`. From WSL, if the user runs Windows Pane, call the Windows wrapper through `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane ...'` so the command can reach the Windows named-pipe daemon and avoid UNC cwd issues.",
+        "localControlFlagNote": "`runpane doctor --json`, `runpane repos list`, `runpane panes ...`, and `runpane panels ...` commands use or describe the local framed daemon socket/pipe for a running Pane app. `--pane-dir` points the wrapper at a non-default Pane data directory, such as `PANE_DIR=~/.pane_test` in development. `runpane agent-context` is local/offline and can be used before Pane is running. `agent-context` and `version` accept and ignore `--pane-dir`, so one `--pane-dir` can be passed to every runpane command. In a Pane repository checkout, if `runpane` is not on PATH, build the local wrapper with `pnpm --filter runpane build` and run it with Node 22 or newer, for example `node packages/runpane/dist/cli.js doctor --json`. From WSL, if the user runs Windows Pane, call the Windows wrapper through `powershell.exe -NoProfile -Command 'Set-Location $env:TEMP; runpane ...'` so the command can reach the Windows named-pipe daemon and avoid UNC cwd issues.",
         "daemonFlagNote": "Unknown daemon flags should be forwarded rather than dropped so newer Pane versions can extend `--remote-setup` without requiring an immediate wrapper release. Unknown flags for non-daemon commands should fail clearly.",
         "downloadAttribution": [
             "The npm package uses `source=npm` for all npm-registry consumers, including `npx`, `pnpm dlx`, `yarn dlx`, `bunx`, and global npm/pnpm installs.",
@@ -9325,7 +9393,7 @@ exports.RUNPANE_CONTRACT = {
             "summary": "Pane lets a developer manage saved base repositories, user-visible Panes (Pane sessions) for feature/PR work, and terminal-backed panel tabs. A Pane is a visible workspace that normally maps to one Pane-managed git worktree and branch; a panel is a terminal tab inside one Pane and shares that Pane's worktree; an agent is a CLI process running inside a panel.",
             "rules": [
                 "Start with `runpane doctor --json` to understand wrapper, platform, daemon reachability, and the next safe commands before mutating Pane state.",
-                "In a Pane repository checkout, if `runpane` is not on PATH, use the built local wrapper with Node 22, for example `PATH=/opt/homebrew/opt/node@22/bin:$PATH node packages/runpane/dist/cli.js doctor --json`.",
+                "In a Pane repository checkout, if `runpane` is not on PATH, build the local wrapper with `pnpm --filter runpane build` and run it with Node 22 or newer, for example `node packages/runpane/dist/cli.js doctor --json`.",
                 "Happy path for any user request to use Pane/RunPane: run `runpane doctor --json`, read `runpane agent-context --json`, resolve or add the saved base repo, create the requested visible Pane with a complete command such as `runpane panes create --repo <repo> --name <name> --agent <agent> --prompt \"<task>\" --source agent --no-focus --wait-ready --yes --json` (the new Pane is pinned by default; add `--no-pinned` for a throwaway Pane, add `--base-branch <ref>` to branch from something other than the repository default, or use `--tool-command <command>` instead of `--agent <agent>`), then validate with `panels wait` or `panels screen`. For long-lived supervision, use `runpane watch --follow` instead of polling wait or screen.",
                 "Treat Pane as the user's visible cockpit for watching/co-driving work. Do not create Panes or panels for private delegation unless the user asked for visible Pane orchestration or the result should appear in the Pane app.",
                 "Register the saved base repository once with `repos add`; do not register a pre-created worktree as a separate repo unless the user explicitly asks.",