@mcpmesh/sdk 0.8.0-beta.1

package/dist/provider-handlers/openai-handler.js

@@ -0,0 +1,160 @@
+/**
+ * OpenAI provider handler.
+ *
+ * Optimized for OpenAI models (GPT-4, GPT-4 Turbo, GPT-3.5-turbo)
+ * using OpenAI's native structured output capabilities.
+ *
+ * Based on Python's OpenAIHandler:
+ * src/runtime/python/_mcp_mesh/engine/provider_handlers/openai_handler.py
+ */
+import { createDebug } from "../debug.js";
+import { convertMessagesToVercelFormat, makeSchemaStrict, defaultDetermineOutputMode, BASE_TOOL_INSTRUCTIONS, } from "./provider-handler.js";
+import { ProviderHandlerRegistry } from "./provider-handler-registry.js";
+const debug = createDebug("openai-handler");
+/**
+ * Provider handler for OpenAI models.
+ *
+ * OpenAI Characteristics:
+ * - Native structured output via response_format parameter
+ * - Strict JSON schema enforcement
+ * - Built-in function calling
+ * - Works best with concise, focused prompts
+ * - response_format ensures valid JSON matching schema
+ *
+ * Key Difference from Claude:
+ * - Uses response_format instead of prompt-based JSON instructions
+ * - OpenAI API guarantees JSON schema compliance
+ * - More strict parsing, less tolerance for malformed JSON
+ * - Shorter system prompts work better
+ *
+ * Supported Models:
+ * - gpt-4-turbo-preview and later
+ * - gpt-4-0125-preview and later
+ * - gpt-3.5-turbo-0125 and later
+ * - All gpt-4o models
+ *
+ * Reference: https://platform.openai.com/docs/guides/structured-outputs
+ */
+export class OpenAIHandler {
+    vendor = "openai";
+    /**
+     * Prepare request parameters for OpenAI API with structured output.
+     *
+     * OpenAI Strategy:
+     * - Use response_format parameter for guaranteed JSON schema compliance
+     * - This is the KEY difference from Claude handler
+     * - response_format.json_schema ensures the response matches output schema
+     * - Skip structured output for text mode (string return types)
+     *
+     * Message Format (OpenAI-specific):
+     * - Assistant messages with tool_calls → content blocks with type "tool-call"
+     * - Tool result messages → content blocks with type "tool-result"
+     * This is required for Vercel AI SDK to properly convert to OpenAI's native format.
+     */
+    prepareRequest(messages, tools, outputSchema, options) {
+        const { outputMode, temperature, maxOutputTokens: maxTokens, topP, ...rest } = options ?? {};
+        const determinedMode = this.determineOutputMode(outputSchema, outputMode);
+        // Convert messages to Vercel AI SDK format (shared utility)
+        const convertedMessages = convertMessagesToVercelFormat(messages);
+        const request = {
+            messages: convertedMessages,
+            ...rest,
+        };
+        // Add tools if provided
+        if (tools && tools.length > 0) {
+            request.tools = tools;
+        }
+        // Add standard parameters if provided
+        if (temperature !== undefined) {
+            request.temperature = temperature;
+        }
+        if (maxTokens !== undefined) {
+            request.maxOutputTokens = maxTokens;
+        }
+        if (topP !== undefined) {
+            request.topP = topP;
+        }
+        // Skip structured output for text mode or no schema
+        if (determinedMode === "text" || !outputSchema) {
+            return request;
+        }
+        // Only add response_format in "strict" mode
+        // Hint mode relies on prompt instructions instead
+        if (determinedMode === "strict") {
+            // Transform schema for OpenAI strict mode
+            // OpenAI requires additionalProperties: false and all properties in required
+            const strictSchema = makeSchemaStrict(outputSchema.schema, { addAllRequired: true });
+            // OpenAI structured output format
+            // See: https://platform.openai.com/docs/guides/structured-outputs
+            request.responseFormat = {
+                type: "json_schema",
+                jsonSchema: {
+                    name: outputSchema.name,
+                    schema: strictSchema,
+                    strict: true, // Enforce schema compliance
+                },
+            };
+            debug(`Using response_format with strict schema: ${outputSchema.name}`);
+        }
+        return request;
+    }
+    /**
+     * Format system prompt for OpenAI (concise approach).
+     *
+     * OpenAI Strategy:
+     * 1. Use base prompt as-is
+     * 2. Add tool calling instructions if tools present
+     * 3. NO JSON schema instructions (response_format handles this)
+     * 4. Keep prompt concise - OpenAI works well with shorter prompts
+     * 5. Skip JSON note for text mode (string return type)
+     *
+     * Key Difference from Claude:
+     * - No JSON schema in prompt (response_format ensures compliance)
+     * - Shorter, more focused instructions
+     * - Let response_format handle output structure
+     */
+    formatSystemPrompt(basePrompt, toolSchemas, outputSchema, outputMode) {
+        let systemContent = basePrompt;
+        const determinedMode = this.determineOutputMode(outputSchema, outputMode);
+        // Add tool calling instructions if tools available
+        if (toolSchemas && toolSchemas.length > 0) {
+            systemContent += BASE_TOOL_INSTRUCTIONS;
+        }
+        // Skip JSON note for text mode
+        if (determinedMode === "text" || !outputSchema) {
+            return systemContent;
+        }
+        // NOTE: We do NOT add JSON schema instructions here!
+        // OpenAI's response_format parameter handles JSON structure automatically.
+        // Adding explicit JSON instructions can actually confuse the model.
+        // Optional: Add a brief note that response should be JSON
+        // (though response_format enforces this anyway)
+        systemContent += `
+
+Your final response will be structured as JSON matching the ${outputSchema.name} format.`;
+        return systemContent;
+    }
+    /**
+     * Return OpenAI-specific capabilities.
+     */
+    getCapabilities() {
+        return {
+            nativeToolCalling: true, // OpenAI has native function calling
+            structuredOutput: true, // Native response_format support!
+            streaming: true, // Supports streaming
+            vision: true, // GPT-4V and later support vision
+            jsonMode: true, // Has dedicated JSON mode via response_format
+        };
+    }
+    /**
+     * Determine output mode - OpenAI always uses strict mode for schemas.
+     *
+     * Uses the default implementation since OpenAI has excellent structured output support.
+     */
+    determineOutputMode(outputSchema, overrideMode) {
+        return defaultDetermineOutputMode(outputSchema, overrideMode);
+    }
+}
+// Register with the registry
+ProviderHandlerRegistry.register("openai", OpenAIHandler);
+//# sourceMappingURL=openai-handler.js.map

