@mossbear/protocol 0.1.0-alpha.101 → 0.1.0-alpha.103

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.
Files changed (53) hide show
  1. package/dist/artifact.test.js +28 -1
  2. package/dist/artifact.test.js.map +1 -1
  3. package/dist/commentAnchor.d.ts +9 -0
  4. package/dist/commentAnchor.d.ts.map +1 -1
  5. package/dist/commentAnchor.js +9 -0
  6. package/dist/commentAnchor.js.map +1 -1
  7. package/dist/datasets.d.ts +322 -0
  8. package/dist/datasets.d.ts.map +1 -0
  9. package/dist/datasets.js +290 -0
  10. package/dist/datasets.js.map +1 -0
  11. package/dist/datasets.test.d.ts +2 -0
  12. package/dist/datasets.test.d.ts.map +1 -0
  13. package/dist/datasets.test.js +77 -0
  14. package/dist/datasets.test.js.map +1 -0
  15. package/dist/frameDocument.d.ts +18 -5
  16. package/dist/frameDocument.d.ts.map +1 -1
  17. package/dist/frameDocument.js +24 -5
  18. package/dist/frameDocument.js.map +1 -1
  19. package/dist/frameDocument.test.js +31 -0
  20. package/dist/frameDocument.test.js.map +1 -1
  21. package/dist/frameProtocol.d.ts +7 -0
  22. package/dist/frameProtocol.d.ts.map +1 -1
  23. package/dist/frameProtocol.js +7 -0
  24. package/dist/frameProtocol.js.map +1 -1
  25. package/dist/frameRuntime.d.ts +84 -0
  26. package/dist/frameRuntime.d.ts.map +1 -0
  27. package/dist/frameRuntime.js +141 -0
  28. package/dist/frameRuntime.js.map +1 -0
  29. package/dist/frameRuntime.test.d.ts +2 -0
  30. package/dist/frameRuntime.test.d.ts.map +1 -0
  31. package/dist/frameRuntime.test.js +165 -0
  32. package/dist/frameRuntime.test.js.map +1 -0
  33. package/dist/index.d.ts +2 -0
  34. package/dist/index.d.ts.map +1 -1
  35. package/dist/index.js +2 -0
  36. package/dist/index.js.map +1 -1
  37. package/dist/photos.d.ts +6 -0
  38. package/dist/photos.d.ts.map +1 -1
  39. package/dist/photos.js +6 -0
  40. package/dist/photos.js.map +1 -1
  41. package/dist/schemas.d.ts +210 -7
  42. package/dist/schemas.d.ts.map +1 -1
  43. package/dist/schemas.js +124 -4
  44. package/dist/schemas.js.map +1 -1
  45. package/dist/schemas.test.js +9 -0
  46. package/dist/schemas.test.js.map +1 -1
  47. package/dist/types.d.ts +3 -1
  48. package/dist/types.d.ts.map +1 -1
  49. package/dist/types.js.map +1 -1
  50. package/dist/whatSyncs.d.ts.map +1 -1
  51. package/dist/whatSyncs.js +4 -0
  52. package/dist/whatSyncs.js.map +1 -1
  53. package/package.json +5 -1
package/dist/schemas.d.ts CHANGED
@@ -56,6 +56,24 @@ export type HarnessId = v.InferOutput<typeof HarnessIdSchema>;
56
56
  */
57
57
  export declare const SessionEnvironmentSchema: v.PicklistSchema<["cloud"], undefined>;
58
58
  export type SessionEnvironment = v.InferOutput<typeof SessionEnvironmentSchema>;
59
+ /** Longest accepted repository name. An `owner/repo` path is far shorter; this bounds a folder name. */
60
+ export declare const MAX_REPOSITORY_NAME_LENGTH = 200;
61
+ /**
62
+ * The name of the repository a session ran in, as a person would recognise it:
63
+ * the `owner/repo` path of the checkout's git remote, or the checkout's folder
64
+ * name when it has no remote the CLI can read a path from.
65
+ *
66
+ * A display name, not an identity. Two forks share a name, and a folder name
67
+ * says nothing beyond itself; `projectId` and `repoId` stay the keys a reader
68
+ * joins on. The CLI keeps only the path of a remote: never its scheme,
69
+ * credentials, host, port or query, so a URL carrying a token does not leave
70
+ * the machine.
71
+ *
72
+ * Rides `metadata.repository` on each action (see {@link ActionMetadataSchema}).
73
+ * The server reduces a session's stamps to one value; absent is "unnamed",
74
+ * which is every session a CLI predating the field recorded.
75
+ */
76
+ export declare const RepositoryNameSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>;
59
77
  export declare const GuideFileFormatSchema: v.PicklistSchema<["agents-md", "agents-dir", "claude-md", "claude-rules", "cursorrules", "cursor-rules", "skill-md"], undefined>;
