@with-logic/elwood 0.1.0

package/dist/codex/transcript/watcher.js

@@ -0,0 +1,134 @@
+/**
+ * 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 { BoundedTranscriptCursor } from "../../core/transcript/cursor.js";
+import { DropReporter, ReadErrorReporter } from "../../core/transcript/drops.js";
+import { drainToBudget, newTerminalBudget } from "./drain.js";
+import { CodexLineEmitter } from "./emit.js";
+import { CodexTranscriptFsGuard } from "./fs-guard.js";
+const defaultScanIntervalMs = 250; // poll cadence: transcript activity is not latency-critical
+/** Read passes per scan (×256 KiB ≈ 4 MiB): a huge delta drains across ticks, not one block. */
+const scanChunksPerScan = 16;
+export class CodexTranscriptWatcher {
+    cursor;
+    interval;
+    // A permanent terminal latch: once finished, no scan/flush/observe restarts it.
+    finished = false;
+    guard;
+    drops;
+    lines;
+    onPollError;
+    // ONE budget shared across every flush() for a watcher's whole lifetime.
+    terminalBudget = newTerminalBudget();
+    scanIntervalMs;
+    // Drain-slice clock; undefined in production. See watcher-config.ts.
+    now;
+    constructor(elwoodSessionId, emit, notices = {}) {
+        this.drops = new DropReporter(elwoodSessionId, notices.onDrop);
+        const readErrors = new ReadErrorReporter(elwoodSessionId, notices.onReadError);
+        this.guard = new CodexTranscriptFsGuard(readErrors);
+        this.lines = new CodexLineEmitter(elwoodSessionId, emit, this.drops);
+        this.onPollError = notices.onPollError;
+        this.scanIntervalMs = notices.scanIntervalMs;
+        this.now = notices.now;
+    }
+    // Begin watching `path`, baselining at its CURRENT end so history is NOT replayed.
+    // No-op if already watching this exact path or once finished (never restart polling
+    // past a terminal:exit). A switch to a new path drops the old.
+    observe(path) {
+        if (this.finished || this.cursor?.path === path)
+            return;
+        this.stop();
+        this.cursor = this.guard.read(path, () => new BoundedTranscriptCursor(path));
+        if (!this.cursor)
+            return;
+        // A scan() throw (a throwing drop/activity/warning listener) must not escape the
+        // timer as an uncaught exception — contain it, stop, and route a bounded live
+        // diagnostic (non-throwing recovery), mirroring Claude's poll recovery.
+        this.interval = setInterval(() => this.runScan(), this.scanIntervalMs ?? defaultScanIntervalMs);
+        this.interval.unref?.();
+    }
+    runScan() {
+        try {
+            this.scan();
+        }
+        catch (error) {
+            this.recoverFromPollError(error);
+        }
+    }
+    // One bounded scan pass: read up to a per-pass chunk budget of new committed bytes
+    // (a large delta streams across ticks), emit complete lines, retain the partial.
+    scan() {
+        const cursor = this.cursor;
+        if (this.finished || !cursor)
+            return;
+        const budget = { chunks: scanChunksPerScan };
+        while (budget.chunks > 0) {
+            budget.chunks -= 1;
+            const chunk = this.guard.read(cursor.path, () => cursor.readChunk());
+            if (!chunk)
+                break; // contained FS failure; keep last offset
+            if (chunk.text.length > 0)
+                this.lines.emitLines(cursor.path, chunk.text, cursor);
+            if (!chunk.canContinueNow)
+                break;
+        } // budget exhausted with more to read: the next scan tick resumes here.
+        this.drops.flushPass(); // bounded drop delivery: one warning per (path, cause) per scan
+    }
+    // Bounded terminal flush: drain to EOF against the SHARED terminal budget and a
+    // wall-clock slice, dropping any leftover backlog content-free (never an unbounded
+    // synchronous loop), then flush the final partial line. No-op once finished so a
+    // second finish() (PTY-exit path + runtime cleanup) cannot re-drain the backlog.
+    flush() {
+        if (this.finished || !this.cursor)
+            return;
+        drainToBudget(this.drainContext(), this.cursor, this.terminalBudget);
+    }
+    // Flush trailing partials, then permanently stop. Idempotent (`finished` gates a
+    // second call) and terminal; `stop()` runs in `finally` so a throwing drain still
+    // clears the timer (no leaked interval).
+    finish() {
+        if (this.finished)
+            return;
+        try {
+            this.flush();
+        }
+        finally {
+            this.finished = true;
+            this.stop();
+        }
+    }
+    stop() {
+        if (this.interval)
+            clearInterval(this.interval);
+        this.interval = undefined;
+    }
+    // Non-throwing recovery for a failed scan: finish() and the diagnostic can each
+    // throw a listener error (which on the timer path would terminate the host), so
+    // each is contained. finish() already clears the timer in its own `finally`, so a
+    // finish() throw here is simply swallowed — the interval is gone regardless.
+    recoverFromPollError(error) {
+        try {
+            this.finish();
+        }
+        catch { } // finish()'s finally already ran stop(); a drain throw is contained here
+        try {
+            this.onPollError?.(error);
+        }
+        catch { } // a diagnostic listener bug must not resurrect the failure
+    }
+    drainContext() {
+        return {
+            readFs: this.guard.read.bind(this.guard),
+            lines: this.lines,
+            drops: this.drops,
+            ...(this.now === undefined ? {} : { now: this.now }),
+        };
+    }
+}
+//# sourceMappingURL=watcher.js.map

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

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

