@letta-ai/letta-agent-sdk 0.8.77 → 0.8.79

package/dist/client.d.ts

@@ -8,6 +8,7 @@ export declare class LettaAgentClient extends LettaAgentClientBase {
     private localClosePromise;
     private sharedLocalServer;
     close(): Promise<void>;
+    protected startRegisteredComputer(): Promise<void>;
     protected skillNodeSupport(): SkillNodeSupport;
     protected createLocalManagementTransport(): ManagementTransport;
     protected localAppServerConnection(): {

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EACV,kBAAkB,EAClB,6BAA6B,EAE7B,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,gBAAiB,SAAQ,oBAAoB;IACxD,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,iBAAiB,CAA8B;IAEvD,OAAO,CAAC,iBAAiB;IAUhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;cAUZ,gBAAgB,IAAI,gBAAgB;cAIpC,8BAA8B,IAAI,mBAAmB;cAIrD,wBAAwB;;;;;;;;;cAoBlB,gBAAgB,CACvC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC;cAqBC,kBAAkB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,6BAA6B,GACrC,gBAAgB;cAcA,uBAAuB,CACxC,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,6BAA6B,GAC5C,gBAAgB;cAgCA,kBAAkB,CACnC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,6BAA6B,GACrC,gBAAgB;CAwBpB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EACV,kBAAkB,EAElB,6BAA6B,EAE7B,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,gBAAiB,SAAQ,oBAAoB;IACxD,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,iBAAiB,CAA8B;IAEvD,OAAO,CAAC,iBAAiB;IAehB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;cAUN,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;cAI9C,gBAAgB,IAAI,gBAAgB;cAIpC,8BAA8B,IAAI,mBAAmB;cAIrD,wBAAwB;;;;;;;;;cAyBlB,gBAAgB,CACvC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC;cAqBC,kBAAkB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,6BAA6B,GACrC,gBAAgB;cAcA,uBAAuB,CACxC,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,6BAA6B,GAC5C,gBAAgB;cAgCA,kBAAkB,CACnC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,6BAA6B,GACrC,gBAAgB;CAwBpB"}

package/dist/cloud-session.d.ts

@@ -3,6 +3,9 @@ import { type SkillFilesPusher } from "./skill-loading.js";
 import { RemoteClientSessionCore, type RuntimeScope, type RuntimeSessionInit, type RuntimeSessionMode } from "./remote-client-session-core.js";
 import type { CreateAgentOptions, LettaCodeClientSessionOptions, LettaCodeCloudClientOptions } from "./types.js";
 import { type SandboxFilesClient } from "./sandbox-files.js";
+type ResolvedCloudConnection = {
+    connectionId: string;
+};
 /**
  * The Cloud API reaped a conversation-scoped managed sandbox before the SDK
  * could refresh it. The failed refresh happens before the next turn is sent,
@@ -26,6 +29,8 @@ export declare function assertCloudSessionOptionsSupported(action: string, optio
 export declare class CloudEnvironmentSession extends RemoteClientSessionCore {
     private readonly cloudOptions;
     private readonly apiClient;
+    /** Starts and resolves the computer this client registers, when the session runs there. */
+    private readonly connectRegisteredComputer?;
     readonly sandbox: SandboxFilesClient | undefined;
     private connectionId;
     private removeExternalToolHandler;
@@ -41,7 +46,9 @@ export declare class CloudEnvironmentSession extends RemoteClientSessionCore {
     private repositoryIdsRequiringCleanupRecompile;
     private readonly repositoryManagement;
     private readonly cloudMode;
-    constructor(cloudOptions: LettaCodeCloudClientOptions, mode: CloudSessionMode, apiClient?: Letta);
+    constructor(cloudOptions: LettaCodeCloudClientOptions, mode: CloudSessionMode, apiClient?: Letta, 
+    /** Starts and resolves the computer this client registers, when the session runs there. */
+    connectRegisteredComputer?: (() => Promise<ResolvedCloudConnection>) | undefined);
     protected initializeRuntimeController(): Promise<RuntimeSessionInit>;
     private openCloudTransport;
     private createCloudTransportClient;

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

@@ -1 +1 @@
-{"version":3,"file":"cloud-session.d.ts","sourceRoot":"","sources":["../src/cloud-session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cloud-session.d.ts","sourceRoot":"","sources":["../src/cloud-session.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -13576,6 +13576,7 @@ class RemoteTurnCoordinator {
       active.observedTurnEvidence = true;
       if (runId)
         active.runIds.add(runId);
+      this.armTurnTimeout(active);
     }
     const sdkMessage = this.transformStreamDelta(delta);
     if (sdkMessage)
@@ -13641,12 +13642,17 @@ class RemoteTurnCoordinator {
     this.activeTurn = turn;
     turn.startedAt = Date.now();
     this._activeTurnStartedAt = turn.startedAt;
-    if (this.requestTimeoutMs !== undefined) {
-      turn.timeout = setTimeout(() => {
-        this.failTurn(turn, `Timed out waiting for ${this.label} turn`);
-      }, this.requestTimeoutMs);
-      turn.timeout.unref?.();
-    }
+    this.armTurnTimeout(turn);
+  }
+  armTurnTimeout(turn) {
+    if (this.requestTimeoutMs === undefined)
+      return;
+    if (turn.timeout)
+      clearTimeout(turn.timeout);
+    turn.timeout = setTimeout(() => {
+      this.failTurn(turn, `Timed out waiting for ${this.label} turn`);
+    }, this.requestTimeoutMs);
+    turn.timeout.unref?.();
   }
   activateNextTurnFromProtocol() {
     if (this.activeTurn)
@@ -16001,6 +16007,19 @@ function validateCloudClientOptions(options) {
     const field = options.computer !== undefined ? "computer" : "environment";
     throw new Error(`Letta Cloud sessions cannot specify both ${field} and sandbox options.`);
   }
+  if (options.registerComputer !== undefined) {
+    const name = options.registerComputer?.name;
+    if (typeof name !== "string" || !name.trim()) {
+      throw new Error("Invalid registerComputer.name. Expected a non-empty string.");
+    }
+    if (options.computer !== undefined || options.environment !== undefined) {
+      const field = options.computer !== undefined ? "computer" : "environment";
+      throw new Error(`Letta Cloud clients cannot specify both ${field} and registerComputer. Use computer for a machine that is already connected, or registerComputer to connect this one.`);
+    }
+    if (options.sandbox !== undefined) {
+      throw new Error("Letta Cloud clients cannot specify both registerComputer and sandbox options.");
+    }
+  }
   if (options.webSocketAuth !== undefined && options.webSocketAuth !== "header" && options.webSocketAuth !== "query") {
     throw new Error("Invalid webSocketAuth. Valid values: header, query.");
   }
@@ -16094,6 +16113,7 @@ function assertCloudSessionOptionsSupported(action, options) {
 class CloudEnvironmentSession extends RemoteClientSessionCore {
   cloudOptions;
   apiClient;
+  connectRegisteredComputer;
   sandbox;
   connectionId = null;
   removeExternalToolHandler = null;
@@ -16109,13 +16129,14 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
   repositoryIdsRequiringCleanupRecompile = new Set;
   repositoryManagement;
   cloudMode;
-  constructor(cloudOptions, mode, apiClient = createCloudClient(cloudOptions)) {
+  constructor(cloudOptions, mode, apiClient = createCloudClient(cloudOptions), connectRegisteredComputer) {
     super(mode, {
       label: "cloud",
       requestTimeoutMs: cloudOptions.requestTimeoutMs ?? DEFAULT_TURN_TIMEOUT_MS
     });
     this.cloudOptions = cloudOptions;
     this.apiClient = apiClient;
+    this.connectRegisteredComputer = connectRegisteredComputer;
     this.cloudMode = mode;
     this.repositoryManagement = new CloudManagementTransport(apiClient);
     this.sandbox = this.effectiveEnvironment() === undefined ? {
@@ -16518,6 +16539,8 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
     return this.createManagedSandboxConnection(runtime);
   }
   async resolveExplicitConnection(environment) {
+    if (this.connectRegisteredComputer)
+      return this.connectRegisteredComputer();
     const target = environmentToRemoteTarget(environment);
     const resolved = await this.remoteEnvironmentClient().resolveEnvironment(target);
     return { connectionId: resolved.connectionId };
@@ -17317,6 +17340,15 @@ function stripCloudExecutionOptions(options) {
   delete sessionOptions.filesystemConfinement;
   return sessionOptions;
 }
+var REGISTERED_COMPUTER_READY_TIMEOUT_MS = 30000;
+var REGISTERED_COMPUTER_POLL_INTERVAL_MS = 500;
+function registeredComputerName(options) {
+  return options.backend === "cloud" ? options.registerComputer?.name : undefined;
+}
+function isRegisteredComputerPending(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return message.startsWith("Computer not found") || message.startsWith("Computer is offline");
+}
 function hasRepositoryResources(options) {
   return options.resources !== undefined && options.resources.length > 0;
 }
@@ -17375,7 +17407,8 @@ class LettaAgentClientBase {
       throw new Error(`Invalid Letta Code backend '${String(backend)}'. Valid values: local, remote, cloud.`);
     }
     this.backend = backend;
-    this.computer = getOptionsComputer(options);
+    const registeredName = registeredComputerName(options);
+    this.computer = getOptionsComputer(options) ?? (registeredName !== undefined ? { name: registeredName } : undefined);
     this.environment = this.computer;
     this.options = options;
     this.agents = createAgentsClient(() => this.getManagementTransport(), () => this.getAgentRepositoriesClient());
@@ -17471,12 +17504,12 @@ class LettaAgentClientBase {
       });
     }
     if (this.backend === "cloud") {
-      return new CloudEnvironmentSession(this.cloudOptions(), {
+      return this.createCloudSession({
         kind: "session",
         agentId,
         newConversation: true,
         options
-      }, this.getCloudClient());
+      });
     }
     return this.createLocalSession(agentId, options);
   }
@@ -17502,19 +17535,7 @@ class LettaAgentClientBase {
       return session2;
     }
     if (this.backend === "cloud") {
-      if (looksLikeConversationId(id)) {
-        return new CloudEnvironmentSession(this.cloudOptions(), {
-          kind: "session",
-          conversationId: id,
-          options
-        }, this.getCloudClient());
-      }
-      return new CloudEnvironmentSession(this.cloudOptions(), {
-        kind: "session",
-        agentId: id,
-        defaultConversation: true,
-        options
-      }, this.getCloudClient());
+      return this.createCloudSession(looksLikeConversationId(id) ? { kind: "session", conversationId: id, options } : { kind: "session", agentId: id, defaultConversation: true, options });
     }
     const session = this.resumeLocalSession(id, options);
     if (inherited && session instanceof AppServerSession)
@@ -17580,11 +17601,11 @@ class LettaAgentClientBase {
       if (!conversation || typeof conversation !== "object" || typeof conversation.id !== "string") {
         throw new Error("Cloud query conversation response did not include a conversation id.");
       }
-      return new CloudEnvironmentSession(this.cloudOptions(), {
+      return this.createCloudSession({
         kind: "conversation",
         conversationId: conversation.id,
         options: sessionOptions
-      }, this.getCloudClient());
+      });
     }
     return this.createLocalQuerySession(options, sessionOptions);
   }
@@ -17649,6 +17670,29 @@ class LettaAgentClientBase {
     }
     throw new Error(`LettaAgentClient backend '${this.backend}' is not implemented yet. ${action} currently supports backend 'local' only.`);
   }
+  createCloudSession(mode) {
+    const name = registeredComputerName(this.options);
+    const sessionComputer = mode.options.computer ?? mode.options.environment;
+    return new CloudEnvironmentSession(this.cloudOptions(), mode, this.getCloudClient(), name !== undefined && sessionComputer === undefined ? () => this.connectRegisteredComputer(name) : undefined);
+  }
+  async connectRegisteredComputer(name) {
+    await this.startRegisteredComputer();
+    const deadline = Date.now() + REGISTERED_COMPUTER_READY_TIMEOUT_MS;
+    while (true) {
+      try {
+        const resolved = await this.getComputersClient().resolve({ name });
+        return { connectionId: resolved.connectionId };
+      } catch (error) {
+        if (!isRegisteredComputerPending(error) || Date.now() >= deadline) {
+          throw error;
+        }
+        await new Promise((resolve) => setTimeout(resolve, REGISTERED_COMPUTER_POLL_INTERVAL_MS));
+      }
+    }
+  }
+  startRegisteredComputer() {
+    return Promise.reject(this.localBackendUnavailableError());
+  }
   createLocalAgent(_options) {
     throw this.localBackendUnavailableError();
   }
@@ -17729,8 +17773,8 @@ class LettaAgentClientBase {
   }
   registerTools(options) {
     this.assertOpen();
-    if (this.backend === "cloud") {
-      return Promise.reject(new Error('registerTools() requires backend: "local" or "remote". Cloud sessions register tools through the tools session option.'));
+    if (this.backend === "cloud" && registeredComputerName(this.options) === undefined) {
+      return Promise.reject(new Error('registerTools() requires backend: "local" or "remote", or backend: "cloud" with registerComputer. Other Cloud sessions register tools through the tools session option.'));
     }
     this.toolRegistry ??= new ToolRegistry(this.backend === "remote" ? this.remoteOptions() : this.localAppServerConnection());
     return this.toolRegistry.register(options);
@@ -17761,7 +17805,8 @@ class LettaAgentClientBase {
     if (this.backend !== "cloud") {
       throw new Error('Letta Cloud options requested for non-"cloud" backend.');
     }
-    return this.options;
+    const options = this.options;
+    return options.registerComputer !== undefined ? { ...options, computer: { name: options.registerComputer.name } } : options;
   }
 }
 
@@ -18243,7 +18288,8 @@ function buildLocalAppServerArgs(cliPath, options = {}) {
     ...options.backend !== undefined ? ["--backend", options.backend] : [],
     "server",
     "--listen",
-    options.listen ?? DEFAULT_LISTEN_URL
+    options.listen ?? DEFAULT_LISTEN_URL,
+    ...options.computerName !== undefined ? ["--computer-name", options.computerName] : []
   ];
 }
 function buildLocalAppServerProcess(cliPath, options = {}, confineMemory = createMemoryConfinementLauncher) {
@@ -18510,6 +18556,9 @@ class LettaAgentClient extends LettaAgentClientBase {
   sharedLocalServer() {
     if (this.localClosePromise)
       throw new Error("LettaAgentClient is closed");
+    if (this.backend === "cloud") {
+      return this.localServer ??= registeredComputerServer(this.options);
+    }
     const options = this.options.appServer;
     return this.localServer ??= new SharedLocalAppServer({
       listen: options?.listen,
@@ -18526,6 +18575,9 @@ class LettaAgentClient extends LettaAgentClientBase {
     }
     return this.localClosePromise;
   }
+  async startRegisteredComputer() {
+    await this.sharedLocalServer().connect();
+  }
   skillNodeSupport() {
     return { loadSkillDirectory, pushSkillSupportFiles };
   }
@@ -18533,10 +18585,13 @@ class LettaAgentClient extends LettaAgentClientBase {
     return new AppServerManagementTransport(this.localAppServerConnection());
   }
   localAppServerConnection() {
-    const localOptions = this.options.appServer;
+    const localOptions = this.backend === "cloud" ? {
+      WebSocket: this.options.WebSocket,
+      requestTimeoutMs: this.options.requestTimeoutMs
+    } : this.options.appServer;
     const sharedServer = this.sharedLocalServer();
     return {
-      ...localOptions?.url !== undefined ? { url: localOptions.url } : {
+      ...localOptions !== undefined && "url" in localOptions && localOptions.url !== undefined ? { url: localOptions.url } : {
         connect: () => sharedServer.connect()
       },
       ...localOptions?.WebSocket !== undefined ? { WebSocket: localOptions.WebSocket } : {},
@@ -18604,6 +18659,21 @@ class LettaAgentClient extends LettaAgentClientBase {
     }, this.sharedLocalServer());
   }
 }
+function registeredComputerServer(options) {
+  const name = options.registerComputer?.name;
+  if (name === undefined) {
+    throw new Error('A local app-server is only available with backend: "local" or registerComputer.');
+  }
+  const apiKey = getCloudApiKey(options);
+  return new SharedLocalAppServer({
+    backend: "api",
+    computerName: name,
+    env: {
+      ...apiKey !== undefined ? { LETTA_API_KEY: apiKey } : {},
+      ...options.apiBaseUrl !== undefined ? { LETTA_BASE_URL: options.apiBaseUrl } : {}
+    }
+  });
+}
 function looksLikeConversationId2(id) {
   return id.startsWith("conv-") || id.startsWith("local-conv-");
 }
@@ -35393,7 +35463,7 @@ class StreamableHTTPClientTransport {
 }
 var DEFAULT_CLIENT_INFO = {
   name: "letta-code",
-  version: "0.34.48"
+  version: "0.34.49"
 };
 async function connectMcpServer(config2, options = {}) {
   let client = new Client(options.clientInfo ?? DEFAULT_CLIENT_INFO);
@@ -36421,4 +36491,4 @@ export {
   CloudManagedSandboxExpiredError
 };
 
-//# debugId=3C15E1A8960C3D4D64756E2164756E21
+//# debugId=AFB0BEDEFE911CAD64756E2164756E21