@mossbear/protocol 0.1.0-alpha.70 → 0.1.0-alpha.72

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
@@ -11,28 +11,8 @@ import * as v from 'valibot';
11
11
  export declare const VerdictSchema: v.PicklistSchema<["aligned", "unguided", "misaligned"], undefined>;
12
12
  export declare const GuidingTierSchema: v.PicklistSchema<["pattern_match", "cached", "llm", "batch"], undefined>;
13
13
  /**
14
- * Which agent a piece of extracted feedback came from.
15
- *
16
- * Wire-only, and used solely as `source` on the two extracted-suggestion
17
- * schemas below — no column stores it, so this list is free to change. The
18
- * similarly-named `guides.source` is an unrelated vocabulary
19
- * (`human | ai_suggested | feedback_extracted | imported`).
20
- *
21
- * Not the same set as the harnesses `mossbear init` can wire: `cursor` and
22
- * `copilot` have no hook integration but can still be where a suggestion was
23
- * observed, and `init`'s `--platform` deliberately refuses them rather than
24
- * exiting 0 having wired nothing. `windsurf` came out in 2026-08 — it was a
25
- * guess at the market rather than anything wired, and Windsurf is no longer a
26
- * going concern. `gemini_cli` came out in 2026-08 for the same reason in
27
- * reverse: it *was* wired, and stopped being, when Gemini CLI stopped serving
28
- * individual developers.
29
- *
30
- * **Only `claude_code` is produced today**, hardcoded at
31
- * `packages/cli/src/feedback/extract.ts:49`, because extraction reads Claude
32
- * Code's transcript format. The other values are reachable over the wire and
33
- * rendered, but nothing in this repo sets them yet — making `source` truthful
34
- * per harness needs multi-harness transcript reading, which is a separate piece
35
- * of work from wiring the hooks.
14
+ * Compatibility vocabulary for the source of legacy extracted suggestions.
15
+ * These values describe suggestion provenance rather than run-harness identity.
36
16
  */
37
17
  export declare const PlatformKindSchema: v.PicklistSchema<["claude_code", "codex", "opencode", "cursor", "copilot", "other"], undefined>;
38
18
  /**
@@ -375,6 +355,8 @@ export declare const GuideImportOutcomeSchema: v.PicklistSchema<["imported", "up
375
355
  * inventing one would let a later import claim a precondition it never observed.
376
356
  */
377
357
  export declare const GuideImportResultSchema: v.ObjectSchema<{
358
+ /** Canonical guide identity for review links; absent on older servers. */
359
+ readonly guideId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
378
360
  readonly root: v.PicklistSchema<["project", "global"], undefined>;
379
361
  readonly path: 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">]>;
380
362
  readonly outcome: v.PicklistSchema<["imported", "updated", "skipped", "conflict"], undefined>;
@@ -793,6 +775,14 @@ export declare const ResolveSubscriptionsResponseSchema: v.ObjectSchema<{
793
775
  readonly account: v.OptionalSchema<v.ObjectSchema<{
794
776
  readonly deliverGlobalSkills: v.BooleanSchema<undefined>;
795
777
  }, undefined>, undefined>;
778
+ /**
779
+ * True when the caller's token is limited to certain bundles. Such a token
780
+ * resolves only what it was granted, so an id in `unresolved` may be a bundle
781
+ * the account can reach and the token cannot. Said once for the response,
782
+ * never per id, so it confirms nothing about any one bundle. Optional: absent
783
+ * means an ordinary token, and a server that predates it never sends it.
784
+ */
785
+ readonly limitedToken: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
796
786
  }, undefined>;
797
787
  /**
798
788
  * Subscribe the calling account to a bundle it can see, or change the delivery
@@ -1072,6 +1062,19 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
1072
1062
  }, undefined>, undefined>;
1073
1063
  /** The comment's text, already wrapped in the response's untrusted markers. */
1074
1064
  readonly body: v.StringSchema<undefined>;
1065
+ /**
1066
+ * A suggested edit: the replacement for the passage at `passage.lines`,
1067
+ * already wrapped in the response's untrusted markers like `body`. An
1068
+ * insertion is the passage plus its new lines and an empty replacement is a
1069
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
1070
+ */
1071
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1072
+ /**
1073
+ * One line saying what a server-drafted comment was drawn from — counts and
1074
+ * dates, never the cited text. Present only on a comment Mossbear drafted
1075
+ * and the person handed to their agent.
1076
+ */
1077
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1075
1078
  /** The author's display name as the workspace shows it, or null. Never an email. */
1076
1079
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1077
1080
  /** ISO timestamp, machine format. */
@@ -1248,6 +1251,19 @@ export declare const ContextItemSchema: v.ObjectSchema<{
1248
1251
  }, undefined>, undefined>;
1249
1252
  /** The comment's text, already wrapped in the response's untrusted markers. */
1250
1253
  readonly body: v.StringSchema<undefined>;
1254
+ /**
1255
+ * A suggested edit: the replacement for the passage at `passage.lines`,
1256
+ * already wrapped in the response's untrusted markers like `body`. An
1257
+ * insertion is the passage plus its new lines and an empty replacement is a
1258
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
1259
+ */
1260
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1261
+ /**
1262
+ * One line saying what a server-drafted comment was drawn from — counts and
1263
+ * dates, never the cited text. Present only on a comment Mossbear drafted
1264
+ * and the person handed to their agent.
1265
+ */
1266
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1251
1267
  /** The author's display name as the workspace shows it, or null. Never an email. */
1252
1268
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1253
1269
  /** ISO timestamp, machine format. */
@@ -1299,6 +1315,8 @@ export declare const ContextItemSchema: v.ObjectSchema<{
1299
1315
  } | null;
1300
1316
  } | undefined;
