@mossbear/protocol 0.1.0-alpha.91 → 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
@@ -955,24 +955,43 @@ export declare const AttachBundleMemberResponseSchema: v.ObjectSchema<{
955
955
  export declare const DetachBundleMemberResponseSchema: v.ObjectSchema<{
956
956
  readonly detached: v.BooleanSchema<undefined>;
957
957
  }, undefined>;
958
+ /**
959
+ * The most field keys a bundle's shared column list may hold, and the longest
960
+ * one. A key is a frontmatter key as written, so the bound is on what a
961
+ * dashboard could ever show as a column rather than on any real key's length;
962
+ * both are generous enough that a refusal means a client bug.
963
+ */
964
+ export declare const BUNDLE_COLUMNS_MAX_COUNT = 100;
965
+ export declare const BUNDLE_COLUMN_KEY_MAX_LENGTH = 200;
966
+ /**
967
+ * A bundle's shared column list: field keys in display order, no key twice.
968
+ * An array that repeats a key is refused rather than deduplicated, since the
969
+ * order is the content and a client that sent one has lost track of its own
970
+ * list.
971
+ */
972
+ export declare const BundleColumnsSchema: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>, v.CheckAction<string[], "columns must not repeat a key">]>;
958
973
  /**
959
974
  * What `PATCH /api/v1/context/bundles/:id` may change: the display name, the
960
- * home repo, or both. The slug stays immutable — repos address a bundle by id
961
- * and name it by slug, so a slug change would rename a folder in every
962
- * subscriber's checkout (`context-bundle-authoring-plan.md` → D14).
975
+ * home repo, the shared column list, or any of them. The slug stays immutable
976
+ * — repos address a bundle by id and name it by slug, so a slug change would
977
+ * rename a folder in every subscriber's checkout.
963
978
  *
964
- * Both fields optional, with a check that at least one is present: a body that
979
+ * Every field optional, with a check that at least one is present: a body that
965
980
  * changes nothing is a request the caller did not mean to send, and answering it
966
981
  * 200 would hide a client bug. `home: null` clears the claim, which is how a
967
982
  * repo hands a bundle back — distinct from omitting the field, which leaves it.
983
+ * `columns: null` is the same for the column list: it returns the bundle to
984
+ * "not chosen", where every shared field shows.
968
985
  */
969
986
  export declare const UpdateBundleRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
970
987
  readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, number, undefined>, v.CheckAction<string, "Remove the invisible characters from this name — copying text from another app often brings them along.">, v.RegexAction<string, "Remove the invisible characters from this name — copying text from another app often brings them along.">]>, undefined>;
971
988
  readonly home: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>, undefined>;
989
+ readonly columns: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>, v.CheckAction<string[], "columns must not repeat a key">]>, undefined>, undefined>;
972
990
  }, undefined>, v.CheckAction<{
973
991
  name?: string | undefined;
974
992
  home?: string | null | undefined;
975
- }, "name or home is required">]>;
993
+ columns?: string[] | null | undefined;
994
+ }, "name, home or columns is required">]>;
976
995
  export declare const UpdateBundleResponseSchema: v.ObjectSchema<{
977
996
  readonly bundle: v.ObjectSchema<{
978
997
  readonly id: v.StringSchema<undefined>;
@@ -1054,6 +1073,17 @@ export type GuideHistoryUntrusted = v.InferOutput<typeof GuideHistoryUntrustedSc
1054
1073
  * never the thing that silently drops a comment a person left.
1055
1074
  */
1056
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>;
1057
1087
  /** What a finding rests on: graded sessions, how loads read a skill, or the rubric alone. */
1058
1088
  export declare const FindingTierSchema: v.PicklistSchema<["observed", "usage", "practice"], undefined>;
1059
1089
  export type FindingTier = v.InferOutput<typeof FindingTierSchema>;
@@ -1128,6 +1158,12 @@ export declare const ArtifactCommentSchema: v.ObjectSchema<{
1128
1158
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1129
1159
  /** The author's display name as the workspace shows it, or null. Never an email. */
1130
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>;
1131
1167
  /** ISO timestamp, machine format. */
1132
1168
  readonly createdAt: v.StringSchema<undefined>;
1133
1169
  /** The item's content version the comment was written against. */
@@ -1151,20 +1187,28 @@ export declare const ArtifactCommentSchema: v.ObjectSchema<{
1151
1187
  */
1152
1188
  readonly deliveredCount: v.NumberSchema<undefined>;
1153
1189
  /**
1154
- * This comment's thread root — its own id for every delivered root. Resolution
1155
- * replies remain on the dashboard thread and are not delivered to agents.
1156
- * It is on the wire from the first response
1157
- * because the wire contract is consumed by installed CLI versions: reshaping
1158
- * a flat `comments` array into threads-of-comments later would be a breaking
1159
- * 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.
1160
1199
  */
1161
1200
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1162
1201
  /**
1163
- * Always `null` for a delivered root. Present so an older reader meeting a
1164
- * future response that carries real replies degrades to
1165
- * "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.
1166
1204
  */
1167
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>;
1168
1212
  }, undefined>;
1169
1213
  export type ArtifactComment = v.InferOutput<typeof ArtifactCommentSchema>;
1170
1214
  /** The item routes' name for `ArtifactCommentSchema`, kept while those routes are served. */
@@ -1207,6 +1251,12 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
1207
1251
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1208
1252
  /** The author's display name as the workspace shows it, or null. Never an email. */
1209
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>;
1210
1260
  /** ISO timestamp, machine format. */
1211
1261
  readonly createdAt: v.StringSchema<undefined>;
1212
1262
  /** The item's content version the comment was written against. */
@@ -1230,20 +1280,28 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
1230
1280
  */
1231
1281
  readonly deliveredCount: v.NumberSchema<undefined>;
1232
1282
  /**
1233
- * This comment's thread root — its own id for every delivered root. Resolution
1234
- * replies remain on the dashboard thread and are not delivered to agents.
1235
- * It is on the wire from the first response
1236
- * because the wire contract is consumed by installed CLI versions: reshaping
1237
- * a flat `comments` array into threads-of-comments later would be a breaking
1238
- * 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.
1239
1292
  */
1240
1293
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1241
1294
  /**
1242
- * Always `null` for a delivered root. Present so an older reader meeting a
1243
- * future response that carries real replies degrades to
1244
- * "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.
1245
1297
  */
1246
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>;
1247
1305
  }, undefined>;
1248
1306
  export type ContextItemComment = ArtifactComment;
1249
1307
  /**
@@ -1286,9 +1344,10 @@ export declare const GitSourceSchema: v.ObjectSchema<{
1286
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">]>;
1287
1345
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
1288
1346
  /**
1289
- * The branch the publishing commit was on. **The one optional member**:
1290
- * publication is not restricted by branch, so this is recorded so a subscriber
1291
- * 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.
1292
1351
  */
1293
1352
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
1294
1353
  }, undefined>;
@@ -1423,6 +1482,12 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1423
1482
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1424
1483
  /** The author's display name as the workspace shows it, or null. Never an email. */
1425
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>;
1426
1491
  /** ISO timestamp, machine format. */
1427
1492
  readonly createdAt: v.StringSchema<undefined>;
1428
1493
  /** The item's content version the comment was written against. */
@@ -1446,20 +1511,28 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1446
1511
  */
1447
1512
  readonly deliveredCount: v.NumberSchema<undefined>;
1448
1513
  /**
1449
- * This comment's thread root — its own id for every delivered root. Resolution
1450
- * replies remain on the dashboard thread and are not delivered to agents.
1451
- * It is on the wire from the first response
1452
- * because the wire contract is consumed by installed CLI versions: reshaping
1453
- * a flat `comments` array into threads-of-comments later would be a breaking
1454
- * 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.
1455
1523
  */
1456
1524
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1457
1525
  /**
1458
- * Always `null` for a delivered root. Present so an older reader meeting a
1459
- * future response that carries real replies degrades to
1460
- * "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.
1461
1528
  */
1462
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>;
1463
1536
  }, undefined>, undefined>, v.MaxLengthAction<{
1464
1537
  id: string;
1465
1538
  state?: "open" | "resolved" | undefined;
@@ -1480,12 +1553,14 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1480
1553
  } | undefined;
