mcp-from-openapi 2.2.0 → 2.3.0

package/esm/index.mjs

@@ -2,7 +2,6 @@
 import * as yaml from "yaml";
 import * as path from "path";
 import * as fs from "fs/promises";
-import $RefParser from "@apidevtools/json-schema-ref-parser";
 
 // src/types.ts
 function isReferenceObject(obj) {
@@ -686,6 +685,115 @@ var SchemaError = class extends OpenAPIToolError {
   }
 };
 
+// src/format-resolver.ts
+var BUILTIN_FORMAT_RESOLVERS = {
+  // String formats
+  uuid: (schema) => ({
+    ...schema,
+    pattern: schema.pattern ?? "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
+    description: schema.description || "UUID string (RFC 4122)"
+  }),
+  "date-time": (schema) => ({
+    ...schema,
+    description: schema.description || "ISO 8601 date-time (e.g., 2024-01-15T09:30:00Z)"
+  }),
+  date: (schema) => ({
+    ...schema,
+    pattern: schema.pattern ?? "^\\d{4}-\\d{2}-\\d{2}$",
+    description: schema.description || "ISO 8601 date (e.g., 2024-01-15)"
+  }),
+  time: (schema) => ({
+    ...schema,
+    pattern: schema.pattern ?? "^\\d{2}:\\d{2}:\\d{2}",
+    description: schema.description || "ISO 8601 time (e.g., 09:30:00)"
+  }),
+  email: (schema) => ({
+    ...schema,
+    description: schema.description || "Email address (RFC 5322)"
+  }),
+  uri: (schema) => ({
+    ...schema,
+    description: schema.description || "URI (RFC 3986)"
+  }),
+  "uri-reference": (schema) => ({
+    ...schema,
+    description: schema.description || "URI reference (RFC 3986)"
+  }),
+  hostname: (schema) => ({
+    ...schema,
+    description: schema.description || "Internet hostname (RFC 1123)"
+  }),
+  ipv4: (schema) => ({
+    ...schema,
+    pattern: schema.pattern ?? "^((25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(25[0-5]|2[0-4]\\d|[01]?\\d\\d?)$",
+    description: schema.description || "IPv4 address"
+  }),
+  ipv6: (schema) => ({
+    ...schema,
+    description: schema.description || "IPv6 address (RFC 4291)"
+  }),
+  // Integer formats
+  int32: (schema) => ({
+    ...schema,
+    minimum: schema.minimum ?? -2147483648,
+    maximum: schema.maximum ?? 2147483647
+  }),
+  int64: (schema) => ({
+    ...schema,
+    minimum: schema.minimum ?? Number.MIN_SAFE_INTEGER,
+    maximum: schema.maximum ?? Number.MAX_SAFE_INTEGER
+  }),
+  // Binary/encoding formats
+  byte: (schema) => ({
+    ...schema,
+    pattern: schema.pattern ?? "^[A-Za-z0-9+/]*={0,2}$",
+    description: schema.description || "Base64-encoded string (RFC 4648)"
+  }),
+  binary: (schema) => ({
+    ...schema,
+    description: schema.description || "Binary data"
+  }),
+  // Sensitive data formats
+  password: (schema) => ({
+    ...schema,
+    description: schema.description || "Password (sensitive, UI should mask input)"
+  })
+};
+function resolveSchemaFormats(schema, resolvers) {
+  if (!schema || typeof schema !== "object") return schema;
+  let result = { ...schema };
+  const format = result["format"];
+  if (format && resolvers[format]) {
+    result = { ...resolvers[format](result) };
+  }
+  if (result["properties"] && typeof result["properties"] === "object") {
+    const props = {};
+    for (const [key, value] of Object.entries(result["properties"])) {
+      props[key] = resolveSchemaFormats(value, resolvers);
+    }
+    result["properties"] = props;
+  }
+  if (result["items"]) {
+    if (Array.isArray(result["items"])) {
+      result["items"] = result["items"].map((item) => resolveSchemaFormats(item, resolvers));
+    } else {
+      result["items"] = resolveSchemaFormats(result["items"], resolvers);
+    }
+  }
+  if (result["additionalProperties"] && typeof result["additionalProperties"] === "object") {
+    result["additionalProperties"] = resolveSchemaFormats(result["additionalProperties"], resolvers);
+  }
+  for (const key of ["allOf", "anyOf", "oneOf"]) {
+    if (result[key] && Array.isArray(result[key])) {
+      result[key] = result[key].map((s) => resolveSchemaFormats(s, resolvers));
+    }
+  }
+  if (result["not"] && typeof result["not"] === "object") {
+    result["not"] = resolveSchemaFormats(result["not"], resolvers);
+  }
+  return result;
+}
+
 // src/generator.ts
 var OpenAPIToolGenerator = class _OpenAPIToolGenerator {
   document;
@@ -909,17 +1017,12 @@ var OpenAPIToolGenerator = class _OpenAPIToolGenerator {
     return { resolve: resolveConfig };
   }
   /**
-   * Initialize the generator (dereference if needed)
+   * Initialize the generator (dereference if needed, then validate)
    */
   async initialize() {
-    if (this.options.validate) {
-      const result = await this.validate();
-      if (!result.valid) {
-        throw new ParseError("Invalid OpenAPI document", { errors: result.errors });
-      }
-    }
     if (this.options.dereference && !this.dereferencedDocument) {
       try {
+        const { default: $RefParser } = await import("@apidevtools/json-schema-ref-parser");
         const refParserOptions = this.buildRefParserOptions();
         this.dereferencedDocument = await $RefParser.dereference(
           JSON.parse(JSON.stringify(this.document)),
@@ -932,6 +1035,14 @@ var OpenAPIToolGenerator = class _OpenAPIToolGenerator {
         });
       }
     }
+    if (this.options.validate) {
+      const validator = new Validator();
+      const documentToValidate = this.dereferencedDocument ?? this.document;
+      const result = await validator.validate(documentToValidate);
+      if (!result.valid) {
+        throw new ParseError("Invalid OpenAPI document", { errors: result.errors });
+      }
+    }
   }
   /**
    * Generate all tools from the OpenAPI specification
@@ -1000,11 +1111,18 @@ var OpenAPIToolGenerator = class _OpenAPIToolGenerator {
     const name = this.generateToolName(pathStr, method, operation.operationId, options);
     const description = operation.summary || operation.description || `${method.toUpperCase()} ${pathStr}`;
     const metadata = this.extractMetadata(pathStr, method, operation, document, outputSchema);
+    const formatResolvers = {
+      ...options.resolveFormats ? BUILTIN_FORMAT_RESOLVERS : {},
+      ...options.formatResolvers
+    };
+    const hasFormatResolvers = Object.keys(formatResolvers).length > 0;
+    const resolvedInputSchema = hasFormatResolvers ? resolveSchemaFormats(inputSchema, formatResolvers) : inputSchema;
+    const resolvedOutputSchema = hasFormatResolvers && outputSchema ? resolveSchemaFormats(outputSchema, formatResolvers) : outputSchema;
     return {
       name,
       description,
-      inputSchema,
-      outputSchema,
+      inputSchema: resolvedInputSchema,
+      outputSchema: resolvedOutputSchema,
       mapper,
       metadata
     };
@@ -1454,6 +1572,7 @@ var SecurityResolver = class {
     if (requiresSignature) {
       resolved.requiresSignature = true;
       resolved.signatureInfo = {
+        /* c8 ignore next -- signatureScheme is always set from security.scheme */
         scheme: signatureScheme || "unknown"
       };
     }
