rivet-design 0.10.7 → 0.10.9

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

@@ -45,13 +45,6 @@ export interface WorkItem {
      */
     removed?: boolean;
 }
-export declare const projectContextExisting: z.ZodObject<{
-    kind: z.ZodLiteral<"existing">;
-}, "strip", z.ZodTypeAny, {
-    kind: "existing";
-}, {
-    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"]>;
 /**
@@ -484,24 +477,14 @@ export type ExecutionMode = z.infer<typeof executionModeSchema>;
 export type ExecutionConfidence = z.infer<typeof executionConfidenceSchema>;
 export type AssetPlanEntry = z.infer<typeof assetPlanEntrySchema>;
 export type ExecutionCapabilityPlan = z.infer<typeof executionCapabilityPlanSchema>;
-export declare const projectContextFresh: z.ZodObject<{
-    kind: z.ZodLiteral<"fresh">;
-    /** Where the generated subproject's files live (e.g.
-     *  `fable-eng-demo/.rivet/marketing-clone/`). This is the materialize
-     *  target — the agent reads/writes index.html, src/, etc. here. */
-    workspacePath: z.ZodString;
-    /** The user's working directory that owns *all* Rivet artifacts for the
-     *  session (e.g. `fable-eng-demo`). `<workspaceRoot>/.rivet/` holds
-     *  generated subprojects, variant history, and create-project manifests.
-     *  Distinct from `path.dirname(workspacePath)` because subprojects nest
-     *  inside `.rivet/` — the dirname would resolve to the `.rivet` dir,
-     *  not the workspace itself. */
-    workspaceRoot: z.ZodString;
-    framework: z.ZodOptional<z.ZodEnum<["vite", "next", "astro", "remix"]>>;
-    assetSourceRoot: z.ZodOptional<z.ZodString>;
-    /** Per-variant-slot design context. Slug entries resolve bundled catalog
-     *  markdown; markdown entries are written directly as `DESIGN.md`. The
-     *  order matches code-gen variant slot order. */
+export declare const projectContextExisting: z.ZodObject<{
+    kind: z.ZodLiteral<"existing">;
+    /** Absolute project path requested for this existing-project run. Present
+     *  when callers target a nested project inside a larger git worktree. */
+    projectPath: z.ZodOptional<z.ZodString>;
+    /** Optional design context supplied by agents/benchmarks for existing
+     *  project runs with visual references. Surfaced as DesignMD artifacts and
+     *  available to QA gates, but does not trigger a source-plan stage. */
     designContext: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"slug">;
         slug: z.ZodString;
@@ -698,58 +681,9 @@ export declare const projectContextFresh: z.ZodObject<{
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     }>>;
-    /** Agent-supplied execution plan from `report_source_plan`. Drives the
-     *  generation routing decision at approve() time: `static_preview` keeps
-     *  the lightweight HTML-only path; `vite_app` provisions a real Vite
-     *  worktree per variant and copies any large assets from `assetPlan`. */
-    executionPlan: z.ZodOptional<z.ZodObject<{
-        mode: z.ZodEnum<["static_preview", "vite_app"]>;
-        confidence: z.ZodEnum<["low", "medium", "high"]>;
-        reason: z.ZodString;
-        assetPlan: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            source: z.ZodString;
-            destination: z.ZodString;
-            referenceAs: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            source: string;
-            destination: string;
-            referenceAs: string;
-        }, {
-            source: string;
-            destination: string;
-            referenceAs: string;
-        }>, "many">>;
-        runtimeRequirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        userQuestion: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        mode: "static_preview" | "vite_app";
-        reason: string;
-        confidence: "low" | "medium" | "high";
-        assetPlan?: {
-            source: string;
-            destination: string;
-            referenceAs: string;
-        }[] | undefined;
-        runtimeRequirements?: string[] | undefined;
-        userQuestion?: string | undefined;
-    }, {
-        mode: "static_preview" | "vite_app";
-        reason: string;
-        confidence: "low" | "medium" | "high";
-        assetPlan?: {
-            source: string;
-            destination: string;
-            referenceAs: string;
-        }[] | undefined;
-        runtimeRequirements?: string[] | undefined;
-        userQuestion?: string | undefined;
-    }>>;
 }, "strip", z.ZodTypeAny, {
-    kind: "fresh";
-    workspacePath: string;
-    workspaceRoot: string;
-    framework?: "next" | "vite" | "remix" | "astro" | undefined;
-    assetSourceRoot?: string | undefined;
+    kind: "existing";
+    projectPath?: string | undefined;
     designContext?: ({
         slug: string;
         kind: "slug";
@@ -790,24 +724,9 @@ export declare const projectContextFresh: z.ZodObject<{
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     } | undefined;
-    executionPlan?: {
-        mode: "static_preview" | "vite_app";
-        reason: string;
-        confidence: "low" | "medium" | "high";
-        assetPlan?: {
-            source: string;
-            destination: string;
-            referenceAs: string;
-        }[] | undefined;
-        runtimeRequirements?: string[] | undefined;
-        userQuestion?: string | undefined;
-    } | undefined;
 }, {
-    kind: "fresh";
-    workspacePath: string;
-    workspaceRoot: string;
-    framework?: "next" | "vite" | "remix" | "astro" | undefined;
-    assetSourceRoot?: string | undefined;
+    kind: "existing";
+    projectPath?: string | undefined;
     designContext?: ({
         slug: string;
         kind: "slug";
@@ -848,26 +767,8 @@ export declare const projectContextFresh: z.ZodObject<{
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     } | undefined;
-    executionPlan?: {
-        mode: "static_preview" | "vite_app";
-        reason: string;
-        confidence: "low" | "medium" | "high";
-        assetPlan?: {
-            source: string;
-            destination: string;
-            referenceAs: string;
-        }[] | undefined;
-        runtimeRequirements?: string[] | undefined;
-        userQuestion?: string | undefined;
-    } | undefined;
 }>;
-export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
-    kind: z.ZodLiteral<"existing">;
-}, "strip", z.ZodTypeAny, {
-    kind: "existing";
-}, {
-    kind: "existing";
-}>, z.ZodObject<{
+export declare const projectContextFresh: z.ZodObject<{
     kind: z.ZodLiteral<"fresh">;
     /** Where the generated subproject's files live (e.g.
      *  `fable-eng-demo/.rivet/marketing-clone/`). This is the materialize
@@ -1132,7 +1033,6 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
     workspacePath: string;
     workspaceRoot: string;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
-    assetSourceRoot?: string | undefined;
     designContext?: ({
         slug: string;
         kind: "slug";
@@ -1173,6 +1073,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     } | undefined;
+    assetSourceRoot?: string | undefined;
     executionPlan?: {
         mode: "static_preview" | "vite_app";
         reason: string;
@@ -1190,7 +1091,6 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
     workspacePath: string;
     workspaceRoot: string;
     framework?: "next" | "vite" | "remix" | "astro" | undefined;
-    assetSourceRoot?: string | undefined;
     designContext?: ({
         slug: string;
         kind: "slug";
@@ -1231,6 +1131,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         } | undefined;
         designDecision?: "let_rivet_choose" | "go_custom" | undefined;
     } | undefined;
+    assetSourceRoot?: string | undefined;
     executionPlan?: {
         mode: "static_preview" | "vite_app";
         reason: string;
@@ -1243,123 +1144,813 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         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;
-    workspaceRoot: string;
-    framework?: 'vite' | 'next' | 'astro' | 'remix';
-    designContext?: Array<{
-        kind: 'slug';
+}>;
+export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"existing">;
+    /** Absolute project path requested for this existing-project run. Present
+     *  when callers target a nested project inside a larger git worktree. */
+    projectPath: z.ZodOptional<z.ZodString>;
+    /** Optional design context supplied by agents/benchmarks for existing
+     *  project runs with visual references. Surfaced as DesignMD artifacts and
+     *  available to QA gates, but does not trigger a source-plan stage. */
+    designContext: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"slug">;
+        slug: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
         slug: string;
-    } | {
-        kind: 'markdown';
+        kind: "slug";
+    }, {
+        slug: string;
+        kind: "slug";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"markdown">;
+        content: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "markdown";
+        content: string;
         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;
-    /** ISO timestamp of when the variant's session was generated, so the UI can
-     *  show date metadata on currently-generated variants (mirrors the
-     *  `createdAt` shown on persisted history rows). */
-    createdAt?: string;
-    /** 1–2 word, plain-English label for the *run* this variant belongs to —
-     *  the intent of the prompt that kicked it off (e.g. "Brighter"). Shared by
-     *  every variant in the run; shown on each row so the user can tell which
-     *  prompt a direction came from. */
-    runLabel?: string;
-    /** The variant's brief body — a compact, plain-language statement of what
-     *  THIS variant changes relative to baseline. Shown under the title. */
-    description?: string;
-    design?: VariantDesignSource;
-    preview?: VariantPreviewSource;
-    port?: number;
-    errorCode?: string;
-    actions?: ActiveVariantActions;
-    refinement?: {
-        workItemId: string;
-        status: WorkItemStatus;
-        errorCode?: string;
-    };
-    /**
-     * 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. `design_context` artifacts expose loopback URLs so the
- * UI can open raw markdown or a rendered DesignMD view without carrying the
- * full document in every snapshot.
- */
-export interface VariantSessionArtifact {
-    id: string;
-    kind: VariantArtifactKind;
+    }, {
+        kind: "markdown";
+        content: string;
+        label: 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", "motionBrief"]>;
+            label: z.ZodString;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: string;
+        }, {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: 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.ZodEffects<z.ZodObject<{
+                url: z.ZodOptional<z.ZodString>;
+                imageRef: z.ZodOptional<z.ZodString>;
+                role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
+                confidence: z.ZodEnum<["low", "medium", "high"]>;
+                reason: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }>, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            sources: {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        }, {
+            sources: {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        }>>;
+        designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
+    }, "strip", z.ZodTypeAny, {
+        sourceUrls?: string[] | undefined;
+        preserveBrand?: boolean | undefined;
+        sourceArtifacts?: {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: 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;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        } | undefined;
+        designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+    }, {
+        sourceUrls?: string[] | undefined;
+        preserveBrand?: boolean | undefined;
+        sourceArtifacts?: {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: 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;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        } | undefined;
+        designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    kind: "existing";
+    projectPath?: string | undefined;
+    designContext?: ({
+        slug: string;
+        kind: "slug";
+    } | {
+        kind: "markdown";
+        content: string;
+        label: string;
+    })[] | undefined;
+    sourceContext?: {
+        sourceUrls?: string[] | undefined;
+        preserveBrand?: boolean | undefined;
+        sourceArtifacts?: {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: 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;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        } | undefined;
+        designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+    } | undefined;
+}, {
+    kind: "existing";
+    projectPath?: string | undefined;
+    designContext?: ({
+        slug: string;
+        kind: "slug";
+    } | {
+        kind: "markdown";
+        content: string;
+        label: string;
+    })[] | undefined;
+    sourceContext?: {
+        sourceUrls?: string[] | undefined;
+        preserveBrand?: boolean | undefined;
+        sourceArtifacts?: {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: 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;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        } | undefined;
+        designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"fresh">;
+    /** Where the generated subproject's files live (e.g.
+     *  `fable-eng-demo/.rivet/marketing-clone/`). This is the materialize
+     *  target — the agent reads/writes index.html, src/, etc. here. */
+    workspacePath: z.ZodString;
+    /** The user's working directory that owns *all* Rivet artifacts for the
+     *  session (e.g. `fable-eng-demo`). `<workspaceRoot>/.rivet/` holds
+     *  generated subprojects, variant history, and create-project manifests.
+     *  Distinct from `path.dirname(workspacePath)` because subprojects nest
+     *  inside `.rivet/` — the dirname would resolve to the `.rivet` dir,
+     *  not the workspace itself. */
+    workspaceRoot: z.ZodString;
+    framework: z.ZodOptional<z.ZodEnum<["vite", "next", "astro", "remix"]>>;
+    assetSourceRoot: z.ZodOptional<z.ZodString>;
+    /** Per-variant-slot design context. Slug entries resolve bundled catalog
+     *  markdown; markdown entries are written directly as `DESIGN.md`. The
+     *  order matches code-gen variant slot order. */
+    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";
+        content: string;
+        label: string;
+    }, {
+        kind: "markdown";
+        content: string;
+        label: 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", "motionBrief"]>;
+            label: z.ZodString;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: string;
+        }, {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: 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.ZodEffects<z.ZodObject<{
+                url: z.ZodOptional<z.ZodString>;
+                imageRef: z.ZodOptional<z.ZodString>;
+                role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
+                confidence: z.ZodEnum<["low", "medium", "high"]>;
+                reason: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }>, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }, {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            sources: {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        }, {
+            sources: {
+                reason: string;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        }>>;
+        designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
+    }, "strip", z.ZodTypeAny, {
+        sourceUrls?: string[] | undefined;
+        preserveBrand?: boolean | undefined;
+        sourceArtifacts?: {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: 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;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        } | undefined;
+        designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+    }, {
+        sourceUrls?: string[] | undefined;
+        preserveBrand?: boolean | undefined;
+        sourceArtifacts?: {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: 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;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        } | undefined;
+        designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+    }>>;
+    /** Agent-supplied execution plan from `report_source_plan`. Drives the
+     *  generation routing decision at approve() time: `static_preview` keeps
+     *  the lightweight HTML-only path; `vite_app` provisions a real Vite
+     *  worktree per variant and copies any large assets from `assetPlan`. */
+    executionPlan: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodEnum<["static_preview", "vite_app"]>;
+        confidence: z.ZodEnum<["low", "medium", "high"]>;
+        reason: z.ZodString;
+        assetPlan: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            destination: z.ZodString;
+            referenceAs: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }, {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }>, "many">>;
+        runtimeRequirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        userQuestion: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    }, {
+        mode: "static_preview" | "vite_app";
+        reason: string;
+        confidence: "low" | "medium" | "high";
+        assetPlan?: {
+            source: string;
+            destination: string;
+            referenceAs: string;
+        }[] | undefined;
+        runtimeRequirements?: string[] | undefined;
+        userQuestion?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    kind: "fresh";
+    workspacePath: string;
+    workspaceRoot: string;
+    framework?: "next" | "vite" | "remix" | "astro" | undefined;
+    designContext?: ({
+        slug: string;
+        kind: "slug";
+    } | {
+        kind: "markdown";
+        content: string;
+        label: string;
+    })[] | undefined;
+    sourceContext?: {
+        sourceUrls?: string[] | undefined;
+        preserveBrand?: boolean | undefined;
+        sourceArtifacts?: {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: 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;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        } | undefined;
+        designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+    } | undefined;
+    assetSourceRoot?: 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;
+    } | undefined;
+}, {
+    kind: "fresh";
+    workspacePath: string;
+    workspaceRoot: string;
+    framework?: "next" | "vite" | "remix" | "astro" | undefined;
+    designContext?: ({
+        slug: string;
+        kind: "slug";
+    } | {
+        kind: "markdown";
+        content: string;
+        label: string;
+    })[] | undefined;
+    sourceContext?: {
+        sourceUrls?: string[] | undefined;
+        preserveBrand?: boolean | undefined;
+        sourceArtifacts?: {
+            kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+            content: string;
+            label: 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;
+                role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                confidence: "low" | "medium" | "high";
+                url?: string | undefined;
+                imageRef?: string | undefined;
+            }[];
+        } | undefined;
+        designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+    } | undefined;
+    assetSourceRoot?: 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;
+    } | 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';
+    designContext?: Array<{
+        kind: 'slug';
+        slug: string;
+    } | {
+        kind: 'markdown';
+        label: string;
+    }>;
+    sourceContext?: {
+        sourceCount: number;
+        isSourceGrounded: boolean;
+    };
+} | {
+    kind: 'fresh';
+    workspacePath: string;
+    workspaceRoot: 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;
+    /** ISO timestamp of when the variant's session was generated, so the UI can
+     *  show date metadata on currently-generated variants (mirrors the
+     *  `createdAt` shown on persisted history rows). */
+    createdAt?: string;
+    /** 1–2 word, plain-English label for the *run* this variant belongs to —
+     *  the intent of the prompt that kicked it off (e.g. "Brighter"). Shared by
+     *  every variant in the run; shown on each row so the user can tell which
+     *  prompt a direction came from. */
+    runLabel?: string;
+    /** The variant's brief body — a compact, plain-language statement of what
+     *  THIS variant changes relative to baseline. Shown under the title. */
+    description?: string;
+    design?: VariantDesignSource;
+    preview?: VariantPreviewSource;
+    port?: number;
+    errorCode?: string;
+    /**
+     * Set when a *succeeded* variant has no live preview because its preview dev
+     * server failed to start (commonly the port was already in use). Lets the UI
+     * show an accurate per-direction "preview couldn't start" message instead of
+     * the generic "Preview isn't connected / restart Rivet" overlay, which is
+     * misleading here — nothing is offline, this one direction's preview server
+     * just never bound a port.
+     */
+    previewUnavailable?: {
+        reason: 'spawn_error' | 'exited' | 'timeout' | 'unknown';
+        portInUse?: boolean;
+    };
+    actions?: ActiveVariantActions;
+    refinement?: {
+        workItemId: string;
+        status: WorkItemStatus;
+        errorCode?: string;
+    };
+    /**
+     * 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. `design_context` artifacts expose loopback URLs so the
+ * UI can open raw markdown or a rendered DesignMD view without carrying the
+ * full document in every snapshot.
+ */
+export interface VariantSessionArtifact {
+    id: string;
+    kind: VariantArtifactKind;
     label: string;
     summary?: string;
     usedByVariantCount?: number;
@@ -1377,9 +1968,11 @@ 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.
+ * fetched at all. `design_quality` is the aesthetic self-critique verdict:
+ * the rendered variant scored below the must-pass bar on the design rubric.
+ * Kept small so the user-facing prompt can stay legible.
  */
-export type VariantQaIssueKind = 'asset_load_failed' | 'console_error' | 'preview_unavailable';
+export type VariantQaIssueKind = 'asset_load_failed' | 'console_error' | 'preview_unavailable' | 'design_quality';
 export interface VariantQaIssue {
     kind: VariantQaIssueKind;
     /** Asset URL or runtime source location that triggered the failure. */
@@ -1387,6 +1980,57 @@ export interface VariantQaIssue {
     /** Optional human-readable extra context — e.g. HTTP status, error message. */
     message?: string;
 }
+/**
+ * Per-dimension aesthetic scores from the design self-critique, each on a
+ * 0–10 scale. `overall` is the model's holistic verdict for the rendered
+ * variant (not a strict average of the dimensions). Attached to a
+ * `VariantQaResult` when the design critique runs; absent when the critique
+ * is skipped (no runner wired, render/model unavailable, or non-0→1 session).
+ */
+export interface VariantDesignScores {
+    /** Clarity of visual hierarchy / focal flow. */
+    hierarchy: number;
+    /** Type scale, pairing, rhythm, and legibility. */
+    typography: number;
+    /** Palette cohesion and role discipline. */
+    color: number;
+    /** Spacing rhythm, alignment, and density. */
+    spacing: number;
+    /** Resistance to generic "AI slop" patterns (boilerplate hero cards, etc). */
+    slopResistance: number;
+    /** Holistic 0–10 verdict for the rendered variant. */
+    overall: number;
+}
+/**
+ * Severity of a design-critique finding.
+ *  - `critical`: usability-breaking; hard-fails the variant regardless of score.
+ *  - `major`: serious issue that caps the overall score below the pass bar.
+ *  - `minor`: non-blocking nit surfaced for the agent without gating.
+ */
+export type CritiqueSeverity = 'critical' | 'major' | 'minor';
+/** The task-aware checks a 0→1 variant is judged against beyond aesthetics. */
+export type CritiqueCheckCategory = 'task_fit' | 'source_fidelity' | 'ui_polish' | 'readability' | 'responsive';
+/** Pass/warn/fail status for a single critique check category. */
+export type CritiqueCheckStatus = 'pass' | 'warn' | 'fail';
+export type CritiqueChecks = Record<CritiqueCheckCategory, CritiqueCheckStatus>;
+/**
+ * One severity-coded design-critique issue with concrete evidence (what is
+ * wrong) and a fix (what to change), so a re-leased variant has actionable
+ * direction. Raised either by the deterministic artifact lint or the model.
+ */
+export interface CritiqueFinding {
+    severity: CritiqueSeverity;
+    category: CritiqueCheckCategory;
+    evidence: string;
+    fix: string;
+}
+/** A cap applied to a score because of a blocking/major finding. */
+export interface CritiqueScoreCap {
+    category: CritiqueCheckCategory | 'overall';
+    /** Maximum score the affected target may take while the finding stands. */
+    max: number;
+    reason: string;
+}
 export interface VariantQaResult {
     status: VariantQaStatus;
     issues: VariantQaIssue[];
@@ -1394,6 +2038,20 @@ export interface VariantQaResult {
     summary: string;
     /** Source of the inspected preview (the URL or marker the runner used). */
     checkedSource?: string;
+    /** Per-dimension aesthetic scores from the design self-critique, when it
+     *  ran. Surfaced on the variant chip so the user can see the design score
+     *  alongside the objective health verdict. Optional / back-compatible. */
+    dimensionScores?: VariantDesignScores;
+    /** Short natural-language critique from the design self-critique — the
+     *  notes the agent must address when regenerating a below-bar variant. */
+    designSummary?: string;
+    /** Severity-coded findings from the strict critique gate (lint + model),
+     *  present when the critique ran and surfaced issues. */
+    designFindings?: CritiqueFinding[];
+    /** Per-category pass/warn/fail status from the strict critique gate. */
+    designChecks?: CritiqueChecks;
+    /** Caps applied to the overall design score and why. */
+    designScoreCaps?: CritiqueScoreCap[];
 }
 export declare const targetSchema: z.ZodObject<{
     type: z.ZodEnum<["element", "file", "route"]>;
@@ -1455,10 +2113,294 @@ export declare const proposeVariantsInput: {
     }>>;
     projectContext: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"existing">;
+        /** Absolute project path requested for this existing-project run. Present
+         *  when callers target a nested project inside a larger git worktree. */
+        projectPath: z.ZodOptional<z.ZodString>;
+        /** Optional design context supplied by agents/benchmarks for existing
+         *  project runs with visual references. Surfaced as DesignMD artifacts and
+         *  available to QA gates, but does not trigger a source-plan stage. */
+        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";
+            content: string;
+            label: string;
+        }, {
+            kind: "markdown";
+            content: string;
+            label: 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", "motionBrief"]>;
+                label: z.ZodString;
+                content: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+                content: string;
+                label: string;
+            }, {
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+                content: string;
+                label: 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.ZodEffects<z.ZodObject<{
+                    url: z.ZodOptional<z.ZodString>;
+                    imageRef: z.ZodOptional<z.ZodString>;
+                    role: z.ZodEnum<["design_source", "interaction_reference", "asset_source", "content_reference", "other"]>;
+                    confidence: z.ZodEnum<["low", "medium", "high"]>;
+                    reason: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    reason: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }, {
+                    reason: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }>, {
+                    reason: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }, {
+                    reason: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                sources: {
+                    reason: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }[];
+            }, {
+                sources: {
+                    reason: string;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }[];
+            }>>;
+            designDecision: z.ZodOptional<z.ZodEnum<["let_rivet_choose", "go_custom"]>>;
+        }, "strip", z.ZodTypeAny, {
+            sourceUrls?: string[] | undefined;
+            preserveBrand?: boolean | undefined;
+            sourceArtifacts?: {
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+                content: string;
+                label: 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;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }[];
+            } | undefined;
+            designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+        }, {
+            sourceUrls?: string[] | undefined;
+            preserveBrand?: boolean | undefined;
+            sourceArtifacts?: {
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+                content: string;
+                label: 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;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }[];
+            } | undefined;
+            designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         kind: "existing";
+        projectPath?: string | undefined;
+        designContext?: ({
+            slug: string;
+            kind: "slug";
+        } | {
+            kind: "markdown";
+            content: string;
+            label: string;
+        })[] | undefined;
+        sourceContext?: {
+            sourceUrls?: string[] | undefined;
+            preserveBrand?: boolean | undefined;
+            sourceArtifacts?: {
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+                content: string;
+                label: 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;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }[];
+            } | undefined;
+            designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+        } | undefined;
     }, {
         kind: "existing";
+        projectPath?: string | undefined;
+        designContext?: ({
+            slug: string;
+            kind: "slug";
+        } | {
+            kind: "markdown";
+            content: string;
+            label: string;
+        })[] | undefined;
+        sourceContext?: {
+            sourceUrls?: string[] | undefined;
+            preserveBrand?: boolean | undefined;
+            sourceArtifacts?: {
+                kind: "urlText" | "siteBrief" | "visualBrief" | "screenshotNotes" | "motionBrief";
+                content: string;
+                label: 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;
+                    role: "other" | "design_source" | "interaction_reference" | "asset_source" | "content_reference";
+                    confidence: "low" | "medium" | "high";
+                    url?: string | undefined;
+                    imageRef?: string | undefined;
+                }[];
+            } | undefined;
+            designDecision?: "let_rivet_choose" | "go_custom" | undefined;
+        } | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"fresh">;
         /** Where the generated subproject's files live (e.g.
@@ -1724,7 +2666,6 @@ export declare const proposeVariantsInput: {
         workspacePath: string;
         workspaceRoot: string;
         framework?: "next" | "vite" | "remix" | "astro" | undefined;
-        assetSourceRoot?: string | undefined;
         designContext?: ({
             slug: string;
             kind: "slug";
@@ -1765,6 +2706,7 @@ export declare const proposeVariantsInput: {
             } | undefined;
             designDecision?: "let_rivet_choose" | "go_custom" | undefined;
         } | undefined;
+        assetSourceRoot?: string | undefined;
         executionPlan?: {
             mode: "static_preview" | "vite_app";
             reason: string;
@@ -1782,7 +2724,6 @@ export declare const proposeVariantsInput: {
         workspacePath: string;
         workspaceRoot: string;
         framework?: "next" | "vite" | "remix" | "astro" | undefined;
-        assetSourceRoot?: string | undefined;
         designContext?: ({
             slug: string;
             kind: "slug";
@@ -1823,6 +2764,7 @@ export declare const proposeVariantsInput: {
             } | undefined;
             designDecision?: "let_rivet_choose" | "go_custom" | undefined;
         } | undefined;
+        assetSourceRoot?: string | undefined;
         executionPlan?: {
             mode: "static_preview" | "vite_app";
             reason: string;