agent-yes 1.263.0 → 1.264.0

package/dist/{subcommands-Bo1MSwuC.js → subcommands-C3w4bg6x.js}

@@ -1,7 +1,7 @@
 import { t as invokedCliName } from "./invokedCli-uqM2YYA7.js";
 import { n as logger } from "./logger-CDIsZ-Pp.js";
 import { t as agentYesHome } from "./agentYesHome-CtmsY6I-.js";
-import { a as sanitizeRole, i as readGlobalPids, o as updateGlobalPidStatus } from "./globalPidIndex-pwp7Vb7o.js";
+import { a as updateGlobalPidStatus, i as readGlobalPids } from "./globalPidIndex-Dq4KY2IV.js";
 import { a as recordOutbox, i as recordMessage, n as readMailbox, t as partyMatches } from "./messageLog-BYFwioFY.js";
 import { t as loadSharedCliDefaults } from "./configShared-DtHMBCl7.js";
 import { n as isWebrtcSpec } from "./webrtcLink-CS4D-3G1.js";
@@ -13,10 +13,110 @@ import { appendFile, mkdir, open, readFile, readdir, rename, rm, stat, writeFile
 import { homedir } from "os";
 import path from "path";
 import { randomUUID } from "node:crypto";
-import os$1 from "node:os";
+import { readFileSync } from "node:fs";
+import path$1 from "node:path";
+import os$1, { homedir as homedir$1, hostname as hostname$1, userInfo as userInfo$1 } from "node:os";
 import { fileURLToPath } from "node:url";
 import { randomBytes as randomBytes$1 } from "crypto";
 
+//#region ts/identity.ts
+/**
+* The standardized agent identity string:
+*
+*   <username>@<hostname>:<path>:<branch>#<pid>
+*   e.g.  sno@Mac:~/ws/symval/symval/tree/crm:main#30402
+*
+* One line answers "who is this agent" across every surface that names one —
+* the `ay send` envelope header, `ay whoami`, logs. The branch segment usually
+* carries the lane name for free (worktree checkouts like `crm-yamamoto-wifi`
+* or `fix/t173-tone-core` name their purpose), which is why there is no
+* separate role concept.
+*
+* Parsing (right-to-left, for consumers that need it): `#<pid>` from the end;
+* the branch is after the last `:` (git forbids `:` in ref names); the
+* username is before the first `@`; the hostname is between that `@` and the
+* next `:` (hostnames contain no `:`). The path in the middle may itself
+* contain `@`/`:` (Windows drives), which is why parsing anchors on the ends.
+*
+* Every token is clamped before rendering: the identity is embedded in the
+* `<ay-msg …>` envelope's OPEN tag, which is not nonce-protected — whitespace
+* or `>` in a token could forge header structure.
+*/
+/** Replace anything outside a conservative charset so a token can never break
+* out of the envelope header line. Collapses runs to a single `-`. */
+function safeToken(raw, max) {
+	return raw.replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, max);
+}
+/** The local username, header-safe ("John Smith" → "John-Smith"). */
+function localUser() {
+	try {
+		return safeToken(userInfo$1().username, 32) || "unknown";
+	} catch {
+		return "unknown";
+	}
+}
+/** The local hostname's first label ("Macs-MBP.local" → "Macs-MBP"). */
+function localHost() {
+	return safeToken(hostname$1().split(".")[0] ?? "", 32) || "unknown";
+}
+/**
+* The checked-out branch of the git repo containing `cwd`, or a short commit
+* id when detached, or null when `cwd` is not inside a git checkout. Pure
+* file reads — never spawns git — so it is cheap enough to run on every send:
+* walk up to the nearest `.git`, follow a worktree's `gitdir:` indirection
+* file, then parse `HEAD`.
+*/
+function readGitBranch(cwd) {
+	let dir = path$1.resolve(cwd);
+	for (let depth = 0; depth < 32; depth++) {
+		const dotGit = path$1.join(dir, ".git");
+		let gitDir = null;
+		try {
+			const content = readFileSync(dotGit, "utf8");
+			const m = /^gitdir:\s*(.+)\s*$/m.exec(content);
+			gitDir = m ? path$1.resolve(dir, m[1].trim()) : null;
+		} catch (err) {
+			if (err?.code === "EISDIR") gitDir = dotGit;
+		}
+		if (gitDir) try {
+			const head = readFileSync(path$1.join(gitDir, "HEAD"), "utf8").trim();
+			const ref = /^ref:\s*refs\/heads\/(.+)$/.exec(head);
+			if (ref) return safeBranch(ref[1]);
+			if (/^[0-9a-f]{40}$/i.test(head)) return head.slice(0, 12);
+			return null;
+		} catch {
+			return null;
+		}
+		const parent = path$1.dirname(dir);
+		if (parent === dir) return null;
+		dir = parent;
+	}
+	return null;
+}
+/** Branch names never contain `:`/space/`~`/`^` (git forbids them), but they
+* DO allow `/` and `#` — keep `/` (readable, unambiguous: parsing anchors on
+* `#<pid>` at the end) and clamp everything else defensively. */
+function safeBranch(raw) {
+	return raw.replace(/[^A-Za-z0-9._/#-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64);
+}
+/** Abbreviate the home directory to `~`, mirroring how `ay ls` prints cwds. */
+function tildify(p) {
+	const home = homedir$1();
+	return p.startsWith(home) ? "~" + p.slice(home.length) : p;
+}
+/**
+* Render the standardized identity for an agent. `user`/`host` default to the
+* local machine (correct for the envelope: the sending wrapper runs on the
+* agent's own host), `branch` auto-detects from `cwd` unless given.
+*/
+function formatIdentity(parts) {
+	const user = parts.user ?? localUser();
+	const host = parts.host ?? localHost();
+	const branch = parts.branch === void 0 ? readGitBranch(parts.cwd) : parts.branch;
+	return `${user}@${host}:${tildify(parts.cwd)}${branch ? `:${branch}` : ""}#${parts.pid}`;
+}
+
+//#endregion
 //#region ts/agentTree.ts
 /**
 * Link records into a forest via parent_pid === wrapper_pid. Records whose
@@ -1213,7 +1313,11 @@ async function cmdWhoami(rest) {
 	const ageMin = Math.max(0, Math.round((Date.now() - self.started_at) / 6e4));
 	const lines = [
 		`agent     ${self.cli} #${self.pid}${self.agent_id ? `  (agent_id ${self.agent_id})` : ""}`,
-		`role      ${self.role ?? "-  (set with: ay role <name>)"}`,
+		`identity  ${formatIdentity({
+			cwd: self.cwd,
+			pid: self.pid
+		})}`,
+		`title     ${self.title ?? "-"}`,
 		`state     ${state}${question ? ` — ${question}` : ""}`,
 		`cwd       ${self.cwd}`,
 		`started   ${new Date(self.started_at).toISOString()}  (${ageMin}m ago)`,
@@ -1221,7 +1325,10 @@ async function cmdWhoami(rest) {
 		`log       ${self.log_file ?? "-"}`,
 		`fifo      ${self.fifo_file ?? "-"}`,
 		`reply     ${reply} "..."`,
-		`envelope  <ay-msg from ${self.cli} #${self.pid}${self.role ? ` (${self.role})` : ""} @ ${self.cwd} — reply: ${reply} "...">…</ay-msg>`
+		`envelope  <ay-msg from ${self.cli} ${formatIdentity({
+			cwd: self.cwd,
+			pid: self.pid
+		})} — reply: ${reply} "...">…</ay-msg>`
 	];
 	process.stdout.write(lines.join("\n") + "\n");
 	return 0;
@@ -1268,7 +1375,7 @@ async function readLocalTsPids(cwd) {
 		exit_code: d.exitCode ?? null,
 		exit_reason: d.exitReason ?? null,
 		started_at: d.startedAt ?? 0,
-		role: d.role ?? null
+		title: d.title ?? null
 	}));
 }
 /** Merge by pid; later entries (typically from the global file) win. */
@@ -1298,7 +1405,6 @@ const SUBCOMMANDS = new Set([
 	"head",
 	"send",
 	"msgs",
-	"role",
 	"key",
 	"select",
 	"spawn",
@@ -1409,7 +1515,6 @@ async function runSubcommand(argv) {
 			case "head": return await cmdRead(rest, { mode: "head" });
 			case "send": return await cmdSend(rest);
 			case "msgs": return await cmdMsgs(rest);
-			case "role": return await cmdRole(rest);
 			case "key": return await cmdKey(rest);
 			case "select": return await cmdSelect(rest);
 			case "spawn": return await cmdSpawn(rest);
@@ -1419,7 +1524,7 @@ async function runSubcommand(argv) {
 			case "restart": return await cmdRestart(rest);
 			case "note": return await cmdNote(rest);
 			case "todo": {
-				const { runTodoSubcommand } = await import("./todoCli-DNOk38lq.js");
+				const { runTodoSubcommand } = await import("./todoCli-CngDeaT2.js");
 				return runTodoSubcommand(rest);
 			}
 			case "ch":
@@ -1428,35 +1533,35 @@ async function runSubcommand(argv) {
 				return cmdCh(rest);
 			}
 			case "term": {
-				const { cmdTerm } = await import("./terminal-BMQWojIp.js");
+				const { cmdTerm } = await import("./terminal-iObUHvkj.js");
 				return cmdTerm(rest);
 			}
 			case "widget": {
-				const { cmdWidget } = await import("./widget-BVss0Z9Y.js");
+				const { cmdWidget } = await import("./widget-BRBsnbLn.js");
 				return cmdWidget(rest);
 			}
 			case "mint": {
-				const { cmdMint } = await import("./widget-BVss0Z9Y.js");
+				const { cmdMint } = await import("./widget-BRBsnbLn.js");
 				return cmdMint(rest);
 			}
 			case "serve": {
-				const { cmdServe } = await import("./serve-BEdLsSpv.js");
+				const { cmdServe } = await import("./serve-Z8FAjest.js");
 				return cmdServe(rest);
 			}
 			case "tray": {
-				const { cmdTray } = await import("./trayApp-DrdktFnW.js");
+				const { cmdTray } = await import("./trayApp-Cb9a-quB.js");
 				return cmdTray(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup-DFRvZ_ku.js");
+				const { cmdSetup } = await import("./setup-D6B85mUe.js");
 				return cmdSetup(rest);
 			}
 			case "ws": {
-				const { cmdWs } = await import("./ws-DMudFezi.js");
+				const { cmdWs } = await import("./ws-BppNz49U.js");
 				return cmdWs(rest);
 			}
 			case "schedule": {
-				const { cmdSchedule } = await import("./schedule-BSEIVKQ0.js");
+				const { cmdSchedule } = await import("./schedule-CdgYYRti.js");
 				return cmdSchedule(rest);
 			}
 			case "remote": {
@@ -1468,7 +1573,7 @@ async function runSubcommand(argv) {
 				return cmdExpose(rest);
 			}
 			case "callback": {
-				const { cmdCallback } = await import("./callback-B0PQUZcK.js");
+				const { cmdCallback } = await import("./callback-C9rkbjgR.js");
 				return cmdCallback(rest);
 			}
 			case "reap":
@@ -1539,7 +1644,7 @@ async function cmdHelp(managerCommands = true) {
 	const wsLines = managerCommands ? "  ay ws ls [--status]                 list <owner>/<repo>/tree/<branch> workspaces\n  ay ws new <owner>/<repo>[@branch]   clone/refresh a workspace (ay ws help for more)\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 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 (keyword '.' = agent in this cwd)\n  ay msgs [keyword] [--in|--out]      inter-agent message log (sent + received)\n  ay role [name] | ay role <kw> <name>  lane/role name shown in the send envelope\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 whoami [--json]                  (inside an agent) your own registry identity + reply address\n  ay result <keyword> [--wait]        pull an agent's structured result envelope\n  ay result set '<json>'              (inside an agent) deposit your result envelope\n  ay reap                             kill process groups leaked by dead agents\n  ay deepseek|ds [-- <codex args>]    run codex via the local DeepSeek adapter (DEEPSEEK_API_KEY)\n" + wsLines + "\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 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:\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(agentSection + "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 (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 whoami [--json]                  (inside an agent) your own registry identity + reply address\n  ay result <keyword> [--wait]        pull an agent's structured result envelope\n  ay result set '<json>'              (inside an agent) deposit your result envelope\n  ay reap                             kill process groups leaked by dead agents\n  ay deepseek|ds [-- <codex args>]    run codex via the local DeepSeek adapter (DEEPSEEK_API_KEY)\n" + wsLines + "\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 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:\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) {
@@ -3359,9 +3464,11 @@ async function cmdSend(rest) {
 	let nonce;
 	if (sender.agent && !isSlashCommand(body) && !raw) {
 		nonce = randomBytes$1(4).toString("hex");
-		const senderRole = sanitizeRole(sender.agent.role);
-		const roleTag = senderRole ? ` (${senderRole})` : "";
-		prefix = `<ay-msg ${nonce} from ${sender.agent.cli} #${sender.agent.pid}${roleTag} @ ${shortenPath(sender.agent.cwd)} — reply: ay send ${replyTarget} "...">\n`;
+		const identity = formatIdentity({
+			cwd: sender.agent.cwd,
+			pid: sender.agent.pid
+		});
+		prefix = `<ay-msg ${nonce} from ${sender.agent.cli} ${identity} — reply: ay send ${replyTarget} "...">\n`;
 		suffix = `\n</ay-msg ${nonce}>`;
 		if (/^\s*<ay-msg\s/.test(body)) process.stderr.write("warning: body already starts with an <ay-msg …> header — ay send adds the envelope automatically, so the recipient will see a DOUBLE wrapper. Send the bare body instead (or pass --raw if you really mean to deliver a pre-built envelope verbatim; forwarding a quoted message inside a plain body is fine).\n");
 	}
@@ -3395,15 +3502,13 @@ async function cmdSend(rest) {
 			pid: sender.agent.pid,
 			cli: sender.agent.cli,
 			cwd: sender.agent.cwd,
-			agent_id: sender.agent.agent_id,
-			role: sender.agent.role ?? void 0
+			agent_id: sender.agent.agent_id
 		} : null,
 		to: {
 			pid: record.pid,
 			cli: record.cli,
 			cwd: record.cwd,
-			agent_id: record.agent_id,
-			role: record.role ?? void 0
+			agent_id: record.agent_id
 		},
 		body,
 		code: trailing === "\r" ? void 0 : codeName,
@@ -3524,67 +3629,6 @@ async function cmdMsgs(rest) {
 	}
 	return 0;
 }
-/**
-* `ay role [name]` / `ay role <keyword> <name>` — read or set an agent's
-* self-declared lane/role name ("pm", "crm", …). The role rides in the
-* `ay send` envelope header (`from claude #123 (pm) @ …`) so recipients don't
-* translate cwd/pid into a lane by hand — the emergent `[pm→qa]` body prefixes
-* exist exactly because the envelope lacked this. With no args: print the
-* calling agent's role. With one arg: set the calling agent's role (requires
-* agent context). With two args: resolve the keyword and set that agent's role.
-* `--clear` removes it. Roles are clamped by sanitizeRole (they render into the
-* non-nonce-protected open tag).
-*/
-const ROLE_RESOLVE_OPTS = {
-	all: false,
-	active: false,
-	cwdScope: null,
-	latest: false,
-	json: false
-};
-async function cmdRole(rest) {
-	const argv = await yargs(rest).usage("Usage: ay role [name] | ay role <keyword> <name> | ay role [keyword] --clear").option("clear", {
-		type: "boolean",
-		default: false,
-		description: "Remove the role"
-	}).help(false).version(false).exitProcess(false).parseAsync();
-	const args = argv._.slice(0).map(String);
-	let target = null;
-	let newRole;
-	if (args.length === 2) {
-		target = await resolveOne(args[0], ROLE_RESOLVE_OPTS);
-		newRole = args[1];
-	} else if (args.length === 1 && argv.clear) target = await resolveOne(args[0], ROLE_RESOLVE_OPTS);
-	else if (args.length === 1) {
-		target = await resolveSender();
-		if (!target) {
-			process.stderr.write("ay role: no agent context (AGENT_YES_PID unset or unregistered) — from a human shell, name the agent: ay role <keyword> <name>\n");
-			return 1;
-		}
-		newRole = args[0];
-	} else {
-		target = await resolveSender();
-		if (!target) {
-			process.stderr.write("ay role: no agent context — from a human shell, name the agent: ay role <keyword> [<name>|--clear]\n");
-			return 1;
-		}
-	}
-	if (newRole === void 0 && !argv.clear) {
-		process.stdout.write(`${target.role ?? ""}\n`);
-		return 0;
-	}
-	let role = null;
-	if (!argv.clear) {
-		role = sanitizeRole(newRole);
-		if (!role) {
-			process.stderr.write(`ay role: invalid role ${JSON.stringify(newRole)} — use 1-32 chars of [A-Za-z0-9._-]\n`);
-			return 1;
-		}
-	}
-	await updateGlobalPidStatus(target.pid, { role });
-	process.stdout.write(role ? `pid ${target.pid} (${target.cli}): role set to "${role}" — envelopes now read: from ${target.cli} #${target.pid} (${role}) @ ${shortenPath(target.cwd)}\n` : `pid ${target.pid} (${target.cli}): role cleared\n`);
-	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.`);
@@ -4017,7 +4061,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-BEdLsSpv.js");
+	const { resolveDaemonHttpBase, loadTokenReadOnly } = await import("./serve-Z8FAjest.js");
 	const daemonBase = await resolveDaemonHttpBase().catch(() => null);
 	const daemonToken = daemonBase ? await loadTokenReadOnly().catch(() => null) ?? "" : "";
 	const capViewer = `attach:${process.pid}`;
@@ -4727,7 +4771,7 @@ async function cmdNotify(rest) {
 	}
 	const ensure = async () => {
 		if (!argv["ensure-daemon"]) return;
-		const { ensureDaemon } = await import("./notifyDaemon-BskLhHdg.js");
+		const { ensureDaemon } = await import("./notifyDaemon--TDDJupp.js");
 		await ensureDaemon().catch(() => null);
 	};
 	await heartbeatWatcher(parent, selfStartedAt);
@@ -4801,7 +4845,7 @@ async function cmdNotifyCursor(args) {
 }
 async function cmdNotifyd(rest) {
 	const sub = rest[0] ?? "status";
-	const daemon = await import("./notifyDaemon-BskLhHdg.js");
+	const daemon = await import("./notifyDaemon--TDDJupp.js");
 	switch (sub) {
 		case "run": return daemon.runDaemon();
 		case "once": return daemon.runDaemon({ once: true });
@@ -4828,4 +4872,4 @@ async function cmdNotifyd(rest) {
 
 //#endregion
 export { listInboxParents as $, readNotes as A, restartHintLines as B, isUserTyping as C, menuSelectKeys as D, matchKeyword as E, renderRawLog as F, submitAndConfirm as G, snapshotStatus as H, renderRawLogLines as I, writeToIpc as J, waitForLogQuiet as K, resolveOne as L, recentMessageEdges as M, recentReadEdges as N, readAgentPtysize as O, renderLogTailLines as P, isTransientLockMkdirError as Q, resolveReadWindow as R, isUnknownManagerToken as S, listRecords as T, stdinActivityPath as U, runSubcommand as V, stopTipForCli as W, gcInboxes as X, appendEvent as Y, hostId as Z, isAgentStuck as _, backoffWhileTyping as a, notifyDir as at, isSlashCommand as b, controlCodeFromName as c, deriveLiveStatus as d, liveWatchers as et, extractBadges as f, finalizedLines as g, extractTaskCounts as h, TYPING_WINDOW_MS as i, daemonLockOwnerPath as it, readPtysize as j, readLogForRender as k, cursorAbs as l, extractNeedsInput as m, MAX_RENDER_BYTES as n, shouldStealLock as nt, cmdDeepseek as o, TYPING_BADGE as ot, extractMenu as p, writeKeysPaced as q, READ_PAGE_DEFAULT as r, daemonLockDir as rt, cmdHelp as s, GRACEFUL_EXIT_COMMANDS as t, readInbox as tt, deriveLiveState as u, isExitRequest as v, lastStdinAt as w, isSubcommand as x, isPidAlive as y, resolveResumeArgs as z };
-//# sourceMappingURL=subcommands-Bo1MSwuC.js.map
+//# sourceMappingURL=subcommands-C3w4bg6x.js.map

package/dist/{terminal-BMQWojIp.js → terminal-iObUHvkj.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-BEdLsSpv.js");
+	const { mintScopedTermToken } = await import("./serve-Z8FAjest.js");
 	const r = await mintScopedTermToken(pid, {
 		ttlSec,
 		canSend
@@ -135,4 +135,4 @@ async function cmdTerm(args) {
 
 //#endregion
 export { cmdTerm };
-//# sourceMappingURL=terminal-BMQWojIp.js.map
+//# sourceMappingURL=terminal-iObUHvkj.js.map

package/dist/{todoCli-DNOk38lq.js → todoCli-CngDeaT2.js}

@@ -1,7 +1,7 @@
 import "./logger-CDIsZ-Pp.js";
 import { _ as isKnownKind, a as renderTree, d as openStore, i as renderDigest, l as CycleError, n as buildTreeJSON, o as unblockedTasks, p as LIFECYCLES, s as describeBlock, t as reconcileTodos, x as removeControlCharacters } from "./todoAutomation-BQRW614S.js";
 import "./JsonlStore-CPGIR0Wy.js";
-import { i as readGlobalPids } from "./globalPidIndex-pwp7Vb7o.js";
+import { i as readGlobalPids } from "./globalPidIndex-Dq4KY2IV.js";
 import yargs from "yargs";
 
 //#region ts/todoCli.ts
@@ -456,4 +456,4 @@ async function runTodoSubcommand(rest0) {
 
 //#endregion
 export { runTodoSubcommand };
-//# sourceMappingURL=todoCli-DNOk38lq.js.map
+//# sourceMappingURL=todoCli-CngDeaT2.js.map

package/dist/{trayApp-CjB5QhdV.js → trayApp-BUI7SXiY.js}

@@ -1,4 +1,4 @@
-import { n as findTrayLauncher } from "./rustBinary-Borvwmya.js";
+import { n as findTrayLauncher } from "./rustBinary-DA-C6PjH.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-CjB5QhdV.js.map
+//# sourceMappingURL=trayApp-BUI7SXiY.js.map

package/dist/trayApp-Cb9a-quB.js

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

package/dist/{ts-BSHR_dga.js → ts-ClHKe4d8.js}

@@ -1,11 +1,11 @@
 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-BTLZ3PAb.js";
+import { r as getInstalledPackage } from "./versionChecker-DRAbaxo-.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";
-import { i as readGlobalPids } from "./globalPidIndex-pwp7Vb7o.js";
-import { t as PidStore } from "./pidStore-DfSm1jog.js";
+import { i as readGlobalPids } from "./globalPidIndex-Dq4KY2IV.js";
+import { t as PidStore } from "./pidStore-DJqSZPJi.js";
 import { r as recordInbox } from "./messageLog-BYFwioFY.js";
 import { n as register, r as sweep } from "./reaper-C4BvNylH.js";
 import { arch, platform } from "process";
@@ -446,6 +446,118 @@ async function createLinuxFifo(cli, customPath) {
 	}
 }
 
+//#endregion
+//#region ts/titleScanner.ts
+/**
+* Incremental scanner for terminal-title escapes (OSC 0/2) in the child CLI's
+* PTY stream — the TS-runtime mirror of rs/src/title_scanner.rs; keep the two
+* in sync.
+*
+* Coding-agent CLIs (claude, opencode, codex) continuously set the terminal
+* title to a summary of what they are doing (`ESC ] 0 ; <title> BEL`, also
+* terminated by `ESC \`). The wrapper observes the stream anyway, so scanning
+* it yields a live "what is this agent doing" label for free — surfaced as
+* `title` in the pid registry and shown by `ay whoami` / `ay ls --json`.
+*
+* Fed arbitrary chunk boundaries: a sequence split across reads still parses.
+* The scanner only observes — it never modifies the stream.
+*/
+/** A title longer than this is a runaway OSC without terminator — discard. */
+const MAX_TITLE_LEN = 512;
+/** What we store/display. */
+const STORED_TITLE_LEN = 256;
+var State = /* @__PURE__ */ function(State) {
+	State[State["Ground"] = 0] = "Ground";
+	State[State["Esc"] = 1] = "Esc";
+	State[State["OscParam"] = 2] = "OscParam";
+	State[State["OscTitle"] = 3] = "OscTitle";
+	State[State["OscOther"] = 4] = "OscOther";
+	State[State["OscTitleEsc"] = 5] = "OscTitleEsc";
+	State[State["OscOtherEsc"] = 6] = "OscOtherEsc";
+	return State;
+}(State || {});
+var TitleScanner = class {
+	state = State.Ground;
+	param = "";
+	title = "";
+	/** Feed one output chunk; returns the LAST complete title in it, if any. */
+	feed(chunk) {
+		let found = null;
+		for (const c of chunk) switch (this.state) {
+			case State.Ground:
+				if (c === "\x1B") this.state = State.Esc;
+				break;
+			case State.Esc:
+				if (c === "]") {
+					this.param = "";
+					this.state = State.OscParam;
+				} else if (c !== "\x1B") this.state = State.Ground;
+				break;
+			case State.OscParam:
+				if (c >= "0" && c <= "9" && this.param.length < 4) this.param += c;
+				else if (c === ";") if (this.param === "0" || this.param === "2") {
+					this.title = "";
+					this.state = State.OscTitle;
+				} else this.state = State.OscOther;
+				else if (c === "\x07") this.state = State.Ground;
+				else if (c === "\x1B") this.state = State.OscOtherEsc;
+				else this.state = State.OscOther;
+				break;
+			case State.OscTitle:
+				if (c === "\x07") {
+					found = cleanTitle(this.title);
+					this.state = State.Ground;
+				} else if (c === "\x1B") this.state = State.OscTitleEsc;
+				else if (this.title.length >= MAX_TITLE_LEN) this.state = State.OscOther;
+				else this.title += c;
+				break;
+			case State.OscTitleEsc:
+				if (c === "\\") found = cleanTitle(this.title);
+				this.state = State.Ground;
+				break;
+			case State.OscOther:
+				if (c === "\x07") this.state = State.Ground;
+				else if (c === "\x1B") this.state = State.OscOtherEsc;
+				break;
+			case State.OscOtherEsc:
+				this.state = State.Ground;
+				break;
+		}
+		return found || null;
+	}
+};
+/** Strip control chars (they can't be typed into a title bar) and clamp. */
+function cleanTitle(raw) {
+	return raw.replace(/[\x00-\x1f\x7f]/g, "").trim().slice(0, STORED_TITLE_LEN);
+}
+/**
+* Change-gated + rate-limited publisher: registry writes take the
+* cross-runtime lock, while claude retitles every few seconds — the steady
+* state must cost zero writes, and a retitle burst collapses to one write per
+* window. Call `poll()` from any recurring point in the run loop so the final
+* title still lands within a window after the CLI goes quiet.
+*/
+var TitlePublisher = class {
+	latest = null;
+	written = null;
+	writtenAt = 0;
+	constructor(write, minIntervalMs = 2e3) {
+		this.write = write;
+		this.minIntervalMs = minIntervalMs;
+	}
+	observe(title) {
+		this.latest = title;
+		this.poll();
+	}
+	poll(now = Date.now()) {
+		if (this.latest === null || this.latest === this.written) return;
+		if (now - this.writtenAt < this.minIntervalMs) return;
+		this.write(this.latest);
+		this.written = this.latest;
+		this.writtenAt = now;
+	}
+};
+
 //#endregion
 //#region ts/idleWaiter.ts
 /**
@@ -1569,7 +1681,6 @@ async function agentYes({ cli, cliArgs = [], skipPermissions = false, prompt, ro
 	const parentPid = Number.isInteger(inheritedAyPid) && inheritedAyPid > 0 ? inheritedAyPid : void 0;
 	ptyEnv.AGENT_YES_PID = String(process.pid);
 	delete ptyEnv.AGENT_YES_AGENT_ID;
-	delete ptyEnv.AGENT_YES_ROLE;
 	stripClaudeSessionPin(ptyEnv);
 	if (cliConf?.env) for (const [key, raw] of Object.entries(cliConf.env)) {
 		let unresolved = false;
@@ -1600,10 +1711,17 @@ async function agentYes({ cli, cliArgs = [], skipPermissions = false, prompt, ro
 		ptyOptions
 	});
 	shellWrite = (data) => shell.write(data);
+	const titleScanner = new TitleScanner();
+	const titlePublisher = new TitlePublisher((title) => {
+		pidStore.updateTitle(shell.pid, title).catch(() => null);
+	});
 	function onData(data) {
 		const currentPid = shell.pid;
 		xtermProxy.write(data);
 		globalAgentRegistry.appendStdout(currentPid, data);
+		const title = titleScanner.feed(data);
+		if (title) titlePublisher.observe(title);
+		else titlePublisher.poll();
 	}
 	shell.onData(onData);
 	try {
@@ -2181,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-BSHR_dga.js.map
+//# sourceMappingURL=ts-ClHKe4d8.js.map

package/dist/{versionChecker-BTLZ3PAb.js → versionChecker-DRAbaxo-.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "agent-yes";
-var version = "1.263.0";
+var version = "1.264.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-BTLZ3PAb.js.map
+//# sourceMappingURL=versionChecker-DRAbaxo-.js.map

package/dist/{widget-BVss0Z9Y.js → widget-BRBsnbLn.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-BEdLsSpv.js");
+	const { resolveDaemonHttpBase, loadTokenReadOnly } = await import("./serve-Z8FAjest.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-BEdLsSpv.js");
+	const { mintScopedTermToken } = await import("./serve-Z8FAjest.js");
 	const r = await mintScopedTermToken(target, {
 		ttlSec,
 		caps
@@ -202,4 +202,4 @@ async function cmdMint(args) {
 
 //#endregion
 export { cmdMint, cmdWidget };
-//# sourceMappingURL=widget-BVss0Z9Y.js.map
+//# sourceMappingURL=widget-BRBsnbLn.js.map

package/dist/{ws-DMudFezi.js → ws-BppNz49U.js}

@@ -1,11 +1,11 @@
 import "./logger-CDIsZ-Pp.js";
-import "./globalPidIndex-pwp7Vb7o.js";
+import "./globalPidIndex-Dq4KY2IV.js";
 import "./messageLog-BYFwioFY.js";
 import "./e2e-CUMZC53I.js";
 import "./configShared-DtHMBCl7.js";
-import "./subcommands-Bo1MSwuC.js";
+import "./subcommands-C3w4bg6x.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-DxNNwnrc.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-CAFA4oXH.js";
 
 export { WS_JSON_SCHEMA, cmdWs, collectWorkspaces, isPathInside, loadProvision, walkWorkspaces, workspaceStatus };