@letta-ai/letta-client 1.0.0-alpha.15 → 1.0.0-alpha.17

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,16 +62,17 @@ export class Folders extends APIResource {
   }
 }
 
+export type FoldersArrayPage = ArrayPage<Folder>;
+
 /**
  * Representation of a folder, which is a collection of files and passages.
- *
- * Parameters: id (str): The ID of the folder name (str): The name of the folder.
- * embedding_config (EmbeddingConfig): The embedding configuration used by the
- * folder. user_id (str): The ID of the user that created the folder. metadata
- * (dict): Metadata associated with the folder. description (str): The description
- * of the folder.
  */
 export interface Folder {
+  /**
+   * The human-friendly ID of the Source
+   */
+  id: string;
+
   /**
    * The embedding configuration used by the folder.
    */
@@ -87,11 +83,6 @@ export interface Folder {
    */
   name: string;
 
-  /**
-   * The human-friendly ID of the Source
-   */
-  id?: string;
-
   /**
    * The timestamp when the folder was created.
    */
@@ -128,12 +119,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 +158,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 +198,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 +209,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

@@ -317,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;
 
@@ -329,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;
 
@@ -369,10 +370,16 @@ export interface MessageStreamParams {
 
   /**
    * 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

package/src/resources/identities/identities.ts

@@ -8,6 +8,7 @@ import { BlockListParams, Blocks } from './blocks';
 import * as PropertiesAPI from './properties';
 import { Properties, PropertyUpsertParams, PropertyUpsertResponse } from './properties';
 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 Identities extends APIResource {
   list(
     query: IdentityListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<IdentityListResponse> {
-    return this._client.get('/v1/identities/', { query, ...options });
+  ): PagePromise<IdentitiesArrayPage, Identity> {
+    return this._client.getAPIList('/v1/identities/', ArrayPage<Identity>, { query, ...options });
   }
 
   /**
@@ -47,13 +48,6 @@ export class Identities extends APIResource {
     return this._client.delete(path`/v1/identities/${identityID}`, options);
   }
 
-  /**
-   * Get count of all identities for a user
-   */
-  count(options?: RequestOptions): APIPromise<IdentityCountResponse> {
-    return this._client.get('/v1/identities/count', options);
-  }
-
   /**
    * Modify Identity
    */
@@ -69,7 +63,14 @@ export class Identities extends APIResource {
   }
 }
 
+export type IdentitiesArrayPage = ArrayPage<Identity>;
+
 export interface Identity {
+  /**
+   * The human-friendly ID of the Identity
+   */
+  id: string;
+
   /**
    * @deprecated The IDs of the agents associated with the identity.
    */
@@ -95,11 +96,6 @@ export interface Identity {
    */
   name: string;
 
-  /**
-   * The human-friendly ID of the Identity
-   */
-  id?: string;
-
   /**
    * The project id of the identity, if applicable.
    */
@@ -136,12 +132,8 @@ export interface IdentityProperty {
  */
 export type IdentityType = 'org' | 'user' | 'other';
 
-export type IdentityListResponse = Array<Identity>;
-
 export type IdentityDeleteResponse = unknown;
 
-export type IdentityCountResponse = number;
-
 export interface IdentityCreateParams {
   /**
    * External, user-generated identifier key of the identity.
@@ -179,19 +171,7 @@ export interface IdentityCreateParams {
   properties?: Array<IdentityProperty> | null;
 }
 
-export interface IdentityListParams {
-  /**
-   * Identity ID cursor for pagination. Returns identities that come after this
-   * identity ID in the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Identity ID cursor for pagination. Returns identities that come before this
-   * identity ID in the specified sort order
-   */
-  before?: string | null;
-
+export interface IdentityListParams extends ArrayPageParams {
   identifier_key?: string | null;
 
   /**
@@ -199,24 +179,8 @@ export interface IdentityListParams {
    */
   identity_type?: IdentityType | null;
 
-  /**
-   * Maximum number of identities to return
-   */
-  limit?: number | null;
-
   name?: string | null;
 
-  /**
-   * Sort order for identities by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
-
   project_id?: string | null;
 }
 
@@ -298,9 +262,8 @@ export declare namespace Identities {
     type Identity as Identity,
     type IdentityProperty as IdentityProperty,
     type IdentityType as IdentityType,
-    type IdentityListResponse as IdentityListResponse,
     type IdentityDeleteResponse as IdentityDeleteResponse,
-    type IdentityCountResponse as IdentityCountResponse,
+    type IdentitiesArrayPage as IdentitiesArrayPage,
     type IdentityCreateParams as IdentityCreateParams,
     type IdentityListParams as IdentityListParams,
     type IdentityModifyParams as IdentityModifyParams,

package/src/resources/identities/index.ts

@@ -7,12 +7,11 @@ export {
   type Identity,
   type IdentityProperty,
   type IdentityType,
-  type IdentityListResponse,
   type IdentityDeleteResponse,
-  type IdentityCountResponse,
   type IdentityCreateParams,
   type IdentityListParams,
   type IdentityModifyParams,
   type IdentityUpsertParams,
+  type IdentitiesArrayPage,
 } from './identities';
 export { Properties, type PropertyUpsertResponse, type PropertyUpsertParams } from './properties';

package/src/resources/index.ts

@@ -20,7 +20,6 @@ export {
   type TerminalToolRule,
   type TextResponseFormat,
   type AgentDeleteResponse,
-  type AgentCountResponse,
   type AgentExportFileResponse,
   type AgentImportFileResponse,
   type AgentCreateParams,
@@ -35,25 +34,24 @@ export {
   Archives,
   type Archive,
   type VectorDBProvider,
-  type ArchiveListResponse,
   type ArchiveCreateParams,
   type ArchiveListParams,
   type ArchiveModifyParams,
+  type ArchivesArrayPage,
 } from './archives';
 export {
   Batches,
   type BatchJob,
-  type BatchListResponse,
   type BatchCancelResponse,
   type BatchCreateParams,
   type BatchListParams,
+  type BatchJobsArrayPage,
 } from './batches/batches';
 export {
   Blocks,
   type BlockResponse,
   type CreateBlock,
   type BlockDeleteResponse,
-  type BlockCountResponse,
   type BlockCreateParams,
   type BlockListParams,
   type BlockModifyParams,
@@ -62,12 +60,11 @@ export {
 export {
   Folders,
   type Folder,
-  type FolderListResponse,
   type FolderDeleteResponse,
-  type FolderCountResponse,
   type FolderCreateParams,
   type FolderListParams,
   type FolderModifyParams,
+  type FoldersArrayPage,
 } from './folders/folders';
 export {
   Groups,
@@ -79,7 +76,6 @@ export {
   type SupervisorManager,
   type VoiceSleeptimeManager,
   type GroupDeleteResponse,
-  type GroupCountResponse,
   type GroupCreateParams,
   type GroupListParams,
   type GroupModifyParams,
@@ -90,35 +86,48 @@ export {
   type Identity,
   type IdentityProperty,
   type IdentityType,
-  type IdentityListResponse,
   type IdentityDeleteResponse,
-  type IdentityCountResponse,
   type IdentityCreateParams,
   type IdentityListParams,
   type IdentityModifyParams,
   type IdentityUpsertParams,
+  type IdentitiesArrayPage,
 } from './identities/identities';
 export {
   McpServers,
-  type McpServerSchema,
+  type CreateSseMcpServer,
+  type CreateStdioMcpServer,
+  type CreateStreamableHTTPMcpServer,
+  type McpToolExecuteRequest,
+  type SseMcpServer,
+  type StdioMcpServer,
+  type StreamableHTTPMcpServer,
+  type ToolExecutionResult,
+  type UpdateSseMcpServer,
+  type UpdateStdioMcpServer,
+  type UpdateStreamableHTTPMcpServer,
   type McpServerCreateResponse,
   type McpServerRetrieveResponse,
   type McpServerListResponse,
   type McpServerConnectResponse,
   type McpServerModifyResponse,
+  type McpServerRefreshResponse,
   type McpServerCreateParams,
   type McpServerModifyParams,
+  type McpServerRefreshParams,
 } from './mcp-servers/mcp-servers';
 export {
   Models,
   type EmbeddingConfig,
+  type EmbeddingModel,
   type LlmConfig,
+  type Model,
   type ProviderCategory,
   type ProviderType,
   type ModelListResponse,
   type ModelListParams,
 } from './models/models';
-export { Runs, type Job, type StopReasonType, type RunListResponse, type RunListParams } from './runs/runs';
+export { Runs, type Job, type StopReasonType, type RunListParams } from './runs/runs';
 export {
   Steps,
   type ProviderTrace,
@@ -136,14 +145,12 @@ export {
   type ToolCreate,
   type ToolReturnMessage,
   type ToolType,
-  type ToolListResponse,
   type ToolDeleteResponse,
-  type ToolCountResponse,
   type ToolUpsertBaseToolsResponse,
   type ToolCreateParams,
   type ToolListParams,
-  type ToolCountParams,
   type ToolModifyParams,
   type ToolUpsertParams,
+  type ToolsArrayPage,
 } from './tools';
 export { type HealthResponse } from './top-level';

package/src/resources/mcp-servers/index.ts

@@ -2,20 +2,25 @@
 
 export {
   McpServers,
-  type McpServerSchema,
+  type CreateSseMcpServer,
+  type CreateStdioMcpServer,
+  type CreateStreamableHTTPMcpServer,
+  type McpToolExecuteRequest,
+  type SseMcpServer,
+  type StdioMcpServer,
+  type StreamableHTTPMcpServer,
+  type ToolExecutionResult,
+  type UpdateSseMcpServer,
+  type UpdateStdioMcpServer,
+  type UpdateStreamableHTTPMcpServer,
   type McpServerCreateResponse,
   type McpServerRetrieveResponse,
   type McpServerListResponse,
   type McpServerConnectResponse,
   type McpServerModifyResponse,
+  type McpServerRefreshResponse,
   type McpServerCreateParams,
   type McpServerModifyParams,
+  type McpServerRefreshParams,
 } from './mcp-servers';
-export { Refresh, type RefreshTriggerResponse, type RefreshTriggerParams } from './refresh';
-export {
-  Tools,
-  type ToolListResponse,
-  type ToolRunResponse,
-  type ToolRetrieveParams,
-  type ToolRunParams,
-} from './tools';
+export { Tools, type ToolListResponse, type ToolRetrieveParams, type ToolRunParams } from './tools';