@dungle-scrubs/harness-cli-normalizer 0.1.1

package/dist/interpretation/content.js

@@ -0,0 +1,169 @@
+import { asRecord } from "./shape.js";
+/** Text of an array of `{type:"text", text}` content blocks. */
+const textOfBlocks = (content) => Array.isArray(content)
+    ? content
+        .map((b) => asRecord(b))
+        .filter((b) => b !== null && b.type === "text")
+        .map((b) => (typeof b.text === "string" ? b.text : ""))
+        .join("")
+    : "";
+const at = (record, path) => {
+    let cursor = record;
+    for (const seg of path.split(".")) {
+        const inner = asRecord(cursor);
+        if (inner === null)
+            return undefined;
+        cursor = inner[seg];
+    }
+    return cursor;
+};
+const claude = (r) => {
+    const events = [];
+    if (r.type === "assistant") {
+        const content = at(r, "message.content");
+        if (Array.isArray(content)) {
+            for (const raw of content) {
+                const block = asRecord(raw);
+                if (block?.type === "tool_use" && typeof block.name === "string") {
+                    events.push({ kind: "tool", name: block.name, input: block.input });
+                }
+            }
+        }
+        const text = textOfBlocks(content);
+        if (text !== "")
+            events.push({ kind: "message", role: "assistant", text });
+    }
+    else if (r.type === "stream_event") {
+        const delta = at(r, "event.delta");
+        const d = asRecord(delta);
+        if (d?.type === "text_delta" && typeof d.text === "string") {
+            events.push({ kind: "token", text: d.text });
+        }
+    }
+    else if (r.type === "system" && r.subtype !== "init" && typeof r.subtype === "string") {
+        // Non-init system lines (hook_started etc.) surface as droppable
+        // progress, as the pre-refactor decoder did. The init line is the
+        // identity announcement, handled upstream.
+        events.push({ kind: "progress", label: r.subtype });
+    }
+    else if (r.type === "result" && r.is_error === true) {
+        // A result line marked is_error is a failed turn (max-turns, execution
+        // error) - surface it so a streamTurn consumer sees the failure, not a
+        // clean turn. (openSession handles result boundaries itself.)
+        const sub = typeof r.subtype === "string" ? r.subtype : "result error";
+        events.push({ kind: "error", message: `turn failed: ${sub}` });
+    }
+    return events;
+};
+// codex item types that are NOT tool activity - everything else on
+// item.started is a tool of some kind (command_execution, file_change,
+// mcp_tool_call, web_search, ...), surfaced generically by item.type.
+const CODEX_NON_TOOL = new Set(["agent_message", "error", "reasoning", "todo_list"]);
+const codex = (r) => {
+    const item = asRecord(r.item);
+    if (item === null)
+        return [];
+    // Tool activity is emitted once on start so it is not double-counted
+    // against the completion record. Any non-message/reasoning item is a tool;
+    // name it by its item.type, carry the most useful field as input.
+    if (r.type === "item.started" &&
+        typeof item.type === "string" &&
+        !CODEX_NON_TOOL.has(item.type)) {
+        const name = item.type === "command_execution" ? "shell" : item.type;
+        const input = item.command ?? item.changes ?? item.query ?? item.invocation ?? undefined;
+        return [{ kind: "tool", name, input }];
+    }
+    if (r.type !== "item.completed")
+        return [];
+    if (item.type === "agent_message" && typeof item.text === "string") {
+        return [{ kind: "message", role: "assistant", text: item.text }];
+    }
+    if (item.type === "error" && typeof item.message === "string") {
+        return [{ kind: "error", message: item.message }];
+    }
+    return [];
+};
+const pi = (r) => {
+    // One clean tool event per invocation (the toolcall_start/delta/end and
+    // tool_execution_update stream is noise; tool_execution_start fires once).
+    if (r.type === "tool_execution_start" && typeof r.toolName === "string") {
+        return [{ kind: "tool", name: r.toolName, input: r.args }];
+    }
+    if (r.type === "message_update") {
+        const ev = asRecord(r.assistantMessageEvent);
+        if (ev?.type === "text_delta" && typeof ev.delta === "string") {
+            return [{ kind: "token", text: ev.delta }];
+        }
+        return [];
+    }
+    if (r.type === "message_end") {
+        const message = asRecord(r.message);
+        if (message?.role === "assistant") {
+            // A turn that ends with stopReason "error" is a provider/auth/token
+            // failure pi does NOT print to stderr and exits 0 for (verified with
+            // an expired minimax token: empty content, stopReason error, clean
+            // exit). Without this the failure is invisible - a silent empty turn.
+            if (message.stopReason === "error") {
+                return [
+                    { kind: "error", message: "pi turn ended with stopReason error (provider/auth failure)" },
+                ];
+            }
+            const text = textOfBlocks(message.content);
+            if (text !== "")
+                return [{ kind: "message", role: "assistant", text }];
+        }
+    }
+    return [];
+};
+const muse = (r) => {
+    const payload = asRecord(r.payload);
+    if (payload === null)
+        return [];
+    // Tool activity: muse emits a tool_result naming the tool in
+    // correlation_facts.tool_name, with the command inside the result text.
+    if (payload.kind === "tool_result") {
+        const facts = asRecord(payload.correlation_facts);
+        const name = typeof facts?.tool_name === "string" ? facts.tool_name : "tool";
+        // Shell tools carry a JSON result with a `command`; file tools carry
+        // plain prose. Surface the command when present, else leave input off
+        // (the tool name is the signal that matters).
+        let command;
+        if (typeof payload.text === "string") {
+            try {
+                command = JSON.parse(payload.text).command;
+            }
+            catch {
+                command = undefined;
+            }
+        }
+        return [{ kind: "tool", name, input: command }];
+    }
+    if (payload.kind === "run_output_delta" && typeof payload.text === "string") {
+        return [{ kind: "token", text: payload.text }];
+    }
+    if (payload.kind === "run_terminal") {
+        if (payload.terminal === "completed" &&
+            typeof payload.text === "string" &&
+            payload.text !== "") {
+            return [{ kind: "message", role: "assistant", text: payload.text }];
+        }
+        if (payload.terminal === "failed") {
+            const reason = typeof payload.reason === "string" ? payload.reason : "run failed";
+            return [{ kind: "error", message: `muse run failed: ${reason}` }];
+        }
+    }
+    return [];
+};
+const READERS = {
+    claude,
+    codex,
+    pi,
+    muse,
+};
+export const contentEventsOf = (harness, raw) => {
+    const record = asRecord(raw);
+    if (record === null)
+        return [];
+    return READERS[harness](record);
+};
+//# sourceMappingURL=content.js.map

