@mcpmesh/sdk 0.8.0-beta.1

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

@@ -0,0 +1,245 @@
+/**
+ * Base provider handler interface for vendor-specific LLM behavior.
+ *
+ * This module defines the interface for provider-specific handlers
+ * that customize how different LLM vendors (Claude, OpenAI, Gemini, etc.) are called.
+ *
+ * Based on Python's BaseProviderHandler:
+ * src/runtime/python/_mcp_mesh/engine/provider_handlers/base_provider_handler.py
+ */
+import type { LlmMessage } from "../types.js";
+/**
+ * Output mode for structured responses.
+ *
+ * - strict: Use response_format for guaranteed schema compliance (slowest, 100% reliable)
+ * - hint: Use prompt-based JSON instructions (medium speed, ~95% reliable)
+ * - text: Plain text output for string return types (fastest)
+ */
+export type OutputMode = "strict" | "hint" | "text";
+/**
+ * Vendor capability flags.
+ */
+export interface VendorCapabilities {
+    /** Native function/tool calling support */
+    nativeToolCalling: boolean;
+    /** Native structured output via response_format */
+    structuredOutput: boolean;
+    /** Streaming response support */
+    streaming: boolean;
+    /** Vision/image input support */
+    vision: boolean;
+    /** JSON mode via response_format */
+    jsonMode: boolean;
+    /** Prompt caching support (Claude) */
+    promptCaching?: boolean;
+}
+/**
+ * Tool schema in OpenAI format.
+ */
+export interface ToolSchema {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters?: Record<string, unknown>;
+    };
+}
+/**
+ * Prepared request parameters for the LLM API.
+ */
+export interface PreparedRequest {
+    /** Messages to send (may be transformed) */
+    messages: LlmMessage[];
+    /** Tools in vendor-specific format (if provided) */
+    tools?: ToolSchema[];
+    /** Response format configuration (for structured output) */
+    responseFormat?: {
+        type: "json_schema";
+        jsonSchema: {
+            name: string;
+            schema: Record<string, unknown>;
+            strict?: boolean;
+        };
+    };
+    /** Additional vendor-specific parameters */
+    [key: string]: unknown;
+}
+/**
+ * JSON Schema for output type validation.
+ */
+export interface OutputSchema {
+    /** Schema name (typically the type name) */
+    name: string;
+    /** JSON Schema definition */
+    schema: Record<string, unknown>;
+    /** Number of fields in the schema */
+    fieldCount?: number;
+    /** Whether the schema has nested objects */
+    hasNestedObjects?: boolean;
+}
+/**
+ * AI SDK v6 tool result output format.
+ */
+export interface ToolResultOutput {
+    type: "text" | "json";
+    value: unknown;
+}
+/**
+ * Wrap tool result content in AI SDK v6 ToolResultOutput format.
+ *
+ * AI SDK v6 requires tool result output to be structured as:
+ * - { type: 'text', value: string } for text content
+ * - { type: 'json', value: JSONValue } for JSON content
+ *
+ * @param content - Raw tool result content (string)
+ * @returns Properly formatted ToolResultOutput
+ */
+export declare function wrapToolResultOutput(content: string | null | undefined): ToolResultOutput;
+/**
+ * Convert messages to Vercel AI SDK format for multi-turn tool conversations.
+ *
+ * Both Anthropic and OpenAI require specific message formats for tool calls:
+ * - Assistant messages with tool_calls → content array with "tool-call" parts
+ * - Tool result messages → content array with "tool-result" parts
+ *
+ * This conversion ensures Vercel AI SDK properly converts to each provider's native format.
+ *
+ * @param messages - Messages in OpenAI-style format (from mesh network)
+ * @returns Messages in Vercel AI SDK format
+ */
+export declare function convertMessagesToVercelFormat(messages: LlmMessage[]): LlmMessage[];
+/**
+ * Base tool calling instructions shared across all providers.
+ *
+ * Claude handler adds anti-XML instruction on top of this.
+ */
+export declare const BASE_TOOL_INSTRUCTIONS = "\nIMPORTANT TOOL CALLING RULES:\n- You have access to tools that you can call to gather information\n- Make ONE tool call at a time\n- After receiving tool results, you can make additional calls if needed\n- Once you have all needed information, provide your final response\n";
+/**
+ * Anti-XML instruction for Claude (prevents <invoke> style tool calls).
+ */
+export declare const CLAUDE_ANTI_XML_INSTRUCTION = "- NEVER use XML-style syntax like <invoke name=\"tool_name\"/>";
+/**
+ * Options for making a schema strict.
+ */
+export interface MakeSchemaStrictOptions {
+    /**
+     * If true, set 'required' to include ALL property keys.
+     * OpenAI and Gemini require this; Claude does not.
+     * Default: true
+     */
+    addAllRequired?: boolean;
+}
+/**
+ * Make a JSON schema strict for structured output.
+ *
+ * This is a shared utility used by OpenAI, Gemini, and Claude handlers.
+ * Adds additionalProperties: false to all object types and optionally
+ * ensures 'required' includes all property keys.
+ *
+ * @param schema - JSON schema to make strict
+ * @param options - Configuration options
+ * @returns New schema with strict constraints (original not mutated)
+ */
+export declare function makeSchemaStrict(schema: Record<string, unknown>, options?: MakeSchemaStrictOptions): Record<string, unknown>;
+/**
+ * Default implementation of determineOutputMode.
+ *
+ * Most providers (OpenAI, Gemini) use strict mode for schemas.
+ * Claude overrides this with more sophisticated logic.
+ *
+ * @param outputSchema - The output schema (null for string return type)
+ * @param overrideMode - Optional explicit mode override
+ * @returns The determined output mode
+ */
+export declare function defaultDetermineOutputMode(outputSchema: OutputSchema | null, overrideMode?: OutputMode): OutputMode;
+/**
+ * Interface for provider-specific LLM handlers.
+ *
+ * Each vendor (Claude, OpenAI, Gemini, etc.) can have its own handler
+ * that customizes request preparation, system prompt formatting, and
+ * response parsing to work optimally with that vendor's API.
+ *
+ * Handler Selection:
+ *   The ProviderHandlerRegistry selects handlers based on the vendor
+ *   extracted from the model string (e.g., "anthropic/claude-sonnet-4-5" → "anthropic").
+ *
+ * Extensibility:
+ *   New handlers can be added by:
+ *   1. Implementing ProviderHandler interface
+ *   2. Registering in ProviderHandlerRegistry
+ *
+ * @example
+ * ```typescript
+ * class MyHandler implements ProviderHandler {
+ *   readonly vendor = "myvendor";
+ *
+ *   prepareRequest(messages, tools, outputSchema, options) {
+ *     return { messages, tools, ...vendorSpecificParams };
+ *   }
+ *
+ *   formatSystemPrompt(basePrompt, toolSchemas, outputSchema) {
+ *     return basePrompt + "\n\nVendor-specific instructions...";
+ *   }
+ *
+ *   getCapabilities() {
+ *     return { nativeToolCalling: true, structuredOutput: true, ... };
+ *   }
+ * }
+ * ```
+ */
+export interface ProviderHandler {
+    /** Vendor name (e.g., "anthropic", "openai", "google") */
+    readonly vendor: string;
+    /**
+     * Prepare vendor-specific request parameters.
+     *
+     * This method allows customization of the request sent to the LLM provider.
+     * For example:
+     * - Claude: Add cache_control for prompt caching
+     * - OpenAI: Add response_format for structured output
+     * - Gemini: Add generation config
+     *
+     * @param messages - List of messages to send
+     * @param tools - Optional list of tool schemas (OpenAI format)
+     * @param outputSchema - Optional schema for expected response
+     * @param options - Additional options (outputMode, temperature, etc.)
+     * @returns Prepared request parameters
+     */
+    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 vendor-specific requirements.
+     *
+     * Different vendors have different best practices for system prompts:
+     * - Claude: Prefers detailed instructions, handles XML well, needs anti-XML for tools
+     * - OpenAI: Structured output mode makes JSON instructions optional
+     * - Gemini: System instructions separate from messages
+     *
+     * @param basePrompt - Base system prompt (from template or config)
+     * @param toolSchemas - Optional list of tool schemas (if tools available)
+     * @param outputSchema - Optional schema for response validation
+     * @param outputMode - Optional override for output mode
+     * @returns Formatted system prompt string optimized for this vendor
+     */
+    formatSystemPrompt(basePrompt: string, toolSchemas: ToolSchema[] | null, outputSchema: OutputSchema | null, outputMode?: OutputMode): string;
+    /**
+     * Get vendor-specific capability flags.
+     *
+     * @returns Dictionary of capability flags
+     */
+    getCapabilities(): VendorCapabilities;
+    /**
+     * Determine the optimal output mode based on schema complexity.
+     *
+     * @param outputSchema - The output schema (null for string return type)
+     * @param overrideMode - Optional explicit mode override
+     * @returns The determined output mode
+     */
+    determineOutputMode(outputSchema: OutputSchema | null, overrideMode?: OutputMode): OutputMode;
+}
+//# sourceMappingURL=provider-handler.d.ts.map

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

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

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

