@machina.ai/openapi-contract-tester 2.1.0

package/dist/mcp/handlers/index.js

@@ -0,0 +1,12 @@
+/**
+ * MCP Handlers - Exports all tool handlers
+ *
+ * @module mcp/handlers
+ */
+export { GenerateTestsHandler } from './generate-tests.js';
+export { RunTestsHandler } from './run-tests.js';
+export { ExportResultsHandler } from './export-results.js';
+export { CompareSourcesHandler } from './compare-sources.js';
+export { ExportToPostmanHandler } from './export-to-postman.js';
+export { BaseToolHandler } from './base-handler.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/mcp/handlers/run-tests.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Run Tests Handler
+ *
+ * Handles the run-tests tool which executes test suites against APIs.
+ *
+ * @module mcp/handlers/run-tests
+ */
+import { BaseToolHandler } from './base-handler.js';
+import type { ToolResponse } from './types.js';
+import { SpecService } from '../services/spec-service.js';
+/**
+ * Handler for test execution tool
+ */
+export declare class RunTestsHandler extends BaseToolHandler {
+    private specService;
+    readonly name = "run-tests";
+    readonly description: string;
+    readonly inputSchema: {
+        type: string;
+        properties: {
+            specPath: {
+                type: string;
+                description: string;
+            };
+            baseUrl: {
+                type: string;
+                description: string;
+            };
+            tests: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                };
+            };
+            credentials: {
+                type: string;
+                description: string;
+                properties: {
+                    bearerToken: {
+                        type: string;
+                        description: string;
+                    };
+                    apiKey: {
+                        type: string;
+                        description: string;
+                    };
+                    username: {
+                        type: string;
+                        description: string;
+                    };
+                    password: {
+                        type: string;
+                        description: string;
+                    };
+                    clientId: {
+                        type: string;
+                        description: string;
+                    };
+                    clientSecret: {
+                        type: string;
+                        description: string;
+                    };
+                };
+            };
+            authToken: {
+                type: string;
+                description: string;
+            };
+            testData: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+            };
+            parallel: {
+                type: string;
+                description: string;
+            };
+            timeout: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(specService: SpecService);
+    handle(args: unknown): Promise<ToolResponse>;
+}
+//# sourceMappingURL=run-tests.d.ts.map

package/dist/mcp/handlers/run-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tests.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/run-tests.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI1D;;GAEG;AACH,qBAAa,eAAgB,SAAQ,eAAe;IA+FhD,OAAO,CAAC,WAAW;IA9FrB,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,SASuD;IAE3E,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA+ElB;gBAGQ,WAAW,EAAE,WAAW;IAK5B,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CAuEnD"}

package/dist/mcp/handlers/run-tests.js

