@xmanrui/dsh-im 4.16.0 → 4.17.0

package/src/channels/feishu/feishu-cards.mjs

@@ -903,6 +903,136 @@ export function approvalCard({ toolName, operation, reason, approvalId }) {
   return cardWith(t('🔐 工具审批'), elements);
 }
 
+// ── Streaming step card (流式过程卡片) ────────────────────────────────────
+
+/** One streaming step card carries at most this many JSON bytes after the
+ *  card has been serialized (Feishu caps card content near 30KB; stay lower
+ *  so headers and JSON escaping always fit). */
+export const STEP_STREAM_CARD_MAX_BYTES = 24_000;
+
+/**
+ * Build one streaming step card from the accumulated process blocks:
+ *   { kind: 'message', text }         — interim note / warning / context line
+ *   { kind: 'tools', lines: string[] } — tool-call summary panel
+ * `status`: 'running' keeps panels expanded and ends with an italic status
+ * line; 'completed' / 'stopped' collapse the panels and swap the status text;
+ * 'sealed' is an overflow spill chunk with no status line at all. Finished
+ * turns (and sealed spill chunks) merge every tool/thinking panel into one
+ * collapsed "process details" panel so the sealed card stays compact.
+ */
+
+export function stepStreamCard(rawBlocks, { status = 'running' } = {}) {
+  const running = status === 'running';
+  const elements = [];
+  const panelElements = [];
+  for (const block of Array.isArray(rawBlocks) ? rawBlocks : []) {
+    if (block?.kind === 'tools' || block?.kind === 'notes') {
+      const lines = (Array.isArray(block.lines) ? block.lines : [])
+        .filter((line) => typeof line === 'string' && line.trim());
+      if (lines.length === 0) continue;
+      const count = lines.length + (Number(block.omitted) || 0);
+      const panel = stepPanel(lines, {
+        title: block.kind === 'tools'
+          ? t('🛠️ 工具摘要（{count}）', { count })
+          : t('💭 思考过程（{count}）', { count }),
+        // Tool summaries stay visible while the turn runs; thinking notes
+        // remain folded at all times. Finished turns keep both panels but
+        // tuck them inside one collapsed "process details" wrapper.
+        expanded: block.kind === 'tools' && running,
+      });
+      if (running) elements.push(panel);
+      else panelElements.push(panel);
+      continue;
+    }
+    const text = typeof block?.text === 'string' ? block.text.trim() : '';
+    if (text) elements.push({ tag: 'markdown', content: text });
+  }
+  if (!running && panelElements.length > 0) {
+    // Finished turns: the tool/thinking panels nest inside one collapsed
+    // "process details" wrapper, so the sealed card shows a single line.
+    elements.push(processDetailsPanel(panelElements));
+  }
+  if (elements.length === 0) elements.push({ tag: 'markdown', content: ' ' });
+  if (status !== 'sealed') {
+    elements.push({ tag: 'markdown', content: `_${stepStatusText(status)}_` });
+  }
+  return JSON.stringify({
+    schema: '2.0',
+    header: { title: plainText(t('⚙️ 任务过程')), template: 'blue' },
+    body: { elements },
+  });
+}
+
+/** The collapsed wrapper that holds the per-kind panels on finished turns. */
+function processDetailsPanel(children) {
+  return {
+    tag: 'collapsible_panel',
+    expanded: false,
+    background_color: 'grey-50',
+    border: { color: 'grey', corner_radius: '8px' },
+    padding: '8px 8px 8px 8px',
+    header: {
+      title: { tag: 'plain_text', content: t('📋 过程详情') },
+      vertical_align: 'center',
+      padding: '8px 8px 8px 8px',
+      icon: { tag: 'standard_icon', token: 'down-small-ccm_outlined', color: 'grey', size: '16px 16px' },
+      icon_position: 'right',
+      icon_expanded_angle: -180,
+    },
+    elements: children,
+  };
+}
+
+/** The collapsible grey panel used for tool summaries and thinking notes. */
+function stepPanel(lines, { title, expanded }) {
+  return {
+    tag: 'collapsible_panel',
+    expanded: expanded === true,
+    background_color: 'grey-50',
+    border: { color: 'grey', corner_radius: '8px' },
+    padding: '8px 8px 8px 8px',
+    header: {
+      title: { tag: 'plain_text', content: title },
+      vertical_align: 'center',
+      padding: '8px 8px 8px 8px',
+      icon: { tag: 'standard_icon', token: 'down-small-ccm_outlined', color: 'grey', size: '16px 16px' },
+      icon_position: 'right',
+      icon_expanded_angle: -180,
+    },
+    elements: [{ tag: 'markdown', content: lines.join('\n') }],
+  };
+}
+
+function stepStatusText(status) {
+  if (status === 'completed') return t('已完成');
+  if (status === 'stopped') return t('已停止');
+  return t('运行中');
+}
+
+/**
+ * Split accumulated blocks into card-sized chunks at block boundaries,
+ * budgeted by the encoded running-status card (the largest render). Every
+ * chunk keeps at least one block so progress is never dropped. The caller
+ * renders all but the last chunk as `sealed` and the last one live.
+ */
+export function splitStepStreamCardBlocks(blocks, limit = STEP_STREAM_CARD_MAX_BYTES) {
+  const list = (Array.isArray(blocks) ? blocks : []).filter(Boolean);
+  if (list.length === 0) return [];
+  const chunks = [];
+  let current = [];
+  for (const block of list) {
+    if (current.length > 0
+      && Buffer.byteLength(stepStreamCard([...current, block]), 'utf8') > limit) {
+      chunks.push(current);
+      current = [block];
+    } else {
+      current.push(block);
+    }
+  }
+  if (current.length > 0) chunks.push(current);
+  return chunks;
+}
+
 /**
  * Interactive question card. When the question carries options, each option is
  * rendered as its own button; the selected option label is submitted via a

package/src/channels/feishu/feishu-runtime.mjs

@@ -3,6 +3,7 @@ import { FeishuHarnessBridge } from './bridge.mjs';
 import { cardActionProbeCard } from './feishu-cards.mjs';
 import { VerifiedFeishuChannel } from './feishu-channel.mjs';
 import { normalizeFeishuGroupResponseMode } from './group-response-mode.mjs';
+import { normalizeFeishuStepPushMode } from './step-push-mode.mjs';
 import {
   registerSlashCommands,
   SLASH_COMMAND_MANIFEST,
@@ -112,6 +113,7 @@ export class FeishuRuntime {
   #groupResponseMode;
   #groupTopicReply;
   #stepPush;
+  #stepPushMode;
   #ownerOpenIds;
   #harness;
   #state;
@@ -143,6 +145,7 @@ export class FeishuRuntime {
     groupResponseMode,
     groupTopicReply = false,
     stepPush = false,
+    stepPushMode = 'post',
     ownerOpenId,
     ownerOpenIds,
     harness,
@@ -180,6 +183,7 @@ export class FeishuRuntime {
     this.#groupResponseMode = normalizeFeishuGroupResponseMode(groupResponseMode);
     this.#groupTopicReply = groupTopicReply === true;
     this.#stepPush = stepPush === true;
+    this.#stepPushMode = normalizeFeishuStepPushMode(stepPushMode);
     this.#ownerOpenIds = normalizedOwners;
     this.#harness = harness;
     this.#state = state;
@@ -214,6 +218,11 @@ export class FeishuRuntime {
     this.#bridge?.setStepPush(this.#stepPush);
   }
 
+  setStepPushMode(value) {
+    this.#stepPushMode = normalizeFeishuStepPushMode(value);
+    this.#bridge?.setStepPushMode(this.#stepPushMode);
+  }
+
   async start() {
     while (true) {
       while (this.#stopping) await this.#stopping;
@@ -304,6 +313,7 @@ export class FeishuRuntime {
         groupResponseMode: this.#groupResponseMode,
         groupTopicReply: this.#groupTopicReply,
         stepPush: this.#stepPush,
+        stepPushMode: this.#stepPushMode,
         repair: this.#repair,
         replyTimeoutMs: this.#replyTimeoutMs,
         // Interaction cards (approval/question buttons) are on by default.

package/src/channels/feishu/multi-bot-controller.mjs

@@ -15,6 +15,11 @@ import {
   isFeishuGroupResponseMode,
   normalizeFeishuGroupResponseMode,
 } from './group-response-mode.mjs';
+import {
+  DEFAULT_FEISHU_STEP_PUSH_MODE,
+  isFeishuStepPushMode,
+  normalizeFeishuStepPushMode,
+} from './step-push-mode.mjs';
 
 const ACTIVE_REGISTRATION_STATES = new Set([
   'starting', 'qr_ready', 'polling', 'slow_down', 'domain_switched',
@@ -92,6 +97,7 @@ function configuredBotFingerprint(config) {
     groupResponseMode: normalizeFeishuGroupResponseMode(config.groupResponseMode),
     groupTopicReply: config.groupTopicReply === true,
     stepPush: config.stepPush === true,
+    stepPushMode: normalizeFeishuStepPushMode(config.stepPushMode),
     groupMessagePermissionGranted: config.groupMessagePermissionGranted === true,
     deletionPending: config.deletionPending === true,
     connectedAt: config.connectedAt ?? null,
@@ -447,6 +453,8 @@ export class MultiBotDshFeishuController {
         botName: bot.name,
         botOpenId: bot.openId,
         activated: bot.activated,
+        stepPush: existing?.stepPush ?? true,
+        stepPushMode: existing?.stepPushMode ?? DEFAULT_FEISHU_STEP_PUSH_MODE,
         deletionPending: false,
         connectedAt: new Date().toISOString(),
         createdAt: existing?.createdAt ?? new Date().toISOString(),
@@ -614,6 +622,20 @@ export class MultiBotDshFeishuController {
     }));
   }
 
+  async updateStepPushMode(botId, stepPushMode) {
+    this.#assertOpen();
+    if (!isFeishuStepPushMode(stepPushMode)) {
+      throw new TypeError('Invalid Feishu step push mode');
+    }
+    return this.#serializeConfig(() => this.#withBotTransition(botId, async () => {
+      const config = this.#requireBot(botId);
+      const saved = await this.#configStore.saveBot({ ...config, stepPushMode });
+      this.#runtimes.get(botId)?.setStepPushMode?.(saved.stepPushMode);
+      this.#touch();
+      return this.status(botId);
+    }));
+  }
+
   async deleteBot(botId) {
     this.#assertOpen();
     return this.#serializeConfig(() => this.#withBotTransition(botId, async () => {
@@ -678,6 +700,7 @@ export class MultiBotDshFeishuController {
         groupResponseMode: normalizeFeishuGroupResponseMode(config.groupResponseMode),
         groupTopicReply: config.groupTopicReply === true,
         stepPush: config.stepPush === true,
+        stepPushMode: normalizeFeishuStepPushMode(config.stepPushMode),
         groupMessagePermissionGranted: config.groupMessagePermissionGranted === true,
         bot: publicBot(config),
         connection,
@@ -1111,6 +1134,11 @@ export class MultiBotDshFeishuController {
         botName: bot.name,
         botOpenId: bot.openId,
         activated: bot.activated,
+        // New connections start with the process-card presentation; existing
+        // bots keep whatever they saved before (the spread above re-applies
+        // their stored values, undefined falls through to the defaults here).
+        stepPush: existing?.stepPush ?? true,
+        stepPushMode: existing?.stepPushMode ?? DEFAULT_FEISHU_STEP_PUSH_MODE,
         deletionPending: false,
         connectedAt: new Date().toISOString(),
         createdAt: existing?.createdAt ?? new Date().toISOString(),

package/src/channels/feishu/plugin-config-store.mjs

@@ -2,6 +2,7 @@ import { createHash } from 'node:crypto';
 import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 import { normalizeFeishuGroupResponseMode } from './group-response-mode.mjs';
+import { normalizeFeishuStepPushMode } from './step-push-mode.mjs';
 
 export const LEGACY_FEISHU_SECRET_REF = 'DSH_FEISHU_APP_SECRET';
 
@@ -47,6 +48,7 @@ function normalizeBot(value, { legacy = false } = {}) {
     groupResponseMode: normalizeFeishuGroupResponseMode(value.groupResponseMode),
     groupTopicReply: value.groupTopicReply === true,
     stepPush: value.stepPush === true,
+    stepPushMode: normalizeFeishuStepPushMode(value.stepPushMode),
     groupMessagePermissionGranted: value.groupMessagePermissionGranted === true,
     deletionPending: value.deletionPending === true,
     connectedAt: cleanString(value.connectedAt),

package/src/channels/feishu/step-push-mode.mjs

@@ -0,0 +1,19 @@
+export const FEISHU_STEP_PUSH_MODES = Object.freeze({
+  POST: 'post',
+  STREAMING_CARD: 'streaming_card',
+});
+
+/** New connections explicitly opt into the process-card presentation. */
+export const DEFAULT_FEISHU_STEP_PUSH_MODE = FEISHU_STEP_PUSH_MODES.STREAMING_CARD;
+
+export function normalizeFeishuStepPushMode(value) {
+  // Bots created before modes existed used posts when step push was enabled.
+  return value === FEISHU_STEP_PUSH_MODES.STREAMING_CARD
+    ? FEISHU_STEP_PUSH_MODES.STREAMING_CARD
+    : FEISHU_STEP_PUSH_MODES.POST;
+}
+
+export function isFeishuStepPushMode(value) {
+  return value === FEISHU_STEP_PUSH_MODES.POST
+    || value === FEISHU_STEP_PUSH_MODES.STREAMING_CARD;
+}

package/src/channels/shared/i18n-en/feishu.mjs

@@ -323,6 +323,14 @@ export default {
   '🔙 返回菜单': '🔙 Back to menu',
   '已完成': 'Completed',
   '已停止': 'Stopped',
+  '运行中': 'Running',
+  '⚙️ 任务过程': '⚙️ Task progress',
+  '📋 过程详情': '📋 Process details',
+  '🛠️ 工具摘要（{count}）': '🛠️ Tool summary ({count})',
+  '💭 思考过程（{count}）': '💭 Thinking ({count})',
+  '🛠️ 工具': '🛠️ Tools',
+  '💭 思考': '💭 Thinking',
+  '📋 过程详情（工具 {tools} · 思考 {notes}）': '📋 Process details (tools {tools} · thinking {notes})',
   '已中止': 'Aborted',
   '已取消': 'Cancelled',
   '已结束': 'Ended',