rivet-design 0.17.5 → 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"];
@@ -93,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>;
@@ -113,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">;
@@ -137,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>;
@@ -145,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;
@@ -184,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>;
@@ -193,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;
@@ -226,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>;
@@ -235,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;
@@ -266,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<{
@@ -311,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>;
@@ -320,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;
@@ -353,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>;
@@ -362,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>;
@@ -397,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;
@@ -413,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;
@@ -434,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;
@@ -450,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;
@@ -778,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>;
@@ -787,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;
@@ -820,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>;
@@ -829,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;
@@ -1019,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">;
@@ -1124,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;
@@ -1140,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;
@@ -1190,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";
@@ -1235,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;
@@ -1251,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;
@@ -1301,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,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>;
@@ -1400,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;
@@ -1433,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>;
@@ -1442,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;
@@ -1632,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">;
@@ -1737,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;
@@ -1753,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;
@@ -1803,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";
@@ -1848,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;
@@ -1864,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;
@@ -1914,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";
@@ -1971,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;
@@ -1987,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;
@@ -2037,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";
@@ -2094,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;
@@ -2110,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;
@@ -2160,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";
@@ -2254,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>;
@@ -2263,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;
@@ -2296,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>;
@@ -2305,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;
@@ -2495,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">;
@@ -2600,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;
@@ -2616,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;
@@ -2666,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";
@@ -2711,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;
@@ -2727,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;
@@ -2777,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";
@@ -2889,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;
@@ -2905,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;
@@ -2955,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";
@@ -3027,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;
@@ -3043,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;
@@ -3093,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";
@@ -3186,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>;
@@ -3195,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;
@@ -3228,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>;
@@ -3237,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;
@@ -3427,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">;
@@ -3532,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;
@@ -3548,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;
@@ -3598,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";
@@ -3643,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;
@@ -3659,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;
@@ -3709,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";
@@ -3766,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;
@@ -3782,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;
@@ -3832,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";
@@ -3889,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;
@@ -3905,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;
@@ -3955,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";
@@ -4048,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>;
@@ -4057,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;
@@ -4090,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>;
@@ -4099,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;
@@ -4289,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">;
@@ -4394,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;
@@ -4410,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;
@@ -4460,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";
@@ -4505,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;
@@ -4521,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;
@@ -4571,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";
@@ -4683,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;
@@ -4699,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;
@@ -4749,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";
@@ -4821,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;
@@ -4837,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;
@@ -4887,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";
@@ -4980,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>;
@@ -4989,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;
@@ -5022,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>;
@@ -5031,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;
@@ -5221,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">;
@@ -5326,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;
@@ -5342,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;
@@ -5392,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";
@@ -5437,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;
@@ -5453,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;
@@ -5503,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";
@@ -5618,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>;
@@ -5627,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;
@@ -5660,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>;
@@ -5669,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;
@@ -5859,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">;
@@ -5964,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;
@@ -5980,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;
@@ -6030,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";
@@ -6075,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;
@@ -6091,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;
@@ -6141,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";
@@ -6350,6 +7719,7 @@ export interface ActiveVariantSnapshot {
     runLabel?: string;
     requestId?: string;
     description?: string;
+    references?: VariantReference[];
     adoptedSource?: {
         sessionId: string;
         variantId: string;
@@ -6508,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;
@@ -6542,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>;
@@ -6551,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;
@@ -6584,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>;
@@ -6593,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;
@@ -6764,16 +8261,16 @@ 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;
@@ -6818,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;
@@ -6834,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;
@@ -6871,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;
 }, {
@@ -6904,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;
@@ -6920,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;
@@ -6957,14 +8498,21 @@ 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;
 }>;
@@ -7050,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>;
@@ -7059,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;
@@ -7092,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>;
@@ -7101,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;
@@ -7291,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">;
@@ -7396,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;
@@ -7412,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;
@@ -7462,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";
@@ -7507,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;
@@ -7523,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;
@@ -7573,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";
@@ -7688,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>;
@@ -7697,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;
@@ -7730,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>;
@@ -7739,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;
@@ -7929,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">;
@@ -8034,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;
@@ -8050,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;
@@ -8100,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";
@@ -8145,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;
@@ -8161,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;
@@ -8211,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";
@@ -9890,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>;
@@ -9910,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">;
@@ -9934,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>;
@@ -9942,11 +11829,28 @@ 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>;
     requestId: z.ZodOptional<z.ZodString>;