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

package/src/client.ts

@@ -14,271 +14,186 @@ import * as Opts from './internal/request-options';
 import * as qs from './internal/qs';
 import { VERSION } from './version';
 import * as Errors from './core/error';
+import * as Pagination from './core/pagination';
+import {
+  AbstractPage,
+  type ArrayPageParams,
+  ArrayPageResponse,
+  type NextFilesPageParams,
+  NextFilesPageResponse,
+  type ObjectPageParams,
+  ObjectPageResponse,
+} from './core/pagination';
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
+import * as TopLevelAPI from './resources/top-level';
+import { HealthResponse } from './resources/top-level';
 import { APIPromise } from './core/api-promise';
 import {
-  Archive,
-  ArchiveRetrieveParams,
-  ArchiveRetrieveResponse,
-  ArchiveUpdateParams,
-  Archives,
-  VectorDBProvider,
-} from './resources/archives';
-import {
-  BlockCountResponse,
-  BlockCreateParams,
-  BlockDeleteResponse,
-  BlockListAgentsParams,
-  BlockListAgentsResponse,
-  BlockListParams,
-  BlockListResponse,
-  BlockUpdateParams,
-  Blocks,
-  CreateBlock,
-} from './resources/blocks';
-import {
-  ClientSideAccessTokenCreateParams,
-  ClientSideAccessTokenCreateResponse,
-  ClientSideAccessTokenDeleteParams,
-  ClientSideAccessTokenDeleteResponse,
-  ClientSideAccessTokenListParams,
-  ClientSideAccessTokenListResponse,
-  ClientSideAccessTokens,
-} from './resources/client-side-access-tokens';
-import {
-  EmbeddingGetTotalStorageSizeParams,
-  EmbeddingGetTotalStorageSizeResponse,
-  Embeddings,
-} from './resources/embeddings';
-import {
-  Folder,
-  FolderCountResponse,
-  FolderCreateParams,
-  FolderDeleteFileParams,
-  FolderDeleteResponse,
-  FolderGetByNameResponse,
-  FolderListAgentsParams,
-  FolderListAgentsResponse,
-  FolderListFilesParams,
-  FolderListFilesResponse,
-  FolderListParams,
-  FolderListPassagesParams,
-  FolderListPassagesResponse,
-  FolderListResponse,
-  FolderRetrieveMetadataParams,
-  FolderUpdateParams,
-  FolderUploadFileParams,
-  Folders,
-} from './resources/folders';
-import { Health, HealthCheckResponse } from './resources/health';
-import {
-  Identities,
-  Identity,
-  IdentityCountResponse,
-  IdentityCreateParams,
-  IdentityDeleteResponse,
-  IdentityListAgentsParams,
-  IdentityListAgentsResponse,
-  IdentityListBlocksParams,
-  IdentityListBlocksResponse,
-  IdentityListParams,
-  IdentityListResponse,
-  IdentityModifyParams,
-  IdentityProperty,
-  IdentityType,
-  IdentityUpsertParams,
-  IdentityUpsertPropertiesParams,
-  IdentityUpsertPropertiesResponse,
-} from './resources/identities';
-import {
-  Job,
-  JobListActiveParams,
-  JobListActiveResponse,
-  JobListParams,
-  JobListResponse,
-  Jobs,
-} from './resources/jobs';
-import {
-  EmbeddingConfig,
-  LlmConfig,
-  ModelListEmbeddingResponse,
-  ModelListParams,
-  ModelListResponse,
-  Models,
-  ProviderCategory,
-  ProviderType,
-} from './resources/models';
-import { ProjectListParams, ProjectListResponse, Projects } from './resources/projects';
-import {
-  Provider,
-  ProviderCheckParams,
-  ProviderCheckResponse,
-  ProviderCreateParams,
-  ProviderDeleteResponse,
-  ProviderListParams,
-  ProviderListResponse,
-  ProviderUpdateParams,
-  Providers,
-} from './resources/providers';
-import {
-  RunListActiveParams,
-  RunListActiveResponse,
-  RunListMessagesParams,
-  RunListMessagesResponse,
-  RunListParams,
-  RunListResponse,
-  RunListStepsParams,
-  RunListStepsResponse,
-  RunRetrieveStreamParams,
-  RunRetrieveStreamResponse,
-  RunRetrieveUsageResponse,
-  Runs,
-  StopReasonType,
-} from './resources/runs';
-import {
-  ProviderTrace,
-  Step,
-  StepListMessagesParams,
-  StepListMessagesResponse,
-  StepListParams,
-  StepListResponse,
-  StepRetrieveMetricsResponse,
-  StepUpdateFeedbackParams,
-  Steps,
-} from './resources/steps';
+  AccessTokenCreateParams,
+  AccessTokenCreateResponse,
+  AccessTokenDeleteParams,
+  AccessTokenDeleteResponse,
+  AccessTokenListParams,
+  AccessTokenListResponse,
+  AccessTokens,
+} from './resources/access-tokens';
 import { TagListParams, TagListResponse, Tags } from './resources/tags';
