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

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,117 @@ 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<EmbeddingListResponse.EmbeddingListResponseItem>;
+
+export namespace EmbeddingListResponse {
+  export interface EmbeddingListResponseItem {
+    /**
+     * 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: ModelsAPI.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';
+  }
+}
 
 export declare namespace Embeddings {
   export { type EmbeddingListResponse as EmbeddingListResponse };

package/src/resources/models/models.ts

@@ -1,6 +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';
 import * as EmbeddingsAPI from './embeddings';
 import { EmbeddingListResponse, Embeddings } from './embeddings';
 import { APIPromise } from '../../core/api-promise';
@@ -11,7 +12,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 = {},
@@ -251,7 +256,158 @@ export type ProviderType =
   | 'vllm'
   | 'xai';
 
-export type ModelListResponse = Array<LlmConfig>;
+export type ModelListResponse = Array<ModelListResponse.ModelListResponseItem>;
+
+export namespace ModelListResponse {
+  export interface ModelListResponseItem {
+    /**
+     * @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: ModelsAPI.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?: ModelsAPI.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 interface ModelListParams {
   provider_category?: Array<ProviderCategory> | null;

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,8 +29,11 @@ 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 });
   }
 }
 
@@ -145,20 +150,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 +178,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 +194,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 +207,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.
@@ -105,7 +98,7 @@ export interface Tool {
   /**
    * The human-friendly ID of the Tool
    */
-  id?: string;
+  id: string;
 
   /**
    * The args JSON schema of the function.
@@ -328,12 +321,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 +384,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 +400,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 +421,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 +552,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.16'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.0.0-alpha.15";
+export declare const VERSION = "1.0.0-alpha.16";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.0.0-alpha.15";
+export declare const VERSION = "1.0.0-alpha.16";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '1.0.0-alpha.15'; // x-release-please-version
+exports.VERSION = '1.0.0-alpha.16'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.0.0-alpha.15'; // x-release-please-version
+export const VERSION = '1.0.0-alpha.16'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map