claude-yes 1.162.0 → 1.165.0

package/dist/{SUPPORTED_CLIS-BNLYYzBZ.js → SUPPORTED_CLIS-H7IIw10E.js}

@@ -1,8 +1,8 @@
-import { t as CLIS_CONFIG } from "./ts--UKFJGU-.js";
+import { t as CLIS_CONFIG } from "./ts-jDEwTsVt.js";
 
 //#region ts/SUPPORTED_CLIS.ts
 const SUPPORTED_CLIS = Object.keys(CLIS_CONFIG);
 
 //#endregion
 export { SUPPORTED_CLIS as t };
-//# sourceMappingURL=SUPPORTED_CLIS-BNLYYzBZ.js.map
+//# sourceMappingURL=SUPPORTED_CLIS-H7IIw10E.js.map

package/dist/SUPPORTED_CLIS-dBgLp3mi.js

@@ -0,0 +1,8 @@
+import "./ts-jDEwTsVt.js";
+import "./logger-CDIsZ-Pp.js";
+import "./versionChecker-C0UJyFcN.js";
+import "./pidStore-BfoBWUjc.js";
+import "./globalPidIndex-DlmmJlO8.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-H7IIw10E.js";
+
+export { SUPPORTED_CLIS };

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 import { t as invokedCliName } from "./invokedCli-uqM2YYA7.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-DJObC8O_.js";
+import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-C0UJyFcN.js";
 import { argv } from "process";
 import { execFileSync, spawn } from "child_process";
 import ms from "ms";
@@ -481,7 +481,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-DeW-4FGU.js");
+	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-CIFWi9vq.js");
 	if (isHelpFlag && process.argv.length === 3) {
 		cmdHelp(managerCommands);
 		process.exit(0);
@@ -514,7 +514,7 @@ if (config.useRust) {
 		}
 	}
 	if (rustBinary) {
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-C9TQK7ME.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-dBgLp3mi.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--UKFJGU-.js";
+import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-jDEwTsVt.js";
 import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-DJObC8O_.js";
+import "./versionChecker-C0UJyFcN.js";
 import "./pidStore-BfoBWUjc.js";
 import "./globalPidIndex-DlmmJlO8.js";
 

package/dist/{schedule-DzFEVEoq.js → schedule-BobQwIBS.js}

@@ -1,9 +1,9 @@
-import "./ts--UKFJGU-.js";
+import "./ts-jDEwTsVt.js";
 import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-DJObC8O_.js";
+import "./versionChecker-C0UJyFcN.js";
 import "./pidStore-BfoBWUjc.js";
 import "./globalPidIndex-DlmmJlO8.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-BNLYYzBZ.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-H7IIw10E.js";
 import { o as resolveSpawnCwd } from "./workspaceConfig-B0Q9-q2B.js";
 import { createHash } from "node:crypto";
 
@@ -141,4 +141,4 @@ async function cmdSchedule(rest) {
 
 //#endregion
 export { cmdSchedule };
-//# sourceMappingURL=schedule-DzFEVEoq.js.map
+//# sourceMappingURL=schedule-BobQwIBS.js.map

package/dist/{serve-BFnjq7JW.js → serve-DzOWMI_8.js}

@@ -1,16 +1,16 @@
-import "./ts--UKFJGU-.js";
+import "./ts-jDEwTsVt.js";
 import "./logger-CDIsZ-Pp.js";
-import { r as getInstalledPackage } from "./versionChecker-DJObC8O_.js";
+import { r as getInstalledPackage } from "./versionChecker-C0UJyFcN.js";
 import "./pidStore-BfoBWUjc.js";
 import { a as updateGlobalPidStatus } from "./globalPidIndex-DlmmJlO8.js";
 import { t as pgidForWrapper } from "./reaper-C-eWAxIj.js";
 import "./configShared-CEyhl0WH.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-BNLYYzBZ.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-H7IIw10E.js";
 import "./e2e-Bfw7qL9O.js";
 import "./webrtcLink-CBZkZ-LT.js";
 import "./remotes-DBCvpp3B.js";
 import { a as isProvisionAllowed, i as hasSpawnHook, n as getSpawnHook, o as resolveSpawnCwd, t as getProvisionRoot } from "./workspaceConfig-B0Q9-q2B.js";
-import { D as writeToIpc, T as snapshotStatus, _ as readPtysize, b as resolveOne, c as extractTaskCounts, g as readNotes, i as controlCodeFromName, m as listRecords, o as deriveLiveStatus, v as renderRawLog } from "./subcommands-CKMEWv6U.js";
+import { A as writeToIpc, D as snapshotStatus, S as resolveOne, b as renderRawLog, c as extractNeedsInput, h as listRecords, i as controlCodeFromName, l as extractTaskCounts, o as deriveLiveStatus, v as readNotes, y as readPtysize } from "./subcommands-DtwxPMYe.js";
 import yargs from "yargs";
 import { mkdir, open, readFile, stat, unlink, writeFile } from "fs/promises";
 import { homedir, hostname, userInfo } from "os";
@@ -625,6 +625,24 @@ Options:
 			return null;
 		}
 	};