-import { Telemetry } from './resources/telemetry';
 import {
-  TemplateCreateAgentsParams,
-  TemplateCreateAgentsResponse,
-  TemplateCreateParams,
-  TemplateCreateResponse,
-  TemplateDeleteParams,
-  TemplateDeleteResponse,
-  TemplateForkParams,
-  TemplateForkResponse,
-  TemplateGetSnapshotParams,
-  TemplateGetSnapshotResponse,
-  TemplateListParams,
-  TemplateListResponse,
-  TemplateListVersionsParams,
-  TemplateListVersionsResponse,
-  TemplateRenameParams,
-  TemplateRenameResponse,
-  TemplateSaveVersionParams,
-  TemplateSaveVersionResponse,
-  TemplateUpdateDescriptionParams,
-  TemplateUpdateDescriptionResponse,
-  Templates,
-} from './resources/templates';
-import {
-  InternalTemplateCreateAgentParams,
-  InternalTemplateCreateBlockParams,
-  InternalTemplateCreateGroupParams,
-  _InternalTemplates,
-} from './resources/-internal-templates/-internal-templates';
+  NpmRequirement,
+  PipRequirement,
+  Tool,
+  ToolCreate,
+  ToolCreateParams,
+  ToolDeleteResponse,
+  ToolListParams,
+  ToolReturnMessage,
+  ToolType,
+  ToolUpdateParams,
+  ToolUpsertBaseToolsResponse,
+  ToolUpsertParams,
+  Tools,
+  ToolsArrayPage,
+} from './resources/tools';
 import {
-  AgentCountResponse,
   AgentCreateParams,
   AgentDeleteResponse,
   AgentEnvironmentVariable,
-  AgentExportParams,
-  AgentExportResponse,
-  AgentImportParams,
-  AgentImportResponse,
-  AgentListGroupsParams,
-  AgentListGroupsResponse,
+  AgentExportFileParams,
+  AgentExportFileResponse,
+  AgentImportFileParams,
+  AgentImportFileResponse,
   AgentListParams,
-  AgentListResponse,
-  AgentMigrateParams,
-  AgentMigrateResponse,
-  AgentResetMessagesParams,
-  AgentRetrieveContextResponse,
   AgentRetrieveParams,
-  AgentSearchParams,
-  AgentSearchResponse,
   AgentState,
-  AgentSummarizeParams,
+  AgentStatesArrayPage,
   AgentType,
   AgentUpdateParams,
   Agents,
+  AnthropicModelSettings,
+  AzureModelSettings,
+  BedrockModelSettings,
   ChildToolRule,
   ConditionalToolRule,
   ContinueToolRule,
+  DeepseekModelSettings,
+  GoogleAIModelSettings,
+  GoogleVertexModelSettings,
+  GroqModelSettings,
   InitToolRule,
   JsonObjectResponseFormat,
   JsonSchemaResponseFormat,
   LettaMessageContentUnion,
   MaxCountPerStepToolRule,
   MessageCreate,
+  OpenAIModelSettings,
   ParentToolRule,
   RequiredBeforeExitToolRule,
   RequiresApprovalToolRule,
   TerminalToolRule,
   TextResponseFormat,
+  TogetherModelSettings,
+  XaiModelSettings,
 } from './resources/agents/agents';
+import {
+  Archive,
+  ArchiveCreateParams,
+  ArchiveListParams,
+  ArchiveUpdateParams,
+  Archives,
+  ArchivesArrayPage,
+  VectorDBProvider,
+} from './resources/archives/archives';
+import {
+  BatchCancelResponse,
+  BatchCreateParams,
+  BatchJob,
+  BatchJobsArrayPage,
+  BatchListParams,
+  Batches,
+} from './resources/batches/batches';
+import {
+  BlockCreateParams,
+  BlockDeleteResponse,
+  BlockListParams,
+  BlockResponse,
+  BlockResponsesArrayPage,
+  BlockUpdateParams,
+  Blocks,
+  CreateBlock,
+} from './resources/blocks/blocks';
+import {
+  Folder,
+  FolderCreateParams,
+  FolderDeleteResponse,
+  FolderListParams,
+  FolderUpdateParams,
+  Folders,
+  FoldersArrayPage,
+} from './resources/folders/folders';
 import {
   DynamicManager,
   Group,
-  GroupCountResponse,
   GroupCreateParams,
   GroupDeleteResponse,
   GroupListParams,
-  GroupListResponse,
-  GroupResetMessagesResponse,
   GroupUpdateParams,
   Groups,
+  GroupsArrayPage,
   ManagerType,
   RoundRobinManager,
   SleeptimeManager,
   SupervisorManager,
   VoiceSleeptimeManager,
 } from './resources/groups/groups';
