@hopgoldy/agent-bridge 0.3.4 → 0.4.0

package/dist/agent-bridge.js

@@ -116,18 +116,33 @@ var resources = {
       progress: {
         noProgress: "No progress yet.",
         collapsed: "Collapsed {{count}} earlier updates.",
-        running: "Running {{subject}}",
-        finished: "Finished {{subject}}",
-        failed: "Failed {{subject}}",
-        failedWithDetail: "Failed {{subject}}: {{detail}}",
+        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- `/help` (`/h`) - Show this help message",
+        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."
+        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.",
@@ -143,18 +158,33 @@ var resources = {
       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}}",
+        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- `/help` (`/h`) - \u67E5\u770B\u8FD9\u6761\u5E2E\u52A9\u4FE1\u606F",
+        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"
+        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",
@@ -335,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) {
@@ -389,6 +431,123 @@ var GatewayCore = class {
     }
     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) {
@@ -482,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);
@@ -884,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 });
   }
@@ -990,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;
@@ -1072,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;
@@ -1183,7 +1439,7 @@ var PiCodingAgentAdapter = class {
         toolCallId,
         toolInput,
         toolLabel,
-        text: `Running ${toolName}`
+        text: void 0
       });
       return;
     }
@@ -1204,7 +1460,7 @@ var PiCodingAgentAdapter = class {
         toolInput,
         toolLabel,
         partialResult: "partialResult" in rpcEvent ? rpcEvent.partialResult : void 0,
-        text: `Running ${toolName}`
+        text: void 0
       });
       return;
     }
@@ -1222,7 +1478,7 @@ var PiCodingAgentAdapter = class {
         toolInput,
         toolLabel,
         result: "result" in rpcEvent ? rpcEvent.result : void 0,
-        text: isError ? void 0 : `Finished ${toolName}`
+        text: void 0
       });
       if (toolCallId) {
         this.#toolLabelByCallId.delete(toolCallId);
@@ -1419,7 +1675,7 @@ function getTypedAgentModule(config) {
 
 // src/modules/client/utils/progress-renderer.ts
 var DEFAULT_COLLAPSE_THRESHOLD = 10;
-var MAX_TOOL_LABEL_DISPLAY_LENGTH = 15;
+var MAX_TOOL_LABEL_DISPLAY_LENGTH = 24;
 var ProgressRenderer = class {
   #collapseThreshold;
   #t;
@@ -1531,11 +1787,6 @@ var ProgressRenderer = class {
     if (!normalizedText) {
       return `- ${this.#humanizeToolError(toolName)}`;
     }
-    const lowerText = normalizedText.toLowerCase();
-    const lowerToolName = toolName.toLowerCase();
-    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.#t("progress.failedWithDetail", { subject: toolName, detail: normalizedText })}`;
   }
   #humanizeToolError(toolName) {
@@ -1566,7 +1817,26 @@ function isHelpCommand(text2) {
 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":
@@ -1577,11 +1847,87 @@ function parseSlashCommand(text2, 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";
@@ -1981,10 +2327,14 @@ var FeishuIMAdapter = class _FeishuIMAdapter {
         return;
       }
       const normalizedText = text2.trim();
+      this.#lastInboundMessageIdBySession.set(clientSessionId, messageId);
+      this.#resetProgressState(clientSessionId);
+      await this.#client?.startTyping(chatId, messageId);
       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);
@@ -1993,9 +2343,6 @@ var FeishuIMAdapter = class _FeishuIMAdapter {
         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",
@@ -2041,6 +2388,13 @@ var FeishuIMAdapter = class _FeishuIMAdapter {
         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;
           }
@@ -2718,14 +3072,14 @@ var WecomIMAdapter = class {
         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;
       }
-      this.#lastInboundMessageIdBySession.set(clientSessionId, messageId);
-      this.#resetProgressState(clientSessionId);
-      await this.#announceStart(chatId, messageId, clientSessionId);
       await this.#onOutput({
         type: "user.message",
         clientSessionId,
@@ -2770,6 +3124,13 @@ var WecomIMAdapter = class {
         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;
           }
@@ -3243,19 +3604,22 @@ var WeixinIMAdapter = class {
         return;
       }
       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;
       }
-      this.#resetProgressState(clientSessionId);
       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,
@@ -3311,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;
           }

package/dist/cli.js

@@ -116,18 +116,33 @@ var resources = {
       progress: {
         noProgress: "No progress yet.",
         collapsed: "Collapsed {{count}} earlier updates.",
-        running: "Running {{subject}}",
-        finished: "Finished {{subject}}",
-        failed: "Failed {{subject}}",
-        failedWithDetail: "Failed {{subject}}: {{detail}}",
+        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- `/help` (`/h`) - Show this help message",
+        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."
+        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.",
@@ -143,18 +158,33 @@ var resources = {
       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}}",
+        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- `/help` (`/h`) - \u67E5\u770B\u8FD9\u6761\u5E2E\u52A9\u4FE1\u606F",
+        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"
+        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",
@@ -335,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) {
@@ -389,6 +431,123 @@ var GatewayCore = class {
     }
     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) {
@@ -482,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);
@@ -884,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 });
   }
