@captain-app/openclaw 2026.2.4

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 (1686) hide show
  1. package/CHANGELOG.md +1528 -0
  2. package/LICENSE +21 -0
  3. package/README-header.png +0 -0
  4. package/README.md +539 -0
  5. package/assets/avatar-placeholder.svg +19 -0
  6. package/assets/chrome-extension/README.md +22 -0
  7. package/assets/chrome-extension/background.js +438 -0
  8. package/assets/chrome-extension/icons/icon128.png +0 -0
  9. package/assets/chrome-extension/icons/icon16.png +0 -0
  10. package/assets/chrome-extension/icons/icon32.png +0 -0
  11. package/assets/chrome-extension/icons/icon48.png +0 -0
  12. package/assets/chrome-extension/manifest.json +25 -0
  13. package/assets/chrome-extension/options.html +196 -0
  14. package/assets/chrome-extension/options.js +59 -0
  15. package/assets/dmg-background-small.png +0 -0
  16. package/assets/dmg-background.png +0 -0
  17. package/dist/accounts-ClnuDahN.js +250 -0
  18. package/dist/accounts-DzBgAM3C.js +251 -0
  19. package/dist/acp-cli-BEDDkzXH.js +926 -0
  20. package/dist/acp-cli-CwV4mdnW.js +923 -0
  21. package/dist/agent-CArjbSeE.js +695 -0
  22. package/dist/agent-CB7x5HLT.js +695 -0
  23. package/dist/agent-scope-BbT4OG2N.js +545 -0
  24. package/dist/agent-scope-C_O6Vpl0.js +545 -0
  25. package/dist/agent-scope-Csu2B6AM.js +606 -0
  26. package/dist/archive-CWrnG1CH.js +85 -0
  27. package/dist/archive-ccN9aDgq.js +85 -0
  28. package/dist/audit-DXPkQ275.js +1686 -0
  29. package/dist/audit-eH7nwgsM.js +1686 -0
  30. package/dist/auth-health-Bj7Gjbv0.js +149 -0
  31. package/dist/auth-health-CjjJhHey.js +149 -0
  32. package/dist/auth-nnRYiqpH.js +192 -0
  33. package/dist/auth-profiles-DVLfuixr.js +2954 -0
  34. package/dist/auth-y1BLPUhX.js +192 -0
  35. package/dist/boolean-Wzu0-e0P.js +30 -0
  36. package/dist/brew-Cqi8b49_.js +46 -0
  37. package/dist/brew-DyBGNK8A.js +46 -0
  38. package/dist/build-info.json +5 -0
  39. package/dist/call-B7EveN4V.js +252 -0
  40. package/dist/call-vuUQIjOj.js +252 -0
  41. package/dist/canvas-host/a2ui/.bundle.hash +1 -0
  42. package/dist/canvas-host/a2ui/a2ui.bundle.js +17780 -0
  43. package/dist/canvas-host/a2ui/index.html +307 -0
  44. package/dist/channel-options-CJfmOkol.js +32 -0
  45. package/dist/channel-options-lFguMTz1.js +62 -0
  46. package/dist/channel-selection-BmND9mWj.js +51 -0
  47. package/dist/channel-selection-cGhL9G0c.js +51 -0
  48. package/dist/channel-summary-B4G513Eb.js +1154 -0
  49. package/dist/channel-summary-MCwBCa5y.js +1154 -0
  50. package/dist/channels-cli-C2Of1mZG.js +1411 -0
  51. package/dist/channels-cli-DFynrP1H.js +1413 -0
  52. package/dist/channels-status-issues-YohTjZ-I.js +18 -0
  53. package/dist/channels-status-issues-ZcR1U-m5.js +18 -0
  54. package/dist/chrome-B3IuUad-.js +1953 -0
  55. package/dist/chrome-BZ9K48w9.js +1973 -0
  56. package/dist/clack-prompter-B9yLhyOm.js +92 -0
  57. package/dist/clack-prompter-BybM9xdL.js +92 -0
  58. package/dist/cli/daemon-cli.js +2 -0
  59. package/dist/cli-BJZdJwug.js +89 -0
  60. package/dist/cli-BQSoKu3d.js +86 -0
  61. package/dist/cli-utils-CO4jEMn0.js +43 -0
  62. package/dist/cli-utils-gtE-0a0D.js +43 -0
  63. package/dist/client-DPqNOpK3.js +1609 -0
  64. package/dist/client-DySXIFCA.js +1609 -0
  65. package/dist/command-format-CFzL448l.js +52 -0
  66. package/dist/command-format-DELazozB.js +52 -0
  67. package/dist/command-format-ayFsmwwz.js +38 -0
  68. package/dist/command-options-CsjxK4cZ.js +33 -0
  69. package/dist/commands-BRe9VTyU.js +229 -0
  70. package/dist/completion-cli-DlkjK0iC.js +390 -0
  71. package/dist/completion-cli-E6Pt41AL.js +387 -0
  72. package/dist/config-BtSTwPcH.js +4882 -0
  73. package/dist/config-DfMIMT-f.js +4881 -0
  74. package/dist/config-_d7_WcRv.js +5623 -0
  75. package/dist/config-guard-wSnm-U8a.js +5628 -0
  76. package/dist/configure-CPHAFKlg.js +895 -0
  77. package/dist/configure-DK1XgXYx.js +894 -0
  78. package/dist/constants-CNTiY-ZN.js +65 -0
  79. package/dist/constants-hpmbslG7.js +65 -0
  80. package/dist/control-service-CqX5g_ko.js +61 -0
  81. package/dist/control-service-o6xe3hEb.js +61 -0
  82. package/dist/control-ui/apple-touch-icon.png +0 -0
  83. package/dist/control-ui/assets/index-RwcW4Xl0.css +1 -0
  84. package/dist/control-ui/assets/index-ryaCcbyp.js +4584 -0
  85. package/dist/control-ui/assets/index-ryaCcbyp.js.map +1 -0
  86. package/dist/control-ui/favicon-32.png +0 -0
  87. package/dist/control-ui/favicon.ico +0 -0
  88. package/dist/control-ui/favicon.svg +22 -0
  89. package/dist/control-ui/index.html +17 -0
  90. package/dist/cron-cli-BoSaDgvH.js +453 -0
  91. package/dist/cron-cli-qVandvsD.js +456 -0
  92. package/dist/daemon-cli-C4gGWa15.js +760 -0
  93. package/dist/daemon-cli-DV_X0Krf.js +761 -0
  94. package/dist/daemon-runtime-D5hbSrdO.js +460 -0
  95. package/dist/daemon-runtime-DXUfrXBC.js +460 -0
  96. package/dist/deliver-BxK5nI2P.js +2587 -0
  97. package/dist/deliver-Dwzg9LUd.js +2557 -0
  98. package/dist/deliver-qpYZp20m.js +2587 -0
  99. package/dist/deps-CUXtMV9d.js +27 -0
  100. package/dist/deps-WBvZpFV_.js +27 -0
  101. package/dist/devices-cli-B2s18Qrh.js +207 -0
  102. package/dist/devices-cli-D1UEtMUJ.js +204 -0
  103. package/dist/directory-cli-BXQbrkfM.js +247 -0
  104. package/dist/directory-cli-CqA7tRbq.js +244 -0
  105. package/dist/dispatcher-Dyv7T-1r.js +160 -0
  106. package/dist/dns-cli-CWxKD22D.js +198 -0
  107. package/dist/dns-cli-CzKr_Fxj.js +201 -0
  108. package/dist/docs-cli-BNyxUbWr.js +159 -0
  109. package/dist/docs-cli-DYpTbo3i.js +161 -0
  110. package/dist/doctor-C8fDYZLq.js +2583 -0
  111. package/dist/doctor-hYcqp7c0.js +2585 -0
  112. package/dist/entry.js +1326 -0
  113. package/dist/env-l7QVNj6j.js +32 -0
  114. package/dist/errors-CMCg46fK.js +1952 -0
  115. package/dist/exec-B8JKbXKW.js +246 -0
  116. package/dist/exec-BMnoMcZW.js +1099 -0
  117. package/dist/exec-HEWTMJ7j.js +246 -0
  118. package/dist/exec-approvals-DtrnHx6M.js +1026 -0
  119. package/dist/exec-approvals-Y42bE8ud.js +1026 -0
  120. package/dist/exec-approvals-cli-CIedYxP3.js +385 -0
  121. package/dist/exec-approvals-cli-xpbxnj4O.js +388 -0
  122. package/dist/extensionAPI.js +66572 -0
  123. package/dist/format-Dzy9uRLE.js +34 -0
  124. package/dist/format-sj0fELBK.js +34 -0
  125. package/dist/gateway-cli-5A-KNLEC.js +16635 -0
  126. package/dist/gateway-cli-B8kS4chb.js +16637 -0
  127. package/dist/gateway-rpc-15n38Ize.js +28 -0
  128. package/dist/gateway-rpc-TMVRgGfj.js +28 -0
  129. package/dist/github-copilot-auth-DVZj4Zgh.js +1104 -0
  130. package/dist/github-copilot-auth-DeGYyLY9.js +1104 -0
  131. package/dist/github-copilot-token-B3SA95yo.js +103 -0
  132. package/dist/github-copilot-token-C8XFYz0i.js +103 -0
  133. package/dist/github-copilot-token-CnxakiSC.js +103 -0
  134. package/dist/gmail-setup-utils-CWPC386a.js +428 -0
  135. package/dist/gmail-setup-utils-eJVB5Ewp.js +428 -0
  136. package/dist/health-format-B0tMTk3C.js +1189 -0
  137. package/dist/health-format-DaURVaUn.js +1188 -0
  138. package/dist/help-format-CEsRHU2f.js +17 -0
  139. package/dist/help-format-GuCWws6r.js +17 -0
  140. package/dist/helpers-BEJ-phFf.js +25 -0
  141. package/dist/helpers-BtbBZVKZ.js +10 -0
  142. package/dist/helpers-C12w9zxf.js +10 -0
  143. package/dist/helpers-CzjGJZmJ.js +25 -0
  144. package/dist/hooks/bundled/boot-md/HOOK.md +19 -0
  145. package/dist/hooks/bundled/command-logger/HOOK.md +122 -0
  146. package/dist/hooks/bundled/session-memory/HOOK.md +109 -0
  147. package/dist/hooks/bundled/soul-evil/HOOK.md +71 -0
  148. package/dist/hooks-cli-BZCMAnW2.js +1058 -0
  149. package/dist/hooks-cli-D0CEFg3P.js +1061 -0
  150. package/dist/hooks-status-Bn7_O8PM.js +443 -0
  151. package/dist/hooks-status-BrWVfIn0.js +443 -0
  152. package/dist/image-BS022pvv.js +1421 -0
  153. package/dist/image-BzJtY34J.js +629 -0
  154. package/dist/image-CBqmIbQQ.js +629 -0
  155. package/dist/index.js +5809 -0
  156. package/dist/installs-BP4K5L33.js +388 -0
  157. package/dist/installs-DOpTt7VZ.js +388 -0
  158. package/dist/is-main-B4o72sqg.js +25 -0
  159. package/dist/is-main-PYGa3tDA.js +25 -0
  160. package/dist/links-B4nk2iDf.js +15 -0
  161. package/dist/links-DwjRqxgR.js +15 -0
  162. package/dist/loader-Cn4EV_pf.js +63690 -0
  163. package/dist/logging-CS3tbYDj.js +15 -0
  164. package/dist/logging-CY-Q5cwf.js +1 -0
  165. package/dist/logging-DhiLkhLw.js +15 -0
  166. package/dist/logging-pqyrk15z.js +1 -0
  167. package/dist/login-qr-CD164Aw1.js +478 -0
  168. package/dist/login-qr-D7Zdgji2.js +478 -0
  169. package/dist/login-qr-YgILJ4VC.js +475 -0
  170. package/dist/logs-cli-BdS0Uv0I.js +227 -0
  171. package/dist/logs-cli-CqSN1GzB.js +230 -0
  172. package/dist/manager-CfGY5zND.js +2870 -0
  173. package/dist/manager-CjuBqFRL.js +2870 -0
  174. package/dist/manager-CoBEAQKm.js +2872 -0
  175. package/dist/manifest-registry-Bwjq9Iev.js +668 -0
  176. package/dist/manifest-registry-D2Yntqcb.js +668 -0
  177. package/dist/message-channel-Cjsiqxok.js +105 -0
  178. package/dist/message-channel-D6v_oPAg.js +105 -0
  179. package/dist/model-selection-Cv5Ox_tY.js +2956 -0
  180. package/dist/model-selection-Dr-5U5-l.js +2708 -0
  181. package/dist/models-cli-B39ckynD.js +2541 -0
  182. package/dist/models-cli-DoiYsBYw.js +2544 -0
  183. package/dist/net-CFCxaipF.js +137 -0
  184. package/dist/net-DKJPqXuW.js +137 -0
  185. package/dist/node-cli-C_FYF-RA.js +1456 -0
  186. package/dist/node-cli-DWPoNsQS.js +1459 -0
  187. package/dist/node-service-DcJREOww.js +67 -0
  188. package/dist/node-service-DuZ9Us9h.js +67 -0
  189. package/dist/nodes-cli-Elo6tlen.js +1210 -0
  190. package/dist/nodes-cli-zqryRUWB.js +1207 -0
  191. package/dist/nodes-screen-C4aCrxie.js +157 -0
  192. package/dist/nodes-screen-D4PSynkR.js +157 -0
  193. package/dist/note-CQhSvgQv.js +73 -0
  194. package/dist/note-_C44YfAQ.js +73 -0
  195. package/dist/onboard-channels-CHBDi-ZA.js +670 -0
  196. package/dist/onboard-channels-DOEKyxaL.js +670 -0
  197. package/dist/onboard-skills-BUTXREDZ.js +3327 -0
  198. package/dist/onboard-skills-CSLYZmZA.js +3327 -0
  199. package/dist/onboarding-CgKb8b39.js +3232 -0
  200. package/dist/openclaw-root-9ILYSmJ9.js +84 -0
  201. package/dist/openclaw-root-Cvotktkd.js +84 -0
  202. package/dist/pairing-cli-B4UGR2at.js +114 -0
  203. package/dist/pairing-cli-BWDDl8cf.js +117 -0
  204. package/dist/pairing-labels-ClZ-fTWT.js +9 -0
  205. package/dist/pairing-labels-Ds7BPOkj.js +9 -0
  206. package/dist/pairing-store-DDLNuzmx.js +391 -0
  207. package/dist/pairing-store-DRn08lZD.js +391 -0
  208. package/dist/parse-87ybtYW1.js +23 -0
  209. package/dist/parse-OCFfznr3.js +23 -0
  210. package/dist/parse-log-line-C9aL5PUL.js +44 -0
  211. package/dist/parse-log-line-DxRaGzQb.js +44 -0
  212. package/dist/parse-timeout-CFqNj7No.js +16 -0
  213. package/dist/parse-timeout-DV8NQQWk.js +16 -0
  214. package/dist/path-env-C7kiJUgG.js +77 -0
  215. package/dist/path-env-DEj4CiFN.js +77 -0
  216. package/dist/paths-B-q1nXdY.js +43 -0
  217. package/dist/paths-B1kfl4h5.js +164 -0
  218. package/dist/paths-B4kigINg.js +40 -0
  219. package/dist/paths-CHGbP1-A.js +43 -0
  220. package/dist/paths-scjhy7N2.js +180 -0
  221. package/dist/pi-embedded-helpers-C19wUpMB.js +8451 -0
  222. package/dist/pi-embedded-helpers-CT5VuLCb.js +1293 -0
  223. package/dist/pi-embedded-helpers-Dl8e5Rf8.js +1293 -0
  224. package/dist/pi-model-discovery-B6CsmK6Y.js +20 -0
  225. package/dist/pi-model-discovery-DsRqYJLy.js +20 -0
  226. package/dist/pi-model-discovery-EhM2JAQo.js +20 -0
  227. package/dist/pi-tools.policy-BvkSDFDN.js +229 -0
  228. package/dist/plugin-auto-enable-Bd_StZzz.js +461 -0
  229. package/dist/plugin-auto-enable-DBhXb_0x.js +461 -0
  230. package/dist/plugin-sdk/agent-scope-DdwUKIOe.js +606 -0
  231. package/dist/plugin-sdk/chrome-G8apFa5p.js +1953 -0
  232. package/dist/plugin-sdk/command-format-qUVxzqYm.js +52 -0
  233. package/dist/plugin-sdk/config-Cm1M7tgH.js +5623 -0
  234. package/dist/plugin-sdk/deliver-Cl8uowiO.js +2557 -0
  235. package/dist/plugin-sdk/exec-Cm9b2r9Q.js +1107 -0
  236. package/dist/plugin-sdk/github-copilot-token-BHNcM4_B.js +103 -0
  237. package/dist/plugin-sdk/image-7PgoS2VD.js +1421 -0
  238. package/dist/plugin-sdk/index.d.ts +8908 -0
  239. package/dist/plugin-sdk/index.js +70888 -0
  240. package/dist/plugin-sdk/login-qr-qTALvWi2.js +475 -0
  241. package/dist/plugin-sdk/manager-Cs3EQZCb.js +2870 -0
  242. package/dist/plugin-sdk/model-selection-BgC1E1a7.js +2708 -0
  243. package/dist/plugin-sdk/paths-BYpoyRv5.js +164 -0
  244. package/dist/plugin-sdk/paths-DNQE-bvr.js +40 -0
  245. package/dist/plugin-sdk/pi-embedded-helpers-5jNqW_dE.js +8755 -0
  246. package/dist/plugin-sdk/pi-model-discovery-BUGEht9A.js +20 -0
  247. package/dist/plugin-sdk/pw-ai-COTtei4a.js +1649 -0
  248. package/dist/plugin-sdk/qmd-manager-ClSwiAJl.js +615 -0
  249. package/dist/plugin-sdk/redact-2AzjOfk2.js +94 -0
  250. package/dist/plugin-sdk/rolldown-runtime-Cbj13DAv.js +20 -0
  251. package/dist/plugin-sdk/sqlite-gCW7MlLs.js +215 -0
  252. package/dist/plugin-sdk/transcript-events-DGF257vD.js +17 -0
  253. package/dist/plugins-C3Bm-HQV.js +494 -0
  254. package/dist/plugins-QJjTXliB.js +495 -0
  255. package/dist/plugins-cli-DTci0JQb.js +443 -0
  256. package/dist/plugins-cli-wJsN1HHK.js +440 -0
  257. package/dist/ports-CiW9dmMq.js +96 -0
  258. package/dist/program-BWpTHh1I.js +188 -0
  259. package/dist/progress-Bcjniu7m.js +133 -0
  260. package/dist/progress-CvaSPjS9.js +133 -0
  261. package/dist/prompt-style-CFsleyxV.js +9 -0
  262. package/dist/prompt-style-DYJdrXyV.js +9 -0
  263. package/dist/prompts-Bt9fwsg2.js +10 -0
  264. package/dist/prompts-CudpZgTI.js +10 -0
  265. package/dist/pw-ai-08F3GD-3.js +1649 -0
  266. package/dist/pw-ai-ZmHxHQnx.js +1651 -0
  267. package/dist/pw-ai-tNPuRNn3.js +1649 -0
  268. package/dist/qmd-manager-2r-4n3sP.js +617 -0
  269. package/dist/qmd-manager-CF52nuBg.js +615 -0
  270. package/dist/qmd-manager-HEm5H2mk.js +616 -0
  271. package/dist/redact-BICFkpn7.js +97 -0
  272. package/dist/redact-BIMJ3ntQ.js +94 -0
  273. package/dist/redact-KzWHRS5J.js +97 -0
  274. package/dist/register.subclis-D2K25c84.js +348 -0
  275. package/dist/register.subclis-Dd8LbOLi.js +342 -0
  276. package/dist/reply-5UNWRwMn.js +63693 -0
  277. package/dist/restart-sentinel-Cr0vUxB8.js +65 -0
  278. package/dist/restart-sentinel-DUemCjgU.js +65 -0
  279. package/dist/rolldown-runtime-Cbj13DAv.js +20 -0
  280. package/dist/routes-C6UpTPas.js +2410 -0
  281. package/dist/routes-ClNyEvlm.js +2410 -0
  282. package/dist/rpc-D0mf7DIw.js +95 -0
  283. package/dist/rpc-DYdOrgd9.js +95 -0
  284. package/dist/run-main-CojI7gWx.js +194 -0
  285. package/dist/runtime-guard-68M_evhb.js +60 -0
  286. package/dist/runtime-guard-DkjmhnBD.js +60 -0
  287. package/dist/sandbox-Ca81z3Tw.js +2924 -0
  288. package/dist/sandbox-cli-D75GApgp.js +459 -0
  289. package/dist/sandbox-cli-E4SJsC1C.js +462 -0
  290. package/dist/sandbox-knontqD9.js +2925 -0
  291. package/dist/security-cli-BLihvXO-.js +503 -0
  292. package/dist/security-cli-IGQCsK4g.js +506 -0
  293. package/dist/server-context-B9GX5GOI.js +740 -0
  294. package/dist/server-context-BFH7HB_M.js +740 -0
  295. package/dist/server-node-events-CTdHBiEA.js +218 -0
  296. package/dist/server-node-events-DAV14qPr.js +215 -0
  297. package/dist/service-BZNBq9hq.js +680 -0
  298. package/dist/service-C-BLXx9U.js +680 -0
  299. package/dist/service-audit-BfJv4NqZ.js +542 -0
  300. package/dist/service-audit-Bw3M2OEI.js +542 -0
  301. package/dist/shared-5SH-45AX.js +74 -0
  302. package/dist/shared-BxRm5uLU.js +74 -0
  303. package/dist/shared-C80Rmxsd.js +150 -0
  304. package/dist/shared-fGK6_D2v.js +150 -0
  305. package/dist/skills-Bhp0l6UK.js +693 -0
  306. package/dist/skills-Tky2kCMO.js +694 -0
  307. package/dist/skills-cli-6rCClAE4.js +287 -0
  308. package/dist/skills-cli-C4nLCrLw.js +290 -0
  309. package/dist/skills-status-CENcKr3I.js +187 -0
  310. package/dist/skills-status-DX1eUYvk.js +187 -0
  311. package/dist/sqlite-CmdZSZRx.js +197 -0
  312. package/dist/sqlite-Dnmf3LS7.js +215 -0
  313. package/dist/sqlite-QDf0yuU0.js +215 -0
  314. package/dist/status-BSfGAp2D.js +27 -0
  315. package/dist/status-Bp_2NMjt.js +27 -0
  316. package/dist/status-C0ANDr0T.js +3140 -0
  317. package/dist/status-CCHBIZnm.js +21 -0
  318. package/dist/status-Vuqbw2Bb.js +21 -0
  319. package/dist/status.update-BZW5r8Su.js +79 -0
  320. package/dist/status.update-BnD93_O8.js +79 -0
  321. package/dist/subsystem-CAq3uyo7.js +834 -0
  322. package/dist/system-cli-Bb9zmCO1.js +83 -0
  323. package/dist/system-cli-TIIQ04ls.js +80 -0
  324. package/dist/systemd-0Qa_nGqe.js +438 -0
  325. package/dist/systemd-Czb0Xsm7.js +438 -0
  326. package/dist/systemd-hints-CWoEOQRb.js +19 -0
  327. package/dist/systemd-hints-Cv3RN_mZ.js +19 -0
  328. package/dist/systemd-linger-CsdvcIoS.js +75 -0
  329. package/dist/systemd-linger-DKUFHcLn.js +75 -0
  330. package/dist/table-DNPESyNj.js +279 -0
  331. package/dist/table-DS4-gmkV.js +279 -0
  332. package/dist/tailnet-Bg_vE5qi.js +42 -0
  333. package/dist/tailnet-CrNWlQRJ.js +42 -0
  334. package/dist/tailscale-CBv58toW.js +252 -0
  335. package/dist/tailscale-DCnMs7_q.js +225 -0
  336. package/dist/tool-display-BEACy9rK.js +795 -0
  337. package/dist/tool-display-NYQnSpdo.js +795 -0
  338. package/dist/transcript-events-CsB1Saa6.js +17 -0
  339. package/dist/transcript-events-DDYvbmRV.js +17 -0
  340. package/dist/transcript-events-JLH5W4He.js +17 -0
  341. package/dist/tui--NY0rnjr.js +2542 -0
  342. package/dist/tui-DqJfGtvM.js +2543 -0
  343. package/dist/tui-cli-BuHNY6wF.js +54 -0
  344. package/dist/tui-cli-LMFV982e.js +57 -0
  345. package/dist/update-CRpHtCgz.js +317 -0
  346. package/dist/update-D3qruxhj.js +317 -0
  347. package/dist/update-cli-CFF-pslM.js +948 -0
  348. package/dist/update-cli-cn9pEMX7.js +951 -0
  349. package/dist/update-runner-CxGU142L.js +1221 -0
  350. package/dist/update-runner-DNobz_ft.js +1221 -0
  351. package/dist/utils-CKSrBNwq.js +192 -0
  352. package/dist/utils-DX85MiPR.js +188 -0
  353. package/dist/webhooks-cli-BGtt2HAR.js +312 -0
  354. package/dist/webhooks-cli-DHLZrEO_.js +309 -0
  355. package/dist/widearea-dns-BpG7ATO8.js +127 -0
  356. package/dist/widearea-dns-D4wkCJly.js +127 -0
  357. package/dist/ws-3zr8WUwL.js +13 -0
  358. package/dist/ws-log-BXcT2xQk.js +267 -0
  359. package/dist/ws-log-DbDIUsgz.js +267 -0
  360. package/dist/ws-lzrgabja.js +13 -0
  361. package/dist/wsl-D2O2qOrl.js +160 -0
  362. package/docs/.i18n/README.md +31 -0
  363. package/docs/.i18n/glossary.zh-CN.json +190 -0
  364. package/docs/.i18n/zh-CN.tm.jsonl +1329 -0
  365. package/docs/CNAME +1 -0
  366. package/docs/_config.yml +53 -0
  367. package/docs/_layouts/default.html +145 -0
  368. package/docs/assets/markdown.css +179 -0
  369. package/docs/assets/openclaw-logo-text-dark.png +0 -0
  370. package/docs/assets/openclaw-logo-text.png +0 -0
  371. package/docs/assets/pixel-lobster.svg +60 -0
  372. package/docs/assets/showcase/agents-ui.jpg +0 -0
  373. package/docs/assets/showcase/bambu-cli.png +0 -0
  374. package/docs/assets/showcase/codexmonitor.png +0 -0
  375. package/docs/assets/showcase/gohome-grafana.png +0 -0
  376. package/docs/assets/showcase/ios-testflight.jpg +0 -0
  377. package/docs/assets/showcase/oura-health.png +0 -0
  378. package/docs/assets/showcase/padel-cli.svg +11 -0
  379. package/docs/assets/showcase/padel-screenshot.jpg +0 -0
  380. package/docs/assets/showcase/papla-tts.jpg +0 -0
  381. package/docs/assets/showcase/pr-review-telegram.jpg +0 -0
  382. package/docs/assets/showcase/roborock-screenshot.jpg +0 -0
  383. package/docs/assets/showcase/roborock-status.svg +13 -0
  384. package/docs/assets/showcase/roof-camera-sky.jpg +0 -0
  385. package/docs/assets/showcase/snag.png +0 -0
  386. package/docs/assets/showcase/tesco-shop.jpg +0 -0
  387. package/docs/assets/showcase/wienerlinien.png +0 -0
  388. package/docs/assets/showcase/wine-cellar-skill.jpg +0 -0
  389. package/docs/assets/showcase/winix-air-purifier.jpg +0 -0
  390. package/docs/assets/showcase/xuezh-pronunciation.jpeg +0 -0
  391. package/docs/assets/terminal.css +473 -0
  392. package/docs/assets/theme.js +55 -0
  393. package/docs/automation/auth-monitoring.md +44 -0
  394. package/docs/automation/cron-jobs.md +468 -0
  395. package/docs/automation/cron-vs-heartbeat.md +282 -0
  396. package/docs/automation/gmail-pubsub.md +256 -0
  397. package/docs/automation/poll.md +69 -0
  398. package/docs/automation/webhook.md +163 -0
  399. package/docs/bedrock.md +176 -0
  400. package/docs/brave-search.md +41 -0
  401. package/docs/broadcast-groups.md +442 -0
  402. package/docs/channels/bluebubbles.md +338 -0
  403. package/docs/channels/discord.md +475 -0
  404. package/docs/channels/feishu.md +507 -0
  405. package/docs/channels/googlechat.md +250 -0
  406. package/docs/channels/grammy.md +31 -0
  407. package/docs/channels/imessage.md +299 -0
  408. package/docs/channels/index.md +46 -0
  409. package/docs/channels/line.md +186 -0
  410. package/docs/channels/location.md +56 -0
  411. package/docs/channels/matrix.md +233 -0
  412. package/docs/channels/mattermost.md +138 -0
  413. package/docs/channels/msteams.md +768 -0
  414. package/docs/channels/nextcloud-talk.md +136 -0
  415. package/docs/channels/nostr.md +233 -0
  416. package/docs/channels/signal.md +202 -0
  417. package/docs/channels/slack.md +548 -0
  418. package/docs/channels/telegram.md +750 -0
  419. package/docs/channels/tlon.md +132 -0
  420. package/docs/channels/troubleshooting.md +29 -0
  421. package/docs/channels/twitch.md +379 -0
  422. package/docs/channels/whatsapp.md +404 -0
  423. package/docs/channels/zalo.md +189 -0
  424. package/docs/channels/zalouser.md +140 -0
  425. package/docs/cli/acp.md +170 -0
  426. package/docs/cli/agent.md +24 -0
  427. package/docs/cli/agents.md +75 -0
  428. package/docs/cli/approvals.md +50 -0
  429. package/docs/cli/browser.md +107 -0
  430. package/docs/cli/channels.md +79 -0
  431. package/docs/cli/config.md +50 -0
  432. package/docs/cli/configure.md +33 -0
  433. package/docs/cli/cron.md +42 -0
  434. package/docs/cli/dashboard.md +16 -0
  435. package/docs/cli/devices.md +67 -0
  436. package/docs/cli/directory.md +63 -0
  437. package/docs/cli/dns.md +23 -0
  438. package/docs/cli/docs.md +15 -0
  439. package/docs/cli/doctor.md +41 -0
  440. package/docs/cli/gateway.md +199 -0
  441. package/docs/cli/health.md +21 -0
  442. package/docs/cli/hooks.md +304 -0
  443. package/docs/cli/index.md +1029 -0
  444. package/docs/cli/logs.md +24 -0
  445. package/docs/cli/memory.md +45 -0
  446. package/docs/cli/message.md +239 -0
  447. package/docs/cli/models.md +79 -0
  448. package/docs/cli/node.md +112 -0
  449. package/docs/cli/nodes.md +73 -0
  450. package/docs/cli/onboard.md +29 -0
  451. package/docs/cli/pairing.md +21 -0
  452. package/docs/cli/plugins.md +62 -0
  453. package/docs/cli/reset.md +17 -0
  454. package/docs/cli/sandbox.md +152 -0
  455. package/docs/cli/security.md +26 -0
  456. package/docs/cli/sessions.md +16 -0
  457. package/docs/cli/setup.md +29 -0
  458. package/docs/cli/skills.md +26 -0
  459. package/docs/cli/status.md +26 -0
  460. package/docs/cli/system.md +60 -0
  461. package/docs/cli/tui.md +23 -0
  462. package/docs/cli/uninstall.md +17 -0
  463. package/docs/cli/update.md +98 -0
  464. package/docs/cli/voicecall.md +34 -0
  465. package/docs/cli/webhooks.md +25 -0
  466. package/docs/concepts/agent-loop.md +146 -0
  467. package/docs/concepts/agent-workspace.md +233 -0
  468. package/docs/concepts/agent.md +123 -0
  469. package/docs/concepts/architecture.md +129 -0
  470. package/docs/concepts/channel-routing.md +114 -0
  471. package/docs/concepts/compaction.md +61 -0
  472. package/docs/concepts/context.md +161 -0
  473. package/docs/concepts/group-messages.md +84 -0
  474. package/docs/concepts/groups.md +373 -0
  475. package/docs/concepts/markdown-formatting.md +130 -0
  476. package/docs/concepts/memory.md +546 -0
  477. package/docs/concepts/messages.md +154 -0
  478. package/docs/concepts/model-failover.md +149 -0
  479. package/docs/concepts/model-providers.md +316 -0
  480. package/docs/concepts/models.md +208 -0
  481. package/docs/concepts/multi-agent.md +376 -0
  482. package/docs/concepts/oauth.md +145 -0
  483. package/docs/concepts/presence.md +102 -0
  484. package/docs/concepts/queue.md +89 -0
  485. package/docs/concepts/retry.md +69 -0
  486. package/docs/concepts/session-pruning.md +122 -0
  487. package/docs/concepts/session-tool.md +193 -0
  488. package/docs/concepts/session.md +188 -0
  489. package/docs/concepts/sessions.md +10 -0
  490. package/docs/concepts/streaming.md +135 -0
  491. package/docs/concepts/system-prompt.md +115 -0
  492. package/docs/concepts/timezone.md +91 -0
  493. package/docs/concepts/typebox.md +289 -0
  494. package/docs/concepts/typing-indicators.md +68 -0
  495. package/docs/concepts/usage-tracking.md +35 -0
  496. package/docs/date-time.md +128 -0
  497. package/docs/debug/node-issue.md +83 -0
  498. package/docs/debugging.md +162 -0
  499. package/docs/diagnostics/flags.md +91 -0
  500. package/docs/docs.json +1587 -0
  501. package/docs/environment.md +81 -0
  502. package/docs/experiments/onboarding-config-protocol.md +40 -0
  503. package/docs/experiments/plans/cron-add-hardening.md +63 -0
  504. package/docs/experiments/plans/group-policy-hardening.md +40 -0
  505. package/docs/experiments/plans/openresponses-gateway.md +123 -0
  506. package/docs/experiments/proposals/model-config.md +36 -0
  507. package/docs/experiments/research/memory.md +228 -0
  508. package/docs/gateway/authentication.md +145 -0
  509. package/docs/gateway/background-process.md +93 -0
  510. package/docs/gateway/bonjour.md +167 -0
  511. package/docs/gateway/bridge-protocol.md +89 -0
  512. package/docs/gateway/cli-backends.md +223 -0
  513. package/docs/gateway/configuration-examples.md +606 -0
  514. package/docs/gateway/configuration.md +3393 -0
  515. package/docs/gateway/discovery.md +116 -0
  516. package/docs/gateway/doctor.md +282 -0
  517. package/docs/gateway/gateway-lock.md +34 -0
  518. package/docs/gateway/health.md +35 -0
  519. package/docs/gateway/heartbeat.md +302 -0
  520. package/docs/gateway/index.md +328 -0
  521. package/docs/gateway/local-models.md +150 -0
  522. package/docs/gateway/logging.md +113 -0
  523. package/docs/gateway/multiple-gateways.md +112 -0
  524. package/docs/gateway/openai-http-api.md +118 -0
  525. package/docs/gateway/openresponses-http-api.md +317 -0
  526. package/docs/gateway/pairing.md +99 -0
  527. package/docs/gateway/protocol.md +221 -0
  528. package/docs/gateway/remote-gateway-readme.md +157 -0
  529. package/docs/gateway/remote.md +127 -0
  530. package/docs/gateway/sandbox-vs-tool-policy-vs-elevated.md +128 -0
  531. package/docs/gateway/sandboxing.md +193 -0
  532. package/docs/gateway/security/formal-verification.md +164 -0
  533. package/docs/gateway/security/index.md +825 -0
  534. package/docs/gateway/tailscale.md +127 -0
  535. package/docs/gateway/tools-invoke-http-api.md +85 -0
  536. package/docs/gateway/troubleshooting.md +767 -0
  537. package/docs/help/faq.md +2830 -0
  538. package/docs/help/index.md +21 -0
  539. package/docs/help/troubleshooting.md +98 -0
  540. package/docs/hooks/soul-evil.md +69 -0
  541. package/docs/hooks.md +913 -0
  542. package/docs/images/feishu-step2-create-app.png +0 -0
  543. package/docs/images/feishu-step3-credentials.png +0 -0
  544. package/docs/images/feishu-step4-permissions.png +0 -0
  545. package/docs/images/feishu-step5-bot-capability.png +0 -0
  546. package/docs/images/feishu-step6-event-subscription.png +0 -0
  547. package/docs/images/groups-flow.svg +52 -0
  548. package/docs/images/mobile-ui-screenshot.png +0 -0
  549. package/docs/index.md +258 -0
  550. package/docs/install/ansible.md +208 -0
  551. package/docs/install/bun.md +59 -0
  552. package/docs/install/development-channels.md +75 -0
  553. package/docs/install/docker.md +567 -0
  554. package/docs/install/index.md +185 -0
  555. package/docs/install/installer.md +123 -0
  556. package/docs/install/migrating.md +192 -0
  557. package/docs/install/nix.md +96 -0
  558. package/docs/install/node.md +78 -0
  559. package/docs/install/uninstall.md +128 -0
  560. package/docs/install/updating.md +228 -0
  561. package/docs/logging.md +350 -0
  562. package/docs/multi-agent-sandbox-tools.md +395 -0
  563. package/docs/network.md +54 -0
  564. package/docs/nodes/audio.md +114 -0
  565. package/docs/nodes/camera.md +156 -0
  566. package/docs/nodes/images.md +72 -0
  567. package/docs/nodes/index.md +341 -0
  568. package/docs/nodes/location-command.md +113 -0
  569. package/docs/nodes/media-understanding.md +379 -0
  570. package/docs/nodes/talk.md +90 -0
  571. package/docs/nodes/voicewake.md +65 -0
  572. package/docs/northflank.mdx +53 -0
  573. package/docs/perplexity.md +80 -0
  574. package/docs/pi-dev.md +70 -0
  575. package/docs/pi.md +612 -0
  576. package/docs/platforms/android.md +148 -0
  577. package/docs/platforms/digitalocean.md +262 -0
  578. package/docs/platforms/exe-dev.md +125 -0
  579. package/docs/platforms/fly.md +486 -0
  580. package/docs/platforms/gcp.md +503 -0
  581. package/docs/platforms/hetzner.md +330 -0
  582. package/docs/platforms/index.md +53 -0
  583. package/docs/platforms/ios.md +107 -0
  584. package/docs/platforms/linux.md +94 -0
  585. package/docs/platforms/mac/bundled-gateway.md +73 -0
  586. package/docs/platforms/mac/canvas.md +125 -0
  587. package/docs/platforms/mac/child-process.md +69 -0
  588. package/docs/platforms/mac/dev-setup.md +102 -0
  589. package/docs/platforms/mac/health.md +34 -0
  590. package/docs/platforms/mac/icon.md +31 -0
  591. package/docs/platforms/mac/logging.md +57 -0
  592. package/docs/platforms/mac/menu-bar.md +81 -0
  593. package/docs/platforms/mac/peekaboo.md +65 -0
  594. package/docs/platforms/mac/permissions.md +44 -0
  595. package/docs/platforms/mac/release.md +85 -0
  596. package/docs/platforms/mac/remote.md +83 -0
  597. package/docs/platforms/mac/signing.md +47 -0
  598. package/docs/platforms/mac/skills.md +33 -0
  599. package/docs/platforms/mac/voice-overlay.md +60 -0
  600. package/docs/platforms/mac/voicewake.md +67 -0
  601. package/docs/platforms/mac/webchat.md +41 -0
  602. package/docs/platforms/mac/xpc.md +61 -0
  603. package/docs/platforms/macos-vm.md +281 -0
  604. package/docs/platforms/macos.md +203 -0
  605. package/docs/platforms/oracle.md +303 -0
  606. package/docs/platforms/raspberry-pi.md +358 -0
  607. package/docs/platforms/windows.md +159 -0
  608. package/docs/plugin.md +664 -0
  609. package/docs/plugins/agent-tools.md +99 -0
  610. package/docs/plugins/manifest.md +71 -0
  611. package/docs/plugins/voice-call.md +284 -0
  612. package/docs/plugins/zalouser.md +81 -0
  613. package/docs/prose.md +134 -0
  614. package/docs/providers/anthropic.md +152 -0
  615. package/docs/providers/claude-max-api-proxy.md +148 -0
  616. package/docs/providers/cloudflare-ai-gateway.md +71 -0
  617. package/docs/providers/deepgram.md +93 -0
  618. package/docs/providers/github-copilot.md +72 -0
  619. package/docs/providers/glm.md +33 -0
  620. package/docs/providers/index.md +63 -0
  621. package/docs/providers/minimax.md +208 -0
  622. package/docs/providers/models.md +51 -0
  623. package/docs/providers/moonshot.md +142 -0
  624. package/docs/providers/ollama.md +223 -0
  625. package/docs/providers/openai.md +62 -0
  626. package/docs/providers/opencode.md +36 -0
  627. package/docs/providers/openrouter.md +37 -0
  628. package/docs/providers/qwen.md +53 -0
  629. package/docs/providers/synthetic.md +99 -0
  630. package/docs/providers/venice.md +267 -0
  631. package/docs/providers/vercel-ai-gateway.md +50 -0
  632. package/docs/providers/xiaomi.md +64 -0
  633. package/docs/providers/zai.md +36 -0
  634. package/docs/railway.mdx +99 -0
  635. package/docs/refactor/clawnet.md +417 -0
  636. package/docs/refactor/exec-host.md +316 -0
  637. package/docs/refactor/outbound-session-mirroring.md +85 -0
  638. package/docs/refactor/plugin-sdk.md +214 -0
  639. package/docs/refactor/strict-config.md +93 -0
  640. package/docs/reference/AGENTS.default.md +124 -0
  641. package/docs/reference/RELEASING.md +120 -0
  642. package/docs/reference/api-usage-costs.md +137 -0
  643. package/docs/reference/device-models.md +47 -0
  644. package/docs/reference/rpc.md +43 -0
  645. package/docs/reference/session-management-compaction.md +285 -0
  646. package/docs/reference/templates/AGENTS.dev.md +83 -0
  647. package/docs/reference/templates/AGENTS.md +218 -0
  648. package/docs/reference/templates/BOOT.md +10 -0
  649. package/docs/reference/templates/BOOTSTRAP.md +61 -0
  650. package/docs/reference/templates/HEARTBEAT.md +11 -0
  651. package/docs/reference/templates/IDENTITY.dev.md +47 -0
  652. package/docs/reference/templates/IDENTITY.md +27 -0
  653. package/docs/reference/templates/SOUL.dev.md +76 -0
  654. package/docs/reference/templates/SOUL.md +42 -0
  655. package/docs/reference/templates/TOOLS.dev.md +24 -0
  656. package/docs/reference/templates/TOOLS.md +46 -0
  657. package/docs/reference/templates/USER.dev.md +18 -0
  658. package/docs/reference/templates/USER.md +22 -0
  659. package/docs/reference/test.md +50 -0
  660. package/docs/reference/transcript-hygiene.md +129 -0
  661. package/docs/render.mdx +165 -0
  662. package/docs/scripts.md +28 -0
  663. package/docs/security/formal-verification.md +164 -0
  664. package/docs/start/getting-started.md +208 -0
  665. package/docs/start/hubs.md +185 -0
  666. package/docs/start/lore.md +219 -0
  667. package/docs/start/onboarding.md +110 -0
  668. package/docs/start/openclaw.md +241 -0
  669. package/docs/start/pairing.md +86 -0
  670. package/docs/start/setup.md +149 -0
  671. package/docs/start/showcase.md +416 -0
  672. package/docs/start/wizard.md +349 -0
  673. package/docs/testing.md +368 -0
  674. package/docs/token-use.md +112 -0
  675. package/docs/tools/agent-send.md +53 -0
  676. package/docs/tools/apply-patch.md +50 -0
  677. package/docs/tools/browser-linux-troubleshooting.md +139 -0
  678. package/docs/tools/browser-login.md +68 -0
  679. package/docs/tools/browser.md +576 -0
  680. package/docs/tools/chrome-extension.md +178 -0
  681. package/docs/tools/clawhub.md +257 -0
  682. package/docs/tools/creating-skills.md +54 -0
  683. package/docs/tools/elevated.md +57 -0
  684. package/docs/tools/exec-approvals.md +246 -0
  685. package/docs/tools/exec.md +179 -0
  686. package/docs/tools/firecrawl.md +61 -0
  687. package/docs/tools/index.md +509 -0
  688. package/docs/tools/llm-task.md +115 -0
  689. package/docs/tools/lobster.md +342 -0
  690. package/docs/tools/reactions.md +22 -0
  691. package/docs/tools/skills-config.md +76 -0
  692. package/docs/tools/skills.md +300 -0
  693. package/docs/tools/slash-commands.md +198 -0
  694. package/docs/tools/subagents.md +151 -0
  695. package/docs/tools/thinking.md +73 -0
  696. package/docs/tools/web.md +261 -0
  697. package/docs/tts.md +396 -0
  698. package/docs/tui.md +159 -0
  699. package/docs/vps.md +43 -0
  700. package/docs/web/control-ui.md +221 -0
  701. package/docs/web/dashboard.md +46 -0
  702. package/docs/web/index.md +116 -0
  703. package/docs/web/webchat.md +49 -0
  704. package/docs/whatsapp-openclaw-ai-zh.jpg +0 -0
  705. package/docs/whatsapp-openclaw.jpg +0 -0
  706. package/docs/zh-CN/AGENTS.md +59 -0
  707. package/docs/zh-CN/automation/auth-monitoring.md +47 -0
  708. package/docs/zh-CN/automation/cron-jobs.md +424 -0
  709. package/docs/zh-CN/automation/cron-vs-heartbeat.md +286 -0
  710. package/docs/zh-CN/automation/gmail-pubsub.md +249 -0
  711. package/docs/zh-CN/automation/poll.md +76 -0
  712. package/docs/zh-CN/automation/webhook.md +163 -0
  713. package/docs/zh-CN/bedrock.md +170 -0
  714. package/docs/zh-CN/brave-search.md +48 -0
  715. package/docs/zh-CN/broadcast-groups.md +449 -0
  716. package/docs/zh-CN/channels/bluebubbles.md +271 -0
  717. package/docs/zh-CN/channels/discord.md +468 -0
  718. package/docs/zh-CN/channels/feishu.md +513 -0
  719. package/docs/zh-CN/channels/googlechat.md +257 -0
  720. package/docs/zh-CN/channels/grammy.md +38 -0
  721. package/docs/zh-CN/channels/imessage.md +302 -0
  722. package/docs/zh-CN/channels/index.md +53 -0
  723. package/docs/zh-CN/channels/line.md +180 -0
  724. package/docs/zh-CN/channels/location.md +63 -0
  725. package/docs/zh-CN/channels/matrix.md +221 -0
  726. package/docs/zh-CN/channels/mattermost.md +144 -0
  727. package/docs/zh-CN/channels/msteams.md +775 -0
  728. package/docs/zh-CN/channels/nextcloud-talk.md +142 -0
  729. package/docs/zh-CN/channels/nostr.md +240 -0
  730. package/docs/zh-CN/channels/signal.md +209 -0
  731. package/docs/zh-CN/channels/slack.md +531 -0
  732. package/docs/zh-CN/channels/telegram.md +751 -0
  733. package/docs/zh-CN/channels/tlon.md +136 -0
  734. package/docs/zh-CN/channels/troubleshooting.md +36 -0
  735. package/docs/zh-CN/channels/twitch.md +385 -0
  736. package/docs/zh-CN/channels/whatsapp.md +411 -0
  737. package/docs/zh-CN/channels/zalo.md +196 -0
  738. package/docs/zh-CN/channels/zalouser.md +147 -0
  739. package/docs/zh-CN/cli/acp.md +173 -0
  740. package/docs/zh-CN/cli/agent.md +30 -0
  741. package/docs/zh-CN/cli/agents.md +82 -0
  742. package/docs/zh-CN/cli/approvals.md +57 -0
  743. package/docs/zh-CN/cli/browser.md +114 -0
  744. package/docs/zh-CN/cli/channels.md +86 -0
  745. package/docs/zh-CN/cli/config.md +57 -0
  746. package/docs/zh-CN/cli/configure.md +38 -0
  747. package/docs/zh-CN/cli/cron.md +43 -0
  748. package/docs/zh-CN/cli/dashboard.md +23 -0
  749. package/docs/zh-CN/cli/devices.md +74 -0
  750. package/docs/zh-CN/cli/directory.md +70 -0
  751. package/docs/zh-CN/cli/dns.md +30 -0
  752. package/docs/zh-CN/cli/docs.md +22 -0
  753. package/docs/zh-CN/cli/doctor.md +48 -0
  754. package/docs/zh-CN/cli/gateway.md +206 -0
  755. package/docs/zh-CN/cli/health.md +28 -0
  756. package/docs/zh-CN/cli/hooks.md +311 -0
  757. package/docs/zh-CN/cli/index.md +1032 -0
  758. package/docs/zh-CN/cli/logs.md +31 -0
  759. package/docs/zh-CN/cli/memory.md +52 -0
  760. package/docs/zh-CN/cli/message.md +246 -0
  761. package/docs/zh-CN/cli/models.md +85 -0
  762. package/docs/zh-CN/cli/node.md +115 -0
  763. package/docs/zh-CN/cli/nodes.md +80 -0
  764. package/docs/zh-CN/cli/onboard.md +36 -0
  765. package/docs/zh-CN/cli/pairing.md +28 -0
  766. package/docs/zh-CN/cli/plugins.md +66 -0
  767. package/docs/zh-CN/cli/reset.md +24 -0
  768. package/docs/zh-CN/cli/sandbox.md +158 -0
  769. package/docs/zh-CN/cli/security.md +33 -0
  770. package/docs/zh-CN/cli/sessions.md +23 -0
  771. package/docs/zh-CN/cli/setup.md +36 -0
  772. package/docs/zh-CN/cli/skills.md +33 -0
  773. package/docs/zh-CN/cli/status.md +33 -0
  774. package/docs/zh-CN/cli/system.md +63 -0
  775. package/docs/zh-CN/cli/tui.md +30 -0
  776. package/docs/zh-CN/cli/uninstall.md +24 -0
  777. package/docs/zh-CN/cli/update.md +101 -0
  778. package/docs/zh-CN/cli/voicecall.md +41 -0
  779. package/docs/zh-CN/cli/webhooks.md +32 -0
  780. package/docs/zh-CN/concepts/agent-loop.md +146 -0
  781. package/docs/zh-CN/concepts/agent-workspace.md +219 -0
  782. package/docs/zh-CN/concepts/agent.md +115 -0
  783. package/docs/zh-CN/concepts/architecture.md +123 -0
  784. package/docs/zh-CN/concepts/channel-routing.md +117 -0
  785. package/docs/zh-CN/concepts/compaction.md +67 -0
  786. package/docs/zh-CN/concepts/context.md +168 -0
  787. package/docs/zh-CN/concepts/group-messages.md +91 -0
  788. package/docs/zh-CN/concepts/groups.md +379 -0
  789. package/docs/zh-CN/concepts/markdown-formatting.md +117 -0
  790. package/docs/zh-CN/concepts/memory.md +412 -0
  791. package/docs/zh-CN/concepts/messages.md +141 -0
  792. package/docs/zh-CN/concepts/model-failover.md +145 -0
  793. package/docs/zh-CN/concepts/model-providers.md +320 -0
  794. package/docs/zh-CN/concepts/models.md +196 -0
  795. package/docs/zh-CN/concepts/multi-agent.md +372 -0
  796. package/docs/zh-CN/concepts/oauth.md +151 -0
  797. package/docs/zh-CN/concepts/presence.md +99 -0
  798. package/docs/zh-CN/concepts/queue.md +94 -0
  799. package/docs/zh-CN/concepts/retry.md +76 -0
  800. package/docs/zh-CN/concepts/session-pruning.md +129 -0
  801. package/docs/zh-CN/concepts/session-tool.md +200 -0
  802. package/docs/zh-CN/concepts/session.md +166 -0
  803. package/docs/zh-CN/concepts/sessions.md +17 -0
  804. package/docs/zh-CN/concepts/streaming.md +133 -0
  805. package/docs/zh-CN/concepts/system-prompt.md +101 -0
  806. package/docs/zh-CN/concepts/timezone.md +96 -0
  807. package/docs/zh-CN/concepts/typebox.md +284 -0
  808. package/docs/zh-CN/concepts/typing-indicators.md +74 -0
  809. package/docs/zh-CN/concepts/usage-tracking.md +42 -0
  810. package/docs/zh-CN/date-time.md +129 -0
  811. package/docs/zh-CN/debug/node-issue.md +90 -0
  812. package/docs/zh-CN/debugging.md +160 -0
  813. package/docs/zh-CN/diagnostics/flags.md +98 -0
  814. package/docs/zh-CN/environment.md +88 -0
  815. package/docs/zh-CN/experiments/onboarding-config-protocol.md +47 -0
  816. package/docs/zh-CN/experiments/plans/cron-add-hardening.md +70 -0
  817. package/docs/zh-CN/experiments/plans/group-policy-hardening.md +45 -0
  818. package/docs/zh-CN/experiments/plans/openresponses-gateway.md +121 -0
  819. package/docs/zh-CN/experiments/proposals/model-config.md +42 -0
  820. package/docs/zh-CN/experiments/research/memory.md +235 -0
  821. package/docs/zh-CN/gateway/authentication.md +142 -0
  822. package/docs/zh-CN/gateway/background-process.md +100 -0
  823. package/docs/zh-CN/gateway/bonjour.md +174 -0
  824. package/docs/zh-CN/gateway/bridge-protocol.md +86 -0
  825. package/docs/zh-CN/gateway/cli-backends.md +213 -0
  826. package/docs/zh-CN/gateway/configuration-examples.md +587 -0
  827. package/docs/zh-CN/gateway/configuration.md +3332 -0
  828. package/docs/zh-CN/gateway/discovery.md +123 -0
  829. package/docs/zh-CN/gateway/doctor.md +238 -0
  830. package/docs/zh-CN/gateway/gateway-lock.md +41 -0
  831. package/docs/zh-CN/gateway/health.md +42 -0
  832. package/docs/zh-CN/gateway/heartbeat.md +274 -0
  833. package/docs/zh-CN/gateway/index.md +335 -0
  834. package/docs/zh-CN/gateway/local-models.md +157 -0
  835. package/docs/zh-CN/gateway/logging.md +114 -0
  836. package/docs/zh-CN/gateway/multiple-gateways.md +119 -0
  837. package/docs/zh-CN/gateway/openai-http-api.md +125 -0
  838. package/docs/zh-CN/gateway/openresponses-http-api.md +317 -0
  839. package/docs/zh-CN/gateway/pairing.md +99 -0
  840. package/docs/zh-CN/gateway/protocol.md +220 -0
  841. package/docs/zh-CN/gateway/remote-gateway-readme.md +164 -0
  842. package/docs/zh-CN/gateway/remote.md +133 -0
  843. package/docs/zh-CN/gateway/sandbox-vs-tool-policy-vs-elevated.md +135 -0
  844. package/docs/zh-CN/gateway/sandboxing.md +188 -0
  845. package/docs/zh-CN/gateway/security/formal-verification.md +169 -0
  846. package/docs/zh-CN/gateway/security/index.md +777 -0
  847. package/docs/zh-CN/gateway/tailscale.md +124 -0
  848. package/docs/zh-CN/gateway/tools-invoke-http-api.md +92 -0
  849. package/docs/zh-CN/gateway/troubleshooting.md +771 -0
  850. package/docs/zh-CN/help/faq.md +2628 -0
  851. package/docs/zh-CN/help/index.md +28 -0
  852. package/docs/zh-CN/help/troubleshooting.md +104 -0
  853. package/docs/zh-CN/hooks/soul-evil.md +72 -0
  854. package/docs/zh-CN/hooks.md +919 -0
  855. package/docs/zh-CN/index.md +264 -0
  856. package/docs/zh-CN/install/ansible.md +215 -0
  857. package/docs/zh-CN/install/bun.md +65 -0
  858. package/docs/zh-CN/install/development-channels.md +81 -0
  859. package/docs/zh-CN/install/docker.md +532 -0
  860. package/docs/zh-CN/install/index.md +193 -0
  861. package/docs/zh-CN/install/installer.md +128 -0
  862. package/docs/zh-CN/install/migrating.md +199 -0
  863. package/docs/zh-CN/install/nix.md +99 -0
  864. package/docs/zh-CN/install/node.md +85 -0
  865. package/docs/zh-CN/install/uninstall.md +135 -0
  866. package/docs/zh-CN/install/updating.md +233 -0
  867. package/docs/zh-CN/logging.md +329 -0
  868. package/docs/zh-CN/multi-agent-sandbox-tools.md +401 -0
  869. package/docs/zh-CN/network.md +59 -0
  870. package/docs/zh-CN/nodes/audio.md +120 -0
  871. package/docs/zh-CN/nodes/camera.md +162 -0
  872. package/docs/zh-CN/nodes/images.md +79 -0
  873. package/docs/zh-CN/nodes/index.md +348 -0
  874. package/docs/zh-CN/nodes/location-command.md +120 -0
  875. package/docs/zh-CN/nodes/media-understanding.md +380 -0
  876. package/docs/zh-CN/nodes/talk.md +97 -0
  877. package/docs/zh-CN/nodes/voicewake.md +72 -0
  878. package/docs/zh-CN/northflank.mdx +60 -0
  879. package/docs/zh-CN/perplexity.md +84 -0
  880. package/docs/zh-CN/pi-dev.md +77 -0
  881. package/docs/zh-CN/pi.md +619 -0
  882. package/docs/zh-CN/platforms/android.md +155 -0
  883. package/docs/zh-CN/platforms/digitalocean.md +269 -0
  884. package/docs/zh-CN/platforms/exe-dev.md +127 -0
  885. package/docs/zh-CN/platforms/fly.md +490 -0
  886. package/docs/zh-CN/platforms/gcp.md +510 -0
  887. package/docs/zh-CN/platforms/hetzner.md +337 -0
  888. package/docs/zh-CN/platforms/index.md +60 -0
  889. package/docs/zh-CN/platforms/ios.md +114 -0
  890. package/docs/zh-CN/platforms/linux.md +101 -0
  891. package/docs/zh-CN/platforms/mac/bundled-gateway.md +75 -0
  892. package/docs/zh-CN/platforms/mac/canvas.md +128 -0
  893. package/docs/zh-CN/platforms/mac/child-process.md +73 -0
  894. package/docs/zh-CN/platforms/mac/dev-setup.md +109 -0
  895. package/docs/zh-CN/platforms/mac/health.md +41 -0
  896. package/docs/zh-CN/platforms/mac/icon.md +38 -0
  897. package/docs/zh-CN/platforms/mac/logging.md +64 -0
  898. package/docs/zh-CN/platforms/mac/menu-bar.md +88 -0
  899. package/docs/zh-CN/platforms/mac/peekaboo.md +62 -0
  900. package/docs/zh-CN/platforms/mac/permissions.md +46 -0
  901. package/docs/zh-CN/platforms/mac/release.md +92 -0
  902. package/docs/zh-CN/platforms/mac/remote.md +90 -0
  903. package/docs/zh-CN/platforms/mac/signing.md +54 -0
  904. package/docs/zh-CN/platforms/mac/skills.md +40 -0
  905. package/docs/zh-CN/platforms/mac/voice-overlay.md +67 -0
  906. package/docs/zh-CN/platforms/mac/voicewake.md +74 -0
  907. package/docs/zh-CN/platforms/mac/webchat.md +43 -0
  908. package/docs/zh-CN/platforms/mac/xpc.md +68 -0
  909. package/docs/zh-CN/platforms/macos-vm.md +288 -0
  910. package/docs/zh-CN/platforms/macos.md +193 -0
  911. package/docs/zh-CN/platforms/oracle.md +310 -0
  912. package/docs/zh-CN/platforms/raspberry-pi.md +365 -0
  913. package/docs/zh-CN/platforms/windows.md +156 -0
  914. package/docs/zh-CN/plugin.md +639 -0
  915. package/docs/zh-CN/plugins/agent-tools.md +99 -0
  916. package/docs/zh-CN/plugins/manifest.md +68 -0
  917. package/docs/zh-CN/plugins/voice-call.md +250 -0
  918. package/docs/zh-CN/plugins/zalouser.md +88 -0
  919. package/docs/zh-CN/prose.md +141 -0
  920. package/docs/zh-CN/providers/anthropic.md +159 -0
  921. package/docs/zh-CN/providers/claude-max-api-proxy.md +155 -0
  922. package/docs/zh-CN/providers/deepgram.md +97 -0
  923. package/docs/zh-CN/providers/github-copilot.md +67 -0
  924. package/docs/zh-CN/providers/glm.md +39 -0
  925. package/docs/zh-CN/providers/index.md +68 -0
  926. package/docs/zh-CN/providers/minimax.md +206 -0
  927. package/docs/zh-CN/providers/models.md +55 -0
  928. package/docs/zh-CN/providers/moonshot.md +145 -0
  929. package/docs/zh-CN/providers/ollama.md +230 -0
  930. package/docs/zh-CN/providers/openai.md +68 -0
  931. package/docs/zh-CN/providers/opencode.md +41 -0
  932. package/docs/zh-CN/providers/openrouter.md +43 -0
  933. package/docs/zh-CN/providers/qwen.md +55 -0
  934. package/docs/zh-CN/providers/synthetic.md +102 -0
  935. package/docs/zh-CN/providers/venice.md +274 -0
  936. package/docs/zh-CN/providers/vercel-ai-gateway.md +57 -0
  937. package/docs/zh-CN/providers/xiaomi.md +68 -0
  938. package/docs/zh-CN/providers/zai.md +41 -0
  939. package/docs/zh-CN/railway.mdx +106 -0
  940. package/docs/zh-CN/refactor/clawnet.md +424 -0
  941. package/docs/zh-CN/refactor/exec-host.md +323 -0
  942. package/docs/zh-CN/refactor/outbound-session-mirroring.md +92 -0
  943. package/docs/zh-CN/refactor/plugin-sdk.md +221 -0
  944. package/docs/zh-CN/refactor/strict-config.md +100 -0
  945. package/docs/zh-CN/reference/AGENTS.default.md +131 -0
  946. package/docs/zh-CN/reference/RELEASING.md +123 -0
  947. package/docs/zh-CN/reference/api-usage-costs.md +136 -0
  948. package/docs/zh-CN/reference/device-models.md +54 -0
  949. package/docs/zh-CN/reference/rpc.md +48 -0
  950. package/docs/zh-CN/reference/session-management-compaction.md +287 -0
  951. package/docs/zh-CN/reference/templates/AGENTS.dev.md +89 -0
  952. package/docs/zh-CN/reference/templates/AGENTS.md +225 -0
  953. package/docs/zh-CN/reference/templates/BOOT.md +17 -0
  954. package/docs/zh-CN/reference/templates/BOOTSTRAP.md +68 -0
  955. package/docs/zh-CN/reference/templates/HEARTBEAT.md +18 -0
  956. package/docs/zh-CN/reference/templates/IDENTITY.dev.md +54 -0
  957. package/docs/zh-CN/reference/templates/IDENTITY.md +35 -0
  958. package/docs/zh-CN/reference/templates/SOUL.dev.md +83 -0
  959. package/docs/zh-CN/reference/templates/SOUL.md +49 -0
  960. package/docs/zh-CN/reference/templates/TOOLS.dev.md +31 -0
  961. package/docs/zh-CN/reference/templates/TOOLS.md +53 -0
  962. package/docs/zh-CN/reference/templates/USER.dev.md +25 -0
  963. package/docs/zh-CN/reference/templates/USER.md +30 -0
  964. package/docs/zh-CN/reference/test.md +57 -0
  965. package/docs/zh-CN/reference/transcript-hygiene.md +109 -0
  966. package/docs/zh-CN/render.mdx +169 -0
  967. package/docs/zh-CN/scripts.md +35 -0
  968. package/docs/zh-CN/security/formal-verification.md +171 -0
  969. package/docs/zh-CN/start/getting-started.md +206 -0
  970. package/docs/zh-CN/start/hubs.md +191 -0
  971. package/docs/zh-CN/start/lore.md +226 -0
  972. package/docs/zh-CN/start/onboarding.md +105 -0
  973. package/docs/zh-CN/start/openclaw.md +248 -0
  974. package/docs/zh-CN/start/pairing.md +89 -0
  975. package/docs/zh-CN/start/setup.md +153 -0
  976. package/docs/zh-CN/start/showcase.md +423 -0
  977. package/docs/zh-CN/start/wizard.md +331 -0
  978. package/docs/zh-CN/testing.md +375 -0
  979. package/docs/zh-CN/token-use.md +119 -0
  980. package/docs/zh-CN/tools/agent-send.md +59 -0
  981. package/docs/zh-CN/tools/apply-patch.md +57 -0
  982. package/docs/zh-CN/tools/browser-linux-troubleshooting.md +144 -0
  983. package/docs/zh-CN/tools/browser-login.md +75 -0
  984. package/docs/zh-CN/tools/browser.md +553 -0
  985. package/docs/zh-CN/tools/chrome-extension.md +183 -0
  986. package/docs/zh-CN/tools/clawhub.md +209 -0
  987. package/docs/zh-CN/tools/creating-skills.md +61 -0
  988. package/docs/zh-CN/tools/elevated.md +64 -0
  989. package/docs/zh-CN/tools/exec-approvals.md +234 -0
  990. package/docs/zh-CN/tools/exec.md +169 -0
  991. package/docs/zh-CN/tools/firecrawl.md +68 -0
  992. package/docs/zh-CN/tools/index.md +515 -0
  993. package/docs/zh-CN/tools/llm-task.md +117 -0
  994. package/docs/zh-CN/tools/lobster.md +349 -0
  995. package/docs/zh-CN/tools/reactions.md +29 -0
  996. package/docs/zh-CN/tools/skills-config.md +78 -0
  997. package/docs/zh-CN/tools/skills.md +279 -0
  998. package/docs/zh-CN/tools/slash-commands.md +205 -0
  999. package/docs/zh-CN/tools/subagents.md +156 -0
  1000. package/docs/zh-CN/tools/thinking.md +80 -0
  1001. package/docs/zh-CN/tools/web.md +257 -0
  1002. package/docs/zh-CN/tts.md +375 -0
  1003. package/docs/zh-CN/tui.md +166 -0
  1004. package/docs/zh-CN/vps.md +47 -0
  1005. package/docs/zh-CN/web/control-ui.md +191 -0
  1006. package/docs/zh-CN/web/dashboard.md +53 -0
  1007. package/docs/zh-CN/web/index.md +118 -0
  1008. package/docs/zh-CN/web/webchat.md +56 -0
  1009. package/extensions/bluebubbles/README.md +45 -0
  1010. package/extensions/bluebubbles/index.ts +19 -0
  1011. package/extensions/bluebubbles/node_modules/.bin/openclaw +21 -0
  1012. package/extensions/bluebubbles/openclaw.plugin.json +9 -0
  1013. package/extensions/bluebubbles/package.json +36 -0
  1014. package/extensions/bluebubbles/src/accounts.ts +88 -0
  1015. package/extensions/bluebubbles/src/actions.test.ts +650 -0
  1016. package/extensions/bluebubbles/src/actions.ts +438 -0
  1017. package/extensions/bluebubbles/src/attachments.test.ts +345 -0
  1018. package/extensions/bluebubbles/src/attachments.ts +300 -0
  1019. package/extensions/bluebubbles/src/channel.ts +414 -0
  1020. package/extensions/bluebubbles/src/chat.test.ts +461 -0
  1021. package/extensions/bluebubbles/src/chat.ts +378 -0
  1022. package/extensions/bluebubbles/src/config-schema.ts +51 -0
  1023. package/extensions/bluebubbles/src/media-send.ts +174 -0
  1024. package/extensions/bluebubbles/src/monitor.test.ts +2342 -0
  1025. package/extensions/bluebubbles/src/monitor.ts +2490 -0
  1026. package/extensions/bluebubbles/src/onboarding.ts +352 -0
  1027. package/extensions/bluebubbles/src/probe.ts +135 -0
  1028. package/extensions/bluebubbles/src/reactions.test.ts +392 -0
  1029. package/extensions/bluebubbles/src/reactions.ts +188 -0
  1030. package/extensions/bluebubbles/src/runtime.ts +14 -0
  1031. package/extensions/bluebubbles/src/send.test.ts +808 -0
  1032. package/extensions/bluebubbles/src/send.ts +467 -0
  1033. package/extensions/bluebubbles/src/targets.test.ts +183 -0
  1034. package/extensions/bluebubbles/src/targets.ts +422 -0
  1035. package/extensions/bluebubbles/src/types.ts +127 -0
  1036. package/extensions/copilot-proxy/README.md +24 -0
  1037. package/extensions/copilot-proxy/index.ts +148 -0
  1038. package/extensions/copilot-proxy/node_modules/.bin/openclaw +21 -0
  1039. package/extensions/copilot-proxy/openclaw.plugin.json +9 -0
  1040. package/extensions/copilot-proxy/package.json +14 -0
  1041. package/extensions/diagnostics-otel/index.ts +15 -0
  1042. package/extensions/diagnostics-otel/node_modules/.bin/openclaw +21 -0
  1043. package/extensions/diagnostics-otel/openclaw.plugin.json +8 -0
  1044. package/extensions/diagnostics-otel/package.json +27 -0
  1045. package/extensions/diagnostics-otel/src/service.test.ts +226 -0
  1046. package/extensions/diagnostics-otel/src/service.ts +635 -0
  1047. package/extensions/discord/index.ts +17 -0
  1048. package/extensions/discord/node_modules/.bin/openclaw +21 -0
  1049. package/extensions/discord/openclaw.plugin.json +9 -0
  1050. package/extensions/discord/package.json +14 -0
  1051. package/extensions/discord/src/channel.ts +422 -0
  1052. package/extensions/discord/src/runtime.ts +14 -0
  1053. package/extensions/feishu/README.md +47 -0
  1054. package/extensions/feishu/index.ts +15 -0
  1055. package/extensions/feishu/node_modules/.bin/openclaw +21 -0
  1056. package/extensions/feishu/openclaw.plugin.json +9 -0
  1057. package/extensions/feishu/package.json +33 -0
  1058. package/extensions/feishu/src/channel.ts +276 -0
  1059. package/extensions/feishu/src/config-schema.ts +46 -0
  1060. package/extensions/feishu/src/onboarding.ts +278 -0
  1061. package/extensions/google-antigravity-auth/README.md +24 -0
  1062. package/extensions/google-antigravity-auth/index.ts +461 -0
  1063. package/extensions/google-antigravity-auth/node_modules/.bin/openclaw +21 -0
  1064. package/extensions/google-antigravity-auth/openclaw.plugin.json +9 -0
  1065. package/extensions/google-antigravity-auth/package.json +14 -0
  1066. package/extensions/google-gemini-cli-auth/README.md +35 -0
  1067. package/extensions/google-gemini-cli-auth/index.ts +88 -0
  1068. package/extensions/google-gemini-cli-auth/node_modules/.bin/openclaw +21 -0
  1069. package/extensions/google-gemini-cli-auth/oauth.test.ts +240 -0
  1070. package/extensions/google-gemini-cli-auth/oauth.ts +662 -0
  1071. package/extensions/google-gemini-cli-auth/openclaw.plugin.json +9 -0
  1072. package/extensions/google-gemini-cli-auth/package.json +14 -0
  1073. package/extensions/googlechat/index.ts +19 -0
  1074. package/extensions/googlechat/node_modules/.bin/openclaw +21 -0
  1075. package/extensions/googlechat/openclaw.plugin.json +9 -0
  1076. package/extensions/googlechat/package.json +39 -0
  1077. package/extensions/googlechat/src/accounts.ts +147 -0
  1078. package/extensions/googlechat/src/actions.ts +181 -0
  1079. package/extensions/googlechat/src/api.test.ts +61 -0
  1080. package/extensions/googlechat/src/api.ts +282 -0
  1081. package/extensions/googlechat/src/auth.ts +123 -0
  1082. package/extensions/googlechat/src/channel.ts +583 -0
  1083. package/extensions/googlechat/src/monitor.test.ts +22 -0
  1084. package/extensions/googlechat/src/monitor.ts +949 -0
  1085. package/extensions/googlechat/src/onboarding.ts +269 -0
  1086. package/extensions/googlechat/src/runtime.ts +14 -0
  1087. package/extensions/googlechat/src/targets.test.ts +32 -0
  1088. package/extensions/googlechat/src/targets.ts +65 -0
  1089. package/extensions/googlechat/src/types.config.ts +3 -0
  1090. package/extensions/googlechat/src/types.ts +73 -0
  1091. package/extensions/imessage/index.ts +17 -0
  1092. package/extensions/imessage/node_modules/.bin/openclaw +21 -0
  1093. package/extensions/imessage/openclaw.plugin.json +9 -0
  1094. package/extensions/imessage/package.json +14 -0
  1095. package/extensions/imessage/src/channel.ts +294 -0
  1096. package/extensions/imessage/src/runtime.ts +14 -0
  1097. package/extensions/line/index.ts +19 -0
  1098. package/extensions/line/node_modules/.bin/openclaw +21 -0
  1099. package/extensions/line/openclaw.plugin.json +9 -0
  1100. package/extensions/line/package.json +29 -0
  1101. package/extensions/line/src/card-command.ts +344 -0
  1102. package/extensions/line/src/channel.logout.test.ts +99 -0
  1103. package/extensions/line/src/channel.sendPayload.test.ts +306 -0
  1104. package/extensions/line/src/channel.ts +780 -0
  1105. package/extensions/line/src/runtime.ts +14 -0
  1106. package/extensions/llm-task/README.md +97 -0
  1107. package/extensions/llm-task/index.ts +6 -0
  1108. package/extensions/llm-task/node_modules/.bin/openclaw +21 -0
  1109. package/extensions/llm-task/openclaw.plugin.json +21 -0
  1110. package/extensions/llm-task/package.json +14 -0
  1111. package/extensions/llm-task/src/llm-task-tool.test.ts +138 -0
  1112. package/extensions/llm-task/src/llm-task-tool.ts +245 -0
  1113. package/extensions/lobster/README.md +75 -0
  1114. package/extensions/lobster/SKILL.md +97 -0
  1115. package/extensions/lobster/index.ts +14 -0
  1116. package/extensions/lobster/node_modules/.bin/openclaw +21 -0
  1117. package/extensions/lobster/openclaw.plugin.json +10 -0
  1118. package/extensions/lobster/package.json +14 -0
  1119. package/extensions/lobster/src/lobster-tool.test.ts +247 -0
  1120. package/extensions/lobster/src/lobster-tool.ts +328 -0
  1121. package/extensions/matrix/CHANGELOG.md +87 -0
  1122. package/extensions/matrix/index.ts +17 -0
  1123. package/extensions/matrix/node_modules/.bin/markdown-it +21 -0
  1124. package/extensions/matrix/node_modules/.bin/openclaw +21 -0
  1125. package/extensions/matrix/openclaw.plugin.json +9 -0
  1126. package/extensions/matrix/package.json +36 -0
  1127. package/extensions/matrix/src/actions.ts +195 -0
  1128. package/extensions/matrix/src/channel.directory.test.ts +64 -0
  1129. package/extensions/matrix/src/channel.ts +439 -0
  1130. package/extensions/matrix/src/config-schema.ts +62 -0
  1131. package/extensions/matrix/src/directory-live.ts +188 -0
  1132. package/extensions/matrix/src/group-mentions.ts +66 -0
  1133. package/extensions/matrix/src/matrix/accounts.test.ts +82 -0
  1134. package/extensions/matrix/src/matrix/accounts.ts +65 -0
  1135. package/extensions/matrix/src/matrix/actions/client.ts +57 -0
  1136. package/extensions/matrix/src/matrix/actions/messages.ts +128 -0
  1137. package/extensions/matrix/src/matrix/actions/pins.ts +76 -0
  1138. package/extensions/matrix/src/matrix/actions/reactions.ts +96 -0
  1139. package/extensions/matrix/src/matrix/actions/room.ts +85 -0
  1140. package/extensions/matrix/src/matrix/actions/summary.ts +75 -0
  1141. package/extensions/matrix/src/matrix/actions/types.ts +84 -0
  1142. package/extensions/matrix/src/matrix/actions.ts +15 -0
  1143. package/extensions/matrix/src/matrix/active-client.ts +11 -0
  1144. package/extensions/matrix/src/matrix/client/config.ts +160 -0
  1145. package/extensions/matrix/src/matrix/client/create-client.ts +123 -0
  1146. package/extensions/matrix/src/matrix/client/logging.ts +36 -0
  1147. package/extensions/matrix/src/matrix/client/runtime.ts +4 -0
  1148. package/extensions/matrix/src/matrix/client/shared.ts +170 -0
  1149. package/extensions/matrix/src/matrix/client/storage.ts +131 -0
  1150. package/extensions/matrix/src/matrix/client/types.ts +34 -0
  1151. package/extensions/matrix/src/matrix/client.test.ts +56 -0
  1152. package/extensions/matrix/src/matrix/client.ts +5 -0
  1153. package/extensions/matrix/src/matrix/credentials.ts +105 -0
  1154. package/extensions/matrix/src/matrix/deps.ts +60 -0
  1155. package/extensions/matrix/src/matrix/format.test.ts +33 -0
  1156. package/extensions/matrix/src/matrix/format.ts +22 -0
  1157. package/extensions/matrix/src/matrix/index.ts +11 -0
  1158. package/extensions/matrix/src/matrix/monitor/allowlist.test.ts +45 -0
  1159. package/extensions/matrix/src/matrix/monitor/allowlist.ts +103 -0
  1160. package/extensions/matrix/src/matrix/monitor/auto-join.ts +71 -0
  1161. package/extensions/matrix/src/matrix/monitor/direct.ts +104 -0
  1162. package/extensions/matrix/src/matrix/monitor/events.ts +101 -0
  1163. package/extensions/matrix/src/matrix/monitor/handler.ts +661 -0
  1164. package/extensions/matrix/src/matrix/monitor/index.ts +338 -0
  1165. package/extensions/matrix/src/matrix/monitor/location.ts +100 -0
  1166. package/extensions/matrix/src/matrix/monitor/media.test.ts +102 -0
  1167. package/extensions/matrix/src/matrix/monitor/media.ts +113 -0
  1168. package/extensions/matrix/src/matrix/monitor/mentions.ts +31 -0
  1169. package/extensions/matrix/src/matrix/monitor/replies.ts +97 -0
  1170. package/extensions/matrix/src/matrix/monitor/room-info.ts +55 -0
  1171. package/extensions/matrix/src/matrix/monitor/rooms.test.ts +39 -0
  1172. package/extensions/matrix/src/matrix/monitor/rooms.ts +47 -0
  1173. package/extensions/matrix/src/matrix/monitor/threads.ts +68 -0
  1174. package/extensions/matrix/src/matrix/monitor/types.ts +39 -0
  1175. package/extensions/matrix/src/matrix/poll-types.test.ts +21 -0
  1176. package/extensions/matrix/src/matrix/poll-types.ts +166 -0
  1177. package/extensions/matrix/src/matrix/probe.ts +70 -0
  1178. package/extensions/matrix/src/matrix/send/client.ts +66 -0
  1179. package/extensions/matrix/src/matrix/send/formatting.ts +89 -0
  1180. package/extensions/matrix/src/matrix/send/media.ts +229 -0
  1181. package/extensions/matrix/src/matrix/send/targets.test.ts +98 -0
  1182. package/extensions/matrix/src/matrix/send/targets.ts +136 -0
  1183. package/extensions/matrix/src/matrix/send/types.ts +109 -0
  1184. package/extensions/matrix/src/matrix/send.test.ts +171 -0
  1185. package/extensions/matrix/src/matrix/send.ts +260 -0
  1186. package/extensions/matrix/src/onboarding.ts +449 -0
  1187. package/extensions/matrix/src/outbound.ts +52 -0
  1188. package/extensions/matrix/src/resolve-targets.test.ts +48 -0
  1189. package/extensions/matrix/src/resolve-targets.ts +135 -0
  1190. package/extensions/matrix/src/runtime.ts +14 -0
  1191. package/extensions/matrix/src/tool-actions.ts +164 -0
  1192. package/extensions/matrix/src/types.ts +95 -0
  1193. package/extensions/mattermost/index.ts +17 -0
  1194. package/extensions/mattermost/node_modules/.bin/openclaw +21 -0
  1195. package/extensions/mattermost/openclaw.plugin.json +9 -0
  1196. package/extensions/mattermost/package.json +28 -0
  1197. package/extensions/mattermost/src/channel.test.ts +48 -0
  1198. package/extensions/mattermost/src/channel.ts +337 -0
  1199. package/extensions/mattermost/src/config-schema.ts +55 -0
  1200. package/extensions/mattermost/src/group-mentions.ts +15 -0
  1201. package/extensions/mattermost/src/mattermost/accounts.ts +128 -0
  1202. package/extensions/mattermost/src/mattermost/client.ts +220 -0
  1203. package/extensions/mattermost/src/mattermost/index.ts +9 -0
  1204. package/extensions/mattermost/src/mattermost/monitor-helpers.ts +166 -0
  1205. package/extensions/mattermost/src/mattermost/monitor.ts +987 -0
  1206. package/extensions/mattermost/src/mattermost/probe.ts +74 -0
  1207. package/extensions/mattermost/src/mattermost/send.ts +231 -0
  1208. package/extensions/mattermost/src/normalize.ts +46 -0
  1209. package/extensions/mattermost/src/onboarding-helpers.ts +44 -0
  1210. package/extensions/mattermost/src/onboarding.ts +186 -0
  1211. package/extensions/mattermost/src/runtime.ts +14 -0
  1212. package/extensions/mattermost/src/types.ts +50 -0
  1213. package/extensions/memory-core/index.ts +38 -0
  1214. package/extensions/memory-core/node_modules/.bin/openclaw +21 -0
  1215. package/extensions/memory-core/openclaw.plugin.json +9 -0
  1216. package/extensions/memory-core/package.json +17 -0
  1217. package/extensions/memory-lancedb/config.ts +139 -0
  1218. package/extensions/memory-lancedb/index.test.ts +295 -0
  1219. package/extensions/memory-lancedb/index.ts +608 -0
  1220. package/extensions/memory-lancedb/node_modules/.bin/openai +21 -0
  1221. package/extensions/memory-lancedb/node_modules/.bin/openclaw +21 -0
  1222. package/extensions/memory-lancedb/openclaw.plugin.json +60 -0
  1223. package/extensions/memory-lancedb/package.json +19 -0
  1224. package/extensions/minimax-portal-auth/README.md +33 -0
  1225. package/extensions/minimax-portal-auth/index.ts +155 -0
  1226. package/extensions/minimax-portal-auth/node_modules/.bin/openclaw +21 -0
  1227. package/extensions/minimax-portal-auth/oauth.ts +247 -0
  1228. package/extensions/minimax-portal-auth/openclaw.plugin.json +9 -0
  1229. package/extensions/minimax-portal-auth/package.json +14 -0
  1230. package/extensions/msteams/CHANGELOG.md +83 -0
  1231. package/extensions/msteams/index.ts +17 -0
  1232. package/extensions/msteams/node_modules/.bin/openclaw +21 -0
  1233. package/extensions/msteams/openclaw.plugin.json +9 -0
  1234. package/extensions/msteams/package.json +39 -0
  1235. package/extensions/msteams/src/attachments/download.ts +283 -0
  1236. package/extensions/msteams/src/attachments/graph.ts +353 -0
  1237. package/extensions/msteams/src/attachments/html.ts +90 -0
  1238. package/extensions/msteams/src/attachments/payload.ts +22 -0
  1239. package/extensions/msteams/src/attachments/shared.ts +291 -0
  1240. package/extensions/msteams/src/attachments/types.ts +37 -0
  1241. package/extensions/msteams/src/attachments.test.ts +459 -0
  1242. package/extensions/msteams/src/attachments.ts +18 -0
  1243. package/extensions/msteams/src/channel.directory.test.ts +48 -0
  1244. package/extensions/msteams/src/channel.ts +459 -0
  1245. package/extensions/msteams/src/conversation-store-fs.test.ts +88 -0
  1246. package/extensions/msteams/src/conversation-store-fs.ts +165 -0
  1247. package/extensions/msteams/src/conversation-store-memory.ts +47 -0
  1248. package/extensions/msteams/src/conversation-store.ts +41 -0
  1249. package/extensions/msteams/src/directory-live.ts +205 -0
  1250. package/extensions/msteams/src/errors.test.ts +45 -0
  1251. package/extensions/msteams/src/errors.ts +190 -0
  1252. package/extensions/msteams/src/file-consent-helpers.test.ts +243 -0
  1253. package/extensions/msteams/src/file-consent-helpers.ts +73 -0
  1254. package/extensions/msteams/src/file-consent.ts +126 -0
  1255. package/extensions/msteams/src/graph-chat.ts +53 -0
  1256. package/extensions/msteams/src/graph-upload.ts +453 -0
  1257. package/extensions/msteams/src/inbound.test.ts +66 -0
  1258. package/extensions/msteams/src/inbound.ts +48 -0
  1259. package/extensions/msteams/src/index.ts +4 -0
  1260. package/extensions/msteams/src/media-helpers.test.ts +189 -0
  1261. package/extensions/msteams/src/media-helpers.ts +86 -0
  1262. package/extensions/msteams/src/messenger.test.ts +248 -0
  1263. package/extensions/msteams/src/messenger.ts +495 -0
  1264. package/extensions/msteams/src/monitor-handler/inbound-media.ts +128 -0
  1265. package/extensions/msteams/src/monitor-handler/message-handler.ts +640 -0
  1266. package/extensions/msteams/src/monitor-handler.ts +162 -0
  1267. package/extensions/msteams/src/monitor-types.ts +5 -0
  1268. package/extensions/msteams/src/monitor.ts +295 -0
  1269. package/extensions/msteams/src/onboarding.ts +431 -0
  1270. package/extensions/msteams/src/outbound.ts +46 -0
  1271. package/extensions/msteams/src/pending-uploads.ts +89 -0
  1272. package/extensions/msteams/src/policy.test.ts +209 -0
  1273. package/extensions/msteams/src/policy.ts +273 -0
  1274. package/extensions/msteams/src/polls-store-memory.ts +32 -0
  1275. package/extensions/msteams/src/polls-store.test.ts +38 -0
  1276. package/extensions/msteams/src/polls.test.ts +72 -0
  1277. package/extensions/msteams/src/polls.ts +315 -0
  1278. package/extensions/msteams/src/probe.test.ts +58 -0
  1279. package/extensions/msteams/src/probe.ts +107 -0
  1280. package/extensions/msteams/src/reply-dispatcher.ts +130 -0
  1281. package/extensions/msteams/src/resolve-allowlist.ts +297 -0
  1282. package/extensions/msteams/src/runtime.ts +14 -0
  1283. package/extensions/msteams/src/sdk-types.ts +19 -0
  1284. package/extensions/msteams/src/sdk.ts +33 -0
  1285. package/extensions/msteams/src/send-context.ts +164 -0
  1286. package/extensions/msteams/src/send.ts +519 -0
  1287. package/extensions/msteams/src/sent-message-cache.test.ts +15 -0
  1288. package/extensions/msteams/src/sent-message-cache.ts +47 -0
  1289. package/extensions/msteams/src/storage.ts +25 -0
  1290. package/extensions/msteams/src/store-fs.ts +83 -0
  1291. package/extensions/msteams/src/token.ts +19 -0
  1292. package/extensions/nextcloud-talk/index.ts +17 -0
  1293. package/extensions/nextcloud-talk/node_modules/.bin/openclaw +21 -0
  1294. package/extensions/nextcloud-talk/openclaw.plugin.json +9 -0
  1295. package/extensions/nextcloud-talk/package.json +33 -0
  1296. package/extensions/nextcloud-talk/src/accounts.ts +174 -0
  1297. package/extensions/nextcloud-talk/src/channel.ts +409 -0
  1298. package/extensions/nextcloud-talk/src/config-schema.ts +78 -0
  1299. package/extensions/nextcloud-talk/src/format.ts +79 -0
  1300. package/extensions/nextcloud-talk/src/inbound.ts +317 -0
  1301. package/extensions/nextcloud-talk/src/monitor.ts +246 -0
  1302. package/extensions/nextcloud-talk/src/normalize.ts +39 -0
  1303. package/extensions/nextcloud-talk/src/onboarding.ts +343 -0
  1304. package/extensions/nextcloud-talk/src/policy.test.ts +33 -0
  1305. package/extensions/nextcloud-talk/src/policy.ts +180 -0
  1306. package/extensions/nextcloud-talk/src/room-info.ts +125 -0
  1307. package/extensions/nextcloud-talk/src/runtime.ts +14 -0
  1308. package/extensions/nextcloud-talk/src/send.ts +210 -0
  1309. package/extensions/nextcloud-talk/src/signature.ts +72 -0
  1310. package/extensions/nextcloud-talk/src/types.ts +179 -0
  1311. package/extensions/nostr/CHANGELOG.md +74 -0
  1312. package/extensions/nostr/README.md +136 -0
  1313. package/extensions/nostr/index.ts +68 -0
  1314. package/extensions/nostr/node_modules/.bin/openclaw +21 -0
  1315. package/extensions/nostr/openclaw.plugin.json +9 -0
  1316. package/extensions/nostr/package.json +34 -0
  1317. package/extensions/nostr/src/channel.test.ts +151 -0
  1318. package/extensions/nostr/src/channel.ts +353 -0
  1319. package/extensions/nostr/src/config-schema.ts +90 -0
  1320. package/extensions/nostr/src/metrics.ts +478 -0
  1321. package/extensions/nostr/src/nostr-bus.fuzz.test.ts +533 -0
  1322. package/extensions/nostr/src/nostr-bus.integration.test.ts +448 -0
  1323. package/extensions/nostr/src/nostr-bus.test.ts +199 -0
  1324. package/extensions/nostr/src/nostr-bus.ts +715 -0
  1325. package/extensions/nostr/src/nostr-profile-http.test.ts +378 -0
  1326. package/extensions/nostr/src/nostr-profile-http.ts +519 -0
  1327. package/extensions/nostr/src/nostr-profile-import.test.ts +119 -0
  1328. package/extensions/nostr/src/nostr-profile-import.ts +262 -0
  1329. package/extensions/nostr/src/nostr-profile.fuzz.test.ts +477 -0
  1330. package/extensions/nostr/src/nostr-profile.test.ts +410 -0
  1331. package/extensions/nostr/src/nostr-profile.ts +277 -0
  1332. package/extensions/nostr/src/nostr-state-store.test.ts +131 -0
  1333. package/extensions/nostr/src/nostr-state-store.ts +226 -0
  1334. package/extensions/nostr/src/runtime.ts +14 -0
  1335. package/extensions/nostr/src/seen-tracker.ts +303 -0
  1336. package/extensions/nostr/src/types.test.ts +157 -0
  1337. package/extensions/nostr/src/types.ts +101 -0
  1338. package/extensions/nostr/test/setup.ts +5 -0
  1339. package/extensions/open-prose/README.md +25 -0
  1340. package/extensions/open-prose/index.ts +5 -0
  1341. package/extensions/open-prose/node_modules/.bin/openclaw +21 -0
  1342. package/extensions/open-prose/openclaw.plugin.json +11 -0
  1343. package/extensions/open-prose/package.json +14 -0
  1344. package/extensions/open-prose/skills/prose/LICENSE +21 -0
  1345. package/extensions/open-prose/skills/prose/SKILL.md +323 -0
  1346. package/extensions/open-prose/skills/prose/alt-borges.md +141 -0
  1347. package/extensions/open-prose/skills/prose/alts/arabian-nights.md +358 -0
  1348. package/extensions/open-prose/skills/prose/alts/borges.md +360 -0
  1349. package/extensions/open-prose/skills/prose/alts/folk.md +322 -0
  1350. package/extensions/open-prose/skills/prose/alts/homer.md +346 -0
  1351. package/extensions/open-prose/skills/prose/alts/kafka.md +373 -0
  1352. package/extensions/open-prose/skills/prose/compiler.md +2971 -0
  1353. package/extensions/open-prose/skills/prose/examples/01-hello-world.prose +4 -0
  1354. package/extensions/open-prose/skills/prose/examples/02-research-and-summarize.prose +6 -0
  1355. package/extensions/open-prose/skills/prose/examples/03-code-review.prose +17 -0
  1356. package/extensions/open-prose/skills/prose/examples/04-write-and-refine.prose +14 -0
  1357. package/extensions/open-prose/skills/prose/examples/05-debug-issue.prose +20 -0
  1358. package/extensions/open-prose/skills/prose/examples/06-explain-codebase.prose +17 -0
  1359. package/extensions/open-prose/skills/prose/examples/07-refactor.prose +20 -0
  1360. package/extensions/open-prose/skills/prose/examples/08-blog-post.prose +20 -0
  1361. package/extensions/open-prose/skills/prose/examples/09-research-with-agents.prose +25 -0
  1362. package/extensions/open-prose/skills/prose/examples/10-code-review-agents.prose +32 -0
  1363. package/extensions/open-prose/skills/prose/examples/11-skills-and-imports.prose +27 -0
  1364. package/extensions/open-prose/skills/prose/examples/12-secure-agent-permissions.prose +43 -0
  1365. package/extensions/open-prose/skills/prose/examples/13-variables-and-context.prose +51 -0
  1366. package/extensions/open-prose/skills/prose/examples/14-composition-blocks.prose +48 -0
  1367. package/extensions/open-prose/skills/prose/examples/15-inline-sequences.prose +23 -0
  1368. package/extensions/open-prose/skills/prose/examples/16-parallel-reviews.prose +19 -0
  1369. package/extensions/open-prose/skills/prose/examples/17-parallel-research.prose +19 -0
  1370. package/extensions/open-prose/skills/prose/examples/18-mixed-parallel-sequential.prose +36 -0
  1371. package/extensions/open-prose/skills/prose/examples/19-advanced-parallel.prose +71 -0
  1372. package/extensions/open-prose/skills/prose/examples/20-fixed-loops.prose +20 -0
  1373. package/extensions/open-prose/skills/prose/examples/21-pipeline-operations.prose +35 -0
  1374. package/extensions/open-prose/skills/prose/examples/22-error-handling.prose +51 -0
  1375. package/extensions/open-prose/skills/prose/examples/23-retry-with-backoff.prose +63 -0
  1376. package/extensions/open-prose/skills/prose/examples/24-choice-blocks.prose +86 -0
  1377. package/extensions/open-prose/skills/prose/examples/25-conditionals.prose +114 -0
  1378. package/extensions/open-prose/skills/prose/examples/26-parameterized-blocks.prose +100 -0
  1379. package/extensions/open-prose/skills/prose/examples/27-string-interpolation.prose +105 -0
  1380. package/extensions/open-prose/skills/prose/examples/28-automated-pr-review.prose +37 -0
  1381. package/extensions/open-prose/skills/prose/examples/28-gas-town.prose +1572 -0
  1382. package/extensions/open-prose/skills/prose/examples/29-captains-chair.prose +218 -0
  1383. package/extensions/open-prose/skills/prose/examples/30-captains-chair-simple.prose +42 -0
  1384. package/extensions/open-prose/skills/prose/examples/31-captains-chair-with-memory.prose +145 -0
  1385. package/extensions/open-prose/skills/prose/examples/33-pr-review-autofix.prose +168 -0
  1386. package/extensions/open-prose/skills/prose/examples/34-content-pipeline.prose +204 -0
  1387. package/extensions/open-prose/skills/prose/examples/35-feature-factory.prose +296 -0
  1388. package/extensions/open-prose/skills/prose/examples/36-bug-hunter.prose +237 -0
  1389. package/extensions/open-prose/skills/prose/examples/37-the-forge.prose +1474 -0
  1390. package/extensions/open-prose/skills/prose/examples/38-skill-scan.prose +455 -0
  1391. package/extensions/open-prose/skills/prose/examples/39-architect-by-simulation.prose +277 -0
  1392. package/extensions/open-prose/skills/prose/examples/40-rlm-self-refine.prose +32 -0
  1393. package/extensions/open-prose/skills/prose/examples/41-rlm-divide-conquer.prose +38 -0
  1394. package/extensions/open-prose/skills/prose/examples/42-rlm-filter-recurse.prose +46 -0
  1395. package/extensions/open-prose/skills/prose/examples/43-rlm-pairwise.prose +50 -0
  1396. package/extensions/open-prose/skills/prose/examples/44-run-endpoint-ux-test.prose +261 -0
  1397. package/extensions/open-prose/skills/prose/examples/45-plugin-release.prose +159 -0
  1398. package/extensions/open-prose/skills/prose/examples/45-run-endpoint-ux-test-with-remediation.prose +637 -0
  1399. package/extensions/open-prose/skills/prose/examples/46-run-endpoint-ux-test-fast.prose +148 -0
  1400. package/extensions/open-prose/skills/prose/examples/46-workflow-crystallizer.prose +225 -0
  1401. package/extensions/open-prose/skills/prose/examples/47-language-self-improvement.prose +356 -0
  1402. package/extensions/open-prose/skills/prose/examples/48-habit-miner.prose +445 -0
  1403. package/extensions/open-prose/skills/prose/examples/49-prose-run-retrospective.prose +210 -0
  1404. package/extensions/open-prose/skills/prose/examples/README.md +391 -0
  1405. package/extensions/open-prose/skills/prose/examples/roadmap/README.md +22 -0
  1406. package/extensions/open-prose/skills/prose/examples/roadmap/iterative-refinement.prose +20 -0
  1407. package/extensions/open-prose/skills/prose/examples/roadmap/parallel-review.prose +18 -0
  1408. package/extensions/open-prose/skills/prose/examples/roadmap/simple-pipeline.prose +17 -0
  1409. package/extensions/open-prose/skills/prose/examples/roadmap/syntax/open-prose-syntax.prose +223 -0
  1410. package/extensions/open-prose/skills/prose/guidance/antipatterns.md +951 -0
  1411. package/extensions/open-prose/skills/prose/guidance/patterns.md +700 -0
  1412. package/extensions/open-prose/skills/prose/guidance/system-prompt.md +180 -0
  1413. package/extensions/open-prose/skills/prose/help.md +144 -0
  1414. package/extensions/open-prose/skills/prose/lib/README.md +108 -0
  1415. package/extensions/open-prose/skills/prose/lib/calibrator.prose +215 -0
  1416. package/extensions/open-prose/skills/prose/lib/cost-analyzer.prose +174 -0
  1417. package/extensions/open-prose/skills/prose/lib/error-forensics.prose +250 -0
  1418. package/extensions/open-prose/skills/prose/lib/inspector.prose +196 -0
  1419. package/extensions/open-prose/skills/prose/lib/profiler.prose +460 -0
  1420. package/extensions/open-prose/skills/prose/lib/program-improver.prose +275 -0
  1421. package/extensions/open-prose/skills/prose/lib/project-memory.prose +118 -0
  1422. package/extensions/open-prose/skills/prose/lib/user-memory.prose +93 -0
  1423. package/extensions/open-prose/skills/prose/lib/vm-improver.prose +243 -0
  1424. package/extensions/open-prose/skills/prose/primitives/session.md +593 -0
  1425. package/extensions/open-prose/skills/prose/prose.md +1237 -0
  1426. package/extensions/open-prose/skills/prose/state/filesystem.md +498 -0
  1427. package/extensions/open-prose/skills/prose/state/in-context.md +384 -0
  1428. package/extensions/open-prose/skills/prose/state/postgres.md +880 -0
  1429. package/extensions/open-prose/skills/prose/state/sqlite.md +574 -0
  1430. package/extensions/qwen-portal-auth/README.md +24 -0
  1431. package/extensions/qwen-portal-auth/index.ts +130 -0
  1432. package/extensions/qwen-portal-auth/oauth.ts +190 -0
  1433. package/extensions/qwen-portal-auth/openclaw.plugin.json +9 -0
  1434. package/extensions/signal/index.ts +17 -0
  1435. package/extensions/signal/node_modules/.bin/openclaw +21 -0
  1436. package/extensions/signal/openclaw.plugin.json +9 -0
  1437. package/extensions/signal/package.json +14 -0
  1438. package/extensions/signal/src/channel.ts +315 -0
  1439. package/extensions/signal/src/runtime.ts +14 -0
  1440. package/extensions/slack/index.ts +17 -0
  1441. package/extensions/slack/node_modules/.bin/openclaw +21 -0
  1442. package/extensions/slack/openclaw.plugin.json +9 -0
  1443. package/extensions/slack/package.json +14 -0
  1444. package/extensions/slack/src/channel.ts +604 -0
  1445. package/extensions/slack/src/runtime.ts +14 -0
  1446. package/extensions/telegram/index.ts +17 -0
  1447. package/extensions/telegram/node_modules/.bin/openclaw +21 -0
  1448. package/extensions/telegram/openclaw.plugin.json +9 -0
  1449. package/extensions/telegram/package.json +14 -0
  1450. package/extensions/telegram/src/channel.ts +482 -0
  1451. package/extensions/telegram/src/runtime.ts +14 -0
  1452. package/extensions/tlon/README.md +5 -0
  1453. package/extensions/tlon/index.ts +17 -0
  1454. package/extensions/tlon/node_modules/.bin/openclaw +21 -0
  1455. package/extensions/tlon/openclaw.plugin.json +9 -0
  1456. package/extensions/tlon/package.json +33 -0
  1457. package/extensions/tlon/src/channel.ts +392 -0
  1458. package/extensions/tlon/src/config-schema.test.ts +31 -0
  1459. package/extensions/tlon/src/config-schema.ts +43 -0
  1460. package/extensions/tlon/src/monitor/discovery.ts +76 -0
  1461. package/extensions/tlon/src/monitor/history.ts +90 -0
  1462. package/extensions/tlon/src/monitor/index.ts +553 -0
  1463. package/extensions/tlon/src/monitor/processed-messages.test.ts +23 -0
  1464. package/extensions/tlon/src/monitor/processed-messages.ts +46 -0
  1465. package/extensions/tlon/src/monitor/utils.ts +105 -0
  1466. package/extensions/tlon/src/onboarding.ts +214 -0
  1467. package/extensions/tlon/src/runtime.ts +14 -0
  1468. package/extensions/tlon/src/targets.ts +89 -0
  1469. package/extensions/tlon/src/types.ts +92 -0
  1470. package/extensions/tlon/src/urbit/auth.ts +18 -0
  1471. package/extensions/tlon/src/urbit/http-api.ts +38 -0
  1472. package/extensions/tlon/src/urbit/send.test.ts +38 -0
  1473. package/extensions/tlon/src/urbit/send.ts +131 -0
  1474. package/extensions/tlon/src/urbit/sse-client.test.ts +40 -0
  1475. package/extensions/tlon/src/urbit/sse-client.ts +395 -0
  1476. package/extensions/twitch/CHANGELOG.md +45 -0
  1477. package/extensions/twitch/README.md +89 -0
  1478. package/extensions/twitch/index.ts +20 -0
  1479. package/extensions/twitch/node_modules/.bin/openclaw +21 -0
  1480. package/extensions/twitch/openclaw.plugin.json +9 -0
  1481. package/extensions/twitch/package.json +20 -0
  1482. package/extensions/twitch/src/access-control.test.ts +489 -0
  1483. package/extensions/twitch/src/access-control.ts +166 -0
  1484. package/extensions/twitch/src/actions.ts +173 -0
  1485. package/extensions/twitch/src/client-manager-registry.ts +115 -0
  1486. package/extensions/twitch/src/config-schema.ts +82 -0
  1487. package/extensions/twitch/src/config.test.ts +87 -0
  1488. package/extensions/twitch/src/config.ts +116 -0
  1489. package/extensions/twitch/src/monitor.ts +261 -0
  1490. package/extensions/twitch/src/onboarding.test.ts +311 -0
  1491. package/extensions/twitch/src/onboarding.ts +417 -0
  1492. package/extensions/twitch/src/outbound.test.ts +373 -0
  1493. package/extensions/twitch/src/outbound.ts +184 -0
  1494. package/extensions/twitch/src/plugin.test.ts +39 -0
  1495. package/extensions/twitch/src/plugin.ts +274 -0
  1496. package/extensions/twitch/src/probe.test.ts +195 -0
  1497. package/extensions/twitch/src/probe.ts +120 -0
  1498. package/extensions/twitch/src/resolver.ts +137 -0
  1499. package/extensions/twitch/src/runtime.ts +14 -0
  1500. package/extensions/twitch/src/send.test.ts +289 -0
  1501. package/extensions/twitch/src/send.ts +136 -0
  1502. package/extensions/twitch/src/status.test.ts +270 -0
  1503. package/extensions/twitch/src/status.ts +178 -0
  1504. package/extensions/twitch/src/token.test.ts +171 -0
  1505. package/extensions/twitch/src/token.ts +91 -0
  1506. package/extensions/twitch/src/twitch-client.test.ts +589 -0
  1507. package/extensions/twitch/src/twitch-client.ts +277 -0
  1508. package/extensions/twitch/src/types.ts +141 -0
  1509. package/extensions/twitch/src/utils/markdown.ts +98 -0
  1510. package/extensions/twitch/src/utils/twitch.ts +78 -0
  1511. package/extensions/twitch/test/setup.ts +7 -0
  1512. package/extensions/voice-call/CHANGELOG.md +109 -0
  1513. package/extensions/voice-call/README.md +139 -0
  1514. package/extensions/voice-call/index.ts +493 -0
  1515. package/extensions/voice-call/node_modules/.bin/openclaw +21 -0
  1516. package/extensions/voice-call/openclaw.plugin.json +559 -0
  1517. package/extensions/voice-call/package.json +19 -0
  1518. package/extensions/voice-call/src/allowlist.ts +19 -0
  1519. package/extensions/voice-call/src/cli.ts +279 -0
  1520. package/extensions/voice-call/src/config.test.ts +234 -0
  1521. package/extensions/voice-call/src/config.ts +523 -0
  1522. package/extensions/voice-call/src/core-bridge.ts +159 -0
  1523. package/extensions/voice-call/src/manager/context.ts +21 -0
  1524. package/extensions/voice-call/src/manager/events.ts +188 -0
  1525. package/extensions/voice-call/src/manager/lookup.ts +35 -0
  1526. package/extensions/voice-call/src/manager/outbound.ts +275 -0
  1527. package/extensions/voice-call/src/manager/state.ts +48 -0
  1528. package/extensions/voice-call/src/manager/store.ts +91 -0
  1529. package/extensions/voice-call/src/manager/timers.ts +89 -0
  1530. package/extensions/voice-call/src/manager/twiml.ts +9 -0
  1531. package/extensions/voice-call/src/manager.test.ts +194 -0
  1532. package/extensions/voice-call/src/manager.ts +887 -0
  1533. package/extensions/voice-call/src/media-stream.test.ts +96 -0
  1534. package/extensions/voice-call/src/media-stream.ts +411 -0
  1535. package/extensions/voice-call/src/providers/base.ts +67 -0
  1536. package/extensions/voice-call/src/providers/index.ts +10 -0
  1537. package/extensions/voice-call/src/providers/mock.ts +165 -0
  1538. package/extensions/voice-call/src/providers/plivo.test.ts +27 -0
  1539. package/extensions/voice-call/src/providers/plivo.ts +515 -0
  1540. package/extensions/voice-call/src/providers/stt-openai-realtime.ts +311 -0
  1541. package/extensions/voice-call/src/providers/telnyx.ts +371 -0
  1542. package/extensions/voice-call/src/providers/tts-openai.ts +259 -0
  1543. package/extensions/voice-call/src/providers/twilio/api.ts +42 -0
  1544. package/extensions/voice-call/src/providers/twilio/webhook.ts +32 -0
  1545. package/extensions/voice-call/src/providers/twilio.test.ts +60 -0
  1546. package/extensions/voice-call/src/providers/twilio.ts +626 -0
  1547. package/extensions/voice-call/src/response-generator.ts +158 -0
  1548. package/extensions/voice-call/src/runtime.ts +212 -0
  1549. package/extensions/voice-call/src/telephony-audio.ts +90 -0
  1550. package/extensions/voice-call/src/telephony-tts.ts +104 -0
  1551. package/extensions/voice-call/src/tunnel.ts +314 -0
  1552. package/extensions/voice-call/src/types.ts +272 -0
  1553. package/extensions/voice-call/src/utils.ts +14 -0
  1554. package/extensions/voice-call/src/voice-mapping.ts +67 -0
  1555. package/extensions/voice-call/src/webhook-security.test.ts +377 -0
  1556. package/extensions/voice-call/src/webhook-security.ts +689 -0
  1557. package/extensions/voice-call/src/webhook.ts +491 -0
  1558. package/extensions/whatsapp/index.ts +17 -0
  1559. package/extensions/whatsapp/node_modules/.bin/openclaw +21 -0
  1560. package/extensions/whatsapp/openclaw.plugin.json +9 -0
  1561. package/extensions/whatsapp/package.json +14 -0
  1562. package/extensions/whatsapp/src/channel.ts +508 -0
  1563. package/extensions/whatsapp/src/runtime.ts +14 -0
  1564. package/extensions/zalo/CHANGELOG.md +89 -0
  1565. package/extensions/zalo/README.md +50 -0
  1566. package/extensions/zalo/index.ts +19 -0
  1567. package/extensions/zalo/node_modules/.bin/openclaw +21 -0
  1568. package/extensions/zalo/openclaw.plugin.json +9 -0
  1569. package/extensions/zalo/package.json +36 -0
  1570. package/extensions/zalo/src/accounts.ts +80 -0
  1571. package/extensions/zalo/src/actions.ts +67 -0
  1572. package/extensions/zalo/src/api.ts +208 -0
  1573. package/extensions/zalo/src/channel.directory.test.ts +43 -0
  1574. package/extensions/zalo/src/channel.ts +414 -0
  1575. package/extensions/zalo/src/config-schema.ts +24 -0
  1576. package/extensions/zalo/src/monitor.ts +753 -0
  1577. package/extensions/zalo/src/monitor.webhook.test.ts +73 -0
  1578. package/extensions/zalo/src/onboarding.ts +401 -0
  1579. package/extensions/zalo/src/probe.ts +46 -0
  1580. package/extensions/zalo/src/proxy.ts +21 -0
  1581. package/extensions/zalo/src/runtime.ts +14 -0
  1582. package/extensions/zalo/src/send.ts +124 -0
  1583. package/extensions/zalo/src/status-issues.ts +53 -0
  1584. package/extensions/zalo/src/token.ts +63 -0
  1585. package/extensions/zalo/src/types.ts +42 -0
  1586. package/extensions/zalouser/CHANGELOG.md +61 -0
  1587. package/extensions/zalouser/README.md +225 -0
  1588. package/extensions/zalouser/index.ts +31 -0
  1589. package/extensions/zalouser/node_modules/.bin/openclaw +21 -0
  1590. package/extensions/zalouser/openclaw.plugin.json +9 -0
  1591. package/extensions/zalouser/package.json +36 -0
  1592. package/extensions/zalouser/src/accounts.ts +135 -0
  1593. package/extensions/zalouser/src/channel.test.ts +18 -0
  1594. package/extensions/zalouser/src/channel.ts +686 -0
  1595. package/extensions/zalouser/src/config-schema.ts +27 -0
  1596. package/extensions/zalouser/src/monitor.ts +590 -0
  1597. package/extensions/zalouser/src/onboarding.ts +504 -0
  1598. package/extensions/zalouser/src/probe.ts +28 -0
  1599. package/extensions/zalouser/src/runtime.ts +14 -0
  1600. package/extensions/zalouser/src/send.ts +160 -0
  1601. package/extensions/zalouser/src/status-issues.test.ts +57 -0
  1602. package/extensions/zalouser/src/status-issues.ts +89 -0
  1603. package/extensions/zalouser/src/tool.ts +164 -0
  1604. package/extensions/zalouser/src/types.ts +108 -0
  1605. package/extensions/zalouser/src/zca.ts +202 -0
  1606. package/openclaw.mjs +14 -0
  1607. package/package.json +245 -0
  1608. package/skills/1password/SKILL.md +70 -0
  1609. package/skills/1password/references/cli-examples.md +29 -0
  1610. package/skills/1password/references/get-started.md +17 -0
  1611. package/skills/apple-notes/SKILL.md +77 -0
  1612. package/skills/apple-reminders/SKILL.md +96 -0
  1613. package/skills/bear-notes/SKILL.md +107 -0
  1614. package/skills/bird/SKILL.md +224 -0
  1615. package/skills/blogwatcher/SKILL.md +69 -0
  1616. package/skills/blucli/SKILL.md +47 -0
  1617. package/skills/bluebubbles/SKILL.md +131 -0
  1618. package/skills/camsnap/SKILL.md +45 -0
  1619. package/skills/canvas/SKILL.md +198 -0
  1620. package/skills/clawhub/SKILL.md +77 -0
  1621. package/skills/coding-agent/SKILL.md +284 -0
  1622. package/skills/discord/SKILL.md +578 -0
  1623. package/skills/eightctl/SKILL.md +50 -0
  1624. package/skills/food-order/SKILL.md +48 -0
  1625. package/skills/gemini/SKILL.md +43 -0
  1626. package/skills/ghostly-projects/SKILL.md +160 -0
  1627. package/skills/gifgrep/SKILL.md +79 -0
  1628. package/skills/github/SKILL.md +77 -0
  1629. package/skills/gog/SKILL.md +116 -0
  1630. package/skills/goplaces/SKILL.md +52 -0
  1631. package/skills/healthcheck/SKILL.md +245 -0
  1632. package/skills/himalaya/SKILL.md +257 -0
  1633. package/skills/himalaya/references/configuration.md +184 -0
  1634. package/skills/himalaya/references/message-composition.md +199 -0
  1635. package/skills/imsg/SKILL.md +74 -0
  1636. package/skills/linear/SKILL.md +111 -0
  1637. package/skills/linear/linear.sh +204 -0
  1638. package/skills/local-places/SERVER_README.md +101 -0
  1639. package/skills/local-places/SKILL.md +102 -0
  1640. package/skills/local-places/pyproject.toml +21 -0
  1641. package/skills/local-places/src/local_places/__init__.py +2 -0
  1642. package/skills/local-places/src/local_places/google_places.py +314 -0
  1643. package/skills/local-places/src/local_places/main.py +65 -0
  1644. package/skills/local-places/src/local_places/schemas.py +107 -0
  1645. package/skills/mcporter/SKILL.md +61 -0
  1646. package/skills/model-usage/SKILL.md +69 -0
  1647. package/skills/model-usage/references/codexbar-cli.md +33 -0
  1648. package/skills/model-usage/scripts/model_usage.py +310 -0
  1649. package/skills/nano-banana-pro/SKILL.md +58 -0
  1650. package/skills/nano-banana-pro/scripts/generate_image.py +184 -0
  1651. package/skills/nano-pdf/SKILL.md +38 -0
  1652. package/skills/notion/SKILL.md +172 -0
  1653. package/skills/obsidian/SKILL.md +81 -0
  1654. package/skills/openai-image-gen/SKILL.md +89 -0
  1655. package/skills/openai-image-gen/scripts/gen.py +240 -0
  1656. package/skills/openai-whisper/SKILL.md +38 -0
  1657. package/skills/openai-whisper-api/SKILL.md +52 -0
  1658. package/skills/openai-whisper-api/scripts/transcribe.sh +85 -0
  1659. package/skills/openhue/SKILL.md +51 -0
  1660. package/skills/oracle/SKILL.md +125 -0
  1661. package/skills/ordercli/SKILL.md +78 -0
  1662. package/skills/peekaboo/SKILL.md +190 -0
  1663. package/skills/sag/SKILL.md +87 -0
  1664. package/skills/session-logs/SKILL.md +115 -0
  1665. package/skills/sherpa-onnx-tts/SKILL.md +103 -0
  1666. package/skills/sherpa-onnx-tts/bin/sherpa-onnx-tts +178 -0
  1667. package/skills/skill-creator/SKILL.md +370 -0
  1668. package/skills/skill-creator/license.txt +202 -0
  1669. package/skills/skill-creator/scripts/init_skill.py +378 -0
  1670. package/skills/skill-creator/scripts/package_skill.py +111 -0
  1671. package/skills/skill-creator/scripts/quick_validate.py +101 -0
  1672. package/skills/slack/SKILL.md +144 -0
  1673. package/skills/songsee/SKILL.md +49 -0
  1674. package/skills/sonoscli/SKILL.md +46 -0
  1675. package/skills/spotify-player/SKILL.md +64 -0
  1676. package/skills/summarize/SKILL.md +87 -0
  1677. package/skills/things-mac/SKILL.md +86 -0
  1678. package/skills/tmux/SKILL.md +135 -0
  1679. package/skills/tmux/scripts/find-sessions.sh +112 -0
  1680. package/skills/tmux/scripts/wait-for-text.sh +83 -0
  1681. package/skills/trello/SKILL.md +95 -0
  1682. package/skills/video-frames/SKILL.md +46 -0
  1683. package/skills/video-frames/scripts/frame.sh +81 -0
  1684. package/skills/voice-call/SKILL.md +45 -0
  1685. package/skills/wacli/SKILL.md +72 -0
  1686. package/skills/weather/SKILL.md +54 -0
