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

package/src/resources/agents/{core-memory/blocks.ts → 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 AgentsAPI from '../agents';
-import { APIPromise } from '../../../core/api-promise';
-import { RequestOptions } from '../../../internal/request-options';
-import { path } from '../../../internal/utils/path';
+import { APIResource } from '../../core/resource';
+import * as AgentsAPI from './agents';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
 
 export class Blocks extends APIResource {
   /**
@@ -29,8 +29,12 @@ export class Blocks extends APIResource {
   /**
    * Retrieve the core memory blocks of a specific agent.
    */
-  list(agentID: string, options?: RequestOptions): APIPromise<BlockListResponse> {
-    return this._client.get(path`/v1/agents/${agentID}/core-memory/blocks`, options);
+  list(
+    agentID: string,
+    query: BlockListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BlockListResponse> {
+    return this._client.get(path`/v1/agents/${agentID}/core-memory/blocks`, { query, ...options });
   }
 
   /**
@@ -240,12 +244,15 @@ export interface BlockUpdate {
 export type BlockListResponse = Array<Block>;
 
 export interface BlockRetrieveParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
   agent_id: string;
 }
 
 export interface BlockUpdateParams {
   /**
-   * Path param:
+   * Path param: The ID of the agent in the format 'agent-<uuid4>'
    */
   agent_id: string;
 
@@ -320,11 +327,47 @@ export interface BlockUpdateParams {
   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
+   */
+  before?: string | null;
+
+  /**
+   * Maximum number of blocks to return
+   */
+  limit?: number | 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';
+}
+
 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;
 }
 
@@ -335,6 +378,7 @@ export declare namespace Blocks {
     type BlockListResponse as BlockListResponse,
     type BlockRetrieveParams as BlockRetrieveParams,
     type BlockUpdateParams as BlockUpdateParams,
+    type BlockListParams as BlockListParams,
     type BlockAttachParams as BlockAttachParams,
     type BlockDetachParams as BlockDetachParams,
   };

package/src/resources/agents/files.ts

@@ -7,7 +7,7 @@ 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,
@@ -136,7 +136,20 @@ export type FileOpenResponse = Array<string>;
 
 export interface FileListParams {
   /**
-   * Pagination cursor from previous response
+   * File ID cursor for pagination. Returns files that come after this file ID in the
+   * specified sort order
+   */
+  after?: string | null;
+
+  /**
+   * File ID cursor for pagination. Returns files that come before this file ID in
+   * the specified sort order
+   */
+  before?: string | null;
+
+  /**
+   * @deprecated Pagination cursor from previous response (deprecated, use
+   * before/after)
    */
   cursor?: string | null;
 
@@ -146,16 +159,33 @@ export interface FileListParams {
   is_open?: boolean | null;
 
   /**
-   * Number of items to return (1-100)
+   * Maximum number of files to return
+   */
+  limit?: number | null;
+
+  /**
+   * Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest
+   * first
+   */
+  order?: 'asc' | 'desc';
+
+  /**
+   * Field to sort by
    */
-  limit?: number;
+  order_by?: 'created_at';
 }
 
 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;
 }
 

package/src/resources/agents/folders.ts

@@ -1,8 +1,9 @@
 // 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 SourcesAPI from '../sources/sources';
+import * as ModelsAPI from '../models/models';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -11,8 +12,12 @@ export class Folders extends APIResource {
   /**
    * Get the folders associated with an agent.
    */
-  list(agentID: string, options?: RequestOptions): APIPromise<FolderListResponse> {
-    return this._client.get(path`/v1/agents/${agentID}/folders`, options);
+  list(
+    agentID: string,
+    query: FolderListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<FolderListResponse> {
+    return this._client.get(path`/v1/agents/${agentID}/folders`, { query, ...options });
   }
 
   /**
@@ -40,19 +45,124 @@ export class Folders extends APIResource {
   }
 }
 
-export type FolderListResponse = Array<SourcesAPI.Source>;
+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 interface FolderListParams {
+  /**
+   * Source ID cursor for pagination. Returns sources that come after this source ID
+   * in the specified sort order
+   */
+  after?: string | null;
+
+  /**
+   * Source ID cursor for pagination. Returns sources that come before this source ID
+   * in the specified sort order
+   */
+  before?: string | null;
+
+  /**
+   * Maximum number of sources to return
+   */
+  limit?: number | null;
+
+  /**
+   * Sort order for sources by creation time. 'asc' for oldest first, 'desc' for
+   * newest first
+   */
+  order?: 'asc' | 'desc';
+
+  /**
+   * Field to sort by
+   */
+  order_by?: 'created_at';
+}
 
 export interface FolderAttachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
   agent_id: string;
 }
 
 export interface FolderDetachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
   agent_id: string;
 }
 
 export declare namespace Folders {
   export {
     type FolderListResponse as FolderListResponse,
+    type FolderListParams as FolderListParams,
     type FolderAttachParams as FolderAttachParams,
     type FolderDetachParams as FolderDetachParams,
   };

package/src/resources/agents/groups.ts

@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as GroupsGroupsAPI from '../groups/groups';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Groups extends APIResource {
+  /**
+   * Lists the groups for an agent.
+   */
+  list(
+    agentID: string,
+    query: GroupListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<GroupListResponse> {
+    return this._client.get(path`/v1/agents/${agentID}/groups`, { query, ...options });
+  }
+}
+
+export type GroupListResponse = Array<GroupsGroupsAPI.Group>;
+
+export interface GroupListParams {
+  /**
+   * Group ID cursor for pagination. Returns groups that come after this group ID in
+   * the specified sort order
+   */
+  after?: string | null;
+
+  /**
+   * Group ID cursor for pagination. Returns groups that come before this group ID in
+   * the specified sort order
+   */
+  before?: string | null;
+
+  /**
+   * Maximum number of groups to return
+   */
+  limit?: number | null;
+
+  /**
+   * Manager type to filter groups by
+   */
+  manager_type?: string | null;
+
+  /**
+   * Sort order for groups 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 Groups {
+  export { type GroupListResponse as GroupListResponse, type GroupListParams as GroupListParams };
+}

package/src/resources/agents/index.ts

@@ -22,36 +22,26 @@ export {
   type AgentListResponse,
   type AgentDeleteResponse,
   type AgentCountResponse,
-  type AgentExportResponse,
-  type AgentImportResponse,
-  type AgentListGroupsResponse,
-  type AgentMigrateResponse,
-  type AgentRetrieveContextResponse,
-  type AgentSearchResponse,
+  type AgentExportFileResponse,
+  type AgentImportFileResponse,
   type AgentCreateParams,
   type AgentRetrieveParams,
   type AgentUpdateParams,
   type AgentListParams,
-  type AgentExportParams,
-  type AgentImportParams,
-  type AgentListGroupsParams,
-  type AgentMigrateParams,
-  type AgentResetMessagesParams,
-  type AgentSearchParams,
-  type AgentSummarizeParams,
+  type AgentExportFileParams,
+  type AgentImportFileParams,
 } from './agents';
 export {
-  ArchivalMemory,
-  type ArchivalMemoryCreateResponse,
-  type ArchivalMemoryListResponse,
-  type ArchivalMemoryDeleteResponse,
-  type ArchivalMemorySearchResponse,
-  type ArchivalMemoryCreateParams,
-  type ArchivalMemoryListParams,
-  type ArchivalMemoryDeleteParams,
-  type ArchivalMemorySearchParams,
-} from './archival-memory';
-export { CoreMemory, type Memory, type CoreMemoryRetrieveVariablesResponse } from './core-memory/index';
+  Blocks,
+  type Block,
+  type BlockUpdate,
+  type BlockListResponse,
+  type BlockRetrieveParams,
+  type BlockUpdateParams,
+  type BlockListParams,
+  type BlockAttachParams,
+  type BlockDetachParams,
+} from './blocks';
 export {
   Files,
   type FileListResponse,
@@ -65,9 +55,11 @@ export {
 export {
   Folders,
   type FolderListResponse,
+  type FolderListParams,
   type FolderAttachParams,
   type FolderDetachParams,
 } from './folders';
+export { Groups, type GroupListResponse, type GroupListParams } from './groups';
 export {
   Messages,
   type ApprovalCreate,
@@ -108,28 +100,20 @@ export {
   type MessageUpdateResponse,
   type MessageListResponse,
   type MessageCancelResponse,
-  type MessagePreviewRawPayloadResponse,
-  type MessageSearchResponse,
-  type MessageSendStreamResponse,
+  type MessageStreamResponse,
   type MessageUpdateParams,
   type MessageListParams,
   type MessageCancelParams,
-  type MessagePreviewRawPayloadParams,
-  type MessageSearchParams,
+  type MessageResetParams,
   type MessageSendParams,
   type MessageSendAsyncParams,
-  type MessageSendStreamParams,
+  type MessageStreamParams,
 } from './messages';
-export {
-  Sources,
-  type SourceListResponse,
-  type SourceAttachParams,
-  type SourceDetachParams,
-} from './sources';
 export {
   Tools,
   type ToolListResponse,
+  type ToolListParams,
   type ToolAttachParams,
   type ToolDetachParams,
-  type ToolModifyApprovalParams,
+  type ToolUpdateApprovalParams,
 } from './tools';