@agent-native/core 0.92.9 → 0.92.11

package/dist/collab/recent-edits.js.map

@@ -1 +1 @@
-{"version":3,"file":"recent-edits.js","sourceRoot":"","sources":["../../src/collab/recent-edits.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Recent-edit attribution for collaborative documents.\n *\n * Every participant (human or agent) may publish a short ring of recent edits\n * in its awareness state under the `recentEdits` key. Clients render these as\n * lingering, fading highlights (\"Google Docs / Figma collaborator just edited\n * this\") for a few seconds after the edit lands, with the editor's name and\n * color next to the highlighted region.\n *\n * The descriptor is intentionally open-ended — each app publishes whatever its\n * surfaces can resolve back to a DOM rect:\n *   - `{ kind: \"text\", quote }`         rich-text apps resolve by text search\n *   - `{ kind: \"selector\", selector }`  canvas/DOM apps resolve by querySelector\n *   - `{ kind: \"paths\", paths }`        structured apps resolve JSON paths\n *     (e.g. `slides.3.content`) to their rendered element\n *   - `{ kind: \"doc\" }`                 whole-document change (no region)\n */\n\nimport {\n  RECENT_EDITS_MAX,\n  RECENT_EDIT_TTL_MS,\n  type AttributedRecentEdit,\n  type RecentEdit,\n} from \"@agent-native/toolkit/collab-ui\";\nimport { useEffect, useRef, useState } from \"react\";\n\nimport type { OtherPresence } from \"./presence.js\";\n\nexport {\n  RECENT_EDITS_MAX,\n  RECENT_EDIT_TTL_MS,\n  type AttributedRecentEdit,\n  type RecentEdit,\n  type RecentEditDescriptor,\n} from \"@agent-native/toolkit/collab-ui\";\n\n/**\n * Append an edit to a recentEdits ring, keeping the newest\n * {@link RECENT_EDITS_MAX} entries. Pure — returns a new array.\n */\nexport function appendRecentEdit(\n  existing: RecentEdit[] | undefined,\n  edit: RecentEdit,\n): RecentEdit[] {\n  const ring = Array.isArray(existing) ? existing.slice() : [];\n  ring.push(edit);\n  if (ring.length > RECENT_EDITS_MAX) {\n    ring.splice(0, ring.length - RECENT_EDITS_MAX);\n  }\n  return ring;\n}\n\n/**\n * Flatten non-expired recent edits from remote participants, newest last.\n * Pure — exported for tests and non-React consumers.\n */\nexport function collectRecentEdits(\n  others: OtherPresence[],\n  ttlMs: number,\n  now: number,\n): AttributedRecentEdit[] {\n  const result: AttributedRecentEdit[] = [];\n  for (const other of others) {\n    const ring = other.presence[\"recentEdits\"];\n    if (!Array.isArray(ring)) continue;\n    for (const raw of ring) {\n      const edit = raw as RecentEdit;\n      if (!edit || typeof edit.at !== \"number\" || !edit.descriptor) continue;\n      if (now - edit.at > ttlMs) continue;\n      result.push({\n        ...edit,\n        clientId: other.clientId,\n        user: other.user,\n        isAgent: other.isAgent,\n      });\n    }\n  }\n  result.sort((a, b) => a.at - b.at);\n  return result;\n}\n\nexport interface UseRecentEditsOptions {\n  /** How long a highlight lingers after the edit. Default 6000ms. */\n  ttlMs?: number;\n}\n\n/**\n * Reactive list of remote participants' recent edits that haven't expired.\n * Ticks internally (~500ms) while any highlight is visible so consumers can\n * render a smooth fade-out without wiring their own timers.\n */\nexport function useRecentEdits(\n  others: OtherPresence[],\n  options?: UseRecentEditsOptions,\n): AttributedRecentEdit[] {\n  const ttlMs = options?.ttlMs ?? RECENT_EDIT_TTL_MS;\n  const [edits, setEdits] = useState<AttributedRecentEdit[]>([]);\n  const othersRef = useRef(others);\n  othersRef.current = others;\n\n  useEffect(() => {\n    let timer: ReturnType<typeof setTimeout> | null = null;\n\n    function tick() {\n      const next = collectRecentEdits(othersRef.current, ttlMs, Date.now());\n      setEdits((prev) => (recentEditsEqual(prev, next) ? prev : next));\n      if (next.length > 0) {\n        timer = setTimeout(tick, 500);\n      } else {\n        timer = null;\n      }\n    }\n\n    tick();\n    return () => {\n      if (timer) clearTimeout(timer);\n    };\n  }, [others, ttlMs]);\n\n  return edits;\n}\n\n/**\n * Publish a local edit into this client's awareness ring so peers render a\n * lingering highlight for it. Call from app mutation paths (throttled by the\n * ring size + TTL; safe to call per committed edit, not per keystroke).\n */\nexport function publishRecentEdit(\n  awareness: {\n    getLocalState: () => Record<string, unknown> | null;\n    setLocalStateField: (field: string, value: unknown) => void;\n  },\n  edit: Omit<RecentEdit, \"at\"> & { at?: number },\n): void {\n  const local = awareness.getLocalState();\n  const existing = local?.[\"recentEdits\"] as RecentEdit[] | undefined;\n  awareness.setLocalStateField(\n    \"recentEdits\",\n    appendRecentEdit(existing, { ...edit, at: edit.at ?? Date.now() }),\n  );\n}\n\nfunction recentEditsEqual(\n  a: AttributedRecentEdit[],\n  b: AttributedRecentEdit[],\n): boolean {\n  if (a.length !== b.length) return false;\n  for (let i = 0; i < a.length; i++) {\n    if (a[i].clientId !== b[i].clientId || a[i].at !== b[i].at) return false;\n  }\n  return true;\n}\n"]}
+{"version":3,"file":"recent-edits.js","sourceRoot":"","sources":["../../src/collab/recent-edits.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Recent-edit attribution for collaborative documents.\n *\n * Every participant (human or agent) may publish a short ring of recent edits\n * in its awareness state under the `recentEdits` key. Clients render these as\n * lingering, fading highlights (\"Google Docs / Figma collaborator just edited\n * this\") for a few seconds after the edit lands, with the editor's name and\n * color next to the highlighted region.\n *\n * The descriptor is intentionally open-ended — each app publishes whatever its\n * surfaces can resolve back to a DOM rect:\n *   - `{ kind: \"text\", quote }`         rich-text apps resolve by text search\n *   - `{ kind: \"selector\", selector }`  canvas/DOM apps resolve by querySelector\n *   - `{ kind: \"paths\", paths }`        structured apps resolve JSON paths\n *     (e.g. `slides.3.content`) to their rendered element\n *   - `{ kind: \"doc\" }`                 whole-document change (no region)\n */\n\nimport {\n  RECENT_EDITS_MAX,\n  RECENT_EDIT_TTL_MS,\n  type AttributedRecentEdit,\n  type RecentEdit,\n  type RecentEditDescriptor,\n} from \"@agent-native/toolkit/collab-ui\";\nimport { useEffect, useRef, useState } from \"react\";\n\nimport type { OtherPresence } from \"./presence.js\";\n\nexport {\n  RECENT_EDITS_MAX,\n  RECENT_EDIT_TTL_MS,\n  type AttributedRecentEdit,\n  type RecentEdit,\n  type RecentEditDescriptor,\n} from \"@agent-native/toolkit/collab-ui\";\n\n/**\n * Hard cap on any single string carried in a recentEdits entry (quote,\n * selector, path segment, label). Callers are expected to pass short\n * excerpts already (existing call sites trim to 80–120 chars for a \"what\n * changed\" snippet), but this is the ring's own size ceiling — a caller that\n * forgets to trim (e.g. passing a whole paragraph/document as `quote`) must\n * not blow up the awareness payload every connected client receives on the\n * fast-push path, nor the `_collab_awareness` SQL row it gets mirrored into.\n */\nconst RECENT_EDIT_STRING_MAX = 500;\n\nfunction truncateString(value: string): string {\n  return value.length > RECENT_EDIT_STRING_MAX\n    ? value.slice(0, RECENT_EDIT_STRING_MAX)\n    : value;\n}\n\nfunction truncateDescriptor(\n  descriptor: RecentEditDescriptor,\n): RecentEditDescriptor {\n  // The union's last member (`{ kind: string; [key: string]: unknown }`) is an\n  // open-ended catch-all whose `kind` is a plain `string`, so a `switch` on\n  // `descriptor.kind` can't discriminate it away from the literal-kind\n  // members for the compiler — every property still type-checks as\n  // `unknown`. Read/write through an untyped view instead and lean on\n  // runtime checks; the return value is cast back to the real type below.\n  const d = descriptor as Record<string, unknown> & { kind: string };\n  if (d.kind === \"text\" && typeof d.quote === \"string\") {\n    return { ...d, quote: truncateString(d.quote) } as RecentEditDescriptor;\n  }\n  if (d.kind === \"selector\" && typeof d.selector === \"string\") {\n    return {\n      ...d,\n      selector: truncateString(d.selector),\n    } as RecentEditDescriptor;\n  }\n  if (d.kind === \"paths\" && Array.isArray(d.paths)) {\n    return {\n      ...d,\n      paths: d.paths.map((p) =>\n        typeof p === \"string\" ? truncateString(p) : p,\n      ),\n    } as RecentEditDescriptor;\n  }\n  if (d.kind === \"doc\") {\n    return descriptor;\n  }\n  // Open-ended shape — trim any string-valued fields defensively without\n  // knowing their names.\n  const trimmed: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(d)) {\n    trimmed[key] = typeof value === \"string\" ? truncateString(value) : value;\n  }\n  return trimmed as RecentEditDescriptor;\n}\n\n/**\n * Append an edit to a recentEdits ring, keeping the newest\n * {@link RECENT_EDITS_MAX} entries. Pure — returns a new array. Descriptor\n * strings and the label are truncated to {@link RECENT_EDIT_STRING_MAX}\n * characters as a defensive cap on the awareness payload size.\n */\nexport function appendRecentEdit(\n  existing: RecentEdit[] | undefined,\n  edit: RecentEdit,\n): RecentEdit[] {\n  const ring = Array.isArray(existing) ? existing.slice() : [];\n  ring.push({\n    ...edit,\n    descriptor: truncateDescriptor(edit.descriptor),\n    label: edit.label ? truncateString(edit.label) : edit.label,\n  });\n  if (ring.length > RECENT_EDITS_MAX) {\n    ring.splice(0, ring.length - RECENT_EDITS_MAX);\n  }\n  return ring;\n}\n\n/**\n * Flatten non-expired recent edits from remote participants, newest last.\n * Pure — exported for tests and non-React consumers.\n */\nexport function collectRecentEdits(\n  others: OtherPresence[],\n  ttlMs: number,\n  now: number,\n): AttributedRecentEdit[] {\n  const result: AttributedRecentEdit[] = [];\n  for (const other of others) {\n    const ring = other.presence[\"recentEdits\"];\n    if (!Array.isArray(ring)) continue;\n    for (const raw of ring) {\n      const edit = raw as RecentEdit;\n      if (!edit || typeof edit.at !== \"number\" || !edit.descriptor) continue;\n      if (now - edit.at > ttlMs) continue;\n      result.push({\n        ...edit,\n        clientId: other.clientId,\n        user: other.user,\n        isAgent: other.isAgent,\n      });\n    }\n  }\n  result.sort((a, b) => a.at - b.at);\n  return result;\n}\n\nexport interface UseRecentEditsOptions {\n  /** How long a highlight lingers after the edit. Default 6000ms. */\n  ttlMs?: number;\n}\n\n/**\n * Reactive list of remote participants' recent edits that haven't expired.\n * Ticks internally (~500ms) while any highlight is visible so consumers can\n * render a smooth fade-out without wiring their own timers.\n */\nexport function useRecentEdits(\n  others: OtherPresence[],\n  options?: UseRecentEditsOptions,\n): AttributedRecentEdit[] {\n  const ttlMs = options?.ttlMs ?? RECENT_EDIT_TTL_MS;\n  const [edits, setEdits] = useState<AttributedRecentEdit[]>([]);\n  const othersRef = useRef(others);\n  othersRef.current = others;\n\n  useEffect(() => {\n    let timer: ReturnType<typeof setTimeout> | null = null;\n\n    function tick() {\n      const next = collectRecentEdits(othersRef.current, ttlMs, Date.now());\n      setEdits((prev) => (recentEditsEqual(prev, next) ? prev : next));\n      if (next.length > 0) {\n        timer = setTimeout(tick, 500);\n      } else {\n        timer = null;\n      }\n    }\n\n    tick();\n    return () => {\n      if (timer) clearTimeout(timer);\n    };\n  }, [others, ttlMs]);\n\n  return edits;\n}\n\n/**\n * Publish a local edit into this client's awareness ring so peers render a\n * lingering highlight for it. Call from app mutation paths (throttled by the\n * ring size + TTL; safe to call per committed edit, not per keystroke).\n */\nexport function publishRecentEdit(\n  awareness: {\n    getLocalState: () => Record<string, unknown> | null;\n    setLocalStateField: (field: string, value: unknown) => void;\n  },\n  edit: Omit<RecentEdit, \"at\"> & { at?: number },\n): void {\n  const local = awareness.getLocalState();\n  const existing = local?.[\"recentEdits\"] as RecentEdit[] | undefined;\n  awareness.setLocalStateField(\n    \"recentEdits\",\n    appendRecentEdit(existing, { ...edit, at: edit.at ?? Date.now() }),\n  );\n}\n\nfunction recentEditsEqual(\n  a: AttributedRecentEdit[],\n  b: AttributedRecentEdit[],\n): boolean {\n  if (a.length !== b.length) return false;\n  for (let i = 0; i < a.length; i++) {\n    if (a[i].clientId !== b[i].clientId || a[i].at !== b[i].at) return false;\n  }\n  return true;\n}\n"]}

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

