@execbox/core 0.1.0

package/dist/resolveProvider-CixOjPKp.cjs

@@ -0,0 +1,456 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let ajv = require("ajv");
+ajv = __toESM(ajv);
+let zod = require("zod");
+zod = __toESM(zod);
+
+//#region src/identifier.ts
+const RESERVED_WORDS = new Set([
+	"await",
+	"break",
+	"case",
+	"catch",
+	"class",
+	"const",
+	"continue",
+	"debugger",
+	"default",
+	"delete",
+	"do",
+	"else",
+	"enum",
+	"export",
+	"extends",
+	"false",
+	"finally",
+	"for",
+	"function",
+	"if",
+	"import",
+	"in",
+	"instanceof",
+	"new",
+	"null",
+	"return",
+	"super",
+	"switch",
+	"this",
+	"throw",
+	"true",
+	"try",
+	"typeof",
+	"var",
+	"void",
+	"while",
+	"with",
+	"yield"
+]);
+/**
+* Returns whether the value is a valid JavaScript identifier.
+*/
+function isValidIdentifier(value) {
+	return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(value);
+}
+/**
+* Returns whether the identifier is reserved in JavaScript source.
+*/
+function isReservedWord(value) {
+	return RESERVED_WORDS.has(value);
+}
+/**
+* Throws when the value cannot be used as a bare JavaScript identifier.
+*/
+function assertValidIdentifier(value, label = "identifier") {
+	if (!isValidIdentifier(value) || isReservedWord(value)) throw new Error(`Invalid ${label}: ${value}`);
+}
+/**
+* Converts a raw identifier-like value into a safe JavaScript identifier.
+*/
+function sanitizeIdentifier(value) {
+	const sanitized = value.trim().replace(/[^A-Za-z0-9_$]+/g, "_").replace(/^_+|_+$/g, "");
+	let safeName = sanitized.length > 0 ? sanitized : "_";
+	if (/^[0-9]/.test(safeName)) safeName = `_${safeName}`;
+	if (isReservedWord(safeName)) safeName = `${safeName}_`;
+	return safeName;
+}
+/**
+* Renders the name as a bare identifier when possible, otherwise as a string literal.
+*/
+function serializePropertyName(name) {
+	return isValidIdentifier(name) ? name : JSON.stringify(name);
+}
+
+//#endregion
+//#region src/sanitize.ts
+/**
+* Converts a raw tool name into a safe JavaScript identifier.
+*/
+function sanitizeToolName(name) {
+	return sanitizeIdentifier(name);
+}
+
+//#endregion
+//#region src/errors.ts
+/**
+* Structured failure used internally to propagate executor and tool errors.
+*/
+var ExecuteFailure = class extends Error {
+	code;
+	/**
+	* Creates a structured failure with a trusted executor or tool error code.
+	*/
+	constructor(code, message) {
+		super(message);
+		this.code = code;
+		this.name = "ExecuteFailure";
+	}
+};
+/**
+* Returns whether a thrown value is an {@link ExecuteFailure}.
+*/
+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 src/schema/normalizeSchema.ts
+const z = "z" in zod && typeof zod.z === "object" ? zod.z : zod;
+const toJsonSchema = ("toJSONSchema" in zod ? zod.toJSONSchema : void 0) ?? ("toJSONSchema" in z ? z.toJSONSchema : void 0);
+function isRecord$1(value) {
+	return typeof value === "object" && value !== null;
+}
+function isZodSchema(value) {
+	return isRecord$1(value) && typeof value.safeParse === "function";
+}
+function isZodRawShape(value) {
+	return isRecord$1(value) && Object.keys(value).length > 0 && Object.values(value).every(isZodSchema);
+}
+function normalizeZodSchema(schema) {
+	if (typeof toJsonSchema !== "function") throw new Error("Installed zod package does not expose toJSONSchema");
+	const jsonSchema = toJsonSchema(schema);
+	if ("$schema" in jsonSchema) {
+		const { $schema: _ignored, ...rest } = jsonSchema;
+		return rest;
+	}
+	return jsonSchema;
+}
+/**
+* Normalizes supported tool schema inputs to the JSON Schema form used internally.
+*/
+function normalizeToolSchema(schema, phase, toolName) {
+	if (schema === void 0) return;
+	if (isZodSchema(schema)) return normalizeZodSchema(schema);
+	if (isZodRawShape(schema)) return normalizeZodSchema(z.object(schema));
+	if (isRecord$1(schema)) return schema;
+	throw new Error(`Unsupported ${phase} schema for tool ${toolName}. Expected JSON Schema, a Zod schema, or an MCP-style Zod shape.`);
+}
+
+//#endregion
+//#region src/typegen/render.ts
+/**
+* Indents each line of the given string by a specified number of levels.
+*/
+function indent(value, level = 1) {
+	return value.split("\n").map((line) => `${"  ".repeat(level)}${line}`).join("\n");
+}
+/**
+* Renders a short TSDoc-style block when documentation is available.
+*/
+function renderDocComment(lines) {
+	if (lines.length === 0) return "";
+	return [
+		"/**",
+		...lines.map((line) => ` * ${line}`),
+		" */"
+	].join("\n");
+}
+/**
+* Renders a namespace declaration with optional members.
+*/
+function renderNamespaceDeclaration(name, members) {
+	if (members.length === 0) return `declare namespace ${name} {}`;
+	return `declare namespace ${name} {\n${indent(members.join("\n\n"))}\n}`;
+}
+
+//#endregion
+//#region src/typegen/jsonSchema.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+/**
+* Converts a supported JSON Schema fragment into a TypeScript type expression.
+*/
+function schemaToType(schema, level = 0) {
+	if (!schema) return "unknown";
+	if ("allOf" in schema || "anyOf" in schema || "oneOf" in schema || "$ref" in schema || Array.isArray(schema.type)) return "unknown";
+	switch (schema.type) {
+		case "string": return "string";
+		case "number":
+		case "integer": return "number";
+		case "boolean": return "boolean";
+		case "null": return "null";
+		case "array": {
+			const itemType = schemaToType(isRecord(schema.items) ? schema.items : void 0, level + 1);
+			if (isValidIdentifier(itemType)) return `${itemType}[]`;
+			return `Array<${itemType}>`;
+		}
+		case "object": {
+			const properties = isRecord(schema.properties) ? schema.properties : {};
+			const required = new Set(Array.isArray(schema.required) ? schema.required.filter((value) => typeof value === "string") : []);
+			const entries = Object.entries(properties);
+			if (entries.length === 0) return "Record<string, unknown>";
+			return `{\n${indent(entries.map(([name, propertySchema]) => {
+				const propertyType = schemaToType(isRecord(propertySchema) ? propertySchema : void 0, level + 1);
+				const optionalToken = required.has(name) ? "" : "?";
+				return `${serializePropertyName(name)}${optionalToken}: ${propertyType};`;
+			}).join("\n"), level + 1)}\n${"  ".repeat(level)}}`;
+		}
+		default: return "unknown";
+	}
+}
+function formatToolDeclaration(name, tool) {
+	const lines = [];
+	const comment = tool.description ? renderDocComment([tool.description]) : "";
+	if (comment) lines.push(comment);
+	const inputType = schemaToType(tool.inputSchema);
+	const outputType = schemaToType(tool.outputSchema);
+	lines.push(`function ${name}(input: ${inputType}): Promise<${outputType}>;`);
+	return lines.join("\n");
+}
+/**
+* Generates a namespace declaration for a provider's tool schemas.
+*/
+function generateTypesFromJsonSchema(providerName, tools) {
+	return renderNamespaceDeclaration(providerName, Object.entries(tools).map(([name, tool]) => formatToolDeclaration(name, tool)));
+}
+
+//#endregion
+//#region src/provider/resolveProvider.ts
+const DEFAULT_PROVIDER_NAME = "codemode";
+function assertValidNamespace(name) {
+	assertValidIdentifier(name, "provider namespace");
+}
+function compileValidator(ajv$1, schema) {
+	return schema ? ajv$1.compile(schema) : void 0;
+}
+function formatValidationMessage(ajv$1, phase, toolName, validator) {
+	return `Invalid ${phase} for tool ${toolName}: ${ajv$1.errorsText(validator.errors)}`;
+}
+/**
+* Resolves a tool provider into the validated, sanitized shape consumed by executors.
+*/
+function resolveProvider(provider) {
+	const name = provider.name ?? DEFAULT_PROVIDER_NAME;
+	assertValidNamespace(name);
+	const ajv$1 = new ajv.default({
+		allErrors: true,
+		strict: false
+	});
+	const originalToSafeName = {};
+	const safeToOriginalName = {};
+	const usedSafeNames = /* @__PURE__ */ new Set();
+	const resolvedTools = {};
+	const typegenTools = {};
+	for (const [originalName, descriptor] of Object.entries(provider.tools)) {
+		const baseSafeName = sanitizeToolName(originalName);
+		let safeName = baseSafeName;
+		let suffix = 2;
+		while (usedSafeNames.has(safeName)) {
+			safeName = `${baseSafeName}__${suffix}`;
+			suffix += 1;
+		}
+		usedSafeNames.add(safeName);
+		originalToSafeName[originalName] = safeName;
+		safeToOriginalName[safeName] = originalName;
+		const inputSchema = normalizeToolSchema(descriptor.inputSchema, "input", originalName);
+		const outputSchema = normalizeToolSchema(descriptor.outputSchema, "output", originalName);
+		const inputValidator = compileValidator(ajv$1, inputSchema);
+		const outputValidator = compileValidator(ajv$1, outputSchema);
+		resolvedTools[safeName] = {
+			description: descriptor.description,
+			execute: async (input, context) => {
+				if (inputValidator && !inputValidator(input)) throw new ExecuteFailure("validation_error", formatValidationMessage(ajv$1, "input", originalName, inputValidator));
+				try {
+					const result = await descriptor.execute(input, context);
+					if (!isJsonSerializable(result)) throw new ExecuteFailure("serialization_error", `Tool ${originalName} returned a non-serializable value`);
+					if (outputValidator && !outputValidator(result)) throw new ExecuteFailure("validation_error", formatValidationMessage(ajv$1, "output", originalName, outputValidator));
+					return result;
+				} catch (error) {
+					if (isExecuteFailure(error)) throw error;
+					throw new ExecuteFailure("tool_error", error instanceof Error ? error.message : `Tool ${originalName} failed`);
+				}
+			},
+			inputSchema,
+			originalName,
+			outputSchema,
+			safeName
+		};
+		typegenTools[safeName] = {
+			description: descriptor.description,
+			inputSchema,
+			outputSchema
+		};
+	}
+	return {
+		name,
+		originalToSafeName,
+		safeToOriginalName,
+		tools: resolvedTools,
+		types: provider.types ?? generateTypesFromJsonSchema(name, typegenTools)
+	};
+}
+
+//#endregion
+Object.defineProperty(exports, 'ExecuteFailure', {
+  enumerable: true,
+  get: function () {
+    return ExecuteFailure;
+  }
+});
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});
+Object.defineProperty(exports, 'assertValidIdentifier', {
+  enumerable: true,
+  get: function () {
+    return assertValidIdentifier;
+  }
+});
+Object.defineProperty(exports, 'generateTypesFromJsonSchema', {
+  enumerable: true,
+  get: function () {
+    return generateTypesFromJsonSchema;
+  }
+});
+Object.defineProperty(exports, 'isExecuteFailure', {
+  enumerable: true,
+  get: function () {
+    return isExecuteFailure;
+  }
+});
+Object.defineProperty(exports, 'isJsonSerializable', {
+  enumerable: true,
+  get: function () {
+    return isJsonSerializable;
+  }
+});
+Object.defineProperty(exports, 'isReservedWord', {
+  enumerable: true,
+  get: function () {
+    return isReservedWord;
+  }
+});
+Object.defineProperty(exports, 'isValidIdentifier', {
+  enumerable: true,
+  get: function () {
+    return isValidIdentifier;
+  }
+});
+Object.defineProperty(exports, 'renderDocComment', {
+  enumerable: true,
+  get: function () {
+    return renderDocComment;
+  }
+});
+Object.defineProperty(exports, 'renderNamespaceDeclaration', {
+  enumerable: true,
+  get: function () {
+    return renderNamespaceDeclaration;
+  }
+});
+Object.defineProperty(exports, 'resolveProvider', {
+  enumerable: true,
+  get: function () {
+    return resolveProvider;
+  }
+});
+Object.defineProperty(exports, 'sanitizeIdentifier', {
+  enumerable: true,
+  get: function () {
+    return sanitizeIdentifier;
+  }
+});
+Object.defineProperty(exports, 'sanitizeToolName', {
+  enumerable: true,
+  get: function () {
+    return sanitizeToolName;
+  }
+});
+Object.defineProperty(exports, 'schemaToType', {
+  enumerable: true,
+  get: function () {
+    return schemaToType;
+  }
+});
+Object.defineProperty(exports, 'serializePropertyName', {
+  enumerable: true,
+  get: function () {
+    return serializePropertyName;
+  }
+});
+//# sourceMappingURL=resolveProvider-CixOjPKp.cjs.map

