@mossbear/protocol 0.1.0-alpha.94 → 0.1.0-alpha.96

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
@@ -1216,6 +1216,19 @@ export declare const ArtifactCommentSchema: v.ObjectSchema<{
1216
1216
  * that the server handed it over.
1217
1217
  */
1218
1218
  readonly deliveredCount: v.NumberSchema<undefined>;
1219
+ /**
1220
+ * On a root: true when the item changed after an earlier read was last
1221
+ * handed this comment. For a guide that is any change to its body or its
1222
+ * files, so a fix in a supporting file counts. A reader should check whether
1223
+ * the change addressed the comment, and resolve it with a note if so.
1224
+ *
1225
+ * Computed before this read is counted, so the read that carries `true` is
1226
+ * the one that uses it up; the next read says `false` unless the item
1227
+ * changes again. A comment never handed over before is never flagged.
1228
+ * Optional because a server that predates the field omits it, and absent on
1229
+ * a reply.
1230
+ */
1231
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1219
1232
  /**
1220
1233
  * This comment's thread root: its own id on a root, the root's id on a reply.
1221
1234
  *
@@ -1309,6 +1322,19 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
1309
1322
  * that the server handed it over.
1310
1323
  */
1311
1324
  readonly deliveredCount: v.NumberSchema<undefined>;
1325
+ /**
1326
+ * On a root: true when the item changed after an earlier read was last
1327
+ * handed this comment. For a guide that is any change to its body or its
1328
+ * files, so a fix in a supporting file counts. A reader should check whether
1329
+ * the change addressed the comment, and resolve it with a note if so.
1330
+ *
1331
+ * Computed before this read is counted, so the read that carries `true` is
1332
+ * the one that uses it up; the next read says `false` unless the item
1333
+ * changes again. A comment never handed over before is never flagged.
1334
+ * Optional because a server that predates the field omits it, and absent on
1335
+ * a reply.
1336
+ */
1337
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1312
1338
  /**
1313
1339
  * This comment's thread root: its own id on a root, the root's id on a reply.
1314
1340
  *
@@ -1540,6 +1566,19 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1540
1566
  * that the server handed it over.
1541
1567
  */
1542
1568
  readonly deliveredCount: v.NumberSchema<undefined>;
1569
+ /**
1570
+ * On a root: true when the item changed after an earlier read was last
1571
+ * handed this comment. For a guide that is any change to its body or its
1572
+ * files, so a fix in a supporting file counts. A reader should check whether
1573
+ * the change addressed the comment, and resolve it with a note if so.
1574
+ *
1575
+ * Computed before this read is counted, so the read that carries `true` is
1576
+ * the one that uses it up; the next read says `false` unless the item
1577
+ * changes again. A comment never handed over before is never flagged.
1578
+ * Optional because a server that predates the field omits it, and absent on
1579
+ * a reply.
1580
+ */
1581
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1543
1582
  /**
1544
1583
  * This comment's thread root: its own id on a root, the root's id on a reply.
1545
1584
  *
@@ -1588,6 +1627,7 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1588
1627
  itemVersion: number;
1589
1628
  itemChangedSince: boolean;
1590
1629
  deliveredCount: number;
1630
+ guideChangedSinceRead?: boolean | undefined;
1591
1631
  threadId: string;
1592
1632
  replyToId: string | null;
1593
1633
  repliesWithheld?: number | undefined;
@@ -1661,6 +1701,22 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1661
1701
  * than a tombstone that says no.
1662
1702
  */
1663
1703
  readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
1704
+ /**
1705
+ * This guide is switched off. Served only to a read that asked for the
1706
+ * bundle's inventory (`inactive=include`), which the publishers make so a
1707
+ * switched-off guide is updated in place rather than created again. Every
1708
+ * other read omits switched-off guides, so a reader that ignores this key is
1709
+ * never handed one.
1710
+ */
1711
+ readonly inactive: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
1712
+ /**
1713
+ * Beside `inactive` only: publication switched this guide off because the
1714
+ * published branch deleted its file, so publishing that file again switches
1715
+ * it back on. A switched-off guide without it was switched off by a person,
1716
+ * and publication leaves it off — re-sending its unchanged bytes would be a
1717
+ * write with nothing to do.
1718
+ */
1719
+ readonly retiredByPublication: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
1664
1720
  }, undefined>, v.TransformAction<{
1665
1721
  id: string;
1666
1722
  artifactId?: string | null | undefined;
@@ -1705,6 +1761,7 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1705
1761
  itemVersion: number;
1706
1762
  itemChangedSince: boolean;
1707
1763
  deliveredCount: number;
1764
+ guideChangedSinceRead?: boolean | undefined;
1708
1765
  threadId: string;
1709
1766
  replyToId: string | null;
1710
1767
  repliesWithheld?: number | undefined;
@@ -1716,6 +1773,8 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1716
1773
  branch?: string | undefined;
1717
1774
  } | null | undefined;
