@agent-native/core 0.176.1 → 0.176.2-nightly-20260831184159

package/corpus/templates/crm/app/components/layout/CrmSidebar.tsx

@@ -51,7 +51,7 @@ import {
 
 const primaryNav = [
   {
-    to: "/",
+    to: "/home",
     labelKey: "navigation.overview",
     icon: IconLayoutDashboard,
     end: true,
@@ -248,7 +248,7 @@ export function CrmSidebar({ onNavigate }: { onNavigate?: () => void }) {
               const Icon = item.icon;
               const label = t(item.labelKey);
               const isActive = item.end
-                ? location.pathname === "/"
+                ? location.pathname === "/home"
                 : location.pathname.startsWith(item.to);
               return (
                 <CollapsibleTooltip
@@ -376,7 +376,7 @@ export function CrmSidebar({ onNavigate }: { onNavigate?: () => void }) {
           </div>
 
           {!collapsed && (
-            <div className="mt-2 grid gap-2 px-1">
+            <div className="mt-2 grid gap-2 px-1 empty:hidden">
               <OrgSwitcher reserveSpace />
               <DevDatabaseLink />
             </div>

package/corpus/templates/crm/app/root.tsx

@@ -9,7 +9,14 @@ import { getLocaleInitScript } from "@agent-native/core/client/i18n";
 import { getThemeInitScript } from "@agent-native/core/client/ui";
 import { useQueryClient } from "@tanstack/react-query";
 import { useState } from "react";
-import { Links, Meta, Outlet, Scripts, ScrollRestoration } from "react-router";
+import {
+  Links,
+  Meta,
+  Outlet,
+  Scripts,
+  ScrollRestoration,
+  useLocation,
+} from "react-router";
 import type { LinksFunction } from "react-router";
 
 import { CrmCommandMenu } from "@/components/layout/CrmCommandMenu";
@@ -74,16 +81,30 @@ function SyncBridge() {
   return null;
 }
 
+function AppContent() {
+  return (
+    <>
+      <SyncBridge />
+      <CrmCommandMenu />
+      <CrmLayout>
+        <Outlet />
+      </CrmLayout>
+    </>
+  );
+}
+
 export default function Root() {
   const [queryClient] = useState(() => createAgentNativeQueryClient());
+  const location = useLocation();
+  const isMarketingPath = location.pathname === "/";
   return (
     <AppToolkitProvider>
-      <AppProviders queryClient={queryClient} i18n={{ catalog: i18nCatalog }}>
-        <SyncBridge />
-        <CrmCommandMenu />
-        <CrmLayout>
-          <Outlet />
-        </CrmLayout>
+      <AppProviders
+        queryClient={queryClient}
+        isPublicPath={isMarketingPath}
+        i18n={{ catalog: i18nCatalog }}
+      >
+        {isMarketingPath ? <Outlet /> : <AppContent />}
       </AppProviders>
     </AppToolkitProvider>
   );

package/corpus/templates/crm/app/routes/_index.tsx

@@ -1,26 +1,36 @@
-import { useActionQuery } from "@agent-native/core/client/hooks";
+import { appPath } from "@agent-native/core/client/api-path";
+import { MarketingHome } from "@agent-native/toolkit/marketing";
 
-import { PageHeader } from "@/components/crm/Surface";
-import { WorkOverview } from "@/components/crm/WorkOverview";
-import type { CrmOverview } from "@/lib/types";
+const SEO_TITLE =
+  "CRM - Open Source agent-native customer relationship manager";
+const SEO_DESCRIPTION =
+  "Open Source CRM for accounts, people, opportunities, tasks, and connected customer data, with safe actions your agent can use.";
 
 export function meta() {
-  return [{ title: "My work · CRM" }];
+  return [
+    { title: SEO_TITLE },
+    { name: "description", content: SEO_DESCRIPTION },
+    { property: "og:title", content: SEO_TITLE },
+    { property: "og:description", content: SEO_DESCRIPTION },
+    { name: "twitter:card", content: "summary" },
+    { name: "twitter:title", content: SEO_TITLE },
+    { name: "twitter:description", content: SEO_DESCRIPTION },
+  ];
 }
 
-export default function WorkRoute() {
-  const overview = useActionQuery<CrmOverview>(
-    "get-crm-overview" as never,
-    {} as never,
-  );
+export default function MarketingHomeRoute() {
   return (
-    <>
-      <PageHeader
-        eyebrow="CRM"
-        title="My work"
-        description="A calm view of follow-up work and current relationship context."
-      />
-      <WorkOverview overview={overview.data} isLoading={overview.isLoading} />
-    </>
+    <MarketingHome
+      appName="CRM"
+      tagline="A complete Native SQL CRM or a connected companion grounded in its source system."
+      description={SEO_DESCRIPTION}
+      valueProps={[
+        "Run accounts, people, opportunities, tasks, and cadence on Native SQL",
+        "Connect scoped HubSpot or Salesforce records without copying credentials",
+        "Use the same safe actions from the UI or your CRM agent",
+      ]}
+      primaryActionHref={appPath("/home")}
+      secondaryActionHref={appPath("/sign-in")}
+    />
   );
 }

package/corpus/templates/crm/app/routes/home.tsx

@@ -0,0 +1,27 @@
+import { useActionQuery } from "@agent-native/core/client/hooks";
+
+import { PageHeader } from "@/components/crm/Surface";
+import { WorkOverview } from "@/components/crm/WorkOverview";
+import type { CrmOverview } from "@/lib/types";
+
+export function meta() {
+  return [{ title: "My work · CRM" }];
+}
+
+// Private app entry retained at /home; / serves the public marketing page.
+export default function WorkRoute() {
+  const overview = useActionQuery<CrmOverview>(
+    "get-crm-overview" as never,
+    {} as never,
+  );
+  return (
+    <>
+      <PageHeader
+        eyebrow="CRM"
+        title="My work"
+        description="A calm view of follow-up work and current relationship context."
+      />
+      <WorkOverview overview={overview.data} isLoading={overview.isLoading} />
+    </>
+  );
+}

package/corpus/templates/crm/app/routes/setup.tsx

@@ -106,7 +106,7 @@ export default function SetupRoute() {
       toast.success(
         `Recent ${providerLabel(selected.provider)} records are ready.`,
       );
-      void navigate("/", { replace: true });
+      void navigate("/home", { replace: true });
     } catch (error) {
       toast.error(error instanceof Error ? error.message : "CRM sync failed.");
     }
@@ -116,7 +116,7 @@ export default function SetupRoute() {
     try {
       await configureNative.mutateAsync({});
       toast.success("Your native CRM is ready.");
-      void navigate("/", { replace: true });
+      void navigate("/home", { replace: true });
     } catch (error) {
       toast.error(
         error instanceof Error ? error.message : "Could not start native CRM.",

package/corpus/templates/crm/app/routes.ts

@@ -2,6 +2,7 @@ import { type RouteConfig, index, route } from "@react-router/dev/routes";
 
 export default [
   index("./routes/_index.tsx"),
+  route("home", "./routes/home.tsx"),
   route("accounts", "./routes/accounts.tsx"),
   route("people", "./routes/people.tsx"),
   route("opportunities", "./routes/opportunities.tsx"),

package/corpus/templates/crm/public/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "CRM",
   "short_name": "CRM",
-  "start_url": "/",
+  "start_url": "./home",
   "background_color": "#faf8f4",
   "theme_color": "#181b20",
   "icons": [

package/corpus/templates/crm/server/plugins/agent-chat.ts

@@ -2,6 +2,8 @@ import { getOrgContext } from "@agent-native/core/org";
 import {
   createAgentChatPlugin,
   loadActionsFromStaticRegistry,
+  getRequestOrgId,
+  getRequestUserEmail,
 } from "@agent-native/core/server";
 
 import actionsRegistry from "../../.generated/actions-registry.js";
@@ -48,8 +50,87 @@ const INITIAL_TOOL_NAMES = [
   "provider-api-request",
 ];
 
+const CRM_DASHBOARD_EDIT_TOOLS = new Set([
+  "restore-crm-dashboard-revision",
+  "save-crm-dashboard",
+]);
+
+function eventRecord(entry: unknown): Record<string, unknown> | undefined {
+  if (!entry || typeof entry !== "object") return undefined;
+  const event = (entry as { event?: unknown }).event;
+  return event && typeof event === "object"
+    ? (event as Record<string, unknown>)
+    : undefined;
+}
+
+function inputForCompletedTool(
+  events: readonly unknown[],
+  index: number,
+  completed: Record<string, unknown>,
+): Record<string, unknown> | undefined {
+  if (completed.input && typeof completed.input === "object") {
+    return completed.input as Record<string, unknown>;
+  }
+  const id = typeof completed.id === "string" ? completed.id : undefined;
+  for (let cursor = index - 1; cursor >= 0; cursor -= 1) {
+    const candidate = eventRecord(events[cursor]);
+    if (
+      candidate?.type !== "tool_start" ||
+      candidate.tool !== completed.tool ||
+      (id && candidate.id !== id)
+    ) {
+      continue;
+    }
+    return candidate.input && typeof candidate.input === "object"
+      ? (candidate.input as Record<string, unknown>)
+      : undefined;
+  }
+  return undefined;
+}
+
+function hasCrmDashboardEdit(
+  run: { events: readonly unknown[] },
+  dashboardId: string,
+): boolean {
+  return run.events.some((entry, index) => {
+    const record = eventRecord(entry);
+    const input = record
+      ? inputForCompletedTool(run.events, index, record)
+      : undefined;
+    return (
+      record?.type === "tool_done" &&
+      record.completedSideEffect === true &&
+      record.isError !== true &&
+      typeof record.tool === "string" &&
+      CRM_DASHBOARD_EDIT_TOOLS.has(record.tool) &&
+      input?.id === dashboardId
+    );
+  });
+}
+
+async function autosaveCrmDashboardAfterAgentTurn(
+  scope: { type: string; id: string },
+  run: {
+    events: readonly unknown[];
+    threadId?: string;
+    runId?: string;
+    turnId?: string;
+  },
+): Promise<void> {
+  if (scope.type !== "crm-dashboard" || !hasCrmDashboardEdit(run, scope.id))
+    return;
+  const userEmail = getRequestUserEmail();
+  if (!userEmail) return;
+  const { crmDashboardStore } = await import("../db/index.js");
+  await crmDashboardStore.createRevisionSnapshot(scope.id, {
+    userEmail,
+    orgId: getRequestOrgId() || undefined,
+  });
+}
+
 export default createAgentChatPlugin({
   appId: "crm",
+  onAgentTurnComplete: autosaveCrmDashboardAfterAgentTurn,
   actions: loadActionsFromStaticRegistry(actionsRegistry),
   initialToolNames: INITIAL_TOOL_NAMES,
   resolveOrgId: async (event) => (await getOrgContext(event)).orgId,

package/corpus/templates/crm/server/plugins/auth.ts

@@ -1,6 +1,7 @@
 import { createAuthPlugin } from "@agent-native/core/server";
 
 export default createAuthPlugin({
+  workspaceAppPublicPaths: ["/"],
   marketing: {
     appName: "CRM",
     tagline:

package/corpus/templates/crm/server/plugins/core-routes.ts

@@ -1,7 +1,7 @@
 import { createCoreRoutesPlugin } from "@agent-native/core/server";
 
 const VIEW_PATHS: Record<string, string> = {
-  overview: "/",
+  overview: "/home",
   records: "/records",
   record: "/records",
   tasks: "/tasks",
@@ -10,6 +10,7 @@ const VIEW_PATHS: Record<string, string> = {
 };
 
 export default createCoreRoutesPlugin({
+  googleOAuthManagedConnection: "not_applicable",
   resolveOpenPath: ({ view, params }) => {
     if (params.recordId) return `/records/${params.recordId}`;
     return view ? (VIEW_PATHS[view] ?? null) : null;

package/corpus/templates/crm/server/plugins/db.ts

@@ -406,7 +406,8 @@ const dashboardsSchema = [
   title TEXT NOT NULL,
   config TEXT NOT NULL,
   created_at TEXT NOT NULL DEFAULT (datetime('now')),
-  created_by TEXT`,
+  created_by TEXT,
+  chat_context TEXT`,
   ),
   sharesTable("crm_dashboard_shares"),
   `CREATE INDEX IF NOT EXISTS crm_dashboards_owner_updated_idx ON crm_dashboards (owner_email, org_id, updated_at)`,
@@ -647,6 +648,11 @@ export const runCrmMigrations = runMigrations(
       sql: {},
       run: backfillNativeStageOptions,
     },
+    {
+      version: 8,
+      name: "crm-dashboard-revision-chat-context",
+      sql: addColumn("crm_dashboard_revisions", "chat_context TEXT"),
+    },
   ],
   { table: "crm_migrations" },
 );

package/corpus/templates/crm/shared/crm-navigation.ts

@@ -50,7 +50,7 @@ export type CrmView = (typeof CRM_VIEWS)[number];
  * returns it — only `navigate` accepts it as a destination.
  */
 export const CRM_VIEW_PATHS: Record<Exclude<CrmView, "record">, string> = {
-  work: "/",
+  work: "/home",
   account: "/accounts",
   person: "/people",
   opportunity: "/opportunities",
@@ -118,7 +118,8 @@ export function crmNavigationPath(target: CrmNavigationTarget): string {
   }
 
   const params = new URLSearchParams();
-  let base = CRM_VIEW_PATHS[target.view as Exclude<CrmView, "record">] ?? "/";
+  let base =
+    CRM_VIEW_PATHS[target.view as Exclude<CrmView, "record">] ?? "/home";
   // A saved view or a list always opens on the /views surface; /lists is only
   // the index of lists.
   if (

package/corpus/templates/design/.agents/skills/design-generation/SKILL.md

@@ -194,6 +194,11 @@ Pick a preset by `projectType`:
 ## Measurable rules (bake these in)
 
 - 8px spacing grid — all padding/margins/gaps are multiples of 4/8.
+- Absolute `left`/`top` are whole pixels, and multiples of the screen's
+  `layoutGrid.size` when `design-selection` reports one. A fractional or
+  off-grid position reads as a mistake to a designer and does not match what
+  dragging the same element produces. Set a screen's grid with
+  `set-layout-grid`.
 - Body text ≥ 16px, labels ≥ 12px.
 - Big type-scale jumps for hierarchy (don't rely on tiny size deltas).
 - WCAG contrast: 4.5:1 normal text, 3:1 large text. Verify accent-on-background.
@@ -324,6 +329,14 @@ Skip the questions entirely when:
   design; or
 - the user says "decide for me," "surprise me," "just build it," or similar.
 
+The turn that opens `show-design-questions` already checked Creative Context
+and any published Brand DNA before this skill loads, and the directives it
+built name exactly which topics (form factor, aesthetic direction,
+features/content, interactions/polish, exploring variations) are already
+answered. Never re-ask a topic those directives list as covered, and never
+skip a topic they don't — a single unrelated context member (a doc, a spec)
+must not suppress a question it has no bearing on.
+
 Asking on every prompt is as much a failure mode as never asking: a detailed
 prompt that already answers the obvious questions should generate
 immediately, and a design already in flight should not be interrupted with a

package/corpus/templates/design/.agents/skills/frontend-design/SKILL.md

@@ -68,6 +68,10 @@ is the target: a surface full of information and nearly empty of narration. So
 "make it minimal" is never satisfied by removing data or by burying it behind
 extra clicks, and never blocked by deleting a sentence.
 
+Keep on-screen text and badging minimal: show the shortest label needed for the
+next action, remove decorative or duplicate status chips, and put context in a
+tooltip or progressive disclosure when it is not needed to decide.
+
 Do not add, unless asked:
 
 - A page title that repeats the nav item or route the user just clicked, or a

package/corpus/templates/design/.agents/skills/secrets/SKILL.md

@@ -31,6 +31,53 @@ standard workspace connections and org/workspace vault scopes; never put them
 in `.env` or deployment environment variables, and never add a provider-specific
 action or startup bootstrap just to write a credential for one organization.
 
+## Google OAuth triage
+
+| Observation | Meaning | Next action |
+| --- | --- | --- |
+| `invalid_grant` from a deliberately fake code | Google accepted the client pair and rejected only the code | Do not rotate credentials; check flow state and callback registration |
+| `invalid_client` | Google rejected the client id/secret pair | Verify the exact pair and deployment source before rotating |
+| `redirect_uri_mismatch` | The client, host, callback path, and Google registration disagree | Compare that exact tuple in Google Cloud Console; publish a new deploy if site-scoped or build-time configuration changes |
+
+Do not reason about this from memory. The probe checks both contracts: the
+unqualified `/health/google` endpoint reports the sign-in contract, while
+`/health/google?client=managed` reports deployment-level managed OAuth. It asks
+Google directly whether each live `(client_id, redirect_uri)` pair is
+registered:
+
+```bash
+pnpm check:google-redirect-uris -- --env all
+```
+
+The sign-in health path calls `checkGoogleSignInCredential()`, which prefers
+the active Better Auth pair and otherwise uses `resolveGoogleSignInCredentials()`
+from `packages/core/src/server/google-oauth-credentials.ts`. Managed health
+calls `checkGoogleManagedCredential()`, which resolves
+`["GOOGLE_CLIENT_ID", "GOOGLE_CLIENT_SECRET"]` through `resolveSecretPair()` in
+`packages/core/src/server/credential-provider.ts`. App provider handlers use
+`resolveGoogleProviderCredentialCandidatesWithReader()` with `resolveSecret`
+under request context. These are separate flows and can intentionally land on
+different Google clients, so a clean result for one says nothing about the
+other. Read both contracts before changing anything:
+
+```bash
+curl -s https://HOST/_agent-native/health/google | jq '{clientId,mismatchedPairs,credentialSource}'
+curl -s "https://HOST/_agent-native/health/google?client=managed" | jq '{clientId,mismatchedPairs,credentialSource}'
+```
+
+Different `clientId` values across those two, or `mismatchedPairs: true`, is a
+divergence to understand, not damage to undo. Never repair it by rotating a
+secret: writing a fresh value into whichever namespace the failing flow does
+not read verifies clean and changes nothing. Do not collapse the namespaces
+without first confirming which flow uses which client; separate sign-in and
+managed clients on one host can be deliberate. For prebuilt Netlify deploys,
+uploaded Functions read site-scoped secrets at runtime, and the health route
+resolves them per request. The build may receive masked placeholder values.
+After changing a site-scoped env var, publish a new deploy before verifying
+live behavior. Call it a rebuild when the changed value is baked into build
+output or static assets; a runtime-only secret does not need to be baked into
+the bundle.
+
 ## Credential Modeling Preflight
 
 Before registering a provider's fields, inspect the workspace/provider connection

package/corpus/templates/design/.generated/bridge/editor-chrome.generated.ts

@@ -6960,8 +6960,8 @@ export const editorChromeBridgeScript: string = `"use strict";
       }
       var currentLeft = readPx(htmlEl.style.left || cs.left);
       var currentTop = readPx(htmlEl.style.top || cs.top);
-      htmlEl.style.left = currentLeft + (oldOriginX - newOriginX) + "px";
-      htmlEl.style.top = currentTop + (oldOriginY - newOriginY) + "px";
+      htmlEl.style.left = Math.round(currentLeft + (oldOriginX - newOriginX)) + "px";
+      htmlEl.style.top = Math.round(currentTop + (oldOriginY - newOriginY)) + "px";
     }
     function prepareFlowMembersForAbsoluteDrop(members, target, startRects, gestureStartRect, pointerOffset, clientX, clientY) {
       if (!target || target.dropMode !== "absolute-container") return;
@@ -7022,8 +7022,8 @@ export const editorChromeBridgeScript: string = `"use strict";
       }
       var localDx = (clientDx * yy - yx * clientDy) / determinant;
       var localDy = (xx * clientDy - clientDx * xy) / determinant;
-      htmlEl.style.left = baseLeft + localDx + "px";
-      htmlEl.style.top = baseTop + localDy + "px";
+      htmlEl.style.left = Math.round(baseLeft + localDx) + "px";
+      htmlEl.style.top = Math.round(baseTop + localDy) + "px";
     }
     function applyRuntimeReorder(el, target) {
       if (!el || !target || !target.anchor || !target.anchor.parentElement)
@@ -7128,6 +7128,11 @@ export const editorChromeBridgeScript: string = `"use strict";
       postElementMarqueeSelect(members, false, ev);
     }
     var SNAP_THRESHOLD_PX = 6;
+    var layoutGridStep = 1;
+    function quantizeToLayoutGrid(value) {
+      if (!(layoutGridStep > 1)) return Math.round(value);
+      return Math.round(value / layoutGridStep) * layoutGridStep;
+    }
     var SNAP_CANDIDATE_CAP = 200;
     function rectBounds(rect) {
       return {
@@ -8485,8 +8490,8 @@ export const editorChromeBridgeScript: string = `"use strict";
         var appliedDx = nextLeft - originLeft;
         var appliedDy = nextTop - originTop;
         memberStates.forEach(function(state) {
-          state.el.style.left = Math.round(state.originLeft + appliedDx) + "px";
-          state.el.style.top = Math.round(state.originTop + appliedDy) + "px";
+          state.el.style.left = quantizeToLayoutGrid(state.originLeft + appliedDx) + "px";
+          state.el.style.top = quantizeToLayoutGrid(state.originTop + appliedDy) + "px";
         });
         if (!duplicatedForDrag && !isGroupDrag) {
           scheduleCrossScreenDragMove(ev);
@@ -8881,10 +8886,12 @@ export const editorChromeBridgeScript: string = `"use strict";
         var rect = nextRect(ev);
         if (rect.touchesWidth) widthTouched = true;
         if (rect.touchesHeight) heightTouched = true;
-        resizeEl.style.left = Math.round(rect.left) + "px";
-        resizeEl.style.top = Math.round(rect.top) + "px";
-        if (widthTouched) resizeEl.style.width = Math.round(rect.width) + "px";
-        if (heightTouched) resizeEl.style.height = Math.round(rect.height) + "px";
+        resizeEl.style.left = quantizeToLayoutGrid(rect.left) + "px";
+        resizeEl.style.top = quantizeToLayoutGrid(rect.top) + "px";
+        if (widthTouched)
+          resizeEl.style.width = quantizeToLayoutGrid(rect.width) + "px";
+        if (heightTouched)
+          resizeEl.style.height = quantizeToLayoutGrid(rect.height) + "px";
         if (scaleToolEnabled) {
           var kScaleFactor = rect.width / Math.max(1, origin.width);
           if (originBorderWidth > 0) {
@@ -10368,6 +10375,11 @@ export const editorChromeBridgeScript: string = `"use strict";
     window.addEventListener("message", function(e) {
       if (e.source !== window.parent) return;
       if (!e.data) return;
+      if (e.data.type === "set-layout-grid-step") {
+        var nextStep = Number(e.data.step);
+        layoutGridStep = Number.isFinite(nextStep) && nextStep >= 1 ? nextStep : 1;
+        return;
+      }
       if (e.data.type === "set-read-only") {
         var nextReadOnly = !!e.data.readOnly;
         if (readOnly === nextReadOnly) return;

package/corpus/templates/design/AGENTS.md

@@ -91,7 +91,7 @@ Read the relevant skill before deeper work in that area.
 - `navigate` — moves the UI in the tab that asked; auto-deleted after the
   client consumes it.
 - `design-selection` — active screen, selected element, overview mode,
-  inspector tab, zoom, and screen list for the current tab.
+  inspector tab, zoom, screen list, and `layoutGrid`.
 - `design-generation-session:<designId>`, `show-questions`, `guided-questions` —
   generation planning, pre-generation questions, and the variant chat choice;
   see `design-generation`.

package/corpus/templates/design/actions/add-breakpoint.ts

@@ -8,6 +8,7 @@ import {
   mutateDesignData,
   type DesignDataRecord,
 } from "../server/lib/design-data-mutation.js";
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import type {
   BreakpointDefinition,
   BreakpointSet,
@@ -70,8 +71,9 @@ export default defineAction({
       .optional()
       .describe("Optional pre-generated id. Omit to auto-generate."),
   }),
-  run: async ({ designId, label, widthPx, id: providedId }) => {
+  run: async ({ designId, label, widthPx, id: providedId }, context) => {
     await assertAccess("design", designId, "editor");
+    await snapshotDesignBeforeAgentEdit(designId, context);
 
     const breakpointId = providedId ?? nanoid();
     const breakpointSetId = nanoid();

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

@@ -14,6 +14,7 @@ import { z } from "zod";
 
 import { schema } from "../server/db/index.js";
 import "../server/db/index.js"; // ensure registerShareableResource runs
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import {
   DEFAULT_FUSION_SCREEN_HEIGHT,
   DEFAULT_FUSION_SCREEN_WIDTH,
@@ -67,6 +68,7 @@ export default defineAction({
       );
     }
 
+    await snapshotDesignBeforeAgentEdit(designId, ctx);
     const { screens } = await upsertFusionScreens({
       designId,
       previewUrl: fusionApp.previewUrl,

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

@@ -15,6 +15,7 @@ import {
   mutateDesignData,
   type DesignDataRecord,
 } from "../server/lib/design-data-mutation.js";
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import { resolveLocalhostConnectionScope } from "../server/lib/localhost-connection.js";
 import {
   mergeCanvasFramePlacements,
@@ -351,18 +352,22 @@ export default defineAction({
       height: 680,
     }),
   },
-  run: async ({
-    designId,
-    connectionId,
-    routes,
-    paths,
-    defaultWidth,
-    defaultHeight,
-    startX,
-    startY,
-    gap,
-  }) => {
+  run: async (
+    {
+      designId,
+      connectionId,
+      routes,
+      paths,
+      defaultWidth,
+      defaultHeight,
+      startX,
+      startY,
+      gap,
+    },
+    context,
+  ) => {
     await assertAccess("design", designId, "editor");
+    await snapshotDesignBeforeAgentEdit(designId, context);
     const { ownerEmail, orgId } = await resolveLocalhostConnectionScope();
     const db = getDb();
 

package/corpus/templates/design/actions/apply-a11y-fix.ts

@@ -30,6 +30,7 @@ import { and, eq } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import {
   readLiveSourceFile,
   writeInlineSourceFile,
@@ -261,14 +262,10 @@ export default defineAction({
       .default(false)
       .describe("Include the patched HTML content in the response."),
   }),
-  run: async ({
-    designId,
-    fileId,
-    filename,
-    finding,
-    color,
-    includeContent,
-  }) => {
+  run: async (
+    { designId, fileId, filename, finding, color, includeContent },
+    context,
+  ) => {
     const plan = a11yFindingToEdit(finding as A11yFinding, { color });
 
     if (!plan) {
@@ -289,6 +286,7 @@ export default defineAction({
       fileId,
       filename,
     });
+    await snapshotDesignBeforeAgentEdit(file.designId, context);
 
     const patch = applyVisualEdit(file.content, plan.edit as EditIntent, {
       source: {