@mossbear/protocol 0.1.0-alpha.111 → 0.1.0-alpha.113

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 (44) hide show
  1. package/dist/artifact.test.js +6 -1
  2. package/dist/artifact.test.js.map +1 -1
  3. package/dist/deliverableSkillMembers.d.ts +24 -0
  4. package/dist/deliverableSkillMembers.d.ts.map +1 -0
  5. package/dist/deliverableSkillMembers.js +39 -0
  6. package/dist/deliverableSkillMembers.js.map +1 -0
  7. package/dist/deliverableSkillMembers.test.d.ts +2 -0
  8. package/dist/deliverableSkillMembers.test.d.ts.map +1 -0
  9. package/dist/deliverableSkillMembers.test.js +32 -0
  10. package/dist/deliverableSkillMembers.test.js.map +1 -0
  11. package/dist/frameDocument.d.ts.map +1 -1
  12. package/dist/frameDocument.js +10 -8
  13. package/dist/frameDocument.js.map +1 -1
  14. package/dist/frameDocument.test.js +7 -0
  15. package/dist/frameDocument.test.js.map +1 -1
  16. package/dist/index.d.ts +1 -0
  17. package/dist/index.d.ts.map +1 -1
  18. package/dist/index.js +1 -0
  19. package/dist/index.js.map +1 -1
  20. package/dist/pairing.d.ts +14 -1
  21. package/dist/pairing.d.ts.map +1 -1
  22. package/dist/pairing.js +12 -0
  23. package/dist/pairing.js.map +1 -1
  24. package/dist/photos.d.ts +93 -6
  25. package/dist/photos.d.ts.map +1 -1
  26. package/dist/photos.js +73 -5
  27. package/dist/photos.js.map +1 -1
  28. package/dist/photos.test.d.ts +2 -0
  29. package/dist/photos.test.d.ts.map +1 -0
  30. package/dist/photos.test.js +71 -0
  31. package/dist/photos.test.js.map +1 -0
  32. package/dist/schemas.d.ts +654 -52
  33. package/dist/schemas.d.ts.map +1 -1
  34. package/dist/schemas.js +123 -47
  35. package/dist/schemas.js.map +1 -1
  36. package/dist/schemas.test.js +1 -19
  37. package/dist/schemas.test.js.map +1 -1
  38. package/dist/types.d.ts +1 -3
  39. package/dist/types.d.ts.map +1 -1
  40. package/dist/types.js.map +1 -1
  41. package/dist/whatSyncs.d.ts.map +1 -1
  42. package/dist/whatSyncs.js +6 -2
  43. package/dist/whatSyncs.js.map +1 -1
  44. package/package.json +1 -1
package/dist/schemas.d.ts CHANGED
@@ -231,28 +231,6 @@ export declare const RawGuideFilePayloadSchema: v.SchemaWithPipe<readonly [v.Obj
231
231
  expectedVersion?: number | undefined;
232
232
  skippedMemberPaths?: string[] | undefined;
233
233
  }, "member paths must be unique (case-insensitive)">]>;
234
- export declare const GuideMemberFileSchema: v.ObjectSchema<{
235
- 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">]>;
236
- readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
237
- readonly contentHash: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
238
- }, undefined>;
239
- export declare const GuideMemberFilesResponseSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
240
- readonly memberFiles: v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
241
- 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">]>;
242
- readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "rawContent must be at most 524288 bytes">]>;
243
- readonly contentHash: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
244
- }, undefined>, undefined>, v.MaxLengthAction<{
245
- path: string;
246
- content: string;
247
- contentHash: string;
248
- }[], 64, undefined>]>;
249
- }, undefined>, v.CheckAction<{
250
- memberFiles: {
251
- path: string;
252
- content: string;
253
- contentHash: string;
254
- }[];
255
- }, "member file paths must be unique (case-insensitive)">]>;
256
234
  /** Max number of rules accepted in a single `POST /api/rules/import` request. */
257
235
  export declare const MAX_RULES_IMPORT_BATCH = 100;
258
236
  /** Opaque checkout digest shared by run logs, manifests, and `runs.repo_id`. */
@@ -768,16 +746,32 @@ export declare const ResolvedSubscriptionSchema: v.ObjectSchema<{
768
746
  */
769
747
  readonly home: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
770
748
  /**
771
- * Guide ids the **account** subscription has switched off for this subscriber
772
- * (`subscription-delivery-target-plan.md` → slice 4).
749
+ * Ids this account has switched off for the asking machine, on a bundle that
750
+ * reaches it through the account subscription alone. An item whose own id or
751
+ * `guideId` is listed is not delivered.
773
752
  *
774
- * Account-scoped and nowhere else: a repo subscription is a committed file
775
- * shared by everyone who clones it, so a mute there would be one member
776
- * deciding for the team. A muted guide leaves the desired delivery list, and
777
- * the global namespace prunes it once no repo still refers to it — repo by
778
- * repo, as each syncs, because the referrer record is machine-local repo ids.
753
+ * The server computes it per machine: artifacts switched off everywhere or
754
+ * on this machine that this bundle can deliver, plus every member when the
755
+ * bundle itself is switched off. Account-scoped and nowhere else: a repo
756
+ * subscription is a committed file shared by everyone who clones it, so a
757
+ * mute there would be one member deciding for the team. A muted guide leaves
758
+ * the desired delivery list, and the global namespace prunes it once no repo
759
+ * still refers to it — repo by repo, as each syncs, because the referrer
760
+ * record is machine-local repo ids.
779
761
  */
780
762
  readonly muted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
763
+ /**
764
+ * The same set as `muted`, sent instead of it when the calling repo's
765
+ * committed config also subscribes this bundle. It applies to the account
766
+ * target only: the repo's own subscription still delivers into the checkout,
767
+ * because an off removes only what reaches the machine through the account.
768
+ *
769
+ * A separate key rather than `muted`, because a CLI that predates it applies
770
+ * `muted` before either target is planned and would drop the repo delivery
771
+ * too. That CLI ignores this key and delivers to both targets, which fails
772
+ * toward the agent having the content.
773
+ */
774
+ readonly accountMuted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
781
775
  }, undefined>;
782
776
  /**
783
777
  * The ids a repo's committed config names. Sent rather than looked up, because
@@ -803,6 +797,12 @@ export declare const ResolveSubscriptionsRequestSchema: v.ObjectSchema<{
803
797
  * ids is answered as before.
804
798
  */
805
799
  readonly repoBundleAddresses: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 104, undefined>, v.CheckAction<string, "address must be <publisher handle>/<bundle slug>">]>, undefined>, v.MaxLengthAction<string[], 64, undefined>]>, undefined>;