1718
1775
  removed?: true | undefined;
1776
+ inactive?: true | undefined;
1777
+ retiredByPublication?: true | undefined;
1719
1778
  }, {
1720
1779
  type: string;
1721
1780
  id: string;
@@ -1760,6 +1819,7 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1760
1819
  itemVersion: number;
1761
1820
  itemChangedSince: boolean;
1762
1821
  deliveredCount: number;
1822
+ guideChangedSinceRead?: boolean | undefined;
1763
1823
  threadId: string;
1764
1824
  replyToId: string | null;
1765
1825
  repliesWithheld?: number | undefined;
@@ -1771,6 +1831,8 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1771
1831
  branch?: string | undefined;
1772
1832
  } | null | undefined;
1773
1833
  removed?: true | undefined;
1834
+ inactive?: true | undefined;
1835
+ retiredByPublication?: true | undefined;
1774
1836
  }>]>;
1775
1837
  export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1776
1838
  readonly items: v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
@@ -1927,6 +1989,19 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1927
1989
  * that the server handed it over.
1928
1990
  */
1929
1991
  readonly deliveredCount: v.NumberSchema<undefined>;
1992
+ /**
1993
+ * On a root: true when the item changed after an earlier read was last
1994
+ * handed this comment. For a guide that is any change to its body or its
1995
+ * files, so a fix in a supporting file counts. A reader should check whether
1996
+ * the change addressed the comment, and resolve it with a note if so.
1997
+ *
1998
+ * Computed before this read is counted, so the read that carries `true` is
1999
+ * the one that uses it up; the next read says `false` unless the item
2000
+ * changes again. A comment never handed over before is never flagged.
2001
+ * Optional because a server that predates the field omits it, and absent on
2002
+ * a reply.
2003
+ */
2004
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1930
2005
  /**
1931
2006
  * This comment's thread root: its own id on a root, the root's id on a reply.
1932
2007
  *
@@ -1975,6 +2050,7 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1975
2050
  itemVersion: number;
1976
2051
  itemChangedSince: boolean;
1977
2052
  deliveredCount: number;
2053
+ guideChangedSinceRead?: boolean | undefined;
1978
2054
  threadId: string;
1979
2055
  replyToId: string | null;
1980
2056
  repliesWithheld?: number | undefined;
@@ -2048,6 +2124,22 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2048
2124
  * than a tombstone that says no.
2049
2125
  */
2050
2126
  readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
2127
+ /**
2128
+ * This guide is switched off. Served only to a read that asked for the
2129
+ * bundle's inventory (`inactive=include`), which the publishers make so a
2130
+ * switched-off guide is updated in place rather than created again. Every
2131
+ * other read omits switched-off guides, so a reader that ignores this key is
2132
+ * never handed one.
2133
+ */
2134
+ readonly inactive: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
2135
+ /**
2136
+ * Beside `inactive` only: publication switched this guide off because the
2137
+ * published branch deleted its file, so publishing that file again switches
2138
+ * it back on. A switched-off guide without it was switched off by a person,
2139
+ * and publication leaves it off — re-sending its unchanged bytes would be a
2140
+ * write with nothing to do.
2141
+ */
2142
+ readonly retiredByPublication: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
2051
2143
  }, undefined>, v.TransformAction<{
2052
2144
  id: string;
2053
2145
  artifactId?: string | null | undefined;
@@ -2092,6 +2184,7 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2092
2184
  itemVersion: number;
2093
2185
  itemChangedSince: boolean;
2094
2186
  deliveredCount: number;
2187
+ guideChangedSinceRead?: boolean | undefined;
2095
2188
  threadId: string;
2096
2189
  replyToId: string | null;
2097
2190
  repliesWithheld?: number | undefined;
@@ -2103,6 +2196,8 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2103
2196
  branch?: string | undefined;
2104
2197
  } | null | undefined;
2105
2198
  removed?: true | undefined;
2199
+ inactive?: true | undefined;
2200
+ retiredByPublication?: true | undefined;
2106
2201
  }, {
2107
2202
  type: string;
2108
2203
  id: string;
@@ -2147,6 +2242,7 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2147
2242
  itemVersion: number;
2148
2243
  itemChangedSince: boolean;
2149
2244
  deliveredCount: number;
2245
+ guideChangedSinceRead?: boolean | undefined;
2150
2246
  threadId: string;
2151
2247
  replyToId: string | null;
2152
2248
  repliesWithheld?: number | undefined;
@@ -2158,6 +2254,8 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2158
2254
  branch?: string | undefined;
2159
2255
  } | null | undefined;
