mirascope 2.0.0-alpha.0

package/dist/bun.cjs

@@ -0,0 +1,447 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var bun = require('bun');
+var fs = require('fs');
+var path = require('path');
+var ts3 = require('typescript');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var ts3__default = /*#__PURE__*/_interopDefault(ts3);
+
+// src/bun.ts
+function isArrayLikeType(type, checker) {
+  if (type.getFlags() & ts3__default.default.TypeFlags.Object) {
+    const objectType = type;
+    const objectFlags = objectType.objectFlags;
+    if (objectFlags & ts3__default.default.ObjectFlags.Reference) {
+      const typeRef = type;
+      const symbol = typeRef.symbol;
+      if (symbol && symbol.getName() === "Array") {
+        return true;
+      }
+      const target = typeRef.target;
+      if (target && target.symbol && target.symbol.getName() === "Array") {
+        return true;
+      }
+    }
+  }
+  const typeString = checker.typeToString(type);
+  if (typeString.endsWith("[]") || typeString.startsWith("Array<")) {
+    return true;
+  }
+  return false;
+}
+function typeToJsonSchema(type, ctx) {
+  const checker = ctx.checker;
+  if (type.isUnion()) {
+    return handleUnionType(type, ctx);
+  }
+  if (type.isIntersection()) {
+    return handleIntersectionType(type, ctx);
+  }
+  if (type.isLiteral()) {
+    return handleLiteralType(type);
+  }
+  const flags = type.getFlags();
+  if (flags & ts3__default.default.TypeFlags.BooleanLiteral) {
+    const intrinsicName = type.intrinsicName;
+    const isTrue = intrinsicName === "true";
+    return { type: "boolean", enum: [isTrue] };
+  }
+  if (flags & ts3__default.default.TypeFlags.String) {
+    return { type: "string" };
+  }
+  if (flags & ts3__default.default.TypeFlags.Number) {
+    return { type: "number" };
+  }
+  if (flags & ts3__default.default.TypeFlags.Null) {
+    return { type: "null" };
+  }
+  if (flags & ts3__default.default.TypeFlags.Undefined) {
+    return {};
+  }
+  if (checker.isArrayType(type) || isArrayLikeType(type, checker)) {
+    const typeRef = type;
+    const typeArgs = checker.getTypeArguments(typeRef);
+    if (typeArgs && typeArgs.length > 0) {
+      return {
+        type: "array",
+        items: typeToJsonSchema(typeArgs[0], ctx)
+      };
+    }
+    return { type: "array" };
+  }
+  if (flags & ts3__default.default.TypeFlags.Object) {
+    return handleObjectType(type, ctx);
+  }
+  return {};
+}
+function handleUnionType(type, ctx) {
+  const types = type.types;
+  const nonUndefinedTypes = types.filter(
+    (t) => !(t.getFlags() & ts3__default.default.TypeFlags.Undefined)
+  );
+  if (nonUndefinedTypes.length === 2 && nonUndefinedTypes.every((t) => t.getFlags() & ts3__default.default.TypeFlags.BooleanLiteral)) {
+    return { type: "boolean" };
+  }
+  if (nonUndefinedTypes.every(
+    (t) => t.isStringLiteral()
+  )) {
+    return {
+      type: "string",
+      enum: nonUndefinedTypes.map((t) => t.value)
+    };
+  }
+  if (nonUndefinedTypes.every(
+    (t) => t.isNumberLiteral()
+  )) {
+    return {
+      type: "number",
+      enum: nonUndefinedTypes.map((t) => t.value)
+    };
+  }
+  if (nonUndefinedTypes.length === 1) {
+    return typeToJsonSchema(nonUndefinedTypes[0], ctx);
+  }
+  return {
+    oneOf: nonUndefinedTypes.map((t) => typeToJsonSchema(t, ctx))
+  };
+}
+function handleIntersectionType(type, ctx) {
+  const allOf = type.types.map((t) => typeToJsonSchema(t, ctx));
+  if (allOf.every((s) => s.type === "object")) {
+    const merged = {
+      type: "object",
+      properties: {},
+      required: []
+    };
+    for (const schema of allOf) {
+      if (schema.properties) {
+        merged.properties = { ...merged.properties, ...schema.properties };
+      }
+      if (schema.required) {
+        merged.required = [
+          ...merged.required,
+          ...schema.required
+        ];
+      }
+    }
+    return merged;
+  }
+  return { allOf };
+}
+function handleLiteralType(type) {
+  if (type.isStringLiteral()) {
+    return { type: "string", enum: [type.value] };
+  }
+  if (type.isNumberLiteral()) {
+    return { type: "number", enum: [type.value] };
+  }
+  return {};
+}
+function handleObjectType(type, ctx) {
+  const checker = ctx.checker;
+  const properties = {};
+  const required = [];
+  const props = checker.getPropertiesOfType(type);
+  for (const prop of props) {
+    const propName = prop.getName();
+    const propType = checker.getTypeOfSymbol(prop);
+    const isOptional = (prop.getFlags() & ts3__default.default.SymbolFlags.Optional) !== 0;
+    const propSchema = typeToJsonSchema(propType, ctx);
+    const jsDocComment = prop.getDocumentationComment(checker);
+    if (jsDocComment.length > 0) {
+      const description = jsDocComment.map((c) => c.text).join("");
+      propSchema.description = description;
+    }
+    properties[propName] = propSchema;
+    if (!isOptional) {
+      required.push(propName);
+    }
+  }
+  return {
+    type: "object",
+    properties,
+    required: required.length > 0 ? required : void 0
+  };
+}
+function typeToToolParameterSchema(type, checker) {
+  const ctx = {
+    checker,
+    definitions: /* @__PURE__ */ new Map()};
+  const schema = typeToJsonSchema(type, ctx);
+  if (schema.type !== "object") {
+    throw new Error(
+      "Tool parameter type must be an object type, got: " + JSON.stringify(schema)
+    );
+  }
+  const result = {
+    type: "object",
+    properties: schema.properties ?? {},
+    required: schema.required ?? [],
+    additionalProperties: false
+  };
+  if (ctx.definitions.size > 0) {
+    result.$defs = Object.fromEntries(ctx.definitions);
+  }
+  return result;
+}
+
+// src/transform/transformer.ts
+var TOOL_FUNCTION_NAMES = /* @__PURE__ */ new Set(["defineTool", "defineContextTool"]);
+var FORMAT_FUNCTION_NAMES = /* @__PURE__ */ new Set(["defineFormat"]);
+function createToolSchemaTransformer(program) {
+  const checker = program.getTypeChecker();
+  return (context) => {
+    return (sourceFile) => {
+      const visitor = (node) => {
+        if (ts3__default.default.isCallExpression(node)) {
+          const toolTransformed = tryTransformToolCall(node, checker, context);
+          if (toolTransformed) {
+            return toolTransformed;
+          }
+          const formatTransformed = tryTransformFormatCall(
+            node,
+            checker,
+            context
+          );
+          if (formatTransformed) {
+            return formatTransformed;
+          }
+        }
+        return ts3__default.default.visitEachChild(node, visitor, context);
+      };
+      return ts3__default.default.visitNode(sourceFile, visitor);
+    };
+  };
+}
+function tryTransformToolCall(node, checker, context) {
+  const functionName = getFunctionName(node);
+  if (!functionName || !TOOL_FUNCTION_NAMES.has(functionName)) {
+    return void 0;
+  }
+  const typeArgs = node.typeArguments;
+  if (!typeArgs || typeArgs.length === 0) {
+    return void 0;
+  }
+  const argsTypeNode = typeArgs[0];
+  const argsType = checker.getTypeFromTypeNode(argsTypeNode);
+  let schema;
+  try {
+    schema = typeToToolParameterSchema(argsType, checker);
+  } catch {
+    return void 0;
+  }
+  const args = node.arguments;
+  const firstArg = args[0];
+  if (!firstArg || !ts3__default.default.isObjectLiteralExpression(firstArg)) {
+    return void 0;
+  }
+  const optionsObject = firstArg;
+  const hasSchema = optionsObject.properties.some(
+    (prop) => ts3__default.default.isPropertyAssignment(prop) && ts3__default.default.isIdentifier(prop.name) && prop.name.text === "__schema"
+  );
+  if (hasSchema) {
+    return void 0;
+  }
+  const schemaProperty = createSchemaProperty(schema, context.factory);
+  const newProperties = [...optionsObject.properties, schemaProperty];
+  const newOptionsObject = context.factory.updateObjectLiteralExpression(
+    optionsObject,
+    newProperties
+  );
+  const newArgs = [newOptionsObject, ...args.slice(1)];
+  return context.factory.updateCallExpression(
+    node,
+    node.expression,
+    node.typeArguments,
+    newArgs
+  );
+}
+function tryTransformFormatCall(node, checker, context) {
+  const functionName = getFunctionName(node);
+  if (!functionName || !FORMAT_FUNCTION_NAMES.has(functionName)) {
+    return void 0;
+  }
+  const typeArgs = node.typeArguments;
+  if (!typeArgs || typeArgs.length === 0) {
+    return void 0;
+  }
+  const outputTypeNode = typeArgs[0];
+  const outputType = checker.getTypeFromTypeNode(outputTypeNode);
+  const args = node.arguments;
+  const firstArg = args[0];
+  if (!firstArg) {
+    return void 0;
+  }
+  if (ts3__default.default.isObjectLiteralExpression(firstArg)) {
+    const formatSpecObject = firstArg;
+    const hasSchema = formatSpecObject.properties.some(
+      (prop) => ts3__default.default.isPropertyAssignment(prop) && ts3__default.default.isIdentifier(prop.name) && prop.name.text === "__schema"
+    );
+    if (hasSchema) {
+      return void 0;
+    }
+    let schema;
+    try {
+      schema = typeToToolParameterSchema(outputType, checker);
+    } catch {
+      return void 0;
+    }
+    const schemaProperty = createSchemaProperty(schema, context.factory);
+    const newProperties = [...formatSpecObject.properties, schemaProperty];
+    const newFormatSpecObject = context.factory.updateObjectLiteralExpression(
+      formatSpecObject,
+      newProperties
+    );
+    const newArgs = [newFormatSpecObject, ...args.slice(1)];
+    return context.factory.updateCallExpression(
+      node,
+      node.expression,
+      node.typeArguments,
+      newArgs
+    );
+  }
+  return void 0;
+}
+function getFunctionName(node) {
+  const expression = node.expression;
+  if (ts3__default.default.isIdentifier(expression)) {
+    return expression.text;
+  }
+  if (ts3__default.default.isPropertyAccessExpression(expression)) {
+    return expression.name.text;
+  }
+  return void 0;
+}
+function createSchemaProperty(schema, factory) {
+  return factory.createPropertyAssignment(
+    factory.createIdentifier("__schema"),
+    jsonToAst(schema, factory)
+  );
+}
+function jsonToAst(value, factory) {
+  if (value === null) {
+    return factory.createNull();
+  }
+  if (value === void 0) {
+    return factory.createIdentifier("undefined");
+  }
+  if (typeof value === "string") {
+    return factory.createStringLiteral(value);
+  }
+  if (typeof value === "number") {
+    return factory.createNumericLiteral(value);
+  }
+  if (typeof value === "boolean") {
+    return value ? factory.createTrue() : factory.createFalse();
+  }
+  if (Array.isArray(value)) {
+    return factory.createArrayLiteralExpression(
+      value.map((item) => jsonToAst(item, factory))
+    );
+  }
+  if (typeof value === "object") {
+    const properties = Object.entries(value).map(
+      ([key, val]) => factory.createPropertyAssignment(
+        factory.createIdentifier(key),
+        jsonToAst(val, factory)
+      )
+    );
+    return factory.createObjectLiteralExpression(properties, true);
+  }
+  return factory.createIdentifier("undefined");
+}
+
+// src/bun.ts
+function needsTransform(contents) {
+  return /\bdefineTool\b|\bdefineContextTool\b|\bdefineFormat\b/.test(contents);
+}
+function transformSource(filePath, contents) {
+  const configPath = ts3__default.default.findConfigFile(
+    path.dirname(filePath),
+    ts3__default.default.sys.fileExists,
+    "tsconfig.json"
+  );
+  const compilerOptions = {
+    target: ts3__default.default.ScriptTarget.ESNext,
+    module: ts3__default.default.ModuleKind.ESNext,
+    moduleResolution: ts3__default.default.ModuleResolutionKind.Bundler,
+    esModuleInterop: true,
+    strict: true
+  };
+  if (configPath) {
+    const configFile = ts3__default.default.readConfigFile(configPath, ts3__default.default.sys.readFile);
+    if (!configFile.error) {
+      const parsed = ts3__default.default.parseJsonConfigFileContent(
+        configFile.config,
+        ts3__default.default.sys,
+        path.dirname(configPath)
+      );
+      Object.assign(compilerOptions, parsed.options);
+    }
+  }
+  const host = ts3__default.default.createCompilerHost(compilerOptions);
+  const originalGetSourceFile = host.getSourceFile;
+  host.getSourceFile = (fileName, languageVersion, onError, shouldCreateNewSourceFile) => {
+    if (path.resolve(fileName) === path.resolve(filePath)) {
+      return ts3__default.default.createSourceFile(fileName, contents, languageVersion, true);
+    }
+    return originalGetSourceFile(
+      fileName,
+      languageVersion,
+      onError,
+      shouldCreateNewSourceFile
+    );
+  };
+  const program = ts3__default.default.createProgram([filePath], compilerOptions, host);
+  const sourceFile = program.getSourceFile(filePath);
+  if (!sourceFile) {
+    return void 0;
+  }
+  const transformer = createToolSchemaTransformer(program);
+  const result = ts3__default.default.transform(sourceFile, [transformer]);
+  const transformedSourceFile = result.transformed[0];
+  if (!transformedSourceFile) {
+    result.dispose();
+    return void 0;
+  }
+  const printer = ts3__default.default.createPrinter({ newLine: ts3__default.default.NewLineKind.LineFeed });
+  const output = printer.printFile(transformedSourceFile);
+  result.dispose();
+  return output;
+}
+function mirascope(options = {}) {
+  const { filter = /\.tsx?$/, exclude = [/node_modules/] } = options;
+  bun.plugin({
+    name: "mirascope",
+    setup(build) {
+      build.onLoad({ filter }, (args) => {
+        for (const pattern of exclude) {
+          if (pattern.test(args.path)) {
+            return;
+          }
+        }
+        const contents = fs.readFileSync(args.path, "utf-8");
+        const loader = args.path.endsWith(".tsx") ? "tsx" : "ts";
+        if (!needsTransform(contents)) {
+          return { contents, loader };
+        }
+        const transformed = transformSource(args.path, contents);
+        return {
+          contents: transformed ?? contents,
+          loader
+        };
+      });
+    }
+  });
+}
+var bun_default = mirascope;
+
+exports.default = bun_default;
+exports.mirascope = mirascope;
+//# sourceMappingURL=bun.cjs.map
+//# sourceMappingURL=bun.cjs.map

