@letta-ai/letta-client 1.0.0-alpha.6 → 1.0.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

@@ -0,0 +1,372 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+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';
+
+export class Blocks extends APIResource {
+  /**
+   * Retrieve a core memory block from an agent.
+   */
+  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);
+  }
+
+  /**
+   * Updates a core memory block of an agent.
+   */
+  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,
+      ...options,
+    });
+  }
+
+  /**
+   * Retrieve the core memory blocks of a specific agent.
+   */
+  list(
+    agentID: string,
+    query: BlockListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<BlockResponsesArrayPage, BlocksBlocksAPI.BlockResponse> {
+    return this._client.getAPIList(
+      path`/v1/agents/${agentID}/core-memory/blocks`,
+      ArrayPage<BlocksBlocksAPI.BlockResponse>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Attach a core memory block to an agent.
+   */
+  attach(
+    blockID: string,
+    params: BlockAttachParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentsAPI.AgentState> {
+    const { agent_id } = params;
+    return this._client.patch(path`/v1/agents/${agent_id}/core-memory/blocks/attach/${blockID}`, options);
+  }
+
+  /**
+   * Detach a core memory block from an agent.
+   */
+  detach(
+    blockID: string,
+    params: BlockDetachParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentsAPI.AgentState> {
+    const { agent_id } = params;
+    return this._client.patch(path`/v1/agents/${agent_id}/core-memory/blocks/detach/${blockID}`, options);
+  }
+}
+
+/**
+ * A Block represents a reserved section of the LLM's context window.
+ */
+export interface Block {
+  /**
+   * Value of the block.
+   */
+  value: string;
+
+  /**
+   * The human-friendly ID of the Block
+   */
+  id?: string;
+
+  /**
+   * 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;
+
+  /**
+   * The id of the deployment.
+   */
+  deployment_id?: string | null;
+
+  /**
+   * Description of the block.
+   */
+  description?: string | null;
+
+  /**
+   * The id of the entity within the template.
+   */
+  entity_id?: string | null;
+
+  /**
+   * 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;
+
+  /**
+   * Preserve the block on template migration.
+   */
+  preserve_on_migration?: boolean | null;
+
+  /**
+   * The associated project id.
+   */
+  project_id?: string | null;
+
+  /**
+   * 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;
+}
+
+/**
+ * Update a block
+ */
+export interface BlockUpdate {
+  /**
+   * The base template id of the block.
+   */
+  base_template_id?: string | null;
+
+  /**
+   * The id of the deployment.
+   */
+  deployment_id?: string | null;
+
+  /**
+   * Description of the block.
+   */
+  description?: string | null;
+
+  /**
+   * The id of the entity within the template.
+   */
+  entity_id?: string | null;
+
+  /**
+   * 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;
+
+  /**
+   * Character limit of the block.
+   */
+  limit?: number | null;
+
+  /**
+   * Metadata of the block.
+   */
+  metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * Preserve the block on template migration.
+   */
+  preserve_on_migration?: boolean | null;
+
+  /**
+   * The associated project id.
+   */
+  project_id?: string | null;
+
+  /**
+   * 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;
+
+  /**
+   * Value of the block.
+   */
+  value?: string | null;
+}
+
+export interface BlockRetrieveParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
+  agent_id: string;
+}
+
+export interface BlockUpdateParams {
+  /**
+   * Path param: The ID of the agent in the format 'agent-<uuid4>'
+   */
+  agent_id: string;
+
+  /**
+   * Body param: The base template id of the block.
+   */
+  base_template_id?: string | null;
+
+  /**
+   * Body param: The id of the deployment.
+   */
+  deployment_id?: string | null;
+
+  /**
+   * Body param: Description of the block.
+   */
+  description?: string | null;
+
+  /**
+   * Body param: The id of the entity within the template.
+   */
+  entity_id?: string | null;
+
+  /**
+   * Body param: If set to True, the block will be hidden.
+   */
+  hidden?: boolean | null;
+
+  /**
+   * Body param: Whether the block is a template (e.g. saved human/persona options).
+   */
+  is_template?: boolean;
+
+  /**
+   * Body param: Label of the block (e.g. 'human', 'persona') in the context window.
+   */
+  label?: string | null;
+
+  /**
+   * Body param: Character limit of the block.
+   */
+  limit?: number | null;
+
+  /**
+   * Body param: Metadata of the block.
+   */
+  metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * Body param: Preserve the block on template migration.
+   */
+  preserve_on_migration?: boolean | null;
+
+  /**
+   * Body param: The associated project id.
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param: Whether the agent has read-only access to the block.
+   */
+  read_only?: boolean;
+
+  /**
+   * Body param: The id of the template.
+   */
+  template_id?: string | null;
+
+  /**
+   * Body param: Name of the block if it is a template.
+   */
+  template_name?: string | null;
+
+  /**
+   * Body param: Value of the block.
+   */
+  value?: string | null;
+}
+
+export interface BlockListParams extends ArrayPageParams {}
+
+export interface BlockAttachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
+  agent_id: string;
+}
+
+export interface BlockDetachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
+  agent_id: string;
+}
+
+export declare namespace Blocks {
+  export {
+    type Block as Block,
+    type BlockUpdate as BlockUpdate,
+    type BlockRetrieveParams as BlockRetrieveParams,
+    type BlockUpdateParams as BlockUpdateParams,
+    type BlockListParams as BlockListParams,
+    type BlockAttachParams as BlockAttachParams,
+    type BlockDetachParams as BlockDetachParams,
+  };
+}
+
+export { type BlockResponsesArrayPage };

package/src/resources/agents/files.ts

@@ -2,19 +2,23 @@
 
 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';
 
 export class Files extends APIResource {
   /**
-   * Get the files attached to an agent with their open/closed status (paginated).
+   * Get the files attached to an agent with their open/closed status.
    */
   list(
     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,81 +55,61 @@ 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;
-}
+  file_name: string;
 
-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;
-  }
+  /**
+   * 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;
@@ -134,9 +118,10 @@ export type FileCloseAllResponse = Array<string>;
 
 export type FileOpenResponse = Array<string>;
 
-export interface FileListParams {
+export interface FileListParams extends NextFilesPageParams {
   /**
-   * Pagination cursor from previous response
+   * @deprecated Pagination cursor from previous response (deprecated, use
+   * before/after)
    */
   cursor?: string | null;
 
@@ -144,18 +129,19 @@ export interface FileListParams {
    * Filter by open status (true for open files, false for closed files)
    */
   is_open?: boolean | null;
-
-  /**
-   * Number of items to return (1-100)
-   */
-  limit?: number;
 }
 
 export interface FileCloseParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
   agent_id: string;
 }
 
 export interface FileOpenParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
   agent_id: string;
 }
 
@@ -165,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,