@mossbear/protocol 0.1.0-alpha.92 → 0.1.0-alpha.93

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
@@ -1073,6 +1073,17 @@ export type GuideHistoryUntrusted = v.InferOutput<typeof GuideHistoryUntrustedSc
1073
1073
  * never the thing that silently drops a comment a person left.
1074
1074
  */
1075
1075
  export declare const MAX_ITEM_COMMENTS_ON_WIRE = 20;
1076
+ /**
1077
+ * How many replies one delivered thread carries, the newest kept. A thread past
1078
+ * it says how many it held back (`repliesWithheld`), so a cut is never silent.
1079
+ */
1080
+ export declare const MAX_REPLIES_PER_THREAD_ON_WIRE = 10;
1081
+ /**
1082
+ * Who wrote a comment. An agent writes under its person's account, so the
1083
+ * author's name alone cannot tell a person's answer from an agent's message.
1084
+ */
1085
+ export declare const CommentAuthorKindSchema: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
1086
+ export type CommentAuthorKind = v.InferOutput<typeof CommentAuthorKindSchema>;
1076
1087
  /** What a finding rests on: graded sessions, how loads read a skill, or the rubric alone. */
1077
1088
  export declare const FindingTierSchema: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
1078
1089
  export type FindingTier = v.InferOutput<typeof FindingTierSchema>;
@@ -1147,6 +1158,12 @@ export declare const ArtifactCommentSchema: v.ObjectSchema<{
1147
1158
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1148
1159
  /** The author's display name as the workspace shows it, or null. Never an email. */
1149
1160
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1161
+ /**
1162
+ * Who wrote it. Optional because a server that predates the field omits it;
1163
+ * a reader that meets a reply without it cannot tell whose it is, and a
1164
+ * server never sends a reply to a client too old to read this.
1165
+ */
1166
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
1150
1167
  /** ISO timestamp, machine format. */
1151
1168
  readonly createdAt: v.StringSchema<undefined>;
1152
1169
  /** The item's content version the comment was written against. */
@@ -1170,20 +1187,28 @@ export declare const ArtifactCommentSchema: v.ObjectSchema<{
1170
1187
  */
1171
1188
  readonly deliveredCount: v.NumberSchema<undefined>;
1172
1189
  /**
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.
1190
+ * This comment's thread root: its own id on a root, the root's id on a reply.
1191
+ *
1192
+ * **Replies ride the same flat array**, each straight after its root, oldest
1193
+ * first. Only a client that reports a version able to render threads is
1194
+ * sent them; any other reader gets roots alone, as it always did. A person's
1195
+ * reply is part of the thread's request. An agent's reply is context: an
1196
+ * earlier message on the thread, never something to act on. A root an agent
1197
+ * wrote is delivered only once a person has replied to it, and is then the
1198
+ * question that reply answers, not a request of its own.
1179
1199
  */
1180
1200
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1181
1201
  /**
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.
1202
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
1203
+ * a reply's parent is always its root.
1185
1204
  */
1186
1205
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
1206
+ /**
1207
+ * On a root whose thread held more replies than
1208
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
1209
+ * Absent when the whole thread was sent.
1210
+ */
1211
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
1187
1212
  }, undefined>;
1188
1213
  export type ArtifactComment = v.InferOutput<typeof ArtifactCommentSchema>;
1189
1214
  /** The item routes' name for `ArtifactCommentSchema`, kept while those routes are served. */
@@ -1226,6 +1251,12 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
1226
1251
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1227
1252
  /** The author's display name as the workspace shows it, or null. Never an email. */
1228
1253
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1254
+ /**
1255
+ * Who wrote it. Optional because a server that predates the field omits it;
1256
+ * a reader that meets a reply without it cannot tell whose it is, and a
1257
+ * server never sends a reply to a client too old to read this.
1258
+ */
1259
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
1229
1260
  /** ISO timestamp, machine format. */
1230
1261
  readonly createdAt: v.StringSchema<undefined>;
1231
1262
  /** The item's content version the comment was written against. */
@@ -1249,20 +1280,28 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
1249
1280
  */
1250
1281
  readonly deliveredCount: v.NumberSchema<undefined>;
1251
1282
  /**
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.
1283
+ * This comment's thread root: its own id on a root, the root's id on a reply.
1284
+ *
1285
+ * **Replies ride the same flat array**, each straight after its root, oldest
1286
+ * first. Only a client that reports a version able to render threads is
1287
+ * sent them; any other reader gets roots alone, as it always did. A person's
1288
+ * reply is part of the thread's request. An agent's reply is context: an
1289
+ * earlier message on the thread, never something to act on. A root an agent
1290
+ * wrote is delivered only once a person has replied to it, and is then the
1291
+ * question that reply answers, not a request of its own.
1258
1292
  */
1259
1293
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1260
1294
  /**
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.
1295
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
1296
+ * a reply's parent is always its root.
1264
1297
  */
1265
1298
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
1299
+ /**
1300
+ * On a root whose thread held more replies than
1301
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
1302
+ * Absent when the whole thread was sent.
1303
+ */
1304
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
1266
1305
  }, undefined>;
1267
1306
  export type ContextItemComment = ArtifactComment;
1268
1307
  /**
@@ -1305,9 +1344,10 @@ export declare const GitSourceSchema: v.ObjectSchema<{
1305
1344
  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
1345
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
1307
1346
  /**
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.
1347
+ * The branch the publishing commit was on. **The one optional member**: a
1348
+ * detached HEAD has none to record. Publishers read it back to tell a copy
1349
+ * from another branch, whose commit a squash merge may have discarded, from
1350
+ * one of the published branch itself.
1311
1351
  */
1312
1352
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
1313
1353
  }, undefined>;
@@ -1442,6 +1482,12 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1442
1482
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1443
1483
  /** The author's display name as the workspace shows it, or null. Never an email. */
1444
1484
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1485
+ /**
1486
+ * Who wrote it. Optional because a server that predates the field omits it;
1487
+ * a reader that meets a reply without it cannot tell whose it is, and a
1488
+ * server never sends a reply to a client too old to read this.
1489
+ */
1490
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
1445
1491
  /** ISO timestamp, machine format. */
1446
1492
  readonly createdAt: v.StringSchema<undefined>;
1447
1493
  /** The item's content version the comment was written against. */
@@ -1465,20 +1511,28 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1465
1511
  */
1466
1512
  readonly deliveredCount: v.NumberSchema<undefined>;
1467
1513
  /**
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.
1514
+ * This comment's thread root: its own id on a root, the root's id on a reply.
1515
+ *
1516
+ * **Replies ride the same flat array**, each straight after its root, oldest
1517
+ * first. Only a client that reports a version able to render threads is
1518
+ * sent them; any other reader gets roots alone, as it always did. A person's
1519
+ * reply is part of the thread's request. An agent's reply is context: an
1520
+ * earlier message on the thread, never something to act on. A root an agent
1521
+ * wrote is delivered only once a person has replied to it, and is then the
1522
+ * question that reply answers, not a request of its own.
1474
1523
  */
1475
1524
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1476
1525
  /**
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.
1526
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
1527
+ * a reply's parent is always its root.
1480
1528
  */