1481
1554
  approved?: boolean | undefined;
1482
1555
  authorName: string | null;
1556
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
1483
1557
  createdAt: string;
1484
1558
  itemVersion: number;
1485
1559
  itemChangedSince: boolean;
1486
1560
  deliveredCount: number;
1487
1561
  threadId: string;
1488
1562
  replyToId: string | null;
1563
+ repliesWithheld?: number | undefined;
1489
1564
  }[], 20, undefined>]>, undefined>;
1490
1565
  readonly updatedAt: v.StringSchema<undefined>;
1491
1566
  /**
@@ -1523,9 +1598,10 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1523
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">]>;
1524
1599
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
1525
1600
  /**
1526
- * The branch the publishing commit was on. **The one optional member**:
1527
- * publication is not restricted by branch, so this is recorded so a subscriber
1528
- * 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.
1529
1605
  */
1530
1606
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
1531
1607
  }, undefined>, undefined>, undefined>;
@@ -1594,12 +1670,14 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1594
1670
  } | undefined;
1595
1671
  approved?: boolean | undefined;
1596
1672
  authorName: string | null;
1673
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
1597
1674
  createdAt: string;
1598
1675
  itemVersion: number;
1599
1676
  itemChangedSince: boolean;
1600
1677
  deliveredCount: number;
1601
1678
  threadId: string;
1602
1679
  replyToId: string | null;
1680
+ repliesWithheld?: number | undefined;
1603
1681
  }[] | undefined;
1604
1682
  updatedAt: string;
1605
1683
  gitSource?: {
@@ -1647,12 +1725,14 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1647
1725
  } | undefined;
1648
1726
  approved?: boolean | undefined;
1649
1727
  authorName: string | null;
1728
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
1650
1729
  createdAt: string;
1651
1730
  itemVersion: number;
1652
1731
  itemChangedSince: boolean;
1653
1732
  deliveredCount: number;
1654
1733
  threadId: string;
1655
1734
  replyToId: string | null;
1735
+ repliesWithheld?: number | undefined;
1656
1736
  }[] | undefined;
1657
1737
  updatedAt: string;
1658
1738
  gitSource?: {
@@ -1789,6 +1869,12 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1789
1869
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1790
1870
  /** The author's display name as the workspace shows it, or null. Never an email. */
1791
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>;
1792
1878
  /** ISO timestamp, machine format. */
1793
1879
  readonly createdAt: v.StringSchema<undefined>;
1794
1880
  /** The item's content version the comment was written against. */
@@ -1812,20 +1898,28 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1812
1898
  */
1813
1899
  readonly deliveredCount: v.NumberSchema<undefined>;
1814
1900
  /**
1815
- * This comment's thread root — its own id for every delivered root. Resolution
1816
- * replies remain on the dashboard thread and are not delivered to agents.
1817
- * It is on the wire from the first response
1818
- * because the wire contract is consumed by installed CLI versions: reshaping
1819
- * a flat `comments` array into threads-of-comments later would be a breaking
1820
- * 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.
1821
1910
  */
1822
1911
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1823
1912
  /**
1824
- * Always `null` for a delivered root. Present so an older reader meeting a
1825
- * future response that carries real replies degrades to
1826
- * "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.
1827
1915
  */
1828
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>;
1829
1923
  }, undefined>, undefined>, v.MaxLengthAction<{
1830
1924
  id: string;
1831
1925
  state?: "open" | "resolved" | undefined;
@@ -1846,12 +1940,14 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1846
1940
  } | undefined;
1847
1941
  approved?: boolean | undefined;
1848
1942
  authorName: string | null;
1943
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
1849
1944
  createdAt: string;
1850
1945
  itemVersion: number;
1851
1946
  itemChangedSince: boolean;
1852
1947
  deliveredCount: number;
1853
1948
  threadId: string;
1854
1949
  replyToId: string | null;
1950
+ repliesWithheld?: number | undefined;
1855
1951
  }[], 20, undefined>]>, undefined>;
1856
1952
  readonly updatedAt: v.StringSchema<undefined>;
1857
1953
  /**
@@ -1889,9 +1985,10 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1889
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">]>;
1890
1986
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
1891
1987
  /**
1892
- * The branch the publishing commit was on. **The one optional member**:
1893
- * publication is not restricted by branch, so this is recorded so a subscriber
1894
- * 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.
1895
1992
  */
1896
1993
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
1897
1994
  }, undefined>, undefined>, undefined>;
@@ -1960,12 +2057,14 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1960
2057
  } | undefined;
1961
2058
  approved?: boolean | undefined;
1962
2059
  authorName: string | null;
2060
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
1963
2061
  createdAt: string;
1964
2062
  itemVersion: number;
