rivet-design 0.9.4 → 0.9.6

package/dist/mcp/agent-variants/contracts.d.ts

@@ -46,52 +46,93 @@ export declare const projectContextExisting: z.ZodObject<{
 }>;
 export declare const sourceIntentRoleSchema: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
 export declare const sourceIntentConfidenceSchema: z.ZodEnum<["low", "medium", "high"]>;
-export declare const sourceIntentEntrySchema: z.ZodObject<{
-    url: z.ZodString;
+/**
+ * One classified source in the agent's `sourceIntent`. Identified by exactly
+ * one of:
+ *  - `url`: an inspiration URL the user provided
+ *  - `imageRef`: a stable per-session reference of the form `image:<index>`
+ *    pointing at an image-kind entry in `sourceArtifacts` (visualBrief or
+ *    screenshotNotes). Indexed over image-kind artifacts only, so the ref
+ *    survives reordering of text-only artifacts.
+ */
+export declare const sourceIntentEntrySchema: z.ZodEffects<z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    imageRef: z.ZodOptional<z.ZodString>;
     role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
     confidence: z.ZodEnum<["low", "medium", "high"]>;
     reason: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     reason: string;
-    url: string;
     role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
     confidence: "low" | "medium" | "high";
+    url?: string | undefined;
+    imageRef?: string | undefined;
 }, {
     reason: string;
-    url: string;
     role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
     confidence: "low" | "medium" | "high";
+    url?: string | undefined;
+    imageRef?: string | undefined;
+}>, {
+    reason: string;
+    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+    confidence: "low" | "medium" | "high";
+    url?: string | undefined;
+    imageRef?: string | undefined;
+}, {
+    reason: string;
+    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+    confidence: "low" | "medium" | "high";
+    url?: string | undefined;
+    imageRef?: string | undefined;
 }>;
 export declare const sourceIntentArtifactSchema: z.ZodObject<{
-    sources: z.ZodArray<z.ZodObject<{
-        url: z.ZodString;
+    sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        url: z.ZodOptional<z.ZodString>;
+        imageRef: z.ZodOptional<z.ZodString>;
         role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
         confidence: z.ZodEnum<["low", "medium", "high"]>;
         reason: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         reason: string;
-        url: string;
         role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
         confidence: "low" | "medium" | "high";
+        url?: string | undefined;
+        imageRef?: string | undefined;
+    }, {
+        reason: string;
+        role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+        confidence: "low" | "medium" | "high";
+        url?: string | undefined;
+        imageRef?: string | undefined;
+    }>, {
+        reason: string;
+        role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+        confidence: "low" | "medium" | "high";
+        url?: string | undefined;
+        imageRef?: string | undefined;
     }, {
         reason: string;
-        url: string;
         role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
         confidence: "low" | "medium" | "high";
+        url?: string | undefined;
+        imageRef?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     sources: {
         reason: string;
-        url: string;
         role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
         confidence: "low" | "medium" | "high";
+        url?: string | undefined;
+        imageRef?: string | undefined;
     }[];
 }, {
     sources: {
         reason: string;
-        url: string;
         role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
         confidence: "low" | "medium" | "high";
+        url?: string | undefined;
+        imageRef?: string | undefined;
     }[];
 }>;
 export type SourceIntentRole = z.infer<typeof sourceIntentRoleSchema>;
@@ -120,17 +161,17 @@ export declare const designContextEntrySchema: z.ZodDiscriminatedUnion<"kind", [
     label: string;
     content: string;
 }>]>;
-export declare const sourceArtifactKindSchema: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
+export declare const sourceArtifactKindSchema: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
 export declare const sourceArtifactInputSchema: z.ZodObject<{
-    kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
+    kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
     label: z.ZodString;
     content: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+    kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
     label: string;
     content: string;
 }, {
-    kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+    kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
     label: string;
     content: string;
 }>;
@@ -197,15 +238,15 @@ export declare const sourceContextInputSchema: z.ZodObject<{
     sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     preserveBrand: z.ZodOptional<z.ZodBoolean>;
     sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
+        kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
         label: z.ZodString;
         content: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
         label: string;
         content: string;
     }, {
-        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
         label: string;
         content: string;
     }>, "many">>;
