@letta-ai/letta-client 1.6.8 → 1.7.2

package/src/resources/agents/messages.ts

@@ -535,7 +535,7 @@ export interface InternalMessage {
   /**
    * The list of approvals for this message.
    */
-  approvals?: Array<ApprovalReturn | InternalMessage.LettaSchemasMessageToolReturn> | null;
+  approvals?: Array<ApprovalReturn | InternalMessage.LettaSchemasMessageToolReturnOutput> | null;
 
   /**
    * Whether tool call is approved.
@@ -649,16 +649,16 @@ export interface InternalMessage {
 }
 
 export namespace InternalMessage {
-  export interface LettaSchemasMessageToolReturn {
+  export interface LettaSchemasMessageToolReturnOutput {
     /**
      * The status of the tool call
      */
     status: 'success' | 'error';
 
     /**
-     * The function response string
+     * The function response - either a string or list of content parts (text/image)
      */
-    func_response?: string | null;
+    func_response?: string | Array<MessagesAPI.TextContent | MessagesAPI.ImageContent> | null;
 
     /**
      * Captured stderr from the tool invocation
@@ -751,9 +751,9 @@ export namespace InternalMessage {
     status: 'success' | 'error';
 
     /**
-     * The function response string
+     * The function response - either a string or list of content parts (text/image)
      */
-    func_response?: string | null;
+    func_response?: string | Array<MessagesAPI.TextContent | MessagesAPI.ImageContent> | null;
 
     /**
      * Captured stderr from the tool invocation
@@ -857,6 +857,13 @@ export interface LettaRequest {
    */
   messages?: Array<AgentsAPI.MessageCreate | ApprovalCreate> | null;
 
+  /**
+   * Model handle to use for this request instead of the agent's default model. This
+   * allows sending a message to a different model without changing the agent's
+   * configuration.
+   */
+  override_model?: string | null;
+
   /**
    * @deprecated Whether the server should parse specific tool call arguments
    * (default `send_message`) as `AssistantMessage` objects. Still supported for
@@ -1095,6 +1102,13 @@ export interface LettaStreamingRequest {
    */
   messages?: Array<AgentsAPI.MessageCreate | ApprovalCreate> | null;
 
+  /**
+   * Model handle to use for this request instead of the agent's default model. This
+   * allows sending a message to a different model without changing the agent's
+   * configuration.
+   */
+  override_model?: string | null;
+
   /**
    * Flag to determine if individual tokens should be streamed, rather than streaming
    * per step (only used when streaming=true).
@@ -1201,14 +1215,36 @@ export type LettaStreamingResponse =
 
 export namespace LettaStreamingResponse {
   /**
-   * Ping messages are a keep-alive to prevent SSE streams from timing out during
+   * A ping message used as a keepalive to prevent SSE streams from timing out during
    * long running requests.
+   *
+   * Args: id (str): The ID of the message date (datetime): The date the message was
+   * created in ISO format
    */
   export interface LettaPing {
+    id: string;
+
+    date: string;
+
+    is_err?: boolean | null;
+
     /**
-     * The type of the message.
+     * The type of the message. Ping messages are a keep-alive to prevent SSE streams
+     * from timing out during long running requests.
      */
-    message_type: 'ping';
+    message_type?: 'ping';
+
+    name?: string | null;
+
+    otid?: string | null;
+
+    run_id?: string | null;
+
+    sender_id?: string | null;
+
+    seq_id?: number | null;
+
+    step_id?: string | null;
   }
 
   /**
@@ -1240,6 +1276,11 @@ export namespace LettaStreamingResponse {
      * An optional error detail.
      */
     detail?: string;
+
+    /**
+     * The sequence ID for cursor-based pagination.
+     */
+    seq_id?: number;
   }
 
   /**
@@ -1743,7 +1784,10 @@ export interface ToolReturn {
 
   tool_call_id: string;
 
-  tool_return: string;
+  /**
+   * The tool return value - either a string or list of content parts (text/image)
+   */
+  tool_return: Array<TextContent | ImageContent> | string;
 
   stderr?: Array<string> | null;
 
@@ -1939,6 +1983,13 @@ export interface MessageCreateParamsBase {
    */
   messages?: Array<AgentsAPI.MessageCreate | ApprovalCreate> | null;
 
+  /**
+   * Model handle to use for this request instead of the agent's default model. This
+   * allows sending a message to a different model without changing the agent's
+   * configuration.
+   */
+  override_model?: string | null;
+
   /**
    * Flag to determine if individual tokens should be streamed, rather than streaming
    * per step (only used when streaming=true).
@@ -2134,6 +2185,7 @@ export namespace MessageCompactParams {
       | AgentsAPI.DeepseekModelSettings
       | AgentsAPI.TogetherModelSettings
       | AgentsAPI.BedrockModelSettings
+      | CompactionSettings.ChatGptoAuthModelSettings
       | null;
 
     /**
@@ -2188,6 +2240,48 @@ export namespace MessageCompactParams {
        */
       temperature?: number;
     }
