@agent-native/core 0.146.0 → 0.146.2

package/corpus/README.md

@@ -31,4 +31,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- template files: 7896
+- template files: 7904

package/corpus/templates/analytics/.agents/skills/turn-into-app/SKILL.md

@@ -27,6 +27,10 @@ The build location depends on the host. Treat this as a hard routing rule:
   `resourceIds` when available. This is the Builder handoff.
 - Do not substitute the generic `create_workspace_app` MCP tool in an online
   host. That tool is a local workspace scaffolder, not the Builder handoff.
+- Connect the Agent-Native Dispatch MCP connector only. Dispatch uses the
+  authenticated Builder Projects API to reuse or provision the workspace
+  project before starting the Builder Cloud Agent; a separate Builder CMS MCP
+  connection is not required for this workflow.
 - If `start-workspace-app-creation` is not available or Dispatch is not
   authenticated, stop with the connector setup needed. Do not fall back to a
   local build or claim that the app exists.

package/corpus/templates/analytics/.agents/skills/turn-into-app/references/fresh-project.md

@@ -50,6 +50,14 @@ skills. For a ChatGPT Project or any host that exposes only the MCP connector,
 also place the skill instructions or this reference in the Project
 instructions/knowledge files. Then add and authenticate the Dispatch MCP
 connector from the packaged `adapters/chatgpt-mcp/connector.json`.
+This single connector is enough: Dispatch provisions or reuses the Builder
+project through the Builder Projects API, so do not ask the user to add a
+separate Builder CMS MCP for app creation.
+Builder's separate Fusion MCP is available as a custom remote connector at
+`https://mcp.builder.io/mcp/fusion` for direct Builder work. It can run an
+existing project, but it cannot provision the repo-backed Agent-Native
+workspace project, so it is optional and not a replacement for the Dispatch
+handoff in this skill. Do not add Builder's CMS MCP for this workflow.
 
 For Claude Web, ChatGPT Web, and their web Projects, the host is an
 orchestrator, not the build environment. After forming the source brief, call

package/corpus/templates/analytics/actions/compose-dashboard.ts

@@ -1,9 +1,4 @@
 import { defineAction, embedApp } from "@agent-native/core";
