@namzu/sdk 27.1.0 → 28.0.0

package/dist/execution/code-runtime/worker.js

@@ -0,0 +1,248 @@
+import { Worker } from 'node:worker_threads';
+import { HostCallDeniedError, } from './types.js';
+/**
+ * A `worker_threads` backend.
+ *
+ * Chosen over `vm` because `vm` is not a sandbox and its own documentation
+ * says so: a context shares the process, so a program that reaches a
+ * constructor from the host realm is out — `this.constructor.constructor`
+ * on any leaked object is the whole escape, and it fits in a tweet. A
+ * worker is a separate V8 isolate with its own heap; escaping it means
+ * escaping V8.
+ *
+ * Chosen over a subprocess because a subprocess is a process: it inherits
+ * an environment, it can be a fork bomb, and killing it is the process-tree
+ * problem `process/kill-tree.ts` exists for. A worker is cheaper to start,
+ * cheaper to kill, and cannot outlive the process that made it.
+ *
+ * What a worker does NOT give, stated because it is the reason this is not
+ * the whole answer: a worker shares the process's filesystem and network
+ * access. It is not confined by anything the OS enforces. What confines the
+ * program here is that it is handed a scope with nothing in it — no
+ * `require`, no `process`, no `fetch` — and a single channel back to the
+ * host. That is a language-level boundary, and a language-level boundary is
+ * exactly as strong as the enumeration of what was withheld. So a host that
+ * needs an OS boundary runs this inside a sandbox that has one, and this
+ * comment is here so nobody concludes the worker was the boundary.
+ */
+/**
+ * The worker's own body, as source.
+ *
+ * Inlined rather than a separate file because a separate file has to be
+ * findable at runtime, and this package is consumed as `dist/` by hosts
+ * whose bundlers rewrite paths. A string has no path.
+ */
+const WORKER_SOURCE = `
+const { parentPort, workerData } = require('node:worker_threads')
+
+// Every host call is a request/response over the port, keyed by an id so
+// several can be in flight — a program that awaits two calls at once is
+// ordinary, and a channel that could only carry one would silently
+// serialise them.
+const pending = new Map()
+let nextId = 0
+
+function hostCall(name, input) {
+	const id = ++nextId
+	return new Promise((resolve, reject) => {
+		pending.set(id, { resolve, reject })
+		parentPort.postMessage({ kind: 'call', id, name, input })
+	})
+}
+
+// Posted as it happens, NOT batched until the end. A program that printed
+// its progress and then hung has told the host where it got to, and a
+// buffer that only ships on completion loses exactly the output a timeout
+// most needs to explain itself.
+function print(...parts) {
+	parentPort.postMessage({
+		kind: 'print',
+		line: parts.map((p) => (typeof p === 'string' ? p : JSON.stringify(p))).join(' '),
+	})
+}
+
+parentPort.on('message', (message) => {
+	if (message.kind !== 'call-result') return
+	const entry = pending.get(message.id)
+	if (!entry) return
+	pending.delete(message.id)
+	if (message.ok) entry.resolve(message.value)
+	else entry.reject(new Error(message.error))
+})
+
+async function main() {
+	// The scope the program runs in, and everything it has. Built with
+	// \`new Function\` over an explicit parameter list rather than with
+	// \`with\` or a Proxy: the parameters SHADOW the outer names, so a
+	// program writing \`require\` gets the parameter, and the parameter is
+	// undefined.
+	const names = ['call', 'print', 'require', 'process', 'module', 'exports', 'globalThis', 'fetch']
+	const values = [hostCall, print, undefined, undefined, undefined, undefined, undefined, undefined]
+	const body = new Function(...names, '"use strict";return (async () => {' + workerData.source + '\\n})()')
+	return await body(...values)
+}
+
+main().then(
+	(result) => parentPort.postMessage({ kind: 'done', result }),
+	(error) => parentPort.postMessage({ kind: 'error', error: String(error && error.message || error) }),
+)
+`;
+export class WorkerCodeRuntime {
+    id = 'worker_threads';
+    async run(options) {
+        const allowed = new Set(options.allowedCalls);
+        const calls = [];
+        let output = '';
+        let truncated = false;
+        const appendOutput = (lines) => {
+            for (const line of lines) {
+                if (truncated)
+                    return;
+                const next = output.length === 0 ? line : `${output}\n${line}`;
+                if (Buffer.byteLength(next) > options.maxOutputBytes) {
+                    // Cut at the LINE that would exceed, and say so. A cut
+                    // mid-JSON produces output a reader cannot parse and cannot
+                    // tell was cut.
+                    truncated = true;
+                    return;
+                }
+                output = next;
+            }
+        };
+        const worker = new Worker(WORKER_SOURCE, {
+            eval: true,
+            workerData: { source: options.source },
+            // Nothing from the host's environment.
+            //
+            // **Unobservable today, and kept deliberately.** `process` is
+            // shadowed in the program's scope, so nothing the program can
+            // write reaches `process.env` either way — a mutation removing
+            // this line passes every test, correctly. It is defence behind the
+            // shadowing rather than beside it: the shadowing is a
+            // language-level boundary, exactly as strong as the enumeration of
+            // what was withheld, and the day that enumeration misses something
+            // this is what the leak finds. The cost is one empty object.
+            env: {},
+            // No stdio inheritance: the program prints through `print`, which
+            // is bounded. A worker writing to the host's stdout would bypass
+            // the cap and interleave with the operator's own output.
+            stdout: true,
+            stderr: true,
+        });
+        return await new Promise((resolve) => {
+            let settled = false;
+            const finish = (result) => {
+                // The Promise already ignores a second `resolve`, so removing
+                // this guard changes no result — a mutation removing it
+                // survives, correctly. It is kept because it also stops a
+                // second `terminate()` and a second `clearTimeout` on a worker
+                // that has already gone, and because `finish` is called from
+                // four places whose ordering is decided by the worker: `done`
+                // then `exit` is the ordinary sequence, not an edge case.
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(deadline);
+                options.signal?.removeEventListener('abort', onAbort);
+                void worker.terminate();
+                resolve(result);
+            };
+            const deadline = setTimeout(() => {
+                finish({ outcome: { status: 'timed-out' }, output, outputTruncated: truncated, calls });
+            }, options.timeoutMs);
+            const onAbort = () => {
+                finish({ outcome: { status: 'cancelled' }, output, outputTruncated: truncated, calls });
+            };
+            options.signal?.addEventListener('abort', onAbort, { once: true });
+            if (options.signal?.aborted) {
+                onAbort();
+                return;
+            }
+            worker.on('message', (message) => {
+                if (message.kind === 'call') {
+                    const name = String(message.name);
+                    const id = message.id;
+                    if (!allowed.has(name)) {
+                        // Refused HERE, not in the worker. The allow-list lives on
+                        // the host side because a check inside the worker is a
+                        // check the program shares a heap with.
+                        calls.push({ name, ok: false });
+                        worker.postMessage({
+                            kind: 'call-result',
+                            id,
+                            ok: false,
+                            error: new HostCallDeniedError({ name, allowed: options.allowedCalls }).message,
+                        });
+                        return;
+                    }
+                    void options
+                        .onHostCall({ name, input: message.input })
+                        .then((result) => {
+                        calls.push({ name, ok: result.ok });
+                        worker.postMessage({
+                            kind: 'call-result',
+                            id,
+                            ok: result.ok,
+                            value: result.value,
+                            error: result.error,
+                        });
+                    })
+                        .catch((err) => {
+                        calls.push({ name, ok: false });
+                        worker.postMessage({
+                            kind: 'call-result',
+                            id,
+                            ok: false,
+                            error: err instanceof Error ? err.message : String(err),
+                        });
+                    });
+                    return;
+                }
+                if (message.kind === 'print') {
+                    appendOutput([String(message.line)]);
+                    return;
+                }
+                if (message.kind === 'done') {
+                    finish({
+                        outcome: { status: 'completed', result: message.result },
+                        output,
+                        outputTruncated: truncated,
+                        calls,
+                    });
+                    return;
+                }
+                if (message.kind === 'error') {
+                    finish({
+                        outcome: { status: 'failed', error: String(message.error) },
+                        output,
+                        outputTruncated: truncated,
+                        calls,
+                    });
+                }
+            });
+            worker.on('error', (err) => {
+                // A worker that died before reporting anything. Its output is
+                // whatever it had already sent, which is nothing — reporting an
+                // empty string here is honest rather than a loss.
+                finish({
+                    outcome: { status: 'failed', error: err.message },
+                    output,
+                    outputTruncated: truncated,
+                    calls,
+                });
+            });
+            worker.on('exit', (code) => {
+                // Only reached when the worker exited without a `done` or
+                // `error` message — a hard crash, or a program that called
+                // `process.exit` through something we failed to withhold.
+                finish({
+                    outcome: { status: 'failed', error: `The program exited with code ${code}.` },
+                    output,
+                    outputTruncated: truncated,
+                    calls,
+                });
+            });
+        });
+    }
+}
+//# sourceMappingURL=worker.js.map

