@c4a/context 0.6.19 → 0.7.0

package/indexerLayoutChange.d.ts

@@ -0,0 +1,329 @@
+import { z } from "zod";
+export declare const indexerApprovedLayoutProjectionSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.approved-layout-projection/v1">;
+    indexer_id: z.ZodEffects<z.ZodString, string, string>;
+    profile: z.ZodEffects<z.ZodString, string, string>;
+    profile_contract_digest: z.ZodString;
+    subject_key_schema_set_digest: z.ZodString;
+    subject_key_schema_digest: z.ZodString;
+    node_ref: z.ZodString;
+    shared_artifact_fingerprint: z.ZodObject<{
+        protocol: z.ZodLiteral<"context.indexer.shared-artifact-fingerprint/v1">;
+        indexer_id: z.ZodEffects<z.ZodString, string, string>;
+        implementation_fingerprint: z.ZodString;
+        instructions_fingerprint: z.ZodString;
+        template_fingerprint: z.ZodString;
+    } & {
+        fingerprint_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        protocol: "context.indexer.shared-artifact-fingerprint/v1";
+        indexer_id: string;
+        implementation_fingerprint: string;
+        instructions_fingerprint: string;
+        template_fingerprint: string;
+        fingerprint_digest: string;
+    }, {
+        protocol: "context.indexer.shared-artifact-fingerprint/v1";
+        indexer_id: string;
+        implementation_fingerprint: string;
+        instructions_fingerprint: string;
+        template_fingerprint: string;
+        fingerprint_digest: string;
+    }>;
+    artifacts: z.ZodArray<z.ZodObject<{
+        artifact_ref: z.ZodString;
+        artifact_id: z.ZodEffects<z.ZodString, string, string>;
+        artifact_kind: z.ZodEffects<z.ZodString, string, string>;
+        collection: z.ZodType<import("./contracts.js").TopLevelNamespace, z.ZodTypeDef, import("./contracts.js").TopLevelNamespace>;
+        output_path: z.ZodEffects<z.ZodString, string, string>;
+        shared_artifact_fingerprint_digest: z.ZodString;
+        purpose: z.ZodEnum<["required", "discretionary", "semantic-split"]>;
+        split_of_artifact_ref: z.ZodNullable<z.ZodString>;
+        split_boundary: z.ZodNullable<z.ZodObject<{
+            axis: z.ZodEffects<z.ZodString, string, string>;
+            start_key: z.ZodString;
+            end_key: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            axis: string;
+            start_key: string;
+            end_key: string;
+        }, {
+            axis: string;
+            start_key: string;
+            end_key: string;
+        }>>;
+        sections: z.ZodArray<z.ZodObject<{
+            section_ref: z.ZodString;
+            section_identity_ref: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            section_ref: string;
+            section_identity_ref: string;
+        }, {
+            section_ref: string;
+            section_identity_ref: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        collection: import("./contracts.js").TopLevelNamespace;
+        output_path: string;
+        artifact_kind: string;
+        artifact_id: string;
+        purpose: "required" | "discretionary" | "semantic-split";
+        sections: {
+            section_ref: string;
+            section_identity_ref: string;
+        }[];
+        artifact_ref: string;
+        shared_artifact_fingerprint_digest: string;
+        split_of_artifact_ref: string | null;
+        split_boundary: {
+            axis: string;
+            start_key: string;
+            end_key: string;
+        } | null;
+    }, {
+        collection: import("./contracts.js").TopLevelNamespace;
+        output_path: string;
+        artifact_kind: string;
+        artifact_id: string;
+        purpose: "required" | "discretionary" | "semantic-split";
+        sections: {
+            section_ref: string;
+            section_identity_ref: string;
+        }[];
+        artifact_ref: string;
+        shared_artifact_fingerprint_digest: string;
+        split_of_artifact_ref: string | null;
+        split_boundary: {
+            axis: string;
+            start_key: string;
+            end_key: string;
+        } | null;
+    }>, "many">;
+} & {
+    projection_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.approved-layout-projection/v1";
+    profile: string;
+    artifacts: {
+        collection: import("./contracts.js").TopLevelNamespace;
+        output_path: string;
+        artifact_kind: string;
+        artifact_id: string;
+        purpose: "required" | "discretionary" | "semantic-split";
+        sections: {
+            section_ref: string;
+            section_identity_ref: string;
+        }[];
+        artifact_ref: string;
+        shared_artifact_fingerprint_digest: string;
+        split_of_artifact_ref: string | null;
+        split_boundary: {
+            axis: string;
+            start_key: string;
+            end_key: string;
+        } | null;
+    }[];
+    indexer_id: string;
+    profile_contract_digest: string;
+    node_ref: string;
+    subject_key_schema_digest: string;
+    projection_digest: string;
+    shared_artifact_fingerprint: {
+        protocol: "context.indexer.shared-artifact-fingerprint/v1";
+        indexer_id: string;
+        implementation_fingerprint: string;
+        instructions_fingerprint: string;
+        template_fingerprint: string;
+        fingerprint_digest: string;
+    };
+    subject_key_schema_set_digest: string;
+}, {
+    protocol: "context.indexer.approved-layout-projection/v1";
+    profile: string;
+    artifacts: {
+        collection: import("./contracts.js").TopLevelNamespace;
+        output_path: string;
+        artifact_kind: string;
+        artifact_id: string;
+        purpose: "required" | "discretionary" | "semantic-split";
+        sections: {
+            section_ref: string;
+            section_identity_ref: string;
+        }[];
+        artifact_ref: string;
+        shared_artifact_fingerprint_digest: string;
+        split_of_artifact_ref: string | null;
+        split_boundary: {
+            axis: string;
+            start_key: string;
+            end_key: string;
+        } | null;
+    }[];
+    indexer_id: string;
+    profile_contract_digest: string;
+    node_ref: string;
+    subject_key_schema_digest: string;
+    projection_digest: string;
+    shared_artifact_fingerprint: {
+        protocol: "context.indexer.shared-artifact-fingerprint/v1";
+        indexer_id: string;
+        implementation_fingerprint: string;
+        instructions_fingerprint: string;
+        template_fingerprint: string;
+        fingerprint_digest: string;
+    };
+    subject_key_schema_set_digest: string;
+}>;
+export type IndexerApprovedLayoutProjection = z.infer<typeof indexerApprovedLayoutProjectionSchema>;
+export declare const indexerLayoutChangeReportSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.layout-change-report/v1">;
+    base_projection_digest: z.ZodNullable<z.ZodString>;
+    target_proposal_digest: z.ZodString;
+    reused_artifact_refs: z.ZodArray<z.ZodString, "many">;
+    changes: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["artifact-added", "artifact-removed", "artifact-split", "artifact-merge", "artifact-rename", "section-move", "collection-move", "path-move"]>;
+        artifact_ref: z.ZodString;
+        related_artifact_ref: z.ZodNullable<z.ZodString>;
+        section_identity_refs: z.ZodArray<z.ZodString, "many">;
+        before_collection: z.ZodNullable<z.ZodType<import("./contracts.js").TopLevelNamespace, z.ZodTypeDef, import("./contracts.js").TopLevelNamespace>>;
+        after_collection: z.ZodNullable<z.ZodType<import("./contracts.js").TopLevelNamespace, z.ZodTypeDef, import("./contracts.js").TopLevelNamespace>>;
+        before_path: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        after_path: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        confirmation_class: z.ZodEnum<["compatible-addition", "destructive", "ambiguous"]>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "artifact-added" | "artifact-removed" | "artifact-split" | "artifact-merge" | "artifact-rename" | "section-move" | "collection-move" | "path-move";
+        artifact_ref: string;
+        related_artifact_ref: string | null;
+        section_identity_refs: string[];
+        before_collection: import("./contracts.js").TopLevelNamespace | null;
+        after_collection: import("./contracts.js").TopLevelNamespace | null;
+        before_path: string | null;
+        after_path: string | null;
+        confirmation_class: "ambiguous" | "compatible-addition" | "destructive";
+    }, {
+        kind: "artifact-added" | "artifact-removed" | "artifact-split" | "artifact-merge" | "artifact-rename" | "section-move" | "collection-move" | "path-move";
+        artifact_ref: string;
+        related_artifact_ref: string | null;
+        section_identity_refs: string[];
+        before_collection: import("./contracts.js").TopLevelNamespace | null;
+        after_collection: import("./contracts.js").TopLevelNamespace | null;
+        before_path: string | null;
+        after_path: string | null;
+        confirmation_class: "ambiguous" | "compatible-addition" | "destructive";
+    }>, "many">;
+    requires_confirmation: z.ZodBoolean;
+    gate: z.ZodNullable<z.ZodObject<{
+        id: z.ZodLiteral<"confirm-layout-change">;
+        authority: z.ZodLiteral<"human">;
+        delegation: z.ZodLiteral<"forbidden">;
+    }, "strict", z.ZodTypeAny, {
+        id: "confirm-layout-change";
+        authority: "human";
+        delegation: "forbidden";
+    }, {
+        id: "confirm-layout-change";
+        authority: "human";
+        delegation: "forbidden";
+    }>>;
+} & {
+    report_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.layout-change-report/v1";
+    report_digest: string;
+    changes: {
+        kind: "artifact-added" | "artifact-removed" | "artifact-split" | "artifact-merge" | "artifact-rename" | "section-move" | "collection-move" | "path-move";
+        artifact_ref: string;
+        related_artifact_ref: string | null;
+        section_identity_refs: string[];
+        before_collection: import("./contracts.js").TopLevelNamespace | null;
+        after_collection: import("./contracts.js").TopLevelNamespace | null;
+        before_path: string | null;
+        after_path: string | null;
+        confirmation_class: "ambiguous" | "compatible-addition" | "destructive";
+    }[];
+    gate: {
+        id: "confirm-layout-change";
+        authority: "human";
+        delegation: "forbidden";
+    } | null;
+    base_projection_digest: string | null;
+    target_proposal_digest: string;
+    reused_artifact_refs: string[];
+    requires_confirmation: boolean;
+}, {
+    protocol: "context.indexer.layout-change-report/v1";
+    report_digest: string;
+    changes: {
+        kind: "artifact-added" | "artifact-removed" | "artifact-split" | "artifact-merge" | "artifact-rename" | "section-move" | "collection-move" | "path-move";
+        artifact_ref: string;
+        related_artifact_ref: string | null;
+        section_identity_refs: string[];
+        before_collection: import("./contracts.js").TopLevelNamespace | null;
+        after_collection: import("./contracts.js").TopLevelNamespace | null;
+        before_path: string | null;
+        after_path: string | null;
+        confirmation_class: "ambiguous" | "compatible-addition" | "destructive";
+    }[];
+    gate: {
+        id: "confirm-layout-change";
+        authority: "human";
+        delegation: "forbidden";
+    } | null;
+    base_projection_digest: string | null;
+    target_proposal_digest: string;
+    reused_artifact_refs: string[];
+    requires_confirmation: boolean;
+}>;
+export type IndexerLayoutChangeReport = z.infer<typeof indexerLayoutChangeReportSchema>;
+export declare const indexerLayoutChangeConfirmationSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.layout-change-confirmation/v1">;
+    gate: z.ZodLiteral<"confirm-layout-change">;
+    report_digest: z.ZodString;
+    base_projection_digest: z.ZodString;
+    target_proposal_digest: z.ZodString;
+    decision: z.ZodLiteral<"approved">;
+    authority: z.ZodLiteral<"human">;
+    delegation: z.ZodLiteral<"none">;
+    actor_ref: z.ZodString;
+} & {
+    confirmation_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    decision: "approved";
+    protocol: "context.indexer.layout-change-confirmation/v1";
+    authority: "human";
+    report_digest: string;
+    gate: "confirm-layout-change";
+    confirmation_digest: string;
+    base_projection_digest: string;
+    target_proposal_digest: string;
+    delegation: "none";
+    actor_ref: string;
+}, {
+    decision: "approved";
+    protocol: "context.indexer.layout-change-confirmation/v1";
+    authority: "human";
+    report_digest: string;
+    gate: "confirm-layout-change";
+    confirmation_digest: string;
+    base_projection_digest: string;
+    target_proposal_digest: string;
+    delegation: "none";
+    actor_ref: string;
+}>;
+export type IndexerLayoutChangeConfirmation = z.infer<typeof indexerLayoutChangeConfirmationSchema>;
+export declare function buildIndexerApprovedLayoutProjection(value: unknown): IndexerApprovedLayoutProjection;
+export declare function validateIndexerApprovedLayoutProjection(value: unknown): IndexerApprovedLayoutProjection;
+export declare function compareIndexerLayout(input: {
+    base: unknown | null;
+    target: unknown;
+}): IndexerLayoutChangeReport;
+export declare function buildIndexerLayoutChangeConfirmation(input: {
+    report: IndexerLayoutChangeReport;
+    actor_ref: string;
+}): IndexerLayoutChangeConfirmation;
+export declare function authorizeIndexerLayoutChange(input: {
+    report: unknown;
+    confirmation?: unknown;
+}): IndexerLayoutChangeReport;
+export declare function validateIndexerLayoutChangeReport(value: unknown): IndexerLayoutChangeReport;
+export declare function sameIndexerApprovedLayout(left: IndexerApprovedLayoutProjection, right: IndexerApprovedLayoutProjection): boolean;