800
+ /**
801
+ * The calling machine's stable id (`MachineIdSchema`). Optional, so an older
802
+ * CLI is answered as before; the server records it for the calling key only
803
+ * when that key has none yet.
804
+ */
805
+ readonly machineId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "not a machine id">]>, undefined>;
806
806
  }, undefined>;
807
807
  export declare const ResolveSubscriptionsResponseSchema: v.ObjectSchema<{
808
808
  /** The effective delivery set, de-duplicated by bundle id. */
@@ -848,16 +848,32 @@ export declare const ResolveSubscriptionsResponseSchema: v.ObjectSchema<{
848
848
  */
849
849
  readonly home: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
850
850
  /**
851
- * Guide ids the **account** subscription has switched off for this subscriber
852
- * (`subscription-delivery-target-plan.md` → slice 4).
851
+ * Ids this account has switched off for the asking machine, on a bundle that
852
+ * reaches it through the account subscription alone. An item whose own id or
853
+ * `guideId` is listed is not delivered.
853
854
  *
854
- * Account-scoped and nowhere else: a repo subscription is a committed file
855
- * shared by everyone who clones it, so a mute there would be one member
856
- * deciding for the team. A muted guide leaves the desired delivery list, and
857
- * the global namespace prunes it once no repo still refers to it — repo by
858
- * repo, as each syncs, because the referrer record is machine-local repo ids.
855
+ * The server computes it per machine: artifacts switched off everywhere or
856
+ * on this machine that this bundle can deliver, plus every member when the
857
+ * bundle itself is switched off. Account-scoped and nowhere else: a repo
858
+ * subscription is a committed file shared by everyone who clones it, so a
859
+ * mute there would be one member deciding for the team. A muted guide leaves
860
+ * the desired delivery list, and the global namespace prunes it once no repo
861
+ * still refers to it — repo by repo, as each syncs, because the referrer
862
+ * record is machine-local repo ids.
859
863
  */
860
864
  readonly muted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
865
+ /**
866
+ * The same set as `muted`, sent instead of it when the calling repo's
867
+ * committed config also subscribes this bundle. It applies to the account
868
+ * target only: the repo's own subscription still delivers into the checkout,
869
+ * because an off removes only what reaches the machine through the account.
870
+ *
871
+ * A separate key rather than `muted`, because a CLI that predates it applies
872
+ * `muted` before either target is planned and would drop the repo delivery
873
+ * too. That CLI ignores this key and delivers to both targets, which fails
874
+ * toward the agent having the content.
875
+ */
876
+ readonly accountMuted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
861
877
  }, undefined>, undefined>;
862
878
  /**
863
879
  * Committed ids the caller cannot see. **Reported, never dropped** — the line
@@ -938,9 +954,14 @@ export declare const SubscribeBundleRequestSchema: v.ObjectSchema<{
938
954
  */
939
955
  readonly deliver: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["repo", "global"], undefined>, undefined>, undefined>;
940
956
  /**
941
- * The guide ids to switch off for this subscriber — the whole set, replacing
942
- * whatever is stored. `[]` unmutes everything, and omitting the field leaves
943
- * the stored set alone.
957
+ * The ids to have switched off on every machine, as far as this bundle can
958
+ * deliver them — the whole set, replacing what is stored. `[]` switches them
959
+ * all back on, and omitting the field leaves the stored set alone.
960
+ *
961
+ * An id switched off here is off for the account, through every bundle that
962
+ * carries it. Switching one back on (an id this bundle delivers that is off
963
+ * now and absent here) needs a dashboard session: a CLI key is refused with
964
+ * 403, because an agent may narrow what it receives but never widen it.
944
965
  *
945
966
  * The same three states as `deliver` above, reached the same way: an explicit
946
967
  * empty clears, and silence never means a write. So changing a delivery target
@@ -1682,6 +1703,25 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
1682
1703
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
1683
1704
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
1684
1705
  }, undefined>, undefined>;
1706
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
1707
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
1708
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
1709
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
1710
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
1711
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
1712
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
1713
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
1714
+ }, undefined>, undefined>;
1715
+ }, undefined>, undefined>, v.MinLengthAction<{
1716
+ id?: string | undefined;
1717
+ parts: {
1718
+ role: "original" | "display" | "thumb";
1719
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
1720
+ bytes: number;
1721
+ width: number;
1722
+ height: number;
1723
+ }[];
1724
+ }[], 1, undefined>]>, undefined>;
1685
1725
  }, undefined>, undefined>, undefined>;
1686
1726
  readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
1687
1727
  readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
@@ -2034,6 +2074,16 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
2034
2074
  width: number;
2035
2075
  height: number;
2036
2076
  }[];
2077
+ images?: {
2078
+ id?: string | undefined;
2079
+ parts: {
2080
+ role: "original" | "display" | "thumb";
2081
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
2082
+ bytes: number;
2083
+ width: number;
2084
+ height: number;
2085
+ }[];
2086
+ }[] | undefined;
2037
2087
  } | null | undefined;
2038
2088
  origin?: string | null | undefined;
2039
2089
  version?: number | undefined;
@@ -2116,6 +2166,16 @@ export declare const ContextItemSchema: v.SchemaWithPipe<readonly [v.ObjectSchem
2116
2166
  width: number;
2117
2167
  height: number;
2118
2168
  }[];
2169
+ images?: {
2170
+ id?: string | undefined;
2171
+ parts: {
2172
+ role: "original" | "display" | "thumb";
2173
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
2174
+ bytes: number;
2175
+ width: number;
2176
+ height: number;
2177
+ }[];
2178
+ }[] | undefined;
2119
2179
  } | null | undefined;
2120
2180
  origin?: string | null | undefined;
2121
2181
  version?: number | undefined;
@@ -2232,6 +2292,25 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2232
2292
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
2233
2293
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
2234
2294
  }, undefined>, undefined>;
2295
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
2296
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
2297
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
2298
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
2299
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
2300
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
2301
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
2302
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
2303
+ }, undefined>, undefined>;
2304
+ }, undefined>, undefined>, v.MinLengthAction<{
2305
+ id?: string | undefined;
2306
+ parts: {
2307
+ role: "original" | "display" | "thumb";
2308
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
2309
+ bytes: number;
2310
+ width: number;
2311
+ height: number;
2312
+ }[];
2313
+ }[], 1, undefined>]>, undefined>;
2235
2314
  }, undefined>, undefined>, undefined>;
2236
2315
  readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2237
2316
  readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
@@ -2584,6 +2663,16 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2584
2663
  width: number;
2585
2664
  height: number;
2586
2665
  }[];
2666
+ images?: {
2667
+ id?: string | undefined;
2668
+ parts: {
2669
+ role: "original" | "display" | "thumb";
2670
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
2671
+ bytes: number;
2672
+ width: number;
2673
+ height: number;
2674
+ }[];
2675
+ }[] | undefined;
2587
2676
  } | null | undefined;
2588
2677
  origin?: string | null | undefined;
2589
2678
  version?: number | undefined;
@@ -2666,6 +2755,16 @@ export declare const ContextItemsResponseSchema: v.ObjectSchema<{
2666
2755
  width: number;
2667
2756
  height: number;
2668
2757
  }[];
2758
+ images?: {
2759
+ id?: string | undefined;
2760
+ parts: {
2761
+ role: "original" | "display" | "thumb";
2762
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
2763
+ bytes: number;
2764
+ width: number;
2765
+ height: number;
2766
+ }[];
2767
+ }[] | undefined;
2669
2768
  } | null | undefined;
2670
2769
  origin?: string | null | undefined;
2671
2770
  version?: number | undefined;
@@ -2800,6 +2899,25 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
2800
2899
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
2801
2900
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
2802
2901
  }, undefined>, undefined>;
2902
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
2903
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
2904
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
2905
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
2906
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
2907
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
2908
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
2909
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
2910
+ }, undefined>, undefined>;
2911
+ }, undefined>, undefined>, v.MinLengthAction<{
2912
+ id?: string | undefined;
2913
+ parts: {
2914
+ role: "original" | "display" | "thumb";
2915
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
2916
+ bytes: number;
2917
+ width: number;
2918
+ height: number;
2919
+ }[];
2920
+ }[], 1, undefined>]>, undefined>;
2803
2921
  }, undefined>, undefined>, undefined>;
2804
2922
  readonly origin: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
2805
2923
  readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
@@ -3152,6 +3270,16 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
3152
3270
  width: number;
3153
3271
  height: number;
3154
3272
  }[];
3273
+ images?: {
3274
+ id?: string | undefined;
3275
+ parts: {
3276
+ role: "original" | "display" | "thumb";
3277
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
3278
+ bytes: number;
3279
+ width: number;
3280
+ height: number;
3281
+ }[];
3282
+ }[] | undefined;
3155
3283
  } | null | undefined;
3156
3284
  origin?: string | null | undefined;
3157
3285
  version?: number | undefined;
@@ -3234,6 +3362,16 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
3234
3362
  width: number;
3235
3363
  height: number;
3236
3364
  }[];
3365
+ images?: {
3366
+ id?: string | undefined;
3367
+ parts: {
3368
+ role: "original" | "display" | "thumb";
3369
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
3370
+ bytes: number;
3371
+ width: number;
3372
+ height: number;
3373
+ }[];
3374
+ }[] | undefined;
3237
3375
  } | null | undefined;
3238
3376
  origin?: string | null | undefined;
3239
3377
  version?: number | undefined;
@@ -3322,6 +3460,18 @@ export declare const BundleArtifactsResponseSchema: v.ObjectSchema<{
3322
3460
  * losing the tail silently.
3323
3461
  */
3324
3462
  export declare const MAX_COMMENT_BUNDLE_IDS = 100;
3463
+ /**
3464
+ * The agent session behind a comment, a reply or a resolution note, as the
3465
+ * caller's harness reported it. Stored on the row so the reply is named after
3466
+ * that session; it is the caller's claim, read only among its own comments.
3467
+ */
3468
+ export declare const AgentIdentitySchema: v.ObjectSchema<{
3469
+ readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
3470
+ readonly harness: v.PicklistSchema<["claude_code", "codex", "antigravity", "opencode"], undefined>;
3471
+ /** The agent's own statement of its model, when it knows it. */
3472
+ readonly model: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
3473
+ readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
3474
+ }, undefined>;
3325
3475
  /**
3326
3476
  * `POST /api/v1/context/comments/resolve`: close one open comment and leave the
3327
3477
  * agent's note as a reply in its thread.
@@ -3350,6 +3500,18 @@ export declare const ResolveItemCommentRequestSchema: v.ObjectSchema<{
3350
3500
  readonly projectId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "projectId must contain only letters, digits, underscore, dot or hyphen">]>, undefined>;
3351
3501
  /** The CLI's version, so a draft resolves only for a client that marks drafts. */
3352
3502
  readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
3503
+ /**
3504
+ * The agent session resolving it, stored on the note so the thread names
3505
+ * who closed it. Optional: releases before it was sent resolve without one,
3506
+ * and their notes read as an unnamed agent.
3507
+ */
3508
+ readonly agent: v.OptionalSchema<v.ObjectSchema<{
3509
+ readonly sessionId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>;
3510
+ readonly harness: v.PicklistSchema<["claude_code", "codex", "antigravity", "opencode"], undefined>;
3511
+ /** The agent's own statement of its model, when it knows it. */
3512
+ readonly model: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 100, undefined>]>, undefined>;
3513
+ readonly cliVersion: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
3514
+ }, undefined>, undefined>;
3353
3515
  }, undefined>;
