runpane 2.4.94 → 2.4.96

package/dist/generated/contract.js

@@ -243,6 +243,17 @@ exports.RUNPANE_CONTRACT = {
                 "paneCreateResult"
             ]
         },
+        {
+            "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]"
+            ],
+            "mutates": true,
+            "jsonSchemas": [
+                "paneCreateResult"
+            ]
+        },
         {
             "name": "panes archive",
             "summary": "Archive a Pane (session) exactly like the UI Archive action, including safe removal of its Pane-managed git worktree.",
@@ -511,6 +522,16 @@ exports.RUNPANE_CONTRACT = {
                 "value": "<branch>",
                 "description": "Base branch for the created worktree."
             },
+            {
+                "name": "--folder",
+                "value": "<name>",
+                "description": "Top-level sidebar folder for an adopted pane."
+            },
+            {
+                "name": "--resume",
+                "value": "<agent-session-id>",
+                "description": "Agent session id to persist and resume in an adopted pane."
+            },
             {
                 "name": "--agent",
                 "value": "<codex|claude|cursor>",
@@ -679,6 +700,10 @@ exports.RUNPANE_CONTRACT = {
                 "name": "--force",
                 "description": "Archive even if the pane's branch has uncommitted, untracked, or unpushed changes."
             },
+            {
+                "name": "--launch",
+                "description": "Run an adopted pane's agent resume command immediately instead of staging it."
+            },
             {
                 "name": "--follow",
                 "description": "Continue waiting for workspace events until interrupted."
@@ -1007,6 +1032,14 @@ exports.RUNPANE_CONTRACT = {
                 "  --dry-run                      Validate and preview without creating panes",
                 "  --yes                          Skip confirmation for mutating commands"
             ],
+            "panes adopt": [
+                "Usage:",
+                "  runpane panes adopt --repo <selector> --path <dir> --name <name> --agent <codex|claude|cursor> [options]",
+                "",
+                "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."
+            ],
             "panes archive": [
                 "Usage:",
                 "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] [--dry-run] --yes [--json]",
@@ -1500,6 +1533,14 @@ exports.RUNPANE_CONTRACT = {
                 "  --dry-run                      Validate and preview without creating panes",
                 "  --yes                          Skip confirmation for mutating commands"
             ],
+            "panes adopt": [
+                "Usage:",
+                "  runpane panes adopt --repo <selector> --path <dir> --name <name> --agent <codex|claude|cursor> [options]",
+                "",
+                "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."
+            ],
             "panes archive": [
                 "Usage:",
                 "  runpane panes archive --pane <pane-id> [--source user|agent] [--force] [--dry-run] --yes [--json]",
@@ -3269,7 +3310,8 @@ exports.RUNPANE_CONTRACT = {
                             "repoId",
                             "panelCount",
                             "pinned",
-                            "agentStatus"
+                            "agentStatus",
+                            "ownership"
                         ],
                         "properties": {
                             "id": {
@@ -3313,6 +3355,12 @@ exports.RUNPANE_CONTRACT = {
                                     "active",
                                     "idle"
                                 ]
+                            },
+                            "ownership": {
+                                "enum": [
+                                    "pane",
+                                    "external"
+                                ]
                             }
                         },
                         "additionalProperties": false
@@ -6081,6 +6129,86 @@ exports.RUNPANE_CONTRACT = {
                     "If readiness returns blocked, inspect blocked.suggestedCommand rather than guessing which prompt to answer."
                 ]
             },
+            "panes adopt": {
+                "name": "panes adopt",
+                "summary": "Adopt an existing externally managed git worktree as a Pane.",
+                "details": "Validates that the canonical path is a registered worktree of the selected saved repository, then creates a Pane record without creating, syncing, building, removing, or recreating the directory.",
+                "requiresPaneDaemon": true,
+                "mutates": true,
+                "arguments": [
+                    {
+                        "name": "--repo",
+                        "value": "<selector>",
+                        "required": true,
+                        "description": "Saved repository selector."
+                    },
+                    {
+                        "name": "--path",
+                        "value": "<dir>",
+                        "required": true,
+                        "description": "Existing git worktree path."
+                    },
+                    {
+                        "name": "--name",
+                        "value": "<name>",
+                        "required": true,
+                        "description": "Pane name."
+                    },
+                    {
+                        "name": "--agent",
+                        "value": "<codex|claude|cursor>",
+                        "required": true,
+                        "description": "Agent whose terminal to create."
+                    },
+                    {
+                        "name": "--resume",
+                        "value": "<id>",
+                        "required": false,
+                        "description": "Persist this agent session id and stage its resume command."
+                    },
+                    {
+                        "name": "--folder",
+                        "value": "<name>",
+                        "required": false,
+                        "description": "Top-level sidebar folder."
+                    },
+                    {
+                        "name": "--launch",
+                        "required": false,
+                        "description": "Run the resume command immediately."
+                    },
+                    {
+                        "name": "--no-pinned",
+                        "required": false,
+                        "description": "Do not pin the adopted pane."
+                    },
+                    {
+                        "name": "--dry-run",
+                        "required": false,
+                        "description": "Validate and preview only."
+                    },
+                    {
+                        "name": "--yes",
+                        "required": false,
+                        "description": "Skip confirmation."
+                    },
+                    {
+                        "name": "--json",
+                        "required": false,
+                        "description": "Print machine-readable output."
+                    }
+                ],
+                "examples": [
+                    "runpane panes adopt --repo active --path /path/to/worktree --name imported --agent codex --resume <id> --yes --json"
+                ],
+                "jsonSchemas": [
+                    "paneCreateResult"
+                ],
+                "notes": [
+                    "The resume command is staged without Enter unless --launch is passed.",
+                    "Pane never removes an externally owned worktree."
+                ]
+            },
             "panes archive": {
                 "name": "panes archive",
                 "summary": "Archive a Pane (session) exactly like the UI Archive action, including safe removal of its Pane-managed git worktree.",