@execbox/quickjs 0.2.0 → 0.3.0

package/dist/runner/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../../core/src/types.ts","../../../core/src/runner.ts","../../src/runner/index.ts"],"sourcesContent":[],"mappings":";;;;;;ACeA;AASA;AASiB,KDlBL,gBAAA,GCkB2B,SAAA,GAAA,cAAA,GAAA,kBAAA,GAAA,YAAA,GAAA,eAAA,GAAA,qBAAA,GAAA,gBAAA;AAiBvC;AASA;;UDhCiB,YAAA;;EEuBL,IAAA,EFrBJ,gBEqBI;EAKK;EACG,OAAA,EAAA,MAAA;;;;;AAIP,KFvBD,aEuBC,CAAA,IAAA,OAAA,CAAA,GAAA;EACF,UAAA,EAAA,MAAA;EAAW,IAAA,EAAA,MAAA,EAAA;EAMV,EAAA,EAAA,IAAA;EAAwB,MAAA,EFzBtB,CEyBsB;CAClC,GAAA;EACW,UAAA,EAAA,MAAA;EAAiB,KAAA,EFvBjB,YEuBiB;EA4TR,IAAA,EAAA,MAAA,EAAA;EACX,EAAA,EAAA,KAAA;CACA;;;;;;AFpXC,UCAK,oBAAA,CDAW;EAYX,WAAA,CAAA,EAAA,MAAY;EAUjB,YAAA,EAAA,MAAa;;;;ACtBzB;AASA;AASiB,UATA,gBAAA,CASsB;EAiBtB,IAAA,EAAA,MAAQ;EASb,KAAA,EAjCH,MAiCG,CAAA,MAAc,EAjCF,oBAuCC,CAAA;;;;ACfzB;AAKA;AACoB,UDvBH,sBAAA,CCuBG;EAEC,WAAA,CAAA,EAAA,MAAA;EAAqB,WAAA,CAAA,EAAA,MAAA;EAAR,gBAAA,CAAA,EAAA,MAAA;EAA0B,SAAA,CAAA,EAAA,MAAA;;;AAuU5D;;AAEW,UDjVM,QAAA,CCiVN;EACA,KAAA,EAAA,OAAA;EAAR,YAAA,EAAA,MAAA;EAAO,YAAA,EAAA,MAAA;;;;;KDzUE,cAAA;;;;SAMC;;;;;;ADlDb;AAYA;AAUY,KEaA,sBAAA,GAAyB,QFJxB;;;;AC/BI,UCwCA,qBAAA,CDxCoB;EASpB,eAAA,CAAA,ECgCG,eD9BI;EAOP,IAAA,EAAA,MAAA;EAiBA,UAAA,EAAQ,CAAA,IAAA,ECQJ,QDRI,EAAA,GCQS,ODRT,CCQiB,cDRjB,CAAA,GCQmC,cDRnC;EASb,SAAA,CAAA,EAAA,GAAA,GAAc,IAAA;aCCb;WACF;;AAXX;AAKA;;AAGqB,KAST,qBAAA,GAAwB,sBATf,GAUnB,sBAVmB,GAAA;EAAqB,MAAA,CAAA,EAW7B,iBAX6B;CAAR;;;;AAGZ,iBAoUA,iBAAA,CApUA,OAAA,EAqUX,qBArUW,EAAA,OAAA,CAAA,EAsUX,qBAtUW,CAAA,EAuUnB,OAvUmB,CAuUX,aAvUW,CAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/runner/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AA8DA,CAAA,CAAA,CAAA,SAAA,CAAA,OAAA,CAAA,IAAA,CAAA,IAAA,CAAA,IAAA,CAAA,OAAA,CAAA,IAAA,CAAA,CAAA,CAAA,OAAA,CAAA,OAAA;AAKA,CAAA,CAAA;AAEoB,IAAA,CAPR,sBAAA,CAAA,CAAA,CAAyB,QAOjB;;;;AAMwC,SAAA,CAR3C,qBAAA,CAQ2C;EAM/C,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,KAAA,CAAA,UAAA,CAAA,IAAA,CAAA,MAAA,CAAA,EAAA,CAAA,SAAA,CAAA,IAAA,CAAA,SAAA,CAAA,KAAA,CAAA,CAAA,CAAA;EAGF,eAAA,CAAA,CAAA,CAfS,eAeT;EAAW,CAAA,CAAA,CAAA,CAAA,KAAA,CAAA,UAAA,CAAA,MAAA,CAAA,EAAA,CAAA,QAAA,CAAA,MAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EAMV,IAAA,CAAA,CAAA,MAAA;EAAwB,CAAA,CAAA,CAAA,CAAA,IAAA,CAAA,QAAA,CAAA,IAAA,CAAA,EAAA,CAAA,OAAA,CAAA,KAAA,CAAA,IAAA,CAAA,KAAA,CAAA,CAAA,CAAA;EAC7B,UAAA,CAAA,CAAA,CAAA,IAAA,CAAA,CAhBc,QAgBd,CAAA,CAAA,CAAA,CAAA,CAhB2B,OAgB3B,CAhBmC,cAgBnC,CAAA,CAAA,CAAA,CAhBqD,cAgBrD;EAAL,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,IAAA,CAAA,OAAA,CAAA,IAAA,CAAA,GAAA,CAAA,KAAA,CAAA,OAAA,CAAA,GAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EAEW,SAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,IAAA;EAAiB,CAAA,CAAA,CAAA,CAAA,SAAA,CAAA,IAAA,CAAA,QAAA,CAAA,SAAA,CAAA,OAAA,CAAA,EAAA,CAAA,GAAA,CAAA,KAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EA4TR,SAAA,CAAA,CAxUT,gBAwU0B,CAAA,CAAA;EAC5B,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,MAAA,CAAA,KAAA,CAAA,KAAA,CAAA,MAAA,CAAA,GAAA,CAAA,GAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EACA,MAAA,CAAA,CAAA,CAvUA,WAuUA;;;;;KAjUC,qBAAA,CAAA,CAAA,CAAwB,yBAClC,KAAK;;WAEM;;;;;iBA4TS,iBAAA,UACX,iCACA,wBACR,QAAQ"}

