@zackbart/connecta 0.7.1 → 0.7.4

package/dist/executor-admission.js

@@ -0,0 +1,151 @@
+/**
+ * A stable, machine-readable admission failure. Overload is retryable; caller
+ * cancellation and shutdown are terminal for this invocation.
+ */
+export class ExecutorAdmissionError extends Error {
+    code;
+    retryable;
+    retryAfterMs;
+    constructor(code, message, opts = {}) {
+        super(message);
+        this.code = code;
+        this.name = "ExecutorAdmissionError";
+        this.retryable = code === "executor_overloaded";
+        if (opts.retryAfterMs !== undefined &&
+            Number.isFinite(opts.retryAfterMs) &&
+            opts.retryAfterMs >= 0) {
+            this.retryAfterMs = Math.trunc(opts.retryAfterMs);
+        }
+    }
+}
+function positiveWhole(value, name) {
+    if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {
+        throw new TypeError(`${name} must be a positive whole number.`);
+    }
+    return value;
+}
+function nonNegativeWhole(value, name) {
+    if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+        throw new TypeError(`${name} must be a non-negative whole number.`);
+    }
+    return value;
+}
+/**
+ * Runtime-portable bounded admission. It deliberately owns no executor or
+ * request state: queued requests retain only a resolver and AbortSignal, while
+ * provider catalogs are constructed after the returned lease is granted.
+ */
+export class AdmissionController {
+    concurrency;
+    maxQueueSize;
+    queueTimeoutMs;
+    retryAfterMs;
+    active = 0;
+    closed = false;
+    waiters = [];
+    constructor(options) {
+        this.concurrency = positiveWhole(options.concurrency, "concurrency");
+        this.maxQueueSize = nonNegativeWhole(options.maxQueueSize, "maxQueueSize");
+        this.queueTimeoutMs = positiveWhole(options.queueTimeoutMs, "queueTimeoutMs");
+        this.retryAfterMs = nonNegativeWhole(options.retryAfterMs ?? this.queueTimeoutMs, "retryAfterMs");
+    }
+    get activeCount() {
+        return this.active;
+    }
+    get queuedCount() {
+        return this.waiters.length;
+    }
+    acquire(options = {}) {
+        if (this.closed) {
+            return Promise.reject(new ExecutorAdmissionError("executor_closed", "Executor is shutting down."));
+        }
+        if (options.signal?.aborted) {
+            return Promise.reject(new ExecutorAdmissionError("executor_cancelled", "Execution was cancelled before admission."));
+        }
+        if (this.active < this.concurrency) {
+            this.active++;
+            return Promise.resolve(this.makeLease());
+        }
+        if (this.waiters.length >= this.maxQueueSize) {
+            return Promise.reject(this.overloaded("Executor queue is full."));
+        }
+        return new Promise((resolve, reject) => {
+            const waiter = {
+                resolve,
+                reject,
+                ...(options.signal ? { signal: options.signal } : {}),
+            };
+            waiter.onAbort = () => {
+                if (!this.remove(waiter))
+                    return;
+                this.cleanup(waiter);
+                reject(new ExecutorAdmissionError("executor_cancelled", "Execution was cancelled while queued."));
+            };
+            options.signal?.addEventListener("abort", waiter.onAbort, { once: true });
+            waiter.timer = setTimeout(() => {
+                if (!this.remove(waiter))
+                    return;
+                this.cleanup(waiter);
+                reject(this.overloaded(`Executor admission timed out after ${this.queueTimeoutMs}ms.`));
+            }, this.queueTimeoutMs);
+            this.waiters.push(waiter);
+        });
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const waiter of this.waiters.splice(0)) {
+            this.cleanup(waiter);
+            waiter.reject(new ExecutorAdmissionError("executor_closed", "Executor is shutting down."));
+        }
+    }
+    overloaded(message) {
+        return new ExecutorAdmissionError("executor_overloaded", message, {
+            retryAfterMs: this.retryAfterMs,
+        });
+    }
+    makeLease() {
+        let released = false;
+        return {
+            release: () => {
+                if (released)
+                    return;
+                released = true;
+                this.release();
+            },
+        };
+    }
+    release() {
+        if (this.active > 0)
+            this.active--;
+        if (this.closed)
+            return;
+        const waiter = this.waiters.shift();
+        if (!waiter)
+            return;
+        this.cleanup(waiter);
+        this.active++;
+        waiter.resolve(this.makeLease());
+    }
+    remove(waiter) {
+        const index = this.waiters.indexOf(waiter);
+        if (index < 0)
+            return false;
+        this.waiters.splice(index, 1);
+        return true;
+    }
+    cleanup(waiter) {
+        if (waiter.timer !== undefined)
+            clearTimeout(waiter.timer);
+        if (waiter.onAbort) {
+            waiter.signal?.removeEventListener("abort", waiter.onAbort);
+        }
+    }
+}
+/** Preserve the one-method Workers seam while recognizing richer Node executors. */
+export function isAdmittingExecutor(executor) {
+    return ("acquire" in executor &&
+        typeof executor.acquire === "function");
+}
+//# sourceMappingURL=executor-admission.js.map

