mcp-from-openapi 0.0.1

package/src/schema-builder.js

@@ -0,0 +1,296 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaBuilder = void 0;
+/**
+ * Helper class for building and manipulating JSON schemas
+ */
+class SchemaBuilder {
+    /**
+     * Merge multiple schemas into one
+     */
+    static merge(schemas) {
+        if (schemas.length === 0) {
+            return { type: 'object' };
+        }
+        if (schemas.length === 1) {
+            return schemas[0];
+        }
+        const merged = {
+            type: 'object',
+            properties: {},
+            required: [],
+        };
+        const allRequired = new Set();
+        for (const schema of schemas) {
+            if (schema.properties) {
+                merged.properties = {
+                    ...merged.properties,
+                    ...schema.properties,
+                };
+            }
+            if (schema.required) {
+                schema.required.forEach((field) => allRequired.add(field));
+            }
+        }
+        if (allRequired.size > 0) {
+            merged.required = Array.from(allRequired);
+        }
+        return merged;
+    }
+    /**
+     * Create a union schema (oneOf)
+     */
+    static union(schemas) {
+        if (schemas.length === 0) {
+            return {};
+        }
+        if (schemas.length === 1) {
+            return schemas[0];
+        }
+        return {
+            oneOf: schemas,
+        };
+    }
+    /**
+     * Deep clone a schema
+     */
+    static clone(schema) {
+        return JSON.parse(JSON.stringify(schema));
+    }
+    /**
+     * Remove $ref from schema (assumes already dereferenced)
+     */
+    static removeRefs(schema) {
+        const cloned = this.clone(schema);
+        this.removeRefsRecursive(cloned);
+        return cloned;
+    }
+    static removeRefsRecursive(obj) {
+        if (!obj || typeof obj !== 'object')
+            return;
+        if (obj.$ref) {
+            delete obj.$ref;
+        }
+        for (const key in obj) {
+            if (obj.hasOwnProperty(key)) {
+                const value = obj[key];
+                if (value && typeof value === 'object') {
+                    this.removeRefsRecursive(value);
+                }
+            }
+        }
+    }
+    /**
+     * Add description to schema
+     */
+    static withDescription(schema, description) {
+        return {
+            ...schema,
+            description,
+        };
+    }
+    /**
+     * Mark schema as required
+     */
+    static required(schema) {
+        return schema;
+    }
+    /**
+     * Mark schema as optional
+     */
+    static optional(schema) {
+        return schema;
+    }
+    /**
+     * Add example to schema
+     */
+    static withExample(schema, example) {
+        const existingExamples = Array.isArray(schema.examples) ? schema.examples : [];
+        return {
+            ...schema,
+            examples: [...existingExamples, example],
+        };
+    }
+    /**
+     * Add default value to schema
+     */
+    static withDefault(schema, defaultValue) {
+        return {
+            ...schema,
+            default: defaultValue,
+        };
+    }
+    /**
+     * Add format to schema
+     */
+    static withFormat(schema, format) {
+        return {
+            ...schema,
+            format,
+        };
+    }
+    /**
+     * Add pattern to schema
+     */
+    static withPattern(schema, pattern) {
+        return {
+            ...schema,
+            pattern,
+        };
+    }
+    /**
+     * Add enum to schema
+     */
+    static withEnum(schema, values) {
+        return {
+            ...schema,
+            enum: values,
+        };
+    }
+    /**
+     * Add minimum/maximum constraints
+     */
+    static withRange(schema, min, max, options = {}) {
+        const result = { ...schema };
+        if (min !== undefined) {
+            if (options.exclusive) {
+                result.exclusiveMinimum = min;
+            }
+            else {
+                result.minimum = min;
+            }
+        }
+        if (max !== undefined) {
+            if (options.exclusive) {
+                result.exclusiveMaximum = max;
+            }
+            else {
+                result.maximum = max;
+            }
+        }
+        return result;
+    }
+    /**
+     * Add minLength/maxLength constraints
+     */
+    static withLength(schema, minLength, maxLength) {
+        const result = { ...schema };
+        if (minLength !== undefined) {
+            result.minLength = minLength;
+        }
+        if (maxLength !== undefined) {
+            result.maxLength = maxLength;
+        }
+        return result;
+    }
+    /**
+     * Create object schema
+     */
+    static object(properties, required) {
+        return {
+            type: 'object',
+            properties,
+            ...(required && required.length > 0 && { required }),
+            additionalProperties: false,
+        };
+    }
+    /**
+     * Create array schema
+     */
+    static array(items, constraints) {
+        return {
+            type: 'array',
+            items,
+            ...constraints,
+        };
+    }
+    /**
+     * Create string schema
+     */
+    static string(constraints) {
+        return {
+            type: 'string',
+            ...constraints,
+        };
+    }
+    /**
+     * Create number schema
+     */
+    static number(constraints) {
+        return {
+            type: 'number',
+            ...constraints,
+        };
+    }
+    /**
+     * Create integer schema
+     */
+    static integer(constraints) {
+        return {
+            type: 'integer',
+            ...constraints,
+        };
+    }
+    /**
+     * Create boolean schema
+     */
+    static boolean() {
+        return {
+            type: 'boolean',
+        };
+    }
+    /**
+     * Create null schema
+     */
+    static null() {
+        return {
+            type: 'null',
+        };
+    }
+    /**
+     * Flatten nested oneOf/anyOf/allOf schemas
+     */
+    static flatten(schema, maxDepth = 10) {
+        if (maxDepth <= 0)
+            return schema;
+        const cloned = this.clone(schema);
+        if (cloned.oneOf) {
+            const flattened = cloned.oneOf.flatMap((s) => {
+                const sub = this.flatten(s, maxDepth - 1);
+                return sub.oneOf ? sub.oneOf : [sub];
+            });
+            cloned.oneOf = flattened;
+        }
+        if (cloned.anyOf) {
+            const flattened = cloned.anyOf.flatMap((s) => {
+                const sub = this.flatten(s, maxDepth - 1);
+                return sub.anyOf ? sub.anyOf : [sub];
+            });
+            cloned.anyOf = flattened;
+        }
+        return cloned;
+    }
+    /**
+     * Simplify schema by removing unnecessary fields
+     */
+    static simplify(schema) {
+        const cloned = this.clone(schema);
+        // Remove empty arrays/objects
+        if (Array.isArray(cloned.required) && cloned.required.length === 0) {
+            delete cloned.required;
+        }
+        if (cloned.properties && Object.keys(cloned.properties).length === 0) {
+            delete cloned.properties;
+        }
+        if (Array.isArray(cloned.examples) && cloned.examples.length === 0) {
+            delete cloned.examples;
+        }
+        // Remove title if it matches description
+        if (cloned.title && cloned.description && cloned.title === cloned.description) {
+            delete cloned.title;
+        }
+        return cloned;
+    }
+}
+exports.SchemaBuilder = SchemaBuilder;
+//# sourceMappingURL=schema-builder.js.map

