@agent-native/core 0.84.29 → 0.84.32

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

@@ -0,0 +1,85 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import {
+  findSourceWorkspaceFile,
+  readLiveSourceFile,
+  resolveSourceWorkspace,
+} from "../server/source-workspace.js";
+import {
+  applySourceEdit,
+  previewSourceDiff,
+} from "../shared/source-workspace.js";
+
+const sourceEditSchema = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("full-replace"),
+    content: z.string().describe("Complete replacement file content"),
+  }),
+  z.object({
+    kind: z.literal("exact-replace"),
+    search: z.string().min(1).describe("Unique exact text to replace"),
+    replace: z.string().describe("Replacement text"),
+  }),
+]);
+
+export default defineAction({
+  description:
+    "Preview a source-file edit without saving it. Returns changed byte counts, " +
+    "line range, and compact before/after excerpts for Design code workspace diffs.",
+  schema: z
+    .object({
+      designId: z.string().describe("Design project ID"),
+      path: z
+        .string()
+        .optional()
+        .describe("Source path/filename, such as index.html"),
+      fileId: z.string().optional().describe("Design file ID"),
+      edit: sourceEditSchema,
+      expectedVersionHash: z
+        .string()
+        .optional()
+        .describe("Optional hash from read-source-file to detect stale edits"),
+    })
+    .refine((args) => args.path || args.fileId, {
+      message: "Provide either path or fileId.",
+      path: ["path"],
+    }),
+  readOnly: true,
+  run: async ({ designId, path, fileId, edit, expectedVersionHash }) => {
+    const workspace = await resolveSourceWorkspace(designId, {
+      includeContent: true,
+    });
+    const file = findSourceWorkspaceFile(workspace.files, { fileId, path });
+    const live = await readLiveSourceFile(file);
+    const stale =
+      expectedVersionHash !== undefined &&
+      expectedVersionHash !== live.versionHash;
+    if (stale) {
+      return {
+        designId,
+        path: file.filename,
+        fileId: file.id,
+        okToApply: false,
+        conflict: "stale-version",
+        currentVersionHash: live.versionHash,
+        message:
+          "Source file changed since it was read. Re-read before saving.",
+      };
+    }
+
+    const next = applySourceEdit(live.content, edit);
+    return {
+      designId,
+      path: file.filename,
+      fileId: file.id,
+      okToApply: workspace.canEdit && workspace.sourceType === "inline",
+      conflict:
+        workspace.sourceType === "inline" ? null : "unsupported-source-backend",
+      currentVersionHash: live.versionHash,
+      nextVersionHash: next.changed ? undefined : live.versionHash,
+      editsApplied: next.editsApplied,
+      diff: previewSourceDiff(live.content, next.content),
+    };
+  },
+});

package/corpus/templates/design/actions/read-source-file.ts

@@ -0,0 +1,55 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import {
+  findSourceWorkspaceFile,
+  readLiveSourceFile,
+  resolveSourceWorkspace,
+} from "../server/source-workspace.js";
+
+export default defineAction({
+  description:
+    "Read one Design source file. For inline designs this returns live " +
+    "design_files content with a version hash for safe follow-up writes.",
+  schema: z
+    .object({
+      designId: z.string().describe("Design project ID"),
+      path: z
+        .string()
+        .optional()
+        .describe("Source path/filename, such as index.html"),
+      fileId: z.string().optional().describe("Design file ID"),
+    })
+    .refine((args) => args.path || args.fileId, {
+      message: "Provide either path or fileId.",
+      path: ["path"],
+    }),
+  readOnly: true,
+  http: { method: "GET" },
+  run: async ({ designId, path, fileId }) => {
+    const workspace = await resolveSourceWorkspace(designId, {
+      includeContent: true,
+    });
+    const file = findSourceWorkspaceFile(workspace.files, { fileId, path });
+    const live = await readLiveSourceFile(file);
+    return {
+      designId,
+      path: file.filename,
+      displayName: file.filename,
+      fileId: file.id,
+      sourceType: workspace.sourceType,
+      backendKind: "virtual-inline",
+      readonly: !workspace.canEdit || workspace.sourceType !== "inline",
+      language: live.language,
+      content: live.content,
+      versionHash: live.versionHash,
+      updatedAt: file.updatedAt,
+      provenance: {
+        kind: "design-file",
+        designId,
+        fileId: file.id,
+        filename: file.filename,
+      },
+    };
+  },
+});

package/corpus/templates/design/actions/resolve-selection-source.ts

