mcp-from-openapi 1.0.0 → 2.1.0

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+## [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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-from-openapi",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "description": "Production-ready library for converting OpenAPI specifications into MCP tool definitions",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -20,7 +20,8 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/agentfront/frontmcp.git"
+    "url": "git+https://github.com/agentfront/frontmcp.git",
+    "directory": "libs/mcp-from-openapi"
   },
   "bugs": {
     "url": "https://github.com/agentfront/frontmcp/issues"
@@ -41,14 +42,16 @@
   },
   "dependencies": {
     "@apidevtools/json-schema-ref-parser": "^11.5.4",
-    "@types/json-schema": "^7.0.15",
     "openapi-types": "^12.1.3",
     "yaml": "^2.8.1"
   },
+  "peerDependencies": {
+    "zod": "^4.0.0"
+  },
   "devDependencies": {
-    "@types/node": "^22.0.0",
+    "@types/node": "^24.0.0",
     "typescript": "^5.0.0",
-    "zod": "^3.23.8"
+    "zod": "^4.0.0"
   },
   "type": "commonjs"
 }

package/src/errors.js

@@ -5,6 +5,7 @@ exports.SchemaError = exports.GenerationError = exports.ValidationError = export
  * Base error class for all library errors
  */
 class OpenAPIToolError extends Error {
+    context;
     constructor(message, context) {
         super(message);
         this.name = this.constructor.name;
@@ -38,6 +39,7 @@ exports.ParseError = ParseError;
  * Error thrown when validating an OpenAPI specification fails
  */
 class ValidationError extends OpenAPIToolError {
+    errors;
     constructor(message, context) {
         super(message, context);
         this.errors = context?.['errors'];

package/src/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAGzC,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,6EAA6E;QAC7E,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAbD,4CAaC;AAED;;GAEG;AACH,MAAa,SAAU,SAAQ,gBAAgB;IAC7C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,8BAIC;AAED;;GAEG;AACH,MAAa,UAAW,SAAQ,gBAAgB;IAC9C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,gCAIC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IAGnD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACF;AAPD,0CAOC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACnD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,0CAIC;AAED;;GAEG;AACH,MAAa,WAAY,SAAQ,gBAAgB;IAC/C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,kCAIC","sourcesContent":["/**\n * Base error class for all library errors\n */\nexport class OpenAPIToolError extends Error {\n  public readonly context?: Record<string, any>;\n\n  constructor(message: string, context?: Record<string, any>) {\n    super(message);\n    this.name = this.constructor.name;\n    this.context = context;\n\n    // captureStackTrace is Node.js-specific, guard against non-Node environments\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Error thrown when loading an OpenAPI specification fails\n */\nexport class LoadError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n\n/**\n * Error thrown when parsing an OpenAPI specification fails\n */\nexport class ParseError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n\n/**\n * Error thrown when validating an OpenAPI specification fails\n */\nexport class ValidationError extends OpenAPIToolError {\n  public readonly errors?: any[];\n\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n    this.errors = context?.['errors'];\n  }\n}\n\n/**\n * Error thrown when generating a tool fails\n */\nexport class GenerationError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n\n/**\n * Error thrown when a schema is invalid\n */\nexport class SchemaError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IACzB,OAAO,CAAuB;IAE9C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,6EAA6E;QAC7E,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAbD,4CAaC;AAED;;GAEG;AACH,MAAa,SAAU,SAAQ,gBAAgB;IAC7C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,8BAIC;AAED;;GAEG;AACH,MAAa,UAAW,SAAQ,gBAAgB;IAC9C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,gCAIC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACnC,MAAM,CAAS;IAE/B,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACF;AAPD,0CAOC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACnD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,0CAIC;AAED;;GAEG;AACH,MAAa,WAAY,SAAQ,gBAAgB;IAC/C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,kCAIC","sourcesContent":["/**\n * Base error class for all library errors\n */\nexport class OpenAPIToolError extends Error {\n  public readonly context?: Record<string, any>;\n\n  constructor(message: string, context?: Record<string, any>) {\n    super(message);\n    this.name = this.constructor.name;\n    this.context = context;\n\n    // captureStackTrace is Node.js-specific, guard against non-Node environments\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Error thrown when loading an OpenAPI specification fails\n */\nexport class LoadError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n\n/**\n * Error thrown when parsing an OpenAPI specification fails\n */\nexport class ParseError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n\n/**\n * Error thrown when validating an OpenAPI specification fails\n */\nexport class ValidationError extends OpenAPIToolError {\n  public readonly errors?: any[];\n\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n    this.errors = context?.['errors'];\n  }\n}\n\n/**\n * Error thrown when generating a tool fails\n */\nexport class GenerationError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n\n/**\n * Error thrown when a schema is invalid\n */\nexport class SchemaError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n"]}

package/src/generator.js

@@ -15,6 +15,9 @@ const errors_1 = require("./errors");
  * Main class for generating MCP tools from OpenAPI specifications
  */
 class OpenAPIToolGenerator {
+    document;
+    dereferencedDocument;
+    options;
     /**
      * Private constructor - use static factory methods to create instances
      */
@@ -43,7 +46,10 @@ class OpenAPIToolGenerator {
             });
             clearTimeout(timeout);
             if (!response.ok) {
-                throw new errors_1.LoadError(`Failed to fetch OpenAPI spec from URL: ${response.status} ${response.statusText}`, { url, status: response.status });
+                throw new errors_1.LoadError(`Failed to fetch OpenAPI spec from URL: ${response.status} ${response.statusText}`, {
+                    url,
+                    status: response.status,
+                });
             }
             const contentType = response.headers.get('content-type') || '';
             const text = await response.text();
@@ -186,7 +192,8 @@ class OpenAPIToolGenerator {
                     tools.push(tool);
                 }
                 catch (error) {
-                    console.warn(`Failed to generate tool for ${method.toUpperCase()} ${pathStr}:`, error.message);
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    console.warn(`Failed to generate tool for ${method.toUpperCase()} ${pathStr}:`, errorMessage);
                 }
             }
         }
@@ -262,7 +269,7 @@ class OpenAPIToolGenerator {
             return options.filterFn({
                 ...operation,
                 path,
-                method
+                method,
             });
         }
         return true;
@@ -293,16 +300,19 @@ class OpenAPIToolGenerator {
             path,
             method,
             operationId: operation.operationId,
+            operationSummary: operation.summary,
+            operationDescription: operation.description,
             tags: operation.tags,
             deprecated: operation.deprecated,
         };
         // Extract security requirements
         if (operation.security || document.security) {
-            metadata.security = this.extractSecurityRequirements(operation.security ?? document.security, document);
+            metadata.security = this.extractSecurityRequirements((operation.security ?? document.security), document);
         }
         // Extract servers
-        if (operation.servers || document.servers) {
-            metadata.servers = (operation.servers ?? document.servers).map((server) => ({
+        const servers = operation.servers ?? document.servers;
+        if (servers) {
+            metadata.servers = servers.map((server) => ({
                 url: this.options.baseUrl || server.url,
                 description: server.description,
                 variables: server.variables,
@@ -312,23 +322,27 @@ class OpenAPIToolGenerator {
             metadata.servers = [{ url: this.options.baseUrl }];
         }
         // Extract response status codes (preserve 0 for default responses)
-        if (outputSchema && Array.isArray(outputSchema.oneOf)) {
-            const codes = outputSchema.oneOf
+        const schemaObj = outputSchema;
+        if (schemaObj && Array.isArray(schemaObj['oneOf'])) {
+            const codes = schemaObj['oneOf']
                 .map((schema) => schema['x-status-code'])
                 .filter((code) => code !== undefined && code !== null);
             if (codes.length > 0) {
                 metadata.responseStatusCodes = codes;
             }
         }
-        else if (outputSchema &&
-            outputSchema['x-status-code'] !== undefined &&
-            outputSchema['x-status-code'] !== null) {
-            metadata.responseStatusCodes = [outputSchema['x-status-code']];
+        else if (schemaObj && schemaObj['x-status-code'] !== undefined && schemaObj['x-status-code'] !== null) {
+            metadata.responseStatusCodes = [schemaObj['x-status-code']];
         }
         // External docs
         if (operation.externalDocs) {
             metadata.externalDocs = operation.externalDocs;
         }
+        // FrontMCP extension (x-frontmcp)
+        const operationWithExt = operation;
+        if (operationWithExt['x-frontmcp']) {
+            metadata.frontmcp = operationWithExt['x-frontmcp'];
+        }
         return metadata;
     }
     /**
@@ -350,9 +364,7 @@ class OpenAPIToolGenerator {
                 type: securityScheme.type,
                 scopes,
                 name: 'name' in securityScheme ? securityScheme.name : undefined,
-                in: apiKeyIn && (apiKeyIn === 'query' || apiKeyIn === 'header' || apiKeyIn === 'cookie')
-                    ? apiKeyIn
-                    : undefined,
+                in: apiKeyIn && (apiKeyIn === 'query' || apiKeyIn === 'header' || apiKeyIn === 'cookie') ? apiKeyIn : undefined,
             };
             // Add HTTP-specific metadata
             if (securityScheme.type === 'http') {

package/src/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/generator.ts"],"names":[],"mappings":"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","sourcesContent":["import * as yaml from 'yaml';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\nimport $RefParser from '@apidevtools/json-schema-ref-parser';\nimport type {\n  OpenAPIDocument,\n  LoadOptions,\n  GenerateOptions,\n  McpOpenAPITool,\n  ValidationResult,\n  HTTPMethod,\n  ParameterObject,\n  SecurityRequirement,\n  SecuritySchemeObject,\n  AuthType,\n} from './types';\nimport { isReferenceObject } from './types';\nimport { ParameterResolver } from './parameter-resolver';\nimport { ResponseBuilder } from './response-builder';\nimport { Validator } from './validator';\nimport { LoadError, ParseError } from './errors';\n\n/**\n * Main class for generating MCP tools from OpenAPI specifications\n */\nexport class OpenAPIToolGenerator {\n  private document: OpenAPIDocument;\n  private dereferencedDocument?: OpenAPIDocument;\n  private options: Required<LoadOptions>;\n\n  /**\n   * Private constructor - use static factory methods to create instances\n   */\n  private constructor(document: OpenAPIDocument, options: LoadOptions = {}) {\n    this.document = document;\n    this.options = {\n      dereference: options.dereference ?? true,\n      baseUrl: options.baseUrl ?? '',\n      headers: options.headers ?? {},\n      timeout: options.timeout ?? 30000,\n      validate: options.validate ?? true,\n      followRedirects: options.followRedirects ?? true,\n    };\n  }\n\n  /**\n   * Create generator from a URL\n   */\n  static async fromURL(\n    url: string,\n    options: LoadOptions = {}\n  ): Promise<OpenAPIToolGenerator> {\n    try {\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), options.timeout ?? 30000);\n\n      const response = await fetch(url, {\n        headers: options.headers,\n        signal: controller.signal,\n        redirect: options.followRedirects ?? true ? 'follow' : 'manual',\n      });\n\n      clearTimeout(timeout);\n\n      if (!response.ok) {\n        throw new LoadError(\n          `Failed to fetch OpenAPI spec from URL: ${response.status} ${response.statusText}`,\n          { url, status: response.status }\n        );\n      }\n\n      const contentType = response.headers.get('content-type') || '';\n      const text = await response.text();\n\n      let document: OpenAPIDocument;\n      if (contentType.includes('yaml') || contentType.includes('yml') || url.match(/\\.ya?ml$/i)) {\n        document = yaml.parse(text);\n      } else {\n        document = JSON.parse(text);\n      }\n\n      return new OpenAPIToolGenerator(document, options);\n    } catch (error: unknown) {\n      if (error instanceof LoadError) {\n        throw error;\n      }\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      throw new LoadError(`Failed to load OpenAPI spec from URL: ${errorMessage}`, {\n        url,\n        originalError: error,\n      });\n    }\n  }\n\n  /**\n   * Create generator from a file path\n   */\n  static async fromFile(\n    filePath: string,\n    options: LoadOptions = {}\n  ): Promise<OpenAPIToolGenerator> {\n    try {\n      const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);\n      const content = await fs.readFile(absolutePath, 'utf-8');\n      const ext = path.extname(filePath).toLowerCase();\n\n      let document: OpenAPIDocument;\n      if (ext === '.yaml' || ext === '.yml') {\n        document = yaml.parse(content);\n      } else if (ext === '.json') {\n        document = JSON.parse(content);\n      } else {\n        // Try to parse as JSON first, then YAML\n        try {\n          document = JSON.parse(content);\n        } catch {\n          document = yaml.parse(content);\n        }\n      }\n\n      return new OpenAPIToolGenerator(document, options);\n    } catch (error: unknown) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      throw new LoadError(`Failed to load OpenAPI spec from file: ${errorMessage}`, {\n        filePath,\n        originalError: error,\n      });\n    }\n  }\n\n  /**\n   * Create generator from a YAML string\n   */\n  static async fromYAML(\n    yamlString: string,\n    options: LoadOptions = {}\n  ): Promise<OpenAPIToolGenerator> {\n    try {\n      const document = yaml.parse(yamlString);\n      return new OpenAPIToolGenerator(document, options);\n    } catch (error: unknown) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      throw new ParseError(`Failed to parse YAML: ${errorMessage}`, {\n        originalError: error,\n      });\n    }\n  }\n\n  /**\n   * Create generator from a JSON object\n   */\n  static async fromJSON(\n    json: object,\n    options: LoadOptions = {}\n  ): Promise<OpenAPIToolGenerator> {\n    // Clone to avoid mutations\n    const document = JSON.parse(JSON.stringify(json));\n    return new OpenAPIToolGenerator(document, options);\n  }\n\n  /**\n   * Get the OpenAPI document\n   */\n  getDocument(): OpenAPIDocument {\n    return this.dereferencedDocument ?? this.document;\n  }\n\n  /**\n   * Validate the OpenAPI document\n   */\n  async validate(): Promise<ValidationResult> {\n    const validator = new Validator();\n    return validator.validate(this.document);\n  }\n\n  /**\n   * Initialize the generator (dereference if needed)\n   */\n  private async initialize(): Promise<void> {\n    if (this.options.validate) {\n      const result = await this.validate();\n      if (!result.valid) {\n        throw new ParseError('Invalid OpenAPI document', { errors: result.errors });\n      }\n    }\n\n    if (this.options.dereference && !this.dereferencedDocument) {\n      try {\n        this.dereferencedDocument = (await $RefParser.dereference(\n          JSON.parse(JSON.stringify(this.document))\n        )) as OpenAPIDocument;\n      } catch (error: unknown) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        throw new ParseError(`Failed to dereference OpenAPI document: ${errorMessage}`, {\n          originalError: error,\n        });\n      }\n    }\n  }\n\n  /**\n   * Generate all tools from the OpenAPI specification\n   */\n  async generateTools(options: GenerateOptions = {}): Promise<McpOpenAPITool[]> {\n    await this.initialize();\n\n    const document = this.getDocument();\n    const tools: McpOpenAPITool[] = [];\n\n    if (!document.paths) {\n      return tools;\n    }\n\n    for (const [pathStr, pathItem] of Object.entries(document.paths)) {\n      if (!pathItem || '$ref' in pathItem) continue;\n\n      const methods: HTTPMethod[] = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace'];\n\n      for (const method of methods) {\n        const operation = pathItem[method];\n        if (!operation) continue;\n\n        // Apply filters\n        if (!this.shouldIncludeOperation(operation, pathStr, method, options)) {\n          continue;\n        }\n\n        try {\n          const tool = await this.generateTool(pathStr, method, options);\n          tools.push(tool);\n        } catch (error: any) {\n          console.warn(`Failed to generate tool for ${method.toUpperCase()} ${pathStr}:`, error.message);\n        }\n      }\n    }\n\n    return tools;\n  }\n\n  /**\n   * Generate a specific tool for a path and method\n   */\n  async generateTool(\n    pathStr: string,\n    method: string,\n    options: GenerateOptions = {}\n  ): Promise<McpOpenAPITool> {\n    await this.initialize();\n\n    const document = this.getDocument();\n\n    if (!document.paths) {\n      throw new Error('No paths defined in OpenAPI document');\n    }\n\n    const pathItem = document.paths[pathStr];\n    const operation = pathItem?.[method.toLowerCase() as HTTPMethod];\n\n    if (!operation) {\n      throw new Error(`Operation not found: ${method.toUpperCase()} ${pathStr}`);\n    }\n\n    // Resolve parameters\n    const parameterResolver = new ParameterResolver(options.namingStrategy);\n\n    // Filter out ReferenceObjects from parameters\n    let pathParameters: ParameterObject[] | undefined = undefined;\n    if (pathItem.parameters) {\n      pathParameters = pathItem.parameters.filter(\n        (p): p is ParameterObject => !isReferenceObject(p)\n      ) as ParameterObject[];\n    }\n\n    // Extract security requirements\n    let securityRequirements: SecurityRequirement[] | undefined = undefined;\n    const securitySpec = operation.security ?? document.security;\n    if (securitySpec) {\n      securityRequirements = this.extractSecurityRequirements(\n        securitySpec as Record<string, string[]>[],\n        document\n      );\n    }\n\n    const { inputSchema, mapper } = parameterResolver.resolve(\n      operation,\n      pathParameters,\n      securityRequirements,\n      options.includeSecurityInInput\n    );\n\n    // Build response schema\n    const responseBuilder = new ResponseBuilder(options);\n    const outputSchema = responseBuilder.build(operation.responses);\n\n    // Generate tool name\n    const name = this.generateToolName(pathStr, method as HTTPMethod, operation.operationId, options);\n\n    // Generate description\n    const description = operation.summary || operation.description || `${method.toUpperCase()} ${pathStr}`;\n\n    // Extract metadata\n    const metadata = this.extractMetadata(pathStr, method as HTTPMethod, operation, document, outputSchema);\n\n    return {\n      name,\n      description,\n      inputSchema,\n      outputSchema,\n      mapper,\n      metadata,\n    };\n  }\n\n  /**\n   * Check if an operation should be included\n   */\n  private shouldIncludeOperation(\n    operation: any,\n    path: string,\n    method: string,\n    options: GenerateOptions\n  ): boolean {\n    // Check deprecated\n    if (operation.deprecated && !options.includeDeprecated) {\n      return false;\n    }\n\n    // Check operation ID filters\n    if (options.includeOperations && operation.operationId) {\n      if (!options.includeOperations.includes(operation.operationId)) {\n        return false;\n      }\n    }\n\n    if (options.excludeOperations && operation.operationId) {\n      if (options.excludeOperations.includes(operation.operationId)) {\n        return false;\n      }\n    }\n\n    // Custom filter\n    if (options.filterFn) {\n      return options.filterFn({\n        ...operation,\n        path,\n        method\n      } as any);\n    }\n\n    return true;\n  }\n\n  /**\n   * Generate a tool name\n   */\n  private generateToolName(\n    path: string,\n    method: HTTPMethod,\n    operationId?: string,\n    options: GenerateOptions = {}\n  ): string {\n    if (options.namingStrategy?.toolNameGenerator) {\n      return options.namingStrategy.toolNameGenerator(path, method, operationId);\n    }\n\n    if (operationId) {\n      return operationId;\n    }\n\n    // Generate from path and method\n    const sanitized = path\n      .replace(/\\{([^}]+)\\}/g, 'By_$1')\n      .replace(/[^a-zA-Z0-9_]/g, '_')\n      .replace(/_+/g, '_')\n      .replace(/^_|_$/g, '');\n\n    return `${method}_${sanitized}`;\n  }\n\n  /**\n   * Extract metadata from operation\n   */\n  private extractMetadata(\n    path: string,\n    method: HTTPMethod,\n    operation: any,\n    document: OpenAPIDocument,\n    outputSchema?: any\n  ): any {\n    const metadata: any = {\n      path,\n      method,\n      operationId: operation.operationId,\n      tags: operation.tags,\n      deprecated: operation.deprecated,\n    };\n\n    // Extract security requirements\n    if (operation.security || document.security) {\n      metadata.security = this.extractSecurityRequirements(\n        operation.security ?? document.security,\n        document\n      );\n    }\n\n    // Extract servers\n    if (operation.servers || document.servers) {\n      metadata.servers = (operation.servers ?? document.servers).map((server: any) => ({\n        url: this.options.baseUrl || server.url,\n        description: server.description,\n        variables: server.variables,\n      }));\n    } else if (this.options.baseUrl) {\n      metadata.servers = [{ url: this.options.baseUrl }];\n    }\n\n    // Extract response status codes (preserve 0 for default responses)\n    if (outputSchema && Array.isArray((outputSchema as any).oneOf)) {\n      const codes = (outputSchema as any).oneOf\n        .map((schema: any) => (schema as any)['x-status-code'])\n        .filter((code: unknown) => code !== undefined && code !== null);\n      if (codes.length > 0) {\n        metadata.responseStatusCodes = codes;\n      }\n    } else if (\n      outputSchema &&\n      (outputSchema as any)['x-status-code'] !== undefined &&\n      (outputSchema as any)['x-status-code'] !== null\n    ) {\n      metadata.responseStatusCodes = [(outputSchema as any)['x-status-code']];\n    }\n\n    // External docs\n    if (operation.externalDocs) {\n      metadata.externalDocs = operation.externalDocs;\n    }\n\n    return metadata;\n  }\n\n  /**\n   * Extract security requirements\n   */\n  private extractSecurityRequirements(\n    security: Record<string, string[]>[],\n    document: OpenAPIDocument\n  ): SecurityRequirement[] {\n    if (!security || !document.components?.securitySchemes) {\n      return [];\n    }\n\n    return security.flatMap((req) =>\n      Object.entries(req).map(([scheme, scopes]): SecurityRequirement => {\n        const securityScheme = document.components!.securitySchemes![scheme];\n\n        // Skip if it's a reference object\n        if (isReferenceObject(securityScheme)) {\n          return { scheme, type: 'http', scopes };\n        }\n\n        const apiKeyIn = 'in' in securityScheme ? securityScheme.in : undefined;\n        const result: SecurityRequirement = {\n          scheme,\n          type: securityScheme.type as AuthType,\n          scopes,\n          name: 'name' in securityScheme ? securityScheme.name : undefined,\n          in: apiKeyIn && (apiKeyIn === 'query' || apiKeyIn === 'header' || apiKeyIn === 'cookie')\n            ? apiKeyIn\n            : undefined,\n        };\n\n        // Add HTTP-specific metadata\n        if (securityScheme.type === 'http') {\n          result.httpScheme = 'scheme' in securityScheme ? securityScheme.scheme : undefined;\n          result.bearerFormat = 'bearerFormat' in securityScheme ? securityScheme.bearerFormat : undefined;\n        }\n\n        // Add description if available\n        result.description = 'description' in securityScheme ? securityScheme.description : undefined;\n\n        return result;\n      })\n    );\n  }\n}\n"]}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/generator.ts"],"names":[],"mappings":";;;;AAAA,mDAA6B;AAC7B,wDAAkC;AAClC,mDAA6B;AAC7B,yGAA6D;AAgB7D,mCAA4C;AAC5C,6DAAyD;AACzD,yDAAqD;AACrD,2CAAwC;AACxC,qCAAiD;AAEjD;;GAEG;AACH,MAAa,oBAAoB;IACvB,QAAQ,CAAkB;IAC1B,oBAAoB,CAAmB;IACvC,OAAO,CAAwB;IAEvC;;OAEG;IACH,YAAoB,QAAyB,EAAE,UAAuB,EAAE;QACtE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG;YACb,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;YACxC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;YACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;SACjD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,UAAuB,EAAE;QACzD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;YAE/E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,QAAQ,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;aAChE,CAAC,CAAC;YAEH,YAAY,CAAC,OAAO,CAAC,CAAC;YAEtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,kBAAS,CAAC,0CAA0C,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAAE;oBACtG,GAAG;oBACH,MAAM,EAAE,QAAQ,CAAC,MAAM;iBACxB,CAAC,CAAC;YACL,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEnC,IAAI,QAAyB,CAAC;YAC9B,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1F,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;YAED,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,kBAAS,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,IAAI,kBAAS,CAAC,yCAAyC,YAAY,EAAE,EAAE;gBAC3E,GAAG;gBACH,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,UAAuB,EAAE;QAC/D,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;YAClG,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YAEjD,IAAI,QAAyB,CAAC;YAC9B,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACtC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;gBAC3B,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,wCAAwC;gBACxC,IAAI,CAAC;oBACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACjC,CAAC;gBAAC,MAAM,CAAC;oBACP,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,IAAI,kBAAS,CAAC,0CAA0C,YAAY,EAAE,EAAE;gBAC5E,QAAQ;gBACR,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAkB,EAAE,UAAuB,EAAE;QACjE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACxC,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,IAAI,mBAAU,CAAC,yBAAyB,YAAY,EAAE,EAAE;gBAC5D,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,UAAuB,EAAE;QAC3D,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,QAAQ,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,SAAS,GAAG,IAAI,qBAAS,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,UAAU;QACtB,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,IAAI,mBAAU,CAAC,0BAA0B,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC3D,IAAI,CAAC;gBACH,IAAI,CAAC,oBAAoB,GAAG,CAAC,MAAM,gCAAU,CAAC,WAAW,CACvD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAC1C,CAAoB,CAAC;YACxB,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5E,MAAM,IAAI,mBAAU,CAAC,2CAA2C,YAAY,EAAE,EAAE;oBAC9E,aAAa,EAAE,KAAK;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,UAA2B,EAAE;QAC/C,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,KAAK,GAAqB,EAAE,CAAC;QAEnC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,QAAQ,IAAI,MAAM,IAAI,QAAQ;gBAAE,SAAS;YAE9C,MAAM,OAAO,GAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAEpG,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACnC,IAAI,CAAC,SAAS;oBAAE,SAAS;gBAEzB,gBAAgB;gBAChB,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;oBACtE,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;oBAC/D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC5E,OAAO,CAAC,IAAI,CAAC,+BAA+B,MAAM,CAAC,WAAW,EAAE,IAAI,OAAO,GAAG,EAAE,YAAY,CAAC,CAAC;gBAChG,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,MAAc,EAAE,UAA2B,EAAE;QAC/E,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAEpC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC,MAAM,CAAC,WAAW,EAAgB,CAAC,CAAC;QAEjE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,qBAAqB;QACrB,MAAM,iBAAiB,GAAG,IAAI,sCAAiB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAExE,8CAA8C;QAC9C,IAAI,cAAc,GAAkC,SAAS,CAAC;QAC9D,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,cAAc,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CACzC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,IAAA,yBAAiB,EAAC,CAAC,CAAC,CAC9B,CAAC;QACzB,CAAC;QAED,gCAAgC;QAChC,IAAI,oBAAoB,GAAsC,SAAS,CAAC;QACxE,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;QAC7D,IAAI,YAAY,EAAE,CAAC;YACjB,oBAAoB,GAAG,IAAI,CAAC,2BAA2B,CAAC,YAA0C,EAAE,QAAQ,CAAC,CAAC;QAChH,CAAC;QAED,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,OAAO,CACvD,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,OAAO,CAAC,sBAAsB,CAC/B,CAAC;QAEF,wBAAwB;QACxB,MAAM,eAAe,GAAG,IAAI,kCAAe,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAEhE,qBAAqB;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAoB,EAAE,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAElG,uBAAuB;QACvB,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,WAAW,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC;QAEvG,mBAAmB;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,MAAoB,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QAExG,OAAO;YACL,IAAI;YACJ,WAAW;YACX,WAAW;YACX,YAAY;YACZ,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,sBAAsB,CAC5B,SAA0B,EAC1B,IAAY,EACZ,MAAc,EACd,OAAwB;QAExB,mBAAmB;QACnB,IAAI,SAAS,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,6BAA6B;QAC7B,IAAI,OAAO,CAAC,iBAAiB,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;YACvD,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/D,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,iBAAiB,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;YACvD,IAAI,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC9D,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,gBAAgB;QAChB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,OAAO,CAAC,QAAQ,CAAC;gBACtB,GAAG,SAAS;gBACZ,IAAI;gBACJ,MAAM;aACiB,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,IAAY,EACZ,MAAkB,EAClB,WAAoB,EACpB,UAA2B,EAAE;QAE7B,IAAI,OAAO,CAAC,cAAc,EAAE,iBAAiB,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,gCAAgC;QAChC,MAAM,SAAS,GAAG,IAAI;aACnB,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC;aAChC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;aAC9B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAEzB,OAAO,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,IAAY,EACZ,MAAkB,EAClB,SAA0B,EAC1B,QAAyB,EACzB,YAAsB;QAEtB,MAAM,QAAQ,GAAiB;YAC7B,IAAI;YACJ,MAAM;YACN,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,gBAAgB,EAAE,SAAS,CAAC,OAAO;YACnC,oBAAoB,EAAE,SAAS,CAAC,WAAW;YAC3C,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,UAAU,EAAE,SAAS,CAAC,UAAU;SACjC,CAAC;QAEF,gCAAgC;QAChC,IAAI,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5C,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,2BAA2B,CAClD,CAAC,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAA+B,EACvE,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,kBAAkB;QAClB,MAAM,OAAO,GAAI,SAA0C,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC;QACxF,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAoB,EAAE,EAAE,CAAC,CAAC;gBACxD,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG;gBACvC,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC,CAAC;QACN,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAChC,QAAQ,CAAC,OAAO,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,mEAAmE;QACnE,MAAM,SAAS,GAAG,YAAmD,CAAC;QACtE,IAAI,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACnD,MAAM,KAAK,GAAI,SAAS,CAAC,OAAO,CAA+B;iBAC5D,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;iBACxC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;YACzE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,mBAAmB,GAAG,KAAK,CAAC;YACvC,CAAC;QACH,CAAC;aAAM,IAAI,SAAS,IAAI,SAAS,CAAC,eAAe,CAAC,KAAK,SAAS,IAAI,SAAS,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE,CAAC;YACxG,QAAQ,CAAC,mBAAmB,GAAG,CAAC,SAAS,CAAC,eAAe,CAAW,CAAC,CAAC;QACxE,CAAC;QAED,gBAAgB;QAChB,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;YAC3B,QAAQ,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC;QACjD,CAAC;QAED,kCAAkC;QAClC,MAAM,gBAAgB,GAAG,SAAoC,CAAC;QAC9D,IAAI,gBAAgB,CAAC,YAAY,CAAC,EAAE,CAAC;YACnC,QAAQ,CAAC,QAAQ,GAAG,gBAAgB,CAAC,YAAY,CAA6B,CAAC;QACjF,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,2BAA2B,CACjC,QAAoC,EACpC,QAAyB;QAEzB,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,eAAe,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAC9B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAuB,EAAE;YAChE,MAAM,cAAc,GAAG,QAAQ,CAAC,UAAW,CAAC,eAAgB,CAAC,MAAM,CAAC,CAAC;YAErE,kCAAkC;YAClC,IAAI,IAAA,yBAAiB,EAAC,cAAc,CAAC,EAAE,CAAC;gBACtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC1C,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YACxE,MAAM,MAAM,GAAwB;gBAClC,MAAM;gBACN,IAAI,EAAE,cAAc,CAAC,IAAgB;gBACrC,MAAM;gBACN,IAAI,EAAE,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBAChE,EAAE,EACA,QAAQ,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;aAC9G,CAAC;YAEF,6BAA6B;YAC7B,IAAI,cAAc,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACnC,MAAM,CAAC,UAAU,GAAG,QAAQ,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;gBACnF,MAAM,CAAC,YAAY,GAAG,cAAc,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;YACnG,CAAC;YAED,+BAA+B;YAC/B,MAAM,CAAC,WAAW,GAAG,aAAa,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;YAE9F,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF;AA9bD,oDA8bC","sourcesContent":["import * as yaml from 'yaml';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\nimport $RefParser from '@apidevtools/json-schema-ref-parser';\nimport type {\n  OpenAPIDocument,\n  LoadOptions,\n  GenerateOptions,\n  McpOpenAPITool,\n  ValidationResult,\n  HTTPMethod,\n  ParameterObject,\n  SecurityRequirement,\n  AuthType,\n  OperationObject,\n  OperationWithContext,\n  ToolMetadata,\n  ServerObject,\n} from './types';\nimport { isReferenceObject } from './types';\nimport { ParameterResolver } from './parameter-resolver';\nimport { ResponseBuilder } from './response-builder';\nimport { Validator } from './validator';\nimport { LoadError, ParseError } from './errors';\n\n/**\n * Main class for generating MCP tools from OpenAPI specifications\n */\nexport class OpenAPIToolGenerator {\n  private document: OpenAPIDocument;\n  private dereferencedDocument?: OpenAPIDocument;\n  private options: Required<LoadOptions>;\n\n  /**\n   * Private constructor - use static factory methods to create instances\n   */\n  private constructor(document: OpenAPIDocument, options: LoadOptions = {}) {\n    this.document = document;\n    this.options = {\n      dereference: options.dereference ?? true,\n      baseUrl: options.baseUrl ?? '',\n      headers: options.headers ?? {},\n      timeout: options.timeout ?? 30000,\n      validate: options.validate ?? true,\n      followRedirects: options.followRedirects ?? true,\n    };\n  }\n\n  /**\n   * Create generator from a URL\n   */\n  static async fromURL(url: string, options: LoadOptions = {}): Promise<OpenAPIToolGenerator> {\n    try {\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), options.timeout ?? 30000);\n\n      const response = await fetch(url, {\n        headers: options.headers,\n        signal: controller.signal,\n        redirect: options.followRedirects ?? true ? 'follow' : 'manual',\n      });\n\n      clearTimeout(timeout);\n\n      if (!response.ok) {\n        throw new LoadError(`Failed to fetch OpenAPI spec from URL: ${response.status} ${response.statusText}`, {\n          url,\n          status: response.status,\n        });\n      }\n\n      const contentType = response.headers.get('content-type') || '';\n      const text = await response.text();\n\n      let document: OpenAPIDocument;\n      if (contentType.includes('yaml') || contentType.includes('yml') || url.match(/\\.ya?ml$/i)) {\n        document = yaml.parse(text);\n      } else {\n        document = JSON.parse(text);\n      }\n\n      return new OpenAPIToolGenerator(document, options);\n    } catch (error: unknown) {\n      if (error instanceof LoadError) {\n        throw error;\n      }\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      throw new LoadError(`Failed to load OpenAPI spec from URL: ${errorMessage}`, {\n        url,\n        originalError: error,\n      });\n    }\n  }\n\n  /**\n   * Create generator from a file path\n   */\n  static async fromFile(filePath: string, options: LoadOptions = {}): Promise<OpenAPIToolGenerator> {\n    try {\n      const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);\n      const content = await fs.readFile(absolutePath, 'utf-8');\n      const ext = path.extname(filePath).toLowerCase();\n\n      let document: OpenAPIDocument;\n      if (ext === '.yaml' || ext === '.yml') {\n        document = yaml.parse(content);\n      } else if (ext === '.json') {\n        document = JSON.parse(content);\n      } else {\n        // Try to parse as JSON first, then YAML\n        try {\n          document = JSON.parse(content);\n        } catch {\n          document = yaml.parse(content);\n        }\n      }\n\n      return new OpenAPIToolGenerator(document, options);\n    } catch (error: unknown) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      throw new LoadError(`Failed to load OpenAPI spec from file: ${errorMessage}`, {\n        filePath,\n        originalError: error,\n      });\n    }\n  }\n\n  /**\n   * Create generator from a YAML string\n   */\n  static async fromYAML(yamlString: string, options: LoadOptions = {}): Promise<OpenAPIToolGenerator> {\n    try {\n      const document = yaml.parse(yamlString);\n      return new OpenAPIToolGenerator(document, options);\n    } catch (error: unknown) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      throw new ParseError(`Failed to parse YAML: ${errorMessage}`, {\n        originalError: error,\n      });\n    }\n  }\n\n  /**\n   * Create generator from a JSON object\n   */\n  static async fromJSON(json: object, options: LoadOptions = {}): Promise<OpenAPIToolGenerator> {\n    // Clone to avoid mutations\n    const document = JSON.parse(JSON.stringify(json));\n    return new OpenAPIToolGenerator(document, options);\n  }\n\n  /**\n   * Get the OpenAPI document\n   */\n  getDocument(): OpenAPIDocument {\n    return this.dereferencedDocument ?? this.document;\n  }\n\n  /**\n   * Validate the OpenAPI document\n   */\n  async validate(): Promise<ValidationResult> {\n    const validator = new Validator();\n    return validator.validate(this.document);\n  }\n\n  /**\n   * Initialize the generator (dereference if needed)\n   */\n  private async initialize(): Promise<void> {\n    if (this.options.validate) {\n      const result = await this.validate();\n      if (!result.valid) {\n        throw new ParseError('Invalid OpenAPI document', { errors: result.errors });\n      }\n    }\n\n    if (this.options.dereference && !this.dereferencedDocument) {\n      try {\n        this.dereferencedDocument = (await $RefParser.dereference(\n          JSON.parse(JSON.stringify(this.document)),\n        )) as OpenAPIDocument;\n      } catch (error: unknown) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        throw new ParseError(`Failed to dereference OpenAPI document: ${errorMessage}`, {\n          originalError: error,\n        });\n      }\n    }\n  }\n\n  /**\n   * Generate all tools from the OpenAPI specification\n   */\n  async generateTools(options: GenerateOptions = {}): Promise<McpOpenAPITool[]> {\n    await this.initialize();\n\n    const document = this.getDocument();\n    const tools: McpOpenAPITool[] = [];\n\n    if (!document.paths) {\n      return tools;\n    }\n\n    for (const [pathStr, pathItem] of Object.entries(document.paths)) {\n      if (!pathItem || '$ref' in pathItem) continue;\n\n      const methods: HTTPMethod[] = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace'];\n\n      for (const method of methods) {\n        const operation = pathItem[method];\n        if (!operation) continue;\n\n        // Apply filters\n        if (!this.shouldIncludeOperation(operation, pathStr, method, options)) {\n          continue;\n        }\n\n        try {\n          const tool = await this.generateTool(pathStr, method, options);\n          tools.push(tool);\n        } catch (error: unknown) {\n          const errorMessage = error instanceof Error ? error.message : String(error);\n          console.warn(`Failed to generate tool for ${method.toUpperCase()} ${pathStr}:`, errorMessage);\n        }\n      }\n    }\n\n    return tools;\n  }\n\n  /**\n   * Generate a specific tool for a path and method\n   */\n  async generateTool(pathStr: string, method: string, options: GenerateOptions = {}): Promise<McpOpenAPITool> {\n    await this.initialize();\n\n    const document = this.getDocument();\n\n    if (!document.paths) {\n      throw new Error('No paths defined in OpenAPI document');\n    }\n\n    const pathItem = document.paths[pathStr];\n    const operation = pathItem?.[method.toLowerCase() as HTTPMethod];\n\n    if (!operation) {\n      throw new Error(`Operation not found: ${method.toUpperCase()} ${pathStr}`);\n    }\n\n    // Resolve parameters\n    const parameterResolver = new ParameterResolver(options.namingStrategy);\n\n    // Filter out ReferenceObjects from parameters\n    let pathParameters: ParameterObject[] | undefined = undefined;\n    if (pathItem.parameters) {\n      pathParameters = pathItem.parameters.filter(\n        (p): p is ParameterObject => !isReferenceObject(p),\n      ) as ParameterObject[];\n    }\n\n    // Extract security requirements\n    let securityRequirements: SecurityRequirement[] | undefined = undefined;\n    const securitySpec = operation.security ?? document.security;\n    if (securitySpec) {\n      securityRequirements = this.extractSecurityRequirements(securitySpec as Record<string, string[]>[], document);\n    }\n\n    const { inputSchema, mapper } = parameterResolver.resolve(\n      operation,\n      pathParameters,\n      securityRequirements,\n      options.includeSecurityInInput,\n    );\n\n    // Build response schema\n    const responseBuilder = new ResponseBuilder(options);\n    const outputSchema = responseBuilder.build(operation.responses);\n\n    // Generate tool name\n    const name = this.generateToolName(pathStr, method as HTTPMethod, operation.operationId, options);\n\n    // Generate description\n    const description = operation.summary || operation.description || `${method.toUpperCase()} ${pathStr}`;\n\n    // Extract metadata\n    const metadata = this.extractMetadata(pathStr, method as HTTPMethod, operation, document, outputSchema);\n\n    return {\n      name,\n      description,\n      inputSchema,\n      outputSchema,\n      mapper,\n      metadata,\n    };\n  }\n\n  /**\n   * Check if an operation should be included\n   */\n  private shouldIncludeOperation(\n    operation: OperationObject,\n    path: string,\n    method: string,\n    options: GenerateOptions,\n  ): boolean {\n    // Check deprecated\n    if (operation.deprecated && !options.includeDeprecated) {\n      return false;\n    }\n\n    // Check operation ID filters\n    if (options.includeOperations && operation.operationId) {\n      if (!options.includeOperations.includes(operation.operationId)) {\n        return false;\n      }\n    }\n\n    if (options.excludeOperations && operation.operationId) {\n      if (options.excludeOperations.includes(operation.operationId)) {\n        return false;\n      }\n    }\n\n    // Custom filter\n    if (options.filterFn) {\n      return options.filterFn({\n        ...operation,\n        path,\n        method,\n      } as OperationWithContext);\n    }\n\n    return true;\n  }\n\n  /**\n   * Generate a tool name\n   */\n  private generateToolName(\n    path: string,\n    method: HTTPMethod,\n    operationId?: string,\n    options: GenerateOptions = {},\n  ): string {\n    if (options.namingStrategy?.toolNameGenerator) {\n      return options.namingStrategy.toolNameGenerator(path, method, operationId);\n    }\n\n    if (operationId) {\n      return operationId;\n    }\n\n    // Generate from path and method\n    const sanitized = path\n      .replace(/\\{([^}]+)\\}/g, 'By_$1')\n      .replace(/[^a-zA-Z0-9_]/g, '_')\n      .replace(/_+/g, '_')\n      .replace(/^_|_$/g, '');\n\n    return `${method}_${sanitized}`;\n  }\n\n  /**\n   * Extract metadata from operation\n   */\n  private extractMetadata(\n    path: string,\n    method: HTTPMethod,\n    operation: OperationObject,\n    document: OpenAPIDocument,\n    outputSchema?: unknown,\n  ): ToolMetadata {\n    const metadata: ToolMetadata = {\n      path,\n      method,\n      operationId: operation.operationId,\n      operationSummary: operation.summary,\n      operationDescription: operation.description,\n      tags: operation.tags,\n      deprecated: operation.deprecated,\n    };\n\n    // Extract security requirements\n    if (operation.security || document.security) {\n      metadata.security = this.extractSecurityRequirements(\n        (operation.security ?? document.security) as Record<string, string[]>[],\n        document,\n      );\n    }\n\n    // Extract servers\n    const servers = (operation as { servers?: ServerObject[] }).servers ?? document.servers;\n    if (servers) {\n      metadata.servers = servers.map((server: ServerObject) => ({\n        url: this.options.baseUrl || server.url,\n        description: server.description,\n        variables: server.variables,\n      }));\n    } else if (this.options.baseUrl) {\n      metadata.servers = [{ url: this.options.baseUrl }];\n    }\n\n    // Extract response status codes (preserve 0 for default responses)\n    const schemaObj = outputSchema as Record<string, unknown> | undefined;\n    if (schemaObj && Array.isArray(schemaObj['oneOf'])) {\n      const codes = (schemaObj['oneOf'] as Record<string, unknown>[])\n        .map((schema) => schema['x-status-code'])\n        .filter((code): code is number => code !== undefined && code !== null);\n      if (codes.length > 0) {\n        metadata.responseStatusCodes = codes;\n      }\n    } else if (schemaObj && schemaObj['x-status-code'] !== undefined && schemaObj['x-status-code'] !== null) {\n      metadata.responseStatusCodes = [schemaObj['x-status-code'] as number];\n    }\n\n    // External docs\n    if (operation.externalDocs) {\n      metadata.externalDocs = operation.externalDocs;\n    }\n\n    // FrontMCP extension (x-frontmcp)\n    const operationWithExt = operation as Record<string, unknown>;\n    if (operationWithExt['x-frontmcp']) {\n      metadata.frontmcp = operationWithExt['x-frontmcp'] as ToolMetadata['frontmcp'];\n    }\n\n    return metadata;\n  }\n\n  /**\n   * Extract security requirements\n   */\n  private extractSecurityRequirements(\n    security: Record<string, string[]>[],\n    document: OpenAPIDocument,\n  ): SecurityRequirement[] {\n    if (!security || !document.components?.securitySchemes) {\n      return [];\n    }\n\n    return security.flatMap((req) =>\n      Object.entries(req).map(([scheme, scopes]): SecurityRequirement => {\n        const securityScheme = document.components!.securitySchemes![scheme];\n\n        // Skip if it's a reference object\n        if (isReferenceObject(securityScheme)) {\n          return { scheme, type: 'http', scopes };\n        }\n\n        const apiKeyIn = 'in' in securityScheme ? securityScheme.in : undefined;\n        const result: SecurityRequirement = {\n          scheme,\n          type: securityScheme.type as AuthType,\n          scopes,\n          name: 'name' in securityScheme ? securityScheme.name : undefined,\n          in:\n            apiKeyIn && (apiKeyIn === 'query' || apiKeyIn === 'header' || apiKeyIn === 'cookie') ? apiKeyIn : undefined,\n        };\n\n        // Add HTTP-specific metadata\n        if (securityScheme.type === 'http') {\n          result.httpScheme = 'scheme' in securityScheme ? securityScheme.scheme : undefined;\n          result.bearerFormat = 'bearerFormat' in securityScheme ? securityScheme.bearerFormat : undefined;\n        }\n\n        // Add description if available\n        result.description = 'description' in securityScheme ? securityScheme.description : undefined;\n\n        return result;\n      }),\n    );\n  }\n}\n"]}

package/src/index.d.ts

@@ -4,7 +4,7 @@ export { ParameterResolver } from './parameter-resolver';
 export { ResponseBuilder } from './response-builder';
 export { Validator } from './validator';
 export { SecurityResolver, createSecurityContext } from './security-resolver';
-export { OpenAPIToolError, LoadError, ParseError, ValidationError, GenerationError, SchemaError, } from './errors';
-export type { McpOpenAPITool, ParameterMapper, ToolMetadata, SerializationInfo, SecurityRequirement, SecurityParameterInfo, ServerInfo, 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 { OpenAPIToolError, LoadError, ParseError, ValidationError, GenerationError, SchemaError } from './errors';
+export type { McpOpenAPITool, ParameterMapper, ToolMetadata, FrontMcpExtensionData, SerializationInfo, SecurityRequirement, SecurityParameterInfo, ServerInfo, 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 { SecurityContext, ResolvedSecurity, DigestAuthCredentials, ClientCertificate, AWSCredentials, SignatureData, } from './security-resolver';
-export { isReferenceObject, toJSONSchema7 } from './types';
+export { isReferenceObject, toJsonSchema } from './types';

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toJSONSchema7 = exports.isReferenceObject = exports.SchemaError = exports.GenerationError = exports.ValidationError = exports.ParseError = exports.LoadError = exports.OpenAPIToolError = exports.createSecurityContext = exports.SecurityResolver = exports.Validator = exports.ResponseBuilder = exports.ParameterResolver = exports.SchemaBuilder = exports.OpenAPIToolGenerator = void 0;
+exports.toJsonSchema = exports.isReferenceObject = exports.SchemaError = exports.GenerationError = exports.ValidationError = exports.ParseError = exports.LoadError = exports.OpenAPIToolError = exports.createSecurityContext = exports.SecurityResolver = exports.Validator = exports.ResponseBuilder = exports.ParameterResolver = exports.SchemaBuilder = exports.OpenAPIToolGenerator = void 0;
 // Main exports
 var generator_1 = require("./generator");
 Object.defineProperty(exports, "OpenAPIToolGenerator", { enumerable: true, get: function () { return generator_1.OpenAPIToolGenerator; } });
@@ -26,5 +26,5 @@ Object.defineProperty(exports, "SchemaError", { enumerable: true, get: function
 // Utility exports
 var types_1 = require("./types");
 Object.defineProperty(exports, "isReferenceObject", { enumerable: true, get: function () { return types_1.isReferenceObject; } });
-Object.defineProperty(exports, "toJSONSchema7", { enumerable: true, get: function () { return types_1.toJSONSchema7; } });
+Object.defineProperty(exports, "toJsonSchema", { enumerable: true, get: function () { return types_1.toJsonSchema; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,eAAe;AACf,yCAAmD;AAA1C,iHAAA,oBAAoB,OAAA;AAC7B,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,yDAA8E;AAArE,qHAAA,gBAAgB,OAAA;AAAE,0HAAA,qBAAqB,OAAA;AAEhD,gBAAgB;AAChB,mCAOkB;AANhB,0GAAA,gBAAgB,OAAA;AAChB,mGAAA,SAAS,OAAA;AACT,oGAAA,UAAU,OAAA;AACV,yGAAA,eAAe,OAAA;AACf,yGAAA,eAAe,OAAA;AACf,qGAAA,WAAW,OAAA;AAgEb,kBAAkB;AAClB,iCAA2D;AAAlD,0GAAA,iBAAiB,OAAA;AAAE,sGAAA,aAAa,OAAA","sourcesContent":["// Main exports\nexport { OpenAPIToolGenerator } from './generator';\nexport { SchemaBuilder } from './schema-builder';\nexport { ParameterResolver } from './parameter-resolver';\nexport { ResponseBuilder } from './response-builder';\nexport { Validator } from './validator';\nexport { SecurityResolver, createSecurityContext } from './security-resolver';\n\n// Error exports\nexport {\n  OpenAPIToolError,\n  LoadError,\n  ParseError,\n  ValidationError,\n  GenerationError,\n  SchemaError,\n} from './errors';\n\n// Type exports\nexport type {\n  // Main MCP types\n  McpOpenAPITool,\n  ParameterMapper,\n  ToolMetadata,\n  SerializationInfo,\n  SecurityRequirement,\n  SecurityParameterInfo,\n  ServerInfo,\n\n  // Configuration types\n  LoadOptions,\n  GenerateOptions,\n  NamingStrategy,\n  OperationWithContext,\n\n  // Basic types\n  OpenAPIDocument,\n  OpenAPIVersion,\n  HTTPMethod,\n  ParameterLocation,\n  AuthType,\n\n  // Re-exported OpenAPI types (from openapi-types package)\n  OperationObject,\n  ParameterObject,\n  RequestBodyObject,\n  ResponseObject,\n  ResponsesObject,\n  MediaTypeObject,\n  HeaderObject,\n  ExampleObject,\n  PathItemObject,\n  PathsObject,\n  ServerObject,\n  SecuritySchemeObject,\n  ReferenceObject,\n  TagObject,\n  ExternalDocumentationObject,\n  ServerVariableObject,\n  EncodingObject,\n  SecurityRequirementObject,\n  SchemaObject,\n\n  // Validation types\n  ValidationResult,\n  ValidationErrorDetail,\n  ValidationWarning,\n} from './types';\n\n// Security resolver types\nexport type {\n  SecurityContext,\n  ResolvedSecurity,\n  DigestAuthCredentials,\n  ClientCertificate,\n  AWSCredentials,\n  SignatureData,\n} from './security-resolver';\n\n// Utility exports\nexport { isReferenceObject, toJSONSchema7 } from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,eAAe;AACf,yCAAmD;AAA1C,iHAAA,oBAAoB,OAAA;AAC7B,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,yDAA8E;AAArE,qHAAA,gBAAgB,OAAA;AAAE,0HAAA,qBAAqB,OAAA;AAEhD,gBAAgB;AAChB,mCAAkH;AAAzG,0GAAA,gBAAgB,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,qGAAA,WAAW,OAAA;AAgE/F,kBAAkB;AAClB,iCAA0D;AAAjD,0GAAA,iBAAiB,OAAA;AAAE,qGAAA,YAAY,OAAA","sourcesContent":["// Main exports\nexport { OpenAPIToolGenerator } from './generator';\nexport { SchemaBuilder } from './schema-builder';\nexport { ParameterResolver } from './parameter-resolver';\nexport { ResponseBuilder } from './response-builder';\nexport { Validator } from './validator';\nexport { SecurityResolver, createSecurityContext } from './security-resolver';\n\n// Error exports\nexport { OpenAPIToolError, LoadError, ParseError, ValidationError, GenerationError, SchemaError } from './errors';\n\n// Type exports\nexport type {\n  // Main MCP types\n  McpOpenAPITool,\n  ParameterMapper,\n  ToolMetadata,\n  FrontMcpExtensionData,\n  SerializationInfo,\n  SecurityRequirement,\n  SecurityParameterInfo,\n  ServerInfo,\n\n  // Configuration types\n  LoadOptions,\n  GenerateOptions,\n  NamingStrategy,\n  OperationWithContext,\n\n  // Basic types\n  OpenAPIDocument,\n  OpenAPIVersion,\n  HTTPMethod,\n  ParameterLocation,\n  AuthType,\n\n  // Re-exported OpenAPI types (from openapi-types package)\n  OperationObject,\n  ParameterObject,\n  RequestBodyObject,\n  ResponseObject,\n  ResponsesObject,\n  MediaTypeObject,\n  HeaderObject,\n  ExampleObject,\n  PathItemObject,\n  PathsObject,\n  ServerObject,\n  SecuritySchemeObject,\n  ReferenceObject,\n  TagObject,\n  ExternalDocumentationObject,\n  ServerVariableObject,\n  EncodingObject,\n  SecurityRequirementObject,\n  SchemaObject,\n\n  // Validation types\n  ValidationResult,\n  ValidationErrorDetail,\n  ValidationWarning,\n} from './types';\n\n// Security resolver types\nexport type {\n  SecurityContext,\n  ResolvedSecurity,\n  DigestAuthCredentials,\n  ClientCertificate,\n  AWSCredentials,\n  SignatureData,\n} from './security-resolver';\n\n// Utility exports\nexport { isReferenceObject, toJsonSchema } from './types';\n"]}

package/src/parameter-resolver.d.ts

@@ -1,4 +1,6 @@
-import type { JSONSchema7 } from 'json-schema';
+import type { JSONSchema } from 'zod/v4/core';
+/** JSON Schema type from Zod v4 */
+type JsonSchema = JSONSchema.JSONSchema;
 import type { ParameterMapper, ParameterObject, NamingStrategy, SecurityRequirement } from './types';
 /**
  * Resolves parameters and handles naming conflicts
@@ -14,7 +16,7 @@ export declare class ParameterResolver {
      * Resolve all parameters for an operation
      */
     resolve(operation: any, pathParameters?: ParameterObject[], securityRequirements?: SecurityRequirement[], includeSecurityInInput?: boolean): {
-        inputSchema: JSONSchema7;
+        inputSchema: JsonSchema;
         mapper: ParameterMapper[];
     };
     /**
@@ -34,3 +36,4 @@ export declare class ParameterResolver {
      */
     private processSecurityRequirements;
 }
+export {};

package/src/parameter-resolver.js

@@ -6,6 +6,7 @@ const types_1 = require("./types");
  * Resolves parameters and handles naming conflicts
  */
 class ParameterResolver {
+    namingStrategy;
     constructor(namingStrategy) {
         this.namingStrategy = namingStrategy ?? {
             conflictResolver: this.defaultConflictResolver,
@@ -28,10 +29,7 @@ class ParameterResolver {
      * Resolve all parameters for an operation
      */
     resolve(operation, pathParameters, securityRequirements, includeSecurityInInput) {
-        const allParameters = [
-            ...(pathParameters ?? []),
-            ...(operation.parameters ?? []),
-        ];
+        const allParameters = [...(pathParameters ?? []), ...(operation.parameters ?? [])];
         const requestBody = operation.requestBody;
         // Collect all parameter names and detect conflicts
         const parametersByName = new Map();
@@ -40,7 +38,7 @@ class ParameterResolver {
             const info = {
                 name: param.name,
                 location: param.in,
-                required: param.required ?? (param.in === 'path'),
+                required: param.required ?? param.in === 'path',
                 schema: param.schema ?? { type: 'string' },
                 description: param.description,
                 style: param.style,
@@ -122,8 +120,8 @@ class ParameterResolver {
     extractBodyParameters(schema, parametersByName, required, contentType, prefix = '') {
         if (!schema || typeof schema !== 'object')
             return;
-        // Convert to JSONSchema7 for processing
-        const jsonSchema = (0, types_1.toJSONSchema7)(schema);
+        // Convert to JsonSchema for processing
+        const jsonSchema = (0, types_1.toJsonSchema)(schema);
         // Handle object schemas
         if (jsonSchema.type === 'object' && jsonSchema.properties) {
             const requiredFields = new Set(jsonSchema.required ?? []);
@@ -170,7 +168,7 @@ class ParameterResolver {
      * Build JSON Schema for a parameter
      */
     buildParameterSchema(param) {
-        const schema = (0, types_1.toJSONSchema7)(param.schema);
+        const schema = (0, types_1.toJsonSchema)(param.schema);
         if (param.description) {
             schema.description = param.description;
         }

package/src/parameter-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"parameter-resolver.js","sourceRoot":"","sources":["../../src/parameter-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema7 } from 'json-schema';\nimport type {\n  ParameterMapper,\n  ParameterObject,\n  RequestBodyObject,\n  NamingStrategy,\n  ParameterLocation,\n  SchemaObject,\n  ReferenceObject,\n  SecurityRequirement,\n  SecurityParameterInfo,\n  SecuritySchemeObject,\n} from './types';\nimport { toJSONSchema7, isReferenceObject } from './types';\n\n/**\n * Resolves parameters and handles naming conflicts\n */\nexport class ParameterResolver {\n  private namingStrategy: NamingStrategy;\n\n  constructor(namingStrategy?: NamingStrategy) {\n    this.namingStrategy = namingStrategy ?? {\n      conflictResolver: this.defaultConflictResolver,\n    };\n  }\n\n  /**\n   * Default conflict resolver: prefix with location\n   */\n  private defaultConflictResolver(\n    paramName: string,\n    location: ParameterLocation,\n    index: number\n  ): string {\n    const locationPrefix = {\n      path: 'path',\n      query: 'query',\n      header: 'header',\n      cookie: 'cookie',\n      body: 'body',\n    }[location];\n\n    return `${locationPrefix}${paramName.charAt(0).toUpperCase()}${paramName.slice(1)}`;\n  }\n\n  /**\n   * Resolve all parameters for an operation\n   */\n  resolve(\n    operation: any,\n    pathParameters?: ParameterObject[],\n    securityRequirements?: SecurityRequirement[],\n    includeSecurityInInput?: boolean\n  ): {\n    inputSchema: JSONSchema7;\n    mapper: ParameterMapper[];\n  } {\n    const allParameters: ParameterObject[] = [\n      ...(pathParameters ?? []),\n      ...(operation.parameters ?? []),\n    ];\n\n    const requestBody = operation.requestBody as RequestBodyObject | undefined;\n\n    // Collect all parameter names and detect conflicts\n    const parametersByName = new Map<string, ParameterInfo[]>();\n\n    // Process standard parameters\n    allParameters.forEach((param) => {\n      const info: ParameterInfo = {\n        name: param.name,\n        location: param.in as ParameterLocation,\n        required: param.required ?? (param.in === 'path'),\n        schema: param.schema ?? { type: 'string' },\n        description: param.description,\n        style: param.style,\n        explode: param.explode,\n        allowReserved: param.allowReserved,\n        deprecated: param.deprecated,\n      };\n\n      if (!parametersByName.has(param.name)) {\n        parametersByName.set(param.name, []);\n      }\n      parametersByName.get(param.name)!.push(info);\n    });\n\n    // Process request body\n    if (requestBody?.content) {\n      const contentType = this.selectContentType(requestBody.content);\n      const mediaType = requestBody.content[contentType];\n\n      if (mediaType?.schema) {\n        this.extractBodyParameters(\n          mediaType.schema,\n          parametersByName,\n          requestBody.required ?? false,\n          contentType\n        );\n      }\n    }\n\n    // Resolve conflicts and build schema + mapper\n    const properties: Record<string, JSONSchema7> = {};\n    const required: string[] = [];\n    const mapper: ParameterMapper[] = [];\n\n    for (const [originalName, params] of parametersByName.entries()) {\n      if (params.length === 1) {\n        // No conflict\n        const param = params[0];\n        const inputKey = originalName;\n\n        properties[inputKey] = this.buildParameterSchema(param);\n        if (param.required) {\n          required.push(inputKey);\n        }\n\n        mapper.push({\n          inputKey,\n          type: param.location,\n          key: originalName,\n          required: param.required,\n          style: param.style,\n          explode: param.explode,\n          serialization: param.serialization,\n        });\n      } else {\n        // Conflict - need to resolve\n        params.forEach((param, index) => {\n          const inputKey = this.namingStrategy.conflictResolver(\n            originalName,\n            param.location,\n            index\n          );\n\n          properties[inputKey] = this.buildParameterSchema(param);\n          if (param.required) {\n            required.push(inputKey);\n          }\n\n          mapper.push({\n            inputKey,\n            type: param.location,\n            key: originalName,\n            required: param.required,\n            style: param.style,\n            explode: param.explode,\n            serialization: param.serialization,\n          });\n        });\n      }\n    }\n\n    // Process security requirements\n    if (securityRequirements && securityRequirements.length > 0) {\n      this.processSecurityRequirements(\n        securityRequirements,\n        properties,\n        required,\n        mapper,\n        includeSecurityInInput ?? false\n      );\n    }\n\n    const inputSchema: JSONSchema7 = {\n      type: 'object',\n      properties,\n      ...(required.length > 0 && { required }),\n      additionalProperties: false,\n    };\n\n    return { inputSchema, mapper };\n  }\n\n  /**\n   * Extract parameters from request body schema\n   */\n  private extractBodyParameters(\n    schema: SchemaObject | ReferenceObject,\n    parametersByName: Map<string, ParameterInfo[]>,\n    required: boolean,\n    contentType: string,\n    prefix = ''\n  ): void {\n    if (!schema || typeof schema !== 'object') return;\n\n    // Convert to JSONSchema7 for processing\n    const jsonSchema = toJSONSchema7(schema);\n\n    // Handle object schemas\n    if (jsonSchema.type === 'object' && jsonSchema.properties) {\n      const requiredFields = new Set(jsonSchema.required ?? []);\n\n      for (const [propName, propSchema] of Object.entries(jsonSchema.properties)) {\n        const fullName = prefix ? `${prefix}.${propName}` : propName;\n        const isRequired = required && requiredFields.has(propName);\n\n        if (typeof propSchema === 'object') {\n          const info: ParameterInfo = {\n            name: fullName,\n            location: 'body',\n            required: isRequired,\n            schema: propSchema as JSONSchema7,\n            description: (propSchema as any).description,\n            serialization: {\n              contentType,\n            },\n          };\n\n          if (!parametersByName.has(fullName)) {\n            parametersByName.set(fullName, []);\n          }\n          parametersByName.get(fullName)!.push(info);\n        }\n      }\n    } else {\n      // For non-object bodies (arrays, primitives), treat as single parameter\n      const bodyParamName = prefix || 'body';\n      const info: ParameterInfo = {\n        name: bodyParamName,\n        location: 'body',\n        required,\n        schema,\n        serialization: {\n          contentType,\n        },\n      };\n\n      if (!parametersByName.has(bodyParamName)) {\n        parametersByName.set(bodyParamName, []);\n      }\n      parametersByName.get(bodyParamName)!.push(info);\n    }\n  }\n\n  /**\n   * Build JSON Schema for a parameter\n   */\n  private buildParameterSchema(param: ParameterInfo): JSONSchema7 {\n    const schema: JSONSchema7 = toJSONSchema7(param.schema as any);\n\n    if (param.description) {\n      schema.description = param.description;\n    }\n\n    if (param.deprecated) {\n      schema['deprecated'] = true;\n    }\n\n    // Add parameter metadata\n    (schema as any)['x-parameter-location'] = param.location;\n    if (param.style) {\n      (schema as any)['x-parameter-style'] = param.style;\n    }\n    if (param.explode !== undefined) {\n      (schema as any)['x-parameter-explode'] = param.explode;\n    }\n\n    return schema;\n  }\n\n  /**\n   * Select the most appropriate content type\n   */\n  private selectContentType(content: Record<string, any>): string {\n    // Preference order\n    const preferences = [\n      'application/json',\n      'application/x-www-form-urlencoded',\n      'multipart/form-data',\n      'application/xml',\n      'text/plain',\n    ];\n\n    for (const pref of preferences) {\n      if (content[pref]) return pref;\n    }\n\n    // Fallback to first available\n    const firstKey = Object.keys(content)[0];\n    if (!firstKey) {\n      throw new Error('No content type available in request body');\n    }\n    return firstKey;\n  }\n\n  /**\n   * Process security requirements and add to mapper/inputSchema\n   */\n  private processSecurityRequirements(\n    securityRequirements: SecurityRequirement[],\n    properties: Record<string, JSONSchema7>,\n    required: string[],\n    mapper: ParameterMapper[],\n    includeInInput: boolean\n  ): void {\n    for (const secReq of securityRequirements) {\n      const { scheme, type, name: apiKeyName, in: apiKeyIn, scopes } = secReq;\n\n      // Build security parameter info\n      const securityInfo: SecurityParameterInfo = {\n        scheme,\n        type,\n        scopes,\n      };\n\n      // Determine parameter details based on security type\n      let inputKey: string;\n      let headerKey: string;\n      let paramLocation: ParameterLocation;\n      let description: string;\n      let schema: JSONSchema7;\n\n      if (type === 'http') {\n        // HTTP auth (bearer, basic, etc.)\n        inputKey = scheme;\n        headerKey = 'Authorization';\n        paramLocation = 'header';\n\n        const httpScheme = 'httpScheme' in secReq && secReq.httpScheme ? secReq.httpScheme : 'bearer';\n        const bearerFormat = 'bearerFormat' in secReq ? secReq.bearerFormat : undefined;\n\n        securityInfo.httpScheme = httpScheme;\n        if (bearerFormat) {\n          securityInfo.bearerFormat = bearerFormat;\n        }\n\n        description = `${httpScheme.charAt(0).toUpperCase()}${httpScheme.slice(1)} authentication token`;\n        if (bearerFormat) {\n          description += ` (${bearerFormat})`;\n        }\n\n        schema = {\n          type: 'string',\n          description,\n        };\n      } else if (type === 'apiKey') {\n        // API Key auth\n        inputKey = scheme;\n        headerKey = apiKeyName || 'X-API-Key';\n        paramLocation = (apiKeyIn || 'header') as ParameterLocation;\n\n        securityInfo.apiKeyName = apiKeyName;\n        securityInfo.apiKeyIn = apiKeyIn;\n\n        description = `API key for ${scheme}`;\n        schema = {\n          type: 'string',\n          description,\n        };\n      } else if (type === 'oauth2' || type === 'openIdConnect') {\n        // OAuth2 / OpenID Connect\n        inputKey = scheme;\n        headerKey = 'Authorization';\n        paramLocation = 'header';\n\n        description = `OAuth2 access token${scopes && scopes.length > 0 ? ` (scopes: ${scopes.join(', ')})` : ''}`;\n        schema = {\n          type: 'string',\n          description,\n        };\n      } else {\n        // Unknown type, skip\n        continue;\n      }\n\n      // Add to mapper (always)\n      mapper.push({\n        inputKey,\n        type: paramLocation,\n        key: headerKey,\n        required: true,\n        security: securityInfo,\n      });\n\n      // Add to inputSchema (only if includeInInput is true)\n      if (includeInInput) {\n        properties[inputKey] = schema;\n        required.push(inputKey);\n      }\n    }\n  }\n}\n\n/**\n * Internal parameter info structure\n */\ninterface ParameterInfo {\n  name: string;\n  location: ParameterLocation;\n  required: boolean;\n  schema: SchemaObject | ReferenceObject | JSONSchema7;\n  description?: string;\n  style?: string;\n  explode?: boolean;\n  allowReserved?: boolean;\n  deprecated?: boolean;\n  serialization?: {\n    contentType?: string;\n    encoding?: Record<string, any>;\n  };\n}\n"]}
+{"version":3,"file":"parameter-resolver.js","sourceRoot":"","sources":["../../src/parameter-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema } from 'zod/v4/core';\n\n/** JSON Schema type from Zod v4 */\ntype JsonSchema = JSONSchema.JSONSchema;\nimport type {\n  ParameterMapper,\n  ParameterObject,\n  RequestBodyObject,\n  NamingStrategy,\n  ParameterLocation,\n  SchemaObject,\n  ReferenceObject,\n  SecurityRequirement,\n  SecurityParameterInfo,\n  SecuritySchemeObject,\n} from './types';\nimport { toJsonSchema, isReferenceObject } from './types';\n\n/**\n * Resolves parameters and handles naming conflicts\n */\nexport class ParameterResolver {\n  private namingStrategy: NamingStrategy;\n\n  constructor(namingStrategy?: NamingStrategy) {\n    this.namingStrategy = namingStrategy ?? {\n      conflictResolver: this.defaultConflictResolver,\n    };\n  }\n\n  /**\n   * Default conflict resolver: prefix with location\n   */\n  private defaultConflictResolver(paramName: string, location: ParameterLocation, index: number): string {\n    const locationPrefix = {\n      path: 'path',\n      query: 'query',\n      header: 'header',\n      cookie: 'cookie',\n      body: 'body',\n    }[location];\n\n    return `${locationPrefix}${paramName.charAt(0).toUpperCase()}${paramName.slice(1)}`;\n  }\n\n  /**\n   * Resolve all parameters for an operation\n   */\n  resolve(\n    operation: any,\n    pathParameters?: ParameterObject[],\n    securityRequirements?: SecurityRequirement[],\n    includeSecurityInInput?: boolean,\n  ): {\n    inputSchema: JsonSchema;\n    mapper: ParameterMapper[];\n  } {\n    const allParameters: ParameterObject[] = [...(pathParameters ?? []), ...(operation.parameters ?? [])];\n\n    const requestBody = operation.requestBody as RequestBodyObject | undefined;\n\n    // Collect all parameter names and detect conflicts\n    const parametersByName = new Map<string, ParameterInfo[]>();\n\n    // Process standard parameters\n    allParameters.forEach((param) => {\n      const info: ParameterInfo = {\n        name: param.name,\n        location: param.in as ParameterLocation,\n        required: param.required ?? param.in === 'path',\n        schema: param.schema ?? { type: 'string' },\n        description: param.description,\n        style: param.style,\n        explode: param.explode,\n        allowReserved: param.allowReserved,\n        deprecated: param.deprecated,\n      };\n\n      if (!parametersByName.has(param.name)) {\n        parametersByName.set(param.name, []);\n      }\n      parametersByName.get(param.name)!.push(info);\n    });\n\n    // Process request body\n    if (requestBody?.content) {\n      const contentType = this.selectContentType(requestBody.content);\n      const mediaType = requestBody.content[contentType];\n\n      if (mediaType?.schema) {\n        this.extractBodyParameters(mediaType.schema, parametersByName, requestBody.required ?? false, contentType);\n      }\n    }\n\n    // Resolve conflicts and build schema + mapper\n    const properties: Record<string, JsonSchema> = {};\n    const required: string[] = [];\n    const mapper: ParameterMapper[] = [];\n\n    for (const [originalName, params] of parametersByName.entries()) {\n      if (params.length === 1) {\n        // No conflict\n        const param = params[0];\n        const inputKey = originalName;\n\n        properties[inputKey] = this.buildParameterSchema(param);\n        if (param.required) {\n          required.push(inputKey);\n        }\n\n        mapper.push({\n          inputKey,\n          type: param.location,\n          key: originalName,\n          required: param.required,\n          style: param.style,\n          explode: param.explode,\n          serialization: param.serialization,\n        });\n      } else {\n        // Conflict - need to resolve\n        params.forEach((param, index) => {\n          const inputKey = this.namingStrategy.conflictResolver(originalName, param.location, index);\n\n          properties[inputKey] = this.buildParameterSchema(param);\n          if (param.required) {\n            required.push(inputKey);\n          }\n\n          mapper.push({\n            inputKey,\n            type: param.location,\n            key: originalName,\n            required: param.required,\n            style: param.style,\n            explode: param.explode,\n            serialization: param.serialization,\n          });\n        });\n      }\n    }\n\n    // Process security requirements\n    if (securityRequirements && securityRequirements.length > 0) {\n      this.processSecurityRequirements(\n        securityRequirements,\n        properties,\n        required,\n        mapper,\n        includeSecurityInInput ?? false,\n      );\n    }\n\n    const inputSchema: JsonSchema = {\n      type: 'object',\n      properties,\n      ...(required.length > 0 && { required }),\n      additionalProperties: false,\n    };\n\n    return { inputSchema, mapper };\n  }\n\n  /**\n   * Extract parameters from request body schema\n   */\n  private extractBodyParameters(\n    schema: SchemaObject | ReferenceObject,\n    parametersByName: Map<string, ParameterInfo[]>,\n    required: boolean,\n    contentType: string,\n    prefix = '',\n  ): void {\n    if (!schema || typeof schema !== 'object') return;\n\n    // Convert to JsonSchema for processing\n    const jsonSchema = toJsonSchema(schema);\n\n    // Handle object schemas\n    if (jsonSchema.type === 'object' && jsonSchema.properties) {\n      const requiredFields = new Set(jsonSchema.required ?? []);\n\n      for (const [propName, propSchema] of Object.entries(jsonSchema.properties)) {\n        const fullName = prefix ? `${prefix}.${propName}` : propName;\n        const isRequired = required && requiredFields.has(propName);\n\n        if (typeof propSchema === 'object') {\n          const info: ParameterInfo = {\n            name: fullName,\n            location: 'body',\n            required: isRequired,\n            schema: propSchema as JsonSchema,\n            description: (propSchema as any).description,\n            serialization: {\n              contentType,\n            },\n          };\n\n          if (!parametersByName.has(fullName)) {\n            parametersByName.set(fullName, []);\n          }\n          parametersByName.get(fullName)!.push(info);\n        }\n      }\n    } else {\n      // For non-object bodies (arrays, primitives), treat as single parameter\n      const bodyParamName = prefix || 'body';\n      const info: ParameterInfo = {\n        name: bodyParamName,\n        location: 'body',\n        required,\n        schema,\n        serialization: {\n          contentType,\n        },\n      };\n\n      if (!parametersByName.has(bodyParamName)) {\n        parametersByName.set(bodyParamName, []);\n      }\n      parametersByName.get(bodyParamName)!.push(info);\n    }\n  }\n\n  /**\n   * Build JSON Schema for a parameter\n   */\n  private buildParameterSchema(param: ParameterInfo): JsonSchema {\n    const schema: JsonSchema = toJsonSchema(param.schema as any);\n\n    if (param.description) {\n      schema.description = param.description;\n    }\n\n    if (param.deprecated) {\n      schema['deprecated'] = true;\n    }\n\n    // Add parameter metadata\n    (schema as any)['x-parameter-location'] = param.location;\n    if (param.style) {\n      (schema as any)['x-parameter-style'] = param.style;\n    }\n    if (param.explode !== undefined) {\n      (schema as any)['x-parameter-explode'] = param.explode;\n    }\n\n    return schema;\n  }\n\n  /**\n   * Select the most appropriate content type\n   */\n  private selectContentType(content: Record<string, any>): string {\n    // Preference order\n    const preferences = [\n      'application/json',\n      'application/x-www-form-urlencoded',\n      'multipart/form-data',\n      'application/xml',\n      'text/plain',\n    ];\n\n    for (const pref of preferences) {\n      if (content[pref]) return pref;\n    }\n\n    // Fallback to first available\n    const firstKey = Object.keys(content)[0];\n    if (!firstKey) {\n      throw new Error('No content type available in request body');\n    }\n    return firstKey;\n  }\n\n  /**\n   * Process security requirements and add to mapper/inputSchema\n   */\n  private processSecurityRequirements(\n    securityRequirements: SecurityRequirement[],\n    properties: Record<string, JsonSchema>,\n    required: string[],\n    mapper: ParameterMapper[],\n    includeInInput: boolean,\n  ): void {\n    for (const secReq of securityRequirements) {\n      const { scheme, type, name: apiKeyName, in: apiKeyIn, scopes } = secReq;\n\n      // Build security parameter info\n      const securityInfo: SecurityParameterInfo = {\n        scheme,\n        type,\n        scopes,\n      };\n\n      // Determine parameter details based on security type\n      let inputKey: string;\n      let headerKey: string;\n      let paramLocation: ParameterLocation;\n      let description: string;\n      let schema: JsonSchema;\n\n      if (type === 'http') {\n        // HTTP auth (bearer, basic, etc.)\n        inputKey = scheme;\n        headerKey = 'Authorization';\n        paramLocation = 'header';\n\n        const httpScheme = 'httpScheme' in secReq && secReq.httpScheme ? secReq.httpScheme : 'bearer';\n        const bearerFormat = 'bearerFormat' in secReq ? secReq.bearerFormat : undefined;\n\n        securityInfo.httpScheme = httpScheme;\n        if (bearerFormat) {\n          securityInfo.bearerFormat = bearerFormat;\n        }\n\n        description = `${httpScheme.charAt(0).toUpperCase()}${httpScheme.slice(1)} authentication token`;\n        if (bearerFormat) {\n          description += ` (${bearerFormat})`;\n        }\n\n        schema = {\n          type: 'string',\n          description,\n        };\n      } else if (type === 'apiKey') {\n        // API Key auth\n        inputKey = scheme;\n        headerKey = apiKeyName || 'X-API-Key';\n        paramLocation = (apiKeyIn || 'header') as ParameterLocation;\n\n        securityInfo.apiKeyName = apiKeyName;\n        securityInfo.apiKeyIn = apiKeyIn;\n\n        description = `API key for ${scheme}`;\n        schema = {\n          type: 'string',\n          description,\n        };\n      } else if (type === 'oauth2' || type === 'openIdConnect') {\n        // OAuth2 / OpenID Connect\n        inputKey = scheme;\n        headerKey = 'Authorization';\n        paramLocation = 'header';\n\n        description = `OAuth2 access token${scopes && scopes.length > 0 ? ` (scopes: ${scopes.join(', ')})` : ''}`;\n        schema = {\n          type: 'string',\n          description,\n        };\n      } else {\n        // Unknown type, skip\n        continue;\n      }\n\n      // Add to mapper (always)\n      mapper.push({\n        inputKey,\n        type: paramLocation,\n        key: headerKey,\n        required: true,\n        security: securityInfo,\n      });\n\n      // Add to inputSchema (only if includeInInput is true)\n      if (includeInInput) {\n        properties[inputKey] = schema;\n        required.push(inputKey);\n      }\n    }\n  }\n}\n\n/**\n * Internal parameter info structure\n */\ninterface ParameterInfo {\n  name: string;\n  location: ParameterLocation;\n  required: boolean;\n  schema: SchemaObject | ReferenceObject | JsonSchema;\n  description?: string;\n  style?: string;\n  explode?: boolean;\n  allowReserved?: boolean;\n  deprecated?: boolean;\n  serialization?: {\n    contentType?: string;\n    encoding?: Record<string, any>;\n  };\n}\n"]}

package/src/response-builder.d.ts

@@ -1,4 +1,6 @@
-import type { JSONSchema7 } from 'json-schema';
+import type { JSONSchema } from 'zod/v4/core';
+/** JSON Schema type from Zod v4 */
+type JsonSchema = JSONSchema.JSONSchema;
 import type { GenerateOptions, ResponsesObject } from './types';
 /**
  * Builds output schemas from OpenAPI response definitions
@@ -10,7 +12,7 @@ export declare class ResponseBuilder {
     /**
      * Build output schema from responses
      */
-    build(responses?: ResponsesObject): JSONSchema7 | undefined;
+    build(responses?: ResponsesObject): JsonSchema | undefined;
     /**
      * Extract schemas from all responses
      */
@@ -28,3 +30,4 @@ export declare class ResponseBuilder {
      */
     private selectPreferredSchema;
 }
+export {};

package/src/response-builder.js

@@ -6,6 +6,8 @@ const types_1 = require("./types");
  * Builds output schemas from OpenAPI response definitions
  */
 class ResponseBuilder {
+    preferredStatusCodes;
+    includeAllResponses;
     constructor(options = {}) {
         this.preferredStatusCodes = options.preferredStatusCodes ?? [200, 201, 204, 202, 203, 206];
         this.includeAllResponses = options.includeAllResponses ?? true;
@@ -90,7 +92,7 @@ class ResponseBuilder {
             return null;
         }
         const schema = {
-            ...(0, types_1.toJSONSchema7)(mediaType.schema),
+            ...(0, types_1.toJsonSchema)(mediaType.schema),
             'x-status-code': statusCode,
         };
         // Add description if not already present

package/src/response-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"response-builder.js","sourceRoot":"","sources":["../../src/response-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema7 } from 'json-schema';\nimport type { ResponseObject, GenerateOptions, ResponsesObject } from './types';\nimport { isReferenceObject, toJSONSchema7 } from './types';\n\n/**\n * Builds output schemas from OpenAPI response definitions\n */\nexport class ResponseBuilder {\n  private preferredStatusCodes: number[];\n  private includeAllResponses: boolean;\n\n  constructor(options: GenerateOptions = {}) {\n    this.preferredStatusCodes = options.preferredStatusCodes ?? [200, 201, 204, 202, 203, 206];\n    this.includeAllResponses = options.includeAllResponses ?? true;\n  }\n\n  /**\n   * Build output schema from responses\n   */\n  build(responses?: ResponsesObject): JSONSchema7 | undefined {\n    if (!responses || Object.keys(responses).length === 0) {\n      return undefined;\n    }\n\n    const schemas = this.extractResponseSchemas(responses);\n\n    if (schemas.length === 0) {\n      return undefined;\n    }\n\n    if (schemas.length === 1) {\n      return schemas[0].schema;\n    }\n\n    if (this.includeAllResponses) {\n      // Return union of all response schemas\n      return {\n        oneOf: schemas.map((s) => s.schema),\n        description: 'Response can be one of multiple status codes',\n      };\n    } else {\n      // Return only the preferred status code\n      const preferred = this.selectPreferredSchema(schemas);\n      return preferred.schema;\n    }\n  }\n\n  /**\n   * Extract schemas from all responses\n   */\n  private extractResponseSchemas(responses: ResponsesObject): ResponseSchema[] {\n    const schemas: ResponseSchema[] = [];\n\n    for (const [statusCode, response] of Object.entries(responses)) {\n      // Skip if it's a reference object\n      if (isReferenceObject(response)) continue;\n\n      // Skip 'default' for now, we'll handle it separately\n      if (statusCode === 'default') continue;\n\n      const code = parseInt(statusCode, 10);\n      if (isNaN(code)) continue;\n\n      const schema = this.extractResponseSchema(response, code);\n      if (schema) {\n        schemas.push(schema);\n      }\n    }\n\n    // Handle default response if no other schemas found\n    if (schemas.length === 0 && responses['default']) {\n      const defaultResponse = responses['default'];\n      if (!isReferenceObject(defaultResponse)) {\n        const schema = this.extractResponseSchema(defaultResponse, 0);\n        if (schema) {\n          schemas.push(schema);\n        }\n      }\n    }\n\n    return schemas;\n  }\n\n  /**\n   * Extract schema from a single response\n   */\n  private extractResponseSchema(response: ResponseObject, statusCode: number): ResponseSchema | null {\n    if (!response.content) {\n      // Response with no content (e.g., 204 No Content)\n      return {\n        statusCode,\n        schema: {\n          type: 'null',\n          description: response.description,\n          'x-status-code': statusCode,\n        } as JSONSchema7,\n      };\n    }\n\n    const contentType = this.selectContentType(response.content);\n    const mediaType = response.content[contentType];\n\n    if (!mediaType?.schema) {\n      return null;\n    }\n\n    const schema: JSONSchema7 & { 'x-status-code'?: number } = {\n      ...toJSONSchema7(mediaType.schema),\n      'x-status-code': statusCode,\n    };\n\n    // Add description if not already present\n    if (!schema.description && response.description) {\n      schema.description = response.description;\n    }\n\n    // Add content type metadata\n    (schema as any)['x-content-type'] = contentType;\n\n    return { statusCode, schema };\n  }\n\n  /**\n   * Select the most appropriate content type\n   */\n  private selectContentType(content: Record<string, any>): string {\n    // Preference order for responses\n    const preferences = [\n      'application/json',\n      'application/hal+json',\n      'application/problem+json',\n      'application/xml',\n      'text/plain',\n      'text/html',\n    ];\n\n    for (const pref of preferences) {\n      if (content[pref]) return pref;\n    }\n\n    // Fallback to first available\n    return Object.keys(content)[0];\n  }\n\n  /**\n   * Select the preferred schema based on status code preferences\n   */\n  private selectPreferredSchema(schemas: ResponseSchema[]): ResponseSchema {\n    // First, try to find exact match in preferred list\n    for (const preferredCode of this.preferredStatusCodes) {\n      const found = schemas.find((s) => s.statusCode === preferredCode);\n      if (found) return found;\n    }\n\n    // Next, try to find any 2xx response\n    const success = schemas.find((s) => s.statusCode >= 200 && s.statusCode < 300);\n    if (success) return success;\n\n    // Next, try to find any 3xx response\n    const redirect = schemas.find((s) => s.statusCode >= 300 && s.statusCode < 400);\n    if (redirect) return redirect;\n\n    // Fallback to first available\n    return schemas[0];\n  }\n}\n\n/**\n * Internal response schema structure\n */\ninterface ResponseSchema {\n  statusCode: number;\n  schema: JSONSchema7;\n}\n"]}
+{"version":3,"file":"response-builder.js","sourceRoot":"","sources":["../../src/response-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema } from 'zod/v4/core';\n\n/** JSON Schema type from Zod v4 */\ntype JsonSchema = JSONSchema.JSONSchema;\nimport type { ResponseObject, GenerateOptions, ResponsesObject } from './types';\nimport { isReferenceObject, toJsonSchema } from './types';\n\n/**\n * Builds output schemas from OpenAPI response definitions\n */\nexport class ResponseBuilder {\n  private preferredStatusCodes: number[];\n  private includeAllResponses: boolean;\n\n  constructor(options: GenerateOptions = {}) {\n    this.preferredStatusCodes = options.preferredStatusCodes ?? [200, 201, 204, 202, 203, 206];\n    this.includeAllResponses = options.includeAllResponses ?? true;\n  }\n\n  /**\n   * Build output schema from responses\n   */\n  build(responses?: ResponsesObject): JsonSchema | undefined {\n    if (!responses || Object.keys(responses).length === 0) {\n      return undefined;\n    }\n\n    const schemas = this.extractResponseSchemas(responses);\n\n    if (schemas.length === 0) {\n      return undefined;\n    }\n\n    if (schemas.length === 1) {\n      return schemas[0].schema;\n    }\n\n    if (this.includeAllResponses) {\n      // Return union of all response schemas\n      return {\n        oneOf: schemas.map((s) => s.schema),\n        description: 'Response can be one of multiple status codes',\n      };\n    } else {\n      // Return only the preferred status code\n      const preferred = this.selectPreferredSchema(schemas);\n      return preferred.schema;\n    }\n  }\n\n  /**\n   * Extract schemas from all responses\n   */\n  private extractResponseSchemas(responses: ResponsesObject): ResponseSchema[] {\n    const schemas: ResponseSchema[] = [];\n\n    for (const [statusCode, response] of Object.entries(responses)) {\n      // Skip if it's a reference object\n      if (isReferenceObject(response)) continue;\n\n      // Skip 'default' for now, we'll handle it separately\n      if (statusCode === 'default') continue;\n\n      const code = parseInt(statusCode, 10);\n      if (isNaN(code)) continue;\n\n      const schema = this.extractResponseSchema(response, code);\n      if (schema) {\n        schemas.push(schema);\n      }\n    }\n\n    // Handle default response if no other schemas found\n    if (schemas.length === 0 && responses['default']) {\n      const defaultResponse = responses['default'];\n      if (!isReferenceObject(defaultResponse)) {\n        const schema = this.extractResponseSchema(defaultResponse, 0);\n        if (schema) {\n          schemas.push(schema);\n        }\n      }\n    }\n\n    return schemas;\n  }\n\n  /**\n   * Extract schema from a single response\n   */\n  private extractResponseSchema(response: ResponseObject, statusCode: number): ResponseSchema | null {\n    if (!response.content) {\n      // Response with no content (e.g., 204 No Content)\n      return {\n        statusCode,\n        schema: {\n          type: 'null',\n          description: response.description,\n          'x-status-code': statusCode,\n        } as JsonSchema,\n      };\n    }\n\n    const contentType = this.selectContentType(response.content);\n    const mediaType = response.content[contentType];\n\n    if (!mediaType?.schema) {\n      return null;\n    }\n\n    const schema: JsonSchema & { 'x-status-code'?: number } = {\n      ...toJsonSchema(mediaType.schema),\n      'x-status-code': statusCode,\n    };\n\n    // Add description if not already present\n    if (!schema.description && response.description) {\n      schema.description = response.description;\n    }\n\n    // Add content type metadata\n    (schema as any)['x-content-type'] = contentType;\n\n    return { statusCode, schema };\n  }\n\n  /**\n   * Select the most appropriate content type\n   */\n  private selectContentType(content: Record<string, any>): string {\n    // Preference order for responses\n    const preferences = [\n      'application/json',\n      'application/hal+json',\n      'application/problem+json',\n      'application/xml',\n      'text/plain',\n      'text/html',\n    ];\n\n    for (const pref of preferences) {\n      if (content[pref]) return pref;\n    }\n\n    // Fallback to first available\n    return Object.keys(content)[0];\n  }\n\n  /**\n   * Select the preferred schema based on status code preferences\n   */\n  private selectPreferredSchema(schemas: ResponseSchema[]): ResponseSchema {\n    // First, try to find exact match in preferred list\n    for (const preferredCode of this.preferredStatusCodes) {\n      const found = schemas.find((s) => s.statusCode === preferredCode);\n      if (found) return found;\n    }\n\n    // Next, try to find any 2xx response\n    const success = schemas.find((s) => s.statusCode >= 200 && s.statusCode < 300);\n    if (success) return success;\n\n    // Next, try to find any 3xx response\n    const redirect = schemas.find((s) => s.statusCode >= 300 && s.statusCode < 400);\n    if (redirect) return redirect;\n\n    // Fallback to first available\n    return schemas[0];\n  }\n}\n\n/**\n * Internal response schema structure\n */\ninterface ResponseSchema {\n  statusCode: number;\n  schema: JsonSchema;\n}\n"]}

package/src/schema-builder.d.ts

@@ -1,4 +1,6 @@
-import type { JSONSchema7 } from 'json-schema';
+import type { JSONSchema } from 'zod/v4/core';
+/** JSON Schema type from Zod v4 */
+type JsonSchema = JSONSchema.JSONSchema;
 /**
  * Helper class for building and manipulating JSON schemas
  */
@@ -6,66 +8,66 @@ export declare class SchemaBuilder {
     /**
      * Merge multiple schemas into one
      */
-    static merge(schemas: JSONSchema7[]): JSONSchema7;
+    static merge(schemas: JsonSchema[]): JsonSchema;
     /**
      * Create a union schema (oneOf)
      */
-    static union(schemas: JSONSchema7[]): JSONSchema7;
+    static union(schemas: JsonSchema[]): JsonSchema;
     /**
      * Deep clone a schema
      */
-    static clone(schema: JSONSchema7): JSONSchema7;
+    static clone(schema: JsonSchema): JsonSchema;
     /**
      * Remove $ref from schema (assumes already dereferenced)
      */
-    static removeRefs(schema: JSONSchema7): JSONSchema7;
+    static removeRefs(schema: JsonSchema): JsonSchema;
     private static removeRefsRecursive;
     /**
      * Add description to schema
      */
-    static withDescription(schema: JSONSchema7, description: string): JSONSchema7;
+    static withDescription(schema: JsonSchema, description: string): JsonSchema;
     /**
      * Add example to schema
      */
-    static withExample(schema: JSONSchema7, example: any): JSONSchema7;
+    static withExample(schema: JsonSchema, example: any): JsonSchema;
     /**
      * Add default value to schema
      */
-    static withDefault(schema: JSONSchema7, defaultValue: any): JSONSchema7;
+    static withDefault(schema: JsonSchema, defaultValue: any): JsonSchema;
     /**
      * Add format to schema
      */
-    static withFormat(schema: JSONSchema7, format: string): JSONSchema7;
+    static withFormat(schema: JsonSchema, format: string): JsonSchema;
     /**
      * Add pattern to schema
      */
-    static withPattern(schema: JSONSchema7, pattern: string): JSONSchema7;
+    static withPattern(schema: JsonSchema, pattern: string): JsonSchema;
     /**
      * Add enum to schema
      */
-    static withEnum(schema: JSONSchema7, values: any[]): JSONSchema7;
+    static withEnum(schema: JsonSchema, values: any[]): JsonSchema;
     /**
      * Add minimum/maximum constraints
      */
-    static withRange(schema: JSONSchema7, min?: number, max?: number, options?: {
+    static withRange(schema: JsonSchema, min?: number, max?: number, options?: {
         exclusive?: boolean;
-    }): JSONSchema7;
+    }): JsonSchema;
     /**
      * Add minLength/maxLength constraints
      */
-    static withLength(schema: JSONSchema7, minLength?: number, maxLength?: number): JSONSchema7;
+    static withLength(schema: JsonSchema, minLength?: number, maxLength?: number): JsonSchema;
     /**
      * Create object schema
      */
-    static object(properties: Record<string, JSONSchema7>, required?: string[]): JSONSchema7;
+    static object(properties: Record<string, JsonSchema>, required?: string[]): JsonSchema;
     /**
      * Create array schema
      */
-    static array(items: JSONSchema7, constraints?: {
+    static array(items: JsonSchema, constraints?: {
         minItems?: number;
         maxItems?: number;
         uniqueItems?: boolean;
-    }): JSONSchema7;
+    }): JsonSchema;
     /**
      * Create string schema
      */
@@ -75,7 +77,7 @@ export declare class SchemaBuilder {
         pattern?: string;
         format?: string;
         enum?: string[];
-    }): JSONSchema7;
+    }): JsonSchema;
     /**
      * Create number schema
      */
@@ -85,7 +87,7 @@ export declare class SchemaBuilder {
         exclusiveMinimum?: number;
         exclusiveMaximum?: number;
         multipleOf?: number;
-    }): JSONSchema7;
+    }): JsonSchema;
     /**
      * Create integer schema
      */
@@ -95,21 +97,22 @@ export declare class SchemaBuilder {
         exclusiveMinimum?: number;
         exclusiveMaximum?: number;
         multipleOf?: number;
-    }): JSONSchema7;
+    }): JsonSchema;
     /**
      * Create boolean schema
      */
-    static boolean(): JSONSchema7;
+    static boolean(): JsonSchema;
     /**
      * Create null schema
      */
-    static null(): JSONSchema7;
+    static null(): JsonSchema;
     /**
      * Flatten nested oneOf/anyOf/allOf schemas
      */
-    static flatten(schema: JSONSchema7, maxDepth?: number): JSONSchema7;
+    static flatten(schema: JsonSchema, maxDepth?: number): JsonSchema;
     /**
      * Simplify schema by removing unnecessary fields
      */
-    static simplify(schema: JSONSchema7): JSONSchema7;
+    static simplify(schema: JsonSchema): JsonSchema;
 }
+export {};

package/src/schema-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-builder.js","sourceRoot":"","sources":["../../src/schema-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema7 } from 'json-schema';\n\n/**\n * Helper class for building and manipulating JSON schemas\n */\nexport class SchemaBuilder {\n  /**\n   * Merge multiple schemas into one\n   */\n  static merge(schemas: JSONSchema7[]): JSONSchema7 {\n    if (schemas.length === 0) {\n      return { type: 'object' };\n    }\n\n    if (schemas.length === 1) {\n      return schemas[0];\n    }\n\n    const merged: JSONSchema7 = {\n      type: 'object',\n      properties: {},\n      required: [],\n    };\n\n    const allRequired = new Set<string>();\n\n    for (const schema of schemas) {\n      if (schema.properties) {\n        merged.properties = {\n          ...merged.properties,\n          ...schema.properties,\n        };\n      }\n\n      if (schema.required) {\n        schema.required.forEach((field) => allRequired.add(field));\n      }\n    }\n\n    if (allRequired.size > 0) {\n      merged.required = Array.from(allRequired);\n    }\n\n    return merged;\n  }\n\n  /**\n   * Create a union schema (oneOf)\n   */\n  static union(schemas: JSONSchema7[]): JSONSchema7 {\n    if (schemas.length === 0) {\n      return {};\n    }\n\n    if (schemas.length === 1) {\n      return schemas[0];\n    }\n\n    return {\n      oneOf: schemas,\n    };\n  }\n\n  /**\n   * Deep clone a schema\n   */\n  static clone(schema: JSONSchema7): JSONSchema7 {\n    return JSON.parse(JSON.stringify(schema));\n  }\n\n  /**\n   * Remove $ref from schema (assumes already dereferenced)\n   */\n  static removeRefs(schema: JSONSchema7): JSONSchema7 {\n    const cloned = this.clone(schema);\n    this.removeRefsRecursive(cloned);\n    return cloned;\n  }\n\n  private static removeRefsRecursive(obj: any): void {\n    if (!obj || typeof obj !== 'object') return;\n\n    if (obj.$ref) {\n      delete obj.$ref;\n    }\n\n    for (const key in obj) {\n      if (key in obj) {\n        const value = obj[key];\n        if (value && typeof value === 'object') {\n          this.removeRefsRecursive(value);\n        }\n      }\n    }\n  }\n\n  /**\n   * Add description to schema\n   */\n  static withDescription(schema: JSONSchema7, description: string): JSONSchema7 {\n    return {\n      ...schema,\n      description,\n    };\n  }\n\n  /**\n   * Add example to schema\n   */\n  static withExample(schema: JSONSchema7, example: any): JSONSchema7 {\n    const existingExamples = Array.isArray(schema.examples) ? schema.examples : [];\n    return {\n      ...schema,\n      examples: [...existingExamples, example],\n    };\n  }\n\n  /**\n   * Add default value to schema\n   */\n  static withDefault(schema: JSONSchema7, defaultValue: any): JSONSchema7 {\n    return {\n      ...schema,\n      default: defaultValue,\n    };\n  }\n\n  /**\n   * Add format to schema\n   */\n  static withFormat(schema: JSONSchema7, format: string): JSONSchema7 {\n    return {\n      ...schema,\n      format,\n    };\n  }\n\n  /**\n   * Add pattern to schema\n   */\n  static withPattern(schema: JSONSchema7, pattern: string): JSONSchema7 {\n    return {\n      ...schema,\n      pattern,\n    };\n  }\n\n  /**\n   * Add enum to schema\n   */\n  static withEnum(schema: JSONSchema7, values: any[]): JSONSchema7 {\n    return {\n      ...schema,\n      enum: values,\n    };\n  }\n\n  /**\n   * Add minimum/maximum constraints\n   */\n  static withRange(\n    schema: JSONSchema7,\n    min?: number,\n    max?: number,\n    options: { exclusive?: boolean } = {}\n  ): JSONSchema7 {\n    const result = { ...schema };\n\n    if (min !== undefined) {\n      if (options.exclusive) {\n        result.exclusiveMinimum = min;\n      } else {\n        result.minimum = min;\n      }\n    }\n\n    if (max !== undefined) {\n      if (options.exclusive) {\n        result.exclusiveMaximum = max;\n      } else {\n        result.maximum = max;\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Add minLength/maxLength constraints\n   */\n  static withLength(schema: JSONSchema7, minLength?: number, maxLength?: number): JSONSchema7 {\n    const result = { ...schema };\n\n    if (minLength !== undefined) {\n      result.minLength = minLength;\n    }\n\n    if (maxLength !== undefined) {\n      result.maxLength = maxLength;\n    }\n\n    return result;\n  }\n\n  /**\n   * Create object schema\n   */\n  static object(\n    properties: Record<string, JSONSchema7>,\n    required?: string[]\n  ): JSONSchema7 {\n    return {\n      type: 'object',\n      properties,\n      ...(required && required.length > 0 && { required }),\n      additionalProperties: false,\n    };\n  }\n\n  /**\n   * Create array schema\n   */\n  static array(items: JSONSchema7, constraints?: {\n    minItems?: number;\n    maxItems?: number;\n    uniqueItems?: boolean;\n  }): JSONSchema7 {\n    return {\n      type: 'array',\n      items,\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create string schema\n   */\n  static string(constraints?: {\n    minLength?: number;\n    maxLength?: number;\n    pattern?: string;\n    format?: string;\n    enum?: string[];\n  }): JSONSchema7 {\n    return {\n      type: 'string',\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create number schema\n   */\n  static number(constraints?: {\n    minimum?: number;\n    maximum?: number;\n    exclusiveMinimum?: number;\n    exclusiveMaximum?: number;\n    multipleOf?: number;\n  }): JSONSchema7 {\n    return {\n      type: 'number',\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create integer schema\n   */\n  static integer(constraints?: {\n    minimum?: number;\n    maximum?: number;\n    exclusiveMinimum?: number;\n    exclusiveMaximum?: number;\n    multipleOf?: number;\n  }): JSONSchema7 {\n    return {\n      type: 'integer',\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create boolean schema\n   */\n  static boolean(): JSONSchema7 {\n    return {\n      type: 'boolean',\n    };\n  }\n\n  /**\n   * Create null schema\n   */\n  static null(): JSONSchema7 {\n    return {\n      type: 'null',\n    };\n  }\n\n  /**\n   * Flatten nested oneOf/anyOf/allOf schemas\n   */\n  static flatten(schema: JSONSchema7, maxDepth = 10): JSONSchema7 {\n    if (maxDepth <= 0) return schema;\n\n    const cloned = this.clone(schema);\n\n    if (cloned.oneOf) {\n      const flattened = cloned.oneOf.flatMap((s) => {\n        const sub = this.flatten(s as JSONSchema7, maxDepth - 1);\n        return sub.oneOf ? sub.oneOf : [sub];\n      });\n      cloned.oneOf = flattened as JSONSchema7[];\n    }\n\n    if (cloned.anyOf) {\n      const flattened = cloned.anyOf.flatMap((s) => {\n        const sub = this.flatten(s as JSONSchema7, maxDepth - 1);\n        return sub.anyOf ? sub.anyOf : [sub];\n      });\n      cloned.anyOf = flattened as JSONSchema7[];\n    }\n\n    if (cloned.allOf) {\n      const flattened = cloned.allOf.flatMap((s) => {\n        const sub = this.flatten(s as JSONSchema7, maxDepth - 1);\n        return sub.allOf ? sub.allOf : [sub];\n      });\n      cloned.allOf = flattened as JSONSchema7[];\n    }\n\n    return cloned;\n  }\n\n  /**\n   * Simplify schema by removing unnecessary fields\n   */\n  static simplify(schema: JSONSchema7): JSONSchema7 {\n    const cloned = this.clone(schema);\n\n    // Remove empty arrays/objects\n    if (Array.isArray(cloned.required) && cloned.required.length === 0) {\n      delete cloned.required;\n    }\n\n    if (cloned.properties && Object.keys(cloned.properties).length === 0) {\n      delete cloned.properties;\n    }\n\n    if (Array.isArray(cloned.examples) && cloned.examples.length === 0) {\n      delete cloned.examples;\n    }\n\n    // Remove title if it matches description\n    if (cloned.title && cloned.description && cloned.title === cloned.description) {\n      delete cloned.title;\n    }\n\n    return cloned;\n  }\n}\n"]}
+{"version":3,"file":"schema-builder.js","sourceRoot":"","sources":["../../src/schema-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema } from 'zod/v4/core';\n\n/** JSON Schema type from Zod v4 */\ntype JsonSchema = JSONSchema.JSONSchema;\n\n/**\n * Helper class for building and manipulating JSON schemas\n */\nexport class SchemaBuilder {\n  /**\n   * Merge multiple schemas into one\n   */\n  static merge(schemas: JsonSchema[]): JsonSchema {\n    if (schemas.length === 0) {\n      return { type: 'object' };\n    }\n\n    if (schemas.length === 1) {\n      return schemas[0];\n    }\n\n    const merged: JsonSchema = {\n      type: 'object',\n      properties: {},\n      required: [],\n    };\n\n    const allRequired = new Set<string>();\n\n    for (const schema of schemas) {\n      if (schema.properties) {\n        merged.properties = {\n          ...merged.properties,\n          ...schema.properties,\n        };\n      }\n\n      if (schema.required) {\n        schema.required.forEach((field) => allRequired.add(field));\n      }\n    }\n\n    if (allRequired.size > 0) {\n      merged.required = Array.from(allRequired);\n    }\n\n    return merged;\n  }\n\n  /**\n   * Create a union schema (oneOf)\n   */\n  static union(schemas: JsonSchema[]): JsonSchema {\n    if (schemas.length === 0) {\n      return {};\n    }\n\n    if (schemas.length === 1) {\n      return schemas[0];\n    }\n\n    return {\n      oneOf: schemas,\n    };\n  }\n\n  /**\n   * Deep clone a schema\n   */\n  static clone(schema: JsonSchema): JsonSchema {\n    return JSON.parse(JSON.stringify(schema));\n  }\n\n  /**\n   * Remove $ref from schema (assumes already dereferenced)\n   */\n  static removeRefs(schema: JsonSchema): JsonSchema {\n    const cloned = this.clone(schema);\n    this.removeRefsRecursive(cloned);\n    return cloned;\n  }\n\n  private static removeRefsRecursive(obj: any): void {\n    if (!obj || typeof obj !== 'object') return;\n\n    if (obj.$ref) {\n      delete obj.$ref;\n    }\n\n    for (const key in obj) {\n      if (key in obj) {\n        const value = obj[key];\n        if (value && typeof value === 'object') {\n          this.removeRefsRecursive(value);\n        }\n      }\n    }\n  }\n\n  /**\n   * Add description to schema\n   */\n  static withDescription(schema: JsonSchema, description: string): JsonSchema {\n    return {\n      ...schema,\n      description,\n    };\n  }\n\n  /**\n   * Add example to schema\n   */\n  static withExample(schema: JsonSchema, example: any): JsonSchema {\n    const existingExamples = Array.isArray(schema.examples) ? schema.examples : [];\n    return {\n      ...schema,\n      examples: [...existingExamples, example],\n    };\n  }\n\n  /**\n   * Add default value to schema\n   */\n  static withDefault(schema: JsonSchema, defaultValue: any): JsonSchema {\n    return {\n      ...schema,\n      default: defaultValue,\n    };\n  }\n\n  /**\n   * Add format to schema\n   */\n  static withFormat(schema: JsonSchema, format: string): JsonSchema {\n    return {\n      ...schema,\n      format,\n    };\n  }\n\n  /**\n   * Add pattern to schema\n   */\n  static withPattern(schema: JsonSchema, pattern: string): JsonSchema {\n    return {\n      ...schema,\n      pattern,\n    };\n  }\n\n  /**\n   * Add enum to schema\n   */\n  static withEnum(schema: JsonSchema, values: any[]): JsonSchema {\n    return {\n      ...schema,\n      enum: values,\n    };\n  }\n\n  /**\n   * Add minimum/maximum constraints\n   */\n  static withRange(schema: JsonSchema, min?: number, max?: number, options: { exclusive?: boolean } = {}): JsonSchema {\n    const result = { ...schema };\n\n    if (min !== undefined) {\n      if (options.exclusive) {\n        result.exclusiveMinimum = min;\n      } else {\n        result.minimum = min;\n      }\n    }\n\n    if (max !== undefined) {\n      if (options.exclusive) {\n        result.exclusiveMaximum = max;\n      } else {\n        result.maximum = max;\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Add minLength/maxLength constraints\n   */\n  static withLength(schema: JsonSchema, minLength?: number, maxLength?: number): JsonSchema {\n    const result = { ...schema };\n\n    if (minLength !== undefined) {\n      result.minLength = minLength;\n    }\n\n    if (maxLength !== undefined) {\n      result.maxLength = maxLength;\n    }\n\n    return result;\n  }\n\n  /**\n   * Create object schema\n   */\n  static object(properties: Record<string, JsonSchema>, required?: string[]): JsonSchema {\n    return {\n      type: 'object',\n      properties,\n      ...(required && required.length > 0 && { required }),\n      additionalProperties: false,\n    };\n  }\n\n  /**\n   * Create array schema\n   */\n  static array(\n    items: JsonSchema,\n    constraints?: {\n      minItems?: number;\n      maxItems?: number;\n      uniqueItems?: boolean;\n    },\n  ): JsonSchema {\n    return {\n      type: 'array',\n      items,\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create string schema\n   */\n  static string(constraints?: {\n    minLength?: number;\n    maxLength?: number;\n    pattern?: string;\n    format?: string;\n    enum?: string[];\n  }): JsonSchema {\n    return {\n      type: 'string',\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create number schema\n   */\n  static number(constraints?: {\n    minimum?: number;\n    maximum?: number;\n    exclusiveMinimum?: number;\n    exclusiveMaximum?: number;\n    multipleOf?: number;\n  }): JsonSchema {\n    return {\n      type: 'number',\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create integer schema\n   */\n  static integer(constraints?: {\n    minimum?: number;\n    maximum?: number;\n    exclusiveMinimum?: number;\n    exclusiveMaximum?: number;\n    multipleOf?: number;\n  }): JsonSchema {\n    return {\n      type: 'integer',\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create boolean schema\n   */\n  static boolean(): JsonSchema {\n    return {\n      type: 'boolean',\n    };\n  }\n\n  /**\n   * Create null schema\n   */\n  static null(): JsonSchema {\n    return {\n      type: 'null',\n    };\n  }\n\n  /**\n   * Flatten nested oneOf/anyOf/allOf schemas\n   */\n  static flatten(schema: JsonSchema, maxDepth = 10): JsonSchema {\n    if (maxDepth <= 0) return schema;\n\n    const cloned = this.clone(schema);\n\n    if (cloned.oneOf) {\n      const flattened = cloned.oneOf.flatMap((s) => {\n        const sub = this.flatten(s as JsonSchema, maxDepth - 1);\n        return sub.oneOf ? sub.oneOf : [sub];\n      });\n      cloned.oneOf = flattened as JsonSchema[];\n    }\n\n    if (cloned.anyOf) {\n      const flattened = cloned.anyOf.flatMap((s) => {\n        const sub = this.flatten(s as JsonSchema, maxDepth - 1);\n        return sub.anyOf ? sub.anyOf : [sub];\n      });\n      cloned.anyOf = flattened as JsonSchema[];\n    }\n\n    if (cloned.allOf) {\n      const flattened = cloned.allOf.flatMap((s) => {\n        const sub = this.flatten(s as JsonSchema, maxDepth - 1);\n        return sub.allOf ? sub.allOf : [sub];\n      });\n      cloned.allOf = flattened as JsonSchema[];\n    }\n\n    return cloned;\n  }\n\n  /**\n   * Simplify schema by removing unnecessary fields\n   */\n  static simplify(schema: JsonSchema): JsonSchema {\n    const cloned = this.clone(schema);\n\n    // Remove empty arrays/objects\n    if (Array.isArray(cloned.required) && cloned.required.length === 0) {\n      delete cloned.required;\n    }\n\n    if (cloned.properties && Object.keys(cloned.properties).length === 0) {\n      delete cloned.properties;\n    }\n\n    if (Array.isArray(cloned.examples) && cloned.examples.length === 0) {\n      delete cloned.examples;\n    }\n\n    // Remove title if it matches description\n    if (cloned.title && cloned.description && cloned.title === cloned.description) {\n      delete cloned.title;\n    }\n\n    return cloned;\n  }\n}\n"]}

package/src/types.d.ts

@@ -1,4 +1,6 @@
-import type { JSONSchema7 } from 'json-schema';
+import type { JSONSchema } from 'zod/v4/core';
+/** JSON Schema type from Zod v4 */
+type JsonSchema = JSONSchema.JSONSchema;
 import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
 /**
  * OpenAPI specification version 3.0.x or 3.1.x
@@ -44,11 +46,11 @@ export type SchemaObject = OpenAPIV3.SchemaObject | OpenAPIV3_1.SchemaObject;
  */
 export declare function isReferenceObject(obj: any): obj is ReferenceObject;
 /**
- * Convert OpenAPI schema to JSONSchema7
+ * Convert OpenAPI schema to JsonSchema
  * Note: OpenAPI 3.0 uses a subset of JSON Schema Draft 4
  * OpenAPI 3.1 uses JSON Schema Draft 2020-12
  */
-export declare function toJSONSchema7(schema: SchemaObject | ReferenceObject): JSONSchema7;
+export declare function toJsonSchema(schema: SchemaObject | ReferenceObject): JsonSchema;
 /**
  * Main MCP Tool definition generated from OpenAPI
  */
@@ -65,12 +67,12 @@ export interface McpOpenAPITool {
      * Combined input schema including all parameters
      * (path, query, header, cookie, body)
      */
-    inputSchema: JSONSchema7;
+    inputSchema: JsonSchema;
     /**
      * Output schema based on response definitions
      * Can be a union of multiple status codes
      */
-    outputSchema?: JSONSchema7;
+    outputSchema?: JsonSchema;
     /**
      * Mapping from input schema properties to actual request parameters
      */
@@ -185,6 +187,14 @@ export interface ToolMetadata {
      * Operation ID from OpenAPI
      */
     operationId?: string;
+    /**
+     * Operation summary from OpenAPI (short description)
+     */
+    operationSummary?: string;
+    /**
+     * Operation description from OpenAPI (detailed description)
+     */
+    operationDescription?: string;
     /**
      * Tags from OpenAPI
      */
@@ -209,6 +219,57 @@ export interface ToolMetadata {
      * External documentation
      */
     externalDocs?: ExternalDocumentationObject;
+    /**
+     * FrontMCP extension data from x-frontmcp in the OpenAPI operation.
+     * Contains annotations, cache config, codecall config, tags, etc.
+     */
+    frontmcp?: FrontMcpExtensionData;
+}
+/**
+ * FrontMCP extension data extracted from x-frontmcp in OpenAPI operations.
+ * This provides declarative configuration for tools directly in the OpenAPI spec.
+ */
+export interface FrontMcpExtensionData {
+    /**
+     * Tool annotations for AI behavior hints.
+     */
+    annotations?: {
+        title?: string;
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    };
+    /**
+     * Cache configuration for response caching.
+     */
+    cache?: {
+        ttl?: number;
+        slideWindow?: boolean;
+    };
+    /**
+     * CodeCall-specific configuration.
+     */
+    codecall?: {
+        enabledInCodeCall?: boolean;
+        visibleInListTools?: boolean;
+    };
+    /**
+     * Tags/labels for categorization.
+     */
+    tags?: string[];
+    /**
+     * If true, hide tool from discovery.
+     */
+    hideFromDiscovery?: boolean;
+    /**
+     * Usage examples.
+     */
+    examples?: Array<{
+        description: string;
+        input: Record<string, unknown>;
+        output?: unknown;
+    }>;
 }
 /**
  * Security requirement definition
@@ -432,3 +493,4 @@ export interface ValidationWarning {
      */
     code?: string;
 }
+export {};

package/src/types.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isReferenceObject = isReferenceObject;
-exports.toJSONSchema7 = toJSONSchema7;
+exports.toJsonSchema = toJsonSchema;
 /**
  * Helper to check if an object is a ReferenceObject
  */
@@ -9,11 +9,11 @@ function isReferenceObject(obj) {
     return obj && typeof obj === 'object' && '$ref' in obj;
 }
 /**
- * Convert OpenAPI schema to JSONSchema7
+ * Convert OpenAPI schema to JsonSchema
  * Note: OpenAPI 3.0 uses a subset of JSON Schema Draft 4
  * OpenAPI 3.1 uses JSON Schema Draft 2020-12
  */
-function toJSONSchema7(schema) {
+function toJsonSchema(schema) {
     if (isReferenceObject(schema)) {
         return { $ref: schema.$ref };
     }
@@ -67,32 +67,32 @@ function toJSONSchema7(schema) {
         // No exclusiveMinimum, just minimum
         result['minimum'] = minimum;
     }
-    // Recursively convert nested schemas to ensure all nested schemas are valid JSONSchema7
+    // Recursively convert nested schemas to ensure all nested schemas are valid JsonSchema
     if (result['properties'] && typeof result['properties'] === 'object') {
         const props = {};
         for (const [key, value] of Object.entries(result['properties'])) {
-            props[key] = toJSONSchema7(value);
+            props[key] = toJsonSchema(value);
         }
         result['properties'] = props;
     }
     if (result['items']) {
         if (Array.isArray(result['items'])) {
-            result['items'] = result['items'].map(toJSONSchema7);
+            result['items'] = result['items'].map(toJsonSchema);
         }
         else {
-            result['items'] = toJSONSchema7(result['items']);
+            result['items'] = toJsonSchema(result['items']);
         }
     }
     if (result['additionalProperties'] && typeof result['additionalProperties'] === 'object') {
-        result['additionalProperties'] = toJSONSchema7(result['additionalProperties']);
+        result['additionalProperties'] = toJsonSchema(result['additionalProperties']);
     }
     for (const key of ['allOf', 'anyOf', 'oneOf']) {
         if (result[key] && Array.isArray(result[key])) {
-            result[key] = result[key].map(toJSONSchema7);
+            result[key] = result[key].map(toJsonSchema);
         }
     }
     if (result['not']) {
-        result['not'] = toJSONSchema7(result['not']);
+        result['not'] = toJsonSchema(result['not']);
     }
     return result;
 }

package/src/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;AAsDA,8CAEC;AAOD,sCAqFC;AAjGD;;GAEG;AACH,SAAgB,iBAAiB,CAAC,GAAQ;IACxC,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,MAAsC;IAClE,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAiB,CAAC;IAC9C,CAAC;IAED,+DAA+D;IAC/D,2DAA2D;IAC3D,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAEjF,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IAEpD,qCAAqC;IACrC,IAAI,OAAO,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC1C,IAAI,gBAAgB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9C,gEAAgE;YAChE,MAAM,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC;QACvC,CAAC;aAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,qDAAqD;YACrD,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QAC9B,CAAC;QACD,qEAAqE;IACvE,CAAC;SAAM,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC1C,6CAA6C;QAC7C,MAAM,CAAC,kBAAkB,CAAC,GAAG,gBAAgB,CAAC;QAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QAC9B,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,oCAAoC;QACpC,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,qCAAqC;IACrC,IAAI,OAAO,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC1C,IAAI,gBAAgB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9C,gEAAgE;YAChE,MAAM,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC;QACvC,CAAC;aAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,qDAAqD;YACrD,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QAC9B,CAAC;QACD,qEAAqE;IACvE,CAAC;SAAM,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC1C,6CAA6C;QAC7C,MAAM,CAAC,kBAAkB,CAAC,GAAG,gBAAgB,CAAC;QAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QAC9B,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,oCAAoC;QACpC,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,wFAAwF;IACxF,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,MAAM,CAAC,YAAY,CAAC,KAAK,QAAQ,EAAE,CAAC;QACrE,MAAM,KAAK,GAAgC,EAAE,CAAC;QAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAmD,CAAC,EAAE,CAAC;YAClH,KAAK,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,OAAO,CAAC,GAAI,MAAM,CAAC,OAAO,CAAwC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC/F,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAmC,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,sBAAsB,CAAC,IAAI,OAAO,MAAM,CAAC,sBAAsB,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzF,MAAM,CAAC,sBAAsB,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,sBAAsB,CAAmC,CAAC,CAAC;IACnH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAU,EAAE,CAAC;QACvD,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,GAAG,CAAC,GAAI,MAAM,CAAC,GAAG,CAAwC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAClB,MAAM,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAmC,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,MAAqB,CAAC;AAC/B,CAAC","sourcesContent":["import type { JSONSchema7 } from 'json-schema';\nimport type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';\n\n/**\n * OpenAPI specification version 3.0.x or 3.1.x\n */\nexport type OpenAPIVersion = '3.0.0' | '3.0.1' | '3.0.2' | '3.0.3' | '3.1.0';\n\n/**\n * Unified OpenAPI Document type (supports both 3.0 and 3.1)\n */\nexport type OpenAPIDocument = OpenAPIV3.Document | OpenAPIV3_1.Document;\n\n/**\n * HTTP methods supported by OpenAPI\n */\nexport type HTTPMethod = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'head' | 'options' | 'trace';\n\n/**\n * Parameter location types\n */\nexport type ParameterLocation = 'path' | 'query' | 'header' | 'cookie' | 'body';\n\n/**\n * Authentication types supported\n */\nexport type AuthType = 'apiKey' | 'http' | 'oauth2' | 'openIdConnect' | 'mutualTLS';\n\n// Re-export OpenAPI types for convenience\nexport type OperationObject = OpenAPIV3.OperationObject | OpenAPIV3_1.OperationObject;\nexport type ParameterObject = OpenAPIV3.ParameterObject | OpenAPIV3_1.ParameterObject;\nexport type RequestBodyObject = OpenAPIV3.RequestBodyObject | OpenAPIV3_1.RequestBodyObject;\nexport type ResponseObject = OpenAPIV3.ResponseObject | OpenAPIV3_1.ResponseObject;\nexport type ResponsesObject = OpenAPIV3.ResponsesObject | OpenAPIV3_1.ResponsesObject;\nexport type MediaTypeObject = OpenAPIV3.MediaTypeObject | OpenAPIV3_1.MediaTypeObject;\nexport type HeaderObject = OpenAPIV3.HeaderObject | OpenAPIV3_1.HeaderObject;\nexport type ExampleObject = OpenAPIV3.ExampleObject | OpenAPIV3_1.ExampleObject;\nexport type PathItemObject = OpenAPIV3.PathItemObject | OpenAPIV3_1.PathItemObject;\nexport type PathsObject = OpenAPIV3.PathsObject | OpenAPIV3_1.PathsObject;\nexport type ServerObject = OpenAPIV3.ServerObject | OpenAPIV3_1.ServerObject;\nexport type SecuritySchemeObject = OpenAPIV3.SecuritySchemeObject | OpenAPIV3_1.SecuritySchemeObject;\nexport type ReferenceObject = OpenAPIV3.ReferenceObject | OpenAPIV3_1.ReferenceObject;\nexport type TagObject = OpenAPIV3.TagObject | OpenAPIV3_1.TagObject;\nexport type ExternalDocumentationObject =\n  | OpenAPIV3.ExternalDocumentationObject\n  | OpenAPIV3_1.ExternalDocumentationObject;\nexport type ServerVariableObject = OpenAPIV3.ServerVariableObject | OpenAPIV3_1.ServerVariableObject;\nexport type EncodingObject = OpenAPIV3.EncodingObject | OpenAPIV3_1.EncodingObject;\nexport type SecurityRequirementObject = OpenAPIV3.SecurityRequirementObject | OpenAPIV3_1.SecurityRequirementObject;\nexport type SchemaObject = OpenAPIV3.SchemaObject | OpenAPIV3_1.SchemaObject;\n\n/**\n * Helper to check if an object is a ReferenceObject\n */\nexport function isReferenceObject(obj: any): obj is ReferenceObject {\n  return obj && typeof obj === 'object' && '$ref' in obj;\n}\n\n/**\n * Convert OpenAPI schema to JSONSchema7\n * Note: OpenAPI 3.0 uses a subset of JSON Schema Draft 4\n * OpenAPI 3.1 uses JSON Schema Draft 2020-12\n */\nexport function toJSONSchema7(schema: SchemaObject | ReferenceObject): JSONSchema7 {\n  if (isReferenceObject(schema)) {\n    return { $ref: schema.$ref } as JSONSchema7;\n  }\n\n  // Handle OpenAPI 3.0 boolean exclusiveMaximum/exclusiveMinimum\n  // by converting them to JSON Schema Draft 7 numeric format\n  const { exclusiveMaximum, exclusiveMinimum, maximum, minimum, ...rest } = schema;\n\n  const result: Record<string, unknown> = { ...rest };\n\n  // Handle exclusiveMaximum conversion\n  if (typeof exclusiveMaximum === 'boolean') {\n    if (exclusiveMaximum && maximum !== undefined) {\n      // true + maximum present -> convert to numeric exclusiveMaximum\n      result['exclusiveMaximum'] = maximum;\n    } else if (maximum !== undefined) {\n      // false or true without maximum -> keep maximum only\n      result['maximum'] = maximum;\n    }\n    // Boolean exclusiveMaximum is never added (invalid in JSON Schema 7)\n  } else if (exclusiveMaximum !== undefined) {\n    // Already numeric (OpenAPI 3.1) - keep as is\n    result['exclusiveMaximum'] = exclusiveMaximum;\n    if (maximum !== undefined) {\n      result['maximum'] = maximum;\n    }\n  } else if (maximum !== undefined) {\n    // No exclusiveMaximum, just maximum\n    result['maximum'] = maximum;\n  }\n\n  // Handle exclusiveMinimum conversion\n  if (typeof exclusiveMinimum === 'boolean') {\n    if (exclusiveMinimum && minimum !== undefined) {\n      // true + minimum present -> convert to numeric exclusiveMinimum\n      result['exclusiveMinimum'] = minimum;\n    } else if (minimum !== undefined) {\n      // false or true without minimum -> keep minimum only\n      result['minimum'] = minimum;\n    }\n    // Boolean exclusiveMinimum is never added (invalid in JSON Schema 7)\n  } else if (exclusiveMinimum !== undefined) {\n    // Already numeric (OpenAPI 3.1) - keep as is\n    result['exclusiveMinimum'] = exclusiveMinimum;\n    if (minimum !== undefined) {\n      result['minimum'] = minimum;\n    }\n  } else if (minimum !== undefined) {\n    // No exclusiveMinimum, just minimum\n    result['minimum'] = minimum;\n  }\n\n  // Recursively convert nested schemas to ensure all nested schemas are valid JSONSchema7\n  if (result['properties'] && typeof result['properties'] === 'object') {\n    const props: Record<string, JSONSchema7> = {};\n    for (const [key, value] of Object.entries(result['properties'] as Record<string, SchemaObject | ReferenceObject>)) {\n      props[key] = toJSONSchema7(value);\n    }\n    result['properties'] = props;\n  }\n\n  if (result['items']) {\n    if (Array.isArray(result['items'])) {\n      result['items'] = (result['items'] as (SchemaObject | ReferenceObject)[]).map(toJSONSchema7);\n    } else {\n      result['items'] = toJSONSchema7(result['items'] as SchemaObject | ReferenceObject);\n    }\n  }\n\n  if (result['additionalProperties'] && typeof result['additionalProperties'] === 'object') {\n    result['additionalProperties'] = toJSONSchema7(result['additionalProperties'] as SchemaObject | ReferenceObject);\n  }\n\n  for (const key of ['allOf', 'anyOf', 'oneOf'] as const) {\n    if (result[key] && Array.isArray(result[key])) {\n      result[key] = (result[key] as (SchemaObject | ReferenceObject)[]).map(toJSONSchema7);\n    }\n  }\n\n  if (result['not']) {\n    result['not'] = toJSONSchema7(result['not'] as SchemaObject | ReferenceObject);\n  }\n\n  return result as JSONSchema7;\n}\n\n/**\n * Main MCP Tool definition generated from OpenAPI\n */\nexport interface McpOpenAPITool {\n  /**\n   * Unique tool name (from operationId or generated)\n   */\n  name: string;\n\n  /**\n   * Tool description (from operation summary/description)\n   */\n  description: string;\n\n  /**\n   * Combined input schema including all parameters\n   * (path, query, header, cookie, body)\n   */\n  inputSchema: JSONSchema7;\n\n  /**\n   * Output schema based on response definitions\n   * Can be a union of multiple status codes\n   */\n  outputSchema?: JSONSchema7;\n\n  /**\n   * Mapping from input schema properties to actual request parameters\n   */\n  mapper: ParameterMapper[];\n\n  /**\n   * Additional metadata about the tool\n   */\n  metadata: ToolMetadata;\n}\n\n/**\n * Maps input schema properties to their actual request locations\n */\nexport interface ParameterMapper {\n  /**\n   * Property name in the input schema\n   */\n  inputKey: string;\n\n  /**\n   * Where this parameter should be placed in the request\n   */\n  type: ParameterLocation;\n\n  /**\n   * Original parameter name (before conflict resolution)\n   */\n  key: string;\n\n  /**\n   * Whether this parameter is required\n   */\n  required?: boolean;\n\n  /**\n   * Parameter style (for path/query parameters)\n   */\n  style?: string;\n\n  /**\n   * Whether to explode arrays/objects\n   */\n  explode?: boolean;\n\n  /**\n   * Custom serialization info\n   */\n  serialization?: SerializationInfo;\n\n  /**\n   * Security scheme information (if this is an auth parameter)\n   * This allows frameworks to resolve auth from context, env vars, etc.\n   */\n  security?: SecurityParameterInfo;\n}\n\n/**\n * Serialization information for complex parameters\n */\nexport interface SerializationInfo {\n  /**\n   * Content type for body parameters\n   */\n  contentType?: string;\n\n  /**\n   * Encoding rules\n   */\n  encoding?: Record<string, EncodingObject>;\n}\n\n/**\n * Security parameter information for framework-agnostic auth resolution\n */\nexport interface SecurityParameterInfo {\n  /**\n   * Security scheme name from OpenAPI (e.g., \"BearerAuth\")\n   */\n  scheme: string;\n\n  /**\n   * Security type (apiKey, http, oauth2, openIdConnect)\n   */\n  type: AuthType;\n\n  /**\n   * HTTP authentication scheme (for type: \"http\")\n   * e.g., \"bearer\", \"basic\"\n   */\n  httpScheme?: string;\n\n  /**\n   * Bearer token format (e.g., \"JWT\")\n   */\n  bearerFormat?: string;\n\n  /**\n   * Required OAuth2 scopes\n   */\n  scopes?: string[];\n\n  /**\n   * API key parameter name (for type: \"apiKey\")\n   */\n  apiKeyName?: string;\n\n  /**\n   * API key location (for type: \"apiKey\")\n   */\n  apiKeyIn?: 'query' | 'header' | 'cookie';\n\n  /**\n   * Description of the security scheme\n   */\n  description?: string;\n}\n\n/**\n * Additional metadata about the generated tool\n */\nexport interface ToolMetadata {\n  /**\n   * Original OpenAPI path\n   */\n  path: string;\n\n  /**\n   * HTTP method\n   */\n  method: HTTPMethod;\n\n  /**\n   * Operation ID from OpenAPI\n   */\n  operationId?: string;\n\n  /**\n   * Tags from OpenAPI\n   */\n  tags?: string[];\n\n  /**\n   * Whether operation is deprecated\n   */\n  deprecated?: boolean;\n\n  /**\n   * Security requirements\n   */\n  security?: SecurityRequirement[];\n\n  /**\n   * Server information\n   */\n  servers?: ServerInfo[];\n\n  /**\n   * Response status codes included in output schema\n   */\n  responseStatusCodes?: number[];\n\n  /**\n   * External documentation\n   */\n  externalDocs?: ExternalDocumentationObject;\n}\n\n/**\n * Security requirement definition\n */\nexport interface SecurityRequirement {\n  /**\n   * Security scheme name\n   */\n  scheme: string;\n\n  /**\n   * Security type\n   */\n  type: AuthType;\n\n  /**\n   * Scopes required (for OAuth2/OpenID Connect)\n   */\n  scopes?: string[];\n\n  /**\n   * Parameter name (for API key)\n   */\n  name?: string;\n\n  /**\n   * Parameter location (for API key)\n   */\n  in?: 'query' | 'header' | 'cookie';\n\n  /**\n   * HTTP authentication scheme (for type: \"http\")\n   * e.g., \"bearer\", \"basic\"\n   */\n  httpScheme?: string;\n\n  /**\n   * Bearer token format (e.g., \"JWT\")\n   */\n  bearerFormat?: string;\n\n  /**\n   * Description of the security scheme\n   */\n  description?: string;\n}\n\n/**\n * Server information\n */\nexport interface ServerInfo {\n  /**\n   * Server URL\n   */\n  url: string;\n\n  /**\n   * Server description\n   */\n  description?: string;\n\n  /**\n   * Server variables\n   */\n  variables?: Record<string, ServerVariableObject>;\n}\n\n/**\n * Options for loading OpenAPI specifications\n */\nexport interface LoadOptions {\n  /**\n   * Whether to dereference $refs in schemas\n   * @default true\n   */\n  dereference?: boolean;\n\n  /**\n   * Base URL for API requests\n   * Overrides servers in OpenAPI spec\n   */\n  baseUrl?: string;\n\n  /**\n   * Custom HTTP headers for loading from URL\n   */\n  headers?: Record<string, string>;\n\n  /**\n   * Request timeout in milliseconds\n   * @default 30000\n   */\n  timeout?: number;\n\n  /**\n   * Whether to validate the OpenAPI document\n   * @default true\n   */\n  validate?: boolean;\n\n  /**\n   * Whether to follow HTTP redirects\n   * @default true\n   */\n  followRedirects?: boolean;\n}\n\n/**\n * Operation object with additional context for filtering\n */\nexport type OperationWithContext = OperationObject & {\n  path: string;\n  method: string;\n};\n\n/**\n * Options for generating tools\n */\nexport interface GenerateOptions {\n  /**\n   * Include only these operation IDs\n   */\n  includeOperations?: string[];\n\n  /**\n   * Exclude these operation IDs\n   */\n  excludeOperations?: string[];\n\n  /**\n   * Custom filter function\n   */\n  filterFn?: (operation: OperationWithContext) => boolean;\n\n  /**\n   * Naming strategy for resolving conflicts\n   */\n  namingStrategy?: NamingStrategy;\n\n  /**\n   * Preferred response status codes (in order of preference)\n   * @default [200, 201, 204, 202, 203, 206]\n   */\n  preferredStatusCodes?: number[];\n\n  /**\n   * Whether to include deprecated operations\n   * @default false\n   */\n  includeDeprecated?: boolean;\n\n  /**\n   * Whether to include all response codes in output schema\n   * If false, only preferred status code is used\n   * @default true\n   */\n  includeAllResponses?: boolean;\n\n  /**\n   * Maximum depth for dereferencing schemas\n   * @default 10\n   */\n  maxSchemaDepth?: number;\n\n  /**\n   * Whether to include examples in schemas\n   * @default false\n   */\n  includeExamples?: boolean;\n\n  /**\n   * Whether to include security requirements as input parameters\n   * If false, security is only in mapper (frameworks resolve from context/env/etc.)\n   * If true, security is added to inputSchema as explicit parameters\n   * @default false\n   */\n  includeSecurityInInput?: boolean;\n}\n\n/**\n * Naming strategy for resolving parameter conflicts\n */\nexport interface NamingStrategy {\n  /**\n   * Resolver function for parameter name conflicts\n   * @param paramName - Original parameter name\n   * @param location - Parameter location\n   * @param index - Index of conflicting parameter (0-based)\n   * @returns New parameter name\n   */\n  conflictResolver: (paramName: string, location: ParameterLocation, index: number) => string;\n\n  /**\n   * Function to generate tool names\n   * @param path - OpenAPI path\n   * @param method - HTTP method\n   * @param operationId - Operation ID if available\n   * @returns Tool name\n   */\n  toolNameGenerator?: (path: string, method: HTTPMethod, operationId?: string) => string;\n}\n\n/**\n * Validation result\n */\nexport interface ValidationResult {\n  /**\n   * Whether the document is valid\n   */\n  valid: boolean;\n\n  /**\n   * Validation errors\n   */\n  errors?: ValidationErrorDetail[];\n\n  /**\n   * Validation warnings\n   */\n  warnings?: ValidationWarning[];\n}\n\n/**\n * Validation error detail\n */\nexport interface ValidationErrorDetail {\n  /**\n   * Error message\n   */\n  message: string;\n\n  /**\n   * Error path (JSON pointer)\n   */\n  path?: string;\n\n  /**\n   * Error code\n   */\n  code?: string;\n}\n\n/**\n * Validation warning\n */\nexport interface ValidationWarning {\n  /**\n   * Warning message\n   */\n  message: string;\n\n  /**\n   * Warning path (JSON pointer)\n   */\n  path?: string;\n\n  /**\n   * Warning code\n   */\n  code?: string;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;AAyDA,8CAEC;AAOD,oCAqFC;AAjGD;;GAEG;AACH,SAAgB,iBAAiB,CAAC,GAAQ;IACxC,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,MAAsC;IACjE,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAgB,CAAC;IAC7C,CAAC;IAED,+DAA+D;IAC/D,2DAA2D;IAC3D,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAEjF,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IAEpD,qCAAqC;IACrC,IAAI,OAAO,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC1C,IAAI,gBAAgB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9C,gEAAgE;YAChE,MAAM,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC;QACvC,CAAC;aAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,qDAAqD;YACrD,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QAC9B,CAAC;QACD,qEAAqE;IACvE,CAAC;SAAM,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC1C,6CAA6C;QAC7C,MAAM,CAAC,kBAAkB,CAAC,GAAG,gBAAgB,CAAC;QAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QAC9B,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,oCAAoC;QACpC,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,qCAAqC;IACrC,IAAI,OAAO,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC1C,IAAI,gBAAgB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9C,gEAAgE;YAChE,MAAM,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC;QACvC,CAAC;aAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,qDAAqD;YACrD,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QAC9B,CAAC;QACD,qEAAqE;IACvE,CAAC;SAAM,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC1C,6CAA6C;QAC7C,MAAM,CAAC,kBAAkB,CAAC,GAAG,gBAAgB,CAAC;QAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QAC9B,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,oCAAoC;QACpC,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,uFAAuF;IACvF,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,MAAM,CAAC,YAAY,CAAC,KAAK,QAAQ,EAAE,CAAC;QACrE,MAAM,KAAK,GAA+B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAmD,CAAC,EAAE,CAAC;YAClH,KAAK,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,OAAO,CAAC,GAAI,MAAM,CAAC,OAAO,CAAwC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC9F,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAmC,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,sBAAsB,CAAC,IAAI,OAAO,MAAM,CAAC,sBAAsB,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzF,MAAM,CAAC,sBAAsB,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,sBAAsB,CAAmC,CAAC,CAAC;IAClH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAU,EAAE,CAAC;QACvD,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,GAAG,CAAC,GAAI,MAAM,CAAC,GAAG,CAAwC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAClB,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAmC,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,MAAoB,CAAC;AAC9B,CAAC","sourcesContent":["import type { JSONSchema } from 'zod/v4/core';\n\n/** JSON Schema type from Zod v4 */\ntype JsonSchema = JSONSchema.JSONSchema;\nimport type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';\n\n/**\n * OpenAPI specification version 3.0.x or 3.1.x\n */\nexport type OpenAPIVersion = '3.0.0' | '3.0.1' | '3.0.2' | '3.0.3' | '3.1.0';\n\n/**\n * Unified OpenAPI Document type (supports both 3.0 and 3.1)\n */\nexport type OpenAPIDocument = OpenAPIV3.Document | OpenAPIV3_1.Document;\n\n/**\n * HTTP methods supported by OpenAPI\n */\nexport type HTTPMethod = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'head' | 'options' | 'trace';\n\n/**\n * Parameter location types\n */\nexport type ParameterLocation = 'path' | 'query' | 'header' | 'cookie' | 'body';\n\n/**\n * Authentication types supported\n */\nexport type AuthType = 'apiKey' | 'http' | 'oauth2' | 'openIdConnect' | 'mutualTLS';\n\n// Re-export OpenAPI types for convenience\nexport type OperationObject = OpenAPIV3.OperationObject | OpenAPIV3_1.OperationObject;\nexport type ParameterObject = OpenAPIV3.ParameterObject | OpenAPIV3_1.ParameterObject;\nexport type RequestBodyObject = OpenAPIV3.RequestBodyObject | OpenAPIV3_1.RequestBodyObject;\nexport type ResponseObject = OpenAPIV3.ResponseObject | OpenAPIV3_1.ResponseObject;\nexport type ResponsesObject = OpenAPIV3.ResponsesObject | OpenAPIV3_1.ResponsesObject;\nexport type MediaTypeObject = OpenAPIV3.MediaTypeObject | OpenAPIV3_1.MediaTypeObject;\nexport type HeaderObject = OpenAPIV3.HeaderObject | OpenAPIV3_1.HeaderObject;\nexport type ExampleObject = OpenAPIV3.ExampleObject | OpenAPIV3_1.ExampleObject;\nexport type PathItemObject = OpenAPIV3.PathItemObject | OpenAPIV3_1.PathItemObject;\nexport type PathsObject = OpenAPIV3.PathsObject | OpenAPIV3_1.PathsObject;\nexport type ServerObject = OpenAPIV3.ServerObject | OpenAPIV3_1.ServerObject;\nexport type SecuritySchemeObject = OpenAPIV3.SecuritySchemeObject | OpenAPIV3_1.SecuritySchemeObject;\nexport type ReferenceObject = OpenAPIV3.ReferenceObject | OpenAPIV3_1.ReferenceObject;\nexport type TagObject = OpenAPIV3.TagObject | OpenAPIV3_1.TagObject;\nexport type ExternalDocumentationObject =\n  | OpenAPIV3.ExternalDocumentationObject\n  | OpenAPIV3_1.ExternalDocumentationObject;\nexport type ServerVariableObject = OpenAPIV3.ServerVariableObject | OpenAPIV3_1.ServerVariableObject;\nexport type EncodingObject = OpenAPIV3.EncodingObject | OpenAPIV3_1.EncodingObject;\nexport type SecurityRequirementObject = OpenAPIV3.SecurityRequirementObject | OpenAPIV3_1.SecurityRequirementObject;\nexport type SchemaObject = OpenAPIV3.SchemaObject | OpenAPIV3_1.SchemaObject;\n\n/**\n * Helper to check if an object is a ReferenceObject\n */\nexport function isReferenceObject(obj: any): obj is ReferenceObject {\n  return obj && typeof obj === 'object' && '$ref' in obj;\n}\n\n/**\n * Convert OpenAPI schema to JsonSchema\n * Note: OpenAPI 3.0 uses a subset of JSON Schema Draft 4\n * OpenAPI 3.1 uses JSON Schema Draft 2020-12\n */\nexport function toJsonSchema(schema: SchemaObject | ReferenceObject): JsonSchema {\n  if (isReferenceObject(schema)) {\n    return { $ref: schema.$ref } as JsonSchema;\n  }\n\n  // Handle OpenAPI 3.0 boolean exclusiveMaximum/exclusiveMinimum\n  // by converting them to JSON Schema Draft 7 numeric format\n  const { exclusiveMaximum, exclusiveMinimum, maximum, minimum, ...rest } = schema;\n\n  const result: Record<string, unknown> = { ...rest };\n\n  // Handle exclusiveMaximum conversion\n  if (typeof exclusiveMaximum === 'boolean') {\n    if (exclusiveMaximum && maximum !== undefined) {\n      // true + maximum present -> convert to numeric exclusiveMaximum\n      result['exclusiveMaximum'] = maximum;\n    } else if (maximum !== undefined) {\n      // false or true without maximum -> keep maximum only\n      result['maximum'] = maximum;\n    }\n    // Boolean exclusiveMaximum is never added (invalid in JSON Schema 7)\n  } else if (exclusiveMaximum !== undefined) {\n    // Already numeric (OpenAPI 3.1) - keep as is\n    result['exclusiveMaximum'] = exclusiveMaximum;\n    if (maximum !== undefined) {\n      result['maximum'] = maximum;\n    }\n  } else if (maximum !== undefined) {\n    // No exclusiveMaximum, just maximum\n    result['maximum'] = maximum;\n  }\n\n  // Handle exclusiveMinimum conversion\n  if (typeof exclusiveMinimum === 'boolean') {\n    if (exclusiveMinimum && minimum !== undefined) {\n      // true + minimum present -> convert to numeric exclusiveMinimum\n      result['exclusiveMinimum'] = minimum;\n    } else if (minimum !== undefined) {\n      // false or true without minimum -> keep minimum only\n      result['minimum'] = minimum;\n    }\n    // Boolean exclusiveMinimum is never added (invalid in JSON Schema 7)\n  } else if (exclusiveMinimum !== undefined) {\n    // Already numeric (OpenAPI 3.1) - keep as is\n    result['exclusiveMinimum'] = exclusiveMinimum;\n    if (minimum !== undefined) {\n      result['minimum'] = minimum;\n    }\n  } else if (minimum !== undefined) {\n    // No exclusiveMinimum, just minimum\n    result['minimum'] = minimum;\n  }\n\n  // Recursively convert nested schemas to ensure all nested schemas are valid JsonSchema\n  if (result['properties'] && typeof result['properties'] === 'object') {\n    const props: Record<string, JsonSchema> = {};\n    for (const [key, value] of Object.entries(result['properties'] as Record<string, SchemaObject | ReferenceObject>)) {\n      props[key] = toJsonSchema(value);\n    }\n    result['properties'] = props;\n  }\n\n  if (result['items']) {\n    if (Array.isArray(result['items'])) {\n      result['items'] = (result['items'] as (SchemaObject | ReferenceObject)[]).map(toJsonSchema);\n    } else {\n      result['items'] = toJsonSchema(result['items'] as SchemaObject | ReferenceObject);\n    }\n  }\n\n  if (result['additionalProperties'] && typeof result['additionalProperties'] === 'object') {\n    result['additionalProperties'] = toJsonSchema(result['additionalProperties'] as SchemaObject | ReferenceObject);\n  }\n\n  for (const key of ['allOf', 'anyOf', 'oneOf'] as const) {\n    if (result[key] && Array.isArray(result[key])) {\n      result[key] = (result[key] as (SchemaObject | ReferenceObject)[]).map(toJsonSchema);\n    }\n  }\n\n  if (result['not']) {\n    result['not'] = toJsonSchema(result['not'] as SchemaObject | ReferenceObject);\n  }\n\n  return result as JsonSchema;\n}\n\n/**\n * Main MCP Tool definition generated from OpenAPI\n */\nexport interface McpOpenAPITool {\n  /**\n   * Unique tool name (from operationId or generated)\n   */\n  name: string;\n\n  /**\n   * Tool description (from operation summary/description)\n   */\n  description: string;\n\n  /**\n   * Combined input schema including all parameters\n   * (path, query, header, cookie, body)\n   */\n  inputSchema: JsonSchema;\n\n  /**\n   * Output schema based on response definitions\n   * Can be a union of multiple status codes\n   */\n  outputSchema?: JsonSchema;\n\n  /**\n   * Mapping from input schema properties to actual request parameters\n   */\n  mapper: ParameterMapper[];\n\n  /**\n   * Additional metadata about the tool\n   */\n  metadata: ToolMetadata;\n}\n\n/**\n * Maps input schema properties to their actual request locations\n */\nexport interface ParameterMapper {\n  /**\n   * Property name in the input schema\n   */\n  inputKey: string;\n\n  /**\n   * Where this parameter should be placed in the request\n   */\n  type: ParameterLocation;\n\n  /**\n   * Original parameter name (before conflict resolution)\n   */\n  key: string;\n\n  /**\n   * Whether this parameter is required\n   */\n  required?: boolean;\n\n  /**\n   * Parameter style (for path/query parameters)\n   */\n  style?: string;\n\n  /**\n   * Whether to explode arrays/objects\n   */\n  explode?: boolean;\n\n  /**\n   * Custom serialization info\n   */\n  serialization?: SerializationInfo;\n\n  /**\n   * Security scheme information (if this is an auth parameter)\n   * This allows frameworks to resolve auth from context, env vars, etc.\n   */\n  security?: SecurityParameterInfo;\n}\n\n/**\n * Serialization information for complex parameters\n */\nexport interface SerializationInfo {\n  /**\n   * Content type for body parameters\n   */\n  contentType?: string;\n\n  /**\n   * Encoding rules\n   */\n  encoding?: Record<string, EncodingObject>;\n}\n\n/**\n * Security parameter information for framework-agnostic auth resolution\n */\nexport interface SecurityParameterInfo {\n  /**\n   * Security scheme name from OpenAPI (e.g., \"BearerAuth\")\n   */\n  scheme: string;\n\n  /**\n   * Security type (apiKey, http, oauth2, openIdConnect)\n   */\n  type: AuthType;\n\n  /**\n   * HTTP authentication scheme (for type: \"http\")\n   * e.g., \"bearer\", \"basic\"\n   */\n  httpScheme?: string;\n\n  /**\n   * Bearer token format (e.g., \"JWT\")\n   */\n  bearerFormat?: string;\n\n  /**\n   * Required OAuth2 scopes\n   */\n  scopes?: string[];\n\n  /**\n   * API key parameter name (for type: \"apiKey\")\n   */\n  apiKeyName?: string;\n\n  /**\n   * API key location (for type: \"apiKey\")\n   */\n  apiKeyIn?: 'query' | 'header' | 'cookie';\n\n  /**\n   * Description of the security scheme\n   */\n  description?: string;\n}\n\n/**\n * Additional metadata about the generated tool\n */\nexport interface ToolMetadata {\n  /**\n   * Original OpenAPI path\n   */\n  path: string;\n\n  /**\n   * HTTP method\n   */\n  method: HTTPMethod;\n\n  /**\n   * Operation ID from OpenAPI\n   */\n  operationId?: string;\n\n  /**\n   * Operation summary from OpenAPI (short description)\n   */\n  operationSummary?: string;\n\n  /**\n   * Operation description from OpenAPI (detailed description)\n   */\n  operationDescription?: string;\n\n  /**\n   * Tags from OpenAPI\n   */\n  tags?: string[];\n\n  /**\n   * Whether operation is deprecated\n   */\n  deprecated?: boolean;\n\n  /**\n   * Security requirements\n   */\n  security?: SecurityRequirement[];\n\n  /**\n   * Server information\n   */\n  servers?: ServerInfo[];\n\n  /**\n   * Response status codes included in output schema\n   */\n  responseStatusCodes?: number[];\n\n  /**\n   * External documentation\n   */\n  externalDocs?: ExternalDocumentationObject;\n\n  /**\n   * FrontMCP extension data from x-frontmcp in the OpenAPI operation.\n   * Contains annotations, cache config, codecall config, tags, etc.\n   */\n  frontmcp?: FrontMcpExtensionData;\n}\n\n/**\n * FrontMCP extension data extracted from x-frontmcp in OpenAPI operations.\n * This provides declarative configuration for tools directly in the OpenAPI spec.\n */\nexport interface FrontMcpExtensionData {\n  /**\n   * Tool annotations for AI behavior hints.\n   */\n  annotations?: {\n    title?: string;\n    readOnlyHint?: boolean;\n    destructiveHint?: boolean;\n    idempotentHint?: boolean;\n    openWorldHint?: boolean;\n  };\n\n  /**\n   * Cache configuration for response caching.\n   */\n  cache?: {\n    ttl?: number;\n    slideWindow?: boolean;\n  };\n\n  /**\n   * CodeCall-specific configuration.\n   */\n  codecall?: {\n    enabledInCodeCall?: boolean;\n    visibleInListTools?: boolean;\n  };\n\n  /**\n   * Tags/labels for categorization.\n   */\n  tags?: string[];\n\n  /**\n   * If true, hide tool from discovery.\n   */\n  hideFromDiscovery?: boolean;\n\n  /**\n   * Usage examples.\n   */\n  examples?: Array<{\n    description: string;\n    input: Record<string, unknown>;\n    output?: unknown;\n  }>;\n}\n\n/**\n * Security requirement definition\n */\nexport interface SecurityRequirement {\n  /**\n   * Security scheme name\n   */\n  scheme: string;\n\n  /**\n   * Security type\n   */\n  type: AuthType;\n\n  /**\n   * Scopes required (for OAuth2/OpenID Connect)\n   */\n  scopes?: string[];\n\n  /**\n   * Parameter name (for API key)\n   */\n  name?: string;\n\n  /**\n   * Parameter location (for API key)\n   */\n  in?: 'query' | 'header' | 'cookie';\n\n  /**\n   * HTTP authentication scheme (for type: \"http\")\n   * e.g., \"bearer\", \"basic\"\n   */\n  httpScheme?: string;\n\n  /**\n   * Bearer token format (e.g., \"JWT\")\n   */\n  bearerFormat?: string;\n\n  /**\n   * Description of the security scheme\n   */\n  description?: string;\n}\n\n/**\n * Server information\n */\nexport interface ServerInfo {\n  /**\n   * Server URL\n   */\n  url: string;\n\n  /**\n   * Server description\n   */\n  description?: string;\n\n  /**\n   * Server variables\n   */\n  variables?: Record<string, ServerVariableObject>;\n}\n\n/**\n * Options for loading OpenAPI specifications\n */\nexport interface LoadOptions {\n  /**\n   * Whether to dereference $refs in schemas\n   * @default true\n   */\n  dereference?: boolean;\n\n  /**\n   * Base URL for API requests\n   * Overrides servers in OpenAPI spec\n   */\n  baseUrl?: string;\n\n  /**\n   * Custom HTTP headers for loading from URL\n   */\n  headers?: Record<string, string>;\n\n  /**\n   * Request timeout in milliseconds\n   * @default 30000\n   */\n  timeout?: number;\n\n  /**\n   * Whether to validate the OpenAPI document\n   * @default true\n   */\n  validate?: boolean;\n\n  /**\n   * Whether to follow HTTP redirects\n   * @default true\n   */\n  followRedirects?: boolean;\n}\n\n/**\n * Operation object with additional context for filtering\n */\nexport type OperationWithContext = OperationObject & {\n  path: string;\n  method: string;\n};\n\n/**\n * Options for generating tools\n */\nexport interface GenerateOptions {\n  /**\n   * Include only these operation IDs\n   */\n  includeOperations?: string[];\n\n  /**\n   * Exclude these operation IDs\n   */\n  excludeOperations?: string[];\n\n  /**\n   * Custom filter function\n   */\n  filterFn?: (operation: OperationWithContext) => boolean;\n\n  /**\n   * Naming strategy for resolving conflicts\n   */\n  namingStrategy?: NamingStrategy;\n\n  /**\n   * Preferred response status codes (in order of preference)\n   * @default [200, 201, 204, 202, 203, 206]\n   */\n  preferredStatusCodes?: number[];\n\n  /**\n   * Whether to include deprecated operations\n   * @default false\n   */\n  includeDeprecated?: boolean;\n\n  /**\n   * Whether to include all response codes in output schema\n   * If false, only preferred status code is used\n   * @default true\n   */\n  includeAllResponses?: boolean;\n\n  /**\n   * Maximum depth for dereferencing schemas\n   * @default 10\n   */\n  maxSchemaDepth?: number;\n\n  /**\n   * Whether to include examples in schemas\n   * @default false\n   */\n  includeExamples?: boolean;\n\n  /**\n   * Whether to include security requirements as input parameters\n   * If false, security is only in mapper (frameworks resolve from context/env/etc.)\n   * If true, security is added to inputSchema as explicit parameters\n   * @default false\n   */\n  includeSecurityInInput?: boolean;\n}\n\n/**\n * Naming strategy for resolving parameter conflicts\n */\nexport interface NamingStrategy {\n  /**\n   * Resolver function for parameter name conflicts\n   * @param paramName - Original parameter name\n   * @param location - Parameter location\n   * @param index - Index of conflicting parameter (0-based)\n   * @returns New parameter name\n   */\n  conflictResolver: (paramName: string, location: ParameterLocation, index: number) => string;\n\n  /**\n   * Function to generate tool names\n   * @param path - OpenAPI path\n   * @param method - HTTP method\n   * @param operationId - Operation ID if available\n   * @returns Tool name\n   */\n  toolNameGenerator?: (path: string, method: HTTPMethod, operationId?: string) => string;\n}\n\n/**\n * Validation result\n */\nexport interface ValidationResult {\n  /**\n   * Whether the document is valid\n   */\n  valid: boolean;\n\n  /**\n   * Validation errors\n   */\n  errors?: ValidationErrorDetail[];\n\n  /**\n   * Validation warnings\n   */\n  warnings?: ValidationWarning[];\n}\n\n/**\n * Validation error detail\n */\nexport interface ValidationErrorDetail {\n  /**\n   * Error message\n   */\n  message: string;\n\n  /**\n   * Error path (JSON pointer)\n   */\n  path?: string;\n\n  /**\n   * Error code\n   */\n  code?: string;\n}\n\n/**\n * Validation warning\n */\nexport interface ValidationWarning {\n  /**\n   * Warning message\n   */\n  message: string;\n\n  /**\n   * Warning path (JSON pointer)\n   */\n  path?: string;\n\n  /**\n   * Warning code\n   */\n  code?: string;\n}\n"]}