1301
1317
  body: string;
1318
+ suggestion?: string | undefined;
1319
+ evidence?: string | undefined;
1302
1320
  authorName: string | null;
1303
1321
  createdAt: string;
1304
1322
  itemVersion: number;
@@ -1466,6 +1484,19 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1466
1484
  }, undefined>, undefined>;
1467
1485
  /** The comment's text, already wrapped in the response's untrusted markers. */
1468
1486
  readonly body: v.StringSchema<undefined>;
1487
+ /**
1488
+ * A suggested edit: the replacement for the passage at `passage.lines`,
1489
+ * already wrapped in the response's untrusted markers like `body`. An
1490
+ * insertion is the passage plus its new lines and an empty replacement is a
1491
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
1492
+ */
1493
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1494
+ /**
1495
+ * One line saying what a server-drafted comment was drawn from — counts and
1496
+ * dates, never the cited text. Present only on a comment Mossbear drafted
1497
+ * and the person handed to their agent.
1498
+ */
1499
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1469
1500
  /** The author's display name as the workspace shows it, or null. Never an email. */
1470
1501
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1471
1502
  /** ISO timestamp, machine format. */
@@ -1517,6 +1548,8 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1517
1548
  } | null;
1518
1549
  } | undefined;
1519
1550
  body: string;
1551
+ suggestion?: string | undefined;
1552
+ evidence?: string | undefined;
1520
1553
  authorName: string | null;
1521
1554
  createdAt: string;
1522
1555
  itemVersion: number;
@@ -1709,6 +1742,19 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
1709
1742
  }, undefined>, undefined>;
1710
1743
  /** The comment's text, already wrapped in the response's untrusted markers. */
1711
1744
  readonly body: v.StringSchema<undefined>;
1745
+ /**
1746
+ * A suggested edit: the replacement for the passage at `passage.lines`,
1747
+ * already wrapped in the response's untrusted markers like `body`. An
1748
+ * insertion is the passage plus its new lines and an empty replacement is a
1749
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
1750
+ */
1751
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1752
+ /**
1753
+ * One line saying what a server-drafted comment was drawn from — counts and
1754
+ * dates, never the cited text. Present only on a comment Mossbear drafted
1755
+ * and the person handed to their agent.
1756
+ */
1757
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1712
1758
  /** The author's display name as the workspace shows it, or null. Never an email. */
1713
1759
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1714
1760
  /** ISO timestamp, machine format. */
@@ -1781,6 +1827,19 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
1781
1827
  }, undefined>, undefined>;
1782
1828
  /** The comment's text, already wrapped in the response's untrusted markers. */
1783
1829
  readonly body: v.StringSchema<undefined>;
1830
+ /**
1831
+ * A suggested edit: the replacement for the passage at `passage.lines`,
1832
+ * already wrapped in the response's untrusted markers like `body`. An
1833
+ * insertion is the passage plus its new lines and an empty replacement is a
1834
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
1835
+ */
1836
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1837
+ /**
1838
+ * One line saying what a server-drafted comment was drawn from — counts and
1839
+ * dates, never the cited text. Present only on a comment Mossbear drafted
1840
+ * and the person handed to their agent.
1841
+ */
1842
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1784
1843
  /** The author's display name as the workspace shows it, or null. Never an email. */