package/dist/bun.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transform/type-to-schema.ts","../src/transform/transformer.ts","../src/bun.ts"],"names":["ts","dirname","resolve","plugin","readFileSync"],"mappings":"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","file":"bun.cjs","sourcesContent":["/**\n * Convert TypeScript types to JSON Schema.\n *\n * Uses the TypeScript Compiler API to introspect types and generate\n * JSON Schema representations suitable for LLM tool definitions.\n */\n\nimport ts from \"typescript\";\n\nimport type { JsonSchemaProperty, ToolParameterSchema } from \"@/llm/tools\";\n\n/**\n * Context for type-to-schema conversion.\n */\ninterface ConversionContext {\n  /** The TypeScript type checker. */\n  checker: ts.TypeChecker;\n  /** Definitions for referenced types ($defs). */\n  definitions: Map<string, JsonSchemaProperty>;\n  /** Set of type names currently being processed (for cycle detection). */\n  processing: Set<string>;\n}\n\n/**\n * Check if a type is an array-like type (handles cases where isArrayType doesn't work).\n *\n * This is needed because TypeScript's isArrayType requires proper lib.d.ts setup.\n * We also check for Array<T> and T[] patterns by looking at the type structure.\n *\n * Coverage ignored: This is defensive fallback code for edge cases where\n * checker.isArrayType() fails due to missing/broken lib.d.ts. In normal\n * usage with proper TypeScript setup, checker.isArrayType() succeeds and\n * this function is never called (short-circuit evaluation on line 120).\n */\n/* v8 ignore start */\nfunction isArrayLikeType(type: ts.Type, checker: ts.TypeChecker): boolean {\n  // Check if it's a TypeReference with 'Array' as the symbol name\n  if (type.getFlags() & ts.TypeFlags.Object) {\n    const objectType = type as ts.ObjectType;\n    const objectFlags = objectType.objectFlags;\n\n    // Check for array reference (Array<T>)\n    if (objectFlags & ts.ObjectFlags.Reference) {\n      const typeRef = type as ts.TypeReference;\n      const symbol = typeRef.symbol;\n      if (symbol && symbol.getName() === \"Array\") {\n        return true;\n      }\n      // Also check the target's symbol for ReadonlyArray, etc.\n      const target = typeRef.target;\n      if (target && target.symbol && target.symbol.getName() === \"Array\") {\n        return true;\n      }\n    }\n  }\n\n  // Check the type string as a fallback\n  const typeString = checker.typeToString(type);\n  if (typeString.endsWith(\"[]\") || typeString.startsWith(\"Array<\")) {\n    return true;\n  }\n\n  return false;\n}\n/* v8 ignore end */\n\n/**\n * Convert a TypeScript type to a JSON Schema property.\n *\n * @param type - The TypeScript type to convert.\n * @param ctx - The conversion context.\n * @returns The JSON Schema property.\n */\nexport function typeToJsonSchema(\n  type: ts.Type,\n  ctx: ConversionContext,\n): JsonSchemaProperty {\n  const checker = ctx.checker;\n\n  // Handle union types (including optional which is T | undefined)\n  if (type.isUnion()) {\n    return handleUnionType(type, ctx);\n  }\n\n  // Handle intersection types\n  if (type.isIntersection()) {\n    return handleIntersectionType(type, ctx);\n  }\n\n  // Handle literal types\n  if (type.isLiteral()) {\n    return handleLiteralType(type);\n  }\n\n  // Handle boolean literals (true/false) - these aren't captured by isLiteral()\n  // They are intrinsic types with BooleanLiteral flag\n  const flags = type.getFlags();\n  if (flags & ts.TypeFlags.BooleanLiteral) {\n    const intrinsicName = (type as ts.Type & { intrinsicName?: string })\n      .intrinsicName;\n    const isTrue = intrinsicName === \"true\";\n    return { type: \"boolean\", enum: [isTrue] };\n  }\n\n  // Handle primitive types\n\n  if (flags & ts.TypeFlags.String) {\n    return { type: \"string\" };\n  }\n\n  if (flags & ts.TypeFlags.Number) {\n    return { type: \"number\" };\n  }\n\n  if (flags & ts.TypeFlags.Null) {\n    return { type: \"null\" };\n  }\n\n  if (flags & ts.TypeFlags.Undefined) {\n    // undefined is typically filtered out from unions\n    return {};\n  }\n\n  // Handle array types\n  // Check both checker.isArrayType and TypeReference patterns\n  if (checker.isArrayType(type) || isArrayLikeType(type, checker)) {\n    const typeRef = type as ts.TypeReference;\n    const typeArgs = checker.getTypeArguments(typeRef);\n    if (typeArgs && typeArgs.length > 0) {\n      return {\n        type: \"array\",\n        items: typeToJsonSchema(typeArgs[0]!, ctx),\n      };\n    }\n    // Coverage ignored: Fallback for arrays without type arguments (e.g., broken lib.d.ts)\n    /* v8 ignore next */\n    return { type: \"array\" };\n  }\n\n  // Handle object types (interfaces, type literals, classes)\n  if (flags & ts.TypeFlags.Object) {\n    return handleObjectType(type as ts.ObjectType, ctx);\n  }\n\n  /* v8 ignore start */\n  return {};\n}\n/* v8 ignore end */\n\n/**\n * Handle union types, including optional types (T | undefined).\n */\nfunction handleUnionType(\n  type: ts.UnionType,\n  ctx: ConversionContext,\n): JsonSchemaProperty {\n  const types = type.types;\n\n  // Filter out undefined (for optional properties)\n  const nonUndefinedTypes = types.filter(\n    (t) => !(t.getFlags() & ts.TypeFlags.Undefined),\n  );\n\n  // Check if this is a boolean type (union of true | false)\n  if (\n    nonUndefinedTypes.length === 2 &&\n    nonUndefinedTypes.every((t) => t.getFlags() & ts.TypeFlags.BooleanLiteral)\n  ) {\n    return { type: \"boolean\" };\n  }\n\n  // If all non-undefined types are string/number literals, create an enum\n  if (\n    nonUndefinedTypes.every((t): t is ts.StringLiteralType =>\n      t.isStringLiteral(),\n    )\n  ) {\n    return {\n      type: \"string\",\n      enum: nonUndefinedTypes.map((t) => t.value),\n    };\n  }\n\n  if (\n    nonUndefinedTypes.every((t): t is ts.NumberLiteralType =>\n      t.isNumberLiteral(),\n    )\n  ) {\n    return {\n      type: \"number\",\n      enum: nonUndefinedTypes.map((t) => t.value),\n    };\n  }\n\n  // If only one non-undefined type remains, use it directly\n  if (nonUndefinedTypes.length === 1) {\n    return typeToJsonSchema(nonUndefinedTypes[0]!, ctx);\n  }\n\n  // Otherwise, create a oneOf schema\n  return {\n    oneOf: nonUndefinedTypes.map((t) => typeToJsonSchema(t, ctx)),\n  };\n}\n\n/**\n * Handle intersection types by merging properties.\n */\nfunction handleIntersectionType(\n  type: ts.IntersectionType,\n  ctx: ConversionContext,\n): JsonSchemaProperty {\n  const allOf = type.types.map((t) => typeToJsonSchema(t, ctx));\n\n  // If all parts are objects, try to merge them\n  if (allOf.every((s) => s.type === \"object\")) {\n    const merged: JsonSchemaProperty = {\n      type: \"object\",\n      properties: {},\n      required: [],\n    };\n\n    for (const schema of allOf) {\n      if (schema.properties) {\n        merged.properties = { ...merged.properties, ...schema.properties };\n      }\n      if (schema.required) {\n        merged.required = [\n          ...(merged.required as string[]),\n          ...(schema.required as string[]),\n        ];\n      }\n    }\n\n    return merged;\n  }\n\n  return { allOf };\n}\n\n/**\n * Handle literal types (string, number literals).\n * Note: Boolean literals (true/false) are handled earlier via BooleanLiteral flag\n * since TypeScript's isLiteral() doesn't return true for them.\n */\nfunction handleLiteralType(type: ts.Type): JsonSchemaProperty {\n  if (type.isStringLiteral()) {\n    return { type: \"string\", enum: [type.value] };\n  }\n\n  if (type.isNumberLiteral()) {\n    return { type: \"number\", enum: [type.value] };\n  }\n\n  /* v8 ignore start */\n  return {};\n}\n/* v8 ignore end */\n\n/**\n * Handle object types (interfaces, type literals, classes).\n */\nfunction handleObjectType(\n  type: ts.ObjectType,\n  ctx: ConversionContext,\n): JsonSchemaProperty {\n  const checker = ctx.checker;\n  const properties: Record<string, JsonSchemaProperty> = {};\n  const required: string[] = [];\n\n  // Get all properties of the type\n  const props = checker.getPropertiesOfType(type);\n\n  for (const prop of props) {\n    const propName = prop.getName();\n    const propType = checker.getTypeOfSymbol(prop);\n\n    // Check if the property is optional\n    const isOptional = (prop.getFlags() & ts.SymbolFlags.Optional) !== 0;\n\n    // Convert the property type to schema\n    const propSchema = typeToJsonSchema(propType, ctx);\n\n    // Extract JSDoc description from property declaration\n    const jsDocComment = prop.getDocumentationComment(checker);\n    if (jsDocComment.length > 0) {\n      const description = jsDocComment.map((c) => c.text).join(\"\");\n      propSchema.description = description;\n    }\n\n    properties[propName] = propSchema;\n\n    // Add to required if not optional\n    if (!isOptional) {\n      required.push(propName);\n    }\n  }\n\n  return {\n    type: \"object\",\n    properties,\n    required: required.length > 0 ? required : undefined,\n  };\n}\n\n/**\n * Convert a TypeScript type to a ToolParameterSchema.\n *\n * This is the main entry point for converting tool argument types\n * to the schema format expected by LLM providers.\n *\n * @param type - The TypeScript type to convert (should be an object type).\n * @param checker - The TypeScript type checker.\n * @returns The tool parameter schema.\n */\nexport function typeToToolParameterSchema(\n  type: ts.Type,\n  checker: ts.TypeChecker,\n): ToolParameterSchema {\n  const ctx: ConversionContext = {\n    checker,\n    definitions: new Map(),\n    processing: new Set(),\n  };\n\n  const schema = typeToJsonSchema(type, ctx);\n\n  // Ensure the result is an object schema\n  if (schema.type !== \"object\") {\n    throw new Error(\n      \"Tool parameter type must be an object type, got: \" +\n        JSON.stringify(schema),\n    );\n  }\n\n  // Build a mutable result, then return as readonly\n  const result: {\n    type: \"object\";\n    properties: Record<string, JsonSchemaProperty>;\n    required: readonly string[];\n    additionalProperties: false;\n    $defs?: Record<string, JsonSchemaProperty>;\n  } = {\n    type: \"object\",\n    properties: schema.properties ?? {},\n    required: (schema.required as readonly string[]) ?? [],\n    additionalProperties: false,\n  };\n\n  // Coverage ignored: $defs only populated for recursive types (not yet implemented)\n  /* v8 ignore start */\n  if (ctx.definitions.size > 0) {\n    result.$defs = Object.fromEntries(ctx.definitions);\n  }\n  /* v8 ignore end */\n\n  return result;\n}\n\n/**\n * Create a ConversionContext for testing or manual use.\n */\nexport function createConversionContext(\n  checker: ts.TypeChecker,\n): ConversionContext {\n  return {\n    checker,\n    definitions: new Map(),\n    processing: new Set(),\n  };\n}\n","/**\n * TypeScript transformer for injecting schemas into tool and format definitions.\n *\n * This transformer finds calls to `defineTool<T>()`, `defineContextTool<T, DepsT>()`,\n * and `defineFormat<T>()` and injects the `__schema` property with the JSON schema\n * generated from type T.\n */\n\nimport ts from \"typescript\";\n\nimport { typeToToolParameterSchema } from \"./type-to-schema\";\n\n/**\n * Names of functions that should have schemas injected.\n */\nconst TOOL_FUNCTION_NAMES = new Set([\"defineTool\", \"defineContextTool\"]);\n\n/**\n * Names of format functions that should have schemas injected.\n */\nconst FORMAT_FUNCTION_NAMES = new Set([\"defineFormat\"]);\n\n/**\n * Create a TypeScript transformer that injects __schema into tool definitions.\n *\n * @param program - The TypeScript program.\n * @returns A transformer factory.\n */\nexport function createToolSchemaTransformer(\n  program: ts.Program,\n): ts.TransformerFactory<ts.SourceFile> {\n  const checker = program.getTypeChecker();\n\n  return (context: ts.TransformationContext) => {\n    return (sourceFile: ts.SourceFile) => {\n      const visitor = (node: ts.Node): ts.Node => {\n        // Look for call expressions\n        if (ts.isCallExpression(node)) {\n          // Try tool transform first\n          const toolTransformed = tryTransformToolCall(node, checker, context);\n          if (toolTransformed) {\n            return toolTransformed;\n          }\n\n          // Try format transform\n          const formatTransformed = tryTransformFormatCall(\n            node,\n            checker,\n            context,\n          );\n          if (formatTransformed) {\n            return formatTransformed;\n          }\n        }\n\n        // Continue visiting children\n        return ts.visitEachChild(node, visitor, context);\n      };\n\n      return ts.visitNode(sourceFile, visitor) as ts.SourceFile;\n    };\n  };\n}\n\n/**\n * Try to transform a call expression if it's a tool definition.\n *\n * @param node - The call expression node.\n * @param checker - The type checker.\n * @param context - The transformation context.\n * @returns The transformed node, or undefined if not a tool definition.\n */\nfunction tryTransformToolCall(\n  node: ts.CallExpression,\n  checker: ts.TypeChecker,\n  context: ts.TransformationContext,\n): ts.CallExpression | undefined {\n  // Check if this is a call to defineTool or defineContextTool\n  const functionName = getFunctionName(node);\n  if (!functionName || !TOOL_FUNCTION_NAMES.has(functionName)) {\n    return undefined;\n  }\n\n  // Get the type arguments (the generic parameter T)\n  const typeArgs = node.typeArguments;\n  if (!typeArgs || typeArgs.length === 0) {\n    // No type arguments - can't generate schema\n    return undefined;\n  }\n\n  // Get the first type argument (T for args type)\n  const argsTypeNode = typeArgs[0]!;\n  const argsType = checker.getTypeFromTypeNode(argsTypeNode);\n\n  // Generate the schema from the type\n  let schema;\n  try {\n    schema = typeToToolParameterSchema(argsType, checker);\n  } catch {\n    // If schema generation fails, leave the call unchanged\n    return undefined;\n  }\n\n  // Get the first argument (the options object)\n  const args = node.arguments;\n  const firstArg = args[0];\n  if (!firstArg || !ts.isObjectLiteralExpression(firstArg)) {\n    return undefined;\n  }\n\n  const optionsObject = firstArg;\n\n  // Check if __schema is already present\n  const hasSchema = optionsObject.properties.some(\n    (prop) =>\n      ts.isPropertyAssignment(prop) &&\n      ts.isIdentifier(prop.name) &&\n      prop.name.text === \"__schema\",\n  );\n\n  if (hasSchema) {\n    // Already has a schema, don't override\n    return undefined;\n  }\n\n  // Create the __schema property\n  const schemaProperty = createSchemaProperty(schema, context.factory);\n\n  // Create a new options object with __schema added\n  const newProperties = [...optionsObject.properties, schemaProperty];\n  const newOptionsObject = context.factory.updateObjectLiteralExpression(\n    optionsObject,\n    newProperties,\n  );\n\n  // Create a new call expression with the updated options\n  const newArgs = [newOptionsObject, ...args.slice(1)];\n  return context.factory.updateCallExpression(\n    node,\n    node.expression,\n    node.typeArguments,\n    newArgs,\n  );\n}\n\n/**\n * Try to transform a call expression if it's a format definition.\n *\n * For defineFormat<T>(options):\n * - If the options arg is an object literal, inject __schema from type T\n * - If __schema is already present, leave unchanged\n * - If options has a validator, the validator's schema is used at runtime\n *\n * @param node - The call expression node.\n * @param checker - The type checker.\n * @param context - The transformation context.\n * @returns The transformed node, or undefined if not a format definition.\n */\nfunction tryTransformFormatCall(\n  node: ts.CallExpression,\n  checker: ts.TypeChecker,\n  context: ts.TransformationContext,\n): ts.CallExpression | undefined {\n  // Check if this is a call to defineFormat\n  const functionName = getFunctionName(node);\n  if (!functionName || !FORMAT_FUNCTION_NAMES.has(functionName)) {\n    return undefined;\n  }\n\n  // Get the type arguments (the generic parameter T)\n  const typeArgs = node.typeArguments;\n  if (!typeArgs || typeArgs.length === 0) {\n    // No type arguments - can't generate schema\n    return undefined;\n  }\n\n  // Get the first type argument (T for the output type)\n  const outputTypeNode = typeArgs[0]!;\n  const outputType = checker.getTypeFromTypeNode(outputTypeNode);\n\n  // Get the first argument\n  const args = node.arguments;\n  const firstArg = args[0];\n  if (!firstArg) {\n    return undefined;\n  }\n\n  // If first arg is an object literal (FormatSpec), inject __schema\n  if (ts.isObjectLiteralExpression(firstArg)) {\n    const formatSpecObject = firstArg;\n\n    // Check if __schema is already present\n    const hasSchema = formatSpecObject.properties.some(\n      (prop) =>\n        ts.isPropertyAssignment(prop) &&\n        ts.isIdentifier(prop.name) &&\n        prop.name.text === \"__schema\",\n    );\n\n    if (hasSchema) {\n      // Already has a schema, don't override\n      return undefined;\n    }\n\n    // Generate the schema from the type\n    let schema;\n    try {\n      schema = typeToToolParameterSchema(outputType, checker);\n    } catch {\n      // If schema generation fails, leave the call unchanged\n      return undefined;\n    }\n\n    // Create the __schema property\n    const schemaProperty = createSchemaProperty(schema, context.factory);\n\n    // Create a new format spec object with __schema added\n    const newProperties = [...formatSpecObject.properties, schemaProperty];\n    const newFormatSpecObject = context.factory.updateObjectLiteralExpression(\n      formatSpecObject,\n      newProperties,\n    );\n\n    // Create a new call expression with the updated format spec\n    const newArgs = [newFormatSpecObject, ...args.slice(1)];\n    return context.factory.updateCallExpression(\n      node,\n      node.expression,\n      node.typeArguments,\n      newArgs,\n    );\n  }\n\n  // If first arg is not an object literal (e.g., a Zod schema identifier),\n  // leave unchanged - Zod schemas handle their own schema generation\n  return undefined;\n}\n\n/**\n * Get the function name from a call expression.\n */\n/* v8 ignore start */\nfunction getFunctionName(node: ts.CallExpression): string | undefined {\n  const expression = node.expression;\n\n  // Direct call: defineTool(...)\n  if (ts.isIdentifier(expression)) {\n    return expression.text;\n  }\n\n  // Property access: llm.defineTool(...)\n  if (ts.isPropertyAccessExpression(expression)) {\n    return expression.name.text;\n  }\n\n  return undefined;\n}\n/* v8 ignore end */\n\n/**\n * Create a __schema property assignment from a schema object.\n */\nfunction createSchemaProperty(\n  schema: object,\n  factory: ts.NodeFactory,\n): ts.PropertyAssignment {\n  return factory.createPropertyAssignment(\n    factory.createIdentifier(\"__schema\"),\n    jsonToAst(schema, factory),\n  );\n}\n\n/**\n * Convert a JSON value to a TypeScript AST expression.\n *\n * Coverage notes: Some branches are ignored because JSON Schema values\n * are always one of: null, string, number, boolean, array, or object.\n * The ignored branches handle edge cases that can't occur with valid schemas.\n */\nfunction jsonToAst(value: unknown, factory: ts.NodeFactory): ts.Expression {\n  // Coverage ignored: JSON schemas from typeToToolParameterSchema never contain\n  // top-level null/undefined values, but we handle them defensively\n  /* v8 ignore start */\n  if (value === null) {\n    return factory.createNull();\n  }\n  if (value === undefined) {\n    return factory.createIdentifier(\"undefined\");\n  }\n  /* v8 ignore end */\n\n  if (typeof value === \"string\") {\n    return factory.createStringLiteral(value);\n  }\n\n  if (typeof value === \"number\") {\n    return factory.createNumericLiteral(value);\n  }\n\n  if (typeof value === \"boolean\") {\n    /* v8 ignore next */\n    return value ? factory.createTrue() : factory.createFalse();\n  }\n\n  if (Array.isArray(value)) {\n    return factory.createArrayLiteralExpression(\n      value.map((item) => jsonToAst(item, factory)),\n    );\n  }\n\n  if (typeof value === \"object\") {\n    const properties = Object.entries(value).map(([key, val]) =>\n      factory.createPropertyAssignment(\n        factory.createIdentifier(key),\n        jsonToAst(val, factory),\n      ),\n    );\n    return factory.createObjectLiteralExpression(properties, true);\n  }\n\n  // Coverage ignored: After handling all JSON-valid types (null, undefined,\n  // string, number, boolean, array, object), this is unreachable\n  /* v8 ignore next */\n  return factory.createIdentifier(\"undefined\");\n}\n\n/**\n * Default export for ts-patch and other transformer loaders.\n */\nexport default function transformer(\n  program: ts.Program,\n): ts.TransformerFactory<ts.SourceFile> {\n  return createToolSchemaTransformer(program);\n}\n","/**\n * Bun preload plugin for Mirascope tool schema transformation.\n *\n * This plugin intercepts TypeScript file loading and applies the Mirascope\n * transformer to inject tool schemas at runtime.\n *\n * ## Usage\n *\n * Create a preload file (e.g., `preload.ts`):\n * ```typescript\n * import { mirascope } from 'mirascope/bun';\n * mirascope();\n * ```\n *\n * Add to your `bunfig.toml`:\n * ```toml\n * preload = [\"./preload.ts\"]\n * ```\n *\n * Then run your files normally:\n * ```bash\n * bun run my-file.ts\n * ```\n */\n\n/* eslint-disable @typescript-eslint/unbound-method */\nimport { plugin } from \"bun\";\nimport { readFileSync } from \"fs\";\nimport { resolve, dirname } from \"path\";\nimport ts from \"typescript\";\n\nimport { createToolSchemaTransformer } from \"./transform/transformer\";\n\n/**\n * Options for the Mirascope Bun plugin.\n */\nexport interface MirascopeBunPluginOptions {\n  /**\n   * File filter pattern. Defaults to /\\.tsx?$/\n   */\n  filter?: RegExp;\n\n  /**\n   * Patterns to exclude. Files matching these won't be transformed.\n   * Defaults to [/node_modules/]\n   */\n  exclude?: RegExp[];\n}\n\n/**\n * Check if a file contains defineTool, defineContextTool, or defineFormat calls.\n * Quick regex check to avoid expensive TypeScript compilation for files that don't need it.\n */\nfunction needsTransform(contents: string): boolean {\n  return /\\bdefineTool\\b|\\bdefineContextTool\\b|\\bdefineFormat\\b/.test(contents);\n}\n\n/**\n * Transform TypeScript source code to inject tool schemas.\n */\nfunction transformSource(\n  filePath: string,\n  contents: string,\n): string | undefined {\n  // Find tsconfig.json\n  const configPath = ts.findConfigFile(\n    dirname(filePath),\n    ts.sys.fileExists,\n    \"tsconfig.json\",\n  );\n\n  const compilerOptions: ts.CompilerOptions = {\n    target: ts.ScriptTarget.ESNext,\n    module: ts.ModuleKind.ESNext,\n    moduleResolution: ts.ModuleResolutionKind.Bundler,\n    esModuleInterop: true,\n    strict: true,\n  };\n\n  // Load tsconfig if found\n  if (configPath) {\n    const configFile = ts.readConfigFile(configPath, ts.sys.readFile);\n    if (!configFile.error) {\n      const parsed = ts.parseJsonConfigFileContent(\n        configFile.config,\n        ts.sys,\n        dirname(configPath),\n      );\n      Object.assign(compilerOptions, parsed.options);\n    }\n  }\n\n  // Create a program with just this file\n  const host = ts.createCompilerHost(compilerOptions);\n  const originalGetSourceFile = host.getSourceFile;\n\n  // Override to provide our in-memory source\n  host.getSourceFile = (\n    fileName: string,\n    languageVersion: ts.ScriptTarget,\n    onError?: (message: string) => void,\n    shouldCreateNewSourceFile?: boolean,\n  ) => {\n    if (resolve(fileName) === resolve(filePath)) {\n      return ts.createSourceFile(fileName, contents, languageVersion, true);\n    }\n    return originalGetSourceFile(\n      fileName,\n      languageVersion,\n      onError,\n      shouldCreateNewSourceFile,\n    );\n  };\n\n  const program = ts.createProgram([filePath], compilerOptions, host);\n  const sourceFile = program.getSourceFile(filePath);\n\n  if (!sourceFile) {\n    return undefined;\n  }\n\n  // Apply the transformer\n  const transformer = createToolSchemaTransformer(program);\n  const result = ts.transform(sourceFile, [transformer]);\n  const transformedSourceFile = result.transformed[0];\n\n  if (!transformedSourceFile) {\n    result.dispose();\n    return undefined;\n  }\n\n  // Print the transformed source back to string\n  const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });\n  const output = printer.printFile(transformedSourceFile);\n\n  result.dispose();\n  return output;\n}\n\n/**\n * Register the Mirascope Bun plugin for tool schema transformation.\n *\n * @param options - Plugin options.\n *\n * @example\n * ```typescript\n * // preload.ts\n * import { mirascope } from 'mirascope/bun';\n * mirascope();\n * ```\n */\nexport function mirascope(options: MirascopeBunPluginOptions = {}): void {\n  const { filter = /\\.tsx?$/, exclude = [/node_modules/] } = options;\n\n  plugin({\n    name: \"mirascope\",\n    setup(build) {\n      build.onLoad({ filter }, (args) => {\n        // Check exclusions - let Bun handle these normally\n        for (const pattern of exclude) {\n          if (pattern.test(args.path)) {\n            // Return undefined to let Bun handle it normally\n            return;\n          }\n        }\n\n        const contents = readFileSync(args.path, \"utf-8\");\n        const loader = args.path.endsWith(\".tsx\") ? \"tsx\" : \"ts\";\n\n        // Quick check: skip files without tool definitions\n        if (!needsTransform(contents)) {\n          // Return original contents to keep Bun happy\n          return { contents, loader };\n        }\n\n        const transformed = transformSource(args.path, contents);\n\n        // Return transformed or original contents\n        return {\n          contents: transformed ?? contents,\n          loader,\n        };\n      });\n    },\n  });\n}\n\nexport default mirascope;\n"]}