package/dist/executor-admission.js.map

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

package/dist/executor-result.d.ts

@@ -0,0 +1,13 @@
+import type { ExecuteResult } from "./types.js";
+/** ~6k tokens. Sandbox code should filter data down before returning. */
+export declare const MAX_EXECUTE_RESULT_CHARS = 24000;
+export declare const MAX_EXECUTE_LOG_CHARS = 4000;
+export declare function serializeExecuteValue(value: unknown): string;
+export declare function guardExecuteResultValue(value: unknown): unknown;
+export declare function truncateExecuteText(text: string, max: number): string;
+/**
+ * Apply the public execute_code result/log policy before a child result enters
+ * IPC. The parent repeats the guard for third-party Executor implementations.
+ */
+export declare function prepareExecuteResultForTransport(outcome: ExecuteResult): ExecuteResult;
+//# sourceMappingURL=executor-result.d.ts.map

package/dist/executor-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-result.d.ts","sourceRoot":"","sources":["../src/executor-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAM3C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG5D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS/D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,aAAa,GACrB,aAAa,CAyBf"}

package/dist/executor-result.js

@@ -0,0 +1,57 @@
+/** ~6k tokens. Sandbox code should filter data down before returning. */
+export const MAX_EXECUTE_RESULT_CHARS = 24_000;
+export const MAX_EXECUTE_LOG_CHARS = 4_000;
+function msg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+export function serializeExecuteValue(value) {
+    const serialized = JSON.stringify(value, null, 2);
+    return serialized === undefined ? String(value) : serialized;
+}
+export function guardExecuteResultValue(value) {
+    const text = serializeExecuteValue(value);
+    if (text.length <= MAX_EXECUTE_RESULT_CHARS)
+        return value;
+    return {
+        truncated: true,
+        preview: text.slice(0, MAX_EXECUTE_RESULT_CHARS),
+        totalChars: text.length,
+        hint: "filter/map/slice data inside execute_code and return only what you need",
+    };
+}
+export function truncateExecuteText(text, max) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max)}\n--- TRUNCATED (${text.length} chars total) — filter/map/slice data inside your code and return only what you need ---`;
+}
+/**
+ * Apply the public execute_code result/log policy before a child result enters
+ * IPC. The parent repeats the guard for third-party Executor implementations.
+ */
+export function prepareExecuteResultForTransport(outcome) {
+    // QuickJS already bounds captured logs at source (entries + cumulative
+    // characters). Preserve that Executor-level shape; createExecuteTool applies
+    // the smaller model-facing 4k presentation cap in the parent.
+    const logs = outcome.logs && outcome.logs.length > 0 ? outcome.logs : undefined;
+    if (outcome.error) {
+        return {
+            result: undefined,
+            error: outcome.error,
+            ...(logs ? { logs } : {}),
+        };
+    }
+    try {
+        return {
+            result: guardExecuteResultValue(outcome.result),
+            ...(logs ? { logs } : {}),
+        };
+    }
+    catch (err) {
+        return {
+            result: undefined,
+            error: `result is not JSON-serializable: ${msg(err)}`,
+            ...(logs ? { logs } : {}),
+        };
+    }
+}
+//# sourceMappingURL=executor-result.js.map

package/dist/executor-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-result.js","sourceRoot":"","sources":["../src/executor-result.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAE3C,SAAS,GAAG,CAAC,GAAY;IACvB,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAClD,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,IAAI,CAAC,MAAM,IAAI,wBAAwB;QAAE,OAAO,KAAK,CAAC;IAC1D,OAAO;QACL,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,CAAC;QAChD,UAAU,EAAE,IAAI,CAAC,MAAM;QACvB,IAAI,EAAE,yEAAyE;KAChF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,GAAW;IAC3D,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,oBAAoB,IAAI,CAAC,MAAM,0FAA0F,CAAC;AACxJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAAsB;IAEtB,uEAAuE;IACvE,6EAA6E;IAC7E,8DAA8D;IAC9D,MAAM,IAAI,GACR,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1B,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO;YACL,MAAM,EAAE,uBAAuB,CAAC,OAAO,CAAC,MAAM,CAAC;YAC/C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,oCAAoC,GAAG,CAAC,GAAG,CAAC,EAAE;YACrD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/executors/quickjs-child.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=quickjs-child.d.ts.map

package/dist/executors/quickjs-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickjs-child.d.ts","sourceRoot":"","sources":["../../src/executors/quickjs-child.ts"],"names":[],"mappings":""}

package/dist/executors/quickjs-child.js

@@ -0,0 +1,131 @@
+import { prepareExecuteResultForTransport } from "../executor-result.js";
+import { MAX_QUICKJS_IPC_BYTES, MAX_QUICKJS_HOST_RPC_BYTES, serializedBytes, stringifyBounded, } from "./quickjs-protocol.js";
+import { executeQuickJs, prepareQuickJs } from "./quickjs-runtime.js";
+let activeJobId;
+let nextCallId = 1;
+const pending = new Map();
+function msg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function send(message) {
+    if (!process.send)
+        throw new Error("QuickJS child IPC channel is unavailable.");
+    // Bound the actual process.send envelope, not only its nested payloadJson.
+    // Guest-controlled strings must be rejected while they are still isolated
+    // in this disposable process, before Node materializes them in the parent.
+    stringifyBounded(message, "QuickJS child IPC envelope");
+    process.send(message);
+}
+function provider(name, jobId) {
+    const functions = new Proxy(Object.create(null), {
+        get: (_target, key) => {
+            if (typeof key !== "string")
+                return undefined;
+            return async (...args) => {
+                const callId = nextCallId++;
+                const payloadJson = stringifyBounded({
+                    namespace: name,
+                    functionName: key,
+                    args,
+                }, "Host call payload", MAX_QUICKJS_HOST_RPC_BYTES);
+                const result = new Promise((resolve, reject) => {
+                    pending.set(callId, { resolve, reject });
+                });
+                send({
+                    type: "host-call",
+                    jobId,
+                    callId,
+                    payloadJson,
+                });
+                return result;
+            };
+        },
+        getOwnPropertyDescriptor: (_target, key) => typeof key === "string"
+            ? { configurable: true, enumerable: false }
+            : undefined,
+    });
+    return { name, fns: functions };
+}
+function fixedTransportFailure(message) {
+    return {
+        outcome: {
+            result: undefined,
+            error: message.slice(0, 4_000),
+        },
+    };
+}
+async function run(payload) {
+    if (activeJobId !== undefined) {
+        throw new Error("QuickJS child received overlapping executions.");
+    }
+    activeJobId = payload.id;
+    try {
+        const providers = payload.providerNames.map((name) => provider(name, payload.id));
+        const raw = await executeQuickJs(payload.code, providers, payload.options);
+        const prepared = {
+            outcome: prepareExecuteResultForTransport(raw),
+            ...(raw.timedOut ? { timedOut: true } : {}),
+        };
+        let payloadJson;
+        try {
+            payloadJson = stringifyBounded(prepared, "QuickJS execution result");
+        }
+        catch (err) {
+            payloadJson = JSON.stringify(fixedTransportFailure(`QuickJS execution result exceeded the ${MAX_QUICKJS_IPC_BYTES}-byte IPC limit: ${msg(err)}`));
+        }
+        send({ type: "result", jobId: payload.id, payloadJson });
+    }
+    finally {
+        activeJobId = undefined;
+        for (const request of pending.values()) {
+            request.reject(new Error("Execution ended before the host call settled."));
+        }
+        pending.clear();
+    }
+}
+process.on("message", (message) => {
+    if (!message || typeof message !== "object")
+        return;
+    if (message.type === "host-result") {
+        if (message.jobId !== activeJobId)
+            return;
+        const request = pending.get(message.callId);
+        if (!request)
+            return;
+        pending.delete(message.callId);
+        if (serializedBytes(message.payloadJson) > MAX_QUICKJS_HOST_RPC_BYTES) {
+            request.reject(new Error("Host result exceeded the IPC limit."));
+            return;
+        }
+        try {
+            const result = JSON.parse(message.payloadJson);
+            if (result.ok)
+                request.resolve(result.value);
+            else
+                request.reject(new Error(result.error));
+        }
+        catch (err) {
+            request.reject(new Error(`Invalid host result: ${msg(err)}`));
+        }
+        return;
+    }
+    if (message.type !== "run")
+        return;
+    if (serializedBytes(message.payloadJson) > MAX_QUICKJS_IPC_BYTES) {
+        throw new Error("Run payload exceeded the IPC limit.");
+    }
+    const payload = JSON.parse(message.payloadJson);
+    void run(payload).catch((err) => {
+        const payloadJson = JSON.stringify(fixedTransportFailure(`QuickJS child failed: ${msg(err)}`));
+        send({ type: "result", jobId: payload.id, payloadJson });
+        activeJobId = undefined;
+    });
+});
+process.on("disconnect", () => process.exit(0));
+// The parent does not start an execution's wall budget until the trusted WASM
+// module is loaded. This keeps cold-start latency from being misclassified as
+// guest CPU/wall failure while the parent's startup timeout still bounds a
+// child that never becomes ready.
+await prepareQuickJs();
+send({ type: "ready" });
+//# sourceMappingURL=quickjs-child.js.map

package/dist/executors/quickjs-child.js.map

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

package/dist/executors/quickjs-protocol.d.ts

@@ -0,0 +1,55 @@
+import type { ExecuteResult } from "../types.js";
+import type { QuickJsRuntimeOptions } from "./quickjs-runtime.js";
+export declare const MAX_QUICKJS_IPC_BYTES: number;
+/** Preserve #84's stopgap before a host value enters the child/WASM process. */
+export declare const MAX_QUICKJS_HOST_RPC_BYTES: number;
+export interface RunPayload {
+    id: number;
+    code: string;
+    providerNames: string[];
+    options: QuickJsRuntimeOptions;
+}
+export type ParentToChildMessage = {
+    type: "run";
+    payloadJson: string;
+} | {
+    type: "host-result";
+    jobId: number;
+    callId: number;
+    payloadJson: string;
+};
+export type ChildToParentMessage = {
+    type: "ready";
+} | {
+    type: "host-call";
+    jobId: number;
+    callId: number;
+    payloadJson: string;
+} | {
+    type: "result";
+    jobId: number;
+    payloadJson: string;
+};
+export interface HostCallPayload {
+    namespace: string;
+    functionName: string;
+    args: unknown[];
+}
+export type HostResultPayload = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+export interface ExecutionPayload {
+    outcome: ExecuteResult;
+    /**
+     * Set by the runtime on wall-clock expiry. The parent recycles the child on
+     * this flag, never on error text a guest can fabricate.
+     */
+    timedOut?: boolean;
+}
+export declare function serializedBytes(text: string): number;
+export declare function stringifyBounded(value: unknown, label: string, limit?: number): string;
+//# sourceMappingURL=quickjs-protocol.d.ts.map

package/dist/executors/quickjs-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickjs-protocol.d.ts","sourceRoot":"","sources":["../../src/executors/quickjs-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAMlE,eAAO,MAAM,qBAAqB,QAAc,CAAC;AACjD,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,QAAa,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACpC;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,KAAK,SAAwB,GAC5B,MAAM,CAYR"}

package/dist/executors/quickjs-protocol.js

@@ -0,0 +1,22 @@
+// The guest result is shaped to 24k characters before transport and QuickJS
+// capture already bounds logs to 256k characters. Every complete message is
+// measured against this ceiling before process.send; one MiB leaves room for
+// multibyte log text and envelope escaping while remaining a hard IPC bound.
+export const MAX_QUICKJS_IPC_BYTES = 1024 * 1024;
+/** Preserve #84's stopgap before a host value enters the child/WASM process. */
+export const MAX_QUICKJS_HOST_RPC_BYTES = 256 * 1024;
+export function serializedBytes(text) {
+    return new TextEncoder().encode(text).length;
+}
+export function stringifyBounded(value, label, limit = MAX_QUICKJS_IPC_BYTES) {
+    const json = JSON.stringify(value);
+    if (json === undefined) {
+        throw new TypeError(`${label} is not JSON-serializable.`);
+    }
+    const bytes = serializedBytes(json);
+    if (bytes > limit) {
+        throw new RangeError(`${label} is ${bytes} UTF-8 bytes, over the ${limit}-byte IPC limit.`);
+    }
+    return json;
+}
+//# sourceMappingURL=quickjs-protocol.js.map

package/dist/executors/quickjs-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickjs-protocol.js","sourceRoot":"","sources":["../../src/executors/quickjs-protocol.ts"],"names":[],"mappings":"AAGA,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAAC;AACjD,gFAAgF;AAChF,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,GAAG,IAAI,CAAC;AA+CrD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,KAAa,EACb,KAAK,GAAG,qBAAqB;IAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,4BAA4B,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,UAAU,CAClB,GAAG,KAAK,OAAO,KAAK,0BAA0B,KAAK,kBAAkB,CACtE,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/executors/quickjs-runtime.d.ts

@@ -0,0 +1,26 @@
+import type { ExecuteResult, ExecutorProvider } from "../types.js";
+export interface QuickJsRuntimeOptions {
+    timeoutMs: number;
+    cpuTimeMs: number;
+    memoryLimitBytes: number;
+    maxStackSizeBytes: number;
+}
+/** Load and compile the shared QuickJS WASM module before a run budget starts. */
+export declare function prepareQuickJs(): Promise<void>;
+/** Normalize model output into an async-arrow expression: strip markdown fences, wrap bare bodies. */
+export declare function normalizeCode(code: string): string;
+/**
+ * ExecuteResult plus a structural wall-expiry marker. Guest errors flow through
+ * formatGuestError verbatim, so the timeout message text is forgeable; this
+ * flag is set only by the return sites below and never from guest values.
+ */
+export interface QuickJsExecutionResult extends ExecuteResult {
+    timedOut?: boolean;
+}
+/**
+ * Execute one program inside the child. Wall time includes host waits; guest
+ * CPU accumulates only while evalCode/executePendingJobs is synchronously
+ * driving QuickJS, so a slow downstream does not consume the short CPU budget.
+ */
+export declare function executeQuickJs(code: string, providers: ExecutorProvider[], options: QuickJsRuntimeOptions): Promise<QuickJsExecutionResult>;
+//# sourceMappingURL=quickjs-runtime.d.ts.map

package/dist/executors/quickjs-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickjs-runtime.d.ts","sourceRoot":"","sources":["../../src/executors/quickjs-runtime.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,kFAAkF;AAClF,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AA4CD,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUlD;AAyLD;;;;GAIG;AACH,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,gBAAgB,EAAE,EAC7B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CA0JjC"}