Merge pull request #90 from letta-ai/release-please--branches--main--changes--next--components--letta-client

release: 1.7.12

Author: sarahwooders

.github/workflows/ci.yml

@@ -55,14 +55,18 @@ jobs:
         run: ./scripts/build
 
       - name: Get GitHub OIDC Token
-        if: github.repository == 'stainless-sdks/letta-sdk-typescript'
+        if: |-
+          github.repository == 'stainless-sdks/letta-sdk-typescript' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
         uses: actions/github-script@v8
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
       - name: Upload tarball
-        if: github.repository == 'stainless-sdks/letta-sdk-typescript'
+        if: |-
+          github.repository == 'stainless-sdks/letta-sdk-typescript' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         env:
           URL: https://pkg.stainless.com/s
           AUTH: ${{ steps.github-oidc.outputs.github_token }}

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.7.11"
+  ".": "1.7.12"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 123
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-641193c8d6dd0ca97bc8f6ffc12534764d4cd9dda8fc5ace158397cb74b7787b.yml
-openapi_spec_hash: e0eef8afab116c4dba3540ab6fd26a8f
-config_hash: 98feceec44cc57270fce259ddbbec999
+configured_endpoints: 125
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-1c44d73b9152645e7b44512a238467b88c993a2c0151d5911b7f98d05583790e.yml
+openapi_spec_hash: e0633c52cd8d694e72211de731d1354a
+config_hash: 2dd2cc848568d7bec38b1cc774a5900c

CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 1.7.12 (2026-03-09)
+
+Full Changelog: [v1.7.11...v1.7.12](https://github.com/letta-ai/letta-node/compare/v1.7.11...v1.7.12)
+
+### Features
+
+* add conversation recompile endpoint ([d5ca4a2](https://github.com/letta-ai/letta-node/commit/d5ca4a29535ba4a198a2f3b0188b7b28f273a03e))
+* add fireworks provider ([076a128](https://github.com/letta-ai/letta-node/commit/076a128e1a26e799c06fea88e9c59754fbe28486))
+* add recompile system endpoint to Stainless SDK ([4b2656b](https://github.com/letta-ai/letta-node/commit/4b2656bf99731ab6fd2404b178a7be64b697e1e8))
+* **core:** restructure memFS system prompt rendering + add client_skills [LET-7760] ([fe053dd](https://github.com/letta-ai/letta-node/commit/fe053dd11ef23220ccfc2a83c8185883ed7fe515))
+* **helm:** M3 multi-signal HPA external metrics + behavior (dev shadow, prod disabled) ([7c10557](https://github.com/letta-ai/letta-node/commit/7c10557cecf1329f0757b6b07a45f34b8d906599))
+* **readiness:** M2 readiness enforcement scaffold (default OFF) ([df8edac](https://github.com/letta-ai/letta-node/commit/df8edac31e86447d2dd7b359b2ec8e1e2b580643))
+
+
+### Bug Fixes
+
+* **client:** preserve URL params already embedded in path ([defbd26](https://github.com/letta-ai/letta-node/commit/defbd267eb46d5076b563a09560819f579b1e43a))
+* fix request delays for retrying to be more respectful of high requested delays ([6b99724](https://github.com/letta-ai/letta-node/commit/6b997247f8efee77c59fca2189e0910fa58cafaf))
+
+
+### Chores
+
+* **ci:** skip uploading artifacts on stainless-internal branches ([839806e](https://github.com/letta-ai/letta-node/commit/839806ebe1f39d9946f1380ac8b6f0b282bd65ea))
+* **internal:** improve import alias names ([4aceca2](https://github.com/letta-ai/letta-node/commit/4aceca2901af2a76f952bcf3a3759aebff28e031))
+* update placeholder string ([b50ef46](https://github.com/letta-ai/letta-node/commit/b50ef46319b07da43d8b57db8cae3fd0e9beb99e))
+
 ## 1.7.11 (2026-03-04)
 
 Full Changelog: [v1.7.10...v1.7.11](https://github.com/letta-ai/letta-node/compare/v1.7.10...v1.7.11)

api.md

@@ -42,6 +42,7 @@ Types:
 - <code><a href="./src/resources/agents/agents.ts">AgentDeleteResponse</a></code>
 - <code><a href="./src/resources/agents/agents.ts">AgentExportFileResponse</a></code>
 - <code><a href="./src/resources/agents/agents.ts">AgentImportFileResponse</a></code>
+- <code><a href="./src/resources/agents/agents.ts">AgentRecompileResponse</a></code>
 
 Methods:
 
@@ -52,6 +53,7 @@ Methods:
 - <code title="delete /v1/agents/{agent_id}">client.agents.<a href="./src/resources/agents/agents.ts">delete</a>(agentID) -> unknown</code>
 - <code title="get /v1/agents/{agent_id}/export">client.agents.<a href="./src/resources/agents/agents.ts">exportFile</a>(agentID, { ...params }) -> string</code>
 - <code title="post /v1/agents/import">client.agents.<a href="./src/resources/agents/agents.ts">importFile</a>({ ...params }) -> AgentImportFileResponse</code>
+- <code title="post /v1/agents/{agent_id}/recompile">client.agents.<a href="./src/resources/agents/agents.ts">recompile</a>(agentID, { ...params }) -> string</code>
 
 ## Messages
 
@@ -570,6 +572,7 @@ Types:
 - <code><a href="./src/resources/conversations/conversations.ts">ConversationListResponse</a></code>
 - <code><a href="./src/resources/conversations/conversations.ts">ConversationDeleteResponse</a></code>
 - <code><a href="./src/resources/conversations/conversations.ts">ConversationCancelResponse</a></code>
+- <code><a href="./src/resources/conversations/conversations.ts">ConversationRecompileResponse</a></code>
 
 Methods:
 
@@ -579,6 +582,7 @@ Methods:
 - <code title="get /v1/conversations/">client.conversations.<a href="./src/resources/conversations/conversations.ts">list</a>({ ...params }) -> ConversationListResponse</code>
 - <code title="delete /v1/conversations/{conversation_id}">client.conversations.<a href="./src/resources/conversations/conversations.ts">delete</a>(conversationID) -> unknown</code>
 - <code title="post /v1/conversations/{conversation_id}/cancel">client.conversations.<a href="./src/resources/conversations/conversations.ts">cancel</a>(conversationID, { ...params }) -> ConversationCancelResponse</code>
+- <code title="post /v1/conversations/{conversation_id}/recompile">client.conversations.<a href="./src/resources/conversations/conversations.ts">recompile</a>(conversationID, { ...params }) -> string</code>
 
 ## Messages
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-client",
-  "version": "1.7.11",
+  "version": "1.7.12",
   "description": "The official TypeScript library for the Letta API",
   "author": "Letta <>",
   "types": "dist/index.d.ts",

src/client.ts

@@ -78,6 +78,8 @@ import {
   AgentImportFileParams,
   AgentImportFileResponse,
   AgentListParams,
+  AgentRecompileParams,
+  AgentRecompileResponse,
   AgentRetrieveParams,
   AgentState,
   AgentStatesArrayPage,
@@ -136,6 +138,8 @@ import {
   ConversationDeleteResponse,
   ConversationListParams,
   ConversationListResponse,
+  ConversationRecompileParams,
+  ConversationRecompileResponse,
   ConversationUpdateParams,
   Conversations,
   CreateConversation,
@@ -415,7 +419,7 @@ export class Letta {
   }
 
   /**
-   * Async health check endpoint.
+   * Liveness endpoint; returns 200 when process is responsive.
    */
   health(options?: RequestOptions): APIPromise<TopLevelAPI.HealthResponse> {
     return this.get('/v1/health/', options);
@@ -469,8 +473,9 @@ export class Letta {
       : new URL(baseURL + (baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
 
     const defaultQuery = this.defaultQuery();
-    if (!isEmptyObj(defaultQuery)) {
-      query = { ...defaultQuery, ...query };
+    const pathQuery = Object.fromEntries(url.searchParams);
+    if (!isEmptyObj(defaultQuery) || !isEmptyObj(pathQuery)) {
+      query = { ...pathQuery, ...defaultQuery, ...query };
     }
 
     if (typeof query === 'object' && query && !Array.isArray(query)) {
@@ -803,9 +808,9 @@ export class Letta {
       }
     }
 
-    // If the API asks us to wait a certain amount of time (and it's a reasonable amount),
-    // just do what it says, but otherwise calculate a default
-    if (!(timeoutMillis && 0 <= timeoutMillis && timeoutMillis < 60 * 1000)) {
+    // If the API asks us to wait a certain amount of time, just do what it
+    // says, but otherwise calculate a default
+    if (timeoutMillis === undefined) {
       const maxRetries = options.maxRetries ?? this.maxRetries;
       timeoutMillis = this.calculateDefaultRetryTimeoutMillis(retriesRemaining, maxRetries);
     }
@@ -1047,13 +1052,15 @@ export declare namespace Letta {
     type AgentDeleteResponse as AgentDeleteResponse,
     type AgentExportFileResponse as AgentExportFileResponse,
     type AgentImportFileResponse as AgentImportFileResponse,
+    type AgentRecompileResponse as AgentRecompileResponse,
     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,
+    type AgentRecompileParams as AgentRecompileParams,
   };
 
   export {
@@ -1197,10 +1204,12 @@ export declare namespace Letta {
     type ConversationListResponse as ConversationListResponse,
     type ConversationDeleteResponse as ConversationDeleteResponse,
     type ConversationCancelResponse as ConversationCancelResponse,
+    type ConversationRecompileResponse as ConversationRecompileResponse,
     type ConversationCreateParams as ConversationCreateParams,
     type ConversationUpdateParams as ConversationUpdateParams,
     type ConversationListParams as ConversationListParams,
     type ConversationCancelParams as ConversationCancelParams,
+    type ConversationRecompileParams as ConversationRecompileParams,
   };
 
   export {

src/resources/agents/agents.ts

@@ -140,8 +140,8 @@ import {
   ToolUpdateApprovalParams,
   Tools,
 } from './tools';
-import * as ArchivesArchivesAPI from '../archives/archives';
-import * as BlocksBlocksAPI from '../blocks/blocks';
+import * as ResourcesArchivesAPI from '../archives/archives';
+import * as ResourcesBlocksAPI from '../blocks/blocks';
 import * as ModelsAPI from '../models/models';
 import * as RunsAPI from '../runs/runs';
 import { APIPromise } from '../../core/api-promise';
@@ -242,6 +242,21 @@ export class Agents extends APIResource {
       ),
     );
   }
+
+  /**
+   * Manually trigger system prompt recompilation for an agent.
+   */
+  recompile(
+    agentID: string,
+    params: AgentRecompileParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<string> {
+    const { dry_run, update_timestamp } = params ?? {};
+    return this._client.post(path`/v1/agents/${agentID}/recompile`, {
+      query: { dry_run, update_timestamp },
+      ...options,
+    });
+  }
 }
 
 export type AgentStatesArrayPage = ArrayPage<AgentState>;
@@ -783,7 +798,7 @@ export namespace AgentState {
     /**
      * The vector database provider used for this source's passages
      */
-    vector_db_provider?: ArchivesArchivesAPI.VectorDBProvider;
+    vector_db_provider?: ResourcesArchivesAPI.VectorDBProvider;
   }
 
   /**
@@ -2065,6 +2080,8 @@ export interface AgentImportFileResponse {
   agent_ids: Array<string>;
 }
 
+export type AgentRecompileResponse = string;
+
 export interface AgentCreateParams {
   /**
    * The type of agent.
@@ -2207,7 +2224,7 @@ export interface AgentCreateParams {
   /**
    * The blocks to create in the agent's in-context memory.
    */
-  memory_blocks?: Array<BlocksBlocksAPI.CreateBlock> | null;
+  memory_blocks?: Array<ResourcesBlocksAPI.CreateBlock> | null;
 
   /**
    * @deprecated Deprecated: Only relevant for creating agents from a template. Use
@@ -3469,6 +3486,19 @@ export interface AgentImportFileParams {
   'x-override-embedding-model'?: string;
 }
 
+export interface AgentRecompileParams {
+  /**
+   * If True, do not persist changes; still returns the compiled system prompt.
+   */
+  dry_run?: boolean;
+
+  /**
+   * If True, update the in-context memory last edit timestamp embedded in the system
+   * prompt.
+   */
+  update_timestamp?: boolean;
+}
+
 Agents.Messages = Messages;
 Agents.Schedule = Schedule;
 Agents.Blocks = Blocks;
@@ -3511,13 +3541,15 @@ export declare namespace Agents {
     type AgentDeleteResponse as AgentDeleteResponse,
     type AgentExportFileResponse as AgentExportFileResponse,
     type AgentImportFileResponse as AgentImportFileResponse,
+    type AgentRecompileResponse as AgentRecompileResponse,
     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,
+    type AgentRecompileParams as AgentRecompileParams,
   };
 
   export {

src/resources/agents/blocks.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as AgentsAPI from './agents';
-import * as BlocksBlocksAPI from '../blocks/blocks';
+import * as ResourcesBlocksAPI from '../blocks/blocks';
 import { BlockResponsesArrayPage } from '../blocks/blocks';
 import { APIPromise } from '../../core/api-promise';
 import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
@@ -17,7 +17,7 @@ export class Blocks extends APIResource {
     blockLabel: string,
     params: BlockRetrieveParams,
     options?: RequestOptions,
-  ): APIPromise<BlocksBlocksAPI.BlockResponse> {
+  ): APIPromise<ResourcesBlocksAPI.BlockResponse> {
     const { agent_id } = params;
     return this._client.get(path`/v1/agents/${agent_id}/core-memory/blocks/${blockLabel}`, options);
   }
@@ -29,7 +29,7 @@ export class Blocks extends APIResource {
     blockLabel: string,
     params: BlockUpdateParams,
     options?: RequestOptions,
-  ): APIPromise<BlocksBlocksAPI.BlockResponse> {
+  ): APIPromise<ResourcesBlocksAPI.BlockResponse> {
     const { agent_id, ...body } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/core-memory/blocks/${blockLabel}`, {
       body,
@@ -44,10 +44,10 @@ export class Blocks extends APIResource {
     agentID: string,
     query: BlockListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<BlockResponsesArrayPage, BlocksBlocksAPI.BlockResponse> {
+  ): PagePromise<BlockResponsesArrayPage, ResourcesBlocksAPI.BlockResponse> {
     return this._client.getAPIList(
       path`/v1/agents/${agentID}/core-memory/blocks`,
-      ArrayPage<BlocksBlocksAPI.BlockResponse>,
+      ArrayPage<ResourcesBlocksAPI.BlockResponse>,
       { query, ...options },
     );
   }

src/resources/agents/index.ts

@@ -32,12 +32,14 @@ export {
   type AgentDeleteResponse,
   type AgentExportFileResponse,
   type AgentImportFileResponse,
+  type AgentRecompileResponse,
   type AgentCreateParams,
   type AgentRetrieveParams,
   type AgentUpdateParams,
   type AgentListParams,
   type AgentExportFileParams,
   type AgentImportFileParams,
+  type AgentRecompileParams,
   type AgentStatesArrayPage,
 } from './agents';
 export {