@mossbear/protocol 0.1.0-alpha.69 → 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
@@ -56,6 +56,25 @@ export declare const PlatformKindSchema: v.PicklistSchema<["claude_code", "codex
56
56
  */
57
57
  export declare const HarnessIdSchema: v.PicklistSchema<["claude_code", "codex", "antigravity", "opencode"], undefined>;
58
58
  export type HarnessId = v.InferOutput<typeof HarnessIdSchema>;
59
+ /**
60
+ * Where a session ran, recorded only when the hook can see it ran in a cloud
61
+ * container: a claude.ai/code session, a Codespace, a CI runner.
62
+ *
63
+ * **There is no `local`.** Nothing positively marks a laptop. "Not one of the
64
+ * clouds we recognize" is only an inference, and it would mislabel any cloud
65
+ * platform the CLI has no marker for yet. So the stamp is either present and
66
+ * `cloud`, or absent, and absent means "not known to be cloud". It never means
67
+ * "local".
68
+ *
69
+ * A picklist rather than a boolean, so a later member (a specific platform)
70
+ * widens a vocabulary instead of replacing a field. Widening follows the
71
+ * `harness` rule: the server is deployed first.
72
+ *
73
+ * Rides `metadata.environment` on each action (see {@link ActionMetadataSchema}).
74
+ * The server writes `cloud` onto a session when any of its actions carry it.
75
+ */
76
+ export declare const SessionEnvironmentSchema: v.PicklistSchema<["cloud"], undefined>;
77
+ export type SessionEnvironment = v.InferOutput<typeof SessionEnvironmentSchema>;
59
78
  export declare const GuideFileFormatSchema: v.PicklistSchema<["agents-md", "agents-dir", "claude-md", "claude-rules", "cursorrules", "cursor-rules", "skill-md"], undefined>;
60
79
  /** Max serialized size (UTF-8 bytes) of an imported guide file's raw content. */
61
80
  export declare const MAX_RAW_GUIDE_CONTENT_BYTES: number;
@@ -774,6 +793,14 @@ export declare const ResolveSubscriptionsResponseSchema: v.ObjectSchema<{
774
793
  readonly account: v.OptionalSchema<v.ObjectSchema<{
775
794
  readonly deliverGlobalSkills: v.BooleanSchema<undefined>;
776
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>;
777
804
  }, undefined>;
778
805
  /**
779
806
  * Subscribe the calling account to a bundle it can see, or change the delivery
@@ -1053,6 +1080,19 @@ export declare const ContextItemCommentSchema: v.ObjectSchema<{
1053
1080
  }, undefined>, undefined>;
1054
1081
  /** The comment's text, already wrapped in the response's untrusted markers. */
1055
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>;
1056
1096
  /** The author's display name as the workspace shows it, or null. Never an email. */
1057
1097
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1058
1098
  /** ISO timestamp, machine format. */
@@ -1229,6 +1269,19 @@ export declare const ContextItemSchema: v.ObjectSchema<{
1229
1269
  }, undefined>, undefined>;
1230
1270
  /** The comment's text, already wrapped in the response's untrusted markers. */
1231
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>;
1232
1285
  /** The author's display name as the workspace shows it, or null. Never an email. */
1233
1286
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1234
1287
  /** ISO timestamp, machine format. */
@@ -1280,6 +1333,8 @@ export declare const ContextItemSchema: v.ObjectSchema<{
1280
1333
  } | null;
1281
1334
  } | undefined;
1282
1335
  body: string;
1336
+ suggestion?: string | undefined;
1337
+ evidence?: string | undefined;
1283
1338
  authorName: string | null;
1284
1339
  createdAt: string;
1285
1340
  itemVersion: number;
@@ -1447,6 +1502,19 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1447
1502
  }, undefined>, undefined>;
1448
1503
  /** The comment's text, already wrapped in the response's untrusted markers. */
1449
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>;
1450
1518
  /** The author's display name as the workspace shows it, or null. Never an email. */
1451
1519
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1452
1520
  /** ISO timestamp, machine format. */
@@ -1498,6 +1566,8 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1498
1566
  } | null;
1499
1567
  } | undefined;
