@c4a/context 0.6.18 → 0.7.0

package/indexerMaterialAnswerFlow.d.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+declare const ownerDomainAuthoritySchema: z.ZodObject<{
+    owner_cell_ref: z.ZodString;
+    domain_state: z.ZodEnum<["required", "optional", "out-of-scope"]>;
+}, "strict", z.ZodTypeAny, {
+    owner_cell_ref: string;
+    domain_state: "required" | "optional" | "out-of-scope";
+}, {
+    owner_cell_ref: string;
+    domain_state: "required" | "optional" | "out-of-scope";
+}>;
+export declare const indexerMaterialAnswerFlowStatusSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.material-answer-flow-status/v1">;
+    ledger_revision: z.ZodString;
+    current_layout_digest: z.ZodString;
+    blocking_unresolved_question_keys: z.ZodArray<z.ZodString, "many">;
+    blocking_answer_approved_question_keys: z.ZodArray<z.ZodString, "many">;
+    blocking_stale_actualization_question_keys: z.ZodArray<z.ZodString, "many">;
+    recommended_pending_question_keys: z.ZodArray<z.ZodString, "many">;
+    current_resolved_binding_digests: z.ZodArray<z.ZodString, "many">;
+    effective_blocking_gap_count: z.ZodNumber;
+    layout_allowed: z.ZodBoolean;
+    conditional_layout_gate_allowed: z.ZodBoolean;
+    main_candidate_review_allowed: z.ZodBoolean;
+} & {
+    status_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.material-answer-flow-status/v1";
+    status_digest: string;
+    ledger_revision: string;
+    current_layout_digest: string;
+    blocking_unresolved_question_keys: string[];
+    blocking_answer_approved_question_keys: string[];
+    blocking_stale_actualization_question_keys: string[];
+    recommended_pending_question_keys: string[];
+    current_resolved_binding_digests: string[];
+    effective_blocking_gap_count: number;
+    layout_allowed: boolean;
+    conditional_layout_gate_allowed: boolean;
+    main_candidate_review_allowed: boolean;
+}, {
+    protocol: "context.indexer.material-answer-flow-status/v1";
+    status_digest: string;
+    ledger_revision: string;
+    current_layout_digest: string;
+    blocking_unresolved_question_keys: string[];
+    blocking_answer_approved_question_keys: string[];
+    blocking_stale_actualization_question_keys: string[];
+    recommended_pending_question_keys: string[];
+    current_resolved_binding_digests: string[];
+    effective_blocking_gap_count: number;
+    layout_allowed: boolean;
+    conditional_layout_gate_allowed: boolean;
+    main_candidate_review_allowed: boolean;
+}>;
+export type IndexerMaterialAnswerFlowStatus = z.infer<typeof indexerMaterialAnswerFlowStatusSchema>;
+export declare function validateIndexerMaterialAnswerFlowStatus(value: unknown): IndexerMaterialAnswerFlowStatus;
+export declare function deriveIndexerMaterialAnswerFlowStatus(input: {
+    ledger: unknown;
+    current_layout_digest: string;
+    owner_domain_authorities: readonly z.infer<typeof ownerDomainAuthoritySchema>[];
+}): IndexerMaterialAnswerFlowStatus;
+export {};

package/indexerMaterialAnswerLayout.d.ts

