lightclawbot 1.0.0 → 1.0.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 (371) hide show
  1. package/README.md +1 -0
  2. package/dist/index.d.ts +24 -0
  3. package/dist/index.d.ts.map +1 -0
  4. package/dist/index.js +34 -0
  5. package/dist/index.js.map +1 -0
  6. package/dist/src/channel.d.ts +11 -0
  7. package/dist/src/channel.d.ts.map +1 -0
  8. package/dist/src/channel.js +255 -0
  9. package/dist/src/channel.js.map +1 -0
  10. package/dist/src/config.d.ts +86 -0
  11. package/dist/src/config.d.ts.map +1 -0
  12. package/dist/src/config.js +188 -0
  13. package/dist/src/config.js.map +1 -0
  14. package/dist/src/dedup.d.ts +7 -0
  15. package/dist/src/dedup.d.ts.map +1 -0
  16. package/dist/src/dedup.js +51 -0
  17. package/dist/src/dedup.js.map +1 -0
  18. package/dist/src/download-tool.d.ts +32 -0
  19. package/dist/src/download-tool.d.ts.map +1 -0
  20. package/dist/src/download-tool.js +147 -0
  21. package/dist/src/download-tool.js.map +1 -0
  22. package/dist/src/file-storage.d.ts +74 -0
  23. package/dist/src/file-storage.d.ts.map +1 -0
  24. package/dist/src/file-storage.js +161 -0
  25. package/dist/src/file-storage.js.map +1 -0
  26. package/dist/src/gateway.d.ts +16 -0
  27. package/dist/src/gateway.d.ts.map +1 -0
  28. package/dist/src/gateway.js +252 -0
  29. package/dist/src/gateway.js.map +1 -0
  30. package/dist/src/history/cron-utils.d.ts +76 -0
  31. package/dist/src/history/cron-utils.d.ts.map +1 -0
  32. package/dist/src/history/cron-utils.js +291 -0
  33. package/dist/src/history/cron-utils.js.map +1 -0
  34. package/dist/src/history/index.d.ts +20 -0
  35. package/dist/src/history/index.d.ts.map +1 -0
  36. package/dist/src/history/index.js +24 -0
  37. package/dist/src/history/index.js.map +1 -0
  38. package/dist/src/history/message-parser.d.ts +52 -0
  39. package/dist/src/history/message-parser.d.ts.map +1 -0
  40. package/dist/src/history/message-parser.js +243 -0
  41. package/dist/src/history/message-parser.js.map +1 -0
  42. package/dist/src/history/session-reader.d.ts +58 -0
  43. package/dist/src/history/session-reader.d.ts.map +1 -0
  44. package/dist/src/history/session-reader.js +287 -0
  45. package/dist/src/history/session-reader.js.map +1 -0
  46. package/dist/src/history/session-store.d.ts +38 -0
  47. package/dist/src/history/session-store.d.ts.map +1 -0
  48. package/dist/src/history/session-store.js +131 -0
  49. package/dist/src/history/session-store.js.map +1 -0
  50. package/dist/src/history/text-processing.d.ts +41 -0
  51. package/dist/src/history/text-processing.d.ts.map +1 -0
  52. package/dist/src/history/text-processing.js +130 -0
  53. package/dist/src/history/text-processing.js.map +1 -0
  54. package/dist/src/history/types.d.ts +134 -0
  55. package/dist/src/history/types.d.ts.map +1 -0
  56. package/dist/src/history/types.js +7 -0
  57. package/dist/src/history/types.js.map +1 -0
  58. package/dist/src/inbound.d.ts +18 -0
  59. package/dist/src/inbound.d.ts.map +1 -0
  60. package/dist/src/inbound.js +332 -0
  61. package/dist/src/inbound.js.map +1 -0
  62. package/dist/src/media.d.ts +12 -0
  63. package/dist/src/media.d.ts.map +1 -0
  64. package/dist/src/media.js +87 -0
  65. package/dist/src/media.js.map +1 -0
  66. package/dist/src/outbound.d.ts +28 -0
  67. package/dist/src/outbound.d.ts.map +1 -0
  68. package/dist/src/outbound.js +172 -0
  69. package/dist/src/outbound.js.map +1 -0
  70. package/dist/src/runtime.d.ts +4 -0
  71. package/dist/src/runtime.d.ts.map +1 -0
  72. package/dist/src/runtime.js +11 -0
  73. package/dist/src/runtime.js.map +1 -0
  74. package/dist/src/session-history.d.ts +88 -0
  75. package/dist/src/session-history.d.ts.map +1 -0
  76. package/dist/src/session-history.js +598 -0
  77. package/dist/src/session-history.js.map +1 -0
  78. package/dist/src/socket-handlers.d.ts +21 -0
  79. package/dist/src/socket-handlers.d.ts.map +1 -0
  80. package/dist/src/socket-handlers.js +121 -0
  81. package/dist/src/socket-handlers.js.map +1 -0
  82. package/dist/src/socket-registry.d.ts +53 -0
  83. package/dist/src/socket-registry.d.ts.map +1 -0
  84. package/dist/src/socket-registry.js +111 -0
  85. package/dist/src/socket-registry.js.map +1 -0
  86. package/dist/src/types.d.ts +102 -0
  87. package/dist/src/types.d.ts.map +1 -0
  88. package/dist/src/types.js +10 -0
  89. package/dist/src/types.js.map +1 -0
  90. package/dist/src/upload-tool.d.ts +27 -0
  91. package/dist/src/upload-tool.d.ts.map +1 -0
  92. package/dist/src/upload-tool.js +148 -0
  93. package/dist/src/upload-tool.js.map +1 -0
  94. package/node_modules/@socket.io/component-emitter/LICENSE +24 -0
  95. package/node_modules/@socket.io/component-emitter/Readme.md +79 -0
  96. package/node_modules/@socket.io/component-emitter/lib/cjs/index.d.ts +179 -0
  97. package/node_modules/@socket.io/component-emitter/lib/cjs/index.js +176 -0
  98. package/node_modules/@socket.io/component-emitter/lib/cjs/package.json +4 -0
  99. package/node_modules/@socket.io/component-emitter/lib/esm/index.d.ts +179 -0
  100. package/node_modules/@socket.io/component-emitter/lib/esm/index.js +169 -0
  101. package/node_modules/@socket.io/component-emitter/lib/esm/package.json +4 -0
  102. package/node_modules/@socket.io/component-emitter/package.json +28 -0
  103. package/node_modules/debug/LICENSE +20 -0
  104. package/node_modules/debug/README.md +481 -0
  105. package/node_modules/debug/package.json +64 -0
  106. package/node_modules/debug/src/browser.js +272 -0
  107. package/node_modules/debug/src/common.js +292 -0
  108. package/node_modules/debug/src/index.js +10 -0
  109. package/node_modules/debug/src/node.js +263 -0
  110. package/node_modules/engine.io-client/LICENSE +22 -0
  111. package/node_modules/engine.io-client/README.md +331 -0
  112. package/node_modules/engine.io-client/build/cjs/browser-entrypoint.d.ts +3 -0
  113. package/node_modules/engine.io-client/build/cjs/browser-entrypoint.js +4 -0
  114. package/node_modules/engine.io-client/build/cjs/contrib/has-cors.d.ts +1 -0
  115. package/node_modules/engine.io-client/build/cjs/contrib/has-cors.js +14 -0
  116. package/node_modules/engine.io-client/build/cjs/contrib/parseqs.d.ts +15 -0
  117. package/node_modules/engine.io-client/build/cjs/contrib/parseqs.js +38 -0
  118. package/node_modules/engine.io-client/build/cjs/contrib/parseuri.d.ts +1 -0
  119. package/node_modules/engine.io-client/build/cjs/contrib/parseuri.js +67 -0
  120. package/node_modules/engine.io-client/build/cjs/globals.d.ts +4 -0
  121. package/node_modules/engine.io-client/build/cjs/globals.js +26 -0
  122. package/node_modules/engine.io-client/build/cjs/globals.node.d.ts +21 -0
  123. package/node_modules/engine.io-client/build/cjs/globals.node.js +97 -0
  124. package/node_modules/engine.io-client/build/cjs/index.d.ts +15 -0
  125. package/node_modules/engine.io-client/build/cjs/index.js +32 -0
  126. package/node_modules/engine.io-client/build/cjs/package.json +10 -0
  127. package/node_modules/engine.io-client/build/cjs/socket.d.ts +482 -0
  128. package/node_modules/engine.io-client/build/cjs/socket.js +765 -0
  129. package/node_modules/engine.io-client/build/cjs/transport.d.ts +106 -0
  130. package/node_modules/engine.io-client/build/cjs/transport.js +153 -0
  131. package/node_modules/engine.io-client/build/cjs/transports/index.d.ts +8 -0
  132. package/node_modules/engine.io-client/build/cjs/transports/index.js +11 -0
  133. package/node_modules/engine.io-client/build/cjs/transports/polling-fetch.d.ts +15 -0
  134. package/node_modules/engine.io-client/build/cjs/transports/polling-fetch.js +60 -0
  135. package/node_modules/engine.io-client/build/cjs/transports/polling-xhr.d.ts +108 -0
  136. package/node_modules/engine.io-client/build/cjs/transports/polling-xhr.js +285 -0
  137. package/node_modules/engine.io-client/build/cjs/transports/polling-xhr.node.d.ts +11 -0
  138. package/node_modules/engine.io-client/build/cjs/transports/polling-xhr.node.js +44 -0
  139. package/node_modules/engine.io-client/build/cjs/transports/polling.d.ts +52 -0
  140. package/node_modules/engine.io-client/build/cjs/transports/polling.js +165 -0
  141. package/node_modules/engine.io-client/build/cjs/transports/websocket.d.ts +36 -0
  142. package/node_modules/engine.io-client/build/cjs/transports/websocket.js +136 -0
  143. package/node_modules/engine.io-client/build/cjs/transports/websocket.node.d.ts +14 -0
  144. package/node_modules/engine.io-client/build/cjs/transports/websocket.node.js +68 -0
  145. package/node_modules/engine.io-client/build/cjs/transports/webtransport.d.ts +18 -0
  146. package/node_modules/engine.io-client/build/cjs/transports/webtransport.js +94 -0
  147. package/node_modules/engine.io-client/build/cjs/util.d.ts +7 -0
  148. package/node_modules/engine.io-client/build/cjs/util.js +65 -0
  149. package/node_modules/engine.io-client/build/esm/browser-entrypoint.d.ts +3 -0
  150. package/node_modules/engine.io-client/build/esm/browser-entrypoint.js +2 -0
  151. package/node_modules/engine.io-client/build/esm/contrib/has-cors.d.ts +1 -0
  152. package/node_modules/engine.io-client/build/esm/contrib/has-cors.js +11 -0
  153. package/node_modules/engine.io-client/build/esm/contrib/parseqs.d.ts +15 -0
  154. package/node_modules/engine.io-client/build/esm/contrib/parseqs.js +34 -0
  155. package/node_modules/engine.io-client/build/esm/contrib/parseuri.d.ts +1 -0
  156. package/node_modules/engine.io-client/build/esm/contrib/parseuri.js +64 -0
  157. package/node_modules/engine.io-client/build/esm/globals.d.ts +4 -0
  158. package/node_modules/engine.io-client/build/esm/globals.js +22 -0
  159. package/node_modules/engine.io-client/build/esm/globals.node.d.ts +21 -0
  160. package/node_modules/engine.io-client/build/esm/globals.node.js +91 -0
  161. package/node_modules/engine.io-client/build/esm/index.d.ts +15 -0
  162. package/node_modules/engine.io-client/build/esm/index.js +15 -0
  163. package/node_modules/engine.io-client/build/esm/package.json +10 -0
  164. package/node_modules/engine.io-client/build/esm/socket.d.ts +482 -0
  165. package/node_modules/engine.io-client/build/esm/socket.js +727 -0
  166. package/node_modules/engine.io-client/build/esm/transport.d.ts +106 -0
  167. package/node_modules/engine.io-client/build/esm/transport.js +142 -0
  168. package/node_modules/engine.io-client/build/esm/transports/index.d.ts +8 -0
  169. package/node_modules/engine.io-client/build/esm/transports/index.js +8 -0
  170. package/node_modules/engine.io-client/build/esm/transports/polling-fetch.d.ts +15 -0
  171. package/node_modules/engine.io-client/build/esm/transports/polling-fetch.js +56 -0
  172. package/node_modules/engine.io-client/build/esm/transports/polling-xhr.d.ts +108 -0
  173. package/node_modules/engine.io-client/build/esm/transports/polling-xhr.js +271 -0
  174. package/node_modules/engine.io-client/build/esm/transports/polling-xhr.node.d.ts +11 -0
  175. package/node_modules/engine.io-client/build/esm/transports/polling-xhr.node.js +17 -0
  176. package/node_modules/engine.io-client/build/esm/transports/polling.d.ts +52 -0
  177. package/node_modules/engine.io-client/build/esm/transports/polling.js +145 -0
  178. package/node_modules/engine.io-client/build/esm/transports/websocket.d.ts +36 -0
  179. package/node_modules/engine.io-client/build/esm/transports/websocket.js +125 -0
  180. package/node_modules/engine.io-client/build/esm/transports/websocket.node.d.ts +14 -0
  181. package/node_modules/engine.io-client/build/esm/transports/websocket.node.js +41 -0
  182. package/node_modules/engine.io-client/build/esm/transports/webtransport.d.ts +18 -0
  183. package/node_modules/engine.io-client/build/esm/transports/webtransport.js +80 -0
  184. package/node_modules/engine.io-client/build/esm/util.d.ts +7 -0
  185. package/node_modules/engine.io-client/build/esm/util.js +59 -0
  186. package/node_modules/engine.io-client/build/esm-debug/browser-entrypoint.d.ts +3 -0
  187. package/node_modules/engine.io-client/build/esm-debug/browser-entrypoint.js +2 -0
  188. package/node_modules/engine.io-client/build/esm-debug/contrib/has-cors.d.ts +1 -0
  189. package/node_modules/engine.io-client/build/esm-debug/contrib/has-cors.js +11 -0
  190. package/node_modules/engine.io-client/build/esm-debug/contrib/parseqs.d.ts +15 -0
  191. package/node_modules/engine.io-client/build/esm-debug/contrib/parseqs.js +34 -0
  192. package/node_modules/engine.io-client/build/esm-debug/contrib/parseuri.d.ts +1 -0
  193. package/node_modules/engine.io-client/build/esm-debug/contrib/parseuri.js +64 -0
  194. package/node_modules/engine.io-client/build/esm-debug/globals.d.ts +4 -0
  195. package/node_modules/engine.io-client/build/esm-debug/globals.js +22 -0
  196. package/node_modules/engine.io-client/build/esm-debug/globals.node.d.ts +21 -0
  197. package/node_modules/engine.io-client/build/esm-debug/globals.node.js +91 -0
  198. package/node_modules/engine.io-client/build/esm-debug/index.d.ts +15 -0
  199. package/node_modules/engine.io-client/build/esm-debug/index.js +15 -0
  200. package/node_modules/engine.io-client/build/esm-debug/package.json +10 -0
  201. package/node_modules/engine.io-client/build/esm-debug/socket.d.ts +482 -0
  202. package/node_modules/engine.io-client/build/esm-debug/socket.js +756 -0
  203. package/node_modules/engine.io-client/build/esm-debug/transport.d.ts +106 -0
  204. package/node_modules/engine.io-client/build/esm-debug/transport.js +145 -0
  205. package/node_modules/engine.io-client/build/esm-debug/transports/index.d.ts +8 -0
  206. package/node_modules/engine.io-client/build/esm-debug/transports/index.js +8 -0
  207. package/node_modules/engine.io-client/build/esm-debug/transports/polling-fetch.d.ts +15 -0
  208. package/node_modules/engine.io-client/build/esm-debug/transports/polling-fetch.js +56 -0
  209. package/node_modules/engine.io-client/build/esm-debug/transports/polling-xhr.d.ts +108 -0
  210. package/node_modules/engine.io-client/build/esm-debug/transports/polling-xhr.js +276 -0
  211. package/node_modules/engine.io-client/build/esm-debug/transports/polling-xhr.node.d.ts +11 -0
  212. package/node_modules/engine.io-client/build/esm-debug/transports/polling-xhr.node.js +17 -0
  213. package/node_modules/engine.io-client/build/esm-debug/transports/polling.d.ts +52 -0
  214. package/node_modules/engine.io-client/build/esm-debug/transports/polling.js +158 -0
  215. package/node_modules/engine.io-client/build/esm-debug/transports/websocket.d.ts +36 -0
  216. package/node_modules/engine.io-client/build/esm-debug/transports/websocket.js +128 -0
  217. package/node_modules/engine.io-client/build/esm-debug/transports/websocket.node.d.ts +14 -0
  218. package/node_modules/engine.io-client/build/esm-debug/transports/websocket.node.js +41 -0
  219. package/node_modules/engine.io-client/build/esm-debug/transports/webtransport.d.ts +18 -0
  220. package/node_modules/engine.io-client/build/esm-debug/transports/webtransport.js +87 -0
  221. package/node_modules/engine.io-client/build/esm-debug/util.d.ts +7 -0
  222. package/node_modules/engine.io-client/build/esm-debug/util.js +59 -0
  223. package/node_modules/engine.io-client/dist/engine.io.esm.min.js +7 -0
  224. package/node_modules/engine.io-client/dist/engine.io.esm.min.js.map +1 -0
  225. package/node_modules/engine.io-client/dist/engine.io.js +3064 -0
  226. package/node_modules/engine.io-client/dist/engine.io.js.map +1 -0
  227. package/node_modules/engine.io-client/dist/engine.io.min.js +7 -0
  228. package/node_modules/engine.io-client/dist/engine.io.min.js.map +1 -0
  229. package/node_modules/engine.io-client/node_modules/ws/LICENSE +20 -0
  230. package/node_modules/engine.io-client/node_modules/ws/README.md +548 -0
  231. package/node_modules/engine.io-client/node_modules/ws/browser.js +8 -0
  232. package/node_modules/engine.io-client/node_modules/ws/index.js +13 -0
  233. package/node_modules/engine.io-client/node_modules/ws/lib/buffer-util.js +131 -0
  234. package/node_modules/engine.io-client/node_modules/ws/lib/constants.js +18 -0
  235. package/node_modules/engine.io-client/node_modules/ws/lib/event-target.js +292 -0
  236. package/node_modules/engine.io-client/node_modules/ws/lib/extension.js +203 -0
  237. package/node_modules/engine.io-client/node_modules/ws/lib/limiter.js +55 -0
  238. package/node_modules/engine.io-client/node_modules/ws/lib/permessage-deflate.js +528 -0
  239. package/node_modules/engine.io-client/node_modules/ws/lib/receiver.js +706 -0
  240. package/node_modules/engine.io-client/node_modules/ws/lib/sender.js +602 -0
  241. package/node_modules/engine.io-client/node_modules/ws/lib/stream.js +161 -0
  242. package/node_modules/engine.io-client/node_modules/ws/lib/subprotocol.js +62 -0
  243. package/node_modules/engine.io-client/node_modules/ws/lib/validation.js +152 -0
  244. package/node_modules/engine.io-client/node_modules/ws/lib/websocket-server.js +550 -0
  245. package/node_modules/engine.io-client/node_modules/ws/lib/websocket.js +1388 -0
  246. package/node_modules/engine.io-client/node_modules/ws/package.json +69 -0
  247. package/node_modules/engine.io-client/node_modules/ws/wrapper.mjs +8 -0
  248. package/node_modules/engine.io-client/package.json +95 -0
  249. package/node_modules/engine.io-parser/LICENSE +22 -0
  250. package/node_modules/engine.io-parser/Readme.md +158 -0
  251. package/node_modules/engine.io-parser/build/cjs/commons.d.ts +14 -0
  252. package/node_modules/engine.io-parser/build/cjs/commons.js +19 -0
  253. package/node_modules/engine.io-parser/build/cjs/contrib/base64-arraybuffer.d.ts +2 -0
  254. package/node_modules/engine.io-parser/build/cjs/contrib/base64-arraybuffer.js +48 -0
  255. package/node_modules/engine.io-parser/build/cjs/decodePacket.browser.d.ts +2 -0
  256. package/node_modules/engine.io-parser/build/cjs/decodePacket.browser.js +66 -0
  257. package/node_modules/engine.io-parser/build/cjs/decodePacket.d.ts +2 -0
  258. package/node_modules/engine.io-parser/build/cjs/decodePacket.js +59 -0
  259. package/node_modules/engine.io-parser/build/cjs/encodePacket.browser.d.ts +4 -0
  260. package/node_modules/engine.io-parser/build/cjs/encodePacket.browser.js +72 -0
  261. package/node_modules/engine.io-parser/build/cjs/encodePacket.d.ts +3 -0
  262. package/node_modules/engine.io-parser/build/cjs/encodePacket.js +38 -0
  263. package/node_modules/engine.io-parser/build/cjs/index.d.ts +9 -0
  264. package/node_modules/engine.io-parser/build/cjs/index.js +164 -0
  265. package/node_modules/engine.io-parser/build/cjs/package.json +8 -0
  266. package/node_modules/engine.io-parser/build/esm/commons.d.ts +14 -0
  267. package/node_modules/engine.io-parser/build/esm/commons.js +14 -0
  268. package/node_modules/engine.io-parser/build/esm/contrib/base64-arraybuffer.d.ts +2 -0
  269. package/node_modules/engine.io-parser/build/esm/contrib/base64-arraybuffer.js +43 -0
  270. package/node_modules/engine.io-parser/build/esm/decodePacket.browser.d.ts +2 -0
  271. package/node_modules/engine.io-parser/build/esm/decodePacket.browser.js +62 -0
  272. package/node_modules/engine.io-parser/build/esm/decodePacket.d.ts +2 -0
  273. package/node_modules/engine.io-parser/build/esm/decodePacket.js +55 -0
  274. package/node_modules/engine.io-parser/build/esm/encodePacket.browser.d.ts +4 -0
  275. package/node_modules/engine.io-parser/build/esm/encodePacket.browser.js +68 -0
  276. package/node_modules/engine.io-parser/build/esm/encodePacket.d.ts +3 -0
  277. package/node_modules/engine.io-parser/build/esm/encodePacket.js +33 -0
  278. package/node_modules/engine.io-parser/build/esm/index.d.ts +9 -0
  279. package/node_modules/engine.io-parser/build/esm/index.js +156 -0
  280. package/node_modules/engine.io-parser/build/esm/package.json +8 -0
  281. package/node_modules/engine.io-parser/package.json +46 -0
  282. package/node_modules/ms/index.js +162 -0
  283. package/node_modules/ms/license.md +21 -0
  284. package/node_modules/ms/package.json +38 -0
  285. package/node_modules/ms/readme.md +59 -0
  286. package/node_modules/socket.io-client/LICENSE +21 -0
  287. package/node_modules/socket.io-client/README.md +29 -0
  288. package/node_modules/socket.io-client/build/cjs/browser-entrypoint.d.ts +2 -0
  289. package/node_modules/socket.io-client/build/cjs/browser-entrypoint.js +4 -0
  290. package/node_modules/socket.io-client/build/cjs/contrib/backo2.d.ts +12 -0
  291. package/node_modules/socket.io-client/build/cjs/contrib/backo2.js +69 -0
  292. package/node_modules/socket.io-client/build/cjs/index.d.ts +29 -0
  293. package/node_modules/socket.io-client/build/cjs/index.js +76 -0
  294. package/node_modules/socket.io-client/build/cjs/manager.d.ts +295 -0
  295. package/node_modules/socket.io-client/build/cjs/manager.js +416 -0
  296. package/node_modules/socket.io-client/build/cjs/on.d.ts +2 -0
  297. package/node_modules/socket.io-client/build/cjs/on.js +9 -0
  298. package/node_modules/socket.io-client/build/cjs/socket.d.ts +593 -0
  299. package/node_modules/socket.io-client/build/cjs/socket.js +909 -0
  300. package/node_modules/socket.io-client/build/cjs/url.d.ts +33 -0
  301. package/node_modules/socket.io-client/build/cjs/url.js +69 -0
  302. package/node_modules/socket.io-client/build/esm/browser-entrypoint.d.ts +2 -0
  303. package/node_modules/socket.io-client/build/esm/browser-entrypoint.js +2 -0
  304. package/node_modules/socket.io-client/build/esm/contrib/backo2.d.ts +12 -0
  305. package/node_modules/socket.io-client/build/esm/contrib/backo2.js +66 -0
  306. package/node_modules/socket.io-client/build/esm/index.d.ts +29 -0
  307. package/node_modules/socket.io-client/build/esm/index.js +58 -0
  308. package/node_modules/socket.io-client/build/esm/manager.d.ts +295 -0
  309. package/node_modules/socket.io-client/build/esm/manager.js +367 -0
  310. package/node_modules/socket.io-client/build/esm/on.d.ts +2 -0
  311. package/node_modules/socket.io-client/build/esm/on.js +6 -0
  312. package/node_modules/socket.io-client/build/esm/package.json +5 -0
  313. package/node_modules/socket.io-client/build/esm/socket.d.ts +593 -0
  314. package/node_modules/socket.io-client/build/esm/socket.js +880 -0
  315. package/node_modules/socket.io-client/build/esm/url.d.ts +33 -0
  316. package/node_modules/socket.io-client/build/esm/url.js +59 -0
  317. package/node_modules/socket.io-client/build/esm-debug/browser-entrypoint.d.ts +2 -0
  318. package/node_modules/socket.io-client/build/esm-debug/browser-entrypoint.js +2 -0
  319. package/node_modules/socket.io-client/build/esm-debug/contrib/backo2.d.ts +12 -0
  320. package/node_modules/socket.io-client/build/esm-debug/contrib/backo2.js +66 -0
  321. package/node_modules/socket.io-client/build/esm-debug/index.d.ts +29 -0
  322. package/node_modules/socket.io-client/build/esm-debug/index.js +62 -0
  323. package/node_modules/socket.io-client/build/esm-debug/manager.d.ts +295 -0
  324. package/node_modules/socket.io-client/build/esm-debug/manager.js +386 -0
  325. package/node_modules/socket.io-client/build/esm-debug/on.d.ts +2 -0
  326. package/node_modules/socket.io-client/build/esm-debug/on.js +6 -0
  327. package/node_modules/socket.io-client/build/esm-debug/package.json +5 -0
  328. package/node_modules/socket.io-client/build/esm-debug/socket.d.ts +593 -0
  329. package/node_modules/socket.io-client/build/esm-debug/socket.js +902 -0
  330. package/node_modules/socket.io-client/build/esm-debug/url.d.ts +33 -0
  331. package/node_modules/socket.io-client/build/esm-debug/url.js +63 -0
  332. package/node_modules/socket.io-client/dist/socket.io.esm.min.js +7 -0
  333. package/node_modules/socket.io-client/dist/socket.io.esm.min.js.map +1 -0
  334. package/node_modules/socket.io-client/dist/socket.io.js +4955 -0
  335. package/node_modules/socket.io-client/dist/socket.io.js.map +1 -0
  336. package/node_modules/socket.io-client/dist/socket.io.min.js +7 -0
  337. package/node_modules/socket.io-client/dist/socket.io.min.js.map +1 -0
  338. package/node_modules/socket.io-client/dist/socket.io.msgpack.min.js +7 -0
  339. package/node_modules/socket.io-client/dist/socket.io.msgpack.min.js.map +1 -0
  340. package/node_modules/socket.io-client/package.json +101 -0
  341. package/node_modules/socket.io-parser/LICENSE +20 -0
  342. package/node_modules/socket.io-parser/Readme.md +81 -0
  343. package/node_modules/socket.io-parser/build/cjs/binary.d.ts +20 -0
  344. package/node_modules/socket.io-parser/build/cjs/binary.js +87 -0
  345. package/node_modules/socket.io-parser/build/cjs/index.d.ts +91 -0
  346. package/node_modules/socket.io-parser/build/cjs/index.js +359 -0
  347. package/node_modules/socket.io-parser/build/cjs/is-binary.d.ts +7 -0
  348. package/node_modules/socket.io-parser/build/cjs/is-binary.js +54 -0
  349. package/node_modules/socket.io-parser/build/cjs/package.json +3 -0
  350. package/node_modules/socket.io-parser/build/esm/binary.d.ts +20 -0
  351. package/node_modules/socket.io-parser/build/esm/binary.js +83 -0
  352. package/node_modules/socket.io-parser/build/esm/index.d.ts +91 -0
  353. package/node_modules/socket.io-parser/build/esm/index.js +348 -0
  354. package/node_modules/socket.io-parser/build/esm/is-binary.d.ts +7 -0
  355. package/node_modules/socket.io-parser/build/esm/is-binary.js +50 -0
  356. package/node_modules/socket.io-parser/build/esm/package.json +3 -0
  357. package/node_modules/socket.io-parser/build/esm-debug/binary.d.ts +20 -0
  358. package/node_modules/socket.io-parser/build/esm-debug/binary.js +83 -0
  359. package/node_modules/socket.io-parser/build/esm-debug/index.d.ts +91 -0
  360. package/node_modules/socket.io-parser/build/esm-debug/index.js +353 -0
  361. package/node_modules/socket.io-parser/build/esm-debug/is-binary.d.ts +7 -0
  362. package/node_modules/socket.io-parser/build/esm-debug/is-binary.js +50 -0
  363. package/node_modules/socket.io-parser/build/esm-debug/package.json +3 -0
  364. package/node_modules/socket.io-parser/package.json +44 -0
  365. package/node_modules/xmlhttprequest-ssl/LICENSE +22 -0
  366. package/node_modules/xmlhttprequest-ssl/README.md +67 -0
  367. package/node_modules/xmlhttprequest-ssl/lib/XMLHttpRequest.js +689 -0
  368. package/node_modules/xmlhttprequest-ssl/package.json +40 -0
  369. package/openclaw.plugin.json +17 -0
  370. package/package.json +43 -23
  371. package/skills/lightclaw-cron/SKILL.md +381 -0
