@letta-ai/letta-agent-sdk 0.7.7 → 0.8.0

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

@@ -35,6 +35,7 @@ export declare class AppServerManagementTransport implements ManagementTransport
     updateConversation(conversationId: string, body: ConversationUpdateParams): Promise<LettaConversation>;
     forkConversation(conversationId: string, body: ConversationForkParams): Promise<LettaConversation>;
     listConversationMessages(conversationId: string, query: MessageListParams): Promise<ConversationMessagesResult>;
+    enqueueConversationMessage(): Promise<never>;
     private request;
     private acquireConnection;
     private openConnection;

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":"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"}
+{"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;IAgBtC,0BAA0B,IAAI,OAAO,CAAC,KAAK,CAAC;YAQ9B,OAAO;IA4BrB,OAAO,CAAC,iBAAiB;YAsBX,cAAc;IA+C5B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,sBAAsB;CAW/B"}

package/dist/client-entry.js

@@ -20,13 +20,13 @@ function __classPrivateFieldGet(receiver, state, kind, f) {
 
 // node_modules/@letta-ai/letta-client/internal/utils/uuid.mjs
 var uuid4 = function() {
-  const { crypto } = globalThis;
-  if (crypto?.randomUUID) {
-    uuid4 = crypto.randomUUID.bind(crypto);
-    return crypto.randomUUID();
+  const { crypto: crypto2 } = globalThis;
+  if (crypto2?.randomUUID) {
+    uuid4 = crypto2.randomUUID.bind(crypto2);
+    return crypto2.randomUUID();
   }
   const u8 = new Uint8Array(1);
-  const randomByte = crypto ? () => crypto.getRandomValues(u8)[0] : () => Math.random() * 255 & 255;
+  const randomByte = crypto2 ? () => crypto2.getRandomValues(u8)[0] : () => Math.random() * 255 & 255;
   return "10000000-1000-4000-8000-100000000000".replace(/[018]/g, (c) => (+c ^ randomByte() & 15 >> +c / 4).toString(16));
 };
 
@@ -3535,6 +3535,9 @@ class AppServerManagementTransport {
     }
     return { messages: response.messages };
   }
+  enqueueConversationMessage() {
+    return Promise.reject(new Error(`conversations.enqueue() is only available with backend: "cloud". App-server backends deliver messages through a session's send().`));
+  }
   async request(type, body, responseType) {
     if (this.closingConnections.size > 0) {
       await Promise.all([...this.closingConnections]);
@@ -10481,6 +10484,20 @@ function cloudModelEntry(raw) {
 function isNotFound(error) {
   return error instanceof APIError && error.status === 404;
 }
+function asEnqueueMessageResult(body) {
+  if (!body || typeof body !== "object" || Array.isArray(body)) {
+    throw new Error("Cloud enqueue message response was not an object.");
+  }
+  const response = body;
+  if (typeof response.client_message_id !== "string" || typeof response.workflow_id !== "string" || typeof response.super_run_id !== "string") {
+    throw new Error("Cloud enqueue message response did not include client_message_id, workflow_id, and super_run_id.");
+  }
+  return {
+    clientMessageId: response.client_message_id,
+    workflowId: response.workflow_id,
+    superRunId: response.super_run_id
+  };
+}
 function toOrderRelativeCursors(query) {
   if ((query.order ?? "desc") !== "desc")
     return query;
@@ -10572,6 +10589,28 @@ class CloudManagementTransport {
     const page = await this.client.conversations.messages.list(conversationId, toOrderRelativeCursors(query));
     return { messages: page.items };
   }
+  async enqueueConversationMessage(conversationId, message, options) {
+    const clientMessageId = options.clientMessageId ?? crypto.randomUUID();
+    const settings = {
+      ...options.workingDirectory !== undefined ? { working_directory: options.workingDirectory } : {},
+      ...options.permissionMode !== undefined ? { permission_mode: options.permissionMode } : {}
+    };
+    const body = await this.client.post(`/v1/conversations/${encodeURIComponent(conversationId)}/messages/enqueue`, {
+      body: {
+        ...options.agentId !== undefined ? { agent_id: options.agentId } : {},
+        messages: [
+          {
+            role: "user",
+            content: message,
+            client_message_id: clientMessageId
+          }
+        ],
+        client_message_id: clientMessageId,
+        ...Object.keys(settings).length > 0 ? { settings } : {}
+      }
+    });
+    return asEnqueueMessageResult(body);
+  }
 }
 
 // src/remote.ts
@@ -11016,6 +11055,7 @@ var DEFAULT_SANDBOX_READY_TIMEOUT_MS = 120000;
 var DEFAULT_SANDBOX_READY_POLL_INTERVAL_MS = 1000;
 var DEFAULT_REPOSITORY_ATTACH_TIMEOUT_MS = 1e4;
 var DEFAULT_REPOSITORY_ATTACH_POLL_INTERVAL_MS = 250;
+var INITIAL_CLOUD_TRANSPORT_ATTEMPTS = 2;
 var SDK_AGENT_ORIGIN = "@letta-ai/letta-agent-sdk";
 
 class CloudManagedSandboxOwnershipError extends Error {
@@ -11206,30 +11246,9 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
     }
   }
   async openCloudTransport(runtime, connectionId) {
-    const apiKey = getCloudApiKey(this.cloudOptions);
-    const url = buildCloudStatusWebSocketUrl({
-      apiBaseUrl: this.cloudOptions.apiBaseUrl,
-      connectionId,
-      agentId: runtime.agent_id,
-      conversationId: runtime.conversation_id,
-      apiKey,
-      authMode: this.cloudOptions.webSocketAuth ?? "header"
-    });
-    const client = applyUniqueRequestIds(createAppServerClient({
-      url,
-      WebSocket: createCloudStatusTransportConstructor({
-        url,
-        WebSocket: getWebSocketConstructor(this.cloudOptions.WebSocket),
-        ...(this.cloudOptions.webSocketAuth ?? "header") === "header" ? { headers: cloudWebSocketHeaders(this.cloudOptions) } : {},
-        pingIntervalMs: this.cloudOptions.pingIntervalMs ?? DEFAULT_PING_INTERVAL_MS,
-        runtime
-      }),
-      requestTimeoutMs: this.cloudOptions.requestTimeoutMs ?? DEFAULT_TURN_TIMEOUT_MS
-    }));
+    const client = await this.connectCloudTransport(runtime, connectionId);
     const options = this.currentOptions();
-    this.installTransportHandlers(client);
     try {
-      await client.connect();
       const response = await this.startCloudRuntime(client, runtime);
       if (!response.success || !response.runtime) {
         throw new Error(response.error ?? "Failed to start Cloud status runtime");
@@ -11257,6 +11276,62 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
       throw error;
     }
   }
+  createCloudTransportClient(runtime, connectionId) {
+    const apiKey = getCloudApiKey(this.cloudOptions);
+    const url = buildCloudStatusWebSocketUrl({
+      apiBaseUrl: this.cloudOptions.apiBaseUrl,
+      connectionId,
+      agentId: runtime.agent_id,
+      conversationId: runtime.conversation_id,
+      apiKey,
+      authMode: this.cloudOptions.webSocketAuth ?? "header"
+    });
+    return applyUniqueRequestIds(createAppServerClient({
+      url,
+      WebSocket: createCloudStatusTransportConstructor({
+        url,
+        WebSocket: getWebSocketConstructor(this.cloudOptions.WebSocket),
+        ...(this.cloudOptions.webSocketAuth ?? "header") === "header" ? { headers: cloudWebSocketHeaders(this.cloudOptions) } : {},
+        pingIntervalMs: this.cloudOptions.pingIntervalMs ?? DEFAULT_PING_INTERVAL_MS,
+        runtime
+      }),
+      requestTimeoutMs: this.cloudOptions.requestTimeoutMs ?? DEFAULT_TURN_TIMEOUT_MS
+    }));
+  }
+  async connectCloudTransport(runtime, initialConnectionId) {
+    let connectionId = initialConnectionId;
+    let lastError;
+    for (let attempt = 0;attempt < INITIAL_CLOUD_TRANSPORT_ATTEMPTS; attempt++) {
+      const client = this.createCloudTransportClient(runtime, connectionId);
+      this.installTransportHandlers(client);
+      try {
+        await client.connect();
+        this.connectionId = connectionId;
+        return client;
+      } catch (error) {
+        lastError = error;
+        console.warn(JSON.stringify({
+          event: "cloud_status_transport_connection_failed",
+          attempt: attempt + 1,
+          max_attempts: INITIAL_CLOUD_TRANSPORT_ATTEMPTS,
+          will_retry: attempt + 1 < INITIAL_CLOUD_TRANSPORT_ATTEMPTS,
+          connection_id: connectionId,
+          agent_id: runtime.agent_id,
+          conversation_id: runtime.conversation_id,
+          error_name: error instanceof Error ? error.name : null,
+          error_message: error instanceof Error ? error.message : String(error)
+        }));
+        this.cleanupTransportHandlers();
+        client.close();
+      }
+      if (attempt + 1 < INITIAL_CLOUD_TRANSPORT_ATTEMPTS) {
+        const resolved = await this.resolveRecoveryConnection(runtime);
+        connectionId = resolved.connectionId;
+      }
+    }
+    const detail = lastError instanceof Error ? lastError.message : String(lastError);
+    throw new Error(`Cloud status WebSocket failed to open for connection ${connectionId}: ${detail}`, { cause: lastError });
+  }
   installTransportHandlers(client) {
     this.cleanupTransportHandlers();
     this.removeControlRequestHandler = registerAppServerControlRequestHandler({
@@ -11809,7 +11884,20 @@ function createConversationsClient(transport) {
       }
       return await transport().forkConversation(sourceConversationId, conversationForkQuery(options));
     },
-    listMessages: (conversationId, options = {}) => transport().listConversationMessages(conversationId, conversationMessagesQuery(options))
+    listMessages: (conversationId, options = {}) => transport().listConversationMessages(conversationId, conversationMessagesQuery(options)),
+    enqueue: async (conversationId, message, options = {}) => {
+      assertNonEmptyId2(conversationId, "conversation id");
+      if (conversationId.trim() === "default" && !options.agentId) {
+        throw new Error('enqueue("default", ...) requires options.agentId to identify the agent.');
+      }
+      if (options.agentId !== undefined) {
+        assertNonEmptyId2(options.agentId, "agent id");
+      }
+      if (options.clientMessageId !== undefined) {
+        assertNonEmptyId2(options.clientMessageId, "client message id");
+      }
+      return await transport().enqueueConversationMessage(conversationId, message, options);
+    }
   };
 }
 
@@ -12858,4 +12946,4 @@ export {
   CloudManagedSandboxExpiredError
 };
 
-//# debugId=4D2DEBF58B35A6BA64756E2164756E21
+//# debugId=6DEC5A9A513E517464756E2164756E21