rivet-design 0.9.5 → 0.9.6

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 (42) hide show
  1. package/dist/mcp/agent-variants/SessionStore.d.ts +10 -2
  2. package/dist/mcp/agent-variants/SessionStore.d.ts.map +1 -1
  3. package/dist/mcp/agent-variants/SessionStore.js +82 -22
  4. package/dist/mcp/agent-variants/SessionStore.js.map +1 -1
  5. package/dist/mcp/agent-variants/WorktreeOrchestrator.d.ts +4 -0
  6. package/dist/mcp/agent-variants/WorktreeOrchestrator.d.ts.map +1 -1
  7. package/dist/mcp/agent-variants/WorktreeOrchestrator.js +430 -35
  8. package/dist/mcp/agent-variants/WorktreeOrchestrator.js.map +1 -1
  9. package/dist/mcp/agent-variants/contracts.d.ts +389 -129
  10. package/dist/mcp/agent-variants/contracts.d.ts.map +1 -1
  11. package/dist/mcp/agent-variants/contracts.js +90 -36
  12. package/dist/mcp/agent-variants/contracts.js.map +1 -1
  13. package/dist/mcp/agent-variants/createZeroToOneTool.d.ts +32 -13
  14. package/dist/mcp/agent-variants/createZeroToOneTool.d.ts.map +1 -1
  15. package/dist/mcp/agent-variants/createZeroToOneTool.js +1 -1
  16. package/dist/mcp/agent-variants/createZeroToOneTool.js.map +1 -1
  17. package/dist/mcp/agent-variants/tools.d.ts.map +1 -1
  18. package/dist/mcp/agent-variants/tools.js +9 -2
  19. package/dist/mcp/agent-variants/tools.js.map +1 -1
  20. package/dist/routes/agentVariants.d.ts.map +1 -1
  21. package/dist/routes/agentVariants.js +120 -37
  22. package/dist/routes/agentVariants.js.map +1 -1
  23. package/dist/services/VariantHistoryService.d.ts +64 -1
  24. package/dist/services/VariantHistoryService.d.ts.map +1 -1
  25. package/dist/services/VariantHistoryService.js +148 -18
  26. package/dist/services/VariantHistoryService.js.map +1 -1
  27. package/dist/utils/skills/claude-skill.d.ts +1 -1
  28. package/dist/utils/skills/claude-skill.js +1 -1
  29. package/dist/utils/skills/cursor-rules.d.ts +1 -1
  30. package/dist/utils/skills/cursor-rules.js +1 -1
  31. package/dist/utils/skills/describe-motion-protocol.d.ts +11 -0
  32. package/dist/utils/skills/describe-motion-protocol.d.ts.map +1 -0
  33. package/dist/utils/skills/describe-motion-protocol.js +216 -0
  34. package/dist/utils/skills/describe-motion-protocol.js.map +1 -0
  35. package/dist/utils/skills/shared-variants-protocol.d.ts.map +1 -1
  36. package/dist/utils/skills/shared-variants-protocol.js +23 -17
  37. package/dist/utils/skills/shared-variants-protocol.js.map +1 -1
  38. package/package.json +1 -1
  39. package/src/ui/dist/assets/main-BX1XfsOq.css +1 -0
  40. package/src/ui/dist/assets/{main-SuZlKEi0.js → main-CO7W1r28.js} +39 -39
  41. package/src/ui/dist/index.html +2 -2
  42. package/src/ui/dist/assets/main-OdmwI8Od.css +0 -1
package/dist/mcp/agent-variants/contracts.d.ts CHANGED
@@ -46,52 +46,93 @@ export declare const projectContextExisting: z.ZodObject<{
46
46
  }>;
47
47
  export declare const sourceIntentRoleSchema: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
48
48
  export declare const sourceIntentConfidenceSchema: z.ZodEnum<["low", "medium", "high"]>;
49
- export declare const sourceIntentEntrySchema: z.ZodObject<{
50
- url: z.ZodString;
49
+ /**
50
+ * One classified source in the agent's `sourceIntent`. Identified by exactly
51
+ * one of:
52
+ * - `url`: an inspiration URL the user provided
53
+ * - `imageRef`: a stable per-session reference of the form `image:<index>`
54
+ * pointing at an image-kind entry in `sourceArtifacts` (visualBrief or
55
+ * screenshotNotes). Indexed over image-kind artifacts only, so the ref
56
+ * survives reordering of text-only artifacts.
57
+ */
58
+ export declare const sourceIntentEntrySchema: z.ZodEffects<z.ZodObject<{
59
+ url: z.ZodOptional<z.ZodString>;
60
+ imageRef: z.ZodOptional<z.ZodString>;
51
61
  role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
52
62
  confidence: z.ZodEnum<["low", "medium", "high"]>;
53
63
  reason: z.ZodString;
54
64
  }, "strip", z.ZodTypeAny, {
55
65
  reason: string;
56
- url: string;
57
66
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
58
67
  confidence: "low" | "medium" | "high";
68
+ url?: string | undefined;
69
+ imageRef?: string | undefined;
59
70
  }, {
60
71
  reason: string;
61
- url: string;
62
72
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
63
73
  confidence: "low" | "medium" | "high";
74
+ url?: string | undefined;
75
+ imageRef?: string | undefined;
76
+ }>, {
77
+ reason: string;
78
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
79
+ confidence: "low" | "medium" | "high";
80
+ url?: string | undefined;
81
+ imageRef?: string | undefined;
82
+ }, {
83
+ reason: string;
84
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
85
+ confidence: "low" | "medium" | "high";
86
+ url?: string | undefined;
87
+ imageRef?: string | undefined;
64
88
  }>;
65
89
  export declare const sourceIntentArtifactSchema: z.ZodObject<{
66
- sources: z.ZodArray<z.ZodObject<{
67
- url: z.ZodString;
90
+ sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
91
+ url: z.ZodOptional<z.ZodString>;
92
+ imageRef: z.ZodOptional<z.ZodString>;
68
93
  role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
69
94
  confidence: z.ZodEnum<["low", "medium", "high"]>;
70
95
  reason: z.ZodString;
71
96
  }, "strip", z.ZodTypeAny, {
72
97
  reason: string;
73
- url: string;
74
98
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
75
99
  confidence: "low" | "medium" | "high";
100
+ url?: string | undefined;
101
+ imageRef?: string | undefined;
102
+ }, {
103
+ reason: string;
104
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
105
+ confidence: "low" | "medium" | "high";
106
+ url?: string | undefined;
107
+ imageRef?: string | undefined;
108
+ }>, {
109
+ reason: string;
110
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
111
+ confidence: "low" | "medium" | "high";
112
+ url?: string | undefined;
113
+ imageRef?: string | undefined;
76
114
  }, {
77
115
  reason: string;
78
- url: string;
79
116
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
80
117
  confidence: "low" | "medium" | "high";
118
+ url?: string | undefined;
119
+ imageRef?: string | undefined;
81
120
  }>, "many">;
82
121
  }, "strip", z.ZodTypeAny, {
83
122
  sources: {
84
123
  reason: string;
85
- url: string;
86
124
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
87
125
  confidence: "low" | "medium" | "high";
126
+ url?: string | undefined;
127
+ imageRef?: string | undefined;
88
128
  }[];
89
129
  }, {
90
130
  sources: {
91
131
  reason: string;
92
- url: string;
93
132
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
94
133
  confidence: "low" | "medium" | "high";
134
+ url?: string | undefined;
135
+ imageRef?: string | undefined;
95
136
  }[];
96
137
  }>;
97
138
  export type SourceIntentRole = z.infer<typeof sourceIntentRoleSchema>;
@@ -120,17 +161,17 @@ export declare const designContextEntrySchema: z.ZodDiscriminatedUnion<"kind", [
120
161
  label: string;
121
162
  content: string;
122
163
  }>]>;