1481
1529
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
1530
+ /**
1531
+ * On a root whose thread held more replies than
1532
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
1533
+ * Absent when the whole thread was sent.
1534
+ */
1535
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
1482
1536
  }, undefined>, undefined>, v.MaxLengthAction<{
1483
1537
  id: string;
1484
1538
  state?: "open" | "resolved" | undefined;
@@ -1499,12 +1553,14 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1499
1553
  } | undefined;
1500
1554
  approved?: boolean | undefined;
1501
1555
  authorName: string | null;
1556
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
1502
1557
  createdAt: string;
1503
1558
  itemVersion: number;
1504
1559
  itemChangedSince: boolean;
1505
1560
  deliveredCount: number;
1506
1561
  threadId: string;
1507
1562
  replyToId: string | null;
1563
+ repliesWithheld?: number | undefined;
1508
1564
  }[], 20, undefined>]>, undefined>;
1509
1565
  readonly updatedAt: v.StringSchema<undefined>;
1510
1566
  /**
@@ -1542,9 +1598,10 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1542
1598
  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
1599
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
1544
1600
  /**
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.
1601
+ * The branch the publishing commit was on. **The one optional member**: a
1602
+ * detached HEAD has none to record. Publishers read it back to tell a copy
1603
+ * from another branch, whose commit a squash merge may have discarded, from
1604
+ * one of the published branch itself.
1548
1605
  */
1549
1606
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
1550
1607
  }, undefined>, undefined>, undefined>;
@@ -1613,12 +1670,14 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1613
1670
  } | undefined;
1614
1671
  approved?: boolean | undefined;
1615
1672
  authorName: string | null;
1673
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
1616
1674
  createdAt: string;
1617
1675
  itemVersion: number;
1618
1676
  itemChangedSince: boolean;
1619
1677
  deliveredCount: number;
1620
1678
  threadId: string;
1621
1679
  replyToId: string | null;
1680
+ repliesWithheld?: number | undefined;
1622
1681
  }[] | undefined;
1623
1682
  updatedAt: string;
1624
1683
  gitSource?: {
@@ -1666,12 +1725,14 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1666
1725
  } | undefined;
1667
1726
  approved?: boolean | undefined;
1668
1727
  authorName: string | null;
1728
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
1669
1729
  createdAt: string;
1670
1730
  itemVersion: number;
1671
1731
  itemChangedSince: boolean;
1672
1732
  deliveredCount: number;
1673
1733
  threadId: string;
1674
1734
  replyToId: string | null;
1735
+ repliesWithheld?: number | undefined;
1675
1736
  }[] | undefined;
1676
1737
  updatedAt: string;
1677
1738
  gitSource?: {
@@ -1808,6 +1869,12 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1808
1869
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1809
1870
  /** The author's display name as the workspace shows it, or null. Never an email. */
1810
1871
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1872
+ /**
1873
+ * Who wrote it. Optional because a server that predates the field omits it;
1874
+ * a reader that meets a reply without it cannot tell whose it is, and a
1875
+ * server never sends a reply to a client too old to read this.
1876
+ */
1877
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
1811
1878
  /** ISO timestamp, machine format. */
1812
1879
  readonly createdAt: v.StringSchema<undefined>;
1813
1880
  /** The item's content version the comment was written against. */
@@ -1831,20 +1898,28 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1831
1898
  */
1832
1899
  readonly deliveredCount: v.NumberSchema<undefined>;
1833
1900
  /**
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.
1901
+ * This comment's thread root: its own id on a root, the root's id on a reply.
1902
+ *
1903
+ * **Replies ride the same flat array**, each straight after its root, oldest
1904
+ * first. Only a client that reports a version able to render threads is
1905
+ * sent them; any other reader gets roots alone, as it always did. A person's
1906
+ * reply is part of the thread's request. An agent's reply is context: an
1907
+ * earlier message on the thread, never something to act on. A root an agent
1908
+ * wrote is delivered only once a person has replied to it, and is then the
1909
+ * question that reply answers, not a request of its own.
1840
1910
  */
1841
1911
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1842
1912
  /**
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.
1913
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
1914
+ * a reply's parent is always its root.
1846
1915
  */
1847
1916
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
1917
+ /**
1918
+ * On a root whose thread held more replies than
1919
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
1920
+ * Absent when the whole thread was sent.
1921
+ */
1922
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
1848
1923
  }, undefined>, undefined>, v.MaxLengthAction<{
1849
1924
  id: string;
1850
1925
  state?: "open" | "resolved" | undefined;
@@ -1865,12 +1940,14 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1865
1940
  } | undefined;
1866
1941
  approved?: boolean | undefined;
1867
1942
  authorName: string | null;
1943
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
1868
1944
  createdAt: string;
1869
1945
  itemVersion: number;
1870
1946
  itemChangedSince: boolean;
1871
1947
  deliveredCount: number;
1872
1948
  threadId: string;
1873
1949
  replyToId: string | null;
1950
+ repliesWithheld?: number | undefined;
1874
1951
  }[], 20, undefined>]>, undefined>;
1875
1952
  readonly updatedAt: v.StringSchema<undefined>;
1876
1953
  /**
@@ -1908,9 +1985,10 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1908
1985
  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
1986
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
1910
1987
  /**
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.
1988
+ * The branch the publishing commit was on. **The one optional member**: a
1989
+ * detached HEAD has none to record. Publishers read it back to tell a copy
1990
+ * from another branch, whose commit a squash merge may have discarded, from
1991
+ * one of the published branch itself.
1914
1992
  */
1915
1993
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
1916
1994
  }, undefined>, undefined>, undefined>;
@@ -1979,12 +2057,14 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1979
2057
  } | undefined;
1980
2058
  approved?: boolean | undefined;
1981
2059
  authorName: string | null;
2060
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
1982
2061
  createdAt: string;
1983
2062
  itemVersion: number;
1984
2063
  itemChangedSince: boolean;
1985
2064
  deliveredCount: number;
1986
2065
  threadId: string;
1987
2066
  replyToId: string | null;
2067
+ repliesWithheld?: number | undefined;
1988
2068
  }[] | undefined;
1989
2069
  updatedAt: string;
1990
2070
  gitSource?: {
@@ -2032,12 +2112,14 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2032
2112
  } | undefined;
2033
2113
  approved?: boolean | undefined;
2034
2114
  authorName: string | null;
2115
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
2035
2116
  createdAt: string;
2036
2117
  itemVersion: number;
2037
2118
  itemChangedSince: boolean;
2038
2119
  deliveredCount: number;
2039
2120
  threadId: string;
2040
2121
  replyToId: string | null;
2122
+ repliesWithheld?: number | undefined;
2041
2123
  }[] | undefined;
2042
2124
  updatedAt: string;
