@letta-ai/letta-agent-sdk 0.5.0 → 0.5.1

package/README.md

@@ -44,12 +44,6 @@ for await (const message of session.stream()) {
 }
 ```
 
-Assistant and reasoning messages are incremental text fragments. Reconcile
-fragments by `type` and `otid` when `otid` is available; `uuid` is a legacy
-transport identifier and is not a portable lineage key. After reconnecting,
-use `(runId, seqId)` to suppress replayed fragments. Sequence IDs are scoped to
-their run and must not be compared across runs.
-
 An agent is the persistent entity with memory. A conversation is a thread on that agent. A session is the active connection used to send messages, stream events, execute tools, and handle approvals.
 
 - `createSession(agentId)` starts a new conversation.
@@ -86,7 +80,8 @@ approvals when a mobile or web client returns to the foreground:
 ```ts
 const status = await session.getDeviceStatus();
 // status.permissionMode, status.workingDirectory, status.isOnline,
-// status.isProcessing, status.pendingControlRequests, status.raw
+// status.isProcessing, status.memoryDirectory,
+// status.pendingControlRequests, status.raw
 
 const unsubscribe = session.onDeviceStatus((status) => {
   // Called for every device-status update pushed by the runtime.

package/dist/client-entry.js

@@ -5987,6 +5987,7 @@ function toSessionDeviceStatus(status) {
     isProcessing: status.is_processing,
     permissionMode,
     workingDirectory: status.current_working_directory,
+    memoryDirectory: typeof status.memory_directory === "string" ? status.memory_directory : null,
     pendingControlRequests: pendingControlRequests(status),
     raw: { ...status }
   };
@@ -8298,6 +8299,7 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
   sandboxRefreshInFlight = null;
   sandboxLifecycleClosing = false;
   attachedRepositoryIds = new Set;
+  repositoryIdsRequiringCleanupRecompile = new Set;
   cloudMode;
   constructor(cloudOptions, mode) {
     super(mode, {
@@ -8311,7 +8313,10 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
   }
   async initializeRuntimeController() {
     const resolved = await this.resolveRuntime();
-    const connection = await this.resolveConnectionForRuntime(resolved.runtime);
+    const connection = await this.resolveConnectionForRuntime(resolved.runtime).catch(async (error) => {
+      await this.cleanupSessionRepositories(resolved.runtime.agent_id, resolved.runtime.conversation_id);
+      throw error;
+    });
     this.connectionId = connection.connectionId;
     const apiKey = getCloudApiKey2(this.cloudOptions);
     const url = buildCloudStatusWebSocketUrl({
@@ -8366,7 +8371,7 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
       this.removeControlRequestHandler = null;
       client.close();
       await this.cleanupManagedSandbox();
-      await this.cleanupSessionRepositories(resolved.runtime.agent_id);
+      await this.cleanupSessionRepositories(resolved.runtime.agent_id, resolved.runtime.conversation_id);
       throw error;
     }
   }
@@ -8417,8 +8422,9 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
     this.removeControlRequestHandler?.();
     this.removeControlRequestHandler = null;
     this.cleanupManagedSandbox();
-    if (this.runtime?.agent_id)
-      this.cleanupSessionRepositories(this.runtime.agent_id);
+    if (this.runtime?.agent_id) {
+      this.cleanupSessionRepositories(this.runtime.agent_id, this.runtime.conversation_id);
+    }
   }
   async resolveRuntime() {
     let agentId = this.cloudMode.agentId;
@@ -8433,22 +8439,30 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
     if (!agentId) {
       throw new Error("Letta Cloud createSession()/resumeSession() requires an agent id or conversation id.");
     }
-    await this.attachSessionRepositories(agentId);
-    if (this.cloudMode.newConversation) {
-      const conversation = await this.createConversation(agentId);
-      conversationId = conversation.id;
-    } else if (this.cloudMode.defaultConversation) {
-      conversationId = "default";
-    }
-    if (!conversationId) {
-      throw new Error("Letta Cloud createSession()/resumeSession() requires an agent id or conversation id.");
+    const shouldRecompileRepositories = await this.attachSessionRepositories(agentId);
+    try {
+      if (this.cloudMode.newConversation) {
+        const conversation = await this.createConversation(agentId);
+        conversationId = conversation.id;
+      } else if (this.cloudMode.defaultConversation) {
+        conversationId = "default";
+      }
+      if (!conversationId) {
+        throw new Error("Letta Cloud createSession()/resumeSession() requires an agent id or conversation id.");
+      }
+      if (shouldRecompileRepositories) {
+        await this.recompileSystemPrompt(agentId, conversationId);
+      }
+      return { runtime: { agent_id: agentId, conversation_id: conversationId } };
+    } catch (error) {
+      await this.cleanupSessionRepositories(agentId, conversationId);
+      throw error;
     }
-    return { runtime: { agent_id: agentId, conversation_id: conversationId } };
   }
   async attachSessionRepositories(agentId) {
     const resources = this.repositoryResources();
     if (resources.length === 0)
-      return;
+      return false;
     const existing = await this.listAgentRepositories(agentId);
     const existingIds = new Set(existing.map((repository) => repository.id));
     try {
@@ -8464,15 +8478,42 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
       await this.cleanupSessionRepositories(agentId);
       throw error;
     }
+    const shouldRecompile = resources.some((resource) => resource.recompile !== false);
+    this.repositoryIdsRequiringCleanupRecompile = new Set(resources.filter((resource) => resource.recompile !== false && this.attachedRepositoryIds.has(resource.repositoryId)).map((resource) => resource.repositoryId));
+    return shouldRecompile;
   }
-  async cleanupSessionRepositories(agentId) {
+  async cleanupSessionRepositories(agentId, conversationId) {
     const repositoryIds = [...this.attachedRepositoryIds];
+    const repositoryIdsRequiringRecompile = this.repositoryIdsRequiringCleanupRecompile;
     this.attachedRepositoryIds.clear();
-    await Promise.all(repositoryIds.map(async (repositoryId) => {
+    this.repositoryIdsRequiringCleanupRecompile = new Set;
+    const recompileAfterDetach = await Promise.all(repositoryIds.map(async (repositoryId) => {
       try {
         await this.unlinkAgentRepository(agentId, repositoryId);
-      } catch {}
+        return repositoryIdsRequiringRecompile.has(repositoryId);
+      } catch {
+        return false;
+      }
     }));
+    if (recompileAfterDetach.some(Boolean)) {
+      try {
+        await this.recompileSystemPrompt(agentId, conversationId);
+      } catch {}
+    }
+  }
+  async recompileSystemPrompt(agentId, conversationId) {
+    const fetchImpl = getFetch3(this.cloudOptions.fetch);
+    const baseUrl = normalizeCloudApiBaseUrl2(this.cloudOptions.apiBaseUrl);
+    const usesAgentPrompt = !conversationId || conversationId === "default";
+    const path = usesAgentPrompt ? `/v1/agents/${encodeURIComponent(agentId)}/recompile` : `/v1/conversations/${encodeURIComponent(conversationId)}/recompile`;
+    const url = `${baseUrl}${path}`;
+    const response = await fetchImpl(url, {
+      method: "POST",
+      headers: cloudHeaders2(this.cloudOptions),
+      body: JSON.stringify(usesAgentPrompt ? {} : { agent_id: agentId })
+    });
+    const body = await parseJsonResponse3(response);
+    assertOkResponse2(response, body, "Cloud recompile system prompt", url);
   }
   repositoryResources() {
     const resources = this.cloudMode.options.resources ?? [];
@@ -9388,4 +9429,4 @@ export {
   CloudManagedSandboxExpiredError
 };
 
-//# debugId=AAFE1DD6848E90C364756E2164756E21
+//# debugId=C4A49597208F4A6464756E2164756E21