@hopgoldy/agent-bridge 0.3.0 → 0.3.4

package/README.md

@@ -78,6 +78,8 @@ agent-bridge remove <channel-name>
 
 Config file: `~/.config/agent-bridge/config.json`
 
+Architecture overview: [`docs/architecture-design.md`](./docs/architecture-design.md)
+
 Command usage across IM adapters: [`docs/command-system.md`](./docs/command-system.md)
 
 ## Development

package/dist/agent-bridge.js

@@ -2,6 +2,7 @@
 
 // src/cli.ts
 import process2 from "process";
+import { createRequire } from "module";
 import { Command } from "commander";
 
 // src/config/prompt.ts
@@ -106,6 +107,85 @@ import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from
 import os2 from "os";
 import path2 from "path";
 
+// src/i18n/index.ts
+import i18next from "i18next";
+var DEFAULT_LOCALE = "en-US";
+var resources = {
+  "en-US": {
+    translation: {
+      progress: {
+        noProgress: "No progress yet.",
+        collapsed: "Collapsed {{count}} earlier updates.",
+        running: "Running {{subject}}",
+        finished: "Finished {{subject}}",
+        failed: "Failed {{subject}}",
+        failedWithDetail: "Failed {{subject}}: {{detail}}",
+        compacting: "Compacting session",
+        compactingWithDetail: "Compacting session: {{detail}}"
+      },
+      client: {
+        processing: "Processing...",
+        helpMessage: "Available commands:\n\n- `/new` (`/n`) - Start a new agent session\n- `/compact` (`/c`) - Compact the current session context\n- `/stop` (`/s`) - Stop the active agent run\n- `/help` (`/h`) - Show this help message",
+        messageDeliveryFailedTitle: "[agent-bridge error] Message delivery failed",
+        weixinCooldown: "Weixin send is cooling down after rate limiting. Please try again shortly."
+      },
+      gateway: {
+        noActiveSessionToCompact: "No active agent session to compact.",
+        noActiveSessionToStop: "No active agent session to stop.",
+        sessionCannotBeStopped: "This agent session cannot be stopped right now.",
+        noActiveRunToStop: "No active agent run to stop.",
+        startedNewSession: "Started a new session."
+      }
+    }
+  },
+  "zh-CN": {
+    translation: {
+      progress: {
+        noProgress: "\u6682\u65E0\u8FDB\u5EA6\u3002",
+        collapsed: "\u5DF2\u6298\u53E0 {{count}} \u6761\u8F83\u65E9\u66F4\u65B0\u3002",
+        running: "\u6B63\u5728\u6267\u884C {{subject}}",
+        finished: "\u5DF2\u5B8C\u6210 {{subject}}",
+        failed: "{{subject}} \u6267\u884C\u5931\u8D25",
+        failedWithDetail: "{{subject}} \u6267\u884C\u5931\u8D25\uFF1A{{detail}}",
+        compacting: "\u6B63\u5728\u538B\u7F29\u4F1A\u8BDD",
+        compactingWithDetail: "\u6B63\u5728\u538B\u7F29\u4F1A\u8BDD: {{detail}}"
+      },
+      client: {
+        processing: "\u6B63\u5728\u5904\u7406\u4E2D...",
+        helpMessage: "\u53EF\u7528\u547D\u4EE4\uFF1A\n\n- `/new` (`/n`) - \u5F00\u59CB\u4E00\u4E2A\u65B0\u4F1A\u8BDD\n- `/compact` (`/c`) - \u538B\u7F29\u5F53\u524D\u4F1A\u8BDD\u4E0A\u4E0B\u6587\n- `/stop` (`/s`) - \u505C\u6B62\u5F53\u524D\u6B63\u5728\u8FD0\u884C\u7684\u4EFB\u52A1\n- `/help` (`/h`) - \u67E5\u770B\u8FD9\u6761\u5E2E\u52A9\u4FE1\u606F",
+        messageDeliveryFailedTitle: "[agent-bridge \u9519\u8BEF] \u6D88\u606F\u53D1\u9001\u5931\u8D25",
+        weixinCooldown: "\u5FAE\u4FE1\u53D1\u9001\u56E0\u9650\u6D41\u5DF2\u8FDB\u5165\u51B7\u5374\uFF0C\u8BF7\u7A0D\u540E\u518D\u8BD5\u3002"
+      },
+      gateway: {
+        noActiveSessionToCompact: "\u5F53\u524D\u6CA1\u6709\u53EF\u538B\u7F29\u7684\u667A\u80FD\u4F53\u4F1A\u8BDD\u3002",
+        noActiveSessionToStop: "\u5F53\u524D\u6CA1\u6709\u53EF\u505C\u6B62\u7684\u667A\u80FD\u4F53\u4F1A\u8BDD\u3002",
+        sessionCannotBeStopped: "\u5F53\u524D\u65E0\u6CD5\u505C\u6B62\u8FD9\u4E2A\u667A\u80FD\u4F53\u4F1A\u8BDD\u3002",
+        noActiveRunToStop: "\u5F53\u524D\u6CA1\u6709\u6B63\u5728\u8FD0\u884C\u7684\u667A\u80FD\u4F53\u4EFB\u52A1\u53EF\u505C\u6B62\u3002",
+        startedNewSession: "\u5DF2\u5F00\u59CB\u65B0\u4F1A\u8BDD\u3002"
+      }
+    }
+  }
+};
+var instance = i18next.createInstance();
+void instance.init({
+  lng: DEFAULT_LOCALE,
+  fallbackLng: DEFAULT_LOCALE,
+  resources,
+  interpolation: { escapeValue: false },
+  initImmediate: false
+});
+function getTranslator(locale) {
+  return instance.getFixedT(locale);
+}
+function getTranslatorForCommon(common) {
+  return getTranslator(common?.language ?? DEFAULT_LOCALE);
+}
+function formatSendFailureNotice(t, detail) {
+  return `${t("client.messageDeliveryFailedTitle")}
+
+${detail}`;
+}
+
 // src/config/defaults.ts
 var DEFAULTS = {
   agentIdleTimeoutMs: 10 * 60 * 1e3
@@ -114,11 +194,20 @@ var DEFAULTS = {
 // src/config/store.ts
 var CONFIG_DIR = path2.join(os2.homedir(), ".config", "agent-bridge");
 var CONFIG_PATH = path2.join(CONFIG_DIR, "config.json");
+function normalizeLanguage(language) {
+  return language === "en-US" || language === "zh-CN" ? language : DEFAULT_LOCALE;
+}
 function normalizeChannelConfig(channel) {
   if (!channel.client || !channel.agent) {
     throw new Error("Invalid channel config shape");
   }
-  return channel;
+  return {
+    common: {
+      language: normalizeLanguage(channel.common?.language)
+    },
+    client: channel.client,
+    agent: channel.agent
+  };
 }
 function mergeDefaults(config = {}) {
   const channels = Object.fromEntries(
@@ -193,16 +282,20 @@ var GatewayCore = class {
   #agentConfig;
   #agentIdleTimeoutMs;
   #bindingStore;
+  #common;
+  #t;
   #logger = createLogger("core");
   #clientToAgentSession = /* @__PURE__ */ new Map();
   #agentRuntimes = /* @__PURE__ */ new Map();
   #started = false;
-  constructor({ imAdapter, agentModule, agentConfig, agentIdleTimeoutMs, bindingStore }) {
+  constructor({ imAdapter, agentModule, agentConfig, agentIdleTimeoutMs, bindingStore, common }) {
     this.#imAdapter = imAdapter;
     this.#agentModule = agentModule;
     this.#agentConfig = agentConfig;
     this.#agentIdleTimeoutMs = agentIdleTimeoutMs;
     this.#bindingStore = bindingStore;
+    this.#common = common;
+    this.#t = getTranslatorForCommon(common);
   }
   async start() {
     if (this.#started) return;
@@ -258,7 +351,7 @@ var GatewayCore = class {
       await this.#deliverClientInput({
         type: "assistant.message",
         clientSessionId,
-        text: "No active agent session to compact."
+        text: this.#t("gateway.noActiveSessionToCompact")
       });
       return;
     }
@@ -273,7 +366,7 @@ var GatewayCore = class {
       await this.#deliverClientInput({
         type: "assistant.message",
         clientSessionId,
-        text: "No active agent session to stop."
+        text: this.#t("gateway.noActiveSessionToStop")
       });
       return;
     }
@@ -282,7 +375,7 @@ var GatewayCore = class {
       await this.#deliverClientInput({
         type: "assistant.message",
         clientSessionId,
-        text: "This agent session cannot be stopped right now."
+        text: this.#t("gateway.sessionCannotBeStopped")
       });
       return;
     }
@@ -290,7 +383,7 @@ var GatewayCore = class {
       await this.#deliverClientInput({
         type: "assistant.message",
         clientSessionId,
-        text: "No active agent run to stop."
+        text: this.#t("gateway.noActiveRunToStop")
       });
       return;
     }
