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

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
@@ -793,6 +793,14 @@ export declare const ResolveSubscriptionsResponseSchema: v.ObjectSchema<{
793
793
  readonly account: v.OptionalSchema<v.ObjectSchema<{
794
794
  readonly deliverGlobalSkills: v.BooleanSchema<undefined>;
795
795
  }, undefined>, undefined>;
796
+ /**
797
+ * True when the caller's token is limited to certain bundles. Such a token
798
+ * resolves only what it was granted, so an id in `unresolved` may be a bundle
799
+ * the account can reach and the token cannot. Said once for the response,
800
+ * never per id, so it confirms nothing about any one bundle. Optional: absent
801
+ * means an ordinary token, and a server that predates it never sends it.
802
+ */
803
+ readonly limitedToken: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
796
804
  }, undefined>;
797
805
  /**
798
806
  * Subscribe the calling account to a bundle it can see, or change the delivery
@@ -1072,6 +1080,19 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
1072
1080
  }, undefined>, undefined>;
1073
1081
  /** The comment's text, already wrapped in the response's untrusted markers. */
1074
1082
  readonly body: v.StringSchema<undefined>;
1083
+ /**
1084
+ * A suggested edit: the replacement for the passage at `passage.lines`,
1085
+ * already wrapped in the response's untrusted markers like `body`. An
1086
+ * insertion is the passage plus its new lines and an empty replacement is a
1087
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
1088
+ */
1089
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1090
+ /**
1091
+ * One line saying what a server-drafted comment was drawn from — counts and
1092
+ * dates, never the cited text. Present only on a comment Mossbear drafted
1093
+ * and the person handed to their agent.
1094
+ */
1095
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1075
1096
  /** The author's display name as the workspace shows it, or null. Never an email. */
1076
1097
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1077
1098
  /** ISO timestamp, machine format. */
@@ -1248,6 +1269,19 @@ export declare const ContextItemSchema: v.ObjectSchema<{
1248
1269
  }, undefined>, undefined>;
1249
1270
  /** The comment's text, already wrapped in the response's untrusted markers. */
1250
1271
  readonly body: v.StringSchema<undefined>;
1272
+ /**
1273
+ * A suggested edit: the replacement for the passage at `passage.lines`,
1274
+ * already wrapped in the response's untrusted markers like `body`. An
1275
+ * insertion is the passage plus its new lines and an empty replacement is a
1276
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
1277
+ */
1278
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1279
+ /**
1280
+ * One line saying what a server-drafted comment was drawn from — counts and
1281
+ * dates, never the cited text. Present only on a comment Mossbear drafted
1282
+ * and the person handed to their agent.
1283
+ */
1284
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1251
1285
  /** The author's display name as the workspace shows it, or null. Never an email. */
1252
1286
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1253
1287
  /** ISO timestamp, machine format. */
@@ -1299,6 +1333,8 @@ export declare const ContextItemSchema: v.ObjectSchema<{
1299
1333
  } | null;
1300
1334
  } | undefined;
1301
1335
  body: string;
1336
+ suggestion?: string | undefined;
1337
+ evidence?: string | undefined;
1302
1338
  authorName: string | null;
1303
1339
  createdAt: string;
1304
1340
  itemVersion: number;
@@ -1466,6 +1502,19 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1466
1502
  }, undefined>, undefined>;
1467
1503
  /** The comment's text, already wrapped in the response's untrusted markers. */
1468
1504
  readonly body: v.StringSchema<undefined>;
1505
+ /**
1506
+ * A suggested edit: the replacement for the passage at `passage.lines`,
1507
+ * already wrapped in the response's untrusted markers like `body`. An
1508
+ * insertion is the passage plus its new lines and an empty replacement is a
1509
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
1510
+ */
1511
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1512
+ /**
1513
+ * One line saying what a server-drafted comment was drawn from — counts and
1514
+ * dates, never the cited text. Present only on a comment Mossbear drafted
1515
+ * and the person handed to their agent.
1516
+ */
1517
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1469
1518
  /** The author's display name as the workspace shows it, or null. Never an email. */
1470
1519
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1471
1520
  /** ISO timestamp, machine format. */
@@ -1517,6 +1566,8 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1517
1566
  } | null;
1518
1567
  } | undefined;
1519
1568
  body: string;
1569
+ suggestion?: string | undefined;
1570
+ evidence?: string | undefined;
1520
1571
  authorName: string | null;