1785
1844
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1786
1845
  /** ISO timestamp, machine format. */
@@ -1834,6 +1893,73 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
1834
1893
  }, undefined>, undefined>, undefined>;
1835
1894
  }, undefined>;
1836
1895
  export type ItemCommentsResponse = v.InferOutput<typeof ItemCommentsResponseSchema>;
1896
+ /**
1897
+ * The evidence behind one Mossbear comment an agent was handed
1898
+ * (`GET /api/v1/context/comments/evidence`, `drafted-guide-suggestions` slice 7).
1899
+ *
1900
+ * `list_comments` carries a one-line pointer; this is the envelope it points
1901
+ * at: the summary, the observable change the edit predicts, and the cited
1902
+ * sessions. Readable only through a comment the comment read itself would
1903
+ * deliver to this reader, so an unapproved edit, another person's, or one
1904
+ * drafted from another repo has no evidence here either.
1905
+ *
1906
+ * Citations are reduced to what the reader may see: their own sessions, with a
1907
+ * date and a short excerpt of the grader's reasoning or of their own redacted
1908
+ * correction turn. A `navigation` citation — a skill load counted when a
1909
+ * suggestion was drafted from how the skill's files were read — has an empty
1910
+ * excerpt: it is dated evidence that a session loaded the skill, and nothing
1911
+ * more. `citationsWithheld` counts any that were dropped, so a short
1912
+ * list is never mistaken for the whole of it.
1913
+ */
1914
+ export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
1915
+ /**
1916
+ * `navigation` is a skill load whose reads drafted the suggestion. It carries
1917
+ * no excerpt (an empty string): it is evidence of how a skill was used, not of
1918
+ * a failure. `action` is a recorded step of a workflow repeated across
1919
+ * sessions: evidence of a habit, not of a failure. A server sends it only to a
1920
+ * client that names a version new enough to parse it.
1921
+ */
1922
+ readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
1923
+ readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1924
+ /** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
1925
+ readonly at: v.StringSchema<undefined>;
1926
+ /** Wrapped in the response's untrusted markers. */
1927
+ readonly excerpt: v.StringSchema<undefined>;
1928
+ }, undefined>;
1929
+ export type CommentEvidenceCitation = v.InferOutput<typeof CommentEvidenceCitationSchema>;
1930
+ export declare const CommentEvidenceResponseSchema: v.ObjectSchema<{
1931
+ /** The comment's full id, even when the request named a prefix. */
1932
+ readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1933
+ readonly itemName: v.StringSchema<undefined>;
1934
+ readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1935
+ /** Wrapped in the response's untrusted markers. */
1936
+ readonly summary: v.StringSchema<undefined>;
1937
+ /** What future sessions should show if the edit works, wrapped; null if none. */
1938
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1939
+ readonly citations: v.ArraySchema<v.ObjectSchema<{
1940
+ /**
1941
+ * `navigation` is a skill load whose reads drafted the suggestion. It carries
1942
+ * no excerpt (an empty string): it is evidence of how a skill was used, not of
1943
+ * a failure. `action` is a recorded step of a workflow repeated across
1944
+ * sessions: evidence of a habit, not of a failure. A server sends it only to a
1945
+ * client that names a version new enough to parse it.
1946
+ */
1947
+ readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action"], undefined>;
1948
+ readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1949
+ /** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
1950
+ readonly at: v.StringSchema<undefined>;
1951
+ /** Wrapped in the response's untrusted markers. */
1952
+ readonly excerpt: v.StringSchema<undefined>;
1953
+ }, undefined>, undefined>;
1954
+ readonly citationsWithheld: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
1955
+ readonly untrusted: v.ObjectSchema<{
1956
+ readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1957
+ readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1958
+ readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1959
+ readonly note: v.StringSchema<undefined>;
1960
+ }, undefined>;
1961
+ }, undefined>;
1962
+ export type CommentEvidenceResponse = v.InferOutput<typeof CommentEvidenceResponseSchema>;
1837
1963
  /** Max number of context item ids a push may cite as its transform sources. */
1838
1964
  export declare const MAX_TRANSFORM_SOURCE_IDS = 100;
1839
1965
  /**
@@ -2006,6 +2132,19 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
2006
2132
  }, undefined>, undefined>;
2007
2133
  /** The comment's text, already wrapped in the response's untrusted markers. */
2008
2134
  readonly body: v.StringSchema<undefined>;
