@dsh-overdrive/gateway 0.3.0 → 0.3.1

package/src/mention.ts

@@ -1,51 +0,0 @@
-// 群聊响应策略（对齐竞品 dsh-im 的「私聊直接响应、群聊被提及/回复才响应」）。
-// 纯函数，平台判定基于渠道 ID 特征与提及模式；无法判定的平台默认始终响应。
-
-import type { NormalizedMessage } from './adapter.js';
-
-/** 纯函数：该渠道 ID 是否为群聊/频道（vs 私聊）。平台特征： */
-export function isGroupChat(adapterId: string, chatId: string): boolean {
-  switch (adapterId) {
-    case 'telegram':
-      // 群/超级群为负 ID（-100 前缀的超群，- 前缀的普通群）
-      return chatId.startsWith('-');
-    case 'whatsapp':
-      return chatId.endsWith('@g.us');
-    case 'slack':
-      // Slack 私聊 DM 以 D 开头，公共频道/群以 C/G 开头
-      return !chatId.startsWith('D');
-    default:
-      // discord / feishu / dingtalk / wecom / wechat / cli：无法从 ID 可靠区分 → 视为私聊（始终响应）
-      return false;
-  }
-}
-
-/** 纯函数：消息文本是否提及了机器人（@<identity> 或 <@identity> 平台格式）。 */
-export function isMentioned(adapterId: string, text: string, botIdentity: string): boolean {
-  if (!botIdentity) return false;
-  switch (adapterId) {
-    case 'telegram':
-      return text.includes(`@${botIdentity}`);
-    case 'whatsapp':
-      return text.includes(`@${botIdentity}`);
-    case 'discord':
-    case 'slack':
-      return text.includes(`<@${botIdentity}>`);
-    default:
-      return true; // 无法检测提及的平台 → 视为已提及（始终响应）
-  }
-}
-
-export interface MentionPolicy {
-  /** 群聊中要求被提及/回复才响应；私聊始终响应。 */
-  requireMention: boolean;
-  /** 机器人身份（telegram @用户名 / discord·slack 用户ID / whatsapp 号码）。 */
-  botIdentity: string;
-}
-
-/** 纯函数：是否应响应该消息。 */
-export function shouldRespond(adapterId: string, msg: NormalizedMessage, policy: MentionPolicy): boolean {
-  if (!policy.requireMention) return true;
-  if (!isGroupChat(adapterId, msg.chatId)) return true; // 私聊始终响应
-  return isMentioned(adapterId, msg.text, policy.botIdentity);
-}

package/src/pending-buttons.ts

