@100xprompt/sdk 0.0.0-dev-202607191034 → 0.1.120

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 (74) hide show
  1. package/LICENSE +3 -0
  2. package/README.md +107 -0
  3. package/dist/client.d.ts +49 -4
  4. package/dist/client.js +122 -14
  5. package/dist/gen/sdk.gen.d.ts +172 -2
  6. package/dist/gen/sdk.gen.js +372 -0
  7. package/dist/gen/types.gen.d.ts +1948 -346
  8. package/package.json +36 -19
  9. package/dist/v2/client.d.ts +0 -7
  10. package/dist/v2/client.js +0 -73
  11. package/dist/v2/gen/client/client.gen.d.ts +0 -2
  12. package/dist/v2/gen/client/client.gen.js +0 -225
  13. package/dist/v2/gen/client/index.d.ts +0 -8
  14. package/dist/v2/gen/client/index.js +0 -6
  15. package/dist/v2/gen/client/types.gen.d.ts +0 -117
  16. package/dist/v2/gen/client/types.gen.js +0 -2
  17. package/dist/v2/gen/client/utils.gen.d.ts +0 -33
  18. package/dist/v2/gen/client/utils.gen.js +0 -226
  19. package/dist/v2/gen/client.gen.d.ts +0 -12
  20. package/dist/v2/gen/client.gen.js +0 -3
  21. package/dist/v2/gen/core/auth.gen.d.ts +0 -18
  22. package/dist/v2/gen/core/auth.gen.js +0 -14
  23. package/dist/v2/gen/core/bodySerializer.gen.d.ts +0 -25
  24. package/dist/v2/gen/core/bodySerializer.gen.js +0 -57
  25. package/dist/v2/gen/core/params.gen.d.ts +0 -43
  26. package/dist/v2/gen/core/params.gen.js +0 -102
  27. package/dist/v2/gen/core/pathSerializer.gen.d.ts +0 -33
  28. package/dist/v2/gen/core/pathSerializer.gen.js +0 -106
  29. package/dist/v2/gen/core/queryKeySerializer.gen.d.ts +0 -18
  30. package/dist/v2/gen/core/queryKeySerializer.gen.js +0 -93
  31. package/dist/v2/gen/core/serverSentEvents.gen.d.ts +0 -71
  32. package/dist/v2/gen/core/serverSentEvents.gen.js +0 -131
  33. package/dist/v2/gen/core/types.gen.d.ts +0 -78
  34. package/dist/v2/gen/core/types.gen.js +0 -2
  35. package/dist/v2/gen/core/utils.gen.d.ts +0 -19
  36. package/dist/v2/gen/core/utils.gen.js +0 -87
  37. package/dist/v2/gen/gen/client/client.gen.d.ts +0 -2
  38. package/dist/v2/gen/gen/client/client.gen.js +0 -225
  39. package/dist/v2/gen/gen/client/index.d.ts +0 -8
  40. package/dist/v2/gen/gen/client/index.js +0 -6
  41. package/dist/v2/gen/gen/client/types.gen.d.ts +0 -117
  42. package/dist/v2/gen/gen/client/types.gen.js +0 -2
  43. package/dist/v2/gen/gen/client/utils.gen.d.ts +0 -33
  44. package/dist/v2/gen/gen/client/utils.gen.js +0 -226
  45. package/dist/v2/gen/gen/client.gen.d.ts +0 -12
  46. package/dist/v2/gen/gen/client.gen.js +0 -3
  47. package/dist/v2/gen/gen/core/auth.gen.d.ts +0 -18
  48. package/dist/v2/gen/gen/core/auth.gen.js +0 -14
  49. package/dist/v2/gen/gen/core/bodySerializer.gen.d.ts +0 -25
  50. package/dist/v2/gen/gen/core/bodySerializer.gen.js +0 -57
  51. package/dist/v2/gen/gen/core/params.gen.d.ts +0 -43
  52. package/dist/v2/gen/gen/core/params.gen.js +0 -102
  53. package/dist/v2/gen/gen/core/pathSerializer.gen.d.ts +0 -33
  54. package/dist/v2/gen/gen/core/pathSerializer.gen.js +0 -106
  55. package/dist/v2/gen/gen/core/queryKeySerializer.gen.d.ts +0 -18
  56. package/dist/v2/gen/gen/core/queryKeySerializer.gen.js +0 -93
  57. package/dist/v2/gen/gen/core/serverSentEvents.gen.d.ts +0 -71
  58. package/dist/v2/gen/gen/core/serverSentEvents.gen.js +0 -131
  59. package/dist/v2/gen/gen/core/types.gen.d.ts +0 -78
  60. package/dist/v2/gen/gen/core/types.gen.js +0 -2
  61. package/dist/v2/gen/gen/core/utils.gen.d.ts +0 -19
  62. package/dist/v2/gen/gen/core/utils.gen.js +0 -87
  63. package/dist/v2/gen/gen/sdk.gen.d.ts +0 -1013
  64. package/dist/v2/gen/gen/sdk.gen.js +0 -1931
  65. package/dist/v2/gen/gen/types.gen.d.ts +0 -4246
  66. package/dist/v2/gen/gen/types.gen.js +0 -2
  67. package/dist/v2/gen/sdk.gen.d.ts +0 -1014
  68. package/dist/v2/gen/sdk.gen.js +0 -1932
  69. package/dist/v2/gen/types.gen.d.ts +0 -4238
  70. package/dist/v2/gen/types.gen.js +0 -2
  71. package/dist/v2/index.d.ts +0 -10
  72. package/dist/v2/index.js +0 -16
  73. package/dist/v2/server.d.ts +0 -23
  74. package/dist/v2/server.js +0 -94
@@ -1,6 +1,18 @@
1
1
  export type ClientOptions = {
2
2
  baseUrl: `${string}://${string}` | (string & {});
3
3
  };
