mcp4openapi 0.1.0

package/dist/src/profile-loader.js

@@ -0,0 +1,443 @@
+/**
+ * Profile configuration loader and validator
+ *
+ * Why validation: Profile config comes from user files. Invalid config would
+ * cause runtime errors. Validate upfront with clear error messages.
+ *
+ * ✅ Schemas are now auto-generated from TypeScript types!
+ * When adding fields to src/types/profile.ts:
+ * 1. Update TypeScript interface (compile-time checking)
+ * 2. Run `npm run generate-schemas` (auto-generates JSON + Zod schemas)
+ * 3. That's it! No manual sync needed.
+ *
+ * See IMPLEMENTATION.md for details.
+ */
+import fs from 'fs/promises';
+import { ValidationError, ConfigurationError } from './errors.js';
+import { profileSchema, authInterceptorSchema } from './generated-schemas.js';
+import { shortenToolName, NamingStrategy, levenshteinDistance } from './naming.js';
+// Schemas are now auto-generated from TypeScript types!
+// See scripts/generate-schemas.js for details.
+// Custom validations that can't be auto-generated
+const enhancedAuthInterceptorSchema = authInterceptorSchema.refine((data) => {
+    if (data.type === 'query' && !data.query_param) {
+        return false;
+    }
+    if (data.type === 'custom-header' && !data.header_name) {
+        return false;
+    }
+    return true;
+}, {
+    message: 'query type requires query_param, custom-header requires header_name',
+});
+// Override the auth schema in the profile schema tree
+// Note: This is a workaround since we can't easily modify the generated schema
+const enhancedProfileSchema = profileSchema.transform((data) => {
+    // Custom validation for auth interceptor if present
+    if (data.interceptors?.auth) {
+        enhancedAuthInterceptorSchema.parse(data.interceptors.auth);
+    }
+    return data;
+});
+export class ProfileLoader {
+    async load(profilePath) {
+        const content = await fs.readFile(profilePath, 'utf-8');
+        const json = JSON.parse(content);
+        // Validate with Zod - throws detailed error if invalid
+        const profile = enhancedProfileSchema.parse(json);
+        this.validateLogic(profile);
+        return profile;
+    }
+    /**
+     * Validate semantic rules beyond schema
+     *
+     * Why separate: Some rules can't be expressed in JSON Schema (e.g.,
+     * "if composite=true then steps must exist"). Fail fast with clear messages.
+     */
+    validateLogic(profile) {
+        for (const tool of profile.tools) {
+            // Composite tools must have steps
+            if (tool.composite && (!tool.steps || tool.steps.length === 0)) {
+                throw new ValidationError(`Tool '${tool.name}' is marked as composite but has no steps`, { toolName: tool.name, composite: tool.composite });
+            }
+            // Non-composite tools must have operations
+            if (!tool.composite && !tool.operations) {
+                throw new ValidationError(`Tool '${tool.name}' must have either 'operations' or be marked as 'composite' with 'steps'`, { toolName: tool.name, composite: tool.composite });
+            }
+            // Validate required_for references existing enum values
+            for (const [paramName, paramDef] of Object.entries(tool.parameters)) {
+                if (paramDef.required_for) {
+                    const actionParam = tool.parameters['action'];
+                    if (!actionParam?.enum) {
+                        throw new ValidationError(`Parameter '${paramName}' in tool '${tool.name}' has 'required_for' but 'action' parameter has no enum`, { toolName: tool.name, paramName, hasActionParam: !!actionParam });
+                    }
+                    for (const action of paramDef.required_for) {
+                        if (!actionParam.enum.includes(action)) {
+                            throw new ValidationError(`Parameter '${paramName}' requires action '${action}' but it's not in action enum: ${actionParam.enum.join(', ')}`, { toolName: tool.name, paramName, requiredAction: action, availableActions: actionParam.enum });
+                        }
+                    }
+                }
+            }
+            // Validate operation keys match action enum or follow {action}_{resourceType} pattern
+            if (tool.operations && tool.parameters['action']?.enum) {
+                const actionEnum = tool.parameters['action'].enum;
+                const resourceTypeParam = tool.parameters['resource_type'];
+                const resourceTypeEnum = resourceTypeParam?.enum;
+                for (const operationKey of Object.keys(tool.operations)) {
+                    // Check if operation key is directly in action enum
+                    if (actionEnum.includes(operationKey)) {
+                        continue;
+                    }
+                    // Check if operation key follows {action}_{resourceType} pattern
+                    const parts = operationKey.split('_');
+                    if (parts.length === 2) {
+                        const [actionPart, resourceTypePart] = parts;
+                        // Both parts must be valid
+                        const actionValid = actionEnum.includes(actionPart);
+                        const resourceTypeValid = resourceTypeEnum ? resourceTypeEnum.includes(resourceTypePart) : true;
+                        if (actionValid && resourceTypeValid) {
+                            continue;
+                        }
+                    }
+                    // Generate helpful error message with suggestions
+                    const suggestions = this.generateOperationKeySuggestions(operationKey, actionEnum, resourceTypeEnum);
+                    const suggestionText = suggestions.length > 0
+                        ? ` Did you mean one of: ${suggestions.join(', ')}?`
+                        : '';
+                    throw new ValidationError(`Invalid operation key '${operationKey}' in tool '${tool.name}'. ` +
+                        `Must be an action from enum [${actionEnum.join(', ')}] or follow pattern {action}_{resourceType}.${suggestionText}`, {
+                        toolName: tool.name,
+                        operationKey,
+                        availableActions: actionEnum,
+                        availableResourceTypes: resourceTypeEnum,
+                        suggestions
+                    });
+                }
+            }
+            // Validate composite steps DAG (no circular dependencies)
+            if (tool.composite && tool.steps) {
+                this.validateCompositeStepsDAG(tool.name, tool.steps);
+            }
+        }
+    }
+    /**
+     * Generate helpful suggestions for invalid operation keys
+     */
+    generateOperationKeySuggestions(invalidKey, actionEnum, resourceTypeEnum) {
+        const suggestions = [];
+        // Direct action matches (case-insensitive)
+        for (const action of actionEnum) {
+            if (action.toLowerCase() === invalidKey.toLowerCase()) {
+                suggestions.push(action);
+            }
+        }
+        // Levenshtein distance suggestions for actions
+        const maxDistance = Math.min(2, invalidKey.length - 1);
+        for (const action of actionEnum) {
+            if (levenshteinDistance(invalidKey, action) <= maxDistance) {
+                suggestions.push(action);
+            }
+        }
+        // Check for {action}_{resourceType} patterns
+        if (resourceTypeEnum) {
+            for (const action of actionEnum) {
+                for (const resourceType of resourceTypeEnum) {
+                    const compositeKey = `${action}_${resourceType}`;
+                    if (levenshteinDistance(invalidKey, compositeKey) <= maxDistance) {
+                        suggestions.push(compositeKey);
+                    }
+                }
+            }
+        }
+        // Remove duplicates and return unique suggestions
+        return [...new Set(suggestions)];
+    }
+    /**
+     * Validate composite steps form a DAG (no circular dependencies)
+     *
+     * Why: Circular dependencies would cause infinite loops or deadlocks.
+     * We use DFS with color-coding to detect cycles.
+     */
+    validateCompositeStepsDAG(toolName, steps) {
+        // Build adjacency list: store_as -> list of steps that depend on it
+        const graph = new Map();
+        const allStoreAs = new Set();
+        // Initialize all nodes
+        for (const step of steps) {
+            allStoreAs.add(step.store_as);
+            if (!graph.has(step.store_as)) {
+                graph.set(step.store_as, []);
+            }
+        }
+        // Build dependency edges
+        for (const step of steps) {
+            if (step.depends_on) {
+                for (const dep of step.depends_on) {
+                    // Validate dependency exists
+                    if (!allStoreAs.has(dep)) {
+                        throw new ValidationError(`Composite step '${step.store_as}' in tool '${toolName}' depends on '${dep}' but no step produces '${dep}'`, { toolName, stepStoreAs: step.store_as, dependency: dep, availableStoreAs: Array.from(allStoreAs) });
+                    }
+                    // Add edge: dep -> step.store_as (dep must complete before step)
+                    if (!graph.has(dep)) {
+                        graph.set(dep, []);
+                    }
+                    graph.get(dep).push(step.store_as);
+                }
+            }
+        }
+        // DFS cycle detection with color-coding
+        const visited = new Set(); // Fully processed nodes
+        const visiting = new Set(); // Currently being processed (in recursion stack)
+        const dfs = (node) => {
+            if (visiting.has(node)) {
+                throw new ValidationError(`Circular dependency detected in composite steps of tool '${toolName}': ${node} depends on itself`, { toolName, circularNode: node, visitingNodes: Array.from(visiting) });
+            }
+            if (visited.has(node)) {
+                return; // Already fully processed
+            }
+            visiting.add(node);
+            // Visit all neighbors
+            const neighbors = graph.get(node) || [];
+            for (const neighbor of neighbors) {
+                dfs(neighbor);
+            }
+            visiting.delete(node);
+            visited.add(node);
+        };
+        // Check all nodes for cycles
+        for (const node of allStoreAs) {
+            if (!visited.has(node)) {
+                dfs(node);
+            }
+        }
+    }
+    /**
+     * Create a default profile with auto-generated tools from OpenAPI spec
+     *
+     * Why: Allows running server without profile for quick exploration.
+     * Generates simple pass-through tools for all operations.
+     *
+     * Auth Strategy:
+     * 1. Parse security scheme from OpenAPI spec
+     * 2. If found, generate auth interceptor
+     * 3. Fallback to bearer token from API_TOKEN env var
+     */
+    static createDefaultProfile(profileName, parser) {
+        const operations = parser.getAllOperations();
+        // Get configuration for name shortening
+        const maxLength = parseInt(process.env.MCP_TOOLNAME_MAX || '45', 10);
+        const strategyStr = (process.env.MCP_TOOLNAME_STRATEGY || 'none').toLowerCase();
+        const warnOnly = (process.env.MCP_TOOLNAME_WARN_ONLY || 'true').toLowerCase() === 'true';
+        const minParts = parseInt(process.env.MCP_TOOLNAME_MIN_PARTS || '3', 10);
+        const minLength = parseInt(process.env.MCP_TOOLNAME_MIN_LENGTH || '20', 10);
+        const strategy = Object.values(NamingStrategy).includes(strategyStr)
+            ? strategyStr
+            : NamingStrategy.None;
+        const shouldShorten = strategy !== NamingStrategy.None && !warnOnly;
+        // Convert to OperationForNaming for shortening
+        const opsForNaming = operations.map(op => ({
+            operationId: op.operationId,
+            method: op.method,
+            path: op.path,
+            tags: op.tags,
+        }));
+        const tools = operations.map(op => this.generateToolFromOperation(op, shouldShorten ? strategy : NamingStrategy.None, maxLength, opsForNaming, { minParts, minLength }));
+        // Generate auth interceptor from OpenAPI security scheme
+        const interceptors = this.generateAuthInterceptor(parser);
+        return {
+            profile_name: profileName,
+            description: `Auto-generated default profile with ${tools.length} tools from OpenAPI spec`,
+            tools,
+            interceptors,
+        };
+    }
+    /**
+     * Generate auth interceptor from OpenAPI security scheme
+     *
+     * Strategy:
+     * 1. Parse security scheme from OpenAPI spec
+     * 2. If not found, check for force auth override via env vars
+     * 3. Map to profile auth interceptor format
+     * 4. Use env var name from AUTH_ENV_VAR or default to API_TOKEN
+     *
+     * Returns empty object if no security scheme found (public API) and no force override
+     */
+    static generateAuthInterceptor(parser) {
+        const securityScheme = parser.getSecurityScheme();
+        // Check for force auth override (for APIs with incomplete OpenAPI spec)
+        const forceAuth = process.env.AUTH_FORCE === 'true';
+        if (!securityScheme && !forceAuth) {
+            return {}; // Public API, no auth required
+        }
+        // Get env var name from environment or use default
+        const envVarName = process.env.AUTH_ENV_VAR || 'API_TOKEN';
+        const interceptors = {};
+        // If force auth is enabled, use env config instead of OpenAPI spec
+        if (forceAuth && !securityScheme) {
+            const authType = (process.env.AUTH_TYPE || 'bearer').toLowerCase();
+            switch (authType) {
+                case 'bearer':
+                    interceptors.auth = {
+                        type: 'bearer',
+                        value_from_env: envVarName,
+                    };
+                    break;
+                case 'query':
+                    const queryParam = process.env.AUTH_QUERY_PARAM;
+                    if (!queryParam) {
+                        throw new ConfigurationError('AUTH_QUERY_PARAM is required when AUTH_TYPE=query', { authType });
+                    }
+                    interceptors.auth = {
+                        type: 'query',
+                        query_param: queryParam,
+                        value_from_env: envVarName,
+                    };
+                    break;
+                case 'custom-header':
+                    const headerName = process.env.AUTH_HEADER_NAME;
+                    if (!headerName) {
+                        throw new ConfigurationError('AUTH_HEADER_NAME is required when AUTH_TYPE=custom-header', { authType });
+                    }
+                    interceptors.auth = {
+                        type: 'custom-header',
+                        header_name: headerName,
+                        value_from_env: envVarName,
+                    };
+                    break;
+                default:
+                    throw new ConfigurationError(`Invalid AUTH_TYPE: ${authType}. Must be one of: bearer, query, custom-header`, { authType });
+            }
+            return interceptors;
+        }
+        // Use OpenAPI security scheme
+        if (!securityScheme) {
+            return {}; // Shouldn't happen, but TypeScript needs this
+        }
+        switch (securityScheme.type) {
+            case 'bearer':
+                // Bearer token in Authorization header
+                interceptors.auth = {
+                    type: 'bearer',
+                    value_from_env: envVarName,
+                };
+                break;
+            case 'apiKey':
+                // API key in header or query
+                if (securityScheme.in === 'query' && securityScheme.name) {
+                    interceptors.auth = {
+                        type: 'query',
+                        query_param: securityScheme.name,
+                        value_from_env: envVarName,
+                    };
+                }
+                else if (securityScheme.in === 'header' && securityScheme.name) {
+                    // Check if it's a standard Authorization header
+                    if (securityScheme.name.toLowerCase() === 'authorization') {
+                        interceptors.auth = {
+                            type: 'bearer',
+                            value_from_env: envVarName,
+                        };
+                    }
+                    else {
+                        interceptors.auth = {
+                            type: 'custom-header',
+                            header_name: securityScheme.name,
+                            value_from_env: envVarName,
+                        };
+                    }
+                }
+                break;
+            default:
+                // Unknown security type, default to bearer
+                interceptors.auth = {
+                    type: 'bearer',
+                    value_from_env: envVarName,
+                };
+        }
+        return interceptors;
+    }
+    /**
+     * Generate a simple tool from an OpenAPI operation
+     *
+     * Creates a tool with parameters based on the operation's path/query/header parameters
+     * and request body. Uses operationId as tool name and summary/description for tool description.
+     */
+    static generateToolFromOperation(operation, strategy = NamingStrategy.None, maxLength = 45, allOperations = [], options) {
+        const parameters = {};
+        // Add path parameters
+        for (const param of operation.parameters) {
+            parameters[param.name] = {
+                type: this.mapOpenAPISchemaToParameterType(param.schema),
+                description: param.description || `Parameter ${param.name}`,
+                required: param.required,
+            };
+        }
+        // Add request body parameters if present
+        if (operation.requestBody?.content) {
+            // For simplicity, assume JSON content and flatten the schema
+            const jsonContent = operation.requestBody.content['application/json'];
+            if (jsonContent?.schema) {
+                this.flattenSchemaToParameters(jsonContent.schema, parameters, operation.requestBody.required);
+            }
+        }
+        // Warn if parameter inflation exceeds threshold
+        const paramCount = Object.keys(parameters).length;
+        if (paramCount > 60) {
+            // Using console.warn to avoid adding logger dependency here
+            console.warn(`[ProfileLoader] Generated tool has ${paramCount} parameters (>60). Operation: ${operation.operationId} ${operation.method.toUpperCase()} ${operation.path}`);
+        }
+        // Apply name shortening if strategy is specified
+        const opForNaming = {
+            operationId: operation.operationId,
+            method: operation.method,
+            path: operation.path,
+            tags: operation.tags,
+        };
+        const nameResult = shortenToolName(opForNaming, strategy, maxLength, allOperations.length > 0 ? allOperations : [opForNaming], options);
+        return {
+            name: nameResult.name,
+            description: operation.summary || operation.description || `Execute ${operation.method.toUpperCase()} ${operation.path}`,
+            operations: {
+                'execute': operation.operationId,
+            },
+            parameters,
+        };
+    }
+    /**
+     * Map OpenAPI schema to parameter type
+     */
+    static mapOpenAPISchemaToParameterType(schema) {
+        switch (schema.type) {
+            case 'string':
+                return 'string';
+            case 'integer':
+                return 'integer';
+            case 'number':
+                return 'number';
+            case 'boolean':
+                return 'boolean';
+            case 'array':
+                return 'array';
+            case 'object':
+                return 'object';
+            default:
+                return 'string'; // fallback
+        }
+    }
+    /**
+     * Recursively flatten schema properties to parameters
+     */
+    static flattenSchemaToParameters(schema, parameters, required = false) {
+        if (schema.type === 'object' && schema.properties) {
+            for (const [propName, propSchema] of Object.entries(schema.properties)) {
+                const isRequired = schema.required?.includes(propName) || required;
+                parameters[propName] = {
+                    type: this.mapOpenAPISchemaToParameterType(propSchema),
+                    description: `Property ${propName}`,
+                    required: isRequired,
+                };
+            }
+        }
+    }
+}
+//# sourceMappingURL=profile-loader.js.map