@@ -1499,6 +1618,7 @@ var SecurityResolver = class {
         return this.resolveBasicAuth(context);
       case "digest":
         return this.resolveDigestAuth(context);
+      /* c8 ignore next -- hoba is part of the same fall-through as mutual/negotiate/vapid/scram */
       case "hoba":
       case "mutual":
       case "negotiate":
@@ -1646,6 +1766,7 @@ function createSecurityContext(auth) {
   };
 }
 export {
+  BUILTIN_FORMAT_RESOLVERS,
   GenerationError,
   LoadError,
   OpenAPIToolError,
@@ -1660,5 +1781,6 @@ export {
   Validator,
   createSecurityContext,
   isReferenceObject,
+  resolveSchemaFormats,
   toJsonSchema
 };

package/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-from-openapi",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Production-ready library for converting OpenAPI specifications into MCP tool definitions",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -27,7 +27,7 @@
   },
   "homepage": "https://github.com/agentfront/mcp-from-openapi#readme",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "type": "module",
   "main": "../index.js",
@@ -48,7 +48,7 @@
     }
   },
   "dependencies": {
-    "@apidevtools/json-schema-ref-parser": "^11.9.3",
+    "@apidevtools/json-schema-ref-parser": "^15.3.5",
     "openapi-types": "^12.1.3",
     "yaml": "^2.8.3"
   },
