@mossbear/protocol 0.1.0-alpha.58 → 0.1.0-alpha.59

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.
package/dist/schemas.d.ts CHANGED
@@ -916,7 +916,7 @@ export type GuideAlias = v.InferOutput<typeof GuideAliasSchema>;
916
916
  *
917
917
  * Named for the guide-history response it was written for and shared by every
918
918
  * payload that places somebody else's words in front of an agent: a grade's
919
- * reasoning, and now an item's notes. One marker scheme, not one per payload —
919
+ * reasoning, and now an item's comments. One marker scheme, not one per payload —
920
920
  * a second scheme is a second thing a reader has to be taught to respect.
921
921
  * Declared here, above its first user, rather than beside that response.
922
922
  */
@@ -928,17 +928,17 @@ export declare const GuideHistoryUntrustedSchema: v.ObjectSchema<{
928
928
  }, undefined>;
929
929
  export type GuideHistoryUntrusted = v.InferOutput<typeof GuideHistoryUntrustedSchema>;
930
930
  /**
931
- * How many open notes one item carries on the wire, newest first.
931
+ * How many open comments one item carries on the wire, newest first.
932
932
  *
933
- * A wire bound, not a product limit: the write side refuses the note that
933
+ * A wire bound, not a product limit: the write side refuses the comment that
934
934
  * would exceed it *by name* (see the dashboard's note mutator), so this cap is
935
- * never the thing that silently drops a request a person left.
935
+ * never the thing that silently drops a comment a person left.
936
936
  */
937
- export declare const MAX_ITEM_NOTES_ON_WIRE = 20;
937
+ export declare const MAX_ITEM_COMMENTS_ON_WIRE = 20;
938
938
  /**
939
- * One note a **person** left about a context item, riding the item it is about.
939
+ * One comment a **person** left about a context item, riding the item it is about.
940
940
  *
941
- * A note is not an item: it is not a member, not projected, not versioned and
941
+ * A comment is not an item: it is not a member, not projected, not versioned and
942
942
  * not capturable. It travels on the item so that it inherits every delivery
943
943
  * decision the item already went through — workspace scope, the archived drop,
944
944
  * the response limit, the subscriber's mute — rather than restating them.
@@ -948,21 +948,31 @@ export declare const MAX_ITEM_NOTES_ON_WIRE = 20;
948
948
  * received them and never re-wraps them: the markers are derived against the
949
949
  * bodies the server sent, so a second wrapping cannot claim the same guarantee.
950
950
  */
951
- export declare const ContextItemNoteSchema: v.ObjectSchema<{
951
+ export declare const ContextItemCommentSchema: v.ObjectSchema<{
952
952
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
953
- /** The note's text, already wrapped in the response's untrusted markers. */
953
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
954
+ /** Current source location of an anchored passage, or its lost quote. */
955
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
956
+ readonly quote: v.StringSchema<undefined>;
957
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
958
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
959
+ readonly start: v.NumberSchema<undefined>;
960
+ readonly end: v.NumberSchema<undefined>;
961
+ }, undefined>, undefined>;
962
+ }, undefined>, undefined>;
963
+ /** The comment's text, already wrapped in the response's untrusted markers. */
954
964
  readonly body: v.StringSchema<undefined>;
955
965
  /** The author's display name as the workspace shows it, or null. Never an email. */
956
966
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
957
967
  /** ISO timestamp, machine format. */
958
968
  readonly createdAt: v.StringSchema<undefined>;
959
- /** The item's content version the note was written against. */
969
+ /** The item's content version the comment was written against. */
960
970
  readonly itemVersion: v.NumberSchema<undefined>;
961
971
  /** True when the item's current version is greater than `itemVersion`. */
962
972
  readonly itemChangedSince: v.BooleanSchema<undefined>;
963
973
  /**
964
- * How many agent reads were handed this note **before** this one — so a
965
- * note reaching an agent for the first time reports `0`.
974
+ * How many agent reads were handed this comment **before** this one — so a
975
+ * comment reaching an agent for the first time reports `0`.
966
976
  *
967
977
  * It is the stored count as it read at the moment the response was built;
968
978
  * the serve this response *is* has not been counted yet. Excluded rather
@@ -971,28 +981,28 @@ export declare const ContextItemNoteSchema: v.ObjectSchema<{
971
981
  * a number that is sometimes off by one is worse than one that is
972
982
  * consistently the prior total.
973
983
  *
974
- * So `deliveredCount > 0` means an earlier read was handed this note, and
984
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
975
985
  * `0` means this read is the first. Neither says a model took it in — only
976
986
  * that the server handed it over.
977
987
  */
978
988
  readonly deliveredCount: v.NumberSchema<undefined>;
979
989
  /**
980
- * This note's thread root — its own id for every note written today, since
981
- * no reply exists yet. Ignorable now; load-bearing once a reply is a second
982
- * row with a different id here. It is on the wire from the first response
990
+ * This comment's thread root — its own id for every delivered root. Resolution
991
+ * replies remain on the dashboard thread and are not delivered to agents.
992
+ * It is on the wire from the first response
983
993
  * because the wire contract is consumed by installed CLI versions: reshaping
984
- * a flat `notes` array into threads-of-notes later would be a breaking
994
+ * a flat `comments` array into threads-of-comments later would be a breaking
985
995
  * change, while a field today's readers ignore costs them nothing.
986
996
  */
987
997
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
988
998
  /**
989
- * Always `null` today — no reply exists to point at. Present now so an older
990
- * reader meeting a future response that carries real replies degrades to
991
- * "a flat list of notes" rather than failing to parse.
999
+ * Always `null` for a delivered root. Present so an older reader meeting a
1000
+ * future response that carries real replies degrades to
1001
+ * "a flat list of comments" rather than failing to parse.
992
1002
  */
993
1003
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
994
1004
  }, undefined>;
995
- export type ContextItemNote = v.InferOutput<typeof ContextItemNoteSchema>;
1005
+ export type ContextItemComment = v.InferOutput<typeof ContextItemCommentSchema>;
996
1006
  /**
997
1007
  * The revision published bytes were read from — 40 hex characters for a sha1
998
1008
  * repository, 64 for a sha256 one. Lowercase only, because that is what
@@ -1087,31 +1097,41 @@ export declare const ContextItemSchema: v.ObjectSchema<{
1087
1097
  path: string;
1088
1098
  }[], 8, undefined>]>, undefined>;
1089
1099
  /**
1090
- * Open notes a person left about this item, newest first.
1100
+ * Open comments a person left about this item, newest first.
1091
1101
  *
1092
1102
  * Optional, and absent rather than empty when there are none — the same rule
1093
1103
  * `aliases` and `projectId` follow above, and for the same reason: an older
1094
1104
  * reader against a newer server ignores the key, and a newer reader against
1095
- * an older server reads "no notes" instead of failing.
1105
+ * an older server reads "no comments" instead of failing.
1096
1106
  *
1097
- * **Absence is not a verdict.** No notes here means none were served on this
1107
+ * **Absence is not a verdict.** No comments here means none were served on this
1098
1108
  * item in this response — not that nobody has anything to say about it.
1099
1109
  */
1100
- readonly notes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
1110
+ readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
1101
1111
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1102
- /** The note's text, already wrapped in the response's untrusted markers. */
1112
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
1113
+ /** Current source location of an anchored passage, or its lost quote. */
1114
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
1115
+ readonly quote: v.StringSchema<undefined>;
1116
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
1117
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
1118
+ readonly start: v.NumberSchema<undefined>;
1119
+ readonly end: v.NumberSchema<undefined>;
1120
+ }, undefined>, undefined>;
1121
+ }, undefined>, undefined>;
1122
+ /** The comment's text, already wrapped in the response's untrusted markers. */
1103
1123
  readonly body: v.StringSchema<undefined>;