3354
3516
  export type ResolveItemCommentRequest = v.InferInput<typeof ResolveItemCommentRequestSchema>;
3355
3517
  /** A resolve the server carried out. Every refusal is an error response instead. */
@@ -4192,6 +4354,25 @@ export declare const CapturedItemSchema: v.ObjectSchema<{
4192
4354
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4193
4355
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4194
4356
  }, undefined>, undefined>;
4357
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4358
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
4359
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
4360
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
4361
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
4362
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4363
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4364
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4365
+ }, undefined>, undefined>;
4366
+ }, undefined>, undefined>, v.MinLengthAction<{
4367
+ id?: string | undefined;
4368
+ parts: {
4369
+ role: "original" | "display" | "thumb";
4370
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
4371
+ bytes: number;
4372
+ width: number;
4373
+ height: number;
4374
+ }[];
4375
+ }[], 1, undefined>]>, undefined>;
4195
4376
  }, undefined>, undefined>, undefined>;
4196
4377
  readonly source: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
4197
4378
  readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
@@ -4216,6 +4397,25 @@ export declare const CaptureResponseSchema: v.ObjectSchema<{
4216
4397
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4217
4398
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4218
4399
  }, undefined>, undefined>;
4400
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4401
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
4402
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
4403
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
4404
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
4405
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4406
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4407
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4408
+ }, undefined>, undefined>;
4409
+ }, undefined>, undefined>, v.MinLengthAction<{
4410
+ id?: string | undefined;
4411
+ parts: {
4412
+ role: "original" | "display" | "thumb";
4413
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
4414
+ bytes: number;
4415
+ width: number;
4416
+ height: number;
4417
+ }[];
4418
+ }[], 1, undefined>]>, undefined>;
4219
4419
  }, undefined>, undefined>, undefined>;
4220
4420
  readonly source: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
4221
4421
  readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