package/dist/deploy/build.d.ts

@@ -150,6 +150,13 @@ export declare function isDurableBackgroundDeployEnabled(): boolean;
  * inline 40s synchronous run (see production-agent.ts).
  */
 export declare function emitSingleTemplateNetlifyBackgroundFunction(projectCwd: string): void;
+/**
+ * Nitro can preserve Vite's `yjs` external in a split server chunk even when
+ * its own server build has emitted `_libs/yjs.mjs`. Netlify does not install
+ * that bare package at runtime, so make every emitted server chunk use the
+ * bundled copy before its function is packaged.
+ */
+export declare function rewriteBareYjsImportsForServerlessOutput(serverDir: string): string[];
 export declare function assertSingleTemplateNetlifyBuildOutput(projectCwd: string): void;
 /**
  * Strip the harmful single-template catch-all rewrite that points at
@@ -196,5 +203,22 @@ export interface NitroBuildPipelineOptions {
  * anything with a file extension.
  */
 export declare function runNitroBuildPipeline(opts: NitroBuildPipelineOptions): Promise<void>;
+/**
+ * Dependencies that must be bundled into every Nitro server output instead of
+ * being left as runtime package imports.
+ *
+ * `yjs` is a direct core dependency, but it is deliberately externalized from
+ * the intermediate Vite SSR graph so that Vite and Nitro do not create two
+ * incompatible Yjs constructors. On file-traced serverless presets, leaving it
+ * external at Nitro's final build can emit `import "yjs"` into a function
+ * chunk without placing the package in that function's `node_modules`. Bundle
+ * it in Nitro's final output so every template receives the one portable copy.
+ */
+export declare const NITRO_SERVER_RUNTIME_BUNDLED_DEPS: readonly ["yjs"];
+/**
+ * Edge runtimes have no node_modules, while Node/serverless outputs only need
+ * the small set above bundled to keep their package manifests traceable.
+ */
+export declare function nitroNoExternalsForPreset(targetPreset: string): true | readonly string[];
 export {};
 //# sourceMappingURL=build.d.ts.map

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;AAmCH,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAI7B,eAAO,MAAM,6BAA6B,UAiBzC,CAAC;AAEF,eAAO,MAAM,mCAAmC,UAiB/C,CAAC;AACF,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiFjE,CAAC;AA6BF,eAAO,MAAM,2CAA2C,EAAE,MAAM,CAC9D,MAAM,EACN,MAAM,CAmSP,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,UAAU,wBAAwB;IAChC,KAAK,EAAE,6BAA6B,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;IACtD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,6BAA6B;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,UAAU,6BAA6B;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAwBD,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,EACnD,OAAO,GAAE,0BAA+B,GACvC,MAAM,CAkoBR;AA4FD,wBAAgB,8CAA8C,CAC5D,QAAQ,EAAE,wBAAwB,EAClC,QAAQ,SAAmC,GAC1C,MAAM,CAiCR;AA6dD,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AA+GD,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,iBAAiB,cAAoB,QAoCtC;AAiCD,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;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gCAAgC,IAAI,OAAO,CAK1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,2CAA2C,CACzD,UAAU,EAAE,MAAM,GACjB,IAAI,CA0GN;AAYD,wBAAgB,sCAAsC,CACpD,UAAU,EAAE,MAAM,GACjB,IAAI,CAgIN;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAsC5E;AAuED;;;;;;GAMG;AACH,wBAAgB,yCAAyC,CACvD,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,IAAI,CAqDN;AA6ID;;;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":"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"}

