@nimbus-sh/worker 0.5.0 → 0.7.0

package/dist/facets/process.d.ts

@@ -45,11 +45,13 @@ export interface ExecStreamResult {
 }
 /**
  * Output chunk in a child's per-fd ring. Sequence numbers let parents
- * read incrementally with cpReadOutput(sinceSeq).
+ * read incrementally with cpReadOutput(sinceSeq). The data is bytes: a
+ * child's stdio is not text, and a string here would lose any byte sequence
+ * that is not valid UTF-8.
  */
 interface OutputChunk {
     seq: number;
-    data: string;
+    data: Uint8Array;
 }
 /**
  * Per-child mutable state. Created on spawn, torn down only when the
@@ -65,11 +67,11 @@ interface ChildEntry {
     facetName: string;
     startedAt: number;
     endedAt: number | null;
-    stdinChunks: string[];
+    stdinChunks: Uint8Array[];
     stdinClosed: boolean;
     stdinTotalBytes: number;
     stdinWaiters: Array<(r: {
-        data: string;
+        data: Uint8Array;
         ended: boolean;
     }) => void>;
     outputs: {
@@ -116,26 +118,29 @@ export interface SpawnReq {
 export interface ReadOutputResult {
     chunks: {
         seq: number;
-        data: string;
+        data: Uint8Array;
     }[];
     closed: boolean;
     maxSeq: number;
 }
 export interface DrainResult {
-    stdout: string;
-    stderr: string;
+    stdout: Uint8Array;
+    stderr: Uint8Array;
     stdoutClosed: boolean;
     stderrClosed: boolean;
 }
 /**
  * Hooks invoked by the inline runner / facet-direct runner to push
  * output back into the per-child ring. Kept as a small structural type
- * so tests can supply mocks.
+ * so tests can supply mocks. They carry bytes; a text producer encodes at
+ * its own edge (see `textBytes`).
  */
 export interface OutputHooks {
-    onStdout: (data: string) => void;
-    onStderr: (data: string) => void;
+    onStdout: (data: Uint8Array) => void;
+    onStderr: (data: Uint8Array) => void;
 }
+/** A text producer's edge onto the byte hooks. */
+export declare function textBytes(text: string): Uint8Array;
 /**
  * Command resolution. The shell registry returns whatever shape it likes;
  * we adapt to a normalized 3-state result.
@@ -186,10 +191,7 @@ export interface FacetProcessManagerDeps {
     };
     /** Optional Worker Loader pool for isolating child-process dispatch. */
     spawnPool?: {
-        runOne: (req: any, kind: Exclude<CommandKind, 'unknown'>, hooks: {
-            onStdout: (d: string) => void;
-            onStderr: (d: string) => void;
-        }) => Promise<number>;
+        runOne: (req: any, kind: Exclude<CommandKind, 'unknown'>, hooks: OutputHooks) => Promise<number>;
     };
 }
 /** Cap recursion depth to defend against runaway spawn loops. */
