agent-yes 1.265.0 → 1.265.1

package/dist/{SUPPORTED_CLIS-DsMN-Qhx.js → SUPPORTED_CLIS-CiX7yHEr.js}

@@ -1,8 +1,8 @@
-import { t as CLIS_CONFIG } from "./ts-DVIq8h5j.js";
+import { t as CLIS_CONFIG } from "./ts-D0sh1_xQ.js";
 
 //#region ts/SUPPORTED_CLIS.ts
 const SUPPORTED_CLIS = Object.keys(CLIS_CONFIG);
 
 //#endregion
 export { SUPPORTED_CLIS as t };
-//# sourceMappingURL=SUPPORTED_CLIS-DsMN-Qhx.js.map
+//# sourceMappingURL=SUPPORTED_CLIS-CiX7yHEr.js.map

package/dist/{SUPPORTED_CLIS-C1gQ4uGn.js → SUPPORTED_CLIS-OujpaqTl.js}

@@ -1,11 +1,11 @@
 import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-DUEHsTJE.js";
-import "./ts-DVIq8h5j.js";
+import "./versionChecker-KLyHD-uA.js";
+import "./ts-D0sh1_xQ.js";
 import "./todoAutomation-BQRW614S.js";
 import "./JsonlStore-CPGIR0Wy.js";
 import "./globalPidIndex-Dq4KY2IV.js";
 import "./pidStore-DJqSZPJi.js";
 import "./messageLog-BYFwioFY.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DsMN-Qhx.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CiX7yHEr.js";
 
 export { SUPPORTED_CLIS };

package/dist/{agentShare-C17BL1b_.js → agentShare-CFkmfmVq.js}

@@ -3,7 +3,7 @@ import "./globalPidIndex-Dq4KY2IV.js";
 import "./messageLog-BYFwioFY.js";
 import "./e2e-CUMZC53I.js";
 import "./configShared-DtHMBCl7.js";
-import { R as resolveOne } from "./subcommands-BYfDH4SQ.js";
+import { R as resolveOne } from "./subcommands-DgTRqMjP.js";
 import "./webrtcLink-CS4D-3G1.js";
 import "./remotes-Cn-wszbK.js";
 import { a as startShare } from "./share-B-e_9WBx.js";
