mnehmos.trace.mcp 1.0.0

package/dist/adapters/mcp.js

@@ -0,0 +1,293 @@
+/**
+ * MCP Schema Adapter
+ * Converts MCP tool definitions to NormalizedSchema
+ */
+import { Project, Node } from 'ts-morph';
+/**
+ * MCP adapter for extracting schemas from MCP server.tool() calls
+ */
+export class MCPAdapter {
+    kind = 'mcp';
+    supports(ref) {
+        return ref.source === 'mcp';
+    }
+    async extract(ref) {
+        const { id, options } = ref;
+        // Parse ID format: "file:path/to/file.ts" or "dir:path/to/dir" or "tool:toolName@path"
+        // Use indexOf to handle Windows paths with colons (e.g., C:\path\to\file.ts)
+        const colonIndex = id.indexOf(':');
+        if (colonIndex === -1) {
+            throw new Error(`Invalid ID format (missing type prefix): ${id}`);
+        }
+        const type = id.slice(0, colonIndex);
+        const pathPart = id.slice(colonIndex + 1);
+        if (type === 'file') {
+            return this.extractFromFile(pathPart, ref);
+        }
+        else if (type === 'dir') {
+            // Extract first tool from directory (or could return all)
+            const schemas = await this.extractFromDirectory(pathPart, options);
+            if (schemas.length === 0) {
+                throw new Error(`No MCP tools found in directory: ${pathPart}`);
+            }
+            return schemas[0];
+        }
+        else if (type === 'tool') {
+            // Format: "tool:toolName@path"
+            const atIndex = pathPart.indexOf('@');
+            if (atIndex === -1) {
+                throw new Error(`Invalid tool ID format (missing @): ${id}`);
+            }
+            const toolName = pathPart.slice(0, atIndex);
+            const filePath = pathPart.slice(atIndex + 1);
+            return this.extractToolByName(toolName, filePath, ref);
+        }
+        else {
+            throw new Error(`Unsupported MCP schema reference format: ${id}`);
+        }
+    }
+    async list(basePath) {
+        const project = new Project({
+            tsConfigFilePath: undefined,
+            skipAddingFilesFromTsConfig: true,
+        });
+        project.addSourceFilesAtPaths([`${basePath}/**/*.ts`]);
+        const refs = [];
+        for (const sourceFile of project.getSourceFiles()) {
+            const filePath = sourceFile.getFilePath();
+            // Skip node_modules and dist
+            if (filePath.includes('node_modules') || filePath.includes('dist')) {
+                continue;
+            }
+            const toolCalls = this.findToolCalls(sourceFile);
+            for (const toolCall of toolCalls) {
+                const toolName = this.extractToolName(toolCall);
+                if (toolName) {
+                    refs.push({
+                        source: 'mcp',
+                        id: `tool:${toolName}@${filePath}`,
+                    });
+                }
+            }
+        }
+        return refs;
+    }
+    // ============================================================================
+    // Private extraction methods
+    // ============================================================================
+    async extractFromFile(filePath, ref) {
+        const project = new Project({
+            skipAddingFilesFromTsConfig: true,
+        });
+        const sourceFile = project.addSourceFileAtPath(filePath);
+        const toolCalls = this.findToolCalls(sourceFile);
+        if (toolCalls.length === 0) {
+            throw new Error(`No MCP tools found in file: ${filePath}`);
+        }
+        // Extract first tool (or specific tool if specified in options)
+        const toolCall = toolCalls[0];
+        return this.parseToolCallToNormalized(toolCall, filePath, ref);
+    }
+    async extractFromDirectory(dirPath, options) {
+        const project = new Project({
+            tsConfigFilePath: undefined,
+            skipAddingFilesFromTsConfig: true,
+        });
+        const patterns = options?.include || ['**/*.ts'];
+        const excludePatterns = options?.exclude || [
+            '**/node_modules/**',
+            '**/dist/**',
+        ];
+        project.addSourceFilesAtPaths(patterns.map((p) => `${dirPath}/${p}`));
+        const schemas = [];
+        for (const sourceFile of project.getSourceFiles()) {
+            const filePath = sourceFile.getFilePath();
+            // Skip excluded patterns
+            if (excludePatterns.some((pattern) => filePath.includes(pattern.replace('**/', '')))) {
+                continue;
+            }
+            const toolCalls = this.findToolCalls(sourceFile);
+            for (const toolCall of toolCalls) {
+                const ref = { source: 'mcp', id: `file:${filePath}` };
+                const schema = this.parseToolCallToNormalized(toolCall, filePath, ref);
+                schemas.push(schema);
+            }
+        }
+        return schemas;
+    }
+    async extractToolByName(toolName, filePath, ref) {
+        const project = new Project({
+            skipAddingFilesFromTsConfig: true,
+        });
+        const sourceFile = project.addSourceFileAtPath(filePath);
+        const toolCalls = this.findToolCalls(sourceFile);
+        for (const toolCall of toolCalls) {
+            const name = this.extractToolName(toolCall);
+            if (name === toolName) {
+                return this.parseToolCallToNormalized(toolCall, filePath, ref);
+            }
+        }
+        throw new Error(`Tool "${toolName}" not found in ${filePath}`);
+    }
+    // ============================================================================
+    // Parsing utilities
+    // ============================================================================
+    findToolCalls(sourceFile) {
+        const toolCalls = [];
+        sourceFile.forEachDescendant((node) => {
+            if (Node.isCallExpression(node)) {
+                const expression = node.getExpression();
+                // Check for pattern: server.tool() or *.tool()
+                if (Node.isPropertyAccessExpression(expression)) {
+                    const methodName = expression.getName();
+                    if (methodName === 'tool') {
+                        toolCalls.push(node);
+                    }
+                }
+            }
+        });
+        return toolCalls;
+    }
+    extractToolName(callExpr) {
+        const args = callExpr.getArguments();
+        if (args.length === 0)
+            return null;
+        const nameArg = args[0];
+        if (Node.isStringLiteral(nameArg)) {
+            return nameArg.getLiteralValue();
+        }
+        return null;
+    }
+    parseToolCallToNormalized(callExpr, filePath, ref) {
+        const args = callExpr.getArguments();
+        if (args.length < 3) {
+            throw new Error(`Invalid tool call at ${filePath}:${callExpr.getStartLineNumber()}`);
+        }
+        // Extract tool name
+        const nameArg = args[0];
+        let toolName = 'unknown';
+        if (Node.isStringLiteral(nameArg)) {
+            toolName = nameArg.getLiteralValue();
+        }
+        // Extract description (second argument if string, otherwise schema is second)
+        let description;
+        let schemaArg;
+        const secondArg = args[1];
+        if (Node.isStringLiteral(secondArg)) {
+            description = secondArg.getLiteralValue();
+            schemaArg = args[2];
+        }
+        else {
+            schemaArg = secondArg;
+        }
+        // Parse the Zod schema object to NormalizedSchema
+        const normalized = this.parseZodSchemaToNormalized(schemaArg);
+        const location = {
+            file: filePath,
+            line: callExpr.getStartLineNumber(),
+            column: callExpr.getStartLinePos(),
+        };
+        return {
+            ...normalized,
+            name: toolName,
+            source: ref,
+            location,
+        };
+    }
+    parseZodSchemaToNormalized(node) {
+        const properties = {};
+        const required = [];
+        if (!Node.isObjectLiteralExpression(node)) {
+            return { properties, required, source: { source: 'mcp', id: '' } };
+        }
+        for (const prop of node.getProperties()) {
+            if (!Node.isPropertyAssignment(prop))
+                continue;
+            const propName = prop.getName();
+            const initializer = prop.getInitializer();
+            if (!initializer)
+                continue;
+            // Parse the Zod type chain
+            const type = this.parseZodType(initializer);
+            const initText = initializer.getText();
+            const isOptional = initText.includes('.optional()');
+            const isNullable = initText.includes('.nullable()');
+            const isDeprecated = initText.includes('.deprecated()');
+            properties[propName] = {
+                type,
+                optional: isOptional,
+                nullable: isNullable,
+                readonly: false,
+                deprecated: isDeprecated,
+            };
+            if (!isOptional) {
+                required.push(propName);
+            }
+        }
+        return {
+            properties,
+            required,
+            source: { source: 'mcp', id: '' },
+        };
+    }
+    parseZodType(node) {
+        const text = node.getText();
+        // z.string()
+        if (text.includes('z.string()')) {
+            return { kind: 'primitive', value: 'string' };
+        }
+        // z.number()
+        if (text.includes('z.number()')) {
+            return { kind: 'primitive', value: 'number' };
+        }
+        // z.boolean()
+        if (text.includes('z.boolean()')) {
+            return { kind: 'primitive', value: 'boolean' };
+        }
+        // z.literal(...)
+        if (text.includes('z.literal(')) {
+            const literalMatch = text.match(/z\.literal\((.*?)\)/);
+            if (literalMatch) {
+                const value = literalMatch[1].replace(/['"]/g, '');
+                return { kind: 'literal', value };
+            }
+        }
+        // z.enum([...])
+        if (text.includes('z.enum(')) {
+            const enumMatch = text.match(/z\.enum\(\[(.*?)\]\)/);
+            if (enumMatch) {
+                const values = enumMatch[1]
+                    .split(',')
+                    .map((v) => v.trim().replace(/['"]/g, ''));
+                // Convert enum to union of literals
+                return {
+                    kind: 'union',
+                    variants: values.map((v) => ({ kind: 'literal', value: v })),
+                };
+            }
+        }
+        // z.array(...)
+        if (text.includes('z.array(')) {
+            // For now, return array of unknown
+            // TODO: Parse element type
+            return { kind: 'array', element: { kind: 'unknown' } };
+        }
+        // z.object(...)
+        if (text.includes('z.object(')) {
+            // For now, return object with empty schema
+            // TODO: Parse nested object
+            return {
+                kind: 'object',
+                schema: { properties: {}, required: [], source: { source: 'mcp', id: '' } },
+            };
+        }
+        // z.union([...])
+        if (text.includes('z.union(')) {
+            // For now, return generic union
+            return { kind: 'union', variants: [{ kind: 'unknown' }] };
+        }
+        // Default
+        return { kind: 'unknown' };
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/adapters/mcp.js.map

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

package/dist/adapters/openapi/adapter.d.ts

@@ -0,0 +1,213 @@
+/**
+ * 📋 OpenAPI Schema Adapter
+ * Extracts and converts OpenAPI/Swagger specifications to NormalizedSchema
+ *
+ * This adapter implements the SchemaAdapter interface for OpenAPI 3.x
+ * specifications. It supports extraction of:
+ * - Full endpoints (request + all responses)
+ * - Request body schemas
+ * - Response schemas by status code
+ * - Component schemas
+ * - File-level extraction (first endpoint)
+ *
+ * @module adapters/openapi/adapter
+ */
+import type { SchemaAdapter, SchemaRef, NormalizedSchema } from '../../core/types.js';
+/**
+ * Schema adapter for OpenAPI 3.x specifications.
+ *
+ * Implements the SchemaAdapter interface to extract schemas from
+ * OpenAPI/Swagger specifications. Uses `@apidevtools/swagger-parser`
+ * for parsing and validation.
+ *
+ * @implements {SchemaAdapter}
+ *
+ * @example
+ * ```typescript
+ * import { OpenAPIAdapter } from './adapter.js';
+ * import { registerAdapter } from '../registry.js';
+ *
+ * // Register the adapter
+ * registerAdapter(new OpenAPIAdapter());
+ *
+ * // Extract an endpoint schema
+ * const adapter = new OpenAPIAdapter();
+ * const schema = await adapter.extract({
+ *   source: 'openapi',
+ *   id: 'endpoint:GET:/users/{id}@./api.yaml'
+ * });
+ * ```
+ */
+export declare class OpenAPIAdapter implements SchemaAdapter {
+    /** Adapter kind identifier */
+    readonly kind: "openapi";
+    /**
+     * Check if this adapter supports the given schema reference.
+     *
+     * @param ref - The schema reference to check
+     * @returns True if the ref source is 'openapi'
+     */
+    supports(ref: SchemaRef): boolean;
+    /**
+     * Extract a schema from an OpenAPI specification.
+     *
+     * Parses the ref ID to determine what to extract:
+     * - `file:` - Extract first endpoint from spec
+     * - `endpoint:` - Full endpoint schema (request + responses)
+     * - `request:` - Request body schema only
+     * - `response:` - Specific response by status code
+     * - `schema:` - Named component schema
+     *
+     * @param ref - The schema reference specifying what to extract
+     * @returns Promise resolving to the normalized schema
+     * @throws {Error} If the ref ID is invalid or extraction fails
+     *
+     * @example
+     * ```typescript
+     * // Extract a full endpoint
+     * const schema = await adapter.extract({
+     *   source: 'openapi',
+     *   id: 'endpoint:GET:/users/{id}@./api.yaml'
+     * });
+     *
+     * // Extract a component schema
+     * const schema = await adapter.extract({
+     *   source: 'openapi',
+     *   id: 'schema:User@./api.yaml'
+     * });
+     * ```
+     */
+    extract(ref: SchemaRef): Promise<NormalizedSchema>;
+    /**
+     * List all endpoints in an OpenAPI specification.
+     *
+     * Scans the paths object and returns a SchemaRef for each
+     * method/path combination found. Handles errors gracefully
+     * by returning an empty array per ADR guidelines.
+     *
+     * @param basePath - Path to the OpenAPI specification file
+     * @returns Promise resolving to array of endpoint SchemaRefs
+     *
+     * @example
+     * ```typescript
+     * const refs = await adapter.list('./api.yaml');
+     * // [
+     * //   { source: 'openapi', id: 'endpoint:GET:/users@./api.yaml' },
+     * //   { source: 'openapi', id: 'endpoint:POST:/users@./api.yaml' },
+     * //   ...
+     * // ]
+     * ```
+     */
+    list(basePath: string): Promise<SchemaRef[]>;
+    /**
+     * Load and validate an OpenAPI specification.
+     *
+     * Uses swagger-parser to validate the spec and resolve references.
+     *
+     * @param specPath - Path to the specification file
+     * @returns Promise resolving to the parsed OpenAPI document
+     * @throws {Error} If the spec cannot be loaded or is invalid
+     */
+    private loadSpec;
+    /**
+     * Extract the first endpoint from a spec.
+     *
+     * Used for `file:` refs that don't specify a specific endpoint.
+     *
+     * @param api - The parsed OpenAPI document
+     * @param specPath - Path to the spec file
+     * @param ref - The original schema reference
+     * @returns The normalized schema for the first endpoint
+     * @throws {Error} If no endpoints are found
+     */
+    private extractFirstEndpoint;
+    /**
+     * Extract a full endpoint schema (request + responses).
+     *
+     * Creates a normalized schema with two top-level properties:
+     * - `request`: Path params, query params, headers, and body
+     * - `responses`: All response schemas keyed by status code
+     *
+     * @param api - The parsed OpenAPI document
+     * @param method - HTTP method (GET, POST, etc.)
+     * @param path - API path (/users/{id})
+     * @param ref - The original schema reference
+     * @param specPath - Path to the spec file
+     * @returns The normalized endpoint schema
+     * @throws {Error} If path or method not found
+     */
+    private extractEndpoint;
+    /**
+     * Build the request schema for an endpoint.
+     *
+     * Combines path-level and operation-level parameters into
+     * a structured schema with path, query, headers, and body sections.
+     *
+     * @param api - The parsed OpenAPI document
+     * @param operation - The operation object
+     * @param pathItem - The path item object
+     * @param ref - The original schema reference
+     * @returns The request schema
+     */
+    private buildRequestSchema;
+    /**
+     * Build the responses schema for an endpoint.
+     *
+     * Creates a schema with status codes as property keys,
+     * each containing the response body schema.
+     *
+     * @param operation - The operation object
+     * @param ref - The original schema reference
+     * @returns The responses schema
+     */
+    private buildResponsesSchema;
+    /**
+     * Extract just the request body schema for an endpoint.
+     *
+     * @param api - The parsed OpenAPI document
+     * @param method - HTTP method
+     * @param path - API path
+     * @param ref - The original schema reference
+     * @returns The request body schema
+     * @throws {Error} If no request body is defined
+     */
+    private extractRequest;
+    /**
+     * Extract a response schema by status code.
+     *
+     * @param api - The parsed OpenAPI document
+     * @param method - HTTP method
+     * @param path - API path
+     * @param statusCode - Response status code (e.g., '200')
+     * @param ref - The original schema reference
+     * @returns The response body schema
+     * @throws {Error} If response not found
+     */
+    private extractResponse;
+    /**
+     * Extract a component schema by name.
+     *
+     * @param api - The parsed OpenAPI document
+     * @param schemaName - Name of the component schema
+     * @param ref - The original schema reference
+     * @param specPath - Path to the spec file
+     * @returns The component schema
+     * @throws {Error} If schema not found
+     */
+    private extractComponentSchema;
+    /**
+     * Dereference a schema by resolving $ref if present.
+     *
+     * Recursively resolves references in the schema tree, including:
+     * - Top-level $ref
+     * - allOf, oneOf, anyOf members
+     * - Array items
+     * - Object properties
+     *
+     * @param api - The parsed OpenAPI document
+     * @param schema - The schema to dereference
+     * @returns The dereferenced schema object
+     */
+    private dereferenceSchema;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/openapi/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/openapi/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,gBAAgB,EAGjB,MAAM,qBAAqB,CAAC;AAW7B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IAEnC;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO;IAIjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6BxD;;;;;;;;;;;;;;;;;;;OAmBG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA+BlD;;;;;;;;OAQG;YACW,QAAQ;IAatB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,eAAe;IAuDvB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,kBAAkB;IAmF1B;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IA4C5B;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;IAgCtB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,eAAe;IAsCvB;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;IA+B9B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,iBAAiB;CAsE1B"}