ai-whisper 0.6.0 → 0.6.1

package/README.md

@@ -61,6 +61,8 @@ You pair any two of three agents — `claude`, `codex`, and `ezio`. ai-whisper d
 - **An LLM evaluator with credentials** — workflows are gated by it and refuse to start without it. See [Evaluator configuration](docs/evaluator-configuration.md).
 - **tmux** *(optional)* — only for `whisper collab start`, which auto-arranges both agents into panes. The mount flow below does not need it.
 
+> **Platform support:** ai-whisper is terminal-native and Unix-oriented — it drives interactive PTY sessions, so it runs on **macOS and Linux**. It is **not supported natively on Windows**: `whisper collab mount` / `reconnect` require a Unix tty-backed shell and will exit with an error pointing here. On Windows, run ai-whisper inside **[WSL2](https://learn.microsoft.com/windows/wsl/install)** — install Node, your agent CLI, and ai-whisper inside the WSL2 distro and run the commands there, where everything works as-is.
+
 ## Safety & permissions
 
 ai-whisper launches each agent in **full-autonomy mode** so the relay can drive it unattended — `claude --dangerously-skip-permissions` and `codex --dangerously-bypass-approvals-and-sandbox`. Inside the mounted workspace the agents read, write, and run commands without prompting. Point it at code you're willing to let two agents change autonomously, watch the run on the dashboard, and remember you are the final gatekeeper — review the result before you ship it. The deeper rationale is in [Concepts](docs/concepts.md).

package/dist/bin/broker-daemon.js

@@ -4386,7 +4386,7 @@ function enforceOneActiveCollabPerWorkspace(db, options = {}) {
 
 // ../broker/dist/storage/clipboard-capture-lease.js
 var LEASE_ID = 1;
-var DEFAULT_LEASE_TTL_MS = 5e3;
+var DEFAULT_LEASE_TTL_MS = 25e3;
 function defaultIsPidAlive2(pid) {
   try {
     process.kill(pid, 0);

package/dist/bin/companion-agent.js

@@ -4406,7 +4406,7 @@ function enforceOneActiveCollabPerWorkspace(db, options = {}) {
 
 // ../broker/dist/storage/clipboard-capture-lease.js
 var LEASE_ID = 1;
-var DEFAULT_LEASE_TTL_MS = 5e3;
+var DEFAULT_LEASE_TTL_MS = 25e3;
 function defaultIsPidAlive2(pid) {
   try {
     process.kill(pid, 0);

package/dist/bin/relay-monitor.js

@@ -4376,7 +4376,7 @@ function enforceOneActiveCollabPerWorkspace(db, options = {}) {
 
 // ../broker/dist/storage/clipboard-capture-lease.js
 var LEASE_ID = 1;
-var DEFAULT_LEASE_TTL_MS = 5e3;
+var DEFAULT_LEASE_TTL_MS = 25e3;
 function defaultIsPidAlive2(pid) {
   try {
     process.kill(pid, 0);

package/dist/bin/whisper.js

@@ -4877,7 +4877,7 @@ function acquireCaptureLease(db, collabId, pid, options = {}) {
   const tx = db.transaction(() => {
     const row = db.prepare("SELECT holder_collab_id, holder_pid, acquired_at FROM clipboard_capture_lease WHERE id = ?").get(LEASE_ID);
     if (row && !isStale(row, opts))
-      return false;
+      return null;
     const acquiredAt = new Date(opts.now()).toISOString();
     db.prepare(`INSERT INTO clipboard_capture_lease (id, holder_collab_id, holder_pid, acquired_at)
 			 VALUES (?, ?, ?, ?)
@@ -4885,13 +4885,19 @@ function acquireCaptureLease(db, collabId, pid, options = {}) {
 			   holder_collab_id = excluded.holder_collab_id,
 			   holder_pid       = excluded.holder_pid,
 			   acquired_at      = excluded.acquired_at`).run(LEASE_ID, collabId, pid, acquiredAt);
-    return true;
+    return acquiredAt;
   });
   return tx.immediate();
 }
-function releaseCaptureLease(db, collabId) {
+function releaseCaptureLease(db, collabId, token) {
+  const tx = db.transaction(() => {
+    db.prepare("UPDATE clipboard_capture_lease SET holder_collab_id = NULL, holder_pid = NULL, acquired_at = NULL WHERE id = ? AND holder_collab_id = ? AND acquired_at = ?").run(LEASE_ID, collabId, token);
+  });
+  tx();
+}
+function releaseCaptureLeaseForHolderPid(db, collabId, pid) {
   const tx = db.transaction(() => {
-    db.prepare("UPDATE clipboard_capture_lease SET holder_collab_id = NULL, holder_pid = NULL, acquired_at = NULL WHERE id = ? AND holder_collab_id = ?").run(LEASE_ID, collabId);
+    db.prepare("UPDATE clipboard_capture_lease SET holder_collab_id = NULL, holder_pid = NULL, acquired_at = NULL WHERE id = ? AND holder_collab_id = ? AND holder_pid = ?").run(LEASE_ID, collabId, pid);
   });
   tx();
 }
@@ -4912,7 +4918,7 @@ var init_clipboard_capture_lease = __esm({
   "../broker/dist/storage/clipboard-capture-lease.js"() {
     "use strict";
     LEASE_ID = 1;
-    DEFAULT_LEASE_TTL_MS = 5e3;
+    DEFAULT_LEASE_TTL_MS = 25e3;
   }
 });
 
@@ -8006,6 +8012,11 @@ function lookupByCwd(db, cwd) {
 import { execFileSync as execFileSync2 } from "node:child_process";
 import { existsSync as existsSync6 } from "node:fs";
 function resolveCurrentTty() {
+  if (process.platform === "win32") {
+    throw new Error(
+      "This command is not supported natively on Windows: it requires a Unix tty-backed shell to drive an interactive PTY session. Run ai-whisper inside WSL2 (Windows Subsystem for Linux) instead \u2014 install Node, your agent CLI, and ai-whisper inside your WSL2 distro and run the command there. Setup guide: https://learn.microsoft.com/windows/wsl/install"
+    );
+  }
   const stdin = process.stdin;
   const ttyPath = stdin.isTTY && typeof stdin.path === "string" ? stdin.path : execFileSync2("tty", [], {
     encoding: "utf8",
@@ -12603,8 +12614,8 @@ function compareSemver(a, b) {
 var EZIO_PROVENANCE = {
   ezioCliVersion: "0.2.0-beta.5",
   ezioGitSha: "a701ee7",
-  builtAt: "2026-06-19T11:36:33.762Z",
-  whisperVersion: "0.6.0"
+  builtAt: "2026-06-21T14:21:01.635Z",
+  whisperVersion: "0.6.1"
 };
 
 // src/ezio-provenance-types.ts
@@ -12904,6 +12915,22 @@ function isAutonomousHandoff(handoffId, broker) {
   const chain = broker.control.getRelayChain?.(meta.chainId);
   return wf?.status === "running" && chain?.status === "active";
 }
+var CAPTURE_WATCHDOG_TIMEOUT = /* @__PURE__ */ Symbol("capture-watchdog-timeout");
+async function raceCaptureAgainstWatchdog(run, watchdogMs, schedule) {
+  let cancel = () => {
+  };
+  const watchdog = new Promise((resolve5) => {
+    cancel = schedule(watchdogMs, () => resolve5(CAPTURE_WATCHDOG_TIMEOUT));
+  });
+  try {
+    return await Promise.race([
+      Promise.resolve(run()).then((r) => r ?? null),
+      watchdog
+    ]);
+  } finally {
+    cancel();
+  }
+}
 function createMountedTurnOwnedRelay(input) {
   function resolveCols() {
     const c = input.getTerminalCols?.() ?? process.stdout.columns;
@@ -12913,6 +12940,11 @@ function createMountedTurnOwnedRelay(input) {
   const HAND_BACK_READY_AFTER_MS = 3e4;
   const autoHandbackMaxAttempts = Math.max(1, input.autoHandbackMaxAttempts ?? 3);
   const autoHandbackRetryMs = Math.max(0, input.autoHandbackRetryMs ?? 1e4);
+  const captureWatchdogMs2 = Math.max(1, input.captureWatchdogMs ?? 2e4);
+  const scheduleWatchdog = input.scheduleWatchdog ?? ((ms, onTimeout) => {
+    const timer = setTimeout(onTimeout, ms);
+    return () => clearTimeout(timer);
+  });
   const autoHandbackAttempts = /* @__PURE__ */ new Map();
   let autoHandbackInFlight = false;
   let disconnectHandled = false;
@@ -13533,15 +13565,30 @@ ${hint}`,
         let leaseDegraded = false;
         let interferenceDetected = false;
         let cleanCaptureEmpty = false;
+        let captureTimedOut = false;
         try {
-          const captureResult = await input.captureHandbackText?.(turnResult.text ?? "") ?? null;
-          if (typeof captureResult === "string") {
+          const captureResult = await raceCaptureAgainstWatchdog(
+            () => input.captureHandbackText?.(turnResult.text ?? ""),
+            captureWatchdogMs2,
+            scheduleWatchdog
+          );
+          if (captureResult === CAPTURE_WATCHDOG_TIMEOUT) {
+            captureTimedOut = true;
+            console.warn(
+              `[ai-whisper] capture watchdog fired (${captureWatchdogMs2}ms): target=${input.currentAgent} handoff=${accepted.handoffId} \u2014 abandoning capture, will retry`
+            );
+          } else if (typeof captureResult === "string") {
             clipboardText = captureResult;
           } else if (captureResult !== null) {
             interferenceDetected = captureResult.interferenceDetected;
             if (captureResult.status === "captured") {
               clipboardText = captureResult.text;
               cleanCaptureEmpty = (captureResult.text ?? "").trim().length === 0;
+            } else if (captureResult.status === "timed_out" || captureResult.status === "lease_unavailable") {
+              captureTimedOut = true;
+              console.warn(
+                `[ai-whisper] capture ${captureResult.status}: target=${input.currentAgent} handoff=${accepted.handoffId} \u2014 will retry (no PTY fallback)`
+              );
             } else {
               leaseDegraded = true;
               console.warn(
@@ -13571,7 +13618,7 @@ ${msg}`
         const capturedNothing = captureStatus === "no_response_captured";
         const staleAgainstCurrentTurn = captureStatus === "no_response_captured_confidently" && classification.jaccardScore !== null;
         const emptyClipConfidentMiss = captureStatus === "no_response_captured_confidently" && cleanCaptureEmpty;
-        if ((capturedNothing || staleAgainstCurrentTurn || emptyClipConfidentMiss) && retryState.attempts + 1 < autoHandbackMaxAttempts) {
+        if ((capturedNothing || staleAgainstCurrentTurn || emptyClipConfidentMiss || captureTimedOut) && retryState.attempts + 1 < autoHandbackMaxAttempts) {
           retryState.attempts += 1;
           retryState.nextEligibleAt = Date.now() + autoHandbackRetryMs;
           autoHandbackAttempts.set(accepted.handoffId, retryState);
@@ -13872,25 +13919,40 @@ function createAssistantTurnCapture() {
 
 // src/runtime/clipboard-handback-capture.ts
 import { execFile as execFile2 } from "node:child_process";
-function execFileText(command, args = []) {
+var CaptureIoTimeoutError = class extends Error {
+  constructor(command) {
+    super(`clipboard I/O timed out: ${command}`);
+    this.name = "CaptureIoTimeoutError";
+  }
+};
+function execFileText(command, args = [], timeoutMs) {
   return new Promise((resolve5, reject) => {
-    execFile2(command, args, { encoding: "utf8" }, (error, stdout) => {
-      if (error) {
-        reject(
-          error instanceof Error ? error : new Error("Clipboard command failed")
-        );
-        return;
+    execFile2(
+      command,
+      args,
+      { encoding: "utf8", timeout: timeoutMs ?? 0, killSignal: "SIGTERM" },
+      (error, stdout) => {
+        if (error) {
+          if (error.killed) {
+            reject(new CaptureIoTimeoutError(command));
+            return;
+          }
+          reject(
+            error instanceof Error ? error : new Error("Clipboard command failed")
+          );
+          return;
+        }
+        resolve5(stdout);
       }
-      resolve5(stdout);
-    });
+    );
   });
 }
 async function captureClipboardHandback(input) {
   const readClipboard = input.readClipboard ?? (() => {
-    if (process.platform !== "darwin") {
+    if ((input.platform ?? process.platform) !== "darwin") {
       return Promise.resolve("");
     }
-    return execFileText("pbpaste");
+    return execFileText("pbpaste", [], input.clipboardTimeoutMs);
   });
   const sleep3 = input.sleep ?? ((ms) => new Promise((resolve5) => setTimeout(resolve5, ms)));
   const attempts = input.attempts ?? 10;
@@ -13936,7 +13998,7 @@ async function captureHandbackText(input) {
   const recaptureAttempts = input.recaptureAttempts ?? 2;
   const recaptureBackoffMs = input.recaptureBackoffMs ?? 50;
   const sig = input.copySignature;
-  let acquired = false;
+  let acquired = null;
   const deadline = Date.now() + acquireMaxWaitMs;
   for (; ; ) {
     try {
@@ -13947,21 +14009,30 @@ async function captureHandbackText(input) {
         input.leaseOptions
       );
     } catch {
-      acquired = false;
+      acquired = null;
     }
     if (acquired) break;
     if (Date.now() >= deadline) break;
     await sleep3(acquireBackoffMs);
   }
   if (!acquired) {
-    return { status: "degraded_pty_only", text: null, interferenceDetected: false };
+    return { status: "lease_unavailable", text: null, interferenceDetected: false };
   }
+  const leaseToken = acquired;
   try {
     let interferenceDetected = false;
     for (let attempt = 0; attempt <= recaptureAttempts; attempt += 1) {
       if (attempt > 0) await sleep3(recaptureBackoffMs);
       const c0 = await input.readChangeCount();
-      const clip = await input.runCapture();
+      let clip;
+      try {
+        clip = await input.runCapture();
+      } catch (err) {
+        if (err instanceof CaptureIoTimeoutError) {
+          return { status: "timed_out", text: null, interferenceDetected };
+        }
+        throw err;
+      }
       const cn = await input.readChangeCount();
       const checkAvailable = c0 !== null && cn !== null;
       const delta = checkAvailable ? cn - c0 : null;
@@ -13991,7 +14062,7 @@ async function captureHandbackText(input) {
     }
     return { status: "degraded_pty_only", text: null, interferenceDetected: true };
   } finally {
-    releaseCaptureLease(input.db, input.collabId);
+    releaseCaptureLease(input.db, input.collabId, leaseToken);
   }
 }
 
@@ -14001,15 +14072,20 @@ import { existsSync as existsSync11 } from "node:fs";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 import { dirname as dirname6, join as join20 } from "node:path";
 var HELPER_BIN_NAME = "clipboard-change-count";
-function execFileText2(command, args = []) {
+function execFileText2(command, args = [], timeoutMs) {
   return new Promise((resolve5, reject) => {
-    execFile3(command, args, { encoding: "utf8" }, (error, stdout) => {
-      if (error) {
-        reject(error instanceof Error ? error : new Error("helper failed"));
-        return;
+    execFile3(
+      command,
+      args,
+      { encoding: "utf8", timeout: timeoutMs ?? 0, killSignal: "SIGTERM" },
+      (error, stdout) => {
+        if (error) {
+          reject(error instanceof Error ? error : new Error("helper failed"));
+          return;
+        }
+        resolve5(stdout);
       }
-      resolve5(stdout);
-    });
+    );
   });
 }
 function makeChangeCountReader(deps) {
@@ -14018,7 +14094,7 @@ function makeChangeCountReader(deps) {
     const here = dirname6(fileURLToPath3(import.meta.url));
     const bin = join20(here, "..", "native", HELPER_BIN_NAME);
     if (!existsSync11(bin)) throw new Error("changeCount helper not built");
-    return execFileText2(bin);
+    return execFileText2(bin, [], deps?.timeoutMs);
   });
   return async () => {
     if (platform !== "darwin") return null;
@@ -14133,7 +14209,13 @@ function resolvePositiveIntEnv(name) {
   const n = Number(process.env[name] ?? "");
   return Number.isFinite(n) && n > 0 ? Math.floor(n) : void 0;
 }
-var readChangeCount = makeChangeCountReader();
+var clipboardIoTimeoutMs = resolvePositiveIntEnv("AI_WHISPER_CLIPBOARD_IO_TIMEOUT_MS") ?? 8e3;
+var captureWatchdogMs = resolvePositiveIntEnv("AI_WHISPER_CAPTURE_WATCHDOG_MS") ?? 2e4;
+var captureLeaseTtlMs = Math.max(
+  captureWatchdogMs + 5e3,
+  DEFAULT_LEASE_TTL_MS
+);
+var readChangeCount = makeChangeCountReader({ timeoutMs: clipboardIoTimeoutMs });
 function safeReapSessions(input) {
   const reap = input.reap ?? ((collabId, agentType, keepSessionId) => {
     const db = openDatabase(getSharedSqlitePath());
@@ -14245,7 +14327,11 @@ function createMountSessionRuntime(input) {
                 agentType: input.target,
                 attachmentKind: "mounted"
               });
-              releaseCaptureLease(db, resolvedClaim.collabId);
+              releaseCaptureLeaseForHolderPid(
+                db,
+                resolvedClaim.collabId,
+                process.pid
+              );
             } finally {
               db.close();
             }
@@ -14453,6 +14539,7 @@ function createMountSessionRuntime(input) {
                 turnText,
                 readChangeCount,
                 copySignature,
+                leaseOptions: { ttlMs: captureLeaseTtlMs },
                 runCapture: () => captureClipboardHandback({
                   triggerCopy: () => submitInjectedInput2("/copy"),
                   // Some provider versions show a picker after /copy (e.g. Claude
@@ -14461,7 +14548,8 @@ function createMountSessionRuntime(input) {
                   confirmPicker: () => {
                     writeInjectedInput("mounted-submit-picker", "\r");
                   },
-                  triggerDelayMs: 300
+                  triggerDelayMs: 300,
+                  clipboardTimeoutMs: clipboardIoTimeoutMs
                 })
               });
             } finally {
@@ -14490,6 +14578,7 @@ function createMountSessionRuntime(input) {
           autoHandbackRetryMs: resolvePositiveIntEnv(
             "AI_WHISPER_AUTO_HANDBACK_RETRY_MS"
           ),
+          captureWatchdogMs,
           // Protocol-native providers (ai-ezio) expose onTurnFinished; for them
           // the quiescence /copy auto-handback is skipped (handback comes from
           // the explicit idle event). Event-enabled claude/codex ALSO suppress it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-whisper",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Terminal-first relay for paired AI coding agents (Claude + Codex), driven by structured workflows.",
   "license": "Apache-2.0",
   "repository": {
@@ -53,10 +53,10 @@
     "ink-testing-library": "^4.0.0",
     "@ai-whisper/adapter-ai-ezio": "0.0.0",
     "@ai-whisper/adapter-claude": "0.0.0",
-    "@ai-whisper/companion-core": "0.0.0",
+    "@ai-whisper/adapter-codex": "0.0.0",
     "@ai-whisper/broker": "0.0.0",
-    "@ai-whisper/shared": "0.0.0",
-    "@ai-whisper/adapter-codex": "0.0.0"
+    "@ai-whisper/companion-core": "0.0.0",
+    "@ai-whisper/shared": "0.0.0"
   },
   "files": [
     "dist",