@@ -1,65 +0,0 @@
-import type { OutboundButton } from './adapter.js';
-
-export const PENDING_BUTTONS_TTL_MS = 5 * 60_000;
-
-interface PendingButtonEntry {
-  buttons: OutboundButton[];
-  expiresAt: number;
-}
-
-/**
- * 编号回复兜底的按钮暂存（带 TTL）。
- *
- * 审批/危险操作按钮发出后，用户在聊天里回复数字（"1"/"2"…）选择；
- * 若按钮长期不消费，后续的普通数字消息会被误判成按钮回复。
- * 本类在 TTL（默认 5 分钟）后自动失效，杜绝"过期按钮吞消息"。
- */
-export class PendingButtons {
-  private readonly map = new Map<string, PendingButtonEntry>();
-
-  constructor(private readonly ttlMs: number = PENDING_BUTTONS_TTL_MS) {}
-
-  set(chatId: string, buttons: OutboundButton[]): void {
-    this.map.set(chatId, { buttons, expiresAt: Date.now() + this.ttlMs });
-  }
-
-  /**
-   * 回复解析（对齐竞品的文字审批）：数字编号（"1"/"2"…）或关键词
-   * （批准/同意/yes/ok/确认 → approve 按钮；拒绝/不同意/no/取消 → reject 按钮）。
-   * 命中即消费；无 pending / 已过期 / 不匹配返回 undefined。
-   */
-  match(chatId: string, text: string): OutboundButton | undefined {
-    const entry = this.map.get(chatId);
-    if (!entry) return undefined;
-    if (entry.expiresAt < Date.now()) {
-      this.map.delete(chatId);
-      return undefined;
-    }
-    const trimmed = text.trim().toLowerCase();
-    // 数字回复
-    const n = Number(trimmed);
-    if (Number.isInteger(n) && n >= 1 && n <= entry.buttons.length) {
-      const button = entry.buttons[n - 1];
-      if (button) this.map.delete(chatId);
-      return button;
-    }
-    // 文字审批关键词（竞品 dsh-im 同款：回复「批准/拒绝」即可）
-    const approveWords = ['批准', '同意', 'yes', 'ok', '确认', 'approve'];
-    const rejectWords = ['拒绝', '不同意', 'no', '取消', 'reject'];
-    const wantsApprove = approveWords.some((w) => trimmed === w || trimmed.startsWith(`${w} `));
-    const wantsReject = rejectWords.some((w) => trimmed === w || trimmed.startsWith(`${w} `));
-    if (wantsApprove || wantsReject) {
-      const button = entry.buttons.find((b) =>
-        wantsApprove ? b.id.startsWith('approve:') : b.id.startsWith('reject:'),
-      );
-      if (button) this.map.delete(chatId);
-      return button;
-    }
-    return undefined;
-  }
-
-  /** 消费原生按钮点击（如 WhatsApp 原生交互按钮）：删除该 chat 的 pending。 */
-  consume(chatId: string): void {
-    this.map.delete(chatId);
-  }
-}

package/src/session.ts

@@ -1,23 +0,0 @@
-import { sessionKey } from '@dsh-overdrive/sdk';
-
-export function buildSessionKey(
-  adapterId: string,
-  msg: { chatId: string; userId: string },
-): string {
-  return sessionKey(adapterId, msg.chatId, msg.userId);
-}
-
-/**
- * 白名单：默认 fail-closed —— 只有显式配置了条目才放行；
- * 开发环境可用 ALLOW_ALL=1 显式放行所有（比空列表隐式放行安全得多）。
- */
-export class Allowlist {
-  constructor(
-    private readonly entries: string[],
-    private readonly allowAll = false,
-  ) {}
-
-  allows(key: string): boolean {
-    return this.allowAll || (this.entries.length > 0 && this.entries.includes(key));
-  }
-}

package/src/setup.ts

