@agent-native/core 0.75.0 → 0.75.2

package/dist/deploy/build.d.ts

@@ -58,25 +58,46 @@ export declare function findInstalledResvgPackages(nodeModulesRoots: string[]):
  */
 export declare function isDurableBackgroundDeployEnabled(): boolean;
 /**
- * Single-template Netlify build: emit a SECOND function whose name ends in
- * `-background`, re-exporting the same `main.mjs` handler bundle, so the chat
- * `_process-run` POST lands on Netlify's async (15-min) function instead of the
- * synchronous one. Additive + flag-gated (see `isDurableBackgroundDeployEnabled`).
+ * Single-template Netlify build: emit a STANDALONE async background function so
+ * the chat `_process-run` worker runs on Netlify's async (15-min) function
+ * reached at its DIRECT url, instead of the synchronous `/*` catch-all.
+ * Additive + flag-gated (see `isDurableBackgroundDeployEnabled`).
  *
- * Nitro's `netlify` preset emits a single function at
- * `.netlify/functions-internal/server` (`server.mjs` → `main.mjs`). We copy
- * that directory to a sibling `<...>-background` function and write an entry
- * with a `config.path` of the process-run route.
+ * Nitro's `netlify` preset emits a single synchronous function at
+ * `.netlify/functions-internal/server` (`server.mjs` → `main.mjs`, `config.path`
+ * `/*`). We copy that bundle to a STANDALONE function in the STANDARD functions
+ * dir `.netlify/functions/server-agent-background` and write an entry that:
+ *   1. Sets `globalThis.__AGENT_NATIVE_BACKGROUND_RUNTIME__ = true` at cold start
+ *      (read back by `isInBackgroundFunctionRuntime()` so the worker takes the
+ *      ~13-min soft-timeout). A `globalThis` flag — NOT `process.env` — keeps the
+ *      no-env-mutation guard satisfied and carries no cross-request state.
+ *   2. Declares `export const config = { background: true }` with NO `path`. With
+ *      no custom `path`, Netlify exposes the function at the DEFAULT url
+ *      `/.netlify/functions/server-agent-background` and `background:true` makes
+ *      it ASYNC (immediate HTTP 202 ack, 15-min budget). The foreground POST
+ *      self-dispatches to that direct url
+ *      (`resolveAgentChatProcessRunDispatchPath`), BYPASSING Nitro's `/*`
+ *      catch-all entirely.
+ *   3. REWRITES the incoming request path to `AGENT_CHAT_PROCESS_RUN_PATH` before
+ *      delegating to the Nitro handler (`./main.mjs` default export — a Netlify
+ *      v2 / Web-standard `async (Request) => Response` handler), so the Nitro
+ *      router dispatches it to the `_process-run` plugin. Method, ALL headers
+ *      (critically the HMAC `Authorization: Bearer` the plugin verifies) and the
+ *      body are preserved by cloning the incoming `Request` with only its URL
+ *      pathname rewritten.
  *
- * ⚠️ REAL-DEPLOY VERIFICATION REQUIRED. Whether Netlify routes
- * `/_agent-native/agent-chat/_process-run` to this `-background` function (and
- * invokes it asynchronously with the 15-min budget) vs the synchronous Nitro
- * function cannot be verified in this environment — Nitro owns the primary
- * function's routing manifest, and the precedence between the two functions for
- * that path is a Netlify runtime behavior. If routing resolves to the
- * synchronous function, the run still completes via the existing 40s
- * soft-timeout path (no durable win, no regression). See
- * docs/design/durable-agent-runs.md (Open risks #1).
+ * WHY this replaced the previous `config.path` approach: a function with a custom
+ * `config.path` is reachable ONLY at that path (not at its default function url)
+ * and `functions-internal` is not exposed at the default url at all. In prod,
+ * Netlify routed `/_agent-native/agent-chat/_process-run` to the synchronous
+ * Nitro `server` catch-all, NOT to the background function — verified live: a
+ * POST to the process-run path returned a SYNCHRONOUS 401 from the handler
+ * (the Nitro plugin ran) instead of a 202 async ack. A standalone function at
+ * its direct url cannot be shadowed by the catch-all.
+ *
+ * Safety net regardless of Netlify routing nuance: if the direct-url dispatch
+ * fast-fails (e.g. 404 when this function was not emitted), the foreground
+ * handler degrades to an inline 40s synchronous run (see production-agent.ts).
  */
 export declare function emitSingleTemplateNetlifyBackgroundFunction(projectCwd: string): void;
 /**

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;AA4B7B,eAAO,MAAM,6BAA6B,UAiBzC,CAAC;AAuBF,wBAAgB,wCAAwC,CACtD,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,CAaR;AAgBD,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAgBvE,wBAAgB,yCAAyC,CACvD,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,WAAW,SAAK,GACf,IAAI,CAQN;AAED;;;;;;;;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,EACjD,mBAAmB,GAAE,MAAM,EAAO,EAClC,gBAAgB,SAAmC,GAClD,MAAM,CAskBR;AAyXD,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAkHD,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,iBAAiB,cAAoB,QAoCtC;AAuBD,KAAK,0BAA0B,GAAG,OAAO,GAAG,KAAK,CAAC;AAQlD,wBAAgB,qCAAqC,CACnD,YAAY,GAAE,MAAM,CAAC,QAA2B,EAChD,QAAQ,GAAE,MAAM,CAAC,YAA2B,EAC5C,UAAU,GAAE,0BAA0B,GAAG,IAAgD,GACxF,OAAO,CAOT;AAqED,wBAAgB,gCAAgC,CAC9C,gBAAgB,EAAE,MAAM,EAAE,GACzB,MAAM,GAAG,IAAI,CA8Bf;AAED,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,MAAM,EAAE,GACzB,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAqCpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gCAAgC,IAAI,OAAO,CAK1D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2CAA2C,CACzD,UAAU,EAAE,MAAM,GACjB,IAAI,CAyCN;AAkND;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,gBAAgB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA+Bf"}
+{"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;AA+B7B,eAAO,MAAM,6BAA6B,UAiBzC,CAAC;AAuBF,wBAAgB,wCAAwC,CACtD,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,CAaR;AAgBD,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAgBvE,wBAAgB,yCAAyC,CACvD,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,WAAW,SAAK,GACf,IAAI,CAQN;AAED;;;;;;;;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,EACjD,mBAAmB,GAAE,MAAM,EAAO,EAClC,gBAAgB,SAAmC,GAClD,MAAM,CAskBR;AAyXD,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAkHD,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,iBAAiB,cAAoB,QAoCtC;AAuBD,KAAK,0BAA0B,GAAG,OAAO,GAAG,KAAK,CAAC;AAQlD,wBAAgB,qCAAqC,CACnD,YAAY,GAAE,MAAM,CAAC,QAA2B,EAChD,QAAQ,GAAE,MAAM,CAAC,YAA2B,EAC5C,UAAU,GAAE,0BAA0B,GAAG,IAAgD,GACxF,OAAO,CAOT;AAqED,wBAAgB,gCAAgC,CAC9C,gBAAgB,EAAE,MAAM,EAAE,GACzB,MAAM,GAAG,IAAI,CA8Bf;AAED,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,MAAM,EAAE,GACzB,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAqCpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gCAAgC,IAAI,OAAO,CAK1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,2CAA2C,CACzD,UAAU,EAAE,MAAM,GACjB,IAAI,CAuFN;AAkND;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,gBAAgB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/deploy/build.js

@@ -21,7 +21,7 @@ import { discoverApiRoutes, discoverPlugins, discoverActionFiles, getMissingDefa
 import { getWorkspaceCoreExports, } from "./workspace-core.js";
 import { generateActionRegistryForProject } from "../vite/action-types-plugin.js";
 import { mcpEmbedStaticAssetRouteRules } from "../shared/mcp-embed-headers.js";
-import { AGENT_CHAT_PROCESS_RUN_PATH } from "../agent/durable-background.js";
+import { AGENT_BACKGROUND_FUNCTION_NAME, AGENT_CHAT_PROCESS_RUN_PATH, } from "../agent/durable-background.js";
 import { AGENT_NATIVE_SOCIAL_IMAGE_ALT, AGENT_NATIVE_SOCIAL_IMAGE_CACHE_BUSTER, AGENT_NATIVE_SOCIAL_IMAGE_HEIGHT, AGENT_NATIVE_SOCIAL_IMAGE_PATH, AGENT_NATIVE_SOCIAL_IMAGE_TYPE, AGENT_NATIVE_SOCIAL_IMAGE_WIDTH, } from "../shared/social-meta.js";
 import { DEFAULT_SSR_CDN_CACHE_CONTROL, DEFAULT_SSR_NETLIFY_CDN_CACHE_CONTROL, DEFAULT_SPECULATION_RULES_PATH, DEFAULT_SSR_CACHE_CONTROL, } from "../shared/cache-control.js";
 import { collectImmutableAssetPaths, IMMUTABLE_ASSET_CACHE_CONTROL, IMMUTABLE_ASSET_CACHE_HEADERS, prefixAssetPath, } from "./immutable-assets.js";
@@ -1252,29 +1252,50 @@ export function isDurableBackgroundDeployEnabled() {
     return !(v === "0" || v === "false" || v === "no" || v === "off");
 }
 /**
- * Single-template Netlify build: emit a SECOND function whose name ends in
- * `-background`, re-exporting the same `main.mjs` handler bundle, so the chat
- * `_process-run` POST lands on Netlify's async (15-min) function instead of the
- * synchronous one. Additive + flag-gated (see `isDurableBackgroundDeployEnabled`).
+ * Single-template Netlify build: emit a STANDALONE async background function so
+ * the chat `_process-run` worker runs on Netlify's async (15-min) function
+ * reached at its DIRECT url, instead of the synchronous `/*` catch-all.
+ * Additive + flag-gated (see `isDurableBackgroundDeployEnabled`).
  *
- * Nitro's `netlify` preset emits a single function at
- * `.netlify/functions-internal/server` (`server.mjs` → `main.mjs`). We copy
- * that directory to a sibling `<...>-background` function and write an entry
- * with a `config.path` of the process-run route.
+ * Nitro's `netlify` preset emits a single synchronous function at
+ * `.netlify/functions-internal/server` (`server.mjs` → `main.mjs`, `config.path`
+ * `/*`). We copy that bundle to a STANDALONE function in the STANDARD functions
+ * dir `.netlify/functions/server-agent-background` and write an entry that:
+ *   1. Sets `globalThis.__AGENT_NATIVE_BACKGROUND_RUNTIME__ = true` at cold start
+ *      (read back by `isInBackgroundFunctionRuntime()` so the worker takes the
+ *      ~13-min soft-timeout). A `globalThis` flag — NOT `process.env` — keeps the
+ *      no-env-mutation guard satisfied and carries no cross-request state.
+ *   2. Declares `export const config = { background: true }` with NO `path`. With
+ *      no custom `path`, Netlify exposes the function at the DEFAULT url
+ *      `/.netlify/functions/server-agent-background` and `background:true` makes
+ *      it ASYNC (immediate HTTP 202 ack, 15-min budget). The foreground POST
+ *      self-dispatches to that direct url
+ *      (`resolveAgentChatProcessRunDispatchPath`), BYPASSING Nitro's `/*`
+ *      catch-all entirely.
+ *   3. REWRITES the incoming request path to `AGENT_CHAT_PROCESS_RUN_PATH` before
+ *      delegating to the Nitro handler (`./main.mjs` default export — a Netlify
+ *      v2 / Web-standard `async (Request) => Response` handler), so the Nitro
+ *      router dispatches it to the `_process-run` plugin. Method, ALL headers
+ *      (critically the HMAC `Authorization: Bearer` the plugin verifies) and the
+ *      body are preserved by cloning the incoming `Request` with only its URL
+ *      pathname rewritten.
  *
- * ⚠️ REAL-DEPLOY VERIFICATION REQUIRED. Whether Netlify routes
- * `/_agent-native/agent-chat/_process-run` to this `-background` function (and
- * invokes it asynchronously with the 15-min budget) vs the synchronous Nitro
- * function cannot be verified in this environment — Nitro owns the primary
- * function's routing manifest, and the precedence between the two functions for
- * that path is a Netlify runtime behavior. If routing resolves to the
- * synchronous function, the run still completes via the existing 40s
- * soft-timeout path (no durable win, no regression). See
- * docs/design/durable-agent-runs.md (Open risks #1).
+ * WHY this replaced the previous `config.path` approach: a function with a custom
+ * `config.path` is reachable ONLY at that path (not at its default function url)
+ * and `functions-internal` is not exposed at the default url at all. In prod,
+ * Netlify routed `/_agent-native/agent-chat/_process-run` to the synchronous
+ * Nitro `server` catch-all, NOT to the background function — verified live: a
+ * POST to the process-run path returned a SYNCHRONOUS 401 from the handler
+ * (the Nitro plugin ran) instead of a 202 async ack. A standalone function at
+ * its direct url cannot be shadowed by the catch-all.
+ *
+ * Safety net regardless of Netlify routing nuance: if the direct-url dispatch
+ * fast-fails (e.g. 404 when this function was not emitted), the foreground
+ * handler degrades to an inline 40s synchronous run (see production-agent.ts).
  */
 export function emitSingleTemplateNetlifyBackgroundFunction(projectCwd) {
-    const functionsDir = path.join(projectCwd, ".netlify", "functions-internal");
-    const serverDir = path.join(functionsDir, "server");
+    const internalDir = path.join(projectCwd, ".netlify", "functions-internal");
+    const serverDir = path.join(internalDir, "server");
     if (!fs.existsSync(path.join(serverDir, "main.mjs"))) {
         // Nitro output layout differs from what we expected — skip rather than
         // guess. The single-function deploy is unaffected.
@@ -1282,32 +1303,78 @@ export function emitSingleTemplateNetlifyBackgroundFunction(projectCwd) {
             "at .netlify/functions-internal/server/main.mjs was not found.");
         return;
     }
-    const backgroundName = "server-agent-background";
+    const backgroundName = AGENT_BACKGROUND_FUNCTION_NAME;
+    // Emit into the STANDARD functions dir (NOT functions-internal) so Netlify
+    // exposes the function at its default url `/.netlify/functions/<name>`.
+    const functionsDir = path.join(projectCwd, ".netlify", "functions");
     const dest = path.join(functionsDir, backgroundName);
+    fs.mkdirSync(functionsDir, { recursive: true });
     fs.rmSync(dest, { recursive: true, force: true });
     copyDir(serverDir, dest);
-    // Drop the original Nitro entry so our background entry is the entrypoint.
+    // Drop the original Nitro `/*` entry so our standalone entry is the entrypoint
+    // and the copied bundle does NOT re-register the catch-all `config.path`.
     fs.rmSync(path.join(dest, "server.mjs"), { force: true });
-    const entry = `let cachedHandler;
+    const processRunPath = JSON.stringify(AGENT_CHAT_PROCESS_RUN_PATH);
+    const entry = `// Mark this isolate as the durable background runtime BEFORE the handler
+// bundle is imported, so isInBackgroundFunctionRuntime() reliably returns true
+// in this function. The deployed Lambda name is NOT guaranteed to end in
+// "-background" (Netlify may mangle/prefix it), so we cannot depend on
+// AWS_LAMBDA_FUNCTION_NAME alone. A globalThis flag (NOT process.env) avoids the
+// no-env-mutation guard and carries no cross-request state — it is a static,
+// set-once isolate marker read back by isInBackgroundFunctionRuntime().
+globalThis.__AGENT_NATIVE_BACKGROUND_RUNTIME__ = true;
+
+// The framework route the Nitro router dispatches to (the _process-run plugin).
+const PROCESS_RUN_PATH = ${processRunPath};
 
-export default async function handler(...args) {
+let cachedHandler;
+
+// Netlify v2 invokes this as (request, context). The Nitro netlify handler is a
+// Web-standard \`async (Request) => Response\` (see nitro/presets/netlify/runtime).
+// We are reached at this function's DIRECT url
+// (/.netlify/functions/${backgroundName}); rewrite the path to PROCESS_RUN_PATH
+// so Nitro routes it to the _process-run plugin, preserving method, ALL headers
+// (the HMAC Authorization: Bearer MUST survive — the plugin verifies it) and the
+// body. We clone the incoming Request with only its URL pathname rewritten;
+// query + origin are preserved.
+export default async function handler(request) {
   cachedHandler ??= (await import("./main.mjs")).default;
-  return cachedHandler(...args);
+  const url = new URL(request.url);
+  url.pathname = PROCESS_RUN_PATH;
+  // Read the body once and pass it through. GET/HEAD have no body.
+  const method = request.method || "POST";
+  const hasBody = method !== "GET" && method !== "HEAD";
+  const body = hasBody ? await request.text() : undefined;
+  const rewritten = new Request(url.toString(), {
+    method,
+    headers: request.headers,
+    body,
+  });
+  return cachedHandler(rewritten);
 }
 
 export const config = {
   name: "agent background handler",
   generator: "agent-native build",
-  path: ${JSON.stringify([AGENT_CHAT_PROCESS_RUN_PATH])},
+  // background: true makes Netlify invoke this ASYNCHRONOUSLY (immediate HTTP
+  // 202 ack) with the 15-minute budget. NO custom \`path\`: that keeps the
+  // function reachable at its DEFAULT url /.netlify/functions/${backgroundName},
+  // which BYPASSES Nitro's /* catch-all. The previous version set a custom
+  // \`config.path\` and Netlify routed the process-run path to the SYNCHRONOUS
+  // catch-all instead (verified live: a synchronous 401 from the handler, not a
+  // 202 async ack). See Netlify docs: build/functions/background-functions +
+  // build/functions/configuration.
+  background: true,
   nodeBundler: "none",
   includedFiles: ["**"],
   preferStatic: false,
 };
 `;
     fs.writeFileSync(path.join(dest, `${backgroundName}.mjs`), entry);
-    console.log(`[build] Emitted durable-background function "${backgroundName}" ` +
-        `(path ${AGENT_CHAT_PROCESS_RUN_PATH}). REQUIRES real-deploy verification ` +
-        `of Netlify async routing — see docs/design/durable-agent-runs.md.`);
+    console.log(`[build] Emitted standalone durable-background function "${backgroundName}" ` +
+        `at /.netlify/functions/${backgroundName} (async, rewrites to ` +
+        `${AGENT_CHAT_PROCESS_RUN_PATH}). REQUIRES real-deploy verification of ` +
+        `Netlify async invocation — see docs/design/durable-agent-runs.md.`);
 }
 function copyInstalledLibsqlNativePackages(serverDir) {
     if (!serverDir || !fs.existsSync(serverDir))