agent-yes 1.300.3 → 1.300.4

package/dist/{subcommands-UWLkF5pq.js → subcommands-Ddo2TYZs.js}

@@ -8,7 +8,7 @@ import { n as localHost, r as localUser, t as formatIdentity } from "./identity-
 import { n as isWorkingScreen, r as parseMenu, t as classifyNeedsInput } from "./needsInput-BHopZGM8.js";
 import { S as postmortemStartedAt, _ as filterSinceSeq, a as getCursor, b as maxSeq, f as readInbox, o as heartbeatWatcher, p as setCursor, r as clearWatcher, s as hostId, v as filterSinceTs, y as filterUnread } from "./notifyStore-2SWKGwZI.js";
 import { n as isWebrtcSpec } from "./webrtcLink-DFRyWNMs.js";
-import { l as readRemotes, u as resolveRemoteSpec } from "./remotes-B4v0Nowo.js";
+import { l as readRemotes, u as resolveRemoteSpec } from "./remotes-B4CNXwDS.js";
 import { execFile } from "child_process";
 import ms from "ms";
 import yargs from "yargs";
@@ -17,7 +17,7 @@ import { appendFile, mkdir, open, readFile, readdir, rename, rm, stat, writeFile
 import { homedir } from "os";
 import path from "path";
 import { lock } from "proper-lockfile";
-import { execFileSync as execFileSync$1 } from "node:child_process";
+import { execFileSync as execFileSync$1, spawn as spawn$1 } from "node:child_process";
 import { createHash, randomBytes } from "crypto";
 import { promisify } from "util";
 
@@ -762,6 +762,137 @@ async function readAncestryTable(read = readProcessTable) {
 	}
 }
 