package/dist/codex/transcript.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 "./transcript/summary.ts";
+export type { CodexTranscriptEvent, CodexTranscriptSummary } from "./transcript/types.ts";
+export { codexDropWarning, codexPollStoppedWarning, codexReadErrorWarning, } from "./transcript/warnings.ts";
+export type { CodexDropNotice, CodexReadErrorNotice, CodexTranscriptNotices, } from "./transcript/watcher.ts";
+export { CodexTranscriptWatcher } from "./transcript/watcher.ts";
+//# sourceMappingURL=transcript.d.ts.map

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

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

package/dist/codex/transcript.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 "./transcript/summary.js";
+export { codexDropWarning, codexPollStoppedWarning, codexReadErrorWarning, } from "./transcript/warnings.js";
+export { CodexTranscriptWatcher } from "./transcript/watcher.js";
+//# sourceMappingURL=transcript.js.map

package/dist/codex/transcript.js.map

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

package/dist/codex/update-prompt.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Recognizes first-party Codex in-TUI update screens and their safe options.
+ * Implements PRD §5.5 and C-CODEX-12 for both prompt automation and input blocking.
+ */
+import type { TrustWriteResult } from "../core/trust/responder.ts";
+export declare const codexUpdateOptionPattern: RegExp;
+/**
+ * A captured first-party banner alone counts so a partial layout fails safe
+ * before its options paint. Generic "update available" prose does not count;
+ * an option-only frame must carry both the update and safe choices.
+ */
+export declare function codexUpdatePromptVisible(frameText: string): boolean;
+/** Keeps a split prompt blocking until a frame with no update evidence clears it. */
+export declare class CodexUpdatePromptTracker {
+    private active;
+    private generation;
+    observe(frameText: string): boolean;
+    /** Captures the current prompt generation so an async retry cannot enter a later dialog. */
+    currentFramePredicate(): (frameText: string) => boolean;
+}
+/** Retries a possibly swallowed startup hotkey only while its safe option remains visible. */
+export declare function writeCodexUpdateSkip(option: string, write: (input: string) => TrustWriteResult, readFrame?: () => string, currentUpdateFrame?: (frameText: string) => boolean): Promise<void>;
+//# sourceMappingURL=update-prompt.d.ts.map

