@mcpmesh/sdk 0.8.0-beta.1

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

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

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

@@ -0,0 +1,82 @@
+/**
+ * Gemini/Google provider handler.
+ *
+ * Optimized for Gemini models (Gemini 2.0 Flash, Gemini 1.5 Pro, etc.)
+ * using Google's best practices for tool calling and structured output.
+ *
+ * Features:
+ * - Native structured output via response_format (via Vercel AI SDK)
+ * - Native function calling support
+ * - Support for Gemini 2.x and 3.x models
+ * - Large context windows (up to 2M tokens)
+ *
+ * Based on Python's GeminiHandler:
+ * src/runtime/python/_mcp_mesh/engine/provider_handlers/gemini_handler.py
+ *
+ * Reference:
+ * - https://ai.google.dev/gemini-api/docs
+ */
+import type { LlmMessage } from "../types.js";
+import { type ProviderHandler, type VendorCapabilities, type ToolSchema, type OutputSchema, type PreparedRequest, type OutputMode } from "./provider-handler.js";
+/**
+ * Provider handler for Google Gemini models.
+ *
+ * Gemini Characteristics:
+ * - Native structured output via response_format (Vercel AI SDK translates)
+ * - Native function calling support
+ * - Large context windows (1M-2M tokens)
+ * - Multimodal support (text, images, video, audio)
+ * - Works well with concise, focused prompts
+ *
+ * Key Similarities with OpenAI:
+ * - Uses response_format for structured output (via Vercel AI SDK)
+ * - Native function calling format
+ * - Similar schema enforcement requirements
+ *
+ * Supported Models (via Vercel AI SDK):
+ * - gemini-2.0-flash (fast, efficient)
+ * - gemini-2.0-flash-lite (fastest, most efficient)
+ * - gemini-1.5-pro (high capability)
+ * - gemini-1.5-flash (balanced)
+ * - gemini-3-flash-preview (reasoning support)
+ * - gemini-3-pro-preview (advanced reasoning)
+ */
+export declare class GeminiHandler implements ProviderHandler {
+    readonly vendor = "google";
+    /**
+     * Prepare request parameters for Gemini API via Vercel AI SDK.
+     *
+     * Gemini Strategy:
+     * - Use response_format parameter for structured JSON output
+     * - Vercel AI SDK handles translation to Gemini's native format
+     * - Skip structured output for text mode (string return types)
+     */
+    prepareRequest(messages: LlmMessage[], tools: ToolSchema[] | null, outputSchema: OutputSchema | null, options?: {
+        outputMode?: OutputMode;
+        temperature?: number;
+        maxOutputTokens?: number;
+        topP?: number;
+        [key: string]: unknown;
+    }): PreparedRequest;
+    /**
+     * Format system prompt for Gemini (concise approach).
+     *
+     * Gemini Strategy:
+     * 1. Use base prompt as-is
+     * 2. Add tool calling instructions if tools present
+     * 3. Minimal JSON instructions (response_format handles structure)
+     * 4. Keep prompt concise - Gemini works well with clear, direct prompts
+     */
+    formatSystemPrompt(basePrompt: string, toolSchemas: ToolSchema[] | null, outputSchema: OutputSchema | null, outputMode?: OutputMode): string;
+    /**
+     * Return Gemini-specific capabilities.
+     */
+    getCapabilities(): VendorCapabilities;
+    /**
+     * Determine output mode - Gemini uses strict mode for schemas.
+     *
+     * Uses the default implementation since Gemini has good structured output support.
+     */
+    determineOutputMode(outputSchema: OutputSchema | null, overrideMode?: OutputMode): OutputMode;
+}
+//# sourceMappingURL=gemini-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-handler.d.ts","sourceRoot":"","sources":["../../src/provider-handlers/gemini-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAK/B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,MAAM,YAAY;IAE3B;;;;;;;OAOG;IACH,cAAc,CACZ,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,EAC1B,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GACA,eAAe;IAuDlB;;;;;;;;OAQG;IACH,kBAAkB,CAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,EAChC,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,UAAU,CAAC,EAAE,UAAU,GACtB,MAAM;IAsBT;;OAEG;IACH,eAAe,IAAI,kBAAkB;IAUrC;;;;OAIG;IACH,mBAAmB,CACjB,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,YAAY,CAAC,EAAE,UAAU,GACxB,UAAU;CAGd"}

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

