@execbox/quickjs 0.3.0 → 0.5.0

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  QuickJsProcessExecutorOptions,\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":"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"}

package/dist/{types-BeVqrcj8.d.ts → types-7wOdERLE.d.ts}

@@ -68,4 +68,4 @@ interface QuickJsProcessExecutorOptions extends ExecutorRuntimeOptions {
 type QuickJsExecutorOptions = QuickJsInlineExecutorOptions | QuickJsWorkerExecutorOptions | QuickJsProcessExecutorOptions;
 //#endregion
 export { QuickJsProcessExecutorOptions as a, QuickJsInlineExecutorOptions as i, QuickJsExecutorOptions as n, QuickJsWorkerExecutorOptions as o, QuickJsHostedMode as r, WorkerResourceLimits as s, QuickJsExecutorHost as t };
-//# sourceMappingURL=types-BeVqrcj8.d.ts.map
+//# sourceMappingURL=types-7wOdERLE.d.ts.map

package/dist/{types-BeVqrcj8.d.ts.map → types-7wOdERLE.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"types-BeVqrcj8.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAQA,CAAA,CAAA;AAKY,IAAA,CALA,mBAAA,CAAA,CAAA,CAKiB,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA;AAK7B,CAAA,CAAA;AAYA,CAAA,CAAA,CAAA,SAAA,CAAA,KAAA,CAAA,GAAA,CAAA,MAAA,CAAA,OAAA,CAAA,MAAA;AAWA,CAAA,CAAA;AAQS,IAAA,CApCG,iBAAA,CAAA,CAAA,CAoCH,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,SAAA,CAAA;;;;AARmE,SAAA,CAvB3D,oBAAA,CAuB2D;EAoB3D,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,IAAA,CAAA,EAAA,CAAA,GAAA,CAAA,GAAA,CAAA,UAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAQR,sBAAA,CAAA,CAAA,CAAA,MAAA;EAGA,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,IAAA,CAAA,EAAA,CAAA,GAAA,CAAA,KAAA,CAAA,UAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAX8C,wBAAA,CAAA,CAAA,CAAA,MAAA;EAAsB,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,EAAA,CAAA,KAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAiBjE,WAAA,CAAA,CAAA,CAAA,MAAA;;;;;UAhDK,4BAAA,CAAA,OAAA,CAAqC;;;;qBAKjC;;;;;UAMJ,4BAAA,CAAA,OAAA,CAAqC;;;;;;SAQ7C;;SAGA;;yBAGgB;;;;;UAMR,6BAAA,CAAA,OAAA,CAAsC;;;;;;SAQ9C;;SAGA;;;;;KAMG,sBAAA,CAAA,CAAA,CACR,+BACA,+BACA"}
+{"version":3,"file":"types-7wOdERLE.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAQA,CAAA,CAAA;AAKY,IAAA,CALA,mBAAA,CAAA,CAAA,CAKiB,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA;AAK7B,CAAA,CAAA;AAYA,CAAA,CAAA,CAAA,SAAA,CAAA,KAAA,CAAA,GAAA,CAAA,MAAA,CAAA,OAAA,CAAA,MAAA;AAWA,CAAA,CAAA;AAQS,IAAA,CApCG,iBAAA,CAAA,CAAA,CAoCH,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,SAAA,CAAA;;;;AARmE,SAAA,CAvB3D,oBAAA,CAuB2D;EAoB3D,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,IAAA,CAAA,EAAA,CAAA,GAAA,CAAA,GAAA,CAAA,UAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAQR,sBAAA,CAAA,CAAA,CAAA,MAAA;EAGA,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,IAAA,CAAA,EAAA,CAAA,GAAA,CAAA,KAAA,CAAA,UAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAX8C,wBAAA,CAAA,CAAA,CAAA,MAAA;EAAsB,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,EAAA,CAAA,KAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAiBjE,WAAA,CAAA,CAAA,CAAA,MAAA;;;;;UAhDK,4BAAA,CAAA,OAAA,CAAqC;;;;qBAKjC;;;;;UAMJ,4BAAA,CAAA,OAAA,CAAqC;;;;;;SAQ7C;;SAGA;;yBAGgB;;;;;UAMR,6BAAA,CAAA,OAAA,CAAsC;;;;;;SAQ9C;;SAGA;;;;;KAMG,sBAAA,CAAA,CAAA,CACR,+BACA,+BACA"}

package/dist/{types-CnNmLawC.d.cts → types-BMA2zKnX.d.cts}

@@ -68,4 +68,4 @@ interface QuickJsProcessExecutorOptions extends ExecutorRuntimeOptions {
 type QuickJsExecutorOptions = QuickJsInlineExecutorOptions | QuickJsWorkerExecutorOptions | QuickJsProcessExecutorOptions;
 //#endregion
 export { QuickJsProcessExecutorOptions as a, QuickJsInlineExecutorOptions as i, QuickJsExecutorOptions as n, QuickJsWorkerExecutorOptions as o, QuickJsHostedMode as r, WorkerResourceLimits as s, QuickJsExecutorHost as t };
-//# sourceMappingURL=types-CnNmLawC.d.cts.map
+//# sourceMappingURL=types-BMA2zKnX.d.cts.map

package/dist/{types-CnNmLawC.d.cts.map → types-BMA2zKnX.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"types-CnNmLawC.d.cts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAQA,CAAA,CAAA;AAKY,IAAA,CALA,mBAAA,CAAA,CAAA,CAKiB,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA;AAK7B,CAAA,CAAA;AAYA,CAAA,CAAA,CAAA,SAAA,CAAA,KAAA,CAAA,GAAA,CAAA,MAAA,CAAA,OAAA,CAAA,MAAA;AAWA,CAAA,CAAA;AAQS,IAAA,CApCG,iBAAA,CAAA,CAAA,CAoCH,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,SAAA,CAAA;;;;AARmE,SAAA,CAvB3D,oBAAA,CAuB2D;EAoB3D,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,IAAA,CAAA,EAAA,CAAA,GAAA,CAAA,GAAA,CAAA,UAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAQR,sBAAA,CAAA,CAAA,CAAA,MAAA;EAGA,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,IAAA,CAAA,EAAA,CAAA,GAAA,CAAA,KAAA,CAAA,UAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAX8C,wBAAA,CAAA,CAAA,CAAA,MAAA;EAAsB,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,EAAA,CAAA,KAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAiBjE,WAAA,CAAA,CAAA,CAAA,MAAA;;;;;UAhDK,4BAAA,CAAA,OAAA,CAAqC;;;;qBAKjC;;;;;UAMJ,4BAAA,CAAA,OAAA,CAAqC;;;;;;SAQ7C;;SAGA;;yBAGgB;;;;;UAMR,6BAAA,CAAA,OAAA,CAAsC;;;;;;SAQ9C;;SAGA;;;;;KAMG,sBAAA,CAAA,CAAA,CACR,+BACA,+BACA"}
+{"version":3,"file":"types-BMA2zKnX.d.cts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAQA,CAAA,CAAA;AAKY,IAAA,CALA,mBAAA,CAAA,CAAA,CAKiB,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA;AAK7B,CAAA,CAAA;AAYA,CAAA,CAAA,CAAA,SAAA,CAAA,KAAA,CAAA,GAAA,CAAA,MAAA,CAAA,OAAA,CAAA,MAAA;AAWA,CAAA,CAAA;AAQS,IAAA,CApCG,iBAAA,CAAA,CAAA,CAoCH,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,SAAA,CAAA;;;;AARmE,SAAA,CAvB3D,oBAAA,CAuB2D;EAoB3D,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,IAAA,CAAA,EAAA,CAAA,GAAA,CAAA,GAAA,CAAA,UAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAQR,sBAAA,CAAA,CAAA,CAAA,MAAA;EAGA,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,IAAA,CAAA,EAAA,CAAA,GAAA,CAAA,KAAA,CAAA,UAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAX8C,wBAAA,CAAA,CAAA,CAAA,MAAA;EAAsB,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,EAAA,CAAA,KAAA,CAAA,IAAA,CAAA,EAAA,CAAA,SAAA,CAAA,CAAA,CAAA;EAiBjE,WAAA,CAAA,CAAA,CAAA,MAAA;;;;;UAhDK,4BAAA,CAAA,OAAA,CAAqC;;;;qBAKjC;;;;;UAMJ,4BAAA,CAAA,OAAA,CAAqC;;;;;;SAQ7C;;SAGA;;yBAGgB;;;;;UAMR,6BAAA,CAAA,OAAA,CAAsC;;;;;;SAQ9C;;SAGA;;;;;KAMG,sBAAA,CAAA,CAAA,CACR,+BACA,+BACA"}

package/dist/workerEntry.cjs

@@ -1,5 +1,5 @@
-require('./runner-DRt0kpEk.cjs');
-const require_protocolEndpoint = require('./protocolEndpoint-A1JBvHG_.cjs');
+require('./runner-DRLfwiqY.cjs');
+const require_protocolEndpoint = require('./protocolEndpoint-ByylXGle.cjs');
 let node_worker_threads = require("node:worker_threads");
 
 //#region src/workerEntry.ts

package/dist/workerEntry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"workerEntry.cjs","names":["parentPort","attachQuickJsProtocolEndpoint"],"sources":["../src/workerEntry.ts"],"sourcesContent":["import { parentPort } from \"node:worker_threads\";\n\nimport type { DispatcherMessage, RunnerMessage } from \"@execbox/protocol\";\n\nimport { attachQuickJsProtocolEndpoint } from \"./runner/protocolEndpoint.ts\";\n\nif (!parentPort) {\n  throw new Error(\"QuickJsExecutor worker host requires a worker parent port\");\n}\n\nconst workerPort = parentPort;\n\nattachQuickJsProtocolEndpoint({\n  onMessage(handler: (message: DispatcherMessage) => void): () => void {\n    workerPort.on(\"message\", handler);\n    return () => workerPort.off(\"message\", handler);\n  },\n  send(message: RunnerMessage): void {\n    workerPort.postMessage(message);\n  },\n});\n"],"mappings":";;;;;AAMA,IAAI,CAACA,+BACH,OAAM,IAAI,MAAM,4DAA4D;AAG9E,MAAM,aAAaA;AAEnBC,uDAA8B;CAC5B,UAAU,SAA2D;AACnE,aAAW,GAAG,WAAW,QAAQ;AACjC,eAAa,WAAW,IAAI,WAAW,QAAQ;;CAEjD,KAAK,SAA8B;AACjC,aAAW,YAAY,QAAQ;;CAElC,CAAC"}
+{"version":3,"file":"workerEntry.cjs","names":["parentPort","attachQuickJsProtocolEndpoint"],"sources":["../src/workerEntry.ts"],"sourcesContent":["import { parentPort } from \"node:worker_threads\";\n\nimport type { DispatcherMessage, RunnerMessage } from \"@execbox/core/protocol\";\n\nimport { attachQuickJsProtocolEndpoint } from \"./runner/protocolEndpoint.ts\";\n\nif (!parentPort) {\n  throw new Error(\"QuickJsExecutor worker host requires a worker parent port\");\n}\n\nconst workerPort = parentPort;\n\nattachQuickJsProtocolEndpoint({\n  onMessage(handler: (message: DispatcherMessage) => void): () => void {\n    workerPort.on(\"message\", handler);\n    return () => workerPort.off(\"message\", handler);\n  },\n  send(message: RunnerMessage): void {\n    workerPort.postMessage(message);\n  },\n});\n"],"mappings":";;;;;AAMA,IAAI,CAACA,+BACH,OAAM,IAAI,MAAM,4DAA4D;AAG9E,MAAM,aAAaA;AAEnBC,uDAA8B;CAC5B,UAAU,SAA2D;AACnE,aAAW,GAAG,WAAW,QAAQ;AACjC,eAAa,WAAW,IAAI,WAAW,QAAQ;;CAEjD,KAAK,SAA8B;AACjC,aAAW,YAAY,QAAQ;;CAElC,CAAC"}

package/dist/workerEntry.js

@@ -1,5 +1,5 @@
-import "./runner-CteKTaPD.js";
-import { t as attachQuickJsProtocolEndpoint } from "./protocolEndpoint-CDGgtfFu.js";
+import "./runner-DJ5AWw-k.js";
+import { t as attachQuickJsProtocolEndpoint } from "./protocolEndpoint-CwyUhKrN.js";
 import { parentPort } from "node:worker_threads";
 
 //#region src/workerEntry.ts

package/dist/workerEntry.js.map

@@ -1 +1 @@
-{"version":3,"file":"workerEntry.js","names":[],"sources":["../src/workerEntry.ts"],"sourcesContent":["import { parentPort } from \"node:worker_threads\";\n\nimport type { DispatcherMessage, RunnerMessage } from \"@execbox/protocol\";\n\nimport { attachQuickJsProtocolEndpoint } from \"./runner/protocolEndpoint.ts\";\n\nif (!parentPort) {\n  throw new Error(\"QuickJsExecutor worker host requires a worker parent port\");\n}\n\nconst workerPort = parentPort;\n\nattachQuickJsProtocolEndpoint({\n  onMessage(handler: (message: DispatcherMessage) => void): () => void {\n    workerPort.on(\"message\", handler);\n    return () => workerPort.off(\"message\", handler);\n  },\n  send(message: RunnerMessage): void {\n    workerPort.postMessage(message);\n  },\n});\n"],"mappings":";;;;;AAMA,IAAI,CAAC,WACH,OAAM,IAAI,MAAM,4DAA4D;AAG9E,MAAM,aAAa;AAEnB,8BAA8B;CAC5B,UAAU,SAA2D;AACnE,aAAW,GAAG,WAAW,QAAQ;AACjC,eAAa,WAAW,IAAI,WAAW,QAAQ;;CAEjD,KAAK,SAA8B;AACjC,aAAW,YAAY,QAAQ;;CAElC,CAAC"}
+{"version":3,"file":"workerEntry.js","names":[],"sources":["../src/workerEntry.ts"],"sourcesContent":["import { parentPort } from \"node:worker_threads\";\n\nimport type { DispatcherMessage, RunnerMessage } from \"@execbox/core/protocol\";\n\nimport { attachQuickJsProtocolEndpoint } from \"./runner/protocolEndpoint.ts\";\n\nif (!parentPort) {\n  throw new Error(\"QuickJsExecutor worker host requires a worker parent port\");\n}\n\nconst workerPort = parentPort;\n\nattachQuickJsProtocolEndpoint({\n  onMessage(handler: (message: DispatcherMessage) => void): () => void {\n    workerPort.on(\"message\", handler);\n    return () => workerPort.off(\"message\", handler);\n  },\n  send(message: RunnerMessage): void {\n    workerPort.postMessage(message);\n  },\n});\n"],"mappings":";;;;;AAMA,IAAI,CAAC,WACH,OAAM,IAAI,MAAM,4DAA4D;AAG9E,MAAM,aAAa;AAEnB,8BAA8B;CAC5B,UAAU,SAA2D;AACnE,aAAW,GAAG,WAAW,QAAQ;AACjC,eAAa,WAAW,IAAI,WAAW,QAAQ;;CAEjD,KAAK,SAA8B;AACjC,aAAW,YAAY,QAAQ;;CAElC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@execbox/quickjs",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "QuickJS executor for the execbox core package across inline, worker, and process hosts.",
   "license": "MIT",
   "type": "module",
@@ -37,6 +37,15 @@
       },
       "import": "./dist/runner/protocolEndpoint.js",
       "require": "./dist/runner/protocolEndpoint.cjs"
+    },
+    "./remote-endpoint": {
+      "source": "./src/remoteEndpoint.ts",
+      "types": {
+        "import": "./dist/remoteEndpoint.d.ts",
+        "require": "./dist/remoteEndpoint.d.cts"
+      },
+      "import": "./dist/remoteEndpoint.js",
+      "require": "./dist/remoteEndpoint.cjs"
     }
   },
   "sideEffects": false,
