@agent-native/core 0.80.7 → 0.80.9

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

@@ -56,10 +56,20 @@ const sourceSchema = z.preprocess(
     }),
 );
 
-const targetSchema = z.object({
-  nodeId: z.string().optional(),
-  selector: z.string().optional(),
-});
+const targetSchema = z
+  .object({
+    nodeId: z.string().optional(),
+    selector: z.string().optional(),
+  })
+  .superRefine((target, ctx) => {
+    if (!target.nodeId && !target.selector) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["nodeId"],
+        message: "target.nodeId or target.selector is required",
+      });
+    }
+  });
 
 const intentSchema = z.preprocess(
   parseJsonString,
@@ -168,6 +178,16 @@ async function resolveEditableDesignFile(
   if (file.fileType !== "html") {
     throw new Error("Visual code-layer edits only support HTML files for now.");
   }
+  if (source.designId && file.designId !== source.designId) {
+    throw new Error(
+      `source.designId "${source.designId}" does not match file "${file.id}"`,
+    );
+  }
+  if (source.filename && file.filename !== source.filename) {
+    throw new Error(
+      `source.filename "${source.filename}" does not match file "${file.id}"`,
+    );
+  }
 
   await assertAccess("design", file.designId, "editor");
 

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

@@ -91,11 +91,14 @@ function findUniqueStableIdAgnosticSpan(
   }
   if (count !== 1) return null;
 
+  // Anchor `end` to one byte past the LAST matched stripped character rather than
+  // the mapped index of the NEXT character. Mapping the next index can land before
+  // a stripped node-id attribute that sits right after the match, so the splice
+  // would cross it and corrupt the file (e.g. duplicate/mangled tags).
+  const lastMatched = onlyIndex + strippedSearch.length - 1;
   return {
     start: strippedContent.indexMap[onlyIndex] ?? 0,
-    end:
-      strippedContent.indexMap[onlyIndex + strippedSearch.length] ??
-      content.length,
+    end: (strippedContent.indexMap[lastMatched] ?? content.length - 1) + 1,
   };
 }
 

package/corpus/templates/design/actions/export-coding-handoff.ts

@@ -11,6 +11,7 @@ import { z } from "zod";
 import { schema } from "../server/db/index.js";
 import {
   buildCodingHandoffPrompt,
+  buildHandoffZipUrl,
   buildRawHandoffUrl,
   normalizeHandoffFormat,
 } from "../server/lib/coding-handoff.js";
@@ -30,9 +31,9 @@ function designDeepLink(designId: string): string {
 
 export default defineAction({
   description:
-    "Turn a design into code: create a coding-tool handoff for a design " +
-    "project. Returns a tokenized raw-code URL external agents can fetch, " +
-    "plus a ready-to-copy prompt. The bundle reflects the design's CURRENT " +
+    "Turn a design into code: create an agent handoff for a design project. " +
+    "Returns tokenized raw and ZIP URLs external agents can fetch, plus a " +
+    "ready-to-copy prompt. The bundle reflects the design's CURRENT " +
     "state — live editor (collab) content plus the user's applied visual " +
     "tweaks resolved into the HTML :root — so the generated code matches the " +
     "tuned design, not the original generated tokens. This is the canonical " +
@@ -56,7 +57,7 @@ export default defineAction({
   mcpApp: {
     compactCatalog: true,
     resource: embedApp({
-      title: "Design coding handoff",
+      title: "Design agent handoff",
       description: "Open the design in the real Design editor.",
       iframeTitle: "Agent-Native Design",
       openLabel: "Open design",
@@ -97,8 +98,14 @@ export default defineAction({
       origin: resolvedOrigin,
       format: handoffFormat,
     });
+    const zipUrl = buildHandoffZipUrl({
+      id,
+      token,
+      origin: resolvedOrigin,
+    });
     const prompt = buildCodingHandoffPrompt({
       rawUrl,
+      zipUrl,
       title: design.title,
       fileCount: snapshot.files.length,
     });
@@ -106,6 +113,7 @@ export default defineAction({
     return {
       designId: id,
       rawUrl,
+      zipUrl,
       prompt,
       clipboardText: prompt,
       format: handoffFormat,

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

@@ -1,6 +1,5 @@
 import { defineAction, embedApp } from "@agent-native/core";
 import {
-  deleteAppState,
   readAppState,
   writeAppState,
 } from "@agent-native/core/application-state";
@@ -26,6 +25,7 @@ import {
 import {
   designGenerationSessionKey,
   type DesignGenerationSession,
+  updateGenerationSessionWithSavedFiles,
 } from "../shared/generation-session.js";
 
 /** Editor deep link so external agents can surface "Open design". */
@@ -57,28 +57,13 @@ async function updateGenerationSessionForSavedFiles(
   const session = rawSession as unknown as DesignGenerationSession;
   if (session.designId !== designId || !Array.isArray(session.frames)) return;
 
-  const saved = new Set(savedFilenames);
-  const frames = session.frames.map((frame) =>
-    frame.filename && saved.has(frame.filename)
-      ? {
-          ...frame,
-          status: "done" as const,
-          step: "Saved",
-          progress: 1,
-        }
-      : frame,
+  const nextSession = updateGenerationSessionWithSavedFiles(
+    session,
+    savedFilenames,
   );
-  const allDone = frames.every((frame) => frame.status === "done");
-  if (allDone) {
-    await deleteAppState(key);
-    return;
-  }
+  if (nextSession === session) return;
 
-  await writeAppState(key, {
-    ...session,
-    status: "generating",
-    frames,
-  } as unknown as Record<string, unknown>);
+  await writeAppState(key, nextSession as unknown as Record<string, unknown>);
 }
 
 export default defineAction({

package/corpus/templates/design/actions/generate-screens.ts

@@ -51,7 +51,7 @@ const requestedScreenSchema = z
       .optional()
       .describe("Target filename for this screen, such as onboarding.html"),
     role: z.enum(["screen", "variant"]).optional().default("screen"),
-    variantOf: z.string().optional(),
+    variantOf: z.string().trim().min(1).optional(),
   })
   .superRefine((screen, ctx) => {
     if (screen.role === "variant" && !screen.variantOf) {
@@ -66,10 +66,11 @@ const requestedScreenSchema = z
 
 export default defineAction({
   description:
-    "Start a visible multi-agent generation session on the Design canvas. " +
+    "Start a multi-screen generation session on the Design canvas. " +
     "Use this before generating multiple screens or variations in parallel: it " +
-    "assigns non-overlapping canvas regions, publishes named agent/frame " +
-    "status to application state, and returns per-frame generation instructions. " +
+    "assigns non-overlapping canvas regions and returns per-frame generation " +
+    "instructions including canvasFrame placements. The session state is " +
+    "agent-facing planning state consumed by generate-design and view-screen. " +
     "After this action, fan out calls to generate-design for each returned " +
     "frame, passing the returned canvasFrame values to generate-design so " +
     "screens appear in the infinite overview canvas.",
@@ -79,7 +80,48 @@ export default defineAction({
     screens: z
       .preprocess(
         (value) => (typeof value === "string" ? JSON.parse(value) : value),
-        z.array(requestedScreenSchema).min(1).max(8),
+        z
+          .array(requestedScreenSchema)
+          .min(1)
+          .max(8)
+          .superRefine((screens, ctx) => {
+            const requestAnchors = new Map<
+              string,
+              { index: number; role: DesignGenerationFrame["role"] }
+            >();
+            screens.forEach((screen, index) => {
+              const anchors = [screen.frameId, screen.filename, screen.title];
+              for (const anchor of anchors) {
+                if (!anchor || requestAnchors.has(anchor)) continue;
+                requestAnchors.set(anchor, {
+                  index,
+                  role: screen.role,
+                });
+              }
+            });
+
+            screens.forEach((screen, index) => {
+              if (screen.role !== "variant" || !screen.variantOf) return;
+              const anchor = requestAnchors.get(screen.variantOf);
+              if (!anchor) return;
+              if (anchor.index === index) {
+                ctx.addIssue({
+                  code: z.ZodIssueCode.custom,
+                  path: [index, "variantOf"],
+                  message: "variant screens cannot point to themselves",
+                });
+                return;
+              }
+              if (anchor.role === "variant") {
+                ctx.addIssue({
+                  code: z.ZodIssueCode.custom,
+                  path: [index, "variantOf"],
+                  message:
+                    "variant screens must anchor to a base screen, not another variant",
+                });
+              }
+            });
+          }),
       )
       .describe("Screens or variants that should be generated on the canvas"),
     designSystemId: z
@@ -167,6 +209,7 @@ export default defineAction({
       prompt,
       contextRefs,
       frames,
+      startedAt: new Date().toISOString(),
     };
 
     await writeAppState(

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

@@ -14,6 +14,7 @@ export default defineAction({
   }),
   readOnly: true,
   requiresAuth: false,
+  publicAgent: { expose: true, readOnly: true, requiresAuth: false },
   http: { method: "GET" },
   run: async ({ id }) => {
     const access = await resolveAccess("design", id);