package/dist/runner/index.d.ts

@@ -1,82 +1,13 @@
-import { t as QuickJsExecutorOptions } from "../types-D7uau0GM.js";
-import { QuickJSWASMModule } from "quickjs-emscripten";
-
-//#region ../core/src/types.d.ts
-
-/**
- * Stable error codes returned by executors and wrapped tool calls.
- */
-type ExecuteErrorCode = "timeout" | "memory_limit" | "validation_error" | "tool_error" | "runtime_error" | "serialization_error" | "internal_error";
-/**
- * Structured execution failure returned in {@link ExecuteResult}.
- */
-interface ExecuteError {
-  /** Machine-readable error category. */
-  code: ExecuteErrorCode;
-  /** Human-readable failure message. */
-  message: string;
-}
-/**
- * Structured result returned by every executor invocation.
- */
-type ExecuteResult<T = unknown> = {
-  durationMs: number;
-  logs: string[];
-  ok: true;
-  result: T;
-} | {
-  durationMs: number;
-  error: ExecuteError;
-  logs: string[];
-  ok: false;
-};
-//#endregion
-//#region ../core/src/runner.d.ts
-/**
- * Transport-safe metadata for one exposed tool.
- */
-interface ProviderToolManifest {
-  description?: string;
-  originalName: string;
-  safeName: string;
-}
 /**
- * Namespace manifest shared with runner implementations.
+ * @packageDocumentation
+ * Public TypeScript declarations for this package entrypoint.
  */
-interface ProviderManifest {
-  name: string;
-  tools: Record<string, ProviderToolManifest>;
-  types: string;
-}
-/**
- * Execution limits forwarded to runner implementations.
- */
-interface ExecutorRuntimeOptions {
-  maxLogChars?: number;
-  maxLogLines?: number;
-  memoryLimitBytes?: number;
-  timeoutMs?: number;
-}
-/**
- * Tool invocation request emitted from a runner.
- */
-interface ToolCall {
-  input: unknown;
-  providerName: string;
-  safeToolName: string;
-}
-/**
- * Trusted host response to a tool invocation request.
- */
-type ToolCallResult = {
-  ok: true;
-  result: unknown;
-} | {
-  error: ExecuteError;
-  ok: false;
-};
-//#endregion
+import { a as QuickJsProcessExecutorOptions, i as QuickJsInlineExecutorOptions, n as QuickJsExecutorOptions, o as QuickJsWorkerExecutorOptions, r as QuickJsHostedMode, s as WorkerResourceLimits, t as QuickJsExecutorHost } from "../types-BeVqrcj8.js";
+import { QuickJSWASMModule } from "quickjs-emscripten";
+import { ExecuteResult, ExecutorRuntimeOptions, ProviderManifest, ToolCall, ToolCallResult } from "@execbox/core";
+
 //#region src/runner/index.d.ts