@@ -309,7 +402,7 @@ var GatewayCore = class {
     await this.#deliverClientInput({
       type: "assistant.message",
       clientSessionId,
-      text: "Started a new session."
+      text: this.#t("gateway.startedNewSession")
     });
   }
   async #deliverClientInput(event) {
@@ -344,6 +437,7 @@ var GatewayCore = class {
     if (this.#agentModule.resumeAgentSession) {
       const agentAdapter = await this.#agentModule.resumeAgentSession({
         config: this.#agentConfig,
+        common: this.#common ?? { channelName: "", language: "en-US" },
         agentSessionId
       });
       return this.#startRuntime(clientSessionId, agentSessionId, agentAdapter);
@@ -354,7 +448,8 @@ var GatewayCore = class {
   }
   async #createRuntimeForClient(clientSessionId) {
     const { agentSessionId, agentAdapter } = await this.#agentModule.createAgentSession({
-      config: this.#agentConfig
+      config: this.#agentConfig,
+      common: this.#common ?? { channelName: "", language: "en-US" }
     });
     return this.#startRuntime(clientSessionId, agentSessionId, agentAdapter);
   }
@@ -1127,7 +1222,7 @@ var PiCodingAgentAdapter = class {
         toolInput,
         toolLabel,
         result: "result" in rpcEvent ? rpcEvent.result : void 0,
-        text: isError ? `Failed ${toolName}` : `Finished ${toolName}`
+        text: isError ? void 0 : `Finished ${toolName}`
       });
       if (toolCallId) {
         this.#toolLabelByCallId.delete(toolCallId);
@@ -1292,16 +1387,16 @@ function createPiCodingAgentConfigCollector() {
 var piCodingAgentModule = {
   type: "pi-coding-agent",
   createConfigCollector: createPiCodingAgentConfigCollector,
-  async createAgentSession({ config }) {
+  async createAgentSession({ config, common }) {
     const agentSessionId = `pi-coding-agent:${randomUUID()}`;
-    logger.info(`creating agent session ${agentSessionId}`);
+    logger.info(`creating agent session ${agentSessionId} for channel ${common.channelName}`);
     return {
       agentSessionId,
       agentAdapter: buildAdapter(config, agentSessionId)
     };
   },
-  async resumeAgentSession({ config, agentSessionId }) {
-    logger.info(`resuming agent session ${agentSessionId}`);
+  async resumeAgentSession({ config, common, agentSessionId }) {
+    logger.info(`resuming agent session ${agentSessionId} for channel ${common.channelName}`);
     return buildAdapter(config, agentSessionId);
   }
 };
@@ -1325,14 +1420,15 @@ function getTypedAgentModule(config) {
 // src/modules/client/utils/progress-renderer.ts
 var DEFAULT_COLLAPSE_THRESHOLD = 10;
 var MAX_TOOL_LABEL_DISPLAY_LENGTH = 15;
-var NO_PROGRESS_MARKDOWN = "No progress yet.";
 var ProgressRenderer = class {
   #collapseThreshold;
+  #t;
   #entries = /* @__PURE__ */ new Map();
   #order = [];
   #status = "running";
   constructor(options = {}) {
     this.#collapseThreshold = options.collapseThreshold ?? DEFAULT_COLLAPSE_THRESHOLD;
+    this.#t = options.t ?? getTranslator("en-US");
   }
   /** Whether `event` should be recorded as progress (excludes assistant messages and thinking). */
   isProgressEvent(event) {
@@ -1354,20 +1450,21 @@ var ProgressRenderer = class {
     return {
       markdown: this.#renderMarkdown(collapsedCount),
       status: this.#status,
-      collapsedCount
+      collapsedCount,
+      isEmpty: this.#order.length === 0
     };
   }
   #renderMarkdown(collapsedCount) {
     const contentLines = [];
     if (collapsedCount > 0) {
-      contentLines.push(`- Collapsed ${collapsedCount} earlier updates.`);
+      contentLines.push(`- ${this.#t("progress.collapsed", { count: collapsedCount })}`);
     }
     for (const id of this.#visibleOrder()) {
       const entry = this.#entries.get(id);
       if (!entry) continue;
       contentLines.push(entry.kind === "line" ? entry.line : this.#formatToolEntry(entry));
     }
-    return contentLines.length > 0 ? contentLines.join("\n") : NO_PROGRESS_MARKDOWN;
+    return contentLines.length > 0 ? contentLines.join("\n") : this.#t("progress.noProgress");
   }
   #visibleOrder() {
     return this.#order.slice(-this.#collapseThreshold);
@@ -1380,9 +1477,6 @@ var ProgressRenderer = class {
   #upsertToolEntry(id, event) {
     if (!this.#entries.has(id)) {
       this.#order.push(id);
-    } else {
-      this.#order = this.#order.filter((entryId) => entryId !== id);
-      this.#order.push(id);
     }
     this.#entries.set(id, {
       kind: "tool",
@@ -1402,9 +1496,9 @@ var ProgressRenderer = class {
     const subject = this.#formatToolSubject(entry.toolName, entry.toolLabel);
     switch (entry.status) {
       case "running":
-        return `- Running ${subject}`;
+        return `- ${this.#t("progress.running", { subject })}`;
       case "done":
-        return `- Finished ${subject}`;
+        return `- ${this.#t("progress.finished", { subject })}`;
       case "error":
         return this.#formatToolErrorLine(subject, entry.text);
     }
@@ -1412,12 +1506,12 @@ var ProgressRenderer = class {
   #formatProgressLine(event) {
     switch (event.type) {
       case "session.compacting":
-        return `- Compacting session${event.text ? `: ${event.text}` : ""}`;
+        return `- ${event.text ? this.#t("progress.compactingWithDetail", { detail: event.text }) : this.#t("progress.compacting")}`;
       case "assistant.tool.running":
       case "assistant.tool.update":
-        return `- Running ${this.#formatToolSubject(event.toolName, event.toolLabel)}`;
+        return `- ${this.#t("progress.running", { subject: this.#formatToolSubject(event.toolName, event.toolLabel) })}`;
       case "assistant.tool.done":
-        return `- Finished ${this.#formatToolSubject(event.toolName, event.toolLabel)}`;
+        return `- ${this.#t("progress.finished", { subject: this.#formatToolSubject(event.toolName, event.toolLabel) })}`;
       case "assistant.tool.error":
         return this.#formatToolErrorLine(this.#formatToolSubject(event.toolName, event.toolLabel), event.text);
     }
@@ -1439,13 +1533,13 @@ var ProgressRenderer = class {
     }
     const lowerText = normalizedText.toLowerCase();
     const lowerToolName = toolName.toLowerCase();
-    if (lowerText === lowerToolName || lowerText === `failed ${lowerToolName}` || lowerText === `running ${lowerToolName}` || lowerText === `finished ${lowerToolName}`) {
+    if (lowerText === lowerToolName || lowerText === this.#t("progress.failed", { subject: toolName }).toLowerCase() || lowerText === this.#t("progress.running", { subject: toolName }).toLowerCase() || lowerText === this.#t("progress.finished", { subject: toolName }).toLowerCase()) {
       return `- ${this.#humanizeToolError(toolName)}`;
     }
-    return `- ${this.#humanizeToolError(toolName)}: ${normalizedText}`;
+    return `- ${this.#t("progress.failedWithDetail", { subject: toolName, detail: normalizedText })}`;
   }
   #humanizeToolError(toolName) {
-    return `Failed ${toolName}`;
+    return this.#t("progress.failed", { subject: toolName });
   }
   #progressStatus(event) {
     switch (event.type) {
@@ -1460,6 +1554,18 @@ var ProgressRenderer = class {
 };
 
 // src/modules/client/utils/slash-commands.ts
+function isHelpCommand(text2) {
+  switch (text2.toLowerCase()) {
+    case "/help":
+    case "/h":
+      return true;
+    default:
+      return false;
+  }
+}
+function resolveHelpMarkdown(text2, t) {
+  return isHelpCommand(text2) ? t("client.helpMessage") : null;
+}
 function parseSlashCommand(text2, clientSessionId) {
   switch (text2.toLowerCase()) {
     case "/new":
@@ -1469,6 +1575,7 @@ function parseSlashCommand(text2, clientSessionId) {
     case "/c":
       return { type: "command.session.compact", clientSessionId };
     case "/stop":
+    case "/s":
       return { type: "command.session.stop", clientSessionId };
     default:
       return null;
@@ -1821,6 +1928,7 @@ function chunkText(text2, maxLen) {
 var FeishuIMAdapter = class _FeishuIMAdapter {
   #config;
   #logger;
+  #t;
   #onOutput = null;
   #client = null;
   #egressQueue = [];
@@ -1845,18 +1953,17 @@ var FeishuIMAdapter = class _FeishuIMAdapter {
       return;
     }
     const message = error instanceof Error ? error.message : String(error);
-    const text2 = `[agent-bridge error] Message delivery failed
-
-${message}`;
+    const text2 = formatSendFailureNotice(this.#t, message);
     try {
       await this.#client.sendText(chatId, text2);
     } catch (notifyError) {
       this.#logger.error("failed to notify send failure:", notifyError);
     }
   }
-  constructor(config, logger3 = createLogger("feishu")) {
+  constructor(config, logger3 = createLogger("feishu"), common) {
     this.#config = config;
     this.#logger = logger3;
+    this.#t = getTranslatorForCommon(common);
   }
   async start(onOutput) {
     this.#onOutput = onOutput;
@@ -1873,16 +1980,22 @@ ${message}`;
         );
         return;
       }
-      this.#lastInboundMessageIdBySession.set(clientSessionId, messageId);
-      this.#resetProgressState(clientSessionId);
-      await this.#client?.startTyping(chatId, messageId);
       const normalizedText = text2.trim();
+      const helpMarkdown = resolveHelpMarkdown(normalizedText, this.#t);
+      if (helpMarkdown) {
+        this.#logger.info(`received local help command ${normalizedText} (session=${clientSessionId})`);
+        await this.#client?.sendText(chatId, helpMarkdown, messageId);
+        return;
+      }
       const commandEvent = parseSlashCommand(normalizedText, clientSessionId);
       if (commandEvent) {
         this.#logger.info(`received command ${normalizedText} (session=${clientSessionId})`);
         await this.#onOutput(commandEvent);
         return;
       }
+      this.#lastInboundMessageIdBySession.set(clientSessionId, messageId);
+      this.#resetProgressState(clientSessionId);
+      await this.#client?.startTyping(chatId, messageId);
       this.#logger.info(`received user message (session=${clientSessionId}): ${normalizedText}`);
       await this.#onOutput({
         type: "user.message",
@@ -1969,7 +2082,7 @@ ${message}`;
       return;
     }
     const state = this.#progressStateBySession.get(event.clientSessionId) ?? {
-      renderer: new ProgressRenderer(),
+      renderer: new ProgressRenderer({ t: this.#t }),
       messageId: null,
       creating: false
     };
@@ -1999,7 +2112,7 @@ ${message}`;
   }
   #resetProgressState(clientSessionId) {
     this.#progressStateBySession.set(clientSessionId, {
-      renderer: new ProgressRenderer(),
+      renderer: new ProgressRenderer({ t: this.#t }),
       messageId: null,
       creating: false
     });
@@ -2051,8 +2164,8 @@ function createFeishuConfigCollector() {
 var feishuClientModule = {
   type: "feishu",
   createConfigCollector: createFeishuConfigCollector,
-  createClientAdapter(config) {
-    return new FeishuIMAdapter(config);
+  createClientAdapter({ config, common }) {
+    return new FeishuIMAdapter(config, void 0, common);
   }
 };
 
@@ -2522,7 +2635,6 @@ function parseWecomSessionId(clientSessionId) {
 
 // src/modules/client/wecom/adapter/wecom-im-adapter.ts
 var MAX_TEXT_CHUNK2 = 4e3;
-var STARTING_MESSAGE = "Processing...";
 function chunkText2(text2, maxLen) {
   if (text2.length <= maxLen) return [text2];
   const chunks = [];
@@ -2549,6 +2661,7 @@ function chunkText2(text2, maxLen) {
 var WecomIMAdapter = class {
   #config;
   #logger;
+  #t;
   #onOutput = null;
   #client = null;
   #egressQueue = [];
@@ -2564,18 +2677,17 @@ var WecomIMAdapter = class {
       return;
     }
     const message = error instanceof Error ? error.message : String(error);
-    const text2 = `[agent-bridge error] Message delivery failed
-
-${message}`;
+    const text2 = formatSendFailureNotice(this.#t, message);
     try {
       await this.#client.sendText(chatId, text2);
     } catch (notifyError) {
       this.#logger.error("failed to notify send failure:", notifyError);
     }
   }
-  constructor(config, logger3 = createLogger("wecom")) {
+  constructor(config, logger3 = createLogger("wecom"), common) {
     this.#config = config;
     this.#logger = logger3;
+    this.#t = getTranslatorForCommon(common);
   }
   async start(onOutput) {
     this.#onOutput = onOutput;
@@ -2601,6 +2713,11 @@ ${message}`;
         return;
       }
       const normalizedText = text2.trim();
+      const helpMarkdown = resolveHelpMarkdown(normalizedText, this.#t);
+      if (helpMarkdown) {
+        await this.#client?.sendText(chatId, helpMarkdown, messageId);
+        return;
+      }
       const commandEvent = parseSlashCommand(normalizedText, clientSessionId);
       if (commandEvent) {
         await this.#onOutput(commandEvent);
@@ -2691,7 +2808,7 @@ ${message}`;
     if (!state || state.announced || !this.#client) {
       return;
     }
-    await this.#client.sendStreamText(chatId, STARTING_MESSAGE, {
+    await this.#client.sendStreamText(chatId, this.#t("client.processing"), {
       replyToMessageId: messageId,
       finish: false
     });
@@ -2702,7 +2819,7 @@ ${message}`;
       return;
     }
     const state = this.#progressStateBySession.get(event.clientSessionId) ?? {
-      renderer: new ProgressRenderer(),
+      renderer: new ProgressRenderer({ t: this.#t }),
       announced: false
     };
     this.#progressStateBySession.set(event.clientSessionId, state);
@@ -2725,7 +2842,7 @@ ${message}`;
     }
     this.#progressStateBySession.delete(clientSessionId);
     const progress = state.renderer.getCurrentProgress();
-    const body = progress.markdown === NO_PROGRESS_MARKDOWN ? STARTING_MESSAGE : progress.markdown;
+    const body = progress.isEmpty ? this.#t("client.processing") : progress.markdown;
     try {
       await this.#client.sendStreamText(chatId, body, { replyToMessageId, finish: true });
     } catch (error) {
@@ -2734,7 +2851,7 @@ ${message}`;
   }
   #resetProgressState(clientSessionId) {
     this.#progressStateBySession.set(clientSessionId, {
-      renderer: new ProgressRenderer(),
+      renderer: new ProgressRenderer({ t: this.#t }),
       announced: false
     });
   }
@@ -2781,8 +2898,8 @@ function createWecomConfigCollector() {
 var wecomClientModule = {
   type: "wecom",
   createConfigCollector: createWecomConfigCollector,
-  createClientAdapter(config) {
-    return new WecomIMAdapter(config);
+  createClientAdapter({ config, common }) {
+    return new WecomIMAdapter(config, void 0, common);
   }
 };
 
@@ -3090,6 +3207,7 @@ function chunkText3(text2, maxLen) {
 var WeixinIMAdapter = class {
   #config;
   #logger;
+  #t;
   #onOutput = null;
   #client = null;
   #egressQueue = [];
@@ -3100,9 +3218,10 @@ var WeixinIMAdapter = class {
   #recentInboundContentKeys = /* @__PURE__ */ new Map();
   #rateLimitEvents = [];
   #rateLimitCircuitUntil = 0;
-  constructor(config, logger3 = createLogger("weixin")) {
+  constructor(config, logger3 = createLogger("weixin"), common) {
     this.#config = config;
     this.#logger = logger3;
+    this.#t = getTranslatorForCommon(common);
   }
   async start(onOutput) {
     this.#onOutput = onOutput;
@@ -3123,8 +3242,13 @@ var WeixinIMAdapter = class {
         this.#logger.debug(`ignoring unsupported Weixin group message (session=${clientSessionId})`);
         return;
       }
-      this.#resetProgressState(clientSessionId);
       const normalizedText = text2.trim();
+      const helpMarkdown = resolveHelpMarkdown(normalizedText, this.#t);
+      if (helpMarkdown) {
+        await this.#client?.sendText(chatId, helpMarkdown);
+        return;
+      }
+      this.#resetProgressState(clientSessionId);
       const commandEvent = parseSlashCommand(normalizedText, clientSessionId);
       if (commandEvent) {
         await this.#onOutput(commandEvent);
@@ -3244,9 +3368,7 @@ var WeixinIMAdapter = class {
       return;
     }
     const message = error instanceof Error ? error.message : String(error);
-    const text2 = `[agent-bridge error] Message delivery failed
-
-${message}`;
+    const text2 = formatSendFailureNotice(this.#t, message);
     try {
       await this.#client.sendText(chatId, text2);
     } catch (notifyError) {
@@ -3259,7 +3381,7 @@ ${message}`;
     }
     const now = Date.now();
     if (this.#rateLimitCircuitUntil > now) {
-      throw new Error("Weixin send is cooling down after rate limiting. Please try again shortly.");
+      throw new Error(this.#t("client.weixinCooldown"));
     }
     if (this.#rateLimitCircuitUntil !== 0 && this.#rateLimitCircuitUntil <= now) {
       this.#rateLimitCircuitUntil = 0;
@@ -3275,7 +3397,7 @@ ${message}`;
       if (this.#isRateLimitError(error)) {
         this.#recordRateLimitEvent(now);
         if (this.#rateLimitCircuitUntil > now) {
-          throw new Error("Weixin send is cooling down after rate limiting. Please try again shortly.");
+          throw new Error(this.#t("client.weixinCooldown"));
         }
       }
       throw error;
@@ -3304,7 +3426,7 @@ ${message}`;
   }
   #createProgressState() {
     return {
-      renderer: new ProgressRenderer(),
+      renderer: new ProgressRenderer({ t: this.#t }),
       dirty: false,
       interval: null
     };
@@ -3489,8 +3611,8 @@ function createWeixinConfigCollector() {
 var weixinClientModule = {
   type: "weixin",
   createConfigCollector: createWeixinConfigCollector,
-  createClientAdapter(config) {
-    return new WeixinIMAdapter(config);
+  createClientAdapter({ config, common }) {
+    return new WeixinIMAdapter(config, void 0, common);
   }
 };
 
@@ -3519,14 +3641,19 @@ var logger2 = createLogger("runner");
 async function runChannel({ channelName, channelConfig, defaults }) {
   const clientModule = getTypedClientModule(channelConfig.client);
   const agentModule = getTypedAgentModule(channelConfig.agent);
-  const imAdapter = clientModule.createClientAdapter(channelConfig.client.config);
+  const common = {
+    channelName,
+    language: channelConfig.common.language
+  };
+  const imAdapter = clientModule.createClientAdapter({ config: channelConfig.client.config, common });
   const bindingStore = createFileSessionBindingStore(getSessionBindingStorePath(channelName));
   const core = new GatewayCore({
     imAdapter,
     agentModule,
     agentConfig: channelConfig.agent.config,
     agentIdleTimeoutMs: defaults.agentIdleTimeoutMs,
-    bindingStore
+    bindingStore,
+    common
   });
   await core.start();
   logger2.info(`channel ${channelName} started`);
@@ -3540,6 +3667,8 @@ async function runChannel({ channelName, channelConfig, defaults }) {
 }
 
 // src/cli.ts
+var require2 = createRequire(import.meta.url);
+var { version } = require2("../package.json");
 async function selectModuleType(label, modules, ctx) {
   if (modules.length === 0) {
     throw new Error(`No modules available for ${label}`);
@@ -3561,6 +3690,15 @@ async function collectModuleConfig(module, ctx) {
   await collector.validate(config);
   return config;
 }
+async function collectCommonChannelConfig(ctx) {
+  const language = await ctx.select("Channel language", [
+    { label: "English (en-US)", value: "en-US" },
+    { label: "\u4E2D\u6587 (zh-CN)", value: "zh-CN" }
+  ]);
+  return {
+    language
+  };
+}
 async function addChannel(config) {
   const ctx = createPromptContext();
   try {
@@ -3572,6 +3710,7 @@ async function addChannel(config) {
         return null;
       }
     });
+    const commonConfig = await collectCommonChannelConfig(ctx);
     const clientType = await selectModuleType("Select client module", listClientModules(), ctx);
     const clientModule = getClientModule(clientType);
     if (!clientModule) {
@@ -3585,6 +3724,7 @@ async function addChannel(config) {
     }
     const agentConfig = await collectModuleConfig(agentModule, ctx);
     config.channels[name] = {
+      common: commonConfig,
       client: {
         type: clientType,
         config: clientConfig
@@ -3663,7 +3803,7 @@ async function startChannel(channelName) {
 }
 async function runCli(argv = process2.argv) {
   const program = new Command();
-  program.name("agent-bridge").description("IM to Agent bridge CLI").version("0.1.0");
+  program.name("agent-bridge").description("IM to Agent bridge CLI").version(version);
   program.command("add").description("Interactively add a channel").action(async () => {
     const config = await loadConfig();
     await addChannel(config);