2135
+ /**
2136
+ * A suggested edit: the replacement for the passage at `passage.lines`,
2137
+ * already wrapped in the response's untrusted markers like `body`. An
2138
+ * insertion is the passage plus its new lines and an empty replacement is a
2139
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
2140
+ */
2141
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2142
+ /**
2143
+ * One line saying what a server-drafted comment was drawn from — counts and
2144
+ * dates, never the cited text. Present only on a comment Mossbear drafted
2145
+ * and the person handed to their agent.
2146
+ */
2147
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
2009
2148
  /** The author's display name as the workspace shows it, or null. Never an email. */
2010
2149
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2011
2150
  /** ISO timestamp, machine format. */
@@ -2057,6 +2196,8 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
2057
2196
  } | null;
2058
2197
  } | undefined;
2059
2198
  body: string;
2199
+ suggestion?: string | undefined;
2200
+ evidence?: string | undefined;
2060
2201
  authorName: string | null;
2061
2202
  createdAt: string;
2062
2203
  itemVersion: number;
@@ -2313,6 +2454,19 @@ export declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
2313
2454
  }, undefined>, undefined>;
2314
2455
  /** The comment's text, already wrapped in the response's untrusted markers. */
2315
2456
  readonly body: v.StringSchema<undefined>;
2457
+ /**
2458
+ * A suggested edit: the replacement for the passage at `passage.lines`,
2459
+ * already wrapped in the response's untrusted markers like `body`. An
2460
+ * insertion is the passage plus its new lines and an empty replacement is a
2461
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
2462
+ */
2463
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2464
+ /**
2465
+ * One line saying what a server-drafted comment was drawn from — counts and
2466
+ * dates, never the cited text. Present only on a comment Mossbear drafted
2467
+ * and the person handed to their agent.
2468
+ */
2469
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
2316
2470
  /** The author's display name as the workspace shows it, or null. Never an email. */
2317
2471
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2318
2472
  /** ISO timestamp, machine format. */
@@ -2364,6 +2518,8 @@ export declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
2364
2518
  } | null;
2365
2519
  } | undefined;
2366
2520
  body: string;
2521
+ suggestion?: string | undefined;
2522
+ evidence?: string | undefined;
2367
2523
  authorName: string | null;
2368
2524
  createdAt: string;
2369
2525
  itemVersion: number;
@@ -2781,6 +2937,19 @@ export declare const ContextItemResponseSchema: v.ObjectSchema<{
2781
2937
  }, undefined>, undefined>;
2782
2938
  /** The comment's text, already wrapped in the response's untrusted markers. */
2783
2939
  readonly body: v.StringSchema<undefined>;
2940
+ /**
2941
+ * A suggested edit: the replacement for the passage at `passage.lines`,
2942
+ * already wrapped in the response's untrusted markers like `body`. An
2943
+ * insertion is the passage plus its new lines and an empty replacement is a
2944
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
2945
+ */
2946
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2947
+ /**
2948
+ * One line saying what a server-drafted comment was drawn from — counts and
2949
+ * dates, never the cited text. Present only on a comment Mossbear drafted
2950
+ * and the person handed to their agent.
2951
+ */
2952
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
2784
2953
  /** The author's display name as the workspace shows it, or null. Never an email. */
2785
2954
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2786
2955
  /** ISO timestamp, machine format. */
@@ -2832,6 +3001,8 @@ export declare const ContextItemResponseSchema: v.ObjectSchema<{
2832
3001
  } | null;
2833
3002
  } | undefined;
2834
3003
  body: string;
3004
+ suggestion?: string | undefined;
3005
+ evidence?: string | undefined;
2835
3006
  authorName: string | null;
2836
3007
  createdAt: string;
2837
3008
  itemVersion: number;
@@ -3001,6 +3172,19 @@ export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
3001
3172
  }, undefined>, undefined>;
3002
3173
  /** The comment's text, already wrapped in the response's untrusted markers. */
3003
3174
  readonly body: v.StringSchema<undefined>;
3175
+ /**
3176
+ * A suggested edit: the replacement for the passage at `passage.lines`,
3177
+ * already wrapped in the response's untrusted markers like `body`. An
3178
+ * insertion is the passage plus its new lines and an empty replacement is a
3179
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
3180
+ */
3181
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
3182
+ /**
3183
+ * One line saying what a server-drafted comment was drawn from — counts and
3184
+ * dates, never the cited text. Present only on a comment Mossbear drafted
3185
+ * and the person handed to their agent.
3186
+ */
3187
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
3004
3188
  /** The author's display name as the workspace shows it, or null. Never an email. */
3005
3189
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3006
3190
  /** ISO timestamp, machine format. */