2043
2125
  gitSource?: {
@@ -2190,6 +2272,12 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2190
2272
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2191
2273
  /** The author's display name as the workspace shows it, or null. Never an email. */
2192
2274
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2275
+ /**
2276
+ * Who wrote it. Optional because a server that predates the field omits it;
2277
+ * a reader that meets a reply without it cannot tell whose it is, and a
2278
+ * server never sends a reply to a client too old to read this.
2279
+ */
2280
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
2193
2281
  /** ISO timestamp, machine format. */
2194
2282
  readonly createdAt: v.StringSchema<undefined>;
2195
2283
  /** The item's content version the comment was written against. */
@@ -2213,20 +2301,28 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2213
2301
  */
2214
2302
  readonly deliveredCount: v.NumberSchema<undefined>;
2215
2303
  /**
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.
2304
+ * This comment's thread root: its own id on a root, the root's id on a reply.
2305
+ *
2306
+ * **Replies ride the same flat array**, each straight after its root, oldest
2307
+ * first. Only a client that reports a version able to render threads is
2308
+ * sent them; any other reader gets roots alone, as it always did. A person's
2309
+ * reply is part of the thread's request. An agent's reply is context: an
2310
+ * earlier message on the thread, never something to act on. A root an agent
2311
+ * wrote is delivered only once a person has replied to it, and is then the
2312
+ * question that reply answers, not a request of its own.
2222
2313
  */
2223
2314
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2224
2315
  /**
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.
2316
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
2317
+ * a reply's parent is always its root.
2228
2318
  */
2229
2319
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
2320
+ /**
2321
+ * On a root whose thread held more replies than
2322
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
2323
+ * Absent when the whole thread was sent.
2324
+ */
2325
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
2230
2326
  }, undefined>, undefined>, v.MaxLengthAction<{
2231
2327
  id: string;
2232
2328
  state?: "open" | "resolved" | undefined;
@@ -2247,12 +2343,14 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2247
2343
  } | undefined;
2248
2344
  approved?: boolean | undefined;
2249
2345
  authorName: string | null;
2346
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
2250
2347
  createdAt: string;
2251
2348
  itemVersion: number;
2252
2349
  itemChangedSince: boolean;
2253
2350
  deliveredCount: number;
2254
2351
  threadId: string;
2255
2352
  replyToId: string | null;
2353
+ repliesWithheld?: number | undefined;
2256
2354
  }[], 20, undefined>]>, undefined>;
2257
2355
  readonly updatedAt: v.StringSchema<undefined>;
2258
2356
  /**
@@ -2290,9 +2388,10 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2290
2388
  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
2389
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
2292
2390
  /**
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.
2391
+ * The branch the publishing commit was on. **The one optional member**: a
2392
+ * detached HEAD has none to record. Publishers read it back to tell a copy
2393
+ * from another branch, whose commit a squash merge may have discarded, from
2394
+ * one of the published branch itself.
2296
2395
  */
2297
2396
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
2298
2397
  }, undefined>, undefined>, undefined>;
@@ -2361,12 +2460,14 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2361
2460
  } | undefined;
2362
2461
  approved?: boolean | undefined;
2363
2462
  authorName: string | null;
2463
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
2364
2464
  createdAt: string;
2365
2465
  itemVersion: number;
2366
2466
  itemChangedSince: boolean;
2367
2467
  deliveredCount: number;
2368
2468
  threadId: string;
2369
2469
  replyToId: string | null;
2470
+ repliesWithheld?: number | undefined;
2370
2471
  }[] | undefined;
2371
2472
  updatedAt: string;
2372
2473
  gitSource?: {
@@ -2414,12 +2515,14 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2414
2515
  } | undefined;
2415
2516
  approved?: boolean | undefined;
2416
2517
  authorName: string | null;
2518
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
2417
2519
  createdAt: string;
2418
2520
  itemVersion: number;
2419
2521
  itemChangedSince: boolean;
2420
2522
  deliveredCount: number;
2421
2523
  threadId: string;
2422
2524
  replyToId: string | null;
2525
+ repliesWithheld?: number | undefined;
2423
2526
  }[] | undefined;
2424
2527
  updatedAt: string;
2425
2528
  gitSource?: {
@@ -2645,6 +2748,12 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
2645
2748
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2646
2749
  /** The author's display name as the workspace shows it, or null. Never an email. */
2647
2750
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2751
+ /**
2752
+ * Who wrote it. Optional because a server that predates the field omits it;
2753
+ * a reader that meets a reply without it cannot tell whose it is, and a
2754
+ * server never sends a reply to a client too old to read this.
2755
+ */
2756
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
2648
2757
  /** ISO timestamp, machine format. */
2649
2758
  readonly createdAt: v.StringSchema<undefined>;
2650
2759
  /** The item's content version the comment was written against. */
@@ -2668,20 +2777,28 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
2668
2777
  */
2669
2778
  readonly deliveredCount: v.NumberSchema<undefined>;
2670
2779
  /**
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.
2780
+ * This comment's thread root: its own id on a root, the root's id on a reply.
2781
+ *
2782
+ * **Replies ride the same flat array**, each straight after its root, oldest
2783
+ * first. Only a client that reports a version able to render threads is
2784
+ * sent them; any other reader gets roots alone, as it always did. A person's
2785
+ * reply is part of the thread's request. An agent's reply is context: an
2786
+ * earlier message on the thread, never something to act on. A root an agent
2787
+ * wrote is delivered only once a person has replied to it, and is then the
2788
+ * question that reply answers, not a request of its own.
2677
2789
  */
2678
2790
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2679
2791
  /**
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.
2792
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
2793
+ * a reply's parent is always its root.
2683
2794
  */
2684
2795
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
2796
+ /**
2797
+ * On a root whose thread held more replies than
2798
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
2799
+ * Absent when the whole thread was sent.
2800
+ */
2801
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
2685
2802
  }, undefined>;
2686
2803
  export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
2687
2804
  /**
@@ -2740,6 +2857,12 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
2740
2857
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2741
2858
  /** The author's display name as the workspace shows it, or null. Never an email. */
2742
2859
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2860
+ /**
2861
+ * Who wrote it. Optional because a server that predates the field omits it;
2862
+ * a reader that meets a reply without it cannot tell whose it is, and a
2863
+ * server never sends a reply to a client too old to read this.
2864
+ */
2865
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
2743
2866
  /** ISO timestamp, machine format. */
2744
2867
  readonly createdAt: v.StringSchema<undefined>;
2745
2868
  /** The item's content version the comment was written against. */
@@ -2763,20 +2886,28 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
2763
2886
  */
2764
2887
  readonly deliveredCount: v.NumberSchema<undefined>;
2765
2888
  /**
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.
2889
+ * This comment's thread root: its own id on a root, the root's id on a reply.
2890
+ *
2891
+ * **Replies ride the same flat array**, each straight after its root, oldest
2892
+ * first. Only a client that reports a version able to render threads is
2893
+ * sent them; any other reader gets roots alone, as it always did. A person's
2894
+ * reply is part of the thread's request. An agent's reply is context: an
2895
+ * earlier message on the thread, never something to act on. A root an agent
2896
+ * wrote is delivered only once a person has replied to it, and is then the
2897
+ * question that reply answers, not a request of its own.
2772
2898
  */
2773
2899
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2774
2900
  /**
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.
2901
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
2902
+ * a reply's parent is always its root.
2778
2903
  */
2779
2904
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
2905
+ /**
2906
+ * On a root whose thread held more replies than
2907
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
2908
+ * Absent when the whole thread was sent.
2909
+ */
2910
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
2780
2911
  }, undefined>, undefined>;
