@agent-native/core 0.168.1 → 0.168.3

package/corpus/templates/mail/app/global.css

@@ -43,6 +43,20 @@
   --mail-toast-surface: hsl(var(--card));
   --mail-toast-border: hsl(var(--border));
   --mail-overlay-scrim: hsl(0 0% 0% / 0.2);
+  --mail-label-automated-bg: 330 81% 60% / 0.2;
+  --mail-label-automated-text: 336 69% 36%;
+  --mail-label-social-bg: 217 91% 60% / 0.2;
+  --mail-label-social-text: 224 76% 48%;
+  --mail-label-updates-bg: 45 93% 47% / 0.2;
+  --mail-label-updates-text: 32 95% 44%;
+  --mail-label-promotions-bg: 142 71% 45% / 0.2;
+  --mail-label-promotions-text: 142 72% 29%;
+  --mail-label-forums-bg: 199 89% 48% / 0.2;
+  --mail-label-forums-text: 201 96% 32%;
+  --mail-label-finance-bg: 160 84% 39% / 0.2;
+  --mail-label-finance-text: 163 94% 24%;
+  --mail-label-travel-bg: 187 85% 53% / 0.2;
+  --mail-label-travel-text: 192 91% 36%;
 }
 
 .dark {
@@ -81,6 +95,13 @@
   --mail-toast-surface: hsl(0 0% 15%);
   --mail-toast-border: hsl(0 0% 26%);
   --mail-overlay-scrim: hsl(0 0% 6% / 0.32);
+  --mail-label-automated-text: 336 75% 75%;
+  --mail-label-social-text: 213 94% 68%;
+  --mail-label-updates-text: 48 96% 64%;
+  --mail-label-promotions-text: 141 76% 73%;
+  --mail-label-forums-text: 199 95% 74%;
+  --mail-label-finance-text: 152 76% 70%;
+  --mail-label-travel-text: 188 86% 74%;
 }
 
 @layer base {

package/corpus/templates/mail/app/hooks/use-emails.ts

@@ -1453,10 +1453,16 @@ export function useContacts() {
 
 // ─── Labels ──────────────────────────────────────────────────────────────────
 
+export const EMPTY_LABELS: Label[] = [];
+
 export function useLabels() {
   return useQuery<Label[]>({
     queryKey: ["labels"],
     queryFn: () => apiFetch("/api/labels"),
+    // A failed background refresh must not erase the last complete label map.
+    // The layout still surfaces isError so an initial failure has an explicit
+    // retry path instead of looking like an empty mailbox.
+    placeholderData: (previousData) => previousData,
     staleTime: 60_000,
   });
 }

package/corpus/templates/mail/app/hooks/use-navigation-state.ts

@@ -10,6 +10,8 @@ export interface NavigationState {
   selectedThreadIds?: string[];
   search?: string;
   label?: string;
+  activeInboxTab?: string;
+  activeAccounts?: string[];
   queuedDraftId?: string;
   queueScope?: string;
   settingsSection?: string;

package/corpus/templates/mail/app/lib/inbox-tabs.ts

@@ -24,6 +24,11 @@ export const COLLAPSIBLE_VIEW_IDS = [
   "trash",
 ] as const;
 
+// Keep the synthetic remainder tab's UI identity separate from user-label IDs.
+// Its public URL remains `tab=other` for existing links and agent commands.
+export const OTHER_INBOX_TAB_ID = "__inbox_other__";
+export const OTHER_INBOX_TAB_PARAM = "other";
+
 /** Pinned labels include a virtual "important" tab when Google is connected. */
 export function resolvePinnedLabels(
   userPinnedLabels: readonly string[],

package/corpus/templates/mail/app/lib/label-colors.ts

@@ -0,0 +1,47 @@
+export type LabelStyle = {
+  bg: string;
+  text: string;
+};
+
+const labelColors: Record<string, LabelStyle> = {
+  automated: {
+    bg: "bg-[hsl(var(--mail-label-automated-bg))]",
+    text: "text-[hsl(var(--mail-label-automated-text))]",
+  },
+  social: {
+    bg: "bg-[hsl(var(--mail-label-social-bg))]",
+    text: "text-[hsl(var(--mail-label-social-text))]",
+  },
+  updates: {
+    bg: "bg-[hsl(var(--mail-label-updates-bg))]",
+    text: "text-[hsl(var(--mail-label-updates-text))]",
+  },
+  promotions: {
+    bg: "bg-[hsl(var(--mail-label-promotions-bg))]",
+    text: "text-[hsl(var(--mail-label-promotions-text))]",
+  },
+  forums: {
+    bg: "bg-[hsl(var(--mail-label-forums-bg))]",
+    text: "text-[hsl(var(--mail-label-forums-text))]",
+  },
+  finance: {
+    bg: "bg-[hsl(var(--mail-label-finance-bg))]",
+    text: "text-[hsl(var(--mail-label-finance-text))]",
+  },
+  travel: {
+    bg: "bg-[hsl(var(--mail-label-travel-bg))]",
+    text: "text-[hsl(var(--mail-label-travel-text))]",
+  },
+};
+
+export function getLabelStyle(labelId: string): LabelStyle {
+  const normalized = labelId.toLowerCase().replace(/^label:/, "");
+  if (labelColors[normalized]) return labelColors[normalized];
+
+  let hash = 0;
+  for (let i = 0; i < normalized.length; i++) {
+    hash = normalized.charCodeAt(i) + ((hash << 5) - hash);
+  }
+  const options = Object.values(labelColors);
+  return options[Math.abs(hash) % options.length];
+}

package/corpus/templates/mail/app/pages/InboxPage.tsx

@@ -23,6 +23,7 @@ import { useKeyboardShortcuts } from "@/hooks/use-keyboard-shortcuts";
 import { useIsMobile } from "@/hooks/use-mobile";
 import { useNavigationState } from "@/hooks/use-navigation-state";
 import {
+  OTHER_INBOX_TAB_PARAM,
   resolvePinnedLabels,
   pinnedTriageLabels,
   augmentSelfSentLabels,
@@ -260,6 +261,7 @@ export function InboxPage() {
   const { data: settings } = useSettings();
   const [searchParams] = useSearchParams();
   const activeLabel = searchParams.get("label");
+  const activeInboxTab = searchParams.get("tab");
   const routeSearchSuffix = searchParams.toString()
     ? `?${searchParams.toString()}`
     : "";
@@ -304,6 +306,10 @@ export function InboxPage() {
     view === "inbox" &&
     mailLabelsInclude(triageLabels, activeLabel);
   const clientSliceTab = isPinnedTab && !searchQuery;
+  const isOtherTab =
+    view === "inbox" &&
+    activeInboxTab === OTHER_INBOX_TAB_PARAM &&
+    !searchQuery;
   const effectiveLabel = clientSliceTab
     ? undefined
     : (activeLabel ?? undefined);
@@ -349,12 +355,7 @@ export function InboxPage() {
       return filterInboxTabEmails(filtered, activeLabel, pinnedLabels);
     }
     // "Other" tab — the inbox remainder, same partition as its badge.
-    if (
-      !searchQuery &&
-      view === "inbox" &&
-      !activeLabel &&
-      triageLabels.length > 0
-    ) {
+    if (isOtherTab) {
       return filterInboxTabEmails(filtered, null, pinnedLabels);
     }
 
@@ -407,6 +408,7 @@ export function InboxPage() {
     view,
     searchQuery,
     activeLabel,
+    isOtherTab,
     clientSliceTab,
     pinnedLabels,
     triageLabels,
@@ -419,7 +421,10 @@ export function InboxPage() {
   // Clear multi-selection when switching views or label tabs. Do NOT clear on
   // threadId changes — shift+j/k in detail view navigates between threads while
   // extending the selection, so selection must persist across thread nav.
-  useEffect(() => setSelectedIds(new Set()), [view, activeLabel]);
+  useEffect(
+    () => setSelectedIds(new Set()),
+    [view, activeLabel, activeInboxTab],
+  );
 
   // Sync current navigation state to file (write-only, so agent can read it)
   const searchQ = searchParams.get("q") ?? undefined;
@@ -430,10 +435,22 @@ export function InboxPage() {
       focusedEmailId: focusedId ?? undefined,
       search: searchQ,
       label: activeLabel ?? undefined,
+      activeInboxTab: activeInboxTab ?? undefined,
+      activeAccounts:
+        activeAccounts.size > 0 ? Array.from(activeAccounts) : undefined,
       selectedThreadIds:
         selectedThreadIds.length > 0 ? selectedThreadIds : undefined,
     });
-  }, [view, threadId, focusedId, searchQ, activeLabel, selectedThreadIds]); // eslint-disable-line react-hooks/exhaustive-deps
+  }, [
+    view,
+    threadId,
+    focusedId,
+    searchQ,
+    activeLabel,
+    activeInboxTab,
+    activeAccounts,
+    selectedThreadIds,
+  ]); // eslint-disable-line react-hooks/exhaustive-deps
 
   // One-shot agent navigation: agent writes navigate.json, UI reads it, navigates, deletes it
   const { data: navCommand } = navState.command;

package/corpus/templates/mail/netlify.toml

@@ -1,6 +1,6 @@
 [build]
 ignore = "node ./scripts/netlify-ignore-build.mjs mail"
-command = "export DATABASE_URL=${NETLIFY_DATABASE_URL:-$DATABASE_URL} && pnpm install && DATABASE_URL=${NETLIFY_DATABASE_URL_UNPOOLED:-$DATABASE_URL} NITRO_PRESET=netlify pnpm --filter mail build && if [ \"${CONTEXT:-}\" = \"production\" ]; then DATABASE_URL=${NETLIFY_DATABASE_URL_UNPOOLED:-$DATABASE_URL} pnpm --filter mail migrate:production; fi"
+command = "export DATABASE_URL=${NETLIFY_DATABASE_URL:-$DATABASE_URL} && pnpm install && DATABASE_URL=${NETLIFY_DATABASE_URL_UNPOOLED:-$DATABASE_URL} NITRO_PRESET=netlify pnpm --filter mail build && if [ \"${CONTEXT:-}\" = \"production\" ] || [ \"${AGENT_NATIVE_RUN_RELEASE_MIGRATIONS:-}\" = \"1\" ]; then DATABASE_URL=${NETLIFY_DATABASE_URL_UNPOOLED:-$DATABASE_URL} pnpm --filter mail migrate:production; fi"
 publish = "templates/mail/dist"
 functions = "templates/mail/.netlify/functions-internal"
 
@@ -14,6 +14,9 @@ NPM_CONFIG_PRODUCTION = "false"
 AGENT_NATIVE_HOSTED_HARNESS = "true"
 AGENT_NATIVE_ENABLE_KEEP_WARM = "1"
 AGENT_NATIVE_DISABLE_KEEP_WARM_BACKGROUND = "1"
+# Production release migrations own schema setup; request functions must skip
+# migration probes on every serverless invocation.
+AGENT_NATIVE_RELEASE_MIGRATIONS = "1"
 
 # A2A delegation calls run a full agent loop (LLM + tool calls + DB queries).
 # The framework does not impose a default agent-run timeout; if a template sets

package/corpus/templates/mail/server/handlers/emails.ts

@@ -1743,10 +1743,13 @@ export const listLabels = defineEventHandler(async (_event: H3Event) => {
           totalCount: number;
         }
       >();
+      let successfulAccountReads = 0;
+      let failedAccountReads = 0;
       // Fetch labels from each account sequentially to avoid race conditions on the shared map
       for (const { accessToken } of accountTokens) {
         try {
           const res = await gmailListLabels(accessToken);
+          successfulAccountReads += 1;
           for (const label of res.labels || []) {
             if (!label.id || !label.name) continue;
             const gmailId = label.id;
@@ -1791,7 +1794,25 @@ export const listLabels = defineEventHandler(async (_event: H3Event) => {
               });
             }
           }
-        } catch {}
+        } catch {
+          // A partial label map is not safe to return because it drops labels
+          // from accounts that failed and makes counts look authoritative.
+          failedAccountReads += 1;
+        }
+      }
+      if (failedAccountReads > 0) {
+        console.warn(
+          `[listLabels] ${failedAccountReads} Gmail account label read(s) failed`,
+        );
+      }
+      if (
+        accountTokens.length === 0 ||
+        successfulAccountReads === 0 ||
+        failedAccountReads > 0
+      ) {
+        console.error("[listLabels] Gmail label fetch failed");
+        setResponseStatus(_event, 502);
+        return { error: "Unable to load Gmail labels. Please retry." };
       }
       const labels: Label[] = Array.from(labelMap.values());
 
@@ -1821,7 +1842,11 @@ export const listLabels = defineEventHandler(async (_event: H3Event) => {
       }
 
       return labels;
-    } catch {}
+    } catch {
+      console.error("[listLabels] Gmail label request failed");
+      setResponseStatus(_event, 502);
+      return { error: "Unable to load Gmail labels. Please retry." };
+    }
   }
   return readLabels(email);
 });

