@letta-ai/letta-client 1.2.0 → 1.3.2

package/resources/tools.js

@@ -37,16 +37,21 @@ class Tools extends resource_1.APIResource {
         return this._client.delete((0, path_1.path) `/v1/tools/${toolID}`, options);
     }
     /**
-     * Create or update a tool
+     * Search tools using semantic search.
+     *
+     * Requires tool embedding to be enabled (embed_tools=True). Uses vector search,
+     * full-text search, or hybrid mode to find tools matching the query.
+     *
+     * Returns tools ranked by relevance with their search scores.
      */
-    upsert(body, options) {
-        return this._client.put('/v1/tools/', { body, ...options });
+    search(body, options) {
+        return this._client.post('/v1/tools/search', { body, ...options });
     }
     /**
-     * Upsert base tools
+     * Create or update a tool
      */
-    upsertBaseTools(options) {
-        return this._client.post('/v1/tools/add-base-tools', options);
+    upsert(body, options) {
+        return this._client.put('/v1/tools/', { body, ...options });
     }
 }
 exports.Tools = Tools;

package/resources/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/resources/tools.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,sDAAkF;AAElF,oDAA8C;AAE9C,MAAa,KAAM,SAAQ,sBAAW;IACpC;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAA,sBAAe,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAwB;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF;AApDD,sBAoDC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/resources/tools.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,sDAAkF;AAElF,oDAA8C;AAE9C,MAAa,KAAM,SAAQ,sBAAW;IACpC;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAA,sBAAe,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AAzDD,sBAyDC"}

package/resources/tools.mjs

@@ -34,16 +34,21 @@ export class Tools extends APIResource {
         return this._client.delete(path `/v1/tools/${toolID}`, options);
     }
     /**
-     * Create or update a tool
+     * Search tools using semantic search.
+     *
+     * Requires tool embedding to be enabled (embed_tools=True). Uses vector search,
+     * full-text search, or hybrid mode to find tools matching the query.
+     *
+     * Returns tools ranked by relevance with their search scores.
      */
-    upsert(body, options) {
-        return this._client.put('/v1/tools/', { body, ...options });
+    search(body, options) {
+        return this._client.post('/v1/tools/search', { body, ...options });
     }
     /**
-     * Upsert base tools
+     * Create or update a tool
      */
-    upsertBaseTools(options) {
-        return this._client.post('/v1/tools/add-base-tools', options);
+    upsert(body, options) {
+        return this._client.put('/v1/tools/', { body, ...options });
     }
 }
 //# sourceMappingURL=tools.mjs.map

package/resources/tools.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tools.mjs","sourceRoot":"","sources":["../src/resources/tools.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,SAAS,EAAqC;OAEhD,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,aAAa,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAA,SAAe,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAwB;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF"}
+{"version":3,"file":"tools.mjs","sourceRoot":"","sources":["../src/resources/tools.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,SAAS,EAAqC;OAEhD,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,aAAa,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAA,SAAe,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF"}

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,9 +58,12 @@ import {
   ToolDeleteResponse,
   ToolListParams,
   ToolReturnMessage,
+  ToolSearchParams,
+  ToolSearchRequest,
+  ToolSearchResponse,
+  ToolSearchResult,
   ToolType,
   ToolUpdateParams,
-  ToolUpsertBaseToolsResponse,
   ToolUpsertParams,
   Tools,
   ToolsArrayPage,
@@ -171,11 +184,9 @@ import {
   McpServerUpdateParams,
   McpServerUpdateResponse,
   McpServers,
-  McpToolExecuteRequest,
   SseMcpServer,
   StdioMcpServer,
   StreamableHTTPMcpServer,
-  ToolExecutionResult,
   UpdateSseMcpServer,
   UpdateStdioMcpServer,
   UpdateStreamableHTTPMcpServer,
@@ -193,7 +204,15 @@ import {
 } from './resources/models/models';
 import { Job, RunListParams, Runs, StopReasonType } from './resources/runs/runs';
 import { ProviderTrace, Step, StepListParams, Steps, StepsArrayPage } from './resources/steps/steps';
-import { Templates } from './resources/templates/templates';
+import {
+  TemplateCreateParams,
+  TemplateCreateResponse,
+  TemplateDeleteParams,
+  TemplateDeleteResponse,
+  TemplateUpdateParams,
+  TemplateUpdateResponse,
+  Templates,
+} from './resources/templates/templates';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -315,7 +334,7 @@ export class Letta {
   baseURL: string;
   maxRetries: number;
   timeout: number;
-  logger: Logger | undefined;
+  logger: Logger;
   logLevel: LogLevel | undefined;
   fetchOptions: MergedRequestInit | undefined;
 
@@ -956,6 +975,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 +994,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 +1064,16 @@ 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 ToolUpsertBaseToolsResponse as ToolUpsertBaseToolsResponse,
+    type ToolSearchResponse as ToolSearchResponse,
     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 +1125,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,
@@ -1132,7 +1156,15 @@ export declare namespace Letta {
     type StepListParams as StepListParams,
   };
 
-  export { Templates as Templates };
+  export {
+    Templates as Templates,
+    type TemplateCreateResponse as TemplateCreateResponse,
+    type TemplateUpdateResponse as TemplateUpdateResponse,
+    type TemplateDeleteResponse as TemplateDeleteResponse,
+    type TemplateCreateParams as TemplateCreateParams,
+    type TemplateUpdateParams as TemplateUpdateParams,
+    type TemplateDeleteParams as TemplateDeleteParams,
+  };
 
   export { Tags as Tags, type TagListResponse as TagListResponse, type TagListParams as TagListParams };
 
@@ -1165,6 +1197,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/messages.ts

@@ -925,6 +925,17 @@ export namespace LettaResponse {
    * The usage statistics of the agent.
    */
   export interface Usage {
+    /**
+     * The number of input tokens written to cache (Anthropic only). None if not
+     * reported by provider.
+     */
+    cache_write_tokens?: number | null;
+
+    /**
+     * The number of input tokens served from cache. None if not reported by provider.
+     */
+    cached_input_tokens?: number | null;
+
     /**
      * The number of tokens generated by the agent.
      */
@@ -937,6 +948,12 @@ export namespace LettaResponse {
      */
     prompt_tokens?: number;
 
+    /**
+     * The number of reasoning/thinking tokens generated. None if not reported by
+     * provider.
+     */
+    reasoning_tokens?: number | null;
+
     /**
      * The background task run IDs associated with the agent interaction
      */
@@ -1164,9 +1181,24 @@ export namespace LettaStreamingResponse {
    * Attributes: completion_tokens (int): The number of tokens generated by the
    * agent. prompt_tokens (int): The number of tokens in the prompt. total_tokens
    * (int): The total number of tokens processed by the agent. step_count (int): The
-   * number of steps taken by the agent.
+   * number of steps taken by the agent. cached_input_tokens (Optional[int]): The
+   * number of input tokens served from cache. None if not reported.
+   * cache_write_tokens (Optional[int]): The number of input tokens written to cache.
+   * None if not reported. reasoning_tokens (Optional[int]): The number of
+   * reasoning/thinking tokens generated. None if not reported.
    */
   export interface LettaUsageStatistics {
+    /**
+     * The number of input tokens written to cache (Anthropic only). None if not
+     * reported by provider.
+     */
+    cache_write_tokens?: number | null;
+
+    /**
+     * The number of input tokens served from cache. None if not reported by provider.
+     */
+    cached_input_tokens?: number | null;
+
     /**
      * The number of tokens generated by the agent.
      */
@@ -1179,6 +1211,12 @@ export namespace LettaStreamingResponse {
      */
     prompt_tokens?: number;
 
+    /**
+     * The number of reasoning/thinking tokens generated. None if not reported by
+     * provider.
+     */
+    reasoning_tokens?: number | null;
+
     /**
      * The background task run IDs associated with the agent interaction
      */

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';
+
+  /**
+   * @deprecated 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;
 }