@iowarp/clio-coder 0.3.8 → 0.3.9

package/dist/{chunk-5C3AQNDW.js → chunk-NNNWO6F2.js}

@@ -827,9 +827,14 @@ function resolveRowSize(value, termHeight) {
 
 // src/interactive/permission-hint.ts
 init_esm_shims();
-function permissionHintEntries(composerHasDraft = false) {
+var MUTATION_PREVIEW_KEY = "v";
+function permissionHintEntries(composerHasDraft = false, inspection = "none") {
   return [
     composerHasDraft ? { key: "Backspace", verb: "clear the draft to allow", short: "clear draft", critical: true } : { key: "Enter", verb: "allow once", short: "allow", critical: true },
+    ...inspection === "none" ? [] : inspection === "open" ? [
+      { key: "\u2191\u2193", verb: "scroll", critical: false },
+      { key: MUTATION_PREVIEW_KEY, verb: "hide mutation", short: "hide", critical: false }
+    ] : [{ key: MUTATION_PREVIEW_KEY, verb: "inspect mutation", short: "inspect", critical: false }],
     { key: "s", verb: "stop turn", short: "stop", critical: true },
     // With a draft, deny and stop are the only immediate answers, so Esc
     // outranks the narrowing that would otherwise drop it first.
@@ -841,6 +846,8 @@ function permissionHintEntries(composerHasDraft = false) {
 var REVERSE_VIDEO_BLANK = `${String.fromCharCode(27)}[7m ${String.fromCharCode(27)}[0m`;
 var EMPTY_PROMPT = "Ask Clio\u2026  / for commands";
 var CONFIRM_PROMPT = "A parked call is waiting for your decision";
+var PREPARING_PROMPT = "Clio has your prompt and is preparing the turn";
+var COMPACTING_PROMPT = "Clio has your prompt and is compacting the context first";
 var MIN_HINT_WIDTH = 60;
 function hasScrollIndicator(line) {
   const stripped = stripTerminalSequences(line);
@@ -870,7 +877,12 @@ function styledRailLabel(theme, chrome) {
 }
 function composerMode(chrome, text) {
   if (chrome.isAwaitingApproval?.() ?? false) return "CONFIRM";
-  if (!(chrome.isStreaming?.() ?? false)) return "MESSAGE";
+  if (!(chrome.isStreaming?.() ?? false)) {
+    const preparation = chrome.getTurnPreparation?.() ?? "idle";
+    if (preparation === "compacting") return "COMPACTING";
+    if (preparation === "preparing") return "PREPARING";
+    return "MESSAGE";
+  }
   const willSteer = chrome.willEnterSteer?.(text) ?? text.trim().length > 0;
   return willSteer ? "STEER" : "FOLLOW-UP";
 }
@@ -880,14 +892,20 @@ function lowerRailHint(theme, chrome) {
     `${chrome.getSubmitKeyLabel?.() ?? "Enter"} send \xB7 ${chrome.getNewlineKeyLabel?.() ?? "Shift+Enter"} newline`
   );
 }
-function confirmRailHint(theme, width, hasDraft) {
-  return theme.fg("warning", fitHintEntries(permissionHintEntries(hasDraft), Math.max(1, width - 3)));
+function confirmRailHint(theme, width, hasDraft, inspection) {
+  return theme.fg("warning", fitHintEntries(permissionHintEntries(hasDraft, inspection), Math.max(1, width - 3)));
 }
 function modeToken(mode) {
-  if (mode === "STEER") return "action";
+  if (mode === "STEER" || mode === "PREPARING" || mode === "COMPACTING") return "action";
   if (mode === "CONFIRM") return "warning";
   return "accentDeep";
 }
+function emptyPromptFor(mode) {
+  if (mode === "CONFIRM") return CONFIRM_PROMPT;
+  if (mode === "PREPARING") return PREPARING_PROMPT;
+  if (mode === "COMPACTING") return COMPACTING_PROMPT;
+  return EMPTY_PROMPT;
+}
 function renderEmptyPrompt(line, width, theme, text = EMPTY_PROMPT) {
   const cursorAt = line.indexOf(REVERSE_VIDEO_BLANK);
   if (cursorAt < 0) return line;
@@ -931,12 +949,12 @@ var ClioEditor = class extends Editor {
       });
     }
     if (text.length === 0 && lines[1]) {
-      lines[1] = renderEmptyPrompt(lines[1], safeWidth, theme, mode === "CONFIRM" ? CONFIRM_PROMPT : EMPTY_PROMPT);
+      lines[1] = renderEmptyPrompt(lines[1], safeWidth, theme, emptyPromptFor(mode));
     }
     const bottomRail = findBottomRail(lines, safeWidth);
     if (bottomRail >= 0 && mode === "CONFIRM") {
       lines[bottomRail] = rule(theme, safeWidth, {
-        right: confirmRailHint(theme, safeWidth, text.length > 0),
+        right: confirmRailHint(theme, safeWidth, text.length > 0, this.chrome.getPermissionInspection?.() ?? "none"),
         fillToken: "frameStrong",
         rightRaw: true,
         rightTail: theme.style("frameStrong", "\u2500", { bold: true })
@@ -977,10 +995,49 @@ init_esm_shims();
 
 // src/interactive/render-trace.ts
 init_esm_shims();
-import { mkdirSync, writeFileSync } from "node:fs";
+import { mkdirSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { appendFile } from "node:fs/promises";
-import { dirname } from "node:path";
+import { dirname, join } from "node:path";
 var RENDER_TRACE_VERSION = 2;
+var INPUT_WEDGE_RING_CAPACITY = 256;
+var INPUT_WEDGE_DUMP_DIRNAME = "input-wedge";
+var INPUT_WEDGE_DUMP_RETAINED = 5;
+function createRing(capacity) {
+  const slots = [];
+  let next = 0;
+  return {
+    push(value) {
+      if (slots.length < capacity) slots.push(value);
+      else slots[next] = value;
+      next = (next + 1) % capacity;
+    },
+    toArray() {
+      if (slots.length < capacity) return [...slots];
+      return [...slots.slice(next), ...slots.slice(0, next)];
+    }
+  };
+}
+function classifyInputWedge(inputIngress, frames) {
+  const newest = [...inputIngress].reverse().find((record) => record.visualExpected) ?? inputIngress.at(-1);
+  if (newest === void 0) return "no-input-recorded";
+  return frames.some((frame2) => frame2.inputHighWater >= newest.inputSeq) ? "input-committed" : "input-not-committed";
+}
+function writeInputWedgeDump(stateDir, snapshot) {
+  const directory = join(stateDir, INPUT_WEDGE_DUMP_DIRNAME);
+  mkdirSync(directory, { recursive: true });
+  const stamp = new Date(snapshot.atEpochMs).toISOString().replace(/[:.]/gu, "-");
+  const path = join(directory, `${stamp}-${snapshot.pid}.json`);
+  writeFileSync(path, `${JSON.stringify(snapshot, null, 2)}
+`, "utf8");
+  try {
+    const existing = readdirSync(directory).filter((name) => name.endsWith(".json")).sort();
+    for (const name of existing.slice(0, Math.max(0, existing.length - INPUT_WEDGE_DUMP_RETAINED))) {
+      rmSync(join(directory, name), { force: true });
+    }
+  } catch {
+  }
+  return path;
+}
 function createAsyncTraceWriter(path, options = {}) {
   const maxRecords = options.maxRecords ?? 4096;
   const batchRecords = options.batchRecords ?? 128;
@@ -1073,11 +1130,16 @@ function renderTracePath(env = process.env) {
   return raw && raw.length > 0 ? raw : null;
 }
 function createRenderTrace(path, now = () => performance.now(), writerOptions = {}) {
-  mkdirSync(dirname(path), { recursive: true });
-  writeFileSync(path, "", "utf8");
+  if (path !== null) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, "", "utf8");
+  }
   const openedAt = now();
+  const openedAtEpochMs = Date.now();
   const at = () => rounded(now() - openedAt);
-  const writer = createAsyncTraceWriter(path, { ...writerOptions, recordTime: at });
+  const writer = path === null ? null : createAsyncTraceWriter(path, { ...writerOptions, recordTime: at });
+  const inputRing = createRing(INPUT_WEDGE_RING_CAPACITY);
+  const frameRing = createRing(INPUT_WEDGE_RING_CAPACITY);
   let frameSeq = 0;
   let writeSeq = 0;
   let eventSeq = 0;
@@ -1093,7 +1155,7 @@ function createRenderTrace(path, now = () => performance.now(), writerOptions =
   let firstCommitDelivered = false;
   const ranges = /* @__PURE__ */ new Map();
   const pendingDrains = /* @__PURE__ */ new Map();
-  writer.enqueue({ type: "trace_start", version: RENDER_TRACE_VERSION, at: 0 });
+  writer?.enqueue({ type: "trace_start", version: RENDER_TRACE_VERSION, at: 0 });
   const trace = {
     recordPanelRender(metrics) {
       pendingPanel = metrics;
@@ -1104,12 +1166,13 @@ function createRenderTrace(path, now = () => performance.now(), writerOptions =
     },
     recordVisibleEvent(fields) {
       eventSeq += 1;
+      if (writer === null) return eventSeq;
       const key = `${generation}:${fields.kind}:${fields.contentIndex}`;
       const previous = ranges.get(key) ?? { codeUnits: 0, graphemes: 0 };
       const graphemes = graphemeCount(fields.delta);
       const next = { codeUnits: previous.codeUnits + fields.delta.length, graphemes: previous.graphemes + graphemes };
       ranges.set(key, next);
-      writer.enqueue({
+      writer?.enqueue({
         type: "event_ingress",
         version: RENDER_TRACE_VERSION,
         eventSeq,
@@ -1127,7 +1190,7 @@ function createRenderTrace(path, now = () => performance.now(), writerOptions =
     },
     recordQueue(sequence, action) {
       queueDepth = Math.max(0, queueDepth + (action === "admit" ? 1 : -1));
-      writer.enqueue({
+      writer?.enqueue({
         type: "queue",
         version: RENDER_TRACE_VERSION,
         eventSeq: sequence,
@@ -1138,7 +1201,7 @@ function createRenderTrace(path, now = () => performance.now(), writerOptions =
     },
     recordPanelApplied(sequence) {
       panelHighWater = Math.max(panelHighWater, sequence);
-      writer.enqueue({
+      writer?.enqueue({
         type: "panel",
         version: RENDER_TRACE_VERSION,
         eventSeq: sequence,
@@ -1149,7 +1212,7 @@ function createRenderTrace(path, now = () => performance.now(), writerOptions =
     recordInputIngress(action, bytes, visualExpected = action !== "no-visual-change") {
       inputSeq += 1;
       if (visualExpected) inputHighWater = inputSeq;
-      writer.enqueue({
+      const record = {
         type: "input_ingress",
         version: RENDER_TRACE_VERSION,
         inputSeq,
@@ -1157,7 +1220,9 @@ function createRenderTrace(path, now = () => performance.now(), writerOptions =
         at: at(),
         bytes,
         visualExpected
-      });
+      };
+      inputRing.push(record);
+      writer?.enqueue(record);
       return inputSeq;
     },
     beginFrame(fields) {
@@ -1205,8 +1270,9 @@ function createRenderTrace(path, now = () => performance.now(), writerOptions =
         },
         commits: frame2.commits
       };
-      writer.enqueue(record);
+      writer?.enqueue(record);
       if (frame2.commits.length > 0) {
+        frameRing.push(record);
         lastCommitAt = frame2.commits.at(-1)?.at ?? endAt;
         if (!firstCommitDelivered) {
           firstCommitDelivered = true;
@@ -1241,6 +1307,7 @@ function createRenderTrace(path, now = () => performance.now(), writerOptions =
         backpressured: !fields.returned
       };
       currentFrame?.commits.push(commit);
+      if (writer === null) return writeSeq;
       writer.enqueue({ type: "terminal_write", version: RENDER_TRACE_VERSION, frameId, ...commit });
       if (!fields.returned) pendingDrains.set(writeSeq, { frameId, at: commit.at });
       return writeSeq;
@@ -1250,7 +1317,7 @@ function createRenderTrace(path, now = () => performance.now(), writerOptions =
       if (!pending) return;
       pendingDrains.delete(writeId);
       const drainAt = at();
-      writer.enqueue({
+      writer?.enqueue({
         type: "terminal_drain",
         version: RENDER_TRACE_VERSION,
         writeId,
@@ -1263,7 +1330,28 @@ function createRenderTrace(path, now = () => performance.now(), writerOptions =
     onFirstFrameCommit(listener) {
       firstCommitListener = listener;
     },
-    close: () => writer.close()
+    snapshotInputWedge() {
+      const inputIngress = inputRing.toArray();
+      const frames = frameRing.toArray();
+      const nowAt = at();
+      const lastIngressAt = inputIngress.at(-1)?.at;
+      const lastFrame = frames.at(-1);
+      const lastFrameCommitAt = lastFrame?.commits.at(-1)?.at ?? lastFrame?.endAt;
+      return {
+        version: RENDER_TRACE_VERSION,
+        capacity: INPUT_WEDGE_RING_CAPACITY,
+        pid: process.pid,
+        openedAtEpochMs,
+        atEpochMs: Date.now(),
+        at: nowAt,
+        classification: classifyInputWedge(inputIngress, frames),
+        msSinceLastInputIngress: lastIngressAt === void 0 ? null : rounded(nowAt - lastIngressAt),
+        msSinceLastCommittedFrame: lastFrameCommitAt === void 0 ? null : rounded(nowAt - lastFrameCommitAt),
+        inputIngress,
+        frames
+      };
+    },
+    close: () => writer?.close() ?? Promise.resolve()
   };
   return trace;
 }
@@ -1490,20 +1578,18 @@ function createProcessInteractiveShell(options = {}) {
   let restoreRoot = null;
   let backpressure = null;
   let observedBackpressure = false;
-  if (tracePath) {
-    let candidate = null;
-    try {
-      candidate = createRenderTrace(tracePath);
-      restoreStdout = traceProcessStdout(candidate);
-      activeRenderTrace = candidate;
-    } catch {
-      restoreStdout?.();
-      restoreStdout = null;
-      void candidate?.close().catch(() => {
-      });
-      activeRenderTrace = null;
-    }
-  } else activeRenderTrace = null;
+  let candidate = null;
+  try {
+    candidate = createRenderTrace(tracePath);
+    restoreStdout = traceProcessStdout(candidate);
+    activeRenderTrace = candidate;
+  } catch {
+    restoreStdout?.();
+    restoreStdout = null;
+    void candidate?.close().catch(() => {
+    });
+    activeRenderTrace = null;
+  }
   const trace = activeRenderTrace;
   if (trace && options.onFirstFrameCommit) trace.onFirstFrameCommit(options.onFirstFrameCommit);
   let firstFrameDelivered = false;
@@ -2187,8 +2273,10 @@ export {
   formatRuntimeResolutionDiagnostic,
   runtimeResolutionDiagnosticLine,
   showClioOverlayFrame,
+  MUTATION_PREVIEW_KEY,
   permissionHintEntries,
   ClioEditor,
+  writeInputWedgeDump,
   getActiveRenderTrace,
   createProcessInteractiveShell,
   validateKeybindings,
@@ -2198,4 +2286,4 @@ export {
   formatPlatformKeybindingNotice,
   createKeybindingManager
 };
-//# sourceMappingURL=chunk-5C3AQNDW.js.map
+//# sourceMappingURL=chunk-NNNWO6F2.js.map

package/dist/{chunk-GU2UIAFZ.js → chunk-NQ6UCCOD.js}

@@ -4,14 +4,14 @@ import {
   listChecks,
   runProjectCheck,
   runScriptCheck
-} from "./chunk-VAWNZU7Z.js";
+} from "./chunk-P3JGPQFL.js";
 import {
   BROWSER_MODES,
   maxOutputArg,
   prepareVerifyArguments,
   timeoutArg,
   verifyToolSurface
-} from "./chunk-PMDBGQSJ.js";
+} from "./chunk-CA42X6KT.js";
 import {
   escapeRegExp
 } from "./chunk-VG7TBQIY.js";
@@ -633,4 +633,4 @@ var verifyTool = {
 export {
   verifyTool
 };
-//# sourceMappingURL=chunk-GU2UIAFZ.js.map
+//# sourceMappingURL=chunk-NQ6UCCOD.js.map

package/dist/{chunk-N22QMJKY.js → chunk-NZU6YDNV.js}

@@ -1,18 +1,18 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   receiptResponseModelIdObservationLabel
-} from "./chunk-HLE42MG7.js";
+} from "./chunk-D73KXYPF.js";
 import {
   adaptRunReceiptTrustStatus,
   formatTrustAxes,
   formatTrustSummary
-} from "./chunk-K4XHGFR5.js";
+} from "./chunk-MLOK6ZOS.js";
 import {
   formatBudgetPolicy,
   formatBudgetReasons,
   formatBudgetRequest,
   formatEffectiveBudget
-} from "./chunk-A3WNZD3P.js";
+} from "./chunk-4H6ULJ3H.js";
 import {
   mentionsWorkerToolCallCap
 } from "./chunk-4ZG3XFUR.js";
@@ -173,4 +173,4 @@ export {
   workerTextLabel,
   workerTextNonEvidenceNotices
 };
-//# sourceMappingURL=chunk-N22QMJKY.js.map
+//# sourceMappingURL=chunk-NZU6YDNV.js.map

package/dist/{chunk-ZVJ5BLO2.js → chunk-O6I4CIEU.js}

@@ -1,7 +1,7 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   ceilChars
-} from "./chunk-RWSI4YD7.js";
+} from "./chunk-AEYBF3TB.js";
 import {
   clioStateDir
 } from "./chunk-BNAZZHFG.js";
@@ -231,6 +231,83 @@ function taskMemoryBankDelta(before, after) {
     procedural: entryDelta(before.procedural, after.procedural)
   };
 }
+function parseTaskMemoryTelemetryRecord(value) {
+  if (!isRecord(value) || !hasExactKeys(value, TELEMETRY_KEYS)) return null;
+  if (value.version !== TASK_MEMORY_TELEMETRY_VERSION || !validIsoTimestamp(value.at)) return null;
+  if (!validTriggerReasons(value.triggerReasons) || !isTier(value.tier) || !isDecision(value.decision)) return null;
+  if (!isReason(value.reason) || !isNonNegativeInteger(value.citedEntries)) return null;
+  if (!isNonNegativeInteger(value.bankOperations) || !isNonNegativeInteger(value.droppedOperations)) return null;
+  const bankDelta = parseBankDelta(value.bankDelta);
+  const tokenCost = parseTokenCost(value.tokenCost);
+  if (bankDelta === null || tokenCost === null || !isNonNegativeFinite(value.latencyMs)) return null;
+  return {
+    version: TASK_MEMORY_TELEMETRY_VERSION,
+    at: value.at,
+    triggerReasons: value.triggerReasons,
+    tier: value.tier,
+    bankDelta,
+    decision: value.decision,
+    reason: value.reason,
+    bankOperations: value.bankOperations,
+    droppedOperations: value.droppedOperations,
+    citedEntries: value.citedEntries,
+    tokenCost,
+    latencyMs: value.latencyMs
+  };
+}
+var TELEMETRY_KEYS = [
+  "version",
+  "at",
+  "triggerReasons",
+  "tier",
+  "bankDelta",
+  "decision",
+  "reason",
+  "bankOperations",
+  "droppedOperations",
+  "citedEntries",
+  "tokenCost",
+  "latencyMs"
+];
+var DELTA_KEYS = ["status", "knowledge", "procedural"];
+var CLASS_DELTA_KEYS = ["added", "updated", "deleted"];
+var TOKEN_KEYS = ["input", "output", "total"];
+var TRIGGERS = /* @__PURE__ */ new Set([
+  "interval",
+  "tool_error_streak",
+  "loop_signal",
+  "repeated_failure",
+  "turn_end",
+  "post_compaction",
+  "manual"
+]);
+var DECISIONS = /* @__PURE__ */ new Set([
+  "silent",
+  "injected",
+  "gated",
+  "timeout",
+  "malformed",
+  "dropped"
+]);
+var REASONS = /* @__PURE__ */ new Set([
+  "intervened",
+  "model_silent",
+  "duplicate_reminder",
+  "suppressed",
+  "uncited",
+  "over_budget",
+  "unparseable",
+  "all_operations_invalid",
+  "deadline",
+  "timed_out",
+  "endpoint_busy",
+  "client_error",
+  "no_client",
+  "no_consumer",
+  "step_in_flight",
+  "no_repeated_failure",
+  "bank_empty"
+]);
 function entryDelta(before, after) {
   const old = new Map(before.map((entry) => [entry.id, entry]));
   const next = new Map(after.map((entry) => [entry.id, entry]));
@@ -250,9 +327,58 @@ function entryDelta(before, after) {
 function sameEntry(left, right) {
   return left.content === right.content && left.createdAt === right.createdAt;
 }
+function parseBankDelta(value) {
+  if (!isRecord(value) || !hasExactKeys(value, DELTA_KEYS)) return null;
+  const status = parseClassDelta(value.status);
+  const knowledge = parseClassDelta(value.knowledge);
+  const procedural = parseClassDelta(value.procedural);
+  return status === null || knowledge === null || procedural === null ? null : { status, knowledge, procedural };
+}
+function parseClassDelta(value) {
+  if (!isRecord(value) || !hasExactKeys(value, CLASS_DELTA_KEYS)) return null;
+  return isNonNegativeInteger(value.added) && isNonNegativeInteger(value.updated) && isNonNegativeInteger(value.deleted) ? { added: value.added, updated: value.updated, deleted: value.deleted } : null;
+}
+function parseTokenCost(value) {
+  if (!isRecord(value) || !hasExactKeys(value, TOKEN_KEYS)) return null;
+  if (!isNonNegativeInteger(value.input) || !isNonNegativeInteger(value.output) || !isNonNegativeInteger(value.total))
+    return null;
+  if (value.total !== value.input + value.output) return null;
+  return { input: value.input, output: value.output, total: value.total };
+}
+function validTriggerReasons(value) {
+  return Array.isArray(value) && value.length > 0 && value.length <= 3 && new Set(value).size === value.length && value.every((item) => typeof item === "string" && TRIGGERS.has(item));
+}
+function isTier(value) {
+  return value === "rules" || value === "llm";
+}
+function isDecision(value) {
+  return typeof value === "string" && DECISIONS.has(value);
+}
+function isReason(value) {
+  return typeof value === "string" && REASONS.has(value);
+}
+function validIsoTimestamp(value) {
+  if (typeof value !== "string" || value.length > 40) return false;
+  const timestamp = Date.parse(value);
+  return Number.isFinite(timestamp) && new Date(timestamp).toISOString() === value;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasExactKeys(value, keys) {
+  const actual = Object.keys(value).sort();
+  const expected = [...keys].sort();
+  return actual.length === expected.length && actual.every((key, index) => key === expected[index]);
+}
+function isNonNegativeInteger(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
 function nonNegativeInteger(value) {
   return Number.isSafeInteger(value) && value >= 0 ? value : 0;
 }
+function isNonNegativeFinite(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
 function nonNegativeFinite(value) {
   return Number.isFinite(value) && value >= 0 ? value : 0;
 }
@@ -303,7 +429,7 @@ function buildMemoryInterventionUserPrompt(input) {
 
 // src/domains/memory/task-memory-policy.ts
 var TASK_MEMORY_POLICY_MAX_OPERATIONS = 8;
-var TASK_MEMORY_POLICY_DEFAULT_TIMEOUT_MS = 18e4;
+var TASK_MEMORY_POLICY_DEFAULT_TIMEOUT_MS = 3e4;
 var TASK_MEMORY_POLICY_MODEL_MAX_OUTPUT_TOKENS = 4e3;
 var TASK_PROMPT_MAX_CHARS = 2e3;
 var TRAJECTORY_PROMPT_MAX_CHARS = 4e3;
@@ -331,6 +457,7 @@ async function runTaskMemoryPolicy(bank, client, input) {
   let userPrompt = "";
   let rawResponse = "";
   let clientError = null;
+  let stepUsage = null;
   const settle = (decision, reason, parts = {}) => {
     const result = {
       decision,
@@ -339,7 +466,8 @@ async function runTaskMemoryPolicy(bank, client, input) {
       droppedOperations: parts.droppedOperations ?? 0,
       reminder: parts.reminder ?? null,
       inputTokens: parts.inputTokens ?? 0,
-      outputTokens: parts.outputTokens ?? 0
+      outputTokens: parts.outputTokens ?? 0,
+      usage: stepUsage
     };
     try {
       input.onEnvelope?.({
@@ -379,9 +507,10 @@ async function runTaskMemoryPolicy(bank, client, input) {
       return settle("timeout", "deadline");
     }
     rawResponse = typeof response.text === "string" ? response.text : "";
+    stepUsage = response.usage ?? null;
     const usage = {
-      inputTokens: nonNegativeInteger2(response.inputTokens),
-      outputTokens: nonNegativeInteger2(response.outputTokens)
+      inputTokens: nonNegativeInteger2(response.inputTokens ?? stepUsage?.input),
+      outputTokens: nonNegativeInteger2(response.outputTokens ?? stepUsage?.output)
     };
     const read = readPolicyStep(rawResponse);
     if (!read.ok) return settle("malformed", read.reason, { ...usage, droppedOperations: read.dropped });
@@ -403,6 +532,7 @@ async function runTaskMemoryPolicy(bank, client, input) {
     return settle("injected", "intervened", { ...counts, reminder });
   } catch (error) {
     clientError = errorMessage(error);
+    if (isTimeoutError(error)) return settle("timeout", "timed_out");
     return settle("silent", "client_error");
   } finally {
     if (timer !== void 0) clearTimeout(timer);
@@ -493,10 +623,10 @@ function readOperations(value) {
   const operations = [];
   let dropped = 0;
   for (const raw of value) {
-    if (!isRecord(raw) || typeof raw.op !== "string") return null;
+    if (!isRecord2(raw) || typeof raw.op !== "string") return null;
     switch (raw.op) {
       case "update_status": {
-        if (!hasExactKeys(raw, ["op", "content"])) return null;
+        if (!hasExactKeys2(raw, ["op", "content"])) return null;
         const content = boundedContent(raw.content);
         if (content === null) return null;
         operations.push({ op: raw.op, content });
@@ -504,7 +634,7 @@ function readOperations(value) {
       }
       case "save_knowledge":
       case "save_procedural": {
-        if (!hasExactKeys(raw, raw.id === void 0 ? ["op", "content"] : ["op", "content", "id"])) return null;
+        if (!hasExactKeys2(raw, raw.id === void 0 ? ["op", "content"] : ["op", "content", "id"])) return null;
         const content = boundedContent(raw.content);
         if (content === null) return null;
         if (raw.id !== void 0 && !nonEmptyString(raw.id)) return null;
@@ -514,7 +644,7 @@ function readOperations(value) {
         break;
       }
       case "delete":
-        if (!hasExactKeys(raw, ["op", "id"]) || !nonEmptyString(raw.id)) return null;
+        if (!hasExactKeys2(raw, ["op", "id"]) || !nonEmptyString(raw.id)) return null;
         operations.push({ op: raw.op, id: raw.id });
         break;
       default:
@@ -585,10 +715,10 @@ function boundedContent(value) {
   const normalized = value.replace(/\s+/gu, " ").trim();
   return normalized.length > 0 && normalized.length <= TASK_MEMORY_CONTENT_MAX_CHARS ? normalized : null;
 }
-function isRecord(value) {
+function isRecord2(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
-function hasExactKeys(record, expected) {
+function hasExactKeys2(record, expected) {
   const keys = Object.keys(record).sort();
   return keys.length === expected.length && [...expected].sort().every((key, index) => keys[index] === key);
 }
@@ -601,6 +731,12 @@ function positiveInteger2(value, fallback) {
 function nonNegativeInteger2(value) {
   return value !== void 0 && Number.isInteger(value) && value >= 0 ? value : 0;
 }
+function isTimeoutError(error) {
+  const name = error instanceof Error ? error.name : "";
+  if (name === "AbortError" || name === "TimeoutError") return true;
+  const message = error instanceof Error ? error.message : typeof error === "string" ? error : "";
+  return /\b(abort(ed)?|timed out|timeout)\b/iu.test(message);
+}
 function errorMessage(error) {
   if (error instanceof Error) return error.message.length > 0 ? error.message : error.name;
   return typeof error === "string" && error.length > 0 ? error : "an unknown client failure";
@@ -613,7 +749,9 @@ export {
   TaskMemoryBank,
   TASK_MEMORY_POLICY_DEFAULT_TIMEOUT_MS,
   runTaskMemoryPolicy,
+  TASK_MEMORY_TELEMETRY_FILE,
   createTaskMemoryTelemetrySink,
-  taskMemoryBankDelta
+  taskMemoryBankDelta,
+  parseTaskMemoryTelemetryRecord
 };
-//# sourceMappingURL=chunk-ZVJ5BLO2.js.map
+//# sourceMappingURL=chunk-O6I4CIEU.js.map

package/dist/{chunk-XN3L4EYL.js → chunk-OEDBCISO.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-CGKSTWHD.js";
 import {
   StringEnum
-} from "./chunk-FCSXB6T2.js";
+} from "./chunk-UOSL25KY.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -43,4 +43,4 @@ export {
   CODE_NAV_MAX_LIMIT,
   codeNavToolSurface
 };
-//# sourceMappingURL=chunk-XN3L4EYL.js.map
+//# sourceMappingURL=chunk-OEDBCISO.js.map

package/dist/{chunk-VAWNZU7Z.js → chunk-P3JGPQFL.js}

@@ -1,7 +1,7 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   runVectorTool
-} from "./chunk-PMDBGQSJ.js";
+} from "./chunk-CA42X6KT.js";
 import {
   PROJECT_VERIFIER_CATALOG_RELATIVE_PATH,
   loadProjectVerifierCatalog,
@@ -239,4 +239,4 @@ export {
   runProjectCheck,
   runScriptCheck
 };
-//# sourceMappingURL=chunk-VAWNZU7Z.js.map
+//# sourceMappingURL=chunk-P3JGPQFL.js.map