@c4a/context 0.6.19 → 0.7.0

package/indexerResultReconciliationRun.d.ts

@@ -0,0 +1,15 @@
+import { type IndexerCoverageCompletionReport, type ResolvedQuestionEntry } from "./indexerResultReconciliation.js";
+export declare function reconcileIndexerResults(input: {
+    registry: unknown;
+    question_target_inventory: unknown;
+    resolved_questions: readonly ResolvedQuestionEntry[];
+    target_facts: Readonly<Record<string, Record<string, unknown>>>;
+    allowed_selector_fact_paths: ReadonlySet<string>;
+    author_results: readonly unknown[];
+    registered_material_sources: readonly unknown[];
+    retained_material_gap_ledger?: unknown;
+}): IndexerCoverageCompletionReport;
+export declare function validateIndexerCoverageCompletionReport(input: {
+    report: unknown;
+    rebuild: () => IndexerCoverageCompletionReport;
+}): IndexerCoverageCompletionReport;

package/indexerRunEnvelope.d.ts

@@ -0,0 +1,384 @@
+import { z } from "zod";
+import type { IndexerMainWorkset } from "./indexerMainWorkset.js";
+import { type IndexerRunFinalAuthority } from "./indexerRunProtocolCommon.js";
+export declare const indexerRunEnvironmentSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.run-environment/v1">;
+    source_snapshot_digest: z.ZodString;
+    parser_dependency_fingerprint: z.ZodString;
+    source_role: z.ZodEffects<z.ZodString, string, string>;
+    source_precedence_digest: z.ZodString;
+    metric_set_digest: z.ZodString;
+    dependency_view_digest: z.ZodNullable<z.ZodString>;
+    primary_execution_projection: z.ZodEffects<z.ZodObject<{
+        protocol: z.ZodLiteral<"context.indexer.primary-execution-projection/v1">;
+        indexer_id: z.ZodEffects<z.ZodString, string, string>;
+        primary_registry_projection_digest: z.ZodString;
+        program_digest: z.ZodNullable<z.ZodString>;
+        instructions_digest: z.ZodString;
+        template_set_digest: z.ZodString;
+        config_digest: z.ZodString;
+        cli_contract_digest: z.ZodString;
+        profile_contract_digest: z.ZodString;
+        resources: z.ZodArray<z.ZodObject<{
+            layer_ref: z.ZodString;
+            phase: z.ZodEnum<["primary", "pre-authority"]>;
+            kind: z.ZodEffects<z.ZodString, string, string>;
+            ref: z.ZodString;
+            digest: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: string;
+            ref: string;
+            digest: string;
+            layer_ref: string;
+            phase: "primary" | "pre-authority";
+        }, {
+            kind: string;
+            ref: string;
+            digest: string;
+            layer_ref: string;
+            phase: "primary" | "pre-authority";
+        }>, "many">;
+        primary_resource_binding_digest: 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;
+        }>;
+        primary_execution_fingerprint: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        protocol: "context.indexer.primary-execution-projection/v1";
+        indexer_id: string;
+        program_digest: string | null;
+        profile_contract_digest: string;
+        primary_registry_projection_digest: string;
+        primary_execution_fingerprint: string;
+        primary_resource_binding_digest: string;
+        instructions_digest: string;
+        template_set_digest: string;
+        config_digest: string;
+        cli_contract_digest: string;
+        resources: {
+            kind: string;
+            ref: string;
+            digest: string;
+            layer_ref: string;
+            phase: "primary" | "pre-authority";
+        }[];
+        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;
+        };
+    }, {
+        protocol: "context.indexer.primary-execution-projection/v1";
+        indexer_id: string;
+        program_digest: string | null;
+        profile_contract_digest: string;
+        primary_registry_projection_digest: string;
+        primary_execution_fingerprint: string;
+        primary_resource_binding_digest: string;
+        instructions_digest: string;
+        template_set_digest: string;
+        config_digest: string;
+        cli_contract_digest: string;
+        resources: {
+            kind: string;
+            ref: string;
+            digest: string;
+            layer_ref: string;
+            phase: "primary" | "pre-authority";
+        }[];
+        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;
+        };
+    }>, {
+        protocol: "context.indexer.primary-execution-projection/v1";
+        indexer_id: string;
+        program_digest: string | null;
+        profile_contract_digest: string;
+        primary_registry_projection_digest: string;
+        primary_execution_fingerprint: string;
+        primary_resource_binding_digest: string;
+        instructions_digest: string;
+        template_set_digest: string;
+        config_digest: string;
+        cli_contract_digest: string;
+        resources: {
+            kind: string;
+            ref: string;
+            digest: string;
+            layer_ref: string;
+            phase: "primary" | "pre-authority";
+        }[];
+        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;
+        };
+    }, {
+        protocol: "context.indexer.primary-execution-projection/v1";
+        indexer_id: string;
+        program_digest: string | null;
+        profile_contract_digest: string;
+        primary_registry_projection_digest: string;
+        primary_execution_fingerprint: string;
+        primary_resource_binding_digest: string;
+        instructions_digest: string;
+        template_set_digest: string;
+        config_digest: string;
+        cli_contract_digest: string;
+        resources: {
+            kind: string;
+            ref: string;
+            digest: string;
+            layer_ref: string;
+            phase: "primary" | "pre-authority";
+        }[];
+        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;
+        };
+    }>;
+} & {
+    environment_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.run-environment/v1";
+    source_role: string;
+    source_snapshot_digest: string;
+    parser_dependency_fingerprint: string;
+    source_precedence_digest: string;
+    metric_set_digest: string;
+    dependency_view_digest: string | null;
+    primary_execution_projection: {
+        protocol: "context.indexer.primary-execution-projection/v1";
+        indexer_id: string;
+        program_digest: string | null;
+        profile_contract_digest: string;
+        primary_registry_projection_digest: string;
+        primary_execution_fingerprint: string;
+        primary_resource_binding_digest: string;
+        instructions_digest: string;
+        template_set_digest: string;
+        config_digest: string;
+        cli_contract_digest: string;
+        resources: {
+            kind: string;
+            ref: string;
+            digest: string;
+            layer_ref: string;
+            phase: "primary" | "pre-authority";
+        }[];
+        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;
+        };
+    };
+    environment_digest: string;
+}, {
+    protocol: "context.indexer.run-environment/v1";
+    source_role: string;
+    source_snapshot_digest: string;
+    parser_dependency_fingerprint: string;
+    source_precedence_digest: string;
+    metric_set_digest: string;
+    dependency_view_digest: string | null;
+    primary_execution_projection: {
+        protocol: "context.indexer.primary-execution-projection/v1";
+        indexer_id: string;
+        program_digest: string | null;
+        profile_contract_digest: string;
+        primary_registry_projection_digest: string;
+        primary_execution_fingerprint: string;
+        primary_resource_binding_digest: string;
+        instructions_digest: string;
+        template_set_digest: string;
+        config_digest: string;
+        cli_contract_digest: string;
+        resources: {
+            kind: string;
+            ref: string;
+            digest: string;
+            layer_ref: string;
+            phase: "primary" | "pre-authority";
+        }[];
+        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;
+        };
+    };
+    environment_digest: string;
+}>;
+export type IndexerRunEnvironment = z.infer<typeof indexerRunEnvironmentSchema>;
+export declare function indexerRunEnvironmentDigest(value: Omit<IndexerRunEnvironment, "environment_digest">): string;
+export declare function buildIndexerRunEnvironment(input: Omit<IndexerRunEnvironment, "protocol" | "environment_digest">): IndexerRunEnvironment;
+export declare function validateIndexerRunEnvironment(value: unknown): IndexerRunEnvironment;
+export declare const indexerRunEnvelopeSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.run-envelope/v1">;
+    stage: z.ZodEnum<["partition", "author"]>;
+    workset_digest: z.ZodString;
+    execution_request_digest: z.ZodString;
+    source_ref: z.ZodString;
+    module_ref: z.ZodNullable<z.ZodString>;
+    logical_unit_ref: z.ZodNullable<z.ZodString>;
+    source_snapshot_digest: z.ZodString;
+    requirement_set_digest: z.ZodString;
+    indexer_id: z.ZodEffects<z.ZodString, string, string>;
+    provider_layer_ref: z.ZodString;
+    provider_integrity: z.ZodString;
+    provider_bundle_digest: z.ZodString;
+    config_fingerprint: z.ZodString;
+    customization_fingerprint: z.ZodNullable<z.ZodString>;
+    plan_binding_digest: z.ZodString;
+    runtime_fingerprint: z.ZodString;
+    resource_binding_digest: 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;
+    }>;
+    parser_dependency_fingerprint: z.ZodString;
+    source_role: z.ZodEffects<z.ZodString, string, string>;
+    source_precedence_digest: z.ZodString;
+    metric_set_digest: z.ZodString;
+    dependency_view_digest: z.ZodNullable<z.ZodString>;
+    run_environment_digest: z.ZodString;
+} & {
+    envelope_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    source_ref: string;
+    protocol: "context.indexer.run-envelope/v1";
+    workset_digest: string;
+    module_ref: string | null;
+    indexer_id: string;
+    provider_integrity: string;
+    logical_unit_ref: string | null;
+    stage: "partition" | "author";
+    requirement_set_digest: string;
+    provider_layer_ref: string;
+    provider_bundle_digest: string;
+    config_fingerprint: string;
+    customization_fingerprint: string | null;
+    source_role: 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;
+    };
+    source_snapshot_digest: string;
+    parser_dependency_fingerprint: string;
+    source_precedence_digest: string;
+    metric_set_digest: string;
+    dependency_view_digest: string | null;
+    execution_request_digest: string;
+    plan_binding_digest: string;
+    runtime_fingerprint: string;
+    resource_binding_digest: string;
+    run_environment_digest: string;
+    envelope_digest: string;
+}, {
+    source_ref: string;
+    protocol: "context.indexer.run-envelope/v1";
+    workset_digest: string;
+    module_ref: string | null;
+    indexer_id: string;
+    provider_integrity: string;
+    logical_unit_ref: string | null;
+    stage: "partition" | "author";
+    requirement_set_digest: string;
+    provider_layer_ref: string;
+    provider_bundle_digest: string;
+    config_fingerprint: string;
+    customization_fingerprint: string | null;
+    source_role: 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;
+    };
+    source_snapshot_digest: string;
+    parser_dependency_fingerprint: string;
+    source_precedence_digest: string;
+    metric_set_digest: string;
+    dependency_view_digest: string | null;
+    execution_request_digest: string;
+    plan_binding_digest: string;
+    runtime_fingerprint: string;
+    resource_binding_digest: string;
+    run_environment_digest: string;
+    envelope_digest: string;
+}>;
+export type IndexerRunEnvelope = z.infer<typeof indexerRunEnvelopeSchema>;
+export declare function indexerRunEnvelopeDigest(value: Omit<IndexerRunEnvelope, "envelope_digest">): string;
+export declare function validateIndexerRunEnvironmentBinding(workset: IndexerMainWorkset, environment: IndexerRunEnvironment): void;
+export declare function buildIndexerRunEnvelope(input: {
+    workset: IndexerMainWorkset;
+    execution_request_digest: string;
+    final_authority: IndexerRunFinalAuthority;
+    run_environment: IndexerRunEnvironment;
+}): IndexerRunEnvelope;
+export declare function validateIndexerRunEnvelope(value: unknown): IndexerRunEnvelope;