2781
2912
  readonly cursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2782
2913
  /**
@@ -3292,9 +3423,10 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3292
3423
  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
3424
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3294
3425
  /**
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.
3426
+ * The branch the publishing commit was on. **The one optional member**: a
3427
+ * detached HEAD has none to record. Publishers read it back to tell a copy
3428
+ * from another branch, whose commit a squash merge may have discarded, from
3429
+ * one of the published branch itself.
3298
3430
  */
3299
3431
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3300
3432
  }, undefined>, undefined>, undefined>;
@@ -3338,6 +3470,12 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3338
3470
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3339
3471
  /** The author's display name as the workspace shows it, or null. Never an email. */
3340
3472
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3473
+ /**
3474
+ * Who wrote it. Optional because a server that predates the field omits it;
3475
+ * a reader that meets a reply without it cannot tell whose it is, and a
3476
+ * server never sends a reply to a client too old to read this.
3477
+ */
3478
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
3341
3479
  /** ISO timestamp, machine format. */
3342
3480
  readonly createdAt: v.StringSchema<undefined>;
3343
3481
  /** The item's content version the comment was written against. */
@@ -3361,20 +3499,28 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3361
3499
  */
3362
3500
  readonly deliveredCount: v.NumberSchema<undefined>;
3363
3501
  /**
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.
3502
+ * This comment's thread root: its own id on a root, the root's id on a reply.
3503
+ *
3504
+ * **Replies ride the same flat array**, each straight after its root, oldest
3505
+ * first. Only a client that reports a version able to render threads is
3506
+ * sent them; any other reader gets roots alone, as it always did. A person's
3507
+ * reply is part of the thread's request. An agent's reply is context: an
3508
+ * earlier message on the thread, never something to act on. A root an agent
3509
+ * wrote is delivered only once a person has replied to it, and is then the
3510
+ * question that reply answers, not a request of its own.
3370
3511
  */
3371
3512
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3372
3513
  /**
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.
3514
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
3515
+ * a reply's parent is always its root.
3376
3516
  */
3377
3517
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
3518
+ /**
3519
+ * On a root whose thread held more replies than
3520
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
3521
+ * Absent when the whole thread was sent.
3522
+ */
3523
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
3378
3524
  }, undefined>, undefined>, v.MaxLengthAction<{
3379
3525
  id: string;
3380
3526
  state?: "open" | "resolved" | undefined;
@@ -3395,12 +3541,14 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3395
3541
  } | undefined;
3396
3542
  approved?: boolean | undefined;
3397
3543
  authorName: string | null;
3544
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
3398
3545
  createdAt: string;
3399
3546
  itemVersion: number;
3400
3547
  itemChangedSince: boolean;
3401
3548
  deliveredCount: number;
3402
3549
  threadId: string;
3403
3550
  replyToId: string | null;
3551
+ repliesWithheld?: number | undefined;
3404
3552
  }[], 20, undefined>]>, undefined>;
3405
3553
  readonly updatedAt: v.StringSchema<undefined>;
3406
3554
  }, undefined>;
@@ -3478,9 +3626,10 @@ export declare const CreateArtifactRequestSchema: v.StrictObjectSchema<{
3478
3626
  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
3627
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3480
3628
  /**
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.
3629
+ * The branch the publishing commit was on. **The one optional member**: a
3630
+ * detached HEAD has none to record. Publishers read it back to tell a copy
3631
+ * from another branch, whose commit a squash merge may have discarded, from
3632
+ * one of the published branch itself.
3484
3633
  */
3485
3634
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3486
3635
  }, undefined>, undefined>;
@@ -3555,9 +3704,10 @@ export declare const UpdateArtifactRequestSchema: v.StrictObjectSchema<{
3555
3704
  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
3705
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3557
3706
  /**
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.
3707
+ * The branch the publishing commit was on. **The one optional member**: a
3708
+ * detached HEAD has none to record. Publishers read it back to tell a copy
3709
+ * from another branch, whose commit a squash merge may have discarded, from
3710
+ * one of the published branch itself.
3561
3711
  */
3562
3712
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3563
3713
  }, undefined>, undefined>;
@@ -3582,9 +3732,10 @@ export declare const RemoveArtifactRequestSchema: v.StrictObjectSchema<{
3582
3732
  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
3733
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3584
3734
  /**
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.
3735
+ * The branch the publishing commit was on. **The one optional member**: a
3736
+ * detached HEAD has none to record. Publishers read it back to tell a copy
3737
+ * from another branch, whose commit a squash merge may have discarded, from
3738
+ * one of the published branch itself.
3588
3739
  */
3589
3740
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3590
3741
  }, undefined>;
@@ -3671,9 +3822,10 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
3671
3822
  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
3823
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3673
3824
  /**
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.
3825
+ * The branch the publishing commit was on. **The one optional member**: a
3826
+ * detached HEAD has none to record. Publishers read it back to tell a copy
3827
+ * from another branch, whose commit a squash merge may have discarded, from
3828
+ * one of the published branch itself.
3677
3829
  */
3678
3830
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3679
3831
  }, undefined>, undefined>, undefined>;
@@ -3717,6 +3869,12 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
3717
3869
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3718
3870
  /** The author's display name as the workspace shows it, or null. Never an email. */
3719
3871
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3872
+ /**
3873
+ * Who wrote it. Optional because a server that predates the field omits it;
3874
+ * a reader that meets a reply without it cannot tell whose it is, and a
3875
+ * server never sends a reply to a client too old to read this.
3876
+ */
3877
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
3720
3878
  /** ISO timestamp, machine format. */
3721
3879
  readonly createdAt: v.StringSchema<undefined>;
3722
3880
  /** The item's content version the comment was written against. */
@@ -3740,20 +3898,28 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
3740
3898
  */
3741
3899
  readonly deliveredCount: v.NumberSchema<undefined>;
3742
3900
  /**
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.
3901
+ * This comment's thread root: its own id on a root, the root's id on a reply.
3902
+ *
3903
+ * **Replies ride the same flat array**, each straight after its root, oldest
3904
+ * first. Only a client that reports a version able to render threads is
3905
+ * sent them; any other reader gets roots alone, as it always did. A person's
3906
+ * reply is part of the thread's request. An agent's reply is context: an
3907
+ * earlier message on the thread, never something to act on. A root an agent
3908
+ * wrote is delivered only once a person has replied to it, and is then the
3909
+ * question that reply answers, not a request of its own.
3749
3910
  */
3750
3911
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3751
3912
  /**
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.
3913
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
3914
+ * a reply's parent is always its root.
3755
3915
  */
3756
3916
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
3917
+ /**
3918
+ * On a root whose thread held more replies than
3919
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
3920
+ * Absent when the whole thread was sent.
3921
+ */
3922
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
3757
3923
  }, undefined>, undefined>, v.MaxLengthAction<{
3758
3924
  id: string;
3759
3925
  state?: "open" | "resolved" | undefined;
@@ -3774,12 +3940,14 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
3774
3940
  } | undefined;
3775
3941
  approved?: boolean | undefined;
3776
3942
  authorName: string | null;
3943
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
3777
3944
  createdAt: string;
3778
3945
  itemVersion: number;
3779
3946
  itemChangedSince: boolean;