2160
2256
  removed?: true | undefined;
2257
+ inactive?: true | undefined;
2258
+ retiredByPublication?: true | undefined;
2161
2259
  }>]>, undefined>;
2162
2260
  /**
2163
2261
  * The markers every comment `body` in this response is wrapped in, plus a
@@ -2330,6 +2428,19 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2330
2428
  * that the server handed it over.
2331
2429
  */
2332
2430
  readonly deliveredCount: v.NumberSchema<undefined>;
2431
+ /**
2432
+ * On a root: true when the item changed after an earlier read was last
2433
+ * handed this comment. For a guide that is any change to its body or its
2434
+ * files, so a fix in a supporting file counts. A reader should check whether
2435
+ * the change addressed the comment, and resolve it with a note if so.
2436
+ *
2437
+ * Computed before this read is counted, so the read that carries `true` is
2438
+ * the one that uses it up; the next read says `false` unless the item
2439
+ * changes again. A comment never handed over before is never flagged.
2440
+ * Optional because a server that predates the field omits it, and absent on
2441
+ * a reply.
2442
+ */
2443
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2333
2444
  /**
2334
2445
  * This comment's thread root: its own id on a root, the root's id on a reply.
2335
2446
  *
@@ -2378,6 +2489,7 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2378
2489
  itemVersion: number;
2379
2490
  itemChangedSince: boolean;
2380
2491
  deliveredCount: number;
2492
+ guideChangedSinceRead?: boolean | undefined;
2381
2493
  threadId: string;
2382
2494
  replyToId: string | null;
2383
2495
  repliesWithheld?: number | undefined;
@@ -2451,6 +2563,22 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2451
2563
  * than a tombstone that says no.
2452
2564
  */
2453
2565
  readonly removed: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
2566
+ /**
2567
+ * This guide is switched off. Served only to a read that asked for the
2568
+ * bundle's inventory (`inactive=include`), which the publishers make so a
2569
+ * switched-off guide is updated in place rather than created again. Every
2570
+ * other read omits switched-off guides, so a reader that ignores this key is
2571
+ * never handed one.
2572
+ */
2573
+ readonly inactive: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
2574
+ /**
2575
+ * Beside `inactive` only: publication switched this guide off because the
2576
+ * published branch deleted its file, so publishing that file again switches
2577
+ * it back on. A switched-off guide without it was switched off by a person,
2578
+ * and publication leaves it off — re-sending its unchanged bytes would be a
2579
+ * write with nothing to do.
2580
+ */
2581
+ readonly retiredByPublication: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
2454
2582
  }, undefined>, v.TransformAction<{
2455
2583
  id: string;
2456
2584
  artifactId?: string | null | undefined;
@@ -2495,6 +2623,7 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2495
2623
  itemVersion: number;
2496
2624
  itemChangedSince: boolean;
2497
2625
  deliveredCount: number;
2626
+ guideChangedSinceRead?: boolean | undefined;
2498
2627
  threadId: string;
2499
2628
  replyToId: string | null;
2500
2629
  repliesWithheld?: number | undefined;
@@ -2506,6 +2635,8 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2506
2635
  branch?: string | undefined;
2507
2636
  } | null | undefined;
2508
2637
  removed?: true | undefined;
2638
+ inactive?: true | undefined;
2639
+ retiredByPublication?: true | undefined;
2509
2640
  }, {
2510
2641
  type: string;
2511
2642
  id: string;
@@ -2550,6 +2681,7 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2550
2681
  itemVersion: number;
2551
2682
  itemChangedSince: boolean;
2552
2683
  deliveredCount: number;
2684
+ guideChangedSinceRead?: boolean | undefined;
2553
2685
  threadId: string;
2554
2686
  replyToId: string | null;
2555
2687
  repliesWithheld?: number | undefined;
@@ -2561,6 +2693,8 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2561
2693
  branch?: string | undefined;
2562
2694
  } | null | undefined;
2563
2695
  removed?: true | undefined;
2696
+ inactive?: true | undefined;
2697
+ retiredByPublication?: true | undefined;
2564
2698
  }>]>, undefined>;
2565
2699
  readonly untrusted: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
2566
2700
  readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -2746,6 +2880,19 @@ export declare const AgentCommentRequestSchema: v.ObjectSchema<{
2746
2880
  readonly model: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
2747
2881
  readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
2748
2882
  }, undefined>;