@@ -60,6 +60,7 @@
     "@swc/helpers": "^0.5.18",
     "@swc/jest": "~0.2.38",
     "@types/jest": "^29.5.0",
+    "@types/json-schema": "^7.0.15",
     "@types/node": "^24.0.0",
     "esbuild": "^0.27.2",
     "jest": "^29.7.0",

package/format-resolver.d.ts

@@ -0,0 +1,12 @@
+import type { JsonSchema, FormatResolver } from './types';
+/**
+ * Built-in format resolvers that enrich JSON Schema with concrete constraints.
+ * Each resolver only adds constraints if not already present on the schema.
+ */
+export declare const BUILTIN_FORMAT_RESOLVERS: Record<string, FormatResolver>;
+/**
+ * Recursively resolve format fields in a JSON Schema tree.
+ * For each schema node with a `format` field, the matching resolver
+ * is applied to enrich the schema with concrete constraints.
+ */
+export declare function resolveSchemaFormats(schema: JsonSchema, resolvers: Record<string, FormatResolver>): JsonSchema;

package/generator.d.ts

@@ -49,7 +49,7 @@ export declare class OpenAPIToolGenerator {
      */
     private buildRefParserOptions;
     /**
-     * Initialize the generator (dereference if needed)
+     * Initialize the generator (dereference if needed, then validate)
      */
     private initialize;
     /**

package/index.d.ts

@@ -4,7 +4,8 @@ export { ParameterResolver } from './parameter-resolver';
 export { ResponseBuilder } from './response-builder';
 export { Validator } from './validator';
 export { SecurityResolver, createSecurityContext } from './security-resolver';
+export { BUILTIN_FORMAT_RESOLVERS, resolveSchemaFormats } from './format-resolver';
 export { OpenAPIToolError, LoadError, ParseError, ValidationError, GenerationError, SchemaError } from './errors';
-export type { McpOpenAPITool, ParameterMapper, ToolMetadata, FrontMcpExtensionData, SerializationInfo, SecurityRequirement, SecurityParameterInfo, ServerInfo, RefResolutionOptions, LoadOptions, GenerateOptions, NamingStrategy, OperationWithContext, OpenAPIDocument, OpenAPIVersion, HTTPMethod, ParameterLocation, AuthType, OperationObject, ParameterObject, RequestBodyObject, ResponseObject, ResponsesObject, MediaTypeObject, HeaderObject, ExampleObject, PathItemObject, PathsObject, ServerObject, SecuritySchemeObject, ReferenceObject, TagObject, ExternalDocumentationObject, ServerVariableObject, EncodingObject, SecurityRequirementObject, SchemaObject, ValidationResult, ValidationErrorDetail, ValidationWarning, } from './types';
+export type { McpOpenAPITool, ParameterMapper, ToolMetadata, FrontMcpExtensionData, SerializationInfo, SecurityRequirement, SecurityParameterInfo, ServerInfo, RefResolutionOptions, LoadOptions, GenerateOptions, FormatResolver, JsonSchema, NamingStrategy, OperationWithContext, OpenAPIDocument, OpenAPIVersion, HTTPMethod, ParameterLocation, AuthType, OperationObject, ParameterObject, RequestBodyObject, ResponseObject, ResponsesObject, MediaTypeObject, HeaderObject, ExampleObject, PathItemObject, PathsObject, ServerObject, SecuritySchemeObject, ReferenceObject, TagObject, ExternalDocumentationObject, ServerVariableObject, EncodingObject, SecurityRequirementObject, SchemaObject, ValidationResult, ValidationErrorDetail, ValidationWarning, } from './types';
 export type { SecurityContext, ResolvedSecurity, DigestAuthCredentials, ClientCertificate, AWSCredentials, SignatureData, } from './security-resolver';
 export { isReferenceObject, toJsonSchema } from './types';

package/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  BUILTIN_FORMAT_RESOLVERS: () => BUILTIN_FORMAT_RESOLVERS,
   GenerationError: () => GenerationError,
   LoadError: () => LoadError,
   OpenAPIToolError: () => OpenAPIToolError,
@@ -44,6 +45,7 @@ __export(index_exports, {
   Validator: () => Validator,
   createSecurityContext: () => createSecurityContext,
   isReferenceObject: () => isReferenceObject,
+  resolveSchemaFormats: () => resolveSchemaFormats,
   toJsonSchema: () => toJsonSchema
 });
 module.exports = __toCommonJS(index_exports);
@@ -52,7 +54,6 @@ module.exports = __toCommonJS(index_exports);
 var yaml = __toESM(require("yaml"));
 var path = __toESM(require("path"));
 var fs = __toESM(require("fs/promises"));
-var import_json_schema_ref_parser = __toESM(require("@apidevtools/json-schema-ref-parser"));
 
 // src/types.ts
 function isReferenceObject(obj) {
@@ -736,6 +737,115 @@ var SchemaError = class extends OpenAPIToolError {
   }
 };
 
+// src/format-resolver.ts
+var BUILTIN_FORMAT_RESOLVERS = {
+  // String formats
+  uuid: (schema) => ({
+    ...schema,
+    pattern: schema.pattern ?? "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
+    description: schema.description || "UUID string (RFC 4122)"
+  }),
+  "date-time": (schema) => ({
+    ...schema,
+    description: schema.description || "ISO 8601 date-time (e.g., 2024-01-15T09:30:00Z)"
+  }),
+  date: (schema) => ({
+    ...schema,
+    pattern: schema.pattern ?? "^\\d{4}-\\d{2}-\\d{2}$",
+    description: schema.description || "ISO 8601 date (e.g., 2024-01-15)"
+  }),
+  time: (schema) => ({
+    ...schema,
+    pattern: schema.pattern ?? "^\\d{2}:\\d{2}:\\d{2}",
+    description: schema.description || "ISO 8601 time (e.g., 09:30:00)"
+  }),
+  email: (schema) => ({
+    ...schema,
+    description: schema.description || "Email address (RFC 5322)"
+  }),
+  uri: (schema) => ({
+    ...schema,
+    description: schema.description || "URI (RFC 3986)"
+  }),
+  "uri-reference": (schema) => ({
+    ...schema,
+    description: schema.description || "URI reference (RFC 3986)"
+  }),
+  hostname: (schema) => ({
+    ...schema,
+    description: schema.description || "Internet hostname (RFC 1123)"
+  }),
+  ipv4: (schema) => ({
+    ...schema,
+    pattern: schema.pattern ?? "^((25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(25[0-5]|2[0-4]\\d|[01]?\\d\\d?)$",
+    description: schema.description || "IPv4 address"
+  }),
+  ipv6: (schema) => ({
+    ...schema,
+    description: schema.description || "IPv6 address (RFC 4291)"
+  }),
+  // Integer formats
+  int32: (schema) => ({
+    ...schema,
+    minimum: schema.minimum ?? -2147483648,
+    maximum: schema.maximum ?? 2147483647
+  }),
+  int64: (schema) => ({
+    ...schema,
+    minimum: schema.minimum ?? Number.MIN_SAFE_INTEGER,
+    maximum: schema.maximum ?? Number.MAX_SAFE_INTEGER
+  }),
+  // Binary/encoding formats
+  byte: (schema) => ({
+    ...schema,
+    pattern: schema.pattern ?? "^[A-Za-z0-9+/]*={0,2}$",
+    description: schema.description || "Base64-encoded string (RFC 4648)"
+  }),
+  binary: (schema) => ({
+    ...schema,
+    description: schema.description || "Binary data"
+  }),
+  // Sensitive data formats
+  password: (schema) => ({
+    ...schema,
+    description: schema.description || "Password (sensitive, UI should mask input)"
+  })
+};
+function resolveSchemaFormats(schema, resolvers) {
+  if (!schema || typeof schema !== "object") return schema;
+  let result = { ...schema };
+  const format = result["format"];
+  if (format && resolvers[format]) {
+    result = { ...resolvers[format](result) };
+  }
+  if (result["properties"] && typeof result["properties"] === "object") {
+    const props = {};
+    for (const [key, value] of Object.entries(result["properties"])) {
+      props[key] = resolveSchemaFormats(value, resolvers);
+    }
+    result["properties"] = props;
+  }
+  if (result["items"]) {
+    if (Array.isArray(result["items"])) {
+      result["items"] = result["items"].map((item) => resolveSchemaFormats(item, resolvers));
+    } else {
+      result["items"] = resolveSchemaFormats(result["items"], resolvers);
+    }
+  }
+  if (result["additionalProperties"] && typeof result["additionalProperties"] === "object") {
+    result["additionalProperties"] = resolveSchemaFormats(result["additionalProperties"], resolvers);
+  }
+  for (const key of ["allOf", "anyOf", "oneOf"]) {
+    if (result[key] && Array.isArray(result[key])) {
+      result[key] = result[key].map((s) => resolveSchemaFormats(s, resolvers));
+    }
+  }
+  if (result["not"] && typeof result["not"] === "object") {
+    result["not"] = resolveSchemaFormats(result["not"], resolvers);
+  }
+  return result;
+}
+
 // src/generator.ts
 var OpenAPIToolGenerator = class _OpenAPIToolGenerator {
   document;
@@ -959,19 +1069,14 @@ var OpenAPIToolGenerator = class _OpenAPIToolGenerator {
     return { resolve: resolveConfig };
   }
   /**
-   * Initialize the generator (dereference if needed)
+   * Initialize the generator (dereference if needed, then validate)
    */
   async initialize() {
-    if (this.options.validate) {
-      const result = await this.validate();
-      if (!result.valid) {
-        throw new ParseError("Invalid OpenAPI document", { errors: result.errors });
-      }
-    }
     if (this.options.dereference && !this.dereferencedDocument) {
       try {
+        const { default: $RefParser } = await import("@apidevtools/json-schema-ref-parser");
         const refParserOptions = this.buildRefParserOptions();
-        this.dereferencedDocument = await import_json_schema_ref_parser.default.dereference(
+        this.dereferencedDocument = await $RefParser.dereference(
           JSON.parse(JSON.stringify(this.document)),
           refParserOptions
         );
@@ -982,6 +1087,14 @@ var OpenAPIToolGenerator = class _OpenAPIToolGenerator {
         });
       }
     }
+    if (this.options.validate) {
+      const validator = new Validator();
+      const documentToValidate = this.dereferencedDocument ?? this.document;
+      const result = await validator.validate(documentToValidate);
+      if (!result.valid) {
+        throw new ParseError("Invalid OpenAPI document", { errors: result.errors });
+      }
+    }
   }
   /**
    * Generate all tools from the OpenAPI specification
@@ -1050,11 +1163,18 @@ var OpenAPIToolGenerator = class _OpenAPIToolGenerator {
     const name = this.generateToolName(pathStr, method, operation.operationId, options);
     const description = operation.summary || operation.description || `${method.toUpperCase()} ${pathStr}`;
     const metadata = this.extractMetadata(pathStr, method, operation, document, outputSchema);
+    const formatResolvers = {
+      ...options.resolveFormats ? BUILTIN_FORMAT_RESOLVERS : {},
+      ...options.formatResolvers
+    };
+    const hasFormatResolvers = Object.keys(formatResolvers).length > 0;
+    const resolvedInputSchema = hasFormatResolvers ? resolveSchemaFormats(inputSchema, formatResolvers) : inputSchema;
+    const resolvedOutputSchema = hasFormatResolvers && outputSchema ? resolveSchemaFormats(outputSchema, formatResolvers) : outputSchema;
     return {
       name,
       description,
-      inputSchema,
-      outputSchema,
+      inputSchema: resolvedInputSchema,
+      outputSchema: resolvedOutputSchema,
       mapper,
       metadata
     };
@@ -1504,6 +1624,7 @@ var SecurityResolver = class {
     if (requiresSignature) {
       resolved.requiresSignature = true;
       resolved.signatureInfo = {
+        /* c8 ignore next -- signatureScheme is always set from security.scheme */
         scheme: signatureScheme || "unknown"
       };
     }
