@openserv-labs/sdk 1.6.0 → 1.7.0

package/README.md

@@ -41,6 +41,7 @@ A powerful TypeScript framework for building non-deterministic AI agents with ad
       - [Upload File](#upload-file)
     - [Integration Management](#integration-management)
       - [Call Integration](#call-integration)
+    - [MCP](#mcp)
   - [Advanced Usage](#advanced-usage)
     - [OpenAI Process Runtime](#openai-process-runtime)
     - [Error Handling](#error-handling)
@@ -573,6 +574,63 @@ const response = await agent.callIntegration({
 })
 ```
 
+### MCP
+
+Easily connect your agent to external [Model Context Protocol](https://modelcontextprotocol.org) (MCP) servers and automatically import their tools as capabilities.
+
+#### Configure MCP servers
+
+Provide an `mcpServers` object when creating the agent. Each key is a **server ID** of your choice. Supported transports are `http`, `sse`, and `stdio`.
+
+```typescript
+import { Agent } from '@openserv-labs/sdk'
+
+const agent = new Agent({
+  systemPrompt: 'You are a search-engine assistant.',
+  mcpServers: {
+    Exa: {
+      transport: 'http',
+      url: 'https://server.smithery.ai/exa/mcp?api_key=YOUR_API_KEY',
+      autoRegisterTools: true // automatically turn MCP tools into capabilities
+    }
+  }
+})
+
+await agent.start()
+```
+
+##### Local (stdio) transport
+
+```typescript
+mcpServers: {
+  LocalLLM: {
+    transport: 'stdio',
+    command: 'my-mcp-binary',
+    args: ['--model', 'gpt-4o'],
+    env: { OPENAI_API_KEY: process.env.OPENAI_API_KEY },
+    autoRegisterTools: true
+  }
+}
+```
+
+##### Server-Sent Events (sse) transport
+
+```typescript
+mcpServers: {
+  Anthropic: {
+    transport: 'sse',
+    url: 'https://my-mcp-server.com/sse',
+    autoRegisterTools: false
+  }
+}
+```
+
+#### Using MCP tools
+
+If `autoRegisterTools` is `true`, each MCP tool becomes a capability named `mcp_<serverId>_<toolName>`.
+
+You can also access the raw MCP client via `agent.mcpClients['MCP_SERVER_ID']` to list tools (`getTools`) or execute them directly (`executeTool`) inside your agents own capabilities.
+
 ## Advanced Usage
 
 ### OpenAI Process Runtime

package/dist/agent.d.ts

@@ -4,12 +4,13 @@ import type { doTaskActionSchema, respondChatMessageActionSchema } from './types
 import { actionSchema } from './types';
 import type { ChatCompletionMessageParam, ChatCompletion } from 'openai/resources/chat/completions';
 import OpenAI from 'openai';
-import type { z } from 'zod';
+import { z } from 'zod';
 import { Capability } from './capability';
+import { type MCPServerConfig, MCPClient } from './mcp';
 /**
  * Configuration options for creating a new Agent instance.
  */
-export interface AgentOptions {
+export interface AgentOptions<T extends string> {
     /**
      * The port number for the agent's HTTP server.
      * Defaults to 7378 if not specified.
@@ -38,8 +39,12 @@ export interface AgentOptions {
      * @param context - Additional context about where the error occurred
      */
     onError?: (error: Error, context?: Record<string, unknown>) => void;
+    /**
+     * Configuration for MCP servers to connect to
+     */
+    mcpServers?: Record<T, MCPServerConfig>;
 }
-export declare class Agent {
+export declare class Agent<M extends string> {
     private options;
     /**
      * The Express application instance used to handle HTTP requests.
@@ -76,7 +81,7 @@ export declare class Agent {
      * Each capability is an instance of the Capability class with a name, description, schema, and run function.
      * @protected
      */
-    protected tools: Array<Capability<z.ZodTypeAny>>;
+    protected tools: Array<Capability<M, z.ZodTypeAny>>;
     /**
      * The OpenServ API key used for authentication.
      * Can be provided in options or via OPENSERV_API_KEY environment variable.
@@ -101,6 +106,11 @@ export declare class Agent {
      * @protected
      */
     protected _openai?: OpenAI;
+    /**
+     * Map of MCP clients by server ID.
+     * @private
+     */
+    mcpClients: Record<M, MCPClient<M>>;
     /**
      * Getter that converts the agent's tools into OpenAI function calling format.
      * Used when making chat completion requests to OpenAI.
@@ -124,7 +134,8 @@ export declare class Agent {
      * @param {AgentOptions} options - Configuration options for the agent
      * @throws {Error} If OpenServ API key is not provided in options or environment
      */
-    constructor(options: AgentOptions);
+    constructor(options: AgentOptions<M>);
+    private initializeMCPClients;
     /**
      * Adds a single capability (tool) to the agent.
      * Each capability must have a unique name and defines a function that can be called via the API.
@@ -146,7 +157,7 @@ export declare class Agent {
         name: string;
         description: string;
         schema: S;
-        run(this: Agent, params: {
+        run(this: Agent<M>, params: {
             args: z.infer<S>;
             action?: z.infer<typeof actionSchema>;
         }, messages: ChatCompletionMessageParam[]): string | Promise<string>;
@@ -169,7 +180,7 @@ export declare class Agent {
             name: string;
             description: string;
             schema: T[K];
-            run(this: Agent, params: {
+            run(this: Agent<M>, params: {
                 args: z.infer<T[K]>;
                 action?: z.infer<typeof actionSchema>;
             }, messages: ChatCompletionMessageParam[]): string | Promise<string>;
@@ -438,5 +449,15 @@ export declare class Agent {
      * @throws {Error} If the integration call fails
      */
     callIntegration(integration: IntegrationCallRequest): Promise<any>;
+    /**
+     * Registers a list of MCP tool descriptors as capabilities on the agent.
+     * Each tool is wrapped in a function that calls `executeMCPTool`.
+     * The capability name is prefixed with `mcp_<serverId>_`.
+     *
+     * @param serverId - The ID of the MCP server these tools belong to.
+     * @param tools - An array of {@link MCPToolDescriptor} objects to register.
+     * @private
+     */
+    private addMCPToolsAsCapabilities;
 }
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

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

package/dist/agent.js

@@ -15,8 +15,10 @@ const logger_1 = require("./logger");
 const types_1 = require("./types");
 const http_errors_1 = require("http-errors");
 const zod_to_json_schema_1 = require("zod-to-json-schema");
+const json_schema_to_zod_1 = require("@n8n/json-schema-to-zod");
 const openai_1 = __importDefault(require("openai"));
 const capability_1 = require("./capability");
+const mcp_1 = require("./mcp");
 const PLATFORM_URL = process.env.OPENSERV_API_URL || 'https://api.openserv.ai';
 const RUNTIME_URL = process.env.OPENSERV_RUNTIME_URL || 'https://agents.openserv.ai';
 const DEFAULT_PORT = Number.parseInt(process.env.PORT || '') || 7378;
@@ -96,6 +98,11 @@ class Agent {
      * @protected
      */
     _openai;
+    /**
+     * Map of MCP clients by server ID.
+     * @private
+     */
+    mcpClients = {};
     /**
      * Getter that converts the agent's tools into OpenAI function calling format.
      * Used when making chat completion requests to OpenAI.
@@ -175,6 +182,20 @@ class Agent {
             logger_1.logger.warn('OPENSERV_AUTH_TOKEN is not set. All requests will be allowed.');
         }
         this.setupRoutes();
+        this.initializeMCPClients();
+    }
+    initializeMCPClients() {
+        if (this.options.mcpServers) {
+            for (const serverId in this.options.mcpServers) {
+                const serverConfig = this.options.mcpServers[serverId];
+                if (!serverConfig) {
+                    logger_1.logger.warn(`MCP server configuration for serverId "${serverId}" is undefined.`);
+                    continue;
+                }
+                const client = new mcp_1.MCPClient(serverId, serverConfig);
+                this.mcpClients[serverId] = client;
+            }
+        }
     }
     /**
      * Adds a single capability (tool) to the agent.
@@ -722,13 +743,40 @@ class Agent {
      * @throws {Error} If server fails to start
      */
     async start() {
-        return new Promise((resolve, reject) => {
+        await new Promise((resolve, reject) => {
             this.server = this.app.listen(this.port, () => {
                 logger_1.logger.info(`Agent server started on port ${this.port}`);
                 resolve();
             });
             this.server.on('error', reject);
         });
+        const connectionPromises = Object.values(this.mcpClients).map(client => client.connect());
+        const results = await Promise.allSettled(connectionPromises);
+        for (const result of results) {
+            if (result.status === 'rejected') {
+                logger_1.logger.error({ error: result.reason }, 'Failed to connect MCP client');
+            }
+        }
+        try {
+            for (const key in this.mcpClients) {
+                const mcpClient = this.mcpClients[key];
+                const serverId = mcpClient.serverId;
+                const serverConfig = this.options.mcpServers?.[serverId];
+                if (!serverConfig?.autoRegisterTools) {
+                    continue;
+                }
+                const tools = mcpClient.getTools();
+                if (tools.length === 0) {
+                    logger_1.logger.info(`MCP server "${serverId}" connected, but no tools found/returned to auto-register.`);
+                    continue;
+                }
+                this.addMCPToolsAsCapabilities(serverId, tools);
+                logger_1.logger.info(`Auto-registered ${tools.length} tools for MCP server "${serverId}".`);
+            }
+        }
+        catch (mcpError) {
+            logger_1.logger.error({ error: mcpError }, 'Error during MCP tools registration');
+        }
     }
     /**
      * Stops the agent's HTTP server.
@@ -769,6 +817,46 @@ class Agent {
         const response = await this.apiClient.post(`/workspaces/${integration.workspaceId}/integration/${integration.integrationId}/proxy`, integration.details);
         return response.data;
     }
+    /**
+     * Registers a list of MCP tool descriptors as capabilities on the agent.
+     * Each tool is wrapped in a function that calls `executeMCPTool`.
+     * The capability name is prefixed with `mcp_<serverId>_`.
+     *
+     * @param serverId - The ID of the MCP server these tools belong to.
+     * @param tools - An array of {@link MCPToolDescriptor} objects to register.
+     * @private
+     */
+    addMCPToolsAsCapabilities(serverId, tools) {
+        for (const tool of tools) {
+            const capabilityName = `mcp_${serverId}_${tool.name}`;
+            const inputSchema = tool.inputSchema ?? { type: 'object', properties: {} };
+            // Register the capability
+            this.addCapability({
+                name: capabilityName,
+                description: tool.description || `Tool from MCP server ${serverId}`,
+                schema: (0, json_schema_to_zod_1.jsonSchemaToZod)(inputSchema),
+                async run({ args }) {
+                    const mcpClient = this.mcpClients[serverId];
+                    if (!mcpClient) {
+                        throw new mcp_1.McpError(mcp_1.MCPErrorCodes.INVALID_PARAMS, `Attempted to run tool for unknown MCP serverId: ${serverId}`);
+                    }
+                    try {
+                        const result = await mcpClient.executeTool(tool.name, args);
+                        // Extract content based on result format
+                        if (result && typeof result === 'object' && 'content' in result) {
+                            const content = result.content;
+                            return typeof content === 'string' ? content : JSON.stringify(content);
+                        }
+                        return JSON.stringify(result);
+                    }
+                    catch (callError) {
+                        logger_1.logger.error(`Error calling MCP tool "${capabilityName}":`, callError);
+                        throw new mcp_1.McpError(mcp_1.MCPErrorCodes.INTERNAL_ERROR, `Failed to execute MCP tool ${tool.name}: ${callError instanceof Error ? callError.message : String(callError)}`);
+                    }
+                }
+            });
+        }
+    }
 }
 exports.Agent = Agent;
 function convertToolToJsonSchema(tool) {

package/dist/capability.d.ts

@@ -2,11 +2,11 @@ import type { z } from 'zod';
 import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions';
 import type { CapabilityFuncParams } from './types';
 import type { Agent } from './agent';
-export declare class Capability<Schema extends z.ZodTypeAny> {
+export declare class Capability<M extends string, Schema extends z.ZodTypeAny> {
     readonly name: string;
     readonly description: string;
     readonly schema: Schema;
-    readonly run: (this: Agent, params: CapabilityFuncParams<Schema>, messages: ChatCompletionMessageParam[]) => string | Promise<string>;
-    constructor(name: string, description: string, schema: Schema, run: (this: Agent, params: CapabilityFuncParams<Schema>, messages: ChatCompletionMessageParam[]) => string | Promise<string>);
+    readonly run: (this: Agent<M>, params: CapabilityFuncParams<Schema>, messages: ChatCompletionMessageParam[]) => string | Promise<string>;
+    constructor(name: string, description: string, schema: Schema, run: (this: Agent<M>, params: CapabilityFuncParams<Schema>, messages: ChatCompletionMessageParam[]) => string | Promise<string>);
 }
 //# sourceMappingURL=capability.d.ts.map

package/dist/capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AACnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,qBAAa,UAAU,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU;aAE/B,IAAI,EAAE,MAAM;aACZ,WAAW,EAAE,MAAM;aACnB,MAAM,EAAE,MAAM;aACd,GAAG,EAAE,CACnB,IAAI,EAAE,KAAK,EACX,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,EACpC,QAAQ,EAAE,0BAA0B,EAAE,KACnC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;gBAPb,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,CACnB,IAAI,EAAE,KAAK,EACX,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,EACpC,QAAQ,EAAE,0BAA0B,EAAE,KACnC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAEhC"}
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AACnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,SAAS,CAAC,CAAC,UAAU;aAEjD,IAAI,EAAE,MAAM;aACZ,WAAW,EAAE,MAAM;aACnB,MAAM,EAAE,MAAM;aACd,GAAG,EAAE,CACnB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,EACpC,QAAQ,EAAE,0BAA0B,EAAE,KACnC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;gBAPb,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,CACnB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,EACpC,QAAQ,EAAE,0BAA0B,EAAE,KACnC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAEhC"}

package/dist/mcp.d.ts

@@ -0,0 +1,289 @@
+import { z } from 'zod';
+export type ProtocolClient = any;
+export type MCPTransport = any;
+/**
+ * Raw descriptor for a tool as returned by an MCP server's listTools method.
+ */
+export type MCPToolDescriptor = {
+    /** The name of the tool. */
+    name: string;
+    /** An optional description of what the tool does. */
+    description?: string;
+    /** An optional JSON schema defining the input parameters for the tool. */
+    inputSchema?: Record<string, unknown>;
+};
+/** Zod schema for validating MCP server configurations using 'stdio' transport. */
+export declare const mcpServerConfigStdioSchema: z.ZodObject<{
+    /** Specifies the transport type as 'stdio'. */
+    transport: z.ZodLiteral<"stdio">;
+    /** The command to execute to start the server. */
+    command: z.ZodString;
+    /** Arguments to pass to the command. */
+    args: z.ZodArray<z.ZodString, "many">;
+    /** Optional environment variables for the command. */
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Whether to automatically discover tools and register them as capabilities upon successful connection. Defaults to false. */
+    autoRegisterTools: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    transport: "stdio";
+    command: string;
+    args: string[];
+    env?: Record<string, string> | undefined;
+    autoRegisterTools?: boolean | undefined;
+}, {
+    transport: "stdio";
+    command: string;
+    args: string[];
+    env?: Record<string, string> | undefined;
+    autoRegisterTools?: boolean | undefined;
+}>;
+/** Zod schema for validating MCP server configurations using 'sse' transport. */
+export declare const mcpServerConfigSseSchema: z.ZodObject<{
+    /** Specifies the transport type as 'sse'. */
+    transport: z.ZodLiteral<"sse">;
+    /** The URL of the MCP server's SSE endpoint. */
+    url: z.ZodString;
+    /** Whether to automatically discover tools and register them as capabilities upon successful connection. Defaults to false. */
+    autoRegisterTools: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    transport: "sse";
+    url: string;
+    autoRegisterTools?: boolean | undefined;
+}, {
+    transport: "sse";
+    url: string;
+    autoRegisterTools?: boolean | undefined;
+}>;
+/** Zod schema for validating MCP server configurations using 'http' (Streamable HTTP) transport. */
+export declare const mcpServerConfigHttpSchema: z.ZodObject<{
+    /** Specifies the transport type as 'http'. */
+    transport: z.ZodLiteral<"http">;
+    /** The URL of the MCP server's HTTP endpoint. */
+    url: z.ZodString;
+    /** Whether to automatically discover tools and register them as capabilities upon successful connection. Defaults to false. */
+    autoRegisterTools: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    transport: "http";
+    url: string;
+    autoRegisterTools?: boolean | undefined;
+}, {
+    transport: "http";
+    url: string;
+    autoRegisterTools?: boolean | undefined;
+}>;
+/**
+ * Discriminated union Zod schema for validating MCP server configurations.
+ * It differentiates based on the 'transport' property.
+ */
+export declare const mcpServerConfigSchema: z.ZodDiscriminatedUnion<"transport", [z.ZodObject<{
+    /** Specifies the transport type as 'stdio'. */
+    transport: z.ZodLiteral<"stdio">;
+    /** The command to execute to start the server. */
+    command: z.ZodString;
+    /** Arguments to pass to the command. */
+    args: z.ZodArray<z.ZodString, "many">;
+    /** Optional environment variables for the command. */
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Whether to automatically discover tools and register them as capabilities upon successful connection. Defaults to false. */
+    autoRegisterTools: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    transport: "stdio";
+    command: string;
+    args: string[];
+    env?: Record<string, string> | undefined;
+    autoRegisterTools?: boolean | undefined;
+}, {
+    transport: "stdio";
+    command: string;
+    args: string[];
+    env?: Record<string, string> | undefined;
+    autoRegisterTools?: boolean | undefined;
+}>, z.ZodObject<{
+    /** Specifies the transport type as 'sse'. */
+    transport: z.ZodLiteral<"sse">;
+    /** The URL of the MCP server's SSE endpoint. */
+    url: z.ZodString;
+    /** Whether to automatically discover tools and register them as capabilities upon successful connection. Defaults to false. */
+    autoRegisterTools: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    transport: "sse";
+    url: string;
+    autoRegisterTools?: boolean | undefined;
+}, {
+    transport: "sse";
+    url: string;
+    autoRegisterTools?: boolean | undefined;
+}>, z.ZodObject<{
+    /** Specifies the transport type as 'http'. */
+    transport: z.ZodLiteral<"http">;
+    /** The URL of the MCP server's HTTP endpoint. */
+    url: z.ZodString;
+    /** Whether to automatically discover tools and register them as capabilities upon successful connection. Defaults to false. */
+    autoRegisterTools: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    transport: "http";
+    url: string;
+    autoRegisterTools?: boolean | undefined;
+}, {
+    transport: "http";
+    url: string;
+    autoRegisterTools?: boolean | undefined;
+}>]>;
+/** Configuration for a single MCP server, covering all transport types. */
+export type MCPServerConfig = z.infer<typeof mcpServerConfigSchema>;
+/** Configuration for an MCP server using 'stdio' (standard input/output) transport. */
+export type MCPServerConfigStdio = z.infer<typeof mcpServerConfigStdioSchema>;
+/** Configuration for an MCP server using 'sse' (Server-Sent Events) transport. */
+export type MCPServerConfigSse = z.infer<typeof mcpServerConfigSseSchema>;
+/** Configuration for an MCP server using 'http' (Streamable HTTP) transport. */
+export type MCPServerConfigHttp = z.infer<typeof mcpServerConfigHttpSchema>;
+/** Dynamically imports the MCP Client class from the MCP SDK. */
+export declare function importClient(): Promise<typeof import("@modelcontextprotocol/sdk/client/index.js", { with: { "resolution-mode": "import" } }).Client>;
+/** Dynamically imports the MCP StdioClientTransport class from the MCP SDK. */
+export declare function importStdioTransport(): Promise<typeof import("@modelcontextprotocol/sdk/client/stdio.js", { with: { "resolution-mode": "import" } }).StdioClientTransport>;
+/** Dynamically imports the MCP SSEClientTransport class from the MCP SDK. */
+export declare function importSSETransport(): Promise<typeof import("@modelcontextprotocol/sdk/client/sse.js", { with: { "resolution-mode": "import" } }).SSEClientTransport>;
+/** Dynamically imports the MCP StreamableHTTPClientTransport class from the MCP SDK. */
+export declare function importHttpTransport(): Promise<typeof import("@modelcontextprotocol/sdk/client/streamableHttp.js", { with: { "resolution-mode": "import" } }).StreamableHTTPClientTransport>;
+/**
+ * Creates a new MCP client instance.
+ * @param name - The name of the client.
+ * @param version - The version of the client.
+ * @returns A promise that resolves to an MCPClient instance.
+ */
+export declare function createClient(name: string, version: string): Promise<ProtocolClient>;
+/**
+ * Creates a new MCP transport layer for stdio communication.
+ * @param options - Configuration options for the stdio transport.
+ * @param options.command - The command to execute to start the server.
+ * @param options.args - Arguments to pass to the command.
+ * @param options.env - Optional environment variables for the command.
+ * @returns A promise that resolves to an MCPTransport instance for stdio.
+ */
+export declare function createStdioTransport(options: {
+    command: string;
+    args: string[];
+    env?: Record<string, string> | undefined;
+}): Promise<MCPTransport>;
+/**
+ * Creates a new MCP transport layer for Server-Sent Events (SSE) communication.
+ * @param url - The URL of the MCP server's SSE endpoint.
+ * @returns A promise that resolves to an MCPTransport instance for SSE.
+ */
+export declare function createSSETransport(url: URL): Promise<MCPTransport>;
+/**
+ * Creates a new MCP transport layer for Streamable HTTP communication.
+ * @param url - The URL of the MCP server's HTTP endpoint.
+ * @returns A promise that resolves to an MCPTransport instance for HTTP.
+ */
+export declare function createHttpTransport(url: URL): Promise<MCPTransport>;
+/**
+ * MCP server class for handling MCP protocol communication.
+ * Manages tool registration and execution.
+ */
+export declare class MCPClient<T extends string> {
+    /** The unique identifier for this MCP server configuration. */
+    serverId: T;
+    /** Array storing discovered tool descriptors after connection. */
+    private tools;
+    /** The configuration object for this specific MCP server. */
+    private config;
+    /** The underlying client instance from the @modelcontextprotocol/sdk. */
+    private client;
+    /**
+     * Creates a new MCPClient instance.
+     * Validates the provided configuration.
+     *
+     * @param serverId - The unique identifier for this MCP server configuration.
+     * @param config - The configuration object for the server.
+     * @throws {McpError} If the configuration is invalid.
+     */
+    constructor(serverId: T, config: MCPServerConfig);
+    /**
+     * Connects to the MCP server using the configured transport.
+     * Establishes a connection based on the transport type (stdio or sse)
+     * and initializes the client with the appropriate transport layer.
+     * @returns {Promise<void>} A promise that resolves when the connection is established and tools (if any) are fetched.
+     * @throws {McpError} If connection fails or transport type is invalid
+     */
+    connect(): Promise<void>;
+    /**
+     * Fetches the list of tool descriptors from the connected MCP server.
+     * Should only be called after a successful connection.
+     *
+     * @returns {Promise<MCPToolDescriptor[]>} A promise resolving to an array of tool descriptors.
+     * @private
+     * @throws {McpError} If the client is not connected or the server response is invalid.
+     */
+    private fetchMCPToolDescriptors;
+    /**
+     * Validates the MCP server configuration using the Zod schema.
+     *
+     * @param serverName - The name/ID of the server (for logging).
+     * @param config - The configuration object to validate.
+     * @returns `true` if valid, `false` otherwise.
+     * @private
+     */
+    private validateMCPServerConfig;
+    /**
+     * Executes a specific tool on the connected MCP server.
+     *
+     * @param toolName - The name of the tool to execute.
+     * @param parameters - The parameters to pass to the tool.
+     * @returns A promise resolving with the result from the tool execution.
+     * @throws {McpError} If the client is not connected or the tool execution fails.
+     */
+    executeTool(toolName: string, parameters: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Gets the list of discovered tool descriptors for this server.
+     * Tools are fetched during the `connect` method.
+     *
+     * @returns {MCPToolDescriptor[]} An array of discovered tool descriptors.
+     */
+    getTools(): MCPToolDescriptor[];
+    /**
+     * Gets the underlying protocol client instance.
+     * Primarily for internal use or specific low-level interactions.
+     *
+     * @returns {ProtocolClient} The raw protocol client instance.
+     */
+    getClient(): ProtocolClient;
+}
+/**
+ * Standard MCP error class with error codes following JSON-RPC spec.
+ * Useful for creating and identifying MCP-specific errors.
+ */
+export declare class McpError extends Error {
+    /** The JSON-RPC error code. */
+    code: number;
+    /** Optional additional data related to the error. */
+    data?: unknown;
+    /**
+     * Constructs an McpError.
+     * @param code - The JSON-RPC error code (see MCPErrorCodes).
+     * @param message - A human-readable description of the error.
+     * @param data - Optional additional data related to the error.
+     */
+    constructor(code: number, message: string, data?: unknown);
+}
+/**
+ * MCP error codes following the JSON-RPC specification.
+ * Provides a standardized set of codes for common MCP errors.
+ */
+export declare const MCPErrorCodes: {
+    /** Connection was closed. */
+    CONNECTION_CLOSED: number;
+    /** Request timed out. */
+    REQUEST_TIMEOUT: number;
+    /** Invalid JSON was received by the server. An error occurred on the server while parsing the JSON text. */
+    PARSE_ERROR: number;
+    /** The JSON sent is not a valid Request object. */
+    INVALID_REQUEST: number;
+    /** The method does not exist / is not available. */
+    METHOD_NOT_FOUND: number;
+    /** Invalid method parameter(s). */
+    INVALID_PARAMS: number;
+    /** Internal JSON-RPC error. */
+    INTERNAL_ERROR: number;
+};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

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

package/dist/mcp.js

@@ -0,0 +1,308 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPErrorCodes = exports.McpError = exports.MCPClient = exports.mcpServerConfigSchema = exports.mcpServerConfigHttpSchema = exports.mcpServerConfigSseSchema = exports.mcpServerConfigStdioSchema = void 0;
+exports.importClient = importClient;
+exports.importStdioTransport = importStdioTransport;
+exports.importSSETransport = importSSETransport;
+exports.importHttpTransport = importHttpTransport;
+exports.createClient = createClient;
+exports.createStdioTransport = createStdioTransport;
+exports.createSSETransport = createSSETransport;
+exports.createHttpTransport = createHttpTransport;
+const zod_1 = require("zod");
+const logger_1 = require("./logger");
+// Zod Schemas for MCP Server Configuration
+/** Zod schema for validating MCP server configurations using 'stdio' transport. */
+exports.mcpServerConfigStdioSchema = zod_1.z.object({
+    /** Specifies the transport type as 'stdio'. */
+    transport: zod_1.z.literal('stdio'),
+    /** The command to execute to start the server. */
+    command: zod_1.z.string().min(1, 'Command cannot be empty'),
+    /** Arguments to pass to the command. */
+    args: zod_1.z.array(zod_1.z.string()),
+    /** Optional environment variables for the command. */
+    env: zod_1.z.record(zod_1.z.string()).optional(),
+    /** Whether to automatically discover tools and register them as capabilities upon successful connection. Defaults to false. */
+    autoRegisterTools: zod_1.z.boolean().optional()
+});
+/** Zod schema for validating MCP server configurations using 'sse' transport. */
+exports.mcpServerConfigSseSchema = zod_1.z.object({
+    /** Specifies the transport type as 'sse'. */
+    transport: zod_1.z.literal('sse'),
+    /** The URL of the MCP server's SSE endpoint. */
+    url: zod_1.z.string().url('Invalid URL format for SSE transport'),
+    /** Whether to automatically discover tools and register them as capabilities upon successful connection. Defaults to false. */
+    autoRegisterTools: zod_1.z.boolean().optional()
+});
+/** Zod schema for validating MCP server configurations using 'http' (Streamable HTTP) transport. */
+exports.mcpServerConfigHttpSchema = zod_1.z.object({
+    /** Specifies the transport type as 'http'. */
+    transport: zod_1.z.literal('http'),
+    /** The URL of the MCP server's HTTP endpoint. */
+    url: zod_1.z.string().url('Invalid URL format for HTTP transport'),
+    /** Whether to automatically discover tools and register them as capabilities upon successful connection. Defaults to false. */
+    autoRegisterTools: zod_1.z.boolean().optional()
+});
+/**
+ * Discriminated union Zod schema for validating MCP server configurations.
+ * It differentiates based on the 'transport' property.
+ */
+exports.mcpServerConfigSchema = zod_1.z.discriminatedUnion('transport', [
+    exports.mcpServerConfigStdioSchema,
+    exports.mcpServerConfigSseSchema,
+    exports.mcpServerConfigHttpSchema
+]);
+/** Dynamically imports the MCP Client class from the MCP SDK. */
+async function importClient() {
+    const { Client } = await import('@modelcontextprotocol/sdk/client/index.js');
+    return Client;
+}
+/** Dynamically imports the MCP StdioClientTransport class from the MCP SDK. */
+async function importStdioTransport() {
+    const { StdioClientTransport } = await import('@modelcontextprotocol/sdk/client/stdio.js');
+    return StdioClientTransport;
+}
+/** Dynamically imports the MCP SSEClientTransport class from the MCP SDK. */
+async function importSSETransport() {
+    const { SSEClientTransport } = await import('@modelcontextprotocol/sdk/client/sse.js');
+    return SSEClientTransport;
+}
+/** Dynamically imports the MCP StreamableHTTPClientTransport class from the MCP SDK. */
+async function importHttpTransport() {
+    const { StreamableHTTPClientTransport } = await import('@modelcontextprotocol/sdk/client/streamableHttp.js');
+    return StreamableHTTPClientTransport;
+}
+/**
+ * Creates a new MCP client instance.
+ * @param name - The name of the client.
+ * @param version - The version of the client.
+ * @returns A promise that resolves to an MCPClient instance.
+ */
+async function createClient(name, version) {
+    const Client = await importClient();
+    return new Client({ name, version });
+}
+/**
+ * Creates a new MCP transport layer for stdio communication.
+ * @param options - Configuration options for the stdio transport.
+ * @param options.command - The command to execute to start the server.
+ * @param options.args - Arguments to pass to the command.
+ * @param options.env - Optional environment variables for the command.
+ * @returns A promise that resolves to an MCPTransport instance for stdio.
+ */
+async function createStdioTransport(options) {
+    const StdioClientTransport = await importStdioTransport();
+    return new StdioClientTransport(options);
+}
+/**
+ * Creates a new MCP transport layer for Server-Sent Events (SSE) communication.
+ * @param url - The URL of the MCP server's SSE endpoint.
+ * @returns A promise that resolves to an MCPTransport instance for SSE.
+ */
+async function createSSETransport(url) {
+    const SSEClientTransport = await importSSETransport();
+    return new SSEClientTransport(url);
+}
+/**
+ * Creates a new MCP transport layer for Streamable HTTP communication.
+ * @param url - The URL of the MCP server's HTTP endpoint.
+ * @returns A promise that resolves to an MCPTransport instance for HTTP.
+ */
+async function createHttpTransport(url) {
+    const StreamableHTTPClientTransport = await importHttpTransport();
+    return new StreamableHTTPClientTransport(url);
+}
+/**
+ * MCP server class for handling MCP protocol communication.
+ * Manages tool registration and execution.
+ */
+class MCPClient {
+    /** The unique identifier for this MCP server configuration. */
+    serverId;
+    /** Array storing discovered tool descriptors after connection. */
+    tools = [];
+    /** The configuration object for this specific MCP server. */
+    config;
+    /** The underlying client instance from the @modelcontextprotocol/sdk. */
+    client;
+    /**
+     * Creates a new MCPClient instance.
+     * Validates the provided configuration.
+     *
+     * @param serverId - The unique identifier for this MCP server configuration.
+     * @param config - The configuration object for the server.
+     * @throws {McpError} If the configuration is invalid.
+     */
+    constructor(serverId, config) {
+        this.config = config;
+        this.serverId = serverId;
+        if (!this.validateMCPServerConfig(this.serverId, this.config)) {
+            throw new McpError(exports.MCPErrorCodes.INVALID_PARAMS, `Invalid configuration for MCP server "${this.serverId}". Check logs for details.`);
+        }
+    }
+    /**
+     * Connects to the MCP server using the configured transport.
+     * Establishes a connection based on the transport type (stdio or sse)
+     * and initializes the client with the appropriate transport layer.
+     * @returns {Promise<void>} A promise that resolves when the connection is established and tools (if any) are fetched.
+     * @throws {McpError} If connection fails or transport type is invalid
+     */
+    async connect() {
+        let transport;
+        const transportType = this.config.transport;
+        try {
+            logger_1.logger.info(`Connecting to MCP server "${this.serverId}" using ${transportType}...`);
+            if (this.config.transport === 'sse') {
+                transport = await createSSETransport(new URL(this.config.url));
+            }
+            else if (this.config.transport === 'http') {
+                transport = await createHttpTransport(new URL(this.config.url));
+            }
+            else if (this.config.transport === 'stdio') {
+                transport = await createStdioTransport({
+                    command: this.config.command,
+                    args: this.config.args,
+                    env: this.config.env
+                });
+            }
+            if (!transport) {
+                throw new McpError(exports.MCPErrorCodes.INTERNAL_ERROR, `Transport could not be initialized for "${this.serverId}" with type ${transportType}.`);
+            }
+            this.client = await createClient(`agent-${this.serverId}`, '1.0.0');
+            this.client.connect(transport);
+            // Wait for the server to be ready
+            await new Promise(resolve => setTimeout(resolve, 5000));
+            logger_1.logger.info(`Successfully connected to MCP server "${this.serverId}"`);
+            this.tools = await this.fetchMCPToolDescriptors();
+        }
+        catch (error) {
+            if (this.client)
+                this.client.disconnect();
+            if (error instanceof McpError) {
+                throw error;
+            }
+            throw new McpError(exports.MCPErrorCodes.INTERNAL_ERROR, `Failed to connect to MCP server "${this.serverId}" using ${transportType}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Fetches the list of tool descriptors from the connected MCP server.
+     * Should only be called after a successful connection.
+     *
+     * @returns {Promise<MCPToolDescriptor[]>} A promise resolving to an array of tool descriptors.
+     * @private
+     * @throws {McpError} If the client is not connected or the server response is invalid.
+     */
+    async fetchMCPToolDescriptors() {
+        if (!this.client) {
+            throw new McpError(exports.MCPErrorCodes.INVALID_PARAMS, `Cannot fetch tool descriptors: No active client found for server "${this.serverId}". Ensure connection was successful.`);
+        }
+        // Request tool list
+        const response = await this.client.listTools();
+        if (!response || !Array.isArray(response.tools)) {
+            logger_1.logger.warn(`No tools returned from "${this.serverId}"`);
+            return [];
+        }
+        return response.tools;
+    }
+    /**
+     * Validates the MCP server configuration using the Zod schema.
+     *
+     * @param serverName - The name/ID of the server (for logging).
+     * @param config - The configuration object to validate.
+     * @returns `true` if valid, `false` otherwise.
+     * @private
+     */
+    validateMCPServerConfig(serverName, config) {
+        const result = exports.mcpServerConfigSchema.safeParse(config);
+        if (!result.success) {
+            logger_1.logger.error(`Invalid configuration for MCP server "${serverName}". Errors: `, result.error.flatten());
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Executes a specific tool on the connected MCP server.
+     *
+     * @param toolName - The name of the tool to execute.
+     * @param parameters - The parameters to pass to the tool.
+     * @returns A promise resolving with the result from the tool execution.
+     * @throws {McpError} If the client is not connected or the tool execution fails.
+     */
+    async executeTool(toolName, parameters) {
+        if (!this.client) {
+            throw new McpError(exports.MCPErrorCodes.CONNECTION_CLOSED, 'Client not connected or initialized');
+        }
+        try {
+            const result = await this.client.callTool({
+                name: toolName,
+                arguments: parameters
+            });
+            return result;
+        }
+        catch (e) {
+            throw new McpError(exports.MCPErrorCodes.INTERNAL_ERROR, `Failed to execute tool ${toolName} on server ${this.serverId}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    /**
+     * Gets the list of discovered tool descriptors for this server.
+     * Tools are fetched during the `connect` method.
+     *
+     * @returns {MCPToolDescriptor[]} An array of discovered tool descriptors.
+     */
+    getTools() {
+        return this.tools;
+    }
+    /**
+     * Gets the underlying protocol client instance.
+     * Primarily for internal use or specific low-level interactions.
+     *
+     * @returns {ProtocolClient} The raw protocol client instance.
+     */
+    getClient() {
+        return this.client;
+    }
+}
+exports.MCPClient = MCPClient;
+/**
+ * Standard MCP error class with error codes following JSON-RPC spec.
+ * Useful for creating and identifying MCP-specific errors.
+ */
+class McpError extends Error {
+    /** The JSON-RPC error code. */
+    code;
+    /** Optional additional data related to the error. */
+    data;
+    /**
+     * Constructs an McpError.
+     * @param code - The JSON-RPC error code (see MCPErrorCodes).
+     * @param message - A human-readable description of the error.
+     * @param data - Optional additional data related to the error.
+     */
+    constructor(code, message, data) {
+        super(`MCP error ${code}: ${message}`);
+        this.name = 'McpError';
+        this.code = code;
+        this.data = data;
+    }
+}
+exports.McpError = McpError;
+/**
+ * MCP error codes following the JSON-RPC specification.
+ * Provides a standardized set of codes for common MCP errors.
+ */
+exports.MCPErrorCodes = {
+    /** Connection was closed. */
+    CONNECTION_CLOSED: -32000,
+    /** Request timed out. */
+    REQUEST_TIMEOUT: -32001,
+    /** Invalid JSON was received by the server. An error occurred on the server while parsing the JSON text. */
+    PARSE_ERROR: -32700,
+    /** The JSON sent is not a valid Request object. */
+    INVALID_REQUEST: -32600,
+    /** The method does not exist / is not available. */
+    METHOD_NOT_FOUND: -32601,
+    /** Invalid method parameter(s). */
+    INVALID_PARAMS: -32602,
+    /** Internal JSON-RPC error. */
+    INTERNAL_ERROR: -32603
+};

package/dist/types.d.ts

@@ -113,7 +113,7 @@ export declare const doTaskActionSchema: z.ZodObject<{
             };
         }>, z.ZodObject<{
             type: z.ZodLiteral<"project-manager-plan-review">;
-            question: z.ZodObject<z.objectUtil.extendShape<{
+            question: z.ZodObject<{
                 tasks: z.ZodArray<z.ZodObject<{
                     index: z.ZodNumber;
                     assigneeAgentId: z.ZodNumber;
@@ -139,9 +139,9 @@ export declare const doTaskActionSchema: z.ZodObject<{
                     taskDescription: string;
                     taskBody: string;
                 }>, "many">;
-            }, {
+            } & {
                 type: z.ZodLiteral<"project-manager-plan-review">;
-            }>, "strip", z.ZodTypeAny, {
+            }, "strip", z.ZodTypeAny, {
                 type: "project-manager-plan-review";
                 tasks: {
                     expectedOutput: string;
@@ -377,6 +377,7 @@ export declare const doTaskActionSchema: z.ZodObject<{
             capabilities_description: string;
         }[];
     }>;
+    workspaceExecutionId: z.ZodOptional<z.ZodNumber>;
     integrations: z.ZodArray<z.ZodObject<{
         id: z.ZodNumber;
         connection_id: z.ZodString;
@@ -526,6 +527,7 @@ export declare const doTaskActionSchema: z.ZodObject<{
         memory: string;
         createdAt: Date;
     }[];
+    workspaceExecutionId?: number | undefined;
 }, {
     type: "do-task";
     me: {
@@ -619,9 +621,11 @@ export declare const doTaskActionSchema: z.ZodObject<{
         memory: string;
         createdAt: Date;
     }[];
+    workspaceExecutionId?: number | undefined;
 }>;
 export declare const respondChatMessageActionSchema: z.ZodObject<{
     type: z.ZodLiteral<"respond-chat-message">;
+    workspaceExecutionId: z.ZodOptional<z.ZodNumber>;
     me: z.ZodIntersection<z.ZodObject<{
         id: z.ZodNumber;
         name: z.ZodString;
@@ -804,6 +808,7 @@ export declare const respondChatMessageActionSchema: z.ZodObject<{
         createdAt: Date;
         author: "agent" | "user";
     }[];
+    workspaceExecutionId?: number | undefined;
 }, {
     type: "respond-chat-message";
     me: {
@@ -850,6 +855,7 @@ export declare const respondChatMessageActionSchema: z.ZodObject<{
         createdAt: Date;
         author: "agent" | "user";
     }[];
+    workspaceExecutionId?: number | undefined;
 }>;
 export declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"do-task">;
@@ -957,7 +963,7 @@ export declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
             };
         }>, z.ZodObject<{
             type: z.ZodLiteral<"project-manager-plan-review">;
-            question: z.ZodObject<z.objectUtil.extendShape<{
+            question: z.ZodObject<{
                 tasks: z.ZodArray<z.ZodObject<{
                     index: z.ZodNumber;
                     assigneeAgentId: z.ZodNumber;
@@ -983,9 +989,9 @@ export declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
                     taskDescription: string;
                     taskBody: string;
                 }>, "many">;
-            }, {
+            } & {
                 type: z.ZodLiteral<"project-manager-plan-review">;
-            }>, "strip", z.ZodTypeAny, {
+            }, "strip", z.ZodTypeAny, {
                 type: "project-manager-plan-review";
                 tasks: {
                     expectedOutput: string;
@@ -1221,6 +1227,7 @@ export declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
             capabilities_description: string;
         }[];
     }>;
+    workspaceExecutionId: z.ZodOptional<z.ZodNumber>;
     integrations: z.ZodArray<z.ZodObject<{
         id: z.ZodNumber;
         connection_id: z.ZodString;
@@ -1370,6 +1377,7 @@ export declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         memory: string;
         createdAt: Date;
     }[];
+    workspaceExecutionId?: number | undefined;
 }, {
     type: "do-task";
     me: {
@@ -1463,8 +1471,10 @@ export declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         memory: string;
         createdAt: Date;
     }[];
+    workspaceExecutionId?: number | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"respond-chat-message">;
+    workspaceExecutionId: z.ZodOptional<z.ZodNumber>;
     me: z.ZodIntersection<z.ZodObject<{
         id: z.ZodNumber;
         name: z.ZodString;
@@ -1647,6 +1657,7 @@ export declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         createdAt: Date;
         author: "agent" | "user";
     }[];
+    workspaceExecutionId?: number | undefined;
 }, {
     type: "respond-chat-message";
     me: {
@@ -1693,6 +1704,7 @@ export declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<
         createdAt: Date;
         author: "agent" | "user";
     }[];
+    workspaceExecutionId?: number | undefined;
 }>]>;
 declare const agentChatMessagesResponseSchema: z.ZodObject<{
     agent: z.ZodObject<{

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -120,6 +120,7 @@ exports.doTaskActionSchema = zod_1.z
             capabilities_description: zod_1.z.string()
         }))
     }),
+    workspaceExecutionId: zod_1.z.number().optional(),
     integrations: zod_1.z.array(zod_1.z.object({
         id: zod_1.z.number(),
         connection_id: zod_1.z.string(),
@@ -143,6 +144,7 @@ exports.doTaskActionSchema = zod_1.z
 exports.respondChatMessageActionSchema = zod_1.z
     .object({
     type: zod_1.z.literal('respond-chat-message'),
+    workspaceExecutionId: zod_1.z.number().optional(),
     me: zod_1.z.intersection(zod_1.z.object({
         id: zod_1.z.number(),
         name: zod_1.z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openserv-labs/sdk",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "OpenServ Agent SDK - Create AI agents easily",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -42,6 +42,8 @@
   "license": "MIT",
   "dependencies": {
     "@asteasolutions/zod-to-openapi": "^7.3.0",
+    "@modelcontextprotocol/sdk": "^1.10.2",
+    "@n8n/json-schema-to-zod": "^1.1.0",
     "axios": "^1.6.8",
     "axios-retry": "^4.1.0",
     "bcryptjs": "^3.0.2",