@agent-native/core 0.137.7 → 0.138.0

package/corpus/templates/design/actions/update-design.ts

@@ -4,6 +4,7 @@ import { and, eq, isNull } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { numericDesignDataWriteError } from "../shared/canvas-frames.js";
 
 const MAX_DATA_CAS_ATTEMPTS = 5;
 const MAX_DATA_OPERATION_SOURCES = 128;
@@ -26,17 +27,63 @@ const dataPathSchema = z
   .min(1)
   .max(8);
 
-const dataOperationSchema = z.discriminatedUnion("op", [
-  z.object({
-    op: z.literal("set"),
-    path: dataPathSchema,
-    value: z.json(),
-  }),
-  z.object({
-    op: z.literal("delete"),
-    path: dataPathSchema,
-  }),
-]);
+const dataOperationSchema = z
+  .discriminatedUnion("op", [
+    z.object({
+      op: z.literal("set"),
+      path: dataPathSchema,
+      value: z.json(),
+    }),
+    z.object({
+      op: z.literal("delete"),
+      path: dataPathSchema,
+    }),
+  ])
+  .superRefine((operation, context) => {
+    if (operation.op !== "set") return;
+    const message = numericDesignDataWriteError(
+      operation.path,
+      operation.value,
+    );
+    if (message) {
+      context.addIssue({ code: "custom", path: ["value"], message });
+    }
+  });
+
+const agentDataOperationSchema = z
+  .discriminatedUnion("op", [
+    z.object({
+      op: z.literal("set"),
+      path: dataPathSchema,
+      value: z
+        .union([
+          z.number(),
+          z.boolean(),
+          z.string(),
+          z.null(),
+          z.array(z.unknown()),
+          z.record(z.string(), z.unknown()),
+        ])
+        .describe(
+          "Value to set. Geometry and dimensions (x, y, width, height, rotation, z) " +
+            'are JSON numbers: 800, never "800" or "800px".',
+        ),
+    }),
+    z.object({
+      op: z.literal("delete"),
+      path: dataPathSchema,
+    }),
+  ])
+  .superRefine((operation, context) => {
+    if (operation.op !== "set") return;
+    const message = numericDesignDataWriteError(
+      operation.path,
+      operation.value,
+    );
+    if (message) {
+      context.addIssue({ code: "custom", path: ["value"], message });
+    }
+  });
 
 type DataOperation = z.infer<typeof dataOperationSchema>;
 