@@ -3052,6 +3236,8 @@ export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
3052
3236
  } | null;
3053
3237
  } | undefined;
3054
3238
  body: string;
3239
+ suggestion?: string | undefined;
3240
+ evidence?: string | undefined;
3055
3241
  authorName: string | null;
3056
3242
  createdAt: string;
3057
3243
  itemVersion: number;
@@ -4000,20 +4186,6 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
4000
4186
  */
4001
4187
  readonly origin: v.OptionalSchema<v.PicklistSchema<["session-start"], undefined>, undefined>;
4002
4188
  }, undefined>;
4003
- export declare const ExtractedGuideSuggestionSchema: v.ObjectSchema<{
4004
- readonly id: v.StringSchema<undefined>;
4005
- readonly content: v.StringSchema<undefined>;
4006
- readonly reasoning: v.StringSchema<undefined>;
4007
- readonly triggerType: v.PicklistSchema<["conversational_feedback"], undefined>;
4008
- readonly confidence: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
4009
- readonly occurrences: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4010
- readonly citations: v.ArraySchema<v.ObjectSchema<{
4011
- readonly agentSessionId: v.StringSchema<undefined>;
4012
- readonly timestamp: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
4013
- readonly summary: v.StringSchema<undefined>;
4014
- }, undefined>, undefined>;
4015
- readonly source: v.PicklistSchema<["claude_code", "codex", "opencode", "cursor", "copilot", "other"], undefined>;
4016
- }, undefined>;
4017
4189
  export declare const ExtractedSkillSuggestionSchema: v.ObjectSchema<{
4018
4190
  readonly id: v.StringSchema<undefined>;
4019
4191
  readonly signal: v.StringSchema<undefined>;
@@ -4027,20 +4199,6 @@ export declare const ExtractedSkillSuggestionSchema: v.ObjectSchema<{
4027
4199
  readonly source: v.PicklistSchema<["claude_code", "codex", "opencode", "cursor", "copilot", "other"], undefined>;
4028
4200
  }, undefined>;
4029
4201
  export declare const ExtractedFeedbackBatchSchema: v.ObjectSchema<{
4030
- readonly guideSuggestions: v.ArraySchema<v.ObjectSchema<{
4031
- readonly id: v.StringSchema<undefined>;
4032
- readonly content: v.StringSchema<undefined>;
4033
- readonly reasoning: v.StringSchema<undefined>;
4034
- readonly triggerType: v.PicklistSchema<["conversational_feedback"], undefined>;
4035
- readonly confidence: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
4036
- readonly occurrences: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4037
- readonly citations: v.ArraySchema<v.ObjectSchema<{
4038
- readonly agentSessionId: v.StringSchema<undefined>;
4039
- readonly timestamp: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
4040
- readonly summary: v.StringSchema<undefined>;
4041
- }, undefined>, undefined>;
4042
- readonly source: v.PicklistSchema<["claude_code", "codex", "opencode", "cursor", "copilot", "other"], undefined>;
4043
- }, undefined>, undefined>;
4044
4202
  readonly skillSuggestions: v.ArraySchema<v.ObjectSchema<{
4045
4203
  readonly id: v.StringSchema<undefined>;
4046
4204
  readonly signal: v.StringSchema<undefined>;
@@ -4535,6 +4693,39 @@ export declare const GuideHistoryGuideSchema: v.ObjectSchema<{
4535
4693
  readonly path: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, undefined>;
4536
4694
  readonly root: v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>;
4537
4695
  }, undefined>;
4696
+ /**
4697
+ * The newest stored failure-pattern analysis of the guide, as the reader's own
4698
+ * dashboard shows it (`drafted-guide-suggestions` slice 7).
4699
+ *
4700
+ * **The caller's own analysis only.** An analysis reads the caller's verdicts,
4701
+ * so a workspace-mate's is never returned, the same rule the verdicts follow.
4702
+ *
4703
+ * **Staleness is derived on read**, exactly as the dashboard derives it: the
4704
+ * guide's wording changed since (`revision_changed`), or failures of the same
4705
+ * wording arrived that it has not read (`new_failures`, with how many). A stale
4706
+ * analysis is still what it found; it is reported, never withheld.
4707
+ *
4708
+ * `summary` arrives wrapped in the response's untrusted markers. It is
4709
+ * model-authored text derived from session transcripts. On `no_pattern` it may
4710
+ * be empty between them, because the dashboard supplies that sentence itself.
4711
+ */
4712
+ export declare const GuideHistoryAnalysisSchema: v.ObjectSchema<{
4713
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4714
+ /** When it was written, ISO. */
4715
+ readonly createdAt: v.StringSchema<undefined>;
4716
+ readonly outcome: v.PicklistSchema<["pattern", "no_pattern"], undefined>;
4717
+ readonly summary: v.StringSchema<undefined>;
4718
+ /** Failed sessions the analysis read. */
4719
+ readonly sessionsAnalysed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
4720
+ /** Failed sessions it left out to stay within its prompt's cap. */
4721
+ readonly sessionsOmitted: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
4722
+ readonly stale: v.BooleanSchema<undefined>;
4723
+ /** Why it is out of date, or null while it is current. */
4724
+ readonly staleReason: v.NullableSchema<v.PicklistSchema<["revision_changed", "new_failures"], undefined>, undefined>;
4725
+ /** Failures it has not read, when `staleReason` is `new_failures`; else null. */
4726
+ readonly newFailures: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
4727
+ }, undefined>;
4728
+ export type GuideHistoryAnalysis = v.InferOutput<typeof GuideHistoryAnalysisSchema>;
4538
4729
  export declare const GuideHistoryResponseSchema: v.ObjectSchema<{
4539
4730
  readonly guide: v.ObjectSchema<{
4540
4731
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -4686,6 +4877,28 @@ export declare const GuideHistoryResponseSchema: v.ObjectSchema<{
4686
4877
  * findings has no other way to know it is reading five of forty.
4687
4878
  */
4688
4879
  readonly findingsOmitted: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
4880
+ /**
4881
+ * The caller's newest stored failure-pattern analysis of this guide, or
4882
+ * **null when they have never asked for one**. Optional because a server
4883
+ * that predates it sends no key; a reader must not take absence for "never
4884
+ * analysed".
4885
+ */
4886
+ readonly analysis: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
4887
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4888
+ /** When it was written, ISO. */
4889
+ readonly createdAt: v.StringSchema<undefined>;
4890
+ readonly outcome: v.PicklistSchema<["pattern", "no_pattern"], undefined>;
4891
+ readonly summary: v.StringSchema<undefined>;
4892
+ /** Failed sessions the analysis read. */
4893
+ readonly sessionsAnalysed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
4894
+ /** Failed sessions it left out to stay within its prompt's cap. */
4895
+ readonly sessionsOmitted: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
4896
+ readonly stale: v.BooleanSchema<undefined>;
4897
+ /** Why it is out of date, or null while it is current. */
4898
+ readonly staleReason: v.NullableSchema<v.PicklistSchema<["revision_changed", "new_failures"], undefined>, undefined>;
4899
+ /** Failures it has not read, when `staleReason` is `new_failures`; else null. */
4900
+ readonly newFailures: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
4901
+ }, undefined>, undefined>, undefined>;
4689
4902
  readonly untrusted: v.ObjectSchema<{
4690
4903
  readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4691
4904
  readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -4901,7 +5114,7 @@ export type SearchRequest = v.InferOutput<typeof SearchRequestSchema>;
4901
5114
  * Why a corpus was not searched. Codes, never prose: each caller writes its own
4902
5115
  * sentence, and the dashboard's has to be a translatable one.
4903
5116
  */
4904
- export declare const SearchSkipReasonSchema: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5117
+ export declare const SearchSkipReasonSchema: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
4905
5118
  export type SearchSkipReason = v.InferOutput<typeof SearchSkipReasonSchema>;
4906
5119
  /** Why a searched corpus covered less than the caller's whole scope. */
4907
5120
  export declare const SearchNarrowingSchema: v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>;
@@ -4985,7 +5198,7 @@ export declare const SearchGuidesReportSchema: v.VariantSchema<"status", [v.Obje
4985
5198
  }, undefined>, undefined>;
4986
5199
  }, undefined>, v.ObjectSchema<{
4987
5200
  readonly status: v.LiteralSchema<"skipped", undefined>;
4988
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5201
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
4989
5202
  }, undefined>], undefined>;
4990
5203
  export declare const SearchVerdictsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
4991
5204
  readonly status: v.LiteralSchema<"searched", undefined>;
@@ -5007,7 +5220,7 @@ export declare const SearchVerdictsReportSchema: v.VariantSchema<"status", [v.Ob
5007
5220
  }, undefined>, undefined>;
5008
5221
  }, undefined>, v.ObjectSchema<{
5009
5222
  readonly status: v.LiteralSchema<"skipped", undefined>;
5010
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5223
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5011
5224
  }, undefined>], undefined>;
5012
5225
  export type SearchGuidesReport = v.InferOutput<typeof SearchGuidesReportSchema>;
5013
5226
  export type SearchVerdictsReport = v.InferOutput<typeof SearchVerdictsReportSchema>;
@@ -5058,7 +5271,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
5058
5271
  }, undefined>, undefined>;
5059
5272
  }, undefined>, v.ObjectSchema<{
5060
5273
  readonly status: v.LiteralSchema<"skipped", undefined>;
5061
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5274
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5062
5275
  }, undefined>], undefined>;
