@agent-native/core 0.9.1 → 0.11.0

package/dist/client/use-db-sync.js

@@ -1,5 +1,25 @@
 import { useEffect, useRef, useState } from "react";
 import { agentNativePath } from "./api-path.js";
+const POLL_ABORT_MIN_MS = 10_000;
+function getPollAbortMs(interval) {
+    return Math.max(POLL_ABORT_MIN_MS, interval * 4);
+}
+async function fetchPollJson(pollUrl, since, interval) {
+    const controller = typeof AbortController === "undefined" ? null : new AbortController();
+    const timeout = controller
+        ? setTimeout(() => controller.abort(), getPollAbortMs(interval))
+        : null;
+    try {
+        const res = await fetch(`${pollUrl}?since=${since}`, controller ? { signal: controller.signal } : undefined);
+        if (!res.ok)
+            throw new Error("HTTP " + res.status);
+        return res.json();
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+    }
+}
 /**
  * Hook that polls /_agent-native/poll for DB change events and invalidates
  * react-query caches when changes are detected.
@@ -28,14 +48,23 @@ export function useDbSync(options = {}) {
         let versionRef = 0;
         let timer = null;
         let stopped = false;
-        async function poll() {
+        let inFlight = false;
+        function schedulePoll() {
             if (stopped)
                 return;
+            if (timer)
+                clearTimeout(timer);
+            timer = setTimeout(() => {
+                timer = null;
+                void poll();
+            }, interval);
+        }
+        async function poll() {
+            if (stopped || inFlight)
+                return;
+            inFlight = true;
             try {
-                const res = await fetch(`${pollUrl}?since=${versionRef}`);
-                if (!res.ok)
-                    throw new Error("HTTP " + res.status);
-                const data = await res.json();
+                const data = await fetchPollJson(pollUrl, versionRef, interval);
                 const { version, events } = data;
                 if (events.length > 0 && queryClient) {
                     const ignore = ignoreSourceRef.current;
@@ -51,6 +80,8 @@ export function useDbSync(options = {}) {
                         // (agent or HTTP) auto-refresh the UI — regardless of how the
                         // template configured queryKeys / onEvent.
                         queryClient.invalidateQueries({ queryKey: ["action"] });
+                        queryClient.invalidateQueries({ queryKey: ["extension"] });
+                        queryClient.invalidateQueries({ queryKey: ["extensions"] });
                         queryClient.invalidateQueries({ queryKey: ["tool"] });
                         queryClient.invalidateQueries({ queryKey: ["tools"] });
                     }
@@ -66,16 +97,36 @@ export function useDbSync(options = {}) {
             catch {
                 // Network error — will retry on next interval
             }
-            if (!stopped) {
-                timer = setTimeout(poll, interval);
+            finally {
+                inFlight = false;
+                schedulePoll();
+            }
+        }
+        function pollNow() {
+            if (typeof document !== "undefined" &&
+                document.visibilityState === "hidden") {
+                return;
             }
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            void poll();
+        }
+        function handleVisibilityChange() {
+            if (document.visibilityState === "visible")
+                pollNow();
         }
         // Initial poll immediately
-        poll();
+        void poll();
+        window.addEventListener("focus", pollNow);
+        document.addEventListener("visibilitychange", handleVisibilityChange);
         return () => {
             stopped = true;
             if (timer)
                 clearTimeout(timer);
+            window.removeEventListener("focus", pollNow);
+            document.removeEventListener("visibilitychange", handleVisibilityChange);
         };
     }, [pollUrl, queryClient, interval]);
 }
@@ -107,30 +158,60 @@ export function useScreenRefreshKey(options = {}) {
         let versionRef = 0;
         let timer = null;
         let stopped = false;
-        async function poll() {
+        let inFlight = false;
+        function schedulePoll() {
             if (stopped)
                 return;
+            if (timer)
+                clearTimeout(timer);
+            timer = setTimeout(() => {
+                timer = null;
+                void poll();
+            }, interval);
+        }
+        async function poll() {
+            if (stopped || inFlight)
+                return;
+            inFlight = true;
             try {
-                const res = await fetch(`${pollUrl}?since=${versionRef}`);
-                if (res.ok) {
-                    const data = (await res.json());
-                    if (data.events?.some((e) => e.source === "screen-refresh")) {
-                        setKey((k) => k + 1);
-                    }
-                    versionRef = Math.max(versionRef, data.version);
+                const data = await fetchPollJson(pollUrl, versionRef, interval);
+                if (data.events?.some((e) => e.source === "screen-refresh")) {
+                    setKey((k) => k + 1);
                 }
+                versionRef = Math.max(versionRef, data.version);
             }
             catch {
                 // Network error — retry on next interval.
             }
-            if (!stopped)
-                timer = setTimeout(poll, interval);
+            finally {
+                inFlight = false;
+                schedulePoll();
+            }
+        }
+        function pollNow() {
+            if (typeof document !== "undefined" &&
+                document.visibilityState === "hidden") {
+                return;
+            }
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            void poll();
+        }
+        function handleVisibilityChange() {
+            if (document.visibilityState === "visible")
+                pollNow();
         }
-        poll();
+        void poll();
+        window.addEventListener("focus", pollNow);
+        document.addEventListener("visibilitychange", handleVisibilityChange);
         return () => {
             stopped = true;
             if (timer)
                 clearTimeout(timer);
+            window.removeEventListener("focus", pollNow);
+            document.removeEventListener("visibilitychange", handleVisibilityChange);
         };
     }, [pollUrl, interval]);
     return key;

package/dist/client/use-db-sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-db-sync.js","sourceRoot":"","sources":["../../src/client/use-db-sync.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { agentNativePath } from \"./api-path.js\";\n\ninterface QueryClient {\n  invalidateQueries(opts?: { queryKey?: string[] }): void;\n}\n\n/**\n * Hook that polls /_agent-native/poll for DB change events and invalidates\n * react-query caches when changes are detected.\n *\n * Works in all deployment environments (serverless, edge, long-lived server).\n *\n * @param options.queryClient - The react-query QueryClient instance\n * @param options.queryKeys - Array of query key prefixes to invalidate on change.\n *   Default: [\"data\"]\n * @param options.pollUrl - Poll endpoint URL. Default: \"/_agent-native/poll\"\n * @param options.onEvent - Optional callback for each change event\n * @param options.interval - Poll interval in ms. Default: 2000\n * @param options.ignoreSource - Skip events whose `requestSource` matches this\n *   value. Use a per-tab ID so the UI ignores its own writes while still\n *   picking up changes from other tabs, agents, and scripts.\n */\nexport function useDbSync(\n  options: {\n    queryClient?: QueryClient;\n    queryKeys?: string[];\n    pollUrl?: string;\n    /** @deprecated Use pollUrl instead */\n    eventsUrl?: string;\n    onEvent?: (data: any) => void;\n    interval?: number;\n    ignoreSource?: string;\n  } = {},\n): void {\n  const {\n    queryClient,\n    queryKeys = [\"data\"],\n    pollUrl = agentNativePath(options.eventsUrl ?? \"/_agent-native/poll\"),\n    interval = 2000,\n  } = options;\n\n  const onEventRef = useRef(options.onEvent);\n  onEventRef.current = options.onEvent;\n\n  const keysRef = useRef(queryKeys);\n  keysRef.current = queryKeys;\n\n  const ignoreSourceRef = useRef(options.ignoreSource);\n  ignoreSourceRef.current = options.ignoreSource;\n\n  useEffect(() => {\n    let versionRef = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    let stopped = false;\n\n    async function poll() {\n      if (stopped) return;\n      try {\n        const res = await fetch(`${pollUrl}?since=${versionRef}`);\n        if (!res.ok) throw new Error(\"HTTP \" + res.status);\n        const data = await res.json();\n        const { version, events } = data as {\n          version: number;\n          events: Array<{ source: string; type: string; key?: string }>;\n        };\n\n        if (events.length > 0 && queryClient) {\n          const ignore = ignoreSourceRef.current;\n          const relevant = ignore\n            ? events.filter((e: any) => e.requestSource !== ignore)\n            : events;\n\n          if (relevant.length > 0) {\n            for (const key of keysRef.current) {\n              queryClient.invalidateQueries({ queryKey: [key] });\n            }\n\n            // Framework-level invalidation: always invalidate framework query\n            // keys on any non-own change event so that mutating actions\n            // (agent or HTTP) auto-refresh the UI — regardless of how the\n            // template configured queryKeys / onEvent.\n            queryClient.invalidateQueries({ queryKey: [\"action\"] });\n            queryClient.invalidateQueries({ queryKey: [\"tool\"] });\n            queryClient.invalidateQueries({ queryKey: [\"tools\"] });\n          }\n\n          // Always forward all events to onEvent — templates can decide\n          for (const evt of events) {\n            onEventRef.current?.(evt);\n          }\n        }\n\n        // Never decrease — protects against serverless instances with\n        // slightly different version counters.\n        versionRef = Math.max(versionRef, version);\n      } catch {\n        // Network error — will retry on next interval\n      }\n      if (!stopped) {\n        timer = setTimeout(poll, interval);\n      }\n    }\n\n    // Initial poll immediately\n    poll();\n\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n    };\n  }, [pollUrl, queryClient, interval]);\n}\n\n/** @deprecated Use useDbSync instead */\nexport const useFileWatcher = useDbSync;\n\n/**\n * Subscribe to `refresh-screen` events from the agent. Returns an integer\n * that increments every time the agent invokes the framework's `refresh-screen`\n * tool. Apply it as a React `key` on the main content wrapper (the part\n * OUTSIDE the agent chat sidebar) so that region remounts and re-fetches its\n * data while the chat, sidebar, and any other persistent chrome keep their\n * in-flight state.\n *\n * Usage in a template's root:\n *\n *   const screenKey = useScreenRefreshKey();\n *   return (\n *     <AppLayout>\n *       <div key={screenKey}>\n *         <Outlet />\n *       </div>\n *     </AppLayout>\n *   );\n */\nexport function useScreenRefreshKey(\n  options: { pollUrl?: string; interval?: number } = {},\n): number {\n  const {\n    pollUrl = agentNativePath(options.pollUrl ?? \"/_agent-native/poll\"),\n    interval = 2000,\n  } = options;\n  const [key, setKey] = useState(0);\n\n  useEffect(() => {\n    let versionRef = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    let stopped = false;\n\n    async function poll() {\n      if (stopped) return;\n      try {\n        const res = await fetch(`${pollUrl}?since=${versionRef}`);\n        if (res.ok) {\n          const data = (await res.json()) as {\n            version: number;\n            events: Array<{ source: string }>;\n          };\n          if (data.events?.some((e) => e.source === \"screen-refresh\")) {\n            setKey((k) => k + 1);\n          }\n          versionRef = Math.max(versionRef, data.version);\n        }\n      } catch {\n        // Network error — retry on next interval.\n      }\n      if (!stopped) timer = setTimeout(poll, interval);\n    }\n\n    poll();\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n    };\n  }, [pollUrl, interval]);\n\n  return key;\n}\n"]}
+{"version":3,"file":"use-db-sync.js","sourceRoot":"","sources":["../../src/client/use-db-sync.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { agentNativePath } from \"./api-path.js\";\n\ninterface QueryClient {\n  invalidateQueries(opts?: { queryKey?: string[] }): void;\n}\n\nconst POLL_ABORT_MIN_MS = 10_000;\n\nfunction getPollAbortMs(interval: number): number {\n  return Math.max(POLL_ABORT_MIN_MS, interval * 4);\n}\n\nasync function fetchPollJson<T>(\n  pollUrl: string,\n  since: number,\n  interval: number,\n): Promise<T> {\n  const controller =\n    typeof AbortController === \"undefined\" ? null : new AbortController();\n  const timeout = controller\n    ? setTimeout(() => controller.abort(), getPollAbortMs(interval))\n    : null;\n\n  try {\n    const res = await fetch(\n      `${pollUrl}?since=${since}`,\n      controller ? { signal: controller.signal } : undefined,\n    );\n    if (!res.ok) throw new Error(\"HTTP \" + res.status);\n    return res.json();\n  } finally {\n    if (timeout) clearTimeout(timeout);\n  }\n}\n\n/**\n * Hook that polls /_agent-native/poll for DB change events and invalidates\n * react-query caches when changes are detected.\n *\n * Works in all deployment environments (serverless, edge, long-lived server).\n *\n * @param options.queryClient - The react-query QueryClient instance\n * @param options.queryKeys - Array of query key prefixes to invalidate on change.\n *   Default: [\"data\"]\n * @param options.pollUrl - Poll endpoint URL. Default: \"/_agent-native/poll\"\n * @param options.onEvent - Optional callback for each change event\n * @param options.interval - Poll interval in ms. Default: 2000\n * @param options.ignoreSource - Skip events whose `requestSource` matches this\n *   value. Use a per-tab ID so the UI ignores its own writes while still\n *   picking up changes from other tabs, agents, and scripts.\n */\nexport function useDbSync(\n  options: {\n    queryClient?: QueryClient;\n    queryKeys?: string[];\n    pollUrl?: string;\n    /** @deprecated Use pollUrl instead */\n    eventsUrl?: string;\n    onEvent?: (data: any) => void;\n    interval?: number;\n    ignoreSource?: string;\n  } = {},\n): void {\n  const {\n    queryClient,\n    queryKeys = [\"data\"],\n    pollUrl = agentNativePath(options.eventsUrl ?? \"/_agent-native/poll\"),\n    interval = 2000,\n  } = options;\n\n  const onEventRef = useRef(options.onEvent);\n  onEventRef.current = options.onEvent;\n\n  const keysRef = useRef(queryKeys);\n  keysRef.current = queryKeys;\n\n  const ignoreSourceRef = useRef(options.ignoreSource);\n  ignoreSourceRef.current = options.ignoreSource;\n\n  useEffect(() => {\n    let versionRef = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    let stopped = false;\n    let inFlight = false;\n\n    function schedulePoll() {\n      if (stopped) return;\n      if (timer) clearTimeout(timer);\n      timer = setTimeout(() => {\n        timer = null;\n        void poll();\n      }, interval);\n    }\n\n    async function poll() {\n      if (stopped || inFlight) return;\n      inFlight = true;\n      try {\n        const data = await fetchPollJson<{\n          version: number;\n          events: Array<{\n            source: string;\n            type: string;\n            key?: string;\n            requestSource?: string;\n          }>;\n        }>(pollUrl, versionRef, interval);\n        const { version, events } = data as {\n          version: number;\n          events: Array<{\n            source: string;\n            type: string;\n            key?: string;\n            requestSource?: string;\n          }>;\n        };\n\n        if (events.length > 0 && queryClient) {\n          const ignore = ignoreSourceRef.current;\n          const relevant = ignore\n            ? events.filter((e: any) => e.requestSource !== ignore)\n            : events;\n\n          if (relevant.length > 0) {\n            for (const key of keysRef.current) {\n              queryClient.invalidateQueries({ queryKey: [key] });\n            }\n\n            // Framework-level invalidation: always invalidate framework query\n            // keys on any non-own change event so that mutating actions\n            // (agent or HTTP) auto-refresh the UI — regardless of how the\n            // template configured queryKeys / onEvent.\n            queryClient.invalidateQueries({ queryKey: [\"action\"] });\n            queryClient.invalidateQueries({ queryKey: [\"extension\"] });\n            queryClient.invalidateQueries({ queryKey: [\"extensions\"] });\n            queryClient.invalidateQueries({ queryKey: [\"tool\"] });\n            queryClient.invalidateQueries({ queryKey: [\"tools\"] });\n          }\n\n          // Always forward all events to onEvent — templates can decide\n          for (const evt of events) {\n            onEventRef.current?.(evt);\n          }\n        }\n\n        // Never decrease — protects against serverless instances with\n        // slightly different version counters.\n        versionRef = Math.max(versionRef, version);\n      } catch {\n        // Network error — will retry on next interval\n      } finally {\n        inFlight = false;\n        schedulePoll();\n      }\n    }\n\n    function pollNow() {\n      if (\n        typeof document !== \"undefined\" &&\n        document.visibilityState === \"hidden\"\n      ) {\n        return;\n      }\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n      void poll();\n    }\n\n    function handleVisibilityChange() {\n      if (document.visibilityState === \"visible\") pollNow();\n    }\n\n    // Initial poll immediately\n    void poll();\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [pollUrl, queryClient, interval]);\n}\n\n/** @deprecated Use useDbSync instead */\nexport const useFileWatcher = useDbSync;\n\n/**\n * Subscribe to `refresh-screen` events from the agent. Returns an integer\n * that increments every time the agent invokes the framework's `refresh-screen`\n * tool. Apply it as a React `key` on the main content wrapper (the part\n * OUTSIDE the agent chat sidebar) so that region remounts and re-fetches its\n * data while the chat, sidebar, and any other persistent chrome keep their\n * in-flight state.\n *\n * Usage in a template's root:\n *\n *   const screenKey = useScreenRefreshKey();\n *   return (\n *     <AppLayout>\n *       <div key={screenKey}>\n *         <Outlet />\n *       </div>\n *     </AppLayout>\n *   );\n */\nexport function useScreenRefreshKey(\n  options: { pollUrl?: string; interval?: number } = {},\n): number {\n  const {\n    pollUrl = agentNativePath(options.pollUrl ?? \"/_agent-native/poll\"),\n    interval = 2000,\n  } = options;\n  const [key, setKey] = useState(0);\n\n  useEffect(() => {\n    let versionRef = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    let stopped = false;\n    let inFlight = false;\n\n    function schedulePoll() {\n      if (stopped) return;\n      if (timer) clearTimeout(timer);\n      timer = setTimeout(() => {\n        timer = null;\n        void poll();\n      }, interval);\n    }\n\n    async function poll() {\n      if (stopped || inFlight) return;\n      inFlight = true;\n      try {\n        const data = await fetchPollJson<{\n          version: number;\n          events: Array<{ source: string }>;\n        }>(pollUrl, versionRef, interval);\n        if (data.events?.some((e) => e.source === \"screen-refresh\")) {\n          setKey((k) => k + 1);\n        }\n        versionRef = Math.max(versionRef, data.version);\n      } catch {\n        // Network error — retry on next interval.\n      } finally {\n        inFlight = false;\n        schedulePoll();\n      }\n    }\n\n    function pollNow() {\n      if (\n        typeof document !== \"undefined\" &&\n        document.visibilityState === \"hidden\"\n      ) {\n        return;\n      }\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n      void poll();\n    }\n\n    function handleVisibilityChange() {\n      if (document.visibilityState === \"visible\") pollNow();\n    }\n\n    void poll();\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [pollUrl, interval]);\n\n  return key;\n}\n"]}

package/dist/deploy/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/deploy/build.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAyB7B;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EAAE,EACzB,WAAW,EAAE,MAAM,EAAE,EACrB,kBAAkB,GAAE,MAAM,EAAO,EACjC,OAAO,GAAE,gBAAgB,EAAO,EAChC,aAAa,GAAE,oBAAoB,GAAG,IAAW,GAChD,MAAM,CAkVR;AAiXD,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/deploy/build.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AA8B7B;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EAAE,EACzB,WAAW,EAAE,MAAM,EAAE,EACrB,kBAAkB,GAAE,MAAM,EAAO,EACjC,OAAO,GAAE,gBAAgB,EAAO,EAChC,aAAa,GAAE,oBAAoB,GAAG,IAAW,GAChD,MAAM,CAkVR;AA0VD,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}