@@ -0,0 +1,101 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import {
+  findSourceWorkspaceFile,
+  readLiveSourceFile,
+  resolveSourceWorkspace,
+} from "../server/source-workspace.js";
+import { buildCodeLayerProjection } from "../shared/code-layer.js";
+
+function offsetToLineColumn(content: string, offset: number) {
+  let line = 1;
+  let column = 1;
+  for (let index = 0; index < offset; index += 1) {
+    if (content.charCodeAt(index) === 10) {
+      line += 1;
+      column = 1;
+    } else {
+      column += 1;
+    }
+  }
+  return { line, column };
+}
+
+export default defineAction({
+  description:
+    "Resolve a selected Design canvas node to the best source file location. " +
+    "Inline designs resolve to the containing design file and, when possible, " +
+    "a line/column/snippet from the code-layer projection.",
+  schema: z
+    .object({
+      designId: z.string().describe("Design project ID"),
+      path: z
+        .string()
+        .optional()
+        .describe("Source path/filename, such as index.html"),
+      fileId: z.string().optional().describe("Design file ID"),
+      nodeId: z
+        .string()
+        .optional()
+        .describe("data-agent-native-node-id or code-layer node id"),
+      selector: z.string().optional().describe("CSS selector fallback"),
+    })
+    .refine((args) => args.path || args.fileId, {
+      message: "Provide either path or fileId.",
+      path: ["path"],
+    }),
+  readOnly: true,
+  http: { method: "GET" },
+  run: async ({ designId, path, fileId, nodeId, selector }) => {
+    const workspace = await resolveSourceWorkspace(designId, {
+      includeContent: true,
+    });
+    const file = findSourceWorkspaceFile(workspace.files, { fileId, path });
+    const live = await readLiveSourceFile(file);
+    const projection = buildCodeLayerProjection(live.content, {
+      source: {
+        kind: "design-file",
+        designId,
+        fileId: file.id,
+        filename: file.filename,
+      },
+    });
+    const node =
+      projection.nodes.find(
+        (candidate) =>
+          candidate.id === nodeId ||
+          candidate.dataAttributes["data-agent-native-node-id"] === nodeId ||
+          candidate.dataAttributes["data-code-layer-id"] === nodeId,
+      ) ??
+      projection.nodes.find((candidate) =>
+        selector
+          ? candidate.selector === selector ||
+            candidate.path === selector ||
+            candidate.selectors.includes(selector)
+          : false,
+      );
+
+    const start = node?.source?.openStart ?? node?.source?.start;
+    const location =
+      typeof start === "number"
+        ? offsetToLineColumn(live.content, start)
+        : null;
+    const snippet =
+      node?.source && typeof node.source.start === "number"
+        ? live.content.slice(node.source.start, node.source.end).slice(0, 1200)
+        : undefined;
+
+    return {
+      designId,
+      sourceType: workspace.sourceType,
+      backendKind: "virtual-inline",
+      path: file.filename,
+      fileId: file.id,
+      line: location?.line ?? null,
+      column: location?.column ?? null,
+      snippet,
+      resolved: Boolean(node),
+    };
+  },
+});

package/corpus/templates/design/actions/view-screen.ts

@@ -34,6 +34,20 @@ function stringArrayProp(value: unknown, key: string): string[] {
     : [];
 }
 
+function boolProp(value: unknown, key: string): boolean | undefined {
+  if (!value || typeof value !== "object") return undefined;
+  const candidate = (value as Record<string, unknown>)[key];
+  return typeof candidate === "boolean" ? candidate : undefined;
+}
+
+function objectProp(value: unknown, key: string): Record<string, unknown> {
+  if (!value || typeof value !== "object") return {};
+  const candidate = (value as Record<string, unknown>)[key];
+  return candidate && typeof candidate === "object" && !Array.isArray(candidate)
+    ? (candidate as Record<string, unknown>)
+    : {};
+}
+
 function resolveActiveScreen(
   files: Array<{
     id: string;
@@ -93,9 +107,36 @@ function resolveActiveScreen(
   return null;
 }
 
+function resolveActiveCodeFile(
+  files: Array<{
+    id: string;
+    filename: string;
+    fileType: string | null;
+    updatedAt: string | null;
+  }>,
+  designSelection: unknown,
+) {
+  const codeWorkspace = objectProp(designSelection, "codeWorkspace");
+  if (Object.keys(codeWorkspace).length === 0) return null;
+  const fileId = stringProp(codeWorkspace, "activeFileId");
+  const path = stringProp(codeWorkspace, "activePath");
+  const file = files.find(
+    (candidate) => candidate.id === fileId || candidate.filename === path,
+  );
+  return {
+    open: boolProp(codeWorkspace, "open") ?? false,
+    backendKind: stringProp(codeWorkspace, "backendKind") ?? "virtual-inline",
+    path: path ?? file?.filename ?? null,
+    fileId: fileId ?? file?.id ?? null,
+    dirty: boolProp(codeWorkspace, "dirty") ?? false,
+    versionHash: stringProp(codeWorkspace, "versionHash") ?? null,
+    file: file ?? null,
+  };
+}
+
 export default defineAction({
   description:
-    "See what the user is currently looking at on screen. Returns the current navigation state including which design is open, which view they are on (list, editor, design-systems, present, settings), active/focused design screen, selected element, active inspector tab (design or tweaks), active left rail panel (file, agent, assets, tools, or tokens), overview canvas state, plus any pending question overlay. Always call this first before taking any action.",
+    "See what the user is currently looking at on screen. Returns the current navigation state including which design is open, which view they are on (list, editor, design-systems, present, settings), active/focused design screen, selected element, active inspector tab (design or tweaks), active left rail panel (file, agent, assets, tools, tokens, or code), active code file metadata, overview canvas state, plus any pending question overlay. Always call this first before taking any action.",
   schema: z.object({}),
   http: false,
   run: async () => {
@@ -154,6 +195,7 @@ export default defineAction({
           title: (access.resource as { title?: unknown }).title ?? null,
           screens: files,
           activeScreen: resolveActiveScreen(files, navigation, designSelection),
+          activeCodeFile: resolveActiveCodeFile(files, designSelection),
           canvasFrames: parseCanvasFrameGeometryById(data.canvasFrames),
         };
       }