@@ -0,0 +1,152 @@
+/**
+ * Gemini/Google provider handler.
+ *
+ * Optimized for Gemini models (Gemini 2.0 Flash, Gemini 1.5 Pro, etc.)
+ * using Google's best practices for tool calling and structured output.
+ *
+ * Features:
+ * - Native structured output via response_format (via Vercel AI SDK)
+ * - Native function calling support
+ * - Support for Gemini 2.x and 3.x models
+ * - Large context windows (up to 2M tokens)
+ *
+ * Based on Python's GeminiHandler:
+ * src/runtime/python/_mcp_mesh/engine/provider_handlers/gemini_handler.py
+ *
+ * Reference:
+ * - https://ai.google.dev/gemini-api/docs
+ */
+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("gemini-handler");
+/**
+ * Provider handler for Google Gemini models.
+ *
+ * Gemini Characteristics:
+ * - Native structured output via response_format (Vercel AI SDK translates)
+ * - Native function calling support
+ * - Large context windows (1M-2M tokens)
+ * - Multimodal support (text, images, video, audio)
+ * - Works well with concise, focused prompts
+ *
+ * Key Similarities with OpenAI:
+ * - Uses response_format for structured output (via Vercel AI SDK)
+ * - Native function calling format
+ * - Similar schema enforcement requirements
+ *
+ * Supported Models (via Vercel AI SDK):
+ * - gemini-2.0-flash (fast, efficient)
+ * - gemini-2.0-flash-lite (fastest, most efficient)
+ * - gemini-1.5-pro (high capability)
+ * - gemini-1.5-flash (balanced)
+ * - gemini-3-flash-preview (reasoning support)
+ * - gemini-3-pro-preview (advanced reasoning)
+ */
+export class GeminiHandler {
+    vendor = "google";
+    /**
+     * Prepare request parameters for Gemini API via Vercel AI SDK.
+     *
+     * Gemini Strategy:
+     * - Use response_format parameter for structured JSON output
+     * - Vercel AI SDK handles translation to Gemini's native format
+     * - Skip structured output for text mode (string return types)
+     */
+    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
+        // Vercel AI SDK will convert to Gemini's function_declarations format
+        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") {
+            // Vercel AI SDK translates this to Gemini's native format
+            const strictSchema = makeSchemaStrict(outputSchema.schema, { addAllRequired: true });
+            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 Gemini (concise approach).
+     *
+     * Gemini Strategy:
+     * 1. Use base prompt as-is
+     * 2. Add tool calling instructions if tools present
+     * 3. Minimal JSON instructions (response_format handles structure)
+     * 4. Keep prompt concise - Gemini works well with clear, direct prompts
+     */
+    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;
+        }
+        // Add brief JSON note (response_format handles enforcement)
+        systemContent += `
+
+Your final response will be structured as JSON matching the ${outputSchema.name} format.`;
+        return systemContent;
+    }
+    /**
+     * Return Gemini-specific capabilities.
+     */
+    getCapabilities() {
+        return {
+            nativeToolCalling: true, // Gemini has native function calling
+            structuredOutput: true, // Supports structured output via response_format
+            streaming: true, // Supports streaming
+            vision: true, // Gemini supports multimodal (images, video, audio)
+            jsonMode: true, // Native JSON mode via response_format
+        };
+    }
+    /**
+     * Determine output mode - Gemini uses strict mode for schemas.
+     *
+     * Uses the default implementation since Gemini has good structured output support.
+     */
+    determineOutputMode(outputSchema, overrideMode) {
+        return defaultDetermineOutputMode(outputSchema, overrideMode);
+    }
+}
+// Register with the registry
+// Use "google" as vendor name to match Vercel AI SDK model extraction
+// (e.g., "google/gemini-2.0-flash" → vendor "google")
+ProviderHandlerRegistry.register("google", GeminiHandler);
+//# sourceMappingURL=gemini-handler.js.map

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

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

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

