@tenphi/akno-core 0.13.0 → 0.13.2

package/dist/bench/language.d.ts

@@ -2,35 +2,16 @@ import type { AknoConfig } from '../config/schema.ts';
 import { type LanguageCase } from './language-corpus.ts';
 export interface LanguageBenchOptions {
     split: LanguageCase['split'];
-    corpus?: 'v1' | 'v2' | 'v3' | 'v4' | 'v5' | 'v6' | 'v7' | 'v8' | 'v9' | 'v10' | 'v11' | 'v12' | 'v13' | 'v14' | 'v15' | 'v16' | 'v17' | 'v18' | 'v19' | 'v20' | 'v21' | 'v22';
+    corpus?: 'v1' | 'v2' | 'v3' | 'v4' | 'v5' | 'v6' | 'v7' | 'v8' | 'v9' | 'v10' | 'v11' | 'v12' | 'v13' | 'v14' | 'v15' | 'v16' | 'v17' | 'v18' | 'v19' | 'v20' | 'v21' | 'v22' | 'v23';
     runs?: number;
     caseIds?: string[];
+    /** Exercise the supplied reranker as well as populated vector retrieval. */
+    fullRetrieval?: boolean;
+    onCaseResult?: (result: Awaited<ReturnType<typeof runCase>>) => void;
     onProgress?: (id: string, done: number, total: number) => void;
 }
 /** Runs only invented inputs. Provider permissions/settings come from the caller's configured roles. */
 export declare function runLanguageBench(config: AknoConfig, options: LanguageBenchOptions): Promise<{
-    schemaVersion: string;
-    createdAt: string;
-    corpusVersion: string;
-    corpusFingerprint: string;
-    selectedCaseIds: string[];
-    runs: number;
-    setup: string;
-    queryMatrix: string[];
-    split: "development" | "held-out";
-    knowledgeLanguage: string;
-    proseProjectionVersion: string;
-    memoryViewVersion: string;
-    answerPromptVersion: string;
-    answerVerifierVersion: string;
-    retentionPromptVersion: string;
-    retentionVerifierVersion: string;
-    models: {
-        retention: string | null;
-        answer: string | null;
-        embedding: string | null;
-        expansion: string | null;
-    };
     modelOutputTokenLimits: {
         answer: number | null;
         retention: number | null;
@@ -165,11 +146,11 @@ export declare function runLanguageBench(config: AknoConfig, options: LanguageBe
         languageRejected: boolean;
         retention: {
             status: "unavailable" | "ok" | "empty" | "degraded";
-            outcome: "ok" | "held" | "noop" | "replayed" | "revision_conflict" | undefined;
-            reason: "language_mismatch" | "conflict" | "routing_uncertain" | "no_writable_destination" | "source_unavailable" | "discourse_uncertain" | "context_too_large" | "time_unresolved" | "noncanonical_without_context" | "support_limit" | "placement_degraded" | "apply_failed" | "validation_failed" | "language_policy_required" | null;
+            outcome: "ok" | "held" | "replayed" | "noop" | "revision_conflict" | undefined;
+            reason: "language_mismatch" | "conflict" | "routing_uncertain" | "no_writable_destination" | "source_unavailable" | "discourse_uncertain" | "context_too_large" | "time_unresolved" | "noncanonical_without_context" | "not_durable" | "scope_mismatch" | "support_limit" | "placement_degraded" | "apply_failed" | "validation_failed" | "language_policy_required" | null;
             candidates: {
                 outcome: "not_found" | "held" | "retracted" | "duplicate" | "written" | "support_added";
-                reason: "language_mismatch" | "conflict" | "routing_uncertain" | "no_writable_destination" | "source_unavailable" | "discourse_uncertain" | "context_too_large" | "time_unresolved" | "noncanonical_without_context" | "support_limit" | "placement_degraded" | "apply_failed" | "validation_failed" | "language_policy_required" | null;
+                reason: "language_mismatch" | "conflict" | "routing_uncertain" | "no_writable_destination" | "source_unavailable" | "discourse_uncertain" | "context_too_large" | "time_unresolved" | "noncanonical_without_context" | "not_durable" | "scope_mismatch" | "support_limit" | "placement_degraded" | "apply_failed" | "validation_failed" | "language_policy_required" | null;
                 holdStage: "verification" | "apply" | "validation" | "placement" | null;
                 routingReason: "existing_selected" | "new_selected" | "read_only_match" | "no_admitted_destination" | "ownership_uncertain" | "model_unavailable" | "model_failed" | "invalid_model_response" | null;
             }[] | undefined;
@@ -214,7 +195,22 @@ export declare function runLanguageBench(config: AknoConfig, options: LanguageBe
             results: number;
         };
         bytesStable: boolean;
-        replayOutcome: "ok" | "held" | "noop" | "replayed" | "revision_conflict" | undefined;
+        replayOutcome: "ok" | "held" | "replayed" | "noop" | "revision_conflict" | undefined;
+        sourceArchive: {
+            stableAcrossRebuildReplay: boolean;
+            supports: {
+                hashValid: boolean;
+                spans: {
+                    quote: string;
+                    matchingSourceItems: string[];
+                }[];
+                memory_id: string;
+                source_ref: string;
+                input_hash: string;
+                evidence: string;
+                evidence_hash: string;
+            }[];
+        };
         queries: {
             queryLanguage: "en" | "ru";
             explicitView: boolean;
@@ -271,6 +267,301 @@ export declare function runLanguageBench(config: AknoConfig, options: LanguageBe
                 qualification_run: boolean;
                 reference_resolution: "unresolved" | "not_needed" | "resolved" | "ambiguous";
             } | null;
+            reviewContext: ({
+                slug: string;
+                title: string;
+                role: "knowledge" | "source" | "inference" | "ignored";
+                summary: string | null;
+                score: number;
+                lines: {
+                    n: number;
+                    text: string;
+                    prose?: {
+                        status: "unresolved" | "qualified";
+                        view: "factual" | "history" | "planning" | "reports" | "questions" | "discussion";
+                        reason: "comment" | "question" | "tentative" | "plan" | "asserted" | "rejected" | "heading" | "heading_scope" | "conditional" | "quotation" | "speaker" | "example" | "context_limit";
+                        answer_eligible: boolean;
+                        source_hash: string;
+                        frame: {
+                            n: number;
+                            text: string;
+                        }[];
+                    } | undefined;
+                    confidence?: number | undefined;
+                    memory?: {
+                        status: "qualified";
+                        id: string;
+                        level: 1;
+                        kind: "claim" | "question" | "plan" | "decision" | "preference" | "event";
+                        subject: string;
+                        source_role: "unknown" | "external" | "user" | "assistant";
+                        commitment: "none" | "tentative" | "asserted" | "hypothetical" | "counterfactual";
+                        disposition: "completed" | "rejected" | "active" | "proposed" | "accepted" | "resolved" | "cancelled" | "superseded";
+                        polarity: "affirmed" | "negated";
+                        basis: "self_attested" | "source_report" | "cited_evidence" | "system_record";
+                        answer_eligible: boolean;
+                        current_eligible: boolean;
+                        source_speaker?: string | undefined;
+                        temporal?: {
+                            time: {
+                                precision: "unknown" | "instant" | "day" | "month" | "year";
+                                relation: "occurred" | "valid" | "scheduled" | "due";
+                                status: "tentative" | "scheduled" | "actual" | "planned";
+                                start?: string | undefined;
+                                until?: string | undefined;
+                                timezone?: string | undefined;
+                                mentioned_at?: string | undefined;
+                                recurrence?: {
+                                    frequency: "daily" | "weekly" | "monthly" | "yearly";
+                                    interval?: number | undefined;
+                                    weekdays?: ("mo" | "tu" | "we" | "th" | "fr" | "sa" | "su")[] | undefined;
+                                    until?: string | undefined;
+                                } | undefined;
+                            };
+                            clock_relation: "past" | "today" | "current_period" | "ongoing" | "future" | "overdue" | "undated";
+                            actionable: boolean;
+                        } | undefined;
+                    } | {
+                        status: "unavailable";
+                        id: string;
+                        answer_eligible: false;
+                    } | undefined;
+                    observation?: {
+                        status: "eligible";
+                        id: string;
+                        level: 2;
+                        subject: string;
+                        disposition: "active" | "superseded" | "weakened" | "retracted";
+                        proof_count: number;
+                        evidence: {
+                            fact: string;
+                            slug: string;
+                            line: number;
+                            line_hash: string;
+                            proof_groups: string[];
+                        }[];
+                        scope_assessment?: {
+                            status: "assessed";
+                            fingerprint: string;
+                        } | undefined;
+                    } | {
+                        status: "ineligible";
+                        id: string;
+                        level: 2;
+                        disposition: "active" | "superseded" | "weakened" | "retracted";
+                        reason: string;
+                    } | undefined;
+                    fact?: string | undefined;
+                }[];
+                type: "page";
+                breadcrumb?: string | undefined;
+                updated?: string | undefined;
+                relevance?: number | undefined;
+                superseded?: {
+                    claim: string;
+                    valid_to: string;
+                }[] | undefined;
+                links?: string[] | undefined;
+                documents?: {
+                    id: string;
+                    rel_path?: string | undefined;
+                    mime?: string | undefined;
+                    label?: string | undefined;
+                    pages?: number | undefined;
+                    parts?: number | undefined;
+                    matched_page?: number | undefined;
+                    summary?: string | undefined;
+                    quote?: string | undefined;
+                    availability?: {
+                        status: "unavailable" | "degraded" | "available";
+                        available_from: ("original" | "indexed_text" | "rendition")[];
+                        missing_originals: string[];
+                        available_renditions: string[];
+                        missing_since?: string | undefined;
+                    } | undefined;
+                }[] | undefined;
+                truncated?: boolean | undefined;
+                matched_by?: ("graph" | "lexical" | "vector")[] | undefined;
+                graph_paths?: {
+                    seed: {
+                        id: string;
+                        kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                        slug?: string | undefined;
+                        label?: string | undefined;
+                        role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                        entity?: string | undefined;
+                        entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                        document?: string | undefined;
+                        fact?: string | undefined;
+                        event?: string | undefined;
+                        memory?: string | undefined;
+                        observation?: string | undefined;
+                        date?: string | undefined;
+                        line_start?: number | undefined;
+                        line_end?: number | undefined;
+                        availability?: "unavailable" | "degraded" | "available" | undefined;
+                    };
+                    target: {
+                        id: string;
+                        kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                        slug?: string | undefined;
+                        label?: string | undefined;
+                        role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                        entity?: string | undefined;
+                        entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                        document?: string | undefined;
+                        fact?: string | undefined;
+                        event?: string | undefined;
+                        memory?: string | undefined;
+                        observation?: string | undefined;
+                        date?: string | undefined;
+                        line_start?: number | undefined;
+                        line_end?: number | undefined;
+                        availability?: "unavailable" | "degraded" | "available" | undefined;
+                    };
+                    nodes: {
+                        id: string;
+                        kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                        slug?: string | undefined;
+                        label?: string | undefined;
+                        role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                        entity?: string | undefined;
+                        entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                        document?: string | undefined;
+                        fact?: string | undefined;
+                        event?: string | undefined;
+                        memory?: string | undefined;
+                        observation?: string | undefined;
+                        date?: string | undefined;
+                        line_start?: number | undefined;
+                        line_end?: number | undefined;
+                        availability?: "unavailable" | "degraded" | "available" | undefined;
+                    }[];
+                    relations: ("about" | "corrects" | "supersedes" | "contradicts" | "fulfills" | "answers" | "caused_by" | "canonical_record" | "links_to" | "mentions" | "has_attribute" | "related_entity" | "owns_document" | "participates_in" | "derived_from")[];
+                    hops: number;
+                    confidence: number;
+                    evidence: {
+                        kind: "document" | "frontmatter" | "page_line" | "fact_line";
+                        slug?: string | undefined;
+                        document?: string | undefined;
+                        event?: string | undefined;
+                        fact?: string | undefined;
+                        memory?: string | undefined;
+                        line_start?: number | undefined;
+                        line_end?: number | undefined;
+                        field?: string | undefined;
+                    }[];
+                }[] | undefined;
+            } | {
+                type: "document";
+                id: string;
+                path: string;
+                label: string;
+                mime: string | null;
+                source: {
+                    kind: "none" | "original_text" | "ocr_text" | "model_description";
+                    via: "none" | "vision" | "plain" | "text-layer" | "ocr" | "textutil" | "libreoffice";
+                    confidence?: number | null | undefined;
+                };
+                ownership: {
+                    status: "orphan";
+                };
+                score: number;
+                summary?: string | undefined;
+                quote?: string | undefined;
+                matched_page?: number | undefined;
+                parts?: {
+                    id: string;
+                    path: string;
+                    pages?: number | null | undefined;
+                }[] | undefined;
+                availability?: {
+                    status: "unavailable" | "degraded" | "available";
+                    available_from: ("original" | "indexed_text" | "rendition")[];
+                    missing_originals: string[];
+                    available_renditions: string[];
+                    missing_since?: string | undefined;
+                } | undefined;
+                suggested_actions?: {
+                    op: "adopt";
+                    args: {
+                        documentId: string;
+                    };
+                }[] | undefined;
+                relevance?: number | undefined;
+                matched_by?: ("graph" | "lexical" | "vector")[] | undefined;
+                graph_paths?: {
+                    seed: {
+                        id: string;
+                        kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                        slug?: string | undefined;
+                        label?: string | undefined;
+                        role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                        entity?: string | undefined;
+                        entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                        document?: string | undefined;
+                        fact?: string | undefined;
+                        event?: string | undefined;
+                        memory?: string | undefined;
+                        observation?: string | undefined;
+                        date?: string | undefined;
+                        line_start?: number | undefined;
+                        line_end?: number | undefined;
+                        availability?: "unavailable" | "degraded" | "available" | undefined;
+                    };
+                    target: {
+                        id: string;
+                        kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                        slug?: string | undefined;
+                        label?: string | undefined;
+                        role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                        entity?: string | undefined;
+                        entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                        document?: string | undefined;
+                        fact?: string | undefined;
+                        event?: string | undefined;
+                        memory?: string | undefined;
+                        observation?: string | undefined;
+                        date?: string | undefined;
+                        line_start?: number | undefined;
+                        line_end?: number | undefined;
+                        availability?: "unavailable" | "degraded" | "available" | undefined;
+                    };
+                    nodes: {
+                        id: string;
+                        kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                        slug?: string | undefined;
+                        label?: string | undefined;
+                        role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                        entity?: string | undefined;
+                        entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                        document?: string | undefined;
+                        fact?: string | undefined;
+                        event?: string | undefined;
+                        memory?: string | undefined;
+                        observation?: string | undefined;
+                        date?: string | undefined;
+                        line_start?: number | undefined;
+                        line_end?: number | undefined;
+                        availability?: "unavailable" | "degraded" | "available" | undefined;
+                    }[];
+                    relations: ("about" | "corrects" | "supersedes" | "contradicts" | "fulfills" | "answers" | "caused_by" | "canonical_record" | "links_to" | "mentions" | "has_attribute" | "related_entity" | "owns_document" | "participates_in" | "derived_from")[];
+                    hops: number;
+                    confidence: number;
+                    evidence: {
+                        kind: "document" | "frontmatter" | "page_line" | "fact_line";
+                        slug?: string | undefined;
+                        document?: string | undefined;
+                        event?: string | undefined;
+                        fact?: string | undefined;
+                        memory?: string | undefined;
+                        line_start?: number | undefined;
+                        line_end?: number | undefined;
+                        field?: string | undefined;
+                    }[];
+                }[] | undefined;
+            })[];
+            contextKnowledgeLanguage: "en" | null | undefined;
             answerOutcome: "not_found" | "partial" | "complete" | "not_answered";
             answerReason: "no_results" | "evidence_unavailable" | "retrieval_incomplete" | "no_eligible_evidence" | "generation_unavailable" | "generation_failed" | "invalid_draft" | "empty_draft" | "draft_rejected" | "verification_unavailable" | "verification_rejected" | "answered" | null;
             answerValidation: {
@@ -367,5 +658,572 @@ export declare function runLanguageBench(config: AknoConfig, options: LanguageBe
         expectedHold: boolean;
         nonfactualExpected: boolean;
     })[];
+    retrievalConfiguration?: {
+        embeddingDimensions: number | undefined;
+        rerankerEnabled: boolean;
+        mode: "endpoint" | "llm" | undefined;
+        topK: number | undefined;
+        maxChars: number | undefined;
+        excludeIrrelevant: boolean | undefined;
+        scoreOffset: number | "auto" | undefined;
+        api: "chat_completions" | "responses" | "auto" | null;
+        timeoutMs: number;
+        providerRetries: number | null;
+        maxOutputTokens: number | undefined;
+        reasoningEffort: "none" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    } | undefined;
+    schemaVersion: string;
+    createdAt: string;
+    corpusVersion: string;
+    corpusFingerprint: string;
+    selectedCaseIds: string[];
+    runs: number;
+    setup: string;
+    queryMatrix: string[];
+    split: "development" | "held-out";
+    knowledgeLanguage: string;
+    proseProjectionVersion: string;
+    memoryViewVersion: string;
+    answerPromptVersion: string;
+    answerVerifierVersion: string;
+    retentionPromptVersion: string;
+    retentionVerifierVersion: string;
+    models: {
+        reranker?: string | null | undefined;
+        retention: string | null;
+        answer: string | null;
+        embedding: string | null;
+        expansion: string | null;
+    };
+    modelConfiguration: {
+        [k: string]: {
+            enabled: boolean;
+            api: "chat_completions" | "responses" | "auto" | null;
+            timeoutMs: number;
+            maxOutputTokens: number | null;
+            reasoningEffort: "none" | "low" | "medium" | "high" | "xhigh" | "max" | null;
+            providerRetries: number | null;
+        };
+    };
+    retrievalProfile: string;
+}>;
+declare function runCase(config: AknoConfig, entry: LanguageCase, corpus: 'v1' | 'v2' | 'v3' | 'v4' | 'v5' | 'v6' | 'v7' | 'v8' | 'v9' | 'v10' | 'v11' | 'v12' | 'v13' | 'v14' | 'v15' | 'v16' | 'v17' | 'v18' | 'v19' | 'v20' | 'v21' | 'v22' | 'v23', run: number, fullRetrieval: boolean): Promise<{
+    retentionAvailabilityFailure: boolean;
+    availabilityFailure: boolean;
+    languageRejected: boolean;
+    retention: {
+        status: "unavailable" | "ok" | "empty" | "degraded";
+        outcome: "ok" | "held" | "replayed" | "noop" | "revision_conflict" | undefined;
+        reason: "language_mismatch" | "conflict" | "routing_uncertain" | "no_writable_destination" | "source_unavailable" | "discourse_uncertain" | "context_too_large" | "time_unresolved" | "noncanonical_without_context" | "not_durable" | "scope_mismatch" | "support_limit" | "placement_degraded" | "apply_failed" | "validation_failed" | "language_policy_required" | null;
+        candidates: {
+            outcome: "not_found" | "held" | "retracted" | "duplicate" | "written" | "support_added";
+            reason: "language_mismatch" | "conflict" | "routing_uncertain" | "no_writable_destination" | "source_unavailable" | "discourse_uncertain" | "context_too_large" | "time_unresolved" | "noncanonical_without_context" | "not_durable" | "scope_mismatch" | "support_limit" | "placement_degraded" | "apply_failed" | "validation_failed" | "language_policy_required" | null;
+            holdStage: "verification" | "apply" | "validation" | "placement" | null;
+            routingReason: "existing_selected" | "new_selected" | "read_only_match" | "no_admitted_destination" | "ownership_uncertain" | "model_unavailable" | "model_failed" | "invalid_model_response" | null;
+        }[] | undefined;
+        usage: {
+            extraction: {
+                model: string;
+                latency_ms: number;
+                input_tokens: number | null;
+                output_tokens: number | null;
+                total_tokens: number | null;
+            } | null;
+            verification: {
+                model: string;
+                latency_ms: number;
+                input_tokens: number | null;
+                output_tokens: number | null;
+                total_tokens: number | null;
+            } | null;
+            placement: {
+                model: string;
+                latency_ms: number;
+                input_tokens: number | null;
+                output_tokens: number | null;
+                total_tokens: number | null;
+            }[];
+            repair?: {
+                model: string;
+                latency_ms: number;
+                input_tokens: number | null;
+                output_tokens: number | null;
+                total_tokens: number | null;
+            } | undefined;
+        } | null;
+        degraded: ("language_mismatch" | "language_check_failed" | "prose_discourse_unresolved" | "no_embedding_model" | "no_reranker" | "no_derive_model" | "no_expansion_model" | "embedding_failed" | "rerank_failed" | "derive_failed" | "retain_verification_failed" | "retain_apply_failed" | "partial_temporal_index" | "partial_memory_index" | "timeline_range_limited" | "expansion_failed" | "no_vector_index" | "partial_index" | "no_document_text" | "document_source_missing" | "source_conflict" | "no_graph_index" | "no_entity_index" | "entity_resolution_failed" | "partial_graph_index" | "graph_traversal_limited" | "no_answer_model" | "answer_failed" | "answer_verification_failed" | "answer_truncated")[];
+    };
+    retainedItems: number;
+    noncanonicalEligibilityFlag: boolean;
+    semanticsMatch: boolean;
+    ordinaryCorrect: boolean;
+    ordinaryInspection: {
+        status: "unavailable" | "ok" | "empty" | "degraded";
+        results: number;
+    };
+    bytesStable: boolean;
+    replayOutcome: "ok" | "held" | "replayed" | "noop" | "revision_conflict" | undefined;
+    sourceArchive: {
+        stableAcrossRebuildReplay: boolean;
+        supports: {
+            hashValid: boolean;
+            spans: {
+                quote: string;
+                matchingSourceItems: string[];
+            }[];
+            memory_id: string;
+            source_ref: string;
+            input_hash: string;
+            evidence: string;
+            evidence_hash: string;
+        }[];
+    };
+    queries: {
+        queryLanguage: "en" | "ru";
+        explicitView: boolean;
+        requestedAnswerLanguage: "en" | "ru";
+        inferredView: "all" | "factual" | "history" | "planning" | "reports" | "questions" | "discussion";
+        recallStatus: "unavailable" | "ok" | "empty" | "degraded";
+        recallDegraded: ("language_mismatch" | "language_check_failed" | "prose_discourse_unresolved" | "no_embedding_model" | "no_reranker" | "no_derive_model" | "no_expansion_model" | "embedding_failed" | "rerank_failed" | "derive_failed" | "retain_verification_failed" | "retain_apply_failed" | "partial_temporal_index" | "partial_memory_index" | "timeline_range_limited" | "expansion_failed" | "no_vector_index" | "partial_index" | "no_document_text" | "document_source_missing" | "source_conflict" | "no_graph_index" | "no_entity_index" | "entity_resolution_failed" | "partial_graph_index" | "graph_traversal_limited" | "no_answer_model" | "answer_failed" | "answer_verification_failed" | "answer_truncated")[];
+        retainedEvidence: number;
+        reviewRetrieval: {
+            text: string;
+            qualification: {
+                status: "qualified";
+                id: string;
+                level: 1;
+                kind: "claim" | "question" | "plan" | "decision" | "preference" | "event";
+                subject: string;
+                source_role: "unknown" | "external" | "user" | "assistant";
+                commitment: "none" | "tentative" | "asserted" | "hypothetical" | "counterfactual";
+                disposition: "completed" | "rejected" | "active" | "proposed" | "accepted" | "resolved" | "cancelled" | "superseded";
+                polarity: "affirmed" | "negated";
+                basis: "self_attested" | "source_report" | "cited_evidence" | "system_record";
+                answer_eligible: boolean;
+                current_eligible: boolean;
+                source_speaker?: string | undefined;
+                temporal?: {
+                    time: {
+                        precision: "unknown" | "instant" | "day" | "month" | "year";
+                        relation: "occurred" | "valid" | "scheduled" | "due";
+                        status: "tentative" | "scheduled" | "actual" | "planned";
+                        start?: string | undefined;
+                        until?: string | undefined;
+                        timezone?: string | undefined;
+                        mentioned_at?: string | undefined;
+                        recurrence?: {
+                            frequency: "daily" | "weekly" | "monthly" | "yearly";
+                            interval?: number | undefined;
+                            weekdays?: ("mo" | "tu" | "we" | "th" | "fr" | "sa" | "su")[] | undefined;
+                            until?: string | undefined;
+                        } | undefined;
+                    };
+                    clock_relation: "past" | "today" | "current_period" | "ongoing" | "future" | "overdue" | "undated";
+                    actionable: boolean;
+                } | undefined;
+            };
+        }[];
+        contextStatus: "unavailable" | "ok" | "empty" | "degraded";
+        contextDegraded: ("language_mismatch" | "language_check_failed" | "prose_discourse_unresolved" | "no_embedding_model" | "no_reranker" | "no_derive_model" | "no_expansion_model" | "embedding_failed" | "rerank_failed" | "derive_failed" | "retain_verification_failed" | "retain_apply_failed" | "partial_temporal_index" | "partial_memory_index" | "timeline_range_limited" | "expansion_failed" | "no_vector_index" | "partial_index" | "no_document_text" | "document_source_missing" | "source_conflict" | "no_graph_index" | "no_entity_index" | "entity_resolution_failed" | "partial_graph_index" | "graph_traversal_limited" | "no_answer_model" | "answer_failed" | "answer_verification_failed" | "answer_truncated")[];
+        contextActivated: boolean;
+        contextActivation: {
+            activated: boolean;
+            basis: "none" | "exact" | "semantic" | "qualified";
+            candidates: number;
+            selected: number;
+            qualification_run: boolean;
+            reference_resolution: "unresolved" | "not_needed" | "resolved" | "ambiguous";
+        } | null;
+        reviewContext: ({
+            slug: string;
+            title: string;
+            role: "knowledge" | "source" | "inference" | "ignored";
+            summary: string | null;
+            score: number;
+            lines: {
+                n: number;
+                text: string;
+                prose?: {
+                    status: "unresolved" | "qualified";
+                    view: "factual" | "history" | "planning" | "reports" | "questions" | "discussion";
+                    reason: "comment" | "question" | "tentative" | "plan" | "asserted" | "rejected" | "heading" | "heading_scope" | "conditional" | "quotation" | "speaker" | "example" | "context_limit";
+                    answer_eligible: boolean;
+                    source_hash: string;
+                    frame: {
+                        n: number;
+                        text: string;
+                    }[];
+                } | undefined;
+                confidence?: number | undefined;
+                memory?: {
+                    status: "qualified";
+                    id: string;
+                    level: 1;
+                    kind: "claim" | "question" | "plan" | "decision" | "preference" | "event";
+                    subject: string;
+                    source_role: "unknown" | "external" | "user" | "assistant";
+                    commitment: "none" | "tentative" | "asserted" | "hypothetical" | "counterfactual";
+                    disposition: "completed" | "rejected" | "active" | "proposed" | "accepted" | "resolved" | "cancelled" | "superseded";
+                    polarity: "affirmed" | "negated";
+                    basis: "self_attested" | "source_report" | "cited_evidence" | "system_record";
+                    answer_eligible: boolean;
+                    current_eligible: boolean;
+                    source_speaker?: string | undefined;
+                    temporal?: {
+                        time: {
+                            precision: "unknown" | "instant" | "day" | "month" | "year";
+                            relation: "occurred" | "valid" | "scheduled" | "due";
+                            status: "tentative" | "scheduled" | "actual" | "planned";
+                            start?: string | undefined;
+                            until?: string | undefined;
+                            timezone?: string | undefined;
+                            mentioned_at?: string | undefined;
+                            recurrence?: {
+                                frequency: "daily" | "weekly" | "monthly" | "yearly";
+                                interval?: number | undefined;
+                                weekdays?: ("mo" | "tu" | "we" | "th" | "fr" | "sa" | "su")[] | undefined;
+                                until?: string | undefined;
+                            } | undefined;
+                        };
+                        clock_relation: "past" | "today" | "current_period" | "ongoing" | "future" | "overdue" | "undated";
+                        actionable: boolean;
+                    } | undefined;
+                } | {
+                    status: "unavailable";
+                    id: string;
+                    answer_eligible: false;
+                } | undefined;
+                observation?: {
+                    status: "eligible";
+                    id: string;
+                    level: 2;
+                    subject: string;
+                    disposition: "active" | "superseded" | "weakened" | "retracted";
+                    proof_count: number;
+                    evidence: {
+                        fact: string;
+                        slug: string;
+                        line: number;
+                        line_hash: string;
+                        proof_groups: string[];
+                    }[];
+                    scope_assessment?: {
+                        status: "assessed";
+                        fingerprint: string;
+                    } | undefined;
+                } | {
+                    status: "ineligible";
+                    id: string;
+                    level: 2;
+                    disposition: "active" | "superseded" | "weakened" | "retracted";
+                    reason: string;
+                } | undefined;
+                fact?: string | undefined;
+            }[];
+            type: "page";
+            breadcrumb?: string | undefined;
+            updated?: string | undefined;
+            relevance?: number | undefined;
+            superseded?: {
+                claim: string;
+                valid_to: string;
+            }[] | undefined;
+            links?: string[] | undefined;
+            documents?: {
+                id: string;
+                rel_path?: string | undefined;
+                mime?: string | undefined;
+                label?: string | undefined;
+                pages?: number | undefined;
+                parts?: number | undefined;
+                matched_page?: number | undefined;
+                summary?: string | undefined;
+                quote?: string | undefined;
+                availability?: {
+                    status: "unavailable" | "degraded" | "available";
+                    available_from: ("original" | "indexed_text" | "rendition")[];
+                    missing_originals: string[];
+                    available_renditions: string[];
+                    missing_since?: string | undefined;
+                } | undefined;
+            }[] | undefined;
+            truncated?: boolean | undefined;
+            matched_by?: ("graph" | "lexical" | "vector")[] | undefined;
+            graph_paths?: {
+                seed: {
+                    id: string;
+                    kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                    slug?: string | undefined;
+                    label?: string | undefined;
+                    role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                    entity?: string | undefined;
+                    entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                    document?: string | undefined;
+                    fact?: string | undefined;
+                    event?: string | undefined;
+                    memory?: string | undefined;
+                    observation?: string | undefined;
+                    date?: string | undefined;
+                    line_start?: number | undefined;
+                    line_end?: number | undefined;
+                    availability?: "unavailable" | "degraded" | "available" | undefined;
+                };
+                target: {
+                    id: string;
+                    kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                    slug?: string | undefined;
+                    label?: string | undefined;
+                    role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                    entity?: string | undefined;
+                    entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                    document?: string | undefined;
+                    fact?: string | undefined;
+                    event?: string | undefined;
+                    memory?: string | undefined;
+                    observation?: string | undefined;
+                    date?: string | undefined;
+                    line_start?: number | undefined;
+                    line_end?: number | undefined;
+                    availability?: "unavailable" | "degraded" | "available" | undefined;
+                };
+                nodes: {
+                    id: string;
+                    kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                    slug?: string | undefined;
+                    label?: string | undefined;
+                    role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                    entity?: string | undefined;
+                    entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                    document?: string | undefined;
+                    fact?: string | undefined;
+                    event?: string | undefined;
+                    memory?: string | undefined;
+                    observation?: string | undefined;
+                    date?: string | undefined;
+                    line_start?: number | undefined;
+                    line_end?: number | undefined;
+                    availability?: "unavailable" | "degraded" | "available" | undefined;
+                }[];
+                relations: ("about" | "corrects" | "supersedes" | "contradicts" | "fulfills" | "answers" | "caused_by" | "canonical_record" | "links_to" | "mentions" | "has_attribute" | "related_entity" | "owns_document" | "participates_in" | "derived_from")[];
+                hops: number;
+                confidence: number;
+                evidence: {
+                    kind: "document" | "frontmatter" | "page_line" | "fact_line";
+                    slug?: string | undefined;
+                    document?: string | undefined;
+                    event?: string | undefined;
+                    fact?: string | undefined;
+                    memory?: string | undefined;
+                    line_start?: number | undefined;
+                    line_end?: number | undefined;
+                    field?: string | undefined;
+                }[];
+            }[] | undefined;
+        } | {
+            type: "document";
+            id: string;
+            path: string;
+            label: string;
+            mime: string | null;
+            source: {
+                kind: "none" | "original_text" | "ocr_text" | "model_description";
+                via: "none" | "vision" | "plain" | "text-layer" | "ocr" | "textutil" | "libreoffice";
+                confidence?: number | null | undefined;
+            };
+            ownership: {
+                status: "orphan";
+            };
+            score: number;
+            summary?: string | undefined;
+            quote?: string | undefined;
+            matched_page?: number | undefined;
+            parts?: {
+                id: string;
+                path: string;
+                pages?: number | null | undefined;
+            }[] | undefined;
+            availability?: {
+                status: "unavailable" | "degraded" | "available";
+                available_from: ("original" | "indexed_text" | "rendition")[];
+                missing_originals: string[];
+                available_renditions: string[];
+                missing_since?: string | undefined;
+            } | undefined;
+            suggested_actions?: {
+                op: "adopt";
+                args: {
+                    documentId: string;
+                };
+            }[] | undefined;
+            relevance?: number | undefined;
+            matched_by?: ("graph" | "lexical" | "vector")[] | undefined;
+            graph_paths?: {
+                seed: {
+                    id: string;
+                    kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                    slug?: string | undefined;
+                    label?: string | undefined;
+                    role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                    entity?: string | undefined;
+                    entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                    document?: string | undefined;
+                    fact?: string | undefined;
+                    event?: string | undefined;
+                    memory?: string | undefined;
+                    observation?: string | undefined;
+                    date?: string | undefined;
+                    line_start?: number | undefined;
+                    line_end?: number | undefined;
+                    availability?: "unavailable" | "degraded" | "available" | undefined;
+                };
+                target: {
+                    id: string;
+                    kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                    slug?: string | undefined;
+                    label?: string | undefined;
+                    role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                    entity?: string | undefined;
+                    entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                    document?: string | undefined;
+                    fact?: string | undefined;
+                    event?: string | undefined;
+                    memory?: string | undefined;
+                    observation?: string | undefined;
+                    date?: string | undefined;
+                    line_start?: number | undefined;
+                    line_end?: number | undefined;
+                    availability?: "unavailable" | "degraded" | "available" | undefined;
+                };
+                nodes: {
+                    id: string;
+                    kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
+                    slug?: string | undefined;
+                    label?: string | undefined;
+                    role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
+                    entity?: string | undefined;
+                    entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
+                    document?: string | undefined;
+                    fact?: string | undefined;
+                    event?: string | undefined;
+                    memory?: string | undefined;
+                    observation?: string | undefined;
+                    date?: string | undefined;
+                    line_start?: number | undefined;
+                    line_end?: number | undefined;
+                    availability?: "unavailable" | "degraded" | "available" | undefined;
+                }[];
+                relations: ("about" | "corrects" | "supersedes" | "contradicts" | "fulfills" | "answers" | "caused_by" | "canonical_record" | "links_to" | "mentions" | "has_attribute" | "related_entity" | "owns_document" | "participates_in" | "derived_from")[];
+                hops: number;
+                confidence: number;
+                evidence: {
+                    kind: "document" | "frontmatter" | "page_line" | "fact_line";
+                    slug?: string | undefined;
+                    document?: string | undefined;
+                    event?: string | undefined;
+                    fact?: string | undefined;
+                    memory?: string | undefined;
+                    line_start?: number | undefined;
+                    line_end?: number | undefined;
+                    field?: string | undefined;
+                }[];
+            }[] | undefined;
+        })[];
+        contextKnowledgeLanguage: "en" | null | undefined;
+        answerOutcome: "not_found" | "partial" | "complete" | "not_answered";
+        answerReason: "no_results" | "evidence_unavailable" | "retrieval_incomplete" | "no_eligible_evidence" | "generation_unavailable" | "generation_failed" | "invalid_draft" | "empty_draft" | "draft_rejected" | "verification_unavailable" | "verification_rejected" | "answered" | null;
+        answerValidation: {
+            generated_blocks: number;
+            passed_guards: number;
+            verified_blocks: number | null;
+            rejection_counts: Partial<Record<"attribution" | "discourse" | "language" | "citation" | "protected_value" | "semantic_support", number>>;
+        } | null;
+        answerDegraded: ("language_mismatch" | "language_check_failed" | "prose_discourse_unresolved" | "no_embedding_model" | "no_reranker" | "no_derive_model" | "no_expansion_model" | "embedding_failed" | "rerank_failed" | "derive_failed" | "retain_verification_failed" | "retain_apply_failed" | "partial_temporal_index" | "partial_memory_index" | "timeline_range_limited" | "expansion_failed" | "no_vector_index" | "partial_index" | "no_document_text" | "document_source_missing" | "source_conflict" | "no_graph_index" | "no_entity_index" | "entity_resolution_failed" | "partial_graph_index" | "graph_traversal_limited" | "no_answer_model" | "answer_failed" | "answer_verification_failed" | "answer_truncated")[];
+        answerModelUsage: {
+            generation: {
+                model: string;
+                latency_ms: number;
+                input_tokens: number | null;
+                output_tokens: number | null;
+                total_tokens: number | null;
+            } | null;
+            verification: {
+                model: string;
+                latency_ms: number;
+                input_tokens: number | null;
+                output_tokens: number | null;
+                total_tokens: number | null;
+            } | null;
+        };
+        reviewAnswer: string | null;
+    }[];
+    reviewKnowledge: {
+        text: string;
+        qualification: {
+            status: "qualified";
+            id: string;
+            level: 1;
+            kind: "claim" | "question" | "plan" | "decision" | "preference" | "event";
+            subject: string;
+            source_role: "unknown" | "external" | "user" | "assistant";
+            commitment: "none" | "tentative" | "asserted" | "hypothetical" | "counterfactual";
+            disposition: "completed" | "rejected" | "active" | "proposed" | "accepted" | "resolved" | "cancelled" | "superseded";
+            polarity: "affirmed" | "negated";
+            basis: "self_attested" | "source_report" | "cited_evidence" | "system_record";
+            answer_eligible: boolean;
+            current_eligible: boolean;
+            source_speaker?: string | undefined;
+            temporal?: {
+                time: {
+                    precision: "unknown" | "instant" | "day" | "month" | "year";
+                    relation: "occurred" | "valid" | "scheduled" | "due";
+                    status: "tentative" | "scheduled" | "actual" | "planned";
+                    start?: string | undefined;
+                    until?: string | undefined;
+                    timezone?: string | undefined;
+                    mentioned_at?: string | undefined;
+                    recurrence?: {
+                        frequency: "daily" | "weekly" | "monthly" | "yearly";
+                        interval?: number | undefined;
+                        weekdays?: ("mo" | "tu" | "we" | "th" | "fr" | "sa" | "su")[] | undefined;
+                        until?: string | undefined;
+                    } | undefined;
+                };
+                clock_relation: "past" | "today" | "current_period" | "ongoing" | "future" | "overdue" | "undated";
+                actionable: boolean;
+            } | undefined;
+        };
+    }[];
+    error: null;
+    id: string;
+    run: number;
+    admission: string;
+    reviewExpectation: string | null;
+    language: "en" | "ru" | "mixed";
+    scenario: string;
+    expectedHold: boolean;
+    nonfactualExpected: boolean;
+} | {
+    retentionAvailabilityFailure: boolean;
+    availabilityFailure: boolean;
+    languageRejected: boolean;
+    retention: null;
+    retainedItems: number;
+    noncanonicalEligibilityFlag: boolean;
+    semanticsMatch: boolean;
+    ordinaryCorrect: boolean;
+    bytesStable: null;
+    replayOutcome: null;
+    queries: never[];
+    reviewKnowledge: never[];
+    error: string;
+    id: string;
+    run: number;
+    admission: string;
+    reviewExpectation: string | null;
+    language: "en" | "ru" | "mixed";
+    scenario: string;
+    expectedHold: boolean;
+    nonfactualExpected: boolean;
 }>;
+export {};
 //# sourceMappingURL=language.d.ts.map