@hopgoldy/agent-bridge 0.3.1 → 0.4.0

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,115 @@ 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: "\u23F3 {{subject}}",
+        finished: "\u2705 {{subject}}",
+        failed: "\u274C {{subject}}",
+        failedWithDetail: "\u274C {{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- `/status` (`/st`) - Show the current agent session status\n- `/model` (`/m`) - List available models, or switch with `/model provider/modelId`\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.",
+        statusTitle: "Current session status",
+        statusSessionId: "Session ID",
+        statusModel: "Model",
+        statusThinkingLevel: "Thinking level",
+        statusContext: "Context",
+        statusUnavailable: "Current session status is unavailable.",
+        statusUnavailableValue: "Unavailable",
+        modelListTitle: "Available models",
+        modelListCurrent: "current",
+        modelListUsage: "Use `/model provider/modelId` to switch.",
+        modelListUnavailable: "Available models are unavailable for the current session.",
+        modelSetUnavailable: "Current session model switching is unavailable.",
+        modelInvalid: "The requested model is invalid or unavailable.",
+        modelBusy: "Current session is busy, so the model cannot be switched. Please use `/stop` first.",
+        modelUpdated: "Switched current model to `{{model}}`."
+      },
+      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: "\u23F3 {{subject}}",
+        finished: "\u2705 {{subject}}",
+        failed: "\u274C {{subject}}",
+        failedWithDetail: "\u274C {{subject}}: {{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- `/status` (`/st`) - \u67E5\u770B\u5F53\u524D\u667A\u80FD\u4F53\u4F1A\u8BDD\u72B6\u6001\n- `/model` (`/m`) - \u67E5\u770B\u53EF\u7528\u6A21\u578B\uFF0C\u6216\u4F7F\u7528 `/model provider/modelId` \u5207\u6362\u6A21\u578B\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",
+        statusTitle: "\u5F53\u524D\u4F1A\u8BDD\u72B6\u6001",
+        statusSessionId: "Session ID",
+        statusModel: "\u6A21\u578B",
+        statusThinkingLevel: "\u601D\u8003\u7B49\u7EA7",
+        statusContext: "\u4E0A\u4E0B\u6587",
+        statusUnavailable: "\u5F53\u524D\u65E0\u6CD5\u83B7\u53D6\u4F1A\u8BDD\u72B6\u6001\u3002",
+        statusUnavailableValue: "\u6682\u4E0D\u53EF\u7528",
+        modelListTitle: "\u53EF\u7528\u6A21\u578B",
+        modelListCurrent: "\u5F53\u524D",
+        modelListUsage: "\u4F7F\u7528 `/model provider/modelId` \u5207\u6362\u6A21\u578B\u3002",
+        modelListUnavailable: "\u5F53\u524D\u4F1A\u8BDD\u6682\u65F6\u65E0\u6CD5\u83B7\u53D6\u53EF\u7528\u6A21\u578B\u5217\u8868\u3002",
+        modelSetUnavailable: "\u5F53\u524D\u4F1A\u8BDD\u6682\u65F6\u65E0\u6CD5\u5207\u6362\u6A21\u578B\u3002",
+        modelInvalid: "\u8BF7\u6C42\u7684\u6A21\u578B\u65E0\u6548\u6216\u5F53\u524D\u4E0D\u53EF\u7528\u3002",
+        modelBusy: "\u5F53\u524D\u6B63\u5728\u8FD0\u884C\uFF0C\u65E0\u6CD5\u5207\u6362\u6A21\u578B\u3002\u8BF7\u5148\u4F7F\u7528 `/stop`\u3002",
+        modelUpdated: "\u5F53\u524D\u6A21\u578B\u5DF2\u5207\u6362\u81F3 `{{model}}`\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 +224,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 +312,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;
@@ -242,6 +365,18 @@ var GatewayCore = class {
       await this.#handleSessionStop(event.clientSessionId);
       return;
     }
+    if (event.type === "command.session.status") {
+      await this.#handleSessionStatus(event.clientSessionId);
+      return;
+    }
+    if (event.type === "command.session.model.list") {
+      await this.#handleSessionModelList(event.clientSessionId);
+      return;
+    }
+    if (event.type === "command.session.model.set") {
+      await this.#handleSessionModelSet(event.clientSessionId, event.target);
+      return;
+    }
     await this.#handleUserMessage(event.clientSessionId, event.text);
   }
   async #handleUserMessage(clientSessionId, text2) {