package/indexerRunProtocolCommon.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export declare const indexerRunFinalAuthoritySchema: z.ZodObject<{
+    layer_ref: z.ZodEffects<z.ZodString, string, string>;
+    integrity: z.ZodString;
+    bundle_digest: z.ZodString;
+    config_fingerprint: z.ZodString;
+    customization_fingerprint: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    integrity: string;
+    layer_ref: string;
+    bundle_digest: string;
+    config_fingerprint: string;
+    customization_fingerprint: string | null;
+}, {
+    integrity: string;
+    layer_ref: string;
+    bundle_digest: string;
+    config_fingerprint: string;
+    customization_fingerprint: string | null;
+}>;
+export type IndexerRunFinalAuthority = z.infer<typeof indexerRunFinalAuthoritySchema>;

package/indexerSharedArtifactFingerprint.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export declare const indexerSharedArtifactFingerprintSchema: 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;
+}>;
+export type IndexerSharedArtifactFingerprint = z.infer<typeof indexerSharedArtifactFingerprintSchema>;
+export declare function indexerImplementationFingerprint(programDigest: string | null): string;
+export declare function buildIndexerSharedArtifactFingerprint(input: {
+    indexer_id: string;
+    program_digest: string | null;
+    instructions_digest: string;
+    template_set_digest: string;
+}): IndexerSharedArtifactFingerprint;
+export declare function validateIndexerSharedArtifactFingerprint(value: unknown): IndexerSharedArtifactFingerprint;