release: 1.0.0-alpha.7 (#36)

* feat: Revert "feat: revise mcp tool routes [LET-4321]"

* codegen metadata

* codegen metadata

* codegen metadata

* fix: sdk config code gen

* feat: remove run tool for external sdk

* feat: add agent template route to config

* feat: deprecate use_assistant_message in list endpoints

* codegen metadata

* feat: replace agent.identity_ids with agent.identities

* feat: rename multi agent group to managed group

* feat: remove unused max length parameter

* codegen metadata

* feat: fix patch approvals endpoint incorrectly using queyr params

* codegen metadata

* feat: reset message incorrectly using query param

* feat: remove relationship fields on identities

* feat: deprecate append copy suffix, add override name [LET-5779]

* feat: add openai-style include param for agents relationship loading

* codegen metadata

* codegen metadata

* feat: add new archive routes to sdk

* chore: add context_window_limit and max_tokens to UpdateAgent [LET-3743] [LET-3741]

* codegen metadata

* feat: attach/detach identities route on blocks and agents, move archives attach/detach routes to agents

* codegen metadata

* feat: Support embedding config on the archive [LET-5832]

* release: 1.0.0-alpha.7

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/publish-npm.yml

@@ -29,4 +29,4 @@ jobs:
         run: |
           bash ./bin/publish-npm
         env:
-          NPM_TOKEN: ${{ secrets.LETTA_SDK_NPM_TOKEN || secrets.NPM_TOKEN }}
+          NPM_TOKEN: ${{ secrets.LETTA_NPM_TOKEN || secrets.NPM_TOKEN }}

.github/workflows/release-doctor.yml

@@ -18,5 +18,5 @@ jobs:
         run: |
           bash ./bin/check-release-environment
         env:
-          NPM_TOKEN: ${{ secrets.LETTA_SDK_NPM_TOKEN || secrets.NPM_TOKEN }}
+          NPM_TOKEN: ${{ secrets.LETTA_NPM_TOKEN || secrets.NPM_TOKEN }}
 

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.0.0-alpha.6"
+  ".": "1.0.0-alpha.7"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 184
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-283b44f5ec292919111e3328874d393d847d7340482adfa86cfee3dacb0d1331.yml
-openapi_spec_hash: 6ff17b6f249c5f4e88e6e833b47f39eb
-config_hash: 1310be2f6c53e5fa8d0513cf1774bafe
+configured_endpoints: 106
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-d67ca762c9a9ebc74be3a4d373dc15fae68b375a580d5b126e86b55ac72a36a2.yml
+openapi_spec_hash: d4d7cbecb83adc92ccd66fe9a96130af
+config_hash: 6566625fdf1964224f4472bd3c9e6c9f

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)

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.

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,20 +339,20 @@ 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
 
 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,
   },

SECURITY.md

@@ -16,7 +16,7 @@ before making any information public.
 ## Reporting Non-SDK Related Security Issues
 
 If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by Letta SDK, please follow the respective company's security reporting guidelines.
+or products provided by Letta, please follow the respective company's security reporting guidelines.
 
 ---