@@ -0,0 +1,76 @@
+import { z } from "zod";
+export declare const indexerMaterialAnswerActualTargetRefSchema: z.ZodEffects<z.ZodString, string, string>;
+export declare const indexerMaterialAnswerLandingMappingSchema: z.ZodObject<{
+    answer_landing_ref: z.ZodString;
+    actualized_target_ref: z.ZodEffects<z.ZodString, string, string>;
+    section_ref: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+}, "strict", z.ZodTypeAny, {
+    answer_landing_ref: string;
+    actualized_target_ref: string;
+    section_ref?: string | undefined;
+}, {
+    answer_landing_ref: string;
+    actualized_target_ref: string;
+    section_ref?: string | undefined;
+}>;
+export declare const indexerMaterialAnswerLayoutProposalSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.material-answer-layout-proposal/v1">;
+    layout_digest: z.ZodString;
+    landing_mappings: z.ZodArray<z.ZodObject<{
+        answer_landing_ref: z.ZodString;
+        actualized_target_ref: z.ZodEffects<z.ZodString, string, string>;
+        section_ref: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        answer_landing_ref: string;
+        actualized_target_ref: string;
+        section_ref?: string | undefined;
+    }, {
+        answer_landing_ref: string;
+        actualized_target_ref: string;
+        section_ref?: string | undefined;
+    }>, "many">;
+} & {
+    proposal_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.material-answer-layout-proposal/v1";
+    proposal_digest: string;
+    layout_digest: string;
+    landing_mappings: {
+        answer_landing_ref: string;
+        actualized_target_ref: string;
+        section_ref?: string | undefined;
+    }[];
+}, {
+    protocol: "context.indexer.material-answer-layout-proposal/v1";
+    proposal_digest: string;
+    layout_digest: string;
+    landing_mappings: {
+        answer_landing_ref: string;
+        actualized_target_ref: string;
+        section_ref?: string | undefined;
+    }[];
+}>;
+export type IndexerMaterialAnswerLandingMapping = z.infer<typeof indexerMaterialAnswerLandingMappingSchema>;
+export type IndexerMaterialAnswerLayoutProposal = z.infer<typeof indexerMaterialAnswerLayoutProposalSchema>;
+export declare function buildIndexerMaterialAnswerLayoutProposal(input: {
+    layout_digest: string;
+    landing_mappings: readonly IndexerMaterialAnswerLandingMapping[];
+}): IndexerMaterialAnswerLayoutProposal;
+export declare function validateIndexerMaterialAnswerLayoutProposal(value: unknown): IndexerMaterialAnswerLayoutProposal;
+export declare function buildIndexerMaterialAnswerLayoutProposalFromLayout(input: {
+    layout: unknown;
+    landings: ReadonlyArray<{
+        answer_landing_ref: string;
+        artifact_id: string;
+        section_key?: string;
+    }>;
+}): IndexerMaterialAnswerLayoutProposal;
+export declare function buildIndexerMaterialAnswerLayoutProposalFromLayoutSet(input: {
+    layout_proposal_set: unknown;
+    landings: ReadonlyArray<{
+        answer_landing_ref: string;
+        indexer_id: string;
+        artifact_id: string;
+        section_key?: string;
+    }>;
+}): IndexerMaterialAnswerLayoutProposal;

package/indexerMaterialAnswerReview.d.ts

