@nimbus-sh/worker 0.7.0 → 0.9.0

package/dist/facets/real-vite-hmr.d.ts

@@ -108,7 +108,9 @@ export declare function registerHmrBridge(doId: string, holder: {
  *   doId — the supervisor DO's id, used to find the right stub +
  *          HmrBridge.
  */
-export declare class CirrusHmrRPC extends WorkerEntrypoint {
+export declare class CirrusHmrRPC extends WorkerEntrypoint<object, {
+    doId?: string;
+}> {
     private _bridge;
     private _stub;
     hmrSend(clientId: string | null, msg: string): Promise<void>;

package/dist/facets/real-vite-hmr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"real-vite-hmr.d.ts","sourceRoot":"","sources":["../../src/facets/real-vite-hmr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AASH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AActD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAS;IACpB,2BAA2B;IAC3B,OAAO,CAAC,OAAO,CAAgC;IAC/C,kDAAkD;IAClD,OAAO,CAAC,OAAO,CAAiH;IAChI,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAA0C;IAC1D,oEAAoE;IAC7D,kBAAkB,UAAS;IAClC,OAAO,CAAC,OAAO,CAAK;IAEpB,wEAAwE;IACxE,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM;IAOnC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK9B,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAInD,6EAA6E;IAC7E,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAapD;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjE,OAAO,CAAC,IAAI;IAWZ;;;;OAIG;IACG,UAAU,CAAC,SAAS,GAAE,MAAe,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAkB5D,2BAA2B;IAC3B,IAAI,IAAI,IAAI,MAAM,CAA8B;IAEhD,uDAAuD;IACvD,QAAQ,IAAI,IAAI;CAYjB;AAUD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAEhF;AAKD;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,KAAK;IAOP,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5D,YAAY,CAAC,SAAS,GAAE,MAAe,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAO/D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CA2HjD;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CA0EvD"}
+{"version":3,"file":"real-vite-hmr.d.ts","sourceRoot":"","sources":["../../src/facets/real-vite-hmr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AASH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAetD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAS;IACpB,2BAA2B;IAC3B,OAAO,CAAC,OAAO,CAAgC;IAC/C,kDAAkD;IAClD,OAAO,CAAC,OAAO,CAAiH;IAChI,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAA0C;IAC1D,oEAAoE;IAC7D,kBAAkB,UAAS;IAClC,OAAO,CAAC,OAAO,CAAK;IAEpB,wEAAwE;IACxE,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM;IAOnC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK9B,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAInD,6EAA6E;IAC7E,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAapD;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjE,OAAO,CAAC,IAAI;IAWZ;;;;OAIG;IACG,UAAU,CAAC,SAAS,GAAE,MAAe,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAkB5D,2BAA2B;IAC3B,IAAI,IAAI,IAAI,MAAM,CAA8B;IAEhD,uDAAuD;IACvD,QAAQ,IAAI,IAAI;CAYjB;AAUD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAEhF;AAKD;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,SAAQ,gBAAgB,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;IAC3E,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,KAAK;IAcP,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5D,YAAY,CAAC,SAAS,GAAE,MAAe,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAO/D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CA2HjD;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CA0EvD"}

package/dist/facets/real-vite-hmr.js

@@ -42,6 +42,7 @@
 // All are emitted by the generators below.
 import { WorkerEntrypoint } from 'cloudflare:workers';
 import { disposeRpcResource, useRpcResource } from '@nimbus-sh/platform/rpc-dispose.js';
+import { hostOpDispatch, hostNamespaceBinding } from '@nimbus-sh/fabric/host-dispatch.js';
 // CLN-3 (2026-05-11): supervisor-side debug gate. Mirrors the facet-side
 // `globalThis.__cirrusDebug` flag declared at cirrus-real.ts:160. When
 // `false` (default), the hot-path console.log calls in `HmrBridge`
@@ -230,23 +231,32 @@ export class CirrusHmrRPC extends WorkerEntrypoint {
         const doId = this.ctx.props?.doId;
         if (!doId)
             return null;
-        const id = this.env.NIMBUS_SESSION.idFromString(doId);
-        return this.env.NIMBUS_SESSION.get(id);
+        let stub = null;
+        try {
+            const binding = hostNamespaceBinding(this.env, 'CirrusHmrRPC');
+            stub = binding.get(binding.idFromString(doId));
+            return { stub, dispatch: hostOpDispatch(stub, 'CirrusHmrRPC') };
+        }
+        catch (error) {
+            disposeRpcResource(stub);
+            throw error;
+        }
     }
     async hmrSend(clientId, msg) {
-        const stub = this._stub();
-        if (!stub)
+        const resolved = this._stub();
+        if (!resolved)
             return;
-        // Call the DO's own RPC method, which runs in the DO's context
-        // and can legally call ws.send() on hibernatable sockets.
+        // The host's supervisorOp routes hmrRelay to its own RPC — running in
+        // the DO's context, it can legally call ws.send() on hibernatable
+        // sockets.
         try {
-            await useRpcResource(stub._rpcHmrRelay(clientId, msg), () => undefined);
+            await useRpcResource(resolved.dispatch({ op: 'hmrRelay', args: [clientId, msg] }), () => undefined);
         }
         catch {
             /* socket gone */
         }
         finally {
-            disposeRpcResource(stub);
+            disposeRpcResource(resolved.stub);
         }
     }
     async hmrNextEvent(timeoutMs = 25_000) {

package/dist/facets/ws-terminal.d.ts

@@ -1,28 +1,7 @@
-/**
- * WebSocket-backed terminal matching Nimbus's ITerminal interface.
- * HeadlessTerminal has: write, writeln, onData, sendData, cols, rows, focus, clear
- *
- * [B'.5] The `ws` ref is no longer readonly: a wsClose leaves the
- * Shell + this terminal alive in-memory; the next /ws upgrade calls
- * `attach(newWs, ...)` to swap in the new socket. The buffer/flush
- * timer state is preserved across the swap so any in-flight
- * coalescing continues seamlessly.
- */
 export declare class WebSocketTerminal {
-    ws: WebSocket;
+    /** Null while the terminal is headless (composed before any attach). */
+    ws: WebSocket | null;
     private dataCallback;
-    /**
-     * REPL-W1: secondary input callback installed by interactive runtimes
-     * (e.g. `python` no-args). When non-null, sendData() routes input to
-     * this callback INSTEAD of the shell. Set via attachRepl(); cleared
-     * by the disposer the attach call returns. Supports nesting (the
-     * disposer restores the prior callback).
-     *
-     * §3 (Layer 2): the explicit handoff mirrors how `vim`/`less` swap
-     * the parent shell's terminal handler. Auto-detect was rejected as
-     * fragile. Additive only — when null, behavior is identical to pre-W1.
-     */
-    private replCallback;
     /**
      * editor/monaco (2026-05-13): Editor-pane file-system bridge.
      *
@@ -46,7 +25,7 @@ export declare class WebSocketTerminal {
      *  into nimbus_terminal_scrollback. Single-frame granularity (not
      *  per-write) keeps the row count bounded by the 5 ms flush cadence. */
     private onFlush;
-    constructor(ws: WebSocket, onFlush?: (data: string) => void);
+    constructor(ws?: WebSocket | null, onFlush?: (data: string) => void);
     /**
      * [B'.5] Swap the underlying WebSocket on a warm rejoin. The Shell
      * keeps `terminal` as a stable instance reference (it stored
@@ -56,6 +35,11 @@ export declare class WebSocketTerminal {
      * self.ctx, but TypeScript-wise it's a fresh function value).
      */
     attach(ws: WebSocket, onFlush?: (data: string) => void): void;
+    /** Release the socket without ending the terminal's lifetime. */
+    detach(): void;
+    private replBinding;
+    private replTeardown;
+    disposeRepl(): Promise<void>;
     close(): void;
     get cols(): number;
     get rows(): number;
@@ -94,13 +78,7 @@ export declare class WebSocketTerminal {
      */
     onFs(cb: (msg: any, reply: (frame: any) => void) => void): void;
     sendData(data: string): void;
-    /**
-     * REPL-W1: install a runtime-side input handler. Returns a disposer
-     * that restores the prior handler (supports nesting). Calling this
-     * does NOT change the shell's dataCallback — it just shadows it
-     * until the disposer runs.
-     */
-    attachRepl(cb: (data: string) => void): () => void;
+    attachRepl(input: (data: string) => void, dispose?: () => Promise<void>): () => void;
     focus(): void;
     clear(): void;
 }

package/dist/facets/ws-terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ws-terminal.d.ts","sourceRoot":"","sources":["../../src/facets/ws-terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IACrB,EAAE,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,YAAY,CAAyC;IAC7D;;;;;;;;;;OAUG;IACH,OAAO,CAAC,YAAY,CAAyC;IAC7D;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,UAAU,CAAkE;IACpF,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAA8C;IAChE;;;4EAGwE;IACxE,OAAO,CAAC,OAAO,CAAkC;gBAErC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IAK3D;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAK7D,KAAK,IAAI,IAAI;IAab,IAAI,IAAI,IAAI,MAAM,CAAuB;IACzC,IAAI,IAAI,IAAI,MAAM,CAAuB;IAEzC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAE3B;;;;;;;;;;OAUG;IACH,QAAQ,IAAI,IAAI;IAQhB,OAAO,CAAC,KAAK;IAeb,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAE9C,aAAa,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IA+C3J;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,KAAK,IAAI,GAAG,IAAI;IAI/D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO5B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAWlD,KAAK,IAAI,IAAI;IACb,KAAK,IAAI,IAAI;CACd"}
+{"version":3,"file":"ws-terminal.d.ts","sourceRoot":"","sources":["../../src/facets/ws-terminal.ts"],"names":[],"mappings":"AAQA,qBAAa,iBAAiB;IAC5B,wEAAwE;IACjE,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,YAAY,CAAyC;IAE7D;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,UAAU,CAAkE;IACpF,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAA8C;IAChE;;;4EAGwE;IACxE,OAAO,CAAC,OAAO,CAAkC;gBAErC,EAAE,GAAE,SAAS,GAAG,IAAW,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IAKzE;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAK7D,iEAAiE;IACjE,MAAM,IAAI,IAAI;IAGd,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAA8B;IAClD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B,KAAK,IAAI,IAAI;IAYb,IAAI,IAAI,IAAI,MAAM,CAAuB;IACzC,IAAI,IAAI,IAAI,MAAM,CAAuB;IAEzC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAE3B;;;;;;;;;;OAUG;IACH,QAAQ,IAAI,IAAI;IAQhB,OAAO,CAAC,KAAK;IAeb,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAE9C,aAAa,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IA+C3J;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,KAAK,IAAI,GAAG,IAAI;IAG/D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,UAAU,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI;IAepF,KAAK,IAAI,IAAI;IACb,KAAK,IAAI,IAAI;CACd"}

package/dist/facets/ws-terminal.js

@@ -1,28 +1,7 @@
-/**
- * WebSocket-backed terminal matching Nimbus's ITerminal interface.
- * HeadlessTerminal has: write, writeln, onData, sendData, cols, rows, focus, clear
- *
- * [B'.5] The `ws` ref is no longer readonly: a wsClose leaves the
- * Shell + this terminal alive in-memory; the next /ws upgrade calls
- * `attach(newWs, ...)` to swap in the new socket. The buffer/flush
- * timer state is preserved across the swap so any in-flight
- * coalescing continues seamlessly.
- */
 export class WebSocketTerminal {
+    /** Null while the terminal is headless (composed before any attach). */
     ws;
     dataCallback = null;
-    /**
-     * REPL-W1: secondary input callback installed by interactive runtimes
-     * (e.g. `python` no-args). When non-null, sendData() routes input to
-     * this callback INSTEAD of the shell. Set via attachRepl(); cleared
-     * by the disposer the attach call returns. Supports nesting (the
-     * disposer restores the prior callback).
-     *
-     * §3 (Layer 2): the explicit handoff mirrors how `vim`/`less` swap
-     * the parent shell's terminal handler. Auto-detect was rejected as
-     * fragile. Additive only — when null, behavior is identical to pre-W1.
-     */
-    replCallback = null;
     /**
      * editor/monaco (2026-05-13): Editor-pane file-system bridge.
      *
@@ -46,7 +25,7 @@ export class WebSocketTerminal {
      *  into nimbus_terminal_scrollback. Single-frame granularity (not
      *  per-write) keeps the row count bounded by the 5 ms flush cadence. */
     onFlush;
-    constructor(ws, onFlush) {
+    constructor(ws = null, onFlush) {
         this.ws = ws;
         this.onFlush = onFlush ?? null;
     }
@@ -63,20 +42,51 @@ export class WebSocketTerminal {
         if (onFlush !== undefined)
             this.onFlush = onFlush;
     }
+    /** Release the socket without ending the terminal's lifetime. */
+    detach() {
+        this.ws = null;
+    }
+    replBinding = null;
+    replTeardown = null;
+    disposeRepl() {
+        if (this.replTeardown)
+            return this.replTeardown;
+        const first = this.replBinding;
+        if (!first)
+            return Promise.resolve();
+        this.replBinding = null;
+        this.replTeardown = Promise.resolve().then(async () => {
+            const errors = [];
+            let binding = first;
+            while (binding) {
+                const next = binding.previous;
+                try {
+                    await binding.dispose?.();
+                }
+                catch (error) {
+                    errors.push(error instanceof Error ? error : new Error(String(error)));
+                }
+                binding = next;
+            }
+            if (errors.length > 0)
+                throw new AggregateError(errors, 'REPL cleanup failed');
+        }).finally(() => { this.replTeardown = null; });
+        return this.replTeardown;
+    }
     close() {
-        if (this.flushTimer) {
+        void this.disposeRepl().catch((error) => console.warn('[terminal] REPL cleanup failed', error));
+        if (this.flushTimer)
             clearTimeout(this.flushTimer);
-            this.flushTimer = null;
-        }
+        this.flushTimer = null;
         this.buffer = [];
         this.onFlush = null;
         this.dataCallback = null;
-        this.replCallback = null;
         this.fsCallback = null;
         try {
-            this.ws.close(1000, 'terminal closed');
+            this.ws?.close(1000, 'terminal closed');
         }
         catch { }
+        this.ws = null;
     }
     get cols() { return this._cols; }
     get rows() { return this._rows; }
@@ -112,7 +122,7 @@ export class WebSocketTerminal {
         const combined = this.buffer.join('');
         this.buffer = [];
         try {
-            this.ws.send(JSON.stringify({ type: 'output', data: combined }));
+            this.ws?.send(JSON.stringify({ type: 'output', data: combined }));
         }
         catch { }
         // [B'.3] Tee to scrollback. Runs AFTER the WS send so a thrown
@@ -161,7 +171,7 @@ export class WebSocketTerminal {
                             const merged = (reqId !== undefined && frame && typeof frame === 'object')
                                 ? { ...frame, reqId }
                                 : frame;
-                            this.ws.send(JSON.stringify(merged));
+                            this.ws?.send(JSON.stringify(merged));
                         }
                         catch { }
                     };
@@ -191,29 +201,26 @@ export class WebSocketTerminal {
         this.fsCallback = cb;
     }
     sendData(data) {
-        // REPL-W1: replCallback takes priority when set. Restored by the
-        // disposer attachRepl() returns.
-        if (this.replCallback) {
-            this.replCallback(data);
-            return;
-        }
-        if (this.dataCallback)
-            this.dataCallback(data);
+        if (this.replBinding)
+            this.replBinding.input(data);
+        else
+            this.dataCallback?.(data);
     }
-    /**
-     * REPL-W1: install a runtime-side input handler. Returns a disposer
-     * that restores the prior handler (supports nesting). Calling this
-     * does NOT change the shell's dataCallback — it just shadows it
-     * until the disposer runs.
-     */
-    attachRepl(cb) {
-        const prior = this.replCallback;
-        this.replCallback = cb;
+    attachRepl(input, dispose) {
+        if (this.replTeardown)
+            throw new Error('Cannot attach a REPL while cleanup is running');
+        const binding = { input, dispose, previous: this.replBinding };
+        this.replBinding = binding;
         return () => {
-            // Idempotent: only restore if we're still the current shadow.
-            // If a nested attachRepl ran in between, the disposer chain
-            // resolves bottom-up correctly.
-            this.replCallback = prior;
+            if (this.replBinding === binding) {
+                this.replBinding = binding.previous;
+                return;
+            }
+            let current = this.replBinding;
+            while (current && current.previous !== binding)
+                current = current.previous;
+            if (current)
+                current.previous = binding.previous;
         };
     }
     focus() { }

package/dist/hosted/commands.d.ts

@@ -0,0 +1,12 @@
+import { NimbusWorkspace } from '@nimbus-sh/core/workspace';
+import type { SessionInternal } from '../session/internal.js';
+import type { RuntimeCatalogEnv } from '../runtime/runtime-catalog.js';
+/** Internal runtime services; callers use composeHostedRuntime, not this recipe. */
+export type RuntimeCommandHost = Pick<SessionInternal, '_emitShellExecDone' | '_setCpRegistry' | '_viteShimPid' | '_viteShimPort' | 'cirrusReal' | 'ensureFacetManager' | 'ensureNpmInstaller' | 'ensureSqliteFs' | 'esbuildService' | 'nimbusWrangler' | 'npmInstaller' | 'portRegistry' | 'processes' | 'sessionBasePath' | 'terminal' | 'viteBasePath' | 'viteDevServer' | 'wranglerAliasBannerShown'> & {
+    readonly ctx: DurableObjectState;
+    readonly env: RuntimeCatalogEnv;
+    routeLoopback: SessionInternal['routeLoopback'];
+    ensureGlobalPrefixDirs: SessionInternal['ensureGlobalPrefixDirs'];
+};
+export declare function registerHostedCommands(self: RuntimeCommandHost, workspace: NimbusWorkspace): Promise<void>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/hosted/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/hosted/commands.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAuB5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGvE,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,eAAe,EACnD,oBAAoB,GAAG,gBAAgB,GAAG,cAAc,GAAG,eAAe,GAAG,YAAY,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,cAAc,GAAG,cAAc,GAAG,WAAW,GAAG,iBAAiB,GAAG,UAAU,GAAG,cAAc,GAAG,eAAe,GAAG,0BAA0B,CAClV,GAAG;IACF,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,aAAa,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;IAChD,sBAAsB,EAAE,eAAe,CAAC,wBAAwB,CAAC,CAAC;CACnE,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6qDhH"}