package/dist/codex/update-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-prompt.d.ts","sourceRoot":"","sources":["../../src/codex/update-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,eAAO,MAAM,wBAAwB,QAAqD,CAAC;AAI3F;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAOnE;AAED,qFAAqF;AACrF,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAK;IAEvB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAWnC,4FAA4F;IAC5F,qBAAqB,IAAI,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO;CAOxD;AAYD,8FAA8F;AAC9F,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,EAC1C,SAAS,CAAC,EAAE,MAAM,MAAM,EACxB,kBAAkB,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAkC,GAC5E,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/codex/update-prompt.js

@@ -0,0 +1,78 @@
+/**
+ * Recognizes first-party Codex in-TUI update screens and their safe options.
+ * Implements PRD §5.5 and C-CODEX-12 for both prompt automation and input blocking.
+ */
+import { nonOptionText, numberedOptions } from "../core/terminal-options.js";
+export const codexUpdateOptionPattern = /continue\s*without\s*updat|skip|not\s*now|later/i;
+const updateScreenBanner = /^[^\S\r\n]*(?:Update available!\s+\d+\.\d+\.\d+\s*(?:->|→)\s*\d+\.\d+\.\d+|A new version of Codex is available[.!]?)[^\S\r\n]*$/im;
+/**
+ * A captured first-party banner alone counts so a partial layout fails safe
+ * before its options paint. Generic "update available" prose does not count;
+ * an option-only frame must carry both the update and safe choices.
+ */
+export function codexUpdatePromptVisible(frameText) {
+    if (updateScreenBanner.test(frameText))
+        return true;
+    const options = numberedOptions(frameText);
+    return (options.some((option) => /update\s+now/i.test(option.label)) &&
+        options.some((option) => codexUpdateOptionPattern.test(option.label)));
+}
+/** Keeps a split prompt blocking until a frame with no update evidence clears it. */
+export class CodexUpdatePromptTracker {
+    active = false;
+    generation = 0;
+    observe(frameText) {
+        if (codexUpdatePromptVisible(frameText)) {
+            if (!this.active)
+                this.generation += 1;
+            this.active = true;
+        }
+        else if (!(this.active && isSafeUpdateContinuation(frameText))) {
+            if (this.active)
+                this.generation += 1;
+            this.active = false;
+        }
+        return this.active;
+    }
+    /** Captures the current prompt generation so an async retry cannot enter a later dialog. */
+    currentFramePredicate() {
+        const generation = this.generation;
+        return (frameText) => this.active &&
+            this.generation === generation &&
+            (codexUpdatePromptVisible(frameText) || isSafeUpdateContinuation(frameText));
+    }
+}
+function isSafeUpdateContinuation(frameText) {
+    if (nonOptionText(frameText).trim() !== "")
+        return false;
+    return numberedOptions(frameText).some((option) => /continue\s*without\s*updat|skip/i.test(option.label));
+}
+const retryIntervalMs = 250;
+const retryTimeoutMs = 5_000;
+/** Retries a possibly swallowed startup hotkey only while its safe option remains visible. */
+export async function writeCodexUpdateSkip(option, write, readFrame, currentUpdateFrame = codexUpdatePromptVisible) {
+    if (readFrame === undefined) {
+        await write(option);
+        return;
+    }
+    const deadline = Date.now() + retryTimeoutMs;
+    while (Date.now() < deadline) {
+        const frame = readFrame();
+        if (!currentUpdateFrame(frame))
+            return;
+        const safeOption = numberedOptions(frame).find((candidate) => codexUpdateOptionPattern.test(candidate.label));
+        if (safeOption === undefined) {
+            throw new Error("Codex update prompt no longer exposes a safe skip option.");
+        }
+        await write(safeOption.number);
+        await wait(retryIntervalMs);
+    }
+    throw new Error("Codex update prompt did not clear after safe-option retries.");
+}
+function wait(ms) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(resolve, ms);
+        timer.unref();
+    });
+}
+//# sourceMappingURL=update-prompt.js.map

package/dist/codex/update-prompt.js.map

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

