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

package/dist/app-server-management.d.ts

@@ -1,5 +1,5 @@
 import type { AgentListParams, AgentUpdateParams } from "@letta-ai/letta-client/resources/agents/agents";
-import type { ConversationCreateParams, ConversationListParams, ConversationUpdateParams } from "@letta-ai/letta-client/resources/conversations/conversations";
+import type { ConversationCreateParams, ConversationForkParams, ConversationListParams, ConversationUpdateParams } from "@letta-ai/letta-client/resources/conversations/conversations";
 import type { MessageListParams } from "@letta-ai/letta-client/resources/conversations/messages";
 import type { ManagementTransport } from "./management.js";
 import type { ConversationMessagesResult, LettaAgent, LettaConversation } from "./management-types.js";
@@ -33,6 +33,7 @@ export declare class AppServerManagementTransport implements ManagementTransport
     retrieveConversation(conversationId: string): Promise<LettaConversation>;
     createConversation(body: ConversationCreateParams): Promise<LettaConversation>;
     updateConversation(conversationId: string, body: ConversationUpdateParams): Promise<LettaConversation>;
+    forkConversation(conversationId: string, body: ConversationForkParams): Promise<LettaConversation>;
     listConversationMessages(conversationId: string, query: MessageListParams): Promise<ConversationMessagesResult>;
     private request;
     private acquireConnection;

