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

package/src/resources/folders/files.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { type Uploadable } from '../../core/uploads';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -16,8 +17,11 @@ export class Files extends APIResource {
     folderID: string,
     query: FileListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<FileListResponse> {
-    return this._client.get(path`/v1/folders/${folderID}/files`, { query, ...options });
+  ): PagePromise<FileListResponsesArrayPage, FileListResponse> {
+    return this._client.getAPIList(path`/v1/folders/${folderID}/files`, ArrayPage<FileListResponse>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -47,110 +51,21 @@ export class Files extends APIResource {
   }
 }
 
-export type FileListResponse = Array<FileListResponse.FileListResponseItem>;
-
-export namespace FileListResponse {
-  /**
-   * Representation of a single FileMetadata
-   */
-  export interface FileListResponseItem {
-    /**
-     * The unique identifier of the source associated with the document.
-     */
-    source_id: string;
-
-    /**
-     * The human-friendly ID of the File
-     */
-    id?: string;
-
-    /**
-     * Number of chunks that have been embedded.
-     */
-    chunks_embedded?: number | null;
-
-    /**
-     * Optional full-text content of the file; only populated on demand due to its
-     * size.
-     */
-    content?: string | null;
-
-    /**
-     * The creation date of the file.
-     */
-    created_at?: string | null;
-
-    /**
-     * Optional error message if the file failed processing.
-     */
-    error_message?: string | null;
-
-    /**
-     * The creation date of the file.
-     */
-    file_creation_date?: string | null;
-
-    /**
-     * The last modified date of the file.
-     */
-    file_last_modified_date?: string | null;
-
-    /**
-     * The name of the file.
-     */
-    file_name?: string | null;
-
-    /**
-     * The path to the file.
-     */
-    file_path?: string | null;
-
-    /**
-     * The size of the file in bytes.
-     */
-    file_size?: number | null;
-
-    /**
-     * The type of the file (MIME type).
-     */
-    file_type?: string | null;
-
-    /**
-     * The original name of the file as uploaded.
-     */
-    original_file_name?: string | null;
-
-    /**
-     * The current processing status of the file (e.g. pending, parsing, embedding,
-     * completed, error).
-     */
-    processing_status?: 'pending' | 'parsing' | 'embedding' | 'completed' | 'error';
-
-    /**
-     * Total number of chunks for the file.
-     */
-    total_chunks?: number | null;
-
-    /**
-     * The update date of the file.
-     */
-    updated_at?: string | null;
-  }
-}
+export type FileListResponsesArrayPage = ArrayPage<FileListResponse>;
 
 /**
  * Representation of a single FileMetadata
  */
-export interface FileUploadResponse {
+export interface FileListResponse {
   /**
-   * The unique identifier of the source associated with the document.
+   * The human-friendly ID of the File
    */
-  source_id: string;
+  id: string;
 
   /**
-   * The human-friendly ID of the File
+   * The unique identifier of the source associated with the document.
    */
-  id?: string;
+  source_id: string;
 
   /**
    * Number of chunks that have been embedded.
@@ -225,39 +140,98 @@ export interface FileUploadResponse {
   updated_at?: string | null;
 }
 
-export interface FileListParams {
+/**
+ * Representation of a single FileMetadata
+ */
+export interface FileUploadResponse {
   /**
-   * File ID cursor for pagination. Returns files that come after this file ID in the
-   * specified sort order
+   * The human-friendly ID of the File
    */
-  after?: string | null;
+  id: string;
 
   /**
-   * File ID cursor for pagination. Returns files that come before this file ID in
-   * the specified sort order
+   * The unique identifier of the source associated with the document.
    */
-  before?: string | null;
+  source_id: string;
 
   /**
-   * Whether to include full file content
+   * Number of chunks that have been embedded.
    */
-  include_content?: boolean;
+  chunks_embedded?: number | null;
+
+  /**
+   * Optional full-text content of the file; only populated on demand due to its
+   * size.
+   */
+  content?: string | null;
+
+  /**
+   * The creation date of the file.
+   */
+  created_at?: string | null;
+
+  /**
+   * Optional error message if the file failed processing.
+   */
+  error_message?: string | null;
+
+  /**
+   * The creation date of the file.
+   */
+  file_creation_date?: string | null;
 
   /**
-   * Maximum number of files to return
+   * The last modified date of the file.
+   */
+  file_last_modified_date?: string | null;
+
+  /**
+   * The name of the file.
+   */
+  file_name?: string | null;
+
+  /**
+   * The path to the file.
    */
-  limit?: number | null;
+  file_path?: string | null;
 
   /**
-   * Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest
-   * first
+   * The size of the file in bytes.
    */
-  order?: 'asc' | 'desc';
+  file_size?: number | null;
 
   /**
-   * Field to sort by
+   * The type of the file (MIME type).
    */
-  order_by?: 'created_at';
+  file_type?: string | null;
+
+  /**
+   * The original name of the file as uploaded.
+   */
+  original_file_name?: string | null;
+
+  /**
+   * The current processing status of the file (e.g. pending, parsing, embedding,
+   * completed, error).
+   */
+  processing_status?: 'pending' | 'parsing' | 'embedding' | 'completed' | 'error';
+
+  /**
+   * Total number of chunks for the file.
+   */
+  total_chunks?: number | null;
+
+  /**
+   * The update date of the file.
+   */
+  updated_at?: string | null;
+}
+
+export interface FileListParams extends ArrayPageParams {
+  /**
+   * Whether to include full file content
+   */
+  include_content?: boolean;
 }
 
 export interface FileDeleteParams {
@@ -288,6 +262,7 @@ export declare namespace Files {
   export {
     type FileListResponse as FileListResponse,
     type FileUploadResponse as FileUploadResponse,
+    type FileListResponsesArrayPage as FileListResponsesArrayPage,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileUploadParams as FileUploadParams,

package/src/resources/folders/folders.ts

@@ -8,12 +8,14 @@ import {
   FileDeleteParams,
   FileListParams,
   FileListResponse,
+  FileListResponsesArrayPage,
   FileUploadParams,
   FileUploadResponse,
   Files,
 } from './files';
 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';
 
@@ -41,8 +43,8 @@ export class Folders extends APIResource {
   list(
     query: FolderListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<FolderListResponse> {
-    return this._client.get('/v1/folders/', { query, ...options });
+  ): PagePromise<FoldersArrayPage, Folder> {
+    return this._client.getAPIList('/v1/folders/', ArrayPage<Folder>, { query, ...options });
   }
 
   /**
@@ -52,13 +54,6 @@ export class Folders extends APIResource {
     return this._client.delete(path`/v1/folders/${folderID}`, options);
   }
 
-  /**
-   * Count all data folders created by a user.
-   */
-  count(options?: RequestOptions): APIPromise<FolderCountResponse> {
-    return this._client.get('/v1/folders/count', options);
-  }
-
   /**
    * Update the name or documentation of an existing data folder.
    */
@@ -67,6 +62,8 @@ export class Folders extends APIResource {
   }
 }
 
+export type FoldersArrayPage = ArrayPage<Folder>;
+
 /**
  * Representation of a folder, which is a collection of files and passages.
  *
@@ -77,6 +74,11 @@ export class Folders extends APIResource {
  * of the folder.
  */
 export interface Folder {
+  /**
+   * The human-friendly ID of the Source
+   */
+  id: string;
+
   /**
    * The embedding configuration used by the folder.
    */
@@ -87,11 +89,6 @@ export interface Folder {
    */
   name: string;
 
-  /**
-   * The human-friendly ID of the Source
-   */
-  id?: string;
-
   /**
    * The timestamp when the folder was created.
    */
@@ -128,12 +125,8 @@ export interface Folder {
   updated_at?: string | null;
 }
 
-export type FolderListResponse = Array<Folder>;
-
 export type FolderDeleteResponse = unknown;
 
-export type FolderCountResponse = number;
-
 export interface FolderCreateParams {
   /**
    * The name of the source.
@@ -171,39 +164,11 @@ export interface FolderCreateParams {
   metadata?: { [key: string]: unknown } | null;
 }
 
-export interface FolderListParams {
-  /**
-   * Folder ID cursor for pagination. Returns folders that come after this folder ID
-   * in the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Folder ID cursor for pagination. Returns folders that come before this folder ID
-   * in the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of folders to return
-   */
-  limit?: number | null;
-
+export interface FolderListParams extends ArrayPageParams {
   /**
    * Folder name to filter by
    */
   name?: string | null;
-
-  /**
-   * Sort order for folders by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
 }
 
 export interface FolderModifyParams {
@@ -239,9 +204,8 @@ Folders.Agents = Agents;
 export declare namespace Folders {
   export {
     type Folder as Folder,
-    type FolderListResponse as FolderListResponse,
     type FolderDeleteResponse as FolderDeleteResponse,
-    type FolderCountResponse as FolderCountResponse,
+    type FoldersArrayPage as FoldersArrayPage,
     type FolderCreateParams as FolderCreateParams,
     type FolderListParams as FolderListParams,
     type FolderModifyParams as FolderModifyParams,
@@ -251,6 +215,7 @@ export declare namespace Folders {
     Files as Files,
     type FileListResponse as FileListResponse,
     type FileUploadResponse as FileUploadResponse,
+    type FileListResponsesArrayPage as FileListResponsesArrayPage,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileUploadParams as FileUploadParams,

package/src/resources/folders/index.ts

@@ -8,14 +8,14 @@ export {
   type FileListParams,
   type FileDeleteParams,
   type FileUploadParams,
+  type FileListResponsesArrayPage,
 } from './files';
 export {
   Folders,
   type Folder,
-  type FolderListResponse,
   type FolderDeleteResponse,
-  type FolderCountResponse,
   type FolderCreateParams,
   type FolderListParams,
   type FolderModifyParams,
+  type FoldersArrayPage,
 } from './folders';

package/src/resources/groups/groups.ts

@@ -51,13 +51,6 @@ export class Groups extends APIResource {
     return this._client.delete(path`/v1/groups/${groupID}`, options);
   }
 
-  /**
-   * Get the count of all groups associated with a given user.
-   */
-  count(options?: RequestOptions): APIPromise<GroupCountResponse> {
-    return this._client.get('/v1/groups/count', options);
-  }
-
   /**
    * Create a new multi-agent group with the specified configuration.
    */
@@ -195,8 +188,6 @@ export interface VoiceSleeptimeManager {
 
 export type GroupDeleteResponse = unknown;
 
-export type GroupCountResponse = number;
-
 export interface GroupCreateParams {
   agent_ids: Array<string>;
 
@@ -324,7 +315,6 @@ export declare namespace Groups {
     type SupervisorManager as SupervisorManager,
     type VoiceSleeptimeManager as VoiceSleeptimeManager,
     type GroupDeleteResponse as GroupDeleteResponse,
-    type GroupCountResponse as GroupCountResponse,
     type GroupsArrayPage as GroupsArrayPage,
     type GroupCreateParams as GroupCreateParams,
     type GroupListParams as GroupListParams,

package/src/resources/groups/index.ts

@@ -10,7 +10,6 @@ export {
   type SupervisorManager,
   type VoiceSleeptimeManager,
   type GroupDeleteResponse,
-  type GroupCountResponse,
   type GroupCreateParams,
   type GroupListParams,
   type GroupModifyParams,

package/src/resources/groups/messages.ts

@@ -95,7 +95,9 @@ export type MessageModifyResponse =
   | ToolsAPI.ToolReturnMessage
   | MessagesAPI.AssistantMessage
   | MessagesAPI.ApprovalRequestMessage
-  | MessagesAPI.ApprovalResponseMessage;
+  | MessagesAPI.ApprovalResponseMessage
+  | MessagesAPI.SummaryMessage
+  | MessagesAPI.EventMessage;
 
 export type MessageResetResponse = unknown;
 
@@ -198,11 +200,6 @@ export declare namespace MessageModifyParams {
 }
 
 export interface MessageSendParams {
-  /**
-   * 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
@@ -228,11 +225,34 @@ export interface MessageSendParams {
    */
   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
+        | MessageSendParams.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
@@ -241,12 +261,48 @@ export interface MessageSendParams {
   use_assistant_message?: boolean;
 }
 
-export interface MessageStreamParams {
+export namespace MessageSendParams {
   /**
-   * The messages to be sent to the agent.
+   * The style of reasoning content returned by the OpenAI Responses API
    */
-  messages: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate>;
+  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 MessageStreamParams {
   /**
    * @deprecated The name of the message argument in the designated message tool.
    * Still supported for legacy agent types, but deprecated for letta_v1_agent
@@ -261,7 +317,8 @@ export interface MessageStreamParams {
   assistant_message_tool_name?: string;
 
   /**
-   * Whether to process the request in the background.
+   * Whether to process the request in the background (only used when
+   * streaming=true).
    */
   background?: boolean;
 
@@ -273,7 +330,7 @@ export interface MessageStreamParams {
 
   /**
    * Whether to include periodic keepalive ping messages in the stream to prevent
-   * connection timeouts.
+   * connection timeouts (only used when streaming=true).
    */
   include_pings?: boolean;
 
@@ -283,17 +340,46 @@ export interface MessageStreamParams {
    */
   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
+        | MessageStreamParams.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;
+
   /**
    * Flag to determine if individual tokens should be streamed, rather than streaming
-   * per step.
+   * per step (only used when streaming=true).
    */
   stream_tokens?: boolean;
 
+  /**
+   * If True, returns a streaming response (Server-Sent Events). If False (default),
+   * returns a complete response.
+   */
+  streaming?: boolean;
+
   /**
    * @deprecated Whether the server should parse specific tool call arguments
    * (default `send_message`) as `AssistantMessage` objects. Still supported for
@@ -302,6 +388,47 @@ export interface MessageStreamParams {
   use_assistant_message?: boolean;
 }
 
+export namespace MessageStreamParams {
+  /**
+   * 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 declare namespace Messages {
   export {
     type MessageModifyResponse as MessageModifyResponse,