123
- export declare const sourceArtifactKindSchema: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
164
+ export declare const sourceArtifactKindSchema: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
124
165
  export declare const sourceArtifactInputSchema: z.ZodObject<{
125
- kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
166
+ kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
126
167
  label: z.ZodString;
127
168
  content: z.ZodString;
128
169
  }, "strip", z.ZodTypeAny, {
129
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
170
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
130
171
  label: string;
131
172
  content: string;
132
173
  }, {
133
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
174
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
134
175
  label: string;
135
176
  content: string;
136
177
  }>;
@@ -197,15 +238,15 @@ export declare const sourceContextInputSchema: z.ZodObject<{
197
238
  sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
198
239
  preserveBrand: z.ZodOptional<z.ZodBoolean>;
199
240
  sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
200
- kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
241
+ kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
201
242
  label: z.ZodString;
202
243
  content: z.ZodString;
203
244
  }, "strip", z.ZodTypeAny, {
204
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
245
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
205
246
  label: string;
206
247
  content: string;
207
248
  }, {
208
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
249
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
209
250
  label: string;
210
251
  content: string;
211
252
  }>, "many">>;
@@ -255,35 +296,52 @@ export declare const sourceContextInputSchema: z.ZodObject<{
255
296
  risks?: string[] | undefined;
256
297
  }>>;
257
298
  sourceIntent: z.ZodOptional<z.ZodObject<{
258
- sources: z.ZodArray<z.ZodObject<{
259
- url: z.ZodString;
299
+ sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
300
+ url: z.ZodOptional<z.ZodString>;
301
+ imageRef: z.ZodOptional<z.ZodString>;
260
302
  role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
261
303
  confidence: z.ZodEnum<["low", "medium", "high"]>;
262
304
  reason: z.ZodString;
263
305
  }, "strip", z.ZodTypeAny, {
264
306
  reason: string;
265
- url: string;
266
307
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
267
308
  confidence: "low" | "medium" | "high";
309
+ url?: string | undefined;
310
+ imageRef?: string | undefined;
268
311
  }, {
269
312
  reason: string;
270
- url: string;
271
313
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
272
314
  confidence: "low" | "medium" | "high";
315
+ url?: string | undefined;
316
+ imageRef?: string | undefined;
317
+ }>, {
318
+ reason: string;
319
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
320
+ confidence: "low" | "medium" | "high";
321
+ url?: string | undefined;
322
+ imageRef?: string | undefined;
323
+ }, {
324
+ reason: string;
325
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
326
+ confidence: "low" | "medium" | "high";
327
+ url?: string | undefined;
328
+ imageRef?: string | undefined;
273
329
  }>, "many">;
274
330
  }, "strip", z.ZodTypeAny, {
275
331
  sources: {
276
332
  reason: string;
277
- url: string;
278
333
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
279
334
  confidence: "low" | "medium" | "high";
335
+ url?: string | undefined;
336
+ imageRef?: string | undefined;
280
337
  }[];
281
338
  }, {
282
339
  sources: {
283
340
  reason: string;
284
- url: string;
285
341
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
286
342
  confidence: "low" | "medium" | "high";
343
+ url?: string | undefined;
344
+ imageRef?: string | undefined;
287
345
  }[];
288
346
  }>>;
289
347
  designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
