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.
Files changed (301) hide show
  1. package/CHANGELOG.md +188 -0
  2. package/CHANGELOG_EN.md +188 -0
  3. package/LICENSE +21 -0
  4. package/README.md +281 -2
  5. package/README_EN.md +248 -0
  6. package/cordis.patch.yml +163 -0
  7. package/cordis.yml +112 -0
  8. package/install.sh +108 -0
  9. package/lib/alarms.js +371 -0
  10. package/lib/client.js +2411 -0
  11. package/lib/commands/auth.d.ts +18 -0
  12. package/lib/commands/auth.d.ts.map +1 -0
  13. package/lib/commands/auth.js +15 -0
  14. package/lib/commands/auth.js.map +1 -0
  15. package/lib/commands/help.d.ts +10 -0
  16. package/lib/commands/help.d.ts.map +1 -0
  17. package/lib/commands/help.js +39 -0
  18. package/lib/commands/help.js.map +1 -0
  19. package/lib/commands/index.d.ts +15 -0
  20. package/lib/commands/index.d.ts.map +1 -0
  21. package/lib/commands/index.js +30 -0
  22. package/lib/commands/index.js.map +1 -0
  23. package/lib/commands/misc.d.ts +21 -0
  24. package/lib/commands/misc.d.ts.map +1 -0
  25. package/lib/commands/misc.js +93 -0
  26. package/lib/commands/misc.js.map +1 -0
  27. package/lib/commands/model.d.ts +6 -0
  28. package/lib/commands/model.d.ts.map +1 -0
  29. package/lib/commands/model.js +63 -0
  30. package/lib/commands/model.js.map +1 -0
  31. package/lib/commands/new.js +17 -0
  32. package/lib/commands/preset.d.ts +8 -0
  33. package/lib/commands/preset.d.ts.map +1 -0
  34. package/lib/commands/preset.js +56 -0
  35. package/lib/commands/preset.js.map +1 -0
  36. package/lib/commands/session.d.ts +14 -0
  37. package/lib/commands/session.d.ts.map +1 -0
  38. package/lib/commands/session.js +34 -0
  39. package/lib/commands/session.js.map +1 -0
  40. package/lib/commands/status.d.ts +7 -0
  41. package/lib/commands/status.d.ts.map +1 -0
  42. package/lib/commands/status.js +26 -0
  43. package/lib/commands/status.js.map +1 -0
  44. package/lib/commands/types.d.ts +21 -0
  45. package/lib/commands/types.d.ts.map +1 -0
  46. package/lib/commands/types.js +2 -0
  47. package/lib/commands/types.js.map +1 -0
  48. package/lib/config.d.ts +95 -0
  49. package/lib/config.js +88 -0
  50. package/lib/features/answer-parser.d.ts +9 -0
  51. package/lib/features/answer-parser.d.ts.map +1 -0
  52. package/lib/features/answer-parser.js +23 -0
  53. package/lib/features/answer-parser.js.map +1 -0
  54. package/lib/features/approval-channel.d.ts +94 -0
  55. package/lib/features/approval-channel.d.ts.map +1 -0
  56. package/lib/features/approval-channel.js +158 -0
  57. package/lib/features/approval-channel.js.map +1 -0
  58. package/lib/features/approval-renderer.d.ts +18 -0
  59. package/lib/features/approval-renderer.d.ts.map +1 -0
  60. package/lib/features/approval-renderer.js +52 -0
  61. package/lib/features/approval-renderer.js.map +1 -0
  62. package/lib/features/button-utils.d.ts +34 -0
  63. package/lib/features/button-utils.d.ts.map +1 -0
  64. package/lib/features/button-utils.js +27 -0
  65. package/lib/features/button-utils.js.map +1 -0
  66. package/lib/features/history-store.d.ts +8 -0
  67. package/lib/features/history-store.d.ts.map +1 -0
  68. package/lib/features/history-store.js +23 -0
  69. package/lib/features/history-store.js.map +1 -0
  70. package/lib/features/question-channel.d.ts +96 -0
  71. package/lib/features/question-channel.d.ts.map +1 -0
  72. package/lib/features/question-channel.js +234 -0
  73. package/lib/features/question-channel.js.map +1 -0
  74. package/lib/features/question-renderer.d.ts +20 -0
  75. package/lib/features/question-renderer.d.ts.map +1 -0
  76. package/lib/features/question-renderer.js +70 -0
  77. package/lib/features/question-renderer.js.map +1 -0
  78. package/lib/fishcheck/measure.js +230 -0
  79. package/lib/fishcheck/rules.js +99 -0
  80. package/lib/fishmeme/plugin.js +605 -0
  81. package/lib/fishmeme/routes.js +141 -0
  82. package/lib/fishmemory/plugin.js +1052 -0
  83. package/lib/gateway/bootstrap.d.ts +12 -0
  84. package/lib/gateway/bootstrap.d.ts.map +1 -0
  85. package/lib/gateway/bootstrap.js +200 -0
  86. package/lib/gateway/bootstrap.js.map +1 -0
  87. package/lib/gateway/index.d.ts +3 -0
  88. package/lib/gateway/index.d.ts.map +1 -0
  89. package/lib/gateway/index.js +3 -0
  90. package/lib/gateway/index.js.map +1 -0
  91. package/lib/gateway/middleware-setup.d.ts +12 -0
  92. package/lib/gateway/middleware-setup.d.ts.map +1 -0
  93. package/lib/gateway/middleware-setup.js +82 -0
  94. package/lib/gateway/middleware-setup.js.map +1 -0
  95. package/lib/host/adapter.d.ts +48 -0
  96. package/lib/host/adapter.d.ts.map +1 -0
  97. package/lib/host/adapter.js +127 -0
  98. package/lib/host/adapter.js.map +1 -0
  99. package/lib/humanlike/ENV_PROMPT.md +28 -0
  100. package/lib/humanlike/affinity.js +316 -0
  101. package/lib/humanlike/learn.js +343 -0
  102. package/lib/humanlike/life.js +899 -0
  103. package/lib/humanlike/mind.js +323 -0
  104. package/lib/humanlike/plugin.js +587 -0
  105. package/lib/humanlike/reach.js +119 -0
  106. package/lib/humanlike/real.js +276 -0
  107. package/lib/humanlike/rules.js +67 -0
  108. package/lib/humanlike/settings-api.js +159 -0
  109. package/lib/humanlike/settings.js +370 -0
  110. package/lib/humanlike/together.js +251 -0
  111. package/lib/identity/paths.js +27 -0
  112. package/lib/identity/persona.js +75 -0
  113. package/lib/identity/portrait.js +25 -0
  114. package/lib/identity/runtime.js +78 -0
  115. package/lib/index.d.ts +15 -0
  116. package/lib/index.js +117 -0
  117. package/lib/media/draft-tool.js +442 -0
  118. package/lib/media/draft-tool.js.bak-to-182027 +389 -0
  119. package/lib/media/media-cleaner.d.ts +19 -0
  120. package/lib/media/media-cleaner.d.ts.map +1 -0
  121. package/lib/media/media-cleaner.js +81 -0
  122. package/lib/media/media-cleaner.js.map +1 -0
  123. package/lib/media/say-tool.js +72 -0
  124. package/lib/media/send-file-tool.d.ts +12 -0
  125. package/lib/media/send-file-tool.d.ts.map +1 -0
  126. package/lib/media/send-file-tool.js +122 -0
  127. package/lib/media/send-file-tool.js.map +1 -0
  128. package/lib/media/send-media.d.ts +61 -0
  129. package/lib/media/send-media.d.ts.map +1 -0
  130. package/lib/media/send-media.js +104 -0
  131. package/lib/media/send-media.js.map +1 -0
  132. package/lib/media/vision-tool.d.ts +22 -0
  133. package/lib/media/vision-tool.d.ts.map +1 -0
  134. package/lib/media/vision-tool.js +288 -0
  135. package/lib/media/vision-tool.js.map +1 -0
  136. package/lib/middleware/attachment.d.ts +11 -0
  137. package/lib/middleware/attachment.d.ts.map +1 -0
  138. package/lib/middleware/attachment.js +30 -0
  139. package/lib/middleware/attachment.js.map +1 -0
  140. package/lib/middleware/question-answer.d.ts +10 -0
  141. package/lib/middleware/question-answer.d.ts.map +1 -0
  142. package/lib/middleware/question-answer.js +19 -0
  143. package/lib/middleware/question-answer.js.map +1 -0
  144. package/lib/model/index.d.ts +10 -0
  145. package/lib/model/index.d.ts.map +1 -0
  146. package/lib/model/index.js +9 -0
  147. package/lib/model/index.js.map +1 -0
  148. package/lib/model/model-resolver.d.ts +102 -0
  149. package/lib/model/model-resolver.d.ts.map +1 -0
  150. package/lib/model/model-resolver.js +206 -0
  151. package/lib/model/model-resolver.js.map +1 -0
  152. package/lib/model/prefs-store.d.ts +50 -0
  153. package/lib/model/prefs-store.d.ts.map +1 -0
  154. package/lib/model/prefs-store.js +215 -0
  155. package/lib/model/prefs-store.js.map +1 -0
  156. package/lib/model/settings-reader.d.ts +19 -0
  157. package/lib/model/settings-reader.d.ts.map +1 -0
  158. package/lib/model/settings-reader.js +76 -0
  159. package/lib/model/settings-reader.js.map +1 -0
  160. package/lib/model/types.d.ts +15 -0
  161. package/lib/model/types.d.ts.map +1 -0
  162. package/lib/model/types.js +5 -0
  163. package/lib/model/types.js.map +1 -0
  164. package/lib/resume-check.js +122 -0
  165. package/lib/resume-tool.js +29 -0
  166. package/lib/rules.js +57 -0
  167. package/lib/session/idle-evictor.d.ts +18 -0
  168. package/lib/session/idle-evictor.d.ts.map +1 -0
  169. package/lib/session/idle-evictor.js +31 -0
  170. package/lib/session/idle-evictor.js.map +1 -0
  171. package/lib/session/index.d.ts +9 -0
  172. package/lib/session/index.d.ts.map +1 -0
  173. package/lib/session/index.js +8 -0
  174. package/lib/session/index.js.map +1 -0
  175. package/lib/session/pick-agent.js +116 -0
  176. package/lib/session/session-id.d.ts +5 -0
  177. package/lib/session/session-id.d.ts.map +1 -0
  178. package/lib/session/session-id.js +15 -0
  179. package/lib/session/session-id.js.map +1 -0
  180. package/lib/session/session-manager.d.ts +138 -0
  181. package/lib/session/session-manager.d.ts.map +1 -0
  182. package/lib/session/session-manager.js +1157 -0
  183. package/lib/session/session-manager.js.bak-target +1081 -0
  184. package/lib/session/session-manager.js.bak-title-20261118 +1119 -0
  185. package/lib/session/session-manager.js.map +1 -0
  186. package/lib/session/types.d.ts +162 -0
  187. package/lib/session/types.d.ts.map +1 -0
  188. package/lib/session/types.js +2 -0
  189. package/lib/session/types.js.map +1 -0
  190. package/lib/setup/bind-routes.d.ts +78 -0
  191. package/lib/setup/bind-routes.d.ts.map +1 -0
  192. package/lib/setup/bind-routes.js +588 -0
  193. package/lib/setup/bind-routes.js.bak-join-163944 +761 -0
  194. package/lib/setup/bind-routes.js.map +1 -0
  195. package/lib/setup/binding-service.d.ts +86 -0
  196. package/lib/setup/binding-service.d.ts.map +1 -0
  197. package/lib/setup/binding-service.js +175 -0
  198. package/lib/setup/binding-service.js.map +1 -0
  199. package/lib/setup/index.d.ts +50 -0
  200. package/lib/setup/index.d.ts.map +1 -0
  201. package/lib/setup/index.js +163 -0
  202. package/lib/setup/index.js.map +1 -0
  203. package/lib/setup/persist.d.ts +42 -0
  204. package/lib/setup/persist.d.ts.map +1 -0
  205. package/lib/setup/persist.js +344 -0
  206. package/lib/setup/persist.js.map +1 -0
  207. package/lib/setup/presenters.d.ts +40 -0
  208. package/lib/setup/presenters.d.ts.map +1 -0
  209. package/lib/setup/presenters.js +84 -0
  210. package/lib/setup/presenters.js.map +1 -0
  211. package/lib/setup/qr-svg.d.ts +9 -0
  212. package/lib/setup/qr-svg.d.ts.map +1 -0
  213. package/lib/setup/qr-svg.js +33 -0
  214. package/lib/setup/qr-svg.js.map +1 -0
  215. package/lib/shared/bind-protocol.d.ts +42 -0
  216. package/lib/shared/bind-protocol.d.ts.map +1 -0
  217. package/lib/shared/bind-protocol.js +33 -0
  218. package/lib/shared/bind-protocol.js.map +1 -0
  219. package/lib/shared/dirs.d.ts +10 -0
  220. package/lib/shared/dirs.d.ts.map +1 -0
  221. package/lib/shared/dirs.js +20 -0
  222. package/lib/shared/dirs.js.map +1 -0
  223. package/lib/shared/http-body.js +43 -0
  224. package/lib/shared/index.d.ts +8 -0
  225. package/lib/shared/index.d.ts.map +1 -0
  226. package/lib/shared/index.js +8 -0
  227. package/lib/shared/index.js.map +1 -0
  228. package/lib/shared/json-file.js +34 -0
  229. package/lib/shared/orders.js +26 -0
  230. package/lib/shared/scope.d.ts +14 -0
  231. package/lib/shared/scope.d.ts.map +1 -0
  232. package/lib/shared/scope.js +12 -0
  233. package/lib/shared/scope.js.map +1 -0
  234. package/lib/shared/send-helper.d.ts +11 -0
  235. package/lib/shared/send-helper.d.ts.map +1 -0
  236. package/lib/shared/send-helper.js +13 -0
  237. package/lib/shared/send-helper.js.map +1 -0
  238. package/lib/shared/utils.d.ts +31 -0
  239. package/lib/shared/utils.d.ts.map +1 -0
  240. package/lib/shared/utils.js +228 -0
  241. package/lib/shared/utils.js.map +1 -0
  242. package/lib/tool-guard.js +74 -0
  243. package/lib/transport/attachment.d.ts +41 -0
  244. package/lib/transport/attachment.d.ts.map +1 -0
  245. package/lib/transport/attachment.js +191 -0
  246. package/lib/transport/attachment.js.map +1 -0
  247. package/lib/transport/chunker.d.ts +14 -0
  248. package/lib/transport/chunker.d.ts.map +1 -0
  249. package/lib/transport/chunker.js +78 -0
  250. package/lib/transport/chunker.js.map +1 -0
  251. package/lib/transport/deliverables.d.ts +20 -0
  252. package/lib/transport/deliverables.d.ts.map +1 -0
  253. package/lib/transport/deliverables.js +72 -0
  254. package/lib/transport/deliverables.js.map +1 -0
  255. package/lib/transport/events.d.ts +117 -0
  256. package/lib/transport/events.d.ts.map +1 -0
  257. package/lib/transport/events.js +112 -0
  258. package/lib/transport/events.js.map +1 -0
  259. package/lib/transport/inbound.d.ts +11 -0
  260. package/lib/transport/inbound.d.ts.map +1 -0
  261. package/lib/transport/inbound.js +511 -0
  262. package/lib/transport/inbound.js.map +1 -0
  263. package/lib/transport/index.d.ts +10 -0
  264. package/lib/transport/index.d.ts.map +1 -0
  265. package/lib/transport/index.js +10 -0
  266. package/lib/transport/index.js.map +1 -0
  267. package/lib/transport/msgid-cache.d.ts +23 -0
  268. package/lib/transport/msgid-cache.d.ts.map +1 -0
  269. package/lib/transport/msgid-cache.js +57 -0
  270. package/lib/transport/msgid-cache.js.map +1 -0
  271. package/lib/transport/notify.js +147 -0
  272. package/lib/transport/outbound-buffer.d.ts +42 -0
  273. package/lib/transport/outbound-buffer.d.ts.map +1 -0
  274. package/lib/transport/outbound-buffer.js +68 -0
  275. package/lib/transport/outbound-buffer.js.map +1 -0
  276. package/lib/transport/outbound.d.ts +42 -0
  277. package/lib/transport/outbound.d.ts.map +1 -0
  278. package/lib/transport/outbound.js +183 -0
  279. package/lib/transport/outbound.js.map +1 -0
  280. package/lib/transport/reply-limiter.d.ts +31 -0
  281. package/lib/transport/reply-limiter.d.ts.map +1 -0
  282. package/lib/transport/reply-limiter.js +50 -0
  283. package/lib/transport/reply-limiter.js.map +1 -0
  284. package/lib/transport/reply-target.d.ts +32 -0
  285. package/lib/transport/reply-target.d.ts.map +1 -0
  286. package/lib/transport/reply-target.js +64 -0
  287. package/lib/transport/reply-target.js.map +1 -0
  288. package/lib/transport/streaming-writer.d.ts +55 -0
  289. package/lib/transport/streaming-writer.d.ts.map +1 -0
  290. package/lib/transport/streaming-writer.js +122 -0
  291. package/lib/transport/streaming-writer.js.map +1 -0
  292. package/lib/transport/tool-presenter.d.ts +37 -0
  293. package/lib/transport/tool-presenter.d.ts.map +1 -0
  294. package/lib/transport/tool-presenter.js +116 -0
  295. package/lib/transport/tool-presenter.js.map +1 -0
  296. package/lib/turn-check.js +85 -0
  297. package/lib/types.d.ts +39 -0
  298. package/lib/types.js +5 -0
  299. package/locale/en.json +6 -0
  300. package/locale/zh.json +6 -0
  301. package/package.json +127 -4
