rivet-design 0.17.4 → 0.18.0

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

@@ -1,3 +1,4 @@
+import { type VariantReference } from '../types/variant-reference';
 import { z } from 'zod/v3';
 import { ERROR_CODES, type ErrorCode } from './errors';
 export declare const STAGES: readonly ["awaiting_source_plan", "awaiting_briefs", "awaiting_approval", "work_items_ready", "waiting_for_results", "ready", "degraded", "failed", "cancelled"];
@@ -14,11 +15,6 @@ export interface LeaseRecord {
     leaseExpiresAt: number;
     attempt: number;
 }
-/**
- * Minimal descriptor of the element a user selected when commenting/Varying a
- * static_preview variant. Carried into forked work items so the generating
- * agent can locate the element in the inline HTML and scope its change to it.
- */
 export interface StaticPreviewTargetElement {
     tagName?: string;
     className?: string;
@@ -26,20 +22,9 @@ export interface StaticPreviewTargetElement {
     textContent?: string;
     xpath?: string;
 }
-/** The runtime that actually executed a variant's worker: vendor CLI plus the
- *  resolved model/effort labels. Recorded by the executor when the worker
- *  finishes; absent while running and for host-agent-executed work (the
- *  pre-executor degraded mode), where the host agent's own runtime applies.
- *  Surfaced so agents and users can answer "which model built this
- *  direction?" from `variants list`/`get` instead of guessing from fidelity. */
 export interface WorkerRuntimeInfo {
     vendor: string;
-    /** Resolved model label — a concrete id (claude) or `<vendor>-default`
-     *  when the tier deliberately omits a model pin (codex/cursor run on the
-     *  user's own CLI default). */
     model: string;
-    /** Effort/reasoning tier when the vendor has one (claude effort, codex
-     *  reasoning effort). */
     effort?: string;
 }
 export interface WorkItem {
@@ -53,30 +38,12 @@ export interface WorkItem {
     error?: {
         code: ErrorCode | string;
         message: string;
-        /** HTTP status from the worker CLI's API failure (e.g. 401/429), when the
-         *  runtime reported one — preserved so failures stay diagnosable without
-         *  re-parsing the message text. */
         apiErrorStatus?: number;
     };
     lease?: LeaseRecord;
-    /** Set on terminal report by the executor — see {@link WorkerRuntimeInfo}. */
     runtime?: WorkerRuntimeInfo;
     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;
-    /**
-     * User removed this variant from the UI. Removed items are kept in the
-     * session (and persisted to `.rivet/variants/` with status `removed`) but
-     * are excluded from the active snapshot, progress/summary accounting, and
-     * terminal evaluation — i.e. never rendered again. Orthogonal to `status`:
-     * a `succeeded` variant can be removed without losing its result.
-     */
     removed?: boolean;
 }
 export declare const CONTEXT_ASSET_MAX_ITEMS = 12;
@@ -102,11 +69,6 @@ export declare const designContextEntrySchema: z.ZodDiscriminatedUnion<"kind", [
     content: string;
     label: string;
 }>]>;
-/**
- * Role a raw source plays in `design_system` action metadata. Retained because
- * `rivetMetadataSchema` references it; the legacy summary-first
- * `sourceContext`/`sourceIntent` intake shapes that also used it are gone.
- */
 export declare const sourceRoleSchema: z.ZodEnum<["primary", "inspiration", "competitor"]>;
 export declare const rawUserContextInputSchema: z.ZodDiscriminatedUnion<"transport", [z.ZodObject<{
     transport: z.ZodLiteral<"url">;
@@ -132,17 +94,48 @@ export declare const rawUserContextInputSchema: z.ZodDiscriminatedUnion<"transpo
 }, "strip", z.ZodTypeAny, {
     path: string;
     transport: "file_path";
+    mimeType?: string | undefined;
     label?: string | undefined;
     userIntent?: string | undefined;
-    mimeType?: string | undefined;
 }, {
     path: string;
     transport: "file_path";
+    mimeType?: string | undefined;
     label?: string | undefined;
     userIntent?: string | undefined;
-    mimeType?: string | undefined;
 }>, z.ZodObject<{
     transport: z.ZodLiteral<"upload">;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodEffects<z.ZodString, string, string>;
+        reason: z.ZodOptional<z.ZodString>;
+        image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            hash: z.ZodString;
+            mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+        }, "strip", z.ZodTypeAny, {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        }, {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        url: string;
+        title: string;
+        image?: {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        } | undefined;
+        reason?: string | undefined;
+    }, {
+        id: string;
+        url: string;
+        title: string;
+        image?: unknown;
+        reason?: string | undefined;
+    }>, "many">>;
     dataUrl: z.ZodString;
     filename: z.ZodOptional<z.ZodString>;
     label: z.ZodOptional<z.ZodString>;
@@ -152,12 +145,29 @@ export declare const rawUserContextInputSchema: z.ZodDiscriminatedUnion<"transpo
     dataUrl: string;
     label?: string | undefined;
     userIntent?: string | undefined;
+    references?: {
+        id: string;
+        url: string;
+        title: string;
+        image?: {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        } | undefined;
+        reason?: string | undefined;
+    }[] | undefined;
     filename?: string | undefined;
 }, {
     transport: "upload";
     dataUrl: string;
     label?: string | undefined;
     userIntent?: string | undefined;
+    references?: {
+        id: string;
+        url: string;
+        title: string;
+        image?: unknown;
+        reason?: string | undefined;
+    }[] | undefined;
     filename?: string | undefined;
 }>, z.ZodObject<{
     transport: z.ZodLiteral<"directory_path">;
@@ -176,6 +186,37 @@ export declare const rawUserContextInputSchema: z.ZodDiscriminatedUnion<"transpo
     userIntent?: string | undefined;
 }>, z.ZodObject<{
     transport: z.ZodLiteral<"text">;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodEffects<z.ZodString, string, string>;
+        reason: z.ZodOptional<z.ZodString>;
+        image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            hash: z.ZodString;
+            mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+        }, "strip", z.ZodTypeAny, {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        }, {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        url: string;
+        title: string;
+        image?: {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        } | undefined;
+        reason?: string | undefined;
+    }, {
+        id: string;
+        url: string;
+        title: string;
+        image?: unknown;
+        reason?: string | undefined;
+    }>, "many">>;
     content: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
     userIntent: z.ZodOptional<z.ZodString>;
@@ -184,11 +225,28 @@ export declare const rawUserContextInputSchema: z.ZodDiscriminatedUnion<"transpo
     transport: "text";
     label?: string | undefined;
     userIntent?: string | undefined;
+    references?: {
+        id: string;
+        url: string;
+        title: string;
+        image?: {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        } | undefined;
+        reason?: string | undefined;
+    }[] | undefined;
 }, {
     content: string;
     transport: "text";
     label?: string | undefined;
     userIntent?: string | undefined;
+    references?: {
+        id: string;
+        url: string;
+        title: string;
+        image?: unknown;
+        reason?: string | undefined;
+    }[] | undefined;
 }>]>;
 export declare const rawUserContextSourceSchema: z.ZodDiscriminatedUnion<"transport", [z.ZodObject<{
     id: z.ZodString;
@@ -223,6 +281,37 @@ export declare const rawUserContextSourceSchema: z.ZodDiscriminatedUnion<"transp
 }>, z.ZodObject<{
     id: z.ZodString;
     transport: z.ZodLiteral<"file">;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodEffects<z.ZodString, string, string>;
+        reason: z.ZodOptional<z.ZodString>;
+        image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            hash: z.ZodString;
+            mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+        }, "strip", z.ZodTypeAny, {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        }, {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        url: string;
+        title: string;
+        image?: {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        } | undefined;
+        reason?: string | undefined;
+    }, {
+        id: string;
+        url: string;
+        title: string;
+        image?: unknown;
+        reason?: string | undefined;
+    }>, "many">>;
     path: z.ZodString;
     mimeType: z.ZodOptional<z.ZodString>;
     originalFilename: z.ZodOptional<z.ZodString>;
@@ -232,17 +321,34 @@ export declare const rawUserContextSourceSchema: z.ZodDiscriminatedUnion<"transp
     id: string;
     path: string;
     transport: "file";
+    mimeType?: string | undefined;
     label?: string | undefined;
     userIntent?: string | undefined;
-    mimeType?: string | undefined;
+    references?: {
+        id: string;
+        url: string;
+        title: string;
+        image?: {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        } | undefined;
+        reason?: string | undefined;
+    }[] | undefined;
     originalFilename?: string | undefined;
 }, {
     id: string;
     path: string;
     transport: "file";
+    mimeType?: string | undefined;
     label?: string | undefined;
     userIntent?: string | undefined;
-    mimeType?: string | undefined;
+    references?: {
+        id: string;
+        url: string;
+        title: string;
+        image?: unknown;
+        reason?: string | undefined;
+    }[] | undefined;
     originalFilename?: string | undefined;
 }>, z.ZodObject<{
     id: z.ZodString;
@@ -265,6 +371,37 @@ export declare const rawUserContextSourceSchema: z.ZodDiscriminatedUnion<"transp
 }>, z.ZodObject<{
     id: z.ZodString;
     transport: z.ZodLiteral<"text">;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodEffects<z.ZodString, string, string>;
+        reason: z.ZodOptional<z.ZodString>;
+        image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            hash: z.ZodString;
+            mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+        }, "strip", z.ZodTypeAny, {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        }, {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        url: string;
+        title: string;
+        image?: {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        } | undefined;
+        reason?: string | undefined;
+    }, {
+        id: string;
+        url: string;
+        title: string;
+        image?: unknown;
+        reason?: string | undefined;
+    }>, "many">>;
     path: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
     userIntent: z.ZodOptional<z.ZodString>;