1500
1568
  body: string;
1569
+ suggestion?: string | undefined;
1570
+ evidence?: string | undefined;
1501
1571
  authorName: string | null;
1502
1572
  createdAt: string;
1503
1573
  itemVersion: number;
@@ -1690,6 +1760,19 @@ export declare const ItemCommentWithSubjectSchema: v.ObjectSchema<{
1690
1760
  }, undefined>, undefined>;
1691
1761
  /** The comment's text, already wrapped in the response's untrusted markers. */
1692
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>;
1693
1776
  /** The author's display name as the workspace shows it, or null. Never an email. */
1694
1777
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1695
1778
  /** ISO timestamp, machine format. */
@@ -1762,6 +1845,19 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
1762
1845
  }, undefined>, undefined>;
1763
1846
  /** The comment's text, already wrapped in the response's untrusted markers. */
1764
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>;
1765
1861
  /** The author's display name as the workspace shows it, or null. Never an email. */
1766
1862
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1767
1863
  /** ISO timestamp, machine format. */
@@ -1815,6 +1911,69 @@ export declare const ItemCommentsResponseSchema: v.ObjectSchema<{
1815
1911
  }, undefined>, undefined>, undefined>;
1816
1912
  }, undefined>;
1817
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>;
1818
1977
  /** Max number of context item ids a push may cite as its transform sources. */
1819
1978
  export declare const MAX_TRANSFORM_SOURCE_IDS = 100;
1820
1979
  /**
@@ -1987,6 +2146,19 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
1987
2146
  }, undefined>, undefined>;
1988
2147
  /** The comment's text, already wrapped in the response's untrusted markers. */
1989
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>;
1990
2162
  /** The author's display name as the workspace shows it, or null. Never an email. */
1991
2163
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
1992
2164
  /** ISO timestamp, machine format. */
@@ -2038,6 +2210,8 @@ export declare const PushContextResponseSchema: v.ObjectSchema<{
2038
2210
  } | null;
2039
2211
  } | undefined;
2040
2212
  body: string;
2213
+ suggestion?: string | undefined;
2214
+ evidence?: string | undefined;
2041
2215
  authorName: string | null;
2042
2216
  createdAt: string;
2043
2217
  itemVersion: number;
@@ -2294,6 +2468,19 @@ export declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
2294
2468
  }, undefined>, undefined>;
2295
2469
  /** The comment's text, already wrapped in the response's untrusted markers. */
2296
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>;
2297
2484
  /** The author's display name as the workspace shows it, or null. Never an email. */
2298
2485
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2299
2486
  /** ISO timestamp, machine format. */
@@ -2345,6 +2532,8 @@ export declare const UpdateContextItemResponseSchema: v.ObjectSchema<{
2345
2532
  } | null;
2346
2533
  } | undefined;
2347
2534
  body: string;
2535
+ suggestion?: string | undefined;
2536
+ evidence?: string | undefined;
2348
2537
  authorName: string | null;
2349
2538
  createdAt: string;
2350
2539
  itemVersion: number;
@@ -2762,6 +2951,19 @@ export declare const ContextItemResponseSchema: v.ObjectSchema<{
2762
2951
  }, undefined>, undefined>;
2763
2952
  /** The comment's text, already wrapped in the response's untrusted markers. */
2764
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>;
2765
2967
  /** The author's display name as the workspace shows it, or null. Never an email. */
2766
2968
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2767
2969
  /** ISO timestamp, machine format. */
@@ -2813,6 +3015,8 @@ export declare const ContextItemResponseSchema: v.ObjectSchema<{
2813
3015
  } | null;
2814
3016
  } | undefined;
2815
3017
  body: string;
3018
+ suggestion?: string | undefined;
3019
+ evidence?: string | undefined;
2816
3020
  authorName: string | null;
2817
3021
  createdAt: string;
2818
3022
  itemVersion: number;
@@ -2982,6 +3186,19 @@ export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
2982
3186
  }, undefined>, undefined>;
2983
3187
  /** The comment's text, already wrapped in the response's untrusted markers. */
2984
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>;
2985
3202
  /** The author's display name as the workspace shows it, or null. Never an email. */
