@letta-ai/letta-client 1.0.0-alpha.7 → 1.1.0

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

@@ -0,0 +1,460 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AgentsAPI from '../agents/agents';
+import * as ToolsAPI 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';
+import { path } from '../../internal/utils/path';
+
+export class McpServers extends APIResource {
+  tools: ToolsAPI.Tools = new ToolsAPI.Tools(this._client);
+
+  /**
+   * Add a new MCP server to the Letta MCP server config
+   */
+  create(body: McpServerCreateParams, options?: RequestOptions): APIPromise<McpServerCreateResponse> {
+    return this._client.post('/v1/mcp-servers/', { body, ...options });
+  }
+
+  /**
+   * Get a specific MCP server
+   */
+  retrieve(mcpServerID: string, options?: RequestOptions): APIPromise<McpServerRetrieveResponse> {
+    return this._client.get(path`/v1/mcp-servers/${mcpServerID}`, options);
+  }
+
+  /**
+   * Update an existing MCP server configuration
+   */
+  update(
+    mcpServerID: string,
+    body: McpServerUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<McpServerUpdateResponse> {
+    return this._client.patch(path`/v1/mcp-servers/${mcpServerID}`, { body, ...options });
+  }
+
+  /**
+   * Get a list of all configured MCP servers
+   */
+  list(options?: RequestOptions): APIPromise<McpServerListResponse> {
+    return this._client.get('/v1/mcp-servers/', options);
+  }
+
+  /**
+   * Delete an MCP server by its ID
+   */
+  delete(mcpServerID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/v1/mcp-servers/${mcpServerID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * 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,
+    });
+  }
+}
+
+/**
+ * Create a new SSE MCP server
+ */
+export interface CreateSseMcpServer {
+  /**
+   * 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;
+
+  mcp_server_type?: 'sse';
+}
+
+/**
+ * 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;
+
+  /**
+   * Environment variables to set
+   */
+  env?: { [key: string]: string } | null;
+
+  mcp_server_type?: 'stdio';
+}
+
+/**
+ * Create a new Streamable HTTP MCP server
+ */
+export interface CreateStreamableHTTPMcpServer {
+  /**
+   * 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;
+
+  mcp_server_type?: '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 MCP 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;
+
+  mcp_server_type?: 'sse';
+}
+
+/**
+ * A Stdio MCP 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;
+
+  /**
+   * The name of the MCP server
+   */
+  server_name: string;
+
+  /**
+   * The human-friendly ID of the Mcp_server
+   */
+  id?: string;
+
+  /**
+   * Environment variables to set
+   */
+  env?: { [key: string]: string } | null;
+
+  mcp_server_type?: 'stdio';
+}
+
+/**
+ * A Streamable HTTP MCP server
+ */
+export interface StreamableHTTPMcpServer {
+  /**
+   * The name of the MCP 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;
+
+  mcp_server_type?: 'streamable_http';
+}
+
+export interface ToolExecutionResult {
+  /**
+   * The status of the tool execution and return object
+   */
+  status: 'success' | 'error';
+
+  /**
+   * 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 function return object
+   */
+  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;
+}
+
+/**
+ * Update schema for SSE MCP server - all fields optional
+ */
+export interface UpdateSseMcpServer {
+  /**
+   * The URL of the server
+   */
+  server_url: 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 HTTP headers to include with requests
+   */
+  custom_headers?: { [key: string]: string } | null;
+
+  mcp_server_type?: 'sse';
+}
+
+/**
+ * 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 (MCP 'local' client will run this command)
+   */
+  command: string | null;
+
+  /**
+   * Environment variables to set
+   */
+  env?: { [key: string]: string } | null;
+
+  mcp_server_type?: 'stdio';
+}
+
+/**
+ * Update schema for Streamable HTTP MCP server - all fields optional
+ */
+export interface UpdateStreamableHTTPMcpServer {
+  /**
+   * The URL of the server
+   */
+  server_url: 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 HTTP headers to include with requests
+   */
+  custom_headers?: { [key: string]: string } | null;
+
+  mcp_server_type?: 'streamable_http';
+}
+
+/**
+ * A Stdio MCP server
+ */
+export type McpServerCreateResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
+
+/**
+ * A Stdio MCP server
+ */
+export type McpServerRetrieveResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
+
+/**
+ * A Stdio MCP server
+ */
+export type McpServerUpdateResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
+
+export type McpServerListResponse = Array<StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer>;
+
+export type McpServerRefreshResponse = unknown;
+
+export interface McpServerCreateParams {
+  /**
+   * The MCP server configuration (Stdio, SSE, or Streamable HTTP)
+   */
+  config: CreateStdioMcpServer | CreateSseMcpServer | CreateStreamableHTTPMcpServer;
+
+  /**
+   * The name of the MCP server
+   */
+  server_name: string;
+}
+
+export interface McpServerUpdateParams {
+  /**
+   * The MCP server configuration updates (Stdio, SSE, or Streamable HTTP)
+   */
+  config: UpdateStdioMcpServer | UpdateSseMcpServer | UpdateStreamableHTTPMcpServer;
+
+  /**
+   * The name of the MCP server
+   */
+  server_name?: string | null;
+}
+
+export interface McpServerRefreshParams {
+  agent_id?: string | null;
+}
+
+McpServers.Tools = Tools;
+
+export declare namespace McpServers {
+  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 McpServerUpdateResponse as McpServerUpdateResponse,
+    type McpServerListResponse as McpServerListResponse,
+    type McpServerRefreshResponse as McpServerRefreshResponse,
+    type McpServerCreateParams as McpServerCreateParams,
+    type McpServerUpdateParams as McpServerUpdateParams,
+    type McpServerRefreshParams as McpServerRefreshParams,
+  };
+
+  export {
+    Tools as Tools,
+    type ToolListResponse as ToolListResponse,
+    type ToolRetrieveParams as ToolRetrieveParams,
+    type ToolRunParams as ToolRunParams,
+  };
+}

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