package/dist/bun.d.cts

@@ -0,0 +1,53 @@
+/**
+ * Bun preload plugin for Mirascope tool schema transformation.
+ *
+ * This plugin intercepts TypeScript file loading and applies the Mirascope
+ * transformer to inject tool schemas at runtime.
+ *
+ * ## Usage
+ *
+ * Create a preload file (e.g., `preload.ts`):
+ * ```typescript
+ * import { mirascope } from 'mirascope/bun';
+ * mirascope();
+ * ```
+ *
+ * Add to your `bunfig.toml`:
+ * ```toml
+ * preload = ["./preload.ts"]
+ * ```
+ *
+ * Then run your files normally:
+ * ```bash
+ * bun run my-file.ts
+ * ```
+ */
+/**
+ * Options for the Mirascope Bun plugin.
+ */
+interface MirascopeBunPluginOptions {
+    /**
+     * File filter pattern. Defaults to /\.tsx?$/
+     */
+    filter?: RegExp;
+    /**
+     * Patterns to exclude. Files matching these won't be transformed.
+     * Defaults to [/node_modules/]
+     */
+    exclude?: RegExp[];
+}
+/**
+ * Register the Mirascope Bun plugin for tool schema transformation.
+ *
+ * @param options - Plugin options.
+ *
+ * @example
+ * ```typescript
+ * // preload.ts
+ * import { mirascope } from 'mirascope/bun';
+ * mirascope();
+ * ```
+ */
+declare function mirascope(options?: MirascopeBunPluginOptions): void;
+
+export { type MirascopeBunPluginOptions, mirascope as default, mirascope };

