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

package/dist/cloud-session.d.ts

@@ -29,6 +29,7 @@ export declare class CloudEnvironmentSession extends RemoteClientSessionCore {
     private sandboxRefreshInFlight;
     private sandboxLifecycleClosing;
     private attachedRepositoryIds;
+    private repositoryIdsRequiringCleanupRecompile;
     private readonly cloudMode;
     constructor(cloudOptions: LettaCodeCloudClientOptions, mode: CloudSessionMode);
     protected initializeRuntimeController(): Promise<RuntimeSessionInit>;
@@ -39,6 +40,7 @@ export declare class CloudEnvironmentSession extends RemoteClientSessionCore {
     private resolveRuntime;
     private attachSessionRepositories;
     private cleanupSessionRepositories;
+    private recompileSystemPrompt;
     private repositoryResources;
     private listAgentRepositories;
     private waitForAgentRepository;

package/dist/cloud-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-session.d.ts","sourceRoot":"","sources":["../src/cloud-session.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,uBAAuB,EAIvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAEV,kBAAkB,EAClB,6BAA6B,EAC7B,2BAA2B,EAI5B,MAAM,YAAY,CAAC;AAwEpB;;;;;GAKG;AACH,qBAAa,+BAAgC,SAAQ,KAAK;IAItD,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM;IAJjC,QAAQ,CAAC,IAAI,EAAG,yBAAyB,CAAU;gBAGxC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM;CAOlC;AAED,KAAK,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAyHzE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAarF;AAkGD,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,2BAA2B,EAC1C,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,6BAA6B,GACrC,IAAI,CAKN;AAED,qBAAa,uBAAwB,SAAQ,uBAAuB;IAahE,OAAO,CAAC,QAAQ,CAAC,YAAY;IAZ/B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,yBAAyB,CAA6B;IAC9D,OAAO,CAAC,2BAA2B,CAA6B;IAChE,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,mBAAmB,CAA+C;IAC1E,OAAO,CAAC,sBAAsB,CAA8B;IAC5D,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,qBAAqB,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;gBAG1B,YAAY,EAAE,2BAA2B,EAC1D,IAAI,EAAE,gBAAgB;cAWC,2BAA2B,IAAI,OAAO,CAAC,kBAAkB,CAAC;YA0ErE,iBAAiB;cA8BN,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;cAUxC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;cAMjC,WAAW,IAAI,IAAI;YASxB,cAAc;YAoCd,yBAAyB;YAsBzB,0BAA0B;IAYxC,OAAO,CAAC,mBAAmB;YAkBb,qBAAqB;YAoBrB,sBAAsB;YAYtB,mBAAmB;YAenB,qBAAqB;YAYrB,kBAAkB;YAkBlB,oBAAoB;YAepB,2BAA2B;YAc3B,yBAAyB;YAQzB,8BAA8B;YAiC9B,oBAAoB;YAiEpB,qBAAqB;YAcrB,yBAAyB;YAuDzB,uBAAuB;YAqCvB,+BAA+B;IA4B7C,OAAO,CAAC,0BAA0B;IAelC,OAAO,CAAC,yBAAyB;YAMnB,qBAAqB;IAuBnC,OAAO,CAAC,uBAAuB;IAS/B,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,sBAAsB;CAG/B"}
+{"version":3,"file":"cloud-session.d.ts","sourceRoot":"","sources":["../src/cloud-session.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,uBAAuB,EAIvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAEV,kBAAkB,EAClB,6BAA6B,EAC7B,2BAA2B,EAI5B,MAAM,YAAY,CAAC;AAwEpB;;;;;GAKG;AACH,qBAAa,+BAAgC,SAAQ,KAAK;IAItD,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM;IAJjC,QAAQ,CAAC,IAAI,EAAG,yBAAyB,CAAU;gBAGxC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM;CAOlC;AAED,KAAK,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAyHzE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAarF;AAkGD,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,2BAA2B,EAC1C,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,6BAA6B,GACrC,IAAI,CAKN;AAED,qBAAa,uBAAwB,SAAQ,uBAAuB;IAchE,OAAO,CAAC,QAAQ,CAAC,YAAY;IAb/B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,yBAAyB,CAA6B;IAC9D,OAAO,CAAC,2BAA2B,CAA6B;IAChE,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,mBAAmB,CAA+C;IAC1E,OAAO,CAAC,sBAAsB,CAA8B;IAC5D,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,qBAAqB,CAAqB;IAClD,OAAO,CAAC,sCAAsC,CAAqB;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;gBAG1B,YAAY,EAAE,2BAA2B,EAC1D,IAAI,EAAE,gBAAgB;cAWC,2BAA2B,IAAI,OAAO,CAAC,kBAAkB,CAAC;YAqFrE,iBAAiB;cA8BN,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;cAUxC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;cAMjC,WAAW,IAAI,IAAI;YAcxB,cAAc;YA8Cd,yBAAyB;YAuCzB,0BAA0B;YA6B1B,qBAAqB;IAuBnC,OAAO,CAAC,mBAAmB;YAkBb,qBAAqB;YAoBrB,sBAAsB;YAYtB,mBAAmB;YAenB,qBAAqB;YAYrB,kBAAkB;YAkBlB,oBAAoB;YAepB,2BAA2B;YAc3B,yBAAyB;YAQzB,8BAA8B;YAiC9B,oBAAoB;YAiEpB,qBAAqB;YAcrB,yBAAyB;YAuDzB,uBAAuB;YAqCvB,+BAA+B;IA4B7C,OAAO,CAAC,0BAA0B;IAelC,OAAO,CAAC,yBAAyB;YAMnB,qBAAqB;IAuBnC,OAAO,CAAC,uBAAuB;IAS/B,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,sBAAsB;CAG/B"}

package/dist/index.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 ?? [];
@@ -10150,4 +10191,4 @@ export {
   CloudManagedSandboxExpiredError
 };
 
-//# debugId=3A7EA512AEF37C3B64756E2164756E21
+//# debugId=31B7FC9589C9EB7964756E2164756E21