@hy-sde-org/dsh-code-runtime-kernels 0.1.0-rc.8

package/dist/nodejs/runner.js

@@ -0,0 +1,298 @@
+/**
+ * The spawned Node.js kernel runner. One `node <this-file>` subprocess is one
+ * persistent kernel: it owns the wire-protocol peers described in
+ * `protocol.ts`, a persistent `state` object (plus the process-global object)
+ * that survives every run of the session, and a per-run evaluation cell with
+ * async-function-body semantics — top-level `await` and `return` work exactly
+ * like the worker-thread backend, and bindings are materialized as ordinary
+ * globals whose members bridge `call`/`reply` frames to the host.
+ *
+ * This file must stay self-contained (Node builtins only, no imports of other package
+ * sources): tsc emits it as ESM under the package output and development tests
+ * spawn the raw source directly (Node 22.18+/24+ runs erasable TypeScript).
+ *
+ * Persistence contract (mirrors the Python provider's user namespace):
+ *  - `state` is a long-lived object exposed to every program; mutations
+ *    survive until the session resets or the kernel exits.
+ *  - sloppy-mode assignments like `x = 41` land on the process global and
+ *    persist; `globalThis` itself persists.
+ *  - `const`/`let`/`var`/`function`/`class` declared at cell top level are
+ *    scoped to that cell (async-function body), exactly like a Node REPL
+ *    line that uses top-level `await` — use `state` or the global object to
+ *    persist values.
+ * @module @deepseek-ai/dsh-code-runtime-nodejs/src/runner
+ */
+import { format } from 'node:util';
+/** Global-object accessor for program-scope globals keyed by identifier. */
+const g = globalThis;
+/** The original stdout sink, captured before suppression of program writes. */
+const rawStdout = process.stdout;
+const rawWrite = rawStdout.write.bind(rawStdout);
+/** Emit one protocol frame (a single JSON line on stdout), untouched by the cap. */
+function emit(frame) {
+    rawWrite(`${JSON.stringify(frame)}\n`);
+}
+// --- persistent kernel state -------------------------------------------------
+/** Program-visible persistent state (survives every run in this kernel). */
+const state = {};
+let executionCount = 0;
+let active = null;
+/** Emit a `log` frame into the active run's ledger; stray output is dropped. */
+function logFrame(text, stream) {
+    if (active === null)
+        return;
+    emit({ type: 'log', id: active.id, text, stream });
+}
+/** Patch the program's output surfaces into ordered per-run log frames. */
+function installOutputCapture() {
+    console.log = (...args) => { logFrame(format(...args) + '\n', 'stdout'); };
+    console.info = (...args) => { logFrame(format(...args) + '\n', 'stdout'); };
+    console.warn = (...args) => { logFrame(format(...args) + '\n', 'stderr'); };
+    console.error = (...args) => { logFrame(format(...args) + '\n', 'stderr'); };
+    console.debug = console.warn;
+    process.stderr.write = (chunk) => { logFrame(String(chunk), 'stderr'); return true; };
+}
+/** Render an unknown thrown value as a short error line. */
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Round-trip a completion through strict JSON; mirrors the Python lossless check. */
+function losslessValue(value) {
+    try {
+        return { ok: true, value: JSON.parse(JSON.stringify(value)) };
+    }
+    catch {
+        return { ok: false };
+    }
+}
+// --- tool bindings -----------------------------------------------------------
+let nextCallSeq = 0;
+/** Wrap one callable member into an async bridge that awaits a host reply. */
+function makeCallable(run, gname, name, errorClass) {
+    return async (args) => {
+        const seq = ++nextCallSeq;
+        const pending = new Promise((resolve, reject) => {
+            run.calls.set(seq, { resolve, reject });
+            emit({ type: 'call', id: run.id, seq, global: gname, name, args });
+        });
+        let value;
+        try {
+            value = await pending;
+        }
+        catch (error) {
+            const message = messageOf(error);
+            const nameForMember = errorClass !== undefined
+                ? error.__dshMember ?? name
+                : undefined;
+            const rejection = errorClass !== undefined
+                ? new g[errorClass.name](message)
+                : new Error(message);
+            if (errorClass !== undefined) {
+                Object.assign(rejection, { [errorClass.memberNameProperty]: nameForMember });
+            }
+            throw rejection;
+        }
+        return value;
+    };
+}
+// --- cell execution ----------------------------------------------------------
+function materializeNamespaces(run, namespaces) {
+    for (const descriptor of namespaces) {
+        const previous = g[descriptor.global];
+        run.restores.push([descriptor.global, previous]);
+        const record = {};
+        for (const name of descriptor.names) {
+            record[name] = makeCallable(run, descriptor.global, name, descriptor.errorClass);
+        }
+        g[descriptor.global] = record;
+        if (descriptor.errorClass !== undefined) {
+            const errorClassName = descriptor.errorClass.name;
+            const previousClass = g[errorClassName];
+            run.restores.push([errorClassName, previousClass]);
+            g[errorClassName] = class extends Error {
+                constructor(message) {
+                    super(message);
+                    this.name = errorClassName;
+                }
+            };
+            // The anonymous class has an empty `.name`; reflect the descriptor so
+            // both `err.constructor.name` and `instanceof` read the real name.
+            Object.defineProperty(g[errorClassName], 'name', { value: errorClassName });
+        }
+    }
+}
+function restoreGlobals(run) {
+    for (const [name, previous] of run.restores) {
+        if (previous === undefined)
+            Reflect.deleteProperty(g, name);
+        else
+            g[name] = previous;
+    }
+    run.restores.length = 0;
+}
+/** The sentinel error that cancels a cell on SIGINT. */
+const INTERRUPTED = new Error('run interrupted by SIGINT');
+INTERRUPTED.name = 'INTERRUPTED';
+/** Run one cell against this run's namespaces; settle the run when it finishes. */
+async function runCell(code, run, namespaces) {
+    materializeNamespaces(run, namespaces);
+    const interrupted = new Promise((_resolve, reject) => { run.interrupt = () => { reject(INTERRUPTED); }; });
+    // Concatenation (not a template literal): the code is hostile user input and
+    // may contain backticks or `${...}` without breaking the wrapper. This is the
+    // kernel's core act — evaluation of model-written cells in a fresh wrapper.
+    // Construction can itself throw (a cell with invalid JavaScript syntax);
+    // that is a program error, not a reason to lose the kernel, so it settles
+    // the run instead of letting the exception escape and kill the runner.
+    // eslint-disable-next-line typescript/no-implied-eval -- persistent eval kernel by design
+    let done = false;
+    const finish = (frame) => {
+        if (done)
+            return;
+        done = true;
+        emit(frame);
+    };
+    let program;
+    try {
+        program = new Function('return (async () => {\n' + code + '\n})()');
+    }
+    catch (error) {
+        const message = messageOf(error);
+        emit({ type: 'error', id: run.id, ename: 'SyntaxError', evalue: message, traceback: [] });
+        finish({ type: 'done', id: run.id, status: 'error', executionCount: ++executionCount, message });
+        return;
+    }
+    try {
+        const promise = program.call(globalThis);
+        const value = await Promise.race([promise, interrupted]);
+        if (value === undefined) {
+            // No completion value: `undefined` is the worker backend's convention for
+            // a program that did not `return` anything, and the seam's value is optional.
+            finish({ type: 'done', id: run.id, status: 'ok', executionCount: ++executionCount });
+            return;
+        }
+        const serialized = losslessValue(value);
+        if (!serialized.ok) {
+            finish({ type: 'done', id: run.id, status: 'error', executionCount: ++executionCount, invalidOutput: true, message: 'program completion must be lossless JSON' });
+            return;
+        }
+        finish({ type: 'done', id: run.id, status: 'ok', executionCount: ++executionCount, value: serialized.value });
+    }
+    catch (error) {
+        if (error === INTERRUPTED) {
+            finish({ type: 'done', id: run.id, status: 'error', cancelled: true, executionCount: ++executionCount });
+            return;
+        }
+        const message = messageOf(error);
+        const stack = error instanceof Error && typeof error.stack === 'string' ? error.stack.split('\n') : [];
+        const ename = error instanceof Error ? error.name : 'Error';
+        emit({ type: 'error', id: run.id, ename, evalue: message, traceback: stack });
+        finish({ type: 'done', id: run.id, status: 'error', executionCount: ++executionCount, message });
+    }
+    finally {
+        restoreGlobals(run);
+    }
+}
+// --- wire loop ---------------------------------------------------------------
+let readBuffer = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => {
+    readBuffer += chunk;
+    for (;;) {
+        const nl = readBuffer.indexOf('\n');
+        if (nl < 0)
+            break;
+        const line = readBuffer.slice(0, nl);
+        readBuffer = readBuffer.slice(nl + 1);
+        if (!line.trim())
+            continue;
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        void handleMessage(message);
+    }
+});
+async function handleMessage(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return;
+    const message = raw;
+    switch (message.type) {
+        case 'exec':
+            await handleExec(message);
+            break;
+        case 'reply':
+            handleReply(message);
+            break;
+        case 'exit':
+            process.exit(0);
+    }
+}
+function handleReply(message) {
+    if (active === null)
+        return;
+    const call = active.calls.get(message.seq);
+    if (call === undefined)
+        return;
+    active.calls.delete(message.seq);
+    if (message.ok)
+        call.resolve(message.value);
+    else {
+        const error = Object.assign(new Error(message.message ?? 'binding failed'), { __dshMember: message.name });
+        call.reject(error);
+    }
+}
+async function handleExec(message) {
+    if (typeof message.id !== 'string' || message.id.length === 0)
+        return;
+    if (typeof message.code !== 'string') {
+        emit({ type: 'error', id: message.id, ename: 'ProtocolError', evalue: 'code must be a string', traceback: [] });
+        emit({ type: 'done', id: message.id, status: 'error', executionCount: ++executionCount, message: 'code must be a string' });
+        return;
+    }
+    if (typeof message.cwd === 'string') {
+        try {
+            process.chdir(message.cwd);
+        }
+        catch { /* keep previous cwd */ }
+    }
+    if (message.env !== undefined && typeof message.env === 'object') {
+        for (const [key, value] of Object.entries(message.env)) {
+            if (typeof value === 'string')
+                process.env[key] = value;
+            else
+                Reflect.deleteProperty(process.env, key);
+        }
+    }
+    const namespaces = Array.isArray(message.namespaces) ? message.namespaces : [];
+    const run = {
+        id: message.id,
+        calls: new Map(),
+        interrupt: () => { },
+        restores: [],
+    };
+    active = run;
+    emit({ type: 'started', id: run.id });
+    await runCell(message.code, run, namespaces);
+    // The run settled (normally, failed, or interrupted); a cancelled cell's
+    // ghost keeps evaluating in the background, so later runs must not see it.
+    if (active === run)
+        active = null;
+}
+// --- signals -----------------------------------------------------------------
+/** SIGINT cancels the active run. A busy synchronous cell blocks the event
+ *  loop here, so the host's escalation ladder (SIGTERM then SIGKILL) is what
+ *  actually stops it — the same outcome, owned by the host. */
+process.on('SIGINT', () => {
+    if (active !== null)
+        active.interrupt();
+});
+// --- boot --------------------------------------------------------------------
+// The program cells evaluate through `new Function` in the process global
+// scope; the persistent `state` object is exposed there so runs can share it.
+g.state = state;
+installOutputCapture();
+emit({ type: 'ready', pid: process.pid });
+//# sourceMappingURL=runner.js.map

