agent-yes 1.140.2 → 1.142.0

package/dist/SUPPORTED_CLIS-BKX1tigt.js

@@ -0,0 +1,8 @@
+import "./ts-DkAVuuIK.js";
+import "./logger-CDIsZ-Pp.js";
+import "./versionChecker-Dl2LrFFo.js";
+import "./pidStore-fqXqTKkh.js";
+import "./globalPidIndex-DlmmJlO8.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-C03sKqhu.js";
+
+export { SUPPORTED_CLIS };

package/dist/{SUPPORTED_CLIS-CTOnaXTX.js → SUPPORTED_CLIS-C03sKqhu.js}

@@ -1,8 +1,8 @@
-import { t as CLIS_CONFIG } from "./ts-B1-x2rKP.js";
+import { t as CLIS_CONFIG } from "./ts-DkAVuuIK.js";
 
 //#region ts/SUPPORTED_CLIS.ts
 const SUPPORTED_CLIS = Object.keys(CLIS_CONFIG);
 
 //#endregion
 export { SUPPORTED_CLIS as t };
-//# sourceMappingURL=SUPPORTED_CLIS-CTOnaXTX.js.map
+//# sourceMappingURL=SUPPORTED_CLIS-C03sKqhu.js.map

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 import { t as invokedCliName } from "./invokedCli-zdFbz1ST.js";
 import { n as logger } from "./logger-CDIsZ-Pp.js";
-import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-Bhn4NygE.js";
+import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-Dl2LrFFo.js";
 import { argv } from "process";
 import { execFileSync, spawn } from "child_process";
 import ms from "ms";
