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

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

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as ToolsAPI from '../tools';
-import * as AgentsAPI from '../agents/agents';
+import * as McpServersAPI from './mcp-servers';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -29,7 +29,11 @@ export class Tools extends APIResource {
    * The request body should contain the tool arguments in the MCPToolExecuteRequest
    * format.
    */
-  run(toolID: string, params: ToolRunParams, options?: RequestOptions): APIPromise<ToolRunResponse> {
+  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,
@@ -40,50 +44,6 @@ export class Tools extends APIResource {
 
 export type ToolListResponse = Array<ToolsAPI.Tool>;
 
-export interface ToolRunResponse {
-  /**
-   * 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.
-   *
-   * 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.
-   */
-  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 ToolRetrieveParams {
   mcp_server_id: string;
 }
@@ -103,7 +63,6 @@ export interface ToolRunParams {
 export declare namespace Tools {
   export {
     type ToolListResponse as ToolListResponse,
-    type ToolRunResponse as ToolRunResponse,
     type ToolRetrieveParams as ToolRetrieveParams,
     type ToolRunParams as ToolRunParams,
   };

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,

package/src/resources/models/models.ts

@@ -11,7 +11,11 @@ export class Models extends APIResource {
 
   /**
    * List available LLM models using the asynchronous implementation for improved
-   * performance
+   * performance.
+   *
+   * Returns Model format which extends LLMConfig with additional metadata fields.
+   * Legacy LLMConfig fields are marked as deprecated but still available for
+   * backward compatibility.
    */
   list(
     query: ModelListParams | null | undefined = {},
@@ -95,6 +99,103 @@ export interface EmbeddingConfig {
   handle?: string | null;
 }
 
+export interface EmbeddingModel {
+  /**
+   * Display name for the model shown in UI
+   */
+  display_name: string;
+
+  /**
+   * The dimension of the embedding
+   */
+  embedding_dim: number;
+
+  /**
+   * @deprecated Deprecated: Use 'provider_type' field instead. The endpoint type for
+   * the embedding model.
+   */
+  embedding_endpoint_type:
+    | 'openai'
+    | 'anthropic'
+    | 'bedrock'
+    | 'google_ai'
+    | 'google_vertex'
+    | 'azure'
+    | 'groq'
+    | 'ollama'
+    | 'webui'
+    | 'webui-legacy'
+    | 'lmstudio'
+    | 'lmstudio-legacy'
+    | 'llamacpp'
+    | 'koboldcpp'
+    | 'vllm'
+    | 'hugging-face'
+    | 'mistral'
+    | 'together'
+    | 'pinecone';
+
+  /**
+   * @deprecated Deprecated: Use 'name' field instead. Embedding model name.
+   */
+  embedding_model: string;
+
+  /**
+   * The actual model name used by the provider
+   */
+  name: string;
+
+  /**
+   * The name of the provider
+   */
+  provider_name: string;
+
+  /**
+   * The type of the provider
+   */
+  provider_type: ProviderType;
+
+  /**
+   * @deprecated Deprecated: The Azure deployment for the model.
+   */
+  azure_deployment?: string | null;
+
+  /**
+   * @deprecated Deprecated: The Azure endpoint for the model.
+   */
+  azure_endpoint?: string | null;
+
+  /**
+   * @deprecated Deprecated: The Azure version for the model.
+   */
+  azure_version?: string | null;
+
+  /**
+   * @deprecated Deprecated: The maximum batch size for processing embeddings.
+   */
+  batch_size?: number;
+
+  /**
+   * @deprecated Deprecated: The chunk size of the embedding.
+   */
+  embedding_chunk_size?: number | null;
+
+  /**
+   * @deprecated Deprecated: The endpoint for the model.
+   */
+  embedding_endpoint?: string | null;
+
+  /**
+   * The handle for this config, in the format provider/model-name.
+   */
+  handle?: string | null;
+
+  /**
+   * Type of model (llm or embedding)
+   */
+  model_type?: 'embedding';
+}
+
 /**
  * Configuration for Language Model (LLM) connection and generation parameters.
  */
@@ -230,6 +331,155 @@ export interface LlmConfig {
   verbosity?: 'low' | 'medium' | 'high' | null;
 }
 
+export interface Model {
+  /**
+   * @deprecated Deprecated: Use 'max_context_window' field instead. The context
+   * window size for the model.
+   */
+  context_window: number;
+
+  /**
+   * The maximum context window for the model
+   */
+  max_context_window: number;
+
+  /**
+   * @deprecated Deprecated: Use 'name' field instead. LLM model name.
+   */
+  model: string;
+
+  /**
+   * @deprecated Deprecated: Use 'provider_type' field instead. The endpoint type for
+   * the model.
+   */
+  model_endpoint_type:
+    | 'openai'
+    | 'anthropic'
+    | 'google_ai'
+    | 'google_vertex'
+    | 'azure'
+    | 'groq'
+    | 'ollama'
+    | 'webui'
+    | 'webui-legacy'
+    | 'lmstudio'
+    | 'lmstudio-legacy'
+    | 'lmstudio-chatcompletions'
+    | 'llamacpp'
+    | 'koboldcpp'
+    | 'vllm'
+    | 'hugging-face'
+    | 'mistral'
+    | 'together'
+    | 'bedrock'
+    | 'deepseek'
+    | 'xai';
+
+  /**
+   * The actual model name used by the provider
+   */
+  name: string;
+
+  /**
+   * The type of the provider
+   */
+  provider_type: ProviderType;
+
+  /**
+   * @deprecated Deprecated: The framework compatibility type for the model.
+   */
+  compatibility_type?: 'gguf' | 'mlx' | null;
+
+  /**
+   * A human-friendly display name for the model.
+   */
+  display_name?: string | null;
+
+  /**
+   * @deprecated Deprecated: Whether or not the model should use extended thinking if
+   * it is a 'reasoning' style model.
+   */
+  enable_reasoner?: boolean;
+
+  /**
+   * @deprecated Deprecated: Positive values penalize new tokens based on their
+   * existing frequency in the text so far.
+   */
+  frequency_penalty?: number | null;
+
+  /**
+   * The handle for this config, in the format provider/model-name.
+   */
+  handle?: string | null;
+
+  /**
+   * @deprecated Deprecated: Configurable thinking budget for extended thinking.
+   */
+  max_reasoning_tokens?: number;
+
+  /**
+   * @deprecated Deprecated: The maximum number of tokens to generate.
+   */
+  max_tokens?: number | null;
+
+  /**
+   * @deprecated Deprecated: The endpoint for the model.
+   */
+  model_endpoint?: string | null;
+
+  /**
+   * Type of model (llm or embedding)
+   */
+  model_type?: 'llm';
+
+  /**
+   * @deprecated Deprecated: The wrapper for the model.
+   */
+  model_wrapper?: string | null;
+
+  /**
+   * @deprecated Deprecated: If set to True, enables parallel tool calling.
+   */
+  parallel_tool_calls?: boolean | null;
+
+  /**
+   * @deprecated Deprecated: The provider category for the model.
+   */
+  provider_category?: ProviderCategory | null;
+
+  /**
+   * The provider name for the model.
+   */
+  provider_name?: string | null;
+
+  /**
+   * @deprecated Deprecated: Puts 'inner_thoughts' as a kwarg in the function call.
+   */
+  put_inner_thoughts_in_kwargs?: boolean | null;
+
+  /**
+   * @deprecated Deprecated: The reasoning effort to use when generating text
+   * reasoning models.
+   */
+  reasoning_effort?: 'minimal' | 'low' | 'medium' | 'high' | null;
+
+  /**
+   * @deprecated Deprecated: The temperature to use when generating text with the
+   * model.
+   */
+  temperature?: number;
+
+  /**
+   * @deprecated Deprecated: The cost tier for the model (cloud only).
+   */
+  tier?: string | null;
+
+  /**
+   * @deprecated Deprecated: Soft control for how verbose model output should be.
+   */
+  verbosity?: 'low' | 'medium' | 'high' | null;
+}
+
 export type ProviderCategory = 'base' | 'byok';
 
 export type ProviderType =
@@ -251,7 +501,7 @@ export type ProviderType =
   | 'vllm'
   | 'xai';
 
-export type ModelListResponse = Array<LlmConfig>;
+export type ModelListResponse = Array<Model>;
 
 export interface ModelListParams {
   provider_category?: Array<ProviderCategory> | null;
@@ -266,7 +516,9 @@ Models.Embeddings = Embeddings;
 export declare namespace Models {
   export {
     type EmbeddingConfig as EmbeddingConfig,
+    type EmbeddingModel as EmbeddingModel,
     type LlmConfig as LlmConfig,
+    type Model as Model,
     type ProviderCategory as ProviderCategory,
     type ProviderType as ProviderType,
     type ModelListResponse as ModelListResponse,

package/src/resources/runs/index.ts

@@ -6,6 +6,6 @@ export {
   type MessageListParams,
   type MessageStreamParams,
 } from './messages';
-export { Runs, type Job, type StopReasonType, type RunListResponse, type RunListParams } from './runs';
+export { Runs, type Job, type StopReasonType, type RunListParams } from './runs';
 export { Steps, type StepListParams } from './steps';
 export { Usage, type UsageRetrieveResponse } from './usage';

package/src/resources/runs/runs.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as MessagesAPI from '../agents/messages';
+import { RunsArrayPage } from '../agents/messages';
 import * as RunsMessagesAPI from './messages';
 import { MessageListParams, MessageStreamParams, MessageStreamResponse, Messages } from './messages';
 import * as StepsAPI from './steps';
@@ -9,6 +10,7 @@ import { StepListParams, Steps } from './steps';
 import * as UsageAPI from './usage';
 import { Usage, UsageRetrieveResponse } from './usage';
 import { APIPromise } from '../../core/api-promise';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -27,19 +29,17 @@ export class Runs extends APIResource {
   /**
    * List all runs.
    */
-  list(query: RunListParams | null | undefined = {}, options?: RequestOptions): APIPromise<RunListResponse> {
-    return this._client.get('/v1/runs/', { query, ...options });
+  list(
+    query: RunListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<RunsArrayPage, MessagesAPI.Run> {
+    return this._client.getAPIList('/v1/runs/', ArrayPage<MessagesAPI.Run>, { query, ...options });
   }
 }
 
 /**
  * Representation of offline jobs, used for tracking status of data loading tasks
  * (involving parsing and embedding files).
- *
- * Parameters: id (str): The unique identifier of the job. status (JobStatus): The
- * status of the job. created_at (datetime): The unix timestamp of when the job was
- * created. completed_at (datetime): The unix timestamp of when the job was
- * completed. user_id (str): The unique identifier of the user associated with the.
  */
 export interface Job {
   /**
@@ -145,20 +145,12 @@ export type StopReasonType =
   | 'cancelled'
   | 'requires_approval';
 
-export type RunListResponse = Array<MessagesAPI.Run>;
-
-export interface RunListParams {
+export interface RunListParams extends ArrayPageParams {
   /**
    * Filter for active runs.
    */
   active?: boolean;
 
-  /**
-   * Run ID cursor for pagination. Returns runs that come after this run ID in the
-   * specified sort order
-   */
-  after?: string | null;
-
   /**
    * The unique identifier of the agent associated with the run.
    */
@@ -181,28 +173,6 @@ export interface RunListParams {
    */
   background?: boolean | null;
 
-  /**
-   * Run ID cursor for pagination. Returns runs that come before this run ID in the
-   * specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of runs to return
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order for runs by creation time. 'asc' for oldest first, 'desc' for newest
-   * first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
-
   /**
    * Filter runs by status. Can specify multiple statuses.
    */
@@ -219,12 +189,7 @@ Runs.Usage = Usage;
 Runs.Steps = Steps;
 
 export declare namespace Runs {
-  export {
-    type Job as Job,
-    type StopReasonType as StopReasonType,
-    type RunListResponse as RunListResponse,
-    type RunListParams as RunListParams,
-  };
+  export { type Job as Job, type StopReasonType as StopReasonType, type RunListParams as RunListParams };
 
   export {
     Messages as Messages,
@@ -237,3 +202,5 @@ export declare namespace Runs {
 
   export { Steps as Steps, type StepListParams as StepListParams };
 }
+
+export { type RunsArrayPage };

package/src/resources/tools.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../core/resource';
 import * as MessagesAPI from './agents/messages';
 import { APIPromise } from '../core/api-promise';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../core/pagination';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
@@ -27,8 +28,8 @@ export class Tools extends APIResource {
   list(
     query: ToolListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ToolListResponse> {
-    return this._client.get('/v1/tools/', { query, ...options });
+  ): PagePromise<ToolsArrayPage, Tool> {
+    return this._client.getAPIList('/v1/tools/', ArrayPage<Tool>, { query, ...options });
   }
 
   /**
@@ -38,16 +39,6 @@ export class Tools extends APIResource {
     return this._client.delete(path`/v1/tools/${toolID}`, options);
   }
 
-  /**
-   * Get a count of all tools available to agents belonging to the org of the user.
-   */
-  count(
-    query: ToolCountParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ToolCountResponse> {
-    return this._client.get('/v1/tools/count', { query, ...options });
-  }
-
   /**
    * Update an existing tool
    */
@@ -70,6 +61,8 @@ export class Tools extends APIResource {
   }
 }
 
+export type ToolsArrayPage = ArrayPage<Tool>;
+
 export interface NpmRequirement {
   /**
    * Name of the npm package.
@@ -96,16 +89,12 @@ export interface PipRequirement {
 
 /**
  * Representation of a tool, which is a function that can be called by the agent.
- *
- * Parameters: id (str): The unique identifier of the tool. name (str): The name of
- * the function. tags (List[str]): Metadata tags. source_code (str): The source
- * code of the function. json_schema (Dict): The JSON schema of the function.
  */
 export interface Tool {
   /**
    * The human-friendly ID of the Tool
    */
-  id?: string;
+  id: string;
 
   /**
    * The args JSON schema of the function.
@@ -328,12 +317,8 @@ export type ToolType =
   | 'external_composio'
   | 'external_mcp';
 
-export type ToolListResponse = Array<Tool>;
-
 export type ToolDeleteResponse = unknown;
 
-export type ToolCountResponse = number;
-
 export type ToolUpsertBaseToolsResponse = Array<Tool>;
 
 export interface ToolCreateParams {
@@ -395,29 +380,12 @@ export interface ToolCreateParams {
   tags?: Array<string> | null;
 }
 
-export interface ToolListParams {
-  /**
-   * Tool ID cursor for pagination. Returns tools that come after this tool ID in the
-   * specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Tool ID cursor for pagination. Returns tools that come before this tool ID in
-   * the specified sort order
-   */
-  before?: string | null;
-
+export interface ToolListParams extends ArrayPageParams {
   /**
    * Tool type(s) to exclude - accepts repeated params or comma-separated values
    */
   exclude_tool_types?: Array<string> | null;
 
-  /**
-   * Maximum number of tools to return
-   */
-  limit?: number | null;
-
   /**
    * Filter by single tool name
    */
@@ -428,17 +396,6 @@ export interface ToolListParams {
    */
   names?: Array<string> | null;
 
-  /**
-   * Sort order for tools by creation time. 'asc' for oldest first, 'desc' for newest
-   * first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
-
   /**
    * Return only tools with tool*type starting with 'letta*'
    */
@@ -460,45 +417,6 @@ export interface ToolListParams {
   tool_types?: Array<string> | null;
 }
 
-export interface ToolCountParams {
-  /**
-   * Exclude built-in Letta tools from the count
-   */
-  exclude_letta_tools?: boolean | null;
-
-  /**
-   * Tool type(s) to exclude - accepts repeated params or comma-separated values
-   */
-  exclude_tool_types?: Array<string> | null;
-
-  name?: string | null;
-
-  /**
-   * Filter by specific tool names
-   */
-  names?: Array<string> | null;
-
-  /**
-   * Count only tools with tool*type starting with 'letta*'
-   */
-  return_only_letta_tools?: boolean | null;
-
-  /**
-   * Search tool names (case-insensitive partial match)
-   */
-  search?: string | null;
-
-  /**
-   * Filter by specific tool IDs - accepts repeated params or comma-separated values
-   */
-  tool_ids?: Array<string> | null;
-
-  /**
-   * Filter by tool type(s) - accepts repeated params or comma-separated values
-   */
-  tool_types?: Array<string> | null;
-}
-
 export interface ToolModifyParams {
   /**
    * The args JSON schema of the function.
@@ -630,13 +548,11 @@ export declare namespace Tools {
     type ToolCreate as ToolCreate,
     type ToolReturnMessage as ToolReturnMessage,
     type ToolType as ToolType,
-    type ToolListResponse as ToolListResponse,
     type ToolDeleteResponse as ToolDeleteResponse,
-    type ToolCountResponse as ToolCountResponse,
     type ToolUpsertBaseToolsResponse as ToolUpsertBaseToolsResponse,
+    type ToolsArrayPage as ToolsArrayPage,
     type ToolCreateParams as ToolCreateParams,
     type ToolListParams as ToolListParams,
-    type ToolCountParams as ToolCountParams,
     type ToolModifyParams as ToolModifyParams,
     type ToolUpsertParams as ToolUpsertParams,
   };

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.0.0-alpha.15'; // x-release-please-version
+export const VERSION = '1.0.0-alpha.17'; // x-release-please-version