@letta-ai/letta-agent-sdk 0.8.78 → 0.8.80

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/external-tools.d.ts

@@ -1,4 +1,4 @@
-import type { AppServerExternalToolCallHandler } from "@letta-ai/letta-code/app-server-client";
+import type { AppServerClient, AppServerExternalToolCallHandler } from "@letta-ai/letta-code/app-server-client";
 import type { RuntimeScope } from "./remote-session-protocol.js";
 import type { AnyAgentTool } from "./types.js";
 /** The `external_tools` groups that advertise client tools to the runtime. */
@@ -7,5 +7,9 @@ export declare function externalToolGroups(tools: AnyAgentTool[] | undefined): A
  * Run a runtime's external tool call against the client tools by name.
  * `fallbackRuntime` covers listeners that send calls without a `runtime`.
  */
-export declare function createExternalToolCallHandler(externalTools: Map<string, AnyAgentTool>, fallbackRuntime?: () => RuntimeScope | null): AppServerExternalToolCallHandler;
+export declare function createExternalToolCallHandler(externalTools: Map<string, AnyAgentTool>, fallbackRuntime?: () => RuntimeScope | null): CancellableToolCallHandler;
+type CancellableToolCallHandler = (request: Parameters<AppServerExternalToolCallHandler>[0], signal?: AbortSignal) => ReturnType<AppServerExternalToolCallHandler>;
+/** Own response arbitration so cancellation and completion cannot both reply. */
+export declare function registerExternalToolCallHandler(client: AppServerClient, handler: CancellableToolCallHandler): () => void;
+export {};
 //# sourceMappingURL=external-tools.d.ts.map

package/dist/external-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external-tools.d.ts","sourceRoot":"","sources":["../src/external-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAC;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAwB,YAAY,EAAE,MAAM,YAAY,CAAC;AAErE,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAYhH;AAID;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACxC,eAAe,CAAC,EAAE,MAAM,YAAY,GAAG,IAAI,GAC1C,gCAAgC,CAwClC"}
+{"version":3,"file":"external-tools.d.ts","sourceRoot":"","sources":["../src/external-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAC;AAChH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAwB,YAAY,EAAE,MAAM,YAAY,CAAC;AAErE,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAahH;AAID;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACxC,eAAe,CAAC,EAAE,MAAM,YAAY,GAAG,IAAI,GAC1C,0BAA0B,CAwC5B;AAED,KAAK,0BAA0B,GAAG,CAChC,OAAO,EAAE,UAAU,CAAC,gCAAgC,CAAC,CAAC,CAAC,CAAC,EACxD,MAAM,CAAC,EAAE,WAAW,KACjB,UAAU,CAAC,gCAAgC,CAAC,CAAC;AAElD,iFAAiF;AACjF,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,0BAA0B,GAClC,MAAM,IAAI,CAuCZ"}

package/dist/index.js

@@ -9536,18 +9536,39 @@ function onceSocketEvent(socket, type, listener) {
   });
   return detach;
 }