@@ -4250,6 +4450,25 @@ export declare const BeginPhotoUploadResponseSchema: v.VariantSchema<"state", [v
4250
4450
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4251
4451
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4252
4452
  }, undefined>, undefined>;
4453
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4454
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
4455
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
4456
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
4457
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
4458
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4459
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4460
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4461
+ }, undefined>, undefined>;
4462
+ }, undefined>, undefined>, v.MinLengthAction<{
4463
+ id?: string | undefined;
4464
+ parts: {
4465
+ role: "original" | "display" | "thumb";
4466
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
4467
+ bytes: number;
4468
+ width: number;
4469
+ height: number;
4470
+ }[];
4471
+ }[], 1, undefined>]>, undefined>;
4253
4472
  }, undefined>, undefined>, undefined>;
4254
4473
  readonly source: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
4255
4474
  readonly version: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
@@ -4507,10 +4726,39 @@ export declare const ArtifactSchema: v.ObjectSchema<{
4507
4726
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4508
4727
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4509
4728
  }, undefined>, undefined>;
4729
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
4730
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
4731
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
4732
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
4733
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
4734
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4735
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4736
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4737
+ }, undefined>, undefined>;
4738
+ }, undefined>, undefined>, v.MinLengthAction<{
4739
+ id?: string | undefined;
4740
+ parts: {
4741
+ role: "original" | "display" | "thumb";
4742
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
4743
+ bytes: number;
4744
+ width: number;
4745
+ height: number;
4746
+ }[];
4747
+ }[], 1, undefined>]>, undefined>;
4510
4748
  }, undefined>, undefined>, undefined>;
4511
4749
  /** Monotonic content version; echo it back as `expectedVersion` to update. */
4512
4750
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4513
4751
  readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
4752
+ /** Personal read facts; optional for servers predating these fields. */
4753
+ readonly deletedAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
4754
+ readonly pinned: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
4755
+ /** Only memberships the credential may read. */
4756
+ readonly bundles: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
4757
+ /** The caller's page views, never other people's or agent fetches. */
4758
+ readonly views: v.OptionalSchema<v.ObjectSchema<{
4759
+ readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
4760
+ readonly lastViewedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
4761
+ }, undefined>, undefined>;
4514
4762
  readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4515
4763
  /** True for a deliberate capture (Inbox). Not derivable from filing state. */
4516
4764
  readonly capture: v.BooleanSchema<undefined>;
@@ -4767,10 +5015,39 @@ export declare const ArtifactMetadataSchema: v.StrictObjectSchema<Omit<{
4767
5015
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4768
5016
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4769
5017
  }, undefined>, undefined>;
5018
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
5019
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
5020
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
5021
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
5022
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
5023
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
5024
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
5025
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
5026
+ }, undefined>, undefined>;
5027
+ }, undefined>, undefined>, v.MinLengthAction<{
5028
+ id?: string | undefined;
5029
+ parts: {
5030
+ role: "original" | "display" | "thumb";
5031
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
5032
+ bytes: number;
5033
+ width: number;
5034
+ height: number;
5035
+ }[];
5036
+ }[], 1, undefined>]>, undefined>;
4770
5037
  }, undefined>, undefined>, undefined>;
4771
5038
  /** Monotonic content version; echo it back as `expectedVersion` to update. */
4772
5039
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
4773
5040
  readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
5041
+ /** Personal read facts; optional for servers predating these fields. */
5042
+ readonly deletedAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
5043
+ readonly pinned: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
5044
+ /** Only memberships the credential may read. */
5045
+ readonly bundles: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
5046
+ /** The caller's page views, never other people's or agent fetches. */
5047
+ readonly views: v.OptionalSchema<v.ObjectSchema<{
5048
+ readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
5049
+ readonly lastViewedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
5050
+ }, undefined>, undefined>;
4774
5051
  readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
4775
5052
  /** True for a deliberate capture (Inbox). Not derivable from filing state. */
4776
5053
  readonly capture: v.BooleanSchema<undefined>;
@@ -5181,6 +5458,17 @@ export declare const ResolveIdentitiesResponseSchema: v.ObjectSchema<{
5181
5458
  }, undefined>, undefined>;
5182
5459
  }, undefined>, undefined>;
5183
5460
  }, undefined>;
5461
+ /**
5462
+ * The optional body of `POST /api/v1/artifacts/:id/copy`. The client sends the
5463
+ * copy's name already localized (`MossbearTemplateCopyButton`); a request with
5464
+ * no name keeps the source's. The bound is `MAX_ARTIFACT_NAME_CHARS`, the same
5465
+ * limit `ArtifactNameSchema` applies on create. Unlike create, this schema trims
5466
+ * the name first, so a blank name is refused here.
5467
+ */
5468
+ export declare const CopyArtifactRequestSchema: v.StrictObjectSchema<{
5469
+ readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
5470
+ }, undefined>;
5471
+ export type CopyArtifactRequest = v.InferOutput<typeof CopyArtifactRequestSchema>;
5184
5472
  export declare const CreateArtifactRequestSchema: v.StrictObjectSchema<{
5185
5473
  readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
5186
5474
  readonly content: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "content must be at most 262144 bytes">]>;
@@ -5804,10 +6092,39 @@ export declare const ReadArtifactResponseSchema: v.ObjectSchema<{
5804
6092
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
5805
6093
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
5806
6094
  }, undefined>, undefined>;
6095
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
6096
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
6097
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
6098
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
6099
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
6100
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6101
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6102
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6103
+ }, undefined>, undefined>;
6104
+ }, undefined>, undefined>, v.MinLengthAction<{
6105
+ id?: string | undefined;
6106
+ parts: {
6107
+ role: "original" | "display" | "thumb";
6108
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
6109
+ bytes: number;
6110
+ width: number;
6111
+ height: number;
6112
+ }[];
6113
+ }[], 1, undefined>]>, undefined>;
5807
6114
  }, undefined>, undefined>, undefined>;
5808
6115
  /** Monotonic content version; echo it back as `expectedVersion` to update. */
5809
6116
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
5810
6117
  readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
6118
+ /** Personal read facts; optional for servers predating these fields. */
6119
+ readonly deletedAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
6120
+ readonly pinned: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6121
+ /** Only memberships the credential may read. */
6122
+ readonly bundles: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
6123
+ /** The caller's page views, never other people's or agent fetches. */
6124
+ readonly views: v.OptionalSchema<v.ObjectSchema<{
6125
+ readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
6126
+ readonly lastViewedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6127
+ }, undefined>, undefined>;
5811
6128
  readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
5812
6129
  /** True for a deliberate capture (Inbox). Not derivable from filing state. */
5813
6130
  readonly capture: v.BooleanSchema<undefined>;