@@ -0,0 +1,78 @@
+/**
+ * Generic provider handler for unknown/unsupported vendors.
+ *
+ * Provides sensible defaults using prompt-based approach similar to Claude.
+ *
+ * Based on Python's GenericHandler:
+ * src/runtime/python/_mcp_mesh/engine/provider_handlers/generic_handler.py
+ */
+import type { LlmMessage } from "../types.js";
+import type { ProviderHandler, VendorCapabilities, ToolSchema, OutputSchema, PreparedRequest, OutputMode } from "./provider-handler.js";
+/**
+ * Generic provider handler for vendors without specific handlers.
+ *
+ * This handler provides a safe, conservative approach that should work
+ * with most LLM providers that follow OpenAI-compatible APIs:
+ * - Uses prompt-based JSON instructions
+ * - Standard tool calling format (via Vercel AI SDK normalization)
+ * - No vendor-specific features
+ * - Maximum compatibility
+ *
+ * Use Cases:
+ * - Fallback for unknown vendors
+ * - New providers before dedicated handler is created
+ * - Testing with custom/local models
+ * - Providers like: Cohere, Together, Replicate, Ollama, etc.
+ *
+ * Strategy:
+ * - Conservative, prompt-based approach
+ * - Relies on Vercel AI SDK to normalize vendor differences
+ * - Works with any provider that Vercel AI SDK supports
+ */
+export declare class GenericHandler implements ProviderHandler {
+    readonly vendor: string;
+    constructor(vendor?: string);
+    /**
+     * Prepare request with standard parameters.
+     *
+     * Generic Strategy:
+     * - Use standard message format
+     * - Include tools if provided (Vercel AI SDK will normalize)
+     * - No vendor-specific parameters
+     * - Let Vercel AI SDK handle vendor differences
+     */
+    prepareRequest(messages: LlmMessage[], tools: ToolSchema[] | null, _outputSchema: OutputSchema | null, // unused in generic handler, but required by interface
+    options?: {
+        outputMode?: OutputMode;
+        temperature?: number;
+        maxOutputTokens?: number;
+        topP?: number;
+        [key: string]: unknown;
+    }): PreparedRequest;
+    /**
+     * Format system prompt with explicit JSON instructions.
+     *
+     * Generic Strategy:
+     * - Use detailed prompt instructions (works with most models)
+     * - Explicit JSON schema (since we can't assume response_format)
+     * - Clear tool calling guidelines
+     * - Maximum explicitness for compatibility
+     * - Skip JSON schema for text mode (string return type)
+     */
+    formatSystemPrompt(basePrompt: string, toolSchemas: ToolSchema[] | null, outputSchema: OutputSchema | null, outputMode?: OutputMode): string;
+    /**
+     * Return conservative capability flags.
+     *
+     * For generic handler, we assume minimal capabilities
+     * to ensure maximum compatibility.
+     */
+    getCapabilities(): VendorCapabilities;
+    /**
+     * Determine output mode - generic handler always uses "hint" for schemas.
+     *
+     * Since we can't assume structured output support, we rely on
+     * prompt-based instructions (hint mode) for JSON schema compliance.
+     */
+    determineOutputMode(outputSchema: OutputSchema | null, overrideMode?: OutputMode): OutputMode;
+}
+//# sourceMappingURL=generic-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generic-handler.d.ts","sourceRoot":"","sources":["../../src/provider-handlers/generic-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,UAAU,EACX,MAAM,uBAAuB,CAAC;AAG/B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,GAAE,MAAkB;IAItC;;;;;;;;OAQG;IACH,cAAc,CACZ,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,EAC1B,aAAa,EAAE,YAAY,GAAG,IAAI,EAAE,uDAAuD;IAC3F,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GACA,eAAe;IA8BlB;;;;;;;;;OASG;IACH,kBAAkB,CAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,EAChC,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,UAAU,CAAC,EAAE,UAAU,GACtB,MAAM;IAwCT;;;;;OAKG;IACH,eAAe,IAAI,kBAAkB;IAUrC;;;;;OAKG;IACH,mBAAmB,CACjB,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,YAAY,CAAC,EAAE,UAAU,GACxB,UAAU;CAed"}

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