1965
2063
  itemChangedSince: boolean;
1966
2064
  deliveredCount: number;
1967
2065
  threadId: string;
1968
2066
  replyToId: string | null;
2067
+ repliesWithheld?: number | undefined;
1969
2068
  }[] | undefined;
1970
2069
  updatedAt: string;
1971
2070
  gitSource?: {
@@ -2013,12 +2112,14 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2013
2112
  } | undefined;
2014
2113
  approved?: boolean | undefined;
2015
2114
  authorName: string | null;
2115
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
2016
2116
  createdAt: string;
2017
2117
  itemVersion: number;
2018
2118
  itemChangedSince: boolean;
2019
2119
  deliveredCount: number;
2020
2120
  threadId: string;
2021
2121
  replyToId: string | null;
2122
+ repliesWithheld?: number | undefined;
2022
2123
  }[] | undefined;
2023
2124
  updatedAt: string;
2024
2125
  gitSource?: {
@@ -2171,6 +2272,12 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2171
2272
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2172
2273
  /** The author's display name as the workspace shows it, or null. Never an email. */
2173
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>;
2174
2281
  /** ISO timestamp, machine format. */
2175
2282
  readonly createdAt: v.StringSchema<undefined>;
2176
2283
  /** The item's content version the comment was written against. */
@@ -2194,20 +2301,28 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2194
2301
  */
2195
2302
  readonly deliveredCount: v.NumberSchema<undefined>;
2196
2303
  /**
2197
- * This comment's thread root — its own id for every delivered root. Resolution
2198
- * replies remain on the dashboard thread and are not delivered to agents.
2199
- * It is on the wire from the first response
2200
- * because the wire contract is consumed by installed CLI versions: reshaping
2201
- * a flat `comments` array into threads-of-comments later would be a breaking
2202
- * 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.
2203
2313
  */
2204
2314
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2205
2315
  /**
2206
- * Always `null` for a delivered root. Present so an older reader meeting a
2207
- * future response that carries real replies degrades to
2208
- * "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.
2209
2318
  */
2210
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>;
2211
2326
  }, undefined>, undefined>, v.MaxLengthAction<{
2212
2327
  id: string;
2213
2328
  state?: "open" | "resolved" | undefined;
@@ -2228,12 +2343,14 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2228
2343
  } | undefined;
2229
2344
  approved?: boolean | undefined;
2230
2345
  authorName: string | null;
2346
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
2231
2347
  createdAt: string;
2232
2348
  itemVersion: number;
2233
2349
  itemChangedSince: boolean;
2234
2350
  deliveredCount: number;
2235
2351
  threadId: string;
2236
2352
  replyToId: string | null;
2353
+ repliesWithheld?: number | undefined;
2237
2354
  }[], 20, undefined>]>, undefined>;
2238
2355
  readonly updatedAt: v.StringSchema<undefined>;
2239
2356
  /**
@@ -2271,9 +2388,10 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2271
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">]>;
2272
2389
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
2273
2390
  /**
2274
- * The branch the publishing commit was on. **The one optional member**:
2275
- * publication is not restricted by branch, so this is recorded so a subscriber
2276
- * 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.
2277
2395
  */
2278
2396
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
2279
2397
  }, undefined>, undefined>, undefined>;
@@ -2342,12 +2460,14 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2342
2460
  } | undefined;
2343
2461
  approved?: boolean | undefined;
2344
2462
  authorName: string | null;
2463
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
2345
2464
  createdAt: string;
2346
2465
  itemVersion: number;
2347
2466
  itemChangedSince: boolean;
2348
2467
  deliveredCount: number;
2349
2468
  threadId: string;
2350
2469
  replyToId: string | null;
2470
+ repliesWithheld?: number | undefined;
2351
2471
  }[] | undefined;
2352
2472
  updatedAt: string;
2353
2473
  gitSource?: {
@@ -2395,12 +2515,14 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2395
2515
  } | undefined;
2396
2516
  approved?: boolean | undefined;
2397
2517
  authorName: string | null;
2518
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
2398
2519
  createdAt: string;
2399
2520
  itemVersion: number;
2400
2521
  itemChangedSince: boolean;
2401
2522
  deliveredCount: number;
2402
2523
  threadId: string;
2403
2524
  replyToId: string | null;
2525
+ repliesWithheld?: number | undefined;
2404
2526
  }[] | undefined;
2405
2527
  updatedAt: string;
2406
2528
  gitSource?: {
@@ -2626,6 +2748,12 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
2626
2748
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2627
2749
  /** The author's display name as the workspace shows it, or null. Never an email. */
2628
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>;
2629
2757
  /** ISO timestamp, machine format. */
2630
2758
  readonly createdAt: v.StringSchema<undefined>;
2631
2759
  /** The item's content version the comment was written against. */
@@ -2649,20 +2777,28 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
2649
2777
  */
2650
2778
  readonly deliveredCount: v.NumberSchema<undefined>;
2651
2779
  /**
2652
- * This comment's thread root — its own id for every delivered root. Resolution
2653
- * replies remain on the dashboard thread and are not delivered to agents.
2654
- * It is on the wire from the first response
2655
- * because the wire contract is consumed by installed CLI versions: reshaping
2656
- * a flat `comments` array into threads-of-comments later would be a breaking
2657
- * 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.
2658
2789
  */
2659
2790
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2660
2791
  /**
2661
- * Always `null` for a delivered root. Present so an older reader meeting a
2662
- * future response that carries real replies degrades to
2663
- * "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.
2664
2794
  */
2665
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>;
2666
2802
  }, undefined>;
2667
2803
  export type ItemCommentWithSubject = v.InferOutput<typeof ItemCommentWithSubjectSchema>;
2668
2804
  /**
@@ -2721,6 +2857,12 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
2721
2857
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2722
2858
  /** The author's display name as the workspace shows it, or null. Never an email. */
2723
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>;
2724
2866
  /** ISO timestamp, machine format. */
2725
2867
  readonly createdAt: v.StringSchema<undefined>;
2726
2868
  /** The item's content version the comment was written against. */
@@ -2744,20 +2886,28 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
2744
2886
  */
2745
2887
  readonly deliveredCount: v.NumberSchema<undefined>;
2746
2888
  /**
2747
- * This comment's thread root — its own id for every delivered root. Resolution
2748
- * replies remain on the dashboard thread and are not delivered to agents.
2749
- * It is on the wire from the first response
2750
- * because the wire contract is consumed by installed CLI versions: reshaping
2751
- * a flat `comments` array into threads-of-comments later would be a breaking
2752
- * 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.
2753
2898
  */
