@letta-ai/letta-client 1.6.5 → 1.6.6

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'

package/src/resources/blocks/blocks.ts

@@ -133,6 +133,11 @@ export interface BlockResponse {
    */
   read_only?: boolean;
 
+  /**
+   * The tags associated with the block.
+   */
+  tags?: Array<string> | null;
+
   /**
    * @deprecated (Deprecated) The id of the template.
    */
@@ -210,6 +215,11 @@ export interface CreateBlock {
    */
   read_only?: boolean;
 
+  /**
+   * The tags to associate with the block.
+   */
+  tags?: Array<string> | null;
+
   /**
    * The id of the template.
    */
@@ -286,6 +296,11 @@ export interface BlockCreateParams {
    */
   read_only?: boolean;
 
+  /**
+   * The tags to associate with the block.
+   */
+  tags?: Array<string> | null;
+
   /**
    * The id of the template.
    */
@@ -358,6 +373,11 @@ export interface BlockUpdateParams {
    */
   read_only?: boolean;
 
+  /**
+   * The tags to associate with the block.
+   */
+  tags?: Array<string> | null;
+
   /**
    * The id of the template.
    */
@@ -420,6 +440,12 @@ export interface BlockListParams extends ArrayPageParams {
    */
   label_search?: string | null;
 
+  /**
+   * If True, only returns blocks that match ALL given tags. Otherwise, return blocks
+   * that have ANY of the passed-in tags.
+   */
+  match_all_tags?: boolean;
+
   /**
    * Name filter (alphanumeric, spaces, hyphens, underscores)
    */
@@ -430,6 +456,11 @@ export interface BlockListParams extends ArrayPageParams {
    */
   project_id?: string | null;
 
+  /**
+   * List of tags to filter blocks by
+   */
+  tags?: Array<string> | null;
+
   /**
    * Whether to include only templates
    */

package/src/resources/conversations/conversations.ts

@@ -69,6 +69,12 @@ export interface Conversation {
    */
   in_context_message_ids?: Array<string>;
 
+  /**
+   * IDs of blocks that are isolated (specific to this conversation, overriding agent
+   * defaults).
+   */
+  isolated_block_ids?: Array<string>;
+
   /**
    * The id of the user that made this object.
    */
@@ -89,6 +95,13 @@ export interface Conversation {
  * Request model for creating a new conversation.
  */
 export interface CreateConversation {
+  /**
+   * List of block labels that should be isolated (conversation-specific) rather than
+   * shared across conversations. New blocks will be created as copies of the agent's
+   * blocks with these labels.
+   */
+  isolated_block_labels?: Array<string> | null;
+
   /**
    * A summary of the conversation.
    */
@@ -103,6 +116,13 @@ export interface ConversationCreateParams {
    */
   agent_id: string;
 
+  /**
+   * Body param: List of block labels that should be isolated (conversation-specific)
+   * rather than shared across conversations. New blocks will be created as copies of
+   * the agent's blocks with these labels.
+   */
+  isolated_block_labels?: Array<string> | null;
+
   /**
    * Body param: A summary of the conversation.
    */

package/src/resources/folders/files.ts

@@ -357,7 +357,7 @@ export interface FileDeleteParams {
 
 export interface FileUploadParams {
   /**
-   * Body param:
+   * Body param
    */
   file: Uploadable;
 

package/src/resources/groups/messages.ts

@@ -256,7 +256,7 @@ export declare namespace MessageUpdateParams {
     content: string;
 
     /**
-     * Body param:
+     * Body param
      */
     message_type?: 'system_message';
   }
@@ -274,7 +274,7 @@ export declare namespace MessageUpdateParams {
     content: Array<MessagesAPI.LettaUserMessageContentUnion> | string;
 
     /**
-     * Body param:
+     * Body param
      */
     message_type?: 'user_message';
   }
@@ -286,12 +286,12 @@ export declare namespace MessageUpdateParams {
     group_id: string;
 
     /**
-     * Body param:
+     * Body param
      */
     reasoning: string;
 
     /**
-     * Body param:
+     * Body param
      */
     message_type?: 'reasoning_message';
   }
@@ -309,7 +309,7 @@ export declare namespace MessageUpdateParams {
     content: Array<MessagesAPI.LettaAssistantMessageContentUnion> | string;
 
     /**
-     * Body param:
+     * Body param
      */
     message_type?: 'assistant_message';
   }

package/src/resources/identities/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'

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

@@ -50,7 +50,7 @@ export interface ToolRetrieveParams {
 
 export interface ToolRunParams {
   /**
-   * Path param:
+   * Path param
    */
   mcp_server_id: string;
 

package/src/resources/messages.ts

@@ -38,6 +38,11 @@ export interface MessageSearchRequest {
    */
   agent_id?: string | null;
 
+  /**
+   * Filter messages by conversation ID
+   */
+  conversation_id?: string | null;
+
   /**
    * Filter messages created on or before this date
    */
@@ -233,6 +238,11 @@ export interface MessageListParams {
    */
   before?: string | null;
 
+  /**
+   * Conversation ID to filter messages by
+   */
+  conversation_id?: string | null;
+
   /**
    * Maximum number of messages to return
    */
@@ -256,6 +266,11 @@ export interface MessageSearchParams {
    */
   agent_id?: string | null;
 
+  /**
+   * Filter messages by conversation ID
+   */
+  conversation_id?: string | null;
+
   /**
    * Filter messages created on or before this date
    */

package/src/resources/runs/index.ts

@@ -8,4 +8,5 @@ export {
 } from './messages';
 export { Runs, type Job, type StopReasonType, type RunListParams } from './runs';
 export { Steps, type StepListParams } from './steps';
+export { Trace, type TraceRetrieveResponse, type TraceRetrieveParams } from './trace';
 export { Usage, type UsageRetrieveResponse } from './usage';

package/src/resources/runs/runs.ts

@@ -7,6 +7,8 @@ import * as RunsMessagesAPI from './messages';
 import { MessageListParams, MessageStreamParams, MessageStreamResponse, Messages } from './messages';
 import * as StepsAPI from './steps';
 import { StepListParams, Steps } from './steps';
+import * as TraceAPI from './trace';
+import { Trace, TraceRetrieveParams, TraceRetrieveResponse } from './trace';
 import * as UsageAPI from './usage';
 import { Usage, UsageRetrieveResponse } from './usage';
 import { APIPromise } from '../../core/api-promise';
@@ -18,6 +20,7 @@ export class Runs extends APIResource {
   messages: RunsMessagesAPI.Messages = new RunsMessagesAPI.Messages(this._client);
   usage: UsageAPI.Usage = new UsageAPI.Usage(this._client);
   steps: StepsAPI.Steps = new StepsAPI.Steps(this._client);
+  trace: TraceAPI.Trace = new TraceAPI.Trace(this._client);
 
   /**
    * Get the status of a run.
@@ -175,6 +178,11 @@ export interface RunListParams extends ArrayPageParams {
    */
   background?: boolean | null;
 
+  /**
+   * Filter runs by conversation ID.
+   */
+  conversation_id?: string | null;
+
   /**
    * Filter runs by status. Can specify multiple statuses.
    */
@@ -189,6 +197,7 @@ export interface RunListParams extends ArrayPageParams {
 Runs.Messages = Messages;
 Runs.Usage = Usage;
 Runs.Steps = Steps;
+Runs.Trace = Trace;
 
 export declare namespace Runs {
   export { type Job as Job, type StopReasonType as StopReasonType, type RunListParams as RunListParams };
@@ -203,6 +212,12 @@ export declare namespace Runs {
   export { Usage as Usage, type UsageRetrieveResponse as UsageRetrieveResponse };
 
   export { Steps as Steps, type StepListParams as StepListParams };
+
+  export {
+    Trace as Trace,
+    type TraceRetrieveResponse as TraceRetrieveResponse,
+    type TraceRetrieveParams as TraceRetrieveParams,
+  };
 }
 
 export { type RunsArrayPage };

package/src/resources/runs/trace.ts

@@ -0,0 +1,44 @@
+// 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 Trace extends APIResource {
+  /**
+   * Retrieve OTEL trace spans for a run.
+   *
+   * Returns a filtered set of spans relevant for observability:
+   *
+   * - agent_step: Individual agent reasoning steps
+   * - tool executions: Tool call spans
+   * - Root span: The top-level request span
+   * - time_to_first_token: TTFT measurement span
+   *
+   * Requires ClickHouse to be configured for trace storage.
+   */
+  retrieve(
+    runID: string,
+    query: TraceRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TraceRetrieveResponse> {
+    return this._client.get(path`/v1/runs/${runID}/trace`, { query, ...options });
+  }
+}
+
+export type TraceRetrieveResponse = Array<{ [key: string]: unknown }>;
+
+export interface TraceRetrieveParams {
+  /**
+   * Maximum number of spans to return
+   */
+  limit?: number;
+}
+
+export declare namespace Trace {
+  export {
+    type TraceRetrieveResponse as TraceRetrieveResponse,
+    type TraceRetrieveParams as TraceRetrieveParams,
+  };
+}

package/src/resources/tags.ts

@@ -6,7 +6,7 @@ import { RequestOptions } from '../internal/request-options';
 
 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: TagListParams | null | undefined = {}, options?: RequestOptions): APIPromise<TagListResponse> {
     return this._client.get('/v1/tags/', { query, ...options });

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.6.5'; // x-release-please-version
+export const VERSION = '1.6.6'; // x-release-please-version

package/version.d.mts

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