5063
5276
  readonly verdicts: v.VariantSchema<"status", [v.ObjectSchema<{
5064
5277
  readonly status: v.LiteralSchema<"searched", undefined>;
@@ -5080,7 +5293,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
5080
5293
  }, undefined>, undefined>;
5081
5294
  }, undefined>, v.ObjectSchema<{
5082
5295
  readonly status: v.LiteralSchema<"skipped", undefined>;
5083
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5296
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5084
5297
  }, undefined>], undefined>;
5085
5298
  }, undefined>;
5086
5299
  readonly notYetSearchable: v.ArraySchema<v.PicklistSchema<readonly ["findings", "actions", "suggestions", "feedback-candidates"], undefined>, undefined>;
@@ -5250,6 +5463,7 @@ export declare function parseResolveSubscriptionsResponse(data: unknown): {
5250
5463
  account?: {
5251
5464
  deliverGlobalSkills: boolean;
5252
5465
  } | undefined;
5466
+ limitedToken?: boolean | undefined;
5253
5467
  };
5254
5468
  export declare function parseUpdateBundleRequest(data: unknown): {
5255
5469
  name?: string | undefined;
@@ -5297,6 +5511,8 @@ export declare function parseContextItem(data: unknown): {
5297
5511
  } | null;
5298
5512
  } | undefined;