package/dist/interpretation/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/interpretation/content.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAStC,gEAAgE;AAChE,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAU,EAAE,CAChD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;IACpB,CAAC,CAAC,OAAO;SACJ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SACvB,MAAM,CAAC,CAAC,CAAC,EAAgC,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;SAC5E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACtD,IAAI,CAAC,EAAE,CAAC;IACb,CAAC,CAAC,EAAE,CAAC;AAET,MAAM,EAAE,GAAG,CAAC,MAA+B,EAAE,IAAY,EAAW,EAAE;IACpE,IAAI,MAAM,GAAY,MAAM,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACrC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,CAA0B,EAAkB,EAAE;IAC5D,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC5B,IAAI,KAAK,EAAE,IAAI,KAAK,UAAU,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACjE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;SAAM,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3D,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;SAAM,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxF,iEAAiE;QACjE,kEAAkE;QAClE,2CAA2C;QAC3C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;SAAM,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtD,uEAAuE;QACvE,uEAAuE;QACvE,8DAA8D;QAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,mEAAmE;AACnE,uEAAuE;AACvE,sEAAsE;AACtE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,eAAe,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAErF,MAAM,KAAK,GAAG,CAAC,CAA0B,EAAkB,EAAE;IAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,qEAAqE;IACrE,2EAA2E;IAC3E,kEAAkE;IAClE,IACE,CAAC,CAAC,IAAI,KAAK,cAAc;QACzB,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAC7B,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAC9B,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC;QACzF,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,EAAE,CAAC;IAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnE,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC9D,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,EAAE,GAAG,CAAC,CAA0B,EAAkB,EAAE;IACxD,wEAAwE;IACxE,2EAA2E;IAC3E,IAAI,CAAC,CAAC,IAAI,KAAK,sBAAsB,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACxE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;QAC7C,IAAI,EAAE,EAAE,IAAI,KAAK,YAAY,IAAI,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9D,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,OAAO,EAAE,IAAI,KAAK,WAAW,EAAE,CAAC;YAClC,oEAAoE;YACpE,qEAAqE;YACrE,mEAAmE;YACnE,sEAAsE;YACtE,IAAI,OAAO,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;gBACnC,OAAO;oBACL,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,6DAA6D,EAAE;iBAC1F,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,IAAI,KAAK,EAAE;gBAAE,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,CAA0B,EAAkB,EAAE;IAC1D,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAChC,6DAA6D;IAC7D,wEAAwE;IACxE,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,OAAO,KAAK,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7E,qEAAqE;QACrE,sEAAsE;QACtE,8CAA8C;QAC9C,IAAI,OAAgB,CAAC;QACrB,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,OAAO,GAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAA6B,CAAC,OAAO,CAAC;YAC1E,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,SAAS,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5E,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACpC,IACE,OAAO,CAAC,QAAQ,KAAK,WAAW;YAChC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;YAChC,OAAO,CAAC,IAAI,KAAK,EAAE,EACnB,CAAC;YACD,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;YAClF,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,MAAM,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,OAAO,GAAwE;IACnF,MAAM;IACN,KAAK;IACL,EAAE;IACF,IAAI;CACL,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAoB,EAAE,GAAY,EAAkB,EAAE;IACpF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC/B,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC,CAAC"}