package/dist/deploy/build.js

@@ -35,6 +35,11 @@ function normalizeConfiguredAppBasePath() {
 /** Plugins that require Node.js runtime and cannot run on edge/serverless */
 const NODE_ONLY_PLUGINS = new Set([
     "terminal", // PTY requires child_process
+    // @sentry/node ships node:fs / node:async_hooks bindings that don't load
+    // on workerd / Cloudflare Workers. Templates running on edge presets can
+    // mount their own edge-compatible Sentry wrapper if they want server
+    // observability there; the framework default is the Node SDK.
+    "sentry",
 ]);
 function isNodeOnlyPlugin(filePath) {
     const basename = path.basename(filePath, path.extname(filePath));
@@ -540,33 +545,10 @@ async function buildCloudflarePages() {
         // Pages' loader scans chunks for `"node:*"` literals and fails with
         // 'No such module "node:fs"' whether or not the string is reached
         // at runtime. Scoping to known builtins avoids touching user data.
-        const builtinsPattern = [
-            "fs",
-            "fs/promises",
-            "path",
-            "os",
-            "crypto",
-            "http",
-            "https",
-            "stream",
-            "stream/web",
-            "url",
-            "util",
-            "events",
-            "buffer",
-            "querystring",
-            "zlib",
-            "net",
-            "tls",
-            "assert",
-            "timers",
-            "child_process",
-            "module",
-            "async_hooks",
-            "process",
-            "worker_threads",
-            "sqlite",
-        ].join("|");
+        // Sorted longest-first so `fs/promises` matches before `fs`.
+        const builtinsPattern = [...NODE_BUILTINS]
+            .sort((a, b) => b.length - a.length)
+            .join("|");
         const builtinRe = new RegExp(`(["'])node:(${builtinsPattern})\\1`, "g");
         code = code.replace(builtinRe, (_, q, mod) => `${q}${mod}${q}`);
         // Rewrite virtual:react-router/server-build imports to the local stub.
@@ -657,28 +639,22 @@ export function getNodeBuiltinNames() {
  * Injected via esbuild --inject so CJS deps work on Workers runtime.
  */
 function generateRequireShim() {
-    // Only shim the commonly-used builtins to keep it small
-    const shimmed = [
-        "fs",
-        "path",
-        "os",
-        "crypto",
-        "http",
-        "https",
-        "stream",
-        "url",
-        "util",
-        "events",
-        "buffer",
-        "querystring",
-        "zlib",
-        "net",
-        "tls",
-        "assert",
-        "timers",
-        "child_process",
-        "module",
-    ];
+    // Shim the full set of node builtins so any CJS `require("X")` from a
+    // transitive dep resolves to the imported ESM module. Anything less is
+    // whack-a-mole: terminal helpers pull in `tty`, transformer libs pull in
+    // `worker_threads`, etc. — every miss fails deploy with a generic
+    // "Cannot require: <name>" thrown by this shim itself.
+    //
+    // Some builtins exist only as runtime polyfills under nodejs_compat
+    // (some are no-op stubs). That's fine — the `import` returns whatever
+    // the runtime provides; failures only surface when callers actually USE
+    // the unsupported APIs at request time, which is the same as if the
+    // shim wasn't there.
+    //
+    // `sqlite` is excluded because it's Node 22+ only and Workers'
+    // nodejs_compat doesn't expose it yet — importing it makes the whole
+    // bundle fail to load.
+    const shimmed = NODE_BUILTINS.filter((name) => name !== "sqlite");
     // Bare module names — CF Pages Functions runs under nodejs_compat v1,
     // which rejects "node:fs" and only accepts "fs". The post-build pass in
     // buildCloudflarePages() also strips any `node:` prefix that esbuild or