@cabane/companion 0.6.209 → 0.6.211

package/README.md

@@ -4,9 +4,9 @@ The Cabane Companion runs your Cabane agents on a device you choose. It receives
 
 It uses **Claude Code**, **Codex** or **OpenCode**. The package includes Claude Code and Codex execution binaries, but setup does not run a vendor CLI installer or sign you in. OpenCode needs its own running server.
 
-Start with [Introduction to the Companion](https://cabane.ai/docs/what-the-companion-does), then [Mac setup](https://cabane.ai/docs/on-a-mac), [Windows setup](https://cabane.ai/docs/on-windows) or [Server and VPS setup](https://cabane.ai/docs/on-a-server). [FAQ and Help](https://cabane.ai/docs/faq) covers sign-in and troubleshooting. This README is the device-side reference: commands, configuration and local state.
+Start with [Introduction to the Companion](https://cabane.ai/docs/introduction-to-the-companion), then [Mac setup](https://cabane.ai/docs/mac-setup), [Windows setup](https://cabane.ai/docs/windows-setup) or [Server and VPS setup](https://cabane.ai/docs/server-and-vps-setup). [FAQ and Help](https://cabane.ai/docs/faq-and-help) covers sign-in and troubleshooting. This README is the device-side reference: commands, configuration and local state.
 
-Pairing supplies a device token, not your Cabane password or a full-account token. The device token is for this device's assignments and liveness; assigned agents receive workspace-bound credentials. The [trust guide](https://cabane.ai/docs/what-the-companion-does) explains the layers, records and access.
+Pairing supplies a device token, not your Cabane password or a full-account token. The device token is for this device's assignments and liveness; assigned agents receive workspace-bound credentials. The [trust guide](https://cabane.ai/docs/introduction-to-the-companion) explains the layers, records and access.
 
 ## Install
 
@@ -24,7 +24,7 @@ npm i -g @cabane/companion && cabane setup CODE
 
 `cabane setup CODE` pairs the device to your account and joins it to that workspace. From an interactive terminal, setup starts the Companion in the background, waits for its first check-in and reports the device's state. Without an interactive terminal, setup can stay attached to the running Companion. The same line on a device that is already paired joins it to the workspace and mints nothing.
 
-If no harness is usable, interactive setup asks which one you want to set up. Follow the complete CLI installation and sign-in steps for [Mac setup](https://cabane.ai/docs/on-a-mac#3-sign-in-inside-the-environment), [Windows setup](https://cabane.ai/docs/on-windows#3-sign-in-inside-the-environment) or [Server and VPS setup](https://cabane.ai/docs/on-a-server#3-sign-in-without-a-browser), then check `cabane status`.
+If no harness is usable, interactive setup asks which one you want to set up. Follow the complete CLI installation and sign-in steps for [Mac setup](https://cabane.ai/docs/mac-setup#2-sign-in), [Windows setup](https://cabane.ai/docs/windows-setup#2-sign-in) or [Server and VPS setup](https://cabane.ai/docs/server-and-vps-setup#2-sign-in-without-a-browser), then check `cabane status`.
 
 ```
 ✓ Paired as "maya-mbp" with Acme.
@@ -45,7 +45,7 @@ Setup never installs the service. On macOS or Linux, run `cabane service install
 
 If `cabane` isn't found afterwards, open a new terminal, or run the `source` line setup printed.
 
-The [server guide](https://cabane.ai/docs/on-a-server) provides a Dockerfile and Compose example to build locally. Its Dockerfile installs the Companion and all three command-line tools; you sign in inside the container. Follow that guide for pairing and starting the Docker environment.
+The [server guide](https://cabane.ai/docs/server-and-vps-setup) provides a Dockerfile and Compose example to build locally. Its Dockerfile installs the Companion and all three command-line tools; you sign in inside the container. Follow that guide for pairing and starting the Docker environment.
 
 ## Commands
 
@@ -69,7 +69,7 @@ For a direct installation, a reboot or a crash leaves the Companion stopped unti
 
 On native Windows, check the background process with `cabane status` and run `cabane start` after a Windows restart. If you installed OpenCode outside Docker, keep its server running separately; the Companion's service does not supervise it.
 
-For the Docker example, keep automatic Companion updates off and rebuild the local image to update the Companion and harness tools. Follow the [server guide's update steps](https://cabane.ai/docs/on-a-server#4-keep-it-running-and-update).
+For the Docker example, keep automatic Companion updates off and rebuild the local image to update the Companion and harness tools. Follow the [server guide's update steps](https://cabane.ai/docs/server-and-vps-setup#keep-the-container-running-and-update).
 
 Other supervisors: run `cabane start --foreground` with `CABANE_COMPANION_SUPERVISED=1` set, using the absolute paths `~/.cabane/node/bin/node` and `~/.cabane/current/dist/bin.js`, which don't move on an update.
 
@@ -79,7 +79,7 @@ For a direct installation, after **Rotate token** in Cabane, apply the replaceme
 2. In `~/.cabane/config.json`, replace `deviceToken` with the replacement token shown by Cabane.
 3. Run `cabane start`.
 
-For Docker, follow [Rotate a Docker device's token](https://cabane.ai/docs/on-a-server#rotate-a-docker-devices-token).
+For Docker, follow [Rotate a Docker device's token](https://cabane.ai/docs/server-and-vps-setup#rotate-a-docker-devices-token).
 
 ## What's on this device
 
@@ -138,7 +138,7 @@ These names are a contract: changing one would break your command, so none chang
 
 ### Harness permissions
 
-The Companion approves Claude Code's tools through a hook and approves OpenCode permission requests; no turn waits for a tool-approval dialog. For Codex it disables approvals and, when your configuration sets a top-level `sandbox_mode`, passes no sandbox flag; without that setting it uses `danger-full-access`. Choose where agents run using [Agent access](https://cabane.ai/docs/how-much-access-agents-get), and configure the tools through [Harness sandboxes](https://cabane.ai/docs/harness-sandboxes).
+The Companion approves Claude Code's tools through a hook and approves OpenCode permission requests; no turn waits for a tool-approval dialog. For Codex it disables approvals and, when your configuration sets a top-level `sandbox_mode`, passes no sandbox flag; without that setting it uses `danger-full-access`. Choose where agents run using [Agent access](https://cabane.ai/docs/agent-access), and configure the tools through [Harness sandboxes](https://cabane.ai/docs/harness-sandboxes).
 
 ## Debugging a turn
 

package/dist/cli.js

@@ -1801,7 +1801,12 @@ var init_api = __esm({
           this.opts.outbox?.remove(activeRunOutboxKey(conversationId, agentId), ACTIVE_RUN_OUTBOX_SEQ);
           return res;
         }
-        return this.request("PATCH", path, body);
+        return this.request(
+          "PATCH",
+          path,
+          body,
+          body.responsiveness ? { signal: AbortSignal.timeout(5e3) } : {}
+        );
       }
       // Send-or-enqueue for an active-run flag write, last-writer-wins per
       // (conversation, agent) pair. Like `durableCommit`, except:
@@ -8020,6 +8025,59 @@ var init_protocol = __esm({
   }
 });
 
+// src/turn-responsiveness.ts
+import { randomUUID as randomUUID2 } from "crypto";
+function createTurnResponsiveness(send, source, now = () => performance.now()) {
+  let invocationId = "";
+  let started = 0;
+  let sessionMode = "fresh";
+  let firstEvent = false;
+  let firstText = false;
+  let invocations = 0;
+  const report = (phase, eventKind) => {
+    if (invocations > 8) return;
+    const value = {
+      executionSourceId: source,
+      invocationId,
+      phase,
+      sessionMode,
+      elapsedMs: Math.min(864e5, Math.max(0, Math.round(now() - started))),
+      ...eventKind ? { eventKind } : {}
+    };
+    try {
+      void send(value).catch(() => {
+      });
+    } catch {
+    }
+  };
+  return {
+    start(mode) {
+      invocationId = randomUUID2();
+      started = now();
+      sessionMode = mode;
+      firstEvent = false;
+      firstText = false;
+      invocations += 1;
+      report("invocation");
+    },
+    event(event) {
+      if (!firstEvent) {
+        firstEvent = true;
+        report("first_event", event.type);
+      }
+      if (!firstText && event.type === "text" && event.body.trim()) {
+        firstText = true;
+        report("first_text", "text");
+      }
+    }
+  };
+}
+var init_turn_responsiveness = __esm({
+  "src/turn-responsiveness.ts"() {
+    "use strict";
+  }
+});
+
 // src/grants.ts
 import { existsSync as existsSync9, readFileSync as readFileSync7 } from "fs";
 import { join as join14 } from "path";
@@ -8138,7 +8196,7 @@ var init_work_dir = __esm({
 });
 
 // src/turn-control-tools.ts
-import { randomUUID as randomUUID2 } from "crypto";
+import { randomUUID as randomUUID3 } from "crypto";
 import { z as z16 } from "zod";
 function createSkipState() {
   return { skipped: false, reason: null };
@@ -8237,7 +8295,7 @@ function createTurnControlMcpServer(acts, skipState) {
           }
           return performAct(acts, {
             kind: "ask",
-            callId: randomUUID2(),
+            callId: randomUUID3(),
             // The swap rides the ask, so the server commits both halves
             // in one transaction — the person never sees neither or both.
             ...args.replaces ? { replaces: args.replaces } : {},
@@ -8279,7 +8337,7 @@ function createTurnControlMcpServer(acts, skipState) {
           }
           return performAct(acts, {
             kind: "wake",
-            callId: randomUUID2(),
+            callId: randomUUID3(),
             wake: {
               ...hasAfter ? { afterSeconds: args.afterSeconds } : {},
               ...hasAt ? { at: args.at } : {},
@@ -8303,7 +8361,7 @@ function createTurnControlMcpServer(acts, skipState) {
         },
         async (args) => performAct(acts, {
           kind: "withdraw_ask",
-          callId: randomUUID2(),
+          callId: randomUUID3(),
           withdraw: { askId: args.askId, reason: args.reason }
         }),
         { annotations: ACT_TOOL, alwaysLoad: true }
@@ -8312,7 +8370,7 @@ function createTurnControlMcpServer(acts, skipState) {
         ANSWER_TOOL2,
         TURN_CONTROL_TOOL_DESCRIPTIONS.answer,
         {},
-        async () => performAct(acts, { kind: "answer", callId: randomUUID2() }),
+        async () => performAct(acts, { kind: "answer", callId: randomUUID3() }),
         { annotations: ACT_TOOL, alwaysLoad: true }
       ),
       // The inverse. No arguments — it can only ever stand down the
@@ -8321,7 +8379,7 @@ function createTurnControlMcpServer(acts, skipState) {
         CANCEL_WAKE_TOOL,
         TURN_CONTROL_TOOL_DESCRIPTIONS.cancel_wake,
         {},
-        async () => performAct(acts, { kind: "cancel_wake", callId: randomUUID2() }),
+        async () => performAct(acts, { kind: "cancel_wake", callId: randomUUID3() }),
         { annotations: CANCEL_TOOL, alwaysLoad: true }
       )
     ]
@@ -9143,7 +9201,7 @@ var init_turn_runtime_integrity = __esm({
 });
 
 // src/turn-execution.ts
-import { createHash as createHash2, randomUUID as randomUUID3 } from "crypto";
+import { createHash as createHash2, randomUUID as randomUUID4 } from "crypto";
 import { existsSync as existsSync12, mkdirSync as mkdirSync9 } from "fs";
 function resolveIdleTimeoutMs(override) {
   return override ?? DEFAULT_AGENT_IDLE_TIMEOUT_MS;
@@ -9185,6 +9243,7 @@ var PREPARING_TOOL_NAME, HARNESS_UNAVAILABLE_NOTICE, NO_TURN_TOKEN_REASON, UNEXP
 var init_turn_execution = __esm({
   "src/turn-execution.ts"() {
     "use strict";
+    init_turn_responsiveness();
     init_term();
     init_cabane_command();
     init_boot_id();
@@ -9241,7 +9300,7 @@ var init_turn_execution = __esm({
           agentId: payload.agentId,
           messageId: payload.messageId
         });
-        this.turnId = handleOpts.turnId ?? randomUUID3();
+        this.turnId = handleOpts.turnId ?? randomUUID4();
       }
       opts;
       supervisor;
@@ -9651,7 +9710,7 @@ var init_turn_execution = __esm({
             let preparing = null;
             const executionSourceId = this.executionSourceId;
             const reportPreparing = (phase) => {
-              preparing ??= { id: `prepare:${randomUUID3()}`, seq: this.nextSeq() };
+              preparing ??= { id: `prepare:${randomUUID4()}`, seq: this.nextSeq() };
               const { id, seq } = preparing;
               const body = {
                 turnId,
@@ -9722,6 +9781,10 @@ var init_turn_execution = __esm({
         try {
           await this.opts.api.setActiveRun(workspaceId, payload.conversationId, payload.agentId, {
             activeRunStartedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            ...this.turnContext.responsivenessVersion === 1 ? {
+              responsivenessVersion: 1,
+              responsivenessSessionMode: this.request.session ? "resumed" : "fresh"
+            } : {},
             // A runner leases under its launcher's boot id, the one the device
             // heartbeats, or the lost-run sweep reads it as a restart.
             bootId: this.opts.inRunner?.bootId ?? bootId,
@@ -10066,10 +10129,23 @@ var init_turn_execution = __esm({
           clearTimeout(totalTimer);
           clearInterval(leaseTimer);
         };
+        const responsiveness = this.turnContext.responsivenessVersion === 1 && this.executionSourceId ? createTurnResponsiveness(
+          (report) => this.opts.api.setActiveRun(workspaceId, payload.conversationId, payload.agentId, {
+            turnId,
+            responsiveness: report
+          }),
+          this.executionSourceId
+        ) : null;
+        responsiveness?.start(this.request.session ? "resumed" : "fresh");
         try {
           for await (const event of this.adapter.runTurn(this.request, abortController.signal, {
-            fresh: (reason) => this.freshRequest(reason)
+            fresh: async (reason) => {
+              const fresh = await this.freshRequest(reason);
+              if (fresh) responsiveness?.start("fallback");
+              return fresh;
+            }
           })) {
+            responsiveness?.event(event);
             transcript2?.write(event);
             o.eventCounts[event.type] += 1;
             if (isContentBearingEvent(event)) o.contentBearingEvents += 1;
@@ -11901,7 +11977,7 @@ function isDevicePaired() {
 // src/runtime.ts
 init_config();
 init_cabane_command();
-import { randomUUID as randomUUID6 } from "crypto";
+import { randomUUID as randomUUID7 } from "crypto";
 import { fileURLToPath as fileURLToPath6 } from "url";
 
 // src/dashboard/server.ts
@@ -12475,7 +12551,7 @@ function turnFailureCopy(reason, runtime) {
 init_api_error_shape();
 init_boot_id();
 init_api();
-import { randomUUID as randomUUID5 } from "crypto";
+import { randomUUID as randomUUID6 } from "crypto";
 
 // src/device-api.ts
 init_errors();
@@ -12858,7 +12934,7 @@ var ConnectorHealthStore = class {
 };
 
 // src/dispatcher.ts
-import { randomUUID as randomUUID4 } from "crypto";
+import { randomUUID as randomUUID5 } from "crypto";
 
 // src/runner/launch.ts
 init_src();
@@ -13348,7 +13424,7 @@ var Dispatcher = class {
         notifyEnd: (info) => this.notifyEnd(info)
       },
       payload,
-      { turnId: opts.turnId ?? randomUUID4(), resumed: opts.resumed === true }
+      { turnId: opts.turnId ?? randomUUID5(), resumed: opts.resumed === true }
     );
   }
   // Cancel the named turn. An older server omits turnId and cancels the pair.
@@ -15489,7 +15565,7 @@ var CompanionSupervisor = class {
           workspaceId,
           agent,
           payload,
-          turnIdForEvent(workspaceId, dispatchId) ?? randomUUID5(),
+          turnIdForEvent(workspaceId, dispatchId) ?? randomUUID6(),
           attempt,
           dispatchId
         );
@@ -15502,7 +15578,7 @@ var CompanionSupervisor = class {
       );
     }
     const resumedTurnId = recoveredTurnId ?? (dispatchId ? turnIdForEvent(workspaceId, dispatchId) : null);
-    const turnId = resumedTurnId ?? randomUUID5();
+    const turnId = resumedTurnId ?? randomUUID6();
     if (dispatchId) {
       const liveTurnIds = rememberTurnId(workspaceId, dispatchId, turnId);
       if (liveTurnIds > TURN_ID_OVERFLOW_WARN) {
@@ -16020,7 +16096,7 @@ async function createCompanionRuntime(opts = {}) {
     throw err;
   }
   configureLogger(log2, cfg);
-  const instanceId = randomUUID6();
+  const instanceId = randomUUID7();
   const startedAt = (/* @__PURE__ */ new Date()).toISOString();
   const pre = readLiveRuntimeState();
   if (pre && await verifyRuntime(pre) === "stale") clearRuntimeState();

package/dist/runtime.js

@@ -1,5 +1,5 @@
 // src/runtime.ts
-import { randomUUID as randomUUID6 } from "crypto";
+import { randomUUID as randomUUID7 } from "crypto";
 import { fileURLToPath as fileURLToPath6 } from "url";
 
 // src/cabane-command.ts
@@ -1864,7 +1864,7 @@ import { randomUUID } from "crypto";
 var bootId = randomUUID();
 
 // src/supervisor.ts
-import { randomUUID as randomUUID5 } from "crypto";
+import { randomUUID as randomUUID6 } from "crypto";
 
 // src/api.ts
 import { promisify } from "util";
@@ -2226,7 +2226,12 @@ var CabaneApi = class {
       this.opts.outbox?.remove(activeRunOutboxKey(conversationId, agentId), ACTIVE_RUN_OUTBOX_SEQ);
       return res;
     }
-    return this.request("PATCH", path, body);
+    return this.request(
+      "PATCH",
+      path,
+      body,
+      body.responsiveness ? { signal: AbortSignal.timeout(5e3) } : {}
+    );
   }
   // Send-or-enqueue for an active-run flag write, last-writer-wins per
   // (conversation, agent) pair. Like `durableCommit`, except:
@@ -7552,7 +7557,7 @@ var ConnectorHealthStore = class {
 };
 
 // src/dispatcher.ts
-import { randomUUID as randomUUID4 } from "crypto";
+import { randomUUID as randomUUID5 } from "crypto";
 
 // src/runner/launch.ts
 import { createInterface } from "readline";
@@ -8216,8 +8221,11 @@ async function runTurnInRunner(opts, launch, duties, payload, handleOpts) {
   return { ok: false, durationMs, reason };
 }
 
+// src/turn-responsiveness.ts
+import { randomUUID as randomUUID2 } from "crypto";
+
 // src/turn-execution.ts
-import { createHash as createHash2, randomUUID as randomUUID3 } from "crypto";
+import { createHash as createHash2, randomUUID as randomUUID4 } from "crypto";
 import { existsSync as existsSync12, mkdirSync as mkdirSync9 } from "fs";
 
 // src/grants.ts
@@ -8284,7 +8292,7 @@ import { statSync as statSync3 } from "fs";
 import { join as join14 } from "path";
 
 // src/turn-control-tools.ts
-import { randomUUID as randomUUID2 } from "crypto";
+import { randomUUID as randomUUID3 } from "crypto";
 import { z as z16 } from "zod";
 var COMPANION_LOCAL_MCP_SERVER = TURN_CONTROL_MCP_SERVER;
 var COMPANION_LOCAL_TOOL_GLOB = `mcp__${COMPANION_LOCAL_MCP_SERVER}__*`;
@@ -8583,7 +8591,7 @@ var Dispatcher = class {
         notifyEnd: (info) => this.notifyEnd(info)
       },
       payload,
-      { turnId: opts.turnId ?? randomUUID4(), resumed: opts.resumed === true }
+      { turnId: opts.turnId ?? randomUUID5(), resumed: opts.resumed === true }
     );
   }
   // Cancel the named turn. An older server omits turnId and cancels the pair.
@@ -11102,7 +11110,7 @@ var CompanionSupervisor = class {
           workspaceId,
           agent,
           payload,
-          turnIdForEvent(workspaceId, dispatchId) ?? randomUUID5(),
+          turnIdForEvent(workspaceId, dispatchId) ?? randomUUID6(),
           attempt,
           dispatchId
         );
@@ -11115,7 +11123,7 @@ var CompanionSupervisor = class {
       );
     }
     const resumedTurnId = recoveredTurnId ?? (dispatchId ? turnIdForEvent(workspaceId, dispatchId) : null);
-    const turnId = resumedTurnId ?? randomUUID5();
+    const turnId = resumedTurnId ?? randomUUID6();
     if (dispatchId) {
       const liveTurnIds = rememberTurnId(workspaceId, dispatchId, turnId);
       if (liveTurnIds > TURN_ID_OVERFLOW_WARN) {
@@ -11631,7 +11639,7 @@ async function createCompanionRuntime(opts = {}) {
     throw err;
   }
   configureLogger(log, cfg);
-  const instanceId = randomUUID6();
+  const instanceId = randomUUID7();
   const startedAt = (/* @__PURE__ */ new Date()).toISOString();
   const pre = readLiveRuntimeState();
   if (pre && await verifyRuntime(pre) === "stale") clearRuntimeState();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cabane/companion",
-  "version": "0.6.209",
+  "version": "0.6.211",
   "type": "module",
   "description": "The Cabane Companion (headless): connect an agent on your machine to your Cabane workspace as a responder — drive work against your own codebase, files, and MCP servers without putting any of it in Cabane.",
   "license": "UNLICENSED",