@modelzen/feishu-codex-bridge 0.4.2 → 0.4.3

package/dist/cli.js

@@ -127,6 +127,13 @@ function secretKeyForApp(appId) {
 function getShowToolCalls(cfg) {
   return cfg.preferences?.showToolCalls !== false;
 }
+function getModelDisplay(cfg) {
+  const v = cfg.preferences?.showModel;
+  if (v === "running" || v === "always" || v === "off") return v;
+  if (v === true) return "always";
+  if (v === false) return "off";
+  return "running";
+}
 function getMaxConcurrentRuns(cfg) {
   const raw = cfg.preferences?.maxConcurrentRuns;
   if (typeof raw !== "number" || !Number.isFinite(raw) || raw < 1) return 10;
@@ -3347,6 +3354,7 @@ var DM = {
   rmDo: "dm.rmDo",
   rmCancel: "dm.rmCancel",
   setTools: "dm.set.tools",
+  setShowModel: "dm.set.showModel",
   setWatchdog: "dm.set.watchdog",
   // 假死超时「自定义…」：watchdogCustom 打开输入卡，watchdogCustomSubmit 保存任意秒数
   watchdogCustom: "dm.set.watchdog.custom",
@@ -3503,6 +3511,17 @@ function buildUpdateCard(state) {
       );
   }
 }
+function buildReconnectCard(conn) {
+  const template = conn === "connected" ? "green" : "orange";
+  return card(
+    [
+      md(`\u957F\u8FDE\u63A5\u72B6\u6001\uFF1A**${conn}**`),
+      note("SDK \u4F1A\u81EA\u52A8\u91CD\u8FDE\uFF1B\u82E5\u957F\u671F\u65AD\u5F00\uFF0C\u8BF7\u5728\u7EC8\u7AEF\u91CD\u8DD1 `feishu-codex-bridge run`\uFF08\u524D\u53F0\uFF09\u6216 `feishu-codex-bridge restart`\uFF08\u540E\u53F0\u5B88\u62A4\uFF09\u3002"),
+      backToMenu()
+    ],
+    { header: { title: "\u{1F504} \u957F\u8FDE\u63A5", template } }
+  );
+}
 function connLabel(state) {
   switch (state) {
     case "connected":
@@ -3809,38 +3828,78 @@ function optionRow(label, actionId, current, opts) {
     actions(opts.map((o) => button(o.label, { a: actionId, v: o.value }, o.value === current ? "primary" : "default")))
   ];
 }
+function settingSection(title) {
+  return { tag: "markdown", content: `**${title}**`, text_size: "notation", text_color: "grey" };
+}
+function settingItem(name, desc, actionId, current, opts) {
+  return [
+    md(`**${name}**`),
+    note(desc),
+    actions(opts.map((o) => button(o.label, { a: actionId, v: o.value }, o.value === current ? "primary" : "default")))
+  ];
+}
 function buildSettingsCard(cfg) {
   const watchdogSec = cfg.preferences?.runIdleTimeoutSeconds ?? 120;
   return card(
     [
-      md("**\u5168\u5C40\u8BBE\u7F6E**\uFF08\u7BA1\u7406\u5458\uFF09"),
-      ...optionRow("\u{1F527} \u5DE5\u5177\u8C03\u7528", DM.setTools, getShowToolCalls(cfg) ? "on" : "off", [
-        { label: "\u663E\u793A", value: "on" },
-        { label: "\u9690\u85CF", value: "off" }
-      ]),
-      md(`\u23F1 \u5047\u6B7B\u8D85\u65F6\uFF08\u5F53\u524D **${watchdogSec === 0 ? "\u5173\u95ED" : `${watchdogSec} \u79D2`}**\uFF09`),
+      settingSection("\u{1F4E4} \u8F93\u51FA\u5C55\u793A"),
+      ...settingItem(
+        "\u{1F527} \u5DE5\u5177\u8C03\u7528",
+        "\u8F93\u51FA\u65F6\u663E\u793A\u6267\u884C\u7684\u547D\u4EE4 / \u5DE5\u5177\u8C03\u7528\uFF1B\u5173\u6389\u53EA\u770B\u6700\u7EC8\u56DE\u7B54\u3002",
+        DM.setTools,
+        getShowToolCalls(cfg) ? "on" : "off",
+        [
+          { label: "\u663E\u793A", value: "on" },
+          { label: "\u9690\u85CF", value: "off" }
+        ]
+      ),
+      ...settingItem(
+        "\u{1F9E0} \u6A21\u578B\u663E\u793A",
+        "\u6BCF\u6761\u56DE\u590D\u53F3\u4E0B\u89D2\u663E\u793A\u300C\u6A21\u578B \xB7 \u63A8\u7406\u5F3A\u5EA6\u300D\u3002\u4EC5\u8F93\u51FA\u65F6\uFF1D\u53EA\u5728\u751F\u6210\u4E2D\u663E\u793A\uFF1B\u59CB\u7EC8\uFF1D\u751F\u6210\u5B8C\u540E\u5361\u7247\u4E5F\u4FDD\u7559\u3002",
+        DM.setShowModel,
+        getModelDisplay(cfg),
+        [
+          { label: "\u5173\u95ED", value: "off" },
+          { label: "\u4EC5\u8F93\u51FA\u65F6", value: "running" },
+          { label: "\u59CB\u7EC8", value: "always" }
+        ]
+      ),
+      hr(),
+      settingSection("\u23F1 \u8FD0\u884C\u63A7\u5236"),
+      md(`**\u23F1 \u5047\u6B7B\u8D85\u65F6** \xB7 \u5F53\u524D **${watchdogSec === 0 ? "\u5173\u95ED" : `${watchdogSec} \u79D2`}**`),
+      note("\u591A\u4E45\u6CA1\u6709\u4EFB\u4F55\u8F93\u51FA\u5C31\u81EA\u52A8\u7EC8\u6B62\u672C\u8F6E\uFF08\u9632\u5361\u6B7B\uFF09\u3002"),
       actions([
         ...[0, 120, 300].map(
           (v) => button(v === 0 ? "\u5173\u95ED" : `${v}\u79D2`, { a: DM.setWatchdog, v: String(v) }, v === watchdogSec ? "primary" : "default")
         ),
         button("\u81EA\u5B9A\u4E49\u2026", { a: DM.watchdogCustom })
       ]),
-      ...optionRow("\u{1F4E5} \u8FD0\u884C\u4E2D\u65B0\u6D88\u606F", DM.setPending, getPendingPolicy(cfg), [
-        { label: "\u5F15\u5BFC", value: "steer" },
-        { label: "\u6392\u961F", value: "queue" }
-      ]),
-      ...optionRow("\u26A1 \u5E76\u53D1\u4E0A\u9650", DM.setConcurrency, String(getMaxConcurrentRuns(cfg)), [
-        { label: "1", value: "1" },
-        { label: "5", value: "5" },
-        { label: "10", value: "10" },
-        { label: "20", value: "20" }
-      ]),
-      note("\u26A1 \u5E76\u53D1\u6C60\u4E3A**\u6240\u6709\u7FA4/\u8BDD\u9898\u5168\u5C40\u5171\u4EAB**\uFF1A\u6EE1\u4E86\u65B0\u4EFB\u52A1\u6309\u5148\u6765\u540E\u5230\u6392\u961F\uFF08\u6392\u961F\u5361\u53EF\u89C1\u3001\u53EF \u23F9 \u53D6\u6D88\uFF09\u3002"),
-      note("\u26A0\uFE0F \u5E76\u53D1\u4E0A\u9650 \u6539\u540E\u9700**\u91CD\u542F**\u751F\u6548\uFF1B\u5176\u4F59\u8BBE\u7F6E\uFF08\u542B\u5047\u6B7B\u8D85\u65F6\uFF09\u5373\u65F6\u751F\u6548\uFF0C\u6240\u6709\u7FA4\u7ACB\u5373\u5957\u7528\u3002"),
+      ...settingItem(
+        "\u{1F4E5} \u8FD0\u884C\u4E2D\u6765\u65B0\u6D88\u606F",
+        "\u6B63\u5728\u8DD1\u65F6\u4F60\u53C8\u53D1\u6D88\u606F\uFF1A\u5F15\u5BFC\uFF1D\u63D2\u8FDB\u5F53\u524D\u8F6E\u7EA0\u504F\uFF1B\u6392\u961F\uFF1D\u7B49\u8FD9\u8F6E\u8DD1\u5B8C\u518D\u5904\u7406\u3002",
+        DM.setPending,
+        getPendingPolicy(cfg),
+        [
+          { label: "\u5F15\u5BFC", value: "steer" },
+          { label: "\u6392\u961F", value: "queue" }
+        ]
+      ),
+      ...settingItem(
+        "\u26A1 \u5E76\u53D1\u4E0A\u9650",
+        "\u6240\u6709\u7FA4 / \u8BDD\u9898\u5168\u5C40\u540C\u65F6\u6700\u591A\u8DD1\u51E0\u4E2A\uFF0C\u6EE1\u4E86\u6392\u961F\uFF08\u6392\u961F\u5361\u53EF \u23F9 \u53D6\u6D88\uFF09\u3002\u6539\u540E\u9700\u91CD\u542F\u751F\u6548\u3002",
+        DM.setConcurrency,
+        String(getMaxConcurrentRuns(cfg)),
+        [
+          { label: "1", value: "1" },
+          { label: "5", value: "5" },
+          { label: "10", value: "10" },
+          { label: "20", value: "20" }
+        ]
+      ),
       hr(),
       actions([button("\u{1F46E} \u7BA1\u7406\u5458", { a: DM.admins }), button("\u2B05\uFE0F \u83DC\u5355", { a: DM.menu })])
     ],
-    { header: { title: "\u2699\uFE0F \u8BBE\u7F6E", template: "blue" } }
+    { header: { title: "\u2699\uFE0F \u5168\u5C40\u8BBE\u7F6E", template: "blue" } }
   );
 }
 function buildWatchdogCustomCard(cfg) {
@@ -4904,24 +4963,6 @@ function buildRunCard(rc) {
 }
 function renderRunning(state, rc) {
   const elements = [];
-  if (rc.cardKey && rc.goalControls) {
-    if (rc.goalEnding) {
-      elements.push(actions([button("\u23F9 \u7EC8\u6B62", { a: RC.stop, m: rc.cardKey }, "danger")], CONTROLS_EID));
-      elements.push(noteMd("_\u{1F3AF} \u76EE\u6807\u5DF2\u89E3\u9664\uFF0C\u672C\u8F6E\u8F93\u51FA\u5B8C\u6210\u540E\u505C\u6B62_"));
-    } else {
-      elements.push(
-        actions(
-          [
-            button("\u23F9 \u7EC8\u6B62", { a: RC.stop, m: rc.cardKey }, "danger"),
-            button("\u{1F3AF} \u7ED3\u675F\u76EE\u6807", { a: RC.endGoal, m: rc.cardKey }, "default")
-          ],
-          CONTROLS_EID
-        )
-      );
-    }
-  } else if (rc.cardKey && !rc.hideStop) {
-    elements.push(actions([button("\u23F9 \u7EC8\u6B62", { a: RC.stop, m: rc.cardKey }, "danger")], CONTROLS_EID));
-  }
   const reasoning = reasoningContent(state);
   if (reasoning) elements.push(reasoningPanel(reasoning, state.reasoningActive));
   const showTools = rc.showTools !== false;
@@ -4937,9 +4978,30 @@ function renderRunning(state, rc) {
   if (tools.length > 0) elements.push(...renderToolGroup(tools, false));
   const answer = textParts.join("\n\n");
   if (answer) elements.push(mdStream(answer, ANSWER_EID));
-  if (state.footer) elements.push(footerStatus(state.footer));
+  const mEl = modelEl(rc);
+  if (state.footer && mEl) elements.push(splitRow(footerStatus(state.footer), mEl));
+  else if (state.footer) elements.push(footerStatus(state.footer));
+  else if (mEl) elements.push(mEl);
   const gauge = gaugeEl(state);
   if (gauge) elements.push(gauge);
+  if (rc.cardKey && rc.goalControls) {
+    if (rc.goalEnding) {
+      elements.push(noteMd("_\u{1F3AF} \u76EE\u6807\u5DF2\u89E3\u9664\uFF0C\u672C\u8F6E\u8F93\u51FA\u5B8C\u6210\u540E\u505C\u6B62_"));
+      elements.push(actions([button("\u23F9 \u7EC8\u6B62", { a: RC.stop, m: rc.cardKey }, "danger")], CONTROLS_EID));
+    } else {
+      elements.push(
+        actions(
+          [
+            button("\u23F9 \u7EC8\u6B62", { a: RC.stop, m: rc.cardKey }, "danger"),
+            button("\u{1F3AF} \u7ED3\u675F\u76EE\u6807", { a: RC.endGoal, m: rc.cardKey }, "default")
+          ],
+          CONTROLS_EID
+        )
+      );
+    }
+  } else if (rc.cardKey && !rc.hideStop) {
+    elements.push(actions([button("\u23F9 \u7EC8\u6B62", { a: RC.stop, m: rc.cardKey }, "danger")], CONTROLS_EID));
+  }
   return elements;
 }
 function renderTerminal(state, rc) {
@@ -4977,6 +5039,8 @@ function renderTerminal(state, rc) {
   }
   const gauge = gaugeEl(state);
   if (gauge) elements.push(gauge);
+  const mEl = rc.modelOnTerminal ? modelEl(rc) : null;
+  if (mEl) elements.push(mEl);
   return elements;
 }
 function errorAdvice(msg) {
@@ -5098,9 +5162,35 @@ function collapsedToolSummary(tools, finalized) {
     body: tools.map((t) => `- ${toolHeaderText(t)}`).join("\n")
   });
 }
+function footerStatusText(status) {
+  return status === "thinking" ? "\u{1F9E0} \u6B63\u5728\u601D\u8003" : status === "tool_running" ? "\u{1F9F0} \u6B63\u5728\u8C03\u7528\u5DE5\u5177" : status === "retrying" ? "\u26A0\uFE0F \u77AC\u65AD\uFF0C\u81EA\u52A8\u91CD\u8BD5\u4E2D\u2026" : "\u270D\uFE0F \u6B63\u5728\u8F93\u51FA";
+}
 function footerStatus(status) {
-  const text = status === "thinking" ? "\u{1F9E0} \u6B63\u5728\u601D\u8003" : status === "tool_running" ? "\u{1F9F0} \u6B63\u5728\u8C03\u7528\u5DE5\u5177" : status === "retrying" ? "\u26A0\uFE0F \u77AC\u65AD\uFF0C\u81EA\u52A8\u91CD\u8BD5\u4E2D\u2026" : "\u270D\uFE0F \u6B63\u5728\u8F93\u51FA";
-  return noteMd(text);
+  return noteMd(footerStatusText(status));
+}
+var EFFORT_TIER = {
+  none: { label: "\u65E0", color: "grey" },
+  minimal: { label: "\u6781\u7B80", color: "grey" },
+  low: { label: "\u4F4E", color: "yellow" },
+  medium: { label: "\u4E2D", color: "green" },
+  high: { label: "\u9AD8", color: "violet" },
+  xhigh: { label: "\u6781\u9AD8", color: "purple" }
+};
+function modelEffortMd(model, effort) {
+  if (!effort) return model;
+  const t = EFFORT_TIER[effort];
+  if (!t) return `${model} \xB7 ${effort}`;
+  return `${model} \xB7 <font color='${t.color}'>${t.label}</font>`;
+}
+function modelEl(rc) {
+  if (!rc.model) return null;
+  return {
+    tag: "markdown",
+    content: modelEffortMd(rc.model, rc.effort),
+    text_size: "notation",
+    text_color: "grey",
+    text_align: "right"
+  };
 }
 function summaryText(state) {
   if (state.terminal === "interrupted") return "\u5DF2\u4E2D\u65AD";
@@ -9034,6 +9124,35 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
     }
     return buildProjectListCard(projects, byChat);
   };
+  const buildDoctorInfo = async () => {
+    const codexProbe = await backend.doctor({ force: true });
+    const app = cfg.accounts.app;
+    const secret = await getSecret(secretKeyForApp(app.id)).catch(() => void 0);
+    const scopeCheck = secret ? await validateAppCredentials(app.id, secret, app.tenant).catch(() => void 0) : void 0;
+    const missingScopes = scopeCheck?.missingScopes;
+    const missingJoinScopes = scopeCheck?.missingJoinScopes;
+    return {
+      codexOk: codexProbe.ok,
+      codexVer: codexProbe.version,
+      conn: channel.getConnectionStatus?.()?.state ?? "unknown",
+      bridgeVer: bridgeVersion(),
+      node: process.version,
+      platform: `${process.platform}-${process.arch}`,
+      logStdout: serviceStdoutPath(),
+      logStderr: serviceStderrPath(),
+      configFile: paths.configFile,
+      missingScopes,
+      // 缺失时预选缺失项（精准开通）；查不到/全开通时预选全部必需 scope 供核对。
+      scopeGrantUrl: buildScopeGrantUrl(
+        app.id,
+        app.tenant,
+        missingScopes && missingScopes.length ? missingScopes : void 0
+      ),
+      missingJoinScopes,
+      // 「加入存量群」按钮恒预选这两项 opt-in scope（它们不在必需清单里）。
+      joinScopeGrantUrl: buildScopeGrantUrl(app.id, app.tenant, JOIN_GROUP_SCOPES)
+    };
+  };
   dispatcher.on(DM.menu, ({ evt }) => {
     if (dmAdmin(evt.operator?.openId)) freshMenu(evt);
   }).on(DM.newProject, ({ evt }) => {
@@ -9098,41 +9217,15 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
     if (dmAdmin(evt.operator?.openId)) await patch(evt, buildSettingsCard(cfg));
   }).on(DM.doctor, async ({ evt }) => {
     if (!dmAdmin(evt.operator?.openId)) return;
-    const codexProbe = await backend.doctor({ force: true });
-    const app = cfg.accounts.app;
-    const secret = await getSecret(secretKeyForApp(app.id)).catch(() => void 0);
-    const scopeCheck = secret ? await validateAppCredentials(app.id, secret, app.tenant).catch(() => void 0) : void 0;
-    const missingScopes = scopeCheck?.missingScopes;
-    const missingJoinScopes = scopeCheck?.missingJoinScopes;
-    const info = {
-      codexOk: codexProbe.ok,
-      codexVer: codexProbe.version,
-      conn: channel.getConnectionStatus?.()?.state ?? "unknown",
-      bridgeVer: bridgeVersion(),
-      node: process.version,
-      platform: `${process.platform}-${process.arch}`,
-      logStdout: serviceStdoutPath(),
-      logStderr: serviceStderrPath(),
-      configFile: paths.configFile,
-      missingScopes,
-      // 缺失时预选缺失项（精准开通）；查不到/全开通时预选全部必需 scope 供核对。
-      scopeGrantUrl: buildScopeGrantUrl(
-        app.id,
-        app.tenant,
-        missingScopes && missingScopes.length ? missingScopes : void 0
-      ),
-      missingJoinScopes,
-      // 「加入存量群」按钮恒预选这两项 opt-in scope（它们不在必需清单里）。
-      joinScopeGrantUrl: buildScopeGrantUrl(app.id, app.tenant, JOIN_GROUP_SCOPES)
-    };
-    await sendManagedCard(channel, evt.chatId, buildDoctorCard(info), evt.messageId).catch(
+    await sendManagedCard(channel, evt.chatId, buildDoctorCard(await buildDoctorInfo()), evt.messageId).catch(
       (err) => log.fail("console", err, { cmd: "doctor" })
     );
   }).on(DM.reconnect, async ({ evt }) => {
     if (!dmAdmin(evt.operator?.openId)) return;
     const conn = channel.getConnectionStatus?.()?.state ?? "unknown";
-    await channel.send(evt.chatId, { markdown: `\u{1F504} \u957F\u8FDE\u63A5\u72B6\u6001\uFF1A**${conn}**
-SDK \u4F1A\u81EA\u52A8\u91CD\u8FDE\uFF1B\u82E5\u957F\u671F\u65AD\u5F00\uFF0C\u8BF7\u5728\u7EC8\u7AEF\u91CD\u8DD1 \`feishu-codex-bridge run\`\uFF08\u524D\u53F0\uFF09\u6216 \`feishu-codex-bridge restart\`\uFF08\u540E\u53F0\u5B88\u62A4\uFF09\u3002` }, { replyTo: evt.messageId }).catch(() => void 0);
+    await sendManagedCard(channel, evt.chatId, buildReconnectCard(conn), evt.messageId).catch(
+      (err) => log.fail("console", err, { cmd: "reconnect" })
+    );
   }).on(DM.update, ({ evt }) => {
     if (!dmAdmin(evt.operator?.openId)) return;
     void (async () => {
@@ -9239,6 +9332,10 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
     });
   }).on(DM.setTools, ({ evt, value }) => {
     applyPref(evt, (p) => p.showToolCalls = value.v === "on");
+  }).on(DM.setShowModel, ({ evt, value }) => {
+    applyPref(evt, (p) => {
+      p.showModel = value.v === "running" ? "running" : value.v === "always" ? "always" : "off";
+    });
   }).on(DM.setWatchdog, ({ evt, value }) => {
     const n = Number(value.v);
     if (Number.isFinite(n)) applyPref(evt, (p) => p.runIdleTimeoutSeconds = n);
@@ -9553,6 +9650,7 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
         firstRec = void 0;
         const turnModel = rec?.model ?? opts.model;
         const turnEffort = rec?.effort ?? opts.effort;
+        const modelDisp = getModelDisplay(cfg);
         const run = opts.thread.runStreamed(turnInput, { model: turnModel, effort: turnEffort });
         const turnStartAt = Date.now();
         state.run = run;
@@ -9562,7 +9660,9 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
         const rc = {
           rs: render.snapshot(),
           requesterOpenId: opts.requesterOpenId,
-          showTools: render.showTools
+          showTools: render.showTools,
+          // 模型显示档位：footnote 本轮 model·推理强度；always 档终态卡也保留。
+          ...modelDisp !== "off" && turnModel ? { model: turnModel, effort: turnEffort, modelOnTerminal: modelDisp === "always" } : {}
         };
         const adoptThreadId = async (messageId) => {
           if (activeKey.startsWith("pending:")) {
@@ -9841,7 +9941,14 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
     const startTurn = () => {
       const render = new RunRender();
       render.showTools = getShowToolCalls(cfg);
-      const rc = { rs: render.snapshot(), requesterOpenId: opts.requesterOpenId, showTools: render.showTools, goalControls: true };
+      const goalModelDisp = getModelDisplay(cfg);
+      const rc = {
+        rs: render.snapshot(),
+        requesterOpenId: opts.requesterOpenId,
+        showTools: render.showTools,
+        goalControls: true,
+        ...goalModelDisp !== "off" && opts.model ? { model: opts.model, effort: opts.effort, modelOnTerminal: goalModelDisp === "always" } : {}
+      };
       return { render, rc, stream: null, cardMsgId: null };
     };
     const ensureCard = async (ctx) => {
@@ -10208,9 +10315,60 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
       }).catch(() => void 0);
       return;
     }
-    await sendManagedCard(channel, op, buildDmMenuCard({ webConsoleUrl: webConsoleUrl(), version: bridgeVersion() }), void 0, false, "open_id").catch(
-      (err) => log.fail("console", err, { cmd: "menu-card" })
-    );
+    const sendDm = (c) => sendManagedCard(channel, op, c, void 0, false, "open_id");
+    try {
+      switch (evt.eventKey) {
+        case DM.newProject:
+          await sendDm(buildNewProjectFormCard({ backends: backendOptionsFor("full") }));
+          break;
+        case DM.projects:
+          await sendDm(await renderProjectList());
+          break;
+        case DM.settings:
+          await sendDm(buildSettingsCard(cfg));
+          break;
+        case DM.doctor:
+          await sendDm(buildDoctorCard(await buildDoctorInfo()));
+          break;
+        case DM.reconnect:
+          await sendDm(buildReconnectCard(channel.getConnectionStatus?.()?.state ?? "unknown"));
+          break;
+        case DM.usage: {
+          const { messageId } = await sendDm(buildUsageCard({ phase: "loading" }));
+          let state;
+          try {
+            state = { phase: "ready", data: await fetchUsageBundle(false) };
+          } catch (e) {
+            log.fail("console", e, { phase: "usage", via: "menu" });
+            state = {
+              phase: "error",
+              kind: e instanceof UsageError ? e.kind : "transient",
+              message: e instanceof Error ? e.message : String(e)
+            };
+          }
+          const ok = await updateManagedCard(channel, messageId, buildUsageCard(state)).catch(() => false);
+          if (!ok) await sendDm(buildUsageCard(state));
+          break;
+        }
+        case DM.update: {
+          const { messageId } = await sendDm(buildUpdateCard({ phase: "checking" }));
+          const current = currentVersion();
+          const latest = await latestVersion().catch(() => null);
+          const hasUpdate = !!latest && isNewer(latest, current);
+          log.info("console", "update-check", { current, latest, hasUpdate, via: "menu" });
+          await updateManagedCard(
+            channel,
+            messageId,
+            buildUpdateCard({ phase: "checked", current, latest, hasUpdate, dev: isDevSource() })
+          ).catch((e) => log.fail("console", e, { phase: "update-check", via: "menu" }));
+          break;
+        }
+        default:
+          await sendDm(buildDmMenuCard({ webConsoleUrl: webConsoleUrl(), version: bridgeVersion() }));
+      }
+    } catch (err) {
+      log.fail("console", err, { cmd: "menu-card", key: evt.eventKey });
+    }
   };
   const reaper = setInterval(() => {
     const now = Date.now();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelzen/feishu-codex-bridge",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Bridge Feishu/Lark messenger with local Codex via app-server (project=group, thread=session)",
   "type": "module",
   "bin": {