package/dist/execution/code-runtime/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/execution/code-runtime/worker.ts"],"names":[],"mappings":"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"}

package/dist/{connector/execution → execution}/factory.d.ts

@@ -1,7 +1,7 @@
-import type { BaseExecutionContext } from '../../execution/base.js';
-import { LocalExecutionContext, type LocalExecutionContextOptions } from '../../execution/local.js';
-import type { ExecutionContextConfig } from '../../types/connector/index.js';
+import type { ExecutionContextConfig } from '../types/connector/index.js';
+import type { BaseExecutionContext } from './base.js';
 import { HybridExecutionContext, type HybridExecutionContextOptions } from './hybrid.js';
+import { LocalExecutionContext, type LocalExecutionContextOptions } from './local.js';
 import { RemoteExecutionContext, type RemoteExecutionContextOptions } from './remote.js';
 export declare class ExecutionContextFactory {
     static create(config: ExecutionContextConfig): BaseExecutionContext;

package/dist/execution/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/execution/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,MAAM,aAAa,CAAA;AACxF,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAExF,qBAAa,uBAAuB;IACnC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,oBAAoB;IAkCnE,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,4BAA4B,GAAG,qBAAqB;IAIhF,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,6BAA6B,GAAG,sBAAsB;IAInF,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,6BAA6B,GAAG,sBAAsB;CAGnF"}

package/dist/{connector/execution → execution}/factory.js

@@ -1,5 +1,5 @@
-import { LocalExecutionContext } from '../../execution/local.js';
 import { HybridExecutionContext } from './hybrid.js';
+import { LocalExecutionContext } from './local.js';
 import { RemoteExecutionContext } from './remote.js';
 export class ExecutionContextFactory {
     static create(config) {

package/dist/execution/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/execution/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAsC,MAAM,aAAa,CAAA;AACxF,OAAO,EAAE,qBAAqB,EAAqC,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,sBAAsB,EAAsC,MAAM,aAAa,CAAA;AAExF,MAAM,OAAO,uBAAuB;IACnC,MAAM,CAAC,MAAM,CAAC,MAA8B;QAC3C,QAAQ,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5B,KAAK,OAAO;gBACX,OAAO,uBAAuB,CAAC,WAAW,CAAC;oBAC1C,EAAE,EAAE,MAAM,CAAC,EAAE;oBACb,GAAG,EAAE,MAAM,CAAC,GAAG;oBACf,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,KAAK,EAAE,MAAM,CAAC,KAAK;iBACnB,CAAC,CAAA;YAEH,KAAK,QAAQ;gBACZ,OAAO,uBAAuB,CAAC,YAAY,CAAC;oBAC3C,EAAE,EAAE,MAAM,CAAC,EAAE;oBACb,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;iBACjC,CAAC,CAAA;YAEH,KAAK,QAAQ;gBACZ,OAAO,uBAAuB,CAAC,YAAY,CAAC;oBAC3C,EAAE,EAAE,MAAM,CAAC,EAAE;oBACb,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,eAAe,EAAE,MAAM,CAAC,eAAe;iBACvC,CAAC,CAAA;YAEH,OAAO,CAAC,CAAC,CAAC;gBACT,MAAM,WAAW,GAAU,MAAM,CAAA;gBACjC,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;YACnF,CAAC;QACF,CAAC;IACF,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,OAAqC;QACvD,OAAO,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAsC;QACzD,OAAO,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAsC;QACzD,OAAO,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAA;IAC3C,CAAC;CACD"}

package/dist/{connector/execution → execution}/hybrid.d.ts

@@ -1,6 +1,7 @@
-import { BaseExecutionContext } from '../../execution/base.js';
-import { LocalExecutionContext } from '../../execution/local.js';
-import type { CommandExecutor, CommandOptions, CommandResult, ExecutionCapability, ExecutionEnvironment, ExecutionRoutingStrategy, HybridExecutionContextConfig, RemoteTarget } from '../../types/connector/index.js';
+import type { CommandExecutor, CommandOptions, CommandResult, ExecutionCapability, ExecutionEnvironment, ExecutionRoutingStrategy, HybridExecutionContextConfig, RemoteTarget } from '../types/connector/index.js';
+import type { Logger } from '../utils/logger.js';
+import { BaseExecutionContext } from './base.js';
+import { LocalExecutionContext } from './local.js';
 import { RemoteExecutionContext } from './remote.js';
 export interface HybridExecutionContextOptions {
     id: string;
@@ -13,6 +14,7 @@ export interface HybridExecutionContextOptions {
     };
     remotes: RemoteTarget[];
     routingStrategy?: ExecutionRoutingStrategy;
+    log?: Logger;
 }
 export declare class HybridExecutionContext extends BaseExecutionContext implements CommandExecutor {
     readonly id: string;

package/dist/execution/hybrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../../src/execution/hybrid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,YAAY,EACZ,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEpD,MAAM,WAAW,6BAA6B;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE;QACN,GAAG,EAAE,MAAM,CAAA;QACX,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAA;QACpC,KAAK,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,eAAe,CAAC,EAAE,wBAAwB,CAAA;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,qBAAa,sBAAuB,SAAQ,oBAAqB,YAAW,eAAe;IAC1F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAW;IAErD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,UAAU,CAAiD;IACnE,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,eAAe,CAAI;gBAEf,OAAO,EAAE,6BAA6B;cA8BlC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAgB7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3C,QAAQ,IAAI,qBAAqB;IAIjC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAI/D,UAAU,IAAI,sBAAsB,EAAE;IAItC,kBAAkB,IAAI,wBAAwB;IAI9C,kBAAkB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAKtD,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQlC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrC,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IAwCzB,QAAQ,IAAI,4BAA4B;IAcxC,OAAO,CAAC,uBAAuB;IAS/B,OAAO,CAAC,oBAAoB;CAS5B"}

package/dist/{connector/execution → execution}/hybrid.js

@@ -1,5 +1,5 @@
-import { BaseExecutionContext } from '../../execution/base.js';
-import { LocalExecutionContext } from '../../execution/local.js';
+import { BaseExecutionContext } from './base.js';
+import { LocalExecutionContext } from './local.js';
 import { RemoteExecutionContext } from './remote.js';
 export class HybridExecutionContext extends BaseExecutionContext {
     id;
@@ -10,7 +10,7 @@ export class HybridExecutionContext extends BaseExecutionContext {
     routingStrategy;
     roundRobinIndex = 0;
     constructor(options) {
-        super();
+        super(options.log);
         this.id = options.id;
         this.remoteTargets = options.remotes;
         this.routingStrategy = options.routingStrategy ?? 'local-first';
@@ -21,6 +21,7 @@ export class HybridExecutionContext extends BaseExecutionContext {
             envVars: options.local.envVars,
             capabilities: options.local.capabilities,
             shell: options.local.shell,
+            log: options.log,
         });
         this.localCtx.on((event) => this.emit(event));
         for (const [i, target] of options.remotes.entries()) {
@@ -28,6 +29,7 @@ export class HybridExecutionContext extends BaseExecutionContext {
             const remote = new RemoteExecutionContext({
                 id: remoteId,
                 target,
+                log: options.log,
             });
             remote.on((event) => this.emit(event));
             this.remoteCtxs.set(remoteId, remote);
@@ -40,7 +42,11 @@ export class HybridExecutionContext extends BaseExecutionContext {
             initPromises.push(remote.initialize());
         }
         await Promise.all(initPromises);
-        this.log.info(`Hybrid context initialized: local(${this.localCtx.getCwd()}) + ${this.remoteCtxs.size} remote(s), strategy=${this.routingStrategy}`);
+        this.log.info('Hybrid context initialized', {
+            'namzu.execution.local_cwd': this.localCtx.getCwd(),
+            'namzu.execution.remote_count': this.remoteCtxs.size,
+            'namzu.execution.routing_strategy': this.routingStrategy,
+        });
     }
     async doTeardown() {
         const teardownPromises = [];

package/dist/execution/hybrid.js.map

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

package/dist/execution/index.d.ts

@@ -1,4 +1,27 @@
+/**
+ * Where a tool call actually runs.
+ *
+ * One concept sat in two directories: the base and the local backend here,
+ * the remote, hybrid and factory under `connector/execution/`, with
+ * `connector/index.ts` reaching into both to reassemble one public export
+ * group. A contributor adding a fifth backend had no principled place to
+ * put it, and either answer was defensible from where they were standing.
+ *
+ * They are all here now, and the direction was not free. Folding this down
+ * into `connector/` was the other option and it is wrong: `run/command-gate.ts`
+ * imports `LocalExecutionContext` directly, so execution is not
+ * connector-scoped — a connector is one CALLER of an execution context, not
+ * the thing that defines one. `connector/index.ts` re-exports from here so
+ * no consumer's import path changes.
+ *
+ * A sixth backend goes in this directory and is named in this file.
+ */
 export { BaseExecutionContext } from './base.js';
+export { ExecutionContextFactory } from './factory.js';
+export { HybridExecutionContext } from './hybrid.js';
+export type { HybridExecutionContextOptions } from './hybrid.js';
 export { LocalExecutionContext } from './local.js';
 export type { LocalExecutionContextOptions } from './local.js';
+export { RemoteExecutionContext } from './remote.js';
+export type { RemoteExecutionContextOptions } from './remote.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/execution/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,YAAY,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,YAAY,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,YAAY,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,YAAY,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA"}

package/dist/execution/index.js

@@ -1,3 +1,24 @@
+/**
+ * Where a tool call actually runs.
+ *
+ * One concept sat in two directories: the base and the local backend here,
+ * the remote, hybrid and factory under `connector/execution/`, with
+ * `connector/index.ts` reaching into both to reassemble one public export
+ * group. A contributor adding a fifth backend had no principled place to
+ * put it, and either answer was defensible from where they were standing.
+ *
+ * They are all here now, and the direction was not free. Folding this down
+ * into `connector/` was the other option and it is wrong: `run/command-gate.ts`
+ * imports `LocalExecutionContext` directly, so execution is not
+ * connector-scoped — a connector is one CALLER of an execution context, not
+ * the thing that defines one. `connector/index.ts` re-exports from here so
+ * no consumer's import path changes.
+ *
+ * A sixth backend goes in this directory and is named in this file.
+ */
 export { BaseExecutionContext } from './base.js';
+export { ExecutionContextFactory } from './factory.js';
+export { HybridExecutionContext } from './hybrid.js';
 export { LocalExecutionContext } from './local.js';
+export { RemoteExecutionContext } from './remote.js';
 //# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAElD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA"}

package/dist/execution/local.d.ts

@@ -1,5 +1,6 @@
 import type { LocalExecutionContextConfig } from '../types/connector/index.js';
 import type { CommandExecutor, CommandOptions, CommandResult, ExecutionCapability, ExecutionEnvironment } from '../types/execution/index.js';
+import type { Logger } from '../utils/logger.js';
 import { BaseExecutionContext } from './base.js';
 export interface LocalExecutionContextOptions {
     id: string;
@@ -8,6 +9,7 @@ export interface LocalExecutionContextOptions {
     envVars?: Record<string, string>;
     capabilities?: ExecutionCapability[];
     shell?: string;
+    log?: Logger;
 }
 export declare class LocalExecutionContext extends BaseExecutionContext implements CommandExecutor {
     readonly id: string;

package/dist/execution/local.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/execution/local.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAC9E,OAAO,KAAK,EACX,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAEhD,MAAM,WAAW,4BAA4B;IAC5C,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,qBAAsB,SAAQ,oBAAqB,YAAW,eAAe;IACzF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAU;IAEpD,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,KAAK,CAAoB;gBAErB,OAAO,EAAE,4BAA4B;cAUjC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAO7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3C,MAAM,IAAI,MAAM;IAIhB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ5B,WAAW,IAAI,OAAO;IAItB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAIzC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1C,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIpC,eAAe,IAAI,mBAAmB,EAAE;IAIxC,aAAa,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO;IAI1C,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IA4DzB,QAAQ,IAAI,2BAA2B;CAWvC"}
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/execution/local.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAC9E,OAAO,KAAK,EACX,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAEhD,MAAM,WAAW,4BAA4B;IAC5C,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,qBAAa,qBAAsB,SAAQ,oBAAqB,YAAW,eAAe;IACzF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAU;IAEpD,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,KAAK,CAAoB;gBAErB,OAAO,EAAE,4BAA4B;cAUjC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAO7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3C,MAAM,IAAI,MAAM;IAIhB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ5B,WAAW,IAAI,OAAO;IAItB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAIzC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1C,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIpC,eAAe,IAAI,mBAAmB,EAAE;IAIxC,aAAa,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO;IAI1C,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IA4DzB,QAAQ,IAAI,2BAA2B;CAWvC"}

package/dist/execution/local.js

@@ -11,7 +11,7 @@ export class LocalExecutionContext extends BaseExecutionContext {
     capabilities;
     shell;
     constructor(options) {
-        super();
+        super(options.log);
         this.id = options.id;
         this.cwd = resolve(options.cwd);
         this.fsAccess = options.fsAccess ?? true;
@@ -23,7 +23,7 @@ export class LocalExecutionContext extends BaseExecutionContext {
         if (!existsSync(this.cwd)) {
             throw new Error(`Working directory does not exist: ${this.cwd}`);
         }
-        this.log.info(`Local context initialized at ${this.cwd}`);
+        this.log.info('Local context initialized', { 'namzu.execution.cwd': this.cwd });
     }
     async doTeardown() { }
     getCwd() {

package/dist/execution/local.js.map

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

package/dist/{connector/execution → execution}/remote.d.ts

@@ -1,10 +1,12 @@
-import { BaseExecutionContext } from '../../execution/base.js';
-import type { CommandOptions, CommandResult, ExecutionCapability, ExecutionEnvironment, RemoteCommandHandler, RemoteExecutionContextConfig, RemoteTarget } from '../../types/connector/index.js';
+import type { CommandOptions, CommandResult, ExecutionCapability, ExecutionEnvironment, RemoteCommandHandler, RemoteExecutionContextConfig, RemoteTarget } from '../types/connector/index.js';
+import type { Logger } from '../utils/logger.js';
+import { BaseExecutionContext } from './base.js';
 export interface RemoteExecutionContextOptions {
     id: string;
     target: RemoteTarget;
     capabilities?: ExecutionCapability[];
     commandHandler?: RemoteCommandHandler;
+    log?: Logger;
 }
 export declare class RemoteExecutionContext extends BaseExecutionContext {
     readonly id: string;

package/dist/execution/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/execution/remote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,4BAA4B,EAC5B,YAAY,EACZ,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAEhD,MAAM,WAAW,6BAA6B;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,YAAY,CAAA;IACpB,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACpC,cAAc,CAAC,EAAE,oBAAoB,CAAA;IACrC,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,qBAAa,sBAAuB,SAAQ,oBAAoB;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAW;IAErD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAkC;gBAE5C,OAAO,EAAE,6BAA6B;cAQlC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;cAQ7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAcxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,WAAW,IAAI,OAAO;IAItB,SAAS,IAAI,YAAY;IAIzB,mBAAmB,IAAI,MAAM;IAK7B,eAAe,IAAI,mBAAmB,EAAE;IAIxC,aAAa,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO;IAIhD,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAIhD,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAYtF,QAAQ,IAAI,4BAA4B;IASxC,OAAO,CAAC,cAAc;CAQtB"}

package/dist/{connector/execution → execution}/remote.js

@@ -1,4 +1,4 @@
-import { BaseExecutionContext } from '../../execution/base.js';
+import { BaseExecutionContext } from './base.js';
 export class RemoteExecutionContext extends BaseExecutionContext {
     id;
     environment = 'remote';
@@ -7,7 +7,7 @@ export class RemoteExecutionContext extends BaseExecutionContext {
     capabilities;
     commandHandler;
     constructor(options) {
-        super();
+        super(options.log);
         this.id = options.id;
         this.target = options.target;
         this.capabilities = options.capabilities ?? ['network'];
@@ -15,7 +15,10 @@ export class RemoteExecutionContext extends BaseExecutionContext {
     }
     async doInitialize() {
         this.validateTarget(this.target);
-        this.log.info(`Remote context initialized for ${this.target.type}://${this.target.host}`);
+        this.log.info('Remote context initialized', {
+            'namzu.execution.target_type': this.target.type,
+            'namzu.execution.target_host': this.target.host,
+        });
     }
     async doTeardown() {
         if (this.connected) {
@@ -34,7 +37,11 @@ export class RemoteExecutionContext extends BaseExecutionContext {
             contextId: this.id,
             target: this.target,
         });
-        this.log.info(`Remote connected: ${this.target.type}://${this.target.host}:${this.target.port ?? 'default'}`);
+        this.log.info('Remote connected', {
+            'namzu.execution.target_type': this.target.type,
+            'namzu.execution.target_host': this.target.host,
+            'namzu.execution.target_port': this.target.port ?? 'default',
+        });
     }
     async disconnect() {
         if (!this.connected)
@@ -45,7 +52,7 @@ export class RemoteExecutionContext extends BaseExecutionContext {
             contextId: this.id,
             host: this.target.host,
         });
-        this.log.info(`Remote disconnected: ${this.target.host}`);
+        this.log.info('Remote disconnected', { 'namzu.execution.target_host': this.target.host });
     }
     isConnected() {
         return this.connected;

package/dist/execution/remote.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export type * from './public-types.js';
 export * from './public-runtime.js';
 export * from './public-tools.js';
+export { BackgroundJobLimitError, BackgroundJobRegistry, UnknownBackgroundJobError, bindOwner, } from './runtime/jobs/registry.js';
+export type { BackgroundJob, BackgroundJobOutput, BackgroundJobRegistryConfig, BackgroundJobStatus, StartJobParams, } from './runtime/jobs/registry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,mBAAmB,mBAAmB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,mBAAmB,mBAAmB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AAKjC,OAAO,EACN,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,SAAS,GACT,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACX,aAAa,EACb,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,EACnB,cAAc,GACd,MAAM,4BAA4B,CAAA"}

package/dist/index.js

@@ -7,4 +7,8 @@
 // here directly — extend the appropriate bucket file.
 export * from './public-runtime.js';
 export * from './public-tools.js';
+// Work that outlives a tool call, owned by whoever started it. The shell
+// cannot be trusted to background under the sandbox's PID namespace, so the
+// kernel holds the process itself. See `runtime/jobs/registry.ts`.
+export { BackgroundJobLimitError, BackgroundJobRegistry, UnknownBackgroundJobError, bindOwner, } from './runtime/jobs/registry.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,qEAAqE;AACrE,qFAAqF;AACrF,2EAA2E;AAC3E,EAAE;AACF,0EAA0E;AAC1E,sDAAsD;AAGtD,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,qEAAqE;AACrE,qFAAqF;AACrF,2EAA2E;AAC3E,EAAE;AACF,0EAA0E;AAC1E,sDAAsD;AAGtD,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AAEjC,yEAAyE;AACzE,4EAA4E;AAC5E,mEAAmE;AACnE,OAAO,EACN,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,SAAS,GACT,MAAM,4BAA4B,CAAA"}