2754
2899
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2755
2900
  /**
2756
- * Always `null` for a delivered root. Present so an older reader meeting a
2757
- * future response that carries real replies degrades to
2758
- * "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.
2759
2903
  */
2760
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>;
2761
2911
  }, undefined>, undefined>;
2762
2912
  readonly cursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2763
2913
  /**
@@ -3079,8 +3229,15 @@ export declare const ArtifactFormatSchema: v.PicklistSchema<["markdown", "html",
3079
3229
  * a create stores text `content`, and a binary artifact reads back with
3080
3230
  * `content: null`, so it could not round-trip. Creation is always
3081
3231
  * `role: 'content'`; guidance and criteria arrive through import.
3232
+ *
3233
+ * `html` is the one addition outside the table: an HTML page the dashboard
3234
+ * renders live in a sandboxed frame. It is deliberately not a row there,
3235
+ * because a row would give it an item type of its own, and a client that
3236
+ * predates that type would reject every listing carrying one. An `html`
3237
+ * artifact serializes as an ordinary `content` item and reports its format on
3238
+ * `ArtifactSchema.format`.
3082
3239
  */
3083
- export declare const CreatableArtifactFormatSchema: v.PicklistSchema<("markdown" | "binary")[], undefined>;
3240
+ export declare const CreatableArtifactFormatSchema: v.PicklistSchema<[...("markdown" | "binary")[], "html"], undefined>;
3084
3241
  /** Largest version an artifact can carry: the version column is a 32-bit integer. */
3085
3242
  export declare const MAX_ARTIFACT_VERSION = 2147483647;
3086
3243
  /**
@@ -3266,9 +3423,10 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3266
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">]>;
3267
3424
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3268
3425
  /**
3269
- * The branch the publishing commit was on. **The one optional member**:
3270
- * publication is not restricted by branch, so this is recorded so a subscriber
3271
- * 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.
3272
3430
  */
3273
3431
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3274
3432
  }, undefined>, undefined>, undefined>;
@@ -3312,6 +3470,12 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3312
3470
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3313
3471
  /** The author's display name as the workspace shows it, or null. Never an email. */
3314
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>;
3315
3479
  /** ISO timestamp, machine format. */
3316
3480
  readonly createdAt: v.StringSchema<undefined>;
3317
3481
  /** The item's content version the comment was written against. */
@@ -3335,20 +3499,28 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3335
3499
  */
3336
3500
  readonly deliveredCount: v.NumberSchema<undefined>;
3337
3501
  /**
3338
- * This comment's thread root — its own id for every delivered root. Resolution
3339
- * replies remain on the dashboard thread and are not delivered to agents.
3340
- * It is on the wire from the first response
3341
- * because the wire contract is consumed by installed CLI versions: reshaping
3342
- * a flat `comments` array into threads-of-comments later would be a breaking
3343
- * 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.
3344
3511
  */
3345
3512
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3346
3513
  /**
3347
- * Always `null` for a delivered root. Present so an older reader meeting a
3348
- * future response that carries real replies degrades to
3349
- * "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.
3350
3516
  */
3351
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>;
3352
3524
  }, undefined>, undefined>, v.MaxLengthAction<{
3353
3525
  id: string;
3354
3526
  state?: "open" | "resolved" | undefined;
@@ -3369,12 +3541,14 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3369
3541
  } | undefined;
3370
3542
  approved?: boolean | undefined;
3371
3543
  authorName: string | null;
3544
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
3372
3545
  createdAt: string;
3373
3546
  itemVersion: number;
3374
3547
  itemChangedSince: boolean;
3375
3548
  deliveredCount: number;
3376
3549
  threadId: string;
3377
3550
  replyToId: string | null;
3551
+ repliesWithheld?: number | undefined;
3378
3552
  }[], 20, undefined>]>, undefined>;
3379
3553
  readonly updatedAt: v.StringSchema<undefined>;
3380
3554
  }, undefined>;
@@ -3388,7 +3562,7 @@ export declare const CreateArtifactRequestSchema: v.StrictObjectSchema<{
3388
3562
  readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
3389
3563
  readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "content must be at most 262144 bytes">]>;
3390
3564
  /** Defaults to markdown. Creation is always `role: 'content'`. */
3391
- readonly format: v.OptionalSchema<v.PicklistSchema<("markdown" | "binary")[], undefined>, undefined>;
3565
+ readonly format: v.OptionalSchema<v.PicklistSchema<[...("markdown" | "binary")[], "html"], undefined>, undefined>;
3392
3566
  /** Destination bundle slug. */
3393
3567
  readonly bundle: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "slug must be lowercase alphanumeric with hyphens, at most 64 characters">]>, undefined>;
3394
3568
  readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
@@ -3452,9 +3626,10 @@ export declare const CreateArtifactRequestSchema: v.StrictObjectSchema<{
3452
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">]>;
3453
3627
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3454
3628
  /**
3455
- * The branch the publishing commit was on. **The one optional member**:
3456
- * publication is not restricted by branch, so this is recorded so a subscriber
3457
- * 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.
3458
3633
  */
3459
3634
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3460
3635
  }, undefined>, undefined>;
@@ -3529,9 +3704,10 @@ export declare const UpdateArtifactRequestSchema: v.StrictObjectSchema<{
3529
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">]>;
3530
3705
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3531
3706
  /**
3532
- * The branch the publishing commit was on. **The one optional member**:
3533
- * publication is not restricted by branch, so this is recorded so a subscriber
3534
- * 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.
3535
3711
  */
3536
3712
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3537
3713
  }, undefined>, undefined>;
@@ -3556,9 +3732,10 @@ export declare const RemoveArtifactRequestSchema: v.StrictObjectSchema<{
3556
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">]>;
3557
3733
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3558
3734
  /**
3559
- * The branch the publishing commit was on. **The one optional member**:
3560
- * publication is not restricted by branch, so this is recorded so a subscriber
3561
- * 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.
3562
3739
  */
3563
3740
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3564
3741
  }, undefined>;
@@ -3645,9 +3822,10 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
3645
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">]>;
3646
3823
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3647
3824
  /**
3648
- * The branch the publishing commit was on. **The one optional member**:
3649
- * publication is not restricted by branch, so this is recorded so a subscriber
3650
- * 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.
3651
3829
  */
3652
3830
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3653
3831
  }, undefined>, undefined>, undefined>;
