@c4a/context 0.6.18 → 0.7.0

package/indexerPhysicalArtifactAudit.d.ts

@@ -0,0 +1,247 @@
+import { z } from "zod";
+import { type IndexerArtifactManifest, type IndexerPhysicalArtifactFileInput } from "./indexerPhysicalArtifactManifest.js";
+declare const physicalArtifactDiagnosticSchema: z.ZodObject<{
+    code: z.ZodEnum<["empty-physical-artifact", "missing-physical-artifact", "orphan-physical-artifact", "unresolved-material-artifact"]>;
+    output_path: z.ZodEffects<z.ZodString, string, string>;
+    artifact_ref: z.ZodNullable<z.ZodString>;
+    logical_unit_ref: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    code: "empty-physical-artifact" | "missing-physical-artifact" | "orphan-physical-artifact" | "unresolved-material-artifact";
+    output_path: string;
+    logical_unit_ref: string | null;
+    artifact_ref: string | null;
+}, {
+    code: "empty-physical-artifact" | "missing-physical-artifact" | "orphan-physical-artifact" | "unresolved-material-artifact";
+    output_path: string;
+    logical_unit_ref: string | null;
+    artifact_ref: string | null;
+}>;
+declare const logicalUnitFanOutSchema: z.ZodObject<{
+    logical_unit_ref: z.ZodString;
+    bundle_digest: z.ZodString;
+    planned_artifact_count: z.ZodNumber;
+    ready_artifact_count: z.ZodNumber;
+    materialized_artifact_count: z.ZodNumber;
+    discretionary_fan_out: z.ZodNumber;
+    semantic_split_part_count: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    logical_unit_ref: string;
+    semantic_split_part_count: number;
+    bundle_digest: string;
+    planned_artifact_count: number;
+    ready_artifact_count: number;
+    materialized_artifact_count: number;
+    discretionary_fan_out: number;
+}, {
+    logical_unit_ref: string;
+    semantic_split_part_count: number;
+    bundle_digest: string;
+    planned_artifact_count: number;
+    ready_artifact_count: number;
+    materialized_artifact_count: number;
+    discretionary_fan_out: number;
+}>;
+export declare const indexerPhysicalArtifactAuditSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.physical-artifact-audit/v1">;
+    layout_proposal_set_digest: z.ZodString;
+    artifact_manifest_digest: z.ZodString;
+    state: z.ZodEnum<["passed", "failed"]>;
+    summary: z.ZodObject<{
+        logical_unit_count: z.ZodNumber;
+        planned_bundle_artifact_count: z.ZodNumber;
+        complete_bundle_artifact_count: z.ZodNumber;
+        physical_artifact_count: z.ZodNumber;
+        registered_physical_artifact_count: z.ZodNumber;
+        navigation_artifact_count: z.ZodNumber;
+        empty_artifact_count: z.ZodNumber;
+        orphan_artifact_count: z.ZodNumber;
+        missing_artifact_count: z.ZodNumber;
+        unresolved_material_artifact_count: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        logical_unit_count: number;
+        planned_bundle_artifact_count: number;
+        complete_bundle_artifact_count: number;
+        physical_artifact_count: number;
+        registered_physical_artifact_count: number;
+        navigation_artifact_count: number;
+        empty_artifact_count: number;
+        orphan_artifact_count: number;
+        missing_artifact_count: number;
+        unresolved_material_artifact_count: number;
+    }, {
+        logical_unit_count: number;
+        planned_bundle_artifact_count: number;
+        complete_bundle_artifact_count: number;
+        physical_artifact_count: number;
+        registered_physical_artifact_count: number;
+        navigation_artifact_count: number;
+        empty_artifact_count: number;
+        orphan_artifact_count: number;
+        missing_artifact_count: number;
+        unresolved_material_artifact_count: number;
+    }>;
+    logical_unit_fan_out: z.ZodArray<z.ZodObject<{
+        logical_unit_ref: z.ZodString;
+        bundle_digest: z.ZodString;
+        planned_artifact_count: z.ZodNumber;
+        ready_artifact_count: z.ZodNumber;
+        materialized_artifact_count: z.ZodNumber;
+        discretionary_fan_out: z.ZodNumber;
+        semantic_split_part_count: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        logical_unit_ref: string;
+        semantic_split_part_count: number;
+        bundle_digest: string;
+        planned_artifact_count: number;
+        ready_artifact_count: number;
+        materialized_artifact_count: number;
+        discretionary_fan_out: number;
+    }, {
+        logical_unit_ref: string;
+        semantic_split_part_count: number;
+        bundle_digest: string;
+        planned_artifact_count: number;
+        ready_artifact_count: number;
+        materialized_artifact_count: number;
+        discretionary_fan_out: number;
+    }>, "many">;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<["empty-physical-artifact", "missing-physical-artifact", "orphan-physical-artifact", "unresolved-material-artifact"]>;
+        output_path: z.ZodEffects<z.ZodString, string, string>;
+        artifact_ref: z.ZodNullable<z.ZodString>;
+        logical_unit_ref: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        code: "empty-physical-artifact" | "missing-physical-artifact" | "orphan-physical-artifact" | "unresolved-material-artifact";
+        output_path: string;
+        logical_unit_ref: string | null;
+        artifact_ref: string | null;
+    }, {
+        code: "empty-physical-artifact" | "missing-physical-artifact" | "orphan-physical-artifact" | "unresolved-material-artifact";
+        output_path: string;
+        logical_unit_ref: string | null;
+        artifact_ref: string | null;
+    }>, "many">;
+    readability_advisories: z.ZodArray<z.ZodObject<{
+        code: z.ZodLiteral<"physical-artifact-reader-body-over-1500-lines">;
+        output_path: z.ZodEffects<z.ZodString, string, string>;
+        artifact_ref: z.ZodString;
+        reader_body_line_count: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        code: "physical-artifact-reader-body-over-1500-lines";
+        output_path: string;
+        artifact_ref: string;
+        reader_body_line_count: number;
+    }, {
+        code: "physical-artifact-reader-body-over-1500-lines";
+        output_path: string;
+        artifact_ref: string;
+        reader_body_line_count: number;
+    }>, "many">;
+} & {
+    audit_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.physical-artifact-audit/v1";
+    diagnostics: {
+        code: "empty-physical-artifact" | "missing-physical-artifact" | "orphan-physical-artifact" | "unresolved-material-artifact";
+        output_path: string;
+        logical_unit_ref: string | null;
+        artifact_ref: string | null;
+    }[];
+    state: "passed" | "failed";
+    audit_digest: string;
+    summary: {
+        logical_unit_count: number;
+        planned_bundle_artifact_count: number;
+        complete_bundle_artifact_count: number;
+        physical_artifact_count: number;
+        registered_physical_artifact_count: number;
+        navigation_artifact_count: number;
+        empty_artifact_count: number;
+        orphan_artifact_count: number;
+        missing_artifact_count: number;
+        unresolved_material_artifact_count: number;
+    };
+    layout_proposal_set_digest: string;
+    artifact_manifest_digest: string;
+    logical_unit_fan_out: {
+        logical_unit_ref: string;
+        semantic_split_part_count: number;
+        bundle_digest: string;
+        planned_artifact_count: number;
+        ready_artifact_count: number;
+        materialized_artifact_count: number;
+        discretionary_fan_out: number;
+    }[];
+    readability_advisories: {
+        code: "physical-artifact-reader-body-over-1500-lines";
+        output_path: string;
+        artifact_ref: string;
+        reader_body_line_count: number;
+    }[];
+}, {
+    protocol: "context.indexer.physical-artifact-audit/v1";
+    diagnostics: {
+        code: "empty-physical-artifact" | "missing-physical-artifact" | "orphan-physical-artifact" | "unresolved-material-artifact";
+        output_path: string;
+        logical_unit_ref: string | null;
+        artifact_ref: string | null;
+    }[];
+    state: "passed" | "failed";
+    audit_digest: string;
+    summary: {
+        logical_unit_count: number;
+        planned_bundle_artifact_count: number;
+        complete_bundle_artifact_count: number;
+        physical_artifact_count: number;
+        registered_physical_artifact_count: number;
+        navigation_artifact_count: number;
+        empty_artifact_count: number;
+        orphan_artifact_count: number;
+        missing_artifact_count: number;
+        unresolved_material_artifact_count: number;
+    };
+    layout_proposal_set_digest: string;
+    artifact_manifest_digest: string;
+    logical_unit_fan_out: {
+        logical_unit_ref: string;
+        semantic_split_part_count: number;
+        bundle_digest: string;
+        planned_artifact_count: number;
+        ready_artifact_count: number;
+        materialized_artifact_count: number;
+        discretionary_fan_out: number;
+    }[];
+    readability_advisories: {
+        code: "physical-artifact-reader-body-over-1500-lines";
+        output_path: string;
+        artifact_ref: string;
+        reader_body_line_count: number;
+    }[];
+}>;
+export type IndexerPhysicalArtifactDiagnostic = z.infer<typeof physicalArtifactDiagnosticSchema>;
+export type IndexerLogicalUnitFanOut = z.infer<typeof logicalUnitFanOutSchema>;
+export type IndexerPhysicalArtifactAudit = z.infer<typeof indexerPhysicalArtifactAuditSchema>;
+export declare function auditIndexerPhysicalArtifacts(input: {
+    layout_proposal_set: unknown;
+    artifact_bundles: readonly unknown[];
+    navigation_artifacts?: readonly unknown[];
+    files: readonly IndexerPhysicalArtifactFileInput[];
+}): {
+    manifest: IndexerArtifactManifest;
+    audit: IndexerPhysicalArtifactAudit;
+};
+export declare function validateIndexerPhysicalArtifactAudit(input: {
+    audit: unknown;
+    manifest: unknown;
+    layout_proposal_set: unknown;
+    artifact_bundles: readonly unknown[];
+    navigation_artifacts?: readonly unknown[];
+}): IndexerPhysicalArtifactAudit;
+export declare function assertIndexerPhysicalArtifactAuditPassed(input: {
+    audit: unknown;
+    manifest: unknown;
+    layout_proposal_set: unknown;
+    artifact_bundles: readonly unknown[];
+    navigation_artifacts?: readonly unknown[];
+}): IndexerPhysicalArtifactAudit;
+export {};