package/dist/codex/validate-result.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Runtime validation for Codex hook handler results.
+ * Implements PRD §7A.2.
+ */
+import type { CodexHookEvent, CodexHookEventName, CodexHookResult } from "./hooks.ts";
+export declare function isCodexHookResult(event: CodexHookEventName | CodexHookEvent, value: unknown): value is CodexHookResult;
+//# sourceMappingURL=validate-result.d.ts.map

package/dist/codex/validate-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-result.d.ts","sourceRoot":"","sources":["../../src/codex/validate-result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,GAAG,cAAc,EAC1C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,eAAe,CAY1B"}

package/dist/codex/validate-result.js

@@ -0,0 +1,84 @@
+/**
+ * Runtime validation for Codex hook handler results.
+ * Implements PRD §7A.2.
+ */
+import { isOneOf, isRecord, optionalString } from "../core/predicates.js";
+export function isCodexHookResult(event, value) {
+    const eventName = typeof event === "string" ? event : event.hook_event_name;
+    const toolName = typeof event === "string" || !("tool_name" in event) ? undefined : event.tool_name;
+    if (value === undefined)
+        return true;
+    if (!isRecord(value))
+        return false;
+    if ("permissionDecision" in value)
+        return isPreToolUseResult(eventName, value, toolName);
+    if (eventName === "PreToolUse" && "additionalContext" in value)
+        return isPreToolUseResult(eventName, value, toolName);
+    if ("behavior" in value)
+        return isPermissionRequestResult(eventName, value);
+    if ("decision" in value)
+        return isBlockResult(eventName, value);
+    return isStopResult(eventName, value);
+}
+function isPreToolUseResult(eventName, value, toolName) {
+    if (eventName !== "PreToolUse")
+        return false;
+    if (!keysAre(value, [
+        "permissionDecision",
+        "permissionDecisionReason",
+        "updatedInput",
+        "additionalContext",
+    ])) {
+        return false;
+    }
+    if ("additionalContext" in value && !("permissionDecision" in value)) {
+        return Object.keys(value).length === 1 && typeof value["additionalContext"] === "string";
+    }
+    if (value["permissionDecision"] === "deny") {
+        return (typeof value["permissionDecisionReason"] === "string" &&
+            !("updatedInput" in value) &&
+            !("additionalContext" in value));
+    }
+    return (value["permissionDecision"] === "allow" &&
+        !("permissionDecisionReason" in value) &&
+        !("additionalContext" in value) &&
+        isCodexToolInputUpdate(toolName, value["updatedInput"]));
+}
+function isPermissionRequestResult(eventName, value) {
+    return (eventName === "PermissionRequest" &&
+        keysAre(value, ["behavior", "message"]) &&
+        isOneOf(value["behavior"], ["allow", "deny"]) &&
+        optionalString(value["message"]));
+}
+function isBlockResult(eventName, value) {
+    return (isOneOf(eventName, ["SubagentStop", "Stop"]) &&
+        value["decision"] === "block" &&
+        typeof value["reason"] === "string" &&
+        optionalString(value["additionalContext"]));
+}
+function isStopResult(eventName, value) {
+    if (eventName !== "Stop" && eventName !== "SubagentStop")
+        return false;
+    return isContinueFalseResult(value);
+}
+function isContinueFalseResult(value) {
+    return (keysAre(value, ["continue", "stopReason", "additionalContext"]) &&
+        value["continue"] === false &&
+        typeof value["stopReason"] === "string" &&
+        optionalString(value["additionalContext"]));
+}
+function keysAre(value, allowed) {
+    return Object.keys(value).every((key) => allowed.includes(key));
+}
+function isCodexToolInputUpdate(toolName, value) {
+    if (value === undefined)
+        return true;
+    if (!isRecord(value))
+        return false;
+    if (toolName !== "Bash" && toolName !== "apply_patch")
+        return true;
+    return (keysAre(value, ["command", "description"]) &&
+        optionalString(value["description"]) &&
+        ("command" in value ? typeof value["command"] === "string" : true));
+}
+//# sourceMappingURL=validate-result.js.map

package/dist/codex/validate-result.js.map

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