1104
1124
  /** The author's display name as the workspace shows it, or null. Never an email. */
1105
1125
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1106
1126
  /** ISO timestamp, machine format. */
1107
1127
  readonly createdAt: v.StringSchema<undefined>;
1108
- /** The item's content version the note was written against. */
1128
+ /** The item's content version the comment was written against. */
1109
1129
  readonly itemVersion: v.NumberSchema<undefined>;
1110
1130
  /** True when the item's current version is greater than `itemVersion`. */
1111
1131
  readonly itemChangedSince: v.BooleanSchema<undefined>;
1112
1132
  /**
1113
- * How many agent reads were handed this note **before** this one — so a
1114
- * note reaching an agent for the first time reports `0`.
1133
+ * How many agent reads were handed this comment **before** this one — so a
1134
+ * comment reaching an agent for the first time reports `0`.
1115
1135
  *
1116
1136
  * It is the stored count as it read at the moment the response was built;
1117
1137
  * the serve this response *is* has not been counted yet. Excluded rather
@@ -1120,28 +1140,37 @@ export declare const ContextItemSchema: v.ObjectSchema<{
1120
1140
  * a number that is sometimes off by one is worse than one that is
1121
1141
  * consistently the prior total.
1122
1142
  *
1123
- * So `deliveredCount > 0` means an earlier read was handed this note, and
1143
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
1124
1144
  * `0` means this read is the first. Neither says a model took it in — only
1125
1145
  * that the server handed it over.
1126
1146
  */
1127
1147
  readonly deliveredCount: v.NumberSchema<undefined>;
1128
1148
  /**
1129
- * This note's thread root — its own id for every note written today, since
1130
- * no reply exists yet. Ignorable now; load-bearing once a reply is a second
1131
- * row with a different id here. It is on the wire from the first response
1149
+ * This comment's thread root — its own id for every delivered root. Resolution
1150
+ * replies remain on the dashboard thread and are not delivered to agents.
1151
+ * It is on the wire from the first response
1132
1152
  * because the wire contract is consumed by installed CLI versions: reshaping
1133
- * a flat `notes` array into threads-of-notes later would be a breaking
1153
+ * a flat `comments` array into threads-of-comments later would be a breaking
1134
1154
  * change, while a field today's readers ignore costs them nothing.
1135
1155
  */
1136
1156
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1137
1157
  /**
1138
- * Always `null` today — no reply exists to point at. Present now so an older
1139
- * reader meeting a future response that carries real replies degrades to
1140
- * "a flat list of notes" rather than failing to parse.
1158
+ * Always `null` for a delivered root. Present so an older reader meeting a
1159
+ * future response that carries real replies degrades to
1160
+ * "a flat list of comments" rather than failing to parse.
1141
1161
  */
1142
1162
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
1143
1163
  }, undefined>, undefined>, v.MaxLengthAction<{
1144
1164
  id: string;
1165
+ state?: "open" | "resolved" | undefined;
1166
+ passage?: {
1167
+ quote: string;
1168
+ status: "located" | "changed" | "orphaned";
1169
+ lines: {
1170
+ start: number;
1171
+ end: number;
1172
+ } | null;
1173
+ } | undefined;
1145
1174
  body: string;
1146
1175
  authorName: string | null;
1147
1176
  createdAt: string;
@@ -1269,31 +1298,41 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1269
1298
  path: string;
1270
1299
  }[], 8, undefined>]>, undefined>;
1271
1300
  /**
1272
- * Open notes a person left about this item, newest first.
1301
+ * Open comments a person left about this item, newest first.
1273
1302
  *
1274
1303
  * Optional, and absent rather than empty when there are none — the same rule
1275
1304
  * `aliases` and `projectId` follow above, and for the same reason: an older
1276
1305
  * reader against a newer server ignores the key, and a newer reader against
1277
- * an older server reads "no notes" instead of failing.
1306
+ * an older server reads "no comments" instead of failing.
1278
1307
  *
1279
- * **Absence is not a verdict.** No notes here means none were served on this
1308
+ * **Absence is not a verdict.** No comments here means none were served on this
1280
1309
  * item in this response — not that nobody has anything to say about it.
1281
1310
  */
1282
- readonly notes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
1311
+ readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
1283
1312
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1284
- /** The note's text, already wrapped in the response's untrusted markers. */
1313
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
1314
+ /** Current source location of an anchored passage, or its lost quote. */
1315
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
1316
+ readonly quote: v.StringSchema<undefined>;
1317
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
1318
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
1319
+ readonly start: v.NumberSchema<undefined>;
1320
+ readonly end: v.NumberSchema<undefined>;
1321
+ }, undefined>, undefined>;
1322
+ }, undefined>, undefined>;
1323
+ /** The comment's text, already wrapped in the response's untrusted markers. */
1285
1324
  readonly body: v.StringSchema<undefined>;
1286
1325
  /** The author's display name as the workspace shows it, or null. Never an email. */
1287
1326
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1288
1327
  /** ISO timestamp, machine format. */
1289
1328
  readonly createdAt: v.StringSchema<undefined>;
1290
- /** The item's content version the note was written against. */
1329
+ /** The item's content version the comment was written against. */
1291
1330
  readonly itemVersion: v.NumberSchema<undefined>;
1292
1331
  /** True when the item's current version is greater than `itemVersion`. */
1293
1332
  readonly itemChangedSince: v.BooleanSchema<undefined>;
1294
1333
  /**
1295
- * How many agent reads were handed this note **before** this one — so a
1296
- * note reaching an agent for the first time reports `0`.
1334
+ * How many agent reads were handed this comment **before** this one — so a
1335
+ * comment reaching an agent for the first time reports `0`.
1297
1336
  *
1298
1337
  * It is the stored count as it read at the moment the response was built;
1299
1338
  * the serve this response *is* has not been counted yet. Excluded rather
@@ -1302,28 +1341,37 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1302
1341
  * a number that is sometimes off by one is worse than one that is
1303
1342
  * consistently the prior total.
1304
1343
  *
1305
- * So `deliveredCount > 0` means an earlier read was handed this note, and
1344
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
1306
1345
  * `0` means this read is the first. Neither says a model took it in — only
1307
1346
  * that the server handed it over.
1308
1347
  */
1309
1348
  readonly deliveredCount: v.NumberSchema<undefined>;
1310
1349
  /**
1311
- * This note's thread root — its own id for every note written today, since
1312
- * no reply exists yet. Ignorable now; load-bearing once a reply is a second
1313
- * row with a different id here. It is on the wire from the first response
1350
+ * This comment's thread root — its own id for every delivered root. Resolution
1351
+ * replies remain on the dashboard thread and are not delivered to agents.
1352
+ * It is on the wire from the first response
1314
1353
  * because the wire contract is consumed by installed CLI versions: reshaping
1315
- * a flat `notes` array into threads-of-notes later would be a breaking
1354
+ * a flat `comments` array into threads-of-comments later would be a breaking
1316
1355
  * change, while a field today's readers ignore costs them nothing.
1317
1356
  */
1318
1357
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1319
1358
  /**
1320
- * Always `null` today — no reply exists to point at. Present now so an older
1321
- * reader meeting a future response that carries real replies degrades to
1322
- * "a flat list of notes" rather than failing to parse.
1359
+ * Always `null` for a delivered root. Present so an older reader meeting a
1360
+ * future response that carries real replies degrades to
1361
+ * "a flat list of comments" rather than failing to parse.
1323
1362
  */