@@ -6103,10 +6420,39 @@ export declare const CreateArtifactResponseSchema: v.ObjectSchema<{
6103
6420
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6104
6421
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6105
6422
  }, undefined>, undefined>;
6423
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
6424
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
6425
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
6426
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
6427
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
6428
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6429
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6430
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6431
+ }, undefined>, undefined>;
6432
+ }, undefined>, undefined>, v.MinLengthAction<{
6433
+ id?: string | undefined;
6434
+ parts: {
6435
+ role: "original" | "display" | "thumb";
6436
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
6437
+ bytes: number;
6438
+ width: number;
6439
+ height: number;
6440
+ }[];
6441
+ }[], 1, undefined>]>, undefined>;
6106
6442
  }, undefined>, undefined>, undefined>;
6107
6443
  /** Monotonic content version; echo it back as `expectedVersion` to update. */
6108
6444
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6109
6445
  readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
6446
+ /** Personal read facts; optional for servers predating these fields. */
6447
+ readonly deletedAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
6448
+ readonly pinned: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6449
+ /** Only memberships the credential may read. */
6450
+ readonly bundles: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
6451
+ /** The caller's page views, never other people's or agent fetches. */
6452
+ readonly views: v.OptionalSchema<v.ObjectSchema<{
6453
+ readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
6454
+ readonly lastViewedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6455
+ }, undefined>, undefined>;
6110
6456
  readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6111
6457
  /** True for a deliberate capture (Inbox). Not derivable from filing state. */
6112
6458
  readonly capture: v.BooleanSchema<undefined>;
@@ -6364,10 +6710,39 @@ export declare const UpdateArtifactResponseSchema: v.ObjectSchema<{
6364
6710
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6365
6711
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6366
6712
  }, undefined>, undefined>;
6713
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
6714
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
6715
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
6716
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
6717
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
6718
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6719
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6720
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6721
+ }, undefined>, undefined>;
6722
+ }, undefined>, undefined>, v.MinLengthAction<{
6723
+ id?: string | undefined;
6724
+ parts: {
6725
+ role: "original" | "display" | "thumb";
6726
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
6727
+ bytes: number;
6728
+ width: number;
6729
+ height: number;
6730
+ }[];
6731
+ }[], 1, undefined>]>, undefined>;
6367
6732
  }, undefined>, undefined>, undefined>;
6368
6733
  /** Monotonic content version; echo it back as `expectedVersion` to update. */
6369
6734
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6370
6735
  readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
6736
+ /** Personal read facts; optional for servers predating these fields. */
6737
+ readonly deletedAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
6738
+ readonly pinned: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
6739
+ /** Only memberships the credential may read. */
6740
+ readonly bundles: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
6741
+ /** The caller's page views, never other people's or agent fetches. */
6742
+ readonly views: v.OptionalSchema<v.ObjectSchema<{
6743
+ readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
6744
+ readonly lastViewedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
6745
+ }, undefined>, undefined>;
6371
6746
  readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6372
6747
  /** True for a deliberate capture (Inbox). Not derivable from filing state. */
6373
6748
  readonly capture: v.BooleanSchema<undefined>;
@@ -6628,6 +7003,7 @@ export declare const DEFAULT_LIST_ARTIFACTS_LIMIT = 100;
6628
7003
  */
6629
7004
  export declare const ListArtifactsQuerySchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
6630
7005
  readonly inbox: v.OptionalSchema<v.PicklistSchema<["true", "false"], "inbox must be true or false">, undefined>;
7006
+ readonly trash: v.OptionalSchema<v.PicklistSchema<["true", "false"], undefined>, undefined>;
6631
7007
  readonly bundle: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 128, undefined>]>, undefined>;
6632
7008
  readonly kind: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TransformAction<string, string[]>, v.ArraySchema<v.PicklistSchema<readonly ["markdown", "html", "code", "photo", "file", "guide"], `kind must be one of ${string}`>, undefined>, v.MinLengthAction<("markdown" | "guide" | "html" | "code" | "photo" | "file")[], 1, undefined>]>, undefined>;
6633
7009
  readonly since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "since must be an ISO timestamp">]>, undefined>;
@@ -6640,6 +7016,18 @@ export declare const ListArtifactsQuerySchema: v.SchemaWithPipe<readonly [v.Obje
6640
7016
  readonly cli: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 64, undefined>]>, undefined>;
6641
7017
  }, undefined>, v.CheckAction<{
6642
7018
  inbox?: "true" | "false" | undefined;
7019
+ trash?: "true" | "false" | undefined;
7020
+ bundle?: string | undefined;
7021
+ kind?: ("markdown" | "guide" | "html" | "code" | "photo" | "file")[] | undefined;
7022
+ since?: string | undefined;
7023
+ limit: number;
7024
+ cursor?: string | undefined;
7025
+ comments?: "none" | undefined;
7026
+ view?: "metadata" | undefined;
7027
+ cli?: string | undefined;
7028
+ }, "The inbox holds only unfiled captures, so inbox and bundle cannot be combined.">, v.CheckAction<{
7029
+ inbox?: "true" | "false" | undefined;
7030
+ trash?: "true" | "false" | undefined;
6643
7031
  bundle?: string | undefined;
6644
7032
  kind?: ("markdown" | "guide" | "html" | "code" | "photo" | "file")[] | undefined;
6645
7033
  since?: string | undefined;
@@ -6648,8 +7036,9 @@ export declare const ListArtifactsQuerySchema: v.SchemaWithPipe<readonly [v.Obje
6648
7036
  comments?: "none" | undefined;
6649
7037
  view?: "metadata" | undefined;
6650
7038
  cli?: string | undefined;
6651
- }, "The inbox holds only unfiled captures, so inbox and bundle cannot be combined.">, v.TransformAction<{
7039
+ }, "Trash and Inbox cannot be combined.">, v.TransformAction<{
6652
7040
  inbox?: "true" | "false" | undefined;
7041
+ trash?: "true" | "false" | undefined;
6653
7042
  bundle?: string | undefined;
6654
7043
  kind?: ("markdown" | "guide" | "html" | "code" | "photo" | "file")[] | undefined;
6655
7044
  since?: string | undefined;
@@ -6660,6 +7049,7 @@ export declare const ListArtifactsQuerySchema: v.SchemaWithPipe<readonly [v.Obje
6660
7049
  cli?: string | undefined;
6661
7050
  }, {
6662
7051
  inbox: boolean;
7052
+ trash: boolean;
6663
7053
  bundle?: string | undefined;
6664
7054
  kind?: ("markdown" | "guide" | "html" | "code" | "photo" | "file")[] | undefined;
6665
7055
  since?: string | undefined;
@@ -6691,10 +7081,39 @@ export declare const ListArtifactsResponseSchema: v.ObjectSchema<{
6691
7081
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6692
7082
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6693
7083
  }, undefined>, undefined>;
7084
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
7085
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
7086
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
7087
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
7088
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
7089
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7090
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7091
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7092
+ }, undefined>, undefined>;
7093
+ }, undefined>, undefined>, v.MinLengthAction<{
7094
+ id?: string | undefined;
7095
+ parts: {
7096
+ role: "original" | "display" | "thumb";
7097
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
7098
+ bytes: number;
7099
+ width: number;
7100
+ height: number;
7101
+ }[];
7102
+ }[], 1, undefined>]>, undefined>;
6694
7103
  }, undefined>, undefined>, undefined>;
