@agent-native/core 0.176.1 → 0.176.2-nightly-20260831184159

package/corpus/templates/design/actions/get-design-system.ts

@@ -157,7 +157,7 @@ function buildDesignSystemAgentContext({
       builder.builderStatus ? `- Status: ${builder.builderStatus}` : "",
       "- Builder DSI docs and token values override local proxy placeholders.",
       canRefreshBuilder
-        ? "- If no usable DSI docs or tokens are returned, call refresh-design-system-with-builder once, then call get-design-system again before generating; if it is still empty, tell the user Builder indexing is not ready."
+        ? "- If no usable DSI docs or tokens are returned, call get-design-system-index-status to check Builder progress. Only call refresh-design-system-with-builder once after that status is ready, then call get-design-system again; if it is still empty, tell the user Builder indexing is not ready."
         : "- If no usable DSI docs or tokens are returned, tell the user Builder indexing is not ready; refreshing the shared system requires editor access.",
     );
 

package/corpus/templates/design/actions/hydrate-figma-paste-images.ts

@@ -18,6 +18,7 @@
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import {
   applyHydration,
   collectImageRefHashes,
@@ -40,7 +41,7 @@ export default defineAction({
         "ID of the design_files row to hydrate. Use the fileId returned by import-figma-clipboard.",
       ),
   }),
-  run: async ({ fileId }) => {
+  run: async ({ fileId }, context) => {
     const { workspaceFile, designId, figmaFileKey } =
       await loadHydratableFile(fileId);
 
@@ -95,6 +96,7 @@ export default defineAction({
       };
     }
 
+    await snapshotDesignBeforeAgentEdit(designId, context);
     const result = await applyHydration({
       file: workspaceFile,
       designId,

package/corpus/templates/design/actions/import-design-source.ts

@@ -2,6 +2,7 @@ import { defineAction } from "@agent-native/core/action";
 import { assertAccess } from "@agent-native/core/sharing";
 import { z } from "zod";
 
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import { saveFigmaPasteHtmlFallback } from "../server/lib/figma-paste-fallback.js";
 import {
   normalizeImportedHtmlDocument,
@@ -42,15 +43,18 @@ export default defineAction({
     frameWidth: z.number().optional(),
     frameHeight: z.number().optional(),
   }),
-  run: async ({
-    designId,
-    sourceType,
-    content,
-    originalName,
-    frameTitle,
-    frameWidth,
-    frameHeight,
-  }) => {
+  run: async (
+    {
+      designId,
+      sourceType,
+      content,
+      originalName,
+      frameTitle,
+      frameWidth,
+      frameHeight,
+    },
+    context,
+  ) => {
     ensureHtmlSize(content);
     const resolvedDesignId = await resolveImportDesignId(designId);
     await assertAccess("design", resolvedDesignId, "editor");
@@ -60,6 +64,7 @@ export default defineAction({
     // keeps every request far below the ~6MB a Netlify function will accept —
     // the cap the server route has to chunk around.
     if (sourceType === "fig-frame") {
+      await snapshotDesignBeforeAgentEdit(resolvedDesignId, context);
       const saved = await saveImportedDesignFiles({
         designId: resolvedDesignId,
         sourceType: "fig-upload",
@@ -87,6 +92,7 @@ export default defineAction({
     }
 
     if (sourceType === "html-string") {
+      await snapshotDesignBeforeAgentEdit(resolvedDesignId, context);
       const saved = await saveImportedDesignFiles({
         designId: resolvedDesignId,
         sourceType: "html-import",
@@ -105,6 +111,7 @@ export default defineAction({
       };
     }
 
+    await snapshotDesignBeforeAgentEdit(resolvedDesignId, context);
     return saveFigmaPasteHtmlFallback({
       designId: resolvedDesignId,
       clipboardHtml: content,

package/corpus/templates/design/actions/import-design-tokens.ts

@@ -23,6 +23,7 @@ import {
   mutateDesignData,
   type DesignDataRecord,
 } from "../server/lib/design-data-mutation.js";
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import {
   isSafeCssTokenValue,
   isSafeCssVarName,
@@ -439,8 +440,9 @@ export default defineAction({
     "apply-design-token-edit. For Figma/.fig and full local-code indexing, use " +
     "the Builder-backed design-system import flow.",
   schema: tokenImportSchema,
-  run: async ({ designId, source, files, text }) => {
+  run: async ({ designId, source, files, text }, context) => {
     await assertAccess("design", designId, "editor");
+    await snapshotDesignBeforeAgentEdit(designId, context);
 
     const db = getDb();
     let importFiles: { filename: string; content: string }[] = [];

package/corpus/templates/design/actions/import-figma-clipboard.ts

@@ -1,6 +1,7 @@
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import { importFigmaClipboardFromBuffer } from "../server/lib/figma-clipboard-local-decode.js";
 import {
   buildFigmaNodeCandidates,
@@ -15,7 +16,10 @@ import {
   summarizeFidelity,
 } from "../server/lib/figma-node-import.js";
 import { saveFigmaPasteHtmlFallback } from "../server/lib/figma-paste-fallback.js";
-import { saveImportedDesignFiles } from "../server/lib/import-design-files.js";
+import {
+  resolveImportDesignId,
+  saveImportedDesignFiles,
+} from "../server/lib/import-design-files.js";
 import { parseVisibleClipboardHtml } from "../server/lib/visible-clipboard-html.js";
 import { parseFigmaFileKey } from "../shared/figma-url.js";
 
@@ -125,20 +129,24 @@ export default defineAction({
       ),
     originalName: z.string().optional(),
   }),
-  run: async ({
-    designId,
-    figmetaFileKey,
-    selectedNodeIds,
-    selectedNodeIdsTruncated,
-    clipboardHtml,
-    clipboardBuffer,
-    clipboardBufferOmittedBytes,
-    originalName,
-  }) => {
+  run: async (
+    {
+      designId,
+      figmetaFileKey,
+      selectedNodeIds,
+      selectedNodeIdsTruncated,
+      clipboardHtml,
+      clipboardBuffer,
+      clipboardBufferOmittedBytes,
+      originalName,
+    },
+    context,
+  ) => {
     const fileKey = parseFigmaFileKey(figmetaFileKey);
     if (!fileKey) {
       throw new Error("The clipboard's Figma file key could not be parsed.");
     }
+    const resolvedDesignId = await resolveImportDesignId(designId);
 
     // Current Figma clipboard HTML commonly contains only figmeta + the
     // private binary figma buffer, with no visible HTML at all. Exact REST ids
@@ -161,8 +169,9 @@ export default defineAction({
         const nodesById = await fetchFigmaNodes(fileKey, selectedNodeIds);
         const { files, fidelityEntries, omissionWarnings } =
           await buildScreenFilesFromFigmaNodes(fileKey, nodesById);
+        await snapshotDesignBeforeAgentEdit(resolvedDesignId, context);
         const saved = await saveImportedDesignFiles({
-          designId,
+          designId: resolvedDesignId,
           sourceType: "figma-clipboard-rest",
           files,
         });
@@ -209,8 +218,9 @@ export default defineAction({
         const nodesById = await fetchFigmaNodes(fileKey, nodeIds);
         const { files, fidelityEntries, omissionWarnings } =
           await buildScreenFilesFromFigmaNodes(fileKey, nodesById);
+        await snapshotDesignBeforeAgentEdit(resolvedDesignId, context);
         const saved = await saveImportedDesignFiles({
-          designId,
+          designId: resolvedDesignId,
           sourceType: "figma-clipboard-rest",
           files,
         });
@@ -271,8 +281,9 @@ export default defineAction({
           originalName,
         });
         if (localResult.files.length > 0) {
+          await snapshotDesignBeforeAgentEdit(resolvedDesignId, context);
           const saved = await saveImportedDesignFiles({
-            designId,
+            designId: resolvedDesignId,
             sourceType: "figma-clipboard-local-kiwi",
             files: localResult.files,
           });
@@ -325,7 +336,7 @@ export default defineAction({
         ? "Nothing was imported."
         : "This Figma clipboard carried no exact node ids and no browser-readable HTML, so nothing was imported. Paste a frame link, or import the .fig file, for an exact import.";
       return {
-        designId,
+        designId: resolvedDesignId,
         files: [],
         warnings: [],
         strategy: "htmlFallback" as const,
@@ -338,8 +349,9 @@ export default defineAction({
       };
     }
 
+    await snapshotDesignBeforeAgentEdit(resolvedDesignId, context);
     const saved = await saveFigmaPasteHtmlFallback({
-      designId,
+      designId: resolvedDesignId,
       clipboardHtml,
       originalName,
     });

package/corpus/templates/design/actions/import-figma-frame.ts

@@ -2,6 +2,7 @@ import { defineAction } from "@agent-native/core/action";
 import { assertAccess } from "@agent-native/core/sharing";
 import { z } from "zod";
 
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import {
   buildScreenFilesFromFigmaNodes,
   fetchFigmaNode,
@@ -57,7 +58,7 @@ export default defineAction({
     "Import a Figma frame/component by URL or file key + node id, mapping supported structure to fidelity-aware HTML (position, auto-layout as flexbox, text, fills/gradients, strokes, corner radii, effects) and saving it as a new Design screen. Geometry and paint models HTML/CSS cannot represent faithfully (including masks, vector/boolean geometry, lines/arcs, advanced strokes/text, and transformed image crops) use rendered fallbacks instead of silently importing the wrong visual. Returns a fidelity report of which nodes were exact, approximated, or image-fallback. Requires the saved FIGMA_ACCESS_TOKEN secret.",
   schema: schemaInput,
   publicAgent: { expose: true, readOnly: false, requiresAuth: true },
-  run: async (args) => {
+  run: async (args, context) => {
     if (args.asNewScreen === false) {
       throw new Error(
         "asNewScreen: false is not supported yet. Omit it or pass true — the imported frame is always saved as a new screen.",
@@ -92,6 +93,7 @@ export default defineAction({
           },
         );
 
+      await snapshotDesignBeforeAgentEdit(designId, context);
       const saved = await saveImportedDesignFiles({
         designId,
         sourceType: "figma-import",

package/corpus/templates/design/actions/insert-asset.ts

@@ -5,6 +5,7 @@ import { and, eq } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import {
   readLiveSourceFile,
   writeInlineSourceFile,
@@ -316,7 +317,7 @@ export default defineAction({
     "get-code-layer-projection or the current selection.",
   schema: schemaInput,
   publicAgent: { expose: true, readOnly: false, requiresAuth: true },
-  run: async (args) => {
+  run: async (args, context) => {
     const target = await resolveTarget(args);
     if (!target.designId) {
       throw new Error(
@@ -353,6 +354,7 @@ export default defineAction({
         : (files.find(isHtmlFile) ?? null);
     if (!file) throw new Error("No editable HTML design file found.");
     await assertAccess("design", file.designId, "editor");
+    await snapshotDesignBeforeAgentEdit(file.designId, context);
 
     // Read the LIVE base (collab text when present, else the SQL row) right
     // before transforming, and carry its versionHash through to the write

package/corpus/templates/design/actions/insert-design-native-asset.ts

@@ -5,6 +5,7 @@ import { and, eq } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import {
   readLiveSourceFile,
   writeInlineSourceFile,
@@ -282,7 +283,7 @@ export default defineAction({
     "Insert a Design-native reusable primitive/component into the active design file. Use list-design-native-assets first to choose a kind. Inserts editable HTML stamped with Design component and layer metadata.",
   schema: schemaInput,
   publicAgent: { expose: true, readOnly: false, requiresAuth: true },
-  run: async (args) => {
+  run: async (args, context) => {
     const target = await resolveTarget(args);
     if (!target.designId) {
       throw new Error(
@@ -319,6 +320,7 @@ export default defineAction({
         : (files.find(isHtmlFile) ?? null);
     if (!file) throw new Error("No editable HTML design file found.");
     await assertAccess("design", file.designId, "editor");
+    await snapshotDesignBeforeAgentEdit(file.designId, context);
 
     // Read the LIVE base (collab text when present, else the SQL row) right
     // before transforming, and carry its versionHash through to the write

package/corpus/templates/design/actions/insert-figma-library-asset.ts

@@ -5,6 +5,7 @@ import { and, eq } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import {
   readLiveSourceFile,
   writeInlineSourceFile,
@@ -161,7 +162,7 @@ export default defineAction({
     "Insert a rendered Figma component or component set into a Design file, preserving Figma file/node/component provenance. Use list-figma-library-assets first to get renderUrl and metadata.",
   schema: schemaInput,
   publicAgent: { expose: true, readOnly: false, requiresAuth: true },
-  run: async (args) => {
+  run: async (args, context) => {
     const target = await resolveTarget(args);
     if (!target.designId) {
       throw new Error(
@@ -198,6 +199,7 @@ export default defineAction({
         : (files.find(isHtmlFile) ?? null);
     if (!file) throw new Error("No editable HTML design file found.");
     await assertAccess("design", file.designId, "editor");
+    await snapshotDesignBeforeAgentEdit(file.designId, context);
 
     // Read the LIVE base (collab text when present, else the SQL row) right
     // before transforming, and carry its versionHash through to the write

package/corpus/templates/design/actions/list-design-versions.ts

@@ -0,0 +1,23 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { listDesignVersions } from "../server/lib/design-versions.js";
+
+export default defineAction({
+  description:
+    "List the saved Design history checkpoints that can be restored. Returns " +
+    "metadata only, not the stored file contents.",
+  schema: z.object({
+    designId: z.string().describe("Design project ID"),
+    limit: z.coerce
+      .number()
+      .int()
+      .min(1)
+      .max(100)
+      .default(50)
+      .describe("Maximum number of history checkpoints to return"),
+  }),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async ({ designId, limit }) => listDesignVersions(designId, limit),
+});

package/corpus/templates/design/actions/migrate-board-objects-to-file.ts

@@ -39,6 +39,7 @@ import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
 import { mutateDesignData } from "../server/lib/design-data-mutation.js";
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import {
   BOARD_FILENAME,
   backfillBoardPrimitiveMarkers,
@@ -60,8 +61,9 @@ export default defineAction({
       .string()
       .describe("Design project ID to migrate board objects for."),
   }),
-  run: async ({ designId }) => {
+  run: async ({ designId }, context) => {
     await assertAccess("design", designId, "editor");
+    await snapshotDesignBeforeAgentEdit(designId, context);
 
     const db = getDb();
 

package/corpus/templates/design/actions/open-visual-edit.ts

@@ -441,26 +441,29 @@ export default defineAction({
         );
       }
 
-      const screens = await addLocalhostScreensAction.run({
-        designId,
-        connectionId: connection.id,
-        routes:
-          viewports && requestedRoutes
-            ? expandRoutesAcrossViewports({
-                routes: requestedRoutes,
-                viewports,
-                startX: args.startX ?? 0,
-                startY: args.startY ?? 0,
-                gap: args.gap ?? 160,
-              })
-            : args.routes,
-        paths: viewports ? undefined : args.paths,
-        defaultWidth: args.defaultWidth,
-        defaultHeight: args.defaultHeight,
-        startX: args.startX,
-        startY: args.startY,
-        gap: args.gap,
-      });
+      const screens = await addLocalhostScreensAction.run(
+        {
+          designId,
+          connectionId: connection.id,
+          routes:
+            viewports && requestedRoutes
+              ? expandRoutesAcrossViewports({
+                  routes: requestedRoutes,
+                  viewports,
+                  startX: args.startX ?? 0,
+                  startY: args.startY ?? 0,
+                  gap: args.gap ?? 160,
+                })
+              : args.routes,
+          paths: viewports ? undefined : args.paths,
+          defaultWidth: args.defaultWidth,
+          defaultHeight: args.defaultHeight,
+          startX: args.startX,
+          startY: args.startY,
+          gap: args.gap,
+        },
+        ctx,
+      );
 
       const urlPath = localVisualEditPath(designId);
       await writeAppState("visual-edit", {

package/corpus/templates/design/actions/present-design-variants.ts

@@ -13,6 +13,7 @@ import { z } from "zod";
 import "../server/db/index.js"; // ensure registerShareableResource runs
 import { getDb, schema } from "../server/db/index.js";
 import { mutateDesignData } from "../server/lib/design-data-mutation.js";
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import {
   mergeCanvasFramePlacements,
   nextFreeCanvasRowY,
@@ -927,8 +928,12 @@ export default defineAction({
       height: 720,
     }),
   },
-  run: async ({ designId, prompt, variants, deleteSupersededSetIds }) => {
+  run: async (
+    { designId, prompt, variants, deleteSupersededSetIds },
+    context,
+  ) => {
     await assertAccess("design", designId, "editor");
+    await snapshotDesignBeforeAgentEdit(designId, context);
 
     const omittedContent = variants.filter(
       (variant) => !variant.content?.trim(),
@@ -1216,7 +1221,7 @@ export default defineAction({
           allowOther: false,
           includeExplore: false,
           includeDecide: false,
-          submitOnSelect: true,
+          submitOnSelect: false,
           options: screens.map((screen, index) => {
             const otherScreens = screens
               .filter((other) => other.id !== screen.id)

package/corpus/templates/design/actions/refresh-design-system-with-builder.ts

@@ -4,7 +4,7 @@ import {
   parseBuilderDesignSystemProxyReference,
 } from "@agent-native/core/server";
 import { assertAccess, resolveAccess } from "@agent-native/core/sharing";
-import { and, eq } from "drizzle-orm";
+import { and, eq, isNull, ne, notExists } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
@@ -109,15 +109,71 @@ export default defineAction({
     }
 
     const db = getDb();
-    await db
-      .update(schema.designSystems)
-      .set({ data: reconciliation.data, updatedAt: syncedAt })
-      .where(
-        and(
-          eq(schema.designSystems.id, latestAccess.resource.id),
-          eq(schema.designSystems.data, latestAccess.resource.data),
-        ),
-      );
+    const persistedUpdate = await db.transaction(async (tx) => {
+      const targetScope = latestAccess.resource.orgId
+        ? and(
+            eq(
+              schema.designSystems.ownerEmail,
+              latestAccess.resource.ownerEmail,
+            ),
+            eq(schema.designSystems.orgId, latestAccess.resource.orgId),
+          )
+        : and(
+            eq(
+              schema.designSystems.ownerEmail,
+              latestAccess.resource.ownerEmail,
+            ),
+            isNull(schema.designSystems.orgId),
+          );
+      const [updated] = await tx
+        .update(schema.designSystems)
+        .set({ data: reconciliation.data, updatedAt: syncedAt })
+        .where(
+          and(
+            eq(schema.designSystems.id, latestAccess.resource.id),
+            eq(schema.designSystems.data, latestAccess.resource.data),
+            targetScope,
+          ),
+        )
+        .returning({ id: schema.designSystems.id });
+      if (!updated) return false;
+
+      await tx
+        .update(schema.designSystems)
+        .set({ isDefault: true, updatedAt: syncedAt })
+        .where(
+          and(
+            eq(schema.designSystems.id, latestAccess.resource.id),
+            targetScope,
+            notExists(
+              tx
+                .select({ id: schema.designSystems.id })
+                .from(schema.designSystems)
+                .where(
+                  and(
+                    targetScope,
+                    eq(schema.designSystems.isDefault, true),
+                    ne(schema.designSystems.id, latestAccess.resource.id),
+                  ),
+                ),
+            ),
+          ),
+        );
+      return true;
+    });
+
+    if (!persistedUpdate) {
+      return {
+        id,
+        synced: false,
+        status: "conflict",
+        docCount: hydrated.docCount,
+        tokenCount: reconciliation.tokenCount,
+        rejectedTokenCount: 0,
+        message:
+          "The design system changed while Builder DSI was syncing. Retry the refresh.",
+      };
+    }
 
     const persisted = await resolveAccess("design-system", id);
     if (!persistedBuilderSyncMatches(persisted?.resource?.data, syncedAt)) {

package/corpus/templates/design/actions/remove-breakpoint.ts

@@ -7,6 +7,7 @@ import {
   mutateDesignData,
   type DesignDataRecord,
 } from "../server/lib/design-data-mutation.js";
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import type { BreakpointSet } from "../shared/design-state.js";
 
 function readBreakpointSet(designData: DesignDataRecord): BreakpointSet | null {
@@ -30,8 +31,9 @@ export default defineAction({
       .string()
       .describe("Id of the BreakpointDefinition to remove."),
   }),
-  run: async ({ designId, breakpointId }) => {
+  run: async ({ designId, breakpointId }, context) => {
     await assertAccess("design", designId, "editor");
+    await snapshotDesignBeforeAgentEdit(designId, context);
 
     let sawSet = false;
     let removedBreakpoint: BreakpointSet["breakpoints"][number] | undefined;

package/corpus/templates/design/actions/remove-motion-timeline.ts

@@ -21,6 +21,7 @@ import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
 import "../server/db/index.js"; // ensure registerShareableResource runs
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import {
   readLiveSourceFile,
   writeInlineSourceFile,
@@ -65,8 +66,9 @@ export default defineAction({
           "when omitted.",
       ),
   }),
-  run: async ({ designId, timelineId, fileId: fileIdInput }) => {
+  run: async ({ designId, timelineId, fileId: fileIdInput }, context) => {
     await assertAccess("design", designId, "editor");
+    await snapshotDesignBeforeAgentEdit(designId, context);
 
     const db = getDb();
 

package/corpus/templates/design/actions/restore-design-version.ts

@@ -0,0 +1,16 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { restoreDesignVersion } from "../server/lib/design-versions.js";
+
+export default defineAction({
+  description:
+    "Restore a Design to a saved history checkpoint. The current live design " +
+    "is saved first, and restore fails if another collaborator is active.",
+  schema: z.object({
+    designId: z.string().describe("Design project ID"),
+    versionId: z.string().describe("Design history checkpoint ID"),
+  }),
+  run: async ({ designId, versionId }, context) =>
+    restoreDesignVersion({ designId, versionId, context }),
+});