shadow-claw 1.23.4 → 1.24.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 (255) hide show
  1. package/README.md +42 -5
  2. package/bin/cli.mjs +166 -0
  3. package/bin/cli.test.mjs +60 -0
  4. package/bin/commands/backup.mjs +70 -0
  5. package/bin/commands/clients.mjs +41 -0
  6. package/bin/commands/peer-id.mjs +76 -0
  7. package/bin/commands/peer-id.test.mjs +104 -0
  8. package/bin/commands/send.mjs +51 -0
  9. package/bin/commands/tasks.mjs +59 -0
  10. package/bin/commands/webrtc-listen.mjs +254 -0
  11. package/bin/prerender-dsd-shell/prerender-dsd-shell.test.mjs +46 -0
  12. package/bin/rolldown.config.test.mjs +401 -8
  13. package/bin/utils/control-client.mjs +243 -0
  14. package/bin/utils/control-client.test.mjs +83 -0
  15. package/bin/utils/ulid.mjs +45 -0
  16. package/bin/utils/webrtc-control-client.mjs +699 -0
  17. package/bin/utils/webrtc-control-client.test.mjs +318 -0
  18. package/dist/electron/main.cjs +1 -1
  19. package/dist/public/AGENTS.md +5 -3
  20. package/dist/public/README.md +42 -5
  21. package/dist/public/agent.worker.js +1 -1
  22. package/dist/public/backup-controller-C_s9in2t.js +1 -0
  23. package/dist/public/components/settings/shadow-claw-control-plane/shadow-claw-control-plane.css +1 -0
  24. package/dist/public/components/settings/shadow-claw-control-plane/shadow-claw-control-plane.html +1 -0
  25. package/dist/public/components/settings/shadow-claw-task-server/shadow-claw-task-server.css +1 -1
  26. package/dist/public/components/settings/shadow-claw-task-server/shadow-claw-task-server.html +1 -1
  27. package/dist/public/components/shadow-claw-settings/shadow-claw-settings.html +1 -1
  28. package/dist/public/config-CrHchneq.js +1 -0
  29. package/dist/public/{configurePeerJs-B4Ym9VMj.js → configurePeerJs-CxpZeDJJ.js} +1 -1
  30. package/dist/public/{connections-BEn6JYdu.js → connections-DvbgdkaB.js} +1 -1
  31. package/dist/public/{custom-element-security-DdYlUozq.js → custom-element-security-NCqQ5lmC.js} +1 -1
  32. package/dist/public/docs/README.md +3 -1
  33. package/dist/public/docs/architecture/overview.md +12 -12
  34. package/dist/public/docs/decisions/bundled-typescript-architecture.md +1 -1
  35. package/dist/public/docs/decisions/indexeddb-and-opfs-storage.md +2 -2
  36. package/dist/public/docs/decisions/native-web-components-and-signals.md +1 -1
  37. package/dist/public/docs/example/article/index.html +1 -1
  38. package/dist/public/docs/guides/configuring-messaging-channels.md +41 -6
  39. package/dist/public/docs/guides/server-development-configuration.md +24 -0
  40. package/dist/public/docs/publishing/index.html +1 -1
  41. package/dist/public/docs/skill-creator/index.html +1 -1
  42. package/dist/public/docs/subsystems/backup.md +56 -0
  43. package/dist/public/docs/subsystems/cli.md +124 -0
  44. package/dist/public/docs/subsystems/control-plane.md +158 -0
  45. package/dist/public/docs/subsystems/notifications.md +54 -2
  46. package/dist/public/docs/subsystems/reactive-ui.md +1 -0
  47. package/dist/public/downloadGroupFile-By0GR6eV.js +1 -0
  48. package/dist/public/e2e/README.md +5 -1
  49. package/dist/public/{e2e-bridge-BQ4KzUt5.js → e2e-bridge-IGWsRl4i.js} +1 -1
  50. package/dist/public/file-viewer-D0eflgt6.js +1 -0
  51. package/dist/public/getAllTasks-vpBlgGsc.js +1 -0
  52. package/dist/public/getGroupDir-P1h9wl6S.js +1 -0
  53. package/dist/public/{git-DEUvQTUA.js → git-7Vq_SJSp.js} +2 -2
  54. package/dist/public/{iframe-sanitizer-0NS4XLOd.js → iframe-sanitizer-y2Z1pPwY.js} +1 -1
  55. package/dist/public/index.html +1 -1
  56. package/dist/public/index.js +1 -1
  57. package/dist/public/{initChatSplitResize-llGkSJXg.js → initChatSplitResize-CzV2E7Ul.js} +1 -1
  58. package/dist/public/initControlPlane-C9jpnWev.js +1 -0
  59. package/dist/public/llms.txt +1 -1
  60. package/dist/public/main/index.html +1 -1
  61. package/dist/public/main/memory/index.html +1 -1
  62. package/dist/public/{markdown-CyYR4App.js → markdown-BnpKxSxl.js} +1 -1
  63. package/dist/public/{mcp-reconnect-CSx4aMwy.js → mcp-reconnect-9emsqGRe.js} +1 -1
  64. package/dist/public/{memoryStorage-Dwg8NhAZ.js → memoryStorage-C0KvLNUp.js} +1 -1
  65. package/dist/public/{orchestrator-DRfEudXk.js → orchestrator-3h9xxHUm.js} +676 -676
  66. package/dist/public/orchestrator-nJj59RqD.js +15 -0
  67. package/dist/public/{peerjs-CurBuKvk.js → peerjs-BP4laMXj.js} +1 -1
  68. package/dist/public/{push-client-Dii-vPEh.js → push-client-CrjEXK3U.js} +1 -1
  69. package/dist/public/service-worker/push-handler.js +1 -1
  70. package/dist/public/service-worker.js +1 -1
  71. package/dist/public/{shadow-claw-5IHaDDMJ.js → shadow-claw-CbwETBWf.js} +2 -2
  72. package/dist/public/{shadow-claw-accounts-CZvz4iQz.js → shadow-claw-accounts-B4sBTQEj.js} +1 -1
  73. package/dist/public/{shadow-claw-channels-BKXFyRS3.js → shadow-claw-channels-BDWG5Qa3.js} +1 -1
  74. package/dist/public/{shadow-claw-chat-CCLuhWdI.js → shadow-claw-chat-Crv0DTCY.js} +6 -6
  75. package/dist/public/shadow-claw-control-plane-CX1IGbh9.js +199 -0
  76. package/dist/public/{shadow-claw-conversations-DV-87UUh.js → shadow-claw-conversations-_9qAaRXk.js} +1 -1
  77. package/dist/public/shadow-claw-dialog-BrOwAOdk.js +1 -0
  78. package/dist/public/{shadow-claw-file-viewer-Dk2dbAUd.js → shadow-claw-file-viewer-Blf6yGVD.js} +1 -1
  79. package/dist/public/shadow-claw-files-CYySBDCl.js +840 -0
  80. package/dist/public/{shadow-claw-git-DRA7_qck.js → shadow-claw-git-v8S0JjuR.js} +2 -2
  81. package/dist/public/{shadow-claw-integrations-1Xu5snuV.js → shadow-claw-integrations-D7ufpwhX.js} +1 -1
  82. package/dist/public/{shadow-claw-llm-6Aci1BDP.js → shadow-claw-llm-GWgoVfhI.js} +2 -2
  83. package/dist/public/{shadow-claw-mcp-remote-BUjAeVXC.js → shadow-claw-mcp-remote-kY4LMFNN.js} +1 -1
  84. package/dist/public/{shadow-claw-networking-FQe4nCp3.js → shadow-claw-networking-qHbP95z9.js} +1 -1
  85. package/dist/public/{shadow-claw-notifications-DV2wibL3.js → shadow-claw-notifications-YyHOK2Fr.js} +1 -1
  86. package/dist/public/{shadow-claw-page-header-B63S4HTU.js → shadow-claw-page-header-DMKbkv3s.js} +1 -1
  87. package/dist/public/{shadow-claw-pages-DE3jWj5K.js → shadow-claw-pages-DFZHhzFZ.js} +1 -1
  88. package/dist/public/{shadow-claw-settings-S6DAKfYx.js → shadow-claw-settings-DhxrKIfA.js} +10 -3
  89. package/dist/public/{shadow-claw-storage-DaacA3_K.js → shadow-claw-storage-BFynbP0j.js} +2 -2
  90. package/dist/public/{shadow-claw-task-server-IjKX042p.js → shadow-claw-task-server-3BIeb5oZ.js} +25 -4
  91. package/dist/public/{shadow-claw-tasks-Cy0JYmGU.js → shadow-claw-tasks-Caxc9atL.js} +1 -1
  92. package/dist/public/{shadow-claw-terminal-znAt7HyP.js → shadow-claw-terminal-Beb5qF-U.js} +1 -1
  93. package/dist/public/{shadow-claw-tools-Cutv9Si5.js → shadow-claw-tools-BfJx3A9W.js} +1 -1
  94. package/dist/public/{shadow-claw-webvm-BH8mPDEu.js → shadow-claw-webvm-BCS8ykeP.js} +1 -1
  95. package/dist/public/{syncWebMcpRegistration-BqJxaMGR.js → syncWebMcpRegistration-B_M2fCjH.js} +1 -1
  96. package/dist/server.js +286 -189
  97. package/package.json +2 -1
  98. package/src/__mocks__/jszip.cjs +15 -5
  99. package/src/components/settings/shadow-claw-accounts/shadow-claw-accounts.test.ts +35 -0
  100. package/src/components/settings/shadow-claw-control-plane/shadow-claw-control-plane.css +117 -0
  101. package/src/components/settings/shadow-claw-control-plane/shadow-claw-control-plane.html +81 -0
  102. package/src/components/settings/shadow-claw-control-plane/shadow-claw-control-plane.test.ts +127 -0
  103. package/src/components/settings/shadow-claw-control-plane/shadow-claw-control-plane.ts +292 -0
  104. package/src/components/settings/shadow-claw-git/shadow-claw-git.test.ts +72 -0
  105. package/src/components/settings/shadow-claw-integrations/connection-test-auth.test.ts +20 -30
  106. package/src/components/settings/shadow-claw-integrations/shadow-claw-integrations.test.ts +116 -0
  107. package/src/components/settings/shadow-claw-llm/model-ranking.test.ts +143 -51
  108. package/src/components/settings/shadow-claw-llm/shadow-claw-llm.test.ts +307 -4
  109. package/src/components/settings/shadow-claw-llm/shadow-claw-llm.ts +8 -8
  110. package/src/components/settings/shadow-claw-mcp-remote/shadow-claw-mcp-remote.test.ts +31 -0
  111. package/src/components/settings/shadow-claw-peerjs/shadow-claw-peerjs.test.ts +186 -0
  112. package/src/components/settings/shadow-claw-storage/shadow-claw-storage.test.ts +76 -0
  113. package/src/components/settings/shadow-claw-task-server/shadow-claw-task-server.css +23 -2
  114. package/src/components/settings/shadow-claw-task-server/shadow-claw-task-server.html +1 -1
  115. package/src/components/settings/shadow-claw-task-server/shadow-claw-task-server.test.ts +19 -0
  116. package/src/components/settings/shadow-claw-task-server/shadow-claw-task-server.ts +2 -1
  117. package/src/components/shadow-claw/utils/initChatSplitResize.test.ts +180 -13
  118. package/src/components/shadow-claw/utils/setupEffects.test.ts +39 -0
  119. package/src/components/shadow-claw-a2ui/catalog/basic/shared.test.ts +117 -0
  120. package/src/components/shadow-claw-a2ui/shadow-claw-a2ui.test.ts +1159 -1
  121. package/src/components/shadow-claw-chat/shadow-claw-chat.test.ts +1523 -19
  122. package/src/components/shadow-claw-chat/utils/escapeHtml.test.ts +13 -0
  123. package/src/components/shadow-claw-chat/utils/getPeerChatDisplayStatus.test.ts +20 -0
  124. package/src/components/shadow-claw-conversations/shadow-claw-conversations.test.ts +494 -0
  125. package/src/components/shadow-claw-dialog/shadow-claw-dialog.ts +13 -2
  126. package/src/components/shadow-claw-file-viewer/shadow-claw-file-viewer.test.ts +273 -0
  127. package/src/components/shadow-claw-files/shadow-claw-files.test.ts +408 -1
  128. package/src/components/shadow-claw-pdf-viewer/utils/installGetOrInsertComputedPolyfill.test.ts +65 -0
  129. package/src/components/shadow-claw-settings/shadow-claw-settings.html +7 -0
  130. package/src/components/shadow-claw-settings/shadow-claw-settings.test.ts +221 -0
  131. package/src/components/shadow-claw-settings/shadow-claw-settings.ts +2 -0
  132. package/src/components/shadow-claw-tasks/shadow-claw-tasks.test.ts +407 -0
  133. package/src/components/shadow-claw-terminal/utils/consumeEscapeSequence.test.ts +58 -0
  134. package/src/components/shadow-claw-tools/shadow-claw-tools.test.ts +80 -0
  135. package/src/config/config.ts +10 -0
  136. package/src/core/backup-controller.test.ts +101 -0
  137. package/src/core/backup-controller.ts +137 -0
  138. package/src/core/control-plane-client.test.ts +408 -0
  139. package/src/core/control-plane-client.ts +425 -0
  140. package/src/core/orchestrator/orchestrator.ts +4 -0
  141. package/src/core/orchestrator/utils/compactContext.test.ts +78 -0
  142. package/src/core/orchestrator/utils/operations/channel.test.ts +254 -9
  143. package/src/core/orchestrator/utils/operations/provider.test.ts +326 -34
  144. package/src/core/orchestrator/utils/operations/vm.test.ts +114 -2
  145. package/src/core/orchestrator/utils/syncProxyConfigToServiceWorker.test.ts +60 -0
  146. package/src/core/utils/initControlPlane.test.ts +276 -0
  147. package/src/core/utils/initControlPlane.ts +437 -0
  148. package/src/core/utils/initializeApp.ts +18 -0
  149. package/src/db/getSession.test.ts +13 -1
  150. package/src/server/app.test.ts +12 -0
  151. package/src/server/app.ts +18 -8
  152. package/src/server/client-registry.test.ts +250 -0
  153. package/src/server/client-registry.ts +477 -0
  154. package/src/server/config.ts +15 -0
  155. package/src/server/control-plane-types.ts +120 -0
  156. package/src/server/control-plane.test.ts +472 -0
  157. package/src/server/control-plane.ts +581 -0
  158. package/src/server/routes/backup.test.ts +263 -0
  159. package/src/server/routes/backup.ts +262 -0
  160. package/src/server/routes/integrations-email.test.ts +532 -0
  161. package/src/server/routes/llamafile.test.ts +172 -48
  162. package/src/server/routes/mesh-llm.test.ts +192 -0
  163. package/src/server/routes/ollama.test.ts +49 -0
  164. package/src/server/server-peer.test.ts +86 -0
  165. package/src/server/server-peer.ts +330 -0
  166. package/src/server/server.ts +35 -0
  167. package/src/server/services/llamafile-manager.test.ts +230 -6
  168. package/src/server/services/transformers-runtime.test.ts +186 -18
  169. package/src/server/webrtc.test.ts +21 -0
  170. package/src/server/webrtc.ts +72 -0
  171. package/src/service-worker/fetch-proxy.test.ts +64 -1
  172. package/src/service-worker/push-handler.ts +39 -0
  173. package/src/shell/vm.test.ts +744 -12
  174. package/src/storage/ensureMainGroupIndex.test.ts +153 -0
  175. package/src/storage/getGroupFile.test.ts +66 -0
  176. package/src/storage/memoryStorage.test.ts +82 -2
  177. package/src/storage/writeGroupFileBytes.test.ts +143 -0
  178. package/src/stores/chat-ui.test.ts +20 -0
  179. package/src/stores/orchestrator.test.ts +134 -0
  180. package/src/stores/toast.test.ts +50 -0
  181. package/src/stores/tools.test.ts +147 -10
  182. package/src/subsystems/channels/imessage.test.ts +59 -0
  183. package/src/subsystems/channels/peerjs.test.ts +500 -62
  184. package/src/subsystems/channels/peerjs.ts +71 -4
  185. package/src/subsystems/channels/telegram.test.ts +177 -0
  186. package/src/subsystems/email/catalog.test.ts +1 -0
  187. package/src/subsystems/email/connections.test.ts +39 -1
  188. package/src/subsystems/git/credentials.test.ts +160 -825
  189. package/src/subsystems/git/git.test.ts +463 -0
  190. package/src/subsystems/notifications/__mocks__/node-sqlite.cjs +12 -1
  191. package/src/subsystems/notifications/push-routes.test.ts +33 -0
  192. package/src/subsystems/notifications/push-routes.ts +23 -0
  193. package/src/subsystems/notifications/push-store.ts +1 -1
  194. package/src/subsystems/providers/builtin-ai-tasks.test.ts +74 -0
  195. package/src/subsystems/providers/litert-lm-provider.test.ts +212 -51
  196. package/src/subsystems/providers/model-registry.test.ts +115 -0
  197. package/src/subsystems/providers/providers.test.ts +94 -1
  198. package/src/subsystems/providers/transformers-js-provider.test.ts +279 -0
  199. package/src/subsystems/providers/utils/createModelCacheFetch.test.ts +2 -2
  200. package/src/subsystems/providers/utils/downloadModelToCache.test.ts +2 -2
  201. package/src/subsystems/providers/utils/loadModelStream.test.ts +2 -2
  202. package/src/subsystems/skills/activateSkill.test.ts +101 -0
  203. package/src/subsystems/skills/discoverSkills.test.ts +251 -0
  204. package/src/subsystems/tools/cron.test.ts +64 -0
  205. package/src/subsystems/tools/declarative.test.ts +255 -89
  206. package/src/testing/assets/v86.9pfs/libv86.mjs +63 -0
  207. package/src/testing/assets/v86.ext2/libv86.mjs +3 -0
  208. package/src/testing/assets_missing_v86/assets/v86.9pfs/libv86.mjs +1 -0
  209. package/src/testing/jest-setup.ts +328 -40
  210. package/src/testing/mock-v86.mjs +49 -0
  211. package/src/ui/a2ui/types.ts +4 -3
  212. package/src/ui/a2ui/utils/normaliseComponentsToMap.test.ts +102 -0
  213. package/src/ui/a2ui/utils/resolveChildIds.test.ts +63 -0
  214. package/src/ui/a2ui/utils/resolveDynamicNumber.test.ts +13 -1
  215. package/src/worker/tools/bash/utils/waitForVMReady.test.ts +40 -0
  216. package/src/worker/tools/email/email.test.ts +193 -8
  217. package/src/worker/tools/email/utils/asEmailAttachmentInputs.test.ts +47 -0
  218. package/src/worker/tools/git/git.test.ts +214 -3
  219. package/src/worker/tools/rooms/invite-to-room.test.ts +54 -0
  220. package/src/worker/tools/rooms/leave-room.test.ts +40 -0
  221. package/src/worker/tools/rooms/list-room-members.test.ts +75 -0
  222. package/src/worker/tools/tasks/tasks-utils.test.ts +22 -0
  223. package/src/worker/tools/ui/ask-user.test.ts +50 -0
  224. package/src/worker/tools/ui/clear-chat.test.ts +19 -0
  225. package/src/worker/tools/ui/get-current-time.test.ts +19 -0
  226. package/src/worker/tools/ui/javascript.test.ts +116 -0
  227. package/src/worker/tools/ui/list-components.test.ts +10 -0
  228. package/src/worker/tools/ui/list-tool-profiles.test.ts +42 -0
  229. package/src/worker/tools/ui/manage-tools.test.ts +34 -0
  230. package/src/worker/tools/ui/render-component.test.ts +346 -0
  231. package/src/worker/tools/ui/send-notification.test.ts +40 -0
  232. package/src/worker/tools/ui/utils/getAllowFullInternetAccess.test.ts +31 -0
  233. package/src/worker/tools/ui/utils/parseBooleanConfig.test.ts +25 -0
  234. package/src/worker/tools/workspace/attach-file.test.ts +84 -0
  235. package/src/worker/tools/workspace/copy-file.test.ts +69 -0
  236. package/src/worker/tools/workspace/create-directory.test.ts +40 -0
  237. package/src/worker/tools/workspace/delete-file.test.ts +73 -0
  238. package/src/worker/tools/workspace/diff-files.test.ts +94 -0
  239. package/src/worker/tools/workspace/list-files.test.ts +36 -0
  240. package/src/worker/tools/workspace/move-file.test.ts +66 -0
  241. package/src/worker/tools/workspace/open-file.test.ts +57 -0
  242. package/src/worker/tools/workspace/patch-file.test.ts +81 -0
  243. package/src/worker/tools/workspace/read-file.test.ts +116 -0
  244. package/src/worker/tools/workspace/send-file.test.ts +82 -0
  245. package/src/worker/tools/workspace/update-memory.test.ts +29 -0
  246. package/src/worker/tools/workspace/write-file.test.ts +28 -0
  247. package/src/worker/utils/rate-limit.test.ts +199 -0
  248. package/src/worker/utils/tool-state.test.ts +29 -0
  249. package/src/worker/utils/transformers-js-utils.test.ts +59 -0
  250. package/dist/public/config-BYAuxx3j.js +0 -1
  251. package/dist/public/downloadGroupFile-Drdvg1Ev.js +0 -1
  252. package/dist/public/file-viewer-CcZYw-PS.js +0 -1
  253. package/dist/public/orchestrator-o9Fj67BN.js +0 -15
  254. package/dist/public/shadow-claw-dialog-ByyHgxM9.js +0 -1
  255. package/dist/public/shadow-claw-files-BpfpJIuP.js +0 -840
