@agent-our/openclaw 2026.2.6-3

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 (2759) hide show
  1. package/CHANGELOG.md +1596 -0
  2. package/LICENSE +21 -0
  3. package/README-header.png +0 -0
  4. package/README.md +545 -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-B9umzy_R.js +250 -0
  18. package/dist/accounts-DkUtJa-O.js +251 -0
  19. package/dist/acp-cli-BBglTQii.js +923 -0
  20. package/dist/acp-cli-DrYibaVx.js +926 -0
  21. package/dist/agent-CbM7AbvV.js +704 -0
  22. package/dist/agent-DlzdY95q.js +704 -0
  23. package/dist/agent-scope-CB4YNu1h.js +613 -0
  24. package/dist/agent-scope-jAWKj2TP.js +371 -0
  25. package/dist/agent-scope-sKVRNONG.js +371 -0
  26. package/dist/archive-Dy3Ezb-5.js +85 -0
  27. package/dist/archive-ccN9aDgq.js +85 -0
  28. package/dist/audit-B2D3VRh8.js +1853 -0
  29. package/dist/audit-BdNhDEyo.js +1853 -0
  30. package/dist/auth-CMKwNo-f.js +192 -0
  31. package/dist/auth-DuZNzAAH.js +192 -0
  32. package/dist/auth-health-BNW1lZ8k.js +149 -0
  33. package/dist/auth-health-C3HJKHJi.js +149 -0
  34. package/dist/auth-profiles-DYdLc1cj.js +2981 -0
  35. package/dist/boolean-BgXe2hyu.js +30 -0
  36. package/dist/brew-CAcErcKz.js +46 -0
  37. package/dist/brew-CcZV0dSS.js +46 -0
  38. package/dist/build-info.json +5 -0
  39. package/dist/call-YdaudqMl.js +280 -0
  40. package/dist/call-wfwuMJe-.js +280 -0
  41. package/dist/canvas-host/a2ui/.bundle.hash +1 -0
  42. package/dist/canvas-host/a2ui/a2ui.bundle.js +17765 -0
  43. package/dist/canvas-host/a2ui/index.html +307 -0
  44. package/dist/channel-options-B-G7tzkB.js +32 -0
  45. package/dist/channel-options-jfcr7ChQ.js +62 -0
  46. package/dist/channel-selection-C5KQyVUF.js +51 -0
  47. package/dist/channel-selection-DXVHNo3U.js +51 -0
  48. package/dist/channel-summary-CFZImIiG.js +1120 -0
  49. package/dist/channel-summary-CoLmo1EU.js +1120 -0
  50. package/dist/channels-cli-Cc3MY52X.js +1413 -0
  51. package/dist/channels-cli-D2lTE59V.js +1415 -0
  52. package/dist/channels-status-issues-Dln8njuR.js +18 -0
  53. package/dist/channels-status-issues-ptsVdM7G.js +18 -0
  54. package/dist/chrome-B3IuUad-.js +1953 -0
  55. package/dist/chrome-BNSd7Bie.js +1973 -0
  56. package/dist/clack-prompter-B9yLhyOm.js +92 -0
  57. package/dist/clack-prompter-CEKDd_Vg.js +92 -0
  58. package/dist/cli/daemon-cli.js +2 -0
  59. package/dist/cli-Fq054ApO.js +89 -0
  60. package/dist/cli-rd9P_S1u.js +86 -0
  61. package/dist/cli-utils-BkRQdAoC.js +43 -0
  62. package/dist/cli-utils-DzrdzskQ.js +43 -0
  63. package/dist/client-DvWPgCi6.js +1815 -0
  64. package/dist/command-format-CFzL448l.js +52 -0
  65. package/dist/command-format-ChfKqObn.js +52 -0
  66. package/dist/command-format-ayFsmwwz.js +38 -0
  67. package/dist/command-options-qBrt237S.js +33 -0
  68. package/dist/commands-CQNsJDTA.js +230 -0
  69. package/dist/completion-cli-C5BH1XDk.js +773 -0
  70. package/dist/completion-cli-CNKrO4o0.js +434 -0
  71. package/dist/config-BEUgkMYH.js +4922 -0
  72. package/dist/config-BM_g3TBU.js +4921 -0
  73. package/dist/config-Ct91v0JZ.js +5662 -0
  74. package/dist/config-guard-C-ACw81n.js +5774 -0
  75. package/dist/configure-CcXcdOUM.js +896 -0
  76. package/dist/configure-DWMokcXD.js +895 -0
  77. package/dist/constants-CNTiY-ZN.js +65 -0
  78. package/dist/constants-HPrOsATF.js +65 -0
  79. package/dist/control-service-B3g4oucx.js +61 -0
  80. package/dist/control-service-Dh4DKu3S.js +61 -0
  81. package/dist/control-ui/apple-touch-icon.png +0 -0
  82. package/dist/control-ui/assets/index-Dm8pMa9P.js +11534 -0
  83. package/dist/control-ui/assets/index-Dm8pMa9P.js.map +1 -0
  84. package/dist/control-ui/assets/index-eofFRbdc.css +1 -0
  85. package/dist/control-ui/favicon-32.png +0 -0
  86. package/dist/control-ui/favicon.ico +0 -0
  87. package/dist/control-ui/favicon.svg +22 -0
  88. package/dist/control-ui/index.html +17 -0
  89. package/dist/cron-cli-Bx6joqjI.js +454 -0
  90. package/dist/cron-cli-C5k_pz71.js +457 -0
  91. package/dist/daemon-cli-D-Gm28gZ.js +758 -0
  92. package/dist/daemon-cli-DQ5dlrIR.js +757 -0
  93. package/dist/daemon-runtime-C648Lhju.js +517 -0
  94. package/dist/daemon-runtime-Chcfufn1.js +517 -0
  95. package/dist/deliver-DBiz1Usy.js +2557 -0
  96. package/dist/deliver-DmpRwa2w.js +2587 -0
  97. package/dist/deliver-X5yjr56P.js +2587 -0
  98. package/dist/deps-DlFoECb7.js +27 -0
  99. package/dist/deps-UZ0CMWoo.js +27 -0
  100. package/dist/devices-cli-CpGSCere.js +207 -0
  101. package/dist/devices-cli-DIZJXWIY.js +204 -0
  102. package/dist/directory-cli-DhC1uA2S.js +247 -0
  103. package/dist/directory-cli-ZDXb1dmk.js +244 -0
  104. package/dist/dispatcher-DLhpc7HC.js +160 -0
  105. package/dist/dns-cli-B7Xi-izZ.js +198 -0
  106. package/dist/dns-cli-BsvKw0iq.js +201 -0
  107. package/dist/docs-cli-Bi5BtLfY.js +161 -0
  108. package/dist/docs-cli-CkczsV22.js +159 -0
  109. package/dist/doctor-CN9WxbwV.js +2586 -0
  110. package/dist/doctor-ClCw8y0M.js +2588 -0
  111. package/dist/entry.js +1330 -0
  112. package/dist/env-0_mKbEWW.js +32 -0
  113. package/dist/errors-CZ9opC6L.js +1952 -0
  114. package/dist/exec-B8JKbXKW.js +246 -0
  115. package/dist/exec-BMnoMcZW.js +1099 -0
  116. package/dist/exec-HEWTMJ7j.js +246 -0
  117. package/dist/exec-approvals-D4ny1TmX.js +1043 -0
  118. package/dist/exec-approvals-DmzWB9Zy.js +1043 -0
  119. package/dist/exec-approvals-cli-DPD2Z2Cg.js +385 -0
  120. package/dist/exec-approvals-cli-Dl4Y4IqE.js +388 -0
  121. package/dist/extensionAPI.js +68146 -0
  122. package/dist/format-8citvr_1.js +34 -0
  123. package/dist/format-tlvh4-cQ.js +34 -0
  124. package/dist/gateway-cli-B_lqsPIR.js +18017 -0
  125. package/dist/gateway-cli-D1Jvi6Ab.js +18016 -0
  126. package/dist/gateway-rpc-CYPgf43u.js +28 -0
  127. package/dist/gateway-rpc-CzWTXOHS.js +28 -0
  128. package/dist/github-copilot-auth-BcnJgC7r.js +1256 -0
  129. package/dist/github-copilot-auth-OEOMPahq.js +1256 -0
  130. package/dist/github-copilot-token-B3SA95yo.js +103 -0
  131. package/dist/github-copilot-token-SLWintYd.js +103 -0
  132. package/dist/github-copilot-token-pGSmVaW-.js +103 -0
  133. package/dist/gmail-setup-utils-CwS9GsIM.js +428 -0
  134. package/dist/gmail-setup-utils-D3Wa2Tx_.js +428 -0
  135. package/dist/health-format-CbDB25L0.js +1388 -0
  136. package/dist/health-format-DIJjpCDL.js +1389 -0
  137. package/dist/help-format-BlaVZH29.js +17 -0
  138. package/dist/help-format-DuMTLWZ-.js +17 -0
  139. package/dist/helpers-BiyEksaK.js +25 -0
  140. package/dist/helpers-CSZtxHTa.js +10 -0
  141. package/dist/helpers-CxHtCvId.js +10 -0
  142. package/dist/helpers-azbX_hrI.js +25 -0
  143. package/dist/hooks/bundled/boot-md/HOOK.md +19 -0
  144. package/dist/hooks/bundled/command-logger/HOOK.md +122 -0
  145. package/dist/hooks/bundled/session-memory/HOOK.md +109 -0
  146. package/dist/hooks/bundled/soul-evil/HOOK.md +71 -0
  147. package/dist/hooks-cli-BuNzxQ-L.js +1058 -0
  148. package/dist/hooks-cli-D-QCmmC9.js +1061 -0
  149. package/dist/hooks-status-BvbcN-ho.js +443 -0
  150. package/dist/hooks-status-CH1ZdZs5.js +443 -0
  151. package/dist/image-BP1mAJzN.js +1421 -0
  152. package/dist/image-DMNGdVWb.js +629 -0
  153. package/dist/image-E_i8K6Vq.js +629 -0
  154. package/dist/index.js +5957 -0
  155. package/dist/installs-BcBaI60O.js +425 -0
  156. package/dist/installs-BhEjOqPy.js +425 -0
  157. package/dist/is-main-B6kCyqsv.js +25 -0
  158. package/dist/is-main-PYGa3tDA.js +25 -0
  159. package/dist/links-B4nk2iDf.js +15 -0
  160. package/dist/links-B5pRdmo1.js +15 -0
  161. package/dist/loader-DqiCudFO.js +64754 -0
  162. package/dist/logging-6zx7VGt-.js +15 -0
  163. package/dist/logging-BWRYHvLp.js +1 -0
  164. package/dist/logging-TXWhN8jG.js +15 -0
  165. package/dist/logging-pqyrk15z.js +1 -0
  166. package/dist/login-qr-Bo7zzLWd.js +478 -0
  167. package/dist/login-qr-CFw3hF2h.js +478 -0
  168. package/dist/login-qr-UmMP2m6M.js +475 -0
  169. package/dist/logs-cli-BBPaaFhF.js +230 -0
  170. package/dist/logs-cli-DTo-7DxM.js +227 -0
  171. package/dist/manager-B365Xcjg.js +3218 -0
  172. package/dist/manager-BtFI9Zdc.js +3216 -0
  173. package/dist/manager-Bwpep10z.js +3216 -0
  174. package/dist/manifest-registry-C69Z-I4v.js +668 -0
  175. package/dist/manifest-registry-DHaa1SJb.js +668 -0
  176. package/dist/message-channel-Bpfe5l5f.js +110 -0
  177. package/dist/message-channel-CQ6DgRUw.js +110 -0
  178. package/dist/model-selection-BXhwukLK.js +2734 -0
  179. package/dist/model-selection-CjiXwYEH.js +2983 -0
  180. package/dist/models-cli-DQKO_tWR.js +2542 -0
  181. package/dist/models-cli-k41kE3Yo.js +2545 -0
  182. package/dist/net-5DEH6AJK.js +1815 -0
  183. package/dist/node-cli-BXYXe5FE.js +1456 -0
  184. package/dist/node-cli-D7W69MZm.js +1459 -0
  185. package/dist/node-service-BTKxbzYo.js +67 -0
  186. package/dist/node-service-BoC2MKaK.js +67 -0
  187. package/dist/nodes-cli-MDb6jux3.js +1210 -0
  188. package/dist/nodes-cli-q-rHzVBz.js +1207 -0
  189. package/dist/nodes-screen-DT5HvhJV.js +157 -0
  190. package/dist/nodes-screen-DtXuFQdk.js +157 -0
  191. package/dist/note-B5HnoeZX.js +73 -0
  192. package/dist/note-_C44YfAQ.js +73 -0
  193. package/dist/onboard-channels-CKzF9fxT.js +671 -0
  194. package/dist/onboard-channels-Dr4FB1Sm.js +671 -0
  195. package/dist/onboard-skills-F6Kw1jrV.js +3452 -0
  196. package/dist/onboard-skills-aY4SkANg.js +3452 -0
  197. package/dist/onboarding-Do6ghpyS.js +3269 -0
  198. package/dist/openclaw-root-9ILYSmJ9.js +84 -0
  199. package/dist/openclaw-root-Cvotktkd.js +84 -0
  200. package/dist/pairing-cli-BUGQkncg.js +114 -0
  201. package/dist/pairing-cli-C63BXADO.js +117 -0
  202. package/dist/pairing-labels-DERlP-Wr.js +9 -0
  203. package/dist/pairing-labels-DhY2DQey.js +9 -0
  204. package/dist/pairing-store-D9vodPRR.js +391 -0
  205. package/dist/pairing-store-DWX2hYou.js +391 -0
  206. package/dist/parse-BZz5lHzQ.js +23 -0
  207. package/dist/parse-DqAvJRIf.js +23 -0
  208. package/dist/parse-log-line-BnB7770k.js +44 -0
  209. package/dist/parse-log-line-DSvJi17i.js +44 -0
  210. package/dist/parse-timeout-DV8NQQWk.js +16 -0
  211. package/dist/parse-timeout-Du-wHHNi.js +16 -0
  212. package/dist/path-env-DP3DsVge.js +77 -0
  213. package/dist/path-env-h3xp5PqO.js +77 -0
  214. package/dist/paths-B1kfl4h5.js +164 -0
  215. package/dist/paths-BT8VDsrj.js +43 -0
  216. package/dist/paths-BveE45t9.js +40 -0
  217. package/dist/paths-CR6bsrfc.js +43 -0
  218. package/dist/paths-scjhy7N2.js +180 -0
  219. package/dist/pi-embedded-helpers-BBIlv_VS.js +1303 -0
  220. package/dist/pi-embedded-helpers-CgGWSZV9.js +8480 -0
  221. package/dist/pi-embedded-helpers-CvujKXfr.js +1303 -0
  222. package/dist/pi-model-discovery-CV2V1HHz.js +20 -0
  223. package/dist/pi-model-discovery-DzEIEgHL.js +20 -0
  224. package/dist/pi-model-discovery-EhM2JAQo.js +20 -0
  225. package/dist/pi-tools.policy-JNsnW6cw.js +230 -0
  226. package/dist/plugin-auto-enable-CKBWhy8V.js +460 -0
  227. package/dist/plugin-auto-enable-D7FGzrWo.js +460 -0
  228. package/dist/plugin-sdk/agents/agent-paths.d.ts +2 -0
  229. package/dist/plugin-sdk/agents/agent-scope.d.ts +37 -0
  230. package/dist/plugin-sdk/agents/anthropic-payload-log.d.ts +16 -0
  231. package/dist/plugin-sdk/agents/apply-patch-update.d.ts +8 -0
  232. package/dist/plugin-sdk/agents/apply-patch.d.ts +24 -0
  233. package/dist/plugin-sdk/agents/auth-profiles/constants.d.ts +20 -0
  234. package/dist/plugin-sdk/agents/auth-profiles/display.d.ts +7 -0
  235. package/dist/plugin-sdk/agents/auth-profiles/doctor.d.ts +8 -0
  236. package/dist/plugin-sdk/agents/auth-profiles/external-cli-sync.d.ts +7 -0
  237. package/dist/plugin-sdk/agents/auth-profiles/oauth.d.ts +12 -0
  238. package/dist/plugin-sdk/agents/auth-profiles/order.d.ts +8 -0
  239. package/dist/plugin-sdk/agents/auth-profiles/paths.d.ts +4 -0
  240. package/dist/plugin-sdk/agents/auth-profiles/profiles.d.ts +18 -0
  241. package/dist/plugin-sdk/agents/auth-profiles/repair.d.ts +14 -0
  242. package/dist/plugin-sdk/agents/auth-profiles/session-override.d.ts +18 -0
  243. package/dist/plugin-sdk/agents/auth-profiles/store.d.ts +10 -0
  244. package/dist/plugin-sdk/agents/auth-profiles/types.d.ts +60 -0
  245. package/dist/plugin-sdk/agents/auth-profiles/usage.d.ts +47 -0
  246. package/dist/plugin-sdk/agents/auth-profiles.d.ts +11 -0
  247. package/dist/plugin-sdk/agents/bash-process-registry.d.ts +68 -0
  248. package/dist/plugin-sdk/agents/bash-tools.d.ts +4 -0
  249. package/dist/plugin-sdk/agents/bash-tools.exec.d.ts +54 -0
  250. package/dist/plugin-sdk/agents/bash-tools.process.d.ts +7 -0
  251. package/dist/plugin-sdk/agents/bash-tools.shared.d.ts +46 -0
  252. package/dist/plugin-sdk/agents/bedrock-discovery.d.ts +9 -0
  253. package/dist/plugin-sdk/agents/bootstrap-files.d.ts +25 -0
  254. package/dist/plugin-sdk/agents/bootstrap-hooks.d.ts +10 -0
  255. package/dist/plugin-sdk/agents/cache-trace.d.ts +51 -0
  256. package/dist/plugin-sdk/agents/channel-tools.d.ts +27 -0
  257. package/dist/plugin-sdk/agents/chutes-oauth.d.ts +46 -0
  258. package/dist/plugin-sdk/agents/cli-backends.d.ts +8 -0
  259. package/dist/plugin-sdk/agents/cli-credentials.d.ts +82 -0
  260. package/dist/plugin-sdk/agents/cli-runner/helpers.d.ts +76 -0
  261. package/dist/plugin-sdk/agents/cli-runner.d.ts +41 -0
  262. package/dist/plugin-sdk/agents/cli-session.d.ts +3 -0
  263. package/dist/plugin-sdk/agents/cloudflare-ai-gateway.d.ts +22 -0
  264. package/dist/plugin-sdk/agents/context-window-guard.d.ts +24 -0
  265. package/dist/plugin-sdk/agents/context.d.ts +1 -0
  266. package/dist/plugin-sdk/agents/date-time.d.ts +13 -0
  267. package/dist/plugin-sdk/agents/defaults.d.ts +3 -0
  268. package/dist/plugin-sdk/agents/docs-path.d.ts +6 -0
  269. package/dist/plugin-sdk/agents/failover-error.d.ts +33 -0
  270. package/dist/plugin-sdk/agents/identity.d.ts +25 -0
  271. package/dist/plugin-sdk/agents/lanes.d.ts +3 -0
  272. package/dist/plugin-sdk/agents/memory-search.d.ts +66 -0
  273. package/dist/plugin-sdk/agents/minimax-vlm.d.ts +7 -0
  274. package/dist/plugin-sdk/agents/model-auth.d.ts +36 -0
  275. package/dist/plugin-sdk/agents/model-catalog.d.ts +25 -0
  276. package/dist/plugin-sdk/agents/model-compat.d.ts +2 -0
  277. package/dist/plugin-sdk/agents/model-fallback.d.ts +49 -0
  278. package/dist/plugin-sdk/agents/model-selection.d.ts +93 -0
  279. package/dist/plugin-sdk/agents/models-config.d.ts +5 -0
  280. package/dist/plugin-sdk/agents/models-config.providers.d.ts +26 -0
  281. package/dist/plugin-sdk/agents/openclaw-tools.d.ts +44 -0
  282. package/dist/plugin-sdk/agents/pi-embedded-block-chunker.d.ts +19 -0
  283. package/dist/plugin-sdk/agents/pi-embedded-helpers/bootstrap.d.ts +28 -0
  284. package/dist/plugin-sdk/agents/pi-embedded-helpers/errors.d.ts +47 -0
  285. package/dist/plugin-sdk/agents/pi-embedded-helpers/google.d.ts +8 -0
  286. package/dist/plugin-sdk/agents/pi-embedded-helpers/images.d.ts +20 -0
  287. package/dist/plugin-sdk/agents/pi-embedded-helpers/messaging-dedupe.d.ts +10 -0
  288. package/dist/plugin-sdk/agents/pi-embedded-helpers/openai.d.ts +9 -0
  289. package/dist/plugin-sdk/agents/pi-embedded-helpers/thinking.d.ts +5 -0
  290. package/dist/plugin-sdk/agents/pi-embedded-helpers/turns.d.ts +20 -0
  291. package/dist/plugin-sdk/agents/pi-embedded-helpers/types.d.ts +5 -0
  292. package/dist/plugin-sdk/agents/pi-embedded-helpers.d.ts +11 -0
  293. package/dist/plugin-sdk/agents/pi-embedded-messaging.d.ts +8 -0
  294. package/dist/plugin-sdk/agents/pi-embedded-runner/abort.d.ts +1 -0
  295. package/dist/plugin-sdk/agents/pi-embedded-runner/cache-ttl.d.ts +9 -0
  296. package/dist/plugin-sdk/agents/pi-embedded-runner/compact.d.ts +50 -0
  297. package/dist/plugin-sdk/agents/pi-embedded-runner/extensions.d.ts +12 -0
  298. package/dist/plugin-sdk/agents/pi-embedded-runner/extra-params.d.ts +22 -0
  299. package/dist/plugin-sdk/agents/pi-embedded-runner/google.d.ts +39 -0
  300. package/dist/plugin-sdk/agents/pi-embedded-runner/history.d.ts +12 -0
  301. package/dist/plugin-sdk/agents/pi-embedded-runner/lanes.d.ts +3 -0
  302. package/dist/plugin-sdk/agents/pi-embedded-runner/logger.d.ts +1 -0
  303. package/dist/plugin-sdk/agents/pi-embedded-runner/model.d.ts +22 -0
  304. package/dist/plugin-sdk/agents/pi-embedded-runner/run/attempt.d.ts +5 -0
  305. package/dist/plugin-sdk/agents/pi-embedded-runner/run/images.d.ts +83 -0
  306. package/dist/plugin-sdk/agents/pi-embedded-runner/run/params.d.ts +116 -0
  307. package/dist/plugin-sdk/agents/pi-embedded-runner/run/payloads.d.ts +34 -0
  308. package/dist/plugin-sdk/agents/pi-embedded-runner/run/types.d.ts +133 -0
  309. package/dist/plugin-sdk/agents/pi-embedded-runner/run.d.ts +3 -0
  310. package/dist/plugin-sdk/agents/pi-embedded-runner/runs.d.ts +14 -0
  311. package/dist/plugin-sdk/agents/pi-embedded-runner/sandbox-info.d.ts +4 -0
  312. package/dist/plugin-sdk/agents/pi-embedded-runner/session-manager-cache.d.ts +2 -0
  313. package/dist/plugin-sdk/agents/pi-embedded-runner/session-manager-init.d.ts +17 -0
  314. package/dist/plugin-sdk/agents/pi-embedded-runner/system-prompt.d.ts +51 -0
  315. package/dist/plugin-sdk/agents/pi-embedded-runner/tool-result-truncation.d.ts +65 -0
  316. package/dist/plugin-sdk/agents/pi-embedded-runner/tool-split.d.ts +11 -0
  317. package/dist/plugin-sdk/agents/pi-embedded-runner/types.d.ts +70 -0
  318. package/dist/plugin-sdk/agents/pi-embedded-runner/utils.d.ts +8 -0
  319. package/dist/plugin-sdk/agents/pi-embedded-runner.d.ts +12 -0
  320. package/dist/plugin-sdk/agents/pi-embedded-subscribe.d.ts +20 -0
  321. package/dist/plugin-sdk/agents/pi-embedded-subscribe.handlers.d.ts +2 -0
  322. package/dist/plugin-sdk/agents/pi-embedded-subscribe.handlers.lifecycle.d.ts +8 -0
  323. package/dist/plugin-sdk/agents/pi-embedded-subscribe.handlers.messages.d.ts +12 -0
  324. package/dist/plugin-sdk/agents/pi-embedded-subscribe.handlers.tools.d.ts +18 -0
  325. package/dist/plugin-sdk/agents/pi-embedded-subscribe.handlers.types.d.ts +108 -0
  326. package/dist/plugin-sdk/agents/pi-embedded-subscribe.raw-stream.d.ts +1 -0
  327. package/dist/plugin-sdk/agents/pi-embedded-subscribe.tools.d.ts +6 -0
  328. package/dist/plugin-sdk/agents/pi-embedded-subscribe.types.d.ts +44 -0
  329. package/dist/plugin-sdk/agents/pi-embedded-utils.d.ts +38 -0
  330. package/dist/plugin-sdk/agents/pi-embedded.d.ts +2 -0
  331. package/dist/plugin-sdk/agents/pi-extensions/compaction-safeguard-runtime.d.ts +6 -0
  332. package/dist/plugin-sdk/agents/pi-extensions/context-pruning/runtime.d.ts +9 -0
  333. package/dist/plugin-sdk/agents/pi-extensions/context-pruning/settings.d.ts +44 -0
  334. package/dist/plugin-sdk/agents/pi-extensions/context-pruning/tools.d.ts +2 -0
  335. package/dist/plugin-sdk/agents/pi-model-discovery.d.ts +4 -0
  336. package/dist/plugin-sdk/agents/pi-settings.d.ts +19 -0
  337. package/dist/plugin-sdk/agents/pi-tool-definition-adapter.d.ts +10 -0
  338. package/dist/plugin-sdk/agents/pi-tools.abort.d.ts +2 -0
  339. package/dist/plugin-sdk/agents/pi-tools.before-tool-call.d.ts +25 -0
  340. package/dist/plugin-sdk/agents/pi-tools.d.ts +69 -0
  341. package/dist/plugin-sdk/agents/pi-tools.policy.d.ts +37 -0
  342. package/dist/plugin-sdk/agents/pi-tools.read.d.ts +35 -0
  343. package/dist/plugin-sdk/agents/pi-tools.schema.d.ts +3 -0
  344. package/dist/plugin-sdk/agents/pi-tools.types.d.ts +2 -0
  345. package/dist/plugin-sdk/agents/pty-dsr.d.ts +5 -0
  346. package/dist/plugin-sdk/agents/pty-keys.d.ts +13 -0
  347. package/dist/plugin-sdk/agents/sandbox/browser-bridges.d.ts +5 -0
  348. package/dist/plugin-sdk/agents/sandbox/browser.d.ts +8 -0
  349. package/dist/plugin-sdk/agents/sandbox/config-hash.d.ts +9 -0
  350. package/dist/plugin-sdk/agents/sandbox/config.d.ts +22 -0
  351. package/dist/plugin-sdk/agents/sandbox/constants.d.ts +19 -0
  352. package/dist/plugin-sdk/agents/sandbox/context.d.ts +12 -0
  353. package/dist/plugin-sdk/agents/sandbox/docker.d.ts +28 -0
  354. package/dist/plugin-sdk/agents/sandbox/manage.d.ts +13 -0
  355. package/dist/plugin-sdk/agents/sandbox/prune.d.ts +3 -0
  356. package/dist/plugin-sdk/agents/sandbox/registry.d.ts +30 -0
  357. package/dist/plugin-sdk/agents/sandbox/runtime-status.d.ts +18 -0
  358. package/dist/plugin-sdk/agents/sandbox/shared.d.ts +4 -0
  359. package/dist/plugin-sdk/agents/sandbox/tool-policy.d.ts +4 -0
  360. package/dist/plugin-sdk/agents/sandbox/types.d.ts +73 -0
  361. package/dist/plugin-sdk/agents/sandbox/types.docker.d.ts +25 -0
  362. package/dist/plugin-sdk/agents/sandbox/workspace.d.ts +1 -0
  363. package/dist/plugin-sdk/agents/sandbox-paths.d.ts +21 -0
  364. package/dist/plugin-sdk/agents/sandbox.d.ts +8 -0
  365. package/dist/plugin-sdk/agents/schema/clean-for-gemini.d.ts +2 -0
  366. package/dist/plugin-sdk/agents/schema/typebox.d.ts +14 -0
  367. package/dist/plugin-sdk/agents/session-file-repair.d.ts +11 -0
  368. package/dist/plugin-sdk/agents/session-slug.d.ts +1 -0
  369. package/dist/plugin-sdk/agents/session-tool-result-guard-wrapper.d.ts +14 -0
  370. package/dist/plugin-sdk/agents/session-tool-result-guard.d.ts +21 -0
  371. package/dist/plugin-sdk/agents/session-transcript-repair.d.ts +26 -0
  372. package/dist/plugin-sdk/agents/session-write-lock.d.ts +21 -0
  373. package/dist/plugin-sdk/agents/shell-utils.d.ts +7 -0
  374. package/dist/plugin-sdk/agents/skills/bundled-dir.d.ts +7 -0
  375. package/dist/plugin-sdk/agents/skills/config.d.ts +14 -0
  376. package/dist/plugin-sdk/agents/skills/env-overrides.d.ts +10 -0
  377. package/dist/plugin-sdk/agents/skills/frontmatter.d.ts +6 -0
  378. package/dist/plugin-sdk/agents/skills/plugin-skills.d.ts +5 -0
  379. package/dist/plugin-sdk/agents/skills/refresh.d.ts +19 -0
  380. package/dist/plugin-sdk/agents/skills/serialize.d.ts +1 -0
  381. package/dist/plugin-sdk/agents/skills/types.d.ts +80 -0
  382. package/dist/plugin-sdk/agents/skills/workspace.d.ts +49 -0
  383. package/dist/plugin-sdk/agents/skills.d.ts +7 -0
  384. package/dist/plugin-sdk/agents/subagent-announce-queue.d.ts +22 -0
  385. package/dist/plugin-sdk/agents/subagent-announce.d.ts +30 -0
  386. package/dist/plugin-sdk/agents/subagent-registry.d.ts +35 -0
  387. package/dist/plugin-sdk/agents/subagent-registry.store.d.ts +5 -0
  388. package/dist/plugin-sdk/agents/synthetic-models.d.ts +153 -0
  389. package/dist/plugin-sdk/agents/system-prompt-params.d.ts +30 -0
  390. package/dist/plugin-sdk/agents/system-prompt-report.d.ts +20 -0
  391. package/dist/plugin-sdk/agents/system-prompt.d.ts +77 -0
  392. package/dist/plugin-sdk/agents/timeout.d.ts +8 -0
  393. package/dist/plugin-sdk/agents/tool-call-id.d.ts +17 -0
  394. package/dist/plugin-sdk/agents/tool-display.d.ts +15 -0
  395. package/dist/plugin-sdk/agents/tool-images.d.ts +19 -0
  396. package/dist/plugin-sdk/agents/tool-policy.d.ts +39 -0
  397. package/dist/plugin-sdk/agents/tool-summaries.d.ts +2 -0
  398. package/dist/plugin-sdk/agents/tools/agent-step.d.ts +12 -0
  399. package/dist/plugin-sdk/agents/tools/agents-list-tool.d.ts +6 -0
  400. package/dist/plugin-sdk/agents/tools/browser-tool.d.ts +5 -0
  401. package/dist/plugin-sdk/agents/tools/browser-tool.schema.d.ts +50 -0
  402. package/dist/plugin-sdk/agents/tools/canvas-tool.d.ts +2 -0
  403. package/dist/plugin-sdk/agents/tools/common.d.ts +52 -0
  404. package/dist/plugin-sdk/agents/tools/cron-tool.d.ts +6 -0
  405. package/dist/plugin-sdk/agents/tools/discord-actions-guild.d.ts +4 -0
  406. package/dist/plugin-sdk/agents/tools/discord-actions-messaging.d.ts +4 -0
  407. package/dist/plugin-sdk/agents/tools/discord-actions-moderation.d.ts +4 -0
  408. package/dist/plugin-sdk/agents/tools/discord-actions-presence.d.ts +4 -0
  409. package/dist/plugin-sdk/agents/tools/discord-actions.d.ts +3 -0
  410. package/dist/plugin-sdk/agents/tools/gateway-tool.d.ts +6 -0
  411. package/dist/plugin-sdk/agents/tools/gateway.d.ts +14 -0
  412. package/dist/plugin-sdk/agents/tools/image-tool.d.ts +26 -0
  413. package/dist/plugin-sdk/agents/tools/image-tool.helpers.d.ts +21 -0
  414. package/dist/plugin-sdk/agents/tools/memory-tool.d.ts +10 -0
  415. package/dist/plugin-sdk/agents/tools/message-tool.d.ts +18 -0
  416. package/dist/plugin-sdk/agents/tools/nodes-tool.d.ts +6 -0
  417. package/dist/plugin-sdk/agents/tools/nodes-utils.d.ts +20 -0
  418. package/dist/plugin-sdk/agents/tools/session-status-tool.d.ts +6 -0
  419. package/dist/plugin-sdk/agents/tools/sessions-announce-target.d.ts +5 -0
  420. package/dist/plugin-sdk/agents/tools/sessions-helpers.d.ts +90 -0
  421. package/dist/plugin-sdk/agents/tools/sessions-history-tool.d.ts +5 -0
  422. package/dist/plugin-sdk/agents/tools/sessions-list-tool.d.ts +5 -0
  423. package/dist/plugin-sdk/agents/tools/sessions-send-helpers.d.ts +34 -0
  424. package/dist/plugin-sdk/agents/tools/sessions-send-tool.a2a.d.ts +12 -0
  425. package/dist/plugin-sdk/agents/tools/sessions-send-tool.d.ts +7 -0
  426. package/dist/plugin-sdk/agents/tools/sessions-spawn-tool.d.ts +15 -0
  427. package/dist/plugin-sdk/agents/tools/slack-actions.d.ts +15 -0
  428. package/dist/plugin-sdk/agents/tools/telegram-actions.d.ts +9 -0
  429. package/dist/plugin-sdk/agents/tools/tts-tool.d.ts +7 -0
  430. package/dist/plugin-sdk/agents/tools/web-fetch-utils.d.ts +18 -0
  431. package/dist/plugin-sdk/agents/tools/web-fetch.d.ts +25 -0
  432. package/dist/plugin-sdk/agents/tools/web-search.d.ts +22 -0
  433. package/dist/plugin-sdk/agents/tools/web-shared.d.ts +17 -0
  434. package/dist/plugin-sdk/agents/tools/web-tools.d.ts +2 -0
  435. package/dist/plugin-sdk/agents/tools/whatsapp-actions.d.ts +3 -0
  436. package/dist/plugin-sdk/agents/transcript-policy.d.ts +23 -0
  437. package/dist/plugin-sdk/agents/usage.d.ts +35 -0
  438. package/dist/plugin-sdk/agents/venice-models.d.ts +238 -0
  439. package/dist/plugin-sdk/agents/workspace-run.d.ts +18 -0
  440. package/dist/plugin-sdk/agents/workspace-templates.d.ts +6 -0
  441. package/dist/plugin-sdk/agents/workspace.d.ts +33 -0
  442. package/dist/plugin-sdk/auto-reply/chunk.d.ts +45 -0
  443. package/dist/plugin-sdk/auto-reply/command-auth.d.ts +17 -0
  444. package/dist/plugin-sdk/auto-reply/command-detection.d.ts +13 -0
  445. package/dist/plugin-sdk/auto-reply/commands-args.d.ts +3 -0
  446. package/dist/plugin-sdk/auto-reply/commands-registry.d.ts +54 -0
  447. package/dist/plugin-sdk/auto-reply/commands-registry.data.d.ts +3 -0
  448. package/dist/plugin-sdk/auto-reply/commands-registry.types.d.ts +66 -0
  449. package/dist/plugin-sdk/auto-reply/dispatch.d.ts +27 -0
  450. package/dist/plugin-sdk/auto-reply/envelope.d.ts +59 -0
  451. package/dist/plugin-sdk/auto-reply/group-activation.d.ts +6 -0
  452. package/dist/plugin-sdk/auto-reply/heartbeat.d.ts +26 -0
  453. package/dist/plugin-sdk/auto-reply/inbound-debounce.d.ts +16 -0
  454. package/dist/plugin-sdk/auto-reply/media-note.d.ts +2 -0
  455. package/dist/plugin-sdk/auto-reply/model.d.ts +8 -0
  456. package/dist/plugin-sdk/auto-reply/reply/abort.d.ts +20 -0
  457. package/dist/plugin-sdk/auto-reply/reply/agent-runner-execution.d.ts +49 -0
  458. package/dist/plugin-sdk/auto-reply/reply/agent-runner-helpers.d.ts +17 -0
  459. package/dist/plugin-sdk/auto-reply/reply/agent-runner-memory.d.ts +20 -0
  460. package/dist/plugin-sdk/auto-reply/reply/agent-runner-payloads.d.ts +25 -0
  461. package/dist/plugin-sdk/auto-reply/reply/agent-runner-utils.d.ts +30 -0
  462. package/dist/plugin-sdk/auto-reply/reply/agent-runner.d.ts +38 -0
  463. package/dist/plugin-sdk/auto-reply/reply/bash-command.d.ts +19 -0
  464. package/dist/plugin-sdk/auto-reply/reply/block-reply-coalescer.d.ts +15 -0
  465. package/dist/plugin-sdk/auto-reply/reply/block-reply-pipeline.d.ts +31 -0
  466. package/dist/plugin-sdk/auto-reply/reply/block-streaming.d.ts +22 -0
  467. package/dist/plugin-sdk/auto-reply/reply/body.d.ts +11 -0
  468. package/dist/plugin-sdk/auto-reply/reply/commands-allowlist.d.ts +2 -0
  469. package/dist/plugin-sdk/auto-reply/reply/commands-approve.d.ts +2 -0
  470. package/dist/plugin-sdk/auto-reply/reply/commands-bash.d.ts +2 -0
  471. package/dist/plugin-sdk/auto-reply/reply/commands-compact.d.ts +2 -0
  472. package/dist/plugin-sdk/auto-reply/reply/commands-config.d.ts +3 -0
  473. package/dist/plugin-sdk/auto-reply/reply/commands-context-report.d.ts +3 -0
  474. package/dist/plugin-sdk/auto-reply/reply/commands-context.d.ts +12 -0
  475. package/dist/plugin-sdk/auto-reply/reply/commands-core.d.ts +2 -0
  476. package/dist/plugin-sdk/auto-reply/reply/commands-info.d.ts +10 -0
  477. package/dist/plugin-sdk/auto-reply/reply/commands-models.d.ts +23 -0
  478. package/dist/plugin-sdk/auto-reply/reply/commands-plugin.d.ts +13 -0
  479. package/dist/plugin-sdk/auto-reply/reply/commands-session.d.ts +7 -0
  480. package/dist/plugin-sdk/auto-reply/reply/commands-status.d.ts +24 -0
  481. package/dist/plugin-sdk/auto-reply/reply/commands-subagents.d.ts +13 -0
  482. package/dist/plugin-sdk/auto-reply/reply/commands-tts.d.ts +2 -0
  483. package/dist/plugin-sdk/auto-reply/reply/commands-types.d.ts +60 -0
  484. package/dist/plugin-sdk/auto-reply/reply/commands.d.ts +4 -0
  485. package/dist/plugin-sdk/auto-reply/reply/config-commands.d.ts +15 -0
  486. package/dist/plugin-sdk/auto-reply/reply/config-value.d.ts +4 -0
  487. package/dist/plugin-sdk/auto-reply/reply/debug-commands.d.ts +16 -0
  488. package/dist/plugin-sdk/auto-reply/reply/directive-handling.auth.d.ts +19 -0
  489. package/dist/plugin-sdk/auto-reply/reply/directive-handling.d.ts +6 -0
  490. package/dist/plugin-sdk/auto-reply/reply/directive-handling.fast-lane.d.ts +47 -0
  491. package/dist/plugin-sdk/auto-reply/reply/directive-handling.impl.d.ts +36 -0
  492. package/dist/plugin-sdk/auto-reply/reply/directive-handling.model-picker.d.ts +13 -0
  493. package/dist/plugin-sdk/auto-reply/reply/directive-handling.model.d.ts +42 -0
  494. package/dist/plugin-sdk/auto-reply/reply/directive-handling.parse.d.ts +62 -0
  495. package/dist/plugin-sdk/auto-reply/reply/directive-handling.persist.d.ts +37 -0
  496. package/dist/plugin-sdk/auto-reply/reply/directive-handling.queue-validation.d.ts +10 -0
  497. package/dist/plugin-sdk/auto-reply/reply/directive-handling.shared.d.ts +16 -0
  498. package/dist/plugin-sdk/auto-reply/reply/directives.d.ts +38 -0
  499. package/dist/plugin-sdk/auto-reply/reply/dispatch-from-config.d.ts +16 -0
  500. package/dist/plugin-sdk/auto-reply/reply/exec/directive.d.ts +20 -0
  501. package/dist/plugin-sdk/auto-reply/reply/exec.d.ts +1 -0
  502. package/dist/plugin-sdk/auto-reply/reply/followup-runner.d.ts +16 -0
  503. package/dist/plugin-sdk/auto-reply/reply/get-reply-directives-apply.d.ts +64 -0
  504. package/dist/plugin-sdk/auto-reply/reply/get-reply-directives-utils.d.ts +2 -0
  505. package/dist/plugin-sdk/auto-reply/reply/get-reply-directives.d.ts +91 -0
  506. package/dist/plugin-sdk/auto-reply/reply/get-reply-inline-actions.d.ts +59 -0
  507. package/dist/plugin-sdk/auto-reply/reply/get-reply-run.d.ts +69 -0
  508. package/dist/plugin-sdk/auto-reply/reply/get-reply.d.ts +4 -0
  509. package/dist/plugin-sdk/auto-reply/reply/groups.d.ts +16 -0
  510. package/dist/plugin-sdk/auto-reply/reply/history.d.ts +72 -0
  511. package/dist/plugin-sdk/auto-reply/reply/inbound-context.d.ts +8 -0
  512. package/dist/plugin-sdk/auto-reply/reply/inbound-dedupe.d.ts +8 -0
  513. package/dist/plugin-sdk/auto-reply/reply/inbound-sender-meta.d.ts +5 -0
  514. package/dist/plugin-sdk/auto-reply/reply/inbound-text.d.ts +1 -0
  515. package/dist/plugin-sdk/auto-reply/reply/line-directives.d.ts +22 -0
  516. package/dist/plugin-sdk/auto-reply/reply/memory-flush.d.ts +23 -0
  517. package/dist/plugin-sdk/auto-reply/reply/mentions.d.ts +18 -0
  518. package/dist/plugin-sdk/auto-reply/reply/model-selection.d.ts +61 -0
  519. package/dist/plugin-sdk/auto-reply/reply/normalize-reply.d.ts +13 -0
  520. package/dist/plugin-sdk/auto-reply/reply/provider-dispatcher.d.ts +19 -0
  521. package/dist/plugin-sdk/auto-reply/reply/queue/cleanup.d.ts +6 -0
  522. package/dist/plugin-sdk/auto-reply/reply/queue/directive.d.ts +15 -0
  523. package/dist/plugin-sdk/auto-reply/reply/queue/drain.d.ts +2 -0
  524. package/dist/plugin-sdk/auto-reply/reply/queue/enqueue.d.ts +3 -0
  525. package/dist/plugin-sdk/auto-reply/reply/queue/normalize.d.ts +3 -0
  526. package/dist/plugin-sdk/auto-reply/reply/queue/settings.d.ts +2 -0
  527. package/dist/plugin-sdk/auto-reply/reply/queue/state.d.ts +19 -0
  528. package/dist/plugin-sdk/auto-reply/reply/queue/types.d.ts +84 -0
  529. package/dist/plugin-sdk/auto-reply/reply/queue.d.ts +8 -0
  530. package/dist/plugin-sdk/auto-reply/reply/reply-directives.d.ts +14 -0
  531. package/dist/plugin-sdk/auto-reply/reply/reply-dispatcher.d.ts +51 -0
  532. package/dist/plugin-sdk/auto-reply/reply/reply-elevated.d.ts +23 -0
  533. package/dist/plugin-sdk/auto-reply/reply/reply-inline.d.ts +8 -0
  534. package/dist/plugin-sdk/auto-reply/reply/reply-payloads.d.ts +22 -0
  535. package/dist/plugin-sdk/auto-reply/reply/reply-reference.d.ts +20 -0
  536. package/dist/plugin-sdk/auto-reply/reply/reply-tags.d.ts +6 -0
  537. package/dist/plugin-sdk/auto-reply/reply/reply-threading.d.ts +9 -0
  538. package/dist/plugin-sdk/auto-reply/reply/response-prefix-template.d.ts +51 -0
  539. package/dist/plugin-sdk/auto-reply/reply/route-reply.d.ts +56 -0
  540. package/dist/plugin-sdk/auto-reply/reply/session-reset-model.d.ts +24 -0
  541. package/dist/plugin-sdk/auto-reply/reply/session-updates.d.ts +34 -0
  542. package/dist/plugin-sdk/auto-reply/reply/session-usage.d.ts +13 -0
  543. package/dist/plugin-sdk/auto-reply/reply/session.d.ts +26 -0
  544. package/dist/plugin-sdk/auto-reply/reply/stage-sandbox-media.d.ts +9 -0
  545. package/dist/plugin-sdk/auto-reply/reply/streaming-directives.d.ts +10 -0
  546. package/dist/plugin-sdk/auto-reply/reply/subagents-utils.d.ts +9 -0
  547. package/dist/plugin-sdk/auto-reply/reply/typing-mode.d.ts +27 -0
  548. package/dist/plugin-sdk/auto-reply/reply/typing.d.ts +18 -0
  549. package/dist/plugin-sdk/auto-reply/reply/untrusted-context.d.ts +1 -0
  550. package/dist/plugin-sdk/auto-reply/reply.d.ts +6 -0
  551. package/dist/plugin-sdk/auto-reply/send-policy.d.ts +6 -0
  552. package/dist/plugin-sdk/auto-reply/skill-commands.d.ts +18 -0
  553. package/dist/plugin-sdk/auto-reply/status.d.ts +53 -0
  554. package/dist/plugin-sdk/auto-reply/templating.d.ts +140 -0
  555. package/dist/plugin-sdk/auto-reply/thinking.d.ts +22 -0
  556. package/dist/plugin-sdk/auto-reply/tokens.d.ts +3 -0
  557. package/dist/plugin-sdk/auto-reply/tool-meta.d.ts +8 -0
  558. package/dist/plugin-sdk/auto-reply/types.d.ts +57 -0
  559. package/dist/plugin-sdk/browser/bridge-server.d.ts +17 -0
  560. package/dist/plugin-sdk/browser/cdp.d.ts +123 -0
  561. package/dist/plugin-sdk/browser/cdp.helpers.d.ts +11 -0
  562. package/dist/plugin-sdk/browser/chrome.d.ts +20 -0
  563. package/dist/plugin-sdk/browser/chrome.executables.d.ts +9 -0
  564. package/dist/plugin-sdk/browser/chrome.profile-decoration.d.ts +10 -0
  565. package/dist/plugin-sdk/browser/client-actions-core.d.ts +143 -0
  566. package/dist/plugin-sdk/browser/client-actions-observe.d.ts +68 -0
  567. package/dist/plugin-sdk/browser/client-actions-state.d.ts +90 -0
  568. package/dist/plugin-sdk/browser/client-actions-types.d.ts +18 -0
  569. package/dist/plugin-sdk/browser/client-actions.d.ts +4 -0
  570. package/dist/plugin-sdk/browser/client-fetch.d.ts +3 -0
  571. package/dist/plugin-sdk/browser/client.d.ts +147 -0
  572. package/dist/plugin-sdk/browser/config.d.ts +39 -0
  573. package/dist/plugin-sdk/browser/constants.d.ts +8 -0
  574. package/dist/plugin-sdk/browser/control-service.d.ts +5 -0
  575. package/dist/plugin-sdk/browser/extension-relay.d.ts +15 -0
  576. package/dist/plugin-sdk/browser/profiles-service.d.ts +25 -0
  577. package/dist/plugin-sdk/browser/profiles.d.ts +30 -0
  578. package/dist/plugin-sdk/browser/pw-ai-module.d.ts +6 -0
  579. package/dist/plugin-sdk/browser/pw-ai.d.ts +2 -0
  580. package/dist/plugin-sdk/browser/pw-role-snapshot.d.ts +35 -0
  581. package/dist/plugin-sdk/browser/pw-session.d.ts +135 -0
  582. package/dist/plugin-sdk/browser/pw-tools-core.activity.d.ts +21 -0
  583. package/dist/plugin-sdk/browser/pw-tools-core.d.ts +8 -0
  584. package/dist/plugin-sdk/browser/pw-tools-core.downloads.d.ts +34 -0
  585. package/dist/plugin-sdk/browser/pw-tools-core.interactions.d.ts +112 -0
  586. package/dist/plugin-sdk/browser/pw-tools-core.responses.d.ts +13 -0
  587. package/dist/plugin-sdk/browser/pw-tools-core.shared.d.ts +6 -0
  588. package/dist/plugin-sdk/browser/pw-tools-core.snapshot.d.ts +64 -0
  589. package/dist/plugin-sdk/browser/pw-tools-core.state.d.ts +46 -0
  590. package/dist/plugin-sdk/browser/pw-tools-core.storage.d.ts +47 -0
  591. package/dist/plugin-sdk/browser/pw-tools-core.trace.d.ts +12 -0
  592. package/dist/plugin-sdk/browser/routes/agent.act.d.ts +3 -0
  593. package/dist/plugin-sdk/browser/routes/agent.act.shared.d.ts +10 -0
  594. package/dist/plugin-sdk/browser/routes/agent.d.ts +3 -0
  595. package/dist/plugin-sdk/browser/routes/agent.debug.d.ts +3 -0
  596. package/dist/plugin-sdk/browser/routes/agent.shared.d.ts +9 -0
  597. package/dist/plugin-sdk/browser/routes/agent.snapshot.d.ts +3 -0
  598. package/dist/plugin-sdk/browser/routes/agent.storage.d.ts +3 -0
  599. package/dist/plugin-sdk/browser/routes/basic.d.ts +3 -0
  600. package/dist/plugin-sdk/browser/routes/dispatcher.d.ts +15 -0
  601. package/dist/plugin-sdk/browser/routes/index.d.ts +3 -0
  602. package/dist/plugin-sdk/browser/routes/tabs.d.ts +3 -0
  603. package/dist/plugin-sdk/browser/routes/types.d.ts +15 -0
  604. package/dist/plugin-sdk/browser/routes/utils.d.ts +15 -0
  605. package/dist/plugin-sdk/browser/screenshot.d.ts +9 -0
  606. package/dist/plugin-sdk/browser/server-context.d.ts +3 -0
  607. package/dist/plugin-sdk/browser/server-context.types.d.ts +78 -0
  608. package/dist/plugin-sdk/browser/target-id.d.ts +11 -0
  609. package/dist/plugin-sdk/browser/trash.d.ts +1 -0
  610. package/dist/plugin-sdk/channel-web.d.ts +6 -0
  611. package/dist/plugin-sdk/channels/ack-reactions.d.ts +29 -0
  612. package/dist/plugin-sdk/channels/allowlist-match.d.ts +10 -0
  613. package/dist/plugin-sdk/channels/allowlists/resolve-utils.d.ts +6 -0
  614. package/dist/plugin-sdk/channels/channel-config.d.ts +39 -0
  615. package/dist/plugin-sdk/channels/chat-type.d.ts +2 -0
  616. package/dist/plugin-sdk/channels/command-gating.d.ts +20 -0
  617. package/dist/plugin-sdk/channels/conversation-label.d.ts +2 -0
  618. package/dist/plugin-sdk/channels/dock.d.ts +36 -0
  619. package/dist/plugin-sdk/channels/location.d.ts +21 -0
  620. package/dist/plugin-sdk/channels/logging.d.ts +20 -0
  621. package/dist/plugin-sdk/channels/mention-gating.d.ts +27 -0
  622. package/dist/plugin-sdk/channels/plugins/actions/discord/handle-action.d.ts +3 -0
  623. package/dist/plugin-sdk/channels/plugins/actions/discord/handle-action.guild-admin.d.ts +9 -0
  624. package/dist/plugin-sdk/channels/plugins/actions/discord.d.ts +2 -0
  625. package/dist/plugin-sdk/channels/plugins/actions/signal.d.ts +2 -0
  626. package/dist/plugin-sdk/channels/plugins/actions/telegram.d.ts +2 -0
  627. package/dist/plugin-sdk/channels/plugins/agent-tools/whatsapp-login.d.ts +2 -0
  628. package/dist/plugin-sdk/channels/plugins/allowlist-match.d.ts +2 -0
  629. package/dist/plugin-sdk/channels/plugins/bluebubbles-actions.d.ts +48 -0
  630. package/dist/plugin-sdk/channels/plugins/channel-config.d.ts +2 -0
  631. package/dist/plugin-sdk/channels/plugins/config-helpers.d.ts +14 -0
  632. package/dist/plugin-sdk/channels/plugins/config-schema.d.ts +3 -0
  633. package/dist/plugin-sdk/channels/plugins/config-writes.d.ts +7 -0
  634. package/dist/plugin-sdk/channels/plugins/directory-config.d.ts +16 -0
  635. package/dist/plugin-sdk/channels/plugins/group-mentions.d.ts +28 -0
  636. package/dist/plugin-sdk/channels/plugins/helpers.d.ts +8 -0
  637. package/dist/plugin-sdk/channels/plugins/index.d.ts +8 -0
  638. package/dist/plugin-sdk/channels/plugins/media-limits.d.ts +9 -0
  639. package/dist/plugin-sdk/channels/plugins/message-action-names.d.ts +2 -0
  640. package/dist/plugin-sdk/channels/plugins/message-actions.d.ts +7 -0
  641. package/dist/plugin-sdk/channels/plugins/normalize/discord.d.ts +2 -0
  642. package/dist/plugin-sdk/channels/plugins/normalize/imessage.d.ts +2 -0
  643. package/dist/plugin-sdk/channels/plugins/normalize/signal.d.ts +2 -0
  644. package/dist/plugin-sdk/channels/plugins/normalize/slack.d.ts +2 -0
  645. package/dist/plugin-sdk/channels/plugins/normalize/telegram.d.ts +2 -0
  646. package/dist/plugin-sdk/channels/plugins/normalize/whatsapp.d.ts +2 -0
  647. package/dist/plugin-sdk/channels/plugins/onboarding/channel-access.d.ts +31 -0
  648. package/dist/plugin-sdk/channels/plugins/onboarding/discord.d.ts +2 -0
  649. package/dist/plugin-sdk/channels/plugins/onboarding/helpers.d.ts +3 -0
  650. package/dist/plugin-sdk/channels/plugins/onboarding/imessage.d.ts +2 -0
  651. package/dist/plugin-sdk/channels/plugins/onboarding/signal.d.ts +2 -0
  652. package/dist/plugin-sdk/channels/plugins/onboarding/slack.d.ts +2 -0
  653. package/dist/plugin-sdk/channels/plugins/onboarding/telegram.d.ts +2 -0
  654. package/dist/plugin-sdk/channels/plugins/onboarding/whatsapp.d.ts +2 -0
  655. package/dist/plugin-sdk/channels/plugins/onboarding-types.d.ts +77 -0
  656. package/dist/plugin-sdk/channels/plugins/outbound/load.d.ts +2 -0
  657. package/dist/plugin-sdk/channels/plugins/pairing-message.d.ts +1 -0
  658. package/dist/plugin-sdk/channels/plugins/pairing.d.ts +16 -0
  659. package/dist/plugin-sdk/channels/plugins/setup-helpers.d.ts +13 -0
  660. package/dist/plugin-sdk/channels/plugins/status-issues/bluebubbles.d.ts +2 -0
  661. package/dist/plugin-sdk/channels/plugins/status-issues/discord.d.ts +2 -0
  662. package/dist/plugin-sdk/channels/plugins/status-issues/shared.d.ts +10 -0
  663. package/dist/plugin-sdk/channels/plugins/status-issues/telegram.d.ts +2 -0
  664. package/dist/plugin-sdk/channels/plugins/status-issues/whatsapp.d.ts +2 -0
  665. package/dist/plugin-sdk/channels/plugins/types.adapters.d.ts +294 -0
  666. package/dist/plugin-sdk/channels/plugins/types.core.d.ts +311 -0
  667. package/dist/plugin-sdk/channels/plugins/types.d.ts +6 -0
  668. package/dist/plugin-sdk/channels/plugins/types.plugin.d.ts +53 -0
  669. package/dist/plugin-sdk/channels/plugins/whatsapp-heartbeat.d.ts +11 -0
  670. package/dist/plugin-sdk/channels/registry.d.ts +16 -0
  671. package/dist/plugin-sdk/channels/reply-prefix.d.ts +24 -0
  672. package/dist/plugin-sdk/channels/sender-label.d.ts +9 -0
  673. package/dist/plugin-sdk/channels/session.d.ts +18 -0
  674. package/dist/plugin-sdk/channels/targets.d.ts +25 -0
  675. package/dist/plugin-sdk/channels/typing.d.ts +12 -0
  676. package/dist/plugin-sdk/channels/web/index.d.ts +1 -0
  677. package/dist/plugin-sdk/cli/cli-name.d.ts +3 -0
  678. package/dist/plugin-sdk/cli/cli-utils.d.ts +18 -0
  679. package/dist/plugin-sdk/cli/command-format.d.ts +1 -0
  680. package/dist/plugin-sdk/cli/deps.d.ts +18 -0
  681. package/dist/plugin-sdk/cli/memory-cli.d.ts +12 -0
  682. package/dist/plugin-sdk/cli/nodes-camera.d.ts +26 -0
  683. package/dist/plugin-sdk/cli/nodes-canvas.d.ts +10 -0
  684. package/dist/plugin-sdk/cli/nodes-run.d.ts +3 -0
  685. package/dist/plugin-sdk/cli/nodes-screen.d.ts +18 -0
  686. package/dist/plugin-sdk/cli/parse-duration.d.ts +4 -0
  687. package/dist/plugin-sdk/cli/parse-timeout.d.ts +1 -0
  688. package/dist/plugin-sdk/cli/profile-utils.d.ts +2 -0
  689. package/dist/plugin-sdk/cli/progress.d.ts +24 -0
  690. package/dist/plugin-sdk/cli/wait.d.ts +1 -0
  691. package/dist/plugin-sdk/commands/agent/types.d.ts +75 -0
  692. package/dist/plugin-sdk/commands/daemon-runtime.d.ts +8 -0
  693. package/dist/plugin-sdk/commands/health.d.ts +63 -0
  694. package/dist/plugin-sdk/commands/oauth-flow.d.ts +21 -0
  695. package/dist/plugin-sdk/commands/onboard-helpers.d.ts +81 -0
  696. package/dist/plugin-sdk/commands/onboard-types.d.ts +67 -0
  697. package/dist/plugin-sdk/commands/signal-install.d.ts +8 -0
  698. package/dist/plugin-sdk/compat/legacy-names.d.ts +8 -0
  699. package/dist/plugin-sdk/config/agent-dirs.d.ts +14 -0
  700. package/dist/plugin-sdk/config/agent-limits.d.ts +5 -0
  701. package/dist/plugin-sdk/config/cache-utils.d.ts +6 -0
  702. package/dist/plugin-sdk/config/channel-capabilities.d.ts +6 -0
  703. package/dist/plugin-sdk/config/commands.d.ts +16 -0
  704. package/dist/plugin-sdk/config/config-paths.d.ts +10 -0
  705. package/dist/plugin-sdk/config/config.d.ts +7 -0
  706. package/dist/plugin-sdk/config/defaults.d.ts +18 -0
  707. package/dist/plugin-sdk/config/env-substitution.d.ts +35 -0
  708. package/dist/plugin-sdk/config/env-vars.d.ts +2 -0
  709. package/dist/plugin-sdk/config/group-policy.d.ts +44 -0
  710. package/dist/plugin-sdk/config/includes.d.ts +32 -0
  711. package/dist/plugin-sdk/config/io.d.ts +36 -0
  712. package/dist/plugin-sdk/config/legacy-migrate.d.ts +5 -0
  713. package/dist/plugin-sdk/config/legacy.d.ts +6 -0
  714. package/dist/plugin-sdk/config/legacy.migrations.d.ts +1 -0
  715. package/dist/plugin-sdk/config/legacy.migrations.part-1.d.ts +2 -0
  716. package/dist/plugin-sdk/config/legacy.migrations.part-2.d.ts +2 -0
  717. package/dist/plugin-sdk/config/legacy.migrations.part-3.d.ts +2 -0
  718. package/dist/plugin-sdk/config/legacy.rules.d.ts +2 -0
  719. package/dist/plugin-sdk/config/legacy.shared.d.ts +18 -0
  720. package/dist/plugin-sdk/config/markdown-tables.d.ts +7 -0
  721. package/dist/plugin-sdk/config/merge-config.d.ts +7 -0
  722. package/dist/plugin-sdk/config/normalize-paths.d.ts +8 -0
  723. package/dist/plugin-sdk/config/paths.d.ts +57 -0
  724. package/dist/plugin-sdk/config/port-defaults.d.ts +13 -0
  725. package/dist/plugin-sdk/config/runtime-overrides.d.ts +15 -0
  726. package/dist/plugin-sdk/config/sessions/group.d.ts +11 -0
  727. package/dist/plugin-sdk/config/sessions/main-session.d.ts +43 -0
  728. package/dist/plugin-sdk/config/sessions/metadata.d.ts +16 -0
  729. package/dist/plugin-sdk/config/sessions/paths.d.ts +11 -0
  730. package/dist/plugin-sdk/config/sessions/reset.d.ts +43 -0
  731. package/dist/plugin-sdk/config/sessions/session-key.d.ts +8 -0
  732. package/dist/plugin-sdk/config/sessions/store.d.ts +38 -0
  733. package/dist/plugin-sdk/config/sessions/transcript.d.ts +18 -0
  734. package/dist/plugin-sdk/config/sessions/types.d.ts +146 -0
  735. package/dist/plugin-sdk/config/sessions.d.ts +9 -0
  736. package/dist/plugin-sdk/config/talk.d.ts +11 -0
  737. package/dist/plugin-sdk/config/telegram-custom-commands.d.ts +24 -0
  738. package/dist/plugin-sdk/config/types.agent-defaults.d.ts +254 -0
  739. package/dist/plugin-sdk/config/types.agents.d.ts +77 -0
  740. package/dist/plugin-sdk/config/types.approvals.d.ts +26 -0
  741. package/dist/plugin-sdk/config/types.auth.d.ts +28 -0
  742. package/dist/plugin-sdk/config/types.base.d.ts +149 -0
  743. package/dist/plugin-sdk/config/types.browser.d.ts +41 -0
  744. package/dist/plugin-sdk/config/types.channels.d.ts +34 -0
  745. package/dist/plugin-sdk/config/types.cron.d.ts +5 -0
  746. package/dist/plugin-sdk/config/types.d.ts +29 -0
  747. package/dist/plugin-sdk/config/types.discord.d.ts +151 -0
  748. package/dist/plugin-sdk/config/types.gateway.d.ts +224 -0
  749. package/dist/plugin-sdk/config/types.googlechat.d.ts +100 -0
  750. package/dist/plugin-sdk/config/types.hooks.d.ts +106 -0
  751. package/dist/plugin-sdk/config/types.imessage.d.ts +71 -0
  752. package/dist/plugin-sdk/config/types.memory.d.ts +43 -0
  753. package/dist/plugin-sdk/config/types.messages.d.ts +106 -0
  754. package/dist/plugin-sdk/config/types.models.d.ts +47 -0
  755. package/dist/plugin-sdk/config/types.msteams.d.ts +101 -0
  756. package/dist/plugin-sdk/config/types.node-host.d.ts +10 -0
  757. package/dist/plugin-sdk/config/types.openclaw.d.ts +108 -0
  758. package/dist/plugin-sdk/config/types.plugins.d.ts +32 -0
  759. package/dist/plugin-sdk/config/types.queue.d.ts +13 -0
  760. package/dist/plugin-sdk/config/types.sandbox.d.ts +76 -0
  761. package/dist/plugin-sdk/config/types.signal.d.ts +86 -0
  762. package/dist/plugin-sdk/config/types.skills.d.ts +28 -0
  763. package/dist/plugin-sdk/config/types.slack.d.ts +138 -0
  764. package/dist/plugin-sdk/config/types.telegram.d.ts +160 -0
  765. package/dist/plugin-sdk/config/types.tools.d.ts +437 -0
  766. package/dist/plugin-sdk/config/types.tts.d.ts +78 -0
  767. package/dist/plugin-sdk/config/types.whatsapp.d.ts +157 -0
  768. package/dist/plugin-sdk/config/validation.d.ts +17 -0
  769. package/dist/plugin-sdk/config/version.d.ts +8 -0
  770. package/dist/plugin-sdk/config/zod-schema.agent-defaults.d.ts +245 -0
  771. package/dist/plugin-sdk/config/zod-schema.agent-runtime.d.ts +819 -0
  772. package/dist/plugin-sdk/config/zod-schema.agents.d.ts +493 -0
  773. package/dist/plugin-sdk/config/zod-schema.approvals.d.ts +15 -0
  774. package/dist/plugin-sdk/config/zod-schema.channels.d.ts +6 -0
  775. package/dist/plugin-sdk/config/zod-schema.core.d.ts +647 -0
  776. package/dist/plugin-sdk/config/zod-schema.d.ts +3085 -0
  777. package/dist/plugin-sdk/config/zod-schema.hooks.d.ts +78 -0
  778. package/dist/plugin-sdk/config/zod-schema.providers-core.d.ts +2761 -0
  779. package/dist/plugin-sdk/config/zod-schema.providers-whatsapp.d.ts +231 -0
  780. package/dist/plugin-sdk/config/zod-schema.providers.d.ts +1662 -0
  781. package/dist/plugin-sdk/config/zod-schema.session.d.ts +183 -0
  782. package/dist/plugin-sdk/cron/delivery.d.ts +9 -0
  783. package/dist/plugin-sdk/cron/normalize.d.ts +9 -0
  784. package/dist/plugin-sdk/cron/parse.d.ts +1 -0
  785. package/dist/plugin-sdk/cron/payload-migration.d.ts +3 -0
  786. package/dist/plugin-sdk/cron/schedule.d.ts +2 -0
  787. package/dist/plugin-sdk/cron/service/jobs.d.ts +13 -0
  788. package/dist/plugin-sdk/cron/service/locked.d.ts +2 -0
  789. package/dist/plugin-sdk/cron/service/normalize.d.ts +17 -0
  790. package/dist/plugin-sdk/cron/service/ops.d.ts +43 -0
  791. package/dist/plugin-sdk/cron/service/state.d.ts +96 -0
  792. package/dist/plugin-sdk/cron/service/store.d.ts +9 -0
  793. package/dist/plugin-sdk/cron/service/timer.d.ts +23 -0
  794. package/dist/plugin-sdk/cron/service.d.ts +48 -0
  795. package/dist/plugin-sdk/cron/store.d.ts +6 -0
  796. package/dist/plugin-sdk/cron/types.d.ts +93 -0
  797. package/dist/plugin-sdk/daemon/constants.d.ts +30 -0
  798. package/dist/plugin-sdk/discord/accounts.d.ts +17 -0
  799. package/dist/plugin-sdk/discord/api.d.ts +11 -0
  800. package/dist/plugin-sdk/discord/audit.d.ts +29 -0
  801. package/dist/plugin-sdk/discord/chunk.d.ts +20 -0
  802. package/dist/plugin-sdk/discord/directory-live.d.ts +4 -0
  803. package/dist/plugin-sdk/discord/gateway-logging.d.ts +8 -0
  804. package/dist/plugin-sdk/discord/monitor/allow-list.d.ts +137 -0
  805. package/dist/plugin-sdk/discord/monitor/exec-approvals.d.ts +70 -0
  806. package/dist/plugin-sdk/discord/monitor/format.d.ts +13 -0
  807. package/dist/plugin-sdk/discord/monitor/gateway-registry.d.ts +9 -0
  808. package/dist/plugin-sdk/discord/monitor/listeners.d.ts +49 -0
  809. package/dist/plugin-sdk/discord/monitor/message-handler.d.ts +26 -0
  810. package/dist/plugin-sdk/discord/monitor/message-handler.preflight.d.ts +3 -0
  811. package/dist/plugin-sdk/discord/monitor/message-handler.preflight.types.d.ts +86 -0
  812. package/dist/plugin-sdk/discord/monitor/message-handler.process.d.ts +2 -0
  813. package/dist/plugin-sdk/discord/monitor/message-utils.d.ts +31 -0
  814. package/dist/plugin-sdk/discord/monitor/native-command.d.ts +20 -0
  815. package/dist/plugin-sdk/discord/monitor/presence-cache.d.ts +9 -0
  816. package/dist/plugin-sdk/discord/monitor/provider.d.ts +13 -0
  817. package/dist/plugin-sdk/discord/monitor/reply-context.d.ts +13 -0
  818. package/dist/plugin-sdk/discord/monitor/reply-delivery.d.ts +18 -0
  819. package/dist/plugin-sdk/discord/monitor/sender-identity.d.ts +31 -0
  820. package/dist/plugin-sdk/discord/monitor/system-events.d.ts +2 -0
  821. package/dist/plugin-sdk/discord/monitor/threading.d.ts +101 -0
  822. package/dist/plugin-sdk/discord/monitor/typing.d.ts +5 -0
  823. package/dist/plugin-sdk/discord/monitor.d.ts +10 -0
  824. package/dist/plugin-sdk/discord/monitor.gateway.d.ts +12 -0
  825. package/dist/plugin-sdk/discord/pluralkit.d.ts +26 -0
  826. package/dist/plugin-sdk/discord/probe.d.ts +29 -0
  827. package/dist/plugin-sdk/discord/resolve-channels.d.ts +15 -0
  828. package/dist/plugin-sdk/discord/resolve-users.d.ts +14 -0
  829. package/dist/plugin-sdk/discord/send.channels.d.ts +17 -0
  830. package/dist/plugin-sdk/discord/send.d.ts +8 -0
  831. package/dist/plugin-sdk/discord/send.emojis-stickers.d.ts +4 -0
  832. package/dist/plugin-sdk/discord/send.guild.d.ts +24 -0
  833. package/dist/plugin-sdk/discord/send.messages.d.ts +18 -0
  834. package/dist/plugin-sdk/discord/send.outbound.d.ts +22 -0
  835. package/dist/plugin-sdk/discord/send.permissions.d.ts +4 -0
  836. package/dist/plugin-sdk/discord/send.reactions.d.ts +15 -0
  837. package/dist/plugin-sdk/discord/send.shared.d.ts +69 -0
  838. package/dist/plugin-sdk/discord/send.types.d.ts +130 -0
  839. package/dist/plugin-sdk/discord/targets.d.ts +18 -0
  840. package/dist/plugin-sdk/discord/token.d.ts +11 -0
  841. package/dist/plugin-sdk/gateway/call.d.ts +51 -0
  842. package/dist/plugin-sdk/gateway/chat-abort.d.ts +44 -0
  843. package/dist/plugin-sdk/gateway/chat-sanitize.d.ts +3 -0
  844. package/dist/plugin-sdk/gateway/client.d.ts +61 -0
  845. package/dist/plugin-sdk/gateway/control-ui-shared.d.ts +9 -0
  846. package/dist/plugin-sdk/gateway/device-auth.d.ts +12 -0
  847. package/dist/plugin-sdk/gateway/net.d.ts +40 -0
  848. package/dist/plugin-sdk/gateway/node-registry.d.ts +60 -0
  849. package/dist/plugin-sdk/gateway/protocol/client-info.d.ts +58 -0
  850. package/dist/plugin-sdk/gateway/protocol/index.d.ts +654 -0
  851. package/dist/plugin-sdk/gateway/protocol/schema/agent.d.ts +72 -0
  852. package/dist/plugin-sdk/gateway/protocol/schema/agents-models-skills.d.ts +152 -0
  853. package/dist/plugin-sdk/gateway/protocol/schema/channels.d.ts +105 -0
  854. package/dist/plugin-sdk/gateway/protocol/schema/config.d.ts +51 -0
  855. package/dist/plugin-sdk/gateway/protocol/schema/cron.d.ts +353 -0
  856. package/dist/plugin-sdk/gateway/protocol/schema/devices.d.ts +38 -0
  857. package/dist/plugin-sdk/gateway/protocol/schema/error-codes.d.ts +14 -0
  858. package/dist/plugin-sdk/gateway/protocol/schema/exec-approvals.d.ts +162 -0
  859. package/dist/plugin-sdk/gateway/protocol/schema/frames.d.ts +163 -0
  860. package/dist/plugin-sdk/gateway/protocol/schema/logs-chat.d.ts +45 -0
  861. package/dist/plugin-sdk/gateway/protocol/schema/nodes.d.ts +64 -0
  862. package/dist/plugin-sdk/gateway/protocol/schema/primitives.d.ts +4 -0
  863. package/dist/plugin-sdk/gateway/protocol/schema/protocol-schemas.d.ts +3 -0
  864. package/dist/plugin-sdk/gateway/protocol/schema/sessions.d.ts +74 -0
  865. package/dist/plugin-sdk/gateway/protocol/schema/snapshot.d.ts +63 -0
  866. package/dist/plugin-sdk/gateway/protocol/schema/types.d.ts +122 -0
  867. package/dist/plugin-sdk/gateway/protocol/schema/wizard.d.ts +86 -0
  868. package/dist/plugin-sdk/gateway/protocol/schema.d.ts +16 -0
  869. package/dist/plugin-sdk/gateway/server/ws-types.d.ts +9 -0
  870. package/dist/plugin-sdk/gateway/server-channels.d.ts +24 -0
  871. package/dist/plugin-sdk/gateway/server-methods/types.d.ts +96 -0
  872. package/dist/plugin-sdk/gateway/server-shared.d.ts +7 -0
  873. package/dist/plugin-sdk/gateway/session-utils.d.ts +53 -0
  874. package/dist/plugin-sdk/gateway/session-utils.fs.d.ts +11 -0
  875. package/dist/plugin-sdk/gateway/session-utils.types.d.ts +83 -0
  876. package/dist/plugin-sdk/globals.d.ts +11 -0
  877. package/dist/plugin-sdk/hooks/internal-hooks.d.ts +95 -0
  878. package/dist/plugin-sdk/hooks/types.d.ts +62 -0
  879. package/dist/plugin-sdk/imessage/accounts.d.ts +16 -0
  880. package/dist/plugin-sdk/imessage/client.d.ts +46 -0
  881. package/dist/plugin-sdk/imessage/constants.d.ts +2 -0
  882. package/dist/plugin-sdk/imessage/monitor/deliver.d.ts +17 -0
  883. package/dist/plugin-sdk/imessage/monitor/monitor-provider.d.ts +2 -0
  884. package/dist/plugin-sdk/imessage/monitor/runtime.d.ts +4 -0
  885. package/dist/plugin-sdk/imessage/monitor/types.d.ts +37 -0
  886. package/dist/plugin-sdk/imessage/monitor.d.ts +2 -0
  887. package/dist/plugin-sdk/imessage/probe.d.ts +18 -0
  888. package/dist/plugin-sdk/imessage/send.d.ts +18 -0
  889. package/dist/plugin-sdk/imessage/targets.d.ts +39 -0
  890. package/dist/plugin-sdk/index.d.ts +1 -0
  891. package/dist/plugin-sdk/index.js +24446 -0
  892. package/dist/plugin-sdk/infra/agent-events.d.ts +21 -0
  893. package/dist/plugin-sdk/infra/backoff.d.ts +8 -0
  894. package/dist/plugin-sdk/infra/channel-activity.d.ts +18 -0
  895. package/dist/plugin-sdk/infra/channel-summary.d.ts +7 -0
  896. package/dist/plugin-sdk/infra/dedupe.d.ts +11 -0
  897. package/dist/plugin-sdk/infra/device-auth-store.d.ts +23 -0
  898. package/dist/plugin-sdk/infra/device-identity.d.ts +11 -0
  899. package/dist/plugin-sdk/infra/diagnostic-events.d.ts +121 -0
  900. package/dist/plugin-sdk/infra/diagnostic-flags.d.ts +4 -0
  901. package/dist/plugin-sdk/infra/env.d.ts +11 -0
  902. package/dist/plugin-sdk/infra/errors.d.ts +3 -0
  903. package/dist/plugin-sdk/infra/exec-approvals.d.ts +155 -0
  904. package/dist/plugin-sdk/infra/exec-safety.d.ts +1 -0
  905. package/dist/plugin-sdk/infra/fetch.d.ts +2 -0
  906. package/dist/plugin-sdk/infra/format-duration.d.ts +10 -0
  907. package/dist/plugin-sdk/infra/git-commit.d.ts +4 -0
  908. package/dist/plugin-sdk/infra/heartbeat-events.d.ts +21 -0
  909. package/dist/plugin-sdk/infra/heartbeat-runner.d.ts +44 -0
  910. package/dist/plugin-sdk/infra/heartbeat-visibility.d.ts +17 -0
  911. package/dist/plugin-sdk/infra/heartbeat-wake.d.ts +20 -0
  912. package/dist/plugin-sdk/infra/json-file.d.ts +2 -0
  913. package/dist/plugin-sdk/infra/machine-name.d.ts +1 -0
  914. package/dist/plugin-sdk/infra/net/fetch-guard.d.ts +20 -0
  915. package/dist/plugin-sdk/infra/net/ssrf.d.ts +31 -0
  916. package/dist/plugin-sdk/infra/node-pairing.d.ts +62 -0
  917. package/dist/plugin-sdk/infra/node-shell.d.ts +1 -0
  918. package/dist/plugin-sdk/infra/openclaw-root.d.ts +10 -0
  919. package/dist/plugin-sdk/infra/outbound/channel-adapters.d.ts +6 -0
  920. package/dist/plugin-sdk/infra/outbound/channel-selection.d.ts +11 -0
  921. package/dist/plugin-sdk/infra/outbound/channel-target.d.ts +6 -0
  922. package/dist/plugin-sdk/infra/outbound/deliver.d.ts +69 -0
  923. package/dist/plugin-sdk/infra/outbound/directory-cache.d.ts +21 -0
  924. package/dist/plugin-sdk/infra/outbound/message-action-runner.d.ts +74 -0
  925. package/dist/plugin-sdk/infra/outbound/message-action-spec.d.ts +5 -0
  926. package/dist/plugin-sdk/infra/outbound/message.d.ts +76 -0
  927. package/dist/plugin-sdk/infra/outbound/outbound-policy.d.ts +31 -0
  928. package/dist/plugin-sdk/infra/outbound/outbound-send-service.d.ts +58 -0
  929. package/dist/plugin-sdk/infra/outbound/outbound-session.d.ts +31 -0
  930. package/dist/plugin-sdk/infra/outbound/payloads.d.ts +16 -0
  931. package/dist/plugin-sdk/infra/outbound/target-errors.d.ts +6 -0
  932. package/dist/plugin-sdk/infra/outbound/target-normalization.d.ts +4 -0
  933. package/dist/plugin-sdk/infra/outbound/target-resolver.d.ts +53 -0
  934. package/dist/plugin-sdk/infra/outbound/targets.d.ts +65 -0
  935. package/dist/plugin-sdk/infra/ports-format.d.ts +5 -0
  936. package/dist/plugin-sdk/infra/ports-inspect.d.ts +2 -0
  937. package/dist/plugin-sdk/infra/ports-lsof.d.ts +2 -0
  938. package/dist/plugin-sdk/infra/ports-types.d.ts +17 -0
  939. package/dist/plugin-sdk/infra/ports.d.ts +14 -0
  940. package/dist/plugin-sdk/infra/provider-usage.auth.d.ts +11 -0
  941. package/dist/plugin-sdk/infra/provider-usage.d.ts +4 -0
  942. package/dist/plugin-sdk/infra/provider-usage.fetch.antigravity.d.ts +2 -0
  943. package/dist/plugin-sdk/infra/provider-usage.fetch.claude.d.ts +2 -0
  944. package/dist/plugin-sdk/infra/provider-usage.fetch.codex.d.ts +2 -0
  945. package/dist/plugin-sdk/infra/provider-usage.fetch.copilot.d.ts +2 -0
  946. package/dist/plugin-sdk/infra/provider-usage.fetch.d.ts +7 -0
  947. package/dist/plugin-sdk/infra/provider-usage.fetch.gemini.d.ts +2 -0
  948. package/dist/plugin-sdk/infra/provider-usage.fetch.minimax.d.ts +2 -0
  949. package/dist/plugin-sdk/infra/provider-usage.fetch.shared.d.ts +1 -0
  950. package/dist/plugin-sdk/infra/provider-usage.fetch.zai.d.ts +2 -0
  951. package/dist/plugin-sdk/infra/provider-usage.format.d.ts +13 -0
  952. package/dist/plugin-sdk/infra/provider-usage.load.d.ts +12 -0
  953. package/dist/plugin-sdk/infra/provider-usage.shared.d.ts +8 -0
  954. package/dist/plugin-sdk/infra/provider-usage.types.d.ts +17 -0
  955. package/dist/plugin-sdk/infra/restart-sentinel.d.ts +50 -0
  956. package/dist/plugin-sdk/infra/restart.d.ts +28 -0
  957. package/dist/plugin-sdk/infra/retry-policy.d.ts +25 -0
  958. package/dist/plugin-sdk/infra/retry.d.ts +21 -0
  959. package/dist/plugin-sdk/infra/session-cost-usage.d.ts +160 -0
  960. package/dist/plugin-sdk/infra/shell-env.d.ts +33 -0
  961. package/dist/plugin-sdk/infra/skills-remote.d.ts +24 -0
  962. package/dist/plugin-sdk/infra/system-events.d.ts +16 -0
  963. package/dist/plugin-sdk/infra/tailnet.d.ts +7 -0
  964. package/dist/plugin-sdk/infra/tls/fingerprint.d.ts +1 -0
  965. package/dist/plugin-sdk/infra/tls/gateway.d.ts +16 -0
  966. package/dist/plugin-sdk/infra/transport-ready.d.ts +16 -0
  967. package/dist/plugin-sdk/infra/unhandled-rejections.d.ts +15 -0
  968. package/dist/plugin-sdk/infra/warnings.d.ts +1 -0
  969. package/dist/plugin-sdk/infra/ws.d.ts +2 -0
  970. package/dist/plugin-sdk/infra/wsl.d.ts +2 -0
  971. package/dist/plugin-sdk/line/accounts.d.ts +10 -0
  972. package/dist/plugin-sdk/line/auto-reply-delivery.d.ts +49 -0
  973. package/dist/plugin-sdk/line/bot-access.d.ts +15 -0
  974. package/dist/plugin-sdk/line/bot-handlers.d.ts +13 -0
  975. package/dist/plugin-sdk/line/bot-message-context.d.ts +102 -0
  976. package/dist/plugin-sdk/line/bot.d.ts +24 -0
  977. package/dist/plugin-sdk/line/config-schema.d.ts +64 -0
  978. package/dist/plugin-sdk/line/download.d.ts +7 -0
  979. package/dist/plugin-sdk/line/flex-templates.d.ts +195 -0
  980. package/dist/plugin-sdk/line/markdown-to-line.d.ts +72 -0
  981. package/dist/plugin-sdk/line/monitor.d.ts +28 -0
  982. package/dist/plugin-sdk/line/probe.d.ts +2 -0
  983. package/dist/plugin-sdk/line/reply-chunks.d.ts +24 -0
  984. package/dist/plugin-sdk/line/send.d.ts +118 -0
  985. package/dist/plugin-sdk/line/signature.d.ts +1 -0
  986. package/dist/plugin-sdk/line/template-messages.d.ts +119 -0
  987. package/dist/plugin-sdk/line/types.d.ts +125 -0
  988. package/dist/plugin-sdk/line/webhook.d.ts +19 -0
  989. package/dist/plugin-sdk/link-understanding/apply.d.ts +10 -0
  990. package/dist/plugin-sdk/link-understanding/defaults.d.ts +2 -0
  991. package/dist/plugin-sdk/link-understanding/detect.d.ts +3 -0
  992. package/dist/plugin-sdk/link-understanding/format.d.ts +4 -0
  993. package/dist/plugin-sdk/link-understanding/runner.d.ts +11 -0
  994. package/dist/plugin-sdk/logger.d.ts +6 -0
  995. package/dist/plugin-sdk/logging/config.d.ts +4 -0
  996. package/dist/plugin-sdk/logging/console.d.ts +19 -0
  997. package/dist/plugin-sdk/logging/diagnostic.d.ts +58 -0
  998. package/dist/plugin-sdk/logging/levels.d.ts +4 -0
  999. package/dist/plugin-sdk/logging/logger.d.ts +42 -0
  1000. package/dist/plugin-sdk/logging/redact-identifier.d.ts +4 -0
  1001. package/dist/plugin-sdk/logging/redact.d.ts +9 -0
  1002. package/dist/plugin-sdk/logging/state.d.ts +17 -0
  1003. package/dist/plugin-sdk/logging/subsystem.d.ts +16 -0
  1004. package/dist/plugin-sdk/logging.d.ts +10 -0
  1005. package/dist/plugin-sdk/markdown/code-spans.d.ts +10 -0
  1006. package/dist/plugin-sdk/markdown/fences.d.ts +10 -0
  1007. package/dist/plugin-sdk/markdown/frontmatter.d.ts +2 -0
  1008. package/dist/plugin-sdk/markdown/ir.d.ts +32 -0
  1009. package/dist/plugin-sdk/markdown/render.d.ts +18 -0
  1010. package/dist/plugin-sdk/markdown/tables.d.ts +2 -0
  1011. package/dist/plugin-sdk/media/audio-tags.d.ts +10 -0
  1012. package/dist/plugin-sdk/media/audio.d.ts +4 -0
  1013. package/dist/plugin-sdk/media/constants.d.ts +7 -0
  1014. package/dist/plugin-sdk/media/fetch.d.ts +23 -0
  1015. package/dist/plugin-sdk/media/image-ops.d.ts +39 -0
  1016. package/dist/plugin-sdk/media/input-files.d.ts +76 -0
  1017. package/dist/plugin-sdk/media/mime.d.ts +15 -0
  1018. package/dist/plugin-sdk/media/parse.d.ts +8 -0
  1019. package/dist/plugin-sdk/media/store.d.ts +18 -0
  1020. package/dist/plugin-sdk/media-understanding/apply.d.ts +19 -0
  1021. package/dist/plugin-sdk/media-understanding/attachments.d.ts +43 -0
  1022. package/dist/plugin-sdk/media-understanding/concurrency.d.ts +1 -0
  1023. package/dist/plugin-sdk/media-understanding/defaults.d.ts +10 -0
  1024. package/dist/plugin-sdk/media-understanding/errors.d.ts +6 -0
  1025. package/dist/plugin-sdk/media-understanding/format.d.ts +7 -0
  1026. package/dist/plugin-sdk/media-understanding/providers/anthropic/index.d.ts +2 -0
  1027. package/dist/plugin-sdk/media-understanding/providers/deepgram/audio.d.ts +4 -0
  1028. package/dist/plugin-sdk/media-understanding/providers/deepgram/index.d.ts +2 -0
  1029. package/dist/plugin-sdk/media-understanding/providers/google/audio.d.ts +3 -0
  1030. package/dist/plugin-sdk/media-understanding/providers/google/index.d.ts +2 -0
  1031. package/dist/plugin-sdk/media-understanding/providers/google/video.d.ts +3 -0
  1032. package/dist/plugin-sdk/media-understanding/providers/groq/index.d.ts +2 -0
  1033. package/dist/plugin-sdk/media-understanding/providers/image.d.ts +2 -0
  1034. package/dist/plugin-sdk/media-understanding/providers/index.d.ts +4 -0
  1035. package/dist/plugin-sdk/media-understanding/providers/minimax/index.d.ts +2 -0
  1036. package/dist/plugin-sdk/media-understanding/providers/openai/audio.d.ts +3 -0
  1037. package/dist/plugin-sdk/media-understanding/providers/openai/index.d.ts +2 -0
  1038. package/dist/plugin-sdk/media-understanding/providers/shared.d.ts +10 -0
  1039. package/dist/plugin-sdk/media-understanding/resolve.d.ts +44 -0
  1040. package/dist/plugin-sdk/media-understanding/runner.d.ts +34 -0
  1041. package/dist/plugin-sdk/media-understanding/scope.d.ts +9 -0
  1042. package/dist/plugin-sdk/media-understanding/types.d.ts +92 -0
  1043. package/dist/plugin-sdk/media-understanding/video.d.ts +2 -0
  1044. package/dist/plugin-sdk/memory/backend-config.d.ts +48 -0
  1045. package/dist/plugin-sdk/memory/batch-gemini.d.ts +55 -0
  1046. package/dist/plugin-sdk/memory/batch-openai.d.ts +45 -0
  1047. package/dist/plugin-sdk/memory/batch-voyage.d.ts +46 -0
  1048. package/dist/plugin-sdk/memory/embeddings-gemini.d.ts +13 -0
  1049. package/dist/plugin-sdk/memory/embeddings-openai.d.ts +13 -0
  1050. package/dist/plugin-sdk/memory/embeddings-voyage.d.ts +13 -0
  1051. package/dist/plugin-sdk/memory/embeddings.d.ts +39 -0
  1052. package/dist/plugin-sdk/memory/hybrid.d.ts +34 -0
  1053. package/dist/plugin-sdk/memory/index.d.ts +3 -0
  1054. package/dist/plugin-sdk/memory/internal.d.ts +27 -0
  1055. package/dist/plugin-sdk/memory/manager-search.d.ts +60 -0
  1056. package/dist/plugin-sdk/memory/manager.d.ts +136 -0
  1057. package/dist/plugin-sdk/memory/memory-schema.d.ts +10 -0
  1058. package/dist/plugin-sdk/memory/node-llama.d.ts +8 -0
  1059. package/dist/plugin-sdk/memory/qmd-manager.d.ts +85 -0
  1060. package/dist/plugin-sdk/memory/search-manager.d.ts +10 -0
  1061. package/dist/plugin-sdk/memory/session-files.d.ts +12 -0
  1062. package/dist/plugin-sdk/memory/sqlite-vec.d.ts +9 -0
  1063. package/dist/plugin-sdk/memory/sqlite.d.ts +1 -0
  1064. package/dist/plugin-sdk/memory/types.d.ts +94 -0
  1065. package/dist/plugin-sdk/pairing/pairing-labels.d.ts +2 -0
  1066. package/dist/plugin-sdk/pairing/pairing-messages.d.ts +6 -0
  1067. package/dist/plugin-sdk/pairing/pairing-store.d.ts +46 -0
  1068. package/dist/plugin-sdk/pi-model-discovery-Dw3A6oXH.js +37 -0
  1069. package/dist/plugin-sdk/plugin-sdk/index.d.ts +100 -0
  1070. package/dist/plugin-sdk/plugins/bundled-dir.d.ts +1 -0
  1071. package/dist/plugin-sdk/plugins/commands.d.ts +78 -0
  1072. package/dist/plugin-sdk/plugins/config-schema.d.ts +2 -0
  1073. package/dist/plugin-sdk/plugins/config-state.d.ts +33 -0
  1074. package/dist/plugin-sdk/plugins/discovery.d.ts +22 -0
  1075. package/dist/plugin-sdk/plugins/hook-runner-global.d.ts +31 -0
  1076. package/dist/plugin-sdk/plugins/hooks.d.ts +41 -0
  1077. package/dist/plugin-sdk/plugins/http-path.d.ts +1 -0
  1078. package/dist/plugin-sdk/plugins/http-registry.d.ts +13 -0
  1079. package/dist/plugin-sdk/plugins/loader.d.ts +14 -0
  1080. package/dist/plugin-sdk/plugins/manifest-registry.d.ts +33 -0
  1081. package/dist/plugin-sdk/plugins/manifest.d.ts +64 -0
  1082. package/dist/plugin-sdk/plugins/registry.d.ts +130 -0
  1083. package/dist/plugin-sdk/plugins/runtime/index.d.ts +3 -0
  1084. package/dist/plugin-sdk/plugins/runtime/native-deps.d.ts +8 -0
  1085. package/dist/plugin-sdk/plugins/runtime/types.d.ts +314 -0
  1086. package/dist/plugin-sdk/plugins/runtime.d.ts +5 -0
  1087. package/dist/plugin-sdk/plugins/schema-validator.d.ts +10 -0
  1088. package/dist/plugin-sdk/plugins/slots.d.ts +24 -0
  1089. package/dist/plugin-sdk/plugins/tools.d.ts +13 -0
  1090. package/dist/plugin-sdk/plugins/types.d.ts +381 -0
  1091. package/dist/plugin-sdk/polls.d.ts +21 -0
  1092. package/dist/plugin-sdk/process/command-queue.d.ts +12 -0
  1093. package/dist/plugin-sdk/process/exec.d.ts +22 -0
  1094. package/dist/plugin-sdk/process/lanes.d.ts +6 -0
  1095. package/dist/plugin-sdk/process/spawn-utils.d.ts +26 -0
  1096. package/dist/plugin-sdk/providers/github-copilot-token.d.ts +19 -0
  1097. package/dist/plugin-sdk/providers/qwen-portal-oauth.d.ts +2 -0
  1098. package/dist/plugin-sdk/routing/bindings.d.ts +11 -0
  1099. package/dist/plugin-sdk/routing/resolve-route.d.ts +38 -0
  1100. package/dist/plugin-sdk/routing/session-key.d.ts +47 -0
  1101. package/dist/plugin-sdk/runtime.d.ts +6 -0
  1102. package/dist/plugin-sdk/security/channel-metadata.d.ts +6 -0
  1103. package/dist/plugin-sdk/security/external-content.d.ts +67 -0
  1104. package/dist/plugin-sdk/sessions/level-overrides.d.ts +10 -0
  1105. package/dist/plugin-sdk/sessions/model-overrides.d.ts +14 -0
  1106. package/dist/plugin-sdk/sessions/send-policy.d.ts +11 -0
  1107. package/dist/plugin-sdk/sessions/session-key-utils.d.ts +8 -0
  1108. package/dist/plugin-sdk/sessions/session-label.d.ts +9 -0
  1109. package/dist/plugin-sdk/sessions/transcript-events.d.ts +7 -0
  1110. package/dist/plugin-sdk/shared/text/reasoning-tags.d.ts +6 -0
  1111. package/dist/plugin-sdk/signal/accounts.d.ts +17 -0
  1112. package/dist/plugin-sdk/signal/client.d.ts +32 -0
  1113. package/dist/plugin-sdk/signal/daemon.d.ts +18 -0
  1114. package/dist/plugin-sdk/signal/format.d.ts +17 -0
  1115. package/dist/plugin-sdk/signal/identity.d.ts +23 -0
  1116. package/dist/plugin-sdk/signal/index.d.ts +5 -0
  1117. package/dist/plugin-sdk/signal/monitor/event-handler.d.ts +5 -0
  1118. package/dist/plugin-sdk/signal/monitor/event-handler.types.d.ts +117 -0
  1119. package/dist/plugin-sdk/signal/monitor.d.ts +23 -0
  1120. package/dist/plugin-sdk/signal/probe.d.ts +8 -0
  1121. package/dist/plugin-sdk/signal/reaction-level.d.ts +24 -0
  1122. package/dist/plugin-sdk/signal/send-reactions.d.ts +32 -0
  1123. package/dist/plugin-sdk/signal/send.d.ts +24 -0
  1124. package/dist/plugin-sdk/signal/sse-reconnect.d.ts +13 -0
  1125. package/dist/plugin-sdk/slack/accounts.d.ts +32 -0
  1126. package/dist/plugin-sdk/slack/actions.d.ts +53 -0
  1127. package/dist/plugin-sdk/slack/channel-migration.d.ts +20 -0
  1128. package/dist/plugin-sdk/slack/client.d.ts +4 -0
  1129. package/dist/plugin-sdk/slack/directory-live.d.ts +4 -0
  1130. package/dist/plugin-sdk/slack/format.d.ts +7 -0
  1131. package/dist/plugin-sdk/slack/http/index.d.ts +1 -0
  1132. package/dist/plugin-sdk/slack/http/registry.d.ts +12 -0
  1133. package/dist/plugin-sdk/slack/index.d.ts +6 -0
  1134. package/dist/plugin-sdk/slack/monitor/allow-list.d.ts +20 -0
  1135. package/dist/plugin-sdk/slack/monitor/auth.d.ts +10 -0
  1136. package/dist/plugin-sdk/slack/monitor/channel-config.d.ts +40 -0
  1137. package/dist/plugin-sdk/slack/monitor/commands.d.ts +4 -0
  1138. package/dist/plugin-sdk/slack/monitor/context.d.ts +109 -0
  1139. package/dist/plugin-sdk/slack/monitor/events/channels.d.ts +4 -0
  1140. package/dist/plugin-sdk/slack/monitor/events/members.d.ts +4 -0
  1141. package/dist/plugin-sdk/slack/monitor/events/messages.d.ts +6 -0
  1142. package/dist/plugin-sdk/slack/monitor/events/pins.d.ts +4 -0
  1143. package/dist/plugin-sdk/slack/monitor/events/reactions.d.ts +4 -0
  1144. package/dist/plugin-sdk/slack/monitor/events.d.ts +8 -0
  1145. package/dist/plugin-sdk/slack/monitor/media.d.ts +29 -0
  1146. package/dist/plugin-sdk/slack/monitor/message-handler/dispatch.d.ts +2 -0
  1147. package/dist/plugin-sdk/slack/monitor/message-handler/prepare.d.ts +13 -0
  1148. package/dist/plugin-sdk/slack/monitor/message-handler/types.d.ts +22 -0
  1149. package/dist/plugin-sdk/slack/monitor/message-handler.d.ts +11 -0
  1150. package/dist/plugin-sdk/slack/monitor/policy.d.ts +5 -0
  1151. package/dist/plugin-sdk/slack/monitor/provider.d.ts +2 -0
  1152. package/dist/plugin-sdk/slack/monitor/replies.d.ts +50 -0
  1153. package/dist/plugin-sdk/slack/monitor/slash.d.ts +6 -0
  1154. package/dist/plugin-sdk/slack/monitor/thread-resolution.d.ts +12 -0
  1155. package/dist/plugin-sdk/slack/monitor/types.d.ts +97 -0
  1156. package/dist/plugin-sdk/slack/monitor.d.ts +5 -0
  1157. package/dist/plugin-sdk/slack/probe.d.ts +15 -0
  1158. package/dist/plugin-sdk/slack/resolve-channels.d.ts +19 -0
  1159. package/dist/plugin-sdk/slack/resolve-users.d.ts +26 -0
  1160. package/dist/plugin-sdk/slack/send.d.ts +14 -0
  1161. package/dist/plugin-sdk/slack/targets.d.ts +7 -0
  1162. package/dist/plugin-sdk/slack/threading-tool-context.d.ts +10 -0
  1163. package/dist/plugin-sdk/slack/threading.d.ts +20 -0
  1164. package/dist/plugin-sdk/slack/token.d.ts +3 -0
  1165. package/dist/plugin-sdk/slack/types.d.ts +36 -0
  1166. package/dist/plugin-sdk/telegram/accounts.d.ts +17 -0
  1167. package/dist/plugin-sdk/telegram/allowed-updates.d.ts +4 -0
  1168. package/dist/plugin-sdk/telegram/api-logging.d.ts +11 -0
  1169. package/dist/plugin-sdk/telegram/audit.d.ts +29 -0
  1170. package/dist/plugin-sdk/telegram/bot/delivery.d.ts +34 -0
  1171. package/dist/plugin-sdk/telegram/bot/helpers.d.ts +93 -0
  1172. package/dist/plugin-sdk/telegram/bot/types.d.ts +28 -0
  1173. package/dist/plugin-sdk/telegram/bot-access.d.ts +24 -0
  1174. package/dist/plugin-sdk/telegram/bot-handlers.d.ts +2 -0
  1175. package/dist/plugin-sdk/telegram/bot-message-context.d.ts +130 -0
  1176. package/dist/plugin-sdk/telegram/bot-message-dispatch.d.ts +21 -0
  1177. package/dist/plugin-sdk/telegram/bot-message.d.ts +21 -0
  1178. package/dist/plugin-sdk/telegram/bot-native-commands.d.ts +59 -0
  1179. package/dist/plugin-sdk/telegram/bot-updates.d.ts +27 -0
  1180. package/dist/plugin-sdk/telegram/bot.d.ts +54 -0
  1181. package/dist/plugin-sdk/telegram/caption.d.ts +5 -0
  1182. package/dist/plugin-sdk/telegram/draft-chunking.d.ts +6 -0
  1183. package/dist/plugin-sdk/telegram/draft-stream.d.ts +17 -0
  1184. package/dist/plugin-sdk/telegram/fetch.d.ts +4 -0
  1185. package/dist/plugin-sdk/telegram/format.d.ts +16 -0
  1186. package/dist/plugin-sdk/telegram/group-migration.d.ts +20 -0
  1187. package/dist/plugin-sdk/telegram/inline-buttons.d.ts +11 -0
  1188. package/dist/plugin-sdk/telegram/model-buttons.d.ts +63 -0
  1189. package/dist/plugin-sdk/telegram/monitor.d.ts +18 -0
  1190. package/dist/plugin-sdk/telegram/network-config.d.ts +12 -0
  1191. package/dist/plugin-sdk/telegram/network-errors.d.ts +5 -0
  1192. package/dist/plugin-sdk/telegram/probe.d.ts +18 -0
  1193. package/dist/plugin-sdk/telegram/proxy.d.ts +1 -0
  1194. package/dist/plugin-sdk/telegram/reaction-level.d.ts +18 -0
  1195. package/dist/plugin-sdk/telegram/send.d.ts +96 -0
  1196. package/dist/plugin-sdk/telegram/sent-message-cache.d.ts +16 -0
  1197. package/dist/plugin-sdk/telegram/sticker-cache.d.ts +46 -0
  1198. package/dist/plugin-sdk/telegram/targets.d.ts +14 -0
  1199. package/dist/plugin-sdk/telegram/token.d.ts +13 -0
  1200. package/dist/plugin-sdk/telegram/update-offset-store.d.ts +9 -0
  1201. package/dist/plugin-sdk/telegram/voice.d.ts +20 -0
  1202. package/dist/plugin-sdk/telegram/webhook.d.ts +20 -0
  1203. package/dist/plugin-sdk/terminal/ansi.d.ts +2 -0
  1204. package/dist/plugin-sdk/terminal/links.d.ts +6 -0
  1205. package/dist/plugin-sdk/terminal/palette.d.ts +10 -0
  1206. package/dist/plugin-sdk/terminal/progress-line.d.ts +3 -0
  1207. package/dist/plugin-sdk/terminal/prompt-style.d.ts +3 -0
  1208. package/dist/plugin-sdk/terminal/restore.d.ts +1 -0
  1209. package/dist/plugin-sdk/terminal/theme.d.ts +15 -0
  1210. package/dist/plugin-sdk/tts/tts.d.ts +198 -0
  1211. package/dist/plugin-sdk/tui/tui-formatters.d.ts +31 -0
  1212. package/dist/plugin-sdk/utils/account-id.d.ts +1 -0
  1213. package/dist/plugin-sdk/utils/boolean.d.ts +5 -0
  1214. package/dist/plugin-sdk/utils/delivery-context.d.ts +29 -0
  1215. package/dist/plugin-sdk/utils/directive-tags.d.ts +16 -0
  1216. package/dist/plugin-sdk/utils/message-channel.d.ts +27 -0
  1217. package/dist/plugin-sdk/utils/provider-utils.d.ts +9 -0
  1218. package/dist/plugin-sdk/utils/queue-helpers.d.ts +41 -0
  1219. package/dist/plugin-sdk/utils/shell-argv.d.ts +1 -0
  1220. package/dist/plugin-sdk/utils/transcript-tools.d.ts +8 -0
  1221. package/dist/plugin-sdk/utils/usage-format.d.ts +26 -0
  1222. package/dist/plugin-sdk/utils.d.ts +43 -0
  1223. package/dist/plugin-sdk/version.d.ts +4 -0
  1224. package/dist/plugin-sdk/web/accounts.d.ts +39 -0
  1225. package/dist/plugin-sdk/web/active-listener.d.ts +24 -0
  1226. package/dist/plugin-sdk/web/auth-store.d.ts +25 -0
  1227. package/dist/plugin-sdk/web/auto-reply/constants.d.ts +1 -0
  1228. package/dist/plugin-sdk/web/auto-reply/deliver-reply.d.ts +18 -0
  1229. package/dist/plugin-sdk/web/auto-reply/heartbeat-runner.d.ts +20 -0
  1230. package/dist/plugin-sdk/web/auto-reply/loggers.d.ts +4 -0
  1231. package/dist/plugin-sdk/web/auto-reply/mentions.d.ts +19 -0
  1232. package/dist/plugin-sdk/web/auto-reply/monitor/ack-reaction.d.ts +13 -0
  1233. package/dist/plugin-sdk/web/auto-reply/monitor/broadcast.d.ts +16 -0
  1234. package/dist/plugin-sdk/web/auto-reply/monitor/commands.d.ts +2 -0
  1235. package/dist/plugin-sdk/web/auto-reply/monitor/echo.d.ts +17 -0
  1236. package/dist/plugin-sdk/web/auto-reply/monitor/group-activation.d.ts +9 -0
  1237. package/dist/plugin-sdk/web/auto-reply/monitor/group-gating.d.ts +29 -0
  1238. package/dist/plugin-sdk/web/auto-reply/monitor/group-members.d.ts +6 -0
  1239. package/dist/plugin-sdk/web/auto-reply/monitor/last-route.d.ts +15 -0
  1240. package/dist/plugin-sdk/web/auto-reply/monitor/message-line.d.ts +11 -0
  1241. package/dist/plugin-sdk/web/auto-reply/monitor/on-message.d.ts +24 -0
  1242. package/dist/plugin-sdk/web/auto-reply/monitor/peer.d.ts +2 -0
  1243. package/dist/plugin-sdk/web/auto-reply/monitor/process-message.d.ts +40 -0
  1244. package/dist/plugin-sdk/web/auto-reply/monitor.d.ts +5 -0
  1245. package/dist/plugin-sdk/web/auto-reply/session-snapshot.d.ts +17 -0
  1246. package/dist/plugin-sdk/web/auto-reply/types.d.ts +28 -0
  1247. package/dist/plugin-sdk/web/auto-reply/util.d.ts +2 -0
  1248. package/dist/plugin-sdk/web/auto-reply.d.ts +1 -0
  1249. package/dist/plugin-sdk/web/auto-reply.impl.d.ts +6 -0
  1250. package/dist/plugin-sdk/web/inbound/access-control.d.ts +24 -0
  1251. package/dist/plugin-sdk/web/inbound/dedupe.d.ts +2 -0
  1252. package/dist/plugin-sdk/web/inbound/extract.d.ts +13 -0
  1253. package/dist/plugin-sdk/web/inbound/media.d.ts +6 -0
  1254. package/dist/plugin-sdk/web/inbound/monitor.d.ts +30 -0
  1255. package/dist/plugin-sdk/web/inbound/send-api.d.ts +22 -0
  1256. package/dist/plugin-sdk/web/inbound/types.d.ts +40 -0
  1257. package/dist/plugin-sdk/web/inbound.d.ts +4 -0
  1258. package/dist/plugin-sdk/web/login-qr.d.ts +19 -0
  1259. package/dist/plugin-sdk/web/login.d.ts +3 -0
  1260. package/dist/plugin-sdk/web/media.d.ts +25 -0
  1261. package/dist/plugin-sdk/web/outbound.d.ts +23 -0
  1262. package/dist/plugin-sdk/web/qr-image.d.ts +4 -0
  1263. package/dist/plugin-sdk/web/reconnect.d.ts +12 -0
  1264. package/dist/plugin-sdk/web/session.d.ts +14 -0
  1265. package/dist/plugin-sdk/web/vcard.d.ts +6 -0
  1266. package/dist/plugin-sdk/whatsapp/normalize.d.ts +6 -0
  1267. package/dist/plugin-sdk/wizard/prompts.d.ts +42 -0
  1268. package/dist/plugin-sdk/wizard/session.d.ts +42 -0
  1269. package/dist/plugins-DWuabtET.js +495 -0
  1270. package/dist/plugins-DrjfSaQw.js +496 -0
  1271. package/dist/plugins-cli-BEi_3gUD.js +444 -0
  1272. package/dist/plugins-cli-DOE3sFNh.js +441 -0
  1273. package/dist/ports-LFe1-ds4.js +96 -0
  1274. package/dist/program-Mm9gwxgw.js +191 -0
  1275. package/dist/progress-Bcjniu7m.js +133 -0
  1276. package/dist/progress-xpLtQsNY.js +133 -0
  1277. package/dist/prompt-style-CFsleyxV.js +9 -0
  1278. package/dist/prompt-style-vzh0MGHs.js +9 -0
  1279. package/dist/prompts-CudpZgTI.js +10 -0
  1280. package/dist/prompts-FbZThK8w.js +10 -0
  1281. package/dist/pw-ai-B7Fvw8DW.js +1649 -0
  1282. package/dist/pw-ai-BpFK57Lc.js +1651 -0
  1283. package/dist/pw-ai-tNPuRNn3.js +1649 -0
  1284. package/dist/qmd-manager-CazydCuO.js +676 -0
  1285. package/dist/qmd-manager-D13fgvkg.js +677 -0
  1286. package/dist/qmd-manager-QixCK9Sh.js +674 -0
  1287. package/dist/redact-BIMJ3ntQ.js +94 -0
  1288. package/dist/redact-Bt-krp_b.js +97 -0
  1289. package/dist/redact-DJCFY628.js +97 -0
  1290. package/dist/register.subclis-DpdKOrqR.js +348 -0
  1291. package/dist/reply-Nagr9G73.js +64757 -0
  1292. package/dist/rolldown-runtime-Cbj13DAv.js +20 -0
  1293. package/dist/routes-B5LAoQFO.js +2411 -0
  1294. package/dist/routes-B9mYGJET.js +2411 -0
  1295. package/dist/rpc-70nwvcmj.js +95 -0
  1296. package/dist/rpc-zvkrerfj.js +95 -0
  1297. package/dist/run-main-Y7DVYcUu.js +194 -0
  1298. package/dist/sandbox-BwaFbMul.js +2943 -0
  1299. package/dist/sandbox-CFJ-0soL.js +2942 -0
  1300. package/dist/sandbox-cli-35JWqRj-.js +460 -0
  1301. package/dist/sandbox-cli-DcGwU3Oa.js +463 -0
  1302. package/dist/security-cli-D-EgVOaA.js +505 -0
  1303. package/dist/security-cli-VON7qTOf.js +508 -0
  1304. package/dist/server-context-C8xKLc0L.js +740 -0
  1305. package/dist/server-context-yKyxyxOJ.js +740 -0
  1306. package/dist/server-node-events-CK-3iTzR.js +219 -0
  1307. package/dist/server-node-events-D0VSL_HV.js +216 -0
  1308. package/dist/service-DMUKaGTV.js +680 -0
  1309. package/dist/service-W6pWyB7g.js +680 -0
  1310. package/dist/service-audit-BTHjbAs2.js +542 -0
  1311. package/dist/service-audit-GvE18NCt.js +542 -0
  1312. package/dist/session-cost-usage-C5MMXOZi.js +692 -0
  1313. package/dist/session-cost-usage-CTuGqn7n.js +692 -0
  1314. package/dist/session-key-Dk6vSAOv.js +183 -0
  1315. package/dist/session-key-ezJ78bLC.js +183 -0
  1316. package/dist/shared-BG2E-mTe.js +74 -0
  1317. package/dist/shared-Boip_I0l.js +152 -0
  1318. package/dist/shared-C-yRLI1r.js +74 -0
  1319. package/dist/shared-CF5YSjfr.js +152 -0
  1320. package/dist/skill-scanner-BoGjHXUZ.js +255 -0
  1321. package/dist/skill-scanner-COatt01v.js +255 -0
  1322. package/dist/skills-B7bCWSck.js +693 -0
  1323. package/dist/skills-D5JDj3TR.js +694 -0
  1324. package/dist/skills-cli-D8i8lW-Y.js +290 -0
  1325. package/dist/skills-cli-OwKnGglX.js +287 -0
  1326. package/dist/skills-status-D83jBWaq.js +187 -0
  1327. package/dist/skills-status-DPwsDMVS.js +187 -0
  1328. package/dist/sqlite-BW8p11HW.js +239 -0
  1329. package/dist/sqlite-BjhYBODp.js +221 -0
  1330. package/dist/sqlite-D1XZ7Oej.js +239 -0
  1331. package/dist/status-BF8IVV7c.js +21 -0
  1332. package/dist/status-CWDof7Cn.js +21 -0
  1333. package/dist/status-CgdwqWHT.js +3177 -0
  1334. package/dist/status-DqF0Asv5.js +27 -0
  1335. package/dist/status-Dqs6r0p6.js +27 -0
  1336. package/dist/subsystem-CAq3uyo7.js +834 -0
  1337. package/dist/system-cli-Bv347a4x.js +83 -0
  1338. package/dist/system-cli-CV1yMDPJ.js +80 -0
  1339. package/dist/systemd-D5s01yMo.js +438 -0
  1340. package/dist/systemd-LmtH96vm.js +438 -0
  1341. package/dist/systemd-hints-3-E4ndGf.js +19 -0
  1342. package/dist/systemd-hints-D3nZ6-tA.js +19 -0
  1343. package/dist/systemd-linger-D4Z0ePWs.js +75 -0
  1344. package/dist/systemd-linger-DFHJcGck.js +75 -0
  1345. package/dist/table-BGYjbJbA.js +279 -0
  1346. package/dist/table-CM9lV0GA.js +279 -0
  1347. package/dist/tailnet-Byp3obcc.js +42 -0
  1348. package/dist/tailnet-DLDGNuH2.js +42 -0
  1349. package/dist/tailscale-9MusRvOi.js +225 -0
  1350. package/dist/tailscale-BVGD9gSD.js +252 -0
  1351. package/dist/tool-display-BxZG0o1b.js +795 -0
  1352. package/dist/tool-display-PgbqPY5M.js +795 -0
  1353. package/dist/transcript-events-Bv_eRVym.js +17 -0
  1354. package/dist/transcript-events-ChU6IQwp.js +17 -0
  1355. package/dist/transcript-events-JLH5W4He.js +17 -0
  1356. package/dist/tui-CSu3OIP_.js +2671 -0
  1357. package/dist/tui-DhzN4YmH.js +2672 -0
  1358. package/dist/tui-cli-Do9zFynn.js +55 -0
  1359. package/dist/tui-cli-awwGCxKR.js +58 -0
  1360. package/dist/update-DBMfgR7g.js +317 -0
  1361. package/dist/update-Nc1UGXeU.js +317 -0
  1362. package/dist/update-cli-DKJswr-w.js +1035 -0
  1363. package/dist/update-cli-LmAKEOiJ.js +1033 -0
  1364. package/dist/update-runner-DQwdSxkJ.js +1458 -0
  1365. package/dist/update-runner-kfvB4_XO.js +1458 -0
  1366. package/dist/usage-format-BcU1flOY.js +36 -0
  1367. package/dist/usage-format-DvowRSs-.js +36 -0
  1368. package/dist/utils-CKSrBNwq.js +192 -0
  1369. package/dist/utils-DX85MiPR.js +188 -0
  1370. package/dist/webhooks-cli--t1jf_uP.js +309 -0
  1371. package/dist/webhooks-cli-DAMZGMPC.js +312 -0
  1372. package/dist/widearea-dns-Bf5ongWC.js +127 -0
  1373. package/dist/widearea-dns-DDNQMGyz.js +127 -0
  1374. package/dist/ws-CEcdsnN9.js +13 -0
  1375. package/dist/ws-D091yo4M.js +13 -0
  1376. package/dist/ws-log-B0dVho23.js +267 -0
  1377. package/dist/ws-log-CBrAJIdp.js +267 -0
  1378. package/dist/wsl-D4fz-38s.js +160 -0
  1379. package/docs/.i18n/README.md +31 -0
  1380. package/docs/.i18n/glossary.zh-CN.json +210 -0
  1381. package/docs/.i18n/zh-CN.tm.jsonl +1329 -0
  1382. package/docs/CNAME +1 -0
  1383. package/docs/assets/macos-onboarding/01-macos-warning.jpeg +0 -0
  1384. package/docs/assets/macos-onboarding/02-local-networks.jpeg +0 -0
  1385. package/docs/assets/macos-onboarding/03-security-notice.png +0 -0
  1386. package/docs/assets/macos-onboarding/04-choose-gateway.png +0 -0
  1387. package/docs/assets/macos-onboarding/05-permissions.png +0 -0
  1388. package/docs/assets/openclaw-logo-text-dark.png +0 -0
  1389. package/docs/assets/openclaw-logo-text.png +0 -0
  1390. package/docs/assets/pixel-lobster.svg +60 -0
  1391. package/docs/assets/showcase/agents-ui.jpg +0 -0
  1392. package/docs/assets/showcase/bambu-cli.png +0 -0
  1393. package/docs/assets/showcase/codexmonitor.png +0 -0
  1394. package/docs/assets/showcase/gohome-grafana.png +0 -0
  1395. package/docs/assets/showcase/ios-testflight.jpg +0 -0
  1396. package/docs/assets/showcase/oura-health.png +0 -0
  1397. package/docs/assets/showcase/padel-cli.svg +11 -0
  1398. package/docs/assets/showcase/padel-screenshot.jpg +0 -0
  1399. package/docs/assets/showcase/papla-tts.jpg +0 -0
  1400. package/docs/assets/showcase/pr-review-telegram.jpg +0 -0
  1401. package/docs/assets/showcase/roborock-screenshot.jpg +0 -0
  1402. package/docs/assets/showcase/roborock-status.svg +13 -0
  1403. package/docs/assets/showcase/roof-camera-sky.jpg +0 -0
  1404. package/docs/assets/showcase/snag.png +0 -0
  1405. package/docs/assets/showcase/tesco-shop.jpg +0 -0
  1406. package/docs/assets/showcase/wienerlinien.png +0 -0
  1407. package/docs/assets/showcase/wine-cellar-skill.jpg +0 -0
  1408. package/docs/assets/showcase/winix-air-purifier.jpg +0 -0
  1409. package/docs/assets/showcase/xuezh-pronunciation.jpeg +0 -0
  1410. package/docs/automation/auth-monitoring.md +44 -0
  1411. package/docs/automation/cron-jobs.md +478 -0
  1412. package/docs/automation/cron-vs-heartbeat.md +282 -0
  1413. package/docs/automation/gmail-pubsub.md +256 -0
  1414. package/docs/automation/hooks.md +916 -0
  1415. package/docs/automation/poll.md +69 -0
  1416. package/docs/automation/troubleshooting.md +122 -0
  1417. package/docs/automation/webhook.md +163 -0
  1418. package/docs/brave-search.md +41 -0
  1419. package/docs/channels/bluebubbles.md +340 -0
  1420. package/docs/channels/broadcast-groups.md +442 -0
  1421. package/docs/channels/channel-routing.md +114 -0
  1422. package/docs/channels/discord.md +476 -0
  1423. package/docs/channels/feishu.md +579 -0
  1424. package/docs/channels/googlechat.md +252 -0
  1425. package/docs/channels/grammy.md +31 -0
  1426. package/docs/channels/group-messages.md +84 -0
  1427. package/docs/channels/groups.md +374 -0
  1428. package/docs/channels/imessage.md +321 -0
  1429. package/docs/channels/index.md +46 -0
  1430. package/docs/channels/line.md +186 -0
  1431. package/docs/channels/location.md +56 -0
  1432. package/docs/channels/matrix.md +259 -0
  1433. package/docs/channels/mattermost.md +138 -0
  1434. package/docs/channels/msteams.md +769 -0
  1435. package/docs/channels/nextcloud-talk.md +138 -0
  1436. package/docs/channels/nostr.md +233 -0
  1437. package/docs/channels/pairing.md +86 -0
  1438. package/docs/channels/signal.md +228 -0
  1439. package/docs/channels/slack.md +574 -0
  1440. package/docs/channels/telegram.md +770 -0
  1441. package/docs/channels/tlon.md +132 -0
  1442. package/docs/channels/troubleshooting.md +116 -0
  1443. package/docs/channels/twitch.md +379 -0
  1444. package/docs/channels/whatsapp.md +406 -0
  1445. package/docs/channels/zalo.md +189 -0
  1446. package/docs/channels/zalouser.md +140 -0
  1447. package/docs/cli/acp.md +170 -0
  1448. package/docs/cli/agent.md +24 -0
  1449. package/docs/cli/agents.md +75 -0
  1450. package/docs/cli/approvals.md +50 -0
  1451. package/docs/cli/browser.md +107 -0
  1452. package/docs/cli/channels.md +79 -0
  1453. package/docs/cli/config.md +50 -0
  1454. package/docs/cli/configure.md +33 -0
  1455. package/docs/cli/cron.md +44 -0
  1456. package/docs/cli/dashboard.md +16 -0
  1457. package/docs/cli/devices.md +70 -0
  1458. package/docs/cli/directory.md +63 -0
  1459. package/docs/cli/dns.md +23 -0
  1460. package/docs/cli/docs.md +15 -0
  1461. package/docs/cli/doctor.md +41 -0
  1462. package/docs/cli/gateway.md +202 -0
  1463. package/docs/cli/health.md +21 -0
  1464. package/docs/cli/hooks.md +304 -0
  1465. package/docs/cli/index.md +1031 -0
  1466. package/docs/cli/logs.md +24 -0
  1467. package/docs/cli/memory.md +45 -0
  1468. package/docs/cli/message.md +239 -0
  1469. package/docs/cli/models.md +79 -0
  1470. package/docs/cli/node.md +112 -0
  1471. package/docs/cli/nodes.md +73 -0
  1472. package/docs/cli/onboard.md +43 -0
  1473. package/docs/cli/pairing.md +21 -0
  1474. package/docs/cli/plugins.md +62 -0
  1475. package/docs/cli/reset.md +17 -0
  1476. package/docs/cli/sandbox.md +152 -0
  1477. package/docs/cli/security.md +26 -0
  1478. package/docs/cli/sessions.md +16 -0
  1479. package/docs/cli/setup.md +29 -0
  1480. package/docs/cli/skills.md +26 -0
  1481. package/docs/cli/status.md +26 -0
  1482. package/docs/cli/system.md +60 -0
  1483. package/docs/cli/tui.md +23 -0
  1484. package/docs/cli/uninstall.md +17 -0
  1485. package/docs/cli/update.md +98 -0
  1486. package/docs/cli/voicecall.md +34 -0
  1487. package/docs/cli/webhooks.md +25 -0
  1488. package/docs/concepts/agent-loop.md +146 -0
  1489. package/docs/concepts/agent-workspace.md +233 -0
  1490. package/docs/concepts/agent.md +123 -0
  1491. package/docs/concepts/architecture.md +131 -0
  1492. package/docs/concepts/compaction.md +61 -0
  1493. package/docs/concepts/context.md +161 -0
  1494. package/docs/concepts/features.md +53 -0
  1495. package/docs/concepts/markdown-formatting.md +130 -0
  1496. package/docs/concepts/memory.md +556 -0
  1497. package/docs/concepts/messages.md +154 -0
  1498. package/docs/concepts/model-failover.md +149 -0
  1499. package/docs/concepts/model-providers.md +316 -0
  1500. package/docs/concepts/models.md +208 -0
  1501. package/docs/concepts/multi-agent.md +376 -0
  1502. package/docs/concepts/oauth.md +145 -0
  1503. package/docs/concepts/presence.md +102 -0
  1504. package/docs/concepts/queue.md +89 -0
  1505. package/docs/concepts/retry.md +69 -0
  1506. package/docs/concepts/session-pruning.md +122 -0
  1507. package/docs/concepts/session-tool.md +193 -0
  1508. package/docs/concepts/session.md +204 -0
  1509. package/docs/concepts/sessions.md +10 -0
  1510. package/docs/concepts/streaming.md +135 -0
  1511. package/docs/concepts/system-prompt.md +115 -0
  1512. package/docs/concepts/timezone.md +91 -0
  1513. package/docs/concepts/typebox.md +289 -0
  1514. package/docs/concepts/typing-indicators.md +68 -0
  1515. package/docs/concepts/usage-tracking.md +35 -0
  1516. package/docs/date-time.md +128 -0
  1517. package/docs/debug/node-issue.md +85 -0
  1518. package/docs/diagnostics/flags.md +91 -0
  1519. package/docs/docs.json +1802 -0
  1520. package/docs/experiments/onboarding-config-protocol.md +40 -0
  1521. package/docs/experiments/plans/cron-add-hardening.md +63 -0
  1522. package/docs/experiments/plans/group-policy-hardening.md +40 -0
  1523. package/docs/experiments/plans/openresponses-gateway.md +123 -0
  1524. package/docs/experiments/proposals/model-config.md +36 -0
  1525. package/docs/experiments/research/memory.md +228 -0
  1526. package/docs/gateway/authentication.md +145 -0
  1527. package/docs/gateway/background-process.md +93 -0
  1528. package/docs/gateway/bonjour.md +170 -0
  1529. package/docs/gateway/bridge-protocol.md +89 -0
  1530. package/docs/gateway/cli-backends.md +225 -0
  1531. package/docs/gateway/configuration-examples.md +606 -0
  1532. package/docs/gateway/configuration.md +3416 -0
  1533. package/docs/gateway/discovery.md +116 -0
  1534. package/docs/gateway/doctor.md +282 -0
  1535. package/docs/gateway/gateway-lock.md +34 -0
  1536. package/docs/gateway/health.md +35 -0
  1537. package/docs/gateway/heartbeat.md +364 -0
  1538. package/docs/gateway/index.md +330 -0
  1539. package/docs/gateway/local-models.md +150 -0
  1540. package/docs/gateway/logging.md +113 -0
  1541. package/docs/gateway/multiple-gateways.md +112 -0
  1542. package/docs/gateway/network-model.md +17 -0
  1543. package/docs/gateway/openai-http-api.md +118 -0
  1544. package/docs/gateway/openresponses-http-api.md +317 -0
  1545. package/docs/gateway/pairing.md +99 -0
  1546. package/docs/gateway/protocol.md +221 -0
  1547. package/docs/gateway/remote-gateway-readme.md +157 -0
  1548. package/docs/gateway/remote.md +129 -0
  1549. package/docs/gateway/sandbox-vs-tool-policy-vs-elevated.md +128 -0
  1550. package/docs/gateway/sandboxing.md +193 -0
  1551. package/docs/gateway/security/index.md +829 -0
  1552. package/docs/gateway/tailscale.md +127 -0
  1553. package/docs/gateway/tools-invoke-http-api.md +85 -0
  1554. package/docs/gateway/troubleshooting.md +318 -0
  1555. package/docs/help/debugging.md +162 -0
  1556. package/docs/help/environment.md +81 -0
  1557. package/docs/help/faq.md +2848 -0
  1558. package/docs/help/index.md +21 -0
  1559. package/docs/help/scripts.md +28 -0
  1560. package/docs/help/submitting-a-pr.md +398 -0
  1561. package/docs/help/submitting-an-issue.md +152 -0
  1562. package/docs/help/testing.md +368 -0
  1563. package/docs/help/troubleshooting.md +265 -0
  1564. package/docs/hooks/soul-evil.md +69 -0
  1565. package/docs/images/feishu-step2-create-app.png +0 -0
  1566. package/docs/images/feishu-step3-credentials.png +0 -0
  1567. package/docs/images/feishu-step4-permissions.png +0 -0
  1568. package/docs/images/feishu-step5-bot-capability.png +0 -0
  1569. package/docs/images/feishu-step6-event-subscription.png +0 -0
  1570. package/docs/images/groups-flow.svg +52 -0
  1571. package/docs/images/mobile-ui-screenshot.png +0 -0
  1572. package/docs/index.md +192 -0
  1573. package/docs/install/ansible.md +208 -0
  1574. package/docs/install/bun.md +59 -0
  1575. package/docs/install/development-channels.md +75 -0
  1576. package/docs/install/docker.md +567 -0
  1577. package/docs/install/exe-dev.md +126 -0
  1578. package/docs/install/fly.md +486 -0
  1579. package/docs/install/gcp.md +504 -0
  1580. package/docs/install/hetzner.md +330 -0
  1581. package/docs/install/index.md +203 -0
  1582. package/docs/install/installer.md +385 -0
  1583. package/docs/install/macos-vm.md +281 -0
  1584. package/docs/install/migrating.md +192 -0
  1585. package/docs/install/nix.md +96 -0
  1586. package/docs/install/node.md +138 -0
  1587. package/docs/install/northflank.mdx +53 -0
  1588. package/docs/install/railway.mdx +99 -0
  1589. package/docs/install/render.mdx +159 -0
  1590. package/docs/install/uninstall.md +128 -0
  1591. package/docs/install/updating.md +231 -0
  1592. package/docs/logging.md +350 -0
  1593. package/docs/network.md +54 -0
  1594. package/docs/nodes/audio.md +114 -0
  1595. package/docs/nodes/camera.md +156 -0
  1596. package/docs/nodes/images.md +72 -0
  1597. package/docs/nodes/index.md +342 -0
  1598. package/docs/nodes/location-command.md +113 -0
  1599. package/docs/nodes/media-understanding.md +379 -0
  1600. package/docs/nodes/talk.md +90 -0
  1601. package/docs/nodes/troubleshooting.md +112 -0
  1602. package/docs/nodes/voicewake.md +65 -0
  1603. package/docs/perplexity.md +80 -0
  1604. package/docs/pi-dev.md +70 -0
  1605. package/docs/pi.md +612 -0
  1606. package/docs/platforms/android.md +151 -0
  1607. package/docs/platforms/digitalocean.md +262 -0
  1608. package/docs/platforms/index.md +53 -0
  1609. package/docs/platforms/ios.md +107 -0
  1610. package/docs/platforms/linux.md +94 -0
  1611. package/docs/platforms/mac/bundled-gateway.md +73 -0
  1612. package/docs/platforms/mac/canvas.md +125 -0
  1613. package/docs/platforms/mac/child-process.md +69 -0
  1614. package/docs/platforms/mac/dev-setup.md +104 -0
  1615. package/docs/platforms/mac/health.md +34 -0
  1616. package/docs/platforms/mac/icon.md +31 -0
  1617. package/docs/platforms/mac/logging.md +57 -0
  1618. package/docs/platforms/mac/menu-bar.md +81 -0
  1619. package/docs/platforms/mac/peekaboo.md +65 -0
  1620. package/docs/platforms/mac/permissions.md +50 -0
  1621. package/docs/platforms/mac/release.md +85 -0
  1622. package/docs/platforms/mac/remote.md +83 -0
  1623. package/docs/platforms/mac/signing.md +47 -0
  1624. package/docs/platforms/mac/skills.md +33 -0
  1625. package/docs/platforms/mac/voice-overlay.md +60 -0
  1626. package/docs/platforms/mac/voicewake.md +67 -0
  1627. package/docs/platforms/mac/webchat.md +43 -0
  1628. package/docs/platforms/mac/xpc.md +61 -0
  1629. package/docs/platforms/macos.md +203 -0
  1630. package/docs/platforms/oracle.md +303 -0
  1631. package/docs/platforms/raspberry-pi.md +358 -0
  1632. package/docs/platforms/windows.md +159 -0
  1633. package/docs/plugins/agent-tools.md +99 -0
  1634. package/docs/plugins/manifest.md +71 -0
  1635. package/docs/plugins/voice-call.md +284 -0
  1636. package/docs/plugins/zalouser.md +81 -0
  1637. package/docs/prose.md +134 -0
  1638. package/docs/providers/anthropic.md +152 -0
  1639. package/docs/providers/bedrock.md +176 -0
  1640. package/docs/providers/claude-max-api-proxy.md +148 -0
  1641. package/docs/providers/cloudflare-ai-gateway.md +71 -0
  1642. package/docs/providers/deepgram.md +93 -0
  1643. package/docs/providers/github-copilot.md +72 -0
  1644. package/docs/providers/glm.md +33 -0
  1645. package/docs/providers/index.md +64 -0
  1646. package/docs/providers/minimax.md +208 -0
  1647. package/docs/providers/models.md +52 -0
  1648. package/docs/providers/moonshot.md +142 -0
  1649. package/docs/providers/ollama.md +277 -0
  1650. package/docs/providers/openai.md +62 -0
  1651. package/docs/providers/opencode.md +36 -0
  1652. package/docs/providers/openrouter.md +37 -0
  1653. package/docs/providers/qianfan.md +38 -0
  1654. package/docs/providers/qwen.md +53 -0
  1655. package/docs/providers/synthetic.md +99 -0
  1656. package/docs/providers/venice.md +267 -0
  1657. package/docs/providers/vercel-ai-gateway.md +50 -0
  1658. package/docs/providers/xiaomi.md +64 -0
  1659. package/docs/providers/zai.md +36 -0
  1660. package/docs/refactor/clawnet.md +417 -0
  1661. package/docs/refactor/exec-host.md +316 -0
  1662. package/docs/refactor/outbound-session-mirroring.md +85 -0
  1663. package/docs/refactor/plugin-sdk.md +214 -0
  1664. package/docs/refactor/strict-config.md +93 -0
  1665. package/docs/reference/AGENTS.default.md +123 -0
  1666. package/docs/reference/RELEASING.md +120 -0
  1667. package/docs/reference/api-usage-costs.md +138 -0
  1668. package/docs/reference/credits.md +27 -0
  1669. package/docs/reference/device-models.md +47 -0
  1670. package/docs/reference/rpc.md +43 -0
  1671. package/docs/reference/session-management-compaction.md +285 -0
  1672. package/docs/reference/templates/AGENTS.dev.md +83 -0
  1673. package/docs/reference/templates/AGENTS.md +218 -0
  1674. package/docs/reference/templates/BOOT.md +10 -0
  1675. package/docs/reference/templates/BOOTSTRAP.md +61 -0
  1676. package/docs/reference/templates/HEARTBEAT.md +11 -0
  1677. package/docs/reference/templates/IDENTITY.dev.md +47 -0
  1678. package/docs/reference/templates/IDENTITY.md +29 -0
  1679. package/docs/reference/templates/SOUL.dev.md +76 -0
  1680. package/docs/reference/templates/SOUL.md +42 -0
  1681. package/docs/reference/templates/TOOLS.dev.md +24 -0
  1682. package/docs/reference/templates/TOOLS.md +46 -0
  1683. package/docs/reference/templates/USER.dev.md +18 -0
  1684. package/docs/reference/templates/USER.md +23 -0
  1685. package/docs/reference/test.md +50 -0
  1686. package/docs/reference/token-use.md +112 -0
  1687. package/docs/reference/transcript-hygiene.md +129 -0
  1688. package/docs/reference/wizard.md +269 -0
  1689. package/docs/security/formal-verification.md +164 -0
  1690. package/docs/start/bootstrapping.md +41 -0
  1691. package/docs/start/docs-directory.md +64 -0
  1692. package/docs/start/getting-started.md +120 -0
  1693. package/docs/start/hubs.md +197 -0
  1694. package/docs/start/lore.md +219 -0
  1695. package/docs/start/onboarding.md +80 -0
  1696. package/docs/start/openclaw.md +224 -0
  1697. package/docs/start/quickstart.md +22 -0
  1698. package/docs/start/setup.md +162 -0
  1699. package/docs/start/showcase.md +416 -0
  1700. package/docs/start/wizard-cli-automation.md +141 -0
  1701. package/docs/start/wizard-cli-reference.md +247 -0
  1702. package/docs/start/wizard.md +108 -0
  1703. package/docs/style.css +3 -0
  1704. package/docs/tools/agent-send.md +53 -0
  1705. package/docs/tools/apply-patch.md +50 -0
  1706. package/docs/tools/browser-linux-troubleshooting.md +139 -0
  1707. package/docs/tools/browser-login.md +67 -0
  1708. package/docs/tools/browser.md +576 -0
  1709. package/docs/tools/chrome-extension.md +178 -0
  1710. package/docs/tools/clawhub.md +257 -0
  1711. package/docs/tools/creating-skills.md +54 -0
  1712. package/docs/tools/elevated.md +57 -0
  1713. package/docs/tools/exec-approvals.md +246 -0
  1714. package/docs/tools/exec.md +179 -0
  1715. package/docs/tools/firecrawl.md +61 -0
  1716. package/docs/tools/index.md +512 -0
  1717. package/docs/tools/llm-task.md +115 -0
  1718. package/docs/tools/lobster.md +342 -0
  1719. package/docs/tools/multi-agent-sandbox-tools.md +396 -0
  1720. package/docs/tools/plugin.md +664 -0
  1721. package/docs/tools/reactions.md +22 -0
  1722. package/docs/tools/skills-config.md +76 -0
  1723. package/docs/tools/skills.md +300 -0
  1724. package/docs/tools/slash-commands.md +198 -0
  1725. package/docs/tools/subagents.md +151 -0
  1726. package/docs/tools/thinking.md +74 -0
  1727. package/docs/tools/web.md +261 -0
  1728. package/docs/tts.md +396 -0
  1729. package/docs/vps.md +43 -0
  1730. package/docs/web/control-ui.md +223 -0
  1731. package/docs/web/dashboard.md +46 -0
  1732. package/docs/web/index.md +116 -0
  1733. package/docs/web/tui.md +162 -0
  1734. package/docs/web/webchat.md +49 -0
  1735. package/docs/whatsapp-openclaw-ai-zh.jpg +0 -0
  1736. package/docs/whatsapp-openclaw.jpg +0 -0
  1737. package/docs/zh-CN/AGENTS.md +59 -0
  1738. package/docs/zh-CN/automation/auth-monitoring.md +47 -0
  1739. package/docs/zh-CN/automation/cron-jobs.md +424 -0
  1740. package/docs/zh-CN/automation/cron-vs-heartbeat.md +286 -0
  1741. package/docs/zh-CN/automation/gmail-pubsub.md +249 -0
  1742. package/docs/zh-CN/automation/hooks.md +919 -0
  1743. package/docs/zh-CN/automation/poll.md +76 -0
  1744. package/docs/zh-CN/automation/troubleshooting.md +8 -0
  1745. package/docs/zh-CN/automation/webhook.md +163 -0
  1746. package/docs/zh-CN/brave-search.md +48 -0
  1747. package/docs/zh-CN/channels/bluebubbles.md +271 -0
  1748. package/docs/zh-CN/channels/broadcast-groups.md +449 -0
  1749. package/docs/zh-CN/channels/channel-routing.md +117 -0
  1750. package/docs/zh-CN/channels/discord.md +468 -0
  1751. package/docs/zh-CN/channels/feishu.md +629 -0
  1752. package/docs/zh-CN/channels/googlechat.md +257 -0
  1753. package/docs/zh-CN/channels/grammy.md +38 -0
  1754. package/docs/zh-CN/channels/group-messages.md +91 -0
  1755. package/docs/zh-CN/channels/groups.md +379 -0
  1756. package/docs/zh-CN/channels/imessage.md +302 -0
  1757. package/docs/zh-CN/channels/index.md +53 -0
  1758. package/docs/zh-CN/channels/line.md +180 -0
  1759. package/docs/zh-CN/channels/location.md +63 -0
  1760. package/docs/zh-CN/channels/matrix.md +221 -0
  1761. package/docs/zh-CN/channels/mattermost.md +144 -0
  1762. package/docs/zh-CN/channels/msteams.md +775 -0
  1763. package/docs/zh-CN/channels/nextcloud-talk.md +142 -0
  1764. package/docs/zh-CN/channels/nostr.md +240 -0
  1765. package/docs/zh-CN/channels/pairing.md +89 -0
  1766. package/docs/zh-CN/channels/signal.md +209 -0
  1767. package/docs/zh-CN/channels/slack.md +531 -0
  1768. package/docs/zh-CN/channels/telegram.md +751 -0
  1769. package/docs/zh-CN/channels/tlon.md +136 -0
  1770. package/docs/zh-CN/channels/troubleshooting.md +36 -0
  1771. package/docs/zh-CN/channels/twitch.md +385 -0
  1772. package/docs/zh-CN/channels/whatsapp.md +411 -0
  1773. package/docs/zh-CN/channels/zalo.md +196 -0
  1774. package/docs/zh-CN/channels/zalouser.md +147 -0
  1775. package/docs/zh-CN/cli/acp.md +173 -0
  1776. package/docs/zh-CN/cli/agent.md +30 -0
  1777. package/docs/zh-CN/cli/agents.md +82 -0
  1778. package/docs/zh-CN/cli/approvals.md +57 -0
  1779. package/docs/zh-CN/cli/browser.md +114 -0
  1780. package/docs/zh-CN/cli/channels.md +86 -0
  1781. package/docs/zh-CN/cli/config.md +57 -0
  1782. package/docs/zh-CN/cli/configure.md +38 -0
  1783. package/docs/zh-CN/cli/cron.md +43 -0
  1784. package/docs/zh-CN/cli/dashboard.md +23 -0
  1785. package/docs/zh-CN/cli/devices.md +74 -0
  1786. package/docs/zh-CN/cli/directory.md +70 -0
  1787. package/docs/zh-CN/cli/dns.md +30 -0
  1788. package/docs/zh-CN/cli/docs.md +22 -0
  1789. package/docs/zh-CN/cli/doctor.md +48 -0
  1790. package/docs/zh-CN/cli/gateway.md +206 -0
  1791. package/docs/zh-CN/cli/health.md +28 -0
  1792. package/docs/zh-CN/cli/hooks.md +311 -0
  1793. package/docs/zh-CN/cli/index.md +1032 -0
  1794. package/docs/zh-CN/cli/logs.md +31 -0
  1795. package/docs/zh-CN/cli/memory.md +52 -0
  1796. package/docs/zh-CN/cli/message.md +246 -0
  1797. package/docs/zh-CN/cli/models.md +85 -0
  1798. package/docs/zh-CN/cli/node.md +115 -0
  1799. package/docs/zh-CN/cli/nodes.md +80 -0
  1800. package/docs/zh-CN/cli/onboard.md +36 -0
  1801. package/docs/zh-CN/cli/pairing.md +28 -0
  1802. package/docs/zh-CN/cli/plugins.md +66 -0
  1803. package/docs/zh-CN/cli/reset.md +24 -0
  1804. package/docs/zh-CN/cli/sandbox.md +158 -0
  1805. package/docs/zh-CN/cli/security.md +33 -0
  1806. package/docs/zh-CN/cli/sessions.md +23 -0
  1807. package/docs/zh-CN/cli/setup.md +36 -0
  1808. package/docs/zh-CN/cli/skills.md +33 -0
  1809. package/docs/zh-CN/cli/status.md +33 -0
  1810. package/docs/zh-CN/cli/system.md +63 -0
  1811. package/docs/zh-CN/cli/tui.md +30 -0
  1812. package/docs/zh-CN/cli/uninstall.md +24 -0
  1813. package/docs/zh-CN/cli/update.md +101 -0
  1814. package/docs/zh-CN/cli/voicecall.md +41 -0
  1815. package/docs/zh-CN/cli/webhooks.md +32 -0
  1816. package/docs/zh-CN/concepts/agent-loop.md +146 -0
  1817. package/docs/zh-CN/concepts/agent-workspace.md +219 -0
  1818. package/docs/zh-CN/concepts/agent.md +115 -0
  1819. package/docs/zh-CN/concepts/architecture.md +123 -0
  1820. package/docs/zh-CN/concepts/compaction.md +67 -0
  1821. package/docs/zh-CN/concepts/context.md +168 -0
  1822. package/docs/zh-CN/concepts/features.md +59 -0
  1823. package/docs/zh-CN/concepts/markdown-formatting.md +117 -0
  1824. package/docs/zh-CN/concepts/memory.md +412 -0
  1825. package/docs/zh-CN/concepts/messages.md +141 -0
  1826. package/docs/zh-CN/concepts/model-failover.md +145 -0
  1827. package/docs/zh-CN/concepts/model-providers.md +320 -0
  1828. package/docs/zh-CN/concepts/models.md +196 -0
  1829. package/docs/zh-CN/concepts/multi-agent.md +372 -0
  1830. package/docs/zh-CN/concepts/oauth.md +151 -0
  1831. package/docs/zh-CN/concepts/presence.md +99 -0
  1832. package/docs/zh-CN/concepts/queue.md +94 -0
  1833. package/docs/zh-CN/concepts/retry.md +76 -0
  1834. package/docs/zh-CN/concepts/session-pruning.md +129 -0
  1835. package/docs/zh-CN/concepts/session-tool.md +200 -0
  1836. package/docs/zh-CN/concepts/session.md +166 -0
  1837. package/docs/zh-CN/concepts/sessions.md +17 -0
  1838. package/docs/zh-CN/concepts/streaming.md +133 -0
  1839. package/docs/zh-CN/concepts/system-prompt.md +101 -0
  1840. package/docs/zh-CN/concepts/timezone.md +96 -0
  1841. package/docs/zh-CN/concepts/typebox.md +284 -0
  1842. package/docs/zh-CN/concepts/typing-indicators.md +74 -0
  1843. package/docs/zh-CN/concepts/usage-tracking.md +42 -0
  1844. package/docs/zh-CN/date-time.md +129 -0
  1845. package/docs/zh-CN/debug/node-issue.md +90 -0
  1846. package/docs/zh-CN/diagnostics/flags.md +98 -0
  1847. package/docs/zh-CN/experiments/onboarding-config-protocol.md +47 -0
  1848. package/docs/zh-CN/experiments/plans/cron-add-hardening.md +70 -0
  1849. package/docs/zh-CN/experiments/plans/group-policy-hardening.md +45 -0
  1850. package/docs/zh-CN/experiments/plans/openresponses-gateway.md +121 -0
  1851. package/docs/zh-CN/experiments/proposals/model-config.md +42 -0
  1852. package/docs/zh-CN/experiments/research/memory.md +235 -0
  1853. package/docs/zh-CN/gateway/authentication.md +142 -0
  1854. package/docs/zh-CN/gateway/background-process.md +100 -0
  1855. package/docs/zh-CN/gateway/bonjour.md +174 -0
  1856. package/docs/zh-CN/gateway/bridge-protocol.md +86 -0
  1857. package/docs/zh-CN/gateway/cli-backends.md +213 -0
  1858. package/docs/zh-CN/gateway/configuration-examples.md +587 -0
  1859. package/docs/zh-CN/gateway/configuration.md +3332 -0
  1860. package/docs/zh-CN/gateway/discovery.md +123 -0
  1861. package/docs/zh-CN/gateway/doctor.md +238 -0
  1862. package/docs/zh-CN/gateway/gateway-lock.md +41 -0
  1863. package/docs/zh-CN/gateway/health.md +42 -0
  1864. package/docs/zh-CN/gateway/heartbeat.md +274 -0
  1865. package/docs/zh-CN/gateway/index.md +335 -0
  1866. package/docs/zh-CN/gateway/local-models.md +157 -0
  1867. package/docs/zh-CN/gateway/logging.md +114 -0
  1868. package/docs/zh-CN/gateway/multiple-gateways.md +119 -0
  1869. package/docs/zh-CN/gateway/network-model.md +23 -0
  1870. package/docs/zh-CN/gateway/openai-http-api.md +125 -0
  1871. package/docs/zh-CN/gateway/openresponses-http-api.md +317 -0
  1872. package/docs/zh-CN/gateway/pairing.md +99 -0
  1873. package/docs/zh-CN/gateway/protocol.md +220 -0
  1874. package/docs/zh-CN/gateway/remote-gateway-readme.md +164 -0
  1875. package/docs/zh-CN/gateway/remote.md +133 -0
  1876. package/docs/zh-CN/gateway/sandbox-vs-tool-policy-vs-elevated.md +135 -0
  1877. package/docs/zh-CN/gateway/sandboxing.md +188 -0
  1878. package/docs/zh-CN/gateway/security/index.md +777 -0
  1879. package/docs/zh-CN/gateway/tailscale.md +124 -0
  1880. package/docs/zh-CN/gateway/tools-invoke-http-api.md +92 -0
  1881. package/docs/zh-CN/gateway/troubleshooting.md +771 -0
  1882. package/docs/zh-CN/help/debugging.md +160 -0
  1883. package/docs/zh-CN/help/environment.md +88 -0
  1884. package/docs/zh-CN/help/faq.md +2628 -0
  1885. package/docs/zh-CN/help/index.md +28 -0
  1886. package/docs/zh-CN/help/scripts.md +35 -0
  1887. package/docs/zh-CN/help/submitting-a-pr.md +8 -0
  1888. package/docs/zh-CN/help/submitting-an-issue.md +8 -0
  1889. package/docs/zh-CN/help/testing.md +375 -0
  1890. package/docs/zh-CN/help/troubleshooting.md +104 -0
  1891. package/docs/zh-CN/hooks/soul-evil.md +72 -0
  1892. package/docs/zh-CN/index.md +186 -0
  1893. package/docs/zh-CN/install/ansible.md +215 -0
  1894. package/docs/zh-CN/install/bun.md +65 -0
  1895. package/docs/zh-CN/install/development-channels.md +81 -0
  1896. package/docs/zh-CN/install/docker.md +532 -0
  1897. package/docs/zh-CN/install/exe-dev.md +127 -0
  1898. package/docs/zh-CN/install/fly.md +490 -0
  1899. package/docs/zh-CN/install/gcp.md +510 -0
  1900. package/docs/zh-CN/install/hetzner.md +337 -0
  1901. package/docs/zh-CN/install/index.md +193 -0
  1902. package/docs/zh-CN/install/installer.md +128 -0
  1903. package/docs/zh-CN/install/macos-vm.md +288 -0
  1904. package/docs/zh-CN/install/migrating.md +199 -0
  1905. package/docs/zh-CN/install/nix.md +99 -0
  1906. package/docs/zh-CN/install/node.md +8 -0
  1907. package/docs/zh-CN/install/northflank.mdx +60 -0
  1908. package/docs/zh-CN/install/railway.mdx +106 -0
  1909. package/docs/zh-CN/install/render.mdx +169 -0
  1910. package/docs/zh-CN/install/uninstall.md +135 -0
  1911. package/docs/zh-CN/install/updating.md +233 -0
  1912. package/docs/zh-CN/logging.md +329 -0
  1913. package/docs/zh-CN/network.md +59 -0
  1914. package/docs/zh-CN/nodes/audio.md +120 -0
  1915. package/docs/zh-CN/nodes/camera.md +162 -0
  1916. package/docs/zh-CN/nodes/images.md +79 -0
  1917. package/docs/zh-CN/nodes/index.md +348 -0
  1918. package/docs/zh-CN/nodes/location-command.md +120 -0
  1919. package/docs/zh-CN/nodes/media-understanding.md +380 -0
  1920. package/docs/zh-CN/nodes/talk.md +97 -0
  1921. package/docs/zh-CN/nodes/troubleshooting.md +8 -0
  1922. package/docs/zh-CN/nodes/voicewake.md +72 -0
  1923. package/docs/zh-CN/perplexity.md +84 -0
  1924. package/docs/zh-CN/pi-dev.md +77 -0
  1925. package/docs/zh-CN/pi.md +619 -0
  1926. package/docs/zh-CN/platforms/android.md +155 -0
  1927. package/docs/zh-CN/platforms/digitalocean.md +269 -0
  1928. package/docs/zh-CN/platforms/index.md +60 -0
  1929. package/docs/zh-CN/platforms/ios.md +114 -0
  1930. package/docs/zh-CN/platforms/linux.md +101 -0
  1931. package/docs/zh-CN/platforms/mac/bundled-gateway.md +75 -0
  1932. package/docs/zh-CN/platforms/mac/canvas.md +128 -0
  1933. package/docs/zh-CN/platforms/mac/child-process.md +73 -0
  1934. package/docs/zh-CN/platforms/mac/dev-setup.md +109 -0
  1935. package/docs/zh-CN/platforms/mac/health.md +41 -0
  1936. package/docs/zh-CN/platforms/mac/icon.md +38 -0
  1937. package/docs/zh-CN/platforms/mac/logging.md +64 -0
  1938. package/docs/zh-CN/platforms/mac/menu-bar.md +88 -0
  1939. package/docs/zh-CN/platforms/mac/peekaboo.md +62 -0
  1940. package/docs/zh-CN/platforms/mac/permissions.md +46 -0
  1941. package/docs/zh-CN/platforms/mac/release.md +92 -0
  1942. package/docs/zh-CN/platforms/mac/remote.md +90 -0
  1943. package/docs/zh-CN/platforms/mac/signing.md +54 -0
  1944. package/docs/zh-CN/platforms/mac/skills.md +40 -0
  1945. package/docs/zh-CN/platforms/mac/voice-overlay.md +67 -0
  1946. package/docs/zh-CN/platforms/mac/voicewake.md +74 -0
  1947. package/docs/zh-CN/platforms/mac/webchat.md +43 -0
  1948. package/docs/zh-CN/platforms/mac/xpc.md +68 -0
  1949. package/docs/zh-CN/platforms/macos.md +193 -0
  1950. package/docs/zh-CN/platforms/oracle.md +310 -0
  1951. package/docs/zh-CN/platforms/raspberry-pi.md +365 -0
  1952. package/docs/zh-CN/platforms/windows.md +156 -0
  1953. package/docs/zh-CN/plugins/agent-tools.md +99 -0
  1954. package/docs/zh-CN/plugins/manifest.md +68 -0
  1955. package/docs/zh-CN/plugins/voice-call.md +250 -0
  1956. package/docs/zh-CN/plugins/zalouser.md +88 -0
  1957. package/docs/zh-CN/prose.md +141 -0
  1958. package/docs/zh-CN/providers/anthropic.md +159 -0
  1959. package/docs/zh-CN/providers/bedrock.md +170 -0
  1960. package/docs/zh-CN/providers/claude-max-api-proxy.md +155 -0
  1961. package/docs/zh-CN/providers/deepgram.md +97 -0
  1962. package/docs/zh-CN/providers/github-copilot.md +67 -0
  1963. package/docs/zh-CN/providers/glm.md +39 -0
  1964. package/docs/zh-CN/providers/index.md +68 -0
  1965. package/docs/zh-CN/providers/minimax.md +206 -0
  1966. package/docs/zh-CN/providers/models.md +55 -0
  1967. package/docs/zh-CN/providers/moonshot.md +145 -0
  1968. package/docs/zh-CN/providers/ollama.md +230 -0
  1969. package/docs/zh-CN/providers/openai.md +68 -0
  1970. package/docs/zh-CN/providers/opencode.md +41 -0
  1971. package/docs/zh-CN/providers/openrouter.md +43 -0
  1972. package/docs/zh-CN/providers/qianfan.md +8 -0
  1973. package/docs/zh-CN/providers/qwen.md +55 -0
  1974. package/docs/zh-CN/providers/synthetic.md +102 -0
  1975. package/docs/zh-CN/providers/venice.md +274 -0
  1976. package/docs/zh-CN/providers/vercel-ai-gateway.md +57 -0
  1977. package/docs/zh-CN/providers/xiaomi.md +68 -0
  1978. package/docs/zh-CN/providers/zai.md +41 -0
  1979. package/docs/zh-CN/refactor/clawnet.md +424 -0
  1980. package/docs/zh-CN/refactor/exec-host.md +323 -0
  1981. package/docs/zh-CN/refactor/outbound-session-mirroring.md +92 -0
  1982. package/docs/zh-CN/refactor/plugin-sdk.md +221 -0
  1983. package/docs/zh-CN/refactor/strict-config.md +100 -0
  1984. package/docs/zh-CN/reference/AGENTS.default.md +131 -0
  1985. package/docs/zh-CN/reference/RELEASING.md +123 -0
  1986. package/docs/zh-CN/reference/api-usage-costs.md +136 -0
  1987. package/docs/zh-CN/reference/credits.md +34 -0
  1988. package/docs/zh-CN/reference/device-models.md +54 -0
  1989. package/docs/zh-CN/reference/rpc.md +48 -0
  1990. package/docs/zh-CN/reference/session-management-compaction.md +287 -0
  1991. package/docs/zh-CN/reference/templates/AGENTS.dev.md +89 -0
  1992. package/docs/zh-CN/reference/templates/AGENTS.md +225 -0
  1993. package/docs/zh-CN/reference/templates/BOOT.md +17 -0
  1994. package/docs/zh-CN/reference/templates/BOOTSTRAP.md +68 -0
  1995. package/docs/zh-CN/reference/templates/HEARTBEAT.md +18 -0
  1996. package/docs/zh-CN/reference/templates/IDENTITY.dev.md +54 -0
  1997. package/docs/zh-CN/reference/templates/IDENTITY.md +36 -0
  1998. package/docs/zh-CN/reference/templates/SOUL.dev.md +83 -0
  1999. package/docs/zh-CN/reference/templates/SOUL.md +49 -0
  2000. package/docs/zh-CN/reference/templates/TOOLS.dev.md +31 -0
  2001. package/docs/zh-CN/reference/templates/TOOLS.md +53 -0
  2002. package/docs/zh-CN/reference/templates/USER.dev.md +25 -0
  2003. package/docs/zh-CN/reference/templates/USER.md +30 -0
  2004. package/docs/zh-CN/reference/test.md +57 -0
  2005. package/docs/zh-CN/reference/token-use.md +119 -0
  2006. package/docs/zh-CN/reference/transcript-hygiene.md +109 -0
  2007. package/docs/zh-CN/reference/wizard.md +9 -0
  2008. package/docs/zh-CN/security/formal-verification.md +171 -0
  2009. package/docs/zh-CN/start/bootstrapping.md +9 -0
  2010. package/docs/zh-CN/start/docs-directory.md +70 -0
  2011. package/docs/zh-CN/start/getting-started.md +206 -0
  2012. package/docs/zh-CN/start/hubs.md +200 -0
  2013. package/docs/zh-CN/start/lore.md +226 -0
  2014. package/docs/zh-CN/start/onboarding.md +105 -0
  2015. package/docs/zh-CN/start/openclaw.md +248 -0
  2016. package/docs/zh-CN/start/quickstart.md +88 -0
  2017. package/docs/zh-CN/start/setup.md +153 -0
  2018. package/docs/zh-CN/start/showcase.md +423 -0
  2019. package/docs/zh-CN/start/wizard.md +331 -0
  2020. package/docs/zh-CN/tools/agent-send.md +59 -0
  2021. package/docs/zh-CN/tools/apply-patch.md +57 -0
  2022. package/docs/zh-CN/tools/browser-linux-troubleshooting.md +144 -0
  2023. package/docs/zh-CN/tools/browser-login.md +75 -0
  2024. package/docs/zh-CN/tools/browser.md +553 -0
  2025. package/docs/zh-CN/tools/chrome-extension.md +183 -0
  2026. package/docs/zh-CN/tools/clawhub.md +209 -0
  2027. package/docs/zh-CN/tools/creating-skills.md +61 -0
  2028. package/docs/zh-CN/tools/elevated.md +64 -0
  2029. package/docs/zh-CN/tools/exec-approvals.md +234 -0
  2030. package/docs/zh-CN/tools/exec.md +169 -0
  2031. package/docs/zh-CN/tools/firecrawl.md +68 -0
  2032. package/docs/zh-CN/tools/index.md +515 -0
  2033. package/docs/zh-CN/tools/llm-task.md +117 -0
  2034. package/docs/zh-CN/tools/lobster.md +349 -0
  2035. package/docs/zh-CN/tools/multi-agent-sandbox-tools.md +401 -0
  2036. package/docs/zh-CN/tools/plugin.md +639 -0
  2037. package/docs/zh-CN/tools/reactions.md +29 -0
  2038. package/docs/zh-CN/tools/skills-config.md +78 -0
  2039. package/docs/zh-CN/tools/skills.md +279 -0
  2040. package/docs/zh-CN/tools/slash-commands.md +205 -0
  2041. package/docs/zh-CN/tools/subagents.md +156 -0
  2042. package/docs/zh-CN/tools/thinking.md +80 -0
  2043. package/docs/zh-CN/tools/web.md +257 -0
  2044. package/docs/zh-CN/tts.md +375 -0
  2045. package/docs/zh-CN/vps.md +47 -0
  2046. package/docs/zh-CN/web/control-ui.md +191 -0
  2047. package/docs/zh-CN/web/dashboard.md +53 -0
  2048. package/docs/zh-CN/web/index.md +118 -0
  2049. package/docs/zh-CN/web/tui.md +166 -0
  2050. package/docs/zh-CN/web/webchat.md +56 -0
  2051. package/extensions/bluebubbles/README.md +45 -0
  2052. package/extensions/bluebubbles/index.ts +19 -0
  2053. package/extensions/bluebubbles/node_modules/.bin/openclaw +21 -0
  2054. package/extensions/bluebubbles/openclaw.plugin.json +9 -0
  2055. package/extensions/bluebubbles/package.json +36 -0
  2056. package/extensions/bluebubbles/src/accounts.ts +88 -0
  2057. package/extensions/bluebubbles/src/actions.test.ts +650 -0
  2058. package/extensions/bluebubbles/src/actions.ts +438 -0
  2059. package/extensions/bluebubbles/src/attachments.test.ts +345 -0
  2060. package/extensions/bluebubbles/src/attachments.ts +302 -0
  2061. package/extensions/bluebubbles/src/channel.ts +414 -0
  2062. package/extensions/bluebubbles/src/chat.test.ts +461 -0
  2063. package/extensions/bluebubbles/src/chat.ts +382 -0
  2064. package/extensions/bluebubbles/src/config-schema.ts +51 -0
  2065. package/extensions/bluebubbles/src/media-send.ts +174 -0
  2066. package/extensions/bluebubbles/src/monitor.test.ts +2384 -0
  2067. package/extensions/bluebubbles/src/monitor.ts +2517 -0
  2068. package/extensions/bluebubbles/src/onboarding.ts +352 -0
  2069. package/extensions/bluebubbles/src/probe.ts +144 -0
  2070. package/extensions/bluebubbles/src/reactions.test.ts +392 -0
  2071. package/extensions/bluebubbles/src/reactions.ts +188 -0
  2072. package/extensions/bluebubbles/src/runtime.ts +14 -0
  2073. package/extensions/bluebubbles/src/send.test.ts +889 -0
  2074. package/extensions/bluebubbles/src/send.ts +474 -0
  2075. package/extensions/bluebubbles/src/targets.test.ts +183 -0
  2076. package/extensions/bluebubbles/src/targets.ts +422 -0
  2077. package/extensions/bluebubbles/src/types.ts +127 -0
  2078. package/extensions/copilot-proxy/README.md +24 -0
  2079. package/extensions/copilot-proxy/index.ts +149 -0
  2080. package/extensions/copilot-proxy/node_modules/.bin/openclaw +21 -0
  2081. package/extensions/copilot-proxy/openclaw.plugin.json +9 -0
  2082. package/extensions/copilot-proxy/package.json +14 -0
  2083. package/extensions/diagnostics-otel/index.ts +15 -0
  2084. package/extensions/diagnostics-otel/node_modules/.bin/acorn +21 -0
  2085. package/extensions/diagnostics-otel/node_modules/.bin/openclaw +21 -0
  2086. package/extensions/diagnostics-otel/openclaw.plugin.json +8 -0
  2087. package/extensions/diagnostics-otel/package.json +27 -0
  2088. package/extensions/diagnostics-otel/src/service.test.ts +226 -0
  2089. package/extensions/diagnostics-otel/src/service.ts +635 -0
  2090. package/extensions/discord/index.ts +17 -0
  2091. package/extensions/discord/node_modules/.bin/openclaw +21 -0
  2092. package/extensions/discord/openclaw.plugin.json +9 -0
  2093. package/extensions/discord/package.json +14 -0
  2094. package/extensions/discord/src/channel.ts +422 -0
  2095. package/extensions/discord/src/runtime.ts +14 -0
  2096. package/extensions/feishu/index.ts +63 -0
  2097. package/extensions/feishu/node_modules/.bin/openclaw +21 -0
  2098. package/extensions/feishu/openclaw.plugin.json +10 -0
  2099. package/extensions/feishu/package.json +37 -0
  2100. package/extensions/feishu/skills/feishu-doc/SKILL.md +105 -0
  2101. package/extensions/feishu/skills/feishu-doc/references/block-types.md +103 -0
  2102. package/extensions/feishu/skills/feishu-drive/SKILL.md +97 -0
  2103. package/extensions/feishu/skills/feishu-perm/SKILL.md +119 -0
  2104. package/extensions/feishu/skills/feishu-wiki/SKILL.md +111 -0
  2105. package/extensions/feishu/src/accounts.ts +144 -0
  2106. package/extensions/feishu/src/bitable.ts +459 -0
  2107. package/extensions/feishu/src/bot.ts +871 -0
  2108. package/extensions/feishu/src/channel.ts +341 -0
  2109. package/extensions/feishu/src/client.ts +118 -0
  2110. package/extensions/feishu/src/config-schema.ts +172 -0
  2111. package/extensions/feishu/src/directory.ts +177 -0
  2112. package/extensions/feishu/src/doc-schema.ts +47 -0
  2113. package/extensions/feishu/src/docx.ts +521 -0
  2114. package/extensions/feishu/src/drive-schema.ts +46 -0
  2115. package/extensions/feishu/src/drive.ts +227 -0
  2116. package/extensions/feishu/src/media.ts +527 -0
  2117. package/extensions/feishu/src/mention.ts +126 -0
  2118. package/extensions/feishu/src/monitor.ts +190 -0
  2119. package/extensions/feishu/src/onboarding.ts +356 -0
  2120. package/extensions/feishu/src/outbound.ts +40 -0
  2121. package/extensions/feishu/src/perm-schema.ts +52 -0
  2122. package/extensions/feishu/src/perm.ts +173 -0
  2123. package/extensions/feishu/src/policy.ts +104 -0
  2124. package/extensions/feishu/src/probe.ts +44 -0
  2125. package/extensions/feishu/src/reactions.ts +160 -0
  2126. package/extensions/feishu/src/reply-dispatcher.ts +184 -0
  2127. package/extensions/feishu/src/runtime.ts +14 -0
  2128. package/extensions/feishu/src/send.ts +358 -0
  2129. package/extensions/feishu/src/targets.ts +78 -0
  2130. package/extensions/feishu/src/tools-config.ts +21 -0
  2131. package/extensions/feishu/src/types.ts +75 -0
  2132. package/extensions/feishu/src/typing.ts +80 -0
  2133. package/extensions/feishu/src/wiki-schema.ts +55 -0
  2134. package/extensions/feishu/src/wiki.ts +232 -0
  2135. package/extensions/google-antigravity-auth/README.md +24 -0
  2136. package/extensions/google-antigravity-auth/index.ts +461 -0
  2137. package/extensions/google-antigravity-auth/node_modules/.bin/openclaw +21 -0
  2138. package/extensions/google-antigravity-auth/openclaw.plugin.json +9 -0
  2139. package/extensions/google-antigravity-auth/package.json +14 -0
  2140. package/extensions/google-gemini-cli-auth/README.md +35 -0
  2141. package/extensions/google-gemini-cli-auth/index.ts +88 -0
  2142. package/extensions/google-gemini-cli-auth/node_modules/.bin/openclaw +21 -0
  2143. package/extensions/google-gemini-cli-auth/oauth.test.ts +240 -0
  2144. package/extensions/google-gemini-cli-auth/oauth.ts +662 -0
  2145. package/extensions/google-gemini-cli-auth/openclaw.plugin.json +9 -0
  2146. package/extensions/google-gemini-cli-auth/package.json +14 -0
  2147. package/extensions/googlechat/index.ts +19 -0
  2148. package/extensions/googlechat/node_modules/.bin/openclaw +21 -0
  2149. package/extensions/googlechat/openclaw.plugin.json +9 -0
  2150. package/extensions/googlechat/package.json +39 -0
  2151. package/extensions/googlechat/src/accounts.ts +147 -0
  2152. package/extensions/googlechat/src/actions.ts +181 -0
  2153. package/extensions/googlechat/src/api.test.ts +61 -0
  2154. package/extensions/googlechat/src/api.ts +282 -0
  2155. package/extensions/googlechat/src/auth.ts +137 -0
  2156. package/extensions/googlechat/src/channel.ts +583 -0
  2157. package/extensions/googlechat/src/monitor.test.ts +22 -0
  2158. package/extensions/googlechat/src/monitor.ts +960 -0
  2159. package/extensions/googlechat/src/onboarding.ts +269 -0
  2160. package/extensions/googlechat/src/runtime.ts +14 -0
  2161. package/extensions/googlechat/src/targets.test.ts +32 -0
  2162. package/extensions/googlechat/src/targets.ts +65 -0
  2163. package/extensions/googlechat/src/types.config.ts +3 -0
  2164. package/extensions/googlechat/src/types.ts +73 -0
  2165. package/extensions/imessage/index.ts +17 -0
  2166. package/extensions/imessage/node_modules/.bin/openclaw +21 -0
  2167. package/extensions/imessage/openclaw.plugin.json +9 -0
  2168. package/extensions/imessage/package.json +14 -0
  2169. package/extensions/imessage/src/channel.ts +294 -0
  2170. package/extensions/imessage/src/runtime.ts +14 -0
  2171. package/extensions/line/index.ts +19 -0
  2172. package/extensions/line/node_modules/.bin/openclaw +21 -0
  2173. package/extensions/line/openclaw.plugin.json +9 -0
  2174. package/extensions/line/package.json +29 -0
  2175. package/extensions/line/src/card-command.ts +344 -0
  2176. package/extensions/line/src/channel.logout.test.ts +99 -0
  2177. package/extensions/line/src/channel.sendPayload.test.ts +306 -0
  2178. package/extensions/line/src/channel.ts +780 -0
  2179. package/extensions/line/src/runtime.ts +14 -0
  2180. package/extensions/llm-task/README.md +97 -0
  2181. package/extensions/llm-task/index.ts +6 -0
  2182. package/extensions/llm-task/node_modules/.bin/openclaw +21 -0
  2183. package/extensions/llm-task/openclaw.plugin.json +21 -0
  2184. package/extensions/llm-task/package.json +14 -0
  2185. package/extensions/llm-task/src/llm-task-tool.test.ts +138 -0
  2186. package/extensions/llm-task/src/llm-task-tool.ts +245 -0
  2187. package/extensions/lobster/README.md +75 -0
  2188. package/extensions/lobster/SKILL.md +97 -0
  2189. package/extensions/lobster/index.ts +14 -0
  2190. package/extensions/lobster/node_modules/.bin/openclaw +21 -0
  2191. package/extensions/lobster/openclaw.plugin.json +10 -0
  2192. package/extensions/lobster/package.json +14 -0
  2193. package/extensions/lobster/src/lobster-tool.test.ts +247 -0
  2194. package/extensions/lobster/src/lobster-tool.ts +328 -0
  2195. package/extensions/matrix/CHANGELOG.md +111 -0
  2196. package/extensions/matrix/index.ts +17 -0
  2197. package/extensions/matrix/node_modules/.bin/markdown-it +21 -0
  2198. package/extensions/matrix/node_modules/.bin/openclaw +21 -0
  2199. package/extensions/matrix/openclaw.plugin.json +9 -0
  2200. package/extensions/matrix/package.json +36 -0
  2201. package/extensions/matrix/src/actions.ts +195 -0
  2202. package/extensions/matrix/src/channel.directory.test.ts +64 -0
  2203. package/extensions/matrix/src/channel.ts +439 -0
  2204. package/extensions/matrix/src/config-schema.ts +63 -0
  2205. package/extensions/matrix/src/directory-live.ts +188 -0
  2206. package/extensions/matrix/src/group-mentions.ts +66 -0
  2207. package/extensions/matrix/src/matrix/accounts.test.ts +82 -0
  2208. package/extensions/matrix/src/matrix/accounts.ts +65 -0
  2209. package/extensions/matrix/src/matrix/actions/client.ts +57 -0
  2210. package/extensions/matrix/src/matrix/actions/messages.ts +128 -0
  2211. package/extensions/matrix/src/matrix/actions/pins.ts +76 -0
  2212. package/extensions/matrix/src/matrix/actions/reactions.ts +96 -0
  2213. package/extensions/matrix/src/matrix/actions/room.ts +85 -0
  2214. package/extensions/matrix/src/matrix/actions/summary.ts +75 -0
  2215. package/extensions/matrix/src/matrix/actions/types.ts +84 -0
  2216. package/extensions/matrix/src/matrix/actions.ts +15 -0
  2217. package/extensions/matrix/src/matrix/active-client.ts +11 -0
  2218. package/extensions/matrix/src/matrix/client/config.ts +160 -0
  2219. package/extensions/matrix/src/matrix/client/create-client.ts +123 -0
  2220. package/extensions/matrix/src/matrix/client/logging.ts +36 -0
  2221. package/extensions/matrix/src/matrix/client/runtime.ts +4 -0
  2222. package/extensions/matrix/src/matrix/client/shared.ts +170 -0
  2223. package/extensions/matrix/src/matrix/client/storage.ts +131 -0
  2224. package/extensions/matrix/src/matrix/client/types.ts +34 -0
  2225. package/extensions/matrix/src/matrix/client.test.ts +56 -0
  2226. package/extensions/matrix/src/matrix/client.ts +5 -0
  2227. package/extensions/matrix/src/matrix/credentials.ts +105 -0
  2228. package/extensions/matrix/src/matrix/deps.ts +60 -0
  2229. package/extensions/matrix/src/matrix/format.test.ts +33 -0
  2230. package/extensions/matrix/src/matrix/format.ts +22 -0
  2231. package/extensions/matrix/src/matrix/index.ts +11 -0
  2232. package/extensions/matrix/src/matrix/monitor/allowlist.test.ts +45 -0
  2233. package/extensions/matrix/src/matrix/monitor/allowlist.ts +103 -0
  2234. package/extensions/matrix/src/matrix/monitor/auto-join.ts +71 -0
  2235. package/extensions/matrix/src/matrix/monitor/direct.ts +104 -0
  2236. package/extensions/matrix/src/matrix/monitor/events.ts +101 -0
  2237. package/extensions/matrix/src/matrix/monitor/handler.ts +665 -0
  2238. package/extensions/matrix/src/matrix/monitor/index.ts +338 -0
  2239. package/extensions/matrix/src/matrix/monitor/location.ts +100 -0
  2240. package/extensions/matrix/src/matrix/monitor/media.test.ts +102 -0
  2241. package/extensions/matrix/src/matrix/monitor/media.ts +113 -0
  2242. package/extensions/matrix/src/matrix/monitor/mentions.ts +31 -0
  2243. package/extensions/matrix/src/matrix/monitor/replies.ts +97 -0
  2244. package/extensions/matrix/src/matrix/monitor/room-info.ts +55 -0
  2245. package/extensions/matrix/src/matrix/monitor/rooms.test.ts +39 -0
  2246. package/extensions/matrix/src/matrix/monitor/rooms.ts +47 -0
  2247. package/extensions/matrix/src/matrix/monitor/threads.ts +68 -0
  2248. package/extensions/matrix/src/matrix/monitor/types.ts +39 -0
  2249. package/extensions/matrix/src/matrix/poll-types.test.ts +21 -0
  2250. package/extensions/matrix/src/matrix/poll-types.ts +166 -0
  2251. package/extensions/matrix/src/matrix/probe.ts +70 -0
  2252. package/extensions/matrix/src/matrix/send/client.ts +66 -0
  2253. package/extensions/matrix/src/matrix/send/formatting.ts +89 -0
  2254. package/extensions/matrix/src/matrix/send/media.ts +229 -0
  2255. package/extensions/matrix/src/matrix/send/targets.test.ts +98 -0
  2256. package/extensions/matrix/src/matrix/send/targets.ts +147 -0
  2257. package/extensions/matrix/src/matrix/send/types.ts +109 -0
  2258. package/extensions/matrix/src/matrix/send.test.ts +171 -0
  2259. package/extensions/matrix/src/matrix/send.ts +260 -0
  2260. package/extensions/matrix/src/onboarding.ts +449 -0
  2261. package/extensions/matrix/src/outbound.ts +52 -0
  2262. package/extensions/matrix/src/resolve-targets.test.ts +48 -0
  2263. package/extensions/matrix/src/resolve-targets.ts +135 -0
  2264. package/extensions/matrix/src/runtime.ts +14 -0
  2265. package/extensions/matrix/src/tool-actions.ts +164 -0
  2266. package/extensions/matrix/src/types.ts +97 -0
  2267. package/extensions/mattermost/index.ts +17 -0
  2268. package/extensions/mattermost/node_modules/.bin/openclaw +21 -0
  2269. package/extensions/mattermost/openclaw.plugin.json +9 -0
  2270. package/extensions/mattermost/package.json +28 -0
  2271. package/extensions/mattermost/src/channel.test.ts +72 -0
  2272. package/extensions/mattermost/src/channel.ts +337 -0
  2273. package/extensions/mattermost/src/config-schema.ts +56 -0
  2274. package/extensions/mattermost/src/group-mentions.ts +15 -0
  2275. package/extensions/mattermost/src/mattermost/accounts.ts +128 -0
  2276. package/extensions/mattermost/src/mattermost/client.ts +220 -0
  2277. package/extensions/mattermost/src/mattermost/index.ts +9 -0
  2278. package/extensions/mattermost/src/mattermost/monitor-helpers.ts +166 -0
  2279. package/extensions/mattermost/src/mattermost/monitor.ts +991 -0
  2280. package/extensions/mattermost/src/mattermost/probe.ts +74 -0
  2281. package/extensions/mattermost/src/mattermost/send.ts +231 -0
  2282. package/extensions/mattermost/src/normalize.ts +46 -0
  2283. package/extensions/mattermost/src/onboarding-helpers.ts +44 -0
  2284. package/extensions/mattermost/src/onboarding.ts +186 -0
  2285. package/extensions/mattermost/src/runtime.ts +14 -0
  2286. package/extensions/mattermost/src/types.ts +52 -0
  2287. package/extensions/memory-core/index.ts +38 -0
  2288. package/extensions/memory-core/node_modules/.bin/openclaw +21 -0
  2289. package/extensions/memory-core/openclaw.plugin.json +9 -0
  2290. package/extensions/memory-core/package.json +17 -0
  2291. package/extensions/memory-lancedb/config.ts +139 -0
  2292. package/extensions/memory-lancedb/index.test.ts +253 -0
  2293. package/extensions/memory-lancedb/index.ts +622 -0
  2294. package/extensions/memory-lancedb/node_modules/.bin/arrow2csv +21 -0
  2295. package/extensions/memory-lancedb/node_modules/.bin/openai +21 -0
  2296. package/extensions/memory-lancedb/node_modules/.bin/openclaw +21 -0
  2297. package/extensions/memory-lancedb/openclaw.plugin.json +60 -0
  2298. package/extensions/memory-lancedb/package.json +19 -0
  2299. package/extensions/minimax-portal-auth/README.md +33 -0
  2300. package/extensions/minimax-portal-auth/index.ts +155 -0
  2301. package/extensions/minimax-portal-auth/node_modules/.bin/openclaw +21 -0
  2302. package/extensions/minimax-portal-auth/oauth.ts +247 -0
  2303. package/extensions/minimax-portal-auth/openclaw.plugin.json +9 -0
  2304. package/extensions/minimax-portal-auth/package.json +14 -0
  2305. package/extensions/msteams/CHANGELOG.md +107 -0
  2306. package/extensions/msteams/index.ts +17 -0
  2307. package/extensions/msteams/node_modules/.bin/openclaw +21 -0
  2308. package/extensions/msteams/openclaw.plugin.json +9 -0
  2309. package/extensions/msteams/package.json +39 -0
  2310. package/extensions/msteams/src/attachments/download.ts +283 -0
  2311. package/extensions/msteams/src/attachments/graph.ts +353 -0
  2312. package/extensions/msteams/src/attachments/html.ts +90 -0
  2313. package/extensions/msteams/src/attachments/payload.ts +22 -0
  2314. package/extensions/msteams/src/attachments/shared.ts +291 -0
  2315. package/extensions/msteams/src/attachments/types.ts +37 -0
  2316. package/extensions/msteams/src/attachments.test.ts +459 -0
  2317. package/extensions/msteams/src/attachments.ts +18 -0
  2318. package/extensions/msteams/src/channel.directory.test.ts +48 -0
  2319. package/extensions/msteams/src/channel.ts +459 -0
  2320. package/extensions/msteams/src/conversation-store-fs.test.ts +88 -0
  2321. package/extensions/msteams/src/conversation-store-fs.ts +165 -0
  2322. package/extensions/msteams/src/conversation-store-memory.ts +47 -0
  2323. package/extensions/msteams/src/conversation-store.ts +41 -0
  2324. package/extensions/msteams/src/directory-live.ts +205 -0
  2325. package/extensions/msteams/src/errors.test.ts +45 -0
  2326. package/extensions/msteams/src/errors.ts +190 -0
  2327. package/extensions/msteams/src/file-consent-helpers.test.ts +243 -0
  2328. package/extensions/msteams/src/file-consent-helpers.ts +73 -0
  2329. package/extensions/msteams/src/file-consent.ts +126 -0
  2330. package/extensions/msteams/src/graph-chat.ts +53 -0
  2331. package/extensions/msteams/src/graph-upload.ts +453 -0
  2332. package/extensions/msteams/src/inbound.test.ts +66 -0
  2333. package/extensions/msteams/src/inbound.ts +48 -0
  2334. package/extensions/msteams/src/index.ts +4 -0
  2335. package/extensions/msteams/src/media-helpers.test.ts +189 -0
  2336. package/extensions/msteams/src/media-helpers.ts +86 -0
  2337. package/extensions/msteams/src/messenger.test.ts +248 -0
  2338. package/extensions/msteams/src/messenger.ts +495 -0
  2339. package/extensions/msteams/src/monitor-handler/inbound-media.ts +128 -0
  2340. package/extensions/msteams/src/monitor-handler/message-handler.ts +641 -0
  2341. package/extensions/msteams/src/monitor-handler.ts +162 -0
  2342. package/extensions/msteams/src/monitor-types.ts +5 -0
  2343. package/extensions/msteams/src/monitor.ts +295 -0
  2344. package/extensions/msteams/src/onboarding.ts +431 -0
  2345. package/extensions/msteams/src/outbound.ts +46 -0
  2346. package/extensions/msteams/src/pending-uploads.ts +89 -0
  2347. package/extensions/msteams/src/policy.test.ts +209 -0
  2348. package/extensions/msteams/src/policy.ts +273 -0
  2349. package/extensions/msteams/src/polls-store-memory.ts +32 -0
  2350. package/extensions/msteams/src/polls-store.test.ts +38 -0
  2351. package/extensions/msteams/src/polls.test.ts +72 -0
  2352. package/extensions/msteams/src/polls.ts +315 -0
  2353. package/extensions/msteams/src/probe.test.ts +58 -0
  2354. package/extensions/msteams/src/probe.ts +107 -0
  2355. package/extensions/msteams/src/reply-dispatcher.ts +132 -0
  2356. package/extensions/msteams/src/resolve-allowlist.ts +297 -0
  2357. package/extensions/msteams/src/runtime.ts +14 -0
  2358. package/extensions/msteams/src/sdk-types.ts +19 -0
  2359. package/extensions/msteams/src/sdk.ts +33 -0
  2360. package/extensions/msteams/src/send-context.ts +164 -0
  2361. package/extensions/msteams/src/send.ts +519 -0
  2362. package/extensions/msteams/src/sent-message-cache.test.ts +15 -0
  2363. package/extensions/msteams/src/sent-message-cache.ts +47 -0
  2364. package/extensions/msteams/src/storage.ts +25 -0
  2365. package/extensions/msteams/src/store-fs.ts +83 -0
  2366. package/extensions/msteams/src/token.ts +19 -0
  2367. package/extensions/nextcloud-talk/index.ts +17 -0
  2368. package/extensions/nextcloud-talk/node_modules/.bin/openclaw +21 -0
  2369. package/extensions/nextcloud-talk/openclaw.plugin.json +9 -0
  2370. package/extensions/nextcloud-talk/package.json +33 -0
  2371. package/extensions/nextcloud-talk/src/accounts.ts +174 -0
  2372. package/extensions/nextcloud-talk/src/channel.ts +409 -0
  2373. package/extensions/nextcloud-talk/src/config-schema.ts +79 -0
  2374. package/extensions/nextcloud-talk/src/format.ts +79 -0
  2375. package/extensions/nextcloud-talk/src/inbound.ts +327 -0
  2376. package/extensions/nextcloud-talk/src/monitor.ts +246 -0
  2377. package/extensions/nextcloud-talk/src/normalize.ts +39 -0
  2378. package/extensions/nextcloud-talk/src/onboarding.ts +343 -0
  2379. package/extensions/nextcloud-talk/src/policy.test.ts +33 -0
  2380. package/extensions/nextcloud-talk/src/policy.ts +180 -0
  2381. package/extensions/nextcloud-talk/src/room-info.ts +125 -0
  2382. package/extensions/nextcloud-talk/src/runtime.ts +14 -0
  2383. package/extensions/nextcloud-talk/src/send.ts +215 -0
  2384. package/extensions/nextcloud-talk/src/signature.ts +72 -0
  2385. package/extensions/nextcloud-talk/src/types.ts +181 -0
  2386. package/extensions/nostr/CHANGELOG.md +98 -0
  2387. package/extensions/nostr/README.md +136 -0
  2388. package/extensions/nostr/index.ts +68 -0
  2389. package/extensions/nostr/node_modules/.bin/openclaw +21 -0
  2390. package/extensions/nostr/node_modules/.bin/tsc +21 -0
  2391. package/extensions/nostr/node_modules/.bin/tsserver +21 -0
  2392. package/extensions/nostr/openclaw.plugin.json +9 -0
  2393. package/extensions/nostr/package.json +34 -0
  2394. package/extensions/nostr/src/channel.test.ts +151 -0
  2395. package/extensions/nostr/src/channel.ts +353 -0
  2396. package/extensions/nostr/src/config-schema.ts +90 -0
  2397. package/extensions/nostr/src/metrics.ts +478 -0
  2398. package/extensions/nostr/src/nostr-bus.fuzz.test.ts +533 -0
  2399. package/extensions/nostr/src/nostr-bus.integration.test.ts +448 -0
  2400. package/extensions/nostr/src/nostr-bus.test.ts +199 -0
  2401. package/extensions/nostr/src/nostr-bus.ts +715 -0
  2402. package/extensions/nostr/src/nostr-profile-http.test.ts +378 -0
  2403. package/extensions/nostr/src/nostr-profile-http.ts +546 -0
  2404. package/extensions/nostr/src/nostr-profile-import.test.ts +119 -0
  2405. package/extensions/nostr/src/nostr-profile-import.ts +262 -0
  2406. package/extensions/nostr/src/nostr-profile.fuzz.test.ts +477 -0
  2407. package/extensions/nostr/src/nostr-profile.test.ts +410 -0
  2408. package/extensions/nostr/src/nostr-profile.ts +277 -0
  2409. package/extensions/nostr/src/nostr-state-store.test.ts +131 -0
  2410. package/extensions/nostr/src/nostr-state-store.ts +226 -0
  2411. package/extensions/nostr/src/runtime.ts +14 -0
  2412. package/extensions/nostr/src/seen-tracker.ts +303 -0
  2413. package/extensions/nostr/src/types.test.ts +157 -0
  2414. package/extensions/nostr/src/types.ts +101 -0
  2415. package/extensions/nostr/test/setup.ts +5 -0
  2416. package/extensions/open-prose/README.md +25 -0
  2417. package/extensions/open-prose/index.ts +5 -0
  2418. package/extensions/open-prose/node_modules/.bin/openclaw +21 -0
  2419. package/extensions/open-prose/openclaw.plugin.json +11 -0
  2420. package/extensions/open-prose/package.json +14 -0
  2421. package/extensions/open-prose/skills/prose/LICENSE +21 -0
  2422. package/extensions/open-prose/skills/prose/SKILL.md +323 -0
  2423. package/extensions/open-prose/skills/prose/alt-borges.md +141 -0
  2424. package/extensions/open-prose/skills/prose/alts/arabian-nights.md +358 -0
  2425. package/extensions/open-prose/skills/prose/alts/borges.md +360 -0
  2426. package/extensions/open-prose/skills/prose/alts/folk.md +322 -0
  2427. package/extensions/open-prose/skills/prose/alts/homer.md +346 -0
  2428. package/extensions/open-prose/skills/prose/alts/kafka.md +373 -0
  2429. package/extensions/open-prose/skills/prose/compiler.md +2971 -0
  2430. package/extensions/open-prose/skills/prose/examples/01-hello-world.prose +4 -0
  2431. package/extensions/open-prose/skills/prose/examples/02-research-and-summarize.prose +6 -0
  2432. package/extensions/open-prose/skills/prose/examples/03-code-review.prose +17 -0
  2433. package/extensions/open-prose/skills/prose/examples/04-write-and-refine.prose +14 -0
  2434. package/extensions/open-prose/skills/prose/examples/05-debug-issue.prose +20 -0
  2435. package/extensions/open-prose/skills/prose/examples/06-explain-codebase.prose +17 -0
  2436. package/extensions/open-prose/skills/prose/examples/07-refactor.prose +20 -0
  2437. package/extensions/open-prose/skills/prose/examples/08-blog-post.prose +20 -0
  2438. package/extensions/open-prose/skills/prose/examples/09-research-with-agents.prose +25 -0
  2439. package/extensions/open-prose/skills/prose/examples/10-code-review-agents.prose +32 -0
  2440. package/extensions/open-prose/skills/prose/examples/11-skills-and-imports.prose +27 -0
  2441. package/extensions/open-prose/skills/prose/examples/12-secure-agent-permissions.prose +43 -0
  2442. package/extensions/open-prose/skills/prose/examples/13-variables-and-context.prose +51 -0
  2443. package/extensions/open-prose/skills/prose/examples/14-composition-blocks.prose +48 -0
  2444. package/extensions/open-prose/skills/prose/examples/15-inline-sequences.prose +23 -0
  2445. package/extensions/open-prose/skills/prose/examples/16-parallel-reviews.prose +19 -0
  2446. package/extensions/open-prose/skills/prose/examples/17-parallel-research.prose +19 -0
  2447. package/extensions/open-prose/skills/prose/examples/18-mixed-parallel-sequential.prose +36 -0
  2448. package/extensions/open-prose/skills/prose/examples/19-advanced-parallel.prose +71 -0
  2449. package/extensions/open-prose/skills/prose/examples/20-fixed-loops.prose +20 -0
  2450. package/extensions/open-prose/skills/prose/examples/21-pipeline-operations.prose +35 -0
  2451. package/extensions/open-prose/skills/prose/examples/22-error-handling.prose +51 -0
  2452. package/extensions/open-prose/skills/prose/examples/23-retry-with-backoff.prose +63 -0
  2453. package/extensions/open-prose/skills/prose/examples/24-choice-blocks.prose +86 -0
  2454. package/extensions/open-prose/skills/prose/examples/25-conditionals.prose +114 -0
  2455. package/extensions/open-prose/skills/prose/examples/26-parameterized-blocks.prose +100 -0
  2456. package/extensions/open-prose/skills/prose/examples/27-string-interpolation.prose +105 -0
  2457. package/extensions/open-prose/skills/prose/examples/28-automated-pr-review.prose +37 -0
  2458. package/extensions/open-prose/skills/prose/examples/28-gas-town.prose +1572 -0
  2459. package/extensions/open-prose/skills/prose/examples/29-captains-chair.prose +218 -0
  2460. package/extensions/open-prose/skills/prose/examples/30-captains-chair-simple.prose +42 -0
  2461. package/extensions/open-prose/skills/prose/examples/31-captains-chair-with-memory.prose +145 -0
  2462. package/extensions/open-prose/skills/prose/examples/33-pr-review-autofix.prose +168 -0
  2463. package/extensions/open-prose/skills/prose/examples/34-content-pipeline.prose +204 -0
  2464. package/extensions/open-prose/skills/prose/examples/35-feature-factory.prose +296 -0
  2465. package/extensions/open-prose/skills/prose/examples/36-bug-hunter.prose +237 -0
  2466. package/extensions/open-prose/skills/prose/examples/37-the-forge.prose +1474 -0
  2467. package/extensions/open-prose/skills/prose/examples/38-skill-scan.prose +455 -0
  2468. package/extensions/open-prose/skills/prose/examples/39-architect-by-simulation.prose +277 -0
  2469. package/extensions/open-prose/skills/prose/examples/40-rlm-self-refine.prose +32 -0
  2470. package/extensions/open-prose/skills/prose/examples/41-rlm-divide-conquer.prose +38 -0
  2471. package/extensions/open-prose/skills/prose/examples/42-rlm-filter-recurse.prose +46 -0
  2472. package/extensions/open-prose/skills/prose/examples/43-rlm-pairwise.prose +50 -0
  2473. package/extensions/open-prose/skills/prose/examples/44-run-endpoint-ux-test.prose +261 -0
  2474. package/extensions/open-prose/skills/prose/examples/45-plugin-release.prose +159 -0
  2475. package/extensions/open-prose/skills/prose/examples/45-run-endpoint-ux-test-with-remediation.prose +637 -0
  2476. package/extensions/open-prose/skills/prose/examples/46-run-endpoint-ux-test-fast.prose +148 -0
  2477. package/extensions/open-prose/skills/prose/examples/46-workflow-crystallizer.prose +225 -0
  2478. package/extensions/open-prose/skills/prose/examples/47-language-self-improvement.prose +356 -0
  2479. package/extensions/open-prose/skills/prose/examples/48-habit-miner.prose +445 -0
  2480. package/extensions/open-prose/skills/prose/examples/49-prose-run-retrospective.prose +210 -0
  2481. package/extensions/open-prose/skills/prose/examples/README.md +391 -0
  2482. package/extensions/open-prose/skills/prose/examples/roadmap/README.md +22 -0
  2483. package/extensions/open-prose/skills/prose/examples/roadmap/iterative-refinement.prose +20 -0
  2484. package/extensions/open-prose/skills/prose/examples/roadmap/parallel-review.prose +18 -0
  2485. package/extensions/open-prose/skills/prose/examples/roadmap/simple-pipeline.prose +17 -0
  2486. package/extensions/open-prose/skills/prose/examples/roadmap/syntax/open-prose-syntax.prose +223 -0
  2487. package/extensions/open-prose/skills/prose/guidance/antipatterns.md +951 -0
  2488. package/extensions/open-prose/skills/prose/guidance/patterns.md +700 -0
  2489. package/extensions/open-prose/skills/prose/guidance/system-prompt.md +180 -0
  2490. package/extensions/open-prose/skills/prose/help.md +144 -0
  2491. package/extensions/open-prose/skills/prose/lib/README.md +108 -0
  2492. package/extensions/open-prose/skills/prose/lib/calibrator.prose +215 -0
  2493. package/extensions/open-prose/skills/prose/lib/cost-analyzer.prose +174 -0
  2494. package/extensions/open-prose/skills/prose/lib/error-forensics.prose +250 -0
  2495. package/extensions/open-prose/skills/prose/lib/inspector.prose +196 -0
  2496. package/extensions/open-prose/skills/prose/lib/profiler.prose +460 -0
  2497. package/extensions/open-prose/skills/prose/lib/program-improver.prose +275 -0
  2498. package/extensions/open-prose/skills/prose/lib/project-memory.prose +118 -0
  2499. package/extensions/open-prose/skills/prose/lib/user-memory.prose +93 -0
  2500. package/extensions/open-prose/skills/prose/lib/vm-improver.prose +243 -0
  2501. package/extensions/open-prose/skills/prose/primitives/session.md +593 -0
  2502. package/extensions/open-prose/skills/prose/prose.md +1237 -0
  2503. package/extensions/open-prose/skills/prose/state/filesystem.md +498 -0
  2504. package/extensions/open-prose/skills/prose/state/in-context.md +384 -0
  2505. package/extensions/open-prose/skills/prose/state/postgres.md +880 -0
  2506. package/extensions/open-prose/skills/prose/state/sqlite.md +574 -0
  2507. package/extensions/qwen-portal-auth/README.md +24 -0
  2508. package/extensions/qwen-portal-auth/index.ts +130 -0
  2509. package/extensions/qwen-portal-auth/oauth.ts +190 -0
  2510. package/extensions/qwen-portal-auth/openclaw.plugin.json +9 -0
  2511. package/extensions/signal/index.ts +17 -0
  2512. package/extensions/signal/node_modules/.bin/openclaw +21 -0
  2513. package/extensions/signal/openclaw.plugin.json +9 -0
  2514. package/extensions/signal/package.json +14 -0
  2515. package/extensions/signal/src/channel.ts +315 -0
  2516. package/extensions/signal/src/runtime.ts +14 -0
  2517. package/extensions/slack/index.ts +17 -0
  2518. package/extensions/slack/node_modules/.bin/openclaw +21 -0
  2519. package/extensions/slack/openclaw.plugin.json +9 -0
  2520. package/extensions/slack/package.json +14 -0
  2521. package/extensions/slack/src/channel.ts +604 -0
  2522. package/extensions/slack/src/runtime.ts +14 -0
  2523. package/extensions/telegram/index.ts +17 -0
  2524. package/extensions/telegram/node_modules/.bin/openclaw +21 -0
  2525. package/extensions/telegram/openclaw.plugin.json +9 -0
  2526. package/extensions/telegram/package.json +14 -0
  2527. package/extensions/telegram/src/channel.ts +482 -0
  2528. package/extensions/telegram/src/runtime.ts +14 -0
  2529. package/extensions/tlon/README.md +5 -0
  2530. package/extensions/tlon/index.ts +17 -0
  2531. package/extensions/tlon/node_modules/.bin/openclaw +21 -0
  2532. package/extensions/tlon/openclaw.plugin.json +9 -0
  2533. package/extensions/tlon/package.json +33 -0
  2534. package/extensions/tlon/src/channel.ts +392 -0
  2535. package/extensions/tlon/src/config-schema.test.ts +31 -0
  2536. package/extensions/tlon/src/config-schema.ts +45 -0
  2537. package/extensions/tlon/src/monitor/discovery.ts +76 -0
  2538. package/extensions/tlon/src/monitor/history.ts +90 -0
  2539. package/extensions/tlon/src/monitor/index.ts +580 -0
  2540. package/extensions/tlon/src/monitor/processed-messages.test.ts +23 -0
  2541. package/extensions/tlon/src/monitor/processed-messages.ts +46 -0
  2542. package/extensions/tlon/src/monitor/utils.ts +106 -0
  2543. package/extensions/tlon/src/onboarding.ts +214 -0
  2544. package/extensions/tlon/src/runtime.ts +14 -0
  2545. package/extensions/tlon/src/targets.ts +89 -0
  2546. package/extensions/tlon/src/types.ts +92 -0
  2547. package/extensions/tlon/src/urbit/auth.ts +18 -0
  2548. package/extensions/tlon/src/urbit/http-api.ts +38 -0
  2549. package/extensions/tlon/src/urbit/send.test.ts +38 -0
  2550. package/extensions/tlon/src/urbit/send.ts +131 -0
  2551. package/extensions/tlon/src/urbit/sse-client.test.ts +40 -0
  2552. package/extensions/tlon/src/urbit/sse-client.ts +395 -0
  2553. package/extensions/twitch/CHANGELOG.md +69 -0
  2554. package/extensions/twitch/README.md +89 -0
  2555. package/extensions/twitch/index.ts +20 -0
  2556. package/extensions/twitch/node_modules/.bin/openclaw +21 -0
  2557. package/extensions/twitch/openclaw.plugin.json +9 -0
  2558. package/extensions/twitch/package.json +20 -0
  2559. package/extensions/twitch/src/access-control.test.ts +489 -0
  2560. package/extensions/twitch/src/access-control.ts +166 -0
  2561. package/extensions/twitch/src/actions.ts +173 -0
  2562. package/extensions/twitch/src/client-manager-registry.ts +115 -0
  2563. package/extensions/twitch/src/config-schema.ts +84 -0
  2564. package/extensions/twitch/src/config.test.ts +87 -0
  2565. package/extensions/twitch/src/config.ts +116 -0
  2566. package/extensions/twitch/src/monitor.ts +272 -0
  2567. package/extensions/twitch/src/onboarding.test.ts +311 -0
  2568. package/extensions/twitch/src/onboarding.ts +417 -0
  2569. package/extensions/twitch/src/outbound.test.ts +373 -0
  2570. package/extensions/twitch/src/outbound.ts +184 -0
  2571. package/extensions/twitch/src/plugin.test.ts +39 -0
  2572. package/extensions/twitch/src/plugin.ts +274 -0
  2573. package/extensions/twitch/src/probe.test.ts +195 -0
  2574. package/extensions/twitch/src/probe.ts +120 -0
  2575. package/extensions/twitch/src/resolver.ts +137 -0
  2576. package/extensions/twitch/src/runtime.ts +14 -0
  2577. package/extensions/twitch/src/send.test.ts +289 -0
  2578. package/extensions/twitch/src/send.ts +136 -0
  2579. package/extensions/twitch/src/status.test.ts +270 -0
  2580. package/extensions/twitch/src/status.ts +178 -0
  2581. package/extensions/twitch/src/token.test.ts +171 -0
  2582. package/extensions/twitch/src/token.ts +91 -0
  2583. package/extensions/twitch/src/twitch-client.test.ts +589 -0
  2584. package/extensions/twitch/src/twitch-client.ts +277 -0
  2585. package/extensions/twitch/src/types.ts +143 -0
  2586. package/extensions/twitch/src/utils/markdown.ts +98 -0
  2587. package/extensions/twitch/src/utils/twitch.ts +78 -0
  2588. package/extensions/twitch/test/setup.ts +7 -0
  2589. package/extensions/voice-call/CHANGELOG.md +133 -0
  2590. package/extensions/voice-call/README.md +139 -0
  2591. package/extensions/voice-call/index.ts +493 -0
  2592. package/extensions/voice-call/node_modules/.bin/openclaw +21 -0
  2593. package/extensions/voice-call/openclaw.plugin.json +559 -0
  2594. package/extensions/voice-call/package.json +19 -0
  2595. package/extensions/voice-call/src/allowlist.ts +19 -0
  2596. package/extensions/voice-call/src/cli.ts +279 -0
  2597. package/extensions/voice-call/src/config.test.ts +234 -0
  2598. package/extensions/voice-call/src/config.ts +523 -0
  2599. package/extensions/voice-call/src/core-bridge.ts +159 -0
  2600. package/extensions/voice-call/src/manager/context.ts +21 -0
  2601. package/extensions/voice-call/src/manager/events.ts +188 -0
  2602. package/extensions/voice-call/src/manager/lookup.ts +35 -0
  2603. package/extensions/voice-call/src/manager/outbound.ts +275 -0
  2604. package/extensions/voice-call/src/manager/state.ts +48 -0
  2605. package/extensions/voice-call/src/manager/store.ts +91 -0
  2606. package/extensions/voice-call/src/manager/timers.ts +89 -0
  2607. package/extensions/voice-call/src/manager/twiml.ts +9 -0
  2608. package/extensions/voice-call/src/manager.test.ts +224 -0
  2609. package/extensions/voice-call/src/manager.ts +887 -0
  2610. package/extensions/voice-call/src/media-stream.test.ts +96 -0
  2611. package/extensions/voice-call/src/media-stream.ts +411 -0
  2612. package/extensions/voice-call/src/providers/base.ts +67 -0
  2613. package/extensions/voice-call/src/providers/index.ts +10 -0
  2614. package/extensions/voice-call/src/providers/mock.ts +165 -0
  2615. package/extensions/voice-call/src/providers/plivo.test.ts +27 -0
  2616. package/extensions/voice-call/src/providers/plivo.ts +515 -0
  2617. package/extensions/voice-call/src/providers/stt-openai-realtime.ts +311 -0
  2618. package/extensions/voice-call/src/providers/telnyx.ts +371 -0
  2619. package/extensions/voice-call/src/providers/tts-openai.ts +259 -0
  2620. package/extensions/voice-call/src/providers/twilio/api.ts +42 -0
  2621. package/extensions/voice-call/src/providers/twilio/webhook.ts +32 -0
  2622. package/extensions/voice-call/src/providers/twilio.test.ts +60 -0
  2623. package/extensions/voice-call/src/providers/twilio.ts +626 -0
  2624. package/extensions/voice-call/src/response-generator.ts +158 -0
  2625. package/extensions/voice-call/src/runtime.ts +212 -0
  2626. package/extensions/voice-call/src/telephony-audio.ts +90 -0
  2627. package/extensions/voice-call/src/telephony-tts.ts +104 -0
  2628. package/extensions/voice-call/src/tunnel.ts +314 -0
  2629. package/extensions/voice-call/src/types.ts +272 -0
  2630. package/extensions/voice-call/src/utils.ts +14 -0
  2631. package/extensions/voice-call/src/voice-mapping.ts +67 -0
  2632. package/extensions/voice-call/src/webhook-security.test.ts +377 -0
  2633. package/extensions/voice-call/src/webhook-security.ts +689 -0
  2634. package/extensions/voice-call/src/webhook.ts +516 -0
  2635. package/extensions/whatsapp/index.ts +17 -0
  2636. package/extensions/whatsapp/node_modules/.bin/openclaw +21 -0
  2637. package/extensions/whatsapp/openclaw.plugin.json +9 -0
  2638. package/extensions/whatsapp/package.json +14 -0
  2639. package/extensions/whatsapp/src/channel.ts +508 -0
  2640. package/extensions/whatsapp/src/runtime.ts +14 -0
  2641. package/extensions/zalo/CHANGELOG.md +113 -0
  2642. package/extensions/zalo/README.md +50 -0
  2643. package/extensions/zalo/index.ts +19 -0
  2644. package/extensions/zalo/node_modules/.bin/openclaw +21 -0
  2645. package/extensions/zalo/openclaw.plugin.json +9 -0
  2646. package/extensions/zalo/package.json +36 -0
  2647. package/extensions/zalo/src/accounts.ts +80 -0
  2648. package/extensions/zalo/src/actions.ts +67 -0
  2649. package/extensions/zalo/src/api.ts +208 -0
  2650. package/extensions/zalo/src/channel.directory.test.ts +43 -0
  2651. package/extensions/zalo/src/channel.ts +414 -0
  2652. package/extensions/zalo/src/config-schema.ts +25 -0
  2653. package/extensions/zalo/src/monitor.ts +764 -0
  2654. package/extensions/zalo/src/monitor.webhook.test.ts +73 -0
  2655. package/extensions/zalo/src/onboarding.ts +401 -0
  2656. package/extensions/zalo/src/probe.ts +46 -0
  2657. package/extensions/zalo/src/proxy.ts +21 -0
  2658. package/extensions/zalo/src/runtime.ts +14 -0
  2659. package/extensions/zalo/src/send.ts +124 -0
  2660. package/extensions/zalo/src/status-issues.ts +53 -0
  2661. package/extensions/zalo/src/token.ts +63 -0
  2662. package/extensions/zalo/src/types.ts +44 -0
  2663. package/extensions/zalouser/CHANGELOG.md +85 -0
  2664. package/extensions/zalouser/README.md +225 -0
  2665. package/extensions/zalouser/index.ts +31 -0
  2666. package/extensions/zalouser/node_modules/.bin/openclaw +21 -0
  2667. package/extensions/zalouser/openclaw.plugin.json +9 -0
  2668. package/extensions/zalouser/package.json +36 -0
  2669. package/extensions/zalouser/src/accounts.ts +135 -0
  2670. package/extensions/zalouser/src/channel.test.ts +18 -0
  2671. package/extensions/zalouser/src/channel.ts +686 -0
  2672. package/extensions/zalouser/src/config-schema.ts +28 -0
  2673. package/extensions/zalouser/src/monitor.ts +601 -0
  2674. package/extensions/zalouser/src/onboarding.ts +504 -0
  2675. package/extensions/zalouser/src/probe.ts +28 -0
  2676. package/extensions/zalouser/src/runtime.ts +14 -0
  2677. package/extensions/zalouser/src/send.ts +160 -0
  2678. package/extensions/zalouser/src/status-issues.test.ts +57 -0
  2679. package/extensions/zalouser/src/status-issues.ts +89 -0
  2680. package/extensions/zalouser/src/tool.ts +164 -0
  2681. package/extensions/zalouser/src/types.ts +110 -0
  2682. package/extensions/zalouser/src/zca.ts +202 -0
  2683. package/openclaw.mjs +33 -0
  2684. package/package.json +234 -0
  2685. package/skills/1password/SKILL.md +70 -0
  2686. package/skills/1password/references/cli-examples.md +29 -0
  2687. package/skills/1password/references/get-started.md +17 -0
  2688. package/skills/apple-notes/SKILL.md +77 -0
  2689. package/skills/apple-reminders/SKILL.md +96 -0
  2690. package/skills/bear-notes/SKILL.md +107 -0
  2691. package/skills/blogwatcher/SKILL.md +69 -0
  2692. package/skills/blucli/SKILL.md +47 -0
  2693. package/skills/bluebubbles/SKILL.md +131 -0
  2694. package/skills/camsnap/SKILL.md +45 -0
  2695. package/skills/canvas/SKILL.md +198 -0
  2696. package/skills/clawhub/SKILL.md +77 -0
  2697. package/skills/coding-agent/SKILL.md +284 -0
  2698. package/skills/discord/SKILL.md +578 -0
  2699. package/skills/eightctl/SKILL.md +50 -0
  2700. package/skills/food-order/SKILL.md +48 -0
  2701. package/skills/gemini/SKILL.md +43 -0
  2702. package/skills/gifgrep/SKILL.md +79 -0
  2703. package/skills/github/SKILL.md +77 -0
  2704. package/skills/gog/SKILL.md +116 -0
  2705. package/skills/goplaces/SKILL.md +52 -0
  2706. package/skills/healthcheck/SKILL.md +245 -0
  2707. package/skills/himalaya/SKILL.md +257 -0
  2708. package/skills/himalaya/references/configuration.md +184 -0
  2709. package/skills/himalaya/references/message-composition.md +199 -0
  2710. package/skills/imsg/SKILL.md +74 -0
  2711. package/skills/local-places/SERVER_README.md +101 -0
  2712. package/skills/local-places/SKILL.md +102 -0
  2713. package/skills/local-places/pyproject.toml +21 -0
  2714. package/skills/local-places/src/local_places/__init__.py +2 -0
  2715. package/skills/local-places/src/local_places/google_places.py +314 -0
  2716. package/skills/local-places/src/local_places/main.py +65 -0
  2717. package/skills/local-places/src/local_places/schemas.py +107 -0
  2718. package/skills/mcporter/SKILL.md +61 -0
  2719. package/skills/model-usage/SKILL.md +69 -0
  2720. package/skills/model-usage/references/codexbar-cli.md +33 -0
  2721. package/skills/model-usage/scripts/model_usage.py +310 -0
  2722. package/skills/nano-banana-pro/SKILL.md +58 -0
  2723. package/skills/nano-banana-pro/scripts/generate_image.py +184 -0
  2724. package/skills/nano-pdf/SKILL.md +38 -0
  2725. package/skills/notion/SKILL.md +172 -0
  2726. package/skills/obsidian/SKILL.md +81 -0
  2727. package/skills/openai-image-gen/SKILL.md +89 -0
  2728. package/skills/openai-image-gen/scripts/gen.py +240 -0
  2729. package/skills/openai-whisper/SKILL.md +38 -0
  2730. package/skills/openai-whisper-api/SKILL.md +52 -0
  2731. package/skills/openai-whisper-api/scripts/transcribe.sh +85 -0
  2732. package/skills/openhue/SKILL.md +51 -0
  2733. package/skills/oracle/SKILL.md +125 -0
  2734. package/skills/ordercli/SKILL.md +78 -0
  2735. package/skills/peekaboo/SKILL.md +190 -0
  2736. package/skills/sag/SKILL.md +87 -0
  2737. package/skills/session-logs/SKILL.md +115 -0
  2738. package/skills/sherpa-onnx-tts/SKILL.md +103 -0
  2739. package/skills/sherpa-onnx-tts/bin/sherpa-onnx-tts +178 -0
  2740. package/skills/skill-creator/SKILL.md +370 -0
  2741. package/skills/skill-creator/license.txt +202 -0
  2742. package/skills/skill-creator/scripts/init_skill.py +378 -0
  2743. package/skills/skill-creator/scripts/package_skill.py +111 -0
  2744. package/skills/skill-creator/scripts/quick_validate.py +101 -0
  2745. package/skills/slack/SKILL.md +144 -0
  2746. package/skills/songsee/SKILL.md +49 -0
  2747. package/skills/sonoscli/SKILL.md +46 -0
  2748. package/skills/spotify-player/SKILL.md +64 -0
  2749. package/skills/summarize/SKILL.md +87 -0
  2750. package/skills/things-mac/SKILL.md +86 -0
  2751. package/skills/tmux/SKILL.md +135 -0
  2752. package/skills/tmux/scripts/find-sessions.sh +112 -0
  2753. package/skills/tmux/scripts/wait-for-text.sh +83 -0
  2754. package/skills/trello/SKILL.md +95 -0
  2755. package/skills/video-frames/SKILL.md +46 -0
  2756. package/skills/video-frames/scripts/frame.sh +81 -0
  2757. package/skills/voice-call/SKILL.md +45 -0
  2758. package/skills/wacli/SKILL.md +72 -0
  2759. package/skills/weather/SKILL.md +54 -0
@@ -0,0 +1,4921 @@
1
+ import { t as __exportAll } from "./rolldown-runtime-Cbj13DAv.js";
2
+ import { B as resolveConfigPath, F as CONFIG_PATH, G as resolveIsNixMode, H as resolveDefaultConfigCandidates, I as DEFAULT_GATEWAY_PORT, J as resolveOAuthDir, K as resolveLegacyStateDirs, L as STATE_DIR, R as isNixMode, U as resolveGatewayLockDir, V as resolveConfigPathCandidate, W as resolveGatewayPort, X as resolveStateDir, Y as resolveOAuthPath, Z as CHANNEL_IDS, ot as normalizeChatChannelId, q as resolveNewStateDir, z as resolveCanonicalConfigPath } from "./entry.js";
3
+ import { A as parseModelRef, dt as loadShellEnvFallback, ft as resolveShellEnvFallbackTimeoutMs, mt as shouldEnableShellEnvFallback, pt as shouldDeferShellEnvFallback, vt as DEFAULT_CONTEXT_TOKENS } from "./auth-profiles-DYdLc1cj.js";
4
+ import { l as normalizeAgentId, n as DEFAULT_AGENT_ID } from "./session-key-Dk6vSAOv.js";
5
+ import { m as resolveUserPath } from "./utils-DX85MiPR.js";
6
+ import { c as resolveDefaultAgentId, s as resolveAgentWorkspaceDir } from "./agent-scope-jAWKj2TP.js";
7
+ import { c as resolveEnableState, l as resolveMemorySlotDecision, s as normalizePluginsConfig, t as loadPluginManifestRegistry } from "./manifest-registry-C69Z-I4v.js";
8
+ import { createRequire } from "node:module";
9
+ import path from "node:path";
10
+ import os from "node:os";
11
+ import fs from "node:fs";
12
+ import JSON5 from "json5";
13
+ import crypto from "node:crypto";
14
+ import AjvPkg from "ajv";
15
+ import { z } from "zod";
16
+
17
+ //#region src/version.ts
18
+ const CORE_PACKAGE_NAME = "openclaw";
19
+ const PACKAGE_JSON_CANDIDATES = [
20
+ "../package.json",
21
+ "../../package.json",
22
+ "../../../package.json",
23
+ "./package.json"
24
+ ];
25
+ const BUILD_INFO_CANDIDATES = [
26
+ "../build-info.json",
27
+ "../../build-info.json",
28
+ "./build-info.json"
29
+ ];
30
+ function readVersionFromJsonCandidates(moduleUrl, candidates, opts = {}) {
31
+ try {
32
+ const require = createRequire(moduleUrl);
33
+ for (const candidate of candidates) try {
34
+ const parsed = require(candidate);
35
+ const version = parsed.version?.trim();
36
+ if (!version) continue;
37
+ if (opts.requirePackageName && parsed.name !== CORE_PACKAGE_NAME) continue;
38
+ return version;
39
+ } catch {}
40
+ return null;
41
+ } catch {
42
+ return null;
43
+ }
44
+ }
45
+ function readVersionFromPackageJsonForModuleUrl(moduleUrl) {
46
+ return readVersionFromJsonCandidates(moduleUrl, PACKAGE_JSON_CANDIDATES, { requirePackageName: true });
47
+ }
48
+ function readVersionFromBuildInfoForModuleUrl(moduleUrl) {
49
+ return readVersionFromJsonCandidates(moduleUrl, BUILD_INFO_CANDIDATES);
50
+ }
51
+ function resolveVersionFromModuleUrl(moduleUrl) {
52
+ return readVersionFromPackageJsonForModuleUrl(moduleUrl) || readVersionFromBuildInfoForModuleUrl(moduleUrl);
53
+ }
54
+ const VERSION = typeof __OPENCLAW_VERSION__ === "string" && __OPENCLAW_VERSION__ || process.env.OPENCLAW_BUNDLED_VERSION || resolveVersionFromModuleUrl(import.meta.url) || "0.0.0";
55
+
56
+ //#endregion
57
+ //#region src/config/agent-dirs.ts
58
+ var DuplicateAgentDirError = class extends Error {
59
+ constructor(duplicates) {
60
+ super(formatDuplicateAgentDirError(duplicates));
61
+ this.name = "DuplicateAgentDirError";
62
+ this.duplicates = duplicates;
63
+ }
64
+ };
65
+ function canonicalizeAgentDir(agentDir) {
66
+ const resolved = path.resolve(agentDir);
67
+ if (process.platform === "darwin" || process.platform === "win32") return resolved.toLowerCase();
68
+ return resolved;
69
+ }
70
+ function collectReferencedAgentIds(cfg) {
71
+ const ids = /* @__PURE__ */ new Set();
72
+ const agents = Array.isArray(cfg.agents?.list) ? cfg.agents?.list : [];
73
+ const defaultAgentId = agents.find((agent) => agent?.default)?.id ?? agents[0]?.id ?? DEFAULT_AGENT_ID;
74
+ ids.add(normalizeAgentId(defaultAgentId));
75
+ for (const entry of agents) if (entry?.id) ids.add(normalizeAgentId(entry.id));
76
+ const bindings = cfg.bindings;
77
+ if (Array.isArray(bindings)) for (const binding of bindings) {
78
+ const id = binding?.agentId;
79
+ if (typeof id === "string" && id.trim()) ids.add(normalizeAgentId(id));
80
+ }
81
+ return [...ids];
82
+ }
83
+ function resolveEffectiveAgentDir(cfg, agentId, deps) {
84
+ const id = normalizeAgentId(agentId);
85
+ const trimmed = (Array.isArray(cfg.agents?.list) ? cfg.agents?.list.find((agent) => normalizeAgentId(agent.id) === id)?.agentDir : void 0)?.trim();
86
+ if (trimmed) return resolveUserPath(trimmed);
87
+ const root = resolveStateDir(deps?.env ?? process.env, deps?.homedir ?? os.homedir);
88
+ return path.join(root, "agents", id, "agent");
89
+ }
90
+ function findDuplicateAgentDirs(cfg, deps) {
91
+ const byDir = /* @__PURE__ */ new Map();
92
+ for (const agentId of collectReferencedAgentIds(cfg)) {
93
+ const agentDir = resolveEffectiveAgentDir(cfg, agentId, deps);
94
+ const key = canonicalizeAgentDir(agentDir);
95
+ const entry = byDir.get(key);
96
+ if (entry) entry.agentIds.push(agentId);
97
+ else byDir.set(key, {
98
+ agentDir,
99
+ agentIds: [agentId]
100
+ });
101
+ }
102
+ return [...byDir.values()].filter((v) => v.agentIds.length > 1);
103
+ }
104
+ function formatDuplicateAgentDirError(dups) {
105
+ return [
106
+ "Duplicate agentDir detected (multi-agent config).",
107
+ "Each agent must have a unique agentDir; sharing it causes auth/session state collisions and token invalidation.",
108
+ "",
109
+ "Conflicts:",
110
+ ...dups.map((d) => `- ${d.agentDir}: ${d.agentIds.map((id) => `"${id}"`).join(", ")}`),
111
+ "",
112
+ "Fix: remove the shared agents.list[].agentDir override (or give each agent its own directory).",
113
+ "If you want to share credentials, copy auth-profiles.json instead of sharing the entire agentDir."
114
+ ].join("\n");
115
+ }
116
+
117
+ //#endregion
118
+ //#region src/config/agent-limits.ts
119
+ const DEFAULT_AGENT_MAX_CONCURRENT = 4;
120
+ const DEFAULT_SUBAGENT_MAX_CONCURRENT = 8;
121
+ function resolveAgentMaxConcurrent(cfg) {
122
+ const raw = cfg?.agents?.defaults?.maxConcurrent;
123
+ if (typeof raw === "number" && Number.isFinite(raw)) return Math.max(1, Math.floor(raw));
124
+ return DEFAULT_AGENT_MAX_CONCURRENT;
125
+ }
126
+ function resolveSubagentMaxConcurrent(cfg) {
127
+ const raw = cfg?.agents?.defaults?.subagents?.maxConcurrent;
128
+ if (typeof raw === "number" && Number.isFinite(raw)) return Math.max(1, Math.floor(raw));
129
+ return DEFAULT_SUBAGENT_MAX_CONCURRENT;
130
+ }
131
+
132
+ //#endregion
133
+ //#region src/config/talk.ts
134
+ function readTalkApiKeyFromProfile(deps = {}) {
135
+ const fsImpl = deps.fs ?? fs;
136
+ const osImpl = deps.os ?? os;
137
+ const pathImpl = deps.path ?? path;
138
+ const home = osImpl.homedir();
139
+ const candidates = [
140
+ ".profile",
141
+ ".zprofile",
142
+ ".zshrc",
143
+ ".bashrc"
144
+ ].map((name) => pathImpl.join(home, name));
145
+ for (const candidate of candidates) {
146
+ if (!fsImpl.existsSync(candidate)) continue;
147
+ try {
148
+ const value = fsImpl.readFileSync(candidate, "utf-8").match(/(?:^|\n)\s*(?:export\s+)?ELEVENLABS_API_KEY\s*=\s*["']?([^\n"']+)["']?/)?.[1]?.trim();
149
+ if (value) return value;
150
+ } catch {}
151
+ }
152
+ return null;
153
+ }
154
+ function resolveTalkApiKey(env = process.env, deps = {}) {
155
+ const envValue = (env.ELEVENLABS_API_KEY ?? "").trim();
156
+ if (envValue) return envValue;
157
+ return readTalkApiKeyFromProfile(deps);
158
+ }
159
+
160
+ //#endregion
161
+ //#region src/config/defaults.ts
162
+ let defaultWarnState = { warned: false };
163
+ const DEFAULT_MODEL_ALIASES = {
164
+ opus: "anthropic/claude-opus-4-6",
165
+ sonnet: "anthropic/claude-sonnet-4-5",
166
+ gpt: "openai/gpt-5.2",
167
+ "gpt-mini": "openai/gpt-5-mini",
168
+ gemini: "google/gemini-3-pro-preview",
169
+ "gemini-flash": "google/gemini-3-flash-preview"
170
+ };
171
+ const DEFAULT_MODEL_COST = {
172
+ input: 0,
173
+ output: 0,
174
+ cacheRead: 0,
175
+ cacheWrite: 0
176
+ };
177
+ const DEFAULT_MODEL_INPUT = ["text"];
178
+ const DEFAULT_MODEL_MAX_TOKENS = 8192;
179
+ function isPositiveNumber(value) {
180
+ return typeof value === "number" && Number.isFinite(value) && value > 0;
181
+ }
182
+ function resolveModelCost(raw) {
183
+ return {
184
+ input: typeof raw?.input === "number" ? raw.input : DEFAULT_MODEL_COST.input,
185
+ output: typeof raw?.output === "number" ? raw.output : DEFAULT_MODEL_COST.output,
186
+ cacheRead: typeof raw?.cacheRead === "number" ? raw.cacheRead : DEFAULT_MODEL_COST.cacheRead,
187
+ cacheWrite: typeof raw?.cacheWrite === "number" ? raw.cacheWrite : DEFAULT_MODEL_COST.cacheWrite
188
+ };
189
+ }
190
+ function resolveAnthropicDefaultAuthMode(cfg) {
191
+ const profiles = cfg.auth?.profiles ?? {};
192
+ const anthropicProfiles = Object.entries(profiles).filter(([, profile]) => profile?.provider === "anthropic");
193
+ const order = cfg.auth?.order?.anthropic ?? [];
194
+ for (const profileId of order) {
195
+ const entry = profiles[profileId];
196
+ if (!entry || entry.provider !== "anthropic") continue;
197
+ if (entry.mode === "api_key") return "api_key";
198
+ if (entry.mode === "oauth" || entry.mode === "token") return "oauth";
199
+ }
200
+ const hasApiKey = anthropicProfiles.some(([, profile]) => profile?.mode === "api_key");
201
+ const hasOauth = anthropicProfiles.some(([, profile]) => profile?.mode === "oauth" || profile?.mode === "token");
202
+ if (hasApiKey && !hasOauth) return "api_key";
203
+ if (hasOauth && !hasApiKey) return "oauth";
204
+ if (process.env.ANTHROPIC_OAUTH_TOKEN?.trim()) return "oauth";
205
+ if (process.env.ANTHROPIC_API_KEY?.trim()) return "api_key";
206
+ return null;
207
+ }
208
+ function resolvePrimaryModelRef(raw) {
209
+ if (!raw || typeof raw !== "string") return null;
210
+ const trimmed = raw.trim();
211
+ if (!trimmed) return null;
212
+ return DEFAULT_MODEL_ALIASES[trimmed.toLowerCase()] ?? trimmed;
213
+ }
214
+ function applyMessageDefaults(cfg) {
215
+ const messages = cfg.messages;
216
+ if (messages?.ackReactionScope !== void 0) return cfg;
217
+ const nextMessages = messages ? { ...messages } : {};
218
+ nextMessages.ackReactionScope = "group-mentions";
219
+ return {
220
+ ...cfg,
221
+ messages: nextMessages
222
+ };
223
+ }
224
+ function applySessionDefaults(cfg, options = {}) {
225
+ const session = cfg.session;
226
+ if (!session || session.mainKey === void 0) return cfg;
227
+ const trimmed = session.mainKey.trim();
228
+ const warn = options.warn ?? console.warn;
229
+ const warnState = options.warnState ?? defaultWarnState;
230
+ const next = {
231
+ ...cfg,
232
+ session: {
233
+ ...session,
234
+ mainKey: "main"
235
+ }
236
+ };
237
+ if (trimmed && trimmed !== "main" && !warnState.warned) {
238
+ warnState.warned = true;
239
+ warn("session.mainKey is ignored; main session is always \"main\".");
240
+ }
241
+ return next;
242
+ }
243
+ function applyTalkApiKey(config) {
244
+ const resolved = resolveTalkApiKey();
245
+ if (!resolved) return config;
246
+ if (config.talk?.apiKey?.trim()) return config;
247
+ return {
248
+ ...config,
249
+ talk: {
250
+ ...config.talk,
251
+ apiKey: resolved
252
+ }
253
+ };
254
+ }
255
+ function applyModelDefaults(cfg) {
256
+ let mutated = false;
257
+ let nextCfg = cfg;
258
+ const providerConfig = nextCfg.models?.providers;
259
+ if (providerConfig) {
260
+ const nextProviders = { ...providerConfig };
261
+ for (const [providerId, provider] of Object.entries(providerConfig)) {
262
+ const models = provider.models;
263
+ if (!Array.isArray(models) || models.length === 0) continue;
264
+ let providerMutated = false;
265
+ const nextModels = models.map((model) => {
266
+ const raw = model;
267
+ let modelMutated = false;
268
+ const reasoning = typeof raw.reasoning === "boolean" ? raw.reasoning : false;
269
+ if (raw.reasoning !== reasoning) modelMutated = true;
270
+ const input = raw.input ?? [...DEFAULT_MODEL_INPUT];
271
+ if (raw.input === void 0) modelMutated = true;
272
+ const cost = resolveModelCost(raw.cost);
273
+ if (!raw.cost || raw.cost.input !== cost.input || raw.cost.output !== cost.output || raw.cost.cacheRead !== cost.cacheRead || raw.cost.cacheWrite !== cost.cacheWrite) modelMutated = true;
274
+ const contextWindow = isPositiveNumber(raw.contextWindow) ? raw.contextWindow : DEFAULT_CONTEXT_TOKENS;
275
+ if (raw.contextWindow !== contextWindow) modelMutated = true;
276
+ const defaultMaxTokens = Math.min(DEFAULT_MODEL_MAX_TOKENS, contextWindow);
277
+ const maxTokens = isPositiveNumber(raw.maxTokens) ? raw.maxTokens : defaultMaxTokens;
278
+ if (raw.maxTokens !== maxTokens) modelMutated = true;
279
+ if (!modelMutated) return model;
280
+ providerMutated = true;
281
+ return {
282
+ ...raw,
283
+ reasoning,
284
+ input,
285
+ cost,
286
+ contextWindow,
287
+ maxTokens
288
+ };
289
+ });
290
+ if (!providerMutated) continue;
291
+ nextProviders[providerId] = {
292
+ ...provider,
293
+ models: nextModels
294
+ };
295
+ mutated = true;
296
+ }
297
+ if (mutated) nextCfg = {
298
+ ...nextCfg,
299
+ models: {
300
+ ...nextCfg.models,
301
+ providers: nextProviders
302
+ }
303
+ };
304
+ }
305
+ const existingAgent = nextCfg.agents?.defaults;
306
+ if (!existingAgent) return mutated ? nextCfg : cfg;
307
+ const existingModels = existingAgent.models ?? {};
308
+ if (Object.keys(existingModels).length === 0) return mutated ? nextCfg : cfg;
309
+ const nextModels = { ...existingModels };
310
+ for (const [alias, target] of Object.entries(DEFAULT_MODEL_ALIASES)) {
311
+ const entry = nextModels[target];
312
+ if (!entry) continue;
313
+ if (entry.alias !== void 0) continue;
314
+ nextModels[target] = {
315
+ ...entry,
316
+ alias
317
+ };
318
+ mutated = true;
319
+ }
320
+ if (!mutated) return cfg;
321
+ return {
322
+ ...nextCfg,
323
+ agents: {
324
+ ...nextCfg.agents,
325
+ defaults: {
326
+ ...existingAgent,
327
+ models: nextModels
328
+ }
329
+ }
330
+ };
331
+ }
332
+ function applyAgentDefaults(cfg) {
333
+ const agents = cfg.agents;
334
+ const defaults = agents?.defaults;
335
+ const hasMax = typeof defaults?.maxConcurrent === "number" && Number.isFinite(defaults.maxConcurrent);
336
+ const hasSubMax = typeof defaults?.subagents?.maxConcurrent === "number" && Number.isFinite(defaults.subagents.maxConcurrent);
337
+ if (hasMax && hasSubMax) return cfg;
338
+ let mutated = false;
339
+ const nextDefaults = defaults ? { ...defaults } : {};
340
+ if (!hasMax) {
341
+ nextDefaults.maxConcurrent = DEFAULT_AGENT_MAX_CONCURRENT;
342
+ mutated = true;
343
+ }
344
+ const nextSubagents = defaults?.subagents ? { ...defaults.subagents } : {};
345
+ if (!hasSubMax) {
346
+ nextSubagents.maxConcurrent = DEFAULT_SUBAGENT_MAX_CONCURRENT;
347
+ mutated = true;
348
+ }
349
+ if (!mutated) return cfg;
350
+ return {
351
+ ...cfg,
352
+ agents: {
353
+ ...agents,
354
+ defaults: {
355
+ ...nextDefaults,
356
+ subagents: nextSubagents
357
+ }
358
+ }
359
+ };
360
+ }
361
+ function applyLoggingDefaults(cfg) {
362
+ const logging = cfg.logging;
363
+ if (!logging) return cfg;
364
+ if (logging.redactSensitive) return cfg;
365
+ return {
366
+ ...cfg,
367
+ logging: {
368
+ ...logging,
369
+ redactSensitive: "tools"
370
+ }
371
+ };
372
+ }
373
+ function applyContextPruningDefaults(cfg) {
374
+ const defaults = cfg.agents?.defaults;
375
+ if (!defaults) return cfg;
376
+ const authMode = resolveAnthropicDefaultAuthMode(cfg);
377
+ if (!authMode) return cfg;
378
+ let mutated = false;
379
+ const nextDefaults = { ...defaults };
380
+ const contextPruning = defaults.contextPruning ?? {};
381
+ const heartbeat = defaults.heartbeat ?? {};
382
+ if (defaults.contextPruning?.mode === void 0) {
383
+ nextDefaults.contextPruning = {
384
+ ...contextPruning,
385
+ mode: "cache-ttl",
386
+ ttl: defaults.contextPruning?.ttl ?? "1h"
387
+ };
388
+ mutated = true;
389
+ }
390
+ if (defaults.heartbeat?.every === void 0) {
391
+ nextDefaults.heartbeat = {
392
+ ...heartbeat,
393
+ every: authMode === "oauth" ? "1h" : "30m"
394
+ };
395
+ mutated = true;
396
+ }
397
+ if (authMode === "api_key") {
398
+ const nextModels = defaults.models ? { ...defaults.models } : {};
399
+ let modelsMutated = false;
400
+ for (const [key, entry] of Object.entries(nextModels)) {
401
+ const parsed = parseModelRef(key, "anthropic");
402
+ if (!parsed || parsed.provider !== "anthropic") continue;
403
+ const current = entry ?? {};
404
+ const params = current.params ?? {};
405
+ if (typeof params.cacheRetention === "string") continue;
406
+ nextModels[key] = {
407
+ ...current,
408
+ params: {
409
+ ...params,
410
+ cacheRetention: "short"
411
+ }
412
+ };
413
+ modelsMutated = true;
414
+ }
415
+ const primary = resolvePrimaryModelRef(defaults.model?.primary ?? void 0);
416
+ if (primary) {
417
+ const parsedPrimary = parseModelRef(primary, "anthropic");
418
+ if (parsedPrimary?.provider === "anthropic") {
419
+ const key = `${parsedPrimary.provider}/${parsedPrimary.model}`;
420
+ const current = nextModels[key] ?? {};
421
+ const params = current.params ?? {};
422
+ if (typeof params.cacheRetention !== "string") {
423
+ nextModels[key] = {
424
+ ...current,
425
+ params: {
426
+ ...params,
427
+ cacheRetention: "short"
428
+ }
429
+ };
430
+ modelsMutated = true;
431
+ }
432
+ }
433
+ }
434
+ if (modelsMutated) {
435
+ nextDefaults.models = nextModels;
436
+ mutated = true;
437
+ }
438
+ }
439
+ if (!mutated) return cfg;
440
+ return {
441
+ ...cfg,
442
+ agents: {
443
+ ...cfg.agents,
444
+ defaults: nextDefaults
445
+ }
446
+ };
447
+ }
448
+ function applyCompactionDefaults(cfg) {
449
+ const defaults = cfg.agents?.defaults;
450
+ if (!defaults) return cfg;
451
+ const compaction = defaults?.compaction;
452
+ if (compaction?.mode) return cfg;
453
+ return {
454
+ ...cfg,
455
+ agents: {
456
+ ...cfg.agents,
457
+ defaults: {
458
+ ...defaults,
459
+ compaction: {
460
+ ...compaction,
461
+ mode: "safeguard"
462
+ }
463
+ }
464
+ }
465
+ };
466
+ }
467
+
468
+ //#endregion
469
+ //#region src/config/env-substitution.ts
470
+ /**
471
+ * Environment variable substitution for config values.
472
+ *
473
+ * Supports `${VAR_NAME}` syntax in string values, substituted at config load time.
474
+ * - Only uppercase env vars are matched: `[A-Z_][A-Z0-9_]*`
475
+ * - Escape with `$${}` to output literal `${}`
476
+ * - Missing env vars throw `MissingEnvVarError` with context
477
+ *
478
+ * @example
479
+ * ```json5
480
+ * {
481
+ * models: {
482
+ * providers: {
483
+ * "vercel-gateway": {
484
+ * apiKey: "${VERCEL_GATEWAY_API_KEY}"
485
+ * }
486
+ * }
487
+ * }
488
+ * }
489
+ * ```
490
+ */
491
+ const ENV_VAR_NAME_PATTERN = /^[A-Z_][A-Z0-9_]*$/;
492
+ var MissingEnvVarError = class extends Error {
493
+ constructor(varName, configPath) {
494
+ super(`Missing env var "${varName}" referenced at config path: ${configPath}`);
495
+ this.varName = varName;
496
+ this.configPath = configPath;
497
+ this.name = "MissingEnvVarError";
498
+ }
499
+ };
500
+ function isPlainObject$4(value) {
501
+ return typeof value === "object" && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
502
+ }
503
+ function substituteString(value, env, configPath) {
504
+ if (!value.includes("$")) return value;
505
+ const chunks = [];
506
+ for (let i = 0; i < value.length; i += 1) {
507
+ const char = value[i];
508
+ if (char !== "$") {
509
+ chunks.push(char);
510
+ continue;
511
+ }
512
+ const next = value[i + 1];
513
+ const afterNext = value[i + 2];
514
+ if (next === "$" && afterNext === "{") {
515
+ const start = i + 3;
516
+ const end = value.indexOf("}", start);
517
+ if (end !== -1) {
518
+ const name = value.slice(start, end);
519
+ if (ENV_VAR_NAME_PATTERN.test(name)) {
520
+ chunks.push(`\${${name}}`);
521
+ i = end;
522
+ continue;
523
+ }
524
+ }
525
+ }
526
+ if (next === "{") {
527
+ const start = i + 2;
528
+ const end = value.indexOf("}", start);
529
+ if (end !== -1) {
530
+ const name = value.slice(start, end);
531
+ if (ENV_VAR_NAME_PATTERN.test(name)) {
532
+ const envValue = env[name];
533
+ if (envValue === void 0 || envValue === "") throw new MissingEnvVarError(name, configPath);
534
+ chunks.push(envValue);
535
+ i = end;
536
+ continue;
537
+ }
538
+ }
539
+ }
540
+ chunks.push(char);
541
+ }
542
+ return chunks.join("");
543
+ }
544
+ function substituteAny(value, env, path) {
545
+ if (typeof value === "string") return substituteString(value, env, path);
546
+ if (Array.isArray(value)) return value.map((item, index) => substituteAny(item, env, `${path}[${index}]`));
547
+ if (isPlainObject$4(value)) {
548
+ const result = {};
549
+ for (const [key, val] of Object.entries(value)) result[key] = substituteAny(val, env, path ? `${path}.${key}` : key);
550
+ return result;
551
+ }
552
+ return value;
553
+ }
554
+ /**
555
+ * Resolves `${VAR_NAME}` environment variable references in config values.
556
+ *
557
+ * @param obj - The parsed config object (after JSON5 parse and $include resolution)
558
+ * @param env - Environment variables to use for substitution (defaults to process.env)
559
+ * @returns The config object with env vars substituted
560
+ * @throws {MissingEnvVarError} If a referenced env var is not set or empty
561
+ */
562
+ function resolveConfigEnvVars(obj, env = process.env) {
563
+ return substituteAny(obj, env, "");
564
+ }
565
+
566
+ //#endregion
567
+ //#region src/config/env-vars.ts
568
+ function collectConfigEnvVars(cfg) {
569
+ const envConfig = cfg?.env;
570
+ if (!envConfig) return {};
571
+ const entries = {};
572
+ if (envConfig.vars) for (const [key, value] of Object.entries(envConfig.vars)) {
573
+ if (!value) continue;
574
+ entries[key] = value;
575
+ }
576
+ for (const [key, value] of Object.entries(envConfig)) {
577
+ if (key === "shellEnv" || key === "vars") continue;
578
+ if (typeof value !== "string" || !value.trim()) continue;
579
+ entries[key] = value;
580
+ }
581
+ return entries;
582
+ }
583
+
584
+ //#endregion
585
+ //#region src/config/includes.ts
586
+ /**
587
+ * Config includes: $include directive for modular configs
588
+ *
589
+ * @example
590
+ * ```json5
591
+ * {
592
+ * "$include": "./base.json5", // single file
593
+ * "$include": ["./a.json5", "./b.json5"] // merge multiple
594
+ * }
595
+ * ```
596
+ */
597
+ const INCLUDE_KEY = "$include";
598
+ const MAX_INCLUDE_DEPTH = 10;
599
+ var ConfigIncludeError = class extends Error {
600
+ constructor(message, includePath, cause) {
601
+ super(message);
602
+ this.includePath = includePath;
603
+ this.cause = cause;
604
+ this.name = "ConfigIncludeError";
605
+ }
606
+ };
607
+ var CircularIncludeError = class extends ConfigIncludeError {
608
+ constructor(chain) {
609
+ super(`Circular include detected: ${chain.join(" -> ")}`, chain[chain.length - 1]);
610
+ this.chain = chain;
611
+ this.name = "CircularIncludeError";
612
+ }
613
+ };
614
+ function isPlainObject$3(value) {
615
+ return typeof value === "object" && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
616
+ }
617
+ /** Deep merge: arrays concatenate, objects merge recursively, primitives: source wins */
618
+ function deepMerge(target, source) {
619
+ if (Array.isArray(target) && Array.isArray(source)) return [...target, ...source];
620
+ if (isPlainObject$3(target) && isPlainObject$3(source)) {
621
+ const result = { ...target };
622
+ for (const key of Object.keys(source)) result[key] = key in result ? deepMerge(result[key], source[key]) : source[key];
623
+ return result;
624
+ }
625
+ return source;
626
+ }
627
+ var IncludeProcessor = class IncludeProcessor {
628
+ constructor(basePath, resolver) {
629
+ this.basePath = basePath;
630
+ this.resolver = resolver;
631
+ this.visited = /* @__PURE__ */ new Set();
632
+ this.depth = 0;
633
+ this.visited.add(path.normalize(basePath));
634
+ }
635
+ process(obj) {
636
+ if (Array.isArray(obj)) return obj.map((item) => this.process(item));
637
+ if (!isPlainObject$3(obj)) return obj;
638
+ if (!(INCLUDE_KEY in obj)) return this.processObject(obj);
639
+ return this.processInclude(obj);
640
+ }
641
+ processObject(obj) {
642
+ const result = {};
643
+ for (const [key, value] of Object.entries(obj)) result[key] = this.process(value);
644
+ return result;
645
+ }
646
+ processInclude(obj) {
647
+ const includeValue = obj[INCLUDE_KEY];
648
+ const otherKeys = Object.keys(obj).filter((k) => k !== INCLUDE_KEY);
649
+ const included = this.resolveInclude(includeValue);
650
+ if (otherKeys.length === 0) return included;
651
+ if (!isPlainObject$3(included)) throw new ConfigIncludeError("Sibling keys require included content to be an object", typeof includeValue === "string" ? includeValue : INCLUDE_KEY);
652
+ const rest = {};
653
+ for (const key of otherKeys) rest[key] = this.process(obj[key]);
654
+ return deepMerge(included, rest);
655
+ }
656
+ resolveInclude(value) {
657
+ if (typeof value === "string") return this.loadFile(value);
658
+ if (Array.isArray(value)) return value.reduce((merged, item) => {
659
+ if (typeof item !== "string") throw new ConfigIncludeError(`Invalid $include array item: expected string, got ${typeof item}`, String(item));
660
+ return deepMerge(merged, this.loadFile(item));
661
+ }, {});
662
+ throw new ConfigIncludeError(`Invalid $include value: expected string or array of strings, got ${typeof value}`, String(value));
663
+ }
664
+ loadFile(includePath) {
665
+ const resolvedPath = this.resolvePath(includePath);
666
+ this.checkCircular(resolvedPath);
667
+ this.checkDepth(includePath);
668
+ const raw = this.readFile(includePath, resolvedPath);
669
+ const parsed = this.parseFile(includePath, resolvedPath, raw);
670
+ return this.processNested(resolvedPath, parsed);
671
+ }
672
+ resolvePath(includePath) {
673
+ const resolved = path.isAbsolute(includePath) ? includePath : path.resolve(path.dirname(this.basePath), includePath);
674
+ return path.normalize(resolved);
675
+ }
676
+ checkCircular(resolvedPath) {
677
+ if (this.visited.has(resolvedPath)) throw new CircularIncludeError([...this.visited, resolvedPath]);
678
+ }
679
+ checkDepth(includePath) {
680
+ if (this.depth >= MAX_INCLUDE_DEPTH) throw new ConfigIncludeError(`Maximum include depth (${MAX_INCLUDE_DEPTH}) exceeded at: ${includePath}`, includePath);
681
+ }
682
+ readFile(includePath, resolvedPath) {
683
+ try {
684
+ return this.resolver.readFile(resolvedPath);
685
+ } catch (err) {
686
+ throw new ConfigIncludeError(`Failed to read include file: ${includePath} (resolved: ${resolvedPath})`, includePath, err instanceof Error ? err : void 0);
687
+ }
688
+ }
689
+ parseFile(includePath, resolvedPath, raw) {
690
+ try {
691
+ return this.resolver.parseJson(raw);
692
+ } catch (err) {
693
+ throw new ConfigIncludeError(`Failed to parse include file: ${includePath} (resolved: ${resolvedPath})`, includePath, err instanceof Error ? err : void 0);
694
+ }
695
+ }
696
+ processNested(resolvedPath, parsed) {
697
+ const nested = new IncludeProcessor(resolvedPath, this.resolver);
698
+ nested.visited = new Set([...this.visited, resolvedPath]);
699
+ nested.depth = this.depth + 1;
700
+ return nested.process(parsed);
701
+ }
702
+ };
703
+ const defaultResolver = {
704
+ readFile: (p) => fs.readFileSync(p, "utf-8"),
705
+ parseJson: (raw) => JSON5.parse(raw)
706
+ };
707
+ /**
708
+ * Resolves all $include directives in a parsed config object.
709
+ */
710
+ function resolveConfigIncludes(obj, configPath, resolver = defaultResolver) {
711
+ return new IncludeProcessor(configPath, resolver).process(obj);
712
+ }
713
+
714
+ //#endregion
715
+ //#region src/config/legacy.shared.ts
716
+ const isRecord$1 = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
717
+ const getRecord = (value) => isRecord$1(value) ? value : null;
718
+ const ensureRecord = (root, key) => {
719
+ const existing = root[key];
720
+ if (isRecord$1(existing)) return existing;
721
+ const next = {};
722
+ root[key] = next;
723
+ return next;
724
+ };
725
+ const mergeMissing = (target, source) => {
726
+ for (const [key, value] of Object.entries(source)) {
727
+ if (value === void 0) continue;
728
+ const existing = target[key];
729
+ if (existing === void 0) {
730
+ target[key] = value;
731
+ continue;
732
+ }
733
+ if (isRecord$1(existing) && isRecord$1(value)) mergeMissing(existing, value);
734
+ }
735
+ };
736
+ const AUDIO_TRANSCRIPTION_CLI_ALLOWLIST = new Set(["whisper"]);
737
+ const mapLegacyAudioTranscription = (value) => {
738
+ const transcriber = getRecord(value);
739
+ const command = Array.isArray(transcriber?.command) ? transcriber?.command : null;
740
+ if (!command || command.length === 0) return null;
741
+ const rawExecutable = String(command[0] ?? "").trim();
742
+ if (!rawExecutable) return null;
743
+ const executableName = rawExecutable.split(/[\\/]/).pop() ?? rawExecutable;
744
+ if (!AUDIO_TRANSCRIPTION_CLI_ALLOWLIST.has(executableName)) return null;
745
+ const args = command.slice(1).map((part) => String(part));
746
+ const timeoutSeconds = typeof transcriber?.timeoutSeconds === "number" ? transcriber?.timeoutSeconds : void 0;
747
+ const result = {
748
+ command: rawExecutable,
749
+ type: "cli"
750
+ };
751
+ if (args.length > 0) result.args = args;
752
+ if (timeoutSeconds !== void 0) result.timeoutSeconds = timeoutSeconds;
753
+ return result;
754
+ };
755
+ const getAgentsList = (agents) => {
756
+ const list = agents?.list;
757
+ return Array.isArray(list) ? list : [];
758
+ };
759
+ const resolveDefaultAgentIdFromRaw = (raw) => {
760
+ const list = getAgentsList(getRecord(raw.agents));
761
+ const defaultEntry = list.find((entry) => isRecord$1(entry) && entry.default === true && typeof entry.id === "string" && entry.id.trim() !== "");
762
+ if (defaultEntry) return defaultEntry.id.trim();
763
+ const routing = getRecord(raw.routing);
764
+ const routingDefault = typeof routing?.defaultAgentId === "string" ? routing.defaultAgentId.trim() : "";
765
+ if (routingDefault) return routingDefault;
766
+ const firstEntry = list.find((entry) => isRecord$1(entry) && typeof entry.id === "string" && entry.id.trim() !== "");
767
+ if (firstEntry) return firstEntry.id.trim();
768
+ return "main";
769
+ };
770
+ const ensureAgentEntry = (list, id) => {
771
+ const normalized = id.trim();
772
+ const existing = list.find((entry) => isRecord$1(entry) && typeof entry.id === "string" && entry.id.trim() === normalized);
773
+ if (existing) return existing;
774
+ const created = { id: normalized };
775
+ list.push(created);
776
+ return created;
777
+ };
778
+
779
+ //#endregion
780
+ //#region src/config/legacy.migrations.part-1.ts
781
+ const LEGACY_CONFIG_MIGRATIONS_PART_1 = [
782
+ {
783
+ id: "bindings.match.provider->bindings.match.channel",
784
+ describe: "Move bindings[].match.provider to bindings[].match.channel",
785
+ apply: (raw, changes) => {
786
+ const bindings = Array.isArray(raw.bindings) ? raw.bindings : null;
787
+ if (!bindings) return;
788
+ let touched = false;
789
+ for (const entry of bindings) {
790
+ if (!isRecord$1(entry)) continue;
791
+ const match = getRecord(entry.match);
792
+ if (!match) continue;
793
+ if (typeof match.channel === "string" && match.channel.trim()) continue;
794
+ const provider = typeof match.provider === "string" ? match.provider.trim() : "";
795
+ if (!provider) continue;
796
+ match.channel = provider;
797
+ delete match.provider;
798
+ entry.match = match;
799
+ touched = true;
800
+ }
801
+ if (touched) {
802
+ raw.bindings = bindings;
803
+ changes.push("Moved bindings[].match.provider → bindings[].match.channel.");
804
+ }
805
+ }
806
+ },
807
+ {
808
+ id: "bindings.match.accountID->bindings.match.accountId",
809
+ describe: "Move bindings[].match.accountID to bindings[].match.accountId",
810
+ apply: (raw, changes) => {
811
+ const bindings = Array.isArray(raw.bindings) ? raw.bindings : null;
812
+ if (!bindings) return;
813
+ let touched = false;
814
+ for (const entry of bindings) {
815
+ if (!isRecord$1(entry)) continue;
816
+ const match = getRecord(entry.match);
817
+ if (!match) continue;
818
+ if (match.accountId !== void 0) continue;
819
+ const accountID = typeof match.accountID === "string" ? match.accountID.trim() : match.accountID;
820
+ if (!accountID) continue;
821
+ match.accountId = accountID;
822
+ delete match.accountID;
823
+ entry.match = match;
824
+ touched = true;
825
+ }
826
+ if (touched) {
827
+ raw.bindings = bindings;
828
+ changes.push("Moved bindings[].match.accountID → bindings[].match.accountId.");
829
+ }
830
+ }
831
+ },
832
+ {
833
+ id: "session.sendPolicy.rules.match.provider->match.channel",
834
+ describe: "Move session.sendPolicy.rules[].match.provider to match.channel",
835
+ apply: (raw, changes) => {
836
+ const session = getRecord(raw.session);
837
+ if (!session) return;
838
+ const sendPolicy = getRecord(session.sendPolicy);
839
+ if (!sendPolicy) return;
840
+ const rules = Array.isArray(sendPolicy.rules) ? sendPolicy.rules : null;
841
+ if (!rules) return;
842
+ let touched = false;
843
+ for (const rule of rules) {
844
+ if (!isRecord$1(rule)) continue;
845
+ const match = getRecord(rule.match);
846
+ if (!match) continue;
847
+ if (typeof match.channel === "string" && match.channel.trim()) continue;
848
+ const provider = typeof match.provider === "string" ? match.provider.trim() : "";
849
+ if (!provider) continue;
850
+ match.channel = provider;
851
+ delete match.provider;
852
+ rule.match = match;
853
+ touched = true;
854
+ }
855
+ if (touched) {
856
+ sendPolicy.rules = rules;
857
+ session.sendPolicy = sendPolicy;
858
+ raw.session = session;
859
+ changes.push("Moved session.sendPolicy.rules[].match.provider → match.channel.");
860
+ }
861
+ }
862
+ },
863
+ {
864
+ id: "messages.queue.byProvider->byChannel",
865
+ describe: "Move messages.queue.byProvider to messages.queue.byChannel",
866
+ apply: (raw, changes) => {
867
+ const messages = getRecord(raw.messages);
868
+ if (!messages) return;
869
+ const queue = getRecord(messages.queue);
870
+ if (!queue) return;
871
+ if (queue.byProvider === void 0) return;
872
+ if (queue.byChannel === void 0) {
873
+ queue.byChannel = queue.byProvider;
874
+ changes.push("Moved messages.queue.byProvider → messages.queue.byChannel.");
875
+ } else changes.push("Removed messages.queue.byProvider (messages.queue.byChannel already set).");
876
+ delete queue.byProvider;
877
+ messages.queue = queue;
878
+ raw.messages = messages;
879
+ }
880
+ },
881
+ {
882
+ id: "providers->channels",
883
+ describe: "Move provider config sections to channels.*",
884
+ apply: (raw, changes) => {
885
+ const legacyEntries = [
886
+ "whatsapp",
887
+ "telegram",
888
+ "discord",
889
+ "slack",
890
+ "signal",
891
+ "imessage",
892
+ "msteams"
893
+ ].filter((key) => isRecord$1(raw[key]));
894
+ if (legacyEntries.length === 0) return;
895
+ const channels = ensureRecord(raw, "channels");
896
+ for (const key of legacyEntries) {
897
+ const legacy = getRecord(raw[key]);
898
+ if (!legacy) continue;
899
+ const channelEntry = ensureRecord(channels, key);
900
+ const hadEntries = Object.keys(channelEntry).length > 0;
901
+ mergeMissing(channelEntry, legacy);
902
+ channels[key] = channelEntry;
903
+ delete raw[key];
904
+ changes.push(hadEntries ? `Merged ${key} → channels.${key}.` : `Moved ${key} → channels.${key}.`);
905
+ }
906
+ raw.channels = channels;
907
+ }
908
+ },
909
+ {
910
+ id: "routing.allowFrom->channels.whatsapp.allowFrom",
911
+ describe: "Move routing.allowFrom to channels.whatsapp.allowFrom",
912
+ apply: (raw, changes) => {
913
+ const routing = raw.routing;
914
+ if (!routing || typeof routing !== "object") return;
915
+ const allowFrom = routing.allowFrom;
916
+ if (allowFrom === void 0) return;
917
+ const channels = getRecord(raw.channels);
918
+ const whatsapp = channels ? getRecord(channels.whatsapp) : null;
919
+ if (!whatsapp) {
920
+ delete routing.allowFrom;
921
+ if (Object.keys(routing).length === 0) delete raw.routing;
922
+ changes.push("Removed routing.allowFrom (channels.whatsapp not configured).");
923
+ return;
924
+ }
925
+ if (whatsapp.allowFrom === void 0) {
926
+ whatsapp.allowFrom = allowFrom;
927
+ changes.push("Moved routing.allowFrom → channels.whatsapp.allowFrom.");
928
+ } else changes.push("Removed routing.allowFrom (channels.whatsapp.allowFrom already set).");
929
+ delete routing.allowFrom;
930
+ if (Object.keys(routing).length === 0) delete raw.routing;
931
+ channels.whatsapp = whatsapp;
932
+ raw.channels = channels;
933
+ }
934
+ },
935
+ {
936
+ id: "routing.groupChat.requireMention->groups.*.requireMention",
937
+ describe: "Move routing.groupChat.requireMention to channels.whatsapp/telegram/imessage groups",
938
+ apply: (raw, changes) => {
939
+ const routing = raw.routing;
940
+ if (!routing || typeof routing !== "object") return;
941
+ const groupChat = routing.groupChat && typeof routing.groupChat === "object" ? routing.groupChat : null;
942
+ if (!groupChat) return;
943
+ const requireMention = groupChat.requireMention;
944
+ if (requireMention === void 0) return;
945
+ const channels = ensureRecord(raw, "channels");
946
+ const applyTo = (key, options) => {
947
+ if (options?.requireExisting && !isRecord$1(channels[key])) return;
948
+ const section = channels[key] && typeof channels[key] === "object" ? channels[key] : {};
949
+ const groups = section.groups && typeof section.groups === "object" ? section.groups : {};
950
+ const defaultKey = "*";
951
+ const entry = groups[defaultKey] && typeof groups[defaultKey] === "object" ? groups[defaultKey] : {};
952
+ if (entry.requireMention === void 0) {
953
+ entry.requireMention = requireMention;
954
+ groups[defaultKey] = entry;
955
+ section.groups = groups;
956
+ channels[key] = section;
957
+ changes.push(`Moved routing.groupChat.requireMention → channels.${key}.groups."*".requireMention.`);
958
+ } else changes.push(`Removed routing.groupChat.requireMention (channels.${key}.groups."*" already set).`);
959
+ };
960
+ applyTo("whatsapp", { requireExisting: true });
961
+ applyTo("telegram");
962
+ applyTo("imessage");
963
+ delete groupChat.requireMention;
964
+ if (Object.keys(groupChat).length === 0) delete routing.groupChat;
965
+ if (Object.keys(routing).length === 0) delete raw.routing;
966
+ raw.channels = channels;
967
+ }
968
+ },
969
+ {
970
+ id: "gateway.token->gateway.auth.token",
971
+ describe: "Move gateway.token to gateway.auth.token",
972
+ apply: (raw, changes) => {
973
+ const gateway = raw.gateway;
974
+ if (!gateway || typeof gateway !== "object") return;
975
+ const token = gateway.token;
976
+ if (token === void 0) return;
977
+ const gatewayObj = gateway;
978
+ const auth = gatewayObj.auth && typeof gatewayObj.auth === "object" ? gatewayObj.auth : {};
979
+ if (auth.token === void 0) {
980
+ auth.token = token;
981
+ if (!auth.mode) auth.mode = "token";
982
+ changes.push("Moved gateway.token → gateway.auth.token.");
983
+ } else changes.push("Removed gateway.token (gateway.auth.token already set).");
984
+ delete gatewayObj.token;
985
+ if (Object.keys(auth).length > 0) gatewayObj.auth = auth;
986
+ raw.gateway = gatewayObj;
987
+ }
988
+ },
989
+ {
990
+ id: "telegram.requireMention->channels.telegram.groups.*.requireMention",
991
+ describe: "Move telegram.requireMention to channels.telegram.groups.*.requireMention",
992
+ apply: (raw, changes) => {
993
+ const channels = ensureRecord(raw, "channels");
994
+ const telegram = channels.telegram;
995
+ if (!telegram || typeof telegram !== "object") return;
996
+ const requireMention = telegram.requireMention;
997
+ if (requireMention === void 0) return;
998
+ const groups = telegram.groups && typeof telegram.groups === "object" ? telegram.groups : {};
999
+ const defaultKey = "*";
1000
+ const entry = groups[defaultKey] && typeof groups[defaultKey] === "object" ? groups[defaultKey] : {};
1001
+ if (entry.requireMention === void 0) {
1002
+ entry.requireMention = requireMention;
1003
+ groups[defaultKey] = entry;
1004
+ telegram.groups = groups;
1005
+ changes.push("Moved telegram.requireMention → channels.telegram.groups.\"*\".requireMention.");
1006
+ } else changes.push("Removed telegram.requireMention (channels.telegram.groups.\"*\" already set).");
1007
+ delete telegram.requireMention;
1008
+ channels.telegram = telegram;
1009
+ raw.channels = channels;
1010
+ }
1011
+ }
1012
+ ];
1013
+
1014
+ //#endregion
1015
+ //#region src/config/legacy.migrations.part-2.ts
1016
+ const LEGACY_CONFIG_MIGRATIONS_PART_2 = [
1017
+ {
1018
+ id: "agent.model-config-v2",
1019
+ describe: "Migrate legacy agent.model/allowedModels/modelAliases/modelFallbacks/imageModelFallbacks to agent.models + model lists",
1020
+ apply: (raw, changes) => {
1021
+ const agentRoot = getRecord(raw.agent);
1022
+ const defaults = getRecord(getRecord(raw.agents)?.defaults);
1023
+ const agent = agentRoot ?? defaults;
1024
+ if (!agent) return;
1025
+ const label = agentRoot ? "agent" : "agents.defaults";
1026
+ const legacyModel = typeof agent.model === "string" ? String(agent.model) : void 0;
1027
+ const legacyImageModel = typeof agent.imageModel === "string" ? String(agent.imageModel) : void 0;
1028
+ const legacyAllowed = Array.isArray(agent.allowedModels) ? agent.allowedModels.map(String) : [];
1029
+ const legacyModelFallbacks = Array.isArray(agent.modelFallbacks) ? agent.modelFallbacks.map(String) : [];
1030
+ const legacyImageModelFallbacks = Array.isArray(agent.imageModelFallbacks) ? agent.imageModelFallbacks.map(String) : [];
1031
+ const legacyAliases = agent.modelAliases && typeof agent.modelAliases === "object" ? agent.modelAliases : {};
1032
+ if (!(legacyModel || legacyImageModel || legacyAllowed.length > 0 || legacyModelFallbacks.length > 0 || legacyImageModelFallbacks.length > 0 || Object.keys(legacyAliases).length > 0)) return;
1033
+ const models = agent.models && typeof agent.models === "object" ? agent.models : {};
1034
+ const ensureModel = (rawKey) => {
1035
+ if (typeof rawKey !== "string") return;
1036
+ const key = rawKey.trim();
1037
+ if (!key) return;
1038
+ if (!models[key]) models[key] = {};
1039
+ };
1040
+ ensureModel(legacyModel);
1041
+ ensureModel(legacyImageModel);
1042
+ for (const key of legacyAllowed) ensureModel(key);
1043
+ for (const key of legacyModelFallbacks) ensureModel(key);
1044
+ for (const key of legacyImageModelFallbacks) ensureModel(key);
1045
+ for (const target of Object.values(legacyAliases)) {
1046
+ if (typeof target !== "string") continue;
1047
+ ensureModel(target);
1048
+ }
1049
+ for (const [alias, targetRaw] of Object.entries(legacyAliases)) {
1050
+ if (typeof targetRaw !== "string") continue;
1051
+ const target = targetRaw.trim();
1052
+ if (!target) continue;
1053
+ const entry = models[target] && typeof models[target] === "object" ? models[target] : {};
1054
+ if (!("alias" in entry)) {
1055
+ entry.alias = alias;
1056
+ models[target] = entry;
1057
+ }
1058
+ }
1059
+ const currentModel = agent.model && typeof agent.model === "object" ? agent.model : null;
1060
+ if (currentModel) {
1061
+ if (!currentModel.primary && legacyModel) currentModel.primary = legacyModel;
1062
+ if (legacyModelFallbacks.length > 0 && (!Array.isArray(currentModel.fallbacks) || currentModel.fallbacks.length === 0)) currentModel.fallbacks = legacyModelFallbacks;
1063
+ agent.model = currentModel;
1064
+ } else if (legacyModel || legacyModelFallbacks.length > 0) agent.model = {
1065
+ primary: legacyModel,
1066
+ fallbacks: legacyModelFallbacks.length ? legacyModelFallbacks : []
1067
+ };
1068
+ const currentImageModel = agent.imageModel && typeof agent.imageModel === "object" ? agent.imageModel : null;
1069
+ if (currentImageModel) {
1070
+ if (!currentImageModel.primary && legacyImageModel) currentImageModel.primary = legacyImageModel;
1071
+ if (legacyImageModelFallbacks.length > 0 && (!Array.isArray(currentImageModel.fallbacks) || currentImageModel.fallbacks.length === 0)) currentImageModel.fallbacks = legacyImageModelFallbacks;
1072
+ agent.imageModel = currentImageModel;
1073
+ } else if (legacyImageModel || legacyImageModelFallbacks.length > 0) agent.imageModel = {
1074
+ primary: legacyImageModel,
1075
+ fallbacks: legacyImageModelFallbacks.length ? legacyImageModelFallbacks : []
1076
+ };
1077
+ agent.models = models;
1078
+ if (legacyModel !== void 0) changes.push(`Migrated ${label}.model string → ${label}.model.primary.`);
1079
+ if (legacyModelFallbacks.length > 0) changes.push(`Migrated ${label}.modelFallbacks → ${label}.model.fallbacks.`);
1080
+ if (legacyImageModel !== void 0) changes.push(`Migrated ${label}.imageModel string → ${label}.imageModel.primary.`);
1081
+ if (legacyImageModelFallbacks.length > 0) changes.push(`Migrated ${label}.imageModelFallbacks → ${label}.imageModel.fallbacks.`);
1082
+ if (legacyAllowed.length > 0) changes.push(`Migrated ${label}.allowedModels → ${label}.models.`);
1083
+ if (Object.keys(legacyAliases).length > 0) changes.push(`Migrated ${label}.modelAliases → ${label}.models.*.alias.`);
1084
+ delete agent.allowedModels;
1085
+ delete agent.modelAliases;
1086
+ delete agent.modelFallbacks;
1087
+ delete agent.imageModelFallbacks;
1088
+ }
1089
+ },
1090
+ {
1091
+ id: "routing.agents-v2",
1092
+ describe: "Move routing.agents/defaultAgentId to agents.list",
1093
+ apply: (raw, changes) => {
1094
+ const routing = getRecord(raw.routing);
1095
+ if (!routing) return;
1096
+ const routingAgents = getRecord(routing.agents);
1097
+ const agents = ensureRecord(raw, "agents");
1098
+ const list = getAgentsList(agents);
1099
+ if (routingAgents) {
1100
+ for (const [rawId, entryRaw] of Object.entries(routingAgents)) {
1101
+ const agentId = String(rawId ?? "").trim();
1102
+ const entry = getRecord(entryRaw);
1103
+ if (!agentId || !entry) continue;
1104
+ const target = ensureAgentEntry(list, agentId);
1105
+ const entryCopy = { ...entry };
1106
+ if ("mentionPatterns" in entryCopy) {
1107
+ const mentionPatterns = entryCopy.mentionPatterns;
1108
+ const groupChat = ensureRecord(target, "groupChat");
1109
+ if (groupChat.mentionPatterns === void 0) {
1110
+ groupChat.mentionPatterns = mentionPatterns;
1111
+ changes.push(`Moved routing.agents.${agentId}.mentionPatterns → agents.list (id "${agentId}").groupChat.mentionPatterns.`);
1112
+ } else changes.push(`Removed routing.agents.${agentId}.mentionPatterns (agents.list groupChat mentionPatterns already set).`);
1113
+ delete entryCopy.mentionPatterns;
1114
+ }
1115
+ const legacyGroupChat = getRecord(entryCopy.groupChat);
1116
+ if (legacyGroupChat) {
1117
+ mergeMissing(ensureRecord(target, "groupChat"), legacyGroupChat);
1118
+ delete entryCopy.groupChat;
1119
+ }
1120
+ const legacySandbox = getRecord(entryCopy.sandbox);
1121
+ if (legacySandbox) {
1122
+ const sandboxTools = getRecord(legacySandbox.tools);
1123
+ if (sandboxTools) {
1124
+ mergeMissing(ensureRecord(ensureRecord(ensureRecord(target, "tools"), "sandbox"), "tools"), sandboxTools);
1125
+ delete legacySandbox.tools;
1126
+ changes.push(`Moved routing.agents.${agentId}.sandbox.tools → agents.list (id "${agentId}").tools.sandbox.tools.`);
1127
+ }
1128
+ entryCopy.sandbox = legacySandbox;
1129
+ }
1130
+ mergeMissing(target, entryCopy);
1131
+ }
1132
+ delete routing.agents;
1133
+ changes.push("Moved routing.agents → agents.list.");
1134
+ }
1135
+ const defaultAgentId = typeof routing.defaultAgentId === "string" ? routing.defaultAgentId.trim() : "";
1136
+ if (defaultAgentId) {
1137
+ if (!list.some((entry) => isRecord$1(entry) && entry.default === true)) {
1138
+ const entry = ensureAgentEntry(list, defaultAgentId);
1139
+ entry.default = true;
1140
+ changes.push(`Moved routing.defaultAgentId → agents.list (id "${defaultAgentId}").default.`);
1141
+ } else changes.push("Removed routing.defaultAgentId (agents.list default already set).");
1142
+ delete routing.defaultAgentId;
1143
+ }
1144
+ if (list.length > 0) agents.list = list;
1145
+ if (Object.keys(routing).length === 0) delete raw.routing;
1146
+ }
1147
+ },
1148
+ {
1149
+ id: "routing.config-v2",
1150
+ describe: "Move routing bindings/groupChat/queue/agentToAgent/transcribeAudio",
1151
+ apply: (raw, changes) => {
1152
+ const routing = getRecord(raw.routing);
1153
+ if (!routing) return;
1154
+ if (routing.bindings !== void 0) {
1155
+ if (raw.bindings === void 0) {
1156
+ raw.bindings = routing.bindings;
1157
+ changes.push("Moved routing.bindings → bindings.");
1158
+ } else changes.push("Removed routing.bindings (bindings already set).");
1159
+ delete routing.bindings;
1160
+ }
1161
+ if (routing.agentToAgent !== void 0) {
1162
+ const tools = ensureRecord(raw, "tools");
1163
+ if (tools.agentToAgent === void 0) {
1164
+ tools.agentToAgent = routing.agentToAgent;
1165
+ changes.push("Moved routing.agentToAgent → tools.agentToAgent.");
1166
+ } else changes.push("Removed routing.agentToAgent (tools.agentToAgent already set).");
1167
+ delete routing.agentToAgent;
1168
+ }
1169
+ if (routing.queue !== void 0) {
1170
+ const messages = ensureRecord(raw, "messages");
1171
+ if (messages.queue === void 0) {
1172
+ messages.queue = routing.queue;
1173
+ changes.push("Moved routing.queue → messages.queue.");
1174
+ } else changes.push("Removed routing.queue (messages.queue already set).");
1175
+ delete routing.queue;
1176
+ }
1177
+ const groupChat = getRecord(routing.groupChat);
1178
+ if (groupChat) {
1179
+ const historyLimit = groupChat.historyLimit;
1180
+ if (historyLimit !== void 0) {
1181
+ const messagesGroup = ensureRecord(ensureRecord(raw, "messages"), "groupChat");
1182
+ if (messagesGroup.historyLimit === void 0) {
1183
+ messagesGroup.historyLimit = historyLimit;
1184
+ changes.push("Moved routing.groupChat.historyLimit → messages.groupChat.historyLimit.");
1185
+ } else changes.push("Removed routing.groupChat.historyLimit (messages.groupChat.historyLimit already set).");
1186
+ delete groupChat.historyLimit;
1187
+ }
1188
+ const mentionPatterns = groupChat.mentionPatterns;
1189
+ if (mentionPatterns !== void 0) {
1190
+ const messagesGroup = ensureRecord(ensureRecord(raw, "messages"), "groupChat");
1191
+ if (messagesGroup.mentionPatterns === void 0) {
1192
+ messagesGroup.mentionPatterns = mentionPatterns;
1193
+ changes.push("Moved routing.groupChat.mentionPatterns → messages.groupChat.mentionPatterns.");
1194
+ } else changes.push("Removed routing.groupChat.mentionPatterns (messages.groupChat.mentionPatterns already set).");
1195
+ delete groupChat.mentionPatterns;
1196
+ }
1197
+ if (Object.keys(groupChat).length === 0) delete routing.groupChat;
1198
+ else routing.groupChat = groupChat;
1199
+ }
1200
+ if (routing.transcribeAudio !== void 0) {
1201
+ const mapped = mapLegacyAudioTranscription(routing.transcribeAudio);
1202
+ if (mapped) {
1203
+ const mediaAudio = ensureRecord(ensureRecord(ensureRecord(raw, "tools"), "media"), "audio");
1204
+ if ((Array.isArray(mediaAudio.models) ? mediaAudio.models : []).length === 0) {
1205
+ mediaAudio.enabled = true;
1206
+ mediaAudio.models = [mapped];
1207
+ changes.push("Moved routing.transcribeAudio → tools.media.audio.models.");
1208
+ } else changes.push("Removed routing.transcribeAudio (tools.media.audio.models already set).");
1209
+ } else changes.push("Removed routing.transcribeAudio (unsupported transcription CLI).");
1210
+ delete routing.transcribeAudio;
1211
+ }
1212
+ const audio = getRecord(raw.audio);
1213
+ if (audio?.transcription !== void 0) {
1214
+ const mapped = mapLegacyAudioTranscription(audio.transcription);
1215
+ if (mapped) {
1216
+ const mediaAudio = ensureRecord(ensureRecord(ensureRecord(raw, "tools"), "media"), "audio");
1217
+ if ((Array.isArray(mediaAudio.models) ? mediaAudio.models : []).length === 0) {
1218
+ mediaAudio.enabled = true;
1219
+ mediaAudio.models = [mapped];
1220
+ changes.push("Moved audio.transcription → tools.media.audio.models.");
1221
+ } else changes.push("Removed audio.transcription (tools.media.audio.models already set).");
1222
+ delete audio.transcription;
1223
+ if (Object.keys(audio).length === 0) delete raw.audio;
1224
+ else raw.audio = audio;
1225
+ } else {
1226
+ delete audio.transcription;
1227
+ changes.push("Removed audio.transcription (unsupported transcription CLI).");
1228
+ if (Object.keys(audio).length === 0) delete raw.audio;
1229
+ else raw.audio = audio;
1230
+ }
1231
+ }
1232
+ if (Object.keys(routing).length === 0) delete raw.routing;
1233
+ }
1234
+ }
1235
+ ];
1236
+
1237
+ //#endregion
1238
+ //#region src/config/legacy.migrations.part-3.ts
1239
+ const LEGACY_CONFIG_MIGRATIONS_PART_3 = [
1240
+ {
1241
+ id: "auth.anthropic-claude-cli-mode-oauth",
1242
+ describe: "Switch anthropic:claude-cli auth profile mode to oauth",
1243
+ apply: (raw, changes) => {
1244
+ const profiles = getRecord(getRecord(raw.auth)?.profiles);
1245
+ if (!profiles) return;
1246
+ const claudeCli = getRecord(profiles["anthropic:claude-cli"]);
1247
+ if (!claudeCli) return;
1248
+ if (claudeCli.mode !== "token") return;
1249
+ claudeCli.mode = "oauth";
1250
+ changes.push("Updated auth.profiles[\"anthropic:claude-cli\"].mode → \"oauth\".");
1251
+ }
1252
+ },
1253
+ {
1254
+ id: "tools.bash->tools.exec",
1255
+ describe: "Move tools.bash to tools.exec",
1256
+ apply: (raw, changes) => {
1257
+ const tools = ensureRecord(raw, "tools");
1258
+ const bash = getRecord(tools.bash);
1259
+ if (!bash) return;
1260
+ if (tools.exec === void 0) {
1261
+ tools.exec = bash;
1262
+ changes.push("Moved tools.bash → tools.exec.");
1263
+ } else changes.push("Removed tools.bash (tools.exec already set).");
1264
+ delete tools.bash;
1265
+ }
1266
+ },
1267
+ {
1268
+ id: "messages.tts.enabled->auto",
1269
+ describe: "Move messages.tts.enabled to messages.tts.auto",
1270
+ apply: (raw, changes) => {
1271
+ const tts = getRecord(getRecord(raw.messages)?.tts);
1272
+ if (!tts) return;
1273
+ if (tts.auto !== void 0) {
1274
+ if ("enabled" in tts) {
1275
+ delete tts.enabled;
1276
+ changes.push("Removed messages.tts.enabled (messages.tts.auto already set).");
1277
+ }
1278
+ return;
1279
+ }
1280
+ if (typeof tts.enabled !== "boolean") return;
1281
+ tts.auto = tts.enabled ? "always" : "off";
1282
+ delete tts.enabled;
1283
+ changes.push(`Moved messages.tts.enabled → messages.tts.auto (${String(tts.auto)}).`);
1284
+ }
1285
+ },
1286
+ {
1287
+ id: "agent.defaults-v2",
1288
+ describe: "Move agent config to agents.defaults and tools",
1289
+ apply: (raw, changes) => {
1290
+ const agent = getRecord(raw.agent);
1291
+ if (!agent) return;
1292
+ const agents = ensureRecord(raw, "agents");
1293
+ const defaults = getRecord(agents.defaults) ?? {};
1294
+ const tools = ensureRecord(raw, "tools");
1295
+ const agentTools = getRecord(agent.tools);
1296
+ if (agentTools) {
1297
+ if (tools.allow === void 0 && agentTools.allow !== void 0) {
1298
+ tools.allow = agentTools.allow;
1299
+ changes.push("Moved agent.tools.allow → tools.allow.");
1300
+ }
1301
+ if (tools.deny === void 0 && agentTools.deny !== void 0) {
1302
+ tools.deny = agentTools.deny;
1303
+ changes.push("Moved agent.tools.deny → tools.deny.");
1304
+ }
1305
+ }
1306
+ const elevated = getRecord(agent.elevated);
1307
+ if (elevated) if (tools.elevated === void 0) {
1308
+ tools.elevated = elevated;
1309
+ changes.push("Moved agent.elevated → tools.elevated.");
1310
+ } else changes.push("Removed agent.elevated (tools.elevated already set).");
1311
+ const bash = getRecord(agent.bash);
1312
+ if (bash) if (tools.exec === void 0) {
1313
+ tools.exec = bash;
1314
+ changes.push("Moved agent.bash → tools.exec.");
1315
+ } else changes.push("Removed agent.bash (tools.exec already set).");
1316
+ const sandbox = getRecord(agent.sandbox);
1317
+ if (sandbox) {
1318
+ const sandboxTools = getRecord(sandbox.tools);
1319
+ if (sandboxTools) {
1320
+ mergeMissing(ensureRecord(ensureRecord(tools, "sandbox"), "tools"), sandboxTools);
1321
+ delete sandbox.tools;
1322
+ changes.push("Moved agent.sandbox.tools → tools.sandbox.tools.");
1323
+ }
1324
+ }
1325
+ const subagents = getRecord(agent.subagents);
1326
+ if (subagents) {
1327
+ const subagentTools = getRecord(subagents.tools);
1328
+ if (subagentTools) {
1329
+ mergeMissing(ensureRecord(ensureRecord(tools, "subagents"), "tools"), subagentTools);
1330
+ delete subagents.tools;
1331
+ changes.push("Moved agent.subagents.tools → tools.subagents.tools.");
1332
+ }
1333
+ }
1334
+ const agentCopy = structuredClone(agent);
1335
+ delete agentCopy.tools;
1336
+ delete agentCopy.elevated;
1337
+ delete agentCopy.bash;
1338
+ if (isRecord$1(agentCopy.sandbox)) delete agentCopy.sandbox.tools;
1339
+ if (isRecord$1(agentCopy.subagents)) delete agentCopy.subagents.tools;
1340
+ mergeMissing(defaults, agentCopy);
1341
+ agents.defaults = defaults;
1342
+ raw.agents = agents;
1343
+ delete raw.agent;
1344
+ changes.push("Moved agent → agents.defaults.");
1345
+ }
1346
+ },
1347
+ {
1348
+ id: "identity->agents.list",
1349
+ describe: "Move identity to agents.list[].identity",
1350
+ apply: (raw, changes) => {
1351
+ const identity = getRecord(raw.identity);
1352
+ if (!identity) return;
1353
+ const agents = ensureRecord(raw, "agents");
1354
+ const list = getAgentsList(agents);
1355
+ const defaultId = resolveDefaultAgentIdFromRaw(raw);
1356
+ const entry = ensureAgentEntry(list, defaultId);
1357
+ if (entry.identity === void 0) {
1358
+ entry.identity = identity;
1359
+ changes.push(`Moved identity → agents.list (id "${defaultId}").identity.`);
1360
+ } else changes.push("Removed identity (agents.list identity already set).");
1361
+ agents.list = list;
1362
+ raw.agents = agents;
1363
+ delete raw.identity;
1364
+ }
1365
+ }
1366
+ ];
1367
+
1368
+ //#endregion
1369
+ //#region src/config/legacy.migrations.ts
1370
+ const LEGACY_CONFIG_MIGRATIONS = [
1371
+ ...LEGACY_CONFIG_MIGRATIONS_PART_1,
1372
+ ...LEGACY_CONFIG_MIGRATIONS_PART_2,
1373
+ ...LEGACY_CONFIG_MIGRATIONS_PART_3
1374
+ ];
1375
+
1376
+ //#endregion
1377
+ //#region src/config/legacy.rules.ts
1378
+ const LEGACY_CONFIG_RULES = [
1379
+ {
1380
+ path: ["whatsapp"],
1381
+ message: "whatsapp config moved to channels.whatsapp (auto-migrated on load)."
1382
+ },
1383
+ {
1384
+ path: ["telegram"],
1385
+ message: "telegram config moved to channels.telegram (auto-migrated on load)."
1386
+ },
1387
+ {
1388
+ path: ["discord"],
1389
+ message: "discord config moved to channels.discord (auto-migrated on load)."
1390
+ },
1391
+ {
1392
+ path: ["slack"],
1393
+ message: "slack config moved to channels.slack (auto-migrated on load)."
1394
+ },
1395
+ {
1396
+ path: ["signal"],
1397
+ message: "signal config moved to channels.signal (auto-migrated on load)."
1398
+ },
1399
+ {
1400
+ path: ["imessage"],
1401
+ message: "imessage config moved to channels.imessage (auto-migrated on load)."
1402
+ },
1403
+ {
1404
+ path: ["msteams"],
1405
+ message: "msteams config moved to channels.msteams (auto-migrated on load)."
1406
+ },
1407
+ {
1408
+ path: ["routing", "allowFrom"],
1409
+ message: "routing.allowFrom was removed; use channels.whatsapp.allowFrom instead (auto-migrated on load)."
1410
+ },
1411
+ {
1412
+ path: ["routing", "bindings"],
1413
+ message: "routing.bindings was moved; use top-level bindings instead (auto-migrated on load)."
1414
+ },
1415
+ {
1416
+ path: ["routing", "agents"],
1417
+ message: "routing.agents was moved; use agents.list instead (auto-migrated on load)."
1418
+ },
1419
+ {
1420
+ path: ["routing", "defaultAgentId"],
1421
+ message: "routing.defaultAgentId was moved; use agents.list[].default instead (auto-migrated on load)."
1422
+ },
1423
+ {
1424
+ path: ["routing", "agentToAgent"],
1425
+ message: "routing.agentToAgent was moved; use tools.agentToAgent instead (auto-migrated on load)."
1426
+ },
1427
+ {
1428
+ path: [
1429
+ "routing",
1430
+ "groupChat",
1431
+ "requireMention"
1432
+ ],
1433
+ message: "routing.groupChat.requireMention was removed; use channels.whatsapp/telegram/imessage groups defaults (e.g. channels.whatsapp.groups.\"*\".requireMention) instead (auto-migrated on load)."
1434
+ },
1435
+ {
1436
+ path: [
1437
+ "routing",
1438
+ "groupChat",
1439
+ "mentionPatterns"
1440
+ ],
1441
+ message: "routing.groupChat.mentionPatterns was moved; use agents.list[].groupChat.mentionPatterns or messages.groupChat.mentionPatterns instead (auto-migrated on load)."
1442
+ },
1443
+ {
1444
+ path: ["routing", "queue"],
1445
+ message: "routing.queue was moved; use messages.queue instead (auto-migrated on load)."
1446
+ },
1447
+ {
1448
+ path: ["routing", "transcribeAudio"],
1449
+ message: "routing.transcribeAudio was moved; use tools.media.audio.models instead (auto-migrated on load)."
1450
+ },
1451
+ {
1452
+ path: ["telegram", "requireMention"],
1453
+ message: "telegram.requireMention was removed; use channels.telegram.groups.\"*\".requireMention instead (auto-migrated on load)."
1454
+ },
1455
+ {
1456
+ path: ["identity"],
1457
+ message: "identity was moved; use agents.list[].identity instead (auto-migrated on load)."
1458
+ },
1459
+ {
1460
+ path: ["agent"],
1461
+ message: "agent.* was moved; use agents.defaults (and tools.* for tool/elevated/exec settings) instead (auto-migrated on load)."
1462
+ },
1463
+ {
1464
+ path: ["tools", "bash"],
1465
+ message: "tools.bash was removed; use tools.exec instead (auto-migrated on load)."
1466
+ },
1467
+ {
1468
+ path: ["agent", "model"],
1469
+ message: "agent.model string was replaced by agents.defaults.model.primary/fallbacks and agents.defaults.models (auto-migrated on load).",
1470
+ match: (value) => typeof value === "string"
1471
+ },
1472
+ {
1473
+ path: ["agent", "imageModel"],
1474
+ message: "agent.imageModel string was replaced by agents.defaults.imageModel.primary/fallbacks (auto-migrated on load).",
1475
+ match: (value) => typeof value === "string"
1476
+ },
1477
+ {
1478
+ path: ["agent", "allowedModels"],
1479
+ message: "agent.allowedModels was replaced by agents.defaults.models (auto-migrated on load)."
1480
+ },
1481
+ {
1482
+ path: ["agent", "modelAliases"],
1483
+ message: "agent.modelAliases was replaced by agents.defaults.models.*.alias (auto-migrated on load)."
1484
+ },
1485
+ {
1486
+ path: ["agent", "modelFallbacks"],
1487
+ message: "agent.modelFallbacks was replaced by agents.defaults.model.fallbacks (auto-migrated on load)."
1488
+ },
1489
+ {
1490
+ path: ["agent", "imageModelFallbacks"],
1491
+ message: "agent.imageModelFallbacks was replaced by agents.defaults.imageModel.fallbacks (auto-migrated on load)."
1492
+ },
1493
+ {
1494
+ path: [
1495
+ "messages",
1496
+ "tts",
1497
+ "enabled"
1498
+ ],
1499
+ message: "messages.tts.enabled was replaced by messages.tts.auto (auto-migrated on load)."
1500
+ },
1501
+ {
1502
+ path: ["gateway", "token"],
1503
+ message: "gateway.token is ignored; use gateway.auth.token instead (auto-migrated on load)."
1504
+ }
1505
+ ];
1506
+
1507
+ //#endregion
1508
+ //#region src/config/legacy.ts
1509
+ function findLegacyConfigIssues(raw) {
1510
+ if (!raw || typeof raw !== "object") return [];
1511
+ const root = raw;
1512
+ const issues = [];
1513
+ for (const rule of LEGACY_CONFIG_RULES) {
1514
+ let cursor = root;
1515
+ for (const key of rule.path) {
1516
+ if (!cursor || typeof cursor !== "object") {
1517
+ cursor = void 0;
1518
+ break;
1519
+ }
1520
+ cursor = cursor[key];
1521
+ }
1522
+ if (cursor !== void 0 && (!rule.match || rule.match(cursor, root))) issues.push({
1523
+ path: rule.path.join("."),
1524
+ message: rule.message
1525
+ });
1526
+ }
1527
+ return issues;
1528
+ }
1529
+ function applyLegacyMigrations(raw) {
1530
+ if (!raw || typeof raw !== "object") return {
1531
+ next: null,
1532
+ changes: []
1533
+ };
1534
+ const next = structuredClone(raw);
1535
+ const changes = [];
1536
+ for (const migration of LEGACY_CONFIG_MIGRATIONS) migration.apply(next, changes);
1537
+ if (changes.length === 0) return {
1538
+ next: null,
1539
+ changes: []
1540
+ };
1541
+ return {
1542
+ next,
1543
+ changes
1544
+ };
1545
+ }
1546
+
1547
+ //#endregion
1548
+ //#region src/config/normalize-paths.ts
1549
+ const PATH_VALUE_RE = /^~(?=$|[\\/])/;
1550
+ const PATH_KEY_RE = /(dir|path|paths|file|root|workspace)$/i;
1551
+ const PATH_LIST_KEYS = new Set(["paths", "pathPrepend"]);
1552
+ function isPlainObject$2(value) {
1553
+ return Boolean(value) && typeof value === "object" && !Array.isArray(value);
1554
+ }
1555
+ function normalizeStringValue(key, value) {
1556
+ if (!PATH_VALUE_RE.test(value.trim())) return value;
1557
+ if (!key) return value;
1558
+ if (PATH_KEY_RE.test(key) || PATH_LIST_KEYS.has(key)) return resolveUserPath(value);
1559
+ return value;
1560
+ }
1561
+ function normalizeAny(key, value) {
1562
+ if (typeof value === "string") return normalizeStringValue(key, value);
1563
+ if (Array.isArray(value)) {
1564
+ const normalizeChildren = Boolean(key && PATH_LIST_KEYS.has(key));
1565
+ return value.map((entry) => {
1566
+ if (typeof entry === "string") return normalizeChildren ? normalizeStringValue(key, entry) : entry;
1567
+ if (Array.isArray(entry)) return normalizeAny(void 0, entry);
1568
+ if (isPlainObject$2(entry)) return normalizeAny(void 0, entry);
1569
+ return entry;
1570
+ });
1571
+ }
1572
+ if (!isPlainObject$2(value)) return value;
1573
+ for (const [childKey, childValue] of Object.entries(value)) {
1574
+ const next = normalizeAny(childKey, childValue);
1575
+ if (next !== childValue) value[childKey] = next;
1576
+ }
1577
+ return value;
1578
+ }
1579
+ /**
1580
+ * Normalize "~" paths in path-ish config fields.
1581
+ *
1582
+ * Goal: accept `~/...` consistently across config file + env overrides, while
1583
+ * keeping the surface area small and predictable.
1584
+ */
1585
+ function normalizeConfigPaths(cfg) {
1586
+ if (!cfg || typeof cfg !== "object") return cfg;
1587
+ normalizeAny(void 0, cfg);
1588
+ return cfg;
1589
+ }
1590
+
1591
+ //#endregion
1592
+ //#region src/config/config-paths.ts
1593
+ const BLOCKED_KEYS = new Set([
1594
+ "__proto__",
1595
+ "prototype",
1596
+ "constructor"
1597
+ ]);
1598
+ function parseConfigPath(raw) {
1599
+ const trimmed = raw.trim();
1600
+ if (!trimmed) return {
1601
+ ok: false,
1602
+ error: "Invalid path. Use dot notation (e.g. foo.bar)."
1603
+ };
1604
+ const parts = trimmed.split(".").map((part) => part.trim());
1605
+ if (parts.some((part) => !part)) return {
1606
+ ok: false,
1607
+ error: "Invalid path. Use dot notation (e.g. foo.bar)."
1608
+ };
1609
+ if (parts.some((part) => BLOCKED_KEYS.has(part))) return {
1610
+ ok: false,
1611
+ error: "Invalid path segment."
1612
+ };
1613
+ return {
1614
+ ok: true,
1615
+ path: parts
1616
+ };
1617
+ }
1618
+ function setConfigValueAtPath(root, path, value) {
1619
+ let cursor = root;
1620
+ for (let idx = 0; idx < path.length - 1; idx += 1) {
1621
+ const key = path[idx];
1622
+ const next = cursor[key];
1623
+ if (!isPlainObject$1(next)) cursor[key] = {};
1624
+ cursor = cursor[key];
1625
+ }
1626
+ cursor[path[path.length - 1]] = value;
1627
+ }
1628
+ function unsetConfigValueAtPath(root, path) {
1629
+ const stack = [];
1630
+ let cursor = root;
1631
+ for (let idx = 0; idx < path.length - 1; idx += 1) {
1632
+ const key = path[idx];
1633
+ const next = cursor[key];
1634
+ if (!isPlainObject$1(next)) return false;
1635
+ stack.push({
1636
+ node: cursor,
1637
+ key
1638
+ });
1639
+ cursor = next;
1640
+ }
1641
+ const leafKey = path[path.length - 1];
1642
+ if (!(leafKey in cursor)) return false;
1643
+ delete cursor[leafKey];
1644
+ for (let idx = stack.length - 1; idx >= 0; idx -= 1) {
1645
+ const { node, key } = stack[idx];
1646
+ const child = node[key];
1647
+ if (isPlainObject$1(child) && Object.keys(child).length === 0) delete node[key];
1648
+ else break;
1649
+ }
1650
+ return true;
1651
+ }
1652
+ function getConfigValueAtPath(root, path) {
1653
+ let cursor = root;
1654
+ for (const key of path) {
1655
+ if (!isPlainObject$1(cursor)) return;
1656
+ cursor = cursor[key];
1657
+ }
1658
+ return cursor;
1659
+ }
1660
+ function isPlainObject$1(value) {
1661
+ return typeof value === "object" && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
1662
+ }
1663
+
1664
+ //#endregion
1665
+ //#region src/config/runtime-overrides.ts
1666
+ let overrides = {};
1667
+ function mergeOverrides(base, override) {
1668
+ if (!isPlainObject(base) || !isPlainObject(override)) return override;
1669
+ const next = { ...base };
1670
+ for (const [key, value] of Object.entries(override)) {
1671
+ if (value === void 0) continue;
1672
+ next[key] = mergeOverrides(base[key], value);
1673
+ }
1674
+ return next;
1675
+ }
1676
+ function isPlainObject(value) {
1677
+ return typeof value === "object" && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
1678
+ }
1679
+ function getConfigOverrides() {
1680
+ return overrides;
1681
+ }
1682
+ function resetConfigOverrides() {
1683
+ overrides = {};
1684
+ }
1685
+ function setConfigOverride(pathRaw, value) {
1686
+ const parsed = parseConfigPath(pathRaw);
1687
+ if (!parsed.ok || !parsed.path) return {
1688
+ ok: false,
1689
+ error: parsed.error ?? "Invalid path."
1690
+ };
1691
+ setConfigValueAtPath(overrides, parsed.path, value);
1692
+ return { ok: true };
1693
+ }
1694
+ function unsetConfigOverride(pathRaw) {
1695
+ const parsed = parseConfigPath(pathRaw);
1696
+ if (!parsed.ok || !parsed.path) return {
1697
+ ok: false,
1698
+ removed: false,
1699
+ error: parsed.error ?? "Invalid path."
1700
+ };
1701
+ return {
1702
+ ok: true,
1703
+ removed: unsetConfigValueAtPath(overrides, parsed.path)
1704
+ };
1705
+ }
1706
+ function applyConfigOverrides(cfg) {
1707
+ if (!overrides || Object.keys(overrides).length === 0) return cfg;
1708
+ return mergeOverrides(cfg, overrides);
1709
+ }
1710
+
1711
+ //#endregion
1712
+ //#region src/plugins/schema-validator.ts
1713
+ const ajv = new AjvPkg({
1714
+ allErrors: true,
1715
+ strict: false,
1716
+ removeAdditional: false
1717
+ });
1718
+ const schemaCache = /* @__PURE__ */ new Map();
1719
+ function formatAjvErrors(errors) {
1720
+ if (!errors || errors.length === 0) return ["invalid config"];
1721
+ return errors.map((error) => {
1722
+ return `${error.instancePath?.replace(/^\//, "").replace(/\//g, ".") || "<root>"}: ${error.message ?? "invalid"}`;
1723
+ });
1724
+ }
1725
+ function validateJsonSchemaValue(params) {
1726
+ let cached = schemaCache.get(params.cacheKey);
1727
+ if (!cached || cached.schema !== params.schema) {
1728
+ cached = {
1729
+ validate: ajv.compile(params.schema),
1730
+ schema: params.schema
1731
+ };
1732
+ schemaCache.set(params.cacheKey, cached);
1733
+ }
1734
+ if (cached.validate(params.value)) return { ok: true };
1735
+ return {
1736
+ ok: false,
1737
+ errors: formatAjvErrors(cached.validate.errors)
1738
+ };
1739
+ }
1740
+
1741
+ //#endregion
1742
+ //#region src/cli/parse-duration.ts
1743
+ function parseDurationMs(raw, opts) {
1744
+ const trimmed = String(raw ?? "").trim().toLowerCase();
1745
+ if (!trimmed) throw new Error("invalid duration (empty)");
1746
+ const m = /^(\d+(?:\.\d+)?)(ms|s|m|h|d)?$/.exec(trimmed);
1747
+ if (!m) throw new Error(`invalid duration: ${raw}`);
1748
+ const value = Number(m[1]);
1749
+ if (!Number.isFinite(value) || value < 0) throw new Error(`invalid duration: ${raw}`);
1750
+ const unit = m[2] ?? opts?.defaultUnit ?? "ms";
1751
+ const multiplier = unit === "ms" ? 1 : unit === "s" ? 1e3 : unit === "m" ? 6e4 : unit === "h" ? 36e5 : 864e5;
1752
+ const ms = Math.round(value * multiplier);
1753
+ if (!Number.isFinite(ms)) throw new Error(`invalid duration: ${raw}`);
1754
+ return ms;
1755
+ }
1756
+
1757
+ //#endregion
1758
+ //#region src/infra/exec-safety.ts
1759
+ const SHELL_METACHARS = /[;&|`$<>]/;
1760
+ const CONTROL_CHARS = /[\r\n]/;
1761
+ const QUOTE_CHARS = /["']/;
1762
+ const BARE_NAME_PATTERN = /^[A-Za-z0-9._+-]+$/;
1763
+ function isLikelyPath(value) {
1764
+ if (value.startsWith(".") || value.startsWith("~")) return true;
1765
+ if (value.includes("/") || value.includes("\\")) return true;
1766
+ return /^[A-Za-z]:[\\/]/.test(value);
1767
+ }
1768
+ function isSafeExecutableValue(value) {
1769
+ if (!value) return false;
1770
+ const trimmed = value.trim();
1771
+ if (!trimmed) return false;
1772
+ if (trimmed.includes("\0")) return false;
1773
+ if (CONTROL_CHARS.test(trimmed)) return false;
1774
+ if (SHELL_METACHARS.test(trimmed)) return false;
1775
+ if (QUOTE_CHARS.test(trimmed)) return false;
1776
+ if (isLikelyPath(trimmed)) return true;
1777
+ if (trimmed.startsWith("-")) return false;
1778
+ return BARE_NAME_PATTERN.test(trimmed);
1779
+ }
1780
+
1781
+ //#endregion
1782
+ //#region src/config/zod-schema.core.ts
1783
+ const ModelApiSchema = z.union([
1784
+ z.literal("openai-completions"),
1785
+ z.literal("openai-responses"),
1786
+ z.literal("anthropic-messages"),
1787
+ z.literal("google-generative-ai"),
1788
+ z.literal("github-copilot"),
1789
+ z.literal("bedrock-converse-stream")
1790
+ ]);
1791
+ const ModelCompatSchema = z.object({
1792
+ supportsStore: z.boolean().optional(),
1793
+ supportsDeveloperRole: z.boolean().optional(),
1794
+ supportsReasoningEffort: z.boolean().optional(),
1795
+ maxTokensField: z.union([z.literal("max_completion_tokens"), z.literal("max_tokens")]).optional()
1796
+ }).strict().optional();
1797
+ const ModelDefinitionSchema = z.object({
1798
+ id: z.string().min(1),
1799
+ name: z.string().min(1),
1800
+ api: ModelApiSchema.optional(),
1801
+ reasoning: z.boolean().optional(),
1802
+ input: z.array(z.union([z.literal("text"), z.literal("image")])).optional(),
1803
+ cost: z.object({
1804
+ input: z.number().optional(),
1805
+ output: z.number().optional(),
1806
+ cacheRead: z.number().optional(),
1807
+ cacheWrite: z.number().optional()
1808
+ }).strict().optional(),
1809
+ contextWindow: z.number().positive().optional(),
1810
+ maxTokens: z.number().positive().optional(),
1811
+ headers: z.record(z.string(), z.string()).optional(),
1812
+ compat: ModelCompatSchema
1813
+ }).strict();
1814
+ const ModelProviderSchema = z.object({
1815
+ baseUrl: z.string().min(1),
1816
+ apiKey: z.string().optional(),
1817
+ auth: z.union([
1818
+ z.literal("api-key"),
1819
+ z.literal("aws-sdk"),
1820
+ z.literal("oauth"),
1821
+ z.literal("token")
1822
+ ]).optional(),
1823
+ api: ModelApiSchema.optional(),
1824
+ headers: z.record(z.string(), z.string()).optional(),
1825
+ authHeader: z.boolean().optional(),
1826
+ models: z.array(ModelDefinitionSchema)
1827
+ }).strict();
1828
+ const BedrockDiscoverySchema = z.object({
1829
+ enabled: z.boolean().optional(),
1830
+ region: z.string().optional(),
1831
+ providerFilter: z.array(z.string()).optional(),
1832
+ refreshInterval: z.number().int().nonnegative().optional(),
1833
+ defaultContextWindow: z.number().int().positive().optional(),
1834
+ defaultMaxTokens: z.number().int().positive().optional()
1835
+ }).strict().optional();
1836
+ const ModelsConfigSchema = z.object({
1837
+ mode: z.union([z.literal("merge"), z.literal("replace")]).optional(),
1838
+ providers: z.record(z.string(), ModelProviderSchema).optional(),
1839
+ bedrockDiscovery: BedrockDiscoverySchema
1840
+ }).strict().optional();
1841
+ const GroupChatSchema = z.object({
1842
+ mentionPatterns: z.array(z.string()).optional(),
1843
+ historyLimit: z.number().int().positive().optional()
1844
+ }).strict().optional();
1845
+ const DmConfigSchema = z.object({ historyLimit: z.number().int().min(0).optional() }).strict();
1846
+ const IdentitySchema = z.object({
1847
+ name: z.string().optional(),
1848
+ theme: z.string().optional(),
1849
+ emoji: z.string().optional(),
1850
+ avatar: z.string().optional()
1851
+ }).strict().optional();
1852
+ const QueueModeSchema = z.union([
1853
+ z.literal("steer"),
1854
+ z.literal("followup"),
1855
+ z.literal("collect"),
1856
+ z.literal("steer-backlog"),
1857
+ z.literal("steer+backlog"),
1858
+ z.literal("queue"),
1859
+ z.literal("interrupt")
1860
+ ]);
1861
+ const QueueDropSchema = z.union([
1862
+ z.literal("old"),
1863
+ z.literal("new"),
1864
+ z.literal("summarize")
1865
+ ]);
1866
+ const ReplyToModeSchema = z.union([
1867
+ z.literal("off"),
1868
+ z.literal("first"),
1869
+ z.literal("all")
1870
+ ]);
1871
+ const GroupPolicySchema = z.enum([
1872
+ "open",
1873
+ "disabled",
1874
+ "allowlist"
1875
+ ]);
1876
+ const DmPolicySchema = z.enum([
1877
+ "pairing",
1878
+ "allowlist",
1879
+ "open",
1880
+ "disabled"
1881
+ ]);
1882
+ const BlockStreamingCoalesceSchema = z.object({
1883
+ minChars: z.number().int().positive().optional(),
1884
+ maxChars: z.number().int().positive().optional(),
1885
+ idleMs: z.number().int().nonnegative().optional()
1886
+ }).strict();
1887
+ const BlockStreamingChunkSchema = z.object({
1888
+ minChars: z.number().int().positive().optional(),
1889
+ maxChars: z.number().int().positive().optional(),
1890
+ breakPreference: z.union([
1891
+ z.literal("paragraph"),
1892
+ z.literal("newline"),
1893
+ z.literal("sentence")
1894
+ ]).optional()
1895
+ }).strict();
1896
+ const MarkdownTableModeSchema = z.enum([
1897
+ "off",
1898
+ "bullets",
1899
+ "code"
1900
+ ]);
1901
+ const MarkdownConfigSchema = z.object({ tables: MarkdownTableModeSchema.optional() }).strict().optional();
1902
+ const TtsProviderSchema = z.enum([
1903
+ "elevenlabs",
1904
+ "openai",
1905
+ "edge"
1906
+ ]);
1907
+ const TtsModeSchema = z.enum(["final", "all"]);
1908
+ const TtsAutoSchema = z.enum([
1909
+ "off",
1910
+ "always",
1911
+ "inbound",
1912
+ "tagged"
1913
+ ]);
1914
+ const TtsConfigSchema = z.object({
1915
+ auto: TtsAutoSchema.optional(),
1916
+ enabled: z.boolean().optional(),
1917
+ mode: TtsModeSchema.optional(),
1918
+ provider: TtsProviderSchema.optional(),
1919
+ summaryModel: z.string().optional(),
1920
+ modelOverrides: z.object({
1921
+ enabled: z.boolean().optional(),
1922
+ allowText: z.boolean().optional(),
1923
+ allowProvider: z.boolean().optional(),
1924
+ allowVoice: z.boolean().optional(),
1925
+ allowModelId: z.boolean().optional(),
1926
+ allowVoiceSettings: z.boolean().optional(),
1927
+ allowNormalization: z.boolean().optional(),
1928
+ allowSeed: z.boolean().optional()
1929
+ }).strict().optional(),
1930
+ elevenlabs: z.object({
1931
+ apiKey: z.string().optional(),
1932
+ baseUrl: z.string().optional(),
1933
+ voiceId: z.string().optional(),
1934
+ modelId: z.string().optional(),
1935
+ seed: z.number().int().min(0).max(4294967295).optional(),
1936
+ applyTextNormalization: z.enum([
1937
+ "auto",
1938
+ "on",
1939
+ "off"
1940
+ ]).optional(),
1941
+ languageCode: z.string().optional(),
1942
+ voiceSettings: z.object({
1943
+ stability: z.number().min(0).max(1).optional(),
1944
+ similarityBoost: z.number().min(0).max(1).optional(),
1945
+ style: z.number().min(0).max(1).optional(),
1946
+ useSpeakerBoost: z.boolean().optional(),
1947
+ speed: z.number().min(.5).max(2).optional()
1948
+ }).strict().optional()
1949
+ }).strict().optional(),
1950
+ openai: z.object({
1951
+ apiKey: z.string().optional(),
1952
+ model: z.string().optional(),
1953
+ voice: z.string().optional()
1954
+ }).strict().optional(),
1955
+ edge: z.object({
1956
+ enabled: z.boolean().optional(),
1957
+ voice: z.string().optional(),
1958
+ lang: z.string().optional(),
1959
+ outputFormat: z.string().optional(),
1960
+ pitch: z.string().optional(),
1961
+ rate: z.string().optional(),
1962
+ volume: z.string().optional(),
1963
+ saveSubtitles: z.boolean().optional(),
1964
+ proxy: z.string().optional(),
1965
+ timeoutMs: z.number().int().min(1e3).max(12e4).optional()
1966
+ }).strict().optional(),
1967
+ prefsPath: z.string().optional(),
1968
+ maxTextLength: z.number().int().min(1).optional(),
1969
+ timeoutMs: z.number().int().min(1e3).max(12e4).optional()
1970
+ }).strict().optional();
1971
+ const HumanDelaySchema = z.object({
1972
+ mode: z.union([
1973
+ z.literal("off"),
1974
+ z.literal("natural"),
1975
+ z.literal("custom")
1976
+ ]).optional(),
1977
+ minMs: z.number().int().nonnegative().optional(),
1978
+ maxMs: z.number().int().nonnegative().optional()
1979
+ }).strict();
1980
+ const CliBackendSchema = z.object({
1981
+ command: z.string(),
1982
+ args: z.array(z.string()).optional(),
1983
+ output: z.union([
1984
+ z.literal("json"),
1985
+ z.literal("text"),
1986
+ z.literal("jsonl")
1987
+ ]).optional(),
1988
+ resumeOutput: z.union([
1989
+ z.literal("json"),
1990
+ z.literal("text"),
1991
+ z.literal("jsonl")
1992
+ ]).optional(),
1993
+ input: z.union([z.literal("arg"), z.literal("stdin")]).optional(),
1994
+ maxPromptArgChars: z.number().int().positive().optional(),
1995
+ env: z.record(z.string(), z.string()).optional(),
1996
+ clearEnv: z.array(z.string()).optional(),
1997
+ modelArg: z.string().optional(),
1998
+ modelAliases: z.record(z.string(), z.string()).optional(),
1999
+ sessionArg: z.string().optional(),
2000
+ sessionArgs: z.array(z.string()).optional(),
2001
+ resumeArgs: z.array(z.string()).optional(),
2002
+ sessionMode: z.union([
2003
+ z.literal("always"),
2004
+ z.literal("existing"),
2005
+ z.literal("none")
2006
+ ]).optional(),
2007
+ sessionIdFields: z.array(z.string()).optional(),
2008
+ systemPromptArg: z.string().optional(),
2009
+ systemPromptMode: z.union([z.literal("append"), z.literal("replace")]).optional(),
2010
+ systemPromptWhen: z.union([
2011
+ z.literal("first"),
2012
+ z.literal("always"),
2013
+ z.literal("never")
2014
+ ]).optional(),
2015
+ imageArg: z.string().optional(),
2016
+ imageMode: z.union([z.literal("repeat"), z.literal("list")]).optional(),
2017
+ serialize: z.boolean().optional()
2018
+ }).strict();
2019
+ const normalizeAllowFrom = (values) => (values ?? []).map((v) => String(v).trim()).filter(Boolean);
2020
+ const requireOpenAllowFrom = (params) => {
2021
+ if (params.policy !== "open") return;
2022
+ if (normalizeAllowFrom(params.allowFrom).includes("*")) return;
2023
+ params.ctx.addIssue({
2024
+ code: z.ZodIssueCode.custom,
2025
+ path: params.path,
2026
+ message: params.message
2027
+ });
2028
+ };
2029
+ const MSTeamsReplyStyleSchema = z.enum(["thread", "top-level"]);
2030
+ const RetryConfigSchema = z.object({
2031
+ attempts: z.number().int().min(1).optional(),
2032
+ minDelayMs: z.number().int().min(0).optional(),
2033
+ maxDelayMs: z.number().int().min(0).optional(),
2034
+ jitter: z.number().min(0).max(1).optional()
2035
+ }).strict().optional();
2036
+ const QueueModeBySurfaceSchema = z.object({
2037
+ whatsapp: QueueModeSchema.optional(),
2038
+ telegram: QueueModeSchema.optional(),
2039
+ discord: QueueModeSchema.optional(),
2040
+ slack: QueueModeSchema.optional(),
2041
+ mattermost: QueueModeSchema.optional(),
2042
+ signal: QueueModeSchema.optional(),
2043
+ imessage: QueueModeSchema.optional(),
2044
+ msteams: QueueModeSchema.optional(),
2045
+ webchat: QueueModeSchema.optional()
2046
+ }).strict().optional();
2047
+ const DebounceMsBySurfaceSchema = z.record(z.string(), z.number().int().nonnegative()).optional();
2048
+ const QueueSchema = z.object({
2049
+ mode: QueueModeSchema.optional(),
2050
+ byChannel: QueueModeBySurfaceSchema,
2051
+ debounceMs: z.number().int().nonnegative().optional(),
2052
+ debounceMsByChannel: DebounceMsBySurfaceSchema,
2053
+ cap: z.number().int().positive().optional(),
2054
+ drop: QueueDropSchema.optional()
2055
+ }).strict().optional();
2056
+ const InboundDebounceSchema = z.object({
2057
+ debounceMs: z.number().int().nonnegative().optional(),
2058
+ byChannel: DebounceMsBySurfaceSchema
2059
+ }).strict().optional();
2060
+ const TranscribeAudioSchema = z.object({
2061
+ command: z.array(z.string()).superRefine((value, ctx) => {
2062
+ const executable = value[0];
2063
+ if (!isSafeExecutableValue(executable)) ctx.addIssue({
2064
+ code: z.ZodIssueCode.custom,
2065
+ path: [0],
2066
+ message: "expected safe executable name or path"
2067
+ });
2068
+ }),
2069
+ timeoutSeconds: z.number().int().positive().optional()
2070
+ }).strict().optional();
2071
+ const HexColorSchema = z.string().regex(/^#?[0-9a-fA-F]{6}$/, "expected hex color (RRGGBB)");
2072
+ const ExecutableTokenSchema = z.string().refine(isSafeExecutableValue, "expected safe executable name or path");
2073
+ const MediaUnderstandingScopeSchema = z.object({
2074
+ default: z.union([z.literal("allow"), z.literal("deny")]).optional(),
2075
+ rules: z.array(z.object({
2076
+ action: z.union([z.literal("allow"), z.literal("deny")]),
2077
+ match: z.object({
2078
+ channel: z.string().optional(),
2079
+ chatType: z.union([
2080
+ z.literal("direct"),
2081
+ z.literal("group"),
2082
+ z.literal("channel")
2083
+ ]).optional(),
2084
+ keyPrefix: z.string().optional()
2085
+ }).strict().optional()
2086
+ }).strict()).optional()
2087
+ }).strict().optional();
2088
+ const MediaUnderstandingCapabilitiesSchema = z.array(z.union([
2089
+ z.literal("image"),
2090
+ z.literal("audio"),
2091
+ z.literal("video")
2092
+ ])).optional();
2093
+ const MediaUnderstandingAttachmentsSchema = z.object({
2094
+ mode: z.union([z.literal("first"), z.literal("all")]).optional(),
2095
+ maxAttachments: z.number().int().positive().optional(),
2096
+ prefer: z.union([
2097
+ z.literal("first"),
2098
+ z.literal("last"),
2099
+ z.literal("path"),
2100
+ z.literal("url")
2101
+ ]).optional()
2102
+ }).strict().optional();
2103
+ const DeepgramAudioSchema = z.object({
2104
+ detectLanguage: z.boolean().optional(),
2105
+ punctuate: z.boolean().optional(),
2106
+ smartFormat: z.boolean().optional()
2107
+ }).strict().optional();
2108
+ const ProviderOptionValueSchema = z.union([
2109
+ z.string(),
2110
+ z.number(),
2111
+ z.boolean()
2112
+ ]);
2113
+ const ProviderOptionsSchema = z.record(z.string(), z.record(z.string(), ProviderOptionValueSchema)).optional();
2114
+ const MediaUnderstandingModelSchema = z.object({
2115
+ provider: z.string().optional(),
2116
+ model: z.string().optional(),
2117
+ capabilities: MediaUnderstandingCapabilitiesSchema,
2118
+ type: z.union([z.literal("provider"), z.literal("cli")]).optional(),
2119
+ command: z.string().optional(),
2120
+ args: z.array(z.string()).optional(),
2121
+ prompt: z.string().optional(),
2122
+ maxChars: z.number().int().positive().optional(),
2123
+ maxBytes: z.number().int().positive().optional(),
2124
+ timeoutSeconds: z.number().int().positive().optional(),
2125
+ language: z.string().optional(),
2126
+ providerOptions: ProviderOptionsSchema,
2127
+ deepgram: DeepgramAudioSchema,
2128
+ baseUrl: z.string().optional(),
2129
+ headers: z.record(z.string(), z.string()).optional(),
2130
+ profile: z.string().optional(),
2131
+ preferredProfile: z.string().optional()
2132
+ }).strict().optional();
2133
+ const ToolsMediaUnderstandingSchema = z.object({
2134
+ enabled: z.boolean().optional(),
2135
+ scope: MediaUnderstandingScopeSchema,
2136
+ maxBytes: z.number().int().positive().optional(),
2137
+ maxChars: z.number().int().positive().optional(),
2138
+ prompt: z.string().optional(),
2139
+ timeoutSeconds: z.number().int().positive().optional(),
2140
+ language: z.string().optional(),
2141
+ providerOptions: ProviderOptionsSchema,
2142
+ deepgram: DeepgramAudioSchema,
2143
+ baseUrl: z.string().optional(),
2144
+ headers: z.record(z.string(), z.string()).optional(),
2145
+ attachments: MediaUnderstandingAttachmentsSchema,
2146
+ models: z.array(MediaUnderstandingModelSchema).optional()
2147
+ }).strict().optional();
2148
+ const ToolsMediaSchema = z.object({
2149
+ models: z.array(MediaUnderstandingModelSchema).optional(),
2150
+ concurrency: z.number().int().positive().optional(),
2151
+ image: ToolsMediaUnderstandingSchema.optional(),
2152
+ audio: ToolsMediaUnderstandingSchema.optional(),
2153
+ video: ToolsMediaUnderstandingSchema.optional()
2154
+ }).strict().optional();
2155
+ const LinkModelSchema = z.object({
2156
+ type: z.literal("cli").optional(),
2157
+ command: z.string().min(1),
2158
+ args: z.array(z.string()).optional(),
2159
+ timeoutSeconds: z.number().int().positive().optional()
2160
+ }).strict();
2161
+ const ToolsLinksSchema = z.object({
2162
+ enabled: z.boolean().optional(),
2163
+ scope: MediaUnderstandingScopeSchema,
2164
+ maxLinks: z.number().int().positive().optional(),
2165
+ timeoutSeconds: z.number().int().positive().optional(),
2166
+ models: z.array(LinkModelSchema).optional()
2167
+ }).strict().optional();
2168
+ const NativeCommandsSettingSchema = z.union([z.boolean(), z.literal("auto")]);
2169
+ const ProviderCommandsSchema = z.object({
2170
+ native: NativeCommandsSettingSchema.optional(),
2171
+ nativeSkills: NativeCommandsSettingSchema.optional()
2172
+ }).strict().optional();
2173
+
2174
+ //#endregion
2175
+ //#region src/config/zod-schema.agent-runtime.ts
2176
+ const HeartbeatSchema = z.object({
2177
+ every: z.string().optional(),
2178
+ activeHours: z.object({
2179
+ start: z.string().optional(),
2180
+ end: z.string().optional(),
2181
+ timezone: z.string().optional()
2182
+ }).strict().optional(),
2183
+ model: z.string().optional(),
2184
+ session: z.string().optional(),
2185
+ includeReasoning: z.boolean().optional(),
2186
+ target: z.string().optional(),
2187
+ to: z.string().optional(),
2188
+ accountId: z.string().optional(),
2189
+ prompt: z.string().optional(),
2190
+ ackMaxChars: z.number().int().nonnegative().optional()
2191
+ }).strict().superRefine((val, ctx) => {
2192
+ if (!val.every) return;
2193
+ try {
2194
+ parseDurationMs(val.every, { defaultUnit: "m" });
2195
+ } catch {
2196
+ ctx.addIssue({
2197
+ code: z.ZodIssueCode.custom,
2198
+ path: ["every"],
2199
+ message: "invalid duration (use ms, s, m, h)"
2200
+ });
2201
+ }
2202
+ const active = val.activeHours;
2203
+ if (!active) return;
2204
+ const timePattern = /^([01]\d|2[0-3]|24):([0-5]\d)$/;
2205
+ const validateTime = (raw, opts, path) => {
2206
+ if (!raw) return;
2207
+ if (!timePattern.test(raw)) {
2208
+ ctx.addIssue({
2209
+ code: z.ZodIssueCode.custom,
2210
+ path: ["activeHours", path],
2211
+ message: "invalid time (use \"HH:MM\" 24h format)"
2212
+ });
2213
+ return;
2214
+ }
2215
+ const [hourStr, minuteStr] = raw.split(":");
2216
+ const hour = Number(hourStr);
2217
+ if (hour === 24 && Number(minuteStr) !== 0) {
2218
+ ctx.addIssue({
2219
+ code: z.ZodIssueCode.custom,
2220
+ path: ["activeHours", path],
2221
+ message: "invalid time (24:00 is the only allowed 24:xx value)"
2222
+ });
2223
+ return;
2224
+ }
2225
+ if (hour === 24 && !opts.allow24) ctx.addIssue({
2226
+ code: z.ZodIssueCode.custom,
2227
+ path: ["activeHours", path],
2228
+ message: "invalid time (start cannot be 24:00)"
2229
+ });
2230
+ };
2231
+ validateTime(active.start, { allow24: false }, "start");
2232
+ validateTime(active.end, { allow24: true }, "end");
2233
+ }).optional();
2234
+ const SandboxDockerSchema = z.object({
2235
+ image: z.string().optional(),
2236
+ containerPrefix: z.string().optional(),
2237
+ workdir: z.string().optional(),
2238
+ readOnlyRoot: z.boolean().optional(),
2239
+ tmpfs: z.array(z.string()).optional(),
2240
+ network: z.string().optional(),
2241
+ user: z.string().optional(),
2242
+ capDrop: z.array(z.string()).optional(),
2243
+ env: z.record(z.string(), z.string()).optional(),
2244
+ setupCommand: z.string().optional(),
2245
+ pidsLimit: z.number().int().positive().optional(),
2246
+ memory: z.union([z.string(), z.number()]).optional(),
2247
+ memorySwap: z.union([z.string(), z.number()]).optional(),
2248
+ cpus: z.number().positive().optional(),
2249
+ ulimits: z.record(z.string(), z.union([
2250
+ z.string(),
2251
+ z.number(),
2252
+ z.object({
2253
+ soft: z.number().int().nonnegative().optional(),
2254
+ hard: z.number().int().nonnegative().optional()
2255
+ }).strict()
2256
+ ])).optional(),
2257
+ seccompProfile: z.string().optional(),
2258
+ apparmorProfile: z.string().optional(),
2259
+ dns: z.array(z.string()).optional(),
2260
+ extraHosts: z.array(z.string()).optional(),
2261
+ binds: z.array(z.string()).optional()
2262
+ }).strict().optional();
2263
+ const SandboxBrowserSchema = z.object({
2264
+ enabled: z.boolean().optional(),
2265
+ image: z.string().optional(),
2266
+ containerPrefix: z.string().optional(),
2267
+ cdpPort: z.number().int().positive().optional(),
2268
+ vncPort: z.number().int().positive().optional(),
2269
+ noVncPort: z.number().int().positive().optional(),
2270
+ headless: z.boolean().optional(),
2271
+ enableNoVnc: z.boolean().optional(),
2272
+ allowHostControl: z.boolean().optional(),
2273
+ autoStart: z.boolean().optional(),
2274
+ autoStartTimeoutMs: z.number().int().positive().optional()
2275
+ }).strict().optional();
2276
+ const SandboxPruneSchema = z.object({
2277
+ idleHours: z.number().int().nonnegative().optional(),
2278
+ maxAgeDays: z.number().int().nonnegative().optional()
2279
+ }).strict().optional();
2280
+ const ToolPolicyBaseSchema = z.object({
2281
+ allow: z.array(z.string()).optional(),
2282
+ alsoAllow: z.array(z.string()).optional(),
2283
+ deny: z.array(z.string()).optional()
2284
+ }).strict();
2285
+ const ToolPolicySchema = ToolPolicyBaseSchema.superRefine((value, ctx) => {
2286
+ if (value.allow && value.allow.length > 0 && value.alsoAllow && value.alsoAllow.length > 0) ctx.addIssue({
2287
+ code: z.ZodIssueCode.custom,
2288
+ message: "tools policy cannot set both allow and alsoAllow in the same scope (merge alsoAllow into allow, or remove allow and use profile + alsoAllow)"
2289
+ });
2290
+ }).optional();
2291
+ const ToolsWebSearchSchema = z.object({
2292
+ enabled: z.boolean().optional(),
2293
+ provider: z.union([z.literal("brave"), z.literal("perplexity")]).optional(),
2294
+ apiKey: z.string().optional(),
2295
+ maxResults: z.number().int().positive().optional(),
2296
+ timeoutSeconds: z.number().int().positive().optional(),
2297
+ cacheTtlMinutes: z.number().nonnegative().optional(),
2298
+ perplexity: z.object({
2299
+ apiKey: z.string().optional(),
2300
+ baseUrl: z.string().optional(),
2301
+ model: z.string().optional()
2302
+ }).strict().optional()
2303
+ }).strict().optional();
2304
+ const ToolsWebFetchSchema = z.object({
2305
+ enabled: z.boolean().optional(),
2306
+ maxChars: z.number().int().positive().optional(),
2307
+ maxCharsCap: z.number().int().positive().optional(),
2308
+ timeoutSeconds: z.number().int().positive().optional(),
2309
+ cacheTtlMinutes: z.number().nonnegative().optional(),
2310
+ maxRedirects: z.number().int().nonnegative().optional(),
2311
+ userAgent: z.string().optional()
2312
+ }).strict().optional();
2313
+ const ToolsWebSchema = z.object({
2314
+ search: ToolsWebSearchSchema,
2315
+ fetch: ToolsWebFetchSchema
2316
+ }).strict().optional();
2317
+ const ToolProfileSchema = z.union([
2318
+ z.literal("minimal"),
2319
+ z.literal("coding"),
2320
+ z.literal("messaging"),
2321
+ z.literal("full")
2322
+ ]).optional();
2323
+ const ToolPolicyWithProfileSchema = z.object({
2324
+ allow: z.array(z.string()).optional(),
2325
+ alsoAllow: z.array(z.string()).optional(),
2326
+ deny: z.array(z.string()).optional(),
2327
+ profile: ToolProfileSchema
2328
+ }).strict().superRefine((value, ctx) => {
2329
+ if (value.allow && value.allow.length > 0 && value.alsoAllow && value.alsoAllow.length > 0) ctx.addIssue({
2330
+ code: z.ZodIssueCode.custom,
2331
+ message: "tools.byProvider policy cannot set both allow and alsoAllow in the same scope (merge alsoAllow into allow, or remove allow and use profile + alsoAllow)"
2332
+ });
2333
+ });
2334
+ const ElevatedAllowFromSchema = z.record(z.string(), z.array(z.union([z.string(), z.number()]))).optional();
2335
+ const AgentSandboxSchema = z.object({
2336
+ mode: z.union([
2337
+ z.literal("off"),
2338
+ z.literal("non-main"),
2339
+ z.literal("all")
2340
+ ]).optional(),
2341
+ workspaceAccess: z.union([
2342
+ z.literal("none"),
2343
+ z.literal("ro"),
2344
+ z.literal("rw")
2345
+ ]).optional(),
2346
+ sessionToolsVisibility: z.union([z.literal("spawned"), z.literal("all")]).optional(),
2347
+ scope: z.union([
2348
+ z.literal("session"),
2349
+ z.literal("agent"),
2350
+ z.literal("shared")
2351
+ ]).optional(),
2352
+ perSession: z.boolean().optional(),
2353
+ workspaceRoot: z.string().optional(),
2354
+ docker: SandboxDockerSchema,
2355
+ browser: SandboxBrowserSchema,
2356
+ prune: SandboxPruneSchema
2357
+ }).strict().optional();
2358
+ const AgentToolsSchema = z.object({
2359
+ profile: ToolProfileSchema,
2360
+ allow: z.array(z.string()).optional(),
2361
+ alsoAllow: z.array(z.string()).optional(),
2362
+ deny: z.array(z.string()).optional(),
2363
+ byProvider: z.record(z.string(), ToolPolicyWithProfileSchema).optional(),
2364
+ elevated: z.object({
2365
+ enabled: z.boolean().optional(),
2366
+ allowFrom: ElevatedAllowFromSchema
2367
+ }).strict().optional(),
2368
+ exec: z.object({
2369
+ host: z.enum([
2370
+ "sandbox",
2371
+ "gateway",
2372
+ "node"
2373
+ ]).optional(),
2374
+ security: z.enum([
2375
+ "deny",
2376
+ "allowlist",
2377
+ "full"
2378
+ ]).optional(),
2379
+ ask: z.enum([
2380
+ "off",
2381
+ "on-miss",
2382
+ "always"
2383
+ ]).optional(),
2384
+ node: z.string().optional(),
2385
+ pathPrepend: z.array(z.string()).optional(),
2386
+ safeBins: z.array(z.string()).optional(),
2387
+ backgroundMs: z.number().int().positive().optional(),
2388
+ timeoutSec: z.number().int().positive().optional(),
2389
+ approvalRunningNoticeMs: z.number().int().nonnegative().optional(),
2390
+ cleanupMs: z.number().int().positive().optional(),
2391
+ notifyOnExit: z.boolean().optional(),
2392
+ applyPatch: z.object({
2393
+ enabled: z.boolean().optional(),
2394
+ allowModels: z.array(z.string()).optional()
2395
+ }).strict().optional()
2396
+ }).strict().optional(),
2397
+ sandbox: z.object({ tools: ToolPolicySchema }).strict().optional()
2398
+ }).strict().superRefine((value, ctx) => {
2399
+ if (value.allow && value.allow.length > 0 && value.alsoAllow && value.alsoAllow.length > 0) ctx.addIssue({
2400
+ code: z.ZodIssueCode.custom,
2401
+ message: "agent tools cannot set both allow and alsoAllow in the same scope (merge alsoAllow into allow, or remove allow and use profile + alsoAllow)"
2402
+ });
2403
+ }).optional();
2404
+ const MemorySearchSchema = z.object({
2405
+ enabled: z.boolean().optional(),
2406
+ sources: z.array(z.union([z.literal("memory"), z.literal("sessions")])).optional(),
2407
+ extraPaths: z.array(z.string()).optional(),
2408
+ experimental: z.object({ sessionMemory: z.boolean().optional() }).strict().optional(),
2409
+ provider: z.union([
2410
+ z.literal("openai"),
2411
+ z.literal("local"),
2412
+ z.literal("gemini"),
2413
+ z.literal("voyage")
2414
+ ]).optional(),
2415
+ remote: z.object({
2416
+ baseUrl: z.string().optional(),
2417
+ apiKey: z.string().optional(),
2418
+ headers: z.record(z.string(), z.string()).optional(),
2419
+ batch: z.object({
2420
+ enabled: z.boolean().optional(),
2421
+ wait: z.boolean().optional(),
2422
+ concurrency: z.number().int().positive().optional(),
2423
+ pollIntervalMs: z.number().int().nonnegative().optional(),
2424
+ timeoutMinutes: z.number().int().positive().optional()
2425
+ }).strict().optional()
2426
+ }).strict().optional(),
2427
+ fallback: z.union([
2428
+ z.literal("openai"),
2429
+ z.literal("gemini"),
2430
+ z.literal("local"),
2431
+ z.literal("voyage"),
2432
+ z.literal("none")
2433
+ ]).optional(),
2434
+ model: z.string().optional(),
2435
+ local: z.object({
2436
+ modelPath: z.string().optional(),
2437
+ modelCacheDir: z.string().optional()
2438
+ }).strict().optional(),
2439
+ store: z.object({
2440
+ driver: z.literal("sqlite").optional(),
2441
+ path: z.string().optional(),
2442
+ vector: z.object({
2443
+ enabled: z.boolean().optional(),
2444
+ extensionPath: z.string().optional()
2445
+ }).strict().optional()
2446
+ }).strict().optional(),
2447
+ chunking: z.object({
2448
+ tokens: z.number().int().positive().optional(),
2449
+ overlap: z.number().int().nonnegative().optional()
2450
+ }).strict().optional(),
2451
+ sync: z.object({
2452
+ onSessionStart: z.boolean().optional(),
2453
+ onSearch: z.boolean().optional(),
2454
+ watch: z.boolean().optional(),
2455
+ watchDebounceMs: z.number().int().nonnegative().optional(),
2456
+ intervalMinutes: z.number().int().nonnegative().optional(),
2457
+ sessions: z.object({
2458
+ deltaBytes: z.number().int().nonnegative().optional(),
2459
+ deltaMessages: z.number().int().nonnegative().optional()
2460
+ }).strict().optional()
2461
+ }).strict().optional(),
2462
+ query: z.object({
2463
+ maxResults: z.number().int().positive().optional(),
2464
+ minScore: z.number().min(0).max(1).optional(),
2465
+ hybrid: z.object({
2466
+ enabled: z.boolean().optional(),
2467
+ vectorWeight: z.number().min(0).max(1).optional(),
2468
+ textWeight: z.number().min(0).max(1).optional(),
2469
+ candidateMultiplier: z.number().int().positive().optional()
2470
+ }).strict().optional()
2471
+ }).strict().optional(),
2472
+ cache: z.object({
2473
+ enabled: z.boolean().optional(),
2474
+ maxEntries: z.number().int().positive().optional()
2475
+ }).strict().optional()
2476
+ }).strict().optional();
2477
+ const AgentModelSchema = z.union([z.string(), z.object({
2478
+ primary: z.string().optional(),
2479
+ fallbacks: z.array(z.string()).optional()
2480
+ }).strict()]);
2481
+ const AgentEntrySchema = z.object({
2482
+ id: z.string(),
2483
+ default: z.boolean().optional(),
2484
+ name: z.string().optional(),
2485
+ workspace: z.string().optional(),
2486
+ agentDir: z.string().optional(),
2487
+ model: AgentModelSchema.optional(),
2488
+ skills: z.array(z.string()).optional(),
2489
+ memorySearch: MemorySearchSchema,
2490
+ humanDelay: HumanDelaySchema.optional(),
2491
+ heartbeat: HeartbeatSchema,
2492
+ identity: IdentitySchema,
2493
+ groupChat: GroupChatSchema,
2494
+ subagents: z.object({
2495
+ allowAgents: z.array(z.string()).optional(),
2496
+ model: z.union([z.string(), z.object({
2497
+ primary: z.string().optional(),
2498
+ fallbacks: z.array(z.string()).optional()
2499
+ }).strict()]).optional(),
2500
+ thinking: z.string().optional()
2501
+ }).strict().optional(),
2502
+ sandbox: AgentSandboxSchema,
2503
+ tools: AgentToolsSchema
2504
+ }).strict();
2505
+ const ToolsSchema = z.object({
2506
+ profile: ToolProfileSchema,
2507
+ allow: z.array(z.string()).optional(),
2508
+ alsoAllow: z.array(z.string()).optional(),
2509
+ deny: z.array(z.string()).optional(),
2510
+ byProvider: z.record(z.string(), ToolPolicyWithProfileSchema).optional(),
2511
+ web: ToolsWebSchema,
2512
+ media: ToolsMediaSchema,
2513
+ links: ToolsLinksSchema,
2514
+ message: z.object({
2515
+ allowCrossContextSend: z.boolean().optional(),
2516
+ crossContext: z.object({
2517
+ allowWithinProvider: z.boolean().optional(),
2518
+ allowAcrossProviders: z.boolean().optional(),
2519
+ marker: z.object({
2520
+ enabled: z.boolean().optional(),
2521
+ prefix: z.string().optional(),
2522
+ suffix: z.string().optional()
2523
+ }).strict().optional()
2524
+ }).strict().optional(),
2525
+ broadcast: z.object({ enabled: z.boolean().optional() }).strict().optional()
2526
+ }).strict().optional(),
2527
+ agentToAgent: z.object({
2528
+ enabled: z.boolean().optional(),
2529
+ allow: z.array(z.string()).optional()
2530
+ }).strict().optional(),
2531
+ elevated: z.object({
2532
+ enabled: z.boolean().optional(),
2533
+ allowFrom: ElevatedAllowFromSchema
2534
+ }).strict().optional(),
2535
+ exec: z.object({
2536
+ host: z.enum([
2537
+ "sandbox",
2538
+ "gateway",
2539
+ "node"
2540
+ ]).optional(),
2541
+ security: z.enum([
2542
+ "deny",
2543
+ "allowlist",
2544
+ "full"
2545
+ ]).optional(),
2546
+ ask: z.enum([
2547
+ "off",
2548
+ "on-miss",
2549
+ "always"
2550
+ ]).optional(),
2551
+ node: z.string().optional(),
2552
+ pathPrepend: z.array(z.string()).optional(),
2553
+ safeBins: z.array(z.string()).optional(),
2554
+ backgroundMs: z.number().int().positive().optional(),
2555
+ timeoutSec: z.number().int().positive().optional(),
2556
+ cleanupMs: z.number().int().positive().optional(),
2557
+ notifyOnExit: z.boolean().optional(),
2558
+ applyPatch: z.object({
2559
+ enabled: z.boolean().optional(),
2560
+ allowModels: z.array(z.string()).optional()
2561
+ }).strict().optional()
2562
+ }).strict().optional(),
2563
+ subagents: z.object({ tools: ToolPolicySchema }).strict().optional(),
2564
+ sandbox: z.object({ tools: ToolPolicySchema }).strict().optional()
2565
+ }).strict().superRefine((value, ctx) => {
2566
+ if (value.allow && value.allow.length > 0 && value.alsoAllow && value.alsoAllow.length > 0) ctx.addIssue({
2567
+ code: z.ZodIssueCode.custom,
2568
+ message: "tools cannot set both allow and alsoAllow in the same scope (merge alsoAllow into allow, or remove allow and use profile + alsoAllow)"
2569
+ });
2570
+ }).optional();
2571
+
2572
+ //#endregion
2573
+ //#region src/config/zod-schema.agent-defaults.ts
2574
+ const AgentDefaultsSchema = z.object({
2575
+ model: z.object({
2576
+ primary: z.string().optional(),
2577
+ fallbacks: z.array(z.string()).optional()
2578
+ }).strict().optional(),
2579
+ imageModel: z.object({
2580
+ primary: z.string().optional(),
2581
+ fallbacks: z.array(z.string()).optional()
2582
+ }).strict().optional(),
2583
+ models: z.record(z.string(), z.object({
2584
+ alias: z.string().optional(),
2585
+ params: z.record(z.string(), z.unknown()).optional(),
2586
+ streaming: z.boolean().optional()
2587
+ }).strict()).optional(),
2588
+ workspace: z.string().optional(),
2589
+ repoRoot: z.string().optional(),
2590
+ skipBootstrap: z.boolean().optional(),
2591
+ bootstrapMaxChars: z.number().int().positive().optional(),
2592
+ userTimezone: z.string().optional(),
2593
+ timeFormat: z.union([
2594
+ z.literal("auto"),
2595
+ z.literal("12"),
2596
+ z.literal("24")
2597
+ ]).optional(),
2598
+ envelopeTimezone: z.string().optional(),
2599
+ envelopeTimestamp: z.union([z.literal("on"), z.literal("off")]).optional(),
2600
+ envelopeElapsed: z.union([z.literal("on"), z.literal("off")]).optional(),
2601
+ contextTokens: z.number().int().positive().optional(),
2602
+ cliBackends: z.record(z.string(), CliBackendSchema).optional(),
2603
+ memorySearch: MemorySearchSchema,
2604
+ contextPruning: z.object({
2605
+ mode: z.union([z.literal("off"), z.literal("cache-ttl")]).optional(),
2606
+ ttl: z.string().optional(),
2607
+ keepLastAssistants: z.number().int().nonnegative().optional(),
2608
+ softTrimRatio: z.number().min(0).max(1).optional(),
2609
+ hardClearRatio: z.number().min(0).max(1).optional(),
2610
+ minPrunableToolChars: z.number().int().nonnegative().optional(),
2611
+ tools: z.object({
2612
+ allow: z.array(z.string()).optional(),
2613
+ deny: z.array(z.string()).optional()
2614
+ }).strict().optional(),
2615
+ softTrim: z.object({
2616
+ maxChars: z.number().int().nonnegative().optional(),
2617
+ headChars: z.number().int().nonnegative().optional(),
2618
+ tailChars: z.number().int().nonnegative().optional()
2619
+ }).strict().optional(),
2620
+ hardClear: z.object({
2621
+ enabled: z.boolean().optional(),
2622
+ placeholder: z.string().optional()
2623
+ }).strict().optional()
2624
+ }).strict().optional(),
2625
+ compaction: z.object({
2626
+ mode: z.union([z.literal("default"), z.literal("safeguard")]).optional(),
2627
+ reserveTokensFloor: z.number().int().nonnegative().optional(),
2628
+ maxHistoryShare: z.number().min(.1).max(.9).optional(),
2629
+ memoryFlush: z.object({
2630
+ enabled: z.boolean().optional(),
2631
+ softThresholdTokens: z.number().int().nonnegative().optional(),
2632
+ prompt: z.string().optional(),
2633
+ systemPrompt: z.string().optional()
2634
+ }).strict().optional()
2635
+ }).strict().optional(),
2636
+ thinkingDefault: z.union([
2637
+ z.literal("off"),
2638
+ z.literal("minimal"),
2639
+ z.literal("low"),
2640
+ z.literal("medium"),
2641
+ z.literal("high"),
2642
+ z.literal("xhigh")
2643
+ ]).optional(),
2644
+ verboseDefault: z.union([
2645
+ z.literal("off"),
2646
+ z.literal("on"),
2647
+ z.literal("full")
2648
+ ]).optional(),
2649
+ elevatedDefault: z.union([
2650
+ z.literal("off"),
2651
+ z.literal("on"),
2652
+ z.literal("ask"),
2653
+ z.literal("full")
2654
+ ]).optional(),
2655
+ blockStreamingDefault: z.union([z.literal("off"), z.literal("on")]).optional(),
2656
+ blockStreamingBreak: z.union([z.literal("text_end"), z.literal("message_end")]).optional(),
2657
+ blockStreamingChunk: BlockStreamingChunkSchema.optional(),
2658
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
2659
+ humanDelay: HumanDelaySchema.optional(),
2660
+ timeoutSeconds: z.number().int().positive().optional(),
2661
+ mediaMaxMb: z.number().positive().optional(),
2662
+ typingIntervalSeconds: z.number().int().positive().optional(),
2663
+ typingMode: z.union([
2664
+ z.literal("never"),
2665
+ z.literal("instant"),
2666
+ z.literal("thinking"),
2667
+ z.literal("message")
2668
+ ]).optional(),
2669
+ heartbeat: HeartbeatSchema,
2670
+ maxConcurrent: z.number().int().positive().optional(),
2671
+ subagents: z.object({
2672
+ maxConcurrent: z.number().int().positive().optional(),
2673
+ archiveAfterMinutes: z.number().int().positive().optional(),
2674
+ model: z.union([z.string(), z.object({
2675
+ primary: z.string().optional(),
2676
+ fallbacks: z.array(z.string()).optional()
2677
+ }).strict()]).optional(),
2678
+ thinking: z.string().optional()
2679
+ }).strict().optional(),
2680
+ sandbox: z.object({
2681
+ mode: z.union([
2682
+ z.literal("off"),
2683
+ z.literal("non-main"),
2684
+ z.literal("all")
2685
+ ]).optional(),
2686
+ workspaceAccess: z.union([
2687
+ z.literal("none"),
2688
+ z.literal("ro"),
2689
+ z.literal("rw")
2690
+ ]).optional(),
2691
+ sessionToolsVisibility: z.union([z.literal("spawned"), z.literal("all")]).optional(),
2692
+ scope: z.union([
2693
+ z.literal("session"),
2694
+ z.literal("agent"),
2695
+ z.literal("shared")
2696
+ ]).optional(),
2697
+ perSession: z.boolean().optional(),
2698
+ workspaceRoot: z.string().optional(),
2699
+ docker: SandboxDockerSchema,
2700
+ browser: SandboxBrowserSchema,
2701
+ prune: SandboxPruneSchema
2702
+ }).strict().optional()
2703
+ }).strict().optional();
2704
+
2705
+ //#endregion
2706
+ //#region src/config/zod-schema.agents.ts
2707
+ const AgentsSchema = z.object({
2708
+ defaults: z.lazy(() => AgentDefaultsSchema).optional(),
2709
+ list: z.array(AgentEntrySchema).optional()
2710
+ }).strict().optional();
2711
+ const BindingsSchema = z.array(z.object({
2712
+ agentId: z.string(),
2713
+ match: z.object({
2714
+ channel: z.string(),
2715
+ accountId: z.string().optional(),
2716
+ peer: z.object({
2717
+ kind: z.union([
2718
+ z.literal("dm"),
2719
+ z.literal("group"),
2720
+ z.literal("channel")
2721
+ ]),
2722
+ id: z.string()
2723
+ }).strict().optional(),
2724
+ guildId: z.string().optional(),
2725
+ teamId: z.string().optional()
2726
+ }).strict()
2727
+ }).strict()).optional();
2728
+ const BroadcastStrategySchema = z.enum(["parallel", "sequential"]);
2729
+ const BroadcastSchema = z.object({ strategy: BroadcastStrategySchema.optional() }).catchall(z.array(z.string())).optional();
2730
+ const AudioSchema = z.object({ transcription: TranscribeAudioSchema }).strict().optional();
2731
+
2732
+ //#endregion
2733
+ //#region src/config/zod-schema.approvals.ts
2734
+ const ExecApprovalForwardTargetSchema = z.object({
2735
+ channel: z.string().min(1),
2736
+ to: z.string().min(1),
2737
+ accountId: z.string().optional(),
2738
+ threadId: z.union([z.string(), z.number()]).optional()
2739
+ }).strict();
2740
+ const ExecApprovalForwardingSchema = z.object({
2741
+ enabled: z.boolean().optional(),
2742
+ mode: z.union([
2743
+ z.literal("session"),
2744
+ z.literal("targets"),
2745
+ z.literal("both")
2746
+ ]).optional(),
2747
+ agentFilter: z.array(z.string()).optional(),
2748
+ sessionFilter: z.array(z.string()).optional(),
2749
+ targets: z.array(ExecApprovalForwardTargetSchema).optional()
2750
+ }).strict().optional();
2751
+ const ApprovalsSchema = z.object({ exec: ExecApprovalForwardingSchema }).strict().optional();
2752
+
2753
+ //#endregion
2754
+ //#region src/config/zod-schema.hooks.ts
2755
+ const HookMappingSchema = z.object({
2756
+ id: z.string().optional(),
2757
+ match: z.object({
2758
+ path: z.string().optional(),
2759
+ source: z.string().optional()
2760
+ }).optional(),
2761
+ action: z.union([z.literal("wake"), z.literal("agent")]).optional(),
2762
+ wakeMode: z.union([z.literal("now"), z.literal("next-heartbeat")]).optional(),
2763
+ name: z.string().optional(),
2764
+ sessionKey: z.string().optional(),
2765
+ messageTemplate: z.string().optional(),
2766
+ textTemplate: z.string().optional(),
2767
+ deliver: z.boolean().optional(),
2768
+ allowUnsafeExternalContent: z.boolean().optional(),
2769
+ channel: z.union([
2770
+ z.literal("last"),
2771
+ z.literal("whatsapp"),
2772
+ z.literal("telegram"),
2773
+ z.literal("discord"),
2774
+ z.literal("slack"),
2775
+ z.literal("signal"),
2776
+ z.literal("imessage"),
2777
+ z.literal("msteams")
2778
+ ]).optional(),
2779
+ to: z.string().optional(),
2780
+ model: z.string().optional(),
2781
+ thinking: z.string().optional(),
2782
+ timeoutSeconds: z.number().int().positive().optional(),
2783
+ transform: z.object({
2784
+ module: z.string(),
2785
+ export: z.string().optional()
2786
+ }).strict().optional()
2787
+ }).strict().optional();
2788
+ const InternalHookHandlerSchema = z.object({
2789
+ event: z.string(),
2790
+ module: z.string(),
2791
+ export: z.string().optional()
2792
+ }).strict();
2793
+ const HookConfigSchema = z.object({
2794
+ enabled: z.boolean().optional(),
2795
+ env: z.record(z.string(), z.string()).optional()
2796
+ }).strict();
2797
+ const HookInstallRecordSchema = z.object({
2798
+ source: z.union([
2799
+ z.literal("npm"),
2800
+ z.literal("archive"),
2801
+ z.literal("path")
2802
+ ]),
2803
+ spec: z.string().optional(),
2804
+ sourcePath: z.string().optional(),
2805
+ installPath: z.string().optional(),
2806
+ version: z.string().optional(),
2807
+ installedAt: z.string().optional(),
2808
+ hooks: z.array(z.string()).optional()
2809
+ }).strict();
2810
+ const InternalHooksSchema = z.object({
2811
+ enabled: z.boolean().optional(),
2812
+ handlers: z.array(InternalHookHandlerSchema).optional(),
2813
+ entries: z.record(z.string(), HookConfigSchema).optional(),
2814
+ load: z.object({ extraDirs: z.array(z.string()).optional() }).strict().optional(),
2815
+ installs: z.record(z.string(), HookInstallRecordSchema).optional()
2816
+ }).strict().optional();
2817
+ const HooksGmailSchema = z.object({
2818
+ account: z.string().optional(),
2819
+ label: z.string().optional(),
2820
+ topic: z.string().optional(),
2821
+ subscription: z.string().optional(),
2822
+ pushToken: z.string().optional(),
2823
+ hookUrl: z.string().optional(),
2824
+ includeBody: z.boolean().optional(),
2825
+ maxBytes: z.number().int().positive().optional(),
2826
+ renewEveryMinutes: z.number().int().positive().optional(),
2827
+ allowUnsafeExternalContent: z.boolean().optional(),
2828
+ serve: z.object({
2829
+ bind: z.string().optional(),
2830
+ port: z.number().int().positive().optional(),
2831
+ path: z.string().optional()
2832
+ }).strict().optional(),
2833
+ tailscale: z.object({
2834
+ mode: z.union([
2835
+ z.literal("off"),
2836
+ z.literal("serve"),
2837
+ z.literal("funnel")
2838
+ ]).optional(),
2839
+ path: z.string().optional(),
2840
+ target: z.string().optional()
2841
+ }).strict().optional(),
2842
+ model: z.string().optional(),
2843
+ thinking: z.union([
2844
+ z.literal("off"),
2845
+ z.literal("minimal"),
2846
+ z.literal("low"),
2847
+ z.literal("medium"),
2848
+ z.literal("high")
2849
+ ]).optional()
2850
+ }).strict().optional();
2851
+
2852
+ //#endregion
2853
+ //#region src/config/zod-schema.channels.ts
2854
+ const ChannelHeartbeatVisibilitySchema = z.object({
2855
+ showOk: z.boolean().optional(),
2856
+ showAlerts: z.boolean().optional(),
2857
+ useIndicator: z.boolean().optional()
2858
+ }).strict().optional();
2859
+
2860
+ //#endregion
2861
+ //#region src/config/telegram-custom-commands.ts
2862
+ const TELEGRAM_COMMAND_NAME_PATTERN = /^[a-z0-9_]{1,32}$/;
2863
+ function normalizeTelegramCommandName(value) {
2864
+ const trimmed = value.trim();
2865
+ if (!trimmed) return "";
2866
+ return (trimmed.startsWith("/") ? trimmed.slice(1) : trimmed).trim().toLowerCase();
2867
+ }
2868
+ function normalizeTelegramCommandDescription(value) {
2869
+ return value.trim();
2870
+ }
2871
+ function resolveTelegramCustomCommands(params) {
2872
+ const entries = Array.isArray(params.commands) ? params.commands : [];
2873
+ const reserved = params.reservedCommands ?? /* @__PURE__ */ new Set();
2874
+ const checkReserved = params.checkReserved !== false;
2875
+ const checkDuplicates = params.checkDuplicates !== false;
2876
+ const seen = /* @__PURE__ */ new Set();
2877
+ const resolved = [];
2878
+ const issues = [];
2879
+ for (let index = 0; index < entries.length; index += 1) {
2880
+ const entry = entries[index];
2881
+ const normalized = normalizeTelegramCommandName(String(entry?.command ?? ""));
2882
+ if (!normalized) {
2883
+ issues.push({
2884
+ index,
2885
+ field: "command",
2886
+ message: "Telegram custom command is missing a command name."
2887
+ });
2888
+ continue;
2889
+ }
2890
+ if (!TELEGRAM_COMMAND_NAME_PATTERN.test(normalized)) {
2891
+ issues.push({
2892
+ index,
2893
+ field: "command",
2894
+ message: `Telegram custom command "/${normalized}" is invalid (use a-z, 0-9, underscore; max 32 chars).`
2895
+ });
2896
+ continue;
2897
+ }
2898
+ if (checkReserved && reserved.has(normalized)) {
2899
+ issues.push({
2900
+ index,
2901
+ field: "command",
2902
+ message: `Telegram custom command "/${normalized}" conflicts with a native command.`
2903
+ });
2904
+ continue;
2905
+ }
2906
+ if (checkDuplicates && seen.has(normalized)) {
2907
+ issues.push({
2908
+ index,
2909
+ field: "command",
2910
+ message: `Telegram custom command "/${normalized}" is duplicated.`
2911
+ });
2912
+ continue;
2913
+ }
2914
+ const description = normalizeTelegramCommandDescription(String(entry?.description ?? ""));
2915
+ if (!description) {
2916
+ issues.push({
2917
+ index,
2918
+ field: "description",
2919
+ message: `Telegram custom command "/${normalized}" is missing a description.`
2920
+ });
2921
+ continue;
2922
+ }
2923
+ if (checkDuplicates) seen.add(normalized);
2924
+ resolved.push({
2925
+ command: normalized,
2926
+ description
2927
+ });
2928
+ }
2929
+ return {
2930
+ commands: resolved,
2931
+ issues
2932
+ };
2933
+ }
2934
+
2935
+ //#endregion
2936
+ //#region src/config/zod-schema.providers-core.ts
2937
+ const ToolPolicyBySenderSchema$1 = z.record(z.string(), ToolPolicySchema).optional();
2938
+ const TelegramInlineButtonsScopeSchema = z.enum([
2939
+ "off",
2940
+ "dm",
2941
+ "group",
2942
+ "all",
2943
+ "allowlist"
2944
+ ]);
2945
+ const TelegramCapabilitiesSchema = z.union([z.array(z.string()), z.object({ inlineButtons: TelegramInlineButtonsScopeSchema.optional() }).strict()]);
2946
+ const TelegramTopicSchema = z.object({
2947
+ requireMention: z.boolean().optional(),
2948
+ groupPolicy: GroupPolicySchema.optional(),
2949
+ skills: z.array(z.string()).optional(),
2950
+ enabled: z.boolean().optional(),
2951
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
2952
+ systemPrompt: z.string().optional()
2953
+ }).strict();
2954
+ const TelegramGroupSchema = z.object({
2955
+ requireMention: z.boolean().optional(),
2956
+ groupPolicy: GroupPolicySchema.optional(),
2957
+ tools: ToolPolicySchema,
2958
+ toolsBySender: ToolPolicyBySenderSchema$1,
2959
+ skills: z.array(z.string()).optional(),
2960
+ enabled: z.boolean().optional(),
2961
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
2962
+ systemPrompt: z.string().optional(),
2963
+ topics: z.record(z.string(), TelegramTopicSchema.optional()).optional()
2964
+ }).strict();
2965
+ const TelegramCustomCommandSchema = z.object({
2966
+ command: z.string().transform(normalizeTelegramCommandName),
2967
+ description: z.string().transform(normalizeTelegramCommandDescription)
2968
+ }).strict();
2969
+ const validateTelegramCustomCommands = (value, ctx) => {
2970
+ if (!value.customCommands || value.customCommands.length === 0) return;
2971
+ const { issues } = resolveTelegramCustomCommands({
2972
+ commands: value.customCommands,
2973
+ checkReserved: false,
2974
+ checkDuplicates: false
2975
+ });
2976
+ for (const issue of issues) ctx.addIssue({
2977
+ code: z.ZodIssueCode.custom,
2978
+ path: [
2979
+ "customCommands",
2980
+ issue.index,
2981
+ issue.field
2982
+ ],
2983
+ message: issue.message
2984
+ });
2985
+ };
2986
+ const TelegramAccountSchemaBase = z.object({
2987
+ name: z.string().optional(),
2988
+ capabilities: TelegramCapabilitiesSchema.optional(),
2989
+ markdown: MarkdownConfigSchema,
2990
+ enabled: z.boolean().optional(),
2991
+ commands: ProviderCommandsSchema,
2992
+ customCommands: z.array(TelegramCustomCommandSchema).optional(),
2993
+ configWrites: z.boolean().optional(),
2994
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
2995
+ botToken: z.string().optional(),
2996
+ tokenFile: z.string().optional(),
2997
+ replyToMode: ReplyToModeSchema.optional(),
2998
+ groups: z.record(z.string(), TelegramGroupSchema.optional()).optional(),
2999
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3000
+ groupAllowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3001
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3002
+ historyLimit: z.number().int().min(0).optional(),
3003
+ dmHistoryLimit: z.number().int().min(0).optional(),
3004
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3005
+ textChunkLimit: z.number().int().positive().optional(),
3006
+ chunkMode: z.enum(["length", "newline"]).optional(),
3007
+ blockStreaming: z.boolean().optional(),
3008
+ draftChunk: BlockStreamingChunkSchema.optional(),
3009
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3010
+ streamMode: z.enum([
3011
+ "off",
3012
+ "partial",
3013
+ "block"
3014
+ ]).optional().default("partial"),
3015
+ mediaMaxMb: z.number().positive().optional(),
3016
+ timeoutSeconds: z.number().int().positive().optional(),
3017
+ retry: RetryConfigSchema,
3018
+ network: z.object({ autoSelectFamily: z.boolean().optional() }).strict().optional(),
3019
+ proxy: z.string().optional(),
3020
+ webhookUrl: z.string().optional(),
3021
+ webhookSecret: z.string().optional(),
3022
+ webhookPath: z.string().optional(),
3023
+ actions: z.object({
3024
+ reactions: z.boolean().optional(),
3025
+ sendMessage: z.boolean().optional(),
3026
+ deleteMessage: z.boolean().optional(),
3027
+ sticker: z.boolean().optional()
3028
+ }).strict().optional(),
3029
+ reactionNotifications: z.enum([
3030
+ "off",
3031
+ "own",
3032
+ "all"
3033
+ ]).optional(),
3034
+ reactionLevel: z.enum([
3035
+ "off",
3036
+ "ack",
3037
+ "minimal",
3038
+ "extensive"
3039
+ ]).optional(),
3040
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3041
+ linkPreview: z.boolean().optional(),
3042
+ responsePrefix: z.string().optional()
3043
+ }).strict();
3044
+ const TelegramAccountSchema = TelegramAccountSchemaBase.superRefine((value, ctx) => {
3045
+ requireOpenAllowFrom({
3046
+ policy: value.dmPolicy,
3047
+ allowFrom: value.allowFrom,
3048
+ ctx,
3049
+ path: ["allowFrom"],
3050
+ message: "channels.telegram.dmPolicy=\"open\" requires channels.telegram.allowFrom to include \"*\""
3051
+ });
3052
+ validateTelegramCustomCommands(value, ctx);
3053
+ });
3054
+ const TelegramConfigSchema = TelegramAccountSchemaBase.extend({ accounts: z.record(z.string(), TelegramAccountSchema.optional()).optional() }).superRefine((value, ctx) => {
3055
+ requireOpenAllowFrom({
3056
+ policy: value.dmPolicy,
3057
+ allowFrom: value.allowFrom,
3058
+ ctx,
3059
+ path: ["allowFrom"],
3060
+ message: "channels.telegram.dmPolicy=\"open\" requires channels.telegram.allowFrom to include \"*\""
3061
+ });
3062
+ validateTelegramCustomCommands(value, ctx);
3063
+ const baseWebhookUrl = typeof value.webhookUrl === "string" ? value.webhookUrl.trim() : "";
3064
+ const baseWebhookSecret = typeof value.webhookSecret === "string" ? value.webhookSecret.trim() : "";
3065
+ if (baseWebhookUrl && !baseWebhookSecret) ctx.addIssue({
3066
+ code: z.ZodIssueCode.custom,
3067
+ message: "channels.telegram.webhookUrl requires channels.telegram.webhookSecret",
3068
+ path: ["webhookSecret"]
3069
+ });
3070
+ if (!value.accounts) return;
3071
+ for (const [accountId, account] of Object.entries(value.accounts)) {
3072
+ if (!account) continue;
3073
+ if (account.enabled === false) continue;
3074
+ if (!(typeof account.webhookUrl === "string" ? account.webhookUrl.trim() : "")) continue;
3075
+ if (!(typeof account.webhookSecret === "string" ? account.webhookSecret.trim() : "") && !baseWebhookSecret) ctx.addIssue({
3076
+ code: z.ZodIssueCode.custom,
3077
+ message: "channels.telegram.accounts.*.webhookUrl requires channels.telegram.webhookSecret or channels.telegram.accounts.*.webhookSecret",
3078
+ path: [
3079
+ "accounts",
3080
+ accountId,
3081
+ "webhookSecret"
3082
+ ]
3083
+ });
3084
+ }
3085
+ });
3086
+ const DiscordDmSchema = z.object({
3087
+ enabled: z.boolean().optional(),
3088
+ policy: DmPolicySchema.optional().default("pairing"),
3089
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3090
+ groupEnabled: z.boolean().optional(),
3091
+ groupChannels: z.array(z.union([z.string(), z.number()])).optional()
3092
+ }).strict().superRefine((value, ctx) => {
3093
+ requireOpenAllowFrom({
3094
+ policy: value.policy,
3095
+ allowFrom: value.allowFrom,
3096
+ ctx,
3097
+ path: ["allowFrom"],
3098
+ message: "channels.discord.dm.policy=\"open\" requires channels.discord.dm.allowFrom to include \"*\""
3099
+ });
3100
+ });
3101
+ const DiscordGuildChannelSchema = z.object({
3102
+ allow: z.boolean().optional(),
3103
+ requireMention: z.boolean().optional(),
3104
+ tools: ToolPolicySchema,
3105
+ toolsBySender: ToolPolicyBySenderSchema$1,
3106
+ skills: z.array(z.string()).optional(),
3107
+ enabled: z.boolean().optional(),
3108
+ users: z.array(z.union([z.string(), z.number()])).optional(),
3109
+ systemPrompt: z.string().optional(),
3110
+ includeThreadStarter: z.boolean().optional(),
3111
+ autoThread: z.boolean().optional()
3112
+ }).strict();
3113
+ const DiscordGuildSchema = z.object({
3114
+ slug: z.string().optional(),
3115
+ requireMention: z.boolean().optional(),
3116
+ tools: ToolPolicySchema,
3117
+ toolsBySender: ToolPolicyBySenderSchema$1,
3118
+ reactionNotifications: z.enum([
3119
+ "off",
3120
+ "own",
3121
+ "all",
3122
+ "allowlist"
3123
+ ]).optional(),
3124
+ users: z.array(z.union([z.string(), z.number()])).optional(),
3125
+ channels: z.record(z.string(), DiscordGuildChannelSchema.optional()).optional()
3126
+ }).strict();
3127
+ const DiscordAccountSchema = z.object({
3128
+ name: z.string().optional(),
3129
+ capabilities: z.array(z.string()).optional(),
3130
+ markdown: MarkdownConfigSchema,
3131
+ enabled: z.boolean().optional(),
3132
+ commands: ProviderCommandsSchema,
3133
+ configWrites: z.boolean().optional(),
3134
+ token: z.string().optional(),
3135
+ allowBots: z.boolean().optional(),
3136
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3137
+ historyLimit: z.number().int().min(0).optional(),
3138
+ dmHistoryLimit: z.number().int().min(0).optional(),
3139
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3140
+ textChunkLimit: z.number().int().positive().optional(),
3141
+ chunkMode: z.enum(["length", "newline"]).optional(),
3142
+ blockStreaming: z.boolean().optional(),
3143
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3144
+ maxLinesPerMessage: z.number().int().positive().optional(),
3145
+ mediaMaxMb: z.number().positive().optional(),
3146
+ retry: RetryConfigSchema,
3147
+ actions: z.object({
3148
+ reactions: z.boolean().optional(),
3149
+ stickers: z.boolean().optional(),
3150
+ emojiUploads: z.boolean().optional(),
3151
+ stickerUploads: z.boolean().optional(),
3152
+ polls: z.boolean().optional(),
3153
+ permissions: z.boolean().optional(),
3154
+ messages: z.boolean().optional(),
3155
+ threads: z.boolean().optional(),
3156
+ pins: z.boolean().optional(),
3157
+ search: z.boolean().optional(),
3158
+ memberInfo: z.boolean().optional(),
3159
+ roleInfo: z.boolean().optional(),
3160
+ roles: z.boolean().optional(),
3161
+ channelInfo: z.boolean().optional(),
3162
+ voiceStatus: z.boolean().optional(),
3163
+ events: z.boolean().optional(),
3164
+ moderation: z.boolean().optional(),
3165
+ channels: z.boolean().optional(),
3166
+ presence: z.boolean().optional()
3167
+ }).strict().optional(),
3168
+ replyToMode: ReplyToModeSchema.optional(),
3169
+ dm: DiscordDmSchema.optional(),
3170
+ guilds: z.record(z.string(), DiscordGuildSchema.optional()).optional(),
3171
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3172
+ execApprovals: z.object({
3173
+ enabled: z.boolean().optional(),
3174
+ approvers: z.array(z.union([z.string(), z.number()])).optional(),
3175
+ agentFilter: z.array(z.string()).optional(),
3176
+ sessionFilter: z.array(z.string()).optional()
3177
+ }).strict().optional(),
3178
+ intents: z.object({
3179
+ presence: z.boolean().optional(),
3180
+ guildMembers: z.boolean().optional()
3181
+ }).strict().optional(),
3182
+ pluralkit: z.object({
3183
+ enabled: z.boolean().optional(),
3184
+ token: z.string().optional()
3185
+ }).strict().optional(),
3186
+ responsePrefix: z.string().optional()
3187
+ }).strict();
3188
+ const DiscordConfigSchema = DiscordAccountSchema.extend({ accounts: z.record(z.string(), DiscordAccountSchema.optional()).optional() });
3189
+ const GoogleChatDmSchema = z.object({
3190
+ enabled: z.boolean().optional(),
3191
+ policy: DmPolicySchema.optional().default("pairing"),
3192
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional()
3193
+ }).strict().superRefine((value, ctx) => {
3194
+ requireOpenAllowFrom({
3195
+ policy: value.policy,
3196
+ allowFrom: value.allowFrom,
3197
+ ctx,
3198
+ path: ["allowFrom"],
3199
+ message: "channels.googlechat.dm.policy=\"open\" requires channels.googlechat.dm.allowFrom to include \"*\""
3200
+ });
3201
+ });
3202
+ const GoogleChatGroupSchema = z.object({
3203
+ enabled: z.boolean().optional(),
3204
+ allow: z.boolean().optional(),
3205
+ requireMention: z.boolean().optional(),
3206
+ users: z.array(z.union([z.string(), z.number()])).optional(),
3207
+ systemPrompt: z.string().optional()
3208
+ }).strict();
3209
+ const GoogleChatAccountSchema = z.object({
3210
+ name: z.string().optional(),
3211
+ capabilities: z.array(z.string()).optional(),
3212
+ enabled: z.boolean().optional(),
3213
+ configWrites: z.boolean().optional(),
3214
+ allowBots: z.boolean().optional(),
3215
+ requireMention: z.boolean().optional(),
3216
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3217
+ groupAllowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3218
+ groups: z.record(z.string(), GoogleChatGroupSchema.optional()).optional(),
3219
+ serviceAccount: z.union([z.string(), z.record(z.string(), z.unknown())]).optional(),
3220
+ serviceAccountFile: z.string().optional(),
3221
+ audienceType: z.enum(["app-url", "project-number"]).optional(),
3222
+ audience: z.string().optional(),
3223
+ webhookPath: z.string().optional(),
3224
+ webhookUrl: z.string().optional(),
3225
+ botUser: z.string().optional(),
3226
+ historyLimit: z.number().int().min(0).optional(),
3227
+ dmHistoryLimit: z.number().int().min(0).optional(),
3228
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3229
+ textChunkLimit: z.number().int().positive().optional(),
3230
+ chunkMode: z.enum(["length", "newline"]).optional(),
3231
+ blockStreaming: z.boolean().optional(),
3232
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3233
+ mediaMaxMb: z.number().positive().optional(),
3234
+ replyToMode: ReplyToModeSchema.optional(),
3235
+ actions: z.object({ reactions: z.boolean().optional() }).strict().optional(),
3236
+ dm: GoogleChatDmSchema.optional(),
3237
+ typingIndicator: z.enum([
3238
+ "none",
3239
+ "message",
3240
+ "reaction"
3241
+ ]).optional(),
3242
+ responsePrefix: z.string().optional()
3243
+ }).strict();
3244
+ const GoogleChatConfigSchema = GoogleChatAccountSchema.extend({
3245
+ accounts: z.record(z.string(), GoogleChatAccountSchema.optional()).optional(),
3246
+ defaultAccount: z.string().optional()
3247
+ });
3248
+ const SlackDmSchema = z.object({
3249
+ enabled: z.boolean().optional(),
3250
+ policy: DmPolicySchema.optional().default("pairing"),
3251
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3252
+ groupEnabled: z.boolean().optional(),
3253
+ groupChannels: z.array(z.union([z.string(), z.number()])).optional(),
3254
+ replyToMode: ReplyToModeSchema.optional()
3255
+ }).strict().superRefine((value, ctx) => {
3256
+ requireOpenAllowFrom({
3257
+ policy: value.policy,
3258
+ allowFrom: value.allowFrom,
3259
+ ctx,
3260
+ path: ["allowFrom"],
3261
+ message: "channels.slack.dm.policy=\"open\" requires channels.slack.dm.allowFrom to include \"*\""
3262
+ });
3263
+ });
3264
+ const SlackChannelSchema = z.object({
3265
+ enabled: z.boolean().optional(),
3266
+ allow: z.boolean().optional(),
3267
+ requireMention: z.boolean().optional(),
3268
+ tools: ToolPolicySchema,
3269
+ toolsBySender: ToolPolicyBySenderSchema$1,
3270
+ allowBots: z.boolean().optional(),
3271
+ users: z.array(z.union([z.string(), z.number()])).optional(),
3272
+ skills: z.array(z.string()).optional(),
3273
+ systemPrompt: z.string().optional()
3274
+ }).strict();
3275
+ const SlackThreadSchema = z.object({
3276
+ historyScope: z.enum(["thread", "channel"]).optional(),
3277
+ inheritParent: z.boolean().optional()
3278
+ }).strict();
3279
+ const SlackReplyToModeByChatTypeSchema = z.object({
3280
+ direct: ReplyToModeSchema.optional(),
3281
+ group: ReplyToModeSchema.optional(),
3282
+ channel: ReplyToModeSchema.optional()
3283
+ }).strict();
3284
+ const SlackAccountSchema = z.object({
3285
+ name: z.string().optional(),
3286
+ mode: z.enum(["socket", "http"]).optional(),
3287
+ signingSecret: z.string().optional(),
3288
+ webhookPath: z.string().optional(),
3289
+ capabilities: z.array(z.string()).optional(),
3290
+ markdown: MarkdownConfigSchema,
3291
+ enabled: z.boolean().optional(),
3292
+ commands: ProviderCommandsSchema,
3293
+ configWrites: z.boolean().optional(),
3294
+ botToken: z.string().optional(),
3295
+ appToken: z.string().optional(),
3296
+ userToken: z.string().optional(),
3297
+ userTokenReadOnly: z.boolean().optional().default(true),
3298
+ allowBots: z.boolean().optional(),
3299
+ requireMention: z.boolean().optional(),
3300
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3301
+ historyLimit: z.number().int().min(0).optional(),
3302
+ dmHistoryLimit: z.number().int().min(0).optional(),
3303
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3304
+ textChunkLimit: z.number().int().positive().optional(),
3305
+ chunkMode: z.enum(["length", "newline"]).optional(),
3306
+ blockStreaming: z.boolean().optional(),
3307
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3308
+ mediaMaxMb: z.number().positive().optional(),
3309
+ reactionNotifications: z.enum([
3310
+ "off",
3311
+ "own",
3312
+ "all",
3313
+ "allowlist"
3314
+ ]).optional(),
3315
+ reactionAllowlist: z.array(z.union([z.string(), z.number()])).optional(),
3316
+ replyToMode: ReplyToModeSchema.optional(),
3317
+ replyToModeByChatType: SlackReplyToModeByChatTypeSchema.optional(),
3318
+ thread: SlackThreadSchema.optional(),
3319
+ actions: z.object({
3320
+ reactions: z.boolean().optional(),
3321
+ messages: z.boolean().optional(),
3322
+ pins: z.boolean().optional(),
3323
+ search: z.boolean().optional(),
3324
+ permissions: z.boolean().optional(),
3325
+ memberInfo: z.boolean().optional(),
3326
+ channelInfo: z.boolean().optional(),
3327
+ emojiList: z.boolean().optional()
3328
+ }).strict().optional(),
3329
+ slashCommand: z.object({
3330
+ enabled: z.boolean().optional(),
3331
+ name: z.string().optional(),
3332
+ sessionPrefix: z.string().optional(),
3333
+ ephemeral: z.boolean().optional()
3334
+ }).strict().optional(),
3335
+ dm: SlackDmSchema.optional(),
3336
+ channels: z.record(z.string(), SlackChannelSchema.optional()).optional(),
3337
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3338
+ responsePrefix: z.string().optional()
3339
+ }).strict();
3340
+ const SlackConfigSchema = SlackAccountSchema.extend({
3341
+ mode: z.enum(["socket", "http"]).optional().default("socket"),
3342
+ signingSecret: z.string().optional(),
3343
+ webhookPath: z.string().optional().default("/slack/events"),
3344
+ accounts: z.record(z.string(), SlackAccountSchema.optional()).optional()
3345
+ }).superRefine((value, ctx) => {
3346
+ const baseMode = value.mode ?? "socket";
3347
+ if (baseMode === "http" && !value.signingSecret) ctx.addIssue({
3348
+ code: z.ZodIssueCode.custom,
3349
+ message: "channels.slack.mode=\"http\" requires channels.slack.signingSecret",
3350
+ path: ["signingSecret"]
3351
+ });
3352
+ if (!value.accounts) return;
3353
+ for (const [accountId, account] of Object.entries(value.accounts)) {
3354
+ if (!account) continue;
3355
+ if (account.enabled === false) continue;
3356
+ if ((account.mode ?? baseMode) !== "http") continue;
3357
+ if (!(account.signingSecret ?? value.signingSecret)) ctx.addIssue({
3358
+ code: z.ZodIssueCode.custom,
3359
+ message: "channels.slack.accounts.*.mode=\"http\" requires channels.slack.signingSecret or channels.slack.accounts.*.signingSecret",
3360
+ path: [
3361
+ "accounts",
3362
+ accountId,
3363
+ "signingSecret"
3364
+ ]
3365
+ });
3366
+ }
3367
+ });
3368
+ const SignalAccountSchemaBase = z.object({
3369
+ name: z.string().optional(),
3370
+ capabilities: z.array(z.string()).optional(),
3371
+ markdown: MarkdownConfigSchema,
3372
+ enabled: z.boolean().optional(),
3373
+ configWrites: z.boolean().optional(),
3374
+ account: z.string().optional(),
3375
+ httpUrl: z.string().optional(),
3376
+ httpHost: z.string().optional(),
3377
+ httpPort: z.number().int().positive().optional(),
3378
+ cliPath: ExecutableTokenSchema.optional(),
3379
+ autoStart: z.boolean().optional(),
3380
+ startupTimeoutMs: z.number().int().min(1e3).max(12e4).optional(),
3381
+ receiveMode: z.union([z.literal("on-start"), z.literal("manual")]).optional(),
3382
+ ignoreAttachments: z.boolean().optional(),
3383
+ ignoreStories: z.boolean().optional(),
3384
+ sendReadReceipts: z.boolean().optional(),
3385
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3386
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3387
+ groupAllowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3388
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3389
+ historyLimit: z.number().int().min(0).optional(),
3390
+ dmHistoryLimit: z.number().int().min(0).optional(),
3391
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3392
+ textChunkLimit: z.number().int().positive().optional(),
3393
+ chunkMode: z.enum(["length", "newline"]).optional(),
3394
+ blockStreaming: z.boolean().optional(),
3395
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3396
+ mediaMaxMb: z.number().int().positive().optional(),
3397
+ reactionNotifications: z.enum([
3398
+ "off",
3399
+ "own",
3400
+ "all",
3401
+ "allowlist"
3402
+ ]).optional(),
3403
+ reactionAllowlist: z.array(z.union([z.string(), z.number()])).optional(),
3404
+ actions: z.object({ reactions: z.boolean().optional() }).strict().optional(),
3405
+ reactionLevel: z.enum([
3406
+ "off",
3407
+ "ack",
3408
+ "minimal",
3409
+ "extensive"
3410
+ ]).optional(),
3411
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3412
+ responsePrefix: z.string().optional()
3413
+ }).strict();
3414
+ const SignalAccountSchema = SignalAccountSchemaBase.superRefine((value, ctx) => {
3415
+ requireOpenAllowFrom({
3416
+ policy: value.dmPolicy,
3417
+ allowFrom: value.allowFrom,
3418
+ ctx,
3419
+ path: ["allowFrom"],
3420
+ message: "channels.signal.dmPolicy=\"open\" requires channels.signal.allowFrom to include \"*\""
3421
+ });
3422
+ });
3423
+ const SignalConfigSchema = SignalAccountSchemaBase.extend({ accounts: z.record(z.string(), SignalAccountSchema.optional()).optional() }).superRefine((value, ctx) => {
3424
+ requireOpenAllowFrom({
3425
+ policy: value.dmPolicy,
3426
+ allowFrom: value.allowFrom,
3427
+ ctx,
3428
+ path: ["allowFrom"],
3429
+ message: "channels.signal.dmPolicy=\"open\" requires channels.signal.allowFrom to include \"*\""
3430
+ });
3431
+ });
3432
+ const IMessageAccountSchemaBase = z.object({
3433
+ name: z.string().optional(),
3434
+ capabilities: z.array(z.string()).optional(),
3435
+ markdown: MarkdownConfigSchema,
3436
+ enabled: z.boolean().optional(),
3437
+ configWrites: z.boolean().optional(),
3438
+ cliPath: ExecutableTokenSchema.optional(),
3439
+ dbPath: z.string().optional(),
3440
+ remoteHost: z.string().optional(),
3441
+ service: z.union([
3442
+ z.literal("imessage"),
3443
+ z.literal("sms"),
3444
+ z.literal("auto")
3445
+ ]).optional(),
3446
+ region: z.string().optional(),
3447
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3448
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3449
+ groupAllowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3450
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3451
+ historyLimit: z.number().int().min(0).optional(),
3452
+ dmHistoryLimit: z.number().int().min(0).optional(),
3453
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3454
+ includeAttachments: z.boolean().optional(),
3455
+ mediaMaxMb: z.number().int().positive().optional(),
3456
+ textChunkLimit: z.number().int().positive().optional(),
3457
+ chunkMode: z.enum(["length", "newline"]).optional(),
3458
+ blockStreaming: z.boolean().optional(),
3459
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3460
+ groups: z.record(z.string(), z.object({
3461
+ requireMention: z.boolean().optional(),
3462
+ tools: ToolPolicySchema,
3463
+ toolsBySender: ToolPolicyBySenderSchema$1
3464
+ }).strict().optional()).optional(),
3465
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3466
+ responsePrefix: z.string().optional()
3467
+ }).strict();
3468
+ const IMessageAccountSchema = IMessageAccountSchemaBase.superRefine((value, ctx) => {
3469
+ requireOpenAllowFrom({
3470
+ policy: value.dmPolicy,
3471
+ allowFrom: value.allowFrom,
3472
+ ctx,
3473
+ path: ["allowFrom"],
3474
+ message: "channels.imessage.dmPolicy=\"open\" requires channels.imessage.allowFrom to include \"*\""
3475
+ });
3476
+ });
3477
+ const IMessageConfigSchema = IMessageAccountSchemaBase.extend({ accounts: z.record(z.string(), IMessageAccountSchema.optional()).optional() }).superRefine((value, ctx) => {
3478
+ requireOpenAllowFrom({
3479
+ policy: value.dmPolicy,
3480
+ allowFrom: value.allowFrom,
3481
+ ctx,
3482
+ path: ["allowFrom"],
3483
+ message: "channels.imessage.dmPolicy=\"open\" requires channels.imessage.allowFrom to include \"*\""
3484
+ });
3485
+ });
3486
+ const BlueBubblesAllowFromEntry = z.union([z.string(), z.number()]);
3487
+ const BlueBubblesActionSchema = z.object({
3488
+ reactions: z.boolean().optional(),
3489
+ edit: z.boolean().optional(),
3490
+ unsend: z.boolean().optional(),
3491
+ reply: z.boolean().optional(),
3492
+ sendWithEffect: z.boolean().optional(),
3493
+ renameGroup: z.boolean().optional(),
3494
+ setGroupIcon: z.boolean().optional(),
3495
+ addParticipant: z.boolean().optional(),
3496
+ removeParticipant: z.boolean().optional(),
3497
+ leaveGroup: z.boolean().optional(),
3498
+ sendAttachment: z.boolean().optional()
3499
+ }).strict().optional();
3500
+ const BlueBubblesGroupConfigSchema = z.object({
3501
+ requireMention: z.boolean().optional(),
3502
+ tools: ToolPolicySchema,
3503
+ toolsBySender: ToolPolicyBySenderSchema$1
3504
+ }).strict();
3505
+ const BlueBubblesAccountSchemaBase = z.object({
3506
+ name: z.string().optional(),
3507
+ capabilities: z.array(z.string()).optional(),
3508
+ markdown: MarkdownConfigSchema,
3509
+ configWrites: z.boolean().optional(),
3510
+ enabled: z.boolean().optional(),
3511
+ serverUrl: z.string().optional(),
3512
+ password: z.string().optional(),
3513
+ webhookPath: z.string().optional(),
3514
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3515
+ allowFrom: z.array(BlueBubblesAllowFromEntry).optional(),
3516
+ groupAllowFrom: z.array(BlueBubblesAllowFromEntry).optional(),
3517
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3518
+ historyLimit: z.number().int().min(0).optional(),
3519
+ dmHistoryLimit: z.number().int().min(0).optional(),
3520
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3521
+ textChunkLimit: z.number().int().positive().optional(),
3522
+ chunkMode: z.enum(["length", "newline"]).optional(),
3523
+ mediaMaxMb: z.number().int().positive().optional(),
3524
+ sendReadReceipts: z.boolean().optional(),
3525
+ blockStreaming: z.boolean().optional(),
3526
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3527
+ groups: z.record(z.string(), BlueBubblesGroupConfigSchema.optional()).optional(),
3528
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3529
+ responsePrefix: z.string().optional()
3530
+ }).strict();
3531
+ const BlueBubblesAccountSchema = BlueBubblesAccountSchemaBase.superRefine((value, ctx) => {
3532
+ requireOpenAllowFrom({
3533
+ policy: value.dmPolicy,
3534
+ allowFrom: value.allowFrom,
3535
+ ctx,
3536
+ path: ["allowFrom"],
3537
+ message: "channels.bluebubbles.accounts.*.dmPolicy=\"open\" requires allowFrom to include \"*\""
3538
+ });
3539
+ });
3540
+ const BlueBubblesConfigSchema = BlueBubblesAccountSchemaBase.extend({
3541
+ accounts: z.record(z.string(), BlueBubblesAccountSchema.optional()).optional(),
3542
+ actions: BlueBubblesActionSchema
3543
+ }).superRefine((value, ctx) => {
3544
+ requireOpenAllowFrom({
3545
+ policy: value.dmPolicy,
3546
+ allowFrom: value.allowFrom,
3547
+ ctx,
3548
+ path: ["allowFrom"],
3549
+ message: "channels.bluebubbles.dmPolicy=\"open\" requires channels.bluebubbles.allowFrom to include \"*\""
3550
+ });
3551
+ });
3552
+ const MSTeamsChannelSchema = z.object({
3553
+ requireMention: z.boolean().optional(),
3554
+ tools: ToolPolicySchema,
3555
+ toolsBySender: ToolPolicyBySenderSchema$1,
3556
+ replyStyle: MSTeamsReplyStyleSchema.optional()
3557
+ }).strict();
3558
+ const MSTeamsTeamSchema = z.object({
3559
+ requireMention: z.boolean().optional(),
3560
+ tools: ToolPolicySchema,
3561
+ toolsBySender: ToolPolicyBySenderSchema$1,
3562
+ replyStyle: MSTeamsReplyStyleSchema.optional(),
3563
+ channels: z.record(z.string(), MSTeamsChannelSchema.optional()).optional()
3564
+ }).strict();
3565
+ const MSTeamsConfigSchema = z.object({
3566
+ enabled: z.boolean().optional(),
3567
+ capabilities: z.array(z.string()).optional(),
3568
+ markdown: MarkdownConfigSchema,
3569
+ configWrites: z.boolean().optional(),
3570
+ appId: z.string().optional(),
3571
+ appPassword: z.string().optional(),
3572
+ tenantId: z.string().optional(),
3573
+ webhook: z.object({
3574
+ port: z.number().int().positive().optional(),
3575
+ path: z.string().optional()
3576
+ }).strict().optional(),
3577
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3578
+ allowFrom: z.array(z.string()).optional(),
3579
+ groupAllowFrom: z.array(z.string()).optional(),
3580
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3581
+ textChunkLimit: z.number().int().positive().optional(),
3582
+ chunkMode: z.enum(["length", "newline"]).optional(),
3583
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3584
+ mediaAllowHosts: z.array(z.string()).optional(),
3585
+ mediaAuthAllowHosts: z.array(z.string()).optional(),
3586
+ requireMention: z.boolean().optional(),
3587
+ historyLimit: z.number().int().min(0).optional(),
3588
+ dmHistoryLimit: z.number().int().min(0).optional(),
3589
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3590
+ replyStyle: MSTeamsReplyStyleSchema.optional(),
3591
+ teams: z.record(z.string(), MSTeamsTeamSchema.optional()).optional(),
3592
+ mediaMaxMb: z.number().positive().optional(),
3593
+ sharePointSiteId: z.string().optional(),
3594
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3595
+ responsePrefix: z.string().optional()
3596
+ }).strict().superRefine((value, ctx) => {
3597
+ requireOpenAllowFrom({
3598
+ policy: value.dmPolicy,
3599
+ allowFrom: value.allowFrom,
3600
+ ctx,
3601
+ path: ["allowFrom"],
3602
+ message: "channels.msteams.dmPolicy=\"open\" requires channels.msteams.allowFrom to include \"*\""
3603
+ });
3604
+ });
3605
+
3606
+ //#endregion
3607
+ //#region src/config/zod-schema.providers-whatsapp.ts
3608
+ const ToolPolicyBySenderSchema = z.record(z.string(), ToolPolicySchema).optional();
3609
+ const WhatsAppAccountSchema = z.object({
3610
+ name: z.string().optional(),
3611
+ capabilities: z.array(z.string()).optional(),
3612
+ markdown: MarkdownConfigSchema,
3613
+ configWrites: z.boolean().optional(),
3614
+ enabled: z.boolean().optional(),
3615
+ sendReadReceipts: z.boolean().optional(),
3616
+ messagePrefix: z.string().optional(),
3617
+ responsePrefix: z.string().optional(),
3618
+ authDir: z.string().optional(),
3619
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3620
+ selfChatMode: z.boolean().optional(),
3621
+ allowFrom: z.array(z.string()).optional(),
3622
+ groupAllowFrom: z.array(z.string()).optional(),
3623
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3624
+ historyLimit: z.number().int().min(0).optional(),
3625
+ dmHistoryLimit: z.number().int().min(0).optional(),
3626
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3627
+ textChunkLimit: z.number().int().positive().optional(),
3628
+ chunkMode: z.enum(["length", "newline"]).optional(),
3629
+ mediaMaxMb: z.number().int().positive().optional(),
3630
+ blockStreaming: z.boolean().optional(),
3631
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3632
+ groups: z.record(z.string(), z.object({
3633
+ requireMention: z.boolean().optional(),
3634
+ tools: ToolPolicySchema,
3635
+ toolsBySender: ToolPolicyBySenderSchema
3636
+ }).strict().optional()).optional(),
3637
+ ackReaction: z.object({
3638
+ emoji: z.string().optional(),
3639
+ direct: z.boolean().optional().default(true),
3640
+ group: z.enum([
3641
+ "always",
3642
+ "mentions",
3643
+ "never"
3644
+ ]).optional().default("mentions")
3645
+ }).strict().optional(),
3646
+ debounceMs: z.number().int().nonnegative().optional().default(0),
3647
+ heartbeat: ChannelHeartbeatVisibilitySchema
3648
+ }).strict().superRefine((value, ctx) => {
3649
+ if (value.dmPolicy !== "open") return;
3650
+ if ((value.allowFrom ?? []).map((v) => String(v).trim()).filter(Boolean).includes("*")) return;
3651
+ ctx.addIssue({
3652
+ code: z.ZodIssueCode.custom,
3653
+ path: ["allowFrom"],
3654
+ message: "channels.whatsapp.accounts.*.dmPolicy=\"open\" requires allowFrom to include \"*\""
3655
+ });
3656
+ });
3657
+ const WhatsAppConfigSchema = z.object({
3658
+ accounts: z.record(z.string(), WhatsAppAccountSchema.optional()).optional(),
3659
+ capabilities: z.array(z.string()).optional(),
3660
+ markdown: MarkdownConfigSchema,
3661
+ configWrites: z.boolean().optional(),
3662
+ sendReadReceipts: z.boolean().optional(),
3663
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3664
+ messagePrefix: z.string().optional(),
3665
+ responsePrefix: z.string().optional(),
3666
+ selfChatMode: z.boolean().optional(),
3667
+ allowFrom: z.array(z.string()).optional(),
3668
+ groupAllowFrom: z.array(z.string()).optional(),
3669
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3670
+ historyLimit: z.number().int().min(0).optional(),
3671
+ dmHistoryLimit: z.number().int().min(0).optional(),
3672
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3673
+ textChunkLimit: z.number().int().positive().optional(),
3674
+ chunkMode: z.enum(["length", "newline"]).optional(),
3675
+ mediaMaxMb: z.number().int().positive().optional().default(50),
3676
+ blockStreaming: z.boolean().optional(),
3677
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3678
+ actions: z.object({
3679
+ reactions: z.boolean().optional(),
3680
+ sendMessage: z.boolean().optional(),
3681
+ polls: z.boolean().optional()
3682
+ }).strict().optional(),
3683
+ groups: z.record(z.string(), z.object({
3684
+ requireMention: z.boolean().optional(),
3685
+ tools: ToolPolicySchema,
3686
+ toolsBySender: ToolPolicyBySenderSchema
3687
+ }).strict().optional()).optional(),
3688
+ ackReaction: z.object({
3689
+ emoji: z.string().optional(),
3690
+ direct: z.boolean().optional().default(true),
3691
+ group: z.enum([
3692
+ "always",
3693
+ "mentions",
3694
+ "never"
3695
+ ]).optional().default("mentions")
3696
+ }).strict().optional(),
3697
+ debounceMs: z.number().int().nonnegative().optional().default(0),
3698
+ heartbeat: ChannelHeartbeatVisibilitySchema
3699
+ }).strict().superRefine((value, ctx) => {
3700
+ if (value.dmPolicy !== "open") return;
3701
+ if ((value.allowFrom ?? []).map((v) => String(v).trim()).filter(Boolean).includes("*")) return;
3702
+ ctx.addIssue({
3703
+ code: z.ZodIssueCode.custom,
3704
+ path: ["allowFrom"],
3705
+ message: "channels.whatsapp.dmPolicy=\"open\" requires channels.whatsapp.allowFrom to include \"*\""
3706
+ });
3707
+ });
3708
+
3709
+ //#endregion
3710
+ //#region src/config/zod-schema.providers.ts
3711
+ const ChannelsSchema = z.object({
3712
+ defaults: z.object({
3713
+ groupPolicy: GroupPolicySchema.optional(),
3714
+ heartbeat: ChannelHeartbeatVisibilitySchema
3715
+ }).strict().optional(),
3716
+ whatsapp: WhatsAppConfigSchema.optional(),
3717
+ telegram: TelegramConfigSchema.optional(),
3718
+ discord: DiscordConfigSchema.optional(),
3719
+ googlechat: GoogleChatConfigSchema.optional(),
3720
+ slack: SlackConfigSchema.optional(),
3721
+ signal: SignalConfigSchema.optional(),
3722
+ imessage: IMessageConfigSchema.optional(),
3723
+ bluebubbles: BlueBubblesConfigSchema.optional(),
3724
+ msteams: MSTeamsConfigSchema.optional()
3725
+ }).passthrough().optional();
3726
+
3727
+ //#endregion
3728
+ //#region src/config/zod-schema.session.ts
3729
+ const SessionResetConfigSchema = z.object({
3730
+ mode: z.union([z.literal("daily"), z.literal("idle")]).optional(),
3731
+ atHour: z.number().int().min(0).max(23).optional(),
3732
+ idleMinutes: z.number().int().positive().optional()
3733
+ }).strict();
3734
+ const SessionSendPolicySchema = z.object({
3735
+ default: z.union([z.literal("allow"), z.literal("deny")]).optional(),
3736
+ rules: z.array(z.object({
3737
+ action: z.union([z.literal("allow"), z.literal("deny")]),
3738
+ match: z.object({
3739
+ channel: z.string().optional(),
3740
+ chatType: z.union([
3741
+ z.literal("direct"),
3742
+ z.literal("group"),
3743
+ z.literal("channel")
3744
+ ]).optional(),
3745
+ keyPrefix: z.string().optional()
3746
+ }).strict().optional()
3747
+ }).strict()).optional()
3748
+ }).strict();
3749
+ const SessionSchema = z.object({
3750
+ scope: z.union([z.literal("per-sender"), z.literal("global")]).optional(),
3751
+ dmScope: z.union([
3752
+ z.literal("main"),
3753
+ z.literal("per-peer"),
3754
+ z.literal("per-channel-peer"),
3755
+ z.literal("per-account-channel-peer")
3756
+ ]).optional(),
3757
+ identityLinks: z.record(z.string(), z.array(z.string())).optional(),
3758
+ resetTriggers: z.array(z.string()).optional(),
3759
+ idleMinutes: z.number().int().positive().optional(),
3760
+ reset: SessionResetConfigSchema.optional(),
3761
+ resetByType: z.object({
3762
+ dm: SessionResetConfigSchema.optional(),
3763
+ group: SessionResetConfigSchema.optional(),
3764
+ thread: SessionResetConfigSchema.optional()
3765
+ }).strict().optional(),
3766
+ resetByChannel: z.record(z.string(), SessionResetConfigSchema).optional(),
3767
+ store: z.string().optional(),
3768
+ typingIntervalSeconds: z.number().int().positive().optional(),
3769
+ typingMode: z.union([
3770
+ z.literal("never"),
3771
+ z.literal("instant"),
3772
+ z.literal("thinking"),
3773
+ z.literal("message")
3774
+ ]).optional(),
3775
+ mainKey: z.string().optional(),
3776
+ sendPolicy: SessionSendPolicySchema.optional(),
3777
+ agentToAgent: z.object({ maxPingPongTurns: z.number().int().min(0).max(5).optional() }).strict().optional()
3778
+ }).strict().optional();
3779
+ const MessagesSchema = z.object({
3780
+ messagePrefix: z.string().optional(),
3781
+ responsePrefix: z.string().optional(),
3782
+ groupChat: GroupChatSchema,
3783
+ queue: QueueSchema,
3784
+ inbound: InboundDebounceSchema,
3785
+ ackReaction: z.string().optional(),
3786
+ ackReactionScope: z.enum([
3787
+ "group-mentions",
3788
+ "group-all",
3789
+ "direct",
3790
+ "all"
3791
+ ]).optional(),
3792
+ removeAckAfterReply: z.boolean().optional(),
3793
+ tts: TtsConfigSchema
3794
+ }).strict().optional();
3795
+ const CommandsSchema = z.object({
3796
+ native: NativeCommandsSettingSchema.optional().default("auto"),
3797
+ nativeSkills: NativeCommandsSettingSchema.optional().default("auto"),
3798
+ text: z.boolean().optional(),
3799
+ bash: z.boolean().optional(),
3800
+ bashForegroundMs: z.number().int().min(0).max(3e4).optional(),
3801
+ config: z.boolean().optional(),
3802
+ debug: z.boolean().optional(),
3803
+ restart: z.boolean().optional(),
3804
+ useAccessGroups: z.boolean().optional(),
3805
+ ownerAllowFrom: z.array(z.union([z.string(), z.number()])).optional()
3806
+ }).strict().optional().default({
3807
+ native: "auto",
3808
+ nativeSkills: "auto"
3809
+ });
3810
+
3811
+ //#endregion
3812
+ //#region src/config/zod-schema.ts
3813
+ const BrowserSnapshotDefaultsSchema = z.object({ mode: z.literal("efficient").optional() }).strict().optional();
3814
+ const NodeHostSchema = z.object({ browserProxy: z.object({
3815
+ enabled: z.boolean().optional(),
3816
+ allowProfiles: z.array(z.string()).optional()
3817
+ }).strict().optional() }).strict().optional();
3818
+ const MemoryQmdPathSchema = z.object({
3819
+ path: z.string(),
3820
+ name: z.string().optional(),
3821
+ pattern: z.string().optional()
3822
+ }).strict();
3823
+ const MemoryQmdSessionSchema = z.object({
3824
+ enabled: z.boolean().optional(),
3825
+ exportDir: z.string().optional(),
3826
+ retentionDays: z.number().int().nonnegative().optional()
3827
+ }).strict();
3828
+ const MemoryQmdUpdateSchema = z.object({
3829
+ interval: z.string().optional(),
3830
+ debounceMs: z.number().int().nonnegative().optional(),
3831
+ onBoot: z.boolean().optional(),
3832
+ waitForBootSync: z.boolean().optional(),
3833
+ embedInterval: z.string().optional(),
3834
+ commandTimeoutMs: z.number().int().nonnegative().optional(),
3835
+ updateTimeoutMs: z.number().int().nonnegative().optional(),
3836
+ embedTimeoutMs: z.number().int().nonnegative().optional()
3837
+ }).strict();
3838
+ const MemoryQmdLimitsSchema = z.object({
3839
+ maxResults: z.number().int().positive().optional(),
3840
+ maxSnippetChars: z.number().int().positive().optional(),
3841
+ maxInjectedChars: z.number().int().positive().optional(),
3842
+ timeoutMs: z.number().int().nonnegative().optional()
3843
+ }).strict();
3844
+ const MemoryQmdSchema = z.object({
3845
+ command: z.string().optional(),
3846
+ includeDefaultMemory: z.boolean().optional(),
3847
+ paths: z.array(MemoryQmdPathSchema).optional(),
3848
+ sessions: MemoryQmdSessionSchema.optional(),
3849
+ update: MemoryQmdUpdateSchema.optional(),
3850
+ limits: MemoryQmdLimitsSchema.optional(),
3851
+ scope: SessionSendPolicySchema.optional()
3852
+ }).strict();
3853
+ const MemorySchema = z.object({
3854
+ backend: z.union([z.literal("builtin"), z.literal("qmd")]).optional(),
3855
+ citations: z.union([
3856
+ z.literal("auto"),
3857
+ z.literal("on"),
3858
+ z.literal("off")
3859
+ ]).optional(),
3860
+ qmd: MemoryQmdSchema.optional()
3861
+ }).strict().optional();
3862
+ const OpenClawSchema = z.object({
3863
+ meta: z.object({
3864
+ lastTouchedVersion: z.string().optional(),
3865
+ lastTouchedAt: z.string().optional()
3866
+ }).strict().optional(),
3867
+ env: z.object({
3868
+ shellEnv: z.object({
3869
+ enabled: z.boolean().optional(),
3870
+ timeoutMs: z.number().int().nonnegative().optional()
3871
+ }).strict().optional(),
3872
+ vars: z.record(z.string(), z.string()).optional()
3873
+ }).catchall(z.string()).optional(),
3874
+ wizard: z.object({
3875
+ lastRunAt: z.string().optional(),
3876
+ lastRunVersion: z.string().optional(),
3877
+ lastRunCommit: z.string().optional(),
3878
+ lastRunCommand: z.string().optional(),
3879
+ lastRunMode: z.union([z.literal("local"), z.literal("remote")]).optional()
3880
+ }).strict().optional(),
3881
+ diagnostics: z.object({
3882
+ enabled: z.boolean().optional(),
3883
+ flags: z.array(z.string()).optional(),
3884
+ otel: z.object({
3885
+ enabled: z.boolean().optional(),
3886
+ endpoint: z.string().optional(),
3887
+ protocol: z.union([z.literal("http/protobuf"), z.literal("grpc")]).optional(),
3888
+ headers: z.record(z.string(), z.string()).optional(),
3889
+ serviceName: z.string().optional(),
3890
+ traces: z.boolean().optional(),
3891
+ metrics: z.boolean().optional(),
3892
+ logs: z.boolean().optional(),
3893
+ sampleRate: z.number().min(0).max(1).optional(),
3894
+ flushIntervalMs: z.number().int().nonnegative().optional()
3895
+ }).strict().optional(),
3896
+ cacheTrace: z.object({
3897
+ enabled: z.boolean().optional(),
3898
+ filePath: z.string().optional(),
3899
+ includeMessages: z.boolean().optional(),
3900
+ includePrompt: z.boolean().optional(),
3901
+ includeSystem: z.boolean().optional()
3902
+ }).strict().optional()
3903
+ }).strict().optional(),
3904
+ logging: z.object({
3905
+ level: z.union([
3906
+ z.literal("silent"),
3907
+ z.literal("fatal"),
3908
+ z.literal("error"),
3909
+ z.literal("warn"),
3910
+ z.literal("info"),
3911
+ z.literal("debug"),
3912
+ z.literal("trace")
3913
+ ]).optional(),
3914
+ file: z.string().optional(),
3915
+ consoleLevel: z.union([
3916
+ z.literal("silent"),
3917
+ z.literal("fatal"),
3918
+ z.literal("error"),
3919
+ z.literal("warn"),
3920
+ z.literal("info"),
3921
+ z.literal("debug"),
3922
+ z.literal("trace")
3923
+ ]).optional(),
3924
+ consoleStyle: z.union([
3925
+ z.literal("pretty"),
3926
+ z.literal("compact"),
3927
+ z.literal("json")
3928
+ ]).optional(),
3929
+ redactSensitive: z.union([z.literal("off"), z.literal("tools")]).optional(),
3930
+ redactPatterns: z.array(z.string()).optional()
3931
+ }).strict().optional(),
3932
+ update: z.object({
3933
+ channel: z.union([
3934
+ z.literal("stable"),
3935
+ z.literal("beta"),
3936
+ z.literal("dev")
3937
+ ]).optional(),
3938
+ checkOnStart: z.boolean().optional()
3939
+ }).strict().optional(),
3940
+ browser: z.object({
3941
+ enabled: z.boolean().optional(),
3942
+ evaluateEnabled: z.boolean().optional(),
3943
+ cdpUrl: z.string().optional(),
3944
+ remoteCdpTimeoutMs: z.number().int().nonnegative().optional(),
3945
+ remoteCdpHandshakeTimeoutMs: z.number().int().nonnegative().optional(),
3946
+ color: z.string().optional(),
3947
+ executablePath: z.string().optional(),
3948
+ headless: z.boolean().optional(),
3949
+ noSandbox: z.boolean().optional(),
3950
+ attachOnly: z.boolean().optional(),
3951
+ defaultProfile: z.string().optional(),
3952
+ snapshotDefaults: BrowserSnapshotDefaultsSchema,
3953
+ profiles: z.record(z.string().regex(/^[a-z0-9-]+$/, "Profile names must be alphanumeric with hyphens only"), z.object({
3954
+ cdpPort: z.number().int().min(1).max(65535).optional(),
3955
+ cdpUrl: z.string().optional(),
3956
+ driver: z.union([z.literal("clawd"), z.literal("extension")]).optional(),
3957
+ color: HexColorSchema
3958
+ }).strict().refine((value) => value.cdpPort || value.cdpUrl, { message: "Profile must set cdpPort or cdpUrl" })).optional()
3959
+ }).strict().optional(),
3960
+ ui: z.object({
3961
+ seamColor: HexColorSchema.optional(),
3962
+ assistant: z.object({
3963
+ name: z.string().max(50).optional(),
3964
+ avatar: z.string().max(200).optional()
3965
+ }).strict().optional()
3966
+ }).strict().optional(),
3967
+ auth: z.object({
3968
+ profiles: z.record(z.string(), z.object({
3969
+ provider: z.string(),
3970
+ mode: z.union([
3971
+ z.literal("api_key"),
3972
+ z.literal("oauth"),
3973
+ z.literal("token")
3974
+ ]),
3975
+ email: z.string().optional()
3976
+ }).strict()).optional(),
3977
+ order: z.record(z.string(), z.array(z.string())).optional(),
3978
+ cooldowns: z.object({
3979
+ billingBackoffHours: z.number().positive().optional(),
3980
+ billingBackoffHoursByProvider: z.record(z.string(), z.number().positive()).optional(),
3981
+ billingMaxHours: z.number().positive().optional(),
3982
+ failureWindowHours: z.number().positive().optional()
3983
+ }).strict().optional()
3984
+ }).strict().optional(),
3985
+ models: ModelsConfigSchema,
3986
+ nodeHost: NodeHostSchema,
3987
+ agents: AgentsSchema,
3988
+ tools: ToolsSchema,
3989
+ bindings: BindingsSchema,
3990
+ broadcast: BroadcastSchema,
3991
+ audio: AudioSchema,
3992
+ media: z.object({ preserveFilenames: z.boolean().optional() }).strict().optional(),
3993
+ messages: MessagesSchema,
3994
+ commands: CommandsSchema,
3995
+ approvals: ApprovalsSchema,
3996
+ session: SessionSchema,
3997
+ cron: z.object({
3998
+ enabled: z.boolean().optional(),
3999
+ store: z.string().optional(),
4000
+ maxConcurrentRuns: z.number().int().positive().optional()
4001
+ }).strict().optional(),
4002
+ hooks: z.object({
4003
+ enabled: z.boolean().optional(),
4004
+ path: z.string().optional(),
4005
+ token: z.string().optional(),
4006
+ maxBodyBytes: z.number().int().positive().optional(),
4007
+ presets: z.array(z.string()).optional(),
4008
+ transformsDir: z.string().optional(),
4009
+ mappings: z.array(HookMappingSchema).optional(),
4010
+ gmail: HooksGmailSchema,
4011
+ internal: InternalHooksSchema
4012
+ }).strict().optional(),
4013
+ web: z.object({
4014
+ enabled: z.boolean().optional(),
4015
+ heartbeatSeconds: z.number().int().positive().optional(),
4016
+ reconnect: z.object({
4017
+ initialMs: z.number().positive().optional(),
4018
+ maxMs: z.number().positive().optional(),
4019
+ factor: z.number().positive().optional(),
4020
+ jitter: z.number().min(0).max(1).optional(),
4021
+ maxAttempts: z.number().int().min(0).optional()
4022
+ }).strict().optional()
4023
+ }).strict().optional(),
4024
+ channels: ChannelsSchema,
4025
+ discovery: z.object({
4026
+ wideArea: z.object({ enabled: z.boolean().optional() }).strict().optional(),
4027
+ mdns: z.object({ mode: z.enum([
4028
+ "off",
4029
+ "minimal",
4030
+ "full"
4031
+ ]).optional() }).strict().optional()
4032
+ }).strict().optional(),
4033
+ canvasHost: z.object({
4034
+ enabled: z.boolean().optional(),
4035
+ root: z.string().optional(),
4036
+ port: z.number().int().positive().optional(),
4037
+ liveReload: z.boolean().optional()
4038
+ }).strict().optional(),
4039
+ talk: z.object({
4040
+ voiceId: z.string().optional(),
4041
+ voiceAliases: z.record(z.string(), z.string()).optional(),
4042
+ modelId: z.string().optional(),
4043
+ outputFormat: z.string().optional(),
4044
+ apiKey: z.string().optional(),
4045
+ interruptOnSpeech: z.boolean().optional()
4046
+ }).strict().optional(),
4047
+ gateway: z.object({
4048
+ port: z.number().int().positive().optional(),
4049
+ mode: z.union([z.literal("local"), z.literal("remote")]).optional(),
4050
+ bind: z.union([
4051
+ z.literal("auto"),
4052
+ z.literal("lan"),
4053
+ z.literal("loopback"),
4054
+ z.literal("custom"),
4055
+ z.literal("tailnet")
4056
+ ]).optional(),
4057
+ controlUi: z.object({
4058
+ enabled: z.boolean().optional(),
4059
+ basePath: z.string().optional(),
4060
+ root: z.string().optional(),
4061
+ allowedOrigins: z.array(z.string()).optional(),
4062
+ allowInsecureAuth: z.boolean().optional(),
4063
+ dangerouslyDisableDeviceAuth: z.boolean().optional()
4064
+ }).strict().optional(),
4065
+ auth: z.object({
4066
+ mode: z.union([z.literal("token"), z.literal("password")]).optional(),
4067
+ token: z.string().optional(),
4068
+ password: z.string().optional(),
4069
+ allowTailscale: z.boolean().optional()
4070
+ }).strict().optional(),
4071
+ trustedProxies: z.array(z.string()).optional(),
4072
+ tailscale: z.object({
4073
+ mode: z.union([
4074
+ z.literal("off"),
4075
+ z.literal("serve"),
4076
+ z.literal("funnel")
4077
+ ]).optional(),
4078
+ resetOnExit: z.boolean().optional()
4079
+ }).strict().optional(),
4080
+ remote: z.object({
4081
+ url: z.string().optional(),
4082
+ transport: z.union([z.literal("ssh"), z.literal("direct")]).optional(),
4083
+ token: z.string().optional(),
4084
+ password: z.string().optional(),
4085
+ tlsFingerprint: z.string().optional(),
4086
+ sshTarget: z.string().optional(),
4087
+ sshIdentity: z.string().optional()
4088
+ }).strict().optional(),
4089
+ reload: z.object({
4090
+ mode: z.union([
4091
+ z.literal("off"),
4092
+ z.literal("restart"),
4093
+ z.literal("hot"),
4094
+ z.literal("hybrid")
4095
+ ]).optional(),
4096
+ debounceMs: z.number().int().min(0).optional()
4097
+ }).strict().optional(),
4098
+ tls: z.object({
4099
+ enabled: z.boolean().optional(),
4100
+ autoGenerate: z.boolean().optional(),
4101
+ certPath: z.string().optional(),
4102
+ keyPath: z.string().optional(),
4103
+ caPath: z.string().optional()
4104
+ }).optional(),
4105
+ http: z.object({ endpoints: z.object({
4106
+ chatCompletions: z.object({ enabled: z.boolean().optional() }).strict().optional(),
4107
+ responses: z.object({
4108
+ enabled: z.boolean().optional(),
4109
+ maxBodyBytes: z.number().int().positive().optional(),
4110
+ files: z.object({
4111
+ allowUrl: z.boolean().optional(),
4112
+ allowedMimes: z.array(z.string()).optional(),
4113
+ maxBytes: z.number().int().positive().optional(),
4114
+ maxChars: z.number().int().positive().optional(),
4115
+ maxRedirects: z.number().int().nonnegative().optional(),
4116
+ timeoutMs: z.number().int().positive().optional(),
4117
+ pdf: z.object({
4118
+ maxPages: z.number().int().positive().optional(),
4119
+ maxPixels: z.number().int().positive().optional(),
4120
+ minTextChars: z.number().int().nonnegative().optional()
4121
+ }).strict().optional()
4122
+ }).strict().optional(),
4123
+ images: z.object({
4124
+ allowUrl: z.boolean().optional(),
4125
+ allowedMimes: z.array(z.string()).optional(),
4126
+ maxBytes: z.number().int().positive().optional(),
4127
+ maxRedirects: z.number().int().nonnegative().optional(),
4128
+ timeoutMs: z.number().int().positive().optional()
4129
+ }).strict().optional()
4130
+ }).strict().optional()
4131
+ }).strict().optional() }).strict().optional(),
4132
+ nodes: z.object({
4133
+ browser: z.object({
4134
+ mode: z.union([
4135
+ z.literal("auto"),
4136
+ z.literal("manual"),
4137
+ z.literal("off")
4138
+ ]).optional(),
4139
+ node: z.string().optional()
4140
+ }).strict().optional(),
4141
+ allowCommands: z.array(z.string()).optional(),
4142
+ denyCommands: z.array(z.string()).optional()
4143
+ }).strict().optional()
4144
+ }).strict().optional(),
4145
+ memory: MemorySchema,
4146
+ skills: z.object({
4147
+ allowBundled: z.array(z.string()).optional(),
4148
+ load: z.object({
4149
+ extraDirs: z.array(z.string()).optional(),
4150
+ watch: z.boolean().optional(),
4151
+ watchDebounceMs: z.number().int().min(0).optional()
4152
+ }).strict().optional(),
4153
+ install: z.object({
4154
+ preferBrew: z.boolean().optional(),
4155
+ nodeManager: z.union([
4156
+ z.literal("npm"),
4157
+ z.literal("pnpm"),
4158
+ z.literal("yarn"),
4159
+ z.literal("bun")
4160
+ ]).optional()
4161
+ }).strict().optional(),
4162
+ entries: z.record(z.string(), z.object({
4163
+ enabled: z.boolean().optional(),
4164
+ apiKey: z.string().optional(),
4165
+ env: z.record(z.string(), z.string()).optional(),
4166
+ config: z.record(z.string(), z.unknown()).optional()
4167
+ }).strict()).optional()
4168
+ }).strict().optional(),
4169
+ plugins: z.object({
4170
+ enabled: z.boolean().optional(),
4171
+ allow: z.array(z.string()).optional(),
4172
+ deny: z.array(z.string()).optional(),
4173
+ load: z.object({ paths: z.array(z.string()).optional() }).strict().optional(),
4174
+ slots: z.object({ memory: z.string().optional() }).strict().optional(),
4175
+ entries: z.record(z.string(), z.object({
4176
+ enabled: z.boolean().optional(),
4177
+ config: z.record(z.string(), z.unknown()).optional()
4178
+ }).strict()).optional(),
4179
+ installs: z.record(z.string(), z.object({
4180
+ source: z.union([
4181
+ z.literal("npm"),
4182
+ z.literal("archive"),
4183
+ z.literal("path")
4184
+ ]),
4185
+ spec: z.string().optional(),
4186
+ sourcePath: z.string().optional(),
4187
+ installPath: z.string().optional(),
4188
+ version: z.string().optional(),
4189
+ installedAt: z.string().optional()
4190
+ }).strict()).optional()
4191
+ }).strict().optional()
4192
+ }).strict().superRefine((cfg, ctx) => {
4193
+ const agents = cfg.agents?.list ?? [];
4194
+ if (agents.length === 0) return;
4195
+ const agentIds = new Set(agents.map((agent) => agent.id));
4196
+ const broadcast = cfg.broadcast;
4197
+ if (!broadcast) return;
4198
+ for (const [peerId, ids] of Object.entries(broadcast)) {
4199
+ if (peerId === "strategy") continue;
4200
+ if (!Array.isArray(ids)) continue;
4201
+ for (let idx = 0; idx < ids.length; idx += 1) {
4202
+ const agentId = ids[idx];
4203
+ if (!agentIds.has(agentId)) ctx.addIssue({
4204
+ code: z.ZodIssueCode.custom,
4205
+ path: [
4206
+ "broadcast",
4207
+ peerId,
4208
+ idx
4209
+ ],
4210
+ message: `Unknown agent id "${agentId}" (not in agents.list).`
4211
+ });
4212
+ }
4213
+ }
4214
+ });
4215
+
4216
+ //#endregion
4217
+ //#region src/config/validation.ts
4218
+ const AVATAR_SCHEME_RE = /^[a-z][a-z0-9+.-]*:/i;
4219
+ const AVATAR_DATA_RE = /^data:/i;
4220
+ const AVATAR_HTTP_RE = /^https?:\/\//i;
4221
+ const WINDOWS_ABS_RE = /^[a-zA-Z]:[\\/]/;
4222
+ function isWorkspaceAvatarPath(value, workspaceDir) {
4223
+ const workspaceRoot = path.resolve(workspaceDir);
4224
+ const resolved = path.resolve(workspaceRoot, value);
4225
+ const relative = path.relative(workspaceRoot, resolved);
4226
+ if (relative === "") return true;
4227
+ if (relative.startsWith("..")) return false;
4228
+ return !path.isAbsolute(relative);
4229
+ }
4230
+ function validateIdentityAvatar(config) {
4231
+ const agents = config.agents?.list;
4232
+ if (!Array.isArray(agents) || agents.length === 0) return [];
4233
+ const issues = [];
4234
+ for (const [index, entry] of agents.entries()) {
4235
+ if (!entry || typeof entry !== "object") continue;
4236
+ const avatarRaw = entry.identity?.avatar;
4237
+ if (typeof avatarRaw !== "string") continue;
4238
+ const avatar = avatarRaw.trim();
4239
+ if (!avatar) continue;
4240
+ if (AVATAR_DATA_RE.test(avatar) || AVATAR_HTTP_RE.test(avatar)) continue;
4241
+ if (avatar.startsWith("~")) {
4242
+ issues.push({
4243
+ path: `agents.list.${index}.identity.avatar`,
4244
+ message: "identity.avatar must be a workspace-relative path, http(s) URL, or data URI."
4245
+ });
4246
+ continue;
4247
+ }
4248
+ if (AVATAR_SCHEME_RE.test(avatar) && !WINDOWS_ABS_RE.test(avatar)) {
4249
+ issues.push({
4250
+ path: `agents.list.${index}.identity.avatar`,
4251
+ message: "identity.avatar must be a workspace-relative path, http(s) URL, or data URI."
4252
+ });
4253
+ continue;
4254
+ }
4255
+ if (!isWorkspaceAvatarPath(avatar, resolveAgentWorkspaceDir(config, entry.id ?? resolveDefaultAgentId(config)))) issues.push({
4256
+ path: `agents.list.${index}.identity.avatar`,
4257
+ message: "identity.avatar must stay within the agent workspace."
4258
+ });
4259
+ }
4260
+ return issues;
4261
+ }
4262
+ function validateConfigObject(raw) {
4263
+ const legacyIssues = findLegacyConfigIssues(raw);
4264
+ if (legacyIssues.length > 0) return {
4265
+ ok: false,
4266
+ issues: legacyIssues.map((iss) => ({
4267
+ path: iss.path,
4268
+ message: iss.message
4269
+ }))
4270
+ };
4271
+ const validated = OpenClawSchema.safeParse(raw);
4272
+ if (!validated.success) return {
4273
+ ok: false,
4274
+ issues: validated.error.issues.map((iss) => ({
4275
+ path: iss.path.join("."),
4276
+ message: iss.message
4277
+ }))
4278
+ };
4279
+ const duplicates = findDuplicateAgentDirs(validated.data);
4280
+ if (duplicates.length > 0) return {
4281
+ ok: false,
4282
+ issues: [{
4283
+ path: "agents.list",
4284
+ message: formatDuplicateAgentDirError(duplicates)
4285
+ }]
4286
+ };
4287
+ const avatarIssues = validateIdentityAvatar(validated.data);
4288
+ if (avatarIssues.length > 0) return {
4289
+ ok: false,
4290
+ issues: avatarIssues
4291
+ };
4292
+ return {
4293
+ ok: true,
4294
+ config: applyModelDefaults(applyAgentDefaults(applySessionDefaults(validated.data)))
4295
+ };
4296
+ }
4297
+ function isRecord(value) {
4298
+ return Boolean(value && typeof value === "object" && !Array.isArray(value));
4299
+ }
4300
+ function validateConfigObjectWithPlugins(raw) {
4301
+ const base = validateConfigObject(raw);
4302
+ if (!base.ok) return {
4303
+ ok: false,
4304
+ issues: base.issues,
4305
+ warnings: []
4306
+ };
4307
+ const config = base.config;
4308
+ const issues = [];
4309
+ const warnings = [];
4310
+ const pluginsConfig = config.plugins;
4311
+ const normalizedPlugins = normalizePluginsConfig(pluginsConfig);
4312
+ const registry = loadPluginManifestRegistry({
4313
+ config,
4314
+ workspaceDir: resolveAgentWorkspaceDir(config, resolveDefaultAgentId(config)) ?? void 0
4315
+ });
4316
+ const knownIds = new Set(registry.plugins.map((record) => record.id));
4317
+ for (const diag of registry.diagnostics) {
4318
+ let path = diag.pluginId ? `plugins.entries.${diag.pluginId}` : "plugins";
4319
+ if (!diag.pluginId && diag.message.includes("plugin path not found")) path = "plugins.load.paths";
4320
+ const message = `${diag.pluginId ? `plugin ${diag.pluginId}` : "plugin"}: ${diag.message}`;
4321
+ if (diag.level === "error") issues.push({
4322
+ path,
4323
+ message
4324
+ });
4325
+ else warnings.push({
4326
+ path,
4327
+ message
4328
+ });
4329
+ }
4330
+ const entries = pluginsConfig?.entries;
4331
+ if (entries && isRecord(entries)) {
4332
+ for (const pluginId of Object.keys(entries)) if (!knownIds.has(pluginId)) issues.push({
4333
+ path: `plugins.entries.${pluginId}`,
4334
+ message: `plugin not found: ${pluginId}`
4335
+ });
4336
+ }
4337
+ const allow = pluginsConfig?.allow ?? [];
4338
+ for (const pluginId of allow) {
4339
+ if (typeof pluginId !== "string" || !pluginId.trim()) continue;
4340
+ if (!knownIds.has(pluginId)) issues.push({
4341
+ path: "plugins.allow",
4342
+ message: `plugin not found: ${pluginId}`
4343
+ });
4344
+ }
4345
+ const deny = pluginsConfig?.deny ?? [];
4346
+ for (const pluginId of deny) {
4347
+ if (typeof pluginId !== "string" || !pluginId.trim()) continue;
4348
+ if (!knownIds.has(pluginId)) issues.push({
4349
+ path: "plugins.deny",
4350
+ message: `plugin not found: ${pluginId}`
4351
+ });
4352
+ }
4353
+ const memorySlot = normalizedPlugins.slots.memory;
4354
+ if (typeof memorySlot === "string" && memorySlot.trim() && !knownIds.has(memorySlot)) issues.push({
4355
+ path: "plugins.slots.memory",
4356
+ message: `plugin not found: ${memorySlot}`
4357
+ });
4358
+ const allowedChannels = new Set(["defaults", ...CHANNEL_IDS]);
4359
+ for (const record of registry.plugins) for (const channelId of record.channels) allowedChannels.add(channelId);
4360
+ if (config.channels && isRecord(config.channels)) for (const key of Object.keys(config.channels)) {
4361
+ const trimmed = key.trim();
4362
+ if (!trimmed) continue;
4363
+ if (!allowedChannels.has(trimmed)) issues.push({
4364
+ path: `channels.${trimmed}`,
4365
+ message: `unknown channel id: ${trimmed}`
4366
+ });
4367
+ }
4368
+ const heartbeatChannelIds = /* @__PURE__ */ new Set();
4369
+ for (const channelId of CHANNEL_IDS) heartbeatChannelIds.add(channelId.toLowerCase());
4370
+ for (const record of registry.plugins) for (const channelId of record.channels) {
4371
+ const trimmed = channelId.trim();
4372
+ if (trimmed) heartbeatChannelIds.add(trimmed.toLowerCase());
4373
+ }
4374
+ const validateHeartbeatTarget = (target, path) => {
4375
+ if (typeof target !== "string") return;
4376
+ const trimmed = target.trim();
4377
+ if (!trimmed) {
4378
+ issues.push({
4379
+ path,
4380
+ message: "heartbeat target must not be empty"
4381
+ });
4382
+ return;
4383
+ }
4384
+ const normalized = trimmed.toLowerCase();
4385
+ if (normalized === "last" || normalized === "none") return;
4386
+ if (normalizeChatChannelId(trimmed)) return;
4387
+ if (heartbeatChannelIds.has(normalized)) return;
4388
+ issues.push({
4389
+ path,
4390
+ message: `unknown heartbeat target: ${target}`
4391
+ });
4392
+ };
4393
+ validateHeartbeatTarget(config.agents?.defaults?.heartbeat?.target, "agents.defaults.heartbeat.target");
4394
+ if (Array.isArray(config.agents?.list)) for (const [index, entry] of config.agents.list.entries()) validateHeartbeatTarget(entry?.heartbeat?.target, `agents.list.${index}.heartbeat.target`);
4395
+ let selectedMemoryPluginId = null;
4396
+ const seenPlugins = /* @__PURE__ */ new Set();
4397
+ for (const record of registry.plugins) {
4398
+ const pluginId = record.id;
4399
+ if (seenPlugins.has(pluginId)) continue;
4400
+ seenPlugins.add(pluginId);
4401
+ const entry = normalizedPlugins.entries[pluginId];
4402
+ const entryHasConfig = Boolean(entry?.config);
4403
+ const enableState = resolveEnableState(pluginId, record.origin, normalizedPlugins);
4404
+ let enabled = enableState.enabled;
4405
+ let reason = enableState.reason;
4406
+ if (enabled) {
4407
+ const memoryDecision = resolveMemorySlotDecision({
4408
+ id: pluginId,
4409
+ kind: record.kind,
4410
+ slot: memorySlot,
4411
+ selectedId: selectedMemoryPluginId
4412
+ });
4413
+ if (!memoryDecision.enabled) {
4414
+ enabled = false;
4415
+ reason = memoryDecision.reason;
4416
+ }
4417
+ if (memoryDecision.selected && record.kind === "memory") selectedMemoryPluginId = pluginId;
4418
+ }
4419
+ if (enabled || entryHasConfig) if (record.configSchema) {
4420
+ const res = validateJsonSchemaValue({
4421
+ schema: record.configSchema,
4422
+ cacheKey: record.schemaCacheKey ?? record.manifestPath ?? pluginId,
4423
+ value: entry?.config ?? {}
4424
+ });
4425
+ if (!res.ok) for (const error of res.errors) issues.push({
4426
+ path: `plugins.entries.${pluginId}.config`,
4427
+ message: `invalid config: ${error}`
4428
+ });
4429
+ } else issues.push({
4430
+ path: `plugins.entries.${pluginId}`,
4431
+ message: `plugin schema missing for ${pluginId}`
4432
+ });
4433
+ if (!enabled && entryHasConfig) warnings.push({
4434
+ path: `plugins.entries.${pluginId}`,
4435
+ message: `plugin disabled (${reason ?? "disabled"}) but config is present`
4436
+ });
4437
+ }
4438
+ if (issues.length > 0) return {
4439
+ ok: false,
4440
+ issues,
4441
+ warnings
4442
+ };
4443
+ return {
4444
+ ok: true,
4445
+ config,
4446
+ warnings
4447
+ };
4448
+ }
4449
+
4450
+ //#endregion
4451
+ //#region src/config/version.ts
4452
+ const VERSION_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:-(\d+))?/;
4453
+ function parseOpenClawVersion(raw) {
4454
+ if (!raw) return null;
4455
+ const match = raw.trim().match(VERSION_RE);
4456
+ if (!match) return null;
4457
+ const [, major, minor, patch, revision] = match;
4458
+ return {
4459
+ major: Number.parseInt(major, 10),
4460
+ minor: Number.parseInt(minor, 10),
4461
+ patch: Number.parseInt(patch, 10),
4462
+ revision: revision ? Number.parseInt(revision, 10) : 0
4463
+ };
4464
+ }
4465
+ function compareOpenClawVersions(a, b) {
4466
+ const parsedA = parseOpenClawVersion(a);
4467
+ const parsedB = parseOpenClawVersion(b);
4468
+ if (!parsedA || !parsedB) return null;
4469
+ if (parsedA.major !== parsedB.major) return parsedA.major < parsedB.major ? -1 : 1;
4470
+ if (parsedA.minor !== parsedB.minor) return parsedA.minor < parsedB.minor ? -1 : 1;
4471
+ if (parsedA.patch !== parsedB.patch) return parsedA.patch < parsedB.patch ? -1 : 1;
4472
+ if (parsedA.revision !== parsedB.revision) return parsedA.revision < parsedB.revision ? -1 : 1;
4473
+ return 0;
4474
+ }
4475
+
4476
+ //#endregion
4477
+ //#region src/config/io.ts
4478
+ const SHELL_ENV_EXPECTED_KEYS = [
4479
+ "OPENAI_API_KEY",
4480
+ "ANTHROPIC_API_KEY",
4481
+ "ANTHROPIC_OAUTH_TOKEN",
4482
+ "GEMINI_API_KEY",
4483
+ "ZAI_API_KEY",
4484
+ "OPENROUTER_API_KEY",
4485
+ "AI_GATEWAY_API_KEY",
4486
+ "MINIMAX_API_KEY",
4487
+ "SYNTHETIC_API_KEY",
4488
+ "ELEVENLABS_API_KEY",
4489
+ "TELEGRAM_BOT_TOKEN",
4490
+ "DISCORD_BOT_TOKEN",
4491
+ "SLACK_BOT_TOKEN",
4492
+ "SLACK_APP_TOKEN",
4493
+ "OPENCLAW_GATEWAY_TOKEN",
4494
+ "OPENCLAW_GATEWAY_PASSWORD"
4495
+ ];
4496
+ const CONFIG_BACKUP_COUNT = 5;
4497
+ const loggedInvalidConfigs = /* @__PURE__ */ new Set();
4498
+ function hashConfigRaw(raw) {
4499
+ return crypto.createHash("sha256").update(raw ?? "").digest("hex");
4500
+ }
4501
+ function resolveConfigSnapshotHash(snapshot) {
4502
+ if (typeof snapshot.hash === "string") {
4503
+ const trimmed = snapshot.hash.trim();
4504
+ if (trimmed) return trimmed;
4505
+ }
4506
+ if (typeof snapshot.raw !== "string") return null;
4507
+ return hashConfigRaw(snapshot.raw);
4508
+ }
4509
+ function coerceConfig(value) {
4510
+ if (!value || typeof value !== "object" || Array.isArray(value)) return {};
4511
+ return value;
4512
+ }
4513
+ async function rotateConfigBackups(configPath, ioFs) {
4514
+ if (CONFIG_BACKUP_COUNT <= 1) return;
4515
+ const backupBase = `${configPath}.bak`;
4516
+ const maxIndex = CONFIG_BACKUP_COUNT - 1;
4517
+ await ioFs.unlink(`${backupBase}.${maxIndex}`).catch(() => {});
4518
+ for (let index = maxIndex - 1; index >= 1; index -= 1) await ioFs.rename(`${backupBase}.${index}`, `${backupBase}.${index + 1}`).catch(() => {});
4519
+ await ioFs.rename(backupBase, `${backupBase}.1`).catch(() => {});
4520
+ }
4521
+ function warnOnConfigMiskeys(raw, logger) {
4522
+ if (!raw || typeof raw !== "object") return;
4523
+ const gateway = raw.gateway;
4524
+ if (!gateway || typeof gateway !== "object") return;
4525
+ if ("token" in gateway) logger.warn("Config uses \"gateway.token\". This key is ignored; use \"gateway.auth.token\" instead.");
4526
+ }
4527
+ function stampConfigVersion(cfg) {
4528
+ const now = (/* @__PURE__ */ new Date()).toISOString();
4529
+ return {
4530
+ ...cfg,
4531
+ meta: {
4532
+ ...cfg.meta,
4533
+ lastTouchedVersion: VERSION,
4534
+ lastTouchedAt: now
4535
+ }
4536
+ };
4537
+ }
4538
+ function warnIfConfigFromFuture(cfg, logger) {
4539
+ const touched = cfg.meta?.lastTouchedVersion;
4540
+ if (!touched) return;
4541
+ const cmp = compareOpenClawVersions(VERSION, touched);
4542
+ if (cmp === null) return;
4543
+ if (cmp < 0) logger.warn(`Config was last written by a newer OpenClaw (${touched}); current version is ${VERSION}.`);
4544
+ }
4545
+ function applyConfigEnv(cfg, env) {
4546
+ const entries = collectConfigEnvVars(cfg);
4547
+ for (const [key, value] of Object.entries(entries)) {
4548
+ if (env[key]?.trim()) continue;
4549
+ env[key] = value;
4550
+ }
4551
+ }
4552
+ function resolveConfigPathForDeps(deps) {
4553
+ if (deps.configPath) return deps.configPath;
4554
+ return resolveConfigPath(deps.env, resolveStateDir(deps.env, deps.homedir));
4555
+ }
4556
+ function normalizeDeps(overrides = {}) {
4557
+ return {
4558
+ fs: overrides.fs ?? fs,
4559
+ json5: overrides.json5 ?? JSON5,
4560
+ env: overrides.env ?? process.env,
4561
+ homedir: overrides.homedir ?? os.homedir,
4562
+ configPath: overrides.configPath ?? "",
4563
+ logger: overrides.logger ?? console
4564
+ };
4565
+ }
4566
+ function parseConfigJson5(raw, json5 = JSON5) {
4567
+ try {
4568
+ return {
4569
+ ok: true,
4570
+ parsed: json5.parse(raw)
4571
+ };
4572
+ } catch (err) {
4573
+ return {
4574
+ ok: false,
4575
+ error: String(err)
4576
+ };
4577
+ }
4578
+ }
4579
+ function createConfigIO(overrides = {}) {
4580
+ const deps = normalizeDeps(overrides);
4581
+ const requestedConfigPath = resolveConfigPathForDeps(deps);
4582
+ const configPath = (deps.configPath ? [requestedConfigPath] : resolveDefaultConfigCandidates(deps.env, deps.homedir)).find((candidate) => deps.fs.existsSync(candidate)) ?? requestedConfigPath;
4583
+ function loadConfig() {
4584
+ try {
4585
+ if (!deps.fs.existsSync(configPath)) {
4586
+ if (shouldEnableShellEnvFallback(deps.env) && !shouldDeferShellEnvFallback(deps.env)) loadShellEnvFallback({
4587
+ enabled: true,
4588
+ env: deps.env,
4589
+ expectedKeys: SHELL_ENV_EXPECTED_KEYS,
4590
+ logger: deps.logger,
4591
+ timeoutMs: resolveShellEnvFallbackTimeoutMs(deps.env)
4592
+ });
4593
+ return {};
4594
+ }
4595
+ const raw = deps.fs.readFileSync(configPath, "utf-8");
4596
+ const resolved = resolveConfigIncludes(deps.json5.parse(raw), configPath, {
4597
+ readFile: (p) => deps.fs.readFileSync(p, "utf-8"),
4598
+ parseJson: (raw) => deps.json5.parse(raw)
4599
+ });
4600
+ if (resolved && typeof resolved === "object" && "env" in resolved) applyConfigEnv(resolved, deps.env);
4601
+ const resolvedConfig = resolveConfigEnvVars(resolved, deps.env);
4602
+ warnOnConfigMiskeys(resolvedConfig, deps.logger);
4603
+ if (typeof resolvedConfig !== "object" || resolvedConfig === null) return {};
4604
+ const preValidationDuplicates = findDuplicateAgentDirs(resolvedConfig, {
4605
+ env: deps.env,
4606
+ homedir: deps.homedir
4607
+ });
4608
+ if (preValidationDuplicates.length > 0) throw new DuplicateAgentDirError(preValidationDuplicates);
4609
+ const validated = validateConfigObjectWithPlugins(resolvedConfig);
4610
+ if (!validated.ok) {
4611
+ const details = validated.issues.map((iss) => `- ${iss.path || "<root>"}: ${iss.message}`).join("\n");
4612
+ if (!loggedInvalidConfigs.has(configPath)) {
4613
+ loggedInvalidConfigs.add(configPath);
4614
+ deps.logger.error(`Invalid config at ${configPath}:\\n${details}`);
4615
+ }
4616
+ const error = /* @__PURE__ */ new Error("Invalid config");
4617
+ error.code = "INVALID_CONFIG";
4618
+ error.details = details;
4619
+ throw error;
4620
+ }
4621
+ if (validated.warnings.length > 0) {
4622
+ const details = validated.warnings.map((iss) => `- ${iss.path || "<root>"}: ${iss.message}`).join("\n");
4623
+ deps.logger.warn(`Config warnings:\\n${details}`);
4624
+ }
4625
+ warnIfConfigFromFuture(validated.config, deps.logger);
4626
+ const cfg = applyModelDefaults(applyCompactionDefaults(applyContextPruningDefaults(applyAgentDefaults(applySessionDefaults(applyLoggingDefaults(applyMessageDefaults(validated.config)))))));
4627
+ normalizeConfigPaths(cfg);
4628
+ const duplicates = findDuplicateAgentDirs(cfg, {
4629
+ env: deps.env,
4630
+ homedir: deps.homedir
4631
+ });
4632
+ if (duplicates.length > 0) throw new DuplicateAgentDirError(duplicates);
4633
+ applyConfigEnv(cfg, deps.env);
4634
+ if ((shouldEnableShellEnvFallback(deps.env) || cfg.env?.shellEnv?.enabled === true) && !shouldDeferShellEnvFallback(deps.env)) loadShellEnvFallback({
4635
+ enabled: true,
4636
+ env: deps.env,
4637
+ expectedKeys: SHELL_ENV_EXPECTED_KEYS,
4638
+ logger: deps.logger,
4639
+ timeoutMs: cfg.env?.shellEnv?.timeoutMs ?? resolveShellEnvFallbackTimeoutMs(deps.env)
4640
+ });
4641
+ return applyConfigOverrides(cfg);
4642
+ } catch (err) {
4643
+ if (err instanceof DuplicateAgentDirError) {
4644
+ deps.logger.error(err.message);
4645
+ throw err;
4646
+ }
4647
+ if (err?.code === "INVALID_CONFIG") return {};
4648
+ deps.logger.error(`Failed to read config at ${configPath}`, err);
4649
+ return {};
4650
+ }
4651
+ }
4652
+ async function readConfigFileSnapshot() {
4653
+ if (!deps.fs.existsSync(configPath)) {
4654
+ const hash = hashConfigRaw(null);
4655
+ return {
4656
+ path: configPath,
4657
+ exists: false,
4658
+ raw: null,
4659
+ parsed: {},
4660
+ valid: true,
4661
+ config: applyTalkApiKey(applyModelDefaults(applyCompactionDefaults(applyContextPruningDefaults(applyAgentDefaults(applySessionDefaults(applyMessageDefaults({}))))))),
4662
+ hash,
4663
+ issues: [],
4664
+ warnings: [],
4665
+ legacyIssues: []
4666
+ };
4667
+ }
4668
+ try {
4669
+ const raw = deps.fs.readFileSync(configPath, "utf-8");
4670
+ const hash = hashConfigRaw(raw);
4671
+ const parsedRes = parseConfigJson5(raw, deps.json5);
4672
+ if (!parsedRes.ok) return {
4673
+ path: configPath,
4674
+ exists: true,
4675
+ raw,
4676
+ parsed: {},
4677
+ valid: false,
4678
+ config: {},
4679
+ hash,
4680
+ issues: [{
4681
+ path: "",
4682
+ message: `JSON5 parse failed: ${parsedRes.error}`
4683
+ }],
4684
+ warnings: [],
4685
+ legacyIssues: []
4686
+ };
4687
+ let resolved;
4688
+ try {
4689
+ resolved = resolveConfigIncludes(parsedRes.parsed, configPath, {
4690
+ readFile: (p) => deps.fs.readFileSync(p, "utf-8"),
4691
+ parseJson: (raw) => deps.json5.parse(raw)
4692
+ });
4693
+ } catch (err) {
4694
+ const message = err instanceof ConfigIncludeError ? err.message : `Include resolution failed: ${String(err)}`;
4695
+ return {
4696
+ path: configPath,
4697
+ exists: true,
4698
+ raw,
4699
+ parsed: parsedRes.parsed,
4700
+ valid: false,
4701
+ config: coerceConfig(parsedRes.parsed),
4702
+ hash,
4703
+ issues: [{
4704
+ path: "",
4705
+ message
4706
+ }],
4707
+ warnings: [],
4708
+ legacyIssues: []
4709
+ };
4710
+ }
4711
+ if (resolved && typeof resolved === "object" && "env" in resolved) applyConfigEnv(resolved, deps.env);
4712
+ let substituted;
4713
+ try {
4714
+ substituted = resolveConfigEnvVars(resolved, deps.env);
4715
+ } catch (err) {
4716
+ const message = err instanceof MissingEnvVarError ? err.message : `Env var substitution failed: ${String(err)}`;
4717
+ return {
4718
+ path: configPath,
4719
+ exists: true,
4720
+ raw,
4721
+ parsed: parsedRes.parsed,
4722
+ valid: false,
4723
+ config: coerceConfig(resolved),
4724
+ hash,
4725
+ issues: [{
4726
+ path: "",
4727
+ message
4728
+ }],
4729
+ warnings: [],
4730
+ legacyIssues: []
4731
+ };
4732
+ }
4733
+ const resolvedConfigRaw = substituted;
4734
+ const legacyIssues = findLegacyConfigIssues(resolvedConfigRaw);
4735
+ const validated = validateConfigObjectWithPlugins(resolvedConfigRaw);
4736
+ if (!validated.ok) return {
4737
+ path: configPath,
4738
+ exists: true,
4739
+ raw,
4740
+ parsed: parsedRes.parsed,
4741
+ valid: false,
4742
+ config: coerceConfig(resolvedConfigRaw),
4743
+ hash,
4744
+ issues: validated.issues,
4745
+ warnings: validated.warnings,
4746
+ legacyIssues
4747
+ };
4748
+ warnIfConfigFromFuture(validated.config, deps.logger);
4749
+ return {
4750
+ path: configPath,
4751
+ exists: true,
4752
+ raw,
4753
+ parsed: parsedRes.parsed,
4754
+ valid: true,
4755
+ config: normalizeConfigPaths(applyTalkApiKey(applyModelDefaults(applyAgentDefaults(applySessionDefaults(applyLoggingDefaults(applyMessageDefaults(validated.config))))))),
4756
+ hash,
4757
+ issues: [],
4758
+ warnings: validated.warnings,
4759
+ legacyIssues
4760
+ };
4761
+ } catch (err) {
4762
+ return {
4763
+ path: configPath,
4764
+ exists: true,
4765
+ raw: null,
4766
+ parsed: {},
4767
+ valid: false,
4768
+ config: {},
4769
+ hash: hashConfigRaw(null),
4770
+ issues: [{
4771
+ path: "",
4772
+ message: `read failed: ${String(err)}`
4773
+ }],
4774
+ warnings: [],
4775
+ legacyIssues: []
4776
+ };
4777
+ }
4778
+ }
4779
+ async function writeConfigFile(cfg) {
4780
+ clearConfigCache();
4781
+ const validated = validateConfigObjectWithPlugins(cfg);
4782
+ if (!validated.ok) {
4783
+ const issue = validated.issues[0];
4784
+ const pathLabel = issue?.path ? issue.path : "<root>";
4785
+ throw new Error(`Config validation failed: ${pathLabel}: ${issue?.message ?? "invalid"}`);
4786
+ }
4787
+ if (validated.warnings.length > 0) {
4788
+ const details = validated.warnings.map((warning) => `- ${warning.path}: ${warning.message}`).join("\n");
4789
+ deps.logger.warn(`Config warnings:\n${details}`);
4790
+ }
4791
+ const dir = path.dirname(configPath);
4792
+ await deps.fs.promises.mkdir(dir, {
4793
+ recursive: true,
4794
+ mode: 448
4795
+ });
4796
+ const json = JSON.stringify(applyModelDefaults(stampConfigVersion(cfg)), null, 2).trimEnd().concat("\n");
4797
+ const tmp = path.join(dir, `${path.basename(configPath)}.${process.pid}.${crypto.randomUUID()}.tmp`);
4798
+ await deps.fs.promises.writeFile(tmp, json, {
4799
+ encoding: "utf-8",
4800
+ mode: 384
4801
+ });
4802
+ if (deps.fs.existsSync(configPath)) {
4803
+ await rotateConfigBackups(configPath, deps.fs.promises);
4804
+ await deps.fs.promises.copyFile(configPath, `${configPath}.bak`).catch(() => {});
4805
+ }
4806
+ try {
4807
+ await deps.fs.promises.rename(tmp, configPath);
4808
+ } catch (err) {
4809
+ const code = err.code;
4810
+ if (code === "EPERM" || code === "EEXIST") {
4811
+ await deps.fs.promises.copyFile(tmp, configPath);
4812
+ await deps.fs.promises.chmod(configPath, 384).catch(() => {});
4813
+ await deps.fs.promises.unlink(tmp).catch(() => {});
4814
+ return;
4815
+ }
4816
+ await deps.fs.promises.unlink(tmp).catch(() => {});
4817
+ throw err;
4818
+ }
4819
+ }
4820
+ return {
4821
+ configPath,
4822
+ loadConfig,
4823
+ readConfigFileSnapshot,
4824
+ writeConfigFile
4825
+ };
4826
+ }
4827
+ const DEFAULT_CONFIG_CACHE_MS = 200;
4828
+ let configCache = null;
4829
+ function resolveConfigCacheMs(env) {
4830
+ const raw = env.OPENCLAW_CONFIG_CACHE_MS?.trim();
4831
+ if (raw === "" || raw === "0") return 0;
4832
+ if (!raw) return DEFAULT_CONFIG_CACHE_MS;
4833
+ const parsed = Number.parseInt(raw, 10);
4834
+ if (!Number.isFinite(parsed)) return DEFAULT_CONFIG_CACHE_MS;
4835
+ return Math.max(0, parsed);
4836
+ }
4837
+ function shouldUseConfigCache(env) {
4838
+ if (env.OPENCLAW_DISABLE_CONFIG_CACHE?.trim()) return false;
4839
+ return resolveConfigCacheMs(env) > 0;
4840
+ }
4841
+ function clearConfigCache() {
4842
+ configCache = null;
4843
+ }
4844
+ function loadConfig() {
4845
+ const io = createConfigIO();
4846
+ const configPath = io.configPath;
4847
+ const now = Date.now();
4848
+ if (shouldUseConfigCache(process.env)) {
4849
+ const cached = configCache;
4850
+ if (cached && cached.configPath === configPath && cached.expiresAt > now) return cached.config;
4851
+ }
4852
+ const config = io.loadConfig();
4853
+ if (shouldUseConfigCache(process.env)) {
4854
+ const cacheMs = resolveConfigCacheMs(process.env);
4855
+ if (cacheMs > 0) configCache = {
4856
+ configPath,
4857
+ expiresAt: now + cacheMs,
4858
+ config
4859
+ };
4860
+ }
4861
+ return config;
4862
+ }
4863
+ async function readConfigFileSnapshot() {
4864
+ return await createConfigIO().readConfigFileSnapshot();
4865
+ }
4866
+ async function writeConfigFile(cfg) {
4867
+ clearConfigCache();
4868
+ await createConfigIO().writeConfigFile(cfg);
4869
+ }
4870
+
4871
+ //#endregion
4872
+ //#region src/config/legacy-migrate.ts
4873
+ function migrateLegacyConfig(raw) {
4874
+ const { next, changes } = applyLegacyMigrations(raw);
4875
+ if (!next) return {
4876
+ config: null,
4877
+ changes: []
4878
+ };
4879
+ const validated = validateConfigObjectWithPlugins(next);
4880
+ if (!validated.ok) {
4881
+ changes.push("Migration applied, but config still invalid; fix remaining issues manually.");
4882
+ return {
4883
+ config: null,
4884
+ changes
4885
+ };
4886
+ }
4887
+ return {
4888
+ config: validated.config,
4889
+ changes
4890
+ };
4891
+ }
4892
+
4893
+ //#endregion
4894
+ //#region src/config/config.ts
4895
+ var config_exports = /* @__PURE__ */ __exportAll({
4896
+ CONFIG_PATH: () => CONFIG_PATH,
4897
+ DEFAULT_GATEWAY_PORT: () => DEFAULT_GATEWAY_PORT,
4898
+ STATE_DIR: () => STATE_DIR,
4899
+ applyConfigOverrides: () => applyConfigOverrides,
4900
+ getConfigOverrides: () => getConfigOverrides,
4901
+ isNixMode: () => isNixMode,
4902
+ loadConfig: () => loadConfig,
4903
+ resetConfigOverrides: () => resetConfigOverrides,
4904
+ resolveCanonicalConfigPath: () => resolveCanonicalConfigPath,
4905
+ resolveConfigPath: () => resolveConfigPath,
4906
+ resolveConfigPathCandidate: () => resolveConfigPathCandidate,
4907
+ resolveDefaultConfigCandidates: () => resolveDefaultConfigCandidates,
4908
+ resolveGatewayLockDir: () => resolveGatewayLockDir,
4909
+ resolveGatewayPort: () => resolveGatewayPort,
4910
+ resolveIsNixMode: () => resolveIsNixMode,
4911
+ resolveLegacyStateDirs: () => resolveLegacyStateDirs,
4912
+ resolveNewStateDir: () => resolveNewStateDir,
4913
+ resolveOAuthDir: () => resolveOAuthDir,
4914
+ resolveOAuthPath: () => resolveOAuthPath,
4915
+ resolveStateDir: () => resolveStateDir,
4916
+ setConfigOverride: () => setConfigOverride,
4917
+ unsetConfigOverride: () => unsetConfigOverride
4918
+ });
4919
+
4920
+ //#endregion
4921
+ export { resolveSubagentMaxConcurrent as A, setConfigValueAtPath as C, MAX_INCLUDE_DEPTH as D, INCLUDE_KEY as E, collectConfigEnvVars as O, parseConfigPath as S, applyLegacyMigrations as T, getConfigOverrides as _, parseConfigJson5 as a, unsetConfigOverride as b, writeConfigFile as c, TELEGRAM_COMMAND_NAME_PATTERN as d, normalizeTelegramCommandName as f, validateJsonSchemaValue as g, parseDurationMs as h, loadConfig as i, VERSION as j, resolveAgentMaxConcurrent as k, validateConfigObjectWithPlugins as l, isSafeExecutableValue as m, migrateLegacyConfig as n, readConfigFileSnapshot as o, resolveTelegramCustomCommands as p, createConfigIO as r, resolveConfigSnapshotHash as s, config_exports as t, OpenClawSchema as u, resetConfigOverrides as v, unsetConfigValueAtPath as w, getConfigValueAtPath as x, setConfigOverride as y };