@@ -990,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;
@@ -1072,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;
@@ -1183,7 +1439,7 @@ var PiCodingAgentAdapter = class {
         toolCallId,
         toolInput,
         toolLabel,
-        text: `Running ${toolName}`
+        text: void 0
       });
       return;
     }
@@ -1204,7 +1460,7 @@ var PiCodingAgentAdapter = class {
         toolInput,
         toolLabel,
         partialResult: "partialResult" in rpcEvent ? rpcEvent.partialResult : void 0,
-        text: `Running ${toolName}`
+        text: void 0
       });
       return;
     }
@@ -1222,7 +1478,7 @@ var PiCodingAgentAdapter = class {
         toolInput,
         toolLabel,
         result: "result" in rpcEvent ? rpcEvent.result : void 0,
-        text: isError ? void 0 : `Finished ${toolName}`
+        text: void 0
       });
       if (toolCallId) {
         this.#toolLabelByCallId.delete(toolCallId);
@@ -1419,7 +1675,7 @@ function getTypedAgentModule(config) {
 
 // src/modules/client/utils/progress-renderer.ts
 var DEFAULT_COLLAPSE_THRESHOLD = 10;
-var MAX_TOOL_LABEL_DISPLAY_LENGTH = 15;
+var MAX_TOOL_LABEL_DISPLAY_LENGTH = 24;
 var ProgressRenderer = class {
   #collapseThreshold;
   #t;
@@ -1531,11 +1787,6 @@ var ProgressRenderer = class {
     if (!normalizedText) {
       return `- ${this.#humanizeToolError(toolName)}`;
     }
-    const lowerText = normalizedText.toLowerCase();
-    const lowerToolName = toolName.toLowerCase();
-    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.#t("progress.failedWithDetail", { subject: toolName, detail: normalizedText })}`;
   }
   #humanizeToolError(toolName) {
@@ -1566,7 +1817,26 @@ function isHelpCommand(text2) {
 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":
@@ -1577,11 +1847,87 @@ function parseSlashCommand(text2, 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";
@@ -1981,10 +2327,14 @@ var FeishuIMAdapter = class _FeishuIMAdapter {
         return;
       }
       const normalizedText = text2.trim();
+      this.#lastInboundMessageIdBySession.set(clientSessionId, messageId);
+      this.#resetProgressState(clientSessionId);
+      await this.#client?.startTyping(chatId, messageId);
       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);
@@ -1993,9 +2343,6 @@ var FeishuIMAdapter = class _FeishuIMAdapter {
         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",
@@ -2041,6 +2388,13 @@ var FeishuIMAdapter = class _FeishuIMAdapter {
         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;
           }
@@ -2718,14 +3072,14 @@ var WecomIMAdapter = class {
         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;
       }
-      this.#lastInboundMessageIdBySession.set(clientSessionId, messageId);
-      this.#resetProgressState(clientSessionId);
-      await this.#announceStart(chatId, messageId, clientSessionId);
       await this.#onOutput({
         type: "user.message",
         clientSessionId,
@@ -2770,6 +3124,13 @@ var WecomIMAdapter = class {
         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;
           }
@@ -3243,19 +3604,22 @@ var WeixinIMAdapter = class {
         return;
       }
       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;
       }
-      this.#resetProgressState(clientSessionId);
       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,
@@ -3311,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;
           }

package/dist/index.d.ts

@@ -11,6 +11,16 @@ type ClientOutputEvent = {
 } | {
     type: "command.session.stop";
     clientSessionId: string;
+} | {
+    type: "command.session.status";
+    clientSessionId: string;
+} | {
+    type: "command.session.model.list";
+    clientSessionId: string;
+} | {
+    type: "command.session.model.set";
+    clientSessionId: string;
+    target: string;
 };
 type AgentInputEvent = {
     type: "user.message";
@@ -24,6 +34,22 @@ interface OutboundAttachment {
     fileName?: string;
     caption?: string;
 }
+interface AgentSessionStatus {
+    sessionId: string;
+    provider?: string;
+    modelId?: string;
+    thinkingLevel?: string;
+    context?: {
+        tokens: number | null;
+        contextWindow: number | null;
+        percent: number | null;
+    };
+}
+interface AgentAvailableModel {
+    provider: string;
+    modelId: string;
+    isCurrent: boolean;
+}
 type ToolProgressPayload = {
     toolName: string;
     toolCallId?: string;
@@ -38,6 +64,20 @@ type AgentOutputPayload = {
 } | {
     type: "assistant.thinking";
     text?: string;
+} | {
+    type: "agent.status.info";
+    status: AgentSessionStatus;
+} | {
+    type: "agent.model.list";
+    models: AgentAvailableModel[];
+} | {
+    type: "agent.model.updated";
+    provider: string;
+    modelId: string;
+} | {
+    type: "error";
+    kind: string;
+    detail?: string;
 } | ({
     type: "assistant.tool.running";
 } & ToolProgressPayload) | ({
@@ -70,6 +110,12 @@ interface AgentAdapter {
     start(onOutput: (event: AgentOutputEvent) => Promise<void> | void): Promise<void>;
     stop(): Promise<void>;
     abort?(): Promise<void>;
+    getStatus?(): Promise<AgentSessionStatus>;
+    getAvailableModels?(): Promise<AgentAvailableModel[]>;
+    setModel?(target: string): Promise<{
+        provider: string;
+        modelId: string;
+    }>;
     input(event: AgentInputEvent): Promise<void>;
     isBusy(): Promise<boolean>;
 }
@@ -222,4 +268,4 @@ interface WeixinInboundMessage {
     raw?: unknown;
 }
 
-export type { AgentAdapter, AgentConfig, AgentInputEvent, AgentModule, AgentOutputEvent, AppConfig, AppDefaults, ChannelCommonConfig, ChannelCommonContext, ChannelConfig, ChannelRunner, ClientConfig, ClientInputEvent, ClientModule, ClientOutputEvent, ConfigAdapter, ConfigCollectContext, ConfigInputOptions, ConfigSelectOption, FeishuClientConfig, FeishuInboundMessage, GatewayCoreOptions, IMAdapter, LegacyAgentInputEvent, LocaleCode, OutboundAttachment, PiCodingAgentConfig, RunChannelOptions, SessionBindingStore, WecomClientConfig, WecomInboundMessage, WeixinClientConfig, WeixinInboundMessage };
+export type { AgentAdapter, AgentAvailableModel, AgentConfig, AgentInputEvent, AgentModule, AgentOutputEvent, AgentSessionStatus, AppConfig, AppDefaults, ChannelCommonConfig, ChannelCommonContext, ChannelConfig, ChannelRunner, ClientConfig, ClientInputEvent, ClientModule, ClientOutputEvent, ConfigAdapter, ConfigCollectContext, ConfigInputOptions, ConfigSelectOption, FeishuClientConfig, FeishuInboundMessage, GatewayCoreOptions, IMAdapter, LegacyAgentInputEvent, LocaleCode, OutboundAttachment, PiCodingAgentConfig, RunChannelOptions, SessionBindingStore, WecomClientConfig, WecomInboundMessage, WeixinClientConfig, WeixinInboundMessage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hopgoldy/agent-bridge",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "private": false,
   "description": "IM to Agent bridge with dual-adapter architecture",
   "packageManager": "pnpm@10.33.0",