agent-messenger 2.2.0 → 2.4.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 (229) hide show
  1. package/.claude-plugin/README.md +16 -16
  2. package/.claude-plugin/marketplace.json +29 -29
  3. package/.claude-plugin/plugin.json +5 -5
  4. package/CONTRIBUTING.md +1 -1
  5. package/README.md +9 -6
  6. package/bun.lock +89 -105
  7. package/bunfig.toml +3 -0
  8. package/dist/package.json +13 -3
  9. package/dist/src/platforms/discordbot/client.js +2 -2
  10. package/dist/src/platforms/discordbot/client.js.map +1 -1
  11. package/dist/src/platforms/kakaotalk/cli.d.ts.map +1 -1
  12. package/dist/src/platforms/kakaotalk/cli.js +2 -1
  13. package/dist/src/platforms/kakaotalk/cli.js.map +1 -1
  14. package/dist/src/platforms/kakaotalk/client.d.ts +2 -1
  15. package/dist/src/platforms/kakaotalk/client.d.ts.map +1 -1
  16. package/dist/src/platforms/kakaotalk/client.js +52 -2
  17. package/dist/src/platforms/kakaotalk/client.js.map +1 -1
  18. package/dist/src/platforms/kakaotalk/commands/index.d.ts +1 -0
  19. package/dist/src/platforms/kakaotalk/commands/index.d.ts.map +1 -1
  20. package/dist/src/platforms/kakaotalk/commands/index.js +1 -0
  21. package/dist/src/platforms/kakaotalk/commands/index.js.map +1 -1
  22. package/dist/src/platforms/kakaotalk/commands/profile.d.ts +3 -0
  23. package/dist/src/platforms/kakaotalk/commands/profile.d.ts.map +1 -0
  24. package/dist/src/platforms/kakaotalk/commands/profile.js +19 -0
  25. package/dist/src/platforms/kakaotalk/commands/profile.js.map +1 -0
  26. package/dist/src/platforms/kakaotalk/index.d.ts +2 -2
  27. package/dist/src/platforms/kakaotalk/index.d.ts.map +1 -1
  28. package/dist/src/platforms/kakaotalk/index.js +1 -1
  29. package/dist/src/platforms/kakaotalk/index.js.map +1 -1
  30. package/dist/src/platforms/kakaotalk/protocol/session.d.ts.map +1 -1
  31. package/dist/src/platforms/kakaotalk/protocol/session.js +2 -1
  32. package/dist/src/platforms/kakaotalk/protocol/session.js.map +1 -1
  33. package/dist/src/platforms/kakaotalk/types.d.ts +16 -0
  34. package/dist/src/platforms/kakaotalk/types.d.ts.map +1 -1
  35. package/dist/src/platforms/kakaotalk/types.js +8 -0
  36. package/dist/src/platforms/kakaotalk/types.js.map +1 -1
  37. package/dist/src/platforms/line/commands/auth.d.ts.map +1 -1
  38. package/dist/src/platforms/line/commands/auth.js +32 -20
  39. package/dist/src/platforms/line/commands/auth.js.map +1 -1
  40. package/dist/src/platforms/teams/commands/reaction.d.ts.map +1 -1
  41. package/dist/src/platforms/teams/commands/reaction.js +2 -0
  42. package/dist/src/platforms/teams/commands/reaction.js.map +1 -1
  43. package/dist/src/platforms/webex/client.d.ts +2 -0
  44. package/dist/src/platforms/webex/client.d.ts.map +1 -1
  45. package/dist/src/platforms/webex/client.js +66 -23
  46. package/dist/src/platforms/webex/client.js.map +1 -1
  47. package/dist/src/platforms/webex/commands/auth.d.ts.map +1 -1
  48. package/dist/src/platforms/webex/commands/auth.js +4 -0
  49. package/dist/src/platforms/webex/commands/auth.js.map +1 -1
  50. package/dist/src/platforms/webex/encryption.d.ts +10 -0
  51. package/dist/src/platforms/webex/encryption.d.ts.map +1 -0
  52. package/dist/src/platforms/webex/encryption.js +49 -0
  53. package/dist/src/platforms/webex/encryption.js.map +1 -0
  54. package/dist/src/platforms/webex/ensure-auth.d.ts.map +1 -1
  55. package/dist/src/platforms/webex/ensure-auth.js +4 -0
  56. package/dist/src/platforms/webex/ensure-auth.js.map +1 -1
  57. package/dist/src/platforms/webex/token-extractor.d.ts +6 -5
  58. package/dist/src/platforms/webex/token-extractor.d.ts.map +1 -1
  59. package/dist/src/platforms/webex/token-extractor.js +92 -43
  60. package/dist/src/platforms/webex/token-extractor.js.map +1 -1
  61. package/dist/src/platforms/webex/types.d.ts +4 -0
  62. package/dist/src/platforms/webex/types.d.ts.map +1 -1
  63. package/dist/src/platforms/webex/types.js +2 -0
  64. package/dist/src/platforms/webex/types.js.map +1 -1
  65. package/dist/src/platforms/wechatbot/cli.d.ts +5 -0
  66. package/dist/src/platforms/wechatbot/cli.d.ts.map +1 -0
  67. package/dist/src/platforms/wechatbot/cli.js +18 -0
  68. package/dist/src/platforms/wechatbot/cli.js.map +1 -0
  69. package/dist/src/platforms/wechatbot/client.d.ts +36 -0
  70. package/dist/src/platforms/wechatbot/client.d.ts.map +1 -0
  71. package/dist/src/platforms/wechatbot/client.js +208 -0
  72. package/dist/src/platforms/wechatbot/client.js.map +1 -0
  73. package/dist/src/platforms/wechatbot/commands/auth.d.ts +28 -0
  74. package/dist/src/platforms/wechatbot/commands/auth.d.ts.map +1 -0
  75. package/dist/src/platforms/wechatbot/commands/auth.js +164 -0
  76. package/dist/src/platforms/wechatbot/commands/auth.js.map +1 -0
  77. package/dist/src/platforms/wechatbot/commands/index.d.ts +5 -0
  78. package/dist/src/platforms/wechatbot/commands/index.d.ts.map +1 -0
  79. package/dist/src/platforms/wechatbot/commands/index.js +5 -0
  80. package/dist/src/platforms/wechatbot/commands/index.js.map +1 -0
  81. package/dist/src/platforms/wechatbot/commands/message.d.ts +18 -0
  82. package/dist/src/platforms/wechatbot/commands/message.d.ts.map +1 -0
  83. package/dist/src/platforms/wechatbot/commands/message.js +80 -0
  84. package/dist/src/platforms/wechatbot/commands/message.js.map +1 -0
  85. package/dist/src/platforms/wechatbot/commands/shared.d.ts +9 -0
  86. package/dist/src/platforms/wechatbot/commands/shared.d.ts.map +1 -0
  87. package/dist/src/platforms/wechatbot/commands/shared.js +13 -0
  88. package/dist/src/platforms/wechatbot/commands/shared.js.map +1 -0
  89. package/dist/src/platforms/wechatbot/commands/template.d.ts +19 -0
  90. package/dist/src/platforms/wechatbot/commands/template.d.ts.map +1 -0
  91. package/dist/src/platforms/wechatbot/commands/template.js +76 -0
  92. package/dist/src/platforms/wechatbot/commands/template.js.map +1 -0
  93. package/dist/src/platforms/wechatbot/commands/user.d.ts +20 -0
  94. package/dist/src/platforms/wechatbot/commands/user.d.ts.map +1 -0
  95. package/dist/src/platforms/wechatbot/commands/user.js +53 -0
  96. package/dist/src/platforms/wechatbot/commands/user.js.map +1 -0
  97. package/dist/src/platforms/wechatbot/credential-manager.d.ts +17 -0
  98. package/dist/src/platforms/wechatbot/credential-manager.d.ts.map +1 -0
  99. package/dist/src/platforms/wechatbot/credential-manager.js +121 -0
  100. package/dist/src/platforms/wechatbot/credential-manager.js.map +1 -0
  101. package/dist/src/platforms/wechatbot/index.d.ts +5 -0
  102. package/dist/src/platforms/wechatbot/index.d.ts.map +1 -0
  103. package/dist/src/platforms/wechatbot/index.js +4 -0
  104. package/dist/src/platforms/wechatbot/index.js.map +1 -0
  105. package/dist/src/platforms/wechatbot/types.d.ts +94 -0
  106. package/dist/src/platforms/wechatbot/types.d.ts.map +1 -0
  107. package/dist/src/platforms/wechatbot/types.js +54 -0
  108. package/dist/src/platforms/wechatbot/types.js.map +1 -0
  109. package/dist/src/platforms/whatsapp/client.d.ts +1 -0
  110. package/dist/src/platforms/whatsapp/client.d.ts.map +1 -1
  111. package/dist/src/platforms/whatsapp/client.js +27 -13
  112. package/dist/src/platforms/whatsapp/client.js.map +1 -1
  113. package/dist/src/platforms/whatsapp/commands/auth.d.ts.map +1 -1
  114. package/dist/src/platforms/whatsapp/commands/auth.js +21 -18
  115. package/dist/src/platforms/whatsapp/commands/auth.js.map +1 -1
  116. package/dist/src/platforms/whatsapp/credential-manager.d.ts.map +1 -1
  117. package/dist/src/platforms/whatsapp/credential-manager.js +14 -8
  118. package/dist/src/platforms/whatsapp/credential-manager.js.map +1 -1
  119. package/docs/content/docs/agent-skills.mdx +4 -4
  120. package/docs/content/docs/cli/channeltalk.mdx +1 -1
  121. package/docs/content/docs/cli/channeltalkbot.mdx +1 -1
  122. package/docs/content/docs/cli/discord.mdx +1 -1
  123. package/docs/content/docs/cli/discordbot.mdx +1 -1
  124. package/docs/content/docs/cli/instagram.mdx +1 -1
  125. package/docs/content/docs/cli/kakaotalk.mdx +1 -1
  126. package/docs/content/docs/cli/line.mdx +1 -1
  127. package/docs/content/docs/cli/meta.json +1 -0
  128. package/docs/content/docs/cli/slack.mdx +1 -1
  129. package/docs/content/docs/cli/slackbot.mdx +1 -1
  130. package/docs/content/docs/cli/teams.mdx +1 -1
  131. package/docs/content/docs/cli/webex.mdx +5 -3
  132. package/docs/content/docs/cli/wechatbot.mdx +179 -0
  133. package/docs/content/docs/cli/whatsapp.mdx +1 -1
  134. package/docs/content/docs/cli/whatsappbot.mdx +1 -1
  135. package/docs/content/docs/sdk/meta.json +1 -1
  136. package/docs/content/docs/sdk/wechatbot.mdx +282 -0
  137. package/docs/content/docs/tui.mdx +1 -1
  138. package/docs/src/app/page.tsx +5 -5
  139. package/package.json +13 -3
  140. package/skills/agent-channeltalk/SKILL.md +1 -1
  141. package/skills/agent-channeltalkbot/SKILL.md +1 -1
  142. package/skills/agent-discord/SKILL.md +1 -1
  143. package/skills/agent-discordbot/SKILL.md +1 -1
  144. package/skills/agent-instagram/SKILL.md +1 -1
  145. package/skills/agent-kakaotalk/SKILL.md +24 -1
  146. package/skills/agent-line/SKILL.md +7 -11
  147. package/skills/agent-line/references/authentication.md +13 -4
  148. package/skills/agent-slack/SKILL.md +1 -1
  149. package/skills/agent-slackbot/SKILL.md +1 -1
  150. package/skills/agent-teams/SKILL.md +1 -1
  151. package/skills/agent-telegram/SKILL.md +1 -1
  152. package/skills/agent-webex/SKILL.md +1 -1
  153. package/skills/agent-webex/references/authentication.md +4 -3
  154. package/skills/agent-webex/references/common-patterns.md +1 -1
  155. package/skills/agent-wechatbot/SKILL.md +385 -0
  156. package/skills/agent-whatsapp/SKILL.md +12 -1
  157. package/skills/agent-whatsappbot/SKILL.md +1 -1
  158. package/src/platforms/discord/credential-manager.test.ts +18 -1
  159. package/src/platforms/discordbot/client.ts +2 -2
  160. package/src/platforms/instagram/commands/auth.test.ts +216 -0
  161. package/src/platforms/instagram/commands/chat.test.ts +127 -0
  162. package/src/platforms/instagram/commands/message.test.ts +178 -0
  163. package/src/platforms/kakaotalk/cli.ts +2 -1
  164. package/src/platforms/kakaotalk/client.test.ts +157 -0
  165. package/src/platforms/kakaotalk/client.ts +57 -3
  166. package/src/platforms/kakaotalk/commands/auth.test.ts +299 -0
  167. package/src/platforms/kakaotalk/commands/chat.test.ts +97 -0
  168. package/src/platforms/kakaotalk/commands/index.ts +1 -0
  169. package/src/platforms/kakaotalk/commands/message.test.ts +113 -0
  170. package/src/platforms/kakaotalk/commands/profile.test.ts +84 -0
  171. package/src/platforms/kakaotalk/commands/profile.ts +21 -0
  172. package/src/platforms/kakaotalk/index.test.ts +5 -0
  173. package/src/platforms/kakaotalk/index.ts +2 -0
  174. package/src/platforms/kakaotalk/protocol/session.ts +2 -0
  175. package/src/platforms/kakaotalk/types.ts +18 -0
  176. package/src/platforms/line/commands/auth.test.ts +141 -0
  177. package/src/platforms/line/commands/auth.ts +28 -19
  178. package/src/platforms/line/commands/chat.test.ts +110 -0
  179. package/src/platforms/line/commands/friend.test.ts +98 -0
  180. package/src/platforms/line/commands/message.test.ts +119 -0
  181. package/src/platforms/line/commands/profile.test.ts +85 -0
  182. package/src/platforms/slackbot/commands/channel.test.ts +139 -0
  183. package/src/platforms/slackbot/commands/message.test.ts +226 -0
  184. package/src/platforms/slackbot/commands/reaction.test.ts +90 -0
  185. package/src/platforms/slackbot/commands/user.test.ts +143 -0
  186. package/src/platforms/teams/commands/reaction.test.ts +45 -61
  187. package/src/platforms/teams/commands/reaction.ts +2 -0
  188. package/src/platforms/telegram/commands/chat.test.ts +125 -0
  189. package/src/platforms/telegram/commands/message.test.ts +92 -0
  190. package/src/platforms/webex/client.ts +98 -26
  191. package/src/platforms/webex/commands/auth.ts +4 -0
  192. package/src/platforms/webex/commands/member.test.ts +65 -58
  193. package/src/platforms/webex/commands/message.test.ts +78 -121
  194. package/src/platforms/webex/commands/snapshot.test.ts +59 -46
  195. package/src/platforms/webex/commands/space.test.ts +49 -48
  196. package/src/platforms/webex/encryption.ts +53 -0
  197. package/src/platforms/webex/ensure-auth.ts +4 -0
  198. package/src/platforms/webex/token-extractor.ts +107 -40
  199. package/src/platforms/webex/types.ts +4 -0
  200. package/src/platforms/webex/typings/node-jose.d.ts +27 -0
  201. package/src/platforms/wechatbot/cli.ts +24 -0
  202. package/src/platforms/wechatbot/client.test.ts +497 -0
  203. package/src/platforms/wechatbot/client.ts +268 -0
  204. package/src/platforms/wechatbot/commands/auth.test.ts +211 -0
  205. package/src/platforms/wechatbot/commands/auth.ts +203 -0
  206. package/src/platforms/wechatbot/commands/index.ts +4 -0
  207. package/src/platforms/wechatbot/commands/message.test.ts +155 -0
  208. package/src/platforms/wechatbot/commands/message.ts +104 -0
  209. package/src/platforms/wechatbot/commands/shared.ts +22 -0
  210. package/src/platforms/wechatbot/commands/template.test.ts +199 -0
  211. package/src/platforms/wechatbot/commands/template.ts +102 -0
  212. package/src/platforms/wechatbot/commands/user.test.ts +165 -0
  213. package/src/platforms/wechatbot/commands/user.ts +75 -0
  214. package/src/platforms/wechatbot/credential-manager.test.ts +255 -0
  215. package/src/platforms/wechatbot/credential-manager.ts +148 -0
  216. package/src/platforms/wechatbot/index.test.ts +49 -0
  217. package/src/platforms/wechatbot/index.ts +19 -0
  218. package/src/platforms/wechatbot/types.test.ts +223 -0
  219. package/src/platforms/wechatbot/types.ts +107 -0
  220. package/src/platforms/whatsapp/client.ts +24 -13
  221. package/src/platforms/whatsapp/commands/auth.test.ts +311 -0
  222. package/src/platforms/whatsapp/commands/auth.ts +21 -17
  223. package/src/platforms/whatsapp/commands/chat.test.ts +198 -0
  224. package/src/platforms/whatsapp/commands/message.test.ts +231 -0
  225. package/src/platforms/whatsapp/credential-manager.test.ts +20 -0
  226. package/src/platforms/whatsapp/credential-manager.ts +17 -8
  227. package/src/platforms/whatsappbot/commands/auth.test.ts +217 -0
  228. package/src/platforms/whatsappbot/commands/message.test.ts +198 -0
  229. package/src/platforms/whatsappbot/commands/template.test.ts +112 -0