@@ -1,252 +0,0 @@
-/**
- * dsh-overdrive setup wizard — 交互式设置向导（hermes setup 风格）
- *
- * 用法：
- *   node packages/gateway/dist/setup.js          （源码构建后）
- *   npx dsh-overdrive-setup                      （npm 全局/临时）
- *
- * 流程：DeepSeek key → 平台多选 → 逐个收集凭据并联网验证 → 写 .env → 打印下一步。
- * 全程英文为主、中文为辅；验证失败会提示"是否继续"。
- */
-import { createInterface } from 'node:readline/promises';
-import { stdin, stdout } from 'node:process';
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-
-const C = {
-  cyan: (t: string) => `\x1b[36m${t}\x1b[0m`,
-  green: (t: string) => `\x1b[32m${t}\x1b[0m`,
-  red: (t: string) => `\x1b[31m${t}\x1b[0m`,
-  dim: (t: string) => `\x1b[90m${t}\x1b[0m`,
-  bold: (t: string) => `\x1b[1m${t}\x1b[0m`,
-};
-
-/**
- * 输入层：TTY 用 readline（交互终端）；非 TTY 预读全部 stdin（管道/自动化/测试），
- * 逐行分发。输入耗尽时返回 ''，由 stopIfClosed 优雅收尾。
- */
-const isTTY = !!stdin.isTTY;
-let ttyRl: ReturnType<typeof createInterface> | null = null;
-const pipeLines: string[] = [];
-if (!isTTY) {
-  const chunks: Buffer[] = [];
-  for await (const chunk of stdin) chunks.push(chunk);
-  pipeLines.push(...Buffer.concat(chunks).toString('utf8').split(/\r?\n/));
-}
-let inputClosed = !isTTY && pipeLines.length === 0;
-async function promptOnce(question: string): Promise<string> {
-  if (isTTY) {
-    ttyRl ??= createInterface({ input: stdin, output: stdout, terminal: true });
-    try {
-      return await ttyRl.question(question);
-    } catch {
-      inputClosed = true;
-      return '';
-    }
-  }
-  const line = pipeLines.shift() ?? '';
-  if (line === '' && pipeLines.length === 0) inputClosed = true;
-  stdout.write(`${question}${line}\n`); // 非 TTY 无回显，手动回显
-  return line;
-}
-function closeInput(): void {
-  try { ttyRl?.close(); } catch { /* noop */ }
-}
-async function ask(q: string, hint = ''): Promise<string> {
-  const answer = await promptOnce(`${C.cyan('?')} ${q} ${C.dim(hint)}\n> `);
-  return answer.trim();
-}
-async function confirm(q: string): Promise<boolean> {
-  const a = (await promptOnce(`${C.cyan('?')} ${q} ${C.dim('[y/N]')}\n> `)).trim().toLowerCase();
-  return a === 'y' || a === 'yes';
-}
-function stopIfClosed(): void {
-  if (inputClosed) {
-    console.log(C.dim('\n  input closed — aborting / 输入已关闭，向导中止'));
-    console.log(C.dim('  (run in an interactive terminal / 请在交互式终端中运行)'));
-    process.exit(1);
-  }
-}
-
-/** 联网验证辅助：返回 {ok, reason}；网络异常按"无法验证"处理（由调用方决定是否继续）。 */
-async function probe(fn: () => Promise<boolean>, name: string): Promise<{ ok: boolean; reason: string }> {
-  try {
-    return (await fn()) ? { ok: true, reason: `${name} verified / 验证通过` } : { ok: false, reason: `${name} rejected / 验证失败` };
-  } catch (error) {
-    return { ok: false, reason: `${name} unreachable (network?) / 网络不可达: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-const PROBES: Record<string, (v: Record<string, string>) => Promise<boolean>> = {
-  deepseek: async (v) => {
-    const r = await fetch('https://api.deepseek.com/user/balance', { headers: { authorization: `Bearer ${v.DEEPSEEK_API_KEY}` } });
-    return r.ok;
-  },
-  telegram: async (v) => {
-    const r = await fetch(`https://api.telegram.org/bot${v.TELEGRAM_BOT_TOKEN}/getMe`);
-    const j = (await r.json()) as { ok?: boolean };
-    return j.ok === true;
-  },
-  discord: async (v) => {
-    const r = await fetch('https://discord.com/api/v10/users/@me', { headers: { authorization: `Bot ${v.DISCORD_BOT_TOKEN}` } });
-    return r.ok;
-  },
-  slack: async (v) => {
-    const r = await fetch('https://slack.com/api/auth.test', { headers: { authorization: `Bearer ${v.SLACK_BOT_TOKEN}` } });
-    const j = (await r.json()) as { ok?: boolean };
-    return j.ok === true;
-  },
-  feishu: async (v) => {
-    const r = await fetch('https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal', {
-      method: 'POST', headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ app_id: v.FEISHU_APP_ID, app_secret: v.FEISHU_APP_SECRET }),
-    });
-    const j = (await r.json()) as { code?: number };
-    return j.code === 0;
-  },
-  dingtalk: async (v) => {
-    const r = await fetch('https://api.dingtalk.com/v1.0/oauth2/accessToken', {
-      method: 'POST', headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ appKey: v.DINGTALK_CLIENT_ID, appSecret: v.DINGTALK_CLIENT_SECRET }),
-    });
-    return r.ok;
-  },
-  wecom: async (v) => {
-    const url = `https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=${encodeURIComponent(v.WECOM_CORP_ID)}&corpsecret=${encodeURIComponent(v.WECOM_SECRET)}`;
-    const j = (await (await fetch(url)).json()) as { errcode?: number };
-    return j.errcode === 0;
-  },
-};
-
-const PLATFORMS: Record<string, { label: string; fields: Array<[key: string, prompt: string, hint: string, pattern?: RegExp]> }> = {
-  telegram: {
-    label: 'Telegram',
-    fields: [['TELEGRAM_BOT_TOKEN', 'Telegram bot token', 'https://t.me/BotFather → /newbot', /^\d+:[A-Za-z0-9_-]{20,}$/]],
-  },
-  whatsapp: {
-    label: 'WhatsApp (no credentials — QR pairing on first start / 无需凭据，首次启动扫码)',
-    fields: [],
-  },
-  discord: {
-    label: 'Discord',
-    fields: [['DISCORD_BOT_TOKEN', 'Discord bot token', 'Developer Portal → Bot → Token', /^[A-Za-z0-9._-]{20,}$/]],
-  },
-  slack: {
-    label: 'Slack (Socket Mode)',
-    fields: [
-      ['SLACK_BOT_TOKEN', 'Slack bot token (xoxb-…)', 'App → OAuth & Permissions', /^xoxb-/],
-      ['SLACK_APP_TOKEN', 'Slack app-level token (xapp-…)', 'App → Basic Information → App-Level Tokens', /^xapp-/],
-    ],
-  },
-  feishu: {
-    label: '飞书 Feishu',
-    fields: [
-      ['FEISHU_APP_ID', 'Feishu App ID', '开放平台 → 应用凭证', /^cli_/],
-      ['FEISHU_APP_SECRET', 'Feishu App Secret', '开放平台 → 应用凭证', /.+/],
-    ],
-  },
-  dingtalk: {
-    label: '钉钉 DingTalk',
-    fields: [
-      ['DINGTALK_CLIENT_ID', 'DingTalk Client ID (AppKey)', '应用开发 → 凭证与基础信息', /.+/],
-      ['DINGTALK_CLIENT_SECRET', 'DingTalk Client Secret', '应用开发 → 凭证与基础信息', /.+/],
-    ],
-  },
-  wecom: {
-    label: '企业微信 WeCom',
-    fields: [
-      ['WECOM_CORP_ID', 'WeCom Corp ID', '我的企业 → 企业信息', /.+/],
-      ['WECOM_SECRET', 'WeCom Secret', '应用管理 → 应用 → Secret', /.+/],
-      ['WECOM_AGENT_ID', 'WeCom Agent ID', '应用管理 → 应用 → AgentId', /^\d+$/],
-      ['WECOM_TOKEN', 'WeCom callback Token', '接收消息 → Token（随意填一串）', /.+/],
-      ['WECOM_ENCODING_AES_KEY', 'WeCom EncodingAESKey', '接收消息 → EncodingAESKey（43 位）', /^[A-Za-z0-9]{43}$/],
-    ],
-  },
-};
-
-/** 读取已有 .env（若存在）合并；返回新内容。 */
-function buildEnv(current: string, pairs: Array<[string, string]>): string {
-  const map = new Map<string, string>();
-  for (const line of current.split(/\r?\n/)) {
-    const m = line.match(/^([A-Z0-9_]+)=(.*)$/);
-    if (m) map.set(m[1], m[2]);
-  }
-  for (const [k, v] of pairs) map.set(k, v);
-  return [...map.entries()].map(([k, v]) => `${k}=${v}`).join('\n') + '\n';
-}
-
-async function main(): Promise<void> {
-  console.log('');
-  console.log(C.bold(C.cyan('==================================================')));
-  console.log(C.bold(C.cyan('  dsh-overdrive setup — the OpenClaw of DeepSeek Harness')));
-  console.log(C.bold(C.cyan('  交互式设置向导（hermes setup 风格）')));
-  console.log(C.bold(C.cyan('==================================================')));
-  console.log('');
-
-  const pairs: Array<[string, string]> = [];
-  let platforms: string[] = [];
-
-  // 1. DeepSeek API key
-  console.log(C.dim('  1/3 DeepSeek API key — get one: https://platform.deepseek.com/api_keys'));
-  for (;;) {
-    const key = await ask('Paste your DeepSeek API key (sk-…)', '必填');
-    stopIfClosed();
-    if (!/^sk-/.test(key)) { console.log(C.red('  [x] should start with sk- / 应以 sk- 开头')); continue; }
-    const r = await probe(() => PROBES.deepseek({ DEEPSEEK_API_KEY: key }), 'DeepSeek key');
-    console.log(r.ok ? C.green(`  [ok] ${r.reason}`) : C.red(`  [!] ${r.reason}`));
-    if (r.ok || (await confirm('Continue anyway? / 仍然继续？'))) { pairs.push(['DEEPSEEK_API_KEY', key]); break; }
-  }
-
-  // 2. platforms
-  console.log(C.dim('  2/3 Platforms — telegram, whatsapp, discord, slack, feishu, dingtalk, wecom'));
-  const chosen = await ask('Which platforms? (comma separated, default: telegram)', '逗号分隔，默认 telegram');
-  stopIfClosed();
-  platforms = (chosen || 'telegram').split(',').map((s) => s.trim().toLowerCase()).filter((s) => PLATFORMS[s]);
-  if (platforms.length === 0) { console.log(C.red('  [x] no valid platform selected / 未选择有效平台')); process.exit(1); }
-
-  // 3. per-platform credentials
-  console.log(C.dim('  3/3 Platform credentials (each is verified live) / 平台凭据（逐个实时验证）'));
-  for (const p of platforms) {
-    console.log(`\n  ${C.bold('-- ' + PLATFORMS[p].label)} --`);
-    const vals: Record<string, string> = { ...Object.fromEntries(pairs) };
-    for (const [key, prompt, hint, pattern] of PLATFORMS[p].fields) {
-      for (;;) {
-        const v = await ask(prompt, hint);
-        stopIfClosed();
-        if (pattern && !pattern.test(v)) { console.log(C.red(`  [x] format looks wrong / 格式不对（${hint}）`)); continue; }
-        vals[key] = v;
-        break;
-      }
-    }
-    const probeFn = PROBES[p];
-    if (probeFn && p !== 'whatsapp') {
-      const r = await probe(() => probeFn(vals), PLATFORMS[p].label);
-      console.log(r.ok ? C.green(`  [ok] ${r.reason}`) : C.red(`  [!] ${r.reason}`));
-      if (!r.ok && !(await confirm('Continue anyway? / 仍然继续？'))) { console.log(C.red('  skipped / 已跳过')); continue; }
-    }
-    for (const [k, v] of PLATFORMS[p].fields) pairs.push([k, vals[k]]);
-  }
-  if (platforms.includes('whatsapp')) console.log(C.dim('  WhatsApp: no credentials needed — QR shows on first start / 无需凭据，启动时扫码'));
-
-  // 4. write .env
-  const envPath = join(process.cwd(), '.env');
-  const current = existsSync(envPath) ? readFileSync(envPath, 'utf8') : '';
-  const merged = buildEnv(current, [...pairs, ['GATEWAY_ADAPTERS', platforms.join(',')], ['DSH_OVERDRIVE_TOKEN', 'dsh-overdrive-token']]);
-  writeFileSync(envPath, merged, 'utf8');
-  console.log(`\n  ${C.green('[ok]')} .env written → ${C.bold(envPath)}（已合并现有配置）`);
-
-  // 5. next steps
-  console.log('');
-  console.log(C.bold(C.cyan('==================================================')));
-  console.log(C.bold(C.cyan('  Next steps / 下一步')));
-  console.log(`  ${C.cyan('1)')} Start:  docker compose -f deploy/docker-compose.yml up -d --build`);
-  console.log(`     or:     GATEWAY_ADAPTERS=${platforms.join(',')} npx @dsh-overdrive/gateway`);
-  console.log(`  ${C.cyan('2)')} Console / 控制台:  http://localhost:3190/  （含四步引导向导）`);
-  console.log(`  ${C.cyan('3)')} DSH Web UI (model): http://localhost:3080/`);
-  console.log(`  ${C.cyan('4)')} In your chat app:   send /help`);
-  console.log(C.bold(C.cyan('==================================================')));
-  console.log('');
-  closeInput();
-}
-
-void main();