2986
3203
  readonly authorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
2987
3204
  /** ISO timestamp, machine format. */
@@ -3033,6 +3250,8 @@ export declare const ArchiveContextItemResponseSchema: v.ObjectSchema<{
3033
3250
  } | null;
3034
3251
  } | undefined;
3035
3252
  body: string;
3253
+ suggestion?: string | undefined;
3254
+ evidence?: string | undefined;
3036
3255
  authorName: string | null;
3037
3256
  createdAt: string;
3038
3257
  itemVersion: number;
@@ -3436,6 +3655,8 @@ export declare const DashboardSyncActionSchema: v.ObjectSchema<{
3436
3655
  [x: string]: unknown;
3437
3656
  }, "metadata.harness must be a known harness id">, v.CheckAction<{
3438
3657
  [x: string]: unknown;
3658
+ }, "metadata.environment must be cloud">, v.CheckAction<{
3659
+ [x: string]: unknown;
3439
3660
  }, "metadata.outcome must be { status: \"ok\" | \"error\", errorClass?: string, exitCode?: number } with no other keys">]>, undefined>, undefined>;
3440
3661
  /**
3441
3662
  * Transcript evidence for this action. See {@link ActionNarrationSchema}.
@@ -3709,6 +3930,8 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
3709
3930
  [x: string]: unknown;
3710
3931
  }, "metadata.harness must be a known harness id">, v.CheckAction<{
3711
3932
  [x: string]: unknown;
3933
+ }, "metadata.environment must be cloud">, v.CheckAction<{
3934
+ [x: string]: unknown;
3712
3935
  }, "metadata.outcome must be { status: \"ok\" | \"error\", errorClass?: string, exitCode?: number } with no other keys">]>, undefined>, undefined>;
3713
3936
  /**
3714
3937
  * Transcript evidence for this action. See {@link ActionNarrationSchema}.
@@ -3977,20 +4200,6 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
3977
4200
  */
3978
4201
  readonly origin: v.OptionalSchema<v.PicklistSchema<["session-start"], undefined>, undefined>;
3979
4202
  }, undefined>;