1521
1572
  createdAt: string;
1522
1573
  itemVersion: number;
@@ -1709,6 +1760,19 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
1709
1760
  }, undefined>, undefined>;
1710
1761
  /** The comment's text, already wrapped in the response's untrusted markers. */
1711
1762
  readonly body: v.StringSchema<undefined>;
1763
+ /**
1764
+ * A suggested edit: the replacement for the passage at `passage.lines`,
1765
+ * already wrapped in the response's untrusted markers like `body`. An
1766
+ * insertion is the passage plus its new lines and an empty replacement is a
1767
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
1768
+ */
1769
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1770
+ /**
1771
+ * One line saying what a server-drafted comment was drawn from — counts and
1772
+ * dates, never the cited text. Present only on a comment Mossbear drafted
1773
+ * and the person handed to their agent.
1774
+ */
1775
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1712
1776
  /** The author's display name as the workspace shows it, or null. Never an email. */
1713
1777
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1714
1778
  /** ISO timestamp, machine format. */
@@ -1781,6 +1845,19 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
1781
1845
  }, undefined>, undefined>;
1782
1846
  /** The comment's text, already wrapped in the response's untrusted markers. */
1783
1847
  readonly body: v.StringSchema<undefined>;
1848
+ /**
1849
+ * A suggested edit: the replacement for the passage at `passage.lines`,
1850
+ * already wrapped in the response's untrusted markers like `body`. An
1851
+ * insertion is the passage plus its new lines and an empty replacement is a
1852
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
1853
+ */
1854
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
1855
+ /**
1856
+ * One line saying what a server-drafted comment was drawn from — counts and
1857
+ * dates, never the cited text. Present only on a comment Mossbear drafted
1858
+ * and the person handed to their agent.
1859
+ */
1860
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
1784
1861
  /** The author's display name as the workspace shows it, or null. Never an email. */
1785
1862
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1786
1863
  /** ISO timestamp, machine format. */
@@ -1834,6 +1911,69 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
1834
1911
  }, undefined>, undefined>, undefined>;
1835
1912
  }, undefined>;
1836
1913
  export type ItemCommentsResponse = v.InferOutput<typeof ItemCommentsResponseSchema>;
1914
+ /**
1915
+ * The evidence behind one Mossbear comment an agent was handed
1916
+ * (`GET /api/v1/context/comments/evidence`, `drafted-guide-suggestions` slice 7).
1917
+ *
1918
+ * `list_comments` carries a one-line pointer; this is the envelope it points
1919
+ * at: the summary, the observable change the edit predicts, and the cited
1920
+ * sessions. Readable only through a comment the comment read itself would
1921
+ * deliver to this reader, so an unapproved edit, another person's, or one
1922
+ * drafted from another repo has no evidence here either.
1923
+ *
1924
+ * Citations are reduced to what the reader may see: their own sessions, with a
1925
+ * date and a short excerpt of the grader's reasoning or of their own redacted
1926
+ * correction turn. A `navigation` citation — a skill load counted when a
1927
+ * suggestion was drafted from how the skill's files were read — has an empty
1928
+ * excerpt: it is dated evidence that a session loaded the skill, and nothing
1929
+ * more. `citationsWithheld` counts any that were dropped, so a short
1930
+ * list is never mistaken for the whole of it.
1931
+ */
1932
+ export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
1933
+ /**
1934
+ * `navigation` is a skill load whose reads drafted the suggestion. It carries
1935
+ * no excerpt (an empty string): it is evidence of how a skill was used, not of
1936
+ * a failure.
1937
+ */
1938
+ readonly kind: v.PicklistSchema<["verdict", "turn", "navigation"], undefined>;
1939
+ readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1940
+ /** ISO, when the verdict was graded, the turn was said, or the skill loaded. */
1941
+ readonly at: v.StringSchema<undefined>;
1942
+ /** Wrapped in the response's untrusted markers. */
1943
+ readonly excerpt: v.StringSchema<undefined>;
1944
+ }, undefined>;
1945
+ export type CommentEvidenceCitation = v.InferOutput<typeof CommentEvidenceCitationSchema>;
1946
+ export declare const CommentEvidenceResponseSchema: v.ObjectSchema<{
1947
+ /** The comment's full id, even when the request named a prefix. */
1948
+ readonly commentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1949
+ readonly itemName: v.StringSchema<undefined>;
1950
+ readonly itemPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1951
+ /** Wrapped in the response's untrusted markers. */
1952
+ readonly summary: v.StringSchema<undefined>;
1953
+ /** What future sessions should show if the edit works, wrapped; null if none. */
1954
+ readonly prediction: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1955
+ readonly citations: v.ArraySchema<v.ObjectSchema<{
1956
+ /**
1957
+ * `navigation` is a skill load whose reads drafted the suggestion. It carries
1958
+ * no excerpt (an empty string): it is evidence of how a skill was used, not of
1959
+ * a failure.
1960
+ */
1961
+ readonly kind: v.PicklistSchema<["verdict", "turn", "navigation"], undefined>;
1962
+ readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1963
+ /** ISO, when the verdict was graded, the turn was said, or the skill loaded. */
1964
+ readonly at: v.StringSchema<undefined>;
1965
+ /** Wrapped in the response's untrusted markers. */
1966
+ readonly excerpt: v.StringSchema<undefined>;
1967
+ }, undefined>, undefined>;
1968
+ readonly citationsWithheld: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
1969
+ readonly untrusted: v.ObjectSchema<{
1970
+ readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1971
+ readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1972
+ readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
1973
+ readonly note: v.StringSchema<undefined>;
1974
+ }, undefined>;
1975
+ }, undefined>;
1976
+ export type CommentEvidenceResponse = v.InferOutput<typeof CommentEvidenceResponseSchema>;
1837
1977
  /** Max number of context item ids a push may cite as its transform sources. */