package/dist/interpretation/context.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Context-hook decoding: recognizes the harness's context-window usage
+ * payload and surfaces it as a `context` HarnessEvent, the droppable
+ * gauge-class event the chat layer may coalesce under pressure. For claude
+ * the payload arrives on the STATUSLINE channel, never on stream-json
+ * stdout - route this at the channel level, do not call it per stdout line.
+ * Values are sanitized (v1 sanitizeContext): non-finite is rejected,
+ * out-of-range is clamped, so callers report nothing rather than a broken
+ * gauge.
+ */
+import type { HarnessDescriptor } from "../knowledge/descriptor.js";
+export interface ContextEvent {
+    readonly kind: "context";
+    readonly usedPct: number;
+}
+export declare const contextEventFrom: (h: HarnessDescriptor, raw: unknown) => ContextEvent | null;
+//# sourceMappingURL=context.d.ts.map

package/dist/interpretation/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/interpretation/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,gBAAgB,MAAO,iBAAiB,OAAO,OAAO,KAAG,YAAY,GAAG,IASpF,CAAC"}

package/dist/interpretation/context.js

@@ -0,0 +1,16 @@
+import { asRecord } from "./shape.js";
+export const contextEventFrom = (h, raw) => {
+    if (h.contextHook === null)
+        return null;
+    const record = asRecord(raw);
+    if (record === null)
+        return null;
+    const outer = asRecord(record[h.contextHook.object]);
+    if (outer === null)
+        return null;
+    const usedPct = outer[h.contextHook.usedPctField];
+    if (typeof usedPct !== "number" || !Number.isFinite(usedPct))
+        return null;
+    return { kind: "context", usedPct: Math.min(100, Math.max(0, usedPct)) };
+};
+//# sourceMappingURL=context.js.map

package/dist/interpretation/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/interpretation/context.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAoB,EAAE,GAAY,EAAuB,EAAE;IAC1F,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC,CAAC"}

package/dist/interpretation/dimensions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Small dimension accessors: one interpretation function per PLAN 3.1
+ * dimension whose value is a direct descriptor lookup. They exist so every
+ * dimension has a single named owner in the interpretation layer - callers
+ * never reach into descriptor internals.
+ */
+import type { HarnessDescriptor } from "../knowledge/descriptor.js";
+export declare const stdinPolicyOf: (h: HarnessDescriptor) => "inherit" | "close-required";
+export declare const providerFlagOf: (h: HarnessDescriptor) => string | null;
+export declare const toolsFlagOf: (h: HarnessDescriptor) => string | null;
+export declare const discoveryDisableFlagsOf: (h: HarnessDescriptor) => readonly string[];
+export declare const autonomyFlagOf: (h: HarnessDescriptor) => string | null;
+//# sourceMappingURL=dimensions.d.ts.map