@@ -63,8 +72,7 @@
   "homepage": "https://github.com/aallam/execbox/tree/main/packages/quickjs#readme",
   "bugs": "https://github.com/aallam/execbox/issues",
   "dependencies": {
-    "@execbox/core": "^0.3.1",
-    "@execbox/protocol": "^0.3.0",
+    "@execbox/core": "^0.5.0",
     "quickjs-emscripten": "^0.31.0"
   }
 }

package/dist/protocolEndpoint-A1JBvHG_.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"protocolEndpoint-A1JBvHG_.cjs","names":["activeAbortController: AbortController | undefined","activeExecutionId: string | undefined","runQuickJsSession"],"sources":["../../protocol/src/messages.ts","../src/runner/protocolEndpoint.ts"],"sourcesContent":["import type {\n  ExecuteResult,\n  ExecutorRuntimeOptions,\n  ProviderManifest,\n  ToolCall,\n  ToolCallResult,\n} from \"@execbox/core\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nfunction isRuntimeOptions(value: unknown): value is ExecutorRuntimeOptions {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  return (\n    isFiniteNumber(value.maxLogChars) &&\n    isFiniteNumber(value.maxLogLines) &&\n    isFiniteNumber(value.memoryLimitBytes) &&\n    isFiniteNumber(value.timeoutMs)\n  );\n}\n\nfunction isProviderManifest(value: unknown): value is ProviderManifest {\n  if (!isRecord(value) || typeof value.name !== \"string\") {\n    return false;\n  }\n\n  if (!isRecord(value.tools) || typeof value.types !== \"string\") {\n    return false;\n  }\n\n  return Object.values(value.tools).every(\n    (tool) =>\n      isRecord(tool) &&\n      typeof tool.originalName === \"string\" &&\n      typeof tool.safeName === \"string\" &&\n      (tool.description === undefined || typeof tool.description === \"string\"),\n  );\n}\n\nfunction isExecuteError(\n  value: unknown,\n): value is { code: string; message: string } {\n  return (\n    isRecord(value) &&\n    typeof value.code === \"string\" &&\n    typeof value.message === \"string\"\n  );\n}\n\nfunction isDonePayload(value: unknown): value is DoneMessage {\n  if (!isRecord(value) || !isFiniteNumber(value.durationMs)) {\n    return false;\n  }\n\n  if (\n    !Array.isArray(value.logs) ||\n    !value.logs.every((log) => typeof log === \"string\")\n  ) {\n    return false;\n  }\n\n  if (typeof value.ok !== \"boolean\") {\n    return false;\n  }\n\n  return value.ok ? true : isExecuteError(value.error);\n}\n\n/**\n * Message sent from dispatcher to runner to start one execution session.\n */\nexport interface ExecuteMessage {\n  code: string;\n  id: string;\n  options: ExecutorRuntimeOptions;\n  providers: ProviderManifest[];\n  type: \"execute\";\n}\n\n/**\n * Message sent from dispatcher to request prompt cancellation.\n */\nexport interface CancelMessage {\n  id: string;\n  type: \"cancel\";\n}\n\n/**\n * Message sent from a runner when guest code invokes a host tool.\n */\nexport interface ToolCallMessage extends ToolCall {\n  callId: string;\n  type: \"tool_call\";\n}\n\n/**\n * Message carrying a trusted host tool result back to the runner.\n */\nexport type ToolResultMessage = {\n  callId: string;\n  type: \"tool_result\";\n} & ToolCallResult;\n\n/**\n * Message indicating the runner has finished bootstrapping guest execution timing.\n */\nexport interface StartedMessage {\n  id: string;\n  type: \"started\";\n}\n\n/**\n * Final successful execution result returned by a runner.\n *\n * Node IPC can omit `undefined` fields during serialization, so `result`\n * remains optional at the protocol boundary and is normalized by the host.\n */\nexport type DoneSuccessMessage<T = unknown> = {\n  durationMs: number;\n  id: string;\n  logs: string[];\n  ok: true;\n  result?: T;\n  type: \"done\";\n};\n\n/**\n * Final failed execution result returned by a runner.\n */\nexport type DoneFailureMessage = {\n  id: string;\n  type: \"done\";\n} & Extract<ExecuteResult, { ok: false }>;\n\n/**\n * Final execution result returned by a runner.\n */\nexport type DoneMessage = DoneSuccessMessage | DoneFailureMessage;\n\n/**\n * Messages accepted by a runner transport endpoint.\n */\nexport type DispatcherMessage =\n  | CancelMessage\n  | ExecuteMessage\n  | ToolResultMessage;\n\n/**\n * Messages emitted by a runner transport endpoint.\n */\nexport type RunnerMessage = DoneMessage | StartedMessage | ToolCallMessage;\n\n/**\n * Returns whether an unknown value is a dispatcher-to-runner message.\n */\nexport function isDispatcherMessage(\n  value: unknown,\n): value is DispatcherMessage {\n  if (!isRecord(value) || typeof value.type !== \"string\") {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"cancel\":\n      return typeof value.id === \"string\";\n    case \"execute\":\n      return (\n        typeof value.code === \"string\" &&\n        typeof value.id === \"string\" &&\n        isRuntimeOptions(value.options) &&\n        Array.isArray(value.providers) &&\n        value.providers.every(isProviderManifest)\n      );\n    case \"tool_result\":\n      if (typeof value.callId !== \"string\" || typeof value.ok !== \"boolean\") {\n        return false;\n      }\n\n      if (value.ok) {\n        return \"result\" in value;\n      }\n\n      return isExecuteError(value.error);\n    default:\n      return false;\n  }\n}\n\n/**\n * Returns whether an unknown value is a runner-to-dispatcher message.\n */\nexport function isRunnerMessage(value: unknown): value is RunnerMessage {\n  if (!isRecord(value) || typeof value.type !== \"string\") {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"started\":\n      return typeof value.id === \"string\";\n    case \"tool_call\":\n      return (\n        typeof value.callId === \"string\" &&\n        typeof value.providerName === \"string\" &&\n        typeof value.safeToolName === \"string\" &&\n        \"input\" in value\n      );\n    case \"done\":\n      return typeof value.id === \"string\" && isDonePayload(value);\n    default:\n      return false;\n  }\n}\n","/**\n * @packageDocumentation\n * Public API for the `@execbox/quickjs/runner/protocol-endpoint` entrypoint.\n */\nimport { randomUUID } from \"node:crypto\";\n\nimport type {\n  DispatcherMessage,\n  ExecuteMessage,\n  RunnerMessage,\n} from \"@execbox/protocol\";\nimport type { ToolCallResult } from \"@execbox/core\";\n// This entrypoint is executed directly from source in worker/process tests before\n// workspace packages are built, so its runtime validator must stay source-local.\nimport { isDispatcherMessage } from \"../../../protocol/src/messages.ts\";\n\nimport { runQuickJsSession } from \"./index.ts\";\n\n/**\n * Minimal worker/process-side port used by the shared QuickJS protocol endpoint.\n */\nexport interface QuickJsProtocolPort {\n  onMessage(handler: (message: DispatcherMessage) => void): void | (() => void);\n  send(message: RunnerMessage): void;\n}\n\n/**\n * Attaches the shared QuickJS protocol loop to a worker/process messaging port.\n */\nexport function attachQuickJsProtocolEndpoint(\n  port: QuickJsProtocolPort,\n): () => void {\n  const pendingToolCalls = new Map<string, (result: ToolCallResult) => void>();\n  let activeAbortController: AbortController | undefined;\n  let activeExecutionId: string | undefined;\n\n  async function startExecution(message: ExecuteMessage): Promise<void> {\n    if (activeExecutionId) {\n      port.send({\n        durationMs: 0,\n        error: {\n          code: \"internal_error\",\n          message: \"QuickJS endpoint already has an active execution\",\n        },\n        id: message.id,\n        logs: [],\n        ok: false,\n        type: \"done\",\n      });\n      return;\n    }\n\n    const abortController = new AbortController();\n    activeAbortController = abortController;\n    activeExecutionId = message.id;\n\n    try {\n      const result = await runQuickJsSession(\n        {\n          abortController,\n          code: message.code,\n          onStarted: () => {\n            port.send({\n              id: message.id,\n              type: \"started\",\n            });\n          },\n          onToolCall: (call) =>\n            new Promise<ToolCallResult>((resolve) => {\n              const callId = randomUUID();\n              pendingToolCalls.set(callId, resolve);\n              port.send({\n                ...call,\n                callId,\n                type: \"tool_call\",\n              });\n            }),\n          providers: message.providers,\n        },\n        message.options,\n      );\n\n      port.send({\n        ...result,\n        id: message.id,\n        type: \"done\",\n      });\n    } catch (error) {\n      port.send({\n        durationMs: 0,\n        error: {\n          code: \"internal_error\",\n          message: error instanceof Error ? error.message : String(error),\n        },\n        id: message.id,\n        logs: [],\n        ok: false,\n        type: \"done\",\n      });\n    } finally {\n      pendingToolCalls.clear();\n      activeAbortController = undefined;\n      activeExecutionId = undefined;\n    }\n  }\n\n  const maybeDetach = port.onMessage((message: DispatcherMessage) => {\n    if (!isDispatcherMessage(message)) {\n      return;\n    }\n\n    switch (message.type) {\n      case \"cancel\":\n        if (message.id === activeExecutionId) {\n          activeAbortController?.abort();\n        }\n        break;\n      case \"execute\":\n        void startExecution(message);\n        break;\n      case \"tool_result\": {\n        const resolve = pendingToolCalls.get(message.callId);\n        pendingToolCalls.delete(message.callId);\n        resolve?.(message);\n        break;\n      }\n    }\n  });\n\n  return () => {\n    if (typeof maybeDetach === \"function\") {\n      maybeDetach();\n    }\n    pendingToolCalls.clear();\n    activeAbortController?.abort();\n    activeAbortController = undefined;\n    activeExecutionId = undefined;\n  };\n}\n"],"mappings":"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"}

