rivet-design 0.9.2 → 0.9.4

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_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 ["brief", "scaffold_base", "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];
@@ -28,6 +28,14 @@ export interface WorkItem {
     };
     lease?: LeaseRecord;
     acceptedReports: string[];
+    /**
+     * When true, the work item is owned by the server (no external lease ever
+     * issued, no `request_work` surfacing). Used for `scaffold_base` items in
+     * fresh-project sessions where the server runs the actual scaffold +
+     * `npm install` in the background and reports completion via
+     * `SessionStore.completeInternal`.
+     */
+    internal?: boolean;
 }
 export declare const projectContextExisting: z.ZodObject<{
     kind: z.ZodLiteral<"existing">;
@@ -36,20 +44,723 @@ 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;
+}, "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;
+}>]>;
+export declare const sourceArtifactKindSchema: z.ZodEnum<["urlText", "siteBrief", "visualBrief", "screenshotNotes"]>;
+export declare const sourceArtifactInputSchema: 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;
+}>;
+export declare const sourceRoleSchema: z.ZodEnum<["primary", "inspiration", "competitor"]>;
+export declare const sourceRoleEntrySchema: 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;
+}>;
+export declare const sourceContextArtifactSchema: 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;
+}>;
+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"]>;
+        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;
+}>;
+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">;
     workspacePath: 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. */
+    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">>;
+    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;
+    }>>;
+    /** 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;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
+    assetSourceRoot?: string | undefined;
+    designContext?: ({
+        slug: string;
+        kind: "slug";
+    } | {
+        kind: "markdown";
+        label: string;
+        content: string;
+    })[] | undefined;
+    sourceContext?: {
+        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;
+    } | 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;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
+    assetSourceRoot?: string | undefined;
+    designContext?: ({
+        slug: string;
+        kind: "slug";
+    } | {
+        kind: "markdown";
+        label: string;
+        content: string;
+    })[] | undefined;
+    sourceContext?: {
+        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;
+    } | 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.ZodUnion<[z.ZodObject<{
+export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"existing">;
 }, "strip", z.ZodTypeAny, {
     kind: "existing";
@@ -59,16 +770,477 @@ export declare const projectContextSchema: z.ZodUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"fresh">;
     workspacePath: 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. */