@@ -274,12 +411,29 @@ export declare const rawUserContextSourceSchema: z.ZodDiscriminatedUnion<"transp
     transport: "text";
     label?: string | undefined;
     userIntent?: string | undefined;
+    references?: {
+        id: string;
+        url: string;
+        title: string;
+        image?: {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        } | undefined;
+        reason?: string | undefined;
+    }[] | undefined;
 }, {
     id: string;
     path: string;
     transport: "text";
     label?: string | undefined;
     userIntent?: string | undefined;
+    references?: {
+        id: string;
+        url: string;
+        title: string;
+        image?: unknown;
+        reason?: string | undefined;
+    }[] | undefined;
 }>]>;
 export declare const contextAssetInputSchema: z.ZodObject<{
     path: z.ZodString;
@@ -305,16 +459,16 @@ export declare const stagedContextAssetSchema: z.ZodObject<{
     originalFilename: string;
     sizeBytes: number;
     sha256: string;
-    label?: string | undefined;
     mimeType?: string | undefined;
+    label?: string | undefined;
 }, {
     id: string;
     path: string;
     originalFilename: string;
     sizeBytes: number;
     sha256: string;
-    label?: string | undefined;
     mimeType?: string | undefined;
+    label?: string | undefined;
 }>;
 export declare const storedUserContextSourceRecordSchema: z.ZodObject<{
     source: z.ZodDiscriminatedUnion<"transport", [z.ZodObject<{
@@ -350,6 +504,37 @@ export declare const storedUserContextSourceRecordSchema: z.ZodObject<{
     }>, z.ZodObject<{
         id: z.ZodString;
         transport: z.ZodLiteral<"file">;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            url: z.ZodEffects<z.ZodString, string, string>;
+            reason: z.ZodOptional<z.ZodString>;
+            image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                hash: z.ZodString;
+                mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+            }, "strip", z.ZodTypeAny, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }, {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }>, "many">>;
         path: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         originalFilename: z.ZodOptional<z.ZodString>;
@@ -359,17 +544,34 @@ export declare const storedUserContextSourceRecordSchema: z.ZodObject<{
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     }, {
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     }>, z.ZodObject<{
         id: z.ZodString;
@@ -392,6 +594,37 @@ export declare const storedUserContextSourceRecordSchema: z.ZodObject<{
     }>, z.ZodObject<{
         id: z.ZodString;
         transport: z.ZodLiteral<"text">;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            url: z.ZodEffects<z.ZodString, string, string>;
+            reason: z.ZodOptional<z.ZodString>;
+            image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                hash: z.ZodString;
+                mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+            }, "strip", z.ZodTypeAny, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }, {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }>, "many">>;
         path: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
         userIntent: z.ZodOptional<z.ZodString>;
@@ -401,12 +634,29 @@ export declare const storedUserContextSourceRecordSchema: z.ZodObject<{
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
     }, {
         id: string;
         path: string;
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
     }>]>;
     storage: z.ZodOptional<z.ZodObject<{
         sizeBytes: z.ZodOptional<z.ZodNumber>;
@@ -436,9 +686,19 @@ export declare const storedUserContextSourceRecordSchema: z.ZodObject<{
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     } | {
         id: string;
@@ -452,6 +712,16 @@ export declare const storedUserContextSourceRecordSchema: z.ZodObject<{
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
     };
     storage?: {
         originalFilename?: string | undefined;
@@ -473,9 +743,16 @@ export declare const storedUserContextSourceRecordSchema: z.ZodObject<{
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     } | {
         id: string;
@@ -489,6 +766,13 @@ export declare const storedUserContextSourceRecordSchema: z.ZodObject<{
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
     };
     storage?: {
         originalFilename?: string | undefined;
@@ -546,13 +830,6 @@ export declare const rivetMetadataSchema: z.ZodDiscriminatedUnion<"kind", [z.Zod
     kind: z.ZodLiteral<"design_system">;
     data: z.ZodObject<{
         designMarkdown: z.ZodOptional<z.ZodString>;
-        /**
-         * Provenance for the design system: `captured` = derived from rendered
-         * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-         * evidence, gaps filled by inference; `inferred` = no rendered evidence
-         * (static fetch / native inspection only). Keeps DESIGN.md honest about
-         * extracted-vs-guessed values.
-         */
         evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
         sourceFindings: z.ZodArray<z.ZodString, "many">;
         sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -728,13 +1005,6 @@ export declare const variantContextBindingSchema: z.ZodDiscriminatedUnion<"kind"
 }>]>;
 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;
@@ -831,6 +1101,37 @@ export declare const variantContextBundleSchema: z.ZodObject<{
     }>, z.ZodObject<{
         id: z.ZodString;
         transport: z.ZodLiteral<"file">;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            url: z.ZodEffects<z.ZodString, string, string>;
+            reason: z.ZodOptional<z.ZodString>;
+            image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                hash: z.ZodString;
+                mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+            }, "strip", z.ZodTypeAny, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }, {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }>, "many">>;
         path: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         originalFilename: z.ZodOptional<z.ZodString>;
@@ -840,17 +1141,34 @@ export declare const variantContextBundleSchema: z.ZodObject<{
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     }, {
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     }>, z.ZodObject<{
         id: z.ZodString;
@@ -873,6 +1191,37 @@ export declare const variantContextBundleSchema: z.ZodObject<{
     }>, z.ZodObject<{
         id: z.ZodString;
         transport: z.ZodLiteral<"text">;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            url: z.ZodEffects<z.ZodString, string, string>;
+            reason: z.ZodOptional<z.ZodString>;
+            image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                hash: z.ZodString;
+                mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+            }, "strip", z.ZodTypeAny, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }, {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }>, "many">>;
         path: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
         userIntent: z.ZodOptional<z.ZodString>;
@@ -882,12 +1231,29 @@ export declare const variantContextBundleSchema: z.ZodObject<{
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
     }, {
         id: string;
         path: string;
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
     }>]>, "many">;
     rivetActions: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -919,13 +1285,6 @@ export declare const variantContextBundleSchema: z.ZodObject<{
         kind: z.ZodLiteral<"design_system">;
         data: z.ZodObject<{
             designMarkdown: z.ZodOptional<z.ZodString>;
-            /**
-             * Provenance for the design system: `captured` = derived from rendered
-             * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-             * evidence, gaps filled by inference; `inferred` = no rendered evidence
-             * (static fetch / native inspection only). Keeps DESIGN.md honest about
-             * extracted-vs-guessed values.
-             */
             evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
             sourceFindings: z.ZodArray<z.ZodString, "many">;
             sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -1079,16 +1438,16 @@ export declare const variantContextBundleSchema: z.ZodObject<{
         originalFilename: string;
         sizeBytes: number;
         sha256: string;
-        label?: string | undefined;
         mimeType?: string | undefined;
+        label?: string | undefined;
     }, {
         id: string;
         path: string;
         originalFilename: string;
         sizeBytes: number;
         sha256: string;
-        label?: string | undefined;
         mimeType?: string | undefined;
+        label?: string | undefined;
     }>, "many">>;
     bindings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"global">;
@@ -1184,9 +1543,19 @@ export declare const variantContextBundleSchema: z.ZodObject<{
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     } | {
         id: string;
@@ -1200,6 +1569,16 @@ export declare const variantContextBundleSchema: z.ZodObject<{
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
     })[];
     rivetActions: {
         id: string;
@@ -1250,8 +1629,8 @@ export declare const variantContextBundleSchema: z.ZodObject<{
         originalFilename: string;
         sizeBytes: number;
         sha256: string;
-        label?: string | undefined;
         mimeType?: string | undefined;
+        label?: string | undefined;
     }[] | undefined;
     bindings?: ({
         kind: "global";
@@ -1295,9 +1674,16 @@ export declare const variantContextBundleSchema: z.ZodObject<{
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     } | {
         id: string;
@@ -1311,6 +1697,13 @@ export declare const variantContextBundleSchema: z.ZodObject<{
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
     })[];
     rivetActions: {
         id: string;
@@ -1361,8 +1754,8 @@ export declare const variantContextBundleSchema: z.ZodObject<{
         originalFilename: string;
         sizeBytes: number;
         sha256: string;
-        label?: string | undefined;
         mimeType?: string | undefined;
+        label?: string | undefined;
     }[] | undefined;
     bindings?: ({
         kind: "global";
@@ -1391,12 +1784,7 @@ export declare const variantContextBundleSchema: z.ZodObject<{
 }>;
 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;
@@ -1456,6 +1844,37 @@ export declare const projectContextExisting: z.ZodObject<{
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"file">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             originalFilename: z.ZodOptional<z.ZodString>;
@@ -1465,17 +1884,34 @@ export declare const projectContextExisting: z.ZodObject<{
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }, {
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }>, z.ZodObject<{
             id: z.ZodString;
@@ -1498,6 +1934,37 @@ export declare const projectContextExisting: z.ZodObject<{
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"text">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
             userIntent: z.ZodOptional<z.ZodString>;
@@ -1507,12 +1974,29 @@ export declare const projectContextExisting: z.ZodObject<{
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         }, {
             id: string;
             path: string;
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         }>]>, "many">;
         rivetActions: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -1544,13 +2028,6 @@ export declare const projectContextExisting: z.ZodObject<{
             kind: z.ZodLiteral<"design_system">;
             data: z.ZodObject<{
                 designMarkdown: z.ZodOptional<z.ZodString>;
-                /**
-                 * Provenance for the design system: `captured` = derived from rendered
-                 * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-                 * evidence, gaps filled by inference; `inferred` = no rendered evidence
-                 * (static fetch / native inspection only). Keeps DESIGN.md honest about
-                 * extracted-vs-guessed values.
-                 */
                 evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
                 sourceFindings: z.ZodArray<z.ZodString, "many">;
                 sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -1704,16 +2181,16 @@ export declare const projectContextExisting: z.ZodObject<{
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }, {
             id: string;
             path: string;
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }>, "many">>;
         bindings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
             kind: z.ZodLiteral<"global">;
@@ -1809,9 +2286,19 @@ export declare const projectContextExisting: z.ZodObject<{
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -1825,6 +2312,16 @@ export declare const projectContextExisting: z.ZodObject<{
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -1875,8 +2372,8 @@ export declare const projectContextExisting: z.ZodObject<{
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -1920,9 +2417,16 @@ export declare const projectContextExisting: z.ZodObject<{
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -1936,6 +2440,13 @@ export declare const projectContextExisting: z.ZodObject<{
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -1986,8 +2497,8 @@ export declare const projectContextExisting: z.ZodObject<{
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -2043,9 +2554,19 @@ export declare const projectContextExisting: z.ZodObject<{
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -2059,6 +2580,16 @@ export declare const projectContextExisting: z.ZodObject<{
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -2109,8 +2640,8 @@ export declare const projectContextExisting: z.ZodObject<{
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -2166,9 +2697,16 @@ export declare const projectContextExisting: z.ZodObject<{
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -2182,6 +2720,13 @@ export declare const projectContextExisting: z.ZodObject<{
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -2232,8 +2777,8 @@ export declare const projectContextExisting: z.ZodObject<{
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -2263,22 +2808,10 @@ export declare const projectContextExisting: 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
-     *  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;
@@ -2338,6 +2871,37 @@ export declare const projectContextFresh: z.ZodObject<{
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"file">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             originalFilename: z.ZodOptional<z.ZodString>;
@@ -2347,17 +2911,34 @@ export declare const projectContextFresh: z.ZodObject<{
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }, {
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }>, z.ZodObject<{
             id: z.ZodString;
@@ -2380,6 +2961,37 @@ export declare const projectContextFresh: z.ZodObject<{
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"text">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
             userIntent: z.ZodOptional<z.ZodString>;
@@ -2389,12 +3001,29 @@ export declare const projectContextFresh: z.ZodObject<{
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         }, {
             id: string;
             path: string;
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         }>]>, "many">;
         rivetActions: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -2426,13 +3055,6 @@ export declare const projectContextFresh: z.ZodObject<{
             kind: z.ZodLiteral<"design_system">;
             data: z.ZodObject<{
                 designMarkdown: z.ZodOptional<z.ZodString>;
-                /**
-                 * Provenance for the design system: `captured` = derived from rendered
-                 * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-                 * evidence, gaps filled by inference; `inferred` = no rendered evidence
-                 * (static fetch / native inspection only). Keeps DESIGN.md honest about
-                 * extracted-vs-guessed values.
-                 */
                 evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
                 sourceFindings: z.ZodArray<z.ZodString, "many">;
                 sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -2586,16 +3208,16 @@ export declare const projectContextFresh: z.ZodObject<{
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }, {
             id: string;
             path: string;
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }>, "many">>;
         bindings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
             kind: z.ZodLiteral<"global">;
@@ -2691,9 +3313,19 @@ export declare const projectContextFresh: z.ZodObject<{
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -2707,6 +3339,16 @@ export declare const projectContextFresh: z.ZodObject<{
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -2757,8 +3399,8 @@ export declare const projectContextFresh: z.ZodObject<{
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -2802,9 +3444,16 @@ export declare const projectContextFresh: z.ZodObject<{
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -2818,6 +3467,13 @@ export declare const projectContextFresh: z.ZodObject<{
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -2868,8 +3524,8 @@ export declare const projectContextFresh: z.ZodObject<{
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -2896,10 +3552,6 @@ export declare const projectContextFresh: z.ZodObject<{
             userQuestion?: string | undefined;
         } | 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"]>;
@@ -2984,9 +3636,19 @@ export declare const projectContextFresh: z.ZodObject<{
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -3000,6 +3662,16 @@ export declare const projectContextFresh: z.ZodObject<{
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -3050,8 +3722,8 @@ export declare const projectContextFresh: z.ZodObject<{
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -3122,9 +3794,16 @@ export declare const projectContextFresh: z.ZodObject<{
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -3138,6 +3817,13 @@ export declare const projectContextFresh: z.ZodObject<{
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -3188,8 +3874,8 @@ export declare const projectContextFresh: z.ZodObject<{
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -3221,12 +3907,7 @@ export declare const projectContextFresh: z.ZodObject<{
 }>;
 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;
@@ -3286,6 +3967,37 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"file">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             originalFilename: z.ZodOptional<z.ZodString>;
@@ -3295,17 +4007,34 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }, {
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }>, z.ZodObject<{
             id: z.ZodString;
@@ -3328,6 +4057,37 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"text">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
             userIntent: z.ZodOptional<z.ZodString>;
@@ -3337,12 +4097,29 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         }, {
             id: string;
             path: string;
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         }>]>, "many">;
         rivetActions: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -3374,13 +4151,6 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             kind: z.ZodLiteral<"design_system">;
             data: z.ZodObject<{
                 designMarkdown: z.ZodOptional<z.ZodString>;
-                /**
-                 * Provenance for the design system: `captured` = derived from rendered
-                 * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-                 * evidence, gaps filled by inference; `inferred` = no rendered evidence
-                 * (static fetch / native inspection only). Keeps DESIGN.md honest about
-                 * extracted-vs-guessed values.
-                 */
                 evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
                 sourceFindings: z.ZodArray<z.ZodString, "many">;
                 sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -3534,16 +4304,16 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }, {
             id: string;
             path: string;
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }>, "many">>;
         bindings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
             kind: z.ZodLiteral<"global">;
@@ -3639,9 +4409,19 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -3655,6 +4435,16 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -3705,8 +4495,8 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -3750,9 +4540,16 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -3766,6 +4563,13 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -3816,8 +4620,8 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -3873,9 +4677,19 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -3889,6 +4703,16 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -3939,8 +4763,8 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -3996,9 +4820,16 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -4012,6 +4843,13 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -4062,8 +4900,8 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -4092,22 +4930,10 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
     } | 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;
@@ -4167,6 +4993,37 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"file">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             originalFilename: z.ZodOptional<z.ZodString>;
@@ -4176,17 +5033,34 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }, {
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }>, z.ZodObject<{
             id: z.ZodString;
@@ -4209,6 +5083,37 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"text">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
             userIntent: z.ZodOptional<z.ZodString>;
@@ -4218,12 +5123,29 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         }, {
             id: string;
             path: string;
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         }>]>, "many">;
         rivetActions: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -4255,13 +5177,6 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             kind: z.ZodLiteral<"design_system">;
             data: z.ZodObject<{
                 designMarkdown: z.ZodOptional<z.ZodString>;
-                /**
-                 * Provenance for the design system: `captured` = derived from rendered
-                 * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-                 * evidence, gaps filled by inference; `inferred` = no rendered evidence
-                 * (static fetch / native inspection only). Keeps DESIGN.md honest about
-                 * extracted-vs-guessed values.
-                 */
                 evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
                 sourceFindings: z.ZodArray<z.ZodString, "many">;
                 sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -4415,16 +5330,16 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }, {
             id: string;
             path: string;
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }>, "many">>;
         bindings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
             kind: z.ZodLiteral<"global">;
@@ -4520,9 +5435,19 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -4536,6 +5461,16 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -4586,8 +5521,8 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -4631,9 +5566,16 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -4647,6 +5589,13 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -4697,8 +5646,8 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -4725,10 +5674,6 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             userQuestion?: string | undefined;
         } | 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"]>;
@@ -4813,9 +5758,19 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -4829,6 +5784,16 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -4879,8 +5844,8 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -4951,9 +5916,16 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -4967,6 +5939,13 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -5017,8 +5996,8 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -5050,12 +6029,7 @@ export declare const projectContextSchema: z.ZodDiscriminatedUnion<"kind", [z.Zo
 }>]>;
 export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<Omit<{
     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;
@@ -5115,6 +6089,37 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"file">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             originalFilename: z.ZodOptional<z.ZodString>;
@@ -5124,17 +6129,34 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }, {
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }>, z.ZodObject<{
             id: z.ZodString;
@@ -5157,6 +6179,37 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"text">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
             userIntent: z.ZodOptional<z.ZodString>;
@@ -5166,12 +6219,29 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         }, {
             id: string;
             path: string;
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         }>]>, "many">;
         rivetActions: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -5203,13 +6273,6 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             kind: z.ZodLiteral<"design_system">;
             data: z.ZodObject<{
                 designMarkdown: z.ZodOptional<z.ZodString>;
-                /**
-                 * Provenance for the design system: `captured` = derived from rendered
-                 * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-                 * evidence, gaps filled by inference; `inferred` = no rendered evidence
-                 * (static fetch / native inspection only). Keeps DESIGN.md honest about
-                 * extracted-vs-guessed values.
-                 */
                 evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
                 sourceFindings: z.ZodArray<z.ZodString, "many">;
                 sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -5363,16 +6426,16 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }, {
             id: string;
             path: string;
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }>, "many">>;
         bindings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
             kind: z.ZodLiteral<"global">;
@@ -5468,9 +6531,19 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -5484,6 +6557,16 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -5534,8 +6617,8 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -5579,9 +6662,16 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -5595,6 +6685,13 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -5645,8 +6742,8 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -5697,22 +6794,10 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
     })[] | undefined;
 }>, z.ZodObject<Omit<{
     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;
@@ -5772,6 +6857,37 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"file">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             originalFilename: z.ZodOptional<z.ZodString>;
@@ -5781,17 +6897,34 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }, {
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         }>, z.ZodObject<{
             id: z.ZodString;
@@ -5814,6 +6947,37 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
         }>, z.ZodObject<{
             id: z.ZodString;
             transport: z.ZodLiteral<"text">;
+            references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                url: z.ZodEffects<z.ZodString, string, string>;
+                reason: z.ZodOptional<z.ZodString>;
+                image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                    hash: z.ZodString;
+                    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                }, "strip", z.ZodTypeAny, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }, {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }, {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }>, "many">>;
             path: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
             userIntent: z.ZodOptional<z.ZodString>;
@@ -5823,12 +6987,29 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         }, {
             id: string;
             path: string;
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         }>]>, "many">;
         rivetActions: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -5860,13 +7041,6 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             kind: z.ZodLiteral<"design_system">;
             data: z.ZodObject<{
                 designMarkdown: z.ZodOptional<z.ZodString>;
-                /**
-                 * Provenance for the design system: `captured` = derived from rendered
-                 * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-                 * evidence, gaps filled by inference; `inferred` = no rendered evidence
-                 * (static fetch / native inspection only). Keeps DESIGN.md honest about
-                 * extracted-vs-guessed values.
-                 */
                 evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
                 sourceFindings: z.ZodArray<z.ZodString, "many">;
                 sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -6020,16 +7194,16 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }, {
             id: string;
             path: string;
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }>, "many">>;
         bindings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
             kind: z.ZodLiteral<"global">;
@@ -6125,9 +7299,19 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -6141,6 +7325,16 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: {
+                    hash: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                } | undefined;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -6191,8 +7385,8 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -6236,9 +7430,16 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             id: string;
             path: string;
             transport: "file";
+            mimeType?: string | undefined;
             label?: string | undefined;
             userIntent?: string | undefined;
-            mimeType?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
             originalFilename?: string | undefined;
         } | {
             id: string;
@@ -6252,6 +7453,13 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             transport: "text";
             label?: string | undefined;
             userIntent?: string | undefined;
+            references?: {
+                id: string;
+                url: string;
+                title: string;
+                image?: unknown;
+                reason?: string | undefined;
+            }[] | undefined;
         })[];
         rivetActions: {
             id: string;
@@ -6302,8 +7510,8 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             originalFilename: string;
             sizeBytes: number;
             sha256: string;
-            label?: string | undefined;
             mimeType?: string | undefined;
+            label?: string | undefined;
         }[] | undefined;
         bindings?: ({
             kind: "global";
@@ -6330,10 +7538,6 @@ export declare const projectContextInputSchema: z.ZodDiscriminatedUnion<"kind",
             userQuestion?: string | undefined;
         } | 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"]>;
@@ -6487,8 +7691,6 @@ export type ActiveProjectContext = {
         sourceCount: number;
         isSourceGrounded: boolean;
     };
-    /** Compact summary of the agent's execution plan, suitable for chip /
-     *  artifact rendering. The full plan stays on the project context. */
     executionPlan?: {
         mode: ExecutionMode;
         confidence: ExecutionConfidence;
@@ -6512,30 +7714,12 @@ export interface ActiveVariantSnapshot {
     briefId: string;
     label: string;
     status: WorkItemStatus;
-    /** TRUE work-item kind — the authoritative routing discriminator. An
-     *  existing-project `code_gen` variant materialized as a static preview
-     *  DISPLAYS as `preview.kind: 'static_artifact'` but must Vary/apply via
-     *  the worktree path; clients key routing off this field, never off the
-     *  display preview kind. */
     workItemKind?: 'code_gen' | 'static_preview';
-    /** 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;
-    /** Short localized 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;
-    /** Correlation id of the UI request that produced this variant (or drives its
-     *  in-place refinement) — the originating change batch's agentRunId/traceId.
-     *  Lets the UI map its optimistic placeholders to the real variant cards. */
     requestId?: 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;
-    /** Source history identity for a past variant adopted into the active session.
-     *  Lets the UI collapse the matching history row into this live row. */
+    references?: VariantReference[];
     adoptedSource?: {
         sessionId: string;
         variantId: string;
@@ -6543,25 +7727,10 @@ export interface ActiveVariantSnapshot {
     design?: VariantDesignSource;
     preview?: VariantPreviewSource;
     port?: number;
-    /** Number of files the variant's captured diff touches (existing-project
-     *  code_gen). Retained in the snapshot for API consumers and commit/history
-     *  metadata. */
     changedFilesCount?: number;
     errorCode?: string;
-    /** Human-readable failure detail for a failed variant (worker exit code +
-     *  stderr/result tail). Bounded at source by the executor's capture caps;
-     *  present only alongside `errorCode`. */
     errorMessage?: string;
-    /** The runtime that executed this variant's worker (vendor/model/effort).
-     *  Present once the executor reports completion; absent while running and
-     *  for host-agent-executed work. */
     runtime?: WorkerRuntimeInfo;
-    /**
-     * Set when a *succeeded* variant has no live preview because its preview dev
-     * server failed to start or was reclaimed after the active-session idle
-     * timeout. Idle previews restart on selection; failed dev-server previews
-     * require an explicit retry without regenerating the direction.
-     */
     previewUnavailable?: {
         reason: 'spawn_error' | 'exited' | 'timeout' | 'compile_error' | 'dependency_install_failed' | 'missing_dev_script' | 'missing_static_entry' | 'idle_timeout' | 'unknown';
         portInUse?: boolean;
@@ -6571,16 +7740,8 @@ export interface ActiveVariantSnapshot {
         workItemId: string;
         status: WorkItemStatus;
         errorCode?: string;
-        /** Failure detail for a failed refinement — mirrors the top-level
-         *  `errorMessage`. */
         errorMessage?: string;
     };
-    /**
-     * Post-generation output-integrity verdict. Present once the orchestrator
-     * has checked the variant's artifact structure. Surfaced on the chip so the
-     * user can see why a variant is not committable. `not_run` indicates the
-     * check does not apply to this variant kind.
-     */
     qa?: VariantQaResult;
 }
 export type VariantAssignedWorkspace = {
@@ -6602,9 +7763,6 @@ export type VariantExecutionMode = (typeof VARIANT_EXECUTION_MODES)[number];
 export type VariantWorkerDirection = {
     label: string;
     brief: string;
-    /** Optional host-authored implementation notes for this direction —
-     *  richer than the UI-facing label/body (design tokens, motion specs,
-     *  constraints). Delivered verbatim to the worker briefing. */
     notes?: string;
 };
 interface HostVariantWorkItemBase {
@@ -6613,18 +7771,10 @@ interface HostVariantWorkItemBase {
     kind: WorkItemKind;
     status: WorkItemStatus;
     leaseId: string;
-    /** Which party holds the lease (e.g. 'rivet-host-agent', 'rivet-executor').
-     *  Hosts must never implement items the executor owns. */
     leaseOwner?: string;
     attempt: number;
     leaseExpiresAt: number;
 }
-/**
- * User-selected design fidelity for a variants run. Maps to the worker tier
- * that implements each direction (see `hosts/workerDefaults.ts`): `low` is
- * fast sketch-grade workers, `high` is frontier-model authorship that can
- * take a few minutes. Absent means the server default (`high`).
- */
 export type WorkerFidelity = 'low' | 'medium' | 'high';
 export declare const isWorkerFidelity: (value: unknown) => value is WorkerFidelity;
 export interface WorkspaceContextAsset {
@@ -6640,7 +7790,6 @@ export interface HostVariantImplementationWorkItemSnapshot extends HostVariantWo
     workspace: VariantAssignedWorkspace;
     mode: VariantExecutionMode;
     direction: VariantWorkerDirection;
-    /** User-selected design fidelity for this run (worker tier selector). */
     fidelity?: WorkerFidelity;
     sourceDirection?: VariantWorkerDirection;
     relevantFiles?: string[];
@@ -6648,16 +7797,11 @@ export interface HostVariantImplementationWorkItemSnapshot extends HostVariantWo
     target?: Target;
     targetElement?: StaticPreviewTargetElement;
     contextBundlePath?: string;
-    /** User-provided reference files copied into the context bundle (images,
-     *  design sources). Workers should Read these before implementing — they
-     *  are the primary visual signal, richer than any prose in the brief. */
     contextFiles?: Array<{
         path: string;
         label?: string;
     }>;
-    /** Caller-supplied files already copied into this work item's workspace. */
     contextAssets?: WorkspaceContextAsset[];
-    /** Structural output problem the worker must repair on its single retry. */
     qaRetry?: {
         summary: string;
     };
@@ -6669,24 +7813,11 @@ export interface HostVariantPlanningWorkItemSnapshot extends HostVariantWorkItem
     outputSchema: unknown;
 }
 export type HostVariantWorkItemSnapshot = HostVariantImplementationWorkItemSnapshot | HostVariantPlanningWorkItemSnapshot;
-/**
- * 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;
@@ -6703,23 +7834,16 @@ export interface VariantSessionArtifact {
     warnings?: string[];
 }
 export type VariantQaStatus = 'passed' | 'failed' | 'not_run';
-/**
- * Categorical result from checking Rivet-owned output integrity.
- */
 export type VariantQaIssueKind = 'asset_load_failed' | 'console_error' | 'preview_unavailable' | 'output_integrity' | 'verification_unavailable';
 export interface VariantQaIssue {
     kind: VariantQaIssueKind;
-    /** Artifact reference or diagnostic source location for this issue. */
     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<{
@@ -6738,10 +7862,6 @@ export declare const briefSchema: z.ZodObject<{
     label: z.ZodString;
     body: z.ZodString;
     notes: z.ZodOptional<z.ZodString>;
-    /**
-     * Optional per-brief visual reference URL. Uses the same synchronous
-     * network-target guard as inspiration URLs before downstream agents fetch it.
-     */
     visualReferenceUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
     label: string;
@@ -6758,6 +7878,37 @@ export declare const briefSchema: z.ZodObject<{
 }>;
 export type Brief = z.infer<typeof briefSchema>;
 export declare const variantWorkItemContextSchema: z.ZodObject<{
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodEffects<z.ZodString, string, string>;
+        reason: z.ZodOptional<z.ZodString>;
+        image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            hash: z.ZodString;
+            mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+        }, "strip", z.ZodTypeAny, {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        }, {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        url: string;
+        title: string;
+        image?: {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        } | undefined;
+        reason?: string | undefined;
+    }, {
+        id: string;
+        url: string;
+        title: string;
+        image?: unknown;
+        reason?: string | undefined;
+    }>, "many">>;
     contextBundlePath: z.ZodString;
     userContext: z.ZodArray<z.ZodDiscriminatedUnion<"transport", [z.ZodObject<{
         id: z.ZodString;
@@ -6792,6 +7943,37 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
     }>, z.ZodObject<{
         id: z.ZodString;
         transport: z.ZodLiteral<"file">;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            url: z.ZodEffects<z.ZodString, string, string>;
+            reason: z.ZodOptional<z.ZodString>;
+            image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                hash: z.ZodString;
+                mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+            }, "strip", z.ZodTypeAny, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }, {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }>, "many">>;
         path: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         originalFilename: z.ZodOptional<z.ZodString>;
@@ -6801,17 +7983,34 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     }, {
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     }>, z.ZodObject<{
         id: z.ZodString;
@@ -6834,6 +8033,37 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
     }>, z.ZodObject<{
         id: z.ZodString;
         transport: z.ZodLiteral<"text">;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            url: z.ZodEffects<z.ZodString, string, string>;
+            reason: z.ZodOptional<z.ZodString>;
+            image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                hash: z.ZodString;
+                mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+            }, "strip", z.ZodTypeAny, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }, {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }>, "many">>;
         path: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
         userIntent: z.ZodOptional<z.ZodString>;
@@ -6843,12 +8073,29 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
     }, {
         id: string;
         path: string;
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
     }>]>, "many">;
     rivetMetadata: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         id: z.ZodString;
@@ -6861,13 +8108,6 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
         kind: z.ZodLiteral<"design_system">;
         data: z.ZodObject<{
             designMarkdown: z.ZodOptional<z.ZodString>;
-            /**
-             * Provenance for the design system: `captured` = derived from rendered
-             * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-             * evidence, gaps filled by inference; `inferred` = no rendered evidence
-             * (static fetch / native inspection only). Keeps DESIGN.md honest about
-             * extracted-vs-guessed values.
-             */
             evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
             sourceFindings: z.ZodArray<z.ZodString, "many">;
             sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -7021,26 +8261,22 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
         originalFilename: string;
         sizeBytes: number;
         sha256: string;
-        label?: string | undefined;
         mimeType?: string | undefined;
+        label?: string | undefined;
     }, {
         id: string;
         path: string;
         originalFilename: string;
         sizeBytes: number;
         sha256: string;
-        label?: string | undefined;
         mimeType?: string | undefined;
+        label?: string | undefined;
     }>, "many">>;
     brief: z.ZodObject<{
         briefId: z.ZodString;
         label: z.ZodString;
         body: z.ZodString;
         notes: z.ZodOptional<z.ZodString>;
-        /**
-         * Optional per-brief visual reference URL. Uses the same synchronous
-         * network-target guard as inspiration URLs before downstream agents fetch it.
-         */
         visualReferenceUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     }, "strip", z.ZodTypeAny, {
         label: string;
@@ -7079,9 +8315,19 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     } | {
         id: string;
@@ -7095,6 +8341,16 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
     })[];
     rivetMetadata: ({
         id: string;
@@ -7132,14 +8388,24 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
         actionId?: string | undefined;
         warnings?: string[] | undefined;
     })[];
+    references?: {
+        id: string;
+        url: string;
+        title: string;
+        image?: {
+            hash: string;
+            mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+        } | undefined;
+        reason?: string | undefined;
+    }[] | undefined;
     contextAssets?: {
         id: string;
         path: string;
         originalFilename: string;
         sizeBytes: number;
         sha256: string;
-        label?: string | undefined;
         mimeType?: string | undefined;
+        label?: string | undefined;
     }[] | undefined;
     executionMode?: "static_preview" | "vite_app" | undefined;
 }, {
@@ -7165,9 +8431,16 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
         id: string;
         path: string;
         transport: "file";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
         originalFilename?: string | undefined;
     } | {
         id: string;
@@ -7181,6 +8454,13 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
     })[];
     rivetMetadata: ({
         id: string;
@@ -7218,29 +8498,28 @@ export declare const variantWorkItemContextSchema: z.ZodObject<{
         actionId?: string | undefined;
         warnings?: string[] | undefined;
     })[];
+    references?: {
+        id: string;
+        url: string;
+        title: string;
+        image?: unknown;
+        reason?: string | undefined;
+    }[] | undefined;
     contextAssets?: {
         id: string;
         path: string;
         originalFilename: string;
         sizeBytes: number;
         sha256: string;
-        label?: string | undefined;
         mimeType?: string | undefined;
+        label?: string | undefined;
     }[] | undefined;
     executionMode?: "static_preview" | "vite_app" | undefined;
 }>;
 export type VariantWorkItemContext = z.infer<typeof variantWorkItemContextSchema>;
-/**
- * Inclusive bounds for the number of variants a single propose_variants run
- * may produce. Exported as named constants so every variant-request intake
- * path consumes the same source of truth.
- */
 export declare const VARIANT_COUNT_MIN = 1;
 export declare const VARIANT_COUNT_MAX = 12;
-/** Configurable via RIVET_DEFAULT_VARIANT_COUNT env var. Clamped to [MIN, MAX]. */
 export declare const DEFAULT_VARIANT_COUNT: number;
-/** Optional agent-supplied label for the *run's* intent, shared by every
- *  variant. Keep it to the prompt's core change, not an evocative name. */
 export declare const runLabelSchema: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 export declare const proposeVariantsInput: {
     sessionId: z.ZodOptional<z.ZodString>;
@@ -7259,12 +8538,7 @@ export declare const proposeVariantsInput: {
     }>>;
     projectContext: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<Omit<{
         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;
@@ -7324,6 +8598,37 @@ export declare const proposeVariantsInput: {
             }>, z.ZodObject<{
                 id: z.ZodString;
                 transport: z.ZodLiteral<"file">;
+                references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    title: z.ZodString;
+                    url: z.ZodEffects<z.ZodString, string, string>;
+                    reason: z.ZodOptional<z.ZodString>;
+                    image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                        hash: z.ZodString;
+                        mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                    }, "strip", z.ZodTypeAny, {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    }, {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    }>>>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }, {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }>, "many">>;
                 path: z.ZodString;
                 mimeType: z.ZodOptional<z.ZodString>;
                 originalFilename: z.ZodOptional<z.ZodString>;
@@ -7333,17 +8638,34 @@ export declare const proposeVariantsInput: {
                 id: string;
                 path: string;
                 transport: "file";
+                mimeType?: string | undefined;
                 label?: string | undefined;
                 userIntent?: string | undefined;
-                mimeType?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }[] | undefined;
                 originalFilename?: string | undefined;
             }, {
                 id: string;
                 path: string;
                 transport: "file";
+                mimeType?: string | undefined;
                 label?: string | undefined;
                 userIntent?: string | undefined;
-                mimeType?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }[] | undefined;
                 originalFilename?: string | undefined;
             }>, z.ZodObject<{
                 id: z.ZodString;
@@ -7366,6 +8688,37 @@ export declare const proposeVariantsInput: {
             }>, z.ZodObject<{
                 id: z.ZodString;
                 transport: z.ZodLiteral<"text">;
+                references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    title: z.ZodString;
+                    url: z.ZodEffects<z.ZodString, string, string>;
+                    reason: z.ZodOptional<z.ZodString>;
+                    image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                        hash: z.ZodString;
+                        mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                    }, "strip", z.ZodTypeAny, {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    }, {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    }>>>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }, {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }>, "many">>;
                 path: z.ZodString;
                 label: z.ZodOptional<z.ZodString>;
                 userIntent: z.ZodOptional<z.ZodString>;
@@ -7375,12 +8728,29 @@ export declare const proposeVariantsInput: {
                 transport: "text";
                 label?: string | undefined;
                 userIntent?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }[] | undefined;
             }, {
                 id: string;
                 path: string;
                 transport: "text";
                 label?: string | undefined;
                 userIntent?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }[] | undefined;
             }>]>, "many">;
             rivetActions: z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
@@ -7412,13 +8782,6 @@ export declare const proposeVariantsInput: {
                 kind: z.ZodLiteral<"design_system">;
                 data: z.ZodObject<{
                     designMarkdown: z.ZodOptional<z.ZodString>;
-                    /**
-                     * Provenance for the design system: `captured` = derived from rendered
-                     * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-                     * evidence, gaps filled by inference; `inferred` = no rendered evidence
-                     * (static fetch / native inspection only). Keeps DESIGN.md honest about
-                     * extracted-vs-guessed values.
-                     */
                     evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
                     sourceFindings: z.ZodArray<z.ZodString, "many">;
                     sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -7572,16 +8935,16 @@ export declare const proposeVariantsInput: {
                 originalFilename: string;
                 sizeBytes: number;
                 sha256: string;
-                label?: string | undefined;
                 mimeType?: string | undefined;
+                label?: string | undefined;
             }, {
                 id: string;
                 path: string;
                 originalFilename: string;
                 sizeBytes: number;
                 sha256: string;
-                label?: string | undefined;
                 mimeType?: string | undefined;
+                label?: string | undefined;
             }>, "many">>;
             bindings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
                 kind: z.ZodLiteral<"global">;
@@ -7677,9 +9040,19 @@ export declare const proposeVariantsInput: {
                 id: string;
                 path: string;
                 transport: "file";
+                mimeType?: string | undefined;
                 label?: string | undefined;
                 userIntent?: string | undefined;
-                mimeType?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }[] | undefined;
                 originalFilename?: string | undefined;
             } | {
                 id: string;
@@ -7693,6 +9066,16 @@ export declare const proposeVariantsInput: {
                 transport: "text";
                 label?: string | undefined;
                 userIntent?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }[] | undefined;
             })[];
             rivetActions: {
                 id: string;
@@ -7743,8 +9126,8 @@ export declare const proposeVariantsInput: {
                 originalFilename: string;
                 sizeBytes: number;
                 sha256: string;
-                label?: string | undefined;
                 mimeType?: string | undefined;
+                label?: string | undefined;
             }[] | undefined;
             bindings?: ({
                 kind: "global";
@@ -7788,9 +9171,16 @@ export declare const proposeVariantsInput: {
                 id: string;
                 path: string;
                 transport: "file";
+                mimeType?: string | undefined;
                 label?: string | undefined;
                 userIntent?: string | undefined;
-                mimeType?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }[] | undefined;
                 originalFilename?: string | undefined;
             } | {
                 id: string;
@@ -7804,6 +9194,13 @@ export declare const proposeVariantsInput: {
                 transport: "text";
                 label?: string | undefined;
                 userIntent?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }[] | undefined;
             })[];
             rivetActions: {
                 id: string;
@@ -7854,8 +9251,8 @@ export declare const proposeVariantsInput: {
                 originalFilename: string;
                 sizeBytes: number;
                 sha256: string;
-                label?: string | undefined;
                 mimeType?: string | undefined;
+                label?: string | undefined;
             }[] | undefined;
             bindings?: ({
                 kind: "global";
@@ -7906,22 +9303,10 @@ export declare const proposeVariantsInput: {
         })[] | undefined;
     }>, z.ZodObject<Omit<{
         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;
@@ -7981,6 +9366,37 @@ export declare const proposeVariantsInput: {
             }>, z.ZodObject<{
                 id: z.ZodString;
                 transport: z.ZodLiteral<"file">;
+                references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    title: z.ZodString;
+                    url: z.ZodEffects<z.ZodString, string, string>;
+                    reason: z.ZodOptional<z.ZodString>;
+                    image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                        hash: z.ZodString;
+                        mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                    }, "strip", z.ZodTypeAny, {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    }, {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    }>>>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }, {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }>, "many">>;
                 path: z.ZodString;
                 mimeType: z.ZodOptional<z.ZodString>;
                 originalFilename: z.ZodOptional<z.ZodString>;
@@ -7990,17 +9406,34 @@ export declare const proposeVariantsInput: {
                 id: string;
                 path: string;
                 transport: "file";
+                mimeType?: string | undefined;
                 label?: string | undefined;
                 userIntent?: string | undefined;
-                mimeType?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }[] | undefined;
                 originalFilename?: string | undefined;
             }, {
                 id: string;
                 path: string;
                 transport: "file";
+                mimeType?: string | undefined;
                 label?: string | undefined;
                 userIntent?: string | undefined;
-                mimeType?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }[] | undefined;
                 originalFilename?: string | undefined;
             }>, z.ZodObject<{
                 id: z.ZodString;
@@ -8023,6 +9456,37 @@ export declare const proposeVariantsInput: {
             }>, z.ZodObject<{
                 id: z.ZodString;
                 transport: z.ZodLiteral<"text">;
+                references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    title: z.ZodString;
+                    url: z.ZodEffects<z.ZodString, string, string>;
+                    reason: z.ZodOptional<z.ZodString>;
+                    image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                        hash: z.ZodString;
+                        mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+                    }, "strip", z.ZodTypeAny, {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    }, {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    }>>>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }, {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }>, "many">>;
                 path: z.ZodString;
                 label: z.ZodOptional<z.ZodString>;
                 userIntent: z.ZodOptional<z.ZodString>;
@@ -8032,12 +9496,29 @@ export declare const proposeVariantsInput: {
                 transport: "text";
                 label?: string | undefined;
                 userIntent?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }[] | undefined;
             }, {
                 id: string;
                 path: string;
                 transport: "text";
                 label?: string | undefined;
                 userIntent?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }[] | undefined;
             }>]>, "many">;
             rivetActions: z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
@@ -8069,13 +9550,6 @@ export declare const proposeVariantsInput: {
                 kind: z.ZodLiteral<"design_system">;
                 data: z.ZodObject<{
                     designMarkdown: z.ZodOptional<z.ZodString>;
-                    /**
-                     * Provenance for the design system: `captured` = derived from rendered
-                     * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-                     * evidence, gaps filled by inference; `inferred` = no rendered evidence
-                     * (static fetch / native inspection only). Keeps DESIGN.md honest about
-                     * extracted-vs-guessed values.
-                     */
                     evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
                     sourceFindings: z.ZodArray<z.ZodString, "many">;
                     sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -8229,16 +9703,16 @@ export declare const proposeVariantsInput: {
                 originalFilename: string;
                 sizeBytes: number;
                 sha256: string;
-                label?: string | undefined;
                 mimeType?: string | undefined;
+                label?: string | undefined;
             }, {
                 id: string;
                 path: string;
                 originalFilename: string;
                 sizeBytes: number;
                 sha256: string;
-                label?: string | undefined;
                 mimeType?: string | undefined;
+                label?: string | undefined;
             }>, "many">>;
             bindings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
                 kind: z.ZodLiteral<"global">;
@@ -8334,9 +9808,19 @@ export declare const proposeVariantsInput: {
                 id: string;
                 path: string;
                 transport: "file";
+                mimeType?: string | undefined;
                 label?: string | undefined;
                 userIntent?: string | undefined;
-                mimeType?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }[] | undefined;
                 originalFilename?: string | undefined;
             } | {
                 id: string;
@@ -8350,6 +9834,16 @@ export declare const proposeVariantsInput: {
                 transport: "text";
                 label?: string | undefined;
                 userIntent?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: {
+                        hash: string;
+                        mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+                    } | undefined;
+                    reason?: string | undefined;
+                }[] | undefined;
             })[];
             rivetActions: {
                 id: string;
@@ -8400,8 +9894,8 @@ export declare const proposeVariantsInput: {
                 originalFilename: string;
                 sizeBytes: number;
                 sha256: string;
-                label?: string | undefined;
                 mimeType?: string | undefined;
+                label?: string | undefined;
             }[] | undefined;
             bindings?: ({
                 kind: "global";
@@ -8445,9 +9939,16 @@ export declare const proposeVariantsInput: {
                 id: string;
                 path: string;
                 transport: "file";
+                mimeType?: string | undefined;
                 label?: string | undefined;
                 userIntent?: string | undefined;
-                mimeType?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }[] | undefined;
                 originalFilename?: string | undefined;
             } | {
                 id: string;
@@ -8461,6 +9962,13 @@ export declare const proposeVariantsInput: {
                 transport: "text";
                 label?: string | undefined;
                 userIntent?: string | undefined;
+                references?: {
+                    id: string;
+                    url: string;
+                    title: string;
+                    image?: unknown;
+                    reason?: string | undefined;
+                }[] | undefined;
             })[];
             rivetActions: {
                 id: string;
@@ -8511,8 +10019,8 @@ export declare const proposeVariantsInput: {
                 originalFilename: string;
                 sizeBytes: number;
                 sha256: string;
-                label?: string | undefined;
                 mimeType?: string | undefined;
+                label?: string | undefined;
             }[] | undefined;
             bindings?: ({
                 kind: "global";
@@ -8539,10 +10047,6 @@ export declare const proposeVariantsInput: {
                 userQuestion?: string | undefined;
             } | 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"]>;
@@ -8659,10 +10163,6 @@ export declare const reportVariantBriefsInput: {
         label: z.ZodString;
         body: z.ZodString;
         notes: z.ZodOptional<z.ZodString>;
-        /**
-         * Optional per-brief visual reference URL. Uses the same synchronous
-         * network-target guard as inspiration URLs before downstream agents fetch it.
-         */
         visualReferenceUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     }, "strip", z.ZodTypeAny, {
         label: string;
@@ -8712,17 +10212,6 @@ export declare const reportVariantBriefsInput: {
         metadataIds?: string[] | undefined;
     }>]>, "many">>;
 };
-/**
- * Canonical planning artifact reported by the agent in a single tool call.
- * The agent inspects raw `userContext` natively, selects Rivet actions from
- * `input.availableActions`, and reports the additive metadata those actions
- * produce plus the static_preview vs vite_app execution decision. `actions`
- * and `metadata` are required (each reported action must produce its matching
- * metadata kind); `bindings` is optional and scopes context per variant slot.
- * The legacy summary-first fields (`sourceIntent`, `sourceContext`,
- * `designContexts`) are intentionally absent — derived guidance now comes
- * from action metadata.
- */
 export declare const sourcePlanArtifactSchema: z.ZodObject<{
     actions: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -8754,13 +10243,6 @@ export declare const sourcePlanArtifactSchema: z.ZodObject<{
         kind: z.ZodLiteral<"design_system">;
         data: z.ZodObject<{
             designMarkdown: z.ZodOptional<z.ZodString>;
-            /**
-             * Provenance for the design system: `captured` = derived from rendered
-             * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-             * evidence, gaps filled by inference; `inferred` = no rendered evidence
-             * (static fetch / native inspection only). Keeps DESIGN.md honest about
-             * extracted-vs-guessed values.
-             */
             evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
             sourceFindings: z.ZodArray<z.ZodString, "many">;
             sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -9150,13 +10632,6 @@ export declare const reportSourcePlanInput: {
             kind: z.ZodLiteral<"design_system">;
             data: z.ZodObject<{
                 designMarkdown: z.ZodOptional<z.ZodString>;
-                /**
-                 * Provenance for the design system: `captured` = derived from rendered
-                 * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-                 * evidence, gaps filled by inference; `inferred` = no rendered evidence
-                 * (static fetch / native inspection only). Keeps DESIGN.md honest about
-                 * extracted-vs-guessed values.
-                 */
                 evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
                 sourceFindings: z.ZodArray<z.ZodString, "many">;
                 sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -9620,16 +11095,6 @@ export type ReportVariantCompleteInput = {
     title?: string;
     description?: string;
 };
-/**
- * Unified hand-back tool that replaces `report_variant_briefs`,
- * `report_source_plan`, and `report_variant_complete`. The three share the
- * lease header (sessionId/workItemId/attempt/leaseId) and differ only by
- * payload, so they collapse behind a `kind` discriminator — the same pattern
- * `continue_variants(action=...)` uses. Because `mcp.tool()` takes a flat
- * ZodRawShape (not a top-level discriminated union), all payload fields are
- * optional here and the handler validates the per-kind requirements at runtime
- * (e.g. `kind:'status'` requires `leaseId` + `status`).
- */
 export declare const reportWorkItemInput: {
     kind: z.ZodEnum<["brief", "source_plan", "status"]>;
     sessionId: z.ZodString;
@@ -9641,10 +11106,6 @@ export declare const reportWorkItemInput: {
         label: z.ZodString;
         body: z.ZodString;
         notes: z.ZodOptional<z.ZodString>;
-        /**
-         * Optional per-brief visual reference URL. Uses the same synchronous
-         * network-target guard as inspiration URLs before downstream agents fetch it.
-         */
         visualReferenceUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     }, "strip", z.ZodTypeAny, {
         label: string;
@@ -9724,13 +11185,6 @@ export declare const reportWorkItemInput: {
             kind: z.ZodLiteral<"design_system">;
             data: z.ZodObject<{
                 designMarkdown: z.ZodOptional<z.ZodString>;
-                /**
-                 * Provenance for the design system: `captured` = derived from rendered
-                 * browser evidence (e.g. `capture_design_evidence`); `partial` = some
-                 * evidence, gaps filled by inference; `inferred` = no rendered evidence
-                 * (static fetch / native inspection only). Keeps DESIGN.md honest about
-                 * extracted-vs-guessed values.
-                 */
                 evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
                 sourceFindings: z.ZodArray<z.ZodString, "many">;
                 sectionInventory: z.ZodArray<z.ZodString, "many">;
@@ -10146,20 +11600,11 @@ export type CancelVariantOutput = {
     message: string;
 };
 export declare const startVariantsMode: z.ZodEnum<["existing", "zero_to_one"]>;
-/**
- * Brief content supplied by the agent through `start_variants`. The server
- * generates briefIds, so the agent only provides label + body (and an
- * optional visualReferenceUrl). Shape matches `briefSchema` minus briefId.
- */
 export declare const startVariantsBriefContent: z.ZodObject<Omit<{
     briefId: z.ZodString;
     label: z.ZodString;
     body: z.ZodString;
     notes: z.ZodOptional<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;
@@ -10187,24 +11632,11 @@ export declare const startVariantsInput: {
         ref: string;
     }>>;
     runLabel: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
-    /**
-     * Per-variant briefs supplied by the agent. When omitted, the server
-     * derives a shared run-intent label per slot from `runLabel` (or the
-     * prompt) — e.g. "Brighter 1", "Brighter 2" — plus the prompt as each
-     * body, identically for fresh and existing runs. UI shows the label/body
-     * as the variant name/description, so the agent should still supply briefs
-     * for distinct, human-readable directions. 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;
         notes: z.ZodOptional<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;
@@ -10217,18 +11649,9 @@ export declare const startVariantsInput: {
         notes?: string | undefined;
         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 project-detection call. */
     projectPath: z.ZodOptional<z.ZodString>;
-    /** Per-variant-slot design context (slug entries resolve bundled catalog
-     *  markdown; markdown entries are written directly as DESIGN.md). Slot order
-     *  matches variant order. */
     designContext: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"slug">;
         slug: z.ZodString;
@@ -10251,12 +11674,6 @@ export declare const startVariantsInput: {
         content: string;
         label: string;
     }>]>, "many">>;
-    /** Optional raw sources attached by the caller — inspiration URLs, local
-     *  images/videos, uploaded image data URLs, directories, or pasted text.
-     *  Rivet stores these as
-     *  read-only user context (the variant context bundle) and, for fresh
-     *  source-grounded runs, lets source planning decide what metadata actions
-     *  to derive. The sole source-intake field. */
     userContext: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"transport", [z.ZodObject<{
         transport: z.ZodLiteral<"url">;
         url: z.ZodString;
@@ -10281,17 +11698,48 @@ export declare const startVariantsInput: {
     }, "strip", z.ZodTypeAny, {
         path: string;
         transport: "file_path";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
     }, {
         path: string;
         transport: "file_path";
+        mimeType?: string | undefined;
         label?: string | undefined;
         userIntent?: string | undefined;
-        mimeType?: string | undefined;
     }>, z.ZodObject<{
         transport: z.ZodLiteral<"upload">;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            url: z.ZodEffects<z.ZodString, string, string>;
+            reason: z.ZodOptional<z.ZodString>;
+            image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                hash: z.ZodString;
+                mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+            }, "strip", z.ZodTypeAny, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }, {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }>, "many">>;
         dataUrl: z.ZodString;
         filename: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
@@ -10301,12 +11749,29 @@ export declare const startVariantsInput: {
         dataUrl: string;
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
         filename?: string | undefined;
     }, {
         transport: "upload";
         dataUrl: string;
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
         filename?: string | undefined;
     }>, z.ZodObject<{
         transport: z.ZodLiteral<"directory_path">;
@@ -10325,6 +11790,37 @@ export declare const startVariantsInput: {
         userIntent?: string | undefined;
     }>, z.ZodObject<{
         transport: z.ZodLiteral<"text">;
+        references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            url: z.ZodEffects<z.ZodString, string, string>;
+            reason: z.ZodOptional<z.ZodString>;
+            image: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+                hash: z.ZodString;
+                mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"]>;
+            }, "strip", z.ZodTypeAny, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }, {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }, {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }>, "many">>;
         content: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
         userIntent: z.ZodOptional<z.ZodString>;
@@ -10333,21 +11829,31 @@ export declare const startVariantsInput: {
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: {
+                hash: string;
+                mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/avif";
+            } | undefined;
+            reason?: string | undefined;
+        }[] | undefined;
     }, {
         content: string;
         transport: "text";
         label?: string | undefined;
         userIntent?: string | undefined;
+        references?: {
+            id: string;
+            url: string;
+            title: string;
+            image?: unknown;
+            reason?: string | undefined;
+        }[] | undefined;
     }>]>, "many">>;
     clientRequestId: z.ZodOptional<z.ZodString>;
-    /** UI correlation id of the originating change batch (its agentRunId), echoed
-     *  back to the agent on a variant-request batch. Stamped onto each spawned
-     *  variant so the panel maps its optimistic placeholders to the real cards —
-     *  pass it through verbatim. Distinct from `clientRequestId` (MCP-call
-     *  idempotency). */
     requestId: z.ZodOptional<z.ZodString>;
-    /** Parent variant to seed from when varying an existing code_gen direction.
-     *  Pass the batch `target.variantId` when the UI targets a specific variant. */
     sourceVariantId: z.ZodOptional<z.ZodString>;
 };
 export type StartVariantsBriefContent = z.infer<typeof startVariantsBriefContent>;
@@ -10365,47 +11871,29 @@ export type StartVariantsInput = {
     clientRequestId?: string;
     requestId?: string;
     briefs?: StartVariantsBriefContent[];
-    /** Parent variant workItemId to fork from when accumulating a Vary batch. */
     sourceVariantId?: string;
 };
-/**
- * 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 project-detection call. */
     project?: {
         projectPath: string;
         framework: string;
     };
-    /** FIFO depth of queued variant-request/refine batches at response time. */
     pendingVariantRequests?: number;
     nextAction: 'report_work_item';
 } | {
@@ -10499,12 +11987,6 @@ export type ReportSourcePlanOutput = {
     errorCode: ErrorCode;
     message: string;
 };
-/**
- * Depth of the server's variant-request/refine FIFO at response-build time —
- * AFTER any batch this call just consumed. Surfaced on agent-facing tool
- * responses so callers can detect stranded batches still queued. Optional so
- * older call sites that don't populate it stay valid.
- */
 export type PendingVariantRequestsField = {
     pendingVariantRequests?: number;
 };
@@ -10537,13 +12019,7 @@ export type ContinueVariantsOutput = ({
 } & PendingVariantRequestsField) | ({
     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;
@@ -10556,26 +12032,14 @@ export type ReportVariantCompleteOutput = {
         ready: number;
         total: number;
     };
-    /** Set when THIS reported variant did not pass the QA gate and was
-     *  re-queued for its single regeneration. It is no longer counted as
-     *  done — the agent MUST re-lease it via
-     *  continue_variants(action='request_work'), address the QA notes, then
-     *  report_variant_complete again. Absent on a normal "sibling still in
-     *  flight" wait, so the agent can tell the two apart. */
     regenerate?: true;
-    /** Actionable regeneration instruction to act on (and surface to the
-     *  user). Populated alongside `regenerate`. */
     qaPrompt?: string;
-    /** The QA verdict that triggered the requeue. */
     qa?: Array<{
         workItemId: string;
         label?: string;
         qa: VariantQaResult;
     }>;
 } | {
-    /** The reported work item was removed/cancelled out from under the agent
-     *  (delete-while-loading, cancel_variant, session cancel). Stop this work
-     *  item immediately — do NOT retry or re-report it — and move on. */
     aborted: true;
     stage: Stage;
     progress: {
@@ -10585,7 +12049,6 @@ export type ReportVariantCompleteOutput = {
 } | {
     stage: 'ready' | 'degraded' | 'failed' | 'cancelled';
     summary: TerminalSummary;
-    /** See `ContinueVariantsOutput.qaPrompt`. */
     qaPrompt?: string;
     qa?: Array<{
         workItemId: string;
@@ -10677,11 +12140,8 @@ export type ListPastVariantsOutput = {
     message: string;
 };
 export declare const captureDesignEvidenceInput: {
-    /** Correlation only; safe to omit. */
     sessionId: z.ZodOptional<z.ZodString>;
-    /** The reference URL to render. */
     url: z.ZodString;
-    /** Optional viewport override; defaults to desktop 1440x1000. */
     viewport: z.ZodOptional<z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
@@ -10701,20 +12161,8 @@ export type CaptureDesignEvidenceInput = {
         height: number;
     };
 };
-/**
- * On success the tool returns rendered evidence as content blocks (a text block
- * with the `:root` tokens + computed element styles + fonts, plus a screenshot
- * image) for the agent to synthesize design_system.data.designMarkdown from —
- * not a typed JSON payload. This type covers only the unavailable/failed case.
- */
 export type CaptureDesignEvidenceOutput = {
     ok: false;
-    /**
-     * When false, no browser agent is available (server not configured, or
-     * unauthenticated) — inspect the URL natively and report design_system with
-     * `evidenceStatus: 'inferred'`. When true, the agent is enabled but this
-     * render failed; you may retry or fall back.
-     */
     available: boolean;
     evidenceStatus: 'inferred';
     reason: string;
@@ -10724,7 +12172,6 @@ export declare const getVariantInput: {
     projectPath: z.ZodOptional<z.ZodString>;
     sessionId: z.ZodString;
     variantId: z.ZodString;
-    /** When false, diff body / file list are omitted to keep responses small. */
     includeBody: z.ZodOptional<z.ZodBoolean>;
 };
 export type GetVariantInput = {
@@ -10741,13 +12188,7 @@ export type GetVariantOutput = {
         destinationPath?: string;
         diff?: string;
         files?: string[];
-        /** Top-level DESIGN.md artifact body — present for fresh-project
-         *  variants scaffolded with a design context. Omitted when
-         *  `includeBody: false`. */
         designMarkdown?: string;
-        /** Provenance for the persisted DESIGN.md so callers can render a
-         *  recognizable label (e.g. catalog name) without re-resolving the
-         *  slug. */
         designSource?: {
             kind: 'slug' | 'markdown';
             label: string;
@@ -10759,48 +12200,23 @@ export type GetVariantOutput = {
     errorCode: ErrorCode;
     message: string;
 };
-export type VariantPickPayload = 
-/**
- * Server-internal raw diff payload. Retained so unit tests and callers that
- * predate server-side apply can still introspect the diff body. The
- * production commit path applies the diff and records `diff-applied`.
- */
-{
+export type VariantPickPayload = {
     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;