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

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 (75) 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 +1964 -391
  8. package/openapi.json +14260 -0
  9. package/package.json +41 -24
  10. package/dist/v2/client.d.ts +0 -7
  11. package/dist/v2/client.js +0 -73
  12. package/dist/v2/gen/client/client.gen.d.ts +0 -2
  13. package/dist/v2/gen/client/client.gen.js +0 -225
  14. package/dist/v2/gen/client/index.d.ts +0 -8
  15. package/dist/v2/gen/client/index.js +0 -6
  16. package/dist/v2/gen/client/types.gen.d.ts +0 -117
  17. package/dist/v2/gen/client/types.gen.js +0 -2
  18. package/dist/v2/gen/client/utils.gen.d.ts +0 -33
  19. package/dist/v2/gen/client/utils.gen.js +0 -226
  20. package/dist/v2/gen/client.gen.d.ts +0 -12
  21. package/dist/v2/gen/client.gen.js +0 -3
  22. package/dist/v2/gen/core/auth.gen.d.ts +0 -18
  23. package/dist/v2/gen/core/auth.gen.js +0 -14
  24. package/dist/v2/gen/core/bodySerializer.gen.d.ts +0 -25
  25. package/dist/v2/gen/core/bodySerializer.gen.js +0 -57
  26. package/dist/v2/gen/core/params.gen.d.ts +0 -43
  27. package/dist/v2/gen/core/params.gen.js +0 -102
  28. package/dist/v2/gen/core/pathSerializer.gen.d.ts +0 -33
  29. package/dist/v2/gen/core/pathSerializer.gen.js +0 -106
  30. package/dist/v2/gen/core/queryKeySerializer.gen.d.ts +0 -18
  31. package/dist/v2/gen/core/queryKeySerializer.gen.js +0 -93
  32. package/dist/v2/gen/core/serverSentEvents.gen.d.ts +0 -71
  33. package/dist/v2/gen/core/serverSentEvents.gen.js +0 -131
  34. package/dist/v2/gen/core/types.gen.d.ts +0 -78
  35. package/dist/v2/gen/core/types.gen.js +0 -2
  36. package/dist/v2/gen/core/utils.gen.d.ts +0 -19
  37. package/dist/v2/gen/core/utils.gen.js +0 -87
  38. package/dist/v2/gen/gen/client/client.gen.d.ts +0 -2
  39. package/dist/v2/gen/gen/client/client.gen.js +0 -225
  40. package/dist/v2/gen/gen/client/index.d.ts +0 -8
  41. package/dist/v2/gen/gen/client/index.js +0 -6
  42. package/dist/v2/gen/gen/client/types.gen.d.ts +0 -117
  43. package/dist/v2/gen/gen/client/types.gen.js +0 -2
  44. package/dist/v2/gen/gen/client/utils.gen.d.ts +0 -33
  45. package/dist/v2/gen/gen/client/utils.gen.js +0 -226
  46. package/dist/v2/gen/gen/client.gen.d.ts +0 -12
  47. package/dist/v2/gen/gen/client.gen.js +0 -3
  48. package/dist/v2/gen/gen/core/auth.gen.d.ts +0 -18
  49. package/dist/v2/gen/gen/core/auth.gen.js +0 -14
  50. package/dist/v2/gen/gen/core/bodySerializer.gen.d.ts +0 -25
  51. package/dist/v2/gen/gen/core/bodySerializer.gen.js +0 -57
  52. package/dist/v2/gen/gen/core/params.gen.d.ts +0 -43
  53. package/dist/v2/gen/gen/core/params.gen.js +0 -102
  54. package/dist/v2/gen/gen/core/pathSerializer.gen.d.ts +0 -33
  55. package/dist/v2/gen/gen/core/pathSerializer.gen.js +0 -106
  56. package/dist/v2/gen/gen/core/queryKeySerializer.gen.d.ts +0 -18
  57. package/dist/v2/gen/gen/core/queryKeySerializer.gen.js +0 -93
  58. package/dist/v2/gen/gen/core/serverSentEvents.gen.d.ts +0 -71
  59. package/dist/v2/gen/gen/core/serverSentEvents.gen.js +0 -131
  60. package/dist/v2/gen/gen/core/types.gen.d.ts +0 -78
  61. package/dist/v2/gen/gen/core/types.gen.js +0 -2
  62. package/dist/v2/gen/gen/core/utils.gen.d.ts +0 -19
  63. package/dist/v2/gen/gen/core/utils.gen.js +0 -87
  64. package/dist/v2/gen/gen/sdk.gen.d.ts +0 -1013
  65. package/dist/v2/gen/gen/sdk.gen.js +0 -1931
  66. package/dist/v2/gen/gen/types.gen.d.ts +0 -4246
  67. package/dist/v2/gen/gen/types.gen.js +0 -2
  68. package/dist/v2/gen/sdk.gen.d.ts +0 -1014
  69. package/dist/v2/gen/sdk.gen.js +0 -1932
  70. package/dist/v2/gen/types.gen.d.ts +0 -4238
  71. package/dist/v2/gen/types.gen.js +0 -2
  72. package/dist/v2/index.d.ts +0 -10
  73. package/dist/v2/index.js +0 -16
  74. package/dist/v2/server.d.ts +0 -23
  75. 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,353 @@ 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";
154
+ properties: {
155
+ sessionID: string;
156
+ status: SessionStatus;
157
+ };
158
+ };
159
+ export type EventSessionIdle = {
160
+ type: "session.idle";
161
+ properties: {
162
+ sessionID: string;
163
+ };
164
+ };
165
+ /**
166
+ * 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.
167
+ *
168
+ * @deprecated
169
+ */
170
+ export type EventMemoryExtractionCompleted = {
171
+ type: "memory.extraction.completed";
172
+ properties: {
173
+ sessionID: string;
174
+ facts: number;
175
+ topics: number;
176
+ skipped: boolean;
177
+ ms: number;
178
+ };
179
+ };
180
+ /**
181
+ * 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.
182
+ *
183
+ * @deprecated
184
+ */
185
+ export type EventMemoryConsolidationCompleted = {
186
+ type: "memory.consolidation.completed";
187
+ properties: {
188
+ factsBefore: number;
189
+ factsAfter: number;
190
+ topicsDeleted: number;
191
+ topicsWritten: number;
192
+ ms: number;
193
+ };
194
+ };
195
+ /**
196
+ * 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.
197
+ *
198
+ * @deprecated
199
+ */
200
+ export type EventMemoryRecallCompleted = {
201
+ type: "memory.recall.completed";
202
+ properties: {
203
+ sessionID: string;
204
+ candidates: number;
205
+ selected: number;
206
+ dedupeExcluded: number;
207
+ ms: number;
208
+ };
209
+ };
210
+ export type PermissionRequest = {
211
+ id: string;
212
+ sessionID: string;
213
+ permission: string;
214
+ patterns: Array<string>;
215
+ metadata: {
216
+ [key: string]: unknown;
217
+ };
218
+ always: Array<string>;
219
+ tool?: {
220
+ messageID: string;
221
+ callID: string;
222
+ };
223
+ };
224
+ export type EventPermissionAsked = {
225
+ type: "permission.asked";
226
+ properties: PermissionRequest;
227
+ };
228
+ export type EventPermissionReplied = {
229
+ type: "permission.replied";
230
+ properties: {
231
+ sessionID: string;
232
+ requestID: string;
233
+ reply: "once" | "always" | "reject";
234
+ };
235
+ };
236
+ /**
237
+ * 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.
238
+ *
239
+ * @deprecated
240
+ */
241
+ export type EventMcpToolsChanged = {
242
+ type: "mcp.tools.changed";
243
+ properties: {
244
+ server: string;
245
+ };
246
+ };
247
+ export type McpStatusConnected = {
248
+ status: "connected";
249
+ };
250
+ export type McpStatusDisabled = {
251
+ status: "disabled";
252
+ };
253
+ export type McpStatusFailed = {
254
+ status: "failed";
255
+ error: string;
256
+ };
257
+ export type McpStatusNeedsAuth = {
258
+ status: "needs_auth";
259
+ };
260
+ export type McpStatusNeedsApproval = {
261
+ status: "needs_approval";
262
+ };
263
+ export type McpStatusNeedsClientRegistration = {
264
+ status: "needs_client_registration";
265
+ error: string;
266
+ };
267
+ export type McpStatusPending = {
268
+ status: "pending";
269
+ attempt: number;
270
+ };
271
+ export type McpStatus = McpStatusConnected | McpStatusDisabled | McpStatusFailed | McpStatusNeedsAuth | McpStatusNeedsApproval | McpStatusNeedsClientRegistration | McpStatusPending;
272
+ export type EventMcpStatusChanged = {
273
+ type: "mcp.status.changed";
274
+ properties: {
275
+ status: {
276
+ [key: string]: McpStatus;
277
+ };
278
+ };
279
+ };
280
+ /**
281
+ * 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.
282
+ *
283
+ * @deprecated
284
+ */
285
+ export type EventScheduleCreated = {
286
+ type: "schedule.created";
287
+ properties: {
288
+ info: {
289
+ id: string;
290
+ title: string;
291
+ prompt: string;
292
+ /**
293
+ * project directory this task runs in
294
+ */
295
+ directory: string;
296
+ agent?: string;
297
+ spec: {
298
+ type: "once";
299
+ /**
300
+ * epoch ms to run once
301
+ */
302
+ at: number;
303
+ } | {
304
+ type: "every";
305
+ /**
306
+ * interval in ms
307
+ */
308
+ ms: number;
309
+ } | {
310
+ type: "cron";
311
+ /**
312
+ * 5-field cron expression
313
+ */
314
+ expr: string;
315
+ };
316
+ enabled: boolean;
317
+ createdAt: number;
318
+ lastRun?: number;
319
+ nextRun: number | null;
320
+ runCount: number;
321
+ lastError?: string;
322
+ };
323
+ };
324
+ };
325
+ /**
326
+ * 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.
327
+ *
328
+ * @deprecated
329
+ */
330
+ export type EventScheduleUpdated = {
331
+ type: "schedule.updated";
332
+ properties: {
333
+ info: {
334
+ id: string;
335
+ title: string;
336
+ prompt: string;
337
+ /**
338
+ * project directory this task runs in
339
+ */
340
+ directory: string;
341
+ agent?: string;
342
+ spec: {
343
+ type: "once";
344
+ /**
345
+ * epoch ms to run once
346
+ */
347
+ at: number;
348
+ } | {
349
+ type: "every";
350
+ /**
351
+ * interval in ms
352
+ */
353
+ ms: number;
354
+ } | {
355
+ type: "cron";
356
+ /**
357
+ * 5-field cron expression
358
+ */
359
+ expr: string;
360
+ };
361
+ enabled: boolean;
362
+ createdAt: number;
363
+ lastRun?: number;
364
+ nextRun: number | null;
365
+ runCount: number;
366
+ lastError?: string;
367
+ };
368
+ };
369
+ };
370
+ /**
371
+ * 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.
372
+ *
373
+ * @deprecated
374
+ */
375
+ export type EventScheduleRemoved = {
376
+ type: "schedule.removed";
377
+ properties: {
378
+ id: string;
379
+ };
380
+ };
381
+ /**
382
+ * 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.
383
+ *
384
+ * @deprecated
385
+ */
386
+ export type EventScheduleFired = {
387
+ type: "schedule.fired";
38
388
  properties: {
39
- directory: string;
389
+ id: string;
390
+ sessionID: string;
40
391
  };
41
392
  };