2883
+ /**
2884
+ * The reader's repo, as its committed `project.id`. A reply may name a
2885
+ * comment by the unique id prefix `list_comments` printed, and a comment
2886
+ * drafted from one repo's corrections is listed only to a read that declares
2887
+ * that repo, so it is matched only by a reply that declares it too.
2888
+ */
2889
+ readonly projectId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>, undefined>;
2890
+ /**
2891
+ * The bundles the reader's `list_comments` was scoped to, so an id prefix
2892
+ * printed there is matched among exactly those bundles. Without it the prefix
2893
+ * is matched among every bundle the caller can reach.
2894
+ */
2895
+ readonly bundleIds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>, undefined>;
2749
2896
  }, undefined>;
2750
2897
  export type AgentCommentRequest = v.InferOutput<typeof AgentCommentRequestSchema>;
2751
2898
  /**
@@ -2847,6 +2994,19 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
2847
2994
  * that the server handed it over.
2848
2995
  */
2849
2996
  readonly deliveredCount: v.NumberSchema<undefined>;
2997
+ /**
2998
+ * On a root: true when the item changed after an earlier read was last
2999
+ * handed this comment. For a guide that is any change to its body or its
3000
+ * files, so a fix in a supporting file counts. A reader should check whether
3001
+ * the change addressed the comment, and resolve it with a note if so.
3002
+ *
3003
+ * Computed before this read is counted, so the read that carries `true` is
3004
+ * the one that uses it up; the next read says `false` unless the item
3005
+ * changes again. A comment never handed over before is never flagged.
3006
+ * Optional because a server that predates the field omits it, and absent on
3007
+ * a reply.
3008
+ */
3009
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2850
3010
  /**
2851
3011
  * This comment's thread root: its own id on a root, the root's id on a reply.
2852
3012
  *
@@ -2956,6 +3116,19 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
2956
3116
  * that the server handed it over.
2957
3117
  */
2958
3118
  readonly deliveredCount: v.NumberSchema<undefined>;
3119
+ /**
3120
+ * On a root: true when the item changed after an earlier read was last
3121
+ * handed this comment. For a guide that is any change to its body or its
3122
+ * files, so a fix in a supporting file counts. A reader should check whether
3123
+ * the change addressed the comment, and resolve it with a note if so.
3124
+ *
3125
+ * Computed before this read is counted, so the read that carries `true` is
3126
+ * the one that uses it up; the next read says `false` unless the item
3127
+ * changes again. A comment never handed over before is never flagged.
3128
+ * Optional because a server that predates the field omits it, and absent on
3129
+ * a reply.
3130
+ */
3131
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2959
3132
  /**
2960
3133
  * This comment's thread root: its own id on a root, the root's id on a reply.
2961
3134
  *
@@ -3017,10 +3190,12 @@ export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
3017
3190
  * `navigation` is a skill load counted when a finding was drafted from how
3018
3191
  * the skill's files were read: evidence of how a skill was used, not of a
3019
3192
  * failure. `action` is a recorded step of a workflow repeated across
3020
- * sessions. A server sends it only to a client that names a version new
3021
- * enough to parse it.
3193
+ * sessions. `discrepancy` is a grader's note that a session's closing report
3194
+ * contradicted its recorded actions; its excerpt is the agent's quoted claim
3195
+ * and the record. A server sends `action` and `discrepancy` only to a client
3196
+ * that names a version new enough to parse them.
3022
3197
  */
3023
- readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
3198
+ readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action", "discrepancy"], undefined>;
3024
3199
  readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3025
3200
  /** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
3026
3201
  readonly at: v.StringSchema<undefined>;
@@ -3135,10 +3310,12 @@ export declare const CommentEvidenceResponseSchema: v.ObjectSchema<{
3135
3310
  * `navigation` is a skill load counted when a finding was drafted from how
3136
3311
  * the skill's files were read: evidence of how a skill was used, not of a
3137
3312
  * failure. `action` is a recorded step of a workflow repeated across
3138
- * sessions. A server sends it only to a client that names a version new
3139
- * enough to parse it.
3313
+ * sessions. `discrepancy` is a grader's note that a session's closing report
3314
+ * contradicted its recorded actions; its excerpt is the agent's quoted claim
3315
+ * and the record. A server sends `action` and `discrepancy` only to a client
3316
+ * that names a version new enough to parse them.
3140
3317
  */
3141
- readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
3318
+ readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action", "discrepancy"], undefined>;
3142
3319
  readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3143
3320
  /** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
3144
3321
  readonly at: v.StringSchema<undefined>;
@@ -3569,6 +3746,19 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3569
3746
  * that the server handed it over.
3570
3747
  */
3571
3748
  readonly deliveredCount: v.NumberSchema<undefined>;