@@ -291,7 +349,7 @@ export declare const sourceContextInputSchema: z.ZodObject<{
291
349
  sourceUrls?: string[] | undefined;
292
350
  preserveBrand?: boolean | undefined;
293
351
  sourceArtifacts?: {
294
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
352
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
295
353
  label: string;
296
354
  content: string;
297
355
  }[] | undefined;
@@ -311,9 +369,10 @@ export declare const sourceContextInputSchema: z.ZodObject<{
311
369
  sourceIntent?: {
312
370
  sources: {
313
371
  reason: string;
314
- url: string;
315
372
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
316
373
  confidence: "low" | "medium" | "high";
374
+ url?: string | undefined;
375
+ imageRef?: string | undefined;
317
376
  }[];
318
377
  } | undefined;
319
378
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -321,7 +380,7 @@ export declare const sourceContextInputSchema: z.ZodObject<{
321
380
  sourceUrls?: string[] | undefined;
322
381
  preserveBrand?: boolean | undefined;
323
382
  sourceArtifacts?: {
324
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
383
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
325
384
  label: string;
326
385
  content: string;
327
386
  }[] | undefined;
@@ -341,9 +400,10 @@ export declare const sourceContextInputSchema: z.ZodObject<{
341
400
  sourceIntent?: {
342
401
  sources: {
343
402
  reason: string;
344
- url: string;
345
403
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
346
404
  confidence: "low" | "medium" | "high";
405
+ url?: string | undefined;
406
+ imageRef?: string | undefined;
347
407
  }[];
348
408
  } | undefined;
349
409
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -460,15 +520,15 @@ export declare const projectContextFresh: z.ZodObject<{
460
520
  sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
461
521
  preserveBrand: z.ZodOptional<z.ZodBoolean>;
462
522
  sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
463
- kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
523
+ kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
464
524
  label: z.ZodString;
465
525
  content: z.ZodString;
466
526
  }, "strip", z.ZodTypeAny, {
467
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
527
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
468
528
  label: string;
469
529
  content: string;
470
530
  }, {
471
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
531
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
472
532
  label: string;
473
533
  content: string;
474
534
  }>, "many">>;
@@ -518,35 +578,52 @@ export declare const projectContextFresh: z.ZodObject<{
518
578
  risks?: string[] | undefined;
519
579
  }>>;
520
580
  sourceIntent: z.ZodOptional<z.ZodObject<{
521
- sources: z.ZodArray<z.ZodObject<{
522
- url: z.ZodString;
581
+ sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
582
+ url: z.ZodOptional<z.ZodString>;
583
+ imageRef: z.ZodOptional<z.ZodString>;
523
584
  role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
524
585
  confidence: z.ZodEnum<["low", "medium", "high"]>;
525
586
  reason: z.ZodString;
526
587
  }, "strip", z.ZodTypeAny, {
527
588
  reason: string;
528
- url: string;
529
589
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
530
590
  confidence: "low" | "medium" | "high";
591
+ url?: string | undefined;
592
+ imageRef?: string | undefined;
531
593
  }, {
532
594
  reason: string;
533
- url: string;
534
595
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
535
596
  confidence: "low" | "medium" | "high";
597
+ url?: string | undefined;
598
+ imageRef?: string | undefined;
599
+ }>, {
600
+ reason: string;
601
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
602
+ confidence: "low" | "medium" | "high";
603
+ url?: string | undefined;
604
+ imageRef?: string | undefined;
605
+ }, {
606
+ reason: string;
607
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
608
+ confidence: "low" | "medium" | "high";
609
+ url?: string | undefined;
610
+ imageRef?: string | undefined;
536
611
  }>, "many">;
537
612
  }, "strip", z.ZodTypeAny, {
538
613
  sources: {
539
614
  reason: string;
540
- url: string;
541
615
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
542
616
  confidence: "low" | "medium" | "high";
617
+ url?: string | undefined;
618
+ imageRef?: string | undefined;
543
619
  }[];
544
620
  }, {
545
621
  sources: {
546
622
  reason: string;
547
- url: string;
548
623
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
549
624
  confidence: "low" | "medium" | "high";
625
+ url?: string | undefined;
626
+ imageRef?: string | undefined;
550
627
  }[];
551
628
  }>>;
552
629
  designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
@@ -554,7 +631,7 @@ export declare const projectContextFresh: z.ZodObject<{
554
631
  sourceUrls?: string[] | undefined;
555
632
  preserveBrand?: boolean | undefined;
556
633
  sourceArtifacts?: {
557
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
634
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
558
635
  label: string;
559
636
  content: string;
560
637
  }[] | undefined;
@@ -574,9 +651,10 @@ export declare const projectContextFresh: z.ZodObject<{
574
651
  sourceIntent?: {
575
652
  sources: {
576
653
  reason: string;
577
- url: string;
578
654
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
579
655
  confidence: "low" | "medium" | "high";
656
+ url?: string | undefined;
657
+ imageRef?: string | undefined;
580
658
  }[];
581
659
  } | undefined;
582
660
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -584,7 +662,7 @@ export declare const projectContextFresh: z.ZodObject<{
584
662
  sourceUrls?: string[] | undefined;
585
663
  preserveBrand?: boolean | undefined;
586
664
  sourceArtifacts?: {
587
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
665
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
588
666
  label: string;
589
667
  content: string;
590
668
  }[] | undefined;
@@ -604,9 +682,10 @@ export declare const projectContextFresh: z.ZodObject<{
604
682
  sourceIntent?: {
605
683
  sources: {
606
684
  reason: string;
607
- url: string;
608
685
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
609
686
  confidence: "low" | "medium" | "high";
687
+ url?: string | undefined;
688
+ imageRef?: string | undefined;
610
689
  }[];
611
690
  } | undefined;
612
691
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -675,7 +754,7 @@ export declare const projectContextFresh: z.ZodObject<{
675
754
  sourceUrls?: string[] | undefined;
676
755
  preserveBrand?: boolean | undefined;
677
756
  sourceArtifacts?: {
678
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
757
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
679
758
  label: string;
680
759
  content: string;
681
760
  }[] | undefined;
@@ -695,9 +774,10 @@ export declare const projectContextFresh: z.ZodObject<{
695
774
  sourceIntent?: {
696
775
  sources: {
697
776
  reason: string;
698
- url: string;
699
777
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
700
778
  confidence: "low" | "medium" | "high";
779
+ url?: string | undefined;
780
+ imageRef?: string | undefined;
701
781
  }[];
702
782
  } | undefined;
703
783
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -732,7 +812,7 @@ export declare const projectContextFresh: z.ZodObject<{
732
812
  sourceUrls?: string[] | undefined;
733
813
  preserveBrand?: boolean | undefined;
734
814
  sourceArtifacts?: {
735
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
815
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
736
816
  label: string;
737
817
  content: string;
738
818
  }[] | undefined;
@@ -752,9 +832,10 @@ export declare const projectContextFresh: z.ZodObject<{
752
832
  sourceIntent?: {
753
833
  sources: {
754
834
  reason: string;
755
- url: string;
756
835
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
757
836
  confidence: "low" | "medium" | "high";
837
+ url?: string | undefined;
838
+ imageRef?: string | undefined;
758
839
  }[];
759
840
  } | undefined;
760
841
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -822,15 +903,15 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
822
903
  sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
823
904
  preserveBrand: z.ZodOptional<z.ZodBoolean>;
824
905
  sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
825
- kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
906
+ kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
826
907
  label: z.ZodString;
827
908
  content: z.ZodString;
828
909
  }, "strip", z.ZodTypeAny, {
829
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
910
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
830
911
  label: string;
831
912
  content: string;
832
913
  }, {
833
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
914
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
834
915
  label: string;
835
916
  content: string;
836
917
  }>, "many">>;
@@ -880,35 +961,52 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
880
961
  risks?: string[] | undefined;
881
962
  }>>;
882
963
  sourceIntent: z.ZodOptional<z.ZodObject<{
883
- sources: z.ZodArray<z.ZodObject<{
884
- url: z.ZodString;
964
+ sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
965
+ url: z.ZodOptional<z.ZodString>;
966
+ imageRef: z.ZodOptional<z.ZodString>;
885
967
  role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
886
968
  confidence: z.ZodEnum<["low", "medium", "high"]>;
887
969
  reason: z.ZodString;
888
970
  }, "strip", z.ZodTypeAny, {
889
971
  reason: string;
890
- url: string;
891
972
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
892
973
  confidence: "low" | "medium" | "high";
974
+ url?: string | undefined;
975
+ imageRef?: string | undefined;
893
976
  }, {
894
977
  reason: string;
895
- url: string;
896
978
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
897
979
  confidence: "low" | "medium" | "high";
980
+ url?: string | undefined;
981
+ imageRef?: string | undefined;
982
+ }>, {
983
+ reason: string;
984
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
985
+ confidence: "low" | "medium" | "high";
986
+ url?: string | undefined;
987
+ imageRef?: string | undefined;
988
+ }, {
989
+ reason: string;
990
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
991
+ confidence: "low" | "medium" | "high";
992
+ url?: string | undefined;
993
+ imageRef?: string | undefined;
898
994
  }>, "many">;
899
995
  }, "strip", z.ZodTypeAny, {
900
996
  sources: {
901
997
  reason: string;
902
- url: string;
903
998
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
904
999
  confidence: "low" | "medium" | "high";
1000
+ url?: string | undefined;
1001
+ imageRef?: string | undefined;
905
1002
  }[];
906
1003
  }, {
907
1004
  sources: {
908
1005
  reason: string;
909
- url: string;
910
1006
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
911
1007
  confidence: "low" | "medium" | "high";
1008
+ url?: string | undefined;
1009
+ imageRef?: string | undefined;
912
1010
  }[];
913
1011
  }>>;
914
1012
  designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
@@ -916,7 +1014,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
916
1014
  sourceUrls?: string[] | undefined;
917
1015
  preserveBrand?: boolean | undefined;
918
1016
  sourceArtifacts?: {
919
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
1017
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
920
1018
  label: string;
921
1019
  content: string;
922
1020
  }[] | undefined;
@@ -936,9 +1034,10 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
936
1034
  sourceIntent?: {
937
1035
  sources: {
938
1036
  reason: string;
939
- url: string;
940
1037
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
941
1038
  confidence: "low" | "medium" | "high";
1039
+ url?: string | undefined;
1040
+ imageRef?: string | undefined;
942
1041
  }[];
943
1042
  } | undefined;
944
1043
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -946,7 +1045,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
946
1045
  sourceUrls?: string[] | undefined;
947
1046
  preserveBrand?: boolean | undefined;
948
1047
  sourceArtifacts?: {
949
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
1048
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
950
1049
  label: string;
951
1050
  content: string;
952
1051
  }[] | undefined;
@@ -966,9 +1065,10 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
966
1065
  sourceIntent?: {
967
1066
  sources: {
968
1067
  reason: string;
969
- url: string;
970
1068
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
971
1069
  confidence: "low" | "medium" | "high";
1070
+ url?: string | undefined;
1071
+ imageRef?: string | undefined;
972
1072
  }[];
973
1073
  } | undefined;
974
1074
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1037,7 +1137,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
1037
1137
  sourceUrls?: string[] | undefined;
1038
1138
  preserveBrand?: boolean | undefined;
1039
1139
  sourceArtifacts?: {
1040
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
1140
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
1041
1141
  label: string;
1042
1142
  content: string;
1043
1143
  }[] | undefined;
@@ -1057,9 +1157,10 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
1057
1157
  sourceIntent?: {
1058
1158
  sources: {
1059
1159
  reason: string;
1060
- url: string;
1061
1160
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1062
1161
  confidence: "low" | "medium" | "high";
1162
+ url?: string | undefined;
1163
+ imageRef?: string | undefined;
1063
1164
  }[];
1064
1165
  } | undefined;
1065
1166
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1094,7 +1195,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
1094
1195
  sourceUrls?: string[] | undefined;
1095
1196
  preserveBrand?: boolean | undefined;
1096
1197
  sourceArtifacts?: {
1097
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
1198
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
1098
1199
  label: string;
1099
1200
  content: string;
1100
1201
  }[] | undefined;
@@ -1114,9 +1215,10 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
1114
1215
  sourceIntent?: {
1115
1216
  sources: {
1116
1217
  reason: string;
1117
- url: string;
1118
1218
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1119
1219
  confidence: "low" | "medium" | "high";
1220
+ url?: string | undefined;
1221
+ imageRef?: string | undefined;
1120
1222
  }[];
1121
1223
  } | undefined;
1122
1224
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1226,9 +1328,9 @@ export type VariantArtifactSource = 'agent_browser' | 'cache' | 'static' | 'manu
1226
1328
  export type VariantArtifactContentType = 'text/markdown' | 'application/json' | 'text/plain';
1227
1329
  /**
1228
1330
  * Stable, transport-safe shape for one supporting artifact attached to a
1229
- * variants session. For `design_context` artifacts the full markdown
1230
- * content is required (the UI renders it inline); other kinds may omit
1231
- * `content` and surface metadata only.
1331
+ * variants session. `design_context` artifacts expose loopback URLs so the
1332
+ * UI can open raw markdown or a rendered DesignMD view without carrying the
1333
+ * full document in every snapshot.
1232
1334
  */
1233
1335
  export interface VariantSessionArtifact {
1234
1336
  id: string;
@@ -1240,6 +1342,8 @@ export interface VariantSessionArtifact {
1240
1342
  source?: VariantArtifactSource;
1241
1343
  contentType?: VariantArtifactContentType;
1242
1344
  content?: string;
1345
+ rawUrl?: string;
1346
+ viewUrl?: string;
1243
1347
  path?: string;
1244
1348
  warnings?: string[];
1245
1349
  }
@@ -1371,15 +1475,15 @@ export declare const proposeVariantsInput: {
1371
1475
  sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1372
1476
  preserveBrand: z.ZodOptional<z.ZodBoolean>;
1373
1477
  sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
1374
- kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
1478
+ kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
1375
1479
  label: z.ZodString;
1376
1480
  content: z.ZodString;
1377
1481
  }, "strip", z.ZodTypeAny, {
1378
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
1482
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
1379
1483
  label: string;
1380
1484
  content: string;
1381
1485
  }, {
1382
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
1486
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
1383
1487
  label: string;
1384
1488
  content: string;
1385
1489
  }>, "many">>;
@@ -1429,35 +1533,52 @@ export declare const proposeVariantsInput: {
1429
1533
  risks?: string[] | undefined;
1430
1534
  }>>;
1431
1535
  sourceIntent: z.ZodOptional<z.ZodObject<{
1432
- sources: z.ZodArray<z.ZodObject<{
1433
- url: z.ZodString;
1536
+ sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
1537
+ url: z.ZodOptional<z.ZodString>;
1538
+ imageRef: z.ZodOptional<z.ZodString>;
1434
1539
  role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
1435
1540
  confidence: z.ZodEnum<["low", "medium", "high"]>;
1436
1541
  reason: z.ZodString;
1437
1542
  }, "strip", z.ZodTypeAny, {
1438
1543
  reason: string;
1439
- url: string;
1440
1544
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1441
1545
  confidence: "low" | "medium" | "high";
1546
+ url?: string | undefined;
1547
+ imageRef?: string | undefined;
1442
1548
  }, {
1443
1549
  reason: string;
1444
- url: string;
1445
1550
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1446
1551
  confidence: "low" | "medium" | "high";
1552
+ url?: string | undefined;
1553
+ imageRef?: string | undefined;
1554
+ }>, {
1555
+ reason: string;
1556
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1557
+ confidence: "low" | "medium" | "high";
1558
+ url?: string | undefined;
1559
+ imageRef?: string | undefined;
1560
+ }, {
1561
+ reason: string;
1562
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1563
+ confidence: "low" | "medium" | "high";
1564
+ url?: string | undefined;
1565
+ imageRef?: string | undefined;
1447
1566
  }>, "many">;
1448
1567
  }, "strip", z.ZodTypeAny, {
1449
1568
  sources: {
1450
1569
  reason: string;
1451
- url: string;
1452
1570
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1453
1571
  confidence: "low" | "medium" | "high";
1572
+ url?: string | undefined;
1573
+ imageRef?: string | undefined;
1454
1574
  }[];
1455
1575
  }, {
1456
1576
  sources: {
1457
1577
  reason: string;
1458
- url: string;
1459
1578
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1460
1579
  confidence: "low" | "medium" | "high";
1580
+ url?: string | undefined;
1581
+ imageRef?: string | undefined;
1461
1582
  }[];
1462
1583
  }>>;
1463
1584
  designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
@@ -1465,7 +1586,7 @@ export declare const proposeVariantsInput: {
1465
1586
  sourceUrls?: string[] | undefined;
1466
1587
  preserveBrand?: boolean | undefined;
1467
1588
  sourceArtifacts?: {
1468
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
1589
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
1469
1590
  label: string;
1470
1591
  content: string;
1471
1592
  }[] | undefined;
@@ -1485,9 +1606,10 @@ export declare const proposeVariantsInput: {
1485
1606
  sourceIntent?: {
1486
1607
  sources: {
1487
1608
  reason: string;
1488
- url: string;
1489
1609
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1490
1610
  confidence: "low" | "medium" | "high";
1611
+ url?: string | undefined;
1612
+ imageRef?: string | undefined;
1491
1613
  }[];
1492
1614
  } | undefined;
1493
1615
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1495,7 +1617,7 @@ export declare const proposeVariantsInput: {
1495
1617
  sourceUrls?: string[] | undefined;
1496
1618
  preserveBrand?: boolean | undefined;
1497
1619
  sourceArtifacts?: {
1498
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
1620
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
1499
1621
  label: string;
1500
1622
  content: string;
1501
1623
  }[] | undefined;
@@ -1515,9 +1637,10 @@ export declare const proposeVariantsInput: {
1515
1637
  sourceIntent?: {
1516
1638
  sources: {
1517
1639
  reason: string;
1518
- url: string;
1519
1640
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1520
1641
  confidence: "low" | "medium" | "high";
1642
+ url?: string | undefined;
1643
+ imageRef?: string | undefined;
1521
1644
  }[];
1522
1645
  } | undefined;
1523
1646
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1586,7 +1709,7 @@ export declare const proposeVariantsInput: {
1586
1709
  sourceUrls?: string[] | undefined;
1587
1710
  preserveBrand?: boolean | undefined;
1588
1711
  sourceArtifacts?: {
1589
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
1712
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
1590
1713
  label: string;
1591
1714
  content: string;
1592
1715
  }[] | undefined;
@@ -1606,9 +1729,10 @@ export declare const proposeVariantsInput: {
1606
1729
  sourceIntent?: {
1607
1730
  sources: {
1608
1731
  reason: string;
1609
- url: string;
1610
1732
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1611
1733
  confidence: "low" | "medium" | "high";
1734
+ url?: string | undefined;
1735
+ imageRef?: string | undefined;
1612
1736
  }[];
1613
1737
  } | undefined;
1614
1738
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1643,7 +1767,7 @@ export declare const proposeVariantsInput: {
1643
1767
  sourceUrls?: string[] | undefined;
1644
1768
  preserveBrand?: boolean | undefined;
1645
1769
  sourceArtifacts?: {
1646
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
1770
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
1647
1771
  label: string;
1648
1772
  content: string;
1649
1773
  }[] | undefined;
@@ -1663,9 +1787,10 @@ export declare const proposeVariantsInput: {
1663
1787
  sourceIntent?: {
1664
1788
  sources: {
1665
1789
  reason: string;
1666
- url: string;
1667
1790
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1668
1791
  confidence: "low" | "medium" | "high";
1792
+ url?: string | undefined;
1793
+ imageRef?: string | undefined;
1669
1794
  }[];
1670
1795
  } | undefined;
1671
1796
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1718,18 +1843,38 @@ export declare const reportVariantBriefsInput: {
1718
1843
  visualReferenceUrl?: string | undefined;
1719
1844
  }>, "many">;
1720
1845
  };
1721
- declare const browserDesignContextSchema: z.ZodObject<{
1722
- url: z.ZodString;
1846
+ /**
1847
+ * One agent-extracted DESIGN.md, keyed by exactly one of:
1848
+ * - `url`: the inspiration URL the agent fetched via browser extraction
1849
+ * - `imageRef`: a stable `image:<index>` reference matching an image-kind
1850
+ * entry in the session's `sourceArtifacts` (see `buildImageRefs` in
1851
+ * SessionStore for index semantics)
1852
+ */
1853
+ declare const browserDesignContextSchema: z.ZodEffects<z.ZodObject<{
1854
+ url: z.ZodOptional<z.ZodString>;
1855
+ imageRef: z.ZodOptional<z.ZodString>;
1723
1856
  label: z.ZodString;
1724
1857
  markdown: z.ZodString;
1725
1858
  }, "strip", z.ZodTypeAny, {
1726
1859
  markdown: string;
1727
- url: string;
1728
1860
  label: string;
1861
+ url?: string | undefined;
1862
+ imageRef?: string | undefined;
1729
1863
  }, {
1730
1864
  markdown: string;
1731
- url: string;
1732
1865
  label: string;
1866
+ url?: string | undefined;
1867
+ imageRef?: string | undefined;
1868
+ }>, {
1869
+ markdown: string;
1870
+ label: string;
1871
+ url?: string | undefined;
1872
+ imageRef?: string | undefined;
1873
+ }, {
1874
+ markdown: string;
1875
+ label: string;
1876
+ url?: string | undefined;
1877
+ imageRef?: string | undefined;
1733
1878
  }>;
1734
1879
  /**
1735
1880
  * Consolidated planning artifact reported by the agent in a single tool call.
@@ -1741,35 +1886,52 @@ declare const browserDesignContextSchema: z.ZodObject<{
1741
1886
  */
1742
1887
  export declare const sourcePlanArtifactSchema: z.ZodObject<{
1743
1888
  sourceIntent: z.ZodObject<{
1744
- sources: z.ZodArray<z.ZodObject<{
1745
- url: z.ZodString;
1889
+ sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
1890
+ url: z.ZodOptional<z.ZodString>;
1891
+ imageRef: z.ZodOptional<z.ZodString>;
1746
1892
  role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
1747
1893
  confidence: z.ZodEnum<["low", "medium", "high"]>;
1748
1894
  reason: z.ZodString;
1749
1895
  }, "strip", z.ZodTypeAny, {
1750
1896
  reason: string;
1751
- url: string;
1752
1897
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1753
1898
  confidence: "low" | "medium" | "high";
1899
+ url?: string | undefined;
1900
+ imageRef?: string | undefined;
1754
1901
  }, {
1755
1902
  reason: string;
1756
- url: string;
1757
1903
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1758
1904
  confidence: "low" | "medium" | "high";
1905
+ url?: string | undefined;
1906
+ imageRef?: string | undefined;
1907
+ }>, {
1908
+ reason: string;
1909
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1910
+ confidence: "low" | "medium" | "high";
1911
+ url?: string | undefined;
1912
+ imageRef?: string | undefined;
1913
+ }, {
1914
+ reason: string;
1915
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1916
+ confidence: "low" | "medium" | "high";
1917
+ url?: string | undefined;
1918
+ imageRef?: string | undefined;
1759
1919
  }>, "many">;
1760
1920
  }, "strip", z.ZodTypeAny, {
1761
1921
  sources: {
1762
1922
  reason: string;
1763
- url: string;
1764
1923
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1765
1924
  confidence: "low" | "medium" | "high";
1925
+ url?: string | undefined;
1926
+ imageRef?: string | undefined;
1766
1927
  }[];
1767
1928
  }, {
1768
1929
  sources: {
1769
1930
  reason: string;
1770
- url: string;
1771
1931
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1772
1932
  confidence: "low" | "medium" | "high";
1933
+ url?: string | undefined;
1934
+ imageRef?: string | undefined;
1773
1935
  }[];
1774
1936
  }>;
1775
1937
  sourceContext: z.ZodObject<{
@@ -1817,18 +1979,31 @@ export declare const sourcePlanArtifactSchema: z.ZodObject<{
1817
1979
  screenshotReferences?: string[] | undefined;
1818
1980
  risks?: string[] | undefined;
1819
1981
  }>;
1820
- designContexts: z.ZodOptional<z.ZodArray<z.ZodObject<{
1821
- url: z.ZodString;
1982
+ designContexts: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
1983
+ url: z.ZodOptional<z.ZodString>;
1984
+ imageRef: z.ZodOptional<z.ZodString>;
1822
1985
  label: z.ZodString;
1823
1986
  markdown: z.ZodString;
1824
1987
  }, "strip", z.ZodTypeAny, {
1825
1988
  markdown: string;
1826
- url: string;
1827
1989
  label: string;
1990
+ url?: string | undefined;
1991
+ imageRef?: string | undefined;
1992
+ }, {
1993
+ markdown: string;
1994
+ label: string;
1995
+ url?: string | undefined;
1996
+ imageRef?: string | undefined;
1997
+ }>, {
1998
+ markdown: string;
1999
+ label: string;
2000
+ url?: string | undefined;
2001
+ imageRef?: string | undefined;
1828
2002
  }, {
1829
2003
  markdown: string;
1830
- url: string;
1831
2004
  label: string;
2005
+ url?: string | undefined;
2006
+ imageRef?: string | undefined;
1832
2007
  }>, "many">>;
1833
2008
  executionPlan: z.ZodObject<{
1834
2009
  mode: z.ZodEnum<["static_preview", "vite_app"]>;
@@ -1876,9 +2051,10 @@ export declare const sourcePlanArtifactSchema: z.ZodObject<{
1876
2051
  sourceIntent: {
1877
2052
  sources: {
1878
2053
  reason: string;
1879
- url: string;
1880
2054
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1881
2055
  confidence: "low" | "medium" | "high";
2056
+ url?: string | undefined;
2057
+ imageRef?: string | undefined;
1882
2058
  }[];
1883
2059
  };
1884
2060
  sourceContext: {
@@ -1908,16 +2084,18 @@ export declare const sourcePlanArtifactSchema: z.ZodObject<{
1908
2084
  };
1909
2085
  designContexts?: {
1910
2086
  markdown: string;
1911
- url: string;
1912
2087
  label: string;
2088
+ url?: string | undefined;
2089
+ imageRef?: string | undefined;
1913
2090
  }[] | undefined;
1914
2091
  }, {
1915
2092
  sourceIntent: {
1916
2093
  sources: {
1917
2094
  reason: string;
1918
- url: string;
1919
2095
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1920
2096
  confidence: "low" | "medium" | "high";
2097
+ url?: string | undefined;
2098
+ imageRef?: string | undefined;
1921
2099
  }[];
1922
2100
  };
1923
2101
  sourceContext: {
@@ -1947,8 +2125,9 @@ export declare const sourcePlanArtifactSchema: z.ZodObject<{
1947
2125
  };
1948
2126
  designContexts?: {
1949
2127
  markdown: string;
1950
- url: string;
1951
2128
  label: string;
2129
+ url?: string | undefined;
2130
+ imageRef?: string | undefined;
1952
2131
  }[] | undefined;
1953
2132
  }>;
1954
2133
  export type SourcePlanArtifact = z.infer<typeof sourcePlanArtifactSchema>;
@@ -1960,35 +2139,52 @@ export declare const reportSourcePlanInput: {
1960
2139
  leaseId: z.ZodString;
1961
2140
  sourcePlan: z.ZodObject<{
1962
2141
  sourceIntent: z.ZodObject<{
1963
- sources: z.ZodArray<z.ZodObject<{
1964
- url: z.ZodString;
2142
+ sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
2143
+ url: z.ZodOptional<z.ZodString>;
2144
+ imageRef: z.ZodOptional<z.ZodString>;
1965
2145
  role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
1966
2146
  confidence: z.ZodEnum<["low", "medium", "high"]>;
1967
2147
  reason: z.ZodString;
1968
2148
  }, "strip", z.ZodTypeAny, {
1969
2149
  reason: string;
1970
- url: string;
1971
2150
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1972
2151
  confidence: "low" | "medium" | "high";
2152
+ url?: string | undefined;
2153
+ imageRef?: string | undefined;
2154
+ }, {
2155
+ reason: string;
2156
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2157
+ confidence: "low" | "medium" | "high";
2158
+ url?: string | undefined;
2159
+ imageRef?: string | undefined;
2160
+ }>, {
2161
+ reason: string;
2162
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2163
+ confidence: "low" | "medium" | "high";
2164
+ url?: string | undefined;
2165
+ imageRef?: string | undefined;
1973
2166
  }, {
1974
2167
  reason: string;
1975
- url: string;
1976
2168
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1977
2169
  confidence: "low" | "medium" | "high";
2170
+ url?: string | undefined;
2171
+ imageRef?: string | undefined;
1978
2172
  }>, "many">;
1979
2173
  }, "strip", z.ZodTypeAny, {
1980
2174
  sources: {
1981
2175
  reason: string;
1982
- url: string;
1983
2176
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1984
2177
  confidence: "low" | "medium" | "high";
2178
+ url?: string | undefined;
2179
+ imageRef?: string | undefined;
1985
2180
  }[];
1986
2181
  }, {
1987
2182
  sources: {
1988
2183
  reason: string;
1989
- url: string;
1990
2184
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
1991
2185
  confidence: "low" | "medium" | "high";
2186
+ url?: string | undefined;
2187
+ imageRef?: string | undefined;
1992
2188
  }[];
1993
2189
  }>;
1994
2190
  sourceContext: z.ZodObject<{
@@ -2036,18 +2232,31 @@ export declare const reportSourcePlanInput: {
2036
2232
  screenshotReferences?: string[] | undefined;
2037
2233
  risks?: string[] | undefined;
2038
2234
  }>;
2039
- designContexts: z.ZodOptional<z.ZodArray<z.ZodObject<{
2040
- url: z.ZodString;
2235
+ designContexts: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
2236
+ url: z.ZodOptional<z.ZodString>;
2237
+ imageRef: z.ZodOptional<z.ZodString>;
2041
2238
  label: z.ZodString;
2042
2239
  markdown: z.ZodString;
2043
2240
  }, "strip", z.ZodTypeAny, {
2044
2241
  markdown: string;
2045
- url: string;
2046
2242
  label: string;
2243
+ url?: string | undefined;
2244
+ imageRef?: string | undefined;
2047
2245
  }, {
2048
2246
  markdown: string;
2049
- url: string;
2050
2247
  label: string;
2248
+ url?: string | undefined;
2249
+ imageRef?: string | undefined;
2250
+ }>, {
2251
+ markdown: string;
2252
+ label: string;
2253
+ url?: string | undefined;
2254
+ imageRef?: string | undefined;
2255
+ }, {
2256
+ markdown: string;
2257
+ label: string;
2258
+ url?: string | undefined;
2259
+ imageRef?: string | undefined;
2051
2260
  }>, "many">>;
2052
2261
  executionPlan: z.ZodObject<{
2053
2262
  mode: z.ZodEnum<["static_preview", "vite_app"]>;
@@ -2095,9 +2304,10 @@ export declare const reportSourcePlanInput: {
2095
2304
  sourceIntent: {
2096
2305
  sources: {
2097
2306
  reason: string;
2098
- url: string;
2099
2307
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2100
2308
  confidence: "low" | "medium" | "high";
2309
+ url?: string | undefined;
2310
+ imageRef?: string | undefined;
2101
2311
  }[];
2102
2312
  };
2103
2313
  sourceContext: {
@@ -2127,16 +2337,18 @@ export declare const reportSourcePlanInput: {
2127
2337
  };
2128
2338
  designContexts?: {
2129
2339
  markdown: string;
2130
- url: string;
2131
2340
  label: string;
2341
+ url?: string | undefined;
2342
+ imageRef?: string | undefined;
2132
2343
  }[] | undefined;
2133
2344
  }, {
2134
2345
  sourceIntent: {
2135
2346
  sources: {
2136
2347
  reason: string;
2137
- url: string;
2138
2348
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2139
2349
  confidence: "low" | "medium" | "high";
2350
+ url?: string | undefined;
2351
+ imageRef?: string | undefined;
2140
2352
  }[];
2141
2353
  };
2142
2354
  sourceContext: {
@@ -2166,8 +2378,9 @@ export declare const reportSourcePlanInput: {
2166
2378
  };
2167
2379
  designContexts?: {
2168
2380
  markdown: string;
2169
- url: string;
2170
2381
  label: string;
2382
+ url?: string | undefined;
2383
+ imageRef?: string | undefined;
2171
2384
  }[] | undefined;
2172
2385
  }>;
2173
2386
  };
@@ -2321,15 +2534,15 @@ export declare const extractInspirationContextInput: {
2321
2534
  urls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2322
2535
  preserveBrand: z.ZodOptional<z.ZodBoolean>;
2323
2536
  sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
2324
- kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
2537
+ kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
2325
2538
  label: z.ZodString;
2326
2539
  content: z.ZodString;
2327
2540
  }, "strip", z.ZodTypeAny, {
2328
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
2541
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
2329
2542
  label: string;
2330
2543
  content: string;
2331
2544
  }, {
2332
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
2545
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
2333
2546
  label: string;
2334
2547
  content: string;
2335
2548
  }>, "many">>;
@@ -2494,15 +2707,15 @@ export declare const startVariantsInput: {
2494
2707
  sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2495
2708
  preserveBrand: z.ZodOptional<z.ZodBoolean>;
2496
2709
  sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
2497
- kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
2710
+ kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
2498
2711
  label: z.ZodString;
2499
2712
  content: z.ZodString;
2500
2713
  }, "strip", z.ZodTypeAny, {
2501
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
2714
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
2502
2715
  label: string;
2503
2716
  content: string;
2504
2717
  }, {
2505
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
2718
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
2506
2719
  label: string;
2507
2720
  content: string;
2508
2721
  }>, "many">>;
@@ -2552,35 +2765,52 @@ export declare const startVariantsInput: {
2552
2765
  risks?: string[] | undefined;
2553
2766
  }>>;
2554
2767
  sourceIntent: z.ZodOptional<z.ZodObject<{
2555
- sources: z.ZodArray<z.ZodObject<{
2556
- url: z.ZodString;
2768
+ sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
2769
+ url: z.ZodOptional<z.ZodString>;
2770
+ imageRef: z.ZodOptional<z.ZodString>;
2557
2771
  role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
2558
2772
  confidence: z.ZodEnum<["low", "medium", "high"]>;
2559
2773
  reason: z.ZodString;
2560
2774
  }, "strip", z.ZodTypeAny, {
2561
2775
  reason: string;
2562
- url: string;
2563
2776
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2564
2777
  confidence: "low" | "medium" | "high";
2778
+ url?: string | undefined;
2779
+ imageRef?: string | undefined;
2565
2780
  }, {
2566
2781
  reason: string;
2567
- url: string;
2568
2782
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2569
2783
  confidence: "low" | "medium" | "high";
2784
+ url?: string | undefined;
2785
+ imageRef?: string | undefined;
2786
+ }>, {
2787
+ reason: string;
2788
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2789
+ confidence: "low" | "medium" | "high";
2790
+ url?: string | undefined;
2791
+ imageRef?: string | undefined;
2792
+ }, {
2793
+ reason: string;
2794
+ role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2795
+ confidence: "low" | "medium" | "high";
2796
+ url?: string | undefined;
2797
+ imageRef?: string | undefined;
2570
2798
  }>, "many">;
2571
2799
  }, "strip", z.ZodTypeAny, {
2572
2800
  sources: {
2573
2801
  reason: string;
2574
- url: string;
2575
2802
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2576
2803
  confidence: "low" | "medium" | "high";
2804
+ url?: string | undefined;
2805
+ imageRef?: string | undefined;
2577
2806
  }[];
2578
2807
  }, {
2579
2808
  sources: {
2580
2809
  reason: string;
2581
- url: string;
2582
2810
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2583
2811
  confidence: "low" | "medium" | "high";
2812
+ url?: string | undefined;
2813
+ imageRef?: string | undefined;
2584
2814
  }[];
2585
2815
  }>>;
2586
2816
  designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
@@ -2588,7 +2818,7 @@ export declare const startVariantsInput: {
2588
2818
  sourceUrls?: string[] | undefined;
2589
2819
  preserveBrand?: boolean | undefined;
2590
2820
  sourceArtifacts?: {
2591
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
2821
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
2592
2822
  label: string;
2593
2823
  content: string;
2594
2824
  }[] | undefined;
@@ -2608,9 +2838,10 @@ export declare const startVariantsInput: {
2608
2838
  sourceIntent?: {
2609
2839
  sources: {
2610
2840
  reason: string;
2611
- url: string;
2612
2841
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2613
2842
  confidence: "low" | "medium" | "high";
2843
+ url?: string | undefined;
2844
+ imageRef?: string | undefined;
2614
2845
  }[];
2615
2846
  } | undefined;
2616
2847
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -2618,7 +2849,7 @@ export declare const startVariantsInput: {
2618
2849
  sourceUrls?: string[] | undefined;
2619
2850
  preserveBrand?: boolean | undefined;
2620
2851
  sourceArtifacts?: {
2621
- kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
2852
+ kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
2622
2853
  label: string;
2623
2854
  content: string;
2624
2855
  }[] | undefined;
@@ -2638,9 +2869,10 @@ export declare const startVariantsInput: {
2638
2869
  sourceIntent?: {
2639
2870
  sources: {
2640
2871
  reason: string;
2641
- url: string;
2642
2872
  role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
2643
2873
  confidence: "low" | "medium" | "high";
2874
+ url?: string | undefined;
2875
+ imageRef?: string | undefined;
2644
2876
  }[];
2645
2877
  } | undefined;
2646
2878
  designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -2859,6 +3091,32 @@ export type ListPastVariantsInput = {
2859
3091
  limit?: number;
2860
3092
  status?: z.infer<typeof variantHistoryStatusSchema>;
2861
3093
  };
3094
+ export type PastVariantArtifact = {
3095
+ kind: 'diff';
3096
+ diffPath: 'diff.patch';
3097
+ filesPath?: 'files';
3098
+ } | {
3099
+ kind: 'project';
3100
+ filesPath: 'files';
3101
+ runnablePath?: string;
3102
+ };
3103
+ export type PastVariantPreview = {
3104
+ kind: 'static';
3105
+ rootPath: 'files';
3106
+ entryPath: string;
3107
+ } | {
3108
+ kind: 'dev-server';
3109
+ rootPath: 'files';
3110
+ command: {
3111
+ cwd: string;
3112
+ packageManager: string;
3113
+ script: string;
3114
+ };
3115
+ runnablePath?: string;
3116
+ } | {
3117
+ kind: 'none';
3118
+ reason: 'diff_only' | 'missing_entry' | 'unsupported';
3119
+ };
2862
3120
  export interface PastVariantSummary {
2863
3121
  sessionId: string;
2864
3122
  variantId: string;
@@ -2869,6 +3127,8 @@ export interface PastVariantSummary {
2869
3127
  createdAt: string;
2870
3128
  statusChangedAt: string;
2871
3129
  changedFilesCount: number;
3130
+ artifact: PastVariantArtifact;
3131
+ preview: PastVariantPreview;
2872
3132
  }
2873
3133
  export type ListPastVariantsOutput = {
2874
3134
  projectPath: string;