1324
1363
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
1325
1364
  }, undefined>, undefined>, v.MaxLengthAction<{
1326
1365
  id: string;
1366
+ state?: "open" | "resolved" | undefined;
1367
+ passage?: {
1368
+ quote: string;
1369
+ status: "located" | "changed" | "orphaned";
1370
+ lines: {
1371
+ start: number;
1372
+ end: number;
1373
+ } | null;
1374
+ } | undefined;
1327
1375
  body: string;
1328
1376
  authorName: string | null;
1329
1377
  createdAt: string;
@@ -1403,9 +1451,9 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1403
1451
  readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
1404
1452
  }, undefined>, undefined>;
1405
1453
  /**
1406
- * The markers every note `body` in this response is wrapped in, plus a
1454
+ * The markers every comment `body` in this response is wrapped in, plus a
1407
1455
  * statement of what they mean. Present exactly when at least one item
1408
- * carries a note — there is nothing to delimit otherwise.
1456
+ * carries a comment — there is nothing to delimit otherwise.
1409
1457
  */
1410
1458
  readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
1411
1459
  readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -1415,20 +1463,20 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1415
1463
  }, undefined>, undefined>, undefined>;
1416
1464
  }, undefined>;
1417
1465
  /**
1418
- * How many bundles one notes read may name.
1466
+ * How many bundles one comments read may name.
1419
1467
  *
1420
1468
  * A repo's delivery set is the union of its committed subscriptions and the
1421
1469
  * reader's account ones, so this bounds a request, not a product limit: a
1422
1470
  * reader subscribing to more bundles than this asks in two calls rather than
1423
1471
  * losing the tail silently.
1424
1472
  */
1425
- export declare const MAX_NOTE_BUNDLE_IDS = 100;
1473
+ export declare const MAX_COMMENT_BUNDLE_IDS = 100;
1426
1474
  /**
1427
- * How many times one subscriber is told, in one repo, that a given note is
1475
+ * How many times one subscriber is told, in one repo, that a given comment is
1428
1476
  * waiting before the hook falls silent about it.
1429
1477
  *
1430
- * **A cap on the interruption, never on the note.** After it is reached the
1431
- * note is still open, still on the item page, and still returned in full by
1478
+ * **A cap on the interruption, never on the comment.** After it is reached the
1479
+ * comment is still open, still on the item page, and still returned in full by
1432
1480
  * the on-demand read — it simply stops being announced in front of the first
1433
1481
  * turn of every session. So silence here means "nothing new to interrupt you
1434
1482
  * about", never "nobody left anything".
@@ -1439,20 +1487,20 @@ export declare const MAX_NOTE_BUNDLE_IDS = 100;
1439
1487
  * judgement, named so replacing it is one edit — the same discipline the live
1440
1488
  * session window is held to.
1441
1489
  */
1442
- export declare const MAX_NOTE_ANNOUNCEMENTS_PER_REPO = 3;
1490
+ export declare const MAX_COMMENT_ANNOUNCEMENTS_PER_REPO = 3;
1443
1491
  /**
1444
- * Ask which notes are waiting for this reader in this repo, and be counted as
1492
+ * Ask which comments are waiting for this reader in this repo, and be counted as
1445
1493
  * told.
1446
1494
  *
1447
1495
  * **A write, because being told is a fact the server has to keep.** The count
1448
- * cannot be `item_notes.delivered_count` — that is one global number across
1449
- * every subscriber and every repo, so one reader's fill of a note would
1496
+ * cannot be `item_comments.delivered_count` — that is one global number across
1497
+ * every subscriber and every repo, so one reader's fill of a comment would
1450
1498
  * silence it for everyone — and it cannot live in the checkout, because the
1451
1499
  * disposable environments this exists for rebuild the clone every session and
1452
- * a counter there resets with it, announcing every unresolved note as new
1500
+ * a counter there resets with it, announcing every unresolved comment as new
1453
1501
  * forever.
1454
1502
  */
1455
- export declare const AnnounceItemNotesRequestSchema: v.ObjectSchema<{
1503
+ export declare const AnnounceItemCommentsRequestSchema: v.ObjectSchema<{
1456
1504
  /**
1457
1505
  * The repo, as its committed config declares it. Required: it is the scope
1458
1506
  * the count is kept under, and a request with nothing to key on could only
@@ -1470,54 +1518,64 @@ export declare const AnnounceItemNotesRequestSchema: v.ObjectSchema<{
1470
1518
  */
1471
1519
  readonly bundleIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
1472
1520
  }, undefined>;
1473
- export type AnnounceItemNotesRequest = v.InferOutput<typeof AnnounceItemNotesRequestSchema>;
1521
+ export type AnnounceItemCommentsRequest = v.InferOutput<typeof AnnounceItemCommentsRequestSchema>;
1474
1522
  /**
1475
- * What an announcement answers: how many notes are waiting, and how many of
1523
+ * What an announcement answers: how many comments are waiting, and how many of
1476
1524
  * them this call was counted as announcing.
1477
1525
  *
1478
1526
  * **Two numbers because they answer two questions and a reader needs both.**
1479
- * `open` is the true state of this repo's notes and is what a caller shows a
1527
+ * `open` is the true state of this repo's comments and is what a caller shows a
1480
1528
  * person — a number that is sometimes a subset of the truth would be worse
1481
1529
  * than the silence it replaced. `announced` is how many of those were still
1482
1530
  * under the cap, and it is the one that decides whether to speak at all: zero
1483
1531
  * means this reader has already been told about every one of them as often as
1484
1532
  * the cap allows.
1485
1533
  */
1486
- export declare const AnnounceItemNotesResponseSchema: v.ObjectSchema<{
1487
- /** Open, unmuted notes about the items these bundles deliver to this reader. */
1534
+ export declare const AnnounceItemCommentsResponseSchema: v.ObjectSchema<{
1535
+ /** Open, unmuted comments about the items these bundles deliver to this reader. */
1488
1536
  readonly open: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
1489
1537
  /** How many of those were under the cap and have now been counted as announced. */
1490
1538
  readonly announced: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
1491
1539
  }, undefined>;
1492
- export type AnnounceItemNotesResponse = v.InferOutput<typeof AnnounceItemNotesResponseSchema>;
1540
+ export type AnnounceItemCommentsResponse = v.InferOutput<typeof AnnounceItemCommentsResponseSchema>;
1493
1541
  /**
1494
- * One note on the on-demand read, with the item it is about named on the note.
1542
+ * One comment on the on-demand read, with the item it is about named on the comment.
1495
1543
  *
1496
- * The item is named here rather than the notes riding an item, because this
1544
+ * The item is named here rather than the comments riding an item, because this
1497
1545
  * read answers "what has been left for me" rather than "what is in this
1498
1546
  * bundle": there is no item payload to hang them off, and an agent that has to
1499
- * ask for every item to find out whether one carries a note is the round trip
1547
+ * ask for every item to find out whether one carries a comment is the round trip
1500
1548
  * the announcement exists to avoid.
1501
1549
  */
1502
- export declare const ItemNoteWithSubjectSchema: v.ObjectSchema<{
1503
- /** The item the note is about, as the wire names it. */
1550
+ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
1551
+ /** The item the comment is about, as the wire names it. */
1504
1552
  readonly itemName: v.StringSchema<undefined>;
1505
1553
  /** The item's declared repo-relative path, or null when it has none. */
1506
1554
  readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1507
1555
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1508
- /** The note's text, already wrapped in the response's untrusted markers. */
1556
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
1557
+ /** Current source location of an anchored passage, or its lost quote. */
1558
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
1559
+ readonly quote: v.StringSchema<undefined>;
1560
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
1561
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
1562
+ readonly start: v.NumberSchema<undefined>;
1563
+ readonly end: v.NumberSchema<undefined>;
1564
+ }, undefined>, undefined>;
1565
+ }, undefined>, undefined>;
1566
+ /** The comment's text, already wrapped in the response's untrusted markers. */
1509
1567
  readonly body: v.StringSchema<undefined>;
1510
1568
  /** The author's display name as the workspace shows it, or null. Never an email. */
1511
1569
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1512
1570
  /** ISO timestamp, machine format. */
1513
1571
  readonly createdAt: v.StringSchema<undefined>;
1514
- /** The item's content version the note was written against. */
1572
+ /** The item's content version the comment was written against. */
1515
1573
  readonly itemVersion: v.NumberSchema<undefined>;
1516
1574
  /** True when the item's current version is greater than `itemVersion`. */
1517
1575
  readonly itemChangedSince: v.BooleanSchema<undefined>;
1518
1576
  /**
1519
- * How many agent reads were handed this note **before** this one — so a
1520
- * note reaching an agent for the first time reports `0`.
1577
+ * How many agent reads were handed this comment **before** this one — so a
1578
+ * comment reaching an agent for the first time reports `0`.
1521
1579
  *
1522
1580
  * It is the stored count as it read at the moment the response was built;
1523
1581
  * the serve this response *is* has not been counted yet. Excluded rather
@@ -1526,60 +1584,70 @@ export declare const ItemNoteWithSubjectSchema: v.ObjectSchema<{
1526
1584
  * a number that is sometimes off by one is worse than one that is
1527
1585
  * consistently the prior total.
1528
1586
  *
1529
- * So `deliveredCount > 0` means an earlier read was handed this note, and
1587
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
1530
1588
  * `0` means this read is the first. Neither says a model took it in — only
1531
1589
  * that the server handed it over.
1532
1590
  */
1533
1591
  readonly deliveredCount: v.NumberSchema<undefined>;
1534
1592
  /**
1535
- * This note's thread root — its own id for every note written today, since
1536
- * no reply exists yet. Ignorable now; load-bearing once a reply is a second
1537
- * row with a different id here. It is on the wire from the first response
1593
+ * This comment's thread root — its own id for every delivered root. Resolution
1594
+ * replies remain on the dashboard thread and are not delivered to agents.
1595
+ * It is on the wire from the first response
1538
1596
  * because the wire contract is consumed by installed CLI versions: reshaping
1539
- * a flat `notes` array into threads-of-notes later would be a breaking
1597
+ * a flat `comments` array into threads-of-comments later would be a breaking
1540
1598
  * change, while a field today's readers ignore costs them nothing.
1541
1599
  */
1542
1600
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1543
1601
  /**
1544
- * Always `null` today — no reply exists to point at. Present now so an older
1545
- * reader meeting a future response that carries real replies degrades to
1546
- * "a flat list of notes" rather than failing to parse.
1602
+ * Always `null` for a delivered root. Present so an older reader meeting a
1603
+ * future response that carries real replies degrades to
1604
+ * "a flat list of comments" rather than failing to parse.
1547
1605
  */
1548
1606
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
1549
1607
  }, undefined>;