1838
1978
  export declare const MAX_TRANSFORM_SOURCE_IDS = 100;
1839
1979
  /**
@@ -2006,6 +2146,19 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
2006
2146
  }, undefined>, undefined>;
2007
2147
  /** The comment's text, already wrapped in the response's untrusted markers. */
2008
2148
  readonly body: v.StringSchema<undefined>;
2149
+ /**
2150
+ * A suggested edit: the replacement for the passage at `passage.lines`,
2151
+ * already wrapped in the response's untrusted markers like `body`. An
2152
+ * insertion is the passage plus its new lines and an empty replacement is a
2153
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
2154
+ */
2155
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2156
+ /**
2157
+ * One line saying what a server-drafted comment was drawn from — counts and
2158
+ * dates, never the cited text. Present only on a comment Mossbear drafted
2159
+ * and the person handed to their agent.
2160
+ */
2161
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
2009
2162
  /** The author's display name as the workspace shows it, or null. Never an email. */
2010
2163
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2011
2164
  /** ISO timestamp, machine format. */
@@ -2057,6 +2210,8 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
2057
2210
  } | null;
2058
2211
  } | undefined;
2059
2212
  body: string;
2213
+ suggestion?: string | undefined;
2214
+ evidence?: string | undefined;
2060
2215
  authorName: string | null;
2061
2216
  createdAt: string;
2062
2217
  itemVersion: number;
@@ -2313,6 +2468,19 @@ export declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
2313
2468
  }, undefined>, undefined>;
2314
2469
  /** The comment's text, already wrapped in the response's untrusted markers. */
2315
2470
  readonly body: v.StringSchema<undefined>;
2471
+ /**
2472
+ * A suggested edit: the replacement for the passage at `passage.lines`,
2473
+ * already wrapped in the response's untrusted markers like `body`. An
2474
+ * insertion is the passage plus its new lines and an empty replacement is a
2475
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
2476
+ */
2477
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2478
+ /**
2479
+ * One line saying what a server-drafted comment was drawn from — counts and
2480
+ * dates, never the cited text. Present only on a comment Mossbear drafted
2481
+ * and the person handed to their agent.
2482
+ */
2483
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
2316
2484
  /** The author's display name as the workspace shows it, or null. Never an email. */
2317
2485
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2318
2486
  /** ISO timestamp, machine format. */
@@ -2364,6 +2532,8 @@ export declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
2364
2532
  } | null;
2365
2533
  } | undefined;
2366
2534
  body: string;
2535
+ suggestion?: string | undefined;
2536
+ evidence?: string | undefined;
2367
2537
  authorName: string | null;
2368
2538
  createdAt: string;
2369
2539
  itemVersion: number;
@@ -2781,6 +2951,19 @@ export declare const ContextItemResponseSchema: v.ObjectSchema<{
2781
2951
  }, undefined>, undefined>;