package/src/status.ts

@@ -1,63 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { createServer, type Server } from 'node:http';
-import { fileURLToPath } from 'node:url';
-import type { Adapter } from './adapter.js';
-import type { GatewayClient } from '@dsh-overdrive/sdk';
-
-export interface StatusServerOptions {
-  adapters: Adapter[];
-  client: GatewayClient;
-  version: string;
-}
-
-/**
- * 健康控制台：GET / 与 /console 返回静态页，GET /api/status 返回 DSH 健康 + 适配器状态。
- *
- * console.html 读取路径说明（与 dist 产物核对过）：
- * - src 运行（vitest）：import.meta.url = packages/gateway/src/status.ts → ../web/console.html = packages/gateway/web/console.html
- * - dist 运行（node packages/gateway/dist/index.js）：import.meta.url = packages/gateway/dist/status.js → ../web/console.html = packages/gateway/web/console.html
- * - npm 安装（@dsh-overdrive/gateway）：console.html 随包分发，两种形态均可命中。
- */
-export function createStatusServer(opts: StatusServerOptions): {
-  server: Server;
-  listen(port: number): Promise<number>;
-  close(): Promise<void>;
-} {
-  const http = createServer(async (req, res) => {
-    const url = new URL(req.url ?? '/', 'http://localhost');
-    if (url.pathname === '/api/status') {
-      let dsh: { status: string } | { error: string };
-      try {
-        dsh = await opts.client.health();
-      } catch (error) {
-        dsh = { error: error instanceof Error ? error.message : String(error) };
-      }
-      const adapters = opts.adapters.map((a) => ({
-        id: a.id,
-        connected: a.status?.().connected ?? null,
-      }));
-      res.writeHead(200, { 'content-type': 'application/json' });
-      res.end(JSON.stringify({ version: opts.version, dsh, adapters }));
-      return;
-    }
-    if (url.pathname === '/' || url.pathname === '/console') {
-      const html = await readFile(
-        fileURLToPath(new URL('../web/console.html', import.meta.url)),
-        'utf8',
-      ).catch(() => '<h1>console.html not found</h1>');
-      res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
-      res.end(html);
-      return;
-    }
-    res.writeHead(404, { 'content-type': 'text/plain' });
-    res.end('not found');
-  });
-  return {
-    server: http,
-    listen: (port: number) =>
-      new Promise<number>((resolve) =>
-        http.listen(port, '0.0.0.0', () => resolve((http.address() as { port: number }).port)),
-      ),
-    close: () => new Promise<void>((resolve) => http.close(() => resolve())),
-  };
-}