3980
- export declare const ExtractedGuideSuggestionSchema: v.ObjectSchema<{
3981
- readonly id: v.StringSchema<undefined>;
3982
- readonly content: v.StringSchema<undefined>;
3983
- readonly reasoning: v.StringSchema<undefined>;
3984
- readonly triggerType: v.PicklistSchema<["conversational_feedback"], undefined>;
3985
- readonly confidence: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
3986
- readonly occurrences: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
3987
- readonly citations: v.ArraySchema<v.ObjectSchema<{
3988
- readonly agentSessionId: v.StringSchema<undefined>;
3989
- readonly timestamp: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
3990
- readonly summary: v.StringSchema<undefined>;
3991
- }, undefined>, undefined>;
3992
- readonly source: v.PicklistSchema<["claude_code", "codex", "opencode", "cursor", "copilot", "other"], undefined>;
3993
- }, undefined>;
3994
4203
  export declare const ExtractedSkillSuggestionSchema: v.ObjectSchema<{
3995
4204
  readonly id: v.StringSchema<undefined>;
3996
4205
  readonly signal: v.StringSchema<undefined>;
@@ -4004,20 +4213,6 @@ export declare const ExtractedSkillSuggestionSchema: v.ObjectSchema<{
4004
4213
  readonly source: v.PicklistSchema<["claude_code", "codex", "opencode", "cursor", "copilot", "other"], undefined>;
4005
4214
  }, undefined>;
4006
4215
  export declare const ExtractedFeedbackBatchSchema: v.ObjectSchema<{
4007
- readonly guideSuggestions: v.ArraySchema<v.ObjectSchema<{
4008
- readonly id: v.StringSchema<undefined>;
4009
- readonly content: v.StringSchema<undefined>;
4010
- readonly reasoning: v.StringSchema<undefined>;
4011
- readonly triggerType: v.PicklistSchema<["conversational_feedback"], undefined>;
4012
- readonly confidence: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
4013
- readonly occurrences: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4014
- readonly citations: v.ArraySchema<v.ObjectSchema<{
4015
- readonly agentSessionId: v.StringSchema<undefined>;
4016
- readonly timestamp: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
4017
- readonly summary: v.StringSchema<undefined>;
4018
- }, undefined>, undefined>;
4019
- readonly source: v.PicklistSchema<["claude_code", "codex", "opencode", "cursor", "copilot", "other"], undefined>;
4020
- }, undefined>, undefined>;
4021
4216
  readonly skillSuggestions: v.ArraySchema<v.ObjectSchema<{
4022
4217
  readonly id: v.StringSchema<undefined>;
4023
4218
  readonly signal: v.StringSchema<undefined>;
@@ -4139,6 +4334,12 @@ export declare const ActionEntrySchema: v.ObjectSchema<{
4139
4334
  * silently, for exactly the multi-harness user this field exists for.
4140
4335
  */
4141
4336
  readonly harness: v.OptionalSchema<v.PicklistSchema<["claude_code", "codex", "antigravity", "opencode"], undefined>, undefined>;
4337
+ /**
4338
+ * `cloud` when the hook saw a cloud marker in its own process environment;
4339
+ * see {@link SessionEnvironmentSchema}. Absent otherwise, and absent never
4340
+ * means local.
4341
+ */
4342
+ readonly environment: v.OptionalSchema<v.PicklistSchema<["cloud"], undefined>, undefined>;
4142
4343
  /**
4143
4344
  * Whether the tool call succeeded, when the hook could tell.
4144
4345
  *
@@ -4506,6 +4707,39 @@ export declare const GuideHistoryGuideSchema: v.ObjectSchema<{
4506
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>;
4507
4708
  readonly root: v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>;
4508
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>;
4509
4743
  export declare const GuideHistoryResponseSchema: v.ObjectSchema<{
4510
4744
  readonly guide: v.ObjectSchema<{
4511
4745
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -4657,6 +4891,28 @@ export declare const GuideHistoryResponseSchema: v.ObjectSchema<{
4657
4891
  * findings has no other way to know it is reading five of forty.
4658
4892
  */
4659
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>;
4660
4916
  readonly untrusted: v.ObjectSchema<{
4661
4917
  readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4662
4918
  readonly startMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -4872,7 +5128,7 @@ export type SearchRequest = v.InferOutput<typeof SearchRequestSchema>;
4872
5128
  * Why a corpus was not searched. Codes, never prose: each caller writes its own
4873
5129
  * sentence, and the dashboard's has to be a translatable one.
4874
5130
  */
4875
- 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>;
4876
5132
  export type SearchSkipReason = v.InferOutput<typeof SearchSkipReasonSchema>;
4877
5133
  /** Why a searched corpus covered less than the caller's whole scope. */
4878
5134
  export declare const SearchNarrowingSchema: v.PicklistSchema<["narrowed-by-bundle-allowlist"], undefined>;
@@ -4956,7 +5212,7 @@ export declare const SearchGuidesReportSchema: v.VariantSchema<"status", [v.Obje
4956
5212
  }, undefined>, undefined>;
4957
5213
  }, undefined>, v.ObjectSchema<{
4958
5214
  readonly status: v.LiteralSchema<"skipped", undefined>;
4959
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5215
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
4960
5216
  }, undefined>], undefined>;
4961
5217
  export declare const SearchVerdictsReportSchema: v.VariantSchema<"status", [v.ObjectSchema<{
4962
5218
  readonly status: v.LiteralSchema<"searched", undefined>;
@@ -4978,7 +5234,7 @@ export declare const SearchVerdictsReportSchema: v.VariantSchema<"status", [v.Ob
4978
5234
  }, undefined>, undefined>;
4979
5235
  }, undefined>, v.ObjectSchema<{
4980
5236
  readonly status: v.LiteralSchema<"skipped", undefined>;
4981
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5237
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
4982
5238
  }, undefined>], undefined>;
4983
5239
  export type SearchGuidesReport = v.InferOutput<typeof SearchGuidesReportSchema>;
4984
5240
  export type SearchVerdictsReport = v.InferOutput<typeof SearchVerdictsReportSchema>;
@@ -5029,7 +5285,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
5029
5285
  }, undefined>, undefined>;
5030
5286
  }, undefined>, v.ObjectSchema<{
5031
5287
  readonly status: v.LiteralSchema<"skipped", undefined>;
5032
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5288
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5033
5289
  }, undefined>], undefined>;
