@letta-ai/letta-agent-sdk 0.7.5 → 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;
@@ -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);
@@ -12770,4 +12788,4 @@ export {
   CloudManagedSandboxExpiredError
 };
 
-//# debugId=4189F3F92EE00D0D64756E2164756E21
+//# debugId=7375838F6D261D8064756E2164756E21