@centralu/host-linux-arm64 0.1.0-beta.28 → 0.1.0-beta.29

package/host/main.mjs

@@ -42892,6 +42892,23 @@ function takeLaunchEnv(env = process.env) {
   return launch2;
 }
 
+// packages/agent-host/src/json-value.ts
+var isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var asObj = (v) => isObj(v) ? v : {};
+var str = (v, fallback = "") => typeof v === "string" ? v : fallback;
+var isFilled = (v) => typeof v === "string" && v.length > 0;
+var filled = (v) => isFilled(v) ? v : null;
+var trimmed = (v) => typeof v === "string" && v.trim() ? v.trim() : void 0;
+var finite = (v) => typeof v === "number" && Number.isFinite(v) ? v : void 0;
+var jsonObject = (v) => {
+  if (typeof v !== "string") return asObj(v);
+  try {
+    return jsonObject(JSON.parse(v));
+  } catch {
+    return {};
+  }
+};
+
 // packages/agent-host/src/lifecycle/handed-token.ts
 var HANDED_TOKEN_WAIT_MS = 1e4;
 var MAX_TOKEN_LINE = 4096;
@@ -42903,7 +42920,7 @@ async function readHandedToken(input, waitMs = HANDED_TOKEN_WAIT_MS) {
   } catch {
     throw new Error("the token line on stdin is not JSON");
   }
-  const token2 = typeof parsed === "object" && parsed !== null ? parsed.token : void 0;
+  const token2 = asObj(parsed).token;
   if (typeof token2 !== "string" || token2.trim() === "") throw new Error("the token line on stdin has no token");
   return token2;
 }
@@ -43012,7 +43029,7 @@ import { mkdirSync as mkdirSync15, writeSync as writeSync3 } from "node:fs";
 
 // packages/protocol/src/brand.ts
 var APP_NAME = "Centralu";
-var APP_VERSION = "0.1.0-beta.28";
+var APP_VERSION = "0.1.0-beta.29";
 var APP_SLUG = "centralu";
 var CLIENT_INFO = { name: APP_SLUG, title: APP_NAME, version: APP_VERSION };
 var DATA_DIR = ".centralu";
