@tenphi/akno-core 0.13.0 → 0.13.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,35 +2,16 @@ import type { AknoConfig } from '../config/schema.ts';
2
2
  import { type LanguageCase } from './language-corpus.ts';
3
3
  export interface LanguageBenchOptions {
4
4
  split: LanguageCase['split'];
5
- corpus?: 'v1' | 'v2' | 'v3' | 'v4' | 'v5' | 'v6' | 'v7' | 'v8' | 'v9' | 'v10' | 'v11' | 'v12' | 'v13' | 'v14' | 'v15' | 'v16' | 'v17' | 'v18' | 'v19' | 'v20' | 'v21' | 'v22';
5
+ corpus?: 'v1' | 'v2' | 'v3' | 'v4' | 'v5' | 'v6' | 'v7' | 'v8' | 'v9' | 'v10' | 'v11' | 'v12' | 'v13' | 'v14' | 'v15' | 'v16' | 'v17' | 'v18' | 'v19' | 'v20' | 'v21' | 'v22' | 'v23';
6
6
  runs?: number;
7
7
  caseIds?: string[];
8
+ /** Exercise the supplied reranker as well as populated vector retrieval. */
9
+ fullRetrieval?: boolean;
10
+ onCaseResult?: (result: Awaited<ReturnType<typeof runCase>>) => void;
8
11
  onProgress?: (id: string, done: number, total: number) => void;
9
12
  }
10
13
  /** Runs only invented inputs. Provider permissions/settings come from the caller's configured roles. */