package/dist/interpretation/dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/interpretation/dimensions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,eAAO,MAAM,aAAa,MAAO,iBAAiB,KAAG,SAAS,GAAG,gBAA2B,CAAC;AAE7F,eAAO,MAAM,cAAc,MAAO,iBAAiB,KAAG,MAAM,GAAG,IACjB,CAAC;AAE/C,eAAO,MAAM,WAAW,MAAO,iBAAiB,KAAG,MAAM,GAAG,IAA0B,CAAC;AAEvF,eAAO,MAAM,uBAAuB,MAAO,iBAAiB,KAAG,SAAS,MAAM,EACrD,CAAC;AAE1B,eAAO,MAAM,cAAc,MAAO,iBAAiB,KAAG,MAAM,GAAG,IACjB,CAAC"}

package/dist/interpretation/dimensions.js

@@ -0,0 +1,6 @@
+export const stdinPolicyOf = (h) => h.stdin;
+export const providerFlagOf = (h) => h.provider === null ? null : h.provider.flag;
+export const toolsFlagOf = (h) => h.launch.toolsFlag;
+export const discoveryDisableFlagsOf = (h) => h.discoveryDisableFlags;
+export const autonomyFlagOf = (h) => h.autonomy === null ? null : h.autonomy.flag;
+//# sourceMappingURL=dimensions.js.map

package/dist/interpretation/dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.js","sourceRoot":"","sources":["../../src/interpretation/dimensions.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAoB,EAAgC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAE7F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAoB,EAAiB,EAAE,CACpE,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;AAE/C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAoB,EAAiB,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;AAEvF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAoB,EAAqB,EAAE,CACjF,CAAC,CAAC,qBAAqB,CAAC;AAE1B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAoB,EAAiB,EAAE,CACpE,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC"}

package/dist/interpretation/identity.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Identity decoding: pure recognition of a harness's identity announcement
+ * inside its output stream. D-022: claude re-emits `system/init` with the
+ * same session_id at every turn start, so announcements are deduped against
+ * the last seen id - an identity is only "news" on first sight or change.
+ * Under caller-assigned authority an announcement that differs from the
+ * REQUESTED id is a rotation anomaly (v1 HSI005): binding it would silently
+ * attach the conversation to a context that never saw it, so the outcome is
+ * surfaced for the runner to refuse, never papered over.
+ */
+import type { HarnessDescriptor } from "../knowledge/descriptor.js";
+export type IdentityOutcome = 
+/** Not an identity announcement at all. */
+"none"
+/** First sight (or a changed id under harness-minted authority). */
+ | "announced"
+/** Same id as last seen - turn-start metadata, not news. */
+ | "duplicate"
+/** Caller-assigned authority, but the harness announced a DIFFERENT id
+ * than the one requested - refuse to bind, do not paper over. */
+ | "rotated"
+/** Announcement present but the id fails the shape rule - not believed. */
+ | "malformed";
+export interface DecodedIdentity {
+    /** The id this raw event announces, whether or not it is news. */
+    readonly sessionId: string | null;
+    /** The id to surface as an identity HarnessEvent, or null when not news. */
+    readonly identity: string | null;
+    readonly outcome: IdentityOutcome;
+}
+export declare const decodeIdentity: (h: HarnessDescriptor, raw: unknown, lastSeenId: string | null, requestedId?: string | null) => DecodedIdentity;
+//# sourceMappingURL=identity.d.ts.map

package/dist/interpretation/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/interpretation/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAIpE,MAAM,MAAM,eAAe;AACzB,2CAA2C;AACzC,MAAM;AACR,oEAAoE;GAClE,WAAW;AACb,4DAA4D;GAC1D,WAAW;AACb;iEACiE;GAC/D,SAAS;AACX,2EAA2E;GACzE,WAAW,CAAC;AAEhB,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC;AAID,eAAO,MAAM,cAAc,MACtB,iBAAiB,OACf,OAAO,cACA,MAAM,GAAG,IAAI,gBACZ,MAAM,GAAG,IAAI,KACzB,eAsCF,CAAC"}

