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

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

@@ -1,10 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as RefreshAPI from './refresh';
-import { Refresh, RefreshTriggerParams, RefreshTriggerResponse } from './refresh';
+import * as AgentsAPI from '../agents/agents';
 import * as ToolsAPI from './tools';
-import { ToolListResponse, ToolRetrieveParams, ToolRunParams, ToolRunResponse, Tools } from './tools';
+import { ToolListResponse, ToolRetrieveParams, ToolRunParams, Tools } from './tools';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -12,7 +11,6 @@ import { path } from '../../internal/utils/path';
 
 export class McpServers extends APIResource {
   tools: ToolsAPI.Tools = new ToolsAPI.Tools(this._client);
-  refresh: RefreshAPI.Refresh = new RefreshAPI.Refresh(this._client);
 
   /**
    * Add a new MCP server to the Letta MCP server config
@@ -63,496 +61,391 @@ export class McpServers extends APIResource {
   ): APIPromise<McpServerModifyResponse> {
     return this._client.patch(path`/v1/mcp-servers/${mcpServerID}`, { body, ...options });
   }
+
+  /**
+   * 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> {
+    const { agent_id } = params ?? {};
+    return this._client.patch(path`/v1/mcp-servers/${mcpServerID}/refresh`, {
+      query: { agent_id },
+      ...options,
+    });
+  }
 }
 
 /**
- * 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;
+  /**
+   * The URL of the server
+   */
+  server_url: string;
 
-  metadata_?: { [key: string]: unknown } | null;
+  /**
+   * The name of the authentication header (e.g., 'Authorization')
+   */
+  auth_header?: string | null;
 
-  server_url?: string | null;
+  /**
+   * The authentication token or API key value
+   */
+  auth_token?: string | null;
 
-  stdio_config?: { [key: string]: unknown } | null;
+  /**
+   * Custom HTTP headers to include with requests
+   */
+  custom_headers?: { [key: string]: string } | null;
+
+  type?: 'sse' | 'stdio' | 'streamable_http';
 }
 
 /**
- * A Stdio MCP server
+ * Create a new Stdio MCP server
  */