@@ -255,35 +296,52 @@ export declare const sourceContextInputSchema: z.ZodObject<{
         risks?: string[] | undefined;
     }>>;
     sourceIntent: z.ZodOptional<z.ZodObject<{
-        sources: z.ZodArray<z.ZodObject<{
-            url: z.ZodString;
+        sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
+            url: z.ZodOptional<z.ZodString>;
+            imageRef: z.ZodOptional<z.ZodString>;
             role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
             confidence: z.ZodEnum<["low", "medium", "high"]>;
             reason: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
+        }, {
+            reason: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
+        }>, {
+            reason: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }, {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         sources: {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }[];
     }, {
         sources: {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }[];
     }>>;
     designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
@@ -291,7 +349,7 @@ export declare const sourceContextInputSchema: z.ZodObject<{
     sourceUrls?: string[] | undefined;
     preserveBrand?: boolean | undefined;
     sourceArtifacts?: {
-        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
         label: string;
         content: string;
     }[] | undefined;
@@ -311,9 +369,10 @@ export declare const sourceContextInputSchema: z.ZodObject<{
     sourceIntent?: {
         sources: {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }[];
     } | undefined;
     designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -321,7 +380,7 @@ export declare const sourceContextInputSchema: z.ZodObject<{
     sourceUrls?: string[] | undefined;
     preserveBrand?: boolean | undefined;
     sourceArtifacts?: {
-        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
         label: string;
         content: string;
     }[] | undefined;
@@ -341,9 +400,10 @@ export declare const sourceContextInputSchema: z.ZodObject<{
     sourceIntent?: {
         sources: {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }[];
     } | undefined;
     designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -418,7 +478,17 @@ export type AssetPlanEntry = z.infer<typeof assetPlanEntrySchema>;
 export type ExecutionCapabilityPlan = z.infer<typeof executionCapabilityPlanSchema>;
 export declare const projectContextFresh: z.ZodObject<{
     kind: z.ZodLiteral<"fresh">;
+    /** Where the generated subproject's files live (e.g.
+     *  `fable-eng-demo/.rivet/marketing-clone/`). This is the materialize
+     *  target — the agent reads/writes index.html, src/, etc. here. */
     workspacePath: z.ZodString;
+    /** The user's working directory that owns *all* Rivet artifacts for the
+     *  session (e.g. `fable-eng-demo`). `<workspaceRoot>/.rivet/` holds
+     *  generated subprojects, variant history, and create-project manifests.
+     *  Distinct from `path.dirname(workspacePath)` because subprojects nest
+     *  inside `.rivet/` — the dirname would resolve to the `.rivet` dir,
+     *  not the workspace itself. */
+    workspaceRoot: z.ZodString;
     framework: z.ZodOptional<z.ZodEnum<["vite", "next", "astro", "remix"]>>;
     assetSourceRoot: z.ZodOptional<z.ZodString>;
     /** Per-variant-slot design context. Slug entries resolve bundled catalog
@@ -450,15 +520,15 @@ export declare const projectContextFresh: z.ZodObject<{
         sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         preserveBrand: z.ZodOptional<z.ZodBoolean>;
         sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
+            kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
             label: z.ZodString;
             content: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }, {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }>, "many">>;
@@ -508,35 +578,52 @@ export declare const projectContextFresh: z.ZodObject<{
             risks?: string[] | undefined;
         }>>;
         sourceIntent: z.ZodOptional<z.ZodObject<{
-            sources: z.ZodArray<z.ZodObject<{
-                url: z.ZodString;
+            sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
+                url: z.ZodOptional<z.ZodString>;
+                imageRef: z.ZodOptional<z.ZodString>;
                 role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
                 confidence: z.ZodEnum<["low", "medium", "high"]>;
                 reason: z.ZodString;
             }, "strip", z.ZodTypeAny, {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }>, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }, {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         }, {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         }>>;
         designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
@@ -544,7 +631,7 @@ export declare const projectContextFresh: z.ZodObject<{
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }[] | undefined;
@@ -564,9 +651,10 @@ export declare const projectContextFresh: z.ZodObject<{
         sourceIntent?: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -574,7 +662,7 @@ export declare const projectContextFresh: z.ZodObject<{
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }[] | undefined;
@@ -594,9 +682,10 @@ export declare const projectContextFresh: z.ZodObject<{
         sourceIntent?: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -650,6 +739,7 @@ export declare const projectContextFresh: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     kind: "fresh";
     workspacePath: string;
+    workspaceRoot: string;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
     assetSourceRoot?: string | undefined;
     designContext?: ({
@@ -664,7 +754,7 @@ export declare const projectContextFresh: z.ZodObject<{
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }[] | undefined;
@@ -684,9 +774,10 @@ export declare const projectContextFresh: z.ZodObject<{
         sourceIntent?: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -706,6 +797,7 @@ export declare const projectContextFresh: z.ZodObject<{
 }, {
     kind: "fresh";
     workspacePath: string;
+    workspaceRoot: string;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
     assetSourceRoot?: string | undefined;
     designContext?: ({
@@ -720,7 +812,7 @@ export declare const projectContextFresh: z.ZodObject<{
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }[] | undefined;
@@ -740,9 +832,10 @@ export declare const projectContextFresh: z.ZodObject<{
         sourceIntent?: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -768,7 +861,17 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
     kind: "existing";
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"fresh">;
+    /** Where the generated subproject's files live (e.g.
+     *  `fable-eng-demo/.rivet/marketing-clone/`). This is the materialize
+     *  target — the agent reads/writes index.html, src/, etc. here. */
     workspacePath: z.ZodString;
+    /** The user's working directory that owns *all* Rivet artifacts for the
+     *  session (e.g. `fable-eng-demo`). `<workspaceRoot>/.rivet/` holds
+     *  generated subprojects, variant history, and create-project manifests.
+     *  Distinct from `path.dirname(workspacePath)` because subprojects nest
+     *  inside `.rivet/` — the dirname would resolve to the `.rivet` dir,
+     *  not the workspace itself. */
+    workspaceRoot: z.ZodString;
     framework: z.ZodOptional<z.ZodEnum<["vite", "next", "astro", "remix"]>>;
     assetSourceRoot: z.ZodOptional<z.ZodString>;
     /** Per-variant-slot design context. Slug entries resolve bundled catalog
@@ -800,15 +903,15 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         preserveBrand: z.ZodOptional<z.ZodBoolean>;
         sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
+            kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
             label: z.ZodString;
             content: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }, {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }>, "many">>;
@@ -858,35 +961,52 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             risks?: string[] | undefined;
         }>>;
         sourceIntent: z.ZodOptional<z.ZodObject<{
-            sources: z.ZodArray<z.ZodObject<{
-                url: z.ZodString;
+            sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
+                url: z.ZodOptional<z.ZodString>;
+                imageRef: z.ZodOptional<z.ZodString>;
                 role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
                 confidence: z.ZodEnum<["low", "medium", "high"]>;
                 reason: z.ZodString;
             }, "strip", z.ZodTypeAny, {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }, {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }>, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         }, {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         }>>;
         designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
@@ -894,7 +1014,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }[] | undefined;
@@ -914,9 +1034,10 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         sourceIntent?: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -924,7 +1045,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }[] | undefined;
@@ -944,9 +1065,10 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         sourceIntent?: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1000,6 +1122,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
 }, "strip", z.ZodTypeAny, {
     kind: "fresh";
     workspacePath: string;
+    workspaceRoot: string;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
     assetSourceRoot?: string | undefined;
     designContext?: ({
@@ -1014,7 +1137,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }[] | undefined;
@@ -1034,9 +1157,10 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         sourceIntent?: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1056,6 +1180,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
 }, {
     kind: "fresh";
     workspacePath: string;
+    workspaceRoot: string;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
     assetSourceRoot?: string | undefined;
     designContext?: ({
@@ -1070,7 +1195,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }[] | undefined;
@@ -1090,9 +1215,10 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         sourceIntent?: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1136,6 +1262,7 @@ export type ActiveProjectContext = {
 } | {
     kind: 'fresh';
     workspacePath: string;
+    workspaceRoot: string;
     framework?: 'vite' | 'next' | 'astro' | 'remix';
     designContext?: Array<{
         kind: 'slug';
@@ -1201,9 +1328,9 @@ export type VariantArtifactSource = 'agent_browser' | 'cache' | 'static' | 'manu
 export type VariantArtifactContentType = 'text/markdown' | 'application/json' | 'text/plain';
 /**
  * Stable, transport-safe shape for one supporting artifact attached to a
- * variants session. For `design_context` artifacts the full markdown
- * content is required (the UI renders it inline); other kinds may omit
- * `content` and surface metadata only.
+ * variants session. `design_context` artifacts expose loopback URLs so the
+ * UI can open raw markdown or a rendered DesignMD view without carrying the
+ * full document in every snapshot.
  */
 export interface VariantSessionArtifact {
     id: string;
@@ -1215,6 +1342,8 @@ export interface VariantSessionArtifact {
     source?: VariantArtifactSource;
     contentType?: VariantArtifactContentType;
     content?: string;
+    rawUrl?: string;
+    viewUrl?: string;
     path?: string;
     warnings?: string[];
 }
@@ -1304,7 +1433,17 @@ export declare const proposeVariantsInput: {
         kind: "existing";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"fresh">;
+        /** Where the generated subproject's files live (e.g.
+         *  `fable-eng-demo/.rivet/marketing-clone/`). This is the materialize
+         *  target — the agent reads/writes index.html, src/, etc. here. */
         workspacePath: z.ZodString;
+        /** The user's working directory that owns *all* Rivet artifacts for the
+         *  session (e.g. `fable-eng-demo`). `<workspaceRoot>/.rivet/` holds
+         *  generated subprojects, variant history, and create-project manifests.
+         *  Distinct from `path.dirname(workspacePath)` because subprojects nest
+         *  inside `.rivet/` — the dirname would resolve to the `.rivet` dir,
+         *  not the workspace itself. */
+        workspaceRoot: z.ZodString;
         framework: z.ZodOptional<z.ZodEnum<["vite", "next", "astro", "remix"]>>;
         assetSourceRoot: z.ZodOptional<z.ZodString>;
         /** Per-variant-slot design context. Slug entries resolve bundled catalog
@@ -1336,15 +1475,15 @@ export declare const proposeVariantsInput: {
             sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             preserveBrand: z.ZodOptional<z.ZodBoolean>;
             sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
+                kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
                 label: z.ZodString;
                 content: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
                 label: string;
                 content: string;
             }, {
-                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
                 label: string;
                 content: string;
             }>, "many">>;
@@ -1394,35 +1533,52 @@ export declare const proposeVariantsInput: {
                 risks?: string[] | undefined;
             }>>;
             sourceIntent: z.ZodOptional<z.ZodObject<{
-                sources: z.ZodArray<z.ZodObject<{
-                    url: z.ZodString;
+                sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
+                    url: z.ZodOptional<z.ZodString>;
+                    imageRef: z.ZodOptional<z.ZodString>;
                     role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
                     confidence: z.ZodEnum<["low", "medium", "high"]>;
                     reason: z.ZodString;
                 }, "strip", z.ZodTypeAny, {
                     reason: string;
-                    url: string;
                     role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                     confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
                 }, {
                     reason: string;
-                    url: string;
                     role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                     confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }>, {
+                    reason: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }, {
+                    reason: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
                 }>, "many">;
             }, "strip", z.ZodTypeAny, {
                 sources: {
                     reason: string;
-                    url: string;
                     role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                     confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
                 }[];
             }, {
                 sources: {
                     reason: string;
-                    url: string;
                     role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                     confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
                 }[];
             }>>;
             designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
@@ -1430,7 +1586,7 @@ export declare const proposeVariantsInput: {
             sourceUrls?: string[] | undefined;
             preserveBrand?: boolean | undefined;
             sourceArtifacts?: {
-                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
                 label: string;
                 content: string;
             }[] | undefined;
@@ -1450,9 +1606,10 @@ export declare const proposeVariantsInput: {
             sourceIntent?: {
                 sources: {
                     reason: string;
-                    url: string;
                     role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                     confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
                 }[];
             } | undefined;
             designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1460,7 +1617,7 @@ export declare const proposeVariantsInput: {
             sourceUrls?: string[] | undefined;
             preserveBrand?: boolean | undefined;
             sourceArtifacts?: {
-                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
                 label: string;
                 content: string;
             }[] | undefined;
@@ -1480,9 +1637,10 @@ export declare const proposeVariantsInput: {
             sourceIntent?: {
                 sources: {
                     reason: string;
-                    url: string;
                     role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                     confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
                 }[];
             } | undefined;
             designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1536,6 +1694,7 @@ export declare const proposeVariantsInput: {
     }, "strip", z.ZodTypeAny, {
         kind: "fresh";
         workspacePath: string;
+        workspaceRoot: string;
         framework?: "next" | "vite" | "remix" | "astro" | undefined;
         assetSourceRoot?: string | undefined;
         designContext?: ({
@@ -1550,7 +1709,7 @@ export declare const proposeVariantsInput: {
             sourceUrls?: string[] | undefined;
             preserveBrand?: boolean | undefined;
             sourceArtifacts?: {
-                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
                 label: string;
                 content: string;
             }[] | undefined;
@@ -1570,9 +1729,10 @@ export declare const proposeVariantsInput: {
             sourceIntent?: {
                 sources: {
                     reason: string;
-                    url: string;
                     role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                     confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
                 }[];
             } | undefined;
             designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1592,6 +1752,7 @@ export declare const proposeVariantsInput: {
     }, {
         kind: "fresh";
         workspacePath: string;
+        workspaceRoot: string;
         framework?: "next" | "vite" | "remix" | "astro" | undefined;
         assetSourceRoot?: string | undefined;
         designContext?: ({
@@ -1606,7 +1767,7 @@ export declare const proposeVariantsInput: {
             sourceUrls?: string[] | undefined;
             preserveBrand?: boolean | undefined;
             sourceArtifacts?: {
-                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
                 label: string;
                 content: string;
             }[] | undefined;
@@ -1626,9 +1787,10 @@ export declare const proposeVariantsInput: {
             sourceIntent?: {
                 sources: {
                     reason: string;
-                    url: string;
                     role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                     confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
                 }[];
             } | undefined;
             designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -1681,18 +1843,38 @@ export declare const reportVariantBriefsInput: {
         visualReferenceUrl?: string | undefined;
     }>, "many">;
 };
-declare const browserDesignContextSchema: z.ZodObject<{
-    url: z.ZodString;
+/**
+ * One agent-extracted DESIGN.md, keyed by exactly one of:
+ *  - `url`: the inspiration URL the agent fetched via browser extraction
+ *  - `imageRef`: a stable `image:<index>` reference matching an image-kind
+ *    entry in the session's `sourceArtifacts` (see `buildImageRefs` in
+ *    SessionStore for index semantics)
+ */
+declare const browserDesignContextSchema: z.ZodEffects<z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    imageRef: z.ZodOptional<z.ZodString>;
     label: z.ZodString;
     markdown: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     markdown: string;
-    url: string;
     label: string;
+    url?: string | undefined;
+    imageRef?: string | undefined;
+}, {
+    markdown: string;
+    label: string;
+    url?: string | undefined;
+    imageRef?: string | undefined;
+}>, {
+    markdown: string;
+    label: string;
+    url?: string | undefined;
+    imageRef?: string | undefined;
 }, {
     markdown: string;
-    url: string;
     label: string;
+    url?: string | undefined;
+    imageRef?: string | undefined;
 }>;
 /**
  * Consolidated planning artifact reported by the agent in a single tool call.
@@ -1704,35 +1886,52 @@ declare const browserDesignContextSchema: z.ZodObject<{
  */
 export declare const sourcePlanArtifactSchema: z.ZodObject<{
     sourceIntent: z.ZodObject<{
-        sources: z.ZodArray<z.ZodObject<{
-            url: z.ZodString;
+        sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
+            url: z.ZodOptional<z.ZodString>;
+            imageRef: z.ZodOptional<z.ZodString>;
             role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
             confidence: z.ZodEnum<["low", "medium", "high"]>;
             reason: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }, {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
+        }>, {
+            reason: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
+        }, {
+            reason: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         sources: {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }[];
     }, {
         sources: {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }[];
     }>;
     sourceContext: z.ZodObject<{
@@ -1780,18 +1979,31 @@ export declare const sourcePlanArtifactSchema: z.ZodObject<{
         screenshotReferences?: string[] | undefined;
         risks?: string[] | undefined;
     }>;
-    designContexts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        url: z.ZodString;
+    designContexts: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        url: z.ZodOptional<z.ZodString>;
+        imageRef: z.ZodOptional<z.ZodString>;
         label: z.ZodString;
         markdown: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         markdown: string;
-        url: string;
         label: string;
+        url?: string | undefined;
+        imageRef?: string | undefined;
     }, {
         markdown: string;
-        url: string;
         label: string;
+        url?: string | undefined;
+        imageRef?: string | undefined;
+    }>, {
+        markdown: string;
+        label: string;
+        url?: string | undefined;
+        imageRef?: string | undefined;
+    }, {
+        markdown: string;
+        label: string;
+        url?: string | undefined;
+        imageRef?: string | undefined;
     }>, "many">>;
     executionPlan: z.ZodObject<{
         mode: z.ZodEnum<["static_preview", "vite_app"]>;
@@ -1839,9 +2051,10 @@ export declare const sourcePlanArtifactSchema: z.ZodObject<{
     sourceIntent: {
         sources: {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }[];
     };
     sourceContext: {
@@ -1871,16 +2084,18 @@ export declare const sourcePlanArtifactSchema: z.ZodObject<{
     };
     designContexts?: {
         markdown: string;
-        url: string;
         label: string;
+        url?: string | undefined;
+        imageRef?: string | undefined;
     }[] | undefined;
 }, {
     sourceIntent: {
         sources: {
             reason: string;
-            url: string;
             role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
             confidence: "low" | "medium" | "high";
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }[];
     };
     sourceContext: {
@@ -1910,8 +2125,9 @@ export declare const sourcePlanArtifactSchema: z.ZodObject<{
     };
     designContexts?: {
         markdown: string;
-        url: string;
         label: string;
+        url?: string | undefined;
+        imageRef?: string | undefined;
     }[] | undefined;
 }>;
 export type SourcePlanArtifact = z.infer<typeof sourcePlanArtifactSchema>;
@@ -1923,35 +2139,52 @@ export declare const reportSourcePlanInput: {
     leaseId: z.ZodString;
     sourcePlan: z.ZodObject<{
         sourceIntent: z.ZodObject<{
-            sources: z.ZodArray<z.ZodObject<{
-                url: z.ZodString;
+            sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
+                url: z.ZodOptional<z.ZodString>;
+                imageRef: z.ZodOptional<z.ZodString>;
                 role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
                 confidence: z.ZodEnum<["low", "medium", "high"]>;
                 reason: z.ZodString;
             }, "strip", z.ZodTypeAny, {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }, {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }>, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         }, {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         }>;
         sourceContext: z.ZodObject<{
@@ -1999,18 +2232,31 @@ export declare const reportSourcePlanInput: {
             screenshotReferences?: string[] | undefined;
             risks?: string[] | undefined;
         }>;
-        designContexts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            url: z.ZodString;
+        designContexts: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+            url: z.ZodOptional<z.ZodString>;
+            imageRef: z.ZodOptional<z.ZodString>;
             label: z.ZodString;
             markdown: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             markdown: string;
-            url: string;
             label: string;
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }, {
             markdown: string;
-            url: string;
             label: string;
+            url?: string | undefined;
+            imageRef?: string | undefined;
+        }>, {
+            markdown: string;
+            label: string;
+            url?: string | undefined;
+            imageRef?: string | undefined;
+        }, {
+            markdown: string;
+            label: string;
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }>, "many">>;
         executionPlan: z.ZodObject<{
             mode: z.ZodEnum<["static_preview", "vite_app"]>;
@@ -2058,9 +2304,10 @@ export declare const reportSourcePlanInput: {
         sourceIntent: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         };
         sourceContext: {
@@ -2090,16 +2337,18 @@ export declare const reportSourcePlanInput: {
         };
         designContexts?: {
             markdown: string;
-            url: string;
             label: string;
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }[] | undefined;
     }, {
         sourceIntent: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         };
         sourceContext: {
@@ -2129,8 +2378,9 @@ export declare const reportSourcePlanInput: {
         };
         designContexts?: {
             markdown: string;
-            url: string;
             label: string;
+            url?: string | undefined;
+            imageRef?: string | undefined;
         }[] | undefined;
     }>;
 };
@@ -2284,15 +2534,15 @@ export declare const extractInspirationContextInput: {
     urls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     preserveBrand: z.ZodOptional<z.ZodBoolean>;
     sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
+        kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
         label: z.ZodString;
         content: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
         label: string;
         content: string;
     }, {
-        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
         label: string;
         content: string;
     }>, "many">>;
@@ -2457,15 +2707,15 @@ export declare const startVariantsInput: {
         sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         preserveBrand: z.ZodOptional<z.ZodBoolean>;
         sourceArtifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
+            kind: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes", "motionBrief"]>;
             label: z.ZodString;
             content: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }, {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }>, "many">>;
@@ -2515,35 +2765,52 @@ export declare const startVariantsInput: {
             risks?: string[] | undefined;
         }>>;
         sourceIntent: z.ZodOptional<z.ZodObject<{
-            sources: z.ZodArray<z.ZodObject<{
-                url: z.ZodString;
+            sources: z.ZodArray<z.ZodEffects<z.ZodObject<{
+                url: z.ZodOptional<z.ZodString>;
+                imageRef: z.ZodOptional<z.ZodString>;
                 role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
                 confidence: z.ZodEnum<["low", "medium", "high"]>;
                 reason: z.ZodString;
             }, "strip", z.ZodTypeAny, {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }, {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }>, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         }, {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         }>>;
         designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
@@ -2551,7 +2818,7 @@ export declare const startVariantsInput: {
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }[] | undefined;
@@ -2571,9 +2838,10 @@ export declare const startVariantsInput: {
         sourceIntent?: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -2581,7 +2849,7 @@ export declare const startVariantsInput: {
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
-            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
             label: string;
             content: string;
         }[] | undefined;
@@ -2601,9 +2869,10 @@ export declare const startVariantsInput: {
         sourceIntent?: {
             sources: {
                 reason: string;
-                url: string;
                 role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
                 confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
             }[];
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
@@ -2811,6 +3080,103 @@ export interface TerminalSummary {
         label?: string;
     }>;
 }
+export declare const variantHistoryStatusSchema: z.ZodEnum<["completed", "committed", "rejected", "cancelled"]>;
+export declare const listPastVariantsInput: {
+    projectPath: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodEnum<["completed", "committed", "rejected", "cancelled"]>>;
+};
+export type ListPastVariantsInput = {
+    projectPath?: string;
+    limit?: number;
+    status?: z.infer<typeof variantHistoryStatusSchema>;
+};
+export type PastVariantArtifact = {
+    kind: 'diff';
+    diffPath: 'diff.patch';
+    filesPath?: 'files';
+} | {
+    kind: 'project';
+    filesPath: 'files';
+    runnablePath?: string;
+};
+export type PastVariantPreview = {
+    kind: 'static';
+    rootPath: 'files';
+    entryPath: string;
+} | {
+    kind: 'dev-server';
+    rootPath: 'files';
+    command: {
+        cwd: string;
+        packageManager: string;
+        script: string;
+    };
+    runnablePath?: string;
+} | {
+    kind: 'none';
+    reason: 'diff_only' | 'missing_entry' | 'unsupported';
+};
+export interface PastVariantSummary {
+    sessionId: string;
+    variantId: string;
+    label: string;
+    brief: string;
+    kind: 'diff' | 'project-created';
+    status: z.infer<typeof variantHistoryStatusSchema>;
+    createdAt: string;
+    statusChangedAt: string;
+    changedFilesCount: number;
+    artifact: PastVariantArtifact;
+    preview: PastVariantPreview;
+}
+export type ListPastVariantsOutput = {
+    projectPath: string;
+    variants: PastVariantSummary[];
+} | {
+    stage: 'failed';
+    errorCode: ErrorCode;
+    message: string;
+};
+export declare const getVariantInput: {
+    projectPath: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodString;
+    variantId: z.ZodString;
+    /** When false, diff body / file list are omitted to keep responses small. */
+    includeBody: z.ZodOptional<z.ZodBoolean>;
+};
+export type GetVariantInput = {
+    projectPath?: string;
+    sessionId: string;
+    variantId: string;
+    includeBody?: boolean;
+};
+export type GetVariantOutput = {
+    projectPath: string;
+    variant: PastVariantSummary & {
+        sessionPrompt: string;
+        baseSha?: string;
+        destinationPath?: string;
+        diff?: string;
+        files?: string[];
+        /** Top-level DESIGN.md artifact body — present for fresh-project
+         *  variants scaffolded with a design context. Omitted when
+         *  `includeBody: false`. */
+        designMarkdown?: string;
+        /** Provenance for the persisted DESIGN.md so callers can render a
+         *  recognizable label (e.g. catalog name) without re-resolving the
+         *  slug. */
+        designSource?: {
+            kind: 'slug' | 'markdown';
+            label: string;
+            slug?: string;
+        };
+    };
+} | {
+    stage: 'failed';
+    errorCode: ErrorCode;
+    message: string;
+};
 export type VariantPickPayload = 
 /**
  * Server-internal raw diff payload. Retained so unit tests and callers that