package/src/text.ts

@@ -1,32 +0,0 @@
-// 长文本工具：按渠道可读性分片（对齐竞品的长回复分段能力）。
-
-const DEFAULT_CHUNK_LIMIT = 1500;
-
-/** 纯函数：长文本按 limit 分片，优先在换行/句号/问号/感叹号处断行；超过 1 段时带（i/n）序号。 */
-export function chunkLongText(text: string, limit = DEFAULT_CHUNK_LIMIT): string[] {
-  if (!text) return [text];
-  if (text.length <= limit) return [text];
-
-  const raw: string[] = [];
-  let rest = text;
-  while (rest.length > limit) {
-    const slice = rest.slice(0, limit);
-    const breakAt = Math.max(
-      slice.lastIndexOf('\n'),
-      slice.lastIndexOf('。'),
-      slice.lastIndexOf('！'),
-      slice.lastIndexOf('？'),
-      slice.lastIndexOf('.'),
-      slice.lastIndexOf('!'),
-      slice.lastIndexOf('?'),
-      slice.lastIndexOf('；'),
-    );
-    const cut = breakAt >= limit * 0.6 ? breakAt + 1 : limit;
-    raw.push(rest.slice(0, cut));
-    rest = rest.slice(cut);
-  }
-  if (rest) raw.push(rest);
-
-  if (raw.length <= 1) return raw;
-  return raw.map((chunk, i) => `${chunk}\n（${i + 1}/${raw.length}）`);
-}

