@kirkchinese/dsh-citeciter 0.9.0-alpha.3 → 0.9.0-beta.2

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.
Files changed (89) hide show
  1. package/README.md +68 -139
  2. package/README.zh.md +70 -141
  3. package/lib/client.js +4020 -1830
  4. package/lib/index.js +16928 -16567
  5. package/lib/{typert-common-BQpqe5Ph.js → typert-common-g1lnIG8u.js} +3 -5
  6. package/lib/typert.host.js +2 -2
  7. package/lib/typert.remote-client.js +1 -1
  8. package/lib/types/actions.d.ts +22 -14
  9. package/lib/types/blackboard-tool.d.ts +6 -0
  10. package/lib/types/blocking-question-recovery.d.ts +16 -0
  11. package/lib/types/board.d.ts +0 -15
  12. package/lib/types/client/action-controller.d.ts +9 -2
  13. package/lib/types/client/action-executor.d.ts +5 -1
  14. package/lib/types/client/board-citation.d.ts +8 -0
  15. package/lib/types/client/citer-session-face.d.ts +3 -2
  16. package/lib/types/client/companion-controller.d.ts +18 -9
  17. package/lib/types/client/components/{WheelSettings.d.ts → ActionSettings.d.ts} +2 -2
  18. package/lib/types/client/components/ActionWheel.d.ts +4 -4
  19. package/lib/types/client/components/CiteCiterSettings.d.ts +1 -1
  20. package/lib/types/client/components/CiteLauncher.d.ts +7 -2
  21. package/lib/types/client/components/CitePanel.d.ts +4 -1
  22. package/lib/types/client/components/CiterPet.d.ts +10 -0
  23. package/lib/types/client/components/DocumentReader.d.ts +2 -4
  24. package/lib/types/client/components/LearningRoute.d.ts +3 -4
  25. package/lib/types/client/components/ModelChoice.d.ts +7 -3
  26. package/lib/types/client/components/QuestionCard.d.ts +8 -4
  27. package/lib/types/client/components/QuestionReplyBody.d.ts +5 -0
  28. package/lib/types/client/components/ReferenceAttachments.d.ts +6 -2
  29. package/lib/types/client/components/SelectionToolbar.d.ts +19 -0
  30. package/lib/types/client/components/ToolMessage.d.ts +1 -1
  31. package/lib/types/client/components/TopicActions.d.ts +15 -4
  32. package/lib/types/client/components/TopicComposer.d.ts +2 -1
  33. package/lib/types/client/components/TopicHeader.d.ts +8 -3
  34. package/lib/types/client/components/TopicNavigation.d.ts +4 -4
  35. package/lib/types/client/components/TopicQuestions.d.ts +10 -0
  36. package/lib/types/client/components/TopicTitle.d.ts +6 -2
  37. package/lib/types/client/components/UserMessageBody.d.ts +4 -1
  38. package/lib/types/client/conversation-dom.d.ts +0 -7
  39. package/lib/types/client/draft-controller.d.ts +3 -6
  40. package/lib/types/client/draft-merge.d.ts +8 -0
  41. package/lib/types/client/draft-references.d.ts +6 -0
  42. package/lib/types/client/host-dock.d.ts +1 -1
  43. package/lib/types/client/host-icons.d.ts +2 -13
  44. package/lib/types/client/host-image-preview.d.ts +2 -1
  45. package/lib/types/client/host-source-chat.d.ts +11 -0
  46. package/lib/types/client/host-ui-adapter.d.ts +2 -2
  47. package/lib/types/client/native-composer.d.ts +15 -0
  48. package/lib/types/client/prompt.d.ts +4 -4
  49. package/lib/types/client/question-draft-controller.d.ts +50 -0
  50. package/lib/types/client/question-interaction.d.ts +33 -0
  51. package/lib/types/client/request-guard.d.ts +3 -13
  52. package/lib/types/client/selection-toolbar.d.ts +36 -0
  53. package/lib/types/client/tool-presentation.d.ts +14 -0
  54. package/lib/types/client/topic-presentation.d.ts +0 -7
  55. package/lib/types/client/topic-question-controller.d.ts +80 -0
  56. package/lib/types/client/types.d.ts +3 -4
  57. package/lib/types/client/wheel-gesture.d.ts +6 -1
  58. package/lib/types/document-access.d.ts +7 -2
  59. package/lib/types/host-agent-modules.d.ts +16 -6
  60. package/lib/types/host-session-adapter.d.ts +7 -4
  61. package/lib/types/host-settings-adapter.d.ts +5 -5
  62. package/lib/types/index.d.ts +8 -8
  63. package/lib/types/learning-cards-tool.d.ts +5 -0
  64. package/lib/types/learning.d.ts +0 -4
  65. package/lib/types/legacy-migration.d.ts +16 -0
  66. package/lib/types/observer.d.ts +0 -7
  67. package/lib/types/question-draft-contract.d.ts +55 -0
  68. package/lib/types/question-draft-lifecycle.d.ts +8 -0
  69. package/lib/types/question-draft-store.d.ts +38 -0
  70. package/lib/types/question-reply.d.ts +23 -0
  71. package/lib/types/source-read-tool.d.ts +3 -4
  72. package/lib/types/tool-approval-projection.d.ts +10 -0
  73. package/lib/types/tool-events.d.ts +2 -0
  74. package/lib/types/tool-outcome-contract.d.ts +3 -0
  75. package/lib/types/topic-deletion-receipts.d.ts +40 -0
  76. package/lib/types/topic-index.d.ts +26 -30
  77. package/lib/types/topic-log.d.ts +41 -0
  78. package/lib/types/topic-prompts.d.ts +8 -1
  79. package/lib/types/topic-question-bridge.d.ts +10 -0
  80. package/lib/types/topic-questions.d.ts +53 -0
  81. package/lib/types/topic-runtime.d.ts +21 -317
  82. package/lib/types/topic.d.ts +219 -177
  83. package/lib/types/typert-codec.d.ts +2 -4
  84. package/lib/types/typert-common.d.ts +251 -1138
  85. package/lib/types/typert.host.d.ts +525 -2584
  86. package/lib/types/update.d.ts +0 -7
  87. package/lib/{update-CRD1jFLf.js → update-B_0nN1_f.js} +215 -121
  88. package/package.json +68 -79
  89. package/lib/types/client/components/TopicSettingsDialog.d.ts +0 -21
