@agent-native/core 0.84.30 → 0.84.34

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

@@ -0,0 +1,52 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import { resolveSourceWorkspace } from "../server/source-workspace.js";
+
+export default defineAction({
+  description:
+    "List source files for a Design code workspace. In the current MVP this " +
+    "returns inline SQL-backed design_files by filename; future localhost and " +
+    "container source backends will use the same shape.",
+  schema: z.object({
+    designId: z.string().describe("Design project ID"),
+  }),
+  readOnly: true,
+  http: { method: "GET" },
+  run: async ({ designId }) => {
+    const workspace = await resolveSourceWorkspace(designId);
+    const readonly = !workspace.canEdit || workspace.sourceType !== "inline";
+    return {
+      designId,
+      backend: {
+        kind: "virtual-inline" as const,
+        workspaceUri: `designfs://${designId}/`,
+        designId,
+        capabilities: {
+          readFile: true,
+          writeFile: workspace.canEdit && workspace.sourceType === "inline",
+          diff: true,
+        },
+      },
+      sourceType: workspace.sourceType,
+      files: workspace.files.map((file) => ({
+        path: file.filename,
+        displayName: file.filename,
+        kind: "file" as const,
+        sourceType: workspace.sourceType,
+        fileId: file.id,
+        readonly,
+        reason: readonly
+          ? workspace.canEdit
+            ? "Only inline Design files are editable in this MVP."
+            : "You need editor access to change this file."
+          : undefined,
+        language:
+          file.fileType === "html" || file.fileType === "css"
+            ? file.fileType
+            : undefined,
+        updatedAt: file.updatedAt,
+      })),
+    };
+  },
+});

package/corpus/templates/design/actions/navigate.ts

@@ -18,7 +18,7 @@
  *   --designId   Design ID (for editor/present views)
  *   --editorView Editor mode for designs: single or overview
  *   --inspectorTab Inspector tab for designs: design or tweaks (extensions opens Tools for compatibility)
- *   --leftPanel  Left editor panel: file, agent, assets, tools, or tokens
+ *   --leftPanel  Left editor panel: file, agent, assets, import, tools, tokens, or code
  *   --fileId     Screen/file id to focus in the design editor
  *   --filename   Screen filename to focus in the design editor
  *   --tool       Design editor tool to activate
@@ -51,13 +51,15 @@ const designLeftPanelSchema = z.enum([
   "file",
   "agent",
   "assets",
+  "import",
   "tools",
   "tokens",
+  "code",
 ]);
 
 export default defineAction({
   description:
-    "Navigate the UI to a specific view or path. Views: list, editor, design-systems, present, settings. Use --designId with editor/present views and --designSystemId with design-systems. For designs, use editorView=overview to show the infinite screens canvas, or editorView=single with fileId/filename/screen to focus a screen. Use leftPanel=file|agent|assets|tools|tokens to focus the Figma-style left rail. Legacy inspectorTab=extensions opens Tools. Use tool to activate a design editor tool.",
+    "Navigate the UI to a specific view or path. Views: list, editor, design-systems, present, settings. Use --designId with editor/present views and --designSystemId with design-systems. For designs, use editorView=overview to show the infinite screens canvas, or editorView=single with fileId/filename/screen to focus a screen. Use leftPanel=file|agent|assets|import|tools|tokens|code to focus the left rail, including Import and the wide Code workspace. Legacy inspectorTab=extensions opens Tools. Use tool to activate a design editor tool.",
   schema: z
     .object({
       view: z

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, import, 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),
         };
       }