6695
7104
  /** Monotonic content version; echo it back as `expectedVersion` to update. */
6696
7105
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6697
7106
  readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
7107
+ /** Personal read facts; optional for servers predating these fields. */
7108
+ readonly deletedAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
7109
+ readonly pinned: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7110
+ /** Only memberships the credential may read. */
7111
+ readonly bundles: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
7112
+ /** The caller's page views, never other people's or agent fetches. */
7113
+ readonly views: v.OptionalSchema<v.ObjectSchema<{
7114
+ readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
7115
+ readonly lastViewedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
7116
+ }, undefined>, undefined>;
6698
7117
  readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6699
7118
  /** True for a deliberate capture (Inbox). Not derivable from filing state. */
6700
7119
  readonly capture: v.BooleanSchema<undefined>;
@@ -6962,10 +7381,39 @@ export declare const ListArtifactMetadataResponseSchema: v.ObjectSchema<{
6962
7381
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6963
7382
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6964
7383
  }, undefined>, undefined>;
7384
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
7385
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
7386
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
7387
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
7388
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
7389
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7390
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7391
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7392
+ }, undefined>, undefined>;
7393
+ }, undefined>, undefined>, v.MinLengthAction<{
7394
+ id?: string | undefined;
7395
+ parts: {
7396
+ role: "original" | "display" | "thumb";
7397
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
7398
+ bytes: number;
7399
+ width: number;
7400
+ height: number;
7401
+ }[];
7402
+ }[], 1, undefined>]>, undefined>;
6965
7403
  }, undefined>, undefined>, undefined>;
6966
7404
  /** Monotonic content version; echo it back as `expectedVersion` to update. */
6967
7405
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
6968
7406
  readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
7407
+ /** Personal read facts; optional for servers predating these fields. */
7408
+ readonly deletedAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
7409
+ readonly pinned: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7410
+ /** Only memberships the credential may read. */
7411
+ readonly bundles: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
7412
+ /** The caller's page views, never other people's or agent fetches. */
7413
+ readonly views: v.OptionalSchema<v.ObjectSchema<{
7414
+ readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
7415
+ readonly lastViewedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
7416
+ }, undefined>, undefined>;
6969
7417
  readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
6970
7418
  /** True for a deliberate capture (Inbox). Not derivable from filing state. */
6971
7419
  readonly capture: v.BooleanSchema<undefined>;
@@ -7395,10 +7843,39 @@ export declare const MarkDoneResponseSchema: v.ObjectSchema<{
7395
7843
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7396
7844
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7397
7845
  }, undefined>, undefined>;
7846
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
7847
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
7848
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
7849
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
7850
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
7851
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7852
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7853
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7854
+ }, undefined>, undefined>;
7855
+ }, undefined>, undefined>, v.MinLengthAction<{
7856
+ id?: string | undefined;
7857
+ parts: {
7858
+ role: "original" | "display" | "thumb";
7859
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
7860
+ bytes: number;
7861
+ width: number;
7862
+ height: number;
7863
+ }[];
7864
+ }[], 1, undefined>]>, undefined>;
7398
7865
  }, undefined>, undefined>, undefined>;
7399
7866
  /** Monotonic content version; echo it back as `expectedVersion` to update. */
7400
7867
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7401
7868
  readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
7869
+ /** Personal read facts; optional for servers predating these fields. */
7870
+ readonly deletedAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
7871
+ readonly pinned: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
7872
+ /** Only memberships the credential may read. */
7873
+ readonly bundles: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
7874
+ /** The caller's page views, never other people's or agent fetches. */
7875
+ readonly views: v.OptionalSchema<v.ObjectSchema<{
7876
+ readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
7877
+ readonly lastViewedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
7878
+ }, undefined>, undefined>;
7402
7879
  readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7403
7880
  /** True for a deliberate capture (Inbox). Not derivable from filing state. */
7404
7881
  readonly capture: v.BooleanSchema<undefined>;
@@ -7658,10 +8135,39 @@ export declare const DeleteArtifactResponseSchema: v.ObjectSchema<{
7658
8135
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7659
8136
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7660
8137
  }, undefined>, undefined>;
8138
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
8139
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
8140
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
8141
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
8142
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
8143
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
8144
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
8145
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
8146
+ }, undefined>, undefined>;
8147
+ }, undefined>, undefined>, v.MinLengthAction<{
8148
+ id?: string | undefined;
8149
+ parts: {
8150
+ role: "original" | "display" | "thumb";
8151
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
8152
+ bytes: number;
8153
+ width: number;
8154
+ height: number;
8155
+ }[];
8156
+ }[], 1, undefined>]>, undefined>;
7661
8157
  }, undefined>, undefined>, undefined>;
7662
8158
  /** Monotonic content version; echo it back as `expectedVersion` to update. */
7663
8159
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7664
8160
  readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
8161
+ /** Personal read facts; optional for servers predating these fields. */
8162
+ readonly deletedAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
8163
+ readonly pinned: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
8164
+ /** Only memberships the credential may read. */
8165
+ readonly bundles: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
8166
+ /** The caller's page views, never other people's or agent fetches. */
8167
+ readonly views: v.OptionalSchema<v.ObjectSchema<{
8168
+ readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
8169
+ readonly lastViewedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
8170
+ }, undefined>, undefined>;
7665
8171
  readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7666
8172
  /** True for a deliberate capture (Inbox). Not derivable from filing state. */
7667
8173
  readonly capture: v.BooleanSchema<undefined>;
@@ -7920,10 +8426,39 @@ export declare const WithdrawArtifactResponseSchema: v.ObjectSchema<{
7920
8426
  readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7921
8427
  readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7922
8428
  }, undefined>, undefined>;
