@c4a/context 0.6.19 → 0.7.0

package/indexerCollectionMapping.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { type IndexerArtifactSectionProjection } from "./indexerArtifactResult.js";
+export declare const indexerKnowledgeCollectionSchema: z.ZodType<import("./contracts.js").TopLevelNamespace, z.ZodTypeDef, import("./contracts.js").TopLevelNamespace>;
+export declare const indexerSectionCollectionSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.section-collection/v1">;
+    profile: z.ZodEffects<z.ZodString, string, string>;
+    source_role: z.ZodEffects<z.ZodString, string, string>;
+    projection: 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>;
+    }, "strict", z.ZodTypeAny, {
+        artifact_kind: string;
+        document_kind: string;
+        reader_goal: string;
+        section_key: string;
+        owner_indexer_id: string;
+    }, {
+        artifact_kind: string;
+        document_kind: string;
+        reader_goal: string;
+        section_key: string;
+        owner_indexer_id: string;
+    }>;
+    collection: z.ZodType<import("./contracts.js").TopLevelNamespace, z.ZodTypeDef, import("./contracts.js").TopLevelNamespace>;
+    profile_contract_digest: z.ZodString;
+    mapping_digest: z.ZodString;
+} & {
+    resolution_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.section-collection/v1";
+    collection: import("./contracts.js").TopLevelNamespace;
+    profile: string;
+    mapping_digest: string;
+    profile_contract_digest: string;
+    source_role: string;
+    resolution_digest: string;
+    projection: {
+        artifact_kind: string;
+        document_kind: string;
+        reader_goal: string;
+        section_key: string;
+        owner_indexer_id: string;
+    };
+}, {
+    protocol: "context.indexer.section-collection/v1";
+    collection: import("./contracts.js").TopLevelNamespace;
+    profile: string;
+    mapping_digest: string;
+    profile_contract_digest: string;
+    source_role: string;
+    resolution_digest: string;
+    projection: {
+        artifact_kind: string;
+        document_kind: string;
+        reader_goal: string;
+        section_key: string;
+        owner_indexer_id: string;
+    };
+}>;
+export type IndexerSectionCollection = z.infer<typeof indexerSectionCollectionSchema>;
+export declare function resolveIndexerSectionCollection(input: {
+    profile: string;
+    source_role: string;
+    projection: IndexerArtifactSectionProjection;
+    profile_contract: unknown;
+    operator_contract: unknown;
+}): IndexerSectionCollection;
+export declare function validateIndexerSectionCollection(input: {
+    value: unknown;
+    profile_contract: unknown;
+    operator_contract: unknown;
+}): IndexerSectionCollection;

package/indexerContentLayers.d.ts

@@ -0,0 +1,137 @@
+import { z } from "zod";
+import type { IndexerJson } from "./indexerRegistry.js";
+export declare const indexerCanonicalJsonSchema: z.ZodType<IndexerJson>;
+export declare const indexerArtifactFactSchema: z.ZodObject<{
+    fact_ref: z.ZodString;
+    fact_kind: z.ZodEffects<z.ZodString, string, string>;
+    subject_key: z.ZodObject<{
+        protocol: z.ZodLiteral<"context.subject-key/v1">;
+        namespace: z.ZodEffects<z.ZodString, string, string>;
+        kind: z.ZodEffects<z.ZodString, string, string>;
+        local_key: z.ZodEffects<z.ZodString, string, string>;
+    }, "strict", z.ZodTypeAny, {
+        kind: string;
+        protocol: "context.subject-key/v1";
+        namespace: string;
+        local_key: string;
+    }, {
+        kind: string;
+        protocol: "context.subject-key/v1";
+        namespace: string;
+        local_key: string;
+    }>;
+    value: z.ZodType<IndexerJson, z.ZodTypeDef, IndexerJson>;
+    evidence_refs: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    value: IndexerJson;
+    evidence_refs: string[];
+    fact_ref: string;
+    fact_kind: string;
+    subject_key: {
+        kind: string;
+        protocol: "context.subject-key/v1";
+        namespace: string;
+        local_key: string;
+    };
+}, {
+    value: IndexerJson;
+    evidence_refs: string[];
+    fact_ref: string;
+    fact_kind: string;
+    subject_key: {
+        kind: string;
+        protocol: "context.subject-key/v1";
+        namespace: string;
+        local_key: string;
+    };
+}>;
+export declare const indexerDeterministicBlockRendererSchema: z.ZodEnum<["bullet-list", "key-value-table", "json-code-block"]>;
+export declare const indexerArtifactContentBlockSchema: z.ZodDiscriminatedUnion<"layer", [z.ZodObject<{
+    block_id: z.ZodEffects<z.ZodString, string, string>;
+    layer: z.ZodLiteral<"deterministic-block">;
+    renderer: z.ZodEnum<["bullet-list", "key-value-table", "json-code-block"]>;
+    fact_refs: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    block_id: string;
+    layer: "deterministic-block";
+    renderer: "bullet-list" | "key-value-table" | "json-code-block";
+    fact_refs: string[];
+}, {
+    block_id: string;
+    layer: "deterministic-block";
+    renderer: "bullet-list" | "key-value-table" | "json-code-block";
+    fact_refs: string[];
+}>, z.ZodObject<{
+    block_id: z.ZodEffects<z.ZodString, string, string>;
+    layer: z.ZodLiteral<"semantic-prose">;
+    markdown: z.ZodString;
+    evidence_refs: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    evidence_refs: string[];
+    block_id: string;
+    layer: "semantic-prose";
+    markdown: string;
+}, {
+    evidence_refs: string[];
+    block_id: string;
+    layer: "semantic-prose";
+    markdown: string;
+}>]>;
+declare const renderedContentBlockPayloadSchema: 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">;
+}, "strict", z.ZodTypeAny, {
+    evidence_refs: string[];
+    layer: "deterministic-block" | "semantic-prose";
+    fact_refs: string[];
+    markdown: string;
+}, {
+    evidence_refs: string[];
+    layer: "deterministic-block" | "semantic-prose";
+    fact_refs: string[];
+    markdown: string;
+}>;
+export declare const indexerRenderedContentBlockSchema: 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;
+}>;
+export type IndexerArtifactFact = z.infer<typeof indexerArtifactFactSchema>;
+export type IndexerArtifactContentBlock = z.infer<typeof indexerArtifactContentBlockSchema>;
+export type IndexerDeterministicBlockRenderer = z.infer<typeof indexerDeterministicBlockRendererSchema>;
+export type IndexerRenderedContentBlock = z.infer<typeof indexerRenderedContentBlockSchema>;
+export declare function projectIndexerFactValue(facts: readonly IndexerArtifactFact[]): IndexerJson;
+export declare function renderIndexerDeterministicFacts(input: {
+    renderer: IndexerDeterministicBlockRenderer;
+    facts: readonly IndexerArtifactFact[];
+}): string;
+export declare function indexerRenderedContentBlockDigest(value: z.infer<typeof renderedContentBlockPayloadSchema>): string;
+export declare function buildIndexerRenderedContentBlock(input: {
+    layer: "deterministic-block" | "semantic-prose";
+    markdown: string;
+    fact_refs?: readonly string[];
+    evidence_refs?: readonly string[];
+}): IndexerRenderedContentBlock;
+export declare function validateIndexerRenderedContentBlock(value: unknown): IndexerRenderedContentBlock;
+export declare function materializeIndexerStructuredContent(input: {
+    blocks: readonly IndexerArtifactContentBlock[];
+    facts: readonly IndexerArtifactFact[];
+}): IndexerRenderedContentBlock[];
+export {};