@mossbear/protocol 0.1.0-alpha.58 → 0.1.0-alpha.60
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/commentAnchor.d.ts +34 -0
- package/dist/commentAnchor.d.ts.map +1 -0
- package/dist/commentAnchor.js +122 -0
- package/dist/commentAnchor.js.map +1 -0
- package/dist/commentAnchor.test.d.ts +2 -0
- package/dist/commentAnchor.test.d.ts.map +1 -0
- package/dist/commentAnchor.test.js +48 -0
- package/dist/commentAnchor.test.js.map +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/schemas.d.ts +397 -188
- package/dist/schemas.d.ts.map +1 -1
- package/dist/schemas.js +69 -61
- package/dist/schemas.js.map +1 -1
- package/package.json +1 -1
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
|
|
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
|
|
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
|
|
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
|
|
935
|
+
* never the thing that silently drops a comment a person left.
|
|
936
936
|
*/
|
|
937
|
-
export declare const
|
|
937
|
+
export declare const MAX_ITEM_COMMENTS_ON_WIRE = 20;
|
|
938
938
|
/**
|
|
939
|
-
* One
|
|
939
|
+
* One comment a **person** left about a context item, riding the item it is about.
|
|
940
940
|
*
|
|
941
|
-
* A
|
|
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
|
|
951
|
+
export declare const ContextItemCommentSchema: v.ObjectSchema<{
|
|
952
952
|
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
953
|
-
|
|
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
|
|
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
|
|
965
|
-
*
|
|
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
|
|
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
|
|
981
|
-
*
|
|
982
|
-
*
|
|
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 `
|
|
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`
|
|
990
|
-
*
|
|
991
|
-
* "a flat list of
|
|
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
|
|
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
|
|
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
|
|
1105
|
+
* an older server reads "no comments" instead of failing.
|
|
1096
1106
|
*
|
|
1097
|
-
* **Absence is not a verdict.** No
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
1114
|
-
*
|
|
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
|
|
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
|
|
1130
|
-
*
|
|
1131
|
-
*
|
|
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 `
|
|
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`
|
|
1139
|
-
*
|
|
1140
|
-
* "a flat list of
|
|
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
|
|
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
|
|
1306
|
+
* an older server reads "no comments" instead of failing.
|
|
1278
1307
|
*
|
|
1279
|
-
* **Absence is not a verdict.** No
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
1296
|
-
*
|
|
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
|
|
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
|
|
1312
|
-
*
|
|
1313
|
-
*
|
|
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 `
|
|
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`
|
|
1321
|
-
*
|
|
1322
|
-
* "a flat list of
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
1431
|
-
*
|
|
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
|
|
1490
|
+
export declare const MAX_COMMENT_ANNOUNCEMENTS_PER_REPO = 3;
|
|
1443
1491
|
/**
|
|
1444
|
-
* Ask which
|
|
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 `
|
|
1449
|
-
* every subscriber and every repo, so one reader's fill of a
|
|
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
|
|
1500
|
+
* a counter there resets with it, announcing every unresolved comment as new
|
|
1453
1501
|
* forever.
|
|
1454
1502
|
*/
|
|
1455
|
-
export declare const
|
|
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
|
|
1521
|
+
export type AnnounceItemCommentsRequest = v.InferOutput<typeof AnnounceItemCommentsRequestSchema>;
|
|
1474
1522
|
/**
|
|
1475
|
-
* What an announcement answers: how many
|
|
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
|
|
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
|
|
1487
|
-
/** Open, unmuted
|
|
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
|
|
1540
|
+
export type AnnounceItemCommentsResponse = v.InferOutput<typeof AnnounceItemCommentsResponseSchema>;
|
|
1493
1541
|
/**
|
|
1494
|
-
* One
|
|
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
|
|
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
|
|
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
|
|
1503
|
-
/** The item the
|
|
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
|
-
|
|
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
|
|
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
|
|
1520
|
-
*
|
|
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
|
|
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
|
|
1536
|
-
*
|
|
1537
|
-
*
|
|
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 `
|
|
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`
|
|
1545
|
-
*
|
|
1546
|
-
* "a flat list of
|
|
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
|
|
1608
|
+
export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
|
|
1551
1609
|
/**
|
|
1552
|
-
* Every open
|
|
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
|
|
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
|
-
*
|
|
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
|
|
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
|
|
1564
|
-
readonly
|
|
1565
|
-
/** The item the
|
|
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
|
-
|
|
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
|
|
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
|
|
1582
|
-
*
|
|
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
|
|
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
|
|
1598
|
-
*
|
|
1599
|
-
*
|
|
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 `
|
|
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`
|
|
1607
|
-
*
|
|
1608
|
-
* "a flat list of
|
|
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
|
|
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
|
|
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
|
|
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
|
|
1815
|
+
* an older server reads "no comments" instead of failing.
|
|
1747
1816
|
*
|
|
1748
|
-
* **Absence is not a verdict.** No
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
1765
|
-
*
|
|
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
|
|
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
|
|
1781
|
-
*
|
|
1782
|
-
*
|
|
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 `
|
|
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`
|
|
1790
|
-
*
|
|
1791
|
-
* "a flat list of
|
|
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
|
|
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
|
|
2084
|
+
* an older server reads "no comments" instead of failing.
|
|
1997
2085
|
*
|
|
1998
|
-
* **Absence is not a verdict.** No
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
2015
|
-
*
|
|
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
|
|
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
|
|
2031
|
-
*
|
|
2032
|
-
*
|
|
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 `
|
|
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`
|
|
2040
|
-
*
|
|
2041
|
-
* "a flat list of
|
|
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>, "
|
|
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.
|
|
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.
|
|
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
|
|
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
|
|
2488
|
+
* an older server reads "no comments" instead of failing.
|
|
2382
2489
|
*
|
|
2383
|
-
* **Absence is not a verdict.** No
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
2400
|
-
*
|
|
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
|
|
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
|
|
2416
|
-
*
|
|
2417
|
-
*
|
|
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 `
|
|
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`
|
|
2425
|
-
*
|
|
2426
|
-
* "a flat list of
|
|
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
|
|
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
|
|
2691
|
+
* an older server reads "no comments" instead of failing.
|
|
2566
2692
|
*
|
|
2567
|
-
* **Absence is not a verdict.** No
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
2584
|
-
*
|
|
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
|
|
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
|
|
2600
|
-
*
|
|
2601
|
-
*
|
|
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 `
|
|
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`
|
|
2609
|
-
*
|
|
2610
|
-
* "a flat list of
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
5314
|
+
export declare function parseAnnounceItemCommentsRequest(data: unknown): {
|
|
5116
5315
|
projectId: string;
|
|
5117
5316
|
bundleIds: string[];
|
|
5118
5317
|
};
|
|
5119
|
-
export declare function
|
|
5318
|
+
export declare function parseAnnounceItemCommentsResponse(data: unknown): {
|
|
5120
5319
|
open: number;
|
|
5121
5320
|
announced: number;
|
|
5122
5321
|
};
|
|
5123
|
-
export declare function
|
|
5124
|
-
|
|
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;
|