package/dist/deploy/build.js

@@ -2021,6 +2021,66 @@ export const config = {
  * the SSR catch-all runs.
  */
 const NETLIFY_DEFAULT_FUNCTION_URL_REDIRECT = "/* /.netlify/functions/server 200";
+function hasBareYjsRuntimeImport(source) {
+    return /\b(?:from\s*|import\s*\(\s*|import\s*)["']yjs(?:\/[^"']*)?["']/.test(source);
+}
+function hasUnsupportedYjsSubpathImport(source) {
+    return /\b(?:from\s*|import\s*\(\s*|import\s*)["']yjs\/[^"']*["']/.test(source);
+}
+function walkServerJavaScriptFiles(dir, onFile) {
+    if (!fs.existsSync(dir))
+        return;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const entryPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walkServerJavaScriptFiles(entryPath, onFile);
+            continue;
+        }
+        if (/\.(?:[cm]?js)$/.test(entry.name))
+            onFile(entryPath);
+    }
+}
+/**
+ * Nitro can preserve Vite's `yjs` external in a split server chunk even when
+ * its own server build has emitted `_libs/yjs.mjs`. Netlify does not install
+ * that bare package at runtime, so make every emitted server chunk use the
+ * bundled copy before its function is packaged.
+ */
+export function rewriteBareYjsImportsForServerlessOutput(serverDir) {
+    const bareImports = [];
+    const unsupportedSubpathImports = [];
+    const bundledYjsPath = path.join(serverDir, "_libs", "yjs.mjs");
+    walkServerJavaScriptFiles(serverDir, (filePath) => {
+        const source = fs.readFileSync(filePath, "utf-8");
+        if (!hasBareYjsRuntimeImport(source))
+            return;
+        if (hasUnsupportedYjsSubpathImport(source)) {
+            unsupportedSubpathImports.push(filePath);
+            return;
+        }
+        bareImports.push(filePath);
+    });
+    if (unsupportedSubpathImports.length > 0) {
+        throw new Error(`[deploy] Serverless output left unsupported yjs subpath imports in ${unsupportedSubpathImports.join(", ")}`);
+    }
+    if (bareImports.length === 0)
+        return [];
+    if (!fs.existsSync(bundledYjsPath)) {
+        throw new Error(`[deploy] Serverless output left yjs as a runtime import but did not emit ${bundledYjsPath}`);
+    }
+    for (const filePath of bareImports) {
+        const bundledImport = path
+            .relative(path.dirname(filePath), bundledYjsPath)
+            .split(path.sep)
+            .join("/");
+        const relativeBundledImport = bundledImport.startsWith(".")
+            ? bundledImport
+            : `./${bundledImport}`;
+        const source = fs.readFileSync(filePath, "utf-8");
+        fs.writeFileSync(filePath, source.replace(/(\b(?:from\s*|import\s*\(\s*|import\s*))(["'])yjs\2/g, (_match, importPrefix, quote) => `${importPrefix}${quote}${relativeBundledImport}${quote}`));
+    }
+    return bareImports;
+}
 export function assertSingleTemplateNetlifyBuildOutput(projectCwd) {
     const failures = [];
     const publishDir = path.join(projectCwd, "dist");
@@ -2072,6 +2132,20 @@ export function assertSingleTemplateNetlifyBuildOutput(projectCwd) {
             failures.push("Netlify server entry must keep preferStatic: true so /assets/* is served from dist before the SSR catch-all");
         }
     }
+    // Netlify's function packager does not install arbitrary runtime package
+    // imports left in Nitro chunks. A bare Yjs import here would deploy
+    // successfully but fail on the first SSR request with ERR_MODULE_NOT_FOUND.
+    // Keep this check adjacent to the output guard so both local builds and CI
+    // reject that artifact before it reaches Netlify.
+    const bareYjsImports = [];
+    walkServerJavaScriptFiles(serverDir, (filePath) => {
+        if (hasBareYjsRuntimeImport(fs.readFileSync(filePath, "utf-8"))) {
+            bareYjsImports.push(path.relative(projectCwd, filePath));
+        }
+    });
+    if (bareYjsImports.length > 0) {
+        failures.push(`Netlify server bundle leaves yjs as a runtime import: ${bareYjsImports.join(", ")}`);
+    }
     if (isDurableBackgroundDeployEnabled()) {
         const backgroundDir = path.join(internalDir, AGENT_BACKGROUND_FUNCTION_NAME);
         const backgroundEntryPath = path.join(backgroundDir, `${AGENT_BACKGROUND_FUNCTION_NAME}.mjs`);
@@ -2421,6 +2495,28 @@ const BROWSER_ONLY_SERVER_LIBS = [
     "@excalidraw/mermaid-to-excalidraw",
     "mermaid",
 ];
+/**
+ * Dependencies that must be bundled into every Nitro server output instead of
+ * being left as runtime package imports.
+ *
+ * `yjs` is a direct core dependency, but it is deliberately externalized from
+ * the intermediate Vite SSR graph so that Vite and Nitro do not create two
+ * incompatible Yjs constructors. On file-traced serverless presets, leaving it
+ * external at Nitro's final build can emit `import "yjs"` into a function
+ * chunk without placing the package in that function's `node_modules`. Bundle
+ * it in Nitro's final output so every template receives the one portable copy.
+ */
+export const NITRO_SERVER_RUNTIME_BUNDLED_DEPS = ["yjs"];
+/**
+ * Edge runtimes have no node_modules, while Node/serverless outputs only need
+ * the small set above bundled to keep their package manifests traceable.
+ */
+export function nitroNoExternalsForPreset(targetPreset) {
+    return targetPreset.startsWith("cloudflare") ||
+        targetPreset.startsWith("deno")
+        ? true
+        : NITRO_SERVER_RUNTIME_BUNDLED_DEPS;
+}
 /**
  * Rolldown plugin for the Nitro server bundle that replaces the browser-only
  * renderers above with an inert proxy module.
@@ -2561,11 +2657,11 @@ export default bundle;
             ? { plugins: [providedPluginsNitroPlugin] }
             : {}),
         routeRules: mcpEmbedStaticAssetRouteRules(appBasePath),
-        // For edge presets (cloudflare, deno), bundle all deps — node_modules
-        // aren't available at runtime. Netlify/Vercel/Node have node_modules.
-        ...(preset.startsWith("cloudflare") || preset.startsWith("deno")
-            ? { noExternals: true }
-            : {}),
+        // Edge presets (cloudflare, deno) bundle all deps because node_modules are
+        // unavailable at runtime. Node/serverless presets also bundle Yjs: Nitro's
+        // file tracer otherwise leaves a bare import that Netlify function bundles
+        // cannot resolve under pnpm.
+        noExternals: nitroNoExternalsForPreset(preset),
     });
     await runNitroBuildPipeline({
         nitro,
@@ -2580,6 +2676,7 @@ export default bundle;
         copyInstalledResvgPackages(nitro.options.output.serverDir);
         copyInstalledFfmpegStaticPackage(nitro.options.output.serverDir);
         sanitizeServerlessFunctionPackageManifest(nitro.options.output.serverDir);
+        rewriteBareYjsImportsForServerlessOutput(nitro.options.output.serverDir);
     }
     // Durable background agent runs (default-OFF / opt-in; enable with a truthy
     // AGENT_CHAT_DURABLE_BACKGROUND). Additive ONLY: emits a SECOND Netlify