@@ -195,7 +242,9 @@ export default defineAction({
     "Update an existing design project. Requires editor access. " +
     "Only provided fields are updated; omitted fields are left unchanged. " +
     "For map entries such as canvasFrames, use dataOperations " +
-    "with explicit set/delete paths instead of a full data snapshot.",
+    "with explicit set/delete paths instead of a full data snapshot. " +
+    "Dimensions and positions (x, y, width, height, rotation, z) are " +
+    "numbers. String values are rejected.",
   schema: z
     .object({
       id: z.string().describe("Design ID"),
@@ -213,7 +262,7 @@ export default defineAction({
         .max(500)
         .optional()
         .describe(
-          "Atomic path-addressed set/delete operations for design data. Safe to CAS-retry across concurrent writers.",
+          "Atomic path-addressed set/delete operations for design data. Safe to CAS-retry across concurrent writers. Geometry values must be numbers, not strings.",
         ),
       operationSource: z
         .string()
@@ -272,6 +321,32 @@ export default defineAction({
         });
       }
     }),
+  // Advertised to the model only; `schema` above stays the validator. Drops
+  // operationSource/operationRevision, which order writes from one browser tab
+  // and have no meaning for an agent call.
+  agentInputSchema: z.object({
+    id: z.string().describe("Design ID"),
+    title: z.string().optional().describe("New title"),
+    description: z.string().optional().describe("New description"),
+    dataOperations: z
+      .array(agentDataOperationSchema)
+      .min(1)
+      .max(500)
+      .optional()
+      .describe(
+        "Atomic path-addressed set/delete operations for design data. Geometry values must be numbers, not strings.",
+      ),
+    projectType: z
+      .enum(["prototype", "other"])
+      .optional()
+      .describe("Updated project type"),
+    designSystemId: z
+      .string()
+      .min(1)
+      .nullable()
+      .optional()
+      .describe("Design system ID to link, or null to unlink"),
+  }),
   run: async ({
     id,
     title,
@@ -284,11 +359,18 @@ export default defineAction({
     designSystemId,
   }) => {
     if (data !== undefined) {
+      let parsedSnapshot: unknown;
       try {
-        JSON.parse(data);
+        parsedSnapshot = JSON.parse(data);
       } catch {
         throw new Error("data must be a valid JSON string");
       }
+      if (isRecord(parsedSnapshot)) {
+        for (const [key, value] of Object.entries(parsedSnapshot)) {
+          const message = numericDesignDataWriteError([key], value);
+          if (message) throw new Error(message);
+        }
+      }
     }
 
     await assertAccess("design", id, "editor");

package/corpus/templates/design/agent-native.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "onboarding": {
+    "firstRun": {
+      "development": "off",
+      "production": "connect-and-integrations"
+    }
+  },
+  "doctor": {
+    "failOnBuild": false
+  }
+}

package/corpus/templates/design/app/components/design/DesignImportPanel.tsx

@@ -37,6 +37,7 @@ import {
   getFigmaConnectionStatus,
   saveFigmaAccessToken,
 } from "@/lib/figma-connection";
+import { MAX_UPLOAD_MB } from "@/lib/upload-limits";
 import { cn } from "@/lib/utils";
 
 import type { DesignExtensionSlotContext } from "./DesignExtensionsPanel";
@@ -307,7 +308,9 @@ export function DesignImportPanel(p: DesignImportPanelProps) {
       }
       if (validationError === "too-large") {
         toast.error(t("designEditor.import.errors.uploadFailed"), {
-          description: t("designEditor.import.errors.figFileTooLarge"),
+          description: t("designEditor.import.errors.figFileTooLarge", {
+            max: MAX_UPLOAD_MB,
+          }),
         });
         if (figFileInputRef.current) figFileInputRef.current.value = "";
         return;
@@ -566,7 +569,9 @@ export function DesignImportPanel(p: DesignImportPanelProps) {
           >
             <div className="space-y-2 p-2">
               <p className="text-[11px] leading-snug text-muted-foreground">
-                {t("designEditor.import.figUploadDescription")}
+                {t("designEditor.import.figUploadDescription", {
+                  max: MAX_UPLOAD_MB,
+                })}
               </p>
               <input
                 ref={figFileInputRef}

package/corpus/templates/design/app/components/design/FigmaHydrationDialog.tsx

@@ -29,6 +29,7 @@ import {
   getFigmaConnectionStatus,
   saveFigmaAccessToken,
 } from "@/lib/figma-connection";
+import { MAX_UPLOAD_MB } from "@/lib/upload-limits";
 
 interface FigmaHydrationDialogProps {
   open: boolean;
@@ -70,8 +71,16 @@ export function FigmaHydrationDialog({
     const file = e.target.files?.[0];
     e.target.value = "";
     if (!file) return;
-    if (validateFigUploadFile(file)) {
-      setError(t("designEditor.import.figmaHydrationInvalidFig"));
+    const validationError = validateFigUploadFile(file);
+    if (validationError) {
+      setError(
+        t(
+          validationError === "too-large"
+            ? "designEditor.import.errors.figFileTooLarge"
+            : "designEditor.import.figmaHydrationInvalidFig",
+          { max: MAX_UPLOAD_MB },
+        ),
+      );
       return;
     }
     setBusy(true);

package/corpus/templates/design/app/components/design/edit-panel/component-section.tsx

@@ -187,7 +187,7 @@ function MakeItRealCard({
   const summary =
     cta.kind === "configure-project"
       ? `Choose a Builder project to enable ${featureLabel}.`
-      : `Connect Builder to enable ${featureLabel}.`;
+      : `Connect Builder (free tier available) to enable ${featureLabel}.`;
   const primaryLabel =
     cta.kind === "configure-project"
       ? t("designEditor.makeItRealCard.choose")

package/corpus/templates/design/app/components/editor/PromptDialog.tsx

@@ -52,6 +52,7 @@ import {
   TooltipContent,
   TooltipTrigger,
 } from "@/components/ui/tooltip";
+import { MAX_UPLOAD_BYTES, MAX_UPLOAD_MB } from "@/lib/upload-limits";
 import { cn } from "@/lib/utils";
 
 export interface UploadedFile {
@@ -513,6 +514,12 @@ export default function PromptPopover({
   const uploadFiles = useCallback(
     async (files: File[]): Promise<UploadedFile[]> => {
       if (files.length === 0) return [];
+      const totalBytes = files.reduce((sum, file) => sum + file.size, 0);
+      if (totalBytes > MAX_UPLOAD_BYTES) {
+        throw new Error(
+          t("promptDialog.attachmentsTooLarge", { max: MAX_UPLOAD_MB }),
+        );
+      }
       setUploading(true);
       try {
         const formData = new FormData();
@@ -552,7 +559,7 @@ export default function PromptPopover({
         setUploading(false);
       }
     },
-    [],
+    [t],
   );
 
   const handleSubmit = useCallback(

package/corpus/templates/design/app/i18n-data.ts

@@ -635,7 +635,7 @@ const enUS = {
       figmaHydrationFigError: "Couldn't read images from that .fig file.",
       figUploadTitle: "Upload .fig",
       figUploadDescription:
-        "Local import using Figma's .fig format — no API quota. Embedded images are included. Format may change between Figma versions. Maximum 50 MB.",
+        "Local import using Figma's .fig format — no API quota. Embedded images are included. Format may change between Figma versions. Maximum {{max}} MB.",
       chooseFigFile: "Choose .fig file",
       figUploadUploading: "Uploading {{progress}}%",
       figUploadProcessing: "Converting…",
@@ -683,7 +683,8 @@ const enUS = {
         figmaPasteFailed: "Figma paste import failed",
         uploadFailed: "File upload failed",
         invalidFigFile: "Choose a file ending in .fig.",
-        figFileTooLarge: ".fig files must be 50 MB or smaller.",
+        figFileTooLarge:
+          "That .fig is too large — uploads are limited to {{max}} MB. In Figma, copy just the frame you want into a new file and export that as .fig, or use Paste from Figma instead.",
       },
     },
     generationMayHaveStopped:
@@ -1249,6 +1250,8 @@ const enUS = {
     assetAdded: "Asset added",
     assetsNoImageUrl: "Assets did not return an image URL.",
     failedToUploadFile: "Failed to upload file",
+    attachmentsTooLarge:
+      "Those attachments are too large. Uploads are limited to {{max}} MB in total — attach fewer or smaller files.",
     failedToSubmitPrompt: "Failed to submit prompt",
     skipPrompt: "Skip prompt",
     designSystem: "Design system",
@@ -5590,6 +5593,8 @@ const designRawLiteralOverrides = {
       assetAdded: "添加资产",
       assetsNoImageUrl: "Assets 未返回图片 URL。",
       failedToUploadFile: "上传文件失败",
+      attachmentsTooLarge:
+        "这些附件太大。上传总大小上限为 {{max}} MB — 请减少文件数量或使用更小的文件。",
       designSystem: "Design系统",
       noDesignSystem: "没有设计系统",
       newDesignSystem: "新",
@@ -5749,6 +5754,8 @@ const designRawLiteralOverrides = {
       assetAdded: "Activo agregado",
       assetsNoImageUrl: "Assets no devolvió una URL de imagen.",
       failedToUploadFile: "No se pudo cargar el archivo",
+      attachmentsTooLarge:
+        "Esos adjuntos son demasiado grandes. Las subidas están limitadas a {{max}} MB en total: adjunta menos archivos o más pequeños.",
       designSystem: "sistema Design",
       noDesignSystem: "Sin sistema de diseño",
       newDesignSystem: "Nuevo",
@@ -5912,6 +5919,8 @@ const designRawLiteralOverrides = {
       assetAdded: "Actif ajouté",
       assetsNoImageUrl: "Assets n'a pas renvoyé d'URL d'image.",
       failedToUploadFile: "Échec du téléchargement du fichier",
+      attachmentsTooLarge:
+        "Ces pièces jointes sont trop volumineuses. Les téléversements sont limités à {{max}} Mo au total : joignez moins de fichiers ou des fichiers plus petits.",
       designSystem: "Système Design",
       noDesignSystem: "Aucun système de conception",
       newDesignSystem: "Nouveau",
@@ -6075,6 +6084,8 @@ const designRawLiteralOverrides = {
       assetAdded: "Asset hinzugefügt",
       assetsNoImageUrl: "Assets hat keine Bild-URL zurückgegeben.",
       failedToUploadFile: "Datei konnte nicht hochgeladen werden",
+      attachmentsTooLarge:
+        "Diese Anhänge sind zu groß. Uploads sind auf insgesamt {{max}} MB begrenzt – hänge weniger oder kleinere Dateien an.",
       designSystem: "Design-System",
       noDesignSystem: "Kein Designsystem",
       newDesignSystem: "Neu",
@@ -6238,6 +6249,8 @@ const designRawLiteralOverrides = {
       assetAdded: "アセットが追加されました",
       assetsNoImageUrl: "Assets が画像 URL を返しませんでした。",
       failedToUploadFile: "ファイルのアップロードに失敗しました",
+      attachmentsTooLarge:
+        "添付ファイルが大きすぎます。アップロードは合計 {{max}} MB までです。ファイル数を減らすか、より小さいファイルを添付してください。",
       designSystem: "Designシステム",
       noDesignSystem: "デザインシステムがない",
       newDesignSystem: "新しい",
@@ -6396,6 +6409,8 @@ const designRawLiteralOverrides = {
       assetAdded: "자산이 추가됨",
       assetsNoImageUrl: "Assets에서 이미지 URL을 반환하지 않았습니다.",
       failedToUploadFile: "파일을 업로드하지 못했습니다.",
+      attachmentsTooLarge:
+        "첨부 파일이 너무 큽니다. 업로드는 총 {{max}}MB까지 지원됩니다. 파일 수를 줄이거나 더 작은 파일을 첨부하세요.",
       designSystem: "Design 시스템",
       noDesignSystem: "디자인 시스템 없음",
       newDesignSystem: "새로운",
@@ -6556,6 +6571,8 @@ const designRawLiteralOverrides = {
       assetAdded: "Recurso adicionado",
       assetsNoImageUrl: "Assets não retornou uma URL de imagem.",
       failedToUploadFile: "Falha ao carregar o arquivo",
+      attachmentsTooLarge:
+        "Esses anexos são grandes demais. Os envios são limitados a {{max}} MB no total — anexe menos arquivos ou arquivos menores.",
       designSystem: "Sistema Design",
       noDesignSystem: "Nenhum sistema de design",
       newDesignSystem: "Novo",
@@ -6717,6 +6734,8 @@ const designRawLiteralOverrides = {
       assetAdded: "संपत्ति जोड़ी गई",
       assetsNoImageUrl: "Assets ने कोई छवि URL नहीं लौटाया।",
       failedToUploadFile: "फ़ाइल अपलोड करने में विफल",
+      attachmentsTooLarge:
+        "ये attachments बहुत बड़े हैं। Uploads की कुल सीमा {{max}} MB है — कम या छोटी files attach करें।",
       designSystem: "Design प्रणाली",
       noDesignSystem: "कोई डिज़ाइन प्रणाली नहीं",
       newDesignSystem: "नया",
@@ -6875,6 +6894,8 @@ const designRawLiteralOverrides = {
       assetAdded: "تمت إضافة الأصول",
       assetsNoImageUrl: "لم تُرجع Assets عنوان URL للصورة.",
       failedToUploadFile: "فشل تحميل الملف",
+      attachmentsTooLarge:
+        "المرفقات كبيرة جدًا. الحد الأقصى للرفع هو {{max}} ميغابايت إجمالًا — أرفق ملفات أقل أو أصغر.",
       designSystem: "نظام Design",
       noDesignSystem: "لا يوجد نظام التصميم",
       newDesignSystem: "جديد",
@@ -12233,7 +12254,7 @@ const designImportOverrides = {
           "已從 Figma 填入 {{count}} 個圖片{{plural}}。",
         figUploadTitle: "上傳 .fig",
         figUploadDescription:
-          "實驗性功能：Figma 的 .fig 格式為專有格式且可能變更。支援的圖層會轉為可編輯螢幕，部分功能可能不同。上限為 50 MB。",
+          "實驗性功能：Figma 的 .fig 格式為專有格式且可能變更。支援的圖層會轉為可編輯螢幕，部分功能可能不同。上限為 {{max}} MB。",
         chooseFigFile: "選擇 .fig 檔案",
         figUploadUploading: "上傳中 {{progress}}%",
         figUploadProcessing: "轉換中…",
@@ -12265,7 +12286,8 @@ const designImportOverrides = {
           figmaPasteFailed: "Figma 貼上匯入失敗",
           uploadFailed: "檔案上傳失敗",
           invalidFigFile: "請選擇副檔名為 .fig 的檔案。",
-          figFileTooLarge: ".fig 檔案必須為 50 MB 或更小。",
+          figFileTooLarge:
+            "此 .fig 檔案太大 — 上傳上限為 {{max}} MB。請在 Figma 中將要匯入的畫框複製到新檔案，並匯出該檔案為 .fig，或改用「從 Figma 貼上」。",
         },
       },
     },
@@ -12296,7 +12318,7 @@ const designImportOverrides = {
           "已从 Figma 填入 {{count}} 张图片{{plural}}。",
         figUploadTitle: "上传 .fig",
         figUploadDescription:
-          "实验性功能：Figma 的 .fig 格式为专有格式且可能变化。支持的图层会转换为可编辑屏幕，部分功能可能有所不同。最大 50 MB。",
+          "实验性功能：Figma 的 .fig 格式为专有格式且可能变化。支持的图层会转换为可编辑屏幕，部分功能可能有所不同。最大 {{max}} MB。",
         chooseFigFile: "选择 .fig 文件",
         figUploadUploading: "正在上传 {{progress}}%",
         figUploadProcessing: "正在转换…",
@@ -12328,7 +12350,8 @@ const designImportOverrides = {
           figmaPasteFailed: "Figma 粘贴导入失败",
           uploadFailed: "文件上传失败",
           invalidFigFile: "请选择以 .fig 结尾的文件。",
-          figFileTooLarge: ".fig 文件必须为 50 MB 或更小。",
+          figFileTooLarge:
+            "该 .fig 文件太大 — 上传上限为 {{max}} MB。请在 Figma 中将需要导入的画板复制到新文件，然后导出该文件为 .fig，或改用“从 Figma 粘贴”。",
         },
       },
     },
@@ -12362,7 +12385,7 @@ const designImportOverrides = {
           "{{count}} imagen{{plural}} rellenada{{plural}} desde Figma.",
         figUploadTitle: "Subir .fig",
         figUploadDescription:
-          "Experimental: el formato .fig de Figma es propietario y puede cambiar. Las capas compatibles se convierten en pantallas editables; algunas funciones pueden variar. Máximo 50 MB.",
+          "Experimental: el formato .fig de Figma es propietario y puede cambiar. Las capas compatibles se convierten en pantallas editables; algunas funciones pueden variar. Máximo {{max}} MB.",
         chooseFigFile: "Elegir archivo .fig",
         figUploadUploading: "Subiendo {{progress}}%",
         figUploadProcessing: "Convirtiendo…",
@@ -12396,7 +12419,8 @@ const designImportOverrides = {
           figmaPasteFailed: "Error al importar el pegado de Figma",
           uploadFailed: "Error al subir el archivo",
           invalidFigFile: "Elige un archivo que termine en .fig.",
-          figFileTooLarge: "Los archivos .fig deben tener 50 MB o menos.",
+          figFileTooLarge:
+            "Ese .fig es demasiado grande: las subidas están limitadas a {{max}} MB. En Figma, copia solo el frame que quieras a un archivo nuevo y exporta ese archivo como .fig, o usa Pegar desde Figma.",
         },
       },
     },
@@ -12430,7 +12454,7 @@ const designImportOverrides = {
           "{{count}} image{{plural}} remplie{{plural}} depuis Figma.",
         figUploadTitle: "Téléverser .fig",
         figUploadDescription:
-          "Expérimental : le format .fig de Figma est propriétaire et peut évoluer. Les calques pris en charge deviennent des écrans modifiables ; certaines fonctions peuvent différer. Maximum 50 Mo.",
+          "Expérimental : le format .fig de Figma est propriétaire et peut évoluer. Les calques pris en charge deviennent des écrans modifiables ; certaines fonctions peuvent différer. Maximum {{max}} Mo.",
         chooseFigFile: "Choisir un fichier .fig",
         figUploadUploading: "Téléversement {{progress}} %",
         figUploadProcessing: "Conversion…",
@@ -12464,7 +12488,8 @@ const designImportOverrides = {
           figmaPasteFailed: "Échec de l’import du collage Figma",
           uploadFailed: "Échec du téléversement",
           invalidFigFile: "Choisissez un fichier se terminant par .fig.",
-          figFileTooLarge: "Les fichiers .fig doivent faire 50 Mo ou moins.",
+          figFileTooLarge:
+            "Ce .fig est trop volumineux : les téléversements sont limités à {{max}} Mo. Dans Figma, copiez uniquement le frame souhaité dans un nouveau fichier et exportez ce fichier en .fig, ou utilisez Coller depuis Figma.",
         },
       },
     },
@@ -12498,7 +12523,7 @@ const designImportOverrides = {
           "{{count}} Bild{{plural}} aus Figma ausgefüllt.",
         figUploadTitle: ".fig hochladen",
         figUploadDescription:
-          "Experimentell: Das .fig-Format von Figma ist proprietär und kann sich ändern. Unterstützte Ebenen werden zu bearbeitbaren Screens; einige Funktionen können abweichen. Maximal 50 MB.",
+          "Experimentell: Das .fig-Format von Figma ist proprietär und kann sich ändern. Unterstützte Ebenen werden zu bearbeitbaren Screens; einige Funktionen können abweichen. Maximal {{max}} MB.",
         chooseFigFile: ".fig-Datei wählen",
         figUploadUploading: "Wird hochgeladen: {{progress}} %",
         figUploadProcessing: "Wird konvertiert…",
@@ -12531,7 +12556,8 @@ const designImportOverrides = {
           figmaPasteFailed: "Figma-Einfügeimport fehlgeschlagen",
           uploadFailed: "Dateiupload fehlgeschlagen",
           invalidFigFile: "Wähle eine Datei mit der Endung .fig.",
-          figFileTooLarge: ".fig-Dateien dürfen höchstens 50 MB groß sein.",
+          figFileTooLarge:
+            "Diese .fig-Datei ist zu groß – Uploads sind auf {{max}} MB begrenzt. Kopiere in Figma nur den gewünschten Frame in eine neue Datei und exportiere diese als .fig, oder nutze „Aus Figma einfügen“.",
         },
       },
     },
@@ -12565,7 +12591,7 @@ const designImportOverrides = {
           "Figma から {{count}} 枚の画像{{plural}}が入力されました。",
         figUploadTitle: ".fig をアップロード",
         figUploadDescription:
-          "試験的機能：Figma の .fig 形式は独自仕様で、変更される可能性があります。対応レイヤーは編集可能な画面になりますが、一部の機能は異なる場合があります。最大 50 MB。",
+          "試験的機能：Figma の .fig 形式は独自仕様で、変更される可能性があります。対応レイヤーは編集可能な画面になりますが、一部の機能は異なる場合があります。最大 {{max}} MB。",
         chooseFigFile: ".fig ファイルを選択",
         figUploadUploading: "アップロード中 {{progress}}%",
         figUploadProcessing: "変換中…",
@@ -12599,7 +12625,8 @@ const designImportOverrides = {
           figmaPasteFailed: "Figma 貼り付けのインポートに失敗しました",
           uploadFailed: "ファイルのアップロードに失敗しました",
           invalidFigFile: ".fig で終わるファイルを選択してください。",
-          figFileTooLarge: ".fig ファイルは 50 MB 以下にしてください。",
+          figFileTooLarge:
+            "この .fig ファイルは大きすぎます。アップロードは {{max}} MB までです。Figma で目的のフレームだけを新しいファイルにコピーし、そのファイルを .fig として書き出すか、「Figma から貼り付け」をご利用ください。",
         },
       },
     },
@@ -12632,7 +12659,7 @@ const designImportOverrides = {
           "Figma에서 {{count}}개의 이미지{{plural}}가 채워졌습니다.",
         figUploadTitle: ".fig 업로드",
         figUploadDescription:
-          "실험적 기능: Figma의 .fig 형식은 독점 형식이며 변경될 수 있습니다. 지원되는 레이어는 편집 가능한 화면으로 변환되지만 일부 기능은 다를 수 있습니다. 최대 50MB.",
+          "실험적 기능: Figma의 .fig 형식은 독점 형식이며 변경될 수 있습니다. 지원되는 레이어는 편집 가능한 화면으로 변환되지만 일부 기능은 다를 수 있습니다. 최대 {{max}}MB.",
         chooseFigFile: ".fig 파일 선택",
         figUploadUploading: "업로드 중 {{progress}}%",
         figUploadProcessing: "변환 중…",
@@ -12666,7 +12693,8 @@ const designImportOverrides = {
           figmaPasteFailed: "Figma 붙여넣기 가져오기 실패",
           uploadFailed: "파일 업로드 실패",
           invalidFigFile: ".fig로 끝나는 파일을 선택하세요.",
-          figFileTooLarge: ".fig 파일은 50MB 이하여야 합니다.",
+          figFileTooLarge:
+            "이 .fig 파일은 너무 큽니다. 업로드는 {{max}}MB까지 지원됩니다. Figma에서 원하는 프레임만 새 파일로 복사한 뒤 그 파일을 .fig로 내보내거나, 'Figma에서 붙여넣기'를 사용하세요.",
         },
       },
     },
@@ -12701,7 +12729,7 @@ const designImportOverrides = {
           "{{count}} imagem{{plural}} preenchida{{plural}} do Figma.",
         figUploadTitle: "Enviar .fig",
         figUploadDescription:
-          "Experimental: o formato .fig do Figma é proprietário e pode mudar. As camadas compatíveis viram telas editáveis; alguns recursos podem ser diferentes. Máximo de 50 MB.",
+          "Experimental: o formato .fig do Figma é proprietário e pode mudar. As camadas compatíveis viram telas editáveis; alguns recursos podem ser diferentes. Máximo de {{max}} MB.",
         chooseFigFile: "Escolher arquivo .fig",
         figUploadUploading: "Enviando {{progress}}%",
         figUploadProcessing: "Convertendo…",
@@ -12735,7 +12763,8 @@ const designImportOverrides = {
           figmaPasteFailed: "Falha ao importar colagem do Figma",
           uploadFailed: "Falha no upload do arquivo",
           invalidFigFile: "Escolha um arquivo que termine em .fig.",
-          figFileTooLarge: "Arquivos .fig devem ter 50 MB ou menos.",
+          figFileTooLarge:
+            "Esse .fig é grande demais — os envios são limitados a {{max}} MB. No Figma, copie apenas o frame desejado para um novo arquivo e exporte esse arquivo como .fig, ou use Colar do Figma.",
         },
       },
     },
@@ -12769,7 +12798,7 @@ const designImportOverrides = {
           "Figma से {{count}} छवि{{plural}} भरी गई{{plural}}।",
         figUploadTitle: ".fig अपलोड करें",
         figUploadDescription:
-          "प्रायोगिक: Figma का .fig format proprietary है और बदल सकता है। समर्थित layers editable screens बनती हैं; कुछ features अलग हो सकते हैं। अधिकतम 50 MB।",
+          "प्रायोगिक: Figma का .fig format proprietary है और बदल सकता है। समर्थित layers editable screens बनती हैं; कुछ features अलग हो सकते हैं। अधिकतम {{max}} MB।",
         chooseFigFile: ".fig file चुनें",
         figUploadUploading: "अपलोड हो रहा है {{progress}}%",
         figUploadProcessing: "बदला जा रहा है…",
@@ -12803,7 +12832,8 @@ const designImportOverrides = {
           figmaPasteFailed: "Figma paste आयात विफल रहा",
           uploadFailed: "File upload विफल रहा",
           invalidFigFile: ".fig पर समाप्त होने वाली file चुनें।",
-          figFileTooLarge: ".fig files 50 MB या उससे छोटी होनी चाहिए।",
+          figFileTooLarge:
+            "यह .fig बहुत बड़ी है — uploads की सीमा {{max}} MB है। Figma में जिस frame को import करना है उसे एक नई file में copy करें और उस file को .fig के रूप में export करें, या Paste from Figma का उपयोग करें।",
         },
       },
     },
@@ -12836,7 +12866,7 @@ const designImportOverrides = {
           "تم ملء {{count}} صورة{{plural}} من Figma.",
         figUploadTitle: "رفع .fig",
         figUploadDescription:
-          "ميزة تجريبية: تنسيق .fig في Figma مملوك وقد يتغير. تتحول الطبقات المدعومة إلى شاشات قابلة للتحرير، وقد تختلف بعض الميزات. الحد الأقصى 50 ميغابايت.",
+          "ميزة تجريبية: تنسيق .fig في Figma مملوك وقد يتغير. تتحول الطبقات المدعومة إلى شاشات قابلة للتحرير، وقد تختلف بعض الميزات. الحد الأقصى {{max}} ميغابايت.",
         chooseFigFile: "اختر ملف .fig",
         figUploadUploading: "جار الرفع {{progress}}%",
         figUploadProcessing: "جار التحويل…",
@@ -12869,7 +12899,8 @@ const designImportOverrides = {
           figmaPasteFailed: "فشل استيراد لصق Figma",
           uploadFailed: "فشل رفع الملف",
           invalidFigFile: "اختر ملفا ينتهي بـ .fig.",
-          figFileTooLarge: "يجب ألا يتجاوز ملف .fig حجم 50 ميغابايت.",
+          figFileTooLarge:
+            "ملف ‎.fig‎ كبير جدًا — الحد الأقصى للرفع {{max}} ميغابايت. في Figma، انسخ الإطار المطلوب فقط إلى ملف جديد وصدّر ذلك الملف بصيغة ‎.fig‎، أو استخدم اللصق من Figma.",
         },
       },
     },

package/corpus/templates/design/app/lib/design-file-upload.ts

@@ -1,6 +1,5 @@
 import { parseUploadResponse, type ImportResult } from "@/lib/design-import";
-
-export const MAX_FIG_UPLOAD_BYTES = 50 * 1024 * 1024;
+import { MAX_UPLOAD_BYTES } from "@/lib/upload-limits";
 
 export type FigUploadValidationError = "invalid-extension" | "too-large";
 
@@ -8,7 +7,7 @@ export function validateFigUploadFile(
   file: Pick<File, "name" | "size">,
 ): FigUploadValidationError | null {
   if (!file.name.toLowerCase().endsWith(".fig")) return "invalid-extension";
-  if (file.size > MAX_FIG_UPLOAD_BYTES) return "too-large";
+  if (file.size > MAX_UPLOAD_BYTES) return "too-large";
   return null;
 }
 

package/corpus/templates/design/app/lib/upload-limits.ts

@@ -0,0 +1,4 @@
+/** Mirrors the server wire cap in `server/lib/request-body-limits.ts`; the two
+ * are held together by the alignment test in `design-file-upload.test.ts`. */
+export const MAX_UPLOAD_BYTES = 4 * 1024 * 1024;
+export const MAX_UPLOAD_MB = MAX_UPLOAD_BYTES / 1024 / 1024;

package/corpus/templates/design/app/pages/DesignSystemSetup.tsx

@@ -450,7 +450,7 @@ export default function DesignSystemSetup() {
 
     if (normalizedGithubLinks.length > 0) {
       parts.push(
-        `\n## Connect Code: GitHub Repositories\nStart Builder DSI indexing for each repository with \`index-design-system-with-builder\`:\n${normalizedGithubLinks.map((l) => `- ${l.url}`).join("\n")}\n\nBuilder is the source of truth for repo/code design-system indexing. The action also creates a local selectable proxy design system for Design flows. If Builder is not connected, stop and tell me to connect Builder from Settings instead of asking me to paste repository credentials into chat.`,
+        `\n## Connect Code: GitHub Repositories\nStart Builder DSI indexing for each repository with \`index-design-system-with-builder\`:\n${normalizedGithubLinks.map((l) => `- ${l.url}`).join("\n")}\n\nBuilder is the source of truth for repo/code design-system indexing. The action also creates a local selectable proxy design system for Design flows. If Builder is not connected, stop and tell me to connect Builder (free tier available) from Settings instead of asking me to paste repository credentials into chat.`,
       );
     }
 

package/corpus/templates/design/changelog/2026-08-05-chat-attachments-now-warn-before-upload-when-they-exceed-the.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-05
+---
+
+Chat attachments now warn before upload when they exceed the 4 MB total limit, instead of failing with an unexplained error.

package/corpus/templates/design/changelog/2026-08-05-figma-fig-uploads-now-show-a-clear-4-mb-limit-up-front-inste.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-05
+---
+
+Figma .fig uploads now show a clear 4 MB limit up front instead of failing partway through the upload.

package/corpus/templates/design/scripts/qa-figma-stress-import.ts

@@ -48,7 +48,7 @@ const evidence = await runWithRequestContext({ userEmail, orgId }, async () => {
   const localQaStorageEnabled = isLocalFigmaQaUploadEnabled();
   if (!builderCredential && !localQaStorageEnabled) {
     throw new Error(
-      "This QA account has no request-scoped durable upload provider. Connect Builder in Design and retry.",
+      "This QA account has no request-scoped durable upload provider. Connect Builder (free tier available) in Design and retry.",
     );
   }
   // The explicit QA flag must deterministically exercise this provider even

package/corpus/templates/design/server/handlers/import-design-file.ts

@@ -10,15 +10,17 @@ import {
   setResponseStatus,
 } from "h3";
 
-import { MAX_FIG_FILE_BYTES } from "../lib/fig-file-limits.js";
 import {
   normalizeImportedHtmlDocument,
   saveImportedDesignFiles,
 } from "../lib/import-design-files.js";
+import {
+  MAX_UPLOAD_BYTES,
+  MAX_UPLOAD_MB,
+  TOTAL_BODY_LIMIT,
+} from "../lib/request-body-limits.js";
 
 const MAX_HTML_BYTES = 2 * 1024 * 1024;
-const MULTIPART_OVERHEAD_BYTES = 1024 * 1024;
-const TOTAL_BODY_LIMIT = MAX_FIG_FILE_BYTES + MULTIPART_OVERHEAD_BYTES;
 
 // Matches the local-kiwi clipboard frame cap so a token-free .fig hydration of
 // a multi-frame paste can fill every imported screen in one upload.
@@ -130,8 +132,10 @@ export const importDesignFile = defineEventHandler(async (event) => {
         }
 
         if (ext === ".fig") {
-          if (data.length > MAX_FIG_FILE_BYTES) {
-            throw new Error(".fig file is too large (max 50 MB).");
+          if (data.length > MAX_UPLOAD_BYTES) {
+            throw new Error(
+              `.fig file is too large (max ${MAX_UPLOAD_MB} MB). In Figma, copy just the frame you want into a new file and export that as .fig.`,
+            );
           }
 
           // Token-free hydration: fill the image placeholders left by a no-token