@loomwork/ui-lineage 0.0.0-stage → 0.1.0

package/dist/events.d.ts

@@ -0,0 +1,781 @@
+import { Operation } from "@loomwork/ui-core";
+import { z } from "zod";
+export declare const EXPERIENCE_COMPOSED = "EXPERIENCE_COMPOSED";
+export declare const EXPERIENCE_REVERTED = "EXPERIENCE_REVERTED";
+export declare const EXPERIENCE_BRANCHED = "EXPERIENCE_BRANCHED";
+export declare const EXPERIENCE_PROMOTED = "EXPERIENCE_PROMOTED";
+export type LineageEventType = typeof EXPERIENCE_COMPOSED | typeof EXPERIENCE_REVERTED | typeof EXPERIENCE_BRANCHED | typeof EXPERIENCE_PROMOTED;
+export declare const ComposedPayload: z.ZodObject<{
+    ops: z.ZodArray<z.ZodObject<{
+        op: z.ZodType<Operation, z.ZodTypeDef, Operation>;
+        baseVersion: z.ZodOptional<z.ZodString>;
+        by: z.ZodObject<{
+            source: z.ZodEnum<["user", "agent", "application", "system"]>;
+            agentId: z.ZodOptional<z.ZodString>;
+            modelId: z.ZodOptional<z.ZodString>;
+            ref: z.ZodOptional<z.ZodString>;
+            decisionId: z.ZodOptional<z.ZodString>;
+            policyDecisionId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        }, {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        }>;
+        at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        op: Operation;
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        baseVersion?: string | undefined;
+    }, {
+        at: string;
+        op: Operation;
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        baseVersion?: string | undefined;
+    }>, "many">;
+    /**
+     * What the author said about the change (U7): UNTRUSTED text (a planner's model text), bounded
+     * and stripped by `boundSummary` on the way in AND on the way out of the fold, since the log is
+     * untrusted input. Optional, so every version written before it replays unchanged; it is not in
+     * the content address (nothing here is).
+     */
+    summary: z.ZodOptional<z.ZodString>;
+    /**
+     * The strictest class of everything the author READ to write `summary` (the experience, tool
+     * samples, caller context), stamped by the host at compose. A summary is judged against it (and
+     * against the version's own class floor) before a viewer is shown it. Recorded on the event, not
+     * in the content address. Absent = unknown, and the floor alone gates the summary.
+     */
+    summaryClass: z.ZodOptional<z.ZodEnum<["secret", "sensitive", "internal"]>>;
+    experienceId: z.ZodString;
+    versionHash: z.ZodString;
+    ref: z.ZodObject<{
+        __loomContent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        __loomContent: string;
+    }, {
+        __loomContent: string;
+    }>;
+    parents: z.ZodArray<z.ZodString, "many">;
+    by: z.ZodObject<{
+        source: z.ZodEnum<["user", "agent", "application", "system"]>;
+        agentId: z.ZodOptional<z.ZodString>;
+        modelId: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+        decisionId: z.ZodOptional<z.ZodString>;
+        policyDecisionId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    }, {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    by: {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    };
+    ops: {
+        at: string;
+        op: Operation;
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        baseVersion?: string | undefined;
+    }[];
+    experienceId: string;
+    versionHash: string;
+    ref: {
+        __loomContent: string;
+    };
+    parents: string[];
+    summary?: string | undefined;
+    summaryClass?: "secret" | "sensitive" | "internal" | undefined;
+}, {
+    by: {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    };
+    ops: {
+        at: string;
+        op: Operation;
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        baseVersion?: string | undefined;
+    }[];
+    experienceId: string;
+    versionHash: string;
+    ref: {
+        __loomContent: string;
+    };
+    parents: string[];
+    summary?: string | undefined;
+    summaryClass?: "secret" | "sensitive" | "internal" | undefined;
+}>;
+export declare const RevertedPayload: z.ZodObject<{
+    revertedTo: z.ZodString;
+    experienceId: z.ZodString;
+    versionHash: z.ZodString;
+    ref: z.ZodObject<{
+        __loomContent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        __loomContent: string;
+    }, {
+        __loomContent: string;
+    }>;
+    parents: z.ZodArray<z.ZodString, "many">;
+    by: z.ZodObject<{
+        source: z.ZodEnum<["user", "agent", "application", "system"]>;
+        agentId: z.ZodOptional<z.ZodString>;
+        modelId: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+        decisionId: z.ZodOptional<z.ZodString>;
+        policyDecisionId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    }, {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    by: {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    };
+    experienceId: string;
+    versionHash: string;
+    ref: {
+        __loomContent: string;
+    };
+    parents: string[];
+    revertedTo: string;
+}, {
+    by: {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    };
+    experienceId: string;
+    versionHash: string;
+    ref: {
+        __loomContent: string;
+    };
+    parents: string[];
+    revertedTo: string;
+}>;
+export declare const BranchedPayload: z.ZodObject<{
+    from: z.ZodObject<{
+        experienceId: z.ZodString;
+        versionHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        experienceId: string;
+        versionHash: string;
+    }, {
+        experienceId: string;
+        versionHash: string;
+    }>;
+    /** The version of the SOURCE line whose sticky classes were carried in (its head at the fork). */
+    carriedFrom: z.ZodString;
+    experienceId: z.ZodString;
+    versionHash: z.ZodString;
+    ref: z.ZodObject<{
+        __loomContent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        __loomContent: string;
+    }, {
+        __loomContent: string;
+    }>;
+    parents: z.ZodArray<z.ZodString, "many">;
+    by: z.ZodObject<{
+        source: z.ZodEnum<["user", "agent", "application", "system"]>;
+        agentId: z.ZodOptional<z.ZodString>;
+        modelId: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+        decisionId: z.ZodOptional<z.ZodString>;
+        policyDecisionId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    }, {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    by: {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    };
+    experienceId: string;
+    versionHash: string;
+    ref: {
+        __loomContent: string;
+    };
+    parents: string[];
+    from: {
+        experienceId: string;
+        versionHash: string;
+    };
+    carriedFrom: string;
+}, {
+    by: {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    };
+    experienceId: string;
+    versionHash: string;
+    ref: {
+        __loomContent: string;
+    };
+    parents: string[];
+    from: {
+        experienceId: string;
+        versionHash: string;
+    };
+    carriedFrom: string;
+}>;
+export declare const PromotedPayload: z.ZodObject<{
+    ref: z.ZodObject<{
+        __loomContent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        __loomContent: string;
+    }, {
+        __loomContent: string;
+    }>;
+    experienceId: z.ZodString;
+    versionHash: z.ZodString;
+    by: z.ZodObject<{
+        source: z.ZodEnum<["user", "agent", "application", "system"]>;
+        agentId: z.ZodOptional<z.ZodString>;
+        modelId: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+        decisionId: z.ZodOptional<z.ZodString>;
+        policyDecisionId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    }, {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    by: {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    };
+    experienceId: string;
+    versionHash: string;
+    ref: {
+        __loomContent: string;
+    };
+}, {
+    by: {
+        source: "user" | "system" | "agent" | "application";
+        ref?: string | undefined;
+        agentId?: string | undefined;
+        modelId?: string | undefined;
+        decisionId?: string | undefined;
+        policyDecisionId?: string | undefined;
+    };
+    experienceId: string;
+    versionHash: string;
+    ref: {
+        __loomContent: string;
+    };
+}>;
+export type ComposedPayload = z.infer<typeof ComposedPayload>;
+export type SummaryClass = NonNullable<ComposedPayload["summaryClass"]>;
+export type RevertedPayload = z.infer<typeof RevertedPayload>;
+export type BranchedPayload = z.infer<typeof BranchedPayload>;
+export type PromotedPayload = z.infer<typeof PromotedPayload>;
+export declare const PAYLOAD_SCHEMAS: {
+    readonly EXPERIENCE_COMPOSED: z.ZodObject<{
+        ops: z.ZodArray<z.ZodObject<{
+            op: z.ZodType<Operation, z.ZodTypeDef, Operation>;
+            baseVersion: z.ZodOptional<z.ZodString>;
+            by: z.ZodObject<{
+                source: z.ZodEnum<["user", "agent", "application", "system"]>;
+                agentId: z.ZodOptional<z.ZodString>;
+                modelId: z.ZodOptional<z.ZodString>;
+                ref: z.ZodOptional<z.ZodString>;
+                decisionId: z.ZodOptional<z.ZodString>;
+                policyDecisionId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "user" | "system" | "agent" | "application";
+                ref?: string | undefined;
+                agentId?: string | undefined;
+                modelId?: string | undefined;
+                decisionId?: string | undefined;
+                policyDecisionId?: string | undefined;
+            }, {
+                source: "user" | "system" | "agent" | "application";
+                ref?: string | undefined;
+                agentId?: string | undefined;
+                modelId?: string | undefined;
+                decisionId?: string | undefined;
+                policyDecisionId?: string | undefined;
+            }>;
+            at: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            at: string;
+            op: Operation;
+            by: {
+                source: "user" | "system" | "agent" | "application";
+                ref?: string | undefined;
+                agentId?: string | undefined;
+                modelId?: string | undefined;
+                decisionId?: string | undefined;
+                policyDecisionId?: string | undefined;
+            };
+            baseVersion?: string | undefined;
+        }, {
+            at: string;
+            op: Operation;
+            by: {
+                source: "user" | "system" | "agent" | "application";
+                ref?: string | undefined;
+                agentId?: string | undefined;
+                modelId?: string | undefined;
+                decisionId?: string | undefined;
+                policyDecisionId?: string | undefined;
+            };
+            baseVersion?: string | undefined;
+        }>, "many">;
+        /**
+         * What the author said about the change (U7): UNTRUSTED text (a planner's model text), bounded
+         * and stripped by `boundSummary` on the way in AND on the way out of the fold, since the log is
+         * untrusted input. Optional, so every version written before it replays unchanged; it is not in
+         * the content address (nothing here is).
+         */
+        summary: z.ZodOptional<z.ZodString>;
+        /**
+         * The strictest class of everything the author READ to write `summary` (the experience, tool
+         * samples, caller context), stamped by the host at compose. A summary is judged against it (and
+         * against the version's own class floor) before a viewer is shown it. Recorded on the event, not
+         * in the content address. Absent = unknown, and the floor alone gates the summary.
+         */
+        summaryClass: z.ZodOptional<z.ZodEnum<["secret", "sensitive", "internal"]>>;
+        experienceId: z.ZodString;
+        versionHash: z.ZodString;
+        ref: z.ZodObject<{
+            __loomContent: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            __loomContent: string;
+        }, {
+            __loomContent: string;
+        }>;
+        parents: z.ZodArray<z.ZodString, "many">;
+        by: z.ZodObject<{
+            source: z.ZodEnum<["user", "agent", "application", "system"]>;
+            agentId: z.ZodOptional<z.ZodString>;
+            modelId: z.ZodOptional<z.ZodString>;
+            ref: z.ZodOptional<z.ZodString>;
+            decisionId: z.ZodOptional<z.ZodString>;
+            policyDecisionId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        }, {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        ops: {
+            at: string;
+            op: Operation;
+            by: {
+                source: "user" | "system" | "agent" | "application";
+                ref?: string | undefined;
+                agentId?: string | undefined;
+                modelId?: string | undefined;
+                decisionId?: string | undefined;
+                policyDecisionId?: string | undefined;
+            };
+            baseVersion?: string | undefined;
+        }[];
+        experienceId: string;
+        versionHash: string;
+        ref: {
+            __loomContent: string;
+        };
+        parents: string[];
+        summary?: string | undefined;
+        summaryClass?: "secret" | "sensitive" | "internal" | undefined;
+    }, {
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        ops: {
+            at: string;
+            op: Operation;
+            by: {
+                source: "user" | "system" | "agent" | "application";
+                ref?: string | undefined;
+                agentId?: string | undefined;
+                modelId?: string | undefined;
+                decisionId?: string | undefined;
+                policyDecisionId?: string | undefined;
+            };
+            baseVersion?: string | undefined;
+        }[];
+        experienceId: string;
+        versionHash: string;
+        ref: {
+            __loomContent: string;
+        };
+        parents: string[];
+        summary?: string | undefined;
+        summaryClass?: "secret" | "sensitive" | "internal" | undefined;
+    }>;
+    readonly EXPERIENCE_REVERTED: z.ZodObject<{
+        revertedTo: z.ZodString;
+        experienceId: z.ZodString;
+        versionHash: z.ZodString;
+        ref: z.ZodObject<{
+            __loomContent: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            __loomContent: string;
+        }, {
+            __loomContent: string;
+        }>;
+        parents: z.ZodArray<z.ZodString, "many">;
+        by: z.ZodObject<{
+            source: z.ZodEnum<["user", "agent", "application", "system"]>;
+            agentId: z.ZodOptional<z.ZodString>;
+            modelId: z.ZodOptional<z.ZodString>;
+            ref: z.ZodOptional<z.ZodString>;
+            decisionId: z.ZodOptional<z.ZodString>;
+            policyDecisionId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        }, {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        experienceId: string;
+        versionHash: string;
+        ref: {
+            __loomContent: string;
+        };
+        parents: string[];
+        revertedTo: string;
+    }, {
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        experienceId: string;
+        versionHash: string;
+        ref: {
+            __loomContent: string;
+        };
+        parents: string[];
+        revertedTo: string;
+    }>;
+    readonly EXPERIENCE_BRANCHED: z.ZodObject<{
+        from: z.ZodObject<{
+            experienceId: z.ZodString;
+            versionHash: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            experienceId: string;
+            versionHash: string;
+        }, {
+            experienceId: string;
+            versionHash: string;
+        }>;
+        /** The version of the SOURCE line whose sticky classes were carried in (its head at the fork). */
+        carriedFrom: z.ZodString;
+        experienceId: z.ZodString;
+        versionHash: z.ZodString;
+        ref: z.ZodObject<{
+            __loomContent: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            __loomContent: string;
+        }, {
+            __loomContent: string;
+        }>;
+        parents: z.ZodArray<z.ZodString, "many">;
+        by: z.ZodObject<{
+            source: z.ZodEnum<["user", "agent", "application", "system"]>;
+            agentId: z.ZodOptional<z.ZodString>;
+            modelId: z.ZodOptional<z.ZodString>;
+            ref: z.ZodOptional<z.ZodString>;
+            decisionId: z.ZodOptional<z.ZodString>;
+            policyDecisionId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        }, {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        experienceId: string;
+        versionHash: string;
+        ref: {
+            __loomContent: string;
+        };
+        parents: string[];
+        from: {
+            experienceId: string;
+            versionHash: string;
+        };
+        carriedFrom: string;
+    }, {
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        experienceId: string;
+        versionHash: string;
+        ref: {
+            __loomContent: string;
+        };
+        parents: string[];
+        from: {
+            experienceId: string;
+            versionHash: string;
+        };
+        carriedFrom: string;
+    }>;
+    readonly EXPERIENCE_PROMOTED: z.ZodObject<{
+        ref: z.ZodObject<{
+            __loomContent: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            __loomContent: string;
+        }, {
+            __loomContent: string;
+        }>;
+        experienceId: z.ZodString;
+        versionHash: z.ZodString;
+        by: z.ZodObject<{
+            source: z.ZodEnum<["user", "agent", "application", "system"]>;
+            agentId: z.ZodOptional<z.ZodString>;
+            modelId: z.ZodOptional<z.ZodString>;
+            ref: z.ZodOptional<z.ZodString>;
+            decisionId: z.ZodOptional<z.ZodString>;
+            policyDecisionId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        }, {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        experienceId: string;
+        versionHash: string;
+        ref: {
+            __loomContent: string;
+        };
+    }, {
+        by: {
+            source: "user" | "system" | "agent" | "application";
+            ref?: string | undefined;
+            agentId?: string | undefined;
+            modelId?: string | undefined;
+            decisionId?: string | undefined;
+            policyDecisionId?: string | undefined;
+        };
+        experienceId: string;
+        versionHash: string;
+        ref: {
+            __loomContent: string;
+        };
+    }>;
+};
+export declare const isLineageEventType: (t: string) => t is LineageEventType;
+/**
+ * The payload paths that carry host or model TEXT, per event type: the op props and labels, the
+ * author's `summary` and the `by` provenance (a user's own words and ids). These are what a host
+ * seals under its owner's key so erasing the owner makes the line unreadable
+ * (`registerLineageSensitivePaths`). Everything else on an event is an identifier (`experienceId`,
+ * `versionHash`, `ref`, `parents`, `from`, `carriedFrom`, `revertedTo`) or a class
+ * (`summaryClass`), and stays plain so the log's structure survives the key.
+ *
+ * `ops` is one path: it covers every nested op's `by`, props, labels and prompt text.
+ */
+export declare const LINEAGE_SENSITIVE_PATHS: Readonly<Record<LineageEventType, readonly string[]>>;
+/**
+ * Register {@link LINEAGE_SENSITIVE_PATHS} on a crypto event store (`EncryptingEventStore`'s
+ * `registerSensitive`). Call it once at composition, before the first lineage write: what was
+ * written before stays plaintext.
+ */
+export declare function registerLineageSensitivePaths(store: {
+    registerSensitive(eventType: string, paths: readonly string[]): void;
+}): void;
+//# sourceMappingURL=events.d.ts.map