package/dist/interpretation/identity.js

@@ -0,0 +1,44 @@
+import { isUsableSessionId } from "./session-id.js";
+import { asRecord } from "./shape.js";
+const NOT_ANNOUNCED = { sessionId: null, identity: null, outcome: "none" };
+export const decodeIdentity = (h, raw, lastSeenId, requestedId = null) => {
+    const record = asRecord(raw);
+    if (record === null)
+        return NOT_ANNOUNCED;
+    const spec = h.identity.announce;
+    for (const [key, expected] of Object.entries(spec.match)) {
+        if (record[key] !== expected)
+            return NOT_ANNOUNCED;
+    }
+    // idField is a dot-path: muse nests its id at stream.id.
+    let cursor = record;
+    for (const segment of spec.idField.split(".")) {
+        const inner = asRecord(cursor);
+        if (inner === null)
+            return NOT_ANNOUNCED;
+        cursor = inner[segment];
+    }
+    const announced = cursor;
+    if (typeof announced !== "string" || !isUsableSessionId(announced)) {
+        // A record that matched a real discriminator (claude system/init) but
+        // carries a null/missing/garbage id is a MALFORMED announcement the
+        // runner must see - treating it as unrelated output leaves the runner
+        // waiting for an identity that already failed to arrive. Descriptors
+        // with an empty match (muse: any record) have no discriminator, so a
+        // record without the id path is ordinary output, not malformed.
+        const discriminated = Object.keys(spec.match).length > 0;
+        return discriminated
+            ? { sessionId: null, identity: null, outcome: "malformed" }
+            : NOT_ANNOUNCED;
+    }
+    if (h.identity.authority === "caller-assigned" &&
+        requestedId !== null &&
+        announced !== requestedId) {
+        return { sessionId: announced, identity: null, outcome: "rotated" };
+    }
+    if (announced === lastSeenId) {
+        return { sessionId: announced, identity: null, outcome: "duplicate" };
+    }
+    return { sessionId: announced, identity: announced, outcome: "announced" };
+};
+//# sourceMappingURL=identity.js.map

package/dist/interpretation/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/interpretation/identity.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAuBtC,MAAM,aAAa,GAAoB,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAE5F,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,CAAoB,EACpB,GAAY,EACZ,UAAyB,EACzB,WAAW,GAAkB,IAAI,EAChB,EAAE;IACnB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,aAAa,CAAC;IAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACjC,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ;YAAE,OAAO,aAAa,CAAC;IACrD,CAAC;IACD,yDAAyD;IACzD,IAAI,MAAM,GAAY,MAAM,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,aAAa,CAAC;QACzC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC;IACzB,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QACnE,sEAAsE;QACtE,oEAAoE;QACpE,sEAAsE;QACtE,qEAAqE;QACrE,qEAAqE;QACrE,gEAAgE;QAChE,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACzD,OAAO,aAAa;YAClB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE;YAC3D,CAAC,CAAC,aAAa,CAAC;IACpB,CAAC;IACD,IACE,CAAC,CAAC,QAAQ,CAAC,SAAS,KAAK,iBAAiB;QAC1C,WAAW,KAAK,IAAI;QACpB,SAAS,KAAK,WAAW,EACzB,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACxE,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAC7E,CAAC,CAAC"}

package/dist/interpretation/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Interpretation layer: owns pure functions that operate over descriptors.
+ *
+ * This includes argv building, identity decoding, limit detection, and
+ * capability queries. Every function here is total and side-effect free: it
+ * performs no I/O and imports no side-effecting Node builtins - purity is
+ * test-enforced. It is NOT responsible for spawning processes or handling
+ * streams; that is the execution layer's job.
+ */
+export * from "./argv.js";
+export * from "./capabilities.js";
+export * from "./context.js";
+export * from "./dimensions.js";
+export * from "./identity.js";
+export * from "./limits.js";
+export * from "./parse-resume.js";
+export * from "./presence.js";
+export * from "./resume-last.js";
+export * from "./session-id.js";
+export * from "./session-input.js";
+export * from "./store.js";
+export * from "./vocabulary.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/interpretation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interpretation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/interpretation/index.js

