@exaudeus/workrail 0.8.5 → 0.9.0

package/dist/v2/durable-core/schemas/session/events.d.ts

@@ -0,0 +1,1812 @@
+import { z } from 'zod';
+export declare const DomainEventEnvelopeV1Schema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    kind: z.ZodString;
+    dedupeKey: z.ZodString;
+    scope: z.ZodOptional<z.ZodObject<{
+        runId: z.ZodOptional<z.ZodString>;
+        nodeId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+    }, {
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+    }>>;
+    data: z.ZodType<unknown, z.ZodTypeDef, unknown>;
+}, "strip", z.ZodTypeAny, {
+    kind: string;
+    sessionId: string;
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    data?: unknown;
+    scope?: {
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+    } | undefined;
+}, {
+    kind: string;
+    sessionId: string;
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    data?: unknown;
+    scope?: {
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+    } | undefined;
+}>;
+export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+    scope: z.ZodOptional<z.ZodObject<{
+        runId: z.ZodOptional<z.ZodString>;
+        nodeId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+    }, {
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+    }>>;
+} & {
+    kind: z.ZodLiteral<"session_created">;
+    data: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+}, "strip", z.ZodTypeAny, {
+    kind: "session_created";
+    sessionId: string;
+    data: {};
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope?: {
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+    } | undefined;
+}, {
+    kind: "session_created";
+    sessionId: string;
+    data: {};
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope?: {
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"observation_recorded">;
+    scope: z.ZodUndefined;
+    data: z.ZodObject<{
+        key: z.ZodEnum<["git_branch", "git_head_sha", "repo_root_hash"]>;
+        value: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"short_string">;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            type: "short_string";
+        }, {
+            value: string;
+            type: "short_string";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"git_sha1">;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            type: "git_sha1";
+        }, {
+            value: string;
+            type: "git_sha1";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"sha256">;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            type: "sha256";
+        }, {
+            value: string;
+            type: "sha256";
+        }>]>;
+        confidence: z.ZodEnum<["low", "med", "high"]>;
+    }, "strip", z.ZodTypeAny, {
+        value: {
+            value: string;
+            type: "short_string";
+        } | {
+            value: string;
+            type: "git_sha1";
+        } | {
+            value: string;
+            type: "sha256";
+        };
+        key: "git_branch" | "git_head_sha" | "repo_root_hash";
+        confidence: "high" | "low" | "med";
+    }, {
+        value: {
+            value: string;
+            type: "short_string";
+        } | {
+            value: string;
+            type: "git_sha1";
+        } | {
+            value: string;
+            type: "sha256";
+        };
+        key: "git_branch" | "git_head_sha" | "repo_root_hash";
+        confidence: "high" | "low" | "med";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "observation_recorded";
+    sessionId: string;
+    data: {
+        value: {
+            value: string;
+            type: "short_string";
+        } | {
+            value: string;
+            type: "git_sha1";
+        } | {
+            value: string;
+            type: "sha256";
+        };
+        key: "git_branch" | "git_head_sha" | "repo_root_hash";
+        confidence: "high" | "low" | "med";
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope?: undefined;
+}, {
+    kind: "observation_recorded";
+    sessionId: string;
+    data: {
+        value: {
+            value: string;
+            type: "short_string";
+        } | {
+            value: string;
+            type: "git_sha1";
+        } | {
+            value: string;
+            type: "sha256";
+        };
+        key: "git_branch" | "git_head_sha" | "repo_root_hash";
+        confidence: "high" | "low" | "med";
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope?: undefined;
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"run_started">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+    }, {
+        runId: string;
+    }>;
+    data: z.ZodObject<{
+        workflowId: z.ZodString;
+        workflowHash: z.ZodString;
+        workflowSourceKind: z.ZodEnum<["bundled", "user", "project", "remote", "plugin"]>;
+        workflowSourceRef: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        workflowId: string;
+        workflowHash: string;
+        workflowSourceKind: "bundled" | "user" | "project" | "remote" | "plugin";
+        workflowSourceRef: string;
+    }, {
+        workflowId: string;
+        workflowHash: string;
+        workflowSourceKind: "bundled" | "user" | "project" | "remote" | "plugin";
+        workflowSourceRef: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "run_started";
+    sessionId: string;
+    data: {
+        workflowId: string;
+        workflowHash: string;
+        workflowSourceKind: "bundled" | "user" | "project" | "remote" | "plugin";
+        workflowSourceRef: string;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+    };
+}, {
+    kind: "run_started";
+    sessionId: string;
+    data: {
+        workflowId: string;
+        workflowHash: string;
+        workflowSourceKind: "bundled" | "user" | "project" | "remote" | "plugin";
+        workflowSourceRef: string;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+    };
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"node_created">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+        nodeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        nodeId: string;
+    }, {
+        runId: string;
+        nodeId: string;
+    }>;
+    data: z.ZodObject<{
+        nodeKind: z.ZodEnum<["step", "checkpoint"]>;
+        parentNodeId: z.ZodNullable<z.ZodString>;
+        workflowHash: z.ZodString;
+        snapshotRef: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        workflowHash: string;
+        nodeKind: "step" | "checkpoint";
+        parentNodeId: string | null;
+        snapshotRef: string;
+    }, {
+        workflowHash: string;
+        nodeKind: "step" | "checkpoint";
+        parentNodeId: string | null;
+        snapshotRef: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "node_created";
+    sessionId: string;
+    data: {
+        workflowHash: string;
+        nodeKind: "step" | "checkpoint";
+        parentNodeId: string | null;
+        snapshotRef: string;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}, {
+    kind: "node_created";
+    sessionId: string;
+    data: {
+        workflowHash: string;
+        nodeKind: "step" | "checkpoint";
+        parentNodeId: string | null;
+        snapshotRef: string;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"edge_created">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+    }, {
+        runId: string;
+    }>;
+    data: z.ZodEffects<z.ZodObject<{
+        edgeKind: z.ZodEnum<["acked_step", "checkpoint"]>;
+        fromNodeId: z.ZodString;
+        toNodeId: z.ZodString;
+        cause: z.ZodObject<{
+            kind: z.ZodEnum<["idempotent_replay", "intentional_fork", "non_tip_advance", "checkpoint_created"]>;
+            eventId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "idempotent_replay" | "intentional_fork" | "non_tip_advance" | "checkpoint_created";
+            eventId: string;
+        }, {
+            kind: "idempotent_replay" | "intentional_fork" | "non_tip_advance" | "checkpoint_created";
+            eventId: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        cause: {
+            kind: "idempotent_replay" | "intentional_fork" | "non_tip_advance" | "checkpoint_created";
+            eventId: string;
+        };
+        edgeKind: "checkpoint" | "acked_step";
+        fromNodeId: string;
+        toNodeId: string;
+    }, {
+        cause: {
+            kind: "idempotent_replay" | "intentional_fork" | "non_tip_advance" | "checkpoint_created";
+            eventId: string;
+        };
+        edgeKind: "checkpoint" | "acked_step";
+        fromNodeId: string;
+        toNodeId: string;
+    }>, {
+        cause: {
+            kind: "idempotent_replay" | "intentional_fork" | "non_tip_advance" | "checkpoint_created";
+            eventId: string;
+        };
+        edgeKind: "checkpoint" | "acked_step";
+        fromNodeId: string;
+        toNodeId: string;
+    }, {
+        cause: {
+            kind: "idempotent_replay" | "intentional_fork" | "non_tip_advance" | "checkpoint_created";
+            eventId: string;
+        };
+        edgeKind: "checkpoint" | "acked_step";
+        fromNodeId: string;
+        toNodeId: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "edge_created";
+    sessionId: string;
+    data: {
+        cause: {
+            kind: "idempotent_replay" | "intentional_fork" | "non_tip_advance" | "checkpoint_created";
+            eventId: string;
+        };
+        edgeKind: "checkpoint" | "acked_step";
+        fromNodeId: string;
+        toNodeId: string;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+    };
+}, {
+    kind: "edge_created";
+    sessionId: string;
+    data: {
+        cause: {
+            kind: "idempotent_replay" | "intentional_fork" | "non_tip_advance" | "checkpoint_created";
+            eventId: string;
+        };
+        edgeKind: "checkpoint" | "acked_step";
+        fromNodeId: string;
+        toNodeId: string;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+    };
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"advance_recorded">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+        nodeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        nodeId: string;
+    }, {
+        runId: string;
+        nodeId: string;
+    }>;
+    data: z.ZodObject<{
+        attemptId: z.ZodString;
+        intent: z.ZodLiteral<"ack_pending">;
+        outcome: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"blocked">;
+            blockers: z.ZodEffects<z.ZodObject<{
+                blockers: z.ZodArray<z.ZodObject<{
+                    code: z.ZodEnum<["USER_ONLY_DEPENDENCY", "MISSING_REQUIRED_OUTPUT", "INVALID_REQUIRED_OUTPUT", "REQUIRED_CAPABILITY_UNKNOWN", "REQUIRED_CAPABILITY_UNAVAILABLE", "INVARIANT_VIOLATION", "STORAGE_CORRUPTION_DETECTED"]>;
+                    pointer: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                        kind: z.ZodLiteral<"context_key">;
+                        key: z.ZodString;
+                    }, "strip", z.ZodTypeAny, {
+                        key: string;
+                        kind: "context_key";
+                    }, {
+                        key: string;
+                        kind: "context_key";
+                    }>, z.ZodObject<{
+                        kind: z.ZodLiteral<"output_contract">;
+                        contractRef: z.ZodString;
+                    }, "strip", z.ZodTypeAny, {
+                        kind: "output_contract";
+                        contractRef: string;
+                    }, {
+                        kind: "output_contract";
+                        contractRef: string;
+                    }>, z.ZodObject<{
+                        kind: z.ZodLiteral<"capability">;
+                        capability: z.ZodEnum<["delegation", "web_browsing"]>;
+                    }, "strip", z.ZodTypeAny, {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    }, {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    }>, z.ZodObject<{
+                        kind: z.ZodLiteral<"workflow_step">;
+                        stepId: z.ZodString;
+                    }, "strip", z.ZodTypeAny, {
+                        kind: "workflow_step";
+                        stepId: string;
+                    }, {
+                        kind: "workflow_step";
+                        stepId: string;
+                    }>]>;
+                    message: z.ZodString;
+                    suggestedFix: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }, {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                blockers: {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }[];
+            }, {
+                blockers: {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }[];
+            }>, {
+                blockers: {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }[];
+            }, {
+                blockers: {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }[];
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "blocked";
+            blockers: {
+                blockers: {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }[];
+            };
+        }, {
+            kind: "blocked";
+            blockers: {
+                blockers: {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }[];
+            };
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"advanced">;
+            toNodeId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "advanced";
+            toNodeId: string;
+        }, {
+            kind: "advanced";
+            toNodeId: string;
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        attemptId: string;
+        intent: "ack_pending";
+        outcome: {
+            kind: "blocked";
+            blockers: {
+                blockers: {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }[];
+            };
+        } | {
+            kind: "advanced";
+            toNodeId: string;
+        };
+    }, {
+        attemptId: string;
+        intent: "ack_pending";
+        outcome: {
+            kind: "blocked";
+            blockers: {
+                blockers: {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }[];
+            };
+        } | {
+            kind: "advanced";
+            toNodeId: string;
+        };
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "advance_recorded";
+    sessionId: string;
+    data: {
+        attemptId: string;
+        intent: "ack_pending";
+        outcome: {
+            kind: "blocked";
+            blockers: {
+                blockers: {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }[];
+            };
+        } | {
+            kind: "advanced";
+            toNodeId: string;
+        };
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}, {
+    kind: "advance_recorded";
+    sessionId: string;
+    data: {
+        attemptId: string;
+        intent: "ack_pending";
+        outcome: {
+            kind: "blocked";
+            blockers: {
+                blockers: {
+                    message: string;
+                    code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+                    pointer: {
+                        key: string;
+                        kind: "context_key";
+                    } | {
+                        kind: "output_contract";
+                        contractRef: string;
+                    } | {
+                        kind: "capability";
+                        capability: "delegation" | "web_browsing";
+                    } | {
+                        kind: "workflow_step";
+                        stepId: string;
+                    };
+                    suggestedFix?: string | undefined;
+                }[];
+            };
+        } | {
+            kind: "advanced";
+            toNodeId: string;
+        };
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"node_output_appended">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+        nodeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        nodeId: string;
+    }, {
+        runId: string;
+        nodeId: string;
+    }>;
+    data: z.ZodEffects<z.ZodObject<{
+        outputId: z.ZodString;
+        supersedesOutputId: z.ZodOptional<z.ZodString>;
+        outputChannel: z.ZodEnum<["recap", "artifact"]>;
+        payload: z.ZodDiscriminatedUnion<"payloadKind", [z.ZodObject<{
+            payloadKind: z.ZodLiteral<"notes">;
+            notesMarkdown: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            payloadKind: "notes";
+            notesMarkdown: string;
+        }, {
+            payloadKind: "notes";
+            notesMarkdown: string;
+        }>, z.ZodObject<{
+            payloadKind: z.ZodLiteral<"artifact_ref">;
+            sha256: z.ZodString;
+            contentType: z.ZodString;
+            byteLength: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            sha256: string;
+            payloadKind: "artifact_ref";
+            contentType: string;
+            byteLength: number;
+        }, {
+            sha256: string;
+            payloadKind: "artifact_ref";
+            contentType: string;
+            byteLength: number;
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        outputId: string;
+        outputChannel: "recap" | "artifact";
+        payload: {
+            payloadKind: "notes";
+            notesMarkdown: string;
+        } | {
+            sha256: string;
+            payloadKind: "artifact_ref";
+            contentType: string;
+            byteLength: number;
+        };
+        supersedesOutputId?: string | undefined;
+    }, {
+        outputId: string;
+        outputChannel: "recap" | "artifact";
+        payload: {
+            payloadKind: "notes";
+            notesMarkdown: string;
+        } | {
+            sha256: string;
+            payloadKind: "artifact_ref";
+            contentType: string;
+            byteLength: number;
+        };
+        supersedesOutputId?: string | undefined;
+    }>, {
+        outputId: string;
+        outputChannel: "recap" | "artifact";
+        payload: {
+            payloadKind: "notes";
+            notesMarkdown: string;
+        } | {
+            sha256: string;
+            payloadKind: "artifact_ref";
+            contentType: string;
+            byteLength: number;
+        };
+        supersedesOutputId?: string | undefined;
+    }, {
+        outputId: string;
+        outputChannel: "recap" | "artifact";
+        payload: {
+            payloadKind: "notes";
+            notesMarkdown: string;
+        } | {
+            sha256: string;
+            payloadKind: "artifact_ref";
+            contentType: string;
+            byteLength: number;
+        };
+        supersedesOutputId?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "node_output_appended";
+    sessionId: string;
+    data: {
+        outputId: string;
+        outputChannel: "recap" | "artifact";
+        payload: {
+            payloadKind: "notes";
+            notesMarkdown: string;
+        } | {
+            sha256: string;
+            payloadKind: "artifact_ref";
+            contentType: string;
+            byteLength: number;
+        };
+        supersedesOutputId?: string | undefined;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}, {
+    kind: "node_output_appended";
+    sessionId: string;
+    data: {
+        outputId: string;
+        outputChannel: "recap" | "artifact";
+        payload: {
+            payloadKind: "notes";
+            notesMarkdown: string;
+        } | {
+            sha256: string;
+            payloadKind: "artifact_ref";
+            contentType: string;
+            byteLength: number;
+        };
+        supersedesOutputId?: string | undefined;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"preferences_changed">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+        nodeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        nodeId: string;
+    }, {
+        runId: string;
+        nodeId: string;
+    }>;
+    data: z.ZodEffects<z.ZodObject<{
+        changeId: z.ZodString;
+        source: z.ZodEnum<["user", "workflow_recommendation", "system"]>;
+        delta: z.ZodArray<z.ZodDiscriminatedUnion<"key", [z.ZodObject<{
+            key: z.ZodLiteral<"autonomy">;
+            value: z.ZodEnum<["guided", "full_auto_stop_on_user_deps", "full_auto_never_stop"]>;
+        }, "strip", z.ZodTypeAny, {
+            value: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            key: "autonomy";
+        }, {
+            value: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            key: "autonomy";
+        }>, z.ZodObject<{
+            key: z.ZodLiteral<"riskPolicy">;
+            value: z.ZodEnum<["conservative", "balanced", "aggressive"]>;
+        }, "strip", z.ZodTypeAny, {
+            value: "conservative" | "balanced" | "aggressive";
+            key: "riskPolicy";
+        }, {
+            value: "conservative" | "balanced" | "aggressive";
+            key: "riskPolicy";
+        }>]>, "many">;
+        effective: z.ZodObject<{
+            autonomy: z.ZodEnum<["guided", "full_auto_stop_on_user_deps", "full_auto_never_stop"]>;
+            riskPolicy: z.ZodEnum<["conservative", "balanced", "aggressive"]>;
+        }, "strip", z.ZodTypeAny, {
+            autonomy: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            riskPolicy: "conservative" | "balanced" | "aggressive";
+        }, {
+            autonomy: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            riskPolicy: "conservative" | "balanced" | "aggressive";
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        source: "user" | "workflow_recommendation" | "system";
+        changeId: string;
+        delta: ({
+            value: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            key: "autonomy";
+        } | {
+            value: "conservative" | "balanced" | "aggressive";
+            key: "riskPolicy";
+        })[];
+        effective: {
+            autonomy: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            riskPolicy: "conservative" | "balanced" | "aggressive";
+        };
+    }, {
+        source: "user" | "workflow_recommendation" | "system";
+        changeId: string;
+        delta: ({
+            value: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            key: "autonomy";
+        } | {
+            value: "conservative" | "balanced" | "aggressive";
+            key: "riskPolicy";
+        })[];
+        effective: {
+            autonomy: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            riskPolicy: "conservative" | "balanced" | "aggressive";
+        };
+    }>, {
+        source: "user" | "workflow_recommendation" | "system";
+        changeId: string;
+        delta: ({
+            value: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            key: "autonomy";
+        } | {
+            value: "conservative" | "balanced" | "aggressive";
+            key: "riskPolicy";
+        })[];
+        effective: {
+            autonomy: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            riskPolicy: "conservative" | "balanced" | "aggressive";
+        };
+    }, {
+        source: "user" | "workflow_recommendation" | "system";
+        changeId: string;
+        delta: ({
+            value: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            key: "autonomy";
+        } | {
+            value: "conservative" | "balanced" | "aggressive";
+            key: "riskPolicy";
+        })[];
+        effective: {
+            autonomy: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            riskPolicy: "conservative" | "balanced" | "aggressive";
+        };
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "preferences_changed";
+    sessionId: string;
+    data: {
+        source: "user" | "workflow_recommendation" | "system";
+        changeId: string;
+        delta: ({
+            value: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            key: "autonomy";
+        } | {
+            value: "conservative" | "balanced" | "aggressive";
+            key: "riskPolicy";
+        })[];
+        effective: {
+            autonomy: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            riskPolicy: "conservative" | "balanced" | "aggressive";
+        };
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}, {
+    kind: "preferences_changed";
+    sessionId: string;
+    data: {
+        source: "user" | "workflow_recommendation" | "system";
+        changeId: string;
+        delta: ({
+            value: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            key: "autonomy";
+        } | {
+            value: "conservative" | "balanced" | "aggressive";
+            key: "riskPolicy";
+        })[];
+        effective: {
+            autonomy: "guided" | "full_auto_stop_on_user_deps" | "full_auto_never_stop";
+            riskPolicy: "conservative" | "balanced" | "aggressive";
+        };
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"capability_observed">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+        nodeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        nodeId: string;
+    }, {
+        runId: string;
+        nodeId: string;
+    }>;
+    data: z.ZodEffects<z.ZodObject<{
+        capObsId: z.ZodString;
+        capability: z.ZodEnum<["delegation", "web_browsing"]>;
+        status: z.ZodEnum<["unknown", "available", "unavailable"]>;
+        provenance: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"probe_step">;
+            enforcementGrade: z.ZodLiteral<"strong">;
+            detail: z.ZodObject<{
+                probeTemplateId: z.ZodString;
+                probeStepId: z.ZodString;
+                result: z.ZodEnum<["success", "failure"]>;
+            }, "strip", z.ZodTypeAny, {
+                result: "success" | "failure";
+                probeTemplateId: string;
+                probeStepId: string;
+            }, {
+                result: "success" | "failure";
+                probeTemplateId: string;
+                probeStepId: string;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "probe_step";
+            detail: {
+                result: "success" | "failure";
+                probeTemplateId: string;
+                probeStepId: string;
+            };
+            enforcementGrade: "strong";
+        }, {
+            kind: "probe_step";
+            detail: {
+                result: "success" | "failure";
+                probeTemplateId: string;
+                probeStepId: string;
+            };
+            enforcementGrade: "strong";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"attempted_use">;
+            enforcementGrade: z.ZodLiteral<"strong">;
+            detail: z.ZodObject<{
+                attemptContext: z.ZodEnum<["workflow_step", "system_probe"]>;
+                result: z.ZodEnum<["success", "failure"]>;
+                failureCode: z.ZodOptional<z.ZodEnum<["tool_missing", "tool_error", "policy_blocked", "unknown"]>>;
+            }, "strip", z.ZodTypeAny, {
+                result: "success" | "failure";
+                attemptContext: "workflow_step" | "system_probe";
+                failureCode?: "unknown" | "tool_missing" | "tool_error" | "policy_blocked" | undefined;
+            }, {
+                result: "success" | "failure";
+                attemptContext: "workflow_step" | "system_probe";
+                failureCode?: "unknown" | "tool_missing" | "tool_error" | "policy_blocked" | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "attempted_use";
+            detail: {
+                result: "success" | "failure";
+                attemptContext: "workflow_step" | "system_probe";
+                failureCode?: "unknown" | "tool_missing" | "tool_error" | "policy_blocked" | undefined;
+            };
+            enforcementGrade: "strong";
+        }, {
+            kind: "attempted_use";
+            detail: {
+                result: "success" | "failure";
+                attemptContext: "workflow_step" | "system_probe";
+                failureCode?: "unknown" | "tool_missing" | "tool_error" | "policy_blocked" | undefined;
+            };
+            enforcementGrade: "strong";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"manual_claim">;
+            enforcementGrade: z.ZodLiteral<"weak">;
+            detail: z.ZodObject<{
+                claimedBy: z.ZodEnum<["agent", "user"]>;
+                claim: z.ZodEnum<["available", "unavailable"]>;
+            }, "strip", z.ZodTypeAny, {
+                claimedBy: "user" | "agent";
+                claim: "available" | "unavailable";
+            }, {
+                claimedBy: "user" | "agent";
+                claim: "available" | "unavailable";
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "manual_claim";
+            detail: {
+                claimedBy: "user" | "agent";
+                claim: "available" | "unavailable";
+            };
+            enforcementGrade: "weak";
+        }, {
+            kind: "manual_claim";
+            detail: {
+                claimedBy: "user" | "agent";
+                claim: "available" | "unavailable";
+            };
+            enforcementGrade: "weak";
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        status: "unknown" | "available" | "unavailable";
+        capability: "delegation" | "web_browsing";
+        capObsId: string;
+        provenance: {
+            kind: "probe_step";
+            detail: {
+                result: "success" | "failure";
+                probeTemplateId: string;
+                probeStepId: string;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "attempted_use";
+            detail: {
+                result: "success" | "failure";
+                attemptContext: "workflow_step" | "system_probe";
+                failureCode?: "unknown" | "tool_missing" | "tool_error" | "policy_blocked" | undefined;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "manual_claim";
+            detail: {
+                claimedBy: "user" | "agent";
+                claim: "available" | "unavailable";
+            };
+            enforcementGrade: "weak";
+        };
+    }, {
+        status: "unknown" | "available" | "unavailable";
+        capability: "delegation" | "web_browsing";
+        capObsId: string;
+        provenance: {
+            kind: "probe_step";
+            detail: {
+                result: "success" | "failure";
+                probeTemplateId: string;
+                probeStepId: string;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "attempted_use";
+            detail: {
+                result: "success" | "failure";
+                attemptContext: "workflow_step" | "system_probe";
+                failureCode?: "unknown" | "tool_missing" | "tool_error" | "policy_blocked" | undefined;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "manual_claim";
+            detail: {
+                claimedBy: "user" | "agent";
+                claim: "available" | "unavailable";
+            };
+            enforcementGrade: "weak";
+        };
+    }>, {
+        status: "unknown" | "available" | "unavailable";
+        capability: "delegation" | "web_browsing";
+        capObsId: string;
+        provenance: {
+            kind: "probe_step";
+            detail: {
+                result: "success" | "failure";
+                probeTemplateId: string;
+                probeStepId: string;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "attempted_use";
+            detail: {
+                result: "success" | "failure";
+                attemptContext: "workflow_step" | "system_probe";
+                failureCode?: "unknown" | "tool_missing" | "tool_error" | "policy_blocked" | undefined;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "manual_claim";
+            detail: {
+                claimedBy: "user" | "agent";
+                claim: "available" | "unavailable";
+            };
+            enforcementGrade: "weak";
+        };
+    }, {
+        status: "unknown" | "available" | "unavailable";
+        capability: "delegation" | "web_browsing";
+        capObsId: string;
+        provenance: {
+            kind: "probe_step";
+            detail: {
+                result: "success" | "failure";
+                probeTemplateId: string;
+                probeStepId: string;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "attempted_use";
+            detail: {
+                result: "success" | "failure";
+                attemptContext: "workflow_step" | "system_probe";
+                failureCode?: "unknown" | "tool_missing" | "tool_error" | "policy_blocked" | undefined;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "manual_claim";
+            detail: {
+                claimedBy: "user" | "agent";
+                claim: "available" | "unavailable";
+            };
+            enforcementGrade: "weak";
+        };
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "capability_observed";
+    sessionId: string;
+    data: {
+        status: "unknown" | "available" | "unavailable";
+        capability: "delegation" | "web_browsing";
+        capObsId: string;
+        provenance: {
+            kind: "probe_step";
+            detail: {
+                result: "success" | "failure";
+                probeTemplateId: string;
+                probeStepId: string;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "attempted_use";
+            detail: {
+                result: "success" | "failure";
+                attemptContext: "workflow_step" | "system_probe";
+                failureCode?: "unknown" | "tool_missing" | "tool_error" | "policy_blocked" | undefined;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "manual_claim";
+            detail: {
+                claimedBy: "user" | "agent";
+                claim: "available" | "unavailable";
+            };
+            enforcementGrade: "weak";
+        };
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}, {
+    kind: "capability_observed";
+    sessionId: string;
+    data: {
+        status: "unknown" | "available" | "unavailable";
+        capability: "delegation" | "web_browsing";
+        capObsId: string;
+        provenance: {
+            kind: "probe_step";
+            detail: {
+                result: "success" | "failure";
+                probeTemplateId: string;
+                probeStepId: string;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "attempted_use";
+            detail: {
+                result: "success" | "failure";
+                attemptContext: "workflow_step" | "system_probe";
+                failureCode?: "unknown" | "tool_missing" | "tool_error" | "policy_blocked" | undefined;
+            };
+            enforcementGrade: "strong";
+        } | {
+            kind: "manual_claim";
+            detail: {
+                claimedBy: "user" | "agent";
+                claim: "available" | "unavailable";
+            };
+            enforcementGrade: "weak";
+        };
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"gap_recorded">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+        nodeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        nodeId: string;
+    }, {
+        runId: string;
+        nodeId: string;
+    }>;
+    data: z.ZodObject<{
+        gapId: z.ZodString;
+        severity: z.ZodEnum<["info", "warning", "critical"]>;
+        reason: z.ZodDiscriminatedUnion<"category", [z.ZodObject<{
+            category: z.ZodLiteral<"user_only_dependency">;
+            detail: z.ZodEnum<["needs_user_secret_or_token", "needs_user_account_access", "needs_user_artifact", "needs_user_choice", "needs_user_approval", "needs_user_environment_action"]>;
+        }, "strip", z.ZodTypeAny, {
+            category: "user_only_dependency";
+            detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
+        }, {
+            category: "user_only_dependency";
+            detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
+        }>, z.ZodObject<{
+            category: z.ZodLiteral<"contract_violation">;
+            detail: z.ZodEnum<["missing_required_output", "invalid_required_output"]>;
+        }, "strip", z.ZodTypeAny, {
+            category: "contract_violation";
+            detail: "missing_required_output" | "invalid_required_output";
+        }, {
+            category: "contract_violation";
+            detail: "missing_required_output" | "invalid_required_output";
+        }>, z.ZodObject<{
+            category: z.ZodLiteral<"capability_missing">;
+            detail: z.ZodEnum<["required_capability_unavailable", "required_capability_unknown"]>;
+        }, "strip", z.ZodTypeAny, {
+            category: "capability_missing";
+            detail: "required_capability_unavailable" | "required_capability_unknown";
+        }, {
+            category: "capability_missing";
+            detail: "required_capability_unavailable" | "required_capability_unknown";
+        }>, z.ZodObject<{
+            category: z.ZodLiteral<"unexpected">;
+            detail: z.ZodEnum<["invariant_violation", "storage_corruption_detected"]>;
+        }, "strip", z.ZodTypeAny, {
+            category: "unexpected";
+            detail: "invariant_violation" | "storage_corruption_detected";
+        }, {
+            category: "unexpected";
+            detail: "invariant_violation" | "storage_corruption_detected";
+        }>]>;
+        summary: z.ZodString;
+        resolution: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"unresolved">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "unresolved";
+        }, {
+            kind: "unresolved";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"resolves">;
+            resolvesGapId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "resolves";
+            resolvesGapId: string;
+        }, {
+            kind: "resolves";
+            resolvesGapId: string;
+        }>]>;
+        evidenceRefs: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"event">;
+            eventId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "event";
+            eventId: string;
+        }, {
+            kind: "event";
+            eventId: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"output">;
+            outputId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "output";
+            outputId: string;
+        }, {
+            kind: "output";
+            outputId: string;
+        }>]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        reason: {
+            category: "user_only_dependency";
+            detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
+        } | {
+            category: "contract_violation";
+            detail: "missing_required_output" | "invalid_required_output";
+        } | {
+            category: "capability_missing";
+            detail: "required_capability_unavailable" | "required_capability_unknown";
+        } | {
+            category: "unexpected";
+            detail: "invariant_violation" | "storage_corruption_detected";
+        };
+        severity: "warning" | "info" | "critical";
+        summary: string;
+        gapId: string;
+        resolution: {
+            kind: "unresolved";
+        } | {
+            kind: "resolves";
+            resolvesGapId: string;
+        };
+        evidenceRefs?: ({
+            kind: "event";
+            eventId: string;
+        } | {
+            kind: "output";
+            outputId: string;
+        })[] | undefined;
+    }, {
+        reason: {
+            category: "user_only_dependency";
+            detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
+        } | {
+            category: "contract_violation";
+            detail: "missing_required_output" | "invalid_required_output";
+        } | {
+            category: "capability_missing";
+            detail: "required_capability_unavailable" | "required_capability_unknown";
+        } | {
+            category: "unexpected";
+            detail: "invariant_violation" | "storage_corruption_detected";
+        };
+        severity: "warning" | "info" | "critical";
+        summary: string;
+        gapId: string;
+        resolution: {
+            kind: "unresolved";
+        } | {
+            kind: "resolves";
+            resolvesGapId: string;
+        };
+        evidenceRefs?: ({
+            kind: "event";
+            eventId: string;
+        } | {
+            kind: "output";
+            outputId: string;
+        })[] | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "gap_recorded";
+    sessionId: string;
+    data: {
+        reason: {
+            category: "user_only_dependency";
+            detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
+        } | {
+            category: "contract_violation";
+            detail: "missing_required_output" | "invalid_required_output";
+        } | {
+            category: "capability_missing";
+            detail: "required_capability_unavailable" | "required_capability_unknown";
+        } | {
+            category: "unexpected";
+            detail: "invariant_violation" | "storage_corruption_detected";
+        };
+        severity: "warning" | "info" | "critical";
+        summary: string;
+        gapId: string;
+        resolution: {
+            kind: "unresolved";
+        } | {
+            kind: "resolves";
+            resolvesGapId: string;
+        };
+        evidenceRefs?: ({
+            kind: "event";
+            eventId: string;
+        } | {
+            kind: "output";
+            outputId: string;
+        })[] | undefined;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}, {
+    kind: "gap_recorded";
+    sessionId: string;
+    data: {
+        reason: {
+            category: "user_only_dependency";
+            detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
+        } | {
+            category: "contract_violation";
+            detail: "missing_required_output" | "invalid_required_output";
+        } | {
+            category: "capability_missing";
+            detail: "required_capability_unavailable" | "required_capability_unknown";
+        } | {
+            category: "unexpected";
+            detail: "invariant_violation" | "storage_corruption_detected";
+        };
+        severity: "warning" | "info" | "critical";
+        summary: string;
+        gapId: string;
+        resolution: {
+            kind: "unresolved";
+        } | {
+            kind: "resolves";
+            resolvesGapId: string;
+        };
+        evidenceRefs?: ({
+            kind: "event";
+            eventId: string;
+        } | {
+            kind: "output";
+            outputId: string;
+        })[] | undefined;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"divergence_recorded">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+        nodeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        nodeId: string;
+    }, {
+        runId: string;
+        nodeId: string;
+    }>;
+    data: z.ZodObject<{
+        divergenceId: z.ZodString;
+        reason: z.ZodEnum<["missing_user_context", "capability_unavailable", "efficiency_skip", "safety_stop", "policy_constraint"]>;
+        summary: z.ZodString;
+        relatedStepId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
+        summary: string;
+        divergenceId: string;
+        relatedStepId?: string | undefined;
+    }, {
+        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
+        summary: string;
+        divergenceId: string;
+        relatedStepId?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "divergence_recorded";
+    sessionId: string;
+    data: {
+        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
+        summary: string;
+        divergenceId: string;
+        relatedStepId?: string | undefined;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}, {
+    kind: "divergence_recorded";
+    sessionId: string;
+    data: {
+        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
+        summary: string;
+        divergenceId: string;
+        relatedStepId?: string | undefined;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"decision_trace_appended">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+        nodeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        nodeId: string;
+    }, {
+        runId: string;
+        nodeId: string;
+    }>;
+    data: z.ZodObject<{
+        traceId: z.ZodString;
+        entries: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["selected_next_step", "evaluated_condition", "entered_loop", "exited_loop", "detected_non_tip_advance"]>;
+            summary: z.ZodString;
+            refs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "selected_next_step" | "evaluated_condition" | "entered_loop" | "exited_loop" | "detected_non_tip_advance";
+            summary: string;
+            refs?: Record<string, unknown> | undefined;
+        }, {
+            kind: "selected_next_step" | "evaluated_condition" | "entered_loop" | "exited_loop" | "detected_non_tip_advance";
+            summary: string;
+            refs?: Record<string, unknown> | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        entries: {
+            kind: "selected_next_step" | "evaluated_condition" | "entered_loop" | "exited_loop" | "detected_non_tip_advance";
+            summary: string;
+            refs?: Record<string, unknown> | undefined;
+        }[];
+        traceId: string;
+    }, {
+        entries: {
+            kind: "selected_next_step" | "evaluated_condition" | "entered_loop" | "exited_loop" | "detected_non_tip_advance";
+            summary: string;
+            refs?: Record<string, unknown> | undefined;
+        }[];
+        traceId: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "decision_trace_appended";
+    sessionId: string;
+    data: {
+        entries: {
+            kind: "selected_next_step" | "evaluated_condition" | "entered_loop" | "exited_loop" | "detected_non_tip_advance";
+            summary: string;
+            refs?: Record<string, unknown> | undefined;
+        }[];
+        traceId: string;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}, {
+    kind: "decision_trace_appended";
+    sessionId: string;
+    data: {
+        entries: {
+            kind: "selected_next_step" | "evaluated_condition" | "entered_loop" | "exited_loop" | "detected_non_tip_advance";
+            summary: string;
+            refs?: Record<string, unknown> | undefined;
+        }[];
+        traceId: string;
+    };
+    v: 1;
+    eventId: string;
+    eventIndex: number;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}>]>;
+export type DomainEventV1 = z.infer<typeof DomainEventV1Schema>;