42
393
  export type EventLspClientDiagnostics = {
@@ -77,6 +428,7 @@ export type UserMessage = {
77
428
  modelID: string;
78
429
  };
79
430
  system?: string;
431
+ systemOverride?: string;
80
432
  tools?: {
81
433
  [key: string]: boolean;
82
434
  };
@@ -98,7 +450,7 @@ export type UnknownError = {
98
450
  export type MessageOutputLengthError = {
99
451
  name: "MessageOutputLengthError";
100
452
  data: {
101
- [key: string]: unknown;
453
+ message?: string;
102
454
  };
103
455
  };
104
456
  export type MessageAbortedError = {
@@ -276,6 +628,7 @@ export type ToolStateCompleted = {
276
628
  start: number;
277
629
  end: number;
278
630
  compacted?: number;
631
+ inputCompacted?: number;
279
632
  };
280
633
  attachments?: Array<FilePart>;
281
634
  };
@@ -377,6 +730,23 @@ export type CompactionPart = {
377
730
  auto: boolean;
378
731
  customInstructions?: string;
379
732
  };
733
+ export type TombstoneReason = "compacted" | "superseded" | "expired" | "budget" | "orphaned" | "reverted" | "cleared";
734
+ export type TombstonePart = {
735
+ id: string;
736
+ sessionID: string;
737
+ messageID: string;
738
+ type: "tombstone";
739
+ original: string;
740
+ kind: string;
741
+ tool?: string;
742
+ bytes: number;
743
+ reason: TombstoneReason;
744
+ retrieval?: string;
745
+ text: string;
746
+ time: {
747
+ created: number;
748
+ };
749
+ };
380
750
  export type Part = TextPart | {
381
751
  id: string;
382
752
  sessionID: string;
@@ -386,7 +756,7 @@ export type Part = TextPart | {
386
756
  description: string;
387
757
  agent: string;
388
758
  command?: string;
389
- } | ReasoningPart | FilePart | ToolPart | StepStartPart | StepFinishPart | SnapshotPart | PatchPart | AgentPart | RetryPart | CompactionPart;
759
+ } | ReasoningPart | FilePart | ToolPart | StepStartPart | StepFinishPart | SnapshotPart | PatchPart | AgentPart | RetryPart | CompactionPart | TombstonePart;
390
760
  export type EventMessagePartUpdated = {
391
761
  type: "message.part.updated";
392
762
  properties: {
@@ -402,98 +772,15 @@ export type EventMessagePartRemoved = {
402
772
  partID: string;
403
773
  };
404
774
  };
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
- };
428
- export type EventMemoryExtractionCompleted = {
429
- type: "memory.extraction.completed";
430
- properties: {
431
- sessionID: string;
432
- facts: number;
433
- topics: number;
434
- skipped: boolean;
435
- ms: number;
436
- };
437
- };
438
- export type EventMemoryConsolidationCompleted = {
439
- type: "memory.consolidation.completed";
440
- properties: {
441
- factsBefore: number;
442
- factsAfter: number;
443
- topicsDeleted: number;
444
- topicsWritten: number;
445
- ms: number;
446
- };
447
- };
448
- export type EventMemoryRecallCompleted = {
449
- type: "memory.recall.completed";
450
- properties: {
451
- sessionID: string;
452
- candidates: number;
453
- selected: number;
454
- dedupeExcluded: number;
455
- ms: number;
456
- };
457
- };
458
- export type EventSessionToolSummary = {
459
- type: "session.tool_summary";
460
- properties: {
461
- sessionID: string;
462
- summary: string;
463
- messageID?: string;
464
- };
465
- };
466
- export type PermissionRequest = {
467
- id: string;
468
- sessionID: string;
469
- permission: string;
470
- patterns: Array<string>;
471
- metadata: {
472
- [key: string]: unknown;
473
- };
474
- always: Array<string>;
475
- tool?: {
476
- messageID: string;
477
- callID: string;
478
- };
479
- };
480
- export type EventPermissionAsked = {
481
- type: "permission.asked";
482
- properties: PermissionRequest;
483
- };
484
- export type EventPermissionReplied = {
485
- type: "permission.replied";
486
- properties: {
487
- sessionID: string;
488
- requestID: string;
489
- reply: "once" | "always" | "reject";
490
- };
491
- };
492
775
  export type Todo = {
493
776
  /**
494
777
  * Brief description of the task
495
778
  */
496
779
  content: string;
780
+ /**
781
+ * 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.
782
+ */
783
+ activeForm?: string;
497
784
  /**
498
785
  * Current status of the task: pending, in_progress, completed, cancelled
499
786
  */
@@ -506,6 +793,14 @@ export type Todo = {
506
793
  * Unique identifier for the todo item
507
794
  */
508
795
  id: string;
796
+ /**
797
+ * ids of tasks this task blocks (they wait on this one)
798
+ */
799
+ blocks?: Array<string>;
800
+ /**
801
+ * ids of tasks that must complete before this one can start
802
+ */
803
+ blocked_by?: Array<string>;
509
804
  };
510
805
  export type EventTodoUpdated = {
511
806
  type: "todo.updated";
@@ -518,7 +813,7 @@ export type EventSessionCompacted = {
518
813
  type: "session.compacted";
519
814
  properties: {
520
815
  sessionID: string;
521
- layer?: string;
816
+ layer: string;
522
817
  tokensBefore?: number;
523
818
  tokensAfter?: number;
524
819
  tokensFreed?: number;
@@ -528,118 +823,357 @@ export type EventSessionCompacted = {
528
823
  summarizerCost?: number;
529
824
  };
530
825
  };
531
- export type QuestionOption = {
826
+ export type EventSessionCompactionFailed = {
827
+ type: "session.compaction.failed";
828
+ properties: {
829
+ sessionID: string;
830
+ layer: string;
831
+ error: string;
832
+ consecutiveFailures: number;
833
+ };
834
+ };
835
+ export type EventCommandExecuted = {
836
+ type: "command.executed";
837
+ properties: {
838
+ name: string;
839
+ sessionID: string;
840
+ arguments: string;
841
+ messageID: string;
842
+ };
843
+ };
844
+ /**
845
+ * 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.
846
+ *
847
+ * @deprecated
848
+ */
849
+ export type EventAgentThreadCreated = {
850
+ type: "agent.thread.created";
851
+ properties: {
852
+ id: string;
853
+ parentID?: string;
854
+ nickname: string;
855
+ role?: string;
856
+ status: "pending" | "running" | "completed" | "error" | "interrupted" | "shutdown";
857
+ depth: number;
858
+ created: number;
859
+ completed?: number;
860
+ error?: string;
861
+ };
862
+ };
863
+ export type EventAgentThreadCompleted = {
864
+ type: "agent.thread.completed";
865
+ properties: {
866
+ id: string;
867
+ parentID?: string;
868
+ nickname: string;
869
+ role?: string;
870
+ status: "pending" | "running" | "completed" | "error" | "interrupted" | "shutdown";
871
+ depth: number;
872
+ created: number;
873
+ completed?: number;
874
+ error?: string;
875
+ };
876
+ };
877
+ /**
878
+ * 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.
879
+ *
880
+ * @deprecated
881
+ */
882
+ export type EventAgentThreadInterrupted = {
883
+ type: "agent.thread.interrupted";
884
+ properties: {
885
+ id: string;
886
+ parentID?: string;
887
+ nickname: string;
888
+ role?: string;
889
+ status: "pending" | "running" | "completed" | "error" | "interrupted" | "shutdown";
890
+ depth: number;
891
+ created: number;
892
+ completed?: number;
893
+ error?: string;
894
+ };
895
+ };
896
+ export type EventAgentThreadError = {
897
+ type: "agent.thread.error";
898
+ properties: {
899
+ id: string;
900
+ parentID?: string;
901
+ nickname: string;
902
+ role?: string;
903
+ status: "pending" | "running" | "completed" | "error" | "interrupted" | "shutdown";
904
+ depth: number;
905
+ created: number;
906
+ completed?: number;
907
+ error?: string;
908
+ };
909
+ };
910
+ /**
911
+ * 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.
912
+ *
913
+ * @deprecated
914
+ */
915
+ export type EventAgentLimitReached = {
916
+ type: "agent.limit.reached";
917
+ properties: {
918
+ maxThreads: number;
919
+ activeThreads: number;
920
+ };
921
+ };
922
+ export type EventTaskCreated = {
923
+ type: "task.created";
924
+ properties: {
925
+ id: string;
926
+ sessionID: string;
927
+ messageID: string;
928
+ partID: string;
929
+ command: string;
930
+ status: "running" | "completed" | "failed" | "aborted";
931
+ pid?: number;
932
+ exitCode?: number;
933
+ outputFilePath?: string;
934
+ startTime: number;
935
+ endTime?: number;
936
+ isBackground?: boolean;
937
+ error?: string;
938
+ };
939
+ };
940
+ export type EventTaskUpdated = {
941
+ type: "task.updated";
942
+ properties: {
943
+ id: string;
944
+ sessionID: string;
945
+ messageID: string;
946
+ partID: string;
947
+ command: string;
948
+ status: "running" | "completed" | "failed" | "aborted";
949
+ pid?: number;
950
+ exitCode?: number;
951
+ outputFilePath?: string;
952
+ startTime: number;
953
+ endTime?: number;
954
+ isBackground?: boolean;
955
+ error?: string;
956
+ };
957
+ };
958
+ export type EventTaskRemoved = {
959
+ type: "task.removed";
960
+ properties: {
961
+ id: string;
962
+ };
963
+ };
964
+ /**
965
+ * 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.
966
+ *
967
+ * @deprecated
968
+ */
969
+ export type EventTaskActivated = {
970
+ type: "task.activated";
971
+ properties: {
972
+ id: string;
973
+ };
974
+ };
975
+ /**
976
+ * 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.
977
+ *
978
+ * @deprecated
979
+ */
980
+ export type EventTaskBackgrounded = {
981
+ type: "task.backgrounded";
982
+ properties: {
983
+ id: string;
984
+ };
985
+ };
986
+ /**
987
+ * 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.
988
+ *
989
+ * @deprecated
990
+ */
991
+ export type EventTaskDeactivated = {
992
+ type: "task.deactivated";
993
+ properties: {
994
+ id: string;
995
+ };
996
+ };
997
+ export type Workitem = {
532
998
  /**
533
- * Display text (1-5 words, concise)
999
+ * Unique work-item id (tsk_…)
534
1000
  */
535
- label: string;
1001
+ id: string;
536
1002
  /**
537
- * Explanation of choice
1003
+ * A brief title for the work item
1004
+ */
1005
+ subject: string;
1006
+ /**
1007
+ * What needs to be done
538
1008
  */
539
1009
  description: string;
540
- };
541
- export type QuestionInfo = {
542
1010
  /**
543
- * Complete question
1011
+ * Present-continuous form shown while in_progress (e.g. 'Running tests')
544
1012
  */
545
- question: string;
1013
+ activeForm?: string;
1014
+ status: "pending" | "in_progress" | "completed" | "cancelled";
546
1015
  /**
547
- * Very short label (max 12 chars)
1016
+ * Session id of the agent that claimed this item
548
1017
  */
549
- header: string;
1018
+ owner?: string;
550
1019
  /**
551
- * Available choices
1020
+ * ids of items this item blocks (they wait on this one)
552
1021
  */
553
- options: Array<QuestionOption>;
1022
+ blocks: Array<string>;
554
1023
  /**
555
- * Allow selecting multiple choices
1024
+ * ids of items that must complete before this one can start
556
1025
  */
557
- multiple?: boolean;
558
- };
559
- export type QuestionRequest = {
560
- id: string;
561
- sessionID: string;
1026
+ blocked_by: Array<string>;
562
1027
  /**
563
- * Questions to ask
1028
+ * Arbitrary metadata attached to the item
564
1029
  */
565
- questions: Array<QuestionInfo>;
566
- tool?: {
567
- messageID: string;
568
- callID: string;
1030
+ metadata?: {
1031
+ [key: string]: unknown;
569
1032
  };
1033
+ created: number;
1034
+ updated: number;
570
1035
  };
571
- export type EventQuestionAsked = {
572
- type: "question.asked";
573
- properties: QuestionRequest;
1036
+ export type EventAgentWorkitemUpdated = {
1037
+ type: "agent.workitem.updated";
1038
+ properties: {
1039
+ items: Array<Workitem>;
1040
+ };
574
1041
  };
575
- export type QuestionAnswer = Array<string>;
576
- export type EventQuestionReplied = {
577
- type: "question.replied";
1042
+ /**
1043
+ * 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.
1044
+ *
1045
+ * @deprecated
1046
+ */
1047
+ export type EventAgentCoordinatorEnabled = {
1048
+ type: "agent.coordinator.enabled";
578
1049
  properties: {
579
1050
  sessionID: string;
580
- requestID: string;
581
- answers: Array<QuestionAnswer>;
582
1051
  };
583
1052
  };
584
- export type EventQuestionRejected = {
585
- type: "question.rejected";
1053
+ /**
1054
+ * 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.
1055
+ *
1056
+ * @deprecated
1057
+ */
1058
+ export type EventAgentCoordinatorDisabled = {
1059
+ type: "agent.coordinator.disabled";
586
1060
  properties: {
587
1061
  sessionID: string;
588
- requestID: string;
589
1062
  };
590
1063
  };
591
- export type EventFileEdited = {
592
- type: "file.edited";
1064
+ /**
1065
+ * 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.
1066
+ *
1067
+ * @deprecated
1068
+ */
1069
+ export type EventAgentCoordinatorDispatched = {
1070
+ type: "agent.coordinator.dispatched";
593
1071
  properties: {
594
- file: string;
1072
+ sessionID: string;
1073
+ taskID: string;
1074
+ workerSessionID?: string;
1075
+ agent?: string;
1076
+ description: string;
595
1077
  };
596
1078
  };
597
- export type EventTuiPromptAppend = {
598
- type: "tui.prompt.append";
1079
+ /**
1080
+ * 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.
1081
+ *
1082
+ * @deprecated
1083
+ */
1084
+ export type EventAgentCoordinatorDispatchUpdated = {
1085
+ type: "agent.coordinator.dispatch_updated";
599
1086
  properties: {
600
- text: string;
1087
+ sessionID: string;
1088
+ taskID: string;
1089
+ status: "running" | "completed" | "failed" | "stopped";
601
1090
  };
602
1091
  };
603
- export type EventTuiCommandExecute = {
604
- type: "tui.command.execute";
1092
+ /**
1093
+ * 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.
1094
+ *
1095
+ * @deprecated
1096
+ */
1097
+ export type EventSessionNotificationQueued = {
1098
+ type: "session.notification.queued";
605
1099
  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;
1100
+ sessionID: string;
1101
+ taskID: string;
1102
+ priority: "now" | "next" | "later";
607
1103
  };
608
1104
  };
609
- export type EventTuiToastShow = {
610
- type: "tui.toast.show";
1105
+ /**
1106
+ * 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.
1107
+ *
1108
+ * @deprecated
1109
+ */
1110
+ export type EventSessionNotificationDrained = {
1111
+ type: "session.notification.drained";
611
1112
  properties: {
612
- title?: string;
613
- message: string;
614
- variant: "info" | "success" | "warning" | "error";
615
- /**
616
- * Duration in milliseconds
617
- */
618
- duration?: number;
1113
+ sessionID: string;
1114
+ count: number;
619
1115
  };
620
1116
  };
621
- export type EventTuiSessionSelect = {
622
- type: "tui.session.select";
1117
+ /**
1118
+ * 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.
1119
+ *
1120
+ * @deprecated
1121
+ */
1122
+ export type EventSessionToolSummary = {
1123
+ type: "session.tool_summary";
1124
+ properties: {
1125
+ sessionID: string;
1126
+ summary: string;
1127
+ messageID?: string;
1128
+ };
1129
+ };
1130
+ export type EventSessionBudgetCompleted = {
1131
+ type: "session.budget.completed";
1132
+ properties: {
1133
+ sessionID: string;
1134
+ continuationCount: number;
1135
+ pct: number;
1136
+ turnTokens: number;
1137
+ budget: number;
1138
+ diminishingReturns: boolean;
1139
+ durationMs: number;
1140
+ };
1141
+ };
1142
+ export type EventSessionPromptSuggestion = {
1143
+ type: "session.prompt_suggestion";
623
1144
  properties: {
624
- /**
625
- * Session ID to navigate to
626
- */
627
1145
  sessionID: string;
1146
+ suggestion: string;
1147
+ variant: "user_intent" | "stated_intent";
1148
+ };
1149
+ };
1150
+ export type EventFileEdited = {
1151
+ type: "file.edited";
1152
+ properties: {
1153
+ file: string;
628
1154
  };
629
1155
  };
630
- export type EventMcpToolsChanged = {
631
- type: "mcp.tools.changed";
1156
+ /**
1157
+ * 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.
1158
+ *
1159
+ * @deprecated
1160
+ */
1161
+ export type EventAgentTeamCreated = {
1162
+ type: "agent.team.created";
632
1163
  properties: {
633
- server: string;
1164
+ name: string;
1165
+ members: Array<string>;
634
1166
  };
635
1167
  };
636
- export type EventCommandExecuted = {
637
- type: "command.executed";
1168
+ /**
1169
+ * 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.
1170
+ *
1171
+ * @deprecated
1172
+ */
1173
+ export type EventAgentTeamDeleted = {
1174
+ type: "agent.team.deleted";
638
1175
  properties: {
639
1176
  name: string;
640
- sessionID: string;
641
- arguments: string;
642
- messageID: string;
643
1177
  };
644
1178
  };
645
1179
  export type PermissionAction = "allow" | "deny" | "ask";
@@ -672,8 +1206,14 @@ export type Session = {
672
1206
  compacting?: number;
673
1207
  archived?: number;
674
1208
  };
1209
+ cost?: number;
675
1210
  permission?: PermissionRuleset;
676
1211
  permissionMode?: PermissionMode;
1212
+ contentReplacements?: Array<{
1213
+ kind: "tool-result" | "tool-input";
1214
+ toolUseId: string;
1215
+ replacement: string;
1216
+ }>;
677
1217
  revert?: {
678
1218
  messageID: string;
679
1219
  partID?: string;
@@ -713,11 +1253,12 @@ export type EventSessionError = {
713
1253
  error?: ProviderAuthError | UnknownError | MessageOutputLengthError | MessageAbortedError | ApiError;
714
1254
  };
715
1255
  };
716
- export type EventFileWatcherUpdated = {
717
- type: "file.watcher.updated";
1256
+ export type EventSessionVerificationVerdict = {
1257
+ type: "session.verification_verdict";
718
1258
  properties: {
719
- file: string;
720
- event: "add" | "change" | "unlink";
1259
+ sessionID: string;
1260
+ verdict: "pass" | "fail";
1261
+ source?: string;
721
1262
  };
722
1263
  };
723
1264
  export type EventVcsBranchUpdated = {
@@ -726,6 +1267,39 @@ export type EventVcsBranchUpdated = {
726
1267
  branch?: string;
727
1268
  };
728
1269
  };
1270
+ export type EventTuiPromptAppend = {
1271
+ type: "tui.prompt.append";
1272
+ properties: {
1273
+ text: string;
1274
+ };
1275
+ };
1276
+ export type EventTuiCommandExecute = {
1277
+ type: "tui.command.execute";
1278
+ properties: {
1279
+ 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;
1280
+ };
1281
+ };
1282
+ export type EventTuiToastShow = {
1283
+ type: "tui.toast.show";
1284
+ properties: {
1285
+ title?: string;
1286
+ message: string;
1287
+ variant: "info" | "success" | "warning" | "error";
1288
+ /**
1289
+ * Duration in milliseconds
1290
+ */
1291
+ duration?: number;
1292
+ };
1293
+ };
1294
+ export type EventTuiSessionSelect = {
1295
+ type: "tui.session.select";
1296
+ properties: {
1297
+ /**
1298
+ * Session ID to navigate to
1299
+ */
1300
+ sessionID: string;
1301
+ };
1302
+ };
729
1303
  export type Pty = {
730
1304
  id: string;
731
1305
  title: string;
@@ -735,18 +1309,33 @@ export type Pty = {
735
1309
  status: "running" | "exited";
736
1310
  pid: number;
737
1311
  };
1312
+ /**
1313
+ * 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.
1314
+ *
1315
+ * @deprecated
1316
+ */
738
1317
  export type EventPtyCreated = {
739
1318
  type: "pty.created";
740
1319
  properties: {
741
1320
  info: Pty;
742
1321
  };
743
1322
  };
1323
+ /**
1324
+ * 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.
1325
+ *
1326
+ * @deprecated
1327
+ */
744
1328
  export type EventPtyUpdated = {
745
1329
  type: "pty.updated";
746
1330
  properties: {
747
1331
  info: Pty;
748
1332
  };
749
1333
  };
1334
+ /**
1335
+ * 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.
1336
+ *
1337
+ * @deprecated
1338
+ */
750
1339
  export type EventPtyExited = {
751
1340
  type: "pty.exited";
752
1341
  properties: {
@@ -754,6 +1343,11 @@ export type EventPtyExited = {
754
1343
  exitCode: number;
755
1344
  };
756
1345
  };
1346
+ /**
1347
+ * 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.
1348
+ *
1349
+ * @deprecated
1350
+ */
757
1351
  export type EventPtyDeleted = {
758
1352
  type: "pty.deleted";
759
1353
  properties: {
@@ -766,13 +1360,46 @@ export type EventServerConnected = {
766
1360
  [key: string]: unknown;
767
1361
  };
768
1362
  };
1363
+ export type EventServerInstanceDisposed = {
1364
+ type: "server.instance.disposed";
1365
+ properties: {
1366
+ [key: string]: unknown;
1367
+ };
1368
+ };
1369
+ /**
1370
+ * 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.
1371
+ *
1372
+ * @deprecated
1373
+ */
769
1374
  export type EventGlobalDisposed = {
770
1375
  type: "global.disposed";
771
1376
  properties: {
772
1377
  [key: string]: unknown;
773
1378
  };
774
1379
  };
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;
1380
+ export type EventSwarmMessageReceived = {
1381
+ type: "swarm.message.received";
1382
+ properties: {
1383
+ id: string;
1384
+ from: string;
1385
+ to: string;
1386
+ type: string;
1387
+ payload?: unknown;
1388
+ time: number;
1389
+ };
1390
+ };
1391
+ export type EventSwarmMailboxMessage = {
1392
+ type: "swarm.mailbox.message";
1393
+ properties: {
1394
+ id: string;
1395
+ from: string;
1396
+ to: string;
1397
+ type: string;
1398
+ payload?: unknown;
1399
+ time: number;
1400
+ };
1401
+ };
1402
+ export type Event = EventFlagRefreshed | EventInstallationUpdated | EventInstallationUpdateAvailable | EventProjectUpdated | EventConfigManagedPolicyChanged | EventFileWatcherUpdated | EventConfigChanged | EventQuestionAsked | EventQuestionReplied | EventQuestionRejected | EventSessionStatus | EventSessionIdle | EventMemoryExtractionCompleted | EventMemoryConsolidationCompleted | EventMemoryRecallCompleted | EventPermissionAsked | EventPermissionReplied | EventMcpToolsChanged | EventMcpStatusChanged | EventScheduleCreated | EventScheduleUpdated | EventScheduleRemoved | EventScheduleFired | EventLspClientDiagnostics | EventLspUpdated | EventMessageUpdated | EventMessageRemoved | EventMessagePartUpdated | EventMessagePartRemoved | 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
1403
  export type GlobalEvent = {
777
1404
  directory: string;
778
1405
  payload: Event;
@@ -790,389 +1417,457 @@ export type NotFoundError = {
790
1417
  message: string;
791
1418
  };
792
1419
  };
1420
+ export type InstalledPlugin = {
1421
+ name: string;
1422
+ version?: string;
1423
+ description?: string;
1424
+ author?: string;
1425
+ root: string;
1426
+ enabled: boolean;
1427
+ source?: string;
1428
+ components: {
1429
+ [key: string]: number;
1430
+ };
1431
+ };
1432
+ export type DiscoverPlugin = {
1433
+ name: string;
1434
+ source: string;
1435
+ description?: string;
1436
+ version?: string;
1437
+ author?: string;
1438
+ installs?: number;
1439
+ marketplace: string;
1440
+ marketplaceSpec: string;
1441
+ };
1442
+ export type PluginError = {
1443
+ dir: string;
1444
+ reason: string;
1445
+ };
1446
+ export type PluginReloadResult = {
1447
+ plugins: number;
1448
+ commands: number;
1449
+ agents: number;
1450
+ skills: number;
1451
+ hooks: number;
1452
+ mcp: number;
1453
+ lsp: number;
1454
+ };
1455
+ export type PluginInstallResult = {
1456
+ name: string;
1457
+ version?: string;
1458
+ };
1459
+ export type TrustStatus = {
1460
+ trusted: boolean;
1461
+ directory: string;
1462
+ home: boolean;
1463
+ hasMcpJson: boolean;
1464
+ hasProjectConfig: boolean;
1465
+ };
1466
+ export type RemoteBridgeEnrollment = {
1467
+ token: string;
1468
+ deviceID: string;
1469
+ protocol: number;
1470
+ path: string;
1471
+ expiresAt: number;
1472
+ };
1473
+ export type RemoteBridgeDevice = {
1474
+ id: string;
1475
+ name?: string;
1476
+ createdAt: number;
1477
+ lastSeenAt?: number;
1478
+ revokedAt?: number;
1479
+ };
793
1480
  /**
794
- * Custom keybind configurations
1481
+ * 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
1482
  */
796
1483
  export type KeybindsConfig = {
797
1484
  /**
798
- * Leader key for keybind combinations
1485
+ * 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
1486
  */
800
1487
  leader?: string;
801
1488
  /**
802
- * Exit the application
1489
+ * Quit 100xprompt. In the prompt it only quits when the input is empty — with text typed, ctrl+c hits `input_clear` first and just clears it. Inside a dialog or a permission prompt this key cancels instead of quitting.
803
1490
  */
804
1491
  app_exit?: string;
805
1492
  /**
806
- * Open external editor
1493
+ * 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
1494
  */
808
1495
  editor_open?: string;
809
1496
  /**
810
- * List available themes
1497
+ * Open the theme picker.
811
1498
  */
812
1499
  theme_list?: string;
813
1500
  /**
814
- * Toggle sidebar
1501
+ * Show or hide the scrollbar alongside the session transcript.
815
1502
  */
816
- sidebar_toggle?: string;
1503
+ scrollbar_toggle?: string;
817
1504
  /**
818
- * Toggle session scrollbar
1505
+ * Accepted for compatibility but currently inert — nothing in the TUI reads this binding. Background tasks are reached from the command palette ("Background tasks").
819
1506
  */
820
- scrollbar_toggle?: string;
1507
+ task_background?: string;
821
1508
  /**
822
- * Toggle username visibility
1509
+ * Accepted for compatibility but currently inert — this build has no username display to toggle and nothing reads this binding.
823
1510
  */
824
1511
  username_toggle?: string;
825
1512
  /**
826
- * View status
1513
+ * Open the status panel: version, providers, connected MCP servers and the active directories.
827
1514
  */
828
1515
  status_view?: string;
829
1516
  /**
830
- * Export session to editor
1517
+ * 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
1518
  */
832
1519
  session_export?: string;
833
1520
  /**
834
- * Create a new session
1521
+ * Start a new session, carrying anything already typed in the prompt across to it.
835
1522
  */
836
1523
  session_new?: string;
837
1524
  /**
838
- * List all sessions
1525
+ * Open the session switcher.
839
1526
  */
840
1527
  session_list?: string;
841
1528
  /**
842
- * Show session timeline
1529
+ * Open the message timeline and jump to any earlier point in the session.
843
1530
  */
844
1531
  session_timeline?: string;
845
1532
  /**
846
- * Fork session from message
1533
+ * Pick an earlier message and branch a new session from it, leaving this one intact.
847
1534
  */
848
1535
  session_fork?: string;
849
1536
  /**
850
- * Rename session
1537
+ * Rename the current session.
851
1538
  */
852
1539
  session_rename?: string;
853
1540
  /**
854
- * Share current session
1541
+ * Publish a share link for this session and copy it to the clipboard. Hidden when `share` is set to "disabled".
855
1542
  */
856
1543
  session_share?: string;
857
1544
  /**
858
- * Unshare current session
1545
+ * Revoke this session's share link.
859
1546
  */
860
1547
  session_unshare?: string;
861
1548
  /**
862
- * Interrupt current session
1549
+ * Abort the turn in flight. Only active while the session is busy; in shell (!) mode it leaves shell mode instead.
863
1550
  */
864
1551
  session_interrupt?: string;
865
1552
  /**
866
- * Compact the session
1553
+ * Summarize the session so far and carry on from the summary, reclaiming context. Needs a provider connected.
867
1554
  */
868
1555
  session_compact?: string;
869
1556
  /**
870
- * Scroll messages up by one page
1557
+ * 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
1558
  */
872
1559
  messages_page_up?: string;
873
1560
  /**
874
- * Scroll messages down by one page
1561
+ * 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
1562
  */
876
1563
  messages_page_down?: string;
877
1564
  /**
878
- * Scroll messages up by half page
1565
+ * Scroll the transcript up by a quarter of a viewport — half the step `messages_page_up` takes.
879
1566
  */
880
1567
  messages_half_page_up?: string;
881
1568
  /**
882
- * Scroll messages down by half page
1569
+ * Scroll the transcript down by a quarter of a viewport — half the step `messages_page_down` takes.
883
1570
  */
884
1571
  messages_half_page_down?: string;
885
1572
  /**
886
- * Navigate to first message
1573
+ * Jump to the top of the transcript.
887
1574
  */
888
1575
  messages_first?: string;
889
1576
  /**
890
- * Navigate to last message
1577
+ * Jump to the bottom of the transcript.
891
1578
  */
892
1579
  messages_last?: string;
893
1580
  /**
894
- * Navigate to next message
1581
+ * Scroll to the next message boundary.
895
1582
  */
896
1583
  messages_next?: string;
897
1584
  /**
898
- * Navigate to previous message
1585
+ * Scroll to the previous message boundary.
899
1586
  */
900
1587
  messages_previous?: string;
901
1588
  /**
902
- * Navigate to last user message
1589
+ * Jump to the most recent message you actually typed, skipping synthetic and hidden text.
903
1590
  */
904
1591
  messages_last_user?: string;
905
1592
  /**
906
- * Copy message
1593
+ * Copy the last assistant message to the clipboard, also emitting OSC 52 so it works over SSH and inside tmux.
907
1594
  */
908
1595
  messages_copy?: string;
909
1596
  /**
910
- * Undo message
1597
+ * 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
1598
  */
912
1599
  messages_undo?: string;
913
1600
  /**
914
- * Redo message
1601
+ * Step forward again after an undo, restoring the next message. Only available while a message is reverted.
915
1602
  */
916
1603
  messages_redo?: string;
917
1604
  /**
918
- * Toggle code block concealment in messages
1605
+ * 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
1606
  */
920
1607
  messages_toggle_conceal?: string;
921
1608
  /**
922
- * Toggle tool details visibility
1609
+ * Rate the last Auto-routed response as good (👍). Does nothing if the last response was not Auto-routed.
1610
+ */
1611
+ feedback_up?: string;
1612
+ /**
1613
+ * Rate the last Auto-routed response as bad (👎). Does nothing if the last response was not Auto-routed.
1614
+ */
1615
+ feedback_down?: string;
1616
+ /**
1617
+ * Show or hide the expanded output underneath each tool call.
923
1618
  */
924
1619
  tool_details?: string;
925
1620
  /**
926
- * List available models
1621
+ * Open the model picker.
927
1622
  */
928
1623
  model_list?: string;
929
1624
  /**
930
- * Next recently used model
1625
+ * Switch to the next model in your recently-used list without opening the picker.
931
1626
  */
932
1627
  model_cycle_recent?: string;
933
1628
  /**
934
- * Previous recently used model
1629
+ * Switch to the previous model in your recently-used list without opening the picker.
935
1630
  */
936
1631
  model_cycle_recent_reverse?: string;
937
1632
  /**
938
- * Next favorite model
1633
+ * Switch to the next favourited model. Warns if you have not starred any.
939
1634
  */
940
1635
  model_cycle_favorite?: string;
941
1636
  /**
942
- * Previous favorite model
1637
+ * Switch to the previous favourited model. Warns if you have not starred any.
943
1638
  */
944
1639
  model_cycle_favorite_reverse?: string;
945
1640
  /**
946
- * List available commands
1641
+ * Open the command palette — every action in one searchable list.
947
1642
  */
948
1643
  command_list?: string;
949
1644
  /**
950
- * List agents
1645
+ * Open the agent picker.
951
1646
  */
952
1647
  agent_list?: string;
953
1648
  /**
954
- * Next agent
1649
+ * Switch to the next agent.
955
1650
  */
956
1651
  agent_cycle?: string;
957
1652
  /**
958
- * Previous agent
1653
+ * Switch to the previous agent.
959
1654
  */
960
1655
  agent_cycle_reverse?: string;
961
1656
  /**
962
- * Cycle permission mode (default → acceptEdits → auto → plan)
1657
+ * Cycle the session's permission mode: default → acceptEdits → auto → plan → back to default.
963
1658
  */
964
1659
  permission_mode_cycle?: string;
965
1660
  /**
966
- * Cycle model variants
1661
+ * 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
1662
  */
968
1663
  variant_cycle?: string;
969
1664
  /**
970
- * Clear input field
1665
+ * Clear the prompt. Only fires while there is text; on an empty prompt the same default falls through to `app_exit`.
971
1666
  */
972
1667
  input_clear?: string;
973
1668
  /**
974
- * Paste from clipboard
1669
+ * Paste the system clipboard into the prompt. An image on the clipboard is attached as a file part instead of pasted as text.
975
1670
  */
976
1671
  input_paste?: string;
977
1672
  /**
978
- * Submit input
1673
+ * Send the prompt.
979
1674
  */
980
1675
  input_submit?: string;
981
1676
  /**
982
- * Insert newline in input
1677
+ * Insert a line break without sending.
983
1678
  */
984
1679
  input_newline?: string;
985
1680
  /**
986
- * Move cursor left in input
1681
+ * Move the cursor one character left.
987
1682
  */
988
1683
  input_move_left?: string;
989
1684
  /**
990
- * Move cursor right in input
1685
+ * Move the cursor one character right.
991
1686
  */
992
1687
  input_move_right?: string;
993
1688
  /**
994
- * Move cursor up in input
1689
+ * Move the cursor up one wrapped row.
995
1690
  */
996
1691
  input_move_up?: string;
997
1692
  /**
998
- * Move cursor down in input
1693
+ * Move the cursor down one wrapped row.
999
1694
  */
1000
1695
  input_move_down?: string;
1001
1696
  /**
1002
- * Select left in input
1697
+ * 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
1698
  */
1004
1699
  input_select_left?: string;
1005
1700
  /**
1006
- * Select right in input
1701
+ * 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
1702
  */
1008
1703
  input_select_right?: string;
1009
1704
  /**
1010
- * Select up in input
1705
+ * Moves the cursor up one wrapped row. The prompt editor has no selection model, so nothing is highlighted.
1011
1706
  */
1012
1707
  input_select_up?: string;
1013
1708
  /**
1014
- * Select down in input
1709
+ * Moves the cursor down one wrapped row. The prompt editor has no selection model, so nothing is highlighted.
1015
1710
  */
1016
1711
  input_select_down?: string;
1017
1712
  /**
1018
- * Move to start of line in input
1713
+ * Move the cursor to the start of the current line.
1019
1714
  */
1020
1715
  input_line_home?: string;
1021
1716
  /**
1022
- * Move to end of line in input
1717
+ * Move the cursor to the end of the current line.
1023
1718
  */
1024
1719
  input_line_end?: string;
1025
1720
  /**
1026
- * Select to start of line in input
1721
+ * Moves the cursor to the start of the line — identical to `input_line_home`. The prompt editor has no selection model.
1027
1722
  */
1028
1723
  input_select_line_home?: string;
1029
1724
  /**
1030
- * Select to end of line in input
1725
+ * Moves the cursor to the end of the line — identical to `input_line_end`. The prompt editor has no selection model.
1031
1726
  */
1032
1727
  input_select_line_end?: string;
1033
1728
  /**
1034
- * Move to start of visual line in input
1729
+ * 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
1730
  */
1036
1731
  input_visual_line_home?: string;
1037
1732
  /**
1038
- * Move to end of visual line in input
1733
+ * 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
1734
  */
1040
1735
  input_visual_line_end?: string;
1041
1736
  /**
1042
- * Select to start of visual line in input
1737
+ * Moves the cursor to the start of the line — identical to `input_line_home`. No selection model, and no wrapped-row behaviour either.
1043
1738
  */
1044
1739
  input_select_visual_line_home?: string;
1045
1740
  /**
1046
- * Select to end of visual line in input
1741
+ * Moves the cursor to the end of the line — identical to `input_line_end`. No selection model, and no wrapped-row behaviour either.
1047
1742
  */
1048
1743
  input_select_visual_line_end?: string;
1049
1744
  /**
1050
- * Move to start of buffer in input
1745
+ * Move the cursor to the very start of the prompt.
1051
1746
  */
1052
1747
  input_buffer_home?: string;
1053
1748
  /**
1054
- * Move to end of buffer in input
1749
+ * Move the cursor to the very end of the prompt.
1055
1750
  */
1056
1751
  input_buffer_end?: string;
1057
1752
  /**
1058
- * Select to start of buffer in input
1753
+ * Moves the cursor to the very start of the prompt — identical to `input_buffer_home`. The prompt editor has no selection model.
1059
1754
  */
1060
1755
  input_select_buffer_home?: string;
1061
1756
  /**
1062
- * Select to end of buffer in input
1757
+ * Moves the cursor to the very end of the prompt — identical to `input_buffer_end`. The prompt editor has no selection model.
1063
1758
  */
1064
1759
  input_select_buffer_end?: string;
1065
1760
  /**
1066
- * Delete line in input
1761
+ * 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
1762
  */
1068
1763
  input_delete_line?: string;
1069
1764
  /**
1070
- * Delete to end of line in input
1765
+ * Delete from the cursor to the end of the line.
1071
1766
  */
1072
1767
  input_delete_to_line_end?: string;
1073
1768
  /**
1074
- * Delete to start of line in input
1769
+ * Delete from the start of the line up to the cursor.
1075
1770
  */
1076
1771
  input_delete_to_line_start?: string;
1077
1772
  /**
1078
- * Backspace in input
1773
+ * Delete the character before the cursor.
1079
1774
  */
1080
1775
  input_backspace?: string;
1081
1776
  /**
1082
- * Delete character in input
1777
+ * Delete the character after the cursor.
1083
1778
  */
1084
1779
  input_delete?: string;
1085
1780
  /**
1086
- * Undo in input
1781
+ * Undo the last edit to the prompt text. This is the prompt's own edit history — to undo a sent message use `messages_undo`.
1087
1782
  */
1088
1783
  input_undo?: string;
1089
1784
  /**
1090
- * Redo in input
1785
+ * Redo an edit to the prompt text undone by `input_undo`.
1091
1786
  */
1092
1787
  input_redo?: string;
1093
1788
  /**
1094
- * Move word forward in input
1789
+ * Move the cursor one word right.
1095
1790
  */
1096
1791
  input_word_forward?: string;
1097
1792
  /**
1098
- * Move word backward in input
1793
+ * Move the cursor one word left.
1099
1794
  */
1100
1795
  input_word_backward?: string;
1101
1796
  /**
1102
- * Select word forward in input
1797
+ * Moves the cursor one word right — identical to `input_word_forward`. The prompt editor has no selection model.
1103
1798
  */
1104
1799
  input_select_word_forward?: string;
1105
1800
  /**
1106
- * Select word backward in input
1801
+ * Moves the cursor one word left — identical to `input_word_backward`. The prompt editor has no selection model.
1107
1802
  */
1108
1803
  input_select_word_backward?: string;
1109
1804
  /**
1110
- * Delete word forward in input
1805
+ * Delete from the cursor forward to the end of the word.
1111
1806
  */
1112
1807
  input_delete_word_forward?: string;
1113
1808
  /**
1114
- * Delete word backward in input
1809
+ * Delete from the cursor back to the start of the word.
1115
1810
  */
1116
1811
  input_delete_word_backward?: string;
1117
1812
  /**
1118
- * Previous history item
1813
+ * 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
1814
  */
1120
1815
  history_previous?: string;
1121
1816
  /**
1122
- * Next history item
1817
+ * 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
1818
  */
1124
1819
  history_next?: string;
1125
1820
  /**
1126
- * Next child session
1821
+ * Move to the next sub-session spawned by this one.
1127
1822
  */
1128
1823
  session_child_cycle?: string;
1129
1824
  /**
1130
- * Previous child session
1825
+ * Move to the previous sub-session spawned by this one.
1131
1826
  */
1132
1827
  session_child_cycle_reverse?: string;
1133
1828
  /**
1134
- * Go to parent session
1829
+ * Go back up to the session that spawned this one.
1135
1830
  */
1136
1831
  session_parent?: string;
1137
1832
  /**
1138
- * Suspend terminal
1833
+ * Suspend to the shell (SIGTSTP). Bring it back with `fg` and the UI redraws.
1139
1834
  */
1140
1835
  terminal_suspend?: string;
1141
1836
  /**
1142
- * Toggle terminal title
1837
+ * Turn terminal window-title updates on or off. The choice is remembered between runs.
1143
1838
  */
1144
1839
  terminal_title_toggle?: string;
1145
1840
  /**
1146
- * Toggle tips on home screen
1841
+ * 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
1842
  */
1148
1843
  tips_toggle?: string;
1149
1844
  /**
1150
- * Toggle companion sprite
1845
+ * Show or hide the companion sprite in the session view. The choice is remembered between runs.
1151
1846
  */
1152
1847
  sprites_toggle?: string;
1153
1848
  };
1154
1849
  /**
1155
- * Log level
1850
+ * Lowest severity written to the log file. DEBUG is the most detailed and ERROR the least.
1156
1851
  */
1157
1852
  export type LogLevel = "DEBUG" | "INFO" | "WARN" | "ERROR";
1158
1853
  /**
1159
- * Server configuration for 100xprompt serve and web commands
1854
+ * Where the HTTP server binds and who may talk to it. Applies to `100xprompt serve` and anything else that starts the server.
1160
1855
  */
1161
1856
  export type ServerConfig = {
1162
1857
  /**
1163
- * Port to listen on
1858
+ * 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
1859
  */
1165
1860
  port?: number;
1166
1861
  /**
1167
- * Hostname to listen on
1862
+ * 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
1863
  */
1169
1864
  hostname?: string;
1170
1865
  /**
1171
- * Enable mDNS service discovery
1866
+ * 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
1867
  */
1173
1868
  mdns?: boolean;
1174
1869
  /**
1175
- * Additional domains to allow for CORS
1870
+ * 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
1871
  */
1177
1872
  cors?: Array<string>;
1178
1873
  };
@@ -1181,6 +1876,9 @@ export type PermissionObjectConfig = {
1181
1876
  [key: string]: PermissionActionConfig;
1182
1877
  };
1183
1878
  export type PermissionRuleConfig = PermissionActionConfig | PermissionObjectConfig;
1879
+ /**
1880
+ * 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.
1881
+ */
1184
1882
  export type PermissionConfig = {
1185
1883
  __originalKeys?: Array<string>;
1186
1884
  read?: PermissionRuleConfig;
@@ -1199,7 +1897,15 @@ export type PermissionConfig = {
1199
1897
  codesearch?: PermissionActionConfig;
1200
1898
  lsp?: PermissionRuleConfig;
1201
1899
  doom_loop?: PermissionActionConfig;
1202
- [key: string]: PermissionRuleConfig | Array<string> | PermissionActionConfig | undefined;
1900
+ /**
1901
+ * Extra directories agents may operate in beyond the workspace root. Org policy can pin these as an immutable directory boundary.
1902
+ */
1903
+ additionalDirectories?: Array<string>;
1904
+ /**
1905
+ * Policy-pinned workspace root. Highest-precedence directory boundary; overrides the env var.
1906
+ */
1907
+ workspaceRoot?: string;
1908
+ [key: string]: PermissionRuleConfig | Array<string> | PermissionActionConfig | Array<string> | string | undefined;
1203
1909
  } | PermissionActionConfig;
1204
1910
  export type AgentConfig = {
1205
1911
  model?: string;
@@ -1207,7 +1913,7 @@ export type AgentConfig = {
1207
1913
  top_p?: number;
1208
1914
  prompt?: string;
1209
1915
  /**
1210
- * @deprecated Use 'permission' field instead
1916
+ * 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
1917
  */
1212
1918
  tools?: {
1213
1919
  [key: string]: boolean;
@@ -1222,6 +1928,10 @@ export type AgentConfig = {
1222
1928
  * Hide this subagent from the @ autocomplete menu (default: false, only applies to mode: subagent)
1223
1929
  */
1224
1930
  hidden?: boolean;
1931
+ /**
1932
+ * 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)
1933
+ */
1934
+ slim?: boolean;
1225
1935
  options?: {
1226
1936
  [key: string]: unknown;
1227
1937
  };
@@ -1395,45 +2105,85 @@ export type McpRemoteConfig = {
1395
2105
  timeout?: number;
1396
2106
  };
1397
2107
  /**
1398
- * @deprecated Always uses stretch layout.
2108
+ * 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.
2109
+ *
2110
+ * @deprecated
1399
2111
  */
1400
2112
  export type LayoutConfig = "auto" | "stretch";
2113
+ /**
2114
+ * Permission mode new sessions start in. --permission-mode and mid-session toggles still override it.
2115
+ */
2116
+ export type PermissionModeConfig = "default" | "acceptEdits" | "plan" | "auto" | "bypassPermissions";
2117
+ /**
2118
+ * 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
2119
+ */
2120
+ export type PermissionsConfig = {
2121
+ /**
2122
+ * CC-style allow rules, e.g. "Bash(git status:*)", "Edit"
2123
+ */
2124
+ allow?: Array<string>;
2125
+ /**
2126
+ * CC-style deny rules — deny always wins over allow for a tool
2127
+ */
2128
+ deny?: Array<string>;
2129
+ /**
2130
+ * CC-style ask rules — force a prompt even when another rule allows
2131
+ */
2132
+ ask?: Array<string>;
2133
+ defaultMode?: PermissionModeConfig;
2134
+ /**
2135
+ * When "disable", removes bypassPermissions from the settable modes for this project.
2136
+ */
2137
+ disableBypassPermissionsMode?: "disable";
2138
+ };
1401
2139
  export type Config = {
1402
2140
  /**
1403
- * JSON schema reference for configuration validation
2141
+ * 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
2142
  */
1405
2143
  $schema?: string;
1406
2144
  /**
1407
- * Theme name to use for the interface
2145
+ * 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
2146
  */
1409
2147
  theme?: string;
1410
2148
  keybinds?: KeybindsConfig;
1411
2149
  logLevel?: LogLevel;
1412
2150
  /**
1413
- * TUI specific settings
2151
+ * 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.
2152
+ */
2153
+ sandbox?: boolean;
2154
+ /**
2155
+ * 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.
2156
+ */
2157
+ sandboxAutoApprove?: boolean;
2158
+ /**
2159
+ * 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.
2160
+ */
2161
+ sandboxBackend?: "microvm" | "seatbelt" | "landlock" | "none";
2162
+ /**
2163
+ * Behaviour of the terminal UI itself — scrolling feel and how diffs are laid out.
1414
2164
  */
1415
2165
  tui?: {
1416
2166
  /**
1417
- * TUI scroll speed
2167
+ * 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
2168
  */
1419
2169
  scroll_speed?: number;
1420
2170
  /**
1421
- * Scroll acceleration settings
2171
+ * Momentum scrolling for the transcript, in place of a fixed rows-per-notch step. Overrides `scroll_speed` when enabled.
1422
2172
  */
1423
2173
  scroll_acceleration?: {
1424
2174
  /**
1425
- * Enable scroll acceleration
2175
+ * Turn on the acceleration curve. Flick the wheel and the transcript keeps travelling; a slow scroll stays precise.
1426
2176
  */
1427
2177
  enabled: boolean;
1428
2178
  };
1429
2179
  /**
1430
- * Control diff rendering style: 'auto' adapts to terminal width, 'stacked' always shows single column
2180
+ * 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
2181
  */
1432
2182
  diff_style?: "auto" | "stacked";
1433
2183
  };
1434
2184
  server?: ServerConfig;
1435
2185
  /**
1436
- * Command configuration, see https://100xprompt.com/docs/commands
2186
+ * Custom slash commands, keyed by the name you type after '/'. See https://100xprompt.com/docs/commands
1437
2187
  */
1438
2188
  command?: {
1439
2189
  [key: string]: {
@@ -1442,41 +2192,205 @@ export type Config = {
1442
2192
  agent?: string;
1443
2193
  model?: string;
1444
2194
  subtask?: boolean;
2195
+ plugin?: string;
2196
+ "allowed-tools"?: string | Array<string>;
2197
+ "argument-hint"?: string;
2198
+ aliases?: Array<string>;
1445
2199
  };
1446
2200
  };
2201
+ /**
2202
+ * Which paths the file watcher pays attention to while a session is open.
2203
+ */
1447
2204
  watcher?: {
2205
+ /**
2206
+ * Extra glob patterns to ignore, on top of .gitignore and the built-in exclusions.
2207
+ */
1448
2208
  ignore?: Array<string>;
1449
2209
  };
2210
+ /**
2211
+ * 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.
2212
+ */
1450
2213
  plugin?: Array<string>;
2214
+ /**
2215
+ * Lifecycle hooks (command, prompt, agent, http) keyed by event: PreToolUse, PostToolUse, PostToolUseFailure, UserPromptSubmit, PermissionRequest, SessionStart, SessionEnd, Stop, PreCompact, PostCompact, and more
2216
+ */
2217
+ hooks?: {
2218
+ [key: string]: Array<{
2219
+ /**
2220
+ * Regex matched against the tool name (PreToolUse/PostToolUse only)
2221
+ */
2222
+ matcher?: string;
2223
+ hooks: Array<{
2224
+ /**
2225
+ * Shell hook (default type)
2226
+ */
2227
+ type?: "command";
2228
+ /**
2229
+ * Shell command. Receives the event JSON on stdin
2230
+ */
2231
+ command: string;
2232
+ /**
2233
+ * Timeout in seconds (default 60)
2234
+ */
2235
+ timeout?: number;
2236
+ } | {
2237
+ /**
2238
+ * Single non-streaming LLM validation call
2239
+ */
2240
+ type: "prompt";
2241
+ /**
2242
+ * Validation instructions for the model
2243
+ */
2244
+ prompt?: string;
2245
+ /**
2246
+ * Model as provider/model (defaults to the small model)
2247
+ */
2248
+ model?: string;
2249
+ /**
2250
+ * Timeout in seconds (default 60)
2251
+ */
2252
+ timeout?: number;
2253
+ } | {
2254
+ /**
2255
+ * Read-only verifier subagent
2256
+ */
2257
+ type: "agent";
2258
+ /**
2259
+ * Verification instructions for the subagent
2260
+ */
2261
+ prompt?: string;
2262
+ /**
2263
+ * Agent definition to run (default: general)
2264
+ */
2265
+ agent?: string;
2266
+ /**
2267
+ * Model as provider/model
2268
+ */
2269
+ model?: string;
2270
+ /**
2271
+ * Max tool turns (capped at 50)
2272
+ */
2273
+ maxTurns?: number;
2274
+ /**
2275
+ * Timeout in seconds (default 300)
2276
+ */
2277
+ timeout?: number;
2278
+ } | {
2279
+ /**
2280
+ * Webhook (SSRF-guarded; private addresses refused)
2281
+ */
2282
+ type: "http";
2283
+ /**
2284
+ * Webhook URL (http/https)
2285
+ */
2286
+ url: string;
2287
+ /**
2288
+ * HTTP method (default POST)
2289
+ */
2290
+ method?: "POST" | "PUT";
2291
+ /**
2292
+ * Extra headers; ${ENV_VAR} is interpolated
2293
+ */
2294
+ headers?: {
2295
+ [key: string]: string;
2296
+ };
2297
+ /**
2298
+ * Timeout in seconds (default 30)
2299
+ */
2300
+ timeout?: number;
2301
+ }>;
2302
+ }>;
2303
+ };
2304
+ /**
2305
+ * Adversarial verification gate — require a read-only verifier subagent verdict before completion reporting on significant changes
2306
+ */
2307
+ verification?: {
2308
+ /**
2309
+ * 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
2310
+ */
2311
+ enabled?: boolean;
2312
+ /**
2313
+ * Distinct files modified in a turn before verification is required. Default 3
2314
+ */
2315
+ threshold?: number;
2316
+ /**
2317
+ * Subagent spawned to verify the work (default: verifier)
2318
+ */
2319
+ agent?: string;
2320
+ };
2321
+ /**
2322
+ * Kairos mode — Claude Code-style background pacing (tick loop + model-controlled sleep) with terminal-focus-aware autonomy
2323
+ */
2324
+ kairos?: {
2325
+ /**
2326
+ * 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
2327
+ */
2328
+ enabled?: boolean;
2329
+ /**
2330
+ * Seconds to wait before the next tick when the model didn't call sleep. Default 60
2331
+ */
2332
+ default_sleep?: number;
2333
+ };
2334
+ /**
2335
+ * Enable Vim keybindings in the TUI prompt input
2336
+ */
2337
+ vim?: boolean;
2338
+ /**
2339
+ * Show an end-of-turn recap (Crunched for … + a one-line summary of what changed). Default on.
2340
+ */
2341
+ recap?: boolean;
2342
+ /**
2343
+ * Active output style (built-in: explanatory, learning, concise; or a custom output-styles*.md name)
2344
+ */
2345
+ output_style?: string;
2346
+ /**
2347
+ * 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
2348
+ */
2349
+ tool_search?: boolean | number;
2350
+ /**
2351
+ * 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.
2352
+ */
1451
2353
  snapshot?: boolean;
1452
2354
  /**
1453
- * Control sharing behavior:'manual' allows manual sharing via commands, 'auto' enables automatic sharing, 'disabled' disables all sharing
2355
+ * 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
2356
  */
1455
2357
  share?: "manual" | "auto" | "disabled";
1456
2358
  /**
1457
- * @deprecated Use 'share' field instead. Share newly created sessions automatically
2359
+ * 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
2360
  */
1459
2361
  autoshare?: boolean;
1460
2362
  /**
1461
- * Automatically update to the latest version. Set to true to auto-update, false to disable, or 'notify' to show update notifications
2363
+ * 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
2364
  */
1463
2365
  autoupdate?: boolean | "notify";
1464
2366
  /**
1465
- * Disable providers that are loaded automatically
2367
+ * 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
2368
  */
1467
2369
  disabled_providers?: Array<string>;
1468
2370
  /**
1469
- * When set, ONLY these providers will be enabled. All other providers will be ignored
2371
+ * Provider ids to allow, as an exclusive list: once this is set, every provider not named here is ignored regardless of available credentials.
1470
2372
  */
1471
2373
  enabled_providers?: Array<string>;
1472
2374
  /**
1473
- * Model to use in the format of provider/model, eg anthropic/claude-2
2375
+ * 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
2376
  */
1475
2377
  model?: string;
1476
2378
  /**
1477
- * Small model to use for tasks like title generation in the format of provider/model
2379
+ * 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.
2380
+ */
2381
+ fallback_model?: string;
2382
+ /**
2383
+ * 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
2384
  */
1479
2385
  small_model?: string;
2386
+ /**
2387
+ * Stronger model consulted by the /second-opinion command, in the format of provider/model. Defaults to the strongest available model
2388
+ */
2389
+ advisor_model?: string;
2390
+ /**
2391
+ * 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').
2392
+ */
2393
+ plan_model?: string;
1480
2394
  /**
1481
2395
  * Long-term memory system configuration
1482
2396
  */
@@ -1501,17 +2415,46 @@ export type Config = {
1501
2415
  * Override the side-model used for memory extraction/consolidation/recall, in the format of provider/model
1502
2416
  */
1503
2417
  model?: string;
2418
+ /**
2419
+ * 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.
2420
+ */
2421
+ team?: {
2422
+ /**
2423
+ * 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.
2424
+ */
2425
+ workspace?: string;
2426
+ /**
2427
+ * 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.
2428
+ */
2429
+ user?: string;
2430
+ /**
2431
+ * GCP project id for Firestore. Falls back to the GCP_PROJECT_ID / GOOGLE_CLOUD_PROJECT environment variables when omitted.
2432
+ */
2433
+ project_id?: string;
2434
+ /**
2435
+ * 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.
2436
+ */
2437
+ credentials?: string;
2438
+ /**
2439
+ * Root Firestore collection for team memories (default 'team-memories').
2440
+ */
2441
+ collection?: string;
2442
+ /**
2443
+ * 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.
2444
+ */
2445
+ default_visibility?: "private" | "team";
2446
+ };
1504
2447
  };
1505
2448
  /**
1506
2449
  * 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
2450
  */
1508
2451
  default_agent?: string;
1509
2452
  /**
1510
- * Custom username to display in conversations instead of system username
2453
+ * Name shown against your messages in the transcript. Defaults to your operating-system username.
1511
2454
  */
1512
2455
  username?: string;
1513
2456
  /**
1514
- * @deprecated Use `agent` field instead.
2457
+ * 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
2458
  */
1516
2459
  mode?: {
1517
2460
  build?: AgentConfig;
@@ -1519,7 +2462,7 @@ export type Config = {
1519
2462
  [key: string]: AgentConfig | undefined;
1520
2463
  };
1521
2464
  /**
1522
- * Agent configuration, see https://100xprompt.com/docs/agent
2465
+ * 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
2466
  */
1524
2467
  agent?: {
1525
2468
  plan?: AgentConfig;
@@ -1532,19 +2475,34 @@ export type Config = {
1532
2475
  [key: string]: AgentConfig | undefined;
1533
2476
  };
1534
2477
  /**
1535
- * Custom provider configurations and model overrides
2478
+ * 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
2479
  */
1537
2480
  provider?: {
1538
2481
  [key: string]: ProviderConfig;
1539
2482
  };
1540
2483
  /**
1541
- * MCP (Model Context Protocol) server configurations
2484
+ * 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
2485
  */
1543
2486
  mcp?: {
1544
2487
  [key: string]: McpLocalConfig | McpRemoteConfig | {
1545
2488
  enabled: boolean;
1546
2489
  };
1547
2490
  };
2491
+ /**
2492
+ * Automatically approve every MCP server declared in the project's committed .mcp.json. Security: leave off so untrusted repo servers require explicit opt-in.
2493
+ */
2494
+ enableAllProjectMcpServers?: boolean;
2495
+ /**
2496
+ * Names of project .mcp.json MCP servers approved to connect (Claude Code parity)
2497
+ */
2498
+ enabledMcpjsonServers?: Array<string>;
2499
+ /**
2500
+ * Names of project .mcp.json MCP servers rejected — they never connect (Claude Code parity)
2501
+ */
2502
+ disabledMcpjsonServers?: Array<string>;
2503
+ /**
2504
+ * 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.
2505
+ */
1548
2506
  formatter?: false | {
1549
2507
  [key: string]: {
1550
2508
  disabled?: boolean;
@@ -1555,6 +2513,9 @@ export type Config = {
1555
2513
  extensions?: Array<string>;
1556
2514
  };
1557
2515
  };
2516
+ /**
2517
+ * 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.
2518
+ */
1558
2519
  lsp?: false | {
1559
2520
  [key: string]: {
1560
2521
  disabled: true;
@@ -1571,23 +2532,31 @@ export type Config = {
1571
2532
  };
1572
2533
  };
1573
2534
  /**
1574
- * Additional instruction files or patterns to include
2535
+ * 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
2536
  */
1576
2537
  instructions?: Array<string>;
1577
2538
  layout?: LayoutConfig;
1578
2539
  permission?: PermissionConfig;
2540
+ permissions?: PermissionsConfig;
2541
+ /**
2542
+ * 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.
2543
+ */
1579
2544
  tools?: {
1580
2545
  [key: string]: boolean;
1581
2546
  };
2547
+ /**
2548
+ * Settings for an organisation-hosted deployment.
2549
+ */
1582
2550
  enterprise?: {
1583
2551
  /**
1584
- * Enterprise URL
2552
+ * Base URL of your organisation's 100xprompt deployment, used to fetch managed configuration.
1585
2553
  */
1586
2554
  url?: string;
1587
2555
  };
1588
2556
  compaction?: {
1589
2557
  auto?: {
1590
2558
  enabled?: boolean;
2559
+ compactionThresholdPct?: number;
1591
2560
  compactionThreshold?: number;
1592
2561
  tailPreserveTurns?: number;
1593
2562
  summaryMaxTokens?: number;
@@ -1602,7 +2571,37 @@ export type Config = {
1602
2571
  coldPreviewTokens?: number;
1603
2572
  };
1604
2573
  };
2574
+ /**
2575
+ * Prompt-cache tuning for Anthropic-family models
2576
+ */
2577
+ cache?: {
2578
+ /**
2579
+ * 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.
2580
+ */
2581
+ ttl?: "5m" | "1h";
2582
+ };
1605
2583
  experimental?: {
2584
+ /**
2585
+ * 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.
2586
+ */
2587
+ channel?: {
2588
+ /**
2589
+ * Responder identities (chat/user ids) permitted to approve or deny a relayed permission prompt. Empty authorizes nobody.
2590
+ */
2591
+ allow?: Array<string>;
2592
+ telegram?: {
2593
+ token: string;
2594
+ chatID: string;
2595
+ };
2596
+ /**
2597
+ * Approval deadline in ms; on expiry the relay denies. Default 600000.
2598
+ */
2599
+ timeoutMs?: number;
2600
+ /**
2601
+ * 'deny' (default) fails closed when no channel accepted the prompt; 'degrade' falls back to the local dialog. Neither can produce an allow.
2602
+ */
2603
+ unreachable?: "deny" | "degrade";
2604
+ };
1606
2605
  hook?: {
1607
2606
  file_edited?: {
1608
2607
  [key: string]: Array<{
@@ -1624,14 +2623,147 @@ export type Config = {
1624
2623
  */
1625
2624
  chatMaxRetries?: number;
1626
2625
  disable_paste_summary?: boolean;
2626
+ /**
2627
+ * Self-evolving skills (offline, validation-gated). Disabled by default.
2628
+ */
2629
+ skillEvolve?: {
2630
+ /**
2631
+ * 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).
2632
+ */
2633
+ enabled?: boolean;
2634
+ /**
2635
+ * Restrict auto-evolution to these skill names. Empty/omitted evolves every discovered skill. Manual `skills evolve <name>` is unaffected by this list.
2636
+ */
2637
+ skills?: Array<string>;
2638
+ /**
2639
+ * Model (provider/model) that proposes skill edits. Defaults to a strong cheap teacher.
2640
+ */
2641
+ optimizerModel?: string;
2642
+ /**
2643
+ * Gate comparison metric. 'hard' (default) = binary failure-mode coverage; 'soft' = partial-credit (sensitive to incremental edits); 'mixed' = weighted blend of both (see mixedWeight).
2644
+ */
2645
+ gateMetric?: "hard" | "soft" | "mixed";
2646
+ /**
2647
+ * For gateMetric 'mixed': weight given to soft coverage in [0,1]. Default 0.5.
2648
+ */
2649
+ mixedWeight?: number;
2650
+ /**
2651
+ * Autonomous learning-rate: scale the per-pass edit budget up/down from recent gate outcomes instead of a fixed budget. Default false (fixed budget).
2652
+ */
2653
+ autonomousLr?: boolean;
2654
+ /**
2655
+ * Epoch-level slow update: maintain a protected long-horizon guidance section in the skill that step edits can't touch. Default false.
2656
+ */
2657
+ slowUpdate?: boolean;
2658
+ /**
2659
+ * Dream rollouts + associative recall (synthetic augmentation for sparse data). Default off.
2660
+ */
2661
+ dream?: {
2662
+ /**
2663
+ * Synthesize this many contrastive variations per real replay item when held-out data is thin. >1 enables dream augmentation.
2664
+ */
2665
+ rollouts?: number;
2666
+ /**
2667
+ * Associative recall: pull the K most task-similar past items into tonight's replay set. >0 enables recall.
2668
+ */
2669
+ recallK?: number;
2670
+ };
2671
+ };
2672
+ /**
2673
+ * Suggested next prompt after each turn (experimental, side-model). Disabled by default.
2674
+ */
2675
+ promptSuggestion?: {
2676
+ /**
2677
+ * 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.
2678
+ */
2679
+ enabled?: boolean;
2680
+ /**
2681
+ * Suggestion prompt variant. 'user_intent' (default) predicts what the user would naturally type next; 'stated_intent' currently shares the same prompt.
2682
+ */
2683
+ variant?: "user_intent" | "stated_intent";
2684
+ };
1627
2685
  /**
1628
2686
  * Enable the batch tool
1629
2687
  */
1630
2688
  batch_tool?: boolean;
2689
+ /**
2690
+ * 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.
2691
+ */
2692
+ pluginIsolation?: boolean;
2693
+ /**
2694
+ * Persistent (unattended) transport retry. Disabled by default — strictly additive, interactive behavior unchanged when off.
2695
+ */
2696
+ persistentRetry?: {
2697
+ /**
2698
+ * 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.
2699
+ */
2700
+ enabled?: boolean;
2701
+ /**
2702
+ * 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.
2703
+ */
2704
+ maxWaitMs?: number;
2705
+ /**
2706
+ * 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).
2707
+ */
2708
+ maxDelayMs?: number;
2709
+ };
1631
2710
  /**
1632
2711
  * Enable OpenTelemetry spans for AI SDK calls (using the 'experimental_telemetry' flag)
1633
2712
  */
1634
2713
  openTelemetry?: boolean;
2714
+ /**
2715
+ * Opt in to the privacy-first audit/telemetry sink. Disabled by default; can be force-disabled via DO_NOT_TRACK or HUNDREDXPROMPT_TELEMETRY_DISABLE.
2716
+ */
2717
+ telemetry?: boolean;
2718
+ /**
2719
+ * Destination URL for telemetry batches. No default — self-hosted / privacy-sensitive by design.
2720
+ */
2721
+ telemetryEndpoint?: string;
2722
+ /**
2723
+ * Optional headers (e.g. auth) sent with every telemetry batch.
2724
+ */
2725
+ telemetryHeaders?: {
2726
+ [key: string]: string;
2727
+ };
2728
+ /**
2729
+ * Telemetry wire format: generic JSON batch ('json') or OTLP-compatible logs ('otlp').
2730
+ */
2731
+ telemetryMode?: "json" | "otlp";
2732
+ /**
2733
+ * Global telemetry sampling rate (0..1, default 1 = keep all). Multiplies each sink's own sampleRate to form its effective keep-probability.
2734
+ */
2735
+ telemetrySampleRate?: number;
2736
+ /**
2737
+ * 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.
2738
+ */
2739
+ telemetrySinks?: Array<{
2740
+ /**
2741
+ * Destination URL for this sink's batches. No default — self-hosted / privacy-sensitive.
2742
+ */
2743
+ endpoint: string;
2744
+ /**
2745
+ * Optional headers (e.g. auth) sent with every batch for this sink.
2746
+ */
2747
+ headers?: {
2748
+ [key: string]: string;
2749
+ };
2750
+ /**
2751
+ * Wire format for this sink: generic JSON batch ('json') or OTLP-compatible logs ('otlp').
2752
+ */
2753
+ mode?: "json" | "otlp";
2754
+ /**
2755
+ * '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.
2756
+ */
2757
+ access?: "general" | "privileged";
2758
+ /**
2759
+ * Per-sink killswitch. Default true; set false to skip this sink entirely (no payload built).
2760
+ */
2761
+ enabled?: boolean;
2762
+ /**
2763
+ * Per-sink sampling rate (0..1, default 1 = keep all).
2764
+ */
2765
+ sampleRate?: number;
2766
+ }>;
1635
2767
  /**
1636
2768
  * Tools that should only be available to primary agents.
1637
2769
  */
@@ -1640,19 +2772,42 @@ export type Config = {
1640
2772
  * Continue the agent loop when a tool call is denied
1641
2773
  */
1642
2774
  continue_loop_on_deny?: boolean;
2775
+ /**
2776
+ * 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.
2777
+ */
2778
+ verificationGate?: boolean;
1643
2779
  /**
1644
2780
  * Timeout in milliseconds for model context protocol (MCP) requests
1645
2781
  */
1646
2782
  mcp_timeout?: number;
1647
2783
  };
1648
2784
  /**
1649
- * Active output style (built-in: explanatory, learning, concise; or a custom output-styles/*.md name)
2785
+ * 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
2786
  */
1651
- output_style?: string;
2787
+ env?: {
2788
+ [key: string]: string;
2789
+ };
2790
+ /**
2791
+ * 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).
2792
+ */
2793
+ includeCoAuthoredBy?: boolean;
1652
2794
  /**
1653
2795
  * 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
2796
  */
1655
2797
  statusline?: string;
2798
+ /**
2799
+ * Ergonomics for git worktrees created by the enter_worktree tool
2800
+ */
2801
+ worktree?: {
2802
+ /**
2803
+ * 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.
2804
+ */
2805
+ sparsePaths?: Array<string>;
2806
+ /**
2807
+ * 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.
2808
+ */
2809
+ symlinkDirectories?: Array<string>;
2810
+ };
1656
2811
  };
1657
2812
  export type ToolIds = Array<string>;
1658
2813
  export type ToolListItem = {
@@ -1676,6 +2831,7 @@ export type Worktree = {
1676
2831
  export type WorktreeCreateInput = {
1677
2832
  name?: string;
1678
2833
  startCommand?: string;
2834
+ repo?: string;
1679
2835
  };
1680
2836
  export type VcsInfo = {
1681
2837
  branch: string;
@@ -1720,12 +2876,28 @@ export type SubtaskPartInput = {
1720
2876
  agent: string;
1721
2877
  command?: string;
1722
2878
  };
2879
+ export type RevertFilePreview = {
2880
+ file: string;
2881
+ action: "restore" | "delete" | "none";
2882
+ additions: number;
2883
+ deletions: number;
2884
+ dirty: boolean;
2885
+ };
2886
+ export type RevertPreview = {
2887
+ files: Array<RevertFilePreview>;
2888
+ dirty: boolean;
2889
+ };
1723
2890
  export type Command = {
1724
2891
  name: string;
1725
2892
  description?: string;
1726
2893
  agent?: string;
1727
2894
  model?: string;
1728
2895
  mcp?: boolean;
2896
+ skill?: boolean;
2897
+ plugin?: string;
2898
+ allowedTools?: Array<string>;
2899
+ argumentHint?: string;
2900
+ aliases?: Array<string>;
1729
2901
  template: string;
1730
2902
  subtask?: boolean;
1731
2903
  hints: Array<string>;
@@ -1867,6 +3039,7 @@ export type Agent = {
1867
3039
  mode: "subagent" | "primary" | "all";
1868
3040
  native?: boolean;
1869
3041
  hidden?: boolean;
3042
+ slim?: boolean;
1870
3043
  topP?: number;
1871
3044
  temperature?: number;
1872
3045
  color?: string;
@@ -1881,170 +3054,463 @@ export type Agent = {
1881
3054
  };
1882
3055
  steps?: number;
1883
3056
  };
1884
- export type McpStatusConnected = {
1885
- status: "connected";
3057
+ export type McpResource = {
3058
+ name: string;
3059
+ uri: string;
3060
+ description?: string;
3061
+ mimeType?: string;
3062
+ client: string;
1886
3063
  };
1887
- export type McpStatusDisabled = {
1888
- status: "disabled";
3064
+ export type LspStatus = {
3065
+ id: string;
3066
+ name: string;
3067
+ root: string;
3068
+ status: "connected" | "error";
1889
3069
  };
1890
- export type McpStatusFailed = {
1891
- status: "failed";
1892
- error: string;
3070
+ export type FormatterStatus = {
3071
+ name: string;
3072
+ extensions: Array<string>;
3073
+ enabled: boolean;
3074
+ };
3075
+ export type OAuth = {
3076
+ type: "oauth";
3077
+ refresh: string;
3078
+ access: string;
3079
+ expires: number;
3080
+ accountId?: string;
3081
+ enterpriseUrl?: string;
3082
+ };
3083
+ export type ApiAuth = {
3084
+ type: "api";
3085
+ key: string;
3086
+ };
3087
+ export type WellKnownAuth = {
3088
+ type: "wellknown";
3089
+ key: string;
3090
+ token: string;
3091
+ };
3092
+ export type Auth = OAuth | ApiAuth | WellKnownAuth;
3093
+ export type GlobalHealthData = {
3094
+ body?: never;
3095
+ path?: never;
3096
+ query?: never;
3097
+ url: "/global/health";
3098
+ };
3099
+ export type GlobalHealthResponses = {
3100
+ /**
3101
+ * Health information
3102
+ */
3103
+ 200: {
3104
+ healthy: true;
3105
+ version: string;
3106
+ };
3107
+ };
3108
+ export type GlobalHealthResponse = GlobalHealthResponses[keyof GlobalHealthResponses];
3109
+ export type GlobalEventData = {
3110
+ body?: never;
3111
+ path?: never;
3112
+ query?: never;
3113
+ url: "/global/event";
3114
+ };
3115
+ export type GlobalEventResponses = {
3116
+ /**
3117
+ * Event stream
3118
+ */
3119
+ 200: GlobalEvent;
3120
+ };
3121
+ export type GlobalEventResponse = GlobalEventResponses[keyof GlobalEventResponses];
3122
+ export type GlobalDisposeData = {
3123
+ body?: never;
3124
+ path?: never;
3125
+ query?: never;
3126
+ url: "/global/dispose";
3127
+ };
3128
+ export type GlobalDisposeResponses = {
3129
+ /**
3130
+ * Global disposed
3131
+ */
3132
+ 200: boolean;
3133
+ };
3134
+ export type GlobalDisposeResponse = GlobalDisposeResponses[keyof GlobalDisposeResponses];
3135
+ export type ProjectListData = {
3136
+ body?: never;
3137
+ path?: never;
3138
+ query?: {
3139
+ directory?: string;
3140
+ };
3141
+ url: "/project";
3142
+ };
3143
+ export type ProjectListResponses = {
3144
+ /**
3145
+ * List of projects
3146
+ */
3147
+ 200: Array<Project>;
3148
+ };
3149
+ export type ProjectListResponse = ProjectListResponses[keyof ProjectListResponses];
3150
+ export type ProjectCurrentData = {
3151
+ body?: never;
3152
+ path?: never;
3153
+ query?: {
3154
+ directory?: string;
3155
+ };
3156
+ url: "/project/current";
3157
+ };
3158
+ export type ProjectCurrentResponses = {
3159
+ /**
3160
+ * Current project information
3161
+ */
3162
+ 200: Project;
3163
+ };
3164
+ export type ProjectCurrentResponse = ProjectCurrentResponses[keyof ProjectCurrentResponses];
3165
+ export type ProjectUpdateData = {
3166
+ body?: {
3167
+ name?: string;
3168
+ icon?: {
3169
+ url?: string;
3170
+ color?: string;
3171
+ };
3172
+ };
3173
+ path: {
3174
+ projectID: string;
3175
+ };
3176
+ query?: {
3177
+ directory?: string;
3178
+ };
3179
+ url: "/project/{projectID}";
3180
+ };
3181
+ export type ProjectUpdateErrors = {
3182
+ /**
3183
+ * Bad request
3184
+ */
3185
+ 400: BadRequestError;
3186
+ /**
3187
+ * Not found
3188
+ */
3189
+ 404: NotFoundError;
3190
+ };
3191
+ export type ProjectUpdateError = ProjectUpdateErrors[keyof ProjectUpdateErrors];
3192
+ export type ProjectUpdateResponses = {
3193
+ /**
3194
+ * Updated project information
3195
+ */
3196
+ 200: Project;
3197
+ };
3198
+ export type ProjectUpdateResponse = ProjectUpdateResponses[keyof ProjectUpdateResponses];
3199
+ export type PluginInstalledData = {
3200
+ body?: never;
3201
+ path?: never;
3202
+ query?: {
3203
+ directory?: string;
3204
+ };
3205
+ url: "/plugin/installed";
3206
+ };
3207
+ export type PluginInstalledResponses = {
3208
+ /**
3209
+ * OK
3210
+ */
3211
+ 200: Array<InstalledPlugin>;
3212
+ };
3213
+ export type PluginInstalledResponse = PluginInstalledResponses[keyof PluginInstalledResponses];
3214
+ export type PluginDiscoverData = {
3215
+ body?: never;
3216
+ path?: never;
3217
+ query?: {
3218
+ directory?: string;
3219
+ };
3220
+ url: "/plugin/discover";
3221
+ };
3222
+ export type PluginDiscoverResponses = {
3223
+ /**
3224
+ * OK
3225
+ */
3226
+ 200: Array<DiscoverPlugin>;
3227
+ };
3228
+ export type PluginDiscoverResponse = PluginDiscoverResponses[keyof PluginDiscoverResponses];
3229
+ export type PluginMarketplacesData = {
3230
+ body?: never;
3231
+ path?: never;
3232
+ query?: {
3233
+ directory?: string;
3234
+ };
3235
+ url: "/plugin/marketplaces";
3236
+ };
3237
+ export type PluginMarketplacesResponses = {
3238
+ /**
3239
+ * OK
3240
+ */
3241
+ 200: Array<string>;
3242
+ };
3243
+ export type PluginMarketplacesResponse = PluginMarketplacesResponses[keyof PluginMarketplacesResponses];
3244
+ export type PluginErrorsData = {
3245
+ body?: never;
3246
+ path?: never;
3247
+ query?: {
3248
+ directory?: string;
3249
+ };
3250
+ url: "/plugin/errors";
3251
+ };
3252
+ export type PluginErrorsResponses = {
3253
+ /**
3254
+ * OK
3255
+ */
3256
+ 200: Array<PluginError>;
3257
+ };
3258
+ export type PluginErrorsResponse = PluginErrorsResponses[keyof PluginErrorsResponses];
3259
+ export type PluginReloadData = {
3260
+ body?: never;
3261
+ path?: never;
3262
+ query?: {
3263
+ directory?: string;
3264
+ };
3265
+ url: "/plugin/reload";
3266
+ };
3267
+ export type PluginReloadResponses = {
3268
+ /**
3269
+ * OK
3270
+ */
3271
+ 200: PluginReloadResult;
1893
3272
  };
1894
- export type McpStatusNeedsAuth = {
1895
- status: "needs_auth";
3273
+ export type PluginReloadResponse = PluginReloadResponses[keyof PluginReloadResponses];
3274
+ export type PluginInstallData = {
3275
+ body?: {
3276
+ source: string;
3277
+ };
3278
+ path?: never;
3279
+ query?: {
3280
+ directory?: string;
3281
+ };
3282
+ url: "/plugin/install";
1896
3283
  };
1897
- export type McpStatusNeedsClientRegistration = {
1898
- status: "needs_client_registration";
1899
- error: string;
3284
+ export type PluginInstallErrors = {
3285
+ /**
3286
+ * Bad request
3287
+ */
3288
+ 400: BadRequestError;
1900
3289
  };
1901
- export type McpStatusPending = {
1902
- status: "pending";
1903
- attempt: number;
3290
+ export type PluginInstallError = PluginInstallErrors[keyof PluginInstallErrors];
3291
+ export type PluginInstallResponses = {
3292
+ /**
3293
+ * OK
3294
+ */
3295
+ 200: PluginInstallResult;
1904
3296
  };
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;
3297
+ export type PluginInstallResponse = PluginInstallResponses[keyof PluginInstallResponses];
3298
+ export type PluginInstallNamedData = {
3299
+ body?: {
3300
+ name: string;
3301
+ };
3302
+ path?: never;
3303
+ query?: {
3304
+ directory?: string;
3305
+ };
3306
+ url: "/plugin/install-named";
1912
3307
  };
1913
- export type LspStatus = {
1914
- id: string;
1915
- name: string;
1916
- root: string;
1917
- status: "connected" | "error";
3308
+ export type PluginInstallNamedErrors = {
3309
+ /**
3310
+ * Bad request
3311
+ */
3312
+ 400: BadRequestError;
1918
3313
  };
1919
- export type FormatterStatus = {
1920
- name: string;
1921
- extensions: Array<string>;
1922
- enabled: boolean;
3314
+ export type PluginInstallNamedError = PluginInstallNamedErrors[keyof PluginInstallNamedErrors];
3315
+ export type PluginInstallNamedResponses = {
3316
+ /**
3317
+ * OK
3318
+ */
3319
+ 200: PluginInstallResult;
1923
3320
  };
1924
- export type OAuth = {
1925
- type: "oauth";
1926
- refresh: string;
1927
- access: string;
1928
- expires: number;
1929
- accountId?: string;
1930
- enterpriseUrl?: string;
3321
+ export type PluginInstallNamedResponse = PluginInstallNamedResponses[keyof PluginInstallNamedResponses];
3322
+ export type PluginSetEnabledData = {
3323
+ body?: {
3324
+ name: string;
3325
+ enabled: boolean;
3326
+ };
3327
+ path?: never;
3328
+ query?: {
3329
+ directory?: string;
3330
+ };
3331
+ url: "/plugin/enable";
1931
3332
  };
1932
- export type ApiAuth = {
1933
- type: "api";
1934
- key: string;
3333
+ export type PluginSetEnabledResponses = {
3334
+ /**
3335
+ * OK
3336
+ */
3337
+ 200: {
3338
+ ok: boolean;
3339
+ };
1935
3340
  };
1936
- export type WellKnownAuth = {
1937
- type: "wellknown";
1938
- key: string;
1939
- token: string;
3341
+ export type PluginSetEnabledResponse = PluginSetEnabledResponses[keyof PluginSetEnabledResponses];
3342
+ export type PluginRemoveData = {
3343
+ body?: {
3344
+ name: string;
3345
+ };
3346
+ path?: never;
3347
+ query?: {
3348
+ directory?: string;
3349
+ };
3350
+ url: "/plugin/remove";
1940
3351
  };
1941
- export type Auth = OAuth | ApiAuth | WellKnownAuth;
1942
- export type GlobalHealthData = {
1943
- body?: never;
3352
+ export type PluginRemoveResponses = {
3353
+ /**
3354
+ * OK
3355
+ */
3356
+ 200: {
3357
+ ok: boolean;
3358
+ };
3359
+ };
3360
+ export type PluginRemoveResponse = PluginRemoveResponses[keyof PluginRemoveResponses];
3361
+ export type PluginMarketplaceAddData = {
3362
+ body?: {
3363
+ source: string;
3364
+ };
1944
3365
  path?: never;
1945
- query?: never;
1946
- url: "/global/health";
3366
+ query?: {
3367
+ directory?: string;
3368
+ };
3369
+ url: "/plugin/marketplace/add";
1947
3370
  };
1948
- export type GlobalHealthResponses = {
3371
+ export type PluginMarketplaceAddResponses = {
1949
3372
  /**
1950
- * Health information
3373
+ * OK
1951
3374
  */
1952
3375
  200: {
1953
- healthy: true;
1954
- version: string;
3376
+ ok: boolean;
1955
3377
  };
1956
3378
  };
1957
- export type GlobalHealthResponse = GlobalHealthResponses[keyof GlobalHealthResponses];
1958
- export type GlobalEventData = {
1959
- body?: never;
3379
+ export type PluginMarketplaceAddResponse = PluginMarketplaceAddResponses[keyof PluginMarketplaceAddResponses];
3380
+ export type PluginMarketplaceRemoveData = {
3381
+ body?: {
3382
+ source: string;
3383
+ };
1960
3384
  path?: never;
1961
- query?: never;
1962
- url: "/global/event";
3385
+ query?: {
3386
+ directory?: string;
3387
+ };
3388
+ url: "/plugin/marketplace/remove";
1963
3389
  };
1964
- export type GlobalEventResponses = {
3390
+ export type PluginMarketplaceRemoveResponses = {
1965
3391
  /**
1966
- * Event stream
3392
+ * OK
1967
3393
  */
1968
- 200: GlobalEvent;
3394
+ 200: {
3395
+ ok: boolean;
3396
+ };
1969
3397
  };
1970
- export type GlobalEventResponse = GlobalEventResponses[keyof GlobalEventResponses];
1971
- export type GlobalDisposeData = {
3398
+ export type PluginMarketplaceRemoveResponse = PluginMarketplaceRemoveResponses[keyof PluginMarketplaceRemoveResponses];
3399
+ export type TrustStatusData = {
1972
3400
  body?: never;
1973
3401
  path?: never;
1974
- query?: never;
1975
- url: "/global/dispose";
3402
+ query?: {
3403
+ directory?: string;
3404
+ };
3405
+ url: "/trust";
1976
3406
  };
1977
- export type GlobalDisposeResponses = {
3407
+ export type TrustStatusResponses = {
1978
3408
  /**
1979
- * Global disposed
3409
+ * OK
1980
3410
  */
1981
- 200: boolean;
3411
+ 200: TrustStatus;
1982
3412
  };
1983
- export type GlobalDisposeResponse = GlobalDisposeResponses[keyof GlobalDisposeResponses];
1984
- export type ProjectListData = {
3413
+ export type TrustStatusResponse = TrustStatusResponses[keyof TrustStatusResponses];
3414
+ export type TrustOnceData = {
1985
3415
  body?: never;
1986
3416
  path?: never;
1987
3417
  query?: {
1988
3418
  directory?: string;
1989
3419
  };
1990
- url: "/project";
3420
+ url: "/trust/once";
1991
3421
  };
1992
- export type ProjectListResponses = {
3422
+ export type TrustOnceResponses = {
1993
3423
  /**
1994
- * List of projects
3424
+ * OK
1995
3425
  */
1996
- 200: Array<Project>;
3426
+ 200: TrustStatus;
1997
3427
  };
1998
- export type ProjectListResponse = ProjectListResponses[keyof ProjectListResponses];
1999
- export type ProjectCurrentData = {
3428
+ export type TrustOnceResponse = TrustOnceResponses[keyof TrustOnceResponses];
3429
+ export type TrustAlwaysData = {
2000
3430
  body?: never;
2001
3431
  path?: never;
2002
3432
  query?: {
2003
3433
  directory?: string;
2004
3434
  };
2005
- url: "/project/current";
3435
+ url: "/trust/always";
2006
3436
  };
2007
- export type ProjectCurrentResponses = {
3437
+ export type TrustAlwaysResponses = {
2008
3438
  /**
2009
- * Current project information
3439
+ * OK
2010
3440
  */
2011
- 200: Project;
3441
+ 200: TrustStatus;
2012
3442
  };
2013
- export type ProjectCurrentResponse = ProjectCurrentResponses[keyof ProjectCurrentResponses];
2014
- export type ProjectUpdateData = {
3443
+ export type TrustAlwaysResponse = TrustAlwaysResponses[keyof TrustAlwaysResponses];
3444
+ export type RemoteBridgeEnrollData = {
2015
3445
  body?: {
2016
- name?: string;
2017
- icon?: {
2018
- url?: string;
2019
- color?: string;
3446
+ device?: {
3447
+ id?: string;
3448
+ name?: string;
2020
3449
  };
3450
+ sessionID?: string;
2021
3451
  };
2022
- path: {
2023
- projectID: string;
3452
+ path?: never;
3453
+ query?: {
3454
+ directory?: string;
2024
3455
  };
3456
+ url: "/remote-bridge/enroll";
3457
+ };
3458
+ export type RemoteBridgeEnrollResponses = {
3459
+ /**
3460
+ * OK
3461
+ */
3462
+ 200: RemoteBridgeEnrollment;
3463
+ };
3464
+ export type RemoteBridgeEnrollResponse = RemoteBridgeEnrollResponses[keyof RemoteBridgeEnrollResponses];
3465
+ export type RemoteBridgeDevicesData = {
3466
+ body?: never;
3467
+ path?: never;
2025
3468
  query?: {
2026
3469
  directory?: string;
2027
3470
  };
2028
- url: "/project/{projectID}";
3471
+ url: "/remote-bridge/devices";
2029
3472
  };
2030
- export type ProjectUpdateErrors = {
3473
+ export type RemoteBridgeDevicesResponses = {
2031
3474
  /**
2032
- * Bad request
3475
+ * OK
2033
3476
  */
2034
- 400: BadRequestError;
3477
+ 200: Array<RemoteBridgeDevice>;
3478
+ };
3479
+ export type RemoteBridgeDevicesResponse = RemoteBridgeDevicesResponses[keyof RemoteBridgeDevicesResponses];
3480
+ export type RemoteBridgeRevokeData = {
3481
+ body?: never;
3482
+ path: {
3483
+ deviceID: string;
3484
+ };
3485
+ query?: {
3486
+ directory?: string;
3487
+ };
3488
+ url: "/remote-bridge/devices/{deviceID}/revoke";
3489
+ };
3490
+ export type RemoteBridgeRevokeResponses = {
2035
3491
  /**
2036
- * Not found
3492
+ * OK
2037
3493
  */
2038
- 404: NotFoundError;
3494
+ 200: {
3495
+ revoked: boolean;
3496
+ };
2039
3497
  };
2040
- export type ProjectUpdateError = ProjectUpdateErrors[keyof ProjectUpdateErrors];
2041
- export type ProjectUpdateResponses = {
3498
+ export type RemoteBridgeRevokeResponse = RemoteBridgeRevokeResponses[keyof RemoteBridgeRevokeResponses];
3499
+ export type RemoteBridgeConnectData = {
3500
+ body?: never;
3501
+ path?: never;
3502
+ query?: {
3503
+ directory?: string;
3504
+ };
3505
+ url: "/remote-bridge/ws";
3506
+ };
3507
+ export type RemoteBridgeConnectResponses = {
2042
3508
  /**
2043
- * Updated project information
3509
+ * OK
2044
3510
  */
2045
- 200: Project;
3511
+ 200: boolean;
2046
3512
  };
2047
- export type ProjectUpdateResponse = ProjectUpdateResponses[keyof ProjectUpdateResponses];
3513
+ export type RemoteBridgeConnectResponse = RemoteBridgeConnectResponses[keyof RemoteBridgeConnectResponses];
2048
3514
  export type PtyListData = {
2049
3515
  body?: never;
2050
3516
  path?: never;
@@ -2374,6 +3840,14 @@ export type SessionListData = {
2374
3840
  * Maximum number of sessions to return
2375
3841
  */
2376
3842
  limit?: number;
3843
+ /**
3844
+ * Include archived sessions in results (default false)
3845
+ */
3846
+ include_archived?: boolean;
3847
+ /**
3848
+ * Also search session message content when a search term is provided (default false)
3849
+ */
3850
+ search_content?: boolean;
2377
3851
  };
2378
3852
  url: "/session";
2379
3853
  };
@@ -2386,6 +3860,7 @@ export type SessionListResponses = {
2386
3860
  export type SessionListResponse = SessionListResponses[keyof SessionListResponses];
2387
3861
  export type SessionCreateData = {
2388
3862
  body?: {
3863
+ id?: string;
2389
3864
  parentID?: string;
2390
3865
  title?: string;
2391
3866
  permission?: PermissionRuleset;
@@ -2724,9 +4199,6 @@ export type SessionShareResponse = SessionShareResponses[keyof SessionShareRespo
2724
4199
  export type SessionDiffData = {
2725
4200
  body?: never;
2726
4201
  path: {
2727
- /**
2728
- * Session ID
2729
- */
2730
4202
  sessionID: string;
2731
4203
  };
2732
4204
  query?: {
@@ -2758,6 +4230,10 @@ export type SessionSummarizeData = {
2758
4230
  providerID: string;
2759
4231
  modelID: string;
2760
4232
  auto?: boolean;
4233
+ /**
4234
+ * Focus instructions for the summarizer (from `/compact <text>`)
4235
+ */
4236
+ customInstructions?: string;
2761
4237
  };
2762
4238
  path: {
2763
4239
  /**
@@ -2839,7 +4315,19 @@ export type SessionPromptData = {
2839
4315
  [key: string]: boolean;
2840
4316
  };
2841
4317
  system?: string;
4318
+ /**
4319
+ * Replace the session's assembled system prompt for this turn (CC --system-prompt). Wins over `system`.
4320
+ */
4321
+ systemOverride?: string;
2842
4322
  variant?: string;
4323
+ /**
4324
+ * Run this session in kairos (background tick) mode: registers the sleep tool and the kairos prompt discipline. Sticky until explicitly set to false
4325
+ */
4326
+ kairos?: boolean;
4327
+ /**
4328
+ * Whether the user's terminal is currently focused; drives kairos focus-aware autonomy
4329
+ */
4330
+ terminalFocus?: boolean;
2843
4331
  parts: Array<TextPartInput | FilePartInput | AgentPartInput | SubtaskPartInput>;
2844
4332
  };
2845
4333
  path: {
@@ -3006,7 +4494,19 @@ export type SessionPromptAsyncData = {
3006
4494
  [key: string]: boolean;
3007
4495
  };
3008
4496
  system?: string;
4497
+ /**
4498
+ * Replace the session's assembled system prompt for this turn (CC --system-prompt). Wins over `system`.
4499
+ */
4500
+ systemOverride?: string;
3009
4501
  variant?: string;
4502
+ /**
4503
+ * Run this session in kairos (background tick) mode: registers the sleep tool and the kairos prompt discipline. Sticky until explicitly set to false
4504
+ */
4505
+ kairos?: boolean;
4506
+ /**
4507
+ * Whether the user's terminal is currently focused; drives kairos focus-aware autonomy
4508
+ */
4509
+ terminalFocus?: boolean;
3010
4510
  parts: Array<TextPartInput | FilePartInput | AgentPartInput | SubtaskPartInput>;
3011
4511
  };
3012
4512
  path: {
@@ -3129,6 +4629,7 @@ export type SessionRevertData = {
3129
4629
  body?: {
3130
4630
  messageID: string;
3131
4631
  partID?: string;
4632
+ mode?: "both" | "conversation" | "files";
3132
4633
  };
3133
4634
  path: {
3134
4635
  sessionID: string;
@@ -3156,6 +4657,38 @@ export type SessionRevertResponses = {
3156
4657
  200: Session;
3157
4658
  };
3158
4659
  export type SessionRevertResponse = SessionRevertResponses[keyof SessionRevertResponses];
4660
+ export type SessionRevertPreviewData = {
4661
+ body?: {
4662
+ messageID: string;
4663
+ partID?: string;
4664
+ mode?: "both" | "conversation" | "files";
4665
+ };
4666
+ path: {
4667
+ sessionID: string;
4668
+ };
4669
+ query?: {
4670
+ directory?: string;
4671
+ };
4672
+ url: "/session/{sessionID}/revert/preview";
4673
+ };
4674
+ export type SessionRevertPreviewErrors = {
4675
+ /**
4676
+ * Bad request
4677
+ */
4678
+ 400: BadRequestError;
4679
+ /**
4680
+ * Not found
4681
+ */
4682
+ 404: NotFoundError;
4683
+ };
4684
+ export type SessionRevertPreviewError = SessionRevertPreviewErrors[keyof SessionRevertPreviewErrors];
4685
+ export type SessionRevertPreviewResponses = {
4686
+ /**
4687
+ * Revert preview
4688
+ */
4689
+ 200: RevertPreview;
4690
+ };
4691
+ export type SessionRevertPreviewResponse = SessionRevertPreviewResponses[keyof SessionRevertPreviewResponses];
3159
4692
  export type SessionUnrevertData = {
3160
4693
  body?: never;
3161
4694
  path: {
@@ -3184,6 +4717,39 @@ export type SessionUnrevertResponses = {
3184
4717
  200: Session;
3185
4718
  };
3186
4719
  export type SessionUnrevertResponse = SessionUnrevertResponses[keyof SessionUnrevertResponses];
4720
+ export type SessionFeedbackData = {
4721
+ body?: {
4722
+ explicit: "up" | "down";
4723
+ };
4724
+ path: {
4725
+ sessionID: string;
4726
+ };
4727
+ query?: {
4728
+ directory?: string;
4729
+ };
4730
+ url: "/session/{sessionID}/feedback";
4731
+ };
4732
+ export type SessionFeedbackErrors = {
4733
+ /**
4734
+ * Bad request
4735
+ */
4736
+ 400: BadRequestError;
4737
+ /**
4738
+ * Not found
4739
+ */
4740
+ 404: NotFoundError;
4741
+ };
4742
+ export type SessionFeedbackError = SessionFeedbackErrors[keyof SessionFeedbackErrors];
4743
+ export type SessionFeedbackResponses = {
4744
+ /**
4745
+ * Feedback accepted
4746
+ */
4747
+ 200: {
4748
+ ok: boolean;
4749
+ matched: boolean;
4750
+ };
4751
+ };
4752
+ export type SessionFeedbackResponse = SessionFeedbackResponses[keyof SessionFeedbackResponses];
3187
4753
  export type PermissionRespondData = {
3188
4754
  body?: {
3189
4755
  response: "once" | "always" | "reject";
@@ -3879,6 +5445,13 @@ export type McpConnectData = {
3879
5445
  };
3880
5446
  url: "/mcp/{name}/connect";
3881
5447
  };
5448
+ export type McpConnectErrors = {
5449
+ /**
5450
+ * Not found
5451
+ */
5452
+ 404: NotFoundError;
5453
+ };
5454
+ export type McpConnectError = McpConnectErrors[keyof McpConnectErrors];
3882
5455
  export type McpConnectResponses = {
3883
5456
  /**
3884
5457
  * MCP server connected successfully