@execbox/core 0.1.0

package/dist/index.cjs

@@ -0,0 +1,242 @@
+const require_resolveProvider = require('./resolveProvider-CixOjPKp.cjs');
+let acorn = require("acorn");
+
+//#region src/executor/shared.ts
+const EXECUTION_TIMEOUT_MESSAGE = "Execution timed out";
+/**
+* Canonical error codes that may safely cross trusted executor boundaries.
+*/
+const KNOWN_EXECUTE_ERROR_CODES = new Set([
+	"timeout",
+	"memory_limit",
+	"validation_error",
+	"tool_error",
+	"runtime_error",
+	"serialization_error",
+	"internal_error"
+]);
+/**
+* Returns whether the value is one of execbox's stable execution error codes.
+*/
+function isKnownExecuteErrorCode(value) {
+	return KNOWN_EXECUTE_ERROR_CODES.has(value);
+}
+/**
+* Returns the stable timeout message used across executor implementations.
+*/
+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) {
+	if (error instanceof Error) return error.message;
+	if (typeof error === "object" && error !== null && "message" in error) {
+		const message = error.message;
+		if (typeof message === "string") return message;
+	}
+	return String(error);
+}
+/**
+* Returns the thrown error name when one is available.
+*/
+function normalizeThrownName(error) {
+	if (error instanceof Error) return error.name;
+	if (typeof error === "object" && error !== null && "name" in error) {
+		const name = error.name;
+		if (typeof name === "string") return name;
+	}
+}
+/**
+* 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) {
+	const limitedLines = logs.slice(0, maxLogLines);
+	let remainingChars = maxLogChars;
+	const truncated = [];
+	for (const line of limitedLines) {
+		if (remainingChars <= 0) break;
+		if (line.length <= remainingChars) {
+			truncated.push(line);
+			remainingChars -= line.length;
+			continue;
+		}
+		truncated.push(line.slice(0, remainingChars));
+		break;
+	}
+	return truncated;
+}
+function formatLogValue(value) {
+	if (typeof value === "string") return value;
+	if (value === void 0) return "undefined";
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return String(value);
+	}
+}
+/**
+* Formats guest console arguments into a single host-side log line.
+*/
+function formatConsoleLine(values) {
+	return values.map((value) => formatLogValue(value)).join(" ");
+}
+
+//#endregion
+//#region src/normalize.ts
+function stripCodeFences(source) {
+	const match = source.match(/^\s*```[^\n]*\n([\s\S]*?)\n?```\s*$/);
+	return match ? match[1] : source;
+}
+function wrapAsync(body) {
+	if (body.trim().length === 0) return "async () => {}";
+	return `async () => {\n${body}\n}`;
+}
+/**
+* Normalizes model-produced JavaScript into an executable async function body.
+*/
+function normalizeCode(source) {
+	const normalizedSource = stripCodeFences(source).trim();
+	if (normalizedSource.length === 0) return "async () => {}";
+	try {
+		const program = (0, acorn.parse)(normalizedSource, {
+			ecmaVersion: "latest",
+			sourceType: "module"
+		});
+		if (program.body?.length === 1) {
+			const [statement] = program.body;
+			if (statement.type === "FunctionDeclaration" && statement.id?.name) return wrapAsync(`${normalizedSource}\nreturn ${statement.id.name}();`);
+			if (statement.type === "ExpressionStatement" && statement.expression) {
+				if (statement.expression.type === "ArrowFunctionExpression" && statement.expression.async) return normalizedSource;
+				return wrapAsync(`return (${normalizedSource});`);
+			}
+		}
+		const lastStatement = (program.body ?? []).at(-1);
+		if (lastStatement?.type === "ExpressionStatement" && lastStatement.expression) {
+			const bodyPrefix = normalizedSource.slice(0, lastStatement.start).trimEnd();
+			const expressionSource = normalizedSource.slice(lastStatement.expression.start, lastStatement.expression.end);
+			const lines = [];
+			if (bodyPrefix.length > 0) lines.push(bodyPrefix);
+			lines.push(`return (${expressionSource});`);
+			return wrapAsync(lines.join("\n"));
+		}
+		return wrapAsync(normalizedSource);
+	} catch {
+		return wrapAsync(normalizedSource);
+	}
+}
+
+//#endregion
+//#region src/runner.ts
+function toTrustedExecuteError(error) {
+	if (require_resolveProvider.isExecuteFailure(error)) return {
+		code: error.code,
+		message: error.message
+	};
+	return {
+		code: "tool_error",
+		message: normalizeThrownMessage(error)
+	};
+}
+/**
+* Converts resolved providers into manifest metadata that reveals only namespace details.
+*/
+function extractProviderManifests(providers) {
+	return providers.map((provider) => ({
+		name: provider.name,
+		tools: Object.fromEntries(Object.entries(provider.tools).map(([safeToolName, descriptor]) => [safeToolName, {
+			description: descriptor.description,
+			originalName: descriptor.originalName,
+			safeName: descriptor.safeName
+		}])),
+		types: provider.types
+	}));
+}
+/**
+* Creates a host-side dispatcher for runner-emitted tool calls.
+*/
+function createToolCallDispatcher(providers, signal) {
+	const providerMap = new Map(providers.map((provider) => [provider.name, provider]));
+	return async (call) => {
+		const provider = providerMap.get(call.providerName);
+		const descriptor = provider?.tools[call.safeToolName];
+		if (!provider || !descriptor) return {
+			error: {
+				code: "internal_error",
+				message: `Unknown tool ${call.providerName}.${call.safeToolName}`
+			},
+			ok: false
+		};
+		try {
+			if (signal.aborted) return {
+				error: {
+					code: "timeout",
+					message: getExecutionTimeoutMessage()
+				},
+				ok: false
+			};
+			const result = await descriptor.execute(call.input, createExecutionContext(signal, provider.name, descriptor.safeName, descriptor.originalName));
+			if (result !== void 0 && !require_resolveProvider.isJsonSerializable(result)) throw new require_resolveProvider.ExecuteFailure("serialization_error", "Host value is not JSON-serializable");
+			return {
+				ok: true,
+				result
+			};
+		} catch (error) {
+			return {
+				error: toTrustedExecuteError(error),
+				ok: false
+			};
+		}
+	};
+}
+
+//#endregion
+exports.ExecuteFailure = require_resolveProvider.ExecuteFailure;
+exports.assertValidIdentifier = require_resolveProvider.assertValidIdentifier;
+exports.createExecutionContext = createExecutionContext;
+exports.createTimeoutExecuteResult = createTimeoutExecuteResult;
+exports.createToolCallDispatcher = createToolCallDispatcher;
+exports.extractProviderManifests = extractProviderManifests;
+exports.formatConsoleLine = formatConsoleLine;
+exports.generateTypesFromJsonSchema = require_resolveProvider.generateTypesFromJsonSchema;
+exports.getExecutionTimeoutMessage = getExecutionTimeoutMessage;
+exports.isExecuteFailure = require_resolveProvider.isExecuteFailure;
+exports.isJsonSerializable = require_resolveProvider.isJsonSerializable;
+exports.isKnownExecuteErrorCode = isKnownExecuteErrorCode;
+exports.isReservedWord = require_resolveProvider.isReservedWord;
+exports.isValidIdentifier = require_resolveProvider.isValidIdentifier;
+exports.normalizeCode = normalizeCode;
+exports.normalizeThrownMessage = normalizeThrownMessage;
+exports.normalizeThrownName = normalizeThrownName;
+exports.resolveProvider = require_resolveProvider.resolveProvider;
+exports.sanitizeIdentifier = require_resolveProvider.sanitizeIdentifier;
+exports.sanitizeToolName = require_resolveProvider.sanitizeToolName;
+exports.serializePropertyName = require_resolveProvider.serializePropertyName;
+exports.truncateLogs = truncateLogs;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["truncated: string[]","isExecuteFailure","isJsonSerializable","ExecuteFailure"],"sources":["../src/executor/shared.ts","../src/normalize.ts","../src/runner.ts"],"sourcesContent":["import type {\n  ExecuteError,\n  ExecuteErrorCode,\n  ExecuteResult,\n  ToolExecutionContext,\n} from \"../types\";\n\nconst EXECUTION_TIMEOUT_MESSAGE = \"Execution timed out\";\n\n/**\n * Canonical error codes that may safely cross trusted executor boundaries.\n */\nconst KNOWN_EXECUTE_ERROR_CODES = new Set<ExecuteErrorCode>([\n  \"timeout\",\n  \"memory_limit\",\n  \"validation_error\",\n  \"tool_error\",\n  \"runtime_error\",\n  \"serialization_error\",\n  \"internal_error\",\n]);\n\n/**\n * Returns whether the value is one of execbox's stable execution error codes.\n */\nexport function isKnownExecuteErrorCode(\n  value: unknown,\n): value is ExecuteErrorCode {\n  return KNOWN_EXECUTE_ERROR_CODES.has(value as ExecuteErrorCode);\n}\n\n/**\n * Returns the stable timeout message used across executor implementations.\n */\nexport function getExecutionTimeoutMessage(): string {\n  return EXECUTION_TIMEOUT_MESSAGE;\n}\n\n/**\n * Creates the canonical timeout failure result used for preflight cancellation.\n */\nexport function createTimeoutExecuteResult(durationMs = 0): ExecuteResult {\n  return {\n    durationMs,\n    error: {\n      code: \"timeout\",\n      message: getExecutionTimeoutMessage(),\n    } satisfies ExecuteError,\n    logs: [],\n    ok: false,\n  };\n}\n\n/**\n * Normalizes an unknown thrown value into a human-readable message.\n */\nexport function normalizeThrownMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  if (typeof error === \"object\" && error !== null && \"message\" in error) {\n    const message = (error as { message?: unknown }).message;\n    if (typeof message === \"string\") {\n      return message;\n    }\n  }\n\n  return String(error);\n}\n\n/**\n * Returns the thrown error name when one is available.\n */\nexport function normalizeThrownName(error: unknown): string | undefined {\n  if (error instanceof Error) {\n    return error.name;\n  }\n\n  if (typeof error === \"object\" && error !== null && \"name\" in error) {\n    const name = (error as { name?: unknown }).name;\n    if (typeof name === \"string\") {\n      return name;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Builds the standard tool execution context passed to resolved tool wrappers.\n */\nexport function createExecutionContext(\n  signal: AbortSignal,\n  providerName: string,\n  safeToolName: string,\n  originalToolName: string,\n): ToolExecutionContext {\n  return {\n    originalToolName,\n    providerName,\n    safeToolName,\n    signal,\n  };\n}\n\n/**\n * Truncates captured logs to the configured line and character limits.\n */\nexport function truncateLogs(\n  logs: string[],\n  maxLogLines: number,\n  maxLogChars: number,\n): string[] {\n  const limitedLines = logs.slice(0, maxLogLines);\n  let remainingChars = maxLogChars;\n  const truncated: string[] = [];\n\n  for (const line of limitedLines) {\n    if (remainingChars <= 0) {\n      break;\n    }\n\n    if (line.length <= remainingChars) {\n      truncated.push(line);\n      remainingChars -= line.length;\n      continue;\n    }\n\n    truncated.push(line.slice(0, remainingChars));\n    break;\n  }\n\n  return truncated;\n}\n\nfunction formatLogValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (value === undefined) {\n    return \"undefined\";\n  }\n\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/**\n * Formats guest console arguments into a single host-side log line.\n */\nexport function formatConsoleLine(values: unknown[]): string {\n  return values.map((value) => formatLogValue(value)).join(\" \");\n}\n","import { parse } from \"acorn\";\nimport type { Node } from \"acorn\";\n\ntype PositionedNode = Node & {\n  end: number;\n  start: number;\n  body?: PositionedNode[];\n  expression?: PositionedNode;\n  async?: boolean;\n  id?: {\n    name: string;\n  };\n};\n\nfunction stripCodeFences(source: string): string {\n  const match = source.match(/^\\s*```[^\\n]*\\n([\\s\\S]*?)\\n?```\\s*$/);\n  return match ? match[1] : source;\n}\n\nfunction wrapAsync(body: string): string {\n  if (body.trim().length === 0) {\n    return \"async () => {}\";\n  }\n\n  return `async () => {\\n${body}\\n}`;\n}\n\n/**\n * Normalizes model-produced JavaScript into an executable async function body.\n */\nexport function normalizeCode(source: string): string {\n  const normalizedSource = stripCodeFences(source).trim();\n\n  if (normalizedSource.length === 0) {\n    return \"async () => {}\";\n  }\n\n  try {\n    const program = parse(normalizedSource, {\n      ecmaVersion: \"latest\",\n      sourceType: \"module\",\n    }) as PositionedNode;\n\n    if (program.body?.length === 1) {\n      const [statement] = program.body;\n\n      if (statement.type === \"FunctionDeclaration\" && statement.id?.name) {\n        return wrapAsync(`${normalizedSource}\\nreturn ${statement.id.name}();`);\n      }\n\n      if (statement.type === \"ExpressionStatement\" && statement.expression) {\n        if (\n          statement.expression.type === \"ArrowFunctionExpression\" &&\n          statement.expression.async\n        ) {\n          return normalizedSource;\n        }\n\n        return wrapAsync(`return (${normalizedSource});`);\n      }\n    }\n\n    const body = program.body ?? [];\n    const lastStatement = body.at(-1);\n\n    if (\n      lastStatement?.type === \"ExpressionStatement\" &&\n      lastStatement.expression\n    ) {\n      const bodyPrefix = normalizedSource\n        .slice(0, lastStatement.start)\n        .trimEnd();\n      const expressionSource = normalizedSource.slice(\n        lastStatement.expression.start,\n        lastStatement.expression.end,\n      );\n\n      const lines = [];\n\n      if (bodyPrefix.length > 0) {\n        lines.push(bodyPrefix);\n      }\n\n      lines.push(`return (${expressionSource});`);\n\n      return wrapAsync(lines.join(\"\\n\"));\n    }\n\n    return wrapAsync(normalizedSource);\n  } catch {\n    return wrapAsync(normalizedSource);\n  }\n}\n","import {\n  createExecutionContext,\n  getExecutionTimeoutMessage,\n  normalizeThrownMessage,\n} from \"./executor/shared.ts\";\nimport {\n  ExecuteFailure,\n  isExecuteFailure,\n  isJsonSerializable,\n} from \"./errors.ts\";\nimport type { ExecuteError, ResolvedToolProvider } from \"./types.ts\";\n\n/**\n * Transport-safe metadata for one exposed tool.\n */\nexport interface ProviderToolManifest {\n  description?: string;\n  originalName: string;\n  safeName: string;\n}\n\n/**\n * Namespace manifest shared with runner implementations.\n */\nexport interface ProviderManifest {\n  name: string;\n  tools: Record<string, ProviderToolManifest>;\n  types: string;\n}\n\n/**\n * Execution limits forwarded to runner implementations.\n */\nexport interface ExecutorRuntimeOptions {\n  maxLogChars?: number;\n  maxLogLines?: number;\n  memoryLimitBytes?: number;\n  timeoutMs?: number;\n}\n\n/**\n * Public execution options accepted by executors per call.\n */\nexport interface ExecutionOptions extends ExecutorRuntimeOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * Tool invocation request emitted from a runner.\n */\nexport interface ToolCall {\n  input: unknown;\n  providerName: string;\n  safeToolName: string;\n}\n\n/**\n * Trusted host response to a tool invocation request.\n */\nexport type ToolCallResult =\n  | {\n      ok: true;\n      result: unknown;\n    }\n  | {\n      error: ExecuteError;\n      ok: false;\n    };\n\nfunction toTrustedExecuteError(error: unknown): ExecuteError {\n  if (isExecuteFailure(error)) {\n    return {\n      code: error.code,\n      message: error.message,\n    };\n  }\n\n  return {\n    code: \"tool_error\",\n    message: normalizeThrownMessage(error),\n  };\n}\n\n/**\n * Converts resolved providers into manifest metadata that reveals only namespace details.\n */\nexport function extractProviderManifests(\n  providers: ResolvedToolProvider[],\n): ProviderManifest[] {\n  return providers.map((provider) => ({\n    name: provider.name,\n    tools: Object.fromEntries(\n      Object.entries(provider.tools).map(([safeToolName, descriptor]) => [\n        safeToolName,\n        {\n          description: descriptor.description,\n          originalName: descriptor.originalName,\n          safeName: descriptor.safeName,\n        },\n      ]),\n    ),\n    types: provider.types,\n  }));\n}\n\n/**\n * Creates a host-side dispatcher for runner-emitted tool calls.\n */\nexport function createToolCallDispatcher(\n  providers: ResolvedToolProvider[],\n  signal: AbortSignal,\n): (call: ToolCall) => Promise<ToolCallResult> {\n  const providerMap = new Map(\n    providers.map((provider) => [provider.name, provider] as const),\n  );\n\n  return async (call) => {\n    const provider = providerMap.get(call.providerName);\n    const descriptor = provider?.tools[call.safeToolName];\n\n    if (!provider || !descriptor) {\n      return {\n        error: {\n          code: \"internal_error\",\n          message: `Unknown tool ${call.providerName}.${call.safeToolName}`,\n        },\n        ok: false,\n      };\n    }\n\n    try {\n      if (signal.aborted) {\n        return {\n          error: {\n            code: \"timeout\",\n            message: getExecutionTimeoutMessage(),\n          },\n          ok: false,\n        };\n      }\n\n      const result = await descriptor.execute(\n        call.input,\n        createExecutionContext(\n          signal,\n          provider.name,\n          descriptor.safeName,\n          descriptor.originalName,\n        ),\n      );\n\n      if (result !== undefined && !isJsonSerializable(result)) {\n        throw new ExecuteFailure(\n          \"serialization_error\",\n          \"Host value is not JSON-serializable\",\n        );\n      }\n\n      return {\n        ok: true,\n        result,\n      };\n    } catch (error) {\n      return {\n        error: toTrustedExecuteError(error),\n        ok: false,\n      };\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,105 @@
+import { _ as ToolExecutionContext, a as ProviderToolManifest, b as TypegenToolDescriptor, c as createToolCallDispatcher, d as ExecuteErrorCode, f as ExecuteResult, g as ToolDescriptor, h as ResolvedToolProvider, i as ProviderManifest, l as extractProviderManifests, m as ResolvedToolDescriptor, n as ExecutionOptions, o as ToolCall, p as JsonSchema, r as ExecutorRuntimeOptions, s as ToolCallResult, t as Executor, u as ExecuteError, v as ToolProvider, y as ToolSchema } from "./executor-DcnjQGwA.cjs";
+
+//#region src/executor/shared.d.ts
+
+/**
+ * Returns whether the value is one of execbox's stable execution error codes.
+ */
+declare function isKnownExecuteErrorCode(value: unknown): value is ExecuteErrorCode;
+/**
+ * Returns the stable timeout message used across executor implementations.
+ */
+declare function getExecutionTimeoutMessage(): string;
+/**
+ * Creates the canonical timeout failure result used for preflight cancellation.
+ */
+declare function createTimeoutExecuteResult(durationMs?: number): ExecuteResult;
+/**
+ * Normalizes an unknown thrown value into a human-readable message.
+ */
+declare function normalizeThrownMessage(error: unknown): string;
+/**
+ * Returns the thrown error name when one is available.
+ */
+declare function normalizeThrownName(error: unknown): string | undefined;
+/**
+ * Builds the standard tool execution context passed to resolved tool wrappers.
+ */
+declare function createExecutionContext(signal: AbortSignal, providerName: string, safeToolName: string, originalToolName: string): ToolExecutionContext;
+/**
+ * Truncates captured logs to the configured line and character limits.
+ */
+declare function truncateLogs(logs: string[], maxLogLines: number, maxLogChars: number): string[];
+/**
+ * Formats guest console arguments into a single host-side log line.
+ */
+declare function formatConsoleLine(values: unknown[]): string;
+//#endregion
+//#region src/identifier.d.ts
+/**
+ * Returns whether the value is a valid JavaScript identifier.
+ */
+declare function isValidIdentifier(value: string): boolean;
+/**
+ * Returns whether the identifier is reserved in JavaScript source.
+ */
+declare function isReservedWord(value: string): boolean;
+/**
+ * Throws when the value cannot be used as a bare JavaScript identifier.
+ */
+declare function assertValidIdentifier(value: string, label?: string): void;
+/**
+ * Converts a raw identifier-like value into a safe JavaScript identifier.
+ */
+declare function sanitizeIdentifier(value: string): string;
+/**
+ * Renders the name as a bare identifier when possible, otherwise as a string literal.
+ */
+declare function serializePropertyName(name: string): string;
+//#endregion
+//#region src/normalize.d.ts
+/**
+ * Normalizes model-produced JavaScript into an executable async function body.
+ */
+declare function normalizeCode(source: string): string;
+//#endregion
+//#region src/sanitize.d.ts
+/**
+ * Converts a raw tool name into a safe JavaScript identifier.
+ */
+declare function sanitizeToolName(name: string): string;
+//#endregion
+//#region src/errors.d.ts
+/**
+ * Structured failure used internally to propagate executor and tool errors.
+ */
+declare class ExecuteFailure extends Error {
+  code: ExecuteErrorCode;
+  /**
+   * Creates a structured failure with a trusted executor or tool error code.
+   */
+  constructor(code: ExecuteErrorCode, message: string);
+}
+/**
+ * Returns whether a thrown value is an {@link ExecuteFailure}.
+ */
+declare function isExecuteFailure(value: unknown): value is ExecuteFailure;
+/**
+ * Returns whether a value can be serialized through the JSON-only host/guest boundary.
+ */
+declare function isJsonSerializable(value: unknown, active?: Set<object>, memo?: WeakSet<object>): boolean;
+//#endregion
+//#region src/provider/resolveProvider.d.ts
+/**
+ * Resolves a tool provider into the validated, sanitized shape consumed by executors.
+ */
+declare function resolveProvider(provider: ToolProvider): ResolvedToolProvider;
+//#endregion
+//#region src/typegen/jsonSchema.d.ts
+/**
+ * Generates a namespace declaration for a provider's tool schemas.
+ */
+declare function generateTypesFromJsonSchema(providerName: string, tools: Record<string, TypegenToolDescriptor>): string;
+//#endregion
+export { type ExecuteError, type ExecuteErrorCode, ExecuteFailure, type ExecuteResult, type ExecutionOptions, type Executor, type ExecutorRuntimeOptions, type JsonSchema, type ProviderManifest, type ProviderToolManifest, type ResolvedToolDescriptor, type ResolvedToolProvider, type ToolCall, type ToolCallResult, type ToolDescriptor, type ToolExecutionContext, type ToolProvider, type ToolSchema, type TypegenToolDescriptor, assertValidIdentifier, createExecutionContext, createTimeoutExecuteResult, createToolCallDispatcher, extractProviderManifests, formatConsoleLine, generateTypesFromJsonSchema, getExecutionTimeoutMessage, isExecuteFailure, isJsonSerializable, isKnownExecuteErrorCode, isReservedWord, isValidIdentifier, normalizeCode, normalizeThrownMessage, normalizeThrownName, resolveProvider, sanitizeIdentifier, sanitizeToolName, serializePropertyName, truncateLogs };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/executor/shared.ts","../src/identifier.ts","../src/normalize.ts","../src/sanitize.ts","../src/errors.ts","../src/provider/resolveProvider.ts","../src/typegen/jsonSchema.ts"],"sourcesContent":[],"mappings":";;;;;;AAyBA;AASgB,iBATA,uBAAA,CAS0B,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IAP9B,gBAO8B;AAO1C;AAeA;AAkBA;AAkBgB,iBA1DA,0BAAA,CAAA,CA2DN,EAIP,MAAA;AAYH;AA8CA;;iBAlHgB,0BAAA,uBAA4C;;ACG5D;AAOA;AAOgB,iBDFA,sBAAA,CCEqB,KAAA,EAAA,OAAA,CAAA,EAAA,MAAA;AAYrC;AAsBA;;iBDlBgB,mBAAA;;AE5ChB;;iBF8DgB,sBAAA,SACN,oFAIP;;AG5FH;;iBHwGgB,YAAA;;AIxGhB;;AAMoB,iBJgJJ,iBAAA,CIhJI,MAAA,EAAA,OAAA,EAAA,CAAA,EAAA,MAAA;;;;;;AJcJ,iBCmBA,iBAAA,CDjBJ,KAAA,EAAA,MAAA,CAAA,EAAA,OAAgB;AAO5B;AAOA;AAeA;AAkBgB,iBCvBA,cAAA,CDuBmB,KAAA,EAAA,MAAA,CAAA,EAAA,OAAA;AAkBnC;AAiBA;AA8CA;iBCjGgB,qBAAA;;;AAdhB;AAOgB,iBAmBA,kBAAA,CAnBc,KAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAO9B;AAYA;AAsBA;iBAAgB,qBAAA;;;;;;ADnEA,iBEKA,aAAA,CFLuB,MAE3B,EAAA,MAAA,CAAA,EAAA,MAAgB;;;;;;AAFZ,iBGpBA,gBAAA,CHoBuB,IAE3B,EAAA,MAAA,CAAA,EAAA,MAAgB;;;;;AAF5B;AASgB,cI7BH,cAAA,SAAuB,KAAA,CJ6BM;EAO1B,IAAA,EInCR,gBJmCQ;EAeA;AAkBhB;AAkBA;EAiBgB,WAAA,CAAA,IAAY,EIlGR,gBJkGQ,EAAA,OAAA,EAAA,MAAA;AA8C5B;;;;AC/GgB,iBGvBA,gBAAA,CHuBiB,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IGvB0B,cHuB1B;AAOjC;AAOA;AAYA;AAsBgB,iBGhEA,kBAAA,CHgEqB,KAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EG9D7B,GH8D6B,CAAA,MAAA,CAAA,EAAA,IAAA,CAAA,EG7D/B,OH6D+B,CAAA,MAAA,CAAA,CAAA,EAAA,OAAA;;;;;ADnErC;AASgB,iBKUA,eAAA,CLV0B,QAAA,EKUA,YLVA,CAAA,EKUe,oBLVf;;;AAsB1C;AAkBA;AAkBA;AAiBgB,iBMLA,2BAAA,CNKY,YAAA,EAAA,MAAA,EAAA,KAAA,EMHnB,MNGmB,CAAA,MAAA,EMHJ,qBNGI,CAAA,CAAA,EAAA,MAAA"}

package/dist/index.d.ts

@@ -0,0 +1,105 @@
+import { _ as ToolExecutionContext, a as ProviderToolManifest, b as TypegenToolDescriptor, c as createToolCallDispatcher, d as ExecuteErrorCode, f as ExecuteResult, g as ToolDescriptor, h as ResolvedToolProvider, i as ProviderManifest, l as extractProviderManifests, m as ResolvedToolDescriptor, n as ExecutionOptions, o as ToolCall, p as JsonSchema, r as ExecutorRuntimeOptions, s as ToolCallResult, t as Executor, u as ExecuteError, v as ToolProvider, y as ToolSchema } from "./executor-C0lf5vWT.js";
+
+//#region src/executor/shared.d.ts
+
+/**
+ * Returns whether the value is one of execbox's stable execution error codes.
+ */
+declare function isKnownExecuteErrorCode(value: unknown): value is ExecuteErrorCode;
+/**
+ * Returns the stable timeout message used across executor implementations.
+ */
+declare function getExecutionTimeoutMessage(): string;
+/**
+ * Creates the canonical timeout failure result used for preflight cancellation.
+ */
+declare function createTimeoutExecuteResult(durationMs?: number): ExecuteResult;
+/**
+ * Normalizes an unknown thrown value into a human-readable message.
+ */
+declare function normalizeThrownMessage(error: unknown): string;
+/**
+ * Returns the thrown error name when one is available.
+ */
+declare function normalizeThrownName(error: unknown): string | undefined;
+/**
+ * Builds the standard tool execution context passed to resolved tool wrappers.
+ */
+declare function createExecutionContext(signal: AbortSignal, providerName: string, safeToolName: string, originalToolName: string): ToolExecutionContext;
+/**
+ * Truncates captured logs to the configured line and character limits.
+ */
+declare function truncateLogs(logs: string[], maxLogLines: number, maxLogChars: number): string[];
+/**
+ * Formats guest console arguments into a single host-side log line.
+ */
+declare function formatConsoleLine(values: unknown[]): string;
+//#endregion
+//#region src/identifier.d.ts
+/**
+ * Returns whether the value is a valid JavaScript identifier.
+ */
+declare function isValidIdentifier(value: string): boolean;
+/**
+ * Returns whether the identifier is reserved in JavaScript source.
+ */
+declare function isReservedWord(value: string): boolean;
+/**
+ * Throws when the value cannot be used as a bare JavaScript identifier.
+ */
+declare function assertValidIdentifier(value: string, label?: string): void;
+/**
+ * Converts a raw identifier-like value into a safe JavaScript identifier.
+ */
+declare function sanitizeIdentifier(value: string): string;
+/**
+ * Renders the name as a bare identifier when possible, otherwise as a string literal.
+ */
+declare function serializePropertyName(name: string): string;
+//#endregion
+//#region src/normalize.d.ts
+/**
+ * Normalizes model-produced JavaScript into an executable async function body.
+ */
+declare function normalizeCode(source: string): string;
+//#endregion
+//#region src/sanitize.d.ts
+/**
+ * Converts a raw tool name into a safe JavaScript identifier.
+ */
+declare function sanitizeToolName(name: string): string;
+//#endregion
+//#region src/errors.d.ts
+/**
+ * Structured failure used internally to propagate executor and tool errors.
+ */
+declare class ExecuteFailure extends Error {
+  code: ExecuteErrorCode;
+  /**
+   * Creates a structured failure with a trusted executor or tool error code.
+   */
+  constructor(code: ExecuteErrorCode, message: string);
+}
+/**
+ * Returns whether a thrown value is an {@link ExecuteFailure}.
+ */
+declare function isExecuteFailure(value: unknown): value is ExecuteFailure;
+/**
+ * Returns whether a value can be serialized through the JSON-only host/guest boundary.
+ */
+declare function isJsonSerializable(value: unknown, active?: Set<object>, memo?: WeakSet<object>): boolean;
+//#endregion
+//#region src/provider/resolveProvider.d.ts
+/**
+ * Resolves a tool provider into the validated, sanitized shape consumed by executors.
+ */
+declare function resolveProvider(provider: ToolProvider): ResolvedToolProvider;
+//#endregion
+//#region src/typegen/jsonSchema.d.ts
+/**
+ * Generates a namespace declaration for a provider's tool schemas.
+ */
+declare function generateTypesFromJsonSchema(providerName: string, tools: Record<string, TypegenToolDescriptor>): string;
+//#endregion
+export { type ExecuteError, type ExecuteErrorCode, ExecuteFailure, type ExecuteResult, type ExecutionOptions, type Executor, type ExecutorRuntimeOptions, type JsonSchema, type ProviderManifest, type ProviderToolManifest, type ResolvedToolDescriptor, type ResolvedToolProvider, type ToolCall, type ToolCallResult, type ToolDescriptor, type ToolExecutionContext, type ToolProvider, type ToolSchema, type TypegenToolDescriptor, assertValidIdentifier, createExecutionContext, createTimeoutExecuteResult, createToolCallDispatcher, extractProviderManifests, formatConsoleLine, generateTypesFromJsonSchema, getExecutionTimeoutMessage, isExecuteFailure, isJsonSerializable, isKnownExecuteErrorCode, isReservedWord, isValidIdentifier, normalizeCode, normalizeThrownMessage, normalizeThrownName, resolveProvider, sanitizeIdentifier, sanitizeToolName, serializePropertyName, truncateLogs };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/executor/shared.ts","../src/identifier.ts","../src/normalize.ts","../src/sanitize.ts","../src/errors.ts","../src/provider/resolveProvider.ts","../src/typegen/jsonSchema.ts"],"sourcesContent":[],"mappings":";;;;;;AAyBA;AASgB,iBATA,uBAAA,CAS0B,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IAP9B,gBAO8B;AAO1C;AAeA;AAkBA;AAkBgB,iBA1DA,0BAAA,CAAA,CA2DN,EAIP,MAAA;AAYH;AA8CA;;iBAlHgB,0BAAA,uBAA4C;;ACG5D;AAOA;AAOgB,iBDFA,sBAAA,CCEqB,KAAA,EAAA,OAAA,CAAA,EAAA,MAAA;AAYrC;AAsBA;;iBDlBgB,mBAAA;;AE5ChB;;iBF8DgB,sBAAA,SACN,oFAIP;;AG5FH;;iBHwGgB,YAAA;;AIxGhB;;AAMoB,iBJgJJ,iBAAA,CIhJI,MAAA,EAAA,OAAA,EAAA,CAAA,EAAA,MAAA;;;;;;AJcJ,iBCmBA,iBAAA,CDjBJ,KAAA,EAAA,MAAA,CAAA,EAAA,OAAgB;AAO5B;AAOA;AAeA;AAkBgB,iBCvBA,cAAA,CDuBmB,KAAA,EAAA,MAAA,CAAA,EAAA,OAAA;AAkBnC;AAiBA;AA8CA;iBCjGgB,qBAAA;;;AAdhB;AAOgB,iBAmBA,kBAAA,CAnBc,KAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAO9B;AAYA;AAsBA;iBAAgB,qBAAA;;;;;;ADnEA,iBEKA,aAAA,CFLuB,MAE3B,EAAA,MAAA,CAAA,EAAA,MAAgB;;;;;;AAFZ,iBGpBA,gBAAA,CHoBuB,IAE3B,EAAA,MAAA,CAAA,EAAA,MAAgB;;;;;AAF5B;AASgB,cI7BH,cAAA,SAAuB,KAAA,CJ6BM;EAO1B,IAAA,EInCR,gBJmCQ;EAeA;AAkBhB;AAkBA;EAiBgB,WAAA,CAAA,IAAY,EIlGR,gBJkGQ,EAAA,OAAA,EAAA,MAAA;AA8C5B;;;;AC/GgB,iBGvBA,gBAAA,CHuBiB,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IGvB0B,cHuB1B;AAOjC;AAOA;AAYA;AAsBgB,iBGhEA,kBAAA,CHgEqB,KAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EG9D7B,GH8D6B,CAAA,MAAA,CAAA,EAAA,IAAA,CAAA,EG7D/B,OH6D+B,CAAA,MAAA,CAAA,CAAA,EAAA,OAAA;;;;;ADnErC;AASgB,iBKUA,eAAA,CLV0B,QAAA,EKUA,YLVA,CAAA,EKUe,oBLVf;;;AAsB1C;AAkBA;AAkBA;AAiBgB,iBMLA,2BAAA,CNKY,YAAA,EAAA,MAAA,EAAA,KAAA,EMHnB,MNGmB,CAAA,MAAA,EMHJ,qBNGI,CAAA,CAAA,EAAA,MAAA"}