@agent-native/core 0.176.4-nightly-20260902015502 → 0.176.4-nightly-20260902024948

package/corpus/templates/forms/actions/db-connect.ts

@@ -5,15 +5,18 @@ export default defineAction({
   description:
     "Explain how to configure deployment-level database connection settings.",
   schema: z.object({
-    url: z.string().describe("DATABASE_URL value (required)"),
-    token: z.string().optional().describe("DATABASE_AUTH_TOKEN value"),
+    url: z.string().describe("Forms database URL value (required)"),
+    token: z
+      .string()
+      .optional()
+      .describe("Forms database auth token value (optional)"),
   }),
   http: false,
   run: async (args) => {
     const maskedUrl = args.url.replace(/\/\/.*@/, "//***@");
     return [
       `Database connection not written: ${maskedUrl}.`,
-      "DATABASE_URL and DATABASE_AUTH_TOKEN are deployment-level database settings.",
+      "For Forms, configure FORMS_DATABASE_URL_UNPOOLED when available, otherwise FORMS_DATABASE_URL. DATABASE_URL_UNPOOLED and DATABASE_URL are supported fallbacks. Use the matching *_DATABASE_AUTH_TOKEN for libSQL.",
       "Configure them with your hosting provider and redeploy the app.",
     ].join(" ");
   },

package/corpus/templates/forms/actions/db-status.ts

@@ -1,5 +1,9 @@
 import { defineAction } from "@agent-native/core/action";
-import { createClient } from "@libsql/client";
+import {
+  getDbExec,
+  getRuntimeDatabaseUrl,
+  isLocalDatabase,
+} from "@agent-native/core/db";
 import { z } from "zod";
 
 export default defineAction({
@@ -7,15 +11,11 @@ export default defineAction({
   schema: z.object({}),
   http: false,
   run: async () => {
-    const url = process.env.DATABASE_URL || "file:./data/app.db";
-    const isLocal = url.startsWith("file:");
+    const url = getRuntimeDatabaseUrl("file:./data/app.db");
+    const isLocal = isLocalDatabase();
 
     try {
-      const client = createClient({
-        url,
-        authToken: process.env.DATABASE_AUTH_TOKEN,
-      });
-      const result = await client.execute("SELECT 1 as ok");
+      const result = await getDbExec().execute("SELECT 1 as ok");
       return {
         url: isLocal ? url : url.replace(/\/\/.*@/, "//***@"),
         mode: isLocal ? "local (SQLite file)" : "remote (cloud)",

package/corpus/templates/forms/app/hooks/use-db-status.ts

@@ -19,8 +19,12 @@ export function useDbStatus() {
     staleTime: 30_000,
   });
 
-  const dbUrlEntry = data?.find((e) => e.key === "DATABASE_URL");
-  const configured = dbUrlEntry?.configured ?? false;
+  const configured =
+    data?.some(
+      (entry) =>
+        /(?:^|_)DATABASE_URL(?:_UNPOOLED)?$/.test(entry.key) &&
+        entry.configured,
+    ) ?? false;
 
   return {
     configured,

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

@@ -3,12 +3,47 @@ import { createCoreRoutesPlugin } from "@agent-native/core/server";
 export default createCoreRoutesPlugin({
   googleOAuthManagedConnection: "not_applicable",
   envKeys: [
+    {
+      key: "FORMS_DATABASE_URL",
+      label: "Forms Database URL",
+      required: false,
+    },
+    {
+      key: "FORMS_DATABASE_URL_UNPOOLED",
+      label: "Forms Unpooled Database URL",
+      required: false,
+    },
+    {
+      key: "FORMS_DATABASE_AUTH_TOKEN",
+      label: "Forms Database Auth Token",
+      required: false,
+    },
     { key: "DATABASE_URL", label: "Database URL", required: false },
+    {
+      key: "DATABASE_URL_UNPOOLED",
+      label: "Unpooled Database URL",
+      required: false,
+    },
+    {
+      key: "NETLIFY_DATABASE_URL",
+      label: "Netlify Database URL",
+      required: false,
+    },
+    {
+      key: "NETLIFY_DATABASE_URL_UNPOOLED",
+      label: "Netlify Unpooled Database URL",
+      required: false,
+    },
     {
       key: "DATABASE_AUTH_TOKEN",
       label: "Database Auth Token",
       required: false,
     },
+    {
+      key: "NETLIFY_DATABASE_AUTH_TOKEN",
+      label: "Netlify Database Auth Token",
+      required: false,
+    },
     {
       key: "TURNSTILE_SECRET_KEY",
       label: "Turnstile Secret Key",

package/corpus/templates/forms/server/routes/api/db-health.get.ts

@@ -1,3 +1,4 @@
+import { getRuntimeDatabaseUrl } from "@agent-native/core/db";
 import { sql } from "drizzle-orm";
 import { defineEventHandler } from "h3";
 
@@ -7,7 +8,7 @@ export default defineEventHandler(async () => {
   try {
     const db = getDb();
     await db.run(sql`SELECT 1`);
-    const url = process.env.DATABASE_URL || "file:./data/app.db";
+    const url = getRuntimeDatabaseUrl("file:./data/app.db");
     return { ok: true, local: url.startsWith("file:") };
   } catch (e) {
     return { ok: false, error: e instanceof Error ? e.message : "Unknown" };

package/dist/client/EnvironmentBadge.d.ts

@@ -1,5 +1,5 @@
 import type { AgentNativeDeploymentEnvironment, AgentNativeConfig } from "../config.js";
-export { BETA_FORCE_QUERY_PARAM, BETA_FORCE_SESSION_STORAGE_KEY, BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, type EnvironmentBadgeTargets, } from "../shared/environment-lanes.js";
+export { BETA_FORCE_QUERY_PARAM, BETA_FORCE_SESSION_STORAGE_KEY, BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, BETA_REDIRECT_DURATION_MS, BETA_REDIRECT_STORAGE_KEY, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, type EnvironmentBadgeTargets, } from "../shared/environment-lanes.js";
 export declare function isBuilderIoEmployee(email: string | null | undefined): boolean;
 export declare function isAgentNativeDesktopUserAgent(userAgent: string | undefined): boolean;
 export declare function resolveEnvironmentChannel(config: AgentNativeConfig, hostname: string | undefined): Extract<AgentNativeDeploymentEnvironment, "local" | "beta" | "production"> | null;

package/dist/client/EnvironmentBadge.js

@@ -2,12 +2,12 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Button } from "@agent-native/toolkit/ui/button";
 import { Popover, PopoverContent, PopoverTrigger, } from "@agent-native/toolkit/ui/popover";
 import { useEffect, useMemo, useRef, useState } from "react";
-import { BETA_FORCE_QUERY_PARAM, BETA_FORCE_SESSION_STORAGE_KEY, BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, } from "../shared/environment-lanes.js";
+import { BETA_FORCE_QUERY_PARAM, BETA_FORCE_SESSION_STORAGE_KEY, BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, BETA_REDIRECT_DURATION_MS, BETA_REDIRECT_STORAGE_KEY, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, } from "../shared/environment-lanes.js";
 import { trackEvent } from "./analytics.js";
 import { injectedAgentNativeConfig } from "./app-config.js";
 import { useSession } from "./use-session.js";
 import { cn } from "./utils.js";
-export { BETA_FORCE_QUERY_PARAM, BETA_FORCE_SESSION_STORAGE_KEY, BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, } from "../shared/environment-lanes.js";
+export { BETA_FORCE_QUERY_PARAM, BETA_FORCE_SESSION_STORAGE_KEY, BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, BETA_REDIRECT_DURATION_MS, BETA_REDIRECT_STORAGE_KEY, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, } from "../shared/environment-lanes.js";
 export function isBuilderIoEmployee(email) {
     return email?.trim().toLowerCase().endsWith("@builder.io") ?? false;
 }
@@ -50,6 +50,16 @@ function readBetaOptOutUntil(now = Date.now()) {
     }
     return null;
 }
+function rememberBetaRedirectPreference() {
+    if (typeof window === "undefined")
+        return;
+    try {
+        window.localStorage.setItem(BETA_REDIRECT_STORAGE_KEY, String(Date.now() + BETA_REDIRECT_DURATION_MS));
+    }
+    catch {
+        // coercion-ok: the marker is only a performance hint; session auth remains authoritative.
+    }
+}
 function rememberForcedProductionSession(sourceHref) {
     let forcedByQuery = false;
     try {
@@ -90,6 +100,7 @@ function consumeBetaOptOutQueryParam(sourceHref, now = Date.now()) {
     try {
         if (active) {
             window.localStorage.setItem(BETA_OPT_OUT_STORAGE_KEY, String(Number(rawExpiry)));
+            window.localStorage.removeItem(BETA_REDIRECT_STORAGE_KEY);
         }
         window.history.replaceState(null, "", target.toString());
     }
@@ -151,6 +162,7 @@ function ProductionEnvironmentBadge({ targets, }) {
         const betaHref = buildEnvironmentUrl(window.location.href, targets.betaHost);
         if (!betaHref || typeof window.location.replace !== "function")
             return;
+        rememberBetaRedirectPreference();
         didAutoRedirect.current = true;
         trackEvent("environment switched", {
             from_environment: "production",

package/dist/client/analytics.d.ts

@@ -23,6 +23,7 @@ declare global {
             workspaceGatewayUrl?: string;
             workspaceOAuthOrigin?: string;
             workspaceRuntime?: boolean;
+            workspaceAppMountPaths?: string[];
             sentryDsn?: string;
             sentryEnvironment?: string;
             deploymentEnvironment?: string;

package/dist/client/app-providers.js

@@ -56,6 +56,8 @@ import { ThemeProvider, useTheme } from "next-themes";
 import { useEffect, useRef } from "react";
 import { useInRouterContext } from "react-router";
 import { isHumanReadableDocumentTitle, normalizeDocumentTitle, } from "../shared/document-title.js";
+import { getSsrBetaRedirectScriptBody } from "../shared/ssr-beta-redirect.js";
+import { agentNativePath } from "./api-path.js";
 import { ClientOnly } from "./ClientOnly.js";
 import { DefaultSpinner } from "./DefaultSpinner.js";
 import { EnvironmentBadge } from "./EnvironmentBadge.js";
@@ -68,6 +70,11 @@ import { RuntimeConfigNotice } from "./RuntimeConfigNotice.js";
 import { EMBEDDED_THEME_CHANGE_EVENT, applyEmbeddedThemeUpdate, parseEmbeddedThemeUpdate, } from "./theme.js";
 import { createAgentNativeServerActionWebMcpRegistration } from "./webmcp.js";
 const DEFAULT_TOASTER = (_jsx(Toaster, { richColors: true, position: "bottom-left", offset: { bottom: 44, left: 32 }, mobileOffset: { bottom: 44, left: 16 } }));
+function EarlyBetaRedirectScript() {
+    return (_jsx("script", { "data-agent-native-beta-redirect": "1", dangerouslySetInnerHTML: {
+            __html: getSsrBetaRedirectScriptBody(agentNativePath("/_agent-native/auth/session")),
+        } }));
+}
 function RoutedAppEnhancements() {
     const isInRouter = useInRouterContext();
     if (!isInRouter)
@@ -165,5 +172,7 @@ export function AppProviders({ queryClient, isPublicPath = false, clientOnlyFall
     if (isPublicPath) {
         return (_jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, i18n: i18n, documentTitleFallback: documentTitleFallback, showProductionEnvironmentBadge: false, children: children }));
     }
-    return (_jsx(ClientOnly, { fallback: fallback, children: _jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, i18n: i18n, documentTitleFallback: documentTitleFallback, showProductionEnvironmentBadge: !sessionBypass, children: _jsx(RequireSession, { bypass: sessionBypass, fallback: fallback, children: sessionBypass ? (children) : (_jsxs(FirstRunOnboardingStartupGate, { children: [_jsx(AutomaticWebMcpActionRegistration, {}), children] })) }) }) }));
+    // Keep the bootstrap outside ClientOnly so the HTML parser can run it before
+    // the authenticated client bundle starts.
+    return (_jsxs(_Fragment, { children: [!sessionBypass && _jsx(EarlyBetaRedirectScript, {}), _jsx(ClientOnly, { fallback: fallback, children: _jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, i18n: i18n, documentTitleFallback: documentTitleFallback, showProductionEnvironmentBadge: !sessionBypass, children: _jsx(RequireSession, { bypass: sessionBypass, fallback: fallback, children: sessionBypass ? (children) : (_jsxs(FirstRunOnboardingStartupGate, { children: [_jsx(AutomaticWebMcpActionRegistration, {}), children] })) }) }) })] }));
 }

package/dist/client/sign-out.js

@@ -1,3 +1,4 @@
+import { BETA_REDIRECT_SIGN_OUT_STORAGE_KEY, BETA_REDIRECT_STORAGE_KEY, } from "../shared/environment-lanes.js";
 /**
  * The one client-side sign-out.
  *
@@ -27,6 +28,34 @@ import { beginSignOut, completeSignOut } from "./use-session.js";
 const LOGOUT_PATH = "/_agent-native/auth/logout";
 const SIGN_OUT_REQUEST_TIMEOUT_MS = 15_000;
 let signOutOperation = null;
+function setBetaRedirectSignOutSignal() {
+    const signOutWindow = window;
+    signOutWindow.__agentNativeBetaRedirectSignOutStarted = true;
+    try {
+        window.sessionStorage.setItem(BETA_REDIRECT_SIGN_OUT_STORAGE_KEY, "1");
+    }
+    catch {
+        // coercion-ok: the in-memory signal still protects this document when storage is unavailable.
+    }
+}
+function clearBetaRedirectSignOutSignal() {
+    const signOutWindow = window;
+    signOutWindow.__agentNativeBetaRedirectSignOutStarted = false;
+    try {
+        window.sessionStorage.removeItem(BETA_REDIRECT_SIGN_OUT_STORAGE_KEY);
+    }
+    catch {
+        // coercion-ok: sign-out navigation must not depend on optional storage.
+    }
+}
+function clearBetaRedirectMarker() {
+    try {
+        window.localStorage.removeItem(BETA_REDIRECT_STORAGE_KEY);
+    }
+    catch {
+        // coercion-ok: local storage is optional; sign-out must still complete.
+    }
+}
 /**
  * Sign the current user out and leave for the sign-in page when revocation
  * succeeds. A failed revoke reloads the current document instead.
@@ -41,6 +70,7 @@ export function signOut(options = {}) {
     return signOutOperation;
 }
 async function signOutFlow(options) {
+    setBetaRedirectSignOutSignal();
     beginSignOut();
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), SIGN_OUT_REQUEST_TIMEOUT_MS);
@@ -69,6 +99,8 @@ async function signOutFlow(options) {
     if (!revoked) {
         // Do not send an unrevoked session through sign-in's continuation, which
         // can immediately authenticate it again.
+        clearBetaRedirectSignOutSignal();
+        clearBetaRedirectMarker();
         window.location.reload();
         return;
     }
@@ -78,5 +110,7 @@ async function signOutFlow(options) {
     completeSignOut();
     // `replace`, not `assign`: the dead authenticated URL must not stay in
     // history, or Back lands on a shell with no session.
+    clearBetaRedirectSignOutSignal();
+    clearBetaRedirectMarker();
     window.location.replace(options.redirectTo ?? buildSignInReturnHref());
 }

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/db/client.d.ts

@@ -60,6 +60,7 @@ export declare function getDatabaseUrl(fallback?: string): string;
  * checks that intentionally inspect the configured deployment value.
  */
 export declare function getRuntimeDatabaseUrl(fallback?: string): string;
+export declare function getRuntimeDatabaseSource(fallback?: string): string;
 /** Same per-app resolution for DATABASE_AUTH_TOKEN (used by Turso/libsql). */
 export declare function getDatabaseAuthToken(): string | undefined;
 /**

package/dist/db/client.js

@@ -59,6 +59,65 @@ function getConfiguredAppDatabaseUrl(suffix) {
 function stripNeonPooler(url) {
     return url.replace(/-pooler(\.[a-z0-9.-]+\.neon\.tech)/, "$1");
 }
+function envDatabaseValue(key) {
+    const value = process.env[key]?.trim();
+    return value || undefined;
+}
+function resolveRuntimeDatabase(fallback = "") {
+    const appName = getAppEnvPrefix();
+    if (appName) {
+        const appUnpooled = envDatabaseValue(`${appName}_DATABASE_URL_UNPOOLED`);
+        if (appUnpooled) {
+            return {
+                url: stripNeonPooler(appUnpooled),
+                source: `${appName}_DATABASE_URL_UNPOOLED`,
+            };
+        }
+        const appUrl = envDatabaseValue(`${appName}_DATABASE_URL`);
+        if (appUrl) {
+            return {
+                url: isServerlessRuntime() ? stripNeonPooler(appUrl) : appUrl,
+                source: `${appName}_DATABASE_URL`,
+            };
+        }
+    }
+    const configuredUnpooled = getAppConfig().runtime.databaseUrlUnpooled;
+    if (configuredUnpooled) {
+        const netlifyUnpooled = envDatabaseValue("NETLIFY_DATABASE_URL_UNPOOLED");
+        const databaseUnpooled = envDatabaseValue("DATABASE_URL_UNPOOLED");
+        return {
+            url: stripNeonPooler(configuredUnpooled),
+            source: netlifyUnpooled === configuredUnpooled
+                ? "NETLIFY_DATABASE_URL_UNPOOLED"
+                : databaseUnpooled === configuredUnpooled
+                    ? "DATABASE_URL_UNPOOLED"
+                    : "DATABASE_URL_UNPOOLED",
+        };
+    }
+    const netlifyUnpooled = envDatabaseValue("NETLIFY_DATABASE_URL_UNPOOLED");
+    if (netlifyUnpooled) {
+        return {
+            url: stripNeonPooler(netlifyUnpooled),
+            source: "NETLIFY_DATABASE_URL_UNPOOLED",
+        };
+    }
+    const databaseUnpooled = envDatabaseValue("DATABASE_URL_UNPOOLED");
+    if (databaseUnpooled) {
+        return {
+            url: stripNeonPooler(databaseUnpooled),
+            source: "DATABASE_URL_UNPOOLED",
+        };
+    }
+    const url = getDatabaseUrl(fallback);
+    return {
+        url: isServerlessRuntime() ? stripNeonPooler(url) : url,
+        source: envDatabaseValue("DATABASE_URL")
+            ? "DATABASE_URL"
+            : envDatabaseValue("NETLIFY_DATABASE_URL")
+                ? "NETLIFY_DATABASE_URL"
+                : "default",
+    };
+}
 /**
  * Resolve the URL used by request-time database clients.
  *
@@ -69,17 +128,10 @@ function stripNeonPooler(url) {
  * checks that intentionally inspect the configured deployment value.
  */
 export function getRuntimeDatabaseUrl(fallback = "") {
-    const appUnpooled = getConfiguredAppDatabaseUrl("DATABASE_URL_UNPOOLED");
-    if (appUnpooled)
-        return stripNeonPooler(appUnpooled);
-    const appUrl = getConfiguredAppDatabaseUrl("DATABASE_URL");
-    if (appUrl)
-        return isServerlessRuntime() ? stripNeonPooler(appUrl) : appUrl;
-    const unpooled = getAppConfig().runtime.databaseUrlUnpooled;
-    if (unpooled)
-        return stripNeonPooler(unpooled);
-    const url = getDatabaseUrl(fallback);
-    return isServerlessRuntime() ? stripNeonPooler(url) : url;
+    return resolveRuntimeDatabase(fallback).url;
+}
+export function getRuntimeDatabaseSource(fallback = "") {
+    return resolveRuntimeDatabase(fallback).source;
 }
 /** Same per-app resolution for DATABASE_AUTH_TOKEN (used by Turso/libsql). */
 export function getDatabaseAuthToken() {

package/dist/db/index.d.ts

@@ -22,6 +22,6 @@ export declare function createDb(config: DbConfig): Promise<(import("drizzle-orm
 export type DrizzleDb = Awaited<ReturnType<typeof createDb>>;
 export { createGetDb } from "./create-get-db.js";
 export { deferMigration, MIGRATION_DEFERRED, runMigrations, withMigrationRuntime, type MigrationEntry, type MigrationRunResult, type MigrationSource, type MigrationSql, } from "./migrations.js";
-export { getDbExec, createDbExec, getDatabaseUrl, getRuntimeDatabaseUrl, getDialect, isLocalDatabase, isPostgres, assertSchemaMutationAllowed, isSchemaMutationStatement, isProductionServerlessFunctionRuntime, intType, closeDbExec, type DbExec, type DbExecConfig, type DbExecQuery, type DbExecStatement, type Dialect, } from "./client.js";
+export { getDbExec, createDbExec, getDatabaseUrl, getRuntimeDatabaseUrl, getRuntimeDatabaseSource, getDialect, isLocalDatabase, isPostgres, assertSchemaMutationAllowed, isSchemaMutationStatement, isProductionServerlessFunctionRuntime, intType, closeDbExec, type DbExec, type DbExecConfig, type DbExecQuery, type DbExecStatement, type Dialect, } from "./client.js";
 export { table, text, integer, now } from "./schema.js";
 export { ensureAdditiveColumns, type EnsureAdditiveColumnsOptions, type EnsureAdditiveColumnsResult, type EnsureAdditiveColumnsLogger, } from "./ensure-additive-columns.js";

package/dist/db/index.js

@@ -21,6 +21,6 @@ export async function createDb(config) {
 }
 export { createGetDb } from "./create-get-db.js";
 export { deferMigration, MIGRATION_DEFERRED, runMigrations, withMigrationRuntime, } from "./migrations.js";
-export { getDbExec, createDbExec, getDatabaseUrl, getRuntimeDatabaseUrl, getDialect, isLocalDatabase, isPostgres, assertSchemaMutationAllowed, isSchemaMutationStatement, isProductionServerlessFunctionRuntime, intType, closeDbExec, } from "./client.js";
+export { getDbExec, createDbExec, getDatabaseUrl, getRuntimeDatabaseUrl, getRuntimeDatabaseSource, getDialect, isLocalDatabase, isPostgres, assertSchemaMutationAllowed, isSchemaMutationStatement, isProductionServerlessFunctionRuntime, intType, closeDbExec, } from "./client.js";
 export { table, text, integer, now } from "./schema.js";
 export { ensureAdditiveColumns, } from "./ensure-additive-columns.js";

package/dist/db/runtime-diagnostics.d.ts

@@ -43,6 +43,11 @@ export interface DatabaseSchemaHealthResult {
 }
 export declare const DEFAULT_REQUIRED_SCHEMA: RequiredSchemaTable[];
 export declare function getDatabaseRuntimeFingerprint(): DatabaseRuntimeFingerprint;
+/**
+ * Report whether a declared database URL represents the effective shared
+ * database, without exposing its value to the caller.
+ */
+export declare function getEffectiveDatabaseEnvStatus(key: string): boolean | undefined;
 export declare function getRuntimeDebugFingerprint(): RuntimeDebugFingerprint;
 export declare function runDatabaseSchemaHealthCheck(options?: {
     exec?: DbExec;

package/dist/db/runtime-diagnostics.js

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { getDialect, getDbExec, getRuntimeDatabaseUrl, } from "./client.js";
+import { getDialect, getDbExec, getRuntimeDatabaseUrl, getRuntimeDatabaseSource, isLocalDatabase, } from "./client.js";
 export const DEFAULT_REQUIRED_SCHEMA = [
     {
         table: "agent_runs",
@@ -74,17 +74,6 @@ function envValue(key) {
 function appEnvPrefix() {
     return envValue("APP_NAME")?.toUpperCase().replace(/-/g, "_");
 }
-function databaseUrlSource() {
-    const appName = appEnvPrefix();
-    if (appName && envValue(`${appName}_DATABASE_URL`)) {
-        return `${appName}_DATABASE_URL`;
-    }
-    if (envValue("DATABASE_URL"))
-        return "DATABASE_URL";
-    if (envValue("NETLIFY_DATABASE_URL"))
-        return "NETLIFY_DATABASE_URL";
-    return "default";
-}
 function databaseAuthTokenConfigured() {
     const appName = appEnvPrefix();
     return Boolean((appName && envValue(`${appName}_DATABASE_AUTH_TOKEN`)) ||
@@ -137,15 +126,28 @@ export function getDatabaseRuntimeFingerprint() {
     const parsed = parseDatabaseUrl(url);
     return {
         configured: Boolean(url),
-        source: databaseUrlSource(),
+        source: getRuntimeDatabaseSource(),
         dialect: getDialect(),
         urlHash: shortHash(url),
         appName: envValue("APP_NAME"),
         authTokenConfigured: databaseAuthTokenConfigured(),
-        netlifyDatabaseUrlConfigured: Boolean(envValue("NETLIFY_DATABASE_URL")),
+        netlifyDatabaseUrlConfigured: Boolean(envValue("NETLIFY_DATABASE_URL") ||
+            envValue("NETLIFY_DATABASE_URL_UNPOOLED")),
         ...parsed,
     };
 }
+/**
+ * Report whether a declared database URL represents the effective shared
+ * database, without exposing its value to the caller.
+ */
+export function getEffectiveDatabaseEnvStatus(key) {
+    if (!/(?:^|_)DATABASE_URL(?:_UNPOOLED)?$/.test(key))
+        return undefined;
+    const database = getDatabaseRuntimeFingerprint();
+    if (!database.configured || isLocalDatabase())
+        return false;
+    return database.source === key;
+}
 export function getRuntimeDebugFingerprint() {
     return {
         app: envValue("APP_NAME") ?? "unknown",

package/dist/deploy/build.js

@@ -1363,6 +1363,43 @@ function getAppOriginClientConfigScript() {
         env.VITE_AGENT_NATIVE_WORKSPACE_APPS_JSON,
       ),
     );
+  const workspaceAppMountPaths = (() => {
+    const raw = firstNonEmpty(
+      env.AGENT_NATIVE_WORKSPACE_APPS_JSON,
+      env.VITE_AGENT_NATIVE_WORKSPACE_APPS_JSON,
+    );
+    if (!raw) return;
+    try {
+      const parsed = JSON.parse(raw);
+      const entries = Array.isArray(parsed)
+        ? parsed
+        : parsed && typeof parsed === "object" && "apps" in parsed
+          ? parsed.apps
+          : null;
+      if (!Array.isArray(entries)) return;
+      const paths = Array.from(
+        new Set(
+          entries
+            .map((entry) => {
+              if (!entry || typeof entry !== "object") return null;
+              const rawPath =
+                typeof entry.path === "string"
+                  ? entry.path
+                  : typeof entry.id === "string"
+                    ? "/" + entry.id
+                    : null;
+              if (!rawPath) return null;
+              const normalized = normalizeAppBasePath(rawPath);
+              return normalized || null;
+            })
+            .filter(Boolean),
+        ),
+      );
+      return paths.length ? paths : undefined;
+    } catch {
+      return;
+    }
+  })();
   const appHomePath = resolveAgentNativeAppHomePath(getAgentNativeAppConfig().app);
   const config = {
     appHomePath,
@@ -1370,6 +1407,7 @@ function getAppOriginClientConfigScript() {
     ...(workspaceGatewayUrl ? { workspaceGatewayUrl } : {}),
     ...(workspaceOAuthOrigin ? { workspaceOAuthOrigin } : {}),
     ...(workspaceRuntime ? { workspaceRuntime: true } : {}),
+    ...(workspaceAppMountPaths ? { workspaceAppMountPaths } : {}),
   };
   if (Object.keys(config).length === 0) return null;
   return (

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;
     ok: boolean;
-    error?: undefined;
 }>>;

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;
 }>>;