-export type McpServerCreateResponse =
-  | McpServerCreateResponse.StdioMcpServer
-  | McpServerCreateResponse.SsemcpServer
-  | McpServerCreateResponse.StreamableHttpmcpServer;
-
-export namespace McpServerCreateResponse {
+export interface CreateStdioMcpServer {
   /**
-   * A Stdio MCP server
+   * The arguments to pass to the command
    */
-  export interface StdioMcpServer {
-    /**
-     * The arguments to pass to the command
-     */
-    args: Array<string>;
+  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 command to run (MCP 'local' client will run this command)
+   */
+  command: string;
 
-    /**
-     * The human-friendly ID of the Mcp_server
-     */
-    id?: string;
+  /**
+   * The name of the server
+   */
+  server_name: string;
 
-    /**
-     * Environment variables to set
-     */
-    env?: { [key: string]: string } | null;
+  /**
+   * Environment variables to set
+   */
+  env?: { [key: string]: string } | null;
 
-    type?: 'sse' | 'stdio' | 'streamable_http';
-  }
+  type?: 'sse' | 'stdio' | 'streamable_http';
+}
 
+/**
+ * Create a new Streamable HTTP MCP server
+ */
+export interface CreateStreamableHTTPMcpServer {
   /**
-   * An SSE MCP server
+   * The name of the server
    */
-  export interface SsemcpServer {
-    /**
-     * The name of the server
-     */
-    server_name: string;
+  server_name: string;
 
-    /**
-     * The URL of the server
-     */
-    server_url: 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 name of the authentication header (e.g., 'Authorization')
-     */
-    auth_header?: string | null;
+  /**
+   * The authentication token or API key value
+   */
+  auth_token?: 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;
 
-    /**
-     * Custom HTTP headers to include with requests
-     */
-    custom_headers?: { [key: string]: string } | null;
+  type?: 'sse' | 'stdio' | 'streamable_http';
+}
 
-    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 {
   /**
-   * A Streamable HTTP MCP server
+   * The name of the server
    */
-  export interface StreamableHttpmcpServer {
-    /**
-     * The name of the server
-     */
-    server_name: string;
+  server_name: string;
 
-    /**
-     * The URL of the server
-     */
-    server_url: string;
+  /**
+   * The URL of the server
+   */
+  server_url: string;
 
-    /**
-     * The human-friendly ID of the Mcp_server
-     */
-    id?: 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 name of the authentication header (e.g., 'Authorization')
+   */
+  auth_header?: string | null;
 
-    /**
-     * The authentication token or API key value
-     */
-    auth_token?: 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;
+  /**
+   * Custom HTTP headers to include with requests
+   */
+  custom_headers?: { [key: string]: string } | null;
 
-    type?: 'sse' | 'stdio' | 'streamable_http';
-  }
+  type?: 'sse' | 'stdio' | 'streamable_http';
 }
 
 /**
  * A Stdio MCP server
  */
-export type McpServerRetrieveResponse =
-  | McpServerRetrieveResponse.StdioMcpServer
-  | McpServerRetrieveResponse.SsemcpServer
-  | McpServerRetrieveResponse.StreamableHttpmcpServer;
-
-export namespace McpServerRetrieveResponse {
+export interface StdioMcpServer {
   /**
-   * A Stdio MCP server
+   * The arguments to pass to the command
    */
-  export 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)
    */
-  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';
-  }
+  command: string;
 
   /**
-   * A Streamable HTTP MCP server
+   * The name of the server
    */
-  export 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;
+  server_name: string;
 
-    /**
-     * The authentication token or API key value
-     */
-    auth_token?: string | null;
+  /**
+   * The human-friendly ID of the Mcp_server
+   */
+  id?: string;
 
-    /**
-     * Custom HTTP headers to include with requests
-     */
-    custom_headers?: { [key: string]: string } | null;
+  /**
+   * Environment variables to set
+   */
+  env?: { [key: string]: string } | null;
 
-    type?: 'sse' | 'stdio' | 'streamable_http';
-  }
+  type?: 'sse' | 'stdio' | 'streamable_http';
 }
 
-export type McpServerListResponse = Array<
-  | McpServerListResponse.StdioMcpServer
-  | McpServerListResponse.SsemcpServer
-  | McpServerListResponse.StreamableHttpmcpServer
->;
-
-export namespace McpServerListResponse {
+/**
+ * A Streamable HTTP MCP server
+ */
+export interface StreamableHTTPMcpServer {
   /**
-   * A Stdio MCP server
+   * The name of the server
    */
-  export 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;
+  server_name: string;
 
-    /**
-     * 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 human-friendly ID of the Mcp_server
+   */
+  id?: string;
 
-    /**
-     * Environment variables to set
-     */
-    env?: { [key: string]: string } | null;
+  /**
+   * The name of the authentication header (e.g., 'Authorization')
+   */
+  auth_header?: string | null;
 
-    type?: 'sse' | 'stdio' | 'streamable_http';
-  }
+  /**
+   * The authentication token or API key value
+   */
+  auth_token?: string | null;
 
   /**
-   * An SSE MCP server
+   * Custom HTTP headers to include with requests
    */
-  export interface SsemcpServer {
-    /**
-     * The name of the server
-     */
-    server_name: string;
+  custom_headers?: { [key: string]: string } | null;
 
-    /**
-     * The URL of the server
-     */
-    server_url: string;
+  type?: 'sse' | 'stdio' | 'streamable_http';
+}
 
-    /**
-     * The human-friendly ID of the Mcp_server
-     */
-    id?: string;
+export interface ToolExecutionResult {
+  /**
+   * The status of the tool execution and return object
+   */
+  status: 'success' | 'error';
 
-    /**
-     * The name of the authentication header (e.g., 'Authorization')
-     */
-    auth_header?: string | null;
+  /**
+   * 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.
+   */
+  agent_state?: AgentsAPI.AgentState | null;
 
-    /**
-     * The authentication token or API key value
-     */
-    auth_token?: string | null;
+  /**
+   * The function return object
+   */
+  func_return?: unknown;
 
-    /**
-     * Custom HTTP headers to include with requests
-     */
-    custom_headers?: { [key: string]: string } | null;
+  /**
+   * The fingerprint of the config for the sandbox
+   */
+  sandbox_config_fingerprint?: string | null;
 
-    type?: 'sse' | 'stdio' | 'streamable_http';
-  }
+  /**
+   * Captured stderr from the function invocation
+   */
+  stderr?: Array<string> | null;
 
   /**
-   * A Streamable HTTP MCP server
+   * Captured stdout (prints, logs) from function invocation
    */
-  export interface StreamableHttpmcpServer {
-    /**
-     * The name of the server
-     */
-    server_name: string;
+  stdout?: Array<string> | null;
+}
 
-    /**
-     * The URL of the server
-     */
-    server_url: string;
+/**
+ * Update schema for SSE MCP server - all fields optional
+ */
+export interface UpdateSseMcpServer {
+  /**
+   * The authentication token (internal)
+   */
+  token?: string | null;
 
-    /**
-     * The human-friendly ID of the Mcp_server
-     */
-    id?: string;
+  /**
+   * The name of the authentication header (e.g., 'Authorization')
+   */
+  auth_header?: 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;
 
-    /**
-     * The authentication token or API key value
-     */
-    auth_token?: string | null;
+  /**
+   * Custom headers to send with requests
+   */
+  custom_headers?: { [key: string]: string } | null;
 
-    /**
-     * Custom HTTP headers to include with requests
-     */
-    custom_headers?: { [key: string]: string } | null;
+  /**
+   * The name of the MCP server
+   */
+  server_name?: string | null;
 
-    type?: 'sse' | 'stdio' | 'streamable_http';
-  }
+  /**
+   * The URL of the SSE MCP server
+   */
+  server_url?: string | null;
 }
 
