@cabane/companion 0.6.182 → 0.6.184

package/README.md

@@ -44,16 +44,26 @@ The script brings its own Node (checksum-checked, into `~/.cabane`) and needs no
 npm i -g @cabane/companion && cabane setup CODE
 ```
 
-Either way `cabane setup CODE` pairs the device to your account, joins it to that workspace, detects your harnesses, and starts the Companion: as a service on macOS and Linux, in the background elsewhere. No confirm, no name screen, no browser on the device. The same line on a device that is already paired joins it to the workspace and mints nothing.
+Either way `cabane setup CODE` pairs the device to your account, joins it to that workspace, starts the Companion in the background, waits for its first check-in, and ends with the device's state in Cabane's words. No confirm, no name screen, no browser on the device. The same line on a device that is already paired joins it to the workspace and mints nothing.
 
 ```
-✓ Claude Code   signed in (2.1.289) — connected
-  Codex         not signed in — run  codex login
-  OpenCode      not running
-All set here. Back to the browser.
+✓ Paired as "maya-mbp" with Acme.
+  Cabane is running in the background. This device is ready — checked in 2s ago.
+
+  Harnesses on this device
+  ✓ Claude Code   connected — signed in (2.1.289)
+    Codex         needs sign-in — run  codex login
+    OpenCode      off — not running
+
+  Status  cabane status     Stop  cabane stop     Log  cabane logs
+  Start at login and keep Cabane updating itself:  cabane service install
+
+  In Cabane: https://app.cabane.ai/acme/settings/devices
 ```
 
-With nothing signed in, the device still pairs and the Companion still runs; the rows say which harness needs sign-in, and the device shows **Needs attention** in Cabane until one is usable. Sign in, and the next check finds it: no restart.
+The device is online the moment the Companion checks in, before any harness is checked; Cabane shows it as **Checking harnesses…** until the first detection lands, then **Ready** or **Needs attention**. With nothing signed in, the device still pairs and the Companion still runs; the rows say which harness needs sign-in. Sign in, and the next check finds it: no restart. A harness that was signed in earlier in this run stays offered through a lapsed login, so a turn reaches the device, fails with the sign-in notice, and the first reply after you sign in again runs with no wait.
+
+Setup never installs the service. Run `cabane service install` when you want the Companion to start at login and keep itself updated; the closing block names it.
 
 A fresh device runs nothing yet. In a workspace, open an agent's page and assign it to the device; the Companion picks the assignment up on its next poll.
 
@@ -61,23 +71,23 @@ If `cabane` isn't found afterwards, open a new terminal, or run the `source` lin
 
 ## Commands
 
-| Command                              | What it does                                                                                                                                                            |
-| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `setup [CODE]`                       | With a code: pair or join, detect harnesses, start. Without: a re-runnable checklist that reports harnesses and starts what isn't running.                              |
-| `start [--foreground]`               | Run in the background. Never asks. Unpaired, it names `setup`. `--foreground` stays attached, for a supervisor of your own.                                             |
-| `stop`                               | Stop a running Companion cleanly. Ends any turn in progress.                                                                                                            |
-| `status`                             | Version and install, the paired device by its Cabane name, whether it's running, each harness's state, the sandbox posture, declared secret names, and local overrides. |
-| `update [--auto on\|off]`            | Install the version Cabane names now; with `--auto`, set whether the Companion keeps itself up to date.                                                                 |
-| `service install\|uninstall\|status` | Run as a systemd user service or a LaunchAgent that starts at boot and restarts if it stops; remove it; show its state.                                                 |
-| `logs [-n N] [-f]`                   | Recent log lines, or follow.                                                                                                                                            |
-| `transcript [file] [--last] [-f]`    | Read back a full agent turn, tool calls and results included.                                                                                                           |
-| `logout [--purge]`                   | Remove the device token and cached agent credentials. Doesn't remove the device from Cabane.                                                                            |
+| Command                              | What it does                                                                                                                                                                                               |
+| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `setup [CODE]`                       | With a code: pair or join, detect harnesses, start. Without: a re-runnable checklist that reports harnesses and starts what isn't running.                                                                 |
+| `start [--foreground]`               | Run in the background. Never asks. Unpaired, it names `setup`. `--foreground` stays attached, for a supervisor of your own.                                                                                |
+| `stop`                               | Stop a running Companion cleanly. Ends any turn in progress.                                                                                                                                               |
+| `status`                             | Version and install, the paired device by its Cabane name, its state in Cabane's words and when it last checked in, each harness's state, the sandbox posture, declared secret names, and local overrides. |
+| `update [--auto on\|off]`            | Install the version Cabane names now; with `--auto`, set whether the Companion keeps itself up to date.                                                                                                    |
+| `service install\|uninstall\|status` | Run as a systemd user service or a LaunchAgent that starts at boot and restarts if it stops; remove it; show its state.                                                                                    |
+| `logs [-n N] [-f]`                   | Recent log lines, or follow.                                                                                                                                                                               |
+| `transcript [file] [--last] [-f]`    | Read back a full agent turn, tool calls and results included.                                                                                                                                              |
+| `logout [--purge]`                   | Remove the device token and cached agent credentials. Doesn't remove the device from Cabane.                                                                                                               |
 
 Anything else about a device is done in Cabane, on the device's page.
 
 ## Keeping it running
 
-Under the service the Companion restarts if it stops, comes back after a reboot, and follows the version Cabane names: it installs the new version under `~/.cabane/versions`, checks it starts, and swaps between turns. A version that can't start is rolled back by the boot guard. `cabane update --auto off` stops updates; without the service, `cabane update` installs and the next `cabane start` runs it.
+Without the service, a reboot or a crash leaves the Companion stopped until the next `cabane start`, and the device shows **Offline** in Cabane. Under the service it restarts if it stops, comes back after a reboot, and follows the version Cabane names: it installs the new version under `~/.cabane/versions`, checks it starts, and swaps between turns. A version that can't start is rolled back by the boot guard. `cabane update --auto off` stops updates; without the service, `cabane update` installs and the next `cabane start` runs it.
 
 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.
 

package/dist/cli.js

@@ -1128,7 +1128,7 @@ function classifyRuntimeNoticeText(text) {
   }
   return null;
 }
-var turnFailureSchema, USAGE_CAPPED, RATE_LIMITED, SERVER_ERROR, AUTH_EXPIRED, AUTH_PATTERNS, SERVER_PATTERNS, CAP_PATTERNS, NEGATED_CAP, RATE_PATTERNS, BARE_LIMIT;
+var turnFailureSchema, ERROR_REASON_MAX, USAGE_CAPPED, RATE_LIMITED, SERVER_ERROR, AUTH_EXPIRED, AUTH_PATTERNS, SERVER_PATTERNS, CAP_PATTERNS, NEGATED_CAP, RATE_PATTERNS, BARE_LIMIT;
 var init_failure = __esm({
   "packages/agent-runtime/src/failure.ts"() {
     "use strict";
@@ -1138,6 +1138,7 @@ var init_failure = __esm({
       z4.object({ kind: z4.literal("server_error") }),
       z4.object({ kind: z4.literal("auth_expired") })
     ]);
+    ERROR_REASON_MAX = 2e3;
     USAGE_CAPPED = "usage_capped";
     RATE_LIMITED = "rate_limited";
     SERVER_ERROR = "server_error";
@@ -2966,7 +2967,7 @@ function createFailureEvidence() {
       const failure = classifyResultFailure(msg, signals);
       const resultText = msg.result ?? "";
       const isError = msg.is_error === true;
-      return failure ? encodeFailureReason(failure) : isError ? `error:${resultText.slice(0, 200) || "unknown"}` : `result_error:${msg.subtype}`;
+      return failure ? encodeFailureReason(failure) : isError ? `error:${resultText || "unknown"}`.slice(0, ERROR_REASON_MAX) : `result_error:${msg.subtype}`;
     },
     thrownFailure(message2, initReceived) {
       return initReceived ? classifyErrorText(message2) : classifyFailure(signals, { text: message2 });
@@ -4260,7 +4261,7 @@ async function* decodeOpencodeStream(events, ctx2) {
         yield { type: "runtime_notice", body: notice };
       }
       const failure = classifyErrorText(errorText);
-      reason = failure ? encodeFailureReason(failure) : `error:${errorText.slice(0, 200)}`;
+      reason = failure ? encodeFailureReason(failure) : `error:${errorText}`.slice(0, ERROR_REASON_MAX);
       settled = true;
       break;
     }
@@ -5500,7 +5501,7 @@ async function* decodeCodexStream(events, ctx2) {
         if (isModelMetadataError(message2)) {
           yield* flushInterim();
           ok = false;
-          reason = `model_unavailable:${message2.slice(0, 200)}`;
+          reason = `model_unavailable:${message2}`.slice(0, ERROR_REASON_MAX);
           settled = true;
           break;
         }
@@ -5568,7 +5569,7 @@ async function* decodeCodexStream(events, ctx2) {
         yield { type: "runtime_notice", body: notice };
       }
       const failure = classifyErrorText(text);
-      reason = failure ? encodeFailureReason(failure) : `error:${text.slice(0, 200)}`;
+      reason = failure ? encodeFailureReason(failure) : `error:${text}`.slice(0, ERROR_REASON_MAX);
       settled = true;
       break;
     }
@@ -7760,16 +7761,16 @@ function missingSecretReason(missing) {
   }
   return `${prefix}+${missing.length}`;
 }
-var PLACEHOLDER_RE, secretStoreSchema, SECRET_ENV_NAME, ERROR_REASON_MAX;
+var PLACEHOLDER_RE, secretStoreSchema, SECRET_ENV_NAME;
 var init_secrets = __esm({
   "src/secrets.ts"() {
     "use strict";
+    init_src();
     init_config();
     init_errors();
     PLACEHOLDER_RE = /\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
     secretStoreSchema = z15.record(z15.string(), z15.string());
     SECRET_ENV_NAME = /^CABANE_MCP_(\d+)$/;
-    ERROR_REASON_MAX = 200;
   }
 });
 
@@ -8133,7 +8134,7 @@ async function settleUnstarted(opts, payload, turnId, errorReason, log2) {
       activeRunStartedAt: null,
       turnId,
       outcome: "failed",
-      ...errorReason ? { errorReason: errorReason.slice(0, 200) } : {},
+      ...errorReason ? { errorReason: errorReason.slice(0, ERROR_REASON_MAX) } : {},
       readThrough: payload.messageId
     });
   } catch (err) {
@@ -8155,7 +8156,7 @@ function sandboxInputs(launch, log2) {
   }
   if (!policy.ok) {
     log2.warn({ error: policy.error }, "runners: the sandbox policy is invalid; refusing the turn");
-    return { ok: false, reason: `setup_failed: ${policy.error}`.slice(0, 200) };
+    return { ok: false, reason: `setup_failed: ${policy.error}`.slice(0, ERROR_REASON_MAX) };
   }
   if (!policyHasCredentials(policy.policy)) return { ok: true, credentials: [] };
   const store = (launch.secretStore ?? defaultSecretStore)(log2);
@@ -8393,7 +8394,7 @@ async function runTurnInRunner(opts, launch, duties, payload, handleOpts) {
       activeRunStartedAt: null,
       turnId,
       outcome: "failed",
-      errorReason: reason.slice(0, 200),
+      errorReason: reason.slice(0, ERROR_REASON_MAX),
       readThrough: payload.messageId
     });
   } catch (err) {
@@ -8419,6 +8420,7 @@ var PINO_LEVELS;
 var init_launch = __esm({
   "src/runner/launch.ts"() {
     "use strict";
+    init_src();
     init_sandbox_policy();
     init_opencode_lock();
     init_api_error_shape();
@@ -9556,7 +9558,7 @@ var init_turn_execution = __esm({
       async concludeBeforeRun(reason, errorReason) {
         const { payload, turnLog, startedAt, turnId } = this;
         const body = { activeRunStartedAt: null, turnId, outcome: "failed" };
-        if (errorReason) body.errorReason = errorReason.slice(0, 200);
+        if (errorReason) body.errorReason = errorReason.slice(0, ERROR_REASON_MAX);
         const context = this.turnContext;
         if (context?.readThrough !== void 0) {
           body.readThrough = context.readThrough;
@@ -9595,7 +9597,7 @@ var init_turn_execution = __esm({
           // `errorReason`, so the inference alone would read it as settled.
           outcome: errorReason || this.outcome.runtimeIncomplete ? "failed" : "settled"
         };
-        if (errorReason) body.errorReason = errorReason.slice(0, 200);
+        if (errorReason) body.errorReason = errorReason.slice(0, ERROR_REASON_MAX);
         try {
           await this.opts.api.setActiveRun(
             this.opts.workspaceId,
@@ -10007,7 +10009,7 @@ var init_turn_execution = __esm({
           }) : null;
         } catch (err) {
           if (!(err instanceof HarnessSandboxRefused)) throw err;
-          const reason = `setup_failed: ${err.message}`.slice(0, 200);
+          const reason = `setup_failed: ${err.message}`.slice(0, ERROR_REASON_MAX);
           throw this.concluded(reason, reason);
         }
         const adapters = [];
@@ -10407,7 +10409,7 @@ var init_turn_execution = __esm({
             body.resolvedConfig = o.turnResolvedConfig;
           }
           if (!o.okResult && o.resultReason && o.resultReason !== "cancelled" && !userCancelled && !o.leaseLost && !o.runtimeIncomplete && !this.skipState.skipped) {
-            body.errorReason = o.resultReason.slice(0, 200);
+            body.errorReason = o.resultReason.slice(0, ERROR_REASON_MAX);
           }
           body.outcome = o.okResult ? committer.spoke ? "settled" : "passed" : body.errorReason || o.runtimeIncomplete ? "failed" : "interrupted";
           if (body.outcome === "settled") body.lastMessageSeq = committer.lastMessageSeq;

package/dist/runtime.js

@@ -1758,6 +1758,7 @@ var turnFailureSchema = z4.discriminatedUnion("kind", [
   z4.object({ kind: z4.literal("server_error") }),
   z4.object({ kind: z4.literal("auth_expired") })
 ]);
+var ERROR_REASON_MAX = 2e3;
 var USAGE_CAPPED = "usage_capped";
 var RATE_LIMITED = "rate_limited";
 var SERVER_ERROR = "server_error";
@@ -3902,7 +3903,7 @@ function createFailureEvidence() {
       const failure = classifyResultFailure(msg, signals);
       const resultText = msg.result ?? "";
       const isError = msg.is_error === true;
-      return failure ? encodeFailureReason(failure) : isError ? `error:${resultText.slice(0, 200) || "unknown"}` : `result_error:${msg.subtype}`;
+      return failure ? encodeFailureReason(failure) : isError ? `error:${resultText || "unknown"}`.slice(0, ERROR_REASON_MAX) : `result_error:${msg.subtype}`;
     },
     thrownFailure(message2, initReceived) {
       return initReceived ? classifyErrorText(message2) : classifyFailure(signals, { text: message2 });
@@ -5120,7 +5121,7 @@ async function* decodeOpencodeStream(events, ctx) {
         yield { type: "runtime_notice", body: notice };
       }
       const failure = classifyErrorText(errorText);
-      reason = failure ? encodeFailureReason(failure) : `error:${errorText.slice(0, 200)}`;
+      reason = failure ? encodeFailureReason(failure) : `error:${errorText}`.slice(0, ERROR_REASON_MAX);
       settled = true;
       break;
     }
@@ -6276,7 +6277,7 @@ async function* decodeCodexStream(events, ctx) {
         if (isModelMetadataError(message2)) {
           yield* flushInterim();
           ok = false;
-          reason = `model_unavailable:${message2.slice(0, 200)}`;
+          reason = `model_unavailable:${message2}`.slice(0, ERROR_REASON_MAX);
           settled = true;
           break;
         }
@@ -6344,7 +6345,7 @@ async function* decodeCodexStream(events, ctx) {
         yield { type: "runtime_notice", body: notice };
       }
       const failure = classifyErrorText(text);
-      reason = failure ? encodeFailureReason(failure) : `error:${text.slice(0, 200)}`;
+      reason = failure ? encodeFailureReason(failure) : `error:${text}`.slice(0, ERROR_REASON_MAX);
       settled = true;
       break;
     }
@@ -8411,7 +8412,6 @@ function resolveMcpSecrets(mcpServers, store, serverSecretEnv = {}) {
   }
   return { servers, secretEnv, missing: [...missing].sort() };
 }
-var ERROR_REASON_MAX = 200;
 function missingSecretReason(missing) {
   const prefix = "missing_secret: ";
   for (let shown = missing.length; shown >= 0; shown--) {
@@ -8746,7 +8746,7 @@ async function settleUnstarted(opts, payload, turnId, errorReason, log) {
       activeRunStartedAt: null,
       turnId,
       outcome: "failed",
-      ...errorReason ? { errorReason: errorReason.slice(0, 200) } : {},
+      ...errorReason ? { errorReason: errorReason.slice(0, ERROR_REASON_MAX) } : {},
       readThrough: payload.messageId
     });
   } catch (err) {
@@ -8768,7 +8768,7 @@ function sandboxInputs(launch, log) {
   }
   if (!policy.ok) {
     log.warn({ error: policy.error }, "runners: the sandbox policy is invalid; refusing the turn");
-    return { ok: false, reason: `setup_failed: ${policy.error}`.slice(0, 200) };
+    return { ok: false, reason: `setup_failed: ${policy.error}`.slice(0, ERROR_REASON_MAX) };
   }
   if (!policyHasCredentials(policy.policy)) return { ok: true, credentials: [] };
   const store = (launch.secretStore ?? defaultSecretStore)(log);
@@ -9006,7 +9006,7 @@ async function runTurnInRunner(opts, launch, duties, payload, handleOpts) {
       activeRunStartedAt: null,
       turnId,
       outcome: "failed",
-      errorReason: reason.slice(0, 200),
+      errorReason: reason.slice(0, ERROR_REASON_MAX),
       readThrough: payload.messageId
     });
   } catch (err) {
@@ -10035,7 +10035,7 @@ var TurnExecution = class {
   async concludeBeforeRun(reason, errorReason) {
     const { payload, turnLog, startedAt, turnId } = this;
     const body = { activeRunStartedAt: null, turnId, outcome: "failed" };
-    if (errorReason) body.errorReason = errorReason.slice(0, 200);
+    if (errorReason) body.errorReason = errorReason.slice(0, ERROR_REASON_MAX);
     const context = this.turnContext;
     if (context?.readThrough !== void 0) {
       body.readThrough = context.readThrough;
@@ -10074,7 +10074,7 @@ var TurnExecution = class {
       // `errorReason`, so the inference alone would read it as settled.
       outcome: errorReason || this.outcome.runtimeIncomplete ? "failed" : "settled"
     };
-    if (errorReason) body.errorReason = errorReason.slice(0, 200);
+    if (errorReason) body.errorReason = errorReason.slice(0, ERROR_REASON_MAX);
     try {
       await this.opts.api.setActiveRun(
         this.opts.workspaceId,
@@ -10486,7 +10486,7 @@ var TurnExecution = class {
       }) : null;
     } catch (err) {
       if (!(err instanceof HarnessSandboxRefused)) throw err;
-      const reason = `setup_failed: ${err.message}`.slice(0, 200);
+      const reason = `setup_failed: ${err.message}`.slice(0, ERROR_REASON_MAX);
       throw this.concluded(reason, reason);
     }
     const adapters = [];
@@ -10886,7 +10886,7 @@ var TurnExecution = class {
         body.resolvedConfig = o.turnResolvedConfig;
       }
       if (!o.okResult && o.resultReason && o.resultReason !== "cancelled" && !userCancelled && !o.leaseLost && !o.runtimeIncomplete && !this.skipState.skipped) {
-        body.errorReason = o.resultReason.slice(0, 200);
+        body.errorReason = o.resultReason.slice(0, ERROR_REASON_MAX);
       }
       body.outcome = o.okResult ? committer.spoke ? "settled" : "passed" : body.errorReason || o.runtimeIncomplete ? "failed" : "interrupted";
       if (body.outcome === "settled") body.lastMessageSeq = committer.lastMessageSeq;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cabane/companion",
-  "version": "0.6.182",
+  "version": "0.6.184",
   "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",