@super-one/cli 0.67.0-alpha → 0.67.0-alpha.2

package/MANIFEST.json

@@ -1,7 +1,7 @@
 {
   "name": "@super-one/cli",
-  "version": "0.67.0-alpha",
+  "version": "0.67.0-alpha.2",
   "kind": "npm",
   "minNodeMajor": 20,
-  "builtAt": "2026-09-15T09:05:55.894Z"
+  "builtAt": "2026-09-16T16:24:48.589Z"
 }

package/lib/cli.mjs

@@ -359,7 +359,7 @@ var init_interaction_memory = __esm({
 });
 
 // ../../packages/shared/src/superone-tool-descriptions.ts
-var MANUAL_READ_DESCRIPTION, SETUP_MINI_APP_DEV_DESCRIPTION, REGISTER_DEV_MINIAPP_DESCRIPTION, PACK_MINI_APP_DESCRIPTION, UPDATE_SUPERONE_TYPES_DESCRIPTION, RENAME_SESSION_DESCRIPTION, SESSION_TAG_DESCRIPTION, SESSION_TAG_LIST_DESCRIPTION, PROJECT_LIST_DESCRIPTION, SESSION_LIST_DESCRIPTION, SESSION_SEARCH_DESCRIPTION, SESSION_READ_DESCRIPTION, SESSION_TAGS_FILTER_DESCRIPTION, SESSION_TAG_MATCH_DESCRIPTION, SESSION_CLEANUP_DESCRIPTION, CONFIG_READ_DESCRIPTION, CONFIG_APPLY_DESCRIPTION, LIST_MEDIA_PROVIDERS_DESCRIPTION, GENERATE_IMAGE_DESCRIPTION, GENERATE_VIDEO_DESCRIPTION, VIDEO_STATUS_DESCRIPTION, SESSION_LIST_AGENTS_DESCRIPTION, SESSION_REQUEST_AGENTS_DESCRIPTION, LAUNCH_SUMMARY_DESCRIPTION, LAUNCH_TASK_DESCRIPTION, LAUNCH_MODE_DESCRIPTION, LAUNCH_SESSION_ID_DESCRIPTION, LAUNCH_PERMISSION_MODE_DESCRIPTION, LAUNCH_CWD_DESCRIPTION, LAUNCH_WORKTREE_DESCRIPTION, LAUNCH_BRANCH_NAME_DESCRIPTION, SESSION_START_DESCRIPTION, SESSION_SEND_DESCRIPTION, SESSION_RETRIEVE_DESCRIPTION, AUTOMATION_LIST_DESCRIPTION, AUTOMATION_APPLY_DESCRIPTION, AUTOMATION_DELETE_DESCRIPTION;
+var MANUAL_READ_DESCRIPTION, SETUP_MINI_APP_DEV_DESCRIPTION, REGISTER_DEV_MINIAPP_DESCRIPTION, PACK_MINI_APP_DESCRIPTION, UPDATE_SUPERONE_TYPES_DESCRIPTION, RENAME_SESSION_DESCRIPTION, SESSION_TAG_DESCRIPTION, SESSION_TAG_LIST_DESCRIPTION, PROJECT_LIST_DESCRIPTION, SESSION_LIST_DESCRIPTION, SESSION_SEARCH_DESCRIPTION, SESSION_READ_DESCRIPTION, SESSION_TAGS_FILTER_DESCRIPTION, SESSION_TAG_MATCH_DESCRIPTION, SESSION_CLEANUP_DESCRIPTION, CONFIG_READ_DESCRIPTION, CONFIG_APPLY_DESCRIPTION, LIST_MEDIA_PROVIDERS_DESCRIPTION, GENERATE_IMAGE_DESCRIPTION, GENERATE_VIDEO_DESCRIPTION, VIDEO_STATUS_DESCRIPTION, SESSION_LIST_AGENTS_DESCRIPTION, SESSION_REQUEST_AGENTS_DESCRIPTION, LAUNCH_SUMMARY_DESCRIPTION, LAUNCH_TASK_DESCRIPTION, LAUNCH_MODE_DESCRIPTION, LAUNCH_SESSION_ID_DESCRIPTION, LAUNCH_PERMISSION_MODE_DESCRIPTION, LAUNCH_CWD_DESCRIPTION, LAUNCH_WORKTREE_DESCRIPTION, LAUNCH_BRANCH_NAME_DESCRIPTION, SESSION_START_DESCRIPTION, SESSION_SEND_DESCRIPTION, SESSION_RETRIEVE_DESCRIPTION, AUTOMATION_LIST_DESCRIPTION, AUTOMATION_APPLY_DESCRIPTION, AUTOMATION_DELETE_DESCRIPTION, TERMINAL_TABS_DESCRIPTION, TERMINAL_SNAPSHOT_DESCRIPTION, TERMINAL_ACT_DESCRIPTION, TERMINAL_WAIT_FOR_DESCRIPTION;
 var init_superone_tool_descriptions = __esm({
   "../../packages/shared/src/superone-tool-descriptions.ts"() {
     "use strict";
@@ -400,6 +400,10 @@ var init_superone_tool_descriptions = __esm({
     AUTOMATION_LIST_DESCRIPTION = "List project automations with schedule and last/next run. Pass id for full prompt, agentConfig, and schedule; filter by query or enabled. Find unknown ids here before automation_apply or automation_delete; check for duplicates before creation when needed.";
     AUTOMATION_APPLY_DESCRIPTION = 'Create or update a project automation. create needs name, prompt, schedule; update needs id plus any field (pause via enabled=false). Call automation_list first for ids; remove with automation_delete. Always opens a user confirmation dialog and applies nothing without approval. For schedule and agentConfig shapes see read_manual({ domain: "product", topic: "automation" }).';
     AUTOMATION_DELETE_DESCRIPTION = "Permanently delete project automations by id (from automation_list). Always opens a user confirmation dialog. Current project only. Prefer automation_list to choose ids first.";
+    TERMINAL_TABS_DESCRIPTION = "Manage activity-panel terminal tabs for long-lived or interactive processes: dev servers, watch modes, REPLs, TUIs, ssh, wizards. One-shot commands (build, test, git) belong in your shell tool. action=list (default) returns this session's tabs plus the user's as a TOON table; other sessions' tabs are hidden. action=run asks to approve `command`, types it into a new or idle tab, and returns the screen; you control the tab only while that command is in the foreground. action=attach asks to control a command already running in a user tab. action=close kills a tab you opened, never one the user is using. Follow with terminal_act / terminal_wait_for / terminal_snapshot.";
+    TERMINAL_SNAPSHOT_DESCRIPTION = "Read a terminal tab as rendered text. `include` picks sections: screen (visible rows, default), scrollback (last `tail` lines including scrolled-off output), cursor, meta (title, cwd, status, foreground command, control). Use screen for prompts and full-screen programs, scrollback for server logs. Output over the tail cap is spilled to a file and returned as path + preview. Prefer this before terminal_act; use terminal_wait_for instead of polling.";
+    TERMINAL_ACT_DESCRIPTION = 'Send input to a terminal tab you control. actions is an array, e.g. [{type:"type",text:"yes"}] or [{type:"key",key:"Ctrl+C"}]; types: type (Enter by default), key (Enter, Tab, Escape, Up, Ctrl+C, F1\u2026), raw, resize, wait. ONE action per call by default; batch 2\u201320 only for an uninterruptible sequence (answer a wizard). Fail-fast. expect holds the call open until a screen condition is met (text, textGone, idleMs, exited); the screen after the batch is returned. Rejected with status=rejected when the approved command has exited or the user took over \u2014 do not retry, call terminal_tabs run again or ask. description is shown to the user instead of raw keystrokes.';
+    TERMINAL_WAIT_FOR_DESCRIPTION = "Block until a terminal tab reaches a state; conditions AND-combine: text (substring visible on screen or in new output), textGone, idleMs (no output for that long), exited (foreground command finished). Use after terminal_tabs run or terminal_act when output arrives asynchronously (a server banner, a build finishing). timeoutMs default 15000, max 120000. Do not sleep+poll with terminal_snapshot yourself.";
   }
 });
 
@@ -2786,7 +2790,7 @@ var WIDGET_SHOW_DESCRIPTION;
 var init_widget_tool_descriptions = __esm({
   "../../packages/shared/src/generative-ui/widget-tool-descriptions.ts"() {
     "use strict";
-    WIDGET_SHOW_DESCRIPTION = `Render SVG, diagrams, charts, or interactive HTML inline in chat. Pass widget_code for new content, or template + data to reuse a saved template. To show media you produced yourself, pass a @native/* template so it renders in SuperOne's own gallery (viewer, download, drag-out) instead of a lookalike you build in widget_code \u2014 call widget_list_templates for the list. To hand the user several files to look at one after another (screenshots, reports, changed sources), pass @native/files-previewer with data.files. Before the first new widget in a session, load the relevant design modules with read_manual({ domain: "widget", modules: [...] }).`;
+    WIDGET_SHOW_DESCRIPTION = `Render SVG, diagrams, charts, interactive HTML, or a SuperOne native surface (media gallery, files previewer) inline in chat. Pass widget_code for new content, or template + data to reuse a saved template. To show media you produced yourself, pass a @native/* template so it renders in SuperOne's own gallery (viewer, download, drag-out) instead of a lookalike you build in widget_code \u2014 call widget_list_templates for the list. To hand the user several files to look at one after another (screenshots, reports, changed sources), pass @native/files-previewer with data.files. Before the first new widget in a session, load the relevant design modules with read_manual({ domain: "widget", modules: [...] }).`;
   }
 });
 
@@ -3622,6 +3626,132 @@ var init_host_action_browser_perf_descriptors = __esm({
   }
 });
 
+// ../../packages/shared/src/environment/host-action-terminal-descriptors.ts
+var TERMINAL_WAIT_CONDITION_PROPERTIES, TERMINAL_ACTION_INPUT_SCHEMA, HOST_ACTION_TERMINAL_DESCRIPTORS;
+var init_host_action_terminal_descriptors = __esm({
+  "../../packages/shared/src/environment/host-action-terminal-descriptors.ts"() {
+    "use strict";
+    init_superone_tool_descriptions();
+    TERMINAL_WAIT_CONDITION_PROPERTIES = {
+      text: { type: "string", description: "Substring that must appear on screen or in recent output." },
+      textGone: { type: "string", description: "Substring that must be absent from the screen." },
+      idleMs: { type: "number", description: "No output for this many milliseconds." },
+      exited: { type: "boolean", description: "The controlled command has left the foreground (or the tab exited)." }
+    };
+    TERMINAL_ACTION_INPUT_SCHEMA = {
+      type: "object",
+      description: "type: text (+Enter unless enter=false) \xB7 key: named key (Enter, Tab, Escape, Up, Ctrl+C, Alt+b, F1\u2026) with optional repeat \xB7 raw: bytes verbatim \xB7 resize: cols/rows \xB7 wait: ms (\u22645000, inside a batch).",
+      properties: {
+        type: { type: "string", enum: ["type", "key", "raw", "resize", "wait"] },
+        text: { type: "string" },
+        enter: { type: "boolean", description: "type only. Default true." },
+        key: { type: "string" },
+        repeat: { type: "number", description: "key only. 1\u2013100." },
+        bytes: { type: "string" },
+        cols: { type: "number" },
+        rows: { type: "number" },
+        ms: { type: "number" }
+      },
+      required: ["type"],
+      additionalProperties: false
+    };
+    HOST_ACTION_TERMINAL_DESCRIPTORS = [
+      {
+        name: "terminal_tabs",
+        description: TERMINAL_TABS_DESCRIPTION,
+        inputSchema: {
+          type: "object",
+          properties: {
+            action: { type: "string", enum: ["list", "run", "attach", "close"], description: "Default list." },
+            tab: {
+              type: ["string", "array"],
+              items: { type: "string" },
+              minItems: 1,
+              description: "Tab id from list. run: reuse this idle tab instead of opening one. attach/close: the target (close accepts an array)."
+            },
+            command: { type: "string", description: "run only. The command the user approves and that is typed into the shell." },
+            rule: {
+              type: "string",
+              description: 'run only. The rule offered as "always allow in this project" next to the approval: the command cut down to its stable leading words plus ":*", e.g. "bun run:*" for "bun run dev", "git commit:*" for "git commit -m \u2026". It must match `command`; keep it as narrow as the user would want (never a bare "sudo:*" / "ssh:*"). Default: derived from the command.'
+            },
+            cwd: { type: "string", description: "run only. Absolute working directory for a new tab. Default: the session working directory." },
+            title: { type: "string", description: "run only. Tab title shown to the user. Default: the command name." },
+            size: {
+              type: "object",
+              properties: { cols: { type: "number" }, rows: { type: "number" } },
+              required: ["cols", "rows"],
+              additionalProperties: false,
+              description: "run only. Initial size of a new tab. Default 120\xD740."
+            },
+            yieldMs: { type: "number", description: "run only. How long to wait for the command to start and go quiet before returning. Default 5000, max 30000." },
+            description: { type: "string", description: "Shown to the user instead of raw arguments." }
+          },
+          additionalProperties: false
+        }
+      },
+      {
+        name: "terminal_snapshot",
+        description: TERMINAL_SNAPSHOT_DESCRIPTION,
+        inputSchema: {
+          type: "object",
+          properties: {
+            tab: { type: "string", description: "Tab id from terminal_tabs." },
+            include: {
+              type: "array",
+              items: { type: "string", enum: ["screen", "scrollback", "cursor", "meta"] },
+              description: "Sections to return. Default [screen]."
+            },
+            tail: { type: "number", description: "scrollback only. Lines from the end. Default 200, max 2000." }
+          },
+          required: ["tab"],
+          additionalProperties: false
+        }
+      },
+      {
+        name: "terminal_act",
+        description: TERMINAL_ACT_DESCRIPTION,
+        inputSchema: {
+          type: "object",
+          properties: {
+            tab: { type: "string", description: "Tab id from terminal_tabs." },
+            actions: {
+              type: "array",
+              items: TERMINAL_ACTION_INPUT_SCHEMA,
+              minItems: 1,
+              maxItems: 20,
+              description: "Normally one action. Use 2\u201320 only for a single uninterruptible sequence; they run in order, fail-fast."
+            },
+            expect: {
+              type: "object",
+              properties: TERMINAL_WAIT_CONDITION_PROPERTIES,
+              additionalProperties: false,
+              description: "Completion condition to wait for after the batch."
+            },
+            timeoutMs: { type: "number", description: "Maximum wait for expect. Default 15000, max 60000." },
+            description: { type: "string", description: "Shown to the user instead of raw keystrokes." }
+          },
+          required: ["tab", "actions"],
+          additionalProperties: false
+        }
+      },
+      {
+        name: "terminal_wait_for",
+        description: TERMINAL_WAIT_FOR_DESCRIPTION,
+        inputSchema: {
+          type: "object",
+          properties: {
+            tab: { type: "string", description: "Tab id from terminal_tabs." },
+            ...TERMINAL_WAIT_CONDITION_PROPERTIES,
+            timeoutMs: { type: "number", description: "Maximum wait in milliseconds. Default 15000, max 120000." }
+          },
+          required: ["tab"],
+          additionalProperties: false
+        }
+      }
+    ];
+  }
+});
+
 // ../../packages/shared/src/environment/host-action-superone-descriptors.ts
 var HOST_ACTION_SUPERONE_TOOL_DESCRIPTORS;
 var init_host_action_superone_descriptors = __esm({
@@ -3639,6 +3769,7 @@ var init_host_action_superone_descriptors = __esm({
     init_host_action_automation_descriptors();
     init_host_action_device_descriptors();
     init_host_action_browser_perf_descriptors();
+    init_host_action_terminal_descriptors();
     HOST_ACTION_SUPERONE_TOOL_DESCRIPTORS = [
       ...INTERACTION_MEMORY_TOOL_DEFS,
       ...HOST_ACTION_COLLABORATION_DESCRIPTORS,
@@ -3650,6 +3781,7 @@ var init_host_action_superone_descriptors = __esm({
       ...HOST_ACTION_COMPUTER_DESCRIPTORS,
       ...HOST_ACTION_WIDGET_DESCRIPTORS,
       ...HOST_ACTION_AUTOMATION_DESCRIPTORS,
+      ...HOST_ACTION_TERMINAL_DESCRIPTORS,
       ...HOST_ACTION_DEVICE_DESCRIPTORS,
       ...HOST_ACTION_BROWSER_PERF_DESCRIPTORS
     ];
@@ -8448,17 +8580,19 @@ function superoneHostContext(extra) {
 ${superoneSystemPrompt(extra)}
 </superone-host-context>`;
 }
-var SUPERONE_SYSTEM_PROMPT_APPEND;
+var SUPERONE_SYSTEM_PROMPT_APPEND, CLAUDE_TOOL_NAMING_APPEND, CLAUDE_SYSTEM_PROMPT_APPEND;
 var init_superone_system_prompt = __esm({
   "../../packages/shared/src/superone-system-prompt.ts"() {
     "use strict";
     init_browser_memory();
     SUPERONE_SYSTEM_PROMPT_APPEND = `You are running inside SuperOne, a desktop GUI app. Your replies render as rich Markdown in a chat panel.
 
-SuperOne tools cover browser and device control, media, widgets, sessions, collaboration, automations, settings, and mini-apps. Read only the manual topics needed for the task; reuse guidance already in context.
+SuperOne tools cover browser, terminal and device control, media, widgets, sessions, collaboration, automations, settings, and mini-apps. Read only the manual topics needed for the task; reuse guidance already in context.
 
 Prefer SuperOne's built-in tools unless the user explicitly requests another tool or no suitable SuperOne tool is available.
 
+Terminals: your own shell tool stays the default for one-shot commands (build, test, git, scripts) that finish on their own. Anything that keeps running or waits for input \u2014 dev servers, watch/hot-reload modes, docker compose up, REPLs, full-screen programs, ssh, interactive wizards \u2014 goes through terminal_tabs run instead of being backgrounded in the shell tool (\`&\`, nohup, setsid): the shell would orphan the process and lose its output, while a terminal tab keeps it visible to the user and lets you keep working with it. Then terminal_wait_for for the ready line or prompt, terminal_snapshot to read the screen, terminal_act to type or send keys, and terminal_tabs close once its job is done. Each command is approved by the user and your control ends when it exits; a rejected result means stop and ask, not retry.
+
 Experience memory:
 SuperOne keeps per-target experience notes on this node: browser_memory_* (domain), computer_memory_* (platform + appId), device_memory_* (platform + appId).
 
@@ -8478,11 +8612,12 @@ Response rendering:
 - Images: use ![description](/abs/path/image.png) to display an inline image.
 - Videos: use ![description](/abs/path/video.mp4) to display an inline video player.
 - Audio: use ![description](/abs/path/audio.mp3) to display an inline audio player.
+- Several media or files in a row (screenshots, recordings, PDFs, changed sources): show them in one card with widget_show({ template: "@native/files-previewer", data: { files: [{ path, note }] } }) instead of stacking embeds or links. A single file stays inline.
 - Wrap a link or media destination in angle brackets whenever the path contains spaces or parentheses, e.g. ![screenshot](</Users/me/Library/Application Support/SuperOne/shot.png>). A bare path with spaces is not valid Markdown and renders as literal text.
 
-Show your work: embed a screenshot or recording when the user requested the capture or it directly supports a visual claim in your reply, and say what to look at. Screenshots needed to inspect content are allowed; reuse them as evidence when relevant. Omit captures that only document navigation or content extraction unless requested; ordinary reading needs no screenshot for the reply. Each file at most once per reply. Embed the user's existing media only when they ask to see or play it; otherwise link the file. For capture methods or multi-file presentation, read product/show-your-work.
+Show your work: embed a screenshot or recording when the user requested the capture or it directly supports a visual claim in your reply, and say what to look at. Screenshots needed to inspect content are allowed; reuse them as evidence when relevant. Omit captures that only document navigation or content extraction unless requested; ordinary reading needs no screenshot for the reply. Each file at most once per reply. Embed the user's existing media only when they ask to see or play it; otherwise link the file. Two or more evidence files go in one @native/files-previewer card. For capture methods, read product/show-your-work.
 
-Leave surfaces as you found them: before ending a task, close the browser tabs you opened and no longer need (browser_tabs close), release the devices you hold (device_release), and quit the desktop apps you launched (no tool needed \u2014 quit the app itself, never kill by process name). What the user had open before, or is using now, stays open.
+Leave surfaces as you found them: before ending a task, close the browser tabs you opened and no longer need (browser_tabs close), close terminal tabs you opened whose command has finished (terminal_tabs close) \u2014 a server the user asked for stays running, say so instead \u2014 release the devices you hold (device_release), and quit the desktop apps you launched (no tool needed \u2014 quit the app itself, never kill by process name). What the user had open before, or is using now, stays open.
 
 Media generated by SuperOne's generation tools is displayed automatically. Do not embed or link the result again; describe it briefly.
 
@@ -8490,6 +8625,10 @@ Session organization:
 On the first substantive user request, call session_rename as your first tool call, before answering. Always include \`tags\`: 1\u20134 short kebab-case labels; reuse existing tags from session_tag_list when they fit, or invent suitable ones. When the session's purpose is fixing an issue or reviewing a PR, add a ref tag issue-N / pr-N in addition to the labels.
 
 Rename again when the title no longer describes the task. Update tags with session_tag as needed \u2014 in particular add pr-N right after opening a PR, so later sessions on that PR can find this one. Use a short title with a verb and concrete object in the user's language, without surrounding quotes or trailing punctuation.`;
+    CLAUDE_TOOL_NAMING_APPEND = `Tool naming: SuperOne tools are named above without their server prefix. In your tool list they are mcp__superone__<name> (e.g. mcp__superone__terminal_tabs); when one is deferred, load it with ToolSearch by that full name.`;
+    CLAUDE_SYSTEM_PROMPT_APPEND = `${SUPERONE_SYSTEM_PROMPT_APPEND}
+
+${CLAUDE_TOOL_NAMING_APPEND}`;
   }
 });
 
@@ -10764,7 +10903,7 @@ function isStaticHostOwnedSuperoneToolQualified(qualifiedName) {
 function isNeverAutoAllowSuperoneBareName(bare) {
   return NEVER_AUTO_ALLOW_SUPERONE_BARE_NAMES.includes(bare);
 }
-var MCP_SUPERONE_TOOL_PREFIX, BROWSER_PRIMITIVE_TOOL_NAMES, BROWSER_ACTION_TOOL_NAMES, BROWSER_LEGACY_TOOL_NAMES, BROWSER_COMPACT_TOOL_NAMES, BROWSER_TOOL_NAMES, DEVICE_AGENT_TOOL_NAMES, BUILT_IN_SUPERONE_TOOL_NAMES, MINIAPP_LIST_BARE_NAME, MINIAPP_CALL_BARE_NAME, NEVER_AUTO_ALLOW_SUPERONE_BARE_NAMES, STATIC_HOST_OWNED_SUPERONE_QUALIFIED_TOOL_NAMES;
+var MCP_SUPERONE_TOOL_PREFIX, BROWSER_PRIMITIVE_TOOL_NAMES, BROWSER_ACTION_TOOL_NAMES, BROWSER_LEGACY_TOOL_NAMES, BROWSER_COMPACT_TOOL_NAMES, BROWSER_TOOL_NAMES, DEVICE_AGENT_TOOL_NAMES, TERMINAL_TOOL_NAMES, BUILT_IN_SUPERONE_TOOL_NAMES, MINIAPP_LIST_BARE_NAME, MINIAPP_CALL_BARE_NAME, NEVER_AUTO_ALLOW_SUPERONE_BARE_NAMES, STATIC_HOST_OWNED_SUPERONE_QUALIFIED_TOOL_NAMES;
 var init_superone_host_owned_tools = __esm({
   "../../packages/shared/src/superone-host-owned-tools.ts"() {
     "use strict";
@@ -10841,6 +10980,12 @@ var init_superone_host_owned_tools = __esm({
       "device_wait_for",
       "device_release"
     ];
+    TERMINAL_TOOL_NAMES = [
+      "terminal_tabs",
+      "terminal_snapshot",
+      "terminal_act",
+      "terminal_wait_for"
+    ];
     BUILT_IN_SUPERONE_TOOL_NAMES = [
       "browser_memory_read",
       "browser_memory_write",
@@ -10878,7 +11023,8 @@ var init_superone_host_owned_tools = __esm({
       "automation_apply",
       "automation_delete",
       ...BROWSER_TOOL_NAMES,
-      ...DEVICE_AGENT_TOOL_NAMES
+      ...DEVICE_AGENT_TOOL_NAMES,
+      ...TERMINAL_TOOL_NAMES
     ];
     MINIAPP_LIST_BARE_NAME = "miniapp_list";
     MINIAPP_CALL_BARE_NAME = "miniapp_call";
@@ -10980,6 +11126,187 @@ var init_slash_commands = __esm({
   }
 });
 
+// ../../packages/shared/src/harness/acp-brand.ts
+function isGrokAcpAgent(agentId) {
+  if (!agentId) return false;
+  const id = agentId.toLowerCase();
+  return id.includes("grok");
+}
+function isOpenCodeAcpAgent(agentId) {
+  if (!agentId) return false;
+  return agentId.toLowerCase().includes("opencode");
+}
+function resolveHarnessBrandKey(harnessId, acpAgentId) {
+  if (!harnessId) return "claude";
+  if (harnessId !== "acp") return harnessId;
+  if (isGrokAcpAgent(acpAgentId)) return "acp-grok";
+  if (isOpenCodeAcpAgent(acpAgentId)) return "acp-opencode";
+  if (acpAgentId?.trim()) {
+    const short = acpAgentId.trim().toLowerCase().replace(/-build$/, "").replace(/[^a-z0-9]+/g, "-");
+    return short ? `acp-${short}` : "acp";
+  }
+  return "acp";
+}
+function acpAgentDisplayName(agentId, catalogName) {
+  if (catalogName?.trim()) {
+    return catalogName.trim().replace(/\s+Build$/i, "");
+  }
+  if (isGrokAcpAgent(agentId)) return "Grok";
+  if (isOpenCodeAcpAgent(agentId)) return "OpenCode";
+  if (agentId?.trim()) {
+    return agentId.trim().replace(/-build$/i, "").split(/[-_]/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+  }
+  return "ACP";
+}
+var init_acp_brand = __esm({
+  "../../packages/shared/src/harness/acp-brand.ts"() {
+    "use strict";
+  }
+});
+
+// ../../packages/shared/src/harness/harness-capabilities.ts
+var HARNESS_CAPABILITIES, ALL_GOAL_LIFECYCLE_ARGS;
+var init_harness_capabilities = __esm({
+  "../../packages/shared/src/harness/harness-capabilities.ts"() {
+    "use strict";
+    init_acp_brand();
+    HARNESS_CAPABILITIES = {
+      claude: {
+        supportsMcp: true,
+        supportsPlanMode: true,
+        supportsTodos: true,
+        supportsSubagents: true,
+        supportsCompact: true,
+        supportsStreamingToolInput: true,
+        supportsQueuedSteer: true,
+        supportsQueuedSteerSoon: true,
+        // SDK `additionalDirectories`.
+        supportsAdditionalDirs: true,
+        // SDK `forkSession()` copies + remaps the transcript jsonl.
+        supportsFork: true,
+        // Built-in `/goal <condition>`: a Stop hook re-checks the condition after
+        // each turn and keeps going until it is met, so there is no paused state —
+        // the goal is either live or cleared.
+        goal: { lifecycleArgs: ["clear"], canPause: false, transport: "slash", semantics: "condition" },
+        displayName: "Claude"
+      },
+      codex: {
+        supportsMcp: true,
+        supportsPlanMode: true,
+        supportsTodos: false,
+        supportsSubagents: false,
+        supportsCompact: true,
+        supportsStreamingToolInput: false,
+        supportsQueuedSteer: true,
+        // Core's queue item either interrupts the turn or waits it out.
+        supportsQueuedSteerSoon: false,
+        // sandbox_workspace_write.writable_roots, re-sent every turn.
+        supportsAdditionalDirs: true,
+        // app-server thread fork, truncatable at a turn id.
+        supportsFork: true,
+        // `thread/goal/{get,set,clear}` over the app server; SuperOne drives the
+        // follow-up turns itself, so every transition is an explicit RPC.
+        goal: { lifecycleArgs: [], canPause: true, transport: "rpc", semantics: "objective" },
+        displayName: "Codex"
+      },
+      acp: {
+        // Host injects SuperOne MCP on every ACP session; user MCP attach is a separate gap.
+        supportsMcp: true,
+        // Agent-driven plan + x.ai/exit_plan_mode approval is shipped (not host enter-plan).
+        supportsPlanMode: true,
+        // ACP session/update plan entries map to todo_write-style UI events.
+        supportsTodos: true,
+        // Subagent_* notifications already map to task rows, but there is no nested
+        // child chrome for ACP. Keep false until Task UI can host those sessions.
+        supportsSubagents: false,
+        // Host intercepts `/compact` → `x.ai/compact_conversation`.
+        supportsCompact: true,
+        supportsStreamingToolInput: false,
+        // Mid-turn send queues; steer inserts via `x.ai/interject` (no abort).
+        // Interject has no now/next split — Claude's "soon" is a second SDK
+        // priority, which Grok does not have.
+        supportsQueuedSteer: true,
+        supportsQueuedSteerSoon: false,
+        // session/new additionalDirectories, gated per agent capability.
+        supportsAdditionalDirs: true,
+        // Cold `x.ai/session/fork` copies Grok session files; SuperOne then resumes the child.
+        supportsFork: true,
+        // Grok only — see `resolveGoalCapability`. The agent owns the loop and
+        // reports back over `goal_updated`; the host just posts `/goal …` lines.
+        goal: {
+          lifecycleArgs: ["status", "pause", "resume", "clear"],
+          canPause: true,
+          transport: "slash",
+          semantics: "objective"
+        },
+        displayName: "Others"
+      },
+      opencode: {
+        supportsMcp: true,
+        supportsPlanMode: true,
+        supportsTodos: true,
+        supportsSubagents: true,
+        supportsCompact: true,
+        supportsStreamingToolInput: false,
+        supportsQueuedSteer: false,
+        supportsQueuedSteerSoon: false,
+        // Single `directory` only.
+        supportsAdditionalDirs: false,
+        // Server-side `forkSession(id, anchor)` + `moveSession`.
+        supportsFork: true,
+        goal: null,
+        displayName: "OpenCode"
+      },
+      cursor: {
+        supportsMcp: true,
+        supportsPlanMode: true,
+        // updateTodos / task tool deltas when event map lands (PR5+)
+        supportsTodos: true,
+        supportsSubagents: true,
+        supportsCompact: false,
+        supportsStreamingToolInput: true,
+        supportsQueuedSteer: false,
+        supportsQueuedSteerSoon: false,
+        // Single cwd; multi-root parked in the harness design doc.
+        supportsAdditionalDirs: false,
+        // SDK has no transcript-fork API; the adapter creates a blank agent.
+        supportsFork: false,
+        goal: null,
+        displayName: "Cursor"
+      },
+      dsh: {
+        // In-process dsh Cordis tree (docs/draft/deepseek-harness-integration.md).
+        // Flags flip only when the corresponding event path is wired: streaming
+        // tool input → tool-call-delta mapping.
+        // `supportsCompact`: `compaction-basic` compacts automatically at context
+        // pressure and on provider overflow; `/compact` drives `compactNow()`.
+        // `supportsMcp` covers both SuperOne's own tools (native dsh rows) and
+        // third-party servers read from dsh's own profile patch layer.
+        // `supportsSubagents`: foreground delegation (`dsh-tool-subagent` over the
+        // in-process spawn provider), rendered as a Task block with the child's
+        // steps nested under it. Background and continuable children are not wired.
+        supportsMcp: true,
+        supportsPlanMode: false,
+        supportsTodos: true,
+        supportsSubagents: true,
+        supportsCompact: true,
+        supportsStreamingToolInput: false,
+        supportsQueuedSteer: false,
+        supportsQueuedSteerSoon: false,
+        // Single cwd.
+        supportsAdditionalDirs: false,
+        // `runtime.forkSession` copies the log prefix up to an event seq.
+        supportsFork: true,
+        goal: null,
+        displayName: "DeepSeek"
+      }
+    };
+    ALL_GOAL_LIFECYCLE_ARGS = [...new Set(
+      Object.values(HARNESS_CAPABILITIES).flatMap((caps) => caps.goal?.lifecycleArgs ?? [])
+    )];
+  }
+});
+
 // ../../packages/shared/src/session-goal.ts
 function sessionGoalFromClaudeActive(raw) {
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
@@ -10990,13 +11317,13 @@ function sessionGoalFromClaudeActive(raw) {
   return {
     objective: condition,
     status: "active",
-    ...typeof value.iterations === "number" && Number.isFinite(value.iterations) ? { iterations: value.iterations } : {},
     ...lastReason ? { lastReason } : {}
   };
 }
 var init_session_goal = __esm({
   "../../packages/shared/src/session-goal.ts"() {
     "use strict";
+    init_harness_capabilities();
   }
 });
 
@@ -12374,7 +12701,7 @@ function buildLiveOptions(opts, onPermission, onQuestion, onPlan, signal, timing
     systemPrompt: {
       type: "preset",
       preset: "claude_code",
-      append: [SUPERONE_SYSTEM_PROMPT_APPEND, opts.systemPromptAppend].filter(Boolean).join("\n\n"),
+      append: [CLAUDE_SYSTEM_PROMPT_APPEND, opts.systemPromptAppend].filter(Boolean).join("\n\n"),
       snapshot: false
     },
     ...opts.sessionId ? { resume: opts.sessionId } : {},
@@ -53006,7 +53333,7 @@ function tryParseJsonObject(text2) {
     }
   }
 }
-var XAI_SESSION_NOTIFICATION, XAI_SESSION_UPDATE, XAI_TASK_BACKGROUNDED, XAI_TASK_COMPLETED, XAI_MONITOR_EVENT, XAI_FOLLOW_UPS, XAI_SCHEDULED_TASK_CREATED, XAI_SCHEDULED_TASK_FIRED, XAI_SCHEDULED_TASK_DELETED, XAI_SCHEDULED_TASK_INJECT_PROMPT, XAI_MCP_ELICIT, XAI_MCP_ELICIT_COMPLETE, XAI_SETTINGS_UPDATE, XAI_SESSION_INTERJECTION, SUBAGENT_LIFECYCLE, XAI_EXT_NOTIFICATION_METHODS;
+var XAI_SESSION_NOTIFICATION, XAI_SESSION_UPDATE, XAI_TASK_BACKGROUNDED, XAI_TASK_COMPLETED, XAI_MONITOR_EVENT, XAI_FOLLOW_UPS, XAI_SCHEDULED_TASK_CREATED, XAI_SCHEDULED_TASK_FIRED, XAI_SCHEDULED_TASK_DELETED, XAI_SCHEDULED_TASK_INJECT_PROMPT, XAI_ASK_USER_QUESTION, XAI_EXIT_PLAN_MODE, XAI_MCP_ELICIT, XAI_MCP_ELICIT_COMPLETE, XAI_SETTINGS_UPDATE, XAI_SESSION_INTERJECTION, SUBAGENT_LIFECYCLE, XAI_EXT_NOTIFICATION_METHODS;
 var init_xai_state = __esm({
   "../../packages/acp/src/xai-state.ts"() {
     "use strict";
@@ -53020,6 +53347,8 @@ var init_xai_state = __esm({
     XAI_SCHEDULED_TASK_FIRED = "x.ai/scheduled_task_fired";
     XAI_SCHEDULED_TASK_DELETED = "x.ai/scheduled_task_deleted";
     XAI_SCHEDULED_TASK_INJECT_PROMPT = "x.ai/scheduled_task_inject_prompt";
+    XAI_ASK_USER_QUESTION = "x.ai/ask_user_question";
+    XAI_EXIT_PLAN_MODE = "x.ai/exit_plan_mode";
     XAI_MCP_ELICIT = "x.ai/mcp/elicit";
     XAI_MCP_ELICIT_COMPLETE = "x.ai/mcp/elicit_complete";
     XAI_SETTINGS_UPDATE = "x.ai/settings/update";
@@ -54674,6 +55003,42 @@ function grokElicitToPendingInteraction(raw) {
 function formatGrokElicitOutcome(allow) {
   return { outcome: allow ? "accept" : "cancel" };
 }
+function formatGrokAskUserCancelled() {
+  return { outcome: "cancelled" };
+}
+function formatGrokAskUserAccepted(answers) {
+  if (!answers || typeof answers !== "object" || Array.isArray(answers)) {
+    return formatGrokAskUserCancelled();
+  }
+  const record2 = answers;
+  const wrapped = record2.answers !== null && typeof record2.answers === "object" && !Array.isArray(record2.answers);
+  const source = wrapped ? record2.answers : record2;
+  const normalized = {};
+  for (const [question, value] of Object.entries(source)) {
+    if (typeof value === "string") {
+      if (value) normalized[question] = value.split(", ").map((part) => part.trim()).filter(Boolean);
+    } else if (Array.isArray(value) && value.every((part) => typeof part === "string")) {
+      normalized[question] = value;
+    } else {
+      return formatGrokAskUserCancelled();
+    }
+  }
+  if (Object.keys(normalized).length === 0) return formatGrokAskUserCancelled();
+  return {
+    outcome: "accepted",
+    answers: normalized,
+    ...wrapped && record2.annotations && typeof record2.annotations === "object" && !Array.isArray(record2.annotations) ? { annotations: record2.annotations } : {}
+  };
+}
+function formatGrokExitPlanCancelled(feedback) {
+  const trimmed = feedback?.trim();
+  return { outcome: "cancelled", ...trimmed ? { feedback: trimmed } : {} };
+}
+function formatGrokExitPlanFromDecision(decision, options) {
+  if (decision === "approve") return { outcome: "approved" };
+  const feedback = typeof options?.feedback === "string" ? options.feedback : void 0;
+  return formatGrokExitPlanCancelled(feedback);
+}
 var init_xai_elicit = __esm({
   "../../packages/acp/src/xai-elicit.ts"() {
     "use strict";
@@ -54731,7 +55096,42 @@ function createAcpAgentTurnRunner(opts = {}) {
           });
         });
       };
-      let clientBuilder = client({ name: opts.clientName ?? "superone-node" }).onRequest(XAI_MCP_ELICIT, (raw) => raw, handleElicit).onRequest(`_${XAI_MCP_ELICIT}`, (raw) => raw, handleElicit).onRequest(methods.client.session.requestPermission, async (ctx) => {
+      const handleAskUser = async (ctx) => {
+        if (!input.onQuestion) return formatGrokAskUserCancelled();
+        const raw = ctx.params && typeof ctx.params === "object" && !Array.isArray(ctx.params) ? ctx.params : {};
+        const toolCallId = typeof raw.toolCallId === "string" ? raw.toolCallId : typeof raw.tool_call_id === "string" ? raw.tool_call_id : `acp_ask_${Date.now().toString(36)}`;
+        try {
+          const answers = await input.onQuestion({
+            interactionId: toolCallId,
+            kind: "question",
+            toolUseId: toolCallId,
+            input: raw,
+            createdAt: Date.now()
+          });
+          return formatGrokAskUserAccepted(answers);
+        } catch {
+          return formatGrokAskUserCancelled();
+        }
+      };
+      const handleExitPlan = async (ctx) => {
+        if (!input.onPlan) return formatGrokExitPlanCancelled();
+        const raw = ctx.params && typeof ctx.params === "object" && !Array.isArray(ctx.params) ? ctx.params : {};
+        const toolCallId = typeof raw.toolCallId === "string" ? raw.toolCallId : typeof raw.tool_call_id === "string" ? raw.tool_call_id : `acp_plan_${Date.now().toString(36)}`;
+        const planContent = typeof raw.planContent === "string" ? raw.planContent : typeof raw.plan_content === "string" ? raw.plan_content : "";
+        try {
+          const result = await input.onPlan({
+            interactionId: toolCallId,
+            kind: "plan",
+            toolUseId: toolCallId,
+            input: { planContent, ...raw },
+            createdAt: Date.now()
+          });
+          return formatGrokExitPlanFromDecision(result.decision, result.options);
+        } catch {
+          return formatGrokExitPlanCancelled();
+        }
+      };
+      let clientBuilder = client({ name: opts.clientName ?? "superone-node" }).onRequest(XAI_MCP_ELICIT, (raw) => raw, handleElicit).onRequest(`_${XAI_MCP_ELICIT}`, (raw) => raw, handleElicit).onRequest(XAI_ASK_USER_QUESTION, (raw) => raw, handleAskUser).onRequest(`_${XAI_ASK_USER_QUESTION}`, (raw) => raw, handleAskUser).onRequest(XAI_EXIT_PLAN_MODE, (raw) => raw, handleExitPlan).onRequest(`_${XAI_EXIT_PLAN_MODE}`, (raw) => raw, handleExitPlan).onRequest(methods.client.session.requestPermission, async (ctx) => {
         const mapped = mapPermissionRequest(ctx.params);
         pendingOptions = mapped.options;
         if (!input.onPermission) {
@@ -54786,7 +55186,12 @@ function createAcpAgentTurnRunner(opts = {}) {
       await connection.agent.request(methods.agent.initialize, {
         protocolVersion: PROTOCOL_VERSION,
         clientInfo: { name: opts.clientName ?? "superone-node", version: "0.0.0" },
-        clientCapabilities: {}
+        clientCapabilities: {},
+        _meta: {
+          askUserQuestion: true,
+          exitPlanMode: true,
+          clientIdentifier: "superone"
+        }
       });
       const mcpServers = opts.getMcpServers?.(input.session.sessionId) ?? opts.mcpServers ?? [];
       const active = await connection.agent.buildSession({ cwd, mcpServers }).start();
@@ -72157,8 +72562,8 @@ import { fileURLToPath } from "node:url";
 function resolveCliReleaseVersion() {
   const fromEnv = process.env.SUPERONE_CLI_VERSION?.trim();
   if (fromEnv) return fromEnv;
-  if ("0.67.0-alpha".trim()) {
-    return "0.67.0-alpha".trim();
+  if ("0.67.0-alpha.2".trim()) {
+    return "0.67.0-alpha.2".trim();
   }
   const fromDist = readDistManifestVersion();
   if (fromDist) return fromDist;
@@ -78895,6 +79300,20 @@ var HarnessManager = class {
       diagnostic: buildHarnessDiagnostic("simulated")
     };
   }
+  getExternalLaunchConfig(id) {
+    const row = this.db.prepare("SELECT config_json FROM harness_installations WHERE harness_id = ?").get(id);
+    try {
+      const config2 = JSON.parse(row?.config_json || "{}");
+      return {
+        ...typeof config2.usesDefaultArgs === "boolean" ? { usesDefaultArgs: config2.usesDefaultArgs } : {},
+        ...typeof config2.command === "string" ? { command: config2.command } : {},
+        ...["path", "explicit"].includes(config2.commandSource) ? { commandSource: config2.commandSource } : {},
+        ...Array.isArray(config2.args) && config2.args.every((arg) => typeof arg === "string") ? { args: config2.args } : {}
+      };
+    } catch {
+      return {};
+    }
+  }
   readPersisted(id) {
     const row = this.db.prepare(
       `SELECT harness_id, enabled, state, runtime_version, command,
@@ -83797,7 +84216,7 @@ function enableDeepseek(manager) {
 function enableAcpGrok(manager, opts) {
   const defaultArgs = ["agent", "stdio"];
   const args = sanitizeHarnessArgs(opts.args.length > 0 ? opts.args : defaultArgs);
-  const resolved = resolveExternalCommand(opts.command, ["grok"]);
+  const resolved = resolveExternalCommand(opts.command, ["grok"], { preserveSymlinks: true });
   if (!resolved) {
     return manager.update("acp-grok", {
       enabled: true,
@@ -83805,7 +84224,7 @@ function enableAcpGrok(manager, opts) {
       command: null,
       diagnosticCode: "not_found",
       lastProbedAt: Date.now(),
-      configJson: JSON.stringify({ args, usesDefaultArgs: opts.args.length === 0 })
+      configJson: JSON.stringify({ commandSource: opts.command ? "explicit" : "path", command: opts.command, args, usesDefaultArgs: opts.args.length === 0 })
     });
   }
   return manager.update("acp-grok", {
@@ -83816,6 +84235,7 @@ function enableAcpGrok(manager, opts) {
     lastProbedAt: Date.now(),
     configJson: JSON.stringify({
       command: resolved,
+      commandSource: opts.command ? "explicit" : "path",
       args,
       usesDefaultArgs: opts.args.length === 0
     })
@@ -83832,7 +84252,7 @@ function requireRegularReadableFile(path) {
   accessSync2(abs, constants2.R_OK);
   return realpathSync3(abs);
 }
-function resolveExternalCommand(explicit, searchNames) {
+function resolveExternalCommand(explicit, searchNames, options = {}) {
   if (explicit) {
     const abs = isAbsolute5(explicit) ? explicit : resolve9(explicit);
     if (!existsSync33(abs)) return null;
@@ -83842,9 +84262,9 @@ function resolveExternalCommand(explicit, searchNames) {
     } catch {
       return null;
     }
-    return realpathSync3(abs);
+    return options.preserveSymlinks ? abs : realpathSync3(abs);
   }
-  const pathEnv = process.env.PATH || "";
+  const pathEnv = options.pathEnv ?? process.env.PATH ?? "";
   const dirs = pathEnv.split(process.platform === "win32" ? ";" : ":");
   for (const name of searchNames) {
     for (const dir of dirs) {
@@ -83854,7 +84274,7 @@ function resolveExternalCommand(explicit, searchNames) {
       try {
         if (!statSync12(candidate).isFile()) continue;
         accessSync2(candidate, constants2.X_OK);
-        return realpathSync3(candidate);
+        return options.preserveSymlinks ? candidate : realpathSync3(candidate);
       } catch {
       }
     }
@@ -85011,7 +85431,7 @@ var WorkspaceGitService = class {
         deletions: shortstat.deletions
       };
     } catch (err) {
-      throw Object.assign(new Error(err.message || "git status failed"), {
+      throw Object.assign(new Error(gitErrorMessage(err) || "git status failed"), {
         code: "internal"
       });
     }
@@ -85509,38 +85929,8 @@ import { createHash as createHash9, randomBytes as randomBytes5, randomUUID as r
 import { existsSync as existsSync39, statSync as statSync15 } from "node:fs";
 import { resolve as pathResolve2 } from "node:path";
 
-// ../../packages/shared/src/harness/acp-brand.ts
-function isGrokAcpAgent(agentId) {
-  if (!agentId) return false;
-  const id = agentId.toLowerCase();
-  return id.includes("grok");
-}
-function isOpenCodeAcpAgent(agentId) {
-  if (!agentId) return false;
-  return agentId.toLowerCase().includes("opencode");
-}
-function resolveHarnessBrandKey(harnessId, acpAgentId) {
-  if (!harnessId) return "claude";
-  if (harnessId !== "acp") return harnessId;
-  if (isGrokAcpAgent(acpAgentId)) return "acp-grok";
-  if (isOpenCodeAcpAgent(acpAgentId)) return "acp-opencode";
-  if (acpAgentId?.trim()) {
-    const short = acpAgentId.trim().toLowerCase().replace(/-build$/, "").replace(/[^a-z0-9]+/g, "-");
-    return short ? `acp-${short}` : "acp";
-  }
-  return "acp";
-}
-function acpAgentDisplayName(agentId, catalogName) {
-  if (catalogName?.trim()) {
-    return catalogName.trim().replace(/\s+Build$/i, "");
-  }
-  if (isGrokAcpAgent(agentId)) return "Grok";
-  if (isOpenCodeAcpAgent(agentId)) return "OpenCode";
-  if (agentId?.trim()) {
-    return agentId.trim().replace(/-build$/i, "").split(/[-_]/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
-  }
-  return "ACP";
-}
+// ../../packages/shared/src/acp-brand.ts
+init_acp_brand();
 
 // src/session/collaboration.ts
 init_resolve_service();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@super-one/cli",
-  "version": "0.67.0-alpha",
+  "version": "0.67.0-alpha.2",
   "description": "SuperOne headless node CLI — remote execution environment (RPC, workspaces, sessions).",
   "type": "module",
   "license": "BUSL-1.1",