package/dist/src/profile-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-loader.js","sourceRoot":"","sources":["../../src/profile-loader.ts"],"names":[],"mappings":"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"}

package/dist/src/schema-validator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Request body schema validator
+ *
+ * Why: Catch invalid requests before sending to API. Better error messages for users.
+ * Validates against OpenAPI schema definitions.
+ */
+import type { SchemaInfo, OperationInfo } from './types/openapi.js';
+export interface ValidationResult {
+    valid: boolean;
+    errors?: ValidationError[];
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+    schema: SchemaInfo;
+    value: unknown;
+}
+export declare class SchemaValidator {
+    /**
+     * Validate request body against OpenAPI schema
+     *
+     * Why: Prevents sending malformed requests. OpenAPI schema is the source of truth.
+     */
+    validateRequestBody(operation: OperationInfo, body: Record<string, unknown>): ValidationResult;
+    /**
+     * Recursively validate data against schema
+     */
+    private validateAgainstSchema;
+}
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/src/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/schema-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGpE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,eAAe;IAC1B;;;;OAIG;IACH,mBAAmB,CACjB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,gBAAgB;IAgBnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;CA4G9B"}

package/dist/src/schema-validator.js

@@ -0,0 +1,115 @@
+/**
+ * Request body schema validator
+ *
+ * Why: Catch invalid requests before sending to API. Better error messages for users.
+ * Validates against OpenAPI schema definitions.
+ */
+import { isEmail, isUri } from './validation-utils.js';
+export class SchemaValidator {
+    /**
+     * Validate request body against OpenAPI schema
+     *
+     * Why: Prevents sending malformed requests. OpenAPI schema is the source of truth.
+     */
+    validateRequestBody(operation, body) {
+        if (!operation.requestBody?.content['application/json']?.schema) {
+            return { valid: true };
+        }
+        const schema = operation.requestBody.content['application/json'].schema;
+        const errors = [];
+        this.validateAgainstSchema(body, schema, '', errors);
+        return {
+            valid: errors.length === 0,
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+    /**
+     * Recursively validate data against schema
+     */
+    validateAgainstSchema(data, schema, path, errors) {
+        // Null/undefined handling
+        if (data === null || data === undefined) {
+            if (schema.type && schema.type !== 'null') {
+                errors.push({
+                    path: path || '(root)',
+                    message: `Expected ${schema.type}, got ${data}`,
+                    schema,
+                    value: data,
+                });
+            }
+            return;
+        }
+        // Type validation
+        if (schema.type) {
+            const actualType = Array.isArray(data) ? 'array' : typeof data;
+            if (actualType !== schema.type) {
+                errors.push({
+                    path: path || '(root)',
+                    message: `Expected ${schema.type}, got ${actualType}`,
+                    schema,
+                    value: data,
+                });
+                return; // Stop validation if type is wrong
+            }
+        }
+        // Enum validation
+        // Note: Using 'as any' here is safe - we're checking if value exists in enum array
+        // TypeScript doesn't know the enum values at compile time
+        if (schema.enum && !schema.enum.includes(data)) {
+            errors.push({
+                path: path || '(root)',
+                message: `Value must be one of: ${schema.enum.join(', ')}`,
+                schema,
+                value: data,
+            });
+        }
+        // Object properties validation
+        if (schema.type === 'object' && schema.properties) {
+            const obj = data;
+            // Check required properties
+            for (const required of schema.required || []) {
+                if (obj[required] === undefined) {
+                    errors.push({
+                        path: path ? `${path}.${required}` : required,
+                        message: 'Required property is missing',
+                        schema,
+                        value: undefined,
+                    });
+                }
+            }
+            // Validate each property
+            for (const [key, value] of Object.entries(obj)) {
+                if (schema.properties[key]) {
+                    this.validateAgainstSchema(value, schema.properties[key], path ? `${path}.${key}` : key, errors);
+                }
+                // Note: Not validating additionalProperties (too strict for most APIs)
+            }
+        }
+        // Array items validation
+        if (schema.type === 'array' && schema.items && Array.isArray(data)) {
+            data.forEach((item, index) => {
+                this.validateAgainstSchema(item, schema.items, `${path}[${index}]`, errors);
+            });
+        }
+        // String format validation (basic)
+        if (schema.type === 'string' && schema.format && typeof data === 'string') {
+            if (schema.format === 'email' && !isEmail(data)) {
+                errors.push({
+                    path: path || '(root)',
+                    message: 'Invalid email format',
+                    schema,
+                    value: data,
+                });
+            }
+            if (schema.format === 'uri' && !isUri(data)) {
+                errors.push({
+                    path: path || '(root)',
+                    message: 'Invalid URI format',
+                    schema,
+                    value: data,
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/src/schema-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../../src/schema-validator.ts"],"names":[],"mappings":"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"}