package/dist/protocolEndpoint-CDGgtfFu.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"protocolEndpoint-CDGgtfFu.js","names":["activeAbortController: AbortController | undefined","activeExecutionId: string | undefined"],"sources":["../../protocol/src/messages.ts","../src/runner/protocolEndpoint.ts"],"sourcesContent":["import type {\n  ExecuteResult,\n  ExecutorRuntimeOptions,\n  ProviderManifest,\n  ToolCall,\n  ToolCallResult,\n} from \"@execbox/core\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nfunction isRuntimeOptions(value: unknown): value is ExecutorRuntimeOptions {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  return (\n    isFiniteNumber(value.maxLogChars) &&\n    isFiniteNumber(value.maxLogLines) &&\n    isFiniteNumber(value.memoryLimitBytes) &&\n    isFiniteNumber(value.timeoutMs)\n  );\n}\n\nfunction isProviderManifest(value: unknown): value is ProviderManifest {\n  if (!isRecord(value) || typeof value.name !== \"string\") {\n    return false;\n  }\n\n  if (!isRecord(value.tools) || typeof value.types !== \"string\") {\n    return false;\n  }\n\n  return Object.values(value.tools).every(\n    (tool) =>\n      isRecord(tool) &&\n      typeof tool.originalName === \"string\" &&\n      typeof tool.safeName === \"string\" &&\n      (tool.description === undefined || typeof tool.description === \"string\"),\n  );\n}\n\nfunction isExecuteError(\n  value: unknown,\n): value is { code: string; message: string } {\n  return (\n    isRecord(value) &&\n    typeof value.code === \"string\" &&\n    typeof value.message === \"string\"\n  );\n}\n\nfunction isDonePayload(value: unknown): value is DoneMessage {\n  if (!isRecord(value) || !isFiniteNumber(value.durationMs)) {\n    return false;\n  }\n\n  if (\n    !Array.isArray(value.logs) ||\n    !value.logs.every((log) => typeof log === \"string\")\n  ) {\n    return false;\n  }\n\n  if (typeof value.ok !== \"boolean\") {\n    return false;\n  }\n\n  return value.ok ? true : isExecuteError(value.error);\n}\n\n/**\n * Message sent from dispatcher to runner to start one execution session.\n */\nexport interface ExecuteMessage {\n  code: string;\n  id: string;\n  options: ExecutorRuntimeOptions;\n  providers: ProviderManifest[];\n  type: \"execute\";\n}\n\n/**\n * Message sent from dispatcher to request prompt cancellation.\n */\nexport interface CancelMessage {\n  id: string;\n  type: \"cancel\";\n}\n\n/**\n * Message sent from a runner when guest code invokes a host tool.\n */\nexport interface ToolCallMessage extends ToolCall {\n  callId: string;\n  type: \"tool_call\";\n}\n\n/**\n * Message carrying a trusted host tool result back to the runner.\n */\nexport type ToolResultMessage = {\n  callId: string;\n  type: \"tool_result\";\n} & ToolCallResult;\n\n/**\n * Message indicating the runner has finished bootstrapping guest execution timing.\n */\nexport interface StartedMessage {\n  id: string;\n  type: \"started\";\n}\n\n/**\n * Final successful execution result returned by a runner.\n *\n * Node IPC can omit `undefined` fields during serialization, so `result`\n * remains optional at the protocol boundary and is normalized by the host.\n */\nexport type DoneSuccessMessage<T = unknown> = {\n  durationMs: number;\n  id: string;\n  logs: string[];\n  ok: true;\n  result?: T;\n  type: \"done\";\n};\n\n/**\n * Final failed execution result returned by a runner.\n */\nexport type DoneFailureMessage = {\n  id: string;\n  type: \"done\";\n} & Extract<ExecuteResult, { ok: false }>;\n\n/**\n * Final execution result returned by a runner.\n */\nexport type DoneMessage = DoneSuccessMessage | DoneFailureMessage;\n\n/**\n * Messages accepted by a runner transport endpoint.\n */\nexport type DispatcherMessage =\n  | CancelMessage\n  | ExecuteMessage\n  | ToolResultMessage;\n\n/**\n * Messages emitted by a runner transport endpoint.\n */\nexport type RunnerMessage = DoneMessage | StartedMessage | ToolCallMessage;\n\n/**\n * Returns whether an unknown value is a dispatcher-to-runner message.\n */\nexport function isDispatcherMessage(\n  value: unknown,\n): value is DispatcherMessage {\n  if (!isRecord(value) || typeof value.type !== \"string\") {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"cancel\":\n      return typeof value.id === \"string\";\n    case \"execute\":\n      return (\n        typeof value.code === \"string\" &&\n        typeof value.id === \"string\" &&\n        isRuntimeOptions(value.options) &&\n        Array.isArray(value.providers) &&\n        value.providers.every(isProviderManifest)\n      );\n    case \"tool_result\":\n      if (typeof value.callId !== \"string\" || typeof value.ok !== \"boolean\") {\n        return false;\n      }\n\n      if (value.ok) {\n        return \"result\" in value;\n      }\n\n      return isExecuteError(value.error);\n    default:\n      return false;\n  }\n}\n\n/**\n * Returns whether an unknown value is a runner-to-dispatcher message.\n */\nexport function isRunnerMessage(value: unknown): value is RunnerMessage {\n  if (!isRecord(value) || typeof value.type !== \"string\") {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"started\":\n      return typeof value.id === \"string\";\n    case \"tool_call\":\n      return (\n        typeof value.callId === \"string\" &&\n        typeof value.providerName === \"string\" &&\n        typeof value.safeToolName === \"string\" &&\n        \"input\" in value\n      );\n    case \"done\":\n      return typeof value.id === \"string\" && isDonePayload(value);\n    default:\n      return false;\n  }\n}\n","/**\n * @packageDocumentation\n * Public API for the `@execbox/quickjs/runner/protocol-endpoint` entrypoint.\n */\nimport { randomUUID } from \"node:crypto\";\n\nimport type {\n  DispatcherMessage,\n  ExecuteMessage,\n  RunnerMessage,\n} from \"@execbox/protocol\";\nimport type { ToolCallResult } from \"@execbox/core\";\n// This entrypoint is executed directly from source in worker/process tests before\n// workspace packages are built, so its runtime validator must stay source-local.\nimport { isDispatcherMessage } from \"../../../protocol/src/messages.ts\";\n\nimport { runQuickJsSession } from \"./index.ts\";\n\n/**\n * Minimal worker/process-side port used by the shared QuickJS protocol endpoint.\n */\nexport interface QuickJsProtocolPort {\n  onMessage(handler: (message: DispatcherMessage) => void): void | (() => void);\n  send(message: RunnerMessage): void;\n}\n\n/**\n * Attaches the shared QuickJS protocol loop to a worker/process messaging port.\n */\nexport function attachQuickJsProtocolEndpoint(\n  port: QuickJsProtocolPort,\n): () => void {\n  const pendingToolCalls = new Map<string, (result: ToolCallResult) => void>();\n  let activeAbortController: AbortController | undefined;\n  let activeExecutionId: string | undefined;\n\n  async function startExecution(message: ExecuteMessage): Promise<void> {\n    if (activeExecutionId) {\n      port.send({\n        durationMs: 0,\n        error: {\n          code: \"internal_error\",\n          message: \"QuickJS endpoint already has an active execution\",\n        },\n        id: message.id,\n        logs: [],\n        ok: false,\n        type: \"done\",\n      });\n      return;\n    }\n\n    const abortController = new AbortController();\n    activeAbortController = abortController;\n    activeExecutionId = message.id;\n\n    try {\n      const result = await runQuickJsSession(\n        {\n          abortController,\n          code: message.code,\n          onStarted: () => {\n            port.send({\n              id: message.id,\n              type: \"started\",\n            });\n          },\n          onToolCall: (call) =>\n            new Promise<ToolCallResult>((resolve) => {\n              const callId = randomUUID();\n              pendingToolCalls.set(callId, resolve);\n              port.send({\n                ...call,\n                callId,\n                type: \"tool_call\",\n              });\n            }),\n          providers: message.providers,\n        },\n        message.options,\n      );\n\n      port.send({\n        ...result,\n        id: message.id,\n        type: \"done\",\n      });\n    } catch (error) {\n      port.send({\n        durationMs: 0,\n        error: {\n          code: \"internal_error\",\n          message: error instanceof Error ? error.message : String(error),\n        },\n        id: message.id,\n        logs: [],\n        ok: false,\n        type: \"done\",\n      });\n    } finally {\n      pendingToolCalls.clear();\n      activeAbortController = undefined;\n      activeExecutionId = undefined;\n    }\n  }\n\n  const maybeDetach = port.onMessage((message: DispatcherMessage) => {\n    if (!isDispatcherMessage(message)) {\n      return;\n    }\n\n    switch (message.type) {\n      case \"cancel\":\n        if (message.id === activeExecutionId) {\n          activeAbortController?.abort();\n        }\n        break;\n      case \"execute\":\n        void startExecution(message);\n        break;\n      case \"tool_result\": {\n        const resolve = pendingToolCalls.get(message.callId);\n        pendingToolCalls.delete(message.callId);\n        resolve?.(message);\n        break;\n      }\n    }\n  });\n\n  return () => {\n    if (typeof maybeDetach === \"function\") {\n      maybeDetach();\n    }\n    pendingToolCalls.clear();\n    activeAbortController?.abort();\n    activeAbortController = undefined;\n    activeExecutionId = undefined;\n  };\n}\n"],"mappings":"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"}