3749
+ /**
3750
+ * On a root: true when the item changed after an earlier read was last
3751
+ * handed this comment. For a guide that is any change to its body or its
3752
+ * files, so a fix in a supporting file counts. A reader should check whether
3753
+ * the change addressed the comment, and resolve it with a note if so.
3754
+ *
3755
+ * Computed before this read is counted, so the read that carries `true` is
3756
+ * the one that uses it up; the next read says `false` unless the item
3757
+ * changes again. A comment never handed over before is never flagged.
3758
+ * Optional because a server that predates the field omits it, and absent on
3759
+ * a reply.
3760
+ */
3761
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3572
3762
  /**
3573
3763
  * This comment's thread root: its own id on a root, the root's id on a reply.
3574
3764
  *
@@ -3617,12 +3807,53 @@ export declare const ArtifactSchema: v.ObjectSchema<{
3617
3807
  itemVersion: number;
3618
3808
  itemChangedSince: boolean;
3619
3809
  deliveredCount: number;
3810
+ guideChangedSinceRead?: boolean | undefined;
3620
3811
  threadId: string;
3621
3812
  replyToId: string | null;
3622
3813
  repliesWithheld?: number | undefined;
3623
3814
  }[], number, undefined>]>, undefined>;
3624
3815
  readonly updatedAt: v.StringSchema<undefined>;
3625
3816
  }, undefined>;
3817
+ /**
3818
+ * A guide publication: the bytes at an agent-guidance path, published from the
3819
+ * repository that homes the bundle, land as a guide rather than a document.
3820
+ *
3821
+ * `format` is the discovery format of the path, the one import records.
3822
+ * `members` is a skill's member files, relative to its directory, and is
3823
+ * authoritative when present: a stored member it omits is removed, unless it
3824
+ * is listed in `skippedPaths` (present at the ref, but not sendable). Only a
3825
+ * `skill-md` publication carries members.
3826
+ */
3827
+ export declare const GuidePublishSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
3828
+ readonly format: v.PicklistSchema<["agents-md", "agents-dir", "claude-md", "claude-rules", "cursorrules", "cursor-rules", "skill-md"], undefined>;
3829
+ readonly members: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
3830
+ readonly path: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, v.CheckAction<string, "path must not shadow the skill’s own SKILL.md">]>;
3831
+ readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
3832
+ }, undefined>, undefined>, v.MaxLengthAction<{
3833
+ path: string;
3834
+ content: string;
3835
+ }[], 64, undefined>, v.CheckAction<{
3836
+ path: string;
3837
+ content: string;
3838
+ }[], "member paths must be unique (case-insensitive)">]>, undefined>;
3839
+ readonly skippedPaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>, undefined>, v.MaxLengthAction<string[], 256, undefined>]>, undefined>;
3840
+ /**
3841
+ * The repository's other copies of this file, such as a skill's twin in
3842
+ * the other skills folder, each published as an alias of this guide rather
3843
+ * than a guide of its own. Each must be an alias path of the published one
3844
+ * (`aliasPathSiblings`). Additive: an alias it omits is kept.
3845
+ */
3846
+ readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>, v.MaxLengthAction<string[], 8, undefined>]>, undefined>;
3847
+ }, undefined>, v.CheckAction<{
3848
+ format: "agents-md" | "agents-dir" | "claude-md" | "claude-rules" | "cursorrules" | "cursor-rules" | "skill-md";
3849
+ members?: {
3850
+ path: string;
3851
+ content: string;
3852
+ }[] | undefined;
3853
+ skippedPaths?: string[] | undefined;
3854
+ aliases?: string[] | undefined;
3855
+ }, "only a skill-md guide carries members">]>;
3856
+ export type GuidePublish = v.InferOutput<typeof GuidePublishSchema>;
3626
3857
  /**
3627
3858
  * Create an artifact. Always a create: it takes no id, and an update is a
3628
3859
  * separate request. `bundle` is optional for an unrestricted caller, who files
@@ -3711,6 +3942,40 @@ export declare const CreateArtifactRequestSchema: v.StrictObjectSchema<{
3711
3942
  * and is not shown as authorship.
3712
3943
  */
3713
3944
  readonly agentSessionId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 256, undefined>]>, undefined>;
