@with-logic/elwood 0.1.0

package/dist/codex/transcript/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/emit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,oEAAoE;AACpE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAAE,KAAK,EAAE,YAAY;IAMxF,qFAAqF;IACrF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAS5E,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAc3C"}

package/dist/codex/transcript/emit.js

@@ -0,0 +1,57 @@
+/**
+ * Parses committed Codex transcript lines into events, reporting drops.
+ * Implements PRD §7A/§5.4 (C-API-12): only committed, parseable records become
+ * events; a malformed line or a discarded over-length record is reported through the
+ * drop reporter as a live, count-free warning (coalesced per scan pass), never as an
+ * event of its own.
+ */
+import { summarizeTranscriptItem } from "./summary.js";
+/** Turns raw transcript text into parsed events for one watcher. */
+export class CodexLineEmitter {
+    elwoodSessionId;
+    emit;
+    drops;
+    constructor(id, emit, drops) {
+        this.elwoodSessionId = id;
+        this.emit = emit;
+        this.drops = drops;
+    }
+    /** Emit complete lines from `text`; the cursor retains any trailing partial line. */
+    emitLines(path, text, cursor) {
+        if (text.length === 0)
+            return;
+        const { lines, startedOversizedDrop } = cursor.takeLines(text);
+        // An over-length un-terminated record was discarded, not emitted: surface one
+        // live drop warning so the truncation is visible rather than silent (§5.4).
+        if (startedOversizedDrop)
+            this.drops.drop(path, "oversized");
+        for (const line of lines)
+            this.emitLine(path, line);
+    }
+    /** Emit a single already-complete line (the final drained partial at teardown). */
+    emitLine(path, line) {
+        if (!line.trim())
+            return;
+        const item = parseLine(line);
+        if (item === undefined) {
+            this.drops.record(path);
+            return;
+        }
+        this.emit({
+            elwoodSessionId: this.elwoodSessionId,
+            path,
+            item,
+            summary: summarizeTranscriptItem(item),
+        });
+    }
+}
+/** Returns undefined for a malformed line so the caller can report the drop. */
+function parseLine(line) {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=emit.js.map

package/dist/codex/transcript/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../../src/codex/transcript/emit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGvD,oEAAoE;AACpE,MAAM,OAAO,gBAAgB;IACV,eAAe,CAAS;IACxB,IAAI,CAAwC;IAC5C,KAAK,CAAe;IAErC,YAAY,EAAU,EAAE,IAA2C,EAAE,KAAmB;QACtF,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,qFAAqF;IACrF,SAAS,CAAC,IAAY,EAAE,IAAY,EAAE,MAA+B;QACnE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC9B,MAAM,EAAE,KAAK,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/D,8EAA8E;QAC9E,4EAA4E;QAC5E,IAAI,oBAAoB;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC7D,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,mFAAmF;IACnF,QAAQ,CAAC,IAAY,EAAE,IAAY;QACjC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO;QACzB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC;YACR,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,IAAI;YACJ,IAAI;YACJ,OAAO,EAAE,uBAAuB,CAAC,IAAI,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;CACF;AAED,gFAAgF;AAChF,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/codex/transcript/fs-guard.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Contained filesystem access for the Codex transcript watcher.
+ * Implements PRD §7A/§5.4: a transcript read that hits a rotation/removal/permission
+ * race is contained (never crashes the scan timer or hook dispatch) and recorded as
+ * a bounded, content-free diagnostic so a persistent fault stays visible rather than
+ * either aborting the host or being swallowed. Codex scans synchronously, so only a
+ * sync guard is needed (no async stat twin).
+ */
+import type { ReadErrorReporter } from "../../core/transcript/drops.ts";
+/** Wraps a sync transcript read so a thrown fs error is contained and reported as one live warning. */
+export declare class CodexTranscriptFsGuard {
+    private readonly readErrors;
+    constructor(readErrors: ReadErrorReporter);
+    read<T>(path: string, read: () => T): T | undefined;
+}
+//# sourceMappingURL=fs-guard.d.ts.map

package/dist/codex/transcript/fs-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-guard.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/fs-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,uGAAuG;AACvG,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,UAAU,EAAE,iBAAiB;IAMzC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS;CAQpD"}

package/dist/codex/transcript/fs-guard.js

@@ -0,0 +1,27 @@
+/**
+ * Contained filesystem access for the Codex transcript watcher.
+ * Implements PRD §7A/§5.4: a transcript read that hits a rotation/removal/permission
+ * race is contained (never crashes the scan timer or hook dispatch) and recorded as
+ * a bounded, content-free diagnostic so a persistent fault stays visible rather than
+ * either aborting the host or being swallowed. Codex scans synchronously, so only a
+ * sync guard is needed (no async stat twin).
+ */
+/** Wraps a sync transcript read so a thrown fs error is contained and reported as one live warning. */
+export class CodexTranscriptFsGuard {
+    readErrors;
+    constructor(readErrors) {
+        this.readErrors = readErrors;
+    }
+    // Contains a sync read failure (never crashes the timer/hook dispatch) and records
+    // a bounded diagnostic so a persistent fault stays visible (§5.4).
+    read(path, read) {
+        try {
+            return read();
+        }
+        catch (error) {
+            this.readErrors.record(path, error);
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=fs-guard.js.map

package/dist/codex/transcript/fs-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-guard.js","sourceRoot":"","sources":["../../../src/codex/transcript/fs-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,uGAAuG;AACvG,MAAM,OAAO,sBAAsB;IAChB,UAAU,CAAoB;IAE/C,YAAY,UAA6B;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,mFAAmF;IACnF,mEAAmE;IACnE,IAAI,CAAI,IAAY,EAAE,IAAa;QACjC,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACpC,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/codex/transcript/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Public entry point for live Codex transcript observation.
+ * Implements PRD §7A and §5.4 (C-API-12): re-exports the bounded transcript watcher
+ * and its item summarizer from the `transcript/` module directory, keeping this
+ * import path stable for callers (`src/index.ts`, `core/activity-*`, tests).
+ */
+export { summarizeTranscriptItem, toolOutputText } from "./summary.ts";
+export type { CodexTranscriptEvent, CodexTranscriptSummary } from "./types.ts";
+export { codexDropWarning, codexPollStoppedWarning, codexReadErrorWarning, } from "./warnings.ts";
+export type { CodexDropNotice, CodexReadErrorNotice, CodexTranscriptNotices, } from "./watcher.ts";
+export { CodexTranscriptWatcher } from "./watcher.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/codex/transcript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/codex/transcript/index.js

@@ -0,0 +1,10 @@
+/**
+ * Public entry point for live Codex transcript observation.
+ * Implements PRD §7A and §5.4 (C-API-12): re-exports the bounded transcript watcher
+ * and its item summarizer from the `transcript/` module directory, keeping this
+ * import path stable for callers (`src/index.ts`, `core/activity-*`, tests).
+ */
+export { summarizeTranscriptItem, toolOutputText } from "./summary.js";
+export { codexDropWarning, codexPollStoppedWarning, codexReadErrorWarning, } from "./warnings.js";
+export { CodexTranscriptWatcher } from "./watcher.js";
+//# sourceMappingURL=index.js.map

package/dist/codex/transcript/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/codex/transcript/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/codex/transcript/summary.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Projects one committed Codex JSONL transcript item into a bounded summary.
+ * Implements PRD §7A.4 (C-API-12, C-CODEX-18, C-CODEX-19): assistant messages,
+ * tool calls/results, reasoning summary text, and web searches are surfaced; raw
+ * encrypted reasoning is never surfaced.
+ */
+import type { CodexTranscriptSummary } from "./types.ts";
+export declare function summarizeTranscriptItem(item: unknown): CodexTranscriptSummary;
+export declare function toolOutputText(output: unknown): string | undefined;
+//# sourceMappingURL=summary.d.ts.map

package/dist/codex/transcript/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIzD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,sBAAsB,CAe7E;AA4ED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOlE"}

package/dist/codex/transcript/summary.js

@@ -0,0 +1,176 @@
+/**
+ * Projects one committed Codex JSONL transcript item into a bounded summary.
+ * Implements PRD §7A.4 (C-API-12, C-CODEX-18, C-CODEX-19): assistant messages,
+ * tool calls/results, reasoning summary text, and web searches are surfaced; raw
+ * encrypted reasoning is never surfaced.
+ */
+import { isRecord } from "../../core/predicates.js";
+export function summarizeTranscriptItem(item) {
+    const payload = record(record(item)?.["payload"]);
+    if (!payload) {
+        return { kind: "other", label: stringValue(record(item)?.["type"]) ?? "unknown" };
+    }
+    const type = stringValue(payload?.["type"]);
+    if (type === "web_search_end" || type === "web_search_call")
+        return webSearch(payload);
+    if (type === "function_call")
+        return toolCall(payload);
+    if (type === "custom_tool_call")
+        return toolCall(payload);
+    if (type === "function_call_output")
+        return toolResult(payload);
+    if (type === "custom_tool_call_output")
+        return toolResult(payload);
+    if (type === "reasoning")
+        return reasoning(payload);
+    if (type === "message")
+        return message(payload);
+    if (type === "agent_message")
+        return agentMessage(payload);
+    return { kind: "other", label: type ?? stringValue(record(item)?.["type"]) ?? "unknown" };
+}
+function webSearch(payload) {
+    const query = stringValue(payload["query"]);
+    const action = record(payload["action"]);
+    const actionType = stringValue(action?.["type"]) ?? "search";
+    const textValue = query ?? stringValue(action?.["url"]) ?? stringValue(action?.["pattern"]);
+    return { kind: "web_search", label: actionType, ...(text(textValue) ?? {}) };
+}
+// A `custom_tool_call` (modern `exec`) carries its command in `input`; a
+// `function_call` in JSON `arguments` — surface whichever holds it, UNWRAPPED from
+// the CLI's JS/JSON harness so consumers see the bare command (C-CODEX-19).
+function toolCall(payload) {
+    const name = stringValue(payload["name"]) ?? "tool";
+    const raw = payload["input"] ?? payload["arguments"];
+    const command = typeof raw === "string" ? extractCommand(raw) : undefined;
+    return { kind: "tool_call", label: name, ...(text(command ?? raw) ?? {}) };
+}
+// Unwrap a Codex exec invocation to the bare command. The modern `exec` tool sends
+// a JS snippet `... tools.exec_command({"cmd":"...", ...}) ...`; older function calls
+// send JSON `arguments` like `{"command":["bash","-lc","..."]}` or `{"cmd":"..."}`.
+// Pull the FIRST embedded JSON object, then read its command; fall back to the raw
+// string when nothing parses so a command is never lost (C-CODEX-19).
+function extractCommand(input) {
+    const args = firstJsonObject(input);
+    if (!args)
+        return undefined;
+    const command = args["command"] ?? args["cmd"];
+    if (typeof command === "string")
+        return command;
+    if (Array.isArray(command))
+        return command.every((part) => typeof part === "string") ? command.join(" ") : undefined;
+    return undefined;
+}
+// Extract and parse the first balanced `{...}` object literal in a string. Codex's
+// exec `cmd` values can themselves contain braces, so scan for a brace-balanced span
+// (respecting string literals/escapes) rather than a greedy regex.
+function firstJsonObject(text) {
+    const start = text.indexOf("{");
+    if (start < 0)
+        return undefined;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = start; i < text.length; i += 1) {
+        const ch = text[i];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (ch === "\\")
+                escaped = true;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"')
+            inString = true;
+        else if (ch === "{")
+            depth += 1;
+        else if (ch === "}" && --depth === 0)
+            return safeJsonRecord(text.slice(start, i + 1));
+    }
+    return undefined;
+}
+function safeJsonRecord(json) {
+    try {
+        return record(JSON.parse(json));
+    }
+    catch {
+        return undefined;
+    }
+}
+function toolResult(payload) {
+    const callId = stringValue(payload["call_id"]) ?? "tool";
+    return { kind: "tool_result", label: callId, ...(text(toolOutputText(payload["output"])) ?? {}) };
+}
+// Extracts a tool result's text. Accepts a plain string, or an
+// `{ type:"input_text", text }[]` array (custom_tool_call_output/modern exec) whose
+// entry texts are joined. Any other shape returns undefined, and the `toolResult`
+// caller simply omits the text (no generic serialization fallback) (C-CODEX-19).
+export function toolOutputText(output) {
+    if (typeof output === "string")
+        return output;
+    if (!Array.isArray(output))
+        return undefined;
+    const parts = output
+        .map((entry) => stringValue(record(entry)?.["text"]))
+        .filter((part) => part !== undefined);
+    return parts.length > 0 ? parts.join("") : undefined;
+}
+function message(payload) {
+    const role = stringValue(payload["role"]) ?? "message";
+    const value = assistantMessageText(payload, role);
+    return value === undefined
+        ? { kind: "other", label: role }
+        : { kind: "message", label: role, text: value };
+}
+function assistantMessageText(payload, role) {
+    if (role !== "assistant")
+        return undefined;
+    const phase = stringValue(payload["phase"]);
+    if (phase !== undefined && phase !== "final_answer")
+        return undefined;
+    const content = payload["content"];
+    if (typeof content === "string")
+        return content;
+    if (phase !== "final_answer" || !Array.isArray(content))
+        return undefined;
+    const parts = content
+        .filter((entry) => stringValue(record(entry)?.["type"]) === "output_text")
+        .map((entry) => stringValue(record(entry)?.["text"]))
+        .filter((part) => part !== undefined);
+    return parts.length > 0 ? parts.join("") : undefined;
+}
+function agentMessage(payload) {
+    return { kind: "message", label: "assistant", ...(text(payload["message"]) ?? {}) };
+}
+// A Codex reasoning item: readable text is `summary[]` `summary_text` entries, or
+// (rarely) `content[]` `reasoning_text`; `encrypted_content` is never surfaced.
+// Most items have an empty summary, so `text` is set only when prose exists (§7A.4).
+function reasoning(payload) {
+    const value = reasoningText(payload["summary"], "summary_text") ??
+        reasoningText(payload["content"], "reasoning_text");
+    return { kind: "reasoning", label: "reasoning", ...(text(value) ?? {}) };
+}
+/** Join the `text` of every array entry whose `type` matches; undefined if none. */
+function reasoningText(value, entryType) {
+    if (!Array.isArray(value))
+        return undefined;
+    const parts = value
+        .filter((e) => stringValue(record(e)?.["type"]) === entryType)
+        .map((e) => stringValue(record(e)?.["text"]))
+        .filter((part) => part !== undefined && part.length > 0);
+    return parts.length > 0 ? parts.join("\n") : undefined;
+}
+function text(value) {
+    if (typeof value === "string")
+        return { text: value };
+    return undefined;
+}
+function record(value) {
+    return isRecord(value) ? value : undefined;
+}
+function stringValue(value) {
+    return typeof value === "string" ? value : undefined;
+}
+//# sourceMappingURL=summary.js.map

package/dist/codex/transcript/summary.js.map

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

package/dist/codex/transcript/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Public shapes for live Codex transcript observation.
+ * Implements PRD §7A and §5.4 (C-API-12): the summarized view of one committed
+ * Codex JSONL transcript item and the event carrying it to subscribers.
+ */
+/**
+ * A typed, adapter-neutral projection of one committed Codex transcript item — the
+ * shape delivered on `codex:transcript` and the unified `activity` stream. NOTE:
+ * "bounded" refers only to the READER (it caps how much it reads/holds), NOT to
+ * this projection's content — `text` below is untruncated conversation prose and
+ * may be sensitive. Treat it as such; it is not a content-free/redacted channel.
+ */
+export type CodexTranscriptSummary = {
+    /**
+     * The kind of activity this item represents. Drives which fields downstream
+     * activity carries: `message` (committed assistant prose), `tool_call` (a shell/exec
+     * or function invocation), `tool_result` (that call's output), `reasoning`
+     * (chain-of-thought summary text, when present), `web_search`, or `other` (any
+     * item type not specifically surfaced).
+     */
+    readonly kind: "message" | "tool_call" | "tool_result" | "reasoning" | "web_search" | "other";
+    /**
+     * A short, human-readable label whose meaning depends on `kind`: the message
+     * role (`assistant`) for `message`, the tool/function name for
+     * `tool_call`, the correlating call id for `tool_result`, the web-search action
+     * type (e.g. `search`/`open_page`) for `web_search`, the literal `"reasoning"`
+     * for `reasoning`, and the raw item `type` (or `"unknown"`) for `other`.
+     */
+    readonly label: string;
+    /**
+     * The item's readable prose, present only when the item genuinely carries some:
+     * a message body, a tool invocation/output, a web-search query/target, or
+     * reasoning summary text. This is UNTRUNCATED conversation content and MAY be
+     * sensitive (full assistant messages, tool output, file contents) — subscribers
+     * must not treat it as a content-free channel. Absent when the item has no
+     * readable text — the common case for an empty reasoning summary or a non-textual
+     * payload — so treat it as optional. Never carries encrypted reasoning content,
+     * which is deliberately not surfaced (§7A.4).
+     */
+    readonly text?: string;
+};
+/**
+ * One live, best-effort observation of a committed Codex transcript item.
+ * Best-effort: the reader is bounded (fixed-size chunk reads, a max-pending
+ * ceiling), so a pathological or oversized record is dropped and accounted rather
+ * than delivered — an event here is always a genuinely committed, parseable item.
+ */
+export type CodexTranscriptEvent = {
+    /** The Elwood session whose transcript produced this item. */
+    readonly elwoodSessionId: string;
+    /** The absolute filesystem path of the JSONL transcript this item was read from. */
+    readonly path: string;
+    /**
+     * The raw, parsed JSONL record exactly as Codex wrote it. This is LIVE transcript
+     * content and MAY be sensitive — it can embed prompts, tool output, file
+     * contents, or other conversation data — so subscribers must treat it as such and
+     * never persist it into a content-free channel. The `summary` is a typed, readable
+     * projection for rendering — its `text` is likewise potentially sensitive (see
+     * CodexTranscriptSummary); `item` is provided for callers needing the raw shape.
+     */
+    readonly item: unknown;
+    /** The typed, readable projection of `item` for activity rendering (its `text` may be sensitive). */
+    readonly summary: CodexTranscriptSummary;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/codex/transcript/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC;IAC9F;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,qGAAqG;IACrG,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;CAC1C,CAAC"}

package/dist/codex/transcript/types.js

@@ -0,0 +1,7 @@
+/**
+ * Public shapes for live Codex transcript observation.
+ * Implements PRD §7A and §5.4 (C-API-12): the summarized view of one committed
+ * Codex JSONL transcript item and the event carrying it to subscribers.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/codex/transcript/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/codex/transcript/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/codex/transcript/warnings.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Builds bounded, content-free Codex transcript diagnostic warnings.
+ * Implements PRD §7A/§5.4: a dropped record or a contained filesystem read error
+ * becomes a typed live `warning` carrying only a bounded cause/phase label and an
+ * error code — never a count, byte magnitude, or raw transcript content. These are
+ * live-only (§5.7): each is emitted once when observed, never persisted, counted,
+ * or replayed. Mirrors Claude's transcript/warnings builders so both adapters
+ * surface identical, shared `transcript_records_dropped` / `transcript_read_error`
+ * warnings.
+ */
+import type { TranscriptDropNotice, TranscriptReadErrorNotice } from "../../core/transcript/drops.ts";
+import type { ElwoodWarningEvent } from "../../core/types.ts";
+import { type PollPhase } from "../../core/warnings/reasons.ts";
+/** The shared drop warning, tagged for Codex. */
+export declare function codexDropWarning(notice: TranscriptDropNotice): ElwoodWarningEvent;
+/** The shared read-error warning, tagged for Codex. */
+export declare function codexReadErrorWarning(notice: TranscriptReadErrorNotice): ElwoodWarningEvent;
+/**
+ * A scan threw and the watcher stopped itself. The escaping error can be a
+ * downstream activity-listener exception whose message embeds raw transcript
+ * content, so only a bounded, allowlisted error NAME/errno reaches the emitted
+ * `reason` — never `error.message` (content-free guarantee, §5.4/§8.3).
+ */
+export declare function codexPollStoppedWarning(elwoodSessionId: string, error: unknown, phase?: PollPhase): ElwoodWarningEvent;
+//# sourceMappingURL=warnings.d.ts.map

package/dist/codex/transcript/warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/warnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,gCAAgC,CAAC;AAExC,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,GAAG,kBAAkB,CAEjF;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,yBAAyB,GAAG,kBAAkB,CAE3F;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,OAAO,EACd,KAAK,GAAE,SAAkB,GACxB,kBAAkB,CAgBpB"}

package/dist/codex/transcript/warnings.js

@@ -0,0 +1,43 @@
+/**
+ * Builds bounded, content-free Codex transcript diagnostic warnings.
+ * Implements PRD §7A/§5.4: a dropped record or a contained filesystem read error
+ * becomes a typed live `warning` carrying only a bounded cause/phase label and an
+ * error code — never a count, byte magnitude, or raw transcript content. These are
+ * live-only (§5.7): each is emitted once when observed, never persisted, counted,
+ * or replayed. Mirrors Claude's transcript/warnings builders so both adapters
+ * surface identical, shared `transcript_records_dropped` / `transcript_read_error`
+ * warnings.
+ */
+import { dropWarning, readErrorWarning } from "../../core/transcript/warnings.js";
+import { boundedErrorToken, isPollErrorReason, } from "../../core/warnings/reasons.js";
+/** The shared drop warning, tagged for Codex. */
+export function codexDropWarning(notice) {
+    return dropWarning("codex", notice);
+}
+/** The shared read-error warning, tagged for Codex. */
+export function codexReadErrorWarning(notice) {
+    return readErrorWarning("codex", notice);
+}
+/**
+ * A scan threw and the watcher stopped itself. The escaping error can be a
+ * downstream activity-listener exception whose message embeds raw transcript
+ * content, so only a bounded, allowlisted error NAME/errno reaches the emitted
+ * `reason` — never `error.message` (content-free guarantee, §5.4/§8.3).
+ */
+export function codexPollStoppedWarning(elwoodSessionId, error, phase = "poll") {
+    const reason = boundedErrorToken(error, isPollErrorReason);
+    return {
+        elwoodSessionId,
+        agent: "codex",
+        source: "terminal",
+        code: "transcript_poll_stopped",
+        severity: "warning",
+        // `phase` distinguishes a live poll failure from the FINAL flush at exit, so lost
+        // trailing shutdown activity is diagnosable without a distinct warning code (§9.2).
+        message: "Codex transcript polling stopped after a scan error; live activity may be incomplete.",
+        reason,
+        phase,
+        raw: `transcript_poll_stopped reason=${reason} phase=${phase}`,
+    };
+}
+//# sourceMappingURL=warnings.js.map

package/dist/codex/transcript/warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.js","sourceRoot":"","sources":["../../../src/codex/transcript/warnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAElF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAElB,MAAM,gCAAgC,CAAC;AAExC,iDAAiD;AACjD,MAAM,UAAU,gBAAgB,CAAC,MAA4B;IAC3D,OAAO,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,qBAAqB,CAAC,MAAiC;IACrE,OAAO,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,eAAuB,EACvB,KAAc,EACd,QAAmB,MAAM;IAEzB,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAC3D,OAAO;QACL,eAAe;QACf,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE,SAAS;QACnB,kFAAkF;QAClF,oFAAoF;QACpF,OAAO,EACL,uFAAuF;QACzF,MAAM;QACN,KAAK;QACL,GAAG,EAAE,kCAAkC,MAAM,UAAU,KAAK,EAAE;KAC/D,CAAC;AACJ,CAAC"}

package/dist/codex/transcript/watcher-config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Public construction options for the Codex transcript watcher.
+ * Implements PRD §7A/§5.4: the diagnostic notice handlers (bounded, content-free)
+ * the watcher forwards for observation problems.
+ */
+import type { TranscriptDropNotice, TranscriptReadErrorNotice } from "../../core/transcript/drops.ts";
+/** Notices the watcher forwards for observation problems (each fired live, once). */
+export type CodexTranscriptNotices = {
+    readonly onDrop?: (notice: TranscriptDropNotice) => void;
+    readonly onReadError?: (notice: TranscriptReadErrorNotice) => void;
+    /** A scan threw and the watcher stopped itself; carries the underlying error. */
+    readonly onPollError?: (error: unknown) => void;
+    /** Scan cadence override (defaults to the watcher default); tests use a short interval. */
+    readonly scanIntervalMs?: number;
+    /**
+     * Monotonic clock for the PTY-exit drain's wall-clock slice. Tests inject a
+     * controlled clock so a multi-chunk drain is deterministic rather than a race
+     * against real time; production uses `Date.now`.
+     */
+    readonly now?: () => number;
+};
+//# sourceMappingURL=watcher-config.d.ts.map

package/dist/codex/transcript/watcher-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher-config.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/watcher-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AAExC,qFAAqF;AACrF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACnE,iFAAiF;IACjF,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,2FAA2F;IAC3F,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B,CAAC"}

package/dist/codex/transcript/watcher-config.js

@@ -0,0 +1,7 @@
+/**
+ * Public construction options for the Codex transcript watcher.
+ * Implements PRD §7A/§5.4: the diagnostic notice handlers (bounded, content-free)
+ * the watcher forwards for observation problems.
+ */
+export {};
+//# sourceMappingURL=watcher-config.js.map

package/dist/codex/transcript/watcher-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher-config.js","sourceRoot":"","sources":["../../../src/codex/transcript/watcher-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/codex/transcript/watcher.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Best-effort live observation of Codex transcript JSONL items, bounded.
+ * Implements PRD §7A and §5.4 (C-API-12): committed message/tool/reasoning items
+ * are sourced from the JSONL transcript Codex writes; reads are bounded (fixed-size
+ * chunks, a max-pending ceiling, a per-scan chunk budget) so a hundreds-of-MiB file
+ * never OOMs or blocks the event loop, and lost committed data is surfaced through
+ * bounded, content-free drop notices.
+ */
+import type { CodexTranscriptEvent } from "./types.ts";
+import type { CodexTranscriptNotices } from "./watcher-config.ts";
+export type { TranscriptDropNotice as CodexDropNotice, TranscriptReadErrorNotice as CodexReadErrorNotice, } from "../../core/transcript/drops.ts";
+export type { CodexTranscriptNotices } from "./watcher-config.ts";
+export declare class CodexTranscriptWatcher {
+    private cursor;
+    private interval;
+    private finished;
+    private readonly guard;
+    private readonly drops;
+    private readonly lines;
+    private readonly onPollError;
+    private readonly terminalBudget;
+    private readonly scanIntervalMs;
+    private readonly now;
+    constructor(elwoodSessionId: string, emit: (event: CodexTranscriptEvent) => void, notices?: CodexTranscriptNotices);
+    observe(path: string): void;
+    private runScan;
+    scan(): void;
+    flush(): void;
+    finish(): void;
+    stop(): void;
+    private recoverFromPollError;
+    private drainContext;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/codex/transcript/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../../src/codex/transcript/watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,YAAY,EACV,oBAAoB,IAAI,eAAe,EACvC,yBAAyB,IAAI,oBAAoB,GAClD,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAMlE,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,QAAQ,CAA6C;IAE7D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IAErE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoC;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IAEpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;gBAG/C,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAC3C,OAAO,GAAE,sBAA2B;IActC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAY3B,OAAO,CAAC,OAAO;IAUf,IAAI,IAAI,IAAI;IAkBZ,KAAK,IAAI,IAAI;IAQb,MAAM,IAAI,IAAI;IAUd,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,YAAY;CAQrB"}