@@ -3691,6 +3869,12 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
3691
3869
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3692
3870
  /** The author's display name as the workspace shows it, or null. Never an email. */
3693
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>;
3694
3878
  /** ISO timestamp, machine format. */
3695
3879
  readonly createdAt: v.StringSchema<undefined>;
3696
3880
  /** The item's content version the comment was written against. */
@@ -3714,20 +3898,28 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
3714
3898
  */
3715
3899
  readonly deliveredCount: v.NumberSchema<undefined>;
3716
3900
  /**
3717
- * This comment's thread root — its own id for every delivered root. Resolution
3718
- * replies remain on the dashboard thread and are not delivered to agents.
3719
- * It is on the wire from the first response
3720
- * because the wire contract is consumed by installed CLI versions: reshaping
3721
- * a flat `comments` array into threads-of-comments later would be a breaking
3722
- * 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.
3723
3910
  */
3724
3911
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3725
3912
  /**
3726
- * Always `null` for a delivered root. Present so an older reader meeting a
3727
- * future response that carries real replies degrades to
3728
- * "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.
3729
3915
  */
3730
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>;
3731
3923
  }, undefined>, undefined>, v.MaxLengthAction<{
3732
3924
  id: string;
3733
3925
  state?: "open" | "resolved" | undefined;
@@ -3748,12 +3940,14 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
3748
3940
  } | undefined;
3749
3941
  approved?: boolean | undefined;
3750
3942
  authorName: string | null;
3943
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
3751
3944
  createdAt: string;
3752
3945
  itemVersion: number;
3753
3946
  itemChangedSince: boolean;
3754
3947
  deliveredCount: number;
3755
3948
  threadId: string;
3756
3949
  replyToId: string | null;
3950
+ repliesWithheld?: number | undefined;
3757
3951
  }[], 20, undefined>]>, undefined>;
3758
3952
  readonly updatedAt: v.StringSchema<undefined>;
3759
3953
  }, undefined>;
@@ -3808,9 +4002,10 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
3808
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">]>;
3809
4003
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3810
4004
  /**
3811
- * The branch the publishing commit was on. **The one optional member**:
3812
- * publication is not restricted by branch, so this is recorded so a subscriber
3813
- * 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.
3814
4009
  */
3815
4010
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3816
4011
  }, undefined>, undefined>, undefined>;
@@ -3854,6 +4049,12 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
3854
4049
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3855
4050
  /** The author's display name as the workspace shows it, or null. Never an email. */
3856
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>;
3857
4058
  /** ISO timestamp, machine format. */
3858
4059
  readonly createdAt: v.StringSchema<undefined>;
3859
4060
  /** The item's content version the comment was written against. */
@@ -3877,20 +4078,28 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
3877
4078
  */
3878
4079
  readonly deliveredCount: v.NumberSchema<undefined>;
3879
4080
  /**
3880
- * This comment's thread root — its own id for every delivered root. Resolution
3881
- * replies remain on the dashboard thread and are not delivered to agents.
3882
- * It is on the wire from the first response
3883
- * because the wire contract is consumed by installed CLI versions: reshaping
3884
- * a flat `comments` array into threads-of-comments later would be a breaking
3885
- * 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.
3886
4090
  */
3887
4091
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3888
4092
  /**
3889
- * Always `null` for a delivered root. Present so an older reader meeting a
3890
- * future response that carries real replies degrades to
3891
- * "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.
3892
4095
  */
3893
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>;
3894
4103
  }, undefined>, undefined>, v.MaxLengthAction<{
3895
4104
  id: string;
3896
4105
  state?: "open" | "resolved" | undefined;
@@ -3911,12 +4120,14 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
3911
4120
  } | undefined;
3912
4121
  approved?: boolean | undefined;
3913
4122
  authorName: string | null;
4123
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
3914
4124
  createdAt: string;
3915
4125
  itemVersion: number;
3916
4126
  itemChangedSince: boolean;
3917
4127
  deliveredCount: number;
3918
4128
  threadId: string;
3919
4129
  replyToId: string | null;
4130
+ repliesWithheld?: number | undefined;
3920
4131
  }[], 20, undefined>]>, undefined>;
3921
4132
  readonly updatedAt: v.StringSchema<undefined>;
3922
4133
  }, undefined>;
@@ -3958,9 +4169,10 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
3958
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">]>;
3959
4170
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
3960
4171
  /**
3961
- * The branch the publishing commit was on. **The one optional member**:
3962
- * publication is not restricted by branch, so this is recorded so a subscriber
3963
- * 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.
3964
4176
  */
3965
4177
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
3966
4178
  }, undefined>, undefined>, undefined>;
@@ -4004,6 +4216,12 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
4004
4216
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4005
4217
  /** The author's display name as the workspace shows it, or null. Never an email. */
4006
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>;
4007
4225
  /** ISO timestamp, machine format. */
4008
4226
  readonly createdAt: v.StringSchema<undefined>;
4009
4227
  /** The item's content version the comment was written against. */
@@ -4027,20 +4245,28 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
4027
4245
  */
4028
4246
  readonly deliveredCount: v.NumberSchema<undefined>;
4029
4247
  /**
4030
- * This comment's thread root — its own id for every delivered root. Resolution
4031
- * replies remain on the dashboard thread and are not delivered to agents.
4032
- * It is on the wire from the first response
4033
- * because the wire contract is consumed by installed CLI versions: reshaping
4034
- * a flat `comments` array into threads-of-comments later would be a breaking
4035
- * 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.
4036
4257
  */
4037
4258
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4038
4259
  /**
4039
- * Always `null` for a delivered root. Present so an older reader meeting a
4040
- * future response that carries real replies degrades to
4041
- * "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.
4042
4262
  */
4043
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>;
4044
4270
  }, undefined>, undefined>, v.MaxLengthAction<{
4045
4271
  id: string;
4046
4272
  state?: "open" | "resolved" | undefined;
@@ -4061,12 +4287,14 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
4061
4287
  } | undefined;
4062
4288
  approved?: boolean | undefined;
4063
4289
  authorName: string | null;
4290
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
4064
4291
  createdAt: string;
4065
4292
  itemVersion: number;
4066
4293
  itemChangedSince: boolean;
4067
4294
  deliveredCount: number;
4068
4295
  threadId: string;
4069
4296
  replyToId: string | null;
4297
+ repliesWithheld?: number | undefined;
4070
4298
  }[], 20, undefined>]>, undefined>;