package/dist/codex/validate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Runtime validation for Codex hook payloads and handler results.
+ * Implements PRD §7A.2.
+ */
+import type { CodexHookEvent } from "./hooks.ts";
+export { isCodexHookResult } from "./validate-result.ts";
+export declare function normalizeCodexHookEvent(event: CodexHookEvent): CodexHookEvent;
+export declare function isCodexHookEvent(value: unknown): value is CodexHookEvent;
+/** True for the built-in command tools whose `tool_input` Elwood narrows (§7A.2). */
+export declare function isKnownCommandTool(value: string): boolean;
+//# sourceMappingURL=validate.d.ts.map

package/dist/codex/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/codex/validate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAG7E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CA8BxE;AAqCD,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/codex/validate.js

@@ -0,0 +1,88 @@
+/**
+ * Runtime validation for Codex hook payloads and handler results.
+ * Implements PRD §7A.2.
+ */
+import { isOneOf, isRecord, optionalString } from "../core/predicates.js";
+export { isCodexHookResult } from "./validate-result.js";
+export function normalizeCodexHookEvent(event) {
+    if (!("tool_name" in event) || isPublicToolName(event.tool_name))
+        return event;
+    return { ...event, tool_name: `unknown:${event.tool_name}` };
+}
+export function isCodexHookEvent(value) {
+    if (!isRecord(value))
+        return false;
+    const record = value;
+    if (!hasCommonFields(record))
+        return false;
+    const eventName = record["hook_event_name"];
+    if (eventName === "SessionStart")
+        return typeof record["source"] === "string";
+    if (!hasTurnFields(record))
+        return false;
+    switch (eventName) {
+        case "SubagentStart":
+            return hasSubagentFields(record);
+        case "PreToolUse":
+        case "PermissionRequest":
+        case "PostToolUse":
+            return hasToolFields(record);
+        case "PreCompact":
+        case "PostCompact":
+            return typeof record["trigger"] === "string";
+        case "UserPromptSubmit":
+            return typeof record["prompt"] === "string";
+        case "SubagentStop":
+            return (hasSubagentFields(record) &&
+                hasStopFields(record) &&
+                optionalNullableString(record["agent_transcript_path"]));
+        case "Stop":
+            return hasStopFields(record);
+        default:
+            return false;
+    }
+}
+function hasCommonFields(record) {
+    return (typeof record["hook_event_name"] === "string" &&
+        typeof record["session_id"] === "string" &&
+        typeof record["cwd"] === "string" &&
+        optionalString(record["model"]) &&
+        optionalPermissionMode(record["permission_mode"]));
+}
+function hasTurnFields(record) {
+    return typeof record["turn_id"] === "string";
+}
+function hasSubagentFields(record) {
+    return typeof record["agent_id"] === "string" && typeof record["agent_type"] === "string";
+}
+function hasStopFields(record) {
+    return (typeof record["stop_hook_active"] === "boolean" &&
+        optionalNullableString(record["last_assistant_message"]));
+}
+function hasToolFields(record) {
+    if (typeof record["tool_name"] !== "string")
+        return false;
+    if (!isRecord(record["tool_input"]))
+        return false;
+    if (!optionalString(record["tool_use_id"]))
+        return false;
+    return isKnownCommandTool(record["tool_name"])
+        ? typeof record["tool_input"]["command"] === "string" &&
+            optionalNullableString(record["tool_input"]["description"])
+        : true;
+}
+/** True for the built-in command tools whose `tool_input` Elwood narrows (§7A.2). */
+export function isKnownCommandTool(value) {
+    return value === "Bash" || value === "apply_patch";
+}
+function isPublicToolName(value) {
+    return isKnownCommandTool(value) || value.startsWith("mcp__") || value.startsWith("unknown:");
+}
+function optionalNullableString(value) {
+    return value === undefined || value === null || typeof value === "string";
+}
+function optionalPermissionMode(value) {
+    return (value === undefined ||
+        isOneOf(value, ["default", "acceptEdits", "plan", "auto", "dontAsk", "bypassPermissions"]));
+}
+//# sourceMappingURL=validate.js.map

