@letta-ai/letta-code 0.22.0 → 0.22.2

package/letta.js

@@ -3269,7 +3269,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@letta-ai/letta-code",
-    version: "0.22.0",
+    version: "0.22.2",
     description: "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
     type: "module",
     bin: {
@@ -5153,19 +5153,86 @@ __export(exports_oauth, {
   OAUTH_CONFIG: () => OAUTH_CONFIG,
   LETTA_CLOUD_API_URL: () => LETTA_CLOUD_API_URL
 });
+function getOAuthAuthHost() {
+  try {
+    return new URL(OAUTH_CONFIG.authBaseUrl).host;
+  } catch {
+    return OAUTH_CONFIG.authBaseUrl;
+  }
+}
+function getErrorLikeMessage(value) {
+  if (value instanceof Error) {
+    return value.message.trim() || null;
+  }
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const message = value.message;
+  return typeof message === "string" && message.trim().length > 0 ? message.trim() : null;
+}
+function getErrorLikeCode(value) {
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const code = value.code;
+  return typeof code === "string" && code.trim().length > 0 ? code.trim() : null;
+}
+function isGenericFetchFailureMessage(message) {
+  const normalized = message.trim().toLowerCase();
+  return normalized === "fetch failed" || normalized === "network request failed";
+}
+function isOAuthTransportError(error) {
+  if (!(error instanceof Error)) {
+    return false;
+  }
+  if (isGenericFetchFailureMessage(error.message)) {
+    return true;
+  }
+  return error.name === "TypeError" && error.cause !== undefined;
+}
+function extractOAuthTransportDetail(error) {
+  const directMessage = isGenericFetchFailureMessage(error.message) ? null : error.message.trim() || null;
+  const causeMessage = getErrorLikeMessage(error.cause);
+  const causeCode = getErrorLikeCode(error.cause);
+  let detail = causeMessage ?? directMessage;
+  if (!detail && causeCode) {
+    detail = causeCode;
+  }
+  if (detail && causeCode && !detail.includes(causeCode)) {
+    detail = `${detail} (${causeCode})`;
+  }
+  return detail;
+}
+function toOAuthActionError(action, error, options) {
+  if (isOAuthTransportError(error)) {
+    const host = getOAuthAuthHost();
+    const detail = extractOAuthTransportDetail(error);
+    const reachabilityHint = options?.browserHint ? "Browser authorization may have succeeded, but the CLI could not reach Letta auth servers from this machine." : "The CLI could not reach Letta auth servers from this machine.";
+    return new Error(`Failed to ${action} from ${host}${detail ? `: ${detail}` : ""}. ${reachabilityHint} Check your network, DNS, proxy, VPN, or TLS settings.`);
+  }
+  if (error instanceof Error) {
+    return error;
+  }
+  return new Error(`Failed to ${action}: ${String(error)}`);
+}
 async function requestDeviceCode() {
-  const response = await fetch(`${OAUTH_CONFIG.authBaseUrl}/api/oauth/device/code`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      client_id: OAUTH_CONFIG.clientId
-    })
-  });
-  if (!response.ok) {
-    const error = await response.json();
-    throw new Error(`Failed to request device code: ${error.error_description || error.error}`);
+  const authHost = getOAuthAuthHost();
+  try {
+    const response = await fetch(`${OAUTH_CONFIG.authBaseUrl}/api/oauth/device/code`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        client_id: OAUTH_CONFIG.clientId
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json();
+      throw new Error(`Failed to request device code from ${authHost}: ${error.error_description || error.error}`);
+    }
+    return await response.json();
+  } catch (error) {
+    throw toOAuthActionError("request device code", error);
   }
-  return await response.json();
 }
 async function pollForToken(deviceCode, interval = 5, expiresIn = 900, deviceId, deviceName) {
   const startTime = Date.now();
@@ -5211,7 +5278,9 @@ async function pollForToken(deviceCode, interval = 5, expiresIn = 900, deviceId,
         context: "auth_oauth_token_poll"
       });
       if (error instanceof Error) {
-        throw error;
+        throw toOAuthActionError("poll for OAuth token", error, {
+          browserHint: true
+        });
       }
       throw new Error(`Failed to poll for token: ${String(error)}`);
     }
@@ -5219,23 +5288,28 @@ async function pollForToken(deviceCode, interval = 5, expiresIn = 900, deviceId,
   throw new Error("Timeout waiting for authorization (15 minutes)");
 }
 async function refreshAccessToken(refreshToken, deviceId, deviceName) {
-  const response = await fetch(`${OAUTH_CONFIG.authBaseUrl}/api/oauth/token`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      grant_type: "refresh_token",
-      client_id: OAUTH_CONFIG.clientId,
-      refresh_token: refreshToken,
-      refresh_token_mode: "new",
-      device_id: deviceId,
-      ...deviceName && { device_name: deviceName }
-    })
-  });
-  if (!response.ok) {
-    const error = await response.json();
-    throw new Error(`Failed to refresh access token: ${error.error_description || error.error}`);
+  const authHost = getOAuthAuthHost();
+  try {
+    const response = await fetch(`${OAUTH_CONFIG.authBaseUrl}/api/oauth/token`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        grant_type: "refresh_token",
+        client_id: OAUTH_CONFIG.clientId,
+        refresh_token: refreshToken,
+        refresh_token_mode: "new",
+        device_id: deviceId,
+        ...deviceName && { device_name: deviceName }
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json();
+      throw new Error(`Failed to refresh access token from ${authHost}: ${error.error_description || error.error}`);
+    }
+    return await response.json();
+  } catch (error) {
+    throw toOAuthActionError("refresh access token", error);
   }
-  return await response.json();
 }
 async function revokeToken(refreshToken) {
   try {
@@ -10364,19 +10438,86 @@ __export(exports_oauth2, {
   OAUTH_CONFIG: () => OAUTH_CONFIG2,
   LETTA_CLOUD_API_URL: () => LETTA_CLOUD_API_URL2
 });
+function getOAuthAuthHost2() {
+  try {
+    return new URL(OAUTH_CONFIG2.authBaseUrl).host;
+  } catch {
+    return OAUTH_CONFIG2.authBaseUrl;
+  }
+}
+function getErrorLikeMessage2(value) {
+  if (value instanceof Error) {
+    return value.message.trim() || null;
+  }
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const message = value.message;
+  return typeof message === "string" && message.trim().length > 0 ? message.trim() : null;
+}
+function getErrorLikeCode2(value) {
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const code = value.code;
+  return typeof code === "string" && code.trim().length > 0 ? code.trim() : null;
+}
+function isGenericFetchFailureMessage2(message) {
+  const normalized = message.trim().toLowerCase();
+  return normalized === "fetch failed" || normalized === "network request failed";
+}
+function isOAuthTransportError2(error) {
+  if (!(error instanceof Error)) {
+    return false;
+  }
+  if (isGenericFetchFailureMessage2(error.message)) {
+    return true;
+  }
+  return error.name === "TypeError" && error.cause !== undefined;
+}
+function extractOAuthTransportDetail2(error) {
+  const directMessage = isGenericFetchFailureMessage2(error.message) ? null : error.message.trim() || null;
+  const causeMessage = getErrorLikeMessage2(error.cause);
+  const causeCode = getErrorLikeCode2(error.cause);
+  let detail = causeMessage ?? directMessage;
+  if (!detail && causeCode) {
+    detail = causeCode;
+  }
+  if (detail && causeCode && !detail.includes(causeCode)) {
+    detail = `${detail} (${causeCode})`;
+  }
+  return detail;
+}
+function toOAuthActionError2(action, error, options) {
+  if (isOAuthTransportError2(error)) {
+    const host = getOAuthAuthHost2();
+    const detail = extractOAuthTransportDetail2(error);
+    const reachabilityHint = options?.browserHint ? "Browser authorization may have succeeded, but the CLI could not reach Letta auth servers from this machine." : "The CLI could not reach Letta auth servers from this machine.";
+    return new Error(`Failed to ${action} from ${host}${detail ? `: ${detail}` : ""}. ${reachabilityHint} Check your network, DNS, proxy, VPN, or TLS settings.`);
+  }
+  if (error instanceof Error) {
+    return error;
+  }
+  return new Error(`Failed to ${action}: ${String(error)}`);
+}
 async function requestDeviceCode2() {
-  const response = await fetch(`${OAUTH_CONFIG2.authBaseUrl}/api/oauth/device/code`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      client_id: OAUTH_CONFIG2.clientId
-    })
-  });
-  if (!response.ok) {
-    const error = await response.json();
-    throw new Error(`Failed to request device code: ${error.error_description || error.error}`);
+  const authHost = getOAuthAuthHost2();
+  try {
+    const response = await fetch(`${OAUTH_CONFIG2.authBaseUrl}/api/oauth/device/code`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        client_id: OAUTH_CONFIG2.clientId
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json();
+      throw new Error(`Failed to request device code from ${authHost}: ${error.error_description || error.error}`);
+    }
+    return await response.json();
+  } catch (error) {
+    throw toOAuthActionError2("request device code", error);
   }
-  return await response.json();
 }
 async function pollForToken2(deviceCode, interval = 5, expiresIn = 900, deviceId, deviceName) {
   const startTime = Date.now();
@@ -10422,7 +10563,9 @@ async function pollForToken2(deviceCode, interval = 5, expiresIn = 900, deviceId
         context: "auth_oauth_token_poll"
       });
       if (error instanceof Error) {
-        throw error;
+        throw toOAuthActionError2("poll for OAuth token", error, {
+          browserHint: true
+        });
       }
       throw new Error(`Failed to poll for token: ${String(error)}`);
     }