+
+    /**
+     * ChatGPT OAuth model configuration (uses ChatGPT backend API).
+     */
+    export interface ChatGptoAuthModelSettings {
+      /**
+       * The maximum number of tokens the model can generate.
+       */
+      max_output_tokens?: number;
+
+      /**
+       * Whether to enable parallel tool calling.
+       */
+      parallel_tool_calls?: boolean;
+
+      /**
+       * The type of the provider.
+       */
+      provider_type?: 'chatgpt_oauth';
+
+      /**
+       * The reasoning configuration for the model.
+       */
+      reasoning?: ChatGptoAuthModelSettings.Reasoning;
+
+      /**
+       * The temperature of the model.
+       */
+      temperature?: number;
+    }
+
+    export namespace ChatGptoAuthModelSettings {
+      /**
+       * The reasoning configuration for the model.
+       */
+      export interface Reasoning {
+        /**
+         * The reasoning effort level for GPT-5.x and o-series models.
+         */
+        reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
+      }
+    }
   }
 }
 
@@ -2257,6 +2351,13 @@ export interface MessageCreateAsyncParams {
    */
   messages?: Array<AgentsAPI.MessageCreate | ApprovalCreate> | null;
 
+  /**
+   * Model handle to use for this request instead of the agent's default model. This
+   * allows sending a message to a different model without changing the agent's
+   * configuration.
+   */
+  override_model?: string | null;
+
   /**
    * @deprecated Whether the server should parse specific tool call arguments
    * (default `send_message`) as `AssistantMessage` objects. Still supported for
@@ -2410,6 +2511,13 @@ export interface MessageStreamParams {
    */
   messages?: Array<AgentsAPI.MessageCreate | ApprovalCreate> | null;
 
+  /**
+   * Model handle to use for this request instead of the agent's default model. This
+   * allows sending a message to a different model without changing the agent's
+   * configuration.
+   */
+  override_model?: string | null;
+
   /**
    * Flag to determine if individual tokens should be streamed, rather than streaming
    * per step (only used when streaming=true).

package/src/resources/conversations/conversations.ts

@@ -31,6 +31,17 @@ export class Conversations extends APIResource {
     return this._client.get(path`/v1/conversations/${conversationID}`, options);
   }
 
+  /**
+   * Update a conversation.
+   */
+  update(
+    conversationID: string,
+    body: ConversationUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<Conversation> {
+    return this._client.patch(path`/v1/conversations/${conversationID}`, { body, ...options });
+  }
+
   /**
    * List all conversations for an agent.
    */
@@ -116,6 +127,16 @@ export interface CreateConversation {
   summary?: string | null;
 }
 
+/**
+ * Request model for updating a conversation.
+ */
+export interface UpdateConversation {
+  /**
+   * A summary of the conversation.
+   */
+  summary?: string | null;
+}
+
 export type ConversationListResponse = Array<Conversation>;
 
 export type ConversationCancelResponse = { [key: string]: unknown };
@@ -139,6 +160,13 @@ export interface ConversationCreateParams {
   summary?: string | null;
 }
 
+export interface ConversationUpdateParams {
+  /**
+   * A summary of the conversation.
+   */
+  summary?: string | null;
+}
+
 export interface ConversationListParams {
   /**
    * The agent ID to list conversations for
@@ -162,9 +190,11 @@ export declare namespace Conversations {
   export {
     type Conversation as Conversation,
     type CreateConversation as CreateConversation,
+    type UpdateConversation as UpdateConversation,
     type ConversationListResponse as ConversationListResponse,
     type ConversationCancelResponse as ConversationCancelResponse,
     type ConversationCreateParams as ConversationCreateParams,
+    type ConversationUpdateParams as ConversationUpdateParams,
     type ConversationListParams as ConversationListParams,
   };
 

package/src/resources/conversations/index.ts

@@ -4,9 +4,11 @@ export {
   Conversations,
   type Conversation,
   type CreateConversation,
+  type UpdateConversation,
   type ConversationListResponse,
   type ConversationCancelResponse,
   type ConversationCreateParams,
+  type ConversationUpdateParams,
   type ConversationListParams,
 } from './conversations';
 export {

package/src/resources/conversations/messages.ts

@@ -141,6 +141,13 @@ export interface MessageCreateParams {
    */
   messages?: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate> | null;
 
+  /**
+   * Model handle to use for this request instead of the agent's default model. This
+   * allows sending a message to a different model without changing the agent's
+   * configuration.
+   */
+  override_model?: string | null;
+
   /**
    * Flag to determine if individual tokens should be streamed, rather than streaming
    * per step (only used when streaming=true).

package/src/resources/index.ts

@@ -72,9 +72,11 @@ export {
   Conversations,
   type Conversation,
   type CreateConversation,
+  type UpdateConversation,
   type ConversationListResponse,
   type ConversationCancelResponse,
   type ConversationCreateParams,
+  type ConversationUpdateParams,
   type ConversationListParams,
 } from './conversations/conversations';
 export {

package/src/resources/models/models.ts

@@ -241,7 +241,8 @@ export interface LlmConfig {
     | 'bedrock'
     | 'deepseek'
     | 'xai'
-    | 'zai';
+    | 'zai'
+    | 'chatgpt_oauth';
 
   /**
    * The framework compatibility type for the model.
@@ -338,6 +339,13 @@ export interface LlmConfig {
     | AgentsAPI.JsonObjectResponseFormat
     | null;
 
+  /**
+   * Enable strict mode for tool calling. When true, tool schemas include strict:
+   * true and additionalProperties: false, guaranteeing tool outputs match JSON
+   * schemas.
+   */
+  strict?: boolean;
+
   /**
    * The temperature to use when generating text with the model. A higher temperature
    * will result in more random text.
@@ -398,7 +406,8 @@ export interface Model {
     | 'bedrock'
     | 'deepseek'
     | 'xai'
-    | 'zai';
+    | 'zai'
+    | 'chatgpt_oauth';
 
   /**
    * The actual model name used by the provider
@@ -504,6 +513,13 @@ export interface Model {
     | AgentsAPI.JsonObjectResponseFormat
     | null;
 
+  /**
+   * Enable strict mode for tool calling. When true, tool schemas include strict:
+   * true and additionalProperties: false, guaranteeing tool outputs match JSON
+   * schemas.
+   */
+  strict?: boolean;
+
   /**
    * @deprecated Deprecated: The temperature to use when generating text with the
    * model.
@@ -528,6 +544,7 @@ export type ProviderType =
   | 'azure'
   | 'bedrock'
   | 'cerebras'
+  | 'chatgpt_oauth'
   | 'deepseek'
   | 'google_ai'
   | 'google_vertex'
@@ -540,6 +557,7 @@ export type ProviderType =
   | 'openai'
   | 'together'
   | 'vllm'
+  | 'sglang'
   | 'xai'
   | 'zai';
 

package/src/resources/steps/steps.ts

@@ -48,9 +48,13 @@ export type StepsArrayPage = ArrayPage<Step>;
  * Attributes: id (str): The unique identifier of the provider trace. request_json
  * (Dict[str, Any]): JSON content of the provider request. response_json (Dict[str,
  * Any]): JSON content of the provider response. step_id (str): ID of the step that
- * this trace is associated with. organization_id (str): The unique identifier of
- * the organization. created_at (datetime): The timestamp when the object was
- * created.
+ * this trace is associated with. agent_id (str): ID of the agent that generated
+ * this trace. agent_tags (list[str]): Tags associated with the agent for
+ * filtering. call_type (str): Type of call (agent_step, summarization, etc.).
+ * run_id (str): ID of the run this trace is associated with. source (str): Source
+ * service that generated this trace (memgpt-server, lettuce-py). organization_id
+ * (str): The unique identifier of the organization. created_at (datetime): The
+ * timestamp when the object was created.
  */
 export interface ProviderTrace {
   /**
@@ -68,6 +72,21 @@ export interface ProviderTrace {
    */
   id?: string;
 
+  /**
+   * ID of the agent that generated this trace
+   */
+  agent_id?: string | null;
+
+  /**
+   * Tags associated with the agent for filtering
+   */
+  agent_tags?: Array<string> | null;
+
+  /**
+   * Type of call (agent_step, summarization, etc.)
+   */
+  call_type?: string | null;
+
   /**
    * The timestamp when the object was created.
    */
@@ -83,6 +102,16 @@ export interface ProviderTrace {
    */
   last_updated_by_id?: string | null;
 
+  /**
+   * ID of the run this trace is associated with
+   */
+  run_id?: string | null;
+
+  /**
+   * Source service that generated this trace (memgpt-server, lettuce-py)
+   */
+  source?: string | null;
+
   /**
    * ID of the step that this trace is associated with
    */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.6.8'; // x-release-please-version
+export const VERSION = '1.7.2'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.6.8";
+export declare const VERSION = "1.7.2";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.6.8";
+export declare const VERSION = "1.7.2";
 //# 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.6.8'; // x-release-please-version
+exports.VERSION = '1.7.2'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.6.8'; // x-release-please-version
+export const VERSION = '1.7.2'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map