dsh-qqbot-plus 0.0.0-stage → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +188 -0
- package/CHANGELOG_EN.md +188 -0
- package/LICENSE +21 -0
- package/README.md +281 -2
- package/README_EN.md +248 -0
- package/cordis.patch.yml +163 -0
- package/cordis.yml +112 -0
- package/install.sh +108 -0
- package/lib/alarms.js +371 -0
- package/lib/client.js +2411 -0
- package/lib/commands/auth.d.ts +18 -0
- package/lib/commands/auth.d.ts.map +1 -0
- package/lib/commands/auth.js +15 -0
- package/lib/commands/auth.js.map +1 -0
- package/lib/commands/help.d.ts +10 -0
- package/lib/commands/help.d.ts.map +1 -0
- package/lib/commands/help.js +39 -0
- package/lib/commands/help.js.map +1 -0
- package/lib/commands/index.d.ts +15 -0
- package/lib/commands/index.d.ts.map +1 -0
- package/lib/commands/index.js +30 -0
- package/lib/commands/index.js.map +1 -0
- package/lib/commands/misc.d.ts +21 -0
- package/lib/commands/misc.d.ts.map +1 -0
- package/lib/commands/misc.js +93 -0
- package/lib/commands/misc.js.map +1 -0
- package/lib/commands/model.d.ts +6 -0
- package/lib/commands/model.d.ts.map +1 -0
- package/lib/commands/model.js +63 -0
- package/lib/commands/model.js.map +1 -0
- package/lib/commands/new.js +17 -0
- package/lib/commands/preset.d.ts +8 -0
- package/lib/commands/preset.d.ts.map +1 -0
- package/lib/commands/preset.js +56 -0
- package/lib/commands/preset.js.map +1 -0
- package/lib/commands/session.d.ts +14 -0
- package/lib/commands/session.d.ts.map +1 -0
- package/lib/commands/session.js +34 -0
- package/lib/commands/session.js.map +1 -0
- package/lib/commands/status.d.ts +7 -0
- package/lib/commands/status.d.ts.map +1 -0
- package/lib/commands/status.js +26 -0
- package/lib/commands/status.js.map +1 -0
- package/lib/commands/types.d.ts +21 -0
- package/lib/commands/types.d.ts.map +1 -0
- package/lib/commands/types.js +2 -0
- package/lib/commands/types.js.map +1 -0
- package/lib/config.d.ts +95 -0
- package/lib/config.js +88 -0
- package/lib/features/answer-parser.d.ts +9 -0
- package/lib/features/answer-parser.d.ts.map +1 -0
- package/lib/features/answer-parser.js +23 -0
- package/lib/features/answer-parser.js.map +1 -0
- package/lib/features/approval-channel.d.ts +94 -0
- package/lib/features/approval-channel.d.ts.map +1 -0
- package/lib/features/approval-channel.js +158 -0
- package/lib/features/approval-channel.js.map +1 -0
- package/lib/features/approval-renderer.d.ts +18 -0
- package/lib/features/approval-renderer.d.ts.map +1 -0
- package/lib/features/approval-renderer.js +52 -0
- package/lib/features/approval-renderer.js.map +1 -0
- package/lib/features/button-utils.d.ts +34 -0
- package/lib/features/button-utils.d.ts.map +1 -0
- package/lib/features/button-utils.js +27 -0
- package/lib/features/button-utils.js.map +1 -0
- package/lib/features/history-store.d.ts +8 -0
- package/lib/features/history-store.d.ts.map +1 -0
- package/lib/features/history-store.js +23 -0
- package/lib/features/history-store.js.map +1 -0
- package/lib/features/question-channel.d.ts +96 -0
- package/lib/features/question-channel.d.ts.map +1 -0
- package/lib/features/question-channel.js +234 -0
- package/lib/features/question-channel.js.map +1 -0
- package/lib/features/question-renderer.d.ts +20 -0
- package/lib/features/question-renderer.d.ts.map +1 -0
- package/lib/features/question-renderer.js +70 -0
- package/lib/features/question-renderer.js.map +1 -0
- package/lib/fishcheck/measure.js +230 -0
- package/lib/fishcheck/rules.js +99 -0
- package/lib/fishmeme/plugin.js +605 -0
- package/lib/fishmeme/routes.js +141 -0
- package/lib/fishmemory/plugin.js +1052 -0
- package/lib/gateway/bootstrap.d.ts +12 -0
- package/lib/gateway/bootstrap.d.ts.map +1 -0
- package/lib/gateway/bootstrap.js +200 -0
- package/lib/gateway/bootstrap.js.map +1 -0
- package/lib/gateway/index.d.ts +3 -0
- package/lib/gateway/index.d.ts.map +1 -0
- package/lib/gateway/index.js +3 -0
- package/lib/gateway/index.js.map +1 -0
- package/lib/gateway/middleware-setup.d.ts +12 -0
- package/lib/gateway/middleware-setup.d.ts.map +1 -0
- package/lib/gateway/middleware-setup.js +82 -0
- package/lib/gateway/middleware-setup.js.map +1 -0
- package/lib/host/adapter.d.ts +48 -0
- package/lib/host/adapter.d.ts.map +1 -0
- package/lib/host/adapter.js +127 -0
- package/lib/host/adapter.js.map +1 -0
- package/lib/humanlike/ENV_PROMPT.md +28 -0
- package/lib/humanlike/affinity.js +316 -0
- package/lib/humanlike/learn.js +343 -0
- package/lib/humanlike/life.js +899 -0
- package/lib/humanlike/mind.js +323 -0
- package/lib/humanlike/plugin.js +587 -0
- package/lib/humanlike/reach.js +119 -0
- package/lib/humanlike/real.js +276 -0
- package/lib/humanlike/rules.js +67 -0
- package/lib/humanlike/settings-api.js +159 -0
- package/lib/humanlike/settings.js +370 -0
- package/lib/humanlike/together.js +251 -0
- package/lib/identity/paths.js +27 -0
- package/lib/identity/persona.js +75 -0
- package/lib/identity/portrait.js +25 -0
- package/lib/identity/runtime.js +78 -0
- package/lib/index.d.ts +15 -0
- package/lib/index.js +117 -0
- package/lib/media/draft-tool.js +442 -0
- package/lib/media/draft-tool.js.bak-to-182027 +389 -0
- package/lib/media/media-cleaner.d.ts +19 -0
- package/lib/media/media-cleaner.d.ts.map +1 -0
- package/lib/media/media-cleaner.js +81 -0
- package/lib/media/media-cleaner.js.map +1 -0
- package/lib/media/say-tool.js +72 -0
- package/lib/media/send-file-tool.d.ts +12 -0
- package/lib/media/send-file-tool.d.ts.map +1 -0
- package/lib/media/send-file-tool.js +122 -0
- package/lib/media/send-file-tool.js.map +1 -0
- package/lib/media/send-media.d.ts +61 -0
- package/lib/media/send-media.d.ts.map +1 -0
- package/lib/media/send-media.js +104 -0
- package/lib/media/send-media.js.map +1 -0
- package/lib/media/vision-tool.d.ts +22 -0
- package/lib/media/vision-tool.d.ts.map +1 -0
- package/lib/media/vision-tool.js +288 -0
- package/lib/media/vision-tool.js.map +1 -0
- package/lib/middleware/attachment.d.ts +11 -0
- package/lib/middleware/attachment.d.ts.map +1 -0
- package/lib/middleware/attachment.js +30 -0
- package/lib/middleware/attachment.js.map +1 -0
- package/lib/middleware/question-answer.d.ts +10 -0
- package/lib/middleware/question-answer.d.ts.map +1 -0
- package/lib/middleware/question-answer.js +19 -0
- package/lib/middleware/question-answer.js.map +1 -0
- package/lib/model/index.d.ts +10 -0
- package/lib/model/index.d.ts.map +1 -0
- package/lib/model/index.js +9 -0
- package/lib/model/index.js.map +1 -0
- package/lib/model/model-resolver.d.ts +102 -0
- package/lib/model/model-resolver.d.ts.map +1 -0
- package/lib/model/model-resolver.js +206 -0
- package/lib/model/model-resolver.js.map +1 -0
- package/lib/model/prefs-store.d.ts +50 -0
- package/lib/model/prefs-store.d.ts.map +1 -0
- package/lib/model/prefs-store.js +215 -0
- package/lib/model/prefs-store.js.map +1 -0
- package/lib/model/settings-reader.d.ts +19 -0
- package/lib/model/settings-reader.d.ts.map +1 -0
- package/lib/model/settings-reader.js +76 -0
- package/lib/model/settings-reader.js.map +1 -0
- package/lib/model/types.d.ts +15 -0
- package/lib/model/types.d.ts.map +1 -0
- package/lib/model/types.js +5 -0
- package/lib/model/types.js.map +1 -0
- package/lib/resume-check.js +122 -0
- package/lib/resume-tool.js +29 -0
- package/lib/rules.js +57 -0
- package/lib/session/idle-evictor.d.ts +18 -0
- package/lib/session/idle-evictor.d.ts.map +1 -0
- package/lib/session/idle-evictor.js +31 -0
- package/lib/session/idle-evictor.js.map +1 -0
- package/lib/session/index.d.ts +9 -0
- package/lib/session/index.d.ts.map +1 -0
- package/lib/session/index.js +8 -0
- package/lib/session/index.js.map +1 -0
- package/lib/session/pick-agent.js +116 -0
- package/lib/session/session-id.d.ts +5 -0
- package/lib/session/session-id.d.ts.map +1 -0
- package/lib/session/session-id.js +15 -0
- package/lib/session/session-id.js.map +1 -0
- package/lib/session/session-manager.d.ts +138 -0
- package/lib/session/session-manager.d.ts.map +1 -0
- package/lib/session/session-manager.js +1157 -0
- package/lib/session/session-manager.js.bak-target +1081 -0
- package/lib/session/session-manager.js.bak-title-20261118 +1119 -0
- package/lib/session/session-manager.js.map +1 -0
- package/lib/session/types.d.ts +162 -0
- package/lib/session/types.d.ts.map +1 -0
- package/lib/session/types.js +2 -0
- package/lib/session/types.js.map +1 -0
- package/lib/setup/bind-routes.d.ts +78 -0
- package/lib/setup/bind-routes.d.ts.map +1 -0
- package/lib/setup/bind-routes.js +588 -0
- package/lib/setup/bind-routes.js.bak-join-163944 +761 -0
- package/lib/setup/bind-routes.js.map +1 -0
- package/lib/setup/binding-service.d.ts +86 -0
- package/lib/setup/binding-service.d.ts.map +1 -0
- package/lib/setup/binding-service.js +175 -0
- package/lib/setup/binding-service.js.map +1 -0
- package/lib/setup/index.d.ts +50 -0
- package/lib/setup/index.d.ts.map +1 -0
- package/lib/setup/index.js +163 -0
- package/lib/setup/index.js.map +1 -0
- package/lib/setup/persist.d.ts +42 -0
- package/lib/setup/persist.d.ts.map +1 -0
- package/lib/setup/persist.js +344 -0
- package/lib/setup/persist.js.map +1 -0
- package/lib/setup/presenters.d.ts +40 -0
- package/lib/setup/presenters.d.ts.map +1 -0
- package/lib/setup/presenters.js +84 -0
- package/lib/setup/presenters.js.map +1 -0
- package/lib/setup/qr-svg.d.ts +9 -0
- package/lib/setup/qr-svg.d.ts.map +1 -0
- package/lib/setup/qr-svg.js +33 -0
- package/lib/setup/qr-svg.js.map +1 -0
- package/lib/shared/bind-protocol.d.ts +42 -0
- package/lib/shared/bind-protocol.d.ts.map +1 -0
- package/lib/shared/bind-protocol.js +33 -0
- package/lib/shared/bind-protocol.js.map +1 -0
- package/lib/shared/dirs.d.ts +10 -0
- package/lib/shared/dirs.d.ts.map +1 -0
- package/lib/shared/dirs.js +20 -0
- package/lib/shared/dirs.js.map +1 -0
- package/lib/shared/http-body.js +43 -0
- package/lib/shared/index.d.ts +8 -0
- package/lib/shared/index.d.ts.map +1 -0
- package/lib/shared/index.js +8 -0
- package/lib/shared/index.js.map +1 -0
- package/lib/shared/json-file.js +34 -0
- package/lib/shared/orders.js +26 -0
- package/lib/shared/scope.d.ts +14 -0
- package/lib/shared/scope.d.ts.map +1 -0
- package/lib/shared/scope.js +12 -0
- package/lib/shared/scope.js.map +1 -0
- package/lib/shared/send-helper.d.ts +11 -0
- package/lib/shared/send-helper.d.ts.map +1 -0
- package/lib/shared/send-helper.js +13 -0
- package/lib/shared/send-helper.js.map +1 -0
- package/lib/shared/utils.d.ts +31 -0
- package/lib/shared/utils.d.ts.map +1 -0
- package/lib/shared/utils.js +228 -0
- package/lib/shared/utils.js.map +1 -0
- package/lib/tool-guard.js +74 -0
- package/lib/transport/attachment.d.ts +41 -0
- package/lib/transport/attachment.d.ts.map +1 -0
- package/lib/transport/attachment.js +191 -0
- package/lib/transport/attachment.js.map +1 -0
- package/lib/transport/chunker.d.ts +14 -0
- package/lib/transport/chunker.d.ts.map +1 -0
- package/lib/transport/chunker.js +78 -0
- package/lib/transport/chunker.js.map +1 -0
- package/lib/transport/deliverables.d.ts +20 -0
- package/lib/transport/deliverables.d.ts.map +1 -0
- package/lib/transport/deliverables.js +72 -0
- package/lib/transport/deliverables.js.map +1 -0
- package/lib/transport/events.d.ts +117 -0
- package/lib/transport/events.d.ts.map +1 -0
- package/lib/transport/events.js +112 -0
- package/lib/transport/events.js.map +1 -0
- package/lib/transport/inbound.d.ts +11 -0
- package/lib/transport/inbound.d.ts.map +1 -0
- package/lib/transport/inbound.js +511 -0
- package/lib/transport/inbound.js.map +1 -0
- package/lib/transport/index.d.ts +10 -0
- package/lib/transport/index.d.ts.map +1 -0
- package/lib/transport/index.js +10 -0
- package/lib/transport/index.js.map +1 -0
- package/lib/transport/msgid-cache.d.ts +23 -0
- package/lib/transport/msgid-cache.d.ts.map +1 -0
- package/lib/transport/msgid-cache.js +57 -0
- package/lib/transport/msgid-cache.js.map +1 -0
- package/lib/transport/notify.js +147 -0
- package/lib/transport/outbound-buffer.d.ts +42 -0
- package/lib/transport/outbound-buffer.d.ts.map +1 -0
- package/lib/transport/outbound-buffer.js +68 -0
- package/lib/transport/outbound-buffer.js.map +1 -0
- package/lib/transport/outbound.d.ts +42 -0
- package/lib/transport/outbound.d.ts.map +1 -0
- package/lib/transport/outbound.js +183 -0
- package/lib/transport/outbound.js.map +1 -0
- package/lib/transport/reply-limiter.d.ts +31 -0
- package/lib/transport/reply-limiter.d.ts.map +1 -0
- package/lib/transport/reply-limiter.js +50 -0
- package/lib/transport/reply-limiter.js.map +1 -0
- package/lib/transport/reply-target.d.ts +32 -0
- package/lib/transport/reply-target.d.ts.map +1 -0
- package/lib/transport/reply-target.js +64 -0
- package/lib/transport/reply-target.js.map +1 -0
- package/lib/transport/streaming-writer.d.ts +55 -0
- package/lib/transport/streaming-writer.d.ts.map +1 -0
- package/lib/transport/streaming-writer.js +122 -0
- package/lib/transport/streaming-writer.js.map +1 -0
- package/lib/transport/tool-presenter.d.ts +37 -0
- package/lib/transport/tool-presenter.d.ts.map +1 -0
- package/lib/transport/tool-presenter.js +116 -0
- package/lib/transport/tool-presenter.js.map +1 -0
- package/lib/turn-check.js +85 -0
- package/lib/types.d.ts +39 -0
- package/lib/types.js +5 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +127 -4
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 富媒体下载 — 将 QQ 图片/视频/file 附件安全下载到本地
|
|
3
|
+
*
|
|
4
|
+
* 下载后仅通过本地绝对路径提示模型,由模型通过 qqbot_describe_image / ffmpeg / tool-fs 等工具自行分析,
|
|
5
|
+
*
|
|
6
|
+
* 下载目录固定为 ~/.dsh/dsh-qqbot-plus/media,
|
|
7
|
+
* 文件名用时间戳+随机数防重名,不依赖 agent cwd,便于 qqbot_describe_image / tool-fs 等工具稳定访问。
|
|
8
|
+
*/
|
|
9
|
+
import { mkdirSync, writeFileSync } from 'node:fs';
|
|
10
|
+
import { basename, extname, join, sep } from 'node:path';
|
|
11
|
+
import { randomBytes } from 'node:crypto';
|
|
12
|
+
import * as dns from 'node:dns';
|
|
13
|
+
import { MEDIA_ROOT } from "../media/media-cleaner.js";
|
|
14
|
+
/** 默认富媒体下载大小上限(MB),可被 media.maxMB 覆盖 */
|
|
15
|
+
const DEFAULT_MAX_MB = 200;
|
|
16
|
+
/** 下载超时(毫秒) */
|
|
17
|
+
const DOWNLOAD_TIMEOUT_MS = 120_000;
|
|
18
|
+
/** 是否为图片(兼容裸值 'image' 与 MIME 'image/png') */
|
|
19
|
+
export function isImageContentType(contentType) {
|
|
20
|
+
return contentType === 'image' || contentType?.startsWith('image/') === true;
|
|
21
|
+
}
|
|
22
|
+
/** 是否为视频(兼容裸值 'video' 与 MIME 'video/mp4') */
|
|
23
|
+
export function isVideoContentType(contentType) {
|
|
24
|
+
return contentType === 'video' || contentType?.startsWith('video/') === true;
|
|
25
|
+
}
|
|
26
|
+
/** 是否为语音(兼容裸值 'voice' 与 MIME 'audio/silk') */
|
|
27
|
+
export function isVoiceContentType(contentType) {
|
|
28
|
+
return contentType === 'voice' || contentType?.startsWith('audio/') === true;
|
|
29
|
+
}
|
|
30
|
+
/** 归类附件 content_type 为统一类型 */
|
|
31
|
+
export function classifyContentType(contentType) {
|
|
32
|
+
if (isImageContentType(contentType))
|
|
33
|
+
return 'image';
|
|
34
|
+
if (isVideoContentType(contentType))
|
|
35
|
+
return 'video';
|
|
36
|
+
if (isVoiceContentType(contentType))
|
|
37
|
+
return 'voice';
|
|
38
|
+
return 'file';
|
|
39
|
+
}
|
|
40
|
+
/** 处理 `//` 开头的协议相对 URL(补 https:) */
|
|
41
|
+
function normalizeUrl(url) {
|
|
42
|
+
return url.startsWith('//') ? `https:${url}` : url;
|
|
43
|
+
}
|
|
44
|
+
/** 文件名净化:去路径、移除非法字符(保留中文等 Unicode 字符),防止路径穿越 */
|
|
45
|
+
function sanitizeFilename(name) {
|
|
46
|
+
const base = basename(name.replace(/\\/g, '/'));
|
|
47
|
+
// 仅替换文件系统非法字符(Windows 保留字符 + 控制字符),保留中文/空格等
|
|
48
|
+
// normalize NFC:统一 Unicode 规范化,避免 macOS(NFD) 与 Linux/Windows(NFC) 存储差异导致路径对不上
|
|
49
|
+
const safe = base
|
|
50
|
+
.replace(/[<>:"|?*\x00-\x1f]/g, '_')
|
|
51
|
+
.trim()
|
|
52
|
+
.normalize('NFC');
|
|
53
|
+
return safe || 'attachment';
|
|
54
|
+
}
|
|
55
|
+
/** 统一路径分隔符为 `/`(POSIX),Node fs 在 Windows 也接受正斜杠,保证注入路径跨平台一致 */
|
|
56
|
+
function toPosixPath(p) {
|
|
57
|
+
return p.split(sep).join('/');
|
|
58
|
+
}
|
|
59
|
+
/** 防重名:文件名 + 时间戳 + 随机数 */
|
|
60
|
+
function uniqueFilename(name) {
|
|
61
|
+
const base = sanitizeFilename(name);
|
|
62
|
+
const ext = extname(base);
|
|
63
|
+
const stem = basename(base, ext);
|
|
64
|
+
const rand = randomBytes(4).toString('hex');
|
|
65
|
+
return `${stem}_${Date.now()}_${rand}${ext}`;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* 按魔数(magic bytes)识别图片真实扩展名,无法识别返回 undefined。
|
|
69
|
+
*
|
|
70
|
+
* 纯函数、零 I/O:QQ 网关的 content_type 统一标 image/png 不可信,只有文件头
|
|
71
|
+
* 可靠。每个分支都带长度守卫,短于所需字节的 buffer 直接落到末尾 undefined。
|
|
72
|
+
*/
|
|
73
|
+
export function imageExtension(buf) {
|
|
74
|
+
if (buf.length >= 6) {
|
|
75
|
+
const head = buf.subarray(0, 6).toString('latin1');
|
|
76
|
+
if (head === 'GIF87a' || head === 'GIF89a')
|
|
77
|
+
return '.gif';
|
|
78
|
+
}
|
|
79
|
+
if (buf.length >= 8 && buf.subarray(0, 8).equals(Buffer.from('89504e470d0a1a0a', 'hex')))
|
|
80
|
+
return '.png';
|
|
81
|
+
if (buf.length >= 3 && buf[0] === 0xff && buf[1] === 0xd8 && buf[2] === 0xff)
|
|
82
|
+
return '.jpg';
|
|
83
|
+
if (buf.length >= 12
|
|
84
|
+
&& buf.subarray(0, 4).toString('latin1') === 'RIFF'
|
|
85
|
+
&& buf.subarray(8, 12).toString('latin1') === 'WEBP')
|
|
86
|
+
return '.webp';
|
|
87
|
+
if (buf.length >= 2 && buf[0] === 0x42 && buf[1] === 0x4d)
|
|
88
|
+
return '.bmp';
|
|
89
|
+
return undefined;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* 按图片真实格式修正路径扩展名,保留文件名主体(纯函数)。
|
|
93
|
+
* 未识别 / 已一致 / jpg≈jpeg 时原样返回,避免无意义改名。
|
|
94
|
+
*/
|
|
95
|
+
export function correctImageExt(path, buf) {
|
|
96
|
+
const realExt = imageExtension(buf);
|
|
97
|
+
const ext = extname(path);
|
|
98
|
+
const declaredExt = ext.toLowerCase();
|
|
99
|
+
if (!realExt || declaredExt === realExt || (realExt === '.jpg' && declaredExt === '.jpeg'))
|
|
100
|
+
return path;
|
|
101
|
+
return `${path.slice(0, path.length - ext.length)}${realExt}`;
|
|
102
|
+
}
|
|
103
|
+
/** 字节数格式化 */
|
|
104
|
+
function formatSize(bytes) {
|
|
105
|
+
if (bytes >= 1024 * 1024)
|
|
106
|
+
return `${(bytes / 1024 / 1024).toFixed(1)}MB`;
|
|
107
|
+
if (bytes >= 1024)
|
|
108
|
+
return `${(bytes / 1024).toFixed(1)}KB`;
|
|
109
|
+
return `${bytes}B`;
|
|
110
|
+
}
|
|
111
|
+
// ── SSRF 防护:阻断解析到私有/保留地址的下载 ──
|
|
112
|
+
const PRIVATE_RANGES = [
|
|
113
|
+
[0x0a000000n, 8], // 10.0.0.0/8
|
|
114
|
+
[0xac100000n, 12], // 172.16.0.0/12
|
|
115
|
+
[0xc0a80000n, 16], // 192.168.0.0/16
|
|
116
|
+
[0x7f000000n, 8], // 127.0.0.0/8
|
|
117
|
+
[0xa9fe0000n, 16], // 169.254.0.0/16
|
|
118
|
+
[0xe0000000n, 4], // 224.0.0.0/4 (multicast)
|
|
119
|
+
];
|
|
120
|
+
function ipToBigInt(ip) {
|
|
121
|
+
return ip.split('.').reduce((acc, octet) => (acc << 8n) | BigInt(Number(octet)), 0n);
|
|
122
|
+
}
|
|
123
|
+
function isPrivateIP(ip) {
|
|
124
|
+
const val = ipToBigInt(ip);
|
|
125
|
+
return PRIVATE_RANGES.some(([mask, prefix]) => (val >> (32n - BigInt(prefix))) === (mask >> (32n - BigInt(prefix))));
|
|
126
|
+
}
|
|
127
|
+
/** 解析 hostname 并阻断指向私有/内网地址的 URL(SSRF 防护) */
|
|
128
|
+
async function assertSafeHostname(hostname) {
|
|
129
|
+
const addresses = await dns.promises.resolve4(hostname).catch(() => []);
|
|
130
|
+
if (addresses.length === 0)
|
|
131
|
+
throw new Error(`DNS resolution failed: ${hostname}`);
|
|
132
|
+
for (const addr of addresses) {
|
|
133
|
+
if (isPrivateIP(addr))
|
|
134
|
+
throw new Error(`SSRF blocked: ${hostname} resolves to private IP ${addr}`);
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
/** 安全下载:仅 HTTPS + SSRF 防护 + 大小上限 + 超时,返回字节 Buffer(不落盘) */
|
|
138
|
+
async function download(url, maxBytes) {
|
|
139
|
+
const parsed = new URL(normalizeUrl(url));
|
|
140
|
+
if (parsed.protocol !== 'https:') {
|
|
141
|
+
throw new Error(`Only HTTPS allowed: ${parsed.protocol}`);
|
|
142
|
+
}
|
|
143
|
+
await assertSafeHostname(parsed.hostname);
|
|
144
|
+
const resp = await fetch(url, { signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS) });
|
|
145
|
+
if (!resp.ok)
|
|
146
|
+
throw new Error(`HTTP ${resp.status}`);
|
|
147
|
+
const buf = Buffer.from(await resp.arrayBuffer());
|
|
148
|
+
if (buf.length > maxBytes) {
|
|
149
|
+
throw new Error(`Download exceeds ${Math.floor(maxBytes / 1024 / 1024)}MB`);
|
|
150
|
+
}
|
|
151
|
+
return buf;
|
|
152
|
+
}
|
|
153
|
+
/**
|
|
154
|
+
* 下载消息中的富媒体附件(image/video/file)到本地
|
|
155
|
+
*
|
|
156
|
+
* 下载目录固定为 ~/.dsh/dsh-qqbot-plus/media,文件名用时间戳+随机数防重名。
|
|
157
|
+
* 下载失败不阻断(由调用方回退描述)。
|
|
158
|
+
*/
|
|
159
|
+
export async function downloadMediaAttachments(attachments, media, logger) {
|
|
160
|
+
if (!media.enabled)
|
|
161
|
+
return [];
|
|
162
|
+
const targets = (attachments ?? []).filter(a => classifyContentType(a.content_type) !== 'voice' && a.url);
|
|
163
|
+
if (targets.length === 0)
|
|
164
|
+
return [];
|
|
165
|
+
mkdirSync(MEDIA_ROOT, { recursive: true });
|
|
166
|
+
const maxBytes = (media.maxMB ?? DEFAULT_MAX_MB) * 1024 * 1024;
|
|
167
|
+
const results = [];
|
|
168
|
+
for (const att of targets) {
|
|
169
|
+
const contentType = classifyContentType(att.content_type);
|
|
170
|
+
const destPath = toPosixPath(join(MEDIA_ROOT, uniqueFilename(att.filename)));
|
|
171
|
+
if (att.size > maxBytes) {
|
|
172
|
+
logger.debug(`im-qqbot: skip download (${att.size}B too large): ${att.filename}`);
|
|
173
|
+
continue; // 超限不下载,由 buildDynamicCtx 回退为描述
|
|
174
|
+
}
|
|
175
|
+
let buf;
|
|
176
|
+
try {
|
|
177
|
+
buf = await download(att.url, maxBytes);
|
|
178
|
+
}
|
|
179
|
+
catch (err) {
|
|
180
|
+
logger.warn(`im-qqbot: download failed: ${att.filename} — ${err instanceof Error ? err.message : String(err)}`);
|
|
181
|
+
continue; // 下载失败不加入结果,由 buildDynamicCtx 回退为描述
|
|
182
|
+
}
|
|
183
|
+
// 图片按真实格式校正扩展名(QQ 的 content_type 不可信),落盘到最终路径
|
|
184
|
+
const localPath = contentType === 'image' ? toPosixPath(correctImageExt(destPath, buf)) : destPath;
|
|
185
|
+
writeFileSync(localPath, buf);
|
|
186
|
+
logger.debug(`im-qqbot: attachment downloaded: ${att.filename} (${formatSize(buf.length)}) → ${localPath}`);
|
|
187
|
+
results.push({ filename: att.filename, contentType, localPath });
|
|
188
|
+
}
|
|
189
|
+
return results;
|
|
190
|
+
}
|
|
191
|
+
//# sourceMappingURL=attachment.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../../src/transport/attachment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,wCAAwC;AACxC,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,eAAe;AACf,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAepC,6CAA6C;AAC7C,MAAM,UAAU,kBAAkB,CAAC,WAAoB;IACrD,OAAO,WAAW,KAAK,OAAO,IAAI,WAAW,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AAC/E,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,kBAAkB,CAAC,WAAoB;IACrD,OAAO,WAAW,KAAK,OAAO,IAAI,WAAW,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AAC/E,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,kBAAkB,CAAC,WAAoB;IACrD,OAAO,WAAW,KAAK,OAAO,IAAI,WAAW,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AAC/E,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,mBAAmB,CAAC,WAAoB;IACtD,IAAI,kBAAkB,CAAC,WAAW,CAAC;QAAE,OAAO,OAAO,CAAC;IACpD,IAAI,kBAAkB,CAAC,WAAW,CAAC;QAAE,OAAO,OAAO,CAAC;IACpD,IAAI,kBAAkB,CAAC,WAAW,CAAC;QAAE,OAAO,OAAO,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oCAAoC;AACpC,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACrD,CAAC;AAED,gDAAgD;AAChD,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAChD,4CAA4C;IAC5C,8EAA8E;IAC9E,MAAM,IAAI,GAAG,IAAI;SACd,OAAO,CAAC,qBAAqB,EAAE,GAAG,CAAC;SACnC,IAAI,EAAE;SACN,SAAS,CAAC,KAAK,CAAC,CAAC;IACpB,OAAO,IAAI,IAAI,YAAY,CAAC;AAC9B,CAAC;AAED,+DAA+D;AAC/D,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,0BAA0B;AAC1B,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;IAC5D,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACxG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAC5F,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE;WACf,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,MAAM;WAChD,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC;IACvE,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACzE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,GAAW;IACvD,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACtC,IAAI,CAAC,OAAO,IAAI,WAAW,KAAK,OAAO,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,WAAW,KAAK,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACxG,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;AAChE,CAAC;AAED,aAAa;AACb,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAK,IAAI,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,OAAO,GAAG,KAAK,GAAG,CAAC;AACrB,CAAC;AAED,gCAAgC;AAEhC,MAAM,cAAc,GAA6C;IAC/D,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,aAAa;IAC/B,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,gBAAgB;IACnC,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,iBAAiB;IACpC,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,cAAc;IAChC,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,iBAAiB;IACpC,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,0BAA0B;CAC7C,CAAC;AAEF,SAAS,UAAU,CAAC,EAAU;IAC5B,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,WAAW,CAAC,EAAU;IAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO,cAAc,CAAC,IAAI,CACxB,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CACzF,CAAC;AACJ,CAAC;AAED,6CAA6C;AAC7C,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IAChD,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACxE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;IAClF,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,WAAW,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,2BAA2B,IAAI,EAAE,CAAC,CAAC;IACrG,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,QAAgB;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE1C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACpF,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAErD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,IAAI,GAAG,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,WAAwC,EACxC,KAAkB,EAClB,MAAc;IAEd,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAE9B,MAAM,OAAO,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAC7C,mBAAmB,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC,GAAG,CACzD,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,cAAc,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IAE/D,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAA+B,CAAC;QACxF,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAE7E,IAAI,GAAG,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,4BAA4B,GAAG,CAAC,IAAI,iBAAiB,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClF,SAAS,CAAC,gCAAgC;QAC5C,CAAC;QAED,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,8BAA8B,GAAG,CAAC,QAAQ,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChH,SAAS,CAAC,oCAAoC;QAChD,CAAC;QAED,8CAA8C;QAC9C,MAAM,SAAS,GAAG,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnG,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,oCAAoC,GAAG,CAAC,QAAQ,KAAK,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC;QAE5G,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Markdown 文本切分器
|
|
3
|
+
*
|
|
4
|
+
* QQ 单条消息有字符数限制(约 5000),需要在合适边界切分,
|
|
5
|
+
* 并保持 GFM 表格、代码块的完整性。
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* 按换行边界切分 Markdown 文本
|
|
9
|
+
* - 不在代码块中间断开
|
|
10
|
+
* - 不在 GFM 表格中间断开
|
|
11
|
+
* - 优先在空行处断开
|
|
12
|
+
*/
|
|
13
|
+
export declare function chunkMarkdownText(text: string, limit: number): string[];
|
|
14
|
+
//# sourceMappingURL=chunker.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/transport/chunker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAoEvE"}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Markdown 文本切分器
|
|
3
|
+
*
|
|
4
|
+
* QQ 单条消息有字符数限制(约 5000),需要在合适边界切分,
|
|
5
|
+
* 并保持 GFM 表格、代码块的完整性。
|
|
6
|
+
*/
|
|
7
|
+
const CODE_FENCE_OPEN = /^```/;
|
|
8
|
+
const GFM_TABLE_LINE = /^\|.+\|$/;
|
|
9
|
+
/**
|
|
10
|
+
* 按换行边界切分 Markdown 文本
|
|
11
|
+
* - 不在代码块中间断开
|
|
12
|
+
* - 不在 GFM 表格中间断开
|
|
13
|
+
* - 优先在空行处断开
|
|
14
|
+
*/
|
|
15
|
+
export function chunkMarkdownText(text, limit) {
|
|
16
|
+
if (text.length <= limit)
|
|
17
|
+
return [text];
|
|
18
|
+
const lines = text.split('\n');
|
|
19
|
+
const chunks = [];
|
|
20
|
+
let current = '';
|
|
21
|
+
let inCodeBlock = false;
|
|
22
|
+
let tableBuffer = [];
|
|
23
|
+
const flushTable = () => {
|
|
24
|
+
if (tableBuffer.length === 0)
|
|
25
|
+
return;
|
|
26
|
+
const block = tableBuffer.join('\n');
|
|
27
|
+
tableBuffer = [];
|
|
28
|
+
if (!current) {
|
|
29
|
+
current = block;
|
|
30
|
+
return;
|
|
31
|
+
}
|
|
32
|
+
const candidate = `${current}\n${block}`;
|
|
33
|
+
if (candidate.length > limit) {
|
|
34
|
+
chunks.push(current);
|
|
35
|
+
current = block;
|
|
36
|
+
}
|
|
37
|
+
else {
|
|
38
|
+
current = candidate;
|
|
39
|
+
}
|
|
40
|
+
};
|
|
41
|
+
const appendLine = (line) => {
|
|
42
|
+
if (!current) {
|
|
43
|
+
current = line;
|
|
44
|
+
return;
|
|
45
|
+
}
|
|
46
|
+
const candidate = `${current}\n${line}`;
|
|
47
|
+
if (candidate.length > limit) {
|
|
48
|
+
chunks.push(current);
|
|
49
|
+
current = line;
|
|
50
|
+
}
|
|
51
|
+
else {
|
|
52
|
+
current = candidate;
|
|
53
|
+
}
|
|
54
|
+
};
|
|
55
|
+
for (const line of lines) {
|
|
56
|
+
if (CODE_FENCE_OPEN.test(line)) {
|
|
57
|
+
flushTable();
|
|
58
|
+
inCodeBlock = !inCodeBlock;
|
|
59
|
+
appendLine(line);
|
|
60
|
+
continue;
|
|
61
|
+
}
|
|
62
|
+
if (inCodeBlock) {
|
|
63
|
+
appendLine(line);
|
|
64
|
+
continue;
|
|
65
|
+
}
|
|
66
|
+
if (GFM_TABLE_LINE.test(line)) {
|
|
67
|
+
tableBuffer.push(line);
|
|
68
|
+
continue;
|
|
69
|
+
}
|
|
70
|
+
flushTable();
|
|
71
|
+
appendLine(line);
|
|
72
|
+
}
|
|
73
|
+
flushTable();
|
|
74
|
+
if (current)
|
|
75
|
+
chunks.push(current);
|
|
76
|
+
return chunks.length > 0 ? chunks : [text];
|
|
77
|
+
}
|
|
78
|
+
//# sourceMappingURL=chunker.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"chunker.js","sourceRoot":"","sources":["../../src/transport/chunker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,cAAc,GAAG,UAAU,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAa;IAC3D,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,WAAW,GAAa,EAAE,CAAC;IAE/B,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACrC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,WAAW,GAAG,EAAE,CAAC;QAEjB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,KAAK,CAAC;YAChB,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,OAAO,KAAK,KAAK,EAAE,CAAC;QACzC,IAAI,SAAS,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAQ,EAAE;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC;YACf,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,GAAG,OAAO,KAAK,IAAI,EAAE,CAAC;QACxC,IAAI,SAAS,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,UAAU,EAAE,CAAC;YACb,WAAW,GAAG,CAAC,WAAW,CAAC;YAC3B,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QAED,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QAED,UAAU,EAAE,CAAC;QACb,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,UAAU,EAAE,CAAC;IACb,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { ImQQBotConfig } from '../config.ts';
|
|
2
|
+
import type { SessionRecord } from '../session/index.ts';
|
|
3
|
+
import type { Logger } from '../types.ts';
|
|
4
|
+
import { type MediaSenderLike } from '../media/send-media.ts';
|
|
5
|
+
import type { PresentedFileRef } from './events.ts';
|
|
6
|
+
import type { QQBotSender } from './outbound-buffer.ts';
|
|
7
|
+
/** 交付物投递器(outbound 路由只依赖此接口,便于测试注入) */
|
|
8
|
+
export interface DeliverablesDelivererLike {
|
|
9
|
+
deliver(record: SessionRecord, files: PresentedFileRef[]): Promise<void>;
|
|
10
|
+
}
|
|
11
|
+
export declare class DeliverablesDeliverer implements DeliverablesDelivererLike {
|
|
12
|
+
private readonly sender;
|
|
13
|
+
private readonly mediaBot;
|
|
14
|
+
private readonly config;
|
|
15
|
+
private readonly logger;
|
|
16
|
+
constructor(sender: QQBotSender, mediaBot: MediaSenderLike, config: ImQQBotConfig, logger: Logger);
|
|
17
|
+
/** 轮末投递一批声明文件:逐个发送,未送达的聚合为一条文字提示 */
|
|
18
|
+
deliver(record: SessionRecord, files: PresentedFileRef[]): Promise<void>;
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=deliverables.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"deliverables.d.ts","sourceRoot":"","sources":["../../src/transport/deliverables.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAiD,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,uCAAuC;AACvC,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAED,qBAAa,qBAAsB,YAAW,yBAAyB;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAG9B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM;IAQhB,oCAAoC;IACvB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA+CtF"}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 交付物投递 — present 声明的文件在轮末发送到当前 QQ 会话
|
|
3
|
+
*
|
|
4
|
+
* 宿主契约:`deliverables/presented` 事件先于 turn/end 到达;文件按引用交付
|
|
5
|
+
* (不复制内容),读取发生在投递时刻;外层轮次失败不撤销已完成的声明。
|
|
6
|
+
* 每个文件独立投递,失败降级为文字提示,不阻断其余文件。
|
|
7
|
+
*/
|
|
8
|
+
import { basename, isAbsolute, resolve } from 'node:path';
|
|
9
|
+
import { isPathAllowed, resolveAgentCwd, sendMediaFile } from "../media/send-media.js";
|
|
10
|
+
import { chunkMarkdownText } from "./chunker.js";
|
|
11
|
+
import { notifySendFailure } from "./notify.js";
|
|
12
|
+
export class DeliverablesDeliverer {
|
|
13
|
+
sender;
|
|
14
|
+
mediaBot;
|
|
15
|
+
config;
|
|
16
|
+
logger;
|
|
17
|
+
constructor(sender, mediaBot, config, logger) {
|
|
18
|
+
this.sender = sender;
|
|
19
|
+
this.mediaBot = mediaBot;
|
|
20
|
+
this.config = config;
|
|
21
|
+
this.logger = logger;
|
|
22
|
+
}
|
|
23
|
+
/** 轮末投递一批声明文件:逐个发送,未送达的聚合为一条文字提示 */
|
|
24
|
+
async deliver(record, files) {
|
|
25
|
+
const limit = Math.max(1, this.config.sendFile?.maxFiles ?? 4);
|
|
26
|
+
const cwd = resolveAgentCwd(this.config.cwd);
|
|
27
|
+
const missed = [];
|
|
28
|
+
let sent = 0;
|
|
29
|
+
for (const [index, file] of files.entries()) {
|
|
30
|
+
// 新声明记录绝对路径;历史相对路径按 agent 工作目录(workspace)兜底解析
|
|
31
|
+
const absPath = isAbsolute(file.path) ? file.path : resolve(cwd, file.path);
|
|
32
|
+
const display = basename(absPath);
|
|
33
|
+
if (index >= limit) {
|
|
34
|
+
missed.push(`${display}(超出单轮投递上限,未发送)`);
|
|
35
|
+
continue;
|
|
36
|
+
}
|
|
37
|
+
if (!isPathAllowed(absPath, this.config.sendFile, cwd)) {
|
|
38
|
+
missed.push(`${display}(路径不在允许范围)`);
|
|
39
|
+
continue;
|
|
40
|
+
}
|
|
41
|
+
const result = await sendMediaFile(this.mediaBot, record.replyTarget, absPath);
|
|
42
|
+
if (result.outcome === 'sent') {
|
|
43
|
+
sent++;
|
|
44
|
+
this.logger.info(`im-qqbot: 交付物已发送 ${display} (${result.size} bytes) → `
|
|
45
|
+
+ `${record.replyTarget.scope}:${record.replyTarget.targetId}`);
|
|
46
|
+
}
|
|
47
|
+
else if (result.outcome === 'failed') {
|
|
48
|
+
this.logger.warn(`im-qqbot: 交付物发送失败 ${display}: ${result.error}`);
|
|
49
|
+
notifySendFailure(record, result.error ?? '交付物发送失败', { kind: 'file', name: display, dedup: display });
|
|
50
|
+
missed.push(display);
|
|
51
|
+
}
|
|
52
|
+
else {
|
|
53
|
+
missed.push(display);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
if (missed.length > 0) {
|
|
57
|
+
const text = ['📎 已生成文件(未能直接发送):', ...missed.map((name) => `- ${name}`)].join('\n');
|
|
58
|
+
for (const chunk of chunkMarkdownText(text, this.config.textChunkLimit)) {
|
|
59
|
+
try {
|
|
60
|
+
await this.sender.sendMarkdown(record.replyTarget, chunk);
|
|
61
|
+
}
|
|
62
|
+
catch (err) {
|
|
63
|
+
this.logger.error(`im-qqbot: deliverables notice failed: ${err instanceof Error ? err.message : String(err)}`);
|
|
64
|
+
// 连「文件没发出去」这句提示都发不出去也得让模型知道,否则它以为已经交代过了
|
|
65
|
+
notifySendFailure(record, err, { kind: 'notice', dedup: 'deliverables-notice' });
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
this.logger.debug(`im-qqbot: deliverables delivered sent=${sent} missed=${missed.length}`);
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
//# sourceMappingURL=deliverables.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"deliverables.js","sourceRoot":"","sources":["../../src/transport/deliverables.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 出站事件解析 — 将 dsh session/event 归一化为强类型
|
|
3
|
+
*
|
|
4
|
+
* 原始事件(ctx.on('session/event') 回调参数)是弱类型:
|
|
5
|
+
* { type: string, data: Record<string, unknown> }
|
|
6
|
+
* 这里把可识别的事件解析为 discriminated union,未知类型或字段缺失返回 undefined。
|
|
7
|
+
*/
|
|
8
|
+
/** 原始 dsh 事件(弱类型,来自 ctx.on('session/event')) */
|
|
9
|
+
export interface RawSessionEvent {
|
|
10
|
+
type: string;
|
|
11
|
+
data: Record<string, unknown>;
|
|
12
|
+
}
|
|
13
|
+
/** turn/end 事件的 reason 结构(兼容 error/failure/顶层 message 三种形态) */
|
|
14
|
+
export interface TurnEndReason {
|
|
15
|
+
kind?: string;
|
|
16
|
+
error?: {
|
|
17
|
+
message?: string;
|
|
18
|
+
code?: string;
|
|
19
|
+
};
|
|
20
|
+
failure?: {
|
|
21
|
+
message?: string;
|
|
22
|
+
code?: string;
|
|
23
|
+
};
|
|
24
|
+
message?: string;
|
|
25
|
+
code?: string;
|
|
26
|
+
}
|
|
27
|
+
/** assistant/chunk 事件(仅保留 text-delta) */
|
|
28
|
+
export interface ChunkEvent {
|
|
29
|
+
type: 'assistant/chunk';
|
|
30
|
+
text: string;
|
|
31
|
+
}
|
|
32
|
+
/** assistant/message 事件 */
|
|
33
|
+
export interface MessageEvent {
|
|
34
|
+
type: 'assistant/message';
|
|
35
|
+
content: Array<{
|
|
36
|
+
type: string;
|
|
37
|
+
text?: string;
|
|
38
|
+
}>;
|
|
39
|
+
}
|
|
40
|
+
/** tool/call 事件 */
|
|
41
|
+
export interface ToolCallEvent {
|
|
42
|
+
type: 'tool/call';
|
|
43
|
+
callId: string;
|
|
44
|
+
name: string;
|
|
45
|
+
arguments: string;
|
|
46
|
+
}
|
|
47
|
+
/** tool/result 事件 */
|
|
48
|
+
export interface ToolResultEvent {
|
|
49
|
+
type: 'tool/result';
|
|
50
|
+
callId: string;
|
|
51
|
+
error?: {
|
|
52
|
+
name: string;
|
|
53
|
+
code: string;
|
|
54
|
+
};
|
|
55
|
+
/** 原始 data 透传给 presenter 做结构化展示 */
|
|
56
|
+
raw: Record<string, unknown>;
|
|
57
|
+
}
|
|
58
|
+
/** turn/end 事件 */
|
|
59
|
+
export interface TurnEndEvent {
|
|
60
|
+
type: 'turn/end';
|
|
61
|
+
reason: TurnEndReason;
|
|
62
|
+
}
|
|
63
|
+
/** present 工具声明的一个交付文件 */
|
|
64
|
+
export interface PresentedFileRef {
|
|
65
|
+
/** 绝对路径,或相对 Session 工作目录的路径(仅历史声明) */
|
|
66
|
+
path: string;
|
|
67
|
+
/** 模型提供的可选说明 */
|
|
68
|
+
description?: string;
|
|
69
|
+
}
|
|
70
|
+
/** deliverables/presented 事件(present 声明的交付文件,含嵌套调用) */
|
|
71
|
+
export interface DeliverablesPresentedEvent {
|
|
72
|
+
type: 'deliverables/presented';
|
|
73
|
+
turn: number;
|
|
74
|
+
callId: string;
|
|
75
|
+
files: PresentedFileRef[];
|
|
76
|
+
}
|
|
77
|
+
/** 出站事件联合类型 */
|
|
78
|
+
export type OutboundEvent = ChunkEvent | MessageEvent | ToolCallEvent | ToolResultEvent | TurnEndEvent | DeliverablesPresentedEvent;
|
|
79
|
+
/**
|
|
80
|
+
* 解析原始事件为强类型
|
|
81
|
+
*
|
|
82
|
+
* 未知类型或缺失关键字段时返回 undefined,由调用方直接跳过。
|
|
83
|
+
*/
|
|
84
|
+
export declare function parseEvent(raw: RawSessionEvent): OutboundEvent | undefined;
|
|
85
|
+
/**
|
|
86
|
+
* 从 turn/end reason 提取错误信息
|
|
87
|
+
*
|
|
88
|
+
* 兼容三种形态:error(新格式)、failure(旧格式)、顶层 message/code(最旧格式)。
|
|
89
|
+
*/
|
|
90
|
+
export declare function extractTurnError(reason: TurnEndReason): {
|
|
91
|
+
code: string;
|
|
92
|
+
message: string;
|
|
93
|
+
} | undefined;
|
|
94
|
+
/**
|
|
95
|
+
* 归一化后的流式增量(`agent/assistant-stream` 瞬态帧,chunk 不进 session log)。
|
|
96
|
+
*/
|
|
97
|
+
export type StreamDelta = {
|
|
98
|
+
kind: 'attempt-start';
|
|
99
|
+
attemptId: string;
|
|
100
|
+
} | {
|
|
101
|
+
kind: 'text-delta';
|
|
102
|
+
attemptId: string;
|
|
103
|
+
text: string;
|
|
104
|
+
};
|
|
105
|
+
/**
|
|
106
|
+
* 解析 `agent/assistant-stream` 的 payload(对齐 @deepseek-ai/dsh-agent 的
|
|
107
|
+
* AssistantStreamFrame 最小契约,避免硬依赖)。
|
|
108
|
+
*
|
|
109
|
+
* 只归一化两类帧:start(新 attempt)与 chunk 的 text-delta(文本增量)。
|
|
110
|
+
* reasoning-delta / tool-call-delta 不进用户消息;end 帧不处理——收尾由 durable
|
|
111
|
+
* `assistant/message` / `turn/end` 事件负责。未知形态返回 undefined。
|
|
112
|
+
*/
|
|
113
|
+
export declare function parseStreamFrame(raw: unknown): {
|
|
114
|
+
agentId: string;
|
|
115
|
+
delta: StreamDelta;
|
|
116
|
+
} | undefined;
|
|
117
|
+
//# sourceMappingURL=events.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/transport/events.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 出站事件解析 — 将 dsh session/event 归一化为强类型
|
|
3
|
+
*
|
|
4
|
+
* 原始事件(ctx.on('session/event') 回调参数)是弱类型:
|
|
5
|
+
* { type: string, data: Record<string, unknown> }
|
|
6
|
+
* 这里把可识别的事件解析为 discriminated union,未知类型或字段缺失返回 undefined。
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* 解析原始事件为强类型
|
|
10
|
+
*
|
|
11
|
+
* 未知类型或缺失关键字段时返回 undefined,由调用方直接跳过。
|
|
12
|
+
*/
|
|
13
|
+
export function parseEvent(raw) {
|
|
14
|
+
switch (raw.type) {
|
|
15
|
+
case 'assistant/chunk': {
|
|
16
|
+
const chunk = raw.data.chunk;
|
|
17
|
+
if (chunk === undefined || chunk.type !== 'text-delta' || !chunk.text)
|
|
18
|
+
return undefined;
|
|
19
|
+
return { type: 'assistant/chunk', text: chunk.text };
|
|
20
|
+
}
|
|
21
|
+
case 'assistant/message': {
|
|
22
|
+
const message = raw.data.message;
|
|
23
|
+
if (message === undefined || !Array.isArray(message.content))
|
|
24
|
+
return undefined;
|
|
25
|
+
return { type: 'assistant/message', content: message.content };
|
|
26
|
+
}
|
|
27
|
+
case 'tool/call': {
|
|
28
|
+
const data = raw.data;
|
|
29
|
+
if (!data.callId || !data.name)
|
|
30
|
+
return undefined;
|
|
31
|
+
return { type: 'tool/call', callId: data.callId, name: data.name, arguments: data.arguments ?? '' };
|
|
32
|
+
}
|
|
33
|
+
case 'tool/result': {
|
|
34
|
+
const data = raw.data;
|
|
35
|
+
const callId = data.message?.source?.callId;
|
|
36
|
+
if (!callId)
|
|
37
|
+
return undefined;
|
|
38
|
+
return { type: 'tool/result', callId, error: data.error, raw: raw.data };
|
|
39
|
+
}
|
|
40
|
+
case 'turn/end': {
|
|
41
|
+
const reason = raw.data.reason ?? {};
|
|
42
|
+
return { type: 'turn/end', reason };
|
|
43
|
+
}
|
|
44
|
+
case 'deliverables/presented': {
|
|
45
|
+
const data = raw.data;
|
|
46
|
+
if (typeof data.turn !== 'number' || typeof data.callId !== 'string' || !data.callId)
|
|
47
|
+
return undefined;
|
|
48
|
+
if (!Array.isArray(data.files) || data.files.length === 0)
|
|
49
|
+
return undefined;
|
|
50
|
+
const files = [];
|
|
51
|
+
for (const file of data.files) {
|
|
52
|
+
if (file === null || typeof file !== 'object' || Array.isArray(file))
|
|
53
|
+
return undefined;
|
|
54
|
+
const { path, description } = file;
|
|
55
|
+
if (typeof path !== 'string' || !path)
|
|
56
|
+
return undefined;
|
|
57
|
+
if (description !== undefined && typeof description !== 'string')
|
|
58
|
+
return undefined;
|
|
59
|
+
files.push(description === undefined ? { path } : { path, description });
|
|
60
|
+
}
|
|
61
|
+
return { type: 'deliverables/presented', turn: data.turn, callId: data.callId, files };
|
|
62
|
+
}
|
|
63
|
+
default:
|
|
64
|
+
return undefined;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* 从 turn/end reason 提取错误信息
|
|
69
|
+
*
|
|
70
|
+
* 兼容三种形态:error(新格式)、failure(旧格式)、顶层 message/code(最旧格式)。
|
|
71
|
+
*/
|
|
72
|
+
export function extractTurnError(reason) {
|
|
73
|
+
if (reason.kind !== 'error')
|
|
74
|
+
return undefined;
|
|
75
|
+
const detail = reason.error ?? reason.failure;
|
|
76
|
+
return {
|
|
77
|
+
code: detail?.code ?? reason.code ?? 'UNKNOWN',
|
|
78
|
+
message: detail?.message ?? reason.message ?? 'unknown error',
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* 解析 `agent/assistant-stream` 的 payload(对齐 @deepseek-ai/dsh-agent 的
|
|
83
|
+
* AssistantStreamFrame 最小契约,避免硬依赖)。
|
|
84
|
+
*
|
|
85
|
+
* 只归一化两类帧:start(新 attempt)与 chunk 的 text-delta(文本增量)。
|
|
86
|
+
* reasoning-delta / tool-call-delta 不进用户消息;end 帧不处理——收尾由 durable
|
|
87
|
+
* `assistant/message` / `turn/end` 事件负责。未知形态返回 undefined。
|
|
88
|
+
*/
|
|
89
|
+
export function parseStreamFrame(raw) {
|
|
90
|
+
if (raw === null || typeof raw !== 'object')
|
|
91
|
+
return undefined;
|
|
92
|
+
const agentId = raw.agent?.id;
|
|
93
|
+
if (typeof agentId !== 'string' || !agentId)
|
|
94
|
+
return undefined;
|
|
95
|
+
const frame = raw.frame;
|
|
96
|
+
if (frame === null || typeof frame !== 'object')
|
|
97
|
+
return undefined;
|
|
98
|
+
const { type, attemptId } = frame;
|
|
99
|
+
if (typeof attemptId !== 'string' || !attemptId)
|
|
100
|
+
return undefined;
|
|
101
|
+
if (type === 'start') {
|
|
102
|
+
return { agentId, delta: { kind: 'attempt-start', attemptId } };
|
|
103
|
+
}
|
|
104
|
+
if (type === 'chunk') {
|
|
105
|
+
const chunk = frame.chunk;
|
|
106
|
+
if (chunk?.type !== 'text-delta' || typeof chunk.text !== 'string' || !chunk.text)
|
|
107
|
+
return undefined;
|
|
108
|
+
return { agentId, delta: { kind: 'text-delta', attemptId, text: chunk.text } };
|
|
109
|
+
}
|
|
110
|
+
return undefined;
|
|
111
|
+
}
|
|
112
|
+
//# sourceMappingURL=events.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/transport/events.ts"],"names":[],"mappings":"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"}
|