rivet-design 0.9.3 → 0.9.5

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

@@ -1,9 +1,9 @@
 import { z } from 'zod/v3';
 import { ERROR_CODES, type ErrorCode } from './errors';
-export declare const STAGES: readonly ["awaiting_source_research", "awaiting_briefs", "awaiting_approval", "work_items_ready", "waiting_for_results", "ready", "degraded", "failed", "cancelled"];
+export declare const STAGES: readonly ["awaiting_source_plan", "awaiting_briefs", "awaiting_approval", "work_items_ready", "waiting_for_results", "ready", "degraded", "failed", "cancelled"];
 export type Stage = (typeof STAGES)[number];
 export declare const TERMINAL_STAGES: ReadonlySet<Stage>;
-export declare const WORK_ITEM_KINDS: readonly ["source_research", "brief", "scaffold_base", "static_preview", "code_gen", "cleanup_runtime"];
+export declare const WORK_ITEM_KINDS: readonly ["source_plan", "brief", "scaffold_base", "static_preview", "code_gen", "cleanup_runtime"];
 export type WorkItemKind = (typeof WORK_ITEM_KINDS)[number];
 export declare const WORK_ITEM_STATUSES: readonly ["pending", "running", "succeeded", "failed", "cancelled"];
 export type WorkItemStatus = (typeof WORK_ITEM_STATUSES)[number];
@@ -44,6 +44,60 @@ export declare const projectContextExisting: z.ZodObject<{
 }, {
     kind: "existing";
 }>;
