@nimbus-sh/worker 0.7.0 → 0.9.0

package/dist/runtime/process-logs-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-logs-api.d.ts","sourceRoot":"","sources":["../../src/runtime/process-logs-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AAEtG;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,wBAAwB,CAAC;IACpC;;;;OAIG;IACH,GAAG,EAAE;QACH,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;KACvD,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,SAAS,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,GAAG,IAAI,EAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAON;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,iBAAiB,GACtB,QAAQ,CA8EV;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,wBAAwB,EACnC,GAAG,EAAE;IAAE,aAAa,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAA;CAAE,GACjD,IAAI,CA8CN;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,wBAAwB,GAClC,QAAQ,CAsCV;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK7D"}
+{"version":3,"file":"process-logs-api.d.ts","sourceRoot":"","sources":["../../src/runtime/process-logs-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AAEtG;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,wBAAwB,CAAC;IACpC;;;;OAIG;IACH,GAAG,EAAE;QACH,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;KACvD,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,GAAG,IAAI,EAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAON;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,iBAAiB,GACtB,QAAQ,CA8EV;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,wBAAwB,EACnC,GAAG,EAAE;IAAE,aAAa,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAA;CAAE,GACjD,IAAI,CA8CN;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,wBAAwB,GAClC,QAAQ,CAsCV;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK7D"}

package/dist/runtime/process-logs-api.js

@@ -30,7 +30,7 @@ export function notifyTerminalEvent(terminal, event) {
     if (!terminal)
         return;
     try {
-        terminal.ws.send(JSON.stringify(event));
+        terminal.ws?.send(JSON.stringify(event));
     }
     catch {
         /* socket closed or congested — dropping is the right behavior here */

package/dist/runtime/python-repl.d.ts

@@ -1,3 +1,4 @@
+import type { Shell } from '@nimbus-sh/core/substrate/lifo/shell/Shell.js';
 /**
  * python-repl.ts — the interactive `python` prompt.
  *
@@ -19,13 +20,14 @@
  * so `1 + 1` prints `2` and `x = 1` prints nothing, with no wrapper of ours
  * deciding what counts as a result.
  */
-import type { SqliteVFS } from '@nimbus-sh/core/vfs/sqlite-vfs.js';
 import type { FacetManager } from '../facets/manager.js';
 import type { WebSocketTerminal } from '../facets/ws-terminal.js';
 import type { RuntimeManifest } from '@nimbus-sh/core/runtime/runtime-manifest.js';
+import { type NimbusFilesystemAuthority } from '@nimbus-sh/core/runtime/os-contracts.js';
 export interface PythonReplDeps {
     facetMgr: FacetManager;
-    vfs: SqliteVFS;
+    /** Owns the installed interpreter blobs the prompt is booted from. */
+    authority: NimbusFilesystemAuthority;
     terminal: WebSocketTerminal;
     /** Per-user-VFS install dir, e.g. 'home/user/.nimbus/runtimes/cpython/3.13.14'. */
     installRoot: string;
@@ -40,7 +42,7 @@ export interface PythonReplDeps {
      * ReplSession lets it drain that queue on attach, which is the difference
      * between the pasted tail arriving and the prompt hanging.
      */
-    shell?: unknown;
+    shell?: Pick<Shell, 'takeQueuedInput'>;
     /**
      * The invoking process's pid.
      *
@@ -57,5 +59,5 @@ export declare function runPythonRepl(deps: PythonReplDeps): Promise<number>;
  * Pay the interpreter's boot before the user asks for a prompt. Pushing empty
  * source compiles to a no-op, so the only thing it does is bring the facet up.
  */
-export declare function warmPythonRepl(deps: Pick<PythonReplDeps, 'facetMgr' | 'vfs' | 'installRoot' | 'manifest'>): Promise<void>;
+export declare function warmPythonRepl(deps: Pick<PythonReplDeps, 'facetMgr' | 'authority' | 'installRoot' | 'manifest'>): Promise<void>;
 //# sourceMappingURL=python-repl.d.ts.map

package/dist/runtime/python-repl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python-repl.d.ts","sourceRoot":"","sources":["../../src/runtime/python-repl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAoBnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,GAAG,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA0QD,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAIzE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,KAAK,GAAG,aAAa,GAAG,UAAU,CAAC,GAC1E,OAAO,CAAC,IAAI,CAAC,CAIf"}
+{"version":3,"file":"python-repl.d.ts","sourceRoot":"","sources":["../../src/runtime/python-repl.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+CAA+C,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAMnF,OAAO,EAAe,KAAK,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AActG,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,sEAAsE;IACtE,SAAS,EAAE,yBAAyB,CAAC;IACrC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACvC;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA2SD,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAIzE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC,GAChF,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/runtime/python-repl.js

@@ -1,24 +1,7 @@
-/**
- * python-repl.ts — the interactive `python` prompt.
- *
- * A long-lived facet holds one interpreter and each submitted line is run in
- * it, so definitions, imports and open files survive between prompts. That is
- * the whole reason the interpreter is built as a WASI reactor: a command
- * module's _start runs once.
- *
- * Incompleteness is decided by `codeop.compile_command`, which is what the real
- * Python REPL uses — it returns None for source that is syntactically fine so
- * far but unfinished (an open bracket, a `def` with no body yet), raises
- * SyntaxError for source that can never complete, and otherwise hands back a
- * code object. That distinction is not something to re-derive from error
- * strings; the previous Pyodide implementation asked PyodideConsole for it,
- * which is the same idea reached through a Pyodide-only object.
- *
- * Compiling in 'single' mode also gets the echo right for free: an expression
- * statement goes through sys.displayhook exactly as it does at a real prompt,
- * so `1 + 1` prints `2` and `x = 1` prints nothing, with no wrapper of ours
- * deciding what counts as a result.
- */
+import { IsolatePool } from '@nimbus-sh/fabric/isolate-pool.js';
+import { manifestVfs } from '@nimbus-sh/core/runtime/vfs-manifest.js';
+import { withHostFilesystem } from '@nimbus-sh/core/shell/execution-fs.js';
+import { z } from 'zod/v4';
 import { ReplSession } from './repl-session.js';
 import { sessionUsesSciVariant } from '@nimbus-sh/core/runtime/python-pip.js';
 import { buildCPythonPreamble } from '@nimbus-sh/core/runtime/cpython-runner.js';
@@ -35,6 +18,8 @@ const INCOMPLETE_MARKER = '__NIMBUS_PY_INCOMPLETE__';
  * ordinary output and never leaves.
  */
 const EXIT_MARKER = '__NIMBUS_PY_EXIT__';
+const PythonFacetResult = z.object({ stdout: z.string(), stderr: z.string(), exitCode: z.number().int(), error: z.string().optional() });
+const PythonFacetFailure = z.object({ __nimbusFacetError: z.string() });
 /** Where cpython-runner's catalog spec stages the interpreter. */
 const CPYTHON_WASM_REL = 'share/cpython/python.wasm';
 const CPYTHON_SCI_WASM_REL = 'share/cpython/python-sci.wasm';
@@ -102,13 +87,25 @@ class PythonReplAdapter {
         return ('Python 3.13.14 (CPython, wasm32-wasi, Nimbus runtime)\r\n' +
             'Type "exit()" or press Ctrl-D to exit.\r\n');
     }
-    async push(source) {
+    push(source) {
+        const controller = new AbortController();
+        const done = this.evaluate(source, controller.signal);
+        const active = { controller, done };
+        this.active = active;
+        const clear = () => { if (this.active === active)
+            this.active = null; };
+        void done.then(clear, clear);
+        return done;
+    }
+    async evaluate(source, signal) {
         const trimmed = source.trim();
         if (trimmed === 'exit' || trimmed === 'quit') {
             return { kind: 'output', stdout: '', stderr: 'Use exit() or Ctrl-D to exit\n' };
         }
         try {
+            signal.throwIfAborted();
             await this.ensurePool();
+            signal.throwIfAborted();
         }
         catch (e) {
             const message = e instanceof Error ? e.message : String(e);
@@ -116,7 +113,7 @@ class PythonReplAdapter {
         }
         let result;
         try {
-            result = await this.submit(buildReplDriver(source));
+            result = await this.submit(buildReplDriver(source), signal);
         }
         catch (e) {
             const message = e instanceof Error ? e.message : String(e);
@@ -149,48 +146,53 @@ class PythonReplAdapter {
         }
         return { kind: 'output', stdout: result.stdout, stderr: result.stderr };
     }
-    async close() {
-        if (this.pool) {
-            try {
-                this.pool.dispose?.();
-            }
-            catch { /* fail-soft: the session is ending anyway */ }
-            this.pool = null;
+    close() { return this.interrupt(); }
+    resetPool() {
+        const pool = this.pool;
+        this.pool = null;
+        this.wasmBytes = null;
+        this.fsSnapshot = null;
+        pool?.dispose();
+    }
+    async interrupt() {
+        const active = this.active;
+        active?.controller.abort();
+        try {
+            await active?.done;
+        }
+        finally {
+            this.resetPool();
         }
     }
     async ensurePool() {
-        const vfsForVariant = this.deps.vfs.as(CRED_KERNEL);
+        await withHostFilesystem(this.deps.authority, CRED_KERNEL, (vfs) => this.ensurePoolFrom(vfs));
+    }
+    async ensurePoolFrom(vfs) {
         const sciPath = `${this.deps.installRoot}/${CPYTHON_SCI_WASM_REL}`;
-        const wantsSci = sessionUsesSciVariant(vfsForVariant) && vfsForVariant.exists(sciPath);
+        const wantsSci = (await sessionUsesSciVariant(vfs)) && (await vfs.exists(sciPath));
         // A prompt that was open before `pip install numpy` is holding the
         // interpreter that does not have it. Dropping the pool rebuilds on the next
         // statement, which is the facet restart EXTENSIONS.md says this costs.
         if (this.pool && this.poolUsesSci !== wantsSci) {
-            try {
-                this.pool.dispose?.();
-            }
-            catch { /* fail-soft: it is being replaced */ }
-            this.pool = null;
+            this.resetPool();
         }
         if (this.pool)
             return;
         this.poolUsesSci = wantsSci;
         const { installRoot, facetMgr } = this.deps;
-        const vfs = vfsForVariant;
         const wasmPath = wantsSci ? sciPath : `${installRoot}/${CPYTHON_WASM_REL}`;
         const stdlibPath = `${installRoot}/${CPYTHON_STDLIB_REL}`;
-        if (!vfs.exists(wasmPath)) {
+        if (!(await vfs.exists(wasmPath))) {
             throw new Error(`python.wasm missing at ${wasmPath} (run 'nimbus install python')`);
         }
-        if (!vfs.exists(stdlibPath)) {
+        if (!(await vfs.exists(stdlibPath))) {
             throw new Error(`python313.zip missing at ${stdlibPath} (run 'nimbus install python')`);
         }
-        this.wasmBytes = toArrayBuffer(vfs.readFile(wasmPath));
-        const { manifestVfs } = await import('@nimbus-sh/core/runtime/vfs-manifest.js');
+        this.wasmBytes = toArrayBuffer(await vfs.readFile(wasmPath));
         // The install root is the Python prefix, so the manifest covers lib/ and
         // etc/ as they are — nothing is aliased into a path the supervisor could
         // not serve.
-        const built = manifestVfs(vfs, 'home/user', { extraRoots: [installRoot.replace(/^\/+/, '')] });
+        const built = await manifestVfs(vfs.authority, CRED_KERNEL, 'home/user', { extraRoots: [installRoot.replace(/^\/+/, '')] });
         if ('error' in built)
             throw new Error(built.error);
         // Same workaround as cpython-runner, and it belongs to the same open
@@ -198,7 +200,7 @@ class PythonReplAdapter {
         // demand-load, though the transport delivers it byte-identically. Seeding
         // it by value is what makes the interpreter start. Remove both together.
         const snapshot = built.snapshot;
-        const zipBytes = vfs.readFile(stdlibPath);
+        const zipBytes = await vfs.readFile(stdlibPath);
         let bin = '';
         const CH = 32768;
         for (let i = 0; i < zipBytes.length; i += CH) {
@@ -207,7 +209,6 @@ class PythonReplAdapter {
         snapshot.files[stdlibPath.replace(/^\/+/, '')] = btoa(bin);
         this.fsSnapshot = snapshot;
         this.pythonHome = `/${installRoot.replace(/^\/+/, '')}`;
-        const { IsolatePool } = await import('@nimbus-sh/fabric/isolate-pool.js');
         const host = getFacetManagerLoaderHost(facetMgr);
         // A prompt where `open(path, "w")` silently does nothing is worse than one
         // that refuses to start, so the pid decides which pool this is. Written as
@@ -219,43 +220,65 @@ class PythonReplAdapter {
             // Distinct from cpython-runner's tag: a REPL facet holds a live
             // interpreter and must never be handed a one-shot invocation.
             tag: wantsSci ? 'python-repl:sci' : 'python-repl',
+            scope: crypto.randomUUID(),
             concurrency: 1,
             preamble: buildCPythonPreamble(),
             wasmModules: { 'python.wasm': this.wasmBytes },
         };
         const pid = this.deps.pid;
-        this.pool = (typeof pid === 'number' && pid > 0
+        this.pool = typeof pid === 'number' && pid > 0
             ? new IsolatePool(host.env, host.ctx, { ...base, supervisorPid: pid })
             // The install-time warm-up has no invoking process. It boots the
             // interpreter and never touches a file, so it asks for no supervisor
             // rather than binding one it cannot authenticate to.
-            : new IsolatePool(host.env, host.ctx, { ...base, omitSupervisor: true }));
+            : new IsolatePool(host.env, host.ctx, { ...base, omitSupervisor: true });
     }
-    async submit(userCode) {
-        const result = await this.pool.submit(pythonReplStepFacetFn, {
-            userCode,
-            pythonHome: this.pythonHome,
-            pyArgv: ['python'],
-            userEnv: { HOME: '/home/user', PYTHONUNBUFFERED: '1' },
-            progName: 'python',
-            cwd: '/home/user',
-            fsSnapshot: this.fsSnapshot,
-        }, { timeoutMs: 60_000 });
-        return result;
+    active = null;
+    async submit(userCode, signal) {
+        const pool = this.pool;
+        if (!pool || !this.fsSnapshot)
+            throw new Error('Python REPL is not initialized');
+        const response = await pool.submitRequest(pythonReplStepRequestFn, new Request('https://facet.internal/python-repl-step', {
+            method: 'POST',
+            body: JSON.stringify({
+                userCode,
+                pythonHome: this.pythonHome,
+                pyArgv: ['python'],
+                userEnv: { HOME: '/home/user', PYTHONUNBUFFERED: '1' },
+                progName: 'python',
+                cwd: '/home/user',
+                fsSnapshot: this.fsSnapshot,
+            }),
+            signal,
+        }), { timeoutMs: 60_000 });
+        if (!response.ok) {
+            const failure = PythonFacetFailure.parse(await response.json());
+            throw new Error(failure.__nimbusFacetError);
+        }
+        return PythonFacetResult.parse(await response.json());
     }
 }
 /**
- * Facet-side. Serialized with fn.toString(), so it captures nothing and names
- * no import: __cpythonReplRun is put on globalThis by the preamble, and unlike
- * __cpythonRun it keeps its interpreter between calls.
+ * Facet-side, request-shaped: serialized with fn.toString() into the
+ * pool's fetch entrypoint, so it captures nothing and names no import —
+ * __cpythonReplRun is put on globalThis by the preamble, and unlike
+ * __cpythonRun it keeps its interpreter between calls. The request body
+ * is the step payload the adapter JSON-encodes; the response is the
+ * step result. Request transport because it is the pool's only
+ * cancellable dispatch: Ctrl-C aborts the request, workerd stops the
+ * interpreter at its suspension point.
  */
-async function pythonReplStepFacetFn(args, facetEnv) {
+async function pythonReplStepRequestFn(request, facetEnv) {
+    const args = await request.json();
+    if (typeof args !== 'object' || args === null || !('userCode' in args) || typeof args.userCode !== 'string') {
+        throw new Error('Python REPL request must contain userCode');
+    }
     const run = Reflect.get(globalThis, '__cpythonReplRun');
     if (typeof run !== 'function') {
-        return {
+        return Response.json({
             stdout: '', stderr: '', exitCode: 127,
             error: 'cpython preamble missing: __cpythonReplRun not in scope',
-        };
+        });
     }
     const adopt = Reflect.get(globalThis, '__wasiAdoptSupervisor');
     const drain = Reflect.get(globalThis, '__wasiDrainPersist');
@@ -266,13 +289,15 @@ async function pythonReplStepFacetFn(args, facetEnv) {
     // filesystem it could read.
     if (supervisor)
         Reflect.set(globalThis, '__nimbusPySupervisor', supervisor);
-    adopt?.(supervisor);
+    if (typeof adopt === 'function')
+        Reflect.apply(adopt, undefined, [supervisor ?? null]);
     try {
-        return await run(args);
+        return Response.json(await run(args));
     }
     finally {
         // A line that wrote a file and then raised still wrote the file.
-        await drain?.();
+        if (typeof drain === 'function')
+            await drain();
     }
 }
 export async function runPythonRepl(deps) {

package/dist/runtime/repl-session.d.ts

@@ -12,6 +12,7 @@
  * interface declared below.
  */
 import type { WebSocketTerminal } from '../facets/ws-terminal.js';
+import type { Shell } from '@nimbus-sh/core/substrate/lifo/shell/Shell.js';
 /**
  * Per-runtime adapter contract. The shell-side ReplSession orchestrates
  * input handling; the adapter wraps the actual runtime invocation.
@@ -30,6 +31,8 @@ export interface ReplAdapter {
     /** Called once on session close (exit() / Ctrl-D / shell teardown).
      *  Should free any cached pool / isolate. Idempotent. */
     close(): Promise<void>;
+    /** Abort and settle the active push, resetting its interpreter before resolving. */
+    interrupt?(): void | Promise<void>;
     /** Primary prompt (typically '>>> '). */
     ps1: string;
     /** Continuation prompt (typically '... '). */
@@ -50,45 +53,10 @@ export type ReplPushResult = {
     kind: 'error';
     stderr: string;
 };
-/**
- * Manages an interactive REPL session: stdin buffering with minimal
- * readline UX (line-mode), output routing to the WS terminal, prompt
- * rendering, and adapter dispatch.
- *
- * The shell creates a ReplSession when a runtime's `startRepl` hook
- * fires; the session installs a `replCallback` on the WebSocketTerminal
- * (via attachRepl()) and runs until the adapter signals 'exit' or the
- * user presses Ctrl-D on an empty line.
- *
- * No setTimeout in the read loop — the session is driven entirely by
- * keystroke arrival on the WS, with awaits gating the adapter's push().
- */
 export declare class ReplSession {
     private adapter;
+    private detachRepl;
     private terminal;
-    private detachReplCb;
-    /**
-     * REPL-R7-1 (2026-05-12): optional reference to the Nimbus shell.
-     *
-     * Required when the REPL is launched from a multi-line WS frame
-     * (e.g. user pastes `python\nexit(7)`). The shell input handler
-     * splits the frame on \r\n and pushes lines AFTER
-     * the first into `shell.pasteQueue`, which is drained ONLY when
-     * the shell becomes idle (after executeLine returns). While our
-     * REPL is running, those pasteQueue lines sit there waiting and
-     * the REPL itself receives no input → user sees a hung `>>> `
-     * prompt that never responds.
-     *
-     * If `shell` is provided, ReplSession will, immediately after
-     * attaching its replCallback, drain shell.pasteQueue and feed the
-     * lines into the callback (suffixed with \r each — matches what
-     * the WS frame originally would have looked like). This makes the
-     * paste path work transparently for REPL launches.
-     *
-     * The shell reference is optional so existing adapters (bun, node,
-     * ruby) that haven't been updated keep working with their
-     * pre-fix behavior.
-     */
     private shellRef;
     /** Current line buffer (chars typed since the last enter). */
     private lineBuf;
@@ -101,9 +69,11 @@ export declare class ReplSession {
     /** Per-session history ring (most recent first). Capped at 100. */
     private history;
     private historyIdx;
-    /** Resolves when close() has been called and the session ended. */
     private closedResolve;
     private closedPromise;
+    private pendingInterrupt;
+    private activePush;
+    private ending;
     /** Exit code captured from adapter's last 'exit' return. */
     private exitCode;
     /**
@@ -124,23 +94,16 @@ export declare class ReplSession {
      */
     private inputQueue;
     private draining;
-    constructor(adapter: ReplAdapter, terminal: WebSocketTerminal, shell?: any);
+    constructor(adapter: ReplAdapter, terminal: WebSocketTerminal, shell?: Pick<Shell, 'takeQueuedInput'>);
     /** Run the session: prints banner, installs the input hook, returns
      *  a promise that resolves with the exit code when the session ends. */
     run(): Promise<number>;
-    /**
-     * REPL-A1b: drain the input queue serially. Pulls data off
-     * inputQueue, runs handleInput, and reads any data that arrived
-     * during the await. Exits when queue is empty. Only ONE drainInput
-     * runs at a time (guarded by draining flag set in attachRepl
-     * callback).
-     */
     private drainInput;
     /** Process an input chunk. May contain multiple characters (paste
      *  or rapid typing) — we iterate char-by-char to handle each
      *  control byte individually. */
     private handleInput;
-    /** Submit the current line buffer to the adapter. */
+    private interruptBusy;
     private submitLine;
     /** Map up-arrow → previous history entry. */
     private historyUp;
@@ -148,7 +111,6 @@ export declare class ReplSession {
     private historyDown;
     /** Erase the current displayed line and replace with `text`. */
     private replaceCurrentLine;
-    /** Close the session: detach input hook, free adapter, resolve. */
     private endSession;
 }
 //# sourceMappingURL=repl-session.d.ts.map

package/dist/runtime/repl-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repl-session.d.ts","sourceRoot":"","sources":["../../src/runtime/repl-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;mCAC+B;IAC/B,MAAM,IAAI,MAAM,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5C;6DACyD;IACzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,YAAY,CAA6B;IACjD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,QAAQ,CAAa;IAE7B,8DAA8D;IAC9D,OAAO,CAAC,OAAO,CAAc;IAC7B,sDAAsD;IACtD,OAAO,CAAC,SAAS,CAAa;IAC9B,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAgB;IAChC,8EAA8E;IAC9E,OAAO,CAAC,IAAI,CAAkB;IAC9B,mEAAmE;IACnE,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAc;IAChC,mEAAmE;IACnE,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,aAAa,CAAgB;IACrC,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAa;IAC7B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,GAAG;IAU1E;4EACwE;IAClE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAyD5B;;;;;;OAMG;YACW,UAAU;IASxB;;qCAEiC;YACnB,WAAW;IA6EzB,qDAAqD;YACvC,UAAU;IA8ExB,6CAA6C;IAC7C,OAAO,CAAC,SAAS;IAMjB,mDAAmD;IACnD,OAAO,CAAC,WAAW;IAUnB,gEAAgE;IAChE,OAAO,CAAC,kBAAkB;IAW1B,mEAAmE;YACrD,UAAU;CAYzB"}
+{"version":3,"file":"repl-session.d.ts","sourceRoot":"","sources":["../../src/runtime/repl-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+CAA+C,CAAC;AAI3E;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;mCAC+B;IAC/B,MAAM,IAAI,MAAM,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5C;6DACyD;IACzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,oFAAoF;IACpF,SAAS,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAiBtC,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAA+C;IAE/D,8DAA8D;IAC9D,OAAO,CAAC,OAAO,CAAc;IAC7B,sDAAsD;IACtD,OAAO,CAAC,SAAS,CAAa;IAC9B,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAgB;IAChC,8EAA8E;IAC9E,OAAO,CAAC,IAAI,CAAkB;IAC9B,mEAAmE;IACnE,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,gBAAgB,CAA0C;IAClE,OAAO,CAAC,UAAU,CAAwC;IAC1D,OAAO,CAAC,MAAM,CAA8B;IAE5C,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAa;IAC7B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAUrG;4EACwE;IAClE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;YAuCd,UAAU;IAiBxB;;qCAEiC;YACnB,WAAW;IA0EzB,OAAO,CAAC,aAAa;YAiBP,UAAU;IA0FxB,6CAA6C;IAC7C,OAAO,CAAC,SAAS;IAMjB,mDAAmD;IACnD,OAAO,CAAC,WAAW;IAUnB,gEAAgE;IAChE,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,UAAU;CAwBnB"}