@nimbus-sh/worker 0.12.0 → 0.13.0

package/dist/facets/oxc-transform.d.ts

@@ -0,0 +1,29 @@
+import { type EsbuildTransformHost } from '@nimbus-sh/core/runtime/esbuild-service.js';
+import type { WorkerCode } from '@nimbus-sh/fabric/vendor/types.js';
+export declare const OXC_FACET_WORKER_ID: string;
+/**
+ * Slim Worker Loader module whose DO class owns the Oxc wasm. `wasm` is the
+ * staged module's verified bytes, compiled by the loader at startup; `runtime`
+ * is the facet's staged runtime script.
+ */
+export declare function oxcFacetWorkerCode(wasm: ArrayBuffer, runtime: string): WorkerCode;
+/**
+ * The transform host a Durable Object's transforms run on: its transform
+ * facet, a slice per call. Transforms are pure, so a slice whose call failed
+ * (the facet reset, the connection dropped) is sent once more, to a freshly
+ * minted stub; an overloaded facet is not asked again. A slice that still
+ * fails answers each of its requests with a transient error, which is no
+ * verdict on the source, and the other slices keep their answers.
+ *
+ * A module whose outcome says Oxc ran out of native stack on it
+ * (`stackExhausted`, set by the driver from the RangeError, never read off
+ * message text) goes to `stackFallback`, the esbuild facet in production:
+ * every such module, in calls of at most STACK_FALLBACK_MODULES, each with a
+ * deadline, each module logged. Its answer stands; the modules of a call that
+ * fails or misses its deadline answer transient. Without a fallback the
+ * exhaustion stands.
+ */
+export declare function oxcTransformHost(ctx: DurableObjectState, env: unknown, stackFallback?: EsbuildTransformHost, { fallbackDeadlineMs }?: {
+    fallbackDeadlineMs?: number;
+}): EsbuildTransformHost;
+//# sourceMappingURL=oxc-transform.d.ts.map

package/dist/facets/oxc-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oxc-transform.d.ts","sourceRoot":"","sources":["../../src/facets/oxc-transform.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,oBAAoB,EAG1B,MAAM,4CAA4C,CAAC;AAMpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AA4CpE,eAAO,MAAM,mBAAmB,QAAwF,CAAC;AAMzH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAiBjF;AA+DD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,kBAAkB,EACvB,GAAG,EAAE,OAAO,EACZ,aAAa,CAAC,EAAE,oBAAoB,EACpC,EAAE,kBAA+C,EAAE,GAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAO,GACxF,oBAAoB,CAkDtB"}

package/dist/facets/oxc-transform.js

