mcp4openapi 0.2.8 → 0.3.1

package/dist/src/tooling/tool-generator.js

@@ -0,0 +1,222 @@
+/**
+ * MCP tool generator from profile definitions
+ *
+ * Why: Translates profile config into MCP SDK tool definitions. Handles both
+ * simple (single operation) and composite (multi-step) tools.
+ */
+import { ValidationError } from '../core/errors.js';
+export class ToolGenerator {
+    constructor(parser) {
+        this.parser = parser;
+    }
+    /**
+     * Generate MCP tool from profile definition
+     */
+    generateTool(toolDef) {
+        const inputSchema = this.generateInputSchema(toolDef);
+        return {
+            name: toolDef.name,
+            description: toolDef.description,
+            inputSchema,
+        };
+    }
+    /**
+     * Generate JSON Schema for tool parameters
+     *
+     * Why JSON Schema: MCP SDK expects JSON Schema for parameter validation.
+     * LLM uses schema to understand what parameters are needed.
+     */
+    generateInputSchema(toolDef) {
+        const properties = {};
+        const required = [];
+        for (const [name, param] of Object.entries(toolDef.parameters)) {
+            properties[name] = this.parameterToJsonSchema(param);
+            // Add to required if unconditionally required
+            if (param.required) {
+                required.push(name);
+            }
+            // Add conditional requirement hints in description
+            if (param.required_for && param.required_for.length > 0) {
+                const existing = properties[name].description || '';
+                properties[name].description = existing +
+                    ` Required when action is: ${param.required_for.join(', ')}.`;
+            }
+        }
+        return {
+            type: 'object',
+            properties,
+            required: required.length > 0 ? required : undefined,
+        };
+    }
+    /**
+     * Convert parameter definition to JSON Schema
+     */
+    parameterToJsonSchema(param) {
+        if (Array.isArray(param.type)) {
+            const oneOf = param.type.map(type => this.parameterTypeToSchema(type, param));
+            return {
+                description: param.description,
+                oneOf,
+            };
+        }
+        const schema = this.parameterTypeToSchema(param.type, param);
+        schema.description = param.description;
+        return schema;
+    }
+    parameterTypeToSchema(type, param) {
+        const schema = { type };
+        if (param.enum) {
+            schema.enum = param.enum;
+        }
+        if (param.default !== undefined) {
+            schema.default = param.default;
+        }
+        if (type === 'string') {
+            if (param.minLength !== undefined) {
+                schema.minLength = param.minLength;
+            }
+            if (param.maxLength !== undefined) {
+                schema.maxLength = param.maxLength;
+            }
+            if (param.pattern !== undefined) {
+                schema.pattern = param.pattern;
+            }
+        }
+        if (type === 'array' && param.items) {
+            schema.items = { type: param.items.type };
+        }
+        if (type === 'object') {
+            // Always include properties for object type (empty {} = free-form object)
+            schema.properties = param.properties || {};
+        }
+        return schema;
+    }
+    /**
+     * Validate tool arguments against parameter definitions
+     *
+     * Why manual validation: Checks conditional requirements (required_for)
+     * which JSON Schema can't express directly.
+     */
+    validateArguments(toolDef, args) {
+        for (const [name, param] of Object.entries(toolDef.parameters)) {
+            const value = args[name];
+            // Check unconditional required
+            if (param.required && value === undefined) {
+                throw new ValidationError(`Missing required parameter: ${name}`);
+            }
+            // Check conditional required
+            if (param.required_for && param.required_for.length > 0) {
+                const action = args['action'];
+                if (action && param.required_for.includes(action) && value === undefined) {
+                    throw new ValidationError(`Parameter '${name}' is required for action '${action}'`);
+                }
+            }
+            // Validate enum
+            if (value !== undefined && param.enum && !param.enum.includes(String(value))) {
+                throw new ValidationError(`Invalid value for ${name}. Must be one of: ${param.enum.join(', ')}`);
+            }
+            // Validate string constraints
+            if (value !== undefined && typeof value === 'string') {
+                if (param.minLength !== undefined && value.length < param.minLength) {
+                    throw new ValidationError(`Invalid value for ${name}. Length must be at least ${param.minLength}`);
+                }
+                if (param.maxLength !== undefined && value.length > param.maxLength) {
+                    throw new ValidationError(`Invalid value for ${name}. Length must be at most ${param.maxLength}`);
+                }
+                if (param.pattern !== undefined) {
+                    let regex;
+                    try {
+                        regex = new RegExp(param.pattern);
+                    }
+                    catch (error) {
+                        const reason = error instanceof Error ? error.message : String(error);
+                        throw new ValidationError(`Invalid pattern for ${name}.`, { paramName: name, pattern: param.pattern, reason });
+                    }
+                    if (!regex.test(value)) {
+                        throw new ValidationError(`Invalid value for ${name}. Must match pattern: ${param.pattern}`, { paramName: name, pattern: param.pattern });
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Get operation definition (string or ProxyDownloadOperation) for action
+     *
+     * Why: Tools can have string operationIds OR proxy_download configs.
+     * This returns the raw definition before extracting operationId.
+     */
+    getOperationDefinition(toolDef, args) {
+        if (!toolDef.operations)
+            return undefined;
+        const action = args['action'];
+        if (!action) {
+            // If single operation, use it directly
+            const operations = Object.values(toolDef.operations);
+            return operations.length === 1 ? operations[0] : undefined;
+        }
+        // For resource_type discrimination (e.g., project vs group)
+        const resourceType = args['resource_type'];
+        if (resourceType) {
+            // Try resource-specific operation first
+            const key = `${action}_${resourceType}`;
+            if (toolDef.operations[key]) {
+                return toolDef.operations[key];
+            }
+        }
+        return toolDef.operations[action];
+    }
+    /**
+     * Map tool action to OpenAPI operation ID
+     *
+     * Why: Single tool with 'action' parameter maps to multiple operations.
+     * Example: manage_badges + action=create => postApiV4ProjectsIdBadges
+     *
+     * Note: Returns undefined for ProxyDownloadOperation (not a direct operationId)
+     */
+    mapActionToOperation(toolDef, args) {
+        const op = this.getOperationDefinition(toolDef, args);
+        return typeof op === 'string' ? op : undefined;
+    }
+    /**
+     * Check if operation requires multipart/form-data
+     *
+     * Why: Some operations (file uploads) need FormData instead of JSON body.
+     * Detected from OpenAPI requestBody.content['multipart/form-data'].
+     */
+    isMultipartOperation(operationId) {
+        const operation = this.parser.getOperation(operationId);
+        if (!operation?.requestBody?.content)
+            return false;
+        return 'multipart/form-data' in operation.requestBody.content;
+    }
+    /**
+     * Build FormData body for file upload
+     *
+     * @param args Tool arguments including base64Content or filePath
+     * @param fileFieldName Field name in FormData (default: 'files[0]')
+     */
+    buildFormDataBody(args, fileFieldName = 'files[0]') {
+        const formData = new FormData();
+        const base64Content = args['base64Content'];
+        const fileName = args['fileName'] || 'upload';
+        const mimeType = args['mimeType'] || 'application/octet-stream';
+        if (base64Content) {
+            // Convert base64 to Blob
+            let binaryString;
+            try {
+                binaryString = atob(base64Content);
+            }
+            catch (error) {
+                throw new ValidationError('Invalid base64 content');
+            }
+            const bytes = new Uint8Array(binaryString.length);
+            for (let i = 0; i < binaryString.length; i++) {
+                bytes[i] = binaryString.charCodeAt(i);
+            }
+            const blob = new Blob([bytes], { type: mimeType });
+            formData.append(fileFieldName, blob, fileName);
+        }
+        return formData;
+    }
+}
+//# sourceMappingURL=tool-generator.js.map

package/dist/src/tooling/tool-generator.js.map

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

package/dist/src/transport/http-client-factory.d.ts

@@ -0,0 +1,65 @@
+/**
+ * HTTP Client Factory - unified HTTP client management
+ *
+ * Why: Eliminates code duplication in HTTP client creation and management
+ * Provides consistent client lifecycle, auth handling, and caching
+ */
+import { HttpClient } from './interceptors.js';
+import type { MetricsCollector } from '../core/metrics.js';
+import type { Profile } from '../types/profile.js';
+export interface HttpClientConfig {
+    profile: Profile;
+    baseUrl: string;
+    sessionToken?: string;
+}
+/**
+ * Factory for creating and managing HTTP clients
+ * Handles both global and session-specific clients
+ */
+export declare class HttpClientFactory {
+    private globalClient?;
+    private sessionClients;
+    private metrics;
+    /**
+     * Create global HTTP client (for stdio transport)
+     */
+    createGlobalClient(config: HttpClientConfig): HttpClient;
+    /**
+     * Get or create session-specific HTTP client
+     */
+    getOrCreateSessionClient(sessionId: string, config: HttpClientConfig): HttpClient;
+    /**
+     * Get global client (throws if not initialized)
+     */
+    getGlobalClient(): HttpClient;
+    /**
+     * Get session client (throws if not exists)
+     */
+    getSessionClient(sessionId: string): HttpClient;
+    /**
+     * Cleanup session client
+     */
+    cleanupSessionClient(sessionId: string): boolean;
+    /**
+     * Check if global client exists
+     */
+    hasGlobalClient(): boolean;
+    /**
+     * Check if session client exists
+     */
+    hasSessionClient(sessionId: string): boolean;
+    setMetricsCollector(metrics: MetricsCollector | null): void;
+    /**
+     * Get auth token for client creation
+     */
+    private getAuthToken;
+    /**
+     * Create interceptor chain for client
+     */
+    private createInterceptorChain;
+    /**
+     * Validate client configuration
+     */
+    validateClientConfig(config: HttpClientConfig): void;
+}
+//# sourceMappingURL=http-client-factory.d.ts.map

package/dist/src/transport/http-client-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client-factory.d.ts","sourceRoot":"","sources":["../../../src/transport/http-client-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAoB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,OAAO,CAAiC;IAEhD;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU;IAOxD;;OAEG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,UAAU;IAsBjF;;OAEG;IACH,eAAe,IAAI,UAAU;IAO7B;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU;IAQ/C;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIhD;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI5C,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAU3D;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAK9B;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;CAsBrD"}

package/dist/src/transport/http-client-factory.js

@@ -0,0 +1,143 @@
+/**
+ * HTTP Client Factory - unified HTTP client management
+ *
+ * Why: Eliminates code duplication in HTTP client creation and management
+ * Provides consistent client lifecycle, auth handling, and caching
+ */
+import { InterceptorChain, HttpClient } from './interceptors.js';
+import { ConfigurationError, AuthenticationError } from '../core/errors.js';
+/**
+ * Factory for creating and managing HTTP clients
+ * Handles both global and session-specific clients
+ */
+export class HttpClientFactory {
+    constructor() {
+        this.sessionClients = new Map();
+        this.metrics = null;
+    }
+    /**
+     * Create global HTTP client (for stdio transport)
+     */
+    createGlobalClient(config) {
+        const interceptors = this.createInterceptorChain(config);
+        const client = new HttpClient(config.baseUrl, interceptors, this.metrics);
+        this.globalClient = client;
+        return client;
+    }
+    /**
+     * Get or create session-specific HTTP client
+     */
+    getOrCreateSessionClient(sessionId, config) {
+        // Check cache first
+        let client = this.sessionClients.get(sessionId);
+        if (client) {
+            return client;
+        }
+        // Create new client for session
+        const interceptors = this.createInterceptorChain(config);
+        const newClient = new HttpClient(config.baseUrl, interceptors, this.metrics);
+        // Double-check for race condition
+        const existingClient = this.sessionClients.get(sessionId);
+        if (existingClient) {
+            return existingClient;
+        }
+        // Cache and return
+        this.sessionClients.set(sessionId, newClient);
+        return newClient;
+    }
+    /**
+     * Get global client (throws if not initialized)
+     */
+    getGlobalClient() {
+        if (!this.globalClient) {
+            throw new ConfigurationError('Global HTTP client not initialized');
+        }
+        return this.globalClient;
+    }
+    /**
+     * Get session client (throws if not exists)
+     */
+    getSessionClient(sessionId) {
+        const client = this.sessionClients.get(sessionId);
+        if (!client) {
+            throw new ConfigurationError(`Session HTTP client not found for session: ${sessionId}`);
+        }
+        return client;
+    }
+    /**
+     * Cleanup session client
+     */
+    cleanupSessionClient(sessionId) {
+        return this.sessionClients.delete(sessionId);
+    }
+    /**
+     * Check if global client exists
+     */
+    hasGlobalClient() {
+        return !!this.globalClient;
+    }
+    /**
+     * Check if session client exists
+     */
+    hasSessionClient(sessionId) {
+        return this.sessionClients.has(sessionId);
+    }
+    setMetricsCollector(metrics) {
+        this.metrics = metrics;
+        if (this.globalClient) {
+            this.globalClient.setMetricsCollector(metrics);
+        }
+        for (const client of this.sessionClients.values()) {
+            client.setMetricsCollector(metrics);
+        }
+    }
+    /**
+     * Get auth token for client creation
+     */
+    getAuthToken(config) {
+        // Priority: session token > environment token
+        if (config.sessionToken) {
+            return config.sessionToken;
+        }
+        const authConfigRaw = config.profile.interceptors?.auth;
+        if (!authConfigRaw) {
+            return undefined;
+        }
+        // Handle multi-auth: get primary non-OAuth config
+        const authConfigs = Array.isArray(authConfigRaw) ? authConfigRaw : [authConfigRaw];
+        const sortedConfigs = authConfigs.sort((a, b) => (a.priority || 0) - (b.priority || 0));
+        const authConfig = sortedConfigs.find(c => c.type !== 'oauth');
+        if (authConfig && authConfig.value_from_env) {
+            return process.env[authConfig.value_from_env];
+        }
+        return undefined;
+    }
+    /**
+     * Create interceptor chain for client
+     */
+    createInterceptorChain(config) {
+        const token = this.getAuthToken(config);
+        return new InterceptorChain(config.profile.interceptors || {}, token);
+    }
+    /**
+     * Validate client configuration
+     */
+    validateClientConfig(config) {
+        if (!config.baseUrl) {
+            throw new ConfigurationError('Base URL is required for HTTP client');
+        }
+        if (!config.profile) {
+            throw new ConfigurationError('Profile is required for HTTP client');
+        }
+        // Check if we have any auth token available
+        const hasToken = this.getAuthToken(config);
+        if (!hasToken && config.profile.interceptors?.auth) {
+            const authConfigRaw = config.profile.interceptors.auth;
+            const authConfigs = Array.isArray(authConfigRaw) ? authConfigRaw : [authConfigRaw];
+            const nonOAuthConfig = authConfigs.find(c => c.type !== 'oauth');
+            const envVar = nonOAuthConfig?.value_from_env || 'MCP4_API_TOKEN';
+            throw new AuthenticationError(`No auth token available. Expected token in Authorization header or ${envVar} env var`, { envVar });
+        }
+    }
+}
+//# sourceMappingURL=http-client-factory.js.map

package/dist/src/transport/http-client-factory.js.map

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

package/dist/src/transport/http-transport-config.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Build base HTTP transport configuration from environment variables.
+ */
+import type { HttpTransportConfig } from '../types/http-transport.js';
+export declare function buildHttpTransportBaseConfig(host: string, port: number): HttpTransportConfig;
+//# sourceMappingURL=http-transport-config.d.ts.map

package/dist/src/transport/http-transport-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport-config.d.ts","sourceRoot":"","sources":["../../../src/transport/http-transport-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAatE,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,mBAAmB,CA8C5F"}

package/dist/src/transport/http-transport-config.js

@@ -0,0 +1,63 @@
+/**
+ * Build base HTTP transport configuration from environment variables.
+ */
+import { TIMEOUTS } from '../core/constants.js';
+import { ConfigurationError } from '../core/errors.js';
+function parseTrustProxy(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'true')
+        return true;
+    if (normalized === 'false')
+        return false;
+    const numeric = Number.parseInt(value, 10);
+    if (!Number.isNaN(numeric) && String(numeric) === value.trim()) {
+        return numeric;
+    }
+    return value;
+}
+export function buildHttpTransportBaseConfig(host, port) {
+    return {
+        host,
+        port,
+        sessionTimeoutMs: parseInt(process.env.MCP4_SESSION_TIMEOUT_MS || String(TIMEOUTS.SESSION_TIMEOUT_MS), 10),
+        heartbeatEnabled: process.env.MCP4_HEARTBEAT_ENABLED === 'true',
+        heartbeatIntervalMs: parseInt(process.env.MCP4_HEARTBEAT_INTERVAL_MS || String(TIMEOUTS.HEARTBEAT_INTERVAL_MS), 10),
+        metricsEnabled: process.env.MCP4_METRICS_ENABLED === 'true',
+        metricsPath: process.env.MCP4_METRICS_PATH || '/metrics',
+        profileIndexEnabled: process.env.MCP4_HTTP_PROFILE_INDEX === 'true',
+        allowedOrigins: process.env.MCP4_ALLOWED_ORIGINS
+            ? process.env.MCP4_ALLOWED_ORIGINS.split(',').map(o => o.trim())
+            : undefined,
+        rateLimitEnabled: process.env.MCP4_HTTP_RATE_LIMIT_ENABLED !== 'false', // default: true
+        rateLimitWindowMs: parseInt(process.env.MCP4_HTTP_RATE_LIMIT_WINDOW_MS || String(TIMEOUTS.RATE_LIMIT_WINDOW_MS), 10),
+        rateLimitMaxRequests: parseInt(process.env.MCP4_HTTP_RATE_LIMIT_MAX_REQUESTS || '100', 10),
+        rateLimitMetricsMax: parseInt(process.env.MCP4_HTTP_RATE_LIMIT_METRICS_MAX || '10', 10),
+        maxTokenLength: process.env.MCP4_TOKEN_MAX_LENGTH
+            ? parseInt(process.env.MCP4_TOKEN_MAX_LENGTH, 10)
+            : undefined,
+        trustProxy: process.env.MCP4_TRUST_PROXY
+            ? parseTrustProxy(process.env.MCP4_TRUST_PROXY)
+            : undefined,
+        sslCertFile: process.env.MCP4_SSL_CERT_FILE,
+        sslKeyFile: process.env.MCP4_SSL_KEY_FILE,
+        oauthSessionTimeoutMs: (() => {
+            if (process.env.MCP4_OAUTH_SESSION_TIMEOUT_MS === undefined)
+                return undefined;
+            const parsed = parseInt(process.env.MCP4_OAUTH_SESSION_TIMEOUT_MS, 10);
+            if (Number.isNaN(parsed)) {
+                throw new ConfigurationError(`Invalid MCP4_OAUTH_SESSION_TIMEOUT_MS: expected integer milliseconds, got '${process.env.MCP4_OAUTH_SESSION_TIMEOUT_MS}'`);
+            }
+            return parsed;
+        })(),
+        oauthRefreshThresholdMs: (() => {
+            if (process.env.MCP4_OAUTH_REFRESH_THRESHOLD_MS === undefined)
+                return undefined;
+            const parsed = parseInt(process.env.MCP4_OAUTH_REFRESH_THRESHOLD_MS, 10);
+            if (Number.isNaN(parsed)) {
+                throw new ConfigurationError(`Invalid MCP4_OAUTH_REFRESH_THRESHOLD_MS: expected integer milliseconds, got '${process.env.MCP4_OAUTH_REFRESH_THRESHOLD_MS}'`);
+            }
+            return parsed;
+        })(),
+    };
+}
+//# sourceMappingURL=http-transport-config.js.map

package/dist/src/transport/http-transport-config.js.map

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