@agent-native/core 0.141.6 → 0.144.0

package/dist/client/settings/SettingsTabsPage.js

@@ -1,8 +1,9 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Tabs, useDesignSystem } from "@agent-native/toolkit/design-system";
-import { IconArrowLeft, IconArrowUpRight, IconHistory, IconSearch, IconSettings, IconUserCircle, IconUsers, IconX, } from "@tabler/icons-react";
+import { IconArrowUpRight, IconHistory, IconSearch, IconSettings, IconUserCircle, IconUsers, IconX, } from "@tabler/icons-react";
 import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
 import { Link } from "react-router";
+import { buildSettingsRoute } from "../../navigation/index.js";
 import { cn } from "../utils.js";
 function normalizeTabId(value) {
     let decoded = value?.replace(/^#/, "").trim() ?? "";
@@ -61,17 +62,52 @@ function resolveTabId(tabs, value) {
     }
     return null;
 }
-function activeTabFromHash(tabs, defaultTab) {
+function activeTabFromLocation(tabs, defaultTab) {
     if (typeof window === "undefined")
         return defaultTab;
+    const settingsPrefix = "/settings";
+    if (window.location.pathname === settingsPrefix) {
+        return resolveTabId(tabs, window.location.hash) ?? defaultTab;
+    }
+    if (window.location.pathname.startsWith(`${settingsPrefix}/`)) {
+        const segments = window.location.pathname
+            .slice(`${settingsPrefix}/`.length)
+            .split("/")
+            .filter(Boolean)
+            .map((segment) => {
+            try {
+                return decodeURIComponent(segment);
+            }
+            catch {
+                return segment;
+            }
+        });
+        for (let length = segments.length; length > 0; length -= 1) {
+            const tabId = resolveTabId(tabs, segments.slice(0, length).join(":"));
+            if (tabId)
+                return tabId;
+        }
+    }
     return resolveTabId(tabs, window.location.hash) ?? defaultTab;
 }
-function updateHashForTab(tabId) {
+function buildSettingsEntryRoute(tabId, section) {
+    const normalizedSection = section?.replace(/^#/, "").trim();
+    if (!normalizedSection || normalizedSection === tabId) {
+        return buildSettingsRoute(tabId);
+    }
+    if (normalizedSection.startsWith("agent:")) {
+        return buildSettingsRoute(normalizedSection);
+    }
+    if (normalizedSection.startsWith(`${tabId}:`)) {
+        return buildSettingsRoute(normalizedSection);
+    }
+    return buildSettingsRoute(`${tabId}:${normalizedSection}`);
+}
+function updateRouteForTab(tabId, section) {
     if (typeof window === "undefined")
         return;
-    const { pathname, search } = window.location;
-    const hash = tabId === "general" ? "" : `#${tabId}`;
-    window.history.pushState(null, "", `${pathname}${search}${hash}`);
+    const route = buildSettingsEntryRoute(tabId, section);
+    window.history.pushState(null, "", `${route}${window.location.search}`);
 }
 function isEditableElement(element) {
     if (!(element instanceof HTMLElement))
@@ -82,7 +118,7 @@ function isEditableElement(element) {
         tagName === "select" ||
         element.isContentEditable);
 }
-export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs = [], generalLabel = "General", accountLabel = "Account", teamLabel = "Team", whatsNewLabel = "What's new", ariaLabel = "Settings sections", defaultTab = "integrations", className, navClassName, contentClassName, enableSearch = true, searchPlaceholder = "Search settings", searchEntries, generalSearchEntries, value, onValueChange, }) {
+export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs = [], generalLabel = "General", accountLabel = "Account", teamLabel = "Team", whatsNewLabel = "What's new", ariaLabel = "Settings sections", defaultTab = "general", className, navClassName, contentClassName, enableSearch = true, searchPlaceholder = "Search settings", searchEntries, generalSearchEntries, value, onValueChange, }) {
     const rootRef = useRef(null);
     const searchInputRef = useRef(null);
     const autoFocusedSearchRef = useRef(false);
@@ -166,7 +202,7 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
         agent: "Agent",
     };
     const isControlled = value !== undefined;
-    const [internalTab, setInternalTab] = useState(() => activeTabFromHash(tabs, fallbackTab));
+    const [internalTab, setInternalTab] = useState(() => activeTabFromLocation(tabs, fallbackTab));
     const activeTab = isControlled ? value : internalTab;
     const [query, setQuery] = useState("");
     const designSystem = useDesignSystem();
@@ -186,39 +222,55 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
         setInternalTab(fallbackTab);
     }, [fallbackTab, internalTab, isControlled, tabs]);
     useEffect(() => {
-        // Hash-driven tab tracking only applies to the uncontrolled mode. Only
-        // react to hashes that name a top-level tab. Section-level hashes
-        // (e.g. `#llm`, `#secrets`) are consumed by the inner panels, so leave
-        // the active tab untouched to avoid bouncing back to General.
         if (isControlled)
             return;
-        const handleHashChange = () => {
-            const fromHash = resolveTabId(tabs, window.location.hash);
-            if (fromHash) {
-                setInternalTab(fromHash);
-            }
+        const syncLocation = () => {
+            const fromPath = activeTabFromLocation(tabs, fallbackTab);
+            if (fromPath)
+                setInternalTab(fromPath);
+            if (window.location.pathname.startsWith("/settings/"))
+                return;
+            const hashValue = window.location.hash.replace(/^#/, "");
+            const fromHash = resolveTabId(tabs, hashValue);
+            if (!fromHash || !hashValue)
+                return;
+            const isTabHash = fromHash === hashValue;
+            updateRouteForTab(fromHash, isTabHash ? undefined : hashValue);
+        };
+        syncLocation();
+        window.addEventListener("hashchange", syncLocation);
+        window.addEventListener("popstate", syncLocation);
+        return () => {
+            window.removeEventListener("hashchange", syncLocation);
+            window.removeEventListener("popstate", syncLocation);
         };
-        window.addEventListener("hashchange", handleHashChange);
-        return () => window.removeEventListener("hashchange", handleHashChange);
-    }, [isControlled, tabs]);
+    }, [fallbackTab, isControlled, tabs]);
     useEffect(() => {
-        // Controlled pages retain ownership of their active state, but shared
-        // organization navigation uses a hash deep link. Report only recognized
-        // top-level tab hashes; section hashes remain available to inner panels.
         if (!isControlled)
             return;
-        const syncControlledHash = () => {
-            const hash = window.location.hash;
-            const fromHash = resolveTabId(tabs, hash);
-            if (!fromHash || controlledHashRef.current === hash)
+        const syncControlledLocation = () => {
+            const fromPath = window.location.pathname.startsWith("/settings/")
+                ? activeTabFromLocation(tabs, defaultTab)
+                : null;
+            const hashValue = window.location.hash.replace(/^#/, "");
+            const fromHash = hashValue ? resolveTabId(tabs, hashValue) : null;
+            const next = fromPath ?? fromHash;
+            const key = `${window.location.pathname}${window.location.hash}`;
+            if (!next || next === value || controlledHashRef.current === key) {
+                controlledHashRef.current = key;
                 return;
-            controlledHashRef.current = hash;
-            onValueChange?.(fromHash);
+            }
+            controlledHashRef.current = key;
+            onValueChange?.(next);
+        };
+        syncControlledLocation();
+        window.addEventListener("hashchange", syncControlledLocation);
+        window.addEventListener("popstate", syncControlledLocation);
+        return () => {
+            window.removeEventListener("hashchange", syncControlledLocation);
+            window.removeEventListener("popstate", syncControlledLocation);
         };
-        syncControlledHash();
-        window.addEventListener("hashchange", syncControlledHash);
-        return () => window.removeEventListener("hashchange", syncControlledHash);
-    }, [isControlled, onValueChange, tabs, value]);
+    }, [defaultTab, isControlled, onValueChange, tabs, value]);
     useEffect(() => {
         if (!enableSearch || autoFocusedSearchRef.current)
             return;
@@ -306,24 +358,24 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
         setQuery("");
         if (typeof window === "undefined")
             return;
-        const hash = entry.hash?.replace(/^#/, "");
-        if (hash) {
-            const { pathname, search } = window.location;
-            window.history.pushState(null, "", `${pathname}${search}#${hash}`);
+        const section = entry.hash?.replace(/^#/, "");
+        if (section) {
+            updateRouteForTab(entry.tabId, section);
             // Let the inner panels open + scroll to their section.
+            window.dispatchEvent(new Event("popstate"));
             window.dispatchEvent(new Event("hashchange"));
             window.requestAnimationFrame(() => {
                 document
-                    .getElementById(hash)
+                    .getElementById(section)
                     ?.scrollIntoView({ block: "start", behavior: "smooth" });
             });
         }
         else if (!isControlled) {
-            updateHashForTab(entry.tabId);
+            updateRouteForTab(entry.tabId);
         }
     };
     const searching = enableSearch && trimmedQuery.length > 0;
-    return (_jsxs("div", { ref: rootRef, className: cn("flex h-full min-h-0 w-full flex-col overflow-hidden bg-background sm:flex-row", className), children: [_jsxs("div", { className: cn("flex shrink-0 flex-col gap-2 bg-background p-2 sm:min-h-0 sm:w-60 sm:overflow-y-auto sm:p-4", navClassName), children: [_jsxs("a", { href: "/", className: "flex min-h-8 items-center gap-2 rounded-md px-2 text-sm text-muted-foreground transition-colors hover:bg-accent/50 hover:text-foreground", children: [_jsx(IconArrowLeft, { className: "size-4 shrink-0 rtl:-scale-x-100" }), _jsx("span", { children: "Back to app" })] }), enableSearch ? (_jsxs("div", { className: "relative sm:mb-2", children: [_jsx(IconSearch, { className: "pointer-events-none absolute start-2.5 top-1/2 size-3.5 -translate-y-1/2 text-muted-foreground" }), _jsx("input", { ref: searchInputRef, type: "search", value: query, onChange: (event) => setQuery(event.target.value), onKeyDown: (event) => {
+    return (_jsxs("div", { ref: rootRef, className: cn("flex h-full min-h-0 w-full flex-col overflow-hidden bg-background sm:flex-row", className), children: [_jsxs("div", { className: cn("flex shrink-0 flex-col gap-2 bg-background p-2 sm:min-h-0 sm:w-60 sm:overflow-y-auto sm:p-4", navClassName), children: [enableSearch ? (_jsxs("div", { className: "relative sm:mb-2", children: [_jsx(IconSearch, { className: "pointer-events-none absolute start-2.5 top-1/2 size-3.5 -translate-y-1/2 text-muted-foreground" }), _jsx("input", { ref: searchInputRef, type: "search", value: query, onChange: (event) => setQuery(event.target.value), onKeyDown: (event) => {
                                     if (event.key === "Escape")
                                         setQuery("");
                                     if (event.key === "Enter" && results[0]) {
@@ -333,11 +385,12 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
                                 }, placeholder: searchPlaceholder, "aria-label": searchPlaceholder, className: "h-8 w-full rounded-md border border-border bg-background ps-8 pe-7 text-[13px] text-foreground outline-none transition-colors placeholder:text-muted-foreground focus:border-foreground/30 focus:ring-2 focus:ring-accent/40" }), query ? (_jsx("button", { type: "button", onClick: () => setQuery(""), "aria-label": "Clear search", className: "absolute end-1.5 top-1/2 flex size-5 -translate-y-1/2 items-center justify-center rounded text-muted-foreground hover:bg-accent/60 hover:text-foreground", children: _jsx(IconX, { className: "size-3.5" }) })) : null] })) : null, searching ? (_jsx("div", { role: "listbox", "aria-label": "Settings search results", className: "flex flex-col gap-0.5", children: results.length === 0 ? (_jsx("p", { className: "px-2 py-6 text-center text-[12px] text-muted-foreground", children: "No matching settings" })) : (results.map((entry) => {
                             const Icon = entry.icon;
                             const tab = tabs.find((candidate) => candidate.id === entry.tabId);
+                            const entryHash = entry.hash?.replace(/^#/, "");
                             const resultHref = tab?.href
-                                ? entry.hash
-                                    ? `${tab.href.split("#", 1)[0]}#${entry.hash.replace(/^#/, "")}`
+                                ? entryHash
+                                    ? buildSettingsEntryRoute(entry.tabId, entryHash)
                                     : tab.href
-                                : null;
+                                : buildSettingsEntryRoute(entry.tabId, entryHash);
                             const result = (_jsxs(_Fragment, { children: [Icon ? (_jsx(Icon, { className: "mt-0.5 size-4 shrink-0 text-muted-foreground" })) : null, _jsxs("span", { className: "flex min-w-0 flex-col", children: [_jsx("span", { className: "truncate font-medium", children: entry.label }), _jsx("span", { className: "truncate text-[11px] text-muted-foreground", children: entry.description ?? entry.tabLabel })] })] }));
                             return resultHref ? (_jsx(Link, { to: resultHref, role: "option", "aria-selected": false, className: "flex items-start gap-2 rounded-md px-2.5 py-2 text-start text-sm text-foreground transition-colors hover:bg-accent/60", children: result }, entry.id)) : (_jsx("button", { type: "button", role: "option", "aria-selected": false, onClick: () => selectEntry(entry), className: "flex items-start gap-2 rounded-md px-2.5 py-2 text-start text-sm text-foreground transition-colors hover:bg-accent/60", children: result }, entry.id));
                         })) })) : hasCustomTabs ? (_jsx(Tabs, { items: tabs.map((tab) => ({
@@ -351,7 +404,7 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
                             const nextTab = String(tabId);
                             changeTab(nextTab);
                             if (!isControlled)
-                                updateHashForTab(nextTab);
+                                updateRouteForTab(nextTab);
                         }, orientation: "vertical", "aria-label": ariaLabel, className: "flex gap-1 overflow-x-auto sm:flex-col sm:overflow-x-visible" })) : (_jsx("nav", { "aria-label": ariaLabel, role: "tablist", className: "flex gap-1 overflow-x-auto sm:flex-col sm:overflow-x-visible", children: tabGroups.map((group, groupIndex) => (_jsx("div", { "data-settings-tab-group": group.id, className: cn("contents sm:block", groupIndex > 0 && "sm:mt-3 sm:pt-1"), children: _jsxs("div", { className: "contents sm:flex sm:flex-col sm:gap-1", children: [_jsx("div", { className: "hidden px-3 pb-1 pt-1 text-[11px] font-medium text-muted-foreground sm:block", children: tabGroupLabels[group.id] ?? group.id }), group.tabs.map((tab) => {
                                         const Icon = tab.icon;
                                         const selected = tab.id === selectedTab?.id;
@@ -366,7 +419,7 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
                                         return (_jsx("button", { type: "button", role: "tab", "aria-selected": selected, "aria-controls": `settings-tabpanel-${tab.id}`, id: `settings-tab-${tab.id}`, onClick: () => {
                                                 changeTab(tab.id);
                                                 if (!isControlled)
-                                                    updateHashForTab(tab.id);
+                                                    updateRouteForTab(tab.id);
                                             }, className: cn("flex min-h-9 shrink-0 items-center gap-2 rounded-md px-3 py-2 text-start text-sm font-medium transition-colors sm:w-full", selected
                                                 ? "bg-accent text-foreground"
                                                 : "text-muted-foreground hover:bg-accent/50 hover:text-foreground"), children: tabContent }, tab.id));

package/dist/client/settings/VoiceTranscriptionSection.js

@@ -13,6 +13,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Picker, Switch } from "@agent-native/toolkit/design-system";
 import { IconAlertCircle, IconCheck, IconChevronDown, IconChevronRight, IconExternalLink, IconLoader2, IconLockOpen, } from "@tabler/icons-react";
 import { useCallback, useEffect, useState } from "react";
+import { buildSettingsRoute } from "../../navigation/index.js";
 import { agentNativePath } from "../api-path.js";
 import { SettingsRow } from "./SettingsRow.js";
 import { openBuilderConnectPopup, useBuilderStatus, } from "./useBuilderStatus.js";
@@ -221,7 +222,8 @@ export function VoiceTranscriptionSection({ compact = false, } = {}) {
     const focusKey = (key) => {
         if (typeof window === "undefined")
             return;
-        window.location.hash = `#secrets:${key}`;
+        window.history.pushState(null, "", buildSettingsRoute(`integrations:secrets:${key}`));
+        window.dispatchEvent(new Event("popstate"));
     };
     const chooseSource = (next) => {
         if (next === transcriptionMode)
@@ -266,6 +268,9 @@ export function VoiceTranscriptionSection({ compact = false, } = {}) {
         }
     };
     if (transcriptionMode === null) {
+        if (compact) {
+            return (_jsx(SettingsRow, { label: "Voice transcription", description: "Choose how voice input is transcribed.", control: _jsx("div", { className: "h-9 w-44 animate-pulse rounded-md border border-border bg-muted-foreground/10", "aria-label": "Loading voice transcription" }) }));
+        }
         return (_jsxs("div", { className: "flex items-center gap-1.5 text-[10px] text-muted-foreground", children: [_jsx(IconLoader2, { size: 10, className: "animate-spin" }), "Loading\u2026"] }));
     }
     if (compact) {

package/dist/client/settings/useSettingsPanelController.js

@@ -34,13 +34,35 @@ function firstVisibleSection(sections) {
         return "llm";
     return sections[0] ?? "llm";
 }
+function settingsPathParts() {
+    if (typeof window === "undefined")
+        return [];
+    const pathParts = window.location.pathname.split("/").filter(Boolean);
+    const settingsIndex = pathParts.indexOf("settings");
+    return settingsIndex === -1 ? [] : pathParts.slice(settingsIndex + 1);
+}
+function secretKeyFromPath(pathParts) {
+    const secretsIndex = pathParts.findIndex((part) => part.toLowerCase() === "secrets");
+    if (secretsIndex === -1)
+        return undefined;
+    const key = pathParts.slice(secretsIndex + 1).join("/");
+    return key || undefined;
+}
 function initialOpenSection(sections) {
     const hashSection = typeof window === "undefined"
         ? null
         : normalizeSettingsSection(window.location.hash);
-    return hashSection && sections.includes(hashSection)
-        ? hashSection
-        : firstVisibleSection(sections);
+    if (hashSection && sections.includes(hashSection))
+        return hashSection;
+    if (typeof window !== "undefined") {
+        const routeParts = settingsPathParts();
+        for (let index = routeParts.length - 1; index >= 0; index -= 1) {
+            const pathSection = normalizeSettingsSection(routeParts[index]);
+            if (pathSection && sections.includes(pathSection))
+                return pathSection;
+        }
+    }
+    return firstVisibleSection(sections);
 }
 export function useSettingsPanelController({ sections = ALL_SETTINGS_SECTIONS, initialSection, sectionRequestKey, onScrollToSection, } = {}) {
     const visibleSections = useMemo(() => new Set(sections), [sections]);
@@ -72,23 +94,40 @@ export function useSettingsPanelController({ sections = ALL_SETTINGS_SECTIONS, i
     useEffect(() => {
         if (typeof window === "undefined")
             return;
-        const handleHashChange = () => {
+        const handleLocationChange = () => {
             const hash = window.location.hash?.replace(/^#/, "") ?? "";
-            const section = normalizeSettingsSection(hash);
+            let section = normalizeSettingsSection(hash);
+            const pathParts = settingsPathParts();
+            if (!section) {
+                for (let index = pathParts.length - 1; index >= 0; index -= 1) {
+                    const pathSection = normalizeSettingsSection(pathParts[index]);
+                    if (pathSection) {
+                        section = pathSection;
+                        break;
+                    }
+                }
+            }
             if (!section || !isSectionVisible(section))
                 return;
             if (hash.startsWith("secrets:") || hash === "secrets") {
                 const key = hash.slice("secrets:".length);
                 setFocusSecretKey(key || undefined);
             }
+            else if (section === "secrets") {
+                setFocusSecretKey(secretKeyFromPath(pathParts));
+            }
             else {
                 setFocusSecretKey(undefined);
             }
             openSettingsSection(section, { scroll: true });
         };
-        handleHashChange();
-        window.addEventListener("hashchange", handleHashChange);
-        return () => window.removeEventListener("hashchange", handleHashChange);
+        handleLocationChange();
+        window.addEventListener("hashchange", handleLocationChange);
+        window.addEventListener("popstate", handleLocationChange);
+        return () => {
+            window.removeEventListener("hashchange", handleLocationChange);
+            window.removeEventListener("popstate", handleLocationChange);
+        };
     }, [isSectionVisible, openSettingsSection]);
     return {
         sections,

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

package/dist/db/client.d.ts

@@ -183,6 +183,15 @@ export declare function isServerlessRuntime(): boolean;
  * leave room for concurrency.
  */
 export declare function pgPoolOptions(url: string): Record<string, unknown>;
+/**
+ * Shared options for every Neon serverless pool. The startup parameter is
+ * applied by Postgres before the first transaction, so a killed function
+ * cannot return a connection that remains idle in transaction indefinitely.
+ */
+export declare function neonPoolOptions(): {
+    max: number;
+    idle_in_transaction_session_timeout?: number;
+};
 /**
  * Connection cap for the @neondatabase/serverless `Pool`.
  *

package/dist/db/client.js

@@ -778,15 +778,35 @@ export function pgPoolOptions(url) {
     const serverless = isServerlessRuntime();
     return {
         onnotice: () => { },
-        max: serverless ? 4 : 20,
+        max: serverless ? serverlessPoolMax() : 20,
         idle_timeout: serverless ? 20 : 240,
         max_lifetime: 60 * 30,
         connect_timeout: 10,
+        ...(serverless
+            ? {
+                connection: {
+                    idle_in_transaction_session_timeout: 30_000,
+                },
+            }
+            : {}),
         // Supabase's connection pooler (Transaction mode) requires prepare:false.
         // Only disable for Supabase URLs to avoid degrading other deployments.
         ...(url.includes("supabase") ? { prepare: false } : {}),
     };
 }
+/**
+ * Shared options for every Neon serverless pool. The startup parameter is
+ * applied by Postgres before the first transaction, so a killed function
+ * cannot return a connection that remains idle in transaction indefinitely.
+ */
+export function neonPoolOptions() {
+    return {
+        max: neonPoolMax(),
+        ...(isServerlessRuntime()
+            ? { idle_in_transaction_session_timeout: 30_000 }
+            : {}),
+    };
+}
 /**
  * Connection cap for the @neondatabase/serverless `Pool`.
  *
@@ -804,20 +824,27 @@ export function pgPoolOptions(url) {
 export function neonPoolMax() {
     if (!isServerlessRuntime())
         return 20;
-    // Netlify can run several background workers concurrently; a background
-    // worker is not a global singleton and must not hold a larger pool than the
-    // foreground path. The agent's
-    // pre-send setup fires ~6 concurrent DB reads in parallel; with only 2
-    // connections that burst exhausts the pool and a single stalled connection
-    // freezes the worker before it can claim — observed on analytics' heavier
-    // action surface, where the worker froze right after `model_done` and never
-    // recorded `env_config`/`presend`, while the foreground path ran the
-    // identical code in ~2s. Four connections preserve the concurrent
-    // read burst while keeping foreground and background caps aligned, avoiding
-    // "Max client connections reached" across many warm instances.
+    return serverlessPoolMax();
+}
+function serverlessPoolMax() {
+    // Scheduled Analytics workers run independently and may overlap across
+    // invocations. They process work sequentially, so one connection prevents
+    // a slow sweep from multiplying Neon connections while foreground requests
+    // retain two slots for their concurrent reads.
+    if (isLowConnectionBackgroundRuntime())
+        return 1;
+    // Netlify can run several background workers concurrently. Keep their four
+    // slots: the agent pre-send setup fires ~6 concurrent DB reads, and two
+    // connections previously froze the worker before it could claim. Foreground
+    // requests use two slots instead, leaving more headroom across warm
+    // instances where the user-facing routes are the pressure source.
     if (isBackgroundFunctionPoolContext())
         return 4;
-    return 4;
+    return 2;
+}
+function isLowConnectionBackgroundRuntime() {
+    return (globalThis
+        .__AGENT_NATIVE_LOW_CONNECTION_BACKGROUND_RUNTIME__ === true);
 }
 /**
  * Inline mirror of `isInBackgroundFunctionRuntime()`
@@ -1085,7 +1112,7 @@ async function createDbExecInternal(config = {}, trackSingletonResources = false
             // connections, so its direct executions use stateless Neon HTTP instead.
             // The foreground and transaction surface keep the WebSocket pool.
             const bgHttp = isBackgroundFunctionPoolContext();
-            const makePool = () => new Pool({ connectionString: url, max: neonPoolMax() });
+            const makePool = () => new Pool({ connectionString: url, ...neonPoolOptions() });
             // The singleton exec shares the process pool; `createDbExec()` callers own
             // a `close()` and so must not be handed it.
             const pool = trackSingletonResources
@@ -1250,8 +1277,16 @@ async function createDbExecInternal(config = {}, trackSingletonResources = false
                             return result;
                         }
                         catch (err) {
-                            await queryNeonClient(client, "ROLLBACK").catch(() => { });
-                            releaseClient(isConnectionError(err) ? true : undefined);
+                            let rollbackFailed = false;
+                            try {
+                                await queryNeonClient(client, "ROLLBACK");
+                            }
+                            catch {
+                                rollbackFailed = true;
+                            }
+                            // A failed rollback can leave the backend inside the transaction.
+                            // Do not return that client to PgBouncer as if it were clean.
+                            releaseClient(isConnectionError(err) || rollbackFailed ? true : undefined);
                             throw err;
                         }
                     }, 1);

package/dist/db/create-get-db.js

@@ -1,6 +1,6 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 import { drizzle as drizzleD1 } from "drizzle-orm/d1";
-import { getDialect, getCloudflareD1Binding, getDatabaseUrl, getDatabaseAuthToken, isLocalSqliteUrl, isPgliteUrl, isConnectionError, getPgliteClient, loadPgliteDrizzle, prepareLocalSqliteUrl, sqliteFilenameFromUrl, pgPoolOptions, neonPoolMax, attachNeonPoolErrorLogger, withDbTimeout, retryOnConnectionError, dbOpTimeoutMs, sharedDbPool, onSharedDbPoolsClosed, onSharedDbPoolReplaced, } from "./client.js";
+import { getDialect, getCloudflareD1Binding, getDatabaseUrl, getDatabaseAuthToken, isLocalSqliteUrl, isPgliteUrl, isConnectionError, getPgliteClient, loadPgliteDrizzle, prepareLocalSqliteUrl, sqliteFilenameFromUrl, pgPoolOptions, neonPoolOptions, attachNeonPoolErrorLogger, withDbTimeout, retryOnConnectionError, dbOpTimeoutMs, sharedDbPool, onSharedDbPoolsClosed, onSharedDbPoolReplaced, } from "./client.js";
 // Lazy driver loaders — cached promises so dynamic import only runs once.
 let _pgDrizzle;
 function getPgDrizzle() {
@@ -407,7 +407,7 @@ export function createGetDb(schema) {
                     // `createGetDb` store: one connect per process instead of one per
                     // schema module. See `sharedDbPool` in client.ts.
                     resetOnPoolClose("neon", url);
-                    const rawPool = sharedDbPool("neon", url, () => new Pool({ connectionString: url, max: neonPoolMax() }));
+                    const rawPool = sharedDbPool("neon", url, () => new Pool({ connectionString: url, ...neonPoolOptions() }));
                     attachNeonPoolErrorLogger(rawPool);
                     // Wrap the pool with the resilience layer so Drizzle queries get the
                     // same withDbTimeout + retryOnConnectionError protection as the raw

package/dist/db/ddl-guard.d.ts

@@ -32,33 +32,33 @@ import { type DbExec } from "./client.js";
 /**
  * True when running against Postgres AND the given table already exists in the
  * `public` schema. Returns `false` on SQLite (callers gate their own behaviour
- * there), for invalid identifiers, or when `information_schema` is unreadable —
- * the conservative answer "not known to exist" makes the caller fall through to
- * its idempotent `CREATE TABLE IF NOT EXISTS`, preserving today's behaviour.
+ * there), for invalid identifiers, and `undefined` when `information_schema`
+ * is unreadable. Unknown must stay distinct from absent: treating a timed-out
+ * probe as missing starts a DDL lock storm on a busy serverless database.
  *
  * This is a plain read (no lock), so it never blocks on an `ACCESS EXCLUSIVE`
  * lock the way `CREATE`/`ALTER` would.
  */
-export declare function pgTableExists(table: string, injectedClient?: DbExec, dialectIsPostgres?: boolean): Promise<boolean>;
+export declare function pgTableExists(table: string, injectedClient?: DbExec, dialectIsPostgres?: boolean): Promise<boolean | undefined>;
 /**
  * True when running against Postgres AND the given column already exists on the
  * given table in the `public` schema. Returns `false` on SQLite, for invalid
- * identifiers, or when `information_schema` is unreadable.
+ * identifiers, and `undefined` when `information_schema` is unreadable.
  *
  * Plain read — no lock taken.
  */
-export declare function pgColumnExists(table: string, column: string, injectedClient?: DbExec): Promise<boolean>;
+export declare function pgColumnExists(table: string, column: string, injectedClient?: DbExec): Promise<boolean | undefined>;
 /**
  * True when running against Postgres AND an index with the given name already
  * exists in the `public` schema. Returns `false` on SQLite, for invalid
- * identifiers, or when `pg_indexes` is unreadable.
+ * identifiers, and `undefined` when `pg_indexes` is unreadable.
  *
  * `CREATE INDEX` (without CONCURRENTLY) takes a `SHARE` lock that blocks
  * writes, so on a fresh background-worker process behind a concurrent
  * connection this can hang just like a `CREATE`/`ALTER` would; checking first
  * skips the lock on the already-migrated hot path.
  */
-export declare function pgIndexExists(indexName: string, injectedClient?: DbExec, dialectIsPostgres?: boolean): Promise<boolean>;
+export declare function pgIndexExists(indexName: string, injectedClient?: DbExec, dialectIsPostgres?: boolean): Promise<boolean | undefined>;
 /**
  * Probe → guarded-DDL → re-probe sequence for one piece of on-demand schema.
  *
@@ -86,8 +86,8 @@ export declare function pgIndexExists(indexName: string, injectedClient?: DbExec
  * `false` only when it already existed up front (no DDL issued).
  */
 export declare function ensureSchemaObject(options: {
-    /** Lock-free existence check; `true` ⇒ already present, skip DDL. */
-    probe: () => Promise<boolean>;
+    /** Lock-free existence check; `true` ⇒ present, `undefined` ⇒ unreadable. */
+    probe: () => Promise<boolean | undefined>;
     /** DDL to run only when `probe()` reports the object missing. */
     ddl: string;
     /** Human-readable name of what's being ensured, for the error message. */
@@ -150,6 +150,7 @@ export declare function isLockTimeoutError(err: unknown): boolean;
  */
 export declare function runGuardedDdl(ddl: string, options?: {
     lockTimeout?: string;
+    idleInTransactionTimeout?: string;
     injectedClient?: DbExec;
     dialectIsPostgres?: boolean;
 }): Promise<boolean>;