-export type McpServerConnectResponse = unknown;
-
 /**
- * A Stdio MCP server
+ * Update schema for Stdio MCP server - all fields optional
  */
-export type McpServerModifyResponse =
-  | McpServerModifyResponse.StdioMcpServer
-  | McpServerModifyResponse.SsemcpServer
-  | McpServerModifyResponse.StreamableHttpmcpServer;
-
-export namespace McpServerModifyResponse {
+export interface UpdateStdioMcpServer {
   /**
-   * A Stdio MCP server
+   * The arguments to pass to the command
    */
-  export 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;
+  args?: Array<string> | null;
 
-    /**
-     * 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';
-  }
+  /**
+   * The command to run the MCP server
+   */
+  command?: string | null;
 
   /**
-   * An SSE MCP server
+   * Environment variables to set
    */
-  export interface SsemcpServer {
-    /**
-     * The name of the server
-     */
-    server_name: string;
+  env?: { [key: string]: string } | null;
 
-    /**
-     * The URL of the server
-     */
-    server_url: string;
+  /**
+   * The name of the MCP server
+   */
+  server_name?: string | null;
+}
 
-    /**
-     * The human-friendly ID of the Mcp_server
-     */
-    id?: string;
+/**
+ * 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 name of the authentication header (e.g., 'Authorization')
+   */
+  auth_header?: string | null;
 
-    /**
-     * The authentication token or API key value
-     */
-    auth_token?: 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;
+  /**
+   * Custom headers to send with requests
+   */
+  custom_headers?: { [key: string]: string } | null;
 
-    type?: 'sse' | 'stdio' | 'streamable_http';
-  }
+  /**
+   * The name of the MCP server
+   */
+  server_name?: string | null;
 
   /**
-   * A Streamable HTTP MCP server
+   * The URL of the Streamable HTTP MCP server
    */
-  export interface StreamableHttpmcpServer {
-    /**
-     * The name of the server
-     */
-    server_name: string;
+  server_url?: string | null;
+}
 
-    /**
-     * The URL of the server
-     */
-    server_url: string;
+/**
+ * A Stdio MCP server
+ */
+export type McpServerCreateResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
 
-    /**
-     * The human-friendly ID of the Mcp_server
-     */
-    id?: string;
+/**
+ * A Stdio MCP server
+ */
+export type McpServerRetrieveResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
 
-    /**
-     * The name of the authentication header (e.g., 'Authorization')
-     */
-    auth_header?: string | null;
+export type McpServerListResponse = Array<StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer>;
 
-    /**
-     * The authentication token or API key value
-     */
-    auth_token?: string | null;
+export type McpServerConnectResponse = unknown;
 
-    /**
-     * Custom HTTP headers to include with requests
-     */
-    custom_headers?: { [key: string]: string } | null;
+/**
+ * A Stdio MCP server
+ */
+export type McpServerModifyResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
 
-    type?: 'sse' | 'stdio' | 'streamable_http';
-  }
-}
+export type McpServerRefreshResponse = unknown;
 
 export type McpServerCreateParams =
   | McpServerCreateParams.CreateStdioMcpServer