2782
2952
  /** The comment's text, already wrapped in the response's untrusted markers. */
2783
2953
  readonly body: v.StringSchema<undefined>;
2954
+ /**
2955
+ * A suggested edit: the replacement for the passage at `passage.lines`,
2956
+ * already wrapped in the response's untrusted markers like `body`. An
2957
+ * insertion is the passage plus its new lines and an empty replacement is a
2958
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
2959
+ */
2960
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
2961
+ /**
2962
+ * One line saying what a server-drafted comment was drawn from — counts and
2963
+ * dates, never the cited text. Present only on a comment Mossbear drafted
2964
+ * and the person handed to their agent.
2965
+ */
2966
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
2784
2967
  /** The author's display name as the workspace shows it, or null. Never an email. */
2785
2968
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2786
2969
  /** ISO timestamp, machine format. */
@@ -2832,6 +3015,8 @@ export declare const ContextItemResponseSchema: v.ObjectSchema<{
2832
3015
  } | null;
2833
3016
  } | undefined;
2834
3017
  body: string;
3018
+ suggestion?: string | undefined;
3019
+ evidence?: string | undefined;
2835
3020
  authorName: string | null;
2836
3021
  createdAt: string;
2837
3022
  itemVersion: number;
@@ -3001,6 +3186,19 @@ export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
3001
3186
  }, undefined>, undefined>;
3002
3187
  /** The comment's text, already wrapped in the response's untrusted markers. */
3003
3188
  readonly body: v.StringSchema<undefined>;
3189
+ /**
3190
+ * A suggested edit: the replacement for the passage at `passage.lines`,
3191
+ * already wrapped in the response's untrusted markers like `body`. An
3192
+ * insertion is the passage plus its new lines and an empty replacement is a
3193
+ * deletion, so every edit is one replace. Absent on an ordinary comment.
3194
+ */
3195
+ readonly suggestion: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
3196
+ /**
3197
+ * One line saying what a server-drafted comment was drawn from — counts and
3198
+ * dates, never the cited text. Present only on a comment Mossbear drafted
3199
+ * and the person handed to their agent.
3200
+ */
3201
+ readonly evidence: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
3004
3202
  /** The author's display name as the workspace shows it, or null. Never an email. */
3005
3203
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
3006
3204
  /** ISO timestamp, machine format. */
@@ -3052,6 +3250,8 @@ export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
3052
3250
  } | null;
3053
3251
  } | undefined;
3054
3252
  body: string;
3253
+ suggestion?: string | undefined;
3254
+ evidence?: string | undefined;
3055
3255
  authorName: string | null;
3056
3256
  createdAt: string;
3057
3257
  itemVersion: number;
@@ -4000,20 +4200,6 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
4000
4200
  */
4001
4201
  readonly origin: v.OptionalSchema<v.PicklistSchema<["session-start"], undefined>, undefined>;
4002
4202
  }, 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