@@ -1 +1 @@
1
- {"version":3,"file":"credential-manager.js","sourceRoot":"","sources":["../../../../src/platforms/whatsapp/credential-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EACL,eAAe,GAIhB,MAAM,SAAS,CAAA;AAEhB,MAAM,OAAO,yBAAyB;IAC5B,SAAS,CAAQ;IACjB,eAAe,CAAQ;IACvB,cAAc,CAAQ;IAE9B,YAAY,SAAkB;QAC5B,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAA;QAC3E,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,2BAA2B,CAAC,CAAA;QACxE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACxD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;QACxC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;YAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAmB,CAAA;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;QACxC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAsB;QACrC,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,MAAM,SAAS,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACzF,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAkB;QACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QAEtC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAC1E,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;QACzC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAA;QACf,CAAC;QAED,MAAM,UAAU,GAAG,eAAe,CAAC,SAAS,CAAC,CAAA;QAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAA;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QAEtC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACtD,GAAG,OAAO;YACV,UAAU,EAAE,OAAO,CAAC,UAAU,KAAK,MAAM,CAAC,OAAO;SAClD,CAAC,CAAC,CAAA;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAwB;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACtC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAA;QAE7C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,UAAU,CAAA;QACrC,CAAC;QAED,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACtC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAA;QAEzF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,UAAU,CAAA;QACnC,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;QAC7B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACtC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAA;QAEzF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,KAAK,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QAE1C,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;YAC1C,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;QAC1D,CAAC;QAED,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;QAC7B,MAAM,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAChG,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,IAAI,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YACrC,MAAM,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,CAAC;QAED,IAAI,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YACpC,MAAM,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;IAED,eAAe,CAAC,SAAiB;QAC/B,MAAM,aAAa,GAAG,eAAe,CAAC,SAAS,CAAC,CAAA;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAA;QAE3D,OAAO;YACL,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC;SACnC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,SAAiB;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;QAC7C,MAAM,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,OAAO,KAAK,CAAA;IACd,CAAC;CACF"}
1
+ {"version":3,"file":"credential-manager.js","sourceRoot":"","sources":["../../../../src/platforms/whatsapp/credential-manager.ts"],"names":[],"mappings":"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"}
@@ -24,7 +24,7 @@ Agent Skills provide this knowledge in a structured format that AI agents can un
24
24
  The fastest way to add Agent Messenger skills to your project:
25
25
 
26
26
  ```bash
27
- npx skills add devxoul/agent-messenger
27
+ npx skills add agent-messenger/agent-messenger
28
28
  ```
29
29
 
30
30
  This adds the skill files to your project's `.skills/` directory. See [skills.sh](https://skills.sh/) for more details.
@@ -35,14 +35,14 @@ Add Agent Messenger skills to Claude Code:
35
35
 
36
36
  ```bash
37
37
  # From terminal
38
- claude plugin marketplace add devxoul/agent-messenger
38
+ claude plugin marketplace add agent-messenger/agent-messenger
39
39
  claude plugin install agent-messenger
40
40
  ```
41
41
 
42
42
  Or from within Claude Code:
43
43
 
44
44
  ```
45
- /plugin marketplace add devxoul/agent-messenger
45
+ /plugin marketplace add agent-messenger/agent-messenger
46
46
  /plugin install agent-messenger
47
47
  ```
48
48
 
@@ -95,4 +95,4 @@ Each platform skill includes:
95
95
 
96
96
  - [Agent Skills Documentation](https://agentskills.io/)
97
97
  - [Skills CLI](https://skills.sh/)
98
- - [GitHub Repository](https://github.com/devxoul/agent-messenger)
98
+ - [GitHub Repository](https://github.com/agent-messenger/agent-messenger)
@@ -258,7 +258,7 @@ npx -y agent-messenger channeltalk snapshot --pretty
258
258
 
259
259
  ## AI Agent Integration
260
260
 
261
- See [`skills/agent-channeltalk/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-channeltalk) for:
261
+ See [`skills/agent-channeltalk/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-channeltalk) for:
262
262
 
263
263
  - Complete skill documentation
264
264
  - Common patterns for AI agent workflows
@@ -255,7 +255,7 @@ Channel Talk enforces rate limits on API calls. The CLI automatically retries on
255
255
 
256
256
  ## AI Agent Integration
257
257
 
258
- See [`skills/agent-channeltalkbot/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-channeltalkbot) for:
258
+ See [`skills/agent-channeltalkbot/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-channeltalkbot) for:
259
259
 
260
260
  - Complete skill documentation
261
261
  - Common patterns for AI agent workflows
@@ -268,7 +268,7 @@ All commands support these options:
268
268
 
269
269
  ## AI Agent Integration
270
270
 
271
- See [`skills/agent-discord/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-discord) for:
271
+ See [`skills/agent-discord/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-discord) for:
272
272
 
273
273
  - Complete skill documentation
274
274
  - Runnable templates
@@ -261,7 +261,7 @@ All commands support these options:
261
261
 
262
262
  ## AI Agent Integration
263
263
 
264
- See [`skills/agent-discordbot/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-discordbot) for:
264
+ See [`skills/agent-discordbot/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-discordbot) for:
265
265
 
266
266
  - Complete skill documentation
267
267
  - Runnable templates
@@ -227,7 +227,7 @@ agent-instagram auth login
227
227
 
228
228
  ## AI Agent Integration
229
229
 
230
- See [`skills/agent-instagram/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-instagram) for:
230
+ See [`skills/agent-instagram/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-instagram) for:
231
231
 
232
232
  - Complete skill documentation
233
233
  - Common patterns for AI agent workflows
@@ -280,7 +280,7 @@ If this file doesn't exist:
280
280
 
281
281
  ## AI Agent Integration
282
282
 
283
- See [`skills/agent-kakaotalk/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-kakaotalk) for:
283
+ See [`skills/agent-kakaotalk/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-kakaotalk) for:
284
284
 
285
285
  - Complete skill documentation
286
286
  - Common patterns for AI agent workflows
@@ -300,7 +300,7 @@ try {
300
300
 
301
301
  ## AI Agent Integration
302
302
 
303
- See [`skills/agent-line/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-line) for:
303
+ See [`skills/agent-line/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-line) for:
304
304
 
305
305
  - Complete skill documentation
306
306
  - Common patterns for AI agent workflows
@@ -11,6 +11,7 @@
11
11
  "whatsapp",
12
12
  "whatsappbot",
13
13
  "line",
14
+ "wechatbot",
14
15
  "instagram",
15
16
  "kakaotalk",
16
17
  "channeltalk",
@@ -389,7 +389,7 @@ agent-slack emoji list
389
389
 
390
390
  ## AI Agent Integration
391
391
 
392
- See [`skills/agent-slack/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-slack) for:
392
+ See [`skills/agent-slack/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-slack) for:
393
393
 
394
394
  - Complete skill documentation
395
395
  - Runnable templates
@@ -208,7 +208,7 @@ agent-slackbot reaction remove <channel> <ts> <emoji>
208
208
 
209
209
  ## AI Agent Integration
210
210
 
211
- See [`skills/agent-slackbot/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-slackbot) for:
211
+ See [`skills/agent-slackbot/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-slackbot) for:
212
212
 
213
213
  - Complete skill documentation
214
214
  - Runnable templates
@@ -294,7 +294,7 @@ Some operations require specific Microsoft 365 permissions. Check with your IT a
294
294
 
295
295
  ## AI Agent Integration
296
296
 
297
- See [`skills/agent-teams/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-teams) for:
297
+ See [`skills/agent-teams/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-teams) for:
298
298
 
299
299
  - Complete skill documentation
300
300
  - Runnable templates
@@ -31,11 +31,13 @@ agent-webex auth extract
31
31
  This command:
32
32
 
33
33
  - Scans Chromium browser profiles for Webex localStorage data (LevelDB)
34
- - Extracts the first-party supertoken and device URL
34
+ - Extracts the first-party supertoken, device URL, and user ID
35
+ - Extracts cached KMS encryption keys for end-to-end encrypted messaging
35
36
  - Validates the token against the Webex API
36
- - Stores credentials in `~/.config/agent-messenger/`
37
+ - Stores credentials and encryption keys in `~/.config/agent-messenger/`
37
38
  - Supported browsers: Chrome, Chrome Canary, Edge, Arc, Brave, Vivaldi, Chromium
38
39
  - Auto-extraction runs when no valid token is stored, so manual extraction is rarely needed
40
+ - Messages are encrypted client-side (JWE/AES-256-GCM) when encryption keys are available; falls back to plaintext otherwise. Re-run `auth extract` to refresh keys for new conversations.
39
41
 
40
42
  ### OAuth Device Grant (Fallback)
41
43
 
@@ -266,7 +268,7 @@ npm install -g agent-messenger
266
268
 
267
269
  ## AI Agent Integration
268
270
 
269
- See [`skills/agent-webex/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-webex) for:
271
+ See [`skills/agent-webex/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-webex) for:
270
272
 
271
273
  - Complete skill documentation
272
274
  - Common patterns and runnable templates
@@ -0,0 +1,179 @@
1
+ ---
2
+ title: WeChat Bot
3
+ description: Complete reference for the agent-wechatbot CLI.
4
+ ---
5
+
6
+ > **Tip**: `agent-wechatbot` is a shortcut for `agent-messenger wechatbot`.
7
+
8
+ ## Quick Start
9
+
10
+ ```bash
11
+ # 1. Set your API credentials
12
+ agent-wechatbot auth set your-app-id your-app-secret
13
+
14
+ # 2. Verify authentication
15
+ agent-wechatbot auth status
16
+
17
+ # 3. List available templates
18
+ agent-wechatbot template list --pretty
19
+
20
+ # 4. Send a text message (recipient must have interacted within 48h)
21
+ agent-wechatbot message send oXXXXXXXXXXXXXXX "Hello from the CLI!"
22
+ ```
23
+
24
+ ## Key Concepts
25
+
26
+ WeChat Official Account API works differently from typical messaging APIs:
27
+
28
+ | Concept | Description |
29
+ | ------------------------ | -------------------------------------------------------------------------------- |
30
+ | **Send-only** | Cannot list or read received messages. Inbound messages require webhooks. |
31
+ | **Customer service messages** | Free-form text, image, and news messages within 48h of user's last interaction. |
32
+ | **Template messages** | Pre-approved templates can be sent at any time. Created in the WeChat admin panel. |
33
+ | **App ID + App Secret** | Credentials from WeChat Official Account admin panel under Development settings. |
34
+ | **OpenID** | Each follower has a unique OpenID scoped to your Official Account. |
35
+ | **IP Whitelist** | Your server IP must be added to the account's whitelist or API calls fail (40164). |
36
+
37
+ ## Authentication
38
+
39
+ ### API Credential Setup
40
+
41
+ agent-wechatbot uses App ID + App Secret pairs from the WeChat Official Account admin panel:
42
+
43
+ ```bash
44
+ # Set credentials (validates against WeChat API before saving)
45
+ agent-wechatbot auth set <app-id> <app-secret>
46
+
47
+ # Check auth status
48
+ agent-wechatbot auth status
49
+ agent-wechatbot auth status --account <account-id>
50
+
51
+ # Clear stored credentials
52
+ agent-wechatbot auth clear
53
+ ```
54
+
55
+ ### How to Get API Credentials
56
+
57
+ 1. Log in to the [WeChat Official Account admin panel](https://mp.weixin.qq.com/)
58
+ 2. Navigate to **Development > Basic Configuration**
59
+ 3. Copy your **App ID** and **App Secret** (you may need to reset the secret if you don't have it saved)
60
+ 4. Add your server's IP to the **IP Whitelist**
61
+ 5. Run `agent-wechatbot auth set <app-id> <app-secret>`
62
+
63
+ ### Multi-Account Management
64
+
65
+ ```bash
66
+ # List stored accounts
67
+ agent-wechatbot auth list
68
+
69
+ # Switch active account
70
+ agent-wechatbot auth use <account-id>
71
+
72
+ # Remove a stored account
73
+ agent-wechatbot auth remove <account-id>
74
+ ```
75
+
76
+ ## Commands
77
+
78
+ ### Message Commands
79
+
80
+ ```bash
81
+ # Send a text message (customer service, within 48h window)
82
+ agent-wechatbot message send <open-id> <text>
83
+ agent-wechatbot message send oABCD1234 "Your order has shipped!"
84
+
85
+ # Send an image message (customer service, within 48h window)
86
+ agent-wechatbot message send-image <open-id> <media-id>
87
+ agent-wechatbot message send-image oABCD1234 MEDIA_ID_HERE
88
+
89
+ # Send a news/article message (customer service, within 48h window)
90
+ agent-wechatbot message send-news <open-id> \
91
+ --title "Title" --description "Desc" --url "https://..." --picurl "https://..."
92
+ ```
93
+
94
+ ### Template Commands
95
+
96
+ ```bash
97
+ # List all private templates
98
+ agent-wechatbot template list
99
+
100
+ # Send a template message
101
+ agent-wechatbot template send <open-id> <template-id>
102
+ agent-wechatbot template send oABCD1234 TM00001 \
103
+ --data '{"order_id":{"value":"ORD-9876"},"customer_name":{"value":"Alice"}}' \
104
+ --url "https://example.com/order/9876"
105
+
106
+ # Delete a template
107
+ agent-wechatbot template delete <template-id>
108
+ ```
109
+
110
+ ### User Commands
111
+
112
+ ```bash
113
+ # List followers (paginated)
114
+ agent-wechatbot user list
115
+ agent-wechatbot user list --next-openid oLAST_OPENID
116
+
117
+ # Get user info by OpenID
118
+ agent-wechatbot user get <open-id>
119
+ agent-wechatbot user get oABCD1234 --lang en
120
+ ```
121
+
122
+ ## Global Options
123
+
124
+ | Option | Description |
125
+ | ---------------- | -------------------------------------- |
126
+ | `--pretty` | Human-readable output instead of JSON |
127
+ | `--account <id>` | Use a specific account for this command |
128
+
129
+ ## Storage
130
+
131
+ Credentials stored in `~/.config/agent-messenger/wechatbot-credentials.json` (0600 permissions).
132
+
133
+ ## Limitations
134
+
135
+ - **Cannot list or read received messages** -- WeChat Official Account API delivers inbound messages via webhooks only. This CLI is send-only.
136
+ - **Customer service messages require 48h window** -- Free-form text, image, and news messages only work within 48 hours of the user's last interaction.
137
+ - **Template messages require pre-approval** -- Templates must be created and approved in the WeChat admin panel before use.
138
+ - **IP whitelist required** -- Your server's IP must be added to the Official Account's whitelist (error 40164).
139
+ - **Media IDs required for images** -- Images must be uploaded to WeChat's media platform first. The CLI accepts media IDs, not URLs.
140
+ - **No group chat support** -- Official Account API communicates with individual followers only.
141
+ - **No real-time events / WebSocket connection** -- Inbound messages require a separate webhook server.
142
+ - **No message editing or deletion**
143
+ - **No voice or video calls**
144
+ - **Access tokens expire** -- Tokens are valid for 7200 seconds. The CLI handles automatic refresh.
145
+
146
+ ## Troubleshooting
147
+
148
+ ### `agent-wechatbot: command not found`
149
+
150
+ **`agent-wechatbot` is NOT the npm package name.** The npm package is `agent-messenger`.
151
+
152
+ ```bash
153
+ # If installed globally
154
+ agent-wechatbot message send oABCD1234 "Hello"
155
+
156
+ # If not installed, use npx
157
+ npx -y agent-messenger wechatbot message send oABCD1234 "Hello"
158
+ ```
159
+
160
+ ### IP whitelist errors (40164)
161
+
162
+ If you get error `40164`, your server's IP is not in the Official Account's whitelist. Add it in the admin panel under **Development > Basic Configuration > IP Whitelist**.
163
+
164
+ ### Token errors (40001, 42001)
165
+
166
+ These indicate an expired or invalid access token. The CLI handles automatic token refresh, but if you see persistent errors:
167
+ - Verify your App Secret hasn't been reset in the admin panel
168
+ - Re-run `agent-wechatbot auth set <app-id> <app-secret>` with the current credentials
169
+
170
+ ### Rate limiting (45009)
171
+
172
+ WeChat enforces API call frequency limits. If you hit error `45009`, wait before retrying. For bulk operations, add delays between requests.
173
+
174
+ ## AI Agent Integration
175
+
176
+ See [`skills/agent-wechatbot/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-wechatbot) for:
177
+
178
+ - Complete skill documentation
179
+ - Common patterns for AI agent workflows
@@ -157,7 +157,7 @@ agent-whatsapp auth login --phone +1234567890
157
157
 
158
158
  ## AI Agent Integration
159
159
 
160
- See [`skills/agent-whatsapp/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-whatsapp) for:
160
+ See [`skills/agent-whatsapp/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-whatsapp) for:
161
161
 
162
162
  - Complete skill documentation
163
163
  - Common patterns for AI agent workflows
@@ -163,7 +163,7 @@ WhatsApp enforces rate limits based on your business tier. The CLI automatically
163
163
 
164
164
  ## AI Agent Integration
165
165
 
166
- See [`skills/agent-whatsappbot/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-whatsappbot) for:
166
+ See [`skills/agent-whatsappbot/`](https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-whatsappbot) for:
167
167
 
168
168
  - Complete skill documentation
169
169
  - Common patterns for AI agent workflows
@@ -1,4 +1,4 @@
1
1
  {
2
2
  "title": "TypeScript SDK",
3
- "pages": ["slack", "discord", "teams", "webex", "whatsapp", "whatsappbot", "line", "instagram", "kakaotalk", "channeltalk", "channeltalkbot"]
3
+ "pages": ["slack", "discord", "teams", "webex", "whatsapp", "whatsappbot", "line", "wechatbot", "instagram", "kakaotalk", "channeltalk", "channeltalkbot"]
4
4
  }