@@ -0,0 +1,23 @@
+/**
+ * Interpretation layer: owns pure functions that operate over descriptors.
+ *
+ * This includes argv building, identity decoding, limit detection, and
+ * capability queries. Every function here is total and side-effect free: it
+ * performs no I/O and imports no side-effecting Node builtins - purity is
+ * test-enforced. It is NOT responsible for spawning processes or handling
+ * streams; that is the execution layer's job.
+ */
+export * from "./argv.js";
+export * from "./capabilities.js";
+export * from "./context.js";
+export * from "./dimensions.js";
+export * from "./identity.js";
+export * from "./limits.js";
+export * from "./parse-resume.js";
+export * from "./presence.js";
+export * from "./resume-last.js";
+export * from "./session-id.js";
+export * from "./session-input.js";
+export * from "./store.js";
+export * from "./vocabulary.js";
+//# sourceMappingURL=index.js.map

package/dist/interpretation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interpretation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/interpretation/limits.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Wall detection: pure classification of harness output against the
+ * descriptor's limit and auth matchers. Returns the CODE, never the matched
+ * line - the consumers of a detection are a retained record and a viewer
+ * warning, and anything the harness printed on that line (a prompt, a
+ * filename, a customer's name) must not ride along (v1 D-005: records carry
+ * identifiers and outcomes, never content).
+ *
+ * Feed these wall-eligible output only - stderr and the non-JSON tail of a
+ * dying turn - never assistant message content, where the model merely
+ * TALKING about limits would match.
+ */
+import type { AuthFailureKind, HarnessDescriptor, LimitCode } from "../knowledge/descriptor.js";
+/** Per-line entry point for streaming readers: O(1) per line, no rescans. */
+export declare const detectLimitInLine: (h: HarnessDescriptor, line: string) => LimitCode | null;
+/** Batch convenience over a turn's tail, bounded and bottom-up. */
+export declare const detectLimit: (h: HarnessDescriptor, output: string) => LimitCode | null;
+export declare const detectAuthFailureInLine: (h: HarnessDescriptor, line: string) => AuthFailureKind | null;
+export declare const detectAuthFailure: (h: HarnessDescriptor, output: string) => AuthFailureKind | null;
+//# sourceMappingURL=limits.d.ts.map

package/dist/interpretation/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/interpretation/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAoChG,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,MAAO,iBAAiB,QAAQ,MAAM,KAAG,SAAS,GAAG,IAC3C,CAAC;AAEzC,mEAAmE;AACnE,eAAO,MAAM,WAAW,MAAO,iBAAiB,UAAU,MAAM,KAAG,SAAS,GAAG,IAC5C,CAAC;AAEpC,eAAO,MAAM,uBAAuB,MAC/B,iBAAiB,QACd,MAAM,KACX,eAAe,GAAG,IAA6C,CAAC;AAEnE,eAAO,MAAM,iBAAiB,MAAO,iBAAiB,UAAU,MAAM,KAAG,eAAe,GAAG,IACzD,CAAC"}

package/dist/interpretation/limits.js

@@ -0,0 +1,35 @@
+/** Bottom-up batch scans stop after this many non-empty lines: the wall is
+ * virtually always the last thing a dying turn printed, and an unbounded
+ * scan over an accumulating session buffer is O(turns x output). */
+const BATCH_SCAN_MAX_LINES = 200;
+const scanLine = (line, matchers) => {
+    for (let i = 0; i < matchers.length; i++) {
+        const matcher = matchers[i];
+        if (matcher?.[0].test(line))
+            return matcher[1];
+    }
+    return null;
+};
+const scanTail = (output, matchers) => {
+    let end = output.length;
+    let scanned = 0;
+    while (end > 0 && scanned < BATCH_SCAN_MAX_LINES) {
+        const start = output.lastIndexOf("\n", end - 1);
+        const line = output.slice(start + 1, end).trim();
+        end = start;
+        if (line === "")
+            continue;
+        scanned++;
+        const code = scanLine(line, matchers);
+        if (code !== null)
+            return code;
+    }
+    return null;
+};
+/** Per-line entry point for streaming readers: O(1) per line, no rescans. */
+export const detectLimitInLine = (h, line) => scanLine(line.trim(), h.limitMatchers);
+/** Batch convenience over a turn's tail, bounded and bottom-up. */
+export const detectLimit = (h, output) => scanTail(output, h.limitMatchers);
+export const detectAuthFailureInLine = (h, line) => scanLine(line.trim(), h.authMatchers);
+export const detectAuthFailure = (h, output) => scanTail(output, h.authMatchers);
+//# sourceMappingURL=limits.js.map