3780
3947
  deliveredCount: number;
3781
3948
  threadId: string;
3782
3949
  replyToId: string | null;
3950
+ repliesWithheld?: number | undefined;
3783
3951
  }[], 20, undefined>]>, undefined>;
3784
3952
  readonly updatedAt: v.StringSchema<undefined>;
3785
3953
  }, undefined>;
@@ -3834,9 +4002,10 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
3834
4002
  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
4003
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3836
4004
  /**
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.
4005
+ * The branch the publishing commit was on. **The one optional member**: a
4006
+ * detached HEAD has none to record. Publishers read it back to tell a copy
4007
+ * from another branch, whose commit a squash merge may have discarded, from
4008
+ * one of the published branch itself.
3840
4009
  */
3841
4010
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3842
4011
  }, undefined>, undefined>, undefined>;
@@ -3880,6 +4049,12 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
3880
4049
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3881
4050
  /** The author's display name as the workspace shows it, or null. Never an email. */
3882
4051
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
4052
+ /**
4053
+ * Who wrote it. Optional because a server that predates the field omits it;
4054
+ * a reader that meets a reply without it cannot tell whose it is, and a
4055
+ * server never sends a reply to a client too old to read this.
4056
+ */
4057
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
3883
4058
  /** ISO timestamp, machine format. */
3884
4059
  readonly createdAt: v.StringSchema<undefined>;
3885
4060
  /** The item's content version the comment was written against. */
@@ -3903,20 +4078,28 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
3903
4078
  */
3904
4079
  readonly deliveredCount: v.NumberSchema<undefined>;
3905
4080
  /**
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.
4081
+ * This comment's thread root: its own id on a root, the root's id on a reply.
4082
+ *
4083
+ * **Replies ride the same flat array**, each straight after its root, oldest
4084
+ * first. Only a client that reports a version able to render threads is
4085
+ * sent them; any other reader gets roots alone, as it always did. A person's
4086
+ * reply is part of the thread's request. An agent's reply is context: an
4087
+ * earlier message on the thread, never something to act on. A root an agent
4088
+ * wrote is delivered only once a person has replied to it, and is then the
4089
+ * question that reply answers, not a request of its own.
3912
4090
  */
3913
4091
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3914
4092
  /**
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.
4093
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
4094
+ * a reply's parent is always its root.
3918
4095
  */
3919
4096
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
4097
+ /**
4098
+ * On a root whose thread held more replies than
4099
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
4100
+ * Absent when the whole thread was sent.
4101
+ */
4102
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
3920
4103
  }, undefined>, undefined>, v.MaxLengthAction<{
3921
4104
  id: string;
3922
4105
  state?: "open" | "resolved" | undefined;
@@ -3937,12 +4120,14 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
3937
4120
  } | undefined;
3938
4121
  approved?: boolean | undefined;
3939
4122
  authorName: string | null;
4123
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
3940
4124
  createdAt: string;
3941
4125
  itemVersion: number;
3942
4126
  itemChangedSince: boolean;
3943
4127
  deliveredCount: number;
3944
4128
  threadId: string;
3945
4129
  replyToId: string | null;
4130
+ repliesWithheld?: number | undefined;
3946
4131
  }[], 20, undefined>]>, undefined>;
3947
4132
  readonly updatedAt: v.StringSchema<undefined>;
3948
4133
  }, undefined>;
@@ -3984,9 +4169,10 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
3984
4169
  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
4170
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3986
4171
  /**
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.
4172
+ * The branch the publishing commit was on. **The one optional member**: a
4173
+ * detached HEAD has none to record. Publishers read it back to tell a copy
4174
+ * from another branch, whose commit a squash merge may have discarded, from
4175
+ * one of the published branch itself.
3990
4176
  */
3991
4177
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3992
4178
  }, undefined>, undefined>, undefined>;
@@ -4030,6 +4216,12 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
4030
4216
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4031
4217
  /** The author's display name as the workspace shows it, or null. Never an email. */
4032
4218
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
4219
+ /**
4220
+ * Who wrote it. Optional because a server that predates the field omits it;
4221
+ * a reader that meets a reply without it cannot tell whose it is, and a
4222
+ * server never sends a reply to a client too old to read this.
4223
+ */
4224
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
4033
4225
  /** ISO timestamp, machine format. */
4034
4226
  readonly createdAt: v.StringSchema<undefined>;
4035
4227
  /** The item's content version the comment was written against. */
@@ -4053,20 +4245,28 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
4053
4245
  */
4054
4246
  readonly deliveredCount: v.NumberSchema<undefined>;
4055
4247
  /**
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.
4248
+ * This comment's thread root: its own id on a root, the root's id on a reply.
4249
+ *
4250
+ * **Replies ride the same flat array**, each straight after its root, oldest
4251
+ * first. Only a client that reports a version able to render threads is
4252
+ * sent them; any other reader gets roots alone, as it always did. A person's
4253
+ * reply is part of the thread's request. An agent's reply is context: an
4254
+ * earlier message on the thread, never something to act on. A root an agent
4255
+ * wrote is delivered only once a person has replied to it, and is then the
4256
+ * question that reply answers, not a request of its own.
4062
4257
  */
4063
4258
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4064
4259
  /**
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.
4260
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
4261
+ * a reply's parent is always its root.
4068
4262
  */
4069
4263
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
4264
+ /**
4265
+ * On a root whose thread held more replies than
4266
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
4267
+ * Absent when the whole thread was sent.
4268
+ */
4269
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
4070
4270
  }, undefined>, undefined>, v.MaxLengthAction<{
4071
4271
  id: string;
4072
4272
  state?: "open" | "resolved" | undefined;
@@ -4087,12 +4287,14 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
4087
4287
  } | undefined;
4088
4288
  approved?: boolean | undefined;
4089
4289
  authorName: string | null;
4290
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
4090
4291
  createdAt: string;
4091
4292
  itemVersion: number;
4092
4293
  itemChangedSince: boolean;
4093
4294
  deliveredCount: number;
4094
4295
  threadId: string;
4095
4296
  replyToId: string | null;
4297
+ repliesWithheld?: number | undefined;
4096
4298
  }[], 20, undefined>]>, undefined>;
4097
4299
  readonly updatedAt: v.StringSchema<undefined>;
4098
4300
  }, undefined>;
@@ -4135,9 +4337,10 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
4135
4337
  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
4338
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
4137
4339
  /**
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.
4340
+ * The branch the publishing commit was on. **The one optional member**: a
4341
+ * detached HEAD has none to record. Publishers read it back to tell a copy
4342
+ * from another branch, whose commit a squash merge may have discarded, from
4343
+ * one of the published branch itself.
4141
4344
  */
4142
4345
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
4143
4346
  }, undefined>, undefined>, undefined>;
@@ -4181,6 +4384,12 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
4181
4384
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4182
4385
  /** The author's display name as the workspace shows it, or null. Never an email. */
4183
4386
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
4387
+ /**
4388
+ * Who wrote it. Optional because a server that predates the field omits it;
4389
+ * a reader that meets a reply without it cannot tell whose it is, and a
4390
+ * server never sends a reply to a client too old to read this.
4391
+ */
4392
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
4184
4393
  /** ISO timestamp, machine format. */
