@letta-ai/letta-code 0.32.8 → 0.32.9

package/letta.js

@@ -3933,6 +3933,18 @@ var init_paths = __esm(() => {
   init_local_backend_paths();
 });
 
+// src/agent/acting-user.ts
+function resolveActingUserId(explicitActingUserId, runtimeActingUserId, env = process.env) {
+  return explicitActingUserId ?? runtimeActingUserId ?? env[ACTING_USER_ID_ENV];
+}
+function actingUserRequestOptions(actingUserId) {
+  if (!actingUserId) {
+    return;
+  }
+  return { headers: { [ACTING_USER_ID_HEADER]: actingUserId } };
+}
+var ACTING_USER_ID_HEADER = "X-Letta-Acting-User-Id", ACTING_USER_ID_ENV = "LETTA_ACTING_USER_ID";
+
 // src/helpers/usable-directory.ts
 import { statSync } from "node:fs";
 function readDirectoryStats(dirPath) {
@@ -3968,6 +3980,9 @@ import { homedir as homedir2, tmpdir } from "node:os";
 function getRuntimeContext() {
   return runtimeContextStorage.getStore();
 }
+function getRuntimeActingUserId() {
+  return resolveActingUserId(undefined, getRuntimeContext()?.actingUserId);
+}
 function runWithRuntimeContext(snapshot, fn) {
   const parent = runtimeContextStorage.getStore();
   return runtimeContextStorage.run({
@@ -5515,7 +5530,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@letta-ai/letta-code",
-    version: "0.32.8",
+    version: "0.32.9",
     lettaStartupLogProtocol: 1,
     description: "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
     type: "module",
@@ -5945,7 +5960,8 @@ async function submitTelemetryMetadata(apiKey, deviceId, payload, options) {
   await apiRequest("POST", "/v1/metadata/telemetry", payload, {
     ...config,
     headers: {
-      "X-Letta-Code-Device-ID": deviceId
+      "X-Letta-Code-Device-ID": deviceId,
+      ...actingUserRequestOptions(options?.actingUserId)?.headers
     },
     signal: options?.signal
   });
@@ -6167,6 +6183,7 @@ function isNonActionableError(message) {
 
 class TelemetryManager {
   events = [];
+  eventActingUsers = new WeakMap;
   sessionId;
   deviceId = null;
   currentAgentId = null;
@@ -6291,6 +6308,7 @@ class TelemetryManager {
         backend: resolveTelemetryBackend()
       }
     };
+    this.eventActingUsers.set(event, getRuntimeActingUserId());
     this.events.push(event);
     if (this.events.length >= this.MAX_BATCH_SIZE) {
       this.flush().catch((err) => {
@@ -6509,15 +6527,27 @@ class TelemetryManager {
     this.events = [];
     const apiKey = await this.resolveTelemetryApiKey();
     const deviceId = this.getTelemetryDeviceId();
-    try {
-      await submitTelemetryMetadata(apiKey, deviceId, {
-        service: "letta-code",
-        server_version: this.serverVersion || undefined,
-        events: eventsToSend
-      }, { signal: AbortSignal.timeout(5000) });
-    } catch (_error) {
-      this.events.unshift(...eventsToSend);
-    }
+    const groups = new Map;
+    for (const event of eventsToSend) {
+      const actingUserId = this.eventActingUsers.get(event);
+      const group = groups.get(actingUserId) ?? [];
+      group.push(event);
+      groups.set(actingUserId, group);
+    }
+    const failed = new Set;
+    await Promise.all([...groups].map(async ([actingUserId, events]) => {
+      try {
+        await submitTelemetryMetadata(apiKey, deviceId, {
+          service: "letta-code",
+          server_version: this.serverVersion || undefined,
+          events
+        }, { signal: AbortSignal.timeout(5000), actingUserId });
+      } catch {
+        for (const event of events)
+          failed.add(event);
+      }
+    }));
+    this.events.unshift(...eventsToSend.filter((event) => failed.has(event)));
   }
   async drain() {
     if (!this.isTelemetryEnabled()) {
@@ -6554,6 +6584,7 @@ var init_telemetry = __esm(() => {
   init_metadata();
   init_server_url();
   init_paths();
+  init_runtime_context();
   init_settings_manager();
   init_debug();
   init_version();
@@ -101243,7 +101274,6 @@ function createConversationRuntime(listener, agentId, conversationId) {
     acceptedInputDispositions: new Map,
     pendingApprovalResolvers: new Map,
     recoveredApprovalState: null,
-    syncApprovalRecoveryCompleted: false,
     expectedTeleportId: null,
     expectedTeleportExpiresAt: null,
     get lastStopReason() {
@@ -122326,18 +122356,6 @@ var init_search_file_content_gemini = __esm(() => {
   init_grep();
 });
 
-// src/agent/acting-user.ts
-function resolveActingUserId(explicitActingUserId, runtimeActingUserId, env3 = process.env) {
-  return explicitActingUserId ?? runtimeActingUserId ?? env3[ACTING_USER_ID_ENV];
-}
-function actingUserRequestOptions(actingUserId) {
-  if (!actingUserId) {
-    return;
-  }
-  return { headers: { [ACTING_USER_ID_HEADER]: actingUserId } };
-}
-var ACTING_USER_ID_HEADER = "X-Letta-Acting-User-Id", ACTING_USER_ID_ENV = "LETTA_ACTING_USER_ID";
-
 // src/backend/api/agent-message.ts
 function normalizeAgentMessageComputer(value) {
   if (value == null)
@@ -123673,106 +123691,114 @@ var init_names = __esm(() => {
   init_constants2();
   SUBAGENT_NAMES = [
     "Deckard",
-    "Rachael",
-    "Roy",
+    "Roy Batty",
     "Pris",
     "Zhora",
-    "Leon",
     "Gaff",
     "Tyrell",
-    "Sebastian",
-    "Bryant",
-    "Chew",
-    "Holden",
-    "Taffey",
     "K",
     "Joi",
     "Luv",
-    "Wallace",
-    "Joshi",
     "Sapper",
-    "Mariette",
     "Freysa",
-    "Ana",
-    "Coco",
-    "Samantha",
-    "Theodore",
-    "Amy",
-    "Catherine",
-    "Paul",
-    "Isabella",
     "Ava",
-    "Caleb",
-    "Nathan",
     "Kyoko",
     "V",
-    "Johnny",
-    "Jackie",
-    "Judy",
+    "Silverhand",
     "Panam",
-    "River",
-    "Kerry",
     "Rogue",
-    "Alt",
-    "Evelyn",
+    "Alt Cunningham",
     "Takemura",
     "Hanako",
     "Yorinobu",
     "Saburo",
     "Oda",
-    "Viktor",
-    "Misty",
-    "Dex",
     "T-Bug",
     "Delamain",
     "Wakako",
     "Padre",
-    "Regina",
-    "Dakota",
-    "Dino",
     "El Capitan",
     "Mr. Hands",
     "Placide",
-    "Brigitte",
-    "Royce",
     "Dum Dum",
-    "Brick",
-    "Meredith",
-    "Sandra",
-    "Maiko",
-    "Claire",
     "Nix",
     "Weyland",
-    "Saul",
-    "Mitch",
     "Scorpion",
-    "Cassidy",
-    "Carol",
-    "Denny",
-    "Nancy",
-    "Henry",
     "Blue Moon",
     "Red Menace",
     "Purple Force",
-    "Lizzy",
+    "Lizzy Wizzy",
     "Ozob",
     "Smasher",
-    "Reed",
     "Songbird",
-    "Alex",
-    "Myers",
-    "Hansen",
-    "Paco",
-    "Babs",
     "Slider",
-    "Aurore",
-    "Aymeric",
     "Aguilar",
-    "Bree",
-    "Dante",
-    "Lina",
-    "Garry",
-    "Pepe"
+    "Dogmeat",
+    "Codsworth",
+    "Nick Valentine",
+    "Yes Man",
+    "Mr. House",
+    "ED-E",
+    "Fisto",
+    "Liberty Prime",
+    "Three Dog",
+    "Charon",
+    "Fawkes",
+    "Ulysses",
+    "The Master",
+    "Muggy",
+    "Dr. Mobius",
+    "Dr. Klein",
+    "Old Longfellow",
+    "Pickman",
+    "Butch DeLoria",
+    "Fantastic",
+    "Muad'Dib",
+    "Stilgar",
+    "Chani",
+    "Gurney Halleck",
+    "Duncan Idaho",
+    "Thufir Hawat",
+    "Liet-Kynes",
+    "Shadout Mapes",
+    "Feyd-Rautha",
+    "Rabban",
+    "Piter De Vries",
+    "Irulan",
+    "Scytale",
+    "Hayt",
+    "Bijaz",
+    "Moneo",
+    "Miles Teg",
+    "Darwi Odrade",
+    "Sheeana",
+    "Shaddam IV",
+    "Count Fenring",
+    "Wintermute",
+    "Neuromancer",
+    "Dixie Flatline",
+    "Molly Millions",
+    "Lady 3Jane",
+    "Armitage",
+    "Maelcum",
+    "Ratz",
+    "The Finn",
+    "Hiro Protagonist",
+    "Y.T.",
+    "Raven",
+    "Uncle Enzo",
+    "R. Daneel Olivaw",
+    "R. Giskard Reventlov",
+    "Hari Seldon",
+    "Dors Venabili",
+    "The Mule",
+    "HAL 9000",
+    "Aineko",
+    "Eschaton",
+    "Mycroft Canner",
+    "J.E.D.D. Mason",
+    "Sniper",
+    "Eureka Weeksbooth"
   ];
   nextName = createSubagentNameAllocator();
 });
@@ -125204,7 +125230,10 @@ async function task(args) {
   const agentId = linkedAgent?.agentId ?? null;
   const agentIdLine = agentId ? `
 Agent ID: ${agentId}` : "";
-  return `Task running in background with task ID: ${taskId}${agentIdLine}
+  const conversationId = linkedAgent?.conversationId ?? null;
+  const conversationIdLine = conversationId ? `
+Conversation ID: ${conversationId}` : "";
+  return `Task running in background with task ID: ${taskId}${agentIdLine}${conversationIdLine}
 Output file: ${outputFile}
 
 You will be notified automatically when this task completes — a <task-notification> message will be delivered with the result. No need to poll, sleep-wait, or check the output file. Just continue with your current work.`;
@@ -134381,7 +134410,7 @@ async function executeToolInner(name, args, options) {
         return createModPermissionToolResult(permissionDecision2);
       }
     }
-    return executeExternalTool(options?.toolCallId ?? `ext-${Date.now()}`, name, eventArgs2, externalTool?.executor ?? activeExternalExecutor, externalTool);
+    return runWithRuntimeContext(executionScope, () => executeExternalTool(options?.toolCallId ?? `ext-${Date.now()}`, name, eventArgs2, externalTool?.executor ?? activeExternalExecutor, externalTool));
   }
   const internalName = resolveInternalToolName(name, activeRegistry);
   const tool = internalName ? activeRegistry.get(internalName) : undefined;
@@ -223091,8 +223120,8 @@ function isSyncCommand(value) {
   if (!value || typeof value !== "object") {
     return false;
   }
-  const candidate = value;
-  return candidate.type === "sync" && isRuntimeScope(candidate.runtime) && (candidate.request_id === undefined || typeof candidate.request_id === "string") && (candidate.recover_approvals === undefined || typeof candidate.recover_approvals === "boolean") && (candidate.force_device_status === undefined || typeof candidate.force_device_status === "boolean");
+  const c = value;
+  return c.type === "sync" && isRuntimeScope(c.runtime) && (c.request_id === undefined || typeof c.request_id === "string") && (c.recover_approvals === undefined || typeof c.recover_approvals === "boolean") && (c.resume_interrupted_turn === undefined || typeof c.resume_interrupted_turn === "boolean") && (c.force_device_status === undefined || typeof c.force_device_status === "boolean");
 }
 function isTerminalSpawnCommand(value) {
   if (!value || typeof value !== "object")
@@ -402519,7 +402548,6 @@ async function startRecoveredApprovalContinuation(runtime, socket, processTurn,
   if (!await canRecoverConversation(runtime)) {
     if (runtime.recoveredApprovalState === recovered) {
       clearRecoveredApprovalState(runtime);
-      runtime.syncApprovalRecoveryCompleted = false;
     }
     return false;
   }
@@ -407312,12 +407340,12 @@ function rowToolCalls(row, index, diagnostics2) {
   }
   return calls;
 }
-function contentText2(content) {
+function contentText(content) {
   if (typeof content === "string") {
     if (content.startsWith(CONTENT_JSON_PREFIX)) {
       const encoded = content.slice(CONTENT_JSON_PREFIX.length);
       try {
-        return contentText2(JSON.parse(encoded));
+        return contentText(JSON.parse(encoded));
       } catch {
         return encoded;
       }
@@ -407403,7 +407431,7 @@ var init_hermes = __esm(() => {
           });
         };
         if (row.role === "user") {
-          const content = contentText2(row.content);
+          const content = contentText(row.content);
           if (content) {
             emit({
               type: "message",
@@ -407423,7 +407451,7 @@ var init_hermes = __esm(() => {
               ...timestamp ? { timestamp } : {}
             });
           }
-          const content = contentText2(row.content);
+          const content = contentText(row.content);
           if (content) {
             emit({
               type: "message",
@@ -407446,7 +407474,7 @@ var init_hermes = __esm(() => {
         if (row.role === "tool") {
           emit({
             type: "tool_result",
-            content: contentText2(row.content),
+            content: contentText(row.content),
             ...typeof row.tool_call_id === "string" && row.tool_call_id ? { callId: row.tool_call_id } : {},
             ...timestamp ? { timestamp } : {}
           });
@@ -413453,16 +413481,18 @@ function extractTelemetryInputText(content) {
 }
 
 // src/websocket/listener/turn-transcript.ts
-function trackListenerUserInput(messages, modelId) {
-  for (const message of messages) {
-    if (!("role" in message) || message.role !== "user") {
-      continue;
-    }
-    const inputText = extractTelemetryInputText(message.content);
-    if (inputText.length > 0) {
-      telemetry.trackUserInput(inputText, "user", modelId);
+function trackListenerUserInput(messages, modelId, actingUserId) {
+  runWithRuntimeContext({ actingUserId }, () => {
+    for (const message of messages) {
+      if (!("role" in message) || message.role !== "user") {
+        continue;
+      }
+      const inputText = extractTelemetryInputText(message.content);
+      if (inputText.length > 0) {
+        telemetry.trackUserInput(inputText, "user", modelId);
+      }
     }
-  }
+  });
 }
 function buildInboundUserTranscriptLines(messages) {
   const lines = [];
@@ -413497,6 +413527,7 @@ function seedInboundUserTranscriptLines(buffers, lines) {
   }
 }
 var init_turn_transcript = __esm(() => {
+  init_runtime_context();
   init_telemetry();
 });
 
@@ -413609,7 +413640,7 @@ async function prepareListenerTurn(params) {
   if (connectionId) {
     onStatusChange?.("processing", connectionId);
   }
-  trackListenerUserInput(msg.messages, "unknown");
+  trackListenerUserInput(msg.messages, "unknown", msg.actingUserId);
   const messagesToSend = [];
   let queuedInterruptedToolCallIds = [];
   const wasInterrupted = hasInterruptedCacheForScope(runtime.listener, {
@@ -418403,6 +418434,7 @@ function summarizeV2Command(parsed) {
       "replace_all",
       "expected_replacements",
       "recover_approvals",
+      "resume_interrupted_turn",
       "force_device_status"
     ]) {
       pushField(fields, key2, parsed[key2]);
@@ -418869,6 +418901,7 @@ function createListenerMessageHandler(params) {
         try {
           await replaySyncStateForRuntime(runtime, socket, parsed.runtime, {
             recoverApprovals: parsed.recover_approvals !== false,
+            resumeInterruptedTurn: parsed.resume_interrupted_turn === true,
             forceDeviceStatus: parsed.force_device_status === true,
             onStatusChange: opts.onStatusChange,
             connectionId: opts.connectionId
@@ -419448,7 +419481,7 @@ var init_process_services = __esm(async () => {
 function isBackendNotFoundError2(error4) {
   return error4 instanceof APIError && (error4.status === 404 || error4.status === 422) || error4 instanceof Error && error4.name === "LocalBackendNotFoundError";
 }
-async function recoverApprovalStateForSync(runtime, scope, deps = {}) {
+async function recoverApprovalStateForSync(runtime, scope, deps = {}, opts = {}) {
   const resolvedDeps = {
     getBackend,
     getResumeDataFromBackend,
@@ -419518,6 +419551,17 @@ async function recoverApprovalStateForSync(runtime, scope, deps = {}) {
     approval,
     reason: STALE_APPROVAL_RECOVERY_DENIAL_REASON
   }));
+  if (interactivePending.length === 0 && !opts.resumeInterruptedTurn) {
+    runtime.pendingInterruptedResults = buildFreshDenialApprovals(pendingApprovals, STALE_APPROVAL_RECOVERY_DENIAL_REASON);
+    runtime.pendingInterruptedContext = {
+      agentId: scope.agent_id,
+      conversationId: scope.conversation_id,
+      continuationEpoch: runtime.continuationEpoch
+    };
+    runtime.pendingInterruptedToolCallIds = null;
+    clearRecoveredApprovalState(runtime);
+    return;
+  }
   const approvalsByRequestId = new Map;
   for (const approval of interactivePending) {
     const requestId = `perm-${approval.toolCallId}`;
@@ -419569,10 +419613,11 @@ var init_recovery_sync = __esm(() => {
 async function replaySyncStateForRuntime(listenerRuntime, socket, scope, opts) {
   const syncScopedRuntime = getOrCreateScopedRuntime(listenerRuntime, scope.agent_id, scope.conversation_id);
   const recoverFn = opts?.recoverApprovalStateForSync ?? recoverApprovalStateForSync;
-  if ((opts?.recoverApprovals ?? true) || !syncScopedRuntime.syncApprovalRecoveryCompleted) {
+  if (opts?.recoverApprovals ?? true) {
     try {
-      const recovered = await recoverFn(syncScopedRuntime, scope);
-      syncScopedRuntime.syncApprovalRecoveryCompleted = recovered !== "deferred";
+      await recoverFn(syncScopedRuntime, scope, undefined, {
+        resumeInterruptedTurn: opts?.resumeInterruptedTurn === true
+      });
     } catch (error4) {
       trackBoundaryError({
         errorType: "listener_sync_recovery_failed",
@@ -440944,7 +440989,7 @@ var init_mcp_client = __esm(() => {
   init_streamableHttp();
   DEFAULT_CLIENT_INFO = {
     name: "letta-code",
-    version: "0.32.8"
+    version: "0.32.9"
   };
 });
 
@@ -519787,7 +519832,9 @@ Error: ${message}`);
           return null;
         });
         if (!shouldBlockOnMemfsStartup) {}
-        const secretsInitPromise = Promise.resolve().then(() => (init_secrets_store(), exports_secrets_store)).then(({ initSecretsFromServer: initSecretsFromServer2 }) => initSecretsFromServer2(agentId2));
+        const secretsInitPromise = Promise.resolve().then(() => (init_secrets_store(), exports_secrets_store)).then(({ initSecretsFromServer: initSecretsFromServer2 }) => initSecretsFromServer2(agentId2)).catch((error5) => {
+          debugLog("secrets", `Failed to init secrets: ${error5 instanceof Error ? error5.message : String(error5)}`);
+        });
         const isResumingProject = !shouldCreateNew && !!resumingAgentId;
         const isReusingExistingAgent = !shouldCreateNew && agent && agent.id;
         const resuming = !!(agentIdArg || isResumingProject || isReusingExistingAgent);
@@ -519898,11 +519945,7 @@ Error: ${message}`);
         }
         const fdPath = await ensureFdPath();
         setFileAutocompleteFdPath(fdPath);
-        try {
-          await secretsInitPromise;
-        } catch (error5) {
-          Promise.resolve().then(() => (init_debug(), exports_debug)).then(({ debugLog: debugLog3 }) => debugLog3("secrets", `Failed to init secrets: ${error5 instanceof Error ? error5.message : String(error5)}`));
-        }
+        await secretsInitPromise;
         if (shouldPersistSessionState()) {
           settingsManager.persistSession(agent.id, conversationIdToUse);
         }
@@ -522317,4 +522360,4 @@ function registerBunOAuthFlows() {
 registerBunOAuthFlows();
 await init_src5().then(() => exports_src2);
 
-//# debugId=A89D538A98A9FFDD64756E2164756E21
+//# debugId=73D666396EC039C064756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.32.8",
+  "version": "0.32.9",
   "lettaStartupLogProtocol": 1,
   "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
   "type": "module",

package/scripts/source-file-size-baseline.json

@@ -23,7 +23,7 @@
   "src/cli/subcommands/skills.ts": 1264,
   "src/headless.ts": 4864,
   "src/hooks/integration.test.ts": 1147,
-  "src/index.ts": 2616,
+  "src/index.ts": 2612,
   "src/mods/learning-harness.ts": 2434,
   "src/mods/mod-engine.test.ts": 2153,
   "src/mods/mod-engine.ts": 1838,
@@ -37,11 +37,11 @@
   "src/settings-manager.ts": 2102,
   "src/tools/manager.ts": 2897,
   "src/tools/tool-execution-context.test.ts": 1136,
-  "src/types/protocol_v2.ts": 2595,
-  "src/websocket/listen-client-concurrency.test.ts": 2677,
+  "src/types/protocol_v2.ts": 2593,
+  "src/websocket/listen-client-concurrency.test.ts": 2666,
   "src/websocket/listen-client-protocol.test.ts": 5762,
   "src/websocket/listener/commands/memory.ts": 1114,
   "src/websocket/listener/file-commands.ts": 1053,
-  "src/websocket/listener/protocol-inbound.ts": 2143,
+  "src/websocket/listener/protocol-inbound.ts": 2137,
   "src/websocket/listener/protocol-outbound.ts": 1022
 }

package/scripts/test-home-preload.ts

@@ -1,4 +1,4 @@
-import { afterAll } from "bun:test";
+import { afterAll, afterEach } from "bun:test";
 import { mkdtempSync, rmSync } from "node:fs";
 import { createRequire } from "node:module";
 import { basename, isAbsolute, join, relative, resolve } from "node:path";
@@ -57,6 +57,14 @@ process.env.LETTA_CODE_TELEM ??= "0";
 // the redirected environment before their runtimes initialize.
 os.homedir = () => testHome;
 
+// Load after redirecting home: channel config captures its filesystem root.
+const routes = await import("@/channels/routing");
+afterEach(() => {
+  routes.clearAllRoutes();
+  routes.__testOverrideLoadRoutes(null);
+  routes.__testOverrideSaveRoutes(null);
+});
+
 if (!configuredTestHome) {
   const cleanup = () => {
     rmSync(testHome, { recursive: true, force: true });

package/skills/letta-guide/SKILL.md

@@ -1,10 +1,12 @@
 ---
 name: letta-guide
-description: Read the official Letta documentation (docs.letta.com) through its cached, ETag-checked fetch route. Load before ANY docs.letta.com retrieval — answering how Letta works, what Letta (or you) can do, setting up providers, models, channels, skills, memory, schedules, permissions, self-hosting, pricing, or billing, AND looking up Letta API, Agent SDK, or Letta Code reference while writing code. Do not use fetch_webpage or web_search on docs.letta.com; this skill's helper is the docs route. Never answer Letta product questions from memory alone.
+description: Read the official Letta documentation (docs.letta.com) through its cached, ETag-checked fetch route. Load before ANY docs.letta.com retrieval — answering how Letta works, what Letta (or you) can do, and looking up Letta API, Agent SDK, or Letta Code reference.
 ---
 
 # Letta Guide
 
+Do not use fetch_webpage or web_search on docs.letta.com; this skill's helper is the docs route.
+
 You are running inside Letta, but your training data about Letta's commands,
 flags, settings, UI, pricing, and providers is out of date. Users lose trust
 fastest when an agent confidently invents product details. This skill defines