package/src/trajectory.ts

@@ -1,45 +0,0 @@
-import type { ServerEvent, TrajectoryStep } from '@dsh-overdrive/sdk';
-
-/** turn 级轨迹聚合：收集 trajectory.step，turn/end（idle）时产出 trajectory.summary 摘要卡片。 */
-export class TrajectoryAggregator {
-  private readonly buffer = new Map<string, TrajectoryStep[]>();
-  private readonly summaries = new Map<string, string>();
-
-  onEvent(ev: ServerEvent, emit: (ev: ServerEvent) => void): void {
-    if (ev.type === 'agent.status' && ev.status === 'idle') {
-      const steps = this.buffer.get(ev.sessionId) ?? [];
-      this.buffer.delete(ev.sessionId);
-      if (steps.length > 0) {
-        this.summaries.set(ev.sessionId, formatTrajectorySummary(steps));
-        emit({ type: 'trajectory.summary', sessionId: ev.sessionId, ts: Date.now(), steps });
-      }
-      emit(ev);
-      return;
-    }
-    if (ev.type === 'agent.status' && ev.status === 'busy') {
-      this.buffer.set(ev.sessionId, []);
-      emit(ev);
-      return;
-    }
-    if (ev.type === 'trajectory.step') {
-      const list = this.buffer.get(ev.sessionId);
-      if (list) list.push(ev.step);
-      else this.buffer.set(ev.sessionId, [ev.step]);
-      return; // 单步不实时推，等摘要（减少刷屏）
-    }
-    emit(ev);
-  }
-
-  /** 最近一次 turn 的轨迹摘要文本（/trace 命令用），无则 null。 */
-  recentSummary(sessionId: string): string | null {
-    return this.summaries.get(sessionId) ?? null;
-  }
-}
-
-export function formatTrajectorySummary(steps: TrajectoryStep[]): string {
-  const lines = steps.map((s) => {
-    const icon = s.kind === 'tool' ? '🛠️' : s.kind === 'subagent' ? '🤖' : '🧠';
-    return `${icon} ${s.label}`;
-  });
-  return `📋 轨迹（${lines.length} 步）\n${lines.join('\n')}`;
-}