@@ -0,0 +1,152 @@
+/**
+ * Generic provider handler for unknown/unsupported vendors.
+ *
+ * Provides sensible defaults using prompt-based approach similar to Claude.
+ *
+ * Based on Python's GenericHandler:
+ * src/runtime/python/_mcp_mesh/engine/provider_handlers/generic_handler.py
+ */
+import { ProviderHandlerRegistry } from "./provider-handler-registry.js";
+/**
+ * Generic provider handler for vendors without specific handlers.
+ *
+ * This handler provides a safe, conservative approach that should work
+ * with most LLM providers that follow OpenAI-compatible APIs:
+ * - Uses prompt-based JSON instructions
+ * - Standard tool calling format (via Vercel AI SDK normalization)
+ * - No vendor-specific features
+ * - Maximum compatibility
+ *
+ * Use Cases:
+ * - Fallback for unknown vendors
+ * - New providers before dedicated handler is created
+ * - Testing with custom/local models
+ * - Providers like: Cohere, Together, Replicate, Ollama, etc.
+ *
+ * Strategy:
+ * - Conservative, prompt-based approach
+ * - Relies on Vercel AI SDK to normalize vendor differences
+ * - Works with any provider that Vercel AI SDK supports
+ */
+export class GenericHandler {
+    vendor;
+    constructor(vendor = "unknown") {
+        this.vendor = vendor;
+    }
+    /**
+     * Prepare request with standard parameters.
+     *
+     * Generic Strategy:
+     * - Use standard message format
+     * - Include tools if provided (Vercel AI SDK will normalize)
+     * - No vendor-specific parameters
+     * - Let Vercel AI SDK handle vendor differences
+     */
+    prepareRequest(messages, tools, _outputSchema, // unused in generic handler, but required by interface
+    options) {
+        const { outputMode, temperature, maxOutputTokens: maxTokens, topP, ...rest } = options ?? {};
+        const request = {
+            messages: [...messages],
+            ...rest,
+        };
+        // Add tools if provided (Vercel AI SDK will convert to vendor format)
+        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;
+        }
+        // Don't add responseFormat - not all vendors support it
+        // Rely on prompt-based JSON instructions instead
+        return request;
+    }
+    /**
+     * Format system prompt with explicit JSON instructions.
+     *
+     * Generic Strategy:
+     * - Use detailed prompt instructions (works with most models)
+     * - Explicit JSON schema (since we can't assume response_format)
+     * - Clear tool calling guidelines
+     * - Maximum explicitness for compatibility
+     * - Skip JSON schema for text mode (string return type)
+     */
+    formatSystemPrompt(basePrompt, toolSchemas, outputSchema, outputMode) {
+        let systemContent = basePrompt;
+        const mode = this.determineOutputMode(outputSchema, outputMode);
+        // Add tool calling instructions if tools available
+        if (toolSchemas && toolSchemas.length > 0) {
+            systemContent += `
+
+TOOL CALLING RULES:
+- You can call tools to gather information
+- Make one tool call at a time
+- Wait for tool results before making additional calls
+- Use standard JSON function calling format
+- Provide your final response after gathering needed information
+`;
+        }
+        // Skip JSON schema for text mode
+        if (mode === "text" || !outputSchema) {
+            return systemContent;
+        }
+        // Add explicit JSON schema instructions
+        // (since we can't rely on vendor-specific structured output)
+        const schemaStr = JSON.stringify(outputSchema.schema, null, 2);
+        systemContent += `
+
+IMPORTANT: Return your final response as valid JSON matching this exact schema:
+${schemaStr}
+
+Rules:
+- Return ONLY the JSON object, no markdown, no additional text
+- Ensure all required fields are present
+- Match the schema exactly
+- Use double quotes for strings
+- Do not include comments`;
+        return systemContent;
+    }
+    /**
+     * Return conservative capability flags.
+     *
+     * For generic handler, we assume minimal capabilities
+     * to ensure maximum compatibility.
+     */
+    getCapabilities() {
+        return {
+            nativeToolCalling: true, // Most modern LLMs support this via Vercel AI SDK
+            structuredOutput: false, // Can't assume all vendors support response_format
+            streaming: false, // Conservative - not all vendors support streaming
+            vision: false, // Conservative - not all models support vision
+            jsonMode: false, // Conservative - use prompt-based JSON instead
+        };
+    }
+    /**
+     * Determine output mode - generic handler always uses "hint" for schemas.
+     *
+     * Since we can't assume structured output support, we rely on
+     * prompt-based instructions (hint mode) for JSON schema compliance.
+     */
+    determineOutputMode(outputSchema, overrideMode) {
+        // Allow explicit override
+        if (overrideMode) {
+            return overrideMode;
+        }
+        // No schema means text mode
+        if (!outputSchema) {
+            return "text";
+        }
+        // Generic handler uses hint mode (prompt-based JSON instructions)
+        // since we can't assume structured output support
+        return "hint";
+    }
+}
+// Register as fallback handler
+ProviderHandlerRegistry.setFallbackHandler(GenericHandler);
+//# sourceMappingURL=generic-handler.js.map

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

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