package/dist/bun.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Bun preload plugin for Mirascope tool schema transformation.
+ *
+ * This plugin intercepts TypeScript file loading and applies the Mirascope
+ * transformer to inject tool schemas at runtime.
+ *
+ * ## Usage
+ *
+ * Create a preload file (e.g., `preload.ts`):
+ * ```typescript
+ * import { mirascope } from 'mirascope/bun';
+ * mirascope();
+ * ```
+ *
+ * Add to your `bunfig.toml`:
+ * ```toml
+ * preload = ["./preload.ts"]
+ * ```
+ *
+ * Then run your files normally:
+ * ```bash
+ * bun run my-file.ts
+ * ```
+ */
+/**
+ * Options for the Mirascope Bun plugin.
+ */
+interface MirascopeBunPluginOptions {
+    /**
+     * File filter pattern. Defaults to /\.tsx?$/
+     */
+    filter?: RegExp;
+    /**
+     * Patterns to exclude. Files matching these won't be transformed.
+     * Defaults to [/node_modules/]
+     */
+    exclude?: RegExp[];
+}
+/**
+ * Register the Mirascope Bun plugin for tool schema transformation.
+ *
+ * @param options - Plugin options.
+ *
+ * @example
+ * ```typescript
+ * // preload.ts
+ * import { mirascope } from 'mirascope/bun';
+ * mirascope();
+ * ```
+ */
+declare function mirascope(options?: MirascopeBunPluginOptions): void;
+
+export { type MirascopeBunPluginOptions, mirascope as default, mirascope };