@@ -0,0 +1 @@
1
+ {"version":3,"file":"msgid-cache.js","sourceRoot":"","sources":["../../src/transport/msgid-cache.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,147 @@
1
+ /**
2
+ * 发不出去要让模型当场知道。
3
+ *
4
+ * 以前发送失败只进日志:模型以为自己说过了,顺着那句话往下聊,
5
+ * 对方其实一个字都没收到。这里把失败翻成一句人话,再 inject 回同一个 agent
6
+ * ——不唤醒,下一个 step 就能看到(宿主 injectUserContext 就是这么做)。
7
+ *
8
+ * 同一个 turn、同一类失败只喊一次;第二次起改成一句条数汇总,不刷屏。
9
+ *
10
+ * @module dsh-qqbot-plus/transport/notify
11
+ */
12
+ import { createUserMessage } from '@deepseek-ai/dsh-llm'
13
+
14
+ /** 已经喊过的(会话 + 步号 + 类别),只留最近几百条,防止长期运行涨内存。 */
15
+ const seen = new Map()
16
+ const SEEN_LIMIT = 400
17
+
18
+ /** 把各种形态的错误拍平成 { code, http, text }。 */
19
+ function shapeOf(error) {
20
+ if (error === null || error === undefined) return { code: '', http: 0, text: '' }
21
+ if (typeof error === 'string') return { code: '', http: 0, text: error }
22
+ const code = error.bizCode ?? error.biz_code ?? error.code ?? ''
23
+ const http = Number(error.httpStatus ?? error.status ?? 0) || 0
24
+ const text = String(error.bizMessage ?? error.message ?? error.error ?? '')
25
+ return { code: code === null || code === undefined ? '' : String(code), http, text }
26
+ }
27
+
28
+ /**
29
+ * 分类:返回 { kind, text }。
30
+ * kind 用来去重(限额和审核是两件事,各喊一次),text 是给模型看的一句话。
31
+ */
32
+ function classify(error) {
33
+ const { code, http, text } = shapeOf(error)
34
+ const hay = `${code} ${text}`
35
+ const codeTag = code === '' ? '' : `(code=${code})`
36
+
37
+ // 1. 被动回复窗口过期:msg_id 失效,平台直接拒
38
+ if (code === '40034005' || /msg_?id/i.test(hay) && /过期|失效|expire|invalid/i.test(hay)) {
39
+ return { kind: 'expired', text: `被动回复窗口过期了,这条对方没收到${codeTag}` }
40
+ }
41
+ // 2. 限流 / 主动消息额度
42
+ if (code === '22009' || code === '22011' || http === 429 || /限流|过于频繁|频率|rate.?limit|too many/i.test(hay)) {
43
+ return { kind: 'ratelimit', text: `被限流或主动消息额度用完了,这条对方没收到${codeTag}` }
44
+ }
45
+ // 3. 平台判内容不合规
46
+ if (code === '40034' || /审核|audit|不合规|敏感|违规|reject|forbidden/i.test(hay)) {
47
+ return { kind: 'audit', text: `内容被平台拦了,这条对方没收到,换个说法重发${codeTag}` }
48
+ }
49
+ // 4. 超时 / 断网:最危险的一类——不知道到底出去没有
50
+ // httpStatus === 0 只有 SDK 的 ApiError 会带(表示压根没拿到响应),普通字符串错误不算
51
+ const offline = typeof error === 'object' && error !== null && 'httpStatus' in error && http === 0
52
+ if (offline || /timeout|timed out|network|fetch failed|ECONN|ETIMEDOUT|socket|abort/i.test(hay)) {
53
+ return { kind: 'network', text: `发送超时或网络断了,不确定有没有发出去,别默认对方看到了${codeTag}` }
54
+ }
55
+ // 5. 服务端临时故障
56
+ if (http >= 500) {
57
+ return { kind: 'server', text: `QQ 服务端临时故障(HTTP ${http}),这条没发出去,可以重试${codeTag}` }
58
+ }
59
+ // 6. 其余原样带出来,别吞掉细节
60
+ const detail = text === '' ? String(error ?? '原因不明') : text
61
+ return { kind: 'unknown', text: `发送失败:${detail.slice(0, 160)}${codeTag}` }
62
+ }
63
+
64
+ /** 给模型看的一句话(导出给工具回执复用)。 */
65
+ export function classifySendError(error) {
66
+ return classify(error).text
67
+ }
68
+
69
+ /** 同类失败的类名(去重用)。 */
70
+ export function classifySendErrorKind(error) {
71
+ return classify(error).kind
72
+ }
73
+
74
+ function prune() {
75
+ if (seen.size <= SEEN_LIMIT) return
76
+ const drop = seen.size - SEEN_LIMIT
77
+ let i = 0
78
+ for (const key of seen.keys()) {
79
+ seen.delete(key)
80
+ if (++i >= drop) break
81
+ }
82
+ }
83
+
84
+ /** 往 agent 手里塞一条「这是系统事件、不是用户说的」消息。 */
85
+ function deliver(agent, text) {
86
+ try {
87
+ const message = createUserMessage({
88
+ content: [{ type: 'text', text }],
89
+ source: { kind: 'qqbot-send-failure' },
90
+ })
91
+ if (typeof agent.inject === 'function') {
92
+ agent.inject(message)
93
+ return true
94
+ }
95
+ if (typeof agent.followup === 'function') {
96
+ agent.followup(message)
97
+ return true
98
+ }
99
+ return false
100
+ }
101
+ catch {
102
+ return false
103
+ }
104
+ }
105
+
106
+ /**
107
+ * 把一条人话塞给这个会话的 agent。
108
+ * @returns 是否真的投进去了(没 agent / 没 inject 就是 false)
109
+ */
110
+ export function notifyAgent(record, text, dedupKey = 'send') {
111
+ const agent = record?.pendingAgent ?? record?.agent
112
+ if (agent === null || agent === undefined) return false
113
+ if (typeof agent.inject !== 'function' && typeof agent.followup !== 'function') return false
114
+ const seq = agent.session?.seq ?? '-'
115
+ const base = `${record.sessionKey ?? record.sessionId ?? agent.id}#${seq}#${dedupKey}`
116
+ const prev = seen.get(base)
117
+ if (prev !== undefined) {
118
+ prev.count += 1
119
+ if (prev.count === 2) {
120
+ // 同类第一次已经喊过,第二次只补一句条数,避免每块都刷一遍
121
+ deliver(agent, `(这一类发送失败这一轮又出现一次,累计 ${prev.count} 次;上面说的那几条对方都没收到)`)
122
+ }
123
+ return true
124
+ }
125
+ seen.set(base, { count: 1, at: Date.now() })
126
+ prune()
127
+ return deliver(agent, text)
128
+ }
129
+
130
+ /**
131
+ * 发送失败的统一出口:分类 → 组织一句话 → 注入。
132
+ * @param context.kind 'text' | 'file' | 'notice'
133
+ * @param context.sent / context.total 分块发送时已发出的块数
134
+ * @param context.name 文件名之类,给模型认东西用
135
+ */
136
+ export function notifySendFailure(record, error, context = {}) {
137
+ const { kind: failKind, text } = classify(error)
138
+ const what = context.kind === 'file' ? '文件' : context.kind === 'notice' ? '提示' : '这条消息'
139
+ const parts = [`⚠️ 刚${what}没发到 QQ:${text}。`]
140
+ if (Number.isFinite(context.total) && context.total > 0) {
141
+ const sent = Number(context.sent ?? 0)
142
+ parts.push(`分 ${context.total} 块发,第 ${sent + 1} 块起没出去${sent > 0 ? '(前面几块已经发出去了)' : ''}。`)
143
+ }
144
+ if (typeof context.name === 'string' && context.name !== '') parts.push(`(${context.name})`)
145
+ const dedup = `${context.kind ?? 'text'}:${failKind}:${context.dedup ?? ''}`
146
+ return notifyAgent(record, parts.join(''), dedup)
147
+ }
@@ -0,0 +1,42 @@
1
+ /**
2
+ * OutboundBuffer — 出站文本缓冲
3
+ *
4
+ * 收集流式 chunk,流式优先投递(StreamingWriter),降级为静态发送。
5
+ * 独立文件便于单测。
6
+ */
7
+ import type { InlineKeyboard } from '@tencent-connect/qqbot-nodejs';
8
+ import type { SessionRecord } from '../session/index.ts';
9
+ import type { Logger, ReplyTarget } from '../types.ts';
10
+ /** QQ 流式会话(openStream 返回) */
11
+ export interface StreamSessionLike {
12
+ update(content: string): Promise<unknown>;
13
+ complete(): Promise<unknown>;
14
+ }
15
+ /** QQ Bot 发送接口 */
16
+ export interface QQBotSender {
17
+ sendMarkdown(target: ReplyTarget, content: string, opts?: {
18
+ keyboard?: InlineKeyboard;
19
+ }): Promise<unknown>;
20
+ openStream(target: ReplyTarget): StreamSessionLike;
21
+ }
22
+ export declare class OutboundBuffer {
23
+ private buffer;
24
+ private flushing;
25
+ private readonly writer;
26
+ private readonly record;
27
+ private readonly bot;
28
+ private readonly limit;
29
+ private readonly logger;
30
+ constructor(record: SessionRecord, bot: QQBotSender, limit: number, logger: Logger, streamingEnabled: boolean);
31
+ /** 追加文本增量 */
32
+ append(text: string): void;
33
+ /** 获取当前累积文本 */
34
+ get text(): string;
35
+ /** 重置累积文本(LLM 重试的新 attempt),流式会话保留由全量 update 重写 */
36
+ reset(): void;
37
+ /** 发送所有累积文本:流式优先,降级静态 */
38
+ flush(): Promise<void>;
39
+ /** 取消(异常/丢弃),中止流式并清空缓冲 */
40
+ cancel(): void;
41
+ }
42
+ //# sourceMappingURL=outbound-buffer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outbound-buffer.d.ts","sourceRoot":"","sources":["../../src/transport/outbound-buffer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,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,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3G,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAAC;CACpD;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAG9B,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,OAAO;IAW3B,aAAa;IACN,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC,eAAe;IACf,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,mDAAmD;IAC5C,KAAK,IAAI,IAAI;IAKpB,yBAAyB;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBnC,0BAA0B;IACnB,MAAM,IAAI,IAAI;CAItB"}
@@ -0,0 +1,68 @@
1
+ import { chunkMarkdownText } from "./chunker.js";
2
+ import { StreamingWriter } from "./streaming-writer.js";
3
+ /** 流式输出节流间隔(ms):连续 chunk 累积后停顿该间隔才推送 */
4
+ const STREAM_THROTTLE_MS = 200;
5
+ export class OutboundBuffer {
6
+ buffer = '';
7
+ flushing = false;
8
+ writer;
9
+ record;
10
+ bot;
11
+ limit;
12
+ logger;
13
+ constructor(record, bot, limit, logger, streamingEnabled) {
14
+ this.record = record;
15
+ this.bot = bot;
16
+ this.limit = limit;
17
+ this.logger = logger;
18
+ this.writer = streamingEnabled
19
+ ? new StreamingWriter({ bot, target: record.replyTarget, logger, throttleMs: STREAM_THROTTLE_MS })
20
+ : null;
21
+ }
22
+ /** 追加文本增量 */
23
+ append(text) {
24
+ this.buffer += text;
25
+ this.writer?.append(text);
26
+ }
27
+ /** 获取当前累积文本 */
28
+ get text() {
29
+ return this.buffer;
30
+ }
31
+ /** 重置累积文本(LLM 重试的新 attempt),流式会话保留由全量 update 重写 */
32
+ reset() {
33
+ this.buffer = '';
34
+ this.writer?.reset();
35
+ }
36
+ /** 发送所有累积文本:流式优先,降级静态 */
37
+ async flush() {
38
+ if (this.flushing || !this.buffer.trim())
39
+ return;
40
+ this.flushing = true;
41
+ try {
42
+ if (this.writer) {
43
+ await this.writer.finish();
44
+ // 流式成功(未降级)→ 直接返回
45
+ if (!this.writer.shouldFallback)
46
+ return;
47
+ }
48
+ // 降级:静态发送(writer 不存在 or 流式失败)
49
+ const chunks = chunkMarkdownText(this.buffer, this.limit);
50
+ for (const chunk of chunks) {
51
+ await this.bot.sendMarkdown(this.record.replyTarget, chunk);
52
+ }
53
+ }
54
+ catch (err) {
55
+ this.logger.error(`im-qqbot: flush failed: ${err instanceof Error ? err.message : String(err)}`);
56
+ }
57
+ finally {
58
+ this.buffer = '';
59
+ this.flushing = false;
60
+ }
61
+ }
62
+ /** 取消(异常/丢弃),中止流式并清空缓冲 */
63
+ cancel() {
64
+ this.writer?.abort();
65
+ this.buffer = '';
66
+ }
67
+ }
68
+ //# sourceMappingURL=outbound-buffer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outbound-buffer.js","sourceRoot":"","sources":["../../src/transport/outbound-buffer.ts"],"names":[],"mappings":"AASA,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;IACjB,MAAM,GAAG,EAAE,CAAC;IACZ,QAAQ,GAAG,KAAK,CAAC;IACR,MAAM,CAAyB;IAC/B,MAAM,CAAgB;IACtB,GAAG,CAAc;IACjB,KAAK,CAAS;IACd,MAAM,CAAS;IAEhC,YACE,MAAqB,EACrB,GAAgB,EAChB,KAAa,EACb,MAAc,EACd,gBAAyB;QAEzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,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,mDAAmD;IAC5C,KAAK;QACV,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IACvB,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"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * 出站处理器 — dsh session/event → QQ 消息发送
3
+ *
4
+ * 采用路由器模式:OutboundRouter 持有会话级状态(文本缓冲、工具调用记录),
5
+ * 事件解析归一化在 events.ts,路由按事件类型分发到私有方法。
6
+ */
7
+ import type { SessionManager } from '../session/index.ts';
8
+ import type { ImQQBotConfig } from '../config.ts';
9
+ import type { Logger } from '../types.ts';
10
+ import { type QQBotSender } from './outbound-buffer.ts';
11
+ import { type ToolsRegistryLike } from './tool-presenter.ts';
12
+ import type { DeliverablesDelivererLike } from './deliverables.ts';
13
+ import { type RawSessionEvent, type StreamDelta } from './events.ts';
14
+ export type { QQBotSender } from './outbound-buffer.ts';
15
+ export type { ToolsRegistryLike } from './tool-presenter.ts';
16
+ export { parseStreamFrame } from './events.ts';
17
+ /** 出站处理器签名(注册到 ctx.on('session/event')) */
18
+ export type OutboundHandler = (session: SessionLike, event: RawSessionEvent) => void;
19
+ /** 出站事件入口集合:durable 事件 + 实时流式帧 */
20
+ export interface OutboundHandlers {
21
+ /** durable session 事件入口(注册到 ctx.on('session/event')) */
22
+ routeSessionEvent(session: SessionLike, event: RawSessionEvent): void;
23
+ /**
24
+ * 实时流式帧入口(注册到 ctx.on('agent/assistant-stream', ..., { global: true }))。
25
+ */
26
+ routeStreamFrame(agentId: string, delta: StreamDelta): void;
27
+ }
28
+ /** dsh Session 简化类型 */
29
+ export interface SessionLike {
30
+ header: {
31
+ id: string;
32
+ };
33
+ }
34
+ /**
35
+ * 创建出站事件处理器
36
+ *
37
+ * 返回 durable 事件与实时流式帧两个入口,分别注册到
38
+ * ctx.on('session/event') 与 ctx.on('agent/assistant-stream', ..., { global: true })。
39
+ * toolsRegistry 用于工具结果的结构化展示;deliverer 用于轮末投递 present 声明的交付文件。
40
+ */
41
+ export declare function createOutboundHandler(manager: SessionManager, bot: QQBotSender, config: ImQQBotConfig, logger: Logger, toolsRegistry?: ToolsRegistryLike, deliverer?: DeliverablesDelivererLike): OutboundHandlers;
42
+ //# sourceMappingURL=outbound.d.ts.map
@@ -0,0 +1 @@
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;AAE1C,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAoB,KAAK,iBAAiB,EAAuB,MAAM,qBAAqB,CAAC;AACpG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAUL,KAAK,eAAe,EACpB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAErF,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IACtE;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7D;AAED,uBAAuB;AACvB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACxB;AAwPD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,iBAAiB,EACjC,SAAS,CAAC,EAAE,yBAAyB,GACpC,gBAAgB,CAMlB"}
@@ -0,0 +1,183 @@
1
+ import { chunkMarkdownText } from "./chunker.js";
2
+ import { OutboundBuffer } from "./outbound-buffer.js";
3
+ import { parseEvent, extractTurnError, } from "./events.js";
4
+ import { notifySendFailure } from "./notify.js";
5
+ export { parseStreamFrame } from "./events.js";
6
+ /** 不展示给用户的轮次错误码(底层传输/网络错误,对用户无意义,且常被重试兜住) */
7
+ const SILENT_TURN_ERROR_CODES = new Set(['STREAM_CLOSED']);
8
+ /**
9
+ * 出站路由器:持有会话级状态,按事件类型分发到处理器
10
+ */
11
+ class OutboundRouter {
12
+ buffers = new Map();
13
+ /** 每会话当前流式 attemptId:LLM 重试会发布新 attempt,用于 reset 与迟到帧过滤 */
14
+ streamAttempts = new Map();
15
+ /** 每会话本轮已声明的交付文件(deliverables/presented,轮末清空) */
16
+ presentedFiles = new Map();
17
+ /** 每会话已见过的 present callId(轮内去重,防事件重放导致重复投递) */
18
+ presentedCalls = new Map();
19
+ /**
20
+ * 每会话最后一笔在途文本发送(assistant/message 的 flush 是 fire-and-forget,
21
+ * turn/end 时需等待其完成再投递交付文件,保证回复文本先于文件到达用户)。
22
+ */
23
+ pendingText = new Map();
24
+ manager;
25
+ bot;
26
+ config;
27
+ logger;
28
+ toolsRegistry;
29
+ deliverer;
30
+ constructor(manager, bot, config, logger, toolsRegistry, deliverer) {
31
+ this.manager = manager;
32
+ this.bot = bot;
33
+ this.config = config;
34
+ this.logger = logger;
35
+ this.toolsRegistry = toolsRegistry;
36
+ this.deliverer = deliverer;
37
+ }
38
+ /** 事件分发入口 */
39
+ route(session, raw) {
40
+ const event = parseEvent(raw);
41
+ if (event === undefined)
42
+ return;
43
+ const record = this.manager.findBySessionId(session.header.id);
44
+ if (record === undefined)
45
+ return;
46
+ switch (event.type) {
47
+ case 'assistant/chunk':
48
+ this.onChunk(session.header.id, record, event);
49
+ break;
50
+ case 'assistant/message':
51
+ this.onMessage(session.header.id, record, event);
52
+ break;
53
+ case 'deliverables/presented':
54
+ this.onPresented(session.header.id, event);
55
+ break;
56
+ case 'turn/end':
57
+ this.onTurnEnd(session.header.id, record, event);
58
+ break;
59
+ }
60
+ }
61
+ /** durable assistant/chunk 事件:不再自动播给 QQ(说话只走 qq_draft + qq_confirm) */
62
+ onChunk(_sessionId, _record, _event) {
63
+ // 起草—确认模式下正文不落地:这里只保留事件入口,避免历史 buffer 越攒越大。
64
+ }
65
+ /**
66
+ * 实时流式帧入口:起草—确认模式下不向 QQ 推送任何流式正文。
67
+ * 这里只清理 attempt 状态,避免迟到帧再被当作新内容。
68
+ */
69
+ routeStreamFrame(agentId, delta) {
70
+ if (delta.kind === 'attempt-start') {
71
+ this.streamAttempts.set(agentId, delta.attemptId);
72
+ this.buffers.get(agentId)?.reset();
73
+ }
74
+ // text-delta 一律丢弃:正文不自动发。
75
+ }
76
+ /** 获取或创建会话 buffer 并追加增量 */
77
+ appendChunk(sessionId, record, text) {
78
+ let buffer = this.buffers.get(sessionId);
79
+ if (buffer === undefined) {
80
+ buffer = new OutboundBuffer(record, this.bot, this.config.textChunkLimit, this.logger, this.shouldStream(record));
81
+ this.buffers.set(sessionId, buffer);
82
+ }
83
+ buffer.append(text);
84
+ }
85
+ /** 是否启用流式:配置开启 + c2c + 有 msgId(群聊不支持流式) */
86
+ shouldStream(record) {
87
+ return this.config.streaming
88
+ && record.replyTarget.scope === 'c2c'
89
+ && !!record.replyTarget.msgId;
90
+ }
91
+ /** 完整 assistant 消息:正文不自动发(说话只走 qq_draft + qq_confirm) */
92
+ onMessage(sessionId, _record, _event) {
93
+ this.buffers.delete(sessionId);
94
+ }
95
+ /** 记录每会话最后一笔在途文本任务(自身吞错:错误已由 send/flush 内部记录) */
96
+ trackText(sessionId, task) {
97
+ this.pendingText.set(sessionId, task.catch(() => { }));
98
+ }
99
+ /** 收集本轮声明的交付文件:事件总是先于 turn/end 到达,轮末统一投递 */
100
+ onPresented(sessionId, event) {
101
+ if (this.config.sendFile?.sendPresentedFiles === false)
102
+ return;
103
+ let calls = this.presentedCalls.get(sessionId);
104
+ if (calls === undefined) {
105
+ calls = new Set();
106
+ this.presentedCalls.set(sessionId, calls);
107
+ }
108
+ if (calls.has(event.callId))
109
+ return;
110
+ calls.add(event.callId);
111
+ const files = this.presentedFiles.get(sessionId) ?? [];
112
+ files.push(...event.files);
113
+ this.presentedFiles.set(sessionId, files);
114
+ }
115
+ /**
116
+ * 轮次结束:文本先送达、再投递交付文件、最后清理状态,异常结束时告知用户。
117
+ * 外层轮次失败不撤销已完成的声明(宿主契约),故失败轮的文件仍投递。
118
+ */
119
+ onTurnEnd(sessionId, record, event) {
120
+ const buffer = this.buffers.get(sessionId);
121
+ // 起草—确认模式下轮末不补发正文:残留 buffer 直接取消。
122
+ if (buffer !== undefined) {
123
+ buffer.cancel();
124
+ this.buffers.delete(sessionId);
125
+ }
126
+ const flushTask = Promise.resolve();
127
+ this.streamAttempts.delete(sessionId);
128
+ const files = this.presentedFiles.get(sessionId) ?? [];
129
+ this.presentedFiles.delete(sessionId);
130
+ this.presentedCalls.delete(sessionId);
131
+ // assistant/message 已在轮内先行发送的文本可能仍在途:与 turn/end 自身的 flush 一起等待
132
+ const pending = this.pendingText.get(sessionId) ?? Promise.resolve();
133
+ this.pendingText.delete(sessionId);
134
+ const failure = extractTurnError(event.reason);
135
+ void (async () => {
136
+ await Promise.all([flushTask, pending]);
137
+ if (failure !== undefined && !SILENT_TURN_ERROR_CODES.has(failure.code)) {
138
+ await this.send(record, `⚠️ 本轮异常结束\n\`${failure.code}\`: ${failure.message}`, 'sendTurnEndError');
139
+ }
140
+ if (files.length > 0 && this.deliverer !== undefined) {
141
+ await this.deliverer.deliver(record, files);
142
+ }
143
+ this.logger.debug(`im-qqbot: turn/end sessionId=${sessionId}`);
144
+ })();
145
+ }
146
+ /** 统一发送:切分 + 逐 chunk 发送 + 失败注入(失败要让模型当场知道,不能只进日志) */
147
+ async send(record, text, tag) {
148
+ const chunks = chunkMarkdownText(text, this.config.textChunkLimit);
149
+ let sent = 0;
150
+ for (const chunk of chunks) {
151
+ try {
152
+ await this.bot.sendMarkdown(record.replyTarget, chunk);
153
+ sent += 1;
154
+ }
155
+ catch (err) {
156
+ this.logger.error(`im-qqbot: ${tag} failed: ${err instanceof Error ? err.message : String(err)}`);
157
+ notifySendFailure(record, err, {
158
+ kind: tag === 'sendTurnEndError' ? 'notice' : 'text',
159
+ sent,
160
+ total: chunks.length,
161
+ dedup: tag,
162
+ });
163
+ // 后面几块别接着发了:缺口那块补不上,再往后发出去就是错位的半截话
164
+ break;
165
+ }
166
+ }
167
+ }
168
+ }
169
+ /**
170
+ * 创建出站事件处理器
171
+ *
172
+ * 返回 durable 事件与实时流式帧两个入口,分别注册到
173
+ * ctx.on('session/event') 与 ctx.on('agent/assistant-stream', ..., { global: true })。
174
+ * toolsRegistry 用于工具结果的结构化展示;deliverer 用于轮末投递 present 声明的交付文件。
175
+ */
176
+ export function createOutboundHandler(manager, bot, config, logger, toolsRegistry, deliverer) {
177
+ const router = new OutboundRouter(manager, bot, config, logger, toolsRegistry, deliverer);
178
+ return {
179
+ routeSessionEvent: (session, event) => router.route(session, event),
180
+ routeStreamFrame: (agentId, delta) => router.routeStreamFrame(agentId, delta),
181
+ };
182
+ }
183
+ //# sourceMappingURL=outbound.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outbound.js","sourceRoot":"","sources":["../../src/transport/outbound.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * 被动回复限额管理。
3
+ *
4
+ * QQ Bot 被动回复有限额:同一条消息只能被动回复 N 次,超时后不能再被动回复。
5
+ * 当限额耗尽或消息过期时,应降级为主动消息(proactive,不传 msgId)。
6
+ */
7
+ export interface ReplyLimiterConfig {
8
+ /** 每条消息最大被动回复次数(默认 4,留 1 次余量) */
9
+ limit?: number;
10
+ /** 消息 ID 过期时间 ms(默认 1 小时) */
11
+ ttlMs?: number;
12
+ /** 最大跟踪消息数(LRU 驱逐,默认 10000) */
13
+ maxTrackedMessages?: number;
14
+ }
15
+ export interface ReplyLimitResult {
16
+ allowed: boolean;
17
+ remaining: number;
18
+ fallbackReason?: 'expired' | 'limit_exceeded';
19
+ }
20
+ export declare class ReplyLimiter {
21
+ private readonly limit;
22
+ private readonly ttlMs;
23
+ private readonly maxTracked;
24
+ private readonly messages;
25
+ constructor(config?: ReplyLimiterConfig);
26
+ /** 检查是否允许对指定消息继续被动回复 */
27
+ checkLimit(messageId: string): ReplyLimitResult;
28
+ /** 记录一次被动回复 */
29
+ record(messageId: string): void;
30
+ }
31
+ //# sourceMappingURL=reply-limiter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reply-limiter.d.ts","sourceRoot":"","sources":["../../src/transport/reply-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAAC;CAC/C;AAOD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;gBAE3C,MAAM,CAAC,EAAE,kBAAkB;IAM9C,wBAAwB;IACjB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAqBtD,eAAe;IACR,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAevC"}
@@ -0,0 +1,50 @@
1
+ /**
2
+ * 被动回复限额管理。
3
+ *
4
+ * QQ Bot 被动回复有限额:同一条消息只能被动回复 N 次,超时后不能再被动回复。
5
+ * 当限额耗尽或消息过期时,应降级为主动消息(proactive,不传 msgId)。
6
+ */
7
+ export class ReplyLimiter {
8
+ limit;
9
+ ttlMs;
10
+ maxTracked;
11
+ messages = new Map();
12
+ constructor(config) {
13
+ this.limit = config?.limit ?? 4;
14
+ this.ttlMs = config?.ttlMs ?? 3600_000;
15
+ this.maxTracked = config?.maxTrackedMessages ?? 10_000;
16
+ }
17
+ /** 检查是否允许对指定消息继续被动回复 */
18
+ checkLimit(messageId) {
19
+ const now = Date.now();
20
+ const tracked = this.messages.get(messageId);
21
+ if (!tracked) {
22
+ return { allowed: true, remaining: this.limit };
23
+ }
24
+ if (now - tracked.firstSeenAt > this.ttlMs) {
25
+ this.messages.delete(messageId);
26
+ return { allowed: false, remaining: 0, fallbackReason: 'expired' };
27
+ }
28
+ const remaining = Math.max(0, this.limit - tracked.count);
29
+ if (remaining <= 0) {
30
+ return { allowed: false, remaining: 0, fallbackReason: 'limit_exceeded' };
31
+ }
32
+ return { allowed: true, remaining };
33
+ }
34
+ /** 记录一次被动回复 */
35
+ record(messageId) {
36
+ const now = Date.now();
37
+ const tracked = this.messages.get(messageId);
38
+ if (tracked) {
39
+ tracked.count += 1;
40
+ return;
41
+ }
42
+ if (this.messages.size >= this.maxTracked) {
43
+ const firstKey = this.messages.keys().next().value;
44
+ if (firstKey !== undefined)
45
+ this.messages.delete(firstKey);
46
+ }
47
+ this.messages.set(messageId, { count: 1, firstSeenAt: now });
48
+ }
49
+ }
50
+ //# sourceMappingURL=reply-limiter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reply-limiter.js","sourceRoot":"","sources":["../../src/transport/reply-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,MAAM,OAAO,YAAY;IACN,KAAK,CAAS;IACd,KAAK,CAAS;IACd,UAAU,CAAS;IACnB,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE9D,YAAmB,MAA2B;QAC5C,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,QAAQ,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE,kBAAkB,IAAI,MAAM,CAAC;IACzD,CAAC;IAED,wBAAwB;IACjB,UAAU,CAAC,SAAiB;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAClD,CAAC;QAED,IAAI,GAAG,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;QACrE,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1D,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;QAC5E,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACtC,CAAC;IAED,eAAe;IACR,MAAM,CAAC,SAAiB;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE7C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACnD,IAAI,QAAQ,KAAK,SAAS;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF"}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * 出站回复目标解析与发送 — 被动回复三级兜底 + msg_id/event_id 区分。
3
+ *
4
+ * 从 gateway 层抽离,保持 bootstrap 只做组装。三级兜底:
5
+ * 1. 优先显式 target.msgId;
6
+ * 2. 超频/过期后,用缓存里「最近一条未超频未过期」的 target;
7
+ * 3. 全部候选都超频/过期,才降级为主动推送(proactive)。
8
+ */
9
+ import { QQBot } from '@tencent-connect/qqbot-nodejs';
10
+ import type { InlineKeyboard } from '@tencent-connect/qqbot-nodejs';
11
+ import type { ReplyTarget } from '../types.ts';
12
+ import type { ReplyLimiter } from './reply-limiter.ts';
13
+ /**
14
+ * 解析被动回复目标。
15
+ *
16
+ * 显式 msgId 须经 cache 确认未超平台被动窗口(群 5min/私聊 30min),
17
+ * 否则跳过(延迟投递携带的旧 id 会被平台 40034005 拒绝)。
18
+ *
19
+ * @param allowEvent 是否允许返回互动事件 eventId。markdown 发送支持 event_id
20
+ * (bot.send 的 extra),传 true;文件发送 SDK 暂不支持 event_id,传 false
21
+ * 跳过 event 候选,降级为 msg 候选或主动推送。
22
+ */
23
+ export declare function resolveReplyTarget(target: ReplyTarget, limiter: ReplyLimiter, allowEvent: boolean): ReplyTarget;
24
+ /**
25
+ * 发送 markdown:区分 msg_id 与 event_id。
26
+ * 带 eventId 时通过 bot.send 的 extra 填 event_id(SDK sendMarkdown 不支持);
27
+ * 否则走 sendMarkdown 填 msg_id。
28
+ */
29
+ export declare function sendResolvedMarkdown(bot: QQBot, target: ReplyTarget, content: string, opts?: {
30
+ keyboard?: InlineKeyboard;
31
+ }): Promise<unknown>;
32
+ //# sourceMappingURL=reply-target.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reply-target.d.ts","sourceRoot":"","sources":["../../src/transport/reply-target.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,EAAW,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,OAAO,GAClB,WAAW,CAyBb;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,KAAK,EACV,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAA;CAAE,GACnC,OAAO,CAAC,OAAO,CAAC,CAWlB"}