8429
+ readonly images: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
8430
+ readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
8431
+ readonly parts: v.ArraySchema<v.ObjectSchema<{
8432
+ readonly role: v.PicklistSchema<readonly ["original", "display", "thumb"], undefined>;
8433
+ readonly mediaType: v.PicklistSchema<readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/heic", "image/heif"], undefined>;
8434
+ readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
8435
+ readonly width: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
8436
+ readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
8437
+ }, undefined>, undefined>;
8438
+ }, undefined>, undefined>, v.MinLengthAction<{
8439
+ id?: string | undefined;
8440
+ parts: {
8441
+ role: "original" | "display" | "thumb";
8442
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
8443
+ bytes: number;
8444
+ width: number;
8445
+ height: number;
8446
+ }[];
8447
+ }[], 1, undefined>]>, undefined>;
7923
8448
  }, undefined>, undefined>, undefined>;
7924
8449
  /** Monotonic content version; echo it back as `expectedVersion` to update. */
7925
8450
  readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
7926
8451
  readonly state: v.PicklistSchema<["live", "deleted", "removed"], undefined>;
8452
+ /** Personal read facts; optional for servers predating these fields. */
8453
+ readonly deletedAt: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
8454
+ readonly pinned: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
8455
+ /** Only memberships the credential may read. */
8456
+ readonly bundles: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
8457
+ /** The caller's page views, never other people's or agent fetches. */
8458
+ readonly views: v.OptionalSchema<v.ObjectSchema<{
8459
+ readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
8460
+ readonly lastViewedAt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
8461
+ }, undefined>, undefined>;
7927
8462
  readonly workspaceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
7928
8463
  /** True for a deliberate capture (Inbox). Not derivable from filing state. */
7929
8464
  readonly capture: v.BooleanSchema<undefined>;
@@ -8630,6 +9165,17 @@ export declare const DashboardSkillUsageSchema: v.ObjectSchema<{
8630
9165
  }, undefined>, undefined>;
8631
9166
  }, undefined>;
8632
9167
  export declare const MAX_ACTION_FILE_PATH_LENGTH = 1024;
9168
+ /**
9169
+ * A file's path relative to the root of the repository it sits in, as the CLI
9170
+ * records it beside an action's own path: POSIX separators, no leading `/`, no
9171
+ * drive letter, and no empty, `.` or `..` segment, so it can never name a
9172
+ * place outside the repository or carry a machine's checkout location.
9173
+ *
9174
+ * The CLI produces only this shape; the check is here because the server
9175
+ * groups sessions by it, and a value that escaped the repository would group
9176
+ * under an area that does not exist.
9177
+ */
9178
+ export declare const ActionRepoPathSchema: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 1024, undefined>, v.RegexAction<string, "repoPath must not contain control or format characters, or backslashes">, v.CheckAction<string, "repoPath must be relative to the repository root, with no empty, . or .. segment">]>;
8633
9179
  export declare const DashboardSyncActionSchema: v.ObjectSchema<{
8634
9180
  readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 128, undefined>, v.RegexAction<string, "id must not contain whitespace or control characters">]>, undefined>;
8635
9181
  readonly sessionId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -8657,6 +9203,15 @@ export declare const DashboardSyncActionSchema: v.ObjectSchema<{
8657
9203
  * change the uploader's own number.
8658
9204
  */
8659
9205
  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>;
9206
+ /**
9207
+ * The file's path relative to its repository root, when the path the action
9208
+ * names lies inside the git repository the session ran in. Sent beside
9209
+ * `filePaths`, never instead of it: that one is the path as the harness gave
9210
+ * it, usually absolute, and this one is where the file sits in the repo, so
9211
+ * sessions on different machines can be grouped by the area they worked in.
9212
+ * Computed by the CLI, the one place that knows the repository root.
9213
+ */
9214
+ readonly repoPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 1024, undefined>, v.RegexAction<string, "repoPath must not contain control or format characters, or backslashes">, v.CheckAction<string, "repoPath must be relative to the repository root, with no empty, . or .. segment">]>, undefined>;
8660
9215
  readonly verdict: v.OptionalSchema<v.PicklistSchema<["aligned", "unguided", "misaligned"], undefined>, undefined>;
8661
9216
  readonly gradingTier: v.OptionalSchema<v.PicklistSchema<["pattern_match", "cached", "llm", "batch", "unguided"], undefined>, undefined>;
8662
9217
  readonly guideIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
@@ -8934,6 +9489,15 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
8934
9489
  * change the uploader's own number.
8935
9490
  */
8936
9491
  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>;
9492
+ /**
9493
+ * The file's path relative to its repository root, when the path the action
9494
+ * names lies inside the git repository the session ran in. Sent beside
9495
+ * `filePaths`, never instead of it: that one is the path as the harness gave
9496
+ * it, usually absolute, and this one is where the file sits in the repo, so
9497
+ * sessions on different machines can be grouped by the area they worked in.
9498
+ * Computed by the CLI, the one place that knows the repository root.
9499
+ */
9500
+ readonly repoPath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 1024, undefined>, v.RegexAction<string, "repoPath must not contain control or format characters, or backslashes">, v.CheckAction<string, "repoPath must be relative to the repository root, with no empty, . or .. segment">]>, undefined>;
8937
9501
  readonly verdict: v.OptionalSchema<v.PicklistSchema<["aligned", "unguided", "misaligned"], undefined>, undefined>;
8938
9502
  readonly gradingTier: v.OptionalSchema<v.PicklistSchema<["pattern_match", "cached", "llm", "batch", "unguided"], undefined>, undefined>;
8939
9503
  readonly guideIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