60
78
  export { MAX_ARTIFACT_DESCRIPTION_CHARS, MAX_ARTIFACT_NAME_CHARS, MAX_RAW_GUIDE_CONTENT_BYTES, };
61
79
  /** Max member files a single skill-md payload may carry. */
@@ -74,6 +92,14 @@ export declare const RawSkillMemberFileSchema: v.ObjectSchema<{
74
92
  readonly rawContent: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
75
93
  readonly lastModified: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
76
94
  readonly content_hash: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
95
+ /**
96
+ * Whether the file is executable (`100755` in git), so delivery writes it
97
+ * `0o755` or `0o644`. A boolean rather than a mode because git records only
98
+ * those two for a blob, and a numeric mode would be a channel for bits
99
+ * nothing here should set. **Absent is not `false`**: a CLI that predates the
100
+ * field sends none, and the server then keeps whatever it already holds.
101
+ */
102
+ readonly executable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
77
103
  }, undefined>;
78
104
  /** Max skipped-member paths a skill-md payload may report alongside `members`. */
79
105
  export declare const MAX_SKILL_SKIPPED_MEMBER_PATHS = 256;
@@ -120,11 +146,20 @@ export declare const RawGuideFilePayloadSchema: v.SchemaWithPipe<readonly [v.Obj
120
146
  readonly rawContent: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
121
147
  readonly lastModified: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
122
148
  readonly content_hash: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
149
+ /**
150
+ * Whether the file is executable (`100755` in git), so delivery writes it
151
+ * `0o755` or `0o644`. A boolean rather than a mode because git records only
152
+ * those two for a blob, and a numeric mode would be a channel for bits
153
+ * nothing here should set. **Absent is not `false`**: a CLI that predates the
154
+ * field sends none, and the server then keeps whatever it already holds.
155
+ */
156
+ readonly executable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
123
157
  }, undefined>, undefined>, v.MaxLengthAction<{
124
158
  path: string;
125
159
  rawContent: string;
126
160
  lastModified: number;
127
161
  content_hash: string;
162
+ executable?: boolean | undefined;
128
163
  }[], 64, undefined>]>, undefined>;
129
164
  /**
130
165
  * The body-item version this machine last agreed with the server about for
@@ -159,6 +194,7 @@ export declare const RawGuideFilePayloadSchema: v.SchemaWithPipe<readonly [v.Obj
159
194
  rawContent: string;
160
195
  lastModified: number;
161
196
  content_hash: string;
197
+ executable?: boolean | undefined;
162
198
  }[] | undefined;
163
199
  expectedVersion?: number | undefined;
164
200
  skippedMemberPaths?: string[] | undefined;
@@ -174,6 +210,7 @@ export declare const RawGuideFilePayloadSchema: v.SchemaWithPipe<readonly [v.Obj
174
210
  rawContent: string;
175
211
  lastModified: number;
176
212
  content_hash: string;
213
+ executable?: boolean | undefined;
177
214
  }[] | undefined;
178
215
  expectedVersion?: number | undefined;
179
216
  skippedMemberPaths?: string[] | undefined;
@@ -189,6 +226,7 @@ export declare const RawGuideFilePayloadSchema: v.SchemaWithPipe<readonly [v.Obj
189
226
  rawContent: string;
190
227
  lastModified: number;
191
228
  content_hash: string;
229
+ executable?: boolean | undefined;
192
230
  }[] | undefined;
193
231
  expectedVersion?: number | undefined;
194
232
  skippedMemberPaths?: string[] | undefined;
@@ -1477,6 +1515,14 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1477
1515
  * broken half-skill on disk, which is worse than not muting at all.
1478
1516
  */
1479
1517
  readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
1518
+ /**
1519
+ * On a skill's member file: whether git records it as executable, so delivery
1520
+ * writes it `0o755` (`true`) or `0o644` (`false`). **Absent means unknown**,
1521
+ * from a server that predates it or for a member imported before the bit was
1522
+ * carried, and delivery then leaves the file's mode as it finds it: writing
1523
+ * `0o644` there would undo a `chmod +x` the user made to work round this.
1524
+ */
1525
+ readonly executable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1480
1526
  readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
1481
1527
  readonly path: v.OptionalSchema<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>, undefined>;
1482
1528
  readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
@@ -1754,6 +1800,7 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1754
1800
  origin?: string | null | undefined;
1755
1801
  version?: number | undefined;
1756
1802
  guideId?: string | null | undefined;
1803
+ executable?: boolean | undefined;
1757
1804
  root?: "project" | "global" | null | undefined;
1758
1805
  path?: string | null | undefined;
1759
1806
  projectId?: string | null | undefined;