@@ -0,0 +1,121 @@
1
+ /**
2
+ * LightClaw — Socket.IO 事件处理器
3
+ *
4
+ * 将 socket 事件监听(message:private、history:request、sessions:request)
5
+ * 从 gateway 主逻辑中解耦。
6
+ */
7
+ import { CHANNEL_KEY, EVENT_MESSAGE_PRIVATE, EVENT_HISTORY_REQUEST, EVENT_HISTORY_RESPONSE, EVENT_SESSIONS_REQUEST, EVENT_SESSIONS_RESPONSE, DEFAULT_HISTORY_LIMIT, } from "./config.js";
8
+ import { isDuplicate, isHistoryRequestThrottled, generateMsgId } from "./dedup.js";
9
+ import { getAssistantRuntime } from "./runtime.js";
10
+ import { readSessionHistoryWithCron, listSessions } from "./history/index.js";
11
+ /**
12
+ * 绑定所有 Socket.IO 事件监听器
13
+ */
14
+ export function bindSocketHandlers(socket, deps) {
15
+ const { account, botClientId, log, enqueueMessage, onEvent } = deps;
16
+ // ---- 接收用户消息 ----
17
+ socket.on(EVENT_MESSAGE_PRIVATE, (data) => {
18
+ // 回环防御:过滤自身发出的消息
19
+ if (data.from === botClientId)
20
+ return;
21
+ // 跳过控制消息(typing / stream 信号),只处理真实用户消息
22
+ if (data.kind && data.kind !== "text")
23
+ return;
24
+ // 无内容跳过
25
+ const hasContent = data.content?.trim();
26
+ const hasFiles = data.files && data.files.length > 0;
27
+ if (!hasContent && !hasFiles)
28
+ return;
29
+ // 去重
30
+ if (isDuplicate(data.msgId))
31
+ return;
32
+ // 通知框架收到入站事件(更新 lastEventAt,防止 stale-socket 误判)
33
+ onEvent?.();
34
+ log?.info(`[${CHANNEL_KEY}] Message from ${data.from}: "${(data.content || "").slice(0, 60)}" files=${data.files?.length ?? 0}`);
35
+ enqueueMessage({
36
+ senderId: data.from,
37
+ text: data.content || "",
38
+ messageId: data.msgId,
39
+ files: data.files ?? [],
40
+ timestamp: data.timestamp,
41
+ });
42
+ });
43
+ // ---- 历史消息请求 ----
44
+ socket.on(EVENT_HISTORY_REQUEST, (data) => {
45
+ if (!data?.from) {
46
+ log?.warn(`[${CHANNEL_KEY}] History request missing userId, ignoring`);
47
+ return;
48
+ }
49
+ // 回环防御:忽略 bot 自身发出的请求
50
+ if (data.from === botClientId)
51
+ return;
52
+ // 去重:如果有 msgId,走消息级去重
53
+ if (data.msgId && isDuplicate(data.msgId)) {
54
+ log?.warn(`[${CHANNEL_KEY}] Duplicate history request (msgId), ignoring`);
55
+ return;
56
+ }
57
+ // 节流:同一用户在短时间内只处理一次 history 请求
58
+ if (isHistoryRequestThrottled(data.from)) {
59
+ log?.warn(`[${CHANNEL_KEY}] Throttled history request from ${data.from}, ignoring`);
60
+ return;
61
+ }
62
+ // 通知框架收到入站事件(更新 lastEventAt,防止 stale-socket 误判)
63
+ onEvent?.();
64
+ try {
65
+ const pluginRuntime = getAssistantRuntime();
66
+ const currentCfg = pluginRuntime.config.loadConfig();
67
+ const route = pluginRuntime.channel.routing.resolveAgentRoute({
68
+ cfg: currentCfg,
69
+ channel: CHANNEL_KEY,
70
+ accountId: account.accountId,
71
+ peer: { kind: "direct", id: data.from },
72
+ });
73
+ const sessionKey = route?.sessionKey ?? `${CHANNEL_KEY}:dm:${data.from}`;
74
+ const messages = readSessionHistoryWithCron(sessionKey, {
75
+ limit: data.limit ?? DEFAULT_HISTORY_LIMIT,
76
+ chatOnly: data.chatOnly ?? true,
77
+ includeCron: true,
78
+ });
79
+ log?.info(`[${CHANNEL_KEY}] History request: userId=${data.from} sessionKey=${sessionKey} found=${messages.length}。messages:${JSON.stringify(messages)}`);
80
+ socket.emit(EVENT_HISTORY_RESPONSE, {
81
+ msgId: generateMsgId(),
82
+ from: botClientId,
83
+ to: data.from,
84
+ sessionKey,
85
+ messages: messages.filter(msg => !!msg.content.trim()),
86
+ });
87
+ }
88
+ catch (err) {
89
+ log?.error(`[${CHANNEL_KEY}] History request error: ${err}`);
90
+ socket.emit(EVENT_HISTORY_RESPONSE, {
91
+ msgId: generateMsgId(),
92
+ from: botClientId,
93
+ to: data.from,
94
+ sessionKey: "",
95
+ messages: [],
96
+ error: err instanceof Error ? err.message : String(err),
97
+ });
98
+ }
99
+ });
100
+ // ---- 会话列表请求 ----
101
+ socket.on(EVENT_SESSIONS_REQUEST, (data) => {
102
+ // 通知框架收到入站事件(更新 lastEventAt,防止 stale-socket 误判)
103
+ onEvent?.();
104
+ try {
105
+ const sessions = listSessions();
106
+ socket.emit(EVENT_SESSIONS_RESPONSE, {
107
+ requestId: data.requestId,
108
+ sessions,
109
+ });
110
+ }
111
+ catch (err) {
112
+ log?.error(`[${CHANNEL_KEY}] Sessions list error: ${err}`);
113
+ socket.emit(EVENT_SESSIONS_RESPONSE, {
114
+ requestId: data.requestId,
115
+ sessions: [],
116
+ error: err instanceof Error ? err.message : String(err),
117
+ });
118
+ }
119
+ });
120
+ }
121
+ //# sourceMappingURL=socket-handlers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"socket-handlers.js","sourceRoot":"","sources":["../../src/socket-handlers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * LightClaw — Socket 注册表
3
+ *
4
+ * 让 gateway 启动时注册 socket 实例,
5
+ * outbound 在需要发送消息时可以通过 WS 连接直接发送,
6
+ * 无需走 REST API。
7
+ *
8
+ * 断线缓冲:
9
+ * 当 socket 暂时断开(Socket.IO 自动重连中)时,outbound 消息
10
+ * 会被缓冲在 pendingMessages 队列中,重连后自动 flush 发送。
11
+ * 仅在 gateway 彻底销毁(cleanup)时才删除 entry。
12
+ */
13
+ import type { Socket } from "socket.io-client";
14
+ import type { PrivateMessageData } from "./types.js";
15
+ interface SocketEntry {
16
+ socket: Socket;
17
+ botClientId: string;
18
+ /** 断线期间缓冲的待发消息 */
19
+ pendingMessages: PrivateMessageData[];
20
+ }
21
+ /** 注册 socket(gateway 首次连接时调用) */
22
+ export declare function registerSocket(accountId: string, socket: Socket, botClientId: string): void;
23
+ /**
24
+ * 注销 socket(gateway 彻底销毁时调用)。
25
+ * 注意:普通断线重连不应调用此函数,只在 cleanup 时调用。
26
+ */
27
+ export declare function unregisterSocket(accountId: string): void;
28
+ /** 获取可用的 socket(仅在 connected 时返回) */
29
+ export declare function getSocket(accountId: string): Pick<SocketEntry, "socket" | "botClientId"> | undefined;
30
+ /** 检查 account 是否有注册的 entry(不管是否 connected) */
31
+ export declare function hasEntry(accountId: string): boolean;
32
+ /** 获取 botClientId(不管 socket 是否 connected) */
33
+ export declare function getBotClientId(accountId: string): string | undefined;
34
+ /**
35
+ * 缓冲一条消息(socket 断开期间由 outbound 调用)。
36
+ * 返回 true 表示成功缓冲,false 表示该 account 没有注册的 entry。
37
+ */
38
+ export declare function bufferMessage(accountId: string, message: PrivateMessageData): boolean;
39
+ /**
40
+ * flush 所有缓冲消息(重连成功后由 gateway 调用)。
41
+ * 返回发送成功 / 失败的计数。
42
+ */
43
+ export declare function flushPendingMessages(accountId: string, log?: {
44
+ info: (msg: string) => void;
45
+ warn: (msg: string) => void;
46
+ }): {
47
+ sent: number;
48
+ failed: number;
49
+ };
50
+ /** 获取缓冲队列长度(调试/监控用) */
51
+ export declare function getPendingCount(accountId: string): number;
52
+ export {};
53
+ //# sourceMappingURL=socket-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"socket-registry.d.ts","sourceRoot":"","sources":["../../src/socket-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAOrD,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,eAAe,EAAE,kBAAkB,EAAE,CAAC;CACvC;AASD,iCAAiC;AACjC,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAS3F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAExD;AAMD,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,aAAa,CAAC,GAAG,SAAS,CAIpG;AAED,8CAA8C;AAC9C,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAUrF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA8BlC;AAED,uBAAuB;AACvB,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD"}
@@ -0,0 +1,111 @@
1
+ /**
2
+ * LightClaw — Socket 注册表
3
+ *
4
+ * 让 gateway 启动时注册 socket 实例,
5
+ * outbound 在需要发送消息时可以通过 WS 连接直接发送,
6
+ * 无需走 REST API。
7
+ *
8
+ * 断线缓冲:
9
+ * 当 socket 暂时断开(Socket.IO 自动重连中)时,outbound 消息
10
+ * 会被缓冲在 pendingMessages 队列中,重连后自动 flush 发送。
11
+ * 仅在 gateway 彻底销毁(cleanup)时才删除 entry。
12
+ */
13
+ import { MAX_PENDING_MESSAGES, EVENT_MESSAGE_PRIVATE } from "./config.js";
14
+ /** accountId → SocketEntry */
15
+ const registry = new Map();
16
+ // ============================================================
17
+ // 注册 / 注销
18
+ // ============================================================
19
+ /** 注册 socket(gateway 首次连接时调用) */
20
+ export function registerSocket(accountId, socket, botClientId) {
21
+ const existing = registry.get(accountId);
22
+ if (existing) {
23
+ // 重连场景:更新 socket 引用,保留 pending 队列
24
+ existing.socket = socket;
25
+ existing.botClientId = botClientId;
26
+ }
27
+ else {
28
+ registry.set(accountId, { socket, botClientId, pendingMessages: [] });
29
+ }
30
+ }
31
+ /**
32
+ * 注销 socket(gateway 彻底销毁时调用)。
33
+ * 注意:普通断线重连不应调用此函数,只在 cleanup 时调用。
34
+ */
35
+ export function unregisterSocket(accountId) {
36
+ registry.delete(accountId);
37
+ }
38
+ // ============================================================
39
+ // 查询
40
+ // ============================================================
41
+ /** 获取可用的 socket(仅在 connected 时返回) */
42
+ export function getSocket(accountId) {
43
+ const entry = registry.get(accountId);
44
+ if (entry && entry.socket.connected)
45
+ return entry;
46
+ return undefined;
47
+ }
48
+ /** 检查 account 是否有注册的 entry(不管是否 connected) */
49
+ export function hasEntry(accountId) {
50
+ return registry.has(accountId);
51
+ }
52
+ /** 获取 botClientId(不管 socket 是否 connected) */
53
+ export function getBotClientId(accountId) {
54
+ return registry.get(accountId)?.botClientId;
55
+ }
56
+ // ============================================================
57
+ // 断线缓冲
58
+ // ============================================================
59
+ /**
60
+ * 缓冲一条消息(socket 断开期间由 outbound 调用)。
61
+ * 返回 true 表示成功缓冲,false 表示该 account 没有注册的 entry。
62
+ */
63
+ export function bufferMessage(accountId, message) {
64
+ const entry = registry.get(accountId);
65
+ if (!entry)
66
+ return false;
67
+ if (entry.pendingMessages.length >= MAX_PENDING_MESSAGES) {
68
+ // 队列满了,丢弃最早的消息
69
+ entry.pendingMessages.shift();
70
+ }
71
+ entry.pendingMessages.push(message);
72
+ return true;
73
+ }
74
+ /**
75
+ * flush 所有缓冲消息(重连成功后由 gateway 调用)。
76
+ * 返回发送成功 / 失败的计数。
77
+ */
78
+ export function flushPendingMessages(accountId, log) {
79
+ const entry = registry.get(accountId);
80
+ if (!entry)
81
+ return { sent: 0, failed: 0 };
82
+ const pending = entry.pendingMessages.splice(0); // 取出全部并清空
83
+ if (pending.length === 0)
84
+ return { sent: 0, failed: 0 };
85
+ let sent = 0;
86
+ let failed = 0;
87
+ for (const msg of pending) {
88
+ if (!entry.socket.connected) {
89
+ // socket 又断了,把剩余消息放回去
90
+ entry.pendingMessages.unshift(...pending.slice(sent + failed));
91
+ break;
92
+ }
93
+ try {
94
+ entry.socket.emit(EVENT_MESSAGE_PRIVATE, msg);
95
+ sent++;
96
+ }
97
+ catch {
98
+ failed++;
99
+ log?.warn(`[socket-registry] Failed to flush buffered message: msgId=${msg.msgId}`);
100
+ }
101
+ }
102
+ if (sent > 0 || failed > 0) {
103
+ log?.info(`[socket-registry] Flushed pending messages: sent=${sent}, failed=${failed}`);
104
+ }
105
+ return { sent, failed };
106
+ }
107
+ /** 获取缓冲队列长度(调试/监控用) */
108
+ export function getPendingCount(accountId) {
109
+ return registry.get(accountId)?.pendingMessages.length ?? 0;
110
+ }
111
+ //# sourceMappingURL=socket-registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"socket-registry.js","sourceRoot":"","sources":["../../src/socket-registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,102 @@
1
+ /**
2
+ * LightClaw OpenClaw Channel Plugin — 类型定义
3
+ *
4
+ * 用户实际消息格式:
5
+ * { msgId, from, to, content, files, timestamp }
6
+ *
7
+ * files 格式为 FileAttachment[],每个文件包含 name, mimeType, bytes(data URL)。
8
+ */
9
+ /** 用户上传的文件(files[] 数组中的元素) */
10
+ export interface FileAttachment {
11
+ /** 文件名 */
12
+ name: string;
13
+ /** MIME 类型 */
14
+ mimeType: string;
15
+ /** base64 data URL(如 "data:text/plain;base64,...") */
16
+ bytes?: string;
17
+ /** 远程文件 URI(如 COS 下载地址),与 bytes 二选一 */
18
+ uri?: string;
19
+ }
20
+ /**
21
+ * message:private 事件的 data 结构
22
+ *
23
+ * 入站(用户 → 插件):{ msgId, from, to, content, files, timestamp }
24
+ * 出站(插件 → 用户):同结构,可附带 kind 用于流式/typing 控制
25
+ */
26
+ export interface PrivateMessageData {
27
+ /** 消息唯一 ID */
28
+ msgId: string;
29
+ /** 发送者 ID */
30
+ from: string;
31
+ /** 接收者 ID */
32
+ to: string;
33
+ /** 消息文本内容(仅发送文件时可为空字符串) */
34
+ content: string;
35
+ /** 消息时间戳(ms) */
36
+ timestamp: number;
37
+ /** 文件列表({name, mimeType, bytes} 格式,bytes 为 data URL) */
38
+ files?: FileAttachment[];
39
+ /** 消息子类型:流式/typing 控制(出站使用) */
40
+ kind?: "text" | "stream_chunk" | "stream_end" | "typing_start" | "typing_stop";
41
+ /** 回复对应的原始消息 ID */
42
+ replyToMsgId?: string;
43
+ }
44
+ /** 原始配置(config.yaml 中的内容) */
45
+ export interface AssistantAccountConfig {
46
+ /** API Key / Token */
47
+ apiKey?: string;
48
+ /** REST API 基础地址(用于 outbound 主动发送) */
49
+ apiBaseUrl?: string;
50
+ /** 是否启用 */
51
+ enabled?: boolean;
52
+ /** 账户名称 */
53
+ name?: string;
54
+ /** DM 策略 */
55
+ dmPolicy?: "open" | "allowlist" | "disabled";
56
+ /** 允许的用户 ID 列表(* 表示所有人) */
57
+ allowFrom?: string[];
58
+ /** 自定义系统提示词 */
59
+ systemPrompt?: string;
60
+ }
61
+ /** 解析后的完整账户(含默认值和环境变量 fallback) */
62
+ export interface ResolvedAssistantAccount {
63
+ accountId: string;
64
+ apiKey: string;
65
+ apiBaseUrl: string;
66
+ enabled: boolean;
67
+ name?: string;
68
+ dmPolicy: "open" | "allowlist" | "disabled";
69
+ allowFrom: string[];
70
+ systemPrompt?: string;
71
+ secretSource: "config" | "env" | "none";
72
+ }
73
+ export interface GatewayContext {
74
+ account: ResolvedAssistantAccount;
75
+ abortSignal: AbortSignal;
76
+ cfg: unknown;
77
+ onReady?: () => void;
78
+ onDisconnect?: () => void;
79
+ onError?: (error: Error) => void;
80
+ /** 收到任何入站事件时调用,用于通知框架更新 lastEventAt,防止 health-monitor 误判 stale-socket */
81
+ onEvent?: () => void;
82
+ log?: {
83
+ info: (msg: string) => void;
84
+ warn: (msg: string) => void;
85
+ error: (msg: string) => void;
86
+ debug?: (msg: string) => void;
87
+ };
88
+ }
89
+ /** 消息队列项 — 直接使用用户的 files[] 格式 */
90
+ export interface QueuedMessage {
91
+ /** 发送者 ID */
92
+ senderId: string;
93
+ /** 消息文本 */
94
+ text: string;
95
+ /** 消息 ID */
96
+ messageId: string;
97
+ /** 文件附件({name, mimeType, bytes} 格式) */
98
+ files: FileAttachment[];
99
+ /** 时间戳 */
100
+ timestamp: number;
101
+ }
102
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * LightClaw OpenClaw Channel Plugin — 类型定义
3
+ *
4
+ * 用户实际消息格式:
5
+ * { msgId, from, to, content, files, timestamp }
6
+ *
7
+ * files 格式为 FileAttachment[],每个文件包含 name, mimeType, bytes(data URL)。
8
+ */
9
+ export {};
10
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * LightClaw — 文件上传工具
3
+ *
4
+ * 注册为 OpenClaw Agent Tool,允许 AI 将本地文件上传到 COS,
5
+ * 获得公网可访问的 URL,方便用户直接下载。
6
+ *
7
+ * 工具名: lightclaw_upload_file
8
+ */
9
+ import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
10
+ export declare const UPLOAD_TOOL_NAME = "lightclaw_upload_file";
11
+ export declare const uploadToolSchema: {
12
+ type: "object";
13
+ properties: {
14
+ paths: {
15
+ type: "array";
16
+ items: {
17
+ type: "string";
18
+ };
19
+ minItems: number;
20
+ maxItems: number;
21
+ description: string;
22
+ };
23
+ };
24
+ required: readonly ["paths"];
25
+ };
26
+ export declare function registerUploadTool(api: OpenClawPluginApi): void;
27
+ //# sourceMappingURL=upload-tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload-tool.d.ts","sourceRoot":"","sources":["../../src/upload-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,qBAAqB,CAAC;AAS3E,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;CAY5B,CAAC;AAuBF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CA+H/D"}
@@ -0,0 +1,148 @@
1
+ /**
2
+ * LightClaw — 文件上传工具
3
+ *
4
+ * 注册为 OpenClaw Agent Tool,允许 AI 将本地文件上传到 COS,
5
+ * 获得公网可访问的 URL,方便用户直接下载。
6
+ *
7
+ * 工具名: lightclaw_upload_file
8
+ */
9
+ import * as fs from "node:fs";
10
+ import * as path from "node:path";
11
+ import { uploadFileToCos } from "./file-storage.js";
12
+ import { formatFileSize } from "./media.js";
13
+ import { resolveAccount } from "./config.js";
14
+ // ============================================================
15
+ // 工具参数 schema(JSON Schema 格式)
16
+ // ============================================================
17
+ export const UPLOAD_TOOL_NAME = "lightclaw_upload_file";
18
+ export const uploadToolSchema = {
19
+ type: "object",
20
+ properties: {
21
+ paths: {
22
+ type: "array",
23
+ items: { type: "string" },
24
+ minItems: 1,
25
+ maxItems: 5,
26
+ description: "需要上传的本地文件路径数组(绝对路径),最多 5 个文件",
27
+ },
28
+ },
29
+ required: ["paths"],
30
+ };
31
+ // ============================================================
32
+ // MIME 类型映射(扩展版)
33
+ // ============================================================
34
+ // ============================================================
35
+ // 辅助:从 api.config 动态解析出 FileStorageConfig
36
+ // ============================================================
37
+ function resolveStorageConfig(api, defaultAccountId) {
38
+ if (!api.config)
39
+ return {};
40
+ const account = resolveAccount(api.config, defaultAccountId);
41
+ return { apiKey: account.apiKey };
42
+ }
43
+ // ============================================================
44
+ // 工具注册(飞书工厂函数模式)
45
+ // ============================================================
46
+ export function registerUploadTool(api) {
47
+ api.registerTool((ctx) => {
48
+ const defaultAccountId = ctx.agentAccountId;
49
+ return {
50
+ name: UPLOAD_TOOL_NAME,
51
+ description: "Upload local files to Tencent COS cloud storage and return publicly accessible download URLs. " +
52
+ "Use this tool whenever you have generated or produced files (reports, images, documents, etc.) " +
53
+ "that the user needs to download. This is the primary way to deliver file outputs to users. " +
54
+ "Supports up to 5 files at once. Returns a public download URL for each uploaded file.",
55
+ parameters: uploadToolSchema,
56
+ async execute(_toolCallId, params) {
57
+ // 每次 execute 时动态解析 apiKey
58
+ const storageConfig = resolveStorageConfig(api, defaultAccountId);
59
+ const { paths } = params;
60
+ // 参数校验
61
+ if (!Array.isArray(paths) || paths.length === 0) {
62
+ return {
63
+ content: [{ type: "text", text: "Error: paths must be a non-empty array of file paths." }],
64
+ };
65
+ }
66
+ if (paths.length > 5) {
67
+ return {
68
+ content: [{ type: "text", text: "Error: maximum 5 files per upload." }],
69
+ };
70
+ }
71
+ // 验证所有文件存在
72
+ const validationErrors = [];
73
+ for (const p of paths) {
74
+ if (typeof p !== "string" || !p.trim()) {
75
+ validationErrors.push(`Invalid path: empty or non-string`);
76
+ continue;
77
+ }
78
+ if (!fs.existsSync(p)) {
79
+ validationErrors.push(`File not found: ${p}`);
80
+ continue;
81
+ }
82
+ const stat = fs.statSync(p);
83
+ if (!stat.isFile()) {
84
+ validationErrors.push(`Not a regular file: ${p}`);
85
+ }
86
+ }
87
+ if (validationErrors.length > 0) {
88
+ return {
89
+ content: [{ type: "text", text: `Validation errors:\n${validationErrors.join("\n")}` }],
90
+ };
91
+ }
92
+ // 并发上传(最多 3 个并发)
93
+ const results = [];
94
+ const concurrency = 3;
95
+ for (let i = 0; i < paths.length; i += concurrency) {
96
+ const batch = paths.slice(i, i + concurrency);
97
+ const batchResults = await Promise.allSettled(batch.map(async (filePath) => {
98
+ const stat = fs.statSync(filePath);
99
+ const uploadResult = await uploadFileToCos(filePath, storageConfig);
100
+ return {
101
+ path: filePath,
102
+ success: true,
103
+ url: uploadResult.url,
104
+ filePath: uploadResult.filePath,
105
+ size: formatFileSize(stat.size),
106
+ };
107
+ }));
108
+ for (let j = 0; j < batchResults.length; j++) {
109
+ const r = batchResults[j];
110
+ if (r.status === "fulfilled") {
111
+ results.push(r.value);
112
+ }
113
+ else {
114
+ results.push({
115
+ path: batch[j],
116
+ success: false,
117
+ error: r.reason instanceof Error ? r.reason.message : String(r.reason),
118
+ });
119
+ }
120
+ }
121
+ }
122
+ // 构建结果文本
123
+ const lines = [];
124
+ const successResults = [];
125
+ for (const r of results) {
126
+ const name = path.basename(r.path);
127
+ if (r.success && r.url) {
128
+ lines.push(`✅ ${name} (${r.size}) → ${r.url}`);
129
+ successResults.push({ name, url: r.url, size: r.size });
130
+ }
131
+ else {
132
+ lines.push(`❌ ${name}: ${r.error}`);
133
+ }
134
+ }
135
+ const summary = results.length === 1
136
+ ? successResults.length === 1
137
+ ? `File uploaded successfully. Download URL: ${successResults[0].url}`
138
+ : `File upload failed: ${results[0].error}`
139
+ : `Uploaded ${successResults.length}/${results.length} files.\n${lines.join("\n")}`;
140
+ return {
141
+ content: [{ type: "text", text: summary }],
142
+ details: { uploads: results },
143
+ };
144
+ },
145
+ };
146
+ }, { name: UPLOAD_TOOL_NAME });
147
+ }
148
+ //# sourceMappingURL=upload-tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload-tool.js","sourceRoot":"","sources":["../../src/upload-tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ (The MIT License)
2
+
3
+ Copyright (c) 2014 Component contributors <dev@component.io>
4
+
5
+ Permission is hereby granted, free of charge, to any person
6
+ obtaining a copy of this software and associated documentation
7
+ files (the "Software"), to deal in the Software without
8
+ restriction, including without limitation the rights to use,
9
+ copy, modify, merge, publish, distribute, sublicense, and/or sell
10
+ copies of the Software, and to permit persons to whom the
11
+ Software is furnished to do so, subject to the following
12
+ conditions:
13
+
14
+ The above copyright notice and this permission notice shall be
15
+ included in all copies or substantial portions of the Software.
16
+
17
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
18
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
19
+ OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
20
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
21
+ HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
22
+ WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
23
+ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
24
+ OTHER DEALINGS IN THE SOFTWARE.