@@ -10430,23 +10573,28 @@ async function pollForToken2(deviceCode, interval = 5, expiresIn = 900, deviceId
   throw new Error("Timeout waiting for authorization (15 minutes)");
 }
 async function refreshAccessToken2(refreshToken, deviceId, deviceName) {
-  const response = await fetch(`${OAUTH_CONFIG2.authBaseUrl}/api/oauth/token`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      grant_type: "refresh_token",
-      client_id: OAUTH_CONFIG2.clientId,
-      refresh_token: refreshToken,
-      refresh_token_mode: "new",
-      device_id: deviceId,
-      ...deviceName && { device_name: deviceName }
-    })
-  });
-  if (!response.ok) {
-    const error = await response.json();
-    throw new Error(`Failed to refresh access token: ${error.error_description || error.error}`);
+  const authHost = getOAuthAuthHost2();
+  try {
+    const response = await fetch(`${OAUTH_CONFIG2.authBaseUrl}/api/oauth/token`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        grant_type: "refresh_token",
+        client_id: OAUTH_CONFIG2.clientId,
+        refresh_token: refreshToken,
+        refresh_token_mode: "new",
+        device_id: deviceId,
+        ...deviceName && { device_name: deviceName }
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json();
+      throw new Error(`Failed to refresh access token from ${authHost}: ${error.error_description || error.error}`);
+    }
+    return await response.json();
+  } catch (error) {
+    throw toOAuthActionError2("refresh access token", error);
   }
-  return await response.json();
 }
 async function revokeToken2(refreshToken) {
   try {
@@ -38922,6 +39070,10 @@ for file in $(git diff --cached --name-only --diff-filter=ACM | grep -E '^(memor
   # Validate each line
   while IFS= read -r line; do
     [ -z "$line" ] && continue
+    # Skip YAML multiline continuation lines (indented lines that continue a previous value)
+    case "$line" in
+      " "*|$'	'*) continue ;;
+    esac
 
     key=$(echo "$line" | cut -d: -f1 | tr -d ' ')
     value=$(echo "$line" | cut -d: -f2- | sed 's/^ *//;s/ *$//')
@@ -39842,11 +39994,227 @@ var init_routing = __esm(() => {
   routesByKey = new Map;
 });
 
+// src/cli/helpers/gitContext.ts
+import { execFileSync } from "node:child_process";
+function runGit3(args, cwd2) {
+  try {
+    return execFileSync("git", args, {
+      cwd: cwd2,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+  } catch {
+    return null;
+  }
+}
+function truncateLines(value, maxLines) {
+  const lines = value.split(`
+`);
+  if (lines.length <= maxLines) {
+    return value;
+  }
+  return lines.slice(0, maxLines).join(`
+`) + `
+... and ${lines.length - maxLines} more changes`;
+}
+function formatGitUser(name, email) {
+  if (!name && !email) {
+    return null;
+  }
+  if (name && email) {
+    return `${name} <${email}>`;
+  }
+  return name || email;
+}
+function gatherGitContextSnapshot(options = {}) {
+  const cwd2 = options.cwd ?? process.cwd();
+  const recentCommitLimit = options.recentCommitLimit ?? 3;
+  if (!runGit3(["rev-parse", "--git-dir"], cwd2)) {
+    return {
+      isGitRepo: false,
+      branch: null,
+      status: null,
+      recentCommits: null,
+      gitUser: null
+    };
+  }
+  const branch = runGit3(["branch", "--show-current"], cwd2);
+  const fullStatus = runGit3(["status", "--short"], cwd2);
+  const status = typeof fullStatus === "string" && options.statusLineLimit ? truncateLines(fullStatus, options.statusLineLimit) : fullStatus;
+  const recentCommits = options.recentCommitFormat ? runGit3([
+    "log",
+    `--format=${options.recentCommitFormat}`,
+    "-n",
+    String(recentCommitLimit)
+  ], cwd2) : runGit3(["log", "--oneline", "-n", String(recentCommitLimit)], cwd2);
+  const userConfig = runGit3(["config", "--get-regexp", "^user\\.(name|email)$"], cwd2);
+  let userName = null;
+  let userEmail = null;
+  if (userConfig) {
+    for (const line of userConfig.split(`
+`)) {
+      if (line.startsWith("user.name "))
+        userName = line.slice("user.name ".length);
+      else if (line.startsWith("user.email "))
+        userEmail = line.slice("user.email ".length);
+    }
+  }
+  const gitUser = formatGitUser(userName, userEmail);
+  return {
+    isGitRepo: true,
+    branch,
+    status,
+    recentCommits,
+    gitUser
+  };
+}
+function getGitContext(cwd2) {
+  if (!runGit3(["rev-parse", "--git-dir"], cwd2)) {
+    return null;
+  }
+  const branch = runGit3(["branch", "--show-current"], cwd2);
+  const branchList = runGit3([
+    "branch",
+    "--sort=-committerdate",
+    "--format=%(refname:short)",
+    "--no-color"
+  ], cwd2);
+  const recentBranches = branchList ? branchList.split(`
+`).map((b) => b.trim()).filter((b) => b.length > 0 && b !== branch).slice(0, 10) : [];
+  return { branch, recent_branches: recentBranches };
+}
+var init_gitContext = () => {};
+
+// src/cli/helpers/sessionContext.ts
+import { platform as platform3 } from "node:os";
+function getLocalTime() {
+  const now = new Date;
+  return now.toLocaleString(undefined, {
+    weekday: "long",
+    year: "numeric",
+    month: "long",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit",
+    timeZoneName: "short"
+  });
+}
+function getDeviceType() {
+  const p = platform3();
+  switch (p) {
+    case "darwin":
+      return "macOS";
+    case "win32":
+      return "Windows";
+    case "linux":
+      return "Linux";
+    default:
+      return p;
+  }
+}
+function getGitInfo(cwd2) {
+  const git = gatherGitContextSnapshot({
+    cwd: cwd2,
+    recentCommitLimit: 3,
+    recentCommitFormat: "%h %s (%an)",
+    statusLineLimit: 20
+  });
+  if (!git.isGitRepo) {
+    return { isGitRepo: false };
+  }
+  return {
+    isGitRepo: true,
+    branch: git.branch ?? "(unknown)",
+    recentCommits: git.recentCommits ?? "(failed to get commits)",
+    status: git.status || "(clean working tree)",
+    gitUser: git.gitUser ?? "(not configured)"
+  };
+}
+function getIntroText(source, reason) {
+  if (reason === "cwd_changed") {
+    return "The working directory for this conversation has changed. Updated environment context follows.";
+  }
+  switch (source) {
+    case "listen":
+      return "This conversation is now connected to a Letta Code execution environment.";
+    case "headless":
+      return "The user has just initiated a new connection via the Letta Code headless client.";
+    default:
+      return "The user has just initiated a new connection via the [Letta Code CLI client](https://docs.letta.com/letta-code/index.md).";
+  }
+}
+function buildSessionContext(options) {
+  try {
+    const cwd2 = options?.cwd ?? process.cwd();
+    const source = options?.source ?? "interactive-cli";
+    const reason = options?.reason ?? "initial_attach";
+    let version = "unknown";
+    try {
+      version = getVersion();
+    } catch {}
+    let deviceType = "unknown";
+    try {
+      deviceType = getDeviceType();
+    } catch {}
+    let localTime = "unknown";
+    try {
+      localTime = getLocalTime();
+    } catch {}
+    const gitInfo = getGitInfo(cwd2);
+    let context2 = `${SYSTEM_REMINDER_OPEN}
+This is an automated message providing context about the user's environment.
+${getIntroText(source, reason)}
+
+## Device Information
+- **Local time**: ${localTime}
+- **Device type**: ${deviceType}
+- **Letta Code version**: ${version}
+- **Current working directory**: ${cwd2}
+`;
+    if (gitInfo.isGitRepo) {
+      context2 += `- **Git repository**: Yes (branch: ${gitInfo.branch})
+- **Git user**: ${gitInfo.gitUser}
+
+### Recent Commits
+\`\`\`
+${gitInfo.recentCommits}
+\`\`\`
+
+### Git Status
+\`\`\`
+${gitInfo.status}
+\`\`\`
+`;
+    } else {
+      context2 += `- **Git repository**: No
+`;
+    }
+    if (platform3() === "win32") {
+      context2 += `
+## Windows Shell Notes
+- The Bash tool uses PowerShell or cmd.exe on Windows
+- HEREDOC syntax (e.g., \`$(cat <<'EOF'...EOF)\`) does NOT work on Windows
+- For multiline strings (git commits, PR bodies), use simple quoted strings instead
+`;
+    }
+    context2 += SYSTEM_REMINDER_CLOSE;
+    return context2;
+  } catch {
+    return "";
+  }
+}
+var init_sessionContext = __esm(() => {
+  init_constants();
+  init_version();
+  init_gitContext();
+});
+
 // src/channels/xml.ts
 function escapeXml(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
 function formatChannelNotification(msg) {
+  const localTime = escapeXml(getLocalTime());
   const attrs = [
     `source="${escapeXml(msg.channel)}"`,
     `chat_id="${escapeXml(msg.chatId)}"`,
@@ -39860,10 +40228,27 @@ function formatChannelNotification(msg) {
   }
   const attrString = attrs.join(" ");
   const escapedText = escapeXml(msg.text);
-  return `<channel-notification ${attrString}>
+  const escapedChannel = escapeXml(msg.channel);
+  const escapedChatId = escapeXml(msg.chatId);
+  const reminder = [
+    SYSTEM_REMINDER_OPEN,
+    `This message originated from an external ${escapedChannel} channel.`,
+    `If you want the ensure the user on ${escapedChannel} will see your reply, you must call the MessageChannel tool to send a message back on the same channel.`,
+    `Use channel="${escapedChannel}" and chat_id="${escapedChatId}" when calling MessageChannel.`,
+    "Only pass reply_to_message_id if you intentionally want the platform's quote/reply UI.",
+    `Current local time on this device: ${localTime}`,
+    SYSTEM_REMINDER_CLOSE
+  ].join(`
+`);
+  return `${reminder}
+<channel-notification ${attrString}>
 ${escapedText}
 </channel-notification>`;
 }
+var init_xml = __esm(() => {
+  init_sessionContext();
+  init_constants();
+});
 
 // node_modules/grammy/out/filter.js
 var require_filter = __commonJS((exports) => {
@@ -48585,13 +48970,22 @@ function createTelegramAdapter(config) {
       await bot.init();
       const info = bot.botInfo;
       console.log(`[Telegram] Bot started as @${info.username} (dm_policy: ${config.dmPolicy})`);
-      bot.start({
-        onStart: () => {
-          running = true;
-        }
-      }).catch((error) => {
-        running = false;
-        console.error("[Telegram] Long-polling stopped unexpectedly:", error);
+      await new Promise((resolve2, reject) => {
+        let started = false;
+        bot.start({
+          onStart: () => {
+            running = true;
+            started = true;
+            resolve2();
+          }
+        }).catch((error) => {
+          running = false;
+          if (!started) {
+            reject(error);
+            return;
+          }
+          console.error("[Telegram] Long-polling stopped unexpectedly:", error);
+        });
       });
     },
     async stop() {
@@ -48635,12 +49029,16 @@ __export(exports_registry, {
   initializeChannels: () => initializeChannels,
   getChannelRegistry: () => getChannelRegistry,
   getActiveChannelIds: () => getActiveChannelIds,
+  ensureChannelRegistry: () => ensureChannelRegistry,
   completePairing: () => completePairing,
   ChannelRegistry: () => ChannelRegistry
 });
 function getChannelRegistry() {
   return instance;
 }
+function ensureChannelRegistry() {
+  return instance ?? new ChannelRegistry;
+}
 function getActiveChannelIds() {
   if (!instance)
     return [];
@@ -48651,6 +49049,7 @@ class ChannelRegistry {
   adapters = new Map;
   ready = false;
   messageHandler = null;
+  eventHandler = null;
   buffer = [];
   constructor() {
     if (instance) {
@@ -48673,6 +49072,9 @@ class ChannelRegistry {
   setMessageHandler(handler) {
     this.messageHandler = handler;
   }
+  setEventHandler(handler) {
+    this.eventHandler = handler;
+  }
   setReady() {
     this.ready = true;
     this.flushBuffer();
@@ -48683,6 +49085,39 @@ class ChannelRegistry {
   getRoute(channel, chatId) {
     return getRoute(channel, chatId);
   }
+  async startChannel(channelId) {
+    const config = readChannelConfig(channelId);
+    if (!config) {
+      return false;
+    }
+    loadRoutes(channelId);
+    loadPairingStore(channelId);
+    const existing = this.adapters.get(channelId);
+    if (existing?.isRunning()) {
+      await existing.stop();
+    }
+    this.adapters.delete(channelId);
+    if (channelId === "telegram") {
+      const { createTelegramAdapter: createTelegramAdapter2 } = await Promise.resolve().then(() => (init_adapter(), exports_adapter));
+      const adapter = createTelegramAdapter2(config);
+      this.registerAdapter(adapter);
+      await adapter.start();
+      return true;
+    }
+    console.error(`Unknown channel "${channelId}". Supported: telegram`);
+    return false;
+  }
+  async stopChannel(channelId) {
+    const adapter = this.adapters.get(channelId);
+    if (!adapter) {
+      return false;
+    }
+    if (adapter.isRunning()) {
+      await adapter.stop();
+    }
+    this.adapters.delete(channelId);
+    return true;
+  }
   async startAll() {
     for (const adapter of Array.from(this.adapters.values())) {
       if (!adapter.isRunning()) {
@@ -48693,6 +49128,7 @@ class ChannelRegistry {
   pause() {
     this.ready = false;
     this.messageHandler = null;
+    this.eventHandler = null;
   }
   async stopAll() {
     for (const adapter of Array.from(this.adapters.values())) {
@@ -48702,6 +49138,7 @@ class ChannelRegistry {
     }
     this.ready = false;
     this.messageHandler = null;
+    this.eventHandler = null;
     instance = null;
   }
   async handleInboundMessage(msg) {
@@ -48722,11 +49159,15 @@ class ChannelRegistry {
       }
       if (!isUserApproved(msg.channel, msg.senderId)) {
         const code = createPairingCode(msg.channel, msg.senderId, msg.chatId, msg.senderName);
+        this.eventHandler?.({
+          type: "pairings_updated",
+          channelId: msg.channel
+        });
         await adapter.sendDirectReply(msg.chatId, `To connect this chat to a Letta Code agent, run:
 
-` + `/channels telegram pair ${code}
+/channels telegram pair ${code}
 
-` + `This code expires in 15 minutes.`);
+This code expires in 15 minutes.`);
         return;
       }
     }
@@ -48736,7 +49177,7 @@ class ChannelRegistry {
       route = getRoute(msg.channel, msg.chatId);
     }
     if (!route) {
-      await adapter.sendDirectReply(msg.chatId, `This chat isn't bound to an agent. ` + `Run \`/channels telegram enable --chat-id ${msg.chatId}\` ` + `on your Letta Code agent to connect.`);
+      await adapter.sendDirectReply(msg.chatId, `This chat isn't bound to an agent. Run \`/channels telegram enable --chat-id ${msg.chatId}\` on your Letta Code agent to connect.`);
       return;
     }
     const xmlContent = formatChannelNotification(msg);
@@ -48758,7 +49199,7 @@ class ChannelRegistry {
   }
 }
 async function initializeChannels(channelNames) {
-  const registry = new ChannelRegistry;
+  const registry = ensureChannelRegistry();
   for (const channelId of channelNames) {
     const config = readChannelConfig(channelId);
     if (!config) {
@@ -48769,17 +49210,8 @@ async function initializeChannels(channelNames) {
       console.log(`Channel "${channelId}" is disabled in config, skipping.`);
       continue;
     }
-    loadRoutes(channelId);
-    loadPairingStore(channelId);
-    if (channelId === "telegram") {
-      const { createTelegramAdapter: createTelegramAdapter2 } = await Promise.resolve().then(() => (init_adapter(), exports_adapter));
-      const adapter = createTelegramAdapter2(config);
-      registry.registerAdapter(adapter);
-    } else {
-      console.error(`Unknown channel: "${channelId}". Supported: telegram`);
-    }
+    await registry.startChannel(channelId);
   }
-  await registry.startAll();
   return registry;
 }
 function completePairing(channelId, code, agentId, conversationId) {
@@ -48816,6 +49248,7 @@ var init_registry = __esm(() => {
   init_config();
   init_pairing();
   init_routing();
+  init_xml();
 });
 
 // src/channels/telegram/setup.ts
@@ -49603,7 +50036,7 @@ var init_default_browser_id = __esm(() => {
 // node_modules/run-applescript/index.js
 import process17 from "node:process";
 import { promisify as promisify4 } from "node:util";
-import { execFile as execFile4, execFileSync } from "node:child_process";
+import { execFile as execFile4, execFileSync as execFileSync2 } from "node:child_process";
 async function runAppleScript(script, { humanReadableOutput = true, signal } = {}) {
   if (process17.platform !== "darwin") {
     throw new Error("macOS only");
@@ -49743,16 +50176,16 @@ function detectArchBinary(binary) {
   }
   return archBinary;
 }
-function detectPlatformBinary({ [platform3]: platformBinary }, { wsl }) {
+function detectPlatformBinary({ [platform4]: platformBinary }, { wsl }) {
   if (wsl && is_wsl_default) {
     return detectArchBinary(wsl);
   }
   if (!platformBinary) {
-    throw new Error(`${platform3} is not supported`);
+    throw new Error(`${platform4} is not supported`);
   }
   return detectArchBinary(platformBinary);
 }
-var execFile7, __dirname2, localXdgOpenPath, platform3, arch, pTryEach = async (array, mapper) => {
+var execFile7, __dirname2, localXdgOpenPath, platform4, arch, pTryEach = async (array, mapper) => {
   let latestError;
   for (const item of array) {
     try {
@@ -49824,7 +50257,7 @@ var execFile7, __dirname2, localXdgOpenPath, platform3, arch, pTryEach = async (
   let command;
   const cliArguments = [];
   const childProcessOptions = {};
-  if (platform3 === "darwin") {
+  if (platform4 === "darwin") {
     command = "open";
     if (options.wait) {
       cliArguments.push("--wait-apps");
@@ -49838,7 +50271,7 @@ var execFile7, __dirname2, localXdgOpenPath, platform3, arch, pTryEach = async (
     if (app) {
       cliArguments.push("-a", app);
     }
-  } else if (platform3 === "win32" || is_wsl_default && !isInsideContainer() && !app) {
+  } else if (platform4 === "win32" || is_wsl_default && !isInsideContainer() && !app) {
     command = await powerShellPath();
     cliArguments.push("-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-EncodedCommand");
     if (!is_wsl_default) {
@@ -49871,7 +50304,7 @@ var execFile7, __dirname2, localXdgOpenPath, platform3, arch, pTryEach = async (
         await fs6.access(localXdgOpenPath, fsConstants2.X_OK);
         exeLocalXdgOpen = true;
       } catch {}
-      const useSystemXdgOpen = process19.versions.electron ?? (platform3 === "android" || isBundled || !exeLocalXdgOpen);
+      const useSystemXdgOpen = process19.versions.electron ?? (platform4 === "android" || isBundled || !exeLocalXdgOpen);
       command = useSystemXdgOpen ? "xdg-open" : localXdgOpenPath;
     }
     if (appArguments.length > 0) {
@@ -49882,7 +50315,7 @@ var execFile7, __dirname2, localXdgOpenPath, platform3, arch, pTryEach = async (
       childProcessOptions.detached = true;
     }
   }
-  if (platform3 === "darwin" && appArguments.length > 0) {
+  if (platform4 === "darwin" && appArguments.length > 0) {
     cliArguments.push("--args", ...appArguments);
   }
   if (options.target) {
@@ -49934,7 +50367,7 @@ var init_open = __esm(() => {
   execFile7 = promisify7(childProcess.execFile);
   __dirname2 = path2.dirname(fileURLToPath(import.meta.url));
   localXdgOpenPath = path2.join(__dirname2, "xdg-open");
-  ({ platform: platform3, arch } = process19);
+  ({ platform: platform4, arch } = process19);
   apps = {};
   defineLazyProperty(apps, "chrome", () => detectPlatformBinary({
     darwin: "google chrome",
@@ -53051,97 +53484,6 @@ var init_fileIndex = __esm(() => {
   indexRoot2 = process.cwd();
 });
 
-// src/cli/helpers/gitContext.ts
-import { execFileSync as execFileSync2 } from "node:child_process";
-function runGit3(args, cwd2) {
-  try {
-    return execFileSync2("git", args, {
-      cwd: cwd2,
-      encoding: "utf-8",
-      stdio: ["ignore", "pipe", "ignore"]
-    }).trim();
-  } catch {
-    return null;
-  }
-}
-function truncateLines(value, maxLines) {
-  const lines = value.split(`
-`);
-  if (lines.length <= maxLines) {
-    return value;
-  }
-  return lines.slice(0, maxLines).join(`
-`) + `
-... and ${lines.length - maxLines} more changes`;
-}
-function formatGitUser(name, email) {
-  if (!name && !email) {
-    return null;
-  }
-  if (name && email) {
-    return `${name} <${email}>`;
-  }
-  return name || email;
-}
-function gatherGitContextSnapshot(options = {}) {
-  const cwd2 = options.cwd ?? process.cwd();
-  const recentCommitLimit = options.recentCommitLimit ?? 3;
-  if (!runGit3(["rev-parse", "--git-dir"], cwd2)) {
-    return {
-      isGitRepo: false,
-      branch: null,
-      status: null,
-      recentCommits: null,
-      gitUser: null
-    };
-  }
-  const branch = runGit3(["branch", "--show-current"], cwd2);
-  const fullStatus = runGit3(["status", "--short"], cwd2);
-  const status = typeof fullStatus === "string" && options.statusLineLimit ? truncateLines(fullStatus, options.statusLineLimit) : fullStatus;
-  const recentCommits = options.recentCommitFormat ? runGit3([
-    "log",
-    `--format=${options.recentCommitFormat}`,
-    "-n",
-    String(recentCommitLimit)
-  ], cwd2) : runGit3(["log", "--oneline", "-n", String(recentCommitLimit)], cwd2);
-  const userConfig = runGit3(["config", "--get-regexp", "^user\\.(name|email)$"], cwd2);
-  let userName = null;
-  let userEmail = null;
-  if (userConfig) {
-    for (const line of userConfig.split(`
-`)) {
-      if (line.startsWith("user.name "))
-        userName = line.slice("user.name ".length);
-      else if (line.startsWith("user.email "))
-        userEmail = line.slice("user.email ".length);
-    }
-  }
-  const gitUser = formatGitUser(userName, userEmail);
-  return {
-    isGitRepo: true,
-    branch,
-    status,
-    recentCommits,
-    gitUser
-  };
-}
-function getGitContext(cwd2) {
-  if (!runGit3(["rev-parse", "--git-dir"], cwd2)) {
-    return null;
-  }
-  const branch = runGit3(["branch", "--show-current"], cwd2);
-  const branchList = runGit3([
-    "branch",
-    "--sort=-committerdate",
-    "--format=%(refname:short)",
-    "--no-color"
-  ], cwd2);
-  const recentBranches = branchList ? branchList.split(`
-`).map((b) => b.trim()).filter((b) => b.length > 0 && b !== branch).slice(0, 10) : [];
-  return { branch, recent_branches: recentBranches };
-}
-var init_gitContext = () => {};
-
 // src/cli/helpers/memoryReminder.ts
 function isValidStepCount(value) {
   return typeof value === "number" && Number.isFinite(value) && Number.isInteger(value) && value > 0;
@@ -64319,7 +64661,7 @@ var MemoryApplyPatch_default = "Apply a codex-style patch to memory files in `$M
 var init_MemoryApplyPatch = () => {};
 
 // src/tools/descriptions/MessageChannel.md
-var MessageChannel_default = "# MessageChannel\n\nSend a message to an external channel (Telegram, Slack, etc.) in response to a channel notification.\n\nWhen you receive a `<channel-notification>`, use this tool to reply. Extract the `source` and `chat_id` from the notification attributes and pass them as `channel` and `chat_id`.\n\nParameters:\n- `channel`: The platform to send to (matches the `source` attribute)\n- `chat_id`: The chat ID to send to (matches the `chat_id` attribute)\n- `text`: The message text to send\n- `reply_to_message_id`: (Optional) Reply to a specific message by its `message_id`\n";
+var MessageChannel_default = "# MessageChannel\n\nSend a message to an external channel (Telegram, Slack, etc.) in response to a channel notification.\n\nWhen you receive a `<channel-notification>`, use this tool to reply directly to the user on the same external channel (a normal assistant response is not delivered back to Telegram/Slack/etc). Extract the `source` and `chat_id` from the notification attributes and pass them as `channel` and `chat_id`.\n\nParameters:\n- `channel`: The platform to send to (matches the `source` attribute)\n- `chat_id`: The chat ID to send to (matches the `chat_id` attribute)\n- `text`: The message text to send\n- `reply_to_message_id`: (Optional) Reply to a specific message by its `message_id`. Omit this unless you intentionally want the platform's quote/reply UI.\n";
 var init_MessageChannel = () => {};
 
 // src/tools/descriptions/MultiEdit.md
@@ -74462,7 +74804,7 @@ class Pattern {
   #isUNC;
   #isAbsolute;
   #followGlobstar = true;
-  constructor(patternList, globList, index, platform4) {
+  constructor(patternList, globList, index, platform5) {
     if (!isPatternList(patternList)) {
       throw new TypeError("empty pattern list");
     }
@@ -74479,7 +74821,7 @@ class Pattern {
     this.#patternList = patternList;
     this.#globList = globList;
     this.#index = index;
-    this.#platform = platform4;
+    this.#platform = platform5;
     if (this.#index === 0) {
       if (this.isUNC()) {
         const [p0, p1, p2, p3, ...prest] = this.#patternList;
@@ -74576,12 +74918,12 @@ class Ignore {
   absoluteChildren;
   platform;
   mmopts;
-  constructor(ignored, { nobrace, nocase, noext, noglobstar, platform: platform4 = defaultPlatform2 }) {
+  constructor(ignored, { nobrace, nocase, noext, noglobstar, platform: platform5 = defaultPlatform2 }) {
     this.relative = [];
     this.absolute = [];
     this.relativeChildren = [];
     this.absoluteChildren = [];
-    this.platform = platform4;
+    this.platform = platform5;
     this.mmopts = {
       dot: true,
       nobrace,
@@ -74589,7 +74931,7 @@ class Ignore {
       noext,
       noglobstar,
       optimizationLevel: 2,
-      platform: platform4,
+      platform: platform5,
       nocomment: true,
       nonegate: true
     };
@@ -76674,7 +77016,7 @@ function resolveSubagentLauncher(cliArgs, options = {}) {
   const env4 = options.env ?? process.env;
   const argv = options.argv ?? process.argv;
   const execPath = options.execPath ?? process.execPath;
-  const platform4 = options.platform ?? process.platform;
+  const platform5 = options.platform ?? process.platform;
   const invocation = resolveLettaInvocation(env4, argv, execPath);
   if (invocation) {
     return {
@@ -76689,7 +77031,7 @@ function resolveSubagentLauncher(cliArgs, options = {}) {
       args: [currentScript, ...cliArgs]
     };
   }
-  if (currentScript.endsWith(".js") && platform4 === "win32") {
+  if (currentScript.endsWith(".js") && platform5 === "win32") {
     return {
       command: execPath,
       args: [currentScript, ...cliArgs]
@@ -87255,130 +87597,6 @@ var init_agentInfo = __esm(async () => {
   await init_settings_manager();
 });
 
-// src/cli/helpers/sessionContext.ts
-import { platform as platform4 } from "node:os";
-function getLocalTime() {
-  const now = new Date;
-  return now.toLocaleString(undefined, {
-    weekday: "long",
-    year: "numeric",
-    month: "long",
-    day: "numeric",
-    hour: "2-digit",
-    minute: "2-digit",
-    timeZoneName: "short"
-  });
-}
-function getDeviceType() {
-  const p = platform4();
-  switch (p) {
-    case "darwin":
-      return "macOS";
-    case "win32":
-      return "Windows";
-    case "linux":
-      return "Linux";
-    default:
-      return p;
-  }
-}
-function getGitInfo(cwd2) {
-  const git = gatherGitContextSnapshot({
-    cwd: cwd2,
-    recentCommitLimit: 3,
-    recentCommitFormat: "%h %s (%an)",
-    statusLineLimit: 20
-  });
-  if (!git.isGitRepo) {
-    return { isGitRepo: false };
-  }
-  return {
-    isGitRepo: true,
-    branch: git.branch ?? "(unknown)",
-    recentCommits: git.recentCommits ?? "(failed to get commits)",
-    status: git.status || "(clean working tree)",
-    gitUser: git.gitUser ?? "(not configured)"
-  };
-}
-function getIntroText(source, reason) {
-  if (reason === "cwd_changed") {
-    return "The working directory for this conversation has changed. Updated environment context follows.";
-  }
-  switch (source) {
-    case "listen":
-      return "This conversation is now connected to a Letta Code execution environment.";
-    case "headless":
-      return "The user has just initiated a new connection via the Letta Code headless client.";
-    default:
-      return "The user has just initiated a new connection via the [Letta Code CLI client](https://docs.letta.com/letta-code/index.md).";
-  }
-}
-function buildSessionContext(options) {
-  try {
-    const cwd2 = options?.cwd ?? process.cwd();
-    const source = options?.source ?? "interactive-cli";
-    const reason = options?.reason ?? "initial_attach";
-    let version = "unknown";
-    try {
-      version = getVersion();
-    } catch {}
-    let deviceType = "unknown";
-    try {
-      deviceType = getDeviceType();
-    } catch {}
-    let localTime = "unknown";
-    try {
-      localTime = getLocalTime();
-    } catch {}
-    const gitInfo = getGitInfo(cwd2);
-    let context3 = `${SYSTEM_REMINDER_OPEN}
-This is an automated message providing context about the user's environment.
-${getIntroText(source, reason)}
-
-## Device Information
-- **Local time**: ${localTime}
-- **Device type**: ${deviceType}
-- **Letta Code version**: ${version}
-- **Current working directory**: ${cwd2}
-`;
-    if (gitInfo.isGitRepo) {
-      context3 += `- **Git repository**: Yes (branch: ${gitInfo.branch})
-- **Git user**: ${gitInfo.gitUser}
-
-### Recent Commits
-\`\`\`
-${gitInfo.recentCommits}
-\`\`\`
-
-### Git Status
-\`\`\`
-${gitInfo.status}
-\`\`\`
-`;
-    } else {
-      context3 += `- **Git repository**: No
-`;
-    }
-    if (platform4() === "win32") {
-      context3 += `
-## Windows Shell Notes
-- The Bash tool uses PowerShell or cmd.exe on Windows
-- HEREDOC syntax (e.g., \`$(cat <<'EOF'...EOF)\`) does NOT work on Windows
-- For multiline strings (git commits, PR bodies), use simple quoted strings instead
-`;
-    }
-    context3 += SYSTEM_REMINDER_CLOSE;
-    return context3;
-  } catch {
-    return "";
-  }
-}
-var init_sessionContext = __esm(() => {
-  init_constants();
-  init_version();
-  init_gitContext();
-});
-
 // src/reminders/catalog.ts
 var SHARED_REMINDER_CATALOG, SHARED_REMINDER_IDS, SHARED_REMINDER_BY_ID;
 var init_catalog = __esm(() => {
@@ -94145,6 +94363,67 @@ function isSetReflectionSettingsCommand(value) {
   const settings = c.settings;
   return (settings.trigger === "off" || settings.trigger === "step-count" || settings.trigger === "compaction-event") && typeof settings.step_count === "number" && Number.isInteger(settings.step_count) && settings.step_count > 0 && (c.scope === undefined || c.scope === "local_project" || c.scope === "global" || c.scope === "both");
 }
+function isChannelId(value) {
+  return value === "telegram";
+}
+function isChannelsListCommand(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const c = value;
+  return c.type === "channels_list" && typeof c.request_id === "string";
+}
+function isChannelGetConfigCommand(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const c = value;
+  return c.type === "channel_get_config" && typeof c.request_id === "string" && isChannelId(c.channel_id);
+}
+function isChannelSetConfigCommand(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const c = value;
+  if (c.type !== "channel_set_config" || typeof c.request_id !== "string" || !isChannelId(c.channel_id) || !c.config || typeof c.config !== "object") {
+    return false;
+  }
+  const config = c.config;
+  return (config.token === undefined || typeof config.token === "string") && (config.dm_policy === undefined || config.dm_policy === "pairing" || config.dm_policy === "allowlist" || config.dm_policy === "open") && (config.allowed_users === undefined || Array.isArray(config.allowed_users) && config.allowed_users.every((entry) => typeof entry === "string"));
+}
+function isChannelStartCommand(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const c = value;
+  return c.type === "channel_start" && typeof c.request_id === "string" && isChannelId(c.channel_id);
+}
+function isChannelStopCommand(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const c = value;
+  return c.type === "channel_stop" && typeof c.request_id === "string" && isChannelId(c.channel_id);
+}
+function isChannelPairingsListCommand(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const c = value;
+  return c.type === "channel_pairings_list" && typeof c.request_id === "string" && isChannelId(c.channel_id);
+}
+function isChannelPairingBindCommand(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const c = value;
+  return c.type === "channel_pairing_bind" && typeof c.request_id === "string" && isChannelId(c.channel_id) && isRuntimeScope(c.runtime) && typeof c.code === "string" && c.code.length > 0;
+}
+function isChannelRoutesListCommand(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const c = value;
+  return c.type === "channel_routes_list" && typeof c.request_id === "string" && (c.channel_id === undefined || isChannelId(c.channel_id)) && (c.agent_id === undefined || typeof c.agent_id === "string") && (c.conversation_id === undefined || typeof c.conversation_id === "string");
+}
+function isChannelRouteRemoveCommand(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const c = value;
+  return c.type === "channel_route_remove" && typeof c.request_id === "string" && isChannelId(c.channel_id) && typeof c.chat_id === "string" && c.chat_id.length > 0;
+}
 function isSearchBranchesCommand(value) {
   if (!value || typeof value !== "object")
     return false;
@@ -94168,7 +94447,7 @@ function parseServerMessage(data) {
   try {
     const raw = typeof data === "string" ? data : data.toString();
     const parsed = JSON.parse(raw);
-    if (isInputCommand(parsed) || isChangeDeviceStateCommand(parsed) || isAbortMessageCommand(parsed) || isSyncCommand(parsed) || isTerminalSpawnCommand(parsed) || isTerminalInputCommand(parsed) || isTerminalResizeCommand(parsed) || isTerminalKillCommand(parsed) || isSearchFilesCommand(parsed) || isListInDirectoryCommand(parsed) || isReadFileCommand(parsed) || isWriteFileCommand(parsed) || isWatchFileCommand(parsed) || isUnwatchFileCommand(parsed) || isEditFileCommand(parsed) || isListMemoryCommand(parsed) || isMemoryHistoryCommand(parsed) || isMemoryFileAtRefCommand(parsed) || isEnableMemfsCommand(parsed) || isListModelsCommand(parsed) || isUpdateModelCommand(parsed) || isCronListCommand(parsed) || isCronAddCommand(parsed) || isCronGetCommand(parsed) || isCronDeleteCommand(parsed) || isCronDeleteAllCommand(parsed) || isSkillEnableCommand(parsed) || isSkillDisableCommand(parsed) || isCreateAgentCommand(parsed) || isGetReflectionSettingsCommand(parsed) || isSetReflectionSettingsCommand(parsed) || isExecuteCommandCommand(parsed) || isSearchBranchesCommand(parsed) || isCheckoutBranchCommand(parsed)) {
+    if (isInputCommand(parsed) || isChangeDeviceStateCommand(parsed) || isAbortMessageCommand(parsed) || isSyncCommand(parsed) || isTerminalSpawnCommand(parsed) || isTerminalInputCommand(parsed) || isTerminalResizeCommand(parsed) || isTerminalKillCommand(parsed) || isSearchFilesCommand(parsed) || isListInDirectoryCommand(parsed) || isReadFileCommand(parsed) || isWriteFileCommand(parsed) || isWatchFileCommand(parsed) || isUnwatchFileCommand(parsed) || isEditFileCommand(parsed) || isListMemoryCommand(parsed) || isMemoryHistoryCommand(parsed) || isMemoryFileAtRefCommand(parsed) || isEnableMemfsCommand(parsed) || isListModelsCommand(parsed) || isUpdateModelCommand(parsed) || isCronListCommand(parsed) || isCronAddCommand(parsed) || isCronGetCommand(parsed) || isCronDeleteCommand(parsed) || isCronDeleteAllCommand(parsed) || isSkillEnableCommand(parsed) || isSkillDisableCommand(parsed) || isCreateAgentCommand(parsed) || isGetReflectionSettingsCommand(parsed) || isSetReflectionSettingsCommand(parsed) || isChannelsListCommand(parsed) || isChannelGetConfigCommand(parsed) || isChannelSetConfigCommand(parsed) || isChannelStartCommand(parsed) || isChannelStopCommand(parsed) || isChannelPairingsListCommand(parsed) || isChannelPairingBindCommand(parsed) || isChannelRoutesListCommand(parsed) || isChannelRouteRemoveCommand(parsed) || isExecuteCommandCommand(parsed) || isSearchBranchesCommand(parsed) || isCheckoutBranchCommand(parsed)) {
       return parsed;
     }
     const invalidInput = getInvalidInputReason(parsed);
@@ -94189,6 +94468,201 @@ var init_protocol_inbound = __esm(async () => {
   await init_approval();
 });
 
+// src/channels/service.ts
+var exports_service = {};
+__export(exports_service, {
+  stopChannelLive: () => stopChannelLive,
+  startChannelLive: () => startChannelLive,
+  setChannelConfigLive: () => setChannelConfigLive,
+  removeChannelRouteLive: () => removeChannelRouteLive,
+  listPendingPairingSnapshots: () => listPendingPairingSnapshots,
+  listChannelSummaries: () => listChannelSummaries,
+  listChannelRouteSnapshots: () => listChannelRouteSnapshots,
+  getChannelConfigSnapshot: () => getChannelConfigSnapshot,
+  bindChannelPairing: () => bindChannelPairing,
+  CHANNEL_DISPLAY_NAMES: () => CHANNEL_DISPLAY_NAMES
+});
+function assertSupportedChannelId(channelId) {
+  if (channelId !== "telegram") {
+    throw new Error(`Unsupported channel: ${channelId}`);
+  }
+}
+function toConfigSnapshot(channelId, config) {
+  return {
+    channelId,
+    enabled: config.enabled,
+    dmPolicy: config.dmPolicy,
+    allowedUsers: [...config.allowedUsers],
+    hasToken: config.token.trim().length > 0
+  };
+}
+function toPendingPairingSnapshot(pending) {
+  return {
+    code: pending.code,
+    senderId: pending.telegramUserId,
+    senderName: pending.telegramUsername,
+    chatId: pending.chatId,
+    createdAt: pending.createdAt,
+    expiresAt: pending.expiresAt
+  };
+}
+function toRouteSnapshot(channelId, route) {
+  return {
+    channelId,
+    chatId: route.chatId,
+    agentId: route.agentId,
+    conversationId: route.conversationId,
+    enabled: route.enabled,
+    createdAt: route.createdAt
+  };
+}
+function listChannelSummaries() {
+  const registry = getChannelRegistry();
+  const channelId = "telegram";
+  const config = readChannelConfig(channelId);
+  if (!config) {
+    return [
+      {
+        channelId,
+        displayName: CHANNEL_DISPLAY_NAMES[channelId],
+        configured: false,
+        enabled: false,
+        running: false,
+        dmPolicy: null,
+        pendingPairingsCount: 0,
+        approvedUsersCount: 0,
+        routesCount: 0
+      }
+    ];
+  }
+  loadRoutes(channelId);
+  loadPairingStore(channelId);
+  return [
+    {
+      channelId,
+      displayName: CHANNEL_DISPLAY_NAMES[channelId],
+      configured: true,
+      enabled: config.enabled,
+      running: registry?.getAdapter(channelId)?.isRunning() ?? false,
+      dmPolicy: config.dmPolicy,
+      pendingPairingsCount: getPendingPairings(channelId).length,
+      approvedUsersCount: getApprovedUsers(channelId).length,
+      routesCount: getRoutesForChannel(channelId).length
+    }
+  ];
+}
+function getChannelConfigSnapshot(channelId) {
+  assertSupportedChannelId(channelId);
+  const config = readChannelConfig(channelId);
+  if (!config) {
+    return null;
+  }
+  return toConfigSnapshot(channelId, config);
+}
+async function setChannelConfigLive(channelId, patch) {
+  assertSupportedChannelId(channelId);
+  const existing = readChannelConfig(channelId);
+  const merged = {
+    channel: "telegram",
+    enabled: existing?.enabled ?? false,
+    token: patch.token ?? existing?.token ?? "",
+    dmPolicy: patch.dmPolicy ?? existing?.dmPolicy ?? "pairing",
+    allowedUsers: patch.allowedUsers ?? existing?.allowedUsers ?? []
+  };
+  writeChannelConfig(channelId, merged);
+  if (merged.enabled) {
+    const registry = ensureChannelRegistry();
+    await registry.startChannel(channelId);
+  }
+  return toConfigSnapshot(channelId, merged);
+}
+async function startChannelLive(channelId) {
+  assertSupportedChannelId(channelId);
+  const existing = readChannelConfig(channelId);
+  if (!existing) {
+    throw new Error(`Channel "${channelId}" is not configured. Configure it first.`);
+  }
+  if (!existing.token.trim()) {
+    throw new Error(`Channel "${channelId}" is missing a token. Configure it first.`);
+  }
+  if (!existing.enabled) {
+    writeChannelConfig(channelId, {
+      ...existing,
+      enabled: true
+    });
+  }
+  if (!getChannelRegistry()) {
+    await initializeChannels([channelId]);
+  } else {
+    await ensureChannelRegistry().startChannel(channelId);
+  }
+  const summary = listChannelSummaries().find((entry) => entry.channelId === channelId);
+  if (!summary) {
+    throw new Error(`Channel "${channelId}" summary not found after start`);
+  }
+  return summary;
+}
+async function stopChannelLive(channelId) {
+  assertSupportedChannelId(channelId);
+  const existing = readChannelConfig(channelId);
+  if (!existing) {
+    throw new Error(`Channel "${channelId}" is not configured. Configure it first.`);
+  }
+  writeChannelConfig(channelId, {
+    ...existing,
+    enabled: false
+  });
+  await getChannelRegistry()?.stopChannel(channelId);
+  const summary = listChannelSummaries().find((entry) => entry.channelId === channelId);
+  if (!summary) {
+    throw new Error(`Channel "${channelId}" summary not found after stop`);
+  }
+  return summary;
+}
+function listPendingPairingSnapshots(channelId) {
+  assertSupportedChannelId(channelId);
+  loadPairingStore(channelId);
+  return getPendingPairings(channelId).map(toPendingPairingSnapshot);
+}
+function bindChannelPairing(channelId, code, agentId, conversationId) {
+  assertSupportedChannelId(channelId);
+  loadRoutes(channelId);
+  loadPairingStore(channelId);
+  const result = completePairing(channelId, code, agentId, conversationId);
+  if (!result.success || !result.chatId) {
+    throw new Error(result.error ?? "Failed to bind pairing");
+  }
+  const route = getRoute(channelId, result.chatId);
+  if (!route) {
+    throw new Error("Pairing succeeded but route was not found");
+  }
+  return {
+    chatId: result.chatId,
+    route: toRouteSnapshot(channelId, route)
+  };
+}
+function listChannelRouteSnapshots(params) {
+  const channelId = params?.channelId ?? "telegram";
+  assertSupportedChannelId(channelId);
+  loadRoutes(channelId);
+  return getRoutesForChannel(channelId).filter((route) => params?.agentId ? route.agentId === params.agentId : true).filter((route) => params?.conversationId ? route.conversationId === params.conversationId : true).map((route) => toRouteSnapshot(channelId, route));
+}
+function removeChannelRouteLive(channelId, chatId) {
+  assertSupportedChannelId(channelId);
+  loadRoutes(channelId);
+  return removeRoute(channelId, chatId);
+}
+var CHANNEL_DISPLAY_NAMES;
+var init_service = __esm(() => {
+  init_config();
+  init_pairing();
+  init_registry();
+  init_routing();
+  CHANNEL_DISPLAY_NAMES = {
+    telegram: "Telegram"
+  };
+});
+
 // src/agent/memoryScanner.ts
 var exports_memoryScanner = {};
 __export(exports_memoryScanner, {
@@ -94562,6 +95036,29 @@ function emitCronsUpdated(socket, scope) {
     ...scope?.conversation_id !== undefined ? { conversation_id: scope.conversation_id } : {}
   }, "listener_cron_send_failed", "listener_cron_command");
 }
+function emitChannelsUpdated(socket, channelId) {
+  safeSocketSend(socket, {
+    type: "channels_updated",
+    timestamp: Date.now(),
+    ...channelId ? { channel_id: channelId } : {}
+  }, "listener_channels_send_failed", "listener_channels_command");
+}
+function emitChannelPairingsUpdated(socket, channelId) {
+  safeSocketSend(socket, {
+    type: "channel_pairings_updated",
+    timestamp: Date.now(),
+    channel_id: channelId
+  }, "listener_channels_send_failed", "listener_channels_command");
+}
+function emitChannelRoutesUpdated(socket, params) {
+  safeSocketSend(socket, {
+    type: "channel_routes_updated",
+    timestamp: Date.now(),
+    channel_id: params.channelId,
+    ...params.agentId ? { agent_id: params.agentId } : {},
+    ...params.conversationId !== undefined ? { conversation_id: params.conversationId } : {}
+  }, "listener_channels_send_failed", "listener_channels_command");
+}
 async function handleCronCommand(parsed, socket) {
   if (parsed.type === "cron_list") {
     try {
@@ -94699,6 +95196,299 @@ async function handleCronCommand(parsed, socket) {
   }
   return true;
 }
+async function handleChannelsProtocolCommand(parsed, socket, runtime, opts, processQueuedTurn) {
+  const {
+    bindChannelPairing: bindChannelPairing2,
+    getChannelConfigSnapshot: getChannelConfigSnapshot2,
+    listChannelRouteSnapshots: listChannelRouteSnapshots2,
+    listChannelSummaries: listChannelSummaries2,
+    listPendingPairingSnapshots: listPendingPairingSnapshots2,
+    removeChannelRouteLive: removeChannelRouteLive2,
+    setChannelConfigLive: setChannelConfigLive2,
+    startChannelLive: startChannelLive2,
+    stopChannelLive: stopChannelLive2
+  } = await Promise.resolve().then(() => (init_service(), exports_service));
+  if (parsed.type === "channels_list") {
+    try {
+      safeSocketSend(socket, {
+        type: "channels_list_response",
+        request_id: parsed.request_id,
+        success: true,
+        channels: listChannelSummaries2().map((summary) => ({
+          channel_id: summary.channelId,
+          display_name: summary.displayName,
+          configured: summary.configured,
+          enabled: summary.enabled,
+          running: summary.running,
+          dm_policy: summary.dmPolicy,
+          pending_pairings_count: summary.pendingPairingsCount,
+          approved_users_count: summary.approvedUsersCount,
+          routes_count: summary.routesCount
+        }))
+      }, "listener_channels_send_failed", "listener_channels_command");
+    } catch (err) {
+      safeSocketSend(socket, {
+        type: "channels_list_response",
+        request_id: parsed.request_id,
+        success: false,
+        channels: [],
+        error: err instanceof Error ? err.message : "Failed to list channels"
+      }, "listener_channels_send_failed", "listener_channels_command");
+    }
+    return true;
+  }
+  if (parsed.type === "channel_get_config") {
+    try {
+      safeSocketSend(socket, {
+        type: "channel_get_config_response",
+        request_id: parsed.request_id,
+        success: true,
+        config: (() => {
+          const snapshot = getChannelConfigSnapshot2(parsed.channel_id);
+          return snapshot ? {
+            channel_id: snapshot.channelId,
+            enabled: snapshot.enabled,
+            dm_policy: snapshot.dmPolicy,
+            allowed_users: snapshot.allowedUsers,
+            has_token: snapshot.hasToken
+          } : null;
+        })()
+      }, "listener_channels_send_failed", "listener_channels_command");
+    } catch (err) {
+      safeSocketSend(socket, {
+        type: "channel_get_config_response",
+        request_id: parsed.request_id,
+        success: false,
+        config: null,
+        error: err instanceof Error ? err.message : "Failed to read channel config"
+      }, "listener_channels_send_failed", "listener_channels_command");
+    }
+    return true;
+  }
+  if (parsed.type === "channel_set_config") {
+    try {
+      const snapshot = await setChannelConfigLive2(parsed.channel_id, {
+        token: parsed.config.token,
+        dmPolicy: parsed.config.dm_policy,
+        allowedUsers: parsed.config.allowed_users
+      });
+      if (snapshot.enabled) {
+        wireChannelIngress(runtime, socket, opts, processQueuedTurn);
+      }
+      safeSocketSend(socket, {
+        type: "channel_set_config_response",
+        request_id: parsed.request_id,
+        success: true,
+        config: {
+          channel_id: snapshot.channelId,
+          enabled: snapshot.enabled,
+          dm_policy: snapshot.dmPolicy,
+          allowed_users: snapshot.allowedUsers,
+          has_token: snapshot.hasToken
+        }
+      }, "listener_channels_send_failed", "listener_channels_command");
+      emitChannelsUpdated(socket, parsed.channel_id);
+    } catch (err) {
+      safeSocketSend(socket, {
+        type: "channel_set_config_response",
+        request_id: parsed.request_id,
+        success: false,
+        config: null,
+        error: err instanceof Error ? err.message : "Failed to update channel config"
+      }, "listener_channels_send_failed", "listener_channels_command");
+    }
+    return true;
+  }
+  if (parsed.type === "channel_start") {
+    try {
+      const summary = await startChannelLive2(parsed.channel_id);
+      wireChannelIngress(runtime, socket, opts, processQueuedTurn);
+      safeSocketSend(socket, {
+        type: "channel_start_response",
+        request_id: parsed.request_id,
+        success: true,
+        channel: {
+          channel_id: summary.channelId,
+          display_name: summary.displayName,
+          configured: summary.configured,
+          enabled: summary.enabled,
+          running: summary.running,
+          dm_policy: summary.dmPolicy,
+          pending_pairings_count: summary.pendingPairingsCount,
+          approved_users_count: summary.approvedUsersCount,
+          routes_count: summary.routesCount
+        }
+      }, "listener_channels_send_failed", "listener_channels_command");
+      emitChannelsUpdated(socket, parsed.channel_id);
+    } catch (err) {
+      safeSocketSend(socket, {
+        type: "channel_start_response",
+        request_id: parsed.request_id,
+        success: false,
+        channel: null,
+        error: err instanceof Error ? err.message : "Failed to start channel"
+      }, "listener_channels_send_failed", "listener_channels_command");
+    }
+    return true;
+  }
+  if (parsed.type === "channel_stop") {
+    try {
+      const summary = await stopChannelLive2(parsed.channel_id);
+      safeSocketSend(socket, {
+        type: "channel_stop_response",
+        request_id: parsed.request_id,
+        success: true,
+        channel: {
+          channel_id: summary.channelId,
+          display_name: summary.displayName,
+          configured: summary.configured,
+          enabled: summary.enabled,
+          running: summary.running,
+          dm_policy: summary.dmPolicy,
+          pending_pairings_count: summary.pendingPairingsCount,
+          approved_users_count: summary.approvedUsersCount,
+          routes_count: summary.routesCount
+        }
+      }, "listener_channels_send_failed", "listener_channels_command");
+      emitChannelsUpdated(socket, parsed.channel_id);
+    } catch (err) {
+      safeSocketSend(socket, {
+        type: "channel_stop_response",
+        request_id: parsed.request_id,
+        success: false,
+        channel: null,
+        error: err instanceof Error ? err.message : "Failed to stop channel"
+      }, "listener_channels_send_failed", "listener_channels_command");
+    }
+    return true;
+  }
+  if (parsed.type === "channel_pairings_list") {
+    try {
+      safeSocketSend(socket, {
+        type: "channel_pairings_list_response",
+        request_id: parsed.request_id,
+        success: true,
+        channel_id: parsed.channel_id,
+        pending: listPendingPairingSnapshots2(parsed.channel_id).map((pending) => ({
+          code: pending.code,
+          sender_id: pending.senderId,
+          sender_name: pending.senderName,
+          chat_id: pending.chatId,
+          created_at: pending.createdAt,
+          expires_at: pending.expiresAt
+        }))
+      }, "listener_channels_send_failed", "listener_channels_command");
+    } catch (err) {
+      safeSocketSend(socket, {
+        type: "channel_pairings_list_response",
+        request_id: parsed.request_id,
+        success: false,
+        channel_id: parsed.channel_id,
+        pending: [],
+        error: err instanceof Error ? err.message : "Failed to list pending pairings"
+      }, "listener_channels_send_failed", "listener_channels_command");
+    }
+    return true;
+  }
+  if (parsed.type === "channel_pairing_bind") {
+    try {
+      const result = bindChannelPairing2(parsed.channel_id, parsed.code, parsed.runtime.agent_id, parsed.runtime.conversation_id);
+      safeSocketSend(socket, {
+        type: "channel_pairing_bind_response",
+        request_id: parsed.request_id,
+        success: true,
+        channel_id: parsed.channel_id,
+        chat_id: result.chatId,
+        route: {
+          channel_id: result.route.channelId,
+          chat_id: result.route.chatId,
+          agent_id: result.route.agentId,
+          conversation_id: result.route.conversationId,
+          enabled: result.route.enabled,
+          created_at: result.route.createdAt
+        }
+      }, "listener_channels_send_failed", "listener_channels_command");
+      emitChannelPairingsUpdated(socket, parsed.channel_id);
+      emitChannelRoutesUpdated(socket, {
+        channelId: parsed.channel_id,
+        agentId: parsed.runtime.agent_id,
+        conversationId: parsed.runtime.conversation_id
+      });
+      emitChannelsUpdated(socket, parsed.channel_id);
+    } catch (err) {
+      safeSocketSend(socket, {
+        type: "channel_pairing_bind_response",
+        request_id: parsed.request_id,
+        success: false,
+        channel_id: parsed.channel_id,
+        route: null,
+        error: err instanceof Error ? err.message : "Failed to bind pairing"
+      }, "listener_channels_send_failed", "listener_channels_command");
+    }
+    return true;
+  }
+  if (parsed.type === "channel_routes_list") {
+    try {
+      const channelId = parsed.channel_id ?? "telegram";
+      safeSocketSend(socket, {
+        type: "channel_routes_list_response",
+        request_id: parsed.request_id,
+        success: true,
+        channel_id: channelId,
+        routes: listChannelRouteSnapshots2({
+          channelId,
+          agentId: parsed.agent_id,
+          conversationId: parsed.conversation_id
+        }).map((route) => ({
+          channel_id: route.channelId,
+          chat_id: route.chatId,
+          agent_id: route.agentId,
+          conversation_id: route.conversationId,
+          enabled: route.enabled,
+          created_at: route.createdAt
+        }))
+      }, "listener_channels_send_failed", "listener_channels_command");
+    } catch (err) {
+      safeSocketSend(socket, {
+        type: "channel_routes_list_response",
+        request_id: parsed.request_id,
+        success: false,
+        channel_id: parsed.channel_id,
+        routes: [],
+        error: err instanceof Error ? err.message : "Failed to list routes"
+      }, "listener_channels_send_failed", "listener_channels_command");
+    }
+    return true;
+  }
+  try {
+    const found = removeChannelRouteLive2(parsed.channel_id, parsed.chat_id);
+    safeSocketSend(socket, {
+      type: "channel_route_remove_response",
+      request_id: parsed.request_id,
+      success: true,
+      channel_id: parsed.channel_id,
+      chat_id: parsed.chat_id,
+      found
+    }, "listener_channels_send_failed", "listener_channels_command");
+    if (found) {
+      emitChannelRoutesUpdated(socket, {
+        channelId: parsed.channel_id
+      });
+      emitChannelsUpdated(socket, parsed.channel_id);
+    }
+  } catch (err) {
+    safeSocketSend(socket, {
+      type: "channel_route_remove_response",
+      request_id: parsed.request_id,
+      success: false,
+      channel_id: parsed.channel_id,
+      chat_id: parsed.chat_id,
+      found: false,
+      error: err instanceof Error ? err.message : "Failed to remove route"
+    }, "listener_channels_send_failed", "listener_channels_command");
+  }
+  return true;
+}
 function emitSkillsUpdated(socket) {
   safeSocketSend(socket, {
     type: "skills_updated",
@@ -94958,6 +95748,12 @@ function wireChannelIngress(listener, socket, opts, processQueuedTurn) {
     enqueueChannelTurn(conversationRuntime, route, xmlContent);
     scheduleQueuePump(conversationRuntime, socket, opts, processQueuedTurn);
   });
+  registry.setEventHandler((event) => {
+    if (event.type === "pairings_updated") {
+      emitChannelPairingsUpdated(socket, event.channelId);
+      emitChannelsUpdated(socket, event.channelId);
+    }
+  });
   registry.setReady();
 }
 function enqueueChannelTurn(runtime, route, xmlContent) {
@@ -96196,6 +96992,12 @@ async function connectWithRetry(runtime, opts, attempt = 0, startTime = Date.now
         });
         return;
       }
+      if (isChannelsListCommand(parsed) || isChannelGetConfigCommand(parsed) || isChannelSetConfigCommand(parsed) || isChannelStartCommand(parsed) || isChannelStopCommand(parsed) || isChannelPairingsListCommand(parsed) || isChannelPairingBindCommand(parsed) || isChannelRoutesListCommand(parsed) || isChannelRouteRemoveCommand(parsed)) {
+        runDetachedListenerTask("channels_command", async () => {
+          await handleChannelsProtocolCommand(parsed, socket, runtime, opts, processQueuedTurn);
+        });
+        return;
+      }
       if (isSkillEnableCommand(parsed) || isSkillDisableCommand(parsed)) {
         runDetachedListenerTask("skill_command", async () => {
           await handleSkillCommand(parsed, socket);
@@ -96696,6 +97498,7 @@ var init_client4 = __esm(async () => {
     handleAbortMessageInput,
     handleChangeDeviceStateInput,
     handleCronCommand,
+    handleChannelsProtocolCommand,
     handleSkillCommand,
     handleCreateAgentCommand,
     handleReflectionSettingsCommand,
@@ -115871,7 +116674,7 @@ function xml(hljs) {
     ]
   };
 }
-var init_xml = () => {};
+var init_xml2 = () => {};
 
 // node_modules/highlight.js/es/languages/yaml.js
 function yaml(hljs) {
@@ -116091,7 +116894,7 @@ var init_common = __esm(() => {
   init_typescript2();
   init_vbnet();
   init_wasm();
-  init_xml();
+  init_xml2();
   init_yaml();
   grammars = {
     arduino,
@@ -165182,4 +165985,4 @@ Error during initialization: ${message}`);
 }
 main();
 
-//# debugId=CB456D0ECB3C77E564756E2164756E21
+//# debugId=177C3FD8089A6F3E64756E2164756E21