@michengai/dsh-im-connect 0.1.0

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 (162) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +39 -0
  3. package/client.js +1479 -0
  4. package/cordis.patch.yml +4 -0
  5. package/lib/channels/dingtalk-card.d.ts +24 -0
  6. package/lib/channels/dingtalk-card.d.ts.map +1 -0
  7. package/lib/channels/dingtalk-card.js +182 -0
  8. package/lib/channels/dingtalk-card.js.map +1 -0
  9. package/lib/channels/dingtalk.d.ts +7 -0
  10. package/lib/channels/dingtalk.d.ts.map +1 -0
  11. package/lib/channels/dingtalk.js +107 -0
  12. package/lib/channels/dingtalk.js.map +1 -0
  13. package/lib/channels/factory.d.ts +4 -0
  14. package/lib/channels/factory.d.ts.map +1 -0
  15. package/lib/channels/factory.js +24 -0
  16. package/lib/channels/factory.js.map +1 -0
  17. package/lib/channels/feishu.d.ts +8 -0
  18. package/lib/channels/feishu.d.ts.map +1 -0
  19. package/lib/channels/feishu.js +73 -0
  20. package/lib/channels/feishu.js.map +1 -0
  21. package/lib/channels/meta.d.ts +20 -0
  22. package/lib/channels/meta.d.ts.map +1 -0
  23. package/lib/channels/meta.js +69 -0
  24. package/lib/channels/meta.js.map +1 -0
  25. package/lib/channels/qr/dingtalk.d.ts +12 -0
  26. package/lib/channels/qr/dingtalk.d.ts.map +1 -0
  27. package/lib/channels/qr/dingtalk.js +69 -0
  28. package/lib/channels/qr/dingtalk.js.map +1 -0
  29. package/lib/channels/qr/feishu.d.ts +14 -0
  30. package/lib/channels/qr/feishu.d.ts.map +1 -0
  31. package/lib/channels/qr/feishu.js +87 -0
  32. package/lib/channels/qr/feishu.js.map +1 -0
  33. package/lib/channels/qr/hub.d.ts +22 -0
  34. package/lib/channels/qr/hub.d.ts.map +1 -0
  35. package/lib/channels/qr/hub.js +193 -0
  36. package/lib/channels/qr/hub.js.map +1 -0
  37. package/lib/channels/qr/render.d.ts +3 -0
  38. package/lib/channels/qr/render.d.ts.map +1 -0
  39. package/lib/channels/qr/render.js +9 -0
  40. package/lib/channels/qr/render.js.map +1 -0
  41. package/lib/channels/qr/shared.d.ts +39 -0
  42. package/lib/channels/qr/shared.d.ts.map +1 -0
  43. package/lib/channels/qr/shared.js +51 -0
  44. package/lib/channels/qr/shared.js.map +1 -0
  45. package/lib/channels/qr/wecom.d.ts +10 -0
  46. package/lib/channels/qr/wecom.d.ts.map +1 -0
  47. package/lib/channels/qr/wecom.js +81 -0
  48. package/lib/channels/qr/wecom.js.map +1 -0
  49. package/lib/channels/qr/weixin.d.ts +10 -0
  50. package/lib/channels/qr/weixin.d.ts.map +1 -0
  51. package/lib/channels/qr/weixin.js +77 -0
  52. package/lib/channels/qr/weixin.js.map +1 -0
  53. package/lib/channels/telegram.d.ts +7 -0
  54. package/lib/channels/telegram.d.ts.map +1 -0
  55. package/lib/channels/telegram.js +133 -0
  56. package/lib/channels/telegram.js.map +1 -0
  57. package/lib/channels/wecom.d.ts +28 -0
  58. package/lib/channels/wecom.d.ts.map +1 -0
  59. package/lib/channels/wecom.js +168 -0
  60. package/lib/channels/wecom.js.map +1 -0
  61. package/lib/channels/weixin.d.ts +41 -0
  62. package/lib/channels/weixin.d.ts.map +1 -0
  63. package/lib/channels/weixin.js +678 -0
  64. package/lib/channels/weixin.js.map +1 -0
  65. package/lib/client.js +1479 -0
  66. package/lib/engine/access.d.ts +11 -0
  67. package/lib/engine/access.d.ts.map +1 -0
  68. package/lib/engine/access.js +11 -0
  69. package/lib/engine/access.js.map +1 -0
  70. package/lib/engine/agent-options.d.ts +25 -0
  71. package/lib/engine/agent-options.d.ts.map +1 -0
  72. package/lib/engine/agent-options.js +19 -0
  73. package/lib/engine/agent-options.js.map +1 -0
  74. package/lib/engine/approval.d.ts +9 -0
  75. package/lib/engine/approval.d.ts.map +1 -0
  76. package/lib/engine/approval.js +38 -0
  77. package/lib/engine/approval.js.map +1 -0
  78. package/lib/engine/assistant-settings.d.ts +17 -0
  79. package/lib/engine/assistant-settings.d.ts.map +1 -0
  80. package/lib/engine/assistant-settings.js +35 -0
  81. package/lib/engine/assistant-settings.js.map +1 -0
  82. package/lib/engine/credentials.d.ts +17 -0
  83. package/lib/engine/credentials.d.ts.map +1 -0
  84. package/lib/engine/credentials.js +51 -0
  85. package/lib/engine/credentials.js.map +1 -0
  86. package/lib/engine/gateway.d.ts +46 -0
  87. package/lib/engine/gateway.d.ts.map +1 -0
  88. package/lib/engine/gateway.js +333 -0
  89. package/lib/engine/gateway.js.map +1 -0
  90. package/lib/engine/json-state.d.ts +8 -0
  91. package/lib/engine/json-state.d.ts.map +1 -0
  92. package/lib/engine/json-state.js +24 -0
  93. package/lib/engine/json-state.js.map +1 -0
  94. package/lib/engine/merge.d.ts +21 -0
  95. package/lib/engine/merge.d.ts.map +1 -0
  96. package/lib/engine/merge.js +55 -0
  97. package/lib/engine/merge.js.map +1 -0
  98. package/lib/engine/router.d.ts +88 -0
  99. package/lib/engine/router.d.ts.map +1 -0
  100. package/lib/engine/router.js +309 -0
  101. package/lib/engine/router.js.map +1 -0
  102. package/lib/engine/seen-store.d.ts +12 -0
  103. package/lib/engine/seen-store.d.ts.map +1 -0
  104. package/lib/engine/seen-store.js +38 -0
  105. package/lib/engine/seen-store.js.map +1 -0
  106. package/lib/engine/session-id.d.ts +30 -0
  107. package/lib/engine/session-id.d.ts.map +1 -0
  108. package/lib/engine/session-id.js +53 -0
  109. package/lib/engine/session-id.js.map +1 -0
  110. package/lib/engine/session-store.d.ts +13 -0
  111. package/lib/engine/session-store.d.ts.map +1 -0
  112. package/lib/engine/session-store.js +38 -0
  113. package/lib/engine/session-store.js.map +1 -0
  114. package/lib/engine/split.d.ts +2 -0
  115. package/lib/engine/split.d.ts.map +1 -0
  116. package/lib/engine/split.js +41 -0
  117. package/lib/engine/split.js.map +1 -0
  118. package/lib/engine/types.d.ts +52 -0
  119. package/lib/engine/types.d.ts.map +1 -0
  120. package/lib/engine/types.js +2 -0
  121. package/lib/engine/types.js.map +1 -0
  122. package/lib/index.d.ts +22 -0
  123. package/lib/index.d.ts.map +1 -0
  124. package/lib/index.js +53 -0
  125. package/lib/index.js.map +1 -0
  126. package/lib/manager.d.ts +103 -0
  127. package/lib/manager.d.ts.map +1 -0
  128. package/lib/manager.js +543 -0
  129. package/lib/manager.js.map +1 -0
  130. package/package.json +63 -0
  131. package/src/channels/dingtalk-card.ts +191 -0
  132. package/src/channels/dingtalk.ts +113 -0
  133. package/src/channels/factory.ts +32 -0
  134. package/src/channels/feishu.ts +77 -0
  135. package/src/channels/meta.ts +89 -0
  136. package/src/channels/qr/dingtalk.ts +71 -0
  137. package/src/channels/qr/feishu.ts +90 -0
  138. package/src/channels/qr/hub.ts +206 -0
  139. package/src/channels/qr/render.ts +7 -0
  140. package/src/channels/qr/shared.ts +80 -0
  141. package/src/channels/qr/wecom.ts +78 -0
  142. package/src/channels/qr/weixin.ts +78 -0
  143. package/src/channels/telegram.ts +145 -0
  144. package/src/channels/wecom.ts +182 -0
  145. package/src/channels/weixin.ts +712 -0
  146. package/src/engine/access.ts +17 -0
  147. package/src/engine/agent-options.ts +24 -0
  148. package/src/engine/approval.ts +45 -0
  149. package/src/engine/assistant-settings.ts +41 -0
  150. package/src/engine/credentials.ts +64 -0
  151. package/src/engine/gateway.ts +330 -0
  152. package/src/engine/json-state.ts +20 -0
  153. package/src/engine/merge.ts +60 -0
  154. package/src/engine/router.ts +333 -0
  155. package/src/engine/seen-store.ts +36 -0
  156. package/src/engine/session-id.ts +65 -0
  157. package/src/engine/session-store.ts +45 -0
  158. package/src/engine/split.ts +29 -0
  159. package/src/engine/types.ts +55 -0
  160. package/src/index.ts +81 -0
  161. package/src/manager.ts +571 -0
  162. package/src/optional-modules.d.ts +13 -0