@@ -0,0 +1,233 @@
+/**
+ * Run Tests Handler
+ *
+ * Handles the run-tests tool which executes test suites against APIs.
+ *
+ * @module mcp/handlers/run-tests
+ */
+import { BaseToolHandler } from './base-handler.js';
+import { TestRunner } from '../../executor/test-runner.js';
+/**
+ * Handler for test execution tool
+ */
+export class RunTestsHandler extends BaseToolHandler {
+    specService;
+    name = 'run-tests';
+    description = 'STEP 2 of 3 — Execute test cases against a live API and return pass/fail results. ' +
+        'Receives the "tests" array from generate-tests and runs each test case against baseUrl. ' +
+        'Happy-path tests run sequentially first; if a login endpoint returns a token, it is ' +
+        'automatically captured and injected as Bearer token for all subsequent protected endpoints — ' +
+        'no manual token handling needed. ' +
+        'For APIs that require credentials, provide the "credentials" object: ' +
+        'use bearerToken for a pre-existing JWT, apiKey for API key auth, ' +
+        'username+password for Basic/form login, or clientId+clientSecret for OAuth2. ' +
+        'The auth type is auto-detected from the OpenAPI spec security schemes.';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            specPath: {
+                type: 'string',
+                description: 'Path to the OpenAPI spec file (YAML or JSON). ' +
+                    'Required for schema validation and OAuth2 token URL auto-discovery. ' +
+                    'Example: "/project/api/openapi.yaml".'
+            },
+            baseUrl: {
+                type: 'string',
+                description: 'Base URL of the live API to test. ' +
+                    'Example: "https://api.example.com" or "http://localhost:3000". ' +
+                    'All test requests are sent to this URL.'
+            },
+            tests: {
+                type: 'array',
+                description: 'Array of test cases to execute — pass the "tests" value returned by generate-tests directly here.',
+                items: { type: 'object' }
+            },
+            credentials: {
+                type: 'object',
+                description: 'API credentials for authenticated endpoints. ' +
+                    'Provide only the fields that match your auth type — the tool auto-detects which to use. ' +
+                    'bearerToken: use when you already have a JWT/Bearer token. ' +
+                    'apiKey: use for API key auth (sent as X-API-Key header). ' +
+                    'username + password: use for Basic auth or form-based login. ' +
+                    'clientId + clientSecret: use for OAuth2 client credentials flow. ' +
+                    'Example for OAuth2: { "clientId": "myapp", "clientSecret": "s3cr3t" }.',
+                properties: {
+                    bearerToken: {
+                        type: 'string',
+                        description: 'Pre-existing Bearer/JWT token to use for the Authorization header'
+                    },
+                    apiKey: {
+                        type: 'string',
+                        description: 'API key value (sent as X-API-Key request header)'
+                    },
+                    username: {
+                        type: 'string',
+                        description: 'Username for Basic auth or OAuth2 password flow'
+                    },
+                    password: {
+                        type: 'string',
+                        description: 'Password for Basic auth or OAuth2 password flow'
+                    },
+                    clientId: {
+                        type: 'string',
+                        description: 'OAuth2 client ID for client credentials flow'
+                    },
+                    clientSecret: {
+                        type: 'string',
+                        description: 'OAuth2 client secret for client credentials flow'
+                    }
+                }
+            },
+            authToken: {
+                type: 'string',
+                description: 'Bearer token shortcut (deprecated — use credentials.bearerToken instead).'
+            },
+            testData: {
+                type: 'object',
+                description: 'Domain-specific values to inject into tests at runtime. ' +
+                    'Use the same keys as in generate-tests. ' +
+                    'Example: { "userId": "123", "productId": "prod_abc" }.',
+                additionalProperties: true
+            },
+            parallel: {
+                type: 'boolean',
+                description: 'Run non-happy-path tests in parallel batches for speed (default: false). ' +
+                    'Happy-path tests always run sequentially for automatic token detection.'
+            },
+            timeout: {
+                type: 'number',
+                description: 'Per-request timeout in milliseconds (default: 5000). ' +
+                    'Increase for slow APIs. Example: 10000 for 10 seconds.'
+            }
+        },
+        required: ['baseUrl']
+    };
+    constructor(specService) {
+        super();
+        this.specService = specService;
+    }
+    async handle(args) {
+        const params = args;
+        this.log.info('Running tests', {
+            baseUrl: params.baseUrl,
+            testCount: params.tests?.length || 0,
+            hasAuth: !!(params.authToken || params.credentials),
+            parallel: params.parallel || false
+        });
+        try {
+            // Get tests to run
+            const tests = params.tests || [];
+            if (tests.length === 0) {
+                throw new Error('No tests provided. Use generate-tests first or provide tests array.');
+            }
+            // Parse spec first (needed for both endpoint extraction and OAuth2 tokenUrl discovery)
+            let endpoints = [];
+            let specDoc = null;
+            if (params.specPath) {
+                specDoc = await this.specService.parseSpec(params.specPath);
+                endpoints = await this.specService.extractEndpoints(specDoc);
+            }
+            // Build minimal environment for TestRunner
+            const environment = {
+                name: 'test',
+                baseUrl: params.baseUrl,
+                timeout: params.timeout || 5000,
+                auth: buildAuthConfig(params.credentials, params.authToken, specDoc),
+            };
+            // Run tests
+            const runner = new TestRunner(environment);
+            const runResult = await runner.runTests(tests, endpoints, {
+                parallel: params.parallel ? 5 : 1
+            });
+            const results = runResult.results;
+            const total = results.length;
+            const passed = results.filter(r => r.status === 'passed').length;
+            const failed = results.filter(r => r.status === 'failed').length;
+            this.log.info('Tests completed', { total, passed, failed });
+            return this.formatResponse({
+                success: true,
+                results,
+                summary: {
+                    total,
+                    passed,
+                    failed,
+                    passRate: total > 0
+                        ? `${((passed / total) * 100).toFixed(2)}%`
+                        : '0.00%',
+                }
+            });
+        }
+        catch (error) {
+            return this.formatError(error);
+        }
+    }
+}
+/**
+ * Builds an AuthConfig from flat credentials and/or a legacy authToken.
+ * Auth type is auto-detected from the available credential fields.
+ * For OAuth2, the tokenUrl is extracted from the OpenAPI spec when available.
+ */
+function buildAuthConfig(credentials, authToken, specDoc) {
+    // 1. Deprecated authToken shortcut (no credentials object)
+    if (authToken && !credentials) {
+        return { type: 'bearer', token: authToken };
+    }
+    if (!credentials)
+        return undefined;
+    // 2. Explicit bearer token inside credentials (highest priority)
+    if (credentials.bearerToken) {
+        return { type: 'bearer', token: credentials.bearerToken };
+    }
+    // 3. Legacy authToken alongside credentials
+    if (authToken) {
+        return { type: 'bearer', token: authToken };
+    }
+    // 4. OAuth2: needs clientId + clientSecret; tokenUrl extracted from spec when available
+    if (credentials.clientId && credentials.clientSecret) {
+        const tokenUrl = extractOAuth2TokenUrl(specDoc) || '';
+        return {
+            type: 'oauth2',
+            oauth2: {
+                tokenUrl,
+                clientId: credentials.clientId,
+                clientSecret: credentials.clientSecret,
+                ...(credentials.username && { username: credentials.username }),
+                ...(credentials.password && { password: credentials.password }),
+            }
+        };
+    }
+    // 5. API key → default header name X-API-Key
+    if (credentials.apiKey) {
+        return {
+            type: 'api-key',
+            apiKey: { name: 'X-API-Key', in: 'header', value: credentials.apiKey }
+        };
+    }
+    // 6. Basic auth (username + password without OAuth2 client credentials)
+    if (credentials.username && credentials.password) {
+        return {
+            type: 'basic',
+            basic: { username: credentials.username, password: credentials.password }
+        };
+    }
+    return undefined;
+}
+/**
+ * Attempts to extract an OAuth2 tokenUrl from the OpenAPI spec's security schemes.
+ * Returns the first tokenUrl found across all OAuth2 flows, or undefined.
+ */
+function extractOAuth2TokenUrl(specDoc) {
+    const schemes = specDoc?.components?.securitySchemes;
+    if (!schemes)
+        return undefined;
+    for (const scheme of Object.values(schemes)) {
+        if (scheme.type === 'oauth2' && scheme.flows) {
+            for (const flow of Object.values(scheme.flows)) {
+                if (flow?.tokenUrl)
+                    return flow.tokenUrl;
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=run-tests.js.map

package/dist/mcp/handlers/run-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tests.js","sourceRoot":"","sources":["../../../src/mcp/handlers/run-tests.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IA+FxC;IA9FD,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAClB,oFAAoF;QACpF,0FAA0F;QAC1F,sFAAsF;QACtF,+FAA+F;QAC/F,mCAAmC;QACnC,uEAAuE;QACvE,mEAAmE;QACnE,+EAA+E;QAC/E,wEAAwE,CAAC;IAElE,WAAW,GAAG;QACrB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;oBAC3D,sEAAsE;oBACtE,uCAAuC;aAC1C;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;oBAC/C,iEAAiE;oBACjE,yCAAyC;aAC5C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,mGAAmG;gBAChH,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;oBAC1D,0FAA0F;oBAC1F,6DAA6D;oBAC7D,2DAA2D;oBAC3D,+DAA+D;oBAC/D,mEAAmE;oBACnE,wEAAwE;gBAC1E,UAAU,EAAE;oBACV,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mEAAmE;qBACjF;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,kDAAkD;qBAChE;oBACD,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iDAAiD;qBAC/D;oBACD,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iDAAiD;qBAC/D;oBACD,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,8CAA8C;qBAC5D;oBACD,YAAY,EAAE;wBACZ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,kDAAkD;qBAChE;iBACF;aACF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2EAA2E;aACzF;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;oBACrE,0CAA0C;oBAC1C,wDAAwD;gBAC1D,oBAAoB,EAAE,IAAI;aAC3B;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,2EAA2E;oBACtF,yEAAyE;aAC5E;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;oBAClE,wDAAwD;aAC3D;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB,CAAC;IAEF,YACU,WAAwB;QAEhC,KAAK,EAAE,CAAC;QAFA,gBAAW,GAAX,WAAW,CAAa;IAGlC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAa;QACxB,MAAM,MAAM,GAAG,IASd,CAAC;QAEF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;YACpC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,WAAW,CAAC;YACnD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;SACnC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,mBAAmB;YACnB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;YACzF,CAAC;YAED,uFAAuF;YACvF,IAAI,SAAS,GAAqB,EAAE,CAAC;YACrC,IAAI,OAAO,GAAQ,IAAI,CAAC;YACxB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC5D,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC/D,CAAC;YAED,2CAA2C;YAC3C,MAAM,WAAW,GAAgB;gBAC/B,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;gBAC/B,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC;aACrE,CAAC;YAEF,YAAY;YACZ,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;YAC3C,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE;gBACxD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aAClC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;YAClC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;YAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;YACjE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;YAEjE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAE5D,OAAO,IAAI,CAAC,cAAc,CAAC;gBACzB,OAAO,EAAE,IAAI;gBACb,OAAO;gBACP,OAAO,EAAE;oBACP,KAAK;oBACL,MAAM;oBACN,MAAM;oBACN,QAAQ,EAAE,KAAK,GAAG,CAAC;wBACjB,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;wBAC3C,CAAC,CAAC,OAAO;iBACZ;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;CACF;AAED;;;;GAIG;AACH,SAAS,eAAe,CACtB,WAA+C,EAC/C,SAA6B,EAC7B,OAAY;IAEZ,2DAA2D;IAC3D,IAAI,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IAEnC,iEAAiE;IACjE,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC;IAC5D,CAAC;IAED,4CAA4C;IAC5C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;IAED,wFAAwF;IACxF,IAAI,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtD,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE;gBACN,QAAQ;gBACR,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,GAAG,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC;gBAC/D,GAAG,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC;aAChE;SACF,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE;SACvE,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,IAAI,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;QACjD,OAAO;YACL,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE;SAC1E,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,OAAY;IACzC,MAAM,OAAO,GAAG,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC;IACrD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAU,EAAE,CAAC;QACrD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAU,EAAE,CAAC;gBACxD,IAAK,IAAY,EAAE,QAAQ;oBAAE,OAAQ,IAAY,CAAC,QAAQ,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/mcp/handlers/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Handler types - Common interfaces for MCP tool handlers
+ *
+ * Defines the contract that all tool handlers must implement.
+ *
+ * @module mcp/handlers/types
+ */
+/**
+ * Response from a tool handler
+ */
+export interface ToolResponse {
+    /**
+     * Content blocks to return to the MCP client
+     */
+    content: Array<{
+        /**
+         * Content type (usually 'text')
+         */
+        type: string;
+        /**
+         * Content text/data
+         */
+        text: string;
+    }>;
+    /**
+     * Optional error flag
+     */
+    isError?: boolean;
+}
+/**
+ * Tool handler interface
+ *
+ * All MCP tool handlers must implement this interface.
+ */
+export interface ToolHandler {
+    /**
+     * Tool name (matches MCP tool name)
+     */
+    readonly name: string;
+    /**
+     * Tool description (shown to MCP clients)
+     */
+    readonly description: string;
+    /**
+     * JSON Schema for tool input validation
+     */
+    readonly inputSchema: {
+        type: string;
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+    /**
+     * Handles the tool invocation
+     *
+     * @param args - Tool arguments (validated against inputSchema)
+     * @returns Tool response
+     */
+    handle(args: unknown): Promise<ToolResponse>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/handlers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC;QACb;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IAEH;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IAEF;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9C"}

package/dist/mcp/handlers/types.js

@@ -0,0 +1,9 @@
+/**
+ * Handler types - Common interfaces for MCP tool handlers
+ *
+ * Defines the contract that all tool handlers must implement.
+ *
+ * @module mcp/handlers/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp/handlers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,64 @@
+/**
+ * MCP Server Implementation
+ *
+ * Model Context Protocol server for OpenAPI contract testing.
+ * Provides tools for test generation, execution, and contract validation
+ * via STDIO transport for MCP client integration.
+ *
+ * This server uses a handler registry pattern for clean separation of concerns.
+ *
+ * @module mcp/server
+ */
+import { type ToolHandler } from './handlers/index.js';
+/**
+ * OpenAPI Contract Tester MCP Server
+ *
+ * Provides 5 essential tools for API testing:
+ * 1. generate-tests - Generate intelligent test suites from OpenAPI specs (AI-powered)
+ * 2. run-tests - Execute test suites against APIs with auto-repair
+ * 3. export-results - Export test results with AI analysis and coverage
+ * 4. compare-sources - Compare OpenAPI vs Code vs PRD
+ * 5. export-to-postman - Export tests as Postman Collection v2.1 (Newman compatible)
+ *
+ * Architecture:
+ * - Uses Strategy pattern for tool handlers
+ * - Each handler implements ToolHandler interface
+ * - Services provide shared functionality (spec parsing, LLM calls, reporting, file I/O)
+ * - Handler registry enables clean dispatch and extensibility
+ */
+export declare class OpenAPIContractTesterServer {
+    private server;
+    private handlers;
+    private specService;
+    private reportService;
+    private fileService;
+    private postmanService;
+    constructor();
+    /**
+     * Registers all tool handlers
+     * @private
+     */
+    private registerHandlers;
+    /**
+     * Sets up MCP request handlers
+     * @private
+     */
+    private setupHandlers;
+    /**
+     * Starts the MCP server
+     */
+    run(): Promise<void>;
+    /**
+     * Stops the MCP server gracefully
+     */
+    stop(): Promise<void>;
+    /**
+     * Gets the list of registered handlers (for testing/debugging)
+     */
+    getHandlers(): ReadonlyMap<string, ToolHandler>;
+}
+/**
+ * Creates and starts the MCP server
+ */
+export declare function startMCPServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAQ7B;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAA2B;IAG3C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAiB;;IAmCvC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAqErB;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB1B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B;;OAEG;IACH,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC;CAGhD;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpD"}