@@ -258,7 +393,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 +408,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 +417,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,12 +425,129 @@ var GatewayCore = class {
       await this.#deliverClientInput({
         type: "assistant.message",
         clientSessionId,
-        text: "No active agent run to stop."
+        text: this.#t("gateway.noActiveRunToStop")
       });
       return;
     }
     await runtime.agentAdapter.abort();
   }
+  async #handleSessionStatus(clientSessionId) {
+    const runtime = await this.#getActiveRuntime(clientSessionId);
+    if (!runtime) {
+      await this.#deliverClientInput({
+        type: "error",
+        clientSessionId,
+        kind: "agent.status.unavailable"
+      });
+      return;
+    }
+    this.#touchRuntime(runtime);
+    if (!runtime.agentAdapter.getStatus) {
+      await this.#deliverClientInput({
+        type: "error",
+        clientSessionId,
+        kind: "agent.status.unavailable"
+      });
+      return;
+    }
+    try {
+      const status = await runtime.agentAdapter.getStatus();
+      await this.#deliverClientInput({
+        type: "agent.status.info",
+        clientSessionId,
+        status
+      });
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      await this.#deliverClientInput({
+        type: "error",
+        clientSessionId,
+        kind: "agent.status.unavailable",
+        detail
+      });
+    }
+  }
+  async #handleSessionModelList(clientSessionId) {
+    const runtime = await this.#getActiveRuntime(clientSessionId);
+    if (!runtime) {
+      await this.#deliverClientInput({
+        type: "error",
+        clientSessionId,
+        kind: "agent.model.list.unavailable"
+      });
+      return;
+    }
+    this.#touchRuntime(runtime);
+    if (!runtime.agentAdapter.getAvailableModels) {
+      await this.#deliverClientInput({
+        type: "error",
+        clientSessionId,
+        kind: "agent.model.list.unavailable"
+      });
+      return;
+    }
+    try {
+      const models = await runtime.agentAdapter.getAvailableModels();
+      await this.#deliverClientInput({
+        type: "agent.model.list",
+        clientSessionId,
+        models
+      });
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      await this.#deliverClientInput({
+        type: "error",
+        clientSessionId,
+        kind: "agent.model.list.unavailable",
+        detail
+      });
+    }
+  }
+  async #handleSessionModelSet(clientSessionId, target) {
+    const runtime = await this.#getActiveRuntime(clientSessionId);
+    if (!runtime) {
+      await this.#deliverClientInput({
+        type: "error",
+        clientSessionId,
+        kind: "agent.model.set.unavailable"
+      });
+      return;
+    }
+    this.#touchRuntime(runtime);
+    if (!runtime.agentAdapter.setModel) {
+      await this.#deliverClientInput({
+        type: "error",
+        clientSessionId,
+        kind: "agent.model.set.unavailable"
+      });
+      return;
+    }
+    if (await runtime.agentAdapter.isBusy()) {
+      await this.#deliverClientInput({
+        type: "error",
+        clientSessionId,
+        kind: "agent.model.busy"
+      });
+      return;
+    }
+    try {
+      const result = await runtime.agentAdapter.setModel(target);
+      await this.#deliverClientInput({
+        type: "agent.model.updated",
+        clientSessionId,
+        provider: result.provider,
+        modelId: result.modelId
+      });
+    } catch (error) {
+      const { kind, detail } = this.#resolveModelCommandError(error);
+      await this.#deliverClientInput({
+        type: "error",
+        clientSessionId,
+        kind,
+        ...detail ? { detail } : {}
+      });
+    }
+  }
   async #handleSessionNew(clientSessionId) {
     const previousAgentSessionId = this.#clientToAgentSession.get(clientSessionId);
     if (previousAgentSessionId) {
@@ -309,7 +561,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 +596,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 +607,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);
   }
@@ -387,6 +641,18 @@ var GatewayCore = class {
       this.#logger.error("failed to persist session bindings:", error);
     }
   }
+  #resolveModelCommandError(error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    if (typeof error === "object" && error && "kind" in error && typeof error.kind === "string") {
+      switch (error.kind) {
+        case "agent.model.invalid":
+        case "agent.model.busy":
+        case "agent.model.set.unavailable":
+          return { kind: error.kind, ...detail ? { detail } : {} };
+      }
+    }
+    return { kind: "agent.model.set.unavailable", ...detail ? { detail } : {} };
+  }
   async #handleAgentOutput(event) {
     const agentSessionId = event.agentSessionId;
     const runtime = this.#agentRuntimes.get(agentSessionId);