5034
5290
  readonly verdicts: v.VariantSchema<"status", [v.ObjectSchema<{
5035
5291
  readonly status: v.LiteralSchema<"searched", undefined>;
@@ -5051,7 +5307,7 @@ export declare const SearchResponseSchema: v.ObjectSchema<{
5051
5307
  }, undefined>, undefined>;
5052
5308
  }, undefined>, v.ObjectSchema<{
5053
5309
  readonly status: v.LiteralSchema<"skipped", undefined>;
5054
- readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out"], undefined>;
5310
+ readonly reason: v.PicklistSchema<["excluded-by-caller", "timed-out", "not-granted"], undefined>;
5055
5311
  }, undefined>], undefined>;
5056
5312
  }, undefined>;
5057
5313
  readonly notYetSearchable: v.ArraySchema<v.PicklistSchema<readonly ["findings", "actions", "suggestions", "feedback-candidates"], undefined>, undefined>;
@@ -5221,6 +5477,7 @@ export declare function parseResolveSubscriptionsResponse(data: unknown): {
5221
5477
  account?: {
5222
5478
  deliverGlobalSkills: boolean;
5223
5479
  } | undefined;
5480
+ limitedToken?: boolean | undefined;
5224
5481
  };
5225
5482
  export declare function parseUpdateBundleRequest(data: unknown): {
5226
5483
  name?: string | undefined;
@@ -5268,6 +5525,8 @@ export declare function parseContextItem(data: unknown): {
5268
5525
  } | null;
5269
5526
  } | undefined;
5270
5527
  body: string;
5528
+ suggestion?: string | undefined;
5529
+ evidence?: string | undefined;
5271
5530
  authorName: string | null;
5272
5531
  createdAt: string;
5273
5532
  itemVersion: number;
@@ -5315,6 +5574,8 @@ export declare function parseContextItemsResponse(data: unknown): {
5315
5574
  } | null;
5316
5575
  } | undefined;
5317
5576
  body: string;
5577
+ suggestion?: string | undefined;
5578
+ evidence?: string | undefined;
5318
5579
  authorName: string | null;
5319
5580
  createdAt: string;
5320
5581
  itemVersion: number;
@@ -5384,6 +5645,8 @@ export declare function parsePushContextResponse(data: unknown): {
5384
5645
  } | null;
5385
5646
  } | undefined;
5386
5647
  body: string;
5648
+ suggestion?: string | undefined;
5649
+ evidence?: string | undefined;
5387
5650
  authorName: string | null;
5388
5651
  createdAt: string;
5389
5652
  itemVersion: number;
@@ -5448,6 +5711,8 @@ export declare function parseUpdateContextItemResponse(data: unknown): {
5448
5711
  } | null;
5449
5712
  } | undefined;
5450
5713
  body: string;
5714
+ suggestion?: string | undefined;
5715
+ evidence?: string | undefined;
5451
5716
  authorName: string | null;
5452
5717
  createdAt: string;
5453
5718
  itemVersion: number;
@@ -5511,6 +5776,8 @@ export declare function parseContextItemResponse(data: unknown): {
5511
5776
  } | null;
5512
5777
  } | undefined;
5513
5778
  body: string;
5779
+ suggestion?: string | undefined;
5780
+ evidence?: string | undefined;
5514
5781
  authorName: string | null;
5515
5782
  createdAt: string;
5516
5783
  itemVersion: number;
@@ -5560,6 +5827,8 @@ export declare function parseArchiveContextItemResponse(data: unknown): {
5560
5827
  } | null;
5561
5828
  } | undefined;
5562
5829
  body: string;
5830
+ suggestion?: string | undefined;
5831
+ evidence?: string | undefined;
5563
5832
  authorName: string | null;
5564
5833
  createdAt: string;
5565
5834
  itemVersion: number;
@@ -5739,20 +6008,6 @@ export declare function parseProposalCitation(data: unknown): {
5739
6008
  timestamp?: string | undefined;
5740
6009
  summary: string;
5741
6010
  };