-  | McpServerCreateParams.CreateSsemcpServer
-  | McpServerCreateParams.CreateStreamableHttpmcpServer;
+  | McpServerCreateParams.CreateSseMcpServer
+  | McpServerCreateParams.CreateStreamableHTTPMcpServer;
 
 export declare namespace McpServerCreateParams {
   export interface CreateStdioMcpServer {
@@ -579,7 +472,7 @@ export declare namespace McpServerCreateParams {
     type?: 'sse' | 'stdio' | 'streamable_http';
   }
 
-  export interface CreateSsemcpServer {
+  export interface CreateSseMcpServer {
     /**
      * The name of the server
      */
@@ -608,7 +501,7 @@ export declare namespace McpServerCreateParams {
     type?: 'sse' | 'stdio' | 'streamable_http';
   }
 
-  export interface CreateStreamableHttpmcpServer {
+  export interface CreateStreamableHTTPMcpServer {
     /**
      * The name of the server
      */
@@ -639,12 +532,12 @@ export declare namespace McpServerCreateParams {
 }
 
 export type McpServerModifyParams =
-  | McpServerModifyParams.LettaSchemasMcpServerUpdateStdioMcpServer
-  | McpServerModifyParams.LettaSchemasMcpServerUpdateSsemcpServer
-  | McpServerModifyParams.LettaSchemasMcpServerUpdateStreamableHttpmcpServer;
+  | McpServerModifyParams.UpdateStdioMcpServer
+  | McpServerModifyParams.UpdateSseMcpServer
+  | McpServerModifyParams.UpdateStreamableHTTPMcpServer;
 
 export declare namespace McpServerModifyParams {
-  export interface LettaSchemasMcpServerUpdateStdioMcpServer {
+  export interface UpdateStdioMcpServer {
     /**
      * The arguments to pass to the command
      */
@@ -666,7 +559,7 @@ export declare namespace McpServerModifyParams {
     server_name?: string | null;
   }
 
-  export interface LettaSchemasMcpServerUpdateSsemcpServer {
+  export interface UpdateSseMcpServer {
     /**
      * The authentication token (internal)
      */
@@ -698,7 +591,7 @@ export declare namespace McpServerModifyParams {
     server_url?: string | null;
   }
 
-  export interface LettaSchemasMcpServerUpdateStreamableHttpmcpServer {
+  export interface UpdateStreamableHTTPMcpServer {
     /**
      * The authentication token (internal)
      */
@@ -731,32 +624,40 @@ export declare namespace McpServerModifyParams {
   }
 }
 
+export interface McpServerRefreshParams {
+  agent_id?: string | null;
+}
+
 McpServers.Tools = Tools;
-McpServers.Refresh = Refresh;
 
 export declare namespace McpServers {
   export {
-    type McpServerSchema as McpServerSchema,
+    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 ToolRunResponse as ToolRunResponse,
     type ToolRetrieveParams as ToolRetrieveParams,
     type ToolRunParams as ToolRunParams,
   };
-
-  export {
-    Refresh as Refresh,
-    type RefreshTriggerResponse as RefreshTriggerResponse,
-    type RefreshTriggerParams as RefreshTriggerParams,
-  };
 }