@@ -789,6 +1055,19 @@ var PiRpcClient = class {
     const response = await this.#send({ type: "get_state" });
     return response.data ?? {};
   }
+  async getSessionStats() {
+    const response = await this.#send({ type: "get_session_stats" });
+    return response.data ?? {};
+  }
+  async getAvailableModels() {
+    const response = await this.#send({ type: "get_available_models" });
+    const data = response.data;
+    return data?.models ?? [];
+  }
+  async setModel(provider, modelId) {
+    const response = await this.#send({ type: "set_model", provider, modelId });
+    return response.data ?? {};
+  }
   async setSessionName(name) {
     await this.#send({ type: "set_session_name", name });
   }
@@ -895,6 +1174,13 @@ function toPiSessionId(agentSessionId) {
 }
 
 // src/modules/agent/pi-coding-agent/adapter/pi-coding-agent-adapter.ts
+var PiModelCommandError = class extends Error {
+  kind;
+  constructor(kind, message) {
+    super(message);
+    this.kind = kind;
+  }
+};
 var PiCodingAgentAdapter = class {
   #agentSessionId;
   #piSessionId;
@@ -977,6 +1263,71 @@ var PiCodingAgentAdapter = class {
   async isBusy() {
     return this.#processing || this.#inputQueue.length > 0;
   }
+  async getStatus() {
+    if (!this.#client) {
+      throw new Error("PiCodingAgentAdapter is not started");
+    }
+    const [state, stats] = await Promise.all([this.#client.getState(), this.#client.getSessionStats()]);
+    const contextUsage = stats.contextUsage;
+    return {
+      sessionId: state.sessionId ?? this.#agentSessionId,
+      provider: state.model?.provider,
+      modelId: state.model?.id,
+      thinkingLevel: state.thinkingLevel,
+      context: contextUsage ? {
+        tokens: contextUsage.tokens ?? null,
+        contextWindow: contextUsage.contextWindow ?? null,
+        percent: contextUsage.percent ?? null
+      } : void 0
+    };
+  }
+  async getAvailableModels() {
+    if (!this.#client) {
+      throw new Error("PiCodingAgentAdapter is not started");
+    }
+    const [state, models] = await Promise.all([this.#client.getState(), this.#client.getAvailableModels()]);
+    return models.filter((model) => typeof model.provider === "string" && typeof model.id === "string").map((model) => ({
+      provider: model.provider,
+      modelId: model.id,
+      isCurrent: state.model?.provider === model.provider && state.model?.id === model.id
+    }));
+  }
+  async setModel(target) {
+    if (!this.#client) {
+      throw new PiModelCommandError("agent.model.set.unavailable", "PiCodingAgentAdapter is not started");
+    }
+    const parsed = this.#parseModelTarget(target);
+    const state = await this.#client.getState();
+    if (state.isStreaming || state.isCompacting) {
+      throw new PiModelCommandError("agent.model.busy", "Current session is busy, so the model cannot be switched. Please use /stop first.");
+    }
+    try {
+      const result = await this.#client.setModel(parsed.provider, parsed.modelId);
+      return {
+        provider: result.provider ?? parsed.provider,
+        modelId: result.id ?? parsed.modelId
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      if (/Model not found:/i.test(message)) {
+        throw new PiModelCommandError("agent.model.invalid", message);
+      }
+      throw new PiModelCommandError("agent.model.set.unavailable", message);
+    }
+  }
+  #parseModelTarget(target) {
+    const trimmed = target.trim();
+    const slashIndex = trimmed.indexOf("/");
+    if (slashIndex <= 0 || slashIndex === trimmed.length - 1) {
+      throw new PiModelCommandError("agent.model.invalid", `Invalid model target: ${target}`);
+    }
+    const provider = trimmed.slice(0, slashIndex).trim();
+    const modelId = trimmed.slice(slashIndex + 1).trim();
+    if (!provider || !modelId) {
+      throw new PiModelCommandError("agent.model.invalid", `Invalid model target: ${target}`);
+    }
+    return { provider, modelId };
+  }
   async #drainInputQueue() {
     if (this.#processing) {
       return;
@@ -1088,7 +1439,7 @@ var PiCodingAgentAdapter = class {
         toolCallId,
         toolInput,
         toolLabel,
-        text: `Running ${toolName}`
+        text: void 0
       });
       return;
     }
@@ -1109,7 +1460,7 @@ var PiCodingAgentAdapter = class {
         toolInput,
         toolLabel,
         partialResult: "partialResult" in rpcEvent ? rpcEvent.partialResult : void 0,
-        text: `Running ${toolName}`
+        text: void 0
       });
       return;
     }
@@ -1127,7 +1478,7 @@ var PiCodingAgentAdapter = class {
         toolInput,
         toolLabel,
         result: "result" in rpcEvent ? rpcEvent.result : void 0,
-        text: isError ? `Failed ${toolName}` : `Finished ${toolName}`
+        text: void 0
       });
       if (toolCallId) {
         this.#toolLabelByCallId.delete(toolCallId);
@@ -1292,16 +1643,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);
   }
 };