@@ -1549,6 +1670,7 @@ var SecurityResolver = class {
         return this.resolveBasicAuth(context);
       case "digest":
         return this.resolveDigestAuth(context);
+      /* c8 ignore next -- hoba is part of the same fall-through as mutual/negotiate/vapid/scram */
       case "hoba":
       case "mutual":
       case "negotiate":
@@ -1697,6 +1819,7 @@ function createSecurityContext(auth) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BUILTIN_FORMAT_RESOLVERS,
   GenerationError,
   LoadError,
   OpenAPIToolError,
@@ -1711,5 +1834,6 @@ function createSecurityContext(auth) {
   Validator,
   createSecurityContext,
   isReferenceObject,
+  resolveSchemaFormats,
   toJsonSchema
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-from-openapi",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Production-ready library for converting OpenAPI specifications into MCP tool definitions",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -27,7 +27,7 @@
   },
   "homepage": "https://github.com/agentfront/mcp-from-openapi#readme",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "type": "commonjs",
   "main": "./index.js",
@@ -48,7 +48,7 @@
     }
   },
   "dependencies": {
-    "@apidevtools/json-schema-ref-parser": "^11.9.3",
+    "@apidevtools/json-schema-ref-parser": "^15.3.5",
     "openapi-types": "^12.1.3",
     "yaml": "^2.8.3"
   },
