@c4a/context 0.7.8 → 0.7.10-alpha.1

package/indexerExampleFactDependencies.d.ts

@@ -1,17 +0,0 @@
-import type { IndexerArtifactResult } from "./indexerArtifactResult.js";
-import { type IndexerAuthorDependencyView } from "./indexerDependencyView.js";
-import type { IndexerMainAuthorWorkset } from "./indexerMainWorkset.js";
-/** An Agent can identify a scenario in supplied source. This only attests its
- * source coordinates and identity; it does not verify the example's behavior. */
-export declare function exampleFactDependencies(input: {
-    workset: IndexerMainAuthorWorkset;
-    dependency_view: IndexerAuthorDependencyView;
-    result: IndexerArtifactResult;
-}): {
-    node_ref: string;
-    kind: "selected-fact";
-    fact_ref: string;
-    fact_digest: string;
-    source_span_node_refs: string[];
-    targets: never[];
-}[];

package/indexerIncrementalImpact.d.ts

@@ -1,221 +0,0 @@
-import { z } from "zod";
-export declare const indexerIncrementalImpactReportSchema: z.ZodObject<{
-    protocol: z.ZodLiteral<"context.indexer.incremental-impact-report/v1">;
-    indexer_id: z.ZodEffects<z.ZodString, string, string>;
-    logical_unit_ref: z.ZodString;
-    previous_run_envelope_digest: z.ZodString;
-    current_run_envelope_digest: z.ZodString;
-    previous_dependency_view_digest: z.ZodString;
-    current_dependency_view_digest: z.ZodString;
-    previous_dependency_set_digest: z.ZodString;
-    envelope_changes: z.ZodArray<z.ZodObject<{
-        field: z.ZodString;
-        previous_value: z.ZodNullable<z.ZodString>;
-        current_value: z.ZodNullable<z.ZodString>;
-    }, "strict", z.ZodTypeAny, {
-        field: string;
-        previous_value: string | null;
-        current_value: string | null;
-    }, {
-        field: string;
-        previous_value: string | null;
-        current_value: string | null;
-    }>, "many">;
-    dependency_changes: z.ZodArray<z.ZodObject<{
-        node_ref: z.ZodString;
-        polarity: z.ZodEnum<["positive", "negative"]>;
-        kind: z.ZodString;
-        change: z.ZodEnum<["added", "removed", "changed"]>;
-        previous_dependency_ref: z.ZodNullable<z.ZodString>;
-        current_dependency_ref: z.ZodNullable<z.ZodString>;
-        affected_artifact_ids: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
-        affected_sections: z.ZodArray<z.ZodObject<{
-            artifact_id: z.ZodEffects<z.ZodString, string, string>;
-            section_key: z.ZodEffects<z.ZodString, string, string>;
-        }, "strict", z.ZodTypeAny, {
-            section_key: string;
-            artifact_id: string;
-        }, {
-            section_key: string;
-            artifact_id: string;
-        }>, "many">;
-    }, "strict", z.ZodTypeAny, {
-        kind: string;
-        node_ref: string;
-        polarity: "positive" | "negative";
-        change: "changed" | "added" | "removed";
-        previous_dependency_ref: string | null;
-        current_dependency_ref: string | null;
-        affected_artifact_ids: string[];
-        affected_sections: {
-            section_key: string;
-            artifact_id: string;
-        }[];
-    }, {
-        kind: string;
-        node_ref: string;
-        polarity: "positive" | "negative";
-        change: "changed" | "added" | "removed";
-        previous_dependency_ref: string | null;
-        current_dependency_ref: string | null;
-        affected_artifact_ids: string[];
-        affected_sections: {
-            section_key: string;
-            artifact_id: string;
-        }[];
-    }>, "many">;
-    artifacts: z.ZodArray<z.ZodObject<{
-        artifact_id: z.ZodEffects<z.ZodString, string, string>;
-        artifact_kind: z.ZodEffects<z.ZodString, string, string>;
-        state: z.ZodEnum<["current", "stale"]>;
-        changed_node_refs: z.ZodArray<z.ZodString, "many">;
-        sections: z.ZodArray<z.ZodObject<{
-            section_key: z.ZodEffects<z.ZodString, string, string>;
-            state: z.ZodEnum<["current", "stale"]>;
-            changed_node_refs: z.ZodArray<z.ZodString, "many">;
-        }, "strict", z.ZodTypeAny, {
-            section_key: string;
-            state: "current" | "stale";
-            changed_node_refs: string[];
-        }, {
-            section_key: string;
-            state: "current" | "stale";
-            changed_node_refs: string[];
-        }>, "many">;
-    }, "strict", z.ZodTypeAny, {
-        artifact_kind: string;
-        artifact_id: string;
-        sections: {
-            section_key: string;
-            state: "current" | "stale";
-            changed_node_refs: string[];
-        }[];
-        state: "current" | "stale";
-        changed_node_refs: string[];
-    }, {
-        artifact_kind: string;
-        artifact_id: string;
-        sections: {
-            section_key: string;
-            state: "current" | "stale";
-            changed_node_refs: string[];
-        }[];
-        state: "current" | "stale";
-        changed_node_refs: string[];
-    }>, "many">;
-    logical_unit_state: z.ZodEnum<["current", "stale"]>;
-    current_artifact_count: z.ZodNumber;
-    stale_artifact_count: z.ZodNumber;
-    current_section_count: z.ZodNumber;
-    stale_section_count: z.ZodNumber;
-    recompute_scope: z.ZodEnum<["none", "artifact-sections", "logical-unit-empty"]>;
-} & {
-    report_digest: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    protocol: "context.indexer.incremental-impact-report/v1";
-    artifacts: {
-        artifact_kind: string;
-        artifact_id: string;
-        sections: {
-            section_key: string;
-            state: "current" | "stale";
-            changed_node_refs: string[];
-        }[];
-        state: "current" | "stale";
-        changed_node_refs: string[];
-    }[];
-    indexer_id: string;
-    report_digest: string;
-    logical_unit_ref: string;
-    previous_run_envelope_digest: string;
-    current_run_envelope_digest: string;
-    previous_dependency_view_digest: string;
-    current_dependency_view_digest: string;
-    previous_dependency_set_digest: string;
-    envelope_changes: {
-        field: string;
-        previous_value: string | null;
-        current_value: string | null;
-    }[];
-    dependency_changes: {
-        kind: string;
-        node_ref: string;
-        polarity: "positive" | "negative";
-        change: "changed" | "added" | "removed";
-        previous_dependency_ref: string | null;
-        current_dependency_ref: string | null;
-        affected_artifact_ids: string[];
-        affected_sections: {
-            section_key: string;
-            artifact_id: string;
-        }[];
-    }[];
-    logical_unit_state: "current" | "stale";
-    current_artifact_count: number;
-    stale_artifact_count: number;
-    current_section_count: number;
-    stale_section_count: number;
-    recompute_scope: "none" | "artifact-sections" | "logical-unit-empty";
-}, {
-    protocol: "context.indexer.incremental-impact-report/v1";
-    artifacts: {
-        artifact_kind: string;
-        artifact_id: string;
-        sections: {
-            section_key: string;
-            state: "current" | "stale";
-            changed_node_refs: string[];
-        }[];
-        state: "current" | "stale";
-        changed_node_refs: string[];
-    }[];
-    indexer_id: string;
-    report_digest: string;
-    logical_unit_ref: string;
-    previous_run_envelope_digest: string;
-    current_run_envelope_digest: string;
-    previous_dependency_view_digest: string;
-    current_dependency_view_digest: string;
-    previous_dependency_set_digest: string;
-    envelope_changes: {
-        field: string;
-        previous_value: string | null;
-        current_value: string | null;
-    }[];
-    dependency_changes: {
-        kind: string;
-        node_ref: string;
-        polarity: "positive" | "negative";
-        change: "changed" | "added" | "removed";
-        previous_dependency_ref: string | null;
-        current_dependency_ref: string | null;
-        affected_artifact_ids: string[];
-        affected_sections: {
-            section_key: string;
-            artifact_id: string;
-        }[];
-    }[];
-    logical_unit_state: "current" | "stale";
-    current_artifact_count: number;
-    stale_artifact_count: number;
-    current_section_count: number;
-    stale_section_count: number;
-    recompute_scope: "none" | "artifact-sections" | "logical-unit-empty";
-}>;
-export type IndexerIncrementalImpactReport = z.infer<typeof indexerIncrementalImpactReportSchema>;
-export declare function indexerIncrementalImpactReportDigest(value: Omit<IndexerIncrementalImpactReport, "report_digest">): string;
-export declare function buildIndexerIncrementalImpactReport(input: {
-    previous_run_envelope: unknown;
-    previous_dependency_view: unknown;
-    previous_dependency_set: unknown;
-    current_run_envelope: unknown;
-    current_dependency_view: unknown;
-}): IndexerIncrementalImpactReport;
-export declare function validateIndexerIncrementalImpactReport(input: {
-    report: unknown;
-    previous_run_envelope: unknown;
-    previous_dependency_view: unknown;
-    previous_dependency_set: unknown;
-    current_run_envelope: unknown;
-    current_dependency_view: unknown;
-}): IndexerIncrementalImpactReport;