@@ -0,0 +1,1973 @@
1
+ import { D as info, E as danger, F as warn, N as shouldLogVerbose, c as defaultRuntime, t as createSubsystemLogger } from "./subsystem-CAq3uyo7.js";
2
+ import { t as CONFIG_DIR } from "./utils-CKSrBNwq.js";
3
+ import { a as logDebug, t as runCommandWithTimeout } from "./exec-HEWTMJ7j.js";
4
+ import { t as formatCliCommand } from "./command-format-DELazozB.js";
5
+ import { t as rawDataToString } from "./ws-lzrgabja.js";
6
+ import os from "node:os";
7
+ import path from "node:path";
8
+ import fs from "node:fs";
9
+ import fs$1 from "node:fs/promises";
10
+ import { execFileSync, spawn } from "node:child_process";
11
+ import { randomBytes } from "node:crypto";
12
+ import { createServer } from "node:http";
13
+ import WebSocket, { WebSocketServer } from "ws";
14
+ import net from "node:net";
15
+
16
+ //#region src/browser/constants.ts
17
+ const DEFAULT_OPENCLAW_BROWSER_ENABLED = true;
18
+ const DEFAULT_BROWSER_EVALUATE_ENABLED = true;
19
+ const DEFAULT_OPENCLAW_BROWSER_COLOR = "#FF4500";
20
+ const DEFAULT_OPENCLAW_BROWSER_PROFILE_NAME = "openclaw";
21
+ const DEFAULT_BROWSER_DEFAULT_PROFILE_NAME = "chrome";
22
+ const DEFAULT_AI_SNAPSHOT_MAX_CHARS = 8e4;
23
+ const DEFAULT_AI_SNAPSHOT_EFFICIENT_MAX_CHARS = 1e4;
24
+ const DEFAULT_AI_SNAPSHOT_EFFICIENT_DEPTH = 6;
25
+
26
+ //#endregion
27
+ //#region src/infra/errors.ts
28
+ function extractErrorCode(err) {
29
+ if (!err || typeof err !== "object") return;
30
+ const code = err.code;
31
+ if (typeof code === "string") return code;
32
+ if (typeof code === "number") return String(code);
33
+ }
34
+ function formatErrorMessage(err) {
35
+ if (err instanceof Error) return err.message || err.name || "Error";
36
+ if (typeof err === "string") return err;
37
+ if (typeof err === "number" || typeof err === "boolean" || typeof err === "bigint") return String(err);
38
+ try {
39
+ return JSON.stringify(err);
40
+ } catch {
41
+ return Object.prototype.toString.call(err);
42
+ }
43
+ }
44
+ function formatUncaughtError(err) {
45
+ if (extractErrorCode(err) === "INVALID_CONFIG") return formatErrorMessage(err);
46
+ if (err instanceof Error) return err.stack ?? err.message ?? err.name;
47
+ return formatErrorMessage(err);
48
+ }
49
+
50
+ //#endregion
51
+ //#region src/browser/extension-relay.ts
52
+ const RELAY_AUTH_HEADER = "x-openclaw-relay-token";
53
+ function headerValue(value) {
54
+ if (!value) return;
55
+ if (Array.isArray(value)) return value[0];
56
+ return value;
57
+ }
58
+ function getHeader(req, name) {
59
+ return headerValue(req.headers[name.toLowerCase()]);
60
+ }
61
+ function isLoopbackHost$1(host) {
62
+ const h = host.trim().toLowerCase();
63
+ return h === "localhost" || h === "127.0.0.1" || h === "0.0.0.0" || h === "[::1]" || h === "::1" || h === "[::]" || h === "::";
64
+ }
65
+ function isLoopbackAddress(ip) {
66
+ if (!ip) return false;
67
+ if (ip === "127.0.0.1") return true;
68
+ if (ip.startsWith("127.")) return true;
69
+ if (ip === "::1") return true;
70
+ if (ip.startsWith("::ffff:127.")) return true;
71
+ return false;
72
+ }
73
+ function parseBaseUrl(raw) {
74
+ const parsed = new URL(raw.trim().replace(/\/$/, ""));
75
+ if (parsed.protocol !== "http:" && parsed.protocol !== "https:") throw new Error(`extension relay cdpUrl must be http(s), got ${parsed.protocol}`);
76
+ const host = parsed.hostname;
77
+ const port = parsed.port?.trim() !== "" ? Number(parsed.port) : parsed.protocol === "https:" ? 443 : 80;
78
+ if (!Number.isFinite(port) || port <= 0 || port > 65535) throw new Error(`extension relay cdpUrl has invalid port: ${parsed.port || "(empty)"}`);
79
+ return {
80
+ host,
81
+ port,
82
+ baseUrl: parsed.toString().replace(/\/$/, "")
83
+ };
84
+ }
85
+ function text(res, status, bodyText) {
86
+ const body = Buffer.from(bodyText);
87
+ res.write(`HTTP/1.1 ${status} ${status === 200 ? "OK" : "ERR"}\r\nContent-Type: text/plain; charset=utf-8\r
88
+ Content-Length: ${body.length}\r\nConnection: close\r
89
+ \r
90
+ `);
91
+ res.write(body);
92
+ res.end();
93
+ }
94
+ function rejectUpgrade(socket, status, bodyText) {
95
+ text(socket, status, bodyText);
96
+ try {
97
+ socket.destroy();
98
+ } catch {}
99
+ }
100
+ const serversByPort = /* @__PURE__ */ new Map();
101
+ const relayAuthByPort = /* @__PURE__ */ new Map();
102
+ function relayAuthTokenForUrl(url) {
103
+ try {
104
+ const parsed = new URL(url);
105
+ if (!isLoopbackHost$1(parsed.hostname)) return null;
106
+ const port = parsed.port?.trim() !== "" ? Number(parsed.port) : parsed.protocol === "https:" || parsed.protocol === "wss:" ? 443 : 80;
107
+ if (!Number.isFinite(port)) return null;
108
+ return relayAuthByPort.get(port) ?? null;
109
+ } catch {
110
+ return null;
111
+ }
112
+ }
113
+ function getChromeExtensionRelayAuthHeaders(url) {
114
+ const token = relayAuthTokenForUrl(url);
115
+ if (!token) return {};
116
+ return { [RELAY_AUTH_HEADER]: token };
117
+ }
118
+ async function ensureChromeExtensionRelayServer(opts) {
119
+ const info = parseBaseUrl(opts.cdpUrl);
120
+ if (!isLoopbackHost$1(info.host)) throw new Error(`extension relay requires loopback cdpUrl host (got ${info.host})`);
121
+ const existing = serversByPort.get(info.port);
122
+ if (existing) return existing;
123
+ let extensionWs = null;
124
+ const cdpClients = /* @__PURE__ */ new Set();
125
+ const connectedTargets = /* @__PURE__ */ new Map();
126
+ const pendingExtension = /* @__PURE__ */ new Map();
127
+ let nextExtensionId = 1;
128
+ const sendToExtension = async (payload) => {
129
+ const ws = extensionWs;
130
+ if (!ws || ws.readyState !== WebSocket.OPEN) throw new Error("Chrome extension not connected");
131
+ ws.send(JSON.stringify(payload));
132
+ return await new Promise((resolve, reject) => {
133
+ const timer = setTimeout(() => {
134
+ pendingExtension.delete(payload.id);
135
+ reject(/* @__PURE__ */ new Error(`extension request timeout: ${payload.params.method}`));
136
+ }, 3e4);
137
+ pendingExtension.set(payload.id, {
138
+ resolve,
139
+ reject,
140
+ timer
141
+ });
142
+ });
143
+ };
144
+ const broadcastToCdpClients = (evt) => {
145
+ const msg = JSON.stringify(evt);
146
+ for (const ws of cdpClients) {
147
+ if (ws.readyState !== WebSocket.OPEN) continue;
148
+ ws.send(msg);
149
+ }
150
+ };
151
+ const sendResponseToCdp = (ws, res) => {
152
+ if (ws.readyState !== WebSocket.OPEN) return;
153
+ ws.send(JSON.stringify(res));
154
+ };
155
+ const ensureTargetEventsForClient = (ws, mode) => {
156
+ for (const target of connectedTargets.values()) if (mode === "autoAttach") ws.send(JSON.stringify({
157
+ method: "Target.attachedToTarget",
158
+ params: {
159
+ sessionId: target.sessionId,
160
+ targetInfo: {
161
+ ...target.targetInfo,
162
+ attached: true
163
+ },
164
+ waitingForDebugger: false
165
+ }
166
+ }));
167
+ else ws.send(JSON.stringify({
168
+ method: "Target.targetCreated",
169
+ params: { targetInfo: {
170
+ ...target.targetInfo,
171
+ attached: true
172
+ } }
173
+ }));
174
+ };
175
+ const routeCdpCommand = async (cmd) => {
176
+ switch (cmd.method) {
177
+ case "Browser.getVersion": return {
178
+ protocolVersion: "1.3",
179
+ product: "Chrome/OpenClaw-Extension-Relay",
180
+ revision: "0",
181
+ userAgent: "OpenClaw-Extension-Relay",
182
+ jsVersion: "V8"
183
+ };
184
+ case "Browser.setDownloadBehavior": return {};
185
+ case "Target.setAutoAttach":
186
+ case "Target.setDiscoverTargets": return {};
187
+ case "Target.getTargets": return { targetInfos: Array.from(connectedTargets.values()).map((t) => ({
188
+ ...t.targetInfo,
189
+ attached: true
190
+ })) };
191
+ case "Target.getTargetInfo": {
192
+ const params = cmd.params ?? {};
193
+ const targetId = typeof params.targetId === "string" ? params.targetId : void 0;
194
+ if (targetId) {
195
+ for (const t of connectedTargets.values()) if (t.targetId === targetId) return { targetInfo: t.targetInfo };
196
+ }
197
+ if (cmd.sessionId && connectedTargets.has(cmd.sessionId)) {
198
+ const t = connectedTargets.get(cmd.sessionId);
199
+ if (t) return { targetInfo: t.targetInfo };
200
+ }
201
+ return { targetInfo: Array.from(connectedTargets.values())[0]?.targetInfo };
202
+ }
203
+ case "Target.attachToTarget": {
204
+ const params = cmd.params ?? {};
205
+ const targetId = typeof params.targetId === "string" ? params.targetId : void 0;
206
+ if (!targetId) throw new Error("targetId required");
207
+ for (const t of connectedTargets.values()) if (t.targetId === targetId) return { sessionId: t.sessionId };
208
+ throw new Error("target not found");
209
+ }
210
+ default: return await sendToExtension({
211
+ id: nextExtensionId++,
212
+ method: "forwardCDPCommand",
213
+ params: {
214
+ method: cmd.method,
215
+ sessionId: cmd.sessionId,
216
+ params: cmd.params
217
+ }
218
+ });
219
+ }
220
+ };
221
+ const relayAuthToken = randomBytes(32).toString("base64url");
222
+ const server = createServer((req, res) => {
223
+ const path = new URL(req.url ?? "/", info.baseUrl).pathname;
224
+ if (path.startsWith("/json")) {
225
+ const token = getHeader(req, RELAY_AUTH_HEADER);
226
+ if (!token || token !== relayAuthToken) {
227
+ res.writeHead(401);
228
+ res.end("Unauthorized");
229
+ return;
230
+ }
231
+ }
232
+ if (req.method === "HEAD" && path === "/") {
233
+ res.writeHead(200);
234
+ res.end();
235
+ return;
236
+ }
237
+ if (path === "/") {
238
+ res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
239
+ res.end("OK");
240
+ return;
241
+ }
242
+ if (path === "/extension/status") {
243
+ res.writeHead(200, { "Content-Type": "application/json" });
244
+ res.end(JSON.stringify({ connected: Boolean(extensionWs) }));
245
+ return;
246
+ }
247
+ const cdpWsUrl = `${`ws://${req.headers.host?.trim() || `${info.host}:${info.port}`}`}/cdp`;
248
+ if ((path === "/json/version" || path === "/json/version/") && (req.method === "GET" || req.method === "PUT")) {
249
+ const payload = {
250
+ Browser: "OpenClaw/extension-relay",
251
+ "Protocol-Version": "1.3"
252
+ };
253
+ if (extensionWs) payload.webSocketDebuggerUrl = cdpWsUrl;
254
+ res.writeHead(200, { "Content-Type": "application/json" });
255
+ res.end(JSON.stringify(payload));
256
+ return;
257
+ }
258
+ if (new Set([
259
+ "/json",
260
+ "/json/",
261
+ "/json/list",
262
+ "/json/list/"
263
+ ]).has(path) && (req.method === "GET" || req.method === "PUT")) {
264
+ const list = Array.from(connectedTargets.values()).map((t) => ({
265
+ id: t.targetId,
266
+ type: t.targetInfo.type ?? "page",
267
+ title: t.targetInfo.title ?? "",
268
+ description: t.targetInfo.title ?? "",
269
+ url: t.targetInfo.url ?? "",
270
+ webSocketDebuggerUrl: cdpWsUrl,
271
+ devtoolsFrontendUrl: `/devtools/inspector.html?ws=${cdpWsUrl.replace("ws://", "")}`
272
+ }));
273
+ res.writeHead(200, { "Content-Type": "application/json" });
274
+ res.end(JSON.stringify(list));
275
+ return;
276
+ }
277
+ const activateMatch = path.match(/^\/json\/activate\/(.+)$/);
278
+ if (activateMatch && (req.method === "GET" || req.method === "PUT")) {
279
+ const targetId = decodeURIComponent(activateMatch[1] ?? "").trim();
280
+ if (!targetId) {
281
+ res.writeHead(400);
282
+ res.end("targetId required");
283
+ return;
284
+ }
285
+ (async () => {
286
+ try {
287
+ await sendToExtension({
288
+ id: nextExtensionId++,
289
+ method: "forwardCDPCommand",
290
+ params: {
291
+ method: "Target.activateTarget",
292
+ params: { targetId }
293
+ }
294
+ });
295
+ } catch {}
296
+ })();
297
+ res.writeHead(200);
298
+ res.end("OK");
299
+ return;
300
+ }
301
+ const closeMatch = path.match(/^\/json\/close\/(.+)$/);
302
+ if (closeMatch && (req.method === "GET" || req.method === "PUT")) {
303
+ const targetId = decodeURIComponent(closeMatch[1] ?? "").trim();
304
+ if (!targetId) {
305
+ res.writeHead(400);
306
+ res.end("targetId required");
307
+ return;
308
+ }
309
+ (async () => {
310
+ try {
311
+ await sendToExtension({
312
+ id: nextExtensionId++,
313
+ method: "forwardCDPCommand",
314
+ params: {
315
+ method: "Target.closeTarget",
316
+ params: { targetId }
317
+ }
318
+ });
319
+ } catch {}
320
+ })();
321
+ res.writeHead(200);
322
+ res.end("OK");
323
+ return;
324
+ }
325
+ res.writeHead(404);
326
+ res.end("not found");
327
+ });
328
+ const wssExtension = new WebSocketServer({ noServer: true });
329
+ const wssCdp = new WebSocketServer({ noServer: true });
330
+ server.on("upgrade", (req, socket, head) => {
331
+ const pathname = new URL(req.url ?? "/", info.baseUrl).pathname;
332
+ const remote = req.socket.remoteAddress;
333
+ if (!isLoopbackAddress(remote)) {
334
+ rejectUpgrade(socket, 403, "Forbidden");
335
+ return;
336
+ }
337
+ const origin = headerValue(req.headers.origin);
338
+ if (origin && !origin.startsWith("chrome-extension://")) {
339
+ rejectUpgrade(socket, 403, "Forbidden: invalid origin");
340
+ return;
341
+ }
342
+ if (pathname === "/extension") {
343
+ if (extensionWs) {
344
+ rejectUpgrade(socket, 409, "Extension already connected");
345
+ return;
346
+ }
347
+ wssExtension.handleUpgrade(req, socket, head, (ws) => {
348
+ wssExtension.emit("connection", ws, req);
349
+ });
350
+ return;
351
+ }
352
+ if (pathname === "/cdp") {
353
+ const token = getHeader(req, RELAY_AUTH_HEADER);
354
+ if (!token || token !== relayAuthToken) {
355
+ rejectUpgrade(socket, 401, "Unauthorized");
356
+ return;
357
+ }
358
+ if (!extensionWs) {
359
+ rejectUpgrade(socket, 503, "Extension not connected");
360
+ return;
361
+ }
362
+ wssCdp.handleUpgrade(req, socket, head, (ws) => {
363
+ wssCdp.emit("connection", ws, req);
364
+ });
365
+ return;
366
+ }
367
+ rejectUpgrade(socket, 404, "Not Found");
368
+ });
369
+ wssExtension.on("connection", (ws) => {
370
+ extensionWs = ws;
371
+ const ping = setInterval(() => {
372
+ if (ws.readyState !== WebSocket.OPEN) return;
373
+ ws.send(JSON.stringify({ method: "ping" }));
374
+ }, 5e3);
375
+ ws.on("message", (data) => {
376
+ let parsed = null;
377
+ try {
378
+ parsed = JSON.parse(rawDataToString(data));
379
+ } catch {
380
+ return;
381
+ }
382
+ if (parsed && typeof parsed === "object" && "id" in parsed && typeof parsed.id === "number") {
383
+ const pending = pendingExtension.get(parsed.id);
384
+ if (!pending) return;
385
+ pendingExtension.delete(parsed.id);
386
+ clearTimeout(pending.timer);
387
+ if ("error" in parsed && typeof parsed.error === "string" && parsed.error.trim()) pending.reject(new Error(parsed.error));
388
+ else pending.resolve(parsed.result);
389
+ return;
390
+ }
391
+ if (parsed && typeof parsed === "object" && "method" in parsed) {
392
+ if (parsed.method === "pong") return;
393
+ if (parsed.method !== "forwardCDPEvent") return;
394
+ const evt = parsed;
395
+ const method = evt.params?.method;
396
+ const params = evt.params?.params;
397
+ const sessionId = evt.params?.sessionId;
398
+ if (!method || typeof method !== "string") return;
399
+ if (method === "Target.attachedToTarget") {
400
+ const attached = params ?? {};
401
+ if ((attached?.targetInfo?.type ?? "page") !== "page") return;
402
+ if (attached?.sessionId && attached?.targetInfo?.targetId) {
403
+ const prev = connectedTargets.get(attached.sessionId);
404
+ const nextTargetId = attached.targetInfo.targetId;
405
+ const prevTargetId = prev?.targetId;
406
+ const changedTarget = Boolean(prev && prevTargetId && prevTargetId !== nextTargetId);
407
+ connectedTargets.set(attached.sessionId, {
408
+ sessionId: attached.sessionId,
409
+ targetId: nextTargetId,
410
+ targetInfo: attached.targetInfo
411
+ });
412
+ if (changedTarget && prevTargetId) broadcastToCdpClients({
413
+ method: "Target.detachedFromTarget",
414
+ params: {
415
+ sessionId: attached.sessionId,
416
+ targetId: prevTargetId
417
+ },
418
+ sessionId: attached.sessionId
419
+ });
420
+ if (!prev || changedTarget) broadcastToCdpClients({
421
+ method,
422
+ params,
423
+ sessionId
424
+ });
425
+ return;
426
+ }
427
+ }
428
+ if (method === "Target.detachedFromTarget") {
429
+ const detached = params ?? {};
430
+ if (detached?.sessionId) connectedTargets.delete(detached.sessionId);
431
+ broadcastToCdpClients({
432
+ method,
433
+ params,
434
+ sessionId
435
+ });
436
+ return;
437
+ }
438
+ if (method === "Target.targetInfoChanged") {
439
+ const targetInfo = (params ?? {})?.targetInfo;
440
+ const targetId = targetInfo?.targetId;
441
+ if (targetId && (targetInfo?.type ?? "page") === "page") for (const [sid, target] of connectedTargets) {
442
+ if (target.targetId !== targetId) continue;
443
+ connectedTargets.set(sid, {
444
+ ...target,
445
+ targetInfo: {
446
+ ...target.targetInfo,
447
+ ...targetInfo
448
+ }
449
+ });
450
+ }
451
+ }
452
+ broadcastToCdpClients({
453
+ method,
454
+ params,
455
+ sessionId
456
+ });
457
+ }
458
+ });
459
+ ws.on("close", () => {
460
+ clearInterval(ping);
461
+ extensionWs = null;
462
+ for (const [, pending] of pendingExtension) {
463
+ clearTimeout(pending.timer);
464
+ pending.reject(/* @__PURE__ */ new Error("extension disconnected"));
465
+ }
466
+ pendingExtension.clear();
467
+ connectedTargets.clear();
468
+ for (const client of cdpClients) try {
469
+ client.close(1011, "extension disconnected");
470
+ } catch {}
471
+ cdpClients.clear();
472
+ });
473
+ });
474
+ wssCdp.on("connection", (ws) => {
475
+ cdpClients.add(ws);
476
+ ws.on("message", async (data) => {
477
+ let cmd = null;
478
+ try {
479
+ cmd = JSON.parse(rawDataToString(data));
480
+ } catch {
481
+ return;
482
+ }
483
+ if (!cmd || typeof cmd !== "object") return;
484
+ if (typeof cmd.id !== "number" || typeof cmd.method !== "string") return;
485
+ if (!extensionWs) {
486
+ sendResponseToCdp(ws, {
487
+ id: cmd.id,
488
+ sessionId: cmd.sessionId,
489
+ error: { message: "Extension not connected" }
490
+ });
491
+ return;
492
+ }
493
+ try {
494
+ const result = await routeCdpCommand(cmd);
495
+ if (cmd.method === "Target.setAutoAttach" && !cmd.sessionId) ensureTargetEventsForClient(ws, "autoAttach");
496
+ if (cmd.method === "Target.setDiscoverTargets") {
497
+ if ((cmd.params ?? {}).discover === true) ensureTargetEventsForClient(ws, "discover");
498
+ }
499
+ if (cmd.method === "Target.attachToTarget") {
500
+ const params = cmd.params ?? {};
501
+ const targetId = typeof params.targetId === "string" ? params.targetId : void 0;
502
+ if (targetId) {
503
+ const target = Array.from(connectedTargets.values()).find((t) => t.targetId === targetId);
504
+ if (target) ws.send(JSON.stringify({
505
+ method: "Target.attachedToTarget",
506
+ params: {
507
+ sessionId: target.sessionId,
508
+ targetInfo: {
509
+ ...target.targetInfo,
510
+ attached: true
511
+ },
512
+ waitingForDebugger: false
513
+ }
514
+ }));
515
+ }
516
+ }
517
+ sendResponseToCdp(ws, {
518
+ id: cmd.id,
519
+ sessionId: cmd.sessionId,
520
+ result
521
+ });
522
+ } catch (err) {
523
+ sendResponseToCdp(ws, {
524
+ id: cmd.id,
525
+ sessionId: cmd.sessionId,
526
+ error: { message: err instanceof Error ? err.message : String(err) }
527
+ });
528
+ }
529
+ });
530
+ ws.on("close", () => {
531
+ cdpClients.delete(ws);
532
+ });
533
+ });
534
+ await new Promise((resolve, reject) => {
535
+ server.listen(info.port, info.host, () => resolve());
536
+ server.once("error", reject);
537
+ });
538
+ const port = server.address()?.port ?? info.port;
539
+ const host = info.host;
540
+ const relay = {
541
+ host,
542
+ port,
543
+ baseUrl: `${new URL(info.baseUrl).protocol}//${host}:${port}`,
544
+ cdpWsUrl: `ws://${host}:${port}/cdp`,
545
+ extensionConnected: () => Boolean(extensionWs),
546
+ stop: async () => {
547
+ serversByPort.delete(port);
548
+ relayAuthByPort.delete(port);
549
+ try {
550
+ extensionWs?.close(1001, "server stopping");
551
+ } catch {}
552
+ for (const ws of cdpClients) try {
553
+ ws.close(1001, "server stopping");
554
+ } catch {}
555
+ await new Promise((resolve) => {
556
+ server.close(() => resolve());
557
+ });
558
+ wssExtension.close();
559
+ wssCdp.close();
560
+ }
561
+ };
562
+ relayAuthByPort.set(port, relayAuthToken);
563
+ serversByPort.set(port, relay);
564
+ return relay;
565
+ }
566
+ async function stopChromeExtensionRelayServer(opts) {
567
+ const info = parseBaseUrl(opts.cdpUrl);
568
+ const existing = serversByPort.get(info.port);
569
+ if (!existing) return false;
570
+ await existing.stop();
571
+ relayAuthByPort.delete(info.port);
572
+ return true;
573
+ }
574
+
575
+ //#endregion
576
+ //#region src/browser/cdp.helpers.ts
577
+ function isLoopbackHost(host) {
578
+ const h = host.trim().toLowerCase();
579
+ return h === "localhost" || h === "127.0.0.1" || h === "0.0.0.0" || h === "[::1]" || h === "::1" || h === "[::]" || h === "::";
580
+ }
581
+ function getHeadersWithAuth(url, headers = {}) {
582
+ const mergedHeaders = {
583
+ ...getChromeExtensionRelayAuthHeaders(url),
584
+ ...headers
585
+ };
586
+ try {
587
+ const parsed = new URL(url);
588
+ if (Object.keys(mergedHeaders).some((key) => key.toLowerCase() === "authorization")) return mergedHeaders;
589
+ if (parsed.username || parsed.password) {
590
+ const auth = Buffer.from(`${parsed.username}:${parsed.password}`).toString("base64");
591
+ return {
592
+ ...mergedHeaders,
593
+ Authorization: `Basic ${auth}`
594
+ };
595
+ }
596
+ } catch {}
597
+ return mergedHeaders;
598
+ }
599
+ function appendCdpPath(cdpUrl, path) {
600
+ const url = new URL(cdpUrl);
601
+ url.pathname = `${url.pathname.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
602
+ return url.toString();
603
+ }
604
+ function createCdpSender(ws) {
605
+ let nextId = 1;
606
+ const pending = /* @__PURE__ */ new Map();
607
+ const send = (method, params) => {
608
+ const id = nextId++;
609
+ const msg = {
610
+ id,
611
+ method,
612
+ params
613
+ };
614
+ ws.send(JSON.stringify(msg));
615
+ return new Promise((resolve, reject) => {
616
+ pending.set(id, {
617
+ resolve,
618
+ reject
619
+ });
620
+ });
621
+ };
622
+ const closeWithError = (err) => {
623
+ for (const [, p] of pending) p.reject(err);
624
+ pending.clear();
625
+ try {
626
+ ws.close();
627
+ } catch {}
628
+ };
629
+ ws.on("message", (data) => {
630
+ try {
631
+ const parsed = JSON.parse(rawDataToString(data));
632
+ if (typeof parsed.id !== "number") return;
633
+ const p = pending.get(parsed.id);
634
+ if (!p) return;
635
+ pending.delete(parsed.id);
636
+ if (parsed.error?.message) {
637
+ p.reject(new Error(parsed.error.message));
638
+ return;
639
+ }
640
+ p.resolve(parsed.result);
641
+ } catch {}
642
+ });
643
+ ws.on("close", () => {
644
+ closeWithError(/* @__PURE__ */ new Error("CDP socket closed"));
645
+ });
646
+ return {
647
+ send,
648
+ closeWithError
649
+ };
650
+ }
651
+ async function fetchJson(url, timeoutMs = 1500, init) {
652
+ const ctrl = new AbortController();
653
+ const t = setTimeout(() => ctrl.abort(), timeoutMs);
654
+ try {
655
+ const headers = getHeadersWithAuth(url, init?.headers || {});
656
+ const res = await fetch(url, {
657
+ ...init,
658
+ headers,
659
+ signal: ctrl.signal
660
+ });
661
+ if (!res.ok) throw new Error(`HTTP ${res.status}`);
662
+ return await res.json();
663
+ } finally {
664
+ clearTimeout(t);
665
+ }
666
+ }
667
+ async function withCdpSocket(wsUrl, fn, opts) {
668
+ const headers = getHeadersWithAuth(wsUrl, opts?.headers ?? {});
669
+ const ws = new WebSocket(wsUrl, {
670
+ handshakeTimeout: 5e3,
671
+ ...Object.keys(headers).length ? { headers } : {}
672
+ });
673
+ const { send, closeWithError } = createCdpSender(ws);
674
+ await new Promise((resolve, reject) => {
675
+ ws.once("open", () => resolve());
676
+ ws.once("error", (err) => reject(err));
677
+ });
678
+ try {
679
+ return await fn(send);
680
+ } catch (err) {
681
+ closeWithError(err instanceof Error ? err : new Error(String(err)));
682
+ throw err;
683
+ } finally {
684
+ try {
685
+ ws.close();
686
+ } catch {}
687
+ }
688
+ }
689
+
690
+ //#endregion
691
+ //#region src/browser/cdp.ts
692
+ function normalizeCdpWsUrl(wsUrl, cdpUrl) {
693
+ const ws = new URL(wsUrl);
694
+ const cdp = new URL(cdpUrl);
695
+ if (isLoopbackHost(ws.hostname) && !isLoopbackHost(cdp.hostname)) {
696
+ ws.hostname = cdp.hostname;
697
+ const cdpPort = cdp.port || (cdp.protocol === "https:" ? "443" : "80");
698
+ if (cdpPort) ws.port = cdpPort;
699
+ ws.protocol = cdp.protocol === "https:" ? "wss:" : "ws:";
700
+ }
701
+ if (cdp.protocol === "https:" && ws.protocol === "ws:") ws.protocol = "wss:";
702
+ if (!ws.username && !ws.password && (cdp.username || cdp.password)) {
703
+ ws.username = cdp.username;
704
+ ws.password = cdp.password;
705
+ }
706
+ for (const [key, value] of cdp.searchParams.entries()) if (!ws.searchParams.has(key)) ws.searchParams.append(key, value);
707
+ return ws.toString();
708
+ }
709
+ async function captureScreenshot(opts) {
710
+ return await withCdpSocket(opts.wsUrl, async (send) => {
711
+ await send("Page.enable");
712
+ let clip;
713
+ if (opts.fullPage) {
714
+ const metrics = await send("Page.getLayoutMetrics");
715
+ const size = metrics?.cssContentSize ?? metrics?.contentSize;
716
+ const width = Number(size?.width ?? 0);
717
+ const height = Number(size?.height ?? 0);
718
+ if (width > 0 && height > 0) clip = {
719
+ x: 0,
720
+ y: 0,
721
+ width,
722
+ height,
723
+ scale: 1
724
+ };
725
+ }
726
+ const format = opts.format ?? "png";
727
+ const quality = format === "jpeg" ? Math.max(0, Math.min(100, Math.round(opts.quality ?? 85))) : void 0;
728
+ const base64 = (await send("Page.captureScreenshot", {
729
+ format,
730
+ ...quality !== void 0 ? { quality } : {},
731
+ fromSurface: true,
732
+ captureBeyondViewport: true,
733
+ ...clip ? { clip } : {}
734
+ }))?.data;
735
+ if (!base64) throw new Error("Screenshot failed: missing data");
736
+ return Buffer.from(base64, "base64");
737
+ });
738
+ }
739
+ async function createTargetViaCdp(opts) {
740
+ const version = await fetchJson(appendCdpPath(opts.cdpUrl, "/json/version"), 1500);
741
+ const wsUrlRaw = String(version?.webSocketDebuggerUrl ?? "").trim();
742
+ const wsUrl = wsUrlRaw ? normalizeCdpWsUrl(wsUrlRaw, opts.cdpUrl) : "";
743
+ if (!wsUrl) throw new Error("CDP /json/version missing webSocketDebuggerUrl");
744
+ return await withCdpSocket(wsUrl, async (send) => {
745
+ const created = await send("Target.createTarget", { url: opts.url });
746
+ const targetId = String(created?.targetId ?? "").trim();
747
+ if (!targetId) throw new Error("CDP Target.createTarget returned no targetId");
748
+ return { targetId };
749
+ });
750
+ }
751
+ function axValue(v) {
752
+ if (!v || typeof v !== "object") return "";
753
+ const value = v.value;
754
+ if (typeof value === "string") return value;
755
+ if (typeof value === "number" || typeof value === "boolean") return String(value);
756
+ return "";
757
+ }
758
+ function formatAriaSnapshot(nodes, limit) {
759
+ const byId = /* @__PURE__ */ new Map();
760
+ for (const n of nodes) if (n.nodeId) byId.set(n.nodeId, n);
761
+ const referenced = /* @__PURE__ */ new Set();
762
+ for (const n of nodes) for (const c of n.childIds ?? []) referenced.add(c);
763
+ const root = nodes.find((n) => n.nodeId && !referenced.has(n.nodeId)) ?? nodes[0];
764
+ if (!root?.nodeId) return [];
765
+ const out = [];
766
+ const stack = [{
767
+ id: root.nodeId,
768
+ depth: 0
769
+ }];
770
+ while (stack.length && out.length < limit) {
771
+ const popped = stack.pop();
772
+ if (!popped) break;
773
+ const { id, depth } = popped;
774
+ const n = byId.get(id);
775
+ if (!n) continue;
776
+ const role = axValue(n.role);
777
+ const name = axValue(n.name);
778
+ const value = axValue(n.value);
779
+ const description = axValue(n.description);
780
+ const ref = `ax${out.length + 1}`;
781
+ out.push({
782
+ ref,
783
+ role: role || "unknown",
784
+ name: name || "",
785
+ ...value ? { value } : {},
786
+ ...description ? { description } : {},
787
+ ...typeof n.backendDOMNodeId === "number" ? { backendDOMNodeId: n.backendDOMNodeId } : {},
788
+ depth
789
+ });
790
+ const children = (n.childIds ?? []).filter((c) => byId.has(c));
791
+ for (let i = children.length - 1; i >= 0; i--) {
792
+ const child = children[i];
793
+ if (child) stack.push({
794
+ id: child,
795
+ depth: depth + 1
796
+ });
797
+ }
798
+ }
799
+ return out;
800
+ }
801
+ async function snapshotAria(opts) {
802
+ const limit = Math.max(1, Math.min(2e3, Math.floor(opts.limit ?? 500)));
803
+ return await withCdpSocket(opts.wsUrl, async (send) => {
804
+ await send("Accessibility.enable").catch(() => {});
805
+ const res = await send("Accessibility.getFullAXTree");
806
+ return { nodes: formatAriaSnapshot(Array.isArray(res?.nodes) ? res.nodes : [], limit) };
807
+ });
808
+ }
809
+
810
+ //#endregion
811
+ //#region src/browser/chrome.executables.ts
812
+ const CHROMIUM_BUNDLE_IDS = new Set([
813
+ "com.google.Chrome",
814
+ "com.google.Chrome.beta",
815
+ "com.google.Chrome.canary",
816
+ "com.google.Chrome.dev",
817
+ "com.brave.Browser",
818
+ "com.brave.Browser.beta",
819
+ "com.brave.Browser.nightly",
820
+ "com.microsoft.Edge",
821
+ "com.microsoft.EdgeBeta",
822
+ "com.microsoft.EdgeDev",
823
+ "com.microsoft.EdgeCanary",
824
+ "org.chromium.Chromium",
825
+ "com.vivaldi.Vivaldi",
826
+ "com.operasoftware.Opera",
827
+ "com.operasoftware.OperaGX",
828
+ "com.yandex.desktop.yandex-browser",
829
+ "company.thebrowser.Browser"
830
+ ]);
831
+ const CHROMIUM_DESKTOP_IDS = new Set([
832
+ "google-chrome.desktop",
833
+ "google-chrome-beta.desktop",
834
+ "google-chrome-unstable.desktop",
835
+ "brave-browser.desktop",
836
+ "microsoft-edge.desktop",
837
+ "microsoft-edge-beta.desktop",
838
+ "microsoft-edge-dev.desktop",
839
+ "microsoft-edge-canary.desktop",
840
+ "chromium.desktop",
841
+ "chromium-browser.desktop",
842
+ "vivaldi.desktop",
843
+ "vivaldi-stable.desktop",
844
+ "opera.desktop",
845
+ "opera-gx.desktop",
846
+ "yandex-browser.desktop",
847
+ "org.chromium.Chromium.desktop"
848
+ ]);
849
+ const CHROMIUM_EXE_NAMES = new Set([
850
+ "chrome.exe",
851
+ "msedge.exe",
852
+ "brave.exe",
853
+ "brave-browser.exe",
854
+ "chromium.exe",
855
+ "vivaldi.exe",
856
+ "opera.exe",
857
+ "launcher.exe",
858
+ "yandex.exe",
859
+ "yandexbrowser.exe",
860
+ "google chrome",
861
+ "google chrome canary",
862
+ "brave browser",
863
+ "microsoft edge",
864
+ "chromium",
865
+ "chrome",
866
+ "brave",
867
+ "msedge",
868
+ "brave-browser",
869
+ "google-chrome",
870
+ "google-chrome-stable",
871
+ "google-chrome-beta",
872
+ "google-chrome-unstable",
873
+ "microsoft-edge",
874
+ "microsoft-edge-beta",
875
+ "microsoft-edge-dev",
876
+ "microsoft-edge-canary",
877
+ "chromium-browser",
878
+ "vivaldi",
879
+ "vivaldi-stable",
880
+ "opera",
881
+ "opera-stable",
882
+ "opera-gx",
883
+ "yandex-browser"
884
+ ]);
885
+ function exists$1(filePath) {
886
+ try {
887
+ return fs.existsSync(filePath);
888
+ } catch {
889
+ return false;
890
+ }
891
+ }
892
+ function execText(command, args, timeoutMs = 1200, maxBuffer = 1024 * 1024) {
893
+ try {
894
+ const output = execFileSync(command, args, {
895
+ timeout: timeoutMs,
896
+ encoding: "utf8",
897
+ maxBuffer
898
+ });
899
+ return String(output ?? "").trim() || null;
900
+ } catch {
901
+ return null;
902
+ }
903
+ }
904
+ function inferKindFromIdentifier(identifier) {
905
+ const id = identifier.toLowerCase();
906
+ if (id.includes("brave")) return "brave";
907
+ if (id.includes("edge")) return "edge";
908
+ if (id.includes("chromium")) return "chromium";
909
+ if (id.includes("canary")) return "canary";
910
+ if (id.includes("opera") || id.includes("vivaldi") || id.includes("yandex") || id.includes("thebrowser")) return "chromium";
911
+ return "chrome";
912
+ }
913
+ function inferKindFromExecutableName(name) {
914
+ const lower = name.toLowerCase();
915
+ if (lower.includes("brave")) return "brave";
916
+ if (lower.includes("edge") || lower.includes("msedge")) return "edge";
917
+ if (lower.includes("chromium")) return "chromium";
918
+ if (lower.includes("canary") || lower.includes("sxs")) return "canary";
919
+ if (lower.includes("opera") || lower.includes("vivaldi") || lower.includes("yandex")) return "chromium";
920
+ return "chrome";
921
+ }
922
+ function detectDefaultChromiumExecutable(platform) {
923
+ if (platform === "darwin") return detectDefaultChromiumExecutableMac();
924
+ if (platform === "linux") return detectDefaultChromiumExecutableLinux();
925
+ if (platform === "win32") return detectDefaultChromiumExecutableWindows();
926
+ return null;
927
+ }
928
+ function detectDefaultChromiumExecutableMac() {
929
+ const bundleId = detectDefaultBrowserBundleIdMac();
930
+ if (!bundleId || !CHROMIUM_BUNDLE_IDS.has(bundleId)) return null;
931
+ const appPathRaw = execText("/usr/bin/osascript", ["-e", `POSIX path of (path to application id "${bundleId}")`]);
932
+ if (!appPathRaw) return null;
933
+ const appPath = appPathRaw.trim().replace(/\/$/, "");
934
+ const exeName = execText("/usr/bin/defaults", [
935
+ "read",
936
+ path.join(appPath, "Contents", "Info"),
937
+ "CFBundleExecutable"
938
+ ]);
939
+ if (!exeName) return null;
940
+ const exePath = path.join(appPath, "Contents", "MacOS", exeName.trim());
941
+ if (!exists$1(exePath)) return null;
942
+ return {
943
+ kind: inferKindFromIdentifier(bundleId),
944
+ path: exePath
945
+ };
946
+ }
947
+ function detectDefaultBrowserBundleIdMac() {
948
+ const plistPath = path.join(os.homedir(), "Library/Preferences/com.apple.LaunchServices/com.apple.launchservices.secure.plist");
949
+ if (!exists$1(plistPath)) return null;
950
+ const handlersRaw = execText("/usr/bin/plutil", [
951
+ "-extract",
952
+ "LSHandlers",
953
+ "json",
954
+ "-o",
955
+ "-",
956
+ "--",
957
+ plistPath
958
+ ], 2e3, 5 * 1024 * 1024);
959
+ if (!handlersRaw) return null;
960
+ let handlers;
961
+ try {
962
+ handlers = JSON.parse(handlersRaw);
963
+ } catch {
964
+ return null;
965
+ }
966
+ if (!Array.isArray(handlers)) return null;
967
+ const resolveScheme = (scheme) => {
968
+ let candidate = null;
969
+ for (const entry of handlers) {
970
+ if (!entry || typeof entry !== "object") continue;
971
+ const record = entry;
972
+ if (record.LSHandlerURLScheme !== scheme) continue;
973
+ const role = typeof record.LSHandlerRoleAll === "string" && record.LSHandlerRoleAll || typeof record.LSHandlerRoleViewer === "string" && record.LSHandlerRoleViewer || null;
974
+ if (role) candidate = role;
975
+ }
976
+ return candidate;
977
+ };
978
+ return resolveScheme("http") ?? resolveScheme("https");
979
+ }
980
+ function detectDefaultChromiumExecutableLinux() {
981
+ const desktopId = execText("xdg-settings", ["get", "default-web-browser"]) || execText("xdg-mime", [
982
+ "query",
983
+ "default",
984
+ "x-scheme-handler/http"
985
+ ]);
986
+ if (!desktopId) return null;
987
+ const trimmed = desktopId.trim();
988
+ if (!CHROMIUM_DESKTOP_IDS.has(trimmed)) return null;
989
+ const desktopPath = findDesktopFilePath(trimmed);
990
+ if (!desktopPath) return null;
991
+ const execLine = readDesktopExecLine(desktopPath);
992
+ if (!execLine) return null;
993
+ const command = extractExecutableFromExecLine(execLine);
994
+ if (!command) return null;
995
+ const resolved = resolveLinuxExecutablePath(command);
996
+ if (!resolved) return null;
997
+ const exeName = path.posix.basename(resolved).toLowerCase();
998
+ if (!CHROMIUM_EXE_NAMES.has(exeName)) return null;
999
+ return {
1000
+ kind: inferKindFromExecutableName(exeName),
1001
+ path: resolved
1002
+ };
1003
+ }
1004
+ function detectDefaultChromiumExecutableWindows() {
1005
+ const progId = readWindowsProgId();
1006
+ const command = (progId ? readWindowsCommandForProgId(progId) : null) || readWindowsCommandForProgId("http");
1007
+ if (!command) return null;
1008
+ const exePath = extractWindowsExecutablePath(expandWindowsEnvVars(command));
1009
+ if (!exePath) return null;
1010
+ if (!exists$1(exePath)) return null;
1011
+ const exeName = path.win32.basename(exePath).toLowerCase();
1012
+ if (!CHROMIUM_EXE_NAMES.has(exeName)) return null;
1013
+ return {
1014
+ kind: inferKindFromExecutableName(exeName),
1015
+ path: exePath
1016
+ };
1017
+ }
1018
+ function findDesktopFilePath(desktopId) {
1019
+ const candidates = [
1020
+ path.join(os.homedir(), ".local", "share", "applications", desktopId),
1021
+ path.join("/usr/local/share/applications", desktopId),
1022
+ path.join("/usr/share/applications", desktopId),
1023
+ path.join("/var/lib/snapd/desktop/applications", desktopId)
1024
+ ];
1025
+ for (const candidate of candidates) if (exists$1(candidate)) return candidate;
1026
+ return null;
1027
+ }
1028
+ function readDesktopExecLine(desktopPath) {
1029
+ try {
1030
+ const lines = fs.readFileSync(desktopPath, "utf8").split(/\r?\n/);
1031
+ for (const line of lines) if (line.startsWith("Exec=")) return line.slice(5).trim();
1032
+ } catch {}
1033
+ return null;
1034
+ }
1035
+ function extractExecutableFromExecLine(execLine) {
1036
+ const tokens = splitExecLine(execLine);
1037
+ for (const token of tokens) {
1038
+ if (!token) continue;
1039
+ if (token === "env") continue;
1040
+ if (token.includes("=") && !token.startsWith("/") && !token.includes("\\")) continue;
1041
+ return token.replace(/^["']|["']$/g, "");
1042
+ }
1043
+ return null;
1044
+ }
1045
+ function splitExecLine(line) {
1046
+ const tokens = [];
1047
+ let current = "";
1048
+ let inQuotes = false;
1049
+ let quoteChar = "";
1050
+ for (let i = 0; i < line.length; i += 1) {
1051
+ const ch = line[i];
1052
+ if ((ch === "\"" || ch === "'") && (!inQuotes || ch === quoteChar)) {
1053
+ if (inQuotes) {
1054
+ inQuotes = false;
1055
+ quoteChar = "";
1056
+ } else {
1057
+ inQuotes = true;
1058
+ quoteChar = ch;
1059
+ }
1060
+ continue;
1061
+ }
1062
+ if (!inQuotes && /\s/.test(ch)) {
1063
+ if (current) {
1064
+ tokens.push(current);
1065
+ current = "";
1066
+ }
1067
+ continue;
1068
+ }
1069
+ current += ch;
1070
+ }
1071
+ if (current) tokens.push(current);
1072
+ return tokens;
1073
+ }
1074
+ function resolveLinuxExecutablePath(command) {
1075
+ const cleaned = command.trim().replace(/%[a-zA-Z]/g, "");
1076
+ if (!cleaned) return null;
1077
+ if (cleaned.startsWith("/")) return cleaned;
1078
+ const resolved = execText("which", [cleaned], 800);
1079
+ return resolved ? resolved.trim() : null;
1080
+ }
1081
+ function readWindowsProgId() {
1082
+ const output = execText("reg", [
1083
+ "query",
1084
+ "HKCU\\Software\\Microsoft\\Windows\\Shell\\Associations\\UrlAssociations\\http\\UserChoice",
1085
+ "/v",
1086
+ "ProgId"
1087
+ ]);
1088
+ if (!output) return null;
1089
+ return output.match(/ProgId\s+REG_\w+\s+(.+)$/im)?.[1]?.trim() || null;
1090
+ }
1091
+ function readWindowsCommandForProgId(progId) {
1092
+ const output = execText("reg", [
1093
+ "query",
1094
+ progId === "http" ? "HKCR\\http\\shell\\open\\command" : `HKCR\\${progId}\\shell\\open\\command`,
1095
+ "/ve"
1096
+ ]);
1097
+ if (!output) return null;
1098
+ return output.match(/REG_\w+\s+(.+)$/im)?.[1]?.trim() || null;
1099
+ }
1100
+ function expandWindowsEnvVars(value) {
1101
+ return value.replace(/%([^%]+)%/g, (_match, name) => {
1102
+ const key = String(name ?? "").trim();
1103
+ return key ? process.env[key] ?? `%${key}%` : _match;
1104
+ });
1105
+ }
1106
+ function extractWindowsExecutablePath(command) {
1107
+ const quoted = command.match(/"([^"]+\\.exe)"/i);
1108
+ if (quoted?.[1]) return quoted[1];
1109
+ const unquoted = command.match(/([^\\s]+\\.exe)/i);
1110
+ if (unquoted?.[1]) return unquoted[1];
1111
+ return null;
1112
+ }
1113
+ function findFirstExecutable(candidates) {
1114
+ for (const candidate of candidates) if (exists$1(candidate.path)) return candidate;
1115
+ return null;
1116
+ }
1117
+ function findChromeExecutableMac() {
1118
+ return findFirstExecutable([
1119
+ {
1120
+ kind: "chrome",
1121
+ path: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
1122
+ },
1123
+ {
1124
+ kind: "chrome",
1125
+ path: path.join(os.homedir(), "Applications/Google Chrome.app/Contents/MacOS/Google Chrome")
1126
+ },
1127
+ {
1128
+ kind: "brave",
1129
+ path: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
1130
+ },
1131
+ {
1132
+ kind: "brave",
1133
+ path: path.join(os.homedir(), "Applications/Brave Browser.app/Contents/MacOS/Brave Browser")
1134
+ },
1135
+ {
1136
+ kind: "edge",
1137
+ path: "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge"
1138
+ },
1139
+ {
1140
+ kind: "edge",
1141
+ path: path.join(os.homedir(), "Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge")
1142
+ },
1143
+ {
1144
+ kind: "chromium",
1145
+ path: "/Applications/Chromium.app/Contents/MacOS/Chromium"
1146
+ },
1147
+ {
1148
+ kind: "chromium",
1149
+ path: path.join(os.homedir(), "Applications/Chromium.app/Contents/MacOS/Chromium")
1150
+ },
1151
+ {
1152
+ kind: "canary",
1153
+ path: "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary"
1154
+ },
1155
+ {
1156
+ kind: "canary",
1157
+ path: path.join(os.homedir(), "Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary")
1158
+ }
1159
+ ]);
1160
+ }
1161
+ function findChromeExecutableLinux() {
1162
+ return findFirstExecutable([
1163
+ {
1164
+ kind: "chrome",
1165
+ path: "/usr/bin/google-chrome"
1166
+ },
1167
+ {
1168
+ kind: "chrome",
1169
+ path: "/usr/bin/google-chrome-stable"
1170
+ },
1171
+ {
1172
+ kind: "chrome",
1173
+ path: "/usr/bin/chrome"
1174
+ },
1175
+ {
1176
+ kind: "brave",
1177
+ path: "/usr/bin/brave-browser"
1178
+ },
1179
+ {
1180
+ kind: "brave",
1181
+ path: "/usr/bin/brave-browser-stable"
1182
+ },
1183
+ {
1184
+ kind: "brave",
1185
+ path: "/usr/bin/brave"
1186
+ },
1187
+ {
1188
+ kind: "brave",
1189
+ path: "/snap/bin/brave"
1190
+ },
1191
+ {
1192
+ kind: "edge",
1193
+ path: "/usr/bin/microsoft-edge"
1194
+ },
1195
+ {
1196
+ kind: "edge",
1197
+ path: "/usr/bin/microsoft-edge-stable"
1198
+ },
1199
+ {
1200
+ kind: "chromium",
1201
+ path: "/usr/bin/chromium"
1202
+ },
1203
+ {
1204
+ kind: "chromium",
1205
+ path: "/usr/bin/chromium-browser"
1206
+ },
1207
+ {
1208
+ kind: "chromium",
1209
+ path: "/snap/bin/chromium"
1210
+ }
1211
+ ]);
1212
+ }
1213
+ function findChromeExecutableWindows() {
1214
+ const localAppData = process.env.LOCALAPPDATA ?? "";
1215
+ const programFiles = process.env.ProgramFiles ?? "C:\\Program Files";
1216
+ const programFilesX86 = process.env["ProgramFiles(x86)"] ?? "C:\\Program Files (x86)";
1217
+ const joinWin = path.win32.join;
1218
+ const candidates = [];
1219
+ if (localAppData) {
1220
+ candidates.push({
1221
+ kind: "chrome",
1222
+ path: joinWin(localAppData, "Google", "Chrome", "Application", "chrome.exe")
1223
+ });
1224
+ candidates.push({
1225
+ kind: "brave",
1226
+ path: joinWin(localAppData, "BraveSoftware", "Brave-Browser", "Application", "brave.exe")
1227
+ });
1228
+ candidates.push({
1229
+ kind: "edge",
1230
+ path: joinWin(localAppData, "Microsoft", "Edge", "Application", "msedge.exe")
1231
+ });
1232
+ candidates.push({
1233
+ kind: "chromium",
1234
+ path: joinWin(localAppData, "Chromium", "Application", "chrome.exe")
1235
+ });
1236
+ candidates.push({
1237
+ kind: "canary",
1238
+ path: joinWin(localAppData, "Google", "Chrome SxS", "Application", "chrome.exe")
1239
+ });
1240
+ }
1241
+ candidates.push({
1242
+ kind: "chrome",
1243
+ path: joinWin(programFiles, "Google", "Chrome", "Application", "chrome.exe")
1244
+ });
1245
+ candidates.push({
1246
+ kind: "chrome",
1247
+ path: joinWin(programFilesX86, "Google", "Chrome", "Application", "chrome.exe")
1248
+ });
1249
+ candidates.push({
1250
+ kind: "brave",
1251
+ path: joinWin(programFiles, "BraveSoftware", "Brave-Browser", "Application", "brave.exe")
1252
+ });
1253
+ candidates.push({
1254
+ kind: "brave",
1255
+ path: joinWin(programFilesX86, "BraveSoftware", "Brave-Browser", "Application", "brave.exe")
1256
+ });
1257
+ candidates.push({
1258
+ kind: "edge",
1259
+ path: joinWin(programFiles, "Microsoft", "Edge", "Application", "msedge.exe")
1260
+ });
1261
+ candidates.push({
1262
+ kind: "edge",
1263
+ path: joinWin(programFilesX86, "Microsoft", "Edge", "Application", "msedge.exe")
1264
+ });
1265
+ return findFirstExecutable(candidates);
1266
+ }
1267
+ function resolveBrowserExecutableForPlatform(resolved, platform) {
1268
+ if (resolved.executablePath) {
1269
+ if (!exists$1(resolved.executablePath)) throw new Error(`browser.executablePath not found: ${resolved.executablePath}`);
1270
+ return {
1271
+ kind: "custom",
1272
+ path: resolved.executablePath
1273
+ };
1274
+ }
1275
+ const detected = detectDefaultChromiumExecutable(platform);
1276
+ if (detected) return detected;
1277
+ if (platform === "darwin") return findChromeExecutableMac();
1278
+ if (platform === "linux") return findChromeExecutableLinux();
1279
+ if (platform === "win32") return findChromeExecutableWindows();
1280
+ return null;
1281
+ }
1282
+
1283
+ //#endregion
1284
+ //#region src/infra/ports-format.ts
1285
+ function classifyPortListener(listener, port) {
1286
+ const raw = `${listener.commandLine ?? ""} ${listener.command ?? ""}`.trim().toLowerCase();
1287
+ if (raw.includes("openclaw")) return "gateway";
1288
+ if (raw.includes("ssh")) {
1289
+ const portToken = String(port);
1290
+ const tunnelPattern = new RegExp(`-(l|r)\\s*${portToken}\\b|-(l|r)${portToken}\\b|:${portToken}\\b`);
1291
+ if (!raw || tunnelPattern.test(raw)) return "ssh";
1292
+ return "ssh";
1293
+ }
1294
+ return "unknown";
1295
+ }
1296
+ function buildPortHints(listeners, port) {
1297
+ if (listeners.length === 0) return [];
1298
+ const kinds = new Set(listeners.map((listener) => classifyPortListener(listener, port)));
1299
+ const hints = [];
1300
+ if (kinds.has("gateway")) hints.push(`Gateway already running locally. Stop it (${formatCliCommand("openclaw gateway stop")}) or use a different port.`);
1301
+ if (kinds.has("ssh")) hints.push("SSH tunnel already bound to this port. Close the tunnel or use a different local port in -L.");
1302
+ if (kinds.has("unknown")) hints.push("Another process is listening on this port.");
1303
+ if (listeners.length > 1) hints.push("Multiple listeners detected; ensure only one gateway/tunnel per port unless intentionally running isolated profiles.");
1304
+ return hints;
1305
+ }
1306
+ function formatPortListener(listener) {
1307
+ return `${listener.pid ? `pid ${listener.pid}` : "pid ?"}${listener.user ? ` ${listener.user}` : ""}: ${listener.commandLine || listener.command || "unknown"}${listener.address ? ` (${listener.address})` : ""}`;
1308
+ }
1309
+ function formatPortDiagnostics(diagnostics) {
1310
+ if (diagnostics.status !== "busy") return [`Port ${diagnostics.port} is free.`];
1311
+ const lines = [`Port ${diagnostics.port} is already in use.`];
1312
+ for (const listener of diagnostics.listeners) lines.push(`- ${formatPortListener(listener)}`);
1313
+ for (const hint of diagnostics.hints) lines.push(`- ${hint}`);
1314
+ return lines;
1315
+ }
1316
+
1317
+ //#endregion
1318
+ //#region src/infra/ports-lsof.ts
1319
+ const LSOF_CANDIDATES = process.platform === "darwin" ? ["/usr/sbin/lsof", "/usr/bin/lsof"] : ["/usr/bin/lsof", "/usr/sbin/lsof"];
1320
+ async function canExecute(path) {
1321
+ try {
1322
+ await fs$1.access(path, fs.constants.X_OK);
1323
+ return true;
1324
+ } catch {
1325
+ return false;
1326
+ }
1327
+ }
1328
+ async function resolveLsofCommand() {
1329
+ for (const candidate of LSOF_CANDIDATES) if (await canExecute(candidate)) return candidate;
1330
+ return "lsof";
1331
+ }
1332
+ function resolveLsofCommandSync() {
1333
+ for (const candidate of LSOF_CANDIDATES) try {
1334
+ fs.accessSync(candidate, fs.constants.X_OK);
1335
+ return candidate;
1336
+ } catch {}
1337
+ return "lsof";
1338
+ }
1339
+
1340
+ //#endregion
1341
+ //#region src/infra/ports-inspect.ts
1342
+ function isErrno$1(err) {
1343
+ return Boolean(err && typeof err === "object" && "code" in err);
1344
+ }
1345
+ async function runCommandSafe(argv, timeoutMs = 5e3) {
1346
+ try {
1347
+ const res = await runCommandWithTimeout(argv, { timeoutMs });
1348
+ return {
1349
+ stdout: res.stdout,
1350
+ stderr: res.stderr,
1351
+ code: res.code ?? 1
1352
+ };
1353
+ } catch (err) {
1354
+ return {
1355
+ stdout: "",
1356
+ stderr: "",
1357
+ code: 1,
1358
+ error: String(err)
1359
+ };
1360
+ }
1361
+ }
1362
+ function parseLsofFieldOutput(output) {
1363
+ const lines = output.split(/\r?\n/).filter(Boolean);
1364
+ const listeners = [];
1365
+ let current = {};
1366
+ for (const line of lines) if (line.startsWith("p")) {
1367
+ if (current.pid || current.command) listeners.push(current);
1368
+ const pid = Number.parseInt(line.slice(1), 10);
1369
+ current = Number.isFinite(pid) ? { pid } : {};
1370
+ } else if (line.startsWith("c")) current.command = line.slice(1);
1371
+ else if (line.startsWith("n")) {
1372
+ if (!current.address) current.address = line.slice(1);
1373
+ }
1374
+ if (current.pid || current.command) listeners.push(current);
1375
+ return listeners;
1376
+ }
1377
+ async function resolveUnixCommandLine(pid) {
1378
+ const res = await runCommandSafe([
1379
+ "ps",
1380
+ "-p",
1381
+ String(pid),
1382
+ "-o",
1383
+ "command="
1384
+ ]);
1385
+ if (res.code !== 0) return;
1386
+ return res.stdout.trim() || void 0;
1387
+ }
1388
+ async function resolveUnixUser(pid) {
1389
+ const res = await runCommandSafe([
1390
+ "ps",
1391
+ "-p",
1392
+ String(pid),
1393
+ "-o",
1394
+ "user="
1395
+ ]);
1396
+ if (res.code !== 0) return;
1397
+ return res.stdout.trim() || void 0;
1398
+ }
1399
+ async function readUnixListeners(port) {
1400
+ const errors = [];
1401
+ const res = await runCommandSafe([
1402
+ await resolveLsofCommand(),
1403
+ "-nP",
1404
+ `-iTCP:${port}`,
1405
+ "-sTCP:LISTEN",
1406
+ "-FpFcn"
1407
+ ]);
1408
+ if (res.code === 0) {
1409
+ const listeners = parseLsofFieldOutput(res.stdout);
1410
+ await Promise.all(listeners.map(async (listener) => {
1411
+ if (!listener.pid) return;
1412
+ const [commandLine, user] = await Promise.all([resolveUnixCommandLine(listener.pid), resolveUnixUser(listener.pid)]);
1413
+ if (commandLine) listener.commandLine = commandLine;
1414
+ if (user) listener.user = user;
1415
+ }));
1416
+ return {
1417
+ listeners,
1418
+ detail: res.stdout.trim() || void 0,
1419
+ errors
1420
+ };
1421
+ }
1422
+ const stderr = res.stderr.trim();
1423
+ if (res.code === 1 && !res.error && !stderr) return {
1424
+ listeners: [],
1425
+ detail: void 0,
1426
+ errors
1427
+ };
1428
+ if (res.error) errors.push(res.error);
1429
+ const detail = [stderr, res.stdout.trim()].filter(Boolean).join("\n");
1430
+ if (detail) errors.push(detail);
1431
+ return {
1432
+ listeners: [],
1433
+ detail: void 0,
1434
+ errors
1435
+ };
1436
+ }
1437
+ function parseNetstatListeners(output, port) {
1438
+ const listeners = [];
1439
+ const portToken = `:${port}`;
1440
+ for (const rawLine of output.split(/\r?\n/)) {
1441
+ const line = rawLine.trim();
1442
+ if (!line) continue;
1443
+ if (!line.toLowerCase().includes("listen")) continue;
1444
+ if (!line.includes(portToken)) continue;
1445
+ const parts = line.split(/\s+/);
1446
+ if (parts.length < 4) continue;
1447
+ const pidRaw = parts.at(-1);
1448
+ const pid = pidRaw ? Number.parseInt(pidRaw, 10) : NaN;
1449
+ const localAddr = parts[1];
1450
+ const listener = {};
1451
+ if (Number.isFinite(pid)) listener.pid = pid;
1452
+ if (localAddr?.includes(portToken)) listener.address = localAddr;
1453
+ listeners.push(listener);
1454
+ }
1455
+ return listeners;
1456
+ }
1457
+ async function resolveWindowsImageName(pid) {
1458
+ const res = await runCommandSafe([
1459
+ "tasklist",
1460
+ "/FI",
1461
+ `PID eq ${pid}`,
1462
+ "/FO",
1463
+ "LIST"
1464
+ ]);
1465
+ if (res.code !== 0) return;
1466
+ for (const rawLine of res.stdout.split(/\r?\n/)) {
1467
+ const line = rawLine.trim();
1468
+ if (!line.toLowerCase().startsWith("image name:")) continue;
1469
+ return line.slice(11).trim() || void 0;
1470
+ }
1471
+ }
1472
+ async function resolveWindowsCommandLine(pid) {
1473
+ const res = await runCommandSafe([
1474
+ "wmic",
1475
+ "process",
1476
+ "where",
1477
+ `ProcessId=${pid}`,
1478
+ "get",
1479
+ "CommandLine",
1480
+ "/value"
1481
+ ]);
1482
+ if (res.code !== 0) return;
1483
+ for (const rawLine of res.stdout.split(/\r?\n/)) {
1484
+ const line = rawLine.trim();
1485
+ if (!line.toLowerCase().startsWith("commandline=")) continue;
1486
+ return line.slice(12).trim() || void 0;
1487
+ }
1488
+ }
1489
+ async function readWindowsListeners(port) {
1490
+ const errors = [];
1491
+ const res = await runCommandSafe([
1492
+ "netstat",
1493
+ "-ano",
1494
+ "-p",
1495
+ "tcp"
1496
+ ]);
1497
+ if (res.code !== 0) {
1498
+ if (res.error) errors.push(res.error);
1499
+ const detail = [res.stderr.trim(), res.stdout.trim()].filter(Boolean).join("\n");
1500
+ if (detail) errors.push(detail);
1501
+ return {
1502
+ listeners: [],
1503
+ errors
1504
+ };
1505
+ }
1506
+ const listeners = parseNetstatListeners(res.stdout, port);
1507
+ await Promise.all(listeners.map(async (listener) => {
1508
+ if (!listener.pid) return;
1509
+ const [imageName, commandLine] = await Promise.all([resolveWindowsImageName(listener.pid), resolveWindowsCommandLine(listener.pid)]);
1510
+ if (imageName) listener.command = imageName;
1511
+ if (commandLine) listener.commandLine = commandLine;
1512
+ }));
1513
+ return {
1514
+ listeners,
1515
+ detail: res.stdout.trim() || void 0,
1516
+ errors
1517
+ };
1518
+ }
1519
+ async function tryListenOnHost(port, host) {
1520
+ try {
1521
+ await new Promise((resolve, reject) => {
1522
+ const tester = net.createServer().once("error", (err) => reject(err)).once("listening", () => {
1523
+ tester.close(() => resolve());
1524
+ }).listen({
1525
+ port,
1526
+ host,
1527
+ exclusive: true
1528
+ });
1529
+ });
1530
+ return "free";
1531
+ } catch (err) {
1532
+ if (isErrno$1(err) && err.code === "EADDRINUSE") return "busy";
1533
+ if (isErrno$1(err) && (err.code === "EADDRNOTAVAIL" || err.code === "EAFNOSUPPORT")) return "skip";
1534
+ return "unknown";
1535
+ }
1536
+ }
1537
+ async function checkPortInUse(port) {
1538
+ const hosts = [
1539
+ "127.0.0.1",
1540
+ "0.0.0.0",
1541
+ "::1",
1542
+ "::"
1543
+ ];
1544
+ let sawUnknown = false;
1545
+ for (const host of hosts) {
1546
+ const result = await tryListenOnHost(port, host);
1547
+ if (result === "busy") return "busy";
1548
+ if (result === "unknown") sawUnknown = true;
1549
+ }
1550
+ return sawUnknown ? "unknown" : "free";
1551
+ }
1552
+ async function inspectPortUsage(port) {
1553
+ const errors = [];
1554
+ const result = process.platform === "win32" ? await readWindowsListeners(port) : await readUnixListeners(port);
1555
+ errors.push(...result.errors);
1556
+ let listeners = result.listeners;
1557
+ let status = listeners.length > 0 ? "busy" : "unknown";
1558
+ if (listeners.length === 0) status = await checkPortInUse(port);
1559
+ if (status !== "busy") listeners = [];
1560
+ const hints = buildPortHints(listeners, port);
1561
+ if (status === "busy" && listeners.length === 0) hints.push("Port is in use but process details are unavailable (install lsof or run as an admin user).");
1562
+ return {
1563
+ port,
1564
+ status,
1565
+ listeners,
1566
+ hints,
1567
+ detail: result.detail,
1568
+ errors: errors.length > 0 ? errors : void 0
1569
+ };
1570
+ }
1571
+
1572
+ //#endregion
1573
+ //#region src/infra/ports.ts
1574
+ var PortInUseError = class extends Error {
1575
+ constructor(port, details) {
1576
+ super(`Port ${port} is already in use.`);
1577
+ this.name = "PortInUseError";
1578
+ this.port = port;
1579
+ this.details = details;
1580
+ }
1581
+ };
1582
+ function isErrno(err) {
1583
+ return Boolean(err && typeof err === "object" && "code" in err);
1584
+ }
1585
+ async function describePortOwner(port) {
1586
+ const diagnostics = await inspectPortUsage(port);
1587
+ if (diagnostics.listeners.length === 0) return;
1588
+ return formatPortDiagnostics(diagnostics).join("\n");
1589
+ }
1590
+ async function ensurePortAvailable(port) {
1591
+ try {
1592
+ await new Promise((resolve, reject) => {
1593
+ const tester = net.createServer().once("error", (err) => reject(err)).once("listening", () => {
1594
+ tester.close(() => resolve());
1595
+ }).listen(port);
1596
+ });
1597
+ } catch (err) {
1598
+ if (isErrno(err) && err.code === "EADDRINUSE") throw new PortInUseError(port, await describePortOwner(port));
1599
+ throw err;
1600
+ }
1601
+ }
1602
+ async function handlePortError(err, port, context, runtime = defaultRuntime) {
1603
+ if (err instanceof PortInUseError || isErrno(err) && err.code === "EADDRINUSE") {
1604
+ const details = err instanceof PortInUseError ? err.details : await describePortOwner(port);
1605
+ runtime.error(danger(`${context} failed: port ${port} is already in use.`));
1606
+ if (details) {
1607
+ runtime.error(info("Port listener details:"));
1608
+ runtime.error(details);
1609
+ if (/openclaw|src\/index\.ts|dist\/index\.js/.test(details)) runtime.error(warn("It looks like another OpenClaw instance is already running. Stop it or pick a different port."));
1610
+ }
1611
+ runtime.error(info("Resolve by stopping the process using the port or passing --port <free-port>."));
1612
+ runtime.exit(1);
1613
+ }
1614
+ runtime.error(danger(`${context} failed: ${String(err)}`));
1615
+ if (shouldLogVerbose()) {
1616
+ const stdout = err?.stdout;
1617
+ const stderr = err?.stderr;
1618
+ if (stdout?.trim()) logDebug(`stdout: ${stdout.trim()}`);
1619
+ if (stderr?.trim()) logDebug(`stderr: ${stderr.trim()}`);
1620
+ }
1621
+ return runtime.exit(1);
1622
+ }
1623
+
1624
+ //#endregion
1625
+ //#region src/browser/chrome.profile-decoration.ts
1626
+ function decoratedMarkerPath(userDataDir) {
1627
+ return path.join(userDataDir, ".openclaw-profile-decorated");
1628
+ }
1629
+ function safeReadJson(filePath) {
1630
+ try {
1631
+ if (!fs.existsSync(filePath)) return null;
1632
+ const raw = fs.readFileSync(filePath, "utf-8");
1633
+ const parsed = JSON.parse(raw);
1634
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return null;
1635
+ return parsed;
1636
+ } catch {
1637
+ return null;
1638
+ }
1639
+ }
1640
+ function safeWriteJson(filePath, data) {
1641
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
1642
+ fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
1643
+ }
1644
+ function setDeep(obj, keys, value) {
1645
+ let node = obj;
1646
+ for (const key of keys.slice(0, -1)) {
1647
+ const next = node[key];
1648
+ if (typeof next !== "object" || next === null || Array.isArray(next)) node[key] = {};
1649
+ node = node[key];
1650
+ }
1651
+ node[keys[keys.length - 1] ?? ""] = value;
1652
+ }
1653
+ function parseHexRgbToSignedArgbInt(hex) {
1654
+ const cleaned = hex.trim().replace(/^#/, "");
1655
+ if (!/^[0-9a-fA-F]{6}$/.test(cleaned)) return null;
1656
+ const argbUnsigned = 255 << 24 | Number.parseInt(cleaned, 16);
1657
+ return argbUnsigned > 2147483647 ? argbUnsigned - 4294967296 : argbUnsigned;
1658
+ }
1659
+ function isProfileDecorated(userDataDir, desiredName, desiredColorHex) {
1660
+ const desiredColorInt = parseHexRgbToSignedArgbInt(desiredColorHex);
1661
+ const localStatePath = path.join(userDataDir, "Local State");
1662
+ const preferencesPath = path.join(userDataDir, "Default", "Preferences");
1663
+ const profile = safeReadJson(localStatePath)?.profile;
1664
+ const infoCache = typeof profile === "object" && profile !== null && !Array.isArray(profile) ? profile.info_cache : null;
1665
+ const info = typeof infoCache === "object" && infoCache !== null && !Array.isArray(infoCache) && typeof infoCache.Default === "object" && infoCache.Default !== null && !Array.isArray(infoCache.Default) ? infoCache.Default : null;
1666
+ const prefs = safeReadJson(preferencesPath);
1667
+ const browserTheme = (() => {
1668
+ const browser = prefs?.browser;
1669
+ const theme = typeof browser === "object" && browser !== null && !Array.isArray(browser) ? browser.theme : null;
1670
+ return typeof theme === "object" && theme !== null && !Array.isArray(theme) ? theme : null;
1671
+ })();
1672
+ const autogeneratedTheme = (() => {
1673
+ const autogenerated = prefs?.autogenerated;
1674
+ const theme = typeof autogenerated === "object" && autogenerated !== null && !Array.isArray(autogenerated) ? autogenerated.theme : null;
1675
+ return typeof theme === "object" && theme !== null && !Array.isArray(theme) ? theme : null;
1676
+ })();
1677
+ const nameOk = typeof info?.name === "string" ? info.name === desiredName : true;
1678
+ if (desiredColorInt == null) return nameOk;
1679
+ const localSeedOk = typeof info?.profile_color_seed === "number" ? info.profile_color_seed === desiredColorInt : false;
1680
+ const prefOk = typeof browserTheme?.user_color2 === "number" && browserTheme.user_color2 === desiredColorInt || typeof autogeneratedTheme?.color === "number" && autogeneratedTheme.color === desiredColorInt;
1681
+ return nameOk && localSeedOk && prefOk;
1682
+ }
1683
+ /**
1684
+ * Best-effort profile decoration (name + lobster-orange). Chrome preference keys
1685
+ * vary by version; we keep this conservative and idempotent.
1686
+ */
1687
+ function decorateOpenClawProfile(userDataDir, opts) {
1688
+ const desiredName = opts?.name ?? DEFAULT_OPENCLAW_BROWSER_PROFILE_NAME;
1689
+ const desiredColor = (opts?.color ?? DEFAULT_OPENCLAW_BROWSER_COLOR).toUpperCase();
1690
+ const desiredColorInt = parseHexRgbToSignedArgbInt(desiredColor);
1691
+ const localStatePath = path.join(userDataDir, "Local State");
1692
+ const preferencesPath = path.join(userDataDir, "Default", "Preferences");
1693
+ const localState = safeReadJson(localStatePath) ?? {};
1694
+ setDeep(localState, [
1695
+ "profile",
1696
+ "info_cache",
1697
+ "Default",
1698
+ "name"
1699
+ ], desiredName);
1700
+ setDeep(localState, [
1701
+ "profile",
1702
+ "info_cache",
1703
+ "Default",
1704
+ "shortcut_name"
1705
+ ], desiredName);
1706
+ setDeep(localState, [
1707
+ "profile",
1708
+ "info_cache",
1709
+ "Default",
1710
+ "user_name"
1711
+ ], desiredName);
1712
+ setDeep(localState, [
1713
+ "profile",
1714
+ "info_cache",
1715
+ "Default",
1716
+ "profile_color"
1717
+ ], desiredColor);
1718
+ setDeep(localState, [
1719
+ "profile",
1720
+ "info_cache",
1721
+ "Default",
1722
+ "user_color"
1723
+ ], desiredColor);
1724
+ if (desiredColorInt != null) {
1725
+ setDeep(localState, [
1726
+ "profile",
1727
+ "info_cache",
1728
+ "Default",
1729
+ "profile_color_seed"
1730
+ ], desiredColorInt);
1731
+ setDeep(localState, [
1732
+ "profile",
1733
+ "info_cache",
1734
+ "Default",
1735
+ "profile_highlight_color"
1736
+ ], desiredColorInt);
1737
+ setDeep(localState, [
1738
+ "profile",
1739
+ "info_cache",
1740
+ "Default",
1741
+ "default_avatar_fill_color"
1742
+ ], desiredColorInt);
1743
+ setDeep(localState, [
1744
+ "profile",
1745
+ "info_cache",
1746
+ "Default",
1747
+ "default_avatar_stroke_color"
1748
+ ], desiredColorInt);
1749
+ }
1750
+ safeWriteJson(localStatePath, localState);
1751
+ const prefs = safeReadJson(preferencesPath) ?? {};
1752
+ setDeep(prefs, ["profile", "name"], desiredName);
1753
+ setDeep(prefs, ["profile", "profile_color"], desiredColor);
1754
+ setDeep(prefs, ["profile", "user_color"], desiredColor);
1755
+ if (desiredColorInt != null) {
1756
+ setDeep(prefs, [
1757
+ "autogenerated",
1758
+ "theme",
1759
+ "color"
1760
+ ], desiredColorInt);
1761
+ setDeep(prefs, [
1762
+ "browser",
1763
+ "theme",
1764
+ "user_color2"
1765
+ ], desiredColorInt);
1766
+ }
1767
+ safeWriteJson(preferencesPath, prefs);
1768
+ try {
1769
+ fs.writeFileSync(decoratedMarkerPath(userDataDir), `${Date.now()}\n`, "utf-8");
1770
+ } catch {}
1771
+ }
1772
+ function ensureProfileCleanExit(userDataDir) {
1773
+ const preferencesPath = path.join(userDataDir, "Default", "Preferences");
1774
+ const prefs = safeReadJson(preferencesPath) ?? {};
1775
+ setDeep(prefs, ["exit_type"], "Normal");
1776
+ setDeep(prefs, ["exited_cleanly"], true);
1777
+ safeWriteJson(preferencesPath, prefs);
1778
+ }
1779
+
1780
+ //#endregion
1781
+ //#region src/browser/chrome.ts
1782
+ const log = createSubsystemLogger("browser").child("chrome");
1783
+ function exists(filePath) {
1784
+ try {
1785
+ return fs.existsSync(filePath);
1786
+ } catch {
1787
+ return false;
1788
+ }
1789
+ }
1790
+ function resolveBrowserExecutable(resolved) {
1791
+ return resolveBrowserExecutableForPlatform(resolved, process.platform);
1792
+ }
1793
+ function resolveOpenClawUserDataDir(profileName = DEFAULT_OPENCLAW_BROWSER_PROFILE_NAME) {
1794
+ return path.join(CONFIG_DIR, "browser", profileName, "user-data");
1795
+ }
1796
+ function cdpUrlForPort(cdpPort) {
1797
+ return `http://127.0.0.1:${cdpPort}`;
1798
+ }
1799
+ async function isChromeReachable(cdpUrl, timeoutMs = 500) {
1800
+ const version = await fetchChromeVersion(cdpUrl, timeoutMs);
1801
+ return Boolean(version);
1802
+ }
1803
+ async function fetchChromeVersion(cdpUrl, timeoutMs = 500) {
1804
+ const ctrl = new AbortController();
1805
+ const t = setTimeout(() => ctrl.abort(), timeoutMs);
1806
+ try {
1807
+ const versionUrl = appendCdpPath(cdpUrl, "/json/version");
1808
+ const res = await fetch(versionUrl, {
1809
+ signal: ctrl.signal,
1810
+ headers: getHeadersWithAuth(versionUrl)
1811
+ });
1812
+ if (!res.ok) return null;
1813
+ const data = await res.json();
1814
+ if (!data || typeof data !== "object") return null;
1815
+ return data;
1816
+ } catch {
1817
+ return null;
1818
+ } finally {
1819
+ clearTimeout(t);
1820
+ }
1821
+ }
1822
+ async function getChromeWebSocketUrl(cdpUrl, timeoutMs = 500) {
1823
+ const version = await fetchChromeVersion(cdpUrl, timeoutMs);
1824
+ const wsUrl = String(version?.webSocketDebuggerUrl ?? "").trim();
1825
+ if (!wsUrl) return null;
1826
+ return normalizeCdpWsUrl(wsUrl, cdpUrl);
1827
+ }
1828
+ async function canOpenWebSocket(wsUrl, timeoutMs = 800) {
1829
+ return await new Promise((resolve) => {
1830
+ const headers = getHeadersWithAuth(wsUrl);
1831
+ const ws = new WebSocket(wsUrl, {
1832
+ handshakeTimeout: timeoutMs,
1833
+ ...Object.keys(headers).length ? { headers } : {}
1834
+ });
1835
+ const timer = setTimeout(() => {
1836
+ try {
1837
+ ws.terminate();
1838
+ } catch {}
1839
+ resolve(false);
1840
+ }, Math.max(50, timeoutMs + 25));
1841
+ ws.once("open", () => {
1842
+ clearTimeout(timer);
1843
+ try {
1844
+ ws.close();
1845
+ } catch {}
1846
+ resolve(true);
1847
+ });
1848
+ ws.once("error", () => {
1849
+ clearTimeout(timer);
1850
+ resolve(false);
1851
+ });
1852
+ });
1853
+ }
1854
+ async function isChromeCdpReady(cdpUrl, timeoutMs = 500, handshakeTimeoutMs = 800) {
1855
+ const wsUrl = await getChromeWebSocketUrl(cdpUrl, timeoutMs);
1856
+ if (!wsUrl) return false;
1857
+ return await canOpenWebSocket(wsUrl, handshakeTimeoutMs);
1858
+ }
1859
+ async function launchOpenClawChrome(resolved, profile) {
1860
+ if (!profile.cdpIsLoopback) throw new Error(`Profile "${profile.name}" is remote; cannot launch local Chrome.`);
1861
+ await ensurePortAvailable(profile.cdpPort);
1862
+ const exe = resolveBrowserExecutable(resolved);
1863
+ if (!exe) throw new Error("No supported browser found (Chrome/Brave/Edge/Chromium on macOS, Linux, or Windows).");
1864
+ const userDataDir = resolveOpenClawUserDataDir(profile.name);
1865
+ fs.mkdirSync(userDataDir, { recursive: true });
1866
+ const needsDecorate = !isProfileDecorated(userDataDir, profile.name, (profile.color ?? DEFAULT_OPENCLAW_BROWSER_COLOR).toUpperCase());
1867
+ const spawnOnce = () => {
1868
+ const args = [
1869
+ `--remote-debugging-port=${profile.cdpPort}`,
1870
+ `--user-data-dir=${userDataDir}`,
1871
+ "--no-first-run",
1872
+ "--no-default-browser-check",
1873
+ "--disable-sync",
1874
+ "--disable-background-networking",
1875
+ "--disable-component-update",
1876
+ "--disable-features=Translate,MediaRouter",
1877
+ "--disable-session-crashed-bubble",
1878
+ "--hide-crash-restore-bubble",
1879
+ "--password-store=basic"
1880
+ ];
1881
+ if (resolved.headless) {
1882
+ args.push("--headless=new");
1883
+ args.push("--disable-gpu");
1884
+ }
1885
+ if (resolved.noSandbox) {
1886
+ args.push("--no-sandbox");
1887
+ args.push("--disable-setuid-sandbox");
1888
+ }
1889
+ if (process.platform === "linux") args.push("--disable-dev-shm-usage");
1890
+ args.push("about:blank");
1891
+ return spawn(exe.path, args, {
1892
+ stdio: "pipe",
1893
+ env: {
1894
+ ...process.env,
1895
+ HOME: os.homedir()
1896
+ }
1897
+ });
1898
+ };
1899
+ const startedAt = Date.now();
1900
+ const localStatePath = path.join(userDataDir, "Local State");
1901
+ const preferencesPath = path.join(userDataDir, "Default", "Preferences");
1902
+ if (!exists(localStatePath) || !exists(preferencesPath)) {
1903
+ const bootstrap = spawnOnce();
1904
+ const deadline = Date.now() + 1e4;
1905
+ while (Date.now() < deadline) {
1906
+ if (exists(localStatePath) && exists(preferencesPath)) break;
1907
+ await new Promise((r) => setTimeout(r, 100));
1908
+ }
1909
+ try {
1910
+ bootstrap.kill("SIGTERM");
1911
+ } catch {}
1912
+ const exitDeadline = Date.now() + 5e3;
1913
+ while (Date.now() < exitDeadline) {
1914
+ if (bootstrap.exitCode != null) break;
1915
+ await new Promise((r) => setTimeout(r, 50));
1916
+ }
1917
+ }
1918
+ if (needsDecorate) try {
1919
+ decorateOpenClawProfile(userDataDir, {
1920
+ name: profile.name,
1921
+ color: profile.color
1922
+ });
1923
+ log.info(`🦞 openclaw browser profile decorated (${profile.color})`);
1924
+ } catch (err) {
1925
+ log.warn(`openclaw browser profile decoration failed: ${String(err)}`);
1926
+ }
1927
+ try {
1928
+ ensureProfileCleanExit(userDataDir);
1929
+ } catch (err) {
1930
+ log.warn(`openclaw browser clean-exit prefs failed: ${String(err)}`);
1931
+ }
1932
+ const proc = spawnOnce();
1933
+ const readyDeadline = Date.now() + 15e3;
1934
+ while (Date.now() < readyDeadline) {
1935
+ if (await isChromeReachable(profile.cdpUrl, 500)) break;
1936
+ await new Promise((r) => setTimeout(r, 200));
1937
+ }
1938
+ if (!await isChromeReachable(profile.cdpUrl, 500)) {
1939
+ try {
1940
+ proc.kill("SIGKILL");
1941
+ } catch {}
1942
+ throw new Error(`Failed to start Chrome CDP on port ${profile.cdpPort} for profile "${profile.name}".`);
1943
+ }
1944
+ const pid = proc.pid ?? -1;
1945
+ log.info(`🦞 openclaw browser started (${exe.kind}) profile "${profile.name}" on 127.0.0.1:${profile.cdpPort} (pid ${pid})`);
1946
+ return {
1947
+ pid,
1948
+ exe,
1949
+ userDataDir,
1950
+ cdpPort: profile.cdpPort,
1951
+ startedAt,
1952
+ proc
1953
+ };
1954
+ }
1955
+ async function stopOpenClawChrome(running, timeoutMs = 2500) {
1956
+ const proc = running.proc;
1957
+ if (proc.killed) return;
1958
+ try {
1959
+ proc.kill("SIGTERM");
1960
+ } catch {}
1961
+ const start = Date.now();
1962
+ while (Date.now() - start < timeoutMs) {
1963
+ if (!proc.exitCode && proc.killed) break;
1964
+ if (!await isChromeReachable(cdpUrlForPort(running.cdpPort), 200)) return;
1965
+ await new Promise((r) => setTimeout(r, 100));
1966
+ }
1967
+ try {
1968
+ proc.kill("SIGKILL");
1969
+ } catch {}
1970
+ }
1971
+
1972
+ //#endregion
1973
+ export { DEFAULT_BROWSER_DEFAULT_PROFILE_NAME as A, stopChromeExtensionRelayServer as C, DEFAULT_AI_SNAPSHOT_EFFICIENT_DEPTH as D, formatUncaughtError as E, DEFAULT_OPENCLAW_BROWSER_COLOR as M, DEFAULT_OPENCLAW_BROWSER_ENABLED as N, DEFAULT_AI_SNAPSHOT_EFFICIENT_MAX_CHARS as O, DEFAULT_OPENCLAW_BROWSER_PROFILE_NAME as P, ensureChromeExtensionRelayServer as S, formatErrorMessage as T, formatAriaSnapshot as _, resolveOpenClawUserDataDir as a, appendCdpPath as b, describePortOwner as c, inspectPortUsage as d, resolveLsofCommandSync as f, createTargetViaCdp as g, captureScreenshot as h, launchOpenClawChrome as i, DEFAULT_BROWSER_EVALUATE_ENABLED as j, DEFAULT_AI_SNAPSHOT_MAX_CHARS as k, ensurePortAvailable as l, resolveBrowserExecutableForPlatform as m, isChromeCdpReady as n, stopOpenClawChrome as o, formatPortDiagnostics as p, isChromeReachable as r, PortInUseError as s, getChromeWebSocketUrl as t, handlePortError as u, normalizeCdpWsUrl as v, extractErrorCode as w, getHeadersWithAuth as x, snapshotAria as y };