@yanhaidao/wecom 2.4.160 → 2.5.110

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 (313) hide show
  1. package/dist/index.js +68 -0
  2. package/dist/src/accounts.js +20 -0
  3. package/dist/src/agent/handler.js +895 -0
  4. package/dist/src/agent/index.js +5 -0
  5. package/dist/src/app/account-runtime.js +216 -0
  6. package/dist/src/app/bootstrap.js +19 -0
  7. package/dist/src/app/index.js +118 -0
  8. package/dist/src/capability/agent/delivery-service.js +63 -0
  9. package/dist/src/capability/agent/fallback-policy.js +6 -0
  10. package/dist/src/capability/agent/ingress-service.js +33 -0
  11. package/dist/src/capability/agent/upstream-delivery-service.js +71 -0
  12. package/dist/src/capability/bot/dispatch-config.js +45 -0
  13. package/dist/src/capability/bot/fallback-delivery.js +147 -0
  14. package/dist/src/capability/bot/local-path-delivery.js +178 -0
  15. package/dist/src/capability/bot/sandbox-media.js +138 -0
  16. package/dist/src/capability/bot/service.js +49 -0
  17. package/dist/src/capability/bot/stream-delivery.js +321 -0
  18. package/dist/src/capability/bot/stream-finalizer.js +81 -0
  19. package/dist/src/capability/bot/stream-orchestrator.js +318 -0
  20. package/dist/src/capability/bot/types.js +1 -0
  21. package/{src/capability/calendar/client.ts → dist/src/capability/calendar/client.js} +118 -241
  22. package/{src/capability/calendar/schema.ts → dist/src/capability/calendar/schema.js} +0 -38
  23. package/dist/src/capability/calendar/tool.js +365 -0
  24. package/dist/src/capability/calendar/types.js +12 -0
  25. package/{src/capability/doc/client.ts → dist/src/capability/doc/client.js} +370 -605
  26. package/{src/capability/doc/schema.ts → dist/src/capability/doc/schema.js} +345 -394
  27. package/dist/src/capability/doc/tool.js +1556 -0
  28. package/dist/src/capability/doc/types.js +113 -0
  29. package/dist/src/capability/mcp/index.js +3 -0
  30. package/dist/src/capability/mcp/schema.js +102 -0
  31. package/dist/src/capability/mcp/tool.js +146 -0
  32. package/dist/src/capability/mcp/transport.js +293 -0
  33. package/dist/src/channel.js +224 -0
  34. package/dist/src/config/accounts.js +236 -0
  35. package/dist/src/config/derived-paths.js +31 -0
  36. package/dist/src/config/index.js +7 -0
  37. package/dist/src/config/media.js +110 -0
  38. package/dist/src/config/network.js +32 -0
  39. package/dist/src/config/routing.js +20 -0
  40. package/dist/src/config/runtime-config.js +25 -0
  41. package/dist/src/config/schema.js +4 -0
  42. package/{src/config-schema.ts → dist/src/config-schema.js} +1 -1
  43. package/dist/src/context-store.js +219 -0
  44. package/{src/crypto/aes.ts → dist/src/crypto/aes.js} +11 -28
  45. package/dist/src/crypto/index.js +9 -0
  46. package/{src/crypto/signature.ts → dist/src/crypto/signature.js} +3 -18
  47. package/{src/crypto/xml.ts → dist/src/crypto/xml.js} +3 -11
  48. package/dist/src/crypto.js +145 -0
  49. package/dist/src/domain/models.js +1 -0
  50. package/dist/src/domain/policies.js +32 -0
  51. package/{src/dynamic-agent.ts → dist/src/dynamic-agent.js} +36 -73
  52. package/dist/src/gateway-monitor.js +139 -0
  53. package/dist/src/http.js +114 -0
  54. package/{src/media.ts → dist/src/media.js} +21 -40
  55. package/dist/src/monitor/limits.js +7 -0
  56. package/dist/src/monitor/state.js +28 -0
  57. package/dist/src/monitor.js +84 -0
  58. package/dist/src/observability/audit-log.js +30 -0
  59. package/dist/src/observability/legacy-operational-event-store.js +22 -0
  60. package/dist/src/observability/raw-envelope-log.js +24 -0
  61. package/dist/src/observability/status-registry.js +9 -0
  62. package/dist/src/observability/transport-session-view.js +14 -0
  63. package/dist/src/onboarding.js +546 -0
  64. package/dist/src/outbound.js +557 -0
  65. package/dist/src/runtime/dispatcher.js +57 -0
  66. package/{src/runtime/index.ts → dist/src/runtime/index.js} +0 -1
  67. package/dist/src/runtime/outbound-intent.js +1 -0
  68. package/dist/src/runtime/reply-orchestrator.js +38 -0
  69. package/dist/src/runtime/routing-bridge.js +26 -0
  70. package/dist/src/runtime/session-manager.js +112 -0
  71. package/dist/src/runtime/source-registry.js +174 -0
  72. package/dist/src/runtime.js +1 -0
  73. package/dist/src/shared/command-auth.js +57 -0
  74. package/{src/shared/index.ts → dist/src/shared/index.js} +0 -1
  75. package/dist/src/shared/media-asset.js +65 -0
  76. package/dist/src/shared/media-service.js +59 -0
  77. package/dist/src/shared/media-types.js +1 -0
  78. package/{src/shared/xml-parser.ts → dist/src/shared/xml-parser.js} +72 -63
  79. package/dist/src/store/active-reply-store.js +41 -0
  80. package/dist/src/store/interfaces.js +1 -0
  81. package/dist/src/store/memory-store.js +33 -0
  82. package/dist/src/store/stream-batch-store.js +319 -0
  83. package/{src/target.ts → dist/src/target.js} +15 -48
  84. package/dist/src/transport/agent-api/client.js +168 -0
  85. package/dist/src/transport/agent-api/core.js +337 -0
  86. package/dist/src/transport/agent-api/delivery.js +28 -0
  87. package/dist/src/transport/agent-api/media-upload.js +4 -0
  88. package/dist/src/transport/agent-api/reply.js +24 -0
  89. package/dist/src/transport/agent-api/upstream-delivery.js +30 -0
  90. package/dist/src/transport/agent-api/upstream-media-upload.js +46 -0
  91. package/dist/src/transport/agent-api/upstream-reply.js +26 -0
  92. package/dist/src/transport/agent-callback/http-handler.js +30 -0
  93. package/dist/src/transport/agent-callback/inbound.js +4 -0
  94. package/dist/src/transport/agent-callback/reply.js +8 -0
  95. package/dist/src/transport/agent-callback/request-handler.js +189 -0
  96. package/dist/src/transport/agent-callback/session.js +15 -0
  97. package/dist/src/transport/bot-webhook/active-reply.js +27 -0
  98. package/dist/src/transport/bot-webhook/http-handler.js +31 -0
  99. package/dist/src/transport/bot-webhook/inbound-normalizer.js +496 -0
  100. package/dist/src/transport/bot-webhook/inbound.js +4 -0
  101. package/dist/src/transport/bot-webhook/message-shape.js +98 -0
  102. package/dist/src/transport/bot-webhook/protocol.js +124 -0
  103. package/dist/src/transport/bot-webhook/reply.js +9 -0
  104. package/dist/src/transport/bot-webhook/request-handler.js +285 -0
  105. package/dist/src/transport/bot-webhook/session.js +15 -0
  106. package/dist/src/transport/bot-ws/inbound.js +147 -0
  107. package/dist/src/transport/bot-ws/media.js +236 -0
  108. package/dist/src/transport/bot-ws/reply.js +310 -0
  109. package/dist/src/transport/bot-ws/sdk-adapter.js +257 -0
  110. package/dist/src/transport/bot-ws/session.js +15 -0
  111. package/dist/src/transport/http/common.js +78 -0
  112. package/dist/src/transport/http/registry.js +71 -0
  113. package/dist/src/transport/http/request-handler.js +51 -0
  114. package/{src/transport/index.ts → dist/src/transport/index.js} +2 -10
  115. package/dist/src/types/account.js +1 -0
  116. package/dist/src/types/config.js +1 -0
  117. package/dist/src/types/constants.js +28 -0
  118. package/dist/src/types/events.js +1 -0
  119. package/dist/src/types/index.js +1 -0
  120. package/dist/src/types/legacy-stream.js +1 -0
  121. package/dist/src/types/message.js +5 -0
  122. package/dist/src/types/runtime-context.js +1 -0
  123. package/dist/src/types/runtime.js +1 -0
  124. package/dist/src/types.js +1 -0
  125. package/dist/src/upstream/index.js +111 -0
  126. package/dist/src/wecom_msg_adapter/markdown_adapter.js +280 -0
  127. package/openclaw.plugin.json +15 -0
  128. package/package.json +18 -1
  129. package/.github/workflows/release.yml +0 -143
  130. package/GOVERNANCE.md +0 -26
  131. package/SKILLS_CAL.md +0 -895
  132. package/SKILLS_DOC.md +0 -2288
  133. package/UPSTREAM_CONFIG.md +0 -170
  134. package/UPSTREAM_PLAN.md +0 -175
  135. package/assets/01.bot-add.png +0 -0
  136. package/assets/01.bot-setp2.png +0 -0
  137. package/assets/01.image.jpg +0 -0
  138. package/assets/02.agent.add.png +0 -0
  139. package/assets/02.agent.api-set.png +0 -0
  140. package/assets/02.image.jpg +0 -0
  141. package/assets/03.agent.page.png +0 -0
  142. package/assets/03.bot.page.png +0 -0
  143. package/assets/link-me.jpg +0 -0
  144. package/assets/register.png +0 -0
  145. package/changelog/v2.2.28.md +0 -70
  146. package/changelog/v2.3.10.md +0 -17
  147. package/changelog/v2.3.11.md +0 -19
  148. package/changelog/v2.3.12.md +0 -25
  149. package/changelog/v2.3.13.md +0 -19
  150. package/changelog/v2.3.14.md +0 -48
  151. package/changelog/v2.3.15.md +0 -15
  152. package/changelog/v2.3.16.md +0 -11
  153. package/changelog/v2.3.18.md +0 -22
  154. package/changelog/v2.3.19.md +0 -73
  155. package/changelog/v2.3.2.md +0 -28
  156. package/changelog/v2.3.26.md +0 -21
  157. package/changelog/v2.3.27.md +0 -33
  158. package/changelog/v2.3.4.md +0 -20
  159. package/changelog/v2.3.9.md +0 -22
  160. package/changelog/v2.4.12.md +0 -37
  161. package/changelog/v2.4.16.md +0 -19
  162. package/compat-single-account.md +0 -148
  163. package/index.test.ts +0 -38
  164. package/scripts/test-proxy.ts +0 -70
  165. package/src/accounts.ts +0 -34
  166. package/src/agent/api-client.upload.test.ts +0 -109
  167. package/src/agent/handler.event-filter.test.ts +0 -100
  168. package/src/agent/handler.ts +0 -1105
  169. package/src/agent/index.ts +0 -12
  170. package/src/app/account-runtime.ts +0 -276
  171. package/src/app/bootstrap.ts +0 -29
  172. package/src/app/index.ts +0 -192
  173. package/src/capability/agent/delivery-service.ts +0 -87
  174. package/src/capability/agent/fallback-policy.ts +0 -13
  175. package/src/capability/agent/ingress-service.ts +0 -38
  176. package/src/capability/agent/upstream-delivery-service.ts +0 -96
  177. package/src/capability/bot/dispatch-config.ts +0 -47
  178. package/src/capability/bot/fallback-delivery.ts +0 -178
  179. package/src/capability/bot/local-path-delivery.ts +0 -215
  180. package/src/capability/bot/sandbox-media.test.ts +0 -221
  181. package/src/capability/bot/sandbox-media.ts +0 -176
  182. package/src/capability/bot/service.ts +0 -56
  183. package/src/capability/bot/stream-delivery.ts +0 -379
  184. package/src/capability/bot/stream-finalizer.ts +0 -120
  185. package/src/capability/bot/stream-orchestrator.ts +0 -371
  186. package/src/capability/bot/types.ts +0 -8
  187. package/src/capability/calendar/SKILLS_CHECKLIST.md +0 -251
  188. package/src/capability/calendar/tool.ts +0 -417
  189. package/src/capability/calendar/types.ts +0 -309
  190. package/src/capability/doc/tool.ts +0 -1629
  191. package/src/capability/doc/types.ts +0 -792
  192. package/src/capability/mcp/index.ts +0 -10
  193. package/src/capability/mcp/schema.ts +0 -107
  194. package/src/capability/mcp/tool.ts +0 -174
  195. package/src/capability/mcp/transport.ts +0 -394
  196. package/src/channel.config.test.ts +0 -147
  197. package/src/channel.lifecycle.test.ts +0 -255
  198. package/src/channel.meta.test.ts +0 -26
  199. package/src/channel.ts +0 -256
  200. package/src/config/accounts.resolve.test.ts +0 -75
  201. package/src/config/accounts.ts +0 -296
  202. package/src/config/derived-paths.test.ts +0 -111
  203. package/src/config/derived-paths.ts +0 -41
  204. package/src/config/index.ts +0 -26
  205. package/src/config/media.test.ts +0 -113
  206. package/src/config/media.ts +0 -139
  207. package/src/config/network.ts +0 -53
  208. package/src/config/routing.test.ts +0 -88
  209. package/src/config/routing.ts +0 -26
  210. package/src/config/runtime-config.ts +0 -46
  211. package/src/config/schema.ts +0 -90
  212. package/src/context-store.ts +0 -297
  213. package/src/crypto/index.ts +0 -24
  214. package/src/crypto.test.ts +0 -32
  215. package/src/crypto.ts +0 -176
  216. package/src/domain/models.ts +0 -7
  217. package/src/domain/policies.ts +0 -36
  218. package/src/dynamic-agent.account-scope.test.ts +0 -17
  219. package/src/gateway-monitor.ts +0 -181
  220. package/src/http.ts +0 -145
  221. package/src/media.test.ts +0 -82
  222. package/src/monitor/limits.ts +0 -7
  223. package/src/monitor/state.queue.test.ts +0 -185
  224. package/src/monitor/state.ts +0 -34
  225. package/src/monitor.active.test.ts +0 -245
  226. package/src/monitor.inbound-filter.test.ts +0 -63
  227. package/src/monitor.integration.test.ts +0 -208
  228. package/src/monitor.ts +0 -121
  229. package/src/monitor.webhook.test.ts +0 -774
  230. package/src/observability/audit-log.ts +0 -48
  231. package/src/observability/legacy-operational-event-store.ts +0 -36
  232. package/src/observability/raw-envelope-log.ts +0 -28
  233. package/src/observability/status-registry.ts +0 -13
  234. package/src/observability/transport-session-view.ts +0 -14
  235. package/src/onboarding.test.ts +0 -336
  236. package/src/onboarding.ts +0 -704
  237. package/src/outbound.test.ts +0 -1271
  238. package/src/outbound.ts +0 -746
  239. package/src/runtime/dispatcher.ts +0 -71
  240. package/src/runtime/outbound-intent.ts +0 -4
  241. package/src/runtime/reply-orchestrator.test.ts +0 -71
  242. package/src/runtime/reply-orchestrator.ts +0 -67
  243. package/src/runtime/routing-bridge.test.ts +0 -115
  244. package/src/runtime/routing-bridge.ts +0 -44
  245. package/src/runtime/session-manager.test.ts +0 -174
  246. package/src/runtime/session-manager.ts +0 -139
  247. package/src/runtime/source-registry.ts +0 -249
  248. package/src/runtime.ts +0 -14
  249. package/src/shared/command-auth.ts +0 -87
  250. package/src/shared/media-asset.ts +0 -78
  251. package/src/shared/media-service.test.ts +0 -111
  252. package/src/shared/media-service.ts +0 -84
  253. package/src/shared/media-types.ts +0 -5
  254. package/src/shared/xml-parser.test.ts +0 -50
  255. package/src/store/active-reply-store.ts +0 -42
  256. package/src/store/interfaces.ts +0 -11
  257. package/src/store/memory-store.ts +0 -43
  258. package/src/store/stream-batch-store.ts +0 -350
  259. package/src/transport/agent-api/client.ts +0 -277
  260. package/src/transport/agent-api/core.ts +0 -463
  261. package/src/transport/agent-api/delivery.ts +0 -41
  262. package/src/transport/agent-api/media-upload.ts +0 -11
  263. package/src/transport/agent-api/reply.ts +0 -39
  264. package/src/transport/agent-api/upstream-delivery.ts +0 -45
  265. package/src/transport/agent-api/upstream-media-upload.ts +0 -70
  266. package/src/transport/agent-api/upstream-reply.ts +0 -43
  267. package/src/transport/agent-callback/http-handler.ts +0 -47
  268. package/src/transport/agent-callback/inbound.ts +0 -5
  269. package/src/transport/agent-callback/reply.ts +0 -13
  270. package/src/transport/agent-callback/request-handler.ts +0 -244
  271. package/src/transport/agent-callback/session.ts +0 -23
  272. package/src/transport/bot-webhook/active-reply.ts +0 -39
  273. package/src/transport/bot-webhook/http-handler.ts +0 -48
  274. package/src/transport/bot-webhook/inbound-normalizer.test.ts +0 -433
  275. package/src/transport/bot-webhook/inbound-normalizer.ts +0 -558
  276. package/src/transport/bot-webhook/inbound.ts +0 -5
  277. package/src/transport/bot-webhook/message-shape.ts +0 -92
  278. package/src/transport/bot-webhook/protocol.ts +0 -148
  279. package/src/transport/bot-webhook/reply.ts +0 -15
  280. package/src/transport/bot-webhook/request-handler.ts +0 -394
  281. package/src/transport/bot-webhook/session.ts +0 -23
  282. package/src/transport/bot-ws/inbound.test.ts +0 -290
  283. package/src/transport/bot-ws/inbound.ts +0 -163
  284. package/src/transport/bot-ws/media.test.ts +0 -44
  285. package/src/transport/bot-ws/media.ts +0 -321
  286. package/src/transport/bot-ws/reply.test.ts +0 -450
  287. package/src/transport/bot-ws/reply.ts +0 -365
  288. package/src/transport/bot-ws/sdk-adapter.test.ts +0 -187
  289. package/src/transport/bot-ws/sdk-adapter.ts +0 -314
  290. package/src/transport/bot-ws/session.ts +0 -28
  291. package/src/transport/http/common.ts +0 -109
  292. package/src/transport/http/registry.ts +0 -92
  293. package/src/transport/http/request-handler.ts +0 -84
  294. package/src/types/account.ts +0 -70
  295. package/src/types/config.ts +0 -114
  296. package/src/types/constants.ts +0 -31
  297. package/src/types/events.ts +0 -21
  298. package/src/types/global.d.ts +0 -9
  299. package/src/types/index.ts +0 -17
  300. package/src/types/legacy-stream.ts +0 -50
  301. package/src/types/message.ts +0 -189
  302. package/src/types/runtime-context.ts +0 -28
  303. package/src/types/runtime.ts +0 -165
  304. package/src/types.ts +0 -41
  305. package/src/upstream/index.ts +0 -150
  306. package/src/upstream.test.ts +0 -84
  307. package/src/wecom_msg_adapter/markdown_adapter.ts +0 -331
  308. package/tsconfig.json +0 -22
  309. package/vitest.config.ts +0 -26
  310. /package/{src/capability/agent/index.ts → dist/src/capability/agent/index.js} +0 -0
  311. /package/{src/capability/bot/index.ts → dist/src/capability/bot/index.js} +0 -0
  312. /package/{src/capability/calendar/index.ts → dist/src/capability/calendar/index.js} +0 -0
  313. /package/{src/capability/index.ts → dist/src/capability/index.js} +0 -0