@@ -1102,16 +1102,83 @@ export class PeerJsChannel implements Channel {
1102
1102
 
1103
1103
  return;
1104
1104
  }
1105
+
1106
+ // Control-plane command execution over WebRTC DataChannel
1107
+ if (msg.type === "command:execute") {
1108
+ const payload = (msg.payload || {}) as {
1109
+ commandId?: string;
1110
+ action?: string;
1111
+ args?: any;
1112
+ };
1113
+ const action = payload.action || "";
1114
+ const args = payload.args || {};
1115
+ const commandId = payload.commandId || "";
1116
+
1117
+ import("../../core/utils/initControlPlane.js")
1118
+ .then(({ executeClientControlCommand }) =>
1119
+ executeClientControlCommand(action, args),
1120
+ )
1121
+ .then((result) => {
1122
+ const conn = this.connections.get(remotePeerId);
1123
+ if (conn) {
1124
+ const hasError = Boolean(result?.error);
1125
+ conn.send({
1126
+ id: ulid(),
1127
+ type: "command:result",
1128
+ payload: {
1129
+ commandId,
1130
+ action,
1131
+ success: !hasError,
1132
+ data: result,
1133
+ ...(hasError ? { error: result.error } : {}),
1134
+ },
1135
+ });
1136
+ }
1137
+ })
1138
+ .catch((err) => {
1139
+ const conn = this.connections.get(remotePeerId);
1140
+ if (conn) {
1141
+ conn.send({
1142
+ id: ulid(),
1143
+ type: "command:result",
1144
+ payload: {
1145
+ commandId,
1146
+ action,
1147
+ success: false,
1148
+ error: err?.message || String(err),
1149
+ },
1150
+ });
1151
+ }
1152
+ });
1153
+
1154
+ return;
1155
+ }
1156
+ }
1157
+
1158
+ private _isTrustedPeer(remotePeerId: string): boolean {
1159
+ if (this.trustedPeerIds.size === 0) {
1160
+ return true;
1161
+ }
1162
+ if (this.trustedPeerIds.has(remotePeerId)) {
1163
+ return true;
1164
+ }
1165
+ for (const trusted of this.trustedPeerIds) {
1166
+ const clean = trusted.trim();
1167
+ if (clean.endsWith("*") && remotePeerId.startsWith(clean.slice(0, -1))) {
1168
+ return true;
1169
+ }
1170
+ if (clean === "cli" && remotePeerId.startsWith("cli-")) {
1171
+ return true;
1172
+ }
1173
+ }
1174
+ return false;
1105
1175
  }