3945
+ /**
3946
+ * Publish this path as a guide ({@link GuidePublishSchema}). The one way an
3947
+ * agent-guidance `path` is accepted: the route also requires `gitSource` and
3948
+ * a `bundle` whose home is `projectId`.
3949
+ */
3950
+ readonly guide: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
3951
+ readonly format: v.PicklistSchema<["agents-md", "agents-dir", "claude-md", "claude-rules", "cursorrules", "cursor-rules", "skill-md"], undefined>;
3952
+ readonly members: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
3953
+ readonly path: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, v.CheckAction<string, "path must not shadow the skill’s own SKILL.md">]>;
3954
+ readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
3955
+ }, undefined>, undefined>, v.MaxLengthAction<{
3956
+ path: string;
3957
+ content: string;
3958
+ }[], 64, undefined>, v.CheckAction<{
3959
+ path: string;
3960
+ content: string;
3961
+ }[], "member paths must be unique (case-insensitive)">]>, undefined>;
3962
+ readonly skippedPaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>, undefined>, v.MaxLengthAction<string[], 256, undefined>]>, undefined>;
3963
+ /**
3964
+ * The repository's other copies of this file, such as a skill's twin in
3965
+ * the other skills folder, each published as an alias of this guide rather
3966
+ * than a guide of its own. Each must be an alias path of the published one
3967
+ * (`aliasPathSiblings`). Additive: an alias it omits is kept.
3968
+ */
3969
+ readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>, v.MaxLengthAction<string[], 8, undefined>]>, undefined>;
3970
+ }, undefined>, v.CheckAction<{
3971
+ format: "agents-md" | "agents-dir" | "claude-md" | "claude-rules" | "cursorrules" | "cursor-rules" | "skill-md";
3972
+ members?: {
3973
+ path: string;
3974
+ content: string;
3975
+ }[] | undefined;
3976
+ skippedPaths?: string[] | undefined;
3977
+ aliases?: string[] | undefined;
3978
+ }, "only a skill-md guide carries members">]>, undefined>;
3714
3979
  }, undefined>;
3715
3980
  /**
3716
3981
  * Update an existing artifact's content. The id is in the route. The version the
@@ -3796,6 +4061,39 @@ export declare const UpdateArtifactRequestSchema: v.StrictObjectSchema<{
3796
4061
  * and is not shown as authorship.
3797
4062
  */
3798
4063
  readonly agentSessionId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 256, undefined>]>, undefined>;
4064
+ /**
4065
+ * A guide publication's members ({@link GuidePublishSchema}), written after
4066
+ * the body. Accepted only on a guide's body, beside a `gitSource`.
4067
+ */
4068
+ readonly guide: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
4069
+ readonly format: v.PicklistSchema<["agents-md", "agents-dir", "claude-md", "claude-rules", "cursorrules", "cursor-rules", "skill-md"], undefined>;
4070
+ readonly members: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
4071
+ readonly path: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, v.CheckAction<string, "path must not shadow the skill’s own SKILL.md">]>;
4072
+ readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
4073
+ }, undefined>, undefined>, v.MaxLengthAction<{
4074
+ path: string;
4075
+ content: string;
4076
+ }[], 64, undefined>, v.CheckAction<{
4077
+ path: string;
4078
+ content: string;
4079
+ }[], "member paths must be unique (case-insensitive)">]>, undefined>;
4080
+ readonly skippedPaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>, undefined>, v.MaxLengthAction<string[], 256, undefined>]>, undefined>;
4081
+ /**
4082
+ * The repository's other copies of this file, such as a skill's twin in
4083
+ * the other skills folder, each published as an alias of this guide rather
4084
+ * than a guide of its own. Each must be an alias path of the published one
4085
+ * (`aliasPathSiblings`). Additive: an alias it omits is kept.
4086
+ */
4087
+ readonly aliases: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>, v.MaxLengthAction<string[], 8, undefined>]>, undefined>;
4088
+ }, undefined>, v.CheckAction<{
4089
+ format: "agents-md" | "agents-dir" | "claude-md" | "claude-rules" | "cursorrules" | "cursor-rules" | "skill-md";
4090
+ members?: {
4091
+ path: string;
4092
+ content: string;
4093
+ }[] | undefined;
4094
+ skippedPaths?: string[] | undefined;
4095
+ aliases?: string[] | undefined;
4096
+ }, "only a skill-md guide carries members">]>, undefined>;
3799
4097
  }, undefined>;
3800
4098
  /**
3801
4099
  * Tombstone an artifact: the commit that published it has since deleted the
@@ -3982,6 +4280,19 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
3982
4280
  * that the server handed it over.
3983
4281
  */
3984
4282
  readonly deliveredCount: v.NumberSchema<undefined>;
