@mcploom/codexec-quickjs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mouaad Aallam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @mcploom/codexec-quickjs
+
+QuickJS executor package for `@mcploom/codexec`.
+
+## Install
+
+```bash
+npm install @mcploom/codexec @mcploom/codexec-quickjs
+```
+
+Use this package when you want the smallest, easiest-to-install executor backend for codexec.
+
+## Usage
+
+```ts
+import { resolveProvider } from "@mcploom/codexec";
+import { QuickJsExecutor } from "@mcploom/codexec-quickjs";
+
+const provider = resolveProvider({
+  tools: {
+    echo: {
+      execute: async (input) => input,
+    },
+  },
+});
+
+const executor = new QuickJsExecutor();
+const result = await executor.execute("await codemode.echo({ ok: true })", [
+  provider,
+]);
+```
+
+Each execution runs in a fresh QuickJS runtime with captured `console.*` output, timeout handling, and JSON-only tool/result boundaries.

package/dist/index.cjs

@@ -0,0 +1,314 @@
+let quickjs_emscripten = require("quickjs-emscripten");
+let __mcploom_codexec = require("@mcploom/codexec");
+
+//#region src/quickjsBridge.ts
+function formatLogValue(value) {
+	if (typeof value === "string") return value;
+	if (value === void 0) return "undefined";
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return String(value);
+	}
+}
+function formatConsoleLine(values) {
+	return values.map((value) => formatLogValue(value)).join(" ");
+}
+function createGuestErrorHandle(context, code, message) {
+	const errorHandle = context.newError({
+		message,
+		name: "Error"
+	});
+	const codeHandle = context.newString(code);
+	context.setProp(errorHandle, "code", codeHandle);
+	codeHandle.dispose();
+	return errorHandle;
+}
+function fromGuestHandle(context, handle) {
+	const guestType = context.typeof(handle);
+	if (guestType === "undefined") return;
+	if (guestType === "function" || guestType === "symbol" || guestType === "bigint") throw new __mcploom_codexec.ExecuteFailure("serialization_error", "Guest code returned a non-serializable value");
+	const jsonHandle = context.getProp(context.global, "JSON");
+	const stringifyHandle = context.getProp(jsonHandle, "stringify");
+	try {
+		const stringified = context.unwrapResult(context.callFunction(stringifyHandle, jsonHandle, handle));
+		if (context.typeof(stringified) === "undefined") throw new __mcploom_codexec.ExecuteFailure("serialization_error", "Guest code returned a non-serializable value");
+		const jsonValue = context.getString(stringified);
+		return JSON.parse(jsonValue);
+	} catch (error) {
+		if (error instanceof __mcploom_codexec.ExecuteFailure) throw error;
+		throw new __mcploom_codexec.ExecuteFailure("serialization_error", "Guest code returned a non-serializable value");
+	} finally {
+		stringifyHandle.dispose();
+		jsonHandle.dispose();
+	}
+}
+function toGuestHandle(context, value) {
+	if (value === void 0) return context.undefined;
+	const jsonValue = JSON.stringify(value);
+	if (jsonValue === void 0) throw new __mcploom_codexec.ExecuteFailure("serialization_error", "Host value is not JSON-serializable");
+	return context.unwrapResult(context.evalCode(`(${jsonValue})`, "host-value.json"));
+}
+
+//#endregion
+//#region src/quickjsExecutor.ts
+const DEFAULT_MEMORY_LIMIT_BYTES = 64 * 1024 * 1024;
+const DEFAULT_TIMEOUT_MS = 5e3;
+const DEFAULT_MAX_LOG_LINES = 100;
+const DEFAULT_MAX_LOG_CHARS = 64e3;
+const loadDefaultModule = (0, quickjs_emscripten.memoizePromiseFactory)(() => (0, quickjs_emscripten.newQuickJSWASMModule)(quickjs_emscripten.RELEASE_SYNC));
+function isKnownErrorCode(value) {
+	return value === "timeout" || value === "memory_limit" || value === "validation_error" || value === "tool_error" || value === "runtime_error" || value === "serialization_error" || value === "internal_error";
+}
+function normalizeThrownMessage(error) {
+	if (error instanceof Error) return error.message;
+	return String(error);
+}
+function toExecuteError(error, deadline) {
+	if ((0, __mcploom_codexec.isExecuteFailure)(error)) return {
+		code: error.code,
+		message: error.message
+	};
+	const message = normalizeThrownMessage(error);
+	if (Date.now() > deadline || message.includes("interrupted")) return {
+		code: "timeout",
+		message: "Execution timed out"
+	};
+	if (message.toLowerCase().includes("out of memory")) return {
+		code: "memory_limit",
+		message
+	};
+	return {
+		code: "runtime_error",
+		message
+	};
+}
+function errorFromGuestHandle(context, handle, deadline) {
+	const codeHandle = context.getProp(handle, "code");
+	const messageHandle = context.getProp(handle, "message");
+	try {
+		const code = context.typeof(codeHandle) === "string" ? context.getString(codeHandle) : void 0;
+		const message = context.typeof(messageHandle) === "string" ? context.getString(messageHandle) : normalizeThrownMessage(context.dump(handle));
+		if (isKnownErrorCode(code)) return {
+			code,
+			message
+		};
+		return toExecuteError(message, deadline);
+	} finally {
+		codeHandle.dispose();
+		messageHandle.dispose();
+	}
+}
+function truncateLogs(logs, maxLogLines, maxLogChars) {
+	const limitedLines = logs.slice(0, maxLogLines);
+	let remainingChars = maxLogChars;
+	const truncated = [];
+	for (const line of limitedLines) {
+		if (remainingChars <= 0) break;
+		if (line.length <= remainingChars) {
+			truncated.push(line);
+			remainingChars -= line.length;
+			continue;
+		}
+		truncated.push(line.slice(0, remainingChars));
+		break;
+	}
+	return truncated;
+}
+function createExecutionContext(signal, providerName, safeToolName, originalToolName) {
+	return {
+		originalToolName,
+		providerName,
+		safeToolName,
+		signal
+	};
+}
+async function waitForPromiseSettlement(runtime, promise, deadline) {
+	let settled = false;
+	let rejection;
+	promise.then(() => {
+		settled = true;
+	}, (error) => {
+		settled = true;
+		rejection = error;
+	});
+	while (!settled) {
+		if (Date.now() > deadline) throw new __mcploom_codexec.ExecuteFailure("timeout", "Execution timed out");
+		const pendingJobsResult = runtime.executePendingJobs(-1);
+		if ((0, quickjs_emscripten.isFail)(pendingJobsResult)) {
+			const pendingError = pendingJobsResult.error;
+			try {
+				const executeError = errorFromGuestHandle(pendingError.context, pendingError, deadline);
+				throw new __mcploom_codexec.ExecuteFailure(executeError.code, executeError.message);
+			} finally {
+				pendingError.dispose();
+			}
+		}
+		await new Promise((resolve) => setTimeout(resolve, 0));
+	}
+	if (rejection !== void 0) throw rejection;
+}
+function injectConsole(context, logs) {
+	const consoleHandle = context.newObject();
+	try {
+		for (const methodName of [
+			"log",
+			"info",
+			"warn",
+			"error"
+		]) {
+			const methodHandle = context.newFunction(methodName, (...args) => {
+				logs.push(formatConsoleLine(args.map((arg) => context.dump(arg))));
+				return context.undefined;
+			});
+			context.setProp(consoleHandle, methodName, methodHandle);
+			methodHandle.dispose();
+		}
+		context.setProp(context.global, "console", consoleHandle);
+	} finally {
+		consoleHandle.dispose();
+	}
+}
+function injectProviders(context, providers, signal) {
+	for (const provider of providers) {
+		const providerHandle = context.newObject();
+		try {
+			for (const [safeToolName, descriptor] of Object.entries(provider.tools)) {
+				const toolHandle = createToolHandle(context, provider, descriptor, safeToolName, signal);
+				context.setProp(providerHandle, safeToolName, toolHandle);
+				toolHandle.dispose();
+			}
+			context.setProp(context.global, provider.name, providerHandle);
+		} finally {
+			providerHandle.dispose();
+		}
+	}
+}
+function createToolHandle(context, provider, descriptor, safeToolName, signal) {
+	return context.newFunction(safeToolName, (...args) => {
+		const deferred = context.newPromise();
+		const input = args[0] === void 0 ? void 0 : context.dump(args[0]);
+		const executionContext = createExecutionContext(signal, provider.name, safeToolName, descriptor.originalName);
+		Promise.resolve().then(async () => descriptor.execute(input, executionContext)).then((result) => {
+			if (!context.alive || !deferred.alive) return;
+			let resultHandle;
+			try {
+				resultHandle = toGuestHandle(context, result);
+				deferred.resolve(resultHandle);
+			} catch (error) {
+				const executeError = toExecuteError(error, Number.POSITIVE_INFINITY);
+				const errorHandle = createGuestErrorHandle(context, executeError.code, executeError.message);
+				deferred.reject(errorHandle);
+				errorHandle.dispose();
+			} finally {
+				resultHandle?.dispose();
+				deferred.dispose();
+			}
+		}).catch((error) => {
+			if (!context.alive || !deferred.alive) return;
+			const executeError = toExecuteError(error, Number.POSITIVE_INFINITY);
+			const errorHandle = createGuestErrorHandle(context, executeError.code, executeError.message);
+			deferred.reject(errorHandle);
+			errorHandle.dispose();
+			deferred.dispose();
+		});
+		return deferred.handle;
+	});
+}
+/**
+* QuickJS-backed executor for one-shot sandboxed JavaScript runs.
+*/
+var QuickJsExecutor = class {
+	loadModule;
+	maxLogChars;
+	maxLogLines;
+	memoryLimitBytes;
+	timeoutMs;
+	constructor(options = {}) {
+		this.loadModule = async () => {
+			return options.loadModule ? await options.loadModule() : await loadDefaultModule();
+		};
+		this.maxLogChars = options.maxLogChars ?? DEFAULT_MAX_LOG_CHARS;
+		this.maxLogLines = options.maxLogLines ?? DEFAULT_MAX_LOG_LINES;
+		this.memoryLimitBytes = options.memoryLimitBytes ?? DEFAULT_MEMORY_LIMIT_BYTES;
+		this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	}
+	/**
+	* Executes JavaScript against the provided tool namespaces in a fresh QuickJS runtime.
+	*/
+	async execute(code, providers) {
+		const startedAt = Date.now();
+		const deadline = startedAt + this.timeoutMs;
+		const logs = [];
+		const abortController = new AbortController();
+		const runtime = (await this.loadModule()).newRuntime();
+		runtime.setMemoryLimit(this.memoryLimitBytes);
+		runtime.setInterruptHandler((0, quickjs_emscripten.shouldInterruptAfterDeadline)(deadline));
+		const context = runtime.newContext();
+		try {
+			injectConsole(context, logs);
+			injectProviders(context, providers, abortController.signal);
+			const executableSource = (0, __mcploom_codexec.normalizeCode)(code);
+			const functionHandle = context.unwrapResult(context.evalCode(`(${executableSource})`, "sandbox-user-code.js"));
+			try {
+				const promiseHandle = context.unwrapResult(context.callFunction(functionHandle, context.undefined));
+				try {
+					const promiseResult = context.resolvePromise(promiseHandle);
+					await waitForPromiseSettlement(runtime, promiseResult, deadline);
+					const settledResult = await promiseResult;
+					if ((0, quickjs_emscripten.isFail)(settledResult)) {
+						const errorHandle = settledResult.error;
+						try {
+							return {
+								durationMs: Date.now() - startedAt,
+								error: errorFromGuestHandle(context, errorHandle, deadline),
+								logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),
+								ok: false
+							};
+						} finally {
+							errorHandle.dispose();
+						}
+					}
+					try {
+						const value = fromGuestHandle(context, settledResult.value);
+						return {
+							durationMs: Date.now() - startedAt,
+							logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),
+							ok: true,
+							result: value
+						};
+					} catch (error) {
+						return {
+							durationMs: Date.now() - startedAt,
+							error: toExecuteError(error, deadline),
+							logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),
+							ok: false
+						};
+					} finally {
+						settledResult.value.dispose();
+					}
+				} finally {
+					promiseHandle.dispose();
+				}
+			} finally {
+				functionHandle.dispose();
+			}
+		} catch (error) {
+			abortController.abort();
+			return {
+				durationMs: Date.now() - startedAt,
+				error: toExecuteError(error, deadline),
+				logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),
+				ok: false
+			};
+		} finally {
+			abortController.abort();
+			context.dispose();
+			runtime.dispose();
+		}
+	}
+};
+
+//#endregion
+exports.QuickJsExecutor = QuickJsExecutor;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["ExecuteFailure","RELEASE_SYNC","truncated: string[]","rejection: unknown","ExecuteFailure","resultHandle: QuickJSHandle | undefined","logs: string[]"],"sources":["../src/quickjsBridge.ts","../src/quickjsExecutor.ts"],"sourcesContent":["import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\n\nimport { ExecuteFailure, type ExecuteErrorCode } from \"@mcploom/codexec\";\n\nfunction formatLogValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (value === undefined) {\n    return \"undefined\";\n  }\n\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\nexport function formatConsoleLine(values: unknown[]): string {\n  return values.map((value) => formatLogValue(value)).join(\" \");\n}\n\nexport function createGuestErrorHandle(\n  context: QuickJSContext,\n  code: ExecuteErrorCode,\n  message: string,\n): QuickJSHandle {\n  const errorHandle = context.newError({ message, name: \"Error\" });\n  const codeHandle = context.newString(code);\n  context.setProp(errorHandle, \"code\", codeHandle);\n  codeHandle.dispose();\n  return errorHandle;\n}\n\nexport function fromGuestHandle(\n  context: QuickJSContext,\n  handle: QuickJSHandle,\n): unknown {\n  const guestType = context.typeof(handle);\n\n  if (guestType === \"undefined\") {\n    return undefined;\n  }\n\n  if (\n    guestType === \"function\" ||\n    guestType === \"symbol\" ||\n    guestType === \"bigint\"\n  ) {\n    throw new ExecuteFailure(\n      \"serialization_error\",\n      \"Guest code returned a non-serializable value\",\n    );\n  }\n\n  const jsonHandle = context.getProp(context.global, \"JSON\");\n  const stringifyHandle = context.getProp(jsonHandle, \"stringify\");\n\n  try {\n    const stringified = context.unwrapResult(\n      context.callFunction(stringifyHandle, jsonHandle, handle),\n    );\n    const stringifiedType = context.typeof(stringified);\n\n    if (stringifiedType === \"undefined\") {\n      throw new ExecuteFailure(\n        \"serialization_error\",\n        \"Guest code returned a non-serializable value\",\n      );\n    }\n\n    const jsonValue = context.getString(stringified);\n    return JSON.parse(jsonValue);\n  } catch (error) {\n    if (error instanceof ExecuteFailure) {\n      throw error;\n    }\n\n    throw new ExecuteFailure(\n      \"serialization_error\",\n      \"Guest code returned a non-serializable value\",\n    );\n  } finally {\n    stringifyHandle.dispose();\n    jsonHandle.dispose();\n  }\n}\n\nexport function toGuestHandle(\n  context: QuickJSContext,\n  value: unknown,\n): QuickJSHandle {\n  if (value === undefined) {\n    return context.undefined;\n  }\n\n  const jsonValue = JSON.stringify(value);\n\n  if (jsonValue === undefined) {\n    throw new ExecuteFailure(\n      \"serialization_error\",\n      \"Host value is not JSON-serializable\",\n    );\n  }\n\n  return context.unwrapResult(\n    context.evalCode(`(${jsonValue})`, \"host-value.json\"),\n  );\n}\n","import {\n  RELEASE_SYNC,\n  isFail,\n  memoizePromiseFactory,\n  newQuickJSWASMModule,\n  shouldInterruptAfterDeadline,\n  type QuickJSContext,\n  type QuickJSHandle,\n  type QuickJSRuntime,\n  type QuickJSWASMModule,\n} from \"quickjs-emscripten\";\n\nimport {\n  ExecuteFailure,\n  isExecuteFailure,\n  normalizeCode,\n} from \"@mcploom/codexec\";\nimport type {\n  ExecuteError,\n  ExecuteResult,\n  ResolvedToolDescriptor,\n  ResolvedToolProvider,\n  ToolExecutionContext,\n  Executor,\n} from \"@mcploom/codexec\";\nimport {\n  createGuestErrorHandle,\n  formatConsoleLine,\n  fromGuestHandle,\n  toGuestHandle,\n} from \"./quickjsBridge\";\nimport type { QuickJsExecutorOptions } from \"./types\";\n\nconst DEFAULT_MEMORY_LIMIT_BYTES = 64 * 1024 * 1024;\nconst DEFAULT_TIMEOUT_MS = 5000;\nconst DEFAULT_MAX_LOG_LINES = 100;\nconst DEFAULT_MAX_LOG_CHARS = 64_000;\n\nconst loadDefaultModule = memoizePromiseFactory(() =>\n  newQuickJSWASMModule(RELEASE_SYNC),\n);\n\nfunction isKnownErrorCode(value: unknown): value is ExecuteError[\"code\"] {\n  return (\n    value === \"timeout\" ||\n    value === \"memory_limit\" ||\n    value === \"validation_error\" ||\n    value === \"tool_error\" ||\n    value === \"runtime_error\" ||\n    value === \"serialization_error\" ||\n    value === \"internal_error\"\n  );\n}\n\nfunction normalizeThrownMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return String(error);\n}\n\nfunction toExecuteError(error: unknown, deadline: number): ExecuteError {\n  if (isExecuteFailure(error)) {\n    return {\n      code: error.code,\n      message: error.message,\n    };\n  }\n\n  const message = normalizeThrownMessage(error);\n\n  if (Date.now() > deadline || message.includes(\"interrupted\")) {\n    return {\n      code: \"timeout\",\n      message: \"Execution timed out\",\n    };\n  }\n\n  if (message.toLowerCase().includes(\"out of memory\")) {\n    return {\n      code: \"memory_limit\",\n      message,\n    };\n  }\n\n  return {\n    code: \"runtime_error\",\n    message,\n  };\n}\n\nfunction errorFromGuestHandle(\n  context: QuickJSContext,\n  handle: QuickJSHandle,\n  deadline: number,\n): ExecuteError {\n  const codeHandle = context.getProp(handle, \"code\");\n  const messageHandle = context.getProp(handle, \"message\");\n\n  try {\n    const code =\n      context.typeof(codeHandle) === \"string\"\n        ? context.getString(codeHandle)\n        : undefined;\n    const message =\n      context.typeof(messageHandle) === \"string\"\n        ? context.getString(messageHandle)\n        : normalizeThrownMessage(context.dump(handle));\n\n    if (isKnownErrorCode(code)) {\n      return {\n        code,\n        message,\n      };\n    }\n\n    return toExecuteError(message, deadline);\n  } finally {\n    codeHandle.dispose();\n    messageHandle.dispose();\n  }\n}\n\nfunction truncateLogs(\n  logs: string[],\n  maxLogLines: number,\n  maxLogChars: number,\n): string[] {\n  const limitedLines = logs.slice(0, maxLogLines);\n  let remainingChars = maxLogChars;\n  const truncated: string[] = [];\n\n  for (const line of limitedLines) {\n    if (remainingChars <= 0) {\n      break;\n    }\n\n    if (line.length <= remainingChars) {\n      truncated.push(line);\n      remainingChars -= line.length;\n      continue;\n    }\n\n    truncated.push(line.slice(0, remainingChars));\n    break;\n  }\n\n  return truncated;\n}\n\nfunction createExecutionContext(\n  signal: AbortSignal,\n  providerName: string,\n  safeToolName: string,\n  originalToolName: string,\n): ToolExecutionContext {\n  return {\n    originalToolName,\n    providerName,\n    safeToolName,\n    signal,\n  };\n}\n\nasync function waitForPromiseSettlement(\n  runtime: QuickJSRuntime,\n  promise: Promise<unknown>,\n  deadline: number,\n): Promise<void> {\n  let settled = false;\n  let rejection: unknown;\n\n  promise.then(\n    () => {\n      settled = true;\n    },\n    (error) => {\n      settled = true;\n      rejection = error;\n    },\n  );\n\n  while (!settled) {\n    if (Date.now() > deadline) {\n      throw new ExecuteFailure(\"timeout\", \"Execution timed out\");\n    }\n\n    const pendingJobsResult = runtime.executePendingJobs(-1);\n    if (isFail(pendingJobsResult)) {\n      const pendingError = pendingJobsResult.error;\n\n      try {\n        const executeError = errorFromGuestHandle(\n          pendingError.context,\n          pendingError,\n          deadline,\n        );\n        throw new ExecuteFailure(executeError.code, executeError.message);\n      } finally {\n        pendingError.dispose();\n      }\n    }\n\n    await new Promise((resolve) => setTimeout(resolve, 0));\n  }\n\n  if (rejection !== undefined) {\n    throw rejection;\n  }\n}\n\nfunction injectConsole(context: QuickJSContext, logs: string[]): void {\n  const consoleHandle = context.newObject();\n\n  try {\n    for (const methodName of [\"log\", \"info\", \"warn\", \"error\"]) {\n      const methodHandle = context.newFunction(methodName, (...args) => {\n        logs.push(formatConsoleLine(args.map((arg) => context.dump(arg))));\n        return context.undefined;\n      });\n\n      context.setProp(consoleHandle, methodName, methodHandle);\n      methodHandle.dispose();\n    }\n\n    context.setProp(context.global, \"console\", consoleHandle);\n  } finally {\n    consoleHandle.dispose();\n  }\n}\n\nfunction injectProviders(\n  context: QuickJSContext,\n  providers: ResolvedToolProvider[],\n  signal: AbortSignal,\n): void {\n  for (const provider of providers) {\n    const providerHandle = context.newObject();\n\n    try {\n      for (const [safeToolName, descriptor] of Object.entries(provider.tools)) {\n        const toolHandle = createToolHandle(\n          context,\n          provider,\n          descriptor,\n          safeToolName,\n          signal,\n        );\n        context.setProp(providerHandle, safeToolName, toolHandle);\n        toolHandle.dispose();\n      }\n\n      context.setProp(context.global, provider.name, providerHandle);\n    } finally {\n      providerHandle.dispose();\n    }\n  }\n}\n\nfunction createToolHandle(\n  context: QuickJSContext,\n  provider: ResolvedToolProvider,\n  descriptor: ResolvedToolDescriptor,\n  safeToolName: string,\n  signal: AbortSignal,\n): QuickJSHandle {\n  return context.newFunction(safeToolName, (...args) => {\n    const deferred = context.newPromise();\n    const input = args[0] === undefined ? undefined : context.dump(args[0]);\n    const executionContext = createExecutionContext(\n      signal,\n      provider.name,\n      safeToolName,\n      descriptor.originalName,\n    );\n\n    void Promise.resolve()\n      .then(async () => descriptor.execute(input, executionContext))\n      .then((result) => {\n        if (!context.alive || !deferred.alive) {\n          return;\n        }\n\n        let resultHandle: QuickJSHandle | undefined;\n\n        try {\n          resultHandle = toGuestHandle(context, result);\n          deferred.resolve(resultHandle);\n        } catch (error) {\n          const executeError = toExecuteError(error, Number.POSITIVE_INFINITY);\n          const errorHandle = createGuestErrorHandle(\n            context,\n            executeError.code,\n            executeError.message,\n          );\n          deferred.reject(errorHandle);\n          errorHandle.dispose();\n        } finally {\n          resultHandle?.dispose();\n          deferred.dispose();\n        }\n      })\n      .catch((error) => {\n        if (!context.alive || !deferred.alive) {\n          return;\n        }\n\n        const executeError = toExecuteError(error, Number.POSITIVE_INFINITY);\n        const errorHandle = createGuestErrorHandle(\n          context,\n          executeError.code,\n          executeError.message,\n        );\n        deferred.reject(errorHandle);\n        errorHandle.dispose();\n        deferred.dispose();\n      });\n\n    return deferred.handle;\n  });\n}\n\n/**\n * QuickJS-backed executor for one-shot sandboxed JavaScript runs.\n */\nexport class QuickJsExecutor implements Executor {\n  private readonly loadModule: () => Promise<QuickJSWASMModule>;\n  private readonly maxLogChars: number;\n  private readonly maxLogLines: number;\n  private readonly memoryLimitBytes: number;\n  private readonly timeoutMs: number;\n\n  constructor(options: QuickJsExecutorOptions = {}) {\n    this.loadModule = async () => {\n      const loaded = options.loadModule\n        ? await options.loadModule()\n        : await loadDefaultModule();\n      return loaded as QuickJSWASMModule;\n    };\n    this.maxLogChars = options.maxLogChars ?? DEFAULT_MAX_LOG_CHARS;\n    this.maxLogLines = options.maxLogLines ?? DEFAULT_MAX_LOG_LINES;\n    this.memoryLimitBytes =\n      options.memoryLimitBytes ?? DEFAULT_MEMORY_LIMIT_BYTES;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  }\n\n  /**\n   * Executes JavaScript against the provided tool namespaces in a fresh QuickJS runtime.\n   */\n  async execute(\n    code: string,\n    providers: ResolvedToolProvider[],\n  ): Promise<ExecuteResult> {\n    const startedAt = Date.now();\n    const deadline = startedAt + this.timeoutMs;\n    const logs: string[] = [];\n    const abortController = new AbortController();\n    const module = await this.loadModule();\n    const runtime = module.newRuntime();\n    runtime.setMemoryLimit(this.memoryLimitBytes);\n    runtime.setInterruptHandler(shouldInterruptAfterDeadline(deadline));\n    const context = runtime.newContext();\n\n    try {\n      injectConsole(context, logs);\n      injectProviders(context, providers, abortController.signal);\n\n      const executableSource = normalizeCode(code);\n      const functionHandle = context.unwrapResult(\n        context.evalCode(`(${executableSource})`, \"sandbox-user-code.js\"),\n      );\n\n      try {\n        const promiseHandle = context.unwrapResult(\n          context.callFunction(functionHandle, context.undefined),\n        );\n\n        try {\n          const promiseResult = context.resolvePromise(promiseHandle);\n          await waitForPromiseSettlement(runtime, promiseResult, deadline);\n          const settledResult = await promiseResult;\n\n          if (isFail(settledResult)) {\n            const errorHandle = settledResult.error;\n\n            try {\n              return {\n                durationMs: Date.now() - startedAt,\n                error: errorFromGuestHandle(context, errorHandle, deadline),\n                logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),\n                ok: false,\n              };\n            } finally {\n              errorHandle.dispose();\n            }\n          }\n\n          try {\n            const value = fromGuestHandle(context, settledResult.value);\n\n            return {\n              durationMs: Date.now() - startedAt,\n              logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),\n              ok: true,\n              result: value,\n            };\n          } catch (error) {\n            return {\n              durationMs: Date.now() - startedAt,\n              error: toExecuteError(error, deadline),\n              logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),\n              ok: false,\n            };\n          } finally {\n            settledResult.value.dispose();\n          }\n        } finally {\n          promiseHandle.dispose();\n        }\n      } finally {\n        functionHandle.dispose();\n      }\n    } catch (error) {\n      abortController.abort();\n\n      return {\n        durationMs: Date.now() - startedAt,\n        error: toExecuteError(error, deadline),\n        logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),\n        ok: false,\n      };\n    } finally {\n      abortController.abort();\n      context.dispose();\n      runtime.dispose();\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,38 @@
+import { ExecuteResult, Executor, ResolvedToolProvider } from "@mcploom/codexec";
+
+//#region src/types.d.ts
+/**
+ * Options for constructing a {@link QuickJsExecutor}.
+ */
+interface QuickJsExecutorOptions {
+  /** Optional QuickJS module loader override for tests or custom builds. */
+  loadModule?: () => Promise<unknown> | unknown;
+  /** Maximum total characters preserved across captured log lines. */
+  maxLogChars?: number;
+  /** Maximum number of captured log lines returned in the result. */
+  maxLogLines?: number;
+  /** Guest memory limit in bytes. */
+  memoryLimitBytes?: number;
+  /** Wall-clock execution timeout in milliseconds. */
+  timeoutMs?: number;
+}
+//#endregion
+//#region src/quickjsExecutor.d.ts
+/**
+ * QuickJS-backed executor for one-shot sandboxed JavaScript runs.
+ */
+declare class QuickJsExecutor implements Executor {
+  private readonly loadModule;
+  private readonly maxLogChars;
+  private readonly maxLogLines;
+  private readonly memoryLimitBytes;
+  private readonly timeoutMs;
+  constructor(options?: QuickJsExecutorOptions);
+  /**
+   * Executes JavaScript against the provided tool namespaces in a fresh QuickJS runtime.
+   */
+  execute(code: string, providers: ResolvedToolProvider[]): Promise<ExecuteResult>;
+}
+//#endregion
+export { QuickJsExecutor, type QuickJsExecutorOptions };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/quickjsExecutor.ts"],"sourcesContent":[],"mappings":";;;;;;AAGiB,UAAA,sBAAA,CAEI;;qBAAA;;ECiUR,WAAA,CAAA,EAAA,MAAgB;EAON;EAmBR,WAAA,CAAA,EAAA,MAAA;EACF;EAAR,gBAAA,CAAA,EAAA,MAAA;EA3BmC;EAAQ,SAAA,CAAA,EAAA,MAAA;;;;;ADnUhD;;cCmUa,eAAA,YAA2B;;EAA3B,iBAAA,WAAgB;EAON,iBAAA,WAAA;EAmBR,iBAAA,gBAAA;EACF,iBAAA,SAAA;EAAR,WAAA,CAAA,OAAA,CAAA,EApBkB,sBAoBlB;EA3BmC;;;mCA0BzB,yBACV,QAAQ"}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import { ExecuteResult, Executor, ResolvedToolProvider } from "@mcploom/codexec";
+
+//#region src/types.d.ts
+/**
+ * Options for constructing a {@link QuickJsExecutor}.
+ */
+interface QuickJsExecutorOptions {
+  /** Optional QuickJS module loader override for tests or custom builds. */
+  loadModule?: () => Promise<unknown> | unknown;
+  /** Maximum total characters preserved across captured log lines. */
+  maxLogChars?: number;
+  /** Maximum number of captured log lines returned in the result. */
+  maxLogLines?: number;
+  /** Guest memory limit in bytes. */
+  memoryLimitBytes?: number;
+  /** Wall-clock execution timeout in milliseconds. */
+  timeoutMs?: number;
+}
+//#endregion
+//#region src/quickjsExecutor.d.ts
+/**
+ * QuickJS-backed executor for one-shot sandboxed JavaScript runs.
+ */
+declare class QuickJsExecutor implements Executor {
+  private readonly loadModule;
+  private readonly maxLogChars;
+  private readonly maxLogLines;
+  private readonly memoryLimitBytes;
+  private readonly timeoutMs;
+  constructor(options?: QuickJsExecutorOptions);
+  /**
+   * Executes JavaScript against the provided tool namespaces in a fresh QuickJS runtime.
+   */
+  execute(code: string, providers: ResolvedToolProvider[]): Promise<ExecuteResult>;
+}
+//#endregion
+export { QuickJsExecutor, type QuickJsExecutorOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/quickjsExecutor.ts"],"sourcesContent":[],"mappings":";;;;;;AAGiB,UAAA,sBAAA,CAEI;;qBAAA;;ECiUR,WAAA,CAAA,EAAA,MAAgB;EAON;EAmBR,WAAA,CAAA,EAAA,MAAA;EACF;EAAR,gBAAA,CAAA,EAAA,MAAA;EA3BmC;EAAQ,SAAA,CAAA,EAAA,MAAA;;;;;ADnUhD;;cCmUa,eAAA,YAA2B;;EAA3B,iBAAA,WAAgB;EAON,iBAAA,WAAA;EAmBR,iBAAA,gBAAA;EACF,iBAAA,SAAA;EAAR,WAAA,CAAA,OAAA,CAAA,EApBkB,sBAoBlB;EA3BmC;;;mCA0BzB,yBACV,QAAQ"}

package/dist/index.js

@@ -0,0 +1,314 @@
+import { RELEASE_SYNC, isFail, memoizePromiseFactory, newQuickJSWASMModule, shouldInterruptAfterDeadline } from "quickjs-emscripten";
+import { ExecuteFailure, isExecuteFailure, normalizeCode } from "@mcploom/codexec";
+
+//#region src/quickjsBridge.ts
+function formatLogValue(value) {
+	if (typeof value === "string") return value;
+	if (value === void 0) return "undefined";
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return String(value);
+	}
+}
+function formatConsoleLine(values) {
+	return values.map((value) => formatLogValue(value)).join(" ");
+}
+function createGuestErrorHandle(context, code, message) {
+	const errorHandle = context.newError({
+		message,
+		name: "Error"
+	});
+	const codeHandle = context.newString(code);
+	context.setProp(errorHandle, "code", codeHandle);
+	codeHandle.dispose();
+	return errorHandle;
+}
+function fromGuestHandle(context, handle) {
+	const guestType = context.typeof(handle);
+	if (guestType === "undefined") return;
+	if (guestType === "function" || guestType === "symbol" || guestType === "bigint") throw new ExecuteFailure("serialization_error", "Guest code returned a non-serializable value");
+	const jsonHandle = context.getProp(context.global, "JSON");
+	const stringifyHandle = context.getProp(jsonHandle, "stringify");
+	try {
+		const stringified = context.unwrapResult(context.callFunction(stringifyHandle, jsonHandle, handle));
+		if (context.typeof(stringified) === "undefined") throw new ExecuteFailure("serialization_error", "Guest code returned a non-serializable value");
+		const jsonValue = context.getString(stringified);
+		return JSON.parse(jsonValue);
+	} catch (error) {
+		if (error instanceof ExecuteFailure) throw error;
+		throw new ExecuteFailure("serialization_error", "Guest code returned a non-serializable value");
+	} finally {
+		stringifyHandle.dispose();
+		jsonHandle.dispose();
+	}
+}
+function toGuestHandle(context, value) {
+	if (value === void 0) return context.undefined;
+	const jsonValue = JSON.stringify(value);
+	if (jsonValue === void 0) throw new ExecuteFailure("serialization_error", "Host value is not JSON-serializable");
+	return context.unwrapResult(context.evalCode(`(${jsonValue})`, "host-value.json"));
+}
+
+//#endregion
+//#region src/quickjsExecutor.ts
+const DEFAULT_MEMORY_LIMIT_BYTES = 64 * 1024 * 1024;
+const DEFAULT_TIMEOUT_MS = 5e3;
+const DEFAULT_MAX_LOG_LINES = 100;
+const DEFAULT_MAX_LOG_CHARS = 64e3;
+const loadDefaultModule = memoizePromiseFactory(() => newQuickJSWASMModule(RELEASE_SYNC));
+function isKnownErrorCode(value) {
+	return value === "timeout" || value === "memory_limit" || value === "validation_error" || value === "tool_error" || value === "runtime_error" || value === "serialization_error" || value === "internal_error";
+}
+function normalizeThrownMessage(error) {
+	if (error instanceof Error) return error.message;
+	return String(error);
+}
+function toExecuteError(error, deadline) {
+	if (isExecuteFailure(error)) return {
+		code: error.code,
+		message: error.message
+	};
+	const message = normalizeThrownMessage(error);
+	if (Date.now() > deadline || message.includes("interrupted")) return {
+		code: "timeout",
+		message: "Execution timed out"
+	};
+	if (message.toLowerCase().includes("out of memory")) return {
+		code: "memory_limit",
+		message
+	};
+	return {
+		code: "runtime_error",
+		message
+	};
+}
+function errorFromGuestHandle(context, handle, deadline) {
+	const codeHandle = context.getProp(handle, "code");
+	const messageHandle = context.getProp(handle, "message");
+	try {
+		const code = context.typeof(codeHandle) === "string" ? context.getString(codeHandle) : void 0;
+		const message = context.typeof(messageHandle) === "string" ? context.getString(messageHandle) : normalizeThrownMessage(context.dump(handle));
+		if (isKnownErrorCode(code)) return {
+			code,
+			message
+		};
+		return toExecuteError(message, deadline);
+	} finally {
+		codeHandle.dispose();
+		messageHandle.dispose();
+	}
+}
+function truncateLogs(logs, maxLogLines, maxLogChars) {
+	const limitedLines = logs.slice(0, maxLogLines);
+	let remainingChars = maxLogChars;
+	const truncated = [];
+	for (const line of limitedLines) {
+		if (remainingChars <= 0) break;
+		if (line.length <= remainingChars) {
+			truncated.push(line);
+			remainingChars -= line.length;
+			continue;
+		}
+		truncated.push(line.slice(0, remainingChars));
+		break;
+	}
+	return truncated;
+}
+function createExecutionContext(signal, providerName, safeToolName, originalToolName) {
+	return {
+		originalToolName,
+		providerName,
+		safeToolName,
+		signal
+	};
+}
+async function waitForPromiseSettlement(runtime, promise, deadline) {
+	let settled = false;
+	let rejection;
+	promise.then(() => {
+		settled = true;
+	}, (error) => {
+		settled = true;
+		rejection = error;
+	});
+	while (!settled) {
+		if (Date.now() > deadline) throw new ExecuteFailure("timeout", "Execution timed out");
+		const pendingJobsResult = runtime.executePendingJobs(-1);
+		if (isFail(pendingJobsResult)) {
+			const pendingError = pendingJobsResult.error;
+			try {
+				const executeError = errorFromGuestHandle(pendingError.context, pendingError, deadline);
+				throw new ExecuteFailure(executeError.code, executeError.message);
+			} finally {
+				pendingError.dispose();
+			}
+		}
+		await new Promise((resolve) => setTimeout(resolve, 0));
+	}
+	if (rejection !== void 0) throw rejection;
+}
+function injectConsole(context, logs) {
+	const consoleHandle = context.newObject();
+	try {
+		for (const methodName of [
+			"log",
+			"info",
+			"warn",
+			"error"
+		]) {
+			const methodHandle = context.newFunction(methodName, (...args) => {
+				logs.push(formatConsoleLine(args.map((arg) => context.dump(arg))));
+				return context.undefined;
+			});
+			context.setProp(consoleHandle, methodName, methodHandle);
+			methodHandle.dispose();
+		}
+		context.setProp(context.global, "console", consoleHandle);
+	} finally {
+		consoleHandle.dispose();
+	}
+}
+function injectProviders(context, providers, signal) {
+	for (const provider of providers) {
+		const providerHandle = context.newObject();
+		try {
+			for (const [safeToolName, descriptor] of Object.entries(provider.tools)) {
+				const toolHandle = createToolHandle(context, provider, descriptor, safeToolName, signal);
+				context.setProp(providerHandle, safeToolName, toolHandle);
+				toolHandle.dispose();
+			}
+			context.setProp(context.global, provider.name, providerHandle);
+		} finally {
+			providerHandle.dispose();
+		}
+	}
+}
+function createToolHandle(context, provider, descriptor, safeToolName, signal) {
+	return context.newFunction(safeToolName, (...args) => {
+		const deferred = context.newPromise();
+		const input = args[0] === void 0 ? void 0 : context.dump(args[0]);
+		const executionContext = createExecutionContext(signal, provider.name, safeToolName, descriptor.originalName);
+		Promise.resolve().then(async () => descriptor.execute(input, executionContext)).then((result) => {
+			if (!context.alive || !deferred.alive) return;
+			let resultHandle;
+			try {
+				resultHandle = toGuestHandle(context, result);
+				deferred.resolve(resultHandle);
+			} catch (error) {
+				const executeError = toExecuteError(error, Number.POSITIVE_INFINITY);
+				const errorHandle = createGuestErrorHandle(context, executeError.code, executeError.message);
+				deferred.reject(errorHandle);
+				errorHandle.dispose();
+			} finally {
+				resultHandle?.dispose();
+				deferred.dispose();
+			}
+		}).catch((error) => {
+			if (!context.alive || !deferred.alive) return;
+			const executeError = toExecuteError(error, Number.POSITIVE_INFINITY);
+			const errorHandle = createGuestErrorHandle(context, executeError.code, executeError.message);
+			deferred.reject(errorHandle);
+			errorHandle.dispose();
+			deferred.dispose();
+		});
+		return deferred.handle;
+	});
+}
+/**
+* QuickJS-backed executor for one-shot sandboxed JavaScript runs.
+*/
+var QuickJsExecutor = class {
+	loadModule;
+	maxLogChars;
+	maxLogLines;
+	memoryLimitBytes;
+	timeoutMs;
+	constructor(options = {}) {
+		this.loadModule = async () => {
+			return options.loadModule ? await options.loadModule() : await loadDefaultModule();
+		};
+		this.maxLogChars = options.maxLogChars ?? DEFAULT_MAX_LOG_CHARS;
+		this.maxLogLines = options.maxLogLines ?? DEFAULT_MAX_LOG_LINES;
+		this.memoryLimitBytes = options.memoryLimitBytes ?? DEFAULT_MEMORY_LIMIT_BYTES;
+		this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	}
+	/**
+	* Executes JavaScript against the provided tool namespaces in a fresh QuickJS runtime.
+	*/
+	async execute(code, providers) {
+		const startedAt = Date.now();
+		const deadline = startedAt + this.timeoutMs;
+		const logs = [];
+		const abortController = new AbortController();
+		const runtime = (await this.loadModule()).newRuntime();
+		runtime.setMemoryLimit(this.memoryLimitBytes);
+		runtime.setInterruptHandler(shouldInterruptAfterDeadline(deadline));
+		const context = runtime.newContext();
+		try {
+			injectConsole(context, logs);
+			injectProviders(context, providers, abortController.signal);
+			const executableSource = normalizeCode(code);
+			const functionHandle = context.unwrapResult(context.evalCode(`(${executableSource})`, "sandbox-user-code.js"));
+			try {
+				const promiseHandle = context.unwrapResult(context.callFunction(functionHandle, context.undefined));
+				try {
+					const promiseResult = context.resolvePromise(promiseHandle);
+					await waitForPromiseSettlement(runtime, promiseResult, deadline);
+					const settledResult = await promiseResult;
+					if (isFail(settledResult)) {
+						const errorHandle = settledResult.error;
+						try {
+							return {
+								durationMs: Date.now() - startedAt,
+								error: errorFromGuestHandle(context, errorHandle, deadline),
+								logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),
+								ok: false
+							};
+						} finally {
+							errorHandle.dispose();
+						}
+					}
+					try {
+						const value = fromGuestHandle(context, settledResult.value);
+						return {
+							durationMs: Date.now() - startedAt,
+							logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),
+							ok: true,
+							result: value
+						};
+					} catch (error) {
+						return {
+							durationMs: Date.now() - startedAt,
+							error: toExecuteError(error, deadline),
+							logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),
+							ok: false
+						};
+					} finally {
+						settledResult.value.dispose();
+					}
+				} finally {
+					promiseHandle.dispose();
+				}
+			} finally {
+				functionHandle.dispose();
+			}
+		} catch (error) {
+			abortController.abort();
+			return {
+				durationMs: Date.now() - startedAt,
+				error: toExecuteError(error, deadline),
+				logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),
+				ok: false
+			};
+		} finally {
+			abortController.abort();
+			context.dispose();
+			runtime.dispose();
+		}
+	}
+};
+
+//#endregion
+export { QuickJsExecutor };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["truncated: string[]","rejection: unknown","resultHandle: QuickJSHandle | undefined","logs: string[]"],"sources":["../src/quickjsBridge.ts","../src/quickjsExecutor.ts"],"sourcesContent":["import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\n\nimport { ExecuteFailure, type ExecuteErrorCode } from \"@mcploom/codexec\";\n\nfunction formatLogValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (value === undefined) {\n    return \"undefined\";\n  }\n\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\nexport function formatConsoleLine(values: unknown[]): string {\n  return values.map((value) => formatLogValue(value)).join(\" \");\n}\n\nexport function createGuestErrorHandle(\n  context: QuickJSContext,\n  code: ExecuteErrorCode,\n  message: string,\n): QuickJSHandle {\n  const errorHandle = context.newError({ message, name: \"Error\" });\n  const codeHandle = context.newString(code);\n  context.setProp(errorHandle, \"code\", codeHandle);\n  codeHandle.dispose();\n  return errorHandle;\n}\n\nexport function fromGuestHandle(\n  context: QuickJSContext,\n  handle: QuickJSHandle,\n): unknown {\n  const guestType = context.typeof(handle);\n\n  if (guestType === \"undefined\") {\n    return undefined;\n  }\n\n  if (\n    guestType === \"function\" ||\n    guestType === \"symbol\" ||\n    guestType === \"bigint\"\n  ) {\n    throw new ExecuteFailure(\n      \"serialization_error\",\n      \"Guest code returned a non-serializable value\",\n    );\n  }\n\n  const jsonHandle = context.getProp(context.global, \"JSON\");\n  const stringifyHandle = context.getProp(jsonHandle, \"stringify\");\n\n  try {\n    const stringified = context.unwrapResult(\n      context.callFunction(stringifyHandle, jsonHandle, handle),\n    );\n    const stringifiedType = context.typeof(stringified);\n\n    if (stringifiedType === \"undefined\") {\n      throw new ExecuteFailure(\n        \"serialization_error\",\n        \"Guest code returned a non-serializable value\",\n      );\n    }\n\n    const jsonValue = context.getString(stringified);\n    return JSON.parse(jsonValue);\n  } catch (error) {\n    if (error instanceof ExecuteFailure) {\n      throw error;\n    }\n\n    throw new ExecuteFailure(\n      \"serialization_error\",\n      \"Guest code returned a non-serializable value\",\n    );\n  } finally {\n    stringifyHandle.dispose();\n    jsonHandle.dispose();\n  }\n}\n\nexport function toGuestHandle(\n  context: QuickJSContext,\n  value: unknown,\n): QuickJSHandle {\n  if (value === undefined) {\n    return context.undefined;\n  }\n\n  const jsonValue = JSON.stringify(value);\n\n  if (jsonValue === undefined) {\n    throw new ExecuteFailure(\n      \"serialization_error\",\n      \"Host value is not JSON-serializable\",\n    );\n  }\n\n  return context.unwrapResult(\n    context.evalCode(`(${jsonValue})`, \"host-value.json\"),\n  );\n}\n","import {\n  RELEASE_SYNC,\n  isFail,\n  memoizePromiseFactory,\n  newQuickJSWASMModule,\n  shouldInterruptAfterDeadline,\n  type QuickJSContext,\n  type QuickJSHandle,\n  type QuickJSRuntime,\n  type QuickJSWASMModule,\n} from \"quickjs-emscripten\";\n\nimport {\n  ExecuteFailure,\n  isExecuteFailure,\n  normalizeCode,\n} from \"@mcploom/codexec\";\nimport type {\n  ExecuteError,\n  ExecuteResult,\n  ResolvedToolDescriptor,\n  ResolvedToolProvider,\n  ToolExecutionContext,\n  Executor,\n} from \"@mcploom/codexec\";\nimport {\n  createGuestErrorHandle,\n  formatConsoleLine,\n  fromGuestHandle,\n  toGuestHandle,\n} from \"./quickjsBridge\";\nimport type { QuickJsExecutorOptions } from \"./types\";\n\nconst DEFAULT_MEMORY_LIMIT_BYTES = 64 * 1024 * 1024;\nconst DEFAULT_TIMEOUT_MS = 5000;\nconst DEFAULT_MAX_LOG_LINES = 100;\nconst DEFAULT_MAX_LOG_CHARS = 64_000;\n\nconst loadDefaultModule = memoizePromiseFactory(() =>\n  newQuickJSWASMModule(RELEASE_SYNC),\n);\n\nfunction isKnownErrorCode(value: unknown): value is ExecuteError[\"code\"] {\n  return (\n    value === \"timeout\" ||\n    value === \"memory_limit\" ||\n    value === \"validation_error\" ||\n    value === \"tool_error\" ||\n    value === \"runtime_error\" ||\n    value === \"serialization_error\" ||\n    value === \"internal_error\"\n  );\n}\n\nfunction normalizeThrownMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return String(error);\n}\n\nfunction toExecuteError(error: unknown, deadline: number): ExecuteError {\n  if (isExecuteFailure(error)) {\n    return {\n      code: error.code,\n      message: error.message,\n    };\n  }\n\n  const message = normalizeThrownMessage(error);\n\n  if (Date.now() > deadline || message.includes(\"interrupted\")) {\n    return {\n      code: \"timeout\",\n      message: \"Execution timed out\",\n    };\n  }\n\n  if (message.toLowerCase().includes(\"out of memory\")) {\n    return {\n      code: \"memory_limit\",\n      message,\n    };\n  }\n\n  return {\n    code: \"runtime_error\",\n    message,\n  };\n}\n\nfunction errorFromGuestHandle(\n  context: QuickJSContext,\n  handle: QuickJSHandle,\n  deadline: number,\n): ExecuteError {\n  const codeHandle = context.getProp(handle, \"code\");\n  const messageHandle = context.getProp(handle, \"message\");\n\n  try {\n    const code =\n      context.typeof(codeHandle) === \"string\"\n        ? context.getString(codeHandle)\n        : undefined;\n    const message =\n      context.typeof(messageHandle) === \"string\"\n        ? context.getString(messageHandle)\n        : normalizeThrownMessage(context.dump(handle));\n\n    if (isKnownErrorCode(code)) {\n      return {\n        code,\n        message,\n      };\n    }\n\n    return toExecuteError(message, deadline);\n  } finally {\n    codeHandle.dispose();\n    messageHandle.dispose();\n  }\n}\n\nfunction truncateLogs(\n  logs: string[],\n  maxLogLines: number,\n  maxLogChars: number,\n): string[] {\n  const limitedLines = logs.slice(0, maxLogLines);\n  let remainingChars = maxLogChars;\n  const truncated: string[] = [];\n\n  for (const line of limitedLines) {\n    if (remainingChars <= 0) {\n      break;\n    }\n\n    if (line.length <= remainingChars) {\n      truncated.push(line);\n      remainingChars -= line.length;\n      continue;\n    }\n\n    truncated.push(line.slice(0, remainingChars));\n    break;\n  }\n\n  return truncated;\n}\n\nfunction createExecutionContext(\n  signal: AbortSignal,\n  providerName: string,\n  safeToolName: string,\n  originalToolName: string,\n): ToolExecutionContext {\n  return {\n    originalToolName,\n    providerName,\n    safeToolName,\n    signal,\n  };\n}\n\nasync function waitForPromiseSettlement(\n  runtime: QuickJSRuntime,\n  promise: Promise<unknown>,\n  deadline: number,\n): Promise<void> {\n  let settled = false;\n  let rejection: unknown;\n\n  promise.then(\n    () => {\n      settled = true;\n    },\n    (error) => {\n      settled = true;\n      rejection = error;\n    },\n  );\n\n  while (!settled) {\n    if (Date.now() > deadline) {\n      throw new ExecuteFailure(\"timeout\", \"Execution timed out\");\n    }\n\n    const pendingJobsResult = runtime.executePendingJobs(-1);\n    if (isFail(pendingJobsResult)) {\n      const pendingError = pendingJobsResult.error;\n\n      try {\n        const executeError = errorFromGuestHandle(\n          pendingError.context,\n          pendingError,\n          deadline,\n        );\n        throw new ExecuteFailure(executeError.code, executeError.message);\n      } finally {\n        pendingError.dispose();\n      }\n    }\n\n    await new Promise((resolve) => setTimeout(resolve, 0));\n  }\n\n  if (rejection !== undefined) {\n    throw rejection;\n  }\n}\n\nfunction injectConsole(context: QuickJSContext, logs: string[]): void {\n  const consoleHandle = context.newObject();\n\n  try {\n    for (const methodName of [\"log\", \"info\", \"warn\", \"error\"]) {\n      const methodHandle = context.newFunction(methodName, (...args) => {\n        logs.push(formatConsoleLine(args.map((arg) => context.dump(arg))));\n        return context.undefined;\n      });\n\n      context.setProp(consoleHandle, methodName, methodHandle);\n      methodHandle.dispose();\n    }\n\n    context.setProp(context.global, \"console\", consoleHandle);\n  } finally {\n    consoleHandle.dispose();\n  }\n}\n\nfunction injectProviders(\n  context: QuickJSContext,\n  providers: ResolvedToolProvider[],\n  signal: AbortSignal,\n): void {\n  for (const provider of providers) {\n    const providerHandle = context.newObject();\n\n    try {\n      for (const [safeToolName, descriptor] of Object.entries(provider.tools)) {\n        const toolHandle = createToolHandle(\n          context,\n          provider,\n          descriptor,\n          safeToolName,\n          signal,\n        );\n        context.setProp(providerHandle, safeToolName, toolHandle);\n        toolHandle.dispose();\n      }\n\n      context.setProp(context.global, provider.name, providerHandle);\n    } finally {\n      providerHandle.dispose();\n    }\n  }\n}\n\nfunction createToolHandle(\n  context: QuickJSContext,\n  provider: ResolvedToolProvider,\n  descriptor: ResolvedToolDescriptor,\n  safeToolName: string,\n  signal: AbortSignal,\n): QuickJSHandle {\n  return context.newFunction(safeToolName, (...args) => {\n    const deferred = context.newPromise();\n    const input = args[0] === undefined ? undefined : context.dump(args[0]);\n    const executionContext = createExecutionContext(\n      signal,\n      provider.name,\n      safeToolName,\n      descriptor.originalName,\n    );\n\n    void Promise.resolve()\n      .then(async () => descriptor.execute(input, executionContext))\n      .then((result) => {\n        if (!context.alive || !deferred.alive) {\n          return;\n        }\n\n        let resultHandle: QuickJSHandle | undefined;\n\n        try {\n          resultHandle = toGuestHandle(context, result);\n          deferred.resolve(resultHandle);\n        } catch (error) {\n          const executeError = toExecuteError(error, Number.POSITIVE_INFINITY);\n          const errorHandle = createGuestErrorHandle(\n            context,\n            executeError.code,\n            executeError.message,\n          );\n          deferred.reject(errorHandle);\n          errorHandle.dispose();\n        } finally {\n          resultHandle?.dispose();\n          deferred.dispose();\n        }\n      })\n      .catch((error) => {\n        if (!context.alive || !deferred.alive) {\n          return;\n        }\n\n        const executeError = toExecuteError(error, Number.POSITIVE_INFINITY);\n        const errorHandle = createGuestErrorHandle(\n          context,\n          executeError.code,\n          executeError.message,\n        );\n        deferred.reject(errorHandle);\n        errorHandle.dispose();\n        deferred.dispose();\n      });\n\n    return deferred.handle;\n  });\n}\n\n/**\n * QuickJS-backed executor for one-shot sandboxed JavaScript runs.\n */\nexport class QuickJsExecutor implements Executor {\n  private readonly loadModule: () => Promise<QuickJSWASMModule>;\n  private readonly maxLogChars: number;\n  private readonly maxLogLines: number;\n  private readonly memoryLimitBytes: number;\n  private readonly timeoutMs: number;\n\n  constructor(options: QuickJsExecutorOptions = {}) {\n    this.loadModule = async () => {\n      const loaded = options.loadModule\n        ? await options.loadModule()\n        : await loadDefaultModule();\n      return loaded as QuickJSWASMModule;\n    };\n    this.maxLogChars = options.maxLogChars ?? DEFAULT_MAX_LOG_CHARS;\n    this.maxLogLines = options.maxLogLines ?? DEFAULT_MAX_LOG_LINES;\n    this.memoryLimitBytes =\n      options.memoryLimitBytes ?? DEFAULT_MEMORY_LIMIT_BYTES;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  }\n\n  /**\n   * Executes JavaScript against the provided tool namespaces in a fresh QuickJS runtime.\n   */\n  async execute(\n    code: string,\n    providers: ResolvedToolProvider[],\n  ): Promise<ExecuteResult> {\n    const startedAt = Date.now();\n    const deadline = startedAt + this.timeoutMs;\n    const logs: string[] = [];\n    const abortController = new AbortController();\n    const module = await this.loadModule();\n    const runtime = module.newRuntime();\n    runtime.setMemoryLimit(this.memoryLimitBytes);\n    runtime.setInterruptHandler(shouldInterruptAfterDeadline(deadline));\n    const context = runtime.newContext();\n\n    try {\n      injectConsole(context, logs);\n      injectProviders(context, providers, abortController.signal);\n\n      const executableSource = normalizeCode(code);\n      const functionHandle = context.unwrapResult(\n        context.evalCode(`(${executableSource})`, \"sandbox-user-code.js\"),\n      );\n\n      try {\n        const promiseHandle = context.unwrapResult(\n          context.callFunction(functionHandle, context.undefined),\n        );\n\n        try {\n          const promiseResult = context.resolvePromise(promiseHandle);\n          await waitForPromiseSettlement(runtime, promiseResult, deadline);\n          const settledResult = await promiseResult;\n\n          if (isFail(settledResult)) {\n            const errorHandle = settledResult.error;\n\n            try {\n              return {\n                durationMs: Date.now() - startedAt,\n                error: errorFromGuestHandle(context, errorHandle, deadline),\n                logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),\n                ok: false,\n              };\n            } finally {\n              errorHandle.dispose();\n            }\n          }\n\n          try {\n            const value = fromGuestHandle(context, settledResult.value);\n\n            return {\n              durationMs: Date.now() - startedAt,\n              logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),\n              ok: true,\n              result: value,\n            };\n          } catch (error) {\n            return {\n              durationMs: Date.now() - startedAt,\n              error: toExecuteError(error, deadline),\n              logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),\n              ok: false,\n            };\n          } finally {\n            settledResult.value.dispose();\n          }\n        } finally {\n          promiseHandle.dispose();\n        }\n      } finally {\n        functionHandle.dispose();\n      }\n    } catch (error) {\n      abortController.abort();\n\n      return {\n        durationMs: Date.now() - startedAt,\n        error: toExecuteError(error, deadline),\n        logs: truncateLogs(logs, this.maxLogLines, this.maxLogChars),\n        ok: false,\n      };\n    } finally {\n      abortController.abort();\n      context.dispose();\n      runtime.dispose();\n    }\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@mcploom/codexec-quickjs",
+  "version": "0.1.0",
+  "description": "QuickJS executor for the mcploom codexec core package.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsdown"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "quickjs",
+    "sandbox",
+    "code-execution"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aallam/mcploom.git",
+    "directory": "packages/codexec-quickjs"
+  },
+  "homepage": "https://github.com/aallam/mcploom/tree/main/packages/codexec-quickjs#readme",
+  "bugs": "https://github.com/aallam/mcploom/issues",
+  "dependencies": {
+    "@mcploom/codexec": "^0.1.0",
+    "quickjs-emscripten": "^0.31.0"
+  }
+}