+//#endregion
+//#region ts/remoteCache.ts
+/** Rows younger than this are served as-is without kicking a refresh. */
+const REMOTE_CACHE_FRESH_MS = 3e4;
+function remoteCachePath(alias) {
+	return path.join(agentYesHome(), "remotes", `${encodeURIComponent(alias)}.cache.json`);
+}
+/** The persisted snapshot, or null for missing/corrupt — a cold cache, never an error. */
+async function readRemoteSnapshot(alias) {
+	try {
+		const parsed = JSON.parse(await readFile(remoteCachePath(alias), "utf-8"));
+		if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
+		const s = parsed;
+		if (s.version !== 1 || !Array.isArray(s.records)) return null;
+		const fetchedAt = typeof s.fetchedAt === "number" && Number.isFinite(s.fetchedAt) ? s.fetchedAt : null;
+		const e = s.error;
+		const error = e && typeof e === "object" && typeof e.message === "string" && typeof e.since === "number" ? {
+			message: e.message,
+			since: e.since,
+			lastTriedAt: Number(e.lastTriedAt) || e.since
+		} : null;
+		return {
+			version: 1,
+			alias,
+			fetchedAt,
+			records: s.records,
+			error
+		};
+	} catch {
+		return null;
+	}
+}
+/** tmp + rename, like the health file: a concurrent reader never sees a torn file. */
+async function writeRemoteSnapshot(snap) {
+	const dest = remoteCachePath(snap.alias);
+	await mkdir(path.dirname(dest), { recursive: true });
+	const tmp = `${dest}.${process.pid}.tmp`;
+	await writeFile(tmp, JSON.stringify(snap));
+	await rename(tmp, dest);
+}
+/**
+* Fold one fetch into the snapshot. Success replaces the rows and clears the
+* error; failure keeps the last good rows and extends the streak, preserving
+* `since` so the operator sees "unreachable since 14:02", not "since now".
+*/
+function noteSnapshotResult(prev, alias, result, now) {
+	if (result.ok) return {
+		version: 1,
+		alias,
+		fetchedAt: now,
+		records: result.records,
+		error: null
+	};
+	return {
+		version: 1,
+		alias,
+		fetchedAt: prev?.fetchedAt ?? null,
+		records: prev?.records ?? [],
+		error: {
+			message: result.message,
+			since: prev?.error?.since ?? now,
+			lastTriedAt: now
+		}
+	};
+}
+/** Whether the rows are old enough to warrant a refresh. Fails open to "stale". */
+function isStale(snap, now, freshMs = REMOTE_CACHE_FRESH_MS) {
+	if (!snap || snap.fetchedAt === null) return true;
+	const age = now - snap.fetchedAt;
+	return age < 0 || age >= freshMs;
+}
+/** "0s", "42s", "3m", "5h", "2d" — the table's AGE column vocabulary. */
+function humanizeAge(ms) {
+	if (ms < 1e3) return "0s";
+	const s = Math.floor(ms / 1e3);
+	if (s < 60) return `${s}s`;
+	const m = Math.floor(s / 60);
+	if (m < 60) return `${m}m`;
+	const h = Math.floor(m / 60);
+	if (h < 24) return `${h}h`;
+	return `${Math.floor(h / 24)}d`;
+}
+/** Local wall-clock HH:MM, for "unreachable since 14:02". */
+function hhmm(ts) {
+	const d = new Date(ts);
+	return `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`;
+}
+/**
+* The per-remote tag printed beside its section: where the rows came from and
+* how old they are. `refreshing` says a background refresh was just kicked.
+*/
+function cacheAgeLabel(snap, now, refreshing) {
+	const base = snap && snap.fetchedAt !== null ? `cached ${humanizeAge(now - snap.fetchedAt)} ago` : "no cache yet";
+	if (snap?.error) return `${base}, unreachable since ${hhmm(snap.error.since)}`;
+	return refreshing ? `${base}, refreshing…` : base;
+}
+/**
+* `--waitFor=all|local|<alias>[,<alias>…]`. Unknown aliases are an error
+* rather than silently waited-for-nothing: the flag exists so a caller can
+* trust the rows it gets, and a typo must not become a false "fresh".
+*/
+function parseWaitFor(value, aliases) {
+	const v = value.trim();
+	if (!v) return { error: "--waitFor needs a value: all, local, or an alias list" };
+	if (v === "all") return {
+		local: true,
+		remotes: [...aliases]
+	};
+	if (v === "local") return {
+		local: true,
+		remotes: []
+	};
+	const want = v.split(",").map((s) => s.trim()).filter(Boolean);
+	const unknown = want.filter((a) => !aliases.includes(a));
+	if (unknown.length) return { error: `--waitFor: unknown remote ${unknown.join(", ")} (configured: ${aliases.join(", ") || "none"})` };
+	return {
+		local: false,
+		remotes: [...new Set(want)]
+	};
+}
+/** The `--json` shape for one remote: additive, so a parser can decide on staleness. */
+function jsonRemote(snap, now) {
+	return {
+		fetchedAt: snap?.fetchedAt ?? null,
+		stale: isStale(snap, now),
+		ageMs: snap && snap.fetchedAt !== null ? now - snap.fetchedAt : null,
+		error: snap?.error ?? null,
+		records: snap?.records ?? []
+	};
+}
+
 //#endregion
 //#region ts/remoteHealth.ts
 /**
@@ -1737,6 +1868,7 @@ function mergeRecords(...buckets) {
 }
 const SUBCOMMANDS = new Set([
 	"ls",
+	"ls-refresh",
 	"list",
 	"ps",
 	"status",
@@ -2011,7 +2143,7 @@ async function runSubcommand(argv) {
 		switch (sub) {
 			case "ls":
 			case "list": return await cmdLs(rest);
-			case "ps": return await (await import("./cmdPs-C8DIl8V6.js")).cmdPs(rest);
+			case "ps": return await (await import("./cmdPs-B3jTE4f3.js")).cmdPs(rest);
 			case "status": return await cmdStatus(rest);
 			case "whoami": return await cmdWhoami(rest);
 			case "result": return await cmdResult(rest);
@@ -2025,6 +2157,7 @@ async function runSubcommand(argv) {
 			case "history": return await (await import("./hist-DZxq7NMA.js")).cmdHist(rest);
 			case "send": return await cmdSend(rest);
 			case "send-drain": return await cmdSendDrain(rest);
+			case "ls-refresh": return await cmdLsRefresh(rest);
 			case "msgs": return await cmdMsgs(rest);
 			case "key": return await cmdKey(rest);
 			case "select": return await cmdSelect(rest);
@@ -2055,51 +2188,51 @@ async function runSubcommand(argv) {
 			}
 			case "ch":
 			case "channels": {
-				const { cmdCh } = await import("./channels-aYwLMbFV.js");
+				const { cmdCh } = await import("./channels-rhxQArqN.js");
 				return cmdCh(rest);
 			}
 			case "term": {
-				const { cmdTerm } = await import("./terminal-DviH1E3C.js");
+				const { cmdTerm } = await import("./terminal-DEXrWOa9.js");
 				return cmdTerm(rest);
 			}
 			case "widget": {
-				const { cmdWidget } = await import("./widget-DgBDIGRQ.js");
+				const { cmdWidget } = await import("./widget-DneXqnL8.js");
 				return cmdWidget(rest);
 			}
 			case "mint": {
-				const { cmdMint } = await import("./widget-DgBDIGRQ.js");
+				const { cmdMint } = await import("./widget-DneXqnL8.js");
 				return cmdMint(rest);
 			}
 			case "serve": {
-				const { cmdServe } = await import("./serve-DVoYVgBo.js");
+				const { cmdServe } = await import("./serve-F5tXYO0-.js");
 				return cmdServe(rest);
 			}
 			case "tray": {
-				const { cmdTray } = await import("./trayApp-BDIb8fOj.js");
+				const { cmdTray } = await import("./trayApp-0RVjo43f.js");
 				return cmdTray(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup--1zRHaGW.js");
+				const { cmdSetup } = await import("./setup-mCb1JbTX.js");
 				return cmdSetup(rest);
 			}
 			case "ws": {
-				const { cmdWs } = await import("./ws-DnBg8-g-.js");
+				const { cmdWs } = await import("./ws-DPw1lVTi.js");
 				return cmdWs(rest);
 			}
 			case "schedule": {
-				const { cmdSchedule } = await import("./schedule-DryC--yx.js");
+				const { cmdSchedule } = await import("./schedule-DmijwnTA.js");
 				return cmdSchedule(rest);
 			}
 			case "remote": {
-				const { cmdRemote } = await import("./remotes-DnMQWaqQ.js");
+				const { cmdRemote } = await import("./remotes-CQTEY8Gt.js");
 				return cmdRemote(rest);
 			}
 			case "share": {
-				const { cmdShare } = await import("./shareCmd-BI3hRWGO.js");
+				const { cmdShare } = await import("./shareCmd-aOKimJeT.js");
 				return cmdShare(rest);
 			}
 			case "connect": {
-				const { cmdConnect } = await import("./remotes-DnMQWaqQ.js");
+				const { cmdConnect } = await import("./remotes-CQTEY8Gt.js");
 				return cmdConnect(rest);
 			}
 			case "expose": {
@@ -2107,7 +2240,7 @@ async function runSubcommand(argv) {
 				return cmdExpose(rest);
 			}
 			case "callback": {
-				const { cmdCallback } = await import("./callback-B8CUyag4.js");
+				const { cmdCallback } = await import("./callback-yWhCmi4k.js");
 				return cmdCallback(rest);
 			}
 			case "reap":
@@ -2118,7 +2251,7 @@ async function runSubcommand(argv) {
 				return await cmdDsh(rest);
 			}
 			case "gc": {
-				const { gcOldBinaryDirs } = await import("./rustBinary-BNmAJEBb.js");
+				const { gcOldBinaryDirs } = await import("./rustBinary-FhGG3Yfl.js");
 				const { gcLogs } = await import("./globalPidIndex-DC93JhHQ.js");
 				const bins = gcOldBinaryDirs();
 				const logs = await gcLogs();
@@ -2181,7 +2314,7 @@ async function cmdHelp(managerCommands = true) {
 	const shareAliasNote = managerCommands ? `` : `                                      (\`ay\` only — \`cy share\`/\`cy connect\` are prompts)\n`;
 	const self = process.env.AGENT_YES_PID ? await resolveSender() : null;
 	const agentSection = self ? await buildAgentContextSection(self) : "";
-	process.stdout.write(agentSection + "ay - agent-yes CLI\n\nManagement:\n  ay ls [keyword]                     list running agents\n  ay ps [keyword]                     per-agent CPU/RSS, rolled up over each\n                                        agent's whole process tree, + box vitals\n  ay tail [-f] [-n N] <keyword>       last N lines (96), -f to follow\n  ay tail <keyword> --until TEXT      block until TEXT is printed, then exit 0\n      [--timeout 10m] [-q] [--regex]    (1 = agent exited without it, 2 = no match,\n      [--fail-on TEXT] [--count N]       3 = --fail-on hit first)\n  ay read <keyword> [page opts]       paginate: --last/--head N, --range A:B,\n                                        --before-line L [--limit N]\n" + readAliasNote + "  ay cat <keyword>                    full log\n  ay head <keyword>                   first N lines\n  ay hist [-n 6] [--all] [--json]     past agent conversations (claude/codex\n                                        transcripts, incl. exited sessions);\n                                        this cwd unless --all\n  ay send <keyword> <msg>             send a message (keyword '.' = agent in this cwd)\n  ay msgs [keyword] [--in|--out]      inter-agent message log (sent + received)\n  ay ch mk|join|send|read|tail <topic>  local-first E2E channels: AI ↔ humans on a topic (ay ch help)\n  ay term embed <pid>                 <script> to embed a live read-only agent terminal in a page (ay term help)\n  ay widget ls | read selection|dom   read an opted-in page widget's context (selection/DOM) (ay widget help)\n  ay mint <target> --caps ...         mint a scoped, short-TTL capability token (embeddable in a page)\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 notify watch --unread            get notified when sub-agents finish/stuck/crash (writes to inbox)\n  ay whoami [--json]                  (inside an agent) your own registry identity + reply address\n  ay result <keyword> [--wait]        pull an agent's structured result envelope\n  ay result set '<json>'              (inside an agent) deposit your result envelope\n  ay reap                             kill process groups leaked by dead agents\n  ay gc                               reclaim old-version binary cache dirs + stale session logs\n  ay dsh-legacy [args...]              launch the DeepSeek Harness terminal client (dsh-tui)\n" + wsLines + "\nRemote:\n" + setupLine + "  ay share [local|lan|tailscale|webrtc]  share this machine: one URL for web console + CLI\n  ay connect <share-url> [alias]      save another machine's share URL as a remote\n" + shareAliasNote + "  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 expose <port>                    share localhost:<port> at https://<id>.agent-yes.com (private link)\n  ay callback --expires 7d           mint an embeddable message-me widget for one agent\n  ay ls   <token>@<host>:<port>       connect inline (no alias needed)\n  ay send <token>@<host>:<port>:<kw> <msg>\n\nRun an agent (naming a CLI is what launches one — bare 'ay' shows this help):\n  ay <claude|codex|...> [options] -- [prompt]\n  ay claude -- \"fix the bug in auth.ts\"\n  cy [options] -- [prompt]            shortcut for 'ay claude' (bare 'cy' starts claude)\n  ay claude --help                    full agent-runner options\n\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(agentSection + "ay - agent-yes CLI\n\nManagement:\n  ay ls [keyword]                     list running agents (remotes from cache, refreshed\n      [--waitFor=all|local|<alias>]     in the background; --waitFor blocks for fresh rows)\n  ay ps [keyword]                     per-agent CPU/RSS, rolled up over each\n                                        agent's whole process tree, + box vitals\n  ay tail [-f] [-n N] <keyword>       last N lines (96), -f to follow\n  ay tail <keyword> --until TEXT      block until TEXT is printed, then exit 0\n      [--timeout 10m] [-q] [--regex]    (1 = agent exited without it, 2 = no match,\n      [--fail-on TEXT] [--count N]       3 = --fail-on hit first)\n  ay read <keyword> [page opts]       paginate: --last/--head N, --range A:B,\n                                        --before-line L [--limit N]\n" + readAliasNote + "  ay cat <keyword>                    full log\n  ay head <keyword>                   first N lines\n  ay hist [-n 6] [--all] [--json]     past agent conversations (claude/codex\n                                        transcripts, incl. exited sessions);\n                                        this cwd unless --all\n  ay send <keyword> <msg>             send a message (keyword '.' = agent in this cwd)\n  ay msgs [keyword] [--in|--out]      inter-agent message log (sent + received)\n  ay ch mk|join|send|read|tail <topic>  local-first E2E channels: AI ↔ humans on a topic (ay ch help)\n  ay term embed <pid>                 <script> to embed a live read-only agent terminal in a page (ay term help)\n  ay widget ls | read selection|dom   read an opted-in page widget's context (selection/DOM) (ay widget help)\n  ay mint <target> --caps ...         mint a scoped, short-TTL capability token (embeddable in a page)\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 notify watch --unread            get notified when sub-agents finish/stuck/crash (writes to inbox)\n  ay whoami [--json]                  (inside an agent) your own registry identity + reply address\n  ay result <keyword> [--wait]        pull an agent's structured result envelope\n  ay result set '<json>'              (inside an agent) deposit your result envelope\n  ay reap                             kill process groups leaked by dead agents\n  ay gc                               reclaim old-version binary cache dirs + stale session logs\n  ay dsh-legacy [args...]              launch the DeepSeek Harness terminal client (dsh-tui)\n" + wsLines + "\nRemote:\n" + setupLine + "  ay share [local|lan|tailscale|webrtc]  share this machine: one URL for web console + CLI\n  ay connect <share-url> [alias]      save another machine's share URL as a remote\n" + shareAliasNote + "  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 expose <port>                    share localhost:<port> at https://<id>.agent-yes.com (private link)\n  ay callback --expires 7d           mint an embeddable message-me widget for one agent\n  ay ls   <token>@<host>:<port>       connect inline (no alias needed)\n  ay send <token>@<host>:<port>:<kw> <msg>\n\nRun an agent (naming a CLI is what launches one — bare 'ay' shows this help):\n  ay <claude|codex|...> [options] -- [prompt]\n  ay claude -- \"fix the bug in auth.ts\"\n  cy [options] -- [prompt]            shortcut for 'ay claude' (bare 'cy' starts claude)\n  ay claude --help                    full agent-runner options\n\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;
 }
 /** Looks like an agent_id (12 hex, or a longer injected one) rather than a word. */