5299
5513
  body: string;
5514
+ suggestion?: string | undefined;
5515
+ evidence?: string | undefined;
5300
5516
  authorName: string | null;
5301
5517
  createdAt: string;
5302
5518
  itemVersion: number;
@@ -5344,6 +5560,8 @@ export declare function parseContextItemsResponse(data: unknown): {
5344
5560
  } | null;
5345
5561
  } | undefined;
5346
5562
  body: string;
5563
+ suggestion?: string | undefined;
5564
+ evidence?: string | undefined;
5347
5565
  authorName: string | null;
5348
5566
  createdAt: string;
5349
5567
  itemVersion: number;
@@ -5413,6 +5631,8 @@ export declare function parsePushContextResponse(data: unknown): {
5413
5631
  } | null;
5414
5632
  } | undefined;
5415
5633
  body: string;
5634
+ suggestion?: string | undefined;
5635
+ evidence?: string | undefined;
5416
5636
  authorName: string | null;
5417
5637
  createdAt: string;
5418
5638
  itemVersion: number;
@@ -5477,6 +5697,8 @@ export declare function parseUpdateContextItemResponse(data: unknown): {
5477
5697
  } | null;
5478
5698
  } | undefined;
5479
5699
  body: string;
5700
+ suggestion?: string | undefined;
5701
+ evidence?: string | undefined;
5480
5702
  authorName: string | null;
5481
5703
  createdAt: string;
5482
5704
  itemVersion: number;
@@ -5540,6 +5762,8 @@ export declare function parseContextItemResponse(data: unknown): {
5540
5762
  } | null;
5541
5763
  } | undefined;
5542
5764
  body: string;
5765
+ suggestion?: string | undefined;
5766
+ evidence?: string | undefined;
5543
5767
  authorName: string | null;
5544
5768
  createdAt: string;
5545
5769
  itemVersion: number;
@@ -5589,6 +5813,8 @@ export declare function parseArchiveContextItemResponse(data: unknown): {
5589
5813
  } | null;
5590
5814
  } | undefined;
5591
5815
  body: string;
5816
+ suggestion?: string | undefined;
5817
+ evidence?: string | undefined;
5592
5818
  authorName: string | null;
5593
5819
  createdAt: string;
5594
5820
  itemVersion: number;
@@ -5768,20 +5994,6 @@ export declare function parseProposalCitation(data: unknown): {
5768
5994
  timestamp?: string | undefined;
5769
5995
  summary: string;
5770
5996
  };
