@letta-ai/letta-code 0.30.5 → 0.30.7

package/letta.js

@@ -5464,7 +5464,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@letta-ai/letta-code",
-    version: "0.30.5",
+    version: "0.30.7",
     description: "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
     type: "module",
     packageManager: "bun@1.3.0",
@@ -5746,6 +5746,7 @@ var init_memfs_git_proxy = __esm(() => {
 var exports_client = {};
 __export(exports_client, {
   getServerUrl: () => getServerUrl,
+  getRuntimeEnvironmentDeviceId: () => getRuntimeEnvironmentDeviceId,
   getMemfsServerUrl: () => getMemfsServerUrl,
   getMemfsGitProxyRewriteConfig: () => getMemfsGitProxyRewriteConfig,
   getClientDefaultHeaders: () => getClientDefaultHeaders,
@@ -7125,12 +7126,7 @@ You **MUST** be proactive in creating crons when work extends beyond the current
 
 **Cost**: Self-invocation is critical, but expensive. Default to the longest interval that still serves the user. Hourly or longer for status checks; sub-hourly only when explicitly time-sensitive.
 
-Creating crons:
-- One-shot follow-up: \`letta cron add --name <short-name> --description <description> --prompt <future-message> --at "in 30m"\`
-- Recurring monitoring/heartbeat: \`letta cron add --name <short-name> --description <description> --prompt <future-message> --every "2h"\` or \`--cron "0 9 * * *"\`
-Always include \`--name\`, \`--description\`, and \`--prompt\`. \`$AGENT_ID\` is automatically injected into the shell environment, and \`letta cron\` uses it by default, so you do not need to specify which agent to invoke unless overriding the current agent intentionally.
-
-Where crons run: for cloud agents, schedules default to durable Cloud schedules that fire from the cloud and execute in your cloud sandbox — they survive local shutdown, so this is the right default. If the scheduled work must run on a specific computer (e.g. it needs that computer's filesystem or local services), add \`--computer <deviceId>\` (from \`letta environments list\`) to keep the durable Cloud schedule but execute on that computer, with sandbox fallback if it is offline. Use \`--runner local\` only when that fallback is unacceptable; local schedules only fire while a Letta session is running on that computer.
+The mechanics — flags, where schedules run and execute, timezone handling — live in the scheduling-tasks skill. Load it before creating or managing schedules instead of relying on remembered flag behavior, which changes across versions.
 
 # Harness Architecture
 
@@ -7310,12 +7306,7 @@ You **MUST** be proactive in creating crons when work extends beyond the current
 
 **Cost**: Self-invocation is critical, but expensive. Default to the longest interval that still serves the user. Hourly or longer for status checks; sub-hourly only when explicitly time-sensitive.
 
-Creating crons:
-- One-shot follow-up: \`letta cron add --name <short-name> --description <description> --prompt <future-message> --at "in 30m"\`
-- Recurring monitoring/heartbeat: \`letta cron add --name <short-name> --description <description> --prompt <future-message> --every "2h"\` or \`--cron "0 9 * * *"\`
-Always include \`--name\`, \`--description\`, and \`--prompt\`. \`$AGENT_ID\` is automatically injected into the shell environment, and \`letta cron\` uses it by default, so you do not need to specify which agent to invoke unless overriding the current agent intentionally.
-
-Where crons run: for cloud agents, schedules default to durable Cloud schedules that fire from the cloud and execute in your cloud sandbox — they survive local shutdown, so this is the right default. If the scheduled work must run on a specific computer (e.g. it needs that computer's filesystem or local services), add \`--computer <deviceId>\` (from \`letta environments list\`) to keep the durable Cloud schedule but execute on that computer, with sandbox fallback if it is offline. Use \`--runner local\` only when that fallback is unacceptable; local schedules only fire while a Letta session is running on that computer.
+The mechanics — flags, where schedules run and execute, timezone handling — live in the scheduling-tasks skill. Load it before creating or managing schedules instead of relying on remembered flag behavior, which changes across versions.
 
 # Harness Architecture
 
@@ -139326,7 +139317,7 @@ function isProviderConfigured(provider, localProviderNames) {
 function listConfiguredPiProviders(localProviderNames) {
   return PI_PROVIDER_SPECS.filter((provider) => isProviderConfigured(provider, localProviderNames)).map((provider) => provider.id);
 }
-var LOCAL_CHATGPT_PROVIDER_NAME = "chatgpt-plus-pro", LOCAL_OPENAI_PROVIDER_NAME = "lc-openai", LOCAL_ANTHROPIC_PROVIDER_NAME = "lc-anthropic", LOCAL_OPENROUTER_PROVIDER_NAME = "lc-openrouter", LOCAL_OLLAMA_PROVIDER_NAME = "lc-ollama", LOCAL_OLLAMA_CLOUD_PROVIDER_NAME = "lc-ollama-cloud", LOCAL_LMSTUDIO_PROVIDER_NAME = "lc-lmstudio", LMSTUDIO_OPENAI_PROVIDER_TYPE = "lmstudio_openai", LEGACY_LMSTUDIO_PROVIDER_TYPE = "lmstudio", LOCAL_LLAMA_CPP_PROVIDER_NAME = "lc-llama-cpp", LOCAL_ZAI_PROVIDER_NAME = "lc-zai", LOCAL_ZAI_CODING_PROVIDER_NAME = "lc-zai-coding", LOCAL_MINIMAX_PROVIDER_NAME = "lc-minimax", LOCAL_MOONSHOT_PROVIDER_NAME = "lc-moonshot", LOCAL_KIMI_CODE_PROVIDER_NAME = "lc-kimi-code", LOCAL_GOOGLE_AI_PROVIDER_NAME = "lc-gemini", LOCAL_BEDROCK_PROVIDER_NAME = "lc-bedrock", prefixedCatalogModelHandle = (prefix) => (model) => `${prefix}${model.id}`, PI_PROVIDER_ALIASES, PI_TUI_DEFAULT_MODEL_IDS, PI_TUI_DEFAULTLESS_PROVIDER_IDS, PI_PROVIDER_OVERRIDES, LOCAL_ENDPOINT_PROVIDER_SPECS, PI_PROVIDER_SPECS, SUPPORTED_LOCAL_PROVIDER_TYPES, KNOWN_PI_PROVIDERS, PROVIDER_TYPE_TO_BASE_PROVIDER;
+var LOCAL_CHATGPT_PROVIDER_NAME = "chatgpt-plus-pro", LOCAL_OPENAI_PROVIDER_NAME = "lc-openai", LOCAL_OPENAI_COMPATIBLE_PROVIDER_NAME = "lc-openai-compatible", OPENAI_COMPATIBLE_PI_PROVIDER_ID = "openai-compatible", LOCAL_ANTHROPIC_PROVIDER_NAME = "lc-anthropic", LOCAL_OPENROUTER_PROVIDER_NAME = "lc-openrouter", LOCAL_OLLAMA_PROVIDER_NAME = "lc-ollama", LOCAL_OLLAMA_CLOUD_PROVIDER_NAME = "lc-ollama-cloud", LOCAL_LMSTUDIO_PROVIDER_NAME = "lc-lmstudio", LMSTUDIO_OPENAI_PROVIDER_TYPE = "lmstudio_openai", LEGACY_LMSTUDIO_PROVIDER_TYPE = "lmstudio", LOCAL_LLAMA_CPP_PROVIDER_NAME = "lc-llama-cpp", LOCAL_ZAI_PROVIDER_NAME = "lc-zai", LOCAL_ZAI_CODING_PROVIDER_NAME = "lc-zai-coding", LOCAL_MINIMAX_PROVIDER_NAME = "lc-minimax", LOCAL_MOONSHOT_PROVIDER_NAME = "lc-moonshot", LOCAL_KIMI_CODE_PROVIDER_NAME = "lc-kimi-code", LOCAL_GOOGLE_AI_PROVIDER_NAME = "lc-gemini", LOCAL_BEDROCK_PROVIDER_NAME = "lc-bedrock", prefixedCatalogModelHandle = (prefix) => (model) => `${prefix}${model.id}`, PI_PROVIDER_ALIASES, PI_TUI_DEFAULT_MODEL_IDS, PI_TUI_DEFAULTLESS_PROVIDER_IDS, PI_PROVIDER_OVERRIDES, LOCAL_ENDPOINT_PROVIDER_SPECS, PI_PROVIDER_SPECS, SUPPORTED_LOCAL_PROVIDER_TYPES, KNOWN_PI_PROVIDERS, PROVIDER_TYPE_TO_BASE_PROVIDER;
 var init_pi_provider_registry = __esm(() => {
   init_compat2();
   init_all();
@@ -139473,6 +139464,18 @@ var init_pi_provider_registry = __esm(() => {
       envConfigured: () => hasEnvValue(process.env.OLLAMA_API_KEY),
       createCustomModel: true
     },
+    {
+      id: OPENAI_COMPATIBLE_PI_PROVIDER_ID,
+      providerTypes: ["openai-compatible"],
+      handlePrefixes: ["openai-compatible/"],
+      localProviderNames: [
+        OPENAI_COMPATIBLE_PI_PROVIDER_ID,
+        LOCAL_OPENAI_COMPATIBLE_PROVIDER_NAME
+      ],
+      fallbackApiKey: "not-needed",
+      localModelDiscovery: "openai-compatible",
+      createCustomModel: true
+    },
     {
       id: "lmstudio",
       providerTypes: [
@@ -139595,6 +139598,10 @@ async function createOrUpdateLocalProvider(input) {
   }
   const file3 = readAuthFile(input.storageDir);
   const existing = file3.providers[input.providerName];
+  const baseURL = input.baseURL ?? existing?.base_url;
+  if (input.providerType === OPENAI_COMPATIBLE_PI_PROVIDER_ID && !baseURL?.trim()) {
+    throw new Error("OpenAI-compatible API requires a base URL.");
+  }
   const now = new Date().toISOString();
   const auth = input.providerType === "chatgpt_oauth" ? parseChatGPTOAuth(input.apiKey) : { type: "api", key: input.apiKey };
   const next = {
@@ -139606,7 +139613,7 @@ async function createOrUpdateLocalProvider(input) {
     ...input.accessKey ? { access_key: input.accessKey } : {},
     ...input.region ? { region: input.region } : {},
     ...input.profile ? { profile: input.profile } : {},
-    ...input.baseURL ?? existing?.base_url ? { base_url: input.baseURL ?? existing?.base_url } : {},
+    ...baseURL ? { base_url: baseURL } : {},
     ...input.timeout !== undefined ? { timeout: input.timeout } : existing?.timeout !== undefined ? { timeout: existing.timeout } : {},
     created_at: existing?.created_at ?? now,
     updated_at: now
@@ -140225,6 +140232,20 @@ var init_byok_providers = __esm(() => {
       providerName: "ollama-cloud",
       providerNames: ["ollama-cloud", "lc-ollama-cloud"]
     },
+    {
+      id: "openai-compatible",
+      displayName: "OpenAI-compatible API",
+      description: "Connect an OpenAI-compatible Chat Completions endpoint",
+      providerType: "openai-compatible",
+      providerName: "openai-compatible",
+      providerNames: ["openai-compatible", "lc-openai-compatible"],
+      requiresApiKey: false,
+      defaultApiKey: LOCAL_PROVIDER_NO_API_KEY,
+      fields: [
+        { key: "apiKey", label: "API Key", secret: true, required: false },
+        { key: "baseUrl", label: "Base URL" }
+      ]
+    },
     {
       id: "lmstudio",
       displayName: "LM Studio (local)",
@@ -146165,6 +146186,7 @@ var init_config2 = __esm(() => {
         allowedUsers: parsed.allowed_users ?? [],
         transcribeVoice: parsed.transcribe_voice === true,
         listenMode: parsed.listen_mode === true,
+        mentionOnlyChannels: Array.isArray(parsed.mention_only_channels) ? parsed.mention_only_channels.filter((channelId) => typeof channelId === "string") : [],
         allowBots: normalizeSlackAllowBotsMode(parsed.allow_bots)
       };
     }
@@ -150405,6 +150427,11 @@ function cloneAccount(account) {
   if (isTelegramChannelAccount(account)) {
     cloned.binding = { ...account.binding };
   }
+  if (isSlackChannelAccount(account)) {
+    cloned.mentionOnlyChannels = [
+      ...account.mentionOnlyChannels ?? []
+    ];
+  }
   if (isDiscordChannelAccount(account) && account.allowedChannels) {
     cloned.allowedChannels = Array.isArray(account.allowedChannels) ? [...account.allowedChannels] : { ...account.allowedChannels };
   }
@@ -150474,6 +150501,8 @@ function normalizeLoadedAccount(account) {
     delete next.progress_ui;
     delete next.progressUi;
     next.listenMode = next.listenMode === true;
+    const mentionOnlyChannels = next.mentionOnlyChannels;
+    next.mentionOnlyChannels = Array.isArray(mentionOnlyChannels) ? [...mentionOnlyChannels] : [];
     next.allowBots = normalizeSlackAllowBotsMode(next.allowBots);
   }
   if (isDiscordChannelAccount(next)) {
@@ -150623,6 +150652,7 @@ function makeDefaultLegacyAccount(channelId) {
     defaultPermissionMode: DEFAULT_SLACK_PERMISSION_MODE,
     transcribeVoice: config3.transcribeVoice === true,
     listenMode: config3.listenMode === true,
+    mentionOnlyChannels: [...config3.mentionOnlyChannels ?? []],
     allowBots: config3.allowBots ?? false,
     createdAt: now,
     updatedAt: now
@@ -150822,6 +150852,7 @@ var init_accounts = __esm(() => {
     group_mode: "groupMode",
     inbound_debounce_ms: "inboundDebounceMs",
     listen_mode: "listenMode",
+    mention_only_channels: "mentionOnlyChannels",
     message_prefix: "messagePrefix",
     media_max_bytes: "mediaMaxBytes",
     attachment_filter: "attachmentFilter",
@@ -154533,6 +154564,9 @@ var init_inbound_debounce = __esm(() => {
 });
 
 // src/channels/slack/ingress-policy.ts
+function isSlackMentionOnlyChannel(channelId, mentionOnlyChannels) {
+  return mentionOnlyChannels?.includes(channelId) === true;
+}
 function hasRecordValue(value) {
   return value !== null && typeof value === "object";
 }
@@ -154763,6 +154797,9 @@ function createSlackIngressController(params) {
       })) {
         return;
       }
+      if (basePolicy.chatType === "channel" && !basePolicy.wasMentioned && isSlackMentionOnlyChannel(channelId, config3.mentionOnlyChannels)) {
+        return;
+      }
       const attachments = await resolveSlackInboundAttachments({
         accountId: config3.accountId,
         token: config3.botToken,
@@ -154944,6 +154981,9 @@ function createSlackIngressController(params) {
         return;
       }
       const chatType = resolveSlackChatType(chatId);
+      if (chatType === "channel" && isSlackMentionOnlyChannel(chatId, config3.mentionOnlyChannels)) {
+        return;
+      }
       const threadId = chatType === "channel" ? knownThreadIdsByMessageId.get(targetMessageId) ?? targetMessageId : knownThreadIdsByMessageId.get(targetMessageId) ?? null;
       try {
         await adapter.onMessage({
@@ -172754,6 +172794,7 @@ function createConversationRuntime(listener, agentId, conversationId) {
     currentToolsetPreference: "auto",
     currentLoadedTools: [],
     pendingApprovalBatchByToolCallId: new Map,
+    approvalMessageIdByToolCallId: new Map,
     pendingInterruptedResults: null,
     pendingInterruptedContext: null,
     continuationEpoch: 0,
@@ -172790,6 +172831,7 @@ function clearConversationRuntimeState(runtime) {
     conversationId: runtime.conversationId
   });
   runtime.pendingApprovalBatchByToolCallId.clear();
+  runtime.approvalMessageIdByToolCallId.clear();
   runtime.pendingInterruptedResults = null;
   runtime.pendingInterruptedContext = null;
   runtime.pendingInterruptedToolCallIds = null;
@@ -173673,6 +173715,10 @@ function getShellEnv() {
     env3[pathKey] = existingPath ? `${pathPrefixes.join(shellPathDelimiter())}${shellPathDelimiter()}${existingPath}` : pathPrefixes.join(shellPathDelimiter());
   }
   env3.USER_CWD = getCurrentWorkingDirectory();
+  const environmentDeviceId = getRuntimeContext()?.environmentDeviceId?.trim();
+  if (environmentDeviceId) {
+    env3.LETTA_RUNTIME_ENVIRONMENT_DEVICE_ID = environmentDeviceId;
+  }
   let agentId;
   try {
     const resolvedAgentId = getCurrentAgentId();
@@ -348867,9 +348913,21 @@ import { join as join34 } from "node:path";
 async function getUnavailableListenerClient() {
   throw new Error("letta.client is not available in listener mods");
 }
+function resolveListenerAgentMemfsContext(agentId) {
+  if (!agentId)
+    return { enabled: false, memoryDir: null };
+  try {
+    return settingsManager.isMemfsEnabled(agentId) ? {
+      enabled: true,
+      memoryDir: getScopedMemoryFilesystemRoot(agentId)
+    } : { enabled: false, memoryDir: null };
+  } catch {
+    return { enabled: false, memoryDir: null };
+  }
+}
 function createListenerModContext(options3 = {}) {
   const cwd = options3.workingDirectory ?? getCurrentWorkingDirectory();
-  return buildModInvocationContext({
+  const context3 = buildModInvocationContext({
     agent: options3.agent ?? null,
     conversationId: options3.sessionId ?? null,
     modelIdentifier: options3.modelIdentifier ?? null,
@@ -348877,6 +348935,13 @@ function createListenerModContext(options3 = {}) {
     toolset: options3.toolset ?? null,
     workingDirectory: cwd
   });
+  return {
+    ...context3,
+    memfs: resolveListenerAgentMemfsContext(context3.agent.id)
+  };
+}
+function createListenerAgentModContext(agentId) {
+  return createListenerModContext({ agent: { id: agentId } });
 }
 function createListenerModAdapter(options3 = {}) {
   return createModAdapter({
@@ -350048,7 +350113,7 @@ function scheduleQueueEmit(runtime, scope) {
 }
 function createLifecycleMessageBase(messageType, runId) {
   return {
-    id: `message-${crypto.randomUUID()}`,
+    id: `lifecycle-${crypto.randomUUID()}`,
     date: new Date().toISOString(),
     message_type: messageType,
     ...runId ? { run_id: runId } : {}
@@ -364865,6 +364930,7 @@ function composeSubagentChildEnv(options3) {
     backendMode,
     localBackendStorageDir,
     parentAgentId,
+    subagentType,
     launchProfile,
     inheritedPrimaryRoot,
     memoryScope,
@@ -364878,6 +364944,7 @@ function composeSubagentChildEnv(options3) {
     ...inheritedApiKey && { LETTA_API_KEY: inheritedApiKey },
     ...inheritedBaseUrl && { LETTA_BASE_URL: inheritedBaseUrl },
     LETTA_CODE_AGENT_ROLE: "subagent",
+    ...subagentType === "reflection" && { [LETTA_DISABLE_MODS_ENV]: "1" },
     ...parentAgentId && { LETTA_PARENT_AGENT_ID: parentAgentId },
     ...transcriptPath && { TRANSCRIPT_PATH: transcriptPath },
     ...inheritedChannelContext && {
@@ -365410,6 +365477,7 @@ async function executeSubagent(type3, config3, model, userPrompt, subagentId, is
       backendMode,
       localBackendStorageDir,
       parentAgentId,
+      subagentType: type3,
       launchProfile: effectiveLaunchProfile,
       inheritedPrimaryRoot,
       memoryScope,
@@ -373761,6 +373829,7 @@ function parseInheritedChannelContextEnv() {
 async function prepareToolExecutionContextForScope(params) {
   const {
     connectionId,
+    environmentDeviceId,
     agentId,
     conversationId,
     overrideModel,
@@ -373826,6 +373895,7 @@ async function prepareToolExecutionContextForScope(params) {
     agent: agent2,
     runtimeContext: {
       connectionId,
+      environmentDeviceId,
       agentId,
       agentName: agent2.name ?? null,
       conversationId: scopedConversationId,
@@ -375025,13 +375095,13 @@ echo password=${token}
   } else {
     helper = `!f() { echo "username=letta"; echo "password=${token}"; }; f`;
   }
-  await gitConfig(dir, [
-    "config",
-    `credential.${normalizedBaseUrl}.helper`,
-    helper
-  ]);
+  const writeHelperWithReset = async (key) => {
+    await gitConfig(dir, ["config", "--local", "--replace-all", key, ""]);
+    await gitConfig(dir, ["config", "--local", "--add", key, helper]);
+  };
+  await writeHelperWithReset(`credential.${normalizedBaseUrl}.helper`);
   if (rawBaseUrl !== normalizedBaseUrl) {
-    await gitConfig(dir, ["config", `credential.${rawBaseUrl}.helper`, helper]);
+    await writeHelperWithReset(`credential.${rawBaseUrl}.helper`);
   }
   debugLog("memfs-git", `Configured local credential helper for ${normalizedBaseUrl}${rawBaseUrl !== normalizedBaseUrl ? ` (and raw ${rawBaseUrl})` : ""}`);
 }
@@ -379215,6 +379285,7 @@ function isEncryptedContentError(e2) {
 function formatErrorDetails2(e2, agentId, conversationId, options3 = {}) {
   let runId;
   const surface = options3.surface ?? "terminal";
+  const fallback = (raw) => options3.unclassifiedFallback === "generic" ? GENERIC_ERROR_MESSAGE : raw;
   const encryptedContentMsg = checkEncryptedContentError(e2);
   if (encryptedContentMsg)
     return encryptedContentMsg;
@@ -379303,6 +379374,8 @@ Detail: ${detail}` : "";
         const conversationBusyMessage = formatConversationBusyErrorForDisplay(baseError, runId, options3);
         if (conversationBusyMessage)
           return conversationBusyMessage;
+        if (options3.unclassifiedFallback === "generic")
+          return fallback(baseError);
         return runId && agentId ? `${baseError}
 ${createAgentLink(runId, agentId, conversationId, surface)}` : baseError;
       }
@@ -379316,32 +379389,34 @@ ${createAgentLink(runId, agentId, conversationId, surface)}` : baseError;
       const conversationBusyMessage = formatConversationBusyErrorForDisplay(baseError, runId, options3);
       if (conversationBusyMessage)
         return conversationBusyMessage;
+      if (options3.unclassifiedFallback === "generic")
+        return fallback(baseError);
       return runId && agentId ? `${baseError}
 ${createAgentLink(runId, agentId, conversationId, surface)}` : baseError;
     }
-    return e2.message;
+    return fallback(e2.message);
   }
   if (e2 instanceof Error) {
-    return e2.message;
+    return fallback(e2.message);
   }
   if (typeof e2 === "object" && e2 !== null) {
     const obj = e2;
     if (typeof obj.message === "string") {
-      return obj.message;
+      return fallback(obj.message);
     }
     if (typeof obj.error === "string") {
-      return obj.error;
+      return fallback(obj.error);
     }
     if (typeof obj.detail === "string") {
-      return obj.detail;
+      return fallback(obj.detail);
     }
     try {
-      return JSON.stringify(e2, null, 2);
+      return fallback(JSON.stringify(e2, null, 2));
     } catch {
-      return "[Error: Unable to serialize error object]";
+      return fallback("[Error: Unable to serialize error object]");
     }
   }
-  return String(e2);
+  return fallback(String(e2));
 }
 function getRetryStatusMessage(errorDetail2) {
   if (!errorDetail2)
@@ -379373,7 +379448,7 @@ function createAgentLink(runId, agentId, conversationId, surface) {
   const agentRef = surface === "terminal" ? buildAgentTerminalLink(agentId, { conversationId }) : agentId;
   return `View agent: ${agentRef} (run: ${runId})`;
 }
-var LETTA_USAGE_URL, LETTA_AGENTS_URL, CLOUDFLARE_EDGE_5XX_MARKER_PATTERN, CLOUDFLARE_EDGE_5XX_TITLE_PATTERN, CLOUDFLARE_EDGE_5XX_FORMATTED_PATTERN, CLOUDFLARE_JSON_5XX_PATTERN, CHATGPT_USAGE_LIMIT_HINT = "Switch models with /model, or connect your own provider keys with /connect.", ENCRYPTED_CONTENT_HINT, DEFAULT_RETRY_MESSAGE = "Unexpected downstream LLM API error, retrying...", ENDPOINT_TYPE_DISPLAY_NAMES;
+var LETTA_USAGE_URL, LETTA_AGENTS_URL, GENERIC_ERROR_MESSAGE = "The request failed. Please try again.", CLOUDFLARE_EDGE_5XX_MARKER_PATTERN, CLOUDFLARE_EDGE_5XX_TITLE_PATTERN, CLOUDFLARE_EDGE_5XX_FORMATTED_PATTERN, CLOUDFLARE_JSON_5XX_PATTERN, CHATGPT_USAGE_LIMIT_HINT = "Switch models with /model, or connect your own provider keys with /connect.", ENCRYPTED_CONTENT_HINT, DEFAULT_RETRY_MESSAGE = "Unexpected downstream LLM API error, retrying...", ENDPOINT_TYPE_DISPLAY_NAMES;
 var init_error_formatter = __esm(() => {
   init_error();
   init_conversation_busy_error();
@@ -380797,7 +380872,10 @@ function createLocalEndpointPiProvider(options3) {
         name: `${options3.name} API key`,
         resolve: async ({ credential }) => {
           const apiKey = credential?.key ?? options3.apiKey;
-          return apiKey ? { auth: { apiKey }, source: "local provider record" } : undefined;
+          return apiKey ? {
+            auth: apiKey === "not-needed" ? { apiKey, headers: { Authorization: null } } : { apiKey },
+            source: "local provider record"
+          } : undefined;
         }
       }
     },
@@ -381158,6 +381236,27 @@ var init_pi_ollama_provider = __esm(() => {
   init_pi_local_endpoint_provider();
 });
 
+// src/backend/dev/pi-openai-compatible-provider.ts
+function createOpenAICompatiblePiProvider(options3) {
+  return createLocalEndpointPiProvider({
+    id: OPENAI_COMPATIBLE_PI_PROVIDER_ID,
+    name: "OpenAI-compatible API",
+    baseURL: options3.baseURL,
+    ...options3.apiKey ? { apiKey: options3.apiKey } : {},
+    ...options3.fetchImpl ? { fetchImpl: options3.fetchImpl } : {},
+    ...options3.discoveryTimeoutMs ? { discoveryTimeoutMs: options3.discoveryTimeoutMs } : {},
+    discover: openAICompatibleDiscover
+  });
+}
+var openAICompatibleDiscover = async (context3) => {
+  const list = await context3.fetchJson(`${context3.openAIBaseURL}/models`);
+  return modelIdsFromOpenAICompatibleList(list).map((modelId) => context3.lastKnown.get(modelId) ?? context3.buildModel({ id: modelId }));
+};
+var init_pi_openai_compatible_provider = __esm(() => {
+  init_pi_local_endpoint_provider();
+  init_pi_provider_registry();
+});
+
 // src/backend/dev/pi-models-runtime.ts
 function aliasedAuthContext() {
   const base2 = defaultProviderAuthContext();
@@ -381185,7 +381284,7 @@ function resolveLocalEndpointConnection(providerId2, storageDir) {
       break;
   }
   const baseURL = record5?.base_url ?? spec.baseUrlEnv?.() ?? spec.defaultBaseURL ?? "";
-  const apiKey = localProviderApiKeyFromRecord(record5) ?? spec.apiKeyEnv?.() ?? spec.fallbackApiKey;
+  const apiKey = localProviderApiKeyFromRecord(record5) ?? spec.apiKeyEnv?.() ?? (record5 !== null || spec.autoDetectLocalEndpoint === true ? spec.fallbackApiKey : undefined);
   return {
     baseURL,
     apiKey,
@@ -381424,6 +381523,7 @@ var init_pi_models_runtime = __esm(() => {
   init_pi_lmstudio_provider();
   init_pi_mod_provider();
   init_pi_ollama_provider();
+  init_pi_openai_compatible_provider();
   init_pi_provider_mod_registry();
   init_pi_provider_registry();
   init_registered_pi_provider_runtime();
@@ -381440,7 +381540,11 @@ var init_pi_models_runtime = __esm(() => {
       })
     ],
     [LLAMA_CPP_PI_PROVIDER_ID, (input) => createLlamaCppPiProvider(input)],
-    [LMSTUDIO_PI_PROVIDER_ID, (input) => createLmStudioPiProvider(input)]
+    [LMSTUDIO_PI_PROVIDER_ID, (input) => createLmStudioPiProvider(input)],
+    [
+      OPENAI_COMPATIBLE_PI_PROVIDER_ID,
+      (input) => createOpenAICompatiblePiProvider(input)
+    ]
   ]);
 });
 
@@ -381674,7 +381778,10 @@ async function resolvePiModelForAgent(modelHandle, modelSettings = {}, options3
   }
   const fallbackModelId = !registeredProvider && spec?.piProvider ? fallbackCatalogModelId(spec.piProvider, modelId) : undefined;
   const { model: publishedModel, auth: authResult } = await modelsRuntime.resolveTurn(runtimeProviderId, modelId, fallbackModelId);
-  connection = { ...connection, apiKey: authResult?.auth.apiKey };
+  connection = {
+    ...connection,
+    apiKey: authResult?.auth.apiKey === LOCAL_PROVIDER_NO_API_KEY ? undefined : authResult?.auth.apiKey
+  };
   if (authResult?.auth.baseUrl)
     baseURL = authResult.auth.baseUrl;
   if (authResult?.auth.headers) {
@@ -384635,10 +384742,12 @@ function isResumedConversation(conversation) {
 function approvalRequestsFromMessage(messageToCheck) {
   const approvalMsg = messageToCheck;
   const toolCalls = Array.isArray(approvalMsg.tool_calls) ? approvalMsg.tool_calls : approvalMsg.tool_call ? [approvalMsg.tool_call] : [];
+  const messageId = "id" in messageToCheck && typeof messageToCheck.id === "string" ? messageToCheck.id : undefined;
   return toolCalls.filter((tc) => !!tc && !!tc.tool_call_id).map((tc) => ({
     toolCallId: tc.tool_call_id,
     toolName: tc.name || "",
-    toolArgs: tc.arguments || ""
+    toolArgs: tc.arguments || "",
+    ...messageId ? { messageId } : {}
   }));
 }
 function logPendingApprovals(pendingApprovals) {
@@ -426741,6 +426850,9 @@ function isNullableString4(value) {
 function isBoolean3(value) {
   return value === true || value === false;
 }
+function isStringArray5(value) {
+  return Array.isArray(value) && value.every(isString3);
+}
 function isDefaultPermissionMode2(value) {
   return value === "standard" || value === "acceptEdits" || value === "unrestricted" || value === "default" || value === "bypassPermissions" || value === "fullAccess";
 }
@@ -426757,6 +426869,7 @@ var init_account_config4 = __esm(() => {
     "transcribe_voice",
     "show_completed_reaction",
     "listen_mode",
+    "mention_only_channels",
     "allow_bots"
   ]);
   slackAccountConfigAdapter = {
@@ -426766,7 +426879,7 @@ var init_account_config4 = __esm(() => {
           return false;
         }
       }
-      return (config3.bot_token === undefined || isString3(config3.bot_token)) && (config3.app_token === undefined || isString3(config3.app_token)) && (config3.mode === undefined || config3.mode === "socket") && (config3.agent_id === undefined || isNullableString4(config3.agent_id)) && (config3.default_permission_mode === undefined || isDefaultPermissionMode2(config3.default_permission_mode)) && (config3.transcribe_voice === undefined || isBoolean3(config3.transcribe_voice)) && (config3.show_completed_reaction === undefined || isBoolean3(config3.show_completed_reaction)) && (config3.listen_mode === undefined || isBoolean3(config3.listen_mode)) && isValidSlackAllowBotsConfigValue(config3.allow_bots);
+      return (config3.bot_token === undefined || isString3(config3.bot_token)) && (config3.app_token === undefined || isString3(config3.app_token)) && (config3.mode === undefined || config3.mode === "socket") && (config3.agent_id === undefined || isNullableString4(config3.agent_id)) && (config3.default_permission_mode === undefined || isDefaultPermissionMode2(config3.default_permission_mode)) && (config3.transcribe_voice === undefined || isBoolean3(config3.transcribe_voice)) && (config3.show_completed_reaction === undefined || isBoolean3(config3.show_completed_reaction)) && (config3.listen_mode === undefined || isBoolean3(config3.listen_mode)) && (config3.mention_only_channels === undefined || isStringArray5(config3.mention_only_channels)) && isValidSlackAllowBotsConfigValue(config3.allow_bots);
     },
     toAccountPatch(config3) {
       return {
@@ -426777,6 +426890,7 @@ var init_account_config4 = __esm(() => {
         defaultPermissionMode: isDefaultPermissionMode2(config3.default_permission_mode) ? migratePermissionMode(config3.default_permission_mode) : undefined,
         transcribeVoice: isBoolean3(config3.transcribe_voice) ? config3.transcribe_voice : undefined,
         listenMode: isBoolean3(config3.listen_mode) ? config3.listen_mode : undefined,
+        mentionOnlyChannels: isStringArray5(config3.mention_only_channels) ? [...config3.mention_only_channels] : undefined,
         allowBots: config3.allow_bots !== undefined && isValidSlackAllowBotsConfigValue(config3.allow_bots) ? normalizeSlackAllowBotsMode(config3.allow_bots) : undefined
       };
     },
@@ -426789,6 +426903,7 @@ var init_account_config4 = __esm(() => {
         default_permission_mode: account.defaultPermissionMode ?? DEFAULT_SLACK_PERMISSION_MODE,
         transcribe_voice: account.transcribeVoice === true,
         listen_mode: account.listenMode === true,
+        mention_only_channels: [...account.mentionOnlyChannels ?? []],
         allow_bots: account.allowBots ?? false
       };
     },
@@ -426801,6 +426916,7 @@ var init_account_config4 = __esm(() => {
         default_permission_mode: account.defaultPermissionMode ?? DEFAULT_SLACK_PERMISSION_MODE,
         transcribe_voice: account.transcribeVoice === true,
         listen_mode: account.listenMode === true,
+        mention_only_channels: [...account.mentionOnlyChannels ?? []],
         allow_bots: account.allowBots ?? false
       };
     },
@@ -426890,7 +427006,7 @@ function isNullableString5(value) {
 function isBoolean5(value) {
   return typeof value === "boolean";
 }
-function isStringArray5(value) {
+function isStringArray6(value) {
   return Array.isArray(value) && value.every((entry) => typeof entry === "string");
 }
 function isGroupMode3(value) {
@@ -426936,22 +427052,22 @@ var init_account_config6 = __esm(() => {
           return false;
         }
       }
-      return (config3.agent_id === undefined || isNullableString5(config3.agent_id)) && (config3.self_chat_mode === undefined || isBoolean5(config3.self_chat_mode)) && (config3.group_mode === undefined || isGroupMode3(config3.group_mode)) && (config3.allowed_groups === undefined || isStringArray5(config3.allowed_groups)) && (config3.mention_patterns === undefined || isStringArray5(config3.mention_patterns)) && (config3.transcribe_voice === undefined || isBoolean5(config3.transcribe_voice)) && (config3.download_media === undefined || isBoolean5(config3.download_media)) && (config3.media_max_bytes === undefined || isPositiveNumber2(config3.media_max_bytes)) && (config3.attachment_filter === undefined || isBoolean5(config3.attachment_filter)) && (config3.attachment_mime_types === undefined || isStringArray5(config3.attachment_mime_types)) && (config3.attachment_allowed_recipients === undefined || isStringArray5(config3.attachment_allowed_recipients)) && (config3.attachment_allowed_paths === undefined || isStringArray5(config3.attachment_allowed_paths)) && (config3.attachment_path_recursive === undefined || isBoolean5(config3.attachment_path_recursive)) && (config3.inbound_debounce_ms === undefined || isValidInboundDebounceMs(config3.inbound_debounce_ms)) && (config3.waiting_behavior === undefined || isWaitingBehavior(config3.waiting_behavior)) && (config3.message_prefix === undefined || isString5(config3.message_prefix));
+      return (config3.agent_id === undefined || isNullableString5(config3.agent_id)) && (config3.self_chat_mode === undefined || isBoolean5(config3.self_chat_mode)) && (config3.group_mode === undefined || isGroupMode3(config3.group_mode)) && (config3.allowed_groups === undefined || isStringArray6(config3.allowed_groups)) && (config3.mention_patterns === undefined || isStringArray6(config3.mention_patterns)) && (config3.transcribe_voice === undefined || isBoolean5(config3.transcribe_voice)) && (config3.download_media === undefined || isBoolean5(config3.download_media)) && (config3.media_max_bytes === undefined || isPositiveNumber2(config3.media_max_bytes)) && (config3.attachment_filter === undefined || isBoolean5(config3.attachment_filter)) && (config3.attachment_mime_types === undefined || isStringArray6(config3.attachment_mime_types)) && (config3.attachment_allowed_recipients === undefined || isStringArray6(config3.attachment_allowed_recipients)) && (config3.attachment_allowed_paths === undefined || isStringArray6(config3.attachment_allowed_paths)) && (config3.attachment_path_recursive === undefined || isBoolean5(config3.attachment_path_recursive)) && (config3.inbound_debounce_ms === undefined || isValidInboundDebounceMs(config3.inbound_debounce_ms)) && (config3.waiting_behavior === undefined || isWaitingBehavior(config3.waiting_behavior)) && (config3.message_prefix === undefined || isString5(config3.message_prefix));
     },
     toAccountPatch(config3) {
       return {
         agentId: isNullableString5(config3.agent_id) ? config3.agent_id : undefined,
         selfChatMode: isBoolean5(config3.self_chat_mode) ? config3.self_chat_mode : undefined,
         groupMode: isGroupMode3(config3.group_mode) ? config3.group_mode : undefined,
-        allowedGroups: isStringArray5(config3.allowed_groups) ? [...config3.allowed_groups] : undefined,
-        mentionPatterns: isStringArray5(config3.mention_patterns) ? [...config3.mention_patterns] : undefined,
+        allowedGroups: isStringArray6(config3.allowed_groups) ? [...config3.allowed_groups] : undefined,
+        mentionPatterns: isStringArray6(config3.mention_patterns) ? [...config3.mention_patterns] : undefined,
         transcribeVoice: isBoolean5(config3.transcribe_voice) ? config3.transcribe_voice : undefined,
         downloadMedia: isBoolean5(config3.download_media) ? config3.download_media : undefined,
         mediaMaxBytes: isPositiveNumber2(config3.media_max_bytes) ? config3.media_max_bytes : undefined,
         attachmentFilter: isBoolean5(config3.attachment_filter) ? config3.attachment_filter : undefined,
-        attachmentMimeTypes: isStringArray5(config3.attachment_mime_types) ? [...config3.attachment_mime_types] : undefined,
-        attachmentAllowedRecipients: isStringArray5(config3.attachment_allowed_recipients) ? [...config3.attachment_allowed_recipients] : undefined,
-        attachmentAllowedPaths: isStringArray5(config3.attachment_allowed_paths) ? [...config3.attachment_allowed_paths] : undefined,
+        attachmentMimeTypes: isStringArray6(config3.attachment_mime_types) ? [...config3.attachment_mime_types] : undefined,
+        attachmentAllowedRecipients: isStringArray6(config3.attachment_allowed_recipients) ? [...config3.attachment_allowed_recipients] : undefined,
+        attachmentAllowedPaths: isStringArray6(config3.attachment_allowed_paths) ? [...config3.attachment_allowed_paths] : undefined,
         attachmentPathRecursive: isBoolean5(config3.attachment_path_recursive) ? config3.attachment_path_recursive : undefined,
         inboundDebounceMs: isValidInboundDebounceMs(config3.inbound_debounce_ms) ? Math.trunc(Math.min(config3.inbound_debounce_ms, 1e4)) : undefined,
         waitingBehavior: isWaitingBehavior(config3.waiting_behavior) ? config3.waiting_behavior : undefined,
@@ -427307,6 +427423,7 @@ function createAccountFromPatch(channelId, accountId, patch2) {
     defaultPermissionMode: normalizedPatch.defaultPermissionMode ?? DEFAULT_SLACK_PERMISSION_MODE,
     transcribeVoice: normalizedPatch.transcribeVoice === true,
     listenMode: normalizedPatch.listenMode === true,
+    mentionOnlyChannels: [...normalizedPatch.mentionOnlyChannels ?? []],
     allowBots: normalizedPatch.allowBots ?? false,
     dmPolicy: normalizedPatch.dmPolicy ?? "open",
     allowedUsers: normalizedPatch.allowedUsers ?? [],
@@ -427423,6 +427540,9 @@ function mergeAccountPatch(existing, patch2) {
     defaultPermissionMode: normalizedPatch.defaultPermissionMode ?? existing.defaultPermissionMode ?? DEFAULT_SLACK_PERMISSION_MODE,
     transcribeVoice: normalizedPatch.transcribeVoice ?? existing.transcribeVoice ?? false,
     listenMode: normalizedPatch.listenMode ?? existing.listenMode ?? false,
+    mentionOnlyChannels: [
+      ...normalizedPatch.mentionOnlyChannels ?? existing.mentionOnlyChannels ?? []
+    ],
     allowBots: normalizedPatch.allowBots ?? existing.allowBots ?? false,
     dmPolicy: normalizedPatch.dmPolicy ?? existing.dmPolicy,
     allowedUsers: normalizedPatch.allowedUsers ?? existing.allowedUsers,
@@ -427616,6 +427736,7 @@ function toAccountSnapshot(account) {
     defaultPermissionMode: account.defaultPermissionMode ?? DEFAULT_SLACK_PERMISSION_MODE,
     transcribeVoice: account.transcribeVoice === true,
     listenMode: account.listenMode === true,
+    mentionOnlyChannels: [...account.mentionOnlyChannels ?? []],
     allowBots: account.allowBots ?? false,
     createdAt: account.createdAt,
     updatedAt: account.updatedAt
@@ -427776,6 +427897,7 @@ function getChannelConfigSnapshot(channelId, accountId) {
     defaultPermissionMode: account.defaultPermissionMode ?? DEFAULT_SLACK_PERMISSION_MODE,
     transcribeVoice: account.transcribeVoice === true,
     listenMode: account.listenMode === true,
+    mentionOnlyChannels: [...account.mentionOnlyChannels ?? []],
     allowBots: account.allowBots ?? false
   };
 }
@@ -428299,6 +428421,7 @@ async function setChannelConfigLive(channelId, patch2, accountId) {
       threadPolicyByChannel: normalizedPatch.threadPolicyByChannel,
       acknowledgeMessageReaction: normalizedPatch.acknowledgeMessageReaction,
       listenMode: normalizedPatch.listenMode,
+      mentionOnlyChannels: normalizedPatch.mentionOnlyChannels,
       allowBots: normalizedPatch.allowBots,
       removeStaleRoutes: normalizedPatch.removeStaleRoutes,
       inboundDebounceMs: normalizedPatch.inboundDebounceMs,
@@ -428336,6 +428459,7 @@ async function setChannelConfigLive(channelId, patch2, accountId) {
       threadPolicyByChannel: normalizedPatch.threadPolicyByChannel,
       acknowledgeMessageReaction: normalizedPatch.acknowledgeMessageReaction,
       listenMode: normalizedPatch.listenMode,
+      mentionOnlyChannels: normalizedPatch.mentionOnlyChannels,
       allowBots: normalizedPatch.allowBots,
       removeStaleRoutes: normalizedPatch.removeStaleRoutes,
       inboundDebounceMs: normalizedPatch.inboundDebounceMs,
@@ -429992,6 +430116,9 @@ function isConnectOAuthProvider(provider) {
 function isConnectBedrockProvider(provider) {
   return provider.byokProvider.providerType === "bedrock" || provider.byokProvider.providerType === "amazon-bedrock";
 }
+function isConnectBaseURLRequired(provider) {
+  return provider.byokProvider.fields?.some((field) => field.key === "baseUrl" && field.required !== false) === true;
+}
 function isConnectApiKeyProvider(provider) {
   return !isConnectOAuthProvider(provider) && !isConnectBedrockProvider(provider);
 }
@@ -430049,6 +430176,7 @@ function formatUsage() {
     "  letta connect codex --method device-code",
     "  letta connect anthropic <api_key>",
     "  letta connect openai --api-key <api_key>",
+    "  letta connect openai-compatible --base-url http://localhost:8000/v1 [--api-key <api_key>]",
     "  letta connect ollama --base-url http://192.168.1.50:11434/v1",
     "  letta connect lmstudio --base-url http://127.0.0.1:1234/v1 --timeout 600s",
     "  letta connect llama-cpp --base-url http://localhost:8080/v1",
@@ -430262,6 +430390,10 @@ Provider '${providerName}' saved.`);
       io.stderr(getErrorMessage2(error54));
       return 1;
     }
+    if (isConnectBaseURLRequired(provider) && !connectionOptions.baseURL?.trim()) {
+      io.stderr(`Missing base URL for ${provider.canonical}. Pass --base-url <url>.`);
+      return 1;
+    }
     apiKey ||= defaultConnectApiKey(provider) ?? "";
     if (!apiKey && isConnectZaiBaseProvider(provider)) {
       io.stdout(`Do you have a Z.ai Coding plan?
@@ -438839,6 +438971,100 @@ var init_cron = __esm(async () => {
   await init_scheduler();
 });
 
+// src/backend/api/environments.ts
+var exports_environments2 = {};
+__export(exports_environments2, {
+  sendEnvironmentMessage: () => sendEnvironmentMessage,
+  resolveEnvironmentConnectionId: () => resolveEnvironmentConnectionId,
+  resolveAgentSandboxConnectionId: () => resolveAgentSandboxConnectionId,
+  listEnvironments: () => listEnvironments,
+  isEnvironmentOnline: () => isEnvironmentOnline,
+  getEnvironmentConnection: () => getEnvironmentConnection,
+  describeEnvironment: () => describeEnvironment,
+  createAgentSandbox: () => createAgentSandbox
+});
+async function listEnvironments(options3 = {}) {
+  return apiRequest("GET", "/v1/environments", undefined, {
+    query: {
+      limit: options3.limit,
+      after: options3.after,
+      onlineOnly: options3.onlineOnly
+    }
+  });
+}
+async function sendEnvironmentMessage(connectionId, body3) {
+  return apiRequest("POST", `/v1/environments/${encodeURIComponent(connectionId)}/messages`, body3);
+}
+async function getEnvironmentConnection(deviceId) {
+  return apiRequest("GET", `/v1/environments/${encodeURIComponent(deviceId)}`);
+}
+async function createAgentSandbox(agentId) {
+  return apiRequest("POST", `/v1/agents/${encodeURIComponent(agentId)}/sandboxes`, {});
+}
+function isEnvironmentOnline(environment2) {
+  return typeof environment2.connectionId === "string" && environment2.connectionId.length > 0 && typeof environment2.lastHeartbeat === "number" && Date.now() - environment2.lastHeartbeat < 120000;
+}
+function describeEnvironment(environment2) {
+  const status = isEnvironmentOnline(environment2) ? "online" : "offline";
+  return `${environment2.connectionName} (${environment2.deviceId}, ${status})`;
+}
+async function resolveEnvironmentConnectionId(selector) {
+  const trimmed = selector.trim();
+  if (!trimmed) {
+    throw new Error("Environment selector must not be empty");
+  }
+  const response = await listEnvironments({ limit: 100 });
+  const matches2 = response.connections.filter((environment3) => {
+    return environment3.connectionId === trimmed || environment3.id === trimmed || environment3.deviceId === trimmed || environment3.connectionName === trimmed;
+  });
+  if (matches2.length === 0) {
+    throw new Error(`Environment "${trimmed}" not found. Run \`letta environments list\` to discover available environments.`);
+  }
+  const onlineMatches = matches2.filter(isEnvironmentOnline);
+  if (onlineMatches.length === 0) {
+    throw new Error(`Environment "${trimmed}" is offline. Matched: ${matches2.map(describeEnvironment).join(", ")}`);
+  }
+  if (onlineMatches.length > 1) {
+    throw new Error(`Environment "${trimmed}" is ambiguous. Matched: ${onlineMatches.map(describeEnvironment).join(", ")}`);
+  }
+  const environment2 = onlineMatches[0];
+  if (!environment2) {
+    throw new Error(`Environment "${trimmed}" is offline`);
+  }
+  if (!environment2.connectionId) {
+    throw new Error(`Environment "${trimmed}" has no active connection id`);
+  }
+  return { connectionId: environment2.connectionId, environment: environment2 };
+}
+async function resolveAgentSandboxConnectionId(agentId, options3 = {}) {
+  const timeoutMs = options3.timeoutMs ?? 3 * 60000;
+  const pollIntervalMs = options3.pollIntervalMs ?? 2000;
+  const sandbox = await createAgentSandbox(agentId);
+  const deviceId = sandbox.deviceId || `sandbox-${agentId}`;
+  const deadline = Date.now() + timeoutMs;
+  let lastEnvironment = null;
+  let lastError = null;
+  while (Date.now() < deadline) {
+    try {
+      const environment2 = await getEnvironmentConnection(deviceId);
+      lastEnvironment = environment2;
+      if (isEnvironmentOnline(environment2) && environment2.connectionId) {
+        return { connectionId: environment2.connectionId, environment: environment2 };
+      }
+    } catch (error54) {
+      lastError = error54;
+    }
+    await new Promise((resolve31) => setTimeout(resolve31, pollIntervalMs));
+  }
+  if (lastEnvironment) {
+    throw new Error(`Timed out waiting for cloud sandbox ${sandbox.connectionName} to come online. Last status: ${describeEnvironment(lastEnvironment)}`);
+  }
+  throw new Error(`Timed out waiting for cloud sandbox ${sandbox.connectionName} to register${lastError instanceof Error ? `: ${lastError.message}` : ""}`);
+}
+var init_environments2 = __esm(() => {
+  init_request();
+});
+
 // src/cli/subcommands/cron-runner.ts
 function isLocalAgent(agentId) {
   return agentId.startsWith("agent-local-");
@@ -438881,7 +439107,7 @@ function validateTargetDevice(deviceId, environment2) {
   if (deviceId === SYNTHETIC_CLOUD_DEVICE_ID) {
     return {
       ok: false,
-      error: `"Cloud" is the default execution target, not a computer. Omit --computer to run in the agent's cloud sandbox.`
+      error: `"Cloud" is not a computer. Pass --runner cloud to run in the agent's Cloud sandbox.`
     };
   }
   if (deviceId === SYNTHETIC_LOCAL_PLACEHOLDER_ID) {
@@ -438898,6 +439124,32 @@ function validateTargetDevice(deviceId, environment2) {
   }
   return { ok: true };
 }
+async function resolveInferredTargetDevice(deviceId, lookupEnvironment) {
+  if (deviceId.startsWith("sandbox-")) {
+    return { kind: "cloud-sandbox" };
+  }
+  const environment2 = await lookupEnvironment();
+  const basicValidity = validateTargetDevice(deviceId, environment2);
+  if (!basicValidity.ok) {
+    return {
+      kind: "local-fallback",
+      reason: "this computer is not connected to your Letta account"
+    };
+  }
+  if (!environment2) {
+    return {
+      kind: "local-fallback",
+      reason: "this computer is not connected to your Letta account"
+    };
+  }
+  if (!isEnvironmentOnline(environment2)) {
+    return {
+      kind: "local-fallback",
+      reason: "this computer's connection to Letta is not currently online"
+    };
+  }
+  return { kind: "device" };
+}
 function buildCloudScheduleInput(params) {
   const notes = [];
   let schedule;
@@ -438928,6 +439180,9 @@ function buildCloudScheduleInput(params) {
   };
 }
 var CLOUD_EXECUTION_TARGET = "cloud-sandbox", SYNTHETIC_CLOUD_DEVICE_ID = "__letta_cloud__", SYNTHETIC_LOCAL_PLACEHOLDER_ID = "local", CLOUD_CRON_UTC_NOTE = "Recurring Cloud schedules currently interpret cron expressions in UTC (timezone support is tracked in LET-9815).", CLOUD_DEVICE_FALLBACK_NOTE = "If the target computer is offline when the schedule fires, execution falls back to the agent's cloud sandbox.";
+var init_cron_runner = __esm(() => {
+  init_environments2();
+});
 
 // src/cli/subcommands/cron-task-ref.ts
 async function ensureSettingsForCloud() {
@@ -438977,103 +439232,10 @@ function printAmbiguousTaskName(name, matches2) {
 var init_cron_task_ref = __esm(async () => {
   init_schedules2();
   init_backend_mode();
+  init_cron_runner();
   await init_cron();
 });
 
-// src/backend/api/environments.ts
-var exports_environments2 = {};
-__export(exports_environments2, {
-  sendEnvironmentMessage: () => sendEnvironmentMessage,
-  resolveEnvironmentConnectionId: () => resolveEnvironmentConnectionId,
-  resolveAgentSandboxConnectionId: () => resolveAgentSandboxConnectionId,
-  listEnvironments: () => listEnvironments,
-  isEnvironmentOnline: () => isEnvironmentOnline,
-  getEnvironmentConnection: () => getEnvironmentConnection,
-  describeEnvironment: () => describeEnvironment,
-  createAgentSandbox: () => createAgentSandbox
-});
-async function listEnvironments(options3 = {}) {
-  return apiRequest("GET", "/v1/environments", undefined, {
-    query: {
-      limit: options3.limit,
-      after: options3.after,
-      onlineOnly: options3.onlineOnly
-    }
-  });
-}
-async function sendEnvironmentMessage(connectionId, body3) {
-  return apiRequest("POST", `/v1/environments/${encodeURIComponent(connectionId)}/messages`, body3);
-}
-async function getEnvironmentConnection(deviceId) {
-  return apiRequest("GET", `/v1/environments/${encodeURIComponent(deviceId)}`);
-}
-async function createAgentSandbox(agentId) {
-  return apiRequest("POST", `/v1/agents/${encodeURIComponent(agentId)}/sandboxes`, {});
-}
-function isEnvironmentOnline(environment2) {
-  return typeof environment2.connectionId === "string" && environment2.connectionId.length > 0 && typeof environment2.lastHeartbeat === "number" && Date.now() - environment2.lastHeartbeat < 120000;
-}
-function describeEnvironment(environment2) {
-  const status = isEnvironmentOnline(environment2) ? "online" : "offline";
-  return `${environment2.connectionName} (${environment2.deviceId}, ${status})`;
-}
-async function resolveEnvironmentConnectionId(selector) {
-  const trimmed = selector.trim();
-  if (!trimmed) {
-    throw new Error("Environment selector must not be empty");
-  }
-  const response = await listEnvironments({ limit: 100 });
-  const matches2 = response.connections.filter((environment3) => {
-    return environment3.connectionId === trimmed || environment3.id === trimmed || environment3.deviceId === trimmed || environment3.connectionName === trimmed;
-  });
-  if (matches2.length === 0) {
-    throw new Error(`Environment "${trimmed}" not found. Run \`letta environments list\` to discover available environments.`);
-  }
-  const onlineMatches = matches2.filter(isEnvironmentOnline);
-  if (onlineMatches.length === 0) {
-    throw new Error(`Environment "${trimmed}" is offline. Matched: ${matches2.map(describeEnvironment).join(", ")}`);
-  }
-  if (onlineMatches.length > 1) {
-    throw new Error(`Environment "${trimmed}" is ambiguous. Matched: ${onlineMatches.map(describeEnvironment).join(", ")}`);
-  }
-  const environment2 = onlineMatches[0];
-  if (!environment2) {
-    throw new Error(`Environment "${trimmed}" is offline`);
-  }
-  if (!environment2.connectionId) {
-    throw new Error(`Environment "${trimmed}" has no active connection id`);
-  }
-  return { connectionId: environment2.connectionId, environment: environment2 };
-}
-async function resolveAgentSandboxConnectionId(agentId, options3 = {}) {
-  const timeoutMs = options3.timeoutMs ?? 3 * 60000;
-  const pollIntervalMs = options3.pollIntervalMs ?? 2000;
-  const sandbox = await createAgentSandbox(agentId);
-  const deviceId = sandbox.deviceId || `sandbox-${agentId}`;
-  const deadline = Date.now() + timeoutMs;
-  let lastEnvironment = null;
-  let lastError = null;
-  while (Date.now() < deadline) {
-    try {
-      const environment2 = await getEnvironmentConnection(deviceId);
-      lastEnvironment = environment2;
-      if (isEnvironmentOnline(environment2) && environment2.connectionId) {
-        return { connectionId: environment2.connectionId, environment: environment2 };
-      }
-    } catch (error54) {
-      lastError = error54;
-    }
-    await new Promise((resolve31) => setTimeout(resolve31, pollIntervalMs));
-  }
-  if (lastEnvironment) {
-    throw new Error(`Timed out waiting for cloud sandbox ${sandbox.connectionName} to come online. Last status: ${describeEnvironment(lastEnvironment)}`);
-  }
-  throw new Error(`Timed out waiting for cloud sandbox ${sandbox.connectionName} to register${lastError instanceof Error ? `: ${lastError.message}` : ""}`);
-}
-var init_environments2 = __esm(() => {
-  init_request();
-});
-
 // src/cli/subcommands/cron.ts
 import { parseArgs as parseArgs5 } from "node:util";
 function printUsage4() {
@@ -439096,18 +439258,25 @@ Add options:
   --cron <expr>          Raw 5-field cron expression
   --agent <id>           Agent ID (defaults to LETTA_AGENT_ID)
   --conversation <id>    Conversation ID (defaults to LETTA_CONVERSATION_ID or "default")
-  --runner <runner>      Where the schedule lives and fires:
-                           cloud - durable Cloud schedule; executes in the
-                                   agent's managed cloud sandbox (default for
-                                   cloud agents)
+  --runner <runner>      Where the schedule lives and fires (normally omit:
+                         the default keeps the schedule running where it was
+                         created):
+                           cloud - durable Cloud schedule (default for cloud
+                                   agents on Cloud-reachable runtimes:
+                                   external listeners are targeted, managed
+                                   sandboxes stay untargeted). Explicit
+                                   --runner cloud always uses the Cloud sandbox
                            local - this device's scheduler (~/.letta/crons.json);
                                    only fires while a session runs here (default
-                                   for local-backend agents / self-hosted)
-  --computer <id>        (cloud runner only) Execute on one of your
-                         connected computers (deviceId from
-                         \`letta environments list\`) instead of the agent's
-                         cloud sandbox. Falls back to the sandbox if the
-                         computer is offline at fire time.
+                                   for local-backend agents / self-hosted, and
+                                   the fallback when Cloud scheduling cannot
+                                   reach this computer)
+  --computer <id>        (cloud runner only) Override execution with a
+                         connected external environment (deviceId from
+                         \`letta environments list\`). Falls back to the Cloud
+                         sandbox if the computer is offline at fire time.
+                         Managed sandboxes and Desktop-local connections are
+                         not currently valid Cloud schedule targets.
 
 List/filter options:
   --agent <id>           Filter by agent ID
@@ -439270,13 +439439,15 @@ async function handleAdd(values2) {
     console.error("Error: no schedule specified.");
     return 1;
   }
-  const targetDeviceId = values2.computer?.trim() || undefined;
+  let targetDeviceId = values2.computer?.trim() || undefined;
   const resolved = await getRunnerForAgent(values2.runner, agentId);
   if ("error" in resolved) {
     console.error(`Error: ${resolved.error}`);
     return 1;
   }
-  if (targetDeviceId && resolved.runner !== "cloud") {
+  let runner = resolved.runner;
+  let localFallbackNote;
+  if (targetDeviceId && runner !== "cloud") {
     console.error("Error: --computer requires the cloud runner. Run `letta cron add` on the target computer itself (with --runner local) to schedule there locally.");
     return 1;
   }
@@ -439286,8 +439457,17 @@ async function handleAdd(values2) {
       console.error(`Error: ${validity.error}`);
       return 1;
     }
+  } else if (runner === "cloud" && values2.runner !== "cloud") {
+    const inferredDeviceId = getRuntimeEnvironmentDeviceId();
+    const resolution = await resolveInferredTargetDevice(inferredDeviceId, () => lookupEnvironmentForTarget(inferredDeviceId));
+    if (resolution.kind === "device") {
+      targetDeviceId = inferredDeviceId;
+    } else if (resolution.kind === "local-fallback") {
+      runner = "local";
+      localFallbackNote = `This schedule is local to this computer (${resolution.reason}): it only fires while a Letta session is running here. For a schedule that fires regardless, pass --runner cloud (runs in the agent's cloud sandbox) or --computer <deviceId> (runs on a connected computer, from \`letta environments list\`).`;
+    }
   }
-  if (resolved.runner === "cloud") {
+  if (runner === "cloud") {
     return handleCloudAdd({
       agentId,
       conversationId,
@@ -439331,8 +439511,10 @@ async function handleAdd(values2) {
     if (note) {
       output.note = note;
     }
-    if (result.warning) {
-      output.warning = result.warning;
+    const fallbackWarning = localFallbackNote && recurring ? `${localFallbackNote} Recurring schedules on an unregistered computer stop firing whenever no session is running — strongly consider a durable alternative.` : localFallbackNote;
+    const warnings = [fallbackWarning, result.warning].filter(Boolean);
+    if (warnings.length > 0) {
+      output.warning = warnings.join(" ");
     }
     console.log(JSON.stringify(output, null, 2));
     console.error("Created local schedule: it only fires while a Letta session is running on this device.");
@@ -439694,9 +439876,11 @@ async function runCronSubcommand(argv) {
 }
 var CRON_OPTIONS;
 var init_cron2 = __esm(async () => {
+  init_client2();
   init_request();
   init_schedules2();
   init_backend_mode();
+  init_cron_runner();
   await __promiseAll([
     init_cron(),
     init_cron_task_ref()
@@ -448016,6 +448200,9 @@ function rememberPendingApprovalBatchIds(runtime, pendingApprovals, batchId) {
   for (const approval of pendingApprovals) {
     if (approval.toolCallId) {
       runtime.pendingApprovalBatchByToolCallId.set(approval.toolCallId, batchId);
+      if (approval.messageId) {
+        runtime.approvalMessageIdByToolCallId.set(approval.toolCallId, approval.messageId);
+      }
     }
   }
 }
@@ -448042,6 +448229,7 @@ function resolveRecoveryBatchId(runtime, pendingApprovals) {
 function clearPendingApprovalBatchIds(runtime, approvals) {
   for (const approval of approvals) {
     runtime.pendingApprovalBatchByToolCallId.delete(approval.toolCallId);
+    runtime.approvalMessageIdByToolCallId.delete(approval.toolCallId);
   }
 }
 function isValidApprovalResponseBody(value) {
@@ -448335,13 +448523,13 @@ var init_channel_service_validation = __esm(() => {
 function isExperimentId(value) {
   return typeof value === "string" && EXPERIMENT_IDS.has(value);
 }
-function isStringArray6(value) {
+function isStringArray7(value) {
   return Array.isArray(value) && value.every((item) => typeof item === "string");
 }
 function isClientToolsetConfig(value) {
   if (!isObjectRecord2(value))
     return false;
-  return (value.base === undefined || typeof value.base === "string" && TOOLSET_PREFERENCES.has(value.base)) && (value.include === undefined || isStringArray6(value.include));
+  return (value.base === undefined || typeof value.base === "string" && TOOLSET_PREFERENCES.has(value.base)) && (value.include === undefined || isStringArray7(value.include));
 }
 function isStringRecord2(value) {
   return !!value && typeof value === "object" && !Array.isArray(value) && Object.values(value).every((item) => typeof item === "string");
@@ -448372,7 +448560,7 @@ function isInputCommand(value) {
   }
   const payload = candidate.payload;
   if (payload.kind === "create_message") {
-    return Array.isArray(payload.messages) && (payload.image_failure_mode === undefined || payload.image_failure_mode === "strict" || payload.image_failure_mode === "drop") && (payload.client_tool_allowlist === undefined || isStringArray6(payload.client_tool_allowlist)) && (payload.client_toolset === undefined || isClientToolsetConfig(payload.client_toolset)) && (payload.external_tool_scope_ids === undefined || isStringArray6(payload.external_tool_scope_ids)) && (payload.exclude_interactive_tools === undefined || typeof payload.exclude_interactive_tools === "boolean");
+    return Array.isArray(payload.messages) && (payload.image_failure_mode === undefined || payload.image_failure_mode === "strict" || payload.image_failure_mode === "drop") && (payload.client_tool_allowlist === undefined || isStringArray7(payload.client_tool_allowlist)) && (payload.client_toolset === undefined || isClientToolsetConfig(payload.client_toolset)) && (payload.external_tool_scope_ids === undefined || isStringArray7(payload.external_tool_scope_ids)) && (payload.exclude_interactive_tools === undefined || typeof payload.exclude_interactive_tools === "boolean");
   }
   if (payload.kind === "approval_response") {
     return isValidApprovalResponseBody(payload);
@@ -448397,9 +448585,9 @@ function legacyEnvironmentMessageToInputCommand(value) {
     payload: {
       kind: "create_message",
       messages: candidate.messages,
-      client_tool_allowlist: isStringArray6(candidate.clientToolAllowlist) ? candidate.clientToolAllowlist : undefined,
+      client_tool_allowlist: isStringArray7(candidate.clientToolAllowlist) ? candidate.clientToolAllowlist : undefined,
       client_toolset: isClientToolsetConfig(candidate.clientToolset) ? candidate.clientToolset : undefined,
-      external_tool_scope_ids: isStringArray6(candidate.externalToolScopeIds) ? candidate.externalToolScopeIds : undefined
+      external_tool_scope_ids: isStringArray7(candidate.externalToolScopeIds) ? candidate.externalToolScopeIds : undefined
     }
   };
 }
@@ -448431,7 +448619,7 @@ function getInvalidInputReason(value) {
         reason: "Protocol violation: input.payload.image_failure_mode must be strict or drop"
       };
     }
-    if (payload.client_tool_allowlist !== undefined && !isStringArray6(payload.client_tool_allowlist)) {
+    if (payload.client_tool_allowlist !== undefined && !isStringArray7(payload.client_tool_allowlist)) {
       return {
         runtime: candidate.runtime,
         reason: "Protocol violation: input.payload.client_tool_allowlist must be string[]"
@@ -448449,7 +448637,7 @@ function getInvalidInputReason(value) {
         reason: "Protocol violation: input.payload.exclude_interactive_tools must be boolean"
       };
     }
-    if (payload.external_tool_scope_ids !== undefined && !isStringArray6(payload.external_tool_scope_ids)) {
+    if (payload.external_tool_scope_ids !== undefined && !isStringArray7(payload.external_tool_scope_ids)) {
       return {
         runtime: candidate.runtime,
         reason: "Protocol violation: input.payload.external_tool_scope_ids must be string[]"
@@ -448811,7 +448999,7 @@ function isCreateAgentCommand(value) {
   if (!value || typeof value !== "object")
     return false;
   const c = value;
-  return c.type === "create_agent" && typeof c.request_id === "string" && (c.personality === "memo" || c.personality === "blank" || c.personality === "tutorial" || c.personality === "linus" || c.personality === "kawaii") && (c.model === undefined || typeof c.model === "string") && (c.tags === undefined || isStringArray6(c.tags)) && (c.pin_global === undefined || typeof c.pin_global === "boolean");
+  return c.type === "create_agent" && typeof c.request_id === "string" && (c.personality === "memo" || c.personality === "blank" || c.personality === "tutorial" || c.personality === "linus" || c.personality === "kawaii") && (c.model === undefined || typeof c.model === "string") && (c.tags === undefined || isStringArray7(c.tags)) && (c.pin_global === undefined || typeof c.pin_global === "boolean");
 }
 function isAgentListCommand(value) {
   if (!value || typeof value !== "object")
@@ -451068,6 +451256,7 @@ async function applyModelUpdateForRuntime(params) {
       conversationId,
       overrideModel: model.handle,
       overrideProviderType: providerTypeFromModelSettings3(modelSettings) ?? inferProviderTypeFromRegistryHandle(model.handle) ?? null,
+      modContext: createListenerAgentModContext(agentId),
       modAdapters,
       modEvents: createListenerModEvents(modAdapters)
     });
@@ -451140,6 +451329,7 @@ async function applyToolsetUpdateForRuntime(params) {
     const preparedToolContext = await prepareToolExecutionContextForScope({
       agentId,
       conversationId,
+      modContext: createListenerAgentModContext(agentId),
       modAdapters,
       modEvents: createListenerModEvents(modAdapters)
     });
@@ -452274,7 +452464,7 @@ function emitInterruptToolReturnMessage(socket, runtime, approvals, runId, uuidP
     emitCanonicalMessageDelta(socket, runtime, {
       type: "message",
       message_type: "tool_return_message",
-      id: `message-${uuidPrefix}-${crypto.randomUUID()}`,
+      id: `synthetic-${uuidPrefix}-${crypto.randomUUID()}`,
       date: new Date().toISOString(),
       run_id: resolvedRunId,
       status: toolReturn.status,
@@ -452298,8 +452488,10 @@ function emitInterruptToolReturnMessage(socket, runtime, approvals, runId, uuidP
 function emitToolExecutionStartedEvents(socket, runtime, params) {
   const toolCalls = params.toolCalls ?? (params.toolCallIds ?? []).map((toolCallId) => ({ toolCallId }));
   for (const toolCall of toolCalls) {
+    const messageId2 = runtime.approvalMessageIdByToolCallId.get(toolCall.toolCallId);
     const delta2 = {
       ...createLifecycleMessageBase("client_tool_start", params.runId),
+      ...messageId2 ? { id: messageId2 } : {},
       tool_call_id: toolCall.toolCallId,
       ...toolCall.toolName ? { tool_name: toolCall.toolName } : {},
       ...toolCall.toolArgs ? { tool_args: toolCall.toolArgs } : {}
@@ -452313,8 +452505,10 @@ function emitToolExecutionStartedEvents(socket, runtime, params) {
 function emitToolExecutionFinishedEvents(socket, runtime, params) {
   const toolReturns = extractInterruptToolReturns(params.approvals);
   for (const toolReturn of toolReturns) {
+    const messageId2 = runtime.approvalMessageIdByToolCallId.get(toolReturn.tool_call_id);
     const delta2 = {
       ...createLifecycleMessageBase("client_tool_end", params.runId),
+      ...messageId2 ? { id: messageId2 } : {},
       tool_call_id: toolReturn.tool_call_id,
       status: toolReturn.status
     };
@@ -452326,8 +452520,10 @@ function emitToolExecutionFinishedEvents(socket, runtime, params) {
 }
 function emitToolExecutionAbortedEvents(socket, runtime, params) {
   for (const toolCallId of params.toolCallIds) {
+    const messageId2 = runtime.approvalMessageIdByToolCallId.get(toolCallId);
     const delta2 = {
       ...createLifecycleMessageBase("client_tool_end", params.runId),
+      ...messageId2 ? { id: messageId2 } : {},
       tool_call_id: toolCallId,
       status: "error"
     };
@@ -452387,7 +452583,7 @@ function createToolExecutionOutputEmitter(socket, runtime, params) {
     }
     const existing = outputByToolCallId.get(toolCallId);
     const outputState = existing ?? {
-      messageId: `message-tool-return-stream-${toolCallId}`,
+      messageId: `synthetic-tool-return-stream-${toolCallId}`,
       stdout: "",
       stderr: "",
       dirty: false,
@@ -452655,13 +452851,24 @@ function getLoopErrorNoticeDecision(params) {
       apiError
     };
   }
-  const formattedMessage = formatErrorDetails2(apiError ? buildStructuredFormatInput(apiError) : params.error ?? params.message, params.agentId ?? undefined, params.conversationId ?? undefined);
+  const formattedMessage = formatErrorDetails2(apiError ? buildStructuredFormatInput(apiError) : params.error ?? params.message, params.agentId ?? undefined, params.conversationId ?? undefined, {
+    surface: params.surface,
+    unclassifiedFallback: params.unclassifiedFallback
+  });
   return {
     visibility: "transcript",
     message: formattedMessage,
     apiError
   };
 }
+function getTranscriptLoopErrorMessage(params) {
+  const decision = getLoopErrorNoticeDecision({
+    ...params,
+    surface: "plain",
+    unclassifiedFallback: "generic"
+  });
+  return decision.visibility === "transcript" ? decision.message : undefined;
+}
 function emitLoopErrorNotice(socket, runtime, params) {
   const decision = getLoopErrorNoticeDecision(params);
   if (decision.visibility === "debug_only") {
@@ -454249,6 +454456,9 @@ class StreamProcessor {
           toolName: "",
           toolArgs: ""
         };
+        if ("id" in chunk && typeof chunk.id === "string" && chunk.id) {
+          existing.messageId = chunk.id;
+        }
         if (toolCall.name) {
           existing.toolName = toolCall.name;
         }
@@ -454268,7 +454478,8 @@ class StreamProcessor {
     return Array.from(this.pendingApprovals.values()).map((a2) => ({
       toolCallId: a2.toolCallId,
       toolName: a2.toolName,
-      toolArgs: a2.toolArgs
+      toolArgs: a2.toolArgs,
+      ...a2.messageId ? { messageId: a2.messageId } : {}
     }));
   }
 }
@@ -454545,7 +454756,8 @@ async function drainStream(stream12, buffers, refresh, abortSignal, onFirstMessa
   const approvals = allPending.map((a2) => ({
     toolCallId: a2.toolCallId,
     toolName: a2.toolName || "",
-    toolArgs: a2.toolArgs || ""
+    toolArgs: a2.toolArgs || "",
+    ...a2.messageId ? { messageId: a2.messageId } : {}
   }));
   const approval = approvals[0] || null;
   streamProcessor.pendingApprovals.clear();
@@ -455231,23 +455443,27 @@ function finalizeHandledRecoveryTurn(runtime, socket, turnLease, params) {
   }
   const terminalStopReason = params.drainResult.stopReason || "error";
   const runId = runtime.activeRunId;
+  const noticeParams = {
+    message: `Recovery continuation ended unexpectedly: ${terminalStopReason}`,
+    agentId: params.agentId,
+    conversationId: params.conversationId
+  };
   const transition = finishListenerTurn(runtime, turnLease, {
     stopReason: terminalStopReason,
     socket,
     agentId: params.agentId,
     conversationId: params.conversationId,
-    turnId: params.turnId
+    turnId: params.turnId,
+    error: getTranscriptLoopErrorMessage(noticeParams)
   });
   if (!transition.finished) {
     return transition;
   }
   emitLoopErrorNotice(socket, runtime, {
-    message: `Recovery continuation ended unexpectedly: ${terminalStopReason}`,
+    ...noticeParams,
     stopReason: terminalStopReason,
     isTerminal: true,
-    runId: runId || undefined,
-    agentId: params.agentId ?? undefined,
-    conversationId: params.conversationId
+    runId: runId || undefined
   });
   return transition;
 }
@@ -455508,6 +455724,7 @@ async function resolveRecoveredApprovalResponse(runtime, socket, response, proce
         conversationId: recovered.conversationId,
         workingDirectory,
         permissionModeState: getOrCreateConversationPermissionModeStateRef(runtime.listener, recovered.agentId, recovered.conversationId),
+        modContext: createListenerAgentModContext(recovered.agentId),
         modAdapters,
         modEvents: createListenerModEvents(modAdapters)
       });
@@ -455603,13 +455820,17 @@ async function resolveRecoveredApprovalResponse(runtime, socket, response, proce
       recovered.pendingRequestIds = new Set(recovered.approvalsByRequestId.keys());
       recovered.responsesByRequestId.clear();
     }
+    const stopReason = recoveryLease.signal.aborted ? "cancelled" : "error";
     finishListenerTurn(runtime, recoveryLease, {
-      stopReason: recoveryLease.signal.aborted ? "cancelled" : "error",
+      stopReason,
       socket,
       agentId: recovered.agentId,
       conversationId: recovered.conversationId,
       turnId: `batch-recovered-${requestId}`,
-      error: error54 instanceof Error ? error54.message : String(error54)
+      error: stopReason === "error" ? getTranscriptLoopErrorMessage({
+        error: error54,
+        message: error54 instanceof Error ? error54.message : String(error54)
+      }) : undefined
     });
     throw error54;
   }
@@ -455917,6 +456138,7 @@ async function resolveStaleApprovals(runtime, socket, turnLease, deps = {}) {
     conversationId: recoveryConversationId,
     workingDirectory: recoveryWorkingDirectory,
     permissionModeState: getOrCreateConversationPermissionModeStateRef(runtime.listener, runtime.agentId, runtime.conversationId),
+    modContext: createListenerAgentModContext(runtime.agentId),
     modAdapters,
     modEvents: createListenerModEvents(modAdapters)
   });
@@ -459107,7 +459329,7 @@ async function emitListenerTurnStart(options3) {
       sessionId: options3.conversationId,
       workingDirectory: options3.workingDirectory,
       permissionMode: options3.permissionMode ?? null,
-      agent: options3.cachedAgent ?? null
+      agent: options3.cachedAgent ?? { id: options3.agentId }
     });
     const event2 = {
       agentId: options3.agentId,
@@ -459134,7 +459356,7 @@ async function emitListenerTurnEnd(options3) {
       sessionId: options3.conversationId,
       workingDirectory: options3.workingDirectory,
       permissionMode: options3.permissionMode ?? null,
-      agent: options3.cachedAgent ?? null
+      agent: options3.cachedAgent ?? { id: options3.agentId }
     });
     const event2 = {
       agentId: options3.agentId,
@@ -460227,8 +460449,10 @@ async function prepareListenerTurn(params) {
     inboundUserTranscriptLines = buildInboundUserTranscriptLines(currentInput);
   }
   const modAdapters = await ensureListenerModAdaptersForAgent(runtime.listener, agentId);
+  const environmentDeviceId = connectionId ? runtime.listener.connections.get(connectionId)?.options.deviceId : undefined;
   const preparedToolContext = await prepareToolExecutionContextForScope({
     connectionId,
+    environmentDeviceId,
     agentId,
     conversationId,
     clientToolset: msg.clientToolset,
@@ -460239,6 +460463,7 @@ async function prepareListenerTurn(params) {
     permissionModeState,
     skillSources: runtime.skillSources,
     cachedAgent,
+    modContext: createListenerAgentModContext(agentId),
     modAdapters,
     modEvents: createListenerModEvents(modAdapters)
   });
@@ -460359,7 +460584,8 @@ async function handleIncomingMessageInner(msg, socket, runtime, onStatusChange,
     if (!agentId) {
       finishTurn({
         stopReason: "error",
-        conversationId
+        conversationId,
+        error: getTranscriptLoopErrorMessage({ message: "Missing agent ID" })
       });
       return;
     }
@@ -460732,24 +460958,29 @@ async function handleIncomingMessageInner(msg, socket, runtime, onStatusChange,
         }
         const errorMessage2 = errorDetail2 || `Unexpected stop reason: ${stopReason}`;
         const terminalRunId = runId || runtime.activeRunId || runErrorInfo2?.run_id;
+        const noticeParams = {
+          message: errorMessage2,
+          agentId,
+          conversationId,
+          runErrorInfo: runErrorInfo2 ?? undefined,
+          cancelRequested: turnAbortSignal.aborted,
+          abortSignal: turnAbortSignal
+        };
+        const terminalError = getTranscriptLoopErrorMessage(noticeParams);
         const transition = finishTurn({
           stopReason: effectiveStopReason,
           agentId,
-          conversationId
+          conversationId,
+          error: terminalError
         });
         if (!transition.finished) {
           break;
         }
         const formattedError = emitLoopErrorNotice(socket, runtime, {
-          message: errorMessage2,
+          ...noticeParams,
           stopReason: effectiveStopReason,
           isTerminal: true,
-          runId: terminalRunId,
-          agentId,
-          conversationId,
-          runErrorInfo: runErrorInfo2 ?? undefined,
-          cancelRequested: turnAbortSignal.aborted,
-          abortSignal: turnAbortSignal
+          runId: terminalRunId
         });
         runtime.lastTerminalLoopErrorMessage = formattedError ?? errorMessage2;
         runtime.lastTerminalLoopErrorRunId = terminalRunId ?? null;
@@ -460776,10 +461007,14 @@ async function handleIncomingMessageInner(msg, socket, runtime, onStatusChange,
       });
       if (approvalResult.kind === "error") {
         const terminalRunId = runId || runtime.activeRunId;
+        const terminalError = getTranscriptLoopErrorMessage({
+          message: approvalResult.message
+        });
         const transition = finishTurn({
           stopReason: "error",
           agentId,
-          conversationId
+          conversationId,
+          error: terminalError
         });
         if (!transition.finished) {
           return;
@@ -460877,24 +461112,29 @@ async function handleIncomingMessageInner(msg, socket, runtime, onStatusChange,
     }
     const errorMessage2 = error54 instanceof Error ? error54.message : String(error54);
     const terminalRunId = runtime.activeRunId;
+    const noticeParams = {
+      message: errorMessage2,
+      agentId,
+      conversationId,
+      error: error54,
+      cancelRequested: turnAbortSignal.aborted,
+      abortSignal: turnAbortSignal
+    };
+    const terminalError = getTranscriptLoopErrorMessage(noticeParams);
     const transition = finishTurn({
       stopReason: "error",
       agentId: agentId || null,
-      conversationId
+      conversationId,
+      error: terminalError
     });
     if (!transition.finished) {
       return;
     }
     const formattedError = emitLoopErrorNotice(socket, runtime, {
-      message: errorMessage2,
+      ...noticeParams,
       stopReason: "error",
       isTerminal: true,
-      runId: terminalRunId,
-      agentId: agentId || undefined,
-      conversationId,
-      error: error54,
-      cancelRequested: turnAbortSignal.aborted,
-      abortSignal: turnAbortSignal
+      runId: terminalRunId
     });
     runtime.lastTerminalLoopErrorMessage = formattedError ?? errorMessage2;
     runtime.lastTerminalLoopErrorRunId = terminalRunId ?? null;
@@ -460914,7 +461154,8 @@ async function handleIncomingMessageInner(msg, socket, runtime, onStatusChange,
         socket,
         runId: runtime.activeRunId || msgRunIds[msgRunIds.length - 1],
         agentId: agentId || null,
-        conversationId
+        conversationId,
+        error: turnAbortSignal.aborted ? undefined : getTranscriptLoopErrorMessage({ message: "Unexpected turn failure" })
       });
     }
     if (runtime.activeConnectionId === connectionId) {
@@ -466115,6 +466356,7 @@ async function startConnectedListenerRuntime(runtime, transport, opts, processQu
   if (runtime !== getActiveRuntime() || runtime.intentionallyClosed) {
     return;
   }
+  installExternalToolBridge(runtime);
   const shouldStartHeartbeat = options3.startHeartbeat !== false;
   const cronSchedulerDisabledByEnv = process.env.LETTA_DISABLE_CRON_SCHEDULER === "1";
   const shouldStartCronScheduler = options3.startCronScheduler !== false && !cronSchedulerDisabledByEnv;
@@ -469394,6 +469636,9 @@ async function resolveListenerStartupMode(channelNames, channelsRequested = chan
   if (channelsRequested) {
     return { kind: "local-channels", serverUrl, backend: "self-hosted" };
   }
+  if (process.env.IGNORE_SELF_HOSTED_LISTENER_ERROR === "1") {
+    return { kind: "remote", serverUrl };
+  }
   return { kind: "unsupported-self-hosted", serverUrl };
 }
 function getScopedChannelRestoreAgentScope() {
@@ -469542,7 +469787,7 @@ async function runListenSubcommand(argv) {
   try {
     const deviceId = settingsManager.getOrCreateDeviceId();
     const startupMode = await resolveListenerStartupMode(channelNames, channelNames.length > 0 || restoreEnabledChannels);
-    if (startupMode.kind === "unsupported-self-hosted" && process.env.IGNORE_SELF_HOSTED_LISTENER_ERROR !== "1") {
+    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");
@@ -491886,7 +492131,7 @@ var init_mcp_client = __esm(() => {
   init_streamableHttp();
   DEFAULT_CLIENT_INFO = {
     name: "letta-code",
-    version: "0.30.5"
+    version: "0.30.7"
   };
 });
 
@@ -523799,6 +524044,7 @@ function formatConnectUsage() {
     "  /connect codex",
     "  /connect anthropic <api_key>",
     "  /connect openai <api_key>",
+    "  /connect openai-compatible --base-url http://localhost:8000/v1 [--api-key <api_key>]",
     "  /connect lmstudio --base-url http://127.0.0.1:1234/v1 --timeout 600s",
     "  /connect bedrock iam --access-key <id> --secret-key <key> --region <region>",
     "  /connect bedrock profile --profile <name> --region <region>"
@@ -523876,7 +524122,7 @@ function formatApiKeyUsage(provider) {
       `Usage: /connect ${provider.canonical} [api_key]`,
       "",
       `Connect to ${provider.byokProvider.displayName}. API key is optional for this local provider.`,
-      "Optional: --base-url <url> --timeout <ms|duration|false>"
+      isConnectBaseURLRequired(provider) ? "Required: --base-url <url>. Optional: --timeout <ms|duration|false>" : "Optional: --base-url <url> --timeout <ms|duration|false>"
     ].join(`
 `);
   }
@@ -524172,6 +524418,12 @@ Usage: /connect chatgpt [--name <provider-name>]`, false);
     if (parsed.error) {
       addCommandResult(ctx.buffersRef, ctx.refreshDerived, msg, `${parsed.error}
 
+${formatApiKeyUsage(provider)}`, false);
+      return;
+    }
+    if (isConnectBaseURLRequired(provider) && !parsed.baseURL?.trim()) {
+      addCommandResult(ctx.buffersRef, ctx.refreshDerived, msg, `Missing required field: --base-url <url>.
+
 ${formatApiKeyUsage(provider)}`, false);
       return;
     }
@@ -555619,9 +555871,8 @@ Note: Flags should use double dashes for full names (e.g., --yolo, not -yolo)`);
   const command = positionals[2];
   if (values2.help) {
     printHelp();
-    const helpDelayMs = Number.parseInt(process.env.LETTA_TEST_HELP_EXIT_DELAY_MS ?? "", 10);
-    if (Number.isFinite(helpDelayMs) && helpDelayMs > 0) {
-      await new Promise((resolve40) => setTimeout(resolve40, helpDelayMs));
+    if (process.env.LETTA_TEST_WAIT_FOR_STARTUP_AUTO_UPDATE === "1") {
+      await autoUpdatePromise;
     }
     process.exit(0);
   }
@@ -558987,4 +559238,4 @@ function registerBunOAuthFlows() {
 registerBunOAuthFlows();
 await init_src5().then(() => exports_src2);
 
-//# debugId=AF6DD74653AB022F64756E2164756E21
+//# debugId=4343FD443B24C00264756E2164756E21