@letta-ai/letta-client 1.0.0-alpha.15 → 1.0.0-alpha.16

package/resources/mcp-servers/mcp-servers.d.ts

@@ -1,13 +1,11 @@
 import { APIResource } from "../../core/resource.js";
-import * as RefreshAPI from "./refresh.js";
-import { Refresh, RefreshTriggerParams, RefreshTriggerResponse } from "./refresh.js";
+import * as AgentsAPI from "../agents/agents.js";
 import * as ToolsAPI from "./tools.js";
-import { ToolListResponse, ToolRetrieveParams, ToolRunParams, ToolRunResponse, Tools } from "./tools.js";
+import { ToolListResponse, ToolRetrieveParams, ToolRunParams, Tools } from "./tools.js";
 import { APIPromise } from "../../core/api-promise.js";
 import { RequestOptions } from "../../internal/request-options.js";
 export declare class McpServers extends APIResource {
     tools: ToolsAPI.Tools;
-    refresh: RefreshAPI.Refresh;
     /**
      * Add a new MCP server to the Letta MCP server config
      */
@@ -33,416 +31,340 @@ export declare class McpServers extends APIResource {
      * Update an existing MCP server configuration
      */
     modify(mcpServerID: string, body: McpServerModifyParams, options?: RequestOptions): APIPromise<McpServerModifyResponse>;
+    /**
+     * Refresh tools for an MCP server by:
+     *
+     * 1. Fetching current tools from the MCP server
+     * 2. Deleting tools that no longer exist on the server
+     * 3. Updating schemas for existing tools
+     * 4. Adding new tools from the server
+     *
+     * Returns a summary of changes made.
+     */
+    refresh(mcpServerID: string, params?: McpServerRefreshParams | null | undefined, options?: RequestOptions): APIPromise<unknown>;
 }
 /**
- * MCP server schema for agent files with remapped ID.
+ * Create a new SSE MCP server
  */
-export interface McpServerSchema {
+export interface CreateSseMcpServer {
     /**
-     * Human-readable MCP server ID
+     * The name of the server
      */
-    id: string;
     server_name: string;
-    server_type: string;
-    metadata_?: {
-        [key: string]: unknown;
+    /**
+     * The URL of the server
+     */
+    server_url: string;
+    /**
+     * The name of the authentication header (e.g., 'Authorization')
+     */
+    auth_header?: string | null;
+    /**
+     * The authentication token or API key value
+     */
+    auth_token?: string | null;
+    /**
+     * Custom HTTP headers to include with requests
+     */
+    custom_headers?: {
+        [key: string]: string;
     } | null;
-    server_url?: string | null;
-    stdio_config?: {
+    type?: 'sse' | 'stdio' | 'streamable_http';
+}
+/**
+ * Create a new Stdio MCP server
+ */
+export interface CreateStdioMcpServer {
+    /**
+     * The arguments to pass to the command
+     */
+    args: Array<string>;
+    /**
+     * The command to run (MCP 'local' client will run this command)
+     */
+    command: string;
+    /**
+     * The name of the server
+     */
+    server_name: string;
+    /**
+     * Environment variables to set
+     */
+    env?: {
+        [key: string]: string;
+    } | null;
+    type?: 'sse' | 'stdio' | 'streamable_http';
+}
+/**
+ * Create a new Streamable HTTP MCP server
+ */
+export interface CreateStreamableHTTPMcpServer {
+    /**
+     * The name of the server
+     */
+    server_name: string;
+    /**
+     * The URL of the server
+     */
+    server_url: string;
+    /**
+     * The name of the authentication header (e.g., 'Authorization')
+     */
+    auth_header?: string | null;
+    /**
+     * The authentication token or API key value
+     */
+    auth_token?: string | null;
+    /**
+     * Custom HTTP headers to include with requests
+     */
+    custom_headers?: {
+        [key: string]: string;
+    } | null;
+    type?: 'sse' | 'stdio' | 'streamable_http';
+}
+/**
+ * Request to execute an MCP tool by IDs.
+ */
+export interface McpToolExecuteRequest {
+    /**
+     * Arguments to pass to the MCP tool
+     */
+    args?: {
         [key: string]: unknown;
+    };
+}
+/**
+ * An SSE MCP server
+ */
+export interface SseMcpServer {
+    /**
+     * The name of the server
+     */
+    server_name: string;
+    /**
+     * The URL of the server
+     */
+    server_url: string;
+    /**
+     * The human-friendly ID of the Mcp_server
+     */
+    id?: string;
+    /**
+     * The name of the authentication header (e.g., 'Authorization')
+     */
+    auth_header?: string | null;
+    /**
+     * The authentication token or API key value
+     */
+    auth_token?: string | null;
+    /**
+     * Custom HTTP headers to include with requests
+     */
+    custom_headers?: {
+        [key: string]: string;
     } | null;
+    type?: 'sse' | 'stdio' | 'streamable_http';
 }
 /**
  * A Stdio MCP server
  */
-export type McpServerCreateResponse = McpServerCreateResponse.StdioMcpServer | McpServerCreateResponse.SsemcpServer | McpServerCreateResponse.StreamableHttpmcpServer;
-export declare namespace McpServerCreateResponse {
+export interface StdioMcpServer {
     /**
-     * A Stdio MCP server
+     * The arguments to pass to the command
      */
-    interface StdioMcpServer {
-        /**
-         * The arguments to pass to the command
-         */
-        args: Array<string>;
-        /**
-         * The command to run (MCP 'local' client will run this command)
-         */
-        command: string;
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * Environment variables to set
-         */
-        env?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    args: Array<string>;
     /**
-     * An SSE MCP server
+     * The command to run (MCP 'local' client will run this command)
      */
-    interface SsemcpServer {
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The URL of the server
-         */
-        server_url: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * The name of the authentication header (e.g., 'Authorization')
-         */
-        auth_header?: string | null;
-        /**
-         * The authentication token or API key value
-         */
-        auth_token?: string | null;
-        /**
-         * Custom HTTP headers to include with requests
-         */
-        custom_headers?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    command: string;
     /**
-     * A Streamable HTTP MCP server
+     * The name of the server
      */
-    interface StreamableHttpmcpServer {
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The URL of the server
-         */
-        server_url: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * The name of the authentication header (e.g., 'Authorization')
-         */
-        auth_header?: string | null;
-        /**
-         * The authentication token or API key value
-         */
-        auth_token?: string | null;
-        /**
-         * Custom HTTP headers to include with requests
-         */
-        custom_headers?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    server_name: string;
+    /**
+     * The human-friendly ID of the Mcp_server
+     */
+    id?: string;
+    /**
+     * Environment variables to set
+     */
+    env?: {
+        [key: string]: string;
+    } | null;
+    type?: 'sse' | 'stdio' | 'streamable_http';
 }
 /**
- * A Stdio MCP server
+ * A Streamable HTTP MCP server
  */
-export type McpServerRetrieveResponse = McpServerRetrieveResponse.StdioMcpServer | McpServerRetrieveResponse.SsemcpServer | McpServerRetrieveResponse.StreamableHttpmcpServer;
-export declare namespace McpServerRetrieveResponse {
+export interface StreamableHTTPMcpServer {
     /**
-     * A Stdio MCP server
+     * The name of the server
      */
-    interface StdioMcpServer {
-        /**
-         * The arguments to pass to the command
-         */
-        args: Array<string>;
-        /**
-         * The command to run (MCP 'local' client will run this command)
-         */
-        command: string;
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * Environment variables to set
-         */
-        env?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    server_name: string;
     /**
-     * An SSE MCP server
+     * The URL of the server
      */
-    interface SsemcpServer {
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The URL of the server
-         */
-        server_url: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * The name of the authentication header (e.g., 'Authorization')
-         */
-        auth_header?: string | null;
-        /**
-         * The authentication token or API key value
-         */
-        auth_token?: string | null;
-        /**
-         * Custom HTTP headers to include with requests
-         */
-        custom_headers?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    server_url: string;
     /**
-     * A Streamable HTTP MCP server
+     * The human-friendly ID of the Mcp_server
      */
-    interface StreamableHttpmcpServer {
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The URL of the server
-         */
-        server_url: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * The name of the authentication header (e.g., 'Authorization')
-         */
-        auth_header?: string | null;
-        /**
-         * The authentication token or API key value
-         */
-        auth_token?: string | null;
-        /**
-         * Custom HTTP headers to include with requests
-         */
-        custom_headers?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    id?: string;
+    /**
+     * The name of the authentication header (e.g., 'Authorization')
+     */
+    auth_header?: string | null;
+    /**
+     * The authentication token or API key value
+     */
+    auth_token?: string | null;
+    /**
+     * Custom HTTP headers to include with requests
+     */
+    custom_headers?: {
+        [key: string]: string;
+    } | null;
+    type?: 'sse' | 'stdio' | 'streamable_http';
 }
-export type McpServerListResponse = Array<McpServerListResponse.StdioMcpServer | McpServerListResponse.SsemcpServer | McpServerListResponse.StreamableHttpmcpServer>;
-export declare namespace McpServerListResponse {
+export interface ToolExecutionResult {
     /**
-     * A Stdio MCP server
+     * The status of the tool execution and return object
      */
-    interface StdioMcpServer {
-        /**
-         * The arguments to pass to the command
-         */
-        args: Array<string>;
-        /**
-         * The command to run (MCP 'local' client will run this command)
-         */
-        command: string;
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * Environment variables to set
-         */
-        env?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    status: 'success' | 'error';
     /**
-     * An SSE MCP server
+     * Representation of an agent's state. This is the state of the agent at a given
+     * time, and is persisted in the DB backend. The state has all the information
+     * needed to recreate a persisted agent.
+     *
+     * Parameters: id (str): The unique identifier of the agent. name (str): The name
+     * of the agent (must be unique to the user). created_at (datetime): The datetime
+     * the agent was created. message_ids (List[str]): The ids of the messages in the
+     * agent's in-context memory. memory (Memory): The in-context memory of the agent.
+     * tools (List[str]): The tools used by the agent. This includes any memory editing
+     * functions specified in `memory`. system (str): The system prompt used by the
+     * agent. llm_config (LLMConfig): The LLM configuration used by the agent.
+     * embedding_config (EmbeddingConfig): The embedding configuration used by the
+     * agent.
      */
-    interface SsemcpServer {
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The URL of the server
-         */
-        server_url: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * The name of the authentication header (e.g., 'Authorization')
-         */
-        auth_header?: string | null;
-        /**
-         * The authentication token or API key value
-         */
-        auth_token?: string | null;
-        /**
-         * Custom HTTP headers to include with requests
-         */
-        custom_headers?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    agent_state?: AgentsAPI.AgentState | null;
     /**
-     * A Streamable HTTP MCP server
+     * The function return object
      */
-    interface StreamableHttpmcpServer {
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The URL of the server
-         */
-        server_url: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * The name of the authentication header (e.g., 'Authorization')
-         */
-        auth_header?: string | null;
-        /**
-         * The authentication token or API key value
-         */
-        auth_token?: string | null;
-        /**
-         * Custom HTTP headers to include with requests
-         */
-        custom_headers?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    func_return?: unknown;
+    /**
+     * The fingerprint of the config for the sandbox
+     */
+    sandbox_config_fingerprint?: string | null;
+    /**
+     * Captured stderr from the function invocation
+     */
+    stderr?: Array<string> | null;
+    /**
+     * Captured stdout (prints, logs) from function invocation
+     */
+    stdout?: Array<string> | null;
 }
-export type McpServerConnectResponse = unknown;
 /**
- * A Stdio MCP server
+ * Update schema for SSE MCP server - all fields optional
  */
-export type McpServerModifyResponse = McpServerModifyResponse.StdioMcpServer | McpServerModifyResponse.SsemcpServer | McpServerModifyResponse.StreamableHttpmcpServer;
-export declare namespace McpServerModifyResponse {
+export interface UpdateSseMcpServer {
     /**
-     * A Stdio MCP server
+     * The authentication token (internal)
      */
-    interface StdioMcpServer {
-        /**
-         * The arguments to pass to the command
-         */
-        args: Array<string>;
-        /**
-         * The command to run (MCP 'local' client will run this command)
-         */
-        command: string;
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * Environment variables to set
-         */
-        env?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    token?: string | null;
     /**
-     * An SSE MCP server
+     * The name of the authentication header (e.g., 'Authorization')
      */
-    interface SsemcpServer {
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The URL of the server
-         */
-        server_url: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * The name of the authentication header (e.g., 'Authorization')
-         */
-        auth_header?: string | null;
-        /**
-         * The authentication token or API key value
-         */
-        auth_token?: string | null;
-        /**
-         * Custom HTTP headers to include with requests
-         */
-        custom_headers?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    auth_header?: string | null;
     /**
-     * A Streamable HTTP MCP server
+     * The authentication token or API key value
      */
-    interface StreamableHttpmcpServer {
-        /**
-         * The name of the server
-         */
-        server_name: string;
-        /**
-         * The URL of the server
-         */
-        server_url: string;
-        /**
-         * The human-friendly ID of the Mcp_server
-         */
-        id?: string;
-        /**
-         * The name of the authentication header (e.g., 'Authorization')
-         */
-        auth_header?: string | null;
-        /**
-         * The authentication token or API key value
-         */
-        auth_token?: string | null;
-        /**
-         * Custom HTTP headers to include with requests
-         */
-        custom_headers?: {
-            [key: string]: string;
-        } | null;
-        type?: 'sse' | 'stdio' | 'streamable_http';
-    }
+    auth_token?: string | null;
+    /**
+     * Custom headers to send with requests
+     */
+    custom_headers?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * The name of the MCP server
+     */
+    server_name?: string | null;
+    /**
+     * The URL of the SSE MCP server
+     */
+    server_url?: string | null;
 }
-export type McpServerCreateParams = McpServerCreateParams.CreateStdioMcpServer | McpServerCreateParams.CreateSsemcpServer | McpServerCreateParams.CreateStreamableHttpmcpServer;
+/**
+ * Update schema for Stdio MCP server - all fields optional
+ */
+export interface UpdateStdioMcpServer {
+    /**
+     * The arguments to pass to the command
+     */
+    args?: Array<string> | null;
+    /**
+     * The command to run the MCP server
+     */
+    command?: string | null;
+    /**
+     * Environment variables to set
+     */
+    env?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * The name of the MCP server
+     */
+    server_name?: string | null;
+}
+/**
+ * Update schema for Streamable HTTP MCP server - all fields optional
+ */
+export interface UpdateStreamableHTTPMcpServer {
+    /**
+     * The authentication token (internal)
+     */
+    token?: string | null;
+    /**
+     * The name of the authentication header (e.g., 'Authorization')
+     */
+    auth_header?: string | null;
+    /**
+     * The authentication token or API key value
+     */
+    auth_token?: string | null;
+    /**
+     * Custom headers to send with requests
+     */
+    custom_headers?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * The name of the MCP server
+     */
+    server_name?: string | null;
+    /**
+     * The URL of the Streamable HTTP MCP server
+     */
+    server_url?: string | null;
+}
+/**
+ * A Stdio MCP server
+ */
+export type McpServerCreateResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
+/**
+ * A Stdio MCP server
+ */
+export type McpServerRetrieveResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
+export type McpServerListResponse = Array<StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer>;
+export type McpServerConnectResponse = unknown;
+/**
+ * A Stdio MCP server
+ */
+export type McpServerModifyResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
+export type McpServerRefreshResponse = unknown;
+export type McpServerCreateParams = McpServerCreateParams.CreateStdioMcpServer | McpServerCreateParams.CreateSseMcpServer | McpServerCreateParams.CreateStreamableHTTPMcpServer;
 export declare namespace McpServerCreateParams {
     interface CreateStdioMcpServer {
         /**
@@ -465,7 +387,7 @@ export declare namespace McpServerCreateParams {
         } | null;
         type?: 'sse' | 'stdio' | 'streamable_http';
     }
-    interface CreateSsemcpServer {
+    interface CreateSseMcpServer {
         /**
          * The name of the server
          */
@@ -490,7 +412,7 @@ export declare namespace McpServerCreateParams {
         } | null;
         type?: 'sse' | 'stdio' | 'streamable_http';
     }
-    interface CreateStreamableHttpmcpServer {
+    interface CreateStreamableHTTPMcpServer {
         /**
          * The name of the server
          */
@@ -516,9 +438,9 @@ export declare namespace McpServerCreateParams {
         type?: 'sse' | 'stdio' | 'streamable_http';
     }
 }
-export type McpServerModifyParams = McpServerModifyParams.LettaSchemasMcpServerUpdateStdioMcpServer | McpServerModifyParams.LettaSchemasMcpServerUpdateSsemcpServer | McpServerModifyParams.LettaSchemasMcpServerUpdateStreamableHttpmcpServer;
+export type McpServerModifyParams = McpServerModifyParams.UpdateStdioMcpServer | McpServerModifyParams.UpdateSseMcpServer | McpServerModifyParams.UpdateStreamableHTTPMcpServer;
 export declare namespace McpServerModifyParams {
-    interface LettaSchemasMcpServerUpdateStdioMcpServer {
+    interface UpdateStdioMcpServer {
         /**
          * The arguments to pass to the command
          */
@@ -538,7 +460,7 @@ export declare namespace McpServerModifyParams {
          */
         server_name?: string | null;
     }
-    interface LettaSchemasMcpServerUpdateSsemcpServer {
+    interface UpdateSseMcpServer {
         /**
          * The authentication token (internal)
          */
@@ -566,7 +488,7 @@ export declare namespace McpServerModifyParams {
          */
         server_url?: string | null;
     }
-    interface LettaSchemasMcpServerUpdateStreamableHttpmcpServer {
+    interface UpdateStreamableHTTPMcpServer {
         /**
          * The authentication token (internal)
          */
@@ -595,9 +517,11 @@ export declare namespace McpServerModifyParams {
         server_url?: string | null;
     }
 }
+export interface McpServerRefreshParams {
+    agent_id?: string | null;
+}
 export declare namespace McpServers {
-    export { type McpServerSchema as McpServerSchema, type McpServerCreateResponse as McpServerCreateResponse, type McpServerRetrieveResponse as McpServerRetrieveResponse, type McpServerListResponse as McpServerListResponse, type McpServerConnectResponse as McpServerConnectResponse, type McpServerModifyResponse as McpServerModifyResponse, type McpServerCreateParams as McpServerCreateParams, type McpServerModifyParams as McpServerModifyParams, };
-    export { Tools as Tools, type ToolListResponse as ToolListResponse, type ToolRunResponse as ToolRunResponse, type ToolRetrieveParams as ToolRetrieveParams, type ToolRunParams as ToolRunParams, };
-    export { Refresh as Refresh, type RefreshTriggerResponse as RefreshTriggerResponse, type RefreshTriggerParams as RefreshTriggerParams, };
+    export { type CreateSseMcpServer as CreateSseMcpServer, type CreateStdioMcpServer as CreateStdioMcpServer, type CreateStreamableHTTPMcpServer as CreateStreamableHTTPMcpServer, type McpToolExecuteRequest as McpToolExecuteRequest, type SseMcpServer as SseMcpServer, type StdioMcpServer as StdioMcpServer, type StreamableHTTPMcpServer as StreamableHTTPMcpServer, type ToolExecutionResult as ToolExecutionResult, type UpdateSseMcpServer as UpdateSseMcpServer, type UpdateStdioMcpServer as UpdateStdioMcpServer, type UpdateStreamableHTTPMcpServer as UpdateStreamableHTTPMcpServer, type McpServerCreateResponse as McpServerCreateResponse, type McpServerRetrieveResponse as McpServerRetrieveResponse, type McpServerListResponse as McpServerListResponse, type McpServerConnectResponse as McpServerConnectResponse, type McpServerModifyResponse as McpServerModifyResponse, type McpServerRefreshResponse as McpServerRefreshResponse, type McpServerCreateParams as McpServerCreateParams, type McpServerModifyParams as McpServerModifyParams, type McpServerRefreshParams as McpServerRefreshParams, };
+    export { Tools as Tools, type ToolListResponse as ToolListResponse, type ToolRetrieveParams as ToolRetrieveParams, type ToolRunParams as ToolRunParams, };
 }
 //# sourceMappingURL=mcp-servers.d.ts.map