-function waitForSocketOpen(socket) {
+function waitForSocketOpen(socket, timeoutMs) {
   if (socket.readyState === WEBSOCKET_OPEN_STATE) {
     return Promise.resolve();
   }
-  return new Promise((resolve, reject) => {
+  return new Promise((resolvePromise, rejectPromise) => {
+    let settled = false;
+    const resolve = () => {
+      if (settled)
+        return;
+      settled = true;
+      resolvePromise();
+    };
+    const reject = (error) => {
+      if (settled)
+        return;
+      settled = true;
+      rejectPromise(error);
+    };
     let detachOpen = () => {};
     let detachError = () => {};
+    let detachClose = () => {};
     let detachResponse = () => {};
     let detachBody = () => {};
+    let upgradeRejected = false;
+    const timer = timeoutMs > 0 ? setTimeout(() => {
+      cleanup();
+      reject(new Error(`App-server WebSocket failed to open: timed out after ${timeoutMs}ms`));
+    }, timeoutMs) : undefined;
     const cleanup = () => {
+      clearTimeout(timer);
       detachOpen();
       detachError();
+      detachClose();
       detachResponse();
       detachBody();
     };
@@ -9559,6 +9580,7 @@ function waitForSocketOpen(socket) {
       const onResponse = (_request, response) => {
         if (!response)
           return;
+        upgradeRejected = true;
         const request = _request;
         let body = Buffer.alloc(0);
         let finished = false;
@@ -9600,6 +9622,12 @@ function waitForSocketOpen(socket) {
       cleanup();
       reject(new Error(`App-server WebSocket failed to open: ${String(event)}`));
     });
+    detachClose = onceSocketEvent(socket, "close", () => {
+      if (upgradeRejected)
+        return;
+      cleanup();
+      reject(new Error("App-server WebSocket failed to open: closed before opening"));
+    });
   });
 }
 function rawEventData(event) {
@@ -9667,7 +9695,7 @@ class AppServerClient {
     });
   }
   async connect() {
-    await waitForSocketOpen(this.socket);
+    await waitForSocketOpen(this.socket, this.requestTimeoutMs);
     return this;
   }
   close() {
@@ -13294,6 +13322,7 @@ function externalToolGroups(tools) {
     return;
   return [
     {
+      capabilities: { external_tool_call_cancel: true },
       tools: tools.map((tool) => ({
         name: tool.name,
         label: tool.label,
@@ -13306,14 +13335,14 @@ function externalToolGroups(tools) {
 var MAX_REMEMBERED_EXTERNAL_TOOL_CALLS = 200;
 function createExternalToolCallHandler(externalTools, fallbackRuntime) {
   const calls = new Map;
-  const execute = async (request) => {
+  const execute = async (request, signal) => {
     const tool = externalTools.get(request.tool_name);
     if (!tool) {
       throw new Error(`Unknown external tool: ${request.tool_name}`);
     }
     const runtime = request.runtime ?? fallbackRuntime?.() ?? null;
     const context = runtime ? { toolCallId: request.tool_call_id, agentId: runtime.agent_id, conversationId: runtime.conversation_id } : undefined;
-    const result = await tool.execute(request.tool_call_id, request.input, undefined, undefined, context);
+    const result = await tool.execute(request.tool_call_id, request.input, signal, undefined, context);
     return {
       content: result.content.map((part) => ({
         type: part.type,
@@ -13324,15 +13353,15 @@ function createExternalToolCallHandler(externalTools, fallbackRuntime) {
       ...result.isError === true ? { is_error: true } : {}
     };
   };
-  return (request) => {
+  return (request, signal) => {
     const requestId = request.request_id;
     if (typeof requestId !== "string" || requestId.length === 0) {
-      return execute(request);
+      return execute(request, signal);
     }
     const existing = calls.get(requestId);
     if (existing)
       return existing;
-    const call = execute(request);
+    const call = execute(request, signal);
     calls.set(requestId, call);
     while (calls.size > MAX_REMEMBERED_EXTERNAL_TOOL_CALLS) {
       const oldest = calls.keys().next().value;
@@ -13343,6 +13372,49 @@ function createExternalToolCallHandler(externalTools, fallbackRuntime) {
     return call;
   };
 }
+function registerExternalToolCallHandler(client, handler) {
+  const pending = new Map;
+  const completed = new Set;
+  const remove = client.onMessage((raw, channel) => {
+    if (channel !== "control")
+      return;
+    const message = raw;
+    const requestId = message.request_id;
+    if (typeof requestId !== "string")
+      return;
+    if (message.type === "external_tool_call_cancel") {
+      const call = pending.get(requestId);
+      if (!call)
+        return;
+      call.finish({ error: "cancelled" });
+      call.controller.abort(message.reason);
+      return;
+    }
+    if (message.type !== "external_tool_call_request" || pending.has(requestId) || completed.has(requestId))
+      return;
+    const controller = new AbortController;
+    const finish = (response) => {
+      if (!pending.delete(requestId))
+        return;
+      completed.add(requestId);
+      if (completed.size > MAX_REMEMBERED_EXTERNAL_TOOL_CALLS)
+        completed.delete(completed.values().next().value);
+      client.send({ type: "external_tool_call_response", request_id: requestId, ...response });
+    };
+    pending.set(requestId, { controller, finish });
+    try {
+      Promise.resolve(handler(raw, controller.signal)).then((result) => finish({ result }), (error) => finish({ error: error instanceof Error ? error.message : String(error) }));
+    } catch (error) {
+      finish({ error: error instanceof Error ? error.message : String(error) });
+    }
+  });
+  return () => {
+    remove();
+    for (const call of pending.values())
+      call.controller.abort();
+    pending.clear();
+  };
+}
 
 // src/runtime-tool-policy.ts
 var RUNTIME_TOOL_POLICY_CAPABILITY = "runtime_tool_policy";
@@ -15167,7 +15239,7 @@ class AppServerSession extends RemoteClientSessionCore {
       getOptions: () => this.currentOptions()
     });
     if (this.externalTools.size > 0 || this.inheritedTools) {
-      this.removeExternalToolHandler = client.onExternalToolCall(createExternalToolCallHandler(this.externalTools, () => this.runtime));
+      this.removeExternalToolHandler = registerExternalToolCallHandler(client, createExternalToolCallHandler(this.externalTools, () => this.runtime));
     }
     try {
       await client.connect();
@@ -16007,6 +16079,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.");
   }
@@ -16100,6 +16185,7 @@ function assertCloudSessionOptionsSupported(action, options) {
 class CloudEnvironmentSession extends RemoteClientSessionCore {
   cloudOptions;
   apiClient;
+  connectRegisteredComputer;
   sandbox;
   connectionId = null;
   removeExternalToolHandler = null;
@@ -16115,13 +16201,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 ? {
@@ -16257,7 +16344,7 @@ class CloudEnvironmentSession extends RemoteClientSessionCore {
       getOptions: () => this.currentOptions()
     });
     if (this.externalTools.size > 0) {
-      this.removeExternalToolHandler = client.onExternalToolCall(createExternalToolCallHandler(this.externalTools, () => this.runtime));
+      this.removeExternalToolHandler = registerExternalToolCallHandler(client, createExternalToolCallHandler(this.externalTools, () => this.runtime));
     }
   }
   cleanupTransportHandlers() {
@@ -16524,6 +16611,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 };
@@ -17013,12 +17102,12 @@ class ToolRegistry {
       ...this.options.WebSocket ? { WebSocket: this.options.WebSocket } : {},
       ...this.options.requestTimeoutMs !== undefined ? { requestTimeoutMs: this.options.requestTimeoutMs } : {}
     }));
-    client.onExternalToolCall(async (request) => {
+    registerExternalToolCallHandler(client, async (request, signal) => {
       const runtime = request.runtime;
       const entry = runtime && [...this.entries].find((candidate) => candidate.runtimes.some((r) => runtimeKey(r) === runtimeKey(runtime)));
       if (!entry)
         throw new Error(`No tools registered for conversation ${runtime?.conversation_id}`);
-      return entry.call(request);
+      return entry.call(request, signal);
     });
     try {
       await client.connect();
@@ -17323,6 +17412,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;
 }
@@ -17381,7 +17479,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());
@@ -17477,12 +17576,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);
   }
@@ -17508,19 +17607,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)
@@ -17586,11 +17673,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);
   }
@@ -17655,6 +17742,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();
   }
@@ -17735,8 +17845,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);
@@ -17767,7 +17877,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;
   }
 }
 
@@ -18249,7 +18360,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) {
@@ -18516,6 +18628,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,
@@ -18532,6 +18647,9 @@ class LettaAgentClient extends LettaAgentClientBase {
     }
     return this.localClosePromise;
   }
+  async startRegisteredComputer() {
+    await this.sharedLocalServer().connect();
+  }
   skillNodeSupport() {
     return { loadSkillDirectory, pushSkillSupportFiles };
   }
@@ -18539,10 +18657,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 } : {},
@@ -18610,6 +18731,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-");
 }
@@ -35399,7 +35535,7 @@ class StreamableHTTPClientTransport {
 }
 var DEFAULT_CLIENT_INFO = {
   name: "letta-code",
-  version: "0.34.49"
+  version: "0.34.50"
 };
 async function connectMcpServer(config2, options = {}) {
   let client = new Client(options.clientInfo ?? DEFAULT_CLIENT_INFO);
@@ -36427,4 +36563,4 @@ export {
   CloudManagedSandboxExpiredError
 };
 
-//# debugId=4CD40C08118B97D164756E2164756E21
+//# debugId=FF481D2B70CB9B5D64756E2164756E21