@@ -480,7 +480,7 @@ function buildRustArgs(argv, cliFromScript, supportedClis) {
 	const rawArg = process.argv[2];
 	const managerCommands = !invokedCliName(process.argv);
 	const isHelpFlag = rawArg === "-h" || rawArg === "--help";
-	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-DKizMTs9.js");
+	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-DyhY1zTt.js");
 	if (isHelpFlag && process.argv.length === 3) {
 		cmdHelp(managerCommands);
 		process.exit(0);
@@ -513,7 +513,7 @@ if (config.useRust) {
 		}
 	}
 	if (rustBinary) {
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-DYcaH-bR.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-BKX1tigt.js");
 		const rustArgs = buildRustArgs(process.argv, config.cli, SUPPORTED_CLIS);
 		if (config.verbose) {
 			console.log(`[rust] Using binary: ${rustBinary}`);

package/dist/index.js

@@ -1,6 +1,6 @@
-import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-B1-x2rKP.js";
+import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-DkAVuuIK.js";
 import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-Bhn4NygE.js";
+import "./versionChecker-Dl2LrFFo.js";
 import "./pidStore-fqXqTKkh.js";
 import "./globalPidIndex-DlmmJlO8.js";
 

package/dist/{schedule-DZb7ZQgW.js → schedule-BB_gXj7p.js}

@@ -1,9 +1,9 @@
-import "./ts-B1-x2rKP.js";
+import "./ts-DkAVuuIK.js";
 import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-Bhn4NygE.js";
+import "./versionChecker-Dl2LrFFo.js";
 import "./pidStore-fqXqTKkh.js";
 import "./globalPidIndex-DlmmJlO8.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CTOnaXTX.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-C03sKqhu.js";
 import { n as resolveSpawnCwd } from "./workspaceConfig-BCOqRBEW.js";
 import { createHash } from "node:crypto";
 
@@ -141,4 +141,4 @@ async function cmdSchedule(rest) {
 
 //#endregion
 export { cmdSchedule };
-//# sourceMappingURL=schedule-DZb7ZQgW.js.map
+//# sourceMappingURL=schedule-BB_gXj7p.js.map

package/dist/{serve-BBwXw8gY.js → serve-B8tHXvH2.js}

@@ -1,13 +1,13 @@
-import "./ts-B1-x2rKP.js";
+import "./ts-DkAVuuIK.js";
 import "./logger-CDIsZ-Pp.js";
-import { r as getInstalledPackage } from "./versionChecker-Bhn4NygE.js";
+import { r as getInstalledPackage } from "./versionChecker-Dl2LrFFo.js";
 import "./pidStore-fqXqTKkh.js";
 import { a as updateGlobalPidStatus } from "./globalPidIndex-DlmmJlO8.js";
 import { t as pgidForWrapper } from "./reaper-C-eWAxIj.js";
 import "./configShared-C1C04bbq.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CTOnaXTX.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-C03sKqhu.js";
 import "./remotes-PKKjfTI1.js";
-import { S as writeToIpc, _ as resolveOne, b as snapshotStatus, c as extractTaskCounts, f as listRecords, h as renderRawLog, i as controlCodeFromName, m as readNotes, o as deriveLiveStatus } from "./subcommands-Cz7-sHOT.js";
+import { S as snapshotStatus, _ as renderRawLog, c as extractTaskCounts, g as readNotes, i as controlCodeFromName, m as listRecords, o as deriveLiveStatus, w as writeToIpc, y as resolveOne } from "./subcommands-OKH2CsBu.js";
 import yargs from "yargs";
 import { mkdir, open, readFile, stat, writeFile } from "fs/promises";
 import { homedir, hostname, userInfo } from "os";
@@ -1175,4 +1175,4 @@ Options:
 
 //#endregion
 export { cmdServe };
-//# sourceMappingURL=serve-BBwXw8gY.js.map
+//# sourceMappingURL=serve-B8tHXvH2.js.map

package/dist/{setup-S9LoYWK5.js → setup-DKF0uPs6.js}

@@ -32,7 +32,7 @@ async function cmdSetup(rest) {
 	if (!existsSync(abs)) process.stderr.write(`  note: that directory doesn't exist yet — create it, or agents spawned there will fail\n`);
 	if (noShare) return 0;
 	process.stdout.write(`\nsharing this machine to agent-yes.com…\n`);
-	const { cmdServe } = await import("./serve-BBwXw8gY.js");
+	const { cmdServe } = await import("./serve-B8tHXvH2.js");
 	return cmdServe([
 		"install",
 		"--share",
@@ -42,4 +42,4 @@ async function cmdSetup(rest) {
 
 //#endregion
 export { cmdSetup };
-//# sourceMappingURL=setup-S9LoYWK5.js.map
+//# sourceMappingURL=setup-DKF0uPs6.js.map

package/dist/subcommands-DyhY1zTt.js

@@ -0,0 +1,7 @@
+import "./logger-CDIsZ-Pp.js";
+import "./globalPidIndex-DlmmJlO8.js";
+import "./configShared-C1C04bbq.js";
+import "./remotes-PKKjfTI1.js";
+import { C as stopTipForCli, S as snapshotStatus, _ as renderRawLog, a as cursorAbs, b as resolveReadWindow, c as extractTaskCounts, d as isExitRequest, f as isPidAlive, g as readNotes, h as matchKeyword, i as controlCodeFromName, l as finalizedLines, m as listRecords, n as READ_PAGE_DEFAULT, o as deriveLiveStatus, p as isSubcommand, r as cmdHelp, s as extractNeedsInput, t as GRACEFUL_EXIT_COMMANDS, u as isAgentStuck, v as renderRawLogLines, w as writeToIpc, x as runSubcommand, y as resolveOne } from "./subcommands-OKH2CsBu.js";
+
+export { cmdHelp, isSubcommand, runSubcommand };

package/dist/{subcommands-Cz7-sHOT.js → subcommands-OKH2CsBu.js}

@@ -182,6 +182,19 @@ function classifyNeedsInput(lines, cfg) {
 	const end = Math.min(lines.length, last + 6);
 	return { question: lines.slice(start, end).map((l) => l.trim()).filter((l) => l && !isChromeLine(l)).join(" • ").slice(0, 400) };
 }
+/**
+* True when the rendered screen still shows a "busy" marker (config `working`,
+* e.g. claude's `esc to interrupt`). Paired with a long-quiet log this is the
+* `stuck` signal: a live spinner writes to the log every frame, so a busy marker
+* on screen WITHOUT recent output means the agent wedged mid-stream (a silent
+* API stream stall) rather than finishing. Pure + synchronous like the rest of
+* this module so it's trivially unit-testable.
+*/
+function isWorkingScreen(lines, working) {
+	if (!working?.length) return false;
+	const text = lines.join("\n");
+	return working.some((re) => reTest(re, text));
+}
 
 //#endregion
 //#region ts/lsWatch.ts
@@ -488,6 +501,7 @@ const SUBCOMMANDS = new Set([
 	"send",
 	"attach",
 	"stop",
+	"exit",
 	"restart",
 	"note",
 	"serve",
@@ -498,6 +512,10 @@ const SUBCOMMANDS = new Set([
 ]);
 const MANAGER_SUBCOMMANDS = new Set(["setup"]);
 const IDLE_THRESHOLD_MS = 60 * 1e3;
+const STUCK_THRESHOLD_MS = (() => {
+	const n = Number(process.env.AGENT_YES_STUCK_MS);
+	return Number.isFinite(n) && n > 0 ? n : 300 * 1e3;
+})();
 /**
 * Whether `name` is a subcommand. `managerCommands` (default true, for the
 * generic `ay`/`agent-yes` entry) additionally admits manager-only commands
@@ -531,18 +549,19 @@ async function runSubcommand(argv) {
 			case "send": return await cmdSend(rest);
 			case "attach": return await cmdAttach(rest);
 			case "stop": return await cmdStop(rest);
+			case "exit": return await cmdExit(rest);
 			case "restart": return await cmdRestart(rest);
 			case "note": return await cmdNote(rest);
 			case "serve": {
-				const { cmdServe } = await import("./serve-BBwXw8gY.js");
+				const { cmdServe } = await import("./serve-B8tHXvH2.js");
 				return cmdServe(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup-S9LoYWK5.js");
+				const { cmdSetup } = await import("./setup-DKF0uPs6.js");
 				return cmdSetup(rest);
 			}
 			case "schedule": {
-				const { cmdSchedule } = await import("./schedule-DZb7ZQgW.js");
+				const { cmdSchedule } = await import("./schedule-BB_gXj7p.js");
 				return cmdSchedule(rest);
 			}
 			case "remote": {
@@ -563,7 +582,7 @@ async function runSubcommand(argv) {
 }
 function cmdHelp(managerCommands = true) {
 	const setupLine = managerCommands ? `  ay setup                            guided setup: pick a workspace, share to agent-yes.com\n` : ``;
-	process.stdout.write("ay - agent-yes CLI\n\nManagement:\n  ay ls [keyword]                     list running agents\n  ay tail [-f] [-n N] <keyword>       last N lines (96), -f to follow\n  ay read <keyword> [page opts]       paginate: --last/--head N, --range A:B,\n                                        --before-line L [--limit N]\n  ay cat <keyword>                    full log\n  ay head <keyword>                   first N lines\n  ay send <keyword> <msg>             send a message\n  ay attach <keyword>                 interactive attach (detach: Ctrl-\\)\n  ay stop <keyword>                   graceful shutdown (/exit for claude/codex)\n  ay status <keyword>                 agent status snapshot\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\nRemote:\n" + setupLine + "  ay schedule <when> <cli> -- <msg>   run an agent on a schedule (HH:MM or cron)\n  ay serve [--port N]                 start HTTP API server (prints token)\n  ay serve status                     show serve daemon/server status\n  ay remote add <alias> http://<token>@<host>:<port>\n  ay remote ls / rm <alias>           manage saved remotes\n  ay ls   <token>@<host>:<port>       connect inline (no alias needed)\n  ay send <token>@<host>:<port>:<kw> <msg>\n\nRun an agent:\n  ay [claude|codex|gemini|...] [options] -- [prompt]\n  ay claude -- \"fix the bug in auth.ts\"\n  ay claude --help                    full agent-runner options\n\nLabs (examples at https://github.com/snomiao/agent-yes/tree/main/lab):\n  local-role-play/   designer + builder on one machine\n  http-remote/       ay serve remote access demo\n  p2p-pairing/       libp2p P2P  (needs: cargo build --features swarm)\n");
+	process.stdout.write("ay - agent-yes CLI\n\nManagement:\n  ay ls [keyword]                     list running agents\n  ay tail [-f] [-n N] <keyword>       last N lines (96), -f to follow\n  ay read <keyword> [page opts]       paginate: --last/--head N, --range A:B,\n                                        --before-line L [--limit N]\n  ay cat <keyword>                    full log\n  ay head <keyword>                   first N lines\n  ay send <keyword> <msg>             send a message\n  ay attach <keyword>                 interactive attach (detach: Ctrl-\\)\n  ay stop <keyword>                   graceful shutdown (/exit for claude/codex)\n  ay exit <keyword> [reason]          graceful shutdown, recording who/why (= 'ay send <kw> exit')\n  ay status <keyword>                 agent status snapshot\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\nRemote:\n" + setupLine + "  ay schedule <when> <cli> -- <msg>   run an agent on a schedule (HH:MM or cron)\n  ay serve [--port N]                 start HTTP API server (prints token)\n  ay serve status                     show serve daemon/server status\n  ay remote add <alias> http://<token>@<host>:<port>\n  ay remote ls / rm <alias>           manage saved remotes\n  ay ls   <token>@<host>:<port>       connect inline (no alias needed)\n  ay send <token>@<host>:<port>:<kw> <msg>\n\nRun an agent:\n  ay [claude|codex|gemini|...] [options] -- [prompt]\n  ay claude -- \"fix the bug in auth.ts\"\n  ay claude --help                    full agent-runner options\n\nLabs (examples at https://github.com/snomiao/agent-yes/tree/main/lab):\n  local-role-play/   designer + builder on one machine\n  http-remote/       ay serve remote access demo\n  p2p-pairing/       libp2p P2P  (needs: cargo build --features swarm)\n");
 	return 0;
 }
 function matchKeyword(record, keyword) {
@@ -977,6 +996,10 @@ async function deriveLiveState(r) {
 			state: "needs_input",
 			question: ni.question
 		};
+		if (base === "idle" && await isAgentStuck(r)) return {
+			state: "stuck",
+			question: null
+		};
 	}
 	return {
 		state: base,
@@ -1000,7 +1023,7 @@ async function cmdLs(rest) {
 		alias: "w",
 		type: "boolean",
 		default: false,
-		description: "Stream agent state transitions (needs_input | idle | active | stopped) as NDJSON across all matched agents — one event stream for a whole fan-out, instead of N per-pid `ay status --watch`es. Runs until Ctrl-C."
+		description: "Stream agent state transitions (needs_input | idle | active | stuck | stopped) as NDJSON across all matched agents — one event stream for a whole fan-out, instead of N per-pid `ay status --watch`es. Runs until Ctrl-C."
 	}).option("interval", {
 		type: "number",
 		default: 2,
@@ -1646,9 +1669,12 @@ function cliDefaults() {
 * and renders it through xterm, then runs the CLI's `needsInput`/`working`
 * patterns. Returns null when no menu is detected (or the CLI defines none).
 */
-async function extractNeedsInput(logPath, cli) {
-	const cfg = (await cliDefaults())[cli];
-	if (!cfg?.needsInput?.length) return null;
+/**
+* Render the last `n` lines of a raw PTY log (reads only the final 32KB). Returns
+* null on any read/render error or an empty log. Shared by the needs_input and
+* stuck classifiers so they don't each re-implement the tail read.
+*/
+async function renderLogTailLines(logPath, n = 40) {
 	const TAIL_BYTES = 32 * 1024;
 	let buf;
 	try {
@@ -1671,17 +1697,41 @@ async function extractNeedsInput(logPath, cli) {
 		return null;
 	}
 	try {
-		return classifyNeedsInput((await renderRawLog(buf, {
+		return (await renderRawLog(buf, {
 			mode: "tail",
-			n: 40
-		})).split("\n"), {
-			needsInput: cfg.needsInput,
-			working: cfg.working
-		});
+			n
+		})).split("\n");
 	} catch {
 		return null;
 	}
 }
+async function extractNeedsInput(logPath, cli) {
+	const cfg = (await cliDefaults())[cli];
+	if (!cfg?.needsInput?.length) return null;
+	const lines = await renderLogTailLines(logPath, 40);
+	if (!lines) return null;
+	return classifyNeedsInput(lines, {
+		needsInput: cfg.needsInput,
+		working: cfg.working
+	});
+}
+/**
+* Whether an alive agent is wedged: its log has been silent for at least
+* STUCK_THRESHOLD_MS yet its screen still shows a `working` busy marker (a live
+* spinner keeps writing, so busy + long-silent = a mid-stream stall). Pass the
+* already-stat'd log mtime to skip a redundant stat. Returns false when the CLI
+* has no `working` markers configured (nothing to key off).
+*/
+async function isAgentStuck(record, logMtimeMs) {
+	if (!record.log_file) return false;
+	const cfg = (await cliDefaults())[record.cli];
+	if (!cfg?.working?.length) return false;
+	const mtime = logMtimeMs ?? await stat(record.log_file).then((s) => s.mtimeMs).catch(() => null);
+	if (mtime === null || Date.now() - mtime < STUCK_THRESHOLD_MS) return false;
+	const lines = await renderLogTailLines(record.log_file, 40);
+	if (!lines) return false;
+	return isWorkingScreen(lines, cfg.working);
+}
 function extractActivityFromLines(lines) {
 	const isChrome = (l) => {
 		const s = l.trim();
@@ -1776,6 +1826,12 @@ async function cmdSend(rest) {
 		if (sender.agent) throw new Error(`${what}.\n  Confirm it's the right agent first:  ay tail ${record.pid}\n  then resend, or pass --force to override.`);
 		process.stderr.write(`warning: ${what} — make sure this is the agent you meant (ay tail ${record.pid}).\n`);
 	}
+	if (isExitRequest(body)) {
+		const reason = sender.agent ? `requested by ${sender.agent.cli} #${sender.agent.pid} @ ${shortenPath(sender.agent.cwd)}` : `requested via 'ay send ${keyword} exit'`;
+		const { strategy } = await gracefulExitAgent(record, reason);
+		process.stdout.write(`pid ${record.pid} (${record.cli}): exit requested — sent ${strategy} (${reason})\n`);
+		return 0;
+	}
 	const fullBody = (sender.agent ? `[from ${sender.agent.cli} #${sender.agent.pid} @ ${shortenPath(sender.agent.cwd)} — reply: ay send ${sender.agent.pid} "..."]\n` : "") + body;
 	if (fullBody && trailing) {
 		await writeToIpc(fifoPath, fullBody);
@@ -1938,6 +1994,74 @@ async function cmdStop(rest) {
 	process.stderr.write(`\n  ay status ${record.pid}                # confirm it exited\n  ay ls --all                            # see exit codes\n`);
 	return 0;
 }
+/** A `send` body that is exactly the exit word (not a sentence that merely
+* contains it). Bare "exit" and the literal "/exit" both qualify. */
+function isExitRequest(body) {
+	const t = body.trim().toLowerCase();
+	return t === "exit" || t === "/exit";
+}
+/**
+* Gracefully terminate a live agent and record WHY in its note (the audit trail
+* shown by `ay ls`). Sends the CLI's graceful-exit command (e.g. claude's
+* `/exit`) or a double-Ctrl+C fallback. `reason` is agent-yes metadata — claude's
+* `/exit` takes no argument, so the reason is the note, not appended to `/exit`.
+* Shared by `ay exit` and by `ay send <kw> exit`'s routing.
+*/
+async function gracefulExitAgent(record, reason) {
+	if (!record.fifo_file) throw new Error(`pid ${record.pid}: no fifo_file — cannot send shutdown command`);
+	await writeNote(record.pid, `↩ exit — ${reason}`).catch(() => {});
+	const fifoPath = record.fifo_file;
+	const graceful = GRACEFUL_EXIT_COMMANDS[record.cli];
+	if (graceful) {
+		await writeToIpc(fifoPath, graceful);
+		await new Promise((r) => setTimeout(r, 200));
+		await writeToIpc(fifoPath, "\r");
+		return { strategy: `'${graceful}' + Enter` };
+	}
+	await writeToIpc(fifoPath, "");
+	await new Promise((r) => setTimeout(r, 200));
+	await writeToIpc(fifoPath, "");
+	return { strategy: `double Ctrl+C (no known /exit for cli "${record.cli}")` };
+}
+async function cmdExit(rest) {
+	const argv = await yargs(rest).usage("Usage: ay exit <keyword> [reason]").option("all", {
+		type: "boolean",
+		default: false,
+		description: "Include exited agents"
+	}).option("latest", {
+		type: "boolean",
+		default: false,
+		description: "Use most recent match"
+	}).option("cwd", {
+		type: "string",
+		description: "Restrict to agents under this dir"
+	}).help(false).version(false).exitProcess(false).parseAsync();
+	const opts = {
+		all: argv.all,
+		active: false,
+		json: false,
+		latest: argv.latest,
+		cwdScope: typeof argv.cwd === "string" ? path.resolve(argv.cwd) : null
+	};
+	const keyword = argv._[0] !== void 0 ? String(argv._[0]) : void 0;
+	if (!keyword) throw new Error("usage: ay exit <keyword> [reason]");
+	const reasonArg = argv._.slice(1).map(String).join(" ").trim();
+	const record = await resolveOne(keyword, opts);
+	if (!isPidAlive(record.pid)) {
+		await updateGlobalPidStatus(record.pid, {
+			status: "exited",
+			exit_reason: "already-stopped"
+		}).catch(() => {});
+		process.stdout.write(`pid ${record.pid} (${record.cli}) already stopped — marked exited\n`);
+		return 0;
+	}
+	const sender = await senderContext();
+	const reason = reasonArg || (sender.agent ? `requested by ${sender.agent.cli} #${sender.agent.pid} @ ${shortenPath(sender.agent.cwd)}` : "manual");
+	const { strategy } = await gracefulExitAgent(record, reason);
+	process.stdout.write(`exiting pid ${record.pid} (${record.cli}) via ${strategy} — ${reason}\n`);
+	process.stderr.write(`\n  ay status ${record.pid}                # confirm it exited\n`);
+	return 0;
+}
 async function cmdAttach(rest) {
 	const argv = await yargs(rest).usage("Usage: ay attach <keyword> [--escape ctrl-\\]").option("escape", {
 		type: "string",
@@ -2189,7 +2313,7 @@ async function snapshotStatus(record) {
 		if (ni) {
 			state = "needs_input";
 			question = ni.question;
-		}
+		} else if (state === "idle" && await isAgentStuck(record, logMtimeMs)) state = "stuck";
 	}
 	const note = (await readNotes()).get(record.pid) ?? null;
 	return {
@@ -2269,7 +2393,7 @@ async function cmdStatus(rest) {
 		const startedAt = Date.now();
 		for (;;) {
 			const snap = await snapshotStatus(record);
-			if (snap.state === "needs_input" || snap.state === "idle" || snap.state === "stopped") {
+			if (snap.state === "needs_input" || snap.state === "idle" || snap.state === "stuck" || snap.state === "stopped") {
 				emit(snap);
 				return 0;
 			}
@@ -2284,7 +2408,7 @@ async function cmdStatus(rest) {
 		const startedAt = Date.now();
 		for (;;) {
 			const snap = await snapshotStatus(record);
-			if (snap.state === "idle") {
+			if (snap.state === "idle" || snap.state === "stuck") {
 				emit(snap);
 				return 0;
 			}
@@ -2456,5 +2580,5 @@ async function cmdResultSet(rest) {
 }
 
 //#endregion
-export { writeToIpc as S, resolveOne as _, cursorAbs as a, snapshotStatus as b, extractTaskCounts as c, isSubcommand as d, listRecords as f, renderRawLogLines as g, renderRawLog as h, controlCodeFromName as i, finalizedLines as l, readNotes as m, READ_PAGE_DEFAULT as n, deriveLiveStatus as o, matchKeyword as p, cmdHelp as r, extractNeedsInput as s, GRACEFUL_EXIT_COMMANDS as t, isPidAlive as u, resolveReadWindow as v, stopTipForCli as x, runSubcommand as y };
-//# sourceMappingURL=subcommands-Cz7-sHOT.js.map
+export { stopTipForCli as C, snapshotStatus as S, renderRawLog as _, cursorAbs as a, resolveReadWindow as b, extractTaskCounts as c, isExitRequest as d, isPidAlive as f, readNotes as g, matchKeyword as h, controlCodeFromName as i, finalizedLines as l, listRecords as m, READ_PAGE_DEFAULT as n, deriveLiveStatus as o, isSubcommand as p, cmdHelp as r, extractNeedsInput as s, GRACEFUL_EXIT_COMMANDS as t, isAgentStuck as u, renderRawLogLines as v, writeToIpc as w, runSubcommand as x, resolveOne as y };
+//# sourceMappingURL=subcommands-OKH2CsBu.js.map

package/dist/{ts-B1-x2rKP.js → ts-DkAVuuIK.js}

@@ -1,5 +1,5 @@
 import { n as logger, t as addTransport } from "./logger-CDIsZ-Pp.js";
-import { r as getInstalledPackage } from "./versionChecker-Bhn4NygE.js";
+import { r as getInstalledPackage } from "./versionChecker-Dl2LrFFo.js";
 import { t as agentYesHome } from "./agentYesHome-_eJa3DaX.js";
 import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-V4qvXgAw.js";
 import { t as PidStore } from "./pidStore-fqXqTKkh.js";
@@ -1788,4 +1788,4 @@ function sleep(ms) {
 
 //#endregion
 export { removeControlCharacters as a, AgentContext as i, agentYes as n, config as r, CLIS_CONFIG as t };
-//# sourceMappingURL=ts-B1-x2rKP.js.map
+//# sourceMappingURL=ts-DkAVuuIK.js.map

package/dist/{versionChecker-Bhn4NygE.js → versionChecker-Dl2LrFFo.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "agent-yes";
-var version = "1.140.2";
+var version = "1.142.0";
 
 //#endregion
 //#region ts/versionChecker.ts
@@ -215,4 +215,4 @@ async function displayVersion() {
 
 //#endregion
 export { versionString as i, displayVersion as n, getInstalledPackage as r, checkAndAutoUpdate as t };
-//# sourceMappingURL=versionChecker-Bhn4NygE.js.map
+//# sourceMappingURL=versionChecker-Dl2LrFFo.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-yes",
-  "version": "1.140.2",
+  "version": "1.142.0",
   "description": "A wrapper tool that automates interactions with various AI CLI tools by automatically handling common prompts and responses.",
   "keywords": [
     "ai",

package/ts/lsWatch.ts

@@ -10,7 +10,7 @@
  * `needsInput.ts`.
  */
 
-export type LiveState = "active" | "idle" | "stopped" | "needs_input";
+export type LiveState = "active" | "idle" | "stopped" | "needs_input" | "stuck";
 
 /** The observable state of one agent at a single tick. */
 export interface LsAgentState {

package/ts/needsInput.spec.ts

@@ -1,5 +1,5 @@
 import { expect, test } from "vitest";
-import { classifyNeedsInput } from "./needsInput.ts";
+import { classifyNeedsInput, isWorkingScreen } from "./needsInput.ts";
 import { loadSharedCliDefaults } from "./configShared.ts";
 
 // Use the REAL shipped claude/codex patterns so the test guards the actual config.
@@ -11,6 +11,25 @@ test("claude config actually ships a needsInput pattern", () => {
   expect(claude.needsInput?.length).toBeGreaterThan(0);
 });
 
+test("claude config ships a working busy marker (the stuck detector keys off it)", () => {
+  expect(claude.working?.length).toBeGreaterThan(0);
+});
+
+test("isWorkingScreen: true when the shipped claude busy marker is on screen", () => {
+  const screen = ["⏺ Running the test suite…", "", "esc to interrupt · ← for agents"];
+  expect(isWorkingScreen(screen, claude.working)).toBe(true);
+});
+
+test("isWorkingScreen: false at a finished/idle prompt (no busy marker)", () => {
+  const screen = ["⏺ Done — all tests pass.", "", "❯", "", "? for shortcuts"];
+  expect(isWorkingScreen(screen, claude.working)).toBe(false);
+});
+
+test("isWorkingScreen: false when no working patterns are configured", () => {
+  expect(isWorkingScreen(["esc to interrupt"], undefined)).toBe(false);
+  expect(isWorkingScreen(["esc to interrupt"], [])).toBe(false);
+});
+
 test("detects a claude AskUserQuestion selection menu", () => {
   const screen = [
     "Which auth method should we use?",

package/ts/needsInput.ts

@@ -66,3 +66,17 @@ export function classifyNeedsInput(
     .filter((l) => l && !isChromeLine(l));
   return { question: block.join(" • ").slice(0, 400) };
 }
+
+/**
+ * True when the rendered screen still shows a "busy" marker (config `working`,
+ * e.g. claude's `esc to interrupt`). Paired with a long-quiet log this is the
+ * `stuck` signal: a live spinner writes to the log every frame, so a busy marker
+ * on screen WITHOUT recent output means the agent wedged mid-stream (a silent
+ * API stream stall) rather than finishing. Pure + synchronous like the rest of
+ * this module so it's trivially unit-testable.
+ */
+export function isWorkingScreen(lines: string[], working?: RegExp[]): boolean {
+  if (!working?.length) return false;
+  const text = lines.join("\n");
+  return working.some((re) => reTest(re, text));
+}

package/ts/subcommands.spec.ts

@@ -717,6 +717,82 @@ describe("subcommands.cmdSend writes bytes to FIFO", () => {
     const { controlCodeFromName } = await loadModule();
     expect(controlCodeFromName("none")).toBe("");
   });
+
+  it.skipIf(!itUnix)(
+    "routes a bare 'exit' to the graceful /exit, not the literal word",
+    async () => {
+      const { runSubcommand } = await loadModule();
+      const { appendGlobalPid } = await import("./globalPidIndex.ts");
+      const { spawnSync } = await import("child_process");
+      const tmp = await mkdtemp(path.join(tmpdir(), "ay-fifo-"));
+      try {
+        const fifo = path.join(tmp, "exit.fifo");
+        if (spawnSync("mkfifo", [fifo]).status !== 0) return;
+        const fs = await import("fs");
+        const rdwrFd = fs.openSync(fifo, fs.constants.O_RDWR);
+        await appendGlobalPid({
+          pid: process.pid,
+          cli: "claude",
+          prompt: null,
+          cwd: process.cwd(),
+          log_file: null,
+          fifo_file: fifo,
+          status: "active",
+          exit_code: null,
+          exit_reason: null,
+          started_at: Date.now(),
+        });
+        const stdout: string[] = [];
+        const orig = process.stdout.write.bind(process.stdout);
+        (process.stdout as any).write = (s: any) => (stdout.push(String(s)), true);
+        const savedAyPid = process.env.AGENT_YES_PID;
+        delete process.env.AGENT_YES_PID;
+        try {
+          const code = await runSubcommand([
+            "bun",
+            "cli.js",
+            "send",
+            String(process.pid),
+            "exit",
+            "--force",
+          ]);
+          expect(code).toBe(0);
+          expect(stdout.join("")).toMatch(/exit requested/);
+        } finally {
+          process.stdout.write = orig;
+          if (savedAyPid !== undefined) process.env.AGENT_YES_PID = savedAyPid;
+        }
+        const buf = Buffer.alloc(4096);
+        const n = fs.readSync(rdwrFd, buf, 0, buf.length, null);
+        // The real `/exit` command + Enter — NOT the literal "exit\r" that claude ignores.
+        expect(buf.subarray(0, n).toString()).toBe("/exit\r");
+        fs.closeSync(rdwrFd);
+      } finally {
+        await rm(tmp, { recursive: true, force: true }).catch(() => null);
+      }
+    },
+  );
+});
+
+describe("subcommands.isExitRequest", () => {
+  it("matches the bare exit word and the literal /exit (any case, trimmed)", async () => {
+    const { isExitRequest } = await loadModule();
+    for (const s of ["exit", "/exit", "  exit ", "EXIT", "/Exit", "\nexit\n"]) {
+      expect(isExitRequest(s)).toBe(true);
+    }
+  });
+  it("does NOT match a sentence that merely contains 'exit'", async () => {
+    const { isExitRequest } = await loadModule();
+    for (const s of [
+      "please exit now",
+      "exit the loop after step 3",
+      "do not exit",
+      "exiting",
+      "",
+    ]) {
+      expect(isExitRequest(s)).toBe(false);
+    }
+  });
 });
 
 describe("subcommands.writeToIpc reliable delivery", () => {
@@ -1571,3 +1647,74 @@ describe("subcommands.deriveLiveStatus", () => {
     }
   });
 });
+
+describe("subcommands.isAgentStuck / stuck state", () => {
+  const rec = (over: any) => ({
+    pid: process.pid,
+    cli: "claude",
+    prompt: null,
+    cwd: "/tmp",
+    log_file: null,
+    fifo_file: null,
+    status: "active",
+    exit_code: null,
+    exit_reason: null,
+    started_at: 0,
+    ...over,
+  });
+  // A log whose rendered tail shows claude's shipped `working` busy marker.
+  const BUSY = "⏺ Cogitating…\r\nesc to interrupt · ← for agents\r\n";
+  const tenMinAgo = () => new Date(Date.now() - 10 * 60 * 1000);
+
+  it("isAgentStuck: true when a busy marker is on screen and the log is long-silent", async () => {
+    const dir = await mkdtemp(path.join(tmpdir(), "ay-stuck-"));
+    try {
+      const log = path.join(dir, "a.log");
+      await writeFile(log, BUSY);
+      await utimes(log, tenMinAgo(), tenMinAgo());
+      const mod = await loadModule();
+      expect(await mod.isAgentStuck(rec({ log_file: log }))).toBe(true);
+    } finally {
+      await rm(dir, { recursive: true, force: true }).catch(() => null);
+    }
+  });
+
+  it("isAgentStuck: false when the busy log was written recently (still working)", async () => {
+    const dir = await mkdtemp(path.join(tmpdir(), "ay-stuck-"));
+    try {
+      const log = path.join(dir, "a.log");
+      await writeFile(log, BUSY); // fresh mtime — under the stuck threshold
+      const mod = await loadModule();
+      expect(await mod.isAgentStuck(rec({ log_file: log }))).toBe(false);
+    } finally {
+      await rm(dir, { recursive: true, force: true }).catch(() => null);
+    }
+  });
+
+  it("isAgentStuck: false when long-silent but no busy marker on screen (genuinely idle)", async () => {
+    const dir = await mkdtemp(path.join(tmpdir(), "ay-stuck-"));
+    try {
+      const log = path.join(dir, "a.log");
+      await writeFile(log, "⏺ Done — all green.\r\n❯\r\n");
+      await utimes(log, tenMinAgo(), tenMinAgo());
+      const mod = await loadModule();
+      expect(await mod.isAgentStuck(rec({ log_file: log }))).toBe(false);
+    } finally {
+      await rm(dir, { recursive: true, force: true }).catch(() => null);
+    }
+  });
+
+  it("snapshotStatus: reports 'stuck' for a long-silent busy agent (not 'idle')", async () => {
+    const dir = await mkdtemp(path.join(tmpdir(), "ay-stuck-"));
+    try {
+      const log = path.join(dir, "a.log");
+      await writeFile(log, BUSY);
+      await utimes(log, tenMinAgo(), tenMinAgo());
+      const mod = await loadModule();
+      const snap = await mod.snapshotStatus(rec({ log_file: log }));
+      expect(snap.state).toBe("stuck");
+    } finally {
+      await rm(dir, { recursive: true, force: true }).catch(() => null);
+    }
+  });
+});

package/dist/SUPPORTED_CLIS-DYcaH-bR.js

@@ -1,8 +0,0 @@
-import "./ts-B1-x2rKP.js";
-import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-Bhn4NygE.js";
-import "./pidStore-fqXqTKkh.js";
-import "./globalPidIndex-DlmmJlO8.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CTOnaXTX.js";
-
-export { SUPPORTED_CLIS };

package/dist/subcommands-DKizMTs9.js

@@ -1,7 +0,0 @@
-import "./logger-CDIsZ-Pp.js";
-import "./globalPidIndex-DlmmJlO8.js";
-import "./configShared-C1C04bbq.js";
-import "./remotes-PKKjfTI1.js";
-import { S as writeToIpc, _ as resolveOne, a as cursorAbs, b as snapshotStatus, c as extractTaskCounts, d as isSubcommand, f as listRecords, g as renderRawLogLines, h as renderRawLog, i as controlCodeFromName, l as finalizedLines, m as readNotes, n as READ_PAGE_DEFAULT, o as deriveLiveStatus, p as matchKeyword, r as cmdHelp, s as extractNeedsInput, t as GRACEFUL_EXIT_COMMANDS, u as isPidAlive, v as resolveReadWindow, x as stopTipForCli, y as runSubcommand } from "./subcommands-Cz7-sHOT.js";
-
-export { cmdHelp, isSubcommand, runSubcommand };