package/indexerPhysicalArtifactManifest.d.ts

@@ -0,0 +1,449 @@
+import { z } from "zod";
+export declare const indexerPhysicalArtifactOwnerSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"logical-unit">;
+    logical_unit_ref: z.ZodString;
+    node_ref: z.ZodString;
+    artifact_ref: z.ZodString;
+    artifact_id: z.ZodEffects<z.ZodString, string, string>;
+    artifact_kind: z.ZodEffects<z.ZodString, string, string>;
+    bundle_digest: z.ZodString;
+    purpose: z.ZodEnum<["required", "discretionary", "semantic-split"]>;
+    split_of: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    section_refs: z.ZodArray<z.ZodString, "many">;
+    material_state: z.ZodEnum<["ready", "blocked"]>;
+}, "strict", z.ZodTypeAny, {
+    kind: "logical-unit";
+    artifact_kind: string;
+    artifact_id: string;
+    purpose: "required" | "discretionary" | "semantic-split";
+    split_of: string | null;
+    logical_unit_ref: string;
+    bundle_digest: string;
+    node_ref: string;
+    artifact_ref: string;
+    section_refs: string[];
+    material_state: "blocked" | "ready";
+}, {
+    kind: "logical-unit";
+    artifact_kind: string;
+    artifact_id: string;
+    purpose: "required" | "discretionary" | "semantic-split";
+    split_of: string | null;
+    logical_unit_ref: string;
+    bundle_digest: string;
+    node_ref: string;
+    artifact_ref: string;
+    section_refs: string[];
+    material_state: "blocked" | "ready";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"navigation">;
+    navigation_ref: z.ZodString;
+    artifact_ref: z.ZodString;
+    artifact_id: z.ZodEffects<z.ZodString, string, string>;
+    artifact_kind: z.ZodEffects<z.ZodString, string, string>;
+    plan_digest: z.ZodString;
+    child_artifact_refs: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    kind: "navigation";
+    artifact_kind: string;
+    artifact_id: string;
+    plan_digest: string;
+    artifact_ref: string;
+    navigation_ref: string;
+    child_artifact_refs: string[];
+}, {
+    kind: "navigation";
+    artifact_kind: string;
+    artifact_id: string;
+    plan_digest: string;
+    artifact_ref: string;
+    navigation_ref: string;
+    child_artifact_refs: string[];
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"orphan">;
+    reason: z.ZodLiteral<"unregistered-output-path">;
+}, "strict", z.ZodTypeAny, {
+    kind: "orphan";
+    reason: "unregistered-output-path";
+}, {
+    kind: "orphan";
+    reason: "unregistered-output-path";
+}>]>;
+declare const physicalArtifactManifestEntrySchema: z.ZodObject<{
+    physical_ref: z.ZodString;
+    output_path: z.ZodEffects<z.ZodString, string, string>;
+    markdown_digest: z.ZodString;
+    byte_count: z.ZodNumber;
+    reader_body_line_count: z.ZodNumber;
+    empty: z.ZodBoolean;
+    owner: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"logical-unit">;
+        logical_unit_ref: z.ZodString;
+        node_ref: z.ZodString;
+        artifact_ref: z.ZodString;
+        artifact_id: z.ZodEffects<z.ZodString, string, string>;
+        artifact_kind: z.ZodEffects<z.ZodString, string, string>;
+        bundle_digest: z.ZodString;
+        purpose: z.ZodEnum<["required", "discretionary", "semantic-split"]>;
+        split_of: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        section_refs: z.ZodArray<z.ZodString, "many">;
+        material_state: z.ZodEnum<["ready", "blocked"]>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "logical-unit";
+        artifact_kind: string;
+        artifact_id: string;
+        purpose: "required" | "discretionary" | "semantic-split";
+        split_of: string | null;
+        logical_unit_ref: string;
+        bundle_digest: string;
+        node_ref: string;
+        artifact_ref: string;
+        section_refs: string[];
+        material_state: "blocked" | "ready";
+    }, {
+        kind: "logical-unit";
+        artifact_kind: string;
+        artifact_id: string;
+        purpose: "required" | "discretionary" | "semantic-split";
+        split_of: string | null;
+        logical_unit_ref: string;
+        bundle_digest: string;
+        node_ref: string;
+        artifact_ref: string;
+        section_refs: string[];
+        material_state: "blocked" | "ready";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"navigation">;
+        navigation_ref: z.ZodString;
+        artifact_ref: z.ZodString;
+        artifact_id: z.ZodEffects<z.ZodString, string, string>;
+        artifact_kind: z.ZodEffects<z.ZodString, string, string>;
+        plan_digest: z.ZodString;
+        child_artifact_refs: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "navigation";
+        artifact_kind: string;
+        artifact_id: string;
+        plan_digest: string;
+        artifact_ref: string;
+        navigation_ref: string;
+        child_artifact_refs: string[];
+    }, {
+        kind: "navigation";
+        artifact_kind: string;
+        artifact_id: string;
+        plan_digest: string;
+        artifact_ref: string;
+        navigation_ref: string;
+        child_artifact_refs: string[];
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"orphan">;
+        reason: z.ZodLiteral<"unregistered-output-path">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "orphan";
+        reason: "unregistered-output-path";
+    }, {
+        kind: "orphan";
+        reason: "unregistered-output-path";
+    }>]>;
+}, "strict", z.ZodTypeAny, {
+    empty: boolean;
+    output_path: string;
+    owner: {
+        kind: "logical-unit";
+        artifact_kind: string;
+        artifact_id: string;
+        purpose: "required" | "discretionary" | "semantic-split";
+        split_of: string | null;
+        logical_unit_ref: string;
+        bundle_digest: string;
+        node_ref: string;
+        artifact_ref: string;
+        section_refs: string[];
+        material_state: "blocked" | "ready";
+    } | {
+        kind: "navigation";
+        artifact_kind: string;
+        artifact_id: string;
+        plan_digest: string;
+        artifact_ref: string;
+        navigation_ref: string;
+        child_artifact_refs: string[];
+    } | {
+        kind: "orphan";
+        reason: "unregistered-output-path";
+    };
+    physical_ref: string;
+    markdown_digest: string;
+    byte_count: number;
+    reader_body_line_count: number;
+}, {
+    empty: boolean;
+    output_path: string;
+    owner: {
+        kind: "logical-unit";
+        artifact_kind: string;
+        artifact_id: string;
+        purpose: "required" | "discretionary" | "semantic-split";
+        split_of: string | null;
+        logical_unit_ref: string;
+        bundle_digest: string;
+        node_ref: string;
+        artifact_ref: string;
+        section_refs: string[];
+        material_state: "blocked" | "ready";
+    } | {
+        kind: "navigation";
+        artifact_kind: string;
+        artifact_id: string;
+        plan_digest: string;
+        artifact_ref: string;
+        navigation_ref: string;
+        child_artifact_refs: string[];
+    } | {
+        kind: "orphan";
+        reason: "unregistered-output-path";
+    };
+    physical_ref: string;
+    markdown_digest: string;
+    byte_count: number;
+    reader_body_line_count: number;
+}>;
+export declare const indexerArtifactManifestSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.artifact-manifest/v1">;
+    layout_proposal_set_digest: z.ZodString;
+    files: z.ZodArray<z.ZodObject<{
+        physical_ref: z.ZodString;
+        output_path: z.ZodEffects<z.ZodString, string, string>;
+        markdown_digest: z.ZodString;
+        byte_count: z.ZodNumber;
+        reader_body_line_count: z.ZodNumber;
+        empty: z.ZodBoolean;
+        owner: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"logical-unit">;
+            logical_unit_ref: z.ZodString;
+            node_ref: z.ZodString;
+            artifact_ref: z.ZodString;
+            artifact_id: z.ZodEffects<z.ZodString, string, string>;
+            artifact_kind: z.ZodEffects<z.ZodString, string, string>;
+            bundle_digest: z.ZodString;
+            purpose: z.ZodEnum<["required", "discretionary", "semantic-split"]>;
+            split_of: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+            section_refs: z.ZodArray<z.ZodString, "many">;
+            material_state: z.ZodEnum<["ready", "blocked"]>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "logical-unit";
+            artifact_kind: string;
+            artifact_id: string;
+            purpose: "required" | "discretionary" | "semantic-split";
+            split_of: string | null;
+            logical_unit_ref: string;
+            bundle_digest: string;
+            node_ref: string;
+            artifact_ref: string;
+            section_refs: string[];
+            material_state: "blocked" | "ready";
+        }, {
+            kind: "logical-unit";
+            artifact_kind: string;
+            artifact_id: string;
+            purpose: "required" | "discretionary" | "semantic-split";
+            split_of: string | null;
+            logical_unit_ref: string;
+            bundle_digest: string;
+            node_ref: string;
+            artifact_ref: string;
+            section_refs: string[];
+            material_state: "blocked" | "ready";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"navigation">;
+            navigation_ref: z.ZodString;
+            artifact_ref: z.ZodString;
+            artifact_id: z.ZodEffects<z.ZodString, string, string>;
+            artifact_kind: z.ZodEffects<z.ZodString, string, string>;
+            plan_digest: z.ZodString;
+            child_artifact_refs: z.ZodArray<z.ZodString, "many">;
+        }, "strict", z.ZodTypeAny, {
+            kind: "navigation";
+            artifact_kind: string;
+            artifact_id: string;
+            plan_digest: string;
+            artifact_ref: string;
+            navigation_ref: string;
+            child_artifact_refs: string[];
+        }, {
+            kind: "navigation";
+            artifact_kind: string;
+            artifact_id: string;
+            plan_digest: string;
+            artifact_ref: string;
+            navigation_ref: string;
+            child_artifact_refs: string[];
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"orphan">;
+            reason: z.ZodLiteral<"unregistered-output-path">;
+        }, "strict", z.ZodTypeAny, {
+            kind: "orphan";
+            reason: "unregistered-output-path";
+        }, {
+            kind: "orphan";
+            reason: "unregistered-output-path";
+        }>]>;
+    }, "strict", z.ZodTypeAny, {
+        empty: boolean;
+        output_path: string;
+        owner: {
+            kind: "logical-unit";
+            artifact_kind: string;
+            artifact_id: string;
+            purpose: "required" | "discretionary" | "semantic-split";
+            split_of: string | null;
+            logical_unit_ref: string;
+            bundle_digest: string;
+            node_ref: string;
+            artifact_ref: string;
+            section_refs: string[];
+            material_state: "blocked" | "ready";
+        } | {
+            kind: "navigation";
+            artifact_kind: string;
+            artifact_id: string;
+            plan_digest: string;
+            artifact_ref: string;
+            navigation_ref: string;
+            child_artifact_refs: string[];
+        } | {
+            kind: "orphan";
+            reason: "unregistered-output-path";
+        };
+        physical_ref: string;
+        markdown_digest: string;
+        byte_count: number;
+        reader_body_line_count: number;
+    }, {
+        empty: boolean;
+        output_path: string;
+        owner: {
+            kind: "logical-unit";
+            artifact_kind: string;
+            artifact_id: string;
+            purpose: "required" | "discretionary" | "semantic-split";
+            split_of: string | null;
+            logical_unit_ref: string;
+            bundle_digest: string;
+            node_ref: string;
+            artifact_ref: string;
+            section_refs: string[];
+            material_state: "blocked" | "ready";
+        } | {
+            kind: "navigation";
+            artifact_kind: string;
+            artifact_id: string;
+            plan_digest: string;
+            artifact_ref: string;
+            navigation_ref: string;
+            child_artifact_refs: string[];
+        } | {
+            kind: "orphan";
+            reason: "unregistered-output-path";
+        };
+        physical_ref: string;
+        markdown_digest: string;
+        byte_count: number;
+        reader_body_line_count: number;
+    }>, "many">;
+} & {
+    manifest_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.artifact-manifest/v1";
+    files: {
+        empty: boolean;
+        output_path: string;
+        owner: {
+            kind: "logical-unit";
+            artifact_kind: string;
+            artifact_id: string;
+            purpose: "required" | "discretionary" | "semantic-split";
+            split_of: string | null;
+            logical_unit_ref: string;
+            bundle_digest: string;
+            node_ref: string;
+            artifact_ref: string;
+            section_refs: string[];
+            material_state: "blocked" | "ready";
+        } | {
+            kind: "navigation";
+            artifact_kind: string;
+            artifact_id: string;
+            plan_digest: string;
+            artifact_ref: string;
+            navigation_ref: string;
+            child_artifact_refs: string[];
+        } | {
+            kind: "orphan";
+            reason: "unregistered-output-path";
+        };
+        physical_ref: string;
+        markdown_digest: string;
+        byte_count: number;
+        reader_body_line_count: number;
+    }[];
+    manifest_digest: string;
+    layout_proposal_set_digest: string;
+}, {
+    protocol: "context.indexer.artifact-manifest/v1";
+    files: {
+        empty: boolean;
+        output_path: string;
+        owner: {
+            kind: "logical-unit";
+            artifact_kind: string;
+            artifact_id: string;
+            purpose: "required" | "discretionary" | "semantic-split";
+            split_of: string | null;
+            logical_unit_ref: string;
+            bundle_digest: string;
+            node_ref: string;
+            artifact_ref: string;
+            section_refs: string[];
+            material_state: "blocked" | "ready";
+        } | {
+            kind: "navigation";
+            artifact_kind: string;
+            artifact_id: string;
+            plan_digest: string;
+            artifact_ref: string;
+            navigation_ref: string;
+            child_artifact_refs: string[];
+        } | {
+            kind: "orphan";
+            reason: "unregistered-output-path";
+        };
+        physical_ref: string;
+        markdown_digest: string;
+        byte_count: number;
+        reader_body_line_count: number;
+    }[];
+    manifest_digest: string;
+    layout_proposal_set_digest: string;
+}>;
+export type IndexerPhysicalArtifactOwner = z.infer<typeof indexerPhysicalArtifactOwnerSchema>;
+export type IndexerPhysicalArtifactManifestEntry = z.infer<typeof physicalArtifactManifestEntrySchema>;
+export type IndexerArtifactManifest = z.infer<typeof indexerArtifactManifestSchema>;
+export interface IndexerPhysicalArtifactRegistration {
+    output_path: string;
+    owner: Exclude<IndexerPhysicalArtifactOwner, {
+        kind: "orphan";
+    }>;
+}
+export interface IndexerPhysicalArtifactFileInput {
+    output_path: string;
+    markdown: string;
+}
+export declare function buildIndexerArtifactManifest(input: {
+    layout_proposal_set_digest: string;
+    registrations: readonly IndexerPhysicalArtifactRegistration[];
+    files: readonly IndexerPhysicalArtifactFileInput[];
+}): IndexerArtifactManifest;
+export declare function validateIndexerArtifactManifest(value: unknown): IndexerArtifactManifest;
+export {};