@tencent-connect/dsh-qqbot 0.2.0 → 0.3.0

package/dist/transport/outbound-buffer.d.ts

@@ -1,13 +1,20 @@
 /**
  * OutboundBuffer — 出站文本缓冲
  *
- * 收集流式 chunk 并 debounce 发送，独立文件便于单测。
+ * 收集流式 chunk，流式优先投递（StreamingWriter），降级为静态发送。
+ * 独立文件便于单测。
  */
 import type { SessionRecord } from '../session/index.js';
 import type { Logger, ReplyTarget } from '../types.js';
+/** QQ 流式会话（openStream 返回） */
+export interface StreamSessionLike {
+    update(content: string): Promise<unknown>;
+    complete(): Promise<unknown>;
+}
 /** QQ Bot 发送接口 */
 export interface QQBotSender {
     sendMarkdown(target: ReplyTarget, content: string): Promise<unknown>;
+    openStream(target: ReplyTarget): StreamSessionLike;
 }
 export declare class OutboundBuffer {
     private readonly record;
@@ -15,18 +22,16 @@ export declare class OutboundBuffer {
     private readonly limit;
     private readonly logger;
     private buffer;
-    private timer;
     private flushing;
-    constructor(record: SessionRecord, bot: QQBotSender, limit: number, logger: Logger);
+    private readonly writer;
+    constructor(record: SessionRecord, bot: QQBotSender, limit: number, logger: Logger, streamingEnabled: boolean);
     /** 追加文本增量 */
     append(text: string): void;
     /** 获取当前累积文本 */
     get text(): string;
-    /** 安排延迟发送（debounce） */
-    scheduleSend(delayMs: number): void;
-    /** 立即发送所有累积文本 */
+    /** 发送所有累积文本：流式优先，降级静态 */
     flush(): Promise<void>;
-    /** 取消未发送的定时器 */
+    /** 取消（异常/丢弃），中止流式并清空缓冲 */
     cancel(): void;
 }
 //# sourceMappingURL=outbound-buffer.d.ts.map

package/dist/transport/outbound-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbound-buffer.d.ts","sourceRoot":"","sources":["../../src/transport/outbound-buffer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGvD,kBAAkB;AAClB,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtE;AAED,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAS;gBAGN,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;IAGjC,aAAa;IACb,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,eAAe;IACf,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,uBAAuB;IACvB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQnC,iBAAiB;IACX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B,gBAAgB;IAChB,MAAM,IAAI,IAAI;CAOf"}
+{"version":3,"file":"outbound-buffer.d.ts","sourceRoot":"","sources":["../../src/transport/outbound-buffer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAOvD,6BAA6B;AAC7B,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED,kBAAkB;AAClB,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAAC;CACpD;AAED,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAG7B,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAC/B,gBAAgB,EAAE,OAAO;IAO3B,aAAa;IACN,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC,eAAe;IACf,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,yBAAyB;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBnC,0BAA0B;IACnB,MAAM,IAAI,IAAI;CAItB"}

package/dist/transport/outbound-buffer.js

@@ -1,64 +1,62 @@
 import { chunkMarkdownText } from './chunker.js';
+import { StreamingWriter } from './streaming-writer.js';
+/** 流式输出节流间隔(ms)：连续 chunk 累积后停顿该间隔才推送 */
+const STREAM_THROTTLE_MS = 200;
 export class OutboundBuffer {
     record;
     bot;
     limit;
     logger;
     buffer = '';
-    timer = null;
     flushing = false;
-    constructor(record, bot, limit, logger) {
+    writer;
+    constructor(record, bot, limit, logger, streamingEnabled) {
         this.record = record;
         this.bot = bot;
         this.limit = limit;
         this.logger = logger;
+        this.writer = streamingEnabled
+            ? new StreamingWriter({ bot, target: record.replyTarget, logger, throttleMs: STREAM_THROTTLE_MS })
+            : null;
     }
     /** 追加文本增量 */
     append(text) {
         this.buffer += text;
+        this.writer?.append(text);
     }
     /** 获取当前累积文本 */
     get text() {
         return this.buffer;
     }
-    /** 安排延迟发送（debounce） */
-    scheduleSend(delayMs) {
-        if (this.timer)
-            return;
-        this.timer = setTimeout(() => {
-            this.timer = null;
-            void this.flush();
-        }, delayMs);
-    }
-    /** 立即发送所有累积文本 */
+    /** 发送所有累积文本：流式优先，降级静态 */
     async flush() {
         if (this.flushing || !this.buffer.trim())
             return;
         this.flushing = true;
-        if (this.timer) {
-            clearTimeout(this.timer);
-            this.timer = null;
-        }
         try {
+            if (this.writer) {
+                await this.writer.finish();
+                // 流式成功（未降级）→ 直接返回
+                if (!this.writer.shouldFallback)
+                    return;
+            }
+            // 降级：静态发送（writer 不存在 or 流式失败）
             const chunks = chunkMarkdownText(this.buffer, this.limit);
             for (const chunk of chunks) {
                 await this.bot.sendMarkdown(this.record.replyTarget, chunk);
             }
         }
         catch (err) {
-            this.logger.error(`im-qqbot: sendMarkdown failed: ${err instanceof Error ? err.message : String(err)}`);
+            this.logger.error(`im-qqbot: flush failed: ${err instanceof Error ? err.message : String(err)}`);
         }
         finally {
             this.buffer = '';
             this.flushing = false;
         }
     }
-    /** 取消未发送的定时器 */
+    /** 取消（异常/丢弃），中止流式并清空缓冲 */
     cancel() {
-        if (this.timer) {
-            clearTimeout(this.timer);
-            this.timer = null;
-        }
+        this.writer?.abort();
         this.buffer = '';
     }
 }

package/dist/transport/outbound-buffer.js.map

@@ -1 +1 @@
-{"version":3,"file":"outbound-buffer.js","sourceRoot":"","sources":["../../src/transport/outbound-buffer.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAOjD,MAAM,OAAO,cAAc;IAMN;IACA;IACA;IACA;IARX,MAAM,GAAG,EAAE,CAAC;IACZ,KAAK,GAAyC,IAAI,CAAC;IACnD,QAAQ,GAAG,KAAK,CAAC;IAEzB,YACmB,MAAqB,EACrB,GAAgB,EAChB,KAAa,EACb,MAAc;QAHd,WAAM,GAAN,MAAM,CAAe;QACrB,QAAG,GAAH,GAAG,CAAa;QAChB,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ,aAAa;IACb,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IACtB,CAAC;IAED,eAAe;IACf,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,uBAAuB;IACvB,YAAY,CAAC,OAAe;QAC1B,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED,iBAAiB;IACjB,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,OAAO;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1G,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF"}
+{"version":3,"file":"outbound-buffer.js","sourceRoot":"","sources":["../../src/transport/outbound-buffer.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,wCAAwC;AACxC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAc/B,MAAM,OAAO,cAAc;IAMN;IACA;IACA;IACA;IARX,MAAM,GAAG,EAAE,CAAC;IACZ,QAAQ,GAAG,KAAK,CAAC;IACR,MAAM,CAAyB;IAEhD,YACmB,MAAqB,EACrB,GAAgB,EAChB,KAAa,EACb,MAAc,EAC/B,gBAAyB;QAJR,WAAM,GAAN,MAAM,CAAe;QACrB,QAAG,GAAH,GAAG,CAAa;QAChB,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;QAG/B,IAAI,CAAC,MAAM,GAAG,gBAAgB;YAC5B,CAAC,CAAC,IAAI,eAAe,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;YAClG,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAED,aAAa;IACN,MAAM,CAAC,IAAY;QACxB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;QACpB,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,eAAe;IACf,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,yBAAyB;IAClB,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,OAAO;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC3B,kBAAkB;gBAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc;oBAAE,OAAO;YAC1C,CAAC;YAED,8BAA8B;YAC9B,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnG,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,0BAA0B;IACnB,MAAM;QACX,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/transport/outbound.d.ts

@@ -1,18 +1,19 @@
 /**
  * 出站处理器 — dsh session/event → QQ 消息发送
+ *
+ * 采用路由器模式：OutboundRouter 持有会话级状态（文本缓冲、工具调用记录），
+ * 事件解析归一化在 events.ts，路由按事件类型分发到私有方法。
  */
 import type { SessionManager } from '../session/index.js';
 import type { ImQQBotConfig } from '../config.js';
 import type { Logger } from '../types.js';
 import { type QQBotSender } from './outbound-buffer.js';
 import { type ToolsRegistryLike } from './tool-presenter.js';
+import { type RawSessionEvent } from './events.js';
 export type { QQBotSender } from './outbound-buffer.js';
 export type { ToolsRegistryLike } from './tool-presenter.js';
-/** dsh SessionEvent 简化类型 */
-export interface SessionEvent {
-    type: string;
-    data: Record<string, unknown>;
-}
+/** 出站处理器签名（注册到 ctx.on('session/event')） */
+export type OutboundHandler = (session: SessionLike, event: RawSessionEvent) => void;
 /** dsh Session 简化类型 */
 export interface SessionLike {
     header: {
@@ -25,5 +26,5 @@ export interface SessionLike {
  * 返回一个 handler 函数，应注册到 ctx.on('session/event', handler)。
  * toolsRegistry 用于工具结果的结构化展示（参考 dsh-TUI 的 presentResult）。
  */
-export declare function createOutboundHandler(manager: SessionManager, bot: QQBotSender, config: ImQQBotConfig, logger: Logger, toolsRegistry?: ToolsRegistryLike): (session: SessionLike, event: SessionEvent) => void;
+export declare function createOutboundHandler(manager: SessionManager, bot: QQBotSender, config: ImQQBotConfig, logger: Logger, toolsRegistry?: ToolsRegistryLike): OutboundHandler;
 //# sourceMappingURL=outbound.d.ts.map

package/dist/transport/outbound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../../src/transport/outbound.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAoB,KAAK,iBAAiB,EAAuB,MAAM,qBAAqB,CAAC;AAEpG,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,uBAAuB;AACvB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACxB;AAQD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,iBAAiB,GAChC,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAqCrD"}
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../../src/transport/outbound.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAoB,KAAK,iBAAiB,EAAuB,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAQL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAErF,uBAAuB;AACvB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACxB;AAoJD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,iBAAiB,GAChC,eAAe,CAGjB"}

package/dist/transport/outbound.js

@@ -1,138 +1,143 @@
 import { chunkMarkdownText } from './chunker.js';
 import { OutboundBuffer } from './outbound-buffer.js';
 import { formatToolResult } from './tool-presenter.js';
+import { parseEvent, extractTurnError, } from './events.js';
+/** 不展示给用户的轮次错误码（底层传输/网络错误，对用户无意义，且常被重试兜住） */
+const SILENT_TURN_ERROR_CODES = new Set(['STREAM_CLOSED']);
 /**
- * 创建出站事件处理器
- *
- * 返回一个 handler 函数，应注册到 ctx.on('session/event', handler)。
- * toolsRegistry 用于工具结果的结构化展示（参考 dsh-TUI 的 presentResult）。
+ * 出站路由器：持有会话级状态，按事件类型分发到处理器
  */
-export function createOutboundHandler(manager, bot, config, logger, toolsRegistry) {
-    const buffers = new Map();
-    const toolCalls = new Map();
-    const limit = config.textChunkLimit;
-    return (session, event) => {
-        const sessionId = session.header.id;
-        const record = manager.findBySessionId(sessionId);
-        if (!record)
+class OutboundRouter {
+    manager;
+    bot;
+    config;
+    logger;
+    toolsRegistry;
+    buffers = new Map();
+    toolCalls = new Map();
+    constructor(manager, bot, config, logger, toolsRegistry) {
+        this.manager = manager;
+        this.bot = bot;
+        this.config = config;
+        this.logger = logger;
+        this.toolsRegistry = toolsRegistry;
+    }
+    /** 事件分发入口 */
+    route(session, raw) {
+        const event = parseEvent(raw);
+        if (event === undefined)
+            return;
+        const record = this.manager.findBySessionId(session.header.id);
+        if (record === undefined)
             return;
         switch (event.type) {
-            case 'assistant/chunk': {
-                handleChunk(sessionId, record, event, buffers, bot, limit, logger);
+            case 'assistant/chunk':
+                this.onChunk(session.header.id, record, event);
                 break;
-            }
-            case 'assistant/message': {
-                handleMessage(sessionId, record, event, buffers, bot, limit, logger);
+            case 'assistant/message':
+                this.onMessage(session.header.id, record, event);
                 break;
-            }
-            case 'tool/call': {
-                handleToolCall(event, toolCalls);
+            case 'tool/call':
+                this.onToolCall(event);
                 break;
-            }
-            case 'tool/result': {
-                handleToolResult(record, event, toolCalls, bot, config, logger, toolsRegistry);
+            case 'tool/result':
+                this.onToolResult(record, event);
                 break;
-            }
-            case 'turn/end': {
-                handleTurnEnd(sessionId, buffers, logger);
+            case 'turn/end':
+                this.onTurnEnd(session.header.id, record, event);
                 break;
-            }
         }
-    };
-}
-/** 记录工具调用（不发送，避免刷屏，等待结果） */
-function handleToolCall(event, toolCalls) {
-    const data = event.data;
-    if (!data.callId || !data.name)
-        return;
-    toolCalls.set(data.callId, { name: data.name, args: data.arguments ?? '' });
-}
-/** 格式化并发送工具结果（错误始终发送，成功结果按开关） */
-function handleToolResult(record, event, toolCalls, bot, config, logger, toolsRegistry) {
-    const data = event.data;
-    const callId = data.message?.source?.callId;
-    if (!callId)
-        return;
-    const call = toolCalls.get(callId);
-    toolCalls.delete(callId);
-    if (!call)
-        return;
-    // 错误始终展示，成功结果按 config.showToolResults
-    if (data.error === undefined && !config.showToolResults)
-        return;
-    const text = formatToolResult(call.name, call.args, event.data, toolsRegistry, record.agent);
-    if (!text)
-        return;
-    void (async () => {
-        const chunks = chunkMarkdownText(text, config.textChunkLimit);
-        for (const chunk of chunks) {
-            try {
-                await bot.sendMarkdown(record.replyTarget, chunk);
-            }
-            catch (err) {
-                logger.error(`im-qqbot: sendToolResult failed: ${err instanceof Error ? err.message : String(err)}`);
-            }
+    }
+    /** 流式文本增量：累积到会话 buffer */
+    onChunk(sessionId, record, event) {
+        let buffer = this.buffers.get(sessionId);
+        if (buffer === undefined) {
+            buffer = new OutboundBuffer(record, this.bot, this.config.textChunkLimit, this.logger, this.shouldStream(record));
+            this.buffers.set(sessionId, buffer);
         }
-    })();
-}
-/** 处理流式文本增量 */
-function handleChunk(sessionId, record, event, buffers, bot, limit, logger) {
-    const chunk = event.data.chunk;
-    if (!chunk || chunk.type !== 'text-delta' || !chunk.text)
-        return;
-    let buffer = buffers.get(sessionId);
-    if (!buffer) {
-        buffer = new OutboundBuffer(record, bot, limit, logger);
-        buffers.set(sessionId, buffer);
+        buffer.append(event.text);
     }
-    buffer.append(chunk.text);
-}
-/** 处理完整 assistant 消息 */
-function handleMessage(sessionId, record, event, buffers, bot, limit, logger) {
-    const buffer = buffers.get(sessionId);
-    if (buffer && buffer.text.trim()) {
-        void buffer.flush();
-        buffers.delete(sessionId);
-        return;
+    /** 是否启用流式：配置开启 + c2c + 有 msgId（群聊不支持流式） */
+    shouldStream(record) {
+        return this.config.streaming
+            && record.replyTarget.scope === 'c2c'
+            && !!record.replyTarget.msgId;
+    }
+    /** 完整 assistant 消息：有流式 buffer 则 flush，否则直接发送文本块 */
+    onMessage(sessionId, record, event) {
+        const buffer = this.buffers.get(sessionId);
+        if (buffer !== undefined && buffer.text.trim()) {
+            void buffer.flush();
+            this.buffers.delete(sessionId);
+            return;
+        }
+        const textParts = [];
+        for (const block of event.content) {
+            if (block.type === 'text' && block.text)
+                textParts.push(block.text);
+        }
+        const fullText = textParts.join('\n');
+        if (!fullText.trim())
+            return;
+        void this.send(record, fullText, 'sendMarkdown');
+        this.buffers.delete(sessionId);
+    }
+    /** 工具调用：仅记录，不发送（避免刷屏，等待结果） */
+    onToolCall(event) {
+        this.toolCalls.set(event.callId, { name: event.name, args: event.arguments });
+    }
+    /** 工具结果：错误始终发送，成功结果按开关 */
+    onToolResult(record, event) {
+        const call = this.toolCalls.get(event.callId);
+        this.toolCalls.delete(event.callId);
+        if (call === undefined)
+            return;
+        if (event.error === undefined && !this.config.showToolResults)
+            return;
+        const text = formatToolResult(call.name, call.args, event.raw, this.toolsRegistry, record.agent);
+        if (!text)
+            return;
+        void this.send(record, text, 'sendToolResult');
     }
-    const message = event.data;
-    const blocks = message?.message?.content;
-    if (!blocks || !Array.isArray(blocks))
-        return;
-    const textParts = [];
-    for (const block of blocks) {
-        if (block.type === 'text' && block.text) {
-            textParts.push(block.text);
+    /** 轮次结束：清理 buffer，异常结束时告知用户 */
+    onTurnEnd(sessionId, record, event) {
+        const buffer = this.buffers.get(sessionId);
+        if (buffer !== undefined) {
+            if (buffer.text.trim()) {
+                void buffer.flush();
+            }
+            else {
+                buffer.cancel();
+            }
+            this.buffers.delete(sessionId);
+        }
+        const failure = extractTurnError(event.reason);
+        if (failure !== undefined && !SILENT_TURN_ERROR_CODES.has(failure.code)) {
+            void this.send(record, `⚠️ 本轮异常结束\n\`${failure.code}\`: ${failure.message}`, 'sendTurnEndError');
         }
+        this.logger.debug(`im-qqbot: turn/end sessionId=${sessionId}`);
     }
-    const fullText = textParts.join('\n');
-    if (!fullText.trim())
-        return;
-    const chunks = chunkMarkdownText(fullText, limit);
-    void (async () => {
+    /** 统一发送：切分 + 逐 chunk 发送 + 错误记录 */
+    async send(record, text, tag) {
+        const chunks = chunkMarkdownText(text, this.config.textChunkLimit);
         for (const chunk of chunks) {
             try {
-                await bot.sendMarkdown(record.replyTarget, chunk);
+                await this.bot.sendMarkdown(record.replyTarget, chunk);
             }
             catch (err) {
-                logger.error(`im-qqbot: sendMarkdown failed: ${err instanceof Error ? err.message : String(err)}`);
+                this.logger.error(`im-qqbot: ${tag} failed: ${err instanceof Error ? err.message : String(err)}`);
             }
         }
-    })();
-    buffers.delete(sessionId);
-}
-/** 处理轮次结束，清理 buffer */
-function handleTurnEnd(sessionId, buffers, logger) {
-    const buffer = buffers.get(sessionId);
-    if (buffer) {
-        if (buffer.text.trim()) {
-            void buffer.flush();
-        }
-        else {
-            buffer.cancel();
-        }
-        buffers.delete(sessionId);
     }
-    logger.debug(`im-qqbot: turn/end sessionId=${sessionId}`);
+}
+/**
+ * 创建出站事件处理器
+ *
+ * 返回一个 handler 函数，应注册到 ctx.on('session/event', handler)。
+ * toolsRegistry 用于工具结果的结构化展示（参考 dsh-TUI 的 presentResult）。
+ */
+export function createOutboundHandler(manager, bot, config, logger, toolsRegistry) {
+    const router = new OutboundRouter(manager, bot, config, logger, toolsRegistry);
+    return (session, event) => router.route(session, event);
 }
 //# sourceMappingURL=outbound.js.map

package/dist/transport/outbound.js.map

@@ -1 +1 @@
-{"version":3,"file":"outbound.js","sourceRoot":"","sources":["../../src/transport/outbound.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"outbound.js","sourceRoot":"","sources":["../../src/transport/outbound.ts"],"names":[],"mappings":"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"}

package/dist/transport/streaming-writer.d.ts

@@ -0,0 +1,47 @@
+/**
+ * StreamingWriter — QQ 流式文本写入器
+ *
+ * 边界条件设计：
+ *   - 节流（throttle）：固定间隔 flush，避免每 token 发 HTTP，同时保证长文本分多次推送
+ *   - 串行队列（chain）：保证 update 顺序，finish 前最后一次文本必达
+ *   - 降级（sentChunkCount === 0）：只有从未成功发送分片才降级静态，
+ *     避免"已流式部分 + 静态全量"的重复内容
+ *   - 终态幂等（finished）：finish/abort 后忽略 append，重复 finish 不重复 complete
+ *   - 中止关闭（abort）：abort 时若 session 已打开，串行 complete 关闭，避免悬挂
+ */
+import type { Logger, ReplyTarget } from '../types.js';
+import type { QQBotSender } from './outbound-buffer.js';
+export interface StreamingWriterDeps {
+    bot: QQBotSender;
+    target: ReplyTarget;
+    logger: Logger;
+    /** 节流间隔（ms）：连续 append 累积后，停顿该间隔才 update */
+    throttleMs: number;
+}
+export declare class StreamingWriter {
+    private readonly deps;
+    private fullText;
+    private session;
+    private sentChunkCount;
+    private failed;
+    private finished;
+    private aborted;
+    private throttleTimer;
+    private chain;
+    constructor(deps: StreamingWriterDeps);
+    /** 是否应降级为静态发送：从未成功发送过任何分片 */
+    get shouldFallback(): boolean;
+    /** 累积全文（降级静态发送时使用） */
+    get text(): string;
+    /** 追加增量文本，节流（throttle）后 update 全量 */
+    append(delta: string): void;
+    /** 结束：flush 最终文本 + complete 收尾 */
+    finish(): Promise<void>;
+    /** 中止（异常/取消）：关闭已打开的流式会话，避免悬挂 */
+    abort(): void;
+    /** 入队一次 update（串行，保证顺序） */
+    private enqueue;
+    /** 推送当前累积文本（首次 openStream + update 全量） */
+    private pushUpdate;
+}
+//# sourceMappingURL=streaming-writer.d.ts.map

package/dist/transport/streaming-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-writer.d.ts","sourceRoot":"","sources":["../../src/transport/streaming-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,sBAAsB,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,WAAW,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAe;IAUP,OAAO,CAAC,QAAQ,CAAC,IAAI;IATxC,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,KAAK,CAAoC;gBAEb,IAAI,EAAE,mBAAmB;IAE7D,6BAA6B;IAC7B,IAAW,cAAc,IAAI,OAAO,CAEnC;IAED,sBAAsB;IACtB,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,qCAAqC;IAC9B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAclC,kCAAkC;IACrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBpC,gCAAgC;IACzB,KAAK,IAAI,IAAI;IAwBpB,2BAA2B;IAC3B,OAAO,CAAC,OAAO;IAIf,0CAA0C;YAC5B,UAAU;CA2BzB"}