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

package/src/resources/agents/archives.ts

@@ -0,0 +1,51 @@
+// 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 Archives extends APIResource {
+  /**
+   * Attach an archive to an agent.
+   */
+  attach(archiveID: string, params: ArchiveAttachParams, options?: RequestOptions): APIPromise<unknown> {
+    const { agent_id } = params;
+    return this._client.patch(path`/v1/agents/${agent_id}/archives/attach/${archiveID}`, options);
+  }
+
+  /**
+   * Detach an archive from an agent.
+   */
+  detach(archiveID: string, params: ArchiveDetachParams, options?: RequestOptions): APIPromise<unknown> {
+    const { agent_id } = params;
+    return this._client.patch(path`/v1/agents/${agent_id}/archives/detach/${archiveID}`, options);
+  }
+}
+
+export type ArchiveAttachResponse = unknown;
+
+export type ArchiveDetachResponse = unknown;
+
+export interface ArchiveAttachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
+  agent_id: string;
+}
+
+export interface ArchiveDetachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
+  agent_id: string;
+}
+
+export declare namespace Archives {
+  export {
+    type ArchiveAttachResponse as ArchiveAttachResponse,
+    type ArchiveDetachResponse as ArchiveDetachResponse,
+    type ArchiveAttachParams as ArchiveAttachParams,
+    type ArchiveDetachParams as ArchiveDetachParams,
+  };
+}

package/src/resources/agents/blocks.ts

@@ -2,7 +2,10 @@
 
 import { APIResource } from '../../core/resource';
 import * as AgentsAPI from './agents';
+import * as BlocksBlocksAPI from '../blocks/blocks';
+import { BlockResponsesArrayPage } from '../blocks/blocks';
 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';
 
