@inerrata-corporation/errata 2.0.17-dev.3407 → 2.0.17-dev.3421

package/errata.mjs

@@ -21903,6 +21903,24 @@ function parseIntentFences(text) {
   }
   return out2;
 }
+function parseShareFence(text) {
+  const m = /```errata-share[^\n]*\n([\s\S]*?)```/.exec(text);
+  if (!m) return null;
+  const parts2 = [];
+  for (const line of m[1].split(/\r?\n/)) {
+    const kv = /^\s*priors\s*:\s*(.*?)\s*$/i.exec(line);
+    if (kv) parts2.push(kv[1]);
+    else if (parts2.length > 0 && line.trim()) parts2.push(line.trim());
+  }
+  const value = parts2.join(" ").trim();
+  if (/^all$/i.test(value)) return { all: true };
+  const priors = [
+    ...new Set(
+      value.split(/[\s,]+/).map((t) => t.replace(/^[`([]+|[`)\]]+$/g, "")).filter((t) => /^[\w.:-]+$/.test(t))
+    )
+  ];
+  return priors.length > 0 ? { all: false, priors } : null;
+}
 function searchByIntent(store, intent, opts) {
   const limit = opts?.limit ?? 5;
   const minCoverage = opts?.minCoverage ?? DEFAULT_MIN_COVERAGE;
@@ -25010,6 +25028,7 @@ __export(src_exports2, {
   parseAbstractionFences: () => parseAbstractionFences,
   parseIntentFences: () => parseIntentFences,
   parseSemver: () => parseSemver,
+  parseShareFence: () => parseShareFence,
   parseTriageFences: () => parseTriageFences,
   pendingAbstractions: () => pendingAbstractions,
   pendingDiscriminators: () => pendingDiscriminators,
@@ -25292,6 +25311,8 @@ function renderSnapshot(s) {
   lines.push(SEARCH_IMPERATIVE_HEADER);
   lines.push(SEARCH_IMPERATIVE_BODY);
   lines.push("");
+  lines.push(s.isolated ? SUBAGENT_OWN_BLOCK_NOTE : SPAWN_SHARE_HINT);
+  lines.push("");
   lines.push(`### Active workspace profile`);
   lines.push(`- **Name:** ${s.profile.name}`);
   const ctxName = (name2) => name2.startsWith("@") ? `\`${name2}\`` : name2;
@@ -25469,6 +25490,12 @@ function renderSnapshot(s) {
     }
     lines.push("");
   }
+  if (s.sharedPriors?.length) {
+    lines.push(`### \u{1F91D} Handed to you by the agent that spawned you`);
+    lines.push("_It chose these for your task \u2014 cite one with its `[handle]` if you lean on it:_");
+    for (const n of s.sharedPriors) lines.push(`- **${n.label}:** ${n.description}${tagOf(n)}`);
+    lines.push("");
+  }
   if (s.statedIntent) {
     const si = s.statedIntent;
     lines.push(`### \u{1F3AF} You said you're working on this`);
@@ -25650,6 +25677,34 @@ function budgetSnapshot(s, maxChars) {
   while (renderSnapshot(s).length > maxChars && dropLowestUnit(s)) dropped++;
   return dropped;
 }
+function isolateSnapshot(s) {
+  const {
+    workingFile: _workingFile,
+    statedIntent: _statedIntent,
+    selfCiteSkips: _selfCiteSkips,
+    pendingUpdate: _pendingUpdate,
+    daemonDistress: _daemonDistress,
+    reviewItems: _reviewItems,
+    causalNudge: _causalNudge,
+    domainNudge: _domainNudge,
+    sharedPriors: _sharedPriors,
+    ...graphWide
+  } = s;
+  return {
+    ...graphWide,
+    isolated: true,
+    recentProblems: [],
+    recentResolved: [],
+    regressions: [],
+    recentConstraints: [],
+    pendingEnrichment: [],
+    needsRevisit: [],
+    reviewCount: 0,
+    motifs: [...s.motifs],
+    skills: [...s.skills],
+    ...s.remote ? { remote: [...s.remote] } : {}
+  };
+}
 function assembleAgentContext(opts) {
   const snapshot = opts.snapshot ?? buildSnapshot({
     store: opts.store,
@@ -25666,6 +25721,7 @@ function assembleAgentContext(opts) {
   if (opts.daemonDistress) snapshot.daemonDistress = opts.daemonDistress;
   if (opts.reviewItems?.length) snapshot.reviewItems = [...opts.reviewItems];
   if (opts.statedIntent) snapshot.statedIntent = opts.statedIntent;
+  if (opts.sharedPriors?.length) snapshot.sharedPriors = [...opts.sharedPriors];
   if (opts.remote && opts.remote.length > 0) {
     const seen = /* @__PURE__ */ new Set();
     const remote = opts.remote.filter((n) => {
@@ -25717,7 +25773,7 @@ function diffRenderLedger(before, after) {
   for (const i2 of before) (survived.has(key(i2)) ? shown : evicted).push(i2);
   return { shown, evicted };
 }
-var RECALL_FIRST_HEADER, RECALL_FIRST_BODY, RECALL_FIRST_BLOCK, SEARCH_IMPERATIVE_HEADER, SEARCH_IMPERATIVE_BODY, EVICTION_ORDER, MOTIF_FLOOR, REMOTE_FLOOR, PROBLEM_FLOOR, REVIEW_ITEM_FLOOR, DEFAULT_AGENT_CONTEXT_BUDGET;
+var RECALL_FIRST_HEADER, RECALL_FIRST_BODY, RECALL_FIRST_BLOCK, SEARCH_IMPERATIVE_HEADER, SEARCH_IMPERATIVE_BODY, SPAWN_SHARE_HINT, SUBAGENT_OWN_BLOCK_NOTE, EVICTION_ORDER, MOTIF_FLOOR, REMOTE_FLOOR, PROBLEM_FLOOR, REVIEW_ITEM_FLOOR, DEFAULT_AGENT_CONTEXT_BUDGET;
 var init_render = __esm({
   "../../packages/context-writer/src/render.ts"() {
     "use strict";
@@ -25731,6 +25787,8 @@ var init_render = __esm({
 ${RECALL_FIRST_BODY}`;
     SEARCH_IMPERATIVE_HEADER = "### \u{1F50E} PRIORS ARE SEEDS \u2014 a sample, not the whole graph";
     SEARCH_IMPERATIVE_BODY = "Everything below is a budgeted slice of a much larger graph, not all errata knows. Starting a piece of work? Say what it is \u2014 we search on it between your tool calls and put what we find here:\n```errata-intent\nintent: <the work in hand, in your words>\n```\nNarration, not a detour: no tool call, no plan change. It is the one signal we cannot derive from your edits \u2014 everything else here is guessed from the files you touched.";
+    SPAWN_SHARE_HINT = "_Spawning a subagent? It gets its own errata block, seeded from its task \u2014 none of the priors here. To hand it some, put this in its prompt (or `priors: all` for this whole block):_\n```errata-share\npriors: [handle], [handle]\n```";
+    SUBAGENT_OWN_BLOCK_NOTE = "_This block is yours: seeded from the task you were given, then from what you state and touch. The agent that spawned you sees a different one._";
     EVICTION_ORDER = [
       "skills",
       // Review items beyond the floor drop immediately after skills — one naming
@@ -32004,6 +32062,9 @@ function errorCardHeadline(items) {
   const fixes = items.filter((it) => it.label === "Solution").length;
   return fixes > 0 ? `${plural(fixes, "known fix", "known fixes")} for this error` : `${plural(items.length, "prior")} for this error`;
 }
+function forSubagent(card, agentType) {
+  return { ...card, headline: `\u21B3 ${agentType || "subagent"} \xB7 ${card.headline}` };
+}
 function leadItem(card) {
   return card.chain?.fix ?? card.items.find((it) => it.label === "Solution") ?? card.single ?? card.items[0];
 }
@@ -32083,6 +32144,29 @@ function rememberCard(sessionId, card, now = Date.now(), since = now) {
   if (current && current.at > since) return;
   remember(latestBySession, sessionId, { card, at: now });
 }
+function rememberAgentCard(sessionId, agentId, card, now = Date.now()) {
+  if (!sessionId || !agentId) return;
+  remember(latestByAgent, agentKey(sessionId, agentId), { card, at: now });
+}
+function subagentRows(body2, now = Date.now()) {
+  const sessionId = typeof body2["session_id"] === "string" ? body2["session_id"] : "";
+  const tasks = Array.isArray(body2["tasks"]) ? body2["tasks"] : [];
+  const columns = typeof body2["columns"] === "number" && body2["columns"] > 20 ? body2["columns"] : 100;
+  const lines = [];
+  for (const task of tasks) {
+    const id = typeof task["id"] === "string" ? task["id"] : "";
+    const hit = id ? latestByAgent.get(agentKey(sessionId, id)) : void 0;
+    if (!hit || now - hit.at > SUBAGENT_ROW_TTL_MS) continue;
+    const lead2 = leadItem(hit.card);
+    const title = String(task["description"] ?? task["label"] ?? "").trim();
+    const plain = clip(
+      `${title ? `${title} \xB7 ` : ""}\u26A1 errata \xB7 ${hit.card.headline}${lead2 ? ` \u2014 ${labelName(lead2.label)}: ${lead2.text}` : ""}`,
+      columns - 2
+    );
+    lines.push(JSON.stringify({ id, content: plain.replace("\u26A1", `${AMBER}\u26A1${RESET}`) }));
+  }
+  return lines.join("\n");
+}
 function rememberOpenCount(sessionId, open2) {
   if (sessionId) remember(openBySession, sessionId, open2);
 }
@@ -32105,7 +32189,7 @@ function recallCardEnabled(env2 = process.env) {
   const v = (env2["ERRATA_RECALL_CARD"] ?? "").trim().toLowerCase();
   return !(v === "0" || v === "off" || v === "false" || v === "no");
 }
-var LABEL_NAMES, INLINE_TEXT_WIDTH, ESC, RESET, DIM, BOLD, AMBER, MADDER, GREEN, INK, STATUS_ROWS, STATUS_TEXT_WIDTH, LABEL_WIDTH, STATUS_CARD_TTL_MS, IDLE_STATUS, latestBySession, MAX_SESSIONS, openBySession;
+var LABEL_NAMES, INLINE_TEXT_WIDTH, ESC, RESET, DIM, BOLD, AMBER, MADDER, GREEN, INK, STATUS_ROWS, STATUS_TEXT_WIDTH, LABEL_WIDTH, STATUS_CARD_TTL_MS, IDLE_STATUS, latestBySession, MAX_SESSIONS, latestByAgent, agentKey, SUBAGENT_ROW_TTL_MS, openBySession;
 var init_recall_card = __esm({
   "src/recall-card.ts"() {
     "use strict";
@@ -32129,6 +32213,9 @@ var init_recall_card = __esm({
     IDLE_STATUS = `${AMBER}\u26A1${RESET} ${DIM}errata \xB7 watching${RESET}`;
     latestBySession = /* @__PURE__ */ new Map();
     MAX_SESSIONS = 256;
+    latestByAgent = /* @__PURE__ */ new Map();
+    agentKey = (sessionId, agentId) => `${sessionId}#${agentId}`;
+    SUBAGENT_ROW_TTL_MS = 30 * 6e4;
     openBySession = /* @__PURE__ */ new Map();
   }
 });
@@ -52721,6 +52808,7 @@ var init_message_accumulator = __esm({
 // src/webui.ts
 var webui_exports = {};
 __export(webui_exports, {
+  SUBAGENT_REFRESH_MIN_MS: () => SUBAGENT_REFRESH_MIN_MS,
   asFailedPostToolUse: () => asFailedPostToolUse,
   buildWebUi: () => buildWebUi,
   decideContextInject: () => decideContextInject,
@@ -52728,6 +52816,7 @@ __export(webui_exports, {
   fileRecall: () => fileRecall,
   fileUriToFsPath: () => fileUriToFsPath,
   findFileByPath: () => findFileByPath,
+  hookAudience: () => hookAudience,
   recallForFile: () => recallForFile,
   recallForTool: () => recallForTool
 });
@@ -52874,10 +52963,21 @@ ${lines.join("\n")}`,
     card: { headline: `${plural(items.length, "prior")} before this command runs`, items }
   };
 }
+function hookAudience(body2) {
+  const sessionId = String(body2["session_id"] ?? "");
+  const agentId = typeof body2["agent_id"] === "string" ? body2["agent_id"] : "";
+  if (!agentId) return { sessionId, contextKey: sessionId, subagent: null, agentId: "" };
+  return {
+    sessionId,
+    contextKey: sessionId ? `${sessionId}#${agentId}` : "",
+    subagent: typeof body2["agent_type"] === "string" ? body2["agent_type"] : "",
+    agentId
+  };
+}
 function decideContextInject(args2) {
   const { event, sessionId, block, lastInjectedHash } = args2;
   if (!block) return null;
-  if (event === "SessionStart") {
+  if (event === "SessionStart" || event === "SubagentStart") {
     if (sessionId) lastInjectedHash.set(sessionId, block.hash);
   } else if (sessionId && lastInjectedHash.get(sessionId) === block.hash) {
     return null;
@@ -52892,6 +52992,7 @@ function buildWebUi(deps) {
   const B = deps.basePath ?? "";
   const lastInjectedHash = /* @__PURE__ */ new Map();
   const fileRecallSeen = /* @__PURE__ */ new Map();
+  const lastSubagentInjectAt = /* @__PURE__ */ new Map();
   app.get(
     "/",
     (c) => c.json({
@@ -53034,6 +53135,14 @@ function buildWebUi(deps) {
     if (hookEvent === "PostToolUseFailure") body2 = asFailedPostToolUse(body2);
     const event = hookEvent === "PostToolUseFailure" ? "PostToolUse" : hookEvent;
     let recall = null;
+    const audience = hookAudience(body2);
+    if (event === "PreToolUse" && (tool === "Agent" || tool === "Task") && audience.subagent === null) {
+      try {
+        deps.onSubagentSpawn?.(audience.sessionId, input);
+      } catch {
+      }
+      return c.json({ ok: true, event, tool, spawn: true });
+    }
     if (event === "PreToolUse") {
       const virtual = extractVirtualReads(input);
       if (virtual.length > 0) {
@@ -53062,7 +53171,10 @@ function buildWebUi(deps) {
       const workspaceRoot = (deps.paths.root ?? "").replace(/\\/g, "/");
       const fp = filePath.replace(/\\/g, "/");
       rel = fp.startsWith(workspaceRoot + "/") ? fp.slice(workspaceRoot.length + 1) : fp;
-      if (deps.onWorkingFileChanged) deps.onWorkingFileChanged(rel, String(body2["session_id"] ?? ""));
+      if (deps.onWorkingFileChanged) {
+        const agentId = typeof body2["agent_id"] === "string" && body2["agent_id"] ? body2["agent_id"] : void 0;
+        deps.onWorkingFileChanged(rel, audience.sessionId, agentId);
+      }
     }
     if (rel && event === "PostToolUse" && deps.onHookEvent) {
       deps.onHookEvent({
@@ -53130,7 +53242,7 @@ function buildWebUi(deps) {
       }
     }
     if (event === "PostToolUse" && !recall && rel && (tool === "Read" || tool === "Edit" || tool === "Write" || tool === "NotebookEdit")) {
-      const sid = String(body2["session_id"] ?? "");
+      const sid = hookAudience(body2).contextKey;
       let seen = fileRecallSeen.get(sid);
       if (!seen) {
         seen = /* @__PURE__ */ new Set();
@@ -53144,13 +53256,46 @@ function buildWebUi(deps) {
         }
       }
     }
-    if ((event === "PostToolUse" || event === "PreToolUse") && recall) {
+    let refreshed = null;
+    if (event === "PostToolUse" && audience.subagent !== null && audience.contextKey && deps.subagentContext) {
+      const last = lastSubagentInjectAt.get(audience.contextKey) ?? 0;
+      if (Date.now() - last >= SUBAGENT_REFRESH_MIN_MS) {
+        try {
+          const own = deps.subagentContext({
+            sessionId: audience.sessionId,
+            agentId: audience.agentId,
+            agentType: audience.subagent,
+            start: false
+          });
+          const decision = decideContextInject({
+            event,
+            source: "",
+            sessionId: audience.contextKey,
+            block: own,
+            lastInjectedHash
+          });
+          if (decision) {
+            lastSubagentInjectAt.set(audience.contextKey, Date.now());
+            refreshed = { additionalContext: decision.additionalContext, card: own?.card ?? null };
+          }
+        } catch {
+        }
+      }
+    }
+    if ((event === "PostToolUse" || event === "PreToolUse") && (recall || refreshed)) {
       const showCard = recallCardEnabled();
-      if (showCard) rememberCard(String(body2["session_id"] ?? ""), recall.card);
-      const line = showCard ? renderRecallLine(recall.card) : null;
+      const { sessionId, subagent } = audience;
+      const raw2 = recall?.card ?? refreshed?.card ?? null;
+      const card = raw2 && subagent !== null ? forSubagent(raw2, subagent) : raw2;
+      if (showCard && raw2 && card) {
+        if (subagent !== null) rememberAgentCard(sessionId, audience.agentId, raw2);
+        else rememberCard(sessionId, card);
+      }
+      const line = showCard && recall && card ? renderRecallLine(card) : null;
+      const additionalContext = [recall?.context, refreshed?.additionalContext].filter(Boolean).join("\n\n");
       return c.json({
         ...line ? { systemMessage: line } : {},
-        hookSpecificOutput: { hookEventName: hookEvent, additionalContext: recall.context }
+        hookSpecificOutput: { hookEventName: hookEvent, additionalContext }
       });
     }
     if (event === "PostToolUse") return c.body(null, 204);
@@ -53160,6 +53305,10 @@ function buildWebUi(deps) {
     const body2 = await c.req.json().catch(() => ({}));
     return c.text(statuslineText(String(body2["session_id"] ?? "")));
   });
+  app.post("/api/statusline/subagents", async (c) => {
+    const body2 = await c.req.json().catch(() => ({}));
+    return c.text(subagentRows(body2));
+  });
   app.post("/api/turn", async (c) => {
     let body2;
     try {
@@ -53172,6 +53321,9 @@ function buildWebUi(deps) {
     if (transcriptPath && deps.onTurn) {
       deps.onTurn({ sessionId, transcriptPath });
     }
+    if (body2["hook_event_name"] === "SubagentStop" && typeof body2["agent_id"] === "string" && body2["agent_id"]) {
+      deps.onSubagentStop?.(body2["agent_id"]);
+    }
     return c.json({ ok: true });
   });
   app.post("/api/message", async (c) => {
@@ -53188,7 +53340,13 @@ function buildWebUi(deps) {
     const isFinal = body2["final"] !== false;
     const whole = accumulateMessageDelta(messageId, index, delta, isFinal, Date.now());
     if (whole !== null && whole.text && sessionId && deps.onMessage) {
-      deps.onMessage({ sessionId, text: whole.text, ...messageId ? { messageId } : {} });
+      const agentId = typeof body2["agent_id"] === "string" && body2["agent_id"] ? body2["agent_id"] : void 0;
+      deps.onMessage({
+        sessionId,
+        text: whole.text,
+        ...messageId ? { messageId } : {},
+        ...agentId ? { agentId } : {}
+      });
     }
     return c.json({ ok: true, ...whole === null ? { buffered: true } : {} });
   });
@@ -53213,9 +53371,9 @@ function buildWebUi(deps) {
     } catch {
       return c.json({});
     }
-    const sid = String(body2["session_id"] ?? "");
+    const { sessionId: sid, contextKey: contextKey2, subagent, agentId } = hookAudience(body2);
     const hookEvent = String(body2["hook_event_name"] ?? "UserPromptSubmit");
-    const atPrompt = hookEvent === "UserPromptSubmit" || hookEvent === "SessionStart";
+    const atPrompt = hookEvent === "UserPromptSubmit" || hookEvent === "SessionStart" || hookEvent === "SubagentStart";
     if (sid && recallCardEnabled() && atPrompt) {
       setImmediate(() => {
         try {
@@ -53224,20 +53382,38 @@ function buildWebUi(deps) {
         }
       });
     }
-    const block = readContextFileWithHash(deps.paths.root);
+    let block;
+    let storedCard = null;
+    if (subagent !== null) {
+      const own = deps.subagentContext?.({
+        sessionId: sid,
+        agentId,
+        agentType: subagent,
+        ...typeof body2["task_description"] === "string" ? { taskDescription: body2["task_description"] } : {},
+        start: hookEvent === "SubagentStart"
+      }) ?? null;
+      block = own;
+      storedCard = own?.card ?? null;
+    } else {
+      block = readContextFileWithHash(deps.paths.root);
+      storedCard = block ? readContextCard(deps.paths.root, block.hash) : null;
+    }
     const decision = decideContextInject({
       event: hookEvent,
       source: String(body2["source"] ?? ""),
-      sessionId: sid,
+      sessionId: contextKey2,
       block,
       lastInjectedHash
     });
+    if (decision && subagent !== null) lastSubagentInjectAt.set(contextKey2, Date.now());
     let systemMessage = null;
     if (sid && block && recallCardEnabled() && (decision || atPrompt)) {
-      const card = readContextCard(deps.paths.root, block.hash);
+      const card = storedCard && subagent !== null ? forSubagent(storedCard, subagent) : storedCard;
       if (card) {
-        rememberCard(sid, card);
-        if (decision && sid.startsWith("codex:")) systemMessage = renderRecallLine(card);
+        if (subagent !== null && storedCard) rememberAgentCard(sid, agentId, storedCard);
+        else rememberCard(sid, card);
+        if (decision && hookEvent === "SubagentStart") systemMessage = renderRecallLine(card);
+        else if (decision && sid.startsWith("codex:")) systemMessage = renderRecallLine(card);
       }
     }
     if (!decision) return c.json({});
@@ -53423,7 +53599,7 @@ function proposalToIngest(p, profile, daemonVersion) {
     payloadDigest: p.id
   };
 }
-var messageAccumulator, GENERIC_ERROR_WORDS, wsPackagesCache, WS_PACKAGES_TTL_MS, loggedToolSessions, META_LABELS;
+var messageAccumulator, GENERIC_ERROR_WORDS, wsPackagesCache, WS_PACKAGES_TTL_MS, loggedToolSessions, SUBAGENT_REFRESH_MIN_MS, META_LABELS;
 var init_webui = __esm({
   "src/webui.ts"() {
     "use strict";
@@ -53484,6 +53660,7 @@ var init_webui = __esm({
     wsPackagesCache = /* @__PURE__ */ new WeakMap();
     WS_PACKAGES_TTL_MS = 6e4;
     loggedToolSessions = /* @__PURE__ */ new Set();
+    SUBAGENT_REFRESH_MIN_MS = 6e4;
     META_LABELS = /* @__PURE__ */ new Set([
       "Pattern",
       "Technique",
@@ -75365,6 +75542,154 @@ async function chat(req) {
 init_src11();
 init_src6();
 init_recall_signal();
+
+// src/subagent-state.ts
+init_src5();
+var SPAWN_CLAIM_TTL_MS = 2 * 6e4;
+var SUBAGENT_IDLE_TTL_MS = 60 * 6e4;
+var MAX_AGENTS = 200;
+var SEED_INTENT_MAX_CHARS = 400;
+function seedIntentOf(toolInput) {
+  const prompt = typeof toolInput["prompt"] === "string" ? toolInput["prompt"] : "";
+  const stated = parseIntentFences(prompt)[0]?.intent;
+  if (stated) return stated;
+  const description = typeof toolInput["description"] === "string" ? toolInput["description"].trim() : "";
+  const body2 = prompt.replace(/```errata-[\s\S]*?```/g, " ").replace(/\s+/g, " ").trim();
+  const seed = [description, body2].filter(Boolean).join(" \u2014 ");
+  return seed.length > SEED_INTENT_MAX_CHARS ? `${seed.slice(0, SEED_INTENT_MAX_CHARS - 1)}\u2026` : seed;
+}
+function createSubagentState() {
+  const pending = /* @__PURE__ */ new Map();
+  const agents = /* @__PURE__ */ new Map();
+  const sweep = (nowMs) => {
+    for (const [id, a] of agents) if (nowMs - a.lastSeenMs > SUBAGENT_IDLE_TTL_MS) agents.delete(id);
+    while (agents.size > MAX_AGENTS) agents.delete(agents.keys().next().value);
+    for (const [sid, list] of pending) {
+      const live3 = list.filter((s) => nowMs - s.atMs <= SPAWN_CLAIM_TTL_MS);
+      if (live3.length) pending.set(sid, live3);
+      else pending.delete(sid);
+    }
+  };
+  const touch = (agentId, nowMs) => {
+    const a = agents.get(agentId);
+    if (!a) return void 0;
+    if (nowMs - a.lastSeenMs > SUBAGENT_IDLE_TTL_MS) {
+      agents.delete(agentId);
+      return void 0;
+    }
+    a.lastSeenMs = nowMs;
+    return a;
+  };
+  return {
+    noteSpawn(sessionId, toolInput, nowMs) {
+      sweep(nowMs);
+      const prompt = typeof toolInput["prompt"] === "string" ? toolInput["prompt"] : "";
+      const agentType = typeof toolInput["subagent_type"] === "string" ? toolInput["subagent_type"] : "";
+      const list = pending.get(sessionId) ?? [];
+      list.push({ agentType, seedIntent: seedIntentOf(toolInput), share: parseShareFence(prompt), atMs: nowMs });
+      pending.set(sessionId, list);
+    },
+    start({ sessionId, agentId, agentType, taskDescription }, nowMs) {
+      const existing = touch(agentId, nowMs);
+      if (existing) return existing;
+      sweep(nowMs);
+      const list = pending.get(sessionId) ?? [];
+      const i2 = list.findIndex((s) => s.agentType === agentType || s.agentType === "");
+      const spawn6 = i2 >= 0 ? list.splice(i2, 1)[0] : void 0;
+      const seed = spawn6?.seedIntent || (taskDescription ?? "").trim();
+      const entry = {
+        sessionId,
+        agentType,
+        ...seed ? { intent: seed } : {},
+        ownIntent: false,
+        share: spawn6?.share ?? null,
+        lastSeenMs: nowMs
+      };
+      agents.set(agentId, entry);
+      return entry;
+    },
+    get: (agentId, nowMs) => touch(agentId, nowMs),
+    setIntent(agentId, text, nowMs) {
+      const a = touch(agentId, nowMs);
+      const trimmed = text.trim();
+      if (!a || !trimmed) return false;
+      const changed = a.intent !== trimmed;
+      a.intent = trimmed;
+      a.ownIntent = true;
+      return changed;
+    },
+    setWorkingFile(agentId, rel, nowMs) {
+      const a = touch(agentId, nowMs);
+      if (!a || a.workingFile === rel) return false;
+      a.workingFile = rel;
+      return true;
+    },
+    stop(agentId) {
+      agents.delete(agentId);
+    }
+  };
+}
+
+// src/subagent-context.ts
+init_src6();
+init_src5();
+init_src2();
+init_recall_signal();
+var MAX_SHARED_PRIORS = 8;
+var INTENT_HITS = 4;
+function resolveSharedPriors(store, wanted, handleMap, remote) {
+  const out2 = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const ref of wanted) {
+    const id = handleMap[ref]?.id ?? ref;
+    const node2 = store.getNode(id) ?? remote.find((n) => n.id === id || priorHandle(n) === ref) ?? void 0;
+    if (!node2 || seen.has(node2.id)) continue;
+    seen.add(node2.id);
+    out2.push(node2);
+    if (out2.length >= MAX_SHARED_PRIORS) break;
+  }
+  return out2;
+}
+function renderSubagentBlock(args2) {
+  const { store, entry } = args2;
+  const snapshot = isolateSnapshot(structuredClone(args2.base));
+  if (entry.workingFile) {
+    const slice = sliceForFile(store, entry.workingFile, args2.atCommit);
+    if (slice) snapshot.workingFile = slice;
+  }
+  const hits = entry.intent ? searchByIntent(store, entry.intent, { limit: INTENT_HITS }).map((h) => ({
+    id: h.node.id,
+    label: h.node.label,
+    description: h.node.description,
+    coverage: h.coverage
+  })) : [];
+  const shared = entry.share && !entry.share.all ? resolveSharedPriors(store, entry.share.priors, args2.handleMap, args2.remote) : [];
+  const { body: body2, snapshot: shown } = assembleAgentContext({
+    store,
+    profile: args2.profile,
+    ...args2.atCommit ? { atCommit: args2.atCommit } : {},
+    reviewCount: 0,
+    reviewUiUrl: args2.reviewUiUrl,
+    remote: args2.remote,
+    snapshot,
+    ...args2.edgeElicitation ? { edgeElicitation: args2.edgeElicitation } : {},
+    ...entry.intent ? { statedIntent: { text: entry.intent, hits } } : {},
+    ...shared.length ? { sharedPriors: shared } : {}
+  });
+  const profileNodes = [
+    ...shown.profileContext.languages,
+    ...shown.profileContext.packages,
+    ...shown.profileContext.tools
+  ].flatMap((e) => e.node ? [e.node] : []);
+  return {
+    body: body2,
+    hash: contextHash(body2),
+    card: contextCard(store, shown),
+    handleNodes: [...shown.sharedPriors ?? [], ...shown.motifs, ...shown.remote ?? [], ...profileNodes]
+  };
+}
+
+// src/engine.ts
 init_src8();
 init_review2();
 
@@ -81593,7 +81918,7 @@ function createWatchBreaker(deps) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.17-dev.3407" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.17-dev.3421" : "2.0.0-alpha.0";
 var IGNORED_PATH = /[\\/](?:\.git|node_modules|\.errata|\.claude|\.codex|\.cursor|\.turbo|\.next|dist|coverage|test-results|playwright-report|__pycache__)(?:[\\/]|$)/;
 var IGNORED_NOISE = /castalia\.db|eventlog\.sqlite|turn-cursors/;
 var GIT_OP_MUTE_MS = 4e3;
@@ -81991,6 +82316,10 @@ function createWorkspaceEngine(opts) {
     witnessParked: () => witnessQueue.length
   });
   const intents = createIntentState();
+  const subagents = createSubagentState();
+  let subagentBase = null;
+  let subagentBaseVersion = 0;
+  const subagentRenders = /* @__PURE__ */ new Map();
   const toolRuns = createToolRunState();
   let ctxRefreshTimer = null;
   let contextDirty = false;
@@ -82068,6 +82397,7 @@ function createWorkspaceEngine(opts) {
       contextDirty = true;
       return;
     }
+    const baseForSubagents = prebuilt ? structuredClone(prebuilt) : null;
     const doneRender = markPass(`${prebuilt ? "context-render" : "context-render-inline"}:${profile.name}`);
     const pendingUpdate = opts.pendingUpdate?.() ?? null;
     const daemonDistress = opts.daemonDistress?.() ?? null;
@@ -82106,6 +82436,8 @@ function createWorkspaceEngine(opts) {
       } : {}
     });
     doneRender();
+    subagentBase = baseForSubagents ?? structuredClone(snapshot);
+    subagentBaseVersion++;
     try {
       const seq = store.currentIngestSeq();
       const stamped = recordRenderLedger(store, ledger, seq, Date.now());
@@ -82408,7 +82740,11 @@ function createWorkspaceEngine(opts) {
     }
     return { report, localSkills: 0 };
   };
-  const onWorkingFileChanged = (rel, sessionId) => {
+  const onWorkingFileChanged = (rel, sessionId, agentId) => {
+    if (agentId) {
+      subagents.setWorkingFile(agentId, rel, Date.now());
+      return;
+    }
     if (!workingFiles.set(sessionId, rel)) return;
     contextDirty = true;
     if (ctxRefreshTimer) clearTimeout(ctxRefreshTimer);
@@ -82419,6 +82755,48 @@ function createWorkspaceEngine(opts) {
       }
     }, 500);
   };
+  const onSubagentSpawn = (sessionId, toolInput) => {
+    subagents.noteSpawn(sessionId, toolInput, Date.now());
+  };
+  const subagentContext = (a) => {
+    const now = Date.now();
+    const entry = a.start ? subagents.start(a, now) : subagents.get(a.agentId, now);
+    if (!entry) return null;
+    if (entry.share?.all) {
+      const file2 = readContextFileWithHash(opts.workspaceRoot);
+      return file2 ? { body: file2.body, hash: file2.hash, card: readContextCard(opts.workspaceRoot, file2.hash), handleNodes: [] } : null;
+    }
+    if (!subagentBase) {
+      contextDirty = true;
+      return null;
+    }
+    const key = JSON.stringify([subagentBaseVersion, lastRemoteAt, entry.intent, entry.workingFile, entry.share]);
+    const cached2 = subagentRenders.get(a.agentId);
+    if (cached2?.key === key) return cached2.block;
+    const elicit = isEdgeElicitationEnabled();
+    const handlesPath = join35(paths.configDir, "priming-handles.json");
+    const atCommit = readGitRefState(join35(opts.workspaceRoot, ".git")).sha ?? void 0;
+    const block = renderSubagentBlock({
+      store,
+      entry,
+      base: subagentBase,
+      profile,
+      ...atCommit ? { atCommit } : {},
+      reviewUiUrl: opts.reviewUrl(),
+      remote: remotePriors,
+      handleMap: readPrimingHandles(handlesPath),
+      ...elicit ? { edgeElicitation: { instruction: PRIOR_TAG_INSTRUCTION } } : {}
+    });
+    if (elicit && block.handleNodes.length) writePrimingHandles(handlesPath, block.handleNodes);
+    subagentRenders.delete(a.agentId);
+    subagentRenders.set(a.agentId, { key, block });
+    if (subagentRenders.size > 200) subagentRenders.delete(subagentRenders.keys().next().value);
+    return block;
+  };
+  const onSubagentStop = (agentId) => {
+    subagents.stop(agentId);
+    subagentRenders.delete(agentId);
+  };
   const onHookEvent = (e) => {
     const intentHints = deriveIntentHints(e.tool, e.oldString, e.newString);
     const operation = /(?:edit|write|patch)/i.test(e.tool) ? "write" : /read/i.test(e.tool) ? "read" : null;
@@ -82668,8 +83046,10 @@ function createWorkspaceEngine(opts) {
         }
         const touched = new Set(toolRuns.get(sessionId));
         if (touchedFileId) touched.add(touchedFileId);
+        const fenceAgent = turn.agentId ?? (sessionId.startsWith("agent-") ? sessionId.slice(6) : void 0);
         for (const fence of parseIntentFences(turn.text)) {
-          if (intents.set(sessionId, fence.intent, t)) refreshContextNow();
+          if (fenceAgent) subagents.setIntent(fenceAgent, fence.intent, t);
+          else if (intents.set(sessionId, fence.intent, t)) refreshContextNow();
         }
         const plan = harvestInlineTags(store, turn.text, {
           sourceId: sessionLastProblem.get(sessionId),
@@ -83493,7 +83873,7 @@ function createWorkspaceEngine(opts) {
         }
       }
     }
-    setImmediate(() => void harvestTexts(e.sessionId, [{ text: e.text }]));
+    setImmediate(() => void harvestTexts(e.sessionId, [{ text: e.text, ...e.agentId ? { agentId: e.agentId } : {} }]));
   };
   const harvestInFlight = /* @__PURE__ */ new Map();
   const repairedSessions = /* @__PURE__ */ new Set();
@@ -83732,6 +84112,9 @@ B: ${b}`,
     telemetry,
     webHooks: {
       onWorkingFileChanged,
+      onSubagentSpawn,
+      subagentContext,
+      onSubagentStop,
       onHook: () => telemetry.count("hooks_fired"),
       onToolsObserved: (sessionId, toolNodeIds) => toolRuns.record(sessionId, toolNodeIds),
       onHookEvent,
@@ -84129,6 +84512,9 @@ async function startDaemon(opts) {
     profile: engine.profile,
     daemonVersion: DAEMON_VERSION,
     onWorkingFileChanged: engine.webHooks.onWorkingFileChanged,
+    onSubagentSpawn: engine.webHooks.onSubagentSpawn,
+    subagentContext: engine.webHooks.subagentContext,
+    onSubagentStop: engine.webHooks.onSubagentStop,
     onHook: engine.webHooks.onHook,
     onHookEvent: engine.webHooks.onHookEvent,
     onShellEvent: engine.webHooks.onShellEvent,
@@ -86842,7 +87228,14 @@ function stage(profile, patch, now) {
     }
   };
 }
-function unitTiming(postStarted, prepMs, receipt) {
+function isEdgeContentBlock(err2) {
+  return isIntermediaryRejection(err2) && err2 instanceof CloudError && err2.status !== 408 && err2.status !== 429;
+}
+function stageMs(value) {
+  const ms = Number.parseInt(value, 10);
+  return Number.isFinite(ms) ? ms : -1;
+}
+function unitTiming(postStarted, prepMs, receipt, nowMs = Date.now()) {
   const s = (ms) => `${(ms / 1e3).toFixed(1)}s`;
   const parts2 = [`local ${s(prepMs)}`];
   const g = receipt.gate;
@@ -86850,10 +87243,13 @@ function unitTiming(postStarted, prepMs, receipt) {
   if (receipt.timing?.modelMs !== void 0) parts2.push(`model ${s(receipt.timing.modelMs)}`);
   if (receipt.timing?.orderWaitMs) parts2.push(`waited ${s(receipt.timing.orderWaitMs)} for the previous write`);
   if (receipt.timing?.ingestMs !== void 0) {
-    const top = Object.entries(receipt.timing.ingestStages ?? {}).slice(0, 4).map(([k, v]) => `${k} ${v}`);
+    const top = Object.entries(receipt.timing.ingestStages ?? {}).sort((a, b) => stageMs(b[1]) - stageMs(a[1])).slice(0, 4).map(([k, v]) => `${k} ${v}`);
     parts2.push(`ingest ${s(receipt.timing.ingestMs)}${top.length ? ` [${top.join(", ")}]` : ""}`);
   }
-  return ` in ${s(Date.now() - postStarted + prepMs)} (${parts2.join(", ")})`;
+  if (receipt.usage && (receipt.usage.input_tokens || receipt.usage.output_tokens)) {
+    parts2.push(`tokens ${receipt.usage.input_tokens}/${receipt.usage.output_tokens}`);
+  }
+  return ` in ${s(nowMs - postStarted + prepMs)} (${parts2.join(", ")})`;
 }
 function addCounts(a, b) {
   const sum = (k) => (a[k] ?? 0) + (b[k] ?? 0);
@@ -86920,8 +87316,9 @@ async function walk10(root, input, client, opts, readBlob) {
   const prepared = /* @__PURE__ */ new Map();
   const launched = /* @__PURE__ */ new Map();
   const cap = opts.maxUnits;
+  const edgeParked = /* @__PURE__ */ new Set();
   const predecessor = (k) => {
-    for (let j = k - 1; j >= 0; j--) if (!units[j].skip) return units[j];
+    for (let j = k - 1; j >= 0; j--) if (!units[j].skip && !edgeParked.has(j)) return units[j];
     return void 0;
   };
   const prepare = (k) => {
@@ -87025,17 +87422,28 @@ async function walk10(root, input, client, opts, readBlob) {
     let first = head2.settled;
     let outcome = null;
     let attempt = 0;
+    let edgeBlocks = 0;
+    let parkedAtEdge = false;
     while (outcome === null) {
       attempt += 1;
       if (!first && body2.backfill && body2.backfill.anchorSeq === void 0 && anchor.seq !== void 0) {
         body2.backfill = { ...body2.backfill, anchorSeq: anchor.seq };
       }
+      if (!first && body2.after) {
+        const prev = predecessor(k);
+        if (!prev) delete body2.after;
+        else if (prev.sha !== body2.after.sha || prev.subIndex !== body2.after.subIndex) body2.after = { sha: prev.sha, subIndex: prev.subIndex };
+      }
       const settled = await (first ?? settle(Promise.resolve().then(() => post(projectId, body2))));
       first = null;
       if ("err" in settled) {
         const err2 = settled.err;
         const status = err2 instanceof CloudError ? err2.status : 0;
         const elapsed = Math.round((Date.now() - started2) / 1e3);
+        if (isEdgeContentBlock(err2) && ++edgeBlocks >= 2) {
+          parkedAtEdge = true;
+          break;
+        }
         if (Date.now() - started2 > RECOVERY_DEADLINE_MS) {
           profile = stage(profile, { state: "paused", lastError: `unit ${label}: ${status || "connection"} after ${elapsed}s, giving up until the next run` }, now);
           persist(profile);
@@ -87069,6 +87477,19 @@ async function walk10(root, input, client, opts, readBlob) {
       }
       outcome = res;
     }
+    if (parkedAtEdge || outcome === null) {
+      edgeParked.add(k);
+      const runId = `edge-blocked:${u.sha}/${u.subIndex}`;
+      const gaps = [...profile.historyStage?.coverageGaps ?? []];
+      const known = gaps.some((g) => g.runId === runId);
+      counts = addCounts(counts, { commitsWalked: 1, deferredUnits: known ? 0 : 1 });
+      if (!known) gaps.push({ sha: u.sha, subIndex: u.subIndex, runId, reason: "edge-blocked" });
+      profile = stage(profile, { coverageGaps: gaps.slice(-1e3), unitsDone: doneSoFar, counts, ...lastInPosition ? { watermarkSha: positionSha } : {} }, now);
+      persist(profile);
+      processed += 1;
+      log(`[errata] history ${label}: refused at the edge (HTML ${edgeBlocks}\xD7 on its text); coverage gap retained as ${runId}, walking on`);
+      continue;
+    }
     await launchAhead(k);
     switch (outcome.status) {
       case "completed": {
@@ -88313,6 +88734,10 @@ async function startMultiDaemon(opts = {}) {
       daemonVersion: DAEMON_VERSION,
       basePath: `/ws/${id}`,
       onWorkingFileChanged: engine.webHooks.onWorkingFileChanged,
+      // CAP-subagent-prime: each Task-tool subagent's own block.
+      onSubagentSpawn: engine.webHooks.onSubagentSpawn,
+      subagentContext: engine.webHooks.subagentContext,
+      onSubagentStop: engine.webHooks.onSubagentStop,
       onHook: engine.webHooks.onHook,
       onHookEvent: engine.webHooks.onHookEvent,
       onShellEvent: engine.webHooks.onShellEvent,
@@ -88629,6 +89054,19 @@ async function startMultiDaemon(opts = {}) {
     }
     return c.text(statuslineText(String(body2["session_id"] ?? "")));
   });
+  app.post("/api/statusline/subagents", async (c) => {
+    const body2 = await c.req.json().catch(() => ({}));
+    const dir = statuslineDir(body2);
+    if (dir !== null) {
+      const d = normPath(dir);
+      const known = listWorkspaceEntries().some((e) => {
+        const root = normPath(e.path);
+        return d === root || d.startsWith(`${root}/`);
+      });
+      if (!known) return c.text("");
+    }
+    return c.text(subagentRows(body2));
+  });
   for (const r of records) {
     mountedIds.add(r.id);
     app.route(`/ws/${r.id}`, r.webApp);
@@ -90727,8 +91165,9 @@ import { readFileSync } from 'node:fs';
 
 try {
   const port = Number(process.argv[2]);
+  const route = process.argv[3] === 'subagents' ? '/api/statusline/subagents' : '/api/statusline';
   if (Number.isInteger(port) && port > 0 && port < 65536) {
-    const response = await fetch('http://127.0.0.1:' + port + '/api/statusline', {
+    const response = await fetch('http://127.0.0.1:' + port + route, {
       method: 'POST', headers: { 'Content-Type': 'application/json' },
       body: readFileSync(0, 'utf8') || '{}', signal: AbortSignal.timeout(800),
     });
@@ -90738,20 +91177,30 @@ try {
 `;
 var STATUSLINE_RELAY_FILE = "errata-statusline.mjs";
 function buildStatusLine(port, nodePath, relayPath) {
+  return { type: "command", command: relayCommand(port, nodePath, relayPath), padding: 0 };
+}
+function buildSubagentStatusLine(port, nodePath, relayPath) {
+  return { type: "command", command: `${relayCommand(port, nodePath, relayPath)} subagents` };
+}
+function relayCommand(port, nodePath, relayPath) {
   if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error("Invalid status line port");
   const q = (p) => {
     if (/["$`\r\n]/.test(p)) throw new Error("Unsupported character in status line path");
     return `"${p.replace(/\\/g, "/")}"`;
   };
-  return { type: "command", command: `${q(nodePath)} ${q(relayPath)} ${port}`, padding: 0 };
+  return `${q(nodePath)} ${q(relayPath)} ${port}`;
 }
 function isErrataStatusLine(value) {
   return !!value && typeof value === "object" && typeof value["command"] === "string" && value["command"].includes(STATUSLINE_RELAY_FILE);
 }
 function removeProjectStatusLine(settings) {
-  if (!isErrataStatusLine(settings["statusLine"])) return false;
-  delete settings["statusLine"];
-  return true;
+  let removed = false;
+  for (const key of ["statusLine", "subagentStatusLine"]) {
+    if (!isErrataStatusLine(settings[key])) continue;
+    delete settings[key];
+    removed = true;
+  }
+  return removed;
 }
 function userClaudeSettingsPath() {
   const base = process.env["CLAUDE_CONFIG_DIR"] ?? join46(homedir8(), ".claude");
@@ -90772,15 +91221,23 @@ function ensureUserStatusLine(opts) {
       return "unreadable";
     }
   }
-  if (settings["statusLine"] !== void 0 && !isErrataStatusLine(settings["statusLine"])) return "kept-own";
+  const ownMain = settings["statusLine"] !== void 0 && !isErrataStatusLine(settings["statusLine"]);
+  const ownRows = settings["subagentStatusLine"] !== void 0 && !isErrataStatusLine(settings["subagentStatusLine"]);
+  if (ownMain && ownRows) return "kept-own";
   const relay = join46(opts.relayDir, STATUSLINE_RELAY_FILE);
   mkdirSync10(opts.relayDir, { recursive: true });
   if (!existsSync36(relay) || readFileSync39(relay, "utf8") !== STATUSLINE_RELAY_SOURCE) {
     writeFileSync27(relay, STATUSLINE_RELAY_SOURCE, "utf8");
   }
-  const next = buildStatusLine(opts.port, opts.nodePath ?? process.execPath, relay);
-  if (JSON.stringify(settings["statusLine"]) === JSON.stringify(next)) return "unchanged";
-  settings["statusLine"] = next;
+  const nodePath = opts.nodePath ?? process.execPath;
+  const next = {
+    ...ownMain ? {} : { statusLine: buildStatusLine(opts.port, nodePath, relay) },
+    ...ownRows ? {} : { subagentStatusLine: buildSubagentStatusLine(opts.port, nodePath, relay) }
+  };
+  if (Object.entries(next).every(([k, v]) => JSON.stringify(settings[k]) === JSON.stringify(v))) {
+    return ownMain ? "kept-own" : "unchanged";
+  }
+  Object.assign(settings, next);
   mkdirSync10(dirname14(settingsPath), { recursive: true });
   writeFileSync27(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf8");
   return "installed";
@@ -93291,6 +93748,7 @@ async function installClaudeHooks(port) {
   }
   const matcher = "Read|Edit|Write|Grep|Glob|NotebookEdit|Bash";
   const postMatcher = `${matcher}|ToolSearch|mcp__errata__.*`;
+  const preMatcher = `${matcher}|Agent|Task`;
   const preCmd = `${hookRelayCommand(port, "/api/hook")} ${ERRATA_TAG}`;
   const postCmd = `${hookRelayCommand(port, "/api/hook")} ${ERRATA_TAG}`;
   settings.hooks ??= {};
@@ -93300,7 +93758,7 @@ async function installClaudeHooks(port) {
     }
   };
   for (const [event, command, eventMatcher] of [
-    ["PreToolUse", preCmd, matcher],
+    ["PreToolUse", preCmd, preMatcher],
     ["PostToolUse", postCmd, postMatcher],
     ["PostToolUseFailure", postCmd, postMatcher]
   ]) {
@@ -93325,7 +93783,7 @@ async function installClaudeHooks(port) {
   dropErrata(endList);
   endList.push({ hooks: [{ type: "command", command: endCmd }] });
   const injectCmd = `${hookRelayCommand(port, "/api/context-inject")} ${ERRATA_TAG}`;
-  for (const event of ["SessionStart", "UserPromptSubmit"]) {
+  for (const event of ["SessionStart", "UserPromptSubmit", "SubagentStart"]) {
     const list = settings.hooks[event] ??= [];
     dropErrata(list);
     list.push({ hooks: [{ type: "command", command: injectCmd }] });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inerrata-corporation/errata",
-  "version": "2.0.17-dev.3407",
+  "version": "2.0.17-dev.3421",
   "description": "errata - local-first observation engine for AI coding agents",
   "type": "module",
   "bin": {