@letta-ai/letta-code 0.24.8 → 0.24.9

package/letta.js

@@ -3269,7 +3269,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@letta-ai/letta-code",
-    version: "0.24.8",
+    version: "0.24.9",
     description: "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
     type: "module",
     bin: {
@@ -9488,46 +9488,6 @@ var init_models2 = __esm(() => {
           parallel_tool_calls: true
         }
       },
-      {
-        id: "gpt-5.5-pro-medium",
-        handle: "openai/gpt-5.5-pro",
-        label: "GPT-5.5 Pro",
-        description: "GPT-5.5 Pro — max performance variant (med reasoning)",
-        updateArgs: {
-          reasoning_effort: "medium",
-          verbosity: "medium",
-          context_window: 272000,
-          max_output_tokens: 128000,
-          parallel_tool_calls: true
-        }
-      },
-      {
-        id: "gpt-5.5-pro-high",
-        handle: "openai/gpt-5.5-pro",
-        label: "GPT-5.5 Pro",
-        description: "GPT-5.5 Pro — max performance variant (high reasoning)",
-        updateArgs: {
-          reasoning_effort: "high",
-          verbosity: "medium",
-          context_window: 272000,
-          max_output_tokens: 128000,
-          parallel_tool_calls: true
-        },
-        isFeatured: true
-      },
-      {
-        id: "gpt-5.5-pro-xhigh",
-        handle: "openai/gpt-5.5-pro",
-        label: "GPT-5.5 Pro",
-        description: "GPT-5.5 Pro — max performance variant (max reasoning)",
-        updateArgs: {
-          reasoning_effort: "xhigh",
-          verbosity: "medium",
-          context_window: 272000,
-          max_output_tokens: 128000,
-          parallel_tool_calls: true
-        }
-      },
       {
         id: "gpt-5.4-pro-medium",
         handle: "openai/gpt-5.4-pro",
@@ -40145,12 +40105,14 @@ var init_config = __esm(() => {
   };
   discordConfigCodec = {
     parse(parsed) {
+      const rawAllowedChannels = parsed.allowed_channels;
       return {
         channel: "discord",
         enabled: parsed.enabled !== false,
         token: String(parsed.token ?? ""),
         dmPolicy: parsed.dm_policy ?? "pairing",
-        allowedUsers: parsed.allowed_users ?? []
+        allowedUsers: parsed.allowed_users ?? [],
+        allowedChannels: Array.isArray(rawAllowedChannels) ? rawAllowedChannels : undefined
       };
     }
   };
@@ -40183,6 +40145,11 @@ function cloneAccount(account) {
   if (account.channel === "telegram") {
     cloned.binding = { ...account.binding };
   }
+  if (account.channel === "discord" && account.allowedChannels) {
+    cloned.allowedChannels = [
+      ...account.allowedChannels
+    ];
+  }
   return cloned;
 }
 function normalizeLoadedAccount(account) {
@@ -40226,6 +40193,7 @@ function makeDefaultLegacyAccount(channelId) {
       token: config.token,
       dmPolicy: config.dmPolicy,
       allowedUsers: [...config.allowedUsers],
+      allowedChannels: config.allowedChannels ? [...config.allowedChannels] : undefined,
       agentId: null,
       createdAt: now,
       updatedAt: now
@@ -44112,6 +44080,16 @@ var init_plugin2 = __esm(() => {
   };
 });
 
+// src/channels/discord/channelGating.ts
+function isDiscordGuildChannelAllowed(params) {
+  const { channelId, parentChannelId, isThread, allowedChannels } = params;
+  if (!allowedChannels || allowedChannels.length === 0) {
+    return true;
+  }
+  const gateChannelId = isThread ? parentChannelId ?? channelId : channelId;
+  return allowedChannels.includes(gateChannelId);
+}
+
 // src/channels/discord/media.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
 import { mkdirSync as mkdirSync11 } from "node:fs";
@@ -44594,6 +44572,13 @@ function createDiscordAdapter(config) {
         }
         if (!isThread && !wasMentioned)
           return;
+        if (!isDiscordGuildChannelAllowed({
+          channelId: message.channelId,
+          parentChannelId: message.channel.parentId ?? null,
+          isThread,
+          allowedChannels: config.allowedChannels
+        }))
+          return;
         if (markIngressMessageSeen(message.channelId, message.id))
           return;
         let effectiveChatId = message.channelId;
@@ -44657,6 +44642,13 @@ function createDiscordAdapter(config) {
         const isThread = msg.channel && "isThread" in msg.channel && typeof msg.channel.isThread === "function" && msg.channel.isThread();
         if (chatType === "channel" && !isThread)
           return;
+        if (chatType === "channel" && isThread && !isDiscordGuildChannelAllowed({
+          channelId,
+          parentChannelId: msg.channel.parentId ?? null,
+          isThread: true,
+          allowedChannels: config.allowedChannels
+        }))
+          return;
         const inbound = {
           channel: "discord",
           accountId: config.accountId,
@@ -44973,12 +44965,12 @@ Bind to agent ${envAgentId}? [Y/n]: `);
     }
     if (!agentId) {
       const agentInput = await rl.question(`
-Agent ID to bind this bot to (required for @mention routing): `);
+Agent ID to bind this bot to (required for DM and @mention routing): `);
       agentId = agentInput.trim() || null;
     }
     if (!agentId) {
       console.log(`
-Warning: No agent bound. DM pairing will still work, but guild @mentions won't route until you bind an agent.`);
+Warning: No agent bound. DM pairing will still work, but open/allowlist DMs and guild @mentions won't route until you bind an agent.`);
       console.log("  You can bind later: letta channels bind --channel discord --agent <id>");
       console.log(`  Or set agentId in ~/.letta/channels/discord/accounts.json
 `);
@@ -45829,6 +45821,17 @@ function buildSlackConversationSummary(msg) {
   }
   return `[Slack] Thread${channelLabel || ` ${msg.chatId}`}`;
 }
+function buildDiscordConversationSummary(msg) {
+  if (msg.chatType === "direct") {
+    return `[Discord] DM with ${msg.senderName?.trim() || msg.senderId}`;
+  }
+  const preview = truncateChannelSummaryPreview(msg.text);
+  const channelLabel = msg.chatLabel && msg.chatLabel !== msg.chatId ? ` in ${msg.chatLabel}` : "";
+  if (preview) {
+    return `[Discord] Thread${channelLabel}: ${preview}`;
+  }
+  return `[Discord] Thread${channelLabel || ` ${msg.chatId}`}`;
+}
 function buildChannelTurnSource(route, msg) {
   return {
     channel: msg.channel,
@@ -46212,7 +46215,7 @@ class ChannelRegistry {
       });
       return;
     }
-    if (msg.channel === "discord" && config.channel === "discord" && msg.chatType === "channel") {
+    if (msg.channel === "discord" && config.channel === "discord" && (msg.chatType === "channel" || config.dmPolicy !== "pairing")) {
       const discordResult = await this.ensureDiscordRoute(adapter, msg, config);
       if (!discordResult) {
         return;
@@ -46361,7 +46364,7 @@ class ChannelRegistry {
     if (!config.agentId) {
       throw new Error("Discord bot is missing an agent binding.");
     }
-    const conversationId = await this.createConversationForAgent(config.agentId, `[Discord] Thread ${msg.chatLabel ?? msg.chatId}`);
+    const conversationId = await this.createConversationForAgent(config.agentId, buildDiscordConversationSummary(msg));
     const now = new Date().toISOString();
     const route = {
       accountId: config.accountId,
@@ -46384,6 +46387,10 @@ class ChannelRegistry {
 ` + "Open Channels > Discord in Letta Code, choose which agent this bot should represent, and try again.");
       return null;
     }
+    if (msg.chatType === "direct" && config.dmPolicy === "allowlist" && !config.allowedUsers.includes(msg.senderId)) {
+      await adapter.sendDirectReply(msg.chatId, "You are not on the allowed users list for this Discord bot.");
+      return null;
+    }
     const accountId = msg.accountId ?? LEGACY_CHANNEL_ACCOUNT_ID;
     const routeThreadId = msg.threadId ?? null;
     let route = getRoute(msg.channel, msg.chatId, accountId, routeThreadId);
@@ -46394,7 +46401,7 @@ class ChannelRegistry {
     if (route) {
       return { route, isFirstRouteTurn: false };
     }
-    if (!msg.isMention) {
+    if (msg.chatType === "channel" && !msg.isMention) {
       return null;
     }
     return {
@@ -79479,6 +79486,7 @@ function toAccountSnapshot(account) {
       running,
       dmPolicy: account.dmPolicy,
       allowedUsers: [...account.allowedUsers],
+      allowedChannels: [...account.allowedChannels ?? []],
       hasToken: account.token.trim().length > 0,
       agentId: account.agentId,
       createdAt: account.createdAt,
@@ -79533,6 +79541,7 @@ function createAccountFromPatch(channelId, accountId, patch) {
       agentId: patch.agentId ?? null,
       dmPolicy: patch.dmPolicy ?? "pairing",
       allowedUsers: patch.allowedUsers ?? [],
+      allowedChannels: patch.allowedChannels ?? [],
       createdAt: now,
       updatedAt: now
     };
@@ -79576,6 +79585,7 @@ function mergeAccountPatch(existing, patch) {
       agentId: patch.agentId ?? existing.agentId,
       dmPolicy: patch.dmPolicy ?? existing.dmPolicy,
       allowedUsers: patch.allowedUsers ?? existing.allowedUsers,
+      allowedChannels: patch.allowedChannels ?? existing.allowedChannels,
       updatedAt: nextUpdatedAt
     };
   }
@@ -79654,6 +79664,7 @@ function getChannelConfigSnapshot(channelId, accountId) {
       enabled: account.enabled,
       dmPolicy: account.dmPolicy,
       allowedUsers: [...account.allowedUsers],
+      allowedChannels: [...account.allowedChannels ?? []],
       hasToken: account.token.trim().length > 0
     };
   }
@@ -79683,6 +79694,7 @@ async function setChannelConfigLive(channelId, patch, accountId) {
       mode: patch.mode,
       dmPolicy: patch.dmPolicy,
       allowedUsers: patch.allowedUsers,
+      allowedChannels: patch.allowedChannels,
       displayName: existing.displayName
     });
     shouldRefreshDisplayName = channelId === "telegram" || channelId === "discord" ? patch.token !== undefined : patch.botToken !== undefined || patch.appToken !== undefined;
@@ -79694,7 +79706,8 @@ async function setChannelConfigLive(channelId, patch, accountId) {
       appToken: patch.appToken,
       mode: patch.mode,
       dmPolicy: patch.dmPolicy,
-      allowedUsers: patch.allowedUsers
+      allowedUsers: patch.allowedUsers,
+      allowedChannels: patch.allowedChannels
     }, accountId ? { accountId } : undefined);
     targetAccountId = created.accountId;
     shouldRefreshDisplayName = true;
@@ -89192,8 +89205,29 @@ var init_cwd = __esm(() => {
   init_remote_settings();
 });
 
-// src/websocket/listener/approval.ts
+// src/websocket/listener/transport.ts
 import WebSocket from "ws";
+
+class LocalListenerTransport {
+  kind = "local";
+  bufferedAmount = 0;
+  isOpen() {
+    return true;
+  }
+  send(_data) {}
+}
+function isListenerTransportOpen(transport) {
+  if ("isOpen" in transport && typeof transport.isOpen === "function") {
+    return transport.isOpen();
+  }
+  return transport.readyState === WebSocket.OPEN;
+}
+function getListenerTransportKind(transport) {
+  return "kind" in transport ? transport.kind : "websocket";
+}
+var init_transport = () => {};
+
+// src/websocket/listener/approval.ts
 function rememberPendingApprovalBatchIds(runtime, pendingApprovals, batchId) {
   for (const approval of pendingApprovals) {
     if (approval.toolCallId) {
@@ -89327,7 +89361,7 @@ function rejectPendingApprovalResolvers(runtime, reason) {
   evictConversationRuntimeIfIdle(runtime);
 }
 function requestApprovalOverWS(runtime, socket, requestId, controlRequest) {
-  if (socket.readyState !== WebSocket.OPEN) {
+  if (!isListenerTransportOpen(socket)) {
     return Promise.reject(new Error("WebSocket not open"));
   }
   const abortSignal = runtime.activeAbortController?.signal ?? null;
@@ -89390,6 +89424,7 @@ function requestApprovalOverWS(runtime, socket, requestId, controlRequest) {
 }
 var init_approval = __esm(async () => {
   init_runtime4();
+  init_transport();
   await init_protocol_outbound();
 });
 
@@ -93226,7 +93261,6 @@ var init_diffPreview = __esm(() => {
 
 // src/websocket/listener/turn-approval.ts
 import { readFile as readFile12 } from "node:fs/promises";
-import WebSocket2 from "ws";
 function getChannelApprovalSourceScopeKey(source) {
   return [
     source.channel,
@@ -93512,7 +93546,7 @@ async function handleApprovalStop(params) {
     return interruptTermination();
   }
   const onFileWrite = (filePath, content) => {
-    if (socket.readyState === WebSocket2.OPEN) {
+    if (isListenerTransportOpen(socket)) {
       socket.send(JSON.stringify({
         type: "file_ops",
         path: filePath,
@@ -93639,6 +93673,7 @@ var init_turn_approval = __esm(async () => {
   init_formatDenial();
   init_interactivePolicy();
   init_skill_injection();
+  init_transport();
   await __promiseAll([
     init_approval_execution(),
     init_approval(),
@@ -94720,7 +94755,6 @@ var init_commands = __esm(async () => {
 import { appendFileSync as appendFileSync4, mkdirSync as mkdirSync22 } from "node:fs";
 import { dirname as dirname16 } from "node:path";
 import { performance as performance2 } from "node:perf_hooks";
-import WebSocket3 from "ws";
 function getProtocolPerfKey(message) {
   if (message.type === "stream_delta" && "delta" in message) {
     const delta = message.delta;
@@ -94942,10 +94976,11 @@ function buildDeviceStatus(runtime, params) {
     }
   })();
   const systemPromptDoctorState = scopedAgentId ? getSystemPromptDoctorState(scopedAgentId) : null;
+  const transport = listener.transport ?? listener.socket;
   return {
     current_connection_id: listener.connectionId,
     connection_name: listener.connectionName,
-    is_online: listener.socket?.readyState === WebSocket3.OPEN,
+    is_online: transport ? isListenerTransportOpen(transport) : false,
     is_processing: !!conversationRuntime?.isProcessing,
     current_permission_mode: conversationPermissionModeState.mode,
     current_working_directory: resolvedCwd,
@@ -95015,7 +95050,7 @@ function setLoopStatus(runtime, status, scope) {
   emitLoopStatusIfOpen(runtime, scope);
 }
 function emitProtocolV2Message(socket, runtime, message, scope) {
-  if (socket.readyState !== WebSocket3.OPEN) {
+  if (!isListenerTransportOpen(socket)) {
     return;
   }
   const listener = getListenerRuntime(runtime);
@@ -95083,14 +95118,16 @@ function emitLoopStatusUpdate(socket, runtime, scope) {
 }
 function emitLoopStatusIfOpen(runtime, scope) {
   const listener = getListenerRuntime(runtime);
-  if (listener?.socket?.readyState === WebSocket3.OPEN) {
-    emitLoopStatusUpdate(listener.socket, runtime, scope);
+  const transport = listener?.transport ?? listener?.socket;
+  if (transport && isListenerTransportOpen(transport)) {
+    emitLoopStatusUpdate(transport, runtime, scope);
   }
 }
 function emitDeviceStatusIfOpen(runtime, scope) {
   const listener = getListenerRuntime(runtime);
-  if (listener?.socket?.readyState === WebSocket3.OPEN) {
-    emitDeviceStatusUpdate(listener.socket, runtime, scope);
+  const transport = listener?.transport ?? listener?.socket;
+  if (transport && isListenerTransportOpen(transport)) {
+    emitDeviceStatusUpdate(transport, runtime, scope);
   }
 }
 function emitQueueUpdate(socket, runtime, scope) {
@@ -95148,8 +95185,9 @@ function emitDequeuedUserMessage(socket, runtime, incoming, batch) {
 }
 function emitQueueUpdateIfOpen(runtime, scope) {
   const listener = getListenerRuntime(runtime);
-  if (listener?.socket?.readyState === WebSocket3.OPEN) {
-    emitQueueUpdate(listener.socket, runtime, scope);
+  const transport = listener?.transport ?? listener?.socket;
+  if (transport && isListenerTransportOpen(transport)) {
+    emitQueueUpdate(transport, runtime, scope);
   }
 }
 function emitStateSync(socket, runtime, scope) {
@@ -95204,8 +95242,9 @@ function emitSubagentStateUpdate(socket, runtime, scope) {
 }
 function emitSubagentStateIfOpen(runtime, scope) {
   const listener = getListenerRuntime(runtime);
-  if (listener?.socket?.readyState === WebSocket3.OPEN) {
-    emitSubagentStateUpdate(listener.socket, runtime, scope);
+  const transport = listener?.transport ?? listener?.socket;
+  if (transport && isListenerTransportOpen(transport)) {
+    emitSubagentStateUpdate(transport, runtime, scope);
   }
 }
 function scheduleQueueEmit(runtime, scope) {
@@ -95301,6 +95340,7 @@ var init_protocol_outbound = __esm(async () => {
   init_cwd();
   init_permissionMode();
   init_runtime4();
+  init_transport();
   await init_commands();
   PROTOCOL_PERF_ENV_VALUES = new Set(["1", "true", "yes"]);
   PROTOCOL_PERF_ENABLED = PROTOCOL_PERF_ENV_VALUES.has((process.env.LETTA_LISTENER_PERF ?? "").toLowerCase());
@@ -95873,7 +95913,7 @@ var init_toolset_labels = __esm(() => {
 
 // src/websocket/terminalHandler.ts
 import * as os4 from "node:os";
-import WebSocket4 from "ws";
+import WebSocket2 from "ws";
 function getDefaultShell() {
   if (os4.platform() === "win32") {
     return process.env.COMSPEC || "cmd.exe";
@@ -95881,7 +95921,7 @@ function getDefaultShell() {
   return process.env.SHELL || "/bin/zsh";
 }
 function sendTerminalMessage(socket, message) {
-  if (socket.readyState === WebSocket4.OPEN) {
+  if (socket.readyState === WebSocket2.OPEN) {
     socket.send(JSON.stringify(message));
   }
 }
@@ -96596,9 +96636,10 @@ function isChannelId(value) {
 function hasValidChannelPolicyFields(config) {
   const hasValidDmPolicy = config.dm_policy === undefined || config.dm_policy === "pairing" || config.dm_policy === "allowlist" || config.dm_policy === "open";
   const hasValidAllowedUsers = config.allowed_users === undefined || Array.isArray(config.allowed_users) && config.allowed_users.every((entry) => typeof entry === "string");
+  const hasValidAllowedChannels = config.allowed_channels === undefined || Array.isArray(config.allowed_channels) && config.allowed_channels.every((entry) => typeof entry === "string");
   const hasValidDisplayName = config.display_name === undefined || typeof config.display_name === "string";
   const hasValidEnabled = config.enabled === undefined || typeof config.enabled === "boolean";
-  return hasValidDmPolicy && hasValidAllowedUsers && hasValidDisplayName && hasValidEnabled;
+  return hasValidDmPolicy && hasValidAllowedUsers && hasValidAllowedChannels && hasValidDisplayName && hasValidEnabled;
 }
 function isChannelsListCommand(value) {
   if (!value || typeof value !== "object")
@@ -97025,7 +97066,7 @@ import { execFile as execFile13 } from "node:child_process";
 import { lstat as lstat2, realpath as realpath3, stat as stat6 } from "node:fs/promises";
 import path25 from "node:path";
 import { promisify as promisify11 } from "node:util";
-import WebSocket5 from "ws";
+import WebSocket3 from "ws";
 async function isGitWorktreeRoot(dir) {
   try {
     const stats = await lstat2(path25.join(dir, ".git"));
@@ -97048,7 +97089,7 @@ function trackListenerError(errorType, error, context3) {
   });
 }
 function safeSocketSend(socket, payload, errorType, context3) {
-  if (socket.readyState !== WebSocket5.OPEN) {
+  if (socket.readyState !== WebSocket3.OPEN) {
     return false;
   }
   try {
@@ -97063,6 +97104,22 @@ function safeSocketSend(socket, payload, errorType, context3) {
     return false;
   }
 }
+function safeTransportSend(transport, payload, errorType, context3) {
+  if (!isListenerTransportOpen(transport)) {
+    return false;
+  }
+  try {
+    const serialized = typeof payload === "string" ? payload : JSON.stringify(payload);
+    transport.send(serialized);
+    return true;
+  } catch (error) {
+    trackListenerError(errorType, error, context3);
+    if (isDebugEnabled()) {
+      console.error(`[Listen] ${context3} send failed:`, error);
+    }
+    return false;
+  }
+}
 function runDetachedListenerTask(commandName, task2) {
   task2().catch((error) => {
     trackListenerError(`listener_${commandName}_failed`, error, `listener_${commandName}`);
@@ -97844,6 +97901,7 @@ async function handleChannelsProtocolCommand(parsed, socket, runtime, opts, proc
         enabled: snapshot.enabled,
         dm_policy: snapshot.dmPolicy,
         allowed_users: snapshot.allowedUsers,
+        allowed_channels: snapshot.allowedChannels,
         has_token: snapshot.hasToken
       };
     }
@@ -97889,6 +97947,7 @@ async function handleChannelsProtocolCommand(parsed, socket, runtime, opts, proc
         running: snapshot.running,
         dm_policy: snapshot.dmPolicy,
         allowed_users: snapshot.allowedUsers,
+        allowed_channels: snapshot.allowedChannels,
         has_token: snapshot.hasToken,
         agent_id: snapshot.agentId,
         created_at: snapshot.createdAt,
@@ -98004,7 +98063,8 @@ async function handleChannelsProtocolCommand(parsed, socket, runtime, opts, proc
         agentId: "agent_id" in parsed.account ? parsed.account.agent_id : undefined,
         defaultPermissionMode: "default_permission_mode" in parsed.account ? parsed.account.default_permission_mode : undefined,
         dmPolicy: parsed.account.dm_policy,
-        allowedUsers: parsed.account.allowed_users
+        allowedUsers: parsed.account.allowed_users,
+        allowedChannels: "allowed_channels" in parsed.account ? parsed.account.allowed_channels : undefined
       }, {
         accountId: "account_id" in parsed.account ? parsed.account.account_id : undefined
       });
@@ -98045,7 +98105,8 @@ async function handleChannelsProtocolCommand(parsed, socket, runtime, opts, proc
         agentId: "agent_id" in parsed.patch ? parsed.patch.agent_id : undefined,
         defaultPermissionMode: "default_permission_mode" in parsed.patch ? parsed.patch.default_permission_mode : undefined,
         dmPolicy: parsed.patch.dm_policy,
-        allowedUsers: parsed.patch.allowed_users
+        allowedUsers: parsed.patch.allowed_users,
+        allowedChannels: "allowed_channels" in parsed.patch ? parsed.patch.allowed_channels : undefined
       });
       const shouldRefreshDisplayName = !("display_name" in parsed.patch) && (parsed.channel_id === "telegram" ? "token" in parsed.patch : ("bot_token" in parsed.patch) || ("app_token" in parsed.patch));
       const account = shouldRefreshDisplayName ? await refreshChannelAccountDisplayNameLive2(parsed.channel_id, parsed.account_id, { force: true }) : updated;
@@ -98245,7 +98306,8 @@ async function handleChannelsProtocolCommand(parsed, socket, runtime, opts, proc
         appToken: "app_token" in parsed.config ? parsed.config.app_token : undefined,
         mode: "mode" in parsed.config ? parsed.config.mode : undefined,
         dmPolicy: parsed.config.dm_policy,
-        allowedUsers: parsed.config.allowed_users
+        allowedUsers: parsed.config.allowed_users,
+        allowedChannels: "allowed_channels" in parsed.config ? parsed.config.allowed_channels : undefined
       }, parsed.account_id);
       if (snapshot.enabled) {
         await wireChannelIngress(runtime, socket, opts, processQueuedTurn);
@@ -98833,13 +98895,17 @@ async function wireChannelIngress(listener, socket, opts, processQueuedTurn) {
 }
 function handleChannelRegistryEvent(event, socket, runtime) {
   if (event.type === "pairings_updated") {
-    emitChannelPairingsUpdated(socket, event.channelId);
-    emitChannelsUpdated(socket, event.channelId);
+    if (socket instanceof WebSocket3) {
+      emitChannelPairingsUpdated(socket, event.channelId);
+      emitChannelsUpdated(socket, event.channelId);
+    }
     return;
   }
   if (event.type === "targets_updated") {
-    emitChannelTargetsUpdated(socket, event.channelId);
-    emitChannelsUpdated(socket, event.channelId);
+    if (socket instanceof WebSocket3) {
+      emitChannelTargetsUpdated(socket, event.channelId);
+      emitChannelsUpdated(socket, event.channelId);
+    }
     return;
   }
   const permissionModeState = getOrCreateConversationPermissionModeStateRef(runtime, event.agentId, event.conversationId);
@@ -99184,6 +99250,7 @@ function createRuntime() {
   const bootWorkingDirectory = getCurrentWorkingDirectory();
   return {
     socket: null,
+    transport: null,
     heartbeatInterval: null,
     reconnectTimeout: null,
     intentionallyClosed: false,
@@ -99232,17 +99299,100 @@ function stopRuntime(runtime, suppressCallbacks) {
   runtime.queuedSystemPromptRecompileByConversation.clear();
   stopAllWorktreeWatchers(runtime);
   if (!runtime.socket) {
+    runtime.transport = null;
     return;
   }
   const socket = runtime.socket;
   runtime.socket = null;
+  runtime.transport = null;
   if (suppressCallbacks) {
     socket.removeAllListeners();
   }
-  if (socket.readyState === WebSocket5.OPEN || socket.readyState === WebSocket5.CONNECTING) {
+  if (socket.readyState === WebSocket3.OPEN || socket.readyState === WebSocket3.CONNECTING) {
     socket.close();
   }
 }
+async function startConnectedListenerRuntime(runtime, transport, opts, processQueuedTurn, options = {}) {
+  if (runtime !== getActiveRuntime() || runtime.intentionallyClosed) {
+    return;
+  }
+  const shouldStartHeartbeat = options.startHeartbeat !== false;
+  const shouldStartCronScheduler = options.startCronScheduler !== false;
+  runtime.transport = transport;
+  safeEmitWsEvent("recv", "lifecycle", {
+    type: getListenerTransportKind(transport) === "websocket" ? "_ws_open" : "_local_open"
+  });
+  runtime.hasSuccessfulConnection = true;
+  runtime.everConnected = true;
+  opts.onConnected(opts.connectionId);
+  if (runtime.conversationRuntimes.size === 0) {
+    emitLoopStatusUpdate(transport, runtime);
+  } else {
+    for (const reminderState of runtime.reminderStateByConversation.values()) {
+      resetSharedReminderState(reminderState);
+    }
+    for (const contextTracker of runtime.contextTrackerByConversation.values()) {
+      resetContextHistory(contextTracker);
+    }
+    for (const conversationRuntime of runtime.conversationRuntimes.values()) {
+      const scope = {
+        agent_id: conversationRuntime.agentId,
+        conversation_id: conversationRuntime.conversationId
+      };
+      emitDeviceStatusUpdate(transport, conversationRuntime, scope);
+      emitLoopStatusUpdate(transport, conversationRuntime, scope);
+    }
+  }
+  runtime._unsubscribeSubagentState?.();
+  runtime._unsubscribeSubagentState = subscribe2(() => {
+    if (runtime.conversationRuntimes.size === 0) {
+      emitSubagentStateIfOpen(runtime);
+      return;
+    }
+    for (const conversationRuntime of runtime.conversationRuntimes.values()) {
+      emitSubagentStateIfOpen(runtime, {
+        agent_id: conversationRuntime.agentId,
+        conversation_id: conversationRuntime.conversationId
+      });
+    }
+  });
+  runtime._unsubscribeSubagentStreamEvents?.();
+  runtime._unsubscribeSubagentStreamEvents = subscribeToStreamEvents((subagentId, event) => {
+    if (!isListenerTransportOpen(transport))
+      return;
+    const subagent = getSubagents().find((entry) => entry.id === subagentId);
+    if (subagent?.silent === true) {
+      return;
+    }
+    emitStreamDelta(transport, runtime, event, subagent?.parentAgentId ? {
+      agent_id: subagent.parentAgentId,
+      conversation_id: subagent.parentConversationId ?? "default"
+    } : undefined, subagentId);
+  });
+  setMessageQueueAdder((queuedMessage) => {
+    const targetRuntime = queuedMessage.agentId && queuedMessage.conversationId ? getOrCreateScopedRuntime(runtime, queuedMessage.agentId, queuedMessage.conversationId) : findFallbackRuntime(runtime);
+    if (!targetRuntime?.queueRuntime) {
+      return;
+    }
+    targetRuntime.queueRuntime.enqueue({
+      kind: "task_notification",
+      source: "task_notification",
+      text: queuedMessage.text,
+      agentId: queuedMessage.agentId ?? targetRuntime.agentId ?? undefined,
+      conversationId: queuedMessage.conversationId ?? targetRuntime.conversationId
+    });
+    scheduleQueuePump(targetRuntime, transport, opts, processQueuedTurn);
+  });
+  if (shouldStartHeartbeat) {
+    runtime.heartbeatInterval = setInterval(() => {
+      safeTransportSend(transport, { type: "ping" }, "listener_ping_send_failed", "listener_heartbeat");
+    }, 30000);
+  }
+  if (shouldStartCronScheduler) {
+    startScheduler(transport, opts, processQueuedTurn);
+  }
+  await wireChannelIngress(runtime, transport, opts, processQueuedTurn);
+}
 async function startListenerClient(opts) {
   const existingRuntime = getActiveRuntime();
   if (existingRuntime) {
@@ -99257,6 +99407,34 @@ async function startListenerClient(opts) {
   telemetry.init();
   await connectWithRetry(runtime, opts);
 }
+async function startLocalChannelListener(opts) {
+  const existingRuntime = getActiveRuntime();
+  if (existingRuntime) {
+    stopRuntime(existingRuntime, true);
+  }
+  const runtime = createRuntime();
+  runtime.onWsEvent = opts.onWsEvent;
+  runtime.connectionId = opts.connectionId;
+  runtime.connectionName = opts.connectionName;
+  setActiveRuntime(runtime);
+  telemetry.setSurface("websocket");
+  telemetry.init();
+  try {
+    await loadTools();
+    const transport = new LocalListenerTransport;
+    const processQueuedTurn = async (queuedTurn, dequeuedBatch) => {
+      const scopedRuntime = getOrCreateScopedRuntime(runtime, queuedTurn.agentId, queuedTurn.conversationId);
+      await handleIncomingMessage(queuedTurn, transport, scopedRuntime, opts.onStatusChange, opts.connectionId, dequeuedBatch.batchId);
+    };
+    await startConnectedListenerRuntime(runtime, transport, opts, processQueuedTurn, { startHeartbeat: false, startCronScheduler: true });
+  } catch (error) {
+    stopRuntime(runtime, true);
+    if (getActiveRuntime() === runtime) {
+      setActiveRuntime(null);
+    }
+    opts.onError(error instanceof Error ? error : new Error(String(error)));
+  }
+}
 async function listDirectoryHybrid(absDir, indexRoot3, includeFiles) {
   let indexedNames;
   const indexedFolders = [];
@@ -99339,7 +99517,7 @@ async function connectWithRetry(runtime, opts, attempt = 0, startTime = Date.now
   const url = new URL(opts.wsUrl);
   url.searchParams.set("deviceId", opts.deviceId);
   url.searchParams.set("connectionName", opts.connectionName);
-  const socket = new WebSocket5(url.toString(), {
+  const socket = new WebSocket3(url.toString(), {
     headers: {
       Authorization: `Bearer ${apiKey}`
     }
@@ -99348,83 +99526,13 @@ async function connectWithRetry(runtime, opts, attempt = 0, startTime = Date.now
   const watchDebounceTimers = new Map;
   const cancelledWatches = new Set;
   runtime.socket = socket;
+  const transport = socket;
   const processQueuedTurn = async (queuedTurn, dequeuedBatch) => {
     const scopedRuntime = getOrCreateScopedRuntime(runtime, queuedTurn.agentId, queuedTurn.conversationId);
-    await handleIncomingMessage(queuedTurn, socket, scopedRuntime, opts.onStatusChange, opts.connectionId, dequeuedBatch.batchId);
+    await handleIncomingMessage(queuedTurn, transport, scopedRuntime, opts.onStatusChange, opts.connectionId, dequeuedBatch.batchId);
   };
   socket.on("open", async () => {
-    if (runtime !== getActiveRuntime() || runtime.intentionallyClosed) {
-      return;
-    }
-    safeEmitWsEvent("recv", "lifecycle", { type: "_ws_open" });
-    runtime.hasSuccessfulConnection = true;
-    runtime.everConnected = true;
-    opts.onConnected(opts.connectionId);
-    if (runtime.conversationRuntimes.size === 0) {
-      emitLoopStatusUpdate(socket, runtime);
-    } else {
-      for (const reminderState of runtime.reminderStateByConversation.values()) {
-        resetSharedReminderState(reminderState);
-      }
-      for (const contextTracker of runtime.contextTrackerByConversation.values()) {
-        resetContextHistory(contextTracker);
-      }
-      for (const conversationRuntime of runtime.conversationRuntimes.values()) {
-        const scope = {
-          agent_id: conversationRuntime.agentId,
-          conversation_id: conversationRuntime.conversationId
-        };
-        emitDeviceStatusUpdate(socket, conversationRuntime, scope);
-        emitLoopStatusUpdate(socket, conversationRuntime, scope);
-      }
-    }
-    runtime._unsubscribeSubagentState?.();
-    runtime._unsubscribeSubagentState = subscribe2(() => {
-      if (runtime.conversationRuntimes.size === 0) {
-        emitSubagentStateIfOpen(runtime);
-        return;
-      }
-      for (const conversationRuntime of runtime.conversationRuntimes.values()) {
-        emitSubagentStateIfOpen(runtime, {
-          agent_id: conversationRuntime.agentId,
-          conversation_id: conversationRuntime.conversationId
-        });
-      }
-    });
-    runtime._unsubscribeSubagentStreamEvents?.();
-    runtime._unsubscribeSubagentStreamEvents = subscribeToStreamEvents((subagentId, event) => {
-      if (socket.readyState !== WebSocket5.OPEN)
-        return;
-      const subagent = getSubagents().find((entry) => entry.id === subagentId);
-      if (subagent?.silent === true) {
-        return;
-      }
-      emitStreamDelta(socket, runtime, event, subagent?.parentAgentId ? {
-        agent_id: subagent.parentAgentId,
-        conversation_id: subagent.parentConversationId ?? "default"
-      } : undefined, subagentId);
-    });
-    setMessageQueueAdder((queuedMessage) => {
-      const targetRuntime = queuedMessage.agentId && queuedMessage.conversationId ? getOrCreateScopedRuntime(runtime, queuedMessage.agentId, queuedMessage.conversationId) : findFallbackRuntime(runtime);
-      if (!targetRuntime?.queueRuntime) {
-        return;
-      }
-      targetRuntime.queueRuntime.enqueue({
-        kind: "task_notification",
-        source: "task_notification",
-        text: queuedMessage.text,
-        agentId: queuedMessage.agentId ?? targetRuntime.agentId ?? undefined,
-        conversationId: queuedMessage.conversationId ?? targetRuntime.conversationId
-      });
-      scheduleQueuePump(targetRuntime, socket, opts, processQueuedTurn);
-    });
-    runtime.heartbeatInterval = setInterval(() => {
-      if (socket.readyState === WebSocket5.OPEN) {
-        safeSocketSend(socket, { type: "ping" }, "listener_ping_send_failed", "listener_heartbeat");
-      }
-    }, 30000);
-    startScheduler(socket, opts, processQueuedTurn);
-    await wireChannelIngress(runtime, socket, opts, processQueuedTurn);
+    await startConnectedListenerRuntime(runtime, transport, opts, processQueuedTurn, { startHeartbeat: true, startCronScheduler: true });
   });
   socket.on("message", async (data) => {
     const raw = data.toString();
@@ -100458,7 +100566,7 @@ async function connectWithRetry(runtime, opts, attempt = 0, startTime = Date.now
 }
 function isListenerActive() {
   const runtime = getActiveRuntime();
-  return runtime !== null && runtime.socket !== null;
+  return runtime !== null && runtime.transport !== null;
 }
 function stopListenerClient() {
   const runtime = getActiveRuntime();
@@ -100686,6 +100794,7 @@ var init_client4 = __esm(async () => {
   init_grepInFiles();
   init_permissionMode();
   init_runtime4();
+  init_transport();
   await __promiseAll([
     init_scheduler(),
     init_manager4(),
@@ -100781,6 +100890,7 @@ var init_client4 = __esm(async () => {
 var exports_listen_client = {};
 __export(exports_listen_client, {
   stopListenerClient: () => stopListenerClient,
+  startLocalChannelListener: () => startLocalChannelListener,
   startListenerClient: () => startListenerClient,
   resolvePendingApprovalResolver: () => resolvePendingApprovalResolver,
   requestApprovalOverWS: () => requestApprovalOverWS,
@@ -165010,6 +165120,23 @@ function getListenerServerUrl(settings) {
   const oauthDeps = getListenerOAuthDeps();
   return process.env.LETTA_BASE_URL || settings.env?.LETTA_BASE_URL || oauthDeps.LETTA_CLOUD_API_URL;
 }
+function normalizeListenerBaseUrl(url) {
+  return url.trim().replace(/\/+$/, "");
+}
+function isCloudListenerServerUrl(serverUrl) {
+  return normalizeListenerBaseUrl(serverUrl) === normalizeListenerBaseUrl(getListenerOAuthDeps().LETTA_CLOUD_API_URL);
+}
+async function resolveListenerStartupMode(channelNames) {
+  const settings = await settingsManager.getSettingsWithSecureTokens();
+  const serverUrl = getListenerServerUrl(settings);
+  if (isCloudListenerServerUrl(serverUrl)) {
+    return { kind: "remote", serverUrl };
+  }
+  if (channelNames.length > 0) {
+    return { kind: "local-channels", serverUrl };
+  }
+  return { kind: "unsupported-self-hosted", serverUrl };
+}
 async function refreshListenerAccessToken(settings, deviceId, connectionName) {
   const oauthDeps = getListenerOAuthDeps();
   const now = Date.now();
@@ -165065,7 +165192,7 @@ async function resolveListenerRegistrationOptions(deviceId, connectionName) {
     };
   }
   let apiKey = settings.env?.LETTA_API_KEY;
-  if (serverUrl === LETTA_CLOUD_API_URL) {
+  if (isCloudListenerServerUrl(serverUrl)) {
     const expiresAt = settings.tokenExpiresAt;
     if (settings.refreshToken && expiresAt) {
       const now = Date.now();
@@ -165190,6 +165317,52 @@ async function runListenSubcommand(argv) {
   console.log(`Log file: ${sessionLog.path}`);
   try {
     const deviceId = settingsManager.getOrCreateDeviceId();
+    const startupMode = await resolveListenerStartupMode(channelNames);
+    if (startupMode.kind === "unsupported-self-hosted") {
+      console.error(`Self-hosted listener registration is not available for ${startupMode.serverUrl}.`);
+      console.error("Start with --channels to run local channel adapters, or unset LETTA_BASE_URL to use Letta API remote environments.");
+      await flushListenerTelemetryEnd("listener_self_hosted_no_channels");
+      return 1;
+    }
+    sessionLog.log(`Session started (debug=${debugMode})`);
+    sessionLog.log(`deviceId: ${deviceId}`);
+    sessionLog.log(`connectionName: ${connectionName}`);
+    if (startupMode.kind === "local-channels") {
+      const connectionId2 = `local-${deviceId}`;
+      sessionLog.log(`Starting local channel listener for ${startupMode.serverUrl}`);
+      sessionLog.log("Skipping environment registration");
+      console.log(`Starting local channel listener for self-hosted server ${startupMode.serverUrl}`);
+      console.log(`Skipping environment registration. Press Ctrl+C to stop.
+`);
+      const { startLocalChannelListener: startLocalChannelListener2 } = await init_listen_client().then(() => exports_listen_client);
+      await startLocalChannelListener2({
+        connectionId: connectionId2,
+        deviceId,
+        connectionName,
+        onWsEvent: process.env.LETTA_LOG_WS_EVENTS === "1" ? (direction, label, event) => {
+          sessionLog.wsEvent(direction, label, event);
+        } : undefined,
+        onStatusChange: (status) => {
+          sessionLog.log(`status: ${status}`);
+          if (debugMode) {
+            console.log(`[${formatTimestamp3()}] status: ${status}`);
+          }
+        },
+        onConnected: () => {
+          sessionLog.log("Local channel listener ready.");
+          if (debugMode) {
+            console.log(`[${formatTimestamp3()}] Local channel listener ready.`);
+            console.log("");
+          }
+        },
+        onError: (error) => {
+          sessionLog.log(`Error: ${error.message}`);
+          console.error(`[${formatTimestamp3()}] Error: ${error.message}`);
+          exitWithTelemetry(1, "listener_error");
+        }
+      });
+      return new Promise(() => {});
+    }
     let registerOptions;
     try {
       registerOptions = await resolveListenerRegistrationOptions(deviceId, connectionName);
@@ -165204,9 +165377,6 @@ async function runListenSubcommand(argv) {
       await flushListenerTelemetryEnd("listener_oauth_failed");
       return 1;
     }
-    sessionLog.log(`Session started (debug=${debugMode})`);
-    sessionLog.log(`deviceId: ${deviceId}`);
-    sessionLog.log(`connectionName: ${connectionName}`);
     if (debugMode) {
       console.log(`[${formatTimestamp3()}] Registering with ${registerOptions.serverUrl}/v1/environments/register`);
       console.log(`[${formatTimestamp3()}]   deviceId: ${deviceId}`);
@@ -169599,4 +169769,4 @@ Error during initialization: ${message}`);
 }
 main();
 
-//# debugId=C84A92912A26F4A364756E2164756E21
+//# debugId=5F460A87866AF15264756E2164756E21

package/package.json

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