@with-logic/elwood 0.1.0

package/dist/claude/transcript/index.js

@@ -0,0 +1,191 @@
+/**
+ * Best-effort live observation of Claude transcript JSONL files.
+ * Implements PRD §5.4 (C-CLAUDE-15): committed assistant text, tool calls, and
+ * tool results are sourced from the transcript(s) the CLI writes (no ghost-text);
+ * reads are bounded, per-path, no replay.
+ */
+import { TranscriptCursor } from "./cursor.js";
+import { drainToBudget, newTerminalBudget } from "./drain.js";
+import { buildDrainContext } from "./drain-context.js";
+import { DropReporter, ReadErrorReporter, } from "./drops.js";
+import { LineEmitter } from "./emit.js";
+import { TranscriptFsGuard } from "./fs-guard.js";
+const pollMs = 500; // poll cadence: transcript activity is not latency-critical
+/** Read passes per scan, shared across ALL cursors (×256 KiB ≈ 4 MiB): a huge delta drains across poll ticks, not one event-loop block (§9.2). */
+const scanChunksPerScan = 16;
+export class ClaudeTranscriptWatcher {
+    // One cursor per observed path so A→B→A never rewinds A to the start.
+    cursors = new Map();
+    interval;
+    polling = false;
+    // A permanent terminal latch: once finished, no scan/emit/observe/poll runs.
+    finished = false;
+    // ONE budget shared across every retire() + finish(): terminal work is watcher-bounded (§9.2).
+    terminalBudget = newTerminalBudget();
+    drops;
+    guard;
+    onPollError;
+    pollIntervalMs;
+    lines;
+    drain;
+    // Test seam: run after each cursor's scan within a poll pass, so a test can drive the
+    // exact race where an earlier cursor's drop is pending when finish() lands mid-pass.
+    afterScanForTests;
+    setAfterScanForTests(hook) {
+        this.afterScanForTests = hook;
+    }
+    constructor(elwoodSessionId, emit, notices = {}) {
+        this.drops = new DropReporter(elwoodSessionId, notices.onDrop);
+        const readErrors = new ReadErrorReporter(elwoodSessionId, notices.onReadError);
+        this.guard = new TranscriptFsGuard(readErrors, () => this.finished);
+        this.onPollError = notices.onPollError;
+        this.pollIntervalMs = notices.pollIntervalMs ?? pollMs;
+        this.lines = new LineEmitter(elwoodSessionId, emit, this.drops);
+        this.drain = buildDrainContext({
+            guard: this.guard,
+            lines: this.lines,
+            drops: this.drops,
+            now: notices.now,
+        });
+    }
+    // Begin watching `path`: baselines at EOF (history not replayed); a turn-boundary
+    // first-observe (recoverTail) replays the committed tail (§5.4). No observation
+    // after finish — a late hook must not emit past terminal:exit.
+    observe(path, recoverTail = false) {
+        if (this.finished || this.cursors.has(path))
+            return;
+        const cursor = this.guard.read(path, () => new TranscriptCursor(path));
+        if (cursor === undefined)
+            return;
+        this.cursors.set(path, cursor);
+        if (recoverTail) {
+            const tail = this.guard.read(path, () => cursor.baselineTail());
+            this.lines.emitLines(path, tail?.text ?? "");
+            // A turn larger than the recovery window surfaces its out-of-window records as
+            // one bounded, content-free backlog drop warning so the gap is not silent (§5.4).
+            if (tail?.truncated && tail.droppedBytes > 0)
+                this.drops.drop(path, "unread_backlog");
+            this.drops.flushPass(); // deliver this observe's coalesced drops
+        }
+        this.ensurePolling();
+    }
+    scan() {
+        if (this.finished)
+            return;
+        const budget = { chunks: scanChunksPerScan };
+        for (const cursor of this.cursors.values()) {
+            if (budget.chunks <= 0)
+                break; // watcher-wide budget spent; resume next tick
+            this.scanCursor(cursor, budget);
+        }
+        this.drops.flushPass(); // bounded drop delivery: one warning per (path, cause) per scan
+    }
+    // Flush + retire a stopped subagent's transcript (one-shot): drained against the
+    // SHARED terminal budget (not a fresh full one) and a wall-clock slice — bounded,
+    // non-blocking; backlog past the bound drops content-free, then the cursor is gone.
+    retire(path) {
+        const cursor = this.cursors.get(path);
+        if (!cursor || this.finished)
+            return;
+        drainToBudget(this.drain, [cursor], this.terminalBudget);
+        this.cursors.delete(path);
+    }
+    pollOnceForTests() {
+        return this.poll(); // test seam: drive one poll pass synchronously
+    }
+    // Idle-friendly poll: an async stat gates each cursor (no sync fs work when idle,
+    // §9.2); a bounded sync read runs only on growth. Re-entrancy-guarded.
+    async poll() {
+        if (this.polling || this.finished)
+            return;
+        this.polling = true;
+        try {
+            const budget = { chunks: scanChunksPerScan }; // one budget for the whole pass
+            for (const cursor of this.cursors.values()) {
+                const changed = await this.guard.readAsync(cursor.path, () => cursor.needsScan());
+                // Re-check after the await: finish() or retire() may have run mid-stat (§5.4).
+                if (this.finished)
+                    return;
+                if (this.cursors.get(cursor.path) !== cursor)
+                    continue;
+                if (budget.chunks <= 0)
+                    break; // watcher-wide budget spent this tick
+                if (changed)
+                    this.scanCursor(cursor, budget);
+                this.afterScanForTests?.(); // test seam: drive finish() between cursors
+            }
+        }
+        finally {
+            // Deliver this pass's drops ONLY while still live. If finish() ran during the
+            // awaited stat it already drained and emitted terminal:exit; flushing here would
+            // emit a warning/activity AFTER the permanent terminal latch (§5.4). Discard the
+            // unfinished pass instead so nothing escapes past exit.
+            if (this.finished)
+                this.drops.discardPass();
+            else
+                this.drops.flushPass(); // one warning per (path, cause) per poll
+            this.polling = false;
+        }
+    }
+    // Flush buffered partials, then permanently stop. `finished` set FIRST so an
+    // in-flight poll bails and later observe/scan/retire no-op — nothing emits past
+    // terminal:exit (§5.4); flushing must not prevent stop() (finally). The drain uses
+    // the shared budget's LEFTOVER and is wall-clock-slice-bounded (§9.2).
+    finish() {
+        if (this.finished)
+            return;
+        this.finished = true;
+        try {
+            drainToBudget(this.drain, [...this.cursors.values()], this.terminalBudget);
+        }
+        finally {
+            this.stop();
+        }
+    }
+    stop() {
+        if (this.interval)
+            clearInterval(this.interval);
+        this.interval = undefined;
+    }
+    ensurePolling() {
+        if (this.interval || this.finished)
+            return;
+        // scanCursor can throw a listener error after the poll's await, which on the
+        // timer path would become an unhandled rejection; the catch stops the watcher
+        // and routes the failure (non-throwing recovery).
+        this.interval = setInterval(() => {
+            void this.poll().catch((error) => this.recoverFromPollError(error));
+        }, this.pollIntervalMs);
+        this.interval.unref?.();
+    }
+    // Non-throwing recovery for a failed poll: finish() and the poll-error diagnostic
+    // can each throw a listener error, which would become a host-terminating unhandled
+    // rejection, so each step is contained.
+    recoverFromPollError(error) {
+        try {
+            this.finish();
+        }
+        catch {
+            this.stop(); // finish() threw mid-drain: still guarantee the timer is cleared
+        }
+        try {
+            this.onPollError?.(error);
+        }
+        catch { } // a diagnostic listener bug must not resurrect the failure
+    }
+    // Drain a cursor in bounded chunks against the SHARED per-scan budget (sync work
+    // bounded across ALL cursors); the read is contained, parse/emit run outside it.
+    scanCursor(cursor, budget) {
+        while (budget.chunks > 0) {
+            budget.chunks -= 1;
+            const chunk = this.guard.read(cursor.path, () => cursor.readChunk());
+            if (chunk === undefined)
+                return; // contained FS failure; keep last offset
+            if (chunk.text.length > 0)
+                this.lines.emitLines(cursor.path, chunk.text, cursor);
+            if (!chunk.canContinueNow)
+                return;
+        } // budget exhausted with more to read: the next poll tick resumes here.
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * Summarizes a committed Claude transcript record into activity-ready items.
+ * Implements PRD §5.4 (C-CLAUDE-15): assistant text, tool calls, and tool
+ * results are sourced from the committed transcript, never from ghost-text.
+ */
+/**
+ * A committed transcript item, discriminated by kind so each variant carries
+ * only the fields it can have (an `assistant_message` always has `text`; a
+ * `tool_call` always has `toolName`; a `tool_result` always has `toolUseId`).
+ */
+export type ClaudeTranscriptSummary = {
+    readonly kind: "assistant_message";
+    readonly label: string;
+    readonly text: string;
+} | {
+    readonly kind: "reasoning";
+    readonly label: string;
+    readonly text: string;
+} | {
+    readonly kind: "tool_call";
+    readonly label: string;
+    readonly toolName: string;
+    readonly toolUseId?: string;
+    readonly toolInput?: string;
+} | {
+    readonly kind: "tool_result";
+    readonly label: string;
+    readonly toolUseId: string;
+    readonly toolOutput?: string;
+};
+/**
+ * Expands one transcript record into zero or more summaries. A Claude record is
+ * an Anthropic Messages-API turn (`{ type, message: { role, content } }`) whose
+ * `content` is `text` / `tool_use` / `tool_result` blocks. Only committed
+ * ASSISTANT text and tool calls/results become activity (C-CLAUDE-15): user
+ * prose stays hook-sourced from `UserPromptSubmit`, so it is NOT emitted here
+ * (that would double every submitted prompt). Non-message records yield nothing.
+ */
+export declare function summarizeClaudeRecord(item: unknown): readonly ClaudeTranscriptSummary[];
+//# sourceMappingURL=summary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/claude/transcript/summary.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7E;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAKN;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,uBAAuB,EAAE,CASvF"}

package/dist/claude/transcript/summary.js

@@ -0,0 +1,90 @@
+/**
+ * Summarizes a committed Claude transcript record into activity-ready items.
+ * Implements PRD §5.4 (C-CLAUDE-15): assistant text, tool calls, and tool
+ * results are sourced from the committed transcript, never from ghost-text.
+ */
+import { stringify } from "../../core/serialize.js";
+/**
+ * Expands one transcript record into zero or more summaries. A Claude record is
+ * an Anthropic Messages-API turn (`{ type, message: { role, content } }`) whose
+ * `content` is `text` / `tool_use` / `tool_result` blocks. Only committed
+ * ASSISTANT text and tool calls/results become activity (C-CLAUDE-15): user
+ * prose stays hook-sourced from `UserPromptSubmit`, so it is NOT emitted here
+ * (that would double every submitted prompt). Non-message records yield nothing.
+ */
+export function summarizeClaudeRecord(item) {
+    const record = asRecord(item);
+    const type = stringValue(record["type"]);
+    if (type !== "assistant" && type !== "user")
+        return [];
+    const role = type;
+    const content = asRecord(record["message"])["content"];
+    if (typeof content === "string")
+        return assistantText(role, content);
+    if (!Array.isArray(content))
+        return [];
+    return content.flatMap((block) => summarizeBlock(role, block));
+}
+function summarizeBlock(role, block) {
+    const record = asRecord(block);
+    const type = stringValue(record["type"]);
+    if (type === "text")
+        return assistantText(role, stringValue(record["text"]) ?? "");
+    if (type === "thinking")
+        return reasoning(role, stringValue(record["thinking"]) ?? "");
+    if (type === "tool_use")
+        return [toolCall(record)];
+    if (type === "tool_result")
+        return [toolResult(record)];
+    // `redacted_thinking` carries only an opaque encrypted `data` blob (no readable
+    // text), so it is dropped here alongside any other unknown block type.
+    return [];
+}
+/**
+ * Extended-thinking prose from an assistant `thinking` block (C-CLAUDE-15). Like
+ * assistant text, only ASSISTANT reasoning is surfaced and empty thinking is
+ * dropped. The plaintext is committed to the transcript by the CLI, so it needs no
+ * hook and is surfaced as a `reasoning` activity — mirroring Codex (§5.4, §7A.4).
+ */
+function reasoning(role, text) {
+    if (role !== "assistant" || text.length === 0)
+        return [];
+    return [{ kind: "reasoning", label: "thinking", text }];
+}
+/** Assistant prose only: user text is intentionally dropped (hook-sourced). */
+function assistantText(role, text) {
+    if (role !== "assistant" || text.length === 0)
+        return [];
+    return [{ kind: "assistant_message", label: role, text }];
+}
+function toolCall(block) {
+    const name = stringValue(block["name"]) ?? "tool";
+    return {
+        kind: "tool_call",
+        label: name,
+        toolName: name,
+        ...optional("toolUseId", stringValue(block["id"])),
+        ...optional("toolInput", stringify(block["input"])),
+    };
+}
+function toolResult(block) {
+    const id = stringValue(block["tool_use_id"]) ?? "tool";
+    return {
+        kind: "tool_result",
+        label: id,
+        toolUseId: id,
+        ...optional("toolOutput", stringify(block["content"])),
+    };
+}
+function optional(key, value) {
+    return value === undefined ? {} : { [key]: value };
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function stringValue(value) {
+    return typeof value === "string" ? value : undefined;
+}
+//# sourceMappingURL=summary.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * Builds bounded, content-free transcript diagnostic warnings.
+ * Implements PRD §5.4 (C-CLAUDE-15): 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 warnings are live-only (§5.7): each is emitted once when observed
+ * and is never persisted, counted, or replayed.
+ */
+import type { ElwoodWarningEvent } from "../../core/types.ts";
+import type { TranscriptDropNotice, TranscriptReadErrorNotice } from "./drops.ts";
+/** The shared drop warning, tagged for Claude. */
+export declare function dropWarning(notice: TranscriptDropNotice): ElwoodWarningEvent;
+/** The shared read-error warning, tagged for Claude. */
+export declare function readErrorWarning(notice: TranscriptReadErrorNotice): ElwoodWarningEvent;
+/** Which lifecycle phase surfaced a transcript-processing failure (§5.4). */
+export type TranscriptFailurePhase = "poll" | "final_flush";
+/**
+ * A programming error escaped transcript processing; the watcher stopped (§5.4).
+ * Phase-neutral by design: `phase` records WHERE it escaped — a live periodic poll
+ * (`"poll"`) or the final flush at PTY exit (`"final_flush"`) — so a failed shutdown
+ * flush (lost trailing activity) is distinguishable from a live-watcher poll failure
+ * without a separate warning code. The public `transcript_poll_stopped` code is
+ * kept (PRD-required), but the builder is named for BOTH phases it now handles.
+ * This warning is live-only (emitted once when observed, never persisted), and the
+ * escaping error can be a downstream activity-listener exception whose message
+ * embeds raw transcript items (prompts, tool output, credentials). To honor the
+ * content-free warning guarantee (§5.4/§8.3), only a bounded, allowlisted error
+ * NAME/errno reaches the emitted fields — never `error.message` or `String(error)`.
+ */
+export declare function transcriptFailureWarning(elwoodSessionId: string, error: unknown, phase?: TranscriptFailurePhase): ElwoodWarningEvent;
+//# sourceMappingURL=warnings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../../../src/claude/transcript/warnings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAElF,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,kBAAkB,CAE5E;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,yBAAyB,GAAG,kBAAkB,CAEtF;AAED,6EAA6E;AAC7E,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,aAAa,CAAC;AAQ5D;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,OAAO,EACd,KAAK,GAAE,sBAA+B,GACrC,kBAAkB,CAepB"}

package/dist/claude/transcript/warnings.js

@@ -0,0 +1,53 @@
+/**
+ * Builds bounded, content-free transcript diagnostic warnings.
+ * Implements PRD §5.4 (C-CLAUDE-15): 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 warnings are live-only (§5.7): each is emitted once when observed
+ * and is never persisted, counted, or replayed.
+ */
+import { dropWarning as sharedDropWarning, readErrorWarning as sharedReadErrorWarning, } from "../../core/transcript/warnings.js";
+import { boundedErrorToken, isPollErrorReason } from "../../core/warnings/reasons.js";
+/** The shared drop warning, tagged for Claude. */
+export function dropWarning(notice) {
+    return sharedDropWarning("claude", notice);
+}
+/** The shared read-error warning, tagged for Claude. */
+export function readErrorWarning(notice) {
+    return sharedReadErrorWarning("claude", notice);
+}
+/** Phase-specific message so an operator can tell WHICH phase failed. */
+const phaseMessage = {
+    poll: "Transcript polling stopped after an unexpected error.",
+    final_flush: "Transcript final flush at exit failed after an unexpected error.",
+};
+/**
+ * A programming error escaped transcript processing; the watcher stopped (§5.4).
+ * Phase-neutral by design: `phase` records WHERE it escaped — a live periodic poll
+ * (`"poll"`) or the final flush at PTY exit (`"final_flush"`) — so a failed shutdown
+ * flush (lost trailing activity) is distinguishable from a live-watcher poll failure
+ * without a separate warning code. The public `transcript_poll_stopped` code is
+ * kept (PRD-required), but the builder is named for BOTH phases it now handles.
+ * This warning is live-only (emitted once when observed, never persisted), and the
+ * escaping error can be a downstream activity-listener exception whose message
+ * embeds raw transcript items (prompts, tool output, credentials). To honor the
+ * content-free warning guarantee (§5.4/§8.3), only a bounded, allowlisted error
+ * NAME/errno reaches the emitted fields — never `error.message` or `String(error)`.
+ */
+export function transcriptFailureWarning(elwoodSessionId, error, phase = "poll") {
+    // Only an allowlisted poll error-name/errno survives; any conversation-derived
+    // string collapses to `UnknownError` via the shared bounded-token helper (§5.7).
+    const reason = boundedErrorToken(error, isPollErrorReason);
+    return {
+        elwoodSessionId,
+        agent: "claude",
+        source: "terminal",
+        code: "transcript_poll_stopped",
+        severity: "warning",
+        message: phaseMessage[phase],
+        reason,
+        phase,
+        raw: `transcript_poll_stopped phase=${phase} reason=${reason}`,
+    };
+}
+//# sourceMappingURL=warnings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.js","sourceRoot":"","sources":["../../../src/claude/transcript/warnings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,WAAW,IAAI,iBAAiB,EAChC,gBAAgB,IAAI,sBAAsB,GAC3C,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGtF,kDAAkD;AAClD,MAAM,UAAU,WAAW,CAAC,MAA4B;IACtD,OAAO,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,CAAC,MAAiC;IAChE,OAAO,sBAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAKD,yEAAyE;AACzE,MAAM,YAAY,GAA2C;IAC3D,IAAI,EAAE,uDAAuD;IAC7D,WAAW,EAAE,kEAAkE;CAChF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACtC,eAAuB,EACvB,KAAc,EACd,QAAgC,MAAM;IAEtC,+EAA+E;IAC/E,iFAAiF;IACjF,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAC3D,OAAO;QACL,eAAe;QACf,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC;QAC5B,MAAM;QACN,KAAK;QACL,GAAG,EAAE,iCAAiC,KAAK,WAAW,MAAM,EAAE;KAC/D,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Public construction options for the Claude transcript watcher.
+ * Implements PRD §5.4 (C-CLAUDE-15): the diagnostic notice handlers (bounded,
+ * content-free) the watcher forwards for observation problems.
+ */
+import type { TranscriptDropNotice, TranscriptReadErrorNotice } from "./drops.ts";
+/** Notices the watcher forwards for observation problems (each fired live, once). */
+export type TranscriptNoticeHandlers = {
+    readonly onDrop?: (notice: TranscriptDropNotice) => void;
+    readonly onReadError?: (notice: TranscriptReadErrorNotice) => void;
+    /** A programming error escaped the timer poll; the watcher has stopped. */
+    readonly onPollError?: (error: unknown) => void;
+    /** Poll cadence override (defaults to the watcher default); tests use a short interval. */
+    readonly pollIntervalMs?: 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/claude/transcript/watcher-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher-config.d.ts","sourceRoot":"","sources":["../../../src/claude/transcript/watcher-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAElF,qFAAqF;AACrF,MAAM,MAAM,wBAAwB,GAAG;IACrC,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,2EAA2E;IAC3E,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/claude/transcript/watcher-config.js

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

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

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

package/dist/claude/validate/input.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Runtime validation for Claude hook inputs crossing the bridge: common fields,
+ * then a per-event predicate table keyed by `hook_event_name`.
+ * Implements PRD §6.4.
+ */
+import type { ClaudeHookEvent } from "../hooks/index.ts";
+export declare function isClaudeHookInput(value: unknown): value is ClaudeHookEvent;
+//# sourceMappingURL=input.d.ts.map

package/dist/claude/validate/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/claude/validate/input.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA+DzD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAW1E"}

package/dist/claude/validate/input.js

@@ -0,0 +1,137 @@
+/**
+ * Runtime validation for Claude hook inputs crossing the bridge: common fields,
+ * then a per-event predicate table keyed by `hook_event_name`.
+ * Implements PRD §6.4.
+ */
+import { isOneOf, isRecord, isString, optionalBoolean, optionalString, } from "../../core/predicates.js";
+import { claudeHookPermissionModes, } from "../hooks/names.js";
+import { isToolHookEventName } from "../hooks/tool-events.js";
+const effortLevels = ["low", "medium", "high", "xhigh", "max"];
+const _effortLevelsCoupled = true;
+void _effortLevelsCoupled;
+const compactTrigger = (value) => isOneOf(value["trigger"], ["manual", "auto"]);
+const strings = (...keys) => (value) => hasStrings(value, keys);
+// One predicate per non-tool event; tool events share `hasToolEventFields`. The
+// table is keyed by the public union so a new event name cannot be forgotten.
+const eventChecks = {
+    SessionStart: strings("source"),
+    Setup: (value) => isOneOf(value["trigger"], ["init", "maintenance"]),
+    InstructionsLoaded: hasInstructionsLoaded,
+    UserPromptSubmit: strings("prompt"),
+    UserPromptExpansion: hasUserPromptExpansion,
+    PostToolBatch: (value) => hasPostToolBatch(value["tool_calls"]),
+    Notification: strings("message", "notification_type"),
+    SubagentStart: strings("agent_id", "agent_type"),
+    SubagentStop: strings("agent_id", "agent_type", "agent_transcript_path"),
+    TaskCreated: strings("task_id", "task_subject"),
+    TaskCompleted: strings("task_id", "task_subject"),
+    Stop: (value) => optionalBoolean(value["stop_hook_active"]),
+    StopFailure: strings("error"),
+    TeammateIdle: strings("teammate_name", "team_name"),
+    ConfigChange: strings("source"),
+    CwdChanged: strings("old_cwd", "new_cwd"),
+    FileChanged: (value) => hasStrings(value, ["file_path"]) && isOneOf(value["event"], ["change", "add", "unlink"]),
+    WorktreeCreate: strings("name"),
+    WorktreeRemove: strings("worktree_path"),
+    PreCompact: (value) => compactTrigger(value) && isNullableOptionalString(value["custom_instructions"]),
+    PostCompact: (value) => compactTrigger(value) && hasStrings(value, ["compact_summary"]),
+    SessionEnd: strings("reason"),
+    Elicitation: strings("mcp_server_name", "message"),
+    ElicitationResult: strings("mcp_server_name", "action"),
+};
+export function isClaudeHookInput(value) {
+    if (!(isRecord(value) && hasStrings(value, ["hook_event_name", "session_id", "cwd"]))) {
+        return false;
+    }
+    if (!hasValidCommonFields(value))
+        return false;
+    const eventName = value["hook_event_name"];
+    if (isToolHookEventName(eventName))
+        return hasToolEventFields(eventName, value);
+    return (Object.hasOwn(eventChecks, eventName) &&
+        eventChecks[eventName](value));
+}
+// C-HOOK-07 / C-HOOK-17: typed optional common fields present on every hook
+// event must match ClaudeCommonHookFields, not merely be ignored.
+function hasValidCommonFields(value) {
+    return (optionalString(value["transcript_path"]) &&
+        (value["permission_mode"] === undefined ||
+            isOneOf(value["permission_mode"], claudeHookPermissionModes)) &&
+        isValidEffort(value["effort"]));
+}
+function isValidEffort(value) {
+    if (value === undefined)
+        return true;
+    return isRecord(value) && isOneOf(value["level"], effortLevels);
+}
+function hasToolEventFields(eventName, value) {
+    return (typeof value["tool_name"] === "string" &&
+        isToolInput(value["tool_name"], value["tool_input"]) &&
+        hasToolSpecificEventFields(eventName, value));
+}
+function hasToolSpecificEventFields(eventName, value) {
+    if (eventName === "PostToolUse")
+        return "tool_response" in value;
+    if (eventName === "PostToolUseFailure")
+        return typeof value["error"] === "string";
+    if (eventName === "PermissionDenied")
+        return hasStrings(value, ["tool_use_id", "reason"]);
+    return true;
+}
+const toolInputChecks = {
+    Agent: (input) => typeof input["prompt"] === "string",
+    AskUserQuestion: isAskUserQuestionInput,
+    Bash: (input) => typeof input["command"] === "string",
+    Edit: (input) => hasStrings(input, ["file_path", "old_string", "new_string"]),
+    Glob: (input) => typeof input["pattern"] === "string",
+    Grep: (input) => typeof input["pattern"] === "string",
+    Read: (input) => typeof input["file_path"] === "string",
+    WebFetch: (input) => hasStrings(input, ["url", "prompt"]),
+    WebSearch: (input) => typeof input["query"] === "string",
+    Write: (input) => hasStrings(input, ["file_path", "content"]),
+};
+function isToolInput(toolName, input) {
+    if (!isRecord(input))
+        return false;
+    const check = Object.hasOwn(toolInputChecks, toolName) ? toolInputChecks[toolName] : undefined;
+    return check === undefined || check(input);
+}
+function hasInstructionsLoaded(value) {
+    return (hasStrings(value, ["file_path"]) &&
+        isOneOf(value["memory_type"], ["User", "Project", "Local", "Managed"]) &&
+        isOneOf(value["load_reason"], [
+            "session_start",
+            "nested_traversal",
+            "path_glob_match",
+            "include",
+            "compact",
+        ]));
+}
+function hasUserPromptExpansion(value) {
+    return (hasStrings(value, ["prompt", "command_name"]) &&
+        isOneOf(value["expansion_type"], ["slash_command", "mcp_prompt"]));
+}
+function hasPostToolBatch(value) {
+    return (Array.isArray(value) &&
+        value.every((item) => isRecord(item) && hasToolEventFields("PostToolUse", item)));
+}
+function isAskUserQuestionInput(input) {
+    return Array.isArray(input["questions"]) && input["questions"].every(isQuestion);
+}
+function isQuestion(value) {
+    return (isRecord(value) &&
+        hasStrings(value, ["question", "header"]) &&
+        Array.isArray(value["options"]) &&
+        value["options"].every(isQuestionOption) &&
+        optionalBoolean(value["multiSelect"]));
+}
+function isQuestionOption(value) {
+    return isRecord(value) && isString(value["label"]) && optionalString(value["description"]);
+}
+function hasStrings(value, keys) {
+    return keys.every((key) => isString(value[key]));
+}
+function isNullableOptionalString(value) {
+    return value === undefined || value === null || typeof value === "string";
+}
+//# sourceMappingURL=input.js.map