@@ -8996,6 +9560,7 @@ export declare const DashboardSyncRequestSchema: v.ObjectSchema<{
8996
9560
  summary: string;
8997
9561
  filePaths?: string[] | undefined;
8998
9562
  itemId?: string | undefined;
9563
+ repoPath?: string | undefined;
8999
9564
  verdict?: "aligned" | "unguided" | "misaligned" | undefined;
9000
9565
  gradingTier?: "unguided" | "pattern_match" | "cached" | "llm" | "batch" | undefined;
9001
9566
  guideIds?: string[] | undefined;
@@ -9321,6 +9886,16 @@ export declare const ActionEntrySchema: v.ObjectSchema<{
9321
9886
  * `itemId`.
9322
9887
  */
9323
9888
  readonly itemIds: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, undefined>;
9889
+ /**
9890
+ * `filePath` relative to the root of the git repository the call ran in, when
9891
+ * it lies inside it. Absent for a path outside the repository, for a folder
9892
+ * that is not a git repository, and for the repository root itself. Sent as
9893
+ * the action's `repoPath` only when it passes `ActionRepoPathSchema`.
9894
+ *
9895
+ * A plain string here, not that schema: a run log line that failed to parse
9896
+ * would lose the whole action, and a bad path should lose only the path.
9897
+ */
9898
+ readonly repoPath: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
9324
9899
  /**
9325
9900
  * Where this session's transcript lives on *this machine*, as the agent
9326
9901
  * itself reported it.
@@ -9759,13 +10334,13 @@ export declare const GuideHistoryGuideSchema: v.ObjectSchema<{
9759
10334
  readonly root: v.NullableSchema<v.PicklistSchema<["project", "global"], undefined>, undefined>;
9760
10335
  }, undefined>;
9761
10336
  /**
9762
- * The newest stored failure-pattern analysis of the guide, as the reader's own
9763
- * dashboard shows it (`drafted-guide-suggestions` slice 7).
10337
+ * The caller's newest stored failure-pattern analysis of the guide
10338
+ * (`drafted-guide-suggestions` slice 7), served through artifact feedback.
9764
10339
  *
9765
10340
  * **The caller's own analysis only.** An analysis reads the caller's verdicts,
9766
10341
  * so a workspace-mate's is never returned, the same rule the verdicts follow.
9767
10342
  *
9768
- * **Staleness is derived on read**, exactly as the dashboard derives it: the
10343
+ * **Staleness is derived on read**: the
9769
10344
  * guide's wording changed since (`revision_changed`), or failures of the same
9770
10345
  * wording arrived that it has not read (`new_failures`, with how many). A stale
9771
10346
  * analysis is still what it found; it is reported, never withheld.
@@ -12156,13 +12731,6 @@ export declare function parseRawGuideFilePayload(data: unknown): {
12156
12731
  expectedVersion?: number | undefined;
12157
12732
  skippedMemberPaths?: string[] | undefined;
12158
12733
  };
12159
- export declare function parseGuideMemberFilesResponse(data: unknown): {
12160
- memberFiles: {
12161
- path: string;
12162
- content: string;
12163
- contentHash: string;
12164
- }[];
12165
- };
12166
12734
  export declare function parseBundleListResponse(data: unknown): {
12167
12735
  bundles: {
12168
12736
  home?: string | undefined;
@@ -12249,6 +12817,7 @@ export declare function parseSubscribeBundleResponse(data: unknown): {
12249
12817
  export declare function parseResolveSubscriptionsRequest(data: unknown): {
12250
12818
  repoBundleIds: string[];
12251
12819
  repoBundleAddresses?: string[] | undefined;
12820
+ machineId?: string | undefined;
12252
12821
  };
12253
12822
  export declare function parseResolveSubscriptionsResponse(data: unknown): {
12254
12823
  bundles: {
@@ -12265,6 +12834,7 @@ export declare function parseResolveSubscriptionsResponse(data: unknown): {
12265
12834
  deliver?: "global" | "repo" | undefined;
12266
12835
  home?: string | undefined;
12267
12836
  muted?: string[] | undefined;
12837
+ accountMuted?: string[] | undefined;
12268
12838
  }[];
12269
12839
  unresolved: {
12270
12840
  id: string;
@@ -12319,6 +12889,16 @@ export declare function parseContextItemsResponse(data: unknown): {
12319
12889
  width: number;
12320
12890
  height: number;
12321
12891
  }[];
12892
+ images?: {
12893
+ id?: string | undefined;
12894
+ parts: {
12895
+ role: "original" | "display" | "thumb";
12896
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
12897
+ bytes: number;
12898
+ width: number;
12899
+ height: number;
12900
+ }[];
12901
+ }[] | undefined;
12322
12902
  } | null | undefined;
12323
12903
  origin?: string | null | undefined;
12324
12904
  version?: number | undefined;
@@ -12411,6 +12991,16 @@ export declare function parseBundleArtifactsResponse(data: unknown): {
12411
12991
  width: number;
12412
12992
  height: number;
12413
12993
  }[];
12994
+ images?: {
12995
+ id?: string | undefined;
12996
+ parts: {
12997
+ role: "original" | "display" | "thumb";
12998
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
12999
+ bytes: number;
13000
+ width: number;
13001
+ height: number;
13002
+ }[];
13003
+ }[] | undefined;
12414
13004
  } | null | undefined;
12415
13005
  origin?: string | null | undefined;
12416
13006
  version?: number | undefined;
@@ -12509,6 +13099,16 @@ export declare function parseCaptureResponse(data: unknown): {
12509
13099
  width: number;
12510
13100
  height: number;
12511
13101
  }[];
13102
+ images?: {
13103
+ id?: string | undefined;
13104
+ parts: {
13105
+ role: "original" | "display" | "thumb";
13106
+ mediaType: "image/jpeg" | "image/png" | "image/webp" | "image/gif" | "image/heic" | "image/heif";
13107
+ bytes: number;
13108
+ width: number;
13109
+ height: number;
13110
+ }[];
13111
+ }[] | undefined;
12512
13112
  } | null | undefined;
12513
13113
  source?: string | null | undefined;
12514
13114
  version?: number | undefined;
@@ -12538,6 +13138,7 @@ export declare function parseDashboardSyncRequest(data: unknown): {
12538
13138
  summary: string;
12539
13139
  filePaths?: string[] | undefined;
12540
13140
  itemId?: string | undefined;
13141
+ repoPath?: string | undefined;
12541
13142
  verdict?: "aligned" | "unguided" | "misaligned" | undefined;
12542
13143
  gradingTier?: "unguided" | "pattern_match" | "cached" | "llm" | "batch" | undefined;
12543
13144
  guideIds?: string[] | undefined;
@@ -12645,6 +13246,7 @@ export declare function parseActionEntry(data: unknown): {
12645
13246
  itemIds?: {
12646
13247
  [x: string]: string;
12647
13248
  } | undefined;
13249
+ repoPath?: string | undefined;
12648
13250
  transcriptPath?: string | undefined;
12649
13251
  repoId?: string | undefined;
12650
13252
  projectId?: string | undefined;
@@ -12910,7 +13512,7 @@ export declare function parseSessionGradeResponse(data: unknown): {
12910
13512
  endedAt: string | null;
12911
13513
  status: "open" | "closed";
12912
13514
  };
12913
- state: "pending" | "graded" | "nothing_to_grade" | "expired" | "grading_off";
13515
+ state: "pending" | "expired" | "graded" | "nothing_to_grade" | "grading_off";
12914
13516
  gradeFailedAttempts?: number | undefined;
12915
13517
  grade: {
12916
13518
  summary: string | null;
@@ -12939,7 +13541,7 @@ export declare function parseSessionDigestResponse(data: unknown): {
12939
13541
  endedAt: string | null;
12940
13542
  status: "open" | "closed";
12941
13543
  };
12942
- state: "pending" | "graded" | "nothing_to_grade" | "expired" | "grading_off";
13544
+ state: "pending" | "expired" | "graded" | "nothing_to_grade" | "grading_off";
12943
13545
  gradeFailedAttempts?: number | undefined;
12944
13546
  grade: {
12945
13547
  summary: string | null;