@c4a/context 0.6.18 → 0.7.0

package/indexerProviderComposition.d.ts

@@ -0,0 +1,1357 @@
+import { z } from "zod";
+import { type IndexerCustomizationPlan } from "./indexerCustomizationLadder.js";
+import { type IndexerProviderManifest } from "./indexerProvider.js";
+import { type IndexerProfileContract } from "./indexerProfileContract.js";
+import { type IndexerResolvedCompositionLayer } from "./indexerProviderProfileResolution.js";
+import { type IndexerRegistryEntry } from "./indexerRegistry.js";
+export declare const indexerSkillCapabilitySchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.skill-capability/v1">;
+    skill: z.ZodEffects<z.ZodString, string, string>;
+    version: z.ZodString;
+    domains: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    profiles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    operations: z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<["main-index", "material-answer"]>;
+        consumes: z.ZodString;
+        produces: z.ZodString;
+        accepts_layer_fragments: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        supported_evidence_kinds: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        id: "main-index" | "material-answer";
+        consumes: string;
+        produces: string;
+        accepts_layer_fragments: string[];
+        supported_evidence_kinds: string[];
+    }, {
+        id: "main-index" | "material-answer";
+        consumes: string;
+        produces: string;
+        accepts_layer_fragments: string[];
+        supported_evidence_kinds: string[];
+    }>, "many">;
+    layer_fragments: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEffects<z.ZodString, string, string>;
+        phase: z.ZodEnum<["pre-authority", "post-author"]>;
+        produces: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: string;
+        phase: "pre-authority" | "post-author";
+        produces: string;
+    }, {
+        kind: string;
+        phase: "pre-authority" | "post-author";
+        produces: string;
+    }>, "many">;
+    source_roles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    tool_sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        handler: z.ZodString;
+        request: z.ZodString;
+        produces: z.ZodLiteral<"context.indexer.tool-snapshot/v1">;
+        operations: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        optional: z.ZodLiteral<true>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        handler: string;
+        operations: string[];
+        optional: true;
+        request: string;
+        produces: "context.indexer.tool-snapshot/v1";
+    }, {
+        id: string;
+        handler: string;
+        operations: string[];
+        optional: true;
+        request: string;
+        produces: "context.indexer.tool-snapshot/v1";
+    }>, {
+        id: string;
+        handler: string;
+        operations: string[];
+        optional: true;
+        request: string;
+        produces: "context.indexer.tool-snapshot/v1";
+    }, {
+        id: string;
+        handler: string;
+        operations: string[];
+        optional: true;
+        request: string;
+        produces: "context.indexer.tool-snapshot/v1";
+    }>, "many">;
+    logical_units: z.ZodArray<z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        identity: z.ZodEffects<z.ZodString, string, string>;
+        recommended_artifacts: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        supported_policy_variants: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        identity: string;
+        supported_policy_variants: string[];
+        recommended_artifacts: string[];
+    }, {
+        id: string;
+        identity: string;
+        supported_policy_variants: string[];
+        recommended_artifacts: string[];
+    }>, "many">;
+    composers: z.ZodArray<z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        supported_profiles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        contract: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            instruction: z.ZodEffects<z.ZodString, string, string>;
+            primary_requirements: z.ZodObject<{
+                fact_kinds: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+                artifact_kinds: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            }, "strict", z.ZodTypeAny, {
+                artifact_kinds: string[];
+                fact_kinds: string[];
+            }, {
+                artifact_kinds: string[];
+                fact_kinds: string[];
+            }>;
+            derived_artifact_policy: z.ZodObject<{
+                fragment_protocol: z.ZodLiteral<"context.indexer.layer-fragment/v1">;
+                fragment_kind: z.ZodLiteral<"derived-artifact-proposal">;
+                artifact_policy_variant: z.ZodEffects<z.ZodString, string, string>;
+                artifact_kinds: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            }, "strict", z.ZodTypeAny, {
+                artifact_policy_variant: string;
+                artifact_kinds: string[];
+                fragment_protocol: "context.indexer.layer-fragment/v1";
+                fragment_kind: "derived-artifact-proposal";
+            }, {
+                artifact_policy_variant: string;
+                artifact_kinds: string[];
+                fragment_protocol: "context.indexer.layer-fragment/v1";
+                fragment_kind: "derived-artifact-proposal";
+            }>;
+            empty_result: z.ZodObject<{
+                result_protocol: z.ZodLiteral<"context.indexer.layer-fragment-result/v1">;
+                behavior: z.ZodLiteral<"empty-fragment-set">;
+            }, "strict", z.ZodTypeAny, {
+                result_protocol: "context.indexer.layer-fragment-result/v1";
+                behavior: "empty-fragment-set";
+            }, {
+                result_protocol: "context.indexer.layer-fragment-result/v1";
+                behavior: "empty-fragment-set";
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            instruction: string;
+            primary_requirements: {
+                artifact_kinds: string[];
+                fact_kinds: string[];
+            };
+            derived_artifact_policy: {
+                artifact_policy_variant: string;
+                artifact_kinds: string[];
+                fragment_protocol: "context.indexer.layer-fragment/v1";
+                fragment_kind: "derived-artifact-proposal";
+            };
+            empty_result: {
+                result_protocol: "context.indexer.layer-fragment-result/v1";
+                behavior: "empty-fragment-set";
+            };
+        }, {
+            instruction: string;
+            primary_requirements: {
+                artifact_kinds: string[];
+                fact_kinds: string[];
+            };
+            derived_artifact_policy: {
+                artifact_policy_variant: string;
+                artifact_kinds: string[];
+                fragment_protocol: "context.indexer.layer-fragment/v1";
+                fragment_kind: "derived-artifact-proposal";
+            };
+            empty_result: {
+                result_protocol: "context.indexer.layer-fragment-result/v1";
+                behavior: "empty-fragment-set";
+            };
+        }>, {
+            instruction: string;
+            primary_requirements: {
+                artifact_kinds: string[];
+                fact_kinds: string[];
+            };
+            derived_artifact_policy: {
+                artifact_policy_variant: string;
+                artifact_kinds: string[];
+                fragment_protocol: "context.indexer.layer-fragment/v1";
+                fragment_kind: "derived-artifact-proposal";
+            };
+            empty_result: {
+                result_protocol: "context.indexer.layer-fragment-result/v1";
+                behavior: "empty-fragment-set";
+            };
+        }, {
+            instruction: string;
+            primary_requirements: {
+                artifact_kinds: string[];
+                fact_kinds: string[];
+            };
+            derived_artifact_policy: {
+                artifact_policy_variant: string;
+                artifact_kinds: string[];
+                fragment_protocol: "context.indexer.layer-fragment/v1";
+                fragment_kind: "derived-artifact-proposal";
+            };
+            empty_result: {
+                result_protocol: "context.indexer.layer-fragment-result/v1";
+                behavior: "empty-fragment-set";
+            };
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        supported_profiles: string[];
+        contract?: {
+            instruction: string;
+            primary_requirements: {
+                artifact_kinds: string[];
+                fact_kinds: string[];
+            };
+            derived_artifact_policy: {
+                artifact_policy_variant: string;
+                artifact_kinds: string[];
+                fragment_protocol: "context.indexer.layer-fragment/v1";
+                fragment_kind: "derived-artifact-proposal";
+            };
+            empty_result: {
+                result_protocol: "context.indexer.layer-fragment-result/v1";
+                behavior: "empty-fragment-set";
+            };
+        } | undefined;
+    }, {
+        id: string;
+        supported_profiles: string[];
+        contract?: {
+            instruction: string;
+            primary_requirements: {
+                artifact_kinds: string[];
+                fact_kinds: string[];
+            };
+            derived_artifact_policy: {
+                artifact_policy_variant: string;
+                artifact_kinds: string[];
+                fragment_protocol: "context.indexer.layer-fragment/v1";
+                fragment_kind: "derived-artifact-proposal";
+            };
+            empty_result: {
+                result_protocol: "context.indexer.layer-fragment-result/v1";
+                behavior: "empty-fragment-set";
+            };
+        } | undefined;
+    }>, "many">;
+    program_capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    customization_capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+} & {
+    capability_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.skill-capability/v1";
+    operations: {
+        id: "main-index" | "material-answer";
+        consumes: string;
+        produces: string;
+        accepts_layer_fragments: string[];
+        supported_evidence_kinds: string[];
+    }[];
+    skill: string;
+    version: string;
+    composers: {
+        id: string;
+        supported_profiles: string[];
+        contract?: {
+            instruction: string;
+            primary_requirements: {
+                artifact_kinds: string[];
+                fact_kinds: string[];
+            };
+            derived_artifact_policy: {
+                artifact_policy_variant: string;
+                artifact_kinds: string[];
+                fragment_protocol: "context.indexer.layer-fragment/v1";
+                fragment_kind: "derived-artifact-proposal";
+            };
+            empty_result: {
+                result_protocol: "context.indexer.layer-fragment-result/v1";
+                behavior: "empty-fragment-set";
+            };
+        } | undefined;
+    }[];
+    source_roles: string[];
+    profiles: string[];
+    layer_fragments: {
+        kind: string;
+        phase: "pre-authority" | "post-author";
+        produces: string;
+    }[];
+    tool_sources: {
+        id: string;
+        handler: string;
+        operations: string[];
+        optional: true;
+        request: string;
+        produces: "context.indexer.tool-snapshot/v1";
+    }[];
+    logical_units: {
+        id: string;
+        identity: string;
+        supported_policy_variants: string[];
+        recommended_artifacts: string[];
+    }[];
+    domains: string[];
+    program_capabilities: string[];
+    customization_capabilities: string[];
+    capability_digest: string;
+}, {
+    protocol: "context.indexer.skill-capability/v1";
+    operations: {
+        id: "main-index" | "material-answer";
+        consumes: string;
+        produces: string;
+        accepts_layer_fragments: string[];
+        supported_evidence_kinds: string[];
+    }[];
+    skill: string;
+    version: string;
+    composers: {
+        id: string;
+        supported_profiles: string[];
+        contract?: {
+            instruction: string;
+            primary_requirements: {
+                artifact_kinds: string[];
+                fact_kinds: string[];
+            };
+            derived_artifact_policy: {
+                artifact_policy_variant: string;
+                artifact_kinds: string[];
+                fragment_protocol: "context.indexer.layer-fragment/v1";
+                fragment_kind: "derived-artifact-proposal";
+            };
+            empty_result: {
+                result_protocol: "context.indexer.layer-fragment-result/v1";
+                behavior: "empty-fragment-set";
+            };
+        } | undefined;
+    }[];
+    source_roles: string[];
+    profiles: string[];
+    layer_fragments: {
+        kind: string;
+        phase: "pre-authority" | "post-author";
+        produces: string;
+    }[];
+    tool_sources: {
+        id: string;
+        handler: string;
+        operations: string[];
+        optional: true;
+        request: string;
+        produces: "context.indexer.tool-snapshot/v1";
+    }[];
+    logical_units: {
+        id: string;
+        identity: string;
+        supported_policy_variants: string[];
+        recommended_artifacts: string[];
+    }[];
+    domains: string[];
+    program_capabilities: string[];
+    customization_capabilities: string[];
+    capability_digest: string;
+}>;
+export type IndexerSkillCapability = z.infer<typeof indexerSkillCapabilitySchema>;
+export declare function buildIndexerSkillCapability(value: IndexerProviderManifest): IndexerSkillCapability;
+export declare function validateIndexerSkillCapability(value: unknown): IndexerSkillCapability;
+export declare const indexerProviderCompositionPlanSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.provider-composition-plan/v1">;
+    indexer_id: z.ZodEffects<z.ZodString, string, string>;
+    primary_layer_id: z.ZodEffects<z.ZodString, string, string>;
+    active_profiles: z.ZodArray<z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        kind: z.ZodEnum<["primary", "supporting", "extension"]>;
+        provider_layer_id: z.ZodEffects<z.ZodString, string, string>;
+        variants: z.ZodRecord<z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        kind: "primary" | "supporting" | "extension";
+        variants: Record<string, string>;
+        provider_layer_id: string;
+    }, {
+        id: string;
+        kind: "primary" | "supporting" | "extension";
+        variants: Record<string, string>;
+        provider_layer_id: string;
+    }>, "many">;
+    skill_capabilities: z.ZodArray<z.ZodObject<{
+        provider_layer_id: z.ZodEffects<z.ZodString, string, string>;
+        provider_integrity: z.ZodString;
+        manifest_digest: z.ZodString;
+        capability: z.ZodObject<{
+            protocol: z.ZodLiteral<"context.indexer.skill-capability/v1">;
+            skill: z.ZodEffects<z.ZodString, string, string>;
+            version: z.ZodString;
+            domains: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            profiles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            operations: z.ZodArray<z.ZodObject<{
+                id: z.ZodEnum<["main-index", "material-answer"]>;
+                consumes: z.ZodString;
+                produces: z.ZodString;
+                accepts_layer_fragments: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+                supported_evidence_kinds: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            }, "strict", z.ZodTypeAny, {
+                id: "main-index" | "material-answer";
+                consumes: string;
+                produces: string;
+                accepts_layer_fragments: string[];
+                supported_evidence_kinds: string[];
+            }, {
+                id: "main-index" | "material-answer";
+                consumes: string;
+                produces: string;
+                accepts_layer_fragments: string[];
+                supported_evidence_kinds: string[];
+            }>, "many">;
+            layer_fragments: z.ZodArray<z.ZodObject<{
+                kind: z.ZodEffects<z.ZodString, string, string>;
+                phase: z.ZodEnum<["pre-authority", "post-author"]>;
+                produces: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                kind: string;
+                phase: "pre-authority" | "post-author";
+                produces: string;
+            }, {
+                kind: string;
+                phase: "pre-authority" | "post-author";
+                produces: string;
+            }>, "many">;
+            source_roles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            tool_sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
+                id: z.ZodEffects<z.ZodString, string, string>;
+                handler: z.ZodString;
+                request: z.ZodString;
+                produces: z.ZodLiteral<"context.indexer.tool-snapshot/v1">;
+                operations: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+                optional: z.ZodLiteral<true>;
+            }, "strict", z.ZodTypeAny, {
+                id: string;
+                handler: string;
+                operations: string[];
+                optional: true;
+                request: string;
+                produces: "context.indexer.tool-snapshot/v1";
+            }, {
+                id: string;
+                handler: string;
+                operations: string[];
+                optional: true;
+                request: string;
+                produces: "context.indexer.tool-snapshot/v1";
+            }>, {
+                id: string;
+                handler: string;
+                operations: string[];
+                optional: true;
+                request: string;
+                produces: "context.indexer.tool-snapshot/v1";
+            }, {
+                id: string;
+                handler: string;
+                operations: string[];
+                optional: true;
+                request: string;
+                produces: "context.indexer.tool-snapshot/v1";
+            }>, "many">;
+            logical_units: z.ZodArray<z.ZodObject<{
+                id: z.ZodEffects<z.ZodString, string, string>;
+                identity: z.ZodEffects<z.ZodString, string, string>;
+                recommended_artifacts: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+                supported_policy_variants: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            }, "strict", z.ZodTypeAny, {
+                id: string;
+                identity: string;
+                supported_policy_variants: string[];
+                recommended_artifacts: string[];
+            }, {
+                id: string;
+                identity: string;
+                supported_policy_variants: string[];
+                recommended_artifacts: string[];
+            }>, "many">;
+            composers: z.ZodArray<z.ZodObject<{
+                id: z.ZodEffects<z.ZodString, string, string>;
+                supported_profiles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+                contract: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+                    instruction: z.ZodEffects<z.ZodString, string, string>;
+                    primary_requirements: z.ZodObject<{
+                        fact_kinds: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+                        artifact_kinds: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+                    }, "strict", z.ZodTypeAny, {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    }, {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    }>;
+                    derived_artifact_policy: z.ZodObject<{
+                        fragment_protocol: z.ZodLiteral<"context.indexer.layer-fragment/v1">;
+                        fragment_kind: z.ZodLiteral<"derived-artifact-proposal">;
+                        artifact_policy_variant: z.ZodEffects<z.ZodString, string, string>;
+                        artifact_kinds: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+                    }, "strict", z.ZodTypeAny, {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    }, {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    }>;
+                    empty_result: z.ZodObject<{
+                        result_protocol: z.ZodLiteral<"context.indexer.layer-fragment-result/v1">;
+                        behavior: z.ZodLiteral<"empty-fragment-set">;
+                    }, "strict", z.ZodTypeAny, {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    }, {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    }>;
+                }, "strict", z.ZodTypeAny, {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                }, {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                }>, {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                }, {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                }>>;
+            }, "strict", z.ZodTypeAny, {
+                id: string;
+                supported_profiles: string[];
+                contract?: {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                } | undefined;
+            }, {
+                id: string;
+                supported_profiles: string[];
+                contract?: {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                } | undefined;
+            }>, "many">;
+            program_capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            customization_capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        } & {
+            capability_digest: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            protocol: "context.indexer.skill-capability/v1";
+            operations: {
+                id: "main-index" | "material-answer";
+                consumes: string;
+                produces: string;
+                accepts_layer_fragments: string[];
+                supported_evidence_kinds: string[];
+            }[];
+            skill: string;
+            version: string;
+            composers: {
+                id: string;
+                supported_profiles: string[];
+                contract?: {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                } | undefined;
+            }[];
+            source_roles: string[];
+            profiles: string[];
+            layer_fragments: {
+                kind: string;
+                phase: "pre-authority" | "post-author";
+                produces: string;
+            }[];
+            tool_sources: {
+                id: string;
+                handler: string;
+                operations: string[];
+                optional: true;
+                request: string;
+                produces: "context.indexer.tool-snapshot/v1";
+            }[];
+            logical_units: {
+                id: string;
+                identity: string;
+                supported_policy_variants: string[];
+                recommended_artifacts: string[];
+            }[];
+            domains: string[];
+            program_capabilities: string[];
+            customization_capabilities: string[];
+            capability_digest: string;
+        }, {
+            protocol: "context.indexer.skill-capability/v1";
+            operations: {
+                id: "main-index" | "material-answer";
+                consumes: string;
+                produces: string;
+                accepts_layer_fragments: string[];
+                supported_evidence_kinds: string[];
+            }[];
+            skill: string;
+            version: string;
+            composers: {
+                id: string;
+                supported_profiles: string[];
+                contract?: {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                } | undefined;
+            }[];
+            source_roles: string[];
+            profiles: string[];
+            layer_fragments: {
+                kind: string;
+                phase: "pre-authority" | "post-author";
+                produces: string;
+            }[];
+            tool_sources: {
+                id: string;
+                handler: string;
+                operations: string[];
+                optional: true;
+                request: string;
+                produces: "context.indexer.tool-snapshot/v1";
+            }[];
+            logical_units: {
+                id: string;
+                identity: string;
+                supported_policy_variants: string[];
+                recommended_artifacts: string[];
+            }[];
+            domains: string[];
+            program_capabilities: string[];
+            customization_capabilities: string[];
+            capability_digest: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        capability: {
+            protocol: "context.indexer.skill-capability/v1";
+            operations: {
+                id: "main-index" | "material-answer";
+                consumes: string;
+                produces: string;
+                accepts_layer_fragments: string[];
+                supported_evidence_kinds: string[];
+            }[];
+            skill: string;
+            version: string;
+            composers: {
+                id: string;
+                supported_profiles: string[];
+                contract?: {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                } | undefined;
+            }[];
+            source_roles: string[];
+            profiles: string[];
+            layer_fragments: {
+                kind: string;
+                phase: "pre-authority" | "post-author";
+                produces: string;
+            }[];
+            tool_sources: {
+                id: string;
+                handler: string;
+                operations: string[];
+                optional: true;
+                request: string;
+                produces: "context.indexer.tool-snapshot/v1";
+            }[];
+            logical_units: {
+                id: string;
+                identity: string;
+                supported_policy_variants: string[];
+                recommended_artifacts: string[];
+            }[];
+            domains: string[];
+            program_capabilities: string[];
+            customization_capabilities: string[];
+            capability_digest: string;
+        };
+        manifest_digest: string;
+        provider_integrity: string;
+        provider_layer_id: string;
+    }, {
+        capability: {
+            protocol: "context.indexer.skill-capability/v1";
+            operations: {
+                id: "main-index" | "material-answer";
+                consumes: string;
+                produces: string;
+                accepts_layer_fragments: string[];
+                supported_evidence_kinds: string[];
+            }[];
+            skill: string;
+            version: string;
+            composers: {
+                id: string;
+                supported_profiles: string[];
+                contract?: {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                } | undefined;
+            }[];
+            source_roles: string[];
+            profiles: string[];
+            layer_fragments: {
+                kind: string;
+                phase: "pre-authority" | "post-author";
+                produces: string;
+            }[];
+            tool_sources: {
+                id: string;
+                handler: string;
+                operations: string[];
+                optional: true;
+                request: string;
+                produces: "context.indexer.tool-snapshot/v1";
+            }[];
+            logical_units: {
+                id: string;
+                identity: string;
+                supported_policy_variants: string[];
+                recommended_artifacts: string[];
+            }[];
+            domains: string[];
+            program_capabilities: string[];
+            customization_capabilities: string[];
+            capability_digest: string;
+        };
+        manifest_digest: string;
+        provider_integrity: string;
+        provider_layer_id: string;
+    }>, "many">;
+    operation_authorities: z.ZodArray<z.ZodObject<{
+        operation: z.ZodEnum<["main-index", "material-answer"]>;
+        final_authority_layer_id: z.ZodEffects<z.ZodString, string, string>;
+        accepts_layer_fragments: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        operation: "main-index" | "material-answer";
+        accepts_layer_fragments: string[];
+        final_authority_layer_id: string;
+    }, {
+        operation: "main-index" | "material-answer";
+        accepts_layer_fragments: string[];
+        final_authority_layer_id: string;
+    }>, "many">;
+    source_roles: z.ZodArray<z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        provider_layer_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        provider_layer_ids: string[];
+    }, {
+        id: string;
+        provider_layer_ids: string[];
+    }>, "many">;
+    tool_sources: z.ZodArray<z.ZodObject<{
+        provider_layer_id: z.ZodEffects<z.ZodString, string, string>;
+        declaration: z.ZodEffects<z.ZodObject<{
+            id: z.ZodEffects<z.ZodString, string, string>;
+            handler: z.ZodString;
+            request: z.ZodString;
+            produces: z.ZodLiteral<"context.indexer.tool-snapshot/v1">;
+            operations: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+            optional: z.ZodLiteral<true>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            handler: string;
+            operations: string[];
+            optional: true;
+            request: string;
+            produces: "context.indexer.tool-snapshot/v1";
+        }, {
+            id: string;
+            handler: string;
+            operations: string[];
+            optional: true;
+            request: string;
+            produces: "context.indexer.tool-snapshot/v1";
+        }>, {
+            id: string;
+            handler: string;
+            operations: string[];
+            optional: true;
+            request: string;
+            produces: "context.indexer.tool-snapshot/v1";
+        }, {
+            id: string;
+            handler: string;
+            operations: string[];
+            optional: true;
+            request: string;
+            produces: "context.indexer.tool-snapshot/v1";
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        provider_layer_id: string;
+        declaration: {
+            id: string;
+            handler: string;
+            operations: string[];
+            optional: true;
+            request: string;
+            produces: "context.indexer.tool-snapshot/v1";
+        };
+    }, {
+        provider_layer_id: string;
+        declaration: {
+            id: string;
+            handler: string;
+            operations: string[];
+            optional: true;
+            request: string;
+            produces: "context.indexer.tool-snapshot/v1";
+        };
+    }>, "many">;
+    logical_units: z.ZodArray<z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        definition_digest: z.ZodString;
+        provider_layer_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        provider_layer_ids: string[];
+        definition_digest: string;
+    }, {
+        id: string;
+        provider_layer_ids: string[];
+        definition_digest: string;
+    }>, "many">;
+    instructions: z.ZodArray<z.ZodObject<{
+        stage: z.ZodEnum<["primary", "supporting", "extension", "composer"]>;
+        provider_layer_id: z.ZodEffects<z.ZodString, string, string>;
+        profile_id: z.ZodEffects<z.ZodString, string, string>;
+        path: z.ZodEffects<z.ZodString, string, string>;
+        source: z.ZodEnum<["provider", "project-append"]>;
+        project_digest: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        source: "provider" | "project-append";
+        profile_id: string;
+        stage: "primary" | "supporting" | "extension" | "composer";
+        provider_layer_id: string;
+        project_digest?: string | undefined;
+    }, {
+        path: string;
+        source: "provider" | "project-append";
+        profile_id: string;
+        stage: "primary" | "supporting" | "extension" | "composer";
+        provider_layer_id: string;
+        project_digest?: string | undefined;
+    }>, "many">;
+    templates: z.ZodArray<z.ZodObject<{
+        stage: z.ZodEnum<["primary", "supporting", "extension", "composer"]>;
+        provider_layer_id: z.ZodEffects<z.ZodString, string, string>;
+        profile_id: z.ZodEffects<z.ZodString, string, string>;
+        template_id: z.ZodEffects<z.ZodString, string, string>;
+        provider_path: z.ZodEffects<z.ZodString, string, string>;
+        source: z.ZodEnum<["provider", "project-override"]>;
+        project_path: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        project_digest: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        source: "provider" | "project-override";
+        template_id: string;
+        profile_id: string;
+        stage: "primary" | "supporting" | "extension" | "composer";
+        provider_layer_id: string;
+        provider_path: string;
+        project_digest?: string | undefined;
+        project_path?: string | undefined;
+    }, {
+        source: "provider" | "project-override";
+        template_id: string;
+        profile_id: string;
+        stage: "primary" | "supporting" | "extension" | "composer";
+        provider_layer_id: string;
+        provider_path: string;
+        project_digest?: string | undefined;
+        project_path?: string | undefined;
+    }>, "many">;
+    isolated_configs: z.ZodArray<z.ZodObject<{
+        provider_layer_id: z.ZodEffects<z.ZodString, string, string>;
+        config_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        config_digest: string;
+        provider_layer_id: string;
+    }, {
+        config_digest: string;
+        provider_layer_id: string;
+    }>, "many">;
+    composers: z.ZodArray<z.ZodObject<{
+        composer_ref: z.ZodString;
+        composer_id: z.ZodEffects<z.ZodString, string, string>;
+        provider_layer_id: z.ZodEffects<z.ZodString, string, string>;
+        composer_contract_digest: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        composer_ref: string;
+        provider_layer_id: string;
+        composer_id: string;
+        composer_contract_digest?: string | undefined;
+    }, {
+        composer_ref: string;
+        provider_layer_id: string;
+        composer_id: string;
+        composer_contract_digest?: string | undefined;
+    }>, "many">;
+    customization: z.ZodObject<{
+        mode: z.ZodEnum<["none", "extend", "replace"]>;
+        fingerprint: z.ZodString;
+        plan_digest: z.ZodString;
+        selected_capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        program_source: z.ZodEnum<["provider", "project-extend", "project-replace"]>;
+    }, "strict", z.ZodTypeAny, {
+        mode: "replace" | "extend" | "none";
+        plan_digest: string;
+        fingerprint: string;
+        selected_capabilities: string[];
+        program_source: "provider" | "project-extend" | "project-replace";
+    }, {
+        mode: "replace" | "extend" | "none";
+        plan_digest: string;
+        fingerprint: string;
+        selected_capabilities: string[];
+        program_source: "provider" | "project-extend" | "project-replace";
+    }>;
+} & {
+    composition_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.provider-composition-plan/v1";
+    composers: {
+        composer_ref: string;
+        provider_layer_id: string;
+        composer_id: string;
+        composer_contract_digest?: string | undefined;
+    }[];
+    customization: {
+        mode: "replace" | "extend" | "none";
+        plan_digest: string;
+        fingerprint: string;
+        selected_capabilities: string[];
+        program_source: "provider" | "project-extend" | "project-replace";
+    };
+    source_roles: {
+        id: string;
+        provider_layer_ids: string[];
+    }[];
+    tool_sources: {
+        provider_layer_id: string;
+        declaration: {
+            id: string;
+            handler: string;
+            operations: string[];
+            optional: true;
+            request: string;
+            produces: "context.indexer.tool-snapshot/v1";
+        };
+    }[];
+    logical_units: {
+        id: string;
+        provider_layer_ids: string[];
+        definition_digest: string;
+    }[];
+    instructions: {
+        path: string;
+        source: "provider" | "project-append";
+        profile_id: string;
+        stage: "primary" | "supporting" | "extension" | "composer";
+        provider_layer_id: string;
+        project_digest?: string | undefined;
+    }[];
+    templates: {
+        source: "provider" | "project-override";
+        template_id: string;
+        profile_id: string;
+        stage: "primary" | "supporting" | "extension" | "composer";
+        provider_layer_id: string;
+        provider_path: string;
+        project_digest?: string | undefined;
+        project_path?: string | undefined;
+    }[];
+    indexer_id: string;
+    primary_layer_id: string;
+    active_profiles: {
+        id: string;
+        kind: "primary" | "supporting" | "extension";
+        variants: Record<string, string>;
+        provider_layer_id: string;
+    }[];
+    skill_capabilities: {
+        capability: {
+            protocol: "context.indexer.skill-capability/v1";
+            operations: {
+                id: "main-index" | "material-answer";
+                consumes: string;
+                produces: string;
+                accepts_layer_fragments: string[];
+                supported_evidence_kinds: string[];
+            }[];
+            skill: string;
+            version: string;
+            composers: {
+                id: string;
+                supported_profiles: string[];
+                contract?: {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                } | undefined;
+            }[];
+            source_roles: string[];
+            profiles: string[];
+            layer_fragments: {
+                kind: string;
+                phase: "pre-authority" | "post-author";
+                produces: string;
+            }[];
+            tool_sources: {
+                id: string;
+                handler: string;
+                operations: string[];
+                optional: true;
+                request: string;
+                produces: "context.indexer.tool-snapshot/v1";
+            }[];
+            logical_units: {
+                id: string;
+                identity: string;
+                supported_policy_variants: string[];
+                recommended_artifacts: string[];
+            }[];
+            domains: string[];
+            program_capabilities: string[];
+            customization_capabilities: string[];
+            capability_digest: string;
+        };
+        manifest_digest: string;
+        provider_integrity: string;
+        provider_layer_id: string;
+    }[];
+    operation_authorities: {
+        operation: "main-index" | "material-answer";
+        accepts_layer_fragments: string[];
+        final_authority_layer_id: string;
+    }[];
+    isolated_configs: {
+        config_digest: string;
+        provider_layer_id: string;
+    }[];
+    composition_digest: string;
+}, {
+    protocol: "context.indexer.provider-composition-plan/v1";
+    composers: {
+        composer_ref: string;
+        provider_layer_id: string;
+        composer_id: string;
+        composer_contract_digest?: string | undefined;
+    }[];
+    customization: {
+        mode: "replace" | "extend" | "none";
+        plan_digest: string;
+        fingerprint: string;
+        selected_capabilities: string[];
+        program_source: "provider" | "project-extend" | "project-replace";
+    };
+    source_roles: {
+        id: string;
+        provider_layer_ids: string[];
+    }[];
+    tool_sources: {
+        provider_layer_id: string;
+        declaration: {
+            id: string;
+            handler: string;
+            operations: string[];
+            optional: true;
+            request: string;
+            produces: "context.indexer.tool-snapshot/v1";
+        };
+    }[];
+    logical_units: {
+        id: string;
+        provider_layer_ids: string[];
+        definition_digest: string;
+    }[];
+    instructions: {
+        path: string;
+        source: "provider" | "project-append";
+        profile_id: string;
+        stage: "primary" | "supporting" | "extension" | "composer";
+        provider_layer_id: string;
+        project_digest?: string | undefined;
+    }[];
+    templates: {
+        source: "provider" | "project-override";
+        template_id: string;
+        profile_id: string;
+        stage: "primary" | "supporting" | "extension" | "composer";
+        provider_layer_id: string;
+        provider_path: string;
+        project_digest?: string | undefined;
+        project_path?: string | undefined;
+    }[];
+    indexer_id: string;
+    primary_layer_id: string;
+    active_profiles: {
+        id: string;
+        kind: "primary" | "supporting" | "extension";
+        variants: Record<string, string>;
+        provider_layer_id: string;
+    }[];
+    skill_capabilities: {
+        capability: {
+            protocol: "context.indexer.skill-capability/v1";
+            operations: {
+                id: "main-index" | "material-answer";
+                consumes: string;
+                produces: string;
+                accepts_layer_fragments: string[];
+                supported_evidence_kinds: string[];
+            }[];
+            skill: string;
+            version: string;
+            composers: {
+                id: string;
+                supported_profiles: string[];
+                contract?: {
+                    instruction: string;
+                    primary_requirements: {
+                        artifact_kinds: string[];
+                        fact_kinds: string[];
+                    };
+                    derived_artifact_policy: {
+                        artifact_policy_variant: string;
+                        artifact_kinds: string[];
+                        fragment_protocol: "context.indexer.layer-fragment/v1";
+                        fragment_kind: "derived-artifact-proposal";
+                    };
+                    empty_result: {
+                        result_protocol: "context.indexer.layer-fragment-result/v1";
+                        behavior: "empty-fragment-set";
+                    };
+                } | undefined;
+            }[];
+            source_roles: string[];
+            profiles: string[];
+            layer_fragments: {
+                kind: string;
+                phase: "pre-authority" | "post-author";
+                produces: string;
+            }[];
+            tool_sources: {
+                id: string;
+                handler: string;
+                operations: string[];
+                optional: true;
+                request: string;
+                produces: "context.indexer.tool-snapshot/v1";
+            }[];
+            logical_units: {
+                id: string;
+                identity: string;
+                supported_policy_variants: string[];
+                recommended_artifacts: string[];
+            }[];
+            domains: string[];
+            program_capabilities: string[];
+            customization_capabilities: string[];
+            capability_digest: string;
+        };
+        manifest_digest: string;
+        provider_integrity: string;
+        provider_layer_id: string;
+    }[];
+    operation_authorities: {
+        operation: "main-index" | "material-answer";
+        accepts_layer_fragments: string[];
+        final_authority_layer_id: string;
+    }[];
+    isolated_configs: {
+        config_digest: string;
+        provider_layer_id: string;
+    }[];
+    composition_digest: string;
+}>;
+export type IndexerProviderCompositionPlan = z.infer<typeof indexerProviderCompositionPlanSchema>;
+export interface IndexerCompositionCustomizationInput {
+    mode: "none" | "extend" | "replace";
+    fingerprint: string;
+    files: readonly {
+        path: string;
+        digest: string;
+        capability: "instructions-append" | "template-override" | "program-extend";
+        origin: {
+            skill: string;
+            version: string;
+            profile: string;
+        };
+    }[];
+    plan: IndexerCustomizationPlan;
+}
+export type { IndexerResolvedCompositionLayer } from "./indexerProviderProfileResolution.js";
+export declare function buildIndexerProviderCompositionPlan(input: {
+    indexer: IndexerRegistryEntry;
+    resolved_layers: readonly IndexerResolvedCompositionLayer[];
+    profile_contract: IndexerProfileContract;
+    customization: IndexerCompositionCustomizationInput;
+}): IndexerProviderCompositionPlan;
+export declare function validateIndexerProviderCompositionPlan(value: unknown): IndexerProviderCompositionPlan;