@adecore/agent-contracts 0.21.2 → 0.22.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/dist/chat.d.ts +110 -0
  2. package/dist/chat.js +14 -2
  3. package/dist/model.d.ts +5 -0
  4. package/dist/model.js +8 -2
  5. package/dist/protocol.d.ts +80 -0
  6. package/package.json +2 -2
  7. package/src/chat.ts +17 -2
  8. package/src/model.ts +8 -2
package/dist/chat.d.ts CHANGED
@@ -76,6 +76,10 @@ export declare const ChatUiAnswerSchema: z.ZodObject<{
76
76
  turnId: z.ZodString;
77
77
  }, z.core.$strip>;
78
78
  export type ChatUiAnswer = z.infer<typeof ChatUiAnswerSchema>;
79
+ export declare const ChatQuoteSourceSchema: z.ZodObject<{
80
+ itemId: z.ZodString;
81
+ }, z.core.$strip>;
82
+ export type ChatQuoteSource = z.infer<typeof ChatQuoteSourceSchema>;
79
83
  export declare const ChatQueuedMessageSchema: z.ZodObject<{
80
84
  id: z.ZodString;
81
85
  turnId: z.ZodOptional<z.ZodString>;
@@ -104,6 +108,9 @@ export declare const ChatQueuedMessageSchema: z.ZodObject<{
104
108
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
105
109
  at: z.ZodNumber;
106
110
  }, z.core.$strip>>;
111
+ quoteSource: z.ZodOptional<z.ZodObject<{
112
+ itemId: z.ZodString;
113
+ }, z.core.$strip>>;
107
114
  }, z.core.$strip>;
108
115
  export type ChatQueuedMessage = z.infer<typeof ChatQueuedMessageSchema>;
109
116
  export declare const ChatBackgroundTaskSchema: z.ZodObject<{
@@ -276,6 +283,9 @@ export declare const ChatInfoSchema: z.ZodObject<{
276
283
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
277
284
  at: z.ZodNumber;
278
285
  }, z.core.$strip>>;
286
+ quoteSource: z.ZodOptional<z.ZodObject<{
287
+ itemId: z.ZodString;
288
+ }, z.core.$strip>>;
279
289
  }, z.core.$strip>>>;
280
290
  queuePaused: z.ZodOptional<z.ZodBoolean>;
281
291
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -418,6 +428,9 @@ export declare const ChatUserItemSchema: z.ZodObject<{
418
428
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
419
429
  at: z.ZodNumber;
420
430
  }, z.core.$strip>>;
431
+ quoteSource: z.ZodOptional<z.ZodObject<{
432
+ itemId: z.ZodString;
433
+ }, z.core.$strip>>;
421
434
  }, z.core.$strip>;
