@zaofan/dsh-qqbot 0.6.0

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

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

package/dist/transport/outbound.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 出站处理器 — 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';
+/** 出站处理器签名（注册到 ctx.on('session/event')） */
+export type OutboundHandler = (session: SessionLike, event: RawSessionEvent) => void;
+/** dsh Session 简化类型 */
+export interface SessionLike {
+    header: {
+        id: string;
+    };
+}
+/**
+ * 创建出站事件处理器
+ *
+ * 返回一个 handler 函数，应注册到 ctx.on('session/event', handler)。
+ * toolsRegistry 用于工具结果的结构化展示（参考 dsh-TUI 的 presentResult）。
+ */
+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

@@ -0,0 +1 @@
+{"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;AAC1C,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC1F,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;AAwJD;;;;;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

@@ -0,0 +1,139 @@
+import { OutboundBuffer, sendRichOutbound } 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']);
+/**
+ * 出站路由器：持有会话级状态，按事件类型分发到处理器
+ */
+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':
+                this.onChunk(session.header.id, record, event);
+                break;
+            case 'assistant/message':
+                this.onMessage(session.header.id, record, event);
+                break;
+            case 'tool/call':
+                this.onToolCall(event);
+                break;
+            case 'tool/result':
+                this.onToolResult(record, event);
+                break;
+            case 'turn/end':
+                this.onTurnEnd(session.header.id, record, event);
+                break;
+        }
+    }
+    /** 流式文本增量：累积到会话 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.config.cwd);
+            this.buffers.set(sessionId, buffer);
+        }
+        buffer.append(event.text);
+    }
+    /** 是否启用流式：配置开启 + 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');
+    }
+    /** 轮次结束：清理 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}`);
+    }
+    /** 统一发送：富媒体感知 + 分块；媒体指令([MEDIA:..]/[RECALL])被剔除，失败降级记录 */
+    async send(record, text, tag) {
+        try {
+            await sendRichOutbound(this.bot, record.replyTarget, text, this.config.textChunkLimit, this.config.cwd, (m) => this.logger.error(m));
+        }
+        catch (err) {
+            this.logger.error(`im-qqbot: ${tag} failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+/**
+ * 创建出站事件处理器
+ *
+ * 返回一个 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

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

package/dist/transport/rich-media.d.ts

@@ -0,0 +1,41 @@
+export type MediaKind = 'image' | 'video' | 'voice' | 'file';
+/** 是否含撤回指令 */
+export declare function containsRecall(text: string): boolean;
+/** 收集文本里出现的所有撤回指令序号(按出现顺序)。[RECALL]→1。无则返回空数组。 */
+export declare function collectRecallIndices(text: string): number[];
+export type Segment = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'media';
+    kind: MediaKind;
+    source: string;
+};
+/** 是否含富媒体指令 */
+export declare function containsMedia(text: string): boolean;
+/**
+ * 把一段 agent 文本拆成 Segment[]：文本段与富媒体段交替。
+ * 富媒体标记被剔除；[RECALL] 不在此拆分（由调用方单独处理，避免污染文本段）。
+ */
+export declare function parseOutbound(text: string): Segment[];
+/**
+ * 把标记文本清理成"仅剩要展示的纯文本"（去掉富媒体与撤回指令），供降级/预览。
+ */
+export declare function stripDirectives(text: string): string;
+/**
+ * 把 agent 给出的 source 解析为可直接喂给底层 sendImage/sendFile 的来源。
+ * 规则：
+ *   http(s)://  → 原样(URL)
+ *   file://     → 本地绝对路径
+ *   Windows 盘符/绝对路径 → 原样
+ *   其余(相对) → 相对 cwd 解析为绝对路径
+ * 返回 { kind: 'url', url } | { kind: 'localPath', path }，便于底层分发。
+ */
+export declare function resolveSource(source: string, cwd: string | undefined): {
+    kind: 'url';
+    url: string;
+} | {
+    kind: 'localPath';
+    path: string;
+};
+//# sourceMappingURL=rich-media.d.ts.map

package/dist/transport/rich-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-media.d.ts","sourceRoot":"","sources":["../../src/transport/rich-media.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAS7D,cAAc;AACd,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED,kDAAkD;AAClD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAS3D;AAED,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,eAAe;AACf,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAoBrD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAWzI"}

package/dist/transport/rich-media.js

@@ -0,0 +1,104 @@
+/**
+ * rich-media.ts — agent 富媒体出站 / 撤回 的结构化标记解析与来源解析
+ *
+ * agent 在回复文本里输出以下标记即可触发发送/撤回（发送层把指令从展示文本中剔除）：
+ *   [MEDIA:image|<url|本地路径>]
+ *   [MEDIA:video|<url|本地路径>]
+ *   [MEDIA:voice|<url|本地路径>]
+ *   [MEDIA:file|<url|本地路径>]
+ *   [RECALL]                // 撤本 bot 发给该 peer 的最近一条(= [RECALL:1])
+ *   [RECALL:2]              // 撤倒数第 2 条；[RECALL:N] 撤倒数第 N 条
+ *
+ * 仅纯函数/正则，便于单测；发送动作由调用方(outbound)根据 Segment 分派到 QQBotSender。
+ */
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+/** 富媒体标记：支持单个或多段连续出现 */
+const MEDIA_RE = /\[MEDIA:(image|video|voice|file)\|([^\]]+)\]/g;
+/** 撤回标记：支持 [RECALL] 或 [RECALL:N]（N=撤倒数第 N 条，默认 1） */
+const RECALL_RE = /\[RECALL(?::\s*(\d+))?\]/;
+/** 全局版：一次性清除/收集文本里所有撤回指令 */
+const RECALL_G_RE = /\[RECALL(?::\s*(\d+))?\]/g;
+/** 是否含撤回指令 */
+export function containsRecall(text) {
+    RECALL_RE.lastIndex = 0;
+    return RECALL_RE.test(text);
+}
+/** 收集文本里出现的所有撤回指令序号(按出现顺序)。[RECALL]→1。无则返回空数组。 */
+export function collectRecallIndices(text) {
+    RECALL_G_RE.lastIndex = 0;
+    const out = [];
+    let m;
+    while ((m = RECALL_G_RE.exec(text)) !== null) {
+        const n = m[1] ? parseInt(m[1], 10) : 1;
+        out.push(Number.isFinite(n) && n >= 1 ? n : 1);
+    }
+    return out;
+}
+/** 是否含富媒体指令 */
+export function containsMedia(text) {
+    MEDIA_RE.lastIndex = 0;
+    return MEDIA_RE.test(text);
+}
+/**
+ * 把一段 agent 文本拆成 Segment[]：文本段与富媒体段交替。
+ * 富媒体标记被剔除；[RECALL] 不在此拆分（由调用方单独处理，避免污染文本段）。
+ */
+export function parseOutbound(text) {
+    const segments = [];
+    MEDIA_RE.lastIndex = 0;
+    let last = 0;
+    let m;
+    while ((m = MEDIA_RE.exec(text)) !== null) {
+        if (m.index > last) {
+            const t = text.slice(last, m.index);
+            if (t.trim())
+                segments.push({ type: 'text', text: t });
+        }
+        const kind = m[1];
+        const source = (m[2] ?? '').trim();
+        if (source)
+            segments.push({ type: 'media', kind, source });
+        last = m.index + m[0].length;
+    }
+    if (last < text.length) {
+        const t = text.slice(last);
+        if (t.trim())
+            segments.push({ type: 'text', text: t });
+    }
+    return segments;
+}
+/**
+ * 把标记文本清理成"仅剩要展示的纯文本"（去掉富媒体与撤回指令），供降级/预览。
+ */
+export function stripDirectives(text) {
+    return text.replace(MEDIA_RE, '').replace(RECALL_G_RE, '').replace(/\n{3,}/g, '\n\n').trim();
+}
+/**
+ * 把 agent 给出的 source 解析为可直接喂给底层 sendImage/sendFile 的来源。
+ * 规则：
+ *   http(s)://  → 原样(URL)
+ *   file://     → 本地绝对路径
+ *   Windows 盘符/绝对路径 → 原样
+ *   其余(相对) → 相对 cwd 解析为绝对路径
+ * 返回 { kind: 'url', url } | { kind: 'localPath', path }，便于底层分发。
+ */
+export function resolveSource(source, cwd) {
+    const s = source.trim();
+    if (/^https?:\/\//i.test(s))
+        return { kind: 'url', url: s };
+    if (s.startsWith('file://')) {
+        try {
+            return { kind: 'localPath', path: fileURLToPath(s) };
+        }
+        catch {
+            return { kind: 'localPath', path: s.replace(/^file:\/\//, '') };
+        }
+    }
+    // Windows 盘符或绝对路径
+    if (/^[a-zA-Z]:[\\/]/.test(s) || s.startsWith('/'))
+        return { kind: 'localPath', path: s };
+    // 相对 → 相对 cwd
+    return { kind: 'localPath', path: cwd ? path.resolve(cwd, s) : s };
+}
+//# sourceMappingURL=rich-media.js.map

package/dist/transport/rich-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-media.js","sourceRoot":"","sources":["../../src/transport/rich-media.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"}

package/dist/transport/streaming-writer.js

@@ -0,0 +1,110 @@
+export class StreamingWriter {
+    deps;
+    fullText = '';
+    session = null;
+    sentChunkCount = 0;
+    failed = false;
+    finished = false;
+    aborted = false;
+    throttleTimer = null;
+    chain = Promise.resolve();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** 是否应降级为静态发送：从未成功发送过任何分片 */
+    get shouldFallback() {
+        return this.sentChunkCount === 0;
+    }
+    /** 累积全文（降级静态发送时使用） */
+    get text() {
+        return this.fullText;
+    }
+    /** 追加增量文本，节流（throttle）后 update 全量 */
+    append(delta) {
+        if (this.finished)
+            return;
+        this.fullText += delta;
+        // throttle：仅在无 pending timer 时启动，固定间隔 flush。
+        // 不用 debounce（否则 chunk 持续到达时永远憋着，流式退化成一次性全量发送）
+        if (this.throttleTimer === null) {
+            this.throttleTimer = setTimeout(() => {
+                this.throttleTimer = null;
+                this.enqueue();
+            }, this.deps.throttleMs);
+        }
+    }
+    /** 结束：flush 最终文本 + complete 收尾 */
+    async finish() {
+        if (this.finished)
+            return;
+        this.finished = true;
+        if (this.throttleTimer) {
+            clearTimeout(this.throttleTimer);
+            this.throttleTimer = null;
+        }
+        // 立即把最终累积文本入队（覆盖节流未触发的场景）
+        this.enqueue();
+        await this.chain;
+        // 只要 session 存在就 complete（关闭流式消息，无论是否降级）
+        if (this.session) {
+            try {
+                await this.session.complete();
+            }
+            catch (err) {
+                this.deps.logger.error(`im-qqbot: stream complete failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    /** 中止（异常/取消）：关闭已打开的流式会话，避免悬挂 */
+    abort() {
+        if (this.finished)
+            return;
+        this.finished = true;
+        this.aborted = true;
+        if (this.throttleTimer) {
+            clearTimeout(this.throttleTimer);
+            this.throttleTimer = null;
+        }
+        // 串行 complete（排在 pending update 之后），关闭已打开的流式会话
+        this.chain = this.chain.then(async () => {
+            if (this.session) {
+                try {
+                    await this.session.complete();
+                }
+                catch (err) {
+                    this.deps.logger.error(`im-qqbot: stream abort complete failed: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        });
+    }
+    /** 入队一次 update（串行，保证顺序） */
+    enqueue() {
+        this.chain = this.chain.then(() => this.pushUpdate());
+    }
+    /** 推送当前累积文本（首次 openStream + update 全量） */
+    async pushUpdate() {
+        if (this.aborted || this.failed || !this.fullText)
+            return;
+        if (!this.session) {
+            try {
+                this.session = this.deps.bot.openStream(this.deps.target);
+                this.deps.logger.debug(`im-qqbot: stream opened (chars=${this.fullText.length})`);
+            }
+            catch (err) {
+                // openStream 失败：标记 failed 避免重复尝试，后续走降级静态
+                this.failed = true;
+                this.deps.logger.warn(`im-qqbot: openStream failed, fallback to static: ${err instanceof Error ? err.message : String(err)}`);
+                return;
+            }
+        }
+        try {
+            await this.session.update(this.fullText);
+            this.sentChunkCount++;
+        }
+        catch (err) {
+            // update 失败：不标记 failed（session 已打开，finish 会 complete 关闭）
+            this.deps.logger.warn(`im-qqbot: stream update failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+//# sourceMappingURL=streaming-writer.js.map

package/dist/transport/streaming-writer.js.map

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

package/dist/transport/tool-presenter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 工具调用结果 → Markdown 格式化
+ *
+ * 参考 dsh-TUI 的 presentResult 机制（channel.ts presentResultView），
+ * 适配 QQ 消息通道：优先用工具自定义的 presentResult 视图，
+ * fallback 到 raw text。错误始终展示，成功结果按 config 开关。
+ */
+/** dsh-tools 主机平面注册表（presentResult 能力） */
+export interface ToolsRegistryLike {
+    get(name: string, scope?: unknown): {
+        presentResult?(args: unknown, result: unknown): unknown;
+    } | undefined;
+}
+/** 工具结果事件数据（tool/result） */
+export interface ToolResultData {
+    message: {
+        content: Array<{
+            type: string;
+            content?: unknown;
+            isError?: boolean;
+        }>;
+        source: {
+            callId: string;
+        };
+    };
+    error?: {
+        name: string;
+        code: string;
+    };
+    meta?: unknown;
+}
+/**
+ * 将工具调用结果格式化为 Markdown 文本
+ *
+ * 返回 null 表示无需发送（无内容）。
+ */
+export declare function formatToolResult(name: string, rawArgs: string, data: ToolResultData, toolsRegistry: ToolsRegistryLike | undefined, agent: unknown): string | null;
+//# sourceMappingURL=tool-presenter.d.ts.map

package/dist/transport/tool-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-presenter.d.ts","sourceRoot":"","sources":["../../src/transport/tool-presenter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG;QAClC,aAAa,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;KACzD,GAAG,SAAS,CAAC;CACf;AAED,4BAA4B;AAC5B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QACP,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACvE,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5B,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAcD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,EACpB,aAAa,EAAE,iBAAiB,GAAG,SAAS,EAC5C,KAAK,EAAE,OAAO,GACb,MAAM,GAAG,IAAI,CAoBf"}