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

package/src/local-app-server.ts

@@ -22,6 +22,8 @@ export interface StartLocalAppServerOptions {
   env?: Record<string, string | undefined>;
   filesystemConfinement?: "memory";
   agentId?: string;
+  /** Register the app-server as a Letta Cloud computer with this name. */
+  computerName?: string;
 }
 
 interface LocalAppServerProcess {
@@ -95,7 +97,10 @@ function tryExtractListeningUrl(output: string): string | null {
 
 export function buildLocalAppServerArgs(
   cliPath: string,
-  options: Pick<StartLocalAppServerOptions, "backend" | "listen"> = {},
+  options: Pick<
+    StartLocalAppServerOptions,
+    "backend" | "listen" | "computerName"
+  > = {},
 ): string[] {
   return [
     cliPath,
@@ -103,6 +108,9 @@ export function buildLocalAppServerArgs(
     "server",
     "--listen",
     options.listen ?? DEFAULT_LISTEN_URL,
+    ...(options.computerName !== undefined
+      ? ["--computer-name", options.computerName]
+      : []),
   ];
 }
 

package/src/tool-registration.ts

@@ -5,7 +5,7 @@ import {
 } from "@letta-ai/letta-code/app-server-client";
 import type { ConversationRetrieveResponseMessage } from "@letta-ai/letta-code/app-server-protocol";
 import type { AppServerSessionOptions } from "./app-server-session.js";
-import { createExternalToolCallHandler, externalToolGroups } from "./external-tools.js";
+import { createExternalToolCallHandler, externalToolGroups, registerExternalToolCallHandler } from "./external-tools.js";
 import { applyUniqueRequestIds } from "./request-ids.js";
 import {
   runtimeToolPolicy,
@@ -215,12 +215,12 @@ export class ToolRegistry {
         ? { 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();

package/src/types.ts

@@ -433,6 +433,13 @@ export interface LettaCodeCloudClientOptions {
   environment?: LettaCodeEnvironment;
   /** Options for SDK-managed sandboxes when no computer is selected. */
   sandbox?: LettaCodeCloudSandboxOptions;
+  /**
+   * Register this machine as a computer with this name and run the client's
+   * sessions on it. The SDK starts a Letta Code app-server here, so tools from
+   * `client.registerTools()` run in this process, including on turns Letta
+   * Cloud delivers to this computer. Node.js only; excludes `computer`/`sandbox`.
+   */
+  registerComputer?: { name: string };
 }
 
 export type LettaCodeClientOptions =