agent-yes 1.272.0 → 1.274.0

package/ts/subcommands.ts

@@ -12,9 +12,7 @@
  */
 
 import { randomBytes } from "crypto";
-import { spawn } from "child_process";
 import { appendFile, mkdir, open, readFile, stat, writeFile } from "fs/promises";
-import { fileURLToPath } from "node:url";
 import ms from "ms";
 import { homedir } from "os";
 import path from "path";
@@ -445,8 +443,7 @@ const SUBCOMMANDS = new Set([
   "expose",
   "callback",
   "reap",
-  "deepseek",
-  "ds",
+  "gc",
   "help",
 ]);
 
@@ -715,9 +712,20 @@ export async function runSubcommand(argv: string[]): Promise<number | null> {
         await reaper.sweep();
         return 0;
       }
-      case "deepseek":
-      case "ds":
-        return cmdDeepseek(rest);
+      case "gc": {
+        const { gcOldBinaryDirs } = await import("./rustBinary.ts");
+        const res = gcOldBinaryDirs();
+        if (res.removed.length === 0) {
+          process.stdout.write("no old agent-yes binary cache dirs to remove\n");
+        } else {
+          for (const v of res.removed) process.stdout.write(`removed ${v}\n`);
+          const mib = (res.freedBytes / 1024 / 1024).toFixed(1);
+          process.stdout.write(
+            `freed ${mib} MiB (${res.freedBytes} bytes) across ${res.removed.length} version dir(s)\n`,
+          );
+        }
+        return 0;
+      }
       case "help":
         return cmdHelp(managerCommands);
       default:
@@ -730,47 +738,6 @@ export async function runSubcommand(argv: string[]): Promise<number | null> {
   }
 }
 
-// ---------------------------------------------------------------------------
-// ay deepseek / ay ds
-// ---------------------------------------------------------------------------
-
-/**
- * `ay deepseek [-- <args>…]` / `ay ds …`: run the local DeepSeek adapter that
- * bridges Codex's Responses API to DeepSeek's chat completions, then spawn
- * `codex` pointed at it. The adapter script lives in this package's
- * `scripts/deepseek-codex.ts` and is Bun-only (Bun.serve / Bun.spawn), so it is
- * re-exec'd via the same bun runtime that's running us — never imported into
- * this process. Extra args are forwarded verbatim to `codex`.
- */
-export function cmdDeepseek(rest: string[]): Promise<number> {
-  const root = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
-  const script = path.join(root, "scripts", "deepseek-codex.ts");
-  const bunBin = process.execPath.split(/[/\\]/).at(-1)?.startsWith("bun")
-    ? process.execPath
-    : "bun";
-  const child = spawn(bunBin, [script, ...rest], {
-    cwd: process.cwd(),
-    env: { ...process.env, AGENT_YES_BIN: process.argv[1] },
-    stdio: "inherit",
-  });
-  return new Promise((resolve) => {
-    child.on("error", (err) => {
-      process.stderr.write(`ay deepseek: failed to start: ${err.message}\n`);
-      resolve(1);
-    });
-    child.on("exit", (code, signal) => {
-      if (signal) {
-        resolve(128 + (signal === "SIGINT" ? 2 : signal === "SIGTERM" ? 15 : 1));
-      } else {
-        resolve(code ?? 1);
-      }
-    });
-    for (const signal of ["SIGINT", "SIGTERM"] as const) {
-      process.on(signal, () => child.kill(signal));
-    }
-  });
-}
-
 // ---------------------------------------------------------------------------
 // ay help
 // ---------------------------------------------------------------------------
@@ -830,6 +797,11 @@ async function buildAgentContextSection(self: GlobalPidRecord): Promise<string>
     `     --advisor is a claude-cli flag — only takes effect for claude/cy)\n` +
     `  List agents (your children nest under your own pid in the tree):\n` +
     `    ay ls --cwd ${shortenPath(self.cwd)}\n` +
+    `  Get notified when a sub-agent finishes / goes idle / crashes (preferred):\n` +
+    `    ay notify watch --unread\n` +
+    `    (one watch loop for your whole fan-out: needs_input / idle / exited edges land\n` +
+    `     in your inbox; a hard child crash is caught by the 2s liveness poll, which\n` +
+    `     nothing push-based can see)\n` +
     `  Watch agent state changes, scoped to your workspace:\n` +
     `    ay ls --watch --cwd ${shortenPath(self.cwd)}\n` +
     `    (NDJSON stream of state changes across every matched agent — one watcher\n` +