@@ -9,61 +9,27 @@ export declare const DEFAULT_TOPIC_SCENARIO: "qa";
9
9
  export declare const CITECITER_SETTINGS_NAMESPACE: "citeciter";
10
10
  /** Topic-scoped system prompt section. */
11
11
  export declare const TUTOR_SECTION_NAME: "@kirkchinese/dsh-citeciter:tutor";
12
- /** Topic-scoped, user-role Citation context. */
13
- export declare const CITATION_CONTEXT_NAME: "@kirkchinese/dsh-citeciter:citation";
14
- export declare const topicModeSchema: z.ZodEnum<{
15
- observer: "observer";
16
- "exact-fork": "exact-fork";
17
- }>;
18
- export type TopicMode = z.infer<typeof topicModeSchema>;
19
- /**
20
- * Topic turn-content scenario. Orthogonal to {@link TopicMode}: mode describes
21
- * the source-session timing relation, scenario selects the assembled tool set,
22
- * prompt sections, and future loop decorations for this Topic.
23
- */
24
- export declare const topicScenarioSchema: z.ZodEnum<{
25
- qa: "qa";
26
- present: "present";
27
- read: "read";
28
- investigate: "investigate";
29
- }>;
30
- export type TopicScenario = z.infer<typeof topicScenarioSchema>;
31
- /** One user-editable prompt template shown beside the selection popover. */
32
- export declare const promptTemplateSchema: z.ZodObject<{
33
- id: z.ZodString;
34
- label: z.ZodString;
35
- text: z.ZodString;
36
- }, z.core.$strict>;
37
- export type PromptTemplate = z.infer<typeof promptTemplateSchema>;
38
- /** User preferences applied to new Topics and source reads. */
12
+ /** User preferences applied to new Topics, source reads and the browser panel. */
39
13
  export declare const citeCiterSettingsSchema: z.ZodObject<{
40
- defaultMode: z.ZodEnum<{
41
- observer: "observer";
42
- "exact-when-available": "exact-when-available";
43
- }>;
44
14
  includeSourceReasoning: z.ZodBoolean;
45
- allowSourceFiles: z.ZodBoolean;
46
15
  panelWidthPercent: z.ZodNumber;
47
16
  reopenLastTopic: z.ZodBoolean;
48
17
  tutorPrompt: z.ZodOptional<z.ZodString>;
49
18
  followupQuestions: z.ZodOptional<z.ZodBoolean>;
50
- promptTemplates: z.ZodOptional<z.ZodArray<z.ZodObject<{
51
- id: z.ZodString;
52
- label: z.ZodString;
53
- text: z.ZodString;
54
- }, z.core.$strict>>>;
55
19
  shortcutOpenPanel: z.ZodOptional<z.ZodString>;
56
20
  boardAnimations: z.ZodOptional<z.ZodBoolean>;
57
21
  activeRecall: z.ZodOptional<z.ZodBoolean>;
58
22
  updateNotifications: z.ZodOptional<z.ZodBoolean>;
23
+ selectionToolbar: z.ZodOptional<z.ZodBoolean>;
24
+ actionDelivery: z.ZodOptional<z.ZodEnum<{
25
+ send: "send";
26
+ draft: "draft";
27
+ }>>;
28
+ wheelEnabled: z.ZodOptional<z.ZodBoolean>;
59
29
  wheelSlots: z.ZodOptional<z.ZodArray<z.ZodNullable<z.ZodObject<{
60
30
  label: z.ZodString;
61
31
  prompt: z.ZodString;
62
32
  ask: z.ZodBoolean;
63
- scenario: z.ZodEnum<{
64
- qa: "qa";
65
- present: "present";
66
- }>;
67
33
  presentation: z.ZodEnum<{
68
34
  side: "side";
69
35
  floating: "floating";
@@ -72,7 +38,7 @@ export declare const citeCiterSettingsSchema: z.ZodObject<{
72
38
  current: "current";
73
39
  new: "new";
74
40
  }>>;
75
- }, z.core.$strict>>>>;
41
+ }, z.core.$strip>>>>;
76
42
  wheelTrigger: z.ZodOptional<z.ZodEnum<{
77
43
  "right-button": "right-button";
78
44
  Alt: "Alt";
@@ -94,6 +60,13 @@ export declare const citeCiterSettingsSchema: z.ZodObject<{
94
60
  export type CiteCiterSettings = z.infer<typeof citeCiterSettingsSchema>;
95
61
  /** Settings used before an optional DSH settings provider becomes available. */
96
62
  export declare const DEFAULT_CITECITER_SETTINGS: CiteCiterSettings;
63
+ /**
64
+ * Read persisted settings field by field. Keys written by other versions are
65
+ * ignored, and an invalid value falls back to its default without discarding the rest.
66
+ * @param raw - settings value from the Host configuration.
67
+ * @returns complete settings for this version.
68
+ */
69
+ export declare function readCiteCiterSettings(raw: unknown): CiteCiterSettings;
97
70
  /** Browser-visible selection resolved by the Host against one committed model call. */
98
71
  export declare const citationSelectionClaimSchema: z.ZodObject<{
99
72
  sourceSessionId: z.ZodString;
@@ -116,7 +89,7 @@ export declare const citationDraftSchema: z.ZodObject<{
116
89
  suffixText: z.ZodString;
117
90
  selectionFingerprint: z.ZodString;
118
91
  }, z.core.$strict>;
119
- /** Exact Citation retained for durable data and legacy 0.3.1 requests. */
92
+ /** Host-resolved assistant-message Citation before it becomes a durable record. */
120
93
  export type CitationDraft = z.infer<typeof citationDraftSchema>;
121
94
  /**
122
95
  * Evidence anchor discriminator for one durable Citation. `anchorSeq` mirrors
@@ -341,6 +314,17 @@ export type TopicMetadata = z.infer<typeof topicMetadataSchema>;
341
314
  * @returns canonical TopicMetadata.
342
315
  */
343
316
  export declare function parseTopicMetadataFile(raw: unknown): TopicMetadata;
317
+ /**
318
+ * The title a Topic shows. DSH's fallback title repeats the first prompt, which for a Topic
319
+ * is Citer's action instructions, so the excerpt or question it started from stays until a
320
+ * provider or the user names the Topic.
321
+ * @param metadata - the Topic's cached and temporary titles.
322
+ * @returns the display title and whether a real title is still pending.
323
+ */
324
+ export declare function topicDisplayTitle(metadata: Pick<TopicMetadata, 'temporaryTitle' | 'cachedTitle' | 'cachedTitleSource'>): {
325
+ readonly title: string;
326
+ readonly pending: boolean;
327
+ };
344
328
  export declare const permissionSchema: z.ZodEnum<{
345
329
  "read-only": "read-only";
346
330
  "workspace-write": "workspace-write";
@@ -353,21 +337,9 @@ export declare const topicSummarySchema: z.ZodObject<{
353
337
  "workspace-write": "workspace-write";
354
338
  "danger-full-access": "danger-full-access";
355
339
  }>>;
356
- hosted: z.ZodOptional<z.ZodBoolean>;
357
- storage: z.ZodOptional<z.ZodLiteral<"source">>;
358
340
  topicId: z.ZodNumber;
359
341
  sessionId: z.ZodString;
360
342
  sourceSessionId: z.ZodString;
361
- mode: z.ZodEnum<{
362
- observer: "observer";
363
- "exact-fork": "exact-fork";
364
- }>;
365
- scenario: z.ZodEnum<{
366
- qa: "qa";
367
- present: "present";
368
- read: "read";
369
- investigate: "investigate";
370
- }>;
371
343
  documentId: z.ZodNullable<z.ZodString>;
372
344
  citation: z.ZodNullable<z.ZodObject<{
373
345
  entry: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -426,6 +398,15 @@ export declare const topicSummarySchema: z.ZodObject<{
426
398
  export type TopicSummary = z.infer<typeof topicSummarySchema>;
427
399
  export declare const topicMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
428
400
  role: z.ZodLiteral<"user">;
401
+ questionReply: z.ZodOptional<z.ZodObject<{
402
+ callId: z.ZodString;
403
+ items: z.ZodArray<z.ZodObject<{
404
+ id: z.ZodString;
405
+ question: z.ZodString;
406
+ header: z.ZodOptional<z.ZodString>;
407
+ values: z.ZodArray<z.ZodString>;
408
+ }, z.core.$strict>>;
409
+ }, z.core.$strict>>;
429
410
  attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
430
411
  kind: z.ZodEnum<{
431
412
  file: "file";
@@ -453,6 +434,15 @@ export declare const topicMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
453
434
  seq: z.ZodNumber;
454
435
  }, z.core.$strict>, z.ZodObject<{
455
436
  role: z.ZodLiteral<"tool">;
437
+ questionReply: z.ZodOptional<z.ZodObject<{
438
+ callId: z.ZodString;
439
+ items: z.ZodArray<z.ZodObject<{
440
+ id: z.ZodString;
441
+ question: z.ZodString;
442
+ header: z.ZodOptional<z.ZodString>;
443
+ values: z.ZodArray<z.ZodString>;
444
+ }, z.core.$strict>>;
445
+ }, z.core.$strict>>;
456
446
  attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
457
447
  kind: z.ZodEnum<{
458
448
  file: "file";
@@ -465,6 +455,12 @@ export declare const topicMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
465
455
  arguments: z.ZodString;
466
456
  result: z.ZodNullable<z.ZodString>;
467
457
  isError: z.ZodBoolean;
458
+ errorCode: z.ZodOptional<z.ZodEnum<{
459
+ ASK_CANCELLED: "ASK_CANCELLED";
460
+ ASK_ABORTED: "ASK_ABORTED";
461
+ }>>;
462
+ approvalOutcome: z.ZodOptional<z.ZodLiteral<"rejected">>;
463
+ interruptionOutcome: z.ZodOptional<z.ZodLiteral<"interrupted">>;
468
464
  running: z.ZodBoolean;
469
465
  id: z.ZodString;
470
466
  seq: z.ZodNumber;
@@ -489,6 +485,7 @@ export declare const questionItemSchema: z.ZodObject<{
489
485
  id: z.ZodString;
490
486
  question: z.ZodString;
491
487
  header: z.ZodOptional<z.ZodString>;
488
+ detail: z.ZodOptional<z.ZodString>;
492
489
  options: z.ZodOptional<z.ZodArray<z.ZodObject<{
493
490
  label: z.ZodString;
494
491
  description: z.ZodOptional<z.ZodString>;
@@ -509,12 +506,20 @@ export declare const pendingQuestionSchema: z.ZodObject<{
509
506
  id: z.ZodString;
510
507
  question: z.ZodString;
511
508
  header: z.ZodOptional<z.ZodString>;
509
+ detail: z.ZodOptional<z.ZodString>;
512
510
  options: z.ZodOptional<z.ZodArray<z.ZodObject<{
513
511
  label: z.ZodString;
514
512
  description: z.ZodOptional<z.ZodString>;
515
513
  }, z.core.$strict>>>;
516
514
  multiSelect: z.ZodOptional<z.ZodBoolean>;
517
515
  }, z.core.$strict>>;
516
+ state: z.ZodOptional<z.ZodEnum<{
517
+ open: "open";
518
+ continued: "continued";
519
+ }>>;
520
+ callId: z.ZodOptional<z.ZodString>;
521
+ timed: z.ZodOptional<z.ZodBoolean>;
522
+ blocking: z.ZodOptional<z.ZodBoolean>;
518
523
  }, z.core.$strict>;
519
524
  export type PendingQuestion = z.infer<typeof pendingQuestionSchema>;
520
525
  export declare const topicSnapshotSchema: z.ZodObject<{
@@ -527,21 +532,9 @@ export declare const topicSnapshotSchema: z.ZodObject<{
527
532
  "workspace-write": "workspace-write";
528
533
  "danger-full-access": "danger-full-access";
529
534
  }>>;
530
- hosted: z.ZodOptional<z.ZodBoolean>;
531
- storage: z.ZodOptional<z.ZodLiteral<"source">>;
532
535
  topicId: z.ZodNumber;
533
536
  sessionId: z.ZodString;
534
537
  sourceSessionId: z.ZodString;
535
- mode: z.ZodEnum<{
536
- observer: "observer";
537
- "exact-fork": "exact-fork";
538
- }>;
539
- scenario: z.ZodEnum<{
540
- qa: "qa";
541
- present: "present";
542
- read: "read";
543
- investigate: "investigate";
544
- }>;
545
538
  documentId: z.ZodNullable<z.ZodString>;
546
539
  citation: z.ZodNullable<z.ZodObject<{
547
540
  entry: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -599,6 +592,15 @@ export declare const topicSnapshotSchema: z.ZodObject<{
599
592
  }, z.core.$strict>;
600
593
  messages: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
601
594
  role: z.ZodLiteral<"user">;
595
+ questionReply: z.ZodOptional<z.ZodObject<{
596
+ callId: z.ZodString;
597
+ items: z.ZodArray<z.ZodObject<{
598
+ id: z.ZodString;
599
+ question: z.ZodString;
600
+ header: z.ZodOptional<z.ZodString>;
601
+ values: z.ZodArray<z.ZodString>;
602
+ }, z.core.$strict>>;
603
+ }, z.core.$strict>>;
602
604
  attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
603
605
  kind: z.ZodEnum<{
604
606
  file: "file";
@@ -626,6 +628,15 @@ export declare const topicSnapshotSchema: z.ZodObject<{
626
628
  seq: z.ZodNumber;
627
629
  }, z.core.$strict>, z.ZodObject<{
628
630
  role: z.ZodLiteral<"tool">;
631
+ questionReply: z.ZodOptional<z.ZodObject<{
632
+ callId: z.ZodString;
633
+ items: z.ZodArray<z.ZodObject<{
634
+ id: z.ZodString;
635
+ question: z.ZodString;
636
+ header: z.ZodOptional<z.ZodString>;
637
+ values: z.ZodArray<z.ZodString>;
638
+ }, z.core.$strict>>;
639
+ }, z.core.$strict>>;
629
640
  attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
630
641
  kind: z.ZodEnum<{
631
642
  file: "file";
@@ -638,6 +649,12 @@ export declare const topicSnapshotSchema: z.ZodObject<{
638
649
  arguments: z.ZodString;
639
650
  result: z.ZodNullable<z.ZodString>;
640
651
  isError: z.ZodBoolean;
652
+ errorCode: z.ZodOptional<z.ZodEnum<{
653
+ ASK_CANCELLED: "ASK_CANCELLED";
654
+ ASK_ABORTED: "ASK_ABORTED";
655
+ }>>;
656
+ approvalOutcome: z.ZodOptional<z.ZodLiteral<"rejected">>;
657
+ interruptionOutcome: z.ZodOptional<z.ZodLiteral<"interrupted">>;
641
658
  running: z.ZodBoolean;
642
659
  id: z.ZodString;
643
660
  seq: z.ZodNumber;
@@ -659,13 +676,42 @@ export declare const topicSnapshotSchema: z.ZodObject<{
659
676
  id: z.ZodString;
660
677
  question: z.ZodString;
661
678
  header: z.ZodOptional<z.ZodString>;
679
+ detail: z.ZodOptional<z.ZodString>;
662
680
  options: z.ZodOptional<z.ZodArray<z.ZodObject<{
663
681
  label: z.ZodString;
664
682
  description: z.ZodOptional<z.ZodString>;
665
683
  }, z.core.$strict>>>;
666
684
  multiSelect: z.ZodOptional<z.ZodBoolean>;
667
685
  }, z.core.$strict>>;
686
+ state: z.ZodOptional<z.ZodEnum<{
687
+ open: "open";
688
+ continued: "continued";
689
+ }>>;
690
+ callId: z.ZodOptional<z.ZodString>;
691
+ timed: z.ZodOptional<z.ZodBoolean>;
692
+ blocking: z.ZodOptional<z.ZodBoolean>;
668
693
  }, z.core.$strict>>;
694
+ pendingQuestions: z.ZodOptional<z.ZodArray<z.ZodObject<{
695
+ key: z.ZodString;
696
+ questions: z.ZodArray<z.ZodObject<{
697
+ id: z.ZodString;
698
+ question: z.ZodString;
699
+ header: z.ZodOptional<z.ZodString>;
700
+ detail: z.ZodOptional<z.ZodString>;
701
+ options: z.ZodOptional<z.ZodArray<z.ZodObject<{
702
+ label: z.ZodString;
703
+ description: z.ZodOptional<z.ZodString>;
704
+ }, z.core.$strict>>>;
705
+ multiSelect: z.ZodOptional<z.ZodBoolean>;
706
+ }, z.core.$strict>>;
707
+ state: z.ZodOptional<z.ZodEnum<{
708
+ open: "open";
709
+ continued: "continued";
710
+ }>>;
711
+ callId: z.ZodOptional<z.ZodString>;
712
+ timed: z.ZodOptional<z.ZodBoolean>;
713
+ blocking: z.ZodOptional<z.ZodBoolean>;
714
+ }, z.core.$strict>>>;
669
715
  error: z.ZodNullable<z.ZodString>;
670
716
  board: z.ZodOptional<z.ZodObject<{
671
717
  version: z.ZodLiteral<4>;
@@ -787,56 +833,15 @@ export declare const documentContentSchema: z.ZodObject<{
787
833
  export type DocumentContent = z.infer<typeof documentContentSchema>;
788
834
  /** One strict direct-RPC command for the private CiteCiter runtime. */
789
835
  export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
790
- action: z.ZodLiteral<"create">;
791
- modelRoute: z.ZodOptional<z.ZodObject<{
792
- provider: z.ZodString;
793
- model: z.ZodString;
794
- }, z.core.$strict>>;
795
- requestId: z.ZodString;
796
836
  sourceSessionId: z.ZodString;
797
- question: z.ZodString;
798
- mode: z.ZodLiteral<"observer">;
799
- scenario: z.ZodOptional<z.ZodEnum<{
800
- qa: "qa";
801
- present: "present";
802
- }>>;
803
- }, z.core.$strict>, z.ZodObject<{
804
837
  action: z.ZodLiteral<"create">;
805
838
  modelRoute: z.ZodOptional<z.ZodObject<{
806
839
  provider: z.ZodString;
807
840
  model: z.ZodString;
808
841
  }, z.core.$strict>>;
809
842
  requestId: z.ZodString;
810
- citation: z.ZodObject<{
811
- sourceSessionId: z.ZodString;
812
- anchorSeq: z.ZodNumber;
813
- startOffset: z.ZodNumber;
814
- endOffset: z.ZodNumber;
815
- sourceText: z.ZodString;
816
- displayText: z.ZodString;
817
- prefixText: z.ZodString;
818
- suffixText: z.ZodString;
819
- selectionFingerprint: z.ZodString;
820
- }, z.core.$strict>;
821
843
  question: z.ZodString;
822
- mode: z.ZodEnum<{
823
- observer: "observer";
824
- "exact-fork": "exact-fork";
825
- "exact-when-available": "exact-when-available";
826
- }>;
827
- scenario: z.ZodOptional<z.ZodEnum<{
828
- qa: "qa";
829
- present: "present";
830
- read: "read";
831
- investigate: "investigate";
832
- }>>;
833
844
  }, z.core.$strict>, z.ZodObject<{
834
- action: z.ZodLiteral<"create">;
835
- modelRoute: z.ZodOptional<z.ZodObject<{
836
- provider: z.ZodString;
837
- model: z.ZodString;
838
- }, z.core.$strict>>;
839
- requestId: z.ZodString;
840
845
  selectionClaim: z.ZodObject<{
841
846
  sourceSessionId: z.ZodString;
842
847
  anchorSeq: z.ZodNumber;
@@ -845,25 +850,14 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
845
850
  prefixText: z.ZodString;
846
851
  suffixText: z.ZodString;
847
852
  }, z.core.$strict>;
848
- question: z.ZodString;
849
- mode: z.ZodEnum<{
850
- observer: "observer";
851
- "exact-fork": "exact-fork";
852
- "exact-when-available": "exact-when-available";
853
- }>;
854
- scenario: z.ZodOptional<z.ZodEnum<{
855
- qa: "qa";
856
- present: "present";
857
- read: "read";
858
- investigate: "investigate";
859
- }>>;
860
- }, z.core.$strict>, z.ZodObject<{
861
853
  action: z.ZodLiteral<"create">;
862
854
  modelRoute: z.ZodOptional<z.ZodObject<{
863
855
  provider: z.ZodString;
864
856
  model: z.ZodString;
865
857
  }, z.core.$strict>>;
866
858
  requestId: z.ZodString;
859
+ question: z.ZodString;
860
+ }, z.core.$strict>, z.ZodObject<{
867
861
  toolClaim: z.ZodObject<{
868
862
  sourceSessionId: z.ZodString;
869
863
  callId: z.ZodString;
@@ -874,25 +868,14 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
874
868
  diff: "diff";
875
869
  }>>;
876
870
  }, z.core.$strict>;
877
- question: z.ZodString;
878
- mode: z.ZodEnum<{
879
- observer: "observer";
880
- "exact-fork": "exact-fork";
881
- "exact-when-available": "exact-when-available";
882
- }>;
883
- scenario: z.ZodOptional<z.ZodEnum<{
884
- qa: "qa";
885
- present: "present";
886
- read: "read";
887
- investigate: "investigate";
888
- }>>;
889
- }, z.core.$strict>, z.ZodObject<{
890
871
  action: z.ZodLiteral<"create">;
891
872
  modelRoute: z.ZodOptional<z.ZodObject<{
892
873
  provider: z.ZodString;
893
874
  model: z.ZodString;
894
875
  }, z.core.$strict>>;
895
876
  requestId: z.ZodString;
877
+ question: z.ZodString;
878
+ }, z.core.$strict>, z.ZodObject<{
896
879
  documentClaim: z.ZodObject<{
897
880
  sourceSessionId: z.ZodString;
898
881
  documentId: z.ZodString;
@@ -900,19 +883,35 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
900
883
  prefixText: z.ZodString;
901
884
  suffixText: z.ZodString;
902
885
  }, z.core.$strict>;
886
+ action: z.ZodLiteral<"create">;
887
+ modelRoute: z.ZodOptional<z.ZodObject<{
888
+ provider: z.ZodString;
889
+ model: z.ZodString;
890
+ }, z.core.$strict>>;
891
+ requestId: z.ZodString;
903
892
  question: z.ZodString;
904
- mode: z.ZodEnum<{
905
- observer: "observer";
906
- "exact-fork": "exact-fork";
907
- "exact-when-available": "exact-when-available";
908
- }>;
909
- scenario: z.ZodOptional<z.ZodEnum<{
910
- qa: "qa";
911
- present: "present";
912
- read: "read";
913
- investigate: "investigate";
914
- }>>;
915
893
  }, z.core.$strict>]>, z.ZodDiscriminatedUnion<[z.ZodObject<{
894
+ action: z.ZodLiteral<"question-draft-get">;
895
+ topicSessionId: z.ZodString;
896
+ key: z.ZodString;
897
+ }, z.core.$strict>, z.ZodObject<{
898
+ action: z.ZodLiteral<"question-draft-save">;
899
+ topicSessionId: z.ZodString;
900
+ key: z.ZodString;
901
+ state: z.ZodObject<{
902
+ version: z.ZodLiteral<1>;
903
+ revision: z.ZodNumber;
904
+ content: z.ZodObject<{
905
+ answers: z.ZodRecord<z.ZodString, z.ZodObject<{
906
+ selected: z.ZodArray<z.ZodString>;
907
+ custom: z.ZodString;
908
+ }, z.core.$strict>>;
909
+ page: z.ZodNumber;
910
+ edited: z.ZodBoolean;
911
+ held: z.ZodBoolean;
912
+ }, z.core.$strict>;
913
+ }, z.core.$strict>;
914
+ }, z.core.$strict>, z.ZodObject<{
916
915
  action: z.ZodLiteral<"draft-get">;
917
916
  topicSessionId: z.ZodString;
918
917
  }, z.core.$strict>, z.ZodObject<{
@@ -1026,10 +1025,15 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
1026
1025
  custom: z.ZodOptional<z.ZodString>;
1027
1026
  }, z.core.$strict>>;
1028
1027
  }, z.core.$strict>;
1028
+ draftRevision: z.ZodOptional<z.ZodNumber>;
1029
1029
  }, z.core.$strict>, z.ZodObject<{
1030
1030
  action: z.ZodLiteral<"cancel-question">;
1031
1031
  topicSessionId: z.ZodString;
1032
1032
  key: z.ZodString;
1033
+ }, z.core.$strict>, z.ZodObject<{
1034
+ action: z.ZodLiteral<"timeout-question">;
1035
+ topicSessionId: z.ZodString;
1036
+ key: z.ZodString;
1033
1037
  }, z.core.$strict>, z.ZodObject<{
1034
1038
  action: z.ZodLiteral<"rename">;
1035
1039
  topicSessionId: z.ZodString;
@@ -1061,12 +1065,6 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
1061
1065
  action: z.ZodLiteral<"set-reasoning-effort">;
1062
1066
  topicSessionId: z.ZodString;
1063
1067
  reasoningEffort: z.ZodNullable<z.ZodString>;
1064
- }, z.core.$strict>, z.ZodObject<{
1065
- action: z.ZodLiteral<"select-model">;
1066
- topicSessionId: z.ZodString;
1067
- provider: z.ZodString;
1068
- model: z.ZodString;
1069
- reasoningEffort: z.ZodNullable<z.ZodString>;
1070
1068
  }, z.core.$strict>, z.ZodObject<{
1071
1069
  action: z.ZodLiteral<"document-import">;
1072
1070
  requestId: z.ZodOptional<z.ZodString>;
@@ -1086,6 +1084,23 @@ export declare const citeCiterRequestSchema: z.ZodUnion<readonly [z.ZodUnion<rea
1086
1084
  export type CiteCiterRequest = z.infer<typeof citeCiterRequestSchema>;
1087
1085
  /** Strict response union returned by the single Remote command endpoint. */
1088
1086
  export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1087
+ kind: z.ZodLiteral<"question-draft">;
1088
+ state: z.ZodObject<{
1089
+ version: z.ZodLiteral<1>;
1090
+ revision: z.ZodNumber;
1091
+ content: z.ZodObject<{
1092
+ answers: z.ZodRecord<z.ZodString, z.ZodObject<{
1093
+ selected: z.ZodArray<z.ZodString>;
1094
+ custom: z.ZodString;
1095
+ }, z.core.$strict>>;
1096
+ page: z.ZodNumber;
1097
+ edited: z.ZodBoolean;
1098
+ held: z.ZodBoolean;
1099
+ }, z.core.$strict>;
1100
+ }, z.core.$strict>;
1101
+ conflict: z.ZodBoolean;
1102
+ closed: z.ZodBoolean;
1103
+ }, z.core.$strict>, z.ZodObject<{
1089
1104
  kind: z.ZodLiteral<"draft">;
1090
1105
  state: z.ZodObject<{
1091
1106
  version: z.ZodLiteral<1>;
@@ -1332,21 +1347,9 @@ export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObje
1332
1347
  "workspace-write": "workspace-write";
1333
1348
  "danger-full-access": "danger-full-access";
1334
1349
  }>>;
1335
- hosted: z.ZodOptional<z.ZodBoolean>;
1336
- storage: z.ZodOptional<z.ZodLiteral<"source">>;
1337
1350
  topicId: z.ZodNumber;
1338
1351
  sessionId: z.ZodString;
1339
1352
  sourceSessionId: z.ZodString;
1340
- mode: z.ZodEnum<{
1341
- observer: "observer";
1342
- "exact-fork": "exact-fork";
1343
- }>;
1344
- scenario: z.ZodEnum<{
1345
- qa: "qa";
1346
- present: "present";
1347
- read: "read";
1348
- investigate: "investigate";
1349
- }>;
1350
1353
  documentId: z.ZodNullable<z.ZodString>;
1351
1354
  citation: z.ZodNullable<z.ZodObject<{
1352
1355
  entry: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1404,6 +1407,15 @@ export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObje
1404
1407
  }, z.core.$strict>;
1405
1408
  messages: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
1406
1409
  role: z.ZodLiteral<"user">;
1410
+ questionReply: z.ZodOptional<z.ZodObject<{
1411
+ callId: z.ZodString;
1412
+ items: z.ZodArray<z.ZodObject<{
1413
+ id: z.ZodString;
1414
+ question: z.ZodString;
1415
+ header: z.ZodOptional<z.ZodString>;
1416
+ values: z.ZodArray<z.ZodString>;
1417
+ }, z.core.$strict>>;
1418
+ }, z.core.$strict>>;
1407
1419
  attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
1408
1420
  kind: z.ZodEnum<{
1409
1421
  file: "file";
@@ -1431,6 +1443,15 @@ export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObje
1431
1443
  seq: z.ZodNumber;
1432
1444
  }, z.core.$strict>, z.ZodObject<{
1433
1445
  role: z.ZodLiteral<"tool">;
1446
+ questionReply: z.ZodOptional<z.ZodObject<{
1447
+ callId: z.ZodString;
1448
+ items: z.ZodArray<z.ZodObject<{
1449
+ id: z.ZodString;
1450
+ question: z.ZodString;
1451
+ header: z.ZodOptional<z.ZodString>;
1452
+ values: z.ZodArray<z.ZodString>;
1453
+ }, z.core.$strict>>;
1454
+ }, z.core.$strict>>;
1434
1455
  attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
1435
1456
  kind: z.ZodEnum<{
1436
1457
  file: "file";
@@ -1443,6 +1464,12 @@ export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObje
1443
1464
  arguments: z.ZodString;
1444
1465
  result: z.ZodNullable<z.ZodString>;
1445
1466
  isError: z.ZodBoolean;
1467
+ errorCode: z.ZodOptional<z.ZodEnum<{
1468
+ ASK_CANCELLED: "ASK_CANCELLED";
1469
+ ASK_ABORTED: "ASK_ABORTED";
1470
+ }>>;
1471
+ approvalOutcome: z.ZodOptional<z.ZodLiteral<"rejected">>;
1472
+ interruptionOutcome: z.ZodOptional<z.ZodLiteral<"interrupted">>;
1446
1473
  running: z.ZodBoolean;
1447
1474
  id: z.ZodString;
1448
1475
  seq: z.ZodNumber;
@@ -1464,13 +1491,42 @@ export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObje
1464
1491
  id: z.ZodString;
1465
1492
  question: z.ZodString;
1466
1493
  header: z.ZodOptional<z.ZodString>;
1494
+ detail: z.ZodOptional<z.ZodString>;
1467
1495
  options: z.ZodOptional<z.ZodArray<z.ZodObject<{
1468
1496
  label: z.ZodString;
1469
1497
  description: z.ZodOptional<z.ZodString>;
1470
1498
  }, z.core.$strict>>>;
1471
1499
  multiSelect: z.ZodOptional<z.ZodBoolean>;
1472
1500
  }, z.core.$strict>>;
1501
+ state: z.ZodOptional<z.ZodEnum<{
1502
+ open: "open";
1503
+ continued: "continued";
1504
+ }>>;
1505
+ callId: z.ZodOptional<z.ZodString>;
1506
+ timed: z.ZodOptional<z.ZodBoolean>;
1507
+ blocking: z.ZodOptional<z.ZodBoolean>;
1473
1508
  }, z.core.$strict>>;
1509
+ pendingQuestions: z.ZodOptional<z.ZodArray<z.ZodObject<{
1510
+ key: z.ZodString;
1511
+ questions: z.ZodArray<z.ZodObject<{
1512
+ id: z.ZodString;
1513
+ question: z.ZodString;
1514
+ header: z.ZodOptional<z.ZodString>;
1515
+ detail: z.ZodOptional<z.ZodString>;
1516
+ options: z.ZodOptional<z.ZodArray<z.ZodObject<{
1517
+ label: z.ZodString;
1518
+ description: z.ZodOptional<z.ZodString>;
1519
+ }, z.core.$strict>>>;
1520
+ multiSelect: z.ZodOptional<z.ZodBoolean>;
1521
+ }, z.core.$strict>>;
1522
+ state: z.ZodOptional<z.ZodEnum<{
1523
+ open: "open";
1524
+ continued: "continued";
1525
+ }>>;
1526
+ callId: z.ZodOptional<z.ZodString>;
1527
+ timed: z.ZodOptional<z.ZodBoolean>;
1528
+ blocking: z.ZodOptional<z.ZodBoolean>;
1529
+ }, z.core.$strict>>>;
1474
1530
  error: z.ZodNullable<z.ZodString>;
1475
1531
  board: z.ZodOptional<z.ZodObject<{
1476
1532
  version: z.ZodLiteral<4>;
@@ -1520,21 +1576,9 @@ export declare const citeCiterResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObje
1520
1576
  "workspace-write": "workspace-write";
1521
1577
  "danger-full-access": "danger-full-access";
1522
1578
  }>>;
1523
- hosted: z.ZodOptional<z.ZodBoolean>;
1524
- storage: z.ZodOptional<z.ZodLiteral<"source">>;
1525
1579
  topicId: z.ZodNumber;
1526
1580
  sessionId: z.ZodString;
1527
1581
  sourceSessionId: z.ZodString;
1528
- mode: z.ZodEnum<{
1529
- observer: "observer";
1530
- "exact-fork": "exact-fork";
1531
- }>;
1532
- scenario: z.ZodEnum<{
1533
- qa: "qa";
1534
- present: "present";
1535
- read: "read";
1536
- investigate: "investigate";
1537
- }>;
1538
1582
  documentId: z.ZodNullable<z.ZodString>;
1539
1583
  citation: z.ZodNullable<z.ZodObject<{
1540
1584
  entry: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1660,6 +1704,4 @@ export type CitationIdentity = Omit<CitationDraft, 'selectionFingerprint'> & {
1660
1704
  };
1661
1705
  /** Serialize the identity-bearing fields. Legacy drafts without an entry keep their v3 identity. */
1662
1706
  export declare function canonicalCitationIdentity(citation: CitationIdentity): string;
1663
- /** Render the immutable Citation as explicitly untrusted user-role context. */
1664
- export declare function renderCitationContext(citation: CitationRecord): string;
1665
1707
  export {};
@@ -1,13 +1,11 @@
1
- /** Public Typert schema forms: 0.1.5 reads schema; 0.1.7 creates it lazily. Both refer to one schema. */
1
+ /** Official Typert lazily resolves schemas after module registration. */
2
2
  export declare function strictCodec<T>(typeSymbol: string, schema: T): {
3
3
  mode: "strict";
4
4
  typeSymbol: string;
5
- schema: T;
6
5
  create: () => T;
7
6
  };
8
- /** Publish the same named schema through both supported registry contracts. */
7
+ /** Register one named schema through the official registry contract. */
9
8
  export declare function namedSchema<T>(name: string, schema: T): {
10
9
  name: string;
11
- schema: T;
12
10
  create: () => T;
13
11
  };