@@ -0,0 +1,69 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ToolsAPI from '../tools';
+import * as McpServersAPI from './mcp-servers';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Tools extends APIResource {
+  /**
+   * Get a specific MCP tool by its ID
+   */
+  retrieve(toolID: string, params: ToolRetrieveParams, options?: RequestOptions): APIPromise<ToolsAPI.Tool> {
+    const { mcp_server_id } = params;
+    return this._client.get(path`/v1/mcp-servers/${mcp_server_id}/tools/${toolID}`, options);
+  }
+
+  /**
+   * Get a list of all tools for a specific MCP server
+   */
+  list(mcpServerID: string, options?: RequestOptions): APIPromise<ToolListResponse> {
+    return this._client.get(path`/v1/mcp-servers/${mcpServerID}/tools`, options);
+  }
+
+  /**
+   * Execute a specific MCP tool
+   *
+   * The request body should contain the tool arguments in the MCPToolExecuteRequest
+   * format.
+   */
+  run(
+    toolID: string,
+    params: ToolRunParams,
+    options?: RequestOptions,
+  ): APIPromise<McpServersAPI.ToolExecutionResult> {
+    const { mcp_server_id, ...body } = params;
+    return this._client.post(path`/v1/mcp-servers/${mcp_server_id}/tools/${toolID}/run`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export type ToolListResponse = Array<ToolsAPI.Tool>;
+
+export interface ToolRetrieveParams {
+  mcp_server_id: string;
+}
+
+export interface ToolRunParams {
+  /**
+   * Path param:
+   */
+  mcp_server_id: string;
+
+  /**
+   * Body param: Arguments to pass to the MCP tool
+   */
+  args?: { [key: string]: unknown };
+}
+
+export declare namespace Tools {
+  export {
+    type ToolListResponse as ToolListResponse,
+    type ToolRetrieveParams as ToolRetrieveParams,
+    type ToolRunParams as ToolRunParams,
+  };
+}

package/src/resources/mcp-servers.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './mcp-servers/index';

package/src/resources/models/embeddings.ts

@@ -8,14 +8,18 @@ import { RequestOptions } from '../../internal/request-options';
 export class Embeddings extends APIResource {
   /**
    * List available embedding models using the asynchronous implementation for
-   * improved performance
+   * improved performance.
+   *
+   * Returns EmbeddingModel format which extends EmbeddingConfig with additional
+   * metadata fields. Legacy EmbeddingConfig fields are marked as deprecated but
+   * still available for backward compatibility.
    */
   list(options?: RequestOptions): APIPromise<EmbeddingListResponse> {
     return this._client.get('/v1/models/embedding', options);
   }
 }
 
-export type EmbeddingListResponse = Array<ModelsAPI.EmbeddingConfig>;
+export type EmbeddingListResponse = Array<ModelsAPI.EmbeddingModel>;
 
 export declare namespace Embeddings {
   export { type EmbeddingListResponse as EmbeddingListResponse };

package/src/resources/models/index.ts

@@ -4,7 +4,9 @@ export { Embeddings, type EmbeddingListResponse } from './embeddings';
 export {
   Models,
   type EmbeddingConfig,
+  type EmbeddingModel,
   type LlmConfig,
+  type Model,
   type ProviderCategory,
   type ProviderType,
   type ModelListResponse,