package/dist/provider-handlers/openai-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-handler.js","sourceRoot":"","sources":["../../src/provider-handlers/openai-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,0BAA0B,EAC1B,sBAAsB,GAOvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,MAAM,KAAK,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,aAAa;IACf,MAAM,GAAG,QAAQ,CAAC;IAE3B;;;;;;;;;;;;;OAaG;IACH,cAAc,CACZ,QAAsB,EACtB,KAA0B,EAC1B,YAAiC,EACjC,OAMC;QAED,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QAC7F,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAE1E,4DAA4D;QAC5D,MAAM,iBAAiB,GAAG,6BAA6B,CAAC,QAAQ,CAAC,CAAC;QAElE,MAAM,OAAO,GAAoB;YAC/B,QAAQ,EAAE,iBAAiB;YAC3B,GAAG,IAAI;SACR,CAAC;QAEF,wBAAwB;QACxB,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,CAAC;QAED,sCAAsC;QACtC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;QACpC,CAAC;QACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;QACtC,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,oDAAoD;QACpD,IAAI,cAAc,KAAK,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,4CAA4C;QAC5C,kDAAkD;QAClD,IAAI,cAAc,KAAK,QAAQ,EAAE,CAAC;YAChC,0CAA0C;YAC1C,6EAA6E;YAC7E,MAAM,YAAY,GAAG,gBAAgB,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;YAErF,kCAAkC;YAClC,kEAAkE;YAClE,OAAO,CAAC,cAAc,GAAG;gBACvB,IAAI,EAAE,aAAa;gBACnB,UAAU,EAAE;oBACV,IAAI,EAAE,YAAY,CAAC,IAAI;oBACvB,MAAM,EAAE,YAAY;oBACpB,MAAM,EAAE,IAAI,EAAE,4BAA4B;iBAC3C;aACF,CAAC;YAEF,KAAK,CAAC,6CAA6C,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAChB,UAAkB,EAClB,WAAgC,EAChC,YAAiC,EACjC,UAAuB;QAEvB,IAAI,aAAa,GAAG,UAAU,CAAC;QAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAE1E,mDAAmD;QACnD,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,aAAa,IAAI,sBAAsB,CAAC;QAC1C,CAAC;QAED,+BAA+B;QAC/B,IAAI,cAAc,KAAK,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/C,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,qDAAqD;QACrD,2EAA2E;QAC3E,oEAAoE;QAEpE,0DAA0D;QAC1D,gDAAgD;QAChD,aAAa,IAAI;;8DAEyC,YAAY,CAAC,IAAI,UAAU,CAAC;QAEtF,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO;YACL,iBAAiB,EAAE,IAAI,EAAE,qCAAqC;YAC9D,gBAAgB,EAAE,IAAI,EAAE,kCAAkC;YAC1D,SAAS,EAAE,IAAI,EAAE,qBAAqB;YACtC,MAAM,EAAE,IAAI,EAAE,kCAAkC;YAChD,QAAQ,EAAE,IAAI,EAAE,8CAA8C;SAC/D,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CACjB,YAAiC,EACjC,YAAyB;QAEzB,OAAO,0BAA0B,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAChE,CAAC;CACF;AAED,6BAA6B;AAC7B,uBAAuB,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC"}