package/corpus/templates/plan/netlify.toml

@@ -1,6 +1,6 @@
 [build]
 ignore = "node ./scripts/netlify-ignore-build.mjs plan"
-command = "export DATABASE_URL=${NETLIFY_DATABASE_URL:-$DATABASE_URL} && pnpm install && NITRO_PRESET=netlify pnpm --filter plan build && if [ \"${CONTEXT:-}\" = \"production\" ]; then pnpm --filter plan migrate:production; fi"
+command = "export DATABASE_URL=${NETLIFY_DATABASE_URL:-$DATABASE_URL} && pnpm install && NITRO_PRESET=netlify pnpm --filter plan build && if [ \"${CONTEXT:-}\" = \"production\" ] || [ \"${AGENT_NATIVE_RUN_RELEASE_MIGRATIONS:-}\" = \"1\" ]; then pnpm --filter plan migrate:production; fi"
 publish = "templates/plan/dist"
 functions = "templates/plan/.netlify/functions-internal"
 
@@ -15,6 +15,9 @@ AGENT_CHAT_DURABLE_BACKGROUND = "true"
 AGENT_NATIVE_HOSTED_HARNESS = "true"
 AGENT_NATIVE_ENABLE_KEEP_WARM = "1"
 AGENT_NATIVE_DISABLE_KEEP_WARM_BACKGROUND = "1"
