mcp-from-openapi 0.0.1 → 1.0.0

package/src/schema-builder.js

@@ -72,7 +72,7 @@ class SchemaBuilder {
             delete obj.$ref;
         }
         for (const key in obj) {
-            if (obj.hasOwnProperty(key)) {
+            if (key in obj) {
                 const value = obj[key];
                 if (value && typeof value === 'object') {
                     this.removeRefsRecursive(value);
@@ -89,18 +89,6 @@ class SchemaBuilder {
             description,
         };
     }
-    /**
-     * Mark schema as required
-     */
-    static required(schema) {
-        return schema;
-    }
-    /**
-     * Mark schema as optional
-     */
-    static optional(schema) {
-        return schema;
-    }
     /**
      * Add example to schema
      */
@@ -268,6 +256,13 @@ class SchemaBuilder {
             });
             cloned.anyOf = flattened;
         }
+        if (cloned.allOf) {
+            const flattened = cloned.allOf.flatMap((s) => {
+                const sub = this.flatten(s, maxDepth - 1);
+                return sub.allOf ? sub.allOf : [sub];
+            });
+            cloned.allOf = flattened;
+        }
         return cloned;
     }
     /**

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 (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"]}
+{"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"]}

package/src/security-resolver.d.ts

@@ -0,0 +1,289 @@
+import type { ParameterMapper, SecurityParameterInfo } from './types';
+/**
+ * Context for resolving security parameters
+ * Frameworks should implement this interface based on their auth system
+ */
+export interface SecurityContext {
+    /**
+     * JWT/Bearer token
+     */
+    jwt?: string;
+    /**
+     * Basic auth credentials (base64 encoded "username:password")
+     */
+    basic?: string;
+    /**
+     * Digest auth credentials
+     * Object with username, password, realm, nonce, etc.
+     */
+    digest?: DigestAuthCredentials;
+    /**
+     * API key (single key for backward compatibility)
+     */
+    apiKey?: string;
+    /**
+     * Multiple API keys by name
+     * Use this when API requires different keys for different purposes
+     * @example { 'X-API-Key': 'key1', 'X-Client-Id': 'client123' }
+     */
+    apiKeys?: Record<string, string>;
+    /**
+     * OAuth2 access token
+     */
+    oauth2Token?: string;
+    /**
+     * Client certificate for mutual TLS (mTLS)
+     */
+    clientCertificate?: ClientCertificate;
+    /**
+     * Private key for signature-based auth (HMAC, AWS Signature V4, etc.)
+     */
+    privateKey?: string;
+    /**
+     * Public key (if needed for verification)
+     */
+    publicKey?: string;
+    /**
+     * HMAC secret for HMAC-based authentication
+     */
+    hmacSecret?: string;
+    /**
+     * AWS credentials for AWS Signature V4
+     */
+    awsCredentials?: AWSCredentials;
+    /**
+     * Custom headers for proprietary authentication
+     * @example { 'X-Custom-Auth': 'custom-value' }
+     */
+    customHeaders?: Record<string, string>;
+    /**
+     * Session cookies
+     */
+    cookies?: Record<string, string>;
+    /**
+     * Custom resolver for framework-specific auth
+     * @param security - Security parameter info from mapper
+     * @returns The auth value to use, or undefined if not available
+     */
+    customResolver?: (security: SecurityParameterInfo) => string | Promise<string | undefined>;
+    /**
+     * Signature generator for signature-based auth
+     * @param data - Data to sign (typically the request)
+     * @param security - Security parameter info
+     * @returns The signature or signed value
+     */
+    signatureGenerator?: (data: SignatureData, security: SecurityParameterInfo) => string | Promise<string>;
+}
+/**
+ * Digest authentication credentials
+ */
+export interface DigestAuthCredentials {
+    username: string;
+    password: string;
+    realm?: string;
+    nonce?: string;
+    uri?: string;
+    qop?: string;
+    nc?: string;
+    cnonce?: string;
+    response?: string;
+    opaque?: string;
+}
+/**
+ * Client certificate for mTLS
+ */
+export interface ClientCertificate {
+    /**
+     * Certificate in PEM format
+     */
+    cert: string;
+    /**
+     * Private key in PEM format
+     */
+    key: string;
+    /**
+     * Passphrase for encrypted key
+     */
+    passphrase?: string;
+    /**
+     * CA certificates
+     */
+    ca?: string | string[];
+}
+/**
+ * AWS credentials for Signature V4
+ */
+export interface AWSCredentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+    region?: string;
+    service?: string;
+}
+/**
+ * Data to be signed for signature-based auth
+ */
+export interface SignatureData {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: string;
+    timestamp?: number;
+}
+/**
+ * Resolved security parameters ready to be added to HTTP request
+ */
+export interface ResolvedSecurity {
+    /**
+     * Headers to add to the request
+     */
+    headers: Record<string, string>;
+    /**
+     * Query parameters to add to the request
+     */
+    query: Record<string, string>;
+    /**
+     * Cookie values to add to the request
+     */
+    cookies: Record<string, string>;
+    /**
+     * Client certificate for mTLS (if applicable)
+     */
+    clientCertificate?: ClientCertificate;
+    /**
+     * Whether signature-based auth is required
+     * If true, you need to call signRequest() before sending
+     */
+    requiresSignature?: boolean;
+    /**
+     * Signature metadata (if signature-based auth is used)
+     */
+    signatureInfo?: {
+        scheme: string;
+        algorithm?: string;
+    };
+}
+/**
+ * Security resolver that maps OpenAPI security requirements to actual auth values
+ *
+ * This helper handles security parameters from any OpenAPI spec, regardless of
+ * custom naming (BearerAuth, JWT, Authorization, etc.). It uses the mapper's
+ * security metadata to determine the auth type and format.
+ *
+ * @example
+ * ```typescript
+ * // In FrontMCP
+ * const resolver = new SecurityResolver();
+ * const resolved = resolver.resolve(tool.mapper, {
+ *   jwt: context.authInfo.jwt,
+ *   apiKey: process.env.API_KEY
+ * });
+ *
+ * // Use resolved.headers in HTTP request
+ * fetch(url, { headers: { ...resolved.headers, ...otherHeaders } });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Custom resolver for framework-specific auth
+ * const resolved = resolver.resolve(tool.mapper, {
+ *   customResolver: (security) => {
+ *     if (security.type === 'http' && security.httpScheme === 'bearer') {
+ *       return myFramework.getAuthToken();
+ *     }
+ *     return undefined;
+ *   }
+ * });
+ * ```
+ */
+export declare class SecurityResolver {
+    /**
+     * Resolve security parameters from mapper entries
+     *
+     * @param mappers - Parameter mappers from the tool definition
+     * @param context - Security context with auth values or custom resolver
+     * @returns Resolved headers, query params, and cookies with auth applied
+     */
+    resolve(mappers: ParameterMapper[], context: SecurityContext): Promise<ResolvedSecurity>;
+    /**
+     * Check if security scheme requires request signing
+     */
+    private isSignatureBasedAuth;
+    /**
+     * Resolve the actual auth value based on security type
+     */
+    private resolveAuthValue;
+    /**
+     * Resolve HTTP authentication (bearer, basic, digest, etc.)
+     */
+    private resolveHttpAuth;
+    /**
+     * Resolve Bearer token authentication
+     */
+    private resolveBearerAuth;
+    /**
+     * Resolve Basic authentication
+     */
+    private resolveBasicAuth;
+    /**
+     * Resolve Digest authentication
+     */
+    private resolveDigestAuth;
+    /**
+     * Resolve custom HTTP authentication schemes
+     */
+    private resolveCustomHttpScheme;
+    /**
+     * Resolve API key authentication
+     */
+    private resolveApiKey;
+    /**
+     * Resolve OAuth2/OpenID Connect authentication
+     */
+    private resolveOAuth2;
+    /**
+     * Check if any security requirements are missing from context
+     *
+     * @param mappers - Parameter mappers from the tool definition
+     * @param context - Security context with auth values
+     * @returns Array of missing security scheme names
+     */
+    checkMissingSecurity(mappers: ParameterMapper[], context: SecurityContext): Promise<string[]>;
+    /**
+     * Sign a request for signature-based authentication
+     *
+     * Use this when resolved.requiresSignature is true.
+     * This method will call the signatureGenerator from context to sign the request.
+     *
+     * @param mappers - Parameter mappers from the tool definition
+     * @param signatureData - Request data to sign
+     * @param context - Security context with signature generator
+     * @returns Headers with signature added
+     *
+     * @example
+     * ```typescript
+     * const resolved = resolver.resolve(tool.mapper, context);
+     * if (resolved.requiresSignature) {
+     *   const signedHeaders = await resolver.signRequest(
+     *     tool.mapper,
+     *     { method: 'GET', url: 'https://api.example.com/data', headers: resolved.headers },
+     *     context
+     *   );
+     *   // Use signedHeaders in request
+     * }
+     * ```
+     */
+    signRequest(mappers: ParameterMapper[], signatureData: SignatureData, context: SecurityContext): Promise<Record<string, string>>;
+}
+/**
+ * Create a basic security context from common auth sources
+ *
+ * @example
+ * ```typescript
+ * const context = createSecurityContext({
+ *   jwt: process.env.JWT_TOKEN,
+ *   apiKey: process.env.API_KEY
+ * });
+ * ```
+ */
+export declare function createSecurityContext(auth: Partial<SecurityContext>): SecurityContext;