@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/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
- }, "A member needs an artifactId.">, v.TransformAction<{
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 — its own id for every delivered root. Resolution
1174
- * replies remain on the dashboard thread and are not delivered to agents.
1175
- * It is on the wire from the first response
1176
- * because the wire contract is consumed by installed CLI versions: reshaping
1177
- * a flat `comments` array into threads-of-comments later would be a breaking
1178
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
1183
- * future response that carries real replies degrades to
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 — its own id for every delivered root. Resolution
1253
- * replies remain on the dashboard thread and are not delivered to agents.
1254
- * It is on the wire from the first response
1255
- * because the wire contract is consumed by installed CLI versions: reshaping
1256
- * a flat `comments` array into threads-of-comments later would be a breaking
1257
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
1262
- * future response that carries real replies degrades to
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
- * publication is not restricted by branch, so this is recorded so a subscriber
1310
- * can see what they got, and a detached HEAD has none to record.
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 — its own id for every delivered root. Resolution
1469
- * replies remain on the dashboard thread and are not delivered to agents.
1470
- * It is on the wire from the first response
1471
- * because the wire contract is consumed by installed CLI versions: reshaping
1472
- * a flat `comments` array into threads-of-comments later would be a breaking
1473
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
1478
- * future response that carries real replies degrades to
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
- }[], 20, undefined>]>, undefined>;
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
- * publication is not restricted by branch, so this is recorded so a subscriber
1547
- * can see what they got, and a detached HEAD has none to record.
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 — its own id for every delivered root. Resolution
1835
- * replies remain on the dashboard thread and are not delivered to agents.
1836
- * It is on the wire from the first response
1837
- * because the wire contract is consumed by installed CLI versions: reshaping
1838
- * a flat `comments` array into threads-of-comments later would be a breaking
1839
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
1844
- * future response that carries real replies degrades to
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
- }[], 20, undefined>]>, undefined>;
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
- * publication is not restricted by branch, so this is recorded so a subscriber
1913
- * can see what they got, and a detached HEAD has none to record.
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 — its own id for every delivered root. Resolution
2217
- * replies remain on the dashboard thread and are not delivered to agents.
2218
- * It is on the wire from the first response
2219
- * because the wire contract is consumed by installed CLI versions: reshaping
2220
- * a flat `comments` array into threads-of-comments later would be a breaking
2221
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
2226
- * future response that carries real replies degrades to
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
- }[], 20, undefined>]>, undefined>;
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
- * publication is not restricted by branch, so this is recorded so a subscriber
2295
- * can see what they got, and a detached HEAD has none to record.
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 — its own id for every delivered root. Resolution
2672
- * replies remain on the dashboard thread and are not delivered to agents.
2673
- * It is on the wire from the first response
2674
- * because the wire contract is consumed by installed CLI versions: reshaping
2675
- * a flat `comments` array into threads-of-comments later would be a breaking
2676
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
2681
- * future response that carries real replies degrades to
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 — its own id for every delivered root. Resolution
2767
- * replies remain on the dashboard thread and are not delivered to agents.
2768
- * It is on the wire from the first response
2769
- * because the wire contract is consumed by installed CLI versions: reshaping
2770
- * a flat `comments` array into threads-of-comments later would be a breaking
2771
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
2776
- * future response that carries real replies degrades to
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
- * publication is not restricted by branch, so this is recorded so a subscriber
3297
- * can see what they got, and a detached HEAD has none to record.
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 — its own id for every delivered root. Resolution
3365
- * replies remain on the dashboard thread and are not delivered to agents.
3366
- * It is on the wire from the first response
3367
- * because the wire contract is consumed by installed CLI versions: reshaping
3368
- * a flat `comments` array into threads-of-comments later would be a breaking
3369
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
3374
- * future response that carries real replies degrades to
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
- }[], 20, undefined>]>, undefined>;
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
- * publication is not restricted by branch, so this is recorded so a subscriber
3483
- * can see what they got, and a detached HEAD has none to record.
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
- * publication is not restricted by branch, so this is recorded so a subscriber
3560
- * can see what they got, and a detached HEAD has none to record.
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
- * publication is not restricted by branch, so this is recorded so a subscriber
3587
- * can see what they got, and a detached HEAD has none to record.
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
- * publication is not restricted by branch, so this is recorded so a subscriber
3676
- * can see what they got, and a detached HEAD has none to record.
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 — its own id for every delivered root. Resolution
3744
- * replies remain on the dashboard thread and are not delivered to agents.
3745
- * It is on the wire from the first response
3746
- * because the wire contract is consumed by installed CLI versions: reshaping
3747
- * a flat `comments` array into threads-of-comments later would be a breaking
3748
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
3753
- * future response that carries real replies degrades to
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
- }[], 20, undefined>]>, undefined>;
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
- * publication is not restricted by branch, so this is recorded so a subscriber
3839
- * can see what they got, and a detached HEAD has none to record.
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 — its own id for every delivered root. Resolution
3907
- * replies remain on the dashboard thread and are not delivered to agents.
3908
- * It is on the wire from the first response
3909
- * because the wire contract is consumed by installed CLI versions: reshaping
3910
- * a flat `comments` array into threads-of-comments later would be a breaking
3911
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
3916
- * future response that carries real replies degrades to
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
- }[], 20, undefined>]>, undefined>;
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
- * publication is not restricted by branch, so this is recorded so a subscriber
3989
- * can see what they got, and a detached HEAD has none to record.
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 — its own id for every delivered root. Resolution
4057
- * replies remain on the dashboard thread and are not delivered to agents.
4058
- * It is on the wire from the first response
4059
- * because the wire contract is consumed by installed CLI versions: reshaping
4060
- * a flat `comments` array into threads-of-comments later would be a breaking
4061
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
4066
- * future response that carries real replies degrades to
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
- }[], 20, undefined>]>, undefined>;
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
- * publication is not restricted by branch, so this is recorded so a subscriber
4140
- * can see what they got, and a detached HEAD has none to record.
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 — its own id for every delivered root. Resolution
4208
- * replies remain on the dashboard thread and are not delivered to agents.
4209
- * It is on the wire from the first response
4210
- * because the wire contract is consumed by installed CLI versions: reshaping
4211
- * a flat `comments` array into threads-of-comments later would be a breaking
4212
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
4217
- * future response that carries real replies degrades to
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
- }[], 20, undefined>]>, undefined>;
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 — its own id for every delivered root. Resolution
5971
- * replies remain on the dashboard thread and are not delivered to agents.
5972
- * It is on the wire from the first response
5973
- * because the wire contract is consumed by installed CLI versions: reshaping
5974
- * a flat `comments` array into threads-of-comments later would be a breaking
5975
- * change, while a field today's readers ignore costs them nothing.
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
- * Always `null` for a delivered root. Present so an older reader meeting a
5980
- * future response that carries real replies degrades to
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: readonly ["person", "agent", "mossbear"];
6510
- export declare const SearchCommentAuthorKindSchema: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
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<readonly ["person", "agent", "mossbear"], undefined>, undefined>, v.MinLengthAction<("agent" | "person" | "mossbear")[], 1, undefined>]>, undefined>;
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<readonly ["person", "agent", "mossbear"], undefined>, undefined>, v.MinLengthAction<("agent" | "person" | "mossbear")[], 1, undefined>]>, undefined>;
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?: ("agent" | "person" | "mossbear")[] | undefined;
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?: ("agent" | "person" | "mossbear")[] | undefined;
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?: ("agent" | "person" | "mossbear")[] | undefined;
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?: ("agent" | "person" | "mossbear")[] | undefined;
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?: ("agent" | "person" | "mossbear")[] | undefined;
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?: ("agent" | "person" | "mossbear")[] | undefined;
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<readonly ["person", "agent", "mossbear"], undefined>;
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<readonly ["person", "agent", "mossbear"], undefined>;
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<readonly ["person", "agent", "mossbear"], undefined>;
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<readonly ["person", "agent", "mossbear"], undefined>;
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<readonly ["person", "agent", "mossbear"], undefined>;
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<readonly ["person", "agent", "mossbear"], undefined>;
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<readonly ["person", "agent", "mossbear"], undefined>;
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<readonly ["person", "agent", "mossbear"], undefined>;
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: "agent" | "person" | "mossbear";
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: "agent" | "person" | "mossbear";
9110
+ authorKind: "person" | "agent" | "mossbear";
8328
9111
  resolved: boolean;
8329
9112
  createdAt: string;
8330
9113
  url?: string | undefined;