package/dist/app-server-management.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-server-management.d.ts","sourceRoot":"","sources":["../src/app-server-management.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,8DAA8D,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAC;AAEjG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,KAAK,EACV,0BAA0B,EAC1B,UAAU,EACV,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjF,KAAK,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,IAAI,IAAI,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,0BAA0B,GACpC,OAAO,CAAC,4BAA4B,CAAC,GAAG;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;CAC1C,CAAC;AAmBJ;;;;;;GAMG;AACH,qBAAa,4BACX,YAAW,mBAAmB;IAKlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,kBAAkB,CAA4B;gBAEzB,OAAO,EAAE,0BAA0B;IAE1D,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAYzD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAanD,WAAW,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,UAAU,CAAC;IAahB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAWvC,iBAAiB,CACrB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAYzB,oBAAoB,CACxB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC;IAavB,kBAAkB,CACtB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAavB,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAavB,wBAAwB,CAC5B,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,0BAA0B,CAAC;YAgBxB,OAAO;IA4BrB,OAAO,CAAC,iBAAiB;YAsBX,cAAc;IA+C5B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,sBAAsB;CAW/B"}
+{"version":3,"file":"app-server-management.d.ts","sourceRoot":"","sources":["../src/app-server-management.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,8DAA8D,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAC;AAGjG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,KAAK,EACV,0BAA0B,EAC1B,UAAU,EACV,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjF,KAAK,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,IAAI,IAAI,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,0BAA0B,GACpC,OAAO,CAAC,4BAA4B,CAAC,GAAG;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;CAC1C,CAAC;AAmBJ;;;;;;GAMG;AACH,qBAAa,4BACX,YAAW,mBAAmB;IAKlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,kBAAkB,CAA4B;gBAEzB,OAAO,EAAE,0BAA0B;IAE1D,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAYzD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAanD,WAAW,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,UAAU,CAAC;IAahB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAWvC,iBAAiB,CACrB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAYzB,oBAAoB,CACxB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC;IAavB,kBAAkB,CACtB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAavB,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAavB,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,iBAAiB,CAAC;IAkBvB,wBAAwB,CAC5B,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,0BAA0B,CAAC;YAgBxB,OAAO;IA4BrB,OAAO,CAAC,iBAAiB;YAsBX,cAAc;IA+C5B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,sBAAsB;CAW/B"}

package/dist/client-entry.d.ts

@@ -11,6 +11,7 @@ export declare class LettaAgentClient extends LettaAgentClientBase {
     constructor(options: PortableLettaAgentClientOptions);
 }
 export { CloudManagedSandboxExpiredError } from "./cloud-session.js";
+export { ConversationForkHydrationError } from "./management-errors.js";
 export { RepositoriesClient } from "./repositories.js";
 export type { Computer, ComputerMetadata, ComputerSelector, ComputersClient, ListComputersOptions, ListComputersResult, ResolvedComputer, } from "./computers.js";
 export type * from "./management-types.js";

package/dist/client-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-entry.d.ts","sourceRoot":"","sources":["../src/client-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EACV,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,+BAA+B,GACvC,4BAA4B,GAC5B,2BAA2B,CAAC;AAEhC;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,oBAAoB;gBAC5C,OAAO,EAAE,+BAA+B;CAMrD;AAED,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,mBAAmB,uBAAuB,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,qCAAqC,EAAE,MAAM,gBAAgB,CAAC;AACvE,mBAAmB,YAAY,CAAC"}
+{"version":3,"file":"client-entry.d.ts","sourceRoot":"","sources":["../src/client-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EACV,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,+BAA+B,GACvC,4BAA4B,GAC5B,2BAA2B,CAAC;AAEhC;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,oBAAoB;gBAC5C,OAAO,EAAE,+BAA+B;CAMrD;AAED,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,mBAAmB,uBAAuB,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,qCAAqC,EAAE,MAAM,gBAAgB,CAAC;AACvE,mBAAmB,YAAY,CAAC"}

package/dist/client-entry.js

@@ -3439,6 +3439,16 @@ function normalizeAppServerModels(response) {
   };
 }
 
+// src/management-errors.ts
+class ConversationForkHydrationError extends Error {
+  conversationId;
+  constructor(conversationId, cause) {
+    super(`Conversation ${conversationId} was forked, but its state could not be retrieved.`, { cause });
+    this.name = "ConversationForkHydrationError";
+    this.conversationId = conversationId;
+  }
+}
+
 // src/request-ids.ts
 var processRequestCounter = 0;
 function createRequestIdGenerator() {
@@ -3509,6 +3519,15 @@ class AppServerManagementTransport {
     const response = await this.request("conversation_update", { conversation_id: conversationId, body }, "conversation_update_response");
     return ensureResponse(response, response.conversation, `Failed to update conversation ${conversationId}.`);
   }
+  async forkConversation(conversationId, body) {
+    const response = await this.request("conversation_fork", { conversation_id: conversationId, body }, "conversation_fork_response");
+    const fork = ensureResponse(response, response.conversation, `Failed to fork conversation ${conversationId}.`);
+    try {
+      return await this.retrieveConversation(fork.id);
+    } catch (error) {
+      throw new ConversationForkHydrationError(fork.id, error);
+    }
+  }
   async listConversationMessages(conversationId, query) {
     const response = await this.request("conversation_messages_list", { conversation_id: conversationId, query }, "conversation_messages_list_response");
     if (!response.success) {
@@ -8807,6 +8826,7 @@ class RemoteTurnCoordinator {
       runIds: new Set,
       observedTurnEvidence: false,
       observedRequiresApprovalStop: false,
+      pendingTerminal: null,
       abortRequested: false,
       timeout: null
     };
@@ -9026,6 +9046,8 @@ class RemoteTurnCoordinator {
       return;
     }
     if (status === "WAITING_ON_INPUT" && active.observedTurnEvidence) {
+      if (active.pendingTerminal)
+        return;
       this.completeActiveTurn({
         runtime: active.runtime,
         stopReason: null,
@@ -9056,14 +9078,19 @@ class RemoteTurnCoordinator {
     }
     const errorCode = toSdkErrorCode(finished.stopReason);
     const success = !isFailureStopReason(finished.stopReason);
-    this.completeActiveTurn({
+    const terminal = {
       runtime: active.runtime,
       stopReason: finished.stopReason,
       runIds: [...active.runIds],
       success,
       ...success ? {} : { errorCode: errorCode ?? "error" },
       ...finished.error ? { detail: finished.error } : {}
-    });
+    };
+    if (active.pendingTerminal) {
+      active.pendingTerminal = terminal;
+      return;
+    }
+    this.completeActiveTurn(terminal);
   }
   handleTurnTerminalDelta(delta, sdkMessage) {
     const active = this.activeTurn;
@@ -9076,11 +9103,15 @@ class RemoteTurnCoordinator {
         active.observedRequiresApprovalStop = true;
         return;
       }
-      this.completeActiveTurn({
+      active.pendingTerminal = {
         runtime: active.runtime,
         stopReason,
         runIds: [...active.runIds]
-      });
+      };
+      return;
+    }
+    if (messageType === "usage_statistics" && active.pendingTerminal) {
+      this.completeActiveTurn(active.pendingTerminal);
       return;
     }
     if (sdkMessage?.type === "error") {
@@ -10518,6 +10549,9 @@ class CloudManagementTransport {
   async updateConversation(conversationId, body) {
     return this.client.conversations.update(conversationId, body);
   }
+  async forkConversation(conversationId, query) {
+    return this.client.conversations.fork(conversationId, query);
+  }
   async listConversationMessages(conversationId, query) {
     const page = await this.client.conversations.messages.list(conversationId, toOrderRelativeCursors(query));
     return { messages: page.items };
@@ -11641,6 +11675,12 @@ function conversationUpdateBody(options) {
     archived: options.archived
   };
 }
+function conversationForkQuery(options) {
+  return {
+    message_id: options.messageId,
+    hidden: options.hidden
+  };
+}
 function conversationMessagesQuery(options) {
   return {
     before: options.before,
@@ -11674,6 +11714,13 @@ function createConversationsClient(transport) {
     retrieve: (conversationId) => transport().retrieveConversation(conversationId),
     create: (options) => transport().createConversation(conversationCreateBody(options)),
     update: (conversationId, options) => transport().updateConversation(conversationId, conversationUpdateBody(options)),
+    fork: async (sourceConversationId, options = {}) => {
+      assertNonEmptyId2(sourceConversationId, "conversation id");
+      if (options.messageId !== undefined) {
+        assertNonEmptyId2(options.messageId, "message id");
+      }
+      return await transport().forkConversation(sourceConversationId, conversationForkQuery(options));
+    },
     listMessages: (conversationId, options = {}) => transport().listConversationMessages(conversationId, conversationMessagesQuery(options))
   };
 }
@@ -12719,7 +12766,8 @@ export {
   createReactNativeWebSocketConstructor,
   RepositoriesClient,
   LettaAgentClient,
+  ConversationForkHydrationError,
   CloudManagedSandboxExpiredError
 };
 
-//# debugId=306AFAA371490E4864756E2164756E21
+//# debugId=D64E5E8DF2F0895364756E2164756E21