@execbox/quickjs 0.2.0 → 0.3.0

package/dist/{runner-DhOZH9xz.cjs → runner-DRt0kpEk.cjs}

@@ -28,6 +28,20 @@ function getExecutionTimeoutMessage() {
 	return EXECUTION_TIMEOUT_MESSAGE;
 }
 /**
+* Creates the canonical timeout failure result used for preflight cancellation.
+*/
+function createTimeoutExecuteResult(durationMs = 0) {
+	return {
+		durationMs,
+		error: {
+			code: "timeout",
+			message: getExecutionTimeoutMessage()
+		},
+		logs: [],
+		ok: false
+	};
+}
+/**
 * Normalizes an unknown thrown value into a human-readable message.
 */
 function normalizeThrownMessage(error) {
@@ -39,6 +53,17 @@ function normalizeThrownMessage(error) {
 	return String(error);
 }
 /**
+* Builds the standard tool execution context passed to resolved tool wrappers.
+*/
+function createExecutionContext(signal, providerName, safeToolName, originalToolName) {
+	return {
+		originalToolName,
+		providerName,
+		safeToolName,
+		signal
+	};
+}
+/**
 * Truncates captured logs to the configured line and character limits.
 */
 function truncateLogs(logs, maxLogLines, maxLogChars) {
@@ -5226,6 +5251,66 @@ var ExecuteFailure = class extends Error {
 function isExecuteFailure(value) {
 	return value instanceof ExecuteFailure;
 }
+/**
+* Returns whether a value can be serialized through the JSON-only host/guest boundary.
+*/
+function isJsonSerializable(value, active = /* @__PURE__ */ new Set(), memo = /* @__PURE__ */ new WeakSet()) {
+	if (value === null) return true;
+	switch (typeof value) {
+		case "string":
+		case "boolean": return true;
+		case "number": return Number.isFinite(value);
+		case "bigint":
+		case "function":
+		case "symbol":
+		case "undefined": return false;
+		case "object": {
+			const objectValue = value;
+			if (memo.has(objectValue)) return true;
+			if (active.has(objectValue)) return false;
+			active.add(objectValue);
+			let isSerializable = false;
+			try {
+				if (Array.isArray(value)) {
+					isSerializable = value.every((item) => isJsonSerializable(item, active, memo));
+					return isSerializable;
+				}
+				const prototype = Object.getPrototypeOf(value);
+				if (prototype !== Object.prototype && prototype !== null) return false;
+				isSerializable = Object.values(value).every((item) => isJsonSerializable(item, active, memo));
+				return isSerializable;
+			} finally {
+				active.delete(objectValue);
+				if (isSerializable) memo.add(objectValue);
+			}
+		}
+	}
+	return false;
+}
+
+//#endregion
+//#region ../core/src/runtimeOptions.ts
+/**
+* Default runtime limits shared across the built-in executor implementations.
+*/
+const DEFAULT_EXECUTOR_RUNTIME_OPTIONS = {
+	maxLogChars: 64e3,
+	maxLogLines: 100,
+	memoryLimitBytes: 64 * 1024 * 1024,
+	timeoutMs: 5e3
+};
+/**
+* Resolves executor runtime limits by applying explicit overrides on top of a
+* base options object and finally the shared defaults.
+*/
+function resolveExecutorRuntimeOptions(options = {}, overrides = {}) {
+	return {
+		maxLogChars: overrides.maxLogChars ?? options.maxLogChars ?? DEFAULT_EXECUTOR_RUNTIME_OPTIONS.maxLogChars,
+		maxLogLines: overrides.maxLogLines ?? options.maxLogLines ?? DEFAULT_EXECUTOR_RUNTIME_OPTIONS.maxLogLines,
+		memoryLimitBytes: overrides.memoryLimitBytes ?? options.memoryLimitBytes ?? DEFAULT_EXECUTOR_RUNTIME_OPTIONS.memoryLimitBytes,
+		timeoutMs: overrides.timeoutMs ?? options.timeoutMs ?? DEFAULT_EXECUTOR_RUNTIME_OPTIONS.timeoutMs
+	};
+}
 
 //#endregion
 //#region src/quickjsBridge.ts
@@ -5282,10 +5367,10 @@ function toGuestHandle(context, value) {
 
 //#endregion
 //#region src/runner/index.ts
-const DEFAULT_MEMORY_LIMIT_BYTES = 64 * 1024 * 1024;
-const DEFAULT_TIMEOUT_MS = 5e3;
-const DEFAULT_MAX_LOG_LINES = 100;
-const DEFAULT_MAX_LOG_CHARS = 64e3;
+/**
+* @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.
@@ -5479,14 +5564,12 @@ function createToolHandle(context, providerName, safeToolName, signal, trustedHo
 * Runs one QuickJS-backed execution session using a transport-neutral tool callback.
 */
 async function runQuickJsSession(request, options = {}) {
+	const runtimeOptions = resolveExecutorRuntimeOptions(options);
 	const loadModule = async () => {
 		if (options.module) return options.module;
 		return options.loadModule ? await options.loadModule() : await loadDefaultModule();
 	};
-	const maxLogChars = options.maxLogChars ?? DEFAULT_MAX_LOG_CHARS;
-	const maxLogLines = options.maxLogLines ?? DEFAULT_MAX_LOG_LINES;
-	const memoryLimitBytes = options.memoryLimitBytes ?? DEFAULT_MEMORY_LIMIT_BYTES;
-	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	const { maxLogChars, maxLogLines, memoryLimitBytes, timeoutMs } = runtimeOptions;
 	const startedAt = Date.now();
 	const logs = [];
 	const abortController = new AbortController();
@@ -5567,10 +5650,58 @@ async function runQuickJsSession(request, options = {}) {
 }
 
 //#endregion
+Object.defineProperty(exports, 'ExecuteFailure', {
+  enumerable: true,
+  get: function () {
+    return ExecuteFailure;
+  }
+});
+Object.defineProperty(exports, 'createExecutionContext', {
+  enumerable: true,
+  get: function () {
+    return createExecutionContext;
+  }
+});
+Object.defineProperty(exports, 'createTimeoutExecuteResult', {
+  enumerable: true,
+  get: function () {
+    return createTimeoutExecuteResult;
+  }
+});
+Object.defineProperty(exports, 'getExecutionTimeoutMessage', {
+  enumerable: true,
+  get: function () {
+    return getExecutionTimeoutMessage;
+  }
+});
+Object.defineProperty(exports, 'isExecuteFailure', {
+  enumerable: true,
+  get: function () {
+    return isExecuteFailure;
+  }
+});
+Object.defineProperty(exports, 'isJsonSerializable', {
+  enumerable: true,
+  get: function () {
+    return isJsonSerializable;
+  }
+});
+Object.defineProperty(exports, 'normalizeThrownMessage', {
+  enumerable: true,
+  get: function () {
+    return normalizeThrownMessage;
+  }
+});
+Object.defineProperty(exports, 'resolveExecutorRuntimeOptions', {
+  enumerable: true,
+  get: function () {
+    return resolveExecutorRuntimeOptions;
+  }
+});
 Object.defineProperty(exports, 'runQuickJsSession', {
   enumerable: true,
   get: function () {
     return runQuickJsSession;
   }
 });
-//# sourceMappingURL=runner-DhOZH9xz.cjs.map
+//# sourceMappingURL=runner-DRt0kpEk.cjs.map