11
14
  export declare function runLanguageBench(config: AknoConfig, options: LanguageBenchOptions): Promise<{
12
- schemaVersion: string;
13
- createdAt: string;
14
- corpusVersion: string;
15
- corpusFingerprint: string;
16
- selectedCaseIds: string[];
17
- runs: number;
18
- setup: string;
19
- queryMatrix: string[];
20
- split: "development" | "held-out";
21
- knowledgeLanguage: string;
22
- proseProjectionVersion: string;
23
- memoryViewVersion: string;
24
- answerPromptVersion: string;
25
- answerVerifierVersion: string;
26
- retentionPromptVersion: string;
27
- retentionVerifierVersion: string;
28
- models: {
29
- retention: string | null;
30
- answer: string | null;
31
- embedding: string | null;
32
- expansion: string | null;
33
- };
34
15
  modelOutputTokenLimits: {
35
16
  answer: number | null;
36
17
  retention: number | null;
@@ -215,6 +196,21 @@ export declare function runLanguageBench(config: AknoConfig, options: LanguageBe
215
196
  };
216
197
  bytesStable: boolean;
217
198
  replayOutcome: "ok" | "held" | "noop" | "replayed" | "revision_conflict" | undefined;
199
+ sourceArchive: {
200
+ stableAcrossRebuildReplay: boolean;
201
+ supports: {
202
+ hashValid: boolean;
203
+ spans: {
204
+ quote: string;
205
+ matchingSourceItems: string[];
206
+ }[];
207
+ memory_id: string;
208
+ source_ref: string;
209
+ input_hash: string;
210
+ evidence: string;
211
+ evidence_hash: string;
212
+ }[];
213
+ };
218
214
  queries: {
219
215
  queryLanguage: "en" | "ru";
220
216
  explicitView: boolean;
@@ -271,6 +267,297 @@ export declare function runLanguageBench(config: AknoConfig, options: LanguageBe
271
267
  qualification_run: boolean;
272
268
  reference_resolution: "unresolved" | "not_needed" | "resolved" | "ambiguous";
273
269
  } | null;
270
+ reviewContext: ({
271
+ slug: string;
272
+ title: string;
273
+ role: "knowledge" | "source" | "inference" | "ignored";
274
+ summary: string | null;
275
+ score: number;
276
+ lines: {
277
+ n: number;
278
+ text: string;
279
+ prose?: {
280
+ status: "unresolved" | "qualified";
281
+ view: "factual" | "history" | "planning" | "reports" | "questions" | "discussion";
282
+ reason: "comment" | "question" | "tentative" | "plan" | "asserted" | "rejected" | "heading" | "heading_scope" | "conditional" | "quotation" | "speaker" | "example" | "context_limit";
283
+ answer_eligible: boolean;
284
+ source_hash: string;
285
+ frame: {
286
+ n: number;
287
+ text: string;
288
+ }[];
289
+ } | undefined;
290
+ confidence?: number | undefined;
291
+ memory?: {
292
+ status: "qualified";
293
+ id: string;
294
+ level: 1;
295
+ kind: "claim" | "question" | "plan" | "decision" | "preference" | "event";
296
+ subject: string;
297
+ source_role: "unknown" | "external" | "user" | "assistant";
298
+ commitment: "none" | "tentative" | "asserted" | "hypothetical" | "counterfactual";
299
+ disposition: "completed" | "rejected" | "active" | "proposed" | "accepted" | "resolved" | "cancelled" | "superseded";
300
+ polarity: "affirmed" | "negated";
301
+ basis: "self_attested" | "source_report" | "cited_evidence" | "system_record";
302
+ answer_eligible: boolean;
303
+ current_eligible: boolean;
304
+ source_speaker?: string | undefined;
305
+ temporal?: {
306
+ time: {
307
+ precision: "unknown" | "instant" | "day" | "month" | "year";
308
+ relation: "occurred" | "valid" | "scheduled" | "due";
309
+ status: "tentative" | "scheduled" | "actual" | "planned";
310
+ start?: string | undefined;
311
+ until?: string | undefined;
312
+ timezone?: string | undefined;
313
+ mentioned_at?: string | undefined;
314
+ recurrence?: {
315
+ frequency: "daily" | "weekly" | "monthly" | "yearly";
316
+ interval?: number | undefined;
317
+ weekdays?: ("mo" | "tu" | "we" | "th" | "fr" | "sa" | "su")[] | undefined;
318
+ until?: string | undefined;
319
+ } | undefined;
320
+ };
321
+ clock_relation: "past" | "today" | "current_period" | "ongoing" | "future" | "overdue" | "undated";
322
+ actionable: boolean;
323
+ } | undefined;
324
+ } | {
325
+ status: "unavailable";
326
+ id: string;
327
+ answer_eligible: false;
328
+ } | undefined;
329
+ observation?: {
330
+ status: "eligible";
331
+ id: string;
332
+ level: 2;
333
+ subject: string;
334
+ disposition: "active" | "superseded" | "weakened" | "retracted";
335
+ proof_count: number;
336
+ evidence: {
337
+ fact: string;
338
+ slug: string;
339
+ line: number;
340
+ line_hash: string;
341
+ proof_groups: string[];
342
+ }[];
343
+ } | {
344
+ status: "ineligible";
345
+ id: string;
346
+ level: 2;
347
+ disposition: "active" | "superseded" | "weakened" | "retracted";
348
+ reason: string;
349
+ } | undefined;
350
+ fact?: string | undefined;
351
+ }[];
352
+ type: "page";
353
+ breadcrumb?: string | undefined;
354
+ updated?: string | undefined;
355
+ relevance?: number | undefined;
356
+ superseded?: {
357
+ claim: string;
358
+ valid_to: string;
359
+ }[] | undefined;
360
+ links?: string[] | undefined;
361
+ documents?: {
362
+ id: string;
363
+ rel_path?: string | undefined;
364
+ mime?: string | undefined;
365
+ label?: string | undefined;
366
+ pages?: number | undefined;
367
+ parts?: number | undefined;
368
+ matched_page?: number | undefined;
369
+ summary?: string | undefined;
370
+ quote?: string | undefined;
371
+ availability?: {
372
+ status: "unavailable" | "degraded" | "available";
373
+ available_from: ("original" | "indexed_text" | "rendition")[];
374
+ missing_originals: string[];
375
+ available_renditions: string[];
376
+ missing_since?: string | undefined;
377
+ } | undefined;
378
+ }[] | undefined;
379
+ truncated?: boolean | undefined;
380
+ matched_by?: ("graph" | "lexical" | "vector")[] | undefined;
381
+ graph_paths?: {
382
+ seed: {
383
+ id: string;
384
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
385
+ slug?: string | undefined;
386
+ label?: string | undefined;
387
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
388
+ entity?: string | undefined;
389
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
390
+ document?: string | undefined;
391
+ fact?: string | undefined;
392
+ event?: string | undefined;
393
+ memory?: string | undefined;
394
+ observation?: string | undefined;
395
+ date?: string | undefined;
396
+ line_start?: number | undefined;
397
+ line_end?: number | undefined;
398
+ availability?: "unavailable" | "degraded" | "available" | undefined;
399
+ };
400
+ target: {
401
+ id: string;
402
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
403
+ slug?: string | undefined;
404
+ label?: string | undefined;
405
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
406
+ entity?: string | undefined;
407
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
408
+ document?: string | undefined;
409
+ fact?: string | undefined;
410
+ event?: string | undefined;
411
+ memory?: string | undefined;
412
+ observation?: string | undefined;
413
+ date?: string | undefined;
414
+ line_start?: number | undefined;
415
+ line_end?: number | undefined;
416
+ availability?: "unavailable" | "degraded" | "available" | undefined;
417
+ };
418
+ nodes: {
419
+ id: string;
420
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
421
+ slug?: string | undefined;
422
+ label?: string | undefined;
423
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
424
+ entity?: string | undefined;
425
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
426
+ document?: string | undefined;
427
+ fact?: string | undefined;
428
+ event?: string | undefined;
429
+ memory?: string | undefined;
430
+ observation?: string | undefined;
431
+ date?: string | undefined;
432
+ line_start?: number | undefined;
433
+ line_end?: number | undefined;
434
+ availability?: "unavailable" | "degraded" | "available" | undefined;
435
+ }[];
436
+ relations: ("about" | "corrects" | "supersedes" | "contradicts" | "fulfills" | "answers" | "caused_by" | "canonical_record" | "links_to" | "mentions" | "has_attribute" | "related_entity" | "owns_document" | "participates_in" | "derived_from")[];
437
+ hops: number;
438
+ confidence: number;
439
+ evidence: {
440
+ kind: "document" | "frontmatter" | "page_line" | "fact_line";
441
+ slug?: string | undefined;
442
+ document?: string | undefined;
443
+ event?: string | undefined;
444
+ fact?: string | undefined;
445
+ memory?: string | undefined;
446
+ line_start?: number | undefined;
447
+ line_end?: number | undefined;
448
+ field?: string | undefined;
449
+ }[];
450
+ }[] | undefined;
451
+ } | {
452
+ type: "document";
453
+ id: string;
454
+ path: string;
455
+ label: string;
456
+ mime: string | null;
457
+ source: {
458
+ kind: "none" | "original_text" | "ocr_text" | "model_description";
459
+ via: "none" | "vision" | "plain" | "text-layer" | "ocr" | "textutil" | "libreoffice";
460
+ confidence?: number | null | undefined;
461
+ };
462
+ ownership: {
463
+ status: "orphan";
464
+ };
465
+ score: number;
466
+ summary?: string | undefined;
467
+ quote?: string | undefined;
468
+ matched_page?: number | undefined;
469
+ parts?: {
470
+ id: string;
471
+ path: string;
472
+ pages?: number | null | undefined;
473
+ }[] | undefined;
474
+ availability?: {
475
+ status: "unavailable" | "degraded" | "available";
476
+ available_from: ("original" | "indexed_text" | "rendition")[];
477
+ missing_originals: string[];
478
+ available_renditions: string[];
479
+ missing_since?: string | undefined;
480
+ } | undefined;
481
+ suggested_actions?: {
482
+ op: "adopt";
483
+ args: {
484
+ documentId: string;
485
+ };
486
+ }[] | undefined;
487
+ relevance?: number | undefined;
488
+ matched_by?: ("graph" | "lexical" | "vector")[] | undefined;
489
+ graph_paths?: {
490
+ seed: {
491
+ id: string;
492
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
493
+ slug?: string | undefined;
494
+ label?: string | undefined;
495
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
496
+ entity?: string | undefined;
497
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
498
+ document?: string | undefined;
499
+ fact?: string | undefined;
500
+ event?: string | undefined;
501
+ memory?: string | undefined;
502
+ observation?: string | undefined;
503
+ date?: string | undefined;
504
+ line_start?: number | undefined;
505
+ line_end?: number | undefined;
506
+ availability?: "unavailable" | "degraded" | "available" | undefined;
507
+ };
508
+ target: {
509
+ id: string;
510
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
511
+ slug?: string | undefined;
512
+ label?: string | undefined;
513
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
514
+ entity?: string | undefined;
515
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
516
+ document?: string | undefined;
517
+ fact?: string | undefined;
518
+ event?: string | undefined;
519
+ memory?: string | undefined;
520
+ observation?: string | undefined;
521
+ date?: string | undefined;
522
+ line_start?: number | undefined;
523
+ line_end?: number | undefined;
524
+ availability?: "unavailable" | "degraded" | "available" | undefined;
525
+ };
526
+ nodes: {
527
+ id: string;
528
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
529
+ slug?: string | undefined;
530
+ label?: string | undefined;
531
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
532
+ entity?: string | undefined;
533
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
534
+ document?: string | undefined;
535
+ fact?: string | undefined;
536
+ event?: string | undefined;
537
+ memory?: string | undefined;
538
+ observation?: string | undefined;
539
+ date?: string | undefined;
540
+ line_start?: number | undefined;
541
+ line_end?: number | undefined;
542
+ availability?: "unavailable" | "degraded" | "available" | undefined;
543
+ }[];
544
+ relations: ("about" | "corrects" | "supersedes" | "contradicts" | "fulfills" | "answers" | "caused_by" | "canonical_record" | "links_to" | "mentions" | "has_attribute" | "related_entity" | "owns_document" | "participates_in" | "derived_from")[];
545
+ hops: number;
546
+ confidence: number;
547
+ evidence: {
548
+ kind: "document" | "frontmatter" | "page_line" | "fact_line";
549
+ slug?: string | undefined;
550
+ document?: string | undefined;
551
+ event?: string | undefined;
552
+ fact?: string | undefined;
553
+ memory?: string | undefined;
554
+ line_start?: number | undefined;
555
+ line_end?: number | undefined;
556
+ field?: string | undefined;
557
+ }[];
558
+ }[] | undefined;
559
+ })[];
560
+ contextKnowledgeLanguage: "en" | null | undefined;
274
561
  answerOutcome: "not_found" | "partial" | "complete" | "not_answered";
275
562
  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;
276
563
  answerValidation: {
@@ -367,5 +654,568 @@ export declare function runLanguageBench(config: AknoConfig, options: LanguageBe
367
654
  expectedHold: boolean;
368
655
  nonfactualExpected: boolean;
369
656
  })[];
657
+ retrievalConfiguration?: {
658
+ embeddingDimensions: number | undefined;
659
+ rerankerEnabled: boolean;
660
+ mode: "endpoint" | "llm" | undefined;
661
+ topK: number | undefined;
662
+ maxChars: number | undefined;
663
+ excludeIrrelevant: boolean | undefined;
664
+ scoreOffset: number | "auto" | undefined;
665
+ api: "chat_completions" | "responses" | "auto" | null;
666
+ timeoutMs: number;
667
+ providerRetries: number | null;
668
+ maxOutputTokens: number | undefined;
669
+ reasoningEffort: "none" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
670
+ } | undefined;
671
+ schemaVersion: string;
672
+ createdAt: string;
673
+ corpusVersion: string;
674
+ corpusFingerprint: string;
675
+ selectedCaseIds: string[];
676
+ runs: number;
677
+ setup: string;
678
+ queryMatrix: string[];
679
+ split: "development" | "held-out";
680
+ knowledgeLanguage: string;
681
+ proseProjectionVersion: string;
682
+ memoryViewVersion: string;
683
+ answerPromptVersion: string;
684
+ answerVerifierVersion: string;
685
+ retentionPromptVersion: string;
686
+ retentionVerifierVersion: string;
687
+ models: {
688
+ reranker?: string | null | undefined;
689
+ retention: string | null;
690
+ answer: string | null;
691
+ embedding: string | null;
692
+ expansion: string | null;
693
+ };
694
+ modelConfiguration: {
695
+ [k: string]: {
696
+ enabled: boolean;
697
+ api: "chat_completions" | "responses" | "auto" | null;
698
+ timeoutMs: number;
699
+ maxOutputTokens: number | null;
700
+ reasoningEffort: "none" | "low" | "medium" | "high" | "xhigh" | "max" | null;
701
+ providerRetries: number | null;
702
+ };
703
+ };
704
+ retrievalProfile: string;
705
+ }>;
706
+ 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<{
707
+ retentionAvailabilityFailure: boolean;
708
+ availabilityFailure: boolean;
709
+ languageRejected: boolean;
710
+ retention: {
711
+ status: "unavailable" | "ok" | "empty" | "degraded";
712
+ outcome: "ok" | "held" | "noop" | "replayed" | "revision_conflict" | undefined;
713
+ 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;
714
+ candidates: {
715
+ outcome: "not_found" | "held" | "retracted" | "duplicate" | "written" | "support_added";
716
+ 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;
717
+ holdStage: "verification" | "apply" | "validation" | "placement" | null;
718
+ routingReason: "existing_selected" | "new_selected" | "read_only_match" | "no_admitted_destination" | "ownership_uncertain" | "model_unavailable" | "model_failed" | "invalid_model_response" | null;
719
+ }[] | undefined;
720
+ usage: {
721
+ extraction: {
722
+ model: string;
723
+ latency_ms: number;
724
+ input_tokens: number | null;
725
+ output_tokens: number | null;
726
+ total_tokens: number | null;
727
+ } | null;
728
+ verification: {
729
+ model: string;
730
+ latency_ms: number;
731
+ input_tokens: number | null;
732
+ output_tokens: number | null;
733
+ total_tokens: number | null;
734
+ } | null;
735
+ placement: {
736
+ model: string;
737
+ latency_ms: number;
738
+ input_tokens: number | null;
739
+ output_tokens: number | null;
740
+ total_tokens: number | null;
741
+ }[];
742
+ repair?: {
743
+ model: string;
744
+ latency_ms: number;
745
+ input_tokens: number | null;
746
+ output_tokens: number | null;
747
+ total_tokens: number | null;
748
+ } | undefined;
749
+ } | null;
750
+ 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")[];
751
+ };
752
+ retainedItems: number;
753
+ noncanonicalEligibilityFlag: boolean;
754
+ semanticsMatch: boolean;
755
+ ordinaryCorrect: boolean;
756
+ ordinaryInspection: {
757
+ status: "unavailable" | "ok" | "empty" | "degraded";
758
+ results: number;
759
+ };
760
+ bytesStable: boolean;
761
+ replayOutcome: "ok" | "held" | "noop" | "replayed" | "revision_conflict" | undefined;
762
+ sourceArchive: {
763
+ stableAcrossRebuildReplay: boolean;
764
+ supports: {
765
+ hashValid: boolean;
766
+ spans: {
767
+ quote: string;
768
+ matchingSourceItems: string[];
769
+ }[];
770
+ memory_id: string;
771
+ source_ref: string;
772
+ input_hash: string;
773
+ evidence: string;
774
+ evidence_hash: string;
775
+ }[];
776
+ };
777
+ queries: {
778
+ queryLanguage: "en" | "ru";
779
+ explicitView: boolean;
780
+ requestedAnswerLanguage: "en" | "ru";
781
+ inferredView: "all" | "factual" | "history" | "planning" | "reports" | "questions" | "discussion";
782
+ recallStatus: "unavailable" | "ok" | "empty" | "degraded";
783
+ 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")[];
784
+ retainedEvidence: number;
785
+ reviewRetrieval: {
786
+ text: string;
787
+ qualification: {
788
+ status: "qualified";
789
+ id: string;
790
+ level: 1;
791
+ kind: "claim" | "question" | "plan" | "decision" | "preference" | "event";
792
+ subject: string;
793
+ source_role: "unknown" | "external" | "user" | "assistant";
794
+ commitment: "none" | "tentative" | "asserted" | "hypothetical" | "counterfactual";
795
+ disposition: "completed" | "rejected" | "active" | "proposed" | "accepted" | "resolved" | "cancelled" | "superseded";
796
+ polarity: "affirmed" | "negated";
797
+ basis: "self_attested" | "source_report" | "cited_evidence" | "system_record";
798
+ answer_eligible: boolean;
799
+ current_eligible: boolean;
800
+ source_speaker?: string | undefined;
801
+ temporal?: {
802
+ time: {
803
+ precision: "unknown" | "instant" | "day" | "month" | "year";
804
+ relation: "occurred" | "valid" | "scheduled" | "due";
805
+ status: "tentative" | "scheduled" | "actual" | "planned";
806
+ start?: string | undefined;
807
+ until?: string | undefined;
808
+ timezone?: string | undefined;
809
+ mentioned_at?: string | undefined;
810
+ recurrence?: {
811
+ frequency: "daily" | "weekly" | "monthly" | "yearly";
812
+ interval?: number | undefined;
813
+ weekdays?: ("mo" | "tu" | "we" | "th" | "fr" | "sa" | "su")[] | undefined;
814
+ until?: string | undefined;
815
+ } | undefined;
816
+ };
817
+ clock_relation: "past" | "today" | "current_period" | "ongoing" | "future" | "overdue" | "undated";
818
+ actionable: boolean;
819
+ } | undefined;
820
+ };
821
+ }[];
822
+ contextStatus: "unavailable" | "ok" | "empty" | "degraded";
823
+ 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")[];
824
+ contextActivated: boolean;
825
+ contextActivation: {
826
+ activated: boolean;
827
+ basis: "none" | "exact" | "semantic" | "qualified";
828
+ candidates: number;
829
+ selected: number;
830
+ qualification_run: boolean;
831
+ reference_resolution: "unresolved" | "not_needed" | "resolved" | "ambiguous";
832
+ } | null;
833
+ reviewContext: ({
834
+ slug: string;
835
+ title: string;
836
+ role: "knowledge" | "source" | "inference" | "ignored";
837
+ summary: string | null;
838
+ score: number;
839
+ lines: {
840
+ n: number;
841
+ text: string;
842
+ prose?: {
843
+ status: "unresolved" | "qualified";
844
+ view: "factual" | "history" | "planning" | "reports" | "questions" | "discussion";
845
+ reason: "comment" | "question" | "tentative" | "plan" | "asserted" | "rejected" | "heading" | "heading_scope" | "conditional" | "quotation" | "speaker" | "example" | "context_limit";
846
+ answer_eligible: boolean;
847
+ source_hash: string;
848
+ frame: {
849
+ n: number;
850
+ text: string;
851
+ }[];
852
+ } | undefined;
853
+ confidence?: number | undefined;
854
+ memory?: {
855
+ status: "qualified";
856
+ id: string;
857
+ level: 1;
858
+ kind: "claim" | "question" | "plan" | "decision" | "preference" | "event";
859
+ subject: string;
860
+ source_role: "unknown" | "external" | "user" | "assistant";
861
+ commitment: "none" | "tentative" | "asserted" | "hypothetical" | "counterfactual";
862
+ disposition: "completed" | "rejected" | "active" | "proposed" | "accepted" | "resolved" | "cancelled" | "superseded";
863
+ polarity: "affirmed" | "negated";
864
+ basis: "self_attested" | "source_report" | "cited_evidence" | "system_record";
865
+ answer_eligible: boolean;
866
+ current_eligible: boolean;
867
+ source_speaker?: string | undefined;
868
+ temporal?: {
869
+ time: {
870
+ precision: "unknown" | "instant" | "day" | "month" | "year";
871
+ relation: "occurred" | "valid" | "scheduled" | "due";
872
+ status: "tentative" | "scheduled" | "actual" | "planned";
873
+ start?: string | undefined;
874
+ until?: string | undefined;
875
+ timezone?: string | undefined;
876
+ mentioned_at?: string | undefined;
877
+ recurrence?: {
878
+ frequency: "daily" | "weekly" | "monthly" | "yearly";
879
+ interval?: number | undefined;
880
+ weekdays?: ("mo" | "tu" | "we" | "th" | "fr" | "sa" | "su")[] | undefined;
881
+ until?: string | undefined;
882
+ } | undefined;
883
+ };
884
+ clock_relation: "past" | "today" | "current_period" | "ongoing" | "future" | "overdue" | "undated";
885
+ actionable: boolean;
886
+ } | undefined;
887
+ } | {
888
+ status: "unavailable";
889
+ id: string;
890
+ answer_eligible: false;
891
+ } | undefined;
892
+ observation?: {
893
+ status: "eligible";
894
+ id: string;
895
+ level: 2;
896
+ subject: string;
897
+ disposition: "active" | "superseded" | "weakened" | "retracted";
898
+ proof_count: number;
899
+ evidence: {
900
+ fact: string;
901
+ slug: string;
902
+ line: number;
903
+ line_hash: string;
904
+ proof_groups: string[];
905
+ }[];
906
+ } | {
907
+ status: "ineligible";
908
+ id: string;
909
+ level: 2;
910
+ disposition: "active" | "superseded" | "weakened" | "retracted";
911
+ reason: string;
912
+ } | undefined;
913
+ fact?: string | undefined;
914
+ }[];
915
+ type: "page";
916
+ breadcrumb?: string | undefined;
917
+ updated?: string | undefined;
918
+ relevance?: number | undefined;
919
+ superseded?: {
920
+ claim: string;
921
+ valid_to: string;
922
+ }[] | undefined;
923
+ links?: string[] | undefined;
924
+ documents?: {
925
+ id: string;
926
+ rel_path?: string | undefined;
927
+ mime?: string | undefined;
928
+ label?: string | undefined;
929
+ pages?: number | undefined;
930
+ parts?: number | undefined;
931
+ matched_page?: number | undefined;
932
+ summary?: string | undefined;
933
+ quote?: string | undefined;
934
+ availability?: {
935
+ status: "unavailable" | "degraded" | "available";
936
+ available_from: ("original" | "indexed_text" | "rendition")[];
937
+ missing_originals: string[];
938
+ available_renditions: string[];
939
+ missing_since?: string | undefined;
940
+ } | undefined;
941
+ }[] | undefined;
942
+ truncated?: boolean | undefined;
943
+ matched_by?: ("graph" | "lexical" | "vector")[] | undefined;
944
+ graph_paths?: {
945
+ seed: {
946
+ id: string;
947
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
948
+ slug?: string | undefined;
949
+ label?: string | undefined;
950
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
951
+ entity?: string | undefined;
952
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
953
+ document?: string | undefined;
954
+ fact?: string | undefined;
955
+ event?: string | undefined;
956
+ memory?: string | undefined;
957
+ observation?: string | undefined;
958
+ date?: string | undefined;
959
+ line_start?: number | undefined;
960
+ line_end?: number | undefined;
961
+ availability?: "unavailable" | "degraded" | "available" | undefined;
962
+ };
963
+ target: {
964
+ id: string;
965
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
966
+ slug?: string | undefined;
967
+ label?: string | undefined;
968
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
969
+ entity?: string | undefined;
970
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
971
+ document?: string | undefined;
972
+ fact?: string | undefined;
973
+ event?: string | undefined;
974
+ memory?: string | undefined;
975
+ observation?: string | undefined;
976
+ date?: string | undefined;
977
+ line_start?: number | undefined;
978
+ line_end?: number | undefined;
979
+ availability?: "unavailable" | "degraded" | "available" | undefined;
980
+ };
981
+ nodes: {
982
+ id: string;
983
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
984
+ slug?: string | undefined;
985
+ label?: string | undefined;
986
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
987
+ entity?: string | undefined;
988
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
989
+ document?: string | undefined;
990
+ fact?: string | undefined;
991
+ event?: string | undefined;
992
+ memory?: string | undefined;
993
+ observation?: string | undefined;
994
+ date?: string | undefined;
995
+ line_start?: number | undefined;
996
+ line_end?: number | undefined;
997
+ availability?: "unavailable" | "degraded" | "available" | undefined;
998
+ }[];
999
+ relations: ("about" | "corrects" | "supersedes" | "contradicts" | "fulfills" | "answers" | "caused_by" | "canonical_record" | "links_to" | "mentions" | "has_attribute" | "related_entity" | "owns_document" | "participates_in" | "derived_from")[];
1000
+ hops: number;
1001
+ confidence: number;
1002
+ evidence: {
1003
+ kind: "document" | "frontmatter" | "page_line" | "fact_line";
1004
+ slug?: string | undefined;
1005
+ document?: string | undefined;
1006
+ event?: string | undefined;
1007
+ fact?: string | undefined;
1008
+ memory?: string | undefined;
1009
+ line_start?: number | undefined;
1010
+ line_end?: number | undefined;
1011
+ field?: string | undefined;
1012
+ }[];
1013
+ }[] | undefined;
1014
+ } | {
1015
+ type: "document";
1016
+ id: string;
1017
+ path: string;
1018
+ label: string;
1019
+ mime: string | null;
1020
+ source: {
1021
+ kind: "none" | "original_text" | "ocr_text" | "model_description";
1022
+ via: "none" | "vision" | "plain" | "text-layer" | "ocr" | "textutil" | "libreoffice";
1023
+ confidence?: number | null | undefined;
1024
+ };
1025
+ ownership: {
1026
+ status: "orphan";
1027
+ };
1028
+ score: number;
1029
+ summary?: string | undefined;
1030
+ quote?: string | undefined;
1031
+ matched_page?: number | undefined;
1032
+ parts?: {
1033
+ id: string;
1034
+ path: string;
1035
+ pages?: number | null | undefined;
1036
+ }[] | undefined;
1037
+ availability?: {
1038
+ status: "unavailable" | "degraded" | "available";
1039
+ available_from: ("original" | "indexed_text" | "rendition")[];
1040
+ missing_originals: string[];
1041
+ available_renditions: string[];
1042
+ missing_since?: string | undefined;
1043
+ } | undefined;
1044
+ suggested_actions?: {
1045
+ op: "adopt";
1046
+ args: {
1047
+ documentId: string;
1048
+ };
1049
+ }[] | undefined;
1050
+ relevance?: number | undefined;
1051
+ matched_by?: ("graph" | "lexical" | "vector")[] | undefined;
1052
+ graph_paths?: {
1053
+ seed: {
1054
+ id: string;
1055
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
1056
+ slug?: string | undefined;
1057
+ label?: string | undefined;
1058
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
1059
+ entity?: string | undefined;
1060
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
1061
+ document?: string | undefined;
1062
+ fact?: string | undefined;
1063
+ event?: string | undefined;
1064
+ memory?: string | undefined;
1065
+ observation?: string | undefined;
1066
+ date?: string | undefined;
1067
+ line_start?: number | undefined;
1068
+ line_end?: number | undefined;
1069
+ availability?: "unavailable" | "degraded" | "available" | undefined;
1070
+ };
1071
+ target: {
1072
+ id: string;
1073
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
1074
+ slug?: string | undefined;
1075
+ label?: string | undefined;
1076
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
1077
+ entity?: string | undefined;
1078
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
1079
+ document?: string | undefined;
1080
+ fact?: string | undefined;
1081
+ event?: string | undefined;
1082
+ memory?: string | undefined;
1083
+ observation?: string | undefined;
1084
+ date?: string | undefined;
1085
+ line_start?: number | undefined;
1086
+ line_end?: number | undefined;
1087
+ availability?: "unavailable" | "degraded" | "available" | undefined;
1088
+ };
1089
+ nodes: {
1090
+ id: string;
1091
+ kind: "page" | "document" | "memory" | "observation" | "fact" | "event" | "entity";
1092
+ slug?: string | undefined;
1093
+ label?: string | undefined;
1094
+ role?: "knowledge" | "source" | "inference" | "ignored" | undefined;
1095
+ entity?: string | undefined;
1096
+ entity_type?: "event" | "other" | "person" | "organization" | "place" | "product" | "concept" | undefined;
1097
+ document?: string | undefined;
1098
+ fact?: string | undefined;
1099
+ event?: string | undefined;
1100
+ memory?: string | undefined;
1101
+ observation?: string | undefined;
1102
+ date?: string | undefined;
1103
+ line_start?: number | undefined;
1104
+ line_end?: number | undefined;
1105
+ availability?: "unavailable" | "degraded" | "available" | undefined;
1106
+ }[];
1107
+ relations: ("about" | "corrects" | "supersedes" | "contradicts" | "fulfills" | "answers" | "caused_by" | "canonical_record" | "links_to" | "mentions" | "has_attribute" | "related_entity" | "owns_document" | "participates_in" | "derived_from")[];
1108
+ hops: number;
1109
+ confidence: number;
1110
+ evidence: {
1111
+ kind: "document" | "frontmatter" | "page_line" | "fact_line";
1112
+ slug?: string | undefined;
1113
+ document?: string | undefined;
1114
+ event?: string | undefined;
1115
+ fact?: string | undefined;
1116
+ memory?: string | undefined;
1117
+ line_start?: number | undefined;
1118
+ line_end?: number | undefined;
1119
+ field?: string | undefined;
1120
+ }[];
1121
+ }[] | undefined;
1122
+ })[];
1123
+ contextKnowledgeLanguage: "en" | null | undefined;
1124
+ answerOutcome: "not_found" | "partial" | "complete" | "not_answered";
1125
+ 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;
1126
+ answerValidation: {
1127
+ generated_blocks: number;
1128
+ passed_guards: number;
1129
+ verified_blocks: number | null;
1130
+ rejection_counts: Partial<Record<"attribution" | "discourse" | "language" | "citation" | "protected_value" | "semantic_support", number>>;
1131
+ } | null;
1132
+ 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")[];
1133
+ answerModelUsage: {
1134
+ generation: {
1135
+ model: string;
1136
+ latency_ms: number;
1137
+ input_tokens: number | null;
1138
+ output_tokens: number | null;
1139
+ total_tokens: number | null;
1140
+ } | null;
1141
+ verification: {
1142
+ model: string;
1143
+ latency_ms: number;
1144
+ input_tokens: number | null;
1145
+ output_tokens: number | null;
1146
+ total_tokens: number | null;
1147
+ } | null;
1148
+ };
1149
+ reviewAnswer: string | null;
1150
+ }[];
1151
+ reviewKnowledge: {
1152
+ text: string;
1153
+ qualification: {
1154
+ status: "qualified";
1155
+ id: string;
1156
+ level: 1;
1157
+ kind: "claim" | "question" | "plan" | "decision" | "preference" | "event";
1158
+ subject: string;
1159
+ source_role: "unknown" | "external" | "user" | "assistant";
1160
+ commitment: "none" | "tentative" | "asserted" | "hypothetical" | "counterfactual";
1161
+ disposition: "completed" | "rejected" | "active" | "proposed" | "accepted" | "resolved" | "cancelled" | "superseded";
1162
+ polarity: "affirmed" | "negated";
1163
+ basis: "self_attested" | "source_report" | "cited_evidence" | "system_record";
1164
+ answer_eligible: boolean;
1165
+ current_eligible: boolean;
1166
+ source_speaker?: string | undefined;
1167
+ temporal?: {
1168
+ time: {
1169
+ precision: "unknown" | "instant" | "day" | "month" | "year";
1170
+ relation: "occurred" | "valid" | "scheduled" | "due";
1171
+ status: "tentative" | "scheduled" | "actual" | "planned";
1172
+ start?: string | undefined;
1173
+ until?: string | undefined;
1174
+ timezone?: string | undefined;
1175
+ mentioned_at?: string | undefined;
1176
+ recurrence?: {
1177
+ frequency: "daily" | "weekly" | "monthly" | "yearly";
1178
+ interval?: number | undefined;
1179
+ weekdays?: ("mo" | "tu" | "we" | "th" | "fr" | "sa" | "su")[] | undefined;
1180
+ until?: string | undefined;
1181
+ } | undefined;
1182
+ };
1183
+ clock_relation: "past" | "today" | "current_period" | "ongoing" | "future" | "overdue" | "undated";
1184
+ actionable: boolean;
1185
+ } | undefined;
1186
+ };
1187
+ }[];
1188
+ error: null;
1189
+ id: string;
1190
+ run: number;
1191
+ admission: string;
1192
+ reviewExpectation: string | null;
1193
+ language: "en" | "ru" | "mixed";
1194
+ scenario: string;
1195
+ expectedHold: boolean;
1196
+ nonfactualExpected: boolean;
1197
+ } | {
1198
+ retentionAvailabilityFailure: boolean;
1199
+ availabilityFailure: boolean;
1200
+ languageRejected: boolean;
1201
+ retention: null;
1202
+ retainedItems: number;
1203
+ noncanonicalEligibilityFlag: boolean;
1204
+ semanticsMatch: boolean;
1205
+ ordinaryCorrect: boolean;
1206
+ bytesStable: null;
1207
+ replayOutcome: null;
1208
+ queries: never[];
1209
+ reviewKnowledge: never[];
1210
+ error: string;
1211
+ id: string;
1212
+ run: number;
1213
+ admission: string;
1214
+ reviewExpectation: string | null;
1215
+ language: "en" | "ru" | "mixed";
1216
+ scenario: string;
1217
+ expectedHold: boolean;
1218
+ nonfactualExpected: boolean;
370
1219
  }>;
1220
+ export {};
371
1221
  //# sourceMappingURL=language.d.ts.map