package/dist/interpretation/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/interpretation/limits.ts"],"names":[],"mappings":"AAcA;;oEAEoE;AACpE,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,MAAM,QAAQ,GAAG,CACf,IAAY,EACZ,QAAgD,EACnC,EAAE;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CACf,MAAc,EACd,QAAgD,EACnC,EAAE;IACf,IAAI,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,GAAG,GAAG,CAAC,IAAI,OAAO,GAAG,oBAAoB,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,GAAG,GAAG,KAAK,CAAC;QACZ,IAAI,IAAI,KAAK,EAAE;YAAE,SAAS;QAC1B,OAAO,EAAE,CAAC;QACV,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAoB,EAAE,IAAY,EAAoB,EAAE,CACxF,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;AAEzC,mEAAmE;AACnE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAoB,EAAE,MAAc,EAAoB,EAAE,CACpF,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;AAEpC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,CAAoB,EACpB,IAAY,EACY,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAoB,EAAE,MAAc,EAA0B,EAAE,CAChG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC"}

package/dist/interpretation/parse-resume.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Resume-command parsing: recognizes a pasted "resume this session" shell
+ * command and recovers {harness, sessionId, autonomy} - or a resume-last
+ * request where the harness supports one. The inverse of buildResumeArgv,
+ * tolerant of what shell history actually carries (quoted ids, resolved
+ * bin paths, --flag=value, flag aliases, root options on either side of a
+ * subcommand). Anchoring rules ported from v1 (D-011): the id must follow
+ * the harness's own resume grammar, match its id shape, and be the ONLY
+ * id-shaped token - a UUID inside quoted prompt text must never be
+ * returned as the session id. Position independence is safe because
+ * tokenize collapses quoted text into single words: a bare resume word can
+ * only come from a real argv slot.
+ */
+import type { HarnessDescriptor, HarnessName } from "../knowledge/descriptor.js";
+export interface ParsedResume {
+    readonly harness: HarnessName;
+    readonly sessionId: string;
+    readonly autonomy: boolean;
+}
+/** A recorded `--last` resume: no id to anchor - corroboration ranking
+ * (rankResumeLast) decides what it names. */
+export interface ParsedResumeLast {
+    readonly harness: HarnessName;
+    readonly resumeLast: true;
+    readonly autonomy: boolean;
+}
+export declare const parseResumeCommand: (known: readonly HarnessDescriptor[], command: string) => ParsedResume | ParsedResumeLast | null;
+//# sourceMappingURL=parse-resume.d.ts.map

package/dist/interpretation/parse-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-resume.d.ts","sourceRoot":"","sources":["../../src/interpretation/parse-resume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAIjF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;6CAC6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AA+DD,eAAO,MAAM,kBAAkB,UACtB,SAAS,iBAAiB,EAAE,WAC1B,MAAM,KACd,YAAY,GAAG,gBAAgB,GAAG,IAqBpC,CAAC"}

package/dist/interpretation/parse-resume.js