4203
  export declare const ExtractedSkillSuggestionSchema: v.ObjectSchema<{
4018
4204
  readonly id: v.StringSchema<undefined>;
4019
4205
  readonly signal: v.StringSchema<undefined>;
@@ -4027,20 +4213,6 @@ export declare const ExtractedSkillSuggestionSchema: v.ObjectSchema<{
4027
4213
  readonly source: v.PicklistSchema<["claude_code", "codex", "opencode", "cursor", "copilot", "other"], undefined>;
4028
4214
  }, undefined>;
4029
4215
  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
4216
  readonly skillSuggestions: v.ArraySchema<v.ObjectSchema<{
4045
4217
  readonly id: v.StringSchema<undefined>;
4046
4218
  readonly signal: v.StringSchema<undefined>;
@@ -4535,6 +4707,39 @@ export declare const GuideHistoryGuideSchema: v.ObjectSchema<{
4535
4707
  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
4708
  readonly root: v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>;
4537
4709
  }, undefined>;
4710
+ /**
4711
+ * The newest stored failure-pattern analysis of the guide, as the reader's own
4712
+ * dashboard shows it (`drafted-guide-suggestions` slice 7).
4713
+ *
4714
+ * **The caller's own analysis only.** An analysis reads the caller's verdicts,
4715
+ * so a workspace-mate's is never returned, the same rule the verdicts follow.
4716
+ *
4717
+ * **Staleness is derived on read**, exactly as the dashboard derives it: the
4718
+ * guide's wording changed since (`revision_changed`), or failures of the same
4719
+ * wording arrived that it has not read (`new_failures`, with how many). A stale
4720
+ * analysis is still what it found; it is reported, never withheld.
4721
+ *
4722
+ * `summary` arrives wrapped in the response's untrusted markers. It is
4723
+ * model-authored text derived from session transcripts. On `no_pattern` it may
4724
+ * be empty between them, because the dashboard supplies that sentence itself.
4725
+ */
4726
+ export declare const GuideHistoryAnalysisSchema: v.ObjectSchema<{
4727
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4728
+ /** When it was written, ISO. */
4729
+ readonly createdAt: v.StringSchema<undefined>;
4730
+ readonly outcome: v.PicklistSchema<["pattern", "no_pattern"], undefined>;
4731
+ readonly summary: v.StringSchema<undefined>;
4732
+ /** Failed sessions the analysis read. */
4733
+ readonly sessionsAnalysed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
4734
+ /** Failed sessions it left out to stay within its prompt's cap. */
4735
+ readonly sessionsOmitted: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
4736
+ readonly stale: v.BooleanSchema<undefined>;
4737
+ /** Why it is out of date, or null while it is current. */
4738
+ readonly staleReason: v.NullableSchema<v.PicklistSchema<["revision_changed", "new_failures"], undefined>, undefined>;
4739
+ /** Failures it has not read, when `staleReason` is `new_failures`; else null. */
4740
+ readonly newFailures: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
4741
+ }, undefined>;
4742
+ export type GuideHistoryAnalysis = v.InferOutput<typeof GuideHistoryAnalysisSchema>;
4538
4743
  export declare const GuideHistoryResponseSchema: v.ObjectSchema<{
4539
4744
  readonly guide: v.ObjectSchema<{
4540
4745
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -4686,6 +4891,28 @@ export declare const GuideHistoryResponseSchema: v.ObjectSchema<{
4686
4891
  * findings has no other way to know it is reading five of forty.
4687
4892
  */
4688
4893
  readonly findingsOmitted: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
4894
+ /**
4895
+ * The caller's newest stored failure-pattern analysis of this guide, or
4896
+ * **null when they have never asked for one**. Optional because a server
4897
+ * that predates it sends no key; a reader must not take absence for "never
4898
+ * analysed".
4899
+ */
4900
+ readonly analysis: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
4901
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4902
+ /** When it was written, ISO. */
4903
+ readonly createdAt: v.StringSchema<undefined>;
4904
+ readonly outcome: v.PicklistSchema<["pattern", "no_pattern"], undefined>;
4905
+ readonly summary: v.StringSchema<undefined>;
4906
+ /** Failed sessions the analysis read. */
4907
+ readonly sessionsAnalysed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
4908
+ /** Failed sessions it left out to stay within its prompt's cap. */
4909
+ readonly sessionsOmitted: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
4910
+ readonly stale: v.BooleanSchema<undefined>;
4911
+ /** Why it is out of date, or null while it is current. */
4912
+ readonly staleReason: v.NullableSchema<v.PicklistSchema<["revision_changed", "new_failures"], undefined>, undefined>;
4913
+ /** Failures it has not read, when `staleReason` is `new_failures`; else null. */
4914
+ readonly newFailures: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
4915
+ }, undefined>, undefined>, undefined>;
4689
4916
  readonly untrusted: v.ObjectSchema<{
4690
4917
  readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4691
4918
  readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -4901,7 +5128,7 @@ export type SearchRequest = v.InferOutput<typeof SearchRequestSchema>;
4901
5128
  * Why a corpus was not searched. Codes, never prose: each caller writes its own
4902
5129
  * sentence, and the dashboard's has to be a translatable one.
4903
5130
  */
4904
- export declare const SearchSkipReasonSchema: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5131
+ export declare const SearchSkipReasonSchema: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
4905
5132
  export type SearchSkipReason = v.InferOutput<typeof SearchSkipReasonSchema>;
4906
5133
  /** Why a searched corpus covered less than the caller's whole scope. */
4907
5134
  export declare const SearchNarrowingSchema: v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>;
@@ -4985,7 +5212,7 @@ export declare const SearchGuidesReportSchema: v.VariantSchema<"status", [v.Obje
4985
5212
  }, undefined>, undefined>;
4986
5213
  }, undefined>, v.ObjectSchema<{
4987
5214
  readonly status: v.LiteralSchema<"skipped", undefined>;
4988
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5215
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
4989
5216
  }, undefined>], undefined>;
4990
5217
  export declare const SearchVerdictsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
4991
5218
  readonly status: v.LiteralSchema<"searched", undefined>;
@@ -5007,7 +5234,7 @@ export declare const SearchVerdictsReportSchema: v.VariantSchema<"status", [v.Ob
5007
5234
  }, undefined>, undefined>;
5008
5235
  }, undefined>, v.ObjectSchema<{
5009
5236
  readonly status: v.LiteralSchema<"skipped", undefined>;
5010
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5237
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5011
5238
  }, undefined>], undefined>;
5012
5239
  export type SearchGuidesReport = v.InferOutput<typeof SearchGuidesReportSchema>;
5013
5240
  export type SearchVerdictsReport = v.InferOutput<typeof SearchVerdictsReportSchema>;
@@ -5058,7 +5285,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
5058
5285
  }, undefined>, undefined>;