+# Production release migrations own schema setup; request functions must skip
+# migration probes on every serverless invocation.
+AGENT_NATIVE_RELEASE_MIGRATIONS = "1"
 
 # A2A/MCP calls may include plan generation, artifact serialization, and
 # feedback polling. Keep this aligned with other agent-heavy hosted templates.

package/corpus/templates/slides/netlify.toml

@@ -2,7 +2,7 @@
 ignore = "node ./scripts/netlify-ignore-build.mjs slides"
 # Rebuild Core explicitly so a cached Netlify install cannot bundle an older
 # agent loop or A2A handler into Slides' server functions.
-command = "export DATABASE_URL=${NETLIFY_DATABASE_URL:-$DATABASE_URL} && pnpm install && pnpm --filter @agent-native/core build && NITRO_PRESET=netlify pnpm --filter slides build && if [ \"${CONTEXT:-}\" = \"production\" ]; then pnpm --filter slides migrate:production; fi"
+command = "export DATABASE_URL=${NETLIFY_DATABASE_URL:-$DATABASE_URL} && pnpm install && pnpm --filter @agent-native/core build && NITRO_PRESET=netlify pnpm --filter slides build && if [ \"${CONTEXT:-}\" = \"production\" ] || [ \"${AGENT_NATIVE_RUN_RELEASE_MIGRATIONS:-}\" = \"1\" ]; then pnpm --filter slides migrate:production; fi"
 publish = "templates/slides/dist"
 functions = "templates/slides/.netlify/functions-internal"
 