4185
4394
  readonly createdAt: v.StringSchema<undefined>;
4186
4395
  /** The item's content version the comment was written against. */
@@ -4204,20 +4413,28 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
4204
4413
  */
4205
4414
  readonly deliveredCount: v.NumberSchema<undefined>;
4206
4415
  /**
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.
4416
+ * This comment's thread root: its own id on a root, the root's id on a reply.
4417
+ *
4418
+ * **Replies ride the same flat array**, each straight after its root, oldest
4419
+ * first. Only a client that reports a version able to render threads is
4420
+ * sent them; any other reader gets roots alone, as it always did. A person's
4421
+ * reply is part of the thread's request. An agent's reply is context: an
4422
+ * earlier message on the thread, never something to act on. A root an agent
4423
+ * wrote is delivered only once a person has replied to it, and is then the
4424
+ * question that reply answers, not a request of its own.
4213
4425
  */
4214
4426
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4215
4427
  /**
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.
4428
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
4429
+ * a reply's parent is always its root.
4219
4430
  */
4220
4431
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
4432
+ /**
4433
+ * On a root whose thread held more replies than
4434
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
4435
+ * Absent when the whole thread was sent.
4436
+ */
4437
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
4221
4438
  }, undefined>, undefined>, v.MaxLengthAction<{
4222
4439
  id: string;
4223
4440
  state?: "open" | "resolved" | undefined;
@@ -4238,12 +4455,14 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
4238
4455
  } | undefined;
4239
4456
  approved?: boolean | undefined;
4240
4457
  authorName: string | null;
4458
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
4241
4459
  createdAt: string;
4242
4460
  itemVersion: number;
4243
4461
  itemChangedSince: boolean;
4244
4462
  deliveredCount: number;
4245
4463
  threadId: string;
4246
4464
  replyToId: string | null;
4465
+ repliesWithheld?: number | undefined;
4247
4466
  }[], 20, undefined>]>, undefined>;
4248
4467
  readonly updatedAt: v.StringSchema<undefined>;
4249
4468
  }, undefined>;
@@ -4545,22 +4764,56 @@ export type ActionNarration = v.InferOutput<typeof ActionNarrationSchema>;
4545
4764
  export declare const TokenUsageSchema: v.ObjectSchema<{
4546
4765
  readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4547
4766
  readonly provider: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
4767
+ 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
4768
  readonly inputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4549
4769
  readonly outputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4550
4770
  readonly cacheReadTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4551
4771
  readonly cacheWriteTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4552
4772
  }, undefined>;
4773
+ /** Identity of a model's usage at an instant, or its undated legacy total. */
4774
+ export declare function usageRowKey(row: {
4775
+ model: string;
4776
+ occurredAt?: number | undefined;
4777
+ }): string;
4778
+ /** Preserve legacy model ordering so saved numerical proofs remain verifiable. */
4779
+ export declare function compareUsageRows(a: {
4780
+ model: string;
4781
+ occurredAt?: number | undefined;
4782
+ }, b: {
4783
+ model: string;
4784
+ occurredAt?: number | undefined;
4785
+ }): number;
4786
+ export declare const MAX_HOSTED_USAGE_ROWS = 50000;
4787
+ export declare const MAX_HOSTED_USAGE_BYTES: number;
4788
+ export declare const MAX_SYNC_REQUEST_BYTES: number;
4553
4789
  export declare const DashboardSessionUsageSchema: v.ObjectSchema<{
4554
4790
  readonly sessionId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
4555
4791
  readonly agentSessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4556
- readonly usage: v.ArraySchema<v.ObjectSchema<{
4792
+ readonly usage: v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4557
4793
  readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4558
4794
  readonly provider: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
4795
+ 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
4796
  readonly inputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4560
4797
  readonly outputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4561
4798
  readonly cacheReadTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4562
4799
  readonly cacheWriteTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4563
- }, undefined>, undefined>;
4800
+ }, undefined>, undefined>, v.MaxLengthAction<{
4801
+ model: string;
4802
+ provider?: string | undefined;
4803
+ occurredAt?: number | undefined;
4804
+ inputTokens: number;
4805
+ outputTokens: number;
4806
+ cacheReadTokens?: number | undefined;
4807
+ cacheWriteTokens?: number | undefined;
4808
+ }[], 50000, undefined>, v.CheckAction<{
4809
+ model: string;
4810
+ provider?: string | undefined;
4811
+ occurredAt?: number | undefined;
4812
+ inputTokens: number;
4813
+ outputTokens: number;
4814
+ cacheReadTokens?: number | undefined;
4815
+ cacheWriteTokens?: number | undefined;
4816
+ }[], "Usage snapshot exceeds the single-session upload capacity">]>;
4564
4817
  }, undefined>;