@@ -1822,6 +1869,7 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1822
1869
  origin?: string | null | undefined;
1823
1870
  version?: number | undefined;
1824
1871
  guideId?: string | null | undefined;
1872
+ executable?: boolean | undefined;
1825
1873
  root?: "project" | "global" | null | undefined;
1826
1874
  path?: string | null | undefined;
1827
1875
  projectId?: string | null | undefined;
@@ -1937,6 +1985,14 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
1937
1985
  * broken half-skill on disk, which is worse than not muting at all.
1938
1986
  */
1939
1987
  readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
1988
+ /**
1989
+ * On a skill's member file: whether git records it as executable, so delivery
1990
+ * writes it `0o755` (`true`) or `0o644` (`false`). **Absent means unknown**,
1991
+ * from a server that predates it or for a member imported before the bit was
1992
+ * carried, and delivery then leaves the file's mode as it finds it: writing
1993
+ * `0o644` there would undo a `chmod +x` the user made to work round this.
1994
+ */
1995
+ readonly executable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
1940
1996
  readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
1941
1997
  readonly path: v.OptionalSchema<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>, undefined>;
1942
1998
  readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
@@ -2214,6 +2270,7 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2214
2270
  origin?: string | null | undefined;
2215
2271
  version?: number | undefined;
2216
2272
  guideId?: string | null | undefined;
2273
+ executable?: boolean | undefined;
2217
2274
  root?: "project" | "global" | null | undefined;
2218
2275
  path?: string | null | undefined;
2219
2276
  projectId?: string | null | undefined;
@@ -2282,6 +2339,7 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2282
2339
  origin?: string | null | undefined;
2283
2340
  version?: number | undefined;
2284
2341
  guideId?: string | null | undefined;
2342
+ executable?: boolean | undefined;
2285
2343
  root?: "project" | "global" | null | undefined;
2286
2344
  path?: string | null | undefined;
2287
2345
  projectId?: string | null | undefined;
@@ -2341,6 +2399,8 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2341
2399
  readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2342
2400
  readonly note: v.StringSchema<undefined>;
2343
2401
  }, undefined>, undefined>, undefined>;
2402
+ /** As on {@link BundleArtifactsResponseSchema}. */
2403
+ readonly next: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2344
2404
  }, undefined>;
2345
2405
  /**
2346
2406
  * The bundle pull under its artifact name: the same members and comments as
@@ -2413,6 +2473,14 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2413
2473
  * broken half-skill on disk, which is worse than not muting at all.
2414
2474
  */
2415
2475
  readonly guideId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2476
+ /**
2477
+ * On a skill's member file: whether git records it as executable, so delivery
2478
+ * writes it `0o755` (`true`) or `0o644` (`false`). **Absent means unknown**,
2479
+ * from a server that predates it or for a member imported before the bit was
2480
+ * carried, and delivery then leaves the file's mode as it finds it: writing
2481
+ * `0o644` there would undo a `chmod +x` the user made to work round this.
2482
+ */
2483
+ readonly executable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
2416
2484
  readonly root: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>, undefined>;
2417
2485
  readonly path: v.OptionalSchema<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>, undefined>;
2418
2486
  readonly projectId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
@@ -2690,6 +2758,7 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2690
2758
  origin?: string | null | undefined;
2691
2759
  version?: number | undefined;
2692
2760
  guideId?: string | null | undefined;
2761
+ executable?: boolean | undefined;
2693
2762
  root?: "project" | "global" | null | undefined;
2694
2763
  path?: string | null | undefined;
2695
2764
  projectId?: string | null | undefined;
@@ -2758,6 +2827,7 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2758
2827
  origin?: string | null | undefined;
2759
2828
  version?: number | undefined;
2760
2829
  guideId?: string | null | undefined;
2830
+ executable?: boolean | undefined;
2761
2831
  root?: "project" | "global" | null | undefined;
2762
2832
  path?: string | null | undefined;
2763
2833
  projectId?: string | null | undefined;
@@ -2812,6 +2882,12 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2812
2882
  readonly endMarker: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
2813
2883
  readonly note: v.StringSchema<undefined>;
2814
2884
  }, undefined>, undefined>, undefined>;
2885
+ /**
2886
+ * On a paged read (one that sent `after`): the cursor for the next page, or
2887
+ * `null` after the last. Absent on an unpaged read, and from a server that
2888
+ * predates paging — which is how a reader tells the two apart.
2889
+ */
2890
+ readonly next: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2815
2891
  }, undefined>;
