@agent-native/core 0.84.30 → 0.84.32

package/corpus/README.md

@@ -28,4 +28,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 ## Generated Counts
 
 - core files: 2043
-- template files: 4973
+- template files: 4983

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @agent-native/core
 
+## 0.84.32
+
+### Patch Changes
+
+- da8ac0a: Keep tail-resume reconnect content display-only, recover zero-byte action-prep stalls, and polish Design screen tool labels.
+
+## 0.84.31
+
+### Patch Changes
+
+- 3190dea: Inline rrweb stylesheet snapshots by default so Analytics session replay captures can play back styled pages without live CSS fetches.
+
 ## 0.84.30
 
 ### Patch Changes

package/corpus/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.84.30",
+  "version": "0.84.32",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {

package/corpus/core/src/client/session-replay.ts

@@ -19,6 +19,7 @@ interface RrwebRecordOptions {
   emit: (event: ReplayEvent) => void;
   checkoutEveryNth?: number;
   checkoutEveryNms?: number;
+  inlineStylesheet?: boolean;
   blockClass?: string | RegExp;
   blockSelector?: string;
   ignoreClass?: string | RegExp;
@@ -82,6 +83,7 @@ export interface SessionReplayOptions {
   maxBatchBytes?: number;
   checkoutEveryNth?: number;
   checkoutEveryNms?: number;
+  inlineStylesheet?: boolean;
   blockSelector?: string;
   ignoreSelector?: string;
   maskTextClass?: string | RegExp;
@@ -135,6 +137,7 @@ interface NormalizedSessionReplayOptions {
   maxBatchBytes: number;
   checkoutEveryNth?: number;
   checkoutEveryNms?: number;
+  inlineStylesheet: boolean;
   blockSelector: string;
   ignoreSelector: string;
   maskTextClass: string | RegExp;
@@ -509,6 +512,7 @@ function normalizeOptions(
     ),
     checkoutEveryNth: options.checkoutEveryNth,
     checkoutEveryNms: options.checkoutEveryNms,
+    inlineStylesheet: options.inlineStylesheet ?? true,
     blockSelector: options.blockSelector || DEFAULT_BLOCK_SELECTOR,
     ignoreSelector: options.ignoreSelector || DEFAULT_IGNORE_SELECTOR,
     maskTextClass: options.maskTextClass || DEFAULT_MASK_TEXT_CLASS,
@@ -1010,6 +1014,7 @@ async function startSessionReplayRecorder(
       sampling: normalized.eventSampling,
       checkoutEveryNth: normalized.checkoutEveryNth,
       checkoutEveryNms: normalized.checkoutEveryNms,
+      inlineStylesheet: normalized.inlineStylesheet,
       blockSelector: normalized.blockSelector,
       ignoreSelector: normalized.ignoreSelector,
       maskTextClass: normalized.maskTextClass,

package/corpus/templates/analytics/app/pages/sessions/SessionDetailPage.tsx

@@ -1243,7 +1243,14 @@ function sanitizeCssText(value: string): string {
   if (!containsStylesheetNetworkLoad(value)) return value;
   return value
     .replace(/@import\s+(?:url\s*\()?[^;{}]+;?/gi, "")
-    .replace(/\burl\s*\((?:\\.|[^\\)])*\)/gi, "none");
+    .replace(/\burl\s*\(\s*((?:\\.|[^\\)])*)\)/gi, sanitizeCssUrlToken);
+}
+
+function sanitizeCssUrlToken(match: string, rawValue: string): string {
+  const urlValue = rawValue.trim();
+  const unquoted = urlValue.replace(/^(['"])(.*)\1$/, "$2").trim();
+  if (/^(?:data:|blob:|#)/i.test(unquoted)) return match;
+  return "none";
 }
 
 function sanitizeAttributes(attributes: AnyRecord): AnyRecord {
@@ -1258,6 +1265,11 @@ function sanitizeAttributes(attributes: AnyRecord): AnyRecord {
       if (style.trim()) next[key] = style;
       continue;
     }
+    if (normalized === "_csstext") {
+      const cssText = sanitizeCssText(String(value));
+      if (cssText.trim()) next[key] = cssText;
+      continue;
+    }
     next[key] = value;
   }
   return next;

package/corpus/templates/analytics/changelog/2026-07-01-session-replays-keep-inlined-css-without-live-resource-loa.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-01
+---
+
+Session replay playback keeps rrweb's inlined stylesheet snapshots while stripping live resource loads, reducing blank replay frames for captured pages with external CSS.

package/corpus/templates/design/AGENTS.md

@@ -191,6 +191,24 @@ patterns live in `.agents/skills/`.
   mode can list and resolve local routes now, but file reads/writes remain a
   bridge contract until explicit permission controls are hardened.
 
+## Code Workspace
+
+- The editor left rail has a wide `code` workspace panel. Open it with
+  `navigate --view editor --designId <id> --leftPanel code` and optionally pass
+  `fileId`, `filename`, or `screen` to focus a file.
+- Use `list-source-files` to inspect the source workspace. For the MVP the
+  backend is `virtual-inline` over SQL-backed `design_files`, exposed as
+  `designfs://<designId>/`.
+- Use `read-source-file` for file contents and preserve its `versionHash` before
+  writing. Do not return full file content from `view-screen`; it reports only
+  active code file metadata and dirty state.
+- Use `preview-source-edit` to show a diff without saving, then
+  `apply-source-edit` with the prior `versionHash` to save either a full replace
+  or exact replace. These actions update the same inline file state as the UI.
+- Use `resolve-selection-source` when the user has a canvas element selected and
+  you need the best matching inline file location/snippet. Localhost/container
+  source reads and writes remain future backend work.
+
 ## Localhost Source Actions
 
 - `connect-localhost`: registers or refreshes a localhost source connection

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

@@ -0,0 +1,87 @@
+import { defineAction } from "@agent-native/core";
+import { z } from "zod";
+
+import {
+  findSourceWorkspaceFile,
+  readLiveSourceFile,
+  resolveSourceWorkspace,
+  writeInlineSourceFile,
+} 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:
+    "Apply a source-file edit through the shared Design source surface. In the " +
+    "MVP this writes inline design_files only and rejects stale version hashes.",
+  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("Hash returned by read-source-file or preview-source-edit"),
+    })
+    .refine((args) => args.path || args.fileId, {
+      message: "Provide either path or fileId.",
+      path: ["path"],
+    }),
+  run: async ({ designId, path, fileId, edit, expectedVersionHash }) => {
+    const workspace = await resolveSourceWorkspace(designId, {
+      includeContent: true,
+    });
+    if (workspace.sourceType !== "inline") {
+      throw new Error("Only inline Design files are editable in this MVP.");
+    }
+    const file = findSourceWorkspaceFile(workspace.files, { fileId, path });
+    const live = await readLiveSourceFile(file);
+    if (
+      expectedVersionHash !== undefined &&
+      expectedVersionHash !== live.versionHash
+    ) {
+      throw new Error(
+        "Source file changed since it was read. Re-read the file and retry.",
+      );
+    }
+
+    const next = applySourceEdit(live.content, edit);
+    const write = await writeInlineSourceFile({
+      designId,
+      file,
+      content: next.content,
+      expectedVersionHash: expectedVersionHash ?? live.versionHash,
+    });
+
+    return {
+      designId,
+      path: file.filename,
+      fileId: file.id,
+      backendKind: "virtual-inline",
+      changed: write.changed,
+      editsApplied: next.editsApplied,
+      versionHash: write.versionHash,
+      updatedAt: write.updatedAt,
+      diff: previewSourceDiff(live.content, next.content),
+    };
+  },
+});

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, 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
@@ -53,11 +53,12 @@ const designLeftPanelSchema = z.enum([
   "assets",
   "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|tools|tokens|code to focus the left rail, including 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, 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),
         };
       }