4
+ /**
5
+ * Deprecated: no consumer reads this event. It reports that the feature-flag payload was re-fetched and carries only a source label and a count, not the flags themselves. No replacement — flag values are resolved per call. Scheduled for removal in the next major; still emitted until then.
6
+ *
7
+ * @deprecated
8
+ */
9
+ export type EventFlagRefreshed = {
10
+ type: "flag.refreshed";
11
+ properties: {
12
+ source: string;
13
+ count: number;
14
+ };
15
+ };
4
16
  export type EventInstallationUpdated = {
5
17
  type: "installation.updated";
6
18
  properties: {
@@ -11,6 +23,7 @@ export type EventInstallationUpdateAvailable = {
11
23
  type: "installation.update-available";
12
24
  properties: {
13
25
  version: string;
26
+ command?: string;
14
27
  };
15
28
  };
16
29
  export type Project = {
@@ -28,15 +41,125 @@ export type Project = {
28
41
  initialized?: number;
29
42
  };
30
43
  sandboxes: Array<string>;
44
+ approvedExternalIncludes?: Array<string>;
31
45
  };
46
+ /**
47
+ * Deprecated: no consumer reads this event. Read project state with the `project.current` / `project.list` SDK methods instead; the fields that actually change during a session (the VCS branch) have their own event, `vcs.branch.updated`. Scheduled for removal in the next major; still emitted until then.
48
+ *
49
+ * @deprecated
50
+ */
32
51
  export type EventProjectUpdated = {
33
52
  type: "project.updated";
34
53
  properties: Project;
35
54
  };
36
- export type EventServerInstanceDisposed = {
37
- type: "server.instance.disposed";
55
+ /**
56
+ * Deprecated: no consumer reads this event. It was added for a managed-config consent dialog that was never built, so today the policy change is applied and the event is dropped. No replacement — read the managed config directly if you need to detect a policy change. Scheduled for removal in the next major; still emitted until then.
57
+ *
58
+ * @deprecated
59
+ */
60
+ export type EventConfigManagedPolicyChanged = {
61
+ type: "config.managed.policy_changed";
62
+ properties: {
63
+ url: string;
64
+ changedKeys: Array<string>;
65
+ hash: string;
66
+ };
67
+ };
68
+ export type EventFileWatcherUpdated = {
69
+ type: "file.watcher.updated";
70
+ properties: {
71
+ file: string;
72
+ event: "add" | "change" | "unlink";
73
+ };
74
+ };
75
+ export type EventConfigChanged = {
76
+ type: "config.changed";
77
+ properties: {
78
+ file: string;
79
+ source: string;
80
+ };
81
+ };
82
+ export type QuestionOption = {
83
+ /**
84
+ * Display text (1-5 words, concise)
85
+ */
86
+ label: string;
87
+ /**
88
+ * Explanation of choice
89
+ */
90
+ description: string;
91
+ };
92
+ export type QuestionInfo = {
93
+ /**
94
+ * Complete question
95
+ */
96
+ question: string;
97
+ /**
98
+ * Very short label shown as a tab/chip (about 12 chars; longer is truncated). Examples: "Auth method", "Library", "Approach".
99
+ */
100
+ header: string;
101
+ /**
102
+ * Available choices (2-4, distinct; do NOT include an 'Other' option — it is added automatically)
103
+ */
104
+ options: Array<QuestionOption>;
105
+ /**
106
+ * Allow selecting multiple choices (phrase the question accordingly)
107
+ */
108
+ multiple?: boolean;
109
+ };
110
+ export type QuestionRequest = {
111
+ id: string;
112
+ sessionID: string;
113
+ /**
114
+ * Questions to ask
115
+ */
116
+ questions: Array<QuestionInfo>;
117
+ tool?: {
118
+ messageID: string;
119
+ callID: string;
120
+ };
121
+ };
122
+ export type EventQuestionAsked = {
123
+ type: "question.asked";
124
+ properties: QuestionRequest;
125
+ };
126
+ export type QuestionAnswer = Array<string>;
127
+ export type EventQuestionReplied = {
128
+ type: "question.replied";
129
+ properties: {
130
+ sessionID: string;
131
+ requestID: string;
132
+ answers: Array<QuestionAnswer>;
133
+ };
134
+ };
135
+ export type EventQuestionRejected = {
136
+ type: "question.rejected";
137
+ properties: {
138
+ sessionID: string;
139
+ requestID: string;
140
+ };
141
+ };
142
+ export type SessionStatus = {
143
+ type: "idle";
144
+ } | {
145
+ type: "retry";
146
+ attempt: number;
147
+ message: string;
148
+ next: number;
149
+ } | {
150
+ type: "busy";
151
+ };
152
+ export type EventSessionStatus = {
153
+ type: "session.status";
38
154
  properties: {
39
- directory: string;
155
+ sessionID: string;
156
+ status: SessionStatus;
157
+ };
158
+ };
159
+ export type EventSessionIdle = {
160
+ type: "session.idle";
161
+ properties: {
162
+ sessionID: string;
40
163
  };
41
164
  };
42
165
  export type EventLspClientDiagnostics = {
@@ -77,6 +200,7 @@ export type UserMessage = {
77
200
  modelID: string;
78
201
  };
79
202
  system?: string;
203
+ systemOverride?: string;
80
204
  tools?: {
81
205
  [key: string]: boolean;
82
206
  };
@@ -98,7 +222,7 @@ export type UnknownError = {
98
222
  export type MessageOutputLengthError = {
99
223
  name: "MessageOutputLengthError";
100
224
  data: {
101
- [key: string]: unknown;
225
+ message?: string;
102
226
  };
103
227
  };
104
228
  export type MessageAbortedError = {
@@ -276,6 +400,7 @@ export type ToolStateCompleted = {
276
400
  start: number;
277
401
  end: number;
278
402
  compacted?: number;
403
+ inputCompacted?: number;
279
404
  };
280
405
  attachments?: Array<FilePart>;
281
406
  };
@@ -320,6 +445,7 @@ export type StepFinishPart = {
320
445
  type: "step-finish";
321
446
  reason: string;
322
447
  snapshot?: string;
448
+ upstream?: string;
323
449
  cost: number;
324
450
  tokens: {
325
451
  input: number;
@@ -377,6 +503,23 @@ export type CompactionPart = {
377
503
  auto: boolean;
378
504
  customInstructions?: string;
379
505
  };
506
+ export type TombstoneReason = "compacted" | "superseded" | "expired" | "budget" | "orphaned" | "reverted" | "cleared";
507
+ export type TombstonePart = {
508
+ id: string;
509
+ sessionID: string;
510
+ messageID: string;
511
+ type: "tombstone";
512
+ original: string;
513
+ kind: string;
514
+ tool?: string;
515
+ bytes: number;
516
+ reason: TombstoneReason;
517
+ retrieval?: string;
518
+ text: string;
519
+ time: {
520
+ created: number;
521
+ };
522
+ };
380
523
  export type Part = TextPart | {
381
524
  id: string;
382
525
  sessionID: string;
@@ -386,7 +529,7 @@ export type Part = TextPart | {
386
529
  description: string;
387
530
  agent: string;
388
531
  command?: string;
389
- } | ReasoningPart | FilePart | ToolPart | StepStartPart | StepFinishPart | SnapshotPart | PatchPart | AgentPart | RetryPart | CompactionPart;
532
+ } | ReasoningPart | FilePart | ToolPart | StepStartPart | StepFinishPart | SnapshotPart | PatchPart | AgentPart | RetryPart | CompactionPart | TombstonePart;
390
533
  export type EventMessagePartUpdated = {
391
534
  type: "message.part.updated";
392
535
  properties: {
@@ -402,29 +545,11 @@ export type EventMessagePartRemoved = {
402
545
  partID: string;
403
546
  };
404
547
  };
405
- export type SessionStatus = {
406
- type: "idle";
407
- } | {
408
- type: "retry";
409
- attempt: number;
410
- message: string;
411
- next: number;
412
- } | {
413
- type: "busy";
414
- };
415
- export type EventSessionStatus = {
416
- type: "session.status";
417
- properties: {
418
- sessionID: string;
419
- status: SessionStatus;
420
- };
421
- };
422
- export type EventSessionIdle = {
423
- type: "session.idle";
424
- properties: {
425
- sessionID: string;
426
- };
427
- };
548
+ /**
549
+ * Deprecated: no consumer reads this event. It is memory-v2 telemetry, not a supported integration point — counts and timings are also written to the `memory` service log. Scheduled for removal in the next major; still emitted until then.
550
+ *
551
+ * @deprecated
552
+ */
428
553
  export type EventMemoryExtractionCompleted = {
429
554
  type: "memory.extraction.completed";
430
555
  properties: {
@@ -435,6 +560,11 @@ export type EventMemoryExtractionCompleted = {
435
560
  ms: number;
436
561
  };
437
562
  };
563
+ /**
564
+ * Deprecated: no consumer reads this event. It is memory-v2 telemetry, not a supported integration point — counts and timings are also written to the `memory` service log. Scheduled for removal in the next major; still emitted until then.
565
+ *
566
+ * @deprecated
567
+ */
438
568
  export type EventMemoryConsolidationCompleted = {
439
569
  type: "memory.consolidation.completed";
440
570
  properties: {
@@ -445,6 +575,11 @@ export type EventMemoryConsolidationCompleted = {
445
575
  ms: number;
446
576
  };
447
577
  };
578
+ /**
579
+ * Deprecated: no consumer reads this event. It is memory-v2 telemetry, not a supported integration point — counts and timings are also written to the `memory` service log. Scheduled for removal in the next major; still emitted until then.
580
+ *
581
+ * @deprecated
582
+ */
448
583
  export type EventMemoryRecallCompleted = {
449
584
  type: "memory.recall.completed";
450
585
  properties: {
@@ -455,14 +590,6 @@ export type EventMemoryRecallCompleted = {
455
590
  ms: number;
456
591
  };
457
592
  };
458
- export type EventSessionToolSummary = {
459
- type: "session.tool_summary";
460
- properties: {
461
- sessionID: string;
462
- summary: string;
463
- messageID?: string;
464
- };
465
- };
466
593
  export type PermissionRequest = {
467
594
  id: string;
468
595
  sessionID: string;
@@ -489,11 +616,172 @@ export type EventPermissionReplied = {
489
616
  reply: "once" | "always" | "reject";
490
617
  };
491
618
  };
619
+ /**
620
+ * Deprecated: no consumer reads this event. It fires on an MCP `notifications/tools/list_changed` and on config reload, and only carries a server name — the cache is already invalidated by the time it is published, so re-reading the tool list is enough. Note `mcp.status.changed` is NOT a drop-in replacement: it tracks connection state, not tool-list changes. Scheduled for removal in the next major; still emitted until then.
621
+ *
622
+ * @deprecated
623
+ */
624
+ export type EventMcpToolsChanged = {
625
+ type: "mcp.tools.changed";
626
+ properties: {
627
+ server: string;
628
+ };
629
+ };
630
+ export type McpStatusConnected = {
631
+ status: "connected";
632
+ };
633
+ export type McpStatusDisabled = {
634
+ status: "disabled";
635
+ };
636
+ export type McpStatusFailed = {
637
+ status: "failed";
638
+ error: string;
639
+ };
640
+ export type McpStatusNeedsAuth = {
641
+ status: "needs_auth";
642
+ };
643
+ export type McpStatusNeedsApproval = {
644
+ status: "needs_approval";
645
+ };
646
+ export type McpStatusNeedsClientRegistration = {
647
+ status: "needs_client_registration";
648
+ error: string;
649
+ };
650
+ export type McpStatusPending = {
651
+ status: "pending";
652
+ attempt: number;
653
+ };
654
+ export type McpStatus = McpStatusConnected | McpStatusDisabled | McpStatusFailed | McpStatusNeedsAuth | McpStatusNeedsApproval | McpStatusNeedsClientRegistration | McpStatusPending;
655
+ export type EventMcpStatusChanged = {
656
+ type: "mcp.status.changed";
657
+ properties: {
658
+ status: {
659
+ [key: string]: McpStatus;
660
+ };
661
+ };
662
+ };
663
+ /**
664
+ * Deprecated: no consumer reads this event, and there is no HTTP route or SDK method behind it — schedules are managed only through the `schedule` tool. A fired schedule surfaces as an ordinary session (`session.created`, then `session.idle` when it finishes). Scheduled for removal in the next major; still emitted until then.
665
+ *
666
+ * @deprecated
667
+ */
668
+ export type EventScheduleCreated = {
669
+ type: "schedule.created";
670
+ properties: {
671
+ info: {
672
+ id: string;
673
+ title: string;
674
+ prompt: string;
675
+ /**
676
+ * project directory this task runs in
677
+ */
678
+ directory: string;
679
+ agent?: string;
680
+ spec: {
681
+ type: "once";
682
+ /**
683
+ * epoch ms to run once
684
+ */
685
+ at: number;
686
+ } | {
687
+ type: "every";
688
+ /**
689
+ * interval in ms
690
+ */
691
+ ms: number;
692
+ } | {
693
+ type: "cron";
694
+ /**
695
+ * 5-field cron expression
696
+ */
697
+ expr: string;
698
+ };
699
+ enabled: boolean;
700
+ createdAt: number;
701
+ lastRun?: number;
702
+ nextRun: number | null;
703
+ runCount: number;
704
+ lastError?: string;
705
+ };
706
+ };
707
+ };
708
+ /**
709
+ * Deprecated: no consumer reads this event, and there is no HTTP route or SDK method behind it — schedules are managed only through the `schedule` tool. A fired schedule surfaces as an ordinary session (`session.created`, then `session.idle` when it finishes). Scheduled for removal in the next major; still emitted until then.
710
+ *
711
+ * @deprecated
712
+ */
713
+ export type EventScheduleUpdated = {
714
+ type: "schedule.updated";
715
+ properties: {
716
+ info: {
717
+ id: string;
718
+ title: string;
719
+ prompt: string;
720
+ /**
721
+ * project directory this task runs in
722
+ */
723
+ directory: string;
724
+ agent?: string;
725
+ spec: {
726
+ type: "once";
727
+ /**
728
+ * epoch ms to run once
729
+ */
730
+ at: number;
731
+ } | {
732
+ type: "every";
733
+ /**
734
+ * interval in ms
735
+ */
736
+ ms: number;
737
+ } | {
738
+ type: "cron";
739
+ /**
740
+ * 5-field cron expression
741
+ */
742
+ expr: string;
743
+ };
744
+ enabled: boolean;
745
+ createdAt: number;
746
+ lastRun?: number;
747
+ nextRun: number | null;
748
+ runCount: number;
749
+ lastError?: string;
750
+ };
751
+ };
752
+ };
753
+ /**
754
+ * Deprecated: no consumer reads this event, and there is no HTTP route or SDK method behind it — schedules are managed only through the `schedule` tool. A fired schedule surfaces as an ordinary session (`session.created`, then `session.idle` when it finishes). Scheduled for removal in the next major; still emitted until then.
755
+ *
756
+ * @deprecated
757
+ */
758
+ export type EventScheduleRemoved = {
759
+ type: "schedule.removed";
760
+ properties: {
761
+ id: string;
762
+ };
763
+ };
764
+ /**
765
+ * Deprecated: no consumer reads this event, and there is no HTTP route or SDK method behind it — schedules are managed only through the `schedule` tool. A fired schedule surfaces as an ordinary session (`session.created`, then `session.idle` when it finishes). Scheduled for removal in the next major; still emitted until then.
766
+ *
767
+ * @deprecated
768
+ */
769
+ export type EventScheduleFired = {
770
+ type: "schedule.fired";
771
+ properties: {
772
+ id: string;
773
+ sessionID: string;
774
+ };
775
+ };
492
776
  export type Todo = {
493
777
  /**
494
778
  * Brief description of the task
495
779
  */
496
780
  content: string;
781
+ /**
782
+ * Present-continuous form of the task for display while in_progress (e.g. 'Running tests' for 'Run tests'). Optional — only needed when a natural present-continuous phrasing differs meaningfully from content.
783
+ */
784
+ activeForm?: string;
497
785
  /**
498
786
  * Current status of the task: pending, in_progress, completed, cancelled
499
787
  */
@@ -506,6 +794,14 @@ export type Todo = {
506
794
  * Unique identifier for the todo item
507
795
  */
508
796
  id: string;
797
+ /**
798
+ * ids of tasks this task blocks (they wait on this one)
799
+ */
800
+ blocks?: Array<string>;
801
+ /**
802
+ * ids of tasks that must complete before this one can start
803
+ */
804
+ blocked_by?: Array<string>;
509
805
  };
510
806
  export type EventTodoUpdated = {
511
807
  type: "todo.updated";
@@ -518,7 +814,7 @@ export type EventSessionCompacted = {
518
814
  type: "session.compacted";
519
815
  properties: {
520
816
  sessionID: string;
521
- layer?: string;
817
+ layer: string;
522
818
  tokensBefore?: number;
523
819
  tokensAfter?: number;
524
820
  tokensFreed?: number;
@@ -528,118 +824,357 @@ export type EventSessionCompacted = {
528
824
  summarizerCost?: number;
529
825
  };
530
826
  };
531
- export type QuestionOption = {
532
- /**
533
- * Display text (1-5 words, concise)
534
- */
535
- label: string;
536
- /**
537
- * Explanation of choice
538
- */
539
- description: string;
540
- };
541
- export type QuestionInfo = {
542
- /**
543
- * Complete question
544
- */
545
- question: string;
546
- /**
547
- * Very short label (max 12 chars)
548
- */
549
- header: string;
550
- /**
551
- * Available choices
552
- */
553
- options: Array<QuestionOption>;
554
- /**
555
- * Allow selecting multiple choices
556
- */
557
- multiple?: boolean;
827
+ export type EventSessionCompactionFailed = {
828
+ type: "session.compaction.failed";
829
+ properties: {
830
+ sessionID: string;
831
+ layer: string;
832
+ error: string;
833
+ consecutiveFailures: number;
834
+ };
558
835
  };
559
- export type QuestionRequest = {
836
+ export type EventCommandExecuted = {
837
+ type: "command.executed";
838
+ properties: {
839
+ name: string;
840
+ sessionID: string;
841
+ arguments: string;
842
+ messageID: string;
843
+ };
844
+ };
845
+ /**
846
+ * Deprecated: no consumer reads this event. A created thread is observable through the child session it drives (`session.created`) and through `agent.thread.completed` / `agent.thread.error` when it finishes. Scheduled for removal in the next major; still emitted until then.
847
+ *
848
+ * @deprecated
849
+ */
850
+ export type EventAgentThreadCreated = {
851
+ type: "agent.thread.created";
852
+ properties: {
853
+ id: string;
854
+ parentID?: string;
855
+ nickname: string;
856
+ role?: string;
857
+ status: "pending" | "running" | "completed" | "error" | "interrupted" | "shutdown";
858
+ depth: number;
859
+ created: number;
860
+ completed?: number;
861
+ error?: string;
862
+ };
863
+ };
864
+ export type EventAgentThreadCompleted = {
865
+ type: "agent.thread.completed";
866
+ properties: {
867
+ id: string;
868
+ parentID?: string;
869
+ nickname: string;
870
+ role?: string;
871
+ status: "pending" | "running" | "completed" | "error" | "interrupted" | "shutdown";
872
+ depth: number;
873
+ created: number;
874
+ completed?: number;
875
+ error?: string;
876
+ };
877
+ };
878
+ /**
879
+ * Deprecated: no consumer reads this event. Interruption is already reported by `session.status` on the interrupted session. Scheduled for removal in the next major; still emitted until then.
880
+ *
881
+ * @deprecated
882
+ */
883
+ export type EventAgentThreadInterrupted = {
884
+ type: "agent.thread.interrupted";
885
+ properties: {
886
+ id: string;
887
+ parentID?: string;
888
+ nickname: string;
889
+ role?: string;
890
+ status: "pending" | "running" | "completed" | "error" | "interrupted" | "shutdown";
891
+ depth: number;
892
+ created: number;
893
+ completed?: number;
894
+ error?: string;
895
+ };
896
+ };
897
+ export type EventAgentThreadError = {
898
+ type: "agent.thread.error";
899
+ properties: {
900
+ id: string;
901
+ parentID?: string;
902
+ nickname: string;
903
+ role?: string;
904
+ status: "pending" | "running" | "completed" | "error" | "interrupted" | "shutdown";
905
+ depth: number;
906
+ created: number;
907
+ completed?: number;
908
+ error?: string;
909
+ };
910
+ };
911
+ /**
912
+ * Deprecated: no consumer reads this event. The spawn that hit the limit fails with an error the caller already sees. Scheduled for removal in the next major; still emitted until then.
913
+ *
914
+ * @deprecated
915
+ */
916
+ export type EventAgentLimitReached = {
917
+ type: "agent.limit.reached";
918
+ properties: {
919
+ maxThreads: number;
920
+ activeThreads: number;
921
+ };
922
+ };
923
+ export type EventTaskCreated = {
924
+ type: "task.created";
925
+ properties: {
926
+ id: string;
927
+ sessionID: string;
928
+ messageID: string;
929
+ partID: string;
930
+ command: string;
931
+ status: "running" | "completed" | "failed" | "aborted";
932
+ pid?: number;
933
+ exitCode?: number;
934
+ outputFilePath?: string;
935
+ startTime: number;
936
+ endTime?: number;
937
+ isBackground?: boolean;
938
+ error?: string;
939
+ };
940
+ };
941
+ export type EventTaskUpdated = {
942
+ type: "task.updated";
943
+ properties: {
944
+ id: string;
945
+ sessionID: string;
946
+ messageID: string;
947
+ partID: string;
948
+ command: string;
949
+ status: "running" | "completed" | "failed" | "aborted";
950
+ pid?: number;
951
+ exitCode?: number;
952
+ outputFilePath?: string;
953
+ startTime: number;
954
+ endTime?: number;
955
+ isBackground?: boolean;
956
+ error?: string;
957
+ };
958
+ };
959
+ export type EventTaskRemoved = {
960
+ type: "task.removed";
961
+ properties: {
962
+ id: string;
963
+ };
964
+ };
965
+ /**
966
+ * Deprecated: no consumer reads this event. It only signals which running task the tool call is currently attached to, carries nothing but an id, and is not published alongside a `task.updated`, so it cannot be reconstructed from the task list. No replacement — it is going away. Scheduled for removal in the next major; still emitted until then.
967
+ *
968
+ * @deprecated
969
+ */
970
+ export type EventTaskActivated = {
971
+ type: "task.activated";
972
+ properties: {
973
+ id: string;
974
+ };
975
+ };
976
+ /**
977
+ * Deprecated: no consumer reads this event. `sendToBackground` writes the task first, so the same transition already arrives as a `task.updated` with `isBackground: true` — watch that instead. Scheduled for removal in the next major; still emitted until then.
978
+ *
979
+ * @deprecated
980
+ */
981
+ export type EventTaskBackgrounded = {
982
+ type: "task.backgrounded";
983
+ properties: {
984
+ id: string;
985
+ };
986
+ };
987
+ /**
988
+ * Deprecated: no consumer reads this event. It only signals which running task the tool call is currently attached to, carries nothing but an id, and is not published alongside a `task.updated`, so it cannot be reconstructed from the task list. No replacement — it is going away. Scheduled for removal in the next major; still emitted until then.
989
+ *
990
+ * @deprecated
991
+ */
992
+ export type EventTaskDeactivated = {
993
+ type: "task.deactivated";
994
+ properties: {
995
+ id: string;
996
+ };
997
+ };
998
+ export type Workitem = {
999
+ /**
1000
+ * Unique work-item id (tsk_…)
1001
+ */
560
1002
  id: string;
561
- sessionID: string;
562
1003
  /**
563
- * Questions to ask
1004
+ * A brief title for the work item
564
1005
  */
565
- questions: Array<QuestionInfo>;
566
- tool?: {
567
- messageID: string;
568
- callID: string;
1006
+ subject: string;
1007
+ /**
1008
+ * What needs to be done
1009
+ */
1010
+ description: string;
1011
+ /**
1012
+ * Present-continuous form shown while in_progress (e.g. 'Running tests')
1013
+ */
1014
+ activeForm?: string;
1015
+ status: "pending" | "in_progress" | "completed" | "cancelled";
1016
+ /**
1017
+ * Session id of the agent that claimed this item
1018
+ */
1019
+ owner?: string;
1020
+ /**
1021
+ * ids of items this item blocks (they wait on this one)
1022
+ */
1023
+ blocks: Array<string>;
1024
+ /**
1025
+ * ids of items that must complete before this one can start
1026
+ */
1027
+ blocked_by: Array<string>;
1028
+ /**
1029
+ * Arbitrary metadata attached to the item
1030
+ */
1031
+ metadata?: {
1032
+ [key: string]: unknown;
569
1033
  };
1034
+ created: number;
1035
+ updated: number;
570
1036
  };
571
- export type EventQuestionAsked = {
572
- type: "question.asked";
573
- properties: QuestionRequest;
1037
+ export type EventAgentWorkitemUpdated = {
1038
+ type: "agent.workitem.updated";
1039
+ properties: {
1040
+ items: Array<Workitem>;
1041
+ };
574
1042
  };
575
- export type QuestionAnswer = Array<string>;
576
- export type EventQuestionReplied = {
577
- type: "question.replied";
1043
+ /**
1044
+ * Deprecated: coordinator-internal telemetry with no consumer. Track dispatched work through the child sessions themselves (`session.created`, `session.status`, `session.idle`) or the `task.*` events. Scheduled for removal in the next major; still emitted until then.
1045
+ *
1046
+ * @deprecated
1047
+ */
1048
+ export type EventAgentCoordinatorEnabled = {
1049
+ type: "agent.coordinator.enabled";
578
1050
  properties: {
579
1051
  sessionID: string;
580
- requestID: string;
581
- answers: Array<QuestionAnswer>;
582
1052
  };
583
1053
  };
584
- export type EventQuestionRejected = {
585
- type: "question.rejected";
1054
+ /**
1055
+ * Deprecated: coordinator-internal telemetry with no consumer. Track dispatched work through the child sessions themselves (`session.created`, `session.status`, `session.idle`) or the `task.*` events. Scheduled for removal in the next major; still emitted until then.
1056
+ *
1057
+ * @deprecated
1058
+ */
1059
+ export type EventAgentCoordinatorDisabled = {
1060
+ type: "agent.coordinator.disabled";
586
1061
  properties: {
587
1062
  sessionID: string;
588
- requestID: string;
589
1063
  };
590
1064
  };
591
- export type EventFileEdited = {
592
- type: "file.edited";
1065
+ /**
1066
+ * Deprecated: coordinator-internal telemetry with no consumer. Track dispatched work through the child sessions themselves (`session.created`, `session.status`, `session.idle`) or the `task.*` events. Scheduled for removal in the next major; still emitted until then.
1067
+ *
1068
+ * @deprecated
1069
+ */
1070
+ export type EventAgentCoordinatorDispatched = {
1071
+ type: "agent.coordinator.dispatched";
593
1072
  properties: {
594
- file: string;
1073
+ sessionID: string;
1074
+ taskID: string;
1075
+ workerSessionID?: string;
1076
+ agent?: string;
1077
+ description: string;
595
1078
  };
596
1079
  };
597
- export type EventTuiPromptAppend = {
598
- type: "tui.prompt.append";
1080
+ /**
1081
+ * Deprecated: coordinator-internal telemetry with no consumer. Track dispatched work through the child sessions themselves (`session.created`, `session.status`, `session.idle`) or the `task.*` events. Scheduled for removal in the next major; still emitted until then.
1082
+ *
1083
+ * @deprecated
1084
+ */
1085
+ export type EventAgentCoordinatorDispatchUpdated = {
1086
+ type: "agent.coordinator.dispatch_updated";
599
1087
  properties: {
600
- text: string;
1088
+ sessionID: string;
1089
+ taskID: string;
1090
+ status: "running" | "completed" | "failed" | "stopped";
601
1091
  };
602
1092
  };
603
- export type EventTuiCommandExecute = {
604
- type: "tui.command.execute";
1093
+ /**
1094
+ * Deprecated: no consumer reads this event. The notification queue is an internal hand-off — a queued notification reaches the user as part of the next assistant turn, observable through `message.part.updated`. No direct replacement. Scheduled for removal in the next major; still emitted until then.
1095
+ *
1096
+ * @deprecated
1097
+ */
1098
+ export type EventSessionNotificationQueued = {
1099
+ type: "session.notification.queued";
605
1100
  properties: {
606
- command: "session.list" | "session.new" | "session.share" | "session.interrupt" | "session.compact" | "session.page.up" | "session.page.down" | "session.half.page.up" | "session.half.page.down" | "session.first" | "session.last" | "prompt.clear" | "prompt.submit" | "agent.cycle" | string;
1101
+ sessionID: string;
1102
+ taskID: string;
1103
+ priority: "now" | "next" | "later";
607
1104
  };
608
1105
  };
609
- export type EventTuiToastShow = {
610
- type: "tui.toast.show";
1106
+ /**
1107
+ * Deprecated: no consumer reads this event. The notification queue is an internal hand-off — a queued notification reaches the user as part of the next assistant turn, observable through `message.part.updated`. No direct replacement. Scheduled for removal in the next major; still emitted until then.
1108
+ *
1109
+ * @deprecated
1110
+ */
1111
+ export type EventSessionNotificationDrained = {
1112
+ type: "session.notification.drained";
611
1113
  properties: {
612
- title?: string;
613
- message: string;
614
- variant: "info" | "success" | "warning" | "error";
615
- /**
616
- * Duration in milliseconds
617
- */
618
- duration?: number;
1114
+ sessionID: string;
1115
+ count: number;
619
1116
  };
620
1117
  };
621
- export type EventTuiSessionSelect = {
622
- type: "tui.session.select";
1118
+ /**
1119
+ * Deprecated: no consumer reads this event. It carries a short progress label for a batch of tool calls, and it was always intended for clients rather than the TUI — but nothing has ever consumed it. The same information is derivable from the `message.part.updated` tool parts. Scheduled for removal in the next major unless a consumer is written first; still emitted until then.
1120
+ *
1121
+ * @deprecated
1122
+ */
1123
+ export type EventSessionToolSummary = {
1124
+ type: "session.tool_summary";
623
1125
  properties: {
624
- /**
625
- * Session ID to navigate to
626
- */
627
1126
  sessionID: string;
1127
+ summary: string;
1128
+ messageID?: string;
628
1129
  };
629
1130
  };
630
- export type EventMcpToolsChanged = {
631
- type: "mcp.tools.changed";
1131
+ export type EventSessionBudgetCompleted = {
1132
+ type: "session.budget.completed";
632
1133
  properties: {
633
- server: string;
1134
+ sessionID: string;
1135
+ continuationCount: number;
1136
+ pct: number;
1137
+ turnTokens: number;
1138
+ budget: number;
1139
+ diminishingReturns: boolean;
1140
+ durationMs: number;
634
1141
  };
635
1142
  };
636
- export type EventCommandExecuted = {
637
- type: "command.executed";
1143
+ export type EventSessionPromptSuggestion = {
1144
+ type: "session.prompt_suggestion";
638
1145
  properties: {
639
- name: string;
640
1146
  sessionID: string;
641
- arguments: string;
642
- messageID: string;
1147
+ suggestion: string;
1148
+ variant: "user_intent" | "stated_intent";
1149
+ };
1150
+ };
1151
+ export type EventFileEdited = {
1152
+ type: "file.edited";
1153
+ properties: {
1154
+ file: string;
1155
+ };
1156
+ };
1157
+ /**
1158
+ * Deprecated: no consumer reads this event. Team membership is state, not a stream — read it back through the `team` tool. Scheduled for removal in the next major; still emitted until then.
1159
+ *
1160
+ * @deprecated
1161
+ */
1162
+ export type EventAgentTeamCreated = {
1163
+ type: "agent.team.created";
1164
+ properties: {
1165
+ name: string;
1166
+ members: Array<string>;
1167
+ };
1168
+ };
1169
+ /**
1170
+ * Deprecated: no consumer reads this event. Team membership is state, not a stream — read it back through the `team` tool. Scheduled for removal in the next major; still emitted until then.
1171
+ *
1172
+ * @deprecated
1173
+ */
1174
+ export type EventAgentTeamDeleted = {
1175
+ type: "agent.team.deleted";
1176
+ properties: {
1177
+ name: string;
643
1178
  };
644
1179
  };
645
1180
  export type PermissionAction = "allow" | "deny" | "ask";
@@ -672,8 +1207,14 @@ export type Session = {
672
1207
  compacting?: number;
673
1208
  archived?: number;
674
1209
  };
1210
+ cost?: number;
675
1211
  permission?: PermissionRuleset;
676
1212
  permissionMode?: PermissionMode;
1213
+ contentReplacements?: Array<{
1214
+ kind: "tool-result" | "tool-input";
1215
+ toolUseId: string;
1216
+ replacement: string;
1217
+ }>;
677
1218
  revert?: {
678
1219
  messageID: string;
679
1220
  partID?: string;
@@ -713,11 +1254,12 @@ export type EventSessionError = {
713
1254
  error?: ProviderAuthError | UnknownError | MessageOutputLengthError | MessageAbortedError | ApiError;
714
1255
  };
715
1256
  };
716
- export type EventFileWatcherUpdated = {
717
- type: "file.watcher.updated";
1257
+ export type EventSessionVerificationVerdict = {
1258
+ type: "session.verification_verdict";
718
1259
  properties: {
719
- file: string;
720
- event: "add" | "change" | "unlink";
1260
+ sessionID: string;
1261
+ verdict: "pass" | "fail";
1262
+ source?: string;
721
1263
  };
722
1264
  };
723
1265
  export type EventVcsBranchUpdated = {
@@ -726,6 +1268,39 @@ export type EventVcsBranchUpdated = {
726
1268
  branch?: string;
727
1269
  };
728
1270
  };
1271
+ export type EventTuiPromptAppend = {
1272
+ type: "tui.prompt.append";
1273
+ properties: {
1274
+ text: string;
1275
+ };
1276
+ };
1277
+ export type EventTuiCommandExecute = {
1278
+ type: "tui.command.execute";
1279
+ properties: {
1280
+ command: "session.list" | "session.new" | "session.share" | "session.interrupt" | "session.compact" | "session.page.up" | "session.page.down" | "session.half.page.up" | "session.half.page.down" | "session.first" | "session.last" | "prompt.clear" | "prompt.submit" | "agent.cycle" | string;
1281
+ };
1282
+ };
1283
+ export type EventTuiToastShow = {
1284
+ type: "tui.toast.show";
1285
+ properties: {
1286
+ title?: string;
1287
+ message: string;
1288
+ variant: "info" | "success" | "warning" | "error";
1289
+ /**
1290
+ * Duration in milliseconds
1291
+ */
1292
+ duration?: number;
1293
+ };
1294
+ };
1295
+ export type EventTuiSessionSelect = {
1296
+ type: "tui.session.select";
1297
+ properties: {
1298
+ /**
1299
+ * Session ID to navigate to
1300
+ */
1301
+ sessionID: string;
1302
+ };
1303
+ };
729
1304
  export type Pty = {
730
1305
  id: string;
731
1306
  title: string;
@@ -735,18 +1310,33 @@ export type Pty = {
735
1310
  status: "running" | "exited";
736
1311
  pid: number;
737
1312
  };
1313
+ /**
1314
+ * Deprecated: no consumer reads this event — the PTY WebSocket at `GET /pty/{ptyID}/connect` reports session lifecycle to the only client that has ever used it. Poll `GET /pty` for the session list. Scheduled for removal in the next major; still emitted until then.
1315
+ *
1316
+ * @deprecated
1317
+ */
738
1318
  export type EventPtyCreated = {
739
1319
  type: "pty.created";
740
1320
  properties: {
741
1321
  info: Pty;
742
1322
  };
743
1323
  };
1324
+ /**
1325
+ * Deprecated: no consumer reads this event — the PTY WebSocket at `GET /pty/{ptyID}/connect` reports session lifecycle to the only client that has ever used it. Poll `GET /pty` for the session list. Scheduled for removal in the next major; still emitted until then.
1326
+ *
1327
+ * @deprecated
1328
+ */
744
1329
  export type EventPtyUpdated = {
745
1330
  type: "pty.updated";
746
1331
  properties: {
747
1332
  info: Pty;
748
1333
  };
749
1334
  };
1335
+ /**
1336
+ * Deprecated: no consumer reads this event — the PTY WebSocket at `GET /pty/{ptyID}/connect` reports session lifecycle to the only client that has ever used it. Poll `GET /pty` for the session list. Scheduled for removal in the next major; still emitted until then.
1337
+ *
1338
+ * @deprecated
1339
+ */
750
1340
  export type EventPtyExited = {
751
1341
  type: "pty.exited";
752
1342
  properties: {
@@ -754,6 +1344,11 @@ export type EventPtyExited = {
754
1344
  exitCode: number;
755
1345
  };
756
1346
  };
1347
+ /**
1348
+ * Deprecated: no consumer reads this event — the PTY WebSocket at `GET /pty/{ptyID}/connect` reports session lifecycle to the only client that has ever used it. Poll `GET /pty` for the session list. Scheduled for removal in the next major; still emitted until then.
1349
+ *
1350
+ * @deprecated
1351
+ */
757
1352
  export type EventPtyDeleted = {
758
1353
  type: "pty.deleted";
759
1354
  properties: {
@@ -766,13 +1361,46 @@ export type EventServerConnected = {
766
1361
  [key: string]: unknown;
767
1362
  };
768
1363
  };
1364
+ export type EventServerInstanceDisposed = {
1365
+ type: "server.instance.disposed";
1366
+ properties: {
1367
+ [key: string]: unknown;
1368
+ };
1369
+ };
1370
+ /**
1371
+ * Deprecated: no consumer reads this event. It is emitted once on `POST /global/dispose`, which itself has no caller in this repo, and it carries no payload. Per-instance disposal is reported by `server.instance.disposed`, which is consumed and is not going away. Scheduled for removal in the next major; still emitted until then.
1372
+ *
1373
+ * @deprecated
1374
+ */
769
1375
  export type EventGlobalDisposed = {
770
1376
  type: "global.disposed";
771
1377
  properties: {
772
1378
  [key: string]: unknown;
773
1379
  };
774
1380
  };
775
- export type Event = EventInstallationUpdated | EventInstallationUpdateAvailable | EventProjectUpdated | EventServerInstanceDisposed | EventLspClientDiagnostics | EventLspUpdated | EventMessageUpdated | EventMessageRemoved | EventMessagePartUpdated | EventMessagePartRemoved | EventSessionStatus | EventSessionIdle | EventMemoryExtractionCompleted | EventMemoryConsolidationCompleted | EventMemoryRecallCompleted | EventSessionToolSummary | EventPermissionAsked | EventPermissionReplied | EventTodoUpdated | EventSessionCompacted | EventQuestionAsked | EventQuestionReplied | EventQuestionRejected | EventFileEdited | EventTuiPromptAppend | EventTuiCommandExecute | EventTuiToastShow | EventTuiSessionSelect | EventMcpToolsChanged | EventCommandExecuted | EventSessionCreated | EventSessionUpdated | EventSessionDeleted | EventSessionDiff | EventSessionError | EventFileWatcherUpdated | EventVcsBranchUpdated | EventPtyCreated | EventPtyUpdated | EventPtyExited | EventPtyDeleted | EventServerConnected | EventGlobalDisposed;
1381
+ export type EventSwarmMessageReceived = {
1382
+ type: "swarm.message.received";
1383
+ properties: {
1384
+ id: string;
1385
+ from: string;
1386
+ to: string;
1387
+ type: string;
1388
+ payload?: unknown;
1389
+ time: number;
1390
+ };
1391
+ };
1392
+ export type EventSwarmMailboxMessage = {
1393
+ type: "swarm.mailbox.message";
1394
+ properties: {
1395
+ id: string;
1396
+ from: string;
1397
+ to: string;
1398
+ type: string;
1399
+ payload?: unknown;
1400
+ time: number;
1401
+ };
1402
+ };
1403
+ export type Event = EventFlagRefreshed | EventInstallationUpdated | EventInstallationUpdateAvailable | EventProjectUpdated | EventConfigManagedPolicyChanged | EventFileWatcherUpdated | EventConfigChanged | EventQuestionAsked | EventQuestionReplied | EventQuestionRejected | EventSessionStatus | EventSessionIdle | EventLspClientDiagnostics | EventLspUpdated | EventMessageUpdated | EventMessageRemoved | EventMessagePartUpdated | EventMessagePartRemoved | EventMemoryExtractionCompleted | EventMemoryConsolidationCompleted | EventMemoryRecallCompleted | EventPermissionAsked | EventPermissionReplied | EventMcpToolsChanged | EventMcpStatusChanged | EventScheduleCreated | EventScheduleUpdated | EventScheduleRemoved | EventScheduleFired | EventTodoUpdated | EventSessionCompacted | EventSessionCompactionFailed | EventCommandExecuted | EventAgentThreadCreated | EventAgentThreadCompleted | EventAgentThreadInterrupted | EventAgentThreadError | EventAgentLimitReached | EventTaskCreated | EventTaskUpdated | EventTaskRemoved | EventTaskActivated | EventTaskBackgrounded | EventTaskDeactivated | EventAgentWorkitemUpdated | EventAgentCoordinatorEnabled | EventAgentCoordinatorDisabled | EventAgentCoordinatorDispatched | EventAgentCoordinatorDispatchUpdated | EventSessionNotificationQueued | EventSessionNotificationDrained | EventSessionToolSummary | EventSessionBudgetCompleted | EventSessionPromptSuggestion | EventFileEdited | EventAgentTeamCreated | EventAgentTeamDeleted | EventSessionCreated | EventSessionUpdated | EventSessionDeleted | EventSessionDiff | EventSessionError | EventSessionVerificationVerdict | EventVcsBranchUpdated | EventTuiPromptAppend | EventTuiCommandExecute | EventTuiToastShow | EventTuiSessionSelect | EventPtyCreated | EventPtyUpdated | EventPtyExited | EventPtyDeleted | EventServerConnected | EventServerInstanceDisposed | EventGlobalDisposed | EventSwarmMessageReceived | EventSwarmMailboxMessage;
776
1404
  export type GlobalEvent = {
777
1405
  directory: string;
778
1406
  payload: Event;
@@ -790,389 +1418,481 @@ export type NotFoundError = {
790
1418
  message: string;
791
1419
  };
792
1420
  };
1421
+ export type InstalledPlugin = {
1422
+ name: string;
1423
+ version?: string;
1424
+ description?: string;
1425
+ author?: string;
1426
+ root: string;
1427
+ enabled: boolean;
1428
+ source?: string;
1429
+ components: {
1430
+ [key: string]: number;
1431
+ };
1432
+ };
1433
+ export type DiscoverPlugin = {
1434
+ name: string;
1435
+ source: string;
1436
+ description?: string;
1437
+ version?: string;
1438
+ author?: string;
1439
+ installs?: number;
1440
+ marketplace: string;
1441
+ marketplaceSpec: string;
1442
+ };
1443
+ export type PluginError = {
1444
+ dir: string;
1445
+ reason: string;
1446
+ };
1447
+ export type PluginReloadResult = {
1448
+ plugins: number;
1449
+ commands: number;
1450
+ agents: number;
1451
+ skills: number;
1452
+ hooks: number;
1453
+ mcp: number;
1454
+ lsp: number;
1455
+ };
1456
+ export type PluginInstallResult = {
1457
+ name: string;
1458
+ version?: string;
1459
+ };
1460
+ export type TrustStatus = {
1461
+ trusted: boolean;
1462
+ directory: string;
1463
+ home: boolean;
1464
+ hasMcpJson: boolean;
1465
+ hasProjectConfig: boolean;
1466
+ };
1467
+ export type RemoteBridgeEnrollment = {
1468
+ token: string;
1469
+ deviceID: string;
1470
+ protocol: number;
1471
+ path: string;
1472
+ expiresAt: number;
1473
+ };
1474
+ export type RemoteBridgeDevice = {
1475
+ id: string;
1476
+ name?: string;
1477
+ createdAt: number;
1478
+ lastSeenAt?: number;
1479
+ revokedAt?: number;
1480
+ };
793
1481
  /**
794
- * Custom keybind configurations
1482
+ * Remap keyboard shortcuts. Every action listed here has a default; only the ones you set are overridden. Use <leader> to build on the leader key, separate alternatives with commas to bind several chords to one action, and set "none" to leave an action unbound.
795
1483
  */
796
1484
  export type KeybindsConfig = {
797
1485
  /**
798
- * Leader key for keybind combinations
1486
+ * Prefix key that opens a two-key chord. Press it, then the second key within 2 seconds; every `<leader>…` binding below is built on it.
799
1487
  */
800
1488
  leader?: string;
801
1489
  /**
802
- * Exit the application
1490
+ * Quit 100xprompt. Press it twice: the first press on an empty prompt shows "press again to exit", and a second press within 1.5 seconds quits. While a turn is running, ctrl+c interrupts it instead. With text typed, ctrl+c hits `input_clear` first and just clears it. A leader chord (`<leader>q`) quits at once. Inside a dialog or a permission prompt this key cancels instead of quitting.
803
1491
  */
804
1492
  app_exit?: string;
805
1493
  /**
806
- * Open external editor
1494
+ * Redraw the whole screen, for when the display has been garbled by something else writing to the terminal.
1495
+ */
1496
+ app_redraw?: string;
1497
+ /**
1498
+ * Open the current prompt in $EDITOR. Whatever you save comes back into the prompt, and @file/@agent mentions are re-anchored to wherever their text ended up.
807
1499
  */
808
1500
  editor_open?: string;
809
1501
  /**
810
- * List available themes
1502
+ * Open the theme picker.
811
1503
  */
812
1504
  theme_list?: string;
813
1505
  /**
814
- * Toggle sidebar
1506
+ * Show or hide the scrollbar alongside the session transcript.
815
1507
  */
816
- sidebar_toggle?: string;
1508
+ scrollbar_toggle?: string;
817
1509
  /**
818
- * Toggle session scrollbar
1510
+ * Accepted for compatibility but currently inert — nothing in the TUI reads this binding. Background tasks are reached from the command palette ("Background tasks").
819
1511
  */
820
- scrollbar_toggle?: string;
1512
+ task_background?: string;
821
1513
  /**
822
- * Toggle username visibility
1514
+ * Accepted for compatibility but currently inert — this build has no username display to toggle and nothing reads this binding.
823
1515
  */
824
1516
  username_toggle?: string;
825
1517
  /**
826
- * View status
1518
+ * Open the status panel: version, providers, connected MCP servers and the active directories.
827
1519
  */
828
1520
  status_view?: string;
829
1521
  /**
830
- * Export session to editor
1522
+ * Export the transcript as Markdown. Asks what to include, writes the file into the current directory and opens it in $EDITOR; edits you make there are saved back to the file.
831
1523
  */
832
1524
  session_export?: string;
833
1525
  /**
834
- * Create a new session
1526
+ * Start a new session, carrying anything already typed in the prompt across to it.
835
1527
  */
836
1528
  session_new?: string;
837
1529
  /**
838
- * List all sessions
1530
+ * Open the session switcher.
839
1531
  */
840
1532
  session_list?: string;
841
1533
  /**
842
- * Show session timeline
1534
+ * Open the message timeline and jump to any earlier point in the session.
843
1535
  */
844
1536
  session_timeline?: string;
845
1537
  /**
846
- * Fork session from message
1538
+ * Pick an earlier message and branch a new session from it, leaving this one intact.
847
1539
  */
848
1540
  session_fork?: string;
849
1541
  /**
850
- * Rename session
1542
+ * Rename the current session.
851
1543
  */
852
1544
  session_rename?: string;
853
1545
  /**
854
- * Share current session
1546
+ * Publish a share link for this session and copy it to the clipboard. Hidden when `share` is set to "disabled".
855
1547
  */
856
1548
  session_share?: string;
857
1549
  /**
858
- * Unshare current session
1550
+ * Revoke this session's share link.
859
1551
  */
860
1552
  session_unshare?: string;
861
1553
  /**
862
- * Interrupt current session
1554
+ * Abort the turn in flight. Only active while the session is busy; in shell (!) mode it leaves shell mode instead.
863
1555
  */
864
1556
  session_interrupt?: string;
865
1557
  /**
866
- * Compact the session
1558
+ * Summarize the session so far and carry on from the summary, reclaiming context. Needs a provider connected.
867
1559
  */
868
1560
  session_compact?: string;
869
1561
  /**
870
- * Scroll messages up by one page
1562
+ * Scroll the transcript up by half a viewport. (The name is inherited; the step really is half a screen, and `messages_half_page_up` is a quarter.)
871
1563
  */
872
1564
  messages_page_up?: string;
873
1565
  /**
874
- * Scroll messages down by one page
1566
+ * Scroll the transcript down by half a viewport. (The name is inherited; the step really is half a screen, and `messages_half_page_down` is a quarter.)
875
1567
  */
876
1568
  messages_page_down?: string;
877
1569
  /**
878
- * Scroll messages up by half page
1570
+ * Scroll the transcript up by a quarter of a viewport — half the step `messages_page_up` takes.
879
1571
  */
880
1572
  messages_half_page_up?: string;
881
1573
  /**
882
- * Scroll messages down by half page
1574
+ * Scroll the transcript down by a quarter of a viewport — half the step `messages_page_down` takes.
883
1575
  */
884
1576
  messages_half_page_down?: string;
885
1577
  /**
886
- * Navigate to first message
1578
+ * Jump to the top of the transcript.
887
1579
  */
888
1580
  messages_first?: string;
889
1581
  /**
890
- * Navigate to last message
1582
+ * Jump to the bottom of the transcript.
891
1583
  */
892
1584
  messages_last?: string;
893
1585
  /**
894
- * Navigate to next message
1586
+ * Scroll to the next message boundary.
895
1587
  */
896
1588
  messages_next?: string;
897
1589
  /**
898
- * Navigate to previous message
1590
+ * Scroll to the previous message boundary.
899
1591
  */
900
1592
  messages_previous?: string;
901
1593
  /**
902
- * Navigate to last user message
1594
+ * Jump to the most recent message you actually typed, skipping synthetic and hidden text.
903
1595
  */
904
1596
  messages_last_user?: string;
905
1597
  /**
906
- * Copy message
1598
+ * Copy the last assistant message to the clipboard, also emitting OSC 52 so it works over SSH and inside tmux.
907
1599
  */
908
1600
  messages_copy?: string;
909
1601
  /**
910
- * Undo message
1602
+ * Roll the session back to before your previous message and restore that message's text and attachments into the prompt. Aborts the turn in flight first.
911
1603
  */
912
1604
  messages_undo?: string;
913
1605
  /**
914
- * Redo message
1606
+ * Step forward again after an undo, restoring the next message. Only available while a message is reverted.
915
1607
  */
916
1608
  messages_redo?: string;
917
1609
  /**
918
- * Toggle code block concealment in messages
1610
+ * Collapse or expand fenced code blocks in the transcript. Shares its default with `tips_toggle`, which is only live on the home screen, so the two never collide.
919
1611
  */
920
1612
  messages_toggle_conceal?: string;
921
1613
  /**
922
- * Toggle tool details visibility
1614
+ * Rate the last Auto-routed response as good (👍). Does nothing if the last response was not Auto-routed.
1615
+ */
1616
+ feedback_up?: string;
1617
+ /**
1618
+ * Rate the last Auto-routed response as bad (👎). Does nothing if the last response was not Auto-routed.
1619
+ */
1620
+ feedback_down?: string;
1621
+ /**
1622
+ * Show or hide the expanded output underneath each tool call.
923
1623
  */
924
1624
  tool_details?: string;
925
1625
  /**
926
- * List available models
1626
+ * Open the model picker.
927
1627
  */
928
1628
  model_list?: string;
929
1629
  /**
930
- * Next recently used model
1630
+ * Switch to the next model in your recently-used list without opening the picker.
931
1631
  */
932
1632
  model_cycle_recent?: string;
933
1633
  /**
934
- * Previous recently used model
1634
+ * Switch to the previous model in your recently-used list without opening the picker.
935
1635
  */
936
1636
  model_cycle_recent_reverse?: string;
937
1637
  /**
938
- * Next favorite model
1638
+ * Switch to the next favourited model. Warns if you have not starred any.
939
1639
  */
940
1640
  model_cycle_favorite?: string;
941
1641
  /**
942
- * Previous favorite model
1642
+ * Switch to the previous favourited model. Warns if you have not starred any.
943
1643
  */
944
1644
  model_cycle_favorite_reverse?: string;
945
1645
  /**
946
- * List available commands
1646
+ * Open the command palette — every action in one searchable list.
947
1647
  */
948
1648
  command_list?: string;
949
1649
  /**
950
- * List agents
1650
+ * Open the agent picker.
951
1651
  */
952
1652
  agent_list?: string;
953
1653
  /**
954
- * Next agent
1654
+ * Switch to the next agent.
955
1655
  */
956
1656
  agent_cycle?: string;
957
1657
  /**
958
- * Previous agent
1658
+ * Switch to the previous agent.
959
1659
  */
960
1660
  agent_cycle_reverse?: string;
961
1661
  /**
962
- * Cycle permission mode (default → acceptEdits → auto → plan)
1662
+ * Cycle the session's permission mode: default → acceptEdits → auto → plan → back to default.
963
1663
  */
964
1664
  permission_mode_cycle?: string;
965
1665
  /**
966
- * Cycle model variants
1666
+ * Cycle the model's thinking / reasoning-effort level: model default → each level the model offers → back to default. Does nothing on models with no levels.
967
1667
  */
968
1668
  variant_cycle?: string;
969
1669
  /**
970
- * Clear input field
1670
+ * Clear the prompt. Only fires while there is text; on an empty prompt the same default falls through to `app_exit`.
971
1671
  */
972
1672
  input_clear?: string;
973
1673
  /**
974
- * Paste from clipboard
1674
+ * Paste the system clipboard into the prompt. An image on the clipboard is attached as a file part instead of pasted as text.
975
1675
  */
976
1676
  input_paste?: string;
977
1677
  /**
978
- * Submit input
1678
+ * Send the prompt.
979
1679
  */
980
1680
  input_submit?: string;
981
1681
  /**
982
- * Insert newline in input
1682
+ * Insert a line break without sending.
983
1683
  */
984
1684
  input_newline?: string;
985
1685
  /**
986
- * Move cursor left in input
1686
+ * Move the cursor one character left.
987
1687
  */
988
1688
  input_move_left?: string;
989
1689
  /**
990
- * Move cursor right in input
1690
+ * Move the cursor one character right.
991
1691
  */
992
1692
  input_move_right?: string;
993
1693
  /**
994
- * Move cursor up in input
1694
+ * Move the cursor up one wrapped row.
995
1695
  */
996
1696
  input_move_up?: string;
997
1697
  /**
998
- * Move cursor down in input
1698
+ * Move the cursor down one wrapped row.
999
1699
  */
1000
1700
  input_move_down?: string;
1001
1701
  /**
1002
- * Select left in input
1702
+ * Inert. The prompt editor has no selection model, and unlike the other `input_select_*` keys this one is not wired to a cursor move either.
1003
1703
  */
1004
1704
  input_select_left?: string;
1005
1705
  /**
1006
- * Select right in input
1706
+ * Inert. The prompt editor has no selection model, and unlike the other `input_select_*` keys this one is not wired to a cursor move either.
1007
1707
  */
1008
1708
  input_select_right?: string;
1009
1709
  /**
1010
- * Select up in input
1710
+ * Moves the cursor up one wrapped row. The prompt editor has no selection model, so nothing is highlighted.
1011
1711
  */
1012
1712
  input_select_up?: string;
1013
1713
  /**
1014
- * Select down in input
1714
+ * Moves the cursor down one wrapped row. The prompt editor has no selection model, so nothing is highlighted.
1015
1715
  */
1016
1716
  input_select_down?: string;
1017
1717
  /**
1018
- * Move to start of line in input
1718
+ * Move the cursor to the start of the current line.
1019
1719
  */
1020
1720
  input_line_home?: string;
1021
1721
  /**
1022
- * Move to end of line in input
1722
+ * Move the cursor to the end of the current line.
1023
1723
  */
1024
1724
  input_line_end?: string;
1025
1725
  /**
1026
- * Select to start of line in input
1726
+ * Moves the cursor to the start of the line — identical to `input_line_home`. The prompt editor has no selection model.
1027
1727
  */
1028
1728
  input_select_line_home?: string;
1029
1729
  /**
1030
- * Select to end of line in input
1730
+ * Moves the cursor to the end of the line — identical to `input_line_end`. The prompt editor has no selection model.
1031
1731
  */
1032
1732
  input_select_line_end?: string;
1033
1733
  /**
1034
- * Move to start of visual line in input
1734
+ * Move the cursor to the start of the current line. Identical to `input_line_home` today: this movement works on real lines, not wrapped rows.
1035
1735
  */
1036
1736
  input_visual_line_home?: string;
1037
1737
  /**
1038
- * Move to end of visual line in input
1738
+ * Move the cursor to the end of the current line. Identical to `input_line_end` today: this movement works on real lines, not wrapped rows.
1039
1739
  */
1040
1740
  input_visual_line_end?: string;
1041
1741
  /**
1042
- * Select to start of visual line in input
1742
+ * Moves the cursor to the start of the line — identical to `input_line_home`. No selection model, and no wrapped-row behaviour either.
1043
1743
  */
1044
1744
  input_select_visual_line_home?: string;
1045
1745
  /**
1046
- * Select to end of visual line in input
1746
+ * Moves the cursor to the end of the line — identical to `input_line_end`. No selection model, and no wrapped-row behaviour either.
1047
1747
  */
1048
1748
  input_select_visual_line_end?: string;
1049
1749
  /**
1050
- * Move to start of buffer in input
1750
+ * Move the cursor to the very start of the prompt.
1051
1751
  */
1052
1752
  input_buffer_home?: string;
1053
1753
  /**
1054
- * Move to end of buffer in input
1754
+ * Move the cursor to the very end of the prompt.
1055
1755
  */
1056
1756
  input_buffer_end?: string;
1057
1757
  /**
1058
- * Select to start of buffer in input
1758
+ * Moves the cursor to the very start of the prompt — identical to `input_buffer_home`. The prompt editor has no selection model.
1059
1759
  */
1060
1760
  input_select_buffer_home?: string;
1061
1761
  /**
1062
- * Select to end of buffer in input
1762
+ * Moves the cursor to the very end of the prompt — identical to `input_buffer_end`. The prompt editor has no selection model.
1063
1763
  */
1064
1764
  input_select_buffer_end?: string;
1065
1765
  /**
1066
- * Delete line in input
1766
+ * Delete from the cursor to the end of the line — the same edit as `input_delete_to_line_end`, despite the name. The whole line is not removed.
1067
1767
  */
1068
1768
  input_delete_line?: string;
1069
1769
  /**
1070
- * Delete to end of line in input
1770
+ * Delete from the cursor to the end of the line.
1071
1771
  */
1072
1772
  input_delete_to_line_end?: string;
1073
1773
  /**
1074
- * Delete to start of line in input
1774
+ * Delete from the start of the line up to the cursor.
1075
1775
  */
1076
1776
  input_delete_to_line_start?: string;
1077
1777
  /**
1078
- * Backspace in input
1778
+ * Delete the character before the cursor.
1079
1779
  */
1080
1780
  input_backspace?: string;
1081
1781
  /**
1082
- * Delete character in input
1782
+ * Delete the character after the cursor.
1083
1783
  */
1084
1784
  input_delete?: string;
1085
1785
  /**
1086
- * Undo in input
1786
+ * Undo the last edit to the prompt text. This is the prompt's own edit history — to undo a sent message use `messages_undo`. On Windows the default also includes ctrl+z.
1087
1787
  */
1088
1788
  input_undo?: string;
1089
1789
  /**
1090
- * Redo in input
1790
+ * Redo an edit to the prompt text undone by `input_undo`.
1091
1791
  */
1092
1792
  input_redo?: string;
1093
1793
  /**
1094
- * Move word forward in input
1794
+ * Move the cursor one word right.
1095
1795
  */
1096
1796
  input_word_forward?: string;
1097
1797
  /**
1098
- * Move word backward in input
1798
+ * Move the cursor one word left.
1099
1799
  */
1100
1800
  input_word_backward?: string;
1101
1801
  /**
1102
- * Select word forward in input
1802
+ * Moves the cursor one word right — identical to `input_word_forward`. The prompt editor has no selection model.
1103
1803
  */
1104
1804
  input_select_word_forward?: string;
1105
1805
  /**
1106
- * Select word backward in input
1806
+ * Moves the cursor one word left — identical to `input_word_backward`. The prompt editor has no selection model.
1107
1807
  */
1108
1808
  input_select_word_backward?: string;
1109
1809
  /**
1110
- * Delete word forward in input
1810
+ * Delete from the cursor forward to the end of the word.
1111
1811
  */
1112
1812
  input_delete_word_forward?: string;
1113
1813
  /**
1114
- * Delete word backward in input
1814
+ * Delete from the cursor back to the start of the word.
1115
1815
  */
1116
1816
  input_delete_word_backward?: string;
1117
1817
  /**
1118
- * Previous history item
1818
+ * Recall the previous prompt you submitted. Only fires when the cursor is already at the very start of the prompt, so it never fights with cursor movement.
1119
1819
  */
1120
1820
  history_previous?: string;
1121
1821
  /**
1122
- * Next history item
1822
+ * Recall the next prompt in history. Only fires when the cursor is already at the very end of the prompt, so it never fights with cursor movement.
1123
1823
  */
1124
1824
  history_next?: string;
1125
1825
  /**
1126
- * Next child session
1826
+ * Move to the next sub-session spawned by this one.
1127
1827
  */
1128
1828
  session_child_cycle?: string;
1129
1829
  /**
1130
- * Previous child session
1830
+ * Move to the previous sub-session spawned by this one.
1131
1831
  */
1132
1832
  session_child_cycle_reverse?: string;
1133
1833
  /**
1134
- * Go to parent session
1834
+ * Go back up to the session that spawned this one.
1135
1835
  */
1136
1836
  session_parent?: string;
1137
1837
  /**
1138
- * Suspend terminal
1838
+ * Suspend to the shell (SIGTSTP). Bring it back with `fg` and the UI redraws. Not available on Windows, which has no SIGTSTP: there the default is unbound and ctrl+z is undo (`input_undo`).
1139
1839
  */
1140
1840
  terminal_suspend?: string;
1141
1841
  /**
1142
- * Toggle terminal title
1842
+ * Turn terminal window-title updates on or off. The choice is remembered between runs.
1143
1843
  */
1144
1844
  terminal_title_toggle?: string;
1145
1845
  /**
1146
- * Toggle tips on home screen
1846
+ * Show or hide the tips block on the home screen. Only bound on the home screen — inside a session the same default runs `messages_toggle_conceal`.
1147
1847
  */
1148
1848
  tips_toggle?: string;
1149
1849
  /**
1150
- * Toggle companion sprite
1850
+ * Show or hide the companion sprite in the session view. The choice is remembered between runs.
1151
1851
  */
1152
1852
  sprites_toggle?: string;
1853
+ /**
1854
+ * Search the whole session — replies, prompts, thinking and tool output — and jump to what matches.
1855
+ */
1856
+ transcript_search?: string;
1857
+ /**
1858
+ * Search earlier prompts (in this project) by any words in them, and put the one picked back in the prompt.
1859
+ */
1860
+ history_search?: string;
1861
+ /**
1862
+ * Show the full transcript: every tool panel open and every output unabridged. Press again to go back.
1863
+ */
1864
+ transcript_full?: string;
1865
+ /**
1866
+ * Open the file finder and add the picked file to the prompt as an @-mention.
1867
+ */
1868
+ file_quick_open?: string;
1869
+ /**
1870
+ * Stop everything running in the background: shells, subagents and sessions sent to the background.
1871
+ */
1872
+ agents_stop_all?: string;
1153
1873
  };
1154
1874
  /**
1155
- * Log level
1875
+ * Lowest severity written to the log file. DEBUG is the most detailed and ERROR the least.
1156
1876
  */
1157
1877
  export type LogLevel = "DEBUG" | "INFO" | "WARN" | "ERROR";
1158
1878
  /**
1159
- * Server configuration for 100xprompt serve and web commands
1879
+ * Where the HTTP server binds and who may talk to it. Applies to `100xprompt serve` and anything else that starts the server.
1160
1880
  */
1161
1881
  export type ServerConfig = {
1162
1882
  /**
1163
- * Port to listen on
1883
+ * Port the HTTP server binds to. Leave unset to try 4096 first and fall back to any free port. `--port` on the command line wins over this.
1164
1884
  */
1165
1885
  port?: number;
1166
1886
  /**
1167
- * Hostname to listen on
1887
+ * Address the HTTP server binds to. Defaults to 127.0.0.1, or 0.0.0.0 when `mdns` is on and no hostname is set here. `--hostname` on the command line wins over this.
1168
1888
  */
1169
1889
  hostname?: string;
1170
1890
  /**
1171
- * Enable mDNS service discovery
1891
+ * Advertise the server over mDNS/Bonjour so other machines on the LAN can find it. Skipped with a warning if the server is bound to loopback, since nothing off-box could reach it anyway.
1172
1892
  */
1173
1893
  mdns?: boolean;
1174
1894
  /**
1175
- * Additional domains to allow for CORS
1895
+ * Extra origins allowed to call the HTTP server, matched exactly. localhost, 127.0.0.1, tauri://localhost and *.100xprompt.com/.ai are already allowed. Any `--cors` values are added to this list rather than replacing it.
1176
1896
  */
1177
1897
  cors?: Array<string>;
1178
1898
  };
@@ -1181,6 +1901,9 @@ export type PermissionObjectConfig = {
1181
1901
  [key: string]: PermissionActionConfig;
1182
1902
  };
1183
1903
  export type PermissionRuleConfig = PermissionActionConfig | PermissionObjectConfig;
1904
+ /**
1905
+ * What may run without asking. Each tool maps to allow (run silently), ask (prompt first) or deny (refuse outright); bash and edit can also take per-pattern rules so, say, `git status` is allowed while `git push` still prompts.
1906
+ */
1184
1907
  export type PermissionConfig = {
1185
1908
  __originalKeys?: Array<string>;
1186
1909
  read?: PermissionRuleConfig;
@@ -1199,7 +1922,15 @@ export type PermissionConfig = {
1199
1922
  codesearch?: PermissionActionConfig;
1200
1923
  lsp?: PermissionRuleConfig;
1201
1924
  doom_loop?: PermissionActionConfig;
1202
- [key: string]: PermissionRuleConfig | Array<string> | PermissionActionConfig | undefined;
1925
+ /**
1926
+ * Extra directories agents may operate in beyond the workspace root. Org policy can pin these as an immutable directory boundary.
1927
+ */
1928
+ additionalDirectories?: Array<string>;
1929
+ /**
1930
+ * Policy-pinned workspace root. Highest-precedence directory boundary; overrides the env var.
1931
+ */
1932
+ workspaceRoot?: string;
1933
+ [key: string]: PermissionRuleConfig | Array<string> | PermissionActionConfig | Array<string> | string | undefined;
1203
1934
  } | PermissionActionConfig;
1204
1935
  export type AgentConfig = {
1205
1936
  model?: string;
@@ -1207,7 +1938,7 @@ export type AgentConfig = {
1207
1938
  top_p?: number;
1208
1939
  prompt?: string;
1209
1940
  /**
1210
- * @deprecated Use 'permission' field instead
1941
+ * Superseded by `permission`. Kept working by translation: true becomes an allow rule and false a deny rule for that tool name, with write/edit/patch/multiedit all collapsing onto the single `edit` permission. Anything set in `permission` overrides the result, so prefer that.
1211
1942
  */
1212
1943
  tools?: {
1213
1944
  [key: string]: boolean;
@@ -1222,6 +1953,10 @@ export type AgentConfig = {
1222
1953
  * Hide this subagent from the @ autocomplete menu (default: false, only applies to mode: subagent)
1223
1954
  */
1224
1955
  hidden?: boolean;
1956
+ /**
1957
+ * Use a slim system prompt when this agent runs as a spawned subagent: skips memory, mode prompts, and the full environment block (default: true for task-spawned subagents; set false to opt out)
1958
+ */
1959
+ slim?: boolean;
1225
1960
  options?: {
1226
1961
  [key: string]: unknown;
1227
1962
  };
@@ -1395,45 +2130,85 @@ export type McpRemoteConfig = {
1395
2130
  timeout?: number;
1396
2131
  };
1397
2132
  /**
1398
- * @deprecated Always uses stretch layout.
2133
+ * No longer has any effect. The terminal UI sizes itself to the window and has no alternative layouts; the key is still accepted so older config files keep validating.
2134
+ *
2135
+ * @deprecated
1399
2136
  */
1400
2137
  export type LayoutConfig = "auto" | "stretch";
2138
+ /**
2139
+ * Permission mode new sessions start in. --permission-mode and mid-session toggles still override it.
2140
+ */
2141
+ export type PermissionModeConfig = "default" | "acceptEdits" | "plan" | "auto" | "bypassPermissions";
2142
+ /**
2143
+ * Claude Code-style structured permissions: allow/deny/ask rule strings plus defaultMode and disableBypassPermissionsMode. Merged with `permission` (structured rules take precedence). See https://100xprompt.com/docs/permissions
2144
+ */
2145
+ export type PermissionsConfig = {
2146
+ /**
2147
+ * CC-style allow rules, e.g. "Bash(git status:*)", "Edit"
2148
+ */
2149
+ allow?: Array<string>;
2150
+ /**
2151
+ * CC-style deny rules — deny always wins over allow for a tool
2152
+ */
2153
+ deny?: Array<string>;
2154
+ /**
2155
+ * CC-style ask rules — force a prompt even when another rule allows
2156
+ */
2157
+ ask?: Array<string>;
2158
+ defaultMode?: PermissionModeConfig;
2159
+ /**
2160
+ * When "disable", removes bypassPermissions from the settable modes for this project.
2161
+ */
2162
+ disableBypassPermissionsMode?: "disable";
2163
+ };
1401
2164
  export type Config = {
1402
2165
  /**
1403
- * JSON schema reference for configuration validation
2166
+ * URL of the schema this file is validated against. Set it to https://proxy.100xprompt.com/config.json to get completion and inline documentation in your editor.
1404
2167
  */
1405
2168
  $schema?: string;
1406
2169
  /**
1407
- * Theme name to use for the interface
2170
+ * Colour theme for the terminal UI. Accepts any built-in theme name or one defined in a themes/ directory. Omit to follow the terminal's own palette.
1408
2171
  */
1409
2172
  theme?: string;
1410
2173
  keybinds?: KeybindsConfig;
1411
2174
  logLevel?: LogLevel;
1412
2175
  /**
1413
- * TUI specific settings
2176
+ * Enable the OS command sandbox (seatbelt on macOS, bwrap on Linux). Default: OFF on macOS, ON elsewhere. Set true to opt in on macOS, false to opt out anywhere.
2177
+ */
2178
+ sandbox?: boolean;
2179
+ /**
2180
+ * Skip the bash permission prompt for commands the sandbox actually contains, since the kernel is already enforcing the boundary. Default: ON wherever the sandbox is active. Commands that can exfiltrate data (curl, ssh, rsync…), dangerous commands, and denied/plan-mode commands always still prompt. Set false to always prompt.
2181
+ */
2182
+ sandboxAutoApprove?: boolean;
2183
+ /**
2184
+ * Which sandbox backend confines untrusted bash commands. Default: seatbelt on macOS, landlock on Linux (unset = platform default, unchanged behavior). "microvm" runs each command in a VM-isolated environment with its own kernel — detected via HUNDREDXPROMPT_MICROVM_RUNNER or a `msb` (microsandbox), `docker`, `podman`, or apple `container` CLI on PATH (image: HUNDREDXPROMPT_MICROVM_IMAGE, default alpine). If no runner is present it degrades gracefully to the platform sandbox. "seatbelt"/"landlock" pin that backend (honored only on the matching OS); "none" disables the sandbox like sandbox: false.
2185
+ */
2186
+ sandboxBackend?: "microvm" | "seatbelt" | "landlock" | "none";
2187
+ /**
2188
+ * Behaviour of the terminal UI itself — scrolling feel and how diffs are laid out.
1414
2189
  */
1415
2190
  tui?: {
1416
2191
  /**
1417
- * TUI scroll speed
2192
+ * Rows moved per mouse-wheel notch in the transcript. Default 3. Ignored when `scroll_acceleration.enabled` is true, which replaces the fixed step entirely.
1418
2193
  */
1419
2194
  scroll_speed?: number;
1420
2195
  /**
1421
- * Scroll acceleration settings
2196
+ * Momentum scrolling for the transcript, in place of a fixed rows-per-notch step. Overrides `scroll_speed` when enabled.
1422
2197
  */
1423
2198
  scroll_acceleration?: {
1424
2199
  /**
1425
- * Enable scroll acceleration
2200
+ * Turn on the acceleration curve. Flick the wheel and the transcript keeps travelling; a slow scroll stays precise.
1426
2201
  */
1427
2202
  enabled: boolean;
1428
2203
  };
1429
2204
  /**
1430
- * Control diff rendering style: 'auto' adapts to terminal width, 'stacked' always shows single column
2205
+ * How file diffs are laid out. "auto" (the default) shows them side by side once the terminal is wider than 120 columns and stacks them below that; "stacked" always keeps the single-column unified view.
1431
2206
  */
1432
2207
  diff_style?: "auto" | "stacked";
1433
2208
  };
1434
2209
  server?: ServerConfig;
1435
2210
  /**
1436
- * Command configuration, see https://100xprompt.com/docs/commands
2211
+ * Custom slash commands, keyed by the name you type after '/'. See https://100xprompt.com/docs/commands
1437
2212
  */
1438
2213
  command?: {
1439
2214
  [key: string]: {
@@ -1442,41 +2217,209 @@ export type Config = {
1442
2217
  agent?: string;
1443
2218
  model?: string;
1444
2219
  subtask?: boolean;
2220
+ plugin?: string;
2221
+ "allowed-tools"?: string | Array<string>;
2222
+ "argument-hint"?: string;
2223
+ aliases?: Array<string>;
1445
2224
  };
1446
2225
  };
2226
+ /**
2227
+ * Which paths the file watcher pays attention to while a session is open.
2228
+ */
1447
2229
  watcher?: {
2230
+ /**
2231
+ * Extra glob patterns to ignore, on top of .gitignore and the built-in exclusions.
2232
+ */
1448
2233
  ignore?: Array<string>;
1449
2234
  };
2235
+ /**
2236
+ * Plugins to load, each either an npm package (optionally @version, defaulting to latest) or a file:// path to a local module. Loaded in addition to the built-in plugins.
2237
+ */
1450
2238
  plugin?: Array<string>;
2239
+ /**
2240
+ * Lifecycle hooks (command, prompt, agent, http) keyed by event: PreToolUse, PostToolUse, PostToolUseFailure, UserPromptSubmit, PermissionRequest, SessionStart, SessionEnd, Stop, PreCompact, PostCompact, and more
2241
+ */
2242
+ hooks?: {
2243
+ [key: string]: Array<{
2244
+ /**
2245
+ * Regex matched against the tool name (PreToolUse/PostToolUse only)
2246
+ */
2247
+ matcher?: string;
2248
+ hooks: Array<{
2249
+ /**
2250
+ * Shell hook (default type)
2251
+ */
2252
+ type?: "command";
2253
+ /**
2254
+ * Shell command. Receives the event JSON on stdin
2255
+ */
2256
+ command: string;
2257
+ /**
2258
+ * Timeout in seconds (default 60)
2259
+ */
2260
+ timeout?: number;
2261
+ } | {
2262
+ /**
2263
+ * Single non-streaming LLM validation call
2264
+ */
2265
+ type: "prompt";
2266
+ /**
2267
+ * Validation instructions for the model
2268
+ */
2269
+ prompt?: string;
2270
+ /**
2271
+ * Model as provider/model (defaults to the small model)
2272
+ */
2273
+ model?: string;
2274
+ /**
2275
+ * Timeout in seconds (default 60)
2276
+ */
2277
+ timeout?: number;
2278
+ } | {
2279
+ /**
2280
+ * Read-only verifier subagent
2281
+ */
2282
+ type: "agent";
2283
+ /**
2284
+ * Verification instructions for the subagent
2285
+ */
2286
+ prompt?: string;
2287
+ /**
2288
+ * Agent definition to run (default: general)
2289
+ */
2290
+ agent?: string;
2291
+ /**
2292
+ * Model as provider/model
2293
+ */
2294
+ model?: string;
2295
+ /**
2296
+ * Max tool turns (capped at 50)
2297
+ */
2298
+ maxTurns?: number;
2299
+ /**
2300
+ * Timeout in seconds (default 300)
2301
+ */
2302
+ timeout?: number;
2303
+ } | {
2304
+ /**
2305
+ * Webhook (SSRF-guarded; private addresses refused)
2306
+ */
2307
+ type: "http";
2308
+ /**
2309
+ * Webhook URL (http/https)
2310
+ */
2311
+ url: string;
2312
+ /**
2313
+ * HTTP method (default POST)
2314
+ */
2315
+ method?: "POST" | "PUT";
2316
+ /**
2317
+ * Extra headers; ${ENV_VAR} is interpolated
2318
+ */
2319
+ headers?: {
2320
+ [key: string]: string;
2321
+ };
2322
+ /**
2323
+ * Timeout in seconds (default 30)
2324
+ */
2325
+ timeout?: number;
2326
+ }>;
2327
+ }>;
2328
+ };
2329
+ /**
2330
+ * Adversarial verification gate — require a read-only verifier subagent verdict before completion reporting on significant changes
2331
+ */
2332
+ verification?: {
2333
+ /**
2334
+ * Enable the adversarial verification gate: significant turns (threshold+ files modified) cannot mark the final todo completed until a verification subagent has issued VERDICT: PASS/FAIL/PARTIAL. Default false
2335
+ */
2336
+ enabled?: boolean;
2337
+ /**
2338
+ * Distinct files modified in a turn before verification is required. Default 3
2339
+ */
2340
+ threshold?: number;
2341
+ /**
2342
+ * Subagent spawned to verify the work (default: verifier)
2343
+ */
2344
+ agent?: string;
2345
+ };
2346
+ /**
2347
+ * Kairos mode — Claude Code-style background pacing (tick loop + model-controlled sleep) with terminal-focus-aware autonomy
2348
+ */
2349
+ kairos?: {
2350
+ /**
2351
+ * Enable the /kairos TUI command: a background tick loop where the model paces itself with the sleep tool and calibrates autonomy to terminal focus. Default true; set false to disable
2352
+ */
2353
+ enabled?: boolean;
2354
+ /**
2355
+ * Seconds to wait before the next tick when the model didn't call sleep. Default 60
2356
+ */
2357
+ default_sleep?: number;
2358
+ };
2359
+ /**
2360
+ * Enable Vim keybindings in the TUI prompt input
2361
+ */
2362
+ vim?: boolean;
2363
+ /**
2364
+ * Show an end-of-turn recap (Crunched for … + a one-line summary of what changed). Default on.
2365
+ */
2366
+ recap?: boolean;
2367
+ /**
2368
+ * Active output style (built-in: explanatory, learning, concise; or a custom output-styles*.md name)
2369
+ */
2370
+ output_style?: string;
2371
+ /**
2372
+ * Defer MCP tool schemas behind a `tool_search` tool to save context. Deferred by default when more than 8 MCP tools are available; set false to disable, true to always defer, or a number to use a custom threshold
2373
+ */
2374
+ tool_search?: boolean | number;
2375
+ /**
2376
+ * Whether to record a restorable snapshot of the working tree before edits, which is what makes reverting a turn possible. On by default; set false to skip it entirely.
2377
+ */
1451
2378
  snapshot?: boolean;
1452
2379
  /**
1453
- * Control sharing behavior:'manual' allows manual sharing via commands, 'auto' enables automatic sharing, 'disabled' disables all sharing
2380
+ * Who can be given a link to a session. 'manual' (the default) shares only when you ask for it; 'auto' publishes every new session as it starts; 'disabled' refuses to share at all and hides the share command.
1454
2381
  */
1455
2382
  share?: "manual" | "auto" | "disabled";
1456
2383
  /**
1457
- * @deprecated Use 'share' field instead. Share newly created sessions automatically
2384
+ * Superseded by `share`. Setting this to true is rewritten to `share: "auto"` when the config loads, and only when `share` is not set — so if you set both, `share` wins. Nothing else reads this key.
1458
2385
  */
1459
2386
  autoshare?: boolean;
1460
2387
  /**
1461
- * Automatically update to the latest version. Set to true to auto-update, false to disable, or 'notify' to show update notifications
2388
+ * What to do when a newer release exists: true installs it in the background, 'notify' only mentions it and leaves the upgrade to you, false stops checking altogether.
1462
2389
  */
1463
2390
  autoupdate?: boolean | "notify";
1464
2391
  /**
1465
- * Disable providers that are loaded automatically
2392
+ * Whether to show usage on your own API keys (OpenRouter, Anthropic, any provider you configure) on your 100xprompt dashboard alongside gateway usage. When you are signed in, each finished step on your own key sends only numbers and names: token counts, cost, provider, model and the upstream that served it, never prompts, replies, tool data, file paths, keys or config. Usage through the 100xprompt gateway is never reported this way, and own-key usage never counts toward your plan. On by default; set false, or export HUNDREDXPROMPT_DISABLE_USAGE_REPORT=1, to stop it.
2393
+ */
2394
+ usageReport?: boolean;
2395
+ /**
2396
+ * Provider ids to leave out even though credentials for them were found. Use this to stop a provider you have keys for from being offered.
1466
2397
  */
1467
2398
  disabled_providers?: Array<string>;
1468
2399
  /**
1469
- * When set, ONLY these providers will be enabled. All other providers will be ignored
2400
+ * Provider ids to allow, as an exclusive list: once this is set, every provider not named here is ignored regardless of available credentials.
1470
2401
  */
1471
2402
  enabled_providers?: Array<string>;
1472
2403
  /**
1473
- * Model to use in the format of provider/model, eg anthropic/claude-2
2404
+ * The model each new session starts on, written as provider/model — for example anthropic/claude-sonnet-4-5 or 100xprompt/pro. Leave unset to use the best model your credentials allow.
1474
2405
  */
1475
2406
  model?: string;
1476
2407
  /**
1477
- * Small model to use for tasks like title generation in the format of provider/model
2408
+ * Model to retry with, as provider/model, when the primary one is rate-limited, overloaded, or otherwise refusing work. Pick something on a different provider so a single outage cannot take out both.
2409
+ */
2410
+ fallback_model?: string;
2411
+ /**
2412
+ * Cheaper model, as provider/model, for the small side-jobs that run alongside a conversation: session titles, summaries and similar. Never used for your actual turns.
1478
2413
  */
1479
2414
  small_model?: string;
2415
+ /**
2416
+ * Stronger model consulted by the /second-opinion command, in the format of provider/model. Defaults to the strongest available model
2417
+ */
2418
+ advisor_model?: string;
2419
+ /**
2420
+ * Stronger model to use when the session is in plan mode (e.g. 'anthropic/claude-opus-4-5'). When set and the session permission mode is 'plan', requests use this model instead of the session's normal model. Supports provider/model format or a short alias (e.g. 'opus').
2421
+ */
2422
+ plan_model?: string;
1480
2423
  /**
1481
2424
  * Long-term memory system configuration
1482
2425
  */
@@ -1501,17 +2444,46 @@ export type Config = {
1501
2444
  * Override the side-model used for memory extraction/consolidation/recall, in the format of provider/model
1502
2445
  */
1503
2446
  model?: string;
2447
+ /**
2448
+ * Shared / team memory backend (Firestore). When a workspace id and GCP credentials are configured, memory is shared across the team with per-record access control; otherwise memory stays local-only.
2449
+ */
2450
+ team?: {
2451
+ /**
2452
+ * Team/workspace id. When set (together with GCP credentials) team memory is enabled: memories can be shared with the workspace and are stored in Firestore under this namespace. Off by default.
2453
+ */
2454
+ workspace?: string;
2455
+ /**
2456
+ * Stable id for the current user within the workspace, used as the memory owner and to filter private memories. Defaults to the OS username when omitted.
2457
+ */
2458
+ user?: string;
2459
+ /**
2460
+ * GCP project id for Firestore. Falls back to the GCP_PROJECT_ID / GOOGLE_CLOUD_PROJECT environment variables when omitted.
2461
+ */
2462
+ project_id?: string;
2463
+ /**
2464
+ * Path to a GCP service-account JSON key file for Firestore, or the JSON itself. Falls back to Application Default Credentials (GOOGLE_APPLICATION_CREDENTIALS) when omitted.
2465
+ */
2466
+ credentials?: string;
2467
+ /**
2468
+ * Root Firestore collection for team memories (default 'team-memories').
2469
+ */
2470
+ collection?: string;
2471
+ /**
2472
+ * Visibility applied to new memories written while team mode is on (default 'private'). Reads always merge the user's private memories with team-visible ones.
2473
+ */
2474
+ default_visibility?: "private" | "team";
2475
+ };
1504
2476
  };
1505
2477
  /**
1506
2478
  * Default agent to use when none is specified. Must be a primary agent. Falls back to 'build' if not set or if the specified agent is invalid.
1507
2479
  */
1508
2480
  default_agent?: string;
1509
2481
  /**
1510
- * Custom username to display in conversations instead of system username
2482
+ * Name shown against your messages in the transcript. Defaults to your operating-system username.
1511
2483
  */
1512
2484
  username?: string;
1513
2485
  /**
1514
- * @deprecated Use `agent` field instead.
2486
+ * Superseded by `agent`. Each entry here is merged into `agent` as a primary agent when the config loads, so existing files keep working — but new configuration belongs under `agent`, which is the only place subagents can be defined.
1515
2487
  */
1516
2488
  mode?: {
1517
2489
  build?: AgentConfig;
@@ -1519,7 +2491,7 @@ export type Config = {
1519
2491
  [key: string]: AgentConfig | undefined;
1520
2492
  };
1521
2493
  /**
1522
- * Agent configuration, see https://100xprompt.com/docs/agent
2494
+ * Define or adjust agents, keyed by agent name. The built-ins (build, plan, general, explore and the specialised title/summary/compaction ones) can be reconfigured here, and any other name creates a new agent. See https://100xprompt.com/docs/agent
1523
2495
  */
1524
2496
  agent?: {
1525
2497
  plan?: AgentConfig;
@@ -1532,19 +2504,34 @@ export type Config = {
1532
2504
  [key: string]: AgentConfig | undefined;
1533
2505
  };
1534
2506
  /**
1535
- * Custom provider configurations and model overrides
2507
+ * Add providers or change ones already known, keyed by provider id. Use it to point at a self-hosted or OpenAI-compatible endpoint, supply base URLs and headers, or correct the cost and context limits of an individual model.
1536
2508
  */
1537
2509
  provider?: {
1538
2510
  [key: string]: ProviderConfig;
1539
2511
  };
1540
2512
  /**
1541
- * MCP (Model Context Protocol) server configurations
2513
+ * MCP servers to connect to, keyed by the name their tools are prefixed with. An entry is either a full server definition (a local command to spawn, or a remote URL) or just `{ "enabled": false }` to switch off one declared elsewhere.
1542
2514
  */
1543
2515
  mcp?: {
1544
2516
  [key: string]: McpLocalConfig | McpRemoteConfig | {
1545
2517
  enabled: boolean;
1546
2518
  };
1547
2519
  };
2520
+ /**
2521
+ * Automatically approve every MCP server declared in the project's committed .mcp.json. Security: leave off so untrusted repo servers require explicit opt-in.
2522
+ */
2523
+ enableAllProjectMcpServers?: boolean;
2524
+ /**
2525
+ * Names of project .mcp.json MCP servers approved to connect (Claude Code parity)
2526
+ */
2527
+ enabledMcpjsonServers?: Array<string>;
2528
+ /**
2529
+ * Names of project .mcp.json MCP servers rejected — they never connect (Claude Code parity)
2530
+ */
2531
+ disabledMcpjsonServers?: Array<string>;
2532
+ /**
2533
+ * Code formatters run after a file is edited, keyed by formatter name. Override the command or file extensions of a built-in, add your own, disable one with `disabled: true`, or set this whole field to false to format nothing.
2534
+ */
1548
2535
  formatter?: false | {
1549
2536
  [key: string]: {
1550
2537
  disabled?: boolean;
@@ -1555,6 +2542,9 @@ export type Config = {
1555
2542
  extensions?: Array<string>;
1556
2543
  };
1557
2544
  };
2545
+ /**
2546
+ * Language servers used for diagnostics and symbol lookup, keyed by server id. Override a built-in's command, add a server of your own (`extensions` is required for those), disable one with `disabled: true`, or set this whole field to false to run no language servers.
2547
+ */
1558
2548
  lsp?: false | {
1559
2549
  [key: string]: {
1560
2550
  disabled: true;
@@ -1571,23 +2561,31 @@ export type Config = {
1571
2561
  };
1572
2562
  };
1573
2563
  /**
1574
- * Additional instruction files or patterns to include
2564
+ * Extra files whose contents are prepended to the system prompt, as paths or glob patterns relative to the project root. These are read in addition to the AGENTS.md files found automatically, not instead of them.
1575
2565
  */
1576
2566
  instructions?: Array<string>;
1577
2567
  layout?: LayoutConfig;
1578
2568
  permission?: PermissionConfig;
2569
+ permissions?: PermissionsConfig;
2570
+ /**
2571
+ * Superseded by `permission`. Kept working by translation: true becomes an allow rule and false a deny rule for that tool name, with write/edit/patch/multiedit all collapsing onto the single `edit` permission. Anything set in `permission` overrides the result, so prefer that.
2572
+ */
1579
2573
  tools?: {
1580
2574
  [key: string]: boolean;
1581
2575
  };
2576
+ /**
2577
+ * Settings for an organisation-hosted deployment.
2578
+ */
1582
2579
  enterprise?: {
1583
2580
  /**
1584
- * Enterprise URL
2581
+ * Base URL of your organisation's 100xprompt deployment, used to fetch managed configuration.
1585
2582
  */
1586
2583
  url?: string;
1587
2584
  };
1588
2585
  compaction?: {
1589
2586
  auto?: {
1590
2587
  enabled?: boolean;
2588
+ compactionThresholdPct?: number;
1591
2589
  compactionThreshold?: number;
1592
2590
  tailPreserveTurns?: number;
1593
2591
  summaryMaxTokens?: number;
@@ -1602,7 +2600,37 @@ export type Config = {
1602
2600
  coldPreviewTokens?: number;
1603
2601
  };
1604
2602
  };
2603
+ /**
2604
+ * Prompt-cache tuning for Anthropic-family models
2605
+ */
2606
+ cache?: {
2607
+ /**
2608
+ * Prompt-cache lifetime for Anthropic-family models. "1h" (default) keeps the cached prefix alive across long pauses — writes cost 2x base but the prefix is reused instead of re-written every turn, a net win for long interactive/agentic sessions. "5m" writes cheapest (1.25x base input). No effect on non-Anthropic providers.
2609
+ */
2610
+ ttl?: "5m" | "1h";
2611
+ };
1605
2612
  experimental?: {
2613
+ /**
2614
+ * Out-of-band permission approval. Requires HUNDREDXPROMPT_CHANNEL_RELAY=1 and the HMAC key in HUNDREDXPROMPT_CHANNEL_SECRET. There is deliberately no `secret` field here: this file is project-committed, and a committed approval key is a backdoor.
2615
+ */
2616
+ channel?: {
2617
+ /**
2618
+ * Responder identities (chat/user ids) permitted to approve or deny a relayed permission prompt. Empty authorizes nobody.
2619
+ */
2620
+ allow?: Array<string>;
2621
+ telegram?: {
2622
+ token: string;
2623
+ chatID: string;
2624
+ };
2625
+ /**
2626
+ * Approval deadline in ms; on expiry the relay denies. Default 600000.
2627
+ */
2628
+ timeoutMs?: number;
2629
+ /**
2630
+ * 'deny' (default) fails closed when no channel accepted the prompt; 'degrade' falls back to the local dialog. Neither can produce an allow.
2631
+ */
2632
+ unreachable?: "deny" | "degrade";
2633
+ };
1606
2634
  hook?: {
1607
2635
  file_edited?: {
1608
2636
  [key: string]: Array<{
@@ -1624,14 +2652,147 @@ export type Config = {
1624
2652
  */
1625
2653
  chatMaxRetries?: number;
1626
2654
  disable_paste_summary?: boolean;
2655
+ /**
2656
+ * Self-evolving skills (offline, validation-gated). Disabled by default.
2657
+ */
2658
+ skillEvolve?: {
2659
+ /**
2660
+ * Automatically run validation-gated skill evolution on a daily throttle. Default FALSE (manual only — run `100xprompt skills evolve <name>` yourself). Set true to let 100xprompt self-improve your skills in the background, always behind the validation gate (a skill is only changed if it measurably improves on your recent sessions).
2661
+ */
2662
+ enabled?: boolean;
2663
+ /**
2664
+ * Restrict auto-evolution to these skill names. Empty/omitted evolves every discovered skill. Manual `skills evolve <name>` is unaffected by this list.
2665
+ */
2666
+ skills?: Array<string>;
2667
+ /**
2668
+ * Model (provider/model) that proposes skill edits. Defaults to a strong cheap teacher.
2669
+ */
2670
+ optimizerModel?: string;
2671
+ /**
2672
+ * Gate comparison metric. 'hard' (default) = binary failure-mode coverage; 'soft' = partial-credit (sensitive to incremental edits); 'mixed' = weighted blend of both (see mixedWeight).
2673
+ */
2674
+ gateMetric?: "hard" | "soft" | "mixed";
2675
+ /**
2676
+ * For gateMetric 'mixed': weight given to soft coverage in [0,1]. Default 0.5.
2677
+ */
2678
+ mixedWeight?: number;
2679
+ /**
2680
+ * Autonomous learning-rate: scale the per-pass edit budget up/down from recent gate outcomes instead of a fixed budget. Default false (fixed budget).
2681
+ */
2682
+ autonomousLr?: boolean;
2683
+ /**
2684
+ * Epoch-level slow update: maintain a protected long-horizon guidance section in the skill that step edits can't touch. Default false.
2685
+ */
2686
+ slowUpdate?: boolean;
2687
+ /**
2688
+ * Dream rollouts + associative recall (synthetic augmentation for sparse data). Default off.
2689
+ */
2690
+ dream?: {
2691
+ /**
2692
+ * Synthesize this many contrastive variations per real replay item when held-out data is thin. >1 enables dream augmentation.
2693
+ */
2694
+ rollouts?: number;
2695
+ /**
2696
+ * Associative recall: pull the K most task-similar past items into tonight's replay set. >0 enables recall.
2697
+ */
2698
+ recallK?: number;
2699
+ };
2700
+ };
2701
+ /**
2702
+ * Suggested next prompt after each turn (experimental, side-model). Disabled by default.
2703
+ */
2704
+ promptSuggestion?: {
2705
+ /**
2706
+ * After each turn ends, a cheap side-model reads the recent conversation and proposes a suggested next prompt in the TUI input footer (accept to fill the input, ignore to dismiss). Default FALSE — fully inert when off: no model call, no render. Interactive CLI only; never fires for SDK/headless/subagent sessions.
2707
+ */
2708
+ enabled?: boolean;
2709
+ /**
2710
+ * Suggestion prompt variant. 'user_intent' (default) predicts what the user would naturally type next; 'stated_intent' currently shares the same prompt.
2711
+ */
2712
+ variant?: "user_intent" | "stated_intent";
2713
+ };
1627
2714
  /**
1628
2715
  * Enable the batch tool
1629
2716
  */
1630
2717
  batch_tool?: boolean;
2718
+ /**
2719
+ * Run the plugin host in a supervised child process (the VS Code extension-host model): plugins execute out-of-process over JSON-RPC stdio, so a crashing plugin cannot take the agent down and a hung plugin hook is killed and the child restarted (bounded by a restart budget; on exhaustion plugins degrade to unavailable while the agent keeps running). Default FALSE — the in-process plugin host is used. Plugin-provided tools and auth are not served in isolated mode.
2720
+ */
2721
+ pluginIsolation?: boolean;
2722
+ /**
2723
+ * Persistent (unattended) transport retry. Disabled by default — strictly additive, interactive behavior unchanged when off.
2724
+ */
2725
+ persistentRetry?: {
2726
+ /**
2727
+ * Unattended/long-running agentic tasks: keep retrying retryable provider failures (429/529/5xx/network) past the interactive ceiling, with capped backoff + heartbeat waits, until maxWaitMs elapses. Default FALSE — interactive sessions stay bounded (fast-fail to the session retry countdown). Background calls still bail on 529; aborts still cancel instantly.
2728
+ */
2729
+ enabled?: boolean;
2730
+ /**
2731
+ * Hard cap on TOTAL time spent in persistent transport retries for one request. Default 7200000 (2h). The request always fails once this elapses — persistent retry never loops forever.
2732
+ */
2733
+ maxWaitMs?: number;
2734
+ /**
2735
+ * Per-attempt backoff ceiling in persistent mode. Default 60000 (60s). Server-directed Retry-After waits are honored in full (clamped to the remaining maxWaitMs budget).
2736
+ */
2737
+ maxDelayMs?: number;
2738
+ };
1631
2739
  /**
1632
2740
  * Enable OpenTelemetry spans for AI SDK calls (using the 'experimental_telemetry' flag)
1633
2741
  */
1634
2742
  openTelemetry?: boolean;
2743
+ /**
2744
+ * Opt in to the privacy-first audit/telemetry sink. Disabled by default; can be force-disabled via DO_NOT_TRACK or HUNDREDXPROMPT_TELEMETRY_DISABLE.
2745
+ */
2746
+ telemetry?: boolean;
2747
+ /**
2748
+ * Destination URL for telemetry batches. No default — self-hosted / privacy-sensitive by design.
2749
+ */
2750
+ telemetryEndpoint?: string;
2751
+ /**
2752
+ * Optional headers (e.g. auth) sent with every telemetry batch.
2753
+ */
2754
+ telemetryHeaders?: {
2755
+ [key: string]: string;
2756
+ };
2757
+ /**
2758
+ * Telemetry wire format: generic JSON batch ('json') or OTLP-compatible logs ('otlp').
2759
+ */
2760
+ telemetryMode?: "json" | "otlp";
2761
+ /**
2762
+ * Global telemetry sampling rate (0..1, default 1 = keep all). Multiplies each sink's own sampleRate to form its effective keep-probability.
2763
+ */
2764
+ telemetrySampleRate?: number;
2765
+ /**
2766
+ * Multi-sink telemetry routing. When set (non-empty), fully replaces the single telemetryEndpoint field; each sink samples, segments (general/privileged) and retries through its own disk queue independently. Config-driven only — remote/fetched killswitches are out of scope.
2767
+ */
2768
+ telemetrySinks?: Array<{
2769
+ /**
2770
+ * Destination URL for this sink's batches. No default — self-hosted / privacy-sensitive.
2771
+ */
2772
+ endpoint: string;
2773
+ /**
2774
+ * Optional headers (e.g. auth) sent with every batch for this sink.
2775
+ */
2776
+ headers?: {
2777
+ [key: string]: string;
2778
+ };
2779
+ /**
2780
+ * Wire format for this sink: generic JSON batch ('json') or OTLP-compatible logs ('otlp').
2781
+ */
2782
+ mode?: "json" | "otlp";
2783
+ /**
2784
+ * 'general' (default) receives the sanitized payload with PII-tagged _PROTO_* fields stripped; 'privileged' receives the full payload including _PROTO_* — point only at a trusted first-party store.
2785
+ */
2786
+ access?: "general" | "privileged";
2787
+ /**
2788
+ * Per-sink killswitch. Default true; set false to skip this sink entirely (no payload built).
2789
+ */
2790
+ enabled?: boolean;
2791
+ /**
2792
+ * Per-sink sampling rate (0..1, default 1 = keep all).
2793
+ */
2794
+ sampleRate?: number;
2795
+ }>;
1635
2796
  /**
1636
2797
  * Tools that should only be available to primary agents.
1637
2798
  */
@@ -1640,19 +2801,42 @@ export type Config = {
1640
2801
  * Continue the agent loop when a tool call is denied
1641
2802
  */
1642
2803
  continue_loop_on_deny?: boolean;
2804
+ /**
2805
+ * Verification-gated stopping: the agent loop cannot end a turn (stop) until a verifier emits a pass verdict (e.g. `bun run typecheck`). Default false — the loop stops as before.
2806
+ */
2807
+ verificationGate?: boolean;
1643
2808
  /**
1644
2809
  * Timeout in milliseconds for model context protocol (MCP) requests
1645
2810
  */
1646
2811
  mcp_timeout?: number;
1647
2812
  };
1648
2813
  /**
1649
- * Active output style (built-in: explanatory, learning, concise; or a custom output-styles/*.md name)
2814
+ * Environment variables injected into the agent's tool environment (e.g. Bash, hooks). Keys and values are plain strings; tools that spawn subprocesses should merge these into their environment.
1650
2815
  */
1651
- output_style?: string;
2816
+ env?: {
2817
+ [key: string]: string;
2818
+ };
2819
+ /**
2820
+ * Whether to append a Co-Authored-By trailer to git commits. Defaults to true. Set to false to suppress the trailer (e.g. for repositories that enforce clean commit footers).
2821
+ */
2822
+ includeCoAuthoredBy?: boolean;
1652
2823
  /**
1653
2824
  * Shell command to execute for custom footer status text. Receives session context as JSON on stdin and its stdout is rendered as trailing text in the TUI footer.
1654
2825
  */
1655
2826
  statusline?: string;
2827
+ /**
2828
+ * Ergonomics for git worktrees created by the enter_worktree tool
2829
+ */
2830
+ worktree?: {
2831
+ /**
2832
+ * Cone-mode sparse-checkout paths. When non-empty, new worktrees check out only these paths instead of the full tree — cheap to branch from a huge repo. Leave unset for a normal full checkout.
2833
+ */
2834
+ sparsePaths?: Array<string>;
2835
+ /**
2836
+ * Directories (e.g. ['node_modules', '.venv']) to symlink from a new worktree back to the main repo, avoiding a costly reinstall. Skipped when the source is missing or the target already exists.
2837
+ */
2838
+ symlinkDirectories?: Array<string>;
2839
+ };
1656
2840
  };
1657
2841
  export type ToolIds = Array<string>;
1658
2842
  export type ToolListItem = {
@@ -1676,6 +2860,7 @@ export type Worktree = {
1676
2860
  export type WorktreeCreateInput = {
1677
2861
  name?: string;
1678
2862
  startCommand?: string;
2863
+ repo?: string;
1679
2864
  };
1680
2865
  export type VcsInfo = {
1681
2866
  branch: string;
@@ -1720,12 +2905,28 @@ export type SubtaskPartInput = {
1720
2905
  agent: string;
1721
2906
  command?: string;
1722
2907
  };
2908
+ export type RevertFilePreview = {
2909
+ file: string;
2910
+ action: "restore" | "delete" | "none";
2911
+ additions: number;
2912
+ deletions: number;
2913
+ dirty: boolean;
2914
+ };
2915
+ export type RevertPreview = {
2916
+ files: Array<RevertFilePreview>;
2917
+ dirty: boolean;
2918
+ };
1723
2919
  export type Command = {
1724
2920
  name: string;
1725
2921
  description?: string;
1726
2922
  agent?: string;
1727
2923
  model?: string;
1728
2924
  mcp?: boolean;
2925
+ skill?: boolean;
2926
+ plugin?: string;
2927
+ allowedTools?: Array<string>;
2928
+ argumentHint?: string;
2929
+ aliases?: Array<string>;
1729
2930
  template: string;
1730
2931
  subtask?: boolean;
1731
2932
  hints: Array<string>;
@@ -1867,6 +3068,7 @@ export type Agent = {
1867
3068
  mode: "subagent" | "primary" | "all";
1868
3069
  native?: boolean;
1869
3070
  hidden?: boolean;
3071
+ slim?: boolean;
1870
3072
  topP?: number;
1871
3073
  temperature?: number;
1872
3074
  color?: string;
@@ -1881,170 +3083,463 @@ export type Agent = {
1881
3083
  };
1882
3084
  steps?: number;
1883
3085
  };
1884
- export type McpStatusConnected = {
1885
- status: "connected";
3086
+ export type McpResource = {
3087
+ name: string;
3088
+ uri: string;
3089
+ description?: string;
3090
+ mimeType?: string;
3091
+ client: string;
1886
3092
  };
1887
- export type McpStatusDisabled = {
1888
- status: "disabled";
3093
+ export type LspStatus = {
3094
+ id: string;
3095
+ name: string;
3096
+ root: string;
3097
+ status: "connected" | "error";
1889
3098
  };
1890
- export type McpStatusFailed = {
1891
- status: "failed";
1892
- error: string;
3099
+ export type FormatterStatus = {
3100
+ name: string;
3101
+ extensions: Array<string>;
3102
+ enabled: boolean;
3103
+ };
3104
+ export type OAuth = {
3105
+ type: "oauth";
3106
+ refresh: string;
3107
+ access: string;
3108
+ expires: number;
3109
+ accountId?: string;
3110
+ enterpriseUrl?: string;
3111
+ };
3112
+ export type ApiAuth = {
3113
+ type: "api";
3114
+ key: string;
3115
+ };
3116
+ export type WellKnownAuth = {
3117
+ type: "wellknown";
3118
+ key: string;
3119
+ token: string;
3120
+ };
3121
+ export type Auth = OAuth | ApiAuth | WellKnownAuth;
3122
+ export type GlobalHealthData = {
3123
+ body?: never;
3124
+ path?: never;
3125
+ query?: never;
3126
+ url: "/global/health";
3127
+ };
3128
+ export type GlobalHealthResponses = {
3129
+ /**
3130
+ * Health information
3131
+ */
3132
+ 200: {
3133
+ healthy: true;
3134
+ version: string;
3135
+ };
3136
+ };
3137
+ export type GlobalHealthResponse = GlobalHealthResponses[keyof GlobalHealthResponses];
3138
+ export type GlobalEventData = {
3139
+ body?: never;
3140
+ path?: never;
3141
+ query?: never;
3142
+ url: "/global/event";
3143
+ };
3144
+ export type GlobalEventResponses = {
3145
+ /**
3146
+ * Event stream
3147
+ */
3148
+ 200: GlobalEvent;
3149
+ };
3150
+ export type GlobalEventResponse = GlobalEventResponses[keyof GlobalEventResponses];
3151
+ export type GlobalDisposeData = {
3152
+ body?: never;
3153
+ path?: never;
3154
+ query?: never;
3155
+ url: "/global/dispose";
3156
+ };
3157
+ export type GlobalDisposeResponses = {
3158
+ /**
3159
+ * Global disposed
3160
+ */
3161
+ 200: boolean;
3162
+ };
3163
+ export type GlobalDisposeResponse = GlobalDisposeResponses[keyof GlobalDisposeResponses];
3164
+ export type ProjectListData = {
3165
+ body?: never;
3166
+ path?: never;
3167
+ query?: {
3168
+ directory?: string;
3169
+ };
3170
+ url: "/project";
3171
+ };
3172
+ export type ProjectListResponses = {
3173
+ /**
3174
+ * List of projects
3175
+ */
3176
+ 200: Array<Project>;
3177
+ };
3178
+ export type ProjectListResponse = ProjectListResponses[keyof ProjectListResponses];
3179
+ export type ProjectCurrentData = {
3180
+ body?: never;
3181
+ path?: never;
3182
+ query?: {
3183
+ directory?: string;
3184
+ };
3185
+ url: "/project/current";
3186
+ };
3187
+ export type ProjectCurrentResponses = {
3188
+ /**
3189
+ * Current project information
3190
+ */
3191
+ 200: Project;
3192
+ };
3193
+ export type ProjectCurrentResponse = ProjectCurrentResponses[keyof ProjectCurrentResponses];
3194
+ export type ProjectUpdateData = {
3195
+ body?: {
3196
+ name?: string;
3197
+ icon?: {
3198
+ url?: string;
3199
+ color?: string;
3200
+ };
3201
+ };
3202
+ path: {
3203
+ projectID: string;
3204
+ };
3205
+ query?: {
3206
+ directory?: string;
3207
+ };
3208
+ url: "/project/{projectID}";
3209
+ };
3210
+ export type ProjectUpdateErrors = {
3211
+ /**
3212
+ * Bad request
3213
+ */
3214
+ 400: BadRequestError;
3215
+ /**
3216
+ * Not found
3217
+ */
3218
+ 404: NotFoundError;
3219
+ };
3220
+ export type ProjectUpdateError = ProjectUpdateErrors[keyof ProjectUpdateErrors];
3221
+ export type ProjectUpdateResponses = {
3222
+ /**
3223
+ * Updated project information
3224
+ */
3225
+ 200: Project;
3226
+ };
3227
+ export type ProjectUpdateResponse = ProjectUpdateResponses[keyof ProjectUpdateResponses];
3228
+ export type PluginInstalledData = {
3229
+ body?: never;
3230
+ path?: never;
3231
+ query?: {
3232
+ directory?: string;
3233
+ };
3234
+ url: "/plugin/installed";
3235
+ };
3236
+ export type PluginInstalledResponses = {
3237
+ /**
3238
+ * OK
3239
+ */
3240
+ 200: Array<InstalledPlugin>;
3241
+ };
3242
+ export type PluginInstalledResponse = PluginInstalledResponses[keyof PluginInstalledResponses];
3243
+ export type PluginDiscoverData = {
3244
+ body?: never;
3245
+ path?: never;
3246
+ query?: {
3247
+ directory?: string;
3248
+ };
3249
+ url: "/plugin/discover";
3250
+ };
3251
+ export type PluginDiscoverResponses = {
3252
+ /**
3253
+ * OK
3254
+ */
3255
+ 200: Array<DiscoverPlugin>;
3256
+ };
3257
+ export type PluginDiscoverResponse = PluginDiscoverResponses[keyof PluginDiscoverResponses];
3258
+ export type PluginMarketplacesData = {
3259
+ body?: never;
3260
+ path?: never;
3261
+ query?: {
3262
+ directory?: string;
3263
+ };
3264
+ url: "/plugin/marketplaces";
3265
+ };
3266
+ export type PluginMarketplacesResponses = {
3267
+ /**
3268
+ * OK
3269
+ */
3270
+ 200: Array<string>;
3271
+ };
3272
+ export type PluginMarketplacesResponse = PluginMarketplacesResponses[keyof PluginMarketplacesResponses];
3273
+ export type PluginErrorsData = {
3274
+ body?: never;
3275
+ path?: never;
3276
+ query?: {
3277
+ directory?: string;
3278
+ };
3279
+ url: "/plugin/errors";
3280
+ };
3281
+ export type PluginErrorsResponses = {
3282
+ /**
3283
+ * OK
3284
+ */
3285
+ 200: Array<PluginError>;
3286
+ };
3287
+ export type PluginErrorsResponse = PluginErrorsResponses[keyof PluginErrorsResponses];
3288
+ export type PluginReloadData = {
3289
+ body?: never;
3290
+ path?: never;
3291
+ query?: {
3292
+ directory?: string;
3293
+ };
3294
+ url: "/plugin/reload";
3295
+ };
3296
+ export type PluginReloadResponses = {
3297
+ /**
3298
+ * OK
3299
+ */
3300
+ 200: PluginReloadResult;
1893
3301
  };
1894
- export type McpStatusNeedsAuth = {
1895
- status: "needs_auth";
3302
+ export type PluginReloadResponse = PluginReloadResponses[keyof PluginReloadResponses];
3303
+ export type PluginInstallData = {
3304
+ body?: {
3305
+ source: string;
3306
+ };
3307
+ path?: never;
3308
+ query?: {
3309
+ directory?: string;
3310
+ };
3311
+ url: "/plugin/install";
1896
3312
  };
1897
- export type McpStatusNeedsClientRegistration = {
1898
- status: "needs_client_registration";
1899
- error: string;
3313
+ export type PluginInstallErrors = {
3314
+ /**
3315
+ * Bad request
3316
+ */
3317
+ 400: BadRequestError;
1900
3318
  };
1901
- export type McpStatusPending = {
1902
- status: "pending";
1903
- attempt: number;
3319
+ export type PluginInstallError = PluginInstallErrors[keyof PluginInstallErrors];
3320
+ export type PluginInstallResponses = {
3321
+ /**
3322
+ * OK
3323
+ */
3324
+ 200: PluginInstallResult;
1904
3325
  };
1905
- export type McpStatus = McpStatusConnected | McpStatusDisabled | McpStatusFailed | McpStatusNeedsAuth | McpStatusNeedsClientRegistration | McpStatusPending;
1906
- export type McpResource = {
1907
- name: string;
1908
- uri: string;
1909
- description?: string;
1910
- mimeType?: string;
1911
- client: string;
3326
+ export type PluginInstallResponse = PluginInstallResponses[keyof PluginInstallResponses];
3327
+ export type PluginInstallNamedData = {
3328
+ body?: {
3329
+ name: string;
3330
+ };
3331
+ path?: never;
3332
+ query?: {
3333
+ directory?: string;
3334
+ };
3335
+ url: "/plugin/install-named";
1912
3336
  };
1913
- export type LspStatus = {
1914
- id: string;
1915
- name: string;
1916
- root: string;
1917
- status: "connected" | "error";
3337
+ export type PluginInstallNamedErrors = {
3338
+ /**
3339
+ * Bad request
3340
+ */
3341
+ 400: BadRequestError;
1918
3342
  };
1919
- export type FormatterStatus = {
1920
- name: string;
1921
- extensions: Array<string>;
1922
- enabled: boolean;
3343
+ export type PluginInstallNamedError = PluginInstallNamedErrors[keyof PluginInstallNamedErrors];
3344
+ export type PluginInstallNamedResponses = {
3345
+ /**
3346
+ * OK
3347
+ */
3348
+ 200: PluginInstallResult;
1923
3349
  };
1924
- export type OAuth = {
1925
- type: "oauth";
1926
- refresh: string;
1927
- access: string;
1928
- expires: number;
1929
- accountId?: string;
1930
- enterpriseUrl?: string;
3350
+ export type PluginInstallNamedResponse = PluginInstallNamedResponses[keyof PluginInstallNamedResponses];
3351
+ export type PluginSetEnabledData = {
3352
+ body?: {
3353
+ name: string;
3354
+ enabled: boolean;
3355
+ };
3356
+ path?: never;
3357
+ query?: {
3358
+ directory?: string;
3359
+ };
3360
+ url: "/plugin/enable";
1931
3361
  };
1932
- export type ApiAuth = {
1933
- type: "api";
1934
- key: string;
3362
+ export type PluginSetEnabledResponses = {
3363
+ /**
3364
+ * OK
3365
+ */
3366
+ 200: {
3367
+ ok: boolean;
3368
+ };
1935
3369
  };
1936
- export type WellKnownAuth = {
1937
- type: "wellknown";
1938
- key: string;
1939
- token: string;
3370
+ export type PluginSetEnabledResponse = PluginSetEnabledResponses[keyof PluginSetEnabledResponses];
3371
+ export type PluginRemoveData = {
3372
+ body?: {
3373
+ name: string;
3374
+ };
3375
+ path?: never;
3376
+ query?: {
3377
+ directory?: string;
3378
+ };
3379
+ url: "/plugin/remove";
1940
3380
  };
1941
- export type Auth = OAuth | ApiAuth | WellKnownAuth;
1942
- export type GlobalHealthData = {
1943
- body?: never;
3381
+ export type PluginRemoveResponses = {
3382
+ /**
3383
+ * OK
3384
+ */
3385
+ 200: {
3386
+ ok: boolean;
3387
+ };
3388
+ };
3389
+ export type PluginRemoveResponse = PluginRemoveResponses[keyof PluginRemoveResponses];
3390
+ export type PluginMarketplaceAddData = {
3391
+ body?: {
3392
+ source: string;
3393
+ };
1944
3394
  path?: never;
1945
- query?: never;
1946
- url: "/global/health";
3395
+ query?: {
3396
+ directory?: string;
3397
+ };
3398
+ url: "/plugin/marketplace/add";
1947
3399
  };
1948
- export type GlobalHealthResponses = {
3400
+ export type PluginMarketplaceAddResponses = {
1949
3401
  /**
1950
- * Health information
3402
+ * OK
1951
3403
  */
1952
3404
  200: {
1953
- healthy: true;
1954
- version: string;
3405
+ ok: boolean;
1955
3406
  };
1956
3407
  };
1957
- export type GlobalHealthResponse = GlobalHealthResponses[keyof GlobalHealthResponses];
1958
- export type GlobalEventData = {
1959
- body?: never;
3408
+ export type PluginMarketplaceAddResponse = PluginMarketplaceAddResponses[keyof PluginMarketplaceAddResponses];
3409
+ export type PluginMarketplaceRemoveData = {
3410
+ body?: {
3411
+ source: string;
3412
+ };
1960
3413
  path?: never;
1961
- query?: never;
1962
- url: "/global/event";
3414
+ query?: {
3415
+ directory?: string;
3416
+ };
3417
+ url: "/plugin/marketplace/remove";
1963
3418
  };
1964
- export type GlobalEventResponses = {
3419
+ export type PluginMarketplaceRemoveResponses = {
1965
3420
  /**
1966
- * Event stream
3421
+ * OK
1967
3422
  */
1968
- 200: GlobalEvent;
3423
+ 200: {
3424
+ ok: boolean;
3425
+ };
1969
3426
  };
1970
- export type GlobalEventResponse = GlobalEventResponses[keyof GlobalEventResponses];
1971
- export type GlobalDisposeData = {
3427
+ export type PluginMarketplaceRemoveResponse = PluginMarketplaceRemoveResponses[keyof PluginMarketplaceRemoveResponses];
3428
+ export type TrustStatusData = {
1972
3429
  body?: never;
1973
3430
  path?: never;
1974
- query?: never;
1975
- url: "/global/dispose";
3431
+ query?: {
3432
+ directory?: string;
3433
+ };
3434
+ url: "/trust";
1976
3435
  };
1977
- export type GlobalDisposeResponses = {
3436
+ export type TrustStatusResponses = {
1978
3437
  /**
1979
- * Global disposed
3438
+ * OK
1980
3439
  */
1981
- 200: boolean;
3440
+ 200: TrustStatus;
1982
3441
  };
1983
- export type GlobalDisposeResponse = GlobalDisposeResponses[keyof GlobalDisposeResponses];
1984
- export type ProjectListData = {
3442
+ export type TrustStatusResponse = TrustStatusResponses[keyof TrustStatusResponses];
3443
+ export type TrustOnceData = {
1985
3444
  body?: never;
1986
3445
  path?: never;
1987
3446
  query?: {
1988
3447
  directory?: string;
1989
3448
  };
1990
- url: "/project";
3449
+ url: "/trust/once";
1991
3450
  };
1992
- export type ProjectListResponses = {
3451
+ export type TrustOnceResponses = {
1993
3452
  /**
1994
- * List of projects
3453
+ * OK
1995
3454
  */
1996
- 200: Array<Project>;
3455
+ 200: TrustStatus;
1997
3456
  };
1998
- export type ProjectListResponse = ProjectListResponses[keyof ProjectListResponses];
1999
- export type ProjectCurrentData = {
3457
+ export type TrustOnceResponse = TrustOnceResponses[keyof TrustOnceResponses];
3458
+ export type TrustAlwaysData = {
2000
3459
  body?: never;
2001
3460
  path?: never;
2002
3461
  query?: {
2003
3462
  directory?: string;
2004
3463
  };
2005
- url: "/project/current";
3464
+ url: "/trust/always";
2006
3465
  };
2007
- export type ProjectCurrentResponses = {
3466
+ export type TrustAlwaysResponses = {
2008
3467
  /**
2009
- * Current project information
3468
+ * OK
2010
3469
  */
2011
- 200: Project;
3470
+ 200: TrustStatus;
2012
3471
  };
2013
- export type ProjectCurrentResponse = ProjectCurrentResponses[keyof ProjectCurrentResponses];
2014
- export type ProjectUpdateData = {
3472
+ export type TrustAlwaysResponse = TrustAlwaysResponses[keyof TrustAlwaysResponses];
3473
+ export type RemoteBridgeEnrollData = {
2015
3474
  body?: {
2016
- name?: string;
2017
- icon?: {
2018
- url?: string;
2019
- color?: string;
3475
+ device?: {
3476
+ id?: string;
3477
+ name?: string;
2020
3478
  };
3479
+ sessionID?: string;
2021
3480
  };
2022
- path: {
2023
- projectID: string;
3481
+ path?: never;
3482
+ query?: {
3483
+ directory?: string;
2024
3484
  };
3485
+ url: "/remote-bridge/enroll";
3486
+ };
3487
+ export type RemoteBridgeEnrollResponses = {
3488
+ /**
3489
+ * OK
3490
+ */
3491
+ 200: RemoteBridgeEnrollment;
3492
+ };
3493
+ export type RemoteBridgeEnrollResponse = RemoteBridgeEnrollResponses[keyof RemoteBridgeEnrollResponses];
3494
+ export type RemoteBridgeDevicesData = {
3495
+ body?: never;
3496
+ path?: never;
2025
3497
  query?: {
2026
3498
  directory?: string;
2027
3499
  };
2028
- url: "/project/{projectID}";
3500
+ url: "/remote-bridge/devices";
2029
3501
  };
2030
- export type ProjectUpdateErrors = {
3502
+ export type RemoteBridgeDevicesResponses = {
2031
3503
  /**
2032
- * Bad request
3504
+ * OK
2033
3505
  */
2034
- 400: BadRequestError;
3506
+ 200: Array<RemoteBridgeDevice>;
3507
+ };
3508
+ export type RemoteBridgeDevicesResponse = RemoteBridgeDevicesResponses[keyof RemoteBridgeDevicesResponses];
3509
+ export type RemoteBridgeRevokeData = {
3510
+ body?: never;
3511
+ path: {
3512
+ deviceID: string;
3513
+ };
3514
+ query?: {
3515
+ directory?: string;
3516
+ };
3517
+ url: "/remote-bridge/devices/{deviceID}/revoke";
3518
+ };
3519
+ export type RemoteBridgeRevokeResponses = {
2035
3520
  /**
2036
- * Not found
3521
+ * OK
2037
3522
  */
2038
- 404: NotFoundError;
3523
+ 200: {
3524
+ revoked: boolean;
3525
+ };
2039
3526
  };
2040
- export type ProjectUpdateError = ProjectUpdateErrors[keyof ProjectUpdateErrors];
2041
- export type ProjectUpdateResponses = {
3527
+ export type RemoteBridgeRevokeResponse = RemoteBridgeRevokeResponses[keyof RemoteBridgeRevokeResponses];
3528
+ export type RemoteBridgeConnectData = {
3529
+ body?: never;
3530
+ path?: never;
3531
+ query?: {
3532
+ directory?: string;
3533
+ };
3534
+ url: "/remote-bridge/ws";
3535
+ };
3536
+ export type RemoteBridgeConnectResponses = {
2042
3537
  /**
2043
- * Updated project information
3538
+ * OK
2044
3539
  */
2045
- 200: Project;
3540
+ 200: boolean;
2046
3541
  };
2047
- export type ProjectUpdateResponse = ProjectUpdateResponses[keyof ProjectUpdateResponses];
3542
+ export type RemoteBridgeConnectResponse = RemoteBridgeConnectResponses[keyof RemoteBridgeConnectResponses];
2048
3543
  export type PtyListData = {
2049
3544
  body?: never;
2050
3545
  path?: never;
@@ -2374,6 +3869,14 @@ export type SessionListData = {
2374
3869
  * Maximum number of sessions to return
2375
3870
  */
2376
3871
  limit?: number;
3872
+ /**
3873
+ * Include archived sessions in results (default false)
3874
+ */
3875
+ include_archived?: boolean;
3876
+ /**
3877
+ * Also search session message content when a search term is provided (default false)
3878
+ */
3879
+ search_content?: boolean;
2377
3880
  };
2378
3881
  url: "/session";
2379
3882
  };
@@ -2386,6 +3889,7 @@ export type SessionListResponses = {
2386
3889
  export type SessionListResponse = SessionListResponses[keyof SessionListResponses];
2387
3890
  export type SessionCreateData = {
2388
3891
  body?: {
3892
+ id?: string;
2389
3893
  parentID?: string;
2390
3894
  title?: string;
2391
3895
  permission?: PermissionRuleset;
@@ -2724,9 +4228,6 @@ export type SessionShareResponse = SessionShareResponses[keyof SessionShareRespo
2724
4228
  export type SessionDiffData = {
2725
4229
  body?: never;
2726
4230
  path: {
2727
- /**
2728
- * Session ID
2729
- */
2730
4231
  sessionID: string;
2731
4232
  };
2732
4233
  query?: {
@@ -2758,6 +4259,10 @@ export type SessionSummarizeData = {
2758
4259
  providerID: string;
2759
4260
  modelID: string;
2760
4261
  auto?: boolean;
4262
+ /**
4263
+ * Focus instructions for the summarizer (from `/compact <text>`)
4264
+ */
4265
+ customInstructions?: string;
2761
4266
  };
2762
4267
  path: {
2763
4268
  /**
@@ -2839,7 +4344,19 @@ export type SessionPromptData = {
2839
4344
  [key: string]: boolean;
2840
4345
  };
2841
4346
  system?: string;
4347
+ /**
4348
+ * Replace the session's assembled system prompt for this turn (CC --system-prompt). Wins over `system`.
4349
+ */
4350
+ systemOverride?: string;
2842
4351
  variant?: string;
4352
+ /**
4353
+ * Run this session in kairos (background tick) mode: registers the sleep tool and the kairos prompt discipline. Sticky until explicitly set to false
4354
+ */
4355
+ kairos?: boolean;
4356
+ /**
4357
+ * Whether the user's terminal is currently focused; drives kairos focus-aware autonomy
4358
+ */
4359
+ terminalFocus?: boolean;
2843
4360
  parts: Array<TextPartInput | FilePartInput | AgentPartInput | SubtaskPartInput>;
2844
4361
  };
2845
4362
  path: {
@@ -3006,7 +4523,19 @@ export type SessionPromptAsyncData = {
3006
4523
  [key: string]: boolean;
3007
4524
  };
3008
4525
  system?: string;
4526
+ /**
4527
+ * Replace the session's assembled system prompt for this turn (CC --system-prompt). Wins over `system`.
4528
+ */
4529
+ systemOverride?: string;
3009
4530
  variant?: string;
4531
+ /**
4532
+ * Run this session in kairos (background tick) mode: registers the sleep tool and the kairos prompt discipline. Sticky until explicitly set to false
4533
+ */
4534
+ kairos?: boolean;
4535
+ /**
4536
+ * Whether the user's terminal is currently focused; drives kairos focus-aware autonomy
4537
+ */
4538
+ terminalFocus?: boolean;
3010
4539
  parts: Array<TextPartInput | FilePartInput | AgentPartInput | SubtaskPartInput>;
3011
4540
  };
3012
4541
  path: {
@@ -3129,6 +4658,7 @@ export type SessionRevertData = {
3129
4658
  body?: {
3130
4659
  messageID: string;
3131
4660
  partID?: string;
4661
+ mode?: "both" | "conversation" | "files";
3132
4662
  };
3133
4663
  path: {
3134
4664
  sessionID: string;
@@ -3156,6 +4686,38 @@ export type SessionRevertResponses = {
3156
4686
  200: Session;
3157
4687
  };
3158
4688
  export type SessionRevertResponse = SessionRevertResponses[keyof SessionRevertResponses];
4689
+ export type SessionRevertPreviewData = {
4690
+ body?: {
4691
+ messageID: string;
4692
+ partID?: string;
4693
+ mode?: "both" | "conversation" | "files";
4694
+ };
4695
+ path: {
4696
+ sessionID: string;
4697
+ };
4698
+ query?: {
4699
+ directory?: string;
4700
+ };
4701
+ url: "/session/{sessionID}/revert/preview";
4702
+ };
4703
+ export type SessionRevertPreviewErrors = {
4704
+ /**
4705
+ * Bad request
4706
+ */
4707
+ 400: BadRequestError;
4708
+ /**
4709
+ * Not found
4710
+ */
4711
+ 404: NotFoundError;
4712
+ };
4713
+ export type SessionRevertPreviewError = SessionRevertPreviewErrors[keyof SessionRevertPreviewErrors];
4714
+ export type SessionRevertPreviewResponses = {
4715
+ /**
4716
+ * Revert preview
4717
+ */
4718
+ 200: RevertPreview;
4719
+ };
4720
+ export type SessionRevertPreviewResponse = SessionRevertPreviewResponses[keyof SessionRevertPreviewResponses];
3159
4721
  export type SessionUnrevertData = {
3160
4722
  body?: never;
3161
4723
  path: {
@@ -3184,6 +4746,39 @@ export type SessionUnrevertResponses = {
3184
4746
  200: Session;
3185
4747
  };
3186
4748
  export type SessionUnrevertResponse = SessionUnrevertResponses[keyof SessionUnrevertResponses];
4749
+ export type SessionFeedbackData = {
4750
+ body?: {
4751
+ explicit: "up" | "down";
4752
+ };
4753
+ path: {
4754
+ sessionID: string;
4755
+ };
4756
+ query?: {
4757
+ directory?: string;
4758
+ };
4759
+ url: "/session/{sessionID}/feedback";
4760
+ };
4761
+ export type SessionFeedbackErrors = {
4762
+ /**
4763
+ * Bad request
4764
+ */
4765
+ 400: BadRequestError;
4766
+ /**
4767
+ * Not found
4768
+ */
4769
+ 404: NotFoundError;
4770
+ };
4771
+ export type SessionFeedbackError = SessionFeedbackErrors[keyof SessionFeedbackErrors];
4772
+ export type SessionFeedbackResponses = {
4773
+ /**
4774
+ * Feedback accepted
4775
+ */
4776
+ 200: {
4777
+ ok: boolean;
4778
+ matched: boolean;
4779
+ };
4780
+ };
4781
+ export type SessionFeedbackResponse = SessionFeedbackResponses[keyof SessionFeedbackResponses];
3187
4782
  export type PermissionRespondData = {
3188
4783
  body?: {
3189
4784
  response: "once" | "always" | "reject";
@@ -3879,6 +5474,13 @@ export type McpConnectData = {
3879
5474
  };
3880
5475
  url: "/mcp/{name}/connect";
3881
5476
  };
5477
+ export type McpConnectErrors = {
5478
+ /**
5479
+ * Not found
5480
+ */
5481
+ 404: NotFoundError;
5482
+ };
5483
+ export type McpConnectError = McpConnectErrors[keyof McpConnectErrors];
3882
5484
  export type McpConnectResponses = {
3883
5485
  /**
3884
5486
  * MCP server connected successfully