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

package/src/resources/agents/tools.ts

@@ -2,8 +2,10 @@
 
 import { APIResource } from '../../core/resource';
 import * as ToolsAPI from '../tools';
+import { ToolsArrayPage } from '../tools';
 import * as AgentsAPI from './agents';
 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';
 
@@ -15,8 +17,11 @@ export class Tools extends APIResource {
     agentID: string,
     query: ToolListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ToolListResponse> {
-    return this._client.get(path`/v1/agents/${agentID}/tools`, { query, ...options });
+  ): PagePromise<ToolsArrayPage, ToolsAPI.Tool> {
+    return this._client.getAPIList(path`/v1/agents/${agentID}/tools`, ArrayPage<ToolsAPI.Tool>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -63,37 +68,7 @@ export class Tools extends APIResource {
   }
 }
 
-export type ToolListResponse = Array<ToolsAPI.Tool>;
-
-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;
-
-  /**
-   * Maximum number of tools to return
-   */
-  limit?: number | 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';
-}
+export interface ToolListParams extends ArrayPageParams {}
 
 export interface ToolAttachParams {
   /**
@@ -128,10 +103,11 @@ export interface ToolUpdateApprovalParams {
 
 export declare namespace Tools {
   export {
-    type ToolListResponse as ToolListResponse,
     type ToolListParams as ToolListParams,
     type ToolAttachParams as ToolAttachParams,
     type ToolDetachParams as ToolDetachParams,
     type ToolUpdateApprovalParams as ToolUpdateApprovalParams,
   };
 }
+
+export { type ToolsArrayPage };

package/src/resources/archives.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../core/resource';
 import * as ModelsAPI from './models/models';
 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';
 
@@ -28,8 +29,8 @@ export class Archives extends APIResource {
   list(
     query: ArchiveListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ArchiveListResponse> {
-    return this._client.get('/v1/archives/', { query, ...options });
+  ): PagePromise<ArchivesArrayPage, Archive> {
+    return this._client.getAPIList('/v1/archives/', ArrayPage<Archive>, { query, ...options });
   }
 
   /**
@@ -47,6 +48,8 @@ export class Archives extends APIResource {
   }
 }
 
+export type ArchivesArrayPage = ArrayPage<Archive>;
+
 /**
  * Representation of an archive - a collection of archival passages that can be
  * shared between agents.
@@ -58,6 +61,11 @@ export class Archives extends APIResource {
  * archive.
  */
 export interface Archive {
+  /**
+   * The human-friendly ID of the Archive
+   */
+  id: string;
+
   /**
    * The creation date of the archive
    */
@@ -73,11 +81,6 @@ export interface Archive {
    */
   name: string;
 
-  /**
-   * The human-friendly ID of the Archive
-   */
-  id?: string;
-
   /**
    * The id of the user that made this object.
    */
@@ -114,8 +117,6 @@ export interface Archive {
  */
 export type VectorDBProvider = 'native' | 'tpuf' | 'pinecone';
 
-export type ArchiveListResponse = Array<Archive>;
-
 export interface ArchiveCreateParams {
   /**
    * Embedding configuration for the archive
@@ -127,44 +128,16 @@ export interface ArchiveCreateParams {
   description?: string | null;
 }
 
-export interface ArchiveListParams {
-  /**
-   * Archive ID cursor for pagination. Returns archives that come after this archive
-   * ID in the specified sort order
-   */
-  after?: string | null;
-
+export interface ArchiveListParams extends ArrayPageParams {
   /**
    * Only archives attached to this agent ID
    */
   agent_id?: string | null;
 
-  /**
-   * Archive ID cursor for pagination. Returns archives that come before this archive
-   * ID in the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of archives to return
-   */
-  limit?: number | null;
-
   /**
    * Filter by archive name (exact match)
    */
   name?: string | null;
-
-  /**
-   * Sort order for archives by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
 }
 
 export interface ArchiveModifyParams {
@@ -177,7 +150,7 @@ export declare namespace Archives {
   export {
     type Archive as Archive,
     type VectorDBProvider as VectorDBProvider,
-    type ArchiveListResponse as ArchiveListResponse,
+    type ArchivesArrayPage as ArchivesArrayPage,
     type ArchiveCreateParams as ArchiveCreateParams,
     type ArchiveListParams as ArchiveListParams,
     type ArchiveModifyParams as ArchiveModifyParams,

package/src/resources/batches/batches.ts

@@ -4,9 +4,10 @@ import { APIResource } from '../../core/resource';
 import * as AgentsAPI from '../agents/agents';
 import * as MessagesAPI from '../agents/messages';
 import * as BatchesMessagesAPI from './messages';
-import { MessageListParams, MessageListResponse, Messages } from './messages';
+import { MessageListParams, Messages } from './messages';
 import * as RunsAPI from '../runs/runs';
 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';
 
@@ -36,8 +37,8 @@ export class Batches extends APIResource {
   list(
     query: BatchListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<BatchListResponse> {
-    return this._client.get('/v1/messages/batches', { query, ...options });
+  ): PagePromise<BatchJobsArrayPage, BatchJob> {
+    return this._client.getAPIList('/v1/messages/batches', ArrayPage<BatchJob>, { query, ...options });
   }
 
   /**
@@ -48,11 +49,13 @@ export class Batches extends APIResource {
   }
 }
 
+export type BatchJobsArrayPage = ArrayPage<BatchJob>;
+
 export interface BatchJob {
   /**
    * The human-friendly ID of the Job
    */
-  id?: string;
+  id: string;
 
   /**
    * The agent associated with this job/run.
@@ -137,8 +140,6 @@ export interface BatchJob {
   updated_at?: string | null;
 }
 
-export type BatchListResponse = Array<BatchJob>;
-
 export type BatchCancelResponse = unknown;
 
 export interface BatchCreateParams {
@@ -165,11 +166,6 @@ export namespace BatchCreateParams {
      */
     agent_id: string;
 
-    /**
-     * The messages to be sent to the agent.
-     */
-    messages: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate>;
-
     /**
      * @deprecated The name of the message argument in the designated message tool.
      * Still supported for legacy agent types, but deprecated for letta_v1_agent
@@ -195,11 +191,34 @@ export namespace BatchCreateParams {
      */
     include_return_message_types?: Array<MessagesAPI.MessageType> | null;
 
+    /**
+     * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+     * 'user', 'content': input}].
+     */
+    input?:
+      | string
+      | Array<
+          | MessagesAPI.TextContent
+          | MessagesAPI.ImageContent
+          | MessagesAPI.ToolCallContent
+          | MessagesAPI.ToolReturnContent
+          | MessagesAPI.ReasoningContent
+          | MessagesAPI.RedactedReasoningContent
+          | MessagesAPI.OmittedReasoningContent
+          | Request.SummarizedReasoningContent
+        >
+      | null;
+
     /**
      * Maximum number of steps the agent should take to process the request.
      */
     max_steps?: number;
 
+    /**
+     * The messages to be sent to the agent.
+     */
+    messages?: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate> | null;
+
     /**
      * @deprecated Whether the server should parse specific tool call arguments
      * (default `send_message`) as `AssistantMessage` objects. Still supported for
@@ -207,52 +226,61 @@ export namespace BatchCreateParams {
      */
     use_assistant_message?: boolean;
   }
-}
-
-export interface BatchListParams {
-  /**
-   * Job ID cursor for pagination. Returns jobs that come after this job ID in the
-   * specified sort order
-   */
-  after?: string | null;
 
-  /**
-   * Job ID cursor for pagination. Returns jobs that come before this job ID in the
-   * specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of jobs to return
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order for jobs by creation time. 'asc' for oldest first, 'desc' for newest
-   * first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
+  export namespace Request {
+    /**
+     * The style of reasoning content returned by the OpenAI Responses API
+     */
+    export interface SummarizedReasoningContent {
+      /**
+       * The unique identifier for this reasoning step.
+       */
+      id: string;
+
+      /**
+       * Summaries of the reasoning content.
+       */
+      summary: Array<SummarizedReasoningContent.Summary>;
+
+      /**
+       * The encrypted reasoning content.
+       */
+      encrypted_content?: string;
+
+      /**
+       * Indicates this is a summarized reasoning step.
+       */
+      type?: 'summarized_reasoning';
+    }
+
+    export namespace SummarizedReasoningContent {
+      export interface Summary {
+        /**
+         * The index of the summary part.
+         */
+        index: number;
+
+        /**
+         * The text of the summary part.
+         */
+        text: string;
+      }
+    }
+  }
 }
 
+export interface BatchListParams extends ArrayPageParams {}
+
 Batches.Messages = Messages;
 
 export declare namespace Batches {
   export {
     type BatchJob as BatchJob,
-    type BatchListResponse as BatchListResponse,
     type BatchCancelResponse as BatchCancelResponse,
+    type BatchJobsArrayPage as BatchJobsArrayPage,
     type BatchCreateParams as BatchCreateParams,
     type BatchListParams as BatchListParams,
   };
 
-  export {
-    Messages as Messages,
-    type MessageListResponse as MessageListResponse,
-    type MessageListParams as MessageListParams,
-  };
+  export { Messages as Messages, type MessageListParams as MessageListParams };
 }

package/src/resources/batches/index.ts

@@ -3,9 +3,9 @@
 export {
   Batches,
   type BatchJob,
-  type BatchListResponse,
   type BatchCancelResponse,
   type BatchCreateParams,
   type BatchListParams,
+  type BatchJobsArrayPage,
 } from './batches';
-export { Messages, type MessageListResponse, type MessageListParams } from './messages';
+export { Messages, type MessageListParams } from './messages';

package/src/resources/batches/messages.ts

@@ -2,7 +2,8 @@
 
 import { APIResource } from '../../core/resource';
 import * as MessagesAPI from '../agents/messages';
-import { APIPromise } from '../../core/api-promise';
+import { MessagesObjectPage } from '../agents/messages';
+import { ObjectPage, type ObjectPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -14,50 +15,24 @@ export class Messages extends APIResource {
     batchID: string,
     query: MessageListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<MessageListResponse> {
-    return this._client.get(path`/v1/messages/batches/${batchID}/messages`, { query, ...options });
+  ): PagePromise<MessagesObjectPage, MessagesAPI.Message> {
+    return this._client.getAPIList(
+      path`/v1/messages/batches/${batchID}/messages`,
+      ObjectPage<MessagesAPI.Message>,
+      { query, ...options },
+    );
   }
 }
 
-export interface MessageListResponse {
-  messages: Array<MessagesAPI.Message>;
-}
-
-export interface MessageListParams {
-  /**
-   * Message ID cursor for pagination. Returns messages that come after this message
-   * ID in the specified sort order
-   */
-  after?: string | null;
-
+export interface MessageListParams extends ObjectPageParams {
   /**
    * Filter messages by agent ID
    */
   agent_id?: string | null;
-
-  /**
-   * Message ID cursor for pagination. Returns messages that come before this message
-   * ID in the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of messages to return
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order for messages by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
 }
 
 export declare namespace Messages {
-  export { type MessageListResponse as MessageListResponse, type MessageListParams as MessageListParams };
+  export { type MessageListParams as MessageListParams };
 }
+
+export { type MessagesObjectPage };

package/src/resources/blocks/blocks.ts

@@ -42,13 +42,6 @@ export class Blocks extends APIResource {
     return this._client.delete(path`/v1/blocks/${blockID}`, options);
   }
 
-  /**
-   * Count all blocks created by a user.
-   */
-  count(options?: RequestOptions): APIPromise<BlockCountResponse> {
-    return this._client.get('/v1/blocks/count', options);
-  }
-
   /**
    * Modify Block
    */
@@ -230,8 +223,6 @@ export interface CreateBlock {
 
 export type BlockDeleteResponse = unknown;
 
-export type BlockCountResponse = number;
-
 export interface BlockCreateParams {
   /**
    * Label of the block.
@@ -457,7 +448,6 @@ export declare namespace Blocks {
     type BlockResponse as BlockResponse,
     type CreateBlock as CreateBlock,
     type BlockDeleteResponse as BlockDeleteResponse,
-    type BlockCountResponse as BlockCountResponse,
     type BlockResponsesArrayPage as BlockResponsesArrayPage,
     type BlockCreateParams as BlockCreateParams,
     type BlockListParams as BlockListParams,

package/src/resources/blocks/index.ts

@@ -6,7 +6,6 @@ export {
   type BlockResponse,
   type CreateBlock,
   type BlockDeleteResponse,
-  type BlockCountResponse,
   type BlockCreateParams,
   type BlockListParams,
   type BlockModifyParams,