@@ -58461,15 +58478,15 @@ var ApprovalDetail = ApprovalDetailKinds.catch((ctx) => unknownApprovalCard(ctx.
 var UNKNOWN_CARD = "unknown_card";
 var UNKNOWN_CARD_NOTE = "A newer Centralu may have sent it. Allow it only if you know what it asks; updating Centralu shows it in full.";
 var UNREADABLE_CARD_NOTE = "It may come from a newer Centralu, or be malformed. Allow it only if you know what it asks.";
-var str = (v) => typeof v === "string" && v.trim() !== "" ? v.trim() : void 0;
+var str2 = (v) => typeof v === "string" && v.trim() !== "" ? v.trim() : void 0;
 var quoted = (v, max = 500) => {
   const cut = (t) => t.length > max ? `${t.slice(0, max)}\u2026` : t;
   return typeof v === "string" ? JSON.stringify(cut(v)) : cut(JSON.stringify(v) ?? String(v));
 };
-var nameOf = (v) => typeof v === "object" && v !== null ? str(v.name) : void 0;
+var nameOf = (v) => typeof v === "object" && v !== null ? str2(v.name) : void 0;
 function unknownApprovalCard(raw) {
   const card = typeof raw === "object" && raw !== null ? raw : {};
-  const kind = str(card.kind)?.slice(0, 60);
+  const kind = str2(card.kind)?.slice(0, 60);
   const branch = kind ? ApprovalDetailKinds.options.find((o) => o.shape.kind.value === kind) : void 0;
   const lines = [];
   let problems = "";
@@ -58490,11 +58507,11 @@ function unknownApprovalCard(raw) {
   const named = [
     nameOf(card.project) && `project ${quoted(nameOf(card.project), 80)}`,
     nameOf(card.app) && `app ${quoted(nameOf(card.app), 80)}`,
-    str(card.machine) && `machine ${quoted(str(card.machine), 80)}`
+    str2(card.machine) && `machine ${quoted(str2(card.machine), 80)}`
   ].filter(Boolean);
   if (named.length) lines.push(`It names ${named.join(", ")}.`);
   for (const [key, label] of [["text", "Its text"], ["raw", "Its text"], ["command", "The command"], ["path", "The file"]]) {
-    const v = str(card[key]);
+    const v = str2(card[key]);
     if (v) lines.push(`${label}, as the request gives it (not checked by Centralu): ${quoted(v)}`);
   }
   lines.push(branch ? UNREADABLE_CARD_NOTE : UNKNOWN_CARD_NOTE);
@@ -61529,10 +61546,16 @@ var sessionMethods = {
    * the apps' broker has a trash or purge verb. `agents.deleteSession` is the way in.
    *
    * `bytes` is the total of every session's `bytes` — shown because nothing empties the trash on its own.
+   * `unreached`: the linked machines whose trash could not be read this time (#841 item 4), so the list says it is
+   * not the whole trash. Absent when every machine answered, and from a host before it.
    */
   "trash.list": {
     params: external_exports.object({}),
-    result: external_exports.object({ sessions: external_exports.array(TrashedSession), bytes: external_exports.number() })
+    result: external_exports.object({
+      sessions: external_exports.array(TrashedSession),
+      bytes: external_exports.number(),
+      unreached: external_exports.array(external_exports.object({ machineId: external_exports.string(), name: external_exports.string() })).optional()
+    })
   },
   /** A trashed conversation, read-only — the same page shape as `messages.load` */
   "trash.read": {
@@ -62058,6 +62081,9 @@ function appKeyOf(projectId, appId, machine) {
 function appLabel(ref) {
   return `${ref.projectId === null ? "user" : ref.projectId.slice(0, 8)}/${ref.appId}`;
 }
+function noSuchAppText(ref) {
+  return `There is no such app: ${ref.projectId ?? "user"}/${ref.appId}`;
+}
 
 // packages/protocol/src/app-frames.ts
 function frameField(value) {
@@ -63178,23 +63204,6 @@ function keeperPtyModule(keeper) {
   };
 }
 
-// packages/agent-host/src/json-value.ts
-var isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-var asObj = (v) => isObj(v) ? v : {};
-var str2 = (v, fallback = "") => typeof v === "string" ? v : fallback;
-var isFilled = (v) => typeof v === "string" && v.length > 0;
-var filled = (v) => isFilled(v) ? v : null;
-var trimmed = (v) => typeof v === "string" && v.trim() ? v.trim() : void 0;
-var finite = (v) => typeof v === "number" && Number.isFinite(v) ? v : void 0;
-var jsonObject = (v) => {
-  if (typeof v !== "string") return asObj(v);
-  try {
-    return jsonObject(JSON.parse(v));
-  } catch {
-    return {};
-  }
-};
-
 // packages/agent-host/src/keeper/tags.ts
 function parseTag(raw) {
   if (typeof raw !== "object" || raw === null) return null;
@@ -64722,18 +64731,23 @@ function proxyPageHtml(config2) {
 
 // packages/agent-host/src/views/view-document.ts
 var VIEW_MIME_TYPE = "text/html;profile=mcp-app";
+function isViewMimeType(mimeType) {
+  return typeof mimeType === "string" && mimeType.replace(/\s+/g, "").toLowerCase() === VIEW_MIME_TYPE;
+}
+function viewHtmlOf(item) {
+  if (typeof item.text === "string") return item.text;
+  if (typeof item.blob === "string") return Buffer.from(item.blob, "base64").toString("utf8");
+  return null;
+}
 function viewDocumentFromResource(result, uri) {
   const contents = result?.contents;
   if (!Array.isArray(contents) || contents.length === 0) throw new Error(`${uri}: the app returned no content for this view`);
   const item = contents.find((c) => c?.uri === uri) ?? contents[0];
-  const mime = typeof item.mimeType === "string" ? item.mimeType.replace(/\s+/g, "").toLowerCase() : "";
-  if (mime !== VIEW_MIME_TYPE) {
+  if (!isViewMimeType(item.mimeType)) {
     throw new Error(`${uri}: not an app view (mimeType ${JSON.stringify(item.mimeType ?? null)}, expected ${VIEW_MIME_TYPE})`);
   }
-  let html;
-  if (typeof item.text === "string") html = item.text;
-  else if (typeof item.blob === "string") html = Buffer.from(item.blob, "base64").toString("utf8");
-  else throw new Error(`${uri}: the view has neither text nor blob`);
+  const html = viewHtmlOf(item);
+  if (html === null) throw new Error(`${uri}: the view has neither text nor blob`);
   const ui2 = item._meta?.ui;
   const csp = ui2?.csp && typeof ui2.csp === "object" ? ui2.csp : void 0;
   const permissions = ui2?.permissions && typeof ui2.permissions === "object" ? ui2.permissions : void 0;
@@ -77435,13 +77449,13 @@ function fillCacheFields(method, result) {
   const provided = result;
   const ttlMs = isValidCacheTtlMs(provided["ttlMs"]) ? provided["ttlMs"] : resolveTtlMs(fallback);
   const cacheScope = isValidCacheScope(provided["cacheScope"]) ? provided["cacheScope"] : resolveCacheScope(fallback);
-  const filled3 = {
+  const filled2 = {
     ...provided,
     ttlMs,
     cacheScope
   };
-  delete filled3[RESULT_CACHE_HINT_FALLBACK];
-  return filled3;
+  delete filled2[RESULT_CACHE_HINT_FALLBACK];
+  return filled2;
 }
 function isPlainObject$5(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -82171,7 +82185,6 @@ function resourceUriOf(tool) {
 }
 
 // packages/agent-host/src/apps/external/check.ts
-var UI_MIME = "text/html;profile=mcp-app";
 var BRIDGE_TAG = "centralu:mcp-app.js";
 var problem = (where, message) => ({ level: "problem", where, message });
 var warning = (where, message) => ({ level: "warning", where, message });
@@ -82228,13 +82241,13 @@ function checkScreen(uri, read) {
   const content = read.contents.find((c) => c.uri === uri) ?? read.contents[0];
   if (!content) return { findings: [problem(where, "it was read but came back empty (no contents)")], chars: 0 };
   const findings = [];
-  if (content.mimeType !== UI_MIME) {
-    findings.push(problem(where, `its mimeType is ${JSON.stringify(content.mimeType ?? null)} \u2014 a screen must be "${UI_MIME}" (centralu.uiResource sets it)`));
+  if (!isViewMimeType(content.mimeType)) {
+    findings.push(problem(where, `its mimeType is ${JSON.stringify(content.mimeType ?? null)} \u2014 a screen must be "${VIEW_MIME_TYPE}" (centralu.uiResource sets it)`));
   }
-  const text2 = "text" in content && typeof content.text === "string" ? content.text : null;
-  if (text2 === null) {
+  const text2 = viewHtmlOf(content);
+  if (text2 === null) return { findings: [...findings, problem(where, "it has neither text nor a blob, so it cannot be shown")], chars: 0 };
+  if (!("text" in content) || typeof content.text !== "string") {
     findings.push(warning(where, "the HTML came as a blob, not as text \u2014 Centralu's template sends text"));
-    return { findings, chars: 0 };
   }
   if (!text2.trim()) findings.push(problem(where, "the HTML is empty"));
   if (text2.includes(BRIDGE_TAG)) {
@@ -85224,13 +85237,13 @@ function fillCacheFields2(method, result) {
   const provided = result;
   const ttlMs = isValidCacheTtlMs2(provided["ttlMs"]) ? provided["ttlMs"] : resolveTtlMs2(fallback);
   const cacheScope = isValidCacheScope2(provided["cacheScope"]) ? provided["cacheScope"] : resolveCacheScope2(fallback);
-  const filled3 = {
+  const filled2 = {
     ...provided,
     ttlMs,
     cacheScope
   };
-  delete filled3[RESULT_CACHE_HINT_FALLBACK2];
-  return filled3;
+  delete filled2[RESULT_CACHE_HINT_FALLBACK2];
+  return filled2;
 }
 function isPlainObject$42(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -97229,7 +97242,7 @@ var AppProcess = class _AppProcess {
       });
     } catch (e) {
       const shim = /\.(cmd|bat)$/i.test(launch2.command) ? " (a .cmd or .bat that is not a package manager shim needs a shell: name the program it starts)" : "";
-      const head = `could not run ${launch2.command}: ${e.message}${shim}`;
+      const head = spec.redact(`could not run ${launch2.command}: ${e.message}${shim}`);
       log.note(head);
       log.close();
       throw new AppStartError(head, head, []);
@@ -97244,7 +97257,7 @@ var AppProcess = class _AppProcess {
       return proc;
     } catch (e) {
       await proc.waitExit(spec.exitWaitMs);
-      const head = proc.exit ? `exited before it was ready (${describeExit(proc.exit)})` : e.message;
+      const head = proc.exit ? `exited before it was ready (${describeExit(proc.exit)})` : spec.redact(e.message);
       const reason = proc.reason(head);
       const stderr = proc.log.tailLines();
       await proc.stop(0);
@@ -98529,14 +98542,17 @@ function readZipEntries(buf, maxEntries) {
     if (name.includes("\uFFFD")) throw new ZipError("An entry name is not UTF-8; re-create the archive with UTF-8 names");
     if (flags & 1) throw new ZipError(`Encrypted entries are not supported: ${name}`);
     if (compressedSize === 4294967295 || size === 4294967295 || offset === 4294967295) throw new ZipError("ZIP64 archives are not supported");
-    out.push({ name, kind: kindOf(name, madeBy, external), method, compressedSize, size, crc, offset });
+    const mode = unixMode(madeBy, external);
+    out.push({ name, kind: kindOf(name, mode, external), mode, method, compressedSize, size, crc, offset });
     p = nameEnd + extraLen + commentLen;
   }
   return out;
 }
-function kindOf(name, madeBy, external) {
+function unixMode(madeBy, external) {
   const host = madeBy >> 8;
-  const mode = host === 3 || host === 19 ? external >>> 16 : 0;
+  return host === 3 || host === 19 ? external >>> 16 : 0;
+}
+function kindOf(name, mode, external) {
   const type = mode & 61440;
   if (type === 40960) return "link";
   if (name.endsWith("/") || type === 16384 || (external & 16) !== 0) return "dir";
@@ -98858,7 +98874,7 @@ function stageZip(buf, dest, limits) {
     } catch (err) {
       throw new ImportRefused(err instanceof ZipError ? err.message : `Could not unpack ${wireJoin(...parts)}: ${err.message}`);
     }
-    writeFileSync4(out, data, { mode: 420 });
+    writeFileSync4(out, data, { mode: execBits(e.mode) });
   }
   t.out.files.sort((a, b2) => a.path < b2.path ? -1 : a.path > b2.path ? 1 : 0);
   return t.out;
@@ -99316,7 +99332,7 @@ var AppHandover = class {
   /** An id that already exists — even a folder standing there with an invalid manifest belongs to the person. Never overwritten (the same rule as a new app) */
   refuseTaken(id3) {
     this.host.rescanUser();
-    if (this.host.userApp(id3) || existsSync9(join19(this.host.dataRoot, "apps", id3))) {
+    if (this.host.userApp(id3) || existsSync9(join19(this.host.dataRoot, ...USER_APPS_PARTS, id3))) {
       throw new ImportRefused(`An app with the id "${id3}" is already in your apps. Remove it first, or change the id in its manifest`);
     }
   }
@@ -99897,7 +99913,7 @@ var ExternalApps = class {
   // ── Discovery ──────────────────────────────────────────────────────────────────────
   require(ref) {
     const e = this.find(ref);
-    if (!e) throw new AppUnavailableError(`There is no such app: ${ref.projectId ?? "user"}/${ref.appId}`);
+    if (!e) throw new AppUnavailableError(noSuchAppText(ref));
     return e;
   }
   find(ref) {
@@ -101172,8 +101188,8 @@ Answer with agent_session(sessionId="${r.sessionId}", action="answer", card=\u20
 }
 var NO_POLLING = "Do not check on it with status meanwhile. With nothing else to do, wait is the one call that blocks until the end:";
 var NEW_ROLE_NEW_AGENT = "For another kind of work (say, editing files after read-only research), start a new agent instead, with the task written in full: it starts without this one's context, and this one's name and role came from its first task.";
-function cleanUpLine(sessionId) {
-  return `Once you have used its answer and need nothing more from it, delete it: agent_session(sessionId="${sessionId}", action="delete"). Work not on the trunk is kept in the trash.`;
+function cleanUpLine(sessionId, call2 = `agent_session(sessionId="${sessionId}", action="delete")`) {
+  return `Once you have used its answer and need nothing more from it, delete it: ${call2}. Work not on the trunk is kept in the trash.`;
 }
 function agentListText(r) {
   if (!r.ok) return { text: r.error, isError: true };
@@ -101749,7 +101765,6 @@ function orchestratorToolSchemas(profile = "orchestrator") {
 }
 
 // packages/agent-host/src/sessions/orchestrator-tools.ts
-var filled2 = (v) => v?.trim() ? v.trim() : void 0;
 function issuesText(error51) {
   return error51.issues.map((i) => `${i.path.join(".") || "(args)"}: ${i.message}`).join("; ");
 }
@@ -101811,20 +101826,20 @@ var HANDLERS = {
     const project2 = args.project.trim();
     if (!project2) return { text: "Give a project \u2014 the name of another Centralu project.", isError: true };
     const task = args.task?.trim() ? args.task : void 0;
-    const session2 = filled2(args.session);
+    const session2 = trimmed(args.session);
     const { ifBusy } = args;
     return askProjectText(await tools.askProject({ project: project2, ...session2 ? { session: session2 } : {}, ...task ? { task } : {}, ...ifBusy ? { ifBusy } : {} }, signal));
   },
   async start_agent(args, { tools, signal, caller }) {
     const task = args.task.trim() ? args.task : void 0;
     if (!task) return { text: "Give a task: what the new session should do.", isError: true };
-    const tool = filled2(args.tool);
-    const model = filled2(args.model);
-    const effort = filled2(args.effort);
+    const tool = trimmed(args.tool);
+    const model = trimmed(args.model);
+    const effort = trimmed(args.effort);
     const { difficulty } = args;
-    const branch = filled2(args.branch);
-    const name = filled2(args.name);
-    const machine = filled2(args.machine);
+    const branch = trimmed(args.branch);
+    const name = trimmed(args.name);
+    const machine = trimmed(args.machine);
     return agentCallsFor(caller, agentRunText(
       await tools.startAgent(
         {
@@ -101845,14 +101860,14 @@ var HANDLERS = {
     ));
   },
   async agent_session(args, { tools, signal, caller }) {
-    const sessionId = filled2(args.sessionId);
+    const sessionId = trimmed(args.sessionId);
     const { action, ifBusy } = args;
     if (action === "list") return agentCallsFor(caller, agentListText(await tools.listAgents()));
     if (!sessionId) return { text: "Give the sessionId start_agent returned.", isError: true };
     const text2 = args.text?.trim() ? args.text : void 0;
     if (action === "send" && !text2) return { text: "Give text: what to send it.", isError: true };
     if (action === "answer" && !text2) return { text: "Give text: the answer.", isError: true };
-    const card = filled2(args.card);
+    const card = trimmed(args.card);
     return agentCallsFor(caller, agentRunText(await tools.agentSession({ sessionId, action, ...text2 ? { text: text2 } : {}, ...card ? { card } : {}, ...ifBusy ? { ifBusy } : {} }, signal)));
   },
   async recall({ query, limit }, { tools }) {
@@ -101872,13 +101887,13 @@ Not searched: ${r.notSearched.join("; ")}.` : "";
     const sessionId = args.sessionId.trim();
     const text2 = args.text.trim();
     if (!sessionId || !text2) return { text: "Give sessionId and text: the session and your answer.", isError: true };
-    const card = filled2(args.card);
+    const card = trimmed(args.card);
     const r = await tools.answerQuestion({ sessionId, text: text2, ...card ? { card } : {} });
     if (!r.ok) return { text: r.error, isError: true };
     return { text: `Answered card ${r.state === "answered" ? r.card : ""} in "${r.sessionName}" [${r.sessionId}]; it goes on.` };
   },
   async read_session(args, { tools, caller }) {
-    if (caller.profile === "reader" && !args.sessionId) return listSessionsText(tools, caller, filled2(args.project));
+    if (caller.profile === "reader" && !args.sessionId) return listSessionsText(tools, caller, trimmed(args.project));
     const r = await tools.readSession(args.sessionId ?? "", args.limit, {
       around: args.around,
       tools: args.tools === true
@@ -101897,12 +101912,12 @@ ${cardsText(r.cards)}
   },
   async create_project(args, { tools, signal }) {
     const folder = args.name ?? "";
-    const git2 = filled2(args.git);
+    const git2 = trimmed(args.git);
     if (!folder.trim() && !git2) return { text: "Give a name \u2014 the new folder is named by it, and so is the project.", isError: true };
-    const parent = filled2(args.parent);
-    const branch = git2 ? filled2(args.branch) : void 0;
+    const parent = trimmed(args.parent);
+    const branch = git2 ? trimmed(args.branch) : void 0;
     const source = git2 ? { git: git2, ...branch ? { branch } : {} } : void 0;
-    const machine = filled2(args.machine);
+    const machine = trimmed(args.machine);
     const r = await tools.createProject({ name: folder, ...parent ? { parent } : {}, ...source ? { source } : {}, ...machine ? { machine } : {} }, signal);
     if (!r.ok) return { text: `No project was made: ${r.error}`, isError: true };
     return {
@@ -101911,7 +101926,7 @@ ${cardsText(r.cards)}
   },
   async handoff_session(args, { tools, caller, signal }) {
     const sessionId = args.sessionId?.trim() ?? "";
-    const waitFor = filled2(args.waitFor);
+    const waitFor = trimmed(args.waitFor);
     if (!sessionId && !waitFor) return { text: "Give sessionId: the session to hand off, from list_sessions.", isError: true };
     const { tool, mode } = args;
     const instructions = args.instructions?.trim() ? args.instructions : void 0;
@@ -101955,7 +101970,7 @@ ${cardsText(r.cards)}
     return { text: r.text };
   },
   async create_app(args, { tools }) {
-    const spec = { id: args.id.trim(), name: args.name.trim(), project: filled2(args.project), description: args.description, tool: args.tool };
+    const spec = { id: args.id.trim(), name: args.name.trim(), project: trimmed(args.project), description: args.description, tool: args.tool };
     if (!spec.id || !spec.name) return { text: "Give id and name \u2014 a folder name and a name to show the person are needed for the app to stand.", isError: true };
     const r = await tools.createApp(spec);
     if (!r.ok) return { text: `Could not create it \u2014 ${r.error}`, isError: true };
@@ -102335,10 +102350,15 @@ async function isRepo(cwd) {
   try {
     await git(cwd, ["rev-parse", "--git-dir"]);
     return true;
-  } catch {
-    return false;
+  } catch (e) {
+    if (notARepository(e)) return false;
+    throw e;
   }
 }
+function notARepository(e) {
+  const err = e;
+  return /not a git repository/i.test(String(err.stderr || err.message || "")) || err.code === "ENOENT";
+}
 var SUMMARY_CAP = 1e4;
 async function gitSummary(cwd, trust = {}, limits = {}) {
   const cap = limits.cap ?? SUMMARY_CAP;
@@ -102374,7 +102394,7 @@ async function gitSummary(cwd, trust = {}, limits = {}) {
     const err = e;
     const msg = String(err.stderr || err.message || "");
     if (/Operation not permitted|EPERM|EACCES|permission denied/i.test(msg)) return { isRepo: true, branch: "", changedFiles: 0, denied: true };
-    if (/not a git repository/i.test(msg) || err.code === "ENOENT") return { isRepo: false, branch: "", changedFiles: 0 };
+    if (notARepository(e)) return { isRepo: false, branch: "", changedFiles: 0 };
     return { isRepo: true, branch: "", changedFiles: 0, unknown: true };
   }
 }
@@ -103003,8 +103023,8 @@ var WorktreeSessions = class {
     const fromTrunk = trunk && await gitRevParse(params.cwd, trunk) ? trunk : null;
     if (trunk && !fromTrunk) console.error(`[worktree] trunk not found, forking from HEAD instead: ${trunk}`);
     const from = asked ?? fromTrunk;
-    const baseSha = from ? await gitRevParse(params.cwd, from) : await gitHeadSha(params.cwd);
     try {
+      const baseSha = from ? await gitRevParse(params.cwd, from) : await gitHeadSha(params.cwd);
       worktree = await gitWorktreeAdd(params.cwd, path2, branch, from ?? void 0, { trusted: true });
       if (baseSha) worktree = { ...worktree, base: baseSha };
     } catch (err) {
@@ -103753,7 +103773,7 @@ ${text2}` : text2 });
       const remote = remoteOf(sessionId);
       if (remote) {
         const earlier = host.children.linkedReports.get(sessionId);
-        const mine = reportBack ? { orchestratorId, busy: false } : void 0;
+        const mine = reportBack ? { orchestratorId, busy: false, instruction: text2 } : void 0;
         if (mine) host.children.setLinkedReport(sessionId, mine);
         const r = await remote.send(sessionId, text2, host.meta.get(orchestratorId)?.name ?? "Orchestrator");
         const current = host.children.linkedReports.get(sessionId);
@@ -103769,6 +103789,10 @@ ${text2}` : text2 });
           } else if (mine) failedSends.add(mine);
           return r;
         }
+        if (mine?.instruction !== void 0) {
+          console.error(`[links] ${sessionId}: the machine's record of the instruction was not heard; the next turn end reports`);
+          delete mine.instruction;
+        }
         if (!reportBack && earlier?.orchestratorId === orchestratorId && current === earlier) host.children.dropLinkedReport(sessionId);
         return { ok: true };
       }
@@ -106790,7 +106814,7 @@ var RemoteAgents = class {
     this.save([...this.records(), rec]);
     const waiting = opts.wait === false ? void 0 : this.openWait(rec.sessionId);
     if (!waiting) this.host.children.setLinkedReport(rec.sessionId, { orchestratorId: callerId, busy: false });
-    const label = labelOf(this.host.store, caller);
+    const label = labelOf(this.host.store.messages, caller);
     const sent = await reader.send(rec.sessionId, remoteAgentFrame(label, opts.task), label, { depth: depthOf(this.host, callerId) + 1 });
     if (!sent.ok) {
       if (waiting && this.waits.get(rec.sessionId) === waiting) this.waits.delete(rec.sessionId);
@@ -106812,7 +106836,7 @@ var RemoteAgents = class {
     if (rec.callerId !== callerId) return { ok: false, error: `${rec.sessionId} is not a session this session started. agent_session works only on sessions start_agent started from here.` };
     const reader = this.host.linkedReader;
     if (!reader) return { ok: false, error: `${rec.sessionId} is on ${rec.machine}, and no machine is linked to this computer now.` };
-    const label = labelOf(this.host.store, this.host.meta.get(callerId));
+    const label = labelOf(this.host.store.messages, this.host.meta.get(callerId));
     const stateOf = async () => {
       const r = await reader.read(rec.sessionId, 1);
       return r.ok ? { ok: true, state: r.state ?? "idle" } : { ok: false, error: `${rec.machine} cannot be asked about "${rec.name}" now: ${r.error ?? "no answer"}` };
@@ -107084,8 +107108,10 @@ var RemoteAgents = class {
   }
 };
 
-// packages/agent-host/src/sessions/delegation-flow.ts
+// packages/agent-host/src/sessions/hub-sender.ts
 var HUB_SENDER = "_hub-orchestrator";
+
+// packages/agent-host/src/sessions/delegation-flow.ts
 var DelegationFlow = class {
   constructor(host) {
     this.host = host;
@@ -107252,8 +107278,9 @@ var DelegationFlow = class {
 };
 
 // packages/agent-host/src/sessions/child-reports.ts
-function pausedReportLine(running2, stoppable) {
-  return `[Centralu] The assigned work paused: its turn ended while its own background work is still running (${taskList(running2)}). If that work is a server or watcher it leaves running, the answer below may be its final one. A final report follows only if that work ends` + (stoppable ? '; agent_session(action="stop") on it stops that work and ends the wait.\n' : ".\n");
+function pausedReportLine(running2, stop) {
+  return `[Centralu] The assigned work paused: its turn ended while its own background work is still running (${taskList(running2)}). If that work is a server or watcher it leaves running, the answer below may be its final one. A final report follows only if that work ends` + (stop ? `; ${stop} on it stops that work and ends the wait.
+` : ".\n");
 }
 function linkLostReportLine(machine, paused) {
   return `[Centralu] The assigned work paused on its own background work (${taskList(paused)}), and the link to ${frameField(machine)} dropped before that work ended, so its end will not be reported. It may still be running there; read the session once the link is back.
@@ -107382,7 +107409,7 @@ var ChildReports = class {
   async deliverReport(orchestratorId, sessionId, name, project2, preview, ending, work) {
     const stop = this.host.meta.get(sessionId)?.interruption;
     const cutShort = stop?.reason === "network" || stop?.reason === "interrupted" || stop?.reason === "quit";
-    const outcome = work && "machineRemoved" in work ? machineRemovedReportLine(work.machineRemoved, work.paused) : work && "linkLost" in work ? linkLostReportLine(work.linkLost, work.paused) : work && "paused" in work ? pausedReportLine(work.paused, work.stoppable) : work && "settled" in work ? settledReportLine(work.settled) : stop?.reason === "network" ? `[Centralu] The assigned work stopped before finishing: a network error ended its turn.
+    const outcome = work && "machineRemoved" in work ? machineRemovedReportLine(work.machineRemoved, work.paused) : work && "linkLost" in work ? linkLostReportLine(work.linkLost, work.paused) : work && "paused" in work ? pausedReportLine(work.paused, work.stoppable ? this.agentCall(orchestratorId, { action: "stop" }) : void 0) : work && "settled" in work ? settledReportLine(work.settled) : stop?.reason === "network" ? `[Centralu] The assigned work stopped before finishing: a network error ended its turn.
 ` : stop?.reason === "interrupted" ? `[Centralu] The assigned work stopped before finishing: its tool interrupted the turn.
 ` : stop?.reason === "quit" ? `[Centralu] The assigned work stopped before finishing: Centralu quit or restarted during its turn.
 ` : ending.type === "error" ? `[Centralu] The assigned work failed.
@@ -107423,8 +107450,17 @@ If you need more, you can read that session's recent conversation with read_sess
     if (!child || !cleanUpDue(child, parentId)) return "";
     const others = ownAgents(this.host, parentId).filter((s) => s.id !== childId && agentState(this.host, s) === "finished").length;
     return `
-${cleanUpLine(childId)}` + (others ? `
-${others} other finished session${others === 1 ? "" : "s"} you started remain${others === 1 ? "s" : ""}: agent_session(action="list") shows them.` : "");
+${cleanUpLine(childId, this.agentCall(parentId, { sessionId: childId, action: "delete" }))}` + (others ? `
+${others} other finished session${others === 1 ? "" : "s"} you started remain${others === 1 ? "s" : ""}: ${this.agentCall(parentId, { action: "list" })} shows them.` : "");
+  }
+  /**
+   * An agent_session call a report names, in the form its receiver calls it (#850): the orchestrator reaches agent_session
+   * only through centralu_run in the `commands` tier, where the bare call it would copy from the report is refused. A
+   * seat without the tool keeps the bare form the reports always named.
+   */
+  agentCall(receiverId, args) {
+    const bare2 = `agent_session(${Object.entries(args).map(([k2, v]) => `${k2}=${JSON.stringify(v)}`).join(", ")})`;
+    return callForm(this.host.toolProfileOf(receiverId), "agent_session", args) ?? bare2;
   }
   /**
    * Tells a session something in its conversation (#428): a report, or Centralu's word on a request, a note or a queued
@@ -108746,7 +108782,7 @@ function failure(text2) {
 
 // packages/agent-host/src/sessions/app-access.ts
 var KEY = (sessionId) => `session_apps:${sessionId}`;
-var SHARED_KEY = (ref) => `app_shared:${ref.projectId}/${ref.appId}`;
+var SHARED_KEY = (ref) => `app_shared:${appKeyOf(ref.projectId, ref.appId)}`;
 var UNUSABLE2 = /* @__PURE__ */ new Set(["invalid", "untrusted", "unconfirmed", "failed"]);
 function readShared(store2, ref) {
   return ref.projectId !== null && store2.appSetting(SHARED_KEY({ projectId: ref.projectId, appId: ref.appId })) === "1";
@@ -108902,7 +108938,7 @@ var AppAccess = class {
     return { ok: true, app: app2 };
   }
   match(mine, ref) {
-    return mine.find((r) => r.server === ref || this.refOf(r) === ref || r.projectId !== null && `${r.projectId}/${r.appId}` === ref) ?? mine.find((r) => r.appId === ref);
+    return mine.find((r) => r.server === ref || this.refOf(r) === ref || r.projectId !== null && appKeyOf(r.projectId, r.appId) === ref) ?? mine.find((r) => r.appId === ref);
   }
   describe(a) {
     const known = this.deps.hub.rt.knownTools({ projectId: a.projectId, appId: a.appId }, "model");
@@ -110656,6 +110692,10 @@ ${attachments.map((a) => `@${a.path}`).join("\n")}` : text2;
 };
 
 // packages/agent-host/src/sessions/linked-reports.ts
+function fromHub(from) {
+  const id3 = from?.sessionId;
+  return typeof id3 === "string" && id3.endsWith(`.${HUB_SENDER}`);
+}
 var LinkedReports = class {
   constructor(host) {
     this.host = host;
@@ -110701,6 +110741,10 @@ var LinkedReports = class {
       if (wait.paused) this.settleLater(sessionId, wait);
       return;
     }
+    if (wait.instruction !== void 0) {
+      if (e.type === "user_message" && e.text === wait.instruction && fromHub(e.from)) delete wait.instruction;
+      return;
+    }
     const step = linkedTurnEnd(wait.busy, e);
     if (step?.step === "busy") {
       wait.busy = true;
@@ -111622,7 +111666,7 @@ function isCentraluTool(call2, tool) {
   return call2.tool === tool && (!call2.server || call2.server === ORCHESTRATOR_MCP_NAME);
 }
 function centraluRunCommand(args) {
-  const command = str2(args.command).trim();
+  const command = str(args.command).trim();
   if (!/^[a-z]+(?:_[a-z]+)*$/.test(command)) return null;
   return { command, args: jsonObject(args.args) };
 }
@@ -111819,16 +111863,16 @@ var ClaudeSchedules = class _ClaudeSchedules {
   push(m) {
     const content = m.message?.content ?? [];
     if (!Array.isArray(content)) return this.prune();
-    if (str2(m.type) === "assistant") {
+    if (str(m.type) === "assistant") {
       for (const b2 of content) {
-        if (str2(b2.type) === "tool_use" && SCHEDULE_TOOLS.has(str2(b2.name))) this.calls.set(str2(b2.id), { name: str2(b2.name), input: b2.input ?? {} });
+        if (str(b2.type) === "tool_use" && SCHEDULE_TOOLS.has(str(b2.name))) this.calls.set(str(b2.id), { name: str(b2.name), input: b2.input ?? {} });
       }
       return this.prune();
     }
-    const results = content.filter((b2) => str2(b2.type) === "tool_result");
+    const results = content.filter((b2) => str(b2.type) === "tool_result");
     let changed = this.prune();
     for (const b2 of results) {
-      const id3 = str2(b2.tool_use_id);
+      const id3 = str(b2.tool_use_id);
       const call2 = this.calls.get(id3);
       if (!call2) continue;
       this.calls.delete(id3);
@@ -111848,32 +111892,32 @@ var ClaudeSchedules = class _ClaudeSchedules {
       }
       const asked = typeof call2.input.delaySeconds === "number" ? Math.min(Math.max(call2.input.delaySeconds, 60), WAKEUP_MAX_S) : WAKEUP_MAX_S;
       const due2 = typeof out.scheduledFor === "number" ? out.scheduledFor : now + asked * 1e3;
-      const reason = str2(call2.input.reason);
+      const reason = str(call2.input.reason);
       this.wakeups.set(callId, { id: `schedule-wakeup-${callId}`, due: due2, description: `Wakes itself at ${clock(due2)} (/loop)${reason ? `: ${reason}` : ""}` });
       return true;
     }
     if (call2.name === "CronCreate") {
-      const jobId = str2(out.id) || callId;
-      if (!str2(out.id)) this.unnamed.add(jobId);
-      const when = str2(out.humanSchedule) || str2(call2.input.cron);
+      const jobId = str(out.id) || callId;
+      if (!str(out.id)) this.unnamed.add(jobId);
+      const when = str(out.humanSchedule) || str(call2.input.cron);
       this.crons.set(jobId, { id: `schedule-cron-${jobId}`, due: now + CRON_EXPIRY_MS, description: `Scheduled prompt, ${when}` });
       return true;
     }
     if (call2.name === "CronDelete") {
-      if (this.crons.delete(str2(call2.input.id) || str2(out.id))) return true;
+      if (this.crons.delete(str(call2.input.id) || str(out.id))) return true;
       const guess = [...this.unnamed].find((k2) => this.crons.has(k2));
       if (!guess) return false;
       this.unnamed.delete(guess);
       return this.crons.delete(guess);
     }
     if (call2.name === "CronList" && Array.isArray(out.jobs)) {
-      const listed = new Set(out.jobs.map((j2) => str2(j2.id)));
+      const listed = new Set(out.jobs.map((j2) => str(j2.id)));
       let changed = false;
       for (const id3 of [...this.crons.keys()]) if (!listed.has(id3)) changed = this.crons.delete(id3) || changed;
       for (const j2 of out.jobs) {
-        const id3 = str2(j2.id);
+        const id3 = str(j2.id);
         if (!id3 || this.crons.has(id3)) continue;
-        this.crons.set(id3, { id: `schedule-cron-${id3}`, due: now + CRON_EXPIRY_MS, description: `Scheduled prompt, ${str2(j2.humanSchedule) || str2(j2.cron)}` });
+        this.crons.set(id3, { id: `schedule-cron-${id3}`, due: now + CRON_EXPIRY_MS, description: `Scheduled prompt, ${str(j2.humanSchedule) || str(j2.cron)}` });
         changed = true;
       }
       return changed;
@@ -111938,6 +111982,34 @@ var ClaudeSchedules = class _ClaudeSchedules {
   }
 };
 
+// packages/agent-host/src/adapters/background-events.ts
+var BACKGROUND_SUMMARY_CHARS = 300;
+function endedSummary(text2) {
+  const summary = (text2 ?? "").slice(0, BACKGROUND_SUMMARY_CHARS);
+  return summary ? { summary } : {};
+}
+var BackgroundEvents = class {
+  constructor(sessionId) {
+    this.sessionId = sessionId;
+  }
+  sessionId;
+  last = "[]";
+  event(live2, ended = [], snapshot2 = false) {
+    const key = JSON.stringify(live2);
+    if (key === this.last && ended.length === 0 && !snapshot2) return [];
+    this.last = key;
+    return [
+      {
+        type: "background_tasks",
+        ...snapshot2 ? { snapshot: true } : {},
+        sessionId: this.sessionId,
+        live: live2,
+        ...ended.length ? { ended } : {}
+      }
+    ];
+  }
+};
+
 // packages/agent-host/src/adapters/claude/background-tracker.ts
 function taskKind(type) {
   if (/agent|teammate/.test(type)) return "agent";
@@ -111946,11 +112018,6 @@ function taskKind(type) {
   return "other";
 }
 var ClaudeBackgroundTracker = class {
-  constructor(sessionId, now = Date.now) {
-    this.sessionId = sessionId;
-    this.schedules = new ClaudeSchedules(now);
-  }
-  sessionId;
   /** Ids in the last level, in its order. */
   live = [];
   /** Every id the level ever listed — only those are background work (a foreground task's ending is its card's). */
@@ -111958,6 +112025,12 @@ var ClaudeBackgroundTracker = class {
   info = /* @__PURE__ */ new Map();
   /** Timers the CLI holds in this process for the session (`ClaudeSchedules`), listed with the tasks */
   schedules;
+  /** The events, by the rule both adapters share (`BackgroundEvents`): a repeat of the last list is not sent */
+  events;
+  constructor(sessionId, now = Date.now) {
+    this.schedules = new ClaudeSchedules(now);
+    this.events = new BackgroundEvents(sessionId);
+  }
   /** When the earliest scheduled wake-up is due (epoch ms), for a look then (`tick`); null with none */
   nextDue() {
     return this.schedules.nextDue();
@@ -111967,7 +112040,7 @@ var ClaudeBackgroundTracker = class {
    * (`ClaudeSchedules.recover`); the new level when that found any
    */
   recover(messages2) {
-    return this.schedules.recover(messages2) ? [this.event()] : [];
+    return this.schedules.recover(messages2) ? this.event() : [];
   }
   /**
    * The tasks the previous host last saw running in an adopted process (#648, `ProcessSource.adopt.backgroundTasks`).
@@ -111993,66 +112066,65 @@ var ClaudeBackgroundTracker = class {
   }
   /** Drops the wake-ups whose time has passed; the new level when that changed anything */
   tick() {
-    return this.schedules.prune() ? [this.event()] : [];
+    return this.schedules.prune() ? this.event() : [];
   }
   push(m) {
-    if (str2(m.type) === "assistant" || str2(m.type) === "user") {
+    if (str(m.type) === "assistant" || str(m.type) === "user") {
       const changed = this.schedules.push(m);
-      return changed ? [this.event()] : [];
+      return changed ? this.event() : [];
     }
-    if (str2(m.type) !== "system") return [];
-    const subtype = str2(m.subtype);
+    if (str(m.type) !== "system") return [];
+    const subtype = str(m.subtype);
     if (subtype === "background_tasks_changed") {
       const tasks = Array.isArray(m.tasks) ? m.tasks : [];
       this.live = [];
       for (const t of tasks) {
-        const id3 = str2(t.task_id);
+        const id3 = str(t.task_id);
         if (!id3) continue;
         const prev = this.info.get(id3);
         this.info.set(id3, {
           ...prev,
-          kind: taskKind(str2(t.task_type)),
-          description: str2(t.description, prev?.description ?? ""),
+          kind: taskKind(str(t.task_type)),
+          description: str(t.description, prev?.description ?? ""),
           ...t.ambient === true ? { ambient: true } : { ambient: void 0 }
         });
         this.live.push(id3);
         this.seen.add(id3);
       }
-      return [this.event(void 0, true)];
+      return this.event(void 0, true);
     }
     if (subtype === "task_started" || subtype === "task_updated") {
-      const id3 = str2(m.task_id);
+      const id3 = str(m.task_id);
       const prev = this.info.get(id3);
       if (!id3) return [];
       if (subtype === "task_started") {
-        const callId = str2(m.tool_use_id);
+        const callId = str(m.tool_use_id);
         const depth = typeof m.spawn_depth === "number" ? m.spawn_depth : 1;
         this.info.set(id3, {
           ...prev,
-          kind: str2(m.task_type) ? taskKind(str2(m.task_type)) : prev?.kind ?? "other",
-          description: prev?.description || str2(m.description),
+          kind: str(m.task_type) ? taskKind(str(m.task_type)) : prev?.kind ?? "other",
+          description: prev?.description || str(m.description),
           ...callId ? { parentCallId: callId } : {},
           ...m.owned_by_subagent === true || depth > 1 ? { nested: true } : {},
           ...m.ambient === true ? { ambient: true } : {}
         });
       } else {
-        const description = str2(m.patch?.description);
+        const description = str(m.patch?.description);
         if (!prev || !description) return [];
         this.info.set(id3, { ...prev, description });
       }
-      return this.live.includes(id3) ? [this.event()] : [];
+      return this.live.includes(id3) ? this.event() : [];
     }
     if (subtype === "task_notification") {
-      const id3 = str2(m.task_id);
+      const id3 = str(m.task_id);
       const known = this.info.get(id3);
       this.info.delete(id3);
       if (!this.seen.has(id3)) return [];
       this.seen.delete(id3);
       this.live = this.live.filter((x) => x !== id3);
-      const raw = str2(m.status);
+      const raw = str(m.status);
       const status = raw === "failed" || raw === "stopped" ? raw : "completed";
-      const summary = str2(m.summary).slice(0, 300);
-      return [this.event([{ ...this.entry(id3, known), status, ...summary ? { summary } : {} }])];
+      return this.event([{ ...this.entry(id3, known), status, ...endedSummary(str(m.summary)) }]);
     }
     return [];
   }
@@ -112068,7 +112140,7 @@ var ClaudeBackgroundTracker = class {
     this.live = [];
     this.info.clear();
     this.seen.clear();
-    return [this.event(ended)];
+    return this.event(ended);
   }
   entry(id3, i) {
     const kind = i?.kind ?? "other";
@@ -112085,20 +112157,14 @@ var ClaudeBackgroundTracker = class {
     };
   }
   event(ended, snapshot2) {
-    return {
-      type: "background_tasks",
-      ...snapshot2 ? { snapshot: snapshot2 } : {},
-      sessionId: this.sessionId,
-      live: [...this.live.map((id3) => this.entry(id3, this.info.get(id3))), ...this.schedules.live()],
-      ...ended ? { ended } : {}
-    };
+    return this.events.event([...this.live.map((id3) => this.entry(id3, this.info.get(id3))), ...this.schedules.live()], ended, snapshot2);
   }
 };
 
 // packages/agent-host/src/adapters/claude/cli-messages.ts
 function conversationResetEvents(m, sessionId) {
   const out = [];
-  const trigger = str2(m.trigger);
+  const trigger = str(m.trigger);
   out.push({ type: "conversation_reset", sessionId, ...trigger ? { trigger } : {} });
   return out;
 }
@@ -112109,16 +112175,16 @@ function activeGoalEvents(m, sessionId) {
     type: "goal",
     sessionId,
     goal: v ? {
-      objective: str2(v.condition),
+      objective: str(v.condition),
       status: "active",
       ...typeof v.iterations === "number" ? { iterations: v.iterations } : {},
-      ...str2(v.last_reason) ? { reason: str2(v.last_reason) } : {}
+      ...str(v.last_reason) ? { reason: str(v.last_reason) } : {}
     } : null
   });
   return out;
 }
 function systemEvents(m, sessionId) {
-  switch (str2(m.subtype)) {
+  switch (str(m.subtype)) {
     case "informational":
       return informationalEvents(m, sessionId);
     case "notification":
@@ -112137,8 +112203,8 @@ function systemEvents(m, sessionId) {
 }
 function informationalEvents(m, sessionId) {
   const out = [];
-  const text2 = str2(m.content).trim();
-  const level = str2(m.level);
+  const text2 = str(m.content).trim();
+  const level = str(m.level);
   if (text2 && level !== "info") {
     const hook = /\bblocked by hook\b/.test(text2);
     out.push({
@@ -112155,10 +112221,10 @@ function informationalEvents(m, sessionId) {
 }
 function notificationEvents(m, sessionId) {
   const out = [];
-  const text2 = str2(m.text).trim();
-  if (!text2 || str2(m.key) === "error-compacting-conversation") return out;
-  const color = str2(m.color);
-  const priority = str2(m.priority);
+  const text2 = str(m.text).trim();
+  if (!text2 || str(m.key) === "error-compacting-conversation") return out;
+  const color = str(m.color);
+  const priority = str(m.priority);
   const level = color === "error" ? "error" : color === "warning" || priority === "high" || priority === "immediate" ? "warning" : "info";
   out.push({ type: "notice", sessionId, level, text: text2, from: "Claude Code", label: "notice" });
   return out;
@@ -112168,7 +112234,7 @@ function apiRetryEvents(m, sessionId) {
   const status = typeof m.error_status === "number" ? `${m.error_status} ` : "";
   const delay = typeof m.retry_delay_ms === "number" ? ` in ${m.retry_delay_ms}ms` : "";
   console.error(
-    `[claude] ${sessionId.slice(0, 8)} retrying after: ${status}${str2(m.error, "connection error")} (attempt ${String(m.attempt ?? "?")}/${String(m.max_retries ?? "?")}${delay})`
+    `[claude] ${sessionId.slice(0, 8)} retrying after: ${status}${str(m.error, "connection error")} (attempt ${String(m.attempt ?? "?")}/${String(m.max_retries ?? "?")}${delay})`
   );
   out.push({ type: "activity", sessionId, activity: "retrying" });
   return out;
@@ -112176,14 +112242,14 @@ function apiRetryEvents(m, sessionId) {
 function statusEvents(m, sessionId) {
   const out = [];
   out.push({ type: "activity", sessionId, activity: m.status === "compacting" ? "compacting" : null });
-  if (str2(m.compact_result) === "failed") {
-    out.push({ type: "compaction", sessionId, failed: true, reason: str2(m.compact_error, "Unknown reason") });
+  if (str(m.compact_result) === "failed") {
+    out.push({ type: "compaction", sessionId, failed: true, reason: str(m.compact_error, "Unknown reason") });
   }
   return out;
 }
 function localCommandOutputEvents(m, sessionId) {
   const out = [];
-  const content = str2(m.content);
+  const content = str(m.content);
   if (content) out.push({ type: "message_delta", sessionId, role: "assistant", text: content });
   return out;
 }
@@ -112204,7 +112270,7 @@ function compactBoundaryEvents(m, sessionId) {
 function textOfContent(content) {
   if (typeof content === "string") return content;
   if (!Array.isArray(content)) return "";
-  return content.filter((b2) => str2(b2?.type) === "text").map((b2) => str2(b2.text)).join("");
+  return content.filter((b2) => str(b2?.type) === "text").map((b2) => str(b2.text)).join("");
 }
 var ClaudeGoalTracker = class {
   constructor(sessionId) {
@@ -112232,13 +112298,13 @@ var ClaudeGoalTracker = class {
   }
   /** Reads one parent-stream message. `streamed`: this assistant message's body came as deltas, i.e. a model call. */
   push(m, opts) {
-    const type = str2(m.type);
+    const type = str(m.type);
     if (type === "active_goal") {
       this.announced = true;
       return [];
     }
     if (this.announced) return [];
-    if (type === "stream_event" && str2(m.event?.type) === "message_start") {
+    if (type === "stream_event" && str(m.event?.type) === "message_start") {
       if (this.goal) this.drove = true;
       return [];
     }
@@ -112260,7 +112326,7 @@ var ClaudeGoalTracker = class {
     if (type === "result") {
       const drove = this.drove;
       this.drove = false;
-      const success2 = str2(m.subtype) === "success" && m.is_error !== true;
+      const success2 = str(m.subtype) === "success" && m.is_error !== true;
       if (this.goal && drove && success2 && !opts.interrupted) return this.set(null);
     }
     return [];
@@ -112318,7 +112384,7 @@ function mcpImageEvents(sessionId, content) {
   if (!Array.isArray(content)) return [];
   const out = [];
   for (const raw of content) {
-    const part = typeof raw === "object" && raw !== null ? raw : {};
+    const part = asObj(raw);
     if (part.type !== "image") continue;
     const data = typeof part.data === "string" ? part.data : "";
     const mime = typeof part.mimeType === "string" ? part.mimeType : "";
@@ -112348,7 +112414,7 @@ function stepStatus(raw) {
 }
 function planUpdate(sessionId, raw, textField) {
   const steps = (Array.isArray(raw) ? raw : []).map((s) => {
-    const it2 = typeof s === "object" && s !== null ? s : {};
+    const it2 = asObj(s);
     const text2 = it2[textField];
     return { text: typeof text2 === "string" ? text2 : "", status: stepStatus(it2.status) };
   });
@@ -112356,7 +112422,7 @@ function planUpdate(sessionId, raw, textField) {
 }
 function todoWritePlan(sessionId, name, input) {
   if (name !== "TodoWrite") return [];
-  const todos = (typeof input === "object" && input !== null ? input : {}).todos;
+  const todos = asObj(input).todos;
   return Array.isArray(todos) ? [planUpdate(sessionId, todos, "content")] : [];
 }
 
@@ -112372,14 +112438,14 @@ function toolSummary(name, input) {
   if (run4) return toolSummary(run4.name, run4.input);
   const paths = [];
   let title = name;
-  if (name === "Bash") title = str2(input.command, name);
+  if (name === "Bash") title = str(input.command, name);
   else if (FILE_EDIT_TOOLS.has(name) || name === "Read") {
-    const p = str2(input.file_path ?? input.notebook_path);
+    const p = str(input.file_path ?? input.notebook_path);
     if (p) paths.push(p);
     title = `${name}: ${p || "?"}`;
-  } else if (name === "Grep" || name === "Glob") title = `${name}: ${str2(input.pattern)}`;
-  else if (isCentraluTool({ name }, "ask_project")) title = str2(input.project).trim() || name;
-  else if (launchesSubagent(name)) title = str2(input.description, name);
+  } else if (name === "Grep" || name === "Glob") title = `${name}: ${str(input.pattern)}`;
+  else if (isCentraluTool({ name }, "ask_project")) title = str(input.project).trim() || name;
+  else if (launchesSubagent(name)) title = str(input.description, name);
   const parts = mcpNameParts(name);
   const mark = parts ? centraluMark(parts.server, parts.tool, input) : null;
   return { tool: name, title: mark?.title ?? title, paths, ...mark ? { centralu: mark.centralu } : {} };
@@ -112405,29 +112471,29 @@ ${report}` : report;
 function resultOutput(content) {
   if (typeof content === "string") return content;
   if (!Array.isArray(content)) return content == null ? "" : JSON.stringify(content);
-  return content.filter((b2) => str2(b2?.type) !== "image" && str2(b2?.source?.type) !== "base64").map((b2) => str2(b2?.type) === "text" ? str2(b2.text) : JSON.stringify(b2)).join("\n");
+  return content.filter((b2) => str(b2?.type) !== "image" && str(b2?.source?.type) !== "base64").map((b2) => str(b2?.type) === "text" ? str(b2.text) : JSON.stringify(b2)).join("\n");
 }
 function claudeFileChange(name, input, isNew) {
-  const path2 = str2(input.file_path ?? input.notebook_path);
+  const path2 = str(input.file_path ?? input.notebook_path);
   if (name === "Edit") {
-    const diff2 = [diffLines("-", str2(input.old_string)), diffLines("+", str2(input.new_string))].filter(Boolean).join("\n");
+    const diff2 = [diffLines("-", str(input.old_string)), diffLines("+", str(input.new_string))].filter(Boolean).join("\n");
     return { path: path2, diff: input.replace_all === true && diff2 ? `(every occurrence)
 ${diff2}` : diff2 };
   }
   if (name === "Write") {
-    const content = str2(input.content);
+    const content = str(input.content);
     if (isNew === true) return { path: path2, diff: diffLines("+", content), change: "add" };
     const head = isNew === false ? "(replaces the whole file)" : "(writes the whole file)";
     return { path: path2, diff: content ? `${head}
 ${content.replace(/\n$/, "")}` : "" };
   }
-  const mode = str2(input.edit_mode);
-  const diff = diffLines("+", str2(input.new_source));
-  return { path: path2, diff: mode === "delete" ? `(deletes cell ${str2(input.cell_id) || "?"})` : mode === "insert" ? `(inserts a cell)
+  const mode = str(input.edit_mode);
+  const diff = diffLines("+", str(input.new_source));
+  return { path: path2, diff: mode === "delete" ? `(deletes cell ${str(input.cell_id) || "?"})` : mode === "insert" ? `(inserts a cell)
 ${diff}` : diff };
 }
 function approvalDetail(name, input, cwd, isNew) {
-  if (name === "Bash") return { kind: "command", command: str2(input.command), cwd, ...input.dangerouslyDisableSandbox === true ? { unsandboxed: true } : {} };
+  if (name === "Bash") return { kind: "command", command: str(input.command), cwd, ...input.dangerouslyDisableSandbox === true ? { unsandboxed: true } : {} };
   if (FILE_EDIT_TOOLS.has(name)) {
     const change = claudeFileChange(name, input, isNew);
     return fileEditDetail([change.diff ? change : { ...change, diff: JSON.stringify(input) }]);
@@ -112438,20 +112504,20 @@ function approvalDetail(name, input, cwd, isNew) {
 // packages/agent-host/src/adapters/claude/model-messages.ts
 function backgroundLaunch(m) {
   const r = m.tool_use_result ?? {};
-  if (str2(r.status) !== "async_launched" || !str2(r.agentId)) return null;
-  const blocks = (m.message?.content ?? []).filter((b2) => str2(b2.type) === "tool_result");
-  return blocks.length === 1 ? str2(blocks[0]?.tool_use_id) || null : null;
+  if (str(r.status) !== "async_launched" || !str(r.agentId)) return null;
+  const blocks = (m.message?.content ?? []).filter((b2) => str(b2.type) === "tool_result");
+  return blocks.length === 1 ? str(blocks[0]?.tool_use_id) || null : null;
 }
 function streamEventEvents(m, sessionId) {
   const out = [];
   const e = m.event;
-  if (str2(e?.type) === "content_block_delta") {
+  if (str(e?.type) === "content_block_delta") {
     const d2 = e?.delta;
-    if (str2(d2?.type) === "text_delta") {
-      out.push({ type: "message_delta", sessionId, role: "assistant", text: str2(d2?.text) });
+    if (str(d2?.type) === "text_delta") {
+      out.push({ type: "message_delta", sessionId, role: "assistant", text: str(d2?.text) });
     }
-    if (str2(d2?.type) === "thinking_delta") {
-      const text2 = str2(d2?.thinking);
+    if (str(d2?.type) === "thinking_delta") {
+      const text2 = str(d2?.thinking);
       const estTokens = typeof d2?.estimated_tokens === "number" ? d2.estimated_tokens : void 0;
       if (text2 || estTokens) {
         out.push({ type: "reasoning_delta", sessionId, ...text2 ? { text: text2 } : {}, ...estTokens ? { estTokens } : {} });
@@ -112464,21 +112530,21 @@ function assistantEvents(m, sessionId, opts) {
   const out = [];
   const content = m.message?.content ?? [];
   if (!opts?.reasoningStreamed) {
-    const thinking = content.filter((b2) => str2(b2.type) === "thinking").map((b2) => str2(b2.thinking)).join("");
+    const thinking = content.filter((b2) => str(b2.type) === "thinking").map((b2) => str(b2.thinking)).join("");
     if (thinking) out.push({ type: "reasoning_delta", sessionId, text: thinking });
   }
   if (!opts?.textStreamed) {
-    const text2 = content.filter((b2) => str2(b2.type) === "text").map((b2) => str2(b2.text)).join("");
+    const text2 = content.filter((b2) => str(b2.type) === "text").map((b2) => str(b2.text)).join("");
     if (text2) out.push({ type: "message_delta", sessionId, role: "assistant", text: text2 });
   }
   for (const block of content) {
-    if (str2(block.type) === "tool_use") {
-      const name = str2(block.name);
+    if (str(block.type) === "tool_use") {
+      const name = str(block.name);
       const input = block.input ?? {};
       out.push({
         type: "tool_call",
         sessionId,
-        callId: str2(block.id),
+        callId: str(block.id),
         summary: toolSummary(name, input),
         ...block.input !== void 0 ? { input: block.input } : {}
       });
@@ -112490,39 +112556,41 @@ function assistantEvents(m, sessionId, opts) {
     out.push({
       type: "usage_update",
       sessionId,
-      tokens: {
-        inputTokens: tokenCount(usage.input_tokens),
-        outputTokens: tokenCount(usage.output_tokens),
-        cacheReadTokens: tokenCount(usage.cache_read_input_tokens),
-        cacheCreationTokens: tokenCount(usage.cache_creation_input_tokens)
-      }
+      tokens: { ...requestInputTokens(usage), outputTokens: tokenCount(usage.output_tokens) }
     });
   }
   return out;
 }
+function requestInputTokens(usage) {
+  return {
+    inputTokens: tokenCount(usage.input_tokens),
+    cacheReadTokens: tokenCount(usage.cache_read_input_tokens),
+    cacheCreationTokens: tokenCount(usage.cache_creation_input_tokens)
+  };
+}
 function userEvents(m, sessionId) {
   const out = [];
   const content = m.message?.content ?? [];
   const launched = backgroundLaunch(m);
   if (launched) return [{ type: "tool_output_delta", sessionId, callId: launched, text: "Running in the background\n" }];
   const agent = m.tool_use_result ?? {};
-  const agentDone = str2(agent.status) === "completed" && str2(agent.agentId) && Array.isArray(agent.content) && content.filter((b2) => str2(b2.type) === "tool_result").length === 1 ? agentReport(
-    agent.content.map((b2) => str2(b2.text)).join("\n"),
+  const agentDone = str(agent.status) === "completed" && str(agent.agentId) && Array.isArray(agent.content) && content.filter((b2) => str(b2.type) === "tool_result").length === 1 ? agentReport(
+    agent.content.map((b2) => str(b2.text)).join("\n"),
     agentStats(agent.totalToolUseCount, agent.totalDurationMs)
   ) : null;
   for (const block of content) {
-    if (str2(block.type) === "tool_result") {
+    if (str(block.type) === "tool_result") {
       const c = block.content;
-      out.push(toolResultEvent(sessionId, str2(block.tool_use_id), block.is_error !== true, agentDone ?? resultOutput(c)));
+      out.push(toolResultEvent(sessionId, str(block.tool_use_id), block.is_error !== true, agentDone ?? resultOutput(c)));
       if (Array.isArray(c)) {
         for (const part of c) {
-          if (str2(part.type) !== "image") continue;
+          if (str(part.type) !== "image") continue;
           const source = part.source ?? {};
-          if (str2(source.type) !== "base64" || !str2(source.data)) {
-            out.push(undrawnImageEvent(sessionId, `Cannot display an image of this format yet (source: ${str2(source.type) || "none"})`));
+          if (str(source.type) !== "base64" || !str(source.data)) {
+            out.push(undrawnImageEvent(sessionId, `Cannot display an image of this format yet (source: ${str(source.type) || "none"})`));
             continue;
           }
-          out.push(inlineImageEvent(sessionId, str2(source.media_type), str2(source.data)));
+          out.push(inlineImageEvent(sessionId, str(source.media_type), str(source.data)));
         }
       }
     }
@@ -112543,7 +112611,7 @@ var ClaudeTaskPlan = class {
   /** A call was made; the plan tools are remembered until their result */
   call(callId, name, input) {
     if (name !== "TaskCreate" && name !== "TaskUpdate" && name !== "TaskList") return;
-    this.open.set(callId, { name, input: typeof input === "object" && input !== null ? input : {} });
+    this.open.set(callId, { name, input: asObj(input) });
     if (this.open.size > 64) this.open.delete(this.open.keys().next().value);
   }
   /**
@@ -112557,21 +112625,21 @@ var ClaudeTaskPlan = class {
     if (!ok) return [];
     if (call2.name === "TaskCreate") {
       const task = record2?.task ?? {};
-      const id3 = str2(task.id) || /^Task #(\S+) created/.exec(output)?.[1] || "";
+      const id3 = str(task.id) || /^Task #(\S+) created/.exec(output)?.[1] || "";
       if (!id3) return [];
-      this.tasks.set(id3, { text: str2(call2.input.subject) || str2(task.subject), status: "pending" });
+      this.tasks.set(id3, { text: str(call2.input.subject) || str(task.subject), status: "pending" });
     } else if (call2.name === "TaskUpdate") {
-      const id3 = str2(call2.input.taskId);
-      const status = str2(call2.input.status);
+      const id3 = str(call2.input.taskId);
+      const status = str(call2.input.status);
       const known = this.tasks.get(id3);
       if (status === "deleted") this.tasks.delete(id3);
-      else if (known) this.tasks.set(id3, { text: str2(call2.input.subject) || known.text, status: status || known.status });
-      else if (str2(call2.input.subject)) this.tasks.set(id3, { text: str2(call2.input.subject), status: status || "pending" });
+      else if (known) this.tasks.set(id3, { text: str(call2.input.subject) || known.text, status: status || known.status });
+      else if (str(call2.input.subject)) this.tasks.set(id3, { text: str(call2.input.subject), status: status || "pending" });
       else return [];
     } else {
       if (!Array.isArray(record2?.tasks)) return [];
       this.tasks.clear();
-      for (const t of record2.tasks) if (str2(t.id)) this.tasks.set(str2(t.id), { text: str2(t.subject), status: str2(t.status) });
+      for (const t of record2.tasks) if (str(t.id)) this.tasks.set(str(t.id), { text: str(t.subject), status: str(t.status) });
     }
     return [planUpdate(this.sessionId, [...this.tasks.values()], "text")];
   }
@@ -112581,13 +112649,13 @@ var ClaudeTaskPlan = class {
 function rateLimitEvents(m, sessionId) {
   const out = [];
   const info = m.rate_limit_info ?? {};
-  if (str2(info.status) === "rejected") {
+  if (str(info.status) === "rejected") {
     const resetsAt = typeof info.resetsAt === "number" ? new Date(info.resetsAt * 1e3).toISOString() : void 0;
     out.push({
       type: "limit_reached",
       sessionId,
       resumeAt: resetsAt,
-      windowMins: str2(info.rateLimitType) === "five_hour" ? 300 : void 0
+      windowMins: str(info.rateLimitType) === "five_hour" ? 300 : void 0
     });
   }
   return out;
@@ -112610,12 +112678,12 @@ function resultEvents(m, sessionId) {
       }
     });
   }
-  if (str2(m.subtype) !== "success" || m.is_error === true) {
+  if (str(m.subtype) !== "success" || m.is_error === true) {
     const errors = Array.isArray(m.errors) ? m.errors.filter((x) => typeof x === "string" && x.length > 0) : [];
     out.push({
       type: "error",
       sessionId,
-      error: { code: "internal", message: str2(m.result) || errors.join("\n") || `Turn failed: ${str2(m.subtype)}`, retryable: true }
+      error: { code: "internal", message: str(m.result) || errors.join("\n") || `Turn failed: ${str(m.subtype)}`, retryable: true }
     });
   } else {
     out.push(m.structured_output === void 0 ? { type: "turn_complete", sessionId } : { type: "turn_complete", sessionId, output: m.structured_output });
@@ -112626,9 +112694,9 @@ function resultEvents(m, sessionId) {
 // packages/agent-host/src/adapters/claude/normalize.ts
 function normalizeMessage(msg, sessionId, opts) {
   const m = msg;
-  const type = str2(m.type);
+  const type = str(m.type);
   const out = [];
-  const parent = str2(m.parent_tool_use_id);
+  const parent = str(m.parent_tool_use_id);
   if (parent && (type === "assistant" || type === "user" || type === "stream_event")) {
     if (type === "stream_event") return out;
     return subagentSteps(sessionId, parent, normalizeMessage({ ...m, parent_tool_use_id: null }, sessionId));
@@ -112782,21 +112850,21 @@ var ClaudeStreamNormalizer = class {
    *                               falls back to the refusal's explanation, then its category.
    */
   refusalEvents(m) {
-    const subtype = str2(m.subtype);
-    const explanation = str2(m.api_refusal_explanation);
+    const subtype = str(m.subtype);
+    const explanation = str(m.api_refusal_explanation);
     if (subtype === "model_refusal_no_fallback") {
-      const category = str2(m.api_refusal_category);
-      this.refusal = str2(m.content).trim() || explanation || `The model declined to answer${category ? ` (${category})` : ""}`;
+      const category = str(m.api_refusal_category);
+      this.refusal = str(m.content).trim() || explanation || `The model declined to answer${category ? ` (${category})` : ""}`;
       return [];
     }
-    const from = str2(m.original_model, "the model");
-    const to = str2(m.fallback_model);
-    if (str2(m.scope) === "local") {
+    const from = str(m.original_model, "the model");
+    const to = str(m.fallback_model);
+    if (str(m.scope) === "local") {
       console.error(`[claude] ${this.sessionId.slice(0, 8)} a subagent's answer came from ${to} after ${from} declined`);
       return [];
     }
     if (!to) return [];
-    const text2 = str2(m.content).trim() || `${from} declined to answer, so Claude Code switched this session to ${to}${explanation ? `: ${explanation}` : ""}`;
+    const text2 = str(m.content).trim() || `${from} declined to answer, so Claude Code switched this session to ${to}${explanation ? `: ${explanation}` : ""}`;
     return [
       { type: "notice", sessionId: this.sessionId, level: "warning", text: text2, from: "Claude Code", label: "model switch" },
       { type: "settings_changed", sessionId: this.sessionId, ...this.settings(), model: to, by: "tool" }
@@ -112814,7 +112882,7 @@ var ClaudeStreamNormalizer = class {
    */
   withRequest(m, events2, subagent) {
     const message = m.message ?? {};
-    const id3 = str2(message.id);
+    const id3 = str(message.id);
     const usage = message.usage;
     const fresh = !!usage && !(id3 && this.requestsSeen.includes(id3));
     if (!subagent) {
@@ -112830,10 +112898,8 @@ var ClaudeStreamNormalizer = class {
     this.requestsSeen.push(id3);
     if (this.requestsSeen.length > 32) this.requestsSeen.shift();
     const request = {
-      inputTokens: tokenCount(usage.input_tokens),
-      cacheReadTokens: tokenCount(usage.cache_read_input_tokens),
-      cacheCreationTokens: tokenCount(usage.cache_creation_input_tokens),
-      ...subagent ? { agent: str2(m.parent_tool_use_id) } : {},
+      ...requestInputTokens(usage),
+      ...subagent ? { agent: str(m.parent_tool_use_id) } : {},
       ...ttlOf(usage.cache_creation)
     };
     if (subagent) {
@@ -112860,7 +112926,7 @@ var ClaudeStreamNormalizer = class {
    * session's plan. The message's `tool_use_result` is read only when it carries one result.
    */
   followTasks(m, events2) {
-    const results = (m.message?.content ?? []).filter((b2) => str2(b2?.type) === "tool_result");
+    const results = (m.message?.content ?? []).filter((b2) => str(b2?.type) === "tool_result");
     const record2 = results.length === 1 && typeof m.tool_use_result === "object" && m.tool_use_result !== null ? m.tool_use_result : void 0;
     const out = [];
     for (const e of events2) {
@@ -112888,16 +112954,16 @@ var ClaudeStreamNormalizer = class {
   }
   push(msg) {
     const m = msg;
-    const type = str2(m.type);
-    const subagent = str2(m.parent_tool_use_id) !== "";
-    this.unmapped.note(type === "system" ? `system/${str2(m.subtype)}` : type);
+    const type = str(m.type);
+    const subagent = str(m.parent_tool_use_id) !== "";
+    this.unmapped.note(type === "system" ? `system/${str(m.subtype)}` : type);
     const tasks = this.tasks.push(m);
-    if (type === "system" && str2(m.subtype) === "task_notification") {
-      const callId = str2(m.tool_use_id);
+    if (type === "system" && str(m.subtype) === "task_notification") {
+      const callId = str(m.tool_use_id);
       if (!this.background.delete(callId)) return tasks;
-      const status = str2(m.status, "completed");
+      const status = str(m.status, "completed");
       const usage = m.usage ?? {};
-      const output = agentReport(str2(m.summary), agentStats(usage.tool_uses, usage.duration_ms, status));
+      const output = agentReport(str(m.summary), agentStats(usage.tool_uses, usage.duration_ms, status));
       const done = toolResultEvent(this.sessionId, callId, status === "completed", output);
       if (!this.textStreamed && !this.reasoningStreamed) return [...tasks, done];
       this.deferred.push(done);
@@ -112907,7 +112973,7 @@ var ClaudeStreamNormalizer = class {
       const launched = backgroundLaunch(m);
       if (launched) this.background.add(launched);
     }
-    if (type === "system" && /^model_refusal_(no_)?fallback$/.test(str2(m.subtype))) return [...tasks, ...this.refusalEvents(m)];
+    if (type === "system" && /^model_refusal_(no_)?fallback$/.test(str(m.subtype))) return [...tasks, ...this.refusalEvents(m)];
     let events2 = [
       ...tasks,
       ...normalizeMessage(msg, this.sessionId, {
@@ -112936,9 +113002,9 @@ var ClaudeStreamNormalizer = class {
     }
     if (type === "stream_event") {
       const e = m.event ?? {};
-      if (str2(e.type) === "message_start") this.streamMessageId = str2(e.message?.id) || void 0;
+      if (str(e.type) === "message_start") this.streamMessageId = str(e.message?.id) || void 0;
     }
-    const wholeId = type === "assistant" ? str2(m.message?.id) || void 0 : void 0;
+    const wholeId = type === "assistant" ? str(m.message?.id) || void 0 : void 0;
     const messageId = type === "stream_event" ? this.streamMessageId : wholeId;
     if (messageId) events2 = events2.map((e) => e.type === "message_delta" && !e.messageId ? { ...e, messageId } : e);
     events2.push(
@@ -112955,7 +113021,7 @@ var ClaudeStreamNormalizer = class {
     }
     if (type === "result" && this.stopping) {
       this.stopping = false;
-      if (str2(m.subtype) === "error_during_execution") events2 = events2.filter((e) => e.type !== "error");
+      if (str(m.subtype) === "error_during_execution") events2 = events2.filter((e) => e.type !== "error");
     }
     if ((type === "assistant" || type === "result") && this.deferred.length > 0) events2.push(...this.deferred.splice(0));
     return events2;
@@ -115291,13 +115357,13 @@ async function lastCompactSummary(threadId, sessionsDir) {
 
 // packages/agent-host/src/adapters/codex/items.ts
 function resultSummary(item) {
-  const direct = str2(item.aggregatedOutput) || str2(item.output);
+  const direct = str(item.aggregatedOutput) || str(item.output);
   if (direct) return direct;
-  const err = str2(asObj(item.error).message);
+  const err = str(asObj(item.error).message);
   if (err) return err;
   const content = asObj(item.result).content;
   if (Array.isArray(content)) {
-    const text2 = content.map((c) => str2(asObj(c).text)).filter(Boolean).join("\n");
+    const text2 = content.map((c) => str(asObj(c).text)).filter(Boolean).join("\n");
     if (text2) return text2;
   }
   const structured = asObj(item.result).structuredContent;
@@ -115311,7 +115377,7 @@ function resultSummary(item) {
   return "";
 }
 function codexItemOk(item) {
-  const status = str2(item.status);
+  const status = str(item.status);
   return status !== "failed" && status !== "declined" && status !== "interrupted" && item.success !== false;
 }
 var ITEM_OUTCOME = /* @__PURE__ */ new Set([
@@ -115335,9 +115401,9 @@ function itemInput(item) {
   return Object.fromEntries(Object.entries(item).filter(([k2, v]) => !ITEM_OUTCOME.has(k2) && v !== null && v !== void 0));
 }
 function itemSummary(item) {
-  const type = str2(item.type);
+  const type = str(item.type);
   if (type === "commandExecution") {
-    const cmd = str2(item.command);
+    const cmd = str(item.command);
     return { tool: "Bash", title: cmd, paths: [] };
   }
   if (type === "fileChange") {
@@ -115345,8 +115411,8 @@ function itemSummary(item) {
     return { tool: "Edit", title: paths.join(", ") || "Edit files", paths };
   }
   if (type === "mcpToolCall") {
-    const tool = str2(item.tool) || str2(asObj(item.invocation).tool);
-    const server2 = str2(item.server);
+    const tool = str(item.tool) || str(asObj(item.invocation).tool);
+    const server2 = str(item.server);
     if (isCentraluTool({ server: server2, tool }, "centralu_run")) {
       const run4 = centraluRunCommand(jsonObject(item.arguments ?? asObj(item.invocation).arguments));
       if (run4) {
@@ -115354,12 +115420,12 @@ function itemSummary(item) {
       }
     }
     if (isCentraluTool({ server: server2, tool }, "ask_project")) {
-      const project2 = str2(jsonObject(item.arguments ?? asObj(item.invocation).arguments).project);
+      const project2 = str(jsonObject(item.arguments ?? asObj(item.invocation).arguments).project);
       const mark2 = centraluMark(server2, tool, {});
       return { tool, title: project2 || tool, paths: [], ...mark2 ? { centralu: mark2.centralu } : {} };
     }
     const args = argsPreview(item.arguments ?? asObj(item.invocation).arguments);
-    const name = [server2, tool].filter(Boolean).join(": ") || str2(item.title) || "MCP tool";
+    const name = [server2, tool].filter(Boolean).join(": ") || str(item.title) || "MCP tool";
     const mark = tool ? centraluMark(server2, tool, jsonObject(item.arguments ?? asObj(item.invocation).arguments)) : null;
     return {
       tool: tool || "MCP",
@@ -115369,13 +115435,13 @@ function itemSummary(item) {
     };
   }
   if (type === "webSearch") {
-    return { tool: "WebSearch", title: str2(item.query), paths: [] };
+    return { tool: "WebSearch", title: str(item.query), paths: [] };
   }
   if (type === "collabAgentToolCall") {
-    const tool = str2(item.tool) || type;
-    return { tool, title: firstLine2(str2(item.prompt)) || tool, paths: [] };
+    const tool = str(item.tool) || type;
+    return { tool, title: firstLine2(str(item.prompt)) || tool, paths: [] };
   }
-  return { tool: type || "tool", title: str2(item.title) || type, paths: [] };
+  return { tool: type || "tool", title: str(item.title) || type, paths: [] };
 }
 function argsPreview(raw) {
   let value = raw;
@@ -115394,12 +115460,12 @@ function argsPreview(raw) {
 }
 function fileChangesOf(item) {
   const changes = Array.isArray(item.changes) ? item.changes : [];
-  return changes.map((c) => ({ path: str2(asObj(c).path), diff: str2(asObj(c).diff), ...changeKindOf(asObj(asObj(c).kind)) }));
+  return changes.map((c) => ({ path: str(asObj(c).path), diff: str(asObj(c).diff), ...changeKindOf(asObj(asObj(c).kind)) }));
 }
 function changeKindOf(kind) {
-  const type = str2(kind.type);
+  const type = str(kind.type);
   if (type === "add" || type === "delete") return { change: type };
-  if (type === "update") return str2(kind.move_path) ? { change: "move", movePath: str2(kind.move_path) } : { change: "update" };
+  if (type === "update") return str(kind.move_path) ? { change: "move", movePath: str(kind.move_path) } : { change: "update" };
   return {};
 }
 
@@ -115533,10 +115599,10 @@ function warnImpossibleContext(used, window2) {
 
 // packages/agent-host/src/adapters/codex/normalize.ts
 function goalFromCodex(g5) {
-  if (str2(g5.status) === "complete") return null;
+  if (str(g5.status) === "complete") return null;
   return {
-    objective: str2(g5.objective),
-    status: str2(g5.status) || "active",
+    objective: str(g5.objective),
+    status: str(g5.status) || "active",
     ...typeof g5.tokenBudget === "number" ? { tokenBudget: g5.tokenBudget } : {},
     ...typeof g5.tokensUsed === "number" ? { tokensUsed: g5.tokensUsed } : {}
   };
@@ -115547,7 +115613,7 @@ var CompactionMarks = class {
   /** Whether this notification's compaction marker should be emitted */
   admit(n) {
     const kind = n.method === "thread/compacted" ? "notice" : "item";
-    const turn = str2(asObj(n.params).turnId);
+    const turn = str(asObj(n.params).turnId);
     const waiting = this.open.get(turn);
     if (waiting && waiting.kind !== kind) {
       if (--waiting.count === 0) this.open.delete(turn);
@@ -115573,7 +115639,7 @@ function normalizeNotification(sessionId, n) {
      * polling it again."
      */
     case "item/agentMessage/delta":
-      return [{ type: "message_delta", sessionId, role: "assistant", text: str2(p.delta) || str2(p.text), ...messageIdOf(p.itemId) }];
+      return [{ type: "message_delta", sessionId, role: "assistant", text: str(p.delta) || str(p.text), ...messageIdOf(p.itemId) }];
     /*
      * Reasoning summary (measured for #58). This stream only arrives if model_reasoning_summary
      * is turned on in the thread settings — index.ts turns it on. Measured shape:
@@ -115584,7 +115650,7 @@ function normalizeNotification(sessionId, n) {
      * twice (the same rule as agentMessage).
      */
     case "item/reasoning/summaryTextDelta": {
-      const text2 = str2(p.delta);
+      const text2 = str(p.delta);
       return text2 ? [{ type: "reasoning_delta", sessionId, text: text2 }] : [];
     }
     case "item/reasoning/summaryPartAdded":
@@ -115607,25 +115673,25 @@ function normalizeNotification(sessionId, n) {
      * the assumption that summing the deltas equals the full output does not hold.)
      */
     case "item/commandExecution/outputDelta": {
-      const text2 = str2(p.delta);
-      return text2 ? [{ type: "tool_output_delta", sessionId, callId: str2(p.itemId), text: text2 }] : [];
+      const text2 = str(p.delta);
+      return text2 ? [{ type: "tool_output_delta", sessionId, callId: str(p.itemId), text: text2 }] : [];
     }
     case "item/started": {
       const item = asObj(p.item);
-      const type = str2(item.type);
+      const type = str(item.type);
       if (type === "userMessage" || type === "reasoning" || type === "agentMessage") return [];
       if (type === "contextCompaction") return [{ type: "activity", sessionId, activity: "compacting" }];
       if (type === "enteredReviewMode") return [{ type: "activity", sessionId, activity: "reviewing" }];
       if (type === "exitedReviewMode") return [{ type: "activity", sessionId, activity: null }];
       if (type === "imageView") return [];
       const s = itemSummary(item);
-      return [{ type: "tool_call", sessionId, callId: str2(item.id), summary: s, input: itemInput(item) }];
+      return [{ type: "tool_call", sessionId, callId: str(item.id), summary: s, input: itemInput(item) }];
     }
     case "item/completed": {
       const item = asObj(p.item);
-      const type = str2(item.type);
+      const type = str(item.type);
       if (type === "agentMessage") {
-        return str2(item.text) ? [{ type: "message_delta", sessionId, role: "assistant", text: "", ...messageIdOf(item.id) }] : [];
+        return str(item.text) ? [{ type: "message_delta", sessionId, role: "assistant", text: "", ...messageIdOf(item.id) }] : [];
       }
       if (type === "userMessage" || type === "reasoning") return [];
       if (type === "contextCompaction") {
@@ -115637,16 +115703,16 @@ function normalizeNotification(sessionId, n) {
       if (type === "exitedReviewMode") return [{ type: "activity", sessionId, activity: null }];
       if (type === "enteredReviewMode") return [];
       if (type === "imageView") {
-        const path2 = str2(item.path);
+        const path2 = str(item.path);
         return path2 ? [{ type: "message_image", sessionId, mime: "", data: "", path: path2 }] : [];
       }
       const s = itemSummary(item);
-      const ending = str2(item.status) === "declined" ? "declined" : str2(item.status) === "interrupted" ? "interrupted" : void 0;
-      const out = [toolResultEvent(sessionId, str2(item.id), codexItemOk(item), resultSummary(item), ending)];
+      const ending = str(item.status) === "declined" ? "declined" : str(item.status) === "interrupted" ? "interrupted" : void 0;
+      const out = [toolResultEvent(sessionId, str(item.id), codexItemOk(item), resultSummary(item), ending)];
       if (type === "mcpToolCall") out.push(...mcpImageEvents(sessionId, asObj(item.result).content));
       const moved = type === "fileChange" ? fileChangesOf(item).flatMap((c) => c.movePath ? [c.movePath] : []) : [];
       const paths = [...s.paths, ...moved];
-      if (paths.length > 0 && str2(item.status) !== "declined") out.push({ type: "files_touched", sessionId, paths });
+      if (paths.length > 0 && str(item.status) !== "declined") out.push({ type: "files_touched", sessionId, paths });
       return out;
     }
     /*
@@ -115673,16 +115739,16 @@ function normalizeNotification(sessionId, n) {
     case "turn/completed": {
       const turn = asObj(p.turn);
       const failure3 = asObj(turn.error);
-      if (str2(turn.status) === "interrupted" && !failure3.message) return [{ type: "state_change", sessionId, state: "waiting_input", reason: "interrupted" }];
-      if (str2(turn.status) !== "failed" && !failure3.message) return [{ type: "turn_complete", sessionId }];
-      const detail = str2(failure3.additionalDetails);
+      if (str(turn.status) === "interrupted" && !failure3.message) return [{ type: "state_change", sessionId, state: "waiting_input", reason: "interrupted" }];
+      if (str(turn.status) !== "failed" && !failure3.message) return [{ type: "turn_complete", sessionId }];
+      const detail = str(failure3.additionalDetails);
       return [
         {
           type: "error",
           sessionId,
           error: {
             code: "internal",
-            message: [str2(failure3.message) || "The turn failed", detail].filter(Boolean).join("\n"),
+            message: [str(failure3.message) || "The turn failed", detail].filter(Boolean).join("\n"),
             retryable: true
           }
         }
@@ -115707,7 +115773,7 @@ function normalizeNotification(sessionId, n) {
      */
     case "account/rateLimits/updated": {
       const snapshot2 = asObj(p.rateLimits);
-      const reached = str2(snapshot2.rateLimitReachedType) !== "" || snapshot2.spendControlReached === true;
+      const reached = str(snapshot2.rateLimitReachedType) !== "" || snapshot2.spendControlReached === true;
       if (!reached) return [];
       const primary = asObj(snapshot2.primary);
       const resetsAt = finite(primary.resetsAt);
@@ -115722,7 +115788,7 @@ function normalizeNotification(sessionId, n) {
       ];
     }
     case "thread/name/updated":
-      return [{ type: "session_title", sessionId, title: str2(p.name), auto: true }];
+      return [{ type: "session_title", sessionId, title: str(p.name), auto: true }];
     // Deprecated (0.160.0's binding) and not sent in any measured run — kept for a CLI that still does (#303)
     case "thread/compacted":
       return [{ type: "compaction", sessionId, failed: false }];
@@ -115749,17 +115815,17 @@ function normalizeNotification(sessionId, n) {
      * (`noticeWords`, #342).
      */
     case "warning": {
-      const text2 = str2(p.message).trim();
+      const text2 = str(p.message).trim();
       return text2 ? [{ type: "notice", sessionId, level: "warning", text: text2, oncePerSession: true, ...noticeWords("warning", text2) }] : [];
     }
     case "configWarning":
     case "deprecationNotice": {
-      const text2 = [str2(p.summary).trim(), str2(p.details).trim()].filter(Boolean).join("\n");
+      const text2 = [str(p.summary).trim(), str(p.details).trim()].filter(Boolean).join("\n");
       return text2 ? [{ type: "notice", sessionId, level: "warning", text: text2, oncePerSession: true, ...noticeWords(n.method, text2) }] : [];
     }
     // The auto-review guardian's warning about an action (generated/v2/GuardianWarningNotification.ts); not exercised
     case "guardianWarning": {
-      const text2 = str2(p.message).trim();
+      const text2 = str(p.message).trim();
       return text2 ? [{ type: "notice", sessionId, level: "warning", text: text2, ...noticeWords("guardianWarning", text2) }] : [];
     }
     /*
@@ -115769,10 +115835,10 @@ function normalizeNotification(sessionId, n) {
      * conversation and leaves the model the person picked alone.
      */
     case "model/rerouted": {
-      const to = str2(p.toModel);
+      const to = str(p.toModel);
       if (!to) return [];
-      const reason = str2(p.reason) === "highRiskCyberActivity" ? "it was flagged as high-risk cyber activity" : str2(p.reason);
-      const text2 = `Codex answered this turn with ${to} instead of ${str2(p.fromModel) || "the selected model"}${reason ? ` because ${reason}` : ""}`;
+      const reason = str(p.reason) === "highRiskCyberActivity" ? "it was flagged as high-risk cyber activity" : str(p.reason);
+      const text2 = `Codex answered this turn with ${to} instead of ${str(p.fromModel) || "the selected model"}${reason ? ` because ${reason}` : ""}`;
       return [{ type: "notice", sessionId, level: "warning", text: text2, ...noticeWords("model/rerouted", text2) }];
     }
     /*
@@ -115783,11 +115849,11 @@ function normalizeNotification(sessionId, n) {
      * simply had no such tools. The adapter keeps one line per server until it starts again (index.ts).
      */
     case "mcpServer/startupStatus/updated": {
-      if (str2(p.status) !== "failed") return [];
-      const name = str2(p.name) || "an MCP server";
-      const reauth = str2(p.failureReason) === "reauthenticationRequired" ? " (it needs you to sign in again)" : "";
-      const text2 = `${str2(p.error).trim() || `MCP server \`${name}\` failed to start`}${reauth}`;
-      return [{ type: "notice", sessionId, level: "warning", text: text2, ...noticeWords("mcpStartup", text2, str2(p.name)) }];
+      if (str(p.status) !== "failed") return [];
+      const name = str(p.name) || "an MCP server";
+      const reauth = str(p.failureReason) === "reauthenticationRequired" ? " (it needs you to sign in again)" : "";
+      const text2 = `${str(p.error).trim() || `MCP server \`${name}\` failed to start`}${reauth}`;
+      return [{ type: "notice", sessionId, level: "warning", text: text2, ...noticeWords("mcpStartup", text2, str(p.name)) }];
     }
     /*
      * The `error` notification has the shape `{ error, willRetry, threadId, turnId }` (generated
@@ -115812,13 +115878,13 @@ function normalizeNotification(sessionId, n) {
      * and sent the last two only.
      */
     case "error": {
-      const message = str2(asObj(p.error).message) || str2(p.message) || "Unknown error";
+      const message = str(asObj(p.error).message) || str(p.message) || "Unknown error";
       if (p.willRetry === true) {
-        const why = str2(asObj(p.error).additionalDetails);
+        const why = str(asObj(p.error).additionalDetails);
         console.error(`[codex] ${sessionId.slice(0, 8)} retrying after: ${message}${why ? ` (${why})` : ""}`);
         return [{ type: "activity", sessionId, activity: "retrying" }];
       }
-      if (str2(p.turnId)) return [];
+      if (str(p.turnId)) return [];
       return [{ type: "error", sessionId, error: { code: "internal", message, retryable: true } }];
     }
     default:
@@ -116103,13 +116169,13 @@ function threadIdOf(res) {
 function childSteps(sessionId, parentCallId, n) {
   if (n.method !== "item/started" && n.method !== "item/completed") return [];
   const item = asObj(asObj(n.params).item);
-  const type = str2(item.type);
+  const type = str(item.type);
   if (type === "agentMessage") {
-    const text2 = n.method === "item/completed" ? str2(item.text) : "";
+    const text2 = n.method === "item/completed" ? str(item.text) : "";
     return text2 ? subagentSteps(sessionId, parentCallId, [{ type: "message_delta", sessionId, role: "assistant", text: text2, ...messageIdOf(item.id) }]) : [];
   }
   if (type === "reasoning") {
-    const parts = n.method === "item/completed" && Array.isArray(item.summary) ? item.summary.map((x) => str2(x)).filter(Boolean) : [];
+    const parts = n.method === "item/completed" && Array.isArray(item.summary) ? item.summary.map((x) => str(x)).filter(Boolean) : [];
     return parts.length ? subagentSteps(sessionId, parentCallId, [{ type: "reasoning_delta", sessionId, text: parts.join("\n\n") }]) : [];
   }
   return subagentSteps(sessionId, parentCallId, normalizeNotification(sessionId, n));
@@ -116117,18 +116183,20 @@ function childSteps(sessionId, parentCallId, n) {
 function launchedThreads(n) {
   if (n.method !== "item/completed") return [];
   const item = asObj(asObj(n.params).item);
-  if (str2(item.type) !== "collabAgentToolCall" || str2(item.tool) !== "spawnAgent" || !codexItemOk(item)) return [];
+  if (str(item.type) !== "collabAgentToolCall" || str(item.tool) !== "spawnAgent" || !codexItemOk(item)) return [];
   return (Array.isArray(item.receiverThreadIds) ? item.receiverThreadIds : []).filter((t) => typeof t === "string" && t !== "");
 }
 var CodexChildTracker = class {
   constructor(sessionId) {
     this.sessionId = sessionId;
+    this.events = new BackgroundEvents(sessionId);
   }
   sessionId;
   threads = /* @__PURE__ */ new Map();
   /** Linked children: thread to its launch call and description. Only these are listed. */
   linked = /* @__PURE__ */ new Map();
-  lastLive = "[]";
+  /** The events, by the rule both adapters share (`BackgroundEvents`): a repeat of the last list is not sent */
+  events;
   /**
    * Launch cards held open while the children they started run (#843). A `spawnAgent` item completes the moment the
    * child starts (measured: its `item/completed` names the child's thread before the child has done anything), so its
@@ -116169,7 +116237,7 @@ var CodexChildTracker = class {
     const t = this.threads.get(thread) ?? { active: false, turnId: null };
     this.threads.set(thread, t);
     if (n.method === "thread/status/changed") {
-      const type = str2(asObj(p.status).type);
+      const type = str(asObj(p.status).type);
       if (type === "active") t.active = true;
       else if (type === "systemError") {
         const was = t.active;
@@ -116181,15 +116249,15 @@ var CodexChildTracker = class {
     }
     if (n.method === "turn/started") {
       t.active = true;
-      t.turnId = str2(asObj(p.turn).id) || t.turnId;
+      t.turnId = str(asObj(p.turn).id) || t.turnId;
       return this.changed();
     }
     if (n.method === "turn/completed") {
-      const raw = str2(asObj(p.turn).status);
+      const raw = str(asObj(p.turn).status);
       t.active = false;
       t.turnId = null;
       const status = raw === "interrupted" ? "stopped" : raw === "failed" ? "failed" : "completed";
-      const message = str2(asObj(asObj(p.turn).error).message);
+      const message = str(asObj(asObj(p.turn).error).message);
       return [...this.changed([this.ended(thread, status, message || void 0)]), ...this.finished(thread)];
     }
     return [];
@@ -116212,7 +116280,7 @@ var CodexChildTracker = class {
   }
   ended(thread, status, summary) {
     const task = this.task(thread);
-    return task ? { ...task, status, ...summary ? { summary } : {} } : null;
+    return task ? { ...task, status, ...endedSummary(summary) } : null;
   }
   task(thread) {
     const link = this.linked.get(thread);
@@ -116238,12 +116306,10 @@ var CodexChildTracker = class {
   }
   /** The event when the live set or an ending moved; nothing when neither did. */
   changed(ended = []) {
-    const live2 = this.live();
-    const done = ended.filter((t) => t !== null);
-    const key = JSON.stringify(live2);
-    if (key === this.lastLive && done.length === 0) return [];
-    this.lastLive = key;
-    return [{ type: "background_tasks", sessionId: this.sessionId, live: live2, ...done.length ? { ended: done } : {} }];
+    return this.events.event(
+      this.live(),
+      ended.filter((t) => t !== null)
+    );
   }
 };
 
@@ -116337,20 +116403,20 @@ var CODEX_KNOWN_NOTIFICATIONS = /* @__PURE__ */ new Set([
 function threadSettingsOf(res) {
   if (!res) return null;
   const thread = asObj(res.thread);
-  const model = str2(res.model) || str2(thread.model);
+  const model = str(res.model) || str(thread.model);
   if (!model) return null;
   return {
     model,
-    effort: str2(res.reasoningEffort) || str2(thread.reasoningEffort) || null,
-    serviceTier: str2(res.serviceTier) || null
+    effort: str(res.reasoningEffort) || str(thread.reasoningEffort) || null,
+    serviceTier: str(res.serviceTier) || null
   };
 }
 function threadSettingsChanged(sessionId, before, params, launched) {
   const s = asObj(asObj(params).threadSettings);
   const next = {
-    model: str2(s.model) || null,
-    effort: str2(s.effort) || null,
-    serviceTier: str2(s.serviceTier) || null
+    model: str(s.model) || null,
+    effort: str(s.effort) || null,
+    serviceTier: str(s.serviceTier) || null
   };
   if (!next.model) return { next: before, events: [] };
   if (!before) return { next, events: [] };
@@ -116410,18 +116476,18 @@ function approvalDetailFrom(method, params, itemChanges) {
     const net2 = asObj(params.networkApprovalContext);
     return {
       kind: "command",
-      command: str2(item.command) || str2(params.command),
-      cwd: str2(item.cwd) || str2(params.cwd),
-      ...str2(params.reason) ? { reason: str2(params.reason) } : {},
-      ...str2(net2.host) ? { network: { host: str2(net2.host), protocol: str2(net2.protocol) } } : {},
-      ...str2(params.kind) === "writeStdin" ? { stdin: true } : {}
+      command: str(item.command) || str(params.command),
+      cwd: str(item.cwd) || str(params.cwd),
+      ...str(params.reason) ? { reason: str(params.reason) } : {},
+      ...str(net2.host) ? { network: { host: str(net2.host), protocol: str(net2.protocol) } } : {},
+      ...str(params.kind) === "writeStdin" ? { stdin: true } : {}
     };
   }
   if (method === "item/fileChange/requestApproval") return fileEditDetail(itemChanges ?? []);
   if (method === "applyPatchApproval") {
     const changes = Object.entries(asObj(params.fileChanges)).map(([path2, c]) => ({
       path: path2,
-      diff: str2(asObj(c).unified_diff) || str2(asObj(c).content),
+      diff: str(asObj(c).unified_diff) || str(asObj(c).content),
       // generated FileChange: the same `type` (add, delete, update with move_path) as the v2 kind
       ...changeKindOf(asObj(c))
     }));
@@ -116565,7 +116631,7 @@ function approvalKindOf(meta3) {
   return typeof kind === "string" ? kind : null;
 }
 function appApprovalDetail(server2, message, meta3) {
-  const m = typeof meta3 === "object" && meta3 !== null ? meta3 : {};
+  const m = asObj(meta3);
   const title = typeof m.tool_title === "string" && m.tool_title ? m.tool_title : typeof message === "string" ? message : "";
   const params = m.tool_params === void 0 ? "" : ` ${JSON.stringify(m.tool_params).slice(0, 1e3)}`;
   return { kind: "other", raw: `${server2} \xB7 ${title}${params}` };
@@ -117461,7 +117527,7 @@ var CodexSession = class {
     for (const e of normalizeNotification(this.sessionId, n)) {
       if (e.type === "error" && this.inputReceipts.size) this.interrupt(new Error(e.error.message));
       if (e.type === "message_image" && !e.data && e.path) {
-        void imageEventFromDisk(this.sessionId, e.path).then((filled3) => this.emit(filled3));
+        void imageEventFromDisk(this.sessionId, e.path).then((filled2) => this.emit(filled2));
         continue;
       }
       if (e.type === "compaction" && !this.compactions.admit(n)) continue;
@@ -118291,6 +118357,7 @@ var HandoffMarkers = class {
 };
 
 // packages/agent-host/src/dev-services/store/settings.ts
+var SESSION_SETTING_OF = `length(key) > length(@sessionId) + 1 AND substr(key, -length(@sessionId) - 1) = ':' || @sessionId`;
 function flagSetting(settings, key, byDefault) {
   return {
     read: () => {
@@ -118691,13 +118758,26 @@ var MessageRecords = class {
 import Database from "better-sqlite3";
 import { existsSync as existsSync16 } from "node:fs";
 
-// packages/agent-host/src/dev-services/store/migrations/context.ts
+// packages/agent-host/src/dev-services/store/store-keys.ts
 var APP_SETTINGS_DDL = `
   CREATE TABLE IF NOT EXISTS app_settings (
     key   TEXT PRIMARY KEY,
     value TEXT NOT NULL
   );
 `;
+function readStoreKey(db, key) {
+  const table = db.prepare(`SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'app_settings'`).get();
+  if (!table) return null;
+  const row = db.prepare(`SELECT value FROM app_settings WHERE key = ?`).get(key);
+  return row?.value ?? null;
+}
+function writeStoreKey(db, key, value) {
+  db.exec(APP_SETTINGS_DDL);
+  if (value === null) db.prepare(`DELETE FROM app_settings WHERE key = ?`).run(key);
+  else db.prepare(`INSERT INTO app_settings (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(key, value);
+}
+
+// packages/agent-host/src/dev-services/store/migrations/context.ts
 var MigrationRange = class {
   constructor(host) {
     this.host = host;
@@ -118753,15 +118833,12 @@ var ReaderGate = class {
   }
   /** null when nothing is recorded yet: a new store, or one last opened by a host from before #292 */
   storedMinReader() {
-    const table = this.db.prepare(`SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'app_settings'`).get();
-    if (!table) return null;
-    const row = this.db.prepare(`SELECT value FROM app_settings WHERE key = ?`).get(MIN_READER_KEY);
-    const n = row ? Number(row.value) : NaN;
+    const raw = readStoreKey(this.db, MIN_READER_KEY);
+    const n = raw !== null ? Number(raw) : NaN;
     return Number.isInteger(n) && n >= 0 ? n : null;
   }
   writeMinReader(version2) {
-    this.db.exec(APP_SETTINGS_DDL);
-    this.db.prepare(`INSERT INTO app_settings (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(MIN_READER_KEY, String(version2));
+    writeStoreKey(this.db, MIN_READER_KEY, String(version2));
   }
 };
 
@@ -118776,8 +118853,7 @@ var OwedVacuum = class {
   db;
   /** A `VACUUM` a step queued has not run yet: the host was stopped during it (#396) */
   get vacuumOwed() {
-    const table = this.db.prepare(`SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'app_settings'`).get();
-    return !!table && !!this.db.prepare(`SELECT 1 FROM app_settings WHERE key = ?`).get(VACUUM_OWED_KEY);
+    return readStoreKey(this.db, VACUUM_OWED_KEY) !== null;
   }
   /**
    * Runs the owed `VACUUM` and deletes the record of it. `why`, when given, is said in host.log on success.
@@ -118798,7 +118874,7 @@ var OwedVacuum = class {
       console.error(`[store] could not vacuum; ${mb(free)} stay free in the file: ${err.message}`);
       return null;
     } finally {
-      this.db.prepare(`DELETE FROM app_settings WHERE key = ?`).run(VACUUM_OWED_KEY);
+      writeStoreKey(this.db, VACUUM_OWED_KEY, null);
     }
     const done = { before, after: size(), ms: Date.now() - t02 };
     if (why) console.error(`[store] vacuumed ${mb(done.before)} -> ${mb(done.after)} (${done.ms}ms): ${why}`);
@@ -118925,8 +119001,7 @@ var MigrationRunner = class extends ReaderGate {
    * what the vacuum did when it ran.
    */
   vacuumAfterStep(report) {
-    this.db.exec(APP_SETTINGS_DDL);
-    this.db.prepare(`INSERT INTO app_settings (key, value) VALUES (?, '1') ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(VACUUM_OWED_KEY);
+    writeStoreKey(this.db, VACUUM_OWED_KEY, "1");
     this.afterStep(() => {
       const done = this.runOwedVacuum();
       if (done) report?.(done);
@@ -119004,18 +119079,10 @@ var MigrationRunner = class extends ReaderGate {
     }
   }
   storedDeferred() {
-    const table = this.db.prepare(`SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'app_settings'`).get();
-    if (!table) return [];
-    const row = this.db.prepare(`SELECT value FROM app_settings WHERE key = ?`).get(DEFERRED_KEY);
-    return readJsonList(row?.value, external_exports.number().int().positive());
+    return readJsonList(readStoreKey(this.db, DEFERRED_KEY), external_exports.number().int().positive());
   }
   writeDeferred(steps) {
-    this.db.exec(APP_SETTINGS_DDL);
-    if (steps.length === 0) {
-      this.db.prepare(`DELETE FROM app_settings WHERE key = ?`).run(DEFERRED_KEY);
-      return;
-    }
-    this.db.prepare(`INSERT INTO app_settings (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(DEFERRED_KEY, JSON.stringify([...steps].sort((a, b2) => a - b2)));
+    writeStoreKey(this.db, DEFERRED_KEY, steps.length === 0 ? null : JSON.stringify([...steps].sort((a, b2) => a - b2)));
   }
 };
 
@@ -120388,6 +120455,22 @@ var StepsV55 = class extends MigrationRange {
                   END`
           ).run({ mark: ASK_PROJECT_MARK });
         }
+      },
+      {
+        to: 56,
+        // Drops `usage_facts`: an older schema.sql recreates it empty, and builds up to beta.10 still ran DELETE FROM it
+        breaksOlderReaders: true,
+        /**
+         * The unused usage aggregate goes (#423). It was planned for the first milestone and never built: no build ever
+         * wrote a row. Deleting a project was the last statement that named it, and #420 removed that; the table has
+         * been left alone by every release since, which is the "one release later" that §5.1 rule 2 asks for.
+         *
+         * `schema.sql` no longer creates it either, so a new store and a migrated one end with the same tables. Nothing
+         * is lost: there is no row to keep. `IF EXISTS` because a fresh store never had the table.
+         */
+        run: () => {
+          this.db.exec(`DROP TABLE IF EXISTS usage_facts`);
+        }
       }
     ];
   }
@@ -120875,14 +120958,13 @@ var SessionRecords = class {
 // packages/agent-host/src/dev-services/store/trash.ts
 function parseTrashRecord(json2) {
   const r = asObj(parseJson(json2));
-  const str3 = (v) => typeof v === "string" && v ? v : null;
   return {
-    projectId: str3(r.projectId),
-    projectName: str3(r.projectName),
-    projectPath: str3(r.projectPath),
+    projectId: filled(r.projectId),
+    projectName: filled(r.projectName),
+    projectPath: filled(r.projectPath),
     removeExternal: r.removeExternal === true,
     removeWorktree: r.removeWorktree === true,
-    ...r.recovery && typeof r.recovery === "object" && typeof r.recovery.snapshot === "string" && typeof r.recovery.tip === "string" && typeof r.recovery.changedFiles === "number" && typeof r.recovery.commits === "number" ? { recovery: r.recovery } : {}
+    ...isObj(r.recovery) && typeof r.recovery.snapshot === "string" && typeof r.recovery.tip === "string" && typeof r.recovery.changedFiles === "number" && typeof r.recovery.commits === "number" ? { recovery: r.recovery } : {}
   };
 }
 var DELETE_CHUNK = 250;
@@ -120964,6 +121046,10 @@ var TrashRecords = class {
    * the whole took 4.1s, with the event loop turning 231 times). The rows that are not messages, and the session row, go in the same
    * transaction as the last chunk, so a purge cut short leaves the session in the trash with fewer messages, to be
    * purged again, and never messages without a session.
+   *
+   * The settings kept per session go too, all of them by their shape (`SESSION_SETTING_OF`) rather than by name: the
+   * purge used to name two of them, and every key added since stayed behind for good (a process's tool prefix and launch
+   * settings, its fresh-start mark, its last import, a paused report).
    */
   async purgeSession(sessionId, chunk = DELETE_CHUNK) {
     if (!this.isTrashed(sessionId)) return false;
@@ -120990,8 +121076,7 @@ var TrashRecords = class {
       this.db.prepare(`DELETE FROM agent_start_requests WHERE caller_session_id = ?`).run(sessionId);
       this.db.prepare(`DELETE FROM delegated_turns WHERE session_id = ? OR caller_session_id = ?`).run(sessionId, sessionId);
       this.db.prepare(`DELETE FROM queued_requests WHERE session_id = ? OR caller_session_id = ?`).run(sessionId, sessionId);
-      this.db.prepare(`DELETE FROM app_settings WHERE key = ?`).run(`agent_depth:${sessionId}`);
-      this.db.prepare(`DELETE FROM app_settings WHERE key = ?`).run(`hub_ask_depth:${sessionId}`);
+      this.db.prepare(`DELETE FROM app_settings WHERE ${SESSION_SETTING_OF}`).run({ sessionId });
       this.db.prepare(`DELETE FROM sessions WHERE id = ? AND deleted_at IS NOT NULL`).run(sessionId);
       return true;
     });
@@ -121063,8 +121148,7 @@ var TrashRecords = class {
    * of a session caught here are dropped by hand — a session in the trash must not turn up in a search.
    *
    * The rows that belong to the project go with it as before: project-scope rules, the answers given to its apps, and
-   * the app runs and commit links that point at no session still here. (`usage_facts` is not touched: no build ever
-   * wrote a row to it, and this build is the first that leaves it alone, so a later step can drop it; schema.sql.) Rows that point at a session in the trash stay with that session until it is
+   * the app runs and commit links that point at no session still here. Rows that point at a session in the trash stay with that session until it is
    * deleted for good: its own rules, its commit links, the app runs it started or ran in. A restore that registers
    * the folder again under the same id finds them where they were.
    */
@@ -121211,22 +121295,6 @@ var Store = class extends MigrationRunner {
     this.checkpoint();
     this.db.close();
   }
-  /*
-   * Everything below only passes the call on to the module named in its heading. They are the last pass-throughs: #1099,
-   * in the merge queue, still calls them on `Store` and hands the whole store to `labelOf` (#428), and they go once it
-   * lands. New code names the module.
-   */
-  // ── MessageRecords (store/messages.ts) ──
-  loadMessages(sessionId, limit, beforeSeq, opts) {
-    return this.messages.loadMessages(sessionId, limit, beforeSeq, opts);
-  }
-  loadMessagesFrom(sessionId, afterSeq, limit, opts) {
-    return this.messages.loadMessagesFrom(sessionId, afterSeq, limit, opts);
-  }
-  // ── SettingsRecords (store/settings.ts) ──
-  appSetting(key) {
-    return this.settings.appSetting(key);
-  }
 };
 var WAL_SIZE_LIMIT = 64 * 1024 * 1024;
 
@@ -121314,6 +121382,16 @@ function appSettingRests(settings) {
 
 // packages/agent-host/src/dev-services/git-pr.ts
 var OK2 = { timeout: 1e4, maxBuffer: 32 * 1024 * 1024 };
+var GH_STDERR_KEEP = 4096;
+var ghFailuresSaid = /* @__PURE__ */ new Set();
+function noteGhFailure(branch, e) {
+  const lines = String(e.stderr ?? "").split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+  if (!lines.length || lines.some((l) => /no pull requests? found/i.test(l))) return;
+  const why = lines[0].slice(0, 300);
+  if (ghFailuresSaid.has(why)) return;
+  ghFailuresSaid.add(why);
+  console.error(`[git] gh could not read the pull request of ${branch}: ${why}`);
+}
 async function gitBranchPr(projectCwd, branch, signal, timeoutMs = OK2.timeout) {
   const { child } = spawnGrouped(programPath("gh"), ["pr", "view", branch, "--json", "number,state,url,headRefOid"], {
     cwd: projectCwd,
@@ -121325,10 +121403,13 @@ async function gitBranchPr(projectCwd, branch, signal, timeoutMs = OK2.timeout)
     outBytes += chunk.length;
     if (outBytes <= OK2.maxBuffer) out.push(chunk);
   });
-  child.stderr.resume();
+  let err = "";
+  child.stderr.on("data", (chunk) => {
+    err = (err + chunk.toString("utf8")).slice(-GH_STDERR_KEEP);
+  });
   const run4 = new Promise((resolve18, reject) => {
     child.once("error", reject);
-    child.once("close", (code2) => code2 === 0 ? resolve18(Buffer.concat(out).toString("utf8")) : reject(Object.assign(new Error(`gh exited with ${code2}`), { code: code2 })));
+    child.once("close", (code2) => code2 === 0 ? resolve18(Buffer.concat(out).toString("utf8")) : reject(Object.assign(new Error(`gh exited with ${code2}`), { code: code2, stderr: err })));
   });
   const closed = new Promise((done) => child.once("close", () => done()));
   const exited = new Promise((done) => child.once("exit", () => done()));
@@ -121359,7 +121440,9 @@ async function gitBranchPr(projectCwd, branch, signal, timeoutMs = OK2.timeout)
       ...typeof j2.headRefOid === "string" && j2.headRefOid ? { headOid: j2.headRefOid } : {}
     };
   } catch (e) {
-    return e.code === "ENOENT" ? "unavailable" : null;
+    if (e.code === "ENOENT") return "unavailable";
+    noteGhFailure(branch, e);
+    return null;
   } finally {
     clearTimeout(timer);
     if (onAbort) signal?.removeEventListener("abort", onAbort);
@@ -122948,7 +123031,7 @@ var AppSessions = class {
     const rt2 = this.host.appsHub?.rt;
     if (!rt2) throw rpcError("External apps are unavailable");
     const app2 = rt2.list().find((a) => a.appId === ref.appId && a.projectId === ref.projectId);
-    if (!app2) throw rpcError(`There is no such app: ${ref.projectId ?? "user"}/${ref.appId}`);
+    if (!app2) throw rpcError(noSuchAppText(ref));
     if (!app2.trusted) {
       throw rpcError("Centralu does not give a builder to an app in a project it does not trust \u2014 trust the project, and the app can start and be tested");
     }
@@ -126416,7 +126499,7 @@ function createRpcHandler(mgr2, adapters2, { terminals: terminals2, updates: upd
       if (projectId === null) return { kind: "snapshots", snapshots: apps.snapshots({ appId, projectId }).map(({ stamp: _stamp, depth: _depth, ...s }) => s) };
       const project2 = (await mgr2.listProjects()).find((x) => x.id === projectId);
       const app2 = apps.list().find((a) => a.appId === appId && a.projectId === projectId);
-      if (!project2 || !app2) throw rpcError(`There is no such app: ${projectId}/${appId}`);
+      if (!project2 || !app2) throw rpcError(noSuchAppText({ projectId, appId }));
       const { repo, commits } = await gitLogPath(project2.path, relative6(project2.path, app2.dir), 20);
       return { kind: "git", repo, commits };
     },
@@ -129277,11 +129360,48 @@ var SSH_COMMAND_TIMEOUT_MS = 6e4;
 var SSH_DETACH_TIMEOUT_MS = 12e4;
 var SSH_EXEC_TIMEOUT_MS = 30 * 6e4;
 var FORWARD_STDERR_KEEP = 16 * 1024;
+var CLIXML_MARK = /<\/?(?:Objs|Obj|S|MS|PR|TN|TNRef|Props|I32|I64|B|AV)[\s>/]|_x00[0-9A-F]{2}_/;
+var ANSI = /\x1b\[[0-?]*[ -/]*[@-~]|\x1b[@-_]?/g;
+function powershellErrorLine(line) {
+  const l = line.trim();
+  if (l === "+" || l.startsWith("+ ")) return null;
+  if (/^\S+ \S+:\d+ \S+:\d+$/.test(l) || /^(?:At|위치) .+:\d+ \S+:\d+$/.test(l)) return null;
+  if (/^Line \|$/.test(l) || /^\d+ \|/.test(l) || /^\|\s*~*$/.test(l)) return null;
+  const gutter = /^\| ?(.*)$/.exec(l);
+  return gutter ? gutter[1] : line;
+}
+function clixmlErrorText(xml) {
+  return [...xml.matchAll(/<S S="Error">([\s\S]*?)<\/S>/g)].map(
+    (m) => m[1].replace(/_x([0-9A-Fa-f]{4})_/g, (_, hex3) => String.fromCharCode(parseInt(hex3, 16))).replace(/&(lt|gt|quot|apos|amp);/g, (_, e) => ({ lt: "<", gt: ">", quot: '"', apos: "'", amp: "&" })[e])
+  ).join("").replace(ANSI, "").split(/\r?\n/).flatMap((l) => {
+    const kept = powershellErrorLine(l);
+    return kept === null ? [] : [kept];
+  }).join("\n");
+}
+function plainPart(text2) {
+  const mark = text2.search(CLIXML_MARK);
+  return mark < 0 ? text2 : text2.slice(0, text2.lastIndexOf("\n", mark) + 1);
+}
 function withoutClixml(s) {
-  let text2 = s.replace(/#< CLIXML[\s\S]*$/, "");
-  const xml = text2.search(/<\/?(?:Objs|Obj|S|MS|PR|TN|TNRef|Props|I32|I64|B|AV)[\s>/]|_x000[0-9A-F]_/);
-  if (xml >= 0) text2 = text2.slice(0, text2.lastIndexOf("\n", xml) + 1);
-  return text2.split(/\r?\n/);
+  let text2 = s.replace(/^#< CLIXML\r?$/gm, "");
+  const parts = [];
+  const firstEnd = text2.indexOf("</Objs>");
+  const firstOpen = text2.search(/<Objs[\s>]/);
+  if (firstEnd >= 0 && (firstOpen < 0 || firstEnd < firstOpen)) {
+    const cut = plainPart(text2.slice(0, firstEnd));
+    parts.push(cut, "\n", clixmlErrorText(text2.slice(cut.length, firstEnd)), "\n");
+    text2 = text2.slice(firstEnd + "</Objs>".length);
+  }
+  for (; ; ) {
+    const open6 = text2.search(/<Objs[\s>]/);
+    if (open6 < 0) break;
+    parts.push(plainPart(text2.slice(0, open6)), "\n");
+    const end = text2.indexOf("</Objs>", open6);
+    parts.push(clixmlErrorText(end < 0 ? text2.slice(open6) : text2.slice(open6, end)), "\n");
+    text2 = end < 0 ? "" : text2.slice(end + "</Objs>".length);
+  }
+  parts.push(plainPart(text2));
+  return parts.join("").replace(ANSI, "").split(/\r?\n/);
 }
 function lastLine(s, ansi = ansiText) {
   const lines = withoutClixml(s).map((l) => l.trim()).filter((l) => l && !l.startsWith("**") && !/^Node\.js v\d/.test(l) && !/^at /.test(l));
@@ -129461,7 +129581,13 @@ try {
   if ($LASTEXITCODE -ne 0) { throw 'node_runs' }
   New-Item -ItemType Directory -Force (Join-Path $r 'node') | Out-Null
   if (Test-Path $n) { Remove-Item -Recurse -Force $n }
-  Move-Item $k $n
+  # Windows refuses to rename a folder while something holds a file in it, and an on-access scanner holds the node.exe
+  # just run for a moment ("Access to the path is denied", #368): the rename is tried again for up to 15 s. A rename
+  # and nothing else: Move-Item, refused, went on to move the folder's files one by one and left half of it at $n.
+  # A test's stand-in for the scanner says it holds the file by creating CENTRALU_TEST_NODE_PLACE_GATE; unset, nothing waits.
+  $g = $env:CENTRALU_TEST_NODE_PLACE_GATE
+  if ($g) { $end = (Get-Date).AddSeconds(60); while (-not (Test-Path -LiteralPath $g) -and (Get-Date) -lt $end) { Start-Sleep -Milliseconds 20 } }
+  for ($i = 1; ; $i++) { try { [IO.Directory]::Move($k, $n); break } catch { if ($i -ge 60) { throw }; Start-Sleep -Milliseconds 250 } }
   Say 'node ok'
 } catch {
   $m = if ($_.Exception.Message) { $_.Exception.Message } else { "$_" }
@@ -132401,6 +132527,7 @@ var Router = class {
       const failed3 = Array.isArray(out.failed) ? out.failed : [];
       out = { ...out, failed: [...failed3, ...missed.map((m) => ({ sessionId: m.id, name: m.name, error: "this machine could not be reached, so its trash was not emptied" }))] };
     }
+    if (method === "trash.list" && missed.length && isObj(out)) out = { ...out, unreached: missed.map((m) => ({ machineId: m.id, name: m.name })) };
     return out;
   }
 };
@@ -132737,7 +132864,7 @@ var handedToken = launch.tokenOnStdin ? await readHandedToken(process.stdin).cat
   console.error(`[agent-host] the launcher did not hand over the token: ${e.message}`);
   process.exit(1);
 }) : launch.token;
-var BUILD = true ? "9b15c3f" : "dev";
+var BUILD = true ? "c807879" : "dev";
 var { values } = parseArgs({
   options: {
     port: { type: "string", default: "5175" },