4071
4299
  readonly updatedAt: v.StringSchema<undefined>;
4072
4300
  }, undefined>;
@@ -4109,9 +4337,10 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
4109
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">]>;
4110
4338
  readonly commitSha: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "commitSha must be 40 or 64 lowercase hex characters">]>;
4111
4339
  /**
4112
- * The branch the publishing commit was on. **The one optional member**:
4113
- * publication is not restricted by branch, so this is recorded so a subscriber
4114
- * 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.
4115
4344
  */
4116
4345
  readonly branch: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 255, undefined>]>, undefined>;
4117
4346
  }, undefined>, undefined>, undefined>;
@@ -4155,6 +4384,12 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
4155
4384
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4156
4385
  /** The author's display name as the workspace shows it, or null. Never an email. */
4157
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>;
4158
4393
  /** ISO timestamp, machine format. */
4159
4394
  readonly createdAt: v.StringSchema<undefined>;
4160
4395
  /** The item's content version the comment was written against. */
@@ -4178,20 +4413,28 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
4178
4413
  */
4179
4414
  readonly deliveredCount: v.NumberSchema<undefined>;
4180
4415
  /**
4181
- * This comment's thread root — its own id for every delivered root. Resolution
4182
- * replies remain on the dashboard thread and are not delivered to agents.
4183
- * It is on the wire from the first response
4184
- * because the wire contract is consumed by installed CLI versions: reshaping
4185
- * a flat `comments` array into threads-of-comments later would be a breaking
4186
- * 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.
4187
4425
  */
4188
4426
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4189
4427
  /**
4190
- * Always `null` for a delivered root. Present so an older reader meeting a
4191
- * future response that carries real replies degrades to
4192
- * "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.
4193
4430
  */
4194
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>;
4195
4438
  }, undefined>, undefined>, v.MaxLengthAction<{
4196
4439
  id: string;
4197
4440
  state?: "open" | "resolved" | undefined;
@@ -4212,12 +4455,14 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
4212
4455
  } | undefined;
4213
4456
  approved?: boolean | undefined;
4214
4457
  authorName: string | null;
4458
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
4215
4459
  createdAt: string;
4216
4460
  itemVersion: number;
4217
4461
  itemChangedSince: boolean;
4218
4462
  deliveredCount: number;
4219
4463
  threadId: string;
4220
4464
  replyToId: string | null;
4465
+ repliesWithheld?: number | undefined;
4221
4466
  }[], 20, undefined>]>, undefined>;
4222
4467
  readonly updatedAt: v.StringSchema<undefined>;
4223
4468
  }, undefined>;