@@ -0,0 +1,238 @@
+/**
+ * Base provider handler interface for vendor-specific LLM behavior.
+ *
+ * This module defines the interface for provider-specific handlers
+ * that customize how different LLM vendors (Claude, OpenAI, Gemini, etc.) are called.
+ *
+ * Based on Python's BaseProviderHandler:
+ * src/runtime/python/_mcp_mesh/engine/provider_handlers/base_provider_handler.py
+ */
+import { createDebug } from "../debug.js";
+const debug = createDebug("provider-handler");
+/**
+ * Wrap tool result content in AI SDK v6 ToolResultOutput format.
+ *
+ * AI SDK v6 requires tool result output to be structured as:
+ * - { type: 'text', value: string } for text content
+ * - { type: 'json', value: JSONValue } for JSON content
+ *
+ * @param content - Raw tool result content (string)
+ * @returns Properly formatted ToolResultOutput
+ */
+export function wrapToolResultOutput(content) {
+    if (content === null || content === undefined || content === "") {
+        return { type: "text", value: "" };
+    }
+    try {
+        const parsed = JSON.parse(content);
+        // JSON-parsed strings should use text type
+        if (typeof parsed === "string") {
+            return { type: "text", value: parsed };
+        }
+        // null/undefined from JSON.parse should use text
+        if (parsed === null || parsed === undefined) {
+            return { type: "text", value: content };
+        }
+        // Objects, arrays, numbers, booleans use json type
+        return { type: "json", value: parsed };
+    }
+    catch {
+        // Not valid JSON - treat as text
+        return { type: "text", value: content };
+    }
+}
+/**
+ * Convert messages to Vercel AI SDK format for multi-turn tool conversations.
+ *
+ * Both Anthropic and OpenAI require specific message formats for tool calls:
+ * - Assistant messages with tool_calls → content array with "tool-call" parts
+ * - Tool result messages → content array with "tool-result" parts
+ *
+ * This conversion ensures Vercel AI SDK properly converts to each provider's native format.
+ *
+ * @param messages - Messages in OpenAI-style format (from mesh network)
+ * @returns Messages in Vercel AI SDK format
+ */
+export function convertMessagesToVercelFormat(messages) {
+    return messages.map((msg) => {
+        // System and user messages pass through
+        if (msg.role === "system" || msg.role === "user") {
+            return {
+                role: msg.role,
+                content: msg.content ?? "",
+            };
+        }
+        // Assistant messages - convert tool_calls to content blocks
+        if (msg.role === "assistant") {
+            const hasToolCalls = msg.tool_calls && msg.tool_calls.length > 0;
+            if (!hasToolCalls) {
+                return {
+                    role: "assistant",
+                    content: msg.content ?? "",
+                };
+            }
+            // For tool calls, use content blocks format
+            // This is what Vercel AI SDK expects for proper provider conversion
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const contentParts = [];
+            // Add text content if present
+            if (msg.content) {
+                contentParts.push({ type: "text", text: msg.content });
+            }
+            // Add tool calls as content blocks
+            // AI SDK v6 uses 'input' instead of 'args' for tool call parameters
+            for (const tc of msg.tool_calls) {
+                // Parse arguments with fallback for malformed JSON
+                let input = {};
+                try {
+                    input = JSON.parse(tc.function.arguments);
+                }
+                catch (err) {
+                    debug(`Failed to parse tool call arguments for ${tc.function.name}: ${err}. Using empty object.`);
+                }
+                contentParts.push({
+                    type: "tool-call",
+                    toolCallId: tc.id,
+                    toolName: tc.function.name,
+                    input,
+                });
+            }
+            return {
+                role: "assistant",
+                content: contentParts,
+            };
+        }
+        // Tool result messages - convert to content blocks with tool-result type
+        if (msg.role === "tool") {
+            return {
+                role: "tool",
+                content: [{
+                        type: "tool-result",
+                        toolCallId: msg.tool_call_id ?? "",
+                        toolName: msg.name ?? "",
+                        output: wrapToolResultOutput(msg.content),
+                    }],
+            };
+        }
+        // Fallback - return as-is
+        return msg;
+    });
+}
+// ============================================================================
+// Shared Constants
+// ============================================================================
+/**
+ * Base tool calling instructions shared across all providers.
+ *
+ * Claude handler adds anti-XML instruction on top of this.
+ */
+export const BASE_TOOL_INSTRUCTIONS = `
+IMPORTANT TOOL CALLING RULES:
+- You have access to tools that you can call to gather information
+- Make ONE tool call at a time
+- After receiving tool results, you can make additional calls if needed
+- Once you have all needed information, provide your final response
+`;
+/**
+ * Anti-XML instruction for Claude (prevents <invoke> style tool calls).
+ */
+export const CLAUDE_ANTI_XML_INSTRUCTION = `- NEVER use XML-style syntax like <invoke name="tool_name"/>`;
+/**
+ * Make a JSON schema strict for structured output.
+ *
+ * This is a shared utility used by OpenAI, Gemini, and Claude handlers.
+ * Adds additionalProperties: false to all object types and optionally
+ * ensures 'required' includes all property keys.
+ *
+ * @param schema - JSON schema to make strict
+ * @param options - Configuration options
+ * @returns New schema with strict constraints (original not mutated)
+ */
+export function makeSchemaStrict(schema, options = {}) {
+    const { addAllRequired = true } = options;
+    // Deep clone to avoid mutating original
+    const result = JSON.parse(JSON.stringify(schema));
+    addStrictConstraintsRecursive(result, addAllRequired);
+    return result;
+}
+/**
+ * Recursively add strict constraints to a schema object.
+ *
+ * @param obj - Schema object to process (mutated in place)
+ * @param addAllRequired - Whether to set required to all property keys
+ */
+function addStrictConstraintsRecursive(obj, addAllRequired) {
+    if (typeof obj !== "object" || obj === null) {
+        return;
+    }
+    const record = obj;
+    // If this is an object type, add additionalProperties: false
+    if (record.type === "object") {
+        record.additionalProperties = false;
+        // Optionally set required to include all property keys
+        if (addAllRequired && record.properties && typeof record.properties === "object") {
+            record.required = Object.keys(record.properties);
+        }
+    }
+    // Process $defs (used for nested models)
+    if (record.$defs && typeof record.$defs === "object") {
+        for (const defSchema of Object.values(record.$defs)) {
+            addStrictConstraintsRecursive(defSchema, addAllRequired);
+        }
+    }
+    // Process properties
+    if (record.properties && typeof record.properties === "object") {
+        for (const propSchema of Object.values(record.properties)) {
+            addStrictConstraintsRecursive(propSchema, addAllRequired);
+        }
+    }
+    // Process items (for arrays)
+    // items can be an object (single schema) or an array (tuple validation in older drafts)
+    if (record.items) {
+        if (Array.isArray(record.items)) {
+            for (const item of record.items) {
+                addStrictConstraintsRecursive(item, addAllRequired);
+            }
+        }
+        else {
+            addStrictConstraintsRecursive(record.items, addAllRequired);
+        }
+    }
+    // Process prefixItems (tuple validation in JSON Schema draft 2020-12)
+    if (Array.isArray(record.prefixItems)) {
+        for (const item of record.prefixItems) {
+            addStrictConstraintsRecursive(item, addAllRequired);
+        }
+    }
+    // Process anyOf, oneOf, allOf
+    for (const key of ["anyOf", "oneOf", "allOf"]) {
+        if (Array.isArray(record[key])) {
+            for (const item of record[key]) {
+                addStrictConstraintsRecursive(item, addAllRequired);
+            }
+        }
+    }
+}
+/**
+ * Default implementation of determineOutputMode.
+ *
+ * Most providers (OpenAI, Gemini) use strict mode for schemas.
+ * Claude overrides this with more sophisticated logic.
+ *
+ * @param outputSchema - The output schema (null for string return type)
+ * @param overrideMode - Optional explicit mode override
+ * @returns The determined output mode
+ */
+export function defaultDetermineOutputMode(outputSchema, overrideMode) {
+    // Allow explicit override
+    if (overrideMode) {
+        return overrideMode;
+    }
+    // No schema means text mode
+    if (!outputSchema) {
+        return "text";
+    }
+    // Default: use strict mode for schemas
+    return "strict";
+}
+//# sourceMappingURL=provider-handler.js.map

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

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