2816
2892
  /**
2817
2893
  * How many bundles one comments read may name.
@@ -3302,10 +3378,12 @@ export declare const CommentEvidenceCitationSchema: v.ObjectSchema<{
3302
3378
  * failure. `action` is a recorded step of a workflow repeated across
3303
3379
  * sessions. `discrepancy` is a grader's note that a session's closing report
3304
3380
  * contradicted its recorded actions; its excerpt is the agent's quoted claim
3305
- * and the record. A server sends `action` and `discrepancy` only to a client
3306
- * that names a version new enough to parse them.
3381
+ * and the record. `artifact_comment` is a person's comment on an artifact the
3382
+ * cited session wrote; its excerpt is the comment. A server sends `action`,
3383
+ * `discrepancy` and `artifact_comment` only to a client that names a version
3384
+ * new enough to parse them.
3307
3385
  */
3308
- readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action", "discrepancy"], undefined>;
3386
+ readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action", "discrepancy", "artifact_comment"], undefined>;
3309
3387
  readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3310
3388
  /** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
3311
3389
  readonly at: v.StringSchema<undefined>;
@@ -3422,10 +3500,12 @@ export declare const CommentEvidenceResponseSchema: v.ObjectSchema<{
3422
3500
  * failure. `action` is a recorded step of a workflow repeated across
3423
3501
  * sessions. `discrepancy` is a grader's note that a session's closing report
3424
3502
  * contradicted its recorded actions; its excerpt is the agent's quoted claim
3425
- * and the record. A server sends `action` and `discrepancy` only to a client
3426
- * that names a version new enough to parse them.
3503
+ * and the record. `artifact_comment` is a person's comment on an artifact the
3504
+ * cited session wrote; its excerpt is the comment. A server sends `action`,
3505
+ * `discrepancy` and `artifact_comment` only to a client that names a version
3506
+ * new enough to parse them.
3427
3507
  */
3428
- readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action", "discrepancy"], undefined>;
3508
+ readonly kind: v.PicklistSchema<["verdict", "turn", "navigation", "action", "discrepancy", "artifact_comment"], undefined>;
3429
3509
  readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
3430
3510
  /** ISO, when the verdict was graded, the turn was said, the skill loaded, or the action was recorded. */
3431
3511
  readonly at: v.StringSchema<undefined>;
@@ -4023,12 +4103,16 @@ export declare const GuidePublishSchema: v.SchemaWithPipe<readonly [v.StrictObje
4023
4103
  readonly members: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
4024
4104
  readonly path: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, v.CheckAction<string, "path must not shadow the skill’s own SKILL.md">]>;
4025
4105
  readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
4106
+ /** As on {@link RawSkillMemberFileSchema}: absent is not `false`. */
4107
+ readonly executable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4026
4108
  }, undefined>, undefined>, v.MaxLengthAction<{
4027
4109
  path: string;
4028
4110
  content: string;
4111
+ executable?: boolean | undefined;
4029
4112
  }[], 64, undefined>, v.CheckAction<{
4030
4113
  path: string;
4031
4114
  content: string;
4115
+ executable?: boolean | undefined;
4032
4116
  }[], "member paths must be unique (case-insensitive)">]>, undefined>;
4033
4117
  readonly skippedPaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>, undefined>, v.MaxLengthAction<string[], 256, undefined>]>, undefined>;
4034
4118
  /**
@@ -4043,6 +4127,7 @@ export declare const GuidePublishSchema: v.SchemaWithPipe<readonly [v.StrictObje
4043
4127
  members?: {
4044
4128
  path: string;
4045
4129
  content: string;
4130
+ executable?: boolean | undefined;
4046
4131
  }[] | undefined;
4047
4132
  skippedPaths?: string[] | undefined;
4048
4133
  aliases?: string[] | undefined;
@@ -4265,12 +4350,16 @@ export declare const CreateArtifactRequestSchema: v.StrictObjectSchema<{
4265
4350
  readonly members: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
4266
4351
  readonly path: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, v.CheckAction<string, "path must not shadow the skill’s own SKILL.md">]>;
4267
4352
  readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
4353
+ /** As on {@link RawSkillMemberFileSchema}: absent is not `false`. */
4354
+ readonly executable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4268
4355
  }, undefined>, undefined>, v.MaxLengthAction<{
4269
4356
  path: string;
4270
4357
  content: string;
4358
+ executable?: boolean | undefined;
4271
4359
  }[], 64, undefined>, v.CheckAction<{
4272
4360
  path: string;
4273
4361
  content: string;
4362
+ executable?: boolean | undefined;
4274
4363
  }[], "member paths must be unique (case-insensitive)">]>, undefined>;
4275
4364
  readonly skippedPaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>, undefined>, v.MaxLengthAction<string[], 256, undefined>]>, undefined>;