@@ -4519,22 +4764,56 @@ export type ActionNarration = v.InferOutput<typeof ActionNarrationSchema>;
4519
4764
  export declare const TokenUsageSchema: v.ObjectSchema<{
4520
4765
  readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4521
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>;
4522
4768
  readonly inputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4523
4769
  readonly outputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4524
4770
  readonly cacheReadTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4525
4771
  readonly cacheWriteTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4526
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;
4527
4789
  export declare const DashboardSessionUsageSchema: v.ObjectSchema<{
4528
4790
  readonly sessionId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
4529
4791
  readonly agentSessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4530
- readonly usage: v.ArraySchema<v.ObjectSchema<{
4792
+ readonly usage: v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4531
4793
  readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4532
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>;
4533
4796
  readonly inputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4534
4797
  readonly outputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4535
4798
  readonly cacheReadTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4536
4799
  readonly cacheWriteTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4537
- }, 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">]>;
4538
4817
  }, undefined>;
4539
4818
  export declare const SkillUsageEntrySchema: v.ObjectSchema<{
4540
4819
  readonly skillName: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -4937,20 +5216,38 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
4937
5216
  readonly runUsage: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4938
5217
  readonly sessionId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
4939
5218
  readonly agentSessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4940
- readonly usage: v.ArraySchema<v.ObjectSchema<{
5219
+ readonly usage: v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4941
5220
  readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4942
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>;
4943
5223
  readonly inputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4944
5224
  readonly outputTokens: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4945
5225
  readonly cacheReadTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4946
5226
  readonly cacheWriteTokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
4947
- }, 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">]>;
4948
5244
  }, undefined>, undefined>, v.MaxLengthAction<{
4949
5245
  sessionId?: string | undefined;
4950
5246
  agentSessionId: string;
4951
5247
  usage: {
4952
5248
  model: string;
4953
5249
  provider?: string | undefined;
5250
+ occurredAt?: number | undefined;
4954
5251
  inputTokens: number;
4955
5252
  outputTokens: number;
4956
5253
  cacheReadTokens?: number | undefined;
@@ -5918,6 +6215,12 @@ export declare const ArtifactFeedbackResponseSchema: v.ObjectSchema<{
5918
6215
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
5919
6216
  /** The author's display name as the workspace shows it, or null. Never an email. */
5920
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>;
5921
6224
  /** ISO timestamp, machine format. */
5922
6225
  readonly createdAt: v.StringSchema<undefined>;
5923
6226
  /** The item's content version the comment was written against. */
@@ -5941,20 +6244,28 @@ export declare const ArtifactFeedbackResponseSchema: v.ObjectSchema<{
5941
6244
  */
5942
6245
  readonly deliveredCount: v.NumberSchema<undefined>;
5943
6246
  /**
5944
- * This comment's thread root — its own id for every delivered root. Resolution
5945
- * replies remain on the dashboard thread and are not delivered to agents.
5946
- * It is on the wire from the first response
5947
- * because the wire contract is consumed by installed CLI versions: reshaping
5948
- * a flat `comments` array into threads-of-comments later would be a breaking
5949
- * 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.
5950
6256
  */
5951
6257
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5952
6258
  /**
5953
- * Always `null` for a delivered root. Present so an older reader meeting a
5954
- * future response that carries real replies degrades to
5955
- * "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.
5956
6261
  */
5957
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>;
5958
6269
  }, undefined>, undefined>;
5959
6270
  /** Absent on the last page; pass it back as `cursor` for the next. */
5960
6271
  readonly nextCursor: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -6176,7 +6487,8 @@ export type SessionGradeRequest = v.InferOutput<typeof SessionGradeRequestSchema
6176
6487
  *
6177
6488
  * - `pending` — no grade yet, and the grading sweep can still pick the run
6178
6489
  * up (it is open, or closed inside the grading window). "Not graded yet"
6179
- * 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.
6180
6492
  * - `graded` — a grader judged it; `grade` carries what it said.
6181
6493
  * - `nothing_to_grade` — a grader ran and found nothing to judge: no
6182
6494
  * gradeable actions, or no guides in the agent's context. The record
@@ -6255,6 +6567,7 @@ export declare const SessionGradeResponseSchema: v.ObjectSchema<{
6255
6567
  readonly status: v.PicklistSchema<["open", "closed"], undefined>;
6256
6568
  }, undefined>;
6257
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>;
6258
6571
  /** Present exactly when `state` is `graded`. */
6259
6572
  readonly grade: v.NullableSchema<v.ObjectSchema<{
6260
6573
  /** The grader's one-paragraph judgment of the run, wrapped like `reasoning`; null when the record carries none. */
@@ -6347,6 +6660,7 @@ export declare const SessionDigestResponseSchema: v.ObjectSchema<{
6347
6660
  readonly status: v.PicklistSchema<["open", "closed"], undefined>;
6348
6661
  }, undefined>;
6349
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>;
6350
6664
  readonly grade: v.NullableSchema<v.ObjectSchema<{
6351
6665
  /** The grader's one-paragraph judgment of the run, wrapped like `reasoning`; null when the record carries none. */
6352
6666
  readonly summary: v.NullableSchema<v.StringSchema<undefined>, undefined>;
@@ -6480,8 +6794,8 @@ export declare const SearchFrontmatterSchema: v.SchemaWithPipe<readonly [v.Recor
6480
6794
  }, "frontmatter takes between 1 and 3 fields">]>;
6481
6795
  export type SearchFrontmatter = v.InferOutput<typeof SearchFrontmatterSchema>;
6482
6796
  /** Who wrote a comment: a person, an agent, or Mossbear itself. */
6483
- export declare const SEARCH_COMMENT_AUTHOR_KINDS: readonly ["person", "agent", "mossbear"];
6484
- 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>;
6485
6799
  export type SearchCommentAuthorKind = v.InferOutput<typeof SearchCommentAuthorKindSchema>;
6486
6800
  /**
6487
6801
  * What a comment is attached to. `artifact` is a guide or a document; `session`
@@ -6545,7 +6859,7 @@ export declare const SearchRequestObjectSchema: v.ObjectSchema<{
6545
6859
  * Restrict the `comments` corpus to comments written by these kinds of
6546
6860
  * author. Does not touch other corpora.
6547
6861
  */
6548
- 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>;
6549
6863
  /**
6550
6864
  * Restrict the `comments` corpus to comments on these kinds of subject. Does
6551
6865
  * not touch other corpora.
@@ -6615,7 +6929,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6615
6929
  * Restrict the `comments` corpus to comments written by these kinds of
6616
6930
  * author. Does not touch other corpora.
6617
6931
  */
6618
- 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>;
6619
6933
  /**
6620
6934
  * Restrict the `comments` corpus to comments on these kinds of subject. Does
6621
6935
  * not touch other corpora.
@@ -6654,7 +6968,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6654
6968
  frontmatter?: {
6655
6969
  [x: string]: string;
6656
6970
  } | undefined;
6657
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
6971
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6658
6972
  subjectKinds?: ("artifact" | "session")[] | undefined;
6659
6973
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6660
6974
  headSha?: string | undefined;
@@ -6671,7 +6985,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6671
6985
  frontmatter?: {
6672
6986
  [x: string]: string;
6673
6987
  } | undefined;
6674
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
6988
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6675
6989
  subjectKinds?: ("artifact" | "session")[] | undefined;
6676
6990
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6677
6991
  headSha?: string | undefined;
@@ -6688,7 +7002,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6688
7002
  frontmatter?: {
6689
7003
  [x: string]: string;
6690
7004
  } | undefined;
6691
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
7005
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6692
7006
  subjectKinds?: ("artifact" | "session")[] | undefined;
6693
7007
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6694
7008
  headSha?: string | undefined;
@@ -6705,7 +7019,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6705
7019
  frontmatter?: {
6706
7020
  [x: string]: string;
6707
7021
  } | undefined;
6708
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
7022
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6709
7023
  subjectKinds?: ("artifact" | "session")[] | undefined;
6710
7024
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6711
7025
  headSha?: string | undefined;
@@ -6722,7 +7036,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6722
7036
  frontmatter?: {
6723
7037
  [x: string]: string;
6724
7038
  } | undefined;
6725
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
7039
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6726
7040
  subjectKinds?: ("artifact" | "session")[] | undefined;
6727
7041
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6728
7042
  headSha?: string | undefined;
@@ -6739,7 +7053,7 @@ export declare const SearchRequestSchema: v.SchemaWithPipe<readonly [v.ObjectSch
6739
7053
  frontmatter?: {
6740
7054
  [x: string]: string;
6741
7055
  } | undefined;
6742
- authorKinds?: ("agent" | "person" | "mossbear")[] | undefined;
7056
+ authorKinds?: ("person" | "agent" | "mossbear")[] | undefined;
6743
7057
  subjectKinds?: ("artifact" | "session")[] | undefined;
6744
7058
  steeringLabels?: ("correction" | "steering" | "new request" | "acknowledgement" | "insufficient evidence")[] | undefined;
6745
7059
  headSha?: string | undefined;
@@ -6864,7 +7178,7 @@ export declare const SearchArtifactCommentHitSchema: v.ObjectSchema<{
6864
7178
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6865
7179
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6866
7180
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6867
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7181
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
6868
7182
  readonly resolved: v.BooleanSchema<undefined>;
6869
7183
  readonly createdAt: v.StringSchema<undefined>;
6870
7184
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -6881,7 +7195,7 @@ export declare const SearchSessionCommentHitSchema: v.ObjectSchema<{
6881
7195
  readonly matchedIn: v.LiteralSchema<"body", undefined>;
6882
7196
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6883
7197
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6884
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7198
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
6885
7199
  readonly resolved: v.BooleanSchema<undefined>;
6886
7200
  readonly createdAt: v.StringSchema<undefined>;
6887
7201
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -6917,7 +7231,7 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
6917
7231
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6918
7232
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6919
7233
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6920
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7234
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
6921
7235
  readonly resolved: v.BooleanSchema<undefined>;
6922
7236
  readonly createdAt: v.StringSchema<undefined>;
6923
7237
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -6928,7 +7242,7 @@ export declare const SearchCommentHitSchema: v.VariantSchema<"subjectKind", [v.O
6928
7242
  readonly matchedIn: v.LiteralSchema<"body", undefined>;
6929
7243
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6930
7244
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6931
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7245
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
6932
7246
  readonly resolved: v.BooleanSchema<undefined>;
6933
7247
  readonly createdAt: v.StringSchema<undefined>;
6934
7248
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -7135,7 +7449,7 @@ export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.Ob
7135
7449
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7136
7450
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7137
7451
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7138
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7452
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
7139
7453
  readonly resolved: v.BooleanSchema<undefined>;
7140
7454
  readonly createdAt: v.StringSchema<undefined>;
7141
7455
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -7146,7 +7460,7 @@ export declare const SearchCommentsReportSchema: v.VariantSchema<"status", [v.Ob
7146
7460
  readonly matchedIn: v.LiteralSchema<"body", undefined>;
7147
7461
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7148
7462
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7149
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7463
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
7150
7464
  readonly resolved: v.BooleanSchema<undefined>;
7151
7465
  readonly createdAt: v.StringSchema<undefined>;
7152
7466
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -7379,7 +7693,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
7379
7693
  readonly approved: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7380
7694
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7381
7695
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7382
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7696
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
7383
7697
  readonly resolved: v.BooleanSchema<undefined>;
7384
7698
  readonly createdAt: v.StringSchema<undefined>;
7385
7699
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -7390,7 +7704,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
7390
7704
  readonly matchedIn: v.LiteralSchema<"body", undefined>;
7391
7705
  readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7392
7706
  readonly threadId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7393
- readonly authorKind: v.PicklistSchema<readonly ["person", "agent", "mossbear"], undefined>;
7707
+ readonly authorKind: v.PicklistSchema<["person", "agent", "mossbear"], undefined>;
7394
7708
  readonly resolved: v.BooleanSchema<undefined>;
7395
7709
  readonly createdAt: v.StringSchema<undefined>;
7396
7710
  readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -7611,6 +7925,7 @@ export declare function parseResolveSubscriptionsResponse(data: unknown): {
7611
7925
  export declare function parseUpdateBundleRequest(data: unknown): {
7612
7926
  name?: string | undefined;
7613
7927
  home?: string | null | undefined;
7928
+ columns?: string[] | null | undefined;
7614
7929
  };
7615
7930
  export declare function parseUpdateBundleResponse(data: unknown): {
7616
7931
  bundle: {
@@ -7664,12 +7979,14 @@ export declare function parseContextItemsResponse(data: unknown): {
7664
7979
  } | undefined;
7665
7980
  approved?: boolean | undefined;
7666
7981
  authorName: string | null;
7982
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
7667
7983
  createdAt: string;
7668
7984
  itemVersion: number;
7669
7985
  itemChangedSince: boolean;
7670
7986
  deliveredCount: number;
7671
7987
  threadId: string;
7672
7988
  replyToId: string | null;
7989
+ repliesWithheld?: number | undefined;
7673
7990
  }[] | undefined;
7674
7991
  updatedAt: string;
7675
7992
  gitSource?: {
@@ -7726,12 +8043,14 @@ export declare function parseBundleArtifactsResponse(data: unknown): {
7726
8043
  } | undefined;
7727
8044
  approved?: boolean | undefined;
7728
8045
  authorName: string | null;
8046
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
7729
8047
  createdAt: string;
7730
8048
  itemVersion: number;
7731
8049
  itemChangedSince: boolean;
7732
8050
  deliveredCount: number;
7733
8051
  threadId: string;
7734
8052
  replyToId: string | null;
8053
+ repliesWithheld?: number | undefined;
7735
8054
  }[] | undefined;
7736
8055
  updatedAt: string;
7737
8056
  gitSource?: {
@@ -7842,6 +8161,7 @@ export declare function parseDashboardSyncRequest(data: unknown): {
7842
8161
  usage: {
7843
8162
  model: string;
7844
8163
  provider?: string | undefined;
8164
+ occurredAt?: number | undefined;
7845
8165
  inputTokens: number;
7846
8166
  outputTokens: number;
7847
8167
  cacheReadTokens?: number | undefined;
@@ -8069,12 +8389,14 @@ export declare function parseItemCommentsResponse(data: unknown): {
8069
8389
  } | undefined;
8070
8390
  approved?: boolean | undefined;
8071
8391
  authorName: string | null;
8392
+ authorKind?: "person" | "agent" | "mossbear" | undefined;
8072
8393
  createdAt: string;
8073
8394
  itemVersion: number;
8074
8395
  itemChangedSince: boolean;
8075
8396
  deliveredCount: number;
8076
8397
  threadId: string;
8077
8398
  replyToId: string | null;
8399
+ repliesWithheld?: number | undefined;
8078
8400
  }[];
8079
8401
  cursor?: string | undefined;
8080
8402
  untrusted?: {
@@ -8153,6 +8475,7 @@ export declare function parseSessionGradeResponse(data: unknown): {
8153
8475
  status: "open" | "closed";
8154
8476
  };
8155
8477
  state: "pending" | "graded" | "nothing_to_grade" | "expired" | "grading_off";
8478
+ gradeFailedAttempts?: number | undefined;
8156
8479
  grade: {
8157
8480
  summary: string | null;
8158
8481
  gradedAt: string;
@@ -8181,6 +8504,7 @@ export declare function parseSessionDigestResponse(data: unknown): {
8181
8504
  status: "open" | "closed";
8182
8505
  };
8183
8506
  state: "pending" | "graded" | "nothing_to_grade" | "expired" | "grading_off";
8507
+ gradeFailedAttempts?: number | undefined;
8184
8508
  grade: {
8185
8509
  summary: string | null;
8186
8510
  gradedAt: string;
@@ -8286,7 +8610,7 @@ export declare function parseSearchResponse(data: unknown): {
8286
8610
  approved?: boolean | undefined;
8287
8611
  commentId: string;
8288
8612
  threadId: string;
8289
- authorKind: "agent" | "person" | "mossbear";
8613
+ authorKind: "person" | "agent" | "mossbear";
8290
8614
  resolved: boolean;
8291
8615
  createdAt: string;
8292
8616
  url?: string | undefined;
@@ -8297,7 +8621,7 @@ export declare function parseSearchResponse(data: unknown): {
8297
8621
  matchedIn: "body";
8298
8622
  commentId: string;
8299
8623
  threadId: string;
8300
- authorKind: "agent" | "person" | "mossbear";
8624
+ authorKind: "person" | "agent" | "mossbear";
8301
8625
  resolved: boolean;
8302
8626
  createdAt: string;
8303
8627
  url?: string | undefined;