package/dist/proxy.d.ts

@@ -0,0 +1,44 @@
+/**
+ * MCP Mesh proxy implementation for dependency injection.
+ *
+ * Provides HTTP client proxies for calling remote MCP agents.
+ */
+import type { McpMeshAgent, DependencyKwargs } from "./types.js";
+import type { TraceContext } from "./tracing.js";
+/**
+ * Run a function with trace context.
+ * The context is automatically propagated to all async operations within the callback.
+ * This is the preferred way to set trace context for tool execution.
+ */
+export declare function runWithTraceContext<T>(ctx: TraceContext, fn: () => T | Promise<T>): T | Promise<T>;
+/**
+ * Get the current trace context.
+ * Returns the trace context for the current async execution context,
+ * or null if not within a traced context.
+ */
+export declare function getCurrentTraceContext(): TraceContext | null;
+/**
+ * @deprecated Use runWithTraceContext() instead for async-safe context propagation.
+ * This function is kept for backward compatibility but does nothing.
+ */
+export declare function setCurrentTraceContext(_ctx: TraceContext | null): void;
+/**
+ * Create an McpMeshAgent proxy for a resolved dependency.
+ *
+ * The returned object is callable (invokes the bound function)
+ * and also has methods for calling other tools on the agent.
+ */
+export declare function createProxy(endpoint: string, capability: string, functionName: string, kwargs?: DependencyKwargs): McpMeshAgent;
+/**
+ * Normalize a DependencySpec to canonical form.
+ */
+export declare function normalizeDependency(dep: string | {
+    capability: string;
+    tags?: string[];
+    version?: string;
+}): {
+    capability: string;
+    tags: string[];
+    version?: string;
+};
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAcjD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,GAAG,EAAE,YAAY,EACjB,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,GAAG,IAAI,CAE5D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAGtE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,gBAAgB,GACxB,YAAY,CAyCd;AAgSD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAS1D"}