+	const niCache = /* @__PURE__ */ new Map();
+	const logNeedsInput = async (logFile, cli) => {
+		if (!logFile) return null;
+		try {
+			const { size, mtimeMs } = await stat(logFile);
+			const hit = niCache.get(logFile);
+			if (hit && hit.size === size && hit.mtimeMs === mtimeMs) return hit.question;
+			const question = (await extractNeedsInput(logFile, cli))?.question ?? null;
+			niCache.set(logFile, {
+				size,
+				mtimeMs,
+				question
+			});
+			return question;
+		} catch {
+			return null;
+		}
+	};
 	const GIT_DEBOUNCE_MS = 800;
 	const GIT_SAFETY_MS = 6e4;
 	const runGit = async (args, cwd) => {
@@ -643,17 +661,43 @@ Options:
 		}
 	};
 	const parseGitStatus = (out) => {
-		const lines = out.split("\n");
-		const h = /^## (.+)$/.exec(lines[0] ?? "")?.[1] ?? "";
-		const unborn = /^No commits yet on (.+)$/.exec(h);
-		const branch = unborn ? unborn[1] : /^(.+?)(?:\.\.\.|\s|$)/.exec(h)?.[1] || null;
-		const ahead = Number(/\bahead (\d+)/.exec(h)?.[1] ?? 0);
-		const behind = Number(/\bbehind (\d+)/.exec(h)?.[1] ?? 0);
-		const changed = lines.slice(1).filter((l) => l.trim().length > 0).length;
+		let branch = null;
+		let ahead = 0;
+		let behind = 0;
+		let changed = 0;
+		let pins = 0;
+		let subDirty = 0;
+		for (const line of out.split("\n")) {
+			if (line.length === 0) continue;
+			if (line[0] === "#") {
+				const head = /^# branch\.head (.+)$/.exec(line);
+				if (head) {
+					branch = head[1] === "(detached)" ? null : head[1];
+					continue;
+				}
+				const ab = /^# branch\.ab \+(\d+) -(\d+)/.exec(line);
+				if (ab) {
+					ahead = Number(ab[1]);
+					behind = Number(ab[2]);
+				}
+				continue;
+			}
+			const type = line[0];
+			if (type === "?") changed++;
+			else if (type === "u") changed++;
+			else if (type === "1" || type === "2") {
+				const sub = line.split(" ")[2] ?? "N...";
+				if (sub[0] === "S") if (sub[1] === "C") pins++;
+				else subDirty++;
+				else changed++;
+			}
+		}
 		return {
 			branch,
 			dirty: changed > 0,
 			changed,
+			pins,
+			subDirty,
 			ahead,
 			behind
 		};
@@ -676,7 +720,7 @@ Options:
 			try {
 				const out = await runGit([
 					"status",
-					"--porcelain",
+					"--porcelain=v2",
 					"--branch"
 				], root);
 				if (out != null) rw.val = parseGitStatus(out);
@@ -717,9 +761,11 @@ Options:
 	};
 	const withMeta = async (r) => {
 		const status = await deriveLiveStatus(r);
+		const question = status !== "exited" && !r.unresponsive ? await logNeedsInput(r.log_file, r.cli) : null;
 		return {
 			...r,
-			status: status !== "exited" && r.unresponsive ? "stuck" : status,
+			status: status === "exited" ? status : r.unresponsive ? "stuck" : question ? "needs_input" : status,
+			question,
 			title: await logTitle(r.log_file),
 			git: status === "exited" ? null : await gitStatus(r.cwd),
 			tasks: status === "exited" ? null : await logTasks(r.log_file)
@@ -1396,4 +1442,4 @@ Options:
 
 //#endregion
 export { cmdServe };
-//# sourceMappingURL=serve-BFnjq7JW.js.map
+//# sourceMappingURL=serve-DzOWMI_8.js.map

package/dist/{setup-BmUQ_Zbt.js → setup-tVfp7djj.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-BFnjq7JW.js");
+	const { cmdServe } = await import("./serve-DzOWMI_8.js");
 	return cmdServe([
 		"install",
 		"--share",
@@ -42,4 +42,4 @@ async function cmdSetup(rest) {
 
 //#endregion
 export { cmdSetup };
-//# sourceMappingURL=setup-BmUQ_Zbt.js.map
+//# sourceMappingURL=setup-tVfp7djj.js.map

package/dist/subcommands-CIFWi9vq.js

@@ -0,0 +1,9 @@
+import "./logger-CDIsZ-Pp.js";
+import "./globalPidIndex-DlmmJlO8.js";
+import "./configShared-CEyhl0WH.js";
+import "./e2e-Bfw7qL9O.js";
+import "./webrtcLink-CBZkZ-LT.js";
+import "./remotes-DBCvpp3B.js";
+import { A as writeToIpc, C as resolveReadWindow, D as snapshotStatus, E as runSubcommand, O as stopTipForCli, S as resolveOne, T as restartHintLines, _ as menuSelectKeys, a as cursorAbs, b as renderRawLog, c as extractNeedsInput, d as isAgentStuck, f as isExitRequest, g as matchKeyword, h as listRecords, i as controlCodeFromName, k as writeKeysPaced, l as extractTaskCounts, m as isSubcommand, n as READ_PAGE_DEFAULT, o as deriveLiveStatus, p as isPidAlive, r as cmdHelp, s as extractMenu, t as GRACEFUL_EXIT_COMMANDS, u as finalizedLines, v as readNotes, w as resolveResumeArgs, x as renderRawLogLines, y as readPtysize } from "./subcommands-DtwxPMYe.js";
+
+export { cmdHelp, isSubcommand, runSubcommand };

package/dist/{subcommands-CKMEWv6U.js → subcommands-DtwxPMYe.js}

@@ -183,6 +183,43 @@ 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) };
 }
+const OPTION_LINE = /^[\s❯›>▶◉○●·*\-]*?(\d+)\.\s/;
+/**
+* Parse the selection menu a `needs_input` agent is parked on into a cursor
+* position + the available option numbers, so a caller can compute how far the
+* cursor must move (Down/Up) to reach a target option. Returns null when the
+* screen isn't a menu (delegates that judgement to {@link classifyNeedsInput},
+* so `working` still wins) or no numbered cursor line is found. Pure — the
+* `ay select` action reuses the exact detection `ay ls` renders with.
+*/
+function parseMenu(lines, cfg) {
+	const ni = classifyNeedsInput(lines, cfg);
+	if (!ni) return null;
+	const patterns = cfg.needsInput ?? [];
+	let cursorLine = -1;
+	for (let i = 0; i < lines.length; i++) if (patterns.some((re) => reTest(re, lines[i]))) cursorLine = i;
+	if (cursorLine < 0) return null;
+	const cm = /(\d+)\./.exec(lines[cursorLine]);
+	if (!cm) return null;
+	const cursor = parseInt(cm[1], 10);
+	const start = Math.max(0, cursorLine - 12);
+	const end = Math.min(lines.length, cursorLine + 12);
+	const options = [];
+	for (let i = start; i < end; i++) {
+		const m = OPTION_LINE.exec(lines[i]);
+		if (m) {
+			const v = parseInt(m[1], 10);
+			if (!options.includes(v)) options.push(v);
+		}
+	}
+	if (!options.includes(cursor)) options.push(cursor);
+	options.sort((a, b) => a - b);
+	return {
+		cursor,
+		options,
+		question: ni.question
+	};
+}
 /**
 * 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
@@ -500,6 +537,8 @@ const SUBCOMMANDS = new Set([
 	"tail",
 	"head",
 	"send",
+	"key",
+	"select",
 	"spawn",
 	"attach",
 	"stop",
@@ -549,6 +588,8 @@ async function runSubcommand(argv) {
 			case "tail": return await cmdRead(rest, { mode: "tail" });
 			case "head": return await cmdRead(rest, { mode: "head" });
 			case "send": return await cmdSend(rest);
+			case "key": return await cmdKey(rest);
+			case "select": return await cmdSelect(rest);
 			case "spawn": return await cmdSpawn(rest);
 			case "attach": return await cmdAttach(rest);
 			case "stop": return await cmdStop(rest);
@@ -556,15 +597,15 @@ async function runSubcommand(argv) {
 			case "restart": return await cmdRestart(rest);
 			case "note": return await cmdNote(rest);
 			case "serve": {
-				const { cmdServe } = await import("./serve-BFnjq7JW.js");
+				const { cmdServe } = await import("./serve-DzOWMI_8.js");
 				return cmdServe(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup-BmUQ_Zbt.js");
+				const { cmdSetup } = await import("./setup-tVfp7djj.js");
 				return cmdSetup(rest);
 			}
 			case "schedule": {
-				const { cmdSchedule } = await import("./schedule-DzFEVEoq.js");
+				const { cmdSchedule } = await import("./schedule-BobQwIBS.js");
 				return cmdSchedule(rest);
 			}
 			case "remote": {
@@ -585,7 +626,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 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 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 key <keyword> <key...>           send raw keystrokes (down/up/enter/esc/…) — drives menus\n  ay select <keyword> <N>             pick option N of a needs_input selection menu\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 restart <keyword> [--fresh]      stop (if live) + relaunch resuming the session; --fresh replays the prompt\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) {
@@ -1895,6 +1936,71 @@ async function cmdSpawn(rest) {
 		prompt: prompt || void 0
 	});
 }
+/**
+* Shared safety gate for every command that writes to a live agent's stdin
+* (`send`, `key`, `select`): refuse a self-targeting loop, and require that THIS
+* sender actually looked at THIS target recently — an agent is blocked, an
+* interactive human is only warned — unless `force`. Returns the sender context
+* so a caller can reuse it (e.g. `send`'s `[from …]` prefix). Extracted from
+* cmdSend so the action commands enforce the identical guard.
+*/
+async function enforceSendGuards(record, force) {
+	const sender = await senderContext();
+	if (sender.agent && sender.agent.pid === record.pid && !force) throw new Error(`refusing to send to yourself (pid ${record.pid}) — pass --force if you really mean it.`);
+	const last = await lastReadAt(sender.key, record.pid);
+	if (!(last !== null && Date.now() - last <= READ_WINDOW_MS) && !force) {
+		const ago = last === null ? "never read" : `last read ${Math.round((Date.now() - last) / 1e3)}s ago`;
+		const what = `pid ${record.pid} (${record.cli}, ${shortenPath(record.cwd)}) — ${ago}, not within ${READ_WINDOW_MS / 1e3}s`;
+		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`);
+	}
+	return sender;
+}
+const KEY_PACE_MS = 40;
+/**
+* The named-key sequence that moves a menu cursor from `cursor` to option
+* `target` and confirms: |Δ| Downs (target below) or Ups (target above), then
+* Enter. Pure so the arrow arithmetic is unit-tested independent of any live PTY.
+*/
+function menuSelectKeys(cursor, target) {
+	const delta = target - cursor;
+	return [...Array(Math.abs(delta)).fill(delta > 0 ? "down" : "up"), "enter"];
+}
+/** Write each already-encoded key sequence to the FIFO with a pace gap between
+* them (no gap after the last). Raw bytes, no `[from]` framing, no auto-Enter. */
+async function writeKeysPaced(fifoPath, byteSeqs, paceMs) {
+	for (let i = 0; i < byteSeqs.length; i++) {
+		if (byteSeqs[i] === "") continue;
+		await writeToIpc(fifoPath, byteSeqs[i]);
+		if (i < byteSeqs.length - 1 && paceMs > 0) await new Promise((r) => setTimeout(r, paceMs));
+	}
+}
+/**
+* The selection menu a needs_input agent is parked on, or null when it isn't on
+* one. Mirrors extractNeedsInput (same 32 KB tail render + config patterns) but
+* returns the cursor position + option numbers so `ay select` can compute the
+* cursor delta.
+*/
+async function extractMenu(logPath, cli) {
+	const cfg = (await cliDefaults())[cli];
+	if (!cfg?.needsInput?.length) return null;
+	const lines = await renderLogTailLines(logPath, 40);
+	if (!lines) return null;
+	return parseMenu(lines, {
+		needsInput: cfg.needsInput,
+		working: cfg.working
+	});
+}
+/** Poll until the agent is no longer parked on a menu (selection accepted → it
+* resumed / moved on) or the deadline passes. Returns true if it cleared. */
+async function waitForNeedsInputClear(record, timeoutMs) {
+	const deadline = Date.now() + timeoutMs;
+	while (Date.now() < deadline) {
+		await new Promise((r) => setTimeout(r, 250));
+		if ((await snapshotStatus(record)).state !== "needs_input") return true;
+	}
+	return false;
+}
 async function cmdSend(rest) {
 	const argv = await yargs(rest).usage("Usage: ay send <keyword> <msg|-> [options]").option("code", {
 		type: "string",
@@ -1941,16 +2047,7 @@ async function cmdSend(rest) {
 		for await (const chunk of process.stdin) chunks.push(chunk);
 		body = Buffer.concat(chunks).toString("utf-8").trimEnd();
 	} else body = rawMessage;
-	const sender = await senderContext();
-	const force = Boolean(argv.force) || process.env.AGENT_YES_FORCE_SEND === "1";
-	if (sender.agent && sender.agent.pid === record.pid && !force) throw new Error(`refusing to send to yourself (pid ${record.pid}) — pass --force if you really mean it.`);
-	const last = await lastReadAt(sender.key, record.pid);
-	if (!(last !== null && Date.now() - last <= READ_WINDOW_MS) && !force) {
-		const ago = last === null ? "never read" : `last read ${Math.round((Date.now() - last) / 1e3)}s ago`;
-		const what = `pid ${record.pid} (${record.cli}, ${shortenPath(record.cwd)}) — ${ago}, not within ${READ_WINDOW_MS / 1e3}s`;
-		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`);
-	}
+	const sender = await enforceSendGuards(record, Boolean(argv.force) || process.env.AGENT_YES_FORCE_SEND === "1");
 	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);
@@ -1973,6 +2070,104 @@ async function cmdSend(rest) {
 	}
 	return 0;
 }
+async function resolveWritableAgent(keyword, opts) {
+	const record = await resolveOne(keyword, opts);
+	if (!record.fifo_file) throw new Error(`pid ${record.pid}: no fifo_file recorded — this agent didn't register a stdin FIFO (an older agent, or one not started with --stdpush). Restarting it (ay restart ${record.pid}) re-registers one.`);
+	return record;
+}
+async function cmdKey(rest) {
+	const argv = await yargs(rest).usage("Usage: ay key <keyword> <key...> [options]\n\nSend raw named keystrokes to a live agent's TUI — no message framing, no\nauto-Enter. Drives selection menus and other interactive prompts that a\nplain `ay send` (text + Enter) can't. Keys are paced so the CLI registers\neach as a discrete event, not a paste.\n\nKeys: up down left right enter esc tab space backspace delete home end\n      pageup pagedown ctrl-c ctrl-d ctrl-y  raw:0xNN\n\nExamples:\n  ay key 1234 down down enter    # move the menu cursor down twice, confirm\n  ay key 1234 esc                # dismiss a menu\n  ay key 1234 raw:0x1b           # a literal ESC byte").option("pace", {
+		type: "number",
+		default: KEY_PACE_MS,
+		description: "ms between keystrokes"
+	}).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"
+	}).option("force", {
+		type: "boolean",
+		default: false,
+		description: "Skip the recency/self-send guard (also: AGENT_YES_FORCE_SEND=1)"
+	}).help(false).version(false).exitProcess(false).parseAsync();
+	const keyword = argv._[0] !== void 0 ? String(argv._[0]) : void 0;
+	const keyNames = argv._.slice(1).map(String);
+	if (!keyword || keyNames.length === 0) throw new Error("usage: ay key <keyword> <key...>   (e.g. ay key 1234 down down enter)");
+	const byteSeqs = keyNames.map((n) => controlCodeFromName(n.toLowerCase()));
+	const record = await resolveWritableAgent(keyword, {
+		all: argv.all,
+		active: false,
+		json: false,
+		latest: argv.latest,
+		cwdScope: typeof argv.cwd === "string" ? path.resolve(argv.cwd) : null
+	});
+	await enforceSendGuards(record, Boolean(argv.force) || process.env.AGENT_YES_FORCE_SEND === "1");
+	await writeKeysPaced(record.fifo_file, byteSeqs, Math.max(0, argv.pace));
+	process.stdout.write(`sent to pid ${record.pid} (${record.cli}): ${keyNames.join(" ")}\n`);
+	return 0;
+}
+async function cmdSelect(rest) {
+	const argv = await yargs(rest).usage("Usage: ay select <keyword> <N> [options]\n\nPick option N of the selection menu a needs_input agent is parked on.\nRe-parses the live menu (the same ❯-cursor detection `ay ls` uses), computes\nhow far the cursor must move, and sends that many Down/Up keys + Enter — so\nit's robust to a pre-highlighted default (never assumes the cursor starts at 1)\nand doesn't rely on numeric hotkeys (arrow-driven menus ignore them).\n\nExamples:\n  ay select 1234 2           # choose option 2\n  ay select 1234 2 --wait    # …and block until the menu clears").option("pace", {
+		type: "number",
+		default: KEY_PACE_MS,
+		description: "ms between keystrokes"
+	}).option("wait", {
+		type: "boolean",
+		default: false,
+		description: "Block until the agent leaves needs_input (or --timeout)"
+	}).option("timeout", {
+		type: "number",
+		default: 10,
+		description: "Seconds to wait with --wait"
+	}).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"
+	}).option("force", {
+		type: "boolean",
+		default: false,
+		description: "Skip the recency/self-send guard (also: AGENT_YES_FORCE_SEND=1)"
+	}).help(false).version(false).exitProcess(false).parseAsync();
+	const keyword = argv._[0] !== void 0 ? String(argv._[0]) : void 0;
+	const n = Number(argv._[1]);
+	if (!keyword || !Number.isInteger(n) || n < 1) throw new Error("usage: ay select <keyword> <N>   (N = the 1-based option number to choose)");
+	const record = await resolveWritableAgent(keyword, {
+		all: argv.all,
+		active: false,
+		json: false,
+		latest: argv.latest,
+		cwdScope: typeof argv.cwd === "string" ? path.resolve(argv.cwd) : null
+	});
+	if (!record.log_file) throw new Error(`pid ${record.pid}: no log_file recorded — can't read the menu to select from.`);
+	await enforceSendGuards(record, Boolean(argv.force) || process.env.AGENT_YES_FORCE_SEND === "1");
+	const menu = await extractMenu(record.log_file, record.cli);
+	if (!menu) throw new Error(`pid ${record.pid} (${record.cli}) is not parked on a selection menu (not needs_input).\n  Check with:  ay status ${record.pid}`);
+	if (menu.options.length > 0 && !menu.options.includes(n)) throw new Error(`option ${n} is out of range — this menu offers ${menu.options.join(", ")}.`);
+	const byteSeqs = menuSelectKeys(menu.cursor, n).map((k) => controlCodeFromName(k));
+	await writeKeysPaced(record.fifo_file, byteSeqs, Math.max(0, argv.pace));
+	const delta = n - menu.cursor;
+	const moved = delta === 0 ? "cursor already there" : `${Math.abs(delta)}× ${delta > 0 ? "down" : "up"}`;
+	process.stdout.write(`pid ${record.pid} (${record.cli}): selected option ${n} (${moved} + enter)\n`);
+	if (argv.wait) {
+		const ok = await waitForNeedsInputClear(record, Math.max(1, argv.timeout) * 1e3);
+		process.stdout.write(ok ? `  menu cleared — selection accepted.\n` : `  still needs_input after ${argv.timeout}s — re-check with 'ay status ${record.pid}'.\n`);
+		return ok ? 0 : 1;
+	}
+	return 0;
+}
 function stopTipForCli(cli, pid) {
 	const cmd = GRACEFUL_EXIT_COMMANDS[cli];
 	if (cmd) return `  tip: ${cli} ignores a single Ctrl+C — try 'ay stop ${pid}' (sends '${cmd}') or double Ctrl+C.\n`;
@@ -2000,12 +2195,27 @@ function controlCodeFromName(name) {
 		case "ctrl\\":
 		case "ctrl-backslash": return "";
 		case "tab": return "	";
+		case "up": return "\x1B[A";
+		case "down": return "\x1B[B";
+		case "right": return "\x1B[C";
+		case "left": return "\x1B[D";
+		case "home": return "\x1B[H";
+		case "end": return "\x1B[F";
+		case "pageup":
+		case "pgup": return "\x1B[5~";
+		case "pagedown":
+		case "pgdn": return "\x1B[6~";
+		case "space": return " ";
+		case "backspace":
+		case "bs": return "";
+		case "delete":
+		case "del": return "\x1B[3~";
 		case "none":
 		case "": return "";
 		default:
 			const m = /^raw:0x([0-9a-f]+)$/i.exec(name);
 			if (m) return String.fromCharCode(parseInt(m[1], 16));
-			throw new Error(`unknown --code=${name}`);
+			throw new Error(`unknown key/code: ${name}`);
 	}
 }
 async function writeToIpc(ipcPath, payload) {
@@ -2794,5 +3004,5 @@ async function cmdResultSet(rest) {
 }
 
 //#endregion
-export { restartHintLines as C, writeToIpc as D, stopTipForCli as E, resolveResumeArgs as S, snapshotStatus as T, readPtysize as _, cursorAbs as a, resolveOne 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, renderRawLog as v, runSubcommand as w, resolveReadWindow as x, renderRawLogLines as y };
-//# sourceMappingURL=subcommands-CKMEWv6U.js.map
+export { writeToIpc as A, resolveReadWindow as C, snapshotStatus as D, runSubcommand as E, stopTipForCli as O, resolveOne as S, restartHintLines as T, menuSelectKeys as _, cursorAbs as a, renderRawLog as b, extractNeedsInput as c, isAgentStuck as d, isExitRequest as f, matchKeyword as g, listRecords as h, controlCodeFromName as i, writeKeysPaced as k, extractTaskCounts as l, isSubcommand as m, READ_PAGE_DEFAULT as n, deriveLiveStatus as o, isPidAlive as p, cmdHelp as r, extractMenu as s, GRACEFUL_EXIT_COMMANDS as t, finalizedLines as u, readNotes as v, resolveResumeArgs as w, renderRawLogLines as x, readPtysize as y };
+//# sourceMappingURL=subcommands-DtwxPMYe.js.map

package/dist/{ts--UKFJGU-.js → ts-jDEwTsVt.js}

@@ -1,5 +1,5 @@
 import { n as logger, t as addTransport } from "./logger-CDIsZ-Pp.js";
-import { r as getInstalledPackage } from "./versionChecker-DJObC8O_.js";
+import { r as getInstalledPackage } from "./versionChecker-C0UJyFcN.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-BfoBWUjc.js";
@@ -1803,4 +1803,4 @@ function sleep(ms) {
 
 //#endregion
 export { removeControlCharacters as a, AgentContext as i, agentYes as n, config as r, CLIS_CONFIG as t };
-//# sourceMappingURL=ts--UKFJGU-.js.map
+//# sourceMappingURL=ts-jDEwTsVt.js.map

package/dist/{versionChecker-DJObC8O_.js → versionChecker-C0UJyFcN.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "claude-yes";
-var version = "1.162.0";
+var version = "1.165.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-DJObC8O_.js.map
+//# sourceMappingURL=versionChecker-C0UJyFcN.js.map

package/lab/ui/console-logic.js

@@ -153,14 +153,19 @@ export function tagsFor(e) {
 }
 
 // Compact git indicator from the record's `git` snapshot (server-side
-// `git status --porcelain --branch`): "±3" changed files, "↑1" ahead, "↓2"
-// behind. Returns "" when there's no git info or the tree is clean and in sync,
-// so a tidy repo adds no noise. Branch itself is shown via the path identity.
+// `git status --porcelain=v2 --branch`): "±3" real changed files, "⑂2"
+// submodule pin-bumps, "⊙1" submodule internal dirt, "↑1" ahead, "↓2" behind.
+// Pins/sub-dirt are split out of "±" so submodule drift (constant in a repo with
+// many submodules) never buries the real file edits. Returns "" when there's no
+// git info or the tree is clean and in sync, so a tidy repo adds no noise. Branch
+// itself is shown via the path identity.
 export function gitLabel(e) {
   const g = e.git;
   if (!g) return "";
   const parts = [];
   if (g.changed > 0) parts.push("±" + g.changed);
+  if (g.pins > 0) parts.push("⑂" + g.pins);
+  if (g.subDirty > 0) parts.push("⊙" + g.subDirty);
   if (g.ahead > 0) parts.push("↑" + g.ahead);
   if (g.behind > 0) parts.push("↓" + g.behind);
   return parts.join(" ");
@@ -521,10 +526,21 @@ export function fitTransform(gridW, gridH, paneW, paneH) {
 
 // Browser-tab title: "<glyph> <selected agent title> - agent-yes", or the bare
 // console title when nothing is selected (blank/whitespace name). The leading
-// glyph mirrors the agent's status dot — ● active, ○ idle, ✗ exited — so the tab
-// shows liveness at a glance; an unknown status adds no glyph.
+// glyph mirrors the agent's status dot — ⌨ needs_input ("your turn"), ⚠ stuck,
+// ● active, ○ idle, ✗ exited — so the tab shows liveness at a glance even in a
+// background tab; an unknown status adds no glyph.
 export function statusGlyph(status) {
-  return status === "active" ? "●" : status === "idle" ? "○" : status === "exited" ? "✗" : "";
+  return status === "needs_input"
+    ? "⌨"
+    : status === "stuck"
+      ? "⚠"
+      : status === "active"
+        ? "●"
+        : status === "idle"
+          ? "○"
+          : status === "exited"
+            ? "✗"
+            : "";
 }
 export function docTitle(name, status) {
   const n = name && String(name).trim();