4283
+ /**
4284
+ * On a root: true when the item changed after an earlier read was last
4285
+ * handed this comment. For a guide that is any change to its body or its
4286
+ * files, so a fix in a supporting file counts. A reader should check whether
4287
+ * the change addressed the comment, and resolve it with a note if so.
4288
+ *
4289
+ * Computed before this read is counted, so the read that carries `true` is
4290
+ * the one that uses it up; the next read says `false` unless the item
4291
+ * changes again. A comment never handed over before is never flagged.
4292
+ * Optional because a server that predates the field omits it, and absent on
4293
+ * a reply.
4294
+ */
4295
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
3985
4296
  /**
3986
4297
  * This comment's thread root: its own id on a root, the root's id on a reply.
3987
4298
  *
@@ -4030,6 +4341,7 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
4030
4341
  itemVersion: number;
4031
4342
  itemChangedSince: boolean;
4032
4343
  deliveredCount: number;
4344
+ guideChangedSinceRead?: boolean | undefined;
4033
4345
  threadId: string;
4034
4346
  replyToId: string | null;
4035
4347
  repliesWithheld?: number | undefined;
@@ -4162,6 +4474,19 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
4162
4474
  * that the server handed it over.
4163
4475
  */
4164
4476
  readonly deliveredCount: v.NumberSchema<undefined>;
4477
+ /**
4478
+ * On a root: true when the item changed after an earlier read was last
4479
+ * handed this comment. For a guide that is any change to its body or its
4480
+ * files, so a fix in a supporting file counts. A reader should check whether
4481
+ * the change addressed the comment, and resolve it with a note if so.
4482
+ *
4483
+ * Computed before this read is counted, so the read that carries `true` is
4484
+ * the one that uses it up; the next read says `false` unless the item
4485
+ * changes again. A comment never handed over before is never flagged.
4486
+ * Optional because a server that predates the field omits it, and absent on
4487
+ * a reply.
4488
+ */
4489
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4165
4490
  /**
4166
4491
  * This comment's thread root: its own id on a root, the root's id on a reply.
4167
4492
  *
@@ -4210,6 +4535,7 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
4210
4535
  itemVersion: number;
4211
4536
  itemChangedSince: boolean;
4212
4537
  deliveredCount: number;
4538
+ guideChangedSinceRead?: boolean | undefined;
4213
4539
  threadId: string;
4214
4540
  replyToId: string | null;
4215
4541
  repliesWithheld?: number | undefined;
@@ -4329,6 +4655,19 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
4329
4655
  * that the server handed it over.
4330
4656
  */
4331
4657
  readonly deliveredCount: v.NumberSchema<undefined>;
4658
+ /**
4659
+ * On a root: true when the item changed after an earlier read was last
4660
+ * handed this comment. For a guide that is any change to its body or its
4661
+ * files, so a fix in a supporting file counts. A reader should check whether
4662
+ * the change addressed the comment, and resolve it with a note if so.
4663
+ *
4664
+ * Computed before this read is counted, so the read that carries `true` is
4665
+ * the one that uses it up; the next read says `false` unless the item
4666
+ * changes again. A comment never handed over before is never flagged.
4667
+ * Optional because a server that predates the field omits it, and absent on
4668
+ * a reply.
4669
+ */
4670
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4332
4671
  /**
4333
4672
  * This comment's thread root: its own id on a root, the root's id on a reply.
4334
4673
  *
@@ -4377,6 +4716,7 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
4377
4716
  itemVersion: number;
4378
4717
  itemChangedSince: boolean;
4379
4718
  deliveredCount: number;
4719
+ guideChangedSinceRead?: boolean | undefined;
4380
4720
  threadId: string;
4381
4721
  replyToId: string | null;
4382
4722
  repliesWithheld?: number | undefined;
@@ -4497,6 +4837,19 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
4497
4837
  * that the server handed it over.
4498
4838
  */
4499
4839
  readonly deliveredCount: v.NumberSchema<undefined>;
4840
+ /**
4841
+ * On a root: true when the item changed after an earlier read was last
4842
+ * handed this comment. For a guide that is any change to its body or its
4843
+ * files, so a fix in a supporting file counts. A reader should check whether
4844
+ * the change addressed the comment, and resolve it with a note if so.
4845
+ *
4846
+ * Computed before this read is counted, so the read that carries `true` is
4847
+ * the one that uses it up; the next read says `false` unless the item
4848
+ * changes again. A comment never handed over before is never flagged.
4849
+ * Optional because a server that predates the field omits it, and absent on
4850
+ * a reply.
4851
+ */
4852
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4500
4853
  /**
4501
4854
  * This comment's thread root: its own id on a root, the root's id on a reply.
4502
4855
  *
@@ -4545,6 +4898,7 @@ export declare const RemoveArtifactResponseSchema: v.ObjectSchema<{
4545
4898
  itemVersion: number;
4546
4899
  itemChangedSince: boolean;
4547
4900
  deliveredCount: number;
4901
+ guideChangedSinceRead?: boolean | undefined;
4548
4902
  threadId: string;
4549
4903
  replyToId: string | null;
4550
4904
  repliesWithheld?: number | undefined;
@@ -6390,6 +6744,19 @@ export declare const ArtifactFeedbackResponseSchema: v.ObjectSchema<{
6390
6744
  * that the server handed it over.
6391
6745
  */