@@ -1,221 +0,0 @@
1
- import path from "node:path";
2
- import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
3
-
4
- import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
5
-
6
- import { stageWecomInboundMediaForSession } from "./sandbox-media.js";
7
-
8
- describe("stageWecomInboundMediaForSession", () => {
9
- const root = path.join("/tmp", `wecom-sandbox-stage-${process.pid}`);
10
-
11
- beforeEach(async () => {
12
- await mkdir(root, { recursive: true });
13
- });
14
-
15
- afterEach(async () => {
16
- vi.unstubAllEnvs();
17
- await rm(root, { recursive: true, force: true });
18
- });
19
-
20
- it("stages inbound media into the session sandbox workspace using channels.wecom.mediaMaxMb", async () => {
21
- const mediaPath = path.join(root, "openclaw-media", "inbound", "big.bin");
22
- const agentWorkspace = path.join(root, "agent-workspace");
23
- const sandboxRoot = path.join(root, "sandboxes");
24
-
25
- await mkdir(path.dirname(mediaPath), { recursive: true });
26
- await mkdir(agentWorkspace, { recursive: true });
27
- await writeFile(mediaPath, Buffer.alloc(6 * 1024 * 1024, 7));
28
-
29
- const staged = await stageWecomInboundMediaForSession({
30
- cfg: {
31
- channels: {
32
- wecom: {
33
- mediaMaxMb: 8,
34
- },
35
- },
36
- agents: {
37
- list: [
38
- {
39
- id: "ops",
40
- workspace: agentWorkspace,
41
- sandbox: {
42
- mode: "non-main",
43
- scope: "session",
44
- workspaceRoot: sandboxRoot,
45
- workspaceAccess: "ro",
46
- docker: {
47
- workdir: "/workspace",
48
- },
49
- },
50
- },
51
- ],
52
- },
53
- } as any,
54
- accountId: "default",
55
- agentId: "ops",
56
- sessionKey: "agent:ops:wecom:default:dm:zhangsan",
57
- mediaPath,
58
- filename: "big.bin",
59
- });
60
-
61
- expect(staged).toMatch(/^media\/inbound\/big\.bin$/);
62
- const sandboxEntries = await readdir(sandboxRoot);
63
- const stagedBuffer = await readFile(
64
- path.join(sandboxRoot, sandboxEntries[0]!, "media", "inbound", "big.bin"),
65
- );
66
- expect(stagedBuffer.byteLength).toBe(6 * 1024 * 1024);
67
- });
68
-
69
- it("uses the default sandbox workspace root when workspaceRoot is omitted", async () => {
70
- vi.stubEnv("OPENCLAW_STATE_DIR", root);
71
- const mediaPath = path.join(root, "openclaw-media", "inbound", "default-root.bin");
72
- const agentWorkspace = path.join(root, "agent-workspace");
73
-
74
- await mkdir(path.dirname(mediaPath), { recursive: true });
75
- await mkdir(agentWorkspace, { recursive: true });
76
- await writeFile(mediaPath, Buffer.alloc(2 * 1024 * 1024, 5));
77
-
78
- const staged = await stageWecomInboundMediaForSession({
79
- cfg: {
80
- channels: {
81
- wecom: {
82
- mediaMaxMb: 8,
83
- },
84
- },
85
- agents: {
86
- list: [
87
- {
88
- id: "ops",
89
- workspace: agentWorkspace,
90
- sandbox: {
91
- mode: "non-main",
92
- scope: "session",
93
- workspaceAccess: "ro",
94
- docker: {
95
- workdir: "/workspace",
96
- },
97
- },
98
- },
99
- ],
100
- },
101
- } as any,
102
- accountId: "default",
103
- agentId: "ops",
104
- sessionKey: "agent:ops:wecom:default:dm:lisi",
105
- mediaPath,
106
- filename: "default-root.bin",
107
- });
108
-
109
- expect(staged).toMatch(/^media\/inbound\/default-root\.bin$/);
110
- const sandboxEntries = await readdir(path.join(root, "sandboxes"));
111
- const stagedBuffer = await readFile(
112
- path.join(root, "sandboxes", sandboxEntries[0]!, "media", "inbound", "default-root.bin"),
113
- );
114
- expect(stagedBuffer.byteLength).toBe(2 * 1024 * 1024);
115
- });
116
-
117
- it("stages inbound media into the agent workspace for non-sandbox sessions", async () => {
118
- const mediaPath = path.join(root, "openclaw-media", "inbound", "small.bin");
119
- const agentWorkspace = path.join(root, "agent-workspace");
120
-
121
- await mkdir(path.dirname(mediaPath), { recursive: true });
122
- await mkdir(agentWorkspace, { recursive: true });
123
- await writeFile(mediaPath, Buffer.alloc(1024, 1));
124
-
125
- const staged = await stageWecomInboundMediaForSession({
126
- cfg: {
127
- channels: {
128
- wecom: {
129
- mediaMaxMb: 8,
130
- },
131
- },
132
- agents: {
133
- list: [
134
- {
135
- id: "ops",
136
- workspace: agentWorkspace,
137
- sandbox: {
138
- mode: "off",
139
- scope: "session",
140
- workspaceRoot: path.join(root, "sandboxes"),
141
- workspaceAccess: "ro",
142
- docker: {
143
- workdir: "/workspace",
144
- },
145
- },
146
- },
147
- ],
148
- },
149
- } as any,
150
- accountId: "default",
151
- agentId: "ops",
152
- sessionKey: "agent:ops:wecom:default:dm:zhangsan",
153
- mediaPath,
154
- filename: "small.bin",
155
- });
156
-
157
- expect(staged).toBe(path.join(agentWorkspace, "media", "inbound", "small.bin"));
158
- const stagedBuffer = await readFile(staged);
159
- expect(stagedBuffer.byteLength).toBe(1024);
160
- });
161
-
162
- it("allocates distinct staged filenames for concurrent same-name uploads", async () => {
163
- const mediaPathA = path.join(root, "openclaw-media", "inbound", "dup-a.bin");
164
- const mediaPathB = path.join(root, "openclaw-media", "inbound", "dup-b.bin");
165
- const agentWorkspace = path.join(root, "agent-workspace");
166
-
167
- await mkdir(path.dirname(mediaPathA), { recursive: true });
168
- await mkdir(agentWorkspace, { recursive: true });
169
- await writeFile(mediaPathA, Buffer.from("first"));
170
- await writeFile(mediaPathB, Buffer.from("second"));
171
-
172
- const cfg = {
173
- channels: {
174
- wecom: {
175
- mediaMaxMb: 8,
176
- },
177
- },
178
- agents: {
179
- list: [
180
- {
181
- id: "ops",
182
- workspace: agentWorkspace,
183
- sandbox: {
184
- mode: "off",
185
- scope: "session",
186
- workspaceAccess: "ro",
187
- docker: {
188
- workdir: "/workspace",
189
- },
190
- },
191
- },
192
- ],
193
- },
194
- } as any;
195
-
196
- const [stagedA, stagedB] = await Promise.all([
197
- stageWecomInboundMediaForSession({
198
- cfg,
199
- accountId: "default",
200
- agentId: "ops",
201
- sessionKey: "agent:ops:wecom:default:dm:zhangsan",
202
- mediaPath: mediaPathA,
203
- filename: "dup.bin",
204
- }),
205
- stageWecomInboundMediaForSession({
206
- cfg,
207
- accountId: "default",
208
- agentId: "ops",
209
- sessionKey: "agent:ops:wecom:default:dm:lisi",
210
- mediaPath: mediaPathB,
211
- filename: "dup.bin",
212
- }),
213
- ]);
214
-
215
- expect(stagedA).not.toBe(stagedB);
216
- expect([path.basename(stagedA), path.basename(stagedB)].sort()).toEqual(["dup-1.bin", "dup.bin"]);
217
- expect((await readFile(stagedA)).toString()).toMatch(/first|second/);
218
- expect((await readFile(stagedB)).toString()).toMatch(/first|second/);
219
- expect((await readFile(stagedA)).toString()).not.toBe((await readFile(stagedB)).toString());
220
- });
221
- });
@@ -1,176 +0,0 @@
1
- import crypto from "node:crypto";
2
- import { constants } from "node:fs";
3
- import os from "node:os";
4
- import path from "node:path";
5
- import { copyFile, mkdir, stat } from "node:fs/promises";
6
-
7
- import type { OpenClawConfig } from "openclaw/plugin-sdk";
8
- import { resolveAgentConfig, resolveAgentWorkspaceDir } from "openclaw/plugin-sdk/agent-runtime";
9
-
10
- import { resolveWecomMediaMaxBytes } from "../../config/index.js";
11
-
12
- function expandHomeDir(input: string): string {
13
- if (input === "~") return os.homedir();
14
- if (input.startsWith("~/")) return path.join(os.homedir(), input.slice(2));
15
- return input;
16
- }
17
-
18
- function resolveOpenClawStateDir(): string {
19
- const override = process.env.OPENCLAW_STATE_DIR?.trim() || process.env.CLAWDBOT_STATE_DIR?.trim();
20
- if (override) {
21
- return path.resolve(expandHomeDir(override));
22
- }
23
- return path.join(os.homedir(), ".openclaw");
24
- }
25
-
26
- function normalizeAgentId(agentId: string): string {
27
- return agentId.trim().toLowerCase() || "main";
28
- }
29
-
30
- function normalizeMainKey(mainKey: unknown): string {
31
- return typeof mainKey === "string" && mainKey.trim() ? mainKey.trim().toLowerCase() : "main";
32
- }
33
-
34
- function buildAgentMainSessionKey(cfg: OpenClawConfig, agentId: string): string {
35
- if (cfg.session?.scope === "global") {
36
- return "global";
37
- }
38
- return `agent:${normalizeAgentId(agentId)}:${normalizeMainKey(cfg.session?.mainKey)}`;
39
- }
40
-
41
- function slugifySessionKey(value: string): string {
42
- const trimmed = value.trim() || "session";
43
- const hash = crypto.createHash("sha256").update(trimmed).digest("hex").slice(0, 8);
44
- const prefix =
45
- trimmed
46
- .toLowerCase()
47
- .replace(/[^a-z0-9._-]+/g, "-")
48
- .replace(/^-+|-+$/g, "")
49
- .slice(0, 32) || "session";
50
- return `${prefix}-${hash}`;
51
- }
52
-
53
- function isSandboxedSession(params: {
54
- cfg: OpenClawConfig;
55
- agentId: string;
56
- sessionKey: string;
57
- }): boolean {
58
- const sandbox = resolveAgentConfig(params.cfg, params.agentId)?.sandbox;
59
- if (!sandbox || sandbox.mode === "off") {
60
- return false;
61
- }
62
- if (sandbox.mode === "all") {
63
- return true;
64
- }
65
- return params.sessionKey.trim().toLowerCase() !== buildAgentMainSessionKey(params.cfg, params.agentId);
66
- }
67
-
68
- function resolveSessionWorkspaceTarget(params: {
69
- cfg: OpenClawConfig;
70
- agentId: string;
71
- sessionKey: string;
72
- }): { workspaceDir: string; sandboxed: boolean } {
73
- const sandbox = resolveAgentConfig(params.cfg, params.agentId)?.sandbox;
74
- const agentWorkspaceDirRaw = resolveAgentWorkspaceDir(params.cfg, params.agentId);
75
- const agentWorkspaceDir = path.resolve(expandHomeDir(agentWorkspaceDirRaw || process.cwd()));
76
- if (!sandbox || !isSandboxedSession(params)) {
77
- return {
78
- workspaceDir: agentWorkspaceDir,
79
- sandboxed: false,
80
- };
81
- }
82
- if (sandbox.workspaceAccess === "rw" || !sandbox.workspaceRoot) {
83
- if (sandbox.workspaceAccess === "rw") {
84
- return {
85
- workspaceDir: agentWorkspaceDir,
86
- sandboxed: true,
87
- };
88
- }
89
- return {
90
- workspaceDir: path.join(resolveOpenClawStateDir(), "sandboxes", slugifySessionKey(params.sessionKey.trim() || "main")),
91
- sandboxed: true,
92
- };
93
- }
94
-
95
- const workspaceRoot = path.resolve(expandHomeDir(sandbox.workspaceRoot));
96
- const scopeKey =
97
- sandbox.scope === "shared"
98
- ? "shared"
99
- : sandbox.scope === "session"
100
- ? params.sessionKey.trim() || "main"
101
- : `agent:${normalizeAgentId(params.agentId)}`;
102
- if (sandbox.scope === "shared") {
103
- return {
104
- workspaceDir: workspaceRoot,
105
- sandboxed: true,
106
- };
107
- }
108
- return {
109
- workspaceDir: path.join(workspaceRoot, slugifySessionKey(scopeKey)),
110
- sandboxed: true,
111
- };
112
- }
113
-
114
- function buildStagedFilenameCandidate(parsed: path.ParsedPath, suffix: number): string {
115
- if (suffix === 0) {
116
- return parsed.base || "attachment";
117
- }
118
- return `${parsed.name || "attachment"}-${suffix}${parsed.ext}`;
119
- }
120
-
121
- async function copyIntoWorkspaceInbound(params: {
122
- sourcePath: string;
123
- workspaceDir: string;
124
- filename: string;
125
- }): Promise<{ absolutePath: string; relativePath: string }> {
126
- const inboundDir = path.join(params.workspaceDir, "media", "inbound");
127
- await mkdir(inboundDir, { recursive: true });
128
-
129
- const parsed = path.parse(params.filename);
130
- for (let suffix = 0; ; suffix += 1) {
131
- const candidate = buildStagedFilenameCandidate(parsed, suffix);
132
- const absolutePath = path.join(inboundDir, candidate);
133
- try {
134
- await copyFile(params.sourcePath, absolutePath, constants.COPYFILE_EXCL);
135
- return {
136
- absolutePath,
137
- relativePath: path.posix.join("media", "inbound", candidate),
138
- };
139
- } catch (error) {
140
- if ((error as NodeJS.ErrnoException)?.code === "EEXIST") {
141
- continue;
142
- }
143
- throw error;
144
- }
145
- }
146
- }
147
-
148
- export async function stageWecomInboundMediaForSession(params: {
149
- cfg: OpenClawConfig;
150
- accountId: string;
151
- agentId: string;
152
- sessionKey: string;
153
- mediaPath: string;
154
- filename?: string;
155
- }): Promise<string> {
156
- const target = resolveSessionWorkspaceTarget({
157
- cfg: params.cfg,
158
- agentId: params.agentId,
159
- sessionKey: params.sessionKey,
160
- });
161
-
162
- const maxBytes = resolveWecomMediaMaxBytes(params.cfg, params.accountId);
163
- const sourceStat = await stat(params.mediaPath);
164
- if (sourceStat.size > maxBytes) {
165
- throw new Error(
166
- `Inbound media size ${(sourceStat.size / (1024 * 1024)).toFixed(2)}MB exceeds channels.wecom.mediaMaxMb ${(maxBytes / (1024 * 1024)).toFixed(2)}MB before workspace staging`,
167
- );
168
- }
169
-
170
- const staged = await copyIntoWorkspaceInbound({
171
- sourcePath: params.mediaPath,
172
- workspaceDir: target.workspaceDir,
173
- filename: params.filename || path.basename(params.mediaPath),
174
- });
175
- return target.sandboxed ? staged.relativePath : staged.absolutePath;
176
- }
@@ -1,56 +0,0 @@
1
- import type { OpenClawConfig } from "openclaw/plugin-sdk";
2
-
3
- import type { WecomRuntimeEnv } from "../../types/runtime-context.js";
4
- import type { WecomAccountRuntime } from "../../app/account-runtime.js";
5
- import { BotWsSdkAdapter } from "../../transport/bot-ws/sdk-adapter.js";
6
- import { startBotWebhookTransport } from "../../transport/bot-webhook/http-handler.js";
7
-
8
- export class WecomBotCapabilityService {
9
- private wsAdapter?: BotWsSdkAdapter;
10
- private stopTransport?: () => void;
11
-
12
- constructor(
13
- private readonly runtime: WecomAccountRuntime,
14
- private readonly cfg: OpenClawConfig,
15
- private readonly runtimeEnv: WecomRuntimeEnv,
16
- ) {}
17
-
18
- start(): { transport: "bot-ws" | "bot-webhook"; descriptors: string[] } | undefined {
19
- const bot = this.runtime.account.bot;
20
- if (!bot?.configured) {
21
- return undefined;
22
- }
23
-
24
- if (bot.primaryTransport === "ws") {
25
- this.wsAdapter = new BotWsSdkAdapter(this.runtime, {
26
- info: this.runtimeEnv.log,
27
- warn: this.runtimeEnv.log,
28
- error: this.runtimeEnv.error,
29
- });
30
- this.wsAdapter.start();
31
- this.stopTransport = () => this.wsAdapter?.stop();
32
- return {
33
- transport: "bot-ws",
34
- descriptors: ["ws:primary"],
35
- };
36
- }
37
-
38
- const webhook = startBotWebhookTransport({
39
- account: bot,
40
- cfg: this.cfg,
41
- runtime: this.runtime,
42
- runtimeEnv: this.runtimeEnv,
43
- });
44
- this.stopTransport = webhook.stop;
45
- return {
46
- transport: "bot-webhook",
47
- descriptors: webhook.paths,
48
- };
49
- }
50
-
51
- stop(): void {
52
- this.stopTransport?.();
53
- this.stopTransport = undefined;
54
- this.wsAdapter = undefined;
55
- }
56
- }