@@ -60,6 +60,7 @@
     "@swc/helpers": "^0.5.18",
     "@swc/jest": "~0.2.38",
     "@types/jest": "^29.5.0",
+    "@types/json-schema": "^7.0.15",
     "@types/node": "^24.0.0",
     "esbuild": "^0.27.2",
     "jest": "^29.7.0",

package/types.d.ts

@@ -1,6 +1,6 @@
 import type { JSONSchema } from 'zod/v4/core';
 /** JSON Schema type from Zod v4 */
-type JsonSchema = JSONSchema.JSONSchema;
+export type JsonSchema = JSONSchema.JSONSchema;
 import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
 /**
  * OpenAPI specification version 3.0.x or 3.1.x
@@ -457,7 +457,28 @@ export interface GenerateOptions {
      * @default false
      */
     includeSecurityInInput?: boolean;
+    /**
+     * Enable built-in format-to-schema resolution.
+     * Enriches schemas with concrete constraints (patterns, descriptions, min/max)
+     * based on OpenAPI format values (uuid, date-time, email, int32, etc.).
+     * @default false
+     */
+    resolveFormats?: boolean;
+    /**
+     * Custom format resolvers. Keys are format names, values are functions
+     * that receive the original schema and return an enriched schema.
+     *
+     * When used with `resolveFormats: true`, custom resolvers are merged with
+     * built-in resolvers (custom takes precedence for the same format).
+     * When used without `resolveFormats`, only custom resolvers are applied.
+     */
+    formatResolvers?: Record<string, FormatResolver>;
 }