5771
- export declare function parseExtractedGuideSuggestion(data: unknown): {
5772
- id: string;
5773
- content: string;
5774
- reasoning: string;
5775
- triggerType: "conversational_feedback";
5776
- confidence: number;
5777
- occurrences: number;
5778
- citations: {
5779
- agentSessionId: string;
5780
- timestamp?: string | undefined;
5781
- summary: string;
5782
- }[];
5783
- source: "claude_code" | "codex" | "opencode" | "cursor" | "copilot" | "other";
5784
- };
5785
5997
  export declare function parseExtractedSkillSuggestion(data: unknown): {
5786
5998
  id: string;
5787
5999
  signal: string;
@@ -5795,20 +6007,6 @@ export declare function parseExtractedSkillSuggestion(data: unknown): {
5795
6007
  source: "claude_code" | "codex" | "opencode" | "cursor" | "copilot" | "other";
5796
6008
  };
5797
6009
  export declare function parseExtractedFeedbackBatch(data: unknown): {
5798
- guideSuggestions: {
5799
- id: string;
5800
- content: string;
5801
- reasoning: string;
5802
- triggerType: "conversational_feedback";
5803
- confidence: number;
5804
- occurrences: number;
5805
- citations: {
5806
- agentSessionId: string;
5807
- timestamp?: string | undefined;
5808
- summary: string;
5809
- }[];
5810
- source: "claude_code" | "codex" | "opencode" | "cursor" | "copilot" | "other";
5811
- }[];
5812
6010
  skillSuggestions: {
5813
6011
  id: string;
5814
6012
  signal: string;
@@ -5930,6 +6128,17 @@ export declare function parseGuideHistoryResponse(data: unknown): {
5930
6128
  reasoning: string;
5931
6129
  }[];
5932
6130
  findingsOmitted: number;
6131
+ analysis?: {
6132
+ id: string;
6133
+ createdAt: string;
6134
+ outcome: "pattern" | "no_pattern";
6135
+ summary: string;
6136
+ sessionsAnalysed: number;
6137
+ sessionsOmitted: number;
6138
+ stale: boolean;
6139
+ staleReason: "revision_changed" | "new_failures" | null;
6140
+ newFailures: number | null;
6141
+ } | null | undefined;
5933
6142
  untrusted: {
5934
6143
  token: string;
5935
6144
  startMarker: string;
@@ -5960,6 +6169,8 @@ export declare function parseItemCommentsResponse(data: unknown): {
5960
6169
  } | null;
5961
6170
  } | undefined;
5962
6171
  body: string;
6172
+ suggestion?: string | undefined;
6173
+ evidence?: string | undefined;
5963
6174
  authorName: string | null;
5964
6175
  createdAt: string;
5965
6176
  itemVersion: number;
@@ -5976,6 +6187,26 @@ export declare function parseItemCommentsResponse(data: unknown): {
5976
6187
  note: string;
5977
6188
  } | null | undefined;
5978
6189
  };
6190
+ export declare function parseCommentEvidenceResponse(data: unknown): {
6191
+ commentId: string;
6192
+ itemName: string;
6193
+ itemPath: string | null;
6194
+ summary: string;
6195
+ prediction: string | null;
6196
+ citations: {
6197
+ kind: "verdict" | "turn" | "navigation" | "action";
6198
+ sessionId: string;
6199
+ at: string;
6200
+ excerpt: string;
6201
+ }[];
6202
+ citationsWithheld: number;
6203
+ untrusted: {
6204
+ token: string;
6205
+ startMarker: string;
6206
+ endMarker: string;
6207
+ note: string;
6208
+ };
6209
+ };
5979
6210
  export declare function parseRunGradeRequest(data: unknown): {
5980
6211
  session?: string | undefined;
5981
6212
  agent_session?: string | undefined;
@@ -6026,7 +6257,7 @@ export declare function parseSearchResponse(data: unknown): {
6026
6257
  }[];
6027
6258
  } | {
6028
6259
  status: "skipped";
6029
- reason: "excluded-by-caller" | "timed-out";
6260
+ reason: "excluded-by-caller" | "timed-out" | "not-granted";
6030
6261
  };
6031
6262
  verdicts: {
6032
6263
  status: "searched";
@@ -6042,7 +6273,7 @@ export declare function parseSearchResponse(data: unknown): {
6042
6273
  }[];
6043
6274
  } | {
6044
6275
  status: "skipped";
6045
- reason: "excluded-by-caller" | "timed-out";
6276
+ reason: "excluded-by-caller" | "timed-out" | "not-granted";
6046
6277
  };
6047
6278
  };
6048
6279
  notYetSearchable: ("actions" | "findings" | "suggestions" | "feedback-candidates")[];