@@ -0,0 +1,217 @@
+import { z } from "zod";
+import { type IndexerCanonicalMaterialAnswerEvidence, type IndexerCurrentEvidenceSource, type IndexerMaterialAnswerCandidateSet, type IndexerSourceSpanRef } from "./indexerMaterialAnswer.js";
+import { type IndexerResolvedMaterialQuestion } from "./indexerQuestionAuthority.js";
+export declare const INDEXER_MATERIAL_ANSWER_REVIEW_SCOPE: "question-target-source-span-evidence-binding";
+declare const compatibilityReasonSchema: z.ZodEnum<["question-contract-stale", "source-input-set-stale", "evidence-source-missing", "source-origin-stale", "source-input-stale", "evidence-kind-incompatible", "source-kind-incompatible", "evidence-span-stale", "evidence-content-stale", "provenance-constraint-not-met", "minimum-items-not-met", "minimum-distinct-sources-not-met"]>;
+export type IndexerMaterialAnswerCompatibilityReason = z.infer<typeof compatibilityReasonSchema>;
+export declare const indexerMaterialAnswerEvidenceCompatibilitySchema: z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.material-answer-evidence-compatibility/v1">;
+    question_key: z.ZodString;
+    question_revision_digest: z.ZodString;
+    question_contract_digest: z.ZodString;
+    binding_digest: z.ZodString;
+    expected_source_input_set_digest: z.ZodString;
+    current_source_input_set_digest: z.ZodString;
+    accepted_evidence_item_refs: z.ZodArray<z.ZodString, "many">;
+    rejected_evidence_item_refs: z.ZodArray<z.ZodString, "many">;
+    accepted_evidence_item_count: z.ZodNumber;
+    distinct_source_count: z.ZodNumber;
+    compatibility_digest: z.ZodString;
+} & {
+    state: z.ZodLiteral<"compatible">;
+    reason_codes: z.ZodArray<z.ZodEnum<["question-contract-stale", "source-input-set-stale", "evidence-source-missing", "source-origin-stale", "source-input-stale", "evidence-kind-incompatible", "source-kind-incompatible", "evidence-span-stale", "evidence-content-stale", "provenance-constraint-not-met", "minimum-items-not-met", "minimum-distinct-sources-not-met"]>, "many">;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.material-answer-evidence-compatibility/v1";
+    state: "compatible";
+    binding_digest: string;
+    question_contract_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    distinct_source_count: number;
+    reason_codes: ("minimum-items-not-met" | "minimum-distinct-sources-not-met" | "provenance-constraint-not-met" | "question-contract-stale" | "source-input-set-stale" | "evidence-source-missing" | "source-origin-stale" | "source-input-stale" | "evidence-kind-incompatible" | "source-kind-incompatible" | "evidence-span-stale" | "evidence-content-stale")[];
+    accepted_evidence_item_count: number;
+    rejected_evidence_item_refs: string[];
+    expected_source_input_set_digest: string;
+    current_source_input_set_digest: string;
+    accepted_evidence_item_refs: string[];
+    compatibility_digest: string;
+}, {
+    protocol: "context.indexer.material-answer-evidence-compatibility/v1";
+    state: "compatible";
+    binding_digest: string;
+    question_contract_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    distinct_source_count: number;
+    reason_codes: ("minimum-items-not-met" | "minimum-distinct-sources-not-met" | "provenance-constraint-not-met" | "question-contract-stale" | "source-input-set-stale" | "evidence-source-missing" | "source-origin-stale" | "source-input-stale" | "evidence-kind-incompatible" | "source-kind-incompatible" | "evidence-span-stale" | "evidence-content-stale")[];
+    accepted_evidence_item_count: number;
+    rejected_evidence_item_refs: string[];
+    expected_source_input_set_digest: string;
+    current_source_input_set_digest: string;
+    accepted_evidence_item_refs: string[];
+    compatibility_digest: string;
+}>, z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.material-answer-evidence-compatibility/v1">;
+    question_key: z.ZodString;
+    question_revision_digest: z.ZodString;
+    question_contract_digest: z.ZodString;
+    binding_digest: z.ZodString;
+    expected_source_input_set_digest: z.ZodString;
+    current_source_input_set_digest: z.ZodString;
+    accepted_evidence_item_refs: z.ZodArray<z.ZodString, "many">;
+    rejected_evidence_item_refs: z.ZodArray<z.ZodString, "many">;
+    accepted_evidence_item_count: z.ZodNumber;
+    distinct_source_count: z.ZodNumber;
+    compatibility_digest: z.ZodString;
+} & {
+    state: z.ZodLiteral<"incompatible">;
+    reason_codes: z.ZodArray<z.ZodEnum<["question-contract-stale", "source-input-set-stale", "evidence-source-missing", "source-origin-stale", "source-input-stale", "evidence-kind-incompatible", "source-kind-incompatible", "evidence-span-stale", "evidence-content-stale", "provenance-constraint-not-met", "minimum-items-not-met", "minimum-distinct-sources-not-met"]>, "many">;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.material-answer-evidence-compatibility/v1";
+    state: "incompatible";
+    binding_digest: string;
+    question_contract_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    distinct_source_count: number;
+    reason_codes: ("minimum-items-not-met" | "minimum-distinct-sources-not-met" | "provenance-constraint-not-met" | "question-contract-stale" | "source-input-set-stale" | "evidence-source-missing" | "source-origin-stale" | "source-input-stale" | "evidence-kind-incompatible" | "source-kind-incompatible" | "evidence-span-stale" | "evidence-content-stale")[];
+    accepted_evidence_item_count: number;
+    rejected_evidence_item_refs: string[];
+    expected_source_input_set_digest: string;
+    current_source_input_set_digest: string;
+    accepted_evidence_item_refs: string[];
+    compatibility_digest: string;
+}, {
+    protocol: "context.indexer.material-answer-evidence-compatibility/v1";
+    state: "incompatible";
+    binding_digest: string;
+    question_contract_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    distinct_source_count: number;
+    reason_codes: ("minimum-items-not-met" | "minimum-distinct-sources-not-met" | "provenance-constraint-not-met" | "question-contract-stale" | "source-input-set-stale" | "evidence-source-missing" | "source-origin-stale" | "source-input-stale" | "evidence-kind-incompatible" | "source-kind-incompatible" | "evidence-span-stale" | "evidence-content-stale")[];
+    accepted_evidence_item_count: number;
+    rejected_evidence_item_refs: string[];
+    expected_source_input_set_digest: string;
+    current_source_input_set_digest: string;
+    accepted_evidence_item_refs: string[];
+    compatibility_digest: string;
+}>]>;
+export type IndexerMaterialAnswerEvidenceCompatibility = z.infer<typeof indexerMaterialAnswerEvidenceCompatibilitySchema>;
+export declare function indexerMaterialAnswerSourceInputSetDigest(sourceInputDigests: readonly string[]): string;
+export declare function validateIndexerMaterialAnswerEvidenceCompatibility(value: unknown): IndexerMaterialAnswerEvidenceCompatibility;
+export declare function evaluateIndexerMaterialAnswerEvidenceCompatibility(input: {
+    question_key: string;
+    question_revision_digest: string;
+    question_contract_digest: string;
+    binding_digest: string;
+    expected_source_input_set_digest: string;
+    current_source_input_digests: readonly string[];
+    current_question: IndexerResolvedMaterialQuestion;
+    evidence: readonly IndexerCanonicalMaterialAnswerEvidence[];
+    current_sources: readonly IndexerCurrentEvidenceSource[];
+    resolve_evidence_digest: (input: {
+        source: IndexerCurrentEvidenceSource;
+        source_spans: readonly IndexerSourceSpanRef[];
+    }) => string;
+}): IndexerMaterialAnswerEvidenceCompatibility;
+export declare const indexerMaterialAnswerBaselineReportSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.material-answer-baseline-report/v1">;
+    review_scope: z.ZodLiteral<"question-target-source-span-evidence-binding">;
+    workset_digest: z.ZodString;
+    candidate_set_digest: z.ZodString;
+    question_key: z.ZodString;
+    question_contract_digest: z.ZodString;
+    question_revision_digest: z.ZodString;
+    question_target_item_digest: z.ZodString;
+    answer_landing_ref: z.ZodOptional<z.ZodString>;
+    binding_digest: z.ZodString;
+    evidence_item_refs: z.ZodArray<z.ZodString, "many">;
+    evidence_set_digest: z.ZodString;
+    baseline_passed: z.ZodLiteral<true>;
+} & {
+    report_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    protocol: "context.indexer.material-answer-baseline-report/v1";
+    workset_digest: string;
+    report_digest: string;
+    binding_digest: string;
+    question_contract_digest: string;
+    question_target_item_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    candidate_set_digest: string;
+    review_scope: "question-target-source-span-evidence-binding";
+    evidence_item_refs: string[];
+    evidence_set_digest: string;
+    baseline_passed: true;
+    answer_landing_ref?: string | undefined;
+}, {
+    protocol: "context.indexer.material-answer-baseline-report/v1";
+    workset_digest: string;
+    report_digest: string;
+    binding_digest: string;
+    question_contract_digest: string;
+    question_target_item_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    candidate_set_digest: string;
+    review_scope: "question-target-source-span-evidence-binding";
+    evidence_item_refs: string[];
+    evidence_set_digest: string;
+    baseline_passed: true;
+    answer_landing_ref?: string | undefined;
+}>;
+export type IndexerMaterialAnswerBaselineReport = z.infer<typeof indexerMaterialAnswerBaselineReportSchema>;
+export declare function buildIndexerMaterialAnswerBaselineReport(input: {
+    workset: unknown;
+    candidate_set: unknown;
+    question_key: string;
+}): IndexerMaterialAnswerBaselineReport;
+export declare function validateIndexerMaterialAnswerBaselineReport(value: unknown): IndexerMaterialAnswerBaselineReport;
+export declare const indexerMaterialAnswerReviewDecisionSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.indexer.material-answer-review-decision/v1">;
+    review_scope: z.ZodLiteral<"question-target-source-span-evidence-binding">;
+    baseline_report_digest: z.ZodString;
+    workset_digest: z.ZodString;
+    candidate_set_digest: z.ZodString;
+    question_key: z.ZodString;
+    question_revision_digest: z.ZodString;
+    binding_digest: z.ZodString;
+    decision: z.ZodEnum<["approved", "rejected"]>;
+} & {
+    decision_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    decision: "approved" | "rejected";
+    protocol: "context.indexer.material-answer-review-decision/v1";
+    workset_digest: string;
+    binding_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    candidate_set_digest: string;
+    review_scope: "question-target-source-span-evidence-binding";
+    baseline_report_digest: string;
+    decision_digest: string;
+}, {
+    decision: "approved" | "rejected";
+    protocol: "context.indexer.material-answer-review-decision/v1";
+    workset_digest: string;
+    binding_digest: string;
+    question_key: string;
+    question_revision_digest: string;
+    candidate_set_digest: string;
+    review_scope: "question-target-source-span-evidence-binding";
+    baseline_report_digest: string;
+    decision_digest: string;
+}>;
+export type IndexerMaterialAnswerReviewDecision = z.infer<typeof indexerMaterialAnswerReviewDecisionSchema>;
+export declare function decideIndexerMaterialAnswerReview(input: {
+    baseline_report: unknown;
+    decision: "approved" | "rejected";
+}): IndexerMaterialAnswerReviewDecision;
+export declare function validateIndexerMaterialAnswerReviewDecision(input: {
+    decision: unknown;
+    baseline_report: unknown;
+    candidate_set: IndexerMaterialAnswerCandidateSet;
+}): IndexerMaterialAnswerReviewDecision;
+export {};