1550
- export type ItemNoteWithSubject = v.InferOutput<typeof ItemNoteWithSubjectSchema>;
1608
+ export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
1551
1609
  /**
1552
- * Every open note waiting for this reader across the bundles they named.
1610
+ * Every open comment waiting for this reader across the bundles they named.
1553
1611
  *
1554
- * **This read is a delivery and is counted as one**, exactly as notes riding
1612
+ * **This read is a delivery and is counted as one**, exactly as comments riding
1555
1613
  * an item are: a body reached an agent. What it is *not* is an announcement —
1556
1614
  * nothing here touches the per-repo announcement count, so asking to read your
1557
- * notes never spends the interruptions the hook is allowed.
1615
+ * comments never spends the interruptions the hook is allowed.
1558
1616
  *
1559
1617
  * **Never capped.** The announcement cap governs whether a hook speaks; a
1560
- * reader who asked is owed every open note, and hiding one here would retire a
1618
+ * reader who asked is owed every open comment, and hiding one here would retire a
1561
1619
  * person's request without anybody deciding to.
1562
1620
  */
1563
- export declare const ItemNotesResponseSchema: v.ObjectSchema<{
1564
- readonly notes: v.ArraySchema<v.ObjectSchema<{
1565
- /** The item the note is about, as the wire names it. */
1621
+ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
1622
+ readonly comments: v.ArraySchema<v.ObjectSchema<{
1623
+ /** The item the comment is about, as the wire names it. */
1566
1624
  readonly itemName: v.StringSchema<undefined>;
1567
1625
  /** The item's declared repo-relative path, or null when it has none. */
1568
1626
  readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1569
1627
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1570
- /** The note's text, already wrapped in the response's untrusted markers. */
1628
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
1629
+ /** Current source location of an anchored passage, or its lost quote. */
1630
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
1631
+ readonly quote: v.StringSchema<undefined>;
1632
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
1633
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
1634
+ readonly start: v.NumberSchema<undefined>;
1635
+ readonly end: v.NumberSchema<undefined>;
1636
+ }, undefined>, undefined>;
1637
+ }, undefined>, undefined>;
1638
+ /** The comment's text, already wrapped in the response's untrusted markers. */
1571
1639
  readonly body: v.StringSchema<undefined>;
1572
1640
  /** The author's display name as the workspace shows it, or null. Never an email. */
1573
1641
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1574
1642
  /** ISO timestamp, machine format. */
1575
1643
  readonly createdAt: v.StringSchema<undefined>;
1576
- /** The item's content version the note was written against. */
1644
+ /** The item's content version the comment was written against. */
1577
1645
  readonly itemVersion: v.NumberSchema<undefined>;
1578
1646
  /** True when the item's current version is greater than `itemVersion`. */
1579
1647
  readonly itemChangedSince: v.BooleanSchema<undefined>;
1580
1648
  /**
1581
- * How many agent reads were handed this note **before** this one — so a
1582
- * note reaching an agent for the first time reports `0`.
1649
+ * How many agent reads were handed this comment **before** this one — so a
1650
+ * comment reaching an agent for the first time reports `0`.
1583
1651
  *
1584
1652
  * It is the stored count as it read at the moment the response was built;
1585
1653
  * the serve this response *is* has not been counted yet. Excluded rather
@@ -1588,30 +1656,31 @@ export declare const ItemNotesResponseSchema: v.ObjectSchema<{
1588
1656
  * a number that is sometimes off by one is worse than one that is
1589
1657
  * consistently the prior total.
1590
1658
  *
1591
- * So `deliveredCount > 0` means an earlier read was handed this note, and
1659
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
1592
1660
  * `0` means this read is the first. Neither says a model took it in — only
1593
1661
  * that the server handed it over.
1594
1662
  */
1595
1663
  readonly deliveredCount: v.NumberSchema<undefined>;
1596
1664
  /**
1597
- * This note's thread root — its own id for every note written today, since
1598
- * no reply exists yet. Ignorable now; load-bearing once a reply is a second
1599
- * row with a different id here. It is on the wire from the first response
1665
+ * This comment's thread root — its own id for every delivered root. Resolution
1666
+ * replies remain on the dashboard thread and are not delivered to agents.
1667
+ * It is on the wire from the first response
1600
1668
  * because the wire contract is consumed by installed CLI versions: reshaping
1601
- * a flat `notes` array into threads-of-notes later would be a breaking
1669
+ * a flat `comments` array into threads-of-comments later would be a breaking
1602
1670
  * change, while a field today's readers ignore costs them nothing.
1603
1671
  */
1604
1672
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1605
1673
  /**
1606
- * Always `null` today — no reply exists to point at. Present now so an older
1607
- * reader meeting a future response that carries real replies degrades to
1608
- * "a flat list of notes" rather than failing to parse.
1674
+ * Always `null` for a delivered root. Present so an older reader meeting a
1675
+ * future response that carries real replies degrades to
1676
+ * "a flat list of comments" rather than failing to parse.
1609
1677
  */
1610
1678
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
1611
1679
  }, undefined>, undefined>;