@@ -0,0 +1,91 @@
+import { isUsableSessionId } from "./session-id.js";
+import { basenameOf, tokenize } from "./shape.js";
+const flagTokens = (h) => [
+    h.resume.flag,
+    ...h.resume.aliases,
+];
+/** The id token per the descriptor's resume grammar, or null. */
+const idTokenOf = (h, words) => {
+    const positionalWords = [];
+    if (h.resume.style === "positional")
+        positionalWords.push(h.resume.flag);
+    if (h.resume.positionalParseWord !== undefined) {
+        positionalWords.push(h.resume.positionalParseWord);
+    }
+    if (positionalWords.length > 0) {
+        // Walk consuming `--flag value` pairs so an option VALUE spelled
+        // "resume" (muse exec --workspace resume <uuid>) is never mistaken for
+        // the resume word. Root options may sit on either side of a subcommand,
+        // so position alone is not the anchor - a bare, unconsumed resume word
+        // followed by an id-shaped token is. Conservative direction: a boolean
+        // flag directly before the resume word reads as a pair and yields null
+        // (display-only false negative), never a stranger's session.
+        for (let i = 1; i < words.length; i++) {
+            const word = words[i];
+            if (word === undefined)
+                break;
+            if (word.startsWith("-")) {
+                const next = words[i + 1];
+                if (!word.includes("=") && next !== undefined && !next.startsWith("-"))
+                    i++;
+                continue;
+            }
+            if (positionalWords.includes(word)) {
+                const candidate = words[i + 1];
+                if (candidate !== undefined && h.resume.idShape.test(candidate))
+                    return candidate;
+            }
+        }
+    }
+    if (h.resume.style === "flag" || h.resume.positionalParseWord === undefined) {
+        for (const token of flagTokens(h)) {
+            if (h.resume.style === "positional")
+                break;
+            const at = words.indexOf(token, 1);
+            if (at !== -1)
+                return words[at + 1] ?? null;
+            const eqForm = words.find((w) => w.startsWith(`${token}=`));
+            if (eqForm !== undefined)
+                return eqForm.slice(token.length + 1);
+        }
+    }
+    return null;
+};
+/** True when the command asks for the harness's resume-most-recent form. */
+const isResumeLast = (h, words) => {
+    if (h.resumeLast === null)
+        return false;
+    if (!words.includes(h.resumeLast.flag))
+        return false;
+    // --last only means "resume last" in the resume grammar's context: after
+    // the positional resume word, or anywhere for flag-style harnesses.
+    const anchor = h.resume.style === "positional" ? h.resume.flag : (h.resume.positionalParseWord ?? null);
+    if (anchor !== null) {
+        const at = words.indexOf(anchor, 1);
+        return at !== -1 && words.indexOf(h.resumeLast.flag) > at;
+    }
+    return true;
+};
+export const parseResumeCommand = (known, command) => {
+    const words = tokenize(command);
+    const bin = words[0];
+    if (bin === undefined)
+        return null;
+    const h = known.find((d) => basenameOf(bin) === d.bin);
+    if (h === undefined)
+        return null;
+    const autonomy = h.autonomy !== null && words.includes(h.autonomy.flag);
+    const id = idTokenOf(h, words);
+    if (id === null) {
+        return isResumeLast(h, words) ? { harness: h.name, resumeLast: true, autonomy } : null;
+    }
+    if (!h.resume.idShape.test(id) || !isUsableSessionId(id))
+        return null;
+    // D-011: any OTHER id-shaped token means the command is ambiguous -
+    // refuse rather than resume a stranger.
+    const idShaped = words.filter((w) => w !== id && h.resume.idShape.test(w));
+    if (idShaped.length > 0)
+        return null;
+    return { harness: h.name, sessionId: id, autonomy };
+};
+//# sourceMappingURL=parse-resume.js.map

package/dist/interpretation/parse-resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-resume.js","sourceRoot":"","sources":["../../src/interpretation/parse-resume.ts"],"names":[],"mappings":"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"}

package/dist/interpretation/presence.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Presence: does an INTERACTIVE process for this session id exist in the
+ * given process listing? Pure over injected rows - the host polls `ps` and
+ * feeds rows in. Presence says a process exists; it never creates a tap,
+ * never proves a channel, and never decides attachment (that is the chat
+ * layer's liveness state machine). Known blind spot, inherent to argv
+ * matching and shared with v1: an interactive session whose argv carries no
+ * id (`claude --continue`) is invisible here - false-negative is the safe
+ * direction, because presence only ever corroborates.
+ */
+import type { HarnessDescriptor } from "../knowledge/descriptor.js";
+export interface ProcessRow {
+    readonly argv: string;
+}
+export declare const isInteractive: (h: HarnessDescriptor, sessionId: string, rows: readonly ProcessRow[]) => boolean;
+//# sourceMappingURL=presence.d.ts.map

package/dist/interpretation/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/interpretation/presence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAWD,eAAO,MAAM,aAAa,MACrB,iBAAiB,aACT,MAAM,QACX,SAAS,UAAU,EAAE,KAC1B,OAkBF,CAAC"}