-import {
-  hasCollabState,
-  applyText,
-  seedFromText,
-} from "@agent-native/core/collab";
 import {
   getRequestUserEmail,
   getRequestOrgId,
@@ -11,6 +6,7 @@ import {
 } from "@agent-native/core/server";
 import { z } from "zod";
 
+import { queueDashboardCollabSync } from "../server/lib/dashboard-collab-sync";
 import { validateFirstPartyDashboardTimeScope } from "../server/lib/dashboard-time-scope";
 import {
   getDashboard,
@@ -27,27 +23,6 @@ import {
   usesFirstPartyDashboardFilters,
 } from "../server/lib/first-party-metric-catalog";
 
-/**
- * Push the saved config through the collab layer so open dashboard editors get
- * the change in real time (mirrors update-dashboard).
- */
-async function syncToCollab(
-  dashboardId: string,
-  config: Record<string, unknown>,
-): Promise<void> {
-  const docId = `dash-${dashboardId}`;
-  const configStr = JSON.stringify(config);
-  try {
-    if (await hasCollabState(docId)) {
-      await applyText(docId, configStr, "content", "agent");
-    } else {
-      await seedFromText(docId, configStr);
-    }
-  } catch {
-    // Collab sync is best-effort — the SQL write is the source of truth.
-  }
-}
-
 const WINDOWS = new Set<MetricWindow>(["30d", "90d", "all"]);
 
 function normalizeWindow(raw: unknown): MetricWindow | undefined {
@@ -329,7 +304,7 @@ export default defineAction({
       ? (finalConfig.panels as unknown[]).length
       : 0;
 
-    await syncToCollab(args.dashboardId, finalConfig);
+    queueDashboardCollabSync(args.dashboardId, finalConfig, "agent");
 
     const parts: string[] = [];
     if (existing && !args.overwrite) {

package/corpus/templates/analytics/actions/get-sql-dashboard.ts

@@ -65,16 +65,15 @@ export default defineAction({
     const dash = await getDashboard(args.id, ctx);
     if (!dash || dash.kind !== "sql") {
       const seed = loadDashboardSeed(args.id);
-      if (seed)
-        return buildDashboardSeedAgentContext(
-          args.id,
+      if (seed) {
+        const config =
           args.id === FIRST_PARTY_DASHBOARD_ID
             ? repairCanonicalFirstPartyDashboardQueries(seed).config
-            : seed,
-          {
-            includeConfig: args.includeConfig === true,
-          },
-        );
+            : seed;
+        return buildDashboardSeedAgentContext(args.id, config, {
+          includeConfig: args.includeConfig === true,
+        });
+      }
       throw Object.assign(new Error("Dashboard not found"), {
         statusCode: 404,
       });

package/corpus/templates/analytics/actions/migrate-first-party-analytics-to-bigquery.ts

@@ -100,16 +100,32 @@ export default defineAction({
           `BigQuery backfill already targets ${existingJob.table}; prepare the existing migration before changing tables.`,
         );
       }
+      const initialCursor =
+        existingJob?.cursor ?? current.backfillCursor ?? null;
+      if (
+        !existingJob &&
+        current.sink === "dual" &&
+        !initialCursor &&
+        ready.rowCount > 0
+      ) {
+        throw new Error(
+          "Refusing to restart an existing dual-write BigQuery backfill without its legacy cursor; recover the migration cursor before preparing again.",
+        );
+      }
+      const initialCompleted =
+        existingJob?.status === "completed" ||
+        current.backfillCompleted === true;
       await saveFirstPartyAnalyticsBackend(scope, {
         sink: "dual",
         table: ready.table.fullyQualified,
-        backfillCursor: existingJob?.cursor ?? null,
-        backfillCompleted: existingJob?.status === "completed",
+        backfillCursor: initialCursor,
+        backfillCompleted: initialCompleted,
       });
       const job = await queueFirstPartyAnalyticsBigQueryBackfill(
         scope,
         ready.table.fullyQualified,
         limit,
+        initialCursor,
       );
       return {
         sink: "dual" as const,

package/corpus/templates/analytics/actions/mutate-dashboard.ts

@@ -1,9 +1,4 @@
 import { defineAction, embedApp } from "@agent-native/core";
-import {
-  applyText,
-  hasCollabState,
-  seedFromText,
-} from "@agent-native/core/collab";
 import {
   buildDeepLink,
   getRequestOrgId,
@@ -11,6 +6,10 @@ import {
 } from "@agent-native/core/server";
 import { z } from "zod";
 
+import {
+  DASHBOARD_COLLAB_SYNC_TIMEOUT_MS,
+  queueDashboardCollabSync,
+} from "../server/lib/dashboard-collab-sync";
 import {
   getDashboard,
   upsertDashboardWithRetry,
@@ -171,24 +170,6 @@ function cloneConfig(config: Record<string, unknown>): Record<string, unknown> {
   return JSON.parse(JSON.stringify(config)) as Record<string, unknown>;
 }
 
-async function syncToCollab(
-  dashboardId: string,
-  config: Record<string, unknown>,
-): Promise<void> {
-  const docId = `dash-${dashboardId}`;
-  const configStr = JSON.stringify(config);
-  try {
-    const exists = await hasCollabState(docId);
-    if (exists) {
-      await applyText(docId, configStr, "content", "agent");
-    } else {
-      await seedFromText(docId, configStr);
-    }
-  } catch {
-    // SQL remains the source of truth; live collab sync is best-effort.
-  }
-}
-
 function sqlValidationScope(
   operations: DashboardMutationOperation[],
 ): ReadonlySet<string> | "all" | null {
@@ -399,7 +380,10 @@ export default defineAction({
       // structurally identical to the winning attempt's `root`, but reflects
       // exactly what was saved.
       root = saved.config as Record<string, unknown>;
-      await syncToCollab(dashboardId, root);
+      // SQL is the durable source of truth. Collab sync is a convenience for
+      // already-open editors, so it must never hold the saved mutation hostage
+      // behind an unavailable database or a stale per-document write lock.
+      queueDashboardCollabSync(dashboardId, root, "agent");
     }
 
     const compact = compactDashboardResult(root, movedPanelIdsFrom(operations));
@@ -421,6 +405,14 @@ export default defineAction({
       insertedPanelIds: mutation.insertedPanelIds,
       removedPanelIds: mutation.removedPanelIds,
       dashboardFieldsChanged: mutation.dashboardFieldsChanged,
+      ...(args.dryRun === true
+        ? { collabSync: { status: "skipped" as const } }
+        : {
+            collabSync: {
+              status: "queued" as const,
+              timeoutMs: DASHBOARD_COLLAB_SYNC_TIMEOUT_MS,
+            },
+          }),
       ...(args.returnConfig === true ? { config: root } : {}),
       ...(args.returnTypes === true
         ? {

package/corpus/templates/analytics/actions/rename-dashboard.ts

@@ -1,15 +1,11 @@
 import { defineAction } from "@agent-native/core";
-import {
-  hasCollabState,
-  applyText,
-  seedFromText,
-} from "@agent-native/core/collab";
 import {
   getRequestUserEmail,
   getRequestOrgId,
 } from "@agent-native/core/server";
 import { z } from "zod";
 
+import { queueDashboardCollabSync } from "../server/lib/dashboard-collab-sync";
 import { upsertDashboardWithRetry } from "../server/lib/dashboards-store";
 
 function resolveScope() {
@@ -19,24 +15,6 @@ function resolveScope() {
   return { orgId, email };
 }
 
-async function syncToCollab(
-  dashboardId: string,
-  config: Record<string, unknown>,
-  requestSource?: string,
-): Promise<void> {
-  const docId = `dash-${dashboardId}`;
-  const configStr = JSON.stringify(config);
-  try {
-    if (await hasCollabState(docId)) {
-      await applyText(docId, configStr, "content", requestSource);
-    } else {
-      await seedFromText(docId, configStr);
-    }
-  } catch {
-    // Best-effort: SQL remains the source of truth.
-  }
-}
-
 export default defineAction({
   description: "Rename a saved analytics dashboard by ID.",
   schema: z.object({
@@ -54,7 +32,7 @@ export default defineAction({
     const updated = await upsertDashboardWithRetry(args.id, ctx, (existing) => {
       return { kind: existing.kind, body: { ...existing.config, name } };
     });
-    await syncToCollab(
+    queueDashboardCollabSync(
       args.id,
       updated.config,
       actionContext?.caller === "frontend" ? undefined : "agent",

package/corpus/templates/analytics/actions/reorder-dashboard-panels.ts

@@ -1,9 +1,4 @@
 import { defineAction, embedApp } from "@agent-native/core";
-import {
-  applyText,
-  hasCollabState,
-  seedFromText,
-} from "@agent-native/core/collab";
 import {
   buildDeepLink,
   getRequestOrgId,
@@ -11,6 +6,7 @@ import {
 } from "@agent-native/core/server";
 import { z } from "zod";
 
+import { queueDashboardCollabSync } from "../server/lib/dashboard-collab-sync";
 import { upsertDashboardWithRetry } from "../server/lib/dashboards-store";
 import {
   compactDashboardResult,
@@ -74,24 +70,6 @@ function resolveTarget(args: {
   return { position: args.position ?? "top" };
 }
 
-async function syncToCollab(
-  dashboardId: string,
-  config: Record<string, unknown>,
-): Promise<void> {
-  const docId = `dash-${dashboardId}`;
-  const configStr = JSON.stringify(config);
-  try {
-    const exists = await hasCollabState(docId);
-    if (exists) {
-      await applyText(docId, configStr, "content", "agent");
-    } else {
-      await seedFromText(docId, configStr);
-    }
-  } catch {
-    // SQL remains the source of truth; live collab sync is best-effort.
-  }
-}
-
 export default defineAction({
   agentTool: false,
   description:
@@ -172,7 +150,7 @@ export default defineAction({
       },
     );
     const root = saved.config as Record<string, unknown>;
-    await syncToCollab(dashboardId, root);
+    queueDashboardCollabSync(dashboardId, root, "agent");
 
     const compact = compactDashboardResult(root, orderResult.movedPanelIds);
     return {

package/corpus/templates/analytics/actions/restore-dashboard-revision.ts

@@ -1,15 +1,11 @@
 import { defineAction } from "@agent-native/core";
-import {
-  applyText,
-  hasCollabState,
-  seedFromText,
-} from "@agent-native/core/collab";
 import {
   getRequestOrgId,
   getRequestUserEmail,
 } from "@agent-native/core/server";
 import { z } from "zod";
 
+import { queueDashboardCollabSync } from "../server/lib/dashboard-collab-sync";
 import { restoreDashboardRevision } from "../server/lib/dashboards-store";
 
 function resolveScope() {
@@ -19,25 +15,6 @@ function resolveScope() {
   return { orgId, email };
 }
 
-async function syncToCollab(
-  dashboardId: string,
-  config: Record<string, unknown>,
-  requestSource?: string,
-): Promise<void> {
-  const docId = `dash-${dashboardId}`;
-  const configStr = JSON.stringify(config);
-  try {
-    const exists = await hasCollabState(docId);
-    if (exists) {
-      await applyText(docId, configStr, "content", requestSource);
-    } else {
-      await seedFromText(docId, configStr);
-    }
-  } catch {
-    // SQL is the source of truth; open editors also refetch on the dashboards signal.
-  }
-}
-
 export default defineAction({
   description:
     "Restore a dashboard to a saved history revision, snapshotting the current dashboard first.",
@@ -63,7 +40,7 @@ export default defineAction({
       );
     }
     const { dashboard, snapshotRevisionId } = restored;
-    await syncToCollab(
+    queueDashboardCollabSync(
       dashboard.id,
       dashboard.config,
       actionContext?.caller === "frontend" ? undefined : "agent",

package/corpus/templates/analytics/actions/update-dashboard.ts

@@ -1,9 +1,4 @@
 import { defineAction, embedApp } from "@agent-native/core";
-import {
-  hasCollabState,
-  applyText,
-  seedFromText,
-} from "@agent-native/core/collab";
 import {
   getRequestUserEmail,
   getRequestOrgId,
@@ -13,6 +8,7 @@ import { z } from "zod";
 
 import { interpolate } from "../app/pages/adhoc/sql-dashboard/interpolate";
 import { dryRunQuery } from "../server/lib/bigquery";
+import { queueDashboardCollabSync } from "../server/lib/dashboard-collab-sync";
 import { validateFirstPartyDashboardTimeScope } from "../server/lib/dashboard-time-scope";
 import {
   upsertDashboard,
@@ -536,30 +532,6 @@ function opCanChangePanelSql(op: JsonOp): boolean {
   );
 }
 
-/**
- * Push a config update through the collab layer so open dashboard editors
- * receive the change in real time. Seeds the collab state if it doesn't
- * exist yet (e.g. dashboard was created before the collab plugin was added).
- */
-async function syncToCollab(
-  dashboardId: string,
-  config: Record<string, unknown>,
-  requestSource?: string,
-): Promise<void> {
-  const docId = `dash-${dashboardId}`;
-  const configStr = JSON.stringify(config);
-  try {
-    const exists = await hasCollabState(docId);
-    if (exists) {
-      await applyText(docId, configStr, "content", requestSource);
-    } else {
-      await seedFromText(docId, configStr);
-    }
-  } catch {
-    // Collab sync is best-effort — the SQL write is the source of truth
-  }
-}
-
 function isAgentCaller(caller: string | undefined): boolean {
   return caller === "tool" || caller === "mcp" || caller === "a2a";
 }
@@ -642,7 +614,7 @@ export default defineAction({
       const sqlError = await validatePanelSql(args.config);
       if (sqlError) throw new Error(sqlError);
       await upsertDashboard(dashboardId, "sql", args.config, ctx);
-      await syncToCollab(
+      queueDashboardCollabSync(
         dashboardId,
         args.config,
         isAgentCaller(actionContext?.caller) ? "agent" : undefined,
@@ -675,7 +647,7 @@ export default defineAction({
         },
       );
       const root = saved.config as Record<string, unknown>;
-      await syncToCollab(
+      queueDashboardCollabSync(
         dashboardId,
         root,
         isAgentCaller(actionContext?.caller) ? "agent" : undefined,
@@ -721,7 +693,7 @@ export default defineAction({
       },
     );
     const root = saved.config as Record<string, unknown>;
-    await syncToCollab(
+    queueDashboardCollabSync(
       dashboardId,
       root,
       isAgentCaller(actionContext?.caller) ? "agent" : undefined,

package/corpus/templates/analytics/app/components/layout/CommandPalette.tsx

@@ -1,6 +1,6 @@
 import { ChangelogDialog } from "@agent-native/core/client/changelog";
 import { callAction, useChangeVersions } from "@agent-native/core/client/hooks";
-import { LanguagePicker, useT } from "@agent-native/core/client/i18n";
+import { useT } from "@agent-native/core/client/i18n";
 import { useOrgRole } from "@agent-native/core/client/org";
 import {
   IconFlask,
@@ -11,7 +11,6 @@ import {
   IconMoon,
   IconHistory,
   IconHierarchy2,
-  IconLanguage,
   IconRefresh,
   IconSettings,
 } from "@tabler/icons-react";
@@ -41,13 +40,6 @@ import {
   CommandGroup,
   CommandItem,
 } from "@/components/ui/command";
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-} from "@/components/ui/dialog";
-import { Label } from "@/components/ui/label";
 import { Skeleton } from "@/components/ui/skeleton";
 import { useReplayStorageStatus } from "@/hooks/use-replay-storage-status";
 import { dashboardCacheScope } from "@/lib/prefetch-keys";
@@ -263,7 +255,6 @@ export function CommandPalette() {
   const dashboardScope = dashboardCacheScope(auth);
   const [open, setOpen] = useState(false);
   const [changelogOpen, setChangelogOpen] = useState(false);
-  const [languageOpen, setLanguageOpen] = useState(false);
   const [searchQuery, setSearchQuery] = useState("");
   const [selectedCommand, setSelectedCommand] = useState("");
   const commandListRef = useRef<HTMLDivElement>(null);
@@ -553,25 +544,6 @@ export function CommandPalette() {
               key="appearance"
               heading={t("commandPalette.groupAppearance")}
             >
-              <CommandItem
-                value={`appearance:language:${t("settings.languageTitle")}`}
-                onSelect={() => {
-                  setOpen(false);
-                  setLanguageOpen(true);
-                }}
-                keywords={commandPaletteKeywords(
-                  t("settings.languageTitle"),
-                  t("settings.languageLabel"),
-                  "language",
-                  "locale",
-                  "translation",
-                  "internationalization",
-                  "i18n",
-                )}
-              >
-                <IconLanguage className="me-2 h-4 w-4 text-muted-foreground" />
-                {t("settings.languageTitle")}
-              </CommandItem>
               <CommandItem
                 value={`appearance:theme:${
                   isDark
@@ -678,17 +650,6 @@ export function CommandPalette() {
         onOpenChange={setChangelogOpen}
         markdown={changelog}
       />
-      <Dialog open={languageOpen} onOpenChange={setLanguageOpen}>
-        <DialogContent className="max-w-sm">
-          <DialogHeader>
-            <DialogTitle>{t("settings.languageTitle")}</DialogTitle>
-          </DialogHeader>
-          <div className="space-y-1.5">
-            <Label>{t("settings.languageLabel")}</Label>
-            <LanguagePicker label={t("settings.languageLabel")} />
-          </div>
-        </DialogContent>
-      </Dialog>
     </>
   );
 }

package/corpus/templates/analytics/changelog/2026-08-07-language-selection-now-lives-in-settings-instead-of-the-comm.md

@@ -0,0 +1,6 @@
+---
+type: changed
+date: 2026-08-07
+---
+
+Language selection now lives in Settings instead of the command menu.

package/corpus/templates/analytics/netlify.toml

@@ -18,6 +18,13 @@ AGENT_PROD_CODE_EXECUTION = "sandboxed"
 # turns on the durable background worker instead of the short foreground wall.
 AGENT_CHAT_DURABLE_BACKGROUND = "true"
 
+[context.production.environment]
+# Analytics owns its schema at release time (`migrate:production` above), so
+# production request functions skip migrations. Preview functions still run
+# request-path migrations because previews do not run the production release
+# migration step.
+AGENT_NATIVE_RELEASE_MIGRATIONS = "1"
+
 # A2A delegation calls run a full agent loop (LLM + tool calls + DB queries).
 # Hosted agent chat uses a soft timeout before this function timeout so the
 # hidden auto-continuation path can hand off before Netlify kills the function.