package/dist/nodejs/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/nodejs/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAyBH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAElC,4EAA4E;AAC5E,MAAM,CAAC,GAA4B,UAAgD,CAAA;AAEnF,+EAA+E;AAC/E,MAAM,SAAS,GAAuB,OAAO,CAAC,MAAM,CAAA;AACpD,MAAM,QAAQ,GAA+B,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AAE5E,oFAAoF;AACpF,SAAS,IAAI,CAAC,KAAa;IACzB,QAAQ,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACxC,CAAC;AAED,gFAAgF;AAEhF,4EAA4E;AAC5E,MAAM,KAAK,GAA4B,EAAE,CAAA;AACzC,IAAI,cAAc,GAAG,CAAC,CAAA;AAmBtB,IAAI,MAAM,GAAqB,IAAI,CAAA;AAEnC,gFAAgF;AAChF,SAAS,QAAQ,CAAC,IAAY,EAAE,MAAc;IAC5C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAM;IAC3B,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;AACpD,CAAC;AAED,2EAA2E;AAC3E,SAAS,oBAAoB;IAC3B,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAA,CAAC,CAAC,CAAA;IACpF,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAA,CAAC,CAAC,CAAA;IACrF,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAA,CAAC,CAAC,CAAA;IACrF,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAA,CAAC,CAAC,CAAA;IACtF,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAG3B;IAAC,OAAO,CAAC,MAA6B,CAAC,KAAK,GAAG,CAAC,KAAc,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC,CAAA;AACxH,CAAC;AAED,4DAA4D;AAC5D,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC/D,CAAC;AAED,sFAAsF;AACtF,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAY,EAAE,CAAA;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAA;IACtB,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF,IAAI,WAAW,GAAG,CAAC,CAAA;AAEnB,8EAA8E;AAC9E,SAAS,YAAY,CACnB,GAAc,EACd,KAAa,EACb,IAAY,EACZ,UAAoE;IAEpE,OAAO,KAAK,EAAE,IAAa,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,EAAE,WAAW,CAAA;QACzB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACvD,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;YACvC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACpE,CAAC,CAAC,CAAA;QACF,IAAI,KAAc,CAAA;QAClB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,OAAO,CAAA;QACvB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;YAChC,MAAM,aAAa,GAAG,UAAU,KAAK,SAAS;gBAC5C,CAAC,CAAE,KAAkC,CAAC,WAAW,IAAI,IAAI;gBACzD,CAAC,CAAC,SAAS,CAAA;YACb,MAAM,SAAS,GAAG,UAAU,KAAK,SAAS;gBACxC,CAAC,CAAC,IAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAoC,CAAC,OAAO,CAAC;gBACrE,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;YACtB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,aAAa,EAAE,CAAC,CAAA;YAC9E,CAAC;YACD,MAAM,SAAS,CAAA;QACjB,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;AACH,CAAC;AAED,gFAAgF;AAEhF,SAAS,qBAAqB,CAAC,GAAc,EAAE,UAAqC;IAClF,KAAK,MAAM,UAAU,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;QACrC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;QAChD,MAAM,MAAM,GAAwD,EAAE,CAAA;QACtE,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,CAAA;QAClF,CAAC;QACD,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;QAC7B,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAA;YACjD,MAAM,aAAa,GAAG,CAAC,CAAC,cAAc,CAAC,CAAA;YACvC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAA;YAClD,CAAC,CAAC,cAAc,CAAC,GAAG,KAAM,SAAQ,KAAK;gBACrC,YAAY,OAAe;oBACzB,KAAK,CAAC,OAAO,CAAC,CAAA;oBACd,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;gBAC5B,CAAC;aACF,CAAA;YACD,sEAAsE;YACtE,mEAAmE;YACnE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAA;QAC7E,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,GAAc;IACpC,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC5C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;;YACtD,CAAC,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAA;IACzB,CAAC;IACD,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;AACzB,CAAC;AAED,wDAAwD;AACxD,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;AAC1D,WAAW,CAAC,IAAI,GAAG,aAAa,CAAA;AAEhC,mFAAmF;AACnF,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,GAAc,EAAE,UAAqC;IACxF,qBAAqB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IACtC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,GAAG,CAAC,SAAS,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IAC/G,6EAA6E;IAC7E,8EAA8E;IAC9E,4EAA4E;IAC5E,yEAAyE;IACzE,0EAA0E;IAC1E,uEAAuE;IACvE,0FAA0F;IAC1F,IAAI,IAAI,GAAG,KAAK,CAAA;IAChB,MAAM,MAAM,GAAG,CAAC,KAAa,EAAQ,EAAE;QACrC,IAAI,IAAI;YAAE,OAAM;QAChB,IAAI,GAAG,IAAI,CAAA;QACX,IAAI,CAAC,KAAK,CAAC,CAAA;IACb,CAAC,CAAA;IACD,IAAI,OAAwC,CAAA;IAC5C,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,QAAQ,CAAC,yBAAyB,GAAG,IAAI,GAAG,QAAQ,CAAoC,CAAA;IACxG,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;QAChC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAA;QACzF,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAA;QAChG,OAAM;IACR,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAqB,CAAA;QAC5D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAA;QACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,0EAA0E;YAC1E,8EAA8E;YAC9E,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,cAAc,EAAE,CAAC,CAAA;YACpF,OAAM;QACR,CAAC;QACD,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;QACvC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC,CAAA;YACjK,OAAM;QACR,CAAC;QACD,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAA;IAC/G,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;YAC1B,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,cAAc,EAAE,CAAC,CAAA;YACxG,OAAM;QACR,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;QAChC,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACtG,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;QAC3D,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;QAC7E,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAA;IAClG,CAAC;YAAS,CAAC;QACT,cAAc,CAAC,GAAG,CAAC,CAAA;IACrB,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF,IAAI,UAAU,GAAG,EAAE,CAAA;AACnB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AACjC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;IACzC,UAAU,IAAI,KAAK,CAAA;IACnB,SAAS,CAAC;QACR,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,EAAE,GAAG,CAAC;YAAE,MAAK;QACjB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACpC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QACrC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAQ;QAC1B,IAAI,OAAgB,CAAA;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAA;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;QACD,KAAK,aAAa,CAAC,OAAO,CAAC,CAAA;IAC7B,CAAC;AACH,CAAC,CAAC,CAAA;AAEF,KAAK,UAAU,aAAa,CAAC,GAAY;IACvC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAM;IACnD,MAAM,OAAO,GAAG,GAAuC,CAAA;IACvD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM;YACT,MAAM,UAAU,CAAC,OAAiC,CAAC,CAAA;YACnD,MAAK;QACP,KAAK,OAAO;YACV,WAAW,CAAC,OAAkC,CAAC,CAAA;YAC/C,MAAK;QACP,KAAK,MAAM;YACT,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,OAAqB;IACxC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAM;IAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAM;IAC9B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;SACtC,CAAC;QACJ,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;QAC1G,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAAoB;IAC5C,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IACrE,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAA;QAC/G,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAA;QAC3H,OAAM;IACR,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,IAAI,CAAC;YAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;QACjE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;;gBAClD,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9E,MAAM,GAAG,GAAc;QACrB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,IAAI,GAAG,EAAE;QAChB,SAAS,EAAE,GAAG,EAAE,GAA8B,CAAC;QAC/C,QAAQ,EAAE,EAAE;KACb,CAAA;IACD,MAAM,GAAG,GAAG,CAAA;IACZ,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAA;IACrC,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;IAC5C,yEAAyE;IACzE,2EAA2E;IAC3E,IAAI,MAAM,KAAK,GAAG;QAAE,MAAM,GAAG,IAAI,CAAA;AACnC,CAAC;AAED,gFAAgF;AAEhF;;+DAE+D;AAC/D,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,CAAC,SAAS,EAAE,CAAA;AACzC,CAAC,CAAC,CAAA;AAEF,gFAAgF;AAEhF,0EAA0E;AAC1E,8EAA8E;AAC9E,CAAC,CAAC,KAAK,GAAG,KAAK,CAAA;AACf,oBAAoB,EAAE,CAAA;AACtB,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA"}