4276
4365
  /**
@@ -4285,6 +4374,7 @@ export declare const CreateArtifactRequestSchema: v.StrictObjectSchema<{
4285
4374
  members?: {
4286
4375
  path: string;
4287
4376
  content: string;
4377
+ executable?: boolean | undefined;
4288
4378
  }[] | undefined;
4289
4379
  skippedPaths?: string[] | undefined;
4290
4380
  aliases?: string[] | undefined;
@@ -4356,6 +4446,14 @@ export declare const UpdateArtifactRequestFieldsSchema: v.StrictObjectSchema<{
4356
4446
  * an unowned artifact git-owned. Omit for deliberate publication.
4357
4447
  */
4358
4448
  readonly preserveOwnership: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
4449
+ /**
4450
+ * The writer says the new content is theirs: an editor save or their
4451
+ * agent's edit, never a restore, a publication or an import. Only `true`
4452
+ * keeps the writer's approval for the page to read their data on the new
4453
+ * bytes; omitted or false, a content change revokes it, so a client that
4454
+ * does not opt in fails closed.
4455
+ */
4456
+ readonly authored: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4359
4457
  /**
4360
4458
  * The writer's checkout, as the `project.id` it commits. Declaring it grants
4361
4459
  * nothing; it says which checkout this write comes from, so the home
@@ -4403,12 +4501,16 @@ export declare const UpdateArtifactRequestFieldsSchema: v.StrictObjectSchema<{
4403
4501
  readonly members: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
4404
4502
  readonly path: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, v.CheckAction<string, "path must not shadow the skill’s own SKILL.md">]>;
4405
4503
  readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
4504
+ /** As on {@link RawSkillMemberFileSchema}: absent is not `false`. */
4505
+ readonly executable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4406
4506
  }, undefined>, undefined>, v.MaxLengthAction<{
4407
4507
  path: string;
4408
4508
  content: string;
4509
+ executable?: boolean | undefined;
4409
4510
  }[], 64, undefined>, v.CheckAction<{
4410
4511
  path: string;
4411
4512
  content: string;
4513
+ executable?: boolean | undefined;
4412
4514
  }[], "member paths must be unique (case-insensitive)">]>, undefined>;
4413
4515
  readonly skippedPaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>, undefined>, v.MaxLengthAction<string[], 256, undefined>]>, undefined>;
4414
4516
  /**
@@ -4423,6 +4525,7 @@ export declare const UpdateArtifactRequestFieldsSchema: v.StrictObjectSchema<{
4423
4525
  members?: {
4424
4526
  path: string;
4425
4527
  content: string;
4528
+ executable?: boolean | undefined;
4426
4529
  }[] | undefined;
4427
4530
  skippedPaths?: string[] | undefined;
4428
4531
  aliases?: string[] | undefined;
@@ -4437,6 +4540,20 @@ export declare const artifactUpdateChangesSomething: (request: {
4437
4540
  name?: unknown;
4438
4541
  description?: unknown;
4439
4542
  }) => boolean;
4543
+ /**
4544
+ * Allow a page to read the caller's data and their owner-only comment anchors.
4545
+ * `hash` is the SHA-256 of the content the caller saw; the server refuses it
4546
+ * when the page's bytes are no longer those, so an approval only ever names
4547
+ * bytes its giver was shown.
4548
+ */
4549
+ export declare const PageDataApprovalRequestSchema: v.StrictObjectSchema<{
4550
+ readonly hash: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
4551
+ }, undefined>;
4552
+ /** The caller's approval for one page: the hash it names, or null for none. */
4553
+ export declare const PageDataApprovalResponseSchema: v.StrictObjectSchema<{
4554
+ readonly approvedHash: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
4555
+ }, undefined>;
4556
+ export type PageDataApprovalResponse = v.InferOutput<typeof PageDataApprovalResponseSchema>;
4440
4557
  /** The `PUT` body: {@link UpdateArtifactRequestFieldsSchema}, carrying at least one change. */
4441
4558
  export declare const UpdateArtifactRequestSchema: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
4442
4559
  /** Dashboard autosave boundary; omitted retains every ordinary edit. */