@@ -886,11 +858,12 @@ export async function cmdHelp(managerCommands = true): Promise<number> {
       `  ay exit <keyword> [reason]          graceful shutdown, recording who/why (= 'ay send <kw> exit')\n` +
       `  ay restart <keyword> [--fresh]      stop (if live) + relaunch resuming the session; --fresh replays the prompt\n` +
       `  ay status <keyword>                 agent status snapshot\n` +
+      `  ay notify watch --unread            get notified when sub-agents finish/stuck/crash (writes to inbox)\n` +
       `  ay whoami [--json]                  (inside an agent) your own registry identity + reply address\n` +
       `  ay result <keyword> [--wait]        pull an agent's structured result envelope\n` +
       `  ay result set '<json>'              (inside an agent) deposit your result envelope\n` +
       `  ay reap                             kill process groups leaked by dead agents\n` +
-      `  ay deepseek|ds [-- <codex args>]    run codex via the local DeepSeek adapter (DEEPSEEK_API_KEY)\n` +
+      `  ay gc                               remove old-version binary cache dirs and report freed space\n` +
       wsLines +
       `\n` +
       `Remote:\n` +
@@ -906,7 +879,7 @@ export async function cmdHelp(managerCommands = true): Promise<number> {
       `  ay send <token>@<host>:<port>:<kw> <msg>\n` +
       `\n` +
       `Run an agent (naming a CLI is what launches one — bare 'ay' shows this help):\n` +
-      `  ay <claude|codex|gemini|...> [options] -- [prompt]\n` +
+      `  ay <claude|codex|...> [options] -- [prompt]\n` +
       `  ay claude -- "fix the bug in auth.ts"\n` +
       `  cy [options] -- [prompt]            shortcut for 'ay claude' (bare 'cy' starts claude)\n` +
       `  ay claude --help                    full agent-runner options\n` +
@@ -1181,12 +1154,12 @@ async function runRemoteLs(
   if (records.length === 0) {
     process.stderr.write(
       remote.keyword
-        ? `no agents matched "${remote.keyword}" on ${remote.url}\n`
-        : `no running agents on ${remote.url}\n`,
+        ? `no agents matched "${remote.keyword}" on ${remote.label}\n`
+        : `no running agents on ${remote.label}\n`,
     );
     return 0;
   }
-  process.stderr.write(`[remote ${remote.url}]\n`);
+  process.stderr.write(`[remote ${remote.label}]\n`);
   const termWidth = (process.stdout as any).columns ?? 120;
   const widths = {
     pid: Math.max(3, ...records.map((r: any) => String(r.pid).length)),
@@ -1249,7 +1222,7 @@ async function runRemoteRead(
     let attempt = 0;
 
     process.stderr.write(
-      `[remote ${remote.url}  ${keyword}]\nfollowing... (Ctrl-C to stop, timeout: ${Math.round(reconnectTimeoutMs / 1000)}s)\n`,
+      `[remote ${remote.label}  ${keyword}]\nfollowing... (Ctrl-C to stop, timeout: ${Math.round(reconnectTimeoutMs / 1000)}s)\n`,
     );
 
     while (!ac.signal.aborted) {
@@ -1325,7 +1298,7 @@ async function runRemoteRead(
     return 1;
   }
   const text = await res.text();
-  process.stderr.write(`[remote ${remote.url}  ${keyword}]\n`);
+  process.stderr.write(`[remote ${remote.label}  ${keyword}]\n`);
   process.stdout.write(text);
   if (!text.endsWith("\n")) process.stdout.write("\n");
   return 0;
@@ -1359,7 +1332,7 @@ async function runRemoteSend(remote: ResolvedRemote, msg: string, code: string):
     cwd?: string;
     agentId?: string;
   };
-  process.stdout.write(`sent to remote pid ${data.pid} (${remote.url}  ${keyword})\n`);
+  process.stdout.write(`sent to remote pid ${data.pid} (${remote.label}  ${keyword})\n`);
   // Record the sender's half of the exchange locally (the recipient's inbox is
   // recorded on the remote host by its /api/send handler). Only real bodies.
   if (msg && msg !== "-") {
@@ -1376,7 +1349,7 @@ async function runRemoteSend(remote: ResolvedRemote, msg: string, code: string):
       code: code.toLowerCase() === "enter" ? undefined : code.toLowerCase(),
       confirmed: true,
       wrapped: false,
-      remote: remote.url,
+      remote: remote.label,
     });
   }
   return 0;
@@ -1419,7 +1392,7 @@ async function runRemoteSpawn(
     if (name === "TimeoutError" || name === "AbortError") {
       // The request may or may not have spawned — do NOT retry. Let the operator check.
       process.stderr.write(
-        `remote spawn: no response from ${remote.url} within ${Math.round(SPAWN_TIMEOUT_MS / 1000)}s — ` +
+        `remote spawn: no response from ${remote.label} within ${Math.round(SPAWN_TIMEOUT_MS / 1000)}s — ` +
           `result UNKNOWN (not retried).\n  ay ls ${hint}    # check whether it started\n`,
       );
       return 2;
@@ -1440,7 +1413,7 @@ async function runRemoteSpawn(
     provisioned?: { action: string };
   };
   process.stdout.write(
-    `spawned ${r.cli} on ${remote.url} in ${r.cwd}` +
+    `spawned ${r.cli} on ${remote.label} in ${r.cwd}` +
       `${r.hook ? " (via spawn hook)" : ""}` +
       `${r.provisioned ? ` (${r.provisioned.action})` : ""}\n`,
   );
@@ -1452,10 +1425,14 @@ async function runRemoteSpawn(
   if (r.agentId && !hint.includes("://")) {
     process.stderr.write(
       `\n  ay tail ${hint}:${r.agentId}            # watch its output\n` +
-        `  ay status ${hint}:${r.agentId} --wait   # block until it needs you\n`,
+        `  ay status ${hint}:${r.agentId} --wait   # block until it needs you\n` +
+        `  ay notify watch --unread       # get notified when it finishes/stuck/crashes\n`,
     );
   } else {
-    process.stderr.write(`\n  ay ls ${hint}    # the new ${r.cli} agent appears here\n`);
+    process.stderr.write(
+      `\n  ay ls ${hint}    # the new ${r.cli} agent appears here\n` +
+        `  ay notify watch --unread   # get notified when it finishes/stuck/crashes\n`,
+    );
   }
   return 0;
 }
@@ -3075,7 +3052,7 @@ async function cmdSpawn(rest: string[]): Promise<number> {
     .option("cli", {
       type: "string",
       default: "claude",
-      description: "CLI to wrap (claude|codex|gemini|…)",
+      description: "CLI to wrap (claude|codex|…)",
     })
     .option("cwd", {
       type: "string",
@@ -3983,7 +3960,6 @@ export function stopTipForCli(cli: string, pid: number): string | null {
 /// Verified against current upstream CLIs:
 ///   claude   — `/exit`
 ///   codex    — `/exit`
-///   gemini   — `/quit`
 ///   bash/cmd/powershell — `exit` (the shell builtin; closes the session at a
 ///     bare prompt, far cleaner than Ctrl+C which would instead hit whatever
 ///     app is running in the foreground).
@@ -3992,7 +3968,6 @@ export function stopTipForCli(cli: string, pid: number): string | null {
 export const GRACEFUL_EXIT_COMMANDS: Record<string, string> = {
   claude: "/exit",
   codex: "/exit",
-  gemini: "/quit",
   bash: "exit",
   cmd: "exit",
   powershell: "exit",
@@ -5355,9 +5330,60 @@ function printNotifyEvents(events: NotifyEvent[], json: boolean): void {
   }
 }
 
+/** Full usage for `ay notify --help` / `ay notify watch --help`. Every verb and
+ *  option is listed so the caller never needs to enter the watch loop to find
+ *  out what the subcommand does. */
+function notifyHelp(): number {
+  process.stdout.write(
+    `ay notify — read sub-agent status-transition notifications (see docs/subagent-notify.md)\n\n` +
+      `A parent runs ONE command in its Monitor loop to get every child's\n` +
+      `needs_input / idle / exited edge, each with a payload (question / tail /\n` +
+      `git head) so it can act without tailing the child:\n\n` +
+      `  ay notify watch --unread          # tail your inbox; ensures the daemon is up\n\n` +
+      `Usage:\n` +
+      `  ay notify watch [--parent <pid>] [--since <seq>] [--since-ts <ms>] [--unread]\n` +
+      `                   [--ack] [--json] [--consumer <name>] [--interval <s>]\n` +
+      `                   [--no-ensure-daemon]\n` +
+      `  ay notify read  [--parent <pid>] [--since <seq>] [--since-ts <ms>] [--unread]\n` +
+      `                   [--ack] [--json] [--consumer <name>] [--postmortem]\n` +
+      `                   [--started-at <ms>]\n` +
+      `  ay notify cursor get|set <seq> [--parent <pid>] [--consumer <name>]\n\n` +
+      `Verbs:\n` +
+      `  watch    tail -f the inbox (at-least-once by default; --ack advances the cursor)\n` +
+      `  read     one-shot drain of the inbox\n` +
+      `  cursor   get/set the persisted unread cursor (multiple readers via --consumer)\n\n` +
+      `Options:\n` +
+      `  --parent <pid>      parent pid whose inbox to drain (default: $AGENT_YES_PID)\n` +
+      `  --since <seq>       only edges with seq greater than this\n` +
+      `  --since-ts <ms>     only edges at/after this epoch-ms\n` +
+      `  --unread            only edges past the saved cursor\n` +
+      `  --ack               advance the cursor past what's shown (at-least-once: off by default)\n` +
+      `  --json              emit raw NDJSON events\n` +
+      `  --consumer <name>   cursor identity (for multiple readers, default: parent)\n` +
+      `  --interval <s>      poll interval in seconds (watch, default: 2)\n` +
+      `  --no-ensure-daemon  don't start the notifyd singleton if not running (watch)\n` +
+      `  --postmortem        read-only: inspect an inbox whose parent has exited (read)\n` +
+      `  --started-at <ms>   disambiguate which incarnation to show (--postmortem)\n\n` +
+      `Daemon (ay notifyd):\n` +
+      `  ay notifyd run|start|status|stop    the detection engine (auto-started by watch)\n`,
+  );
+  return 0;
+}
+
 async function cmdNotify(rest: string[]): Promise<number> {
   const verb = rest[0];
   const args = rest.slice(1);
+  // --help / -h (at either the verb or the sub-verb position) returns the full
+  // usage immediately — it must never fall through into the watch loop.
+  if (
+    verb === "help" ||
+    verb === "--help" ||
+    verb === "-h" ||
+    args.includes("--help") ||
+    args.includes("-h")
+  ) {
+    return notifyHelp();
+  }
 
   if (verb === "cursor") return cmdNotifyCursor(args);
   if (verb !== "read" && verb !== "watch") {

package/ts/todoParse.ts

@@ -1,7 +1,7 @@
 /**
  * Parse an agent's todo/task list out of its RENDERED TUI screen.
  *
- * Source of truth for EVERY CLI (claude, codex, gemini, …) is the screen the
+ * Source of truth for EVERY CLI (claude, codex, …) is the screen the
  * agent draws — never a CLI-specific session file. The durable copy is the
  * per-pid raw log (`<cwd>/.agent-yes/<pid>.raw.log`); rendering it through a
  * headless xterm (see renderRawLog) collapses the reflow/redraw frames into the

package/dist/SUPPORTED_CLIS-C1rgBiLd.js

@@ -1,12 +0,0 @@
-import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-D9LB-MW5.js";
-import "./ts-Bb-h7XQP.js";
-import "./todoAutomation-BETGOik9.js";
-import "./JsonlStore-CPGIR0Wy.js";
-import "./globalPidIndex-Dq4KY2IV.js";
-import "./pidStore-DJqSZPJi.js";
-import "./messageLog-BYFwioFY.js";
-import "./todoStore-Wk8U4zJ8.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DFOStQkx.js";
-
-export { SUPPORTED_CLIS };

package/dist/callback-C64-nP2U.js

@@ -1,13 +0,0 @@
-import "./logger-CDIsZ-Pp.js";
-import "./globalPidIndex-Dq4KY2IV.js";
-import "./messageLog-BYFwioFY.js";
-import "./e2e-OLfcNxiv.js";
-import "./configShared-DYxlvrH0.js";
-import "./subcommands-DKqbwkvb.js";
-import "./notifyStore-Dus2D1XA.js";
-import "./webrtcLink-B72AQ2eb.js";
-import "./remotes-IzQHupeo.js";
-import "./callbackCore-Bbe7rpN2.js";
-import { i as loadOrCreateCallbackSecret, n as isCallbackRevoked, r as loadCallbackSecretReadOnly, t as cmdCallback } from "./callback-BVKHRbUE.js";
-
-export { cmdCallback };

package/dist/gemini-yes.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env bun
-import { existsSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-const root = join(dirname(fileURLToPath(import.meta.url)), "..");
-if (typeof Bun !== "undefined" && existsSync(join(root, ".git"))) {
-  await import("../ts/cli.ts");
-} else {
-  await import("./cli.js");
-}

package/dist/openrouter-yes.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env bun
-import { existsSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-const root = join(dirname(fileURLToPath(import.meta.url)), "..");
-if (typeof Bun !== "undefined" && existsSync(join(root, ".git"))) {
-  await import("../ts/cli.ts");
-} else {
-  await import("./cli.js");
-}

package/dist/orcy.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env bun
-import { existsSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-const root = join(dirname(fileURLToPath(import.meta.url)), "..");
-if (typeof Bun !== "undefined" && existsSync(join(root, ".git"))) {
-  await import("../ts/cli.ts");
-} else {
-  await import("./cli.js");
-}

package/dist/peer-u1AUAZeA.js

@@ -1,4 +0,0 @@
-import "./e2e-OLfcNxiv.js";
-import { t as ChannelPeer } from "./peer-Dr4zvtcd.js";
-
-export { ChannelPeer };

package/dist/pidStore-D-b8I6Qx.js

@@ -1,6 +0,0 @@
-import "./logger-CDIsZ-Pp.js";
-import "./JsonlStore-CPGIR0Wy.js";
-import "./globalPidIndex-Dq4KY2IV.js";
-import { t as PidStore } from "./pidStore-DJqSZPJi.js";
-
-export { PidStore };

package/dist/spawnGate-C6YKlnmb.js

@@ -1,5 +0,0 @@
-import "./logger-CDIsZ-Pp.js";
-import "./globalPidIndex-Dq4KY2IV.js";
-import { i as waitForSpawnCapacity, n as spawnGateEnabled, r as spawnRejectionReason, t as memAvailableMb } from "./spawnGate-CS3oFdJ9.js";
-
-export { waitForSpawnCapacity };

package/dist/subcommands-TAOmVCxo.js

@@ -1,11 +0,0 @@
-import "./logger-CDIsZ-Pp.js";
-import "./globalPidIndex-Dq4KY2IV.js";
-import "./messageLog-BYFwioFY.js";
-import "./e2e-OLfcNxiv.js";
-import "./configShared-DYxlvrH0.js";
-import { A as menuSelectKeys, B as resolveOne, C as isSubcommand, D as lastStdinAt, E as lastReadAt, F as recentMessageEdges, G as snapshotStatus, H as resolveResumeArgs, I as recentReadEdges, J as submitAndConfirm, K as stdinActivityPath, L as renderLogTailLines, M as readLogForRender, N as readNotes, O as listRecords, P as readPtysize, R as renderRawLog, S as isSlashCommand, T as isUserTyping, U as restartHintLines, V as resolveReadWindow, W as runSubcommand, X as writeKeysPaced, Y as waitForLogQuiet, Z as writeToIpc, _ as finalizedLines, a as TYPING_WINDOW_MS, b as isExitRequest, c as cmdHelp, d as deriveLiveState, f as deriveLiveStatus, g as extractTaskCounts, h as extractNeedsInput, i as READ_WINDOW_MS, j as readAgentPtysize, k as matchKeyword, l as controlCodeFromName, m as extractMenu, n as MAX_RENDER_BYTES, o as backoffWhileTyping, p as extractBadges, q as stopTipForCli, r as READ_PAGE_DEFAULT, s as cmdDeepseek, t as GRACEFUL_EXIT_COMMANDS, u as cursorAbs, v as isAgentStuck, w as isUnknownManagerToken, x as isPidAlive, y as isBareManagerInvocation, z as renderRawLogLines } from "./subcommands-DKqbwkvb.js";
-import "./notifyStore-Dus2D1XA.js";
-import "./webrtcLink-B72AQ2eb.js";
-import "./remotes-IzQHupeo.js";
-
-export { READ_WINDOW_MS, cmdHelp, isBareManagerInvocation, isSubcommand, isUnknownManagerToken, lastReadAt, runSubcommand };

package/dist/trayApp-BHx2FN2d.js

@@ -1,5 +0,0 @@
-import "./versionChecker-D9LB-MW5.js";
-import "./rustBinary-ISnNc7Uf.js";
-import { a as trayHiddenMarker, i as launchTray, n as hasDesktop, r as isTrayHidden, t as cmdTray } from "./trayApp-BsETHuMR.js";
-
-export { cmdTray };

package/dist/ws-CklRMQwW.js

@@ -1,12 +0,0 @@
-import "./logger-CDIsZ-Pp.js";
-import "./globalPidIndex-Dq4KY2IV.js";
-import "./messageLog-BYFwioFY.js";
-import "./e2e-OLfcNxiv.js";
-import "./configShared-DYxlvrH0.js";
-import "./subcommands-DKqbwkvb.js";
-import "./notifyStore-Dus2D1XA.js";
-import "./webrtcLink-B72AQ2eb.js";
-import "./remotes-IzQHupeo.js";
-import { a as isPathInside, c as walkWorkspaces, i as importProvisionModule, l as workspaceStatus, n as cmdWs, o as loadProvision, r as collectWorkspaces, s as resolveOperand, t as WS_JSON_SCHEMA } from "./ws-BFli3FKi.js";
-
-export { WS_JSON_SCHEMA, cmdWs, collectWorkspaces, isPathInside, loadProvision, walkWorkspaces, workspaceStatus };