package/indexerKnowledgeDependency.d.ts

@@ -1,46 +0,0 @@
-import { z } from "zod";
-/** Supporting knowledge is referenced by identity, never copied into the
- * primary inventory ownership of a second topic. */
-export declare const indexerKnowledgeDependencySchema: z.ZodObject<{
-    artifact_ref: z.ZodString;
-    section_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    required: z.ZodDefault<z.ZodBoolean>;
-}, "strict", z.ZodTypeAny, {
-    required: boolean;
-    artifact_ref: string;
-    section_refs: string[];
-}, {
-    artifact_ref: string;
-    required?: boolean | undefined;
-    section_refs?: string[] | undefined;
-}>;
-export type IndexerKnowledgeDependency = z.infer<typeof indexerKnowledgeDependencySchema>;
-export interface IndexerKnowledgeDependencyNode {
-    artifact_ref: string;
-    dependencies: readonly IndexerKnowledgeDependency[];
-}
-export declare class IndexerKnowledgeDependencyCycleError extends TypeError {
-    readonly artifact_refs: readonly string[];
-    constructor(artifact_refs: readonly string[]);
-}
-/** Missing dependencies may be produced later. Cycles cannot become ready by
- * waiting, so reject them before any Author is scheduled. */
-export declare function validateIndexerKnowledgeDependencyGraph(nodes: readonly IndexerKnowledgeDependencyNode[]): void;
-export declare const indexerKnowledgeDependencyVersionSchema: z.ZodObject<{
-    artifact_ref: z.ZodString;
-    approved_content_digest: z.ZodString;
-    projection_digest: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    artifact_ref: string;
-    approved_content_digest: string;
-    projection_digest: string;
-}, {
-    artifact_ref: string;
-    approved_content_digest: string;
-    projection_digest: string;
-}>;
-export type IndexerKnowledgeDependencyVersion = z.infer<typeof indexerKnowledgeDependencyVersionSchema>;
-export declare function indexerKnowledgeDependencyFingerprint(versions: readonly IndexerKnowledgeDependencyVersion[]): string;
-/** A changed or removed dependency invalidates transitive readers as well.
- * This returns identities for the existing update flow, not another queue. */
-export declare function impactedIndexerKnowledgeArticles(nodes: readonly IndexerKnowledgeDependencyNode[], changed: ReadonlySet<string>): string[];