5742
- export declare function parseExtractedGuideSuggestion(data: unknown): {
5743
- id: string;
5744
- content: string;
5745
- reasoning: string;
5746
- triggerType: "conversational_feedback";
5747
- confidence: number;
5748
- occurrences: number;
5749
- citations: {
5750
- agentSessionId: string;
5751
- timestamp?: string | undefined;
5752
- summary: string;
5753
- }[];
5754
- source: "claude_code" | "codex" | "opencode" | "cursor" | "copilot" | "other";
5755
- };
5756
6011
  export declare function parseExtractedSkillSuggestion(data: unknown): {
5757
6012
  id: string;
5758
6013
  signal: string;
@@ -5766,20 +6021,6 @@ export declare function parseExtractedSkillSuggestion(data: unknown): {
5766
6021
  source: "claude_code" | "codex" | "opencode" | "cursor" | "copilot" | "other";
5767
6022
  };
5768
6023
  export declare function parseExtractedFeedbackBatch(data: unknown): {
5769
- guideSuggestions: {
5770
- id: string;
5771
- content: string;
5772
- reasoning: string;
5773
- triggerType: "conversational_feedback";
5774
- confidence: number;
5775
- occurrences: number;
5776
- citations: {
5777
- agentSessionId: string;
5778
- timestamp?: string | undefined;
5779
- summary: string;
5780
- }[];
5781
- source: "claude_code" | "codex" | "opencode" | "cursor" | "copilot" | "other";
5782
- }[];
5783
6024
  skillSuggestions: {
5784
6025
  id: string;
5785
6026
  signal: string;
@@ -5812,6 +6053,7 @@ export declare function parseActionEntry(data: unknown): {
5812
6053
  repoId?: string | undefined;
5813
6054
  projectId?: string | undefined;
5814
6055
  harness?: "claude_code" | "codex" | "opencode" | "antigravity" | undefined;
6056
+ environment?: "cloud" | undefined;
5815
6057
  outcome?: {
5816
6058
  status: "ok" | "error";
5817
6059
  errorClass?: string | undefined;
@@ -5900,6 +6142,17 @@ export declare function parseGuideHistoryResponse(data: unknown): {
5900
6142
  reasoning: string;
5901
6143
  }[];
5902
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;
5903
6156
  untrusted: {
5904
6157
  token: string;
5905
6158
  startMarker: string;
@@ -5930,6 +6183,8 @@ export declare function parseItemCommentsResponse(data: unknown): {
5930
6183
  } | null;
5931
6184
  } | undefined;
5932
6185
  body: string;
6186
+ suggestion?: string | undefined;
6187
+ evidence?: string | undefined;
5933
6188
  authorName: string | null;
5934
6189
  createdAt: string;
5935
6190
  itemVersion: number;
@@ -5946,6 +6201,26 @@ export declare function parseItemCommentsResponse(data: unknown): {
5946
6201
  note: string;
5947
6202
  } | null | undefined;
5948
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
+ };
5949
6224
  export declare function parseRunGradeRequest(data: unknown): {
5950
6225
  session?: string | undefined;
5951
6226
  agent_session?: string | undefined;
@@ -5996,7 +6271,7 @@ export declare function parseSearchResponse(data: unknown): {
5996
6271
  }[];
5997
6272
  } | {
5998
6273
  status: "skipped";
5999
- reason: "excluded-by-caller" | "timed-out";
6274
+ reason: "excluded-by-caller" | "timed-out" | "not-granted";
6000
6275
  };
6001
6276
  verdicts: {
6002
6277
  status: "searched";
@@ -6012,7 +6287,7 @@ export declare function parseSearchResponse(data: unknown): {
6012
6287
  }[];
6013
6288
  } | {
6014
6289
  status: "skipped";
6015
- reason: "excluded-by-caller" | "timed-out";
6290
+ reason: "excluded-by-caller" | "timed-out" | "not-granted";
6016
6291
  };
6017
6292
  };
6018
6293
  notYetSearchable: ("actions" | "findings" | "suggestions" | "feedback-candidates")[];