@@ -1324,15 +1675,16 @@ 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 MAX_TOOL_LABEL_DISPLAY_LENGTH = 24;
 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 +1706,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);
@@ -1399,9 +1752,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);
     }
@@ -1409,12 +1762,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);
     }
@@ -1434,15 +1787,10 @@ var ProgressRenderer = class {
     if (!normalizedText) {
       return `- ${this.#humanizeToolError(toolName)}`;
     }
-    const lowerText = normalizedText.toLowerCase();
-    const lowerToolName = toolName.toLowerCase();
-    if (lowerText === lowerToolName || lowerText === `failed ${lowerToolName}` || lowerText === `running ${lowerToolName}` || lowerText === `finished ${lowerToolName}`) {
-      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) {
@@ -1457,7 +1805,38 @@ 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 parseModelCommand(text2, clientSessionId) {
+  const match = text2.match(/^\/(model|m)(?:\s+(.*))?$/i);
+  if (!match) {
+    return null;
+  }
+  const target = match[2]?.trim();
+  if (!target) {
+    return { type: "command.session.model.list", clientSessionId };
+  }
+  return {
+    type: "command.session.model.set",
+    clientSessionId,
+    target
+  };
+}
 function parseSlashCommand(text2, clientSessionId) {
+  const modelCommand = parseModelCommand(text2, clientSessionId);
+  if (modelCommand) {
+    return modelCommand;
+  }
   switch (text2.toLowerCase()) {
     case "/new":
     case "/n":
@@ -1466,12 +1845,89 @@ function parseSlashCommand(text2, clientSessionId) {
     case "/c":
       return { type: "command.session.compact", clientSessionId };
     case "/stop":
+    case "/s":
       return { type: "command.session.stop", clientSessionId };
+    case "/status":
+    case "/st":
+      return { type: "command.session.status", clientSessionId };
     default:
       return null;
   }
 }
 
+// src/modules/client/utils/status-markdown.ts
+function formatModel(status, t) {
+  if (status.provider && status.modelId) {
+    return `\`${status.provider}/${status.modelId}\``;
+  }
+  if (status.modelId) {
+    return `\`${status.modelId}\``;
+  }
+  if (status.provider) {
+    return `\`${status.provider}\``;
+  }
+  return t("client.statusUnavailableValue");
+}
+function formatContext(status, t) {
+  const context = status.context;
+  if (!context) {
+    return t("client.statusUnavailableValue");
+  }
+  const { tokens, contextWindow, percent } = context;
+  if (tokens == null || contextWindow == null || percent == null) {
+    return t("client.statusUnavailableValue");
+  }
+  return `\`${tokens.toLocaleString()} / ${contextWindow.toLocaleString()} (${percent}%)\``;
+}
+function formatAvailableModel(model, t) {
+  const label = `\`${model.provider}/${model.modelId}\``;
+  return model.isCurrent ? `- ${label} \u2705 ${t("client.modelListCurrent")}` : `- ${label}`;
+}
+function formatErrorMarkdown(title, detail) {
+  return [`**${title}**`, ...detail ? ["", detail] : []].join("\n");
+}
+function renderStatusMarkdown(event, t) {
+  if (event.type === "agent.model.list") {
+    return [
+      `**${t("client.modelListTitle")}**`,
+      "",
+      ...event.models.length > 0 ? event.models.map((model) => formatAvailableModel(model, t)) : [`- ${t("client.statusUnavailableValue")}`],
+      "",
+      t("client.modelListUsage")
+    ].join("\n");
+  }
+  if (event.type === "agent.model.updated") {
+    return t("client.modelUpdated", { model: `${event.provider}/${event.modelId}` });
+  }
+  if (event.type === "agent.status.info") {
+    return [
+      `**${t("client.statusTitle")}**`,
+      "",
+      `- ${t("client.statusSessionId")}: \`${event.status.sessionId}\``,
+      `- ${t("client.statusModel")}: ${formatModel(event.status, t)}`,
+      `- ${t("client.statusThinkingLevel")}: ${event.status.thinkingLevel ? `\`${event.status.thinkingLevel}\`` : t("client.statusUnavailableValue")}`,
+      `- ${t("client.statusContext")}: ${formatContext(event.status, t)}`
+    ].join("\n");
+  }
+  if (event.type === "error") {
+    switch (event.kind) {
+      case "agent.status.unavailable":
+        return formatErrorMarkdown(t("client.statusUnavailable"), event.detail);
+      case "agent.model.list.unavailable":
+        return formatErrorMarkdown(t("client.modelListUnavailable"), event.detail);
+      case "agent.model.set.unavailable":
+        return formatErrorMarkdown(t("client.modelSetUnavailable"), event.detail);
+      case "agent.model.invalid":
+        return formatErrorMarkdown(t("client.modelInvalid"), event.detail);
+      case "agent.model.busy":
+        return event.detail ?? t("client.modelBusy");
+      default:
+        return null;
+    }
+  }
+  return null;
+}
+
 // src/modules/client/feishu/adapter/feishu-client.ts
 import * as Lark from "@larksuiteoapi/node-sdk";
 import { existsSync as existsSync3, mkdirSync, writeFileSync } from "fs";
@@ -1818,6 +2274,7 @@ function chunkText(text2, maxLen) {
 var FeishuIMAdapter = class _FeishuIMAdapter {
   #config;
   #logger;
+  #t;
   #onOutput = null;
   #client = null;
   #egressQueue = [];
@@ -1842,18 +2299,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;
@@ -1870,10 +2326,17 @@ ${message}`;
         );
         return;
       }
+      const normalizedText = text2.trim();
       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);
+        await this.#client?.stopTyping(chatId);
+        return;
+      }
       const commandEvent = parseSlashCommand(normalizedText, clientSessionId);
       if (commandEvent) {
         this.#logger.info(`received command ${normalizedText} (session=${clientSessionId})`);
@@ -1925,6 +2388,13 @@ ${message}`;
         try {
           const target = parseFeishuSessionId(event.clientSessionId);
           if (event.type !== "assistant.message") {
+            const statusMarkdown = renderStatusMarkdown(event, this.#t);
+            if (statusMarkdown) {
+              const replyToMessageId2 = this.#lastInboundMessageIdBySession.get(event.clientSessionId);
+              await this.#client.sendText(target.chatId, statusMarkdown, replyToMessageId2);
+              await this.#client.stopTyping(target.chatId);
+              continue;
+            }
             await this.#handleProgressEvent(target.chatId, event);
             continue;
           }
@@ -1966,7 +2436,7 @@ ${message}`;
       return;
     }
     const state = this.#progressStateBySession.get(event.clientSessionId) ?? {
-      renderer: new ProgressRenderer(),
+      renderer: new ProgressRenderer({ t: this.#t }),
       messageId: null,
       creating: false
     };
@@ -1996,7 +2466,7 @@ ${message}`;
   }
   #resetProgressState(clientSessionId) {
     this.#progressStateBySession.set(clientSessionId, {
-      renderer: new ProgressRenderer(),
+      renderer: new ProgressRenderer({ t: this.#t }),
       messageId: null,
       creating: false
     });
@@ -2048,8 +2518,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);
   }
 };
 
@@ -2519,7 +2989,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 = [];
@@ -2546,6 +3015,7 @@ function chunkText2(text2, maxLen) {
 var WecomIMAdapter = class {
   #config;
   #logger;
+  #t;
   #onOutput = null;
   #client = null;
   #egressQueue = [];
@@ -2561,18 +3031,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;
@@ -2598,14 +3067,19 @@ ${message}`;
         return;
       }
       const normalizedText = text2.trim();
-      const commandEvent = parseSlashCommand(normalizedText, clientSessionId);
-      if (commandEvent) {
-        await this.#onOutput(commandEvent);
+      const helpMarkdown = resolveHelpMarkdown(normalizedText, this.#t);
+      if (helpMarkdown) {
+        await this.#client?.sendText(chatId, helpMarkdown, messageId);
         return;
       }
       this.#lastInboundMessageIdBySession.set(clientSessionId, messageId);
       this.#resetProgressState(clientSessionId);
       await this.#announceStart(chatId, messageId, clientSessionId);
+      const commandEvent = parseSlashCommand(normalizedText, clientSessionId);
+      if (commandEvent) {
+        await this.#onOutput(commandEvent);
+        return;
+      }
       await this.#onOutput({
         type: "user.message",
         clientSessionId,
@@ -2650,6 +3124,13 @@ ${message}`;
         try {
           const target = parseWecomSessionId(event.clientSessionId);
           if (event.type !== "assistant.message") {
+            const statusMarkdown = renderStatusMarkdown(event, this.#t);
+            if (statusMarkdown) {
+              const replyToMessageId2 = this.#lastInboundMessageIdBySession.get(event.clientSessionId);
+              await this.#finishProgressMessage(target.chatId, event.clientSessionId, replyToMessageId2);
+              await this.#client.sendText(target.chatId, statusMarkdown, replyToMessageId2);
+              continue;
+            }
             await this.#handleProgressEvent(target.chatId, event);
             continue;
           }
@@ -2688,7 +3169,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
     });
@@ -2699,7 +3180,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);
@@ -2722,7 +3203,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) {
@@ -2731,7 +3212,7 @@ ${message}`;
   }
   #resetProgressState(clientSessionId) {
     this.#progressStateBySession.set(clientSessionId, {
-      renderer: new ProgressRenderer(),
+      renderer: new ProgressRenderer({ t: this.#t }),
       announced: false
     });
   }
@@ -2778,8 +3259,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);
   }
 };
 