@@ -229,4 +229,4 @@ function transformEvent(rawEvent, agentId, forwarded) {
 
 //#endregion
 export { createScopedShare, listShares, revokeAllShares, revokeShare };
-//# sourceMappingURL=agentShare-C17BL1b_.js.map
+//# sourceMappingURL=agentShare-CFkmfmVq.js.map

package/dist/{callback-DpQpd3oT.js → callback-CYr2w2UB.js}

@@ -3,10 +3,10 @@ import "./globalPidIndex-Dq4KY2IV.js";
 import "./messageLog-BYFwioFY.js";
 import "./e2e-CUMZC53I.js";
 import "./configShared-DtHMBCl7.js";
-import "./subcommands-BYfDH4SQ.js";
+import "./subcommands-DgTRqMjP.js";
 import "./webrtcLink-CS4D-3G1.js";
 import "./remotes-Cn-wszbK.js";
 import "./callbackCore-Cg3Ye0ZS.js";
-import { i as loadOrCreateCallbackSecret, n as isCallbackRevoked, r as loadCallbackSecretReadOnly, t as cmdCallback } from "./callback-Nf4lDypu.js";
+import { i as loadOrCreateCallbackSecret, n as isCallbackRevoked, r as loadCallbackSecretReadOnly, t as cmdCallback } from "./callback-DZn2E6sd.js";
 
 export { cmdCallback };

package/dist/{callback-Nf4lDypu.js → callback-DZn2E6sd.js}

@@ -1,5 +1,5 @@
 import { t as agentYesHome } from "./agentYesHome-CtmsY6I-.js";
-import { R as resolveOne } from "./subcommands-BYfDH4SQ.js";
+import { R as resolveOne } from "./subcommands-DgTRqMjP.js";
 import { a as mintCapability, o as parseExpires } from "./callbackCore-Cg3Ye0ZS.js";
 import { randomBytes } from "node:crypto";
 import { chmodSync, readFileSync, renameSync, writeFileSync } from "node:fs";
@@ -72,7 +72,7 @@ async function resolveBase(flag) {
 	if (flag) return flag;
 	if (process.env.AGENT_YES_CALLBACK_BASE) return process.env.AGENT_YES_CALLBACK_BASE;
 	try {
-		const { resolveLocalServeUrl } = await import("./serve-CQYt24Hc.js");
+		const { resolveLocalServeUrl } = await import("./serve-BrGd7P1-.js");
 		const url = await resolveLocalServeUrl();
 		if (url) return url;
 	} catch {}
@@ -187,4 +187,4 @@ async function cmdCallback(rest) {
 
 //#endregion
 export { loadOrCreateCallbackSecret as i, isCallbackRevoked as n, loadCallbackSecretReadOnly as r, cmdCallback as t };
-//# sourceMappingURL=callback-Nf4lDypu.js.map
+//# sourceMappingURL=callback-DZn2E6sd.js.map

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/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, t as checkAndAutoUpdate } from "./versionChecker-DUEHsTJE.js";
-import { r as getRustBinary } from "./rustBinary-Cz69Ey52.js";
+import { i as versionString, n as displayVersion, t as checkAndAutoUpdate } from "./versionChecker-KLyHD-uA.js";
+import { r as getRustBinary } from "./rustBinary-kNMmfNj8.js";
 import { argv } from "process";
 import { spawn } from "child_process";
 import ms from "ms";
@@ -295,7 +295,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, isUnknownManagerToken, isBareManagerInvocation } = await import("./subcommands-D37Ynyj-.js");
+	const { isSubcommand, runSubcommand, cmdHelp, isUnknownManagerToken, isBareManagerInvocation } = await import("./subcommands-6jo0AAC3.js");
 	if (isHelpFlag && process.argv.length === 3) {
 		await cmdHelp(managerCommands);
 		process.exit(0);
@@ -309,7 +309,7 @@ function buildRustArgs(argv, cliFromScript, supportedClis) {
 		process.exit(code ?? 0);
 	}
 	{
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-C1gQ4uGn.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-OujpaqTl.js");
 		if (isUnknownManagerToken(rawArg, managerCommands, SUPPORTED_CLIS)) {
 			process.stderr.write(`ay: unknown subcommand or CLI '${rawArg}'.\n    See 'ay help' for subcommands. To run an agent, name a CLI:\n    'ay <cli> …' (e.g. 'ay claude …') or 'ay --cli <cli> …'.\n`);
 			process.exit(1);
@@ -360,14 +360,14 @@ if (config.useRust) {
 		}
 	}
 	if (rustBinary) {
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-C1gQ4uGn.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-OujpaqTl.js");
 		const rustArgs = buildRustArgs(process.argv, config.cli, SUPPORTED_CLIS);
 		if (config.verbose) {
 			console.log(`[rust] Using binary: ${rustBinary}`);
 			console.log(`[rust] Args: ${rustArgs.join(" ")}`);
 		}
 		const attach = config.attach || process.env.AGENT_YES_ATTACH === "1";
-		const { shouldForkNested, buildSpawnTutorial, waitForRegistration, predictedLogPath } = await import("./forkNested-CgJ1rTnT.js");
+		const { shouldForkNested, buildSpawnTutorial, waitForRegistration, confirmAgentStarted, predictedLogPath } = await import("./forkNested-VroZS-nk.js");
 		if (shouldForkNested({
 			isTTY: Boolean(process.stdout.isTTY),
 			ayPid: process.env.AGENT_YES_PID,
@@ -396,11 +396,17 @@ if (config.useRust) {
 				console.error(deathMsg);
 				process.exit(1);
 			}
-			forked.unref();
 			if (!registered) {
+				forked.unref();
 				console.error(`Agent pid ${forkedPid} spawned but never became addressable (ay tail/ay send) within 5s.\nLog (if written yet): ${predictedLogPath(process.cwd(), forkedPid)}\nIt may still be starting up — retry: ay tail ${forkedPid}`);
 				process.exit(1);
 			}
+			const started = await confirmAgentStarted(forkedPid, 1500, () => deathMsg !== null);
+			forked.unref();
+			if (!started.ok) {
+				console.error(deathMsg ?? started.reason);
+				process.exit(1);
+			}
 			console.log(buildSpawnTutorial(config.cli || "agent", forkedPid));
 			process.exit(0);
 		}

package/dist/{forkNested-CgJ1rTnT.js → forkNested-VroZS-nk.js}

@@ -65,7 +65,67 @@ async function waitForRegistration(pid, timeoutMs = 5e3, aborted) {
 function predictedLogPath(cwd, pid) {
 	return path.join(cwd, ".agent-yes", `${pid}.raw.log`);
 }
+/** Last `max` bytes of a file as text, or "" if it can't be read. Used to put the
+*  agent's own error (e.g. `error: unknown option '--cwd'`) in the failure message
+*  instead of making the caller go dig for it. */
+async function tailFile(file, max = 400) {
+	if (!file) return "";
+	try {
+		const { readFile } = await import("fs/promises");
+		const text = (await readFile(file, "utf8")).trim();
+		return text.length > max ? `…${text.slice(-max)}` : text;
+	} catch {
+		return "";
+	}
+}
+/**
+* Confirm a just-registered agent actually STARTED, rather than registering and
+* dying a moment later.
+*
+* `waitForRegistration` is necessary but not sufficient: the wrapper writes its
+* pid record before the target CLI has proven it can run, so a CLI that dies on
+* startup (bad flag, missing binary) registers as `active` and only flips to
+* `exited` afterwards. Returning as soon as the record appears therefore printed
+* a success tutorial and exit 0 for an agent that was already dead — a fan-out
+* could collapse in silence (#387).
+*
+* So after registration we hold a short grace window and watch for death. Failure
+* is checked BEFORE liveness each tick: an agent that produced output and *then*
+* died must still be reported dead. The raw-log check is only an early-exit
+* optimisation — real PTY output means the CLI is up, so healthy spawns usually
+* return in well under the grace instead of paying all of it. Timing out is
+* success, keeping the previous behaviour for anything this can't decide.
+*/
+async function confirmAgentStarted(pid, graceMs = 1500, aborted) {
+	const { readGlobalPids } = await import("./globalPidIndex-CQX_0JSB.js");
+	const { stat } = await import("fs/promises");
+	const deadline = Date.now() + graceMs;
+	while (Date.now() < deadline) {
+		if (aborted?.()) return {
+			ok: false,
+			reason: `Agent pid ${pid} died during startup.`
+		};
+		const record = (await readGlobalPids()).find((r) => r.pid === pid);
+		if (!record) return {
+			ok: false,
+			reason: `Agent pid ${pid} disappeared from the registry during startup.`
+		};
+		if (record.status === "exited" || record.exit_code !== null) {
+			const why = record.exit_reason ?? `exit code ${record.exit_code}`;
+			const tail = await tailFile(record.log_file);
+			return {
+				ok: false,
+				reason: `Agent pid ${pid} exited during startup (${why}).` + (tail ? `\n${tail}` : "") + `\nSee: ay tail ${pid}`
+			};
+		}
+		try {
+			if ((await stat(predictedLogPath(record.cwd, pid))).size > 0) return { ok: true };
+		} catch {}
+		await new Promise((r) => setTimeout(r, 100));
+	}
+	return { ok: true };
+}
 
 //#endregion
-export { buildSpawnTutorial, predictedLogPath, shouldForkNested, waitForRegistration };
-//# sourceMappingURL=forkNested-CgJ1rTnT.js.map
+export { buildSpawnTutorial, confirmAgentStarted, predictedLogPath, shouldForkNested, waitForRegistration };
+//# sourceMappingURL=forkNested-VroZS-nk.js.map

package/dist/index.js

@@ -1,6 +1,6 @@
 import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-DUEHsTJE.js";
-import { a as hasTodoStore, i as answerAsk, l as AgentContext, n as agentYes, o as listAsks, r as config, s as listAsksForProject, t as CLIS_CONFIG } from "./ts-DVIq8h5j.js";
+import "./versionChecker-KLyHD-uA.js";
+import { a as hasTodoStore, i as answerAsk, l as AgentContext, n as agentYes, o as listAsks, r as config, s as listAsksForProject, t as CLIS_CONFIG } from "./ts-D0sh1_xQ.js";
 import { _ as isKnownKind, a as renderTree, b as statesOf, c as monitorHint, d as openStore, f as DONE_STATE, g as initialState, h as canTransition, i as renderDigest, l as CycleError, m as ORPHANED_STATE, o as unblockedTasks, p as LIFECYCLES, r as openBlockers, s as describeBlock, t as reconcileTodos, u as TodoStore, v as nextStates, x as removeControlCharacters, y as requiredGate } from "./todoAutomation-BQRW614S.js";
 import "./JsonlStore-CPGIR0Wy.js";
 import "./globalPidIndex-Dq4KY2IV.js";

package/dist/{notifyDaemon-D5BjmH-_.js → notifyDaemon-Qg6V5qxO.js}

@@ -3,7 +3,7 @@ import "./globalPidIndex-Dq4KY2IV.js";
 import "./messageLog-BYFwioFY.js";
 import "./e2e-CUMZC53I.js";
 import "./configShared-DtHMBCl7.js";
-import { E as listRecords, F as renderLogTailLines, Q as hostId, X as appendEvent, Z as gcInboxes, at as daemonLockOwnerPath, b as isPidAlive, et as listInboxParents, it as daemonLockDir, nt as readInbox, ot as notifyDir, rt as shouldStealLock, tt as liveWatchers, u as deriveLiveState } from "./subcommands-BYfDH4SQ.js";
+import { E as listRecords, F as renderLogTailLines, Q as hostId, X as appendEvent, Z as gcInboxes, at as daemonLockOwnerPath, b as isPidAlive, et as listInboxParents, it as daemonLockDir, nt as readInbox, ot as notifyDir, rt as shouldStealLock, tt as liveWatchers, u as deriveLiveState } from "./subcommands-DgTRqMjP.js";
 import "./webrtcLink-CS4D-3G1.js";
 import "./remotes-Cn-wszbK.js";
 import { mkdir, readFile, rename, rm, stat, writeFile } from "fs/promises";
@@ -836,4 +836,4 @@ async function ensureDaemon() {
 
 //#endregion
 export { daemonStatus, ensureDaemon, requestDaemonStop, runDaemon };
-//# sourceMappingURL=notifyDaemon-D5BjmH-_.js.map
+//# sourceMappingURL=notifyDaemon-Qg6V5qxO.js.map

package/dist/{rustBinary-Cz69Ey52.js → rustBinary-kNMmfNj8.js}

@@ -1,4 +1,4 @@
-import { r as getInstalledPackage } from "./versionChecker-DUEHsTJE.js";
+import { r as getInstalledPackage } from "./versionChecker-KLyHD-uA.js";
 import { execFileSync } from "child_process";
 import { existsSync, mkdirSync, unlinkSync } from "fs";
 import { chmod, copyFile } from "fs/promises";
@@ -243,4 +243,4 @@ async function getRustBinary(options = {}) {
 
 //#endregion
 export { findTrayLauncher as n, getRustBinary as r, findSpawnHiddenLauncher as t };
-//# sourceMappingURL=rustBinary-Cz69Ey52.js.map
+//# sourceMappingURL=rustBinary-kNMmfNj8.js.map

package/dist/{schedule-BuACJcy-.js → schedule-BMB6zodv.js}

@@ -1,12 +1,12 @@
 import "./logger-CDIsZ-Pp.js";
-import "./versionChecker-DUEHsTJE.js";
-import "./ts-DVIq8h5j.js";
+import "./versionChecker-KLyHD-uA.js";
+import "./ts-D0sh1_xQ.js";
 import "./todoAutomation-BQRW614S.js";
 import "./JsonlStore-CPGIR0Wy.js";
 import "./globalPidIndex-Dq4KY2IV.js";
 import "./pidStore-DJqSZPJi.js";
 import "./messageLog-BYFwioFY.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DsMN-Qhx.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CiX7yHEr.js";
 import { f as resolveSpawnCwd } from "./workspaceConfig-Bxuk_MOq.js";
 import { n as liveEnv, t as ensureNodeRuntime } from "./nodeRuntime-vhOBffJ3.js";
 import { createHash } from "node:crypto";
@@ -153,4 +153,4 @@ async function cmdSchedule(rest) {
 
 //#endregion
 export { cmdSchedule };
-//# sourceMappingURL=schedule-BuACJcy-.js.map
+//# sourceMappingURL=schedule-BMB6zodv.js.map

package/dist/{serve-CQYt24Hc.js → serve-BrGd7P1-.js}

@@ -1,7 +1,7 @@
 import "./logger-CDIsZ-Pp.js";
-import { r as getInstalledPackage } from "./versionChecker-DUEHsTJE.js";
-import { t as findSpawnHiddenLauncher } from "./rustBinary-Cz69Ey52.js";
-import { c as permissionBadge, i as answerAsk, o as listAsks, u as CLAUDE_SESSION_PIN_ENV } from "./ts-DVIq8h5j.js";
+import { r as getInstalledPackage } from "./versionChecker-KLyHD-uA.js";
+import { t as findSpawnHiddenLauncher } from "./rustBinary-kNMmfNj8.js";
+import { c as permissionBadge, i as answerAsk, o as listAsks, u as CLAUDE_SESSION_PIN_ENV } from "./ts-D0sh1_xQ.js";
 import { t as agentYesHome$1 } from "./agentYesHome-CtmsY6I-.js";
 import { x as removeControlCharacters } from "./todoAutomation-BQRW614S.js";
 import "./JsonlStore-CPGIR0Wy.js";
@@ -11,17 +11,17 @@ import { r as recordInbox } from "./messageLog-BYFwioFY.js";
 import { t as pgidForWrapper } from "./reaper-C4BvNylH.js";
 import "./e2e-CUMZC53I.js";
 import "./configShared-DtHMBCl7.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DsMN-Qhx.js";
-import { $ as isTransientLockMkdirError, A as readLogForRender, E as listRecords, F as renderLogTailLines, I as renderRawLog, L as renderRawLogLines, M as readPtysize, N as recentMessageEdges, P as recentReadEdges, R as resolveOne, U as snapshotStatus, Y as writeToIpc, c as controlCodeFromName, d as deriveLiveStatus, f as extractBadges, h as extractTaskCounts, j as readNotes, m as extractNeedsInput, st as TYPING_BADGE, w as isUserTyping } from "./subcommands-BYfDH4SQ.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-CiX7yHEr.js";
+import { $ as isTransientLockMkdirError, A as readLogForRender, E as listRecords, F as renderLogTailLines, I as renderRawLog, L as renderRawLogLines, M as readPtysize, N as recentMessageEdges, P as recentReadEdges, R as resolveOne, U as snapshotStatus, Y as writeToIpc, c as controlCodeFromName, d as deriveLiveStatus, f as extractBadges, h as extractTaskCounts, j as readNotes, m as extractNeedsInput, st as TYPING_BADGE, w as isUserTyping } from "./subcommands-DgTRqMjP.js";
 import "./webrtcLink-CS4D-3G1.js";
 import "./remotes-Cn-wszbK.js";
 import { i as frameVisitorMessage, s as verifyCapability, t as MAX_CALLBACK_MSG_BYTES } from "./callbackCore-Cg3Ye0ZS.js";
-import { n as isCallbackRevoked, r as loadCallbackSecretReadOnly } from "./callback-Nf4lDypu.js";
+import { n as isCallbackRevoked, r as loadCallbackSecretReadOnly } from "./callback-DZn2E6sd.js";
 import { a as getProvisionRoot, d as isProvisionAllowed, f as resolveSpawnCwd, i as getProvisionHook, l as hasProvisionHook, o as getSpawnHook, t as allowsSkipPermissions, u as hasSpawnHook } from "./workspaceConfig-Bxuk_MOq.js";
 import { n as liveEnv, t as ensureNodeRuntime } from "./nodeRuntime-vhOBffJ3.js";
-import { i as importProvisionModule } from "./ws-BmiW-eii.js";
+import { i as importProvisionModule } from "./ws-B-IGyUgB.js";
 import { r as spawnRejectionReason } from "./spawnGate-D0E1uRP7.js";
-import { i as launchTray } from "./trayApp-zMbgujQq.js";
+import { i as launchTray } from "./trayApp-MWLojgyP.js";
 import yargs from "yargs";
 import { appendFile, mkdir, open, readFile, readdir, rename, rm, stat, unlink, writeFile } from "fs/promises";
 import { arch, cpus, freemem, homedir, hostname, loadavg, platform, totalmem, uptime, userInfo } from "os";
@@ -2434,7 +2434,7 @@ Options:
 			}
 		});
 		if (req.method === "GET" && p === "/api/ws") {
-			const ws = await import("./ws-BX-u3JDN.js");
+			const ws = await import("./ws-BuHoc6N5.js");
 			try {
 				await ws.loadProvision();
 			} catch (e) {
@@ -2454,7 +2454,7 @@ Options:
 		if (req.method === "GET" && p === "/api/ws/status") {
 			const dirRaw = url.searchParams.get("path");
 			if (!dirRaw) return new Response("missing ?path=<workspace dir>", { status: 400 });
-			const ws = await import("./ws-BX-u3JDN.js");
+			const ws = await import("./ws-BuHoc6N5.js");
 			let prov;
 			try {
 				prov = await ws.loadProvision();
@@ -2476,7 +2476,7 @@ Options:
 			}
 		}
 		if (req.method === "GET" && p === "/api/ws/repos") {
-			const ws = await import("./ws-BX-u3JDN.js");
+			const ws = await import("./ws-BuHoc6N5.js");
 			try {
 				await ws.loadProvision();
 			} catch (e) {
@@ -2557,7 +2557,7 @@ Options:
 			const m = /^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)$/.exec(repoParam);
 			if (!m || m[1] === "." || m[1] === ".." || m[2] === "." || m[2] === "..") return new Response("missing/invalid ?repo=<owner>/<repo>", { status: 400 });
 			const [, owner, repo] = m;
-			const ws = await import("./ws-BX-u3JDN.js");
+			const ws = await import("./ws-BuHoc6N5.js");
 			let prov;
 			try {
 				prov = await ws.loadProvision();
@@ -3465,7 +3465,7 @@ Options:
 			const perm = body.perm ?? "r";
 			if (perm !== "r" && perm !== "rw") return new Response(`invalid perm ${perm} (want r or rw)`, { status: 400 });
 			try {
-				const { createScopedShare } = await import("./agentShare-C17BL1b_.js");
+				const { createScopedShare } = await import("./agentShare-CFkmfmVq.js");
 				const share = await createScopedShare({
 					agent: body.agent,
 					perm,
@@ -3480,12 +3480,12 @@ Options:
 			}
 		}
 		if (req.method === "GET" && p === "/api/shares") {
-			const { listShares } = await import("./agentShare-C17BL1b_.js");
+			const { listShares } = await import("./agentShare-CFkmfmVq.js");
 			return Response.json(listShares());
 		}
 		const revokeM = /^\/api\/share\/([^/]+)$/.exec(p);
 		if (req.method === "DELETE" && revokeM) {
-			const { revokeShare } = await import("./agentShare-C17BL1b_.js");
+			const { revokeShare } = await import("./agentShare-CFkmfmVq.js");
 			const ok = revokeShare(decodeURIComponent(revokeM[1]));
 			return new Response(ok ? "revoked" : "no such share", { status: ok ? 200 : 404 });
 		}
@@ -3787,7 +3787,7 @@ Options:
 	const shutdown = (resolve) => {
 		if (heartbeat) clearInterval(heartbeat);
 		closeShare?.();
-		import("./agentShare-C17BL1b_.js").then((m) => m.revokeAllShares()).catch(() => {});
+		import("./agentShare-CFkmfmVq.js").then((m) => m.revokeAllShares()).catch(() => {});
 		server?.stop();
 		Promise.resolve(releaseHostLock?.()).catch(() => {}).then(resolve);
 	};
@@ -3800,4 +3800,4 @@ Options:
 
 //#endregion
 export { cmdServe, loadTokenReadOnly, mintScopedTermToken, resolveDaemonHttpBase, resolveLocalServeUrl };
-//# sourceMappingURL=serve-CQYt24Hc.js.map
+//# sourceMappingURL=serve-BrGd7P1-.js.map

package/dist/{setup-Cde6gwt9.js → setup-DSeq3EW2.js}

@@ -40,7 +40,7 @@ async function cmdSetup(rest) {
 	} catch {}
 	if (noShare) return 0;
 	process.stdout.write(`\nsharing this machine to agent-yes.com…\n`);
-	const { cmdServe } = await import("./serve-CQYt24Hc.js");
+	const { cmdServe } = await import("./serve-BrGd7P1-.js");
 	return cmdServe([
 		"install",
 		"--share",
@@ -50,4 +50,4 @@ async function cmdSetup(rest) {
 
 //#endregion
 export { cmdSetup };
-//# sourceMappingURL=setup-Cde6gwt9.js.map
+//# sourceMappingURL=setup-DSeq3EW2.js.map

package/dist/{subcommands-D37Ynyj-.js → subcommands-6jo0AAC3.js}

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

package/dist/{subcommands-BYfDH4SQ.js → subcommands-DgTRqMjP.js}

@@ -1548,35 +1548,35 @@ async function runSubcommand(argv) {
 				return cmdCh(rest);
 			}
 			case "term": {
-				const { cmdTerm } = await import("./terminal-ZdVfflLy.js");
+				const { cmdTerm } = await import("./terminal-C32Lt-xl.js");
 				return cmdTerm(rest);
 			}
 			case "widget": {
-				const { cmdWidget } = await import("./widget-DCZczYo6.js");
+				const { cmdWidget } = await import("./widget-DRsjPRum.js");
 				return cmdWidget(rest);
 			}
 			case "mint": {
-				const { cmdMint } = await import("./widget-DCZczYo6.js");
+				const { cmdMint } = await import("./widget-DRsjPRum.js");
 				return cmdMint(rest);
 			}
 			case "serve": {
-				const { cmdServe } = await import("./serve-CQYt24Hc.js");
+				const { cmdServe } = await import("./serve-BrGd7P1-.js");
 				return cmdServe(rest);
 			}
 			case "tray": {
-				const { cmdTray } = await import("./trayApp-C2duKfsY.js");
+				const { cmdTray } = await import("./trayApp-BB_f9Qd4.js");
 				return cmdTray(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup-Cde6gwt9.js");
+				const { cmdSetup } = await import("./setup-DSeq3EW2.js");
 				return cmdSetup(rest);
 			}
 			case "ws": {
-				const { cmdWs } = await import("./ws-BX-u3JDN.js");
+				const { cmdWs } = await import("./ws-BuHoc6N5.js");
 				return cmdWs(rest);
 			}
 			case "schedule": {
-				const { cmdSchedule } = await import("./schedule-BuACJcy-.js");
+				const { cmdSchedule } = await import("./schedule-BMB6zodv.js");
 				return cmdSchedule(rest);
 			}
 			case "remote": {
@@ -1588,7 +1588,7 @@ async function runSubcommand(argv) {
 				return cmdExpose(rest);
 			}
 			case "callback": {
-				const { cmdCallback } = await import("./callback-DpQpd3oT.js");
+				const { cmdCallback } = await import("./callback-CYr2w2UB.js");
 				return cmdCallback(rest);
 			}
 			case "reap":
@@ -4076,7 +4076,7 @@ async function cmdAttach(rest) {
 	const winsizeDir = path.join(ayHome, "winsize");
 	await mkdir(winsizeDir, { recursive: true });
 	const winsizePath = path.join(winsizeDir, String(record.pid));
-	const { resolveDaemonHttpBase, loadTokenReadOnly } = await import("./serve-CQYt24Hc.js");
+	const { resolveDaemonHttpBase, loadTokenReadOnly } = await import("./serve-BrGd7P1-.js");
 	const daemonBase = await resolveDaemonHttpBase().catch(() => null);
 	const daemonToken = daemonBase ? await loadTokenReadOnly().catch(() => null) ?? "" : "";
 	const capViewer = `attach:${process.pid}`;
@@ -4786,7 +4786,7 @@ async function cmdNotify(rest) {
 	}
 	const ensure = async () => {
 		if (!argv["ensure-daemon"]) return;
-		const { ensureDaemon } = await import("./notifyDaemon-D5BjmH-_.js");
+		const { ensureDaemon } = await import("./notifyDaemon-Qg6V5qxO.js");
 		await ensureDaemon().catch(() => null);
 	};
 	await heartbeatWatcher(parent, selfStartedAt);
@@ -4860,7 +4860,7 @@ async function cmdNotifyCursor(args) {
 }
 async function cmdNotifyd(rest) {
 	const sub = rest[0] ?? "status";
-	const daemon = await import("./notifyDaemon-D5BjmH-_.js");
+	const daemon = await import("./notifyDaemon-Qg6V5qxO.js");
 	switch (sub) {
 		case "run": return daemon.runDaemon();
 		case "once": return daemon.runDaemon({ once: true });
@@ -4887,4 +4887,4 @@ async function cmdNotifyd(rest) {
 
 //#endregion
 export { isTransientLockMkdirError as $, readLogForRender as A, resolveResumeArgs as B, isUnknownManagerToken as C, matchKeyword as D, listRecords as E, renderLogTailLines as F, stopTipForCli as G, runSubcommand as H, renderRawLog as I, writeKeysPaced as J, submitAndConfirm as K, renderRawLogLines as L, readPtysize as M, recentMessageEdges as N, menuSelectKeys as O, recentReadEdges as P, hostId as Q, resolveOne as R, isSubcommand as S, lastStdinAt as T, snapshotStatus as U, restartHintLines as V, stdinActivityPath as W, appendEvent as X, writeToIpc as Y, gcInboxes as Z, isAgentStuck as _, backoffWhileTyping as a, daemonLockOwnerPath as at, isPidAlive as b, controlCodeFromName as c, deriveLiveStatus as d, listInboxParents as et, extractBadges as f, finalizedLines as g, extractTaskCounts as h, TYPING_WINDOW_MS as i, daemonLockDir as it, readNotes as j, readAgentPtysize as k, cursorAbs as l, extractNeedsInput as m, MAX_RENDER_BYTES as n, readInbox as nt, cmdDeepseek as o, notifyDir as ot, extractMenu as p, waitForLogQuiet as q, READ_PAGE_DEFAULT as r, shouldStealLock as rt, cmdHelp as s, TYPING_BADGE as st, GRACEFUL_EXIT_COMMANDS as t, liveWatchers as tt, deriveLiveState as u, isBareManagerInvocation as v, isUserTyping as w, isSlashCommand as x, isExitRequest as y, resolveReadWindow as z };
-//# sourceMappingURL=subcommands-BYfDH4SQ.js.map
+//# sourceMappingURL=subcommands-DgTRqMjP.js.map

package/dist/{terminal-ZdVfflLy.js → terminal-C32Lt-xl.js}

@@ -98,7 +98,7 @@ async function cmdTermMint(args) {
 	if (flags.ro && flags.interactive) throw new Error("--ro and --interactive are mutually exclusive");
 	const ttlSec = parseTtlSec(typeof flags.ttl === "string" ? flags.ttl : "15m");
 	const canSend = flags.interactive === true;
-	const { mintScopedTermToken } = await import("./serve-CQYt24Hc.js");
+	const { mintScopedTermToken } = await import("./serve-BrGd7P1-.js");
 	const r = await mintScopedTermToken(pid, {
 		ttlSec,
 		canSend
@@ -135,4 +135,4 @@ async function cmdTerm(args) {
 
 //#endregion
 export { cmdTerm };
-//# sourceMappingURL=terminal-ZdVfflLy.js.map
+//# sourceMappingURL=terminal-C32Lt-xl.js.map

package/dist/trayApp-BB_f9Qd4.js

@@ -0,0 +1,5 @@
+import "./versionChecker-KLyHD-uA.js";
+import "./rustBinary-kNMmfNj8.js";
+import { a as trayHiddenMarker, i as launchTray, n as hasDesktop, r as isTrayHidden, t as cmdTray } from "./trayApp-MWLojgyP.js";
+
+export { cmdTray };

package/dist/{trayApp-zMbgujQq.js → trayApp-MWLojgyP.js}

@@ -1,4 +1,4 @@
-import { n as findTrayLauncher } from "./rustBinary-Cz69Ey52.js";
+import { n as findTrayLauncher } from "./rustBinary-kNMmfNj8.js";
 import { t as agentYesHome } from "./agentYesHome-CtmsY6I-.js";
 import { existsSync } from "node:fs";
 import path from "node:path";
@@ -97,4 +97,4 @@ async function cmdTray(args) {
 
 //#endregion
 export { trayHiddenMarker as a, launchTray as i, hasDesktop as n, isTrayHidden as r, cmdTray as t };
-//# sourceMappingURL=trayApp-zMbgujQq.js.map
+//# sourceMappingURL=trayApp-MWLojgyP.js.map

package/dist/{ts-DVIq8h5j.js → ts-D0sh1_xQ.js}

@@ -1,6 +1,6 @@
 import { n as __esmMin, r as __exportAll } from "./chunk-cZBX9HZv.js";
 import { n as logger, t as addTransport } from "./logger-CDIsZ-Pp.js";
-import { r as getInstalledPackage } from "./versionChecker-DUEHsTJE.js";
+import { r as getInstalledPackage } from "./versionChecker-KLyHD-uA.js";
 import { t as agentYesHome } from "./agentYesHome-CtmsY6I-.js";
 import { d as openStore, p as LIFECYCLES, x as removeControlCharacters } from "./todoAutomation-BQRW614S.js";
 import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-DBoONoM-.js";
@@ -2299,4 +2299,4 @@ function sleep(ms) {
 
 //#endregion
 export { hasTodoStore as a, permissionBadge as c, answerAsk as i, AgentContext as l, agentYes as n, listAsks as o, config as r, listAsksForProject as s, CLIS_CONFIG as t, CLAUDE_SESSION_PIN_ENV as u };
-//# sourceMappingURL=ts-DVIq8h5j.js.map
+//# sourceMappingURL=ts-D0sh1_xQ.js.map

package/dist/{versionChecker-DUEHsTJE.js → versionChecker-KLyHD-uA.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "agent-yes";
-var version = "1.265.0";
+var version = "1.265.1";
 
 //#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-DUEHsTJE.js.map
+//# sourceMappingURL=versionChecker-KLyHD-uA.js.map

package/dist/{widget-DCZczYo6.js → widget-DRsjPRum.js}

@@ -28,7 +28,7 @@ function parseFlags(args, known) {
 }
 /** Resolve the local daemon base URL + token (flags override discovery). */
 async function daemonTarget(flags) {
-	const { resolveDaemonHttpBase, loadTokenReadOnly } = await import("./serve-CQYt24Hc.js");
+	const { resolveDaemonHttpBase, loadTokenReadOnly } = await import("./serve-BrGd7P1-.js");
 	const base = typeof flags.base === "string" ? flags.base : await resolveDaemonHttpBase();
 	if (!base) throw new Error("no running ay serve daemon found — start `ay serve` or pass --base <url> (e.g. http://127.0.0.1:PORT)");
 	const token = typeof flags.token === "string" ? flags.token : await loadTokenReadOnly() ?? "";
@@ -186,7 +186,7 @@ async function cmdMint(args) {
 	const bad = caps.filter((c) => !KNOWN_CAPS.has(c));
 	if (bad.length) throw new Error(`unknown cap(s): ${bad.join(", ")} (valid: ${[...KNOWN_CAPS].join(", ")})`);
 	const ttlSec = parseTtlSec(typeof flags.ttl === "string" ? flags.ttl : "15m");
-	const { mintScopedTermToken } = await import("./serve-CQYt24Hc.js");
+	const { mintScopedTermToken } = await import("./serve-BrGd7P1-.js");
 	const r = await mintScopedTermToken(target, {
 		ttlSec,
 		caps
@@ -202,4 +202,4 @@ async function cmdMint(args) {
 
 //#endregion
 export { cmdMint, cmdWidget };
-//# sourceMappingURL=widget-DCZczYo6.js.map
+//# sourceMappingURL=widget-DRsjPRum.js.map

package/dist/{ws-BmiW-eii.js → ws-B-IGyUgB.js}

@@ -1,4 +1,4 @@
-import { E as listRecords } from "./subcommands-BYfDH4SQ.js";
+import { E as listRecords } from "./subcommands-DgTRqMjP.js";
 import { a as getProvisionRoot } from "./workspaceConfig-Bxuk_MOq.js";
 import { existsSync } from "fs";
 import { lstat, opendir } from "fs/promises";
@@ -396,7 +396,7 @@ async function cmdWsFork(args) {
 		return 1;
 	}
 	process.stdout.write(`${res.action}  ${res.folder}\n`);
-	process.stderr.write(`\n  ay claude --cwd ${res.folder} -- "<prompt>"   # work there\n`);
+	process.stderr.write(`\n  cd ${res.folder} && ay claude -- "<prompt>"   # work there\n`);
 	return 0;
 }
 function wsHelp() {
@@ -426,4 +426,4 @@ async function cmdWs(args) {
 
 //#endregion
 export { isPathInside as a, walkWorkspaces as c, importProvisionModule as i, workspaceStatus as l, cmdWs as n, loadProvision as o, collectWorkspaces as r, resolveOperand as s, WS_JSON_SCHEMA as t };
-//# sourceMappingURL=ws-BmiW-eii.js.map
+//# sourceMappingURL=ws-B-IGyUgB.js.map

package/dist/{ws-BX-u3JDN.js → ws-BuHoc6N5.js}

@@ -3,9 +3,9 @@ import "./globalPidIndex-Dq4KY2IV.js";
 import "./messageLog-BYFwioFY.js";
 import "./e2e-CUMZC53I.js";
 import "./configShared-DtHMBCl7.js";
-import "./subcommands-BYfDH4SQ.js";
+import "./subcommands-DgTRqMjP.js";
 import "./webrtcLink-CS4D-3G1.js";
 import "./remotes-Cn-wszbK.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-BmiW-eii.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-B-IGyUgB.js";
 
 export { WS_JSON_SCHEMA, cmdWs, collectWorkspaces, isPathInside, loadProvision, walkWorkspaces, workspaceStatus };

package/examples/spawn-notify.sh

@@ -31,9 +31,12 @@ task="$*"
 
 # 1) Fire-and-forget. nohup+disown so the agent outlives this waiter; agent-yes
 #    keeps its own PTY log under ~/.agent-yes, so /dev/null here loses nothing.
+#    `cd` in a subshell rather than `--cwd`: that flag is deprecated on an agent
+#    run, and anything in AY_FLAGS would sit before it, so agent-yes never parses
+#    it — it lands in the trailing args and the CLI dies on the unknown option.
 mkdir -p "$cwd"
 # shellcheck disable=SC2086
-nohup ay "$cli" ${AY_FLAGS:-} --cwd "$cwd" -- "$task" >/dev/null 2>&1 &
+( cd "$cwd" && exec nohup ay "$cli" ${AY_FLAGS:-} -- "$task" >/dev/null 2>&1 ) &
 disown || true
 
 # 2) Resolve the agent we just spawned to an EXACT pid (newest match in this cwd),

package/package.json

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

package/ts/cli.ts

@@ -157,8 +157,13 @@ if (config.useRust) {
     // agent so we don't block the parent's tool call for the whole session, then
     // print how to drive it and exit. `--attach`/AGENT_YES_ATTACH=1 opts out.
     const attach = config.attach || process.env.AGENT_YES_ATTACH === "1";
-    const { shouldForkNested, buildSpawnTutorial, waitForRegistration, predictedLogPath } =
-      await import("./forkNested.ts");
+    const {
+      shouldForkNested,
+      buildSpawnTutorial,
+      waitForRegistration,
+      confirmAgentStarted,
+      predictedLogPath,
+    } = await import("./forkNested.ts");
     if (
       shouldForkNested({
         isTTY: Boolean(process.stdout.isTTY),
@@ -196,8 +201,8 @@ if (config.useRust) {
         console.error(deathMsg);
         process.exit(1);
       }
-      forked.unref();
       if (!registered) {
+        forked.unref();
         console.error(
           `Agent pid ${forkedPid} spawned but never became addressable (ay tail/ay send) within 5s.\n` +
             `Log (if written yet): ${predictedLogPath(process.cwd(), forkedPid)}\n` +
@@ -205,6 +210,16 @@ if (config.useRust) {
         );
         process.exit(1);
       }
+      // Registration only proves the wrapper got far enough to write its record —
+      // the CLI can still die immediately after. Confirm it actually started before
+      // claiming success, or a caller fanning out reads "Spawned pid N" + exit 0 for
+      // a dead agent (#387). Keep the exit/error listeners live until this resolves.
+      const started = await confirmAgentStarted(forkedPid, 1500, () => deathMsg !== null);
+      forked.unref();
+      if (!started.ok) {
+        console.error(deathMsg ?? started.reason);
+        process.exit(1);
+      }
       console.log(buildSpawnTutorial(config.cli || "agent", forkedPid));
       process.exit(0);
     }

package/ts/forkNested.spec.ts

@@ -1,9 +1,10 @@
-import { appendFileSync, mkdtempSync, rmSync } from "fs";
+import { appendFileSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "fs";
 import { tmpdir } from "os";
 import path from "path";
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
 import {
   buildSpawnTutorial,
+  confirmAgentStarted,
   predictedLogPath,
   shouldForkNested,
   waitForRegistration,
@@ -94,6 +95,106 @@ describe("waitForRegistration", () => {
   });
 });
 
+describe("confirmAgentStarted", () => {
+  let home: string;
+  let proj: string;
+  let prevHome: string | undefined;
+
+  const appendPid = (record: Record<string, unknown>) =>
+    appendFileSync(path.join(home, "pids.jsonl"), JSON.stringify(record) + "\n");
+
+  const live = (pid: number, over: Record<string, unknown> = {}) => ({
+    pid,
+    cli: "claude",
+    prompt: null,
+    cwd: proj,
+    log_file: null,
+    status: "active",
+    exit_code: null,
+    exit_reason: null,
+    started_at: Date.now(),
+    ...over,
+  });
+
+  /** Write the raw log the wrapper produces once the CLI is really up. */
+  const writeRawLog = (pid: number, body = "\x1b[?25l hello") => {
+    mkdirSync(path.join(proj, ".agent-yes"), { recursive: true });
+    writeFileSync(predictedLogPath(proj, pid), body);
+  };
+
+  beforeEach(() => {
+    home = mkdtempSync(path.join(tmpdir(), "ay-confirm-home-"));
+    proj = mkdtempSync(path.join(tmpdir(), "ay-confirm-proj-"));
+    prevHome = process.env.AGENT_YES_HOME;
+    process.env.AGENT_YES_HOME = home;
+  });
+
+  afterEach(() => {
+    if (prevHome === undefined) delete process.env.AGENT_YES_HOME;
+    else process.env.AGENT_YES_HOME = prevHome;
+    rmSync(home, { recursive: true, force: true });
+    rmSync(proj, { recursive: true, force: true });
+  });
+
+  it("fails when the agent flips to exited inside the grace window — the #387 race", async () => {
+    appendPid(live(501));
+    setTimeout(
+      () => appendPid(live(501, { status: "exited", exit_code: 1, exit_reason: "fatal" })),
+      60,
+    );
+    const res = await confirmAgentStarted(501, 2000);
+    expect(res.ok).toBe(false);
+    if (!res.ok) {
+      expect(res.reason).toContain("exited during startup");
+      expect(res.reason).toContain("fatal");
+      expect(res.reason).toContain("ay tail 501");
+    }
+  });
+
+  it("puts the agent's own error output in the failure message", async () => {
+    const errLog = path.join(proj, "boom.log");
+    writeFileSync(errLog, "error: unknown option '--cwd'\n");
+    appendPid(
+      live(502, { status: "exited", exit_code: 1, exit_reason: "fatal", log_file: errLog }),
+    );
+    const res = await confirmAgentStarted(502, 300);
+    expect(res.ok).toBe(false);
+    if (!res.ok) expect(res.reason).toContain("error: unknown option '--cwd'");
+  });
+
+  it("reports death even when the agent produced output before dying", async () => {
+    writeRawLog(503);
+    appendPid(live(503, { status: "exited", exit_code: 1, exit_reason: "fatal" }));
+    // Liveness must never outrank the failure check within a tick.
+    await expect(confirmAgentStarted(503, 300)).resolves.toMatchObject({ ok: false });
+  });
+
+  it("returns early once the raw log proves the CLI is up", async () => {
+    appendPid(live(504));
+    writeRawLog(504);
+    const start = Date.now();
+    await expect(confirmAgentStarted(504, 5000)).resolves.toEqual({ ok: true });
+    expect(Date.now() - start).toBeLessThan(1000); // did not pay the whole grace
+  });
+
+  it("succeeds at the deadline when the agent is alive but quiet", async () => {
+    appendPid(live(505));
+    await expect(confirmAgentStarted(505, 250)).resolves.toEqual({ ok: true });
+  });
+
+  it("fails when aborted() reports the wrapper already died", async () => {
+    appendPid(live(506));
+    const res = await confirmAgentStarted(506, 5000, () => true);
+    expect(res.ok).toBe(false);
+  });
+
+  it("fails when the record vanished — compaction drops dead+exited agents", async () => {
+    const res = await confirmAgentStarted(507, 300);
+    expect(res.ok).toBe(false);
+    if (!res.ok) expect(res.reason).toContain("disappeared from the registry");
+  });
+});
+
 describe("predictedLogPath", () => {
   it("matches the Rust wrapper's <cwd>/.agent-yes/<pid>.raw.log convention", () => {
     expect(predictedLogPath("/home/u/proj", 4242)).toBe(

package/ts/forkNested.ts

@@ -76,3 +76,83 @@ export async function waitForRegistration(
 export function predictedLogPath(cwd: string, pid: number): string {
   return path.join(cwd, ".agent-yes", `${pid}.raw.log`);
 }
+
+/** Outcome of {@link confirmAgentStarted}: started, or died with a reason to print. */
+export type StartConfirmation = { ok: true } | { ok: false; reason: string };
+
+/** Last `max` bytes of a file as text, or "" if it can't be read. Used to put the
+ *  agent's own error (e.g. `error: unknown option '--cwd'`) in the failure message
+ *  instead of making the caller go dig for it. */
+async function tailFile(file: string | null | undefined, max = 400): Promise<string> {
+  if (!file) return "";
+  try {
+    const { readFile } = await import("fs/promises");
+    const text = (await readFile(file, "utf8")).trim();
+    return text.length > max ? `…${text.slice(-max)}` : text;
+  } catch {
+    return "";
+  }
+}
+
+/**
+ * Confirm a just-registered agent actually STARTED, rather than registering and
+ * dying a moment later.
+ *
+ * `waitForRegistration` is necessary but not sufficient: the wrapper writes its
+ * pid record before the target CLI has proven it can run, so a CLI that dies on
+ * startup (bad flag, missing binary) registers as `active` and only flips to
+ * `exited` afterwards. Returning as soon as the record appears therefore printed
+ * a success tutorial and exit 0 for an agent that was already dead — a fan-out
+ * could collapse in silence (#387).
+ *
+ * So after registration we hold a short grace window and watch for death. Failure
+ * is checked BEFORE liveness each tick: an agent that produced output and *then*
+ * died must still be reported dead. The raw-log check is only an early-exit
+ * optimisation — real PTY output means the CLI is up, so healthy spawns usually
+ * return in well under the grace instead of paying all of it. Timing out is
+ * success, keeping the previous behaviour for anything this can't decide.
+ */
+export async function confirmAgentStarted(
+  pid: number,
+  graceMs = 1500,
+  aborted?: () => boolean,
+): Promise<StartConfirmation> {
+  const { readGlobalPids } = await import("./globalPidIndex.ts");
+  const { stat } = await import("fs/promises");
+  const deadline = Date.now() + graceMs;
+
+  while (Date.now() < deadline) {
+    if (aborted?.()) return { ok: false, reason: `Agent pid ${pid} died during startup.` };
+
+    const record = (await readGlobalPids()).find((r) => r.pid === pid);
+    // Gone entirely: compaction drops records that are both dead and exited, so a
+    // vanished record is a death we merely failed to observe — not "keep waiting".
+    if (!record) {
+      return {
+        ok: false,
+        reason: `Agent pid ${pid} disappeared from the registry during startup.`,
+      };
+    }
+    if (record.status === "exited" || record.exit_code !== null) {
+      const why = record.exit_reason ?? `exit code ${record.exit_code}`;
+      const tail = await tailFile(record.log_file);
+      return {
+        ok: false,
+        reason:
+          `Agent pid ${pid} exited during startup (${why}).` +
+          (tail ? `\n${tail}` : "") +
+          `\nSee: ay tail ${pid}`,
+      };
+    }
+    // Positive proof of life: the wrapper only has PTY bytes to write once the CLI
+    // is actually running. Built from the RECORD's cwd, not ours — under `--cwd`
+    // they differ, and that divergence is exactly what this path gets wrong.
+    try {
+      if ((await stat(predictedLogPath(record.cwd, pid))).size > 0) return { ok: true };
+    } catch {
+      // No raw log yet — normal this early; keep watching for death instead.
+    }
+    await new Promise((r) => setTimeout(r, 100));
+  }
+  return { ok: true };
+}

package/ts/ws.ts

@@ -529,7 +529,12 @@ async function cmdWsFork(args: string[]): Promise<number> {
     return 1;
   }
   process.stdout.write(`${res.action}  ${res.folder}\n`);
-  process.stderr.write(`\n  ay claude --cwd ${res.folder} -- "<prompt>"   # work there\n`);
+  // `cd <dir> && ay …`, never `ay … --cwd <dir>`: --cwd is deprecated on an agent
+  // run, and a CLI-specific flag placed before it (`ay claude --model X --cwd D`)
+  // is swallowed into clap's trailing args and forwarded to the target CLI, which
+  // dies on the unknown option. cd has neither problem and puts every relative
+  // path in the command in the same place as the agent.
+  process.stderr.write(`\n  cd ${res.folder} && ay claude -- "<prompt>"   # work there\n`);
   return 0;
 }
 

package/dist/trayApp-C2duKfsY.js

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