@maintainabilityai/research-runner 0.1.1

package/dist/schemas/audit-event.d.ts

@@ -0,0 +1,1151 @@
+/**
+ * AuditEvent — the hash-chained JSONL events written to
+ * `.research-audit/<run_id>.jsonl` by every node in both pipelines.
+ *
+ * Discriminated by `node_kind`. The common envelope at the top of every
+ * variant carries the chain: `prev_event_hash` + `event_hash`, both
+ * SHA-256. The first event in a run has `prev_event_hash: null`. The
+ * `run_complete` event closes the run with a chain root hash.
+ *
+ * See docs/design/research-and-prd-agents.md §"Audit schema — per-node
+ * JSONL events" for the canonical definitions.
+ */
+import { z } from 'zod';
+/** `pure_api` — deterministic external HTTP call (Tavily, arXiv, USPTO, HN, GitHub REST). */
+declare const PureApiEvent: z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"pure_api">;
+    api: z.ZodObject<{
+        provider: z.ZodString;
+        endpoint: z.ZodString;
+        /** Redacted query / body — secrets must NOT appear here. */
+        request_summary: z.ZodString;
+        http_status: z.ZodNumber;
+        response_byte_count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        endpoint: string;
+        request_summary: string;
+        http_status: number;
+        response_byte_count: number;
+    }, {
+        provider: string;
+        endpoint: string;
+        request_summary: string;
+        http_status: number;
+        response_byte_count: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "pure_api";
+    api: {
+        provider: string;
+        endpoint: string;
+        request_summary: string;
+        http_status: number;
+        response_byte_count: number;
+    };
+}, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "pure_api";
+    api: {
+        provider: string;
+        endpoint: string;
+        request_summary: string;
+        http_status: number;
+        response_byte_count: number;
+    };
+}>;
+/** `llm` — non-deterministic LLM call (plan_queries, synthesize, expert reviews). */
+declare const LlmEvent: z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"llm">;
+    llm: z.ZodObject<{
+        provider: z.ZodEnum<["anthropic", "openai", "azure-openai", "github-models"]>;
+        model: z.ZodString;
+        prompt_pack: z.ZodObject<{
+            /** Path relative to mesh root, e.g. `.caterpillar/prompts/research/synthesis.md@v1.0.0`. */
+            path: z.ZodString;
+            sha256: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            sha256: string;
+        }, {
+            path: string;
+            sha256: string;
+        }>;
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        /** USD cost estimate. */
+        cost_usd: z.ZodNumber;
+        /** Guardrail decisions for this hop. */
+        guardrails: z.ZodObject<{
+            mode: z.ZodEnum<["strict", "default", "lenient"]>;
+            pre: z.ZodEnum<["PASS", "WARN", "BLOCK"]>;
+            post: z.ZodEnum<["PASS", "WARN", "BLOCK"]>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        }, {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        guardrails: {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        };
+        provider: "anthropic" | "openai" | "azure-openai" | "github-models";
+        model: string;
+        prompt_pack: {
+            path: string;
+            sha256: string;
+        };
+        input_tokens: number;
+        output_tokens: number;
+        cost_usd: number;
+    }, {
+        guardrails: {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        };
+        provider: "anthropic" | "openai" | "azure-openai" | "github-models";
+        model: string;
+        prompt_pack: {
+            path: string;
+            sha256: string;
+        };
+        input_tokens: number;
+        output_tokens: number;
+        cost_usd: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "llm";
+    llm: {
+        guardrails: {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        };
+        provider: "anthropic" | "openai" | "azure-openai" | "github-models";
+        model: string;
+        prompt_pack: {
+            path: string;
+            sha256: string;
+        };
+        input_tokens: number;
+        output_tokens: number;
+        cost_usd: number;
+    };
+}, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "llm";
+    llm: {
+        guardrails: {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        };
+        provider: "anthropic" | "openai" | "azure-openai" | "github-models";
+        model: string;
+        prompt_pack: {
+            path: string;
+            sha256: string;
+        };
+        input_tokens: number;
+        output_tokens: number;
+        cost_usd: number;
+    };
+}>;
+/** `pure` — local-only deterministic computation (validate, dedupe, structural check). */
+declare const PureEvent: z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"pure">;
+    pure: z.ZodObject<{
+        inputs_summary: z.ZodString;
+        outputs_summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        inputs_summary: string;
+        outputs_summary: string;
+    }, {
+        inputs_summary: string;
+        outputs_summary: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "pure";
+    pure: {
+        inputs_summary: string;
+        outputs_summary: string;
+    };
+}, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "pure";
+    pure: {
+        inputs_summary: string;
+        outputs_summary: string;
+    };
+}>;
+/** `node_error` — any node failure, before any retry. */
+declare const NodeErrorEvent: z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"node_error">;
+    error: z.ZodObject<{
+        message: z.ZodString;
+        /** Optional stack — redacted of secrets. */
+        stack: z.ZodOptional<z.ZodString>;
+        retryable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        retryable: boolean;
+        stack?: string | undefined;
+    }, {
+        message: string;
+        retryable: boolean;
+        stack?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "node_error";
+    error: {
+        message: string;
+        retryable: boolean;
+        stack?: string | undefined;
+    };
+}, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "node_error";
+    error: {
+        message: string;
+        retryable: boolean;
+        stack?: string | undefined;
+    };
+}>;
+/**
+ * `iteration_summary` — emitted once per PRD refinement loop iteration after
+ * `verify_grounding` resolves. Carries the 4 reviewer signals + composite +
+ * verdict in one place so the published PRD can render a score-progression
+ * table without re-parsing earlier events.
+ */
+declare const IterationSummaryEvent: z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"iteration_summary">;
+    iteration: z.ZodNumber;
+    summary: z.ZodObject<{
+        det_arch: z.ZodObject<{
+            severity: z.ZodEnum<["PASS", "MINOR", "MAJOR"]>;
+            invalid_citations: z.ZodNumber;
+            coverage_discrepancies: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        }, {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        }>;
+        det_sec: z.ZodObject<{
+            severity: z.ZodEnum<["PASS", "MINOR", "MAJOR"]>;
+            invalid_citations: z.ZodNumber;
+            coverage_discrepancies: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        }, {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        }>;
+        llm_arch: z.ZodObject<{
+            score: z.ZodNumber;
+            severity: z.ZodEnum<["PASS", "MINOR", "MAJOR", "BLOCKING"]>;
+        }, "strip", z.ZodTypeAny, {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        }, {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        }>;
+        llm_sec: z.ZodObject<{
+            score: z.ZodNumber;
+            severity: z.ZodEnum<["PASS", "MINOR", "MAJOR", "BLOCKING"]>;
+        }, "strip", z.ZodTypeAny, {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        }, {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        }>;
+        composite_score: z.ZodNumber;
+        /** |llm_arch.score - llm_sec.score| — used by verify_grounding for the disagreement rule. */
+        disagreement_delta: z.ZodNumber;
+        verdict: z.ZodEnum<["PASS", "ITERATE", "EXHAUSTED"]>;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        composite_score: number;
+        det_arch: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        det_sec: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        llm_arch: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        llm_sec: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        disagreement_delta: number;
+        verdict: "PASS" | "ITERATE" | "EXHAUSTED";
+        reason: string;
+    }, {
+        composite_score: number;
+        det_arch: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        det_sec: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        llm_arch: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        llm_sec: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        disagreement_delta: number;
+        verdict: "PASS" | "ITERATE" | "EXHAUSTED";
+        reason: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    iteration: number;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "iteration_summary";
+    summary: {
+        composite_score: number;
+        det_arch: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        det_sec: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        llm_arch: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        llm_sec: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        disagreement_delta: number;
+        verdict: "PASS" | "ITERATE" | "EXHAUSTED";
+        reason: string;
+    };
+}, {
+    run_id: string;
+    iteration: number;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "iteration_summary";
+    summary: {
+        composite_score: number;
+        det_arch: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        det_sec: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        llm_arch: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        llm_sec: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        disagreement_delta: number;
+        verdict: "PASS" | "ITERATE" | "EXHAUSTED";
+        reason: string;
+    };
+}>;
+/** `run_complete` — final event emitted by verify_and_trigger. Closes the chain. */
+declare const RunCompleteEvent: z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"run_complete">;
+    outcome: z.ZodObject<{
+        status: z.ZodEnum<["ok", "failed", "partial"]>;
+        mesh_sha: z.ZodString;
+        total_input_tokens: z.ZodNumber;
+        total_output_tokens: z.ZodNumber;
+        total_cost_usd: z.ZodNumber;
+        artifact_paths: z.ZodArray<z.ZodString, "many">;
+        pr_url: z.ZodOptional<z.ZodString>;
+        /** SHA-256 of the entire chain (the last event's event_hash). */
+        chain_root_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "ok" | "failed" | "partial";
+        mesh_sha: string;
+        total_input_tokens: number;
+        total_output_tokens: number;
+        total_cost_usd: number;
+        artifact_paths: string[];
+        chain_root_hash: string;
+        pr_url?: string | undefined;
+    }, {
+        status: "ok" | "failed" | "partial";
+        mesh_sha: string;
+        total_input_tokens: number;
+        total_output_tokens: number;
+        total_cost_usd: number;
+        artifact_paths: string[];
+        chain_root_hash: string;
+        pr_url?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "run_complete";
+    outcome: {
+        status: "ok" | "failed" | "partial";
+        mesh_sha: string;
+        total_input_tokens: number;
+        total_output_tokens: number;
+        total_cost_usd: number;
+        artifact_paths: string[];
+        chain_root_hash: string;
+        pr_url?: string | undefined;
+    };
+}, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "run_complete";
+    outcome: {
+        status: "ok" | "failed" | "partial";
+        mesh_sha: string;
+        total_input_tokens: number;
+        total_output_tokens: number;
+        total_cost_usd: number;
+        artifact_paths: string[];
+        chain_root_hash: string;
+        pr_url?: string | undefined;
+    };
+}>;
+export declare const AuditEvent: z.ZodDiscriminatedUnion<"node_kind", [z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"pure_api">;
+    api: z.ZodObject<{
+        provider: z.ZodString;
+        endpoint: z.ZodString;
+        /** Redacted query / body — secrets must NOT appear here. */
+        request_summary: z.ZodString;
+        http_status: z.ZodNumber;
+        response_byte_count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        endpoint: string;
+        request_summary: string;
+        http_status: number;
+        response_byte_count: number;
+    }, {
+        provider: string;
+        endpoint: string;
+        request_summary: string;
+        http_status: number;
+        response_byte_count: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "pure_api";
+    api: {
+        provider: string;
+        endpoint: string;
+        request_summary: string;
+        http_status: number;
+        response_byte_count: number;
+    };
+}, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "pure_api";
+    api: {
+        provider: string;
+        endpoint: string;
+        request_summary: string;
+        http_status: number;
+        response_byte_count: number;
+    };
+}>, z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"llm">;
+    llm: z.ZodObject<{
+        provider: z.ZodEnum<["anthropic", "openai", "azure-openai", "github-models"]>;
+        model: z.ZodString;
+        prompt_pack: z.ZodObject<{
+            /** Path relative to mesh root, e.g. `.caterpillar/prompts/research/synthesis.md@v1.0.0`. */
+            path: z.ZodString;
+            sha256: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            sha256: string;
+        }, {
+            path: string;
+            sha256: string;
+        }>;
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        /** USD cost estimate. */
+        cost_usd: z.ZodNumber;
+        /** Guardrail decisions for this hop. */
+        guardrails: z.ZodObject<{
+            mode: z.ZodEnum<["strict", "default", "lenient"]>;
+            pre: z.ZodEnum<["PASS", "WARN", "BLOCK"]>;
+            post: z.ZodEnum<["PASS", "WARN", "BLOCK"]>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        }, {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        guardrails: {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        };
+        provider: "anthropic" | "openai" | "azure-openai" | "github-models";
+        model: string;
+        prompt_pack: {
+            path: string;
+            sha256: string;
+        };
+        input_tokens: number;
+        output_tokens: number;
+        cost_usd: number;
+    }, {
+        guardrails: {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        };
+        provider: "anthropic" | "openai" | "azure-openai" | "github-models";
+        model: string;
+        prompt_pack: {
+            path: string;
+            sha256: string;
+        };
+        input_tokens: number;
+        output_tokens: number;
+        cost_usd: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "llm";
+    llm: {
+        guardrails: {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        };
+        provider: "anthropic" | "openai" | "azure-openai" | "github-models";
+        model: string;
+        prompt_pack: {
+            path: string;
+            sha256: string;
+        };
+        input_tokens: number;
+        output_tokens: number;
+        cost_usd: number;
+    };
+}, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "llm";
+    llm: {
+        guardrails: {
+            mode: "strict" | "default" | "lenient";
+            pre: "PASS" | "WARN" | "BLOCK";
+            post: "PASS" | "WARN" | "BLOCK";
+        };
+        provider: "anthropic" | "openai" | "azure-openai" | "github-models";
+        model: string;
+        prompt_pack: {
+            path: string;
+            sha256: string;
+        };
+        input_tokens: number;
+        output_tokens: number;
+        cost_usd: number;
+    };
+}>, z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"pure">;
+    pure: z.ZodObject<{
+        inputs_summary: z.ZodString;
+        outputs_summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        inputs_summary: string;
+        outputs_summary: string;
+    }, {
+        inputs_summary: string;
+        outputs_summary: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "pure";
+    pure: {
+        inputs_summary: string;
+        outputs_summary: string;
+    };
+}, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "pure";
+    pure: {
+        inputs_summary: string;
+        outputs_summary: string;
+    };
+}>, z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"node_error">;
+    error: z.ZodObject<{
+        message: z.ZodString;
+        /** Optional stack — redacted of secrets. */
+        stack: z.ZodOptional<z.ZodString>;
+        retryable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        retryable: boolean;
+        stack?: string | undefined;
+    }, {
+        message: string;
+        retryable: boolean;
+        stack?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "node_error";
+    error: {
+        message: string;
+        retryable: boolean;
+        stack?: string | undefined;
+    };
+}, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "node_error";
+    error: {
+        message: string;
+        retryable: boolean;
+        stack?: string | undefined;
+    };
+}>, z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"iteration_summary">;
+    iteration: z.ZodNumber;
+    summary: z.ZodObject<{
+        det_arch: z.ZodObject<{
+            severity: z.ZodEnum<["PASS", "MINOR", "MAJOR"]>;
+            invalid_citations: z.ZodNumber;
+            coverage_discrepancies: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        }, {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        }>;
+        det_sec: z.ZodObject<{
+            severity: z.ZodEnum<["PASS", "MINOR", "MAJOR"]>;
+            invalid_citations: z.ZodNumber;
+            coverage_discrepancies: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        }, {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        }>;
+        llm_arch: z.ZodObject<{
+            score: z.ZodNumber;
+            severity: z.ZodEnum<["PASS", "MINOR", "MAJOR", "BLOCKING"]>;
+        }, "strip", z.ZodTypeAny, {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        }, {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        }>;
+        llm_sec: z.ZodObject<{
+            score: z.ZodNumber;
+            severity: z.ZodEnum<["PASS", "MINOR", "MAJOR", "BLOCKING"]>;
+        }, "strip", z.ZodTypeAny, {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        }, {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        }>;
+        composite_score: z.ZodNumber;
+        /** |llm_arch.score - llm_sec.score| — used by verify_grounding for the disagreement rule. */
+        disagreement_delta: z.ZodNumber;
+        verdict: z.ZodEnum<["PASS", "ITERATE", "EXHAUSTED"]>;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        composite_score: number;
+        det_arch: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        det_sec: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        llm_arch: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        llm_sec: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        disagreement_delta: number;
+        verdict: "PASS" | "ITERATE" | "EXHAUSTED";
+        reason: string;
+    }, {
+        composite_score: number;
+        det_arch: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        det_sec: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        llm_arch: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        llm_sec: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        disagreement_delta: number;
+        verdict: "PASS" | "ITERATE" | "EXHAUSTED";
+        reason: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    iteration: number;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "iteration_summary";
+    summary: {
+        composite_score: number;
+        det_arch: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        det_sec: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        llm_arch: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        llm_sec: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        disagreement_delta: number;
+        verdict: "PASS" | "ITERATE" | "EXHAUSTED";
+        reason: string;
+    };
+}, {
+    run_id: string;
+    iteration: number;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "iteration_summary";
+    summary: {
+        composite_score: number;
+        det_arch: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        det_sec: {
+            severity: "PASS" | "MINOR" | "MAJOR";
+            invalid_citations: number;
+            coverage_discrepancies: number;
+        };
+        llm_arch: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        llm_sec: {
+            score: number;
+            severity: "PASS" | "MINOR" | "MAJOR" | "BLOCKING";
+        };
+        disagreement_delta: number;
+        verdict: "PASS" | "ITERATE" | "EXHAUSTED";
+        reason: string;
+    };
+}>, z.ZodObject<{
+    run_id: z.ZodString;
+    /** Monotonically incrementing within a run, starting at 1. */
+    event_id: z.ZodNumber;
+    ts: z.ZodEffects<z.ZodString, string, string>;
+    node_name: z.ZodString;
+    duration_ms: z.ZodNumber;
+    /** SHA-256 of the previous serialized event (without its own event_hash). Null on event 1. */
+    prev_event_hash: z.ZodNullable<z.ZodString>;
+    /** SHA-256 of THIS event with `event_hash` set to the empty string. */
+    event_hash: z.ZodString;
+} & {
+    node_kind: z.ZodLiteral<"run_complete">;
+    outcome: z.ZodObject<{
+        status: z.ZodEnum<["ok", "failed", "partial"]>;
+        mesh_sha: z.ZodString;
+        total_input_tokens: z.ZodNumber;
+        total_output_tokens: z.ZodNumber;
+        total_cost_usd: z.ZodNumber;
+        artifact_paths: z.ZodArray<z.ZodString, "many">;
+        pr_url: z.ZodOptional<z.ZodString>;
+        /** SHA-256 of the entire chain (the last event's event_hash). */
+        chain_root_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "ok" | "failed" | "partial";
+        mesh_sha: string;
+        total_input_tokens: number;
+        total_output_tokens: number;
+        total_cost_usd: number;
+        artifact_paths: string[];
+        chain_root_hash: string;
+        pr_url?: string | undefined;
+    }, {
+        status: "ok" | "failed" | "partial";
+        mesh_sha: string;
+        total_input_tokens: number;
+        total_output_tokens: number;
+        total_cost_usd: number;
+        artifact_paths: string[];
+        chain_root_hash: string;
+        pr_url?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "run_complete";
+    outcome: {
+        status: "ok" | "failed" | "partial";
+        mesh_sha: string;
+        total_input_tokens: number;
+        total_output_tokens: number;
+        total_cost_usd: number;
+        artifact_paths: string[];
+        chain_root_hash: string;
+        pr_url?: string | undefined;
+    };
+}, {
+    run_id: string;
+    event_id: number;
+    ts: string;
+    node_name: string;
+    duration_ms: number;
+    prev_event_hash: string | null;
+    event_hash: string;
+    node_kind: "run_complete";
+    outcome: {
+        status: "ok" | "failed" | "partial";
+        mesh_sha: string;
+        total_input_tokens: number;
+        total_output_tokens: number;
+        total_cost_usd: number;
+        artifact_paths: string[];
+        chain_root_hash: string;
+        pr_url?: string | undefined;
+    };
+}>]>;
+export type AuditEvent = z.infer<typeof AuditEvent>;
+export type PureApiEvent = z.infer<typeof PureApiEvent>;
+export type LlmEvent = z.infer<typeof LlmEvent>;
+export type PureEvent = z.infer<typeof PureEvent>;
+export type NodeErrorEvent = z.infer<typeof NodeErrorEvent>;
+export type IterationSummaryEvent = z.infer<typeof IterationSummaryEvent>;
+export type RunCompleteEvent = z.infer<typeof RunCompleteEvent>;
+export {};