+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;
+    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";
+}, {
+    reason: string;
+    url: string;
+    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+    confidence: "low" | "medium" | "high";
+}>;
+export declare const sourceIntentArtifactSchema: z.ZodObject<{
+    sources: z.ZodArray<z.ZodObject<{
+        url: 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";
+    }, {
+        reason: string;
+        url: string;
+        role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+        confidence: "low" | "medium" | "high";
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    sources: {
+        reason: string;
+        url: string;
+        role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+        confidence: "low" | "medium" | "high";
+    }[];
+}, {
+    sources: {
+        reason: string;
+        url: string;
+        role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+        confidence: "low" | "medium" | "high";
+    }[];
+}>;
+export type SourceIntentRole = z.infer<typeof sourceIntentRoleSchema>;
+export type SourceIntentConfidence = z.infer<typeof sourceIntentConfidenceSchema>;
+export type SourceIntentEntry = z.infer<typeof sourceIntentEntrySchema>;
+export type SourceIntentArtifact = z.infer<typeof sourceIntentArtifactSchema>;
 export declare const designContextEntrySchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"slug">;
     slug: z.ZodString;
@@ -59,12 +113,12 @@ export declare const designContextEntrySchema: z.ZodDiscriminatedUnion<"kind", [
     label: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     kind: "markdown";
-    content: string;
     label: string;
+    content: string;
 }, {
     kind: "markdown";
-    content: string;
     label: string;
+    content: string;
 }>]>;
 export declare const sourceArtifactKindSchema: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
 export declare const sourceArtifactInputSchema: z.ZodObject<{
@@ -73,12 +127,12 @@ export declare const sourceArtifactInputSchema: z.ZodObject<{
     content: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-    content: string;
     label: string;
+    content: string;
 }, {
     kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-    content: string;
     label: string;
+    content: string;
 }>;
 export declare const sourceRoleSchema: z.ZodEnum<["primary", "inspiration", "competitor"]>;
 export declare const sourceRoleEntrySchema: z.ZodObject<{
@@ -148,12 +202,12 @@ export declare const sourceContextInputSchema: z.ZodObject<{
         content: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-        content: string;
         label: string;
+        content: string;
     }, {
         kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-        content: string;
         label: string;
+        content: string;
     }>, "many">>;
     artifact: z.ZodOptional<z.ZodObject<{
         sourceFindings: z.ZodArray<z.ZodString, "many">;
@@ -200,14 +254,46 @@ export declare const sourceContextInputSchema: z.ZodObject<{
         screenshotReferences?: string[] | undefined;
         risks?: string[] | undefined;
     }>>;
+    sourceIntent: z.ZodOptional<z.ZodObject<{
+        sources: z.ZodArray<z.ZodObject<{
+            url: 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";
+        }, {
+            reason: string;
+            url: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        sources: {
+            reason: string;
+            url: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+        }[];
+    }, {
+        sources: {
+            reason: string;
+            url: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+        }[];
+    }>>;
     designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
 }, "strip", z.ZodTypeAny, {
     sourceUrls?: string[] | undefined;
     preserveBrand?: boolean | undefined;
     sourceArtifacts?: {
         kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-        content: string;
         label: string;
+        content: string;
     }[] | undefined;
     artifact?: {
         sourceFindings: string[];
@@ -222,14 +308,22 @@ export declare const sourceContextInputSchema: z.ZodObject<{
         screenshotReferences?: string[] | undefined;
         risks?: string[] | undefined;
     } | undefined;
+    sourceIntent?: {
+        sources: {
+            reason: string;
+            url: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+        }[];
+    } | undefined;
     designDecision?: "let_rivet_choose" | "go_custom" | undefined;
 }, {
     sourceUrls?: string[] | undefined;
     preserveBrand?: boolean | undefined;
     sourceArtifacts?: {
         kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-        content: string;
         label: string;
+        content: string;
     }[] | undefined;
     artifact?: {
         sourceFindings: string[];
@@ -244,12 +338,99 @@ export declare const sourceContextInputSchema: z.ZodObject<{
         screenshotReferences?: string[] | undefined;
         risks?: string[] | undefined;
     } | undefined;
+    sourceIntent?: {
+        sources: {
+            reason: string;
+            url: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+        }[];
+    } | undefined;
     designDecision?: "let_rivet_choose" | "go_custom" | undefined;
 }>;
+export declare const executionModeSchema: z.ZodEnum<["static_preview", "vite_app"]>;
+export declare const executionConfidenceSchema: z.ZodEnum<["low", "medium", "high"]>;
+/**
+ * One file to copy from an absolute disk path into the generated project.
+ * `destination` is project-relative (e.g. `public/assets/avatar.glb`);
+ * `referenceAs` is the served path the generated code should use (e.g.
+ * `/assets/avatar.glb`). The agent decides asset routing at planning time
+ * so MCP can materialize the same layout for every variant.
+ */
+export declare const assetPlanEntrySchema: z.ZodObject<{
+    source: z.ZodString;
+    destination: z.ZodString;
+    referenceAs: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    destination: string;
+    referenceAs: string;
+}, {
+    source: string;
+    destination: string;
+    referenceAs: string;
+}>;
+export declare const executionCapabilityPlanSchema: z.ZodObject<{
+    mode: z.ZodEnum<["static_preview", "vite_app"]>;
+    confidence: z.ZodEnum<["low", "medium", "high"]>;
+    reason: z.ZodString;
+    assetPlan: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        destination: z.ZodString;
+        referenceAs: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        destination: string;
+        referenceAs: string;
+    }, {
+        source: string;
+        destination: string;
+        referenceAs: string;
+    }>, "many">>;
+    runtimeRequirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    userQuestion: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    mode: "static_preview" | "vite_app";
+    reason: string;
+    confidence: "low" | "medium" | "high";
+    assetPlan?: {
+        source: string;
+        destination: string;
+        referenceAs: string;
+    }[] | undefined;
+    runtimeRequirements?: string[] | undefined;
+    userQuestion?: string | undefined;
+}, {
+    mode: "static_preview" | "vite_app";
+    reason: string;
+    confidence: "low" | "medium" | "high";
+    assetPlan?: {
+        source: string;
+        destination: string;
+        referenceAs: string;
+    }[] | undefined;
+    runtimeRequirements?: string[] | undefined;
+    userQuestion?: string | undefined;
+}>;
+export type ExecutionMode = z.infer<typeof executionModeSchema>;
+export type ExecutionConfidence = z.infer<typeof executionConfidenceSchema>;
+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
      *  markdown; markdown entries are written directly as `DESIGN.md`. The
      *  order matches code-gen variant slot order. */
@@ -268,12 +449,12 @@ export declare const projectContextFresh: z.ZodObject<{
         label: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         kind: "markdown";
-        content: string;
         label: string;
+        content: string;
     }, {
         kind: "markdown";
-        content: string;
         label: string;
+        content: string;
     }>]>, "many">>;
     sourceContext: z.ZodOptional<z.ZodObject<{
         sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -284,12 +465,12 @@ export declare const projectContextFresh: z.ZodObject<{
             content: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }, {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }>, "many">>;
         artifact: z.ZodOptional<z.ZodObject<{
             sourceFindings: z.ZodArray<z.ZodString, "many">;
@@ -336,14 +517,46 @@ export declare const projectContextFresh: z.ZodObject<{
             screenshotReferences?: string[] | undefined;
             risks?: string[] | undefined;
         }>>;
+        sourceIntent: z.ZodOptional<z.ZodObject<{
+            sources: z.ZodArray<z.ZodObject<{
+                url: 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";
+            }, {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        }, {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        }>>;
         designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
     }, "strip", z.ZodTypeAny, {
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }[] | undefined;
         artifact?: {
             sourceFindings: string[];
@@ -358,14 +571,22 @@ export declare const projectContextFresh: z.ZodObject<{
             screenshotReferences?: string[] | undefined;
             risks?: string[] | undefined;
         } | undefined;
+        sourceIntent?: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     }, {
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }[] | undefined;
         artifact?: {
             sourceFindings: string[];
@@ -380,27 +601,83 @@ export declare const projectContextFresh: z.ZodObject<{
             screenshotReferences?: string[] | undefined;
             risks?: string[] | undefined;
         } | undefined;
+        sourceIntent?: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     }>>;
+    /** Agent-supplied execution plan from `report_source_plan`. Drives the
+     *  generation routing decision at approve() time: `static_preview` keeps
+     *  the lightweight HTML-only path; `vite_app` provisions a real Vite
+     *  worktree per variant and copies any large assets from `assetPlan`. */
+    executionPlan: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodEnum<["static_preview", "vite_app"]>;
+        confidence: z.ZodEnum<["low", "medium", "high"]>;
+        reason: z.ZodString;
+        assetPlan: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            destination: z.ZodString;
+            referenceAs: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }, {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }>, "many">>;
+        runtimeRequirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        userQuestion: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    }, {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     kind: "fresh";
     workspacePath: string;
+    workspaceRoot: string;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
+    assetSourceRoot?: string | undefined;
     designContext?: ({
         slug: string;
         kind: "slug";
     } | {
         kind: "markdown";
-        content: string;
         label: string;
+        content: string;
     })[] | undefined;
     sourceContext?: {
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }[] | undefined;
         artifact?: {
             sourceFindings: string[];
@@ -415,27 +692,49 @@ export declare const projectContextFresh: z.ZodObject<{
             screenshotReferences?: string[] | undefined;
             risks?: string[] | undefined;
         } | undefined;
+        sourceIntent?: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     } | undefined;
+    executionPlan?: {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    } | undefined;
 }, {
     kind: "fresh";
     workspacePath: string;
+    workspaceRoot: string;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
+    assetSourceRoot?: string | undefined;
     designContext?: ({
         slug: string;
         kind: "slug";
     } | {
         kind: "markdown";
-        content: string;
         label: string;
+        content: string;
     })[] | undefined;
     sourceContext?: {
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }[] | undefined;
         artifact?: {
             sourceFindings: string[];
@@ -450,8 +749,28 @@ export declare const projectContextFresh: z.ZodObject<{
             screenshotReferences?: string[] | undefined;
             risks?: string[] | undefined;
         } | undefined;
+        sourceIntent?: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     } | undefined;
+    executionPlan?: {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    } | undefined;
 }>;
 export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"existing">;
@@ -461,8 +780,19 @@ 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
      *  markdown; markdown entries are written directly as `DESIGN.md`. The
      *  order matches code-gen variant slot order. */
@@ -481,12 +811,12 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         label: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         kind: "markdown";
-        content: string;
         label: string;
+        content: string;
     }, {
         kind: "markdown";
-        content: string;
         label: string;
+        content: string;
     }>]>, "many">>;
     sourceContext: z.ZodOptional<z.ZodObject<{
         sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -497,12 +827,12 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             content: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }, {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }>, "many">>;
         artifact: z.ZodOptional<z.ZodObject<{
             sourceFindings: z.ZodArray<z.ZodString, "many">;
@@ -549,14 +879,46 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             screenshotReferences?: string[] | undefined;
             risks?: string[] | undefined;
         }>>;
+        sourceIntent: z.ZodOptional<z.ZodObject<{
+            sources: z.ZodArray<z.ZodObject<{
+                url: 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";
+            }, {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        }, {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        }>>;
         designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
     }, "strip", z.ZodTypeAny, {
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }[] | undefined;
         artifact?: {
             sourceFindings: string[];
@@ -571,14 +933,22 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             screenshotReferences?: string[] | undefined;
             risks?: string[] | undefined;
         } | undefined;
+        sourceIntent?: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     }, {
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }[] | undefined;
         artifact?: {
             sourceFindings: string[];
@@ -593,27 +963,83 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             screenshotReferences?: string[] | undefined;
             risks?: string[] | undefined;
         } | undefined;
