@lore-co/core 0.1.17 → 0.1.19

package/dist/guard-schemas.d.ts

@@ -133,6 +133,46 @@ export declare const GuardItemSchema: z.ZodObject<{
         createdAt: z.ZodISODateTime;
     }, z.core.$strict>;
     reasons: z.ZodArray<z.ZodString>;
+    explanation: z.ZodOptional<z.ZodObject<{
+        contractVersion: z.ZodLiteral<"explainability-v1">;
+        summary: z.ZodString;
+        reasons: z.ZodArray<z.ZodEnum<{
+            symbol: "symbol";
+            path: "path";
+            lexical: "lexical";
+            semantic: "semantic";
+            component: "component";
+            repository: "repository";
+        }>>;
+        matchedTerms: z.ZodArray<z.ZodString>;
+        provenance: z.ZodObject<{
+            workspaceId: z.ZodOptional<z.ZodUUID>;
+            agent: z.ZodString;
+            sessionId: z.ZodOptional<z.ZodString>;
+            messageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            eventId: z.ZodOptional<z.ZodUUID>;
+            userId: z.ZodOptional<z.ZodUUID>;
+            redacted: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>;
+        status: z.ZodEnum<{
+            active: "active";
+            proposed: "proposed";
+            suppressed: "suppressed";
+            superseded: "superseded";
+            deleted: "deleted";
+        }>;
+        scope: z.ZodObject<{
+            organization: z.ZodOptional<z.ZodString>;
+            project: z.ZodOptional<z.ZodString>;
+            repo: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            component: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        freshness: z.ZodObject<{
+            createdAt: z.ZodISODateTime;
+            updatedAt: z.ZodISODateTime;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export type GuardItem = z.infer<typeof GuardItemSchema>;
 export declare const GuardConflictSchema: z.ZodObject<{
@@ -141,6 +181,11 @@ export declare const GuardConflictSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type GuardConflict = z.infer<typeof GuardConflictSchema>;
 export declare const GUARD_MAX_ITEMS = 3;
+export declare const GuardModeSourceSchema: z.ZodEnum<{
+    workspace: "workspace";
+    repo_override: "repo_override";
+}>;
+export type GuardModeSource = z.infer<typeof GuardModeSourceSchema>;
 export declare const GuardCheckResponseSchema: z.ZodObject<{
     checkId: z.ZodUUID;
     mode: z.ZodEnum<{
@@ -185,6 +230,46 @@ export declare const GuardCheckResponseSchema: z.ZodObject<{
             createdAt: z.ZodISODateTime;
         }, z.core.$strict>;
         reasons: z.ZodArray<z.ZodString>;
+        explanation: z.ZodOptional<z.ZodObject<{
+            contractVersion: z.ZodLiteral<"explainability-v1">;
+            summary: z.ZodString;
+            reasons: z.ZodArray<z.ZodEnum<{
+                symbol: "symbol";
+                path: "path";
+                lexical: "lexical";
+                semantic: "semantic";
+                component: "component";
+                repository: "repository";
+            }>>;
+            matchedTerms: z.ZodArray<z.ZodString>;
+            provenance: z.ZodObject<{
+                workspaceId: z.ZodOptional<z.ZodUUID>;
+                agent: z.ZodString;
+                sessionId: z.ZodOptional<z.ZodString>;
+                messageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                eventId: z.ZodOptional<z.ZodUUID>;
+                userId: z.ZodOptional<z.ZodUUID>;
+                redacted: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>;
+            status: z.ZodEnum<{
+                active: "active";
+                proposed: "proposed";
+                suppressed: "suppressed";
+                superseded: "superseded";
+                deleted: "deleted";
+            }>;
+            scope: z.ZodObject<{
+                organization: z.ZodOptional<z.ZodString>;
+                project: z.ZodOptional<z.ZodString>;
+                repo: z.ZodOptional<z.ZodString>;
+                path: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+                component: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            freshness: z.ZodObject<{
+                createdAt: z.ZodISODateTime;
+                updatedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     conflicts: z.ZodArray<z.ZodObject<{
         memoryIds: z.ZodArray<z.ZodUUID>;
@@ -208,6 +293,137 @@ export declare const GuardApproveResponseSchema: z.ZodObject<{
     expiresAt: z.ZodNullable<z.ZodISODateTime>;
 }, z.core.$strict>;
 export type GuardApproveResponse = z.infer<typeof GuardApproveResponseSchema>;
+export declare const GUARD_AUDIT_CONTRACT_VERSION: 1;
+export declare const GuardAuditPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    event: z.ZodLiteral<"check">;
+    checkId: z.ZodUUID;
+    mode: z.ZodEnum<{
+        off: "off";
+        assist: "assist";
+        enforce: "enforce";
+    }>;
+    modeSource: z.ZodEnum<{
+        workspace: "workspace";
+        repo_override: "repo_override";
+    }>;
+    decision: z.ZodEnum<{
+        allow: "allow";
+        require_confirmation: "require_confirmation";
+        approved_override: "approved_override";
+    }>;
+    retrievalMode: z.ZodNullable<z.ZodEnum<{
+        hybrid: "hybrid";
+        semantic_unavailable: "semantic_unavailable";
+        lexical_only: "lexical_only";
+    }>>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    relevant: z.ZodBoolean;
+    surfaced: z.ZodArray<z.ZodObject<{
+        memoryId: z.ZodUUID;
+        reasons: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    conflicts: z.ZodArray<z.ZodObject<{
+        proposalMemoryId: z.ZodUUID;
+        targetMemoryId: z.ZodUUID;
+    }, z.core.$strict>>;
+    blockingMemoryIds: z.ZodArray<z.ZodUUID>;
+    approvedMemoryIds: z.ZodArray<z.ZodUUID>;
+    action: z.ZodEnum<{
+        other: "other";
+        edit: "edit";
+        command: "command";
+        mcp: "mcp";
+        commit: "commit";
+        deploy: "deploy";
+        plan: "plan";
+    }>;
+    tool: z.ZodNullable<z.ZodString>;
+    repo: z.ZodNullable<z.ZodString>;
+    fileCount: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    event: z.ZodLiteral<"failure">;
+    checkId: z.ZodUUID;
+    durationMs: z.ZodNumber;
+    failureCode: z.ZodLiteral<"check_failed">;
+    action: z.ZodEnum<{
+        other: "other";
+        edit: "edit";
+        command: "command";
+        mcp: "mcp";
+        commit: "commit";
+        deploy: "deploy";
+        plan: "plan";
+    }>;
+    tool: z.ZodNullable<z.ZodString>;
+    repo: z.ZodNullable<z.ZodString>;
+    fileCount: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    event: z.ZodLiteral<"approval">;
+    checkId: z.ZodUUID;
+    approvedMemoryIds: z.ZodArray<z.ZodUUID>;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    event: z.ZodLiteral<"policy_update">;
+    previous: z.ZodObject<{
+        workspaceId: z.ZodUUID;
+        mode: z.ZodEnum<{
+            off: "off";
+            assist: "assist";
+            enforce: "enforce";
+        }>;
+        overrides: z.ZodArray<z.ZodObject<{
+            repo: z.ZodString;
+            mode: z.ZodEnum<{
+                off: "off";
+                assist: "assist";
+                enforce: "enforce";
+            }>;
+            updatedAt: z.ZodISODateTime;
+        }, z.core.$strict>>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    current: z.ZodObject<{
+        workspaceId: z.ZodUUID;
+        mode: z.ZodEnum<{
+            off: "off";
+            assist: "assist";
+            enforce: "enforce";
+        }>;
+        overrides: z.ZodArray<z.ZodObject<{
+            repo: z.ZodString;
+            mode: z.ZodEnum<{
+                off: "off";
+                assist: "assist";
+                enforce: "enforce";
+            }>;
+            updatedAt: z.ZodISODateTime;
+        }, z.core.$strict>>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    requested: z.ZodObject<{
+        mode: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            assist: "assist";
+            enforce: "enforce";
+        }>>;
+        setOverride: z.ZodOptional<z.ZodObject<{
+            repo: z.ZodString;
+            mode: z.ZodEnum<{
+                off: "off";
+                assist: "assist";
+                enforce: "enforce";
+            }>;
+        }, z.core.$strict>>;
+        removeOverride: z.ZodOptional<z.ZodObject<{
+            repo: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "event">;
+export type GuardAuditPayload = z.infer<typeof GuardAuditPayloadSchema>;
 /** How long an approval (or pending confirmation) stays valid. */
 export declare const GUARD_APPROVAL_TTL_MINUTES = 30;
 /**
@@ -216,7 +432,7 @@ export declare const GUARD_APPROVAL_TTL_MINUTES = 30;
  * integration so all agents receive identical guard context.
  */
 export declare function formatGuardContext(response: {
-    items: readonly Pick<GuardItem, "content" | "source" | "scope">[];
+    items: readonly Pick<GuardItem, "content" | "source" | "scope" | "explanation">[];
     conflicts: readonly GuardConflict[];
 }): string;
 //# sourceMappingURL=guard-schemas.d.ts.map

package/dist/guard-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guard-schemas.d.ts","sourceRoot":"","sources":["../src/guard-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;;EAAuC,CAAC;AACpE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,uBAAuB;;;;;;;;kBAMzB,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;kBAO5B,CAAC;AACZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;kBAgB1C,CAAC;AACJ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,iBAAiB;;;;;;;;EAQ5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;kBAazB,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,qBAAqB;;;;;kBAOvB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUjB,CAAC;AACZ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,mBAAmB;;;kBAKrB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqB1B,CAAC;AACZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,yBAAyB;;kBAI3B,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,0BAA0B;;;;kBAM5B,CAAC;AACZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE;IAC3C,KAAK,EAAE,SAAS,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAC;IAClE,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;CACrC,GAAG,MAAM,CAyBT"}
+{"version":3,"file":"guard-schemas.d.ts","sourceRoot":"","sources":["../src/guard-schemas.ts"],"names":[],"mappings":"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"}

package/dist/guard-schemas.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { MemoryCategorySchema, MemoryEnforcementSchema, MemoryScopeSchema, RepositoryPathSchema, } from "./schemas.js";
+import { MemoryCategorySchema, MemoryEnforcementSchema, MemoryScopeSchema, RepositoryPathSchema, RetrievalExplanationSchema, formatExplanation, } from "./schemas.js";
 import { ConnectorNameSchema } from "./pilot-schemas.js";
 /**
  * Context Guard runs Lore proactively at meaningful action boundaries.
@@ -81,6 +81,7 @@ export const GuardItemSchema = z
     enforcement: MemoryEnforcementSchema,
     source: GuardItemSourceSchema,
     reasons: z.array(z.string().trim().min(1).max(100)),
+    explanation: RetrievalExplanationSchema.optional(),
 })
     .strict();
 export const GuardConflictSchema = z
@@ -90,13 +91,17 @@ export const GuardConflictSchema = z
 })
     .strict();
 export const GUARD_MAX_ITEMS = 3;
+export const GuardModeSourceSchema = z.enum([
+    "workspace",
+    "repo_override",
+]);
 export const GuardCheckResponseSchema = z
     .object({
     checkId: z.uuid(),
     /** The effective mode after repo-override resolution. */
     mode: GuardModeSchema,
     /** Where the effective mode came from. */
-    modeSource: z.enum(["workspace", "repo_override"]),
+    modeSource: GuardModeSourceSchema,
     relevant: z.boolean(),
     items: z.array(GuardItemSchema).max(GUARD_MAX_ITEMS),
     conflicts: z.array(GuardConflictSchema),
@@ -124,6 +129,80 @@ export const GuardApproveResponseSchema = z
     expiresAt: z.iso.datetime({ offset: true }).nullable(),
 })
     .strict();
+export const GUARD_AUDIT_CONTRACT_VERSION = 1;
+const GuardAuditMemoryEvidenceSchema = z
+    .object({
+    memoryId: z.uuid(),
+    reasons: z.array(z.string().trim().min(1).max(100)).max(10),
+})
+    .strict();
+export const GuardAuditPayloadSchema = z.discriminatedUnion("event", [
+    z
+        .object({
+        version: z.literal(GUARD_AUDIT_CONTRACT_VERSION),
+        event: z.literal("check"),
+        checkId: z.uuid(),
+        mode: GuardModeSchema,
+        modeSource: GuardModeSourceSchema,
+        decision: z.enum([
+            "allow",
+            "require_confirmation",
+            "approved_override",
+        ]),
+        retrievalMode: z
+            .enum(["hybrid", "semantic_unavailable", "lexical_only"])
+            .nullable(),
+        durationMs: z.number().int().nonnegative().max(300_000).optional(),
+        relevant: z.boolean(),
+        surfaced: z.array(GuardAuditMemoryEvidenceSchema).max(GUARD_MAX_ITEMS),
+        conflicts: z
+            .array(z
+            .object({
+            proposalMemoryId: z.uuid(),
+            targetMemoryId: z.uuid(),
+        })
+            .strict())
+            .max(GUARD_MAX_ITEMS),
+        blockingMemoryIds: z.array(z.uuid()).max(100),
+        approvedMemoryIds: z.array(z.uuid()).max(100),
+        action: GuardActionSchema,
+        tool: z.string().trim().min(1).max(200).nullable(),
+        repo: GuardRepoSchema.nullable(),
+        fileCount: z.number().int().nonnegative(),
+    })
+        .strict(),
+    z
+        .object({
+        version: z.literal(GUARD_AUDIT_CONTRACT_VERSION),
+        event: z.literal("failure"),
+        checkId: z.uuid(),
+        durationMs: z.number().int().nonnegative().max(300_000),
+        failureCode: z.literal("check_failed"),
+        action: GuardActionSchema,
+        tool: z.string().trim().min(1).max(200).nullable(),
+        repo: GuardRepoSchema.nullable(),
+        fileCount: z.number().int().nonnegative(),
+    })
+        .strict(),
+    z
+        .object({
+        version: z.literal(GUARD_AUDIT_CONTRACT_VERSION),
+        event: z.literal("approval"),
+        checkId: z.uuid(),
+        approvedMemoryIds: z.array(z.uuid()).min(1).max(100),
+        expiresAt: z.iso.datetime({ offset: true }),
+    })
+        .strict(),
+    z
+        .object({
+        version: z.literal(GUARD_AUDIT_CONTRACT_VERSION),
+        event: z.literal("policy_update"),
+        previous: WorkspaceGuardPolicySchema,
+        current: WorkspaceGuardPolicySchema,
+        requested: UpdateWorkspaceGuardPolicySchema,
+    })
+        .strict(),
+]);
 /** How long an approval (or pending confirmation) stays valid. */
 export const GUARD_APPROVAL_TTL_MINUTES = 30;
 /**
@@ -138,15 +217,17 @@ export function formatGuardContext(response) {
     const lines = ["Relevant Lore context:"];
     for (const item of response.items) {
         lines.push(`- ${item.content}`);
-    }
-    lines.push("", "Sources:");
-    for (const item of response.items) {
-        const scope = item.scope.repo !== undefined
-            ? `${item.scope.repo} repo`
-            : item.scope.organization !== undefined
-                ? "organization rule"
-                : "workspace knowledge";
-        lines.push(`- ${scope} · ${item.source.agent} session`);
+        if (item.explanation !== undefined) {
+            lines.push(`  ${formatExplanation(item.explanation)}`);
+        }
+        else {
+            const scope = item.scope.repo !== undefined
+                ? `${item.scope.repo} repo`
+                : item.scope.organization !== undefined
+                    ? "organization rule"
+                    : "workspace knowledge";
+            lines.push(`  Source: ${scope} · ${item.source.agent} session.`);
+        }
     }
     if (response.conflicts.length > 0) {
         lines.push("", "Conflicting Lore context (do not silently pick a winner):");

package/dist/guard-schemas.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 export * from "./schemas.js";
 export * from "./pilot-schemas.js";
 export * from "./guard-schemas.js";
+export * from "./reliability-schemas.js";
+export * from "./operational-metrics.js";
+export * from "./snapshot-schemas.js";
 export * from "./auth-schemas.js";
 export * from "./platform-admin-schemas.js";
 export * from "./session-schemas.js";
@@ -10,6 +13,8 @@ export * from "./in-memory-repository.js";
 export * from "./engine.js";
 export * from "./conflict-detector.js";
 export * from "./redaction.js";
+export * from "./canonical-json.js";
 export * from "./injected-context.js";
 export * from "./native-coding-agents.js";
+export * from "./integration-contract.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -1,6 +1,9 @@
 export * from "./schemas.js";
 export * from "./pilot-schemas.js";
 export * from "./guard-schemas.js";
+export * from "./reliability-schemas.js";
+export * from "./operational-metrics.js";
+export * from "./snapshot-schemas.js";
 export * from "./auth-schemas.js";
 export * from "./platform-admin-schemas.js";
 export * from "./session-schemas.js";
@@ -10,6 +13,8 @@ export * from "./in-memory-repository.js";
 export * from "./engine.js";
 export * from "./conflict-detector.js";
 export * from "./redaction.js";
+export * from "./canonical-json.js";
 export * from "./injected-context.js";
 export * from "./native-coding-agents.js";
+export * from "./integration-contract.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,4BAA4B,GAE7B,MAAM,mBAAmB,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,4BAA4B,GAE7B,MAAM,mBAAmB,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC"}