1106
1176
 
1107
1177
  private _handleIncomingConnection(conn: DataConnection): void {
1108
1178
  const remotePeerId = conn.peer;
1109
1179
 
1110
1180
  // Reject untrusted peers when a trusted list is configured
1111
- if (
1112
- this.trustedPeerIds.size > 0 &&
1113
- !this.trustedPeerIds.has(remotePeerId)
1114
- ) {
1181
+ if (!this._isTrustedPeer(remotePeerId)) {
1115
1182
  console.warn(
1116
1183
  `PeerJsChannel: rejecting connection from untrusted peer: ${remotePeerId}`,
1117
1184
  );
@@ -331,4 +331,181 @@ describe("TelegramChannel", () => {
331
331
  expect(fetchCalls).toBe(2);
332
332
  channel.stop();
333
333
  });
334
+
335
+ it("handles /ping helper command", async () => {
336
+ const channel = new TelegramChannel();
337
+ const apiCall = jest
338
+ .spyOn(channel, "apiCall")
339
+ .mockResolvedValue({ ok: true } as any);
340
+
341
+ channel.configure("token", ["123"]);
342
+
343
+ await channel.handleUpdate({
344
+ update_id: 20,
345
+ message: {
346
+ message_id: 99,
347
+ chat: { id: 123, type: "private" },
348
+ date: 1_700_000_000,
349
+ text: "/ping",
350
+ },
351
+ });
352
+
353
+ expect(apiCall).toHaveBeenCalledWith("sendMessage", {
354
+ chat_id: "123",
355
+ text: "Pong! ShadowClaw is running.",
356
+ });
357
+ });
358
+
359
+ it("handles voice, video, audio, document, sticker, location, and contact messages", async () => {
360
+ const channel = new TelegramChannel();
361
+ jest.spyOn(channel, "apiCall").mockResolvedValue({
362
+ ok: true,
363
+ result: { file_id: "fid", file_path: "path/file.dat" },
364
+ } as any);
365
+
366
+ channel.configure("token", ["123"]);
367
+ const messagesSeen: any[] = [];
368
+ channel.onMessage((m) => messagesSeen.push(m));
369
+
370
+ // Voice
371
+ await channel.handleUpdate({
372
+ update_id: 21,
373
+ message: {
374
+ message_id: 101,
375
+ chat: { id: 123, type: "private" },
376
+ date: 1_700_000_000,
377
+ voice: { file_id: "voice-1", mime_type: "audio/ogg" },
378
+ },
379
+ });
380
+ expect(messagesSeen[0].content).toBe("[Voice message]");
381
+
382
+ // Video
383
+ await channel.handleUpdate({
384
+ update_id: 22,
385
+ message: {
386
+ message_id: 102,
387
+ chat: { id: 123, type: "private" },
388
+ date: 1_700_000_000,
389
+ video: { file_id: "vid-1", file_name: "movie.mp4" },
390
+ },
391
+ });
392
+ expect(messagesSeen[1].content).toBe("[Video]");
393
+
394
+ // Audio
395
+ await channel.handleUpdate({
396
+ update_id: 23,
397
+ message: {
398
+ message_id: 103,
399
+ chat: { id: 123, type: "private" },
400
+ date: 1_700_000_000,
401
+ audio: { file_id: "aud-1", file_name: "song.mp3" },
402
+ },
403
+ });
404
+ expect(messagesSeen[2].content).toBe("[Audio]");
405
+
406
+ // Document
407
+ await channel.handleUpdate({
408
+ update_id: 24,
409
+ message: {
410
+ message_id: 104,
411
+ chat: { id: 123, type: "private" },
412
+ date: 1_700_000_000,
413
+ document: { file_id: "doc-1", file_name: "report.pdf" },
414
+ },
415
+ });
416
+ expect(messagesSeen[3].content).toBe("[Document: report.pdf]");
417
+
418
+ // Sticker
419
+ await channel.handleUpdate({
420
+ update_id: 25,
421
+ message: {
422
+ message_id: 105,
423
+ chat: { id: 123, type: "private" },
424
+ date: 1_700_000_000,
425
+ sticker: { file_id: "stk-1", emoji: "🚀", is_animated: true },
426
+ },
427
+ });
428
+ expect(messagesSeen[4].content).toBe("[Sticker: 🚀]");
429
+
430
+ // Location
431
+ await channel.handleUpdate({
432
+ update_id: 26,
433
+ message: {
434
+ message_id: 106,
435
+ chat: { id: 123, type: "private" },
436
+ date: 1_700_000_000,
437
+ location: { latitude: 37.7749, longitude: -122.4194 },
438
+ },
439
+ });
440
+ expect(messagesSeen[5].content).toBe("[Location: 37.7749, -122.4194]");
441
+
442
+ // Contact
443
+ await channel.handleUpdate({
444
+ update_id: 27,
445
+ message: {
446
+ message_id: 107,
447
+ chat: { id: 123, type: "private" },
448
+ date: 1_700_000_000,
449
+ contact: { first_name: "Jane" },
450
+ },
451
+ });
452
+ expect(messagesSeen[6].content).toBe("[Contact: Jane]");
453
+ });
454
+
455
+ it("sets typing status via sendChatAction", () => {
456
+ const channel = new TelegramChannel();
457
+ channel.configure("token", ["123"]);
458
+ const apiCall = jest
459
+ .spyOn(channel, "apiCall")
460
+ .mockResolvedValue({ ok: true } as any);
461
+
462
+ channel.setTyping("tg:123", true);
463
+ expect(apiCall).toHaveBeenCalledWith("sendChatAction", {
464
+ chat_id: "123",
465
+ action: "typing",
466
+ });
467
+
468
+ channel.setTyping("tg:123", false);
469
+ expect(apiCall).toHaveBeenCalledTimes(1);
470
+ });
471
+
472
+ it("sends photos and documents via sendPhoto / sendDocument when fileReader provides blobs", async () => {
473
+ const channel = new TelegramChannel();
474
+ channel.configure("token", ["123"]);
475
+
476
+ channel.fileReader = jest
477
+ .fn<any>()
478
+ .mockImplementation(async (_gid, path) => {
479
+ if (path.endsWith(".png")) {
480
+ return new Blob(["png-data"], { type: "image/png" });
481
+ }
482
+ return new Blob(["pdf-data"], { type: "application/pdf" });
483
+ });
484
+
485
+ const fetchSpy = jest.spyOn(globalThis, "fetch").mockResolvedValue({
486
+ ok: true,
487
+ json: async () => ({ ok: true }),
488
+ } as Response);
489
+
490
+ await channel.send(
491
+ "tg:123",
492
+ "Look at ![photo](images/pic.png) and [doc](docs/file.pdf) please",
493
+ );
494
+
495
+ expect(channel.fileReader).toHaveBeenCalledWith("tg:123", "images/pic.png");
496
+ expect(channel.fileReader).toHaveBeenCalledWith("tg:123", "docs/file.pdf");
497
+ expect(
498
+ fetchSpy.mock.calls.some((c: any) => String(c[0]).includes("sendPhoto")),
499
+ ).toBe(true);
500
+ expect(
501
+ fetchSpy.mock.calls.some((c: any) =>
502
+ String(c[0]).includes("sendDocument"),
503
+ ),
504
+ ).toBe(true);
505
+ expect(
506
+ fetchSpy.mock.calls.some((c: any) =>
507
+ String(c[0]).includes("sendMessage"),
508
+ ),
509
+ ).toBe(true);
510
+ });
334
511
  });
@@ -11,6 +11,7 @@ describe("email catalog", () => {
11
11
 
12
12
  it("returns null for unknown manifest id", () => {
13
13
  expect(getEmailPluginManifest("does-not-exist")).toBeNull();
14
+ expect(getEmailPluginManifest("")).toBeNull();
14
15
  });
15
16
 
16
17
  it("returns manifest for known id", () => {
@@ -171,8 +171,46 @@ describe("email connections", () => {
171
171
  ]);
172
172
 
173
173
  const deleted = await deleteEmailConnection({} as any, "conn-9");
174
-
175
174
  expect(deleted).toBe(true);
176
175
  expect(mockSetConfig).toHaveBeenCalledWith({} as any, legacyKeyValue, []);
176
+
177
+ expect(await deleteEmailConnection({} as any, "")).toBe(false);
178
+ expect(await deleteEmailConnection({} as any, "non-existent")).toBe(false);
179
+ });
180
+
181
+ it("updates existing connection on upsert", async () => {
182
+ mockGetConfig.mockResolvedValue([
183
+ {
184
+ id: "conn-existing",
185
+ label: "Old Label",
186
+ pluginId: "imap",
187
+ enabled: true,
188
+ config: {},
189
+ credentialRef: null,
190
+ createdAt: 1,
191
+ updatedAt: 1,
192
+ },
193
+ ]);
194
+
195
+ const updated = await upsertEmailConnection({} as any, {
196
+ id: "conn-existing",
197
+ label: "New Label",
198
+ pluginId: "imap",
199
+ enabled: false,
200
+ });
201
+
202
+ expect(updated.label).toBe("New Label");
203
+ expect(updated.enabled).toBe(false);
204
+ });
205
+
206
+ it("handles edge cases for get and bind connection", async () => {
207
+ expect(await getEmailConnection({} as any, "")).toBeNull();
208
+ mockGetConfig.mockResolvedValue([]);
209
+ expect(await getEmailConnection({} as any, "missing")).toBeNull();
210
+
211
+ expect(await bindEmailCredentialRef({} as any, "", null)).toBeNull();
212
+ expect(
213
+ await bindEmailCredentialRef({} as any, "missing-conn", null),
214
+ ).toBeNull();
177
215
  });
178
216
  });