@letta-ai/letta-client 1.0.0-alpha.7 → 1.1.0

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 { InternalMessagesObjectPage } 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<InternalMessagesObjectPage, MessagesAPI.InternalMessage> {
+    return this._client.getAPIList(
+      path`/v1/messages/batches/${batchID}/messages`,
+      ObjectPage<MessagesAPI.InternalMessage>,
+      { 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 InternalMessagesObjectPage };

package/src/resources/blocks/agents.ts

@@ -2,7 +2,8 @@
 
 import { APIResource } from '../../core/resource';
 import * as AgentsAPI from '../agents/agents';
-import { APIPromise } from '../../core/api-promise';
+import { AgentStatesArrayPage } from '../agents/agents';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -15,26 +16,15 @@ export class Agents extends APIResource {
     blockID: string,
     query: AgentListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<AgentListResponse> {
-    return this._client.get(path`/v1/blocks/${blockID}/agents`, { query, ...options });
+  ): PagePromise<AgentStatesArrayPage, AgentsAPI.AgentState> {
+    return this._client.getAPIList(path`/v1/blocks/${blockID}/agents`, ArrayPage<AgentsAPI.AgentState>, {
+      query,
+      ...options,
+    });
   }
 }
 
-export type AgentListResponse = Array<AgentsAPI.AgentState>;
-
-export interface AgentListParams {
-  /**
-   * Agent ID cursor for pagination. Returns agents that come after this agent ID in
-   * the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Agent ID cursor for pagination. Returns agents that come before this agent ID in
-   * the specified sort order
-   */
-  before?: string | null;
-
+export interface AgentListParams extends ArrayPageParams {
   /**
    * Specify which relational fields to include in the response. No relationships are
    * included by default.
@@ -56,24 +46,10 @@ export interface AgentListParams {
    * parameter, and no longer supported after 1.0.0 SDK versions.
    */
   include_relationships?: Array<string> | null;
-
-  /**
-   * Maximum number of agents to return
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order for agents 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 Agents {
-  export { type AgentListResponse as AgentListResponse, type AgentListParams as AgentListParams };
+  export { type AgentListParams as AgentListParams };
 }
+
+export { type AgentStatesArrayPage };

package/src/resources/blocks/blocks.ts

@@ -1,10 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as BlocksAPI from '../agents/blocks';
 import * as AgentsAPI from './agents';
-import { AgentListParams, AgentListResponse, Agents } from './agents';
+import { AgentListParams, Agents } 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';
 
@@ -14,21 +14,21 @@ export class Blocks extends APIResource {
   /**
    * Create Block
    */
-  create(body: BlockCreateParams, options?: RequestOptions): APIPromise<BlocksAPI.Block> {
+  create(body: BlockCreateParams, options?: RequestOptions): APIPromise<BlockResponse> {
     return this._client.post('/v1/blocks/', { body, ...options });
   }
 
   /**
    * Retrieve Block
    */
-  retrieve(blockID: string, options?: RequestOptions): APIPromise<BlocksAPI.Block> {
+  retrieve(blockID: string, options?: RequestOptions): APIPromise<BlockResponse> {
     return this._client.get(path`/v1/blocks/${blockID}`, options);
   }
 
   /**
-   * Modify Block
+   * Update Block
    */
-  update(blockID: string, body: BlockUpdateParams, options?: RequestOptions): APIPromise<BlocksAPI.Block> {
+  update(blockID: string, body: BlockUpdateParams, options?: RequestOptions): APIPromise<BlockResponse> {
     return this._client.patch(path`/v1/blocks/${blockID}`, { body, ...options });
   }
 
@@ -38,8 +38,8 @@ export class Blocks extends APIResource {
   list(
     query: BlockListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<BlockListResponse> {
-    return this._client.get('/v1/blocks/', { query, ...options });
+  ): PagePromise<BlockResponsesArrayPage, BlockResponse> {
+    return this._client.getAPIList('/v1/blocks/', ArrayPage<BlockResponse>, { query, ...options });
   }
 
   /**
@@ -48,13 +48,100 @@ export class Blocks extends APIResource {
   delete(blockID: string, options?: RequestOptions): APIPromise<unknown> {
     return this._client.delete(path`/v1/blocks/${blockID}`, options);
   }
+}
+
+export type BlockResponsesArrayPage = ArrayPage<BlockResponse>;
 
+export interface BlockResponse {
   /**
-   * Count all blocks created by a user.
+   * The id of the block.
    */
-  count(options?: RequestOptions): APIPromise<BlockCountResponse> {
-    return this._client.get('/v1/blocks/count', options);
-  }
+  id: string;
+
+  /**
+   * Value of the block.
+   */
+  value: string;
+
+  /**
+   * @deprecated (Deprecated) The base template id of the block.
+   */
+  base_template_id?: string | null;
+
+  /**
+   * The id of the user that made this Block.
+   */
+  created_by_id?: string | null;
+
+  /**
+   * @deprecated (Deprecated) The id of the deployment.
+   */
+  deployment_id?: string | null;
+
+  /**
+   * Description of the block.
+   */
+  description?: string | null;
+
+  /**
+   * @deprecated (Deprecated) The id of the entity within the template.
+   */
+  entity_id?: string | null;
+
+  /**
+   * @deprecated (Deprecated) If set to True, the block will be hidden.
+   */
+  hidden?: boolean | null;
+
+  /**
+   * Whether the block is a template (e.g. saved human/persona options).
+   */
+  is_template?: boolean;
+
+  /**
+   * Label of the block (e.g. 'human', 'persona') in the context window.
+   */
+  label?: string | null;
+
+  /**
+   * The id of the user that last updated this Block.
+   */
+  last_updated_by_id?: string | null;
+
+  /**
+   * Character limit of the block.
+   */
+  limit?: number;
+
+  /**
+   * Metadata of the block.
+   */
+  metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * @deprecated (Deprecated) Preserve the block on template migration.
+   */
+  preserve_on_migration?: boolean | null;
+
+  /**
+   * The associated project id.
+   */
+  project_id?: string | null;
+
+  /**
+   * @deprecated (Deprecated) Whether the agent has read-only access to the block.
+   */
+  read_only?: boolean;
+
+  /**
+   * @deprecated (Deprecated) The id of the template.
+   */
+  template_id?: string | null;
+
+  /**
+   * @deprecated (Deprecated) The name of the block template (if it is a template).
+   */
+  template_name?: string | null;
 }
 
 /**
@@ -108,11 +195,6 @@ export interface CreateBlock {
    */
   metadata?: { [key: string]: unknown } | null;
 
-  /**
-   * The id of the template.
-   */
-  name?: string | null;
-
   /**
    * Preserve the block on template migration.
    */
@@ -127,13 +209,19 @@ export interface CreateBlock {
    * Whether the agent has read-only access to the block.
    */
   read_only?: boolean;
-}
 
-export type BlockListResponse = Array<BlocksAPI.Block>;
+  /**
+   * The id of the template.
+   */
+  template_id?: string | null;
 
-export type BlockDeleteResponse = unknown;
+  /**
+   * Name of the block if it is a template.
+   */
+  template_name?: string | null;
+}
 
-export type BlockCountResponse = number;
+export type BlockDeleteResponse = unknown;
 
 export interface BlockCreateParams {
   /**
@@ -183,11 +271,6 @@ export interface BlockCreateParams {
    */
   metadata?: { [key: string]: unknown } | null;
 
-  /**
-   * The id of the template.
-   */
-  name?: string | null;
-
   /**
    * Preserve the block on template migration.
    */
@@ -202,6 +285,16 @@ export interface BlockCreateParams {
    * Whether the agent has read-only access to the block.
    */
   read_only?: boolean;
+
+  /**
+   * The id of the template.
+   */
+  template_id?: string | null;
+
+  /**
+   * Name of the block if it is a template.
+   */
+  template_name?: string | null;
 }
 
 export interface BlockUpdateParams {
@@ -250,11 +343,6 @@ export interface BlockUpdateParams {
    */
   metadata?: { [key: string]: unknown } | null;
 
-  /**
-   * The id of the template.
-   */
-  name?: string | null;
-
   /**
    * Preserve the block on template migration.
    */
@@ -271,24 +359,22 @@ export interface BlockUpdateParams {
   read_only?: boolean;
 
   /**
-   * Value of the block.
+   * The id of the template.
    */
-  value?: string | null;
-}
+  template_id?: string | null;
 
-export interface BlockListParams {
   /**
-   * Block ID cursor for pagination. Returns blocks that come after this block ID in
-   * the specified sort order
+   * Name of the block if it is a template.
    */
-  after?: string | null;
+  template_name?: string | null;
 
   /**
-   * Block ID cursor for pagination. Returns blocks that come before this block ID in
-   * the specified sort order
+   * Value of the block.
    */
-  before?: string | null;
+  value?: string | null;
+}
 
+export interface BlockListParams extends ArrayPageParams {
   /**
    * Filter blocks by the exact number of connected agents. If provided, returns
    * blocks that have exactly this number of connected agents.
@@ -334,27 +420,11 @@ export interface BlockListParams {
    */
   label_search?: string | null;
 
-  /**
-   * Number of blocks to return
-   */
-  limit?: number | null;
-
   /**
    * Name of the block
    */
   name?: string | null;
 
-  /**
-   * Sort order for blocks by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
-
   /**
    * Search blocks by project id
    */
@@ -375,18 +445,14 @@ Blocks.Agents = Agents;
 
 export declare namespace Blocks {
   export {
+    type BlockResponse as BlockResponse,
     type CreateBlock as CreateBlock,
-    type BlockListResponse as BlockListResponse,
     type BlockDeleteResponse as BlockDeleteResponse,
-    type BlockCountResponse as BlockCountResponse,
+    type BlockResponsesArrayPage as BlockResponsesArrayPage,
     type BlockCreateParams as BlockCreateParams,
     type BlockUpdateParams as BlockUpdateParams,
     type BlockListParams as BlockListParams,
   };
 
-  export {
-    Agents as Agents,
-    type AgentListResponse as AgentListResponse,
-    type AgentListParams as AgentListParams,
-  };
+  export { Agents as Agents, type AgentListParams as AgentListParams };
 }

package/src/resources/blocks/index.ts

@@ -1,13 +1,13 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Agents, type AgentListResponse, type AgentListParams } from './agents';
+export { Agents, type AgentListParams } from './agents';
 export {
   Blocks,
+  type BlockResponse,
   type CreateBlock,
-  type BlockListResponse,
   type BlockDeleteResponse,
-  type BlockCountResponse,
   type BlockCreateParams,
   type BlockUpdateParams,
   type BlockListParams,
+  type BlockResponsesArrayPage,
 } from './blocks';