@@ -18,6 +18,9 @@ AGENT_CHAT_DURABLE_BACKGROUND = "true"
 AGENT_NATIVE_HOSTED_HARNESS = "true"
 AGENT_NATIVE_ENABLE_KEEP_WARM = "1"
 AGENT_NATIVE_DISABLE_KEEP_WARM_BACKGROUND = "1"
+# Production release migrations own schema setup; request functions must skip
+# migration probes on every serverless invocation.
+AGENT_NATIVE_RELEASE_MIGRATIONS = "1"
 
 # Function wall for the non-agent long-request paths (deck import/export,
 # image generation). Agent chat opts into the separate Netlify background

package/corpus/templates/tasks/netlify.toml

@@ -1,6 +1,6 @@
 [build]
 ignore = "node ./scripts/netlify-ignore-build.mjs tasks"
-command = "export DATABASE_URL=${NETLIFY_DATABASE_URL:-$DATABASE_URL} && pnpm install && NITRO_PRESET=netlify pnpm --filter tasks build && if [ \"${CONTEXT:-}\" = \"production\" ]; then pnpm --filter tasks migrate:production; fi"
+command = "export DATABASE_URL=${NETLIFY_DATABASE_URL:-$DATABASE_URL} && pnpm install && NITRO_PRESET=netlify pnpm --filter tasks build && if [ \"${CONTEXT:-}\" = \"production\" ] || [ \"${AGENT_NATIVE_RUN_RELEASE_MIGRATIONS:-}\" = \"1\" ]; then pnpm --filter tasks migrate:production; fi"
 publish = "templates/tasks/dist"
 functions = "templates/tasks/.netlify/functions-internal"
 