+    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">>;
+    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;
+    }>>;
+    /** 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;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
+    assetSourceRoot?: string | undefined;
+    designContext?: ({
+        slug: string;
+        kind: "slug";
+    } | {
+        kind: "markdown";
+        label: string;
+        content: string;
+    })[] | undefined;
+    sourceContext?: {
+        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;
+    } | 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;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
+    assetSourceRoot?: string | undefined;
+    designContext?: ({
+        slug: string;
+        kind: "slug";
+    } | {
+        kind: "markdown";
+        label: string;
+        content: string;
+    })[] | undefined;
+    sourceContext?: {
+        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;
+    } | 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>;
+export type SourceArtifactInput = z.infer<typeof sourceArtifactInputSchema>;
+export type SourceRole = z.infer<typeof sourceRoleSchema>;
+export type SourceContextArtifact = z.infer<typeof sourceContextArtifactSchema>;
+export type SourceContextInput = z.infer<typeof sourceContextInputSchema>;
+export type VariantDesignSource = {
+    kind: 'slug';
+    slug: string;
+    displayName: string;
+} | {
+    kind: 'markdown';
+    label: string;
+};
+export type VariantPreviewSource = {
+    kind: 'dev_server';
+    port: number;
+} | {
+    kind: 'static_artifact';
+    url: string;
+};
+export type ActiveProjectContext = {
+    kind: 'existing';
+} | {
+    kind: 'fresh';
+    workspacePath: string;
+    framework?: 'vite' | 'next' | 'astro' | 'remix';
+    designContext?: Array<{
+        kind: 'slug';
+        slug: string;
+    } | {
+        kind: 'markdown';
+        label: string;
+    }>;
+    sourceContext?: {
+        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?: {
+        enabled: boolean;
+        reason?: string;
+    };
+    commit?: {
+        enabled: boolean;
+        reason?: string;
+    };
+}
+export interface ActiveVariantSnapshot {
+    workItemId: string;
+    briefId: string;
+    label: string;
+    status: WorkItemStatus;
+    design?: VariantDesignSource;
+    preview?: VariantPreviewSource;
+    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"]>;
     ref: z.ZodString;
@@ -84,16 +1256,31 @@ 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, {
-    briefId: string;
     label: string;
     body: string;
-}, {
     briefId: string;
+    visualReferenceUrl?: string | undefined;
+}, {
     label: string;
     body: string;
+    briefId: string;
+    visualReferenceUrl?: string | undefined;
 }>;
 export type Brief = z.infer<typeof briefSchema>;
+/**
+ * Inclusive bounds for the number of variants a single propose_variants run
+ * may produce. Exported as named constants so the UI (parseVariantCount),
+ * the /api/mcp/queue-changes intake Zod schema, and the propose_variants tool
+ * schema all consume the same source of truth.
+ */
+export declare const VARIANT_COUNT_MIN = 2;
+export declare const VARIANT_COUNT_MAX = 8;
 export declare const proposeVariantsInput: {
     sessionId: z.ZodOptional<z.ZodString>;
     clientRequestId: z.ZodOptional<z.ZodString>;
@@ -109,7 +1296,7 @@ export declare const proposeVariantsInput: {
         type: "element" | "file" | "route";
         ref: string;
     }>>;
-    projectContext: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+    projectContext: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"existing">;
     }, "strip", z.ZodTypeAny, {
         kind: "existing";
@@ -119,14 +1306,345 @@ export declare const proposeVariantsInput: {
         kind: z.ZodLiteral<"fresh">;
         workspacePath: 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. */
+        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">>;
+        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;
+        }>>;
+        /** 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;
         framework?: "next" | "vite" | "remix" | "astro" | undefined;
+        assetSourceRoot?: string | undefined;
+        designContext?: ({
+            slug: string;
+            kind: "slug";
+        } | {
+            kind: "markdown";
+            label: string;
+            content: string;
+        })[] | undefined;
+        sourceContext?: {
+            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;
+        } | 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;
         framework?: "next" | "vite" | "remix" | "astro" | undefined;
+        assetSourceRoot?: string | undefined;
+        designContext?: ({
+            slug: string;
+            kind: "slug";
+        } | {
+            kind: "markdown";
+            label: string;
+            content: string;
+        })[] | undefined;
+        sourceContext?: {
+            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;
+        } | 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 = {
@@ -146,16 +1664,490 @@ 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, {
-        briefId: string;
         label: string;
         body: string;
-    }, {
         briefId: string;
+        visualReferenceUrl?: string | undefined;
+    }, {
         label: string;
         body: string;
+        briefId: string;
+        visualReferenceUrl?: string | undefined;
     }>, "many">;
 };
+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">;
+        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 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 ReportSourcePlanInput = {
+    sessionId: string;
+    workItemId: string;
+    attempt: number;
+    leaseId: string;
+    sourcePlan: SourcePlanArtifact;
+};
+export interface SourcePlanWorkItemDescriptor {
+    id: string;
+    kind: 'source_plan';
+    attempt: number;
+    input: unknown;
+    output_schema: unknown;
+}
 export type ReportVariantBriefsInput = {
     sessionId: string;
     workItemId: string;
@@ -166,6 +2158,9 @@ export type ReportVariantBriefsInput = {
 export declare const approveVariantBriefsInput: {
     sessionId: z.ZodString;
     briefIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    confirmedByUser: z.ZodOptional<z.ZodBoolean>;
+    bypassRequestedByUser: z.ZodOptional<z.ZodBoolean>;
+    bypassReason: z.ZodOptional<z.ZodString>;
     selections: z.ZodOptional<z.ZodArray<z.ZodObject<{
         briefId: z.ZodString;
         bodyOverride: z.ZodOptional<z.ZodString>;
@@ -180,6 +2175,9 @@ export declare const approveVariantBriefsInput: {
 export type ApproveVariantBriefsInput = {
     sessionId: string;
     briefIds?: string[];
+    confirmedByUser?: boolean;
+    bypassRequestedByUser?: boolean;
+    bypassReason?: string;
     selections?: Array<{
         briefId: string;
         bodyOverride?: string;
@@ -199,16 +2197,24 @@ export type ApproveVariantBriefsOutput = {
 export declare const commitVariantInput: {
     sessionId: z.ZodString;
     variantId: z.ZodString;
+    confirmedByUser: z.ZodOptional<z.ZodBoolean>;
+    bypassRequestedByUser: z.ZodOptional<z.ZodBoolean>;
+    bypassReason: z.ZodOptional<z.ZodString>;
 };
 export type CommitVariantInput = {
     sessionId: string;
     variantId: string;
+    confirmedByUser?: boolean;
+    bypassRequestedByUser?: boolean;
+    bypassReason?: string;
 };
 export type CommitVariantOutput = {
     stage: Stage;
     enqueued: boolean;
     duplicate: boolean;
     changedFilesCount: number;
+    payloadKind?: 'diff' | 'diff-applied' | 'project-created';
+    destinationPath?: string;
 } | {
     stage: 'failed';
     errorCode: ErrorCode;
@@ -246,6 +2252,9 @@ export declare const reportVariantCompleteInput: {
         code: string;
     }>>;
     terminalChunk: z.ZodOptional<z.ZodString>;
+    tokensIn: z.ZodOptional<z.ZodNumber>;
+    tokensOut: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodOptional<z.ZodString>;
 };
 export type ReportVariantCompleteInput = {
     sessionId: string;
@@ -259,6 +2268,60 @@ export type ReportVariantCompleteInput = {
         message: string;
     };
     terminalChunk?: string;
+    tokensIn?: number;
+    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;
@@ -268,6 +2331,342 @@ export type CancelVariantsInput = {
     sessionId: string;
     reason?: string;
 };
+export declare const cancelVariantInput: {
+    sessionId: z.ZodString;
+    variantId: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+};
+export type CancelVariantInput = {
+    sessionId: string;
+    variantId: string;
+    reason?: string;
+};
+export type CancelVariantOutput = {
+    sessionId: string;
+    variantId: string;
+    finalStatus: WorkItemStatus;
+    sessionStage: Stage;
+    alreadyTerminal: boolean;
+} | {
+    stage: 'failed';
+    errorCode: ErrorCode;
+    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>;
+    mode: z.ZodEnum<["existing", "zero_to_one"]>;
+    target: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["element", "file", "route"]>;
+        ref: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "element" | "file" | "route";
+        ref: string;
+    }, {
+        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
+     *  a slugified project folder. Defaults to the user's home dir. */
+    destinationParent: z.ZodOptional<z.ZodString>;
+    /** Existing only: absolute path to the project. Defaults to the MCP
+     *  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;
+    mode: 'existing' | 'zero_to_one';
+    target?: Target;
+    framework?: 'vite';
+    destinationParent?: string;
+    projectPath?: string;
+    designContext?: DesignContextEntry[];
+    sourceContext?: SourceContextInput;
+    clientRequestId?: string;
+    briefs?: StartVariantsBriefContent[];
+};
+/**
+ * Variant entry in the start_variants response. Carries everything the
+ * agent needs to begin code-gen immediately — no follow-up
+ * continue_variants(request_work) call required.
+ */
+export interface StartedVariantDescriptor {
+    variantId: string;
+    briefId: string;
+    label: string;
+    status: 'pending';
+    /** Same payload `continue_variants(request_work)` would return per
+     *  leased item: kind, attempt, dependsOn, input (with worktreePath),
+     *  output_schema. */
+    workItem: LeasedWorkItemDescriptor;
+}
+export type StartVariantsOutput = {
+    sessionId: string;
+    stage: 'work_items_ready';
+    mode: 'existing' | 'zero_to_one';
+    /** Lease covers every variant in the `variants` array. The agent
+     *  passes this back to `report_variant_complete` for each item. */
+    leaseId: string;
+    leaseTtlMs: number;
+    variants: StartedVariantDescriptor[];
+    scaffoldBaseWorkItemId: string | null;
+    /** Populated only for zero_to_one: the future project directory. */
+    destinationPath?: string;
+    /** Populated when the server opened the editor server-side — for
+     *  zero_to_one always, for existing when projectPath was provided
+     *  or could be detected. */
+    visualEditor?: VisualEditorAttachment;
+    /** Detected framework / project metadata (existing mode), so the
+     *  agent doesn't need a separate detect_project call. */
+    project?: {
+        projectPath: string;
+        framework: string;
+    };
+    nextAction: 'report_variant_complete';
+} | {
+    stage: 'failed';
+    errorCode: ErrorCode;
+    message: string;
+};
 export interface BriefWorkItemDescriptor {
     id: string;
     kind: 'brief';
@@ -283,11 +2682,25 @@ export interface LeasedWorkItemDescriptor {
     input: unknown;
     output_schema: unknown;
 }
+export interface VisualEditorAttachment {
+    sessionId: string;
+    url: string;
+    rivetPort: number;
+    opened: boolean;
+    attached: boolean;
+}
 export type ProposeVariantsOutput = {
+    sessionId: string;
+    stage: 'awaiting_source_plan';
+    sourcePlanWorkItem: SourcePlanWorkItemDescriptor;
+    nextAction: 'continue_variants';
+    visualEditor?: VisualEditorAttachment;
+} | {
     sessionId: string;
     stage: 'awaiting_briefs';
     briefWorkItem: BriefWorkItemDescriptor;
     nextAction: 'report_variant_briefs';
+    visualEditor?: VisualEditorAttachment;
 } | {
     stage: 'cancelled';
 } | {
@@ -298,15 +2711,44 @@ export type ProposeVariantsOutput = {
 export type ReportVariantBriefsOutput = {
     stage: 'awaiting_approval';
     briefs: Brief[];
+    approvalPrompt: string;
     nextAction: 'continue_variants';
 } | {
     stage: 'failed';
     errorCode: ErrorCode;
     message: string;
 };
+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';
+    errorCode: ErrorCode;
+    message: string;
+};
 export type ContinueVariantsOutput = {
+    stage: 'awaiting_source_plan';
+    progress: {
+        ready: number;
+        total: number;
+    };
+} | {
+    stage: 'awaiting_source_plan';
+    leaseId: string;
+    leaseTtlMs: number;
+    leasedWorkItems: LeasedWorkItemDescriptor[];
+} | {
     stage: 'awaiting_approval';
     briefs: Brief[];
+    approvalPrompt: string;
 } | {
     stage: 'work_items_ready';
     leaseId: string;
@@ -321,6 +2763,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';
@@ -331,6 +2785,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';
@@ -350,16 +2811,53 @@ export interface TerminalSummary {
         label?: string;
     }>;
 }
-export type VariantPickPayload = {
+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
+ * crosses to agents — the agent-facing payload is `project-created`.
+ */
+ | {
     kind: 'new-project';
     destinationPath: string;
     sourceWorktreePath: string;
     changedFilesCount: number;
+}
+/**
+ * Agent-facing post-materialize state for fresh-project picks. The project
+ * already exists on disk at `destinationPath`; the agent only needs to
+ * optionally install dependencies and continue from there.
+ */
+ | {
+    kind: 'project-created';
+    destinationPath: string;
+    changedFilesCount: number;
+    note: string;
 };
 export interface VariantPickEnvelope {
     sourceSessionId: string;