-import { Messages } from './resources/messages/messages';
 import {
-  DuplicateFileHandling,
-  FileMetadata,
-  FileProcessingStatus,
-  OrganizationSourcesStats,
-  Passage,
-  Source,
-  SourceCountResponse,
-  SourceCreate,
-  SourceCreateParams,
-  SourceDeleteFileParams,
-  SourceDeleteResponse,
-  SourceGetAgentsResponse,
-  SourceGetByNameResponse,
-  SourceGetMetadataParams,
-  SourceListPassagesParams,
-  SourceListPassagesResponse,
-  SourceListResponse,
-  SourceUpdate,
-  SourceUpdateParams,
-  SourceUploadFileParams,
-  Sources,
-} from './resources/sources/sources';
+  Identities,
+  IdentitiesArrayPage,
+  Identity,
+  IdentityCreateParams,
+  IdentityDeleteResponse,
+  IdentityListParams,
+  IdentityProperty,
+  IdentityType,
+  IdentityUpdateParams,
+  IdentityUpsertParams,
+} from './resources/identities/identities';
+import {
+  CreateSseMcpServer,
+  CreateStdioMcpServer,
+  CreateStreamableHTTPMcpServer,
+  McpServerCreateParams,
+  McpServerCreateResponse,
+  McpServerListResponse,
+  McpServerRefreshParams,
+  McpServerRefreshResponse,
+  McpServerRetrieveResponse,
+  McpServerUpdateParams,
+  McpServerUpdateResponse,
+  McpServers,
+  McpToolExecuteRequest,
+  SseMcpServer,
+  StdioMcpServer,
+  StreamableHTTPMcpServer,
+  ToolExecutionResult,
+  UpdateSseMcpServer,
+  UpdateStdioMcpServer,
+  UpdateStreamableHTTPMcpServer,
+} from './resources/mcp-servers/mcp-servers';
 import {
-  NpmRequirement,
-  PipRequirement,
-  Tool,
-  ToolCountParams,
-  ToolCountResponse,
-  ToolCreate,
-  ToolCreateParams,
-  ToolDeleteResponse,
-  ToolListParams,
-  ToolListResponse,
-  ToolModifyParams,
-  ToolReturnMessage,
-  ToolRunParams,
-  ToolType,
-  ToolUpsertBaseResponse,
-  ToolUpsertParams,
-  Tools,
-} from './resources/tools/tools';
-import { VoiceBeta } from './resources/voice-beta/voice-beta';
+  EmbeddingConfig,
+  EmbeddingModel,
+  LlmConfig,
+  Model,
+  ModelListParams,
+  ModelListResponse,
+  Models,
+  ProviderCategory,
+  ProviderType,
+} from './resources/models/models';
+import { Job, RunListParams, Runs, StopReasonType } from './resources/runs/runs';
+import { ProviderTrace, Step, StepListParams, Steps, StepsArrayPage } from './resources/steps/steps';
+import { Templates } from './resources/templates/templates';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -293,30 +208,37 @@ import {
 import { isEmptyObj } from './internal/utils/values';
 
 const environments = {
-  production: 'https://app.letta.com',
-  environment_1: 'http://localhost:8283',
+  cloud: 'https://api.letta.com',
+  local: 'http://localhost:8283',
 };
 type Environment = keyof typeof environments;
 
 export interface ClientOptions {
   /**
-   * Defaults to process.env['LETTA_SDK_API_KEY'].
+   * Defaults to process.env['LETTA_API_KEY'].
+   */
+  apiKey?: string | null | undefined;
+
+  projectID?: string | null | undefined;
+
+  /**
+   * Deprecated, please use project_id instead.
    */
-  apiKey?: string | undefined;
+  project?: string | null | undefined;
 
   /**
    * Specifies the environment to use for the API.
    *
    * Each environment maps to a different base URL:
-   * - `production` corresponds to `https://app.letta.com`
-   * - `environment_1` corresponds to `http://localhost:8283`
+   * - `cloud` corresponds to `https://api.letta.com`
+   * - `local` corresponds to `http://localhost:8283`
    */
   environment?: Environment | undefined;
 
   /**
    * Override the default base URL for the API, e.g., "https://api.example.com/v2/"
    *
-   * Defaults to process.env['LETTA_SDK_BASE_URL'].
+   * Defaults to process.env['LETTA_BASE_URL'].
    */
   baseURL?: string | null | undefined;
 
@@ -370,7 +292,7 @@ export interface ClientOptions {
   /**
    * Set the log level.
    *
-   * Defaults to process.env['LETTA_SDK_LOG'] or 'warn' if it isn't set.
+   * Defaults to process.env['LETTA_LOG'] or 'warn' if it isn't set.
    */
   logLevel?: LogLevel | undefined;
 
@@ -383,10 +305,12 @@ export interface ClientOptions {
 }
 
 /**
- * API Client for interfacing with the Letta SDK API.
+ * API Client for interfacing with the Letta API.
  */
-export class LettaSDK {
-  apiKey: string;
+export class Letta {
+  apiKey: string | null;
+  projectID: string | null;
+  project: string | null;
 
   baseURL: string;
   maxRetries: number;
@@ -401,11 +325,13 @@ export class LettaSDK {
   private _options: ClientOptions;
 
   /**
-   * API Client for interfacing with the Letta SDK API.
+   * API Client for interfacing with the Letta API.
    *
-   * @param {string | undefined} [opts.apiKey=process.env['LETTA_SDK_API_KEY'] ?? undefined]
-   * @param {Environment} [opts.environment=production] - Specifies the environment URL to use for the API.
-   * @param {string} [opts.baseURL=process.env['LETTA_SDK_BASE_URL'] ?? https://app.letta.com] - Override the default base URL for the API.
+   * @param {string | null | undefined} [opts.apiKey=process.env['LETTA_API_KEY'] ?? null]
+   * @param {string | null | undefined} [opts.projectID]
+   * @param {string | null | undefined} [opts.project]
+   * @param {Environment} [opts.environment=cloud] - Specifies the environment URL to use for the API.
+   * @param {string} [opts.baseURL=process.env['LETTA_BASE_URL'] ?? https://api.letta.com] - Override the default base URL for the API.
    * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
    * @param {MergedRequestInit} [opts.fetchOptions] - Additional `RequestInit` options to be passed to `fetch` calls.
    * @param {Fetch} [opts.fetch] - Specify a custom `fetch` function implementation.
@@ -414,38 +340,36 @@ export class LettaSDK {
    * @param {Record<string, string | undefined>} opts.defaultQuery - Default query parameters to include with every request to the API.
    */
   constructor({
-    baseURL = readEnv('LETTA_SDK_BASE_URL'),
-    apiKey = readEnv('LETTA_SDK_API_KEY'),
+    baseURL = readEnv('LETTA_BASE_URL'),
+    apiKey = readEnv('LETTA_API_KEY') ?? null,
+    projectID = null,
+    project = null,
     ...opts
   }: ClientOptions = {}) {
-    if (apiKey === undefined) {
-      throw new Errors.LettaSDKError(
-        "The LETTA_SDK_API_KEY environment variable is missing or empty; either provide it, or instantiate the LettaSDK client with an apiKey option, like new LettaSDK({ apiKey: 'My API Key' }).",
-      );
-    }
-
     const options: ClientOptions = {
       apiKey,
+      projectID,
+      project,
       ...opts,
       baseURL,
-      environment: opts.environment ?? 'production',
+      environment: opts.environment ?? 'cloud',
     };
 
     if (baseURL && opts.environment) {
-      throw new Errors.LettaSDKError(
-        'Ambiguous URL; The `baseURL` option (or LETTA_SDK_BASE_URL env var) and the `environment` option are given. If you want to use the environment you must pass baseURL: null',
+      throw new Errors.LettaError(
+        'Ambiguous URL; The `baseURL` option (or LETTA_BASE_URL env var) and the `environment` option are given. If you want to use the environment you must pass baseURL: null',
       );
     }
 
-    this.baseURL = options.baseURL || environments[options.environment || 'production'];
-    this.timeout = options.timeout ?? LettaSDK.DEFAULT_TIMEOUT /* 1 minute */;
+    this.baseURL = options.baseURL || environments[options.environment || 'cloud'];
+    this.timeout = options.timeout ?? Letta.DEFAULT_TIMEOUT /* 1 minute */;
     this.logger = options.logger ?? console;
     const defaultLogLevel = 'warn';
     // Set default logLevel early so that we can log a warning in parseLogLevel.
     this.logLevel = defaultLogLevel;
     this.logLevel =
       parseLogLevel(options.logLevel, 'ClientOptions.logLevel', this) ??
-      parseLogLevel(readEnv('LETTA_SDK_LOG'), "process.env['LETTA_SDK_LOG']", this) ??
+      parseLogLevel(readEnv('LETTA_LOG'), "process.env['LETTA_LOG']", this) ??
       defaultLogLevel;
     this.fetchOptions = options.fetchOptions;
     this.maxRetries = options.maxRetries ?? 2;
@@ -455,6 +379,8 @@ export class LettaSDK {
     this._options = options;
 
     this.apiKey = apiKey;
+    this.projectID = projectID;
+    this.project = project;
   }
 
   /**
@@ -472,6 +398,8 @@ export class LettaSDK {
       fetch: this.fetch,
       fetchOptions: this.fetchOptions,
       apiKey: this.apiKey,
+      projectID: this.projectID,
+      project: this.project,
       ...options,
     });
     return client;
@@ -481,7 +409,14 @@ export class LettaSDK {
    * Check whether the base URL is set to its default.
    */
   #baseURLOverridden(): boolean {
-    return this.baseURL !== environments[this._options.environment || 'production'];
+    return this.baseURL !== environments[this._options.environment || 'cloud'];
+  }
+
+  /**
+   * Async health check endpoint.
+   */
+  health(options?: RequestOptions): APIPromise<TopLevelAPI.HealthResponse> {
+    return this.get('/v1/health/', options);
   }
 
   protected defaultQuery(): Record<string, string | undefined> | undefined {
@@ -489,15 +424,27 @@ export class LettaSDK {
   }
 
   protected validateHeaders({ values, nulls }: NullableHeaders) {
-    return;
+    if (this.apiKey && values.get('authorization')) {
+      return;
+    }
+    if (nulls.has('authorization')) {
+      return;
+    }
+
+    throw new Error(
+      'Could not resolve authentication method. Expected the apiKey to be set. Or for the "Authorization" headers to be explicitly omitted',
+    );
   }
 
   protected async authHeaders(opts: FinalRequestOptions): Promise<NullableHeaders | undefined> {
+    if (this.apiKey == null) {
+      return undefined;
+    }
     return buildHeaders([{ Authorization: `Bearer ${this.apiKey}` }]);
   }
 
   protected stringifyQuery(query: Record<string, unknown>): string {
-    return qs.stringify(query, { arrayFormat: 'comma' });
+    return qs.stringify(query, { allowDots: true, arrayFormat: 'repeat' });
   }
 
   private getUserAgent(): string {
@@ -752,6 +699,25 @@ export class LettaSDK {
     return { response, options, controller, requestLogID, retryOfRequestLogID, startTime };
   }
 
+  getAPIList<Item, PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>>(
+    path: string,
+    Page: new (...args: any[]) => PageClass,
+    opts?: RequestOptions,
+  ): Pagination.PagePromise<PageClass, Item> {
+    return this.requestAPIList(Page, { method: 'get', path, ...opts });
+  }
+
+  requestAPIList<
+    Item = unknown,
+    PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>,
+  >(
+    Page: new (...args: ConstructorParameters<typeof Pagination.AbstractPage>) => PageClass,
+    options: FinalRequestOptions,
+  ): Pagination.PagePromise<PageClass, Item> {
+    const request = this.makeRequest(options, null, undefined);
+    return new Pagination.PagePromise<PageClass, Item>(this as any as Letta, request, Page);
+  }
+
   async fetchWithTimeout(
     url: RequestInfo,
     init: RequestInit | undefined,
@@ -916,6 +882,8 @@ export class LettaSDK {
         'X-Stainless-Retry-Count': String(retryCount),
         ...(options.timeout ? { 'X-Stainless-Timeout': String(Math.trunc(options.timeout / 1000)) } : {}),
         ...getPlatformHeaders(),
+        'X-Project-Id': this.projectID,
+        'X-Project': this.project,
       },
       await this.authHeaders(options),
       this._options.defaultHeaders,
@@ -965,10 +933,10 @@ export class LettaSDK {
     }
   }
 
-  static LettaSDK = this;
+  static Letta = this;
   static DEFAULT_TIMEOUT = 60000; // 1 minute
 
-  static LettaSDKError = Errors.LettaSDKError;
+  static LettaError = Errors.LettaError;
   static APIError = Errors.APIError;
   static APIConnectionError = Errors.APIConnectionError;
   static APIConnectionTimeoutError = Errors.APIConnectionTimeoutError;
@@ -984,344 +952,244 @@ export class LettaSDK {
 
   static toFile = Uploads.toFile;
 
-  archives: API.Archives = new API.Archives(this);
+  agents: API.Agents = new API.Agents(this);
   tools: API.Tools = new API.Tools(this);
-  sources: API.Sources = new API.Sources(this);
+  blocks: API.Blocks = new API.Blocks(this);
+  archives: API.Archives = new API.Archives(this);
   folders: API.Folders = new API.Folders(this);
-  agents: API.Agents = new API.Agents(this);
-  groups: API.Groups = new API.Groups(this);
-  identities: API.Identities = new API.Identities(this);
-  _internalTemplates: API._InternalTemplates = new API._InternalTemplates(this);
   models: API.Models = new API.Models(this);
-  blocks: API.Blocks = new API.Blocks(this);
-  jobs: API.Jobs = new API.Jobs(this);
-  health: API.Health = new API.Health(this);
-  providers: API.Providers = new API.Providers(this);
+  mcpServers: API.McpServers = new API.McpServers(this);
   runs: API.Runs = new API.Runs(this);
   steps: API.Steps = new API.Steps(this);
-  tags: API.Tags = new API.Tags(this);
-  telemetry: API.Telemetry = new API.Telemetry(this);
-  messages: API.Messages = new API.Messages(this);
-  voiceBeta: API.VoiceBeta = new API.VoiceBeta(this);
-  embeddings: API.Embeddings = new API.Embeddings(this);
   templates: API.Templates = new API.Templates(this);
-  clientSideAccessTokens: API.ClientSideAccessTokens = new API.ClientSideAccessTokens(this);
-  projects: API.Projects = new API.Projects(this);
+  tags: API.Tags = new API.Tags(this);
+  identities: API.Identities = new API.Identities(this);
+  groups: API.Groups = new API.Groups(this);
+  batches: API.Batches = new API.Batches(this);
+  accessTokens: API.AccessTokens = new API.AccessTokens(this);
 }
 
-LettaSDK.Archives = Archives;
-LettaSDK.Tools = Tools;
-LettaSDK.Sources = Sources;
-LettaSDK.Folders = Folders;
-LettaSDK.Agents = Agents;
-LettaSDK.Groups = Groups;
-LettaSDK.Identities = Identities;
-LettaSDK._InternalTemplates = _InternalTemplates;
-LettaSDK.Models = Models;
-LettaSDK.Blocks = Blocks;
-LettaSDK.Jobs = Jobs;
-LettaSDK.Health = Health;
-LettaSDK.Providers = Providers;
-LettaSDK.Runs = Runs;
-LettaSDK.Steps = Steps;
-LettaSDK.Tags = Tags;
-LettaSDK.Telemetry = Telemetry;
-LettaSDK.Messages = Messages;
-LettaSDK.VoiceBeta = VoiceBeta;
-LettaSDK.Embeddings = Embeddings;
-LettaSDK.Templates = Templates;
-LettaSDK.ClientSideAccessTokens = ClientSideAccessTokens;
-LettaSDK.Projects = Projects;
-
-export declare namespace LettaSDK {
+Letta.Agents = Agents;
+Letta.Tools = Tools;
+Letta.Blocks = Blocks;
+Letta.Archives = Archives;
+Letta.Folders = Folders;
+Letta.Models = Models;
+Letta.McpServers = McpServers;
+Letta.Runs = Runs;
+Letta.Steps = Steps;
+Letta.Templates = Templates;
+Letta.Tags = Tags;
+Letta.Identities = Identities;
+Letta.Groups = Groups;
+Letta.Batches = Batches;
+Letta.AccessTokens = AccessTokens;
+
+export declare namespace Letta {
   export type RequestOptions = Opts.RequestOptions;
 
-  export {
-    Archives as Archives,
-    type Archive as Archive,
-    type VectorDBProvider as VectorDBProvider,
-    type ArchiveRetrieveResponse as ArchiveRetrieveResponse,
-    type ArchiveUpdateParams as ArchiveUpdateParams,
-    type ArchiveRetrieveParams as ArchiveRetrieveParams,
-  };
+  export import ArrayPage = Pagination.ArrayPage;
+  export { type ArrayPageParams as ArrayPageParams, type ArrayPageResponse as ArrayPageResponse };
 
-  export {
-    Tools as Tools,
-    type NpmRequirement as NpmRequirement,
-    type PipRequirement as PipRequirement,
-    type Tool as Tool,
-    type ToolCreate as ToolCreate,
-    type ToolReturnMessage as ToolReturnMessage,
-    type ToolType as ToolType,
-    type ToolListResponse as ToolListResponse,
-    type ToolDeleteResponse as ToolDeleteResponse,
-    type ToolCountResponse as ToolCountResponse,
-    type ToolUpsertBaseResponse as ToolUpsertBaseResponse,
-    type ToolCreateParams as ToolCreateParams,
-    type ToolListParams as ToolListParams,
-    type ToolCountParams as ToolCountParams,
-    type ToolModifyParams as ToolModifyParams,
-    type ToolRunParams as ToolRunParams,
-    type ToolUpsertParams as ToolUpsertParams,
-  };
+  export import ObjectPage = Pagination.ObjectPage;
+  export { type ObjectPageParams as ObjectPageParams, type ObjectPageResponse as ObjectPageResponse };
 
+  export import NextFilesPage = Pagination.NextFilesPage;
   export {
-    Sources as Sources,
-    type DuplicateFileHandling as DuplicateFileHandling,
-    type FileMetadata as FileMetadata,
-    type FileProcessingStatus as FileProcessingStatus,
-    type OrganizationSourcesStats as OrganizationSourcesStats,
-    type Passage as Passage,
-    type Source as Source,
-    type SourceCreate as SourceCreate,
-    type SourceUpdate as SourceUpdate,
-    type SourceListResponse as SourceListResponse,
-    type SourceDeleteResponse as SourceDeleteResponse,
-    type SourceCountResponse as SourceCountResponse,
-    type SourceGetAgentsResponse as SourceGetAgentsResponse,
-    type SourceGetByNameResponse as SourceGetByNameResponse,
-    type SourceListPassagesResponse as SourceListPassagesResponse,
-    type SourceCreateParams as SourceCreateParams,
-    type SourceUpdateParams as SourceUpdateParams,
-    type SourceDeleteFileParams as SourceDeleteFileParams,
-    type SourceGetMetadataParams as SourceGetMetadataParams,
-    type SourceListPassagesParams as SourceListPassagesParams,
-    type SourceUploadFileParams as SourceUploadFileParams,
+    type NextFilesPageParams as NextFilesPageParams,
+    type NextFilesPageResponse as NextFilesPageResponse,
   };
 
-  export {
-    Folders as Folders,
-    type Folder as Folder,
-    type FolderListResponse as FolderListResponse,
-    type FolderDeleteResponse as FolderDeleteResponse,
-    type FolderCountResponse as FolderCountResponse,
-    type FolderGetByNameResponse as FolderGetByNameResponse,
-    type FolderListAgentsResponse as FolderListAgentsResponse,
-    type FolderListFilesResponse as FolderListFilesResponse,
-    type FolderListPassagesResponse as FolderListPassagesResponse,
-    type FolderCreateParams as FolderCreateParams,
-    type FolderUpdateParams as FolderUpdateParams,
-    type FolderListParams as FolderListParams,
-    type FolderDeleteFileParams as FolderDeleteFileParams,
-    type FolderListAgentsParams as FolderListAgentsParams,
-    type FolderListFilesParams as FolderListFilesParams,
-    type FolderListPassagesParams as FolderListPassagesParams,
-    type FolderRetrieveMetadataParams as FolderRetrieveMetadataParams,
-    type FolderUploadFileParams as FolderUploadFileParams,
-  };
+  export { type HealthResponse as HealthResponse };
 
   export {
     Agents as Agents,
     type AgentEnvironmentVariable as AgentEnvironmentVariable,
     type AgentState as AgentState,
     type AgentType as AgentType,
+    type AnthropicModelSettings as AnthropicModelSettings,
+    type AzureModelSettings as AzureModelSettings,
+    type BedrockModelSettings as BedrockModelSettings,
     type ChildToolRule as ChildToolRule,
     type ConditionalToolRule as ConditionalToolRule,
     type ContinueToolRule as ContinueToolRule,
+    type DeepseekModelSettings as DeepseekModelSettings,
+    type GoogleAIModelSettings as GoogleAIModelSettings,
+    type GoogleVertexModelSettings as GoogleVertexModelSettings,
+    type GroqModelSettings as GroqModelSettings,
     type InitToolRule as InitToolRule,
     type JsonObjectResponseFormat as JsonObjectResponseFormat,
     type JsonSchemaResponseFormat as JsonSchemaResponseFormat,
     type LettaMessageContentUnion as LettaMessageContentUnion,
     type MaxCountPerStepToolRule as MaxCountPerStepToolRule,
     type MessageCreate as MessageCreate,
+    type OpenAIModelSettings as OpenAIModelSettings,
     type ParentToolRule as ParentToolRule,
     type RequiredBeforeExitToolRule as RequiredBeforeExitToolRule,
     type RequiresApprovalToolRule as RequiresApprovalToolRule,
     type TerminalToolRule as TerminalToolRule,
     type TextResponseFormat as TextResponseFormat,
-    type AgentListResponse as AgentListResponse,
+    type TogetherModelSettings as TogetherModelSettings,
+    type XaiModelSettings as XaiModelSettings,
     type AgentDeleteResponse as AgentDeleteResponse,
-    type AgentCountResponse as AgentCountResponse,
-    type AgentExportResponse as AgentExportResponse,
-    type AgentImportResponse as AgentImportResponse,
-    type AgentListGroupsResponse as AgentListGroupsResponse,
-    type AgentMigrateResponse as AgentMigrateResponse,
-    type AgentRetrieveContextResponse as AgentRetrieveContextResponse,
-    type AgentSearchResponse as AgentSearchResponse,
+    type AgentExportFileResponse as AgentExportFileResponse,
+    type AgentImportFileResponse as AgentImportFileResponse,
+    type AgentStatesArrayPage as AgentStatesArrayPage,
     type AgentCreateParams as AgentCreateParams,
     type AgentRetrieveParams as AgentRetrieveParams,
     type AgentUpdateParams as AgentUpdateParams,
     type AgentListParams as AgentListParams,
-    type AgentExportParams as AgentExportParams,
-    type AgentImportParams as AgentImportParams,
-    type AgentListGroupsParams as AgentListGroupsParams,
-    type AgentMigrateParams as AgentMigrateParams,
-    type AgentResetMessagesParams as AgentResetMessagesParams,
-    type AgentSearchParams as AgentSearchParams,
-    type AgentSummarizeParams as AgentSummarizeParams,
+    type AgentExportFileParams as AgentExportFileParams,
+    type AgentImportFileParams as AgentImportFileParams,
   };
 
   export {
-    Groups as Groups,
-    type DynamicManager as DynamicManager,
-    type Group as Group,
-    type ManagerType as ManagerType,
-    type RoundRobinManager as RoundRobinManager,
-    type SleeptimeManager as SleeptimeManager,
-    type SupervisorManager as SupervisorManager,
-    type VoiceSleeptimeManager as VoiceSleeptimeManager,
-    type GroupListResponse as GroupListResponse,
-    type GroupDeleteResponse as GroupDeleteResponse,
-    type GroupCountResponse as GroupCountResponse,
-    type GroupResetMessagesResponse as GroupResetMessagesResponse,
-    type GroupCreateParams as GroupCreateParams,
-    type GroupUpdateParams as GroupUpdateParams,
-    type GroupListParams as GroupListParams,
+    Tools as Tools,
+    type NpmRequirement as NpmRequirement,
+    type PipRequirement as PipRequirement,
+    type Tool as Tool,
+    type ToolCreate as ToolCreate,
+    type ToolReturnMessage as ToolReturnMessage,
+    type ToolType as ToolType,
+    type ToolDeleteResponse as ToolDeleteResponse,
+    type ToolUpsertBaseToolsResponse as ToolUpsertBaseToolsResponse,
+    type ToolsArrayPage as ToolsArrayPage,
+    type ToolCreateParams as ToolCreateParams,
+    type ToolUpdateParams as ToolUpdateParams,
+    type ToolListParams as ToolListParams,
+    type ToolUpsertParams as ToolUpsertParams,
   };
 
   export {
-    Identities as 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 IdentityListAgentsResponse as IdentityListAgentsResponse,
-    type IdentityListBlocksResponse as IdentityListBlocksResponse,
-    type IdentityUpsertPropertiesResponse as IdentityUpsertPropertiesResponse,
-    type IdentityCreateParams as IdentityCreateParams,
-    type IdentityListParams as IdentityListParams,
-    type IdentityListAgentsParams as IdentityListAgentsParams,
-    type IdentityListBlocksParams as IdentityListBlocksParams,
-    type IdentityModifyParams as IdentityModifyParams,
-    type IdentityUpsertParams as IdentityUpsertParams,
-    type IdentityUpsertPropertiesParams as IdentityUpsertPropertiesParams,
+    Blocks as Blocks,
+    type BlockResponse as BlockResponse,
+    type CreateBlock as CreateBlock,
+    type BlockDeleteResponse as BlockDeleteResponse,
+    type BlockResponsesArrayPage as BlockResponsesArrayPage,
+    type BlockCreateParams as BlockCreateParams,
+    type BlockUpdateParams as BlockUpdateParams,
+    type BlockListParams as BlockListParams,
   };
 
   export {
-    _InternalTemplates as _InternalTemplates,
-    type InternalTemplateCreateAgentParams as InternalTemplateCreateAgentParams,
-    type InternalTemplateCreateBlockParams as InternalTemplateCreateBlockParams,
-    type InternalTemplateCreateGroupParams as InternalTemplateCreateGroupParams,
+    Archives as Archives,
+    type Archive as Archive,
+    type VectorDBProvider as VectorDBProvider,
+    type ArchivesArrayPage as ArchivesArrayPage,
+    type ArchiveCreateParams as ArchiveCreateParams,
+    type ArchiveUpdateParams as ArchiveUpdateParams,
+    type ArchiveListParams as ArchiveListParams,
+  };
+
+  export {
+    Folders as Folders,
+    type Folder as Folder,
+    type FolderDeleteResponse as FolderDeleteResponse,
+    type FoldersArrayPage as FoldersArrayPage,
+    type FolderCreateParams as FolderCreateParams,
+    type FolderUpdateParams as FolderUpdateParams,
+    type FolderListParams as FolderListParams,
   };
 
   export {
     Models as Models,
     type EmbeddingConfig as EmbeddingConfig,
+    type EmbeddingModel as EmbeddingModel,
     type LlmConfig as LlmConfig,
+    type Model as Model,
     type ProviderCategory as ProviderCategory,
     type ProviderType as ProviderType,
     type ModelListResponse as ModelListResponse,
-    type ModelListEmbeddingResponse as ModelListEmbeddingResponse,
     type ModelListParams as ModelListParams,
   };
 
   export {
-    Blocks as Blocks,
-    type CreateBlock as CreateBlock,
-    type BlockListResponse as BlockListResponse,
-    type BlockDeleteResponse as BlockDeleteResponse,
-    type BlockCountResponse as BlockCountResponse,
-    type BlockListAgentsResponse as BlockListAgentsResponse,
-    type BlockCreateParams as BlockCreateParams,
-    type BlockUpdateParams as BlockUpdateParams,
-    type BlockListParams as BlockListParams,
-    type BlockListAgentsParams as BlockListAgentsParams,
-  };
-
-  export {
-    Jobs as Jobs,
-    type Job as Job,
-    type JobListResponse as JobListResponse,
-    type JobListActiveResponse as JobListActiveResponse,
-    type JobListParams as JobListParams,
-    type JobListActiveParams as JobListActiveParams,
-  };
-
-  export { Health as Health, type HealthCheckResponse as HealthCheckResponse };
-
-  export {
-    Providers as Providers,
-    type Provider as Provider,
-    type ProviderListResponse as ProviderListResponse,
-    type ProviderDeleteResponse as ProviderDeleteResponse,
-    type ProviderCheckResponse as ProviderCheckResponse,
-    type ProviderCreateParams as ProviderCreateParams,
-    type ProviderUpdateParams as ProviderUpdateParams,
-    type ProviderListParams as ProviderListParams,
-    type ProviderCheckParams as ProviderCheckParams,
+    McpServers as McpServers,
+    type CreateSseMcpServer as CreateSseMcpServer,
+    type CreateStdioMcpServer as CreateStdioMcpServer,
+    type CreateStreamableHTTPMcpServer as CreateStreamableHTTPMcpServer,
+    type McpToolExecuteRequest as McpToolExecuteRequest,
+    type SseMcpServer as SseMcpServer,
+    type StdioMcpServer as StdioMcpServer,
+    type StreamableHTTPMcpServer as StreamableHTTPMcpServer,
+    type ToolExecutionResult as ToolExecutionResult,
+    type UpdateSseMcpServer as UpdateSseMcpServer,
+    type UpdateStdioMcpServer as UpdateStdioMcpServer,
+    type UpdateStreamableHTTPMcpServer as UpdateStreamableHTTPMcpServer,
+    type McpServerCreateResponse as McpServerCreateResponse,
+    type McpServerRetrieveResponse as McpServerRetrieveResponse,
+    type McpServerUpdateResponse as McpServerUpdateResponse,
+    type McpServerListResponse as McpServerListResponse,
+    type McpServerRefreshResponse as McpServerRefreshResponse,
+    type McpServerCreateParams as McpServerCreateParams,
+    type McpServerUpdateParams as McpServerUpdateParams,
+    type McpServerRefreshParams as McpServerRefreshParams,
   };
 
   export {
     Runs as Runs,
+    type Job as Job,
     type StopReasonType as StopReasonType,
-    type RunListResponse as RunListResponse,
-    type RunListActiveResponse as RunListActiveResponse,
-    type RunListMessagesResponse as RunListMessagesResponse,
-    type RunListStepsResponse as RunListStepsResponse,
-    type RunRetrieveStreamResponse as RunRetrieveStreamResponse,
-    type RunRetrieveUsageResponse as RunRetrieveUsageResponse,
     type RunListParams as RunListParams,
-    type RunListActiveParams as RunListActiveParams,
-    type RunListMessagesParams as RunListMessagesParams,
-    type RunListStepsParams as RunListStepsParams,
-    type RunRetrieveStreamParams as RunRetrieveStreamParams,
   };
 
   export {
     Steps as Steps,
     type ProviderTrace as ProviderTrace,
     type Step as Step,
-    type StepListResponse as StepListResponse,
-    type StepListMessagesResponse as StepListMessagesResponse,
-    type StepRetrieveMetricsResponse as StepRetrieveMetricsResponse,
+    type StepsArrayPage as StepsArrayPage,
     type StepListParams as StepListParams,
-    type StepListMessagesParams as StepListMessagesParams,
-    type StepUpdateFeedbackParams as StepUpdateFeedbackParams,
   };
 
-  export { Tags as Tags, type TagListResponse as TagListResponse, type TagListParams as TagListParams };
-
-  export { Telemetry as Telemetry };
-
-  export { Messages as Messages };
+  export { Templates as Templates };
 
-  export { VoiceBeta as VoiceBeta };
+  export { Tags as Tags, type TagListResponse as TagListResponse, type TagListParams as TagListParams };
 
   export {
-    Embeddings as Embeddings,
-    type EmbeddingGetTotalStorageSizeResponse as EmbeddingGetTotalStorageSizeResponse,
-    type EmbeddingGetTotalStorageSizeParams as EmbeddingGetTotalStorageSizeParams,
+    Identities as Identities,
+    type Identity as Identity,
+    type IdentityProperty as IdentityProperty,
+    type IdentityType as IdentityType,
+    type IdentityDeleteResponse as IdentityDeleteResponse,
+    type IdentitiesArrayPage as IdentitiesArrayPage,
+    type IdentityCreateParams as IdentityCreateParams,
+    type IdentityUpdateParams as IdentityUpdateParams,
+    type IdentityListParams as IdentityListParams,
+    type IdentityUpsertParams as IdentityUpsertParams,
   };
 
   export {
-    Templates as Templates,
-    type TemplateCreateResponse as TemplateCreateResponse,
-    type TemplateListResponse as TemplateListResponse,
-    type TemplateDeleteResponse as TemplateDeleteResponse,
-    type TemplateCreateAgentsResponse as TemplateCreateAgentsResponse,
-    type TemplateForkResponse as TemplateForkResponse,
-    type TemplateGetSnapshotResponse as TemplateGetSnapshotResponse,
-    type TemplateListVersionsResponse as TemplateListVersionsResponse,
-    type TemplateRenameResponse as TemplateRenameResponse,
-    type TemplateSaveVersionResponse as TemplateSaveVersionResponse,
-    type TemplateUpdateDescriptionResponse as TemplateUpdateDescriptionResponse,
-    type TemplateCreateParams as TemplateCreateParams,
-    type TemplateListParams as TemplateListParams,
-    type TemplateDeleteParams as TemplateDeleteParams,
-    type TemplateCreateAgentsParams as TemplateCreateAgentsParams,
-    type TemplateForkParams as TemplateForkParams,
-    type TemplateGetSnapshotParams as TemplateGetSnapshotParams,
-    type TemplateListVersionsParams as TemplateListVersionsParams,
-    type TemplateRenameParams as TemplateRenameParams,
-    type TemplateSaveVersionParams as TemplateSaveVersionParams,
-    type TemplateUpdateDescriptionParams as TemplateUpdateDescriptionParams,
+    Groups as Groups,
+    type DynamicManager as DynamicManager,
+    type Group as Group,
+    type ManagerType as ManagerType,
+    type RoundRobinManager as RoundRobinManager,
+    type SleeptimeManager as SleeptimeManager,
+    type SupervisorManager as SupervisorManager,
+    type VoiceSleeptimeManager as VoiceSleeptimeManager,
+    type GroupDeleteResponse as GroupDeleteResponse,
+    type GroupsArrayPage as GroupsArrayPage,
+    type GroupCreateParams as GroupCreateParams,
+    type GroupUpdateParams as GroupUpdateParams,
+    type GroupListParams as GroupListParams,
   };
 
   export {
-    ClientSideAccessTokens as ClientSideAccessTokens,
-    type ClientSideAccessTokenCreateResponse as ClientSideAccessTokenCreateResponse,
-    type ClientSideAccessTokenListResponse as ClientSideAccessTokenListResponse,
-    type ClientSideAccessTokenDeleteResponse as ClientSideAccessTokenDeleteResponse,
-    type ClientSideAccessTokenCreateParams as ClientSideAccessTokenCreateParams,
-    type ClientSideAccessTokenListParams as ClientSideAccessTokenListParams,
-    type ClientSideAccessTokenDeleteParams as ClientSideAccessTokenDeleteParams,
+    Batches as Batches,
+    type BatchJob as BatchJob,
+    type BatchCancelResponse as BatchCancelResponse,
+    type BatchJobsArrayPage as BatchJobsArrayPage,
+    type BatchCreateParams as BatchCreateParams,
+    type BatchListParams as BatchListParams,
   };
 
   export {
-    Projects as Projects,
-    type ProjectListResponse as ProjectListResponse,
-    type ProjectListParams as ProjectListParams,
+    AccessTokens as AccessTokens,
+    type AccessTokenCreateResponse as AccessTokenCreateResponse,
+    type AccessTokenListResponse as AccessTokenListResponse,
+    type AccessTokenDeleteResponse as AccessTokenDeleteResponse,
+    type AccessTokenCreateParams as AccessTokenCreateParams,
+    type AccessTokenListParams as AccessTokenListParams,
+    type AccessTokenDeleteParams as AccessTokenDeleteParams,
   };
 }