@@ -0,0 +1,198 @@
+import { CF_COMPAT_DATE, GUEST_COMPAT_FLAGS } from '@nimbus-sh/core/constants.js';
+import { generateTransformFacetRuntimeSource, transformSlices, } from '@nimbus-sh/core/runtime/esbuild-service.js';
+import { errorText } from '@nimbus-sh/core/_shared/error-text.js';
+import { beginLoaderFetch } from '@nimbus-sh/fabric/budgets.js';
+import { hashSource } from '@nimbus-sh/fabric/vendor/serialize.js';
+import { classifyDoCall } from '@nimbus-sh/platform/oom-classify.js';
+import { OXC_WASM_BUILD_ID } from '../oxc-wasm-artifact.generated.js';
+import { OXC_FACET_BUILD_ID } from '../oxc-facet-artifact.generated.js';
+import { fetchOxcFacetRuntime, fetchOxcWasmBytes } from '../runtime/oxc-wasm-bytes.js';
+/**
+ * The Oxc wasm's linear memory past which the facet drops its instance after
+ * a call. The module starts at 4.25 MiB and a call grows it to the module's
+ * working set, about 17 times a minified source (62 MiB for pi's 3.6 MiB
+ * chunk; a 256 KiB transform slice stays near 10 MiB). Memory never shrinks,
+ * so an instance a large module grew is released, and the next call starts
+ * a fresh one in about a millisecond.
+ */
+const TRANSFORM_OXC_HIGH_WATER_BYTES = 32 * 1024 * 1024;
+/**
+ * Everything of the facet's module but its staged parts. `oxcWasm` is the
+ * module map's compiled wasm, and the staged runtime (core
+ * runtime/oxc-facet/preamble.ts) installs the wasm's driver, the
+ * dynamic-import rewrite and the top-level-await lowering as globals.
+ * Requests run one at a time on one instance, each answered or refused on
+ * its own: a module Oxc rejects (or that crashes the instance, which is then
+ * replaced) is a verdict on that module, never on its slice.
+ */
+const OXC_FACET_BODY = [
+    generateTransformFacetRuntimeSource(),
+    `const oxc = globalThis.__nimbusCreateOxcTransform(oxcWasm, { retireAboveBytes: ${TRANSFORM_OXC_HIGH_WATER_BYTES} });`,
+    'export class OxcFacet extends DurableObject {',
+    '  async transformMany(requests) {',
+    '    const outcomes = [];',
+    '    for (const { code, options } of requests) {',
+    '      try {',
+    '        outcomes.push(await runTransformRequest(oxc, code, options, globalThis.__nimbusRewriteDynamicImports, globalThis.__nimbusLowerAsyncModule));',
+    '      } catch (e) {',
+    '        const error = String((e && e.message) || e);',
+    '        outcomes.push(e && e.stackExhausted === true ? { error, stackExhausted: true } : { error });',
+    '      }',
+    '    }',
+    '    return outcomes;',
+    '  }',
+    '}',
+].join('\n');
+// The loader serves the code it cached under an id, so the id carries the code.
+export const OXC_FACET_WORKER_ID = `nimbus-oxc:${OXC_WASM_BUILD_ID}:${OXC_FACET_BUILD_ID}:${hashSource(OXC_FACET_BODY)}`;
+/**
+ * Slim Worker Loader module whose DO class owns the Oxc wasm. `wasm` is the
+ * staged module's verified bytes, compiled by the loader at startup; `runtime`
+ * is the facet's staged runtime script.
+ */
+export function oxcFacetWorkerCode(wasm, runtime) {
+    const source = [
+        'import { DurableObject } from "cloudflare:workers";',
+        'import oxcWasm from "oxc.wasm";',
+        runtime,
+        OXC_FACET_BODY,
+    ].join('\n');
+    return {
+        compatibilityDate: CF_COMPAT_DATE,
+        compatibilityFlags: [...GUEST_COMPAT_FLAGS],
+        mainModule: 'worker.js',
+        modules: {
+            'worker.js': source,
+            'oxc.wasm': { wasm },
+        },
+        globalOutbound: null,
+    };
+}
+/**
+ * A Durable Object's transform facet: one loader-backed child that owns the
+ * Oxc wasm, so the object's own isolate never instantiates it. Needs
+ * `env.LOADER`, `env.ASSETS` and `ctx.facets`, and nothing of any host.
+ */
+async function oxcFacet(ctx, env) {
+    const loader = Reflect.get(Object(env), 'LOADER');
+    if (!loader || typeof loader.get !== 'function')
+        throw new Error('Nimbus: env.LOADER unavailable for the transform facet');
+    const assets = Reflect.get(Object(env), 'ASSETS');
+    if (!assets || typeof assets.fetch !== 'function')
+        throw new Error('Nimbus: env.ASSETS unavailable for the transform facet');
+    const worker = await loader.get(OXC_FACET_WORKER_ID, async () => {
+        const assetsEnv = { ASSETS: assets };
+        const [wasm, runtime] = await Promise.all([fetchOxcWasmBytes(assetsEnv), fetchOxcFacetRuntime(assetsEnv)]);
+        return oxcFacetWorkerCode(wasm, runtime);
+    });
+    const facetClass = worker.getDurableObjectClass('OxcFacet');
+    return ctx.facets.get(OXC_FACET_WORKER_ID, async () => ({ class: facetClass }));
+}
+/**
+ * One stub per Durable Object: a caller that starts while another is still
+ * loading the facet waits on that load. A load or call that failed drops the
+ * entry; the next caller mints a fresh stub.
+ */
+const sharedFacets = new WeakMap();
+function sharedOxcFacet(ctx, env) {
+    const current = sharedFacets.get(ctx);
+    if (current)
+        return current;
+    const minted = oxcFacet(ctx, env);
+    sharedFacets.set(ctx, minted);
+    minted.catch(() => forgetOxcFacet(ctx, minted));
+    return minted;
+}
+function forgetOxcFacet(ctx, stub) {
+    if (sharedFacets.get(ctx) === stub)
+        sharedFacets.delete(ctx);
+}
+/** Modules one stack-fallback call carries; a batch with more makes more calls. */
+const STACK_FALLBACK_MODULES = 4;
+/** How long one stack-fallback call may take before its modules' answers are transient. */
+const STACK_FALLBACK_DEADLINE_MS = 30_000;
+/** `call`, or a rejection once `ms` pass first. */
+async function withDeadline(call, ms) {
+    let timer = null;
+    const deadline = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`no answer within ${ms} ms`)), ms);
+    });
+    try {
+        return await Promise.race([call, deadline]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Calls per slice: a slice whose call failed is sent once more. */
+const SLICE_ATTEMPTS = 2;
+/**
+ * The transform host a Durable Object's transforms run on: its transform
+ * facet, a slice per call. Transforms are pure, so a slice whose call failed
+ * (the facet reset, the connection dropped) is sent once more, to a freshly
+ * minted stub; an overloaded facet is not asked again. A slice that still
+ * fails answers each of its requests with a transient error, which is no
+ * verdict on the source, and the other slices keep their answers.
+ *
+ * A module whose outcome says Oxc ran out of native stack on it
+ * (`stackExhausted`, set by the driver from the RangeError, never read off
+ * message text) goes to `stackFallback`, the esbuild facet in production:
+ * every such module, in calls of at most STACK_FALLBACK_MODULES, each with a
+ * deadline, each module logged. Its answer stands; the modules of a call that
+ * fails or misses its deadline answer transient. Without a fallback the
+ * exhaustion stands.
+ */
+export function oxcTransformHost(ctx, env, stackFallback, { fallbackDeadlineMs = STACK_FALLBACK_DEADLINE_MS } = {}) {
+    return async (requests) => {
+        let facet = null;
+        const outcomes = [];
+        // The facet's worker is in flight for the whole batch, bracketed rather
+        // than wrapped (see beginLoaderFetch).
+        const endFetch = beginLoaderFetch(ctx, OXC_FACET_WORKER_ID);
+        try {
+            for (const slice of transformSlices(requests, (request) => request.code.length)) {
+                let answered = null;
+                let failure = null;
+                for (let attempt = 1; answered === null && attempt <= SLICE_ATTEMPTS; attempt++) {
+                    try {
+                        facet ??= sharedOxcFacet(ctx, env);
+                        answered = await (await facet).transformMany(slice);
+                    }
+                    catch (error) {
+                        // A stub that threw may be broken for good; the next call mints its own.
+                        if (facet)
+                            forgetOxcFacet(ctx, facet);
+                        facet = null;
+                        failure = error;
+                        if (classifyDoCall(error) === 'overloaded')
+                            break;
+                    }
+                }
+                if (answered === null) {
+                    const error = `transform facet unavailable: ${errorText(failure)}`;
+                    answered = slice.map(() => ({ error, transient: true }));
+                }
+                for (const outcome of answered)
+                    outcomes.push(outcome);
+            }
+        }
+        finally {
+            endFetch();
+        }
+        if (stackFallback) {
+            // Every module answered here: some callers (a prefetch bundle) have no
+            // store or pacer that would send a deferred one again.
+            const exhausted = outcomes.flatMap((outcome, index) => ('stackExhausted' in outcome && outcome.stackExhausted === true ? [index] : []));
+            for (let at = 0; at < exhausted.length; at += STACK_FALLBACK_MODULES) {
+                const group = exhausted.slice(at, at + STACK_FALLBACK_MODULES);
+                for (const index of group) {
+                    const reason = 'error' in outcomes[index] ? outcomes[index].error.split('\n').at(-1) : '';
+                    console.warn(`[oxc-transform] ${requests[index].options?.dynamicImportParent ?? '<unnamed module>'}: ${reason}; transforming it with esbuild`);
+                }
+                const answered = await withDeadline(stackFallback(group.map((index) => requests[index])), fallbackDeadlineMs).catch((error) => group.map(() => ({ error: `esbuild facet unavailable: ${errorText(error)}`, transient: true })));
+                group.forEach((index, i) => { outcomes[index] = answered[i]; });
+            }
+        }
+        return outcomes;
+    };
+}

package/dist/facets/prebundle-pool.d.ts

@@ -0,0 +1,23 @@
+import type { PrebundleResult, PrebundleSpec } from '../npm/pre-bundle-facet.js';
+/** What both pre-bundling pipelines call. */
+export interface BundlePool {
+    prebundle(spec: PrebundleSpec): Promise<PrebundleResult>;
+}
+/** What a pre-bundling pipeline receives from its host. */
+export interface BundlePoolProvider {
+    /** The session's pool, its facet loaded. */
+    acquire(): Promise<BundlePool>;
+}
+export declare class PrebundlePool implements BundlePoolProvider {
+    private readonly env;
+    private readonly ctx;
+    private readonly pool;
+    /** Pre-bundles waiting for a slot, oldest first; a finishing one hands its slot to the next. */
+    private readonly waiting;
+    private running;
+    constructor(env: unknown, ctx: DurableObjectState);
+    acquire(): Promise<BundlePool>;
+    /** The build facet is the Durable Object's, not the pool's: nothing to release. */
+    dispose(): void;
+}
+//# sourceMappingURL=prebundle-pool.d.ts.map

package/dist/facets/prebundle-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prebundle-pool.d.ts","sourceRoot":"","sources":["../../src/facets/prebundle-pool.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGjF,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC1D;AAED,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CAChC;AAED,qBAAa,aAAc,YAAW,kBAAkB;IAOpD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,gGAAgG;IAChG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,OAAO,CAAK;gBAGD,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,kBAAkB;IAkBpC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAKpC,mFAAmF;IACnF,OAAO,IAAI,IAAI;CAChB"}

package/dist/facets/prebundle-pool.js

@@ -0,0 +1,55 @@
+/**
+ * PrebundlePool — where a session's pre-bundles run.
+ *
+ * Install-time pre-bundling (npm/installer.ts) and the Vite dev server's
+ * on-demand /@modules/ bundles send each npm specifier, with the slice of
+ * package files it needs (npm/pre-bundle-facet.ts), to the session's build
+ * facet (facets/build-facet.ts `prebundle`): rolldown over the staged
+ * binding, whose runtime the facet's module map loads, so no pre-bundle
+ * dispatches any source. One at a time (PRE_BUNDLE_CONCURRENCY), as the
+ * isolate pool that ran esbuild did: each holds up to a slice cap of files,
+ * and the facet's binding never gives back what a bundle grew it to.
+ *
+ * `acquire()` loads the facet before resolving, so its staged parts are
+ * fetched, verified and handed to the loader before a caller builds and
+ * holds a slice.
+ */
+import { PRE_BUNDLE_CONCURRENCY } from '@nimbus-sh/platform/limits.js';
+import { buildFacetPrebundler, loadBuildFacet } from './build-facet.js';
+export class PrebundlePool {
+    env;
+    ctx;
+    pool;
+    /** Pre-bundles waiting for a slot, oldest first; a finishing one hands its slot to the next. */
+    waiting = [];
+    running = 0;
+    constructor(env, ctx) {
+        this.env = env;
+        this.ctx = ctx;
+        const prebundle = buildFacetPrebundler(ctx, env);
+        this.pool = {
+            prebundle: async (spec) => {
+                if (this.running < PRE_BUNDLE_CONCURRENCY)
+                    this.running++;
+                else
+                    await new Promise((resolve) => this.waiting.push(resolve));
+                try {
+                    return await prebundle(spec);
+                }
+                finally {
+                    const next = this.waiting.shift();
+                    if (next)
+                        next();
+                    else
+                        this.running--;
+                }
+            },
+        };
+    }
+    async acquire() {
+        await loadBuildFacet(this.ctx, this.env);
+        return this.pool;
+    }
+    /** The build facet is the Durable Object's, not the pool's: nothing to release. */
+    dispose() { }
+}

package/dist/facets/process.d.ts

@@ -71,10 +71,8 @@ interface ChildEntry {
     stdinChunks: Uint8Array[];
     stdinClosed: boolean;
     stdinTotalBytes: number;
-    stdinWaiters: Array<(r: {
-        data: Uint8Array;
-        ended: boolean;
-    }) => void>;
+    /** Woken when stdin gains a chunk, closes, or the child exits; each takes from `stdinChunks` itself. */
+    stdinWaiters: Array<() => void>;
     outputs: {
         1: OutputChunk[];
         2: OutputChunk[];
@@ -160,13 +158,20 @@ export interface FacetManagerLike {
     }, hooks: OutputHooks): Promise<number>;
     abort?(facetName: string, signal?: string): boolean;
 }
+/** Where a child runs from: its pid (whose credential it has), directory and environment. */
+export interface ChildOrigin {
+    readonly pid: number;
+    readonly cwd: string;
+    readonly env: Record<string, string>;
+}
 /**
  * The minimum shape we need from the command registry.
  */
 export interface CommandRegistryLike {
-    resolve(name: string): {
+    /** How `name` runs as the child `from` describes; null while nothing can run it. */
+    resolve(name: string, from: ChildOrigin): Promise<{
         kind: CommandKind;
-    } | null;
+    } | null>;
     runPureBuiltin(pid: number, name: string, args: string[], env: Record<string, string>, cwd: string, stdin: string, hooks: OutputHooks): Promise<number>;
 }
 export interface ShellExecutorLike {
@@ -251,6 +256,8 @@ export declare class FacetProcessManager {
         ok: boolean;
     };
     stdinEnd(childPid: number): void;
+    /** The child's next stdin packet: a queued chunk, else the end once stdin closed or the child exited; null while neither. */
+    private _takeStdin;
     /**
      * Long-poll: child facet asks the supervisor for its next stdin chunk.
      * Returns immediately if data is already queued OR if stdin is closed.

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

@@ -197,17 +197,20 @@ export class FacetProcessManager {
         const dispatchReq = shellPlan
             ? req
             : { ...req, command: normalizedCommand };
-        // Resolve command kind. Resolution failure → exit 127 (command not
-        // found), no facet at all. Same shell semantics.
-        const reg = shellPlan ? { kind: 'shell-direct' } : this.deps.commandRegistry.resolve(normalizedCommand);
-        const kind = reg ? reg.kind : 'unknown';
-        // Dispatch after the cpSpawn RPC has had a chance to return to the
-        // parent facet. That lets immediate child.stdin.write(); child.stdin.end()
-        // calls land in the stdin queue before a preseeded child runtime starts.
+        // Classify and dispatch after the cpSpawn RPC has had a chance to return
+        // to the parent facet. That lets immediate child.stdin.write();
+        // child.stdin.end() calls land in the stdin queue before a preseeded
+        // child runtime starts. Nothing found to run is exit 127 (command not
+        // found), no facet at all, as in the shell.
         setTimeout(() => {
-            void this._dispatch(child, kind, dispatchReq).catch((e) => {
-                // Last-resort: if both runners somehow throw, exit 1 with the error
-                // on stderr.
+            void (async () => {
+                const reg = shellPlan
+                    ? { kind: 'shell-direct' }
+                    : await this.deps.commandRegistry.resolve(normalizedCommand, { pid, cwd: req.cwd, env: childEnv });
+                await this._dispatch(child, reg ? reg.kind : 'unknown', dispatchReq);
+            })().catch((e) => {
+                // Last resort: a classification or both runners threw (a registered
+                // command's module that fails to load). Exit 1 with the error on stderr.
                 this._appendText(child, 2, `Error: ${e?.message || String(e)}\n`);
                 this._stampExit(child, 1, null);
             });
@@ -519,10 +522,8 @@ export class FacetProcessManager {
         }
         child.stdinChunks.push(data);
         child.stdinTotalBytes += data.byteLength;
-        // Flush any waiters
-        for (const w of child.stdinWaiters.splice(0)) {
-            w({ data, ended: false });
-        }
+        for (const w of child.stdinWaiters.splice(0))
+            w();
         return { ok: true };
     }
     stdinEnd(childPid) {
@@ -530,9 +531,19 @@ export class FacetProcessManager {
         if (!child)
             return;
         child.stdinClosed = true;
-        for (const w of child.stdinWaiters.splice(0)) {
-            w({ data: EMPTY_BYTES, ended: true });
+        for (const w of child.stdinWaiters.splice(0))
+            w();
+    }
+    /** The child's next stdin packet: a queued chunk, else the end once stdin closed or the child exited; null while neither. */
+    _takeStdin(child) {
+        const data = child.stdinChunks.shift();
+        if (data !== undefined) {
+            child.stdinTotalBytes -= data.byteLength;
+            return { data, ended: false };
         }
+        if (child.stdinClosed || child.exitCode !== null)
+            return { data: EMPTY_BYTES, ended: true };
+        return null;
     }
     /**
      * Long-poll: child facet asks the supervisor for its next stdin chunk.
@@ -542,14 +553,11 @@ export class FacetProcessManager {
         const child = this.children.get(childPid);
         if (!child)
             return { data: EMPTY_BYTES, ended: true };
-        if (child.stdinChunks.length > 0) {
-            const data = child.stdinChunks.shift();
-            child.stdinTotalBytes -= data.byteLength;
-            return { data, ended: false };
-        }
-        if (child.stdinClosed)
-            return { data: EMPTY_BYTES, ended: true };
-        // Long-poll
+        const ready = this._takeStdin(child);
+        if (ready)
+            return ready;
+        // Long-poll. The chunk that wakes this reader stays queued until taken
+        // here, so no other reader is handed it too.
         return new Promise((resolve) => {
             const timer = setTimeout(() => {
                 const idx = child.stdinWaiters.indexOf(wrapped);
@@ -557,9 +565,9 @@ export class FacetProcessManager {
                     child.stdinWaiters.splice(idx, 1);
                 resolve({ data: EMPTY_BYTES, ended: false });
             }, Math.min(waitMs, 5000));
-            const wrapped = (r) => {
+            const wrapped = () => {
                 clearTimeout(timer);
-                resolve(r);
+                resolve(this._takeStdin(child) ?? { data: EMPTY_BYTES, ended: false });
             };
             child.stdinWaiters.push(wrapped);
         });
@@ -746,11 +754,9 @@ export class FacetProcessManager {
             const fresh = child.outputs[w.fd].filter((c) => c.seq > w.sinceSeq);
             w.resolve({ chunks: fresh, closed: true, maxSeq: child.outputSeq[w.fd] });
         }
-        // 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: EMPTY_BYTES, ended: true });
-        }
+        // A child blocked on cpReadStdin is told stdin ended, and exits cleanly.
+        for (const w of child.stdinWaiters.splice(0))
+            w();
     }
     /**
      * Late-arriving reportExit from the facet. Idempotent; if kill() or

package/dist/facets/transform-store.d.ts

@@ -14,8 +14,8 @@
  * a function of: the pipeline's code (TRANSFORM_PIPELINE_ID, which core's
  * build pins from the bundled closure of bundle-cell-transform.ts and
  * EsbuildService and ships with that code), the transform host's code (the
- * store is bound to one host — for the session, its esbuild facet, whose id
- * carries the esbuild version, the facet body and the staged CLI runner),
+ * store is bound to one host — for the session, its transform facet and the
+ * esbuild facet that answers what is too deep for it: TRANSFORM_HOST_ID),
  * what is transformed (a module cell or an entry script), where it is staged
  * (its path or URL: the loader, format, TypeScript-ness and import.meta all
  * follow from it), and the source. The old in-heap key was a 32-bit hash of
@@ -98,8 +98,8 @@ export declare class TransformStore implements BundleCellResultStore {
     private opened;
     /**
      * @param host The identity of the transform host whose results this store
-     *   holds: EsbuildService.transformHostId, for the session its esbuild
-     *   facet's ESBUILD_FACET_WORKER_ID.
+     *   holds: EsbuildService.transformHostId, for the session
+     *   esbuild-transform.ts's TRANSFORM_HOST_ID (both engines' code).
      * @param ledger The session's storage ledger, which admits every write.
      */
     constructor(sql: SqlDatabase, transactions: SqlTransactions, ledger: TransformStoreLedger, host: string, options?: TransformStoreOptions);

package/dist/facets/transform-store.js

@@ -14,8 +14,8 @@
  * a function of: the pipeline's code (TRANSFORM_PIPELINE_ID, which core's
  * build pins from the bundled closure of bundle-cell-transform.ts and
  * EsbuildService and ships with that code), the transform host's code (the
- * store is bound to one host — for the session, its esbuild facet, whose id
- * carries the esbuild version, the facet body and the staged CLI runner),
+ * store is bound to one host — for the session, its transform facet and the
+ * esbuild facet that answers what is too deep for it: TRANSFORM_HOST_ID),
  * what is transformed (a module cell or an entry script), where it is staged
  * (its path or URL: the loader, format, TypeScript-ness and import.meta all
  * follow from it), and the source. The old in-heap key was a 32-bit hash of
@@ -157,8 +157,8 @@ export class TransformStore {
     opened = false;
     /**
      * @param host The identity of the transform host whose results this store
-     *   holds: EsbuildService.transformHostId, for the session its esbuild
-     *   facet's ESBUILD_FACET_WORKER_ID.
+     *   holds: EsbuildService.transformHostId, for the session
+     *   esbuild-transform.ts's TRANSFORM_HOST_ID (both engines' code).
      * @param ledger The session's storage ledger, which admits every write.
      */
     constructor(sql, transactions, ledger, host, options = {}) {