422
435
  export declare const ChatUiQueryReadingSchema: z.ZodObject<{
423
436
  state: z.ZodEnum<{
@@ -877,6 +890,8 @@ export declare const ChatTurnItemSchema: z.ZodObject<{
877
890
  endedAt: z.ZodNullable<z.ZodNumber>;
878
891
  costUsd: z.ZodNumber;
879
892
  checkpoint: z.ZodOptional<z.ZodString>;
893
+ checkpointHead: z.ZodOptional<z.ZodString>;
894
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
880
895
  checkpointDiff: z.ZodOptional<z.ZodObject<{
881
896
  files: z.ZodArray<z.ZodObject<{
882
897
  path: z.ZodString;
@@ -924,6 +939,7 @@ export declare function abortedByMachine(turn: {
924
939
  level?: string;
925
940
  text?: string;
926
941
  }[]): boolean;
942
+ export declare const WAITING_NOTE_PREFIX = "waiting-";
927
943
  export declare const ChatNoteItemSchema: z.ZodObject<{
928
944
  id: z.ZodString;
929
945
  createdAt: z.ZodNumber;
@@ -973,6 +989,9 @@ export declare const ChatItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
973
989
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
974
990
  at: z.ZodNumber;
975
991
  }, z.core.$strip>>;
992
+ quoteSource: z.ZodOptional<z.ZodObject<{
993
+ itemId: z.ZodString;
994
+ }, z.core.$strip>>;
976
995
  }, z.core.$strip>, z.ZodObject<{
977
996
  id: z.ZodString;
978
997
  createdAt: z.ZodNumber;
@@ -1209,6 +1228,8 @@ export declare const ChatItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1209
1228
  endedAt: z.ZodNullable<z.ZodNumber>;
1210
1229
  costUsd: z.ZodNumber;
1211
1230
  checkpoint: z.ZodOptional<z.ZodString>;
1231
+ checkpointHead: z.ZodOptional<z.ZodString>;
1232
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
1212
1233
  checkpointDiff: z.ZodOptional<z.ZodObject<{
1213
1234
  files: z.ZodArray<z.ZodObject<{
1214
1235
  path: z.ZodString;
@@ -1306,6 +1327,9 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1306
1327
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1307
1328
  at: z.ZodNumber;
1308
1329
  }, z.core.$strip>>;
1330
+ quoteSource: z.ZodOptional<z.ZodObject<{
1331
+ itemId: z.ZodString;
1332
+ }, z.core.$strip>>;
1309
1333
  }, z.core.$strip>, z.ZodObject<{
1310
1334
  id: z.ZodString;
1311
1335
  createdAt: z.ZodNumber;
@@ -1542,6 +1566,8 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1542
1566
  endedAt: z.ZodNullable<z.ZodNumber>;
1543
1567
  costUsd: z.ZodNumber;
1544
1568
  checkpoint: z.ZodOptional<z.ZodString>;
1569
+ checkpointHead: z.ZodOptional<z.ZodString>;
1570
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
1545
1571
  checkpointDiff: z.ZodOptional<z.ZodObject<{
1546
1572
  files: z.ZodArray<z.ZodObject<{
1547
1573
  path: z.ZodString;
@@ -1723,6 +1749,9 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1723
1749
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1724
1750
  at: z.ZodNumber;
1725
1751
  }, z.core.$strip>>;
1752
+ quoteSource: z.ZodOptional<z.ZodObject<{
1753
+ itemId: z.ZodString;
1754
+ }, z.core.$strip>>;
1726
1755
  }, z.core.$strip>>>;
1727
1756
  queuePaused: z.ZodOptional<z.ZodBoolean>;
1728
1757
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1874,6 +1903,9 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1874
1903
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1875
1904
  at: z.ZodNumber;
1876
1905
  }, z.core.$strip>>;
1906
+ quoteSource: z.ZodOptional<z.ZodObject<{
1907
+ itemId: z.ZodString;
1908
+ }, z.core.$strip>>;
1877
1909
  }, z.core.$strip>>>;
1878
1910
  queuePaused: z.ZodOptional<z.ZodBoolean>;
1879
1911
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1983,6 +2015,9 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1983
2015
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1984
2016
  at: z.ZodNumber;
1985
2017
  }, z.core.$strip>>;
2018
+ quoteSource: z.ZodOptional<z.ZodObject<{
2019
+ itemId: z.ZodString;
2020
+ }, z.core.$strip>>;
1986
2021
  }, z.core.$strip>, z.ZodObject<{
1987
2022
  id: z.ZodString;
1988
2023
  createdAt: z.ZodNumber;
@@ -2219,6 +2254,8 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2219
2254
  endedAt: z.ZodNullable<z.ZodNumber>;
2220
2255
  costUsd: z.ZodNumber;
2221
2256
  checkpoint: z.ZodOptional<z.ZodString>;
2257
+ checkpointHead: z.ZodOptional<z.ZodString>;
2258
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
2222
2259
  checkpointDiff: z.ZodOptional<z.ZodObject<{
2223
2260
  files: z.ZodArray<z.ZodObject<{
2224
2261
  path: z.ZodString;
@@ -2309,6 +2346,9 @@ export declare const ChatEventEnvelopeSchema: z.ZodObject<{
2309
2346
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2310
2347
  at: z.ZodNumber;
2311
2348
  }, z.core.$strip>>;
2349
+ quoteSource: z.ZodOptional<z.ZodObject<{
2350
+ itemId: z.ZodString;
2351
+ }, z.core.$strip>>;
2312
2352
  }, z.core.$strip>, z.ZodObject<{
2313
2353
  id: z.ZodString;
2314
2354
  createdAt: z.ZodNumber;
@@ -2545,6 +2585,8 @@ export declare const ChatEventEnvelopeSchema: z.ZodObject<{
2545
2585
  endedAt: z.ZodNullable<z.ZodNumber>;
2546
2586
  costUsd: z.ZodNumber;
2547
2587
  checkpoint: z.ZodOptional<z.ZodString>;
2588
+ checkpointHead: z.ZodOptional<z.ZodString>;
2589
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
2548
2590
  checkpointDiff: z.ZodOptional<z.ZodObject<{
2549
2591
  files: z.ZodArray<z.ZodObject<{
2550
2592
  path: z.ZodString;
@@ -2726,6 +2768,9 @@ export declare const ChatEventEnvelopeSchema: z.ZodObject<{
2726
2768
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2727
2769
  at: z.ZodNumber;
2728
2770
  }, z.core.$strip>>;
2771
+ quoteSource: z.ZodOptional<z.ZodObject<{
2772
+ itemId: z.ZodString;
2773
+ }, z.core.$strip>>;
2729
2774
  }, z.core.$strip>>>;
2730
2775
  queuePaused: z.ZodOptional<z.ZodBoolean>;
2731
2776
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -2877,6 +2922,9 @@ export declare const ChatEventEnvelopeSchema: z.ZodObject<{
2877
2922
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2878
2923
  at: z.ZodNumber;
2879
2924
  }, z.core.$strip>>;
2925
+ quoteSource: z.ZodOptional<z.ZodObject<{
2926
+ itemId: z.ZodString;
2927
+ }, z.core.$strip>>;
2880
2928
  }, z.core.$strip>>>;
2881
2929
  queuePaused: z.ZodOptional<z.ZodBoolean>;
2882
2930
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -2986,6 +3034,9 @@ export declare const ChatEventEnvelopeSchema: z.ZodObject<{
2986
3034
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2987
3035
  at: z.ZodNumber;
2988
3036
  }, z.core.$strip>>;
3037
+ quoteSource: z.ZodOptional<z.ZodObject<{
3038
+ itemId: z.ZodString;
3039
+ }, z.core.$strip>>;
2989
3040
  }, z.core.$strip>, z.ZodObject<{
2990
3041
  id: z.ZodString;
2991
3042
  createdAt: z.ZodNumber;
@@ -3222,6 +3273,8 @@ export declare const ChatEventEnvelopeSchema: z.ZodObject<{
3222
3273
  endedAt: z.ZodNullable<z.ZodNumber>;
3223
3274
  costUsd: z.ZodNumber;
3224
3275
  checkpoint: z.ZodOptional<z.ZodString>;
3276
+ checkpointHead: z.ZodOptional<z.ZodString>;
3277
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
3225
3278
  checkpointDiff: z.ZodOptional<z.ZodObject<{
3226
3279
  files: z.ZodArray<z.ZodObject<{
3227
3280
  path: z.ZodString;
@@ -3412,6 +3465,9 @@ export declare const ChatHistoryResultSchema: z.ZodObject<{
3412
3465
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3413
3466
  at: z.ZodNumber;
3414
3467
  }, z.core.$strip>>;
3468
+ quoteSource: z.ZodOptional<z.ZodObject<{
3469
+ itemId: z.ZodString;
3470
+ }, z.core.$strip>>;
3415
3471
  }, z.core.$strip>, z.ZodObject<{
3416
3472
  id: z.ZodString;
3417
3473
  createdAt: z.ZodNumber;
@@ -3648,6 +3704,8 @@ export declare const ChatHistoryResultSchema: z.ZodObject<{
3648
3704
  endedAt: z.ZodNullable<z.ZodNumber>;
3649
3705
  costUsd: z.ZodNumber;
3650
3706
  checkpoint: z.ZodOptional<z.ZodString>;
3707
+ checkpointHead: z.ZodOptional<z.ZodString>;
3708
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
3651
3709
  checkpointDiff: z.ZodOptional<z.ZodObject<{
3652
3710
  files: z.ZodArray<z.ZodObject<{
3653
3711
  path: z.ZodString;
@@ -3766,6 +3824,9 @@ export declare const ChatSubagentResultSchema: z.ZodObject<{
3766
3824
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3767
3825
  at: z.ZodNumber;
3768
3826
  }, z.core.$strip>>;
3827
+ quoteSource: z.ZodOptional<z.ZodObject<{
3828
+ itemId: z.ZodString;
3829
+ }, z.core.$strip>>;
3769
3830
  }, z.core.$strip>, z.ZodObject<{
3770
3831
  id: z.ZodString;
3771
3832
  createdAt: z.ZodNumber;
@@ -4002,6 +4063,8 @@ export declare const ChatSubagentResultSchema: z.ZodObject<{
4002
4063
  endedAt: z.ZodNullable<z.ZodNumber>;
4003
4064
  costUsd: z.ZodNumber;
4004
4065
  checkpoint: z.ZodOptional<z.ZodString>;
4066
+ checkpointHead: z.ZodOptional<z.ZodString>;
4067
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
4005
4068
  checkpointDiff: z.ZodOptional<z.ZodObject<{
4006
4069
  files: z.ZodArray<z.ZodObject<{
4007
4070
  path: z.ZodString;
@@ -4197,6 +4260,9 @@ export declare const ChatStatusEventSchema: z.ZodObject<{
4197
4260
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4198
4261
  at: z.ZodNumber;
4199
4262
  }, z.core.$strip>>;
4263
+ quoteSource: z.ZodOptional<z.ZodObject<{
4264
+ itemId: z.ZodString;
4265
+ }, z.core.$strip>>;
4200
4266
  }, z.core.$strip>>>;
4201
4267
  queuePaused: z.ZodOptional<z.ZodBoolean>;
4202
4268
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -4446,6 +4512,9 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
4446
4512
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4447
4513
  at: z.ZodNumber;
4448
4514
  }, z.core.$strip>>;
4515
+ quoteSource: z.ZodOptional<z.ZodObject<{
4516
+ itemId: z.ZodString;
4517
+ }, z.core.$strip>>;
4449
4518
  }, z.core.$strip>>>;
4450
4519
  queuePaused: z.ZodOptional<z.ZodBoolean>;
4451
4520
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -4555,6 +4624,9 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
4555
4624
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4556
4625
  at: z.ZodNumber;
4557
4626
  }, z.core.$strip>>;
4627
+ quoteSource: z.ZodOptional<z.ZodObject<{
4628
+ itemId: z.ZodString;
4629
+ }, z.core.$strip>>;
4558
4630
  }, z.core.$strip>, z.ZodObject<{
4559
4631
  id: z.ZodString;
4560
4632
  createdAt: z.ZodNumber;
@@ -4791,6 +4863,8 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
4791
4863
  endedAt: z.ZodNullable<z.ZodNumber>;
4792
4864
  costUsd: z.ZodNumber;
4793
4865
  checkpoint: z.ZodOptional<z.ZodString>;
4866
+ checkpointHead: z.ZodOptional<z.ZodString>;
4867
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
4794
4868
  checkpointDiff: z.ZodOptional<z.ZodObject<{
4795
4869
  files: z.ZodArray<z.ZodObject<{
4796
4870
  path: z.ZodString;
@@ -4879,6 +4953,9 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
4879
4953
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4880
4954
  at: z.ZodNumber;
4881
4955
  }, z.core.$strip>>;
4956
+ quoteSource: z.ZodOptional<z.ZodObject<{
4957
+ itemId: z.ZodString;
4958
+ }, z.core.$strip>>;
4882
4959
  }, z.core.$strip>, z.ZodObject<{
4883
4960
  id: z.ZodString;
4884
4961
  createdAt: z.ZodNumber;
@@ -5115,6 +5192,8 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
5115
5192
  endedAt: z.ZodNullable<z.ZodNumber>;
5116
5193
  costUsd: z.ZodNumber;
5117
5194
  checkpoint: z.ZodOptional<z.ZodString>;
5195
+ checkpointHead: z.ZodOptional<z.ZodString>;
5196
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
5118
5197
  checkpointDiff: z.ZodOptional<z.ZodObject<{
5119
5198
  files: z.ZodArray<z.ZodObject<{
5120
5199
  path: z.ZodString;
@@ -5202,6 +5281,9 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
5202
5281
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
5203
5282
  at: z.ZodNumber;
5204
5283
  }, z.core.$strip>>;
5284
+ quoteSource: z.ZodOptional<z.ZodObject<{
5285
+ itemId: z.ZodString;
5286
+ }, z.core.$strip>>;
5205
5287
  }, z.core.$strip>, z.ZodObject<{
5206
5288
  id: z.ZodString;
5207
5289
  createdAt: z.ZodNumber;
@@ -5438,6 +5520,8 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
5438
5520
  endedAt: z.ZodNullable<z.ZodNumber>;
5439
5521
  costUsd: z.ZodNumber;
5440
5522
  checkpoint: z.ZodOptional<z.ZodString>;
5523
+ checkpointHead: z.ZodOptional<z.ZodString>;
5524
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
5441
5525
  checkpointDiff: z.ZodOptional<z.ZodObject<{
5442
5526
  files: z.ZodArray<z.ZodObject<{
5443
5527
  path: z.ZodString;
@@ -5619,6 +5703,9 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
5619
5703
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
5620
5704
  at: z.ZodNumber;
5621
5705
  }, z.core.$strip>>;
5706
+ quoteSource: z.ZodOptional<z.ZodObject<{
5707
+ itemId: z.ZodString;
5708
+ }, z.core.$strip>>;
5622
5709
  }, z.core.$strip>>>;
5623
5710
  queuePaused: z.ZodOptional<z.ZodBoolean>;
5624
5711
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -5770,6 +5857,9 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
5770
5857
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
5771
5858
  at: z.ZodNumber;
5772
5859
  }, z.core.$strip>>;
5860
+ quoteSource: z.ZodOptional<z.ZodObject<{
5861
+ itemId: z.ZodString;
5862
+ }, z.core.$strip>>;
5773
5863
  }, z.core.$strip>>>;
5774
5864
  queuePaused: z.ZodOptional<z.ZodBoolean>;
5775
5865
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -5879,6 +5969,9 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
5879
5969
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
5880
5970
  at: z.ZodNumber;
5881
5971
  }, z.core.$strip>>;
5972
+ quoteSource: z.ZodOptional<z.ZodObject<{
5973
+ itemId: z.ZodString;
5974
+ }, z.core.$strip>>;
5882
5975
  }, z.core.$strip>, z.ZodObject<{
5883
5976
  id: z.ZodString;
5884
5977
  createdAt: z.ZodNumber;
@@ -6115,6 +6208,8 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
6115
6208
  endedAt: z.ZodNullable<z.ZodNumber>;
6116
6209
  costUsd: z.ZodNumber;
6117
6210
  checkpoint: z.ZodOptional<z.ZodString>;
6211
+ checkpointHead: z.ZodOptional<z.ZodString>;
6212
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
6118
6213
  checkpointDiff: z.ZodOptional<z.ZodObject<{
6119
6214
  files: z.ZodArray<z.ZodObject<{
6120
6215
  path: z.ZodString;
@@ -6207,6 +6302,9 @@ export declare const ChatSendPayloadSchema: z.ZodObject<{
6207
6302
  mentions: z.ZodOptional<z.ZodArray<z.ZodString>>;
6208
6303
  skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
6209
6304
  chats: z.ZodOptional<z.ZodArray<z.ZodString>>;
6305
+ quoteSource: z.ZodOptional<z.ZodObject<{
6306
+ itemId: z.ZodString;
6307
+ }, z.core.$strip>>;
6210
6308
  attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
6211
6309
  name: z.ZodString;
6212
6310
  mime: z.ZodString;
@@ -6282,6 +6380,9 @@ export declare const ChatUnqueueResultSchema: z.ZodObject<{
6282
6380
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6283
6381
  at: z.ZodNumber;
6284
6382
  }, z.core.$strip>>;
6383
+ quoteSource: z.ZodOptional<z.ZodObject<{
6384
+ itemId: z.ZodString;
6385
+ }, z.core.$strip>>;
6285
6386
  }, z.core.$strip>>;
6286
6387
  }, z.core.$strip>;
6287
6388
  export type ChatUnqueueResult = z.infer<typeof ChatUnqueueResultSchema>;
@@ -6428,6 +6529,9 @@ export declare const ChatForkResultSchema: z.ZodObject<{
6428
6529
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6429
6530
  at: z.ZodNumber;
6430
6531
  }, z.core.$strip>>;
6532
+ quoteSource: z.ZodOptional<z.ZodObject<{
6533
+ itemId: z.ZodString;
6534
+ }, z.core.$strip>>;
6431
6535
  }, z.core.$strip>>>;
6432
6536
  queuePaused: z.ZodOptional<z.ZodBoolean>;
6433
6537
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -6610,6 +6714,9 @@ export declare const ChatContinueOnResultSchema: z.ZodObject<{
6610
6714
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6611
6715
  at: z.ZodNumber;
6612
6716
  }, z.core.$strip>>;
6717
+ quoteSource: z.ZodOptional<z.ZodObject<{
6718
+ itemId: z.ZodString;
6719
+ }, z.core.$strip>>;
6613
6720
  }, z.core.$strip>>>;
6614
6721
  queuePaused: z.ZodOptional<z.ZodBoolean>;
6615
6722
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -6806,6 +6913,9 @@ export declare const ChatListResultSchema: z.ZodObject<{
6806
6913
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6807
6914
  at: z.ZodNumber;
6808
6915
  }, z.core.$strip>>;
6916
+ quoteSource: z.ZodOptional<z.ZodObject<{
6917
+ itemId: z.ZodString;
6918
+ }, z.core.$strip>>;
6809
6919
  }, z.core.$strip>>>;
6810
6920
  queuePaused: z.ZodOptional<z.ZodBoolean>;
6811
6921
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
package/dist/chat.js CHANGED
@@ -104,6 +104,8 @@ export const ChatUiAnswerSchema = ChatUiChoiceOriginSchema.extend({
104
104
  turnId: z.string().min(1)
105
105
  });
106
106
  // A message typed while a turn was running; the daemon sends it when that turn settles.
107
+ /* The reply a quoted passage was taken from, so a client can lead the reader back to it. */
108
+ export const ChatQuoteSourceSchema = z.object({ itemId: z.string().min(1).max(256) });
107
109
  export const ChatQueuedMessageSchema = z.object({
108
110
  id: z.string().min(1),
109
111
  // Older saved queues have no reserved turn yet; draining them still mints one.
@@ -114,7 +116,8 @@ export const ChatQueuedMessageSchema = z.object({
114
116
  chats: z.array(z.string()).optional(),
115
117
  attachments: z.array(ChatAttachmentSchema).optional(),
116
118
  createdAt: z.number(),
117
- uiChoice: ChatUiChoiceOriginSchema.optional()
119
+ uiChoice: ChatUiChoiceOriginSchema.optional(),
120
+ quoteSource: ChatQuoteSourceSchema.optional()
118
121
  });
119
122
  // A command or a monitor the CLI keeps running beside its turns, until it ends or its process does.
120
123
  export const ChatBackgroundTaskSchema = z.object({
@@ -259,7 +262,9 @@ export const ChatUserItemSchema = z.object({
259
262
  // Chats of the same project the person picked with `@`. Only their ids travel; the agent reads them itself.
260
263
  chats: z.array(z.string()).optional(),
261
264
  attachments: z.array(ChatAttachmentSchema).optional(),
262
- uiChoice: ChatUiChoiceOriginSchema.optional()
265
+ uiChoice: ChatUiChoiceOriginSchema.optional(),
266
+ // The reply the quote at the head of the text was taken from; absent when it names none or the reply is gone.
267
+ quoteSource: ChatQuoteSourceSchema.optional()
263
268
  });
264
269
  // `state` is a frozen set: native clients validate these payloads whole, so a new state would fail them.
265
270
  export const ChatUiQueryReadingSchema = z.object({
@@ -471,6 +476,10 @@ export const ChatTurnItemSchema = z.object({
471
476
  costUsd: z.number().nonnegative(),
472
477
  // The git tree of the chat's folder when the turn started; absent outside a repository.
473
478
  checkpoint: z.string().optional(),
479
+ // The commit HEAD pointed at when the turn started, and when it settled; absent when unborn or outside git.
480
+ // Two that differ mean the branch moved during the turn, so the checkpoint diff holds more than the agent's work.
481
+ checkpointHead: z.string().optional(),
482
+ checkpointHeadAfter: z.string().optional(),
474
483
  // What the working tree holds against that checkpoint, taken when the turn settled.
475
484
  checkpointDiff: ChatCheckpointDiffSchema.optional(),
476
485
  // How many CLI processes worked on this turn; absent is one, which is every turn before this field.
@@ -502,6 +511,8 @@ export function abortedByMachine(turn, items) {
502
511
  return (turn.state === 'aborted' &&
503
512
  items.some((item) => item.kind === 'note' && item.turnId === turn.id && item.level === 'warning' && item.text?.startsWith(NOT_RESUMED_PREFIX) === true));
504
513
  }
514
+ /* The id prefix of the note a host leaves in a parent about a child that waits on a request. */
515
+ export const WAITING_NOTE_PREFIX = 'waiting-';
505
516
  export const ChatNoteItemSchema = z.object({
506
517
  ...base,
507
518
  kind: z.literal('note'),
@@ -703,6 +714,7 @@ export const ChatSendPayloadSchema = z
703
714
  mentions: z.array(z.string().min(1)).max(64).optional(),
704
715
  skills: z.array(z.string().min(1)).max(16).optional(),
705
716
  chats: z.array(ChatIdSchema).max(16).optional(),
717
+ quoteSource: ChatQuoteSourceSchema.optional(),
706
718
  attachments: ChatAttachmentUploadsSchema.optional()
707
719
  })
708
720
  .refine((payload) => payload.text.trim() !== '' || (payload.attachments?.length ?? 0) > 0, { message: 'A message needs text or an attachment' });
package/dist/model.d.ts CHANGED
@@ -46,6 +46,7 @@ export declare const ModelInfoSchema: z.ZodObject<{
46
46
  defaultValue: z.ZodBoolean;
47
47
  description: z.ZodOptional<z.ZodString>;
48
48
  }, z.core.$strip>], "type">>;
49
+ minCliVersion: z.ZodOptional<z.ZodString>;
49
50
  }, z.core.$strip>;
50
51
  export type ModelInfo = z.infer<typeof ModelInfoSchema>;
51
52
  export declare const ModelSelectionSchema: z.ZodObject<{
@@ -81,6 +82,7 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
81
82
  profile: z.ZodString;
82
83
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
83
84
  legacy: z.ZodOptional<z.ZodBoolean>;
85
+ minCliVersion: z.ZodOptional<z.ZodString>;
84
86
  }, z.core.$strip>;
85
87
  export type ModelCatalogEntry = z.infer<typeof ModelCatalogEntrySchema>;
86
88
  export declare const ModelCatalogDataSchema: z.ZodObject<{
@@ -113,6 +115,7 @@ export declare const ModelCatalogDataSchema: z.ZodObject<{
113
115
  profile: z.ZodString;
114
116
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
115
117
  legacy: z.ZodOptional<z.ZodBoolean>;
118
+ minCliVersion: z.ZodOptional<z.ZodString>;
116
119
  }, z.core.$strip>>;
117
120
  }, z.core.$strip>;
118
121
  export type ModelCatalogData = z.infer<typeof ModelCatalogDataSchema>;
@@ -183,6 +186,7 @@ export declare const ProviderInfoSchema: z.ZodObject<{
183
186
  defaultValue: z.ZodBoolean;
184
187
  description: z.ZodOptional<z.ZodString>;
185
188
  }, z.core.$strip>], "type">>;
189
+ minCliVersion: z.ZodOptional<z.ZodString>;
186
190
  }, z.core.$strip>>;
187
191
  defaultModel: z.ZodNullable<z.ZodString>;
188
192
  capabilities: z.ZodObject<{
@@ -248,6 +252,7 @@ export declare const ProviderListResultSchema: z.ZodObject<{
248
252
  defaultValue: z.ZodBoolean;
249
253
  description: z.ZodOptional<z.ZodString>;
250
254
  }, z.core.$strip>], "type">>;
255
+ minCliVersion: z.ZodOptional<z.ZodString>;
251
256
  }, z.core.$strip>>;
252
257
  defaultModel: z.ZodNullable<z.ZodString>;
253
258
  capabilities: z.ZodObject<{
package/dist/model.js CHANGED
@@ -30,7 +30,9 @@ export const ModelInfoSchema = z.object({
30
30
  badge: z.string().optional(),
31
31
  legacy: z.boolean(),
32
32
  isDefault: z.boolean(),
33
- options: z.array(ModelOptionDescriptorSchema)
33
+ options: z.array(ModelOptionDescriptorSchema),
34
+ // The oldest CLI that offers this model; absent when no minimum is known.
35
+ minCliVersion: z.string().optional()
34
36
  });
35
37
  export const ModelSelectionSchema = z.object({
36
38
  model: z.string().min(1),
@@ -49,7 +51,11 @@ export const ModelCatalogEntrySchema = z.object({
49
51
  badge: z.string().optional(),
50
52
  profile: z.string().min(1),
51
53
  aliases: z.array(z.string().min(1)).optional(),
52
- legacy: z.boolean().optional()
54
+ legacy: z.boolean().optional(),
55
+ minCliVersion: z
56
+ .string()
57
+ .regex(/^\d+\.\d+(\.\d+)?$/, 'Expected a version such as 2.1 or 2.1.4')
58
+ .optional()
53
59
  });
54
60
  /*
55
61
  * The models one provider offers, as a host ships them and as a catalog service hands out a newer
package/dist/protocol.d.ts CHANGED
@@ -94,6 +94,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
94
94
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
95
95
  at: z.ZodNumber;
96
96
  }, z.core.$strip>>;
97
+ quoteSource: z.ZodOptional<z.ZodObject<{
98
+ itemId: z.ZodString;
99
+ }, z.core.$strip>>;
97
100
  }, z.core.$strip>>>;
98
101
  queuePaused: z.ZodOptional<z.ZodBoolean>;
99
102
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -211,6 +214,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
211
214
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
212
215
  at: z.ZodNumber;
213
216
  }, z.core.$strip>>;
217
+ quoteSource: z.ZodOptional<z.ZodObject<{
218
+ itemId: z.ZodString;
219
+ }, z.core.$strip>>;
214
220
  }, z.core.$strip>, z.ZodObject<{
215
221
  id: z.ZodString;
216
222
  createdAt: z.ZodNumber;
@@ -447,6 +453,8 @@ export declare const AGENT_REQUEST_SCHEMAS: {
447
453
  endedAt: z.ZodNullable<z.ZodNumber>;
448
454
  costUsd: z.ZodNumber;
449
455
  checkpoint: z.ZodOptional<z.ZodString>;
456
+ checkpointHead: z.ZodOptional<z.ZodString>;
457
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
450
458
  checkpointDiff: z.ZodOptional<z.ZodObject<{
451
459
  files: z.ZodArray<z.ZodObject<{
452
460
  path: z.ZodString;
@@ -584,6 +592,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
584
592
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
585
593
  at: z.ZodNumber;
586
594
  }, z.core.$strip>>;
595
+ quoteSource: z.ZodOptional<z.ZodObject<{
596
+ itemId: z.ZodString;
597
+ }, z.core.$strip>>;
587
598
  }, z.core.$strip>>>;
588
599
  queuePaused: z.ZodOptional<z.ZodBoolean>;
589
600
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -693,6 +704,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
693
704
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
694
705
  at: z.ZodNumber;
695
706
  }, z.core.$strip>>;
707
+ quoteSource: z.ZodOptional<z.ZodObject<{
708
+ itemId: z.ZodString;
709
+ }, z.core.$strip>>;
696
710
  }, z.core.$strip>, z.ZodObject<{
697
711
  id: z.ZodString;
698
712
  createdAt: z.ZodNumber;
@@ -929,6 +943,8 @@ export declare const AGENT_REQUEST_SCHEMAS: {
929
943
  endedAt: z.ZodNullable<z.ZodNumber>;
930
944
  costUsd: z.ZodNumber;
931
945
  checkpoint: z.ZodOptional<z.ZodString>;
946
+ checkpointHead: z.ZodOptional<z.ZodString>;
947
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
932
948
  checkpointDiff: z.ZodOptional<z.ZodObject<{
933
949
  files: z.ZodArray<z.ZodObject<{
934
950
  path: z.ZodString;
@@ -1017,6 +1033,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
1017
1033
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1018
1034
  at: z.ZodNumber;
1019
1035
  }, z.core.$strip>>;
1036
+ quoteSource: z.ZodOptional<z.ZodObject<{
1037
+ itemId: z.ZodString;
1038
+ }, z.core.$strip>>;
1020
1039
  }, z.core.$strip>, z.ZodObject<{
1021
1040
  id: z.ZodString;
1022
1041
  createdAt: z.ZodNumber;
@@ -1253,6 +1272,8 @@ export declare const AGENT_REQUEST_SCHEMAS: {
1253
1272
  endedAt: z.ZodNullable<z.ZodNumber>;
1254
1273
  costUsd: z.ZodNumber;
1255
1274
  checkpoint: z.ZodOptional<z.ZodString>;
1275
+ checkpointHead: z.ZodOptional<z.ZodString>;
1276
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
1256
1277
  checkpointDiff: z.ZodOptional<z.ZodObject<{
1257
1278
  files: z.ZodArray<z.ZodObject<{
1258
1279
  path: z.ZodString;
@@ -1340,6 +1361,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
1340
1361
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1341
1362
  at: z.ZodNumber;
1342
1363
  }, z.core.$strip>>;
1364
+ quoteSource: z.ZodOptional<z.ZodObject<{
1365
+ itemId: z.ZodString;
1366
+ }, z.core.$strip>>;
1343
1367
  }, z.core.$strip>, z.ZodObject<{
1344
1368
  id: z.ZodString;
1345
1369
  createdAt: z.ZodNumber;
@@ -1576,6 +1600,8 @@ export declare const AGENT_REQUEST_SCHEMAS: {
1576
1600
  endedAt: z.ZodNullable<z.ZodNumber>;
1577
1601
  costUsd: z.ZodNumber;
1578
1602
  checkpoint: z.ZodOptional<z.ZodString>;
1603
+ checkpointHead: z.ZodOptional<z.ZodString>;
1604
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
1579
1605
  checkpointDiff: z.ZodOptional<z.ZodObject<{
1580
1606
  files: z.ZodArray<z.ZodObject<{
1581
1607
  path: z.ZodString;
@@ -1757,6 +1783,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
1757
1783
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1758
1784
  at: z.ZodNumber;
1759
1785
  }, z.core.$strip>>;
1786
+ quoteSource: z.ZodOptional<z.ZodObject<{
1787
+ itemId: z.ZodString;
1788
+ }, z.core.$strip>>;
1760
1789
  }, z.core.$strip>>>;
1761
1790
  queuePaused: z.ZodOptional<z.ZodBoolean>;
1762
1791
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1908,6 +1937,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
1908
1937
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1909
1938
  at: z.ZodNumber;
1910
1939
  }, z.core.$strip>>;
1940
+ quoteSource: z.ZodOptional<z.ZodObject<{
1941
+ itemId: z.ZodString;
1942
+ }, z.core.$strip>>;
1911
1943
  }, z.core.$strip>>>;
1912
1944
  queuePaused: z.ZodOptional<z.ZodBoolean>;
1913
1945
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -2017,6 +2049,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
2017
2049
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2018
2050
  at: z.ZodNumber;
2019
2051
  }, z.core.$strip>>;
2052
+ quoteSource: z.ZodOptional<z.ZodObject<{
2053
+ itemId: z.ZodString;
2054
+ }, z.core.$strip>>;
2020
2055
  }, z.core.$strip>, z.ZodObject<{
2021
2056
  id: z.ZodString;
2022
2057
  createdAt: z.ZodNumber;
@@ -2253,6 +2288,8 @@ export declare const AGENT_REQUEST_SCHEMAS: {
2253
2288
  endedAt: z.ZodNullable<z.ZodNumber>;
2254
2289
  costUsd: z.ZodNumber;
2255
2290
  checkpoint: z.ZodOptional<z.ZodString>;
2291
+ checkpointHead: z.ZodOptional<z.ZodString>;
2292
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
2256
2293
  checkpointDiff: z.ZodOptional<z.ZodObject<{
2257
2294
  files: z.ZodArray<z.ZodObject<{
2258
2295
  path: z.ZodString;
@@ -2347,6 +2384,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
2347
2384
  mentions: z.ZodOptional<z.ZodArray<z.ZodString>>;
2348
2385
  skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
2349
2386
  chats: z.ZodOptional<z.ZodArray<z.ZodString>>;
2387
+ quoteSource: z.ZodOptional<z.ZodObject<{
2388
+ itemId: z.ZodString;
2389
+ }, z.core.$strip>>;
2350
2390
  attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
2351
2391
  name: z.ZodString;
2352
2392
  mime: z.ZodString;
@@ -2469,6 +2509,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
2469
2509
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2470
2510
  at: z.ZodNumber;
2471
2511
  }, z.core.$strip>>;
2512
+ quoteSource: z.ZodOptional<z.ZodObject<{
2513
+ itemId: z.ZodString;
2514
+ }, z.core.$strip>>;
2472
2515
  }, z.core.$strip>>;
2473
2516
  }, z.core.$strip>;
2474
2517
  };
@@ -2599,6 +2642,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
2599
2642
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2600
2643
  at: z.ZodNumber;
2601
2644
  }, z.core.$strip>>;
2645
+ quoteSource: z.ZodOptional<z.ZodObject<{
2646
+ itemId: z.ZodString;
2647
+ }, z.core.$strip>>;
2602
2648
  }, z.core.$strip>>>;
2603
2649
  queuePaused: z.ZodOptional<z.ZodBoolean>;
2604
2650
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -2848,6 +2894,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
2848
2894
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2849
2895
  at: z.ZodNumber;
2850
2896
  }, z.core.$strip>>;
2897
+ quoteSource: z.ZodOptional<z.ZodObject<{
2898
+ itemId: z.ZodString;
2899
+ }, z.core.$strip>>;
2851
2900
  }, z.core.$strip>>>;
2852
2901
  queuePaused: z.ZodOptional<z.ZodBoolean>;
2853
2902
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -3030,6 +3079,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
3030
3079
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3031
3080
  at: z.ZodNumber;
3032
3081
  }, z.core.$strip>>;
3082
+ quoteSource: z.ZodOptional<z.ZodObject<{
3083
+ itemId: z.ZodString;
3084
+ }, z.core.$strip>>;
3033
3085
  }, z.core.$strip>>>;
3034
3086
  queuePaused: z.ZodOptional<z.ZodBoolean>;
3035
3087
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -3194,6 +3246,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
3194
3246
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3195
3247
  at: z.ZodNumber;
3196
3248
  }, z.core.$strip>>;
3249
+ quoteSource: z.ZodOptional<z.ZodObject<{
3250
+ itemId: z.ZodString;
3251
+ }, z.core.$strip>>;
3197
3252
  }, z.core.$strip>, z.ZodObject<{
3198
3253
  id: z.ZodString;
3199
3254
  createdAt: z.ZodNumber;
@@ -3430,6 +3485,8 @@ export declare const AGENT_REQUEST_SCHEMAS: {
3430
3485
  endedAt: z.ZodNullable<z.ZodNumber>;
3431
3486
  costUsd: z.ZodNumber;
3432
3487
  checkpoint: z.ZodOptional<z.ZodString>;
3488
+ checkpointHead: z.ZodOptional<z.ZodString>;
3489
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
3433
3490
  checkpointDiff: z.ZodOptional<z.ZodObject<{
3434
3491
  files: z.ZodArray<z.ZodObject<{
3435
3492
  path: z.ZodString;
@@ -3686,6 +3743,7 @@ export declare const AGENT_REQUEST_SCHEMAS: {
3686
3743
  defaultValue: z.ZodBoolean;
3687
3744
  description: z.ZodOptional<z.ZodString>;
3688
3745
  }, z.core.$strip>], "type">>;
3746
+ minCliVersion: z.ZodOptional<z.ZodString>;
3689
3747
  }, z.core.$strip>>;
3690
3748
  defaultModel: z.ZodNullable<z.ZodString>;
3691
3749
  capabilities: z.ZodObject<{
@@ -4254,6 +4312,9 @@ export declare const AGENT_REQUEST_SCHEMAS: {
4254
4312
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4255
4313
  at: z.ZodNumber;
4256
4314
  }, z.core.$strip>>;
4315
+ quoteSource: z.ZodOptional<z.ZodObject<{
4316
+ itemId: z.ZodString;
4317
+ }, z.core.$strip>>;
4257
4318
  }, z.core.$strip>>>;
4258
4319
  queuePaused: z.ZodOptional<z.ZodBoolean>;
4259
4320
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -4371,6 +4432,9 @@ export declare const AGENT_EVENT_SCHEMAS: {
4371
4432
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4372
4433
  at: z.ZodNumber;
4373
4434
  }, z.core.$strip>>;
4435
+ quoteSource: z.ZodOptional<z.ZodObject<{
4436
+ itemId: z.ZodString;
4437
+ }, z.core.$strip>>;
4374
4438
  }, z.core.$strip>, z.ZodObject<{
4375
4439
  id: z.ZodString;
4376
4440
  createdAt: z.ZodNumber;
@@ -4607,6 +4671,8 @@ export declare const AGENT_EVENT_SCHEMAS: {
4607
4671
  endedAt: z.ZodNullable<z.ZodNumber>;
4608
4672
  costUsd: z.ZodNumber;
4609
4673
  checkpoint: z.ZodOptional<z.ZodString>;
4674
+ checkpointHead: z.ZodOptional<z.ZodString>;
4675
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
4610
4676
  checkpointDiff: z.ZodOptional<z.ZodObject<{
4611
4677
  files: z.ZodArray<z.ZodObject<{
4612
4678
  path: z.ZodString;
@@ -4788,6 +4854,9 @@ export declare const AGENT_EVENT_SCHEMAS: {
4788
4854
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4789
4855
  at: z.ZodNumber;
4790
4856
  }, z.core.$strip>>;
4857
+ quoteSource: z.ZodOptional<z.ZodObject<{
4858
+ itemId: z.ZodString;
4859
+ }, z.core.$strip>>;
4791
4860
  }, z.core.$strip>>>;
4792
4861
  queuePaused: z.ZodOptional<z.ZodBoolean>;
4793
4862
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -4939,6 +5008,9 @@ export declare const AGENT_EVENT_SCHEMAS: {
4939
5008
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4940
5009
  at: z.ZodNumber;
4941
5010
  }, z.core.$strip>>;
5011
+ quoteSource: z.ZodOptional<z.ZodObject<{
5012
+ itemId: z.ZodString;
5013
+ }, z.core.$strip>>;
4942
5014
  }, z.core.$strip>>>;
4943
5015
  queuePaused: z.ZodOptional<z.ZodBoolean>;
4944
5016
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -5048,6 +5120,9 @@ export declare const AGENT_EVENT_SCHEMAS: {
5048
5120
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
5049
5121
  at: z.ZodNumber;
5050
5122
  }, z.core.$strip>>;
5123
+ quoteSource: z.ZodOptional<z.ZodObject<{
5124
+ itemId: z.ZodString;
5125
+ }, z.core.$strip>>;
5051
5126
  }, z.core.$strip>, z.ZodObject<{
5052
5127
  id: z.ZodString;
5053
5128
  createdAt: z.ZodNumber;
@@ -5284,6 +5359,8 @@ export declare const AGENT_EVENT_SCHEMAS: {
5284
5359
  endedAt: z.ZodNullable<z.ZodNumber>;
5285
5360
  costUsd: z.ZodNumber;
5286
5361
  checkpoint: z.ZodOptional<z.ZodString>;
5362
+ checkpointHead: z.ZodOptional<z.ZodString>;
5363
+ checkpointHeadAfter: z.ZodOptional<z.ZodString>;
5287
5364
  checkpointDiff: z.ZodOptional<z.ZodObject<{
5288
5365
  files: z.ZodArray<z.ZodObject<{
5289
5366
  path: z.ZodString;
@@ -5413,6 +5490,9 @@ export declare const AGENT_EVENT_SCHEMAS: {
5413
5490
  values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
5414
5491
  at: z.ZodNumber;
5415
5492
  }, z.core.$strip>>;
5493
+ quoteSource: z.ZodOptional<z.ZodObject<{
5494
+ itemId: z.ZodString;
5495
+ }, z.core.$strip>>;
5416
5496
  }, z.core.$strip>>>;
5417
5497
  queuePaused: z.ZodOptional<z.ZodBoolean>;
5418
5498
  background: z.ZodOptional<z.ZodArray<z.ZodObject<{
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adecore/agent-contracts",
3
- "version": "0.21.2",
3
+ "version": "0.22.1",
4
4
  "description": "Schemas and port contracts for agent chats, provider accounts, models and usage.",
5
5
  "type": "module",
6
6
  "exports": {
@@ -81,7 +81,7 @@
81
81
  "test": "bun --conditions=source test"
82
82
  },
83
83
  "dependencies": {
84
- "@adecore/intelligent-ui": "0.21.2",
84
+ "@adecore/intelligent-ui": "0.22.1",
85
85
  "zod": "^4.6.5"
86
86
  },
87
87
  "devDependencies": {
package/src/chat.ts CHANGED
@@ -126,6 +126,10 @@ export const ChatUiAnswerSchema = ChatUiChoiceOriginSchema.extend({
126
126
  export type ChatUiAnswer = z.infer<typeof ChatUiAnswerSchema>;
127
127
 
128
128
  // A message typed while a turn was running; the daemon sends it when that turn settles.
129
+ /* The reply a quoted passage was taken from, so a client can lead the reader back to it. */
130
+ export const ChatQuoteSourceSchema = z.object({ itemId: z.string().min(1).max(256) });
131
+ export type ChatQuoteSource = z.infer<typeof ChatQuoteSourceSchema>;
132
+
129
133
  export const ChatQueuedMessageSchema = z.object({
130
134
  id: z.string().min(1),
131
135
  // Older saved queues have no reserved turn yet; draining them still mints one.
@@ -136,7 +140,8 @@ export const ChatQueuedMessageSchema = z.object({
136
140
  chats: z.array(z.string()).optional(),
137
141
  attachments: z.array(ChatAttachmentSchema).optional(),
138
142
  createdAt: z.number(),
139
- uiChoice: ChatUiChoiceOriginSchema.optional()
143
+ uiChoice: ChatUiChoiceOriginSchema.optional(),
144
+ quoteSource: ChatQuoteSourceSchema.optional()
140
145
  });
141
146
  export type ChatQueuedMessage = z.infer<typeof ChatQueuedMessageSchema>;
142
147
 
@@ -307,7 +312,9 @@ export const ChatUserItemSchema = z.object({
307
312
  // Chats of the same project the person picked with `@`. Only their ids travel; the agent reads them itself.
308
313
  chats: z.array(z.string()).optional(),
309
314
  attachments: z.array(ChatAttachmentSchema).optional(),
310
- uiChoice: ChatUiChoiceOriginSchema.optional()
315
+ uiChoice: ChatUiChoiceOriginSchema.optional(),
316
+ // The reply the quote at the head of the text was taken from; absent when it names none or the reply is gone.
317
+ quoteSource: ChatQuoteSourceSchema.optional()
311
318
  });
312
319
 
313
320
  // `state` is a frozen set: native clients validate these payloads whole, so a new state would fail them.
@@ -560,6 +567,10 @@ export const ChatTurnItemSchema = z.object({
560
567
  costUsd: z.number().nonnegative(),
561
568
  // The git tree of the chat's folder when the turn started; absent outside a repository.
562
569
  checkpoint: z.string().optional(),
570
+ // The commit HEAD pointed at when the turn started, and when it settled; absent when unborn or outside git.
571
+ // Two that differ mean the branch moved during the turn, so the checkpoint diff holds more than the agent's work.
572
+ checkpointHead: z.string().optional(),
573
+ checkpointHeadAfter: z.string().optional(),
563
574
  // What the working tree holds against that checkpoint, taken when the turn settled.
564
575
  checkpointDiff: ChatCheckpointDiffSchema.optional(),
565
576
  // How many CLI processes worked on this turn; absent is one, which is every turn before this field.
@@ -600,6 +611,9 @@ export function abortedByMachine(
600
611
  );
601
612
  }
602
613
 
614
+ /* The id prefix of the note a host leaves in a parent about a child that waits on a request. */
615
+ export const WAITING_NOTE_PREFIX = 'waiting-';
616
+
603
617
  export const ChatNoteItemSchema = z.object({
604
618
  ...base,
605
619
  kind: z.literal('note'),
@@ -872,6 +886,7 @@ export const ChatSendPayloadSchema = z
872
886
  mentions: z.array(z.string().min(1)).max(64).optional(),
873
887
  skills: z.array(z.string().min(1)).max(16).optional(),
874
888
  chats: z.array(ChatIdSchema).max(16).optional(),
889
+ quoteSource: ChatQuoteSourceSchema.optional(),
875
890
  attachments: ChatAttachmentUploadsSchema.optional()
876
891
  })
877
892
  .refine((payload) => payload.text.trim() !== '' || (payload.attachments?.length ?? 0) > 0, { message: 'A message needs text or an attachment' });
package/src/model.ts CHANGED
@@ -35,7 +35,9 @@ export const ModelInfoSchema = z.object({
35
35
  badge: z.string().optional(),
36
36
  legacy: z.boolean(),
37
37
  isDefault: z.boolean(),
38
- options: z.array(ModelOptionDescriptorSchema)
38
+ options: z.array(ModelOptionDescriptorSchema),
39
+ // The oldest CLI that offers this model; absent when no minimum is known.
40
+ minCliVersion: z.string().optional()
39
41
  });
40
42
  export type ModelInfo = z.infer<typeof ModelInfoSchema>;
41
43
 
@@ -61,7 +63,11 @@ export const ModelCatalogEntrySchema = z.object({
61
63
  badge: z.string().optional(),
62
64
  profile: z.string().min(1),
63
65
  aliases: z.array(z.string().min(1)).optional(),
64
- legacy: z.boolean().optional()
66
+ legacy: z.boolean().optional(),
67
+ minCliVersion: z
68
+ .string()
69
+ .regex(/^\d+\.\d+(\.\d+)?$/, 'Expected a version such as 2.1 or 2.1.4')
70
+ .optional()
65
71
  });
66
72
  export type ModelCatalogEntry = z.infer<typeof ModelCatalogEntrySchema>;
67
73