package/dist/codex/validate.js.map

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

package/dist/core/activity/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Unified activity events shared across agent adapters.
+ * Implements PRD §5.4.
+ */
+import type { ClaudeHookEvent } from "../../claude/hooks/index.ts";
+import type { CodexHookEvent } from "../../codex/hooks/index.ts";
+import type { ElwoodSessionStatus, ElwoodWarningEvent, HookErrorEvent } from "../types.ts";
+export type ElwoodAgentKind = "claude" | "codex";
+export type ElwoodActivitySource = "hook" | "transcript" | "terminal" | "lifecycle";
+export type ElwoodActivityKind = "status" | "terminal_exit" | "user_message" | "assistant_message" | "reasoning" | "tool_call" | "tool_result" | "web_search" | "other" | "notification" | "warning" | "startup_prompt" | "attention" | "hook" | "hook_result" | "hook_error";
+export type ElwoodActivityEvent = {
+    readonly elwoodSessionId: string;
+    readonly agent: ElwoodAgentKind;
+    readonly source: ElwoodActivitySource;
+    readonly kind: ElwoodActivityKind;
+    readonly label: string;
+    readonly text?: string;
+    readonly hookEventName?: string;
+    readonly turnId?: string;
+    readonly toolName?: string;
+    readonly toolUseId?: string;
+    readonly toolInput?: string;
+    readonly toolOutput?: string;
+    readonly status?: ElwoodSessionStatus;
+    readonly exitCode?: number;
+    readonly failedOpen?: boolean;
+    readonly transcriptPath?: string;
+    readonly raw?: unknown;
+};
+export { activityFromStatus, activityFromTerminalExit, reapFailureWarning, } from "./lifecycle.ts";
+/**
+ * Claude hook → activity. Agent/event correlation stops a Claude event routing
+ * through the Codex path. Claude tool/assistant activity is transcript-sourced
+ * (C-CLAUDE-15), so those hooks stay plain `hook` here (no transcript duplicate).
+ */
+export declare function activityFromClaudeHook(elwoodSessionId: string, event: ClaudeHookEvent): ElwoodActivityEvent;
+/**
+ * Codex hook → activity. Codex's `assistant_message`, `tool_call`, and
+ * `tool_result` are sourced from the committed `codex:transcript` (C-CODEX-16),
+ * so the `Stop`/`PreToolUse`/`PostToolUse` hooks MUST NOT re-project them — that
+ * surfaced every reply and every tool step twice (once from the hook, once from
+ * the transcript). Those hooks stay plain `hook` turn-boundary signals here, and
+ * `Stop`'s `last_assistant_message` (which can be un-submitted ghost text) never
+ * becomes an `assistant_message`, exactly as for Claude (C-CLAUDE-15).
+ */
+export declare function activityFromCodexHook(elwoodSessionId: string, event: CodexHookEvent): ElwoodActivityEvent;
+export declare function activityFromHookError(agent: ElwoodAgentKind, event: HookErrorEvent): ElwoodActivityEvent;
+export declare function activityFromHookResult(agent: ElwoodAgentKind, elwoodSessionId: string, hookEventName: string, result: unknown, failedOpen: boolean): ElwoodActivityEvent;
+export declare function activityFromWarning(event: ElwoodWarningEvent): ElwoodActivityEvent;
+export { activityFromClaudeTranscript, activityFromCodexTranscript, } from "./transcript.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/activity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/activity/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3F,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AACjD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC;AACpF,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,WAAW,GACX,WAAW,GACX,aAAa,GACb,YAAY,GACZ,OAAO,GACP,cAAc,GACd,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,MAAM,GACN,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAgBxB;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,eAAe,GACrB,mBAAmB,CAIrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,cAAc,GACpB,mBAAmB,CAIrB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,cAAc,GACpB,mBAAmB,CAWrB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,OAAO,GAClB,mBAAmB,CAWrB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CAUlF;AAED,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC"}