@agent-native/core 0.129.1 → 0.130.0

package/corpus/templates/design/.generated/bridge/embedded-wheel.generated.ts

@@ -206,6 +206,9 @@ export const embeddedWheelBridgeScript: string = `"use strict";
       if (e.data.type === "embedded-canvas-gesture-mode") {
         wheelEnabled = !!e.data.wheelEnabled;
         spaceKeyForwardingEnabled = !!e.data.spaceKeyForwardingEnabled;
+        if (typeof e.data.editingSafetyEnabled === "boolean") {
+          editingSafetyEnabled = e.data.editingSafetyEnabled;
+        }
       }
     }
     function cancelActivePan() {

package/corpus/templates/design/.generated/bridge/hit-test.generated.ts

@@ -401,7 +401,24 @@ export const hitTestBridgeScript: string = `"use strict";
         }
         cursor = parent;
       }
-      return absolutePrimitiveContainerTargetForPoint(clientX, clientY);
+      var absoluteTarget = absolutePrimitiveContainerTargetForPoint(
+        clientX,
+        clientY
+      );
+      if (absoluteTarget) return absoluteTarget;
+      var blockCursor = hit;
+      while (blockCursor) {
+        if (isContainerDropTarget(blockCursor)) {
+          return {
+            anchor: blockCursor,
+            placement: "inside",
+            axis: "y",
+            dropMode: "flow-insert"
+          };
+        }
+        blockCursor = blockCursor.parentElement;
+      }
+      return null;
     }
     function showInsertionGuideFor(target) {
       if (!target || !target.anchor) {

package/corpus/templates/design/.generated/bridge/source-location.generated.ts

@@ -0,0 +1,348 @@
+// AUTO-GENERATED by bridge/codegen.ts — do not edit manually.
+// Run: pnpm exec tsx app/components/design/bridge/codegen.ts
+
+/** Compiled IIFE string for source-location.bridge.ts — inject into an iframe via srcdoc or a <script> tag. */
+export const sourceLocationBridgeScript: string = `"use strict";
+(() => {
+  // app/components/design/bridge/source-location.bridge.ts
+  (function() {
+    var FIBER_KEY_PREFIXES = [
+      "__reactFiber$",
+      "__reactInternalInstance$",
+      "__reactInternalFiberCurrent$",
+      "__reactInternalFiber$"
+    ];
+    var NOISE_SEGMENTS = {
+      node_modules: true,
+      dist: true,
+      build: true,
+      ".next": true,
+      public: true
+    };
+    function isNoisePath(path) {
+      var segments = path.split("/");
+      for (var i = 0; i < segments.length; i += 1) {
+        if (NOISE_SEGMENTS[segments[i]]) return true;
+        if (segments[i] === "_next" && segments[i + 1] === "static") return true;
+      }
+      return false;
+    }
+    function resolveFrameUrl(rawUrl) {
+      if (rawUrl.indexOf("webpack-internal:///") === 0) {
+        var wPath = rawUrl.slice("webpack-internal:///".length).replace(/^\\.\\//, "");
+        return wPath || null;
+      }
+      try {
+        var url = new URL(rawUrl);
+        var path = decodeURIComponent(url.pathname);
+        if (path.indexOf("/@fs/") === 0) {
+          path = path.slice("/@fs".length);
+        } else if (url.protocol !== "file:") {
+          path = path.replace(/^\\/+/, "");
+        }
+        return path || null;
+      } catch (_err) {
+        return null;
+      }
+    }
+    var STACK_FRAME_RE = /^\\s*at\\s+(?:([^\\s(]+)\\s+\\()?([^()\\s][^()]*?):(\\d+):(\\d+)\\)?\\s*$/;
+    function parseStackFrame(line) {
+      var match = STACK_FRAME_RE.exec(line);
+      if (!match) return null;
+      var functionName = match[1];
+      var rawUrl = match[2];
+      var sourceFile = resolveFrameUrl(rawUrl);
+      if (!sourceFile || isNoisePath(sourceFile)) return null;
+      var lineNumber = Number(match[3]);
+      var column = Number(match[4]);
+      if (!isFinite(lineNumber) || !isFinite(column)) return null;
+      return {
+        sourceFile,
+        line: lineNumber,
+        column,
+        functionName: functionName || void 0
+      };
+    }
+    function extractFromDebugStack(stack) {
+      var lines = stack.split("\\n");
+      for (var i = 0; i < lines.length; i += 1) {
+        var parsed = parseStackFrame(lines[i]);
+        if (parsed) return parsed;
+      }
+      return null;
+    }
+    function getFiberFromDom(node) {
+      var keys = Object.keys(node);
+      for (var i = 0; i < keys.length; i += 1) {
+        for (var j = 0; j < FIBER_KEY_PREFIXES.length; j += 1) {
+          if (keys[i].indexOf(FIBER_KEY_PREFIXES[j]) === 0) {
+            return node[keys[i]];
+          }
+        }
+      }
+      return null;
+    }
+    function findNearestFiber(el) {
+      var node = el;
+      var attempts = 0;
+      while (node && attempts < 8) {
+        var fiber = getFiberFromDom(node);
+        if (fiber) return fiber;
+        node = node.parentElement;
+        attempts += 1;
+      }
+      return null;
+    }
+    function debugSourceOf(fiber) {
+      var source = fiber._debugSource || fiber._debugInfo && fiber._debugInfo.source || fiber.stateNode && fiber.stateNode._debugSource || fiber.elementType && fiber.elementType._debugSource;
+      if (source && source.fileName) {
+        return {
+          sourceFile: source.fileName,
+          line: source.lineNumber,
+          column: source.columnNumber
+        };
+      }
+      var stack = fiber._debugStack && fiber._debugStack.stack || fiber._debugInfo && fiber._debugInfo.stack || fiber.stateNode && fiber.stateNode._debugStack && fiber.stateNode._debugStack.stack;
+      if (stack) {
+        var parsed = extractFromDebugStack(String(stack));
+        if (parsed) {
+          return {
+            sourceFile: parsed.sourceFile,
+            line: parsed.line,
+            column: parsed.column
+          };
+        }
+      }
+      return null;
+    }
+    function hasStructuredDebugSource(fiber) {
+      return !!(fiber._debugSource || fiber._debugInfo && fiber._debugInfo.source || fiber.stateNode && fiber.stateNode._debugSource || fiber.elementType && fiber.elementType._debugSource);
+    }
+    function isComponentFiber(fiber) {
+      return typeof fiber.type === "function";
+    }
+    function componentNameOf(fiber) {
+      var type = fiber.type;
+      return type && (type.displayName || type.name) || void 0;
+    }
+    function resolveFromDataAttributes(el) {
+      var sourceFile = el.getAttribute("data-source-file");
+      var lineAttr = el.getAttribute("data-source-line");
+      var columnAttr = el.getAttribute("data-source-column");
+      var component = el.getAttribute("data-component-name");
+      var dataLoc = el.getAttribute("data-loc");
+      if (!sourceFile && dataLoc) {
+        var lastColon = dataLoc.lastIndexOf(":");
+        var lastPart = lastColon >= 0 ? dataLoc.slice(lastColon + 1) : "";
+        if (lastColon >= 0 && /^\\d+$/.test(lastPart)) {
+          var before = dataLoc.slice(0, lastColon);
+          var prevColon = before.lastIndexOf(":");
+          var prevPart = prevColon >= 0 ? before.slice(prevColon + 1) : "";
+          var hasColumn = /^\\d+$/.test(prevPart);
+          sourceFile = hasColumn ? before.slice(0, prevColon) : before;
+          lineAttr = hasColumn ? prevPart : lastPart;
+          columnAttr = hasColumn ? lastPart : columnAttr;
+        }
+      }
+      if (!sourceFile || !lineAttr) return null;
+      var line = Number(lineAttr);
+      if (!isFinite(line)) return null;
+      var column = columnAttr ? Number(columnAttr) : void 0;
+      return {
+        status: "resolved",
+        framework: "html",
+        method: "data-attribute",
+        sourceFile,
+        line,
+        column: isFinite(column) ? column : void 0,
+        componentName: component || void 0
+      };
+    }
+    function resolveFromFiber(el) {
+      var leafFiber = findNearestFiber(el);
+      if (!leafFiber) return { status: "unavailable", reason: "not-framework" };
+      var elementSource = null;
+      var elementMethod = null;
+      var componentFiber = null;
+      var current = leafFiber;
+      var depth = 0;
+      while (current && depth < 12) {
+        if (!elementSource) {
+          var hasStructured = hasStructuredDebugSource(current);
+          var found = debugSourceOf(current);
+          if (found) {
+            elementSource = found;
+            elementMethod = hasStructured ? "debug-source" : "debug-stack";
+          }
+        }
+        if (!componentFiber && current !== leafFiber && isComponentFiber(current)) {
+          componentFiber = current;
+        }
+        if (elementSource && componentFiber) break;
+        current = current.return || current.parent || current._debugOwner;
+        depth += 1;
+      }
+      if (!elementSource || !elementMethod) {
+        return { status: "unavailable", reason: "no-debug-info" };
+      }
+      var result = {
+        status: "resolved",
+        framework: "react",
+        method: elementMethod,
+        sourceFile: elementSource.sourceFile,
+        line: elementSource.line,
+        column: elementSource.column
+      };
+      if (componentFiber) {
+        result.componentName = componentNameOf(componentFiber);
+        var ownerSource = debugSourceOf(componentFiber);
+        if (ownerSource) {
+          result.ownerSourceFile = ownerSource.sourceFile;
+          result.ownerLine = ownerSource.line;
+          result.ownerColumn = ownerSource.column;
+          result.ownerComponentName = result.componentName;
+          result.ownerMethod = hasStructuredDebugSource(componentFiber) ? "debug-source" : "debug-stack";
+        }
+        if (typeof componentFiber.key === "string" && componentFiber.key) {
+          result.ownerKey = componentFiber.key;
+        }
+      }
+      return result;
+    }
+    function parseFrameworkDataLoc(value) {
+      var lastColon = value.lastIndexOf(":");
+      if (lastColon < 0) return null;
+      var lastPart = value.slice(lastColon + 1);
+      if (!/^\\d+$/.test(lastPart)) return null;
+      var beforeLast = value.slice(0, lastColon);
+      var previousColon = beforeLast.lastIndexOf(":");
+      var previousPart = previousColon >= 0 ? beforeLast.slice(previousColon + 1) : "";
+      var hasColumn = /^\\d+$/.test(previousPart);
+      var sourceFile = (hasColumn ? beforeLast.slice(0, previousColon) : beforeLast).trim();
+      var line = Number(hasColumn ? previousPart : lastPart);
+      var column = hasColumn ? Number(lastPart) : void 0;
+      if (!sourceFile || !isFinite(line)) return null;
+      if (column !== void 0 && !isFinite(column)) return null;
+      return { sourceFile, line, column };
+    }
+    function resolveFromVue(el) {
+      var node = el;
+      var sawVue = false;
+      for (var depth = 0; node && depth < 8; depth += 1) {
+        var vnode = node.__vnode;
+        var component = node.__vueParentComponent;
+        if (vnode || component) sawVue = true;
+        var inspector = vnode && vnode.props && typeof vnode.props.__v_inspector === "string" ? vnode.props.__v_inspector : null;
+        if (inspector) {
+          var parsed = parseFrameworkDataLoc(inspector);
+          if (parsed) {
+            var type = component && component.type || vnode && vnode.type;
+            return {
+              status: "resolved",
+              framework: "vue",
+              method: "vue-inspector",
+              sourceFile: parsed.sourceFile,
+              line: parsed.line,
+              column: parsed.column,
+              componentName: type && (type.name || type.__name || type.displayName)
+            };
+          }
+        }
+        node = node.parentElement;
+      }
+      return sawVue ? { status: "unavailable", reason: "no-debug-info" } : null;
+    }
+    function resolveFromSvelte(el) {
+      var node = el;
+      var sawSvelte = false;
+      for (var depth = 0; node && depth < 8; depth += 1) {
+        var meta = node.__svelte_meta;
+        if (meta) sawSvelte = true;
+        var loc = meta && meta.loc;
+        var sourceFile = loc && (loc.file || loc.filename);
+        var line = loc && Number(loc.line);
+        var column = loc && Number(loc.column);
+        if (sourceFile && isFinite(line)) {
+          return {
+            status: "resolved",
+            framework: "svelte",
+            method: "svelte-meta",
+            sourceFile: String(sourceFile),
+            line,
+            column: isFinite(column) ? column : void 0,
+            componentName: typeof meta.component === "string" ? meta.component : typeof meta.name === "string" ? meta.name : void 0
+          };
+        }
+        node = node.parentElement;
+      }
+      return sawSvelte ? { status: "unavailable", reason: "no-debug-info" } : null;
+    }
+    function resolveFromFramework(el) {
+      var react = resolveFromFiber(el);
+      if (react.status === "resolved" || react.reason === "no-debug-info") {
+        return react;
+      }
+      var vue = resolveFromVue(el);
+      if (vue) return vue;
+      var svelte = resolveFromSvelte(el);
+      if (svelte) return svelte;
+      return { status: "unavailable", reason: "not-framework" };
+    }
+    function resolveSourceLocation(el) {
+      var fromAttributes = resolveFromDataAttributes(el);
+      if (!fromAttributes) return resolveFromFramework(el);
+      var fromFiber = resolveFromFiber(el);
+      if (fromAttributes.status === "resolved" && fromFiber.status === "resolved") {
+        if (fromFiber.ownerSourceFile) {
+          fromAttributes.ownerSourceFile = fromFiber.ownerSourceFile;
+          fromAttributes.ownerLine = fromFiber.ownerLine;
+          fromAttributes.ownerColumn = fromFiber.ownerColumn;
+          fromAttributes.ownerComponentName = fromFiber.ownerComponentName;
+          fromAttributes.ownerMethod = fromFiber.ownerMethod;
+        }
+        if (fromFiber.ownerKey) fromAttributes.ownerKey = fromFiber.ownerKey;
+        if (!fromAttributes.componentName) {
+          fromAttributes.componentName = fromFiber.componentName;
+        }
+        fromAttributes.framework = fromFiber.framework;
+      }
+      return fromAttributes;
+    }
+    function findTarget(nodeId, selector) {
+      if (nodeId) {
+        var byId = document.querySelector(
+          '[data-agent-native-node-id="' + nodeId.replace(/"/g, '\\\\"') + '"]'
+        );
+        if (byId) return byId;
+      }
+      if (selector) {
+        try {
+          return document.querySelector(selector);
+        } catch (_err) {
+          return null;
+        }
+      }
+      return null;
+    }
+    window.addEventListener("message", function(e) {
+      if (e.source !== window.parent) return;
+      if (!e.data || e.data.type !== "agent-native:source-location-request")
+        return;
+      var correlationId = e.data.correlationId || "";
+      var target = findTarget(e.data.nodeId, e.data.selector);
+      var result = target ? resolveSourceLocation(target) : { status: "unavailable", reason: "element-not-found" };
+      try {
+        window.parent.postMessage(
+          {
+            type: "agent-native:source-location-result",
+            correlationId,
+            result
+          },
+          "*"
+        );
+      } catch (_err) {
+      }
+    });
+  })();
+})();
+`;

package/corpus/templates/design/actions/add-localhost-screens.ts

@@ -5,10 +5,6 @@ import {
   seedFromText,
 } from "@agent-native/core/collab";
 import { buildDeepLink } from "@agent-native/core/server";
-import {
-  getRequestOrgId,
-  getRequestUserEmail,
-} from "@agent-native/core/server/request-context";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, desc, eq, isNull } from "drizzle-orm";
 import { nanoid } from "nanoid";
@@ -19,6 +15,7 @@ import {
   mutateDesignData,
   type DesignDataRecord,
 } from "../server/lib/design-data-mutation.js";
+import { resolveLocalhostConnectionScope } from "../server/lib/localhost-connection.js";
 import {
   mergeCanvasFramePlacements,
   parseCanvasFrameGeometryById,
@@ -366,9 +363,7 @@ export default defineAction({
     gap,
   }) => {
     await assertAccess("design", designId, "editor");
-    const ownerEmail = getRequestUserEmail();
-    if (!ownerEmail) throw new Error("no authenticated user");
-    const orgId = getRequestOrgId() ?? null;
+    const { ownerEmail, orgId } = await resolveLocalhostConnectionScope();
     const db = getDb();
 
     const connectionClauses = [

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

@@ -355,6 +355,11 @@ const targetSchema = z
       .object({
         line: z.number().int().positive(),
         column: z.number().int().positive(),
+        // Without this the deterministic writer cannot tell a React 19
+        // owner-stack line from an authored one and would seek to it.
+        positionPrecision: z
+          .enum(["authored", "transformed", "unknown"])
+          .optional(),
         runtimeMultiplicity: z.number().int().positive().optional(),
         scope: z
           .enum([
@@ -693,6 +698,7 @@ export default defineAction({
               sourceAnchor?: {
                 line: number;
                 column: number;
+                positionPrecision?: "authored" | "transformed" | "unknown";
                 runtimeMultiplicity?: number;
                 scope?:
                   | "single-instance"
@@ -714,7 +720,7 @@ export default defineAction({
             status: "conflict" as const,
             changed: false,
             message:
-              "Local visual edits require designId, connectionId, path, and an exact sourceAnchor from the live selection.",
+              "Local visual edits require designId, connectionId, path, and a complete sourceAnchor from the live selection.",
           },
           persisted: false,
         };

package/corpus/templates/design/actions/connect-localhost.ts

@@ -1,14 +1,11 @@
 import crypto from "node:crypto";
 
 import { defineAction } from "@agent-native/core";
-import {
-  getRequestOrgId,
-  getRequestUserEmail,
-} from "@agent-native/core/server/request-context";
 import { and, eq, isNull, sql } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { resolveLocalhostConnectionScope } from "../server/lib/localhost-connection.js";
 import {
   DESIGN_BRIDGE_OPERATIONS,
   makeLocalhostRouteId,
@@ -156,9 +153,7 @@ export default defineAction({
       .default("connected"),
   }),
   run: async (args) => {
-    const ownerEmail = getRequestUserEmail();
-    if (!ownerEmail) throw new Error("no authenticated user");
-    const orgId = getRequestOrgId() ?? null;
+    const { ownerEmail, orgId } = await resolveLocalhostConnectionScope();
 
     const now = new Date().toISOString();
     const db = getDb();
@@ -231,8 +226,9 @@ export default defineAction({
       );
     }
 
-    // Token for a new row: explicit, else existing, else mint. The authenticated
-    // action owning the mint is what lets the CLI skip its own auth (the 401 gap).
+    // Token for a new row: explicit, else existing, else mint. The account or
+    // trusted local-CLI principal owning the row is what lets the bridge skip a
+    // separate browser sign-in without making the token ambient.
     const explicitToken = args.bridgeToken?.trim() || undefined;
     const nextBridgeToken =
       explicitToken ||

package/corpus/templates/design/actions/create-component.ts

@@ -45,7 +45,7 @@ import {
   type SourceWorkspaceFile,
 } from "../server/source-workspace.js";
 import { resolveSourceCapabilities } from "../shared/capability-resolver.js";
-import { buildCodeLayerProjection } from "../shared/code-layer.js";
+import { resolveCodeLayerTarget } from "../shared/code-layer.js";
 import type { CodeLayerNode, CodeLayerSource } from "../shared/code-layer.js";
 import { agentSelectionDescriptor } from "../shared/collab-selection.js";
 import {
@@ -333,22 +333,25 @@ export default defineAction({
       filename: file.filename,
     };
 
-    const projection = buildCodeLayerProjection(html, {
-      source: codeLayerSource,
-    });
-
-    const node = nodeId
-      ? projection.nodes.find((n) => n.id === nodeId)
-      : projection.nodes.find(
-          (n) =>
-            n.selector === selector || n.selectors.includes(selector ?? ""),
-        );
+    // The shared resolver, not a local `.find()`: it refuses an ambiguous match
+    // instead of annotating whichever repeated instance came first, and names
+    // the count. The old "Element not found" read the same whether the target
+    // was absent, ambiguous, or never supplied.
+    const { projection, resolution } = resolveCodeLayerTarget(
+      html,
+      { nodeId, selector },
+      { source: codeLayerSource },
+    );
 
-    if (!node) {
+    if (resolution.status !== "resolved" || !resolution.node) {
       throw new Error(
-        `Element not found. Run get-code-layer-projection to list current node ids and selectors.`,
+        `${resolution.message ?? "Target did not resolve to a single code layer node."} ` +
+          `Searched ${projection.nodes.length} projection nodes for ` +
+          `${nodeId ? `nodeId "${nodeId}"` : `selector "${selector ?? ""}"`}. ` +
+          `Run get-code-layer-projection to list current node ids and selectors.`,
       );
     }
+    const node = resolution.node;
 
     // ── Build annotations ─────────────────────────────────────────────────────
     const componentName = normalizeComponentName(name);

package/corpus/templates/design/actions/grant-localhost-write-consent.ts

@@ -1,14 +1,11 @@
 import { defineAction } from "@agent-native/core";
-import {
-  getRequestOrgId,
-  getRequestUserEmail,
-} from "@agent-native/core/server/request-context";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq, isNull } from "drizzle-orm";
 import { nanoid } from "nanoid";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { resolveLocalhostConnectionScope } from "../server/lib/localhost-connection.js";
 
 /** Grant expiry: 8 hours from mint time. */
 const GRANT_TTL_MS = 8 * 60 * 60 * 1000;
@@ -40,9 +37,7 @@ export default defineAction({
   run: async ({ designId, connectionId }) => {
     await assertAccess("design", designId, "editor");
 
-    const ownerEmail = getRequestUserEmail();
-    if (!ownerEmail) throw new Error("no authenticated user");
-    const orgId = getRequestOrgId() ?? null;
+    const { ownerEmail, orgId } = await resolveLocalhostConnectionScope();
 
     const db = getDb();
 

package/corpus/templates/design/actions/list-design-source-capabilities.ts

@@ -1,13 +1,11 @@
 import { defineAction } from "@agent-native/core";
-import {
-  getRequestOrgId,
-  getRequestUserEmail,
-} from "@agent-native/core/server/request-context";
+import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { resolveAccess } from "@agent-native/core/sharing";
 import { and, eq, isNull } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { resolveLocalhostConnectionScope } from "../server/lib/localhost-connection.js";
 import { resolveSourceCapabilities } from "../shared/capability-resolver.js";
 import { DESIGN_CAPABILITY_NAMES } from "../shared/design-source-capabilities.js";
 import "../server/db/index.js"; // ensure registerShareableResource runs
@@ -57,9 +55,8 @@ export default defineAction({
           typeof rawData === "string" ? JSON.parse(rawData) : {};
         const connectionId = designConnectionIdFromData(rawDesignData);
 
-        const ownerEmail = getRequestUserEmail();
-        const orgId = getRequestOrgId() ?? null;
-        if (connectionId && ownerEmail) {
+        if (connectionId && getRequestUserEmail()) {
+          const { ownerEmail, orgId } = await resolveLocalhostConnectionScope();
           const [conn] = await db
             .select({
               capabilities: schema.designLocalhostConnections.capabilities,