@mcpmesh/sdk 0.8.0-beta.1

package/dist/llm-provider.d.ts

@@ -0,0 +1,323 @@
+/**
+ * LLM Provider implementation for @mcpmesh/sdk.
+ *
+ * Provides mesh.llmProvider() for zero-code LLM providers using Vercel AI SDK.
+ * This is the TypeScript equivalent of Python's @mesh.llm_provider decorator.
+ *
+ * @example
+ * ```typescript
+ * import { FastMCP } from "fastmcp";
+ * import { mesh } from "@mcpmesh/sdk";
+ *
+ * const server = new FastMCP({ name: "Claude Provider", version: "1.0.0" });
+ *
+ * // Zero-code LLM provider
+ * server.addTool(mesh.llmProvider({
+ *   model: "anthropic/claude-sonnet-4-5",
+ *   capability: "llm",
+ *   tags: ["llm", "claude", "anthropic", "provider"],
+ * }));
+ *
+ * const agent = mesh(server, { name: "claude-provider", port: 9011 });
+ * ```
+ */
+import { z } from "zod";
+import type { LlmProviderConfig } from "./types.js";
+/**
+ * Extract vendor name from model string.
+ *
+ * Uses vendor/model format (e.g., "anthropic/claude-sonnet-4-5" → "anthropic").
+ *
+ * @param model - Model string (e.g., "anthropic/claude-sonnet-4-5")
+ * @returns Vendor name or null if not extractable
+ *
+ * @example
+ * ```typescript
+ * extractVendorFromModel("anthropic/claude-sonnet-4-5") // "anthropic"
+ * extractVendorFromModel("openai/gpt-4o") // "openai"
+ * extractVendorFromModel("gpt-4") // null
+ * ```
+ */
+export declare function extractVendorFromModel(model: string): string | null;
+/**
+ * Extract model name without vendor prefix.
+ *
+ * @param model - Model string (e.g., "anthropic/claude-sonnet-4-5")
+ * @returns Model name without vendor prefix
+ *
+ * @example
+ * ```typescript
+ * extractModelName("anthropic/claude-sonnet-4-5") // "claude-sonnet-4-5"
+ * extractModelName("gpt-4") // "gpt-4"
+ * ```
+ */
+export declare function extractModelName(model: string): string;
+/**
+ * Zod schema for MeshLlmRequest input.
+ */
+declare const MeshLlmRequestSchema: z.ZodObject<{
+    request: z.ZodObject<{
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<["system", "user", "assistant", "tool"]>;
+            content: z.ZodNullable<z.ZodString>;
+            tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodLiteral<"function">;
+                function: z.ZodObject<{
+                    name: z.ZodString;
+                    arguments: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    name: string;
+                    arguments: string;
+                }, {
+                    name: string;
+                    arguments: string;
+                }>;
+            }, "strip", z.ZodTypeAny, {
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+                type: "function";
+                id: string;
+            }, {
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+                type: "function";
+                id: string;
+            }>, "many">>;
+            tool_call_id: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            content: string | null;
+            role: "system" | "user" | "assistant" | "tool";
+            tool_calls?: {
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+                type: "function";
+                id: string;
+            }[] | undefined;
+            name?: string | undefined;
+            tool_call_id?: string | undefined;
+        }, {
+            content: string | null;
+            role: "system" | "user" | "assistant" | "tool";
+            tool_calls?: {
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+                type: "function";
+                id: string;
+            }[] | undefined;
+            name?: string | undefined;
+            tool_call_id?: string | undefined;
+        }>, "many">;
+        tools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            function: z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                description?: string | undefined;
+                parameters?: Record<string, unknown> | undefined;
+            }, {
+                name: string;
+                description?: string | undefined;
+                parameters?: Record<string, unknown> | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            function: {
+                name: string;
+                description?: string | undefined;
+                parameters?: Record<string, unknown> | undefined;
+            };
+            type: "function";
+        }, {
+            function: {
+                name: string;
+                description?: string | undefined;
+                parameters?: Record<string, unknown> | undefined;
+            };
+            type: "function";
+        }>, "many">>>;
+        model_params: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        context: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        request_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        caller_agent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        messages: {
+            content: string | null;
+            role: "system" | "user" | "assistant" | "tool";
+            tool_calls?: {
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+                type: "function";
+                id: string;
+            }[] | undefined;
+            name?: string | undefined;
+            tool_call_id?: string | undefined;
+        }[];
+        tools?: {
+            function: {
+                name: string;
+                description?: string | undefined;
+                parameters?: Record<string, unknown> | undefined;
+            };
+            type: "function";
+        }[] | null | undefined;
+        model_params?: Record<string, unknown> | null | undefined;
+        context?: Record<string, unknown> | null | undefined;
+        request_id?: string | null | undefined;
+        caller_agent?: string | null | undefined;
+    }, {
+        messages: {
+            content: string | null;
+            role: "system" | "user" | "assistant" | "tool";
+            tool_calls?: {
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+                type: "function";
+                id: string;
+            }[] | undefined;
+            name?: string | undefined;
+            tool_call_id?: string | undefined;
+        }[];
+        tools?: {
+            function: {
+                name: string;
+                description?: string | undefined;
+                parameters?: Record<string, unknown> | undefined;
+            };
+            type: "function";
+        }[] | null | undefined;
+        model_params?: Record<string, unknown> | null | undefined;
+        context?: Record<string, unknown> | null | undefined;
+        request_id?: string | null | undefined;
+        caller_agent?: string | null | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    request: {
+        messages: {
+            content: string | null;
+            role: "system" | "user" | "assistant" | "tool";
+            tool_calls?: {
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+                type: "function";
+                id: string;
+            }[] | undefined;
+            name?: string | undefined;
+            tool_call_id?: string | undefined;
+        }[];
+        tools?: {
+            function: {
+                name: string;
+                description?: string | undefined;
+                parameters?: Record<string, unknown> | undefined;
+            };
+            type: "function";
+        }[] | null | undefined;
+        model_params?: Record<string, unknown> | null | undefined;
+        context?: Record<string, unknown> | null | undefined;
+        request_id?: string | null | undefined;
+        caller_agent?: string | null | undefined;
+    };
+}, {
+    request: {
+        messages: {
+            content: string | null;
+            role: "system" | "user" | "assistant" | "tool";
+            tool_calls?: {
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+                type: "function";
+                id: string;
+            }[] | undefined;
+            name?: string | undefined;
+            tool_call_id?: string | undefined;
+        }[];
+        tools?: {
+            function: {
+                name: string;
+                description?: string | undefined;
+                parameters?: Record<string, unknown> | undefined;
+            };
+            type: "function";
+        }[] | null | undefined;
+        model_params?: Record<string, unknown> | null | undefined;
+        context?: Record<string, unknown> | null | undefined;
+        request_id?: string | null | undefined;
+        caller_agent?: string | null | undefined;
+    };
+}>;
+type MeshLlmRequestInput = z.infer<typeof MeshLlmRequestSchema>;
+/**
+ * Create a zero-code LLM provider tool definition.
+ *
+ * This is the TypeScript equivalent of Python's @mesh.llm_provider decorator.
+ * It generates a process_chat function that handles MeshLlmRequest and returns
+ * MeshLlmResponse with tool_calls and usage metadata.
+ *
+ * @param config - LLM provider configuration
+ * @returns fastmcp tool definition
+ *
+ * @example
+ * ```typescript
+ * import { FastMCP } from "fastmcp";
+ * import { mesh } from "@mcpmesh/sdk";
+ *
+ * const server = new FastMCP({ name: "Claude Provider", version: "1.0.0" });
+ *
+ * server.addTool(mesh.llmProvider({
+ *   model: "anthropic/claude-sonnet-4-5",
+ *   capability: "llm",
+ *   tags: ["llm", "claude", "anthropic", "provider"],
+ *   maxOutputTokens: 4096,
+ *   temperature: 0.7,
+ * }));
+ *
+ * const agent = mesh(server, { name: "claude-provider", port: 9011 });
+ * ```
+ */
+export declare function llmProvider(config: LlmProviderConfig): {
+    name: string;
+    description: string;
+    parameters: typeof MeshLlmRequestSchema;
+    execute: (args: MeshLlmRequestInput) => Promise<string>;
+    _meshMeta?: {
+        capability: string;
+        tags: string[];
+        version: string;
+        vendor: string;
+    };
+};
+/**
+ * Check if a tool definition is an LLM provider.
+ */
+export declare function isLlmProviderTool(tool: unknown): tool is ReturnType<typeof llmProvider>;
+/**
+ * Get LLM provider metadata from a tool definition.
+ */
+export declare function getLlmProviderMeta(tool: ReturnType<typeof llmProvider>): {
+    capability: string;
+    tags: string[];
+    version: string;
+    vendor: string;
+} | null;
+export {};
+//# sourceMappingURL=llm-provider.d.ts.map

package/dist/llm-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.d.ts","sourceRoot":"","sources":["../src/llm-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EACV,iBAAiB,EAKlB,MAAM,YAAY,CAAC;AAwDpB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKtD;AAgGD;;GAEG;AACH,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCxB,CAAC;AAEH,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,oBAAoB,CAAC;IACxC,OAAO,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAExD,SAAS,CAAC,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAuRA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,GACZ,IAAI,IAAI,UAAU,CAAC,OAAO,WAAW,CAAC,CAOxC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CAEP"}