package/dist/provider-handlers/provider-handler-registry.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Provider handler registry for vendor-specific LLM behavior.
+ *
+ * Manages selection and instantiation of provider handlers based on vendor name.
+ *
+ * Based on Python's ProviderHandlerRegistry:
+ * src/runtime/python/_mcp_mesh/engine/provider_handlers/provider_handler_registry.py
+ */
+import type { ProviderHandler } from "./provider-handler.js";
+/**
+ * Constructor type for provider handlers.
+ */
+export type ProviderHandlerConstructor = new () => ProviderHandler;
+/**
+ * Registry for provider-specific handlers.
+ *
+ * Manages mapping from vendor names to handler classes and provides
+ * handler selection logic. Handlers customize LLM API calls for
+ * optimal performance with each vendor.
+ *
+ * Vendor Mapping:
+ * - "anthropic" -> ClaudeHandler
+ * - "openai" -> OpenAIHandler
+ * - "unknown" or others -> GenericHandler
+ *
+ * Usage:
+ * ```typescript
+ * const handler = ProviderHandlerRegistry.getHandler("anthropic");
+ * const request = handler.prepareRequest(messages, tools, outputSchema);
+ * const systemPrompt = handler.formatSystemPrompt(base, tools, outputSchema);
+ * ```
+ *
+ * Extensibility:
+ * ```typescript
+ * ProviderHandlerRegistry.register("cohere", CohereHandler);
+ * ```
+ */
+export declare class ProviderHandlerRegistry {
+    /** Built-in vendor mappings */
+    private static handlers;
+    /** Cache of instantiated handlers (singleton per vendor) */
+    private static instances;
+    /** Fallback handler class (set by generic-handler.ts) */
+    private static fallbackHandlerClass;
+    /**
+     * Register a custom provider handler.
+     *
+     * Allows runtime registration of new handlers without modifying registry code.
+     *
+     * @param vendor - Vendor name (e.g., "cohere", "gemini", "together")
+     * @param handlerClass - Handler class (must implement ProviderHandler)
+     *
+     * @example
+     * ```typescript
+     * class CohereHandler implements ProviderHandler {
+     *   // ...
+     * }
+     *
+     * ProviderHandlerRegistry.register("cohere", CohereHandler);
+     * ```
+     */
+    static register(vendor: string, handlerClass: ProviderHandlerConstructor): void;
+    /**
+     * Set the fallback handler class.
+     *
+     * Called by generic-handler.ts during module initialization.
+     *
+     * @param handlerClass - Fallback handler class
+     */
+    static setFallbackHandler(handlerClass: ProviderHandlerConstructor): void;
+    /**
+     * Get provider handler for vendor.
+     *
+     * Selection Logic:
+     * 1. If vendor matches registered handler -> use that handler
+     * 2. If vendor is null or "unknown" -> use GenericHandler
+     * 3. If vendor unknown -> use GenericHandler with warning
+     *
+     * Handlers are cached (singleton per vendor) for performance.
+     *
+     * @param vendor - Vendor name from model string (e.g., "anthropic", "openai")
+     * @returns Provider handler instance for the vendor
+     *
+     * @example
+     * ```typescript
+     * // Get Claude handler
+     * const handler = ProviderHandlerRegistry.getHandler("anthropic");
+     *
+     * // Get OpenAI handler
+     * const handler = ProviderHandlerRegistry.getHandler("openai");
+     *
+     * // Get generic fallback
+     * const handler = ProviderHandlerRegistry.getHandler("unknown");
+     * ```
+     */
+    static getHandler(vendor: string | null): ProviderHandler;
+    /**
+     * List all registered vendors and their handlers.
+     *
+     * @returns Map of vendor name -> handler class name
+     *
+     * @example
+     * ```typescript
+     * const vendors = ProviderHandlerRegistry.listVendors();
+     * // Map { 'anthropic' => 'ClaudeHandler', 'openai' => 'OpenAIHandler' }
+     * ```
+     */
+    static listVendors(): Map<string, string>;
+    /**
+     * Clear cached handler instances.
+     *
+     * Useful for testing or when handler behavior needs to be reset.
+     * Next getHandler() call will create fresh instances.
+     */
+    static clearCache(): void;
+    /**
+     * Check if a handler is registered for a vendor.
+     *
+     * @param vendor - Vendor name
+     * @returns True if a specific handler is registered
+     */
+    static hasHandler(vendor: string): boolean;
+}
+//# sourceMappingURL=provider-handler-registry.d.ts.map

