@letta-ai/letta-agent-sdk 0.7.4 → 0.7.6

package/README.md

@@ -32,6 +32,19 @@ for await (const message of session.stream()) {
 }
 ```
 
+Latency-sensitive applications can initialize the runtime and transport before
+the first user action without fetching transcript history or invoking the model:
+
+```typescript
+const session = client.resumeSession(conversationId);
+await session.ready();
+await session.send(message);
+```
+
+`ready()` is idempotent and safe to call concurrently. `SDKResultMessage.durationMs`
+measures the tracked turn and excludes session initialization; measure `ready()`
+separately when startup latency matters.
+
 Set `LETTA_API_KEY` for the cloud backend. See the [quickstart](https://docs.letta.com/agent-sdk/quickstart) for the local and self-hosted paths.
 
 ## Where your agents run

package/dist/client-entry.js

@@ -9337,6 +9337,22 @@ class RemoteClientSessionCore {
     this.initializePromise = memo;
     return memo;
   }
+  async ready() {
+    if (this.closed)
+      throw new Error("Session is closed");
+    if (!this.initialized)
+      await this.initialize();
+    await this.recoverIdleTransportIfNeeded();
+    if (!this._agentId || !this._conversationId) {
+      throw new Error("Session is not initialized");
+    }
+    return {
+      agentId: this._agentId,
+      conversationId: this._conversationId,
+      model: this._model || undefined,
+      ...this.toolNames !== undefined ? { tools: [...this.toolNames] } : {}
+    };
+  }
   async performInitialize() {
     const init = await this.initializeRuntimeController();
     this.controller = init.controller;
@@ -9486,7 +9502,7 @@ class RemoteClientSessionCore {
   }
   async updateModel(update) {
     if (this.mode.kind === "session" && this.mode.options.stateless === true) {
-      throw new Error("updateModel() is unavailable in a stateless session because it changes persisted agent configuration.");
+      throw new Error("updateModel() is unavailable in a stateless session because it changes persistent model configuration.");
     }
     if (!this.initialized) {
       await this.initialize();
@@ -11114,6 +11130,8 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
   }
   async initializeRuntimeController() {
     await this.mcpCleanup;
+    if (!this.closed)
+      this.sandboxLifecycleClosing = false;
     const resolved = await this.resolveRuntime();
     const connection = await this.resolveConnectionForRuntime(resolved.runtime).catch(async (error) => {
       await this.cleanupSessionRepositories(resolved.runtime.agent_id, resolved.runtime.conversation_id);
@@ -11876,7 +11894,7 @@ function validateCreateSessionOptions(options) {
       ["resources", options.resources]
     ].find(([, value]) => value !== undefined);
     if (persistedOption) {
-      throw new Error(`stateless sessions cannot set ${persistedOption[0]} because it changes persisted agent configuration.`);
+      throw new Error(`stateless sessions cannot set ${persistedOption[0]} because it changes persistent configuration.`);
     }
   }
   validateClientToolset(options.toolset);
@@ -12770,4 +12788,4 @@ export {
   CloudManagedSandboxExpiredError
 };
 
-//# debugId=D64E5E8DF2F0895364756E2164756E21
+//# debugId=7375838F6D261D8064756E2164756E21