package/dist/provider-handlers/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Provider-specific handlers for LLM vendors.
+ *
+ * This package provides vendor-specific customization for different LLM providers
+ * (Claude, OpenAI, Gemini, etc.) to optimize API calls and response handling.
+ *
+ * Usage:
+ * ```typescript
+ * import { ProviderHandlerRegistry } from "@mcpmesh/sdk/provider-handlers";
+ *
+ * const handler = ProviderHandlerRegistry.getHandler("anthropic");
+ * const request = handler.prepareRequest(messages, tools, outputSchema);
+ * ```
+ *
+ * Based on Python's provider_handlers package:
+ * src/runtime/python/_mcp_mesh/engine/provider_handlers/
+ */
+export type { ProviderHandler, VendorCapabilities, ToolSchema, OutputSchema, PreparedRequest, OutputMode, } from "./provider-handler.js";
+export { convertMessagesToVercelFormat } from "./provider-handler.js";
+export { ProviderHandlerRegistry, type ProviderHandlerConstructor, } from "./provider-handler-registry.js";
+import "./generic-handler.js";
+import "./claude-handler.js";
+import "./openai-handler.js";
+import "./gemini-handler.js";
+export { GenericHandler } from "./generic-handler.js";
+export { ClaudeHandler } from "./claude-handler.js";
+export { OpenAIHandler } from "./openai-handler.js";
+export { GeminiHandler } from "./gemini-handler.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/provider-handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider-handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,EACL,uBAAuB,EACvB,KAAK,0BAA0B,GAChC,MAAM,gCAAgC,CAAC;AAIxC,OAAO,sBAAsB,CAAC;AAC9B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,qBAAqB,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/provider-handlers/index.js

@@ -0,0 +1,32 @@
+/**
+ * Provider-specific handlers for LLM vendors.
+ *
+ * This package provides vendor-specific customization for different LLM providers
+ * (Claude, OpenAI, Gemini, etc.) to optimize API calls and response handling.
+ *
+ * Usage:
+ * ```typescript
+ * import { ProviderHandlerRegistry } from "@mcpmesh/sdk/provider-handlers";
+ *
+ * const handler = ProviderHandlerRegistry.getHandler("anthropic");
+ * const request = handler.prepareRequest(messages, tools, outputSchema);
+ * ```
+ *
+ * Based on Python's provider_handlers package:
+ * src/runtime/python/_mcp_mesh/engine/provider_handlers/
+ */
+export { convertMessagesToVercelFormat } from "./provider-handler.js";
+// Export registry
+export { ProviderHandlerRegistry, } from "./provider-handler-registry.js";
+// Import handlers to trigger their self-registration
+// Order matters: generic-handler sets fallback, then specific handlers register
+import "./generic-handler.js";
+import "./claude-handler.js";
+import "./openai-handler.js";
+import "./gemini-handler.js";
+// Re-export handler classes for direct use or extension
+export { GenericHandler } from "./generic-handler.js";
+export { ClaudeHandler } from "./claude-handler.js";
+export { OpenAIHandler } from "./openai-handler.js";
+export { GeminiHandler } from "./gemini-handler.js";
+//# sourceMappingURL=index.js.map

package/dist/provider-handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provider-handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE,kBAAkB;AAClB,OAAO,EACL,uBAAuB,GAExB,MAAM,gCAAgC,CAAC;AAExC,qDAAqD;AACrD,gFAAgF;AAChF,OAAO,sBAAsB,CAAC;AAC9B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,qBAAqB,CAAC;AAE7B,wDAAwD;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,86 @@
+/**
+ * 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 type { LlmMessage } from "../types.js";
+import { type ProviderHandler, type VendorCapabilities, type ToolSchema, type OutputSchema, type PreparedRequest, type OutputMode } from "./provider-handler.js";
+/**
+ * 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 declare class OpenAIHandler implements ProviderHandler {
+    readonly 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: LlmMessage[], tools: ToolSchema[] | null, outputSchema: OutputSchema | null, options?: {
+        outputMode?: OutputMode;
+        temperature?: number;
+        maxOutputTokens?: number;
+        topP?: number;
+        [key: string]: unknown;
+    }): PreparedRequest;
+    /**
+     * 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: string, toolSchemas: ToolSchema[] | null, outputSchema: OutputSchema | null, outputMode?: OutputMode): string;
+    /**
+     * Return OpenAI-specific capabilities.
+     */
+    getCapabilities(): VendorCapabilities;
+    /**
+     * Determine output mode - OpenAI always uses strict mode for schemas.
+     *
+     * Uses the default implementation since OpenAI has excellent structured output support.
+     */
+    determineOutputMode(outputSchema: OutputSchema | null, overrideMode?: OutputMode): OutputMode;
+}
+//# sourceMappingURL=openai-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai-handler.d.ts","sourceRoot":"","sources":["../../src/provider-handlers/openai-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAK/B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,MAAM,YAAY;IAE3B;;;;;;;;;;;;;OAaG;IACH,cAAc,CACZ,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,EAC1B,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GACA,eAAe;IAyDlB;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,EAChC,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,UAAU,CAAC,EAAE,UAAU,GACtB,MAAM;IA2BT;;OAEG;IACH,eAAe,IAAI,kBAAkB;IAUrC;;;;OAIG;IACH,mBAAmB,CACjB,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,YAAY,CAAC,EAAE,UAAU,GACxB,UAAU;CAGd"}