1680
+ readonly cursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1612
1681
  /**
1613
1682
  * The markers every `body` above is wrapped in, plus a statement of what
1614
- * they mean. Present exactly when at least one note came back.
1683
+ * they mean. Present exactly when at least one comment came back.
1615
1684
  */
1616
1685
  readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
1617
1686
  readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -1620,7 +1689,7 @@ export declare const ItemNotesResponseSchema: v.ObjectSchema<{
1620
1689
  readonly note: v.StringSchema<undefined>;
1621
1690
  }, undefined>, undefined>, undefined>;
1622
1691
  }, undefined>;
1623
- export type ItemNotesResponse = v.InferOutput<typeof ItemNotesResponseSchema>;
1692
+ export type ItemCommentsResponse = v.InferOutput<typeof ItemCommentsResponseSchema>;
1624
1693
  /** Max number of context item ids a push may cite as its transform sources. */
1625
1694
  export declare const MAX_TRANSFORM_SOURCE_IDS = 100;
1626
1695
  /**
@@ -1738,31 +1807,41 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
1738
1807
  path: string;
1739
1808
  }[], 8, undefined>]>, undefined>;
1740
1809
  /**
1741
- * Open notes a person left about this item, newest first.
1810
+ * Open comments a person left about this item, newest first.
1742
1811
  *
1743
1812
  * Optional, and absent rather than empty when there are none — the same rule
1744
1813
  * `aliases` and `projectId` follow above, and for the same reason: an older
1745
1814
  * reader against a newer server ignores the key, and a newer reader against
1746
- * an older server reads "no notes" instead of failing.
1815
+ * an older server reads "no comments" instead of failing.
1747
1816
  *
1748
- * **Absence is not a verdict.** No notes here means none were served on this
1817
+ * **Absence is not a verdict.** No comments here means none were served on this
1749
1818
  * item in this response — not that nobody has anything to say about it.
1750
1819
  */
1751
- readonly notes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
1820
+ readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
1752
1821
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1753
- /** The note's text, already wrapped in the response's untrusted markers. */
1822
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
1823
+ /** Current source location of an anchored passage, or its lost quote. */
1824
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
1825
+ readonly quote: v.StringSchema<undefined>;
1826
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
1827
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
1828
+ readonly start: v.NumberSchema<undefined>;
1829
+ readonly end: v.NumberSchema<undefined>;
1830
+ }, undefined>, undefined>;
1831
+ }, undefined>, undefined>;
1832
+ /** The comment's text, already wrapped in the response's untrusted markers. */
1754
1833
  readonly body: v.StringSchema<undefined>;
1755
1834
  /** The author's display name as the workspace shows it, or null. Never an email. */
1756
1835
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1757
1836
  /** ISO timestamp, machine format. */
1758
1837
  readonly createdAt: v.StringSchema<undefined>;
1759
- /** The item's content version the note was written against. */
1838
+ /** The item's content version the comment was written against. */
1760
1839
  readonly itemVersion: v.NumberSchema<undefined>;
1761
1840
  /** True when the item's current version is greater than `itemVersion`. */
1762
1841
  readonly itemChangedSince: v.BooleanSchema<undefined>;
1763
1842
  /**
1764
- * How many agent reads were handed this note **before** this one — so a
1765
- * note reaching an agent for the first time reports `0`.
1843
+ * How many agent reads were handed this comment **before** this one — so a
1844
+ * comment reaching an agent for the first time reports `0`.
1766
1845
  *
1767
1846
  * It is the stored count as it read at the moment the response was built;
1768
1847
  * the serve this response *is* has not been counted yet. Excluded rather
@@ -1771,28 +1850,37 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
1771
1850
  * a number that is sometimes off by one is worse than one that is
1772
1851
  * consistently the prior total.
1773
1852
  *
1774
- * So `deliveredCount > 0` means an earlier read was handed this note, and
1853
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
1775
1854
  * `0` means this read is the first. Neither says a model took it in — only
1776
1855
  * that the server handed it over.
1777
1856
  */
1778
1857
  readonly deliveredCount: v.NumberSchema<undefined>;
1779
1858
  /**
1780
- * This note's thread root — its own id for every note written today, since
1781
- * no reply exists yet. Ignorable now; load-bearing once a reply is a second
1782
- * row with a different id here. It is on the wire from the first response
1859
+ * This comment's thread root — its own id for every delivered root. Resolution
1860
+ * replies remain on the dashboard thread and are not delivered to agents.
1861
+ * It is on the wire from the first response
1783
1862
  * because the wire contract is consumed by installed CLI versions: reshaping
1784
- * a flat `notes` array into threads-of-notes later would be a breaking
1863
+ * a flat `comments` array into threads-of-comments later would be a breaking
1785
1864
  * change, while a field today's readers ignore costs them nothing.
1786
1865
  */
1787
1866
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1788
1867
  /**
1789
- * Always `null` today — no reply exists to point at. Present now so an older
1790
- * reader meeting a future response that carries real replies degrades to
1791
- * "a flat list of notes" rather than failing to parse.
1868
+ * Always `null` for a delivered root. Present so an older reader meeting a
1869
+ * future response that carries real replies degrades to
1870
+ * "a flat list of comments" rather than failing to parse.
1792
1871
  */
1793
1872
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
1794
1873
  }, undefined>, undefined>, v.MaxLengthAction<{
1795
1874
  id: string;
1875
+ state?: "open" | "resolved" | undefined;
1876
+ passage?: {
1877
+ quote: string;
1878
+ status: "located" | "changed" | "orphaned";
1879
+ lines: {
1880
+ start: number;
1881
+ end: number;
1882
+ } | null;
1883
+ } | undefined;
1796
1884
  body: string;
1797
1885
  authorName: string | null;
1798
1886
  createdAt: string;
@@ -1988,31 +2076,41 @@ export declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
1988
2076
  path: string;
1989
2077
  }[], 8, undefined>]>, undefined>;
1990
2078
  /**
1991
- * Open notes a person left about this item, newest first.
2079
+ * Open comments a person left about this item, newest first.
1992
2080
  *
1993
2081
  * Optional, and absent rather than empty when there are none — the same rule
1994
2082
  * `aliases` and `projectId` follow above, and for the same reason: an older
1995
2083
  * reader against a newer server ignores the key, and a newer reader against
1996
- * an older server reads "no notes" instead of failing.
2084
+ * an older server reads "no comments" instead of failing.
1997
2085
  *
1998
- * **Absence is not a verdict.** No notes here means none were served on this
2086
+ * **Absence is not a verdict.** No comments here means none were served on this
1999
2087
  * item in this response — not that nobody has anything to say about it.
2000
2088
  */
