@letta-ai/letta-client 1.6.4 → 1.6.6

package/resources/tags.d.mts

@@ -3,7 +3,7 @@ import { APIPromise } from "../core/api-promise.mjs";
 import { RequestOptions } from "../internal/request-options.mjs";
 export declare class Tags extends APIResource {
     /**
-     * Get the list of all agent tags that have been created.
+     * Get the list of all tags (from agents and blocks) that have been created.
      */
     list(query?: TagListParams | null | undefined, options?: RequestOptions): APIPromise<TagListResponse>;
 }

package/resources/tags.d.ts

@@ -3,7 +3,7 @@ import { APIPromise } from "../core/api-promise.js";
 import { RequestOptions } from "../internal/request-options.js";
 export declare class Tags extends APIResource {
     /**
-     * Get the list of all agent tags that have been created.
+     * Get the list of all tags (from agents and blocks) that have been created.
      */
     list(query?: TagListParams | null | undefined, options?: RequestOptions): APIPromise<TagListResponse>;
 }

package/resources/tags.js

@@ -5,7 +5,7 @@ exports.Tags = void 0;
 const resource_1 = require("../core/resource.js");
 class Tags extends resource_1.APIResource {
     /**
-     * Get the list of all agent tags that have been created.
+     * Get the list of all tags (from agents and blocks) that have been created.
      */
     list(query = {}, options) {
         return this._client.get('/v1/tags/', { query, ...options });

package/resources/tags.mjs

@@ -2,7 +2,7 @@
 import { APIResource } from "../core/resource.mjs";
 export class Tags extends APIResource {
     /**
-     * Get the list of all agent tags that have been created.
+     * Get the list of all tags (from agents and blocks) that have been created.
      */
     list(query = {}, options) {
         return this._client.get('/v1/tags/', { query, ...options });

package/src/client.ts

@@ -135,6 +135,14 @@ import {
   Blocks,
   CreateBlock,
 } from './resources/blocks/blocks';
+import {
+  Conversation,
+  ConversationCreateParams,
+  ConversationListParams,
+  ConversationListResponse,
+  Conversations,
+  CreateConversation,
+} from './resources/conversations/conversations';
 import {
   Folder,
   FolderCreateParams,
@@ -978,6 +986,7 @@ export class Letta {
   messages: API.Messages = new API.Messages(this);
   passages: API.Passages = new API.Passages(this);
   batches: API.Batches = new API.Batches(this);
+  conversations: API.Conversations = new API.Conversations(this);
   accessTokens: API.AccessTokens = new API.AccessTokens(this);
 }
 
@@ -997,6 +1006,7 @@ Letta.Groups = Groups;
 Letta.Messages = Messages;
 Letta.Passages = Passages;
 Letta.Batches = Batches;
+Letta.Conversations = Conversations;
 Letta.AccessTokens = AccessTokens;
 
 export declare namespace Letta {
@@ -1223,6 +1233,15 @@ export declare namespace Letta {
     type BatchListParams as BatchListParams,
   };
 
+  export {
+    Conversations as Conversations,
+    type Conversation as Conversation,
+    type CreateConversation as CreateConversation,
+    type ConversationListResponse as ConversationListResponse,
+    type ConversationCreateParams as ConversationCreateParams,
+    type ConversationListParams as ConversationListParams,
+  };
+
   export {
     AccessTokens as AccessTokens,
     type AccessTokenCreateResponse as AccessTokenCreateResponse,

package/src/resources/agents/agents.ts

@@ -120,6 +120,18 @@ import {
   PassageSearchResponse,
   Passages,
 } from './passages';
+import * as ScheduleAPI from './schedule';
+import {
+  Schedule,
+  ScheduleCreateParams,
+  ScheduleCreateResponse,
+  ScheduleDeleteParams,
+  ScheduleDeleteResponse,
+  ScheduleListParams,
+  ScheduleListResponse,
+  ScheduleRetrieveParams,
+  ScheduleRetrieveResponse,
+} from './schedule';
 import * as AgentsToolsAPI from './tools';
 import {
   ToolAttachParams,
@@ -147,6 +159,7 @@ import { path } from '../../internal/utils/path';
 
 export class Agents extends APIResource {
   messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
+  schedule: ScheduleAPI.Schedule = new ScheduleAPI.Schedule(this._client);
   blocks: BlocksAPI.Blocks = new BlocksAPI.Blocks(this._client);
   tools: AgentsToolsAPI.Tools = new AgentsToolsAPI.Tools(this._client);
   folders: FoldersAPI.Folders = new FoldersAPI.Folders(this._client);
@@ -497,6 +510,16 @@ export interface AgentState {
    */
   multi_agent_group?: GroupsGroupsAPI.Group | null;
 
+  /**
+   * A message representing a request for approval to call a tool (generated by the
+   * LLM to trigger tool execution).
+   *
+   * Args: id (str): The ID of the message date (datetime): The date the message was
+   * created in ISO format name (Optional[str]): The name of the sender of the
+   * message tool_call (ToolCall): The tool call
+   */
+  pending_approval?: MessagesAPI.ApprovalRequestMessage | null;
+
   /**
    * The per-file view window character limit for this agent. Setting this too high
    * may exceed the context window, which will break the agent.
@@ -685,6 +708,11 @@ export namespace AgentState {
        */
       read_only?: boolean;
 
+      /**
+       * The tags associated with the block.
+       */
+      tags?: Array<string> | null;
+
       /**
        * The id of the template.
        */
@@ -2055,6 +2083,7 @@ export interface AgentRetrieveParams {
     | 'agent.blocks'
     | 'agent.identities'
     | 'agent.managed_group'
+    | 'agent.pending_approval'
     | 'agent.secrets'
     | 'agent.sources'
     | 'agent.tags'
@@ -2458,6 +2487,7 @@ export interface AgentListParams extends ArrayPageParams {
     | 'agent.blocks'
     | 'agent.identities'
     | 'agent.managed_group'
+    | 'agent.pending_approval'
     | 'agent.secrets'
     | 'agent.sources'
     | 'agent.tags'
@@ -2531,7 +2561,7 @@ export interface AgentExportFileParams {
 
 export interface AgentImportFileParams {
   /**
-   * Body param:
+   * Body param
    */
   file: Uploadable;
 
@@ -2593,12 +2623,13 @@ export interface AgentImportFileParams {
   strip_messages?: boolean;
 
   /**
-   * Header param:
+   * Header param
    */
   'x-override-embedding-model'?: string;
 }
 
 Agents.Messages = Messages;
+Agents.Schedule = Schedule;
 Agents.Blocks = Blocks;
 Agents.Tools = Tools;
 Agents.Folders = Folders;
@@ -2704,6 +2735,18 @@ export declare namespace Agents {
     type MessageStreamParams as MessageStreamParams,
   };
 
+  export {
+    Schedule as Schedule,
+    type ScheduleCreateResponse as ScheduleCreateResponse,
+    type ScheduleRetrieveResponse as ScheduleRetrieveResponse,
+    type ScheduleListResponse as ScheduleListResponse,
+    type ScheduleDeleteResponse as ScheduleDeleteResponse,
+    type ScheduleCreateParams as ScheduleCreateParams,
+    type ScheduleRetrieveParams as ScheduleRetrieveParams,
+    type ScheduleListParams as ScheduleListParams,
+    type ScheduleDeleteParams as ScheduleDeleteParams,
+  };
+
   export {
     Blocks as Blocks,
     type Block as Block,

package/src/resources/agents/blocks.ts

@@ -161,6 +161,11 @@ export interface Block {
    */
   read_only?: boolean;
 
+  /**
+   * The tags associated with the block.
+   */
+  tags?: Array<string> | null;
+
   /**
    * The id of the template.
    */
@@ -236,6 +241,11 @@ export interface BlockUpdate {
    */
   read_only?: boolean;
 
+  /**
+   * The tags to associate with the block.
+   */
+  tags?: Array<string> | null;
+
   /**
    * The id of the template.
    */
@@ -325,6 +335,11 @@ export interface BlockUpdateParams {
    */
   read_only?: boolean;
 
+  /**
+   * Body param: The tags to associate with the block.
+   */
+  tags?: Array<string> | null;
+
   /**
    * Body param: The id of the template.
    */

package/src/resources/agents/index.ts

@@ -151,6 +151,17 @@ export {
   type PassageDeleteParams,
   type PassageSearchParams,
 } from './passages';
+export {
+  Schedule,
+  type ScheduleCreateResponse,
+  type ScheduleRetrieveResponse,
+  type ScheduleListResponse,
+  type ScheduleDeleteResponse,
+  type ScheduleCreateParams,
+  type ScheduleRetrieveParams,
+  type ScheduleListParams,
+  type ScheduleDeleteParams,
+} from './schedule';
 export {
   Tools,
   type ToolExecuteRequest,

package/src/resources/agents/messages.ts

@@ -118,9 +118,16 @@ export class Messages extends APIResource {
   }
 
   /**
-   * Process a user message and return the agent's response. This endpoint accepts a
-   * message from a user and processes it through the agent. It will stream the steps
-   * of the response always, and stream the tokens if 'stream_tokens' is set to True.
+   * Process a user message and return the agent's response.
+   *
+   * Deprecated: Use the `POST /{agent_id}/messages` endpoint with `streaming=true`
+   * in the request body instead.
+   *
+   * This endpoint accepts a message from a user and processes it through the agent.
+   * It will stream the steps of the response always, and stream the tokens if
+   * 'stream_tokens' is set to True.
+   *
+   * @deprecated
    */
   stream(
     agentID: string,
@@ -501,6 +508,7 @@ export namespace ImageContent {
  *         tool_returns (List[ToolReturn]): The list of tool returns requested.
  *         group_id (str): The multi-agent group that the message was sent in.
  *         sender_id (str): The id of the sender of the message, can be an identity id or agent id.
+ *         conversation_id (str): The conversation this message belongs to.
  *
  * t
  */
@@ -555,6 +563,11 @@ export interface InternalMessage {
     | InternalMessage.SummarizedReasoningContent
   > | null;
 
+  /**
+   * The conversation this message belongs to
+   */
+  conversation_id?: string | null;
+
   /**
    * The timestamp when the object was created.
    */
@@ -1490,6 +1503,11 @@ export interface Run {
    */
   completed_at?: string | null;
 
+  /**
+   * The unique identifier of the conversation associated with the run.
+   */
+  conversation_id?: string | null;
+
   /**
    * The timestamp when the run was created.
    */
@@ -2038,6 +2056,11 @@ export interface MessageListParams extends ArrayPageParams {
    */
   assistant_message_tool_name?: string;
 
+  /**
+   * Conversation ID to filter messages by.
+   */
+  conversation_id?: string | null;
+
   /**
    * Group ID to filter messages by.
    */

package/src/resources/agents/passages.ts

@@ -83,6 +83,11 @@ export interface PassageSearchResponse {
 
 export namespace PassageSearchResponse {
   export interface Result {
+    /**
+     * Unique identifier of the archival memory passage
+     */
+    id: string;
+
     /**
      * Text content of the archival memory passage
      */

package/src/resources/agents/schedule.ts

@@ -0,0 +1,361 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Schedule extends APIResource {
+  /**
+   * Schedule a message to be sent by the agent at a specified time or on a recurring
+   * basis.
+   */
+  create(
+    agentID: string,
+    body: ScheduleCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<ScheduleCreateResponse> {
+    return this._client.post(path`/v1/agents/${agentID}/schedule`, { body, ...options });
+  }
+
+  /**
+   * Retrieve a scheduled message by its ID for a specific agent.
+   */
+  retrieve(
+    scheduledMessageID: string,
+    params: ScheduleRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<ScheduleRetrieveResponse> {
+    const { agent_id } = params;
+    return this._client.get(path`/v1/agents/${agent_id}/schedule/${scheduledMessageID}`, options);
+  }
+
+  /**
+   * List all scheduled messages for a specific agent.
+   */
+  list(
+    agentID: string,
+    query: ScheduleListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ScheduleListResponse> {
+    return this._client.get(path`/v1/agents/${agentID}/schedule`, { query, ...options });
+  }
+
+  /**
+   * Delete a scheduled message by its ID for a specific agent.
+   */
+  delete(
+    scheduledMessageID: string,
+    params: ScheduleDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<ScheduleDeleteResponse> {
+    const { agent_id, ...body } = params;
+    return this._client.delete(path`/v1/agents/${agent_id}/schedule/${scheduledMessageID}`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export interface ScheduleCreateResponse {
+  id: string;
+
+  next_scheduled_at?: string;
+}
+
+export interface ScheduleRetrieveResponse {
+  id: string;
+
+  agent_id: string;
+
+  message: ScheduleRetrieveResponse.Message;
+
+  next_scheduled_time: string | null;
+
+  schedule: ScheduleRetrieveResponse.UnionMember0 | ScheduleRetrieveResponse.UnionMember1;
+}
+
+export namespace ScheduleRetrieveResponse {
+  export interface Message {
+    messages: Array<Message.Message>;
+
+    callback_url?: string;
+
+    include_return_message_types?: Array<
+      | 'system_message'
+      | 'user_message'
+      | 'assistant_message'
+      | 'reasoning_message'
+      | 'hidden_reasoning_message'
+      | 'tool_call_message'
+      | 'tool_return_message'
+      | 'approval_request_message'
+      | 'approval_response_message'
+    >;
+
+    max_steps?: number;
+  }
+
+  export namespace Message {
+    export interface Message {
+      content: Array<Message.UnionMember0 | Message.UnionMember1> | string;
+
+      role: 'user' | 'assistant' | 'system';
+
+      name?: string;
+
+      otid?: string;
+
+      sender_id?: string;
+
+      type?: 'message';
+    }
+
+    export namespace Message {
+      export interface UnionMember0 {
+        text: string;
+
+        signature?: string | null;
+
+        type?: 'text';
+      }
+
+      export interface UnionMember1 {
+        source: UnionMember1.Source;
+
+        type: 'image';
+      }
+
+      export namespace UnionMember1 {
+        export interface Source {
+          data: string;
+
+          media_type: string;
+
+          detail?: string;
+
+          type?: 'base64';
+        }
+      }
+    }
+  }
+
+  export interface UnionMember0 {
+    scheduled_at: number;
+
+    type?: 'one-time';
+  }
+
+  export interface UnionMember1 {
+    cron_expression: string;
+
+    type: 'recurring';
+  }
+}
+
+export interface ScheduleListResponse {
+  has_next_page: boolean;
+
+  scheduled_messages: Array<ScheduleListResponse.ScheduledMessage>;
+}
+
+export namespace ScheduleListResponse {
+  export interface ScheduledMessage {
+    id: string;
+
+    agent_id: string;
+
+    message: ScheduledMessage.Message;
+
+    next_scheduled_time: string | null;
+
+    schedule: ScheduledMessage.UnionMember0 | ScheduledMessage.UnionMember1;
+  }
+
+  export namespace ScheduledMessage {
+    export interface Message {
+      messages: Array<Message.Message>;
+
+      callback_url?: string;
+
+      include_return_message_types?: Array<
+        | 'system_message'
+        | 'user_message'
+        | 'assistant_message'
+        | 'reasoning_message'
+        | 'hidden_reasoning_message'
+        | 'tool_call_message'
+        | 'tool_return_message'
+        | 'approval_request_message'
+        | 'approval_response_message'
+      >;
+
+      max_steps?: number;
+    }
+
+    export namespace Message {
+      export interface Message {
+        content: Array<Message.UnionMember0 | Message.UnionMember1> | string;
+
+        role: 'user' | 'assistant' | 'system';
+
+        name?: string;
+
+        otid?: string;
+
+        sender_id?: string;
+
+        type?: 'message';
+      }
+
+      export namespace Message {
+        export interface UnionMember0 {
+          text: string;
+
+          signature?: string | null;
+
+          type?: 'text';
+        }
+
+        export interface UnionMember1 {
+          source: UnionMember1.Source;
+
+          type: 'image';
+        }
+
+        export namespace UnionMember1 {
+          export interface Source {
+            data: string;
+
+            media_type: string;
+
+            detail?: string;
+
+            type?: 'base64';
+          }
+        }
+      }
+    }
+
+    export interface UnionMember0 {
+      scheduled_at: number;
+
+      type?: 'one-time';
+    }
+
+    export interface UnionMember1 {
+      cron_expression: string;
+
+      type: 'recurring';
+    }
+  }
+}
+
+export interface ScheduleDeleteResponse {
+  success: true;
+}
+
+export interface ScheduleCreateParams {
+  messages: Array<ScheduleCreateParams.Message>;
+
+  schedule: ScheduleCreateParams.UnionMember0 | ScheduleCreateParams.UnionMember1;
+
+  callback_url?: string;
+
+  include_return_message_types?: Array<
+    | 'system_message'
+    | 'user_message'
+    | 'assistant_message'
+    | 'reasoning_message'
+    | 'hidden_reasoning_message'
+    | 'tool_call_message'
+    | 'tool_return_message'
+    | 'approval_request_message'
+    | 'approval_response_message'
+  >;
+
+  max_steps?: number;
+}
+
+export namespace ScheduleCreateParams {
+  export interface Message {
+    content: Array<Message.UnionMember0 | Message.UnionMember1> | string;
+
+    role: 'user' | 'assistant' | 'system';
+
+    name?: string;
+
+    otid?: string;
+
+    sender_id?: string;
+
+    type?: 'message';
+  }
+
+  export namespace Message {
+    export interface UnionMember0 {
+      text: string;
+
+      signature?: string | null;
+
+      type?: 'text';
+    }
+
+    export interface UnionMember1 {
+      source: UnionMember1.Source;
+
+      type: 'image';
+    }
+
+    export namespace UnionMember1 {
+      export interface Source {
+        data: string;
+
+        media_type: string;
+
+        detail?: string;
+
+        type?: 'base64';
+      }
+    }
+  }
+
+  export interface UnionMember0 {
+    scheduled_at: number;
+
+    type?: 'one-time';
+  }
+
+  export interface UnionMember1 {
+    cron_expression: string;
+
+    type: 'recurring';
+  }
+}
+
+export interface ScheduleRetrieveParams {
+  agent_id: string;
+}
+
+export interface ScheduleListParams {
+  after?: string;
+
+  limit?: string;
+}
+
+export interface ScheduleDeleteParams {
+  agent_id: string;
+}
+
+export declare namespace Schedule {
+  export {
+    type ScheduleCreateResponse as ScheduleCreateResponse,
+    type ScheduleRetrieveResponse as ScheduleRetrieveResponse,
+    type ScheduleListResponse as ScheduleListResponse,
+    type ScheduleDeleteResponse as ScheduleDeleteResponse,
+    type ScheduleCreateParams as ScheduleCreateParams,
+    type ScheduleRetrieveParams as ScheduleRetrieveParams,
+    type ScheduleListParams as ScheduleListParams,
+    type ScheduleDeleteParams as ScheduleDeleteParams,
+  };
+}

package/src/resources/blocks/agents.ts

@@ -33,6 +33,7 @@ export interface AgentListParams extends ArrayPageParams {
     | 'agent.blocks'
     | 'agent.identities'
     | 'agent.managed_group'
+    | 'agent.pending_approval'
     | 'agent.secrets'
     | 'agent.sources'
     | 'agent.tags'