@@ -4484,6 +4601,14 @@ export declare const UpdateArtifactRequestSchema: v.SchemaWithPipe<readonly [v.S
4484
4601
  * an unowned artifact git-owned. Omit for deliberate publication.
4485
4602
  */
4486
4603
  readonly preserveOwnership: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
4604
+ /**
4605
+ * The writer says the new content is theirs: an editor save or their
4606
+ * agent's edit, never a restore, a publication or an import. Only `true`
4607
+ * keeps the writer's approval for the page to read their data on the new
4608
+ * bytes; omitted or false, a content change revokes it, so a client that
4609
+ * does not opt in fails closed.
4610
+ */
4611
+ readonly authored: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4487
4612
  /**
4488
4613
  * The writer's checkout, as the `project.id` it commits. Declaring it grants
4489
4614
  * nothing; it says which checkout this write comes from, so the home
@@ -4531,12 +4656,16 @@ export declare const UpdateArtifactRequestSchema: v.SchemaWithPipe<readonly [v.S
4531
4656
  readonly members: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StrictObjectSchema<{
4532
4657
  readonly path: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>, v.CheckAction<string, "path must use forward slashes">, v.CheckAction<string, "path must be relative">, v.CheckAction<string, "path must not contain control characters">, v.CheckAction<string, "path must not contain empty, \".\" or \"..\" segments">]>, v.CheckAction<string, "path must not shadow the skill’s own SKILL.md">]>;
4533
4658
  readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
4659
+ /** As on {@link RawSkillMemberFileSchema}: absent is not `false`. */
4660
+ readonly executable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4534
4661
  }, undefined>, undefined>, v.MaxLengthAction<{
4535
4662
  path: string;
4536
4663
  content: string;
4664
+ executable?: boolean | undefined;
4537
4665
  }[], 64, undefined>, v.CheckAction<{
4538
4666
  path: string;
4539
4667
  content: string;
4668
+ executable?: boolean | undefined;
4540
4669
  }[], "member paths must be unique (case-insensitive)">]>, undefined>;
4541
4670
  readonly skippedPaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 512, undefined>]>, undefined>, v.MaxLengthAction<string[], 256, undefined>]>, undefined>;
4542
4671
  /**
@@ -4551,6 +4680,7 @@ export declare const UpdateArtifactRequestSchema: v.SchemaWithPipe<readonly [v.S
4551
4680
  members?: {
4552
4681
  path: string;
4553
4682
  content: string;
4683
+ executable?: boolean | undefined;
4554
4684
  }[] | undefined;
4555
4685
  skippedPaths?: string[] | undefined;
4556
4686
  aliases?: string[] | undefined;
@@ -4572,6 +4702,7 @@ export declare const UpdateArtifactRequestSchema: v.SchemaWithPipe<readonly [v.S
4572
4702
  gitCommit?: string | undefined;
4573
4703
  }[] | undefined;
4574
4704
  preserveOwnership?: true | undefined;
4705
+ authored?: boolean | undefined;
4575
4706
  projectId?: string | undefined;
4576
4707
  gitSource?: {
4577
4708
  projectId: string;
@@ -4584,6 +4715,7 @@ export declare const UpdateArtifactRequestSchema: v.SchemaWithPipe<readonly [v.S
4584
4715
  members?: {
4585
4716
  path: string;
4586
4717
  content: string;
4718
+ executable?: boolean | undefined;
4587
4719
  }[] | undefined;
4588
4720
  skippedPaths?: string[] | undefined;
4589
4721
  aliases?: string[] | undefined;
@@ -4896,6 +5028,29 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
4896
5028
  readonly note: v.StringSchema<undefined>;
4897
5029
  }, undefined>, undefined>, undefined>;
4898
5030
  }, undefined>;
5031
+ /**
5032
+ * What a bundle-scoped credential is told about an artifact in the Trash: who
5033
+ * it is and when it was deleted, never its content or its versions. A read or a
5034
+ * history request answers it with a 410 carrying `code: 'artifact-deleted'`;
5035
+ * restoring the artifact makes it readable again.
5036
+ */
5037
+ export declare const DeletedArtifactSchema: v.ObjectSchema<{
5038
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5039
+ readonly name: v.StringSchema<undefined>;
5040
+ readonly state: v.LiteralSchema<"deleted", undefined>;
5041
+ readonly deletedAt: v.StringSchema<undefined>;
5042
+ }, undefined>;
5043
+ export declare const ArtifactDeletedRefusalSchema: v.ObjectSchema<{
5044
+ readonly error: v.StringSchema<undefined>;
5045
+ readonly code: v.LiteralSchema<"artifact-deleted", undefined>;
5046
+ readonly artifact: v.ObjectSchema<{
5047
+ readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5048
+ readonly name: v.StringSchema<undefined>;
5049
+ readonly state: v.LiteralSchema<"deleted", undefined>;
5050
+ readonly deletedAt: v.StringSchema<undefined>;
5051
+ }, undefined>;
5052
+ readonly requestId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
5053
+ }, undefined>;
4899
5054
  export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
