@cabane/companion 0.6.48 → 0.6.50

package/dist/cli.js

@@ -644,40 +644,58 @@ async function ping(path) {
 }
 
 // src/harness-check.ts
-import { spawn as spawn4 } from "child_process";
+import { spawn as spawn3 } from "child_process";
 
 // src/harness-versions.ts
 import { spawn as spawn2 } from "child_process";
 var EMPTY = { claudeCode: null, opencode: null, codex: null };
+var CLI_PROBE_TIMEOUT_MS = 4e3;
 function parseVersionToken(raw) {
   if (!raw) return null;
   const m = raw.match(/\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?/);
   return m ? m[0] : null;
 }
-async function probeCliVersion(command, spawnImpl = spawn2) {
+function probeCliPresence(command, spawnImpl = spawn2) {
   return new Promise((resolve) => {
     let settled = false;
-    const done = (v) => {
+    let timer = null;
+    const done = (result) => {
       if (!settled) {
         settled = true;
-        resolve(v);
+        if (timer) clearTimeout(timer);
+        resolve(result);
       }
     };
     let child;
     try {
       child = spawnImpl(command, ["--version"], { stdio: ["ignore", "pipe", "ignore"] });
     } catch {
-      done(null);
+      done({ status: "absent" });
       return;
     }
     let out = "";
     child.stdout?.on("data", (chunk) => {
       if (out.length < 4096) out += chunk.toString();
     });
-    child.once("error", () => done(null));
-    child.once("exit", (code) => done(code === 0 ? parseVersionToken(out) : null));
+    timer = setTimeout(() => {
+      child.kill?.("SIGKILL");
+      done({ status: "unusable" });
+    }, CLI_PROBE_TIMEOUT_MS);
+    timer.unref?.();
+    child.once("error", () => done({ status: "absent" }));
+    child.once("exit", (code) => {
+      const version = code === 0 ? parseVersionToken(out) : null;
+      done(version ? { status: "present", version } : { status: "unusable" });
+    });
   });
 }
+function probeHarnessPresence(runtime, spawnImpl = spawn2) {
+  return probeCliPresence(runtime === "codex" ? "codex" : "claude", spawnImpl);
+}
+async function probeCliVersion(command, spawnImpl = spawn2) {
+  const result = await probeCliPresence(command, spawnImpl);
+  return result.status === "present" ? result.version : null;
+}
 async function probeOpencodeVersion(serverUrl, fetchImpl = fetch) {
   try {
     const base = serverUrl.endsWith("/") ? serverUrl.slice(0, -1) : serverUrl;
@@ -741,81 +759,6 @@ function buildCompanionManifest(opts) {
   return { runtimes, capabilities: { ...DEVICE_MANIFEST.capabilities } };
 }
 
-// src/prereqs.ts
-import { spawn as spawn3 } from "child_process";
-async function claudeOnPath() {
-  return new Promise((resolve) => {
-    let settled = false;
-    const child = spawn3("claude", ["--version"], { stdio: "ignore" });
-    child.once("error", () => {
-      if (!settled) {
-        settled = true;
-        resolve(false);
-      }
-    });
-    child.once("exit", (code) => {
-      if (!settled) {
-        settled = true;
-        resolve(code === 0);
-      }
-    });
-  });
-}
-var CODEX_PROBE_TIMEOUT_MS = 4e3;
-async function codexOnPath() {
-  const version = await Promise.race([
-    probeCliVersion("codex"),
-    new Promise((resolve) => {
-      const timer = setTimeout(() => resolve(null), CODEX_PROBE_TIMEOUT_MS);
-      timer.unref?.();
-    })
-  ]);
-  return version !== null;
-}
-async function requireStartConfig(deps = {}) {
-  const requireCfg = deps.requireCfg ?? requireConfig;
-  const probeClaude = deps.probeClaude ?? claudeOnPath;
-  const save2 = deps.save ?? saveConfig;
-  const cfg = requireCfg();
-  const claudeOnPathResult = await probeClaude();
-  const migrated = migrateConnectedHarnesses(cfg, claudeOnPathResult);
-  if (!migrated) return { cfg, claudeOnPath: claudeOnPathResult };
-  save2(migrated);
-  deps.onMigrated?.(migrated, claudeOnPathResult);
-  return { cfg: migrated, claudeOnPath: claudeOnPathResult };
-}
-async function warnAboutHarnessReadiness(cfg, deps = {}) {
-  const probeClaude = deps.probeClaude ?? claudeOnPath;
-  const probeCodex = deps.probeCodex ?? codexOnPath;
-  const warn = deps.warn ?? ((message) => process.stderr.write(`${message}
-`));
-  const connected = [
-    ...isClaudeCodeConnected(cfg) ? ["Claude Code"] : [],
-    ...isCodexEnabled(cfg) ? ["Codex"] : [],
-    ...cfg.opencode ? ["opencode"] : []
-  ];
-  if (connected.length > 0) {
-    if (isClaudeCodeConnected(cfg) && !await probeClaude()) {
-      warn(
-        "warning: Claude Code is connected on this device but `claude` isn\u2019t on your PATH, so it advertises nothing and a Claude-model agent won\u2019t be routed here. Install it (`npm i -g @anthropic-ai/claude-code`) and log in, or disconnect it."
-      );
-    }
-    return;
-  }
-  const [claudeInstalled, codexInstalled] = await Promise.all([probeClaude(), probeCodex()]);
-  const installed = [
-    ...claudeInstalled ? ["Claude Code"] : [],
-    ...codexInstalled ? ["Codex"] : []
-  ];
-  const connectCommands = [
-    ...claudeInstalled ? ["`cabane-companion connect claude-code`"] : [],
-    ...codexInstalled ? ["`cabane-companion connect codex`"] : []
-  ];
-  warn(
-    "No harness is connected on this device yet, so no agent turn can run here. " + (installed.length > 0 ? `We found ${installed.join(" and ")} on this machine \u2014 connect ${installed.length > 1 ? "one with " : "it with "}${connectCommands.join(" or ")} and turns start routing here.` : "Install a harness and sign in \u2014 Claude Code (`npm i -g @anthropic-ai/claude-code`), the Codex CLI (`codex login`), or `opencode serve` \u2014 then connect it with `cabane-companion connect <harness>` (pass `--url <url>` for opencode).")
-  );
-}
-
 // src/harness-status.ts
 var HARNESS_LABELS = {
   "claude-code": "Claude Code",
@@ -976,20 +919,19 @@ async function resolveOpencodeServerUrl(configuredServerUrl, requestedServerUrl,
   return await probeDefault() !== null ? DEFAULT_OPENCODE_SERVER_URL : null;
 }
 async function probeHarnessSignals(cfg, deps = {}) {
-  const probeClaudePresence = deps.probeClaudePresence ?? claudeOnPath;
-  const probeClaudeVersion = deps.probeClaudeVersion ?? (() => probeCliVersion("claude"));
-  const probeCodexVersion = deps.probeCodexVersion ?? (() => probeCliVersion("codex"));
+  const probePresence = deps.probePresence ?? probeHarnessPresence;
   const probeOpencode = deps.probeOpencode ?? ((url) => probeOpencodeVersion(url));
   const configuredServerUrl = cfg.opencode?.serverUrl;
   const opencodeProbeUrl = configuredServerUrl ?? DEFAULT_OPENCODE_SERVER_URL;
-  const [claudeOnPathResult, claudeVersion, codexVersion, opencodeVersion] = await Promise.all([
-    withTimeout(probeClaudePresence(), false),
-    withTimeout(probeClaudeVersion(), null),
-    withTimeout(probeCodexVersion(), null),
+  const [claudePresence, codexPresence, opencodeVersion] = await Promise.all([
+    deps.presence?.["claude-code"] ?? withTimeout(probePresence("claude-code"), { status: "absent" }),
+    deps.presence?.codex ?? withTimeout(probePresence("codex"), { status: "absent" }),
     configuredServerUrl ? withTimeout(probeOpencode(opencodeProbeUrl), null) : probeDefaultOpencodeVersion(probeOpencode)
   ]);
+  const claudeVersion = claudePresence.status === "present" ? claudePresence.version : null;
+  const codexVersion = codexPresence.status === "present" ? codexPresence.version : null;
   return {
-    claudeOnPath: claudeOnPathResult,
+    claudeOnPath: claudePresence.status === "present",
     claudeVersion,
     // CT1082: the user's opt-in. Presence alone exposes nothing now, so this is
     // the manifest gate and the probe above is only a suggestion.
@@ -1041,16 +983,13 @@ async function shakeOutHarness(runtime, cfg, deps = {}) {
       if (!url) return "absent";
       return await probeOpencode(url) !== null ? "ok" : "failed";
     }
-    const { auth, presence } = runtime === "codex" ? {
-      auth: ["codex", ["login", "status"]],
-      presence: ["codex", ["--version"]]
+    const { auth } = runtime === "codex" ? {
+      auth: ["codex", ["login", "status"]]
     } : {
-      auth: ["claude", ["auth", "status"]],
-      presence: ["claude", ["--version"]]
+      auth: ["claude", ["auth", "status"]]
     };
-    const presenceRun = await run(presence[0], [...presence[1]]);
-    if (presenceRun.error === "spawn") return "absent";
-    if (presenceRun.code !== 0) return "unverified";
+    const presence = deps.presence ?? await (deps.probePresence ?? probeHarnessPresence)(runtime);
+    if (presence.status !== "present") return presence.status;
     const authRun = await run(auth[0], [...auth[1]]);
     if (authRun.code === 0) return "ok";
     if (looksUnsupported(authRun.output)) {
@@ -1062,7 +1001,9 @@ async function shakeOutHarness(runtime, cfg, deps = {}) {
   }
 }
 function connectedLine(runtime, verdict) {
-  if (verdict === "absent") throw new Error("an absent harness cannot be connected");
+  if (verdict === "absent" || verdict === "unusable") {
+    throw new Error("an unavailable harness cannot be connected");
+  }
   const label = HARNESS_LABELS[runtime];
   if (verdict !== "failed") return `${label} connected.`;
   return `${label} connected \u2014 ${FAILED_SUFFIX[runtime]}`;
@@ -1072,13 +1013,18 @@ var FAILED_SUFFIX = {
   codex: "it doesn\u2019t look signed in yet. Run `codex login` once, then it\u2019s ready.",
   opencode: "its server isn\u2019t answering. Start `opencode serve`, then it\u2019s ready."
 };
-function absentLine(runtime) {
+function presenceReason(runtime, status2) {
   if (runtime === "opencode") {
     return "No opencode server is configured \u2014 run `opencode serve` and connect with `--url`.";
   }
   const label = HARNESS_LABELS[runtime];
-  const login = runtime === "codex" ? "`codex login`" : "`claude`";
-  return `${label} isn\u2019t installed on this machine \u2014 install it and sign in (${login}), then run this again.`;
+  return status2 === "absent" ? `${label} isn't installed on this machine.` : `${label} is installed here but didn't report a version Cabane can read.`;
+}
+var CLI_PRESENCE_ACTION = "Install it and run this again.";
+var DASHBOARD_PRESENCE_ACTION = "Install it, then refresh.";
+function presenceRefusal(runtime, status2, action) {
+  const reason = presenceReason(runtime, status2);
+  return runtime === "opencode" ? reason : `${reason} ${action}`;
 }
 function looksUnsupported(output) {
   return /unrecognized|unknown (sub)?command|unexpected argument|invalid (sub)?command|no such (sub)?command|usage:|did you mean/i.test(
@@ -1096,7 +1042,7 @@ function runBounded(command, args) {
     };
     let child;
     try {
-      child = spawn4(command, args, { stdio: ["ignore", "pipe", "pipe"] });
+      child = spawn3(command, args, { stdio: ["ignore", "pipe", "pipe"] });
     } catch {
       resolve({ code: null, output: "", error: "spawn" });
       return;
@@ -1299,18 +1245,31 @@ async function confirm(question) {
 }
 
 // src/commands/connect.ts
-async function connect2(raw, opts = {}) {
+async function connect2(raw, opts = {}, deps = {}) {
   const runtime = parseHarnessRuntime(raw);
   if (!runtime) {
     throw new CompanionError(
       `unknown harness "${raw}". Connectable harnesses are: claude-code, codex, opencode.`
     );
   }
-  const live = await liveSocket();
+  const loadConfig2 = deps.loadConfig ?? requireConfig;
+  const request = deps.request ?? controlRequest;
+  const save2 = deps.save ?? saveConfig;
+  const output = deps.output ?? write;
+  const probePresence = deps.probePresence ?? probeHarnessPresence;
+  const shakeOut = deps.shakeOut ?? shakeOutHarness;
+  const resolveServerUrl = deps.resolveServerUrl ?? resolveOpencodeServerUrl;
+  const probeOpencode = deps.probeOpencode ?? probeOpencodeVersion;
+  const cfg = loadConfig2();
+  if (!opts.serverUrl?.trim() && alreadyConnected(runtime, cfg)) {
+    output(`${INDENT}${HARNESS_LABELS[runtime]} is already connected on this device.`);
+    return;
+  }
+  const live = await (deps.findLiveSocket ?? liveSocket)();
   if (live) {
     let result;
     try {
-      result = await controlRequest(
+      result = await request(
         live,
         {
           cmd: "connect",
@@ -1326,42 +1285,38 @@ async function connect2(raw, opts = {}) {
       );
     }
     if (!result.ok) throw new CompanionError(result.message);
-    write(INDENT + tick(result.message));
-    return;
-  }
-  const cfg = requireConfig();
-  if (alreadyConnected(runtime, cfg)) {
-    write(`${INDENT}${HARNESS_LABELS[runtime]} is already connected on this device.`);
+    output(INDENT + tick(result.message));
     return;
   }
-  if (runtime === "claude-code" && !await claudeOnPath()) {
-    throw new CompanionError(
-      "Couldn\u2019t find `claude` on this machine\u2019s PATH. Install Claude Code (`npm i -g @anthropic-ai/claude-code`) and sign in, then connect it."
-    );
-  }
   let next = cfg;
+  const presence = runtime === "opencode" ? void 0 : await probePresence(runtime);
+  if (presence && presence.status !== "present") {
+    throw new CompanionError(presenceRefusal(runtime, presence.status, CLI_PRESENCE_ACTION));
+  }
   if (runtime === "claude-code") next = { ...cfg, claudeCode: { enabled: true } };
   else if (runtime === "codex") next = { ...cfg, codex: { enabled: true } };
   else {
     const requestedServerUrl = opts.serverUrl?.trim();
-    const serverUrl = await resolveOpencodeServerUrl(void 0, requestedServerUrl);
+    const serverUrl = await resolveServerUrl(cfg.opencode?.serverUrl, requestedServerUrl);
     if (!serverUrl) {
       throw new CompanionError(
         "opencode is addressed by URL \u2014 pass it: `cabane-companion connect opencode --url http://127.0.0.1:4096`."
       );
     }
-    if (requestedServerUrl && await probeOpencodeVersion(serverUrl) === null) {
+    if (requestedServerUrl && await probeOpencode(serverUrl) === null) {
       throw new CompanionError(
         `Couldn\u2019t reach an opencode server at ${serverUrl}. Start \`opencode serve\` and check the URL.`
       );
     }
     next = { ...cfg, opencode: { serverUrl } };
   }
-  const verdict = await shakeOutHarness(runtime, next);
-  if (verdict === "absent") throw new CompanionError(absentLine(runtime));
-  saveConfig(next);
-  write(INDENT + tick(connectedLine(runtime, verdict)));
-  write(`${INDENT}Not running yet \u2014 start it with: cabane-companion start`);
+  const verdict = await shakeOut(runtime, next, { ...presence ? { presence } : {} });
+  if (verdict === "absent" || verdict === "unusable") {
+    throw new CompanionError(presenceRefusal(runtime, verdict, CLI_PRESENCE_ACTION));
+  }
+  save2(next);
+  output(INDENT + tick(connectedLine(runtime, verdict)));
+  output(`${INDENT}Not running yet \u2014 start it with: cabane-companion start`);
 }
 async function liveSocket() {
   const state = readLiveRuntimeState();
@@ -2082,12 +2037,18 @@ function registerRoutes(app, deps) {
     const runtime = body.runtime;
     if (runtime === "claude-code") {
       const result = await supervisor.enableHarness({ runtime: "claude-code" });
-      if (!result.ok) return c.json({ error: result.error }, 400);
+      if (!result.ok) {
+        const error = result.presence ? `${result.error} ${DASHBOARD_PRESENCE_ACTION}` : result.error;
+        return c.json({ error }, 400);
+      }
       return c.json({ ok: true, status: hub.statusJson() });
     }
     if (runtime === "codex") {
       const result = await supervisor.enableHarness({ runtime: "codex" });
-      if (!result.ok) return c.json({ error: result.error }, 400);
+      if (!result.ok) {
+        const error = result.presence ? `${result.error} ${DASHBOARD_PRESENCE_ACTION}` : result.error;
+        return c.json({ error }, 400);
+      }
       return c.json({ ok: true, status: hub.statusJson() });
     }
     if (runtime === "opencode") {
@@ -2246,6 +2207,57 @@ function resolveStaticDir() {
   return join7(dirname4(fileURLToPath(import.meta.url)), "static");
 }
 
+// src/prereqs.ts
+async function claudeOnPath() {
+  return (await probeHarnessPresence("claude-code")).status === "present";
+}
+async function codexOnPath() {
+  return (await probeHarnessPresence("codex")).status === "present";
+}
+async function requireStartConfig(deps = {}) {
+  const requireCfg = deps.requireCfg ?? requireConfig;
+  const probeClaude = deps.probeClaude ?? claudeOnPath;
+  const save2 = deps.save ?? saveConfig;
+  const cfg = requireCfg();
+  const claudeOnPathResult = await probeClaude();
+  const migrated = migrateConnectedHarnesses(cfg, claudeOnPathResult);
+  if (!migrated) return { cfg, claudeOnPath: claudeOnPathResult };
+  save2(migrated);
+  deps.onMigrated?.(migrated, claudeOnPathResult);
+  return { cfg: migrated, claudeOnPath: claudeOnPathResult };
+}
+async function warnAboutHarnessReadiness(cfg, deps = {}) {
+  const probeClaude = deps.probeClaude ?? claudeOnPath;
+  const probeCodex = deps.probeCodex ?? codexOnPath;
+  const warn = deps.warn ?? ((message) => process.stderr.write(`${message}
+`));
+  const connected = [
+    ...isClaudeCodeConnected(cfg) ? ["Claude Code"] : [],
+    ...isCodexEnabled(cfg) ? ["Codex"] : [],
+    ...cfg.opencode ? ["opencode"] : []
+  ];
+  if (connected.length > 0) {
+    if (isClaudeCodeConnected(cfg) && !await probeClaude()) {
+      warn(
+        "warning: Claude Code is connected on this device but `claude` isn\u2019t on your PATH, so it advertises nothing and a Claude-model agent won\u2019t be routed here. Install it (`npm i -g @anthropic-ai/claude-code`) and log in, or disconnect it."
+      );
+    }
+    return;
+  }
+  const [claudeInstalled, codexInstalled] = await Promise.all([probeClaude(), probeCodex()]);
+  const installed = [
+    ...claudeInstalled ? ["Claude Code"] : [],
+    ...codexInstalled ? ["Codex"] : []
+  ];
+  const connectCommands = [
+    ...claudeInstalled ? ["`cabane-companion connect claude-code`"] : [],
+    ...codexInstalled ? ["`cabane-companion connect codex`"] : []
+  ];
+  warn(
+    "No harness is connected on this device yet, so no agent turn can run here. " + (installed.length > 0 ? `We found ${installed.join(" and ")} on this machine \u2014 connect ${installed.length > 1 ? "one with " : "it with "}${connectCommands.join(" or ")} and turns start routing here.` : "Install a harness and sign in \u2014 Claude Code (`npm i -g @anthropic-ai/claude-code`), the Codex CLI (`codex login`), or `opencode serve` \u2014 then connect it with `cabane-companion connect <harness>` (pass `--url <url>` for opencode).")
+  );
+}
+
 // src/api.ts
 var RETRY_BACKOFF_MS = [250, 750];
 var ACTIVE_RUN_OUTBOX_SEQ = 0;
@@ -3599,7 +3611,7 @@ var TurnPump = class {
     };
   }
   opts;
-  // `finalEmitted` gates the end-of-turn empty-final promotion;
+  // `finalEmitted` gates the end-of-turn progress promotion;
   // `lastProgressBody` is what we promote to `final` when a clean turn ended on
   // a tool call with no closing text.
   emittedFinal = false;
@@ -3614,28 +3626,28 @@ var TurnPump = class {
   // frozen committer test — drive. Each callback applies the choreography and
   // commits through the injected sink.
   sink;
-  // End-of-turn empty-final promotion. A clean turn that ended on a tool call
-  // with no closing text still needs exactly one `final` row (so the user gets
-  // one notification and the drawer closes the turn). Promote the last progress
-  // body when we have one (the drawer collapses the dup), else the host's
-  // minimal note. Skipped when cancelled or already final. The held-text flush
-  // that precedes it is a classification concern, driven by the caller before
-  // this runs.
+  // End-of-turn progress promotion. A clean turn that emitted interim text but
+  // no closing text promotes the agent's own last progress body (the drawer
+  // collapses the duplicate). If the agent emitted no words, emit no message:
+  // Cabane never attributes host-authored text to an agent, in any turn shape,
+  // for any reason. The host closes that wordless turn with a marker instead.
+  // Skipped when cancelled or already final. The held-text flush that precedes
+  // this is a classification concern, driven by the caller before this runs.
   async finalize(ok) {
-    if (!ok || this.opts.signal.aborted || this.emittedFinal) return;
-    const body = this.lastProgressBody ?? this.opts.emptyFinalBody;
+    if (!ok || this.opts.signal.aborted || this.emittedFinal || !this.lastProgressBody) return;
+    const body = this.lastProgressBody;
     const seq = this.opts.nextSeq();
     try {
       await this.opts.commit.commitMessage({ body, kind: "final", seq });
       this.emittedFinal = true;
       this.finalReplyBody = body;
-      this.emittedFinalSource = this.lastProgressBody ? "progress_promotion" : "host_fallback";
+      this.emittedFinalSource = "progress_promotion";
     } catch (err) {
-      this.opts.onError?.(err, "empty-final");
+      this.opts.onError?.(err, "progress-promotion");
     }
   }
   // Whether the turn has committed its `final` row — read by the host to decide
-  // whether the empty-final path or a marker is owed.
+  // whether a marker is owed.
   get finalEmitted() {
     return this.emittedFinal;
   }
@@ -7274,7 +7286,6 @@ function pruneOld(dir2, retain) {
 }
 
 // src/turn-committer.ts
-var EMPTY_FINAL_BODY = "Done \u2014 see the changes above.";
 var TurnCommitter = class {
   constructor(deps) {
     this.deps = deps;
@@ -7295,9 +7306,7 @@ var TurnCommitter = class {
             turnId: deps.turnId,
             seq,
             parentMessageId: deps.parentMessageId,
-            ...kind === "final" ? this.summonField() : {},
-            ...kind === "final" ? this.askField() : {},
-            ...kind === "final" ? this.wakeField() : {}
+            ...kind === "final" ? this.turnControlFields() : {}
           },
           deps.signal
         );
@@ -7344,11 +7353,10 @@ var TurnCommitter = class {
       commit,
       signal: deps.signal,
       nextSeq: deps.nextSeq,
-      emptyFinalBody: EMPTY_FINAL_BODY,
       onError: (err) => {
         deps.log.warn(
           { err: err instanceof Error ? err.message : String(err) },
-          "dispatcher: empty-final commit failed"
+          "dispatcher: progress-promotion commit failed"
         );
       }
     });
@@ -7374,11 +7382,11 @@ var TurnCommitter = class {
       this.onError(err, event.type);
     }
   }
-  // End-of-turn empty-final promotion. The held-text flush is now the adapter's
+  // End-of-turn progress promotion. The held-text flush is now the adapter's
   // job (it emits the closing reply as a `text` event before `result`), so this
-  // only runs the pump's empty-final: a clean turn that ended on a tool call with
-  // no closing text still gets exactly one `final`. Guards on the abort signal, so
-  // on cancel no `final` is forced.
+  // only asks the pump to promote agent-authored interim text. A wordless turn
+  // stays wordless and the dispatcher closes it with a marker. Guards on the
+  // abort signal, so on cancel no `final` is forced.
   async finalize(okResult) {
     await this.pump.finalize(okResult);
   }
@@ -7389,6 +7397,19 @@ var TurnCommitter = class {
   get finalSource() {
     return this.pump.finalSource;
   }
+  get finalEmitted() {
+    return this.pump.finalEmitted;
+  }
+  // A closing textual reply and a wordless terminal marker carry the same
+  // per-turn control state. Keep this one projection so ask/wake/summon cannot
+  // silently diverge when the agent ends without words.
+  turnControlFields() {
+    return {
+      ...this.summonField(),
+      ...this.askField(),
+      ...this.wakeField()
+    };
+  }
   // CT183: resolve the in-thread summon into the `dispatch` field for a `final`
   // commit. A self-target is stripped here (mirror of the in-app self-strip); the
   // server strips it again and resolves / ignores an unknown id.
@@ -7617,6 +7638,7 @@ var STOPPED_MARKER_BODY = "(stopped)";
 var RUNTIME_UNAVAILABLE_PREFIX = "**This agent's runtime isn't available on this companion.** The model this agent uses needs a runtime this device isn't running, so I can't run this turn here. Details:";
 var UNEXPECTED_ROLE_REASON = `refused the wake trigger (role "system" isn't dispatchable on this companion) \u2014 the companion is likely running outdated code; refresh it, then re-address the agent`;
 var SKIPPED_MARKER_BODY = "(skipped)";
+var SILENT_MARKER_BODY = "(no reply)";
 var DEFAULT_PREPARING_ROW_DELAY_MS = 1500;
 var DEFAULT_AGENT_IDLE_TIMEOUT_MS = 10 * 6e4;
 var DEFAULT_AGENT_TOTAL_TIMEOUT_MS = 6 * 60 * 6e4;
@@ -8274,6 +8296,7 @@ ${reason}`,
     let contentBearingEvents = 0;
     let latestSessionState = request.session;
     let settledDiagnostics = null;
+    let silentMarkerEmitted = false;
     const committer = new TurnCommitter({
       api: this.opts.api,
       workspaceId,
@@ -8465,6 +8488,27 @@ ${reason}`,
         }
       } else {
         await committer.finalize(okResult);
+        if (!abortController.signal.aborted && okResult && !committer.finalEmitted) {
+          try {
+            await this.opts.api.postTurnMessage(workspaceId, payload.conversationId, {
+              body: SILENT_MARKER_BODY,
+              kind: "silent",
+              turnId,
+              seq: nextSeq(),
+              parentMessageId: payload.messageId,
+              // ask, wake and summon must survive a wordless turn exactly as
+              // they survive a textual final; dropping one can strand a person
+              // or the next actor with no visible failure.
+              ...committer.turnControlFields()
+            });
+            silentMarkerEmitted = true;
+          } catch (err) {
+            turnLog.warn(
+              { err: err instanceof Error ? err.message : String(err) },
+              "dispatcher: silent-marker commit failed"
+            );
+          }
+        }
       }
     } catch (err) {
       okResult = false;
@@ -8555,7 +8599,7 @@ ${reason}`,
         sessionFingerprint: fingerprintSessionState(latestSessionState),
         eventCounts,
         runtimeResultKind,
-        finalSource: outcome === "skipped" || outcome === "cancelled" ? "marker" : committer.finalSource
+        finalSource: outcome === "skipped" || outcome === "cancelled" || silentMarkerEmitted ? "marker" : committer.finalSource
       };
       body.diagnostics = settledDiagnostics;
       if (diagnosticReason && !["usage_capped", "rate_limited", "auth_expired", "cancelled", "skipped"].includes(
@@ -9033,11 +9077,9 @@ var CompanionSupervisor = class {
   // can never disagree with what the manifest advertises. Null until the first
   // probe (the heartbeat then falls back to the boot `claudeCode`).
   harnessSignals = null;
-  // CT1082: the fresh PATH probe the claude-code connect vets with. Deliberately
-  // NOT the cached beat signal — someone connecting right after installing Claude
-  // Code shouldn't be refused by a snapshot up to a heartbeat old.
-  probeClaudePresence;
-  probeCodexPresence;
+  // Fresh per attempt, never the cached heartbeat signal: installing a harness
+  // between attempts must be observed immediately.
+  probePresence;
   exitFn;
   reexecFn;
   dispatcherFactory;
@@ -9069,8 +9111,7 @@ var CompanionSupervisor = class {
     this.log = opts.log;
     this.hub = opts.hub;
     this.claudeCode = opts.claudeCode ?? true;
-    this.probeClaudePresence = opts.probeClaudePresence ?? claudeOnPath;
-    this.probeCodexPresence = opts.probeCodexPresence ?? codexOnPath;
+    this.probePresence = opts.probePresence ?? probeHarnessPresence;
     this.harnessVersions = opts.harnessVersions ?? emptyHarnessVersions();
     this.exitFn = opts.exit ?? ((code) => process.exit(code));
     this.reexecFn = opts.reexec ?? defaultReexec;
@@ -9768,10 +9809,11 @@ var CompanionSupervisor = class {
   // over SSE). Fail-soft by construction — `probeHarnessSignals` never throws — but
   // wrapped anyway so a harness refresh can never take a heartbeat down. Called on
   // the heartbeat cadence (fresh presence for the manifest + UI) and on demand.
-  async refreshHarnessStatuses() {
+  async refreshHarnessStatuses(presence = {}) {
     try {
       const signals = await probeHarnessSignals(this.config, {
-        probeClaudePresence: this.probeClaudePresence
+        probePresence: this.probePresence,
+        presence
       });
       this.harnessSignals = signals;
       this.harnessVersions = {
@@ -9828,18 +9870,24 @@ var CompanionSupervisor = class {
   // reachable/valid input).
   async enableHarness(input) {
     let next;
+    let checkedPresence = null;
     if (input.runtime === "claude-code") {
-      if (!await this.probeClaudePresence()) {
+      const presence = input.presence ?? await this.probePresence("claude-code");
+      if (presence.status !== "present") {
         return {
           ok: false,
-          error: "Couldn\u2019t find `claude` on this machine\u2019s PATH. Install Claude Code (`npm i -g @anthropic-ai/claude-code`) and sign in, then connect it."
+          error: presenceReason("claude-code", presence.status),
+          presence: true
         };
       }
+      checkedPresence = { runtime: "claude-code", result: presence };
       next = { ...this.config, claudeCode: { enabled: true } };
     } else if (input.runtime === "codex") {
-      if (!await this.probeCodexPresence()) {
-        return { ok: false, error: absentLine("codex") };
+      const presence = input.presence ?? await this.probePresence("codex");
+      if (presence.status !== "present") {
+        return { ok: false, error: presenceReason("codex", presence.status), presence: true };
       }
+      checkedPresence = { runtime: "codex", result: presence };
       next = { ...this.config, codex: { enabled: true } };
     } else {
       const serverUrl = input.serverUrl.trim();
@@ -9863,7 +9911,9 @@ var CompanionSupervisor = class {
     this.config = next;
     saveConfig(next);
     this.rebuildDispatchers();
-    await this.refreshHarnessStatuses();
+    await this.refreshHarnessStatuses(
+      checkedPresence ? { [checkedPresence.runtime]: checkedPresence.result } : {}
+    );
     this.kickHeartbeat();
     return { ok: true };
   }
@@ -9927,9 +9977,9 @@ async function waitForBoundedHeartbeat(heartbeat) {
 }
 function defaultReexec() {
   clearRuntimeState();
-  void import("child_process").then(({ spawn: spawn6 }) => {
+  void import("child_process").then(({ spawn: spawn5 }) => {
     try {
-      const child = spawn6(process.execPath, process.argv.slice(1), {
+      const child = spawn5(process.execPath, process.argv.slice(1), {
         stdio: "inherit",
         detached: false
       });
@@ -10092,10 +10142,15 @@ async function createCompanionRuntime(opts = {}) {
     const currentConfig = supervisor.currentConfig();
     const resolvedServerUrl = runtime === "opencode" ? await resolveOpencodeServerUrl(currentConfig.opencode?.serverUrl, serverUrl) : null;
     const candidate = runtime === "opencode" ? { ...currentConfig, opencode: { serverUrl: resolvedServerUrl ?? "" } } : currentConfig;
-    const verdict = await shakeOutHarness(runtime, candidate);
-    if (verdict === "absent") return { ok: false, error: absentLine(runtime) };
+    const presence = runtime === "opencode" ? void 0 : await probeHarnessPresence(runtime);
+    const verdict = await shakeOutHarness(runtime, candidate, {
+      ...presence ? { presence } : {}
+    });
+    if (verdict === "absent" || verdict === "unusable") {
+      return { ok: false, error: presenceRefusal(runtime, verdict, CLI_PRESENCE_ACTION) };
+    }
     const result = await supervisor.enableHarness(
-      runtime === "opencode" ? { runtime: "opencode", serverUrl: resolvedServerUrl ?? "" } : { runtime }
+      runtime === "opencode" ? { runtime: "opencode", serverUrl: resolvedServerUrl ?? "" } : { runtime, presence }
     );
     if (!result.ok) return { ok: false, error: result.error };
     return { ok: true, message: connectedLine(runtime, verdict) };
@@ -10160,7 +10215,7 @@ async function closeSurfaces(control, dashboard) {
 }
 
 // src/commands/daemon.ts
-import { spawn as spawn5 } from "child_process";
+import { spawn as spawn4 } from "child_process";
 import { closeSync as closeSync3, mkdirSync as mkdirSync13, openSync as openSync3 } from "fs";
 
 // src/cli-entry.ts
@@ -10267,7 +10322,7 @@ function defaultSpawnDetached(args) {
   mkdirSync13(cabaneDir(), { recursive: true });
   const logFd = openSync3(companionLogPath(), "a");
   try {
-    return spawn5(process.execPath, [cliPath, ...args], {
+    return spawn4(process.execPath, [cliPath, ...args], {
       detached: true,
       stdio: ["ignore", logFd, logFd],
       env: { ...process.env, CABANE_COMPANION_DAEMON: "1" }
@@ -10365,14 +10420,15 @@ function reportAlreadyRunning(pid) {
   write("Connect a harness to the running companion: cabane-companion connect claude-code");
 }
 async function collectHarnessChoices(interactive) {
-  const [claudePresent, claudeVersion, codexVersion, opencodeVersion] = await Promise.all([
-    claudeOnPath().catch(() => false),
-    probeCliVersion("claude").catch(() => null),
-    probeCliVersion("codex").catch(() => null),
+  const [claudePresence, codexPresence, opencodeVersion] = await Promise.all([
+    probeHarnessPresence("claude-code").catch(() => ({ status: "absent" })),
+    probeHarnessPresence("codex").catch(() => ({ status: "absent" })),
     probeDefaultOpencodeVersion()
   ]);
+  const claudeVersion = claudePresence.status === "present" ? claudePresence.version : null;
+  const codexVersion = codexPresence.status === "present" ? codexPresence.version : null;
   const found = [
-    ...claudePresent ? [{ runtime: "claude-code", version: claudeVersion }] : [],
+    ...claudeVersion ? [{ runtime: "claude-code", version: claudeVersion }] : [],
     ...codexVersion ? [{ runtime: "codex", version: codexVersion }] : [],
     ...opencodeVersion ? [
       {