2001
- readonly notes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
2089
+ readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
2002
2090
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2003
- /** The note's text, already wrapped in the response's untrusted markers. */
2091
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
2092
+ /** Current source location of an anchored passage, or its lost quote. */
2093
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
2094
+ readonly quote: v.StringSchema<undefined>;
2095
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
2096
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
2097
+ readonly start: v.NumberSchema<undefined>;
2098
+ readonly end: v.NumberSchema<undefined>;
2099
+ }, undefined>, undefined>;
2100
+ }, undefined>, undefined>;
2101
+ /** The comment's text, already wrapped in the response's untrusted markers. */
2004
2102
  readonly body: v.StringSchema<undefined>;
2005
2103
  /** The author's display name as the workspace shows it, or null. Never an email. */
2006
2104
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2007
2105
  /** ISO timestamp, machine format. */
2008
2106
  readonly createdAt: v.StringSchema<undefined>;
2009
- /** The item's content version the note was written against. */
2107
+ /** The item's content version the comment was written against. */
2010
2108
  readonly itemVersion: v.NumberSchema<undefined>;
2011
2109
  /** True when the item's current version is greater than `itemVersion`. */
2012
2110
  readonly itemChangedSince: v.BooleanSchema<undefined>;
2013
2111
  /**
2014
- * How many agent reads were handed this note **before** this one — so a
2015
- * note reaching an agent for the first time reports `0`.
2112
+ * How many agent reads were handed this comment **before** this one — so a
2113
+ * comment reaching an agent for the first time reports `0`.
2016
2114
  *
2017
2115
  * It is the stored count as it read at the moment the response was built;
2018
2116
  * the serve this response *is* has not been counted yet. Excluded rather
@@ -2021,28 +2119,37 @@ export declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
2021
2119
  * a number that is sometimes off by one is worse than one that is
2022
2120
  * consistently the prior total.
2023
2121
  *
2024
- * So `deliveredCount > 0` means an earlier read was handed this note, and
2122
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
2025
2123
  * `0` means this read is the first. Neither says a model took it in — only
2026
2124
  * that the server handed it over.
2027
2125
  */
2028
2126
  readonly deliveredCount: v.NumberSchema<undefined>;
2029
2127
  /**
2030
- * This note's thread root — its own id for every note written today, since
2031
- * no reply exists yet. Ignorable now; load-bearing once a reply is a second
2032
- * row with a different id here. It is on the wire from the first response
2128
+ * This comment's thread root — its own id for every delivered root. Resolution
2129
+ * replies remain on the dashboard thread and are not delivered to agents.
2130
+ * It is on the wire from the first response
2033
2131
  * because the wire contract is consumed by installed CLI versions: reshaping
2034
- * a flat `notes` array into threads-of-notes later would be a breaking
2132
+ * a flat `comments` array into threads-of-comments later would be a breaking
2035
2133
  * change, while a field today's readers ignore costs them nothing.
2036
2134
  */
2037
2135
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2038
2136
  /**
2039
- * Always `null` today — no reply exists to point at. Present now so an older
2040
- * reader meeting a future response that carries real replies degrades to
2041
- * "a flat list of notes" rather than failing to parse.
2137
+ * Always `null` for a delivered root. Present so an older reader meeting a
2138
+ * future response that carries real replies degrades to
2139
+ * "a flat list of comments" rather than failing to parse.
2042
2140
  */
2043
2141
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
2044
2142
  }, undefined>, undefined>, v.MaxLengthAction<{
2045
2143
  id: string;
2144
+ state?: "open" | "resolved" | undefined;
2145
+ passage?: {
2146
+ quote: string;
2147
+ status: "located" | "changed" | "orphaned";
2148
+ lines: {
2149
+ start: number;
2150
+ end: number;
2151
+ } | null;
2152
+ } | undefined;
2046
2153
  body: string;
2047
2154
  authorName: string | null;
2048
2155
  createdAt: string;
@@ -2188,7 +2295,7 @@ export declare const UpdateContextItemBodySchema: Omit<v.ObjectSchema<{
2188
2295
  * is two answers to one question and the route refuses it rather than picking.
2189
2296
  */
2190
2297
  readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
2191
- }, undefined>, "entries" | "~types" | "~run" | "~standard"> & {
2298
+ }, undefined>, "~types" | "~run" | "~standard" | "entries"> & {
2192
2299
  readonly entries: Omit<{
2193
2300
  readonly itemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2194
2301
  readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
@@ -2292,7 +2399,7 @@ export declare const UpdateContextItemBodySchema: Omit<v.ObjectSchema<{
2292
2399
  } | undefined;
2293
2400
  removed?: true | undefined;
2294
2401
  sourceItemIds?: string[] | undefined;
2295
- }, v.StringIssue | v.MinLengthIssue<string, 1> | v.RegexIssue<string> | v.CheckIssue<string> | v.NumberIssue | v.IntegerIssue<number> | v.ArrayIssue | v.ObjectIssue | v.MinValueIssue<number, 1> | v.MaxLengthIssue<string, 128> | v.MaxLengthIssue<string, 200> | v.MaxLengthIssue<string, 255> | v.LiteralIssue | v.MaxLengthIssue<string[], 100>>;
2402
+ }, v.ObjectIssue | v.StringIssue | v.MinLengthIssue<string, 1> | v.NumberIssue | v.IntegerIssue<number> | v.MinValueIssue<number, 1> | v.RegexIssue<string> | v.CheckIssue<string> | v.ArrayIssue | v.MaxLengthIssue<string, 128> | v.MaxLengthIssue<string, 200> | v.MaxLengthIssue<string, 255> | v.LiteralIssue | v.MaxLengthIssue<string[], 100>>;
2296
2403
  readonly "~types"?: {
2297
2404
  readonly input: {
2298
2405
  name?: string | undefined;
@@ -2320,7 +2427,7 @@ export declare const UpdateContextItemBodySchema: Omit<v.ObjectSchema<{
2320
2427
  removed?: true | undefined;
2321
2428
  sourceItemIds?: string[] | undefined;
2322
2429
  };
2323
- readonly issue: v.StringIssue | v.MinLengthIssue<string, 1> | v.RegexIssue<string> | v.CheckIssue<string> | v.NumberIssue | v.IntegerIssue<number> | v.ArrayIssue | v.ObjectIssue | v.MinValueIssue<number, 1> | v.MaxLengthIssue<string, 128> | v.MaxLengthIssue<string, 200> | v.MaxLengthIssue<string, 255> | v.LiteralIssue | v.MaxLengthIssue<string[], 100>;
2430
+ readonly issue: v.ObjectIssue | v.StringIssue | v.MinLengthIssue<string, 1> | v.NumberIssue | v.IntegerIssue<number> | v.MinValueIssue<number, 1> | v.RegexIssue<string> | v.CheckIssue<string> | v.ArrayIssue | v.MaxLengthIssue<string, 128> | v.MaxLengthIssue<string, 200> | v.MaxLengthIssue<string, 255> | v.LiteralIssue | v.MaxLengthIssue<string[], 100>;
2324
2431
  } | undefined;
2325
2432
  };
2326
2433
  /** A single canonical item, for the item-scoped read route. */
@@ -2373,31 +2480,41 @@ export declare const ContextItemResponseSchema: v.ObjectSchema<{
2373
2480
  path: string;
2374
2481
  }[], 8, undefined>]>, undefined>;
2375
2482
  /**
2376
- * Open notes a person left about this item, newest first.
2483
+ * Open comments a person left about this item, newest first.
2377
2484
  *
2378
2485
  * Optional, and absent rather than empty when there are none — the same rule
2379
2486
  * `aliases` and `projectId` follow above, and for the same reason: an older
2380
2487
  * reader against a newer server ignores the key, and a newer reader against
2381
- * an older server reads "no notes" instead of failing.
2488
+ * an older server reads "no comments" instead of failing.
2382
2489
  *
2383
- * **Absence is not a verdict.** No notes here means none were served on this
2490
+ * **Absence is not a verdict.** No comments here means none were served on this
2384
2491
  * item in this response — not that nobody has anything to say about it.
2385
2492
  */