package/dist/resolveProvider-CixOjPKp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveProvider-CixOjPKp.cjs","names":["isRecord","lines: string[]","ajv","Ajv","originalToSafeName: Record<string, string>","safeToOriginalName: Record<string, string>","resolvedTools: Record<string, ResolvedToolDescriptor>","typegenTools: Record<string, TypegenToolDescriptor>"],"sources":["../src/identifier.ts","../src/sanitize.ts","../src/errors.ts","../src/schema/normalizeSchema.ts","../src/typegen/render.ts","../src/typegen/jsonSchema.ts","../src/provider/resolveProvider.ts"],"sourcesContent":["const RESERVED_WORDS = new Set([\n  \"await\",\n  \"break\",\n  \"case\",\n  \"catch\",\n  \"class\",\n  \"const\",\n  \"continue\",\n  \"debugger\",\n  \"default\",\n  \"delete\",\n  \"do\",\n  \"else\",\n  \"enum\",\n  \"export\",\n  \"extends\",\n  \"false\",\n  \"finally\",\n  \"for\",\n  \"function\",\n  \"if\",\n  \"import\",\n  \"in\",\n  \"instanceof\",\n  \"new\",\n  \"null\",\n  \"return\",\n  \"super\",\n  \"switch\",\n  \"this\",\n  \"throw\",\n  \"true\",\n  \"try\",\n  \"typeof\",\n  \"var\",\n  \"void\",\n  \"while\",\n  \"with\",\n  \"yield\",\n]);\n\n/**\n * Returns whether the value is a valid JavaScript identifier.\n */\nexport function isValidIdentifier(value: string): boolean {\n  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(value);\n}\n\n/**\n * Returns whether the identifier is reserved in JavaScript source.\n */\nexport function isReservedWord(value: string): boolean {\n  return RESERVED_WORDS.has(value);\n}\n\n/**\n * Throws when the value cannot be used as a bare JavaScript identifier.\n */\nexport function assertValidIdentifier(\n  value: string,\n  label = \"identifier\",\n): void {\n  if (!isValidIdentifier(value) || isReservedWord(value)) {\n    throw new Error(`Invalid ${label}: ${value}`);\n  }\n}\n\n/**\n * Converts a raw identifier-like value into a safe JavaScript identifier.\n */\nexport function sanitizeIdentifier(value: string): string {\n  const sanitized = value\n    .trim()\n    .replace(/[^A-Za-z0-9_$]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n\n  let safeName = sanitized.length > 0 ? sanitized : \"_\";\n\n  if (/^[0-9]/.test(safeName)) {\n    safeName = `_${safeName}`;\n  }\n\n  if (isReservedWord(safeName)) {\n    safeName = `${safeName}_`;\n  }\n\n  return safeName;\n}\n\n/**\n * Renders the name as a bare identifier when possible, otherwise as a string literal.\n */\nexport function serializePropertyName(name: string): string {\n  return isValidIdentifier(name) ? name : JSON.stringify(name);\n}\n","import { sanitizeIdentifier } from \"./identifier\";\n\n/**\n * Converts a raw tool name into a safe JavaScript identifier.\n */\nexport function sanitizeToolName(name: string): string {\n  return sanitizeIdentifier(name);\n}\n","import type { ExecuteErrorCode } from \"./types\";\n\n/**\n * Structured failure used internally to propagate executor and tool errors.\n */\nexport class ExecuteFailure extends Error {\n  code: ExecuteErrorCode;\n\n  /**\n   * Creates a structured failure with a trusted executor or tool error code.\n   */\n  constructor(code: ExecuteErrorCode, message: string) {\n    super(message);\n    this.code = code;\n    this.name = \"ExecuteFailure\";\n  }\n}\n\n/**\n * Returns whether a thrown value is an {@link ExecuteFailure}.\n */\nexport function isExecuteFailure(value: unknown): value is ExecuteFailure {\n  return value instanceof ExecuteFailure;\n}\n\n/**\n * Returns whether a value can be serialized through the JSON-only host/guest boundary.\n */\nexport function isJsonSerializable(\n  value: unknown,\n  active = new Set<object>(),\n  memo = new WeakSet<object>(),\n): boolean {\n  if (value === null) {\n    return true;\n  }\n\n  switch (typeof value) {\n    case \"string\":\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return Number.isFinite(value);\n    case \"bigint\":\n    case \"function\":\n    case \"symbol\":\n    case \"undefined\":\n      return false;\n    case \"object\": {\n      const objectValue = value as object;\n\n      if (memo.has(objectValue)) {\n        return true;\n      }\n\n      if (active.has(objectValue)) {\n        return false;\n      }\n\n      active.add(objectValue);\n      let isSerializable = false;\n\n      try {\n        if (Array.isArray(value)) {\n          isSerializable = value.every((item) =>\n            isJsonSerializable(item, active, memo),\n          );\n          return isSerializable;\n        }\n\n        const prototype = Object.getPrototypeOf(value);\n        if (prototype !== Object.prototype && prototype !== null) {\n          return false;\n        }\n\n        isSerializable = Object.values(value).every((item) =>\n          isJsonSerializable(item, active, memo),\n        );\n        return isSerializable;\n      } finally {\n        active.delete(objectValue);\n        if (isSerializable) {\n          memo.add(objectValue);\n        }\n      }\n    }\n  }\n\n  return false;\n}\n","import * as zod from \"zod\";\nimport type { ZodRawShape, ZodTypeAny } from \"zod\";\n\nimport type { JsonSchema, ToolSchema } from \"../types\";\n\nconst z = \"z\" in zod && typeof zod.z === \"object\" ? zod.z : zod;\nconst toJsonSchema =\n  (\"toJSONSchema\" in zod ? zod.toJSONSchema : undefined) ??\n  (\"toJSONSchema\" in z ? z.toJSONSchema : undefined);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isZodSchema(value: unknown): value is ZodTypeAny {\n  return isRecord(value) && typeof value.safeParse === \"function\";\n}\n\nfunction isZodRawShape(value: unknown): value is ZodRawShape {\n  return (\n    isRecord(value) &&\n    Object.keys(value).length > 0 &&\n    Object.values(value).every(isZodSchema)\n  );\n}\n\nfunction normalizeZodSchema(schema: ZodTypeAny): JsonSchema {\n  if (typeof toJsonSchema !== \"function\") {\n    throw new Error(\"Installed zod package does not expose toJSONSchema\");\n  }\n\n  const jsonSchema = toJsonSchema(schema) as JsonSchema & {\n    $schema?: string;\n  };\n\n  if (\"$schema\" in jsonSchema) {\n    const { $schema: _ignored, ...rest } = jsonSchema;\n    return rest;\n  }\n\n  return jsonSchema;\n}\n\n/**\n * Normalizes supported tool schema inputs to the JSON Schema form used internally.\n */\nexport function normalizeToolSchema(\n  schema: ToolSchema | undefined,\n  phase: \"input\" | \"output\",\n  toolName: string,\n): JsonSchema | undefined {\n  if (schema === undefined) {\n    return undefined;\n  }\n\n  if (isZodSchema(schema)) {\n    return normalizeZodSchema(schema);\n  }\n\n  if (isZodRawShape(schema)) {\n    return normalizeZodSchema(z.object(schema));\n  }\n\n  if (isRecord(schema)) {\n    return schema;\n  }\n\n  throw new Error(\n    `Unsupported ${phase} schema for tool ${toolName}. Expected JSON Schema, a Zod schema, or an MCP-style Zod shape.`,\n  );\n}\n","/**\n * Indents each line of the given string by a specified number of levels.\n */\nexport function indent(value: string, level = 1): string {\n  return value\n    .split(\"\\n\")\n    .map((line) => `${\"  \".repeat(level)}${line}`)\n    .join(\"\\n\");\n}\n\n/**\n * Renders a short TSDoc-style block when documentation is available.\n */\nexport function renderDocComment(lines: string[]): string {\n  if (lines.length === 0) {\n    return \"\";\n  }\n\n  return [\"/**\", ...lines.map((line) => ` * ${line}`), \" */\"].join(\"\\n\");\n}\n\n/**\n * Renders a namespace declaration with optional members.\n */\nexport function renderNamespaceDeclaration(\n  name: string,\n  members: string[],\n): string {\n  if (members.length === 0) {\n    return `declare namespace ${name} {}`;\n  }\n\n  return `declare namespace ${name} {\\n${indent(members.join(\"\\n\\n\"))}\\n}`;\n}\n","import { isValidIdentifier, serializePropertyName } from \"../identifier\";\nimport type { JsonSchema, TypegenToolDescriptor } from \"../types\";\nimport { indent, renderDocComment, renderNamespaceDeclaration } from \"./render\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nexport { indent } from \"./render\";\n\n/**\n * Converts a supported JSON Schema fragment into a TypeScript type expression.\n */\nexport function schemaToType(\n  schema: JsonSchema | undefined,\n  level = 0,\n): string {\n  if (!schema) {\n    return \"unknown\";\n  }\n\n  if (\n    \"allOf\" in schema ||\n    \"anyOf\" in schema ||\n    \"oneOf\" in schema ||\n    \"$ref\" in schema ||\n    Array.isArray(schema.type)\n  ) {\n    return \"unknown\";\n  }\n\n  switch (schema.type) {\n    case \"string\":\n      return \"string\";\n    case \"number\":\n    case \"integer\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"null\":\n      return \"null\";\n    case \"array\": {\n      const itemType = schemaToType(\n        isRecord(schema.items) ? (schema.items as JsonSchema) : undefined,\n        level + 1,\n      );\n\n      if (isValidIdentifier(itemType)) {\n        return `${itemType}[]`;\n      }\n\n      return `Array<${itemType}>`;\n    }\n    case \"object\": {\n      const properties = isRecord(schema.properties) ? schema.properties : {};\n      const required = new Set(\n        Array.isArray(schema.required)\n          ? schema.required.filter(\n              (value): value is string => typeof value === \"string\",\n            )\n          : [],\n      );\n      const entries = Object.entries(properties);\n\n      if (entries.length === 0) {\n        return \"Record<string, unknown>\";\n      }\n\n      const lines = entries.map(([name, propertySchema]) => {\n        const propertyType = schemaToType(\n          isRecord(propertySchema) ? (propertySchema as JsonSchema) : undefined,\n          level + 1,\n        );\n        const optionalToken = required.has(name) ? \"\" : \"?\";\n        return `${serializePropertyName(name)}${optionalToken}: ${propertyType};`;\n      });\n\n      return `{\\n${indent(lines.join(\"\\n\"), level + 1)}\\n${\"  \".repeat(level)}}`;\n    }\n    default:\n      return \"unknown\";\n  }\n}\n\nfunction formatToolDeclaration(\n  name: string,\n  tool: TypegenToolDescriptor,\n): string {\n  const lines: string[] = [];\n  const comment = tool.description ? renderDocComment([tool.description]) : \"\";\n  if (comment) {\n    lines.push(comment);\n  }\n\n  const inputType = schemaToType(tool.inputSchema);\n  const outputType = schemaToType(tool.outputSchema);\n  lines.push(`function ${name}(input: ${inputType}): Promise<${outputType}>;`);\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generates a namespace declaration for a provider's tool schemas.\n */\nexport function generateTypesFromJsonSchema(\n  providerName: string,\n  tools: Record<string, TypegenToolDescriptor>,\n): string {\n  return renderNamespaceDeclaration(\n    providerName,\n    Object.entries(tools).map(([name, tool]) =>\n      formatToolDeclaration(name, tool),\n    ),\n  );\n}\n","import Ajv, { type AnySchemaObject, type ValidateFunction } from \"ajv\";\n\nimport {\n  ExecuteFailure,\n  isExecuteFailure,\n  isJsonSerializable,\n} from \"../errors\";\nimport { assertValidIdentifier } from \"../identifier\";\nimport { sanitizeToolName } from \"../sanitize\";\nimport { normalizeToolSchema } from \"../schema/normalizeSchema\";\nimport { generateTypesFromJsonSchema } from \"../typegen/jsonSchema\";\nimport type {\n  JsonSchema,\n  ResolvedToolDescriptor,\n  ResolvedToolProvider,\n  ToolExecutionContext,\n  ToolProvider,\n  TypegenToolDescriptor,\n} from \"../types\";\n\nconst DEFAULT_PROVIDER_NAME = \"codemode\";\nfunction assertValidNamespace(name: string): void {\n  assertValidIdentifier(name, \"provider namespace\");\n}\n\nfunction compileValidator(\n  ajv: Ajv,\n  schema: JsonSchema | undefined,\n): ValidateFunction | undefined {\n  return schema ? ajv.compile(schema as AnySchemaObject) : undefined;\n}\n\nfunction formatValidationMessage(\n  ajv: Ajv,\n  phase: \"input\" | \"output\",\n  toolName: string,\n  validator: ValidateFunction,\n): string {\n  return `Invalid ${phase} for tool ${toolName}: ${ajv.errorsText(validator.errors)}`;\n}\n\n/**\n * Resolves a tool provider into the validated, sanitized shape consumed by executors.\n */\nexport function resolveProvider(provider: ToolProvider): ResolvedToolProvider {\n  const name = provider.name ?? DEFAULT_PROVIDER_NAME;\n  assertValidNamespace(name);\n\n  const ajv = new Ajv({\n    allErrors: true,\n    strict: false,\n  });\n\n  const originalToSafeName: Record<string, string> = {};\n  const safeToOriginalName: Record<string, string> = {};\n  const usedSafeNames = new Set<string>();\n  const resolvedTools: Record<string, ResolvedToolDescriptor> = {};\n  const typegenTools: Record<string, TypegenToolDescriptor> = {};\n\n  for (const [originalName, descriptor] of Object.entries(provider.tools)) {\n    const baseSafeName = sanitizeToolName(originalName);\n    let safeName = baseSafeName;\n    let suffix = 2;\n\n    while (usedSafeNames.has(safeName)) {\n      safeName = `${baseSafeName}__${suffix}`;\n      suffix += 1;\n    }\n\n    usedSafeNames.add(safeName);\n    originalToSafeName[originalName] = safeName;\n    safeToOriginalName[safeName] = originalName;\n\n    const inputSchema = normalizeToolSchema(\n      descriptor.inputSchema,\n      \"input\",\n      originalName,\n    );\n    const outputSchema = normalizeToolSchema(\n      descriptor.outputSchema,\n      \"output\",\n      originalName,\n    );\n    const inputValidator = compileValidator(ajv, inputSchema);\n    const outputValidator = compileValidator(ajv, outputSchema);\n\n    resolvedTools[safeName] = {\n      description: descriptor.description,\n      execute: async (\n        input: unknown,\n        context: ToolExecutionContext,\n      ): Promise<unknown> => {\n        if (inputValidator && !inputValidator(input)) {\n          throw new ExecuteFailure(\n            \"validation_error\",\n            formatValidationMessage(ajv, \"input\", originalName, inputValidator),\n          );\n        }\n\n        try {\n          const result = await descriptor.execute(input, context);\n\n          if (!isJsonSerializable(result)) {\n            throw new ExecuteFailure(\n              \"serialization_error\",\n              `Tool ${originalName} returned a non-serializable value`,\n            );\n          }\n\n          if (outputValidator && !outputValidator(result)) {\n            throw new ExecuteFailure(\n              \"validation_error\",\n              formatValidationMessage(\n                ajv,\n                \"output\",\n                originalName,\n                outputValidator,\n              ),\n            );\n          }\n\n          return result;\n        } catch (error) {\n          if (isExecuteFailure(error)) {\n            throw error;\n          }\n\n          throw new ExecuteFailure(\n            \"tool_error\",\n            error instanceof Error\n              ? error.message\n              : `Tool ${originalName} failed`,\n          );\n        }\n      },\n      inputSchema,\n      originalName,\n      outputSchema,\n      safeName,\n    };\n\n    typegenTools[safeName] = {\n      description: descriptor.description,\n      inputSchema,\n      outputSchema,\n    };\n  }\n\n  return {\n    name,\n    originalToSafeName,\n    safeToOriginalName,\n    tools: resolvedTools,\n    types: provider.types ?? generateTypesFromJsonSchema(name, typegenTools),\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@execbox/core",
+  "version": "0.1.0",
+  "description": "Core execution contract, provider resolution, and MCP adapters.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "import": "./dist/mcp/index.js",
+      "require": "./dist/mcp/index.cjs"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsdown"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "sandbox",
+    "code-execution",
+    "tools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aallam/execbox.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/aallam/execbox/tree/main/packages/core#readme",
+  "bugs": "https://github.com/aallam/execbox/issues",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "acorn": "^8.15.0",
+    "ajv": "^8.17.1",
+    "zod": "^4.3.6"
+  }
+}