package/dist/python/runner.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The persistent Python kernel embedded as source. One long-lived `python3`
+ * subprocess runs this script; the host and it speak NDJSON over stdio. The
+ * script is deliberately SELF-CONTAINED (standard library only) so no
+ * virtualenv, package install, or site customization is needed to run model
+ * code against a persistent namespace and event loop.
+ *
+ * Wire protocol (one JSON object per line):
+ * - host -> kernel: `{"type":"exec","id":str,"code":str,"namespaces":[...],"cwd"?,"env"?}`,
+ *   `{"type":"reply","id":str,"seq":int,"ok":bool,"value"?|"message"}`,
+ *   `{"type":"exit"}`
+ * - kernel -> host: `{"type":"ready","pid":int}`, then per exec:
+ *   `{"type":"started","id"}`, `{"type":"log","id","text","stream"?}`,
+ *   `{"type":"call","id","seq":int,"global","name","args"}`,
+ *   `{"type":"error","id","ename","evalue","traceback":[]}`,
+ *   `{"type":"done","id","status":"ok"|"error","value"?,"executionCount":int,"cancelled":bool}`
+ *
+ * The runner is a persistent kernel: `user_ns` and one asyncio event loop
+ * survive across cells, so top-level `await` interleaves and assignments
+ * persist; tool bindings are bridged through wire frames that the host
+ * resolves against the CURRENT run's namespaces.
+ *
+ * @module @deepseek-ai/dsh-code-runtime-python/src/runner
+ */
+export declare const PYTHON_RUNNER: string;
+//# sourceMappingURL=runner.d.ts.map

package/dist/python/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/python/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,eAAO,MAAM,aAAa,QA6kBzB,CAAA"}