+/**
+ * A function that enriches a JSON Schema based on its format field.
+ * Receives the schema and returns a new schema with additional constraints.
+ */
+export type FormatResolver = (schema: JsonSchema) => JsonSchema;
 /**
  * Naming strategy for resolving parameter conflicts
  */
@@ -530,4 +551,3 @@ export interface ValidationWarning {
      */
     code?: string;
 }
-export {};

package/CHANGELOG.md

@@ -1,83 +0,0 @@
-## [2.2.0] - 2026-04-07
-
-## [2.1.2] - 2025-12-27
-
-### Changed
-
-- Added `publish-alpha` Nx target to enable alpha publishing flow using common script.
-
-## [2.1.1] - 2025-12-24
-
-### Fixed
-
-- Revised build setup to emit CJS and ESM bundles with corrected export map and sideEffects flag to improve tree shaking.
-- Synced package entry points and type outputs with the new build artifacts while preserving the public API surface.
-
-## [2.1.0] - 2025-12-19
-
-### Added
-
-- Introduced logger support within the OpenAPI adapter to improve observability.
-- Expanded security handling with automatic auth type routing and enhanced documentation.
-
-### Changed
-
-- Refined security resolver examples and guidance for broader authentication scheme coverage.
-
-## [2.0.0] - 2025-12-11
-
-### Breaking
-
-- Migrated to Zod v4 (now a peer dependency) and aligned JSON schema types with Zod’s v4 JSONSchema
-- Renamed utility export `toJSONSchema7` to `toJsonSchema`, affecting consumers of the types/helpers
-
-### Changed
-
-- Updated SWC/Jest config to inline ES2022 settings and modernized tooling versions
-- Adjusted exports formatting and minor parameter resolver refactors for consistency
-
-# Changelog
-
-## [1.0.0] - 2025-11-21
-
-### Features
-
-- Production-ready library for converting OpenAPI specifications into MCP tool definitions
-- OpenAPI 3.0+ and Swagger 2.0 support
-- Comprehensive operation parsing:
-  - RESTful endpoint detection (GET, POST, PUT, PATCH, DELETE, etc.)
-  - Path parameter extraction and validation
-  - Query parameter handling
-  - Request body schema conversion
-  - Response schema parsing
-- Advanced OpenAPI features:
-  - Reference resolution ($ref) across the entire specification
-  - Security scheme detection and configuration
-  - Parameter conflict resolution
-  - Operation naming controls and customization
-- Request mapper generation:
-  - Automatic parameter mapping from MCP tool inputs to HTTP requests
-  - Type-safe parameter handling
-  - Support for different parameter locations (path, query, header, cookie)
-  - Request body transformation
-- Tool metadata generation:
-  - Descriptive tool names from operation IDs
-  - Documentation from OpenAPI descriptions
-  - Schema validation rules
-- Multiple input formats:
-  - JSON OpenAPI specifications
-  - YAML OpenAPI specifications
-  - Inline specification objects
-  - URL references to remote specifications
-- Type-safe TypeScript implementation
-- Node.js 18+ compatibility
-
-### Documentation
-
-- Complete API reference
-- OpenAPI conversion examples
-- Integration guides for MCP servers
-- Best practices for tool generation
-
-This is the first official release of `mcp-from-openapi`, extracted from the FrontMCP framework to be published as a
-standalone, reusable library for the community.