2386
- readonly notes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
2493
+ readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
2387
2494
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2388
- /** The note's text, already wrapped in the response's untrusted markers. */
2495
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
2496
+ /** Current source location of an anchored passage, or its lost quote. */
2497
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
2498
+ readonly quote: v.StringSchema<undefined>;
2499
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
2500
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
2501
+ readonly start: v.NumberSchema<undefined>;
2502
+ readonly end: v.NumberSchema<undefined>;
2503
+ }, undefined>, undefined>;
2504
+ }, undefined>, undefined>;
2505
+ /** The comment's text, already wrapped in the response's untrusted markers. */
2389
2506
  readonly body: v.StringSchema<undefined>;
2390
2507
  /** The author's display name as the workspace shows it, or null. Never an email. */
2391
2508
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2392
2509
  /** ISO timestamp, machine format. */
2393
2510
  readonly createdAt: v.StringSchema<undefined>;
2394
- /** The item's content version the note was written against. */
2511
+ /** The item's content version the comment was written against. */
2395
2512
  readonly itemVersion: v.NumberSchema<undefined>;
2396
2513
  /** True when the item's current version is greater than `itemVersion`. */
2397
2514
  readonly itemChangedSince: v.BooleanSchema<undefined>;
2398
2515
  /**
2399
- * How many agent reads were handed this note **before** this one — so a
2400
- * note reaching an agent for the first time reports `0`.
2516
+ * How many agent reads were handed this comment **before** this one — so a
2517
+ * comment reaching an agent for the first time reports `0`.
2401
2518
  *
2402
2519
  * It is the stored count as it read at the moment the response was built;
2403
2520
  * the serve this response *is* has not been counted yet. Excluded rather
@@ -2406,28 +2523,37 @@ export declare const ContextItemResponseSchema: v.ObjectSchema<{
2406
2523
  * a number that is sometimes off by one is worse than one that is
2407
2524
  * consistently the prior total.
2408
2525
  *
2409
- * So `deliveredCount > 0` means an earlier read was handed this note, and
2526
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
2410
2527
  * `0` means this read is the first. Neither says a model took it in — only
2411
2528
  * that the server handed it over.
2412
2529
  */
2413
2530
  readonly deliveredCount: v.NumberSchema<undefined>;
2414
2531
  /**
2415
- * This note's thread root — its own id for every note written today, since
2416
- * no reply exists yet. Ignorable now; load-bearing once a reply is a second
2417
- * row with a different id here. It is on the wire from the first response
2532
+ * This comment's thread root — its own id for every delivered root. Resolution
2533
+ * replies remain on the dashboard thread and are not delivered to agents.
2534
+ * It is on the wire from the first response
2418
2535
  * because the wire contract is consumed by installed CLI versions: reshaping
2419
- * a flat `notes` array into threads-of-notes later would be a breaking
2536
+ * a flat `comments` array into threads-of-comments later would be a breaking
2420
2537
  * change, while a field today's readers ignore costs them nothing.
2421
2538
  */
2422
2539
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2423
2540
  /**
2424
- * Always `null` today — no reply exists to point at. Present now so an older
2425
- * reader meeting a future response that carries real replies degrades to
2426
- * "a flat list of notes" rather than failing to parse.
2541
+ * Always `null` for a delivered root. Present so an older reader meeting a
2542
+ * future response that carries real replies degrades to
2543
+ * "a flat list of comments" rather than failing to parse.
2427
2544
  */
2428
2545
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
2429
2546
  }, undefined>, undefined>, v.MaxLengthAction<{
2430
2547
  id: string;
2548
+ state?: "open" | "resolved" | undefined;
2549
+ passage?: {
2550
+ quote: string;
2551
+ status: "located" | "changed" | "orphaned";
2552
+ lines: {
2553
+ start: number;
2554
+ end: number;
2555
+ } | null;
2556
+ } | undefined;
2431
2557
  body: string;
2432
2558
  authorName: string | null;
2433
2559
  createdAt: string;
@@ -2557,31 +2683,41 @@ export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
2557
2683
  path: string;
2558
2684
  }[], 8, undefined>]>, undefined>;
2559
2685
  /**
2560
- * Open notes a person left about this item, newest first.
2686
+ * Open comments a person left about this item, newest first.
2561
2687
  *
2562
2688
  * Optional, and absent rather than empty when there are none — the same rule
2563
2689
  * `aliases` and `projectId` follow above, and for the same reason: an older
2564
2690
  * reader against a newer server ignores the key, and a newer reader against
2565
- * an older server reads "no notes" instead of failing.
2691
+ * an older server reads "no comments" instead of failing.
2566
2692
  *
2567
- * **Absence is not a verdict.** No notes here means none were served on this
2693
+ * **Absence is not a verdict.** No comments here means none were served on this
2568
2694
  * item in this response — not that nobody has anything to say about it.
2569
2695
  */
2570
- readonly notes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
2696
+ readonly comments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
2571
2697
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2572
- /** The note's text, already wrapped in the response's untrusted markers. */
2698
+ readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
2699
+ /** Current source location of an anchored passage, or its lost quote. */
2700
+ readonly passage: v.OptionalSchema<v.ObjectSchema<{
2701
+ readonly quote: v.StringSchema<undefined>;
2702
+ readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
2703
+ readonly lines: v.NullableSchema<v.ObjectSchema<{
2704
+ readonly start: v.NumberSchema<undefined>;
2705
+ readonly end: v.NumberSchema<undefined>;
2706
+ }, undefined>, undefined>;
2707
+ }, undefined>, undefined>;
2708
+ /** The comment's text, already wrapped in the response's untrusted markers. */
2573
2709
  readonly body: v.StringSchema<undefined>;
2574
2710
  /** The author's display name as the workspace shows it, or null. Never an email. */
2575
2711
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2576
2712
  /** ISO timestamp, machine format. */
2577
2713
  readonly createdAt: v.StringSchema<undefined>;
2578
- /** The item's content version the note was written against. */
2714
+ /** The item's content version the comment was written against. */
2579
2715
  readonly itemVersion: v.NumberSchema<undefined>;
2580
2716
  /** True when the item's current version is greater than `itemVersion`. */
2581
2717
  readonly itemChangedSince: v.BooleanSchema<undefined>;
2582
2718
  /**
2583
- * How many agent reads were handed this note **before** this one — so a
2584
- * note reaching an agent for the first time reports `0`.
2719
+ * How many agent reads were handed this comment **before** this one — so a
2720
+ * comment reaching an agent for the first time reports `0`.
2585
2721
  *
2586
2722
  * It is the stored count as it read at the moment the response was built;
2587
2723
  * the serve this response *is* has not been counted yet. Excluded rather
@@ -2590,28 +2726,37 @@ export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
2590
2726
  * a number that is sometimes off by one is worse than one that is
2591
2727
  * consistently the prior total.
2592
2728
  *
2593
- * So `deliveredCount > 0` means an earlier read was handed this note, and
2729
+ * So `deliveredCount > 0` means an earlier read was handed this comment, and
2594
2730
  * `0` means this read is the first. Neither says a model took it in — only
2595
2731
  * that the server handed it over.
2596
2732
  */
2597
2733
  readonly deliveredCount: v.NumberSchema<undefined>;