@@ -240,7 +242,7 @@ export declare class FacetProcessManager {
     private _drainStdinForShell;
     private _shellCommandLineForPlan;
     private _runShellLine;
-    stdinWrite(childPid: number, data: string): {
+    stdinWrite(childPid: number, data: Uint8Array): {
         ok: boolean;
     };
     stdinEnd(childPid: number): void;
@@ -249,9 +251,11 @@ export declare class FacetProcessManager {
      * Returns immediately if data is already queued OR if stdin is closed.
      */
     cpReadStdin(childPid: number, waitMs: number): Promise<{
-        data: string;
+        data: Uint8Array;
         ended: boolean;
     }>;
+    /** A broker-side text message onto the child's byte ring. */
+    private _appendText;
     /** Internal: push a chunk to fd 1 or 2, fire log-store + waiters. */
     private _appendOutput;
     /**

package/dist/facets/process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/facets/process.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/facets/process.ts"],"names":[],"mappings":"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"}

package/dist/facets/process.js

@@ -35,6 +35,23 @@
  */
 import { resolveVfsPath } from '@nimbus-sh/core/vfs/path.js';
 import { parseShellInvocation } from '@nimbus-sh/core/shell/shell-invocation.js';
+import { enc, dec, StreamTextDecoders } from '@nimbus-sh/core/_shared/bytes.js';
+/** A text producer's edge onto the byte hooks. */
+export function textBytes(text) {
+    return enc.encode(text);
+}
+function concatBytes(chunks) {
+    let total = 0;
+    for (const c of chunks)
+        total += c.byteLength;
+    const joined = new Uint8Array(total);
+    let at = 0;
+    for (const c of chunks) {
+        joined.set(c, at);
+        at += c.byteLength;
+    }
+    return joined;
+}
 /** Cap recursion depth to defend against runaway spawn loops. */
 export const CHILD_PROCESS_MAX_DEPTH = 8;
 /**
@@ -44,6 +61,7 @@ export const CHILD_PROCESS_MAX_DEPTH = 8;
  * signal (real Node would return false from .write).
  */
 const STDIN_QUEUE_MAX_BYTES = 256 * 1024; // 256 KiB
+const EMPTY_BYTES = new Uint8Array(0);
 const STDIN_ATTACH_WAIT_MS = 500;
 /**
  * How long the parent's cpReadOutput long-poll waits for new chunks
@@ -189,7 +207,7 @@ export class FacetProcessManager {
             void this._dispatch(child, kind, dispatchReq).catch((e) => {
                 // Last-resort: if both runners somehow throw, exit 1 with the error
                 // on stderr.
-                this._appendOutput(child, 2, `Error: ${e?.message || String(e)}\n`);
+                this._appendText(child, 2, `Error: ${e?.message || String(e)}\n`);
                 this._stampExit(child, 1, null);
             });
         }, 0);
@@ -198,7 +216,7 @@ export class FacetProcessManager {
     /** Dispatch by kind. */
     async _dispatch(child, kind, req) {
         if (kind === 'unknown') {
-            this._appendOutput(child, 2, `${req.command}: command not found\n`);
+            this._appendText(child, 2, `${req.command}: command not found\n`);
             this._stampExit(child, 127, null);
             return;
         }
@@ -236,7 +254,7 @@ export class FacetProcessManager {
                 this._stampExit(child, code, null);
             }
             catch (e) {
-                this._appendOutput(child, 2, `spawn-pool error: ${e?.message || String(e)}\n`);
+                this._appendText(child, 2, `spawn-pool error: ${e?.message || String(e)}\n`);
                 this._stampExit(child, 1, null);
             }
             return;
@@ -257,7 +275,7 @@ export class FacetProcessManager {
                 this._stampExit(child, code, null);
             }
             catch (e) {
-                this._appendOutput(child, 2, `Error: ${e?.message || String(e)}\n`);
+                this._appendText(child, 2, `Error: ${e?.message || String(e)}\n`);
                 this._stampExit(child, 1, null);
             }
             return;
@@ -281,7 +299,7 @@ export class FacetProcessManager {
             this._stampExit(child, code, null);
         }
         catch (e) {
-            this._appendOutput(child, 2, `facet error: ${e?.message || String(e)}\n`);
+            this._appendText(child, 2, `facet error: ${e?.message || String(e)}\n`);
             this._stampExit(child, 1, null);
         }
     }
@@ -302,11 +320,14 @@ export class FacetProcessManager {
         if (kind === 'unknown') {
             return { exitCode: 127, stdout: '', stderr: `${req.command}: command not found\n` };
         }
+        // An inline result is text for a caller expecting text: decode here, at
+        // its edge, streaming per fd so a split multibyte character survives.
         let stdoutBuf = '';
         let stderrBuf = '';
+        const decoders = new StreamTextDecoders();
         const hooks = {
-            onStdout: (d) => { stdoutBuf += d; },
-            onStderr: (d) => { stderrBuf += d; },
+            onStdout: (d) => { stdoutBuf += decoders.decode(1, d); },
+            onStderr: (d) => { stderrBuf += decoders.decode(2, d); },
         };
         const childEnv = {
             ...(req.env || {}),
@@ -404,7 +425,9 @@ export class FacetProcessManager {
         if (!child.stdinClosed && child.stdinChunks.length > 0) {
             await this._waitForStdinEvent(child, STDIN_ATTACH_WAIT_MS);
         }
-        return child.stdinChunks.join('');
+        // A pure builtin takes its stdin as text, so the decode happens here,
+        // at the consumer's edge, over the whole queued run at once.
+        return dec.decode(concatBytes(child.stdinChunks));
     }
     _shellPlanFor(req) {
         const args = Array.isArray(req.args) ? req.args.map(String) : [];
@@ -420,7 +443,7 @@ export class FacetProcessManager {
     async _dispatchShell(child, req, hooks) {
         const plan = this._shellPlanFor(req);
         if (!plan) {
-            this._appendOutput(child, 2, `${req.command}: unsupported shell invocation\n`);
+            this._appendText(child, 2, `${req.command}: unsupported shell invocation\n`);
             this._stampExit(child, 127, null);
             return;
         }
@@ -435,7 +458,7 @@ export class FacetProcessManager {
             this._stampExit(child, typeof code === 'number' ? code : 0, null);
         }
         catch (e) {
-            this._appendOutput(child, 2, `shell error: ${e?.message || String(e)}\n`);
+            this._appendText(child, 2, `shell error: ${e?.message || String(e)}\n`);
             this._stampExit(child, 1, null);
         }
     }
@@ -446,7 +469,8 @@ export class FacetProcessManager {
         if (!child.stdinClosed && child.stdinChunks.length > 0) {
             await this._waitForStdinEvent(child, STDIN_ATTACH_WAIT_MS);
         }
-        return child.stdinChunks.join('');
+        // A shell line's stdin is text; the queue holds bytes.
+        return dec.decode(concatBytes(child.stdinChunks));
     }
     _shellCommandLineForPlan(plan, cwd, stdin, hooks, shellName, processPid) {
         if (plan.kind === 'command')
@@ -457,19 +481,19 @@ export class FacetProcessManager {
         try {
             const vfs = this.deps.vfsForProcess(processPid);
             if (!vfs.exists(scriptPath) || vfs.isDirectory(scriptPath)) {
-                hooks.onStderr(`${shellName}: ${plan.path}: No such file or directory\n`);
+                hooks.onStderr(textBytes(`${shellName}: ${plan.path}: No such file or directory\n`));
                 return null;
             }
             return vfs.readFileString(scriptPath);
         }
         catch (e) {
-            hooks.onStderr(`${shellName}: ${plan.path}: ${e?.message || String(e)}\n`);
+            hooks.onStderr(textBytes(`${shellName}: ${plan.path}: ${e?.message || String(e)}\n`));
             return null;
         }
     }
     async _runShellLine(pid, commandLine, env, cwd, stdin, hooks) {
         if (!this.deps.shellExecutor) {
-            hooks.onStderr('sh: shell executor unavailable\n');
+            hooks.onStderr(textBytes('sh: shell executor unavailable\n'));
             return 127;
         }
         return this.deps.shellExecutor.execute(pid, commandLine, env, cwd || '/home/user', stdin, hooks);
@@ -479,11 +503,14 @@ export class FacetProcessManager {
         const child = this.children.get(childPid);
         if (!child || child.stdinClosed || child.exitCode !== null)
             return { ok: false };
-        if (child.stdinTotalBytes + data.length > STDIN_QUEUE_MAX_BYTES) {
+        // The cap counts BYTES. It used to count the string's UTF-16 code units,
+        // which undercounts any multibyte character and overcounts a surrogate
+        // pair, so the queue's own limit did not mean what it said.
+        if (child.stdinTotalBytes + data.byteLength > STDIN_QUEUE_MAX_BYTES) {
             return { ok: false };
         }
         child.stdinChunks.push(data);
-        child.stdinTotalBytes += data.length;
+        child.stdinTotalBytes += data.byteLength;
         // Flush any waiters
         for (const w of child.stdinWaiters.splice(0)) {
             w({ data, ended: false });
@@ -496,7 +523,7 @@ export class FacetProcessManager {
             return;
         child.stdinClosed = true;
         for (const w of child.stdinWaiters.splice(0)) {
-            w({ data: '', ended: true });
+            w({ data: EMPTY_BYTES, ended: true });
         }
     }
     /**
@@ -506,21 +533,21 @@ export class FacetProcessManager {
     async cpReadStdin(childPid, waitMs) {
         const child = this.children.get(childPid);
         if (!child)
-            return { data: '', ended: true };
+            return { data: EMPTY_BYTES, ended: true };
         if (child.stdinChunks.length > 0) {
             const data = child.stdinChunks.shift();
-            child.stdinTotalBytes -= data.length;
+            child.stdinTotalBytes -= data.byteLength;
             return { data, ended: false };
         }
         if (child.stdinClosed)
-            return { data: '', ended: true };
+            return { data: EMPTY_BYTES, ended: true };
         // Long-poll
         return new Promise((resolve) => {
             const timer = setTimeout(() => {
                 const idx = child.stdinWaiters.indexOf(wrapped);
                 if (idx >= 0)
                     child.stdinWaiters.splice(idx, 1);
-                resolve({ data: '', ended: false });
+                resolve({ data: EMPTY_BYTES, ended: false });
             }, Math.min(waitMs, 5000));
             const wrapped = (r) => {
                 clearTimeout(timer);
@@ -530,17 +557,21 @@ export class FacetProcessManager {
         });
     }
     // ── output queue ────────────────────────────────────────────────────────
+    /** A broker-side text message onto the child's byte ring. */
+    _appendText(child, fd, text) {
+        this._appendOutput(child, fd, textBytes(text));
+    }
     /** Internal: push a chunk to fd 1 or 2, fire log-store + waiters. */
     _appendOutput(child, fd, data) {
-        if (!data)
+        if (data.byteLength === 0)
             return;
         child.outputSeq[fd]++;
         const chunk = { seq: child.outputSeq[fd], data };
         child.outputs[fd].push(chunk);
         // Tee to the process supervisor's log ring for `logs <pid>` parity
-        // with facet processes.
+        // with facet processes; the ring decodes at its own edge.
         try {
-            this.deps.processes.appendOutput(child.pid, fd === 1 ? 'stdout' : 'stderr', data);
+            this.deps.processes.appendOutputBytes(child.pid, fd === 1 ? 'stdout' : 'stderr', data);
         }
         catch { /* ignore */ }
         // Resolve waiters whose fd matches and whose sinceSeq is now satisfied.
@@ -610,7 +641,7 @@ export class FacetProcessManager {
     async drainOutput(childPid) {
         const child = this.children.get(childPid);
         if (!child) {
-            return { stdout: '', stderr: '', stdoutClosed: true, stderrClosed: true };
+            return { stdout: EMPTY_BYTES, stderr: EMPTY_BYTES, stdoutClosed: true, stderrClosed: true };
         }
         // Wait briefly (up to 50ms) for the dispatch to settle if the child
         // hasn't exited yet — without this, drain races against the spawn's
@@ -620,8 +651,8 @@ export class FacetProcessManager {
             await new Promise((r) => setTimeout(r, 5));
         }
         return {
-            stdout: child.outputs[1].map((c) => c.data).join(''),
-            stderr: child.outputs[2].map((c) => c.data).join(''),
+            stdout: concatBytes(child.outputs[1].map((c) => c.data)),
+            stderr: concatBytes(child.outputs[2].map((c) => c.data)),
             stdoutClosed: child.exitCode !== null,
             stderrClosed: child.exitCode !== null,
         };
@@ -697,7 +728,7 @@ export class FacetProcessManager {
         // Wake stdin waiters with ended=true so a child blocked on cpReadStdin
         // unblocks and exits cleanly.
         for (const w of child.stdinWaiters.splice(0)) {
-            w({ data: '', ended: true });
+            w({ data: EMPTY_BYTES, ended: true });
         }
     }
     /**

package/dist/facets/real-vite-fs-shim.js

@@ -69,7 +69,7 @@
  *   - Any file > MAX_FILE_BYTES (skipped with a diagnostic).
  *
  * Returns a Record<path, content>. Paths are absolute filesystem paths
- * as seen by Vite (/home/user/app/src/main.tsx).
+ * as seen by Vite (/home/user/example-app/src/main.tsx).
  */
 const MAX_FILE_BYTES = 256 * 1024; // 256 KB per file
 const MAX_TOTAL_USER_BYTES = 16 * 1024 * 1024; // 16 MB cap on USER project
@@ -1260,7 +1260,7 @@ ${Object.entries(cjsPrebuiltBundles).map(([pathPattern, code]) => `  [${JSON.str
 ]);
 
 /**
- * Match an fs path like /home/user/app/node_modules/react/index.js
+ * Match an fs path like /home/user/example-app/node_modules/react/index.js
  * against the pre-built bundle table. The keys in the table are
  * SUFFIXES — e.g. "/node_modules/react/index.js" — so a project
  * at any path resolves correctly.

package/dist/facets/resident-identity.d.ts

@@ -0,0 +1,23 @@
+/**
+ * facets/resident-identity.ts — the derived identity of an ordinary resident.
+ *
+ * A durable application used to be whatever an embedder reserved a port for.
+ * Under the universal model every resident has an identity from the moment
+ * it is spawned, derived from what the user typed: the working directory
+ * and the argv. Two spawns of `node server.js` from the same directory are
+ * the same application — before, after and across a supervisor reset — and
+ * that is what a lazily created reservation binds to.
+ *
+ * The environment is deliberately NOT an input: a rotated secret, a changed
+ * `PORT`, a different `TERM` must not turn one application into another.
+ *
+ * The derived form is namespaced (`auto:`) so it can never collide with an
+ * ordinary caller-chosen owner. Reservation policy is NOT inferred from
+ * this prefix: the reservation's persisted explicit/derived kind determines
+ * whether its first binder adopts an owner or must already match it.
+ */
+export declare const DERIVED_OWNER_PREFIX = "auto:";
+/** `auto:` + the first 24 hex of sha256(cwd ++ NUL ++ argv.join(NUL)). */
+export declare function deriveResidentOwner(cwd: string, argv: readonly string[]): Promise<string>;
+export declare function isDerivedOwner(owner: string): boolean;
+//# sourceMappingURL=resident-identity.d.ts.map

package/dist/facets/resident-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resident-identity.d.ts","sourceRoot":"","sources":["../../src/facets/resident-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,0EAA0E;AAC1E,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAM/F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/facets/resident-identity.js

@@ -0,0 +1,31 @@
+/**
+ * facets/resident-identity.ts — the derived identity of an ordinary resident.
+ *
+ * A durable application used to be whatever an embedder reserved a port for.
+ * Under the universal model every resident has an identity from the moment
+ * it is spawned, derived from what the user typed: the working directory
+ * and the argv. Two spawns of `node server.js` from the same directory are
+ * the same application — before, after and across a supervisor reset — and
+ * that is what a lazily created reservation binds to.
+ *
+ * The environment is deliberately NOT an input: a rotated secret, a changed
+ * `PORT`, a different `TERM` must not turn one application into another.
+ *
+ * The derived form is namespaced (`auto:`) so it can never collide with an
+ * ordinary caller-chosen owner. Reservation policy is NOT inferred from
+ * this prefix: the reservation's persisted explicit/derived kind determines
+ * whether its first binder adopts an owner or must already match it.
+ */
+export const DERIVED_OWNER_PREFIX = 'auto:';
+/** `auto:` + the first 24 hex of sha256(cwd ++ NUL ++ argv.join(NUL)). */
+export async function deriveResidentOwner(cwd, argv) {
+    const material = new TextEncoder().encode(`${cwd}\0${argv.join('\0')}`);
+    const digest = new Uint8Array(await crypto.subtle.digest('SHA-256', material));
+    let hex = '';
+    for (const byte of digest)
+        hex += byte.toString(16).padStart(2, '0');
+    return `${DERIVED_OWNER_PREFIX}${hex.slice(0, 24)}`;
+}
+export function isDerivedOwner(owner) {
+    return owner.startsWith(DERIVED_OWNER_PREFIX);
+}

package/dist/facets/vite-dev-server.d.ts

@@ -23,6 +23,7 @@
  */
 import type { SqliteVFS } from '@nimbus-sh/core/vfs/sqlite-vfs.js';
 import type { EsbuildService } from '@nimbus-sh/core/runtime/esbuild-service.js';
+import type { BundlePoolProvider } from './esbuild-bundle-pool.js';
 export interface ViteDevServerOptions {
     vfs: SqliteVFS;
     esbuild: EsbuildService;
@@ -47,17 +48,18 @@ export interface ViteDevServerOptions {
      * the `// nimbus-no-basename` comment for per-file opt-out.
      */
     injectBasename?: boolean;
-    /**
-     * Worker bindings env. Required for the on-demand-bundle facet path
-     * (LOADER + ctx.exports). When provided, /preview/@modules/<spec>
-     * misses bundle in a IsolatePool isolate instead of the
-     * supervisor's EsbuildService — same architecture as the
-     * pre-bundle path. Without this option, the supervisor falls back
-     * to in-process esbuild (legacy behaviour).
-     */
+    /** Worker bindings env (ASSETS for vendored bundles). */
     env?: any;
-    /** Durable Object state — needed alongside `env` for the facet pool. */
+    /** Durable Object state. */
     ctx?: DurableObjectState;
+    /**
+     * The session's esbuild facet pool, shared with the install-time
+     * pre-bundler. When provided, /preview/@modules/<spec> misses bundle in
+     * that pool's isolate instead of the supervisor's EsbuildService.
+     * Without it, the supervisor falls back to in-process esbuild (legacy
+     * behaviour used by callers without a LOADER binding).
+     */
+    bundlePool?: BundlePoolProvider;
     /**
      * process diagnostics support: when set, every diagnostic the dev server
      * would otherwise drop into Worker logs (console.warn / console.error)
@@ -78,9 +80,9 @@ export interface ViteDevServerOptions {
  * pre-bundles via the package they belong to).
  */
 interface HashImportCtx {
-    /** VFS path of the importing file (e.g. `home/user/app/src/foo.ts`). */
+    /** VFS path of the importing file (e.g. `home/user/example-app/src/foo.ts`). */
     importerVfsPath: string;
-    /** Project root (e.g. `home/user/app`). Used to clip the resolved
+    /** Project root (e.g. `home/user/example-app`). Used to clip the resolved
      *  target to a /preview-relative URL. */
     root: string;
     /** VFS readers — kept narrow so callers don't have to expose the
@@ -128,15 +130,10 @@ export declare class ViteDevServer {
     private npmCache;
     /** Inject React Router basename into entry files? Default: true. */
     private injectBasename;
-    /** Worker env (LOADER, ctx.exports) for the on-demand-bundle facet path.
-     *  Null = legacy in-supervisor esbuild fallback. */
     private env;
     private ctx;
-    /** Lazily-constructed pool for on-demand bundling. Mirrors the
-     *  pre-bundle pool's wasm-modules-map shape. Created on first
-     *  cold-path /preview/@modules/<spec> request. */
-    private onDemandPool;
-    private onDemandPoolPromise;
+    /** The session's esbuild facet pool; null = legacy in-supervisor esbuild. */
+    private readonly bundlePool;
     /**
      * In-flight on-demand-bundle coalescing map. When the browser fires
      * multiple parallel requests for the same /preview/@modules/<spec>
@@ -154,21 +151,6 @@ export declare class ViteDevServer {
      * crashes the supervisor for N≥3 on a busy isolate.
      */
     private pendingBundles;
-    /**
-     * Byte-budget admission gate for the on-demand bundle slow path.
-     * Replaces the former single-slot semaphore: instead of serializing
-     * every cold bundle (which made a fresh-React first load multi-second
-     * because each distinct /@modules/ spec waited for the previous), it
-     * bounds the TOTAL slice BYTES resident in the supervisor at once.
-     *
-     * Many small slices' facet RPC round-trips overlap; a single large
-     * (~28 MiB) slice still serializes the rest. Peak resident slice bytes
-     * never exceed ON_DEMAND_SLICE_CAP_BYTES — the same one-slice envelope
-     * the install-time pre-bundler proved safe on shared DO isolates — so
-     * this is a latency win with no supervisor-heap regression. Coupled
-     * with pendingBundles (same-spec coalescing) as before.
-     */
-    private onDemandGate;
     /**
      * process diagnostics support: the supervisor's per-PID log store. When set
      * (alongside `pid`), every diagnostic emitted by the dev server is
@@ -180,13 +162,11 @@ export declare class ViteDevServer {
     private logSink;
     constructor(opts: ViteDevServerOptions);
     /**
-     * Lazily construct the IsolatePool used for on-demand bundling
-     * of /preview/@modules/<spec> requests that miss both the in-memory
-     * and pkg_esm_bundles caches. Mirrors the pre-bundle pool's
-     * configuration: 1 worker, internal pLimit not needed (one bundle
-     * per request), wasm shipped via wasmModules.
-     *
-     * Returns null when env/ctx aren't available (legacy fallback used).
+     * The session's shared esbuild pool for on-demand bundling of
+     * /preview/@modules/<spec> requests that miss both the in-memory and
+     * pkg_esm_bundles caches. Null when no pool was provided (legacy
+     * in-supervisor fallback). Acquired BEFORE the slice lease — see
+     * EsbuildBundlePool.acquire.
      */
     private ensureOnDemandPool;
     /** Detect TailwindCSS usage in the project */
@@ -271,13 +251,11 @@ export declare class ViteDevServer {
      * Cold path of serveModule: package resolution → on-demand facet
      * bundle (synthetic-entry for barrels) → hard-error if bundle fails.
      * NO CDN fallback (100% edge contract). Extracted so the coalescing
-     * + gate wrapper in serveModule() reads cleanly. Always runs inside
-     * the on-demand byte-budget gate — see serveModule's wrapper.
-     *
-     * `admit` reserves the built slice's real byte size against the gate's
-     * budget and releases the build lock for the next spec. It is called
-     * exactly once, right after the slice is built and before the facet
-     * submit; bail-out paths that never build a slice simply never call it.
+     * wrapper in serveModule() reads cleanly. The slice this body builds is
+     * leased from the shared supervisor allocation budget for its worst
+     * case before it is built, shrunk to its real size once built, and
+     * released only after the facet result has been rewritten, cached and
+     * wrapped in the Response — the pre-bundler's per-slice pattern.
      */
     private serveModuleCold;
     /**

package/dist/facets/vite-dev-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite-dev-server.d.ts","sourceRoot":"","sources":["../../src/facets/vite-dev-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vite-dev-server.d.ts","sourceRoot":"","sources":["../../src/facets/vite-dev-server.ts"],"names":[],"mappings":"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"}