package/dist/provider-handlers/provider-handler-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-handler-registry.d.ts","sourceRoot":"","sources":["../../src/provider-handlers/provider-handler-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQ7D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,UAAU,eAAe,CAAC;AAMnE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,uBAAuB;IAClC,+BAA+B;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsD;IAE7E,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAC,SAAS,CAA2C;IAEnE,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAA2C;IAE9E;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,0BAA0B,GAAG,IAAI;IAW/E;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,CAAC,YAAY,EAAE,0BAA0B,GAAG,IAAI;IAKzE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe;IA2CzD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAQzC;;;;;OAKG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAKzB;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAG3C"}

package/dist/provider-handlers/provider-handler-registry.js

@@ -0,0 +1,180 @@
+/**
+ * Provider handler registry for vendor-specific LLM behavior.
+ *
+ * Manages selection and instantiation of provider handlers based on vendor name.
+ *
+ * Based on Python's ProviderHandlerRegistry:
+ * src/runtime/python/_mcp_mesh/engine/provider_handlers/provider_handler_registry.py
+ */
+import { createDebug } from "../debug.js";
+const debug = createDebug("provider-handler-registry");
+// ============================================================================
+// Registry Singleton
+// ============================================================================
+/**
+ * Registry for provider-specific handlers.
+ *
+ * Manages mapping from vendor names to handler classes and provides
+ * handler selection logic. Handlers customize LLM API calls for
+ * optimal performance with each vendor.
+ *
+ * Vendor Mapping:
+ * - "anthropic" -> ClaudeHandler
+ * - "openai" -> OpenAIHandler
+ * - "unknown" or others -> GenericHandler
+ *
+ * Usage:
+ * ```typescript
+ * const handler = ProviderHandlerRegistry.getHandler("anthropic");
+ * const request = handler.prepareRequest(messages, tools, outputSchema);
+ * const systemPrompt = handler.formatSystemPrompt(base, tools, outputSchema);
+ * ```
+ *
+ * Extensibility:
+ * ```typescript
+ * ProviderHandlerRegistry.register("cohere", CohereHandler);
+ * ```
+ */
+export class ProviderHandlerRegistry {
+    /** Built-in vendor mappings */
+    static handlers = new Map();
+    /** Cache of instantiated handlers (singleton per vendor) */
+    static instances = new Map();
+    /** Fallback handler class (set by generic-handler.ts) */
+    static fallbackHandlerClass = null;
+    /**
+     * Register a custom provider handler.
+     *
+     * Allows runtime registration of new handlers without modifying registry code.
+     *
+     * @param vendor - Vendor name (e.g., "cohere", "gemini", "together")
+     * @param handlerClass - Handler class (must implement ProviderHandler)
+     *
+     * @example
+     * ```typescript
+     * class CohereHandler implements ProviderHandler {
+     *   // ...
+     * }
+     *
+     * ProviderHandlerRegistry.register("cohere", CohereHandler);
+     * ```
+     */
+    static register(vendor, handlerClass) {
+        const normalizedVendor = vendor.toLowerCase().trim();
+        this.handlers.set(normalizedVendor, handlerClass);
+        debug(`Registered provider handler: ${normalizedVendor} -> ${handlerClass.name}`);
+        // Clear cached instance if it exists (force re-instantiation)
+        if (this.instances.has(normalizedVendor)) {
+            this.instances.delete(normalizedVendor);
+        }
+    }
+    /**
+     * Set the fallback handler class.
+     *
+     * Called by generic-handler.ts during module initialization.
+     *
+     * @param handlerClass - Fallback handler class
+     */
+    static setFallbackHandler(handlerClass) {
+        this.fallbackHandlerClass = handlerClass;
+        debug(`Set fallback handler: ${handlerClass.name}`);
+    }
+    /**
+     * Get provider handler for vendor.
+     *
+     * Selection Logic:
+     * 1. If vendor matches registered handler -> use that handler
+     * 2. If vendor is null or "unknown" -> use GenericHandler
+     * 3. If vendor unknown -> use GenericHandler with warning
+     *
+     * Handlers are cached (singleton per vendor) for performance.
+     *
+     * @param vendor - Vendor name from model string (e.g., "anthropic", "openai")
+     * @returns Provider handler instance for the vendor
+     *
+     * @example
+     * ```typescript
+     * // Get Claude handler
+     * const handler = ProviderHandlerRegistry.getHandler("anthropic");
+     *
+     * // Get OpenAI handler
+     * const handler = ProviderHandlerRegistry.getHandler("openai");
+     *
+     * // Get generic fallback
+     * const handler = ProviderHandlerRegistry.getHandler("unknown");
+     * ```
+     */
+    static getHandler(vendor) {
+        // Normalize vendor name (handle null, empty string)
+        const normalizedVendor = (vendor ?? "unknown").toLowerCase().trim();
+        // Check cache first
+        const cached = this.instances.get(normalizedVendor);
+        if (cached) {
+            debug(`Using cached handler for vendor: ${normalizedVendor}`);
+            return cached;
+        }
+        // Get handler class (or fallback to Generic)
+        let handlerClass = this.handlers.get(normalizedVendor);
+        let handler;
+        if (handlerClass) {
+            debug(`Selected ${handlerClass.name} for vendor: ${normalizedVendor}`);
+            handler = new handlerClass();
+        }
+        else {
+            // Use fallback handler
+            if (!this.fallbackHandlerClass) {
+                throw new Error(`No handler registered for vendor '${normalizedVendor}' and no fallback handler set. ` +
+                    `Import provider-handlers/index.ts to initialize handlers.`);
+            }
+            if (normalizedVendor !== "unknown") {
+                debug(`No specific handler for vendor '${normalizedVendor}', using GenericHandler`);
+            }
+            else {
+                debug(`Using GenericHandler for unknown vendor`);
+            }
+            handler = new this.fallbackHandlerClass();
+        }
+        // Cache the instance
+        this.instances.set(normalizedVendor, handler);
+        debug(`Instantiated handler: ${handler.constructor.name} for vendor: ${normalizedVendor}`);
+        return handler;
+    }
+    /**
+     * List all registered vendors and their handlers.
+     *
+     * @returns Map of vendor name -> handler class name
+     *
+     * @example
+     * ```typescript
+     * const vendors = ProviderHandlerRegistry.listVendors();
+     * // Map { 'anthropic' => 'ClaudeHandler', 'openai' => 'OpenAIHandler' }
+     * ```
+     */
+    static listVendors() {
+        const result = new Map();
+        for (const [vendor, handlerClass] of this.handlers) {
+            result.set(vendor, handlerClass.name);
+        }
+        return result;
+    }
+    /**
+     * Clear cached handler instances.
+     *
+     * Useful for testing or when handler behavior needs to be reset.
+     * Next getHandler() call will create fresh instances.
+     */
+    static clearCache() {
+        this.instances.clear();
+        debug(`Cleared provider handler cache`);
+    }
+    /**
+     * Check if a handler is registered for a vendor.
+     *
+     * @param vendor - Vendor name
+     * @returns True if a specific handler is registered
+     */
+    static hasHandler(vendor) {
+        return this.handlers.has(vendor.toLowerCase().trim());
+    }
+}
+//# sourceMappingURL=provider-handler-registry.js.map

package/dist/provider-handlers/provider-handler-registry.js.map

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