5059
5286
  }, undefined>, v.ObjectSchema<{
5060
5287
  readonly status: v.LiteralSchema<"skipped", undefined>;
5061
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5288
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5062
5289
  }, undefined>], undefined>;
5063
5290
  readonly verdicts: v.VariantSchema<"status", [v.ObjectSchema<{
5064
5291
  readonly status: v.LiteralSchema<"searched", undefined>;
@@ -5080,7 +5307,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
5080
5307
  }, undefined>, undefined>;
5081
5308
  }, undefined>, v.ObjectSchema<{
5082
5309
  readonly status: v.LiteralSchema<"skipped", undefined>;
5083
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5310
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5084
5311
  }, undefined>], undefined>;
5085
5312
  }, undefined>;
5086
5313
  readonly notYetSearchable: v.ArraySchema<v.PicklistSchema<readonly ["findings", "actions", "suggestions", "feedback-candidates"], undefined>, undefined>;
@@ -5250,6 +5477,7 @@ export declare function parseResolveSubscriptionsResponse(data: unknown): {
5250
5477
  account?: {
5251
5478
  deliverGlobalSkills: boolean;
5252
5479
  } | undefined;
5480
+ limitedToken?: boolean | undefined;
5253
5481
  };
5254
5482
  export declare function parseUpdateBundleRequest(data: unknown): {
5255
5483
  name?: string | undefined;
@@ -5297,6 +5525,8 @@ export declare function parseContextItem(data: unknown): {
5297
5525
  } | null;
5298
5526
  } | undefined;
5299
5527
  body: string;
5528
+ suggestion?: string | undefined;
5529
+ evidence?: string | undefined;
5300
5530
  authorName: string | null;
5301
5531
  createdAt: string;
5302
5532
  itemVersion: number;
@@ -5344,6 +5574,8 @@ export declare function parseContextItemsResponse(data: unknown): {
5344
5574
  } | null;
5345
5575
  } | undefined;
5346
5576
  body: string;
5577
+ suggestion?: string | undefined;
5578
+ evidence?: string | undefined;
5347
5579
  authorName: string | null;
5348
5580
  createdAt: string;
5349
5581
  itemVersion: number;
@@ -5413,6 +5645,8 @@ export declare function parsePushContextResponse(data: unknown): {
5413
5645
  } | null;
5414
5646
  } | undefined;
5415
5647
  body: string;
5648
+ suggestion?: string | undefined;
5649
+ evidence?: string | undefined;
5416
5650
  authorName: string | null;
5417
5651
  createdAt: string;
5418
5652
  itemVersion: number;
@@ -5477,6 +5711,8 @@ export declare function parseUpdateContextItemResponse(data: unknown): {
5477
5711
  } | null;
5478
5712
  } | undefined;
5479
5713
  body: string;
5714
+ suggestion?: string | undefined;
5715
+ evidence?: string | undefined;
5480
5716
  authorName: string | null;
5481
5717
  createdAt: string;
5482
5718
  itemVersion: number;
@@ -5540,6 +5776,8 @@ export declare function parseContextItemResponse(data: unknown): {
5540
5776
  } | null;
5541
5777
  } | undefined;
5542
5778
  body: string;
5779
+ suggestion?: string | undefined;
5780
+ evidence?: string | undefined;
5543
5781
  authorName: string | null;
