@letta-ai/letta-client 1.6.5 → 1.6.7

package/src/resources/agents/index.ts

@@ -76,7 +76,6 @@ export {
   type FolderDetachParams,
   type FolderListResponsesArrayPage,
 } from './folders';
-export { Groups, type GroupListParams } from './groups';
 export {
   Identities,
   type IdentityAttachResponse,
@@ -138,7 +137,6 @@ export {
   type MessageStreamParams,
   type RunsArrayPage,
   type MessagesArrayPage,
-  type InternalMessagesObjectPage,
 } from './messages';
 export {
   Passages,

package/src/resources/agents/messages.ts

@@ -6,7 +6,7 @@ import * as ToolsAPI from '../tools';
 import * as AgentsAPI from './agents';
 import * as RunsAPI from '../runs/runs';
 import { APIPromise } from '../../core/api-promise';
-import { ArrayPage, type ArrayPageParams, ObjectPage, PagePromise } from '../../core/pagination';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { Stream } from '../../core/streaming';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -146,8 +146,6 @@ export type MessagesArrayPage = ArrayPage<Message>;
 
 export type RunsArrayPage = ArrayPage<Run>;
 
-export type InternalMessagesObjectPage = ObjectPage<InternalMessage>;
-
 /**
  * Input to approve or deny a tool call request
  */
@@ -508,6 +506,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
  */
@@ -562,6 +561,11 @@ export interface InternalMessage {
     | InternalMessage.SummarizedReasoningContent
   > | null;
 
+  /**
+   * The conversation this message belongs to
+   */
+  conversation_id?: string | null;
+
   /**
    * The timestamp when the object was created.
    */
@@ -2050,6 +2054,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.
    */
@@ -2061,12 +2070,6 @@ export interface MessageListParams extends ArrayPageParams {
    */
   include_err?: boolean | null;
 
-  /**
-   * Filter to only return specified message types. If None (default), returns all
-   * message types.
-   */
-  message_types?: Array<MessageType> | null;
-
   /**
    * @deprecated Whether to use assistant messages
    */

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/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

@@ -5,7 +5,6 @@ import * as MessagesAPI from './messages';
 import {
   MessageCreateParams,
   MessageListParams,
-  MessageListResponse,
   MessageStreamParams,
   MessageStreamResponse,
   Messages,
@@ -69,6 +68,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 +94,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 +115,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.
    */
@@ -139,7 +158,6 @@ export declare namespace Conversations {
 
   export {
     Messages as Messages,
-    type MessageListResponse as MessageListResponse,
     type MessageStreamResponse as MessageStreamResponse,
     type MessageCreateParams as MessageCreateParams,
     type MessageListParams as MessageListParams,

package/src/resources/conversations/index.ts

@@ -10,7 +10,6 @@ export {
 } from './conversations';
 export {
   Messages,
-  type MessageListResponse,
   type MessageStreamResponse,
   type MessageCreateParams,
   type MessageListParams,

package/src/resources/conversations/messages.ts

@@ -3,7 +3,9 @@
 import { APIResource } from '../../core/resource';
 import * as AgentsAPI from '../agents/agents';
 import * as MessagesAPI from '../agents/messages';
+import { MessagesArrayPage } from '../agents/messages';
 import { APIPromise } from '../../core/api-promise';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { Stream } from '../../core/streaming';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -31,15 +33,18 @@ export class Messages extends APIResource {
    * List all messages in a conversation.
    *
    * Returns LettaMessage objects (UserMessage, AssistantMessage, etc.) for all
-   * messages in the conversation, ordered by position (oldest first), with support
-   * for cursor-based pagination.
+   * messages in the conversation, with support for cursor-based pagination.
    */
   list(
     conversationID: string,
     query: MessageListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<MessageListResponse> {
-    return this._client.get(path`/v1/conversations/${conversationID}/messages`, { query, ...options });
+  ): PagePromise<MessagesArrayPage, MessagesAPI.Message> {
+    return this._client.getAPIList(
+      path`/v1/conversations/${conversationID}/messages`,
+      ArrayPage<MessagesAPI.Message>,
+      { query, ...options },
+    );
   }
 
   /**
@@ -61,8 +66,6 @@ export class Messages extends APIResource {
   }
 }
 
-export type MessageListResponse = Array<MessagesAPI.Message>;
-
 export type MessageStreamResponse = unknown;
 
 export interface MessageCreateParams {
@@ -223,23 +226,17 @@ export namespace MessageCreateParams {
   }
 }
 
-export interface MessageListParams {
+export interface MessageListParams extends ArrayPageParams {
   /**
-   * Message ID cursor for pagination. Returns messages that come after this message
-   * ID in the conversation
+   * Group ID to filter messages by.
    */
-  after?: string | null;
+  group_id?: string | null;
 
   /**
-   * Message ID cursor for pagination. Returns messages that come before this message
-   * ID in the conversation
+   * Whether to include error messages and error statuses. For debugging purposes
+   * only.
    */
-  before?: string | null;
-
-  /**
-   * Maximum number of messages to return
-   */
-  limit?: number | null;
+  include_err?: boolean | null;
 }
 
 export interface MessageStreamParams {
@@ -268,10 +265,11 @@ export interface MessageStreamParams {
 
 export declare namespace Messages {
   export {
-    type MessageListResponse as MessageListResponse,
     type MessageStreamResponse as MessageStreamResponse,
     type MessageCreateParams as MessageCreateParams,
     type MessageListParams as MessageListParams,
     type MessageStreamParams as MessageStreamParams,
   };
 }
+
+export { type MessagesArrayPage };

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/index.ts

@@ -58,14 +58,6 @@ export {
   type ArchiveListParams,
   type ArchivesArrayPage,
 } from './archives/archives';
-export {
-  Batches,
-  type BatchJob,
-  type BatchCancelResponse,
-  type BatchCreateParams,
-  type BatchListParams,
-  type BatchJobsArrayPage,
-} from './batches/batches';
 export {
   Blocks,
   type BlockResponse,
@@ -93,33 +85,6 @@ export {
   type FolderListParams,
   type FoldersArrayPage,
 } from './folders/folders';
-export {
-  Groups,
-  type DynamicManager,
-  type Group,
-  type ManagerType,
-  type RoundRobinManager,
-  type SleeptimeManager,
-  type SupervisorManager,
-  type VoiceSleeptimeManager,
-  type GroupDeleteResponse,
-  type GroupCreateParams,
-  type GroupUpdateParams,
-  type GroupListParams,
-  type GroupsArrayPage,
-} from './groups/groups';
-export {
-  Identities,
-  type Identity,
-  type IdentityProperty,
-  type IdentityType,
-  type IdentityDeleteResponse,
-  type IdentityCreateParams,
-  type IdentityUpdateParams,
-  type IdentityListParams,
-  type IdentityUpsertParams,
-  type IdentitiesArrayPage,
-} from './identities/identities';
 export {
   McpServers,
   type CreateSseMcpServer,
@@ -144,6 +109,7 @@ export {
   Messages,
   type MessageSearchRequest,
   type MessageSearchResult,
+  type MessageRetrieveResponse,
   type MessageListResponse,
   type MessageSearchResponse,
   type MessageListParams,

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

@@ -4,8 +4,16 @@ import { APIResource } from '../core/resource';
 import * as AgentsMessagesAPI from './agents/messages';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
 
 export class Messages extends APIResource {
+  /**
+   * Retrieve a message by ID.
+   */
+  retrieve(messageID: string, options?: RequestOptions): APIPromise<MessageRetrieveResponse> {
+    return this._client.get(path`/v1/messages/${messageID}`, options);
+  }
+
   /**
    * List messages across all agents for the current user.
    */
@@ -38,6 +46,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
    */
@@ -89,6 +102,8 @@ export interface MessageSearchResult {
   vector_rank?: number | null;
 }
 
+export type MessageRetrieveResponse = Array<AgentsMessagesAPI.Message>;
+
 export type MessageListResponse = Array<AgentsMessagesAPI.Message>;
 
 export type MessageSearchResponse = Array<
@@ -233,6 +248,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 +276,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
    */
@@ -281,6 +306,7 @@ export declare namespace Messages {
   export {
     type MessageSearchRequest as MessageSearchRequest,
     type MessageSearchResult as MessageSearchResult,
+    type MessageRetrieveResponse as MessageRetrieveResponse,
     type MessageListResponse as MessageListResponse,
     type MessageSearchResponse as MessageSearchResponse,
     type MessageListParams as MessageListParams,

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.7'; // 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.7";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

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

package/version.mjs

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

package/resources/agents/groups.d.mts

@@ -1,22 +0,0 @@
-import { APIResource } from "../../core/resource.mjs";
-import * as GroupsGroupsAPI from "../groups/groups.mjs";
-import { GroupsArrayPage } from "../groups/groups.mjs";
-import { type ArrayPageParams, PagePromise } from "../../core/pagination.mjs";
-import { RequestOptions } from "../../internal/request-options.mjs";
-export declare class Groups extends APIResource {
-    /**
-     * Lists the groups for an agent.
-     */
-    list(agentID: string, query?: GroupListParams | null | undefined, options?: RequestOptions): PagePromise<GroupsArrayPage, GroupsGroupsAPI.Group>;
-}
-export interface GroupListParams extends ArrayPageParams {
-    /**
-     * Manager type to filter groups by
-     */
-    manager_type?: string | null;
-}
-export declare namespace Groups {
-    export { type GroupListParams as GroupListParams };
-}
-export { type GroupsArrayPage };
-//# sourceMappingURL=groups.d.mts.map

package/resources/agents/groups.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"groups.d.mts","sourceRoot":"","sources":["../../src/resources/agents/groups.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,eAAe;OACpB,EAAE,eAAe,EAAE;OACnB,EAAa,KAAK,eAAe,EAAE,WAAW,EAAE;OAChD,EAAE,cAAc,EAAE;AAGzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,eAAe,EAAE,eAAe,CAAC,KAAK,CAAC;CAMvD;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EAAE,KAAK,eAAe,IAAI,eAAe,EAAE,CAAC;CACpD;AAED,OAAO,EAAE,KAAK,eAAe,EAAE,CAAC"}

package/resources/agents/groups.d.ts

@@ -1,22 +0,0 @@
-import { APIResource } from "../../core/resource.js";
-import * as GroupsGroupsAPI from "../groups/groups.js";
-import { GroupsArrayPage } from "../groups/groups.js";
-import { type ArrayPageParams, PagePromise } from "../../core/pagination.js";
-import { RequestOptions } from "../../internal/request-options.js";
-export declare class Groups extends APIResource {
-    /**
-     * Lists the groups for an agent.
-     */
-    list(agentID: string, query?: GroupListParams | null | undefined, options?: RequestOptions): PagePromise<GroupsArrayPage, GroupsGroupsAPI.Group>;
-}
-export interface GroupListParams extends ArrayPageParams {
-    /**
-     * Manager type to filter groups by
-     */
-    manager_type?: string | null;
-}
-export declare namespace Groups {
-    export { type GroupListParams as GroupListParams };
-}
-export { type GroupsArrayPage };
-//# sourceMappingURL=groups.d.ts.map

package/resources/agents/groups.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../src/resources/agents/groups.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,eAAe;OACpB,EAAE,eAAe,EAAE;OACnB,EAAa,KAAK,eAAe,EAAE,WAAW,EAAE;OAChD,EAAE,cAAc,EAAE;AAGzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,eAAe,EAAE,eAAe,CAAC,KAAK,CAAC;CAMvD;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EAAE,KAAK,eAAe,IAAI,eAAe,EAAE,CAAC;CACpD;AAED,OAAO,EAAE,KAAK,eAAe,EAAE,CAAC"}