+        sourceIntent?: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     }>>;
+    /** Agent-supplied execution plan from `report_source_plan`. Drives the
+     *  generation routing decision at approve() time: `static_preview` keeps
+     *  the lightweight HTML-only path; `vite_app` provisions a real Vite
+     *  worktree per variant and copies any large assets from `assetPlan`. */
+    executionPlan: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodEnum<["static_preview", "vite_app"]>;
+        confidence: z.ZodEnum<["low", "medium", "high"]>;
+        reason: z.ZodString;
+        assetPlan: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            destination: z.ZodString;
+            referenceAs: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }, {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }>, "many">>;
+        runtimeRequirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        userQuestion: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    }, {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     kind: "fresh";
     workspacePath: string;
+    workspaceRoot: string;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
+    assetSourceRoot?: string | undefined;
     designContext?: ({
         slug: string;
         kind: "slug";
     } | {
         kind: "markdown";
-        content: string;
         label: string;
+        content: string;
     })[] | undefined;
     sourceContext?: {
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }[] | undefined;
         artifact?: {
             sourceFindings: string[];
@@ -628,27 +1054,49 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             screenshotReferences?: string[] | undefined;
             risks?: string[] | undefined;
         } | undefined;
+        sourceIntent?: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     } | undefined;
+    executionPlan?: {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    } | undefined;
 }, {
     kind: "fresh";
     workspacePath: string;
+    workspaceRoot: string;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
+    assetSourceRoot?: string | undefined;
     designContext?: ({
         slug: string;
         kind: "slug";
     } | {
         kind: "markdown";
-        content: string;
         label: string;
+        content: string;
     })[] | undefined;
     sourceContext?: {
         sourceUrls?: string[] | undefined;
         preserveBrand?: boolean | undefined;
         sourceArtifacts?: {
             kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-            content: string;
             label: string;
+            content: string;
         }[] | undefined;
         artifact?: {
             sourceFindings: string[];
@@ -663,8 +1111,28 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             screenshotReferences?: string[] | undefined;
             risks?: string[] | undefined;
         } | undefined;
+        sourceIntent?: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     } | undefined;
+    executionPlan?: {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    } | undefined;
 }>]>;
 export type ProjectContext = z.infer<typeof projectContextSchema>;
 export type DesignContextEntry = z.infer<typeof designContextEntrySchema>;
