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

package/CHANGELOG.md

@@ -1,5 +1,276 @@
 # 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)
+
+### 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,14 @@ 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({ name: 'name' });
 
 console.log(archive.id);
 ```
@@ -38,15 +38,15 @@ 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 = { 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 +62,22 @@ 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.agents.importFile({ 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.agents.importFile({ 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.agents.importFile({ 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.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
@@ -88,8 +88,8 @@ 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) {
+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', ...}
@@ -123,12 +123,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({ name: 'name' }, {
   maxRetries: 5,
 });
 ```
@@ -140,12 +140,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({ name: 'name' }, {
   timeout: 5 * 1000,
 });
 ```
@@ -166,13 +166,13 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 
 <!-- prettier-ignore -->
 ```ts
-const client = new LettaSDK();
+const client = new Letta();
 
-const response = await client.archives.update({ 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.update({ 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);
 ```
@@ -187,13 +187,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 +219,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 +254,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 +288,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 +299,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 +316,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 +330,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 +342,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,
   },