@@ -2380,6 +2513,13 @@ async function runRemoteLs(remote, opts) {
 		return 1;
 	}
 	const records = await res.json();
+	if (!remote.keyword && (await readRemotes()).has(remote.label)) {
+		const now = Date.now();
+		await writeRemoteSnapshot(noteSnapshotResult(await readRemoteSnapshot(remote.label), remote.label, {
+			ok: true,
+			records
+		}, now)).catch(() => {});
+	}
 	if (records.length === 0) {
 		process.stderr.write(remote.keyword ? `no agents matched "${remote.keyword}" on ${remote.label}\n` : `no running agents on ${remote.label}\n`);
 		return 0;
@@ -2717,7 +2857,7 @@ async function fetchRemoteRecordsRaw(url, token, opts, onReachable) {
 		let base = url;
 		let bearer = token;
 		if (isWebrtcSpec(url)) {
-			const { startWebrtcBridge } = await import("./webrtcRemote-Cd4vTrgv.js");
+			const { startWebrtcBridge } = await import("./webrtcRemote-Cy5kB8aR.js");
 			bridge = await startWebrtcBridge(url);
 			base = bridge.baseUrl;
 			bearer = bridge.token;
@@ -2729,13 +2869,93 @@ async function fetchRemoteRecordsRaw(url, token, opts, onReachable) {
 		onReachable?.(true);
 		if (!res.ok) return [];
 		return await res.json();
-	} catch {
-		onReachable?.(false);
+	} catch (e) {
+		onReachable?.(false, String(e?.message ?? e).split("\n")[0]);
 		return [];
 	} finally {
 		bridge?.close();
 	}
 }
+/** Probe one remote and fold the outcome into its snapshot. Never throws. */
+async function refreshRemoteSnapshot(alias, cfg, opts, now) {
+	let ok = false;
+	let why = "did not answer";
+	const records = await fetchRemoteRecordsRaw(cfg.url, cfg.token, opts, (r, w) => {
+		ok = r;
+		if (w) why = w;
+	});
+	const snap = noteSnapshotResult(await readRemoteSnapshot(alias), alias, ok ? {
+		ok: true,
+		records
+	} : {
+		ok: false,
+		message: why
+	}, now);
+	await writeRemoteSnapshot(snap).catch(() => {});
+	return {
+		snap,
+		ok
+	};
+}
+/** Run `ay <args…>` detached from this process (same launcher as the send drainer). */
+function spawnDetachedAy(args) {
+	const launcher = drainerLauncher(process.execPath, process.argv[1], Bun.which("ay"));
+	if (!launcher) return null;
+	const [cmd, ...pre] = launcher;
+	try {
+		const child = spawn$1(cmd, [...pre, ...args], {
+			detached: true,
+			stdio: "ignore"
+		});
+		child.on("error", () => {});
+		child.unref();
+		return child.pid ?? null;
+	} catch {
+		return null;
+	}
+}
+/**
+* `ay ls-refresh <alias…> [--all] [--active] [--keyword k]` — hidden: the
+* background half of cached-first `ay ls`. Probes each alias once, writes its
+* snapshot and health, and exits. One refresher per alias at a time (pid
+* lock), so a burst of listings does not fan out into a burst of probes.
+*/
+async function cmdLsRefresh(rest) {
+	const aliases = [];
+	const opts = {
+		all: false,
+		active: false,
+		keyword: void 0
+	};
+	for (let i = 0; i < rest.length; i++) {
+		const a = rest[i];
+		if (a === "--all") opts.all = true;
+		else if (a === "--active") opts.active = true;
+		else if (a === "--keyword") opts.keyword = rest[++i];
+		else if (a.startsWith("--keyword=")) opts.keyword = a.slice(10);
+		else if (!a.startsWith("-")) aliases.push(a);
+	}
+	const remotes = await readRemotes();
+	const now = Date.now();
+	await Promise.all(aliases.map(async (alias) => {
+		const cfg = remotes.get(alias);
+		if (!cfg) return;
+		const lock = path.join(agentYesHome(), "remotes", `${encodeURIComponent(alias)}.refresh.lock`);
+		const owner = Number((await readFile(lock, "utf-8").catch(() => "")).trim());
+		if (owner > 0 && owner !== process.pid && pidAlive(owner)) return;
+		await mkdir(path.dirname(lock), { recursive: true }).catch(() => {});
+		await writeFile(lock, String(process.pid)).catch(() => {});
+		try {
+			const { ok } = await refreshRemoteSnapshot(alias, cfg, opts, now);
+			const health = await readRemoteHealth();
+			health[alias] = noteRemoteResult(health[alias], ok, now);
+			await writeRemoteHealth(health).catch(() => {});
+		} finally {
+			await rm(lock, { force: true }).catch(() => {});
+		}
+	}));
+	return 0;
+}
 async function runAllRemotesLs(opts) {
 	const remotes = await readRemotes();
 	const localOpts = {
@@ -2747,30 +2967,72 @@ async function runAllRemotesLs(opts) {
 	};
 	const health = await readRemoteHealth();
 	const healthNow = Date.now();
-	const skipped = new Set([...remotes.keys()].filter((alias) => shouldSkipRemote(health[alias], healthNow)));
-	const probed = [...remotes.entries()].filter(([alias]) => !skipped.has(alias));
-	const [localResult, ...remoteResults] = await Promise.allSettled([listRecords(opts.keyword, localOpts).then((recs) => ({
+	const waiting = new Set(opts.waitFor?.remotes ?? []);
+	const fetchOpts = {
+		all: opts.all,
+		active: opts.active,
+		keyword: opts.keyword
+	};
+	const [localResult, ...waited] = await Promise.allSettled([listRecords(opts.keyword, localOpts).then((recs) => ({
 		host: "local",
 		records: recs
-	})), ...probed.map(([alias, cfg]) => {
-		let reachable = false;
-		return fetchRemoteRecordsRaw(cfg.url, cfg.token, opts, (ok) => {
-			reachable = ok;
-		}).then((records) => ({
-			host: alias,
-			records,
-			ok: reachable
-		}));
+	})), ...[...remotes.entries()].filter(([alias]) => waiting.has(alias)).map(async ([alias, cfg]) => {
+		const budget = new Promise((resolve) => {
+			setTimeout(() => resolve("timeout"), opts.timeoutMs).unref?.();
+		});
+		const res = await Promise.race([refreshRemoteSnapshot(alias, cfg, fetchOpts, healthNow), budget]);
+		if (res === "timeout") return {
+			alias,
+			snap: await readRemoteSnapshot(alias),
+			ok: false,
+			failure: `timed out after ${Math.round(opts.timeoutMs / 1e3)}s`
+		};
+		const failure = res.ok ? null : res.snap.error ? `unreachable since ${hhmm(res.snap.error.since)} (${res.snap.error.message})` : "unreachable";
+		return {
+			alias,
+			snap: res.snap,
+			ok: res.ok,
+			failure
+		};
 	})]);
-	{
-		const next = pruneRemoteHealth({ ...health }, remotes.keys());
-		for (const [i, [alias]] of probed.entries()) {
-			const res = remoteResults[i];
-			const ok = res?.status === "fulfilled" && res.value.ok === true;
-			next[alias] = noteRemoteResult(health[alias], ok, healthNow);
+	const nextHealth = pruneRemoteHealth({ ...health }, remotes.keys());
+	const waitedByAlias = /* @__PURE__ */ new Map();
+	for (const r of waited) if (r.status === "fulfilled") waitedByAlias.set(r.value.alias, r.value);
+	const sections = [];
+	const background = [];
+	for (const [alias] of remotes) {
+		const w = waitedByAlias.get(alias);
+		if (w) {
+			nextHealth[alias] = noteRemoteResult(health[alias], w.ok, healthNow);
+			sections.push({
+				alias,
+				snap: w.snap,
+				live: w.ok,
+				refreshing: false,
+				failure: w.failure
+			});
+			continue;
 		}
-		await writeRemoteHealth(next).catch(() => {});
+		const snap = await readRemoteSnapshot(alias);
+		const refreshing = isStale(snap, healthNow) && !shouldSkipRemote(health[alias], healthNow);
+		if (refreshing) background.push(alias);
+		sections.push({
+			alias,
+			snap,
+			live: false,
+			refreshing,
+			failure: null
+		});
 	}
+	await writeRemoteHealth(nextHealth).catch(() => {});
+	if (background.length) spawnDetachedAy([
+		"ls-refresh",
+		...background,
+		...opts.all ? ["--all"] : [],
+		...opts.active ? ["--active"] : [],
+		...opts.keyword ? ["--keyword", opts.keyword] : []
+	]);
+	const failed = sections.some((s) => waiting.has(s.alias) && s.failure);
 	const byHost = [];
 	const gitRootCache = /* @__PURE__ */ new Map();
 	const gitInfoCache = /* @__PURE__ */ new Map();
@@ -2803,25 +3065,45 @@ async function runAllRemotesLs(opts) {
 			records: enriched
 		});
 	}
-	for (const alias of skipped) {
-		const h = health[alias];
-		const leftMs = Math.max(0, remoteBackoffMs(h?.streak ?? 1) - (healthNow - (h?.lastFailedAt ?? healthNow)));
-		const left = leftMs >= 6e4 ? `${Math.round(leftMs / 6e4)}m` : `${Math.ceil(leftMs / 1e3)}s`;
-		process.stderr.write(`${alias}: unreachable — skipped after ${h?.streak ?? 0} failed attempt(s), retrying in ${left} (ay ls ${alias} to force a probe now)\n`);
-	}
-	for (const res of remoteResults) if (res.status === "fulfilled") byHost.push({
-		host: res.value.host,
-		records: res.value.records
+	for (const s of sections) byHost.push({
+		host: s.alias,
+		records: s.snap?.records ?? [],
+		cached: !s.live
 	});
+	if (opts.json) {
+		const out = {
+			local: byHost.find((h) => h.host === "local")?.records ?? [],
+			remotes: Object.fromEntries(sections.map((s) => [s.alias, {
+				...jsonRemote(s.snap, healthNow),
+				live: s.live,
+				refreshing: s.refreshing,
+				failure: s.failure
+			}]))
+		};
+		await writeStdoutFlushed(JSON.stringify(out, null, 2) + "\n");
+		return failed ? 1 : 0;
+	}
+	if (sections.length) {
+		const aliasW = Math.max(...sections.map((s) => s.alias.length));
+		for (const s of sections) process.stdout.write(`${s.alias.padEnd(aliasW)}  ${s.failure ?? (s.live ? "live" : cacheAgeLabel(s.snap, healthNow, s.refreshing))}\n`);
+		process.stdout.write("\n");
+	}
 	const rows = [];
-	for (const { host, records } of byHost) for (const { record, prefix } of flattenForest(buildAgentForest(records))) rows.push({
+	for (const { host, records, cached } of byHost) for (const { record, prefix } of flattenForest(buildAgentForest(records))) rows.push({
 		host,
 		rec: record,
-		prefix
+		prefix,
+		cached: cached === true
 	});
+	const anyCached = sections.some((s) => !s.live);
+	const footer = () => {
+		if (rows.some((r) => r.cached)) process.stderr.write(`* = from cache (AGE is real; STATUS may have changed since)\n`);
+		if (anyCached) process.stderr.write(`ay ls --waitFor=all   # block until fresh data from every local+remote machine\n`);
+	};
 	if (rows.length === 0) {
 		process.stderr.write("no running agents\n");
-		return 0;
+		footer();
+		return failed ? 1 : 0;
 	}
 	const termWidth = process.stdout.columns ?? 120;
 	const now = Date.now();
@@ -2830,7 +3112,8 @@ async function runAllRemotesLs(opts) {
 	const hostW = Math.max(4, ...rows.map((r) => r.host.length));
 	const pidW = Math.max(3, ...rows.map((r) => String(r.rec.pid).length));
 	const cliW = Math.max(3, ...rows.map((r) => String(r.rec.cli).length));
-	const statusW = Math.max(6, ...rows.map((r) => String(r.rec.status).length));
+	const statusOf = (r) => String(r.rec.status) + (r.cached ? "*" : "");
+	const statusW = Math.max(6, ...rows.map((r) => statusOf(r).length));
 	const ageW = Math.max(3, ...rows.map((r) => ageOf(r.rec).length));
 	const cwdW = Math.max(3, ...rows.map((r) => cwdLabel(r.rec).length));
 	const promptBudget = Math.max(20, termWidth - hostW - pidW - cliW - statusW - ageW - cwdW - 12 - 1);
@@ -2843,7 +3126,8 @@ async function runAllRemotesLs(opts) {
 		"CWD".padEnd(cwdW),
 		"PROMPT"
 	].join("  ") + "\n");
-	for (const { host, rec, prefix } of rows) {
+	for (const row of rows) {
+		const { host, rec, prefix } = row;
 		const flagStr = badgeLabels(rec.badges);
 		const branchStr = branchLabel(rec.git);
 		const gitStr = gitLabel(rec.git);
@@ -2854,13 +3138,14 @@ async function runAllRemotesLs(opts) {
 			host.padEnd(hostW),
 			String(rec.pid).padEnd(pidW),
 			String(rec.cli).padEnd(cliW),
-			String(rec.status).padEnd(statusW),
+			statusOf(row).padEnd(statusW),
 			ageOf(rec).padEnd(ageW),
 			cwdLabel(rec).padEnd(cwdW),
 			label
 		].join("  ") + "\n");
 	}
-	return 0;
+	footer();
+	return failed ? 1 : 0;
 }
 /**
 * Cheap live status from liveness + log quiescence only (no log-content read):
@@ -3196,12 +3481,19 @@ async function cmdLs(rest) {
 		type: "boolean",
 		default: false,
 		description: "Only this machine's agents — skip configured remotes (the pre-default behaviour)"
+	}).option("waitFor", {
+		type: "string",
+		description: "Block until fresh rows from this set instead of printing cached remote rows: all | local | <alias>[,<alias>…]. Each remote gets --timeout; a failure is reported per remote"
+	}).option("timeout", {
+		type: "number",
+		default: 30,
+		description: "Seconds to wait per remote with --waitFor"
 	}).option("help", {
 		alias: "h",
 		type: "boolean",
 		default: false,
 		description: "Show this help"
-	}).example("ay ls", "list local + all configured remotes").example("ay ls --local", "only this machine's agents").example("ay ls --all", "include exited agents").example("ay ls --json", "machine-readable output").example("ay ls --watch", "stream state transitions for a whole fan-out as NDJSON").example("ay ls myrepo", "filter by cwd/prompt keyword").help(false).version(false).exitProcess(false);
+	}).example("ay ls", "local live + remotes from their last snapshot (refreshed in the background)").example("ay ls --waitFor=all", "block until every machine answered (or timed out)").example("ay ls --json --all-remotes", "{local, remotes:{alias:{fetchedAt, stale, records…}}}").example("ay ls --local", "only this machine's agents").example("ay ls --all", "include exited agents").example("ay ls --json", "machine-readable output").example("ay ls --watch", "stream state transitions for a whole fan-out as NDJSON").example("ay ls myrepo", "filter by cwd/prompt keyword").help(false).version(false).exitProcess(false);
 	const argv = await y.parseAsync();
 	if (argv.help || argv.h) {
 		process.stdout.write(await y.getHelp() + "\n");
@@ -3254,12 +3546,24 @@ async function cmdLs(rest) {
 		});
 		return 0;
 	}
-	if (!argv.local && !opts.json && !argv.latest) {
-		const remotes = await readRemotes();
-		if (argv["all-remotes"] || remotes.size > 0) return runAllRemotesLs({
+	const remotesCfg = await readRemotes();
+	let waitFor = null;
+	if (typeof argv.waitFor === "string") {
+		const parsed = parseWaitFor(argv.waitFor, [...remotesCfg.keys()]);
+		if ("error" in parsed) {
+			process.stderr.write(parsed.error + "\n");
+			return 2;
+		}
+		waitFor = parsed;
+	}
+	if (!argv.local && !argv.latest && (!opts.json || argv["all-remotes"] || waitFor)) {
+		if (argv["all-remotes"] || waitFor || remotesCfg.size > 0) return runAllRemotesLs({
 			all: argv.all,
 			active: argv.active,
-			keyword
+			keyword,
+			waitFor,
+			timeoutMs: Math.max(1, Number(argv.timeout) || 30) * 1e3,
+			json: opts.json
 		});
 	}
 	const records = await listRecords(keyword, opts);
@@ -3371,16 +3675,6 @@ async function cmdLs(rest) {
 	}
 	return 0;
 }
-function humanizeAge(ms) {
-	if (ms < 1e3) return "0s";
-	const s = Math.floor(ms / 1e3);
-	if (s < 60) return `${s}s`;
-	const m = Math.floor(s / 60);
-	if (m < 60) return `${m}m`;
-	const h = Math.floor(m / 60);
-	if (h < 24) return `${h}h`;
-	return `${Math.floor(h / 24)}d`;
-}
 function shortenPath(p) {
 	const home = homedir();
 	return p.startsWith(home) ? "~" + p.slice(home.length) : p;
@@ -4625,11 +4919,24 @@ function inspectSubmission(screen, identity) {
 		composerVisible: false,
 		inComposer: false
 	};
-	const prompt = composerPromptRow(screen);
-	if (prompt < 0 || !identity.trim()) return unknown;
+	if (!identity.trim()) return unknown;
 	const compact = (text) => text.replace(/\s+/gu, "");
 	const needle = compact(identity);
 	const wrapped = identity.startsWith("<ay-msg ");
+	const prompt = composerPromptRow(screen);
+	if (prompt < 0) {
+		if (wrapped) return unknown;
+		let last = screen.length - 1;
+		while (last >= 0 && !screen[last].trim()) last--;
+		const echoed = screen.slice(0, Math.max(0, last)).filter((line) => compact(line).endsWith(needle)).length;
+		return echoed ? {
+			submission: "submitted",
+			retry: false,
+			transcriptMatches: echoed,
+			composerVisible: false,
+			inComposer: false
+		} : unknown;
+	}
 	const transcriptLines = screen.slice(0, prompt);
 	const transcript = compact(transcriptLines.join("\n"));
 	let transcriptMatches = wrapped ? transcript.split(needle).length - 1 : 0;
@@ -5698,7 +6005,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-DVoYVgBo.js");
+	const { resolveDaemonHttpBase, loadTokenReadOnly } = await import("./serve-F5tXYO0-.js");
 	const daemonBase = await resolveDaemonHttpBase().catch(() => null);
 	const daemonToken = daemonBase ? await loadTokenReadOnly().catch(() => null) ?? "" : "";
 	const capViewer = `attach:${process.pid}`;
@@ -5744,12 +6051,32 @@ async function cmdAttach(rest) {
 		await writeWinsizeDirect(cols, rows);
 	};
 	for (let i = 0; i < 15 && (!process.stdout.columns || !process.stdout.rows); i++) await new Promise((r) => setTimeout(r, 100));
+	if (process.platform === "win32" && !capMode) {
+		const cols = process.stdout.columns ?? 0;
+		const rows = process.stdout.rows ?? 0;
+		if (cols > 0 && rows > 1) {
+			await writeWinsizeDirect(cols, rows - 1);
+			await new Promise((r) => setTimeout(r, 400));
+		}
+	}
 	await sendResize();
 	const capHeartbeat = capMode ? setInterval(() => {
 		if (capMode) sendResize();
 	}, 5e3) : null;
+	const directHeartbeat = !capMode ? setInterval(() => {
+		const cols = process.stdout.columns ?? 0;
+		const rows = process.stdout.rows ?? 0;
+		if (cols > 0 && rows > 0) writeFile(winsizePath, `${cols} ${rows} ${Date.now()}\n`).catch(() => {});
+	}, 1e4) : null;
 	const withdrawAttachCap = async () => {
 		if (capHeartbeat) clearInterval(capHeartbeat);
+		if (directHeartbeat) clearInterval(directHeartbeat);
+		if (!capMode) {
+			await rm(winsizePath, { force: true }).catch(() => {});
+			try {
+				process.kill(record.pid, "SIGWINCH");
+			} catch {}
+		}
 		if (!daemonBase) return;
 		try {
 			await fetch(`${daemonBase}/api/presence?token=${encodeURIComponent(daemonToken)}`, {
@@ -6427,7 +6754,7 @@ async function cmdNotify(rest) {
 	}
 	const ensure = async () => {
 		if (!argv["ensure-daemon"]) return;
-		const { ensureDaemon } = await import("./notifyDaemon-DWIfzEE7.js");
+		const { ensureDaemon } = await import("./notifyDaemon-BIo7Nkk2.js");
 		await ensureDaemon().catch(() => null);
 	};
 	await heartbeatWatcher(parent, selfStartedAt);
@@ -6501,7 +6828,7 @@ async function cmdNotifyCursor(args) {
 }
 async function cmdNotifyd(rest) {
 	const sub = rest[0] ?? "status";
-	const daemon = await import("./notifyDaemon-DWIfzEE7.js");
+	const daemon = await import("./notifyDaemon-BIo7Nkk2.js");
 	switch (sub) {
 		case "run": return daemon.runDaemon();
 		case "once": return daemon.runDaemon({ once: true });
@@ -6528,4 +6855,4 @@ async function cmdNotifyd(rest) {
 
 //#endregion
 export { renderLogTailLines as $, isAgentStuck as A, lastStdinAt as B, extractBadges as C, finalizedLines as D, extractTaskCounts as E, isSubcommand as F, probeStdinReachable as G, matchKeyword as H, isUnknownManagerToken as I, readLogForRender as J, readAgentPtysize as K, isUnreachableWriteErrno as L, isExitRequest as M, isPidAlive as N, inspectSubmission as O, isSlashCommand as P, recentReadEdges as Q, isUserTyping as R, envelopeCostFor as S, extractNeedsInput as T, menuSelectKeys as U, listRecords as V, ownedCollapsedPaste as W, readPtysize as X, readNotes as Y, recentMessageEdges as Z, cwdLabel as _, shouldFramePaste as _t, READ_WINDOW_MS as a, restartHintLines as at, drainerLauncher as b, flattenForest as bt, SEND_EXIT_UNREACHABLE as c, snapshotStatus as ct, buildEnvelope as d, submitAndConfirm as dt, renderRawLog as et, cliDefaults as f, waitForLogQuiet as ft, cursorAbs as g, framePaste as gt, controlCodeFromName as h, withIpcLock as ht, READ_PAGE_DEFAULT as i, resolveResumeArgs as it, isBareManagerInvocation as j, isAgentIdShaped as k, TYPING_WINDOW_MS as l, stdinActivityPath as lt, confirmStdinUnreachable as m, writeToIpc as mt, GRACEFUL_EXIT_COMMANDS as n, resolveOne as nt, SEND_BODY_MAX_CHARS as o, runSubcommand as ot, cmdHelp as p, writeKeysPaced as pt, readComposerState as q, MAX_RENDER_BYTES as r, resolveReadWindow as rt, SEND_EXIT_QUEUED as s, sendPayloadCapError as st, COMPOSER_WINDOWS as t, renderRawLogLines as tt, backoffWhileTyping as u, stopTipForCli as ut, deriveLiveState as v, TYPING_BADGE as vt, extractMenu as w, envelopeAttribution as x, deriveLiveStatus as y, buildAgentForest as yt, lastReadAt as z };
-//# sourceMappingURL=subcommands-UWLkF5pq.js.map
+//# sourceMappingURL=subcommands-Ddo2TYZs.js.map