@@ -10,7 +13,11 @@ export class Blocks extends APIResource {
   /**
    * Retrieve a core memory block from an agent.
    */
-  retrieve(blockLabel: string, params: BlockRetrieveParams, options?: RequestOptions): APIPromise<Block> {
+  retrieve(
+    blockLabel: string,
+    params: BlockRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<BlocksBlocksAPI.BlockResponse> {
     const { agent_id } = params;
     return this._client.get(path`/v1/agents/${agent_id}/core-memory/blocks/${blockLabel}`, options);
   }
@@ -18,7 +25,11 @@ export class Blocks extends APIResource {
   /**
    * Updates a core memory block of an agent.
    */
-  update(blockLabel: string, params: BlockUpdateParams, options?: RequestOptions): APIPromise<Block> {
+  update(
+    blockLabel: string,
+    params: BlockUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<BlocksBlocksAPI.BlockResponse> {
     const { agent_id, ...body } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/core-memory/blocks/${blockLabel}`, {
       body,
@@ -33,8 +44,12 @@ export class Blocks extends APIResource {
     agentID: string,
     query: BlockListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<BlockListResponse> {
-    return this._client.get(path`/v1/agents/${agentID}/core-memory/blocks`, { query, ...options });
+  ): PagePromise<BlockResponsesArrayPage, BlocksBlocksAPI.BlockResponse> {
+    return this._client.getAPIList(
+      path`/v1/agents/${agentID}/core-memory/blocks`,
+      ArrayPage<BlocksBlocksAPI.BlockResponse>,
+      { query, ...options },
+    );
   }
 
   /**
@@ -63,21 +78,7 @@ export class Blocks extends APIResource {
 }
 
 /**
- * A Block represents a reserved section of the LLM's context window which is
- * editable. `Block` objects contained in the `Memory` object, which is able to
- * edit the Block values.
- *
- * Parameters: label (str): The label of the block (e.g. 'human', 'persona'). This
- * defines a category for the block. value (str): The value of the block. This is
- * the string that is represented in the context window. limit (int): The character
- * limit of the block. is_template (bool): Whether the block is a template (e.g.
- * saved human/persona options). Non-template blocks are not stored in the database
- * and are ephemeral, while templated blocks are stored in the database. label
- * (str): The label of the block (e.g. 'human', 'persona'). This defines a category
- * for the block. template_name (str): The name of the block template (if it is a
- * template). description (str): Description of the block. metadata (Dict):
- * Metadata of the block. user_id (str): The unique identifier of the user
- * associated with the block.
+ * A Block represents a reserved section of the LLM's context window.
  */
 export interface Block {
   /**
@@ -145,11 +146,6 @@ export interface Block {
    */
   metadata?: { [key: string]: unknown } | null;
 
-  /**
-   * The id of the template.
-   */
-  name?: string | null;
-
   /**
    * Preserve the block on template migration.
    */
@@ -164,6 +160,16 @@ export interface Block {
    * 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;
 }
 
 /**
@@ -215,11 +221,6 @@ export interface BlockUpdate {
    */
   metadata?: { [key: string]: unknown } | null;
 
-  /**
-   * The id of the template.
-   */
-  name?: string | null;
-
   /**
    * Preserve the block on template migration.
    */
@@ -235,14 +236,22 @@ export interface BlockUpdate {
    */
   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;
+
   /**
    * Value of the block.
    */
   value?: string | null;
 }
 
-export type BlockListResponse = Array<Block>;
-
 export interface BlockRetrieveParams {
   /**
    * The ID of the agent in the format 'agent-<uuid4>'
@@ -301,11 +310,6 @@ export interface BlockUpdateParams {
    */
   metadata?: { [key: string]: unknown } | null;
 
-  /**
-   * Body param: The id of the template.
-   */
-  name?: string | null;
-
   /**
    * Body param: Preserve the block on template migration.
    */
@@ -322,41 +326,23 @@ export interface BlockUpdateParams {
   read_only?: boolean;
 
   /**
-   * Body param: Value of the block.
-   */
-  value?: string | null;
-}
-
-export interface BlockListParams {
-  /**
-   * Block ID cursor for pagination. Returns blocks that come after this block ID in
-   * the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Block ID cursor for pagination. Returns blocks that come before this block ID in
-   * the specified sort order
+   * Body param: The id of the template.
    */
-  before?: string | null;
+  template_id?: string | null;
 
   /**
-   * Maximum number of blocks to return
+   * Body param: Name of the block if it is a template.
    */
-  limit?: number | null;
+  template_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
+   * Body param: Value of the block.
    */
-  order_by?: 'created_at';
+  value?: string | null;
 }
 
+export interface BlockListParams extends ArrayPageParams {}
+
 export interface BlockAttachParams {
   /**
    * The ID of the agent in the format 'agent-<uuid4>'
@@ -375,7 +361,6 @@ export declare namespace Blocks {
   export {
     type Block as Block,
     type BlockUpdate as BlockUpdate,
-    type BlockListResponse as BlockListResponse,
     type BlockRetrieveParams as BlockRetrieveParams,
     type BlockUpdateParams as BlockUpdateParams,
     type BlockListParams as BlockListParams,
@@ -383,3 +368,5 @@ export declare namespace Blocks {
     type BlockDetachParams as BlockDetachParams,
   };
 }
+
+export { type BlockResponsesArrayPage };

package/src/resources/agents/files.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
+import { NextFilesPage, type NextFilesPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -13,8 +14,11 @@ export class Files extends APIResource {
     agentID: string,
     query: FileListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<FileListResponse> {
-    return this._client.get(path`/v1/agents/${agentID}/files`, { query, ...options });
+  ): PagePromise<FileListResponsesNextFilesPage, FileListResponse> {
+    return this._client.getAPIList(path`/v1/agents/${agentID}/files`, NextFilesPage<FileListResponse>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -51,128 +55,80 @@ export class Files extends APIResource {
   }
 }
 
+export type FileListResponsesNextFilesPage = NextFilesPage<FileListResponse>;
+
 /**
- * Paginated response for agent files
+ * Response model for agent file attachments showing file status in agent context
  */
 export interface FileListResponse {
   /**
-   * List of file attachments for the agent
+   * Unique identifier of the file-agent relationship
    */
-  files: Array<FileListResponse.File>;
+  id: string;
 
   /**
-   * Whether more results exist after this page
+   * Unique identifier of the file
    */
-  has_more: boolean;
+  file_id: string;
 
   /**
-   * Cursor for fetching the next page (file-agent relationship ID)
+   * Name of the file
    */
-  next_cursor?: string | null;
-}
-
-export namespace FileListResponse {
-  /**
-   * Response model for agent file attachments showing file status in agent context
-   */
-  export interface File {
-    /**
-     * Unique identifier of the file-agent relationship
-     */
-    id: string;
-
-    /**
-     * Unique identifier of the file
-     */
-    file_id: string;
-
-    /**
-     * Name of the file
-     */
-    file_name: string;
-
-    /**
-     * Unique identifier of the folder/source
-     */
-    folder_id: string;
-
-    /**
-     * Name of the folder/source
-     */
-    folder_name: string;
-
-    /**
-     * Whether the file is currently open in the agent's context
-     */
-    is_open: boolean;
-
-    /**
-     * Ending line number if file was opened with line range
-     */
-    end_line?: number | null;
-
-    /**
-     * Timestamp of last access by the agent
-     */
-    last_accessed_at?: string | null;
-
-    /**
-     * Starting line number if file was opened with line range
-     */
-    start_line?: number | null;
-
-    /**
-     * Portion of the file visible to the agent if open
-     */
-    visible_content?: string | null;
-  }
-}
-
-export type FileCloseResponse = unknown;
+  file_name: string;
 
-export type FileCloseAllResponse = Array<string>;
+  /**
+   * Unique identifier of the folder/source
+   */
+  folder_id: string;
 
-export type FileOpenResponse = Array<string>;
+  /**
+   * Name of the folder/source
+   */
+  folder_name: string;
 
-export interface FileListParams {
   /**
-   * File ID cursor for pagination. Returns files that come after this file ID in the
-   * specified sort order
+   * Whether the file is currently open in the agent's context
    */
-  after?: string | null;
+  is_open: boolean;
 
   /**
-   * File ID cursor for pagination. Returns files that come before this file ID in
-   * the specified sort order
+   * Ending line number if file was opened with line range
    */
-  before?: string | null;
+  end_line?: number | null;
 
   /**
-   * @deprecated Pagination cursor from previous response (deprecated, use
-   * before/after)
+   * Timestamp of last access by the agent
    */
-  cursor?: string | null;
+  last_accessed_at?: string | null;
 
   /**
-   * Filter by open status (true for open files, false for closed files)
+   * Starting line number if file was opened with line range
    */
-  is_open?: boolean | null;
+  start_line?: number | null;
 
   /**
-   * Maximum number of files to return
+   * Portion of the file visible to the agent if open
    */
-  limit?: number | null;
+  visible_content?: string | null;
+}
+
+export type FileCloseResponse = unknown;
+
+export type FileCloseAllResponse = Array<string>;
 
+export type FileOpenResponse = Array<string>;
+
+export interface FileListParams extends NextFilesPageParams {
   /**
-   * Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest
-   * first
+   * @deprecated Pagination cursor from previous response (deprecated, use
+   * before/after)
    */
-  order?: 'asc' | 'desc';
+  cursor?: string | null;
 
   /**
-   * Field to sort by
+   * Filter by open status (true for open files, false for closed files)
    */
-  order_by?: 'created_at';
+  is_open?: boolean | null;
 }
 
 export interface FileCloseParams {
@@ -195,6 +151,7 @@ export declare namespace Files {
     type FileCloseResponse as FileCloseResponse,
     type FileCloseAllResponse as FileCloseAllResponse,
     type FileOpenResponse as FileOpenResponse,
+    type FileListResponsesNextFilesPage as FileListResponsesNextFilesPage,
     type FileListParams as FileListParams,
     type FileCloseParams as FileCloseParams,
     type FileOpenParams as FileOpenParams,

package/src/resources/agents/folders.ts

@@ -1,10 +1,11 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as ArchivesAPI from '../archives';
 import * as AgentsAPI from './agents';
+import * as ArchivesAPI from '../archives/archives';
 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';
 
@@ -16,8 +17,11 @@ export class Folders extends APIResource {
     agentID: string,
     query: FolderListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<FolderListResponse> {
-    return this._client.get(path`/v1/agents/${agentID}/folders`, { query, ...options });
+  ): PagePromise<FolderListResponsesArrayPage, FolderListResponse> {
+    return this._client.getAPIList(path`/v1/agents/${agentID}/folders`, ArrayPage<FolderListResponse>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -27,7 +31,7 @@ export class Folders extends APIResource {
     folderID: string,
     params: FolderAttachParams,
     options?: RequestOptions,
-  ): APIPromise<AgentsAPI.AgentState> {
+  ): APIPromise<AgentsAPI.AgentState | null> {
     const { agent_id } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/folders/attach/${folderID}`, options);
   }
@@ -39,112 +43,77 @@ export class Folders extends APIResource {
     folderID: string,
     params: FolderDetachParams,
     options?: RequestOptions,
-  ): APIPromise<AgentsAPI.AgentState> {
+  ): APIPromise<AgentsAPI.AgentState | null> {
     const { agent_id } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/folders/detach/${folderID}`, options);
   }
 }
 
-export type FolderListResponse = Array<FolderListResponse.FolderListResponseItem>;
-
-export namespace FolderListResponse {
-  /**
-   * Representation of a source, which is a collection of files and passages.
-   *
-   * Parameters: id (str): The ID of the source name (str): The name of the source.
-   * embedding_config (EmbeddingConfig): The embedding configuration used by the
-   * source. user_id (str): The ID of the user that created the source. metadata
-   * (dict): Metadata associated with the source. description (str): The description
-   * of the source.
-   */
-  export interface FolderListResponseItem {
-    /**
-     * The embedding configuration used by the source.
-     */
-    embedding_config: ModelsAPI.EmbeddingConfig;
-
-    /**
-     * The name of the source.
-     */
-    name: string;
-
-    /**
-     * The human-friendly ID of the Source
-     */
-    id?: string;
-
-    /**
-     * The timestamp when the source was created.
-     */
-    created_at?: string | null;
-
-    /**
-     * The id of the user that made this Tool.
-     */
-    created_by_id?: string | null;
-
-    /**
-     * The description of the source.
-     */
-    description?: string | null;
-
-    /**
-     * Instructions for how to use the source.
-     */
-    instructions?: string | null;
-
-    /**
-     * The id of the user that made this Tool.
-     */
-    last_updated_by_id?: string | null;
-
-    /**
-     * Metadata associated with the source.
-     */
-    metadata?: { [key: string]: unknown } | null;
-
-    /**
-     * The timestamp when the source was last updated.
-     */
-    updated_at?: string | null;
-
-    /**
-     * The vector database provider used for this source's passages
-     */
-    vector_db_provider?: ArchivesAPI.VectorDBProvider;
-  }
-}
+export type FolderListResponsesArrayPage = ArrayPage<FolderListResponse>;
+
+/**
+ * (Deprecated: Use Folder) Representation of a source, which is a collection of
+ * files and passages.
+ */
+export interface FolderListResponse {
+  /**
+   * The human-friendly ID of the Source
+   */
+  id: string;
+
+  /**
+   * The embedding configuration used by the source.
+   */
+  embedding_config: ModelsAPI.EmbeddingConfig;
+
+  /**
+   * The name of the source.
+   */
+  name: string;
 
-export interface FolderListParams {
   /**
-   * Source ID cursor for pagination. Returns sources that come after this source ID
-   * in the specified sort order
+   * The timestamp when the source was created.
    */
-  after?: string | null;
+  created_at?: string | null;
 
   /**
-   * Source ID cursor for pagination. Returns sources that come before this source ID
-   * in the specified sort order
+   * The id of the user that made this Tool.
    */
-  before?: string | null;
+  created_by_id?: string | null;
 
   /**
-   * Maximum number of sources to return
+   * The description of the source.
    */
-  limit?: number | null;
+  description?: string | null;
 
   /**
-   * Sort order for sources by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
+   * Instructions for how to use the source.
    */
-  order?: 'asc' | 'desc';
+  instructions?: string | null;
 
   /**
-   * Field to sort by
+   * The id of the user that made this Tool.
    */
-  order_by?: 'created_at';
+  last_updated_by_id?: string | null;
+
+  /**
+   * Metadata associated with the source.
+   */
+  metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * The timestamp when the source was last updated.
+   */
+  updated_at?: string | null;
+
+  /**
+   * The vector database provider used for this source's passages
+   */
+  vector_db_provider?: ArchivesAPI.VectorDBProvider;
 }
 
+export interface FolderListParams extends ArrayPageParams {}
+
 export interface FolderAttachParams {
   /**
    * The ID of the agent in the format 'agent-<uuid4>'
@@ -162,6 +131,7 @@ export interface FolderDetachParams {
 export declare namespace Folders {
   export {
     type FolderListResponse as FolderListResponse,
+    type FolderListResponsesArrayPage as FolderListResponsesArrayPage,
     type FolderListParams as FolderListParams,
     type FolderAttachParams as FolderAttachParams,
     type FolderDetachParams as FolderDetachParams,