package/test/adapters.dingtalk.test.ts

@@ -1,64 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { buildActionCard, buildReplyBody, buttonCallbackData, parseBotMessage, parseCardCallback } from '../src/adapters/dingtalk.js';
-
-describe('parseBotMessage（RobotMessage → NormalizedMessage）', () => {
-  it('文本消息', () => {
-    const data = {
-      conversationId: 'cid1',
-      senderStaffId: 'u1',
-      msgtype: 'text',
-      text: { content: 'hello' },
-      sessionWebhook: 'https://hook.dingtalk.com/x',
-    };
-    const out = parseBotMessage(data);
-    expect(out).toMatchObject({ chatId: 'cid1', userId: 'u1', text: 'hello' });
-  });
-  it('非文本返回 null', () => {
-    expect(parseBotMessage({ conversationId: 'c', msgtype: 'picture' })).toBeNull();
-  });
-});
-
-describe('buildReplyBody（sessionWebhook 回发载荷）', () => {
-  it('文本消息体', () => {
-    expect(buildReplyBody('hi')).toEqual({ msgtype: 'text', text: { content: 'hi' } });
-  });
-});
-
-describe('buildActionCard（钉钉 actionCard）', () => {
-  it('生成带 cardCallbackData 的按钮', () => {
-    const card = buildActionCard('需要批准', [
-      { id: 'approve:r1', label: '✅ 同意' },
-      { id: 'reject:r1', label: '🚫 拒绝' },
-    ]);
-    expect(card.msgtype).toBe('actionCard');
-    expect(card.actionCard.btns).toHaveLength(2);
-    expect(card.actionCard.btns[0].actionURL).toContain('cardCallbackData=');
-    expect(decodeURIComponent(card.actionCard.btns[0].actionURL.split('cardCallbackData=')[1])).toBe('{"action":"approve","reqId":"r1"}');
-  });
-});
-
-describe('parseCardCallback（TOPIC_CARD 回调载荷 → 按钮 id + 身份）', () => {
-  it('识别 cardCallbackData 字段', () => {
-    expect(parseCardCallback({ cardPrivateData: { cardCallbackData: '{"action":"approve","reqId":"r1"}' } })).toMatchObject({ buttonId: 'approve:r1' });
-  });
-  it('识别 params / cardActionData 字段与嵌套结构', () => {
-    expect(parseCardCallback({ cardPrivateData: { params: '{"action":"reject","reqId":"r9"}' } })).toMatchObject({ buttonId: 'reject:r9' });
-    expect(parseCardCallback({ a: { b: { cardActionData: '{"action":"approve","reqId":"x"}' } } })).toMatchObject({ buttonId: 'approve:x' });
-  });
-  it('带回会话与用户身份（用于白名单校验）', () => {
-    expect(parseCardCallback({
-      cardPrivateData: { cardCallbackData: '{"action":"approve","reqId":"r1"}', userId: 'u1' },
-      conversationId: 'cid1',
-    })).toEqual({ buttonId: 'approve:r1', chatId: 'cid1', userId: 'u1' });
-  });
-  it('非法载荷返回 null', () => {
-    expect(parseCardCallback(null)).toBeNull();
-    expect(parseCardCallback({ cardPrivateData: { cardCallbackData: 'not-json' } })).toBeNull();
-    expect(parseCardCallback({ cardPrivateData: { cardCallbackData: '{"action":"other","reqId":"r1"}' } })).toBeNull();
-    expect(parseCardCallback({ cardPrivateData: { cardCallbackData: '{"action":"approve"}' } })).toBeNull();
-  });
-  it('buttonCallbackData 与 parseCardCallback 往返一致', () => {
-    const data = buttonCallbackData({ id: 'reject:r7', label: 'x' });
-    expect(parseCardCallback({ cardPrivateData: { cardCallbackData: data } })).toMatchObject({ buttonId: 'reject:r7' });
-  });
-});

