@letta-ai/letta-client 1.2.0 → 1.3.1

package/src/client.ts

@@ -38,6 +38,16 @@ import {
   AccessTokenListResponse,
   AccessTokens,
 } from './resources/access-tokens';
+import {
+  MessageListParams,
+  MessageListResponse,
+  MessageSearchParams,
+  MessageSearchRequest,
+  MessageSearchResponse,
+  MessageSearchResult,
+  Messages,
+} from './resources/messages';
+import { Passage, PassageSearchParams, PassageSearchResponse, Passages } from './resources/passages';
 import { TagListParams, TagListResponse, Tags } from './resources/tags';
 import {
   NpmRequirement,
@@ -48,6 +58,10 @@ import {
   ToolDeleteResponse,
   ToolListParams,
   ToolReturnMessage,
+  ToolSearchParams,
+  ToolSearchRequest,
+  ToolSearchResponse,
+  ToolSearchResult,
   ToolType,
   ToolUpdateParams,
   ToolUpsertBaseToolsResponse,
@@ -171,11 +185,9 @@ import {
   McpServerUpdateParams,
   McpServerUpdateResponse,
   McpServers,
-  McpToolExecuteRequest,
   SseMcpServer,
   StdioMcpServer,
   StreamableHTTPMcpServer,
-  ToolExecutionResult,
   UpdateSseMcpServer,
   UpdateStdioMcpServer,
   UpdateStreamableHTTPMcpServer,
@@ -956,6 +968,8 @@ export class Letta {
   tags: API.Tags = new API.Tags(this);
   identities: API.Identities = new API.Identities(this);
   groups: API.Groups = new API.Groups(this);
+  messages: API.Messages = new API.Messages(this);
+  passages: API.Passages = new API.Passages(this);
   batches: API.Batches = new API.Batches(this);
   accessTokens: API.AccessTokens = new API.AccessTokens(this);
 }
@@ -973,6 +987,8 @@ Letta.Templates = Templates;
 Letta.Tags = Tags;
 Letta.Identities = Identities;
 Letta.Groups = Groups;
+Letta.Messages = Messages;
+Letta.Passages = Passages;
 Letta.Batches = Batches;
 Letta.AccessTokens = AccessTokens;
 
@@ -1041,13 +1057,17 @@ export declare namespace Letta {
     type Tool as Tool,
     type ToolCreate as ToolCreate,
     type ToolReturnMessage as ToolReturnMessage,
+    type ToolSearchRequest as ToolSearchRequest,
+    type ToolSearchResult as ToolSearchResult,
     type ToolType as ToolType,
     type ToolDeleteResponse as ToolDeleteResponse,
+    type ToolSearchResponse as ToolSearchResponse,
     type ToolUpsertBaseToolsResponse as ToolUpsertBaseToolsResponse,
     type ToolsArrayPage as ToolsArrayPage,
     type ToolCreateParams as ToolCreateParams,
     type ToolUpdateParams as ToolUpdateParams,
     type ToolListParams as ToolListParams,
+    type ToolSearchParams as ToolSearchParams,
     type ToolUpsertParams as ToolUpsertParams,
   };
 
@@ -1099,11 +1119,9 @@ export declare namespace Letta {
     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,
@@ -1165,6 +1183,23 @@ export declare namespace Letta {
     type GroupListParams as GroupListParams,
   };
 
+  export {
+    Messages as Messages,
+    type MessageSearchRequest as MessageSearchRequest,
+    type MessageSearchResult as MessageSearchResult,
+    type MessageListResponse as MessageListResponse,
+    type MessageSearchResponse as MessageSearchResponse,
+    type MessageListParams as MessageListParams,
+    type MessageSearchParams as MessageSearchParams,
+  };
+
+  export {
+    Passages as Passages,
+    type Passage as Passage,
+    type PassageSearchResponse as PassageSearchResponse,
+    type PassageSearchParams as PassageSearchParams,
+  };
+
   export {
     Batches as Batches,
     type BatchJob as BatchJob,

package/src/resources/agents/agents.ts

@@ -107,7 +107,16 @@ import {
   UserMessage,
 } from './messages';
 import * as AgentsToolsAPI from './tools';
-import { ToolAttachParams, ToolDetachParams, ToolListParams, ToolUpdateApprovalParams, Tools } from './tools';
+import {
+  ToolAttachParams,
+  ToolDetachParams,
+  ToolExecuteRequest,
+  ToolExecutionResult,
+  ToolListParams,
+  ToolRunParams,
+  ToolUpdateApprovalParams,
+  Tools,
+} from './tools';
 import * as ArchivesArchivesAPI from '../archives/archives';
 import * as BlocksBlocksAPI from '../blocks/blocks';
 import * as GroupsGroupsAPI from '../groups/groups';
@@ -761,6 +770,11 @@ export interface AnthropicModelSettings {
    */
   provider_type?: 'anthropic';
 
+  /**
+   * The response format for the model.
+   */
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
+
   /**
    * The temperature of the model.
    */
@@ -1663,7 +1677,8 @@ export interface AgentCreateParams {
   reasoning?: boolean | null;
 
   /**
-   * The response format for the agent.
+   * @deprecated Deprecated: Use `model_settings` field to configure response format
+   * instead. The response format for the agent.
    */
   response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
 
@@ -1752,10 +1767,10 @@ export interface AgentRetrieveParams {
   >;
 
   /**
-   * Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
-   * in the response. If not provided, all relationships are loaded by default. Using
-   * this can optimize performance by reducing unnecessary joins.This is a legacy
-   * parameter, and no longer supported after 1.0.0 SDK versions.
+   * @deprecated Specify which relational fields (e.g., 'tools', 'sources', 'memory')
+   * to include in the response. If not provided, all relationships are loaded by
+   * default. Using this can optimize performance by reducing unnecessary joins.This
+   * is a legacy parameter, and no longer supported after 1.0.0 SDK versions.
    */
   include_relationships?: Array<string> | null;
 }
@@ -1915,8 +1930,8 @@ export interface AgentUpdateParams {
   reasoning?: boolean | null;
 
   /**
-   * @deprecated Deprecated: Use `model` field to configure response format instead.
-   * The response format for the agent.
+   * @deprecated Deprecated: Use `model_settings` field to configure response format
+   * instead. The response format for the agent.
    */
   response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
 
@@ -2014,10 +2029,10 @@ export interface AgentListParams extends ArrayPageParams {
   >;
 
   /**
-   * Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
-   * in the response. If not provided, all relationships are loaded by default. Using
-   * this can optimize performance by reducing unnecessary joins.This is a legacy
-   * parameter, and no longer supported after 1.0.0 SDK versions.
+   * @deprecated Specify which relational fields (e.g., 'tools', 'sources', 'memory')
+   * to include in the response. If not provided, all relationships are loaded by
+   * default. Using this can optimize performance by reducing unnecessary joins.This
+   * is a legacy parameter, and no longer supported after 1.0.0 SDK versions.
    */
   include_relationships?: Array<string> | null;
 
@@ -2263,9 +2278,12 @@ export declare namespace Agents {
 
   export {
     Tools as Tools,
+    type ToolExecuteRequest as ToolExecuteRequest,
+    type ToolExecutionResult as ToolExecutionResult,
     type ToolListParams as ToolListParams,
     type ToolAttachParams as ToolAttachParams,
     type ToolDetachParams as ToolDetachParams,
+    type ToolRunParams as ToolRunParams,
     type ToolUpdateApprovalParams as ToolUpdateApprovalParams,
   };
 

package/src/resources/agents/index.ts

@@ -140,8 +140,11 @@ export {
 } from './messages';
 export {
   Tools,
+  type ToolExecuteRequest,
+  type ToolExecutionResult,
   type ToolListParams,
   type ToolAttachParams,
   type ToolDetachParams,
+  type ToolRunParams,
   type ToolUpdateApprovalParams,
 } from './tools';

package/src/resources/agents/tools.ts

@@ -48,6 +48,17 @@ export class Tools extends APIResource {
     return this._client.patch(path`/v1/agents/${agent_id}/tools/detach/${toolID}`, options);
   }
 
+  /**
+   * Trigger a tool by name on a specific agent, providing the necessary arguments.
+   *
+   * This endpoint executes a tool that is attached to the agent, using the agent's
+   * state and environment variables for execution context.
+   */
+  run(toolName: string, params: ToolRunParams, options?: RequestOptions): APIPromise<ToolExecutionResult> {
+    const { agent_id, ...body } = params;
+    return this._client.post(path`/v1/agents/${agent_id}/tools/${toolName}/run`, { body, ...options });
+  }
+
   /**
    * Modify the approval requirement for a tool attached to an agent.
    *
@@ -68,6 +79,50 @@ export class Tools extends APIResource {
   }
 }
 
+/**
+ * Request to execute a tool.
+ */
+export interface ToolExecuteRequest {
+  /**
+   * Arguments to pass to the tool
+   */
+  args?: { [key: string]: unknown };
+}
+
+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;
+}
+
 export interface ToolListParams extends ArrayPageParams {}
 
 export interface ToolAttachParams {
@@ -84,6 +139,18 @@ export interface ToolDetachParams {
   agent_id: string;
 }
 
+export interface ToolRunParams {
+  /**
+   * Path param: The ID of the agent in the format 'agent-<uuid4>'
+   */
+  agent_id: string;
+
+  /**
+   * Body param: Arguments to pass to the tool
+   */
+  args?: { [key: string]: unknown };
+}
+
 export interface ToolUpdateApprovalParams {
   /**
    * Path param: The ID of the agent in the format 'agent-<uuid4>'
@@ -103,9 +170,12 @@ export interface ToolUpdateApprovalParams {
 
 export declare namespace Tools {
   export {
+    type ToolExecuteRequest as ToolExecuteRequest,
+    type ToolExecutionResult as ToolExecutionResult,
     type ToolListParams as ToolListParams,
     type ToolAttachParams as ToolAttachParams,
     type ToolDetachParams as ToolDetachParams,
+    type ToolRunParams as ToolRunParams,
     type ToolUpdateApprovalParams as ToolUpdateApprovalParams,
   };
 }

package/src/resources/archives/archives.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as PassagesAPI from './passages';
-import { PassageCreateParams, PassageCreateResponse, PassageDeleteParams, Passages } from './passages';
+import { PassageCreateParams, PassageDeleteParams, Passages } from './passages';
 import * as ModelsAPI from '../models/models';
 import { APIPromise } from '../../core/api-promise';
 import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
@@ -167,7 +167,6 @@ export declare namespace Archives {
 
   export {
     Passages as Passages,
-    type PassageCreateResponse as PassageCreateResponse,
     type PassageCreateParams as PassageCreateParams,
     type PassageDeleteParams as PassageDeleteParams,
   };

package/src/resources/archives/index.ts

@@ -9,9 +9,4 @@ export {
   type ArchiveListParams,
   type ArchivesArrayPage,
 } from './archives';
-export {
-  Passages,
-  type PassageCreateResponse,
-  type PassageCreateParams,
-  type PassageDeleteParams,
-} from './passages';
+export { Passages, type PassageCreateParams, type PassageDeleteParams } from './passages';

package/src/resources/archives/passages.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as ModelsAPI from '../models/models';
+import * as PassagesAPI from '../passages';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -17,7 +17,7 @@ export class Passages extends APIResource {
     archiveID: string,
     body: PassageCreateParams,
     options?: RequestOptions,
-  ): APIPromise<PassageCreateResponse> {
+  ): APIPromise<PassagesAPI.Passage> {
     return this._client.post(path`/v1/archives/${archiveID}/passages`, { body, ...options });
   }
 
@@ -36,87 +36,6 @@ export class Passages extends APIResource {
   }
 }
 
-/**
- * Representation of a passage, which is stored in archival memory.
- */
-export interface PassageCreateResponse {
-  /**
-   * The embedding of the passage.
-   */
-  embedding: Array<number> | null;
-
-  /**
-   * Configuration for embedding model connection and processing parameters.
-   */
-  embedding_config: ModelsAPI.EmbeddingConfig | null;
-
-  /**
-   * The text of the passage.
-   */
-  text: string;
-
-  /**
-   * The human-friendly ID of the Passage
-   */
-  id?: string;
-
-  /**
-   * The unique identifier of the archive containing this passage.
-   */
-  archive_id?: string | null;
-
-  /**
-   * The creation date of the passage.
-   */
-  created_at?: string;
-
-  /**
-   * The id of the user that made this object.
-   */
-  created_by_id?: string | null;
-
-  /**
-   * The unique identifier of the file associated with the passage.
-   */
-  file_id?: string | null;
-
-  /**
-   * The name of the file (only for source passages).
-   */
-  file_name?: string | null;
-
-  /**
-   * Whether this passage is deleted or not.
-   */
-  is_deleted?: boolean;
-
-  /**
-   * The id of the user that made this object.
-   */
-  last_updated_by_id?: string | null;
-
-  /**
-   * The metadata of the passage.
-   */
-  metadata?: { [key: string]: unknown } | null;
-
-  /**
-   * @deprecated Deprecated: Use `folder_id` field instead. The data source of the
-   * passage.
-   */
-  source_id?: string | null;
-
-  /**
-   * Tags associated with this passage.
-   */
-  tags?: Array<string> | null;
-
-  /**
-   * The timestamp when the object was last updated.
-   */
-  updated_at?: string | null;
-}
-
 export interface PassageCreateParams {
   /**
    * The text content of the passage
@@ -142,9 +61,5 @@ export interface PassageDeleteParams {
 }
 
 export declare namespace Passages {
-  export {
-    type PassageCreateResponse as PassageCreateResponse,
-    type PassageCreateParams as PassageCreateParams,
-    type PassageDeleteParams as PassageDeleteParams,
-  };
+  export { type PassageCreateParams as PassageCreateParams, type PassageDeleteParams as PassageDeleteParams };
 }

package/src/resources/blocks/agents.ts

@@ -40,10 +40,10 @@ export interface AgentListParams extends ArrayPageParams {
   >;
 
   /**
-   * Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
-   * in the response. If not provided, all relationships are loaded by default. Using
-   * this can optimize performance by reducing unnecessary joins.This is a legacy
-   * parameter, and no longer supported after 1.0.0 SDK versions.
+   * @deprecated Specify which relational fields (e.g., 'tools', 'sources', 'memory')
+   * to include in the response. If not provided, all relationships are loaded by
+   * default. Using this can optimize performance by reducing unnecessary joins.This
+   * is a legacy parameter, and no longer supported after 1.0.0 SDK versions.
    */
   include_relationships?: Array<string> | null;
 }

package/src/resources/blocks/blocks.ts

@@ -394,8 +394,8 @@ export interface BlockListParams extends ArrayPageParams {
   connected_to_agents_count_lt?: number | null;
 
   /**
-   * Search blocks by description. If provided, returns blocks that match this
-   * description. This is a full-text search on block descriptions.
+   * Search blocks by description. If provided, returns blocks whose description
+   * matches the search query. This is a full-text search on block descriptions.
    */
   description_search?: string | null;
 
@@ -405,23 +405,23 @@ export interface BlockListParams extends ArrayPageParams {
   identifier_keys?: Array<string> | null;
 
   /**
-   * Search agents by identifier id
+   * The ID of the identity in the format 'identity-<uuid4>'
    */
   identity_id?: string | null;
 
   /**
-   * Labels to include (e.g. human, persona)
+   * Label to include (alphanumeric, hyphens, underscores only)
    */
   label?: string | null;
 
   /**
-   * Search blocks by label. If provided, returns blocks that match this label. This
-   * is a full-text search on labels.
+   * Search blocks by label. If provided, returns blocks whose label matches the
+   * search query. This is a full-text search on block labels.
    */
   label_search?: string | null;
 
   /**
-   * Name of the block
+   * Name filter (alphanumeric, spaces, hyphens, underscores)
    */
   name?: string | null;
 
@@ -436,7 +436,8 @@ export interface BlockListParams extends ArrayPageParams {
   templates_only?: boolean;
 
   /**
-   * Search blocks by value. If provided, returns blocks that match this value.
+   * Search blocks by value. If provided, returns blocks whose value matches the
+   * search query. This is a full-text search on block values.
    */
   value_search?: string | null;
 }

package/src/resources/index.ts

@@ -117,11 +117,9 @@ export {
   type CreateSseMcpServer,
   type CreateStdioMcpServer,
   type CreateStreamableHTTPMcpServer,
-  type McpToolExecuteRequest,
   type SseMcpServer,
   type StdioMcpServer,
   type StreamableHTTPMcpServer,
-  type ToolExecutionResult,
   type UpdateSseMcpServer,
   type UpdateStdioMcpServer,
   type UpdateStreamableHTTPMcpServer,
@@ -134,6 +132,15 @@ export {
   type McpServerUpdateParams,
   type McpServerRefreshParams,
 } from './mcp-servers/mcp-servers';
+export {
+  Messages,
+  type MessageSearchRequest,
+  type MessageSearchResult,
+  type MessageListResponse,
+  type MessageSearchResponse,
+  type MessageListParams,
+  type MessageSearchParams,
+} from './messages';
 export {
   Models,
   type EmbeddingConfig,
@@ -145,6 +152,7 @@ export {
   type ModelListResponse,
   type ModelListParams,
 } from './models/models';
+export { Passages, type Passage, type PassageSearchResponse, type PassageSearchParams } from './passages';
 export { Runs, type Job, type StopReasonType, type RunListParams } from './runs/runs';
 export {
   Steps,
@@ -162,12 +170,16 @@ export {
   type Tool,
   type ToolCreate,
   type ToolReturnMessage,
+  type ToolSearchRequest,
+  type ToolSearchResult,
   type ToolType,
   type ToolDeleteResponse,
+  type ToolSearchResponse,
   type ToolUpsertBaseToolsResponse,
   type ToolCreateParams,
   type ToolUpdateParams,
   type ToolListParams,
+  type ToolSearchParams,
   type ToolUpsertParams,
   type ToolsArrayPage,
 } from './tools';

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

@@ -5,11 +5,9 @@ export {
   type CreateSseMcpServer,
   type CreateStdioMcpServer,
   type CreateStreamableHTTPMcpServer,
-  type McpToolExecuteRequest,
   type SseMcpServer,
   type StdioMcpServer,
   type StreamableHTTPMcpServer,
-  type ToolExecutionResult,
   type UpdateSseMcpServer,
   type UpdateStdioMcpServer,
   type UpdateStreamableHTTPMcpServer,

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

@@ -1,7 +1,6 @@
 // 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';
@@ -153,16 +152,6 @@ export interface CreateStreamableHTTPMcpServer {
   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
  */
@@ -269,40 +258,6 @@ export interface StreamableHTTPMcpServer {
   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
  */
@@ -433,11 +388,9 @@ export declare namespace McpServers {
     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,