2598
2734
  /**
2599
- * This note's thread root — its own id for every note written today, since
2600
- * no reply exists yet. Ignorable now; load-bearing once a reply is a second
2601
- * row with a different id here. It is on the wire from the first response
2735
+ * This comment's thread root — its own id for every delivered root. Resolution
2736
+ * replies remain on the dashboard thread and are not delivered to agents.
2737
+ * It is on the wire from the first response
2602
2738
  * because the wire contract is consumed by installed CLI versions: reshaping
2603
- * a flat `notes` array into threads-of-notes later would be a breaking
2739
+ * a flat `comments` array into threads-of-comments later would be a breaking
2604
2740
  * change, while a field today's readers ignore costs them nothing.
2605
2741
  */
2606
2742
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2607
2743
  /**
2608
- * Always `null` today — no reply exists to point at. Present now so an older
2609
- * reader meeting a future response that carries real replies degrades to
2610
- * "a flat list of notes" rather than failing to parse.
2744
+ * Always `null` for a delivered root. Present so an older reader meeting a
2745
+ * future response that carries real replies degrades to
2746
+ * "a flat list of comments" rather than failing to parse.
2611
2747
  */
2612
2748
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
2613
2749
  }, undefined>, undefined>, v.MaxLengthAction<{
2614
2750
  id: string;
2751
+ state?: "open" | "resolved" | undefined;
2752
+ passage?: {
2753
+ quote: string;
2754
+ status: "located" | "changed" | "orphaned";
2755
+ lines: {
2756
+ start: number;
2757
+ end: number;
2758
+ } | null;
2759
+ } | undefined;
2615
2760
  body: string;
2616
2761
  authorName: string | null;
2617
2762
  createdAt: string;
@@ -4531,8 +4676,17 @@ export declare function parseContextItem(data: unknown): {
4531
4676
  root: "project" | "global";
4532
4677
  path: string;
4533
4678
  }[] | undefined;
4534
- notes?: {
4679
+ comments?: {
4535
4680
  id: string;
4681
+ state?: "open" | "resolved" | undefined;
4682
+ passage?: {
4683
+ quote: string;
4684
+ status: "located" | "changed" | "orphaned";
4685
+ lines: {
4686
+ start: number;
4687
+ end: number;
4688
+ } | null;
4689
+ } | undefined;
4536
4690
  body: string;
4537
4691
  authorName: string | null;
4538
4692
  createdAt: string;
@@ -4568,8 +4722,17 @@ export declare function parseContextItemsResponse(data: unknown): {
4568
4722
  root: "project" | "global";
4569
4723
  path: string;
4570
4724
  }[] | undefined;
4571
- notes?: {
4725
+ comments?: {
4572
4726
  id: string;
4727
+ state?: "open" | "resolved" | undefined;
4728
+ passage?: {
4729
+ quote: string;
4730
+ status: "located" | "changed" | "orphaned";
4731
+ lines: {
4732
+ start: number;
4733
+ end: number;
4734
+ } | null;
4735
+ } | undefined;
4573
4736
  body: string;
4574
4737
  authorName: string | null;
4575
4738
  createdAt: string;
@@ -4627,8 +4790,17 @@ export declare function parsePushContextResponse(data: unknown): {
4627
4790
  root: "project" | "global";
4628
4791
  path: string;
4629
4792
  }[] | undefined;
4630
- notes?: {
4793
+ comments?: {
4631
4794
  id: string;
4795
+ state?: "open" | "resolved" | undefined;
4796
+ passage?: {
4797
+ quote: string;
4798
+ status: "located" | "changed" | "orphaned";
4799
+ lines: {
4800
+ start: number;
4801
+ end: number;
4802
+ } | null;
4803
+ } | undefined;
4632
4804
  body: string;
4633
4805
  authorName: string | null;
4634
4806
  createdAt: string;
@@ -4680,8 +4852,17 @@ export declare function parseUpdateContextItemResponse(data: unknown): {
4680
4852
  root: "project" | "global";
4681
4853
  path: string;
4682
4854
  }[] | undefined;
4683
- notes?: {
4855
+ comments?: {
4684
4856
  id: string;
4857
+ state?: "open" | "resolved" | undefined;
4858
+ passage?: {
4859
+ quote: string;
4860
+ status: "located" | "changed" | "orphaned";
4861
+ lines: {
4862
+ start: number;
4863
+ end: number;
4864
+ } | null;
4865
+ } | undefined;
4685
4866
  body: string;
4686
4867
  authorName: string | null;
4687
4868
  createdAt: string;
@@ -4732,8 +4913,17 @@ export declare function parseContextItemResponse(data: unknown): {
4732
4913
  root: "project" | "global";
4733
4914
  path: string;
4734
4915
  }[] | undefined;
4735
- notes?: {
4916
+ comments?: {
4736
4917
  id: string;
4918
+ state?: "open" | "resolved" | undefined;
4919
+ passage?: {
4920
+ quote: string;
4921
+ status: "located" | "changed" | "orphaned";
4922
+ lines: {
4923
+ start: number;
4924
+ end: number;
4925
+ } | null;
4926
+ } | undefined;
4737
4927
  body: string;
4738
4928
  authorName: string | null;
4739
4929
  createdAt: string;
@@ -4771,8 +4961,17 @@ export declare function parseArchiveContextItemResponse(data: unknown): {
4771
4961
  root: "project" | "global";
4772
4962
  path: string;
4773
4963
  }[] | undefined;
4774
- notes?: {
4964
+ comments?: {
4775
4965
  id: string;
4966
+ state?: "open" | "resolved" | undefined;
4967
+ passage?: {
4968
+ quote: string;
4969
+ status: "located" | "changed" | "orphaned";
4970
+ lines: {
4971
+ start: number;
4972
+ end: number;
4973
+ } | null;
4974
+ } | undefined;
4776
4975
  body: string;
4777
4976
  authorName: string | null;
4778
4977
  createdAt: string;
@@ -5112,19 +5311,28 @@ export declare function parseGuideHistoryResponse(data: unknown): {
5112
5311
  note: string;
5113
5312
  };
5114
5313
  };
5115
- export declare function parseAnnounceItemNotesRequest(data: unknown): {
5314
+ export declare function parseAnnounceItemCommentsRequest(data: unknown): {
5116
5315
  projectId: string;
5117
5316
  bundleIds: string[];
5118
5317
  };
5119
- export declare function parseAnnounceItemNotesResponse(data: unknown): {
5318
+ export declare function parseAnnounceItemCommentsResponse(data: unknown): {
5120
5319
  open: number;
5121
5320
  announced: number;
5122
5321
  };
5123
- export declare function parseItemNotesResponse(data: unknown): {
5124
- notes: {
5322
+ export declare function parseItemCommentsResponse(data: unknown): {
5323
+ comments: {
5125
5324
  itemName: string;
5126
5325
  itemPath: string | null;
5127
5326
  id: string;
5327
+ state?: "open" | "resolved" | undefined;
5328
+ passage?: {
5329
+ quote: string;
5330
+ status: "located" | "changed" | "orphaned";
5331
+ lines: {
5332
+ start: number;
5333
+ end: number;
5334
+ } | null;
5335
+ } | undefined;
5128
5336
  body: string;
5129
5337
  authorName: string | null;
5130
5338
  createdAt: string;
@@ -5134,6 +5342,7 @@ export declare function parseItemNotesResponse(data: unknown): {
5134
5342
  threadId: string;
5135
5343
  replyToId: string | null;
5136
5344
  }[];
5345
+ cursor?: string | undefined;
5137
5346
  untrusted?: {
5138
5347
  token: string;
5139
5348
  startMarker: string;