@@ -3087,6 +3568,7 @@ function chunkText3(text2, maxLen) {
 var WeixinIMAdapter = class {
   #config;
   #logger;
+  #t;
   #onOutput = null;
   #client = null;
   #egressQueue = [];
@@ -3097,9 +3579,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;
@@ -3120,15 +3603,23 @@ var WeixinIMAdapter = class {
         this.#logger.debug(`ignoring unsupported Weixin group message (session=${clientSessionId})`);
         return;
       }
-      this.#resetProgressState(clientSessionId);
       const normalizedText = text2.trim();
+      this.#resetProgressState(clientSessionId);
+      await this.#client?.sendTyping(chatId);
+      this.#startTypingHeartbeat(clientSessionId, chatId);
+      const helpMarkdown = resolveHelpMarkdown(normalizedText, this.#t);
+      if (helpMarkdown) {
+        await this.#client?.sendText(chatId, helpMarkdown);
+        this.#stopProgressTimer(clientSessionId);
+        this.#stopTypingHeartbeat(clientSessionId);
+        await this.#client?.stopTyping(chatId);
+        return;
+      }
       const commandEvent = parseSlashCommand(normalizedText, clientSessionId);
       if (commandEvent) {
         await this.#onOutput(commandEvent);
         return;
       }
-      await this.#client?.sendTyping(chatId);
-      this.#startTypingHeartbeat(clientSessionId, chatId);
       await this.#onOutput({
         type: "user.message",
         clientSessionId,
@@ -3184,6 +3675,14 @@ var WeixinIMAdapter = class {
             continue;
           }
           if (event.type !== "assistant.message") {
+            const statusMarkdown = renderStatusMarkdown(event, this.#t);
+            if (statusMarkdown) {
+              await this.#sendTextWithProtection(target.chatId, statusMarkdown);
+              this.#stopProgressTimer(event.clientSessionId);
+              this.#stopTypingHeartbeat(event.clientSessionId);
+              await this.#client.stopTyping(target.chatId);
+              continue;
+            }
             this.#recordProgressEvent(event);
             continue;
           }
@@ -3241,9 +3740,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) {
@@ -3256,7 +3753,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;
@@ -3272,7 +3769,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;
@@ -3301,7 +3798,7 @@ ${message}`;
   }
   #createProgressState() {
     return {
-      renderer: new ProgressRenderer(),
+      renderer: new ProgressRenderer({ t: this.#t }),
       dirty: false,
       interval: null
     };
@@ -3486,8 +3983,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);
   }
 };
 
@@ -3516,14 +4013,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`);
@@ -3537,6 +4039,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}`);
@@ -3558,6 +4062,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 {
@@ -3569,6 +4082,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) {
@@ -3582,6 +4096,7 @@ async function addChannel(config) {
     }
     const agentConfig = await collectModuleConfig(agentModule, ctx);
     config.channels[name] = {
+      common: commonConfig,
       client: {
         type: clientType,
         config: clientConfig
@@ -3660,7 +4175,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);