6392
6746
  readonly deliveredCount: v.NumberSchema<undefined>;
6747
+ /**
6748
+ * On a root: true when the item changed after an earlier read was last
6749
+ * handed this comment. For a guide that is any change to its body or its
6750
+ * files, so a fix in a supporting file counts. A reader should check whether
6751
+ * the change addressed the comment, and resolve it with a note if so.
6752
+ *
6753
+ * Computed before this read is counted, so the read that carries `true` is
6754
+ * the one that uses it up; the next read says `false` unless the item
6755
+ * changes again. A comment never handed over before is never flagged.
6756
+ * Optional because a server that predates the field omits it, and absent on
6757
+ * a reply.
6758
+ */
6759
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6393
6760
  /**
6394
6761
  * This comment's thread root: its own id on a root, the root's id on a reply.
6395
6762
  *
@@ -6713,6 +7080,19 @@ export declare const ArtifactFeedbackBatchResponseSchema: v.ObjectSchema<{
6713
7080
  * that the server handed it over.
6714
7081
  */
6715
7082
  readonly deliveredCount: v.NumberSchema<undefined>;
7083
+ /**
7084
+ * On a root: true when the item changed after an earlier read was last
7085
+ * handed this comment. For a guide that is any change to its body or its
7086
+ * files, so a fix in a supporting file counts. A reader should check whether
7087
+ * the change addressed the comment, and resolve it with a note if so.
7088
+ *
7089
+ * Computed before this read is counted, so the read that carries `true` is
7090
+ * the one that uses it up; the next read says `false` unless the item
7091
+ * changes again. A comment never handed over before is never flagged.
7092
+ * Optional because a server that predates the field omits it, and absent on
7093
+ * a reply.
7094
+ */
7095
+ readonly guideChangedSinceRead: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6716
7096
  /**
6717
7097
  * This comment's thread root: its own id on a root, the root's id on a reply.
6718
7098
  *
@@ -8466,6 +8846,7 @@ export declare function parseContextItemsResponse(data: unknown): {
8466
8846
  itemVersion: number;
8467
8847
  itemChangedSince: boolean;
8468
8848
  deliveredCount: number;
8849
+ guideChangedSinceRead?: boolean | undefined;
8469
8850
  threadId: string;
8470
8851
  replyToId: string | null;
8471
8852
  repliesWithheld?: number | undefined;
@@ -8477,6 +8858,8 @@ export declare function parseContextItemsResponse(data: unknown): {
8477
8858
  branch?: string | undefined;
8478
8859
  } | null | undefined;
8479
8860
  removed?: true | undefined;
8861
+ inactive?: true | undefined;
8862
+ retiredByPublication?: true | undefined;
8480
8863
  }[];
8481
8864
  untrusted?: {
8482
8865
  token: string;
@@ -8530,6 +8913,7 @@ export declare function parseBundleArtifactsResponse(data: unknown): {
8530
8913
  itemVersion: number;
8531
8914
  itemChangedSince: boolean;
8532
8915
  deliveredCount: number;
8916
+ guideChangedSinceRead?: boolean | undefined;
8533
8917
  threadId: string;
8534
8918
  replyToId: string | null;
8535
8919
  repliesWithheld?: number | undefined;
@@ -8541,6 +8925,8 @@ export declare function parseBundleArtifactsResponse(data: unknown): {
8541
8925
  branch?: string | undefined;
8542
8926
  } | null | undefined;
8543
8927
  removed?: true | undefined;
8928
+ inactive?: true | undefined;
8929
+ retiredByPublication?: true | undefined;
8544
8930
  }[];
8545
8931
  untrusted?: {
8546
8932
  token: string;
@@ -8880,6 +9266,7 @@ export declare function parseItemCommentsResponse(data: unknown): {
8880
9266
  itemVersion: number;
8881
9267
  itemChangedSince: boolean;
8882
9268
  deliveredCount: number;
9269
+ guideChangedSinceRead?: boolean | undefined;
8883
9270
  threadId: string;
8884
9271
  replyToId: string | null;
8885
9272
  repliesWithheld?: number | undefined;
@@ -8927,7 +9314,7 @@ export declare function parseCommentEvidenceResponse(data: unknown): {
8927
9314
  }[];
8928
9315
  } | null;
8929
9316
  citations: {
8930
- kind: "verdict" | "turn" | "navigation" | "action";
9317
+ kind: "verdict" | "turn" | "navigation" | "action" | "discrepancy";
8931
9318
  sessionId: string;
8932
9319
  at: string;
8933
9320
  excerpt: string;