4900
5055
  readonly artifact: v.ObjectSchema<{
4901
5056
  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -6659,6 +6814,14 @@ export declare const DashboardSyncActionSchema: v.ObjectSchema<{
6659
6814
  readonly actionType: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 128, undefined>]>;
6660
6815
  readonly summary: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>;
6661
6816
  readonly filePaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 1024, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>, undefined>;
6817
+ /**
6818
+ * The artifact this read touched, when the file it read is one Mossbear placed
6819
+ * on the machine (resolved by the CLI; see `ActionEntrySchema.itemIds`). Only
6820
+ * read actions carry it. Not checked against the artifact on the server:
6821
+ * every count it feeds is scoped to the uploader, so a wrong id can only
6822
+ * change the uploader's own number.
6823
+ */
6824
+ readonly itemId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "id must not contain whitespace or control characters">]>]>, undefined>;
6662
6825
  readonly verdict: v.OptionalSchema<v.PicklistSchema<["aligned", "unguided", "misaligned"], undefined>, undefined>;
6663
6826
  readonly gradingTier: v.OptionalSchema<v.PicklistSchema<["pattern_match", "cached", "llm", "batch", "unguided"], undefined>, undefined>;
6664
6827
  readonly guideIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
@@ -6678,6 +6841,8 @@ export declare const DashboardSyncActionSchema: v.ObjectSchema<{
6678
6841
  [x: string]: unknown;
6679
6842
  }, "metadata.environment must be cloud">, v.CheckAction<{
6680
6843
  [x: string]: unknown;
6844
+ }, "metadata.repository must be a repository name of at most 200 characters">, v.CheckAction<{
6845
+ [x: string]: unknown;
6681
6846
  }, "metadata.outcome must be { status: \"ok\" | \"error\", errorClass?: string, exitCode?: number } with no other keys">]>, undefined>, undefined>;
6682
6847
  /**
6683
6848
  * Transcript evidence for this action. See {@link ActionNarrationSchema}.
@@ -6926,6 +7091,14 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
6926
7091
  readonly actionType: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 128, undefined>]>;
6927
7092
  readonly summary: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>;
6928
7093
  readonly filePaths: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 1024, undefined>]>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>, undefined>;
7094
+ /**
7095
+ * The artifact this read touched, when the file it read is one Mossbear placed
7096
+ * on the machine (resolved by the CLI; see `ActionEntrySchema.itemIds`). Only
7097
+ * read actions carry it. Not checked against the artifact on the server:
7098
+ * every count it feeds is scoped to the uploader, so a wrong id can only
7099
+ * change the uploader's own number.
7100
+ */
7101
+ readonly itemId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "id must not contain whitespace or control characters">]>]>, undefined>;
6929
7102
  readonly verdict: v.OptionalSchema<v.PicklistSchema<["aligned", "unguided", "misaligned"], undefined>, undefined>;
6930
7103
  readonly gradingTier: v.OptionalSchema<v.PicklistSchema<["pattern_match", "cached", "llm", "batch", "unguided"], undefined>, undefined>;
6931
7104
  readonly guideIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
@@ -6945,6 +7118,8 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
6945
7118
  [x: string]: unknown;
6946
7119
  }, "metadata.environment must be cloud">, v.CheckAction<{
6947
7120
  [x: string]: unknown;
7121
+ }, "metadata.repository must be a repository name of at most 200 characters">, v.CheckAction<{
7122
+ [x: string]: unknown;
6948
7123
  }, "metadata.outcome must be { status: \"ok\" | \"error\", errorClass?: string, exitCode?: number } with no other keys">]>, undefined>, undefined>;
6949
7124
  /**
6950
7125
  * Transcript evidence for this action. See {@link ActionNarrationSchema}.
@@ -6985,6 +7160,7 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
6985
7160
  actionType: string;
6986
7161
  summary: string;
6987
7162
  filePaths?: string[] | undefined;
7163
+ itemId?: string | undefined;
6988
7164
  verdict?: "aligned" | "unguided" | "misaligned" | undefined;
6989
7165
  gradingTier?: "unguided" | "pattern_match" | "cached" | "llm" | "batch" | undefined;
6990
7166
  guideIds?: string[] | undefined;
@@ -7301,6 +7477,15 @@ export declare const ActionEntrySchema: v.ObjectSchema<{
7301
7477
  * action a read tool would have produced.
7302
7478
  */
7303
7479
  readonly memberReads: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
7480
+ /**
7481
+ * The artifact placed at each path this entry read, keyed by the path as the
7482
+ * entry records it (`filePath`, or one of `memberReads`). Resolved by the hook
7483
+ * against this machine's placement records, the only place a path and the id
7484
+ * of the artifact Mossbear put there are both known. A path with no placement
7485
+ * is absent. Local-to-upload: each read's id rides its own action as
7486
+ * `itemId`.
7487
+ */
7488
+ readonly itemIds: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, undefined>;
7304
7489
  /**
7305
7490
  * Where this session's transcript lives on *this machine*, as the agent
7306
7491
  * itself reported it.
@@ -7363,6 +7548,14 @@ export declare const ActionEntrySchema: v.ObjectSchema<{
7363
7548
  * means local.
7364
7549
  */