package/test/adapters.discord.test.ts

@@ -1,41 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { discordAttachmentUrl, discordComponents, normalizeDiscordMessage } from '../src/adapters/discord.js';
-
-describe('normalizeDiscordMessage', () => {
-  it('文本消息 → NormalizedMessage', () => {
-    const raw = { channelId: '111', author: { id: '222', bot: false }, content: 'hello' };
-    const out = normalizeDiscordMessage(raw);
-    expect(out).toMatchObject({ chatId: '111', userId: '222', text: 'hello' });
-  });
-  it('bot 消息返回 null', () => {
-    expect(normalizeDiscordMessage({ channelId: '1', author: { id: '2', bot: true }, content: 'x' })).toBeNull();
-  });
-  it('含附件 → media: { kind: "image", url }（纯函数 discordAttachmentUrl 取第一条）', () => {
-    const raw = {
-      channelId: '111',
-      author: { id: '222', bot: false },
-      content: '',
-      attachments: [{ url: 'https://cdn.discordapp.com/a.png', contentType: 'image/png' }],
-    };
-    expect(discordAttachmentUrl(raw)).toBe('https://cdn.discordapp.com/a.png');
-    expect(normalizeDiscordMessage(raw)).toMatchObject({
-      chatId: '111', userId: '222', text: '', media: { kind: 'image', url: 'https://cdn.discordapp.com/a.png' },
-    });
-  });
-});
-
-describe('discordComponents（按钮 action row 数据）', () => {
-  it('按钮 → discord components 结构', () => {
-    const comps = discordComponents([
-      { id: 'approve:r1', label: '✅ 同意' },
-      { id: 'reject:r1', label: '🚫 拒绝' },
-    ]);
-    expect(comps).toEqual([{
-      type: 1,
-      components: [
-        { type: 2, custom_id: 'approve:r1', label: '✅ 同意', style: 1 },
-        { type: 2, custom_id: 'reject:r1', label: '🚫 拒绝', style: 1 },
-      ],
-    }]);
-  });
-});