@letta-ai/letta-agent-sdk 0.5.3 → 0.5.5

package/README.md

@@ -30,8 +30,16 @@ const client = new LettaAgentClient({
 
 const agentId = await client.createAgent({
   model: "anthropic/claude-opus-4-8",
-  persona: "You are a proactive research assistant.",
-  human: "The user prefers concise summaries with sources and next steps.",
+  memory: [
+    {
+      label: "persona",
+      value: "You are a proactive research assistant.",
+    },
+    {
+      label: "human",
+      value: "The user prefers concise summaries with sources and next steps.",
+    },
+  ],
 });
 
 await using session = client.createSession(agentId);
@@ -44,6 +52,10 @@ for await (const message of session.stream()) {
 }
 ```
 
+`createAgent()` uses the supplied memory as the agent's identity. Letta Code
+personality presets are opt-in: pass `personality: "memo"` (or another preset)
+only when you want that preset's name, description, and memory blocks.
+
 An agent is the persistent entity with memory. A conversation is a thread on that agent. A session is the active connection used to send messages, stream events, execute tools, and handle approvals.
 
 - `createSession(agentId)` starts a new conversation.

package/dist/agent-creation.d.ts

@@ -0,0 +1,9 @@
+import type { CreateAgentOptions } from "./types.js";
+/**
+ * Build the standard harness portion of a create-agent request.
+ *
+ * Personality presets are explicit opt-ins. Without one, the SDK builds a
+ * generic agent and lets the caller's memory blocks define its identity.
+ */
+export declare function buildInitialAgentBody(options: CreateAgentOptions): Promise<Record<string, unknown>>;
+//# sourceMappingURL=agent-creation.d.ts.map

package/dist/agent-creation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-creation.d.ts","sourceRoot":"","sources":["../src/agent-creation.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAmBrD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA+BlC"}

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

@@ -1 +1 @@
-{"version":3,"file":"app-server-session.d.ts","sourceRoot":"","sources":["../src/app-server-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gCAAgC,EAEtC,MAAM,wCAAwC,CAAC;AAqBhD,OAAO,EACL,uBAAuB,EAKvB,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAElB,8BAA8B,EAC9B,6BAA6B,EAC7B,WAAW,EACX,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAWpB,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAIF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,EAAE,GAAG,SAAS,CAStB;AAED,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,4BAA4B,CAAC,GAAG;IAC5E,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,CAAC,EAAE,CACR,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAChC,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,IAAI,IAAI,CAAA;KAAE,CAAC,CAAC;IAC7C,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAoDtD,wBAAsB,eAAe,CACnC,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,GAAE;IAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0FlC;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAYhH;AAED,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACvC,gCAAgC,CAgBlC;AAED,KAAK,wBAAwB,GAAG,6BAA6B,GAAG,kBAAkB,CAAC;AAEnF,KAAK,iCAAiC,GAClC;IACE,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,kCAAkC,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/C,GACD;IACE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAkD7B;AAYD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,kBAAkB,GAC3B,iCAAiC,CAkBnC;AAqCD,wBAAgB,sCAAsC,CAAC,MAAM,EAAE;IAC7D,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,MAAM,YAAY,GAAG,IAAI,CAAC;IACtC,UAAU,EAAE,MAAM,wBAAwB,CAAC;CAC5C,GAAG,MAAM,IAAI,CAQb;AAwCD,qBAAa,0BAA2B,YAAW,6BAA6B;IAE5E,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAFpB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,uBAAuB,EAChC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,YAAA;IAG1D,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAMpF,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5C,eAAe,CACb,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,sBAAsB,GAC9B,IAAI;IAwBD,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,OAAO,CAAC,SAAS,SAAS,eAAe,GAAG,eAAe,EACzD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAA;KAAO,GACtF,OAAO,CAAC,SAAS,CAAC;IAqBf,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IASvC,WAAW,CACf,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAYvB,uBAAuB,CAC3B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,6BAA6B,CAAC;IAqBnC,YAAY,CAChB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC;IAwC9B,KAAK,IAAI,IAAI;CAGd;AAED,qBAAa,gBAAiB,SAAQ,uBAAuB;IAOzD,OAAO,CAAC,QAAQ,CAAC,aAAa;IANhC,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,yBAAyB,CAA6B;IAC9D,OAAO,CAAC,2BAA2B,CAA6B;gBAG7C,aAAa,EAAE,uBAAuB,EACvD,IAAI,EAAE,oBAAoB;cAYT,iBAAiB,CAAC,OAAO,EAAE,6BAA6B,GAAG,kBAAkB,GAAG,OAAO;cAKjF,2BAA2B,IAAI,OAAO,CAAC,kBAAkB,CAAC;cA0DhE,WAAW,IAAI,IAAI;YASxB,mBAAmB;YAenB,YAAY;YAOZ,wBAAwB;YAiExB,0BAA0B;CAqBzC"}
+{"version":3,"file":"app-server-session.d.ts","sourceRoot":"","sources":["../src/app-server-session.ts"],"names":[],"mappings":"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"}

package/dist/client-entry.js

@@ -8271,6 +8271,7 @@ var models_default = {
   ]
 };
 var models = models_default.models;
+var MODEL_PRESETS = models;
 function resolveModel(modelIdentifier) {
   const byId = models.find((m) => m.id === modelIdentifier);
   if (byId)
@@ -8530,6 +8531,45 @@ async function buildCreateAgentRequestForPersonality(params) {
   };
 }
 
+// src/agent-creation.ts
+var DEFAULT_MODEL_ID = "auto";
+var DEFAULT_SUMMARIZATION_MODEL2 = "letta/auto";
+function resolveModel2(modelIdentifier) {
+  const preset = MODEL_PRESETS.find((model) => model.id === modelIdentifier || model.handle === modelIdentifier);
+  if (preset)
+    return preset.handle;
+  if (modelIdentifier.includes("/"))
+    return modelIdentifier;
+  throw new Error(`Unknown model: ${modelIdentifier}`);
+}
+async function buildInitialAgentBody(options) {
+  if (options.personality !== undefined) {
+    return {
+      ...await buildCreateAgentRequestForPersonality({
+        personalityId: options.personality,
+        ...options.name !== undefined ? { name: options.name } : {},
+        ...options.description !== undefined ? { description: options.description } : {},
+        ...options.model !== undefined ? { model: options.model } : {},
+        ...options.tags !== undefined ? { extraTags: options.tags } : {}
+      })
+    };
+  }
+  return {
+    agent_type: LETTA_CODE_AGENT_TYPE,
+    ...options.name !== undefined ? { name: options.name } : {},
+    ...options.description !== undefined ? { description: options.description } : {},
+    model: resolveModel2(options.model ?? DEFAULT_MODEL_ID),
+    system: buildSystemPrompt("default", "memfs"),
+    tags: buildCreatedAgentTags({
+      enableMemfs: true,
+      tags: options.tags ?? []
+    }),
+    initial_message_sequence: [],
+    parallel_tool_calls: true,
+    compaction_settings: { model: DEFAULT_SUMMARIZATION_MODEL2 }
+  };
+}
+
 // src/interactiveToolPolicy.ts
 var INTERACTIVE_APPROVAL_TOOLS = new Set([
   "AskUserQuestion",
@@ -8981,6 +9021,7 @@ function normalizeSendMessage(message) {
 class RemoteTurnCoordinator {
   label;
   requestTimeoutMs;
+  autoHandlesToolApprovals;
   onDeviceStatus;
   streamQueue = [];
   streamResolvers = [];
@@ -8994,6 +9035,7 @@ class RemoteTurnCoordinator {
   constructor(config) {
     this.label = config.label;
     this.requestTimeoutMs = config.requestTimeoutMs;
+    this.autoHandlesToolApprovals = config.autoHandlesToolApprovals === true;
     this.onDeviceStatus = config.onDeviceStatus;
   }
   get activeTurnStartedAt() {
@@ -9170,6 +9212,8 @@ class RemoteTurnCoordinator {
     if (!hadTurnEvidence)
       return;
     if (status === "WAITING_ON_APPROVAL") {
+      if (this.autoHandlesToolApprovals)
+        return;
       this.completeActiveTurn({
         runtime: active.runtime,
         stopReason: "requires_approval",
@@ -9407,6 +9451,7 @@ class RemoteClientSessionCore {
     this.turns = new RemoteTurnCoordinator({
       label: config.label,
       requestTimeoutMs: config.requestTimeoutMs,
+      autoHandlesToolApprovals: mode.kind === "session" && typeof mode.options.canUseTool === "function",
       onDeviceStatus: (status) => this.emitDeviceStatus(status)
     });
   }
@@ -9981,15 +10026,7 @@ function upsertMemoryBlock(blocks, block) {
 async function createAgentBody(options, settings = {}) {
   assertRemoteCreateAgentOptionsSupported(options);
   const includeOriginTag = settings.includeSdkOriginTag ?? true;
-  const body = {
-    ...await buildCreateAgentRequestForPersonality({
-      personalityId: options.personality ?? "memo",
-      ...options.name !== undefined ? { name: options.name } : {},
-      ...options.description !== undefined ? { description: options.description } : {},
-      ...options.model !== undefined ? { model: options.model } : {},
-      ...options.tags !== undefined ? { extraTags: options.tags } : {}
-    })
-  };
+  const body = await buildInitialAgentBody(options);
   if (Array.isArray(body.tags)) {
     body.tags = body.tags.filter((tag) => (includeOriginTag || tag !== LETTA_CODE_ORIGIN_TAG) && (options.memfs !== false || tag !== GIT_MEMORY_ENABLED_TAG));
   }
@@ -10020,6 +10057,7 @@ async function createAgentBody(options, settings = {}) {
       throw new Error("createAgent() does not yet support system prompt preset objects for this backend.");
     }
   }
+  const hasMemoryConfiguration = Array.isArray(body.memory_blocks) || options.memory !== undefined || options.persona !== undefined || options.human !== undefined;
   const memoryBlocks = Array.isArray(body.memory_blocks) ? body.memory_blocks.filter((block) => block !== null && typeof block === "object").map((block) => ({ ...block })) : [];
   const blockIds = [];
   for (const item of options.memory ?? []) {
@@ -10041,7 +10079,8 @@ async function createAgentBody(options, settings = {}) {
   if (options.human !== undefined) {
     upsertMemoryBlock(memoryBlocks, { label: "human", value: options.human });
   }
-  body.memory_blocks = memoryBlocks;
+  if (hasMemoryConfiguration)
+    body.memory_blocks = memoryBlocks;
   if (blockIds.length > 0)
     body.block_ids = blockIds;
   return body;
@@ -10178,37 +10217,72 @@ function runtimeScopeFromMessage(message) {
   }
   return null;
 }
-function registerAppServerControlRequestHandler(config) {
-  return config.client.onMessage((rawMessage, channel) => {
-    const message = rawMessage;
-    if (channel !== "control" || message.type !== "control_request")
-      return;
-    respondToAppServerControlRequest(config, message).catch(() => {});
-  });
-}
-async function respondToAppServerControlRequest(config, message) {
-  const runtime = runtimeScopeFromMessage(message) ?? config.getRuntime();
-  if (!runtime)
-    return;
-  const requestId = typeof message.request_id === "string" ? message.request_id : undefined;
+var MAX_CACHED_TOOL_APPROVALS = 256;
+function parseToolApprovalRequest(message, fallbackRuntime) {
+  const runtime = runtimeScopeFromMessage(message) ?? fallbackRuntime;
+  const requestId = typeof message.request_id === "string" ? message.request_id : null;
   const request = message.request;
-  if (!requestId || !request || typeof request !== "object")
-    return;
+  if (!runtime || !requestId || !request || typeof request !== "object")
+    return null;
   const requestRecord = request;
   if (requestRecord.subtype !== "can_use_tool")
-    return;
+    return null;
   const toolName = typeof requestRecord.tool_name === "string" ? requestRecord.tool_name : "unknown";
   const toolInput = requestRecord.input && typeof requestRecord.input === "object" && !Array.isArray(requestRecord.input) ? requestRecord.input : {};
-  const decision = await resolveAppServerToolApproval(config.getOptions(), toolName, toolInput, buildCanUseToolContext(requestRecord, requestId));
-  config.client.input({
+  return {
+    key: JSON.stringify([runtime.agent_id, runtime.conversation_id, requestId]),
     runtime,
+    requestId,
+    toolName,
+    toolInput,
+    context: buildCanUseToolContext(requestRecord, requestId)
+  };
+}
+function sendToolApprovalResponse(client, request, decision) {
+  client.input({
+    runtime: request.runtime,
     payload: {
       kind: "approval_response",
-      request_id: requestId,
+      request_id: request.requestId,
       decision: toAppServerApprovalDecision(decision)
     }
   });
 }
+function registerAppServerControlRequestHandler(config) {
+  const approvals = new Map;
+  return config.client.onMessage((rawMessage, channel) => {
+    const message = rawMessage;
+    if (channel !== "control" || message.type !== "control_request")
+      return;
+    const request = parseToolApprovalRequest(message, config.getRuntime());
+    if (!request)
+      return;
+    const cached = approvals.get(request.key);
+    if (cached) {
+      if (cached.sent) {
+        cached.decision.then((decision) => sendToolApprovalResponse(config.client, cached.request, decision)).catch(() => {
+          return;
+        });
+      }
+      return;
+    }
+    if (approvals.size >= MAX_CACHED_TOOL_APPROVALS) {
+      const oldest = approvals.keys().next().value;
+      if (oldest !== undefined)
+        approvals.delete(oldest);
+    }
+    const entry = {
+      decision: resolveAppServerToolApproval(config.getOptions(), request.toolName, request.toolInput, request.context),
+      sent: false,
+      request
+    };
+    approvals.set(request.key, entry);
+    entry.decision.then((decision) => {
+      entry.sent = true;
+      sendToolApprovalResponse(config.client, request, decision);
+    }).catch(() => approvals.delete(request.key));
+  });
+}
 
 class AppServerRuntimeController {
   client;
@@ -12135,4 +12209,4 @@ export {
   CloudManagedSandboxExpiredError
 };
 
-//# debugId=BAE3E396031D003F64756E2164756E21
+//# debugId=8B8DDE1B1EDE2B4764756E2164756E21