@c4a/context 0.6.18 → 0.7.0

package/indexerTemplateRendering.d.ts

@@ -0,0 +1,485 @@
+import { z } from "zod";
+export declare const indexerTemplateContractSchema: z.ZodEffects<z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.template/v1">;
+    template_id: z.ZodEffects<z.ZodString, string, string>;
+    profile: z.ZodEffects<z.ZodString, string, string>;
+    reader_goal: z.ZodEffects<z.ZodString, string, string>;
+    applicability: z.ZodObject<{
+        artifact_policy_variants: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        condition_refs: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        artifact_policy_variants: string[];
+        condition_refs: string[];
+    }, {
+        artifact_policy_variants: string[];
+        condition_refs: string[];
+    }>;
+    variables: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        type: z.ZodEnum<["string", "string-list", "string-map", "number", "boolean", "json"]>;
+        content_layer: z.ZodEnum<["deterministic-fact", "semantic-prose"]>;
+        required: z.ZodBoolean;
+        evidence_required: z.ZodBoolean;
+        maximum_length: z.ZodOptional<z.ZodNumber>;
+        maximum_items: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        type: "string" | "number" | "boolean" | "string-list" | "string-map" | "json";
+        required: boolean;
+        content_layer: "semantic-prose" | "deterministic-fact";
+        evidence_required: boolean;
+        maximum_length?: number | undefined;
+        maximum_items?: number | undefined;
+    }, {
+        id: string;
+        type: "string" | "number" | "boolean" | "string-list" | "string-map" | "json";
+        required: boolean;
+        content_layer: "semantic-prose" | "deterministic-fact";
+        evidence_required: boolean;
+        maximum_length?: number | undefined;
+        maximum_items?: number | undefined;
+    }>, {
+        id: string;
+        type: "string" | "number" | "boolean" | "string-list" | "string-map" | "json";
+        required: boolean;
+        content_layer: "semantic-prose" | "deterministic-fact";
+        evidence_required: boolean;
+        maximum_length?: number | undefined;
+        maximum_items?: number | undefined;
+    }, {
+        id: string;
+        type: "string" | "number" | "boolean" | "string-list" | "string-map" | "json";
+        required: boolean;
+        content_layer: "semantic-prose" | "deterministic-fact";
+        evidence_required: boolean;
+        maximum_length?: number | undefined;
+        maximum_items?: number | undefined;
+    }>, "many">;
+    deterministic_blocks: z.ZodArray<z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        renderer: z.ZodEnum<["bullet-list", "key-value-table", "json-code-block"]>;
+        source_variable_id: z.ZodEffects<z.ZodString, string, string>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        source_variable_id: string;
+    }, {
+        id: string;
+        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        source_variable_id: string;
+    }>, "many">;
+    sections: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        section_key: z.ZodEffects<z.ZodString, string, string>;
+        presence: z.ZodEnum<["required", "optional"]>;
+        question_ref: z.ZodString;
+        reader_goal: z.ZodEffects<z.ZodString, string, string>;
+        variable_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        deterministic_block_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        accepted_evidence_kinds: z.ZodArray<z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>, "many">;
+        minimum_evidence_items: z.ZodNumber;
+        on_missing: z.ZodEnum<["request-input", "omit"]>;
+        deletion_condition: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        reader_goal: string;
+        section_key: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        accepted_evidence_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_evidence_items: number;
+        on_missing: "request-input" | "omit";
+        deletion_condition: string;
+    }, {
+        reader_goal: string;
+        section_key: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        accepted_evidence_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_evidence_items: number;
+        on_missing: "request-input" | "omit";
+        deletion_condition: string;
+    }>, {
+        reader_goal: string;
+        section_key: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        accepted_evidence_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_evidence_items: number;
+        on_missing: "request-input" | "omit";
+        deletion_condition: string;
+    }, {
+        reader_goal: string;
+        section_key: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        accepted_evidence_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_evidence_items: number;
+        on_missing: "request-input" | "omit";
+        deletion_condition: string;
+    }>, "many">;
+    page_policy: z.ZodObject<{
+        split_suggestion: z.ZodString;
+        semantic_boundaries: z.ZodArray<z.ZodString, "many">;
+        keep_single_page_conditions: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        split_suggestion: string;
+        semantic_boundaries: string[];
+        keep_single_page_conditions: string[];
+    }, {
+        split_suggestion: string;
+        semantic_boundaries: string[];
+        keep_single_page_conditions: string[];
+    }>;
+    anonymous_section_examples: z.ZodArray<z.ZodString, "many">;
+    anti_examples: z.ZodArray<z.ZodString, "many">;
+    forbidden_outputs: z.ZodArray<z.ZodString, "many">;
+    maximum_rendered_bytes: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.template/v1";
+    profile: string;
+    template_id: string;
+    variables: {
+        id: string;
+        type: "string" | "number" | "boolean" | "string-list" | "string-map" | "json";
+        required: boolean;
+        content_layer: "semantic-prose" | "deterministic-fact";
+        evidence_required: boolean;
+        maximum_length?: number | undefined;
+        maximum_items?: number | undefined;
+    }[];
+    reader_goal: string;
+    sections: {
+        reader_goal: string;
+        section_key: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        accepted_evidence_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_evidence_items: number;
+        on_missing: "request-input" | "omit";
+        deletion_condition: string;
+    }[];
+    applicability: {
+        artifact_policy_variants: string[];
+        condition_refs: string[];
+    };
+    deterministic_blocks: {
+        id: string;
+        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        source_variable_id: string;
+    }[];
+    page_policy: {
+        split_suggestion: string;
+        semantic_boundaries: string[];
+        keep_single_page_conditions: string[];
+    };
+    anonymous_section_examples: string[];
+    anti_examples: string[];
+    forbidden_outputs: string[];
+    maximum_rendered_bytes: number;
+}, {
+    protocol: "context.indexer.template/v1";
+    profile: string;
+    template_id: string;
+    variables: {
+        id: string;
+        type: "string" | "number" | "boolean" | "string-list" | "string-map" | "json";
+        required: boolean;
+        content_layer: "semantic-prose" | "deterministic-fact";
+        evidence_required: boolean;
+        maximum_length?: number | undefined;
+        maximum_items?: number | undefined;
+    }[];
+    reader_goal: string;
+    sections: {
+        reader_goal: string;
+        section_key: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        accepted_evidence_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_evidence_items: number;
+        on_missing: "request-input" | "omit";
+        deletion_condition: string;
+    }[];
+    applicability: {
+        artifact_policy_variants: string[];
+        condition_refs: string[];
+    };
+    deterministic_blocks: {
+        id: string;
+        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        source_variable_id: string;
+    }[];
+    page_policy: {
+        split_suggestion: string;
+        semantic_boundaries: string[];
+        keep_single_page_conditions: string[];
+    };
+    anonymous_section_examples: string[];
+    anti_examples: string[];
+    forbidden_outputs: string[];
+    maximum_rendered_bytes: number;
+}>, {
+    protocol: "context.indexer.template/v1";
+    profile: string;
+    template_id: string;
+    variables: {
+        id: string;
+        type: "string" | "number" | "boolean" | "string-list" | "string-map" | "json";
+        required: boolean;
+        content_layer: "semantic-prose" | "deterministic-fact";
+        evidence_required: boolean;
+        maximum_length?: number | undefined;
+        maximum_items?: number | undefined;
+    }[];
+    reader_goal: string;
+    sections: {
+        reader_goal: string;
+        section_key: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        accepted_evidence_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_evidence_items: number;
+        on_missing: "request-input" | "omit";
+        deletion_condition: string;
+    }[];
+    applicability: {
+        artifact_policy_variants: string[];
+        condition_refs: string[];
+    };
+    deterministic_blocks: {
+        id: string;
+        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        source_variable_id: string;
+    }[];
+    page_policy: {
+        split_suggestion: string;
+        semantic_boundaries: string[];
+        keep_single_page_conditions: string[];
+    };
+    anonymous_section_examples: string[];
+    anti_examples: string[];
+    forbidden_outputs: string[];
+    maximum_rendered_bytes: number;
+}, {
+    protocol: "context.indexer.template/v1";
+    profile: string;
+    template_id: string;
+    variables: {
+        id: string;
+        type: "string" | "number" | "boolean" | "string-list" | "string-map" | "json";
+        required: boolean;
+        content_layer: "semantic-prose" | "deterministic-fact";
+        evidence_required: boolean;
+        maximum_length?: number | undefined;
+        maximum_items?: number | undefined;
+    }[];
+    reader_goal: string;
+    sections: {
+        reader_goal: string;
+        section_key: string;
+        question_ref: string;
+        presence: "required" | "optional";
+        variable_ids: string[];
+        deterministic_block_ids: string[];
+        accepted_evidence_kinds: ("contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot")[];
+        minimum_evidence_items: number;
+        on_missing: "request-input" | "omit";
+        deletion_condition: string;
+    }[];
+    applicability: {
+        artifact_policy_variants: string[];
+        condition_refs: string[];
+    };
+    deterministic_blocks: {
+        id: string;
+        renderer: "bullet-list" | "key-value-table" | "json-code-block";
+        source_variable_id: string;
+    }[];
+    page_policy: {
+        split_suggestion: string;
+        semantic_boundaries: string[];
+        keep_single_page_conditions: string[];
+    };
+    anonymous_section_examples: string[];
+    anti_examples: string[];
+    forbidden_outputs: string[];
+    maximum_rendered_bytes: number;
+}>;
+export declare const indexerRenderedArtifactSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.rendered-artifact/v1">;
+    artifact_result_digest: z.ZodString;
+    artifact_id: z.ZodEffects<z.ZodString, string, string>;
+    artifact_kind: z.ZodEffects<z.ZodString, string, string>;
+    artifact_policy_variant: z.ZodEffects<z.ZodString, string, string>;
+    template_id: z.ZodEffects<z.ZodString, string, string>;
+    profile: z.ZodEffects<z.ZodString, string, string>;
+    template_digest: z.ZodString;
+    template_origin: z.ZodEnum<["provider", "customization-override"]>;
+    sections: z.ZodArray<z.ZodObject<{
+        section_key: z.ZodEffects<z.ZodString, string, string>;
+        owner_indexer_id: z.ZodEffects<z.ZodString, string, string>;
+        document_kind: z.ZodEffects<z.ZodString, string, string>;
+        reader_goal: z.ZodEffects<z.ZodString, string, string>;
+        artifact_kind: z.ZodEffects<z.ZodString, string, string>;
+        markdown: z.ZodString;
+        content_blocks: z.ZodArray<z.ZodObject<{
+            layer: z.ZodEnum<["deterministic-block", "semantic-prose"]>;
+            markdown: z.ZodString;
+            fact_refs: z.ZodArray<z.ZodString, "many">;
+            evidence_refs: z.ZodArray<z.ZodString, "many">;
+        } & {
+            content_digest: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            evidence_refs: string[];
+            content_digest: string;
+            layer: "deterministic-block" | "semantic-prose";
+            fact_refs: string[];
+            markdown: string;
+        }, {
+            evidence_refs: string[];
+            content_digest: string;
+            layer: "deterministic-block" | "semantic-prose";
+            fact_refs: string[];
+            markdown: string;
+        }>, "many">;
+        evidence_refs: z.ZodArray<z.ZodString, "many">;
+        content_digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        evidence_refs: string[];
+        artifact_kind: string;
+        document_kind: string;
+        reader_goal: string;
+        content_digest: string;
+        markdown: string;
+        section_key: string;
+        owner_indexer_id: string;
+        content_blocks: {
+            evidence_refs: string[];
+            content_digest: string;
+            layer: "deterministic-block" | "semantic-prose";
+            fact_refs: string[];
+            markdown: string;
+        }[];
+    }, {
+        evidence_refs: string[];
+        artifact_kind: string;
+        document_kind: string;
+        reader_goal: string;
+        content_digest: string;
+        markdown: string;
+        section_key: string;
+        owner_indexer_id: string;
+        content_blocks: {
+            evidence_refs: string[];
+            content_digest: string;
+            layer: "deterministic-block" | "semantic-prose";
+            fact_refs: string[];
+            markdown: string;
+        }[];
+    }>, "many">;
+    material_question_gaps: z.ZodArray<z.ZodObject<{
+        section_key: z.ZodEffects<z.ZodString, string, string>;
+        question_ref: z.ZodString;
+        question_target_key: z.ZodString;
+        material_question_proposal_ref: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        section_key: string;
+        material_question_proposal_ref: string;
+        question_ref: string;
+        question_target_key: string;
+    }, {
+        section_key: string;
+        material_question_proposal_ref: string;
+        question_ref: string;
+        question_target_key: string;
+    }>, "many">;
+    review_ready: z.ZodBoolean;
+    rendered_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.rendered-artifact/v1";
+    profile: string;
+    template_id: string;
+    artifact_kind: string;
+    artifact_policy_variant: string;
+    artifact_id: string;
+    artifact_result_digest: string;
+    sections: {
+        evidence_refs: string[];
+        artifact_kind: string;
+        document_kind: string;
+        reader_goal: string;
+        content_digest: string;
+        markdown: string;
+        section_key: string;
+        owner_indexer_id: string;
+        content_blocks: {
+            evidence_refs: string[];
+            content_digest: string;
+            layer: "deterministic-block" | "semantic-prose";
+            fact_refs: string[];
+            markdown: string;
+        }[];
+    }[];
+    template_digest: string;
+    template_origin: "provider" | "customization-override";
+    material_question_gaps: {
+        section_key: string;
+        material_question_proposal_ref: string;
+        question_ref: string;
+        question_target_key: string;
+    }[];
+    review_ready: boolean;
+    rendered_digest: string;
+}, {
+    protocol: "context.indexer.rendered-artifact/v1";
+    profile: string;
+    template_id: string;
+    artifact_kind: string;
+    artifact_policy_variant: string;
+    artifact_id: string;
+    artifact_result_digest: string;
+    sections: {
+        evidence_refs: string[];
+        artifact_kind: string;
+        document_kind: string;
+        reader_goal: string;
+        content_digest: string;
+        markdown: string;
+        section_key: string;
+        owner_indexer_id: string;
+        content_blocks: {
+            evidence_refs: string[];
+            content_digest: string;
+            layer: "deterministic-block" | "semantic-prose";
+            fact_refs: string[];
+            markdown: string;
+        }[];
+    }[];
+    template_digest: string;
+    template_origin: "provider" | "customization-override";
+    material_question_gaps: {
+        section_key: string;
+        material_question_proposal_ref: string;
+        question_ref: string;
+        question_target_key: string;
+    }[];
+    review_ready: boolean;
+    rendered_digest: string;
+}>;
+export type IndexerTemplateContract = z.infer<typeof indexerTemplateContractSchema>;
+export type IndexerRenderedArtifact = z.infer<typeof indexerRenderedArtifactSchema>;
+export declare function indexerRenderedArtifactDigest(value: Omit<IndexerRenderedArtifact, "rendered_digest">): string;
+export declare function validateIndexerRenderedArtifact(value: unknown): IndexerRenderedArtifact;