@agent-native/core 0.96.0 → 0.97.0

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

@@ -25,12 +25,18 @@ import {
 } from "../shared/code-layer.js";
 import { agentSelectionDescriptor } from "../shared/collab-selection.js";
 import type { TailwindBreakpointPrefix } from "../shared/design-state.js";
+import {
+  planLocalJsxVisualEdit,
+  type LocalJsxLeafIntent,
+} from "../shared/local-jsx-visual-edit.js";
 import {
   breakpointUpperBoundPx,
   planBreakpointStyleWrite,
   utilityStem,
   widthToPrefix,
 } from "../shared/responsive-classes.js";
+import readLocalFileAction from "./read-local-file.js";
+import writeLocalFileAction from "./write-local-file.js";
 
 /**
  * Short human-readable label describing an edit intent, shown next to the
@@ -315,6 +321,7 @@ const sourceSchema = z.preprocess(
       filename: z.string().optional(),
       path: z.string().optional(),
       url: z.string().optional(),
+      connectionId: z.string().optional(),
       revision: z.string().optional(),
       html: z.string().optional(),
     })
@@ -326,6 +333,17 @@ const sourceSchema = z.preprocess(
           message: "designId or fileId is required for design-file sources",
         });
       }
+      if (
+        source.kind === "local-file" &&
+        (!source.designId || !source.connectionId || !source.path)
+      ) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          path: ["path"],
+          message:
+            "designId, connectionId, and path are required for local-file sources",
+        });
+      }
     }),
 );
 
@@ -333,13 +351,29 @@ const targetSchema = z
   .object({
     nodeId: z.string().optional(),
     selector: z.string().optional(),
+    sourceAnchor: z
+      .object({
+        line: z.number().int().positive(),
+        column: z.number().int().positive(),
+        runtimeMultiplicity: z.number().int().positive().optional(),
+        scope: z
+          .enum([
+            "single-instance",
+            "repeated-render",
+            "shared-component-definition",
+            "unknown",
+          ])
+          .optional(),
+      })
+      .optional(),
   })
   .superRefine((target, ctx) => {
-    if (!target.nodeId && !target.selector) {
+    if (!target.nodeId && !target.selector && !target.sourceAnchor) {
       ctx.addIssue({
         code: z.ZodIssueCode.custom,
         path: ["nodeId"],
-        message: "target.nodeId or target.selector is required",
+        message:
+          "target.nodeId, target.selector, or target.sourceAnchor is required",
       });
     }
   });
@@ -589,7 +623,7 @@ async function persistDesignFileEdit(file: {
 export default defineAction({
   description:
     "Apply one deterministic visual edit to a code-backed HTML design layer. " +
-    "Supports safe inline style, class, and leaf textContent edits on inline/SQL HTML files; escalates ambiguous or structural edits with PatchResult statuses. " +
+    "Supports safe inline style, class, and leaf textContent edits on inline/SQL HTML files, plus diff-first literal leaf JSX edits on consented localhost files; escalates ambiguous, dynamic, repeated, shared, or structural JSX edits without writing. " +
     "Responsive editing (§6.4): pass activeFrameWidthPx (the active breakpoint frame width, matching the UI's breakpoint bar) to scope class AND style edits Framer-style — overrides apply below the next-wider frame and cascade down; the widest frame is the base. " +
     "Raw CSS values persist as managed @media rules (<style data-agent-native-breakpoints>); Tailwind-utility values become max-[<bound>px]: classes. " +
     "Pass activeBreakpoint to force legacy min-width prefix scoping for class edits, or maxWidthPx for an explicit desktop-down bound. Omit all three for base (global) behaviour.",
@@ -605,6 +639,13 @@ export default defineAction({
       .optional()
       .default(false)
       .describe("Include patched HTML content in the response."),
+    persist: z
+      .boolean()
+      .optional()
+      .default(false)
+      .describe(
+        "For local-file sources only, persist the proposed edit through write-local-file. Omit/false to return a proposed diff without writing. Local persistence requires the existing human write-consent grant and an exact bridge version hash.",
+      ),
     activeBreakpoint: z
       .enum(TAILWIND_PREFIXES)
       .optional()
@@ -635,6 +676,7 @@ export default defineAction({
     source,
     intent,
     includeContent,
+    persist,
     activeBreakpoint,
     activeFrameWidthPx,
     maxWidthPx,
@@ -642,6 +684,150 @@ export default defineAction({
     const actionSource = source as VisualEditActionSource;
     let editIntent = intent as EditIntent;
 
+    if (actionSource.kind === "local-file") {
+      const target =
+        "target" in editIntent
+          ? (editIntent.target as {
+              nodeId?: string;
+              selector?: string;
+              sourceAnchor?: {
+                line: number;
+                column: number;
+                runtimeMultiplicity?: number;
+                scope?:
+                  | "single-instance"
+                  | "repeated-render"
+                  | "shared-component-definition"
+                  | "unknown";
+              };
+            })
+          : undefined;
+      const sourceAnchor = target?.sourceAnchor;
+      if (
+        !actionSource.designId ||
+        !actionSource.connectionId ||
+        !actionSource.path ||
+        !sourceAnchor
+      ) {
+        return {
+          result: {
+            status: "conflict" as const,
+            changed: false,
+            message:
+              "Local visual edits require designId, connectionId, path, and an exact sourceAnchor from the live selection.",
+          },
+          persisted: false,
+        };
+      }
+      const pathSegments = actionSource.path
+        .replace(/\\/g, "/")
+        .split("/")
+        .filter(Boolean);
+      if (
+        pathSegments.some((segment) =>
+          [
+            "node_modules",
+            "dist",
+            "build",
+            "coverage",
+            ".next",
+            ".nuxt",
+            ".output",
+            "generated",
+          ].includes(segment.toLowerCase()),
+        )
+      ) {
+        return {
+          result: {
+            status: "unsupported" as const,
+            changed: false,
+            message:
+              "Generated and dependency output files are not eligible for deterministic visual write-back.",
+          },
+          persisted: false,
+        };
+      }
+      if (
+        editIntent.kind !== "textContent" &&
+        editIntent.kind !== "class" &&
+        editIntent.kind !== "style"
+      ) {
+        return {
+          result: {
+            status: "needsAgent" as const,
+            changed: false,
+            message:
+              "Structural and semantic JSX edits require coding-agent inspection and are never written by the deterministic local-file path.",
+          },
+          persisted: false,
+        };
+      }
+      if (
+        activeBreakpoint != null ||
+        activeFrameWidthPx != null ||
+        maxWidthPx != null
+      ) {
+        return {
+          result: {
+            status: "needsAgent" as const,
+            changed: false,
+            message:
+              "Breakpoint-scoped localhost JSX edits require semantic source inspection in this first deterministic slice.",
+          },
+          persisted: false,
+        };
+      }
+
+      const read = await readLocalFileAction.run({
+        designId: actionSource.designId,
+        connectionId: actionSource.connectionId,
+        path: actionSource.path,
+      });
+      if (!read.versionHash) {
+        throw new Error(
+          "The local bridge did not return a version hash; no source was written.",
+        );
+      }
+      const planned = planLocalJsxVisualEdit({
+        content: read.content,
+        anchor: sourceAnchor,
+        intent: editIntent as LocalJsxLeafIntent,
+      });
+      let persisted = false;
+      let versionHash = read.versionHash;
+      if (
+        persist &&
+        planned.result.status === "applied" &&
+        planned.result.changed
+      ) {
+        const write = await writeLocalFileAction.run({
+          designId: actionSource.designId,
+          connectionId: actionSource.connectionId,
+          relPath: actionSource.path,
+          content: planned.content,
+          expectedVersionHash: read.versionHash,
+          requireExpectedVersionHash: true,
+        });
+        persisted = write.written;
+        versionHash = write.versionHash ?? versionHash;
+      }
+      return {
+        result: planned.result,
+        source: {
+          kind: "local-file" as const,
+          path: actionSource.path,
+          connectionId: actionSource.connectionId,
+        },
+        proposedDiff: planned.proposedDiff,
+        currentVersionHash: read.versionHash,
+        versionHash,
+        persisted,
+        patchedContent: includeContent ? planned.content : undefined,
+        bytesBefore: read.content.length,
+        bytesAfter: planned.content.length,
+      };
+    }
+
     // Breakpoint scoping precedence (§6.4):
     //
     // 1. Explicit `maxWidthPx` param → Framer desktop-down scope for `class`
@@ -698,9 +884,8 @@ export default defineAction({
       const patch = applyVisualEdit("", editIntent, {
         source: codeLayerSource,
       });
-      // local-file / remote-url sources are not editable here (the engine
-      // reports "unsupported"), so no byte counts are returned — a 0/0 pair
-      // would misleadingly suggest an empty file was measured.
+      // remote-url sources stay preview-only/unsupported. A 0/0 byte count
+      // would misleadingly suggest that an empty remote file was measured.
       return {
         result: patch.result,
         projection: patch.projection,

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

@@ -65,23 +65,11 @@ export default defineAction({
 
     // Copy the design with remapped canvasFrames
     const orgId = getRequestOrgId() || null;
-    await db.insert(schema.designs).values({
-      id: newId,
-      title: newTitle,
-      description: source.description,
-      projectType: source.projectType,
-      designSystemId: source.designSystemId ?? null,
-      data: newData,
-      ownerEmail: (() => {
-        const e = getRequestUserEmail();
-        if (!e) throw new Error("no authenticated user");
-        return e;
-      })(),
-      orgId,
-      visibility: orgId ? "org" : "private",
-      createdAt: now,
-      updatedAt: now,
-    });
+    const ownerEmail = (() => {
+      const e = getRequestUserEmail();
+      if (!e) throw new Error("no authenticated user");
+      return e;
+    })();
 
     // Copy all associated files using the pre-generated IDs. `content` is
     // copied verbatim, including any `data-agent-native-node-id` attributes
@@ -112,17 +100,35 @@ export default defineAction({
     // generated/imported before ids were stamped at creation time): this only
     // adds ids where none exist and never touches an id that's already
     // present, so it can't disturb the existing-id-copy contract above.
-    for (const file of files) {
-      await db.insert(schema.designFiles).values({
-        id: idMap.get(file.id)!,
-        designId: newId,
-        filename: file.filename,
-        fileType: file.fileType,
-        content: annotateScreenHtmlForPersist(file.content, file.fileType),
+    await db.transaction(async (tx) => {
+      await tx.insert(schema.designs).values({
+        id: newId,
+        title: newTitle,
+        description: source.description,
+        projectType: source.projectType,
+        designSystemId: source.designSystemId ?? null,
+        data: newData,
+        ownerEmail,
+        orgId,
+        visibility: orgId ? "org" : "private",
         createdAt: now,
         updatedAt: now,
       });
-    }
+
+      if (files.length > 0) {
+        await tx.insert(schema.designFiles).values(
+          files.map((file) => ({
+            id: idMap.get(file.id)!,
+            designId: newId,
+            filename: file.filename,
+            fileType: file.fileType,
+            content: annotateScreenHtmlForPersist(file.content, file.fileType),
+            createdAt: now,
+            updatedAt: now,
+          })),
+        );
+      }
+    });
 
     return {
       id: newId,

package/corpus/templates/design/app/pages/design-editor/pending-edits.ts

@@ -474,6 +474,7 @@ export function formatPendingVisualStylePrompt(args: {
   designTitle?: string | null;
   activeFileId?: string | null;
   activeFilename?: string | null;
+  localhostConnectionId?: string | null;
   edits: readonly PendingVisualStyleEdit[];
   liveEdits?: readonly PendingLiveNonStyleEdit[];
 }): string {
@@ -595,10 +596,13 @@ export function formatPendingVisualStylePrompt(args: {
     args.activeFileId
       ? `Active screen: "${args.activeFilename ?? args.activeFileId}" (${args.activeFileId}).`
       : "",
+    args.localhostConnectionId
+      ? `Active localhost connection id: "${args.localhostConnectionId}".`
+      : "",
     "",
     "Use the Design source tools to make the source match the current live canvas preview. Read each target screen, resolve source ids/selectors through the code-layer projection, then apply the style, text, and structure changes with focused source edits. Preserve layout, behavior, and unrelated styling.",
     hasReactSourceAnchors
-      ? "React sourceAnchor fields are source provenance; runtime source ids and selectors are correlation hints only. Verify every project-relative file, line, column, component, and surrounding control flow before editing. Never use a generic AST reparent, group, wrapper, or other structural transform. For semantic structure edits, follow the embedded semanticHandoff packet and use this exact guarded sequence: read-local-file, capture its versionHash, obtain human write consent, write-local-file with expectedVersionHash and requireExpectedVersionHash: true, then keep the preview pending until HMR proves the intended runtime relationship. On a version conflict, re-read and re-plan; never overwrite blindly."
+      ? "React sourceAnchor fields are source provenance; runtime source ids and selectors are correlation hints only. For a single-instance leaf text, literal className/class, or flat literal style-object edit, call apply-visual-edit with source.kind=local-file plus designId, connectionId, the verified project-relative path, and target.sourceAnchor. First omit persist and inspect proposedDiff; then retry with persist=true only when the diff matches the preview. That write still requires human localhost consent and exact version-hash concurrency. Verify every file, line, column, component, and surrounding control flow before editing. Never use a generic AST reparent, group, wrapper, breakpoint, dynamic expression, repeated render, or shared component transform through this path. For semantic structure edits, follow the embedded semanticHandoff packet and use this exact guarded sequence: read-local-file, capture its versionHash, obtain human write consent, write-local-file with expectedVersionHash and requireExpectedVersionHash: true, then keep the preview pending until HMR proves the intended runtime relationship. On a version conflict, re-read and re-plan; never overwrite blindly."
       : "",
     hasRepeatedOrSharedReactScope
       ? "At least one React anchor is repeated at runtime or resolves to a shared component definition. Inspect map/conditional/component call sites and confirm whether the change should affect one instance or every instance before writing source."

package/corpus/templates/design/changelog/2026-07-10-duplicating-a-design-can-no-longer-produce-a-copy-with-missi.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-10
+---
+
+Duplicating a design can no longer produce a copy with missing screens if something fails mid-copy

package/corpus/templates/design/changelog/2026-07-10-local-visual-edits-can-now-save-safe-leaf-text-class-and.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-10
+---
+
+Local visual edits can now preview and save safe leaf text, class, and style changes directly to connected React source files.

package/corpus/templates/design/package.json

@@ -28,7 +28,7 @@
     "drizzle-orm": "^0.45.2",
     "entities": "8.0.0",
     "fzstd": "^0.1.1",
-    "h3": "^2.0.1-rc.20",
+    "h3": "catalog:",
     "html2canvas": "^1.4.1",
     "isbot": "^5",
     "jspdf": "^4.2.1",