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

package/CHANGELOG.md

@@ -1,5 +1,244 @@
 # Changelog
 
+## 1.0.0 (2025-11-19)
+
+Full Changelog: [v1.0.0-alpha.22...v1.0.0](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.22...v1.0.0)
+
+### Features
+
+* add client side access tokens to stainless ([9c79dd0](https://github.com/letta-ai/letta-node/commit/9c79dd06df9871369568323bbe30b4cbf2f97727))
+* hack at gpt51 [LET-6178] ([1f3743e](https://github.com/letta-ai/letta-node/commit/1f3743e56c0544f4e8e59c1a7219b462a0e2dec7))
+* Revert "feat: support anthropic structured outputs [LET-6190]" ([1b7a65a](https://github.com/letta-ai/letta-node/commit/1b7a65a66999dbfbd1d43f1d6592a0278251d299))
+
+## 1.0.0-alpha.22 (2025-11-18)
+
+Full Changelog: [v1.0.0-alpha.21...v1.0.0-alpha.22](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.21...v1.0.0-alpha.22)
+
+### Features
+
+* make config for mcp_servers and messages.modify nested ([3ce1bc2](https://github.com/letta-ai/letta-node/commit/3ce1bc2c17000fbf9de21410675ad00e2fc7e2fb))
+
+
+### Bug Fixes
+
+* make attach/detach routes return None if sdk verion 1.0 ([95ab434](https://github.com/letta-ai/letta-node/commit/95ab4342ac7e201f9cd7ac85d35503205b76abad))
+
+## 1.0.0-alpha.21 (2025-11-17)
+
+Full Changelog: [v1.0.0-alpha.20...v1.0.0-alpha.21](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.20...v1.0.0-alpha.21)
+
+### Features
+
+* make attach/detach routes return None if version is 1.0 [LET-5844] ([9681272](https://github.com/letta-ai/letta-node/commit/9681272d5d81a5101bec87080b0d9d240f7df6c1))
+* move sources to folders ([9b06ed2](https://github.com/letta-ai/letta-node/commit/9b06ed23e766ed01d04a611e5acc6e31150ad8bd))
+* rename .af parameters [LET-6154] ([99c0fb6](https://github.com/letta-ai/letta-node/commit/99c0fb6f1eb6ac1b17fa966949c2eeb8c6373cfc))
+* Revert "feat: make attach/detach routes return None if version is 1.0 [LET-5844]" ([416e6f2](https://github.com/letta-ai/letta-node/commit/416e6f206f7683d73b7fccf78fd8141342355f21))
+* support anthropic structured outputs [LET-6190] ([0a1cef3](https://github.com/letta-ai/letta-node/commit/0a1cef3515b17ed77de519e06c9e498a0ce842ef))
+
+
+### Chores
+
+* remove mcp-servers connect for stainless [LET-6166] ([fbaa041](https://github.com/letta-ai/letta-node/commit/fbaa041aae7a21d9e3ba0be4516fcacc52c32cbe))
+* rename summarize to compact in sdk ([9f58804](https://github.com/letta-ai/letta-node/commit/9f5880448cf253b15ef69e36bac6a29394699e7c))
+
+## 1.0.0-alpha.20 (2025-11-12)
+
+Full Changelog: [v1.0.0-alpha.19...v1.0.0-alpha.20](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.19...v1.0.0-alpha.20)
+
+### Features
+
+* deprecate `EmbeddingConfig` from archives ([30b174c](https://github.com/letta-ai/letta-node/commit/30b174c30bc1364f48de752c7b3fb9bdb4d60503))
+
+
+### Chores
+
+* rename send to create and modify to update ([d5aec1c](https://github.com/letta-ai/letta-node/commit/d5aec1cdcf8dadf31616939ad6d74e30315ab9b8))
+* update stainless send to create ([92380e0](https://github.com/letta-ai/letta-node/commit/92380e02c838231f371e96e701655b4e0b6144f4))
+
+## 1.0.0-alpha.19 (2025-11-12)
+
+Full Changelog: [v1.0.0-alpha.18...v1.0.0-alpha.19](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.18...v1.0.0-alpha.19)
+
+### Features
+
+* add approval return param to stainless ([7ec5ea3](https://github.com/letta-ai/letta-node/commit/7ec5ea3da042bae9d8a20d64ef4d301f778514a7))
+* add attach detach methods for archives and identities to sdk ([f644e48](https://github.com/letta-ai/letta-node/commit/f644e487f079e2b136334f0b4e7586d97a978f69))
+* add create memory for archive ([8414e07](https://github.com/letta-ai/letta-node/commit/8414e0785a5b4007107c8a38a4b38698ca3bb9f4))
+* add model setting params to stainless config ([30e5ba2](https://github.com/letta-ai/letta-node/commit/30e5ba23a93427826406bdf5b3d84e188ac6b4bf))
+* add passage deletion route to sdk ([a6656fe](https://github.com/letta-ai/letta-node/commit/a6656fe29a222d9558afb7da80135df9b59c3695))
+* bring back model_settings and remove validation again ([916f8ea](https://github.com/letta-ai/letta-node/commit/916f8ea257dad7a4d413f855cc844f99d414bb8a))
+* make api key optional in sdk ([2ad9913](https://github.com/letta-ai/letta-node/commit/2ad99135884527fcf1255205d6c6840fb2526084))
+* rename message union and internal message ([25bd7a0](https://github.com/letta-ai/letta-node/commit/25bd7a0f12b29988e60dbe5640aff8133f015fef))
+* revert model_settings ([6f9e60b](https://github.com/letta-ai/letta-node/commit/6f9e60b6a82e0f7e54a8b100d90a88a3053a45d1))
+
+
+### Chores
+
+* api sync ([fce4f3a](https://github.com/letta-ai/letta-node/commit/fce4f3af9e6646cc9318cd122c2d1afdc9d16f7e))
+* reorder stainless SDK ([7b390be](https://github.com/letta-ai/letta-node/commit/7b390be89c288ea33fdfcfbba6143590e58ebb14))
+
+## 1.0.0-alpha.18 (2025-11-10)
+
+Full Changelog: [v1.0.0-alpha.17...v1.0.0-alpha.18](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.17...v1.0.0-alpha.18)
+
+### Features
+
+* add list support for query params in sdk ([3494a74](https://github.com/letta-ai/letta-node/commit/3494a746d05f9a5c24f912003ffafd667e3cbeca))
+
+
+### Bug Fixes
+
+* prevent too many runs bug ([d4459ff](https://github.com/letta-ai/letta-node/commit/d4459ff324e183593c9a7a825ed1bd16faa6a903))
+
+## 1.0.0-alpha.17 (2025-11-08)
+
+Full Changelog: [v1.0.0-alpha.16...v1.0.0-alpha.17](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.16...v1.0.0-alpha.17)
+
+### Features
+
+* add model settings schema to stainless [LET-5976] ([6b68312](https://github.com/letta-ai/letta-node/commit/6b683126b6ca4c77fc9ade4479ec582fdab196d8))
+* chore; regen ([554c4a9](https://github.com/letta-ai/letta-node/commit/554c4a90b217669caca4801719434cb903b40aae))
+* split up handle and `model_settings` ([4f05e2b](https://github.com/letta-ai/letta-node/commit/4f05e2b1c73ac178063547dae9bb7b984bd4c2d2))
+
+
+### Chores
+
+* add model and embedding models ([81a78a1](https://github.com/letta-ai/letta-node/commit/81a78a13c1967e2db6442af04476aa8972b32ca4))
+
+## 1.0.0-alpha.16 (2025-11-07)
+
+Full Changelog: [v1.0.0-alpha.15...v1.0.0-alpha.16](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.15...v1.0.0-alpha.16)
+
+### Features
+
+* add filters to count_agents endpoint [LET-5380] [LET-5497] ([b46fb82](https://github.com/letta-ai/letta-node/commit/b46fb82c9369d548a328b024e04074d4ed29ece8))
+* add last_stop_reason to AgentState [LET-5911] ([b49b54d](https://github.com/letta-ai/letta-node/commit/b49b54de46dedfc859407681790fc02558244792))
+* enable streaming flag on send message ([e990b70](https://github.com/letta-ai/letta-node/commit/e990b70a2fe68b969dfc6b8f9f4cdc5f441b36b8))
+* filter list agents by stop reason [LET-5928] ([7809961](https://github.com/letta-ai/letta-node/commit/780996166e7f74ef903850072a1e2bd225534096))
+* return new Model and EmbeddingModel objects for list model/embedding endpoints [LET-6090] ([137bff3](https://github.com/letta-ai/letta-node/commit/137bff3d038bcf64e1387997c65ea1ed109e5e96))
+* Revert "Revert "feat: provider-specific model configuration " ([#5873](https://github.com/letta-ai/letta-node/issues/5873))" ([e63538e](https://github.com/letta-ai/letta-node/commit/e63538e97b275f74f4b5d76f67a60b2163e330e8))
+
+
+### Bug Fixes
+
+* add mcp server routes typing to stainless.yml ([f9e57a7](https://github.com/letta-ai/letta-node/commit/f9e57a720628e4ad6947471ab07fb03a77e965a8))
+* **core:** patch bug w/ sleeptime agents and client-side tool executions [LET-6081] ([2ae116f](https://github.com/letta-ai/letta-node/commit/2ae116f7354534c341b706474da57def3b8c3013))
+* fix refresh sdk name stainless ([d66d4a6](https://github.com/letta-ai/letta-node/commit/d66d4a6b3c16b35397202eadac3d6584be2ec8de))
+* stainless pagination ([546b50c](https://github.com/letta-ai/letta-node/commit/546b50cc3bba2b09aff4e690ce39473dc3cf7909))
+
+
+### Chores
+
+* remove count methods from stainless sdk ([a394300](https://github.com/letta-ai/letta-node/commit/a394300fc5c4ca0df19ac5ab6ab7d1f51b9d7335))
+
+## 1.0.0-alpha.15 (2025-11-04)
+
+Full Changelog: [v1.0.0-alpha.14...v1.0.0-alpha.15](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.14...v1.0.0-alpha.15)
+
+### Features
+
+* add `EventMessage` and `SummaryMessage` ([5b88362](https://github.com/letta-ai/letta-node/commit/5b88362e8effeee88910744969968fa048d9772c))
+* add input option to send message route [LET-4540] ([0589b69](https://github.com/letta-ai/letta-node/commit/0589b6994cbbe70024cd444f23840ee25b826806))
+* make sure tool return chars within max int range ([6092ede](https://github.com/letta-ai/letta-node/commit/6092ede5fb5390f0632d6be2e1da52bc5fd1cc45))
+
+## 1.0.0-alpha.14 (2025-11-04)
+
+Full Changelog: [v1.0.0-alpha.13...v1.0.0-alpha.14](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.13...v1.0.0-alpha.14)
+
+### Features
+
+* add new project id header to stainless client ([f8066b6](https://github.com/letta-ai/letta-node/commit/f8066b6f9d8813bae0ffac391ab4fc4f9fee93bd))
+
+
+### Bug Fixes
+
+* enable stainless pagination ([ae519f4](https://github.com/letta-ai/letta-node/commit/ae519f482c503f669364d4c7fd2496905dfd0ebc))
+
+
+### Chores
+
+* update stainless templates route to not pass in project id ([c032587](https://github.com/letta-ai/letta-node/commit/c032587e583ba130b7eda733145554252b3b50b4))
+
+## 1.0.0-alpha.13 (2025-11-03)
+
+Full Changelog: [v1.0.0-alpha.12...v1.0.0-alpha.13](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.12...v1.0.0-alpha.13)
+
+### Features
+
+* add stream return type to all sse endpoints ([c22c792](https://github.com/letta-ai/letta-node/commit/c22c792ab23bad57de9b6b356afb31ef2f075264))
+
+## 1.0.0-alpha.12 (2025-11-01)
+
+Full Changelog: [v1.0.0-alpha.11...v1.0.0-alpha.12](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.11...v1.0.0-alpha.12)
+
+### Features
+
+* add error handle to stainless stream response ([a17dea8](https://github.com/letta-ai/letta-node/commit/a17dea812692f11bfe6ddd5ea87b7f043a83ca0d))
+
+## 1.0.0-alpha.11 (2025-10-31)
+
+Full Changelog: [v1.0.0-alpha.10...v1.0.0-alpha.11](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.10...v1.0.0-alpha.11)
+
+### Features
+
+* add project and project_id fields to stainless client ([3e40365](https://github.com/letta-ai/letta-node/commit/3e403651515619eb67859680b05b204003097389))
+* provider-specific model configuration ([8ea03d2](https://github.com/letta-ai/letta-node/commit/8ea03d2e6719a025c065a59b0b361a047880df73))
+* Revert "feat: provider-specific model configuration " ([35f2757](https://github.com/letta-ai/letta-node/commit/35f2757b25075b230ab6cece92c177503da7def1))
+
+
+### Bug Fixes
+
+* stainless merge build dependency on changed files ([0cab2f0](https://github.com/letta-ai/letta-node/commit/0cab2f0087fcb99b68a7c1bb6bc2f815c6ecfcd9))
+
+
+### Chores
+
+* verify stainless merge build ([6e086a3](https://github.com/letta-ai/letta-node/commit/6e086a3cea7f4152324c34b53201a1df4aff6224))
+
+## 1.0.0-alpha.10 (2025-10-29)
+
+Full Changelog: [v1.0.0-alpha.9...v1.0.0-alpha.10](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.9...v1.0.0-alpha.10)
+
+### Features
+
+* add streaming response type to messages stream for stainless ([56e61ef](https://github.com/letta-ai/letta-node/commit/56e61efde6a6cfe73e8f58fefd46cbec8ecc4769))
+
+
+### Bug Fixes
+
+* toggle off stainless pagination for list endpoints that require id field ([575af0c](https://github.com/letta-ai/letta-node/commit/575af0c4be8eab72f6fe5334e4e14943b2694153))
+* use api base url for cloud ([d4de0a9](https://github.com/letta-ai/letta-node/commit/d4de0a946cbf1bb0736455a04c969c50b028ba36))
+
+## 1.0.0-alpha.9 (2025-10-24)
+
+Full Changelog: [v1.0.0-alpha.8...v1.0.0-alpha.9](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.8...v1.0.0-alpha.9)
+
+### Features
+
+* clean up block return object  [LET-5784] ([9d70a8a](https://github.com/letta-ai/letta-node/commit/9d70a8aaf6ece09236092dbb1faedb9bf4c06ef0))
+* deprecate shared_block_ids, and add groups, blocks [LET-4430] ([eae2e06](https://github.com/letta-ai/letta-node/commit/eae2e06ff465987018b459bb5a711f6d6a0b5e08))
+
+
+### Chores
+
+* rename update methods to modify in stainless ([6e1bd59](https://github.com/letta-ai/letta-node/commit/6e1bd59fd2634fcf3b3c5cfeeb724e95b7541dfa))
+
+## 1.0.0-alpha.8 (2025-10-24)
+
+Full Changelog: [v1.0.0-alpha.7...v1.0.0-alpha.8](https://github.com/letta-ai/letta-node/compare/v1.0.0-alpha.7...v1.0.0-alpha.8)
+
+### Features
+
+* add pagination config for list agent files ([38a2be0](https://github.com/letta-ai/letta-node/commit/38a2be0e97cb498d0a3b0b3d73d2e0f4d1bf9ae4))
+* add pagination configuration for list batch message endpoint ([855f60e](https://github.com/letta-ai/letta-node/commit/855f60e1f54880023a9b927b175deb4ccb085b1d))
+* add stainless pagination for identities ([ed5e7c7](https://github.com/letta-ai/letta-node/commit/ed5e7c724e42a10bf08a7bf3c66544f62070e4dc))
+* make some routes return none for sdk v1 ([2621268](https://github.com/letta-ai/letta-node/commit/2621268acf05b913e687daf567894651d0aac6d4))
+
+
+### Chores
+
+* add order_by param to list archives [LET-5839] ([33d74a9](https://github.com/letta-ai/letta-node/commit/33d74a948525b99befe5c53bfd539f7555cfed47))
+
 ## 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)

package/README.md

@@ -27,14 +27,7 @@ const client = new Letta({
   environment: 'local', // defaults to 'cloud'
 });
 
-const archive = await client.archives.create({
-  embedding_config: {
-    embedding_dim: 0,
-    embedding_endpoint_type: 'openai',
-    embedding_model: 'embedding_model',
-  },
-  name: 'name',
-});
+const archive = await client.archives.create({ name: 'name' });
 
 console.log(archive.id);
 ```
@@ -52,14 +45,7 @@ const client = new Letta({
   environment: 'local', // defaults to 'cloud'
 });
 
-const params: Letta.ArchiveCreateParams = {
-  embedding_config: {
-    embedding_dim: 0,
-    embedding_endpoint_type: 'openai',
-    embedding_model: 'embedding_model',
-  },
-  name: 'name',
-};
+const params: Letta.ArchiveCreateParams = { name: 'name' };
 const archive: Letta.Archive = await client.archives.create(params);
 ```
 
@@ -81,27 +67,17 @@ import Letta, { toFile } from '@letta-ai/letta-client';
 const client = new Letta();
 
 // If you have access to Node `fs` we recommend using `fs.createReadStream()`:
-await client.folders.files.upload('source-123e4567-e89b-42d3-8456-426614174000', {
-  file: fs.createReadStream('/path/to/file'),
-});
+await client.agents.importFile({ file: fs.createReadStream('/path/to/file') });
 
 // Or if you have the web `File` API you can pass a `File` instance:
-await client.folders.files.upload('source-123e4567-e89b-42d3-8456-426614174000', {
-  file: new File(['my bytes'], 'file'),
-});
+await client.agents.importFile({ file: new File(['my bytes'], 'file') });
 
 // You can also pass a `fetch` `Response`:
-await client.folders.files.upload('source-123e4567-e89b-42d3-8456-426614174000', {
-  file: await fetch('https://somesite/file'),
-});
+await client.agents.importFile({ file: await fetch('https://somesite/file') });
 
 // Finally, if none of the above are convenient, you can use our `toFile` helper:
-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'),
-});
+await client.agents.importFile({ file: await toFile(Buffer.from('my bytes'), 'file') });
+await client.agents.importFile({ file: await toFile(new Uint8Array([0, 1, 2]), 'file') });
 ```
 
 ## Handling errors
@@ -112,24 +88,15 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-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;
-    }
-  });
+const archive = await client.archives.create({ 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:
@@ -161,7 +128,7 @@ const client = new Letta({
 });
 
 // Or, configure per-request:
-await client.archives.create({ embedding_config: { embedding_dim: 0, embedding_endpoint_type: 'openai', embedding_model: 'embedding_model' }, name: 'name' }, {
+await client.archives.create({ name: 'name' }, {
   maxRetries: 5,
 });
 ```
@@ -178,7 +145,7 @@ const client = new Letta({
 });
 
 // Override per-request:
-await client.archives.create({ embedding_config: { embedding_dim: 0, embedding_endpoint_type: 'openai', embedding_model: 'embedding_model' }, name: 'name' }, {
+await client.archives.create({ name: 'name' }, {
   timeout: 5 * 1000,
 });
 ```
@@ -201,29 +168,11 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 ```ts
 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();
+const response = await client.archives.create({ 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
-  .create({
-    embedding_config: {
-      embedding_dim: 0,
-      embedding_endpoint_type: 'openai',
-      embedding_model: 'embedding_model',
-    },
-    name: 'name',
-  })
-  .withResponse();
+const { data: archive, response: raw } = await client.archives.create({ name: 'name' }).withResponse();
 console.log(raw.headers.get('X-My-Header'));
 console.log(archive.id);
 ```

package/client.d.mts

@@ -3,23 +3,27 @@ import type { PromiseOrValue, MergedRequestInit, FinalizedRequestInit } from "./
 export type { Logger, LogLevel } from "./internal/utils/log.mjs";
 import * as Opts from "./internal/request-options.mjs";
 import * as Errors from "./core/error.mjs";
+import * as Pagination from "./core/pagination.mjs";
+import { type ArrayPageParams, ArrayPageResponse, type NextFilesPageParams, NextFilesPageResponse, type ObjectPageParams, ObjectPageResponse } from "./core/pagination.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, ArchiveCreateParams, ArchiveListParams, ArchiveListResponse, ArchiveUpdateParams, Archives, VectorDBProvider } from "./resources/archives.mjs";
+import { AccessTokenCreateParams, AccessTokenCreateResponse, AccessTokenDeleteParams, AccessTokenDeleteResponse, AccessTokenListParams, AccessTokenListResponse, AccessTokens } from "./resources/access-tokens.mjs";
 import { TagListParams, TagListResponse, Tags } from "./resources/tags.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 { NpmRequirement, PipRequirement, Tool, ToolCreate, ToolCreateParams, ToolDeleteResponse, ToolListParams, ToolReturnMessage, ToolType, ToolUpdateParams, ToolUpsertBaseToolsResponse, ToolUpsertParams, Tools, ToolsArrayPage } from "./resources/tools.mjs";
+import { AgentCreateParams, AgentDeleteResponse, AgentEnvironmentVariable, AgentExportFileParams, AgentExportFileResponse, AgentImportFileParams, AgentImportFileResponse, AgentListParams, AgentRetrieveParams, AgentState, 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.mjs";
+import { Archive, ArchiveCreateParams, ArchiveListParams, ArchiveUpdateParams, Archives, ArchivesArrayPage, VectorDBProvider } from "./resources/archives/archives.mjs";
+import { BatchCancelResponse, BatchCreateParams, BatchJob, BatchJobsArrayPage, BatchListParams, Batches } from "./resources/batches/batches.mjs";
+import { BlockCreateParams, BlockDeleteResponse, BlockListParams, BlockResponse, BlockResponsesArrayPage, BlockUpdateParams, Blocks, CreateBlock } from "./resources/blocks/blocks.mjs";
+import { Folder, FolderCreateParams, FolderDeleteResponse, FolderListParams, FolderUpdateParams, Folders, FoldersArrayPage } from "./resources/folders/folders.mjs";
+import { DynamicManager, Group, GroupCreateParams, GroupDeleteResponse, GroupListParams, GroupUpdateParams, Groups, GroupsArrayPage, ManagerType, RoundRobinManager, SleeptimeManager, SupervisorManager, VoiceSleeptimeManager } from "./resources/groups/groups.mjs";
+import { Identities, IdentitiesArrayPage, Identity, IdentityCreateParams, IdentityDeleteResponse, IdentityListParams, IdentityProperty, IdentityType, IdentityUpdateParams, IdentityUpsertParams } from "./resources/identities/identities.mjs";
+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.mjs";
+import { EmbeddingConfig, EmbeddingModel, LlmConfig, Model, ModelListParams, ModelListResponse, Models, ProviderCategory, ProviderType } from "./resources/models/models.mjs";
+import { Job, RunListParams, Runs, StopReasonType } from "./resources/runs/runs.mjs";
+import { ProviderTrace, Step, StepListParams, Steps, StepsArrayPage } 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";
@@ -34,12 +38,17 @@ export interface ClientOptions {
     /**
      * Defaults to process.env['LETTA_API_KEY'].
      */
-    apiKey?: string | undefined;
+    apiKey?: string | null | undefined;
+    projectID?: string | null | undefined;
+    /**
+     * Deprecated, please use project_id instead.
+     */
+    project?: string | null | undefined;
     /**
      * Specifies the environment to use for the API.
      *
      * Each environment maps to a different base URL:
-     * - `cloud` corresponds to `https://app.letta.com`
+     * - `cloud` corresponds to `https://api.letta.com`
      * - `local` corresponds to `http://localhost:8283`
      */
     environment?: Environment | undefined;
@@ -109,7 +118,9 @@ export interface ClientOptions {
  */
 export declare class Letta {
     #private;
-    apiKey: string;
+    apiKey: string | null;
+    projectID: string | null;
+    project: string | null;
     baseURL: string;
     maxRetries: number;
     timeout: number;
@@ -122,9 +133,11 @@ export declare class Letta {
     /**
      * API Client for interfacing with the Letta API.
      *
-     * @param {string | undefined} [opts.apiKey=process.env['LETTA_API_KEY'] ?? undefined]
+     * @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://app.letta.com] - Override the default base URL 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.
@@ -132,13 +145,13 @@ export declare class Letta {
      * @param {HeadersLike} opts.defaultHeaders - Default headers to include with every request to the API.
      * @param {Record<string, string | undefined>} opts.defaultQuery - Default query parameters to include with every request to the API.
      */
-    constructor({ baseURL, apiKey, ...opts }?: ClientOptions);
+    constructor({ baseURL, apiKey, projectID, project, ...opts }?: ClientOptions);
     /**
      * 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
+     * Async health check endpoint.
      */
     health(options?: RequestOptions): APIPromise<TopLevelAPI.HealthResponse>;
     protected defaultQuery(): Record<string, string | undefined> | undefined;
@@ -171,6 +184,8 @@ export declare class Letta {
     private methodRequest;
     request<Rsp>(options: PromiseOrValue<FinalRequestOptions>, remainingRetries?: number | null): APIPromise<Rsp>;
     private makeRequest;
+    getAPIList<Item, PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>>(path: string, Page: new (...args: any[]) => PageClass, opts?: RequestOptions): Pagination.PagePromise<PageClass, Item>;
+    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>;
     fetchWithTimeout(url: RequestInfo, init: RequestInit | undefined, ms: number, controller: AbortController): Promise<Response>;
     private shouldRetry;
     private retryRequest;
@@ -200,35 +215,45 @@ export declare class Letta {
     static PermissionDeniedError: typeof Errors.PermissionDeniedError;
     static UnprocessableEntityError: typeof Errors.UnprocessableEntityError;
     static toFile: typeof Uploads.toFile;
-    archives: API.Archives;
+    agents: API.Agents;
     tools: API.Tools;
+    blocks: API.Blocks;
+    archives: API.Archives;
     folders: API.Folders;
-    agents: API.Agents;
-    groups: API.Groups;
-    identities: API.Identities;
     models: API.Models;
-    blocks: API.Blocks;
+    mcpServers: API.McpServers;
     runs: API.Runs;
     steps: API.Steps;
+    templates: API.Templates;
     tags: API.Tags;
+    identities: API.Identities;
+    groups: API.Groups;
     batches: API.Batches;
-    templates: API.Templates;
+    accessTokens: API.AccessTokens;
 }
 export declare namespace Letta {
     export type RequestOptions = Opts.RequestOptions;
+    export import ArrayPage = Pagination.ArrayPage;
+    export { type ArrayPageParams as ArrayPageParams, type ArrayPageResponse as ArrayPageResponse };
+    export import ObjectPage = Pagination.ObjectPage;
+    export { type ObjectPageParams as ObjectPageParams, type ObjectPageResponse as ObjectPageResponse };
+    export import NextFilesPage = Pagination.NextFilesPage;
+    export { type NextFilesPageParams as NextFilesPageParams, type NextFilesPageResponse as NextFilesPageResponse, };
     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 { Batches as Batches, type BatchJob as BatchJob, type BatchListResponse as BatchListResponse, type BatchCancelResponse as BatchCancelResponse, type BatchCreateParams as BatchCreateParams, type BatchListParams as BatchListParams, };
+    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 TogetherModelSettings as TogetherModelSettings, type XaiModelSettings as XaiModelSettings, type AgentDeleteResponse as AgentDeleteResponse, 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 AgentExportFileParams as AgentExportFileParams, type AgentImportFileParams as AgentImportFileParams, };
+    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 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 { 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 { 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 ModelListParams as ModelListParams, };
+    export { 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 RunListParams as RunListParams, };
+    export { Steps as Steps, type ProviderTrace as ProviderTrace, type Step as Step, type StepsArrayPage as StepsArrayPage, type StepListParams as StepListParams, };
     export { Templates as Templates };
+    export { Tags as Tags, type TagListResponse as TagListResponse, type TagListParams as TagListParams };
+    export { 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 { 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 { Batches as Batches, type BatchJob as BatchJob, type BatchCancelResponse as BatchCancelResponse, type BatchJobsArrayPage as BatchJobsArrayPage, type BatchCreateParams as BatchCreateParams, type BatchListParams as BatchListParams, };
+    export { 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, };
 }
 //# sourceMappingURL=client.d.mts.map