@execbox/quickjs 0.4.0 → 0.6.0

package/dist/runner/protocolEndpoint.js

@@ -1,4 +1,4 @@
-import "../runner-CteKTaPD.js";
-import { t as attachQuickJsProtocolEndpoint } from "../protocolEndpoint-T_JEz8YY.js";
+import "../runner-oZXbguX3.js";
+import { t as attachQuickJsProtocolEndpoint } from "../protocolEndpoint-Ceadcq_L.js";
 
 export { attachQuickJsProtocolEndpoint };

package/dist/runner-DRLfwiqY.cjs

@@ -0,0 +1,348 @@
+let __execbox_core_runtime = require("@execbox/core/runtime");
+let node_crypto = require("node:crypto");
+let quickjs_emscripten = require("quickjs-emscripten");
+
+//#region src/quickjsBridge.ts
+/**
+* Creates a guest-visible error object that carries a trusted host error code marker.
+*/
+function createGuestErrorHandle(context, code, message, trustedHostErrorKey) {
+	const errorHandle = context.newError({
+		message,
+		name: "Error"
+	});
+	const codeHandle = context.newString(code);
+	const trustedHostMarkerHandle = context.true;
+	try {
+		context.setProp(errorHandle, "code", codeHandle);
+		context.setProp(errorHandle, trustedHostErrorKey, trustedHostMarkerHandle);
+		return errorHandle;
+	} finally {
+		codeHandle.dispose();
+		trustedHostMarkerHandle.dispose();
+	}
+}
+/**
+* Converts a guest QuickJS handle into a JSON-compatible host value.
+*/
+function fromGuestHandle(context, handle) {
+	const guestType = context.typeof(handle);
+	if (guestType === "undefined") return;
+	if (guestType === "function" || guestType === "symbol" || guestType === "bigint") throw new __execbox_core_runtime.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 __execbox_core_runtime.ExecuteFailure("serialization_error", "Guest code returned a non-serializable value");
+		const jsonValue = context.getString(stringified);
+		return JSON.parse(jsonValue);
+	} catch (error) {
+		if (error instanceof __execbox_core_runtime.ExecuteFailure) throw error;
+		throw new __execbox_core_runtime.ExecuteFailure("serialization_error", "Guest code returned a non-serializable value");
+	} finally {
+		stringifyHandle.dispose();
+		jsonHandle.dispose();
+	}
+}
+/**
+* Converts a host JSON-compatible value into a guest QuickJS handle.
+*/
+function toGuestHandle(context, value) {
+	if (value === void 0) return context.undefined;
+	const jsonValue = JSON.stringify(value);
+	if (jsonValue === void 0) throw new __execbox_core_runtime.ExecuteFailure("serialization_error", "Host value is not JSON-serializable");
+	return context.unwrapResult(context.evalCode(`(${jsonValue})`, "host-value.json"));
+}
+
+//#endregion
+//#region src/runner/index.ts
+/**
+* @packageDocumentation
+* Public API for the `@execbox/quickjs/runner` entrypoint.
+*/
+const loadDefaultModule = (0, quickjs_emscripten.memoizePromiseFactory)(() => (0, quickjs_emscripten.newQuickJSWASMModule)(quickjs_emscripten.RELEASE_SYNC));
+/**
+* Converts unexpected executor failures into stable public result errors.
+*/
+function toExecuteError(error, deadline) {
+	if ((0, __execbox_core_runtime.isExecuteFailure)(error)) return {
+		code: error.code,
+		message: error.message
+	};
+	const message = (0, __execbox_core_runtime.normalizeThrownMessage)(error);
+	if (Date.now() > deadline || message.includes("interrupted")) return {
+		code: "timeout",
+		message: (0, __execbox_core_runtime.getExecutionTimeoutMessage)()
+	};
+	if (message.toLowerCase().includes("out of memory")) return {
+		code: "memory_limit",
+		message
+	};
+	return {
+		code: "runtime_error",
+		message
+	};
+}
+function errorFromGuestHandle(context, handle, trustedHostErrorKey) {
+	const codeHandle = context.getProp(handle, "code");
+	const messageHandle = context.getProp(handle, "message");
+	const trustedMarkerHandle = context.getProp(handle, trustedHostErrorKey);
+	try {
+		const code = context.typeof(codeHandle) === "string" ? context.getString(codeHandle) : void 0;
+		const trustedHostError = context.typeof(trustedMarkerHandle) === "boolean";
+		const message = context.typeof(messageHandle) === "string" ? context.getString(messageHandle) : (0, __execbox_core_runtime.normalizeThrownMessage)(context.dump(handle));
+		if (trustedHostError && (0, __execbox_core_runtime.isKnownExecuteErrorCode)(code)) return {
+			code,
+			message
+		};
+		return {
+			code: "runtime_error",
+			message
+		};
+	} finally {
+		codeHandle.dispose();
+		messageHandle.dispose();
+		trustedMarkerHandle.dispose();
+	}
+}
+async function waitForPromiseSettlement(runtime, promise, deadline, trustedHostErrorKey) {
+	let settled = false;
+	let rejection;
+	promise.then(() => {
+		settled = true;
+	}, (error) => {
+		settled = true;
+		rejection = error;
+	});
+	while (!settled) {
+		if (Date.now() > deadline) throw new __execbox_core_runtime.ExecuteFailure("timeout", (0, __execbox_core_runtime.getExecutionTimeoutMessage)());
+		const pendingJobsResult = runtime.executePendingJobs(-1);
+		if ((0, quickjs_emscripten.isFail)(pendingJobsResult)) {
+			const pendingError = pendingJobsResult.error;
+			try {
+				const executeError = errorFromGuestHandle(pendingError.context, pendingError, trustedHostErrorKey);
+				throw new __execbox_core_runtime.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((0, __execbox_core_runtime.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, trustedHostErrorKey, onToolCall) {
+	for (const provider of providers) {
+		const providerHandle = context.newObject();
+		try {
+			for (const [safeToolName] of Object.entries(provider.tools)) {
+				const toolHandle = createToolHandle(context, provider.name, safeToolName, signal, trustedHostErrorKey, onToolCall);
+				context.setProp(providerHandle, safeToolName, toolHandle);
+				toolHandle.dispose();
+			}
+			context.setProp(context.global, provider.name, providerHandle);
+		} finally {
+			providerHandle.dispose();
+		}
+	}
+}
+function createToolHandle(context, providerName, safeToolName, signal, trustedHostErrorKey, onToolCall) {
+	return context.newFunction(safeToolName, (...args) => {
+		const deferred = context.newPromise();
+		const disposeDeferred = () => {
+			if (context.alive && deferred.alive) deferred.dispose();
+		};
+		let input;
+		try {
+			input = args[0] === void 0 ? void 0 : fromGuestHandle(context, args[0]);
+		} catch (error) {
+			const executeError = (0, __execbox_core_runtime.isExecuteFailure)(error) ? error : new __execbox_core_runtime.ExecuteFailure("serialization_error", "Guest code passed a non-serializable tool input");
+			const errorHandle = createGuestErrorHandle(context, executeError.code, executeError.message, trustedHostErrorKey);
+			try {
+				deferred.reject(errorHandle);
+				return deferred.handle;
+			} finally {
+				errorHandle.dispose();
+				queueMicrotask(disposeDeferred);
+			}
+		}
+		const onAbort = () => {
+			signal.removeEventListener("abort", onAbort);
+			if (!context.alive || !deferred.alive) {
+				disposeDeferred();
+				return;
+			}
+			const errorHandle = createGuestErrorHandle(context, "timeout", (0, __execbox_core_runtime.getExecutionTimeoutMessage)(), trustedHostErrorKey);
+			try {
+				deferred.reject(errorHandle);
+			} finally {
+				errorHandle.dispose();
+				disposeDeferred();
+			}
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+		let responsePromise;
+		try {
+			if (signal.aborted) throw new __execbox_core_runtime.ExecuteFailure("timeout", (0, __execbox_core_runtime.getExecutionTimeoutMessage)());
+			responsePromise = Promise.resolve(onToolCall({
+				input,
+				providerName,
+				safeToolName
+			}));
+		} catch (error) {
+			responsePromise = Promise.reject(error);
+		}
+		responsePromise.then((response) => {
+			signal.removeEventListener("abort", onAbort);
+			if (!context.alive || !deferred.alive) {
+				disposeDeferred();
+				return;
+			}
+			let resultHandle;
+			try {
+				if (!response.ok) {
+					const errorHandle = createGuestErrorHandle(context, response.error.code, response.error.message, trustedHostErrorKey);
+					deferred.reject(errorHandle);
+					errorHandle.dispose();
+					return;
+				}
+				resultHandle = toGuestHandle(context, response.result);
+				deferred.resolve(resultHandle);
+			} finally {
+				resultHandle?.dispose();
+				disposeDeferred();
+			}
+		}).catch((error) => {
+			signal.removeEventListener("abort", onAbort);
+			if (!context.alive || !deferred.alive) {
+				disposeDeferred();
+				return;
+			}
+			const errorHandle = createGuestErrorHandle(context, (0, __execbox_core_runtime.isExecuteFailure)(error) ? error.code : "internal_error", (0, __execbox_core_runtime.normalizeThrownMessage)(error), trustedHostErrorKey);
+			try {
+				deferred.reject(errorHandle);
+			} finally {
+				errorHandle.dispose();
+				disposeDeferred();
+			}
+		});
+		return deferred.handle;
+	});
+}
+/**
+* Runs one QuickJS-backed execution session using a transport-neutral tool callback.
+*/
+async function runQuickJsSession(request, options = {}) {
+	const runtimeOptions = (0, __execbox_core_runtime.resolveExecutorRuntimeOptions)(options);
+	const loadModule = async () => {
+		if (options.module) return options.module;
+		return options.loadModule ? await options.loadModule() : await loadDefaultModule();
+	};
+	const { maxLogChars, maxLogLines, memoryLimitBytes, timeoutMs } = runtimeOptions;
+	const startedAt = Date.now();
+	const logs = [];
+	const abortController = new AbortController();
+	const trustedHostErrorKey = `__execboxHostError_${(0, node_crypto.randomUUID)()}`;
+	const signal = request.abortController?.signal ?? request.signal ?? abortController.signal;
+	const runtime = (await loadModule()).newRuntime();
+	let deadline = Number.POSITIVE_INFINITY;
+	runtime.setMemoryLimit(memoryLimitBytes);
+	const context = runtime.newContext();
+	try {
+		injectConsole(context, logs);
+		injectProviders(context, request.providers, signal, trustedHostErrorKey, request.onToolCall);
+		deadline = Date.now() + timeoutMs;
+		const shouldInterrupt = (0, quickjs_emscripten.shouldInterruptAfterDeadline)(deadline);
+		runtime.setInterruptHandler((currentRuntime) => {
+			return signal.aborted || shouldInterrupt(currentRuntime);
+		});
+		request.onStarted?.();
+		const executableSource = (0, __execbox_core_runtime.normalizeCode)(request.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, trustedHostErrorKey);
+				const settledResult = await promiseResult;
+				if ((0, quickjs_emscripten.isFail)(settledResult)) {
+					const errorHandle = settledResult.error;
+					try {
+						return {
+							durationMs: Date.now() - startedAt,
+							error: errorFromGuestHandle(context, errorHandle, trustedHostErrorKey),
+							logs: (0, __execbox_core_runtime.truncateLogs)(logs, maxLogLines, maxLogChars),
+							ok: false
+						};
+					} finally {
+						errorHandle.dispose();
+					}
+				}
+				try {
+					const value = fromGuestHandle(context, settledResult.value);
+					return {
+						durationMs: Date.now() - startedAt,
+						logs: (0, __execbox_core_runtime.truncateLogs)(logs, maxLogLines, maxLogChars),
+						ok: true,
+						result: value
+					};
+				} catch (error) {
+					return {
+						durationMs: Date.now() - startedAt,
+						error: toExecuteError(error, deadline),
+						logs: (0, __execbox_core_runtime.truncateLogs)(logs, maxLogLines, 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: (0, __execbox_core_runtime.truncateLogs)(logs, maxLogLines, maxLogChars),
+			ok: false
+		};
+	} finally {
+		request.abortController?.abort();
+		abortController.abort();
+		context.dispose();
+		runtime.dispose();
+	}
+}
+
+//#endregion
+Object.defineProperty(exports, 'runQuickJsSession', {
+  enumerable: true,
+  get: function () {
+    return runQuickJsSession;
+  }
+});
+//# sourceMappingURL=runner-DRLfwiqY.cjs.map

package/dist/runner-DRLfwiqY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-DRLfwiqY.cjs","names":["ExecuteFailure","RELEASE_SYNC","rejection: unknown","ExecuteFailure","input: unknown","responsePromise: Promise<ToolCallResult>","resultHandle: QuickJSHandle | undefined","logs: string[]"],"sources":["../src/quickjsBridge.ts","../src/runner/index.ts"],"sourcesContent":["import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\n\nimport { ExecuteFailure } from \"@execbox/core/runtime\";\nimport type { ExecuteErrorCode } from \"@execbox/core\";\n\n/**\n * Creates a guest-visible error object that carries a trusted host error code marker.\n */\nexport function createGuestErrorHandle(\n  context: QuickJSContext,\n  code: ExecuteErrorCode,\n  message: string,\n  trustedHostErrorKey: string,\n): QuickJSHandle {\n  const errorHandle = context.newError({ message, name: \"Error\" });\n  const codeHandle = context.newString(code);\n  const trustedHostMarkerHandle = context.true;\n\n  try {\n    context.setProp(errorHandle, \"code\", codeHandle);\n    context.setProp(errorHandle, trustedHostErrorKey, trustedHostMarkerHandle);\n    return errorHandle;\n  } finally {\n    codeHandle.dispose();\n    trustedHostMarkerHandle.dispose();\n  }\n}\n\n/**\n * Converts a guest QuickJS handle into a JSON-compatible host value.\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\n/**\n * Converts a host JSON-compatible value into a guest QuickJS handle.\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","/**\n * @packageDocumentation\n * Public API for the `@execbox/quickjs/runner` entrypoint.\n */\nimport { randomUUID } from \"node:crypto\";\n\nimport {\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  formatConsoleLine,\n  getExecutionTimeoutMessage,\n  isExecuteFailure,\n  isKnownExecuteErrorCode,\n  normalizeCode,\n  normalizeThrownMessage,\n  resolveExecutorRuntimeOptions,\n  truncateLogs,\n} from \"@execbox/core/runtime\";\nimport type {\n  ExecuteError,\n  ExecuteResult,\n  ExecutorRuntimeOptions,\n  ProviderManifest,\n  ToolCall,\n  ToolCallResult,\n} from \"@execbox/core\";\n\nimport {\n  createGuestErrorHandle,\n  fromGuestHandle,\n  toGuestHandle,\n} from \"../quickjsBridge.ts\";\nimport type { QuickJsInlineExecutorOptions } from \"../types.ts\";\n\nexport type {\n  QuickJsExecutorHost,\n  QuickJsExecutorOptions,\n  QuickJsHostedMode,\n  QuickJsInlineExecutorOptions,\n  QuickJsWorkerExecutorOptions,\n  WorkerResourceLimits,\n} from \"../types.ts\";\n\nconst loadDefaultModule = memoizePromiseFactory(() =>\n  newQuickJSWASMModule(RELEASE_SYNC),\n);\n\n/**\n * Transport-neutral host tool call emitted from a QuickJS session.\n */\nexport type QuickJsSessionToolCall = ToolCall;\n\n/**\n * Input required to run one transport-backed QuickJS execution session.\n */\nexport interface QuickJsSessionRequest {\n  /** Optional abort controller that should be triggered when execution stops. */\n  abortController?: AbortController;\n\n  /** Guest JavaScript source to evaluate inside QuickJS. */\n  code: string;\n\n  /** Host callback used to fulfill guest tool calls. */\n  onToolCall: (call: ToolCall) => Promise<ToolCallResult> | ToolCallResult;\n\n  /** Optional hook invoked once the guest runtime has started. */\n  onStarted?: () => void;\n\n  /** Transport-safe provider manifests exposed to the guest runtime. */\n  providers: ProviderManifest[];\n\n  /** Optional caller-owned abort signal for the session. */\n  signal?: AbortSignal;\n}\n\n/**\n * Options controlling one transport-backed QuickJS session.\n */\nexport type QuickJsSessionOptions = ExecutorRuntimeOptions &\n  Pick<QuickJsInlineExecutorOptions, \"loadModule\"> & {\n    /** Optional preloaded QuickJS WASM module instance. */\n    module?: QuickJSWASMModule;\n  };\n\n/**\n * Converts unexpected executor failures into stable public result errors.\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: getExecutionTimeoutMessage(),\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  trustedHostErrorKey: string,\n): ExecuteError {\n  const codeHandle = context.getProp(handle, \"code\");\n  const messageHandle = context.getProp(handle, \"message\");\n  const trustedMarkerHandle = context.getProp(handle, trustedHostErrorKey);\n\n  try {\n    const code =\n      context.typeof(codeHandle) === \"string\"\n        ? context.getString(codeHandle)\n        : undefined;\n    const trustedHostError = context.typeof(trustedMarkerHandle) === \"boolean\";\n    const message =\n      context.typeof(messageHandle) === \"string\"\n        ? context.getString(messageHandle)\n        : normalizeThrownMessage(context.dump(handle));\n\n    if (trustedHostError && isKnownExecuteErrorCode(code)) {\n      return {\n        code,\n        message,\n      };\n    }\n\n    return {\n      code: \"runtime_error\",\n      message,\n    };\n  } finally {\n    codeHandle.dispose();\n    messageHandle.dispose();\n    trustedMarkerHandle.dispose();\n  }\n}\n\nasync function waitForPromiseSettlement(\n  runtime: QuickJSRuntime,\n  promise: Promise<unknown>,\n  deadline: number,\n  trustedHostErrorKey: string,\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\", getExecutionTimeoutMessage());\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          trustedHostErrorKey,\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: ProviderManifest[],\n  signal: AbortSignal,\n  trustedHostErrorKey: string,\n  onToolCall: QuickJsSessionRequest[\"onToolCall\"],\n): void {\n  for (const provider of providers) {\n    const providerHandle = context.newObject();\n\n    try {\n      for (const [safeToolName] of Object.entries(provider.tools)) {\n        const toolHandle = createToolHandle(\n          context,\n          provider.name,\n          safeToolName,\n          signal,\n          trustedHostErrorKey,\n          onToolCall,\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  providerName: string,\n  safeToolName: string,\n  signal: AbortSignal,\n  trustedHostErrorKey: string,\n  onToolCall: QuickJsSessionRequest[\"onToolCall\"],\n): QuickJSHandle {\n  return context.newFunction(safeToolName, (...args) => {\n    const deferred = context.newPromise();\n    const disposeDeferred = () => {\n      if (context.alive && deferred.alive) {\n        deferred.dispose();\n      }\n    };\n    let input: unknown;\n\n    try {\n      input =\n        args[0] === undefined ? undefined : fromGuestHandle(context, args[0]);\n    } catch (error) {\n      const executeError = isExecuteFailure(error)\n        ? error\n        : new ExecuteFailure(\n            \"serialization_error\",\n            \"Guest code passed a non-serializable tool input\",\n          );\n      const errorHandle = createGuestErrorHandle(\n        context,\n        executeError.code,\n        executeError.message,\n        trustedHostErrorKey,\n      );\n\n      try {\n        deferred.reject(errorHandle);\n        return deferred.handle;\n      } finally {\n        errorHandle.dispose();\n        queueMicrotask(disposeDeferred);\n      }\n    }\n    const onAbort = () => {\n      signal.removeEventListener(\"abort\", onAbort);\n      if (!context.alive || !deferred.alive) {\n        disposeDeferred();\n        return;\n      }\n\n      const errorHandle = createGuestErrorHandle(\n        context,\n        \"timeout\",\n        getExecutionTimeoutMessage(),\n        trustedHostErrorKey,\n      );\n\n      try {\n        deferred.reject(errorHandle);\n      } finally {\n        errorHandle.dispose();\n        disposeDeferred();\n      }\n    };\n\n    signal.addEventListener(\"abort\", onAbort, { once: true });\n\n    let responsePromise: Promise<ToolCallResult>;\n\n    try {\n      if (signal.aborted) {\n        throw new ExecuteFailure(\"timeout\", getExecutionTimeoutMessage());\n      }\n\n      responsePromise = Promise.resolve(\n        onToolCall({\n          input,\n          providerName,\n          safeToolName,\n        }),\n      );\n    } catch (error) {\n      responsePromise = Promise.reject(error);\n    }\n\n    void responsePromise\n      .then((response) => {\n        signal.removeEventListener(\"abort\", onAbort);\n        if (!context.alive || !deferred.alive) {\n          disposeDeferred();\n          return;\n        }\n\n        let resultHandle: QuickJSHandle | undefined;\n\n        try {\n          if (!response.ok) {\n            const errorHandle = createGuestErrorHandle(\n              context,\n              response.error.code,\n              response.error.message,\n              trustedHostErrorKey,\n            );\n            deferred.reject(errorHandle);\n            errorHandle.dispose();\n            return;\n          }\n\n          resultHandle = toGuestHandle(context, response.result);\n          deferred.resolve(resultHandle);\n        } finally {\n          resultHandle?.dispose();\n          disposeDeferred();\n        }\n      })\n      .catch((error) => {\n        signal.removeEventListener(\"abort\", onAbort);\n        if (!context.alive || !deferred.alive) {\n          disposeDeferred();\n          return;\n        }\n\n        const errorHandle = createGuestErrorHandle(\n          context,\n          isExecuteFailure(error) ? error.code : \"internal_error\",\n          normalizeThrownMessage(error),\n          trustedHostErrorKey,\n        );\n\n        try {\n          deferred.reject(errorHandle);\n        } finally {\n          errorHandle.dispose();\n          disposeDeferred();\n        }\n      });\n\n    return deferred.handle;\n  });\n}\n\n/**\n * Runs one QuickJS-backed execution session using a transport-neutral tool callback.\n */\nexport async function runQuickJsSession(\n  request: QuickJsSessionRequest,\n  options: QuickJsSessionOptions = {},\n): Promise<ExecuteResult> {\n  const runtimeOptions = resolveExecutorRuntimeOptions(options);\n  const loadModule = async () => {\n    if (options.module) {\n      return options.module;\n    }\n\n    const loaded = options.loadModule\n      ? await options.loadModule()\n      : await loadDefaultModule();\n    return loaded as QuickJSWASMModule;\n  };\n  const { maxLogChars, maxLogLines, memoryLimitBytes, timeoutMs } =\n    runtimeOptions;\n  const startedAt = Date.now();\n  const logs: string[] = [];\n  const abortController = new AbortController();\n  const trustedHostErrorKey = `__execboxHostError_${randomUUID()}`;\n  const signal =\n    request.abortController?.signal ?? request.signal ?? abortController.signal;\n  const module = await loadModule();\n  const runtime = module.newRuntime();\n  let deadline = Number.POSITIVE_INFINITY;\n  runtime.setMemoryLimit(memoryLimitBytes);\n  const context = runtime.newContext();\n\n  try {\n    injectConsole(context, logs);\n    injectProviders(\n      context,\n      request.providers,\n      signal,\n      trustedHostErrorKey,\n      request.onToolCall,\n    );\n    const executionStartedAt = Date.now();\n    deadline = executionStartedAt + timeoutMs;\n    const shouldInterrupt = shouldInterruptAfterDeadline(deadline);\n    runtime.setInterruptHandler((currentRuntime) => {\n      return signal.aborted || shouldInterrupt(currentRuntime);\n    });\n    request.onStarted?.();\n\n    const executableSource = normalizeCode(request.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(\n          runtime,\n          promiseResult,\n          deadline,\n          trustedHostErrorKey,\n        );\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(\n                context,\n                errorHandle,\n                trustedHostErrorKey,\n              ),\n              logs: truncateLogs(logs, maxLogLines, 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, maxLogLines, 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, maxLogLines, 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, maxLogLines, maxLogChars),\n      ok: false,\n    };\n  } finally {\n    request.abortController?.abort();\n    abortController.abort();\n    context.dispose();\n    runtime.dispose();\n  }\n}\n"],"mappings":";;;;;;;;AAQA,SAAgB,uBACd,SACA,MACA,SACA,qBACe;CACf,MAAM,cAAc,QAAQ,SAAS;EAAE;EAAS,MAAM;EAAS,CAAC;CAChE,MAAM,aAAa,QAAQ,UAAU,KAAK;CAC1C,MAAM,0BAA0B,QAAQ;AAExC,KAAI;AACF,UAAQ,QAAQ,aAAa,QAAQ,WAAW;AAChD,UAAQ,QAAQ,aAAa,qBAAqB,wBAAwB;AAC1E,SAAO;WACC;AACR,aAAW,SAAS;AACpB,0BAAwB,SAAS;;;;;;AAOrC,SAAgB,gBACd,SACA,QACS;CACT,MAAM,YAAY,QAAQ,OAAO,OAAO;AAExC,KAAI,cAAc,YAChB;AAGF,KACE,cAAc,cACd,cAAc,YACd,cAAc,SAEd,OAAM,IAAIA,sCACR,uBACA,+CACD;CAGH,MAAM,aAAa,QAAQ,QAAQ,QAAQ,QAAQ,OAAO;CAC1D,MAAM,kBAAkB,QAAQ,QAAQ,YAAY,YAAY;AAEhE,KAAI;EACF,MAAM,cAAc,QAAQ,aAC1B,QAAQ,aAAa,iBAAiB,YAAY,OAAO,CAC1D;AAGD,MAFwB,QAAQ,OAAO,YAAY,KAE3B,YACtB,OAAM,IAAIA,sCACR,uBACA,+CACD;EAGH,MAAM,YAAY,QAAQ,UAAU,YAAY;AAChD,SAAO,KAAK,MAAM,UAAU;UACrB,OAAO;AACd,MAAI,iBAAiBA,sCACnB,OAAM;AAGR,QAAM,IAAIA,sCACR,uBACA,+CACD;WACO;AACR,kBAAgB,SAAS;AACzB,aAAW,SAAS;;;;;;AAOxB,SAAgB,cACd,SACA,OACe;AACf,KAAI,UAAU,OACZ,QAAO,QAAQ;CAGjB,MAAM,YAAY,KAAK,UAAU,MAAM;AAEvC,KAAI,cAAc,OAChB,OAAM,IAAIA,sCACR,uBACA,sCACD;AAGH,QAAO,QAAQ,aACb,QAAQ,SAAS,IAAI,UAAU,IAAI,kBAAkB,CACtD;;;;;;;;;ACrDH,MAAM,qHACiBC,gCAAa,CACnC;;;;AA0CD,SAAS,eAAe,OAAgB,UAAgC;AACtE,kDAAqB,MAAM,CACzB,QAAO;EACL,MAAM,MAAM;EACZ,SAAS,MAAM;EAChB;CAGH,MAAM,6DAAiC,MAAM;AAE7C,KAAI,KAAK,KAAK,GAAG,YAAY,QAAQ,SAAS,cAAc,CAC1D,QAAO;EACL,MAAM;EACN,iEAAqC;EACtC;AAGH,KAAI,QAAQ,aAAa,CAAC,SAAS,gBAAgB,CACjD,QAAO;EACL,MAAM;EACN;EACD;AAGH,QAAO;EACL,MAAM;EACN;EACD;;AAGH,SAAS,qBACP,SACA,QACA,qBACc;CACd,MAAM,aAAa,QAAQ,QAAQ,QAAQ,OAAO;CAClD,MAAM,gBAAgB,QAAQ,QAAQ,QAAQ,UAAU;CACxD,MAAM,sBAAsB,QAAQ,QAAQ,QAAQ,oBAAoB;AAExE,KAAI;EACF,MAAM,OACJ,QAAQ,OAAO,WAAW,KAAK,WAC3B,QAAQ,UAAU,WAAW,GAC7B;EACN,MAAM,mBAAmB,QAAQ,OAAO,oBAAoB,KAAK;EACjE,MAAM,UACJ,QAAQ,OAAO,cAAc,KAAK,WAC9B,QAAQ,UAAU,cAAc,sDACT,QAAQ,KAAK,OAAO,CAAC;AAElD,MAAI,wEAA4C,KAAK,CACnD,QAAO;GACL;GACA;GACD;AAGH,SAAO;GACL,MAAM;GACN;GACD;WACO;AACR,aAAW,SAAS;AACpB,gBAAc,SAAS;AACvB,sBAAoB,SAAS;;;AAIjC,eAAe,yBACb,SACA,SACA,UACA,qBACe;CACf,IAAI,UAAU;CACd,IAAIC;AAEJ,SAAQ,WACA;AACJ,YAAU;KAEX,UAAU;AACT,YAAU;AACV,cAAY;GAEf;AAED,QAAO,CAAC,SAAS;AACf,MAAI,KAAK,KAAK,GAAG,SACf,OAAM,IAAIC,sCAAe,mEAAuC,CAAC;EAGnE,MAAM,oBAAoB,QAAQ,mBAAmB,GAAG;AACxD,qCAAW,kBAAkB,EAAE;GAC7B,MAAM,eAAe,kBAAkB;AAEvC,OAAI;IACF,MAAM,eAAe,qBACnB,aAAa,SACb,cACA,oBACD;AACD,UAAM,IAAIA,sCAAe,aAAa,MAAM,aAAa,QAAQ;aACzD;AACR,iBAAa,SAAS;;;AAI1B,QAAM,IAAI,SAAS,YAAY,WAAW,SAAS,EAAE,CAAC;;AAGxD,KAAI,cAAc,OAChB,OAAM;;AAIV,SAAS,cAAc,SAAyB,MAAsB;CACpE,MAAM,gBAAgB,QAAQ,WAAW;AAEzC,KAAI;AACF,OAAK,MAAM,cAAc;GAAC;GAAO;GAAQ;GAAQ;GAAQ,EAAE;GACzD,MAAM,eAAe,QAAQ,YAAY,aAAa,GAAG,SAAS;AAChE,SAAK,mDAAuB,KAAK,KAAK,QAAQ,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC;AAClE,WAAO,QAAQ;KACf;AAEF,WAAQ,QAAQ,eAAe,YAAY,aAAa;AACxD,gBAAa,SAAS;;AAGxB,UAAQ,QAAQ,QAAQ,QAAQ,WAAW,cAAc;WACjD;AACR,gBAAc,SAAS;;;AAI3B,SAAS,gBACP,SACA,WACA,QACA,qBACA,YACM;AACN,MAAK,MAAM,YAAY,WAAW;EAChC,MAAM,iBAAiB,QAAQ,WAAW;AAE1C,MAAI;AACF,QAAK,MAAM,CAAC,iBAAiB,OAAO,QAAQ,SAAS,MAAM,EAAE;IAC3D,MAAM,aAAa,iBACjB,SACA,SAAS,MACT,cACA,QACA,qBACA,WACD;AACD,YAAQ,QAAQ,gBAAgB,cAAc,WAAW;AACzD,eAAW,SAAS;;AAGtB,WAAQ,QAAQ,QAAQ,QAAQ,SAAS,MAAM,eAAe;YACtD;AACR,kBAAe,SAAS;;;;AAK9B,SAAS,iBACP,SACA,cACA,cACA,QACA,qBACA,YACe;AACf,QAAO,QAAQ,YAAY,eAAe,GAAG,SAAS;EACpD,MAAM,WAAW,QAAQ,YAAY;EACrC,MAAM,wBAAwB;AAC5B,OAAI,QAAQ,SAAS,SAAS,MAC5B,UAAS,SAAS;;EAGtB,IAAIC;AAEJ,MAAI;AACF,WACE,KAAK,OAAO,SAAY,SAAY,gBAAgB,SAAS,KAAK,GAAG;WAChE,OAAO;GACd,MAAM,4DAAgC,MAAM,GACxC,QACA,IAAID,sCACF,uBACA,kDACD;GACL,MAAM,cAAc,uBAClB,SACA,aAAa,MACb,aAAa,SACb,oBACD;AAED,OAAI;AACF,aAAS,OAAO,YAAY;AAC5B,WAAO,SAAS;aACR;AACR,gBAAY,SAAS;AACrB,mBAAe,gBAAgB;;;EAGnC,MAAM,gBAAgB;AACpB,UAAO,oBAAoB,SAAS,QAAQ;AAC5C,OAAI,CAAC,QAAQ,SAAS,CAAC,SAAS,OAAO;AACrC,qBAAiB;AACjB;;GAGF,MAAM,cAAc,uBAClB,SACA,mEAC4B,EAC5B,oBACD;AAED,OAAI;AACF,aAAS,OAAO,YAAY;aACpB;AACR,gBAAY,SAAS;AACrB,qBAAiB;;;AAIrB,SAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,MAAM,CAAC;EAEzD,IAAIE;AAEJ,MAAI;AACF,OAAI,OAAO,QACT,OAAM,IAAIF,sCAAe,mEAAuC,CAAC;AAGnE,qBAAkB,QAAQ,QACxB,WAAW;IACT;IACA;IACA;IACD,CAAC,CACH;WACM,OAAO;AACd,qBAAkB,QAAQ,OAAO,MAAM;;AAGzC,EAAK,gBACF,MAAM,aAAa;AAClB,UAAO,oBAAoB,SAAS,QAAQ;AAC5C,OAAI,CAAC,QAAQ,SAAS,CAAC,SAAS,OAAO;AACrC,qBAAiB;AACjB;;GAGF,IAAIG;AAEJ,OAAI;AACF,QAAI,CAAC,SAAS,IAAI;KAChB,MAAM,cAAc,uBAClB,SACA,SAAS,MAAM,MACf,SAAS,MAAM,SACf,oBACD;AACD,cAAS,OAAO,YAAY;AAC5B,iBAAY,SAAS;AACrB;;AAGF,mBAAe,cAAc,SAAS,SAAS,OAAO;AACtD,aAAS,QAAQ,aAAa;aACtB;AACR,kBAAc,SAAS;AACvB,qBAAiB;;IAEnB,CACD,OAAO,UAAU;AAChB,UAAO,oBAAoB,SAAS,QAAQ;AAC5C,OAAI,CAAC,QAAQ,SAAS,CAAC,SAAS,OAAO;AACrC,qBAAiB;AACjB;;GAGF,MAAM,cAAc,uBAClB,sDACiB,MAAM,GAAG,MAAM,OAAO,qEAChB,MAAM,EAC7B,oBACD;AAED,OAAI;AACF,aAAS,OAAO,YAAY;aACpB;AACR,gBAAY,SAAS;AACrB,qBAAiB;;IAEnB;AAEJ,SAAO,SAAS;GAChB;;;;;AAMJ,eAAsB,kBACpB,SACA,UAAiC,EAAE,EACX;CACxB,MAAM,2EAA+C,QAAQ;CAC7D,MAAM,aAAa,YAAY;AAC7B,MAAI,QAAQ,OACV,QAAO,QAAQ;AAMjB,SAHe,QAAQ,aACnB,MAAM,QAAQ,YAAY,GAC1B,MAAM,mBAAmB;;CAG/B,MAAM,EAAE,aAAa,aAAa,kBAAkB,cAClD;CACF,MAAM,YAAY,KAAK,KAAK;CAC5B,MAAMC,OAAiB,EAAE;CACzB,MAAM,kBAAkB,IAAI,iBAAiB;CAC7C,MAAM,sBAAsB,mDAAkC;CAC9D,MAAM,SACJ,QAAQ,iBAAiB,UAAU,QAAQ,UAAU,gBAAgB;CAEvE,MAAM,WADS,MAAM,YAAY,EACV,YAAY;CACnC,IAAI,WAAW,OAAO;AACtB,SAAQ,eAAe,iBAAiB;CACxC,MAAM,UAAU,QAAQ,YAAY;AAEpC,KAAI;AACF,gBAAc,SAAS,KAAK;AAC5B,kBACE,SACA,QAAQ,WACR,QACA,qBACA,QAAQ,WACT;AAED,aAD2B,KAAK,KAAK,GACL;EAChC,MAAM,uEAA+C,SAAS;AAC9D,UAAQ,qBAAqB,mBAAmB;AAC9C,UAAO,OAAO,WAAW,gBAAgB,eAAe;IACxD;AACF,UAAQ,aAAa;EAErB,MAAM,6DAAiC,QAAQ,KAAK;EACpD,MAAM,iBAAiB,QAAQ,aAC7B,QAAQ,SAAS,IAAI,iBAAiB,IAAI,uBAAuB,CAClE;AAED,MAAI;GACF,MAAM,gBAAgB,QAAQ,aAC5B,QAAQ,aAAa,gBAAgB,QAAQ,UAAU,CACxD;AAED,OAAI;IACF,MAAM,gBAAgB,QAAQ,eAAe,cAAc;AAC3D,UAAM,yBACJ,SACA,eACA,UACA,oBACD;IACD,MAAM,gBAAgB,MAAM;AAE5B,uCAAW,cAAc,EAAE;KACzB,MAAM,cAAc,cAAc;AAElC,SAAI;AACF,aAAO;OACL,YAAY,KAAK,KAAK,GAAG;OACzB,OAAO,qBACL,SACA,aACA,oBACD;OACD,+CAAmB,MAAM,aAAa,YAAY;OAClD,IAAI;OACL;eACO;AACR,kBAAY,SAAS;;;AAIzB,QAAI;KACF,MAAM,QAAQ,gBAAgB,SAAS,cAAc,MAAM;AAE3D,YAAO;MACL,YAAY,KAAK,KAAK,GAAG;MACzB,+CAAmB,MAAM,aAAa,YAAY;MAClD,IAAI;MACJ,QAAQ;MACT;aACM,OAAO;AACd,YAAO;MACL,YAAY,KAAK,KAAK,GAAG;MACzB,OAAO,eAAe,OAAO,SAAS;MACtC,+CAAmB,MAAM,aAAa,YAAY;MAClD,IAAI;MACL;cACO;AACR,mBAAc,MAAM,SAAS;;aAEvB;AACR,kBAAc,SAAS;;YAEjB;AACR,kBAAe,SAAS;;UAEnB,OAAO;AACd,kBAAgB,OAAO;AAEvB,SAAO;GACL,YAAY,KAAK,KAAK,GAAG;GACzB,OAAO,eAAe,OAAO,SAAS;GACtC,+CAAmB,MAAM,aAAa,YAAY;GAClD,IAAI;GACL;WACO;AACR,UAAQ,iBAAiB,OAAO;AAChC,kBAAgB,OAAO;AACvB,UAAQ,SAAS;AACjB,UAAQ,SAAS"}