@super-one/cli 0.67.0-alpha.1 → 0.67.0-alpha.3

package/MANIFEST.json

@@ -1,7 +1,7 @@
 {
   "name": "@super-one/cli",
-  "version": "0.67.0-alpha.1",
+  "version": "0.67.0-alpha.3",
   "kind": "npm",
   "minNodeMajor": 20,
-  "builtAt": "2026-09-16T03:50:48.772Z"
+  "builtAt": "2026-09-17T01:36:23.606Z"
 }

package/lib/cli.mjs

@@ -400,7 +400,7 @@ 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 terminal tabs in the activity panel for processes that outlive one command or need input: dev servers, watch modes, REPLs, TUIs, ssh, wizards. One-shot commands (build, test, git) belong in your shell tool. action=list (default) returns a TOON table: tab / title / cwd / status / foreground / control. action=run asks the user to approve `command`, types it into a new (or a given 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 \u2014 never one the user is using. Follow up with terminal_act / terminal_wait_for / terminal_snapshot on the tab id.";
+    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.";
@@ -3670,6 +3670,10 @@ var init_host_action_terminal_descriptors = __esm({
               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: {
@@ -11122,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;
@@ -11132,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();
   }
 });
 
@@ -53148,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";
@@ -53162,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";
@@ -54816,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";
@@ -54873,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) {
@@ -54928,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();
@@ -72299,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.1".trim()) {
-    return "0.67.0-alpha.1".trim();
+  if ("0.67.0-alpha.3".trim()) {
+    return "0.67.0-alpha.3".trim();
   }
   const fromDist = readDistManifestVersion();
   if (fromDist) return fromDist;
@@ -79037,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,
@@ -83939,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,
@@ -83947,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", {
@@ -83958,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
     })
@@ -83974,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;
@@ -83984,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) {
@@ -83996,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 {
       }
     }
@@ -85651,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.1",
+  "version": "0.67.0-alpha.3",
   "description": "SuperOne headless node CLI — remote execution environment (RPC, workspaces, sessions).",
   "type": "module",
   "license": "BUSL-1.1",