@mossbear/protocol 0.1.0-alpha.92 → 0.1.0-alpha.94
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/artifact.test.js +16 -1
- package/dist/artifact.test.js.map +1 -1
- package/dist/publicModelCatalog.generated.d.ts.map +1 -1
- package/dist/publicModelCatalog.generated.js +20 -0
- package/dist/publicModelCatalog.generated.js.map +1 -1
- package/dist/schemas.d.ts +970 -187
- package/dist/schemas.d.ts.map +1 -1
- package/dist/schemas.js +243 -19
- package/dist/schemas.js.map +1 -1
- package/dist/schemas.test.js +41 -1
- package/dist/schemas.test.js.map +1 -1
- package/dist/types.d.ts +7 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js.map +1 -1
- package/dist/usageOnly.d.ts +33 -4
- package/dist/usageOnly.d.ts.map +1 -1
- package/dist/usageOnly.js +4 -2
- package/dist/usageOnly.js.map +1 -1
- package/dist/usageOnly.test.js +15 -0
- package/dist/usageOnly.test.js.map +1 -1
- package/dist/whatSyncs.d.ts.map +1 -1
- package/dist/whatSyncs.js +1 -0
- package/dist/whatSyncs.js.map +1 -1
- package/package.json +1 -1
package/dist/schemas.d.ts
CHANGED
|
@@ -937,21 +937,44 @@ export declare const RevokeScopedTokenRequestSchema: v.ObjectSchema<{
|
|
|
937
937
|
* release step 2 sends; both are read, and the parsed value is always `artifactId`.
|
|
938
938
|
* Drop `itemId` once no such CLI is left to send it.
|
|
939
939
|
*/
|
|
940
|
+
/** The most artifacts one attach request may name. */
|
|
941
|
+
export declare const MAX_BUNDLE_MEMBERS_PER_ATTACH = 200;
|
|
940
942
|
export declare const AttachBundleMemberRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
941
943
|
readonly artifactId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
942
944
|
readonly itemId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
945
|
+
readonly artifactIds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.TransformAction<string[], string[]>, v.MinLengthAction<string[], 1, undefined>, v.MaxLengthAction<string[], 200, undefined>]>, undefined>;
|
|
943
946
|
}, undefined>, v.CheckAction<{
|
|
944
947
|
artifactId?: string | undefined;
|
|
945
948
|
itemId?: string | undefined;
|
|
946
|
-
|
|
949
|
+
artifactIds?: string[] | undefined;
|
|
950
|
+
}, "A member needs an artifactId, or a list of artifactIds on its own.">, v.TransformAction<{
|
|
947
951
|
artifactId?: string | undefined;
|
|
948
952
|
itemId?: string | undefined;
|
|
953
|
+
artifactIds?: string[] | undefined;
|
|
949
954
|
}, {
|
|
950
955
|
artifactId: string;
|
|
956
|
+
} | {
|
|
957
|
+
artifactIds: string[];
|
|
951
958
|
}>]>;
|
|
952
959
|
export declare const AttachBundleMemberResponseSchema: v.ObjectSchema<{
|
|
953
960
|
readonly attached: v.BooleanSchema<undefined>;
|
|
954
961
|
}, undefined>;
|
|
962
|
+
/**
|
|
963
|
+
* One id's outcome in a list attach. `unavailable` is every refusal that is not
|
|
964
|
+
* a path collision, and reads the same whether the artifact is missing, not the
|
|
965
|
+
* caller's to file or in another workspace, so a list cannot probe which ids
|
|
966
|
+
* exist.
|
|
967
|
+
*/
|
|
968
|
+
export declare const AttachBundleMembersResultSchema: v.ObjectSchema<{
|
|
969
|
+
readonly artifactId: v.StringSchema<undefined>;
|
|
970
|
+
readonly status: v.PicklistSchema<["added", "already_there", "unavailable", "path_taken"], undefined>;
|
|
971
|
+
}, undefined>;
|
|
972
|
+
export declare const AttachBundleMembersResponseSchema: v.ObjectSchema<{
|
|
973
|
+
readonly results: v.ArraySchema<v.ObjectSchema<{
|
|
974
|
+
readonly artifactId: v.StringSchema<undefined>;
|
|
975
|
+
readonly status: v.PicklistSchema<["added", "already_there", "unavailable", "path_taken"], undefined>;
|
|
976
|
+
}, undefined>, undefined>;
|
|
977
|
+
}, undefined>;
|
|
955
978
|
export declare const DetachBundleMemberResponseSchema: v.ObjectSchema<{
|
|
956
979
|
readonly detached: v.BooleanSchema<undefined>;
|
|
957
980
|
}, undefined>;
|
|
@@ -1073,6 +1096,24 @@ export type GuideHistoryUntrusted = v.InferOutput<typeof GuideHistoryUntrustedSc
|
|
|
1073
1096
|
* never the thing that silently drops a comment a person left.
|
|
1074
1097
|
*/
|
|
1075
1098
|
export declare const MAX_ITEM_COMMENTS_ON_WIRE = 20;
|
|
1099
|
+
/**
|
|
1100
|
+
* How many replies one delivered thread carries, the newest kept. A thread past
|
|
1101
|
+
* it says how many it held back (`repliesWithheld`), so a cut is never silent.
|
|
1102
|
+
*/
|
|
1103
|
+
export declare const MAX_REPLIES_PER_THREAD_ON_WIRE = 10;
|
|
1104
|
+
/**
|
|
1105
|
+
* The most entries one item's `comments` can hold once threads ride it: a
|
|
1106
|
+
* person's allowance of roots plus an agent's own, each followed by its replies.
|
|
1107
|
+
* A client that does not render threads is sent roots alone, which stay within
|
|
1108
|
+
* `MAX_ITEM_COMMENTS_ON_WIRE`.
|
|
1109
|
+
*/
|
|
1110
|
+
export declare const MAX_ITEM_THREAD_ENTRIES_ON_WIRE: number;
|
|
1111
|
+
/**
|
|
1112
|
+
* Who wrote a comment. An agent writes under its person's account, so the
|
|
1113
|
+
* author's name alone cannot tell a person's answer from an agent's message.
|
|
1114
|
+
*/
|
|
1115
|
+
export declare const CommentAuthorKindSchema: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
|
|
1116
|
+
export type CommentAuthorKind = v.InferOutput<typeof CommentAuthorKindSchema>;
|
|
1076
1117
|
/** What a finding rests on: graded sessions, how loads read a skill, or the rubric alone. */
|
|
1077
1118
|
export declare const FindingTierSchema: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
1078
1119
|
export type FindingTier = v.InferOutput<typeof FindingTierSchema>;
|
|
@@ -1147,6 +1188,12 @@ export declare const ArtifactCommentSchema: v.ObjectSchema<{
|
|
|
1147
1188
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
1148
1189
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
1149
1190
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
1191
|
+
/**
|
|
1192
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
1193
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
1194
|
+
* server never sends a reply to a client too old to read this.
|
|
1195
|
+
*/
|
|
1196
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
1150
1197
|
/** ISO timestamp, machine format. */
|
|
1151
1198
|
readonly createdAt: v.StringSchema<undefined>;
|
|
1152
1199
|
/** The item's content version the comment was written against. */
|
|
@@ -1170,20 +1217,28 @@ export declare const ArtifactCommentSchema: v.ObjectSchema<{
|
|
|
1170
1217
|
*/
|
|
1171
1218
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
1172
1219
|
/**
|
|
1173
|
-
* This comment's thread root
|
|
1174
|
-
*
|
|
1175
|
-
*
|
|
1176
|
-
*
|
|
1177
|
-
*
|
|
1178
|
-
*
|
|
1220
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
1221
|
+
*
|
|
1222
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
1223
|
+
* first. Only a client that reports a version able to render threads is
|
|
1224
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
1225
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
1226
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
1227
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
1228
|
+
* question that reply answers, not a request of its own.
|
|
1179
1229
|
*/
|
|
1180
1230
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
1181
1231
|
/**
|
|
1182
|
-
*
|
|
1183
|
-
*
|
|
1184
|
-
* "a flat list of comments" rather than failing to parse.
|
|
1232
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
1233
|
+
* a reply's parent is always its root.
|
|
1185
1234
|
*/
|
|
1186
1235
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
1236
|
+
/**
|
|
1237
|
+
* On a root whose thread held more replies than
|
|
1238
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
1239
|
+
* Absent when the whole thread was sent.
|
|
1240
|
+
*/
|
|
1241
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
1187
1242
|
}, undefined>;
|
|
1188
1243
|
export type ArtifactComment = v.InferOutput<typeof ArtifactCommentSchema>;
|
|
1189
1244
|
/** The item routes' name for `ArtifactCommentSchema`, kept while those routes are served. */
|
|
@@ -1226,6 +1281,12 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
|
|
|
1226
1281
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
1227
1282
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
1228
1283
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
1284
|
+
/**
|
|
1285
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
1286
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
1287
|
+
* server never sends a reply to a client too old to read this.
|
|
1288
|
+
*/
|
|
1289
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
1229
1290
|
/** ISO timestamp, machine format. */
|
|
1230
1291
|
readonly createdAt: v.StringSchema<undefined>;
|
|
1231
1292
|
/** The item's content version the comment was written against. */
|
|
@@ -1249,20 +1310,28 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
|
|
|
1249
1310
|
*/
|
|
1250
1311
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
1251
1312
|
/**
|
|
1252
|
-
* This comment's thread root
|
|
1253
|
-
*
|
|
1254
|
-
*
|
|
1255
|
-
*
|
|
1256
|
-
*
|
|
1257
|
-
*
|
|
1313
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
1314
|
+
*
|
|
1315
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
1316
|
+
* first. Only a client that reports a version able to render threads is
|
|
1317
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
1318
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
1319
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
1320
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
1321
|
+
* question that reply answers, not a request of its own.
|
|
1258
1322
|
*/
|
|
1259
1323
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
1260
1324
|
/**
|
|
1261
|
-
*
|
|
1262
|
-
*
|
|
1263
|
-
* "a flat list of comments" rather than failing to parse.
|
|
1325
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
1326
|
+
* a reply's parent is always its root.
|
|
1264
1327
|
*/
|
|
1265
1328
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
1329
|
+
/**
|
|
1330
|
+
* On a root whose thread held more replies than
|
|
1331
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
1332
|
+
* Absent when the whole thread was sent.
|
|
1333
|
+
*/
|
|
1334
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
1266
1335
|
}, undefined>;
|
|
1267
1336
|
export type ContextItemComment = ArtifactComment;
|
|
1268
1337
|
/**
|
|
@@ -1305,9 +1374,10 @@ export declare const GitSourceSchema: v.ObjectSchema<{
|
|
|
1305
1374
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
1306
1375
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
1307
1376
|
/**
|
|
1308
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
1309
|
-
*
|
|
1310
|
-
*
|
|
1377
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
1378
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
1379
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
1380
|
+
* one of the published branch itself.
|
|
1311
1381
|
*/
|
|
1312
1382
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
1313
1383
|
}, undefined>;
|
|
@@ -1442,6 +1512,12 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
|
|
|
1442
1512
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
1443
1513
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
1444
1514
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
1515
|
+
/**
|
|
1516
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
1517
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
1518
|
+
* server never sends a reply to a client too old to read this.
|
|
1519
|
+
*/
|
|
1520
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
1445
1521
|
/** ISO timestamp, machine format. */
|
|
1446
1522
|
readonly createdAt: v.StringSchema<undefined>;
|
|
1447
1523
|
/** The item's content version the comment was written against. */
|
|
@@ -1465,20 +1541,28 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
|
|
|
1465
1541
|
*/
|
|
1466
1542
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
1467
1543
|
/**
|
|
1468
|
-
* This comment's thread root
|
|
1469
|
-
*
|
|
1470
|
-
*
|
|
1471
|
-
*
|
|
1472
|
-
*
|
|
1473
|
-
*
|
|
1544
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
1545
|
+
*
|
|
1546
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
1547
|
+
* first. Only a client that reports a version able to render threads is
|
|
1548
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
1549
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
1550
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
1551
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
1552
|
+
* question that reply answers, not a request of its own.
|
|
1474
1553
|
*/
|
|
1475
1554
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
1476
1555
|
/**
|
|
1477
|
-
*
|
|
1478
|
-
*
|
|
1479
|
-
* "a flat list of comments" rather than failing to parse.
|
|
1556
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
1557
|
+
* a reply's parent is always its root.
|
|
1480
1558
|
*/
|
|
1481
1559
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
1560
|
+
/**
|
|
1561
|
+
* On a root whose thread held more replies than
|
|
1562
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
1563
|
+
* Absent when the whole thread was sent.
|
|
1564
|
+
*/
|
|
1565
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
1482
1566
|
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
1483
1567
|
id: string;
|
|
1484
1568
|
state?: "open" | "resolved" | undefined;
|
|
@@ -1499,13 +1583,15 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
|
|
|
1499
1583
|
} | undefined;
|
|
1500
1584
|
approved?: boolean | undefined;
|
|
1501
1585
|
authorName: string | null;
|
|
1586
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
1502
1587
|
createdAt: string;
|
|
1503
1588
|
itemVersion: number;
|
|
1504
1589
|
itemChangedSince: boolean;
|
|
1505
1590
|
deliveredCount: number;
|
|
1506
1591
|
threadId: string;
|
|
1507
1592
|
replyToId: string | null;
|
|
1508
|
-
|
|
1593
|
+
repliesWithheld?: number | undefined;
|
|
1594
|
+
}[], number, undefined>]>, undefined>;
|
|
1509
1595
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
1510
1596
|
/**
|
|
1511
1597
|
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
@@ -1542,9 +1628,10 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
|
|
|
1542
1628
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
1543
1629
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
1544
1630
|
/**
|
|
1545
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
1546
|
-
*
|
|
1547
|
-
*
|
|
1631
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
1632
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
1633
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
1634
|
+
* one of the published branch itself.
|
|
1548
1635
|
*/
|
|
1549
1636
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
1550
1637
|
}, undefined>, undefined>, undefined>;
|
|
@@ -1613,12 +1700,14 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
|
|
|
1613
1700
|
} | undefined;
|
|
1614
1701
|
approved?: boolean | undefined;
|
|
1615
1702
|
authorName: string | null;
|
|
1703
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
1616
1704
|
createdAt: string;
|
|
1617
1705
|
itemVersion: number;
|
|
1618
1706
|
itemChangedSince: boolean;
|
|
1619
1707
|
deliveredCount: number;
|
|
1620
1708
|
threadId: string;
|
|
1621
1709
|
replyToId: string | null;
|
|
1710
|
+
repliesWithheld?: number | undefined;
|
|
1622
1711
|
}[] | undefined;
|
|
1623
1712
|
updatedAt: string;
|
|
1624
1713
|
gitSource?: {
|
|
@@ -1666,12 +1755,14 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
|
|
|
1666
1755
|
} | undefined;
|
|
1667
1756
|
approved?: boolean | undefined;
|
|
1668
1757
|
authorName: string | null;
|
|
1758
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
1669
1759
|
createdAt: string;
|
|
1670
1760
|
itemVersion: number;
|
|
1671
1761
|
itemChangedSince: boolean;
|
|
1672
1762
|
deliveredCount: number;
|
|
1673
1763
|
threadId: string;
|
|
1674
1764
|
replyToId: string | null;
|
|
1765
|
+
repliesWithheld?: number | undefined;
|
|
1675
1766
|
}[] | undefined;
|
|
1676
1767
|
updatedAt: string;
|
|
1677
1768
|
gitSource?: {
|
|
@@ -1808,6 +1899,12 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
|
|
|
1808
1899
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
1809
1900
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
1810
1901
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
1902
|
+
/**
|
|
1903
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
1904
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
1905
|
+
* server never sends a reply to a client too old to read this.
|
|
1906
|
+
*/
|
|
1907
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
1811
1908
|
/** ISO timestamp, machine format. */
|
|
1812
1909
|
readonly createdAt: v.StringSchema<undefined>;
|
|
1813
1910
|
/** The item's content version the comment was written against. */
|
|
@@ -1831,20 +1928,28 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
|
|
|
1831
1928
|
*/
|
|
1832
1929
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
1833
1930
|
/**
|
|
1834
|
-
* This comment's thread root
|
|
1835
|
-
*
|
|
1836
|
-
*
|
|
1837
|
-
*
|
|
1838
|
-
*
|
|
1839
|
-
*
|
|
1931
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
1932
|
+
*
|
|
1933
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
1934
|
+
* first. Only a client that reports a version able to render threads is
|
|
1935
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
1936
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
1937
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
1938
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
1939
|
+
* question that reply answers, not a request of its own.
|
|
1840
1940
|
*/
|
|
1841
1941
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
1842
1942
|
/**
|
|
1843
|
-
*
|
|
1844
|
-
*
|
|
1845
|
-
* "a flat list of comments" rather than failing to parse.
|
|
1943
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
1944
|
+
* a reply's parent is always its root.
|
|
1846
1945
|
*/
|
|
1847
1946
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
1947
|
+
/**
|
|
1948
|
+
* On a root whose thread held more replies than
|
|
1949
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
1950
|
+
* Absent when the whole thread was sent.
|
|
1951
|
+
*/
|
|
1952
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
1848
1953
|
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
1849
1954
|
id: string;
|
|
1850
1955
|
state?: "open" | "resolved" | undefined;
|
|
@@ -1865,13 +1970,15 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
|
|
|
1865
1970
|
} | undefined;
|
|
1866
1971
|
approved?: boolean | undefined;
|
|
1867
1972
|
authorName: string | null;
|
|
1973
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
1868
1974
|
createdAt: string;
|
|
1869
1975
|
itemVersion: number;
|
|
1870
1976
|
itemChangedSince: boolean;
|
|
1871
1977
|
deliveredCount: number;
|
|
1872
1978
|
threadId: string;
|
|
1873
1979
|
replyToId: string | null;
|
|
1874
|
-
|
|
1980
|
+
repliesWithheld?: number | undefined;
|
|
1981
|
+
}[], number, undefined>]>, undefined>;
|
|
1875
1982
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
1876
1983
|
/**
|
|
1877
1984
|
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
@@ -1908,9 +2015,10 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
|
|
|
1908
2015
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
1909
2016
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
1910
2017
|
/**
|
|
1911
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
1912
|
-
*
|
|
1913
|
-
*
|
|
2018
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
2019
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
2020
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
2021
|
+
* one of the published branch itself.
|
|
1914
2022
|
*/
|
|
1915
2023
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
1916
2024
|
}, undefined>, undefined>, undefined>;
|
|
@@ -1979,12 +2087,14 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
|
|
|
1979
2087
|
} | undefined;
|
|
1980
2088
|
approved?: boolean | undefined;
|
|
1981
2089
|
authorName: string | null;
|
|
2090
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
1982
2091
|
createdAt: string;
|
|
1983
2092
|
itemVersion: number;
|
|
1984
2093
|
itemChangedSince: boolean;
|
|
1985
2094
|
deliveredCount: number;
|
|
1986
2095
|
threadId: string;
|
|
1987
2096
|
replyToId: string | null;
|
|
2097
|
+
repliesWithheld?: number | undefined;
|
|
1988
2098
|
}[] | undefined;
|
|
1989
2099
|
updatedAt: string;
|
|
1990
2100
|
gitSource?: {
|
|
@@ -2032,12 +2142,14 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
|
|
|
2032
2142
|
} | undefined;
|
|
2033
2143
|
approved?: boolean | undefined;
|
|
2034
2144
|
authorName: string | null;
|
|
2145
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
2035
2146
|
createdAt: string;
|
|
2036
2147
|
itemVersion: number;
|
|
2037
2148
|
itemChangedSince: boolean;
|
|
2038
2149
|
deliveredCount: number;
|
|
2039
2150
|
threadId: string;
|
|
2040
2151
|
replyToId: string | null;
|
|
2152
|
+
repliesWithheld?: number | undefined;
|
|
2041
2153
|
}[] | undefined;
|
|
2042
2154
|
updatedAt: string;
|
|
2043
2155
|
gitSource?: {
|
|
@@ -2190,6 +2302,12 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
|
2190
2302
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
2191
2303
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
2192
2304
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2305
|
+
/**
|
|
2306
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
2307
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
2308
|
+
* server never sends a reply to a client too old to read this.
|
|
2309
|
+
*/
|
|
2310
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
2193
2311
|
/** ISO timestamp, machine format. */
|
|
2194
2312
|
readonly createdAt: v.StringSchema<undefined>;
|
|
2195
2313
|
/** The item's content version the comment was written against. */
|
|
@@ -2213,20 +2331,28 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
|
2213
2331
|
*/
|
|
2214
2332
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
2215
2333
|
/**
|
|
2216
|
-
* This comment's thread root
|
|
2217
|
-
*
|
|
2218
|
-
*
|
|
2219
|
-
*
|
|
2220
|
-
*
|
|
2221
|
-
*
|
|
2334
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
2335
|
+
*
|
|
2336
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
2337
|
+
* first. Only a client that reports a version able to render threads is
|
|
2338
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
2339
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
2340
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
2341
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
2342
|
+
* question that reply answers, not a request of its own.
|
|
2222
2343
|
*/
|
|
2223
2344
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2224
2345
|
/**
|
|
2225
|
-
*
|
|
2226
|
-
*
|
|
2227
|
-
* "a flat list of comments" rather than failing to parse.
|
|
2346
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
2347
|
+
* a reply's parent is always its root.
|
|
2228
2348
|
*/
|
|
2229
2349
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2350
|
+
/**
|
|
2351
|
+
* On a root whose thread held more replies than
|
|
2352
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
2353
|
+
* Absent when the whole thread was sent.
|
|
2354
|
+
*/
|
|
2355
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
2230
2356
|
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
2231
2357
|
id: string;
|
|
2232
2358
|
state?: "open" | "resolved" | undefined;
|
|
@@ -2247,13 +2373,15 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
|
2247
2373
|
} | undefined;
|
|
2248
2374
|
approved?: boolean | undefined;
|
|
2249
2375
|
authorName: string | null;
|
|
2376
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
2250
2377
|
createdAt: string;
|
|
2251
2378
|
itemVersion: number;
|
|
2252
2379
|
itemChangedSince: boolean;
|
|
2253
2380
|
deliveredCount: number;
|
|
2254
2381
|
threadId: string;
|
|
2255
2382
|
replyToId: string | null;
|
|
2256
|
-
|
|
2383
|
+
repliesWithheld?: number | undefined;
|
|
2384
|
+
}[], number, undefined>]>, undefined>;
|
|
2257
2385
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
2258
2386
|
/**
|
|
2259
2387
|
* Present iff this artifact is owned by git. Absent means Mossbear owns it
|
|
@@ -2290,9 +2418,10 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
|
2290
2418
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
2291
2419
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
2292
2420
|
/**
|
|
2293
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
2294
|
-
*
|
|
2295
|
-
*
|
|
2421
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
2422
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
2423
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
2424
|
+
* one of the published branch itself.
|
|
2296
2425
|
*/
|
|
2297
2426
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
2298
2427
|
}, undefined>, undefined>, undefined>;
|
|
@@ -2361,12 +2490,14 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
|
2361
2490
|
} | undefined;
|
|
2362
2491
|
approved?: boolean | undefined;
|
|
2363
2492
|
authorName: string | null;
|
|
2493
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
2364
2494
|
createdAt: string;
|
|
2365
2495
|
itemVersion: number;
|
|
2366
2496
|
itemChangedSince: boolean;
|
|
2367
2497
|
deliveredCount: number;
|
|
2368
2498
|
threadId: string;
|
|
2369
2499
|
replyToId: string | null;
|
|
2500
|
+
repliesWithheld?: number | undefined;
|
|
2370
2501
|
}[] | undefined;
|
|
2371
2502
|
updatedAt: string;
|
|
2372
2503
|
gitSource?: {
|
|
@@ -2414,12 +2545,14 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
|
2414
2545
|
} | undefined;
|
|
2415
2546
|
approved?: boolean | undefined;
|
|
2416
2547
|
authorName: string | null;
|
|
2548
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
2417
2549
|
createdAt: string;
|
|
2418
2550
|
itemVersion: number;
|
|
2419
2551
|
itemChangedSince: boolean;
|
|
2420
2552
|
deliveredCount: number;
|
|
2421
2553
|
threadId: string;
|
|
2422
2554
|
replyToId: string | null;
|
|
2555
|
+
repliesWithheld?: number | undefined;
|
|
2423
2556
|
}[] | undefined;
|
|
2424
2557
|
updatedAt: string;
|
|
2425
2558
|
gitSource?: {
|
|
@@ -2445,6 +2578,41 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
|
|
|
2445
2578
|
* losing the tail silently.
|
|
2446
2579
|
*/
|
|
2447
2580
|
export declare const MAX_COMMENT_BUNDLE_IDS = 100;
|
|
2581
|
+
/**
|
|
2582
|
+
* `POST /api/v1/context/comments/resolve`: close one open comment and leave the
|
|
2583
|
+
* agent's note as a reply in its thread.
|
|
2584
|
+
*
|
|
2585
|
+
* **Two ways to find the comment, never both at once.** Without `artifactId`,
|
|
2586
|
+
* the id is looked up among the comments the named bundles deliver, which is
|
|
2587
|
+
* what `list_comments` listed. With it, the id is looked up among that one
|
|
2588
|
+
* artifact's open comments, which is what its feedback read listed, after the
|
|
2589
|
+
* same read check that read makes. A request with `artifactId` does not fall
|
|
2590
|
+
* back to the bundles when the id is not on that artifact.
|
|
2591
|
+
*/
|
|
2592
|
+
export declare const ResolveItemCommentRequestSchema: v.ObjectSchema<{
|
|
2593
|
+
/** The comment's id, or a unique prefix of it as a read printed it. */
|
|
2594
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
|
|
2595
|
+
/** One line, kept in the thread as the agent's reply. */
|
|
2596
|
+
readonly note: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 500, undefined>, v.RegexAction<string, undefined>]>;
|
|
2597
|
+
/** The bundles this repo receives. Ignored when `artifactId` is sent. */
|
|
2598
|
+
readonly bundleIds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>, readonly []>;
|
|
2599
|
+
/** The artifact the comment is on, as its feedback read was asked for it. */
|
|
2600
|
+
readonly artifactId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>, undefined>;
|
|
2601
|
+
/**
|
|
2602
|
+
* The reader's repo, as its committed `project.id`. A comment drafted from
|
|
2603
|
+
* one repo's corrections is listed only to a read that declares that repo,
|
|
2604
|
+
* so it is resolvable only by one that declares it too.
|
|
2605
|
+
*/
|
|
2606
|
+
readonly projectId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>, undefined>;
|
|
2607
|
+
/** The CLI's version, so a draft resolves only for a client that marks drafts. */
|
|
2608
|
+
readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
2609
|
+
}, undefined>;
|
|
2610
|
+
export type ResolveItemCommentRequest = v.InferInput<typeof ResolveItemCommentRequestSchema>;
|
|
2611
|
+
/** A resolve the server carried out. Every refusal is an error response instead. */
|
|
2612
|
+
export declare const ResolveItemCommentResponseSchema: v.ObjectSchema<{
|
|
2613
|
+
readonly resolved: v.LiteralSchema<true, undefined>;
|
|
2614
|
+
}, undefined>;
|
|
2615
|
+
export type ResolveItemCommentResponse = v.InferOutput<typeof ResolveItemCommentResponseSchema>;
|
|
2448
2616
|
/**
|
|
2449
2617
|
* How many times one subscriber is told, in one repo, that a given comment is
|
|
2450
2618
|
* waiting before the hook falls silent about it.
|
|
@@ -2491,6 +2659,12 @@ export declare const AnnounceItemCommentsRequestSchema: v.ObjectSchema<{
|
|
|
2491
2659
|
* filtered by the caller's own workspace membership.
|
|
2492
2660
|
*/
|
|
2493
2661
|
readonly bundleIds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
|
|
2662
|
+
/**
|
|
2663
|
+
* The release asking. A person's reply on a thread counts as waiting only
|
|
2664
|
+
* for a release that renders threads; without it the answer is the roots-only
|
|
2665
|
+
* count every older release was given.
|
|
2666
|
+
*/
|
|
2667
|
+
readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
2494
2668
|
}, undefined>;
|
|
2495
2669
|
export type AnnounceItemCommentsRequest = v.InferOutput<typeof AnnounceItemCommentsRequestSchema>;
|
|
2496
2670
|
/**
|
|
@@ -2645,6 +2819,12 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
|
|
|
2645
2819
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
2646
2820
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
2647
2821
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2822
|
+
/**
|
|
2823
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
2824
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
2825
|
+
* server never sends a reply to a client too old to read this.
|
|
2826
|
+
*/
|
|
2827
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
2648
2828
|
/** ISO timestamp, machine format. */
|
|
2649
2829
|
readonly createdAt: v.StringSchema<undefined>;
|
|
2650
2830
|
/** The item's content version the comment was written against. */
|
|
@@ -2668,20 +2848,28 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
|
|
|
2668
2848
|
*/
|
|
2669
2849
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
2670
2850
|
/**
|
|
2671
|
-
* This comment's thread root
|
|
2672
|
-
*
|
|
2673
|
-
*
|
|
2674
|
-
*
|
|
2675
|
-
*
|
|
2676
|
-
*
|
|
2851
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
2852
|
+
*
|
|
2853
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
2854
|
+
* first. Only a client that reports a version able to render threads is
|
|
2855
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
2856
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
2857
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
2858
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
2859
|
+
* question that reply answers, not a request of its own.
|
|
2677
2860
|
*/
|
|
2678
2861
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2679
2862
|
/**
|
|
2680
|
-
*
|
|
2681
|
-
*
|
|
2682
|
-
* "a flat list of comments" rather than failing to parse.
|
|
2863
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
2864
|
+
* a reply's parent is always its root.
|
|
2683
2865
|
*/
|
|
2684
2866
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2867
|
+
/**
|
|
2868
|
+
* On a root whose thread held more replies than
|
|
2869
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
2870
|
+
* Absent when the whole thread was sent.
|
|
2871
|
+
*/
|
|
2872
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
2685
2873
|
}, undefined>;
|
|
2686
2874
|
export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
|
|
2687
2875
|
/**
|
|
@@ -2740,6 +2928,12 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
|
|
|
2740
2928
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
2741
2929
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
2742
2930
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
2931
|
+
/**
|
|
2932
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
2933
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
2934
|
+
* server never sends a reply to a client too old to read this.
|
|
2935
|
+
*/
|
|
2936
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
2743
2937
|
/** ISO timestamp, machine format. */
|
|
2744
2938
|
readonly createdAt: v.StringSchema<undefined>;
|
|
2745
2939
|
/** The item's content version the comment was written against. */
|
|
@@ -2763,20 +2957,28 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
|
|
|
2763
2957
|
*/
|
|
2764
2958
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
2765
2959
|
/**
|
|
2766
|
-
* This comment's thread root
|
|
2767
|
-
*
|
|
2768
|
-
*
|
|
2769
|
-
*
|
|
2770
|
-
*
|
|
2771
|
-
*
|
|
2960
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
2961
|
+
*
|
|
2962
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
2963
|
+
* first. Only a client that reports a version able to render threads is
|
|
2964
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
2965
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
2966
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
2967
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
2968
|
+
* question that reply answers, not a request of its own.
|
|
2772
2969
|
*/
|
|
2773
2970
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
2774
2971
|
/**
|
|
2775
|
-
*
|
|
2776
|
-
*
|
|
2777
|
-
* "a flat list of comments" rather than failing to parse.
|
|
2972
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
2973
|
+
* a reply's parent is always its root.
|
|
2778
2974
|
*/
|
|
2779
2975
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
2976
|
+
/**
|
|
2977
|
+
* On a root whose thread held more replies than
|
|
2978
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
2979
|
+
* Absent when the whole thread was sent.
|
|
2980
|
+
*/
|
|
2981
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
2780
2982
|
}, undefined>, undefined>;
|
|
2781
2983
|
readonly cursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
2782
2984
|
/**
|
|
@@ -3292,9 +3494,10 @@ export declare const ArtifactSchema: v.ObjectSchema<{
|
|
|
3292
3494
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
3293
3495
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3294
3496
|
/**
|
|
3295
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3296
|
-
*
|
|
3297
|
-
*
|
|
3497
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
3498
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
3499
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
3500
|
+
* one of the published branch itself.
|
|
3298
3501
|
*/
|
|
3299
3502
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3300
3503
|
}, undefined>, undefined>, undefined>;
|
|
@@ -3338,6 +3541,12 @@ export declare const ArtifactSchema: v.ObjectSchema<{
|
|
|
3338
3541
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
3339
3542
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
3340
3543
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
3544
|
+
/**
|
|
3545
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
3546
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
3547
|
+
* server never sends a reply to a client too old to read this.
|
|
3548
|
+
*/
|
|
3549
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
3341
3550
|
/** ISO timestamp, machine format. */
|
|
3342
3551
|
readonly createdAt: v.StringSchema<undefined>;
|
|
3343
3552
|
/** The item's content version the comment was written against. */
|
|
@@ -3361,20 +3570,28 @@ export declare const ArtifactSchema: v.ObjectSchema<{
|
|
|
3361
3570
|
*/
|
|
3362
3571
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
3363
3572
|
/**
|
|
3364
|
-
* This comment's thread root
|
|
3365
|
-
*
|
|
3366
|
-
*
|
|
3367
|
-
*
|
|
3368
|
-
*
|
|
3369
|
-
*
|
|
3573
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
3574
|
+
*
|
|
3575
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
3576
|
+
* first. Only a client that reports a version able to render threads is
|
|
3577
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
3578
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
3579
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
3580
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
3581
|
+
* question that reply answers, not a request of its own.
|
|
3370
3582
|
*/
|
|
3371
3583
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3372
3584
|
/**
|
|
3373
|
-
*
|
|
3374
|
-
*
|
|
3375
|
-
* "a flat list of comments" rather than failing to parse.
|
|
3585
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
3586
|
+
* a reply's parent is always its root.
|
|
3376
3587
|
*/
|
|
3377
3588
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
3589
|
+
/**
|
|
3590
|
+
* On a root whose thread held more replies than
|
|
3591
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
3592
|
+
* Absent when the whole thread was sent.
|
|
3593
|
+
*/
|
|
3594
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
3378
3595
|
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
3379
3596
|
id: string;
|
|
3380
3597
|
state?: "open" | "resolved" | undefined;
|
|
@@ -3395,13 +3612,15 @@ export declare const ArtifactSchema: v.ObjectSchema<{
|
|
|
3395
3612
|
} | undefined;
|
|
3396
3613
|
approved?: boolean | undefined;
|
|
3397
3614
|
authorName: string | null;
|
|
3615
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
3398
3616
|
createdAt: string;
|
|
3399
3617
|
itemVersion: number;
|
|
3400
3618
|
itemChangedSince: boolean;
|
|
3401
3619
|
deliveredCount: number;
|
|
3402
3620
|
threadId: string;
|
|
3403
3621
|
replyToId: string | null;
|
|
3404
|
-
|
|
3622
|
+
repliesWithheld?: number | undefined;
|
|
3623
|
+
}[], number, undefined>]>, undefined>;
|
|
3405
3624
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
3406
3625
|
}, undefined>;
|
|
3407
3626
|
/**
|
|
@@ -3478,12 +3697,20 @@ export declare const CreateArtifactRequestSchema: v.StrictObjectSchema<{
|
|
|
3478
3697
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
3479
3698
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3480
3699
|
/**
|
|
3481
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3482
|
-
*
|
|
3483
|
-
*
|
|
3700
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
3701
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
3702
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
3703
|
+
* one of the published branch itself.
|
|
3484
3704
|
*/
|
|
3485
3705
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3486
3706
|
}, undefined>, undefined>;
|
|
3707
|
+
/**
|
|
3708
|
+
* The agent session that wrote this revision, as its harness names it (the id
|
|
3709
|
+
* `create_comment` resolves). Recorded in the saved version's `metadata`, and
|
|
3710
|
+
* absent when the writer could not tell. Provenance only: it grants nothing
|
|
3711
|
+
* and is not shown as authorship.
|
|
3712
|
+
*/
|
|
3713
|
+
readonly agentSessionId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 256, undefined>]>, undefined>;
|
|
3487
3714
|
}, undefined>;
|
|
3488
3715
|
/**
|
|
3489
3716
|
* Update an existing artifact's content. The id is in the route. The version the
|
|
@@ -3555,12 +3782,20 @@ export declare const UpdateArtifactRequestSchema: v.StrictObjectSchema<{
|
|
|
3555
3782
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
3556
3783
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3557
3784
|
/**
|
|
3558
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3559
|
-
*
|
|
3560
|
-
*
|
|
3785
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
3786
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
3787
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
3788
|
+
* one of the published branch itself.
|
|
3561
3789
|
*/
|
|
3562
3790
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3563
3791
|
}, undefined>, undefined>;
|
|
3792
|
+
/**
|
|
3793
|
+
* The agent session that wrote this revision, as its harness names it (the id
|
|
3794
|
+
* `create_comment` resolves). Recorded in the saved version's `metadata`, and
|
|
3795
|
+
* absent when the writer could not tell. Provenance only: it grants nothing
|
|
3796
|
+
* and is not shown as authorship.
|
|
3797
|
+
*/
|
|
3798
|
+
readonly agentSessionId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 256, undefined>]>, undefined>;
|
|
3564
3799
|
}, undefined>;
|
|
3565
3800
|
/**
|
|
3566
3801
|
* Tombstone an artifact: the commit that published it has since deleted the
|
|
@@ -3582,9 +3817,10 @@ export declare const RemoveArtifactRequestSchema: v.StrictObjectSchema<{
|
|
|
3582
3817
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
3583
3818
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3584
3819
|
/**
|
|
3585
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3586
|
-
*
|
|
3587
|
-
*
|
|
3820
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
3821
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
3822
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
3823
|
+
* one of the published branch itself.
|
|
3588
3824
|
*/
|
|
3589
3825
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3590
3826
|
}, undefined>;
|
|
@@ -3671,9 +3907,10 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
|
|
|
3671
3907
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
3672
3908
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3673
3909
|
/**
|
|
3674
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3675
|
-
*
|
|
3676
|
-
*
|
|
3910
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
3911
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
3912
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
3913
|
+
* one of the published branch itself.
|
|
3677
3914
|
*/
|
|
3678
3915
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3679
3916
|
}, undefined>, undefined>, undefined>;
|
|
@@ -3717,6 +3954,12 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
|
|
|
3717
3954
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
3718
3955
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
3719
3956
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
3957
|
+
/**
|
|
3958
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
3959
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
3960
|
+
* server never sends a reply to a client too old to read this.
|
|
3961
|
+
*/
|
|
3962
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
3720
3963
|
/** ISO timestamp, machine format. */
|
|
3721
3964
|
readonly createdAt: v.StringSchema<undefined>;
|
|
3722
3965
|
/** The item's content version the comment was written against. */
|
|
@@ -3740,20 +3983,28 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
|
|
|
3740
3983
|
*/
|
|
3741
3984
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
3742
3985
|
/**
|
|
3743
|
-
* This comment's thread root
|
|
3744
|
-
*
|
|
3745
|
-
*
|
|
3746
|
-
*
|
|
3747
|
-
*
|
|
3748
|
-
*
|
|
3986
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
3987
|
+
*
|
|
3988
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
3989
|
+
* first. Only a client that reports a version able to render threads is
|
|
3990
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
3991
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
3992
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
3993
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
3994
|
+
* question that reply answers, not a request of its own.
|
|
3749
3995
|
*/
|
|
3750
3996
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3751
3997
|
/**
|
|
3752
|
-
*
|
|
3753
|
-
*
|
|
3754
|
-
* "a flat list of comments" rather than failing to parse.
|
|
3998
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
3999
|
+
* a reply's parent is always its root.
|
|
3755
4000
|
*/
|
|
3756
4001
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
4002
|
+
/**
|
|
4003
|
+
* On a root whose thread held more replies than
|
|
4004
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
4005
|
+
* Absent when the whole thread was sent.
|
|
4006
|
+
*/
|
|
4007
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
3757
4008
|
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
3758
4009
|
id: string;
|
|
3759
4010
|
state?: "open" | "resolved" | undefined;
|
|
@@ -3774,13 +4025,15 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
|
|
|
3774
4025
|
} | undefined;
|
|
3775
4026
|
approved?: boolean | undefined;
|
|
3776
4027
|
authorName: string | null;
|
|
4028
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
3777
4029
|
createdAt: string;
|
|
3778
4030
|
itemVersion: number;
|
|
3779
4031
|
itemChangedSince: boolean;
|
|
3780
4032
|
deliveredCount: number;
|
|
3781
4033
|
threadId: string;
|
|
3782
4034
|
replyToId: string | null;
|
|
3783
|
-
|
|
4035
|
+
repliesWithheld?: number | undefined;
|
|
4036
|
+
}[], number, undefined>]>, undefined>;
|
|
3784
4037
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
3785
4038
|
}, undefined>;
|
|
3786
4039
|
readonly revision: v.ObjectSchema<{
|
|
@@ -3834,9 +4087,10 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
|
|
|
3834
4087
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
3835
4088
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3836
4089
|
/**
|
|
3837
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3838
|
-
*
|
|
3839
|
-
*
|
|
4090
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
4091
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
4092
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
4093
|
+
* one of the published branch itself.
|
|
3840
4094
|
*/
|
|
3841
4095
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3842
4096
|
}, undefined>, undefined>, undefined>;
|
|
@@ -3880,6 +4134,12 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
|
|
|
3880
4134
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
3881
4135
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
3882
4136
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4137
|
+
/**
|
|
4138
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
4139
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
4140
|
+
* server never sends a reply to a client too old to read this.
|
|
4141
|
+
*/
|
|
4142
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
3883
4143
|
/** ISO timestamp, machine format. */
|
|
3884
4144
|
readonly createdAt: v.StringSchema<undefined>;
|
|
3885
4145
|
/** The item's content version the comment was written against. */
|
|
@@ -3903,20 +4163,28 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
|
|
|
3903
4163
|
*/
|
|
3904
4164
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
3905
4165
|
/**
|
|
3906
|
-
* This comment's thread root
|
|
3907
|
-
*
|
|
3908
|
-
*
|
|
3909
|
-
*
|
|
3910
|
-
*
|
|
3911
|
-
*
|
|
4166
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
4167
|
+
*
|
|
4168
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
4169
|
+
* first. Only a client that reports a version able to render threads is
|
|
4170
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
4171
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
4172
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
4173
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
4174
|
+
* question that reply answers, not a request of its own.
|
|
3912
4175
|
*/
|
|
3913
4176
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
3914
4177
|
/**
|
|
3915
|
-
*
|
|
3916
|
-
*
|
|
3917
|
-
* "a flat list of comments" rather than failing to parse.
|
|
4178
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
4179
|
+
* a reply's parent is always its root.
|
|
3918
4180
|
*/
|
|
3919
4181
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
4182
|
+
/**
|
|
4183
|
+
* On a root whose thread held more replies than
|
|
4184
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
4185
|
+
* Absent when the whole thread was sent.
|
|
4186
|
+
*/
|
|
4187
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
3920
4188
|
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
3921
4189
|
id: string;
|
|
3922
4190
|
state?: "open" | "resolved" | undefined;
|
|
@@ -3937,13 +4205,15 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
|
|
|
3937
4205
|
} | undefined;
|
|
3938
4206
|
approved?: boolean | undefined;
|
|
3939
4207
|
authorName: string | null;
|
|
4208
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
3940
4209
|
createdAt: string;
|
|
3941
4210
|
itemVersion: number;
|
|
3942
4211
|
itemChangedSince: boolean;
|
|
3943
4212
|
deliveredCount: number;
|
|
3944
4213
|
threadId: string;
|
|
3945
4214
|
replyToId: string | null;
|
|
3946
|
-
|
|
4215
|
+
repliesWithheld?: number | undefined;
|
|
4216
|
+
}[], number, undefined>]>, undefined>;
|
|
3947
4217
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
3948
4218
|
}, undefined>;
|
|
3949
4219
|
}, undefined>;
|
|
@@ -3984,9 +4254,10 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
|
|
|
3984
4254
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
3985
4255
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
3986
4256
|
/**
|
|
3987
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
3988
|
-
*
|
|
3989
|
-
*
|
|
4257
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
4258
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
4259
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
4260
|
+
* one of the published branch itself.
|
|
3990
4261
|
*/
|
|
3991
4262
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
3992
4263
|
}, undefined>, undefined>, undefined>;
|
|
@@ -4030,6 +4301,12 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
|
|
|
4030
4301
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
4031
4302
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
4032
4303
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4304
|
+
/**
|
|
4305
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
4306
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
4307
|
+
* server never sends a reply to a client too old to read this.
|
|
4308
|
+
*/
|
|
4309
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
4033
4310
|
/** ISO timestamp, machine format. */
|
|
4034
4311
|
readonly createdAt: v.StringSchema<undefined>;
|
|
4035
4312
|
/** The item's content version the comment was written against. */
|
|
@@ -4053,20 +4330,28 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
|
|
|
4053
4330
|
*/
|
|
4054
4331
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
4055
4332
|
/**
|
|
4056
|
-
* This comment's thread root
|
|
4057
|
-
*
|
|
4058
|
-
*
|
|
4059
|
-
*
|
|
4060
|
-
*
|
|
4061
|
-
*
|
|
4333
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
4334
|
+
*
|
|
4335
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
4336
|
+
* first. Only a client that reports a version able to render threads is
|
|
4337
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
4338
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
4339
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
4340
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
4341
|
+
* question that reply answers, not a request of its own.
|
|
4062
4342
|
*/
|
|
4063
4343
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
4064
4344
|
/**
|
|
4065
|
-
*
|
|
4066
|
-
*
|
|
4067
|
-
* "a flat list of comments" rather than failing to parse.
|
|
4345
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
4346
|
+
* a reply's parent is always its root.
|
|
4068
4347
|
*/
|
|
4069
4348
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
4349
|
+
/**
|
|
4350
|
+
* On a root whose thread held more replies than
|
|
4351
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
4352
|
+
* Absent when the whole thread was sent.
|
|
4353
|
+
*/
|
|
4354
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
4070
4355
|
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
4071
4356
|
id: string;
|
|
4072
4357
|
state?: "open" | "resolved" | undefined;
|
|
@@ -4087,13 +4372,15 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
|
|
|
4087
4372
|
} | undefined;
|
|
4088
4373
|
approved?: boolean | undefined;
|
|
4089
4374
|
authorName: string | null;
|
|
4375
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
4090
4376
|
createdAt: string;
|
|
4091
4377
|
itemVersion: number;
|
|
4092
4378
|
itemChangedSince: boolean;
|
|
4093
4379
|
deliveredCount: number;
|
|
4094
4380
|
threadId: string;
|
|
4095
4381
|
replyToId: string | null;
|
|
4096
|
-
|
|
4382
|
+
repliesWithheld?: number | undefined;
|
|
4383
|
+
}[], number, undefined>]>, undefined>;
|
|
4097
4384
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
4098
4385
|
}, undefined>;
|
|
4099
4386
|
}, undefined>;
|
|
@@ -4135,9 +4422,10 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
|
|
|
4135
4422
|
readonly projectId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>;
|
|
4136
4423
|
readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
|
|
4137
4424
|
/**
|
|
4138
|
-
* The branch the publishing commit was on. **The one optional member**:
|
|
4139
|
-
*
|
|
4140
|
-
*
|
|
4425
|
+
* The branch the publishing commit was on. **The one optional member**: a
|
|
4426
|
+
* detached HEAD has none to record. Publishers read it back to tell a copy
|
|
4427
|
+
* from another branch, whose commit a squash merge may have discarded, from
|
|
4428
|
+
* one of the published branch itself.
|
|
4141
4429
|
*/
|
|
4142
4430
|
readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
|
|
4143
4431
|
}, undefined>, undefined>, undefined>;
|
|
@@ -4181,6 +4469,12 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
|
|
|
4181
4469
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
4182
4470
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
4183
4471
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4472
|
+
/**
|
|
4473
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
4474
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
4475
|
+
* server never sends a reply to a client too old to read this.
|
|
4476
|
+
*/
|
|
4477
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
4184
4478
|
/** ISO timestamp, machine format. */
|
|
4185
4479
|
readonly createdAt: v.StringSchema<undefined>;
|
|
4186
4480
|
/** The item's content version the comment was written against. */
|
|
@@ -4204,20 +4498,28 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
|
|
|
4204
4498
|
*/
|
|
4205
4499
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
4206
4500
|
/**
|
|
4207
|
-
* This comment's thread root
|
|
4208
|
-
*
|
|
4209
|
-
*
|
|
4210
|
-
*
|
|
4211
|
-
*
|
|
4212
|
-
*
|
|
4501
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
4502
|
+
*
|
|
4503
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
4504
|
+
* first. Only a client that reports a version able to render threads is
|
|
4505
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
4506
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
4507
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
4508
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
4509
|
+
* question that reply answers, not a request of its own.
|
|
4213
4510
|
*/
|
|
4214
4511
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
4215
4512
|
/**
|
|
4216
|
-
*
|
|
4217
|
-
*
|
|
4218
|
-
* "a flat list of comments" rather than failing to parse.
|
|
4513
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
4514
|
+
* a reply's parent is always its root.
|
|
4219
4515
|
*/
|
|
4220
4516
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
4517
|
+
/**
|
|
4518
|
+
* On a root whose thread held more replies than
|
|
4519
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
4520
|
+
* Absent when the whole thread was sent.
|
|
4521
|
+
*/
|
|
4522
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
4221
4523
|
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
4222
4524
|
id: string;
|
|
4223
4525
|
state?: "open" | "resolved" | undefined;
|
|
@@ -4238,13 +4540,15 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
|
|
|
4238
4540
|
} | undefined;
|
|
4239
4541
|
approved?: boolean | undefined;
|
|
4240
4542
|
authorName: string | null;
|
|
4543
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
4241
4544
|
createdAt: string;
|
|
4242
4545
|
itemVersion: number;
|
|
4243
4546
|
itemChangedSince: boolean;
|
|
4244
4547
|
deliveredCount: number;
|
|
4245
4548
|
threadId: string;
|
|
4246
4549
|
replyToId: string | null;
|
|
4247
|
-
|
|
4550
|
+
repliesWithheld?: number | undefined;
|
|
4551
|
+
}[], number, undefined>]>, undefined>;
|
|
4248
4552
|
readonly updatedAt: v.StringSchema<undefined>;
|
|
4249
4553
|
}, undefined>;
|
|
4250
4554
|
}, undefined>;
|
|
@@ -4395,6 +4699,63 @@ export declare const ArtifactVersionConflictSchema: v.ObjectSchema<{
|
|
|
4395
4699
|
readonly expectedVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4396
4700
|
readonly requestId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
4397
4701
|
}, undefined>;
|
|
4702
|
+
/**
|
|
4703
|
+
* Save a draft of an artifact from a git branch. One draft per artifact,
|
|
4704
|
+
* author and branch, so a second upload from the same branch replaces the
|
|
4705
|
+
* first. `baseVersion` is the artifact version the branch's bytes were
|
|
4706
|
+
* compared with; publishing the draft later sends it as `expectedVersion`.
|
|
4707
|
+
* Content equal to the artifact's current content stores nothing and removes
|
|
4708
|
+
* any draft from that branch, because it has landed.
|
|
4709
|
+
*/
|
|
4710
|
+
export declare const UpsertArtifactDraftRequestSchema: v.StrictObjectSchema<{
|
|
4711
|
+
readonly branch: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>;
|
|
4712
|
+
readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "content must be at most 524288 bytes">]>;
|
|
4713
|
+
readonly baseVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4714
|
+
readonly gitCommit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>, undefined>;
|
|
4715
|
+
}, undefined>;
|
|
4716
|
+
/**
|
|
4717
|
+
* One of the caller's drafts. `branch` is null for a draft written in the
|
|
4718
|
+
* dashboard or by an agent rather than uploaded from git.
|
|
4719
|
+
*/
|
|
4720
|
+
export declare const ArtifactDraftSchema: v.ObjectSchema<{
|
|
4721
|
+
readonly id: v.StringSchema<undefined>;
|
|
4722
|
+
readonly artifactId: v.StringSchema<undefined>;
|
|
4723
|
+
readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4724
|
+
readonly gitCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4725
|
+
readonly content: v.StringSchema<undefined>;
|
|
4726
|
+
readonly contentHash: v.StringSchema<undefined>;
|
|
4727
|
+
readonly baseVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4728
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
4729
|
+
readonly updatedAt: v.StringSchema<undefined>;
|
|
4730
|
+
}, undefined>;
|
|
4731
|
+
/** `draft` is null when the content had already landed and nothing was kept. */
|
|
4732
|
+
export declare const UpsertArtifactDraftResponseSchema: v.ObjectSchema<{
|
|
4733
|
+
readonly draft: v.NullableSchema<v.ObjectSchema<{
|
|
4734
|
+
readonly id: v.StringSchema<undefined>;
|
|
4735
|
+
readonly artifactId: v.StringSchema<undefined>;
|
|
4736
|
+
readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4737
|
+
readonly gitCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4738
|
+
readonly content: v.StringSchema<undefined>;
|
|
4739
|
+
readonly contentHash: v.StringSchema<undefined>;
|
|
4740
|
+
readonly baseVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4741
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
4742
|
+
readonly updatedAt: v.StringSchema<undefined>;
|
|
4743
|
+
}, undefined>, undefined>;
|
|
4744
|
+
}, undefined>;
|
|
4745
|
+
/** The caller's own drafts of one artifact, most recently updated first. */
|
|
4746
|
+
export declare const ListArtifactDraftsResponseSchema: v.ObjectSchema<{
|
|
4747
|
+
readonly drafts: v.ArraySchema<v.ObjectSchema<{
|
|
4748
|
+
readonly id: v.StringSchema<undefined>;
|
|
4749
|
+
readonly artifactId: v.StringSchema<undefined>;
|
|
4750
|
+
readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4751
|
+
readonly gitCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
4752
|
+
readonly content: v.StringSchema<undefined>;
|
|
4753
|
+
readonly contentHash: v.StringSchema<undefined>;
|
|
4754
|
+
readonly baseVersion: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
4755
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
4756
|
+
readonly updatedAt: v.StringSchema<undefined>;
|
|
4757
|
+
}, undefined>, undefined>;
|
|
4758
|
+
}, undefined>;
|
|
4398
4759
|
export declare const ProposalCitationSchema: v.ObjectSchema<{
|
|
4399
4760
|
readonly agentSessionId: v.StringSchema<undefined>;
|
|
4400
4761
|
readonly timestamp: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -4545,22 +4906,56 @@ export type ActionNarration = v.InferOutput<typeof ActionNarrationSchema>;
|
|
|
4545
4906
|
export declare const TokenUsageSchema: v.ObjectSchema<{
|
|
4546
4907
|
readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
4547
4908
|
readonly provider: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
4909
|
+
readonly occurredAt: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 8640000000000000, undefined>]>, undefined>;
|
|
4548
4910
|
readonly inputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
4549
4911
|
readonly outputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
4550
4912
|
readonly cacheReadTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
|
|
4551
4913
|
readonly cacheWriteTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
|
|
4552
4914
|
}, undefined>;
|
|
4915
|
+
/** Identity of a model's usage at an instant, or its undated legacy total. */
|
|
4916
|
+
export declare function usageRowKey(row: {
|
|
4917
|
+
model: string;
|
|
4918
|
+
occurredAt?: number | undefined;
|
|
4919
|
+
}): string;
|
|
4920
|
+
/** Preserve legacy model ordering so saved numerical proofs remain verifiable. */
|
|
4921
|
+
export declare function compareUsageRows(a: {
|
|
4922
|
+
model: string;
|
|
4923
|
+
occurredAt?: number | undefined;
|
|
4924
|
+
}, b: {
|
|
4925
|
+
model: string;
|
|
4926
|
+
occurredAt?: number | undefined;
|
|
4927
|
+
}): number;
|
|
4928
|
+
export declare const MAX_HOSTED_USAGE_ROWS = 50000;
|
|
4929
|
+
export declare const MAX_HOSTED_USAGE_BYTES: number;
|
|
4930
|
+
export declare const MAX_SYNC_REQUEST_BYTES: number;
|
|
4553
4931
|
export declare const DashboardSessionUsageSchema: v.ObjectSchema<{
|
|
4554
4932
|
readonly sessionId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
4555
4933
|
readonly agentSessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
4556
|
-
readonly usage: v.ArraySchema<v.ObjectSchema<{
|
|
4934
|
+
readonly usage: v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
4557
4935
|
readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
4558
4936
|
readonly provider: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
4937
|
+
readonly occurredAt: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 8640000000000000, undefined>]>, undefined>;
|
|
4559
4938
|
readonly inputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
4560
4939
|
readonly outputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
4561
4940
|
readonly cacheReadTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
|
|
4562
4941
|
readonly cacheWriteTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
|
|
4563
|
-
}, undefined>, undefined
|
|
4942
|
+
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
4943
|
+
model: string;
|
|
4944
|
+
provider?: string | undefined;
|
|
4945
|
+
occurredAt?: number | undefined;
|
|
4946
|
+
inputTokens: number;
|
|
4947
|
+
outputTokens: number;
|
|
4948
|
+
cacheReadTokens?: number | undefined;
|
|
4949
|
+
cacheWriteTokens?: number | undefined;
|
|
4950
|
+
}[], 50000, undefined>, v.CheckAction<{
|
|
4951
|
+
model: string;
|
|
4952
|
+
provider?: string | undefined;
|
|
4953
|
+
occurredAt?: number | undefined;
|
|
4954
|
+
inputTokens: number;
|
|
4955
|
+
outputTokens: number;
|
|
4956
|
+
cacheReadTokens?: number | undefined;
|
|
4957
|
+
cacheWriteTokens?: number | undefined;
|
|
4958
|
+
}[], "Usage snapshot exceeds the single-session upload capacity">]>;
|
|
4564
4959
|
}, undefined>;
|
|
4565
4960
|
export declare const SkillUsageEntrySchema: v.ObjectSchema<{
|
|
4566
4961
|
readonly skillName: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
@@ -4963,20 +5358,38 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
|
|
|
4963
5358
|
readonly runUsage: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
4964
5359
|
readonly sessionId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
4965
5360
|
readonly agentSessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
4966
|
-
readonly usage: v.ArraySchema<v.ObjectSchema<{
|
|
5361
|
+
readonly usage: v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
4967
5362
|
readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
4968
5363
|
readonly provider: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
5364
|
+
readonly occurredAt: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 8640000000000000, undefined>]>, undefined>;
|
|
4969
5365
|
readonly inputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
4970
5366
|
readonly outputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
|
|
4971
5367
|
readonly cacheReadTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
|
|
4972
5368
|
readonly cacheWriteTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
|
|
4973
|
-
}, undefined>, undefined
|
|
5369
|
+
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
5370
|
+
model: string;
|
|
5371
|
+
provider?: string | undefined;
|
|
5372
|
+
occurredAt?: number | undefined;
|
|
5373
|
+
inputTokens: number;
|
|
5374
|
+
outputTokens: number;
|
|
5375
|
+
cacheReadTokens?: number | undefined;
|
|
5376
|
+
cacheWriteTokens?: number | undefined;
|
|
5377
|
+
}[], 50000, undefined>, v.CheckAction<{
|
|
5378
|
+
model: string;
|
|
5379
|
+
provider?: string | undefined;
|
|
5380
|
+
occurredAt?: number | undefined;
|
|
5381
|
+
inputTokens: number;
|
|
5382
|
+
outputTokens: number;
|
|
5383
|
+
cacheReadTokens?: number | undefined;
|
|
5384
|
+
cacheWriteTokens?: number | undefined;
|
|
5385
|
+
}[], "Usage snapshot exceeds the single-session upload capacity">]>;
|
|
4974
5386
|
}, undefined>, undefined>, v.MaxLengthAction<{
|
|
4975
5387
|
sessionId?: string | undefined;
|
|
4976
5388
|
agentSessionId: string;
|
|
4977
5389
|
usage: {
|
|
4978
5390
|
model: string;
|
|
4979
5391
|
provider?: string | undefined;
|
|
5392
|
+
occurredAt?: number | undefined;
|
|
4980
5393
|
inputTokens: number;
|
|
4981
5394
|
outputTokens: number;
|
|
4982
5395
|
cacheReadTokens?: number | undefined;
|
|
@@ -5876,6 +6289,11 @@ export declare const ArtifactFeedbackQuerySchema: v.ObjectSchema<{
|
|
|
5876
6289
|
* correction drafted for one repo is withheld, as on the comments read.
|
|
5877
6290
|
*/
|
|
5878
6291
|
readonly project: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
6292
|
+
/**
|
|
6293
|
+
* The release asking. Replies on a thread are sent only to one that renders
|
|
6294
|
+
* threads; without it the page is roots only, as it was.
|
|
6295
|
+
*/
|
|
6296
|
+
readonly cli: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
5879
6297
|
}, undefined>;
|
|
5880
6298
|
export type ArtifactFeedbackQuery = v.InferOutput<typeof ArtifactFeedbackQuerySchema>;
|
|
5881
6299
|
/**
|
|
@@ -5944,6 +6362,12 @@ export declare const ArtifactFeedbackResponseSchema: v.ObjectSchema<{
|
|
|
5944
6362
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
5945
6363
|
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
5946
6364
|
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6365
|
+
/**
|
|
6366
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
6367
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
6368
|
+
* server never sends a reply to a client too old to read this.
|
|
6369
|
+
*/
|
|
6370
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
5947
6371
|
/** ISO timestamp, machine format. */
|
|
5948
6372
|
readonly createdAt: v.StringSchema<undefined>;
|
|
5949
6373
|
/** The item's content version the comment was written against. */
|
|
@@ -5967,20 +6391,28 @@ export declare const ArtifactFeedbackResponseSchema: v.ObjectSchema<{
|
|
|
5967
6391
|
*/
|
|
5968
6392
|
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
5969
6393
|
/**
|
|
5970
|
-
* This comment's thread root
|
|
5971
|
-
*
|
|
5972
|
-
*
|
|
5973
|
-
*
|
|
5974
|
-
*
|
|
5975
|
-
*
|
|
6394
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
6395
|
+
*
|
|
6396
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
6397
|
+
* first. Only a client that reports a version able to render threads is
|
|
6398
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
6399
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
6400
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
6401
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
6402
|
+
* question that reply answers, not a request of its own.
|
|
5976
6403
|
*/
|
|
5977
6404
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
5978
6405
|
/**
|
|
5979
|
-
*
|
|
5980
|
-
*
|
|
5981
|
-
* "a flat list of comments" rather than failing to parse.
|
|
6406
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
6407
|
+
* a reply's parent is always its root.
|
|
5982
6408
|
*/
|
|
5983
6409
|
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
6410
|
+
/**
|
|
6411
|
+
* On a root whose thread held more replies than
|
|
6412
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
6413
|
+
* Absent when the whole thread was sent.
|
|
6414
|
+
*/
|
|
6415
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
5984
6416
|
}, undefined>, undefined>;
|
|
5985
6417
|
/** Absent on the last page; pass it back as `cursor` for the next. */
|
|
5986
6418
|
readonly nextCursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -6178,6 +6610,333 @@ export declare const ArtifactFeedbackResponseSchema: v.ObjectSchema<{
|
|
|
6178
6610
|
}, undefined>, undefined>;
|
|
6179
6611
|
}, undefined>;
|
|
6180
6612
|
export type ArtifactFeedbackResponse = v.InferOutput<typeof ArtifactFeedbackResponseSchema>;
|
|
6613
|
+
/** Most artifacts one batch feedback read may name. */
|
|
6614
|
+
export declare const MAX_ARTIFACT_FEEDBACK_BATCH = 25;
|
|
6615
|
+
/**
|
|
6616
|
+
* `POST /api/v1/artifacts/feedback` body: several artifacts read at once, each
|
|
6617
|
+
* paged as `GET .../:id/feedback` pages it (`cursor` is that artifact's own
|
|
6618
|
+
* `nextCursor`). `project` and `cli` mean what they mean on the single read.
|
|
6619
|
+
*/
|
|
6620
|
+
export declare const ArtifactFeedbackBatchRequestSchema: v.ObjectSchema<{
|
|
6621
|
+
readonly artifacts: v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
|
|
6622
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>;
|
|
6623
|
+
readonly cursor: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "cursor is not a feedback cursor">]>, undefined>;
|
|
6624
|
+
}, undefined>, undefined>, v.MinLengthAction<{
|
|
6625
|
+
id: string;
|
|
6626
|
+
cursor?: string | undefined;
|
|
6627
|
+
}[], 1, undefined>, v.MaxLengthAction<{
|
|
6628
|
+
id: string;
|
|
6629
|
+
cursor?: string | undefined;
|
|
6630
|
+
}[], 25, undefined>]>;
|
|
6631
|
+
readonly project: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
6632
|
+
readonly cli: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
|
|
6633
|
+
}, undefined>;
|
|
6634
|
+
export type ArtifactFeedbackBatchRequest = v.InferOutput<typeof ArtifactFeedbackBatchRequestSchema>;
|
|
6635
|
+
/**
|
|
6636
|
+
* One entry per requested id, in request order. `feedback` is null for an id
|
|
6637
|
+
* the caller cannot read, missing or out of scope alike, and carries nothing
|
|
6638
|
+
* else about it; the other entries are unaffected. A read that failed is
|
|
6639
|
+
* `unavailable: true` instead, and nothing of it was counted as delivered.
|
|
6640
|
+
*/
|
|
6641
|
+
export declare const ArtifactFeedbackBatchResponseSchema: v.ObjectSchema<{
|
|
6642
|
+
readonly artifacts: v.ArraySchema<v.ObjectSchema<{
|
|
6643
|
+
readonly id: v.StringSchema<undefined>;
|
|
6644
|
+
readonly feedback: v.NullableSchema<v.ObjectSchema<{
|
|
6645
|
+
readonly artifactId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6646
|
+
/** The artifact's current version, as `read` reports it. */
|
|
6647
|
+
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
|
|
6648
|
+
/** Open comments, oldest first by `(createdAt, id)`. */
|
|
6649
|
+
readonly comments: v.ArraySchema<v.ObjectSchema<{
|
|
6650
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6651
|
+
readonly state: v.OptionalSchema<v.PicklistSchema<["open", "resolved"], undefined>, undefined>;
|
|
6652
|
+
/** Current source location of an anchored passage, or its lost quote. */
|
|
6653
|
+
readonly passage: v.OptionalSchema<v.ObjectSchema<{
|
|
6654
|
+
readonly quote: v.StringSchema<undefined>;
|
|
6655
|
+
readonly status: v.PicklistSchema<["located", "changed", "orphaned"], undefined>;
|
|
6656
|
+
readonly lines: v.NullableSchema<v.ObjectSchema<{
|
|
6657
|
+
readonly start: v.NumberSchema<undefined>;
|
|
6658
|
+
readonly end: v.NumberSchema<undefined>;
|
|
6659
|
+
}, undefined>, undefined>;
|
|
6660
|
+
}, undefined>, undefined>;
|
|
6661
|
+
/** The comment's text, already wrapped in the response's untrusted markers. */
|
|
6662
|
+
readonly body: v.StringSchema<undefined>;
|
|
6663
|
+
/**
|
|
6664
|
+
* What a comment Mossbear wrote is: a finding about the item, never an edit.
|
|
6665
|
+
* Present only on a Mossbear comment. The comment's `body` begins with the
|
|
6666
|
+
* claim (what goes wrong); this carries what the claim rests on.
|
|
6667
|
+
*/
|
|
6668
|
+
readonly finding: v.OptionalSchema<v.ObjectSchema<{
|
|
6669
|
+
readonly tier: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
|
|
6670
|
+
/** How the finding is known, in one line: "Seen in 3 sessions (2026-09-15 – 2026-10-03)". */
|
|
6671
|
+
readonly tierLine: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
6672
|
+
/** What the drafter did not read, fixed per tier. */
|
|
6673
|
+
readonly blindSpot: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>;
|
|
6674
|
+
/** What should change in later sessions if the finding is fixed, wrapped in the untrusted markers. */
|
|
6675
|
+
readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6676
|
+
}, undefined>, undefined>;
|
|
6677
|
+
/**
|
|
6678
|
+
* Whether the person approved a comment Mossbear drafted. Present on every
|
|
6679
|
+
* Mossbear comment and absent on a person's or an agent's, which are
|
|
6680
|
+
* requests as written. `false` is a draft nobody has read yet: a reader shows
|
|
6681
|
+
* it to the user and acts only on their go-ahead. Only a client that reports
|
|
6682
|
+
* a version able to mark drafts is ever listed one, so an older reader that
|
|
6683
|
+
* strips this field never receives a draft it would print as a request.
|
|
6684
|
+
*/
|
|
6685
|
+
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
6686
|
+
/** The author's display name as the workspace shows it, or null. Never an email. */
|
|
6687
|
+
readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6688
|
+
/**
|
|
6689
|
+
* Who wrote it. Optional because a server that predates the field omits it;
|
|
6690
|
+
* a reader that meets a reply without it cannot tell whose it is, and a
|
|
6691
|
+
* server never sends a reply to a client too old to read this.
|
|
6692
|
+
*/
|
|
6693
|
+
readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
|
|
6694
|
+
/** ISO timestamp, machine format. */
|
|
6695
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
6696
|
+
/** The item's content version the comment was written against. */
|
|
6697
|
+
readonly itemVersion: v.NumberSchema<undefined>;
|
|
6698
|
+
/** True when the item's current version is greater than `itemVersion`. */
|
|
6699
|
+
readonly itemChangedSince: v.BooleanSchema<undefined>;
|
|
6700
|
+
/**
|
|
6701
|
+
* How many agent reads were handed this comment **before** this one — so a
|
|
6702
|
+
* comment reaching an agent for the first time reports `0`.
|
|
6703
|
+
*
|
|
6704
|
+
* It is the stored count as it read at the moment the response was built;
|
|
6705
|
+
* the serve this response *is* has not been counted yet. Excluded rather
|
|
6706
|
+
* than included because the count is recorded best-effort: a response that
|
|
6707
|
+
* claimed to include itself would be wrong whenever that record failed, and
|
|
6708
|
+
* a number that is sometimes off by one is worse than one that is
|
|
6709
|
+
* consistently the prior total.
|
|
6710
|
+
*
|
|
6711
|
+
* So `deliveredCount > 0` means an earlier read was handed this comment, and
|
|
6712
|
+
* `0` means this read is the first. Neither says a model took it in — only
|
|
6713
|
+
* that the server handed it over.
|
|
6714
|
+
*/
|
|
6715
|
+
readonly deliveredCount: v.NumberSchema<undefined>;
|
|
6716
|
+
/**
|
|
6717
|
+
* This comment's thread root: its own id on a root, the root's id on a reply.
|
|
6718
|
+
*
|
|
6719
|
+
* **Replies ride the same flat array**, each straight after its root, oldest
|
|
6720
|
+
* first. Only a client that reports a version able to render threads is
|
|
6721
|
+
* sent them; any other reader gets roots alone, as it always did. A person's
|
|
6722
|
+
* reply is part of the thread's request. An agent's reply is context: an
|
|
6723
|
+
* earlier message on the thread, never something to act on. A root an agent
|
|
6724
|
+
* wrote is delivered only once a person has replied to it, and is then the
|
|
6725
|
+
* question that reply answers, not a request of its own.
|
|
6726
|
+
*/
|
|
6727
|
+
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6728
|
+
/**
|
|
6729
|
+
* `null` on a root; the root's id on a reply. Threads are one level deep, so
|
|
6730
|
+
* a reply's parent is always its root.
|
|
6731
|
+
*/
|
|
6732
|
+
readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
|
|
6733
|
+
/**
|
|
6734
|
+
* On a root whose thread held more replies than
|
|
6735
|
+
* `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
|
|
6736
|
+
* Absent when the whole thread was sent.
|
|
6737
|
+
*/
|
|
6738
|
+
readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
|
|
6739
|
+
}, undefined>, undefined>;
|
|
6740
|
+
/** Absent on the last page; pass it back as `cursor` for the next. */
|
|
6741
|
+
readonly nextCursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
6742
|
+
/** The markers every comment `body` is wrapped in; present when any comment came back. */
|
|
6743
|
+
readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
6744
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6745
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6746
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6747
|
+
readonly note: v.StringSchema<undefined>;
|
|
6748
|
+
}, undefined>, undefined>, undefined>;
|
|
6749
|
+
readonly grading: v.NullableSchema<v.ObjectSchema<{
|
|
6750
|
+
readonly guide: v.ObjectSchema<{
|
|
6751
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6752
|
+
readonly title: v.StringSchema<undefined>;
|
|
6753
|
+
readonly path: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>;
|
|
6754
|
+
readonly root: v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>;
|
|
6755
|
+
}, undefined>;
|
|
6756
|
+
/** The wording the window is about, or null when the guide has no revision identity. */
|
|
6757
|
+
readonly currentRevision: v.NullableSchema<v.ObjectSchema<{
|
|
6758
|
+
readonly bodyItemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6759
|
+
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6760
|
+
}, undefined>, undefined>;
|
|
6761
|
+
readonly state: v.PicklistSchema<["evaluated", "awaiting_current_revision", "unevaluated"], undefined>;
|
|
6762
|
+
readonly window: v.ObjectSchema<{
|
|
6763
|
+
/** Rows summarized, after the revision narrow. */
|
|
6764
|
+
readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6765
|
+
readonly aligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6766
|
+
readonly misaligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6767
|
+
/** In context, never engaged. Neither a pass nor a failure. */
|
|
6768
|
+
readonly notApplicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6769
|
+
/** `aligned + misaligned` — the rate's own denominator. */
|
|
6770
|
+
readonly applicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6771
|
+
/** `aligned / applicable`, or **null when no run engaged the guide**. */
|
|
6772
|
+
readonly alignmentRate: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
|
|
6773
|
+
/** The rows hit the per-guide cap: a bounded window, never a lifetime total. */
|
|
6774
|
+
readonly isWindowed: v.BooleanSchema<undefined>;
|
|
6775
|
+
/** The cap the rows were fetched under, so a reader can say what "windowed" means. */
|
|
6776
|
+
readonly windowSize: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6777
|
+
/**
|
|
6778
|
+
* Verdicts fetched and then dropped by the revision narrow — about wording
|
|
6779
|
+
* that is no longer current, or citing no revision at all. A **floor** rather
|
|
6780
|
+
* than a total whenever `isWindowed`, because rows past the cap were never
|
|
6781
|
+
* fetched.
|
|
6782
|
+
*/
|
|
6783
|
+
readonly olderRevisionRows: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6784
|
+
/**
|
|
6785
|
+
* `applicable` is too small for the percentage to mean anything — threshold
|
|
6786
|
+
* `applicable < 3` (founder, 2026-08-22). Read the counts, not the rate.
|
|
6787
|
+
*/
|
|
6788
|
+
readonly isLowConfidence: v.BooleanSchema<undefined>;
|
|
6789
|
+
}, undefined>;
|
|
6790
|
+
/**
|
|
6791
|
+
* The last edit's two windows, or **null when there is no earlier wording to
|
|
6792
|
+
* compare against**.
|
|
6793
|
+
*
|
|
6794
|
+
* Present-and-null rather than omitted: a guide on its first revision has no
|
|
6795
|
+
* delta, and that is an answer. An absent key would leave a reader unable to
|
|
6796
|
+
* tell "no edit to measure" from "this server does not report deltas".
|
|
6797
|
+
*/
|
|
6798
|
+
readonly change: v.NullableSchema<v.ObjectSchema<{
|
|
6799
|
+
/** The revision that preceded the change. */
|
|
6800
|
+
readonly before: v.ObjectSchema<{
|
|
6801
|
+
/** The wording this side judges. */
|
|
6802
|
+
readonly revision: v.ObjectSchema<{
|
|
6803
|
+
readonly bodyItemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6804
|
+
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6805
|
+
}, undefined>;
|
|
6806
|
+
/** Rows in this side's window, including the runs that never engaged it. */
|
|
6807
|
+
readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6808
|
+
readonly aligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6809
|
+
readonly misaligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6810
|
+
readonly notApplicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6811
|
+
/** `aligned + misaligned` — this side's own denominator. */
|
|
6812
|
+
readonly applicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6813
|
+
/** `aligned / applicable`, or null when no run engaged this wording. */
|
|
6814
|
+
readonly alignmentRate: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
|
|
6815
|
+
/** This side is below the sample floor, so read its counts and not its rate. */
|
|
6816
|
+
readonly isLowConfidence: v.BooleanSchema<undefined>;
|
|
6817
|
+
/**
|
|
6818
|
+
* This side is a bounded sample of its revision rather than the whole record.
|
|
6819
|
+
* A saturated side beside an unsaturated one is two different kinds of
|
|
6820
|
+
* number, and comparing them without saying so is the defect the flag exists
|
|
6821
|
+
* to stop.
|
|
6822
|
+
*/
|
|
6823
|
+
readonly isSaturated: v.BooleanSchema<undefined>;
|
|
6824
|
+
/** The span this side covers, ISO. Both null on a side with no rows. */
|
|
6825
|
+
readonly newestAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6826
|
+
readonly oldestAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6827
|
+
}, undefined>;
|
|
6828
|
+
/** The wording the guide stands at now. */
|
|
6829
|
+
readonly since: v.ObjectSchema<{
|
|
6830
|
+
/** The wording this side judges. */
|
|
6831
|
+
readonly revision: v.ObjectSchema<{
|
|
6832
|
+
readonly bodyItemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6833
|
+
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6834
|
+
}, undefined>;
|
|
6835
|
+
/** Rows in this side's window, including the runs that never engaged it. */
|
|
6836
|
+
readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6837
|
+
readonly aligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6838
|
+
readonly misaligned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6839
|
+
readonly notApplicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6840
|
+
/** `aligned + misaligned` — this side's own denominator. */
|
|
6841
|
+
readonly applicable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6842
|
+
/** `aligned / applicable`, or null when no run engaged this wording. */
|
|
6843
|
+
readonly alignmentRate: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
|
|
6844
|
+
/** This side is below the sample floor, so read its counts and not its rate. */
|
|
6845
|
+
readonly isLowConfidence: v.BooleanSchema<undefined>;
|
|
6846
|
+
/**
|
|
6847
|
+
* This side is a bounded sample of its revision rather than the whole record.
|
|
6848
|
+
* A saturated side beside an unsaturated one is two different kinds of
|
|
6849
|
+
* number, and comparing them without saying so is the defect the flag exists
|
|
6850
|
+
* to stop.
|
|
6851
|
+
*/
|
|
6852
|
+
readonly isSaturated: v.BooleanSchema<undefined>;
|
|
6853
|
+
/** The span this side covers, ISO. Both null on a side with no rows. */
|
|
6854
|
+
readonly newestAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6855
|
+
readonly oldestAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6856
|
+
}, undefined>;
|
|
6857
|
+
/**
|
|
6858
|
+
* `since` minus `before`, in `[-1, 1]`, or **null whenever the pair is
|
|
6859
|
+
* suppressed** or either side never engaged the guide. Null is not zero: one
|
|
6860
|
+
* says the evidence does not support a number, the other would be a claim.
|
|
6861
|
+
*/
|
|
6862
|
+
readonly alignmentRateDelta: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
|
|
6863
|
+
/**
|
|
6864
|
+
* Which side is below the sample floor, or null when neither is and the delta
|
|
6865
|
+
* stands. `'since'` is the ordinary post-edit state — *not enough runs since
|
|
6866
|
+
* this change* — and is reported rather than omitted.
|
|
6867
|
+
*/
|
|
6868
|
+
readonly suppressedBy: v.NullableSchema<v.PicklistSchema<["since", "before", "both"], undefined>, undefined>;
|
|
6869
|
+
/** The delta's sign, or null while it is withheld. `unchanged` is exactly zero. */
|
|
6870
|
+
readonly direction: v.NullableSchema<v.PicklistSchema<["improved", "regressed", "unchanged"], undefined>, undefined>;
|
|
6871
|
+
/** Either side is a bounded sample, so neither is a lifetime total. */
|
|
6872
|
+
readonly isWindowed: v.BooleanSchema<undefined>;
|
|
6873
|
+
/** The per-revision cap each side was bounded by, so "sample" has a size. */
|
|
6874
|
+
readonly windowSize: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6875
|
+
/**
|
|
6876
|
+
* When the current wording was recorded, ISO — the boundary between the two
|
|
6877
|
+
* windows, and null when no version row carries it.
|
|
6878
|
+
*
|
|
6879
|
+
* A date, never an attribution: it says when the window opened, not that the
|
|
6880
|
+
* edit caused what happened inside it.
|
|
6881
|
+
*/
|
|
6882
|
+
readonly changedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
6883
|
+
}, undefined>, undefined>;
|
|
6884
|
+
readonly findings: v.ArraySchema<v.ObjectSchema<{
|
|
6885
|
+
readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6886
|
+
readonly occurredAt: v.StringSchema<undefined>;
|
|
6887
|
+
readonly revision: v.NullableSchema<v.ObjectSchema<{
|
|
6888
|
+
readonly bodyItemId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6889
|
+
readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6890
|
+
}, undefined>, undefined>;
|
|
6891
|
+
readonly isCurrentRevision: v.BooleanSchema<undefined>;
|
|
6892
|
+
readonly reasoning: v.StringSchema<undefined>;
|
|
6893
|
+
}, undefined>, undefined>;
|
|
6894
|
+
/**
|
|
6895
|
+
* Misaligned rows in the window beyond the `MAX_GUIDE_HISTORY_FINDINGS`
|
|
6896
|
+
* returned. Reported rather than silently truncated: a caller reading five
|
|
6897
|
+
* findings has no other way to know it is reading five of forty.
|
|
6898
|
+
*/
|
|
6899
|
+
readonly findingsOmitted: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6900
|
+
/**
|
|
6901
|
+
* The caller's newest stored failure-pattern analysis of this guide, or
|
|
6902
|
+
* **null when they have never asked for one**. Optional because a server
|
|
6903
|
+
* that predates it sends no key; a reader must not take absence for "never
|
|
6904
|
+
* analysed".
|
|
6905
|
+
*/
|
|
6906
|
+
readonly analysis: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
|
|
6907
|
+
readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6908
|
+
/** When it was written, ISO. */
|
|
6909
|
+
readonly createdAt: v.StringSchema<undefined>;
|
|
6910
|
+
readonly outcome: v.PicklistSchema<["pattern", "no_pattern"], undefined>;
|
|
6911
|
+
readonly summary: v.StringSchema<undefined>;
|
|
6912
|
+
/** Failed sessions the analysis read. */
|
|
6913
|
+
readonly sessionsAnalysed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6914
|
+
/** Failed sessions it left out to stay within its prompt's cap. */
|
|
6915
|
+
readonly sessionsOmitted: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
|
|
6916
|
+
readonly stale: v.BooleanSchema<undefined>;
|
|
6917
|
+
/** Why it is out of date, or null while it is current. */
|
|
6918
|
+
readonly staleReason: v.NullableSchema<v.PicklistSchema<["revision_changed", "new_failures"], undefined>, undefined>;
|
|
6919
|
+
/** Failures it has not read, when `staleReason` is `new_failures`; else null. */
|
|
6920
|
+
readonly newFailures: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
|
|
6921
|
+
}, undefined>, undefined>, undefined>;
|
|
6922
|
+
readonly untrusted: v.ObjectSchema<{
|
|
6923
|
+
readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6924
|
+
readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6925
|
+
readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6926
|
+
readonly note: v.StringSchema<undefined>;
|
|
6927
|
+
}, undefined>;
|
|
6928
|
+
}, undefined>, undefined>;
|
|
6929
|
+
/** Present exactly when `grading` is null. */
|
|
6930
|
+
readonly gradingUnavailable: v.OptionalSchema<v.ObjectSchema<{
|
|
6931
|
+
readonly code: v.PicklistSchema<["not-graded", "not-available-to-credential"], undefined>;
|
|
6932
|
+
readonly reason: v.StringSchema<undefined>;
|
|
6933
|
+
}, undefined>, undefined>;
|
|
6934
|
+
}, undefined>, undefined>;
|
|
6935
|
+
/** Set on a null `feedback` that is a failed read, not an unreadable id: ask again. */
|
|
6936
|
+
readonly unavailable: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
|
|
6937
|
+
}, undefined>, undefined>;
|
|
6938
|
+
}, undefined>;
|
|
6939
|
+
export type ArtifactFeedbackBatchResponse = v.InferOutput<typeof ArtifactFeedbackBatchResponseSchema>;
|
|
6181
6940
|
export declare const SessionGradeRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
|
|
6182
6941
|
readonly session: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 256, undefined>, v.CheckAction<string, "identifier must not contain control characters">]>, undefined>;
|
|
6183
6942
|
readonly agent_session: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 256, undefined>, v.CheckAction<string, "identifier must not contain control characters">]>, undefined>;
|
|
@@ -6202,7 +6961,8 @@ export type SessionGradeRequest = v.InferOutput<typeof SessionGradeRequestSchema
|
|
|
6202
6961
|
*
|
|
6203
6962
|
* - `pending` — no grade yet, and the grading sweep can still pick the run
|
|
6204
6963
|
* up (it is open, or closed inside the grading window). "Not graded yet"
|
|
6205
|
-
* is honest here and only here
|
|
6964
|
+
* is honest here and only here — unless `gradeFailedAttempts` is above
|
|
6965
|
+
* zero, when grading has been tried and has not finished.
|
|
6206
6966
|
* - `graded` — a grader judged it; `grade` carries what it said.
|
|
6207
6967
|
* - `nothing_to_grade` — a grader ran and found nothing to judge: no
|
|
6208
6968
|
* gradeable actions, or no guides in the agent's context. The record
|
|
@@ -6281,6 +7041,7 @@ export declare const SessionGradeResponseSchema: v.ObjectSchema<{
|
|
|
6281
7041
|
readonly status: v.PicklistSchema<["open", "closed"], undefined>;
|
|
6282
7042
|
}, undefined>;
|
|
6283
7043
|
readonly state: v.PicklistSchema<["pending", "graded", "nothing_to_grade", "expired", "grading_off"], undefined>;
|
|
7044
|
+
readonly gradeFailedAttempts: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
|
|
6284
7045
|
/** Present exactly when `state` is `graded`. */
|
|
6285
7046
|
readonly grade: v.NullableSchema<v.ObjectSchema<{
|
|
6286
7047
|
/** The grader's one-paragraph judgment of the run, wrapped like `reasoning`; null when the record carries none. */
|
|
@@ -6373,6 +7134,7 @@ export declare const SessionDigestResponseSchema: v.ObjectSchema<{
|
|
|
6373
7134
|
readonly status: v.PicklistSchema<["open", "closed"], undefined>;
|
|
6374
7135
|
}, undefined>;
|
|
6375
7136
|
readonly state: v.PicklistSchema<["pending", "graded", "nothing_to_grade", "expired", "grading_off"], undefined>;
|
|
7137
|
+
readonly gradeFailedAttempts: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
|
|
6376
7138
|
readonly grade: v.NullableSchema<v.ObjectSchema<{
|
|
6377
7139
|
/** The grader's one-paragraph judgment of the run, wrapped like `reasoning`; null when the record carries none. */
|
|
6378
7140
|
readonly summary: v.NullableSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -6506,8 +7268,8 @@ export declare const SearchFrontmatterSchema: v.SchemaWithPipe<readonly [v.Recor
|
|
|
6506
7268
|
}, "frontmatter takes between 1 and 3 fields">]>;
|
|
6507
7269
|
export type SearchFrontmatter = v.InferOutput<typeof SearchFrontmatterSchema>;
|
|
6508
7270
|
/** Who wrote a comment: a person, an agent, or Mossbear itself. */
|
|
6509
|
-
export declare const SEARCH_COMMENT_AUTHOR_KINDS:
|
|
6510
|
-
export declare const SearchCommentAuthorKindSchema: v.PicklistSchema<
|
|
7271
|
+
export declare const SEARCH_COMMENT_AUTHOR_KINDS: ["person", "agent", "mossbear"];
|
|
7272
|
+
export declare const SearchCommentAuthorKindSchema: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
|
|
6511
7273
|
export type SearchCommentAuthorKind = v.InferOutput<typeof SearchCommentAuthorKindSchema>;
|
|
6512
7274
|
/**
|
|
6513
7275
|
* What a comment is attached to. `artifact` is a guide or a document; `session`
|
|
@@ -6571,7 +7333,7 @@ export declare const SearchRequestObjectSchema: v.ObjectSchema<{
|
|
|
6571
7333
|
* Restrict the `comments` corpus to comments written by these kinds of
|
|
6572
7334
|
* author. Does not touch other corpora.
|
|
6573
7335
|
*/
|
|
6574
|
-
readonly authorKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<
|
|
7336
|
+
readonly authorKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>, v.MinLengthAction<("person" | "agent" | "mossbear")[], 1, undefined>]>, undefined>;
|
|
6575
7337
|
/**
|
|
6576
7338
|
* Restrict the `comments` corpus to comments on these kinds of subject. Does
|
|
6577
7339
|
* not touch other corpora.
|
|
@@ -6641,7 +7403,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
6641
7403
|
* Restrict the `comments` corpus to comments written by these kinds of
|
|
6642
7404
|
* author. Does not touch other corpora.
|
|
6643
7405
|
*/
|
|
6644
|
-
readonly authorKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<
|
|
7406
|
+
readonly authorKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>, v.MinLengthAction<("person" | "agent" | "mossbear")[], 1, undefined>]>, undefined>;
|
|
6645
7407
|
/**
|
|
6646
7408
|
* Restrict the `comments` corpus to comments on these kinds of subject. Does
|
|
6647
7409
|
* not touch other corpora.
|
|
@@ -6680,7 +7442,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
6680
7442
|
frontmatter?: {
|
|
6681
7443
|
[x: string]: string;
|
|
6682
7444
|
} | undefined;
|
|
6683
|
-
authorKinds?: ("
|
|
7445
|
+
authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
|
|
6684
7446
|
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
6685
7447
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
6686
7448
|
headSha?: string | undefined;
|
|
@@ -6697,7 +7459,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
6697
7459
|
frontmatter?: {
|
|
6698
7460
|
[x: string]: string;
|
|
6699
7461
|
} | undefined;
|
|
6700
|
-
authorKinds?: ("
|
|
7462
|
+
authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
|
|
6701
7463
|
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
6702
7464
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
6703
7465
|
headSha?: string | undefined;
|
|
@@ -6714,7 +7476,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
6714
7476
|
frontmatter?: {
|
|
6715
7477
|
[x: string]: string;
|
|
6716
7478
|
} | undefined;
|
|
6717
|
-
authorKinds?: ("
|
|
7479
|
+
authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
|
|
6718
7480
|
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
6719
7481
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
6720
7482
|
headSha?: string | undefined;
|
|
@@ -6731,7 +7493,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
6731
7493
|
frontmatter?: {
|
|
6732
7494
|
[x: string]: string;
|
|
6733
7495
|
} | undefined;
|
|
6734
|
-
authorKinds?: ("
|
|
7496
|
+
authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
|
|
6735
7497
|
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
6736
7498
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
6737
7499
|
headSha?: string | undefined;
|
|
@@ -6748,7 +7510,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
6748
7510
|
frontmatter?: {
|
|
6749
7511
|
[x: string]: string;
|
|
6750
7512
|
} | undefined;
|
|
6751
|
-
authorKinds?: ("
|
|
7513
|
+
authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
|
|
6752
7514
|
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
6753
7515
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
6754
7516
|
headSha?: string | undefined;
|
|
@@ -6765,7 +7527,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
|
|
|
6765
7527
|
frontmatter?: {
|
|
6766
7528
|
[x: string]: string;
|
|
6767
7529
|
} | undefined;
|
|
6768
|
-
authorKinds?: ("
|
|
7530
|
+
authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
|
|
6769
7531
|
subjectKinds?: ("artifact" | "session")[] | undefined;
|
|
6770
7532
|
steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
|
|
6771
7533
|
headSha?: string | undefined;
|
|
@@ -6890,7 +7652,7 @@ export declare const SearchArtifactCommentHitSchema: v.ObjectSchema<{
|
|
|
6890
7652
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
6891
7653
|
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6892
7654
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6893
|
-
readonly authorKind: v.PicklistSchema<
|
|
7655
|
+
readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
|
|
6894
7656
|
readonly resolved: v.BooleanSchema<undefined>;
|
|
6895
7657
|
readonly createdAt: v.StringSchema<undefined>;
|
|
6896
7658
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -6907,7 +7669,7 @@ export declare const SearchSessionCommentHitSchema: v.ObjectSchema<{
|
|
|
6907
7669
|
readonly matchedIn: v.LiteralSchema<"body", undefined>;
|
|
6908
7670
|
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6909
7671
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6910
|
-
readonly authorKind: v.PicklistSchema<
|
|
7672
|
+
readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
|
|
6911
7673
|
readonly resolved: v.BooleanSchema<undefined>;
|
|
6912
7674
|
readonly createdAt: v.StringSchema<undefined>;
|
|
6913
7675
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -6943,7 +7705,7 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
|
|
|
6943
7705
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
6944
7706
|
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6945
7707
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6946
|
-
readonly authorKind: v.PicklistSchema<
|
|
7708
|
+
readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
|
|
6947
7709
|
readonly resolved: v.BooleanSchema<undefined>;
|
|
6948
7710
|
readonly createdAt: v.StringSchema<undefined>;
|
|
6949
7711
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -6954,7 +7716,7 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
|
|
|
6954
7716
|
readonly matchedIn: v.LiteralSchema<"body", undefined>;
|
|
6955
7717
|
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6956
7718
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
6957
|
-
readonly authorKind: v.PicklistSchema<
|
|
7719
|
+
readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
|
|
6958
7720
|
readonly resolved: v.BooleanSchema<undefined>;
|
|
6959
7721
|
readonly createdAt: v.StringSchema<undefined>;
|
|
6960
7722
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -7161,7 +7923,7 @@ export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.Ob
|
|
|
7161
7923
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
7162
7924
|
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7163
7925
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7164
|
-
readonly authorKind: v.PicklistSchema<
|
|
7926
|
+
readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
|
|
7165
7927
|
readonly resolved: v.BooleanSchema<undefined>;
|
|
7166
7928
|
readonly createdAt: v.StringSchema<undefined>;
|
|
7167
7929
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -7172,7 +7934,7 @@ export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.Ob
|
|
|
7172
7934
|
readonly matchedIn: v.LiteralSchema<"body", undefined>;
|
|
7173
7935
|
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7174
7936
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7175
|
-
readonly authorKind: v.PicklistSchema<
|
|
7937
|
+
readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
|
|
7176
7938
|
readonly resolved: v.BooleanSchema<undefined>;
|
|
7177
7939
|
readonly createdAt: v.StringSchema<undefined>;
|
|
7178
7940
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -7405,7 +8167,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
|
|
|
7405
8167
|
readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
|
|
7406
8168
|
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7407
8169
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7408
|
-
readonly authorKind: v.PicklistSchema<
|
|
8170
|
+
readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
|
|
7409
8171
|
readonly resolved: v.BooleanSchema<undefined>;
|
|
7410
8172
|
readonly createdAt: v.StringSchema<undefined>;
|
|
7411
8173
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -7416,7 +8178,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
|
|
|
7416
8178
|
readonly matchedIn: v.LiteralSchema<"body", undefined>;
|
|
7417
8179
|
readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7418
8180
|
readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
|
|
7419
|
-
readonly authorKind: v.PicklistSchema<
|
|
8181
|
+
readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
|
|
7420
8182
|
readonly resolved: v.BooleanSchema<undefined>;
|
|
7421
8183
|
readonly createdAt: v.StringSchema<undefined>;
|
|
7422
8184
|
readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
|
|
@@ -7595,10 +8357,18 @@ export declare function parseCreateBundleResponse(data: unknown): {
|
|
|
7595
8357
|
};
|
|
7596
8358
|
export declare function parseAttachBundleMemberRequest(data: unknown): {
|
|
7597
8359
|
artifactId: string;
|
|
8360
|
+
} | {
|
|
8361
|
+
artifactIds: string[];
|
|
7598
8362
|
};
|
|
7599
8363
|
export declare function parseAttachBundleMemberResponse(data: unknown): {
|
|
7600
8364
|
attached: boolean;
|
|
7601
8365
|
};
|
|
8366
|
+
export declare function parseAttachBundleMembersResponse(data: unknown): {
|
|
8367
|
+
results: {
|
|
8368
|
+
artifactId: string;
|
|
8369
|
+
status: "added" | "already_there" | "unavailable" | "path_taken";
|
|
8370
|
+
}[];
|
|
8371
|
+
};
|
|
7602
8372
|
export declare function parseDetachBundleMemberResponse(data: unknown): {
|
|
7603
8373
|
detached: boolean;
|
|
7604
8374
|
};
|
|
@@ -7691,12 +8461,14 @@ export declare function parseContextItemsResponse(data: unknown): {
|
|
|
7691
8461
|
} | undefined;
|
|
7692
8462
|
approved?: boolean | undefined;
|
|
7693
8463
|
authorName: string | null;
|
|
8464
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
7694
8465
|
createdAt: string;
|
|
7695
8466
|
itemVersion: number;
|
|
7696
8467
|
itemChangedSince: boolean;
|
|
7697
8468
|
deliveredCount: number;
|
|
7698
8469
|
threadId: string;
|
|
7699
8470
|
replyToId: string | null;
|
|
8471
|
+
repliesWithheld?: number | undefined;
|
|
7700
8472
|
}[] | undefined;
|
|
7701
8473
|
updatedAt: string;
|
|
7702
8474
|
gitSource?: {
|
|
@@ -7753,12 +8525,14 @@ export declare function parseBundleArtifactsResponse(data: unknown): {
|
|
|
7753
8525
|
} | undefined;
|
|
7754
8526
|
approved?: boolean | undefined;
|
|
7755
8527
|
authorName: string | null;
|
|
8528
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
7756
8529
|
createdAt: string;
|
|
7757
8530
|
itemVersion: number;
|
|
7758
8531
|
itemChangedSince: boolean;
|
|
7759
8532
|
deliveredCount: number;
|
|
7760
8533
|
threadId: string;
|
|
7761
8534
|
replyToId: string | null;
|
|
8535
|
+
repliesWithheld?: number | undefined;
|
|
7762
8536
|
}[] | undefined;
|
|
7763
8537
|
updatedAt: string;
|
|
7764
8538
|
gitSource?: {
|
|
@@ -7869,6 +8643,7 @@ export declare function parseDashboardSyncRequest(data: unknown): {
|
|
|
7869
8643
|
usage: {
|
|
7870
8644
|
model: string;
|
|
7871
8645
|
provider?: string | undefined;
|
|
8646
|
+
occurredAt?: number | undefined;
|
|
7872
8647
|
inputTokens: number;
|
|
7873
8648
|
outputTokens: number;
|
|
7874
8649
|
cacheReadTokens?: number | undefined;
|
|
@@ -8055,6 +8830,10 @@ export declare function parseGuideHistoryResponse(data: unknown): {
|
|
|
8055
8830
|
export declare function parseAnnounceItemCommentsRequest(data: unknown): {
|
|
8056
8831
|
projectId: string;
|
|
8057
8832
|
bundleIds: string[];
|
|
8833
|
+
cliVersion?: string | undefined;
|
|
8834
|
+
};
|
|
8835
|
+
export declare function parseResolveItemCommentResponse(data: unknown): {
|
|
8836
|
+
resolved: true;
|
|
8058
8837
|
};
|
|
8059
8838
|
export declare function parseAnnounceItemCommentsResponse(data: unknown): {
|
|
8060
8839
|
open: number;
|
|
@@ -8096,12 +8875,14 @@ export declare function parseItemCommentsResponse(data: unknown): {
|
|
|
8096
8875
|
} | undefined;
|
|
8097
8876
|
approved?: boolean | undefined;
|
|
8098
8877
|
authorName: string | null;
|
|
8878
|
+
authorKind?: "person" | "agent" | "mossbear" | undefined;
|
|
8099
8879
|
createdAt: string;
|
|
8100
8880
|
itemVersion: number;
|
|
8101
8881
|
itemChangedSince: boolean;
|
|
8102
8882
|
deliveredCount: number;
|
|
8103
8883
|
threadId: string;
|
|
8104
8884
|
replyToId: string | null;
|
|
8885
|
+
repliesWithheld?: number | undefined;
|
|
8105
8886
|
}[];
|
|
8106
8887
|
cursor?: string | undefined;
|
|
8107
8888
|
untrusted?: {
|
|
@@ -8180,6 +8961,7 @@ export declare function parseSessionGradeResponse(data: unknown): {
|
|
|
8180
8961
|
status: "open" | "closed";
|
|
8181
8962
|
};
|
|
8182
8963
|
state: "pending" | "graded" | "nothing_to_grade" | "expired" | "grading_off";
|
|
8964
|
+
gradeFailedAttempts?: number | undefined;
|
|
8183
8965
|
grade: {
|
|
8184
8966
|
summary: string | null;
|
|
8185
8967
|
gradedAt: string;
|
|
@@ -8208,6 +8990,7 @@ export declare function parseSessionDigestResponse(data: unknown): {
|
|
|
8208
8990
|
status: "open" | "closed";
|
|
8209
8991
|
};
|
|
8210
8992
|
state: "pending" | "graded" | "nothing_to_grade" | "expired" | "grading_off";
|
|
8993
|
+
gradeFailedAttempts?: number | undefined;
|
|
8211
8994
|
grade: {
|
|
8212
8995
|
summary: string | null;
|
|
8213
8996
|
gradedAt: string;
|
|
@@ -8313,7 +9096,7 @@ export declare function parseSearchResponse(data: unknown): {
|
|
|
8313
9096
|
approved?: boolean | undefined;
|
|
8314
9097
|
commentId: string;
|
|
8315
9098
|
threadId: string;
|
|
8316
|
-
authorKind: "
|
|
9099
|
+
authorKind: "person" | "agent" | "mossbear";
|
|
8317
9100
|
resolved: boolean;
|
|
8318
9101
|
createdAt: string;
|
|
8319
9102
|
url?: string | undefined;
|
|
@@ -8324,7 +9107,7 @@ export declare function parseSearchResponse(data: unknown): {
|
|
|
8324
9107
|
matchedIn: "body";
|
|
8325
9108
|
commentId: string;
|
|
8326
9109
|
threadId: string;
|
|
8327
|
-
authorKind: "
|
|
9110
|
+
authorKind: "person" | "agent" | "mossbear";
|
|
8328
9111
|
resolved: boolean;
|
|
8329
9112
|
createdAt: string;
|
|
8330
9113
|
url?: string | undefined;
|