@agent-native/core 0.75.4 → 0.75.5

package/dist/deploy/build.d.ts

@@ -63,61 +63,57 @@ export declare function isDurableBackgroundDeployEnabled(): boolean;
  * 15-min async function instead of the synchronous `/*` catch-all.
  * Additive + flag-gated (see `isDurableBackgroundDeployEnabled`).
  *
- * GROUNDED IN THE REAL NETLIFY BUILD OUTPUT (verified from a local Nitro build):
+ * GROUNDED IN THE REAL NETLIFY BUILD OUTPUT (verified from a local Nitro build)
+ * AND THE NETLIFY DOCS DEFAULT-URL RULE:
  *   - Nitro's `netlify` preset emits exactly ONE function source at
  *     `.netlify/functions-internal/server/`. `server.mjs` re-exports `main.mjs`
  *     and declares `export const config = { path: "/*", excludedPath:
- *     ["/.netlify/*"], preferStatic: true, ... }`. Nitro writes NO `netlify.toml`
- *     and NO `[[redirects]]`; the `/*` catch-all is an IN-CODE Functions-API-v2
- *     `config.path`.
+ *     ["/.netlify/*"], preferStatic: true, ... }`. The `/*` catch-all is an
+ *     IN-CODE Functions-API-v2 `config.path` and it ALREADY EXCLUDES
+ *     `/.netlify/*`.
  *   - The generated `.netlify/netlify.toml` sets
  *     `functionsDirectory = ".netlify/functions-internal"`. Netlify scans EXACTLY
  *     that dir; functions placed anywhere else (e.g. `.netlify/functions/`, which
  *     is the BUILD OUTPUT dir where `@netlify/build` later writes the zipped
  *     functions + `manifest.json`) are NEVER deployed.
- *   - On Netlify CI, `@netlify/build` reads each scanned function's
- *     `export const config`, zips it, and materializes
- *     `.netlify/functions/manifest.json` with `routes` derived from each
- *     `config.path`. So per-file `export const config` (including `background` and
- *     `path`) IS honored — the `server` manifest entry's `routes: [{ pattern:
- *     "/*" }]` came straight from `server.mjs`'s `config.path`.
+ *   - Every scanned function is reachable at its DEFAULT url
+ *     `/.netlify/functions/<name>` BY DEFAULT. A custom `config.path` REMOVES
+ *     that default url; declaring NO custom `config.path` KEEPS it.
  *
  * THEREFORE we:
  *   1. Emit the background function INTO the scanned dir
  *      (`.netlify/functions-internal/server-agent-background/`), sharing the same
  *      built `main.mjs` bundle, so Netlify discovers it and honors its config.
- *   2. Give its `export const config` BOTH `background: true` (→ async invoke,
- *      immediate 202, 15-min budget) AND `path: AGENT_CHAT_PROCESS_RUN_PATH` (so
- *      it claims that exact path at function-matching time, which Netlify
- *      evaluates BEFORE redirects — step 10 vs 11 in the request chain).
- *   3. PATCH the Nitro `server` function's own `server.mjs` so its catch-all
- *      `config.path: "/*"` EXCLUDES `AGENT_CHAT_PROCESS_RUN_PATH` (append it to
- *      `excludedPath`). Netlify does NOT define a winner when two serverless
- *      functions both match a path; rather than rely on that undocumented order,
- *      we make the match UNAMBIGUOUS — only the background function matches
- *      `_process-run`, and `server` matches everything else exactly as before.
+ *   2. Give its `export const config` `background: true` (→ async invoke,
+ *      immediate 202, 15-min budget) and NO custom `config.path`. With no custom
+ *      path the function keeps its DEFAULT url
+ *      `/.netlify/functions/server-agent-background`, and because the Nitro
+ *      `server` function's `/*` catch-all already excludes `/.netlify/*`, that
+ *      default-url namespace is NEVER shadowed by the synchronous function — no
+ *      catch-all patch is needed.
+ *   3. The entry NORMALIZES/rewrites the incoming request pathname to
+ *      `AGENT_CHAT_PROCESS_RUN_PATH` before delegating to `./main.mjs`. The
+ *      function is reached at its default url
+ *      (`/.netlify/functions/server-agent-background`), so the Nitro router needs
+ *      the path rewritten to the framework `_process-run` route, preserving the
+ *      method, ALL headers (the HMAC `Authorization: Bearer` MUST survive), and
+ *      the body.
  *   4. Set `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.
  *
- * With a real `config.path` the function is reachable at that path directly, so
- * the foreground POSTs to `AGENT_CHAT_PROCESS_RUN_PATH`
- * (`resolveAgentChatProcessRunDispatchPath`) and the request entry no longer
- * needs to rewrite the path — it already arrives at the framework route. We keep
- * a defensive normalize-to-PROCESS_RUN_PATH in the entry anyway (cheap, and it
- * makes the function correct even if reached via its default function url).
+ * The foreground dispatches to this DEFAULT url on hosted Netlify
+ * (`resolveAgentChatProcessRunDispatchPath` → `AGENT_BACKGROUND_FUNCTION_URL_PATH`).
  *
- * WHY THIS BEATS ALL THREE PRIOR FAILURES:
- *   - Attempts 1 & 2 emitted into `functions-internal` (correct dir) with a
- *     `config.path` but did NOT exclude that path from the `server` `/*`
- *     catch-all. Two functions matched `_process-run`; the order is undocumented
- *     and the catch-all `server` (priority 0, synchronous) won → SYNC 401, not a
- *     202. We now exclude the path from `server`, so only the async function
- *     matches.
- *   - Attempt 3 emitted a standalone function into `.netlify/functions/` — the
- *     OUTPUT dir, which Netlify does not scan — so it never entered the manifest
- *     → 404. We now emit into the SCANNED `functions-internal` dir.
+ * WHY THIS IS THE DOC-CORRECT FIX: a prior attempt gave the function a custom
+ * `config.path` (= the framework route) plus a catch-all `excludedPath` patch.
+ * The custom `config.path` was NOT honored as a route in prod — a probe of
+ * `POST /_agent-native/agent-chat/_process-run` returned 404. The doc-correct
+ * approach (confirmed against the Netlify docs) is to use the DEFAULT function
+ * url with no custom path: the function stays reachable at
+ * `/.netlify/functions/<name>` and is never shadowed because `/.netlify/*` is
+ * already excluded from the `server` catch-all.
  *
  * Safety net regardless of Netlify routing nuance: if the dispatch fast-fails
  * (e.g. the function was not emitted), the foreground handler degrades to an

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;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,wBAAgB,2CAA2C,CACzD,UAAU,EAAE,MAAM,GACjB,IAAI,CA8FN;AA2QD;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,2CAA2C,CACzD,UAAU,EAAE,MAAM,GACjB,IAAI,CAyFN;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

@@ -1257,61 +1257,57 @@ export function isDurableBackgroundDeployEnabled() {
  * 15-min async function instead of the synchronous `/*` catch-all.
  * Additive + flag-gated (see `isDurableBackgroundDeployEnabled`).
  *
- * GROUNDED IN THE REAL NETLIFY BUILD OUTPUT (verified from a local Nitro build):
+ * GROUNDED IN THE REAL NETLIFY BUILD OUTPUT (verified from a local Nitro build)
+ * AND THE NETLIFY DOCS DEFAULT-URL RULE:
  *   - Nitro's `netlify` preset emits exactly ONE function source at
  *     `.netlify/functions-internal/server/`. `server.mjs` re-exports `main.mjs`
  *     and declares `export const config = { path: "/*", excludedPath:
- *     ["/.netlify/*"], preferStatic: true, ... }`. Nitro writes NO `netlify.toml`
- *     and NO `[[redirects]]`; the `/*` catch-all is an IN-CODE Functions-API-v2
- *     `config.path`.
+ *     ["/.netlify/*"], preferStatic: true, ... }`. The `/*` catch-all is an
+ *     IN-CODE Functions-API-v2 `config.path` and it ALREADY EXCLUDES
+ *     `/.netlify/*`.
  *   - The generated `.netlify/netlify.toml` sets
  *     `functionsDirectory = ".netlify/functions-internal"`. Netlify scans EXACTLY
  *     that dir; functions placed anywhere else (e.g. `.netlify/functions/`, which
  *     is the BUILD OUTPUT dir where `@netlify/build` later writes the zipped
  *     functions + `manifest.json`) are NEVER deployed.
- *   - On Netlify CI, `@netlify/build` reads each scanned function's
- *     `export const config`, zips it, and materializes
- *     `.netlify/functions/manifest.json` with `routes` derived from each
- *     `config.path`. So per-file `export const config` (including `background` and
- *     `path`) IS honored — the `server` manifest entry's `routes: [{ pattern:
- *     "/*" }]` came straight from `server.mjs`'s `config.path`.
+ *   - Every scanned function is reachable at its DEFAULT url
+ *     `/.netlify/functions/<name>` BY DEFAULT. A custom `config.path` REMOVES
+ *     that default url; declaring NO custom `config.path` KEEPS it.
  *
  * THEREFORE we:
  *   1. Emit the background function INTO the scanned dir
  *      (`.netlify/functions-internal/server-agent-background/`), sharing the same
  *      built `main.mjs` bundle, so Netlify discovers it and honors its config.
- *   2. Give its `export const config` BOTH `background: true` (→ async invoke,
- *      immediate 202, 15-min budget) AND `path: AGENT_CHAT_PROCESS_RUN_PATH` (so
- *      it claims that exact path at function-matching time, which Netlify
- *      evaluates BEFORE redirects — step 10 vs 11 in the request chain).
- *   3. PATCH the Nitro `server` function's own `server.mjs` so its catch-all
- *      `config.path: "/*"` EXCLUDES `AGENT_CHAT_PROCESS_RUN_PATH` (append it to
- *      `excludedPath`). Netlify does NOT define a winner when two serverless
- *      functions both match a path; rather than rely on that undocumented order,
- *      we make the match UNAMBIGUOUS — only the background function matches
- *      `_process-run`, and `server` matches everything else exactly as before.
+ *   2. Give its `export const config` `background: true` (→ async invoke,
+ *      immediate 202, 15-min budget) and NO custom `config.path`. With no custom
+ *      path the function keeps its DEFAULT url
+ *      `/.netlify/functions/server-agent-background`, and because the Nitro
+ *      `server` function's `/*` catch-all already excludes `/.netlify/*`, that
+ *      default-url namespace is NEVER shadowed by the synchronous function — no
+ *      catch-all patch is needed.
+ *   3. The entry NORMALIZES/rewrites the incoming request pathname to
+ *      `AGENT_CHAT_PROCESS_RUN_PATH` before delegating to `./main.mjs`. The
+ *      function is reached at its default url
+ *      (`/.netlify/functions/server-agent-background`), so the Nitro router needs
+ *      the path rewritten to the framework `_process-run` route, preserving the
+ *      method, ALL headers (the HMAC `Authorization: Bearer` MUST survive), and
+ *      the body.
  *   4. Set `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.
  *
- * With a real `config.path` the function is reachable at that path directly, so
- * the foreground POSTs to `AGENT_CHAT_PROCESS_RUN_PATH`
- * (`resolveAgentChatProcessRunDispatchPath`) and the request entry no longer
- * needs to rewrite the path — it already arrives at the framework route. We keep
- * a defensive normalize-to-PROCESS_RUN_PATH in the entry anyway (cheap, and it
- * makes the function correct even if reached via its default function url).
+ * The foreground dispatches to this DEFAULT url on hosted Netlify
+ * (`resolveAgentChatProcessRunDispatchPath` → `AGENT_BACKGROUND_FUNCTION_URL_PATH`).
  *
- * WHY THIS BEATS ALL THREE PRIOR FAILURES:
- *   - Attempts 1 & 2 emitted into `functions-internal` (correct dir) with a
- *     `config.path` but did NOT exclude that path from the `server` `/*`
- *     catch-all. Two functions matched `_process-run`; the order is undocumented
- *     and the catch-all `server` (priority 0, synchronous) won → SYNC 401, not a
- *     202. We now exclude the path from `server`, so only the async function
- *     matches.
- *   - Attempt 3 emitted a standalone function into `.netlify/functions/` — the
- *     OUTPUT dir, which Netlify does not scan — so it never entered the manifest
- *     → 404. We now emit into the SCANNED `functions-internal` dir.
+ * WHY THIS IS THE DOC-CORRECT FIX: a prior attempt gave the function a custom
+ * `config.path` (= the framework route) plus a catch-all `excludedPath` patch.
+ * The custom `config.path` was NOT honored as a route in prod — a probe of
+ * `POST /_agent-native/agent-chat/_process-run` returned 404. The doc-correct
+ * approach (confirmed against the Netlify docs) is to use the DEFAULT function
+ * url with no custom path: the function stays reachable at
+ * `/.netlify/functions/<name>` and is never shadowed because `/.netlify/*` is
+ * already excluded from the `server` catch-all.
  *
  * Safety net regardless of Netlify routing nuance: if the dispatch fast-fails
  * (e.g. the function was not emitted), the foreground handler degrades to an
@@ -1338,10 +1334,6 @@ export function emitSingleTemplateNetlifyBackgroundFunction(projectCwd) {
     // Drop the original Nitro `/*` entry so our 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 });
-    // Make the `server` `/*` catch-all NOT match the process-run path, so only the
-    // async background function matches it (function-vs-function path order is
-    // undocumented on Netlify — don't rely on it).
-    excludeProcessRunPathFromServerCatchAll(serverDir);
     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
@@ -1359,11 +1351,10 @@ 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).
-// Because this function declares \`config.path = PROCESS_RUN_PATH\`, Netlify routes
-// that exact path here and the request already arrives as PROCESS_RUN_PATH — no
-// rewrite is needed. We still NORMALIZE the pathname to PROCESS_RUN_PATH so the
-// function stays correct even if it is ever reached via its default function url
-// (/.netlify/functions/${backgroundName}). Method, ALL headers (the HMAC
+// This function declares NO custom \`config.path\`, so it is reached at its
+// DEFAULT url (/.netlify/functions/${backgroundName}). The Nitro router only
+// knows the framework route, so we REWRITE the incoming pathname to
+// PROCESS_RUN_PATH before delegating. Method, ALL headers (the HMAC
 // Authorization: Bearer MUST survive — the plugin verifies it) and the body are
 // preserved by cloning the incoming Request with only its URL pathname set.
 export default async function handler(request) {
@@ -1387,13 +1378,12 @@ export const config = {
   generator: "agent-native build",
   // background: true makes Netlify invoke this ASYNCHRONOUSLY (immediate HTTP
   // 202 ack) with the 15-minute budget (Netlify docs:
-  // build/functions/background-functions + build/functions/api). path claims the
-  // process-run route directly; Netlify evaluates serverless functions BEFORE
-  // redirects (request-chain step 10 vs 11), and we exclude this path from the
-  // \`server\` /* catch-all so only THIS function matches it — no ambiguous
-  // function-vs-function order.
+  // build/functions/background-functions + build/functions/api). We declare NO
+  // custom path, so the function keeps its DEFAULT url
+  // /.netlify/functions/${backgroundName}; the Nitro \`server\` /* catch-all
+  // already excludes /.netlify/* so that default url is never shadowed by the
+  // synchronous function. The foreground dispatches to that default url.
   background: true,
-  path: PROCESS_RUN_PATH,
   nodeBundler: "none",
   includedFiles: ["**"],
   preferStatic: false,
@@ -1401,59 +1391,12 @@ export const config = {
 `;
     fs.writeFileSync(path.join(dest, `${backgroundName}.mjs`), entry);
     console.log(`[build] Emitted durable-background function "${backgroundName}" into the ` +
-        `scanned dir .netlify/functions-internal with config { background:true, ` +
-        `path:"${AGENT_CHAT_PROCESS_RUN_PATH}" } and excluded that path from the ` +
-        `server /* catch-all. REQUIRES real-deploy verification of Netlify async ` +
-        `(202) invocation — see docs/design/durable-agent-runs.md.`);
-}
-/**
- * Append `AGENT_CHAT_PROCESS_RUN_PATH` to the Nitro `server` function's
- * `config.excludedPath` so its `/*` catch-all does NOT match the process-run
- * path. That guarantees the async background function (which declares
- * `config.path = AGENT_CHAT_PROCESS_RUN_PATH`) is the ONLY function that matches
- * that path — Netlify does not define a winner when two serverless functions
- * both match, so we make the match unambiguous instead of relying on order.
- *
- * The Nitro-generated `server/server.mjs` is small and deterministic:
- *   export { default } from "./main.mjs";
- *   export const config = { ... excludedPath: ["/.netlify/*"], ... };
- * We parse the `excludedPath: [...]` array literal and add our path if absent.
- * If the shape ever changes and we can't find/parse it, we log and leave the
- * file untouched (the inline-40s fallback still keeps chat working).
- */
-function excludeProcessRunPathFromServerCatchAll(serverDir) {
-    const serverEntry = path.join(serverDir, "server.mjs");
-    if (!fs.existsSync(serverEntry)) {
-        console.warn("[build] Durable-background: server/server.mjs not found; cannot exclude " +
-            `${AGENT_CHAT_PROCESS_RUN_PATH} from the /* catch-all.`);
-        return;
-    }
-    const original = fs.readFileSync(serverEntry, "utf8");
-    if (original.includes(AGENT_CHAT_PROCESS_RUN_PATH)) {
-        // Already excluded (idempotent — emit may run on a re-used output tree).
-        return;
-    }
-    const excludedPathRe = /excludedPath:\s*\[([^\]]*)\]/;
-    const match = original.match(excludedPathRe);
-    const quotedPath = JSON.stringify(AGENT_CHAT_PROCESS_RUN_PATH);
-    if (match) {
-        const existing = match[1].trim();
-        const next = existing
-            ? `excludedPath: [${existing.replace(/,\s*$/, "")}, ${quotedPath}]`
-            : `excludedPath: [${quotedPath}]`;
-        fs.writeFileSync(serverEntry, original.replace(excludedPathRe, next));
-        return;
-    }
-    // No existing `excludedPath` — inject one into the config object. Match the
-    // `path: "/*"` line and add `excludedPath` right after it.
-    const pathLineRe = /(path:\s*("\/\*"|'\/\*'),?)/;
-    if (pathLineRe.test(original)) {
-        fs.writeFileSync(serverEntry, original.replace(pathLineRe, `$1\n  excludedPath: [${quotedPath}],`));
-        return;
-    }
-    console.warn("[build] Durable-background: could not locate excludedPath/path in " +
-        "server/server.mjs; leaving the /* catch-all unchanged (the background " +
-        "function may be shadowed — the inline-40s fallback still applies).");
+        `scanned dir .netlify/functions-internal with config { background:true } ` +
+        `and NO custom path — reachable at its default url ` +
+        `/.netlify/functions/${backgroundName} (never shadowed; the server /* ` +
+        `catch-all already excludes /.netlify/*). REQUIRES real-deploy ` +
+        `verification of Netlify async (202) invocation — see ` +
+        `docs/design/durable-agent-runs.md.`);
 }
 function copyInstalledLibsqlNativePackages(serverDir) {
     if (!serverDir || !fs.existsSync(serverDir))