mnehmos.trace.mcp 1.0.0

package/dist/adapters/bootstrap.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 🚀 Adapter Bootstrap
+ * Initializes the adapter registry with all built-in adapters
+ *
+ * @module adapters/bootstrap
+ */
+/**
+ * Bootstrap the adapter registry with all built-in adapters.
+ *
+ * This function should be called once during application startup
+ * to register all available schema adapters. Currently registers:
+ *
+ * - **MCP Adapter** (`mcp`): For MCP tool schemas
+ * - **OpenAPI Adapter** (`openapi`): For OpenAPI/Swagger specifications
+ * - **tRPC Adapter** (`trpc`): For tRPC router definitions
+ *
+ * Multiple calls are safe due to last-wins replacement semantics.
+ *
+ * @example
+ * ```typescript
+ * // In your application entry point
+ * import { bootstrapAdapters } from './adapters';
+ *
+ * bootstrapAdapters();
+ * // Now you can use getAdapter('mcp') or getAdapter('openapi') or getAdapter('trpc')
+ * ```
+ */
+export declare function bootstrapAdapters(): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/adapters/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/adapters/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAiBxC"}

package/dist/adapters/bootstrap.js

@@ -0,0 +1,46 @@
+/**
+ * 🚀 Adapter Bootstrap
+ * Initializes the adapter registry with all built-in adapters
+ *
+ * @module adapters/bootstrap
+ */
+import { registerAdapter } from './registry.js';
+import { MCPAdapter } from './mcp.js';
+import { OpenAPIAdapter } from './openapi/index.js';
+import { TRPCAdapter } from './trpc/index.js';
+/**
+ * Bootstrap the adapter registry with all built-in adapters.
+ *
+ * This function should be called once during application startup
+ * to register all available schema adapters. Currently registers:
+ *
+ * - **MCP Adapter** (`mcp`): For MCP tool schemas
+ * - **OpenAPI Adapter** (`openapi`): For OpenAPI/Swagger specifications
+ * - **tRPC Adapter** (`trpc`): For tRPC router definitions
+ *
+ * Multiple calls are safe due to last-wins replacement semantics.
+ *
+ * @example
+ * ```typescript
+ * // In your application entry point
+ * import { bootstrapAdapters } from './adapters';
+ *
+ * bootstrapAdapters();
+ * // Now you can use getAdapter('mcp') or getAdapter('openapi') or getAdapter('trpc')
+ * ```
+ */
+export function bootstrapAdapters() {
+    if (process.env.DEBUG_TRACE_MCP) {
+        console.error('[AdapterBootstrap] Registering built-in adapters...');
+    }
+    // Register MCP adapter for MCP tool schemas
+    registerAdapter(new MCPAdapter());
+    // Register OpenAPI adapter for OpenAPI/Swagger specifications
+    registerAdapter(new OpenAPIAdapter());
+    // Register tRPC adapter for tRPC router definitions
+    registerAdapter(new TRPCAdapter());
+    if (process.env.DEBUG_TRACE_MCP) {
+        console.error('[AdapterBootstrap] Built-in adapters registered');
+    }
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/adapters/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/adapters/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACvE,CAAC;IAED,4CAA4C;IAC5C,eAAe,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC;IAElC,8DAA8D;IAC9D,eAAe,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;IAEtC,oDAAoD;IACpD,eAAe,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;IAEnC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/adapters/errors.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 🚨 Adapter Registry Errors
+ * Custom error types for the adapter registry system
+ *
+ * @module adapters/errors
+ */
+import type { SchemaAdapter, SchemaSourceKind } from '../core/types.js';
+/**
+ * Base error class for all adapter registry operations.
+ *
+ * All adapter-specific errors inherit from this class, allowing
+ * consumers to catch all adapter errors with a single catch block.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const adapter = getAdapter('unknown-kind');
+ * } catch (error) {
+ *   if (error instanceof AdapterRegistryError) {
+ *     console.error('Adapter operation failed:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export declare class AdapterRegistryError extends Error {
+    /**
+     * Creates a new AdapterRegistryError.
+     *
+     * @param message - Human-readable error description
+     */
+    constructor(message: string);
+}
+/**
+ * Error thrown when a requested adapter is not found in the registry.
+ *
+ * This error provides context about what kind was requested and
+ * what kinds are currently available, aiding in debugging.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const adapter = getAdapter('graphql');
+ * } catch (error) {
+ *   if (error instanceof AdapterNotFoundError) {
+ *     console.log(`Requested: ${error.kind}`);
+ *     console.log(`Available: ${error.available.join(', ')}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class AdapterNotFoundError extends AdapterRegistryError {
+    /** The kind that was requested but not found */
+    readonly kind: SchemaSourceKind;
+    /** List of currently registered adapter kinds */
+    readonly available: SchemaSourceKind[];
+    /**
+     * Creates a new AdapterNotFoundError.
+     *
+     * @param kind - The schema source kind that was requested
+     * @param available - List of currently registered adapter kinds
+     */
+    constructor(kind: SchemaSourceKind, available: SchemaSourceKind[]);
+}
+/**
+ * Error thrown when adapter validation fails during registration.
+ *
+ * This error is thrown when an adapter doesn't meet the required
+ * interface contract (missing kind, supports, or extract methods).
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   registerAdapter({ kind: 'test' } as SchemaAdapter);
+ * } catch (error) {
+ *   if (error instanceof AdapterValidationError) {
+ *     console.log(`Validation failed: ${error.reason}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class AdapterValidationError extends AdapterRegistryError {
+    /** The partial adapter object that failed validation */
+    readonly adapter: Partial<SchemaAdapter>;
+    /** Human-readable reason for validation failure */
+    readonly reason: string;
+    /**
+     * Creates a new AdapterValidationError.
+     *
+     * @param adapter - The adapter object that failed validation
+     * @param reason - Human-readable explanation of why validation failed
+     */
+    constructor(adapter: Partial<SchemaAdapter>, reason: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/adapters/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/adapters/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,oBAAqB,SAAQ,oBAAoB;IAC5D,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAEvC;;;;;OAKG;gBACS,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE;CAOlE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAuB,SAAQ,oBAAoB;IAC9D,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzC,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;gBACS,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM;CAM5D"}

package/dist/adapters/errors.js

@@ -0,0 +1,107 @@
+/**
+ * 🚨 Adapter Registry Errors
+ * Custom error types for the adapter registry system
+ *
+ * @module adapters/errors
+ */
+/**
+ * Base error class for all adapter registry operations.
+ *
+ * All adapter-specific errors inherit from this class, allowing
+ * consumers to catch all adapter errors with a single catch block.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const adapter = getAdapter('unknown-kind');
+ * } catch (error) {
+ *   if (error instanceof AdapterRegistryError) {
+ *     console.error('Adapter operation failed:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export class AdapterRegistryError extends Error {
+    /**
+     * Creates a new AdapterRegistryError.
+     *
+     * @param message - Human-readable error description
+     */
+    constructor(message) {
+        super(message);
+        this.name = 'AdapterRegistryError';
+    }
+}
+/**
+ * Error thrown when a requested adapter is not found in the registry.
+ *
+ * This error provides context about what kind was requested and
+ * what kinds are currently available, aiding in debugging.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const adapter = getAdapter('graphql');
+ * } catch (error) {
+ *   if (error instanceof AdapterNotFoundError) {
+ *     console.log(`Requested: ${error.kind}`);
+ *     console.log(`Available: ${error.available.join(', ')}`);
+ *   }
+ * }
+ * ```
+ */
+export class AdapterNotFoundError extends AdapterRegistryError {
+    /** The kind that was requested but not found */
+    kind;
+    /** List of currently registered adapter kinds */
+    available;
+    /**
+     * Creates a new AdapterNotFoundError.
+     *
+     * @param kind - The schema source kind that was requested
+     * @param available - List of currently registered adapter kinds
+     */
+    constructor(kind, available) {
+        const availableStr = available.length > 0 ? available.join(', ') : 'none';
+        super(`No adapter found for kind "${kind}". Available: ${availableStr}`);
+        this.name = 'AdapterNotFoundError';
+        this.kind = kind;
+        this.available = available;
+    }
+}
+/**
+ * Error thrown when adapter validation fails during registration.
+ *
+ * This error is thrown when an adapter doesn't meet the required
+ * interface contract (missing kind, supports, or extract methods).
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   registerAdapter({ kind: 'test' } as SchemaAdapter);
+ * } catch (error) {
+ *   if (error instanceof AdapterValidationError) {
+ *     console.log(`Validation failed: ${error.reason}`);
+ *   }
+ * }
+ * ```
+ */
+export class AdapterValidationError extends AdapterRegistryError {
+    /** The partial adapter object that failed validation */
+    adapter;
+    /** Human-readable reason for validation failure */
+    reason;
+    /**
+     * Creates a new AdapterValidationError.
+     *
+     * @param adapter - The adapter object that failed validation
+     * @param reason - Human-readable explanation of why validation failed
+     */
+    constructor(adapter, reason) {
+        super(`Invalid adapter: ${reason}`);
+        this.name = 'AdapterValidationError';
+        this.adapter = adapter;
+        this.reason = reason;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/adapters/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/adapters/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,oBAAqB,SAAQ,oBAAoB;IAC5D,gDAAgD;IACvC,IAAI,CAAmB;IAEhC,iDAAiD;IACxC,SAAS,CAAqB;IAEvC;;;;;OAKG;IACH,YAAY,IAAsB,EAAE,SAA6B;QAC/D,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1E,KAAK,CAAC,8BAA8B,IAAI,iBAAiB,YAAY,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,sBAAuB,SAAQ,oBAAoB;IAC9D,wDAAwD;IAC/C,OAAO,CAAyB;IAEzC,mDAAmD;IAC1C,MAAM,CAAS;IAExB;;;;;OAKG;IACH,YAAY,OAA+B,EAAE,MAAc;QACzD,KAAK,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/adapters/graphql/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * GraphQL Adapter
+ *
+ * Exports for GraphQL SDL parsing.
+ *
+ * @see .context/ADR-P2-4-GRAPHQL-SUPPORT.md
+ */
+export { SDLParser, parseGraphQLSchema, extractQueryType, extractMutationType, extractSubscriptionType, extractObjectTypes, extractInputTypes, extractEnumTypes, extractInterfaceTypes, extractUnionTypes, graphqlTypeToNormalized, } from './sdl-parser.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/graphql/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/graphql/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}

package/dist/adapters/graphql/index.js

@@ -0,0 +1,9 @@
+/**
+ * GraphQL Adapter
+ *
+ * Exports for GraphQL SDL parsing.
+ *
+ * @see .context/ADR-P2-4-GRAPHQL-SUPPORT.md
+ */
+export { SDLParser, parseGraphQLSchema, extractQueryType, extractMutationType, extractSubscriptionType, extractObjectTypes, extractInputTypes, extractEnumTypes, extractInterfaceTypes, extractUnionTypes, graphqlTypeToNormalized, } from './sdl-parser.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/graphql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/graphql/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}

package/dist/adapters/graphql/sdl-parser.d.ts

@@ -0,0 +1,74 @@
+/**
+ * GraphQL SDL Parser
+ *
+ * Parses GraphQL Schema Definition Language (SDL) files.
+ * Uses the graphql package for robust parsing.
+ *
+ * @module GraphQL SDL Parser
+ * @see .context/ADR-P2-4-GRAPHQL-SUPPORT.md
+ */
+import type { GraphQLSchemaDefinition, GraphQLTypeDefinition, GraphQLTypeRef, GraphQLNormalizedType } from '../../patterns/graphql/types.js';
+/**
+ * SDL Parser class for parsing GraphQL schema files
+ */
+export declare class SDLParser {
+    /**
+     * Parse a GraphQL SDL schema string
+     */
+    parse(schemaContent: string): GraphQLSchemaDefinition;
+    private extractFields;
+    private convertField;
+    private convertInputField;
+    private convertArgument;
+    private convertTypeRef;
+    private convertObjectType;
+    private convertInputType;
+    private convertEnumType;
+    private convertInterfaceType;
+    private convertUnionType;
+}
+/**
+ * Parse a GraphQL schema string into a schema definition
+ */
+export declare function parseGraphQLSchema(schemaContent: string): GraphQLSchemaDefinition;
+/**
+ * Extract the Query type from a schema
+ */
+export declare function extractQueryType(schemaContent: string): GraphQLTypeDefinition | null;
+/**
+ * Extract the Mutation type from a schema
+ */
+export declare function extractMutationType(schemaContent: string): GraphQLTypeDefinition | null;
+/**
+ * Extract the Subscription type from a schema
+ */
+export declare function extractSubscriptionType(schemaContent: string): GraphQLTypeDefinition | null;
+/**
+ * Extract all object types from a schema
+ */
+export declare function extractObjectTypes(schemaContent: string): GraphQLTypeDefinition[];
+/**
+ * Extract all input types from a schema
+ */
+export declare function extractInputTypes(schemaContent: string): GraphQLTypeDefinition[];
+/**
+ * Extract all enum types from a schema
+ */
+export declare function extractEnumTypes(schemaContent: string): GraphQLTypeDefinition[];
+/**
+ * Extract all interface types from a schema
+ */
+export declare function extractInterfaceTypes(schemaContent: string): GraphQLTypeDefinition[];
+/**
+ * Extract all union types from a schema
+ */
+export declare function extractUnionTypes(schemaContent: string): GraphQLTypeDefinition[];
+export type { GraphQLNormalizedType } from '../../patterns/graphql/types.js';
+/**
+ * Convert a GraphQL type reference to a NormalizedType
+ *
+ * Note: Returns an extended type with extra properties (name, nullable, ofType)
+ * that are specific to GraphQL type handling.
+ */
+export declare function graphqlTypeToNormalized(type: GraphQLTypeRef): GraphQLNormalizedType;
+//# sourceMappingURL=sdl-parser.d.ts.map

package/dist/adapters/graphql/sdl-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdl-parser.d.ts","sourceRoot":"","sources":["../../../src/adapters/graphql/sdl-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EAErB,cAAc,EAEd,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AAMzC;;GAEG;AACH,qBAAa,SAAS;IACpB;;OAEG;IACH,KAAK,CAAC,aAAa,EAAE,MAAM,GAAG,uBAAuB;IAwDrD,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,cAAc;IAkDtB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,gBAAgB;CASzB;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,uBAAuB,CAGjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CA6BpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CA4BvF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CA4B3F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAwCjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,EAAE,CA8BhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAwB/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAmCpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAwBhF;AAGD,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,GAAG,qBAAqB,CAwCnF"}