@@ -692,6 +1160,7 @@ export type ActiveProjectContext = {
 } | {
     kind: 'fresh';
     workspacePath: string;
+    workspaceRoot: string;
     framework?: 'vite' | 'next' | 'astro' | 'remix';
     designContext?: Array<{
         kind: 'slug';
@@ -704,6 +1173,15 @@ export type ActiveProjectContext = {
         sourceCount: number;
         isSourceGrounded: boolean;
     };
+    /** Compact summary of the agent's execution plan, suitable for chip /
+     *  artifact rendering. The full plan stays on the project context. */
+    executionPlan?: {
+        mode: ExecutionMode;
+        confidence: ExecutionConfidence;
+        reason: string;
+        assetCount: number;
+        runtimeRequirementCount: number;
+    };
 };
 export interface ActiveVariantActions {
     view?: {
@@ -725,6 +1203,68 @@ export interface ActiveVariantSnapshot {
     port?: number;
     errorCode?: string;
     actions?: ActiveVariantActions;
+    /**
+     * Objective post-generation QA verdict. Present once the orchestrator has
+     * run preview QA against the variant's deliverable (asset reachability,
+     * runtime/console health). Surfaced on the chip so the user can see why
+     * a variant is not committable. `not_run` indicates QA has not yet been
+     * exercised for this variant kind (e.g. existing-project `code_gen`).
+     */
+    qa?: VariantQaResult;
+}
+/**
+ * Kinds of supporting artifact a variants session can surface to the UI.
+ * `design_context` is the only kind populated today (the DESIGN.md used or
+ * generated for a 0→1 run); the other kinds reserve shape for source
+ * research bundles, QA reports, and persisted asset manifests so the
+ * snapshot contract stays stable as those land.
+ */
+export declare const VARIANT_ARTIFACT_KINDS: readonly ["design_context", "source_context", "qa_report", "asset"];
+export type VariantArtifactKind = (typeof VARIANT_ARTIFACT_KINDS)[number];
+export type VariantArtifactStatus = 'ready' | 'warning' | 'failed';
+export type VariantArtifactSource = 'agent_browser' | 'cache' | 'static' | 'manual';
+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.
+ */
+export interface VariantSessionArtifact {
+    id: string;
+    kind: VariantArtifactKind;
+    label: string;
+    summary?: string;
+    usedByVariantCount?: number;
+    status?: VariantArtifactStatus;
+    source?: VariantArtifactSource;
+    contentType?: VariantArtifactContentType;
+    content?: string;
+    path?: string;
+    warnings?: string[];
+}
+export type VariantQaStatus = 'passed' | 'failed' | 'not_run';
+/**
+ * Categorical QA failure mode. Mirrors the failure surfaces the gate
+ * checks for static previews — referenced assets that fail to load, code
+ * that throws on initial render, or a preview document that couldn't be
+ * fetched at all. Kept small so the user-facing prompt can stay legible.
+ */
+export type VariantQaIssueKind = 'asset_load_failed' | 'console_error' | 'preview_unavailable';
+export interface VariantQaIssue {
+    kind: VariantQaIssueKind;
+    /** Asset URL or runtime source location that triggered the failure. */
+    detail: string;
+    /** Optional human-readable extra context — e.g. HTTP status, error message. */
+    message?: string;
+}
+export interface VariantQaResult {
+    status: VariantQaStatus;
+    issues: VariantQaIssue[];
+    /** Compact, user-facing summary suitable for chip + prompt rendering. */
+    summary: string;
+    /** Source of the inspected preview (the URL or marker the runner used). */
+    checkedSource?: string;
 }
 export declare const targetSchema: z.ZodObject<{
     type: z.ZodEnum<["element", "file", "route"]>;
@@ -741,14 +1281,21 @@ export declare const briefSchema: z.ZodObject<{
     briefId: z.ZodString;
     label: z.ZodString;
     body: z.ZodString;
+    /**
+     * Optional per-brief visual reference URL. Uses the same synchronous
+     * network-target guard as inspiration URLs before downstream agents fetch it.
+     */
+    visualReferenceUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
     label: string;
-    briefId: string;
     body: string;
+    briefId: string;
+    visualReferenceUrl?: string | undefined;
 }, {
     label: string;
-    briefId: string;
     body: string;
+    briefId: string;
+    visualReferenceUrl?: string | undefined;
 }>;
 export type Brief = z.infer<typeof briefSchema>;
 /**
@@ -782,8 +1329,19 @@ 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
          *  markdown; markdown entries are written directly as `DESIGN.md`. The
          *  order matches code-gen variant slot order. */
@@ -802,12 +1360,12 @@ export declare const proposeVariantsInput: {
             label: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             kind: "markdown";
-            content: string;
             label: string;
+            content: string;
         }, {
             kind: "markdown";
-            content: string;
             label: string;
+            content: string;
         }>]>, "many">>;
         sourceContext: z.ZodOptional<z.ZodObject<{
             sourceUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -818,12 +1376,12 @@ export declare const proposeVariantsInput: {
                 content: z.ZodString;
             }, "strip", z.ZodTypeAny, {
                 kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-                content: string;
                 label: string;
+                content: string;
             }, {
                 kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-                content: string;
                 label: string;
+                content: string;
             }>, "many">>;
             artifact: z.ZodOptional<z.ZodObject<{
                 sourceFindings: z.ZodArray<z.ZodString, "many">;
@@ -870,14 +1428,46 @@ export declare const proposeVariantsInput: {
                 screenshotReferences?: string[] | undefined;
                 risks?: string[] | undefined;
             }>>;
+            sourceIntent: z.ZodOptional<z.ZodObject<{
+                sources: z.ZodArray<z.ZodObject<{
+                    url: 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";
+                }, {
+                    reason: string;
+                    url: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                }>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                sources: {
+                    reason: string;
+                    url: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                }[];
+            }, {
+                sources: {
+                    reason: string;
+                    url: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                }[];
+            }>>;
             designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
         }, "strip", z.ZodTypeAny, {
             sourceUrls?: string[] | undefined;
             preserveBrand?: boolean | undefined;
             sourceArtifacts?: {
                 kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-                content: string;
                 label: string;
+                content: string;
             }[] | undefined;
             artifact?: {
                 sourceFindings: string[];
@@ -892,14 +1482,22 @@ export declare const proposeVariantsInput: {
                 screenshotReferences?: string[] | undefined;
                 risks?: string[] | undefined;
             } | undefined;
+            sourceIntent?: {
+                sources: {
+                    reason: string;
+                    url: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                }[];
+            } | undefined;
             designDecision?: "let_rivet_choose" | "go_custom" | undefined;
         }, {
             sourceUrls?: string[] | undefined;
             preserveBrand?: boolean | undefined;
             sourceArtifacts?: {
                 kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-                content: string;
                 label: string;
+                content: string;
             }[] | undefined;
             artifact?: {
                 sourceFindings: string[];
@@ -914,27 +1512,83 @@ export declare const proposeVariantsInput: {
                 screenshotReferences?: string[] | undefined;
                 risks?: string[] | undefined;
             } | undefined;
+            sourceIntent?: {
+                sources: {
+                    reason: string;
+                    url: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                }[];
+            } | undefined;
             designDecision?: "let_rivet_choose" | "go_custom" | undefined;
         }>>;
+        /** Agent-supplied execution plan from `report_source_plan`. Drives the
+         *  generation routing decision at approve() time: `static_preview` keeps
+         *  the lightweight HTML-only path; `vite_app` provisions a real Vite
+         *  worktree per variant and copies any large assets from `assetPlan`. */
+        executionPlan: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodEnum<["static_preview", "vite_app"]>;
+            confidence: z.ZodEnum<["low", "medium", "high"]>;
+            reason: z.ZodString;
+            assetPlan: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                source: z.ZodString;
+                destination: z.ZodString;
+                referenceAs: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }, {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }>, "many">>;
+            runtimeRequirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            userQuestion: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        }, {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         kind: "fresh";
         workspacePath: string;
+        workspaceRoot: string;
         framework?: "next" | "vite" | "remix" | "astro" | undefined;
+        assetSourceRoot?: string | undefined;
         designContext?: ({
             slug: string;
             kind: "slug";
         } | {
             kind: "markdown";
-            content: string;
             label: string;
+            content: string;
         })[] | undefined;
         sourceContext?: {
             sourceUrls?: string[] | undefined;
             preserveBrand?: boolean | undefined;
             sourceArtifacts?: {
                 kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-                content: string;
                 label: string;
+                content: string;
             }[] | undefined;
             artifact?: {
                 sourceFindings: string[];
@@ -949,27 +1603,49 @@ export declare const proposeVariantsInput: {
                 screenshotReferences?: string[] | undefined;
                 risks?: string[] | undefined;
             } | undefined;
+            sourceIntent?: {
+                sources: {
+                    reason: string;
+                    url: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                }[];
+            } | undefined;
             designDecision?: "let_rivet_choose" | "go_custom" | undefined;
         } | undefined;
+        executionPlan?: {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        } | undefined;
     }, {
         kind: "fresh";
         workspacePath: string;
+        workspaceRoot: string;
         framework?: "next" | "vite" | "remix" | "astro" | undefined;
+        assetSourceRoot?: string | undefined;
         designContext?: ({
             slug: string;
             kind: "slug";
         } | {
             kind: "markdown";
-            content: string;
             label: string;
+            content: string;
         })[] | undefined;
         sourceContext?: {
             sourceUrls?: string[] | undefined;
             preserveBrand?: boolean | undefined;
             sourceArtifacts?: {
                 kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
-                content: string;
                 label: string;
+                content: string;
             }[] | undefined;
             artifact?: {
                 sourceFindings: string[];
@@ -984,8 +1660,28 @@ export declare const proposeVariantsInput: {
                 screenshotReferences?: string[] | undefined;
                 risks?: string[] | undefined;
             } | undefined;
+            sourceIntent?: {
+                sources: {
+                    reason: string;
+                    url: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                }[];
+            } | undefined;
             designDecision?: "let_rivet_choose" | "go_custom" | undefined;
         } | undefined;
+        executionPlan?: {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        } | undefined;
     }>]>>;
 };
 export type ProposeVariantsInput = {
@@ -1005,21 +1701,77 @@ export declare const reportVariantBriefsInput: {
         briefId: z.ZodString;
         label: z.ZodString;
         body: z.ZodString;
+        /**
+         * Optional per-brief visual reference URL. Uses the same synchronous
+         * network-target guard as inspiration URLs before downstream agents fetch it.
+         */
+        visualReferenceUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     }, "strip", z.ZodTypeAny, {
         label: string;
-        briefId: string;
         body: string;
+        briefId: string;
+        visualReferenceUrl?: string | undefined;
     }, {
         label: string;
-        briefId: string;
         body: string;
+        briefId: string;
+        visualReferenceUrl?: string | undefined;
     }>, "many">;
 };
-export declare const reportSourceContextInput: {
-    sessionId: z.ZodString;
-    workItemId: z.ZodString;
-    attempt: z.ZodNumber;
-    leaseId: z.ZodString;
+declare const browserDesignContextSchema: z.ZodObject<{
+    url: z.ZodString;
+    label: z.ZodString;
+    markdown: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    markdown: string;
+    url: string;
+    label: string;
+}, {
+    markdown: string;
+    url: string;
+    label: string;
+}>;
+/**
+ * Consolidated planning artifact reported by the agent in a single tool call.
+ * Combines URL/role classification, research findings, browser-extracted
+ * DESIGN.md per design_source URL, and the static_preview vs vite_app
+ * execution decision. Replaces the prior `report_source_intent` +
+ * `report_source_context` round-trips so source-grounded sessions only need
+ * one planning hop before briefs.
+ */
+export declare const sourcePlanArtifactSchema: z.ZodObject<{
+    sourceIntent: z.ZodObject<{
+        sources: z.ZodArray<z.ZodObject<{
+            url: 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";
+        }, {
+            reason: string;
+            url: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        sources: {
+            reason: string;
+            url: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+        }[];
+    }, {
+        sources: {
+            reason: string;
+            url: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+        }[];
+    }>;
     sourceContext: z.ZodObject<{
         sourceFindings: z.ZodArray<z.ZodString, "many">;
         sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -1065,14 +1817,374 @@ export declare const reportSourceContextInput: {
         screenshotReferences?: string[] | undefined;
         risks?: string[] | undefined;
     }>;
+    designContexts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        label: z.ZodString;
+        markdown: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        markdown: string;
+        url: string;
+        label: string;
+    }, {
+        markdown: string;
+        url: string;
+        label: string;
+    }>, "many">>;
+    executionPlan: z.ZodObject<{
+        mode: z.ZodEnum<["static_preview", "vite_app"]>;
+        confidence: z.ZodEnum<["low", "medium", "high"]>;
+        reason: z.ZodString;
+        assetPlan: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            destination: z.ZodString;
+            referenceAs: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }, {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }>, "many">>;
+        runtimeRequirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        userQuestion: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    }, {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    sourceIntent: {
+        sources: {
+            reason: string;
+            url: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+        }[];
+    };
+    sourceContext: {
+        sourceFindings: string[];
+        sectionInventory: string[];
+        visualObservations: string[];
+        sourceRoles: {
+            url: string;
+            role: "primary" | "inspiration" | "competitor";
+            rationale?: string | undefined;
+        }[];
+        qualityBar: string[];
+        screenshotReferences?: string[] | undefined;
+        risks?: string[] | undefined;
+    };
+    executionPlan: {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    };
+    designContexts?: {
+        markdown: string;
+        url: string;
+        label: string;
+    }[] | undefined;
+}, {
+    sourceIntent: {
+        sources: {
+            reason: string;
+            url: string;
+            role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+            confidence: "low" | "medium" | "high";
+        }[];
+    };
+    sourceContext: {
+        sourceFindings: string[];
+        sectionInventory: string[];
+        visualObservations: string[];
+        sourceRoles: {
+            url: string;
+            role: "primary" | "inspiration" | "competitor";
+            rationale?: string | undefined;
+        }[];
+        qualityBar: string[];
+        screenshotReferences?: string[] | undefined;
+        risks?: string[] | undefined;
+    };
+    executionPlan: {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    };
+    designContexts?: {
+        markdown: string;
+        url: string;
+        label: string;
+    }[] | undefined;
+}>;
+export type SourcePlanArtifact = z.infer<typeof sourcePlanArtifactSchema>;
+export type BrowserDesignContext = z.infer<typeof browserDesignContextSchema>;
+export declare const reportSourcePlanInput: {
+    sessionId: z.ZodString;
+    workItemId: z.ZodString;
+    attempt: z.ZodNumber;
+    leaseId: z.ZodString;
+    sourcePlan: z.ZodObject<{
+        sourceIntent: z.ZodObject<{
+            sources: z.ZodArray<z.ZodObject<{
+                url: 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";
+            }, {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        }, {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        }>;
+        sourceContext: z.ZodObject<{
+            sourceFindings: z.ZodArray<z.ZodString, "many">;
+            sectionInventory: z.ZodArray<z.ZodString, "many">;
+            visualObservations: z.ZodArray<z.ZodString, "many">;
+            sourceRoles: z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                role: z.ZodEnum<["primary", "inspiration", "competitor"]>;
+                rationale: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }, {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }>, "many">;
+            qualityBar: z.ZodArray<z.ZodString, "many">;
+            screenshotReferences: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            risks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            sourceFindings: string[];
+            sectionInventory: string[];
+            visualObservations: string[];
+            sourceRoles: {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }[];
+            qualityBar: string[];
+            screenshotReferences?: string[] | undefined;
+            risks?: string[] | undefined;
+        }, {
+            sourceFindings: string[];
+            sectionInventory: string[];
+            visualObservations: string[];
+            sourceRoles: {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }[];
+            qualityBar: string[];
+            screenshotReferences?: string[] | undefined;
+            risks?: string[] | undefined;
+        }>;
+        designContexts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            label: z.ZodString;
+            markdown: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            markdown: string;
+            url: string;
+            label: string;
+        }, {
+            markdown: string;
+            url: string;
+            label: string;
+        }>, "many">>;
+        executionPlan: z.ZodObject<{
+            mode: z.ZodEnum<["static_preview", "vite_app"]>;
+            confidence: z.ZodEnum<["low", "medium", "high"]>;
+            reason: z.ZodString;
+            assetPlan: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                source: z.ZodString;
+                destination: z.ZodString;
+                referenceAs: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }, {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }>, "many">>;
+            runtimeRequirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            userQuestion: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        }, {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        sourceIntent: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        };
+        sourceContext: {
+            sourceFindings: string[];
+            sectionInventory: string[];
+            visualObservations: string[];
+            sourceRoles: {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }[];
+            qualityBar: string[];
+            screenshotReferences?: string[] | undefined;
+            risks?: string[] | undefined;
+        };
+        executionPlan: {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        };
+        designContexts?: {
+            markdown: string;
+            url: string;
+            label: string;
+        }[] | undefined;
+    }, {
+        sourceIntent: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        };
+        sourceContext: {
+            sourceFindings: string[];
+            sectionInventory: string[];
+            visualObservations: string[];
+            sourceRoles: {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }[];
+            qualityBar: string[];
+            screenshotReferences?: string[] | undefined;
+            risks?: string[] | undefined;
+        };
+        executionPlan: {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                source: string;
+                destination: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        };
+        designContexts?: {
+            markdown: string;
+            url: string;
+            label: string;
+        }[] | undefined;
+    }>;
 };
-export type ReportSourceContextInput = {
+export type ReportSourcePlanInput = {
     sessionId: string;
     workItemId: string;
     attempt: number;
     leaseId: string;
-    sourceContext: SourceContextArtifact;
+    sourcePlan: SourcePlanArtifact;
 };
+export interface SourcePlanWorkItemDescriptor {
+    id: string;
+    kind: 'source_plan';
+    attempt: number;
+    input: unknown;
+    output_schema: unknown;
+}
 export type ReportVariantBriefsInput = {
     sessionId: string;
     workItemId: string;
@@ -1138,7 +2250,7 @@ export type CommitVariantOutput = {
     enqueued: boolean;
     duplicate: boolean;
     changedFilesCount: number;
-    payloadKind?: 'diff' | 'project-created';
+    payloadKind?: 'diff' | 'diff-applied' | 'project-created';
     destinationPath?: string;
 } | {
     stage: 'failed';
@@ -1197,6 +2309,57 @@ export type ReportVariantCompleteInput = {
     tokensOut?: number;
     model?: string;
 };
+/**
+ * Stateless inspiration-extraction kickoff. Agents call this before
+ * `start_variants(mode='zero_to_one')` when the user provides inspiration
+ * URLs or other source artifacts, then pass the returned `designContext`
+ * (and optional `sourceContext` echo) into `start_variants`.
+ */
+export declare const extractInspirationContextInput: {
+    prompt: z.ZodString;
+    count: z.ZodNumber;
+    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"]>;
+        label: z.ZodString;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+        label: string;
+        content: string;
+    }, {
+        kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+        label: string;
+        content: string;
+    }>, "many">>;
+    /** When true, bypass any cache entry and force a fresh fetch + extract. */
+    forceRefresh: z.ZodOptional<z.ZodBoolean>;
+    /** Caller-supplied correlation id, echoed into telemetry so this stateless
+     *  extraction can be tied to the subsequent `start_variants` call (which
+     *  accepts the same field) even though no session exists yet. */
+    clientRequestId: z.ZodOptional<z.ZodString>;
+};
+export type ExtractInspirationContextInput = {
+    prompt: string;
+    count: number;
+    urls?: string[];
+    preserveBrand?: boolean;
+    sourceArtifacts?: SourceArtifactInput[];
+    forceRefresh?: boolean;
+    clientRequestId?: string;
+};
+export type ExtractInspirationContextOutput = {
+    designContext: DesignContextEntry[];
+    warnings: string[];
+    /** Echoed back so the agent can forward the same shape into
+     *  `start_variants(mode='zero_to_one')` without reconstructing it. */
+    sourceContext?: SourceContextInput;
+} | {
+    stage: 'failed';
+    errorCode: ErrorCode;
+    message: string;
+};
 export declare const cancelVariantsInput: {
     sessionId: z.ZodString;
     reason: z.ZodOptional<z.ZodString>;
@@ -1227,6 +2390,29 @@ export type CancelVariantOutput = {
     message: string;
 };
 export declare const startVariantsMode: z.ZodEnum<["existing", "zero_to_one"]>;
+/**
+ * Brief content supplied by the agent through `start_variants`. The server
+ * generates briefIds, so the agent only provides label + body (and an
+ * optional visualReferenceUrl). Shape matches `briefSchema` minus briefId.
+ */
+export declare const startVariantsBriefContent: z.ZodObject<Omit<{
+    briefId: z.ZodString;
+    label: z.ZodString;
+    body: z.ZodString;
+    /**
+     * Optional per-brief visual reference URL. Uses the same synchronous
+     * network-target guard as inspiration URLs before downstream agents fetch it.
+     */
+    visualReferenceUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+}, "briefId">, "strip", z.ZodTypeAny, {
+    label: string;
+    body: string;
+    visualReferenceUrl?: string | undefined;
+}, {
+    label: string;
+    body: string;
+    visualReferenceUrl?: string | undefined;
+}>;
 export declare const startVariantsInput: {
     prompt: z.ZodString;
     count: z.ZodOptional<z.ZodNumber>;
@@ -1241,6 +2427,32 @@ export declare const startVariantsInput: {
         type: "element" | "file" | "route";
         ref: string;
     }>>;
+    /**
+     * Per-variant briefs supplied by the agent. When omitted, the server
+     * falls back to a generic "Variant N" label + the prompt verbatim for
+     * each body — UI shows that as the variant name/description, so the
+     * agent should always supply briefs for human-readable variants. When
+     * `briefs` is provided, its length determines the variant count
+     * (overriding any explicit `count`).
+     */
+    briefs: z.ZodOptional<z.ZodArray<z.ZodObject<Omit<{
+        briefId: z.ZodString;
+        label: z.ZodString;
+        body: z.ZodString;
+        /**
+         * Optional per-brief visual reference URL. Uses the same synchronous
+         * network-target guard as inspiration URLs before downstream agents fetch it.
+         */
+        visualReferenceUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "briefId">, "strip", z.ZodTypeAny, {
+        label: string;
+        body: string;
+        visualReferenceUrl?: string | undefined;
+    }, {
+        label: string;
+        body: string;
+        visualReferenceUrl?: string | undefined;
+    }>, "many">>;
     /** Zero-to-one only: framework for the scaffolded project. Defaults to 'vite'. */
     framework: z.ZodOptional<z.ZodEnum<["vite"]>>;
     /** Zero-to-one only: absolute parent directory under which Rivet derives
@@ -1250,8 +2462,192 @@ export declare const startVariantsInput: {
      *  server's current working directory. Used to detect framework and
      *  auto-open the visual editor without a separate detect_project call. */
     projectPath: z.ZodOptional<z.ZodString>;
+    /** Zero-to-one only: per-variant-slot design context produced upstream by
+     *  `extract_inspiration_context`. Threaded into the fresh worktree as
+     *  DESIGN.md per slot. Slot order matches variant order. */
+    designContext: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"slug">;
+        slug: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        kind: "slug";
+    }, {
+        slug: string;
+        kind: "slug";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"markdown">;
+        content: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "markdown";
+        label: string;
+        content: string;
+    }, {
+        kind: "markdown";
+        label: string;
+        content: string;
+    }>]>, "many">>;
+    /** Zero-to-one only: optional source-context metadata (inspiration URLs,
+     *  preserveBrand flag, sourceArtifacts). Forwarded to the worktree
+     *  scaffold so SOURCE_CONTEXT.md is written. */
+    sourceContext: z.ZodOptional<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"]>;
+            label: z.ZodString;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            label: string;
+            content: string;
+        }, {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            label: string;
+            content: string;
+        }>, "many">>;
+        artifact: z.ZodOptional<z.ZodObject<{
+            sourceFindings: z.ZodArray<z.ZodString, "many">;
+            sectionInventory: z.ZodArray<z.ZodString, "many">;
+            visualObservations: z.ZodArray<z.ZodString, "many">;
+            sourceRoles: z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                role: z.ZodEnum<["primary", "inspiration", "competitor"]>;
+                rationale: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }, {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }>, "many">;
+            qualityBar: z.ZodArray<z.ZodString, "many">;
+            screenshotReferences: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            risks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            sourceFindings: string[];
+            sectionInventory: string[];
+            visualObservations: string[];
+            sourceRoles: {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }[];
+            qualityBar: string[];
+            screenshotReferences?: string[] | undefined;
+            risks?: string[] | undefined;
+        }, {
+            sourceFindings: string[];
+            sectionInventory: string[];
+            visualObservations: string[];
+            sourceRoles: {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }[];
+            qualityBar: string[];
+            screenshotReferences?: string[] | undefined;
+            risks?: string[] | undefined;
+        }>>;
+        sourceIntent: z.ZodOptional<z.ZodObject<{
+            sources: z.ZodArray<z.ZodObject<{
+                url: 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";
+            }, {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        }, {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        }>>;
+        designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
+    }, "strip", z.ZodTypeAny, {
+        sourceUrls?: string[] | undefined;
+        preserveBrand?: boolean | undefined;
+        sourceArtifacts?: {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            label: string;
+            content: string;
+        }[] | undefined;
+        artifact?: {
+            sourceFindings: string[];
+            sectionInventory: string[];
+            visualObservations: string[];
+            sourceRoles: {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }[];
+            qualityBar: string[];
+            screenshotReferences?: string[] | undefined;
+            risks?: string[] | undefined;
+        } | undefined;
+        sourceIntent?: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        } | undefined;
+        designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+    }, {
+        sourceUrls?: string[] | undefined;
+        preserveBrand?: boolean | undefined;
+        sourceArtifacts?: {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes";
+            label: string;
+            content: string;
+        }[] | undefined;
+        artifact?: {
+            sourceFindings: string[];
+            sectionInventory: string[];
+            visualObservations: string[];
+            sourceRoles: {
+                url: string;
+                role: "primary" | "inspiration" | "competitor";
+                rationale?: string | undefined;
+            }[];
+            qualityBar: string[];
+            screenshotReferences?: string[] | undefined;
+            risks?: string[] | undefined;
+        } | undefined;
+        sourceIntent?: {
+            sources: {
+                reason: string;
+                url: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+            }[];
+        } | undefined;
+        designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+    }>>;
     clientRequestId: z.ZodOptional<z.ZodString>;
 };
+export type StartVariantsBriefContent = z.infer<typeof startVariantsBriefContent>;
 export type StartVariantsInput = {
     prompt: string;
     count?: number;
@@ -1260,7 +2656,10 @@ export type StartVariantsInput = {
     framework?: 'vite';
     destinationParent?: string;
     projectPath?: string;
+    designContext?: DesignContextEntry[];
+    sourceContext?: SourceContextInput;
     clientRequestId?: string;
+    briefs?: StartVariantsBriefContent[];
 };
 /**
  * Variant entry in the start_variants response. Carries everything the
@@ -1312,13 +2711,6 @@ export interface BriefWorkItemDescriptor {
     input: unknown;
     output_schema: unknown;
 }
-export interface SourceResearchWorkItemDescriptor {
-    id: string;
-    kind: 'source_research';
-    attempt: number;
-    input: unknown;
-    output_schema: unknown;
-}
 export interface LeasedWorkItemDescriptor {
     id: string;
     kind: WorkItemKind;
@@ -1336,8 +2728,8 @@ export interface VisualEditorAttachment {
 }
 export type ProposeVariantsOutput = {
     sessionId: string;
-    stage: 'awaiting_source_research';
-    sourceResearchWorkItem: SourceResearchWorkItemDescriptor;
+    stage: 'awaiting_source_plan';
+    sourcePlanWorkItem: SourcePlanWorkItemDescriptor;
     nextAction: 'continue_variants';
     visualEditor?: VisualEditorAttachment;
 } | {
@@ -1363,9 +2755,16 @@ export type ReportVariantBriefsOutput = {
     errorCode: ErrorCode;
     message: string;
 };
-export type ReportSourceContextOutput = {
+export type ReportSourcePlanOutput = {
     stage: 'awaiting_briefs';
     briefWorkItem: BriefWorkItemDescriptor;
+    executionPlan: {
+        mode: ExecutionMode;
+        confidence: ExecutionConfidence;
+        reason: string;
+        assetCount: number;
+        runtimeRequirementCount: number;
+    };
     nextAction: 'report_variant_briefs';
 } | {
     stage: 'failed';
@@ -1373,11 +2772,16 @@ export type ReportSourceContextOutput = {
     message: string;
 };
 export type ContinueVariantsOutput = {
-    stage: 'awaiting_source_research';
+    stage: 'awaiting_source_plan';
     progress: {
         ready: number;
         total: number;
     };
+} | {
+    stage: 'awaiting_source_plan';
+    leaseId: string;
+    leaseTtlMs: number;
+    leasedWorkItems: LeasedWorkItemDescriptor[];
 } | {
     stage: 'awaiting_approval';
     briefs: Brief[];
@@ -1396,6 +2800,18 @@ export type ContinueVariantsOutput = {
 } | {
     stage: 'ready' | 'degraded' | 'failed' | 'cancelled';
     summary: TerminalSummary;
+    /** Human-readable retry/continue/cancel prompt populated when any
+     *  succeeded-then-QA-failed variant is present in the summary. The
+     *  calling agent should surface this directly to the user. */
+    qaPrompt?: string;
+    /** Per-variant QA verdicts for variants with a `qa` result. Only
+     *  variants with a non-`not_run` status are included so the field
+     *  stays empty when nothing interesting has happened. */
+    qa?: Array<{
+        workItemId: string;
+        label?: string;
+        qa: VariantQaResult;
+    }>;
 };
 export type ReportVariantCompleteOutput = {
     stage: 'waiting_for_results';
@@ -1406,6 +2822,13 @@ export type ReportVariantCompleteOutput = {
 } | {
     stage: 'ready' | 'degraded' | 'failed' | 'cancelled';
     summary: TerminalSummary;
+    /** See `ContinueVariantsOutput.qaPrompt`. */
+    qaPrompt?: string;
+    qa?: Array<{
+        workItemId: string;
+        label?: string;
+        qa: VariantQaResult;
+    }>;
 };
 export type CancelVariantsOutput = {
     stage: 'cancelled';
@@ -1425,12 +2848,101 @@ export interface TerminalSummary {
         label?: string;
     }>;
 }
-export type VariantPickPayload = {
+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 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;
+}
+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
+ * predate server-side apply can still introspect the diff body. The
+ * production commit path now applies the diff before enqueueing and emits
+ * `diff-applied` to the bridge so MCP agents don't re-apply.
+ */
+{
     kind: 'diff';
     diff: string;
     target?: Target;
     changedFilesCount: number;
 }
+/**
+ * Agent-facing post-apply state for existing-project picks. The variant's
+ * unified diff has already been applied to the user's working tree
+ * (uncommitted). Agents must NOT run `git apply` again — just inform the
+ * user and proceed.
+ */
+ | {
+    kind: 'diff-applied';
+    diff: string;
+    target?: Target;
+    changedFilesCount: number;
+    note: string;
+}
 /**
  * Server-internal pre-materialize state for fresh-project picks. Held while
  * the orchestrator copies `sourceWorktreePath` to `destinationPath`. Never