4565
4818
  export declare const SkillUsageEntrySchema: v.ObjectSchema<{
4566
4819
  readonly skillName: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -4963,20 +5216,38 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
4963
5216
  readonly runUsage: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4964
5217
  readonly sessionId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
4965
5218
  readonly agentSessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4966
- readonly usage: v.ArraySchema<v.ObjectSchema<{
5219
+ readonly usage: v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4967
5220
  readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4968
5221
  readonly provider: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
5222
+ 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
5223
  readonly inputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4970
5224
  readonly outputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4971
5225
  readonly cacheReadTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4972
5226
  readonly cacheWriteTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4973
- }, undefined>, undefined>;
5227
+ }, undefined>, undefined>, v.MaxLengthAction<{
5228
+ model: string;
5229
+ provider?: string | undefined;
5230
+ occurredAt?: number | undefined;
5231
+ inputTokens: number;
5232
+ outputTokens: number;
5233
+ cacheReadTokens?: number | undefined;
5234
+ cacheWriteTokens?: number | undefined;
5235
+ }[], 50000, undefined>, v.CheckAction<{
5236
+ model: string;
5237
+ provider?: string | undefined;
5238
+ occurredAt?: number | undefined;
5239
+ inputTokens: number;
5240
+ outputTokens: number;
5241
+ cacheReadTokens?: number | undefined;
5242
+ cacheWriteTokens?: number | undefined;
5243
+ }[], "Usage snapshot exceeds the single-session upload capacity">]>;
4974
5244
  }, undefined>, undefined>, v.MaxLengthAction<{
4975
5245
  sessionId?: string | undefined;
4976
5246
  agentSessionId: string;
4977
5247
  usage: {
4978
5248
  model: string;
4979
5249
  provider?: string | undefined;
5250
+ occurredAt?: number | undefined;
4980
5251
  inputTokens: number;
4981
5252
  outputTokens: number;
4982
5253
  cacheReadTokens?: number | undefined;
@@ -5944,6 +6215,12 @@ export declare const ArtifactFeedbackResponseSchema: v.ObjectSchema<{
5944
6215
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
5945
6216
  /** The author's display name as the workspace shows it, or null. Never an email. */
5946
6217
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6218
+ /**
6219
+ * Who wrote it. Optional because a server that predates the field omits it;
6220
+ * a reader that meets a reply without it cannot tell whose it is, and a
6221
+ * server never sends a reply to a client too old to read this.
6222
+ */
6223
+ readonly authorKind: v.OptionalSchema<v.PicklistSchema<["person", "agent", "mossbear"], undefined>, undefined>;
5947
6224
  /** ISO timestamp, machine format. */
5948
6225
  readonly createdAt: v.StringSchema<undefined>;
5949
6226
  /** The item's content version the comment was written against. */
@@ -5967,20 +6244,28 @@ export declare const ArtifactFeedbackResponseSchema: v.ObjectSchema<{
5967
6244
  */
5968
6245
  readonly deliveredCount: v.NumberSchema<undefined>;
5969
6246
  /**
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.
6247
+ * This comment's thread root: its own id on a root, the root's id on a reply.
6248
+ *
6249
+ * **Replies ride the same flat array**, each straight after its root, oldest
6250
+ * first. Only a client that reports a version able to render threads is
6251
+ * sent them; any other reader gets roots alone, as it always did. A person's
6252
+ * reply is part of the thread's request. An agent's reply is context: an
6253
+ * earlier message on the thread, never something to act on. A root an agent
6254
+ * wrote is delivered only once a person has replied to it, and is then the
6255
+ * question that reply answers, not a request of its own.
5976
6256
  */
5977
6257
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5978
6258
  /**
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.
6259
+ * `null` on a root; the root's id on a reply. Threads are one level deep, so
6260
+ * a reply's parent is always its root.
5982
6261
  */
5983
6262
  readonly replyToId: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
6263
+ /**
6264
+ * On a root whose thread held more replies than
6265
+ * `MAX_REPLIES_PER_THREAD_ON_WIRE`: how many older ones were not sent.
6266
+ * Absent when the whole thread was sent.
6267
+ */
6268
+ readonly repliesWithheld: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
5984
6269
  }, undefined>, undefined>;
5985
6270
  /** Absent on the last page; pass it back as `cursor` for the next. */
5986
6271
  readonly nextCursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -6202,7 +6487,8 @@ export type SessionGradeRequest = v.InferOutput<typeof SessionGradeRequestSchema
6202
6487
  *
6203
6488
  * - `pending` — no grade yet, and the grading sweep can still pick the run
6204
6489
  * up (it is open, or closed inside the grading window). "Not graded yet"
6205
- * is honest here and only here.
6490
+ * is honest here and only here — unless `gradeFailedAttempts` is above
6491
+ * zero, when grading has been tried and has not finished.
6206
6492
  * - `graded` — a grader judged it; `grade` carries what it said.
6207
6493
  * - `nothing_to_grade` — a grader ran and found nothing to judge: no
6208
6494
  * gradeable actions, or no guides in the agent's context. The record
@@ -6281,6 +6567,7 @@ export declare const SessionGradeResponseSchema: v.ObjectSchema<{
6281
6567
  readonly status: v.PicklistSchema<["open", "closed"], undefined>;
6282
6568
  }, undefined>;
6283
6569
  readonly state: v.PicklistSchema<["pending", "graded", "nothing_to_grade", "expired", "grading_off"], undefined>;
6570
+ readonly gradeFailedAttempts: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
6284
6571
  /** Present exactly when `state` is `graded`. */
6285
6572
  readonly grade: v.NullableSchema<v.ObjectSchema<{
6286
6573
  /** The grader's one-paragraph judgment of the run, wrapped like `reasoning`; null when the record carries none. */
@@ -6373,6 +6660,7 @@ export declare const SessionDigestResponseSchema: v.ObjectSchema<{
6373
6660
  readonly status: v.PicklistSchema<["open", "closed"], undefined>;
6374
6661
  }, undefined>;
6375
6662
  readonly state: v.PicklistSchema<["pending", "graded", "nothing_to_grade", "expired", "grading_off"], undefined>;
6663
+ readonly gradeFailedAttempts: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
6376
6664
  readonly grade: v.NullableSchema<v.ObjectSchema<{
6377
6665
  /** The grader's one-paragraph judgment of the run, wrapped like `reasoning`; null when the record carries none. */
6378
6666
  readonly summary: v.NullableSchema<v.StringSchema<undefined>, undefined>;
@@ -6506,8 +6794,8 @@ export declare const SearchFrontmatterSchema: v.SchemaWithPipe<readonly [v.Recor
6506
6794
  }, "frontmatter takes between 1 and 3 fields">]>;
6507
6795
  export type SearchFrontmatter = v.InferOutput<typeof SearchFrontmatterSchema>;
6508
6796
  /** 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>;
6797
+ export declare const SEARCH_COMMENT_AUTHOR_KINDS: ["person", "agent", "mossbear"];
6798
+ export declare const SearchCommentAuthorKindSchema: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
6511
6799
  export type SearchCommentAuthorKind = v.InferOutput<typeof SearchCommentAuthorKindSchema>;
6512
6800
  /**
6513
6801
  * What a comment is attached to. `artifact` is a guide or a document; `session`
@@ -6571,7 +6859,7 @@ export declare const SearchRequestObjectSchema: v.ObjectSchema<{
6571
6859
  * Restrict the `comments` corpus to comments written by these kinds of
6572
6860
  * author. Does not touch other corpora.
6573
6861
  */
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>;
6862
+ 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
6863
  /**
6576
6864
  * Restrict the `comments` corpus to comments on these kinds of subject. Does
6577
6865
  * not touch other corpora.
@@ -6641,7 +6929,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6641
6929
  * Restrict the `comments` corpus to comments written by these kinds of
6642
6930
  * author. Does not touch other corpora.
6643
6931
  */
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>;
6932
+ 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
6933
  /**
6646
6934
  * Restrict the `comments` corpus to comments on these kinds of subject. Does
6647
6935
  * not touch other corpora.
@@ -6680,7 +6968,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6680
6968
  frontmatter?: {
6681
6969
  [x: string]: string;
6682
6970
  } | undefined;
6683
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
6971
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6684
6972
  subjectKinds?: ("artifact" | "session")[] | undefined;
6685
6973
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6686
6974
  headSha?: string | undefined;
@@ -6697,7 +6985,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6697
6985
  frontmatter?: {
6698
6986
  [x: string]: string;
6699
6987
  } | undefined;
6700
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
6988
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6701
6989
  subjectKinds?: ("artifact" | "session")[] | undefined;
6702
6990
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6703
6991
  headSha?: string | undefined;
@@ -6714,7 +7002,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6714
7002
  frontmatter?: {
6715
7003
  [x: string]: string;
6716
7004
  } | undefined;
6717
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
7005
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6718
7006
  subjectKinds?: ("artifact" | "session")[] | undefined;
6719
7007
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6720
7008
  headSha?: string | undefined;
@@ -6731,7 +7019,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6731
7019
  frontmatter?: {
6732
7020
  [x: string]: string;
6733
7021
  } | undefined;
6734
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
7022
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6735
7023
  subjectKinds?: ("artifact" | "session")[] | undefined;
6736
7024
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6737
7025
  headSha?: string | undefined;
@@ -6748,7 +7036,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6748
7036
  frontmatter?: {
6749
7037
  [x: string]: string;
6750
7038
  } | undefined;
6751
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
7039
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6752
7040
  subjectKinds?: ("artifact" | "session")[] | undefined;
6753
7041
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6754
7042
  headSha?: string | undefined;
@@ -6765,7 +7053,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6765
7053
  frontmatter?: {
6766
7054
  [x: string]: string;
6767
7055
  } | undefined;
6768
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
7056
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6769
7057
  subjectKinds?: ("artifact" | "session")[] | undefined;
6770
7058
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6771
7059
  headSha?: string | undefined;
@@ -6890,7 +7178,7 @@ export declare const SearchArtifactCommentHitSchema: v.ObjectSchema<{
6890
7178
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6891
7179
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6892
7180
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6893
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7181
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
6894
7182
  readonly resolved: v.BooleanSchema<undefined>;
6895
7183
  readonly createdAt: v.StringSchema<undefined>;
6896
7184
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -6907,7 +7195,7 @@ export declare const SearchSessionCommentHitSchema: v.ObjectSchema<{
6907
7195
  readonly matchedIn: v.LiteralSchema<"body", undefined>;
6908
7196
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6909
7197
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6910
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7198
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
6911
7199
  readonly resolved: v.BooleanSchema<undefined>;
6912
7200
  readonly createdAt: v.StringSchema<undefined>;
6913
7201
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -6943,7 +7231,7 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
6943
7231
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6944
7232
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6945
7233
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6946
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7234
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
6947
7235
  readonly resolved: v.BooleanSchema<undefined>;
6948
7236
  readonly createdAt: v.StringSchema<undefined>;
6949
7237
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -6954,7 +7242,7 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
6954
7242
  readonly matchedIn: v.LiteralSchema<"body", undefined>;
6955
7243
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6956
7244
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6957
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7245
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
6958
7246
  readonly resolved: v.BooleanSchema<undefined>;
6959
7247
  readonly createdAt: v.StringSchema<undefined>;
6960
7248
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -7161,7 +7449,7 @@ export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.Ob
7161
7449
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7162
7450
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7163
7451
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7164
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7452
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
7165
7453
  readonly resolved: v.BooleanSchema<undefined>;
7166
7454
  readonly createdAt: v.StringSchema<undefined>;
7167
7455
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -7172,7 +7460,7 @@ export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.Ob
7172
7460
  readonly matchedIn: v.LiteralSchema<"body", undefined>;
7173
7461
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7174
7462
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7175
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7463
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
7176
7464
  readonly resolved: v.BooleanSchema<undefined>;
7177
7465
  readonly createdAt: v.StringSchema<undefined>;
7178
7466
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -7405,7 +7693,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
7405
7693
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7406
7694
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7407
7695
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7408
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7696
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
7409
7697
  readonly resolved: v.BooleanSchema<undefined>;
7410
7698
  readonly createdAt: v.StringSchema<undefined>;
7411
7699
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -7416,7 +7704,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
7416
7704
  readonly matchedIn: v.LiteralSchema<"body", undefined>;
7417
7705
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7418
7706
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7419
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7707
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
7420
7708
  readonly resolved: v.BooleanSchema<undefined>;
7421
7709
  readonly createdAt: v.StringSchema<undefined>;
7422
7710
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -7691,12 +7979,14 @@ export declare function parseContextItemsResponse(data: unknown): {
7691
7979
  } | undefined;
7692
7980
  approved?: boolean | undefined;
7693
7981
  authorName: string | null;
7982
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
7694
7983
  createdAt: string;
7695
7984
  itemVersion: number;
7696
7985
  itemChangedSince: boolean;
7697
7986
  deliveredCount: number;
7698
7987
  threadId: string;
7699
7988
  replyToId: string | null;
7989
+ repliesWithheld?: number | undefined;
7700
7990
  }[] | undefined;
7701
7991
  updatedAt: string;
7702
7992
  gitSource?: {
@@ -7753,12 +8043,14 @@ export declare function parseBundleArtifactsResponse(data: unknown): {
7753
8043
  } | undefined;
7754
8044
  approved?: boolean | undefined;
7755
8045
  authorName: string | null;
8046
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
7756
8047
  createdAt: string;
7757
8048
  itemVersion: number;
7758
8049
  itemChangedSince: boolean;
7759
8050
  deliveredCount: number;
7760
8051
  threadId: string;
7761
8052
  replyToId: string | null;
8053
+ repliesWithheld?: number | undefined;
7762
8054
  }[] | undefined;
7763
8055
  updatedAt: string;
7764
8056
  gitSource?: {
@@ -7869,6 +8161,7 @@ export declare function parseDashboardSyncRequest(data: unknown): {
7869
8161
  usage: {
7870
8162
  model: string;
7871
8163
  provider?: string | undefined;
8164
+ occurredAt?: number | undefined;
7872
8165
  inputTokens: number;
7873
8166
  outputTokens: number;
7874
8167
  cacheReadTokens?: number | undefined;
@@ -8096,12 +8389,14 @@ export declare function parseItemCommentsResponse(data: unknown): {
8096
8389
  } | undefined;
8097
8390
  approved?: boolean | undefined;
8098
8391
  authorName: string | null;
8392
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
8099
8393
  createdAt: string;
8100
8394
  itemVersion: number;
8101
8395
  itemChangedSince: boolean;
8102
8396
  deliveredCount: number;
8103
8397
  threadId: string;
8104
8398
  replyToId: string | null;
8399
+ repliesWithheld?: number | undefined;
8105
8400
  }[];
8106
8401
  cursor?: string | undefined;
8107
8402
  untrusted?: {
@@ -8180,6 +8475,7 @@ export declare function parseSessionGradeResponse(data: unknown): {
8180
8475
  status: "open" | "closed";
8181
8476
  };
8182
8477
  state: "pending" | "graded" | "nothing_to_grade" | "expired" | "grading_off";
8478
+ gradeFailedAttempts?: number | undefined;
8183
8479
  grade: {
8184
8480
  summary: string | null;
8185
8481
  gradedAt: string;
@@ -8208,6 +8504,7 @@ export declare function parseSessionDigestResponse(data: unknown): {
8208
8504
  status: "open" | "closed";
8209
8505
  };
8210
8506
  state: "pending" | "graded" | "nothing_to_grade" | "expired" | "grading_off";
8507
+ gradeFailedAttempts?: number | undefined;
8211
8508
  grade: {
8212
8509
  summary: string | null;
8213
8510
  gradedAt: string;
@@ -8313,7 +8610,7 @@ export declare function parseSearchResponse(data: unknown): {
8313
8610
  approved?: boolean | undefined;
8314
8611
  commentId: string;
8315
8612
  threadId: string;
8316
- authorKind: "agent" | "person" | "mossbear";
8613
+ authorKind: "person" | "agent" | "mossbear";
8317
8614
  resolved: boolean;
8318
8615
  createdAt: string;
8319
8616
  url?: string | undefined;
@@ -8324,7 +8621,7 @@ export declare function parseSearchResponse(data: unknown): {
8324
8621
  matchedIn: "body";
8325
8622
  commentId: string;
8326
8623
  threadId: string;
8327
- authorKind: "agent" | "person" | "mossbear";
8624
+ authorKind: "person" | "agent" | "mossbear";
8328
8625
  resolved: boolean;
8329
8626
  createdAt: string;
8330
8627
  url?: string | undefined;