5544
5782
  createdAt: string;
5545
5783
  itemVersion: number;
@@ -5589,6 +5827,8 @@ export declare function parseArchiveContextItemResponse(data: unknown): {
5589
5827
  } | null;
5590
5828
  } | undefined;
5591
5829
  body: string;
5830
+ suggestion?: string | undefined;
5831
+ evidence?: string | undefined;
5592
5832
  authorName: string | null;
5593
5833
  createdAt: string;
5594
5834
  itemVersion: number;
@@ -5768,20 +6008,6 @@ export declare function parseProposalCitation(data: unknown): {
5768
6008
  timestamp?: string | undefined;
5769
6009
  summary: string;
5770
6010
  };
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
6011
  export declare function parseExtractedSkillSuggestion(data: unknown): {
5786
6012
  id: string;
5787
6013
  signal: string;
@@ -5795,20 +6021,6 @@ export declare function parseExtractedSkillSuggestion(data: unknown): {
5795
6021
  source: "claude_code" | "codex" | "opencode" | "cursor" | "copilot" | "other";
5796
6022
  };
5797
6023
  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
6024
  skillSuggestions: {
5813
6025
  id: string;
5814
6026
  signal: string;
@@ -5930,6 +6142,17 @@ export declare function parseGuideHistoryResponse(data: unknown): {
5930
6142
  reasoning: string;
5931
6143
  }[];
5932
6144
  findingsOmitted: number;
6145
+ analysis?: {
6146
+ id: string;
6147
+ createdAt: string;
6148
+ outcome: "pattern" | "no_pattern";
6149
+ summary: string;
6150
+ sessionsAnalysed: number;
6151
+ sessionsOmitted: number;
6152
+ stale: boolean;
6153
+ staleReason: "revision_changed" | "new_failures" | null;
6154
+ newFailures: number | null;
6155
+ } | null | undefined;
5933
6156
  untrusted: {
5934
6157
  token: string;
5935
6158
  startMarker: string;
@@ -5960,6 +6183,8 @@ export declare function parseItemCommentsResponse(data: unknown): {
5960
6183
  } | null;
5961
6184
  } | undefined;
5962
6185
  body: string;
6186
+ suggestion?: string | undefined;
6187
+ evidence?: string | undefined;
5963
6188
  authorName: string | null;
5964
6189
  createdAt: string;
5965
6190
  itemVersion: number;
@@ -5976,6 +6201,26 @@ export declare function parseItemCommentsResponse(data: unknown): {
5976
6201
  note: string;
5977
6202
  } | null | undefined;
5978
6203
  };
6204
+ export declare function parseCommentEvidenceResponse(data: unknown): {
6205
+ commentId: string;
6206
+ itemName: string;
6207
+ itemPath: string | null;
6208
+ summary: string;
6209
+ prediction: string | null;
6210
+ citations: {
6211
+ kind: "verdict" | "turn" | "navigation";
6212
+ sessionId: string;
6213
+ at: string;
6214
+ excerpt: string;
6215
+ }[];
6216
+ citationsWithheld: number;
6217
+ untrusted: {
6218
+ token: string;
6219
+ startMarker: string;
6220
+ endMarker: string;
6221
+ note: string;
6222
+ };
6223
+ };
5979
6224
  export declare function parseRunGradeRequest(data: unknown): {
5980
6225
  session?: string | undefined;
5981
6226
  agent_session?: string | undefined;
@@ -6026,7 +6271,7 @@ export declare function parseSearchResponse(data: unknown): {
6026
6271
  }[];
6027
6272
  } | {
6028
6273
  status: "skipped";
6029
- reason: "excluded-by-caller" | "timed-out";
6274
+ reason: "excluded-by-caller" | "timed-out" | "not-granted";
6030
6275
  };
6031
6276
  verdicts: {
6032
6277
  status: "searched";
@@ -6042,7 +6287,7 @@ export declare function parseSearchResponse(data: unknown): {
6042
6287
  }[];
6043
6288
  } | {
6044
6289
  status: "skipped";
6045
- reason: "excluded-by-caller" | "timed-out";
6290
+ reason: "excluded-by-caller" | "timed-out" | "not-granted";
6046
6291
  };
6047
6292
  };
6048
6293
  notYetSearchable: ("actions" | "findings" | "suggestions" | "feedback-candidates")[];