package/src/schema-builder.js.map

@@ -0,0 +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 (obj.hasOwnProperty(key)) {\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   * Mark schema as required\n   */\n  static required(schema: JSONSchema7): JSONSchema7 {\n    return schema;\n  }\n\n  /**\n   * Mark schema as optional\n   */\n  static optional(schema: JSONSchema7): JSONSchema7 {\n    return schema;\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    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"]}

package/src/types.d.ts

@@ -0,0 +1,371 @@
+import type { JSONSchema7 } from 'json-schema';
+import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
+/**
+ * OpenAPI specification version 3.0.x or 3.1.x
+ */
+export type OpenAPIVersion = '3.0.0' | '3.0.1' | '3.0.2' | '3.0.3' | '3.1.0';
+/**
+ * Unified OpenAPI Document type (supports both 3.0 and 3.1)
+ */
+export type OpenAPIDocument = OpenAPIV3.Document | OpenAPIV3_1.Document;
+/**
+ * HTTP methods supported by OpenAPI
+ */
+export type HTTPMethod = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'head' | 'options' | 'trace';
+/**
+ * Parameter location types
+ */
+export type ParameterLocation = 'path' | 'query' | 'header' | 'cookie' | 'body';
+/**
+ * Authentication types supported
+ */
+export type AuthType = 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+export type OperationObject = OpenAPIV3.OperationObject | OpenAPIV3_1.OperationObject;
+export type ParameterObject = OpenAPIV3.ParameterObject | OpenAPIV3_1.ParameterObject;
+export type RequestBodyObject = OpenAPIV3.RequestBodyObject | OpenAPIV3_1.RequestBodyObject;
+export type ResponseObject = OpenAPIV3.ResponseObject | OpenAPIV3_1.ResponseObject;
+export type ResponsesObject = OpenAPIV3.ResponsesObject | OpenAPIV3_1.ResponsesObject;
+export type MediaTypeObject = OpenAPIV3.MediaTypeObject | OpenAPIV3_1.MediaTypeObject;
+export type HeaderObject = OpenAPIV3.HeaderObject | OpenAPIV3_1.HeaderObject;
+export type ExampleObject = OpenAPIV3.ExampleObject | OpenAPIV3_1.ExampleObject;
+export type PathItemObject = OpenAPIV3.PathItemObject | OpenAPIV3_1.PathItemObject;
+export type PathsObject = OpenAPIV3.PathsObject | OpenAPIV3_1.PathsObject;
+export type ServerObject = OpenAPIV3.ServerObject | OpenAPIV3_1.ServerObject;
+export type SecuritySchemeObject = OpenAPIV3.SecuritySchemeObject | OpenAPIV3_1.SecuritySchemeObject;
+export type ReferenceObject = OpenAPIV3.ReferenceObject | OpenAPIV3_1.ReferenceObject;
+export type TagObject = OpenAPIV3.TagObject | OpenAPIV3_1.TagObject;
+export type ExternalDocumentationObject = OpenAPIV3.ExternalDocumentationObject | OpenAPIV3_1.ExternalDocumentationObject;
+export type ServerVariableObject = OpenAPIV3.ServerVariableObject | OpenAPIV3_1.ServerVariableObject;
+export type EncodingObject = OpenAPIV3.EncodingObject | OpenAPIV3_1.EncodingObject;
+export type SecurityRequirementObject = OpenAPIV3.SecurityRequirementObject | OpenAPIV3_1.SecurityRequirementObject;
+export type SchemaObject = OpenAPIV3.SchemaObject | OpenAPIV3_1.SchemaObject;
+/**
+ * Helper to check if an object is a ReferenceObject
+ */
+export declare function isReferenceObject(obj: any): obj is ReferenceObject;
+/**
+ * Convert OpenAPI schema to JSONSchema7
+ * 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;
+/**
+ * Main MCP Tool definition generated from OpenAPI
+ */
+export interface McpOpenAPITool {
+    /**
+     * Unique tool name (from operationId or generated)
+     */
+    name: string;
+    /**
+     * Tool description (from operation summary/description)
+     */
+    description: string;
+    /**
+     * Combined input schema including all parameters
+     * (path, query, header, cookie, body)
+     */
+    inputSchema: JSONSchema7;
+    /**
+     * Output schema based on response definitions
+     * Can be a union of multiple status codes
+     */
+    outputSchema?: JSONSchema7;
+    /**
+     * Mapping from input schema properties to actual request parameters
+     */
+    mapper: ParameterMapper[];
+    /**
+     * Additional metadata about the tool
+     */
+    metadata: ToolMetadata;
+}
+/**
+ * Maps input schema properties to their actual request locations
+ */
+export interface ParameterMapper {
+    /**
+     * Property name in the input schema
+     */
+    inputKey: string;
+    /**
+     * Where this parameter should be placed in the request
+     */
+    type: ParameterLocation;
+    /**
+     * Original parameter name (before conflict resolution)
+     */
+    key: string;
+    /**
+     * Whether this parameter is required
+     */
+    required?: boolean;
+    /**
+     * Parameter style (for path/query parameters)
+     */
+    style?: string;
+    /**
+     * Whether to explode arrays/objects
+     */
+    explode?: boolean;
+    /**
+     * Custom serialization info
+     */
+    serialization?: SerializationInfo;
+}
+/**
+ * Serialization information for complex parameters
+ */
+export interface SerializationInfo {
+    /**
+     * Content type for body parameters
+     */
+    contentType?: string;
+    /**
+     * Encoding rules
+     */
+    encoding?: Record<string, EncodingObject>;
+}
+/**
+ * Additional metadata about the generated tool
+ */
+export interface ToolMetadata {
+    /**
+     * Original OpenAPI path
+     */
+    path: string;
+    /**
+     * HTTP method
+     */
+    method: HTTPMethod;
+    /**
+     * Operation ID from OpenAPI
+     */
+    operationId?: string;
+    /**
+     * Tags from OpenAPI
+     */
+    tags?: string[];
+    /**
+     * Whether operation is deprecated
+     */
+    deprecated?: boolean;
+    /**
+     * Security requirements
+     */
+    security?: SecurityRequirement[];
+    /**
+     * Server information
+     */
+    servers?: ServerInfo[];
+    /**
+     * Response status codes included in output schema
+     */
+    responseStatusCodes?: number[];
+    /**
+     * External documentation
+     */
+    externalDocs?: ExternalDocumentationObject;
+}
+/**
+ * Security requirement definition
+ */
+export interface SecurityRequirement {
+    /**
+     * Security scheme name
+     */
+    scheme: string;
+    /**
+     * Security type
+     */
+    type: AuthType;
+    /**
+     * Scopes required (for OAuth2/OpenID Connect)
+     */
+    scopes?: string[];
+    /**
+     * Parameter name (for API key)
+     */
+    name?: string;
+    /**
+     * Parameter location (for API key)
+     */
+    in?: 'query' | 'header' | 'cookie';
+}
+/**
+ * Server information
+ */
+export interface ServerInfo {
+    /**
+     * Server URL
+     */
+    url: string;
+    /**
+     * Server description
+     */
+    description?: string;
+    /**
+     * Server variables
+     */
+    variables?: Record<string, ServerVariableObject>;
+}
+/**
+ * Options for loading OpenAPI specifications
+ */
+export interface LoadOptions {
+    /**
+     * Whether to dereference $refs in schemas
+     * @default true
+     */
+    dereference?: boolean;
+    /**
+     * Base URL for API requests
+     * Overrides servers in OpenAPI spec
+     */
+    baseUrl?: string;
+    /**
+     * Custom HTTP headers for loading from URL
+     */
+    headers?: Record<string, string>;
+    /**
+     * Request timeout in milliseconds
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Whether to validate the OpenAPI document
+     * @default true
+     */
+    validate?: boolean;
+    /**
+     * Whether to follow HTTP redirects
+     * @default true
+     */
+    followRedirects?: boolean;
+}
+/**
+ * Operation object with additional context for filtering
+ */
+export type OperationWithContext = OperationObject & {
+    path: string;
+    method: string;
+};
+/**
+ * Options for generating tools
+ */
+export interface GenerateOptions {
+    /**
+     * Include only these operation IDs
+     */
+    includeOperations?: string[];
+    /**
+     * Exclude these operation IDs
+     */
+    excludeOperations?: string[];
+    /**
+     * Custom filter function
+     */
+    filterFn?: (operation: OperationWithContext) => boolean;
+    /**
+     * Naming strategy for resolving conflicts
+     */
+    namingStrategy?: NamingStrategy;
+    /**
+     * Preferred response status codes (in order of preference)
+     * @default [200, 201, 204, 202, 203, 206]
+     */
+    preferredStatusCodes?: number[];
+    /**
+     * Whether to include deprecated operations
+     * @default false
+     */
+    includeDeprecated?: boolean;
+    /**
+     * Whether to include all response codes in output schema
+     * If false, only preferred status code is used
+     * @default true
+     */
+    includeAllResponses?: boolean;
+    /**
+     * Maximum depth for dereferencing schemas
+     * @default 10
+     */
+    maxSchemaDepth?: number;
+    /**
+     * Whether to include examples in schemas
+     * @default false
+     */
+    includeExamples?: boolean;
+}
+/**
+ * Naming strategy for resolving parameter conflicts
+ */
+export interface NamingStrategy {
+    /**
+     * Resolver function for parameter name conflicts
+     * @param paramName - Original parameter name
+     * @param location - Parameter location
+     * @param index - Index of conflicting parameter (0-based)
+     * @returns New parameter name
+     */
+    conflictResolver: (paramName: string, location: ParameterLocation, index: number) => string;
+    /**
+     * Function to generate tool names
+     * @param path - OpenAPI path
+     * @param method - HTTP method
+     * @param operationId - Operation ID if available
+     * @returns Tool name
+     */
+    toolNameGenerator?: (path: string, method: HTTPMethod, operationId?: string) => string;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    /**
+     * Whether the document is valid
+     */
+    valid: boolean;
+    /**
+     * Validation errors
+     */
+    errors?: ValidationErrorDetail[];
+    /**
+     * Validation warnings
+     */
+    warnings?: ValidationWarning[];
+}
+/**
+ * Validation error detail
+ */
+export interface ValidationErrorDetail {
+    /**
+     * Error message
+     */
+    message: string;
+    /**
+     * Error path (JSON pointer)
+     */
+    path?: string;
+    /**
+     * Error code
+     */
+    code?: string;
+}
+/**
+ * Validation warning
+ */
+export interface ValidationWarning {
+    /**
+     * Warning message
+     */
+    message: string;
+    /**
+     * Warning path (JSON pointer)
+     */
+    path?: string;
+    /**
+     * Warning code
+     */
+    code?: string;
+}