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

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 1.0.0-alpha.7 (2025-10-24)
+
+Full Changelog: [v1.0.0-alpha.6...v1.0.0-alpha.7](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.6...v1.0.0-alpha.7)
+
+### Features
+
+* add agent template route to config ([a379f18](https://github.com/letta-ai/letta-node/commit/a379f189b301a71a7f229561327481ec9510ef93))
+* add new archive routes to sdk ([389a103](https://github.com/letta-ai/letta-node/commit/389a103835dac6e45720e8c640c4f46050bb0320))
+* add openai-style include param for agents relationship loading ([b5d9129](https://github.com/letta-ai/letta-node/commit/b5d91299de0444d848d9d340c1f4e97fcf99003c))
+* attach/detach identities route on blocks and agents, move archives attach/detach routes to agents ([3598ad8](https://github.com/letta-ai/letta-node/commit/3598ad8be4b5ba0bc8a52d8804aa356e451fbbb8))
+* deprecate append copy suffix, add override name [LET-5779] ([9315a1d](https://github.com/letta-ai/letta-node/commit/9315a1d1ce68b0dc3c569a0798dc57a03f9da945))
+* deprecate use_assistant_message in list endpoints ([01dc718](https://github.com/letta-ai/letta-node/commit/01dc71801be25019afd1f78897f549e61b50fa83))
+* fix patch approvals endpoint incorrectly using queyr params ([7afe5c8](https://github.com/letta-ai/letta-node/commit/7afe5c8f4e59ea35e227741de29656be9f8d7169))
+* remove relationship fields on identities ([46760eb](https://github.com/letta-ai/letta-node/commit/46760ebf5f756ac46ad49fedcfaa6376aa765990))
+* remove run tool for external sdk ([7553ec2](https://github.com/letta-ai/letta-node/commit/7553ec211dec69ff9c65492f2810abd5d165c322))
+* remove unused max length parameter ([52583f4](https://github.com/letta-ai/letta-node/commit/52583f440712308078b2a7df068500f056ed153c))
+* rename multi agent group to managed group ([c28d519](https://github.com/letta-ai/letta-node/commit/c28d5193c93e5388ec9ca439e9fbfda0ac9a14b3))
+* replace agent.identity_ids with agent.identities ([d030ea8](https://github.com/letta-ai/letta-node/commit/d030ea82e6e23c691c60bc47268e50db1a02b3ad))
+* reset message incorrectly using query param ([8887c58](https://github.com/letta-ai/letta-node/commit/8887c5802c50f782562572c650d8b7ffcc0d9fa6))
+* Revert "feat: revise mcp tool routes [LET-4321]" ([839bdbc](https://github.com/letta-ai/letta-node/commit/839bdbcb891119452b16554bb58737c6bb3ccefe))
+* Support embedding config on the archive [LET-5832] ([c464e03](https://github.com/letta-ai/letta-node/commit/c464e035785567695f998d18c661b1cfb4a35ed0))
+
+
+### Bug Fixes
+
+* sdk config code gen ([7c34069](https://github.com/letta-ai/letta-node/commit/7c340694b03d629e1a70081ff392440c30c59023))
+
+
+### Chores
+
+* add context_window_limit and max_tokens to UpdateAgent [LET-3743] [LET-3741] ([e8a7bd3](https://github.com/letta-ai/letta-node/commit/e8a7bd347e8973beefcf467b8da6532b39f74aa1))
+
 ## 1.0.0-alpha.6 (2025-10-22)
 
 Full Changelog: [v0.0.1...v1.0.0-alpha.6](https://github.com/letta-ai/letta-node/compare/v0.0.1...v1.0.0-alpha.6)

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Letta SDK
+   Copyright 2025 Letta
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -1,8 +1,8 @@
-# Letta SDK TypeScript API Library
+# Letta TypeScript API Library
 
 [![NPM version](<https://img.shields.io/npm/v/@letta-ai/letta-client.svg?label=npm%20(stable)>)](https://npmjs.org/package/@letta-ai/letta-client) ![npm bundle size](https://img.shields.io/bundlephobia/minzip/@letta-ai/letta-client)
 
-This library provides convenient access to the Letta SDK REST API from server-side TypeScript or JavaScript.
+This library provides convenient access to the Letta REST API from server-side TypeScript or JavaScript.
 
 The full API of this library can be found in [api.md](api.md).
 
@@ -20,14 +20,21 @@ The full API of this library can be found in [api.md](api.md).
 
 <!-- prettier-ignore -->
 ```js
-import LettaSDK from '@letta-ai/letta-client';
+import Letta from '@letta-ai/letta-client';
 
-const client = new LettaSDK({
-  apiKey: process.env['LETTA_SDK_API_KEY'], // This is the default and can be omitted
-  environment: 'environment_1', // defaults to 'production'
+const client = new Letta({
+  apiKey: process.env['LETTA_API_KEY'], // This is the default and can be omitted
+  environment: 'local', // defaults to 'cloud'
 });
 
-const archive = await client.archives.update({ name: 'name' });
+const archive = await client.archives.create({
+  embedding_config: {
+    embedding_dim: 0,
+    embedding_endpoint_type: 'openai',
+    embedding_model: 'embedding_model',
+  },
+  name: 'name',
+});
 
 console.log(archive.id);
 ```
@@ -38,15 +45,22 @@ This library includes TypeScript definitions for all request params and response
 
 <!-- prettier-ignore -->
 ```ts
-import LettaSDK from '@letta-ai/letta-client';
+import Letta from '@letta-ai/letta-client';
 
-const client = new LettaSDK({
-  apiKey: process.env['LETTA_SDK_API_KEY'], // This is the default and can be omitted
-  environment: 'environment_1', // defaults to 'production'
+const client = new Letta({
+  apiKey: process.env['LETTA_API_KEY'], // This is the default and can be omitted
+  environment: 'local', // defaults to 'cloud'
 });
 
-const params: LettaSDK.ArchiveUpdateParams = { name: 'name' };
-const archive: LettaSDK.Archive = await client.archives.update(params);
+const params: Letta.ArchiveCreateParams = {
+  embedding_config: {
+    embedding_dim: 0,
+    embedding_endpoint_type: 'openai',
+    embedding_model: 'embedding_model',
+  },
+  name: 'name',
+};
+const archive: Letta.Archive = await client.archives.create(params);
 ```
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
@@ -62,22 +76,32 @@ Request parameters that correspond to file uploads can be passed in many differe
 
 ```ts
 import fs from 'fs';
-import LettaSDK, { toFile } from '@letta-ai/letta-client';
+import Letta, { toFile } from '@letta-ai/letta-client';
 
-const client = new LettaSDK();
+const client = new Letta();
 
 // If you have access to Node `fs` we recommend using `fs.createReadStream()`:
-await client.sources.uploadFile('source_id', { file: fs.createReadStream('/path/to/file') });
+await client.folders.files.upload('source-123e4567-e89b-42d3-8456-426614174000', {
+  file: fs.createReadStream('/path/to/file'),
+});
 
 // Or if you have the web `File` API you can pass a `File` instance:
-await client.sources.uploadFile('source_id', { file: new File(['my bytes'], 'file') });
+await client.folders.files.upload('source-123e4567-e89b-42d3-8456-426614174000', {
+  file: new File(['my bytes'], 'file'),
+});
 
 // You can also pass a `fetch` `Response`:
-await client.sources.uploadFile('source_id', { file: await fetch('https://somesite/file') });
+await client.folders.files.upload('source-123e4567-e89b-42d3-8456-426614174000', {
+  file: await fetch('https://somesite/file'),
+});
 
 // Finally, if none of the above are convenient, you can use our `toFile` helper:
-await client.sources.uploadFile('source_id', { file: await toFile(Buffer.from('my bytes'), 'file') });
-await client.sources.uploadFile('source_id', { file: await toFile(new Uint8Array([0, 1, 2]), 'file') });
+await client.folders.files.upload('source-123e4567-e89b-42d3-8456-426614174000', {
+  file: await toFile(Buffer.from('my bytes'), 'file'),
+});
+await client.folders.files.upload('source-123e4567-e89b-42d3-8456-426614174000', {
+  file: await toFile(new Uint8Array([0, 1, 2]), 'file'),
+});
 ```
 
 ## Handling errors
@@ -88,15 +112,24 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-const archive = await client.archives.update({ name: 'name' }).catch(async (err) => {
-  if (err instanceof LettaSDK.APIError) {
-    console.log(err.status); // 400
-    console.log(err.name); // BadRequestError
-    console.log(err.headers); // {server: 'nginx', ...}
-  } else {
-    throw err;
-  }
-});
+const archive = await client.archives
+  .create({
+    embedding_config: {
+      embedding_dim: 0,
+      embedding_endpoint_type: 'openai',
+      embedding_model: 'embedding_model',
+    },
+    name: 'name',
+  })
+  .catch(async (err) => {
+    if (err instanceof Letta.APIError) {
+      console.log(err.status); // 400
+      console.log(err.name); // BadRequestError
+      console.log(err.headers); // {server: 'nginx', ...}
+    } else {
+      throw err;
+    }
+  });
 ```
 
 Error codes are as follows:
@@ -123,12 +156,12 @@ You can use the `maxRetries` option to configure or disable this:
 <!-- prettier-ignore -->
 ```js
 // Configure the default for all requests:
-const client = new LettaSDK({
+const client = new Letta({
   maxRetries: 0, // default is 2
 });
 
 // Or, configure per-request:
-await client.archives.update({ name: 'name' }, {
+await client.archives.create({ embedding_config: { embedding_dim: 0, embedding_endpoint_type: 'openai', embedding_model: 'embedding_model' }, name: 'name' }, {
   maxRetries: 5,
 });
 ```
@@ -140,12 +173,12 @@ Requests time out after 1 minute by default. You can configure this with a `time
 <!-- prettier-ignore -->
 ```ts
 // Configure the default for all requests:
-const client = new LettaSDK({
+const client = new Letta({
   timeout: 20 * 1000, // 20 seconds (default is 1 minute)
 });
 
 // Override per-request:
-await client.archives.update({ name: 'name' }, {
+await client.archives.create({ embedding_config: { embedding_dim: 0, embedding_endpoint_type: 'openai', embedding_model: 'embedding_model' }, name: 'name' }, {
   timeout: 5 * 1000,
 });
 ```
@@ -166,13 +199,31 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 
 <!-- prettier-ignore -->
 ```ts
-const client = new LettaSDK();
-
-const response = await client.archives.update({ name: 'name' }).asResponse();
+const client = new Letta();
+
+const response = await client.archives
+  .create({
+    embedding_config: {
+      embedding_dim: 0,
+      embedding_endpoint_type: 'openai',
+      embedding_model: 'embedding_model',
+    },
+    name: 'name',
+  })
+  .asResponse();
 console.log(response.headers.get('X-My-Header'));
 console.log(response.statusText); // access the underlying Response object
 
-const { data: archive, response: raw } = await client.archives.update({ name: 'name' }).withResponse();
+const { data: archive, response: raw } = await client.archives
+  .create({
+    embedding_config: {
+      embedding_dim: 0,
+      embedding_endpoint_type: 'openai',
+      embedding_model: 'embedding_model',
+    },
+    name: 'name',
+  })
+  .withResponse();
 console.log(raw.headers.get('X-My-Header'));
 console.log(archive.id);
 ```
@@ -187,13 +238,13 @@ console.log(archive.id);
 
 The log level can be configured in two ways:
 
-1. Via the `LETTA_SDK_LOG` environment variable
+1. Via the `LETTA_LOG` environment variable
 2. Using the `logLevel` client option (overrides the environment variable if set)
 
 ```ts
-import LettaSDK from '@letta-ai/letta-client';
+import Letta from '@letta-ai/letta-client';
 
-const client = new LettaSDK({
+const client = new Letta({
   logLevel: 'debug', // Show all log messages
 });
 ```
@@ -219,13 +270,13 @@ When providing a custom logger, the `logLevel` option still controls which messa
 below the configured level will not be sent to your logger.
 
 ```ts
-import LettaSDK from '@letta-ai/letta-client';
+import Letta from '@letta-ai/letta-client';
 import pino from 'pino';
 
 const logger = pino();
 
-const client = new LettaSDK({
-  logger: logger.child({ name: 'LettaSDK' }),
+const client = new Letta({
+  logger: logger.child({ name: 'Letta' }),
   logLevel: 'debug', // Send all messages to pino, allowing it to filter
 });
 ```
@@ -254,7 +305,7 @@ parameter. This library doesn't validate at runtime that the request matches the
 send will be sent as-is.
 
 ```ts
-client.archives.update({
+client.archives.create({
   // ...
   // @ts-expect-error baz is not yet public
   baz: 'undocumented option',
@@ -288,10 +339,10 @@ globalThis.fetch = fetch;
 Or pass it to the client:
 
 ```ts
-import LettaSDK from '@letta-ai/letta-client';
+import Letta from '@letta-ai/letta-client';
 import fetch from 'my-fetch';
 
-const client = new LettaSDK({ fetch });
+const client = new Letta({ fetch });
 ```
 
 ### Fetch options
@@ -299,9 +350,9 @@ const client = new LettaSDK({ fetch });
 If you want to set custom `fetch` options without overriding the `fetch` function, you can provide a `fetchOptions` object when instantiating the client or making a request. (Request-specific options override client options.)
 
 ```ts
-import LettaSDK from '@letta-ai/letta-client';
+import Letta from '@letta-ai/letta-client';
 
-const client = new LettaSDK({
+const client = new Letta({
   fetchOptions: {
     // `RequestInit` options
   },
@@ -316,11 +367,11 @@ options to requests:
 <img src="https://raw.githubusercontent.com/stainless-api/sdk-assets/refs/heads/main/node.svg" align="top" width="18" height="21"> **Node** <sup>[[docs](https://github.com/nodejs/undici/blob/main/docs/docs/api/ProxyAgent.md#example---proxyagent-with-fetch)]</sup>
 
 ```ts
-import LettaSDK from '@letta-ai/letta-client';
+import Letta from '@letta-ai/letta-client';
 import * as undici from 'undici';
 
 const proxyAgent = new undici.ProxyAgent('http://localhost:8888');
-const client = new LettaSDK({
+const client = new Letta({
   fetchOptions: {
     dispatcher: proxyAgent,
   },
@@ -330,9 +381,9 @@ const client = new LettaSDK({
 <img src="https://raw.githubusercontent.com/stainless-api/sdk-assets/refs/heads/main/bun.svg" align="top" width="18" height="21"> **Bun** <sup>[[docs](https://bun.sh/guides/http/proxy)]</sup>
 
 ```ts
-import LettaSDK from '@letta-ai/letta-client';
+import Letta from '@letta-ai/letta-client';
 
-const client = new LettaSDK({
+const client = new Letta({
   fetchOptions: {
     proxy: 'http://localhost:8888',
   },
@@ -342,10 +393,10 @@ const client = new LettaSDK({
 <img src="https://raw.githubusercontent.com/stainless-api/sdk-assets/refs/heads/main/deno.svg" align="top" width="18" height="21"> **Deno** <sup>[[docs](https://docs.deno.com/api/deno/~/Deno.createHttpClient)]</sup>
 
 ```ts
-import LettaSDK from 'npm:@letta-ai/letta-client';
+import Letta from 'npm:@letta-ai/letta-client';
 
 const httpClient = Deno.createHttpClient({ proxy: { url: 'http://localhost:8888' } });
-const client = new LettaSDK({
+const client = new Letta({
   fetchOptions: {
     client: httpClient,
   },

package/client.d.mts

@@ -5,56 +5,48 @@ import * as Opts from "./internal/request-options.mjs";
 import * as Errors from "./core/error.mjs";
 import * as Uploads from "./core/uploads.mjs";
 import * as API from "./resources/index.mjs";
+import * as TopLevelAPI from "./resources/top-level.mjs";
+import { HealthResponse } from "./resources/top-level.mjs";
 import { APIPromise } from "./core/api-promise.mjs";
-import { Archive, ArchiveRetrieveParams, ArchiveRetrieveResponse, ArchiveUpdateParams, Archives, VectorDBProvider } from "./resources/archives.mjs";
-import { BlockCountResponse, BlockCreateParams, BlockDeleteResponse, BlockListAgentsParams, BlockListAgentsResponse, BlockListParams, BlockListResponse, BlockUpdateParams, Blocks, CreateBlock } from "./resources/blocks.mjs";
-import { ClientSideAccessTokenCreateParams, ClientSideAccessTokenCreateResponse, ClientSideAccessTokenDeleteParams, ClientSideAccessTokenDeleteResponse, ClientSideAccessTokenListParams, ClientSideAccessTokenListResponse, ClientSideAccessTokens } from "./resources/client-side-access-tokens.mjs";
-import { EmbeddingGetTotalStorageSizeParams, EmbeddingGetTotalStorageSizeResponse, Embeddings } from "./resources/embeddings.mjs";
-import { Folder, FolderCountResponse, FolderCreateParams, FolderDeleteFileParams, FolderDeleteResponse, FolderGetByNameResponse, FolderListAgentsParams, FolderListAgentsResponse, FolderListFilesParams, FolderListFilesResponse, FolderListParams, FolderListPassagesParams, FolderListPassagesResponse, FolderListResponse, FolderRetrieveMetadataParams, FolderUpdateParams, FolderUploadFileParams, Folders } from "./resources/folders.mjs";
-import { Health, HealthCheckResponse } from "./resources/health.mjs";
-import { Identities, Identity, IdentityCountResponse, IdentityCreateParams, IdentityDeleteResponse, IdentityListAgentsParams, IdentityListAgentsResponse, IdentityListBlocksParams, IdentityListBlocksResponse, IdentityListParams, IdentityListResponse, IdentityModifyParams, IdentityProperty, IdentityType, IdentityUpsertParams, IdentityUpsertPropertiesParams, IdentityUpsertPropertiesResponse } from "./resources/identities.mjs";
-import { Job, JobListActiveParams, JobListActiveResponse, JobListParams, JobListResponse, Jobs } from "./resources/jobs.mjs";
-import { EmbeddingConfig, LlmConfig, ModelListEmbeddingResponse, ModelListParams, ModelListResponse, Models, ProviderCategory, ProviderType } from "./resources/models.mjs";
-import { ProjectListParams, ProjectListResponse, Projects } from "./resources/projects.mjs";
-import { Provider, ProviderCheckParams, ProviderCheckResponse, ProviderCreateParams, ProviderDeleteResponse, ProviderListParams, ProviderListResponse, ProviderUpdateParams, Providers } from "./resources/providers.mjs";
-import { RunListActiveParams, RunListActiveResponse, RunListMessagesParams, RunListMessagesResponse, RunListParams, RunListResponse, RunListStepsParams, RunListStepsResponse, RunRetrieveStreamParams, RunRetrieveStreamResponse, RunRetrieveUsageResponse, Runs, StopReasonType } from "./resources/runs.mjs";
-import { ProviderTrace, Step, StepListMessagesParams, StepListMessagesResponse, StepListParams, StepListResponse, StepRetrieveMetricsResponse, StepUpdateFeedbackParams, Steps } from "./resources/steps.mjs";
+import { Archive, ArchiveCreateParams, ArchiveListParams, ArchiveListResponse, ArchiveUpdateParams, Archives, VectorDBProvider } from "./resources/archives.mjs";
 import { TagListParams, TagListResponse, Tags } from "./resources/tags.mjs";
-import { Telemetry } from "./resources/telemetry.mjs";
-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.mjs";
-import { InternalTemplateCreateAgentParams, InternalTemplateCreateBlockParams, InternalTemplateCreateGroupParams, _InternalTemplates } from "./resources/-internal-templates/-internal-templates.mjs";
-import { AgentCountResponse, AgentCreateParams, AgentDeleteResponse, AgentEnvironmentVariable, AgentExportParams, AgentExportResponse, AgentImportParams, AgentImportResponse, AgentListGroupsParams, AgentListGroupsResponse, AgentListParams, AgentListResponse, AgentMigrateParams, AgentMigrateResponse, AgentResetMessagesParams, AgentRetrieveContextResponse, AgentRetrieveParams, AgentSearchParams, AgentSearchResponse, AgentState, AgentSummarizeParams, AgentType, AgentUpdateParams, Agents, ChildToolRule, ConditionalToolRule, ContinueToolRule, InitToolRule, JsonObjectResponseFormat, JsonSchemaResponseFormat, LettaMessageContentUnion, MaxCountPerStepToolRule, MessageCreate, ParentToolRule, RequiredBeforeExitToolRule, RequiresApprovalToolRule, TerminalToolRule, TextResponseFormat } from "./resources/agents/agents.mjs";
-import { DynamicManager, Group, GroupCountResponse, GroupCreateParams, GroupDeleteResponse, GroupListParams, GroupListResponse, GroupResetMessagesResponse, GroupUpdateParams, Groups, ManagerType, RoundRobinManager, SleeptimeManager, SupervisorManager, VoiceSleeptimeManager } from "./resources/groups/groups.mjs";
-import { Messages } from "./resources/messages/messages.mjs";
-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.mjs";
-import { NpmRequirement, PipRequirement, Tool, ToolCountParams, ToolCountResponse, ToolCreate, ToolCreateParams, ToolDeleteResponse, ToolListParams, ToolListResponse, ToolModifyParams, ToolReturnMessage, ToolRunParams, ToolType, ToolUpsertBaseResponse, ToolUpsertParams, Tools } from "./resources/tools/tools.mjs";
-import { VoiceBeta } from "./resources/voice-beta/voice-beta.mjs";
+import { NpmRequirement, PipRequirement, Tool, ToolCountParams, ToolCountResponse, ToolCreate, ToolCreateParams, ToolDeleteResponse, ToolListParams, ToolListResponse, ToolReturnMessage, ToolType, ToolUpdateParams, ToolUpsertBaseToolsResponse, ToolUpsertParams, Tools } from "./resources/tools.mjs";
+import { AgentCountResponse, AgentCreateParams, AgentDeleteResponse, AgentEnvironmentVariable, AgentExportFileParams, AgentExportFileResponse, AgentImportFileParams, AgentImportFileResponse, AgentListParams, AgentListResponse, AgentRetrieveParams, AgentState, AgentType, AgentUpdateParams, Agents, ChildToolRule, ConditionalToolRule, ContinueToolRule, InitToolRule, JsonObjectResponseFormat, JsonSchemaResponseFormat, LettaMessageContentUnion, MaxCountPerStepToolRule, MessageCreate, ParentToolRule, RequiredBeforeExitToolRule, RequiresApprovalToolRule, TerminalToolRule, TextResponseFormat } from "./resources/agents/agents.mjs";
+import { BatchCancelResponse, BatchCreateParams, BatchJob, BatchListParams, BatchListResponse, Batches } from "./resources/batches/batches.mjs";
+import { BlockCountResponse, BlockCreateParams, BlockDeleteResponse, BlockListParams, BlockListResponse, BlockUpdateParams, Blocks, CreateBlock } from "./resources/blocks/blocks.mjs";
+import { Folder, FolderCountResponse, FolderCreateParams, FolderDeleteResponse, FolderListParams, FolderListResponse, FolderUpdateParams, Folders } from "./resources/folders/folders.mjs";
+import { DynamicManager, Group, GroupCountResponse, GroupCreateParams, GroupDeleteResponse, GroupListParams, GroupListResponse, GroupUpdateParams, Groups, ManagerType, RoundRobinManager, SleeptimeManager, SupervisorManager, VoiceSleeptimeManager } from "./resources/groups/groups.mjs";
+import { Identities, Identity, IdentityCountResponse, IdentityCreateParams, IdentityDeleteResponse, IdentityListParams, IdentityListResponse, IdentityProperty, IdentityType, IdentityUpdateParams, IdentityUpsertParams } from "./resources/identities/identities.mjs";
+import { EmbeddingConfig, LlmConfig, ModelListParams, ModelListResponse, Models, ProviderCategory, ProviderType } from "./resources/models/models.mjs";
+import { Job, RunListParams, RunListResponse, Runs, StopReasonType } from "./resources/runs/runs.mjs";
+import { ProviderTrace, Step, StepListParams, StepListResponse, Steps } from "./resources/steps/steps.mjs";
+import { Templates } from "./resources/templates/templates.mjs";
 import { type Fetch } from "./internal/builtin-types.mjs";
 import { HeadersLike, NullableHeaders } from "./internal/headers.mjs";
 import { FinalRequestOptions, RequestOptions } from "./internal/request-options.mjs";
 import { type LogLevel, type Logger } from "./internal/utils/log.mjs";
 declare const environments: {
-    production: string;
-    environment_1: string;
+    cloud: string;
+    local: string;
 };
 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 | 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://app.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;
     /**
@@ -102,7 +94,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;
     /**
@@ -113,9 +105,9 @@ export interface ClientOptions {
     logger?: Logger | undefined;
 }
 /**
- * API Client for interfacing with the Letta SDK API.
+ * API Client for interfacing with the Letta API.
  */
-export declare class LettaSDK {
+export declare class Letta {
     #private;
     apiKey: string;
     baseURL: string;
@@ -128,11 +120,11 @@ export declare class LettaSDK {
     protected idempotencyHeader?: string;
     private _options;
     /**
-     * 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 | undefined} [opts.apiKey=process.env['LETTA_API_KEY'] ?? undefined]
+     * @param {Environment} [opts.environment=cloud] - Specifies the environment URL to use for the API.
+     * @param {string} [opts.baseURL=process.env['LETTA_BASE_URL'] ?? https://app.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.
@@ -145,6 +137,10 @@ export declare class LettaSDK {
      * Create a new client instance re-using the same options given to the current client with optional overriding.
      */
     withOptions(options: Partial<ClientOptions>): this;
+    /**
+     * Check Health
+     */
+    health(options?: RequestOptions): APIPromise<TopLevelAPI.HealthResponse>;
     protected defaultQuery(): Record<string, string | undefined> | undefined;
     protected validateHeaders({ values, nulls }: NullableHeaders): void;
     protected authHeaders(opts: FinalRequestOptions): Promise<NullableHeaders | undefined>;
@@ -188,9 +184,9 @@ export declare class LettaSDK {
     }>;
     private buildHeaders;
     private buildBody;
-    static LettaSDK: typeof LettaSDK;
+    static Letta: typeof Letta;
     static DEFAULT_TIMEOUT: number;
-    static LettaSDKError: typeof Errors.LettaSDKError;
+    static LettaError: typeof Errors.LettaError;
     static APIError: typeof Errors.APIError;
     static APIConnectionError: typeof Errors.APIConnectionError;
     static APIConnectionTimeoutError: typeof Errors.APIConnectionTimeoutError;
@@ -206,52 +202,33 @@ export declare class LettaSDK {
     static toFile: typeof Uploads.toFile;
     archives: API.Archives;
     tools: API.Tools;
-    sources: API.Sources;
     folders: API.Folders;
     agents: API.Agents;
     groups: API.Groups;
     identities: API.Identities;
-    _internalTemplates: API._InternalTemplates;
     models: API.Models;
     blocks: API.Blocks;
-    jobs: API.Jobs;
-    health: API.Health;
-    providers: API.Providers;
     runs: API.Runs;
     steps: API.Steps;
     tags: API.Tags;
-    telemetry: API.Telemetry;
-    messages: API.Messages;
-    voiceBeta: API.VoiceBeta;
-    embeddings: API.Embeddings;
+    batches: API.Batches;
     templates: API.Templates;
-    clientSideAccessTokens: API.ClientSideAccessTokens;
-    projects: API.Projects;
 }
-export declare namespace LettaSDK {
+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 { 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 { 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, };
-    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 { Agents as Agents, type AgentEnvironmentVariable as AgentEnvironmentVariable, type AgentState as AgentState, type AgentType as AgentType, type ChildToolRule as ChildToolRule, type ConditionalToolRule as ConditionalToolRule, type ContinueToolRule as ContinueToolRule, 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 ParentToolRule as ParentToolRule, type RequiredBeforeExitToolRule as RequiredBeforeExitToolRule, type RequiresApprovalToolRule as RequiresApprovalToolRule, type TerminalToolRule as TerminalToolRule, type TextResponseFormat as TextResponseFormat, type AgentListResponse as AgentListResponse, 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 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, };
-    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, };
-    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, };
-    export { _InternalTemplates as _InternalTemplates, type InternalTemplateCreateAgentParams as InternalTemplateCreateAgentParams, type InternalTemplateCreateBlockParams as InternalTemplateCreateBlockParams, type InternalTemplateCreateGroupParams as InternalTemplateCreateGroupParams, };
-    export { Models as Models, type EmbeddingConfig as EmbeddingConfig, type LlmConfig as LlmConfig, 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, };
-    export { Runs as Runs, 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 StepListParams as StepListParams, type StepListMessagesParams as StepListMessagesParams, type StepUpdateFeedbackParams as StepUpdateFeedbackParams, };
+    export { type HealthResponse as HealthResponse };
+    export { Archives as Archives, type Archive as Archive, type VectorDBProvider as VectorDBProvider, type ArchiveListResponse as ArchiveListResponse, type ArchiveCreateParams as ArchiveCreateParams, type ArchiveUpdateParams as ArchiveUpdateParams, type ArchiveListParams as ArchiveListParams, };
+    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 ToolUpsertBaseToolsResponse as ToolUpsertBaseToolsResponse, type ToolCreateParams as ToolCreateParams, type ToolUpdateParams as ToolUpdateParams, type ToolListParams as ToolListParams, type ToolCountParams as ToolCountParams, type ToolUpsertParams as ToolUpsertParams, };
+    export { Folders as Folders, type Folder as Folder, type FolderListResponse as FolderListResponse, type FolderDeleteResponse as FolderDeleteResponse, type FolderCountResponse as FolderCountResponse, type FolderCreateParams as FolderCreateParams, type FolderUpdateParams as FolderUpdateParams, type FolderListParams as FolderListParams, };
+    export { Agents as Agents, type AgentEnvironmentVariable as AgentEnvironmentVariable, type AgentState as AgentState, type AgentType as AgentType, type ChildToolRule as ChildToolRule, type ConditionalToolRule as ConditionalToolRule, type ContinueToolRule as ContinueToolRule, 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 ParentToolRule as ParentToolRule, type RequiredBeforeExitToolRule as RequiredBeforeExitToolRule, type RequiresApprovalToolRule as RequiresApprovalToolRule, type TerminalToolRule as TerminalToolRule, type TextResponseFormat as TextResponseFormat, type AgentListResponse as AgentListResponse, type AgentDeleteResponse as AgentDeleteResponse, type AgentCountResponse as AgentCountResponse, type AgentExportFileResponse as AgentExportFileResponse, type AgentImportFileResponse as AgentImportFileResponse, type AgentCreateParams as AgentCreateParams, type AgentRetrieveParams as AgentRetrieveParams, type AgentUpdateParams as AgentUpdateParams, type AgentListParams as AgentListParams, 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 GroupCreateParams as GroupCreateParams, type GroupUpdateParams as GroupUpdateParams, type GroupListParams as GroupListParams, };
+    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 IdentityCreateParams as IdentityCreateParams, type IdentityUpdateParams as IdentityUpdateParams, type IdentityListParams as IdentityListParams, type IdentityUpsertParams as IdentityUpsertParams, };
+    export { Models as Models, type EmbeddingConfig as EmbeddingConfig, type LlmConfig as LlmConfig, type ProviderCategory as ProviderCategory, type ProviderType as ProviderType, type ModelListResponse as ModelListResponse, 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 BlockCreateParams as BlockCreateParams, type BlockUpdateParams as BlockUpdateParams, type BlockListParams as BlockListParams, };
+    export { Runs as Runs, type Job as Job, type StopReasonType as StopReasonType, type RunListResponse as RunListResponse, type RunListParams as RunListParams, };
+    export { Steps as Steps, type ProviderTrace as ProviderTrace, type Step as Step, type StepListResponse as StepListResponse, type StepListParams as StepListParams, };
     export { Tags as Tags, type TagListResponse as TagListResponse, type TagListParams as TagListParams };
-    export { Telemetry as Telemetry };
-    export { Messages as Messages };
-    export { VoiceBeta as VoiceBeta };
-    export { Embeddings as Embeddings, type EmbeddingGetTotalStorageSizeResponse as EmbeddingGetTotalStorageSizeResponse, type EmbeddingGetTotalStorageSizeParams as EmbeddingGetTotalStorageSizeParams, };
-    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, };
-    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, };
-    export { Projects as Projects, type ProjectListResponse as ProjectListResponse, type ProjectListParams as ProjectListParams, };
+    export { Batches as Batches, type BatchJob as BatchJob, type BatchListResponse as BatchListResponse, type BatchCancelResponse as BatchCancelResponse, type BatchCreateParams as BatchCreateParams, type BatchListParams as BatchListParams, };
+    export { Templates as Templates };
 }
 //# sourceMappingURL=client.d.mts.map