7365
7550
  readonly environment: v.OptionalSchema<v.PicklistSchema<["cloud"], undefined>, undefined>;
7551
+ /**
7552
+ * The repository's display name, read by the logger hook from the event's
7553
+ * `cwd` beside `projectId`; see {@link RepositoryNameSchema}.
7554
+ *
7555
+ * Optional: run logs written before this field existed must stay readable,
7556
+ * and a session in the home directory carries no name.
7557
+ */
7558
+ readonly repository: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>, v.CheckAction<string, "repository must be trimmed and hold no control characters">]>, undefined>;
7366
7559
  /**
7367
7560
  * Whether the tool call succeeded, when the hook could tell.
7368
7561
  *
@@ -9990,6 +10183,7 @@ export declare function parseRawGuideFilePayload(data: unknown): {
9990
10183
  rawContent: string;
9991
10184
  lastModified: number;
9992
10185
  content_hash: string;
10186
+ executable?: boolean | undefined;
9993
10187
  }[] | undefined;
9994
10188
  expectedVersion?: number | undefined;
9995
10189
  skippedMemberPaths?: string[] | undefined;
@@ -10131,6 +10325,7 @@ export declare function parseContextItemsResponse(data: unknown): {
10131
10325
  origin?: string | null | undefined;
10132
10326
  version?: number | undefined;
10133
10327
  guideId?: string | null | undefined;
10328
+ executable?: boolean | undefined;
10134
10329
  root?: "project" | "global" | null | undefined;
10135
10330
  path?: string | null | undefined;
10136
10331
  projectId?: string | null | undefined;
@@ -10185,6 +10380,7 @@ export declare function parseContextItemsResponse(data: unknown): {
10185
10380
  endMarker: string;
10186
10381
  note: string;
10187
10382
  } | null | undefined;
10383
+ next?: string | null | undefined;
10188
10384
  };
10189
10385
  export declare function parseBundleArtifactsResponse(data: unknown): {
10190
10386
  artifacts: {
@@ -10208,6 +10404,7 @@ export declare function parseBundleArtifactsResponse(data: unknown): {
10208
10404
  origin?: string | null | undefined;
10209
10405
  version?: number | undefined;
10210
10406
  guideId?: string | null | undefined;
10407
+ executable?: boolean | undefined;
10211
10408
  root?: "project" | "global" | null | undefined;
10212
10409
  path?: string | null | undefined;
10213
10410
  projectId?: string | null | undefined;
@@ -10262,6 +10459,7 @@ export declare function parseBundleArtifactsResponse(data: unknown): {
10262
10459
  endMarker: string;
10263
10460
  note: string;
10264
10461
  } | null | undefined;
10462
+ next?: string | null | undefined;
10265
10463
  };
10266
10464
  export declare function parseCaptureRequest(data: unknown): {
10267
10465
  id?: string | undefined;
@@ -10315,6 +10513,7 @@ export declare function parseDashboardSyncRequest(data: unknown): {
10315
10513
  actionType: string;
10316
10514
  summary: string;
10317
10515
  filePaths?: string[] | undefined;
10516
+ itemId?: string | undefined;
10318
10517
  verdict?: "aligned" | "unguided" | "misaligned" | undefined;
10319
10518
  gradingTier?: "unguided" | "pattern_match" | "cached" | "llm" | "batch" | undefined;
10320
10519
  guideIds?: string[] | undefined;
@@ -10419,11 +10618,15 @@ export declare function parseActionEntry(data: unknown): {
10419
10618
  path?: string | undefined;
10420
10619
  }[] | undefined;
10421
10620
  memberReads?: string[] | undefined;
10621
+ itemIds?: {
10622
+ [x: string]: string;
10623
+ } | undefined;
10422
10624
  transcriptPath?: string | undefined;
10423
10625
  repoId?: string | undefined;
10424
10626
  projectId?: string | undefined;
10425
10627
  harness?: "claude_code" | "codex" | "opencode" | "antigravity" | undefined;
10426
10628
  environment?: "cloud" | undefined;
10629
+ repository?: string | undefined;
10427
10630
  outcome?: {
10428
10631
  status: "ok" | "error";
10429
10632
  errorClass?: string | undefined;
@@ -10631,7 +10834,7 @@ export declare function parseCommentEvidenceResponse(data: unknown): {
10631
10834
  }[];
10632
10835
  } | null;
10633
10836
  citations: {
10634
- kind: "verdict" | "turn" | "navigation" | "action" | "discrepancy";
10837
+ kind: "verdict" | "turn" | "navigation" | "action" | "discrepancy" | "artifact_comment";
10635
10838
  sessionId: string;
10636
10839
  at: string;
10637
10840
  excerpt: string;