+
 /**
  * Transport-neutral host tool call emitted from a QuickJS session.
  */
@@ -85,17 +16,24 @@ type QuickJsSessionToolCall = ToolCall;
  * Input required to run one transport-backed QuickJS execution session.
  */
 interface QuickJsSessionRequest {
+  /** Optional abort controller that should be triggered when execution stops. */
   abortController?: AbortController;
+  /** Guest JavaScript source to evaluate inside QuickJS. */
   code: string;
+  /** Host callback used to fulfill guest tool calls. */
   onToolCall: (call: ToolCall) => Promise<ToolCallResult> | ToolCallResult;
+  /** Optional hook invoked once the guest runtime has started. */
   onStarted?: () => void;
+  /** Transport-safe provider manifests exposed to the guest runtime. */
   providers: ProviderManifest[];
+  /** Optional caller-owned abort signal for the session. */
   signal?: AbortSignal;
 }
 /**
  * Options controlling one transport-backed QuickJS session.
  */
-type QuickJsSessionOptions = QuickJsExecutorOptions & ExecutorRuntimeOptions & {
+type QuickJsSessionOptions = ExecutorRuntimeOptions & Pick<QuickJsInlineExecutorOptions, "loadModule"> & {
+  /** Optional preloaded QuickJS WASM module instance. */
   module?: QuickJSWASMModule;
 };
 /**
@@ -103,5 +41,5 @@ type QuickJsSessionOptions = QuickJsExecutorOptions & ExecutorRuntimeOptions & {
  */
 declare function runQuickJsSession(request: QuickJsSessionRequest, options?: QuickJsSessionOptions): Promise<ExecuteResult>;
 //#endregion
-export { QuickJsSessionOptions, QuickJsSessionRequest, QuickJsSessionToolCall, runQuickJsSession };
+export { type QuickJsExecutorHost, type QuickJsExecutorOptions, type QuickJsHostedMode, type QuickJsInlineExecutorOptions, type QuickJsProcessExecutorOptions, QuickJsSessionOptions, QuickJsSessionRequest, QuickJsSessionToolCall, type QuickJsWorkerExecutorOptions, type WorkerResourceLimits, runQuickJsSession };
 //# sourceMappingURL=index.d.ts.map

package/dist/runner/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../core/src/types.ts","../../../core/src/runner.ts","../../src/runner/index.ts"],"sourcesContent":[],"mappings":";;;;;;ACeA;AASA;AASiB,KDlBL,gBAAA,GCkB2B,SAAA,GAAA,cAAA,GAAA,kBAAA,GAAA,YAAA,GAAA,eAAA,GAAA,qBAAA,GAAA,gBAAA;AAiBvC;AASA;;UDhCiB,YAAA;;EEuBL,IAAA,EFrBJ,gBEqBI;EAKK;EACG,OAAA,EAAA,MAAA;;;;;AAIP,KFvBD,aEuBC,CAAA,IAAA,OAAA,CAAA,GAAA;EACF,UAAA,EAAA,MAAA;EAAW,IAAA,EAAA,MAAA,EAAA;EAMV,EAAA,EAAA,IAAA;EAAwB,MAAA,EFzBtB,CEyBsB;CAClC,GAAA;EACW,UAAA,EAAA,MAAA;EAAiB,KAAA,EFvBjB,YEuBiB;EA4TR,IAAA,EAAA,MAAA,EAAA;EACX,EAAA,EAAA,KAAA;CACA;;;;;;AFpXC,UCAK,oBAAA,CDAW;EAYX,WAAA,CAAA,EAAA,MAAY;EAUjB,YAAA,EAAA,MAAa;;;;ACtBzB;AASA;AASiB,UATA,gBAAA,CASsB;EAiBtB,IAAA,EAAA,MAAQ;EASb,KAAA,EAjCH,MAiCG,CAAA,MAAc,EAjCF,oBAuCC,CAAA;;;;ACfzB;AAKA;AACoB,UDvBH,sBAAA,CCuBG;EAEC,WAAA,CAAA,EAAA,MAAA;EAAqB,WAAA,CAAA,EAAA,MAAA;EAAR,gBAAA,CAAA,EAAA,MAAA;EAA0B,SAAA,CAAA,EAAA,MAAA;;;AAuU5D;;AAEW,UDjVM,QAAA,CCiVN;EACA,KAAA,EAAA,OAAA;EAAR,YAAA,EAAA,MAAA;EAAO,YAAA,EAAA,MAAA;;;;;KDzUE,cAAA;;;;SAMC;;;;;;ADlDb;AAYA;AAUY,KEaA,sBAAA,GAAyB,QFJxB;;;;AC/BI,UCwCA,qBAAA,CDxCoB;EASpB,eAAA,CAAA,ECgCG,eD9BI;EAOP,IAAA,EAAA,MAAA;EAiBA,UAAA,EAAQ,CAAA,IAAA,ECQJ,QDRI,EAAA,GCQS,ODRT,CCQiB,cDRjB,CAAA,GCQmC,cDRnC;EASb,SAAA,CAAA,EAAA,GAAA,GAAc,IAAA;aCCb;WACF;;AAXX;AAKA;;AAGqB,KAST,qBAAA,GAAwB,sBATf,GAUnB,sBAVmB,GAAA;EAAqB,MAAA,CAAA,EAW7B,iBAX6B;CAAR;;;;AAGZ,iBAoUA,iBAAA,CApUA,OAAA,EAqUX,qBArUW,EAAA,OAAA,CAAA,EAsUX,qBAtUW,CAAA,EAuUnB,OAvUmB,CAuUX,aAvUW,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/runner/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AA8DA,CAAA,CAAA,CAAA,SAAA,CAAA,OAAA,CAAA,IAAA,CAAA,IAAA,CAAA,IAAA,CAAA,OAAA,CAAA,IAAA,CAAA,CAAA,CAAA,OAAA,CAAA,OAAA;AAKA,CAAA,CAAA;AAEoB,IAAA,CAPR,sBAAA,CAAA,CAAA,CAAyB,QAOjB;;;;AAMwC,SAAA,CAR3C,qBAAA,CAQ2C;EAM/C,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,KAAA,CAAA,UAAA,CAAA,IAAA,CAAA,MAAA,CAAA,EAAA,CAAA,SAAA,CAAA,IAAA,CAAA,SAAA,CAAA,KAAA,CAAA,CAAA,CAAA;EAGF,eAAA,CAAA,CAAA,CAfS,eAeT;EAAW,CAAA,CAAA,CAAA,CAAA,KAAA,CAAA,UAAA,CAAA,MAAA,CAAA,EAAA,CAAA,QAAA,CAAA,MAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EAMV,IAAA,CAAA,CAAA,MAAA;EAAwB,CAAA,CAAA,CAAA,CAAA,IAAA,CAAA,QAAA,CAAA,IAAA,CAAA,EAAA,CAAA,OAAA,CAAA,KAAA,CAAA,IAAA,CAAA,KAAA,CAAA,CAAA,CAAA;EAC7B,UAAA,CAAA,CAAA,CAAA,IAAA,CAAA,CAhBc,QAgBd,CAAA,CAAA,CAAA,CAAA,CAhB2B,OAgB3B,CAhBmC,cAgBnC,CAAA,CAAA,CAAA,CAhBqD,cAgBrD;EAAL,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,IAAA,CAAA,OAAA,CAAA,IAAA,CAAA,GAAA,CAAA,KAAA,CAAA,OAAA,CAAA,GAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EAEW,SAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,IAAA;EAAiB,CAAA,CAAA,CAAA,CAAA,SAAA,CAAA,IAAA,CAAA,QAAA,CAAA,SAAA,CAAA,OAAA,CAAA,EAAA,CAAA,GAAA,CAAA,KAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EA4TR,SAAA,CAAA,CAxUT,gBAwU0B,CAAA,CAAA;EAC5B,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,MAAA,CAAA,KAAA,CAAA,KAAA,CAAA,MAAA,CAAA,GAAA,CAAA,GAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EACA,MAAA,CAAA,CAAA,CAvUA,WAuUA;;;;;KAjUC,qBAAA,CAAA,CAAA,CAAwB,yBAClC,KAAK;;WAEM;;;;;iBA4TS,iBAAA,UACX,iCACA,wBACR,QAAQ"}

package/dist/runner/index.js

@@ -1,3 +1,3 @@
-import { t as runQuickJsSession } from "../runner-B4UG88h1.js";
+import { t as runQuickJsSession } from "../runner-CteKTaPD.js";
 
 export { runQuickJsSession };

package/dist/runner/protocolEndpoint.cjs

@@ -1,138 +1,4 @@
-const require_runner = require('../runner-DhOZH9xz.cjs');
-let node_crypto = require("node:crypto");
+require('../runner-DRt0kpEk.cjs');
+const require_protocolEndpoint = require('../protocolEndpoint-A1JBvHG_.cjs');
 
-//#region ../protocol/src/messages.ts
-function isRecord(value) {
-	return typeof value === "object" && value !== null;
-}
-function isFiniteNumber(value) {
-	return typeof value === "number" && Number.isFinite(value);
-}
-function isRuntimeOptions(value) {
-	if (!isRecord(value)) return false;
-	return isFiniteNumber(value.maxLogChars) && isFiniteNumber(value.maxLogLines) && isFiniteNumber(value.memoryLimitBytes) && isFiniteNumber(value.timeoutMs);
-}
-function isProviderManifest(value) {
-	if (!isRecord(value) || typeof value.name !== "string") return false;
-	if (!isRecord(value.tools) || typeof value.types !== "string") return false;
-	return Object.values(value.tools).every((tool) => isRecord(tool) && typeof tool.originalName === "string" && typeof tool.safeName === "string" && (tool.description === void 0 || typeof tool.description === "string"));
-}
-function isExecuteError(value) {
-	return isRecord(value) && typeof value.code === "string" && typeof value.message === "string";
-}
-/**
-* Returns whether an unknown value is a dispatcher-to-runner message.
-*/
-function isDispatcherMessage(value) {
-	if (!isRecord(value) || typeof value.type !== "string") return false;
-	switch (value.type) {
-		case "cancel": return typeof value.id === "string";
-		case "execute": return typeof value.code === "string" && typeof value.id === "string" && isRuntimeOptions(value.options) && Array.isArray(value.providers) && value.providers.every(isProviderManifest);
-		case "tool_result":
-			if (typeof value.callId !== "string" || typeof value.ok !== "boolean") return false;
-			if (value.ok) return "result" in value;
-			return isExecuteError(value.error);
-		default: return false;
-	}
-}
-
-//#endregion
-//#region src/runner/protocolEndpoint.ts
-/**
-* Attaches the shared QuickJS protocol loop to a worker/process messaging port.
-*/
-function attachQuickJsProtocolEndpoint(port) {
-	const pendingToolCalls = /* @__PURE__ */ new Map();
-	let activeAbortController;
-	let activeExecutionId;
-	async function startExecution(message) {
-		if (activeExecutionId) {
-			port.send({
-				durationMs: 0,
-				error: {
-					code: "internal_error",
-					message: "QuickJS endpoint already has an active execution"
-				},
-				id: message.id,
-				logs: [],
-				ok: false,
-				type: "done"
-			});
-			return;
-		}
-		const abortController = new AbortController();
-		activeAbortController = abortController;
-		activeExecutionId = message.id;
-		try {
-			const result = await require_runner.runQuickJsSession({
-				abortController,
-				code: message.code,
-				onStarted: () => {
-					port.send({
-						id: message.id,
-						type: "started"
-					});
-				},
-				onToolCall: (call) => new Promise((resolve) => {
-					const callId = (0, node_crypto.randomUUID)();
-					pendingToolCalls.set(callId, resolve);
-					port.send({
-						...call,
-						callId,
-						type: "tool_call"
-					});
-				}),
-				providers: message.providers
-			}, message.options);
-			port.send({
-				...result,
-				id: message.id,
-				type: "done"
-			});
-		} catch (error) {
-			port.send({
-				durationMs: 0,
-				error: {
-					code: "internal_error",
-					message: error instanceof Error ? error.message : String(error)
-				},
-				id: message.id,
-				logs: [],
-				ok: false,
-				type: "done"
-			});
-		} finally {
-			pendingToolCalls.clear();
-			activeAbortController = void 0;
-			activeExecutionId = void 0;
-		}
-	}
-	const maybeDetach = port.onMessage((message) => {
-		if (!isDispatcherMessage(message)) return;
-		switch (message.type) {
-			case "cancel":
-				if (message.id === activeExecutionId) activeAbortController?.abort();
-				break;
-			case "execute":
-				startExecution(message);
-				break;
-			case "tool_result": {
-				const resolve = pendingToolCalls.get(message.callId);
-				pendingToolCalls.delete(message.callId);
-				resolve?.(message);
-				break;
-			}
-		}
-	});
-	return () => {
-		if (typeof maybeDetach === "function") maybeDetach();
-		pendingToolCalls.clear();
-		activeAbortController?.abort();
-		activeAbortController = void 0;
-		activeExecutionId = void 0;
-	};
-}
-
-//#endregion
-exports.attachQuickJsProtocolEndpoint = attachQuickJsProtocolEndpoint;
-//# sourceMappingURL=protocolEndpoint.cjs.map
+exports.attachQuickJsProtocolEndpoint = require_protocolEndpoint.attachQuickJsProtocolEndpoint;

package/dist/runner/protocolEndpoint.d.cts

@@ -1,3 +1,7 @@
+/**
+ * @packageDocumentation
+ * Public TypeScript declarations for this package entrypoint.
+ */
 import { DispatcherMessage, RunnerMessage } from "@execbox/protocol";
 
 //#region src/runner/protocolEndpoint.d.ts

package/dist/runner/protocolEndpoint.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"protocolEndpoint.d.cts","names":[],"sources":["../../src/runner/protocolEndpoint.ts"],"sourcesContent":[],"mappings":";;;;;;AAeA;AAQgB,UARC,mBAAA,CAQ4B;+BAPd;gBACf;;;;;iBAMA,6BAAA,OACR"}
+{"version":3,"file":"protocolEndpoint.d.cts","names":[],"sources":["../../src/runner/protocolEndpoint.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAqBA,CAAA,CAAA;AAQgB,SAAA,CARC,mBAAA,CAQ4B;+BAPd;gBACf;;;;;iBAMA,6BAAA,OACR"}

package/dist/runner/protocolEndpoint.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @packageDocumentation
+ * Public TypeScript declarations for this package entrypoint.
+ */
 import { DispatcherMessage, RunnerMessage } from "@execbox/protocol";
 
 //#region src/runner/protocolEndpoint.d.ts

package/dist/runner/protocolEndpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocolEndpoint.d.ts","names":[],"sources":["../../src/runner/protocolEndpoint.ts"],"sourcesContent":[],"mappings":";;;;;;AAeA;AAQgB,UARC,mBAAA,CAQ4B;+BAPd;gBACf;;;;;iBAMA,6BAAA,OACR"}
+{"version":3,"file":"protocolEndpoint.d.ts","names":[],"sources":["../../src/runner/protocolEndpoint.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAqBA,CAAA,CAAA;AAQgB,SAAA,CARC,mBAAA,CAQ4B;+BAPd;gBACf;;;;;iBAMA,6BAAA,OACR"}

package/dist/runner/protocolEndpoint.js

@@ -1,138 +1,4 @@
-import { t as runQuickJsSession } from "../runner-B4UG88h1.js";
-import { randomUUID } from "node:crypto";
+import "../runner-CteKTaPD.js";
+import { t as attachQuickJsProtocolEndpoint } from "../protocolEndpoint-CDGgtfFu.js";
 
-//#region ../protocol/src/messages.ts
-function isRecord(value) {
-	return typeof value === "object" && value !== null;
-}
-function isFiniteNumber(value) {
-	return typeof value === "number" && Number.isFinite(value);
-}
-function isRuntimeOptions(value) {
-	if (!isRecord(value)) return false;
-	return isFiniteNumber(value.maxLogChars) && isFiniteNumber(value.maxLogLines) && isFiniteNumber(value.memoryLimitBytes) && isFiniteNumber(value.timeoutMs);
-}
-function isProviderManifest(value) {
-	if (!isRecord(value) || typeof value.name !== "string") return false;
-	if (!isRecord(value.tools) || typeof value.types !== "string") return false;
-	return Object.values(value.tools).every((tool) => isRecord(tool) && typeof tool.originalName === "string" && typeof tool.safeName === "string" && (tool.description === void 0 || typeof tool.description === "string"));
-}
-function isExecuteError(value) {
-	return isRecord(value) && typeof value.code === "string" && typeof value.message === "string";
-}
-/**
-* Returns whether an unknown value is a dispatcher-to-runner message.
-*/
-function isDispatcherMessage(value) {
-	if (!isRecord(value) || typeof value.type !== "string") return false;
-	switch (value.type) {
-		case "cancel": return typeof value.id === "string";
-		case "execute": return typeof value.code === "string" && typeof value.id === "string" && isRuntimeOptions(value.options) && Array.isArray(value.providers) && value.providers.every(isProviderManifest);
-		case "tool_result":
-			if (typeof value.callId !== "string" || typeof value.ok !== "boolean") return false;
-			if (value.ok) return "result" in value;
-			return isExecuteError(value.error);
-		default: return false;
-	}
-}
-
-//#endregion
-//#region src/runner/protocolEndpoint.ts
-/**
-* Attaches the shared QuickJS protocol loop to a worker/process messaging port.
-*/
-function attachQuickJsProtocolEndpoint(port) {
-	const pendingToolCalls = /* @__PURE__ */ new Map();
-	let activeAbortController;
-	let activeExecutionId;
-	async function startExecution(message) {
-		if (activeExecutionId) {
-			port.send({
-				durationMs: 0,
-				error: {
-					code: "internal_error",
-					message: "QuickJS endpoint already has an active execution"
-				},
-				id: message.id,
-				logs: [],
-				ok: false,
-				type: "done"
-			});
-			return;
-		}
-		const abortController = new AbortController();
-		activeAbortController = abortController;
-		activeExecutionId = message.id;
-		try {
-			const result = await runQuickJsSession({
-				abortController,
-				code: message.code,
-				onStarted: () => {
-					port.send({
-						id: message.id,
-						type: "started"
-					});
-				},
-				onToolCall: (call) => new Promise((resolve) => {
-					const callId = randomUUID();
-					pendingToolCalls.set(callId, resolve);
-					port.send({
-						...call,
-						callId,
-						type: "tool_call"
-					});
-				}),
-				providers: message.providers
-			}, message.options);
-			port.send({
-				...result,
-				id: message.id,
-				type: "done"
-			});
-		} catch (error) {
-			port.send({
-				durationMs: 0,
-				error: {
-					code: "internal_error",
-					message: error instanceof Error ? error.message : String(error)
-				},
-				id: message.id,
-				logs: [],
-				ok: false,
-				type: "done"
-			});
-		} finally {
-			pendingToolCalls.clear();
-			activeAbortController = void 0;
-			activeExecutionId = void 0;
-		}
-	}
-	const maybeDetach = port.onMessage((message) => {
-		if (!isDispatcherMessage(message)) return;
-		switch (message.type) {
-			case "cancel":
-				if (message.id === activeExecutionId) activeAbortController?.abort();
-				break;
-			case "execute":
-				startExecution(message);
-				break;
-			case "tool_result": {
-				const resolve = pendingToolCalls.get(message.callId);
-				pendingToolCalls.delete(message.callId);
-				resolve?.(message);
-				break;
-			}
-		}
-	});
-	return () => {
-		if (typeof maybeDetach === "function") maybeDetach();
-		pendingToolCalls.clear();
-		activeAbortController?.abort();
-		activeAbortController = void 0;
-		activeExecutionId = void 0;
-	};
-}
-
-//#endregion
-export { attachQuickJsProtocolEndpoint };
-//# sourceMappingURL=protocolEndpoint.js.map
+export { attachQuickJsProtocolEndpoint };

package/dist/{runner-B4UG88h1.js → runner-CteKTaPD.js}

@@ -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 = memoizePromiseFactory(() => newQuickJSWASMModule(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,5 +5650,5 @@ async function runQuickJsSession(request, options = {}) {
 }
 
 //#endregion
-export { runQuickJsSession as t };
-//# sourceMappingURL=runner-B4UG88h1.js.map
+export { isJsonSerializable as a, getExecutionTimeoutMessage as c, isExecuteFailure as i, normalizeThrownMessage as l, resolveExecutorRuntimeOptions as n, createExecutionContext as o, ExecuteFailure as r, createTimeoutExecuteResult as s, runQuickJsSession as t };
+//# sourceMappingURL=runner-CteKTaPD.js.map