@@ -9,3 +9,8 @@ GA_MEASUREMENT_ID = "G-ESF7FYXGN9"
 GTM_CONTAINER_ID = "GTM-N3WSTXZ"
 NITRO_PRESET = "netlify"
 NPM_CONFIG_PRODUCTION = "false"
+
+[context.production.environment]
+# Production release migrations own schema setup; request functions must skip
+# migration probes on every serverless invocation.
+AGENT_NATIVE_RELEASE_MIGRATIONS = "1"

package/dist/app-config/migration.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export declare const migrationConfig: z.ZodObject<{
+    releaseMigrations: z.ZodDefault<z.ZodBoolean>;
+    betaSchemaOwner: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/app-config/migration.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export const migrationConfig = z.object({
+    releaseMigrations: z.boolean().default(false).meta({
+        env: "AGENT_NATIVE_RELEASE_MIGRATIONS",
+        doc: "Treat database migrations as release-owned so request runtimes only probe an already-prepared schema.",
+    }),
+    betaSchemaOwner: z.string().trim().min(1).optional().meta({
+        env: "AGENT_NATIVE_BETA_SCHEMA_OWNER",
+        doc: "Schema owner marker embedded in a prebuilt beta server bundle.",
+    }),
+});

package/dist/app-config/schema.d.ts

@@ -40,6 +40,10 @@ export declare const appConfigSchema: z.ZodObject<{
     integrations: z.ZodPrefault<z.ZodObject<{
         allowUnverifiedWebhooks: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
+    migration: z.ZodPrefault<z.ZodObject<{
+        releaseMigrations: z.ZodDefault<z.ZodBoolean>;
+        betaSchemaOwner: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     privateBlob: z.ZodPrefault<z.ZodObject<{
         provider: z.ZodOptional<z.ZodString>;
         publicUploadFallback: z.ZodDefault<z.ZodBoolean>;

package/dist/app-config/schema.js

@@ -4,6 +4,7 @@ import { agentConfig } from "./agent.js";
 import { appConfig } from "./app.js";
 import { authConfig } from "./auth.js";
 import { integrationsConfig } from "./integrations.js";
+import { migrationConfig } from "./migration.js";
 import { privateBlobConfig } from "./private-blob.js";
 import { workspaceConfig } from "./workspace.js";
 /**
@@ -28,6 +29,7 @@ export const appConfigSchema = z.object({
     app: appConfig.prefault({}),
     auth: authConfig.prefault({}),
     integrations: integrationsConfig.prefault({}),
+    migration: migrationConfig.prefault({}),
     privateBlob: privateBlobConfig.prefault({}),
     workspace: workspaceConfig.prefault({}),
 });

package/dist/app-config/store.d.ts

@@ -8,6 +8,14 @@ import { type AppConfig, type AppConfigInput } from "./schema.js";
  */
 declare const LAYER_ORDER: readonly ["env", "legacy", "app"];
 export type AppConfigLayer = (typeof LAYER_ORDER)[number];
+/**
+ * Nitro embeds build-only deployment markers into direct env reads. Netlify's
+ * prebuilt beta lane has those markers while building, but does not copy them
+ * into the deployed Function environment. Keep the embedded values as the
+ * fallback for this one config boundary so a later dynamic `env[key]` read
+ * cannot erase the build decision from the server bundle.
+ */
+export declare function readConfigEnvironment(embedded?: Record<string, string | undefined>): Record<string, string | undefined>;
 /**
  * Writes one layer of the ladder. Framework-internal: the deprecated setters
  * use it to keep working without reintroducing a second namespace.

package/dist/app-config/store.js

@@ -48,6 +48,24 @@ function resolve(envLayer) {
     }
     return appConfigSchema.parse(merged);
 }
+/**
+ * Nitro embeds build-only deployment markers into direct env reads. Netlify's
+ * prebuilt beta lane has those markers while building, but does not copy them
+ * into the deployed Function environment. Keep the embedded values as the
+ * fallback for this one config boundary so a later dynamic `env[key]` read
+ * cannot erase the build decision from the server bundle.
+ */
+export function readConfigEnvironment(embedded = {
+    AGENT_NATIVE_RELEASE_MIGRATIONS: process.env.AGENT_NATIVE_RELEASE_MIGRATIONS,
+    AGENT_NATIVE_BETA_SCHEMA_OWNER: process.env.AGENT_NATIVE_BETA_SCHEMA_OWNER,
+}) {
+    const env = { ...process.env };
+    for (const [key, value] of Object.entries(embedded)) {
+        if (!env[key] && value)
+            env[key] = value;
+    }
+    return env;
+}
 /**
  * Writes one layer of the ladder. Framework-internal: the deprecated setters
  * use it to keep working without reintroducing a second namespace.
@@ -84,7 +102,7 @@ export function defineAppConfig(config) {
  * remove.
  */
 export function getAppConfig() {
-    const envLayer = readEnvConfigLayer(appConfigSchema, process.env);
+    const envLayer = readEnvConfigLayer(appConfigSchema, readConfigEnvironment());
     const signature = JSON.stringify(envLayer);
     if (state.resolved && state.envSignature === signature)
         return state.resolved;

package/dist/collab/awareness.d.ts

@@ -62,11 +62,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
-    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
+    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -77,9 +77,9 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
-    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
+    error?: undefined;
 }>>;

package/dist/collab/routes.d.ts

@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
  * Body: { update: string (base64), requestSource?: string }
  */
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/collab/struct-routes.d.ts

@@ -13,8 +13,8 @@
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
  */
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/db/migrations.js

@@ -1,3 +1,4 @@
+import { getAppConfig } from "../app-config/index.js";
 import { getDbExec, createDbExec, isPostgres, getDialect, getMigrationDatabaseUrl, getCloudflareD1Binding, retrySqliteBusy, } from "./client.js";
 import { isMigrationAuthorizedRuntime } from "./migration-runtime.js";
 // ---------------------------------------------------------------------------
@@ -250,8 +251,15 @@ function isServerlessRequestRuntime() {
  * migration skipping is safe only when that runner owns schema setup.
  */
 function appMigratesAtRelease() {
-    const raw = process.env.AGENT_NATIVE_RELEASE_MIGRATIONS?.trim();
-    return !!raw && ["1", "true", "yes", "on"].includes(raw.toLowerCase());
+    const { migration } = getAppConfig();
+    if (migration.releaseMigrations)
+        return true;
+    // Clips beta uses the production-owned schema but its masked prebuilt build
+    // must not run migrate:production against the fake build database. The
+    // owner marker is embedded into the deployed server bundle and therefore
+    // carries the same request-path skip decision without pretending the masked
+    // build performed the release migration.
+    return migration.betaSchemaOwner?.toLowerCase() === "production";
 }
 /**
  * Run an explicit release-time migration job with migration duty enabled.

package/dist/deploy/build.js

@@ -34,6 +34,7 @@ import { generateActionRegistryForProject } from "../vite/action-types-plugin.js
 import { createAgentNativeConfigContext, loadResolvedAgentNativeConfig, } from "../vite/agent-native-config-loader.js";
 import { cloneServerBundleForFunction, copyDir } from "./function-bundle.js";
 import { collectImmutableAssetPaths, IMMUTABLE_ASSET_CACHE_CONTROL, IMMUTABLE_ASSET_CACHE_HEADERS, prefixAssetPath, } from "./immutable-assets.js";
+import { writeNetlifyStaticHeaders } from "./netlify-static-headers.js";
 import { discoverApiRoutes, discoverPlugins, discoverActionFiles, getMissingDefaultPlugins, DEFAULT_PLUGIN_REGISTRY, } from "./route-discovery.js";
 import { getWorkspaceCoreExports, } from "./workspace-core.js";
 const cwd = process.cwd();
@@ -3892,6 +3893,7 @@ export function resolveNitroBuildReplacements(env = process.env, deploymentEnvir
         // a separate server build, so embed release migration ownership here as
         // well as in the Vite server bundle.
         "process.env.AGENT_NATIVE_RELEASE_MIGRATIONS": JSON.stringify(env.AGENT_NATIVE_RELEASE_MIGRATIONS?.trim() || ""),
+        "process.env.AGENT_NATIVE_BETA_SCHEMA_OWNER": JSON.stringify(env.AGENT_NATIVE_BETA_SCHEMA_OWNER?.trim() || ""),
         "process.env.AGENT_NATIVE_BUILD_DEPLOY_CONTEXT": JSON.stringify(env.CONTEXT?.trim() || env.NETLIFY_CONTEXT?.trim() || ""),
         // Whether the recurring-jobs scheduled function exists is decided HERE, by
         // the build env. `scheduledTriggerAvailability` cannot re-derive it later —
@@ -4087,6 +4089,10 @@ export default bundle;
             }
         }
         writeSingleTemplateNetlifyRedirects(cwd);
+        // React Router prerendered pages bypass the SSR function and are served
+        // directly from Netlify's static backing store. Keep that artifact on the
+        // same public SWR policy as runtime SSR and .data responses.
+        writeNetlifyStaticHeaders(path.join(cwd, "dist"));
         assertSingleTemplateNetlifyBuildOutput(cwd);
     }
     // Resolve remaining bare npm imports by bundling them into _libs/.

package/dist/deploy/netlify-static-headers.d.ts

@@ -0,0 +1,3 @@
+export declare const GENERATED_NETLIFY_HEADERS_MARKER = "# Generated by @agent-native/core deploy/netlify-static-headers.ts";
+export declare function renderNetlifyStaticHeaders(env?: Record<string, string | undefined>): string;
+export declare function writeNetlifyStaticHeaders(publishDir: string, env?: Record<string, string | undefined>): void;

package/dist/deploy/netlify-static-headers.js

@@ -0,0 +1,60 @@
+import fs from "node:fs";
+import path from "node:path";
+import { resolveSsrCacheHeaders } from "../shared/cache-control.js";
+import { IMMUTABLE_ASSET_CACHE_CONTROL } from "./immutable-assets.js";
+export const GENERATED_NETLIFY_HEADERS_MARKER = "# Generated by @agent-native/core deploy/netlify-static-headers.ts";
+const LEGACY_GENERATED_NETLIFY_HEADERS_MARKER = "# Generated by @agent-native/docs scripts/generate-netlify-headers.ts";
+function renderHeaderBlock(pathname, headers) {
+    return [
+        pathname,
+        ...headers.map(([name, value]) => `  ${name}: ${value}`),
+    ].join("\n");
+}
+export function renderNetlifyStaticHeaders(env = process.env) {
+    const ssrHeaders = resolveSsrCacheHeaders(env);
+    const ssrHeaderEntries = [
+        ["Cache-Control", ssrHeaders["cache-control"]],
+        ["CDN-Cache-Control", ssrHeaders["cdn-cache-control"]],
+        ["Netlify-CDN-Cache-Control", ssrHeaders["netlify-cdn-cache-control"]],
+    ];
+    const immutableAssetHeaders = [
+        ["Cache-Control", IMMUTABLE_ASSET_CACHE_CONTROL],
+        ["CDN-Cache-Control", IMMUTABLE_ASSET_CACHE_CONTROL],
+        ["Netlify-CDN-Cache-Control", IMMUTABLE_ASSET_CACHE_CONTROL],
+    ];
+    const internalHeaders = [
+        ["Cache-Control", "no-cache, no-store"],
+        ["CDN-Cache-Control", "no-cache, no-store"],
+        ["Netlify-CDN-Cache-Control", "no-cache, no-store"],
+    ];
+    return ([
+        GENERATED_NETLIFY_HEADERS_MARKER,
+        renderHeaderBlock("/*", ssrHeaderEntries),
+        renderHeaderBlock("/assets/*", immutableAssetHeaders),
+        renderHeaderBlock("/_agent-native/*", internalHeaders),
+    ].join("\n\n") + "\n");
+}
+export function writeNetlifyStaticHeaders(publishDir, env = process.env) {
+    if (!fs.existsSync(publishDir)) {
+        throw new Error(`Netlify publish directory does not exist: ${publishDir}`);
+    }
+    const headersPath = path.join(publishDir, "_headers");
+    const existing = fs.existsSync(headersPath)
+        ? fs.readFileSync(headersPath, "utf8").trim()
+        : "";
+    const generated = renderNetlifyStaticHeaders(env).trim();
+    const generatedStart = [
+        GENERATED_NETLIFY_HEADERS_MARKER,
+        LEGACY_GENERATED_NETLIFY_HEADERS_MARKER,
+    ]
+        .map((marker) => existing.indexOf(marker))
+        .filter((index) => index >= 0)
+        .sort((a, b) => a - b)[0];
+    const existingWithoutGenerated = generatedStart === undefined
+        ? existing
+        : existing.slice(0, generatedStart).trimEnd();
+    const contents = existingWithoutGenerated
+        ? `${existingWithoutGenerated}\n\n${generated}`
+        : generated;
+    fs.writeFileSync(headersPath, `${contents}\n`);
+}

package/dist/notifications/routes.d.ts

@@ -11,14 +11,14 @@
  *   DELETE /_agent-native/notifications/:id         — delete
  */
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
-    error?: undefined;
     count: number;
     updated?: undefined;
+    error?: undefined;
     ok?: undefined;
 } | {
-    error?: undefined;
     count?: undefined;
     updated: number;
+    error?: undefined;
     ok?: undefined;
 } | {
     count?: undefined;
@@ -26,8 +26,8 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     count?: undefined;
     updated?: undefined;
+    error?: undefined;
     ok: boolean;
 }>>;

package/dist/observability/routes.d.ts

@@ -41,16 +41,16 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
-    error?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
+    error?: undefined;
     ok?: undefined;
 } | {
-    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id: string;
+    error?: undefined;
     ok?: undefined;
 } | {
     summary?: undefined;
@@ -59,9 +59,9 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     error: any;
     ok?: undefined;
 } | {
-    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
+    error?: undefined;
     ok: boolean;
 }>>;