agent-yes 1.130.0 → 1.132.0

package/dist/SUPPORTED_CLIS-DnObTI1A.js

@@ -0,0 +1,8 @@
+import "./ts-FPleHqxr.js";
+import "./logger-B9h0djqx.js";
+import "./versionChecker-4ovR76r7.js";
+import "./pidStore-DWQoGxxA.js";
+import "./globalPidIndex-C7r2m6s7.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-eDyeNYJQ.js";
+
+export { SUPPORTED_CLIS };

package/dist/{SUPPORTED_CLIS-DgpRWiWM.js → SUPPORTED_CLIS-eDyeNYJQ.js}

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

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 import { n as logger } from "./logger-B9h0djqx.js";
-import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-Bty629vj.js";
+import { i as versionString, n as displayVersion, r as getInstalledPackage, t as checkAndAutoUpdate } from "./versionChecker-4ovR76r7.js";
 import { argv } from "process";
 import { execFileSync, spawn } from "child_process";
 import ms from "ms";
@@ -482,7 +482,7 @@ function buildRustArgs(argv, cliFromScript, supportedClis) {
 {
 	const rawArg = process.argv[2];
 	const isHelpFlag = rawArg === "-h" || rawArg === "--help";
-	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-D9CFDaVM.js");
+	const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-CjrE1pU-.js");
 	if (isHelpFlag && process.argv.length === 3) {
 		cmdHelp();
 		process.exit(0);
@@ -515,7 +515,7 @@ if (config.useRust) {
 		}
 	}
 	if (rustBinary) {
-		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-BD3Ly7re.js");
+		const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-DnObTI1A.js");
 		const rustArgs = buildRustArgs(process.argv, config.cli, SUPPORTED_CLIS);
 		if (config.verbose) {
 			console.log(`[rust] Using binary: ${rustBinary}`);
@@ -545,7 +545,7 @@ if (config.showVersion) {
 	process.exit(0);
 }
 if (config.appendPrompt) {
-	const { PidStore } = await import("./pidStore-C4c2O15q.js");
+	const { PidStore } = await import("./pidStore-BweOirbR.js");
 	const ipcPath = await PidStore.findActiveFifo(process.cwd());
 	if (!ipcPath) {
 		console.error("No active agent with IPC found in current directory.");

package/dist/index.js

@@ -1,7 +1,7 @@
-import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-BcbPKaqz.js";
+import { a as removeControlCharacters, i as AgentContext, n as agentYes, r as config, t as CLIS_CONFIG } from "./ts-FPleHqxr.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-Bty629vj.js";
-import "./pidStore-CGKIhaJO.js";
+import "./versionChecker-4ovR76r7.js";
+import "./pidStore-DWQoGxxA.js";
 import "./globalPidIndex-C7r2m6s7.js";
 
 export { AgentContext, CLIS_CONFIG, config, agentYes as default, removeControlCharacters };

package/dist/pidStore-BweOirbR.js

@@ -0,0 +1,5 @@
+import "./logger-B9h0djqx.js";
+import { t as PidStore } from "./pidStore-DWQoGxxA.js";
+import "./globalPidIndex-C7r2m6s7.js";
+
+export { PidStore };

package/dist/{pidStore-CGKIhaJO.js → pidStore-DWQoGxxA.js}

@@ -4,6 +4,7 @@ import { a as updateGlobalPidStatus, n as maybeCompactGlobalPids, r as pruneOldL
 import { closeSync, existsSync, fsyncSync, openSync } from "fs";
 import { appendFile, mkdir, readFile, rename, writeFile } from "fs/promises";
 import path from "path";
+import { randomBytes } from "node:crypto";
 import { lock } from "proper-lockfile";
 
 //#region ts/JsonlStore.ts
@@ -208,6 +209,8 @@ var PidStore = class PidStore {
 		const argsJson = JSON.stringify(args);
 		const logFile = this.getRawLogPath(pid);
 		const fifoFile = this.getFifoPath(pid);
+		const existing = this.store.findOne((doc) => doc.pid === pid);
+		const agentId = existing?.agentId ?? randomBytes(6).toString("hex");
 		const record = {
 			pid,
 			cli,
@@ -218,9 +221,9 @@ var PidStore = class PidStore {
 			fifoFile,
 			status: "active",
 			exitReason: "",
-			startedAt: now
+			startedAt: now,
+			agentId
 		};
-		const existing = this.store.findOne((doc) => doc.pid === pid);
 		if (existing) await this.store.updateById(existing._id, record);
 		else await this.store.append(record);
 		const result = this.store.findOne((doc) => doc.pid === pid);
@@ -242,7 +245,8 @@ var PidStore = class PidStore {
 			exit_reason: null,
 			started_at: now,
 			wrapper_pid: wrapperPid ?? null,
-			parent_pid: parentPid ?? null
+			parent_pid: parentPid ?? null,
+			agent_id: agentId
 		}).then(() => maybeCompactGlobalPids()).catch(() => null);
 		return result;
 	}
@@ -363,4 +367,4 @@ pid-db/
 
 //#endregion
 export { PidStore as t };
-//# sourceMappingURL=pidStore-CGKIhaJO.js.map
+//# sourceMappingURL=pidStore-DWQoGxxA.js.map

package/dist/{schedule-8L8M2WD3.js → schedule-B53gHsN7.js}

@@ -1,9 +1,9 @@
-import "./ts-BcbPKaqz.js";
+import "./ts-FPleHqxr.js";
 import "./logger-B9h0djqx.js";
-import "./versionChecker-Bty629vj.js";
-import "./pidStore-CGKIhaJO.js";
+import "./versionChecker-4ovR76r7.js";
+import "./pidStore-DWQoGxxA.js";
 import "./globalPidIndex-C7r2m6s7.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DgpRWiWM.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-eDyeNYJQ.js";
 import { n as resolveSpawnCwd } from "./workspaceConfig-BJO4fzEn.js";
 import { createHash } from "node:crypto";
 
@@ -141,4 +141,4 @@ async function cmdSchedule(rest) {
 
 //#endregion
 export { cmdSchedule };
-//# sourceMappingURL=schedule-8L8M2WD3.js.map
+//# sourceMappingURL=schedule-B53gHsN7.js.map

package/dist/{serve-DYcTukF5.js → serve-Bu-QzAlr.js}

@@ -1,13 +1,13 @@
-import "./ts-BcbPKaqz.js";
+import "./ts-FPleHqxr.js";
 import "./logger-B9h0djqx.js";
-import { r as getInstalledPackage } from "./versionChecker-Bty629vj.js";
-import "./pidStore-CGKIhaJO.js";
+import { r as getInstalledPackage } from "./versionChecker-4ovR76r7.js";
+import "./pidStore-DWQoGxxA.js";
 import { a as updateGlobalPidStatus } from "./globalPidIndex-C7r2m6s7.js";
 import { t as pgidForWrapper } from "./reaper-BkjPN7mw.js";
 import "./configShared-C5QaNPnz.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DgpRWiWM.js";
+import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-eDyeNYJQ.js";
 import "./remotes-D8GvSbhf.js";
-import { d as listRecords, g as resolveOne, i as controlCodeFromName, m as renderRawLog, p as readNotes, s as extractTaskCounts, x as writeToIpc, y as snapshotStatus } from "./subcommands-BjxWxxGq.js";
+import { d as listRecords, g as resolveOne, i as controlCodeFromName, m as renderRawLog, p as readNotes, s as extractTaskCounts, x as writeToIpc, y as snapshotStatus } from "./subcommands-CpEK563F.js";
 import yargs from "yargs";
 import { mkdir, open, readFile, stat, writeFile } from "fs/promises";
 import { homedir, hostname, userInfo } from "os";
@@ -1142,4 +1142,4 @@ Options:
 
 //#endregion
 export { cmdServe };
-//# sourceMappingURL=serve-DYcTukF5.js.map
+//# sourceMappingURL=serve-Bu-QzAlr.js.map

package/dist/{setup-Ba4q-a7V.js → setup-DTgN_sqc.js}

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

package/dist/{subcommands-D9CFDaVM.js → subcommands-CjrE1pU-.js}

@@ -2,6 +2,6 @@ import "./logger-B9h0djqx.js";
 import "./globalPidIndex-C7r2m6s7.js";
 import "./configShared-C5QaNPnz.js";
 import "./remotes-D8GvSbhf.js";
-import { _ as resolveReadWindow, a as cursorAbs, b as stopTipForCli, c as finalizedLines, d as listRecords, f as matchKeyword, g as resolveOne, h as renderRawLogLines, i as controlCodeFromName, l as isPidAlive, m as renderRawLog, n as READ_PAGE_DEFAULT, o as extractNeedsInput, p as readNotes, r as cmdHelp, s as extractTaskCounts, t as GRACEFUL_EXIT_COMMANDS, u as isSubcommand, v as runSubcommand, x as writeToIpc, y as snapshotStatus } from "./subcommands-BjxWxxGq.js";
+import { _ as resolveReadWindow, a as cursorAbs, b as stopTipForCli, c as finalizedLines, d as listRecords, f as matchKeyword, g as resolveOne, h as renderRawLogLines, i as controlCodeFromName, l as isPidAlive, m as renderRawLog, n as READ_PAGE_DEFAULT, o as extractNeedsInput, p as readNotes, r as cmdHelp, s as extractTaskCounts, t as GRACEFUL_EXIT_COMMANDS, u as isSubcommand, v as runSubcommand, x as writeToIpc, y as snapshotStatus } from "./subcommands-CpEK563F.js";
 
 export { cmdHelp, isSubcommand, runSubcommand };

package/dist/{subcommands-BjxWxxGq.js → subcommands-CpEK563F.js}

@@ -524,15 +524,15 @@ async function runSubcommand(argv) {
 			case "restart": return await cmdRestart(rest);
 			case "note": return await cmdNote(rest);
 			case "serve": {
-				const { cmdServe } = await import("./serve-DYcTukF5.js");
+				const { cmdServe } = await import("./serve-Bu-QzAlr.js");
 				return cmdServe(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup-Ba4q-a7V.js");
+				const { cmdSetup } = await import("./setup-DTgN_sqc.js");
 				return cmdSetup(rest);
 			}
 			case "schedule": {
-				const { cmdSchedule } = await import("./schedule-8L8M2WD3.js");
+				const { cmdSchedule } = await import("./schedule-B53gHsN7.js");
 				return cmdSchedule(rest);
 			}
 			case "remote": {
@@ -562,6 +562,7 @@ function matchKeyword(record, keyword) {
 	if (record.cwd.toLowerCase().includes(kw)) return true;
 	if (record.cli.toLowerCase() === kw) return true;
 	if (record.prompt && record.prompt.toLowerCase().includes(kw)) return true;
+	if (record.agent_id && record.agent_id.toLowerCase().startsWith(kw)) return true;
 	return false;
 }
 async function listRecords(keyword, opts) {
@@ -2407,4 +2408,4 @@ async function cmdResultSet(rest) {
 
 //#endregion
 export { resolveReadWindow as _, cursorAbs as a, stopTipForCli as b, finalizedLines as c, listRecords as d, matchKeyword as f, resolveOne as g, renderRawLogLines as h, controlCodeFromName as i, isPidAlive as l, renderRawLog as m, READ_PAGE_DEFAULT as n, extractNeedsInput as o, readNotes as p, cmdHelp as r, extractTaskCounts as s, GRACEFUL_EXIT_COMMANDS as t, isSubcommand as u, runSubcommand as v, writeToIpc as x, snapshotStatus as y };
-//# sourceMappingURL=subcommands-BjxWxxGq.js.map
+//# sourceMappingURL=subcommands-CpEK563F.js.map

package/dist/{ts-BcbPKaqz.js → ts-FPleHqxr.js}

@@ -1,8 +1,8 @@
 import { n as logger, t as addTransport } from "./logger-B9h0djqx.js";
-import { r as getInstalledPackage } from "./versionChecker-Bty629vj.js";
+import { r as getInstalledPackage } from "./versionChecker-4ovR76r7.js";
 import { t as agentYesHome } from "./agentYesHome-BvaUOzCV.js";
 import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-CJxsoGdb.js";
-import { t as PidStore } from "./pidStore-CGKIhaJO.js";
+import { t as PidStore } from "./pidStore-DWQoGxxA.js";
 import { i as readGlobalPids } from "./globalPidIndex-C7r2m6s7.js";
 import { n as register, r as sweep } from "./reaper-BkjPN7mw.js";
 import { arch, platform } from "process";
@@ -1787,4 +1787,4 @@ function sleep(ms) {
 
 //#endregion
 export { removeControlCharacters as a, AgentContext as i, agentYes as n, config as r, CLIS_CONFIG as t };
-//# sourceMappingURL=ts-BcbPKaqz.js.map
+//# sourceMappingURL=ts-FPleHqxr.js.map

package/dist/{versionChecker-Bty629vj.js → versionChecker-4ovR76r7.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "agent-yes";
-var version = "1.130.0";
+var version = "1.132.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-Bty629vj.js.map
+//# sourceMappingURL=versionChecker-4ovR76r7.js.map

package/lab/ui/blog/e2ee-share-links/index.html

@@ -291,8 +291,9 @@ e2e keys  = HKDF(S, "ay/ay-e2e-1/key/…")  →  never leave your machine or bro
       <footer>
         Curious how it's built? The whole thing is about 200 lines:
         <code>lab/ui/e2e.js</code> (the shared crypto), <code>ts/share.ts</code> (host), and the
-        console client in <code>lab/ui/index.html</code>. ·
-        <a href="https://agent-yes.com/">← back to the console</a>
+        console client in <code>lab/ui/index.html</code>. <br /><br />
+        <a href="/blog/">← all posts</a> · <a href="/architecture.html">Architecture map</a> ·
+        <a href="/w/">Console</a> · <a href="/">agent-yes.com</a>
       </footer>
     </main>
   </body>

package/lab/ui/blog/index.html

@@ -0,0 +1,174 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>agent-yes — blog &amp; design notes</title>
+    <meta
+      name="description"
+      content="Design notes and write-ups for agent-yes: the architecture graph, end-to-end-encrypted share links, and more."
+    />
+    <link
+      rel="icon"
+      href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Ctext y='14' font-size='14'%3E%E2%9C%93%3C/text%3E%3C/svg%3E"
+    />
+    <style>
+      :root {
+        --bg: #0d1117;
+        --fg: #e6edf3;
+        --muted: #8b949e;
+        --accent: #58a6ff;
+        --green: #3fb950;
+        --card: #161b22;
+        --border: #30363d;
+      }
+      @media (prefers-color-scheme: light) {
+        :root {
+          --bg: #ffffff;
+          --fg: #1f2328;
+          --muted: #59636e;
+          --accent: #0969da;
+          --green: #1a7f37;
+          --card: #f6f8fa;
+          --border: #d0d7de;
+        }
+      }
+      * {
+        box-sizing: border-box;
+      }
+      body {
+        background: var(--bg);
+        color: var(--fg);
+        font:
+          16px/1.65 -apple-system,
+          BlinkMacSystemFont,
+          "Segoe UI",
+          Helvetica,
+          Arial,
+          sans-serif;
+        margin: 0;
+        padding: 0 20px;
+      }
+      main {
+        max-width: 760px;
+        margin: 0 auto;
+        padding: 40px 0 96px;
+      }
+      header {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        padding: 4px 0 28px;
+      }
+      .brand {
+        font-weight: 700;
+        font-size: 18px;
+        letter-spacing: -0.01em;
+      }
+      .brand .tick {
+        color: var(--green);
+      }
+      nav a {
+        color: var(--muted);
+        margin-left: 18px;
+        font-size: 14px;
+      }
+      a {
+        color: var(--accent);
+        text-decoration: none;
+      }
+      a:hover {
+        text-decoration: underline;
+      }
+      h1 {
+        font-size: 2em;
+        line-height: 1.2;
+        margin: 12px 0 6px;
+      }
+      .sub {
+        color: var(--muted);
+        margin: 0 0 28px;
+      }
+      .post {
+        display: block;
+        background: var(--card);
+        border: 1px solid var(--border);
+        border-radius: 12px;
+        padding: 18px 20px;
+        margin: 14px 0;
+        color: inherit;
+      }
+      .post:hover {
+        text-decoration: none;
+        border-color: var(--accent);
+      }
+      .post .tag {
+        display: inline-block;
+        font-size: 0.72em;
+        font-weight: 600;
+        letter-spacing: 0.04em;
+        text-transform: uppercase;
+        color: var(--accent);
+        background: color-mix(in srgb, var(--accent) 14%, transparent);
+        border-radius: 999px;
+        padding: 2px 9px;
+        margin-bottom: 9px;
+      }
+      .post h2 {
+        font-size: 1.18em;
+        margin: 0 0 6px;
+      }
+      .post p {
+        margin: 0;
+        color: var(--muted);
+        font-size: 0.95em;
+      }
+      footer {
+        color: var(--muted);
+        font-size: 0.9em;
+        margin-top: 40px;
+        border-top: 1px solid var(--border);
+        padding-top: 20px;
+      }
+    </style>
+  </head>
+  <body>
+    <main>
+      <header>
+        <div class="brand"><span class="tick">✓</span> agent-yes</div>
+        <nav>
+          <a href="/">Home</a>
+          <a href="/w/">Console</a>
+          <a href="/architecture.html">Architecture</a>
+          <a href="https://github.com/snomiao/agent-yes">GitHub</a>
+        </nav>
+      </header>
+
+      <h1>Blog &amp; design notes</h1>
+      <p class="sub">How agent-yes is built, and where it's going.</p>
+
+      <a class="post" href="/architecture.html">
+        <span class="tag">Architecture · living map</span>
+        <h2>The agent-yes graph — today &amp; tomorrow</h2>
+        <p>
+          An interactive map of the whole system: one agent → one local fabric → one API handler →
+          many transports → one URL. What's built, what's experimental, and what's next.
+        </p>
+      </a>
+
+      <a class="post" href="/blog/e2ee-share-links/">
+        <span class="tag">Security</span>
+        <h2>End-to-end encryption for agent-yes share links</h2>
+        <p>
+          How share links stay private even if the signaling relay is compromised: an HKDF key
+          split, AES-256-GCM with per-connection keys, and a fail-closed handshake.
+        </p>
+      </a>
+
+      <footer>
+        <a href="/">← agent-yes.com</a> · <a href="/w/">Console</a> ·
+        <a href="https://github.com/snomiao/agent-yes">GitHub</a>
+      </footer>
+    </main>
+  </body>
+</html>

package/lab/ui/index.html

@@ -2506,12 +2506,17 @@
 
       // The local source is only worth polling when this page is actually backed
       // by an ay serve: localhost, or served by `ay serve --http` (which leaves a
-      // token), or when there are no rooms to fall back on. On the public origin
-      // with rooms, skip it so we don't hammer a 404 every poll.
+      // token), or when there are no rooms to fall back on. The public
+      // agent-yes.com origin serves only static assets + WS rooms (no same-origin
+      // /api), so never probe it — otherwise a bare /w/ visit (e.g. the landing's
+      // "Console" link) 404s on /api/ls + /api/ls/subscribe every poll.
       function ensureLocalSource() {
         const isLocalhost = ["localhost", "127.0.0.1", "[::1]"].includes(location.hostname);
         const hasToken = !!localStorage.getItem("ay.localToken");
-        const enabled = isLocalhost || hasToken || Object.keys(loadRooms()).length === 0;
+        const isPublicOrigin =
+          location.hostname === "agent-yes.com" || location.hostname.endsWith(".agent-yes.com");
+        const enabled =
+          isLocalhost || hasToken || (!isPublicOrigin && Object.keys(loadRooms()).length === 0);
         if (enabled && !sources.has(LOCAL)) {
           const s = {
             id: LOCAL,

package/lab/ui/landing.html

@@ -199,6 +199,7 @@
         <div class="brand"><span class="tick">✓</span> agent-yes</div>
         <nav>
           <a href="/w/">Console</a>
+          <a href="/architecture.html">Architecture</a>
           <a href="/blog/">Blog</a>
           <a href="https://github.com/snomiao/agent-yes">GitHub</a>
         </nav>
@@ -263,8 +264,8 @@ powershell -c "irm https://agent-yes.com/setup.ps1 | iex"</code></pre>
 
       <footer class="wrap" style="padding-left: 0; padding-right: 0">
         <div>
-          <a href="/w/">Console</a> · <a href="/blog/">Blog</a> ·
-          <a href="https://github.com/snomiao/agent-yes">GitHub</a> ·
+          <a href="/w/">Console</a> · <a href="/architecture.html">Architecture</a> ·
+          <a href="/blog/">Blog</a> · <a href="https://github.com/snomiao/agent-yes">GitHub</a> ·
           <a href="https://www.npmjs.com/package/agent-yes">npm</a>
         </div>
         <div style="margin-top: 8px">

package/package.json

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

package/ts/globalPidIndex.spec.ts

@@ -55,6 +55,29 @@ describe("globalPidIndex", () => {
     });
   });
 
+  it("round-trips agent_id and preserves it through a status update", async () => {
+    const mod = await loadModule();
+    await mod.appendGlobalPid({
+      pid: 31313,
+      cli: "claude",
+      prompt: null,
+      cwd: "/a",
+      log_file: null,
+      status: "active",
+      exit_code: null,
+      exit_reason: null,
+      started_at: 1,
+      agent_id: "deadbeef0001",
+    });
+    // updateStatus appends a merged record by pid; agent_id must survive since
+    // the patch doesn't include it (last-line-wins merge spreads the prior doc).
+    await mod.updateGlobalPidStatus(31313, { status: "idle" });
+
+    const records = await mod.readGlobalPids();
+    expect(records).toHaveLength(1);
+    expect(records[0]).toMatchObject({ pid: 31313, status: "idle", agent_id: "deadbeef0001" });
+  });
+
   it("merges multiple appends for the same pid (last write wins)", async () => {
     const mod = await loadModule();
     await mod.appendGlobalPid({

package/ts/globalPidIndex.ts

@@ -47,6 +47,11 @@ export interface GlobalPidRecord {
   // started from a human shell. Builds the agent>subagent tree: a child links to
   // its parent via child.parent_pid === parent.wrapper_pid. See buildAgentForest.
   parent_pid?: number | null;
+  // Stable id minted once at registration so a share grant or `ay <cmd> <id>`
+  // can reference this agent without its ephemeral pid. Mirrors Rust's `agent_id`
+  // (snake_case). Currently per-process; cross-restart re-binding is a follow-up
+  // (see docs/agent-sharing.md). Preserved verbatim through merges/compaction.
+  agent_id?: string | null;
 }
 
 /**

package/ts/pidStore.ts

@@ -1,4 +1,5 @@
 import { mkdir, writeFile } from "fs/promises";
+import { randomBytes } from "node:crypto";
 import path from "path";
 import { logger } from "./logger.ts";
 import { JsonlStore } from "./JsonlStore.ts";
@@ -23,6 +24,8 @@ export interface PidRecord {
   exitReason: string;
   exitCode?: number;
   startedAt: number;
+  // Stable id minted at registration; mirrored to the global index as `agent_id`.
+  agentId?: string;
 }
 
 export class PidStore {
@@ -73,6 +76,11 @@ export class PidStore {
     const logFile = this.getRawLogPath(pid);
     const fifoFile = this.getFifoPath(pid);
 
+    // Upsert by pid. Reuse an existing record's agent id so re-registration
+    // (e.g. status churn) keeps the id stable; mint a fresh 12-hex id otherwise.
+    const existing = this.store.findOne((doc) => doc.pid === pid);
+    const agentId = existing?.agentId ?? randomBytes(6).toString("hex");
+
     const record: Omit<PidRecord, "_id"> = {
       pid,
       cli,
@@ -84,10 +92,9 @@ export class PidStore {
       status: "active",
       exitReason: "",
       startedAt: now,
+      agentId,
     };
 
-    // Upsert by pid
-    const existing = this.store.findOne((doc) => doc.pid === pid);
     if (existing) {
       await this.store.updateById(existing._id!, record);
     } else {
@@ -119,6 +126,7 @@ export class PidStore {
       started_at: now,
       wrapper_pid: wrapperPid ?? null,
       parent_pid: parentPid ?? null,
+      agent_id: agentId,
     })
       .then(() => maybeCompactGlobalPids())
       .catch(() => null);

package/ts/subcommands.spec.ts

@@ -140,6 +140,16 @@ describe("subcommands.matchKeyword", () => {
     const r = { ...baseRecord, prompt: null };
     expect(matchKeyword(r, "parser")).toBe(false);
   });
+
+  it("matches by agent_id prefix", async () => {
+    const { matchKeyword } = await loadModule();
+    const r = { ...baseRecord, agent_id: "a1b2c3d4e5f6" };
+    expect(matchKeyword(r, "a1b2c3d4e5f6")).toBe(true); // full id
+    expect(matchKeyword(r, "a1b2c3")).toBe(true); // prefix
+    expect(matchKeyword(r, "A1B2C3")).toBe(true); // case-insensitive
+    expect(matchKeyword(r, "b2c3")).toBe(false); // not a prefix (mid-string)
+    expect(matchKeyword({ ...baseRecord, agent_id: null }, "a1b2")).toBe(false);
+  });
 });
 
 describe("subcommands.runSubcommand routing", () => {

package/dist/SUPPORTED_CLIS-BD3Ly7re.js

@@ -1,8 +0,0 @@
-import "./ts-BcbPKaqz.js";
-import "./logger-B9h0djqx.js";
-import "./versionChecker-Bty629vj.js";
-import "./pidStore-CGKIhaJO.js";
-import "./globalPidIndex-C7r2m6s7.js";
-import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-DgpRWiWM.js";
-
-export { SUPPORTED_CLIS };

package/dist/pidStore-C4c2O15q.js

@@ -1,5 +0,0 @@
-import "./logger-B9h0djqx.js";
-import { t as PidStore } from "./pidStore-CGKIhaJO.js";
-import "./globalPidIndex-C7r2m6s7.js";
-
-export { PidStore };