@@ -0,0 +1,182 @@
1
+ import type { ChannelAdapter, ImMessage, ReplyStream } from '../engine/types.js'
2
+
3
+ export interface WecomConfig {
4
+ botId?: string
5
+ secret?: string
6
+ }
7
+
8
+ export interface WecomSdkClient {
9
+ replyStream(frame: unknown, streamId: string, content: string, finish?: boolean): Promise<unknown>
10
+ sendMessage(chatId: string, body: unknown): Promise<unknown>
11
+ connect(): unknown
12
+ disconnect(): void
13
+ on(event: string, fn: (payload?: unknown) => void): void
14
+ }
15
+
16
+ export function frameBody(frame: unknown): Record<string, unknown> {
17
+ const body = (frame as { body?: Record<string, unknown> }).body
18
+ return body && typeof body === 'object' ? body : {}
19
+ }
20
+
21
+ export function messageText(body: Record<string, unknown>): string {
22
+ if (body.msgtype === 'text') return String((body.text as { content?: string } | undefined)?.content ?? '').trim()
23
+ if (body.msgtype === 'voice') return String((body.voice as { content?: string } | undefined)?.content ?? '').trim()
24
+ const mixed = body.mixed as { msg_item?: Array<{ msgtype?: string; text?: { content?: string } }> } | undefined
25
+ if (body.msgtype === 'mixed' && Array.isArray(mixed?.msg_item)) {
26
+ return mixed.msg_item
27
+ .filter((item) => item?.msgtype === 'text' && item.text?.content)
28
+ .map((item) => String(item.text?.content ?? ''))
29
+ .join('\n')
30
+ .trim()
31
+ }
32
+ return ''
33
+ }
34
+
35
+ /** 企业微信智能机器人必须按回调帧 replyStream,主动 sendMessage 用户看不到。 */
36
+ export class WecomReplyBroker {
37
+ private readonly pending = new Map<string, { frame: unknown; streamId: string; started: boolean }>()
38
+
39
+ constructor(
40
+ private readonly client: Pick<WecomSdkClient, 'replyStream' | 'sendMessage'>,
41
+ private readonly log: (line: string) => void,
42
+ private readonly newStreamId: () => string = () => `stream_${Date.now()}_${Math.random().toString(16).slice(2, 10)}`,
43
+ ) {}
44
+
45
+ remember(chatId: string, frame: unknown): string {
46
+ const streamId = this.newStreamId()
47
+ this.pending.set(chatId, { frame, streamId, started: false })
48
+ return streamId
49
+ }
50
+
51
+ async startThinking(chatId: string): Promise<void> {
52
+ const item = this.pending.get(chatId)
53
+ if (!item || item.started) return
54
+ await this.client.replyStream(item.frame, item.streamId, '正在思考中…', false)
55
+ item.started = true
56
+ }
57
+
58
+ async send(chatId: string, text: string): Promise<void> {
59
+ const item = this.pending.get(chatId)
60
+ if (item) {
61
+ try {
62
+ await this.client.replyStream(item.frame, item.streamId, text, true)
63
+ this.pending.delete(chatId)
64
+ this.log(`[wecom] 已通过回调回复 ${chatId}`)
65
+ return
66
+ } catch (error) {
67
+ this.log(`[wecom] 回调回复失败,改走主动推送:${error instanceof Error ? error.message : String(error)}`)
68
+ }
69
+ }
70
+ await this.client.sendMessage(chatId, { msgtype: 'markdown', markdown: { content: text } })
71
+ this.log(`[wecom] 已主动推送 ${chatId}`)
72
+ }
73
+
74
+ async beginReply(chatId: string): Promise<ReplyStream> {
75
+ const item = this.pending.get(chatId)
76
+ if (!item) throw new Error('wecom: 没有待回复的回调帧')
77
+ if (!item.started) await this.startThinking(chatId)
78
+ return {
79
+ // 企业微信客户端会把未完成分片渲染成一条条气泡,这里只收最终全文。
80
+ update: async () => undefined,
81
+ finish: async (text) => {
82
+ await this.client.replyStream(item.frame, item.streamId, text, true)
83
+ this.pending.delete(chatId)
84
+ this.log(`[wecom] 已通过回调回复 ${chatId}`)
85
+ },
86
+ }
87
+ }
88
+ }
89
+
90
+ export function createWecomChannel(config: WecomConfig, log: (line: string) => void): ChannelAdapter | undefined {
91
+ const botId = config.botId?.trim()
92
+ const secret = config.secret?.trim()
93
+ if (!botId || !secret) return undefined
94
+
95
+ let handler: ((msg: ImMessage) => void | Promise<void>) | undefined
96
+ let client: WecomSdkClient | undefined
97
+ let broker: WecomReplyBroker | undefined
98
+ let statusText = '未连接'
99
+
100
+ return {
101
+ id: 'wecom',
102
+ label: '企业微信',
103
+ maxMessageLength: 4000,
104
+ skipMerge: true,
105
+ async start() {
106
+ let sdk: {
107
+ WSClient: new (opts: { botId: string; secret: string }) => WecomSdkClient
108
+ generateReqId?: (prefix: string) => string
109
+ }
110
+ try {
111
+ sdk = await import('@wecom/aibot-node-sdk') as typeof sdk
112
+ } catch {
113
+ throw new Error('缺少依赖 @wecom/aibot-node-sdk')
114
+ }
115
+ client = new sdk.WSClient({ botId, secret })
116
+ const newStreamId = sdk.generateReqId
117
+ ? () => sdk.generateReqId!('stream')
118
+ : () => `stream_${Date.now()}_${Math.random().toString(16).slice(2, 10)}`
119
+ broker = new WecomReplyBroker(client, log, newStreamId)
120
+ client.on('message', (frame) => {
121
+ const body = frameBody(frame)
122
+ const chattype = String(body.chattype ?? '')
123
+ const from = body.from as { userid?: string } | undefined
124
+ const senderId = from?.userid ?? ''
125
+ const chatId = chattype === 'group' ? String(body.chatid ?? '') : senderId
126
+ const text = messageText(body)
127
+ if (!chatId || !text || !['single', 'group'].includes(chattype)) {
128
+ log(`[wecom] 忽略一帧 chattype=${chattype || '-'} msgtype=${String(body.msgtype ?? '-')}`)
129
+ return
130
+ }
131
+ log(`[wecom] 收到 ${chattype} ${senderId}: ${text.slice(0, 80)}`)
132
+ broker?.remember(chatId, frame)
133
+ void broker?.startThinking(chatId).catch((error) => {
134
+ log(`[wecom] 无法发送思考中提示:${error instanceof Error ? error.message : String(error)}`)
135
+ })
136
+ void handler?.({
137
+ chatId,
138
+ userId: senderId,
139
+ text,
140
+ kind: chattype === 'group' ? 'group' : 'dm',
141
+ addressed: chattype !== 'group' || text.includes('@'),
142
+ messageId: typeof body.msgid === 'string' ? body.msgid : undefined,
143
+ })
144
+ })
145
+ const ready = new Promise<void>((resolve, reject) => {
146
+ const timer = setTimeout(() => reject(new Error('企业微信连接超时')), 20_000)
147
+ client?.on('authenticated', () => {
148
+ clearTimeout(timer)
149
+ resolve()
150
+ })
151
+ client?.on('error', (error) => {
152
+ const detail = error instanceof Error ? error.message : String(error ?? 'connection-error')
153
+ if (/auth|unauthorized|invalid/i.test(detail)) {
154
+ clearTimeout(timer)
155
+ reject(new Error(`企业微信鉴权失败:${detail}`))
156
+ } else {
157
+ log(`[wecom] 连接异常:${detail}`)
158
+ }
159
+ })
160
+ })
161
+ client.connect()
162
+ await ready
163
+ statusText = '长连接已建立'
164
+ log('[wecom] WebSocket 已连接')
165
+ },
166
+ async stop() {
167
+ client?.disconnect()
168
+ client = undefined
169
+ broker = undefined
170
+ statusText = '已停止'
171
+ },
172
+ async send(chatId, text) {
173
+ if (!broker) throw new Error('wecom: 尚未连接')
174
+ await broker.send(chatId, text)
175
+ },
176
+ async sendAction(chatId) {
177
+ await broker?.startThinking(chatId).catch(() => undefined)
178
+ },
179
+ setMessageHandler(h) { handler = h },
180
+ status() { return statusText },
181
+ }
182
+ }