package/indexerSubjectCatalog.d.ts

@@ -1,230 +0,0 @@
-import { z } from "zod";
-import { type IndexerTargetResolutionView } from "./indexerMainWorkset.js";
-declare const approvedSubjectSchema: z.ZodObject<{
-    node_ref: z.ZodString;
-    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;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    }, {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    }>;
-}, "strict", z.ZodTypeAny, {
-    subject_key: {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    };
-    node_ref: string;
-}, {
-    subject_key: {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    };
-    node_ref: string;
-}>;
-declare const partitionSubjectSchema: z.ZodObject<{
-    partition_workset_digest: z.ZodString;
-    partition_plan_digest: z.ZodString;
-    group_key: z.ZodString;
-    node_ref: z.ZodString;
-    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;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    }, {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    }>;
-}, "strict", z.ZodTypeAny, {
-    subject_key: {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    };
-    node_ref: string;
-    group_key: string;
-    partition_workset_digest: string;
-    partition_plan_digest: string;
-}, {
-    subject_key: {
-        kind: string;
-        namespace: string;
-        protocol: "context.subject-key/v1";
-        local_key: string;
-    };
-    node_ref: string;
-    group_key: string;
-    partition_workset_digest: string;
-    partition_plan_digest: string;
-}>;
-export declare const indexerSubjectCatalogSchema: z.ZodObject<{
-    protocol: z.ZodLiteral<"context.indexer.subject-catalog/v1">;
-    requirement_ref: z.ZodString;
-    subject_key_schema_digest: z.ZodString;
-    approved_subject_set_digest: z.ZodString;
-    partition_subject_set_digest: z.ZodString;
-    entries: z.ZodArray<z.ZodObject<{
-        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;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        }, {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        }>;
-        node_refs: z.ZodArray<z.ZodString, "many">;
-        origin_refs: z.ZodArray<z.ZodString, "many">;
-    }, "strict", z.ZodTypeAny, {
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        node_refs: string[];
-        origin_refs: string[];
-    }, {
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        node_refs: string[];
-        origin_refs: string[];
-    }>, "many">;
-    catalog_digest: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    entries: {
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        node_refs: string[];
-        origin_refs: string[];
-    }[];
-    protocol: "context.indexer.subject-catalog/v1";
-    requirement_ref: string;
-    subject_key_schema_digest: string;
-    approved_subject_set_digest: string;
-    partition_subject_set_digest: string;
-    catalog_digest: string;
-}, {
-    entries: {
-        subject_key: {
-            kind: string;
-            namespace: string;
-            protocol: "context.subject-key/v1";
-            local_key: string;
-        };
-        node_refs: string[];
-        origin_refs: string[];
-    }[];
-    protocol: "context.indexer.subject-catalog/v1";
-    requirement_ref: string;
-    subject_key_schema_digest: string;
-    approved_subject_set_digest: string;
-    partition_subject_set_digest: string;
-    catalog_digest: string;
-}>;
-export type IndexerApprovedSubject = z.infer<typeof approvedSubjectSchema>;
-export type IndexerPartitionSubject = z.infer<typeof partitionSubjectSchema>;
-export type IndexerSubjectCatalog = z.infer<typeof indexerSubjectCatalogSchema>;
-type CatalogPayload = Omit<IndexerSubjectCatalog, "catalog_digest">;
-export declare function indexerSubjectCatalogDigest(value: CatalogPayload): string;
-export declare function buildIndexerSubjectCatalog(input: {
-    requirement_ref: string;
-    subject_key_schema_digest: string;
-    approved_subjects: readonly unknown[];
-    partition_subjects: readonly unknown[];
-}): IndexerSubjectCatalog;
-export declare function validateIndexerSubjectCatalog(value: unknown): IndexerSubjectCatalog;
-export declare function indexerTargetQueryRef(input: {
-    subject_intent: "enrich-or-independent";
-    subject_key: unknown;
-    subject_key_schema_digest: string;
-}): string;
-export declare const indexerTargetResolutionViewSetSchema: z.ZodObject<{
-    protocol: z.ZodLiteral<"context.indexer.target-resolution-view-set/v1">;
-    catalog_digest: z.ZodString;
-    items: z.ZodArray<z.ZodObject<{
-        group_ref: z.ZodString;
-        query_ref: z.ZodString;
-        view_digest: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        view_digest: string;
-        query_ref: string;
-        group_ref: string;
-    }, {
-        view_digest: string;
-        query_ref: string;
-        group_ref: string;
-    }>, "many">;
-    view_set_digest: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    protocol: "context.indexer.target-resolution-view-set/v1";
-    items: {
-        view_digest: string;
-        query_ref: string;
-        group_ref: string;
-    }[];
-    catalog_digest: string;
-    view_set_digest: string;
-}, {
-    protocol: "context.indexer.target-resolution-view-set/v1";
-    items: {
-        view_digest: string;
-        query_ref: string;
-        group_ref: string;
-    }[];
-    catalog_digest: string;
-    view_set_digest: string;
-}>;
-export type IndexerTargetResolutionViewSet = z.infer<typeof indexerTargetResolutionViewSetSchema>;
-export declare function buildIndexerTargetResolutionViews(input: {
-    catalog: unknown;
-    queries: readonly {
-        group_ref: string;
-        subject_intent: "enrich-or-independent";
-        subject_key: unknown;
-    }[];
-}): {
-    views: Array<{
-        group_ref: string;
-        view: IndexerTargetResolutionView;
-    }>;
-    view_set: IndexerTargetResolutionViewSet;
-};
-export {};