synurex 2026.2.19-1

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 (1944) hide show
  1. package/CHANGELOG.md +1594 -0
  2. package/LICENSE +21 -0
  3. package/README-header.png +0 -0
  4. package/README.md +547 -0
  5. package/THIRD_PARTY_LICENSES.txt +27 -0
  6. package/assets/avatar-placeholder.svg +19 -0
  7. package/assets/chrome-extension/README.md +22 -0
  8. package/assets/chrome-extension/background.js +438 -0
  9. package/assets/chrome-extension/icons/icon128.png +0 -0
  10. package/assets/chrome-extension/icons/icon16.png +0 -0
  11. package/assets/chrome-extension/icons/icon32.png +0 -0
  12. package/assets/chrome-extension/icons/icon48.png +0 -0
  13. package/assets/chrome-extension/manifest.json +25 -0
  14. package/assets/chrome-extension/options.html +196 -0
  15. package/assets/chrome-extension/options.js +59 -0
  16. package/assets/dmg-background-small.png +0 -0
  17. package/assets/dmg-background.png +0 -0
  18. package/dist/Synurex-root-CbEdPwLE.js +84 -0
  19. package/dist/Synurex-root-CwTH98Xq.js +84 -0
  20. package/dist/accounts-B6AkTILW.js +250 -0
  21. package/dist/accounts-BqN2SY0Z.js +251 -0
  22. package/dist/acp-cli-C1jHGRAm.js +926 -0
  23. package/dist/acp-cli-C3a9o7M2.js +923 -0
  24. package/dist/agent-9DtpfYJk.js +704 -0
  25. package/dist/agent-N2Qtra36.js +704 -0
  26. package/dist/agent-scope-CRRhJ7Hf.js +370 -0
  27. package/dist/agent-scope-CpSMNwey.js +611 -0
  28. package/dist/agent-scope-DNmzkYn4.js +370 -0
  29. package/dist/archive-Dy3Ezb-5.js +85 -0
  30. package/dist/archive-ccN9aDgq.js +85 -0
  31. package/dist/audit--oGM5x0J.js +1853 -0
  32. package/dist/audit-CM8pyctg.js +1853 -0
  33. package/dist/auth-3NYeRZYb.js +192 -0
  34. package/dist/auth-CVOB8Q9A.js +192 -0
  35. package/dist/auth-health-BSF-YNSl.js +149 -0
  36. package/dist/auth-health-BrChJQW-.js +149 -0
  37. package/dist/auth-profiles-xwZAMwdh.js +2981 -0
  38. package/dist/boolean-BgXe2hyu.js +30 -0
  39. package/dist/brew-CAcErcKz.js +46 -0
  40. package/dist/brew-CcZV0dSS.js +46 -0
  41. package/dist/call-BJsfB_NC.js +280 -0
  42. package/dist/call-mnjMMyVJ.js +280 -0
  43. package/dist/channel-options-BXpm2xHl.js +32 -0
  44. package/dist/channel-options-Bjh17Z08.js +62 -0
  45. package/dist/channel-selection-D2iDbzGy.js +51 -0
  46. package/dist/channel-selection-i-6yBKAk.js +51 -0
  47. package/dist/channel-summary-Cw9cmi4M.js +1216 -0
  48. package/dist/channel-summary-D7joKboS.js +1216 -0
  49. package/dist/channels-cli-8HUWD1_p.js +1415 -0
  50. package/dist/channels-cli-DFia3kGl.js +1413 -0
  51. package/dist/channels-status-issues-CT6Q1t1h.js +18 -0
  52. package/dist/channels-status-issues-CgVNTMMz.js +18 -0
  53. package/dist/chrome-CXlGlG3I.js +1953 -0
  54. package/dist/chrome-D0V3Ybil.js +1973 -0
  55. package/dist/clack-prompter-B9yLhyOm.js +92 -0
  56. package/dist/clack-prompter-C7J7X7j7.js +92 -0
  57. package/dist/cli-1b35n5Cc.js +86 -0
  58. package/dist/cli-BYL7Dz_4.js +89 -0
  59. package/dist/cli-utils-BkRQdAoC.js +43 -0
  60. package/dist/cli-utils-DzrdzskQ.js +43 -0
  61. package/dist/client-atZzP6kK.js +1814 -0
  62. package/dist/command-format-CEnDvS9q.js +56 -0
  63. package/dist/command-format-DUskR3Ej.js +42 -0
  64. package/dist/command-format-rFzrPj6c.js +56 -0
  65. package/dist/command-options-BnW-e302.js +33 -0
  66. package/dist/commands-U_88HsqX.js +230 -0
  67. package/dist/completion-cli-Bh3ds9Rv.js +773 -0
  68. package/dist/completion-cli-BhVl7J3C.js +434 -0
  69. package/dist/config-AFzxllYx.js +4924 -0
  70. package/dist/config-BBxxzNm-.js +4923 -0
  71. package/dist/config-UB10lGn3.js +5664 -0
  72. package/dist/config-guard-BCvAEaxA.js +5484 -0
  73. package/dist/configure-0W-OLHK1.js +895 -0
  74. package/dist/configure-D4ci8KU6.js +896 -0
  75. package/dist/constants-Cf-Zsiqd.js +65 -0
  76. package/dist/constants-CpnpJcmu.js +65 -0
  77. package/dist/control-service-BLzGkUMf.js +61 -0
  78. package/dist/control-service-DpyCNhOa.js +61 -0
  79. package/dist/cron-cli-2W0wnKNI.js +457 -0
  80. package/dist/cron-cli-BGc0ZmXl.js +454 -0
  81. package/dist/daemon-cli-C4IIRXZr.js +758 -0
  82. package/dist/daemon-cli-RFrEzOyc.js +757 -0
  83. package/dist/daemon-runtime-BlKOqOPH.js +517 -0
  84. package/dist/daemon-runtime-CRdmLdkD.js +517 -0
  85. package/dist/deliver-B0C5m0kU.js +2587 -0
  86. package/dist/deliver-BUV-sfaF.js +2557 -0
  87. package/dist/deliver-CQQ0e2eM.js +2587 -0
  88. package/dist/deps-D1eiWUgD.js +27 -0
  89. package/dist/deps-DgFrcXzw.js +27 -0
  90. package/dist/devices-cli-CUYqlUBU.js +207 -0
  91. package/dist/devices-cli-De1Q_0ob.js +204 -0
  92. package/dist/directory-cli-DYkFHmO6.js +244 -0
  93. package/dist/directory-cli-DoquUzqm.js +247 -0
  94. package/dist/dispatcher-BLeixzBZ.js +160 -0
  95. package/dist/dns-cli-C5dXU6Nk.js +198 -0
  96. package/dist/dns-cli-rkR0HJpi.js +201 -0
  97. package/dist/docs-cli-CqtgkhfC.js +161 -0
  98. package/dist/docs-cli-DrFTuzUe.js +159 -0
  99. package/dist/doctor-Cakg6jea.js +2577 -0
  100. package/dist/doctor-Cuk5zryG.js +2579 -0
  101. package/dist/entry.js +1336 -0
  102. package/dist/env-DgIs6BZg.js +32 -0
  103. package/dist/errors-C8t2PjW_.js +1952 -0
  104. package/dist/exec-B8JKbXKW.js +246 -0
  105. package/dist/exec-Dloa-d0d.js +246 -0
  106. package/dist/exec-EqLC5sqa.js +1103 -0
  107. package/dist/exec-approvals-B-sykLIC.js +1043 -0
  108. package/dist/exec-approvals-Ff_p0CYa.js +1043 -0
  109. package/dist/exec-approvals-cli-CfSTGR7F.js +388 -0
  110. package/dist/exec-approvals-cli-DBgnm_6P.js +385 -0
  111. package/dist/extensionAPI.js +68185 -0
  112. package/dist/format-8citvr_1.js +34 -0
  113. package/dist/format-tlvh4-cQ.js +34 -0
  114. package/dist/gateway-cli-BKJbSNiq.js +17878 -0
  115. package/dist/gateway-cli-DMbgzP3o.js +17877 -0
  116. package/dist/gateway-rpc-CFkdcw9l.js +28 -0
  117. package/dist/gateway-rpc-CJljb7MY.js +28 -0
  118. package/dist/github-copilot-auth-BGWtD7lK.js +1256 -0
  119. package/dist/github-copilot-auth-Bog6I9WM.js +1256 -0
  120. package/dist/github-copilot-token-BOoCTERW.js +103 -0
  121. package/dist/github-copilot-token-SLWintYd.js +103 -0
  122. package/dist/github-copilot-token-_jdpoYjM.js +103 -0
  123. package/dist/gmail-setup-utils-C97cHaGd.js +428 -0
  124. package/dist/gmail-setup-utils-n354D0jO.js +428 -0
  125. package/dist/health-format-CLSugjQl.js +1383 -0
  126. package/dist/health-format-KsXnqZiA.js +1382 -0
  127. package/dist/help-format-DuMTLWZ-.js +17 -0
  128. package/dist/help-format-GYRujDx9.js +17 -0
  129. package/dist/helpers-BiyEksaK.js +25 -0
  130. package/dist/helpers-DMlRCrD6.js +10 -0
  131. package/dist/helpers-azbX_hrI.js +25 -0
  132. package/dist/helpers-yjIEMzi8.js +10 -0
  133. package/dist/hooks-cli-DXs2Jiyd.js +1061 -0
  134. package/dist/hooks-cli-Dsah_Ryz.js +1058 -0
  135. package/dist/hooks-status-CpkHFMVY.js +443 -0
  136. package/dist/hooks-status-DQRtaH38.js +443 -0
  137. package/dist/image-C6SHcuJM.js +1421 -0
  138. package/dist/image-Cyv4Hr2t.js +629 -0
  139. package/dist/image-DXuHvpqC.js +629 -0
  140. package/dist/index.js +5667 -0
  141. package/dist/installs-BvY-yqDY.js +425 -0
  142. package/dist/installs-Snp4gUlG.js +425 -0
  143. package/dist/is-main-B6kCyqsv.js +25 -0
  144. package/dist/is-main-PYGa3tDA.js +25 -0
  145. package/dist/links-B79LZSNJ.js +15 -0
  146. package/dist/links-iCD68SwJ.js +15 -0
  147. package/dist/loader-ysGIXyYq.js +64701 -0
  148. package/dist/logging-BWRYHvLp.js +1 -0
  149. package/dist/logging-CzN9OPmT.js +15 -0
  150. package/dist/logging-awp_aUN6.js +15 -0
  151. package/dist/logging-pqyrk15z.js +1 -0
  152. package/dist/login-qr-BEXsF0Oj.js +475 -0
  153. package/dist/login-qr-D823w1Qv.js +478 -0
  154. package/dist/login-qr-wnUfVUoC.js +478 -0
  155. package/dist/logs-cli-D912P9Qo.js +230 -0
  156. package/dist/logs-cli-DHYl4Nfl.js +227 -0
  157. package/dist/manager-DORkoiXy.js +3216 -0
  158. package/dist/manager-MLoKmXjg.js +3218 -0
  159. package/dist/manager-e20ne1Ai.js +3216 -0
  160. package/dist/manifest-registry-D8FEq9qs.js +668 -0
  161. package/dist/manifest-registry-DjRSe72U.js +668 -0
  162. package/dist/message-channel-DJEeCAZD.js +110 -0
  163. package/dist/message-channel-DcxF0eJh.js +110 -0
  164. package/dist/model-selection-CjYymzT8.js +2983 -0
  165. package/dist/model-selection-Cz_VcpX5.js +2734 -0
  166. package/dist/models-cli-CURq5BOw.js +2542 -0
  167. package/dist/models-cli-_y06d7uQ.js +2545 -0
  168. package/dist/net-MZzhgr1g.js +1814 -0
  169. package/dist/node-cli-BkEdPem3.js +1456 -0
  170. package/dist/node-cli-PesFC8YY.js +1459 -0
  171. package/dist/node-service-CmyQuldc.js +67 -0
  172. package/dist/node-service-DB0Rp9Fr.js +67 -0
  173. package/dist/nodes-cli-BV7z71Ke.js +1207 -0
  174. package/dist/nodes-cli-D-pPXmLu.js +1210 -0
  175. package/dist/nodes-screen-B240wNB8.js +157 -0
  176. package/dist/nodes-screen-CGLXLco9.js +157 -0
  177. package/dist/note-_C44YfAQ.js +73 -0
  178. package/dist/note-rStT8AJi.js +73 -0
  179. package/dist/onboard-channels-CSGrNeHm.js +671 -0
  180. package/dist/onboard-channels-CyYMvXjh.js +671 -0
  181. package/dist/onboard-skills-BzZrWnt3.js +3452 -0
  182. package/dist/onboard-skills-Z3OoXEqp.js +3452 -0
  183. package/dist/onboarding--5CEtfSX.js +3269 -0
  184. package/dist/pairing-cli-BrPmwezL.js +114 -0
  185. package/dist/pairing-cli-CN183i69.js +117 -0
  186. package/dist/pairing-labels-CrJtLbMY.js +9 -0
  187. package/dist/pairing-labels-DXioxZ5X.js +9 -0
  188. package/dist/pairing-store-D_NP0mJs.js +391 -0
  189. package/dist/pairing-store-pdzxfI5n.js +391 -0
  190. package/dist/parse-BZz5lHzQ.js +23 -0
  191. package/dist/parse-DqAvJRIf.js +23 -0
  192. package/dist/parse-log-line-BnB7770k.js +44 -0
  193. package/dist/parse-log-line-DSvJi17i.js +44 -0
  194. package/dist/parse-timeout-DV8NQQWk.js +16 -0
  195. package/dist/parse-timeout-Du-wHHNi.js +16 -0
  196. package/dist/path-env-Bc8ZqjfY.js +77 -0
  197. package/dist/path-env-DwZUJC_M.js +77 -0
  198. package/dist/paths-8P2BYpvK.js +156 -0
  199. package/dist/paths-Cn5vXlEi.js +43 -0
  200. package/dist/paths-D4TjaAs9.js +40 -0
  201. package/dist/paths-Drx5WZ13.js +172 -0
  202. package/dist/paths-mzsdSoO2.js +43 -0
  203. package/dist/pi-embedded-helpers-Dpu3lm3V.js +1303 -0
  204. package/dist/pi-embedded-helpers-N_L31uhW.js +1303 -0
  205. package/dist/pi-embedded-helpers-dkrwwXev.js +8481 -0
  206. package/dist/pi-model-discovery-CV2V1HHz.js +20 -0
  207. package/dist/pi-model-discovery-DzEIEgHL.js +20 -0
  208. package/dist/pi-model-discovery-EhM2JAQo.js +20 -0
  209. package/dist/pi-tools.policy-m0G0As1p.js +230 -0
  210. package/dist/plugin-auto-enable-Bu3hK0U6.js +460 -0
  211. package/dist/plugin-auto-enable-Ca3Ou67i.js +460 -0
  212. package/dist/plugin-sdk/index.js +24446 -0
  213. package/dist/plugin-sdk/pi-model-discovery-Dw3A6oXH.js +37 -0
  214. package/dist/plugins-Bng3p5bC.js +496 -0
  215. package/dist/plugins-C1mc_xWv.js +495 -0
  216. package/dist/plugins-cli-B8FonfqG.js +441 -0
  217. package/dist/plugins-cli-B9q0wqUI.js +444 -0
  218. package/dist/ports-DKGBzWgI.js +96 -0
  219. package/dist/program-_5hB5I-4.js +191 -0
  220. package/dist/progress-Bcjniu7m.js +133 -0
  221. package/dist/progress-DWODVbwW.js +133 -0
  222. package/dist/prompt-style-CFsleyxV.js +9 -0
  223. package/dist/prompt-style-DZli5767.js +9 -0
  224. package/dist/prompts-CudpZgTI.js +10 -0
  225. package/dist/prompts-FbZThK8w.js +10 -0
  226. package/dist/pw-ai-BUeSOvm-.js +1649 -0
  227. package/dist/pw-ai-GjX4Az_L.js +1649 -0
  228. package/dist/pw-ai-bugVLPkL.js +1651 -0
  229. package/dist/qmd-manager-C1JB3Owf.js +677 -0
  230. package/dist/qmd-manager-TkF_5Pm-.js +676 -0
  231. package/dist/qmd-manager-t9qHekRb.js +674 -0
  232. package/dist/redact-BIMJ3ntQ.js +94 -0
  233. package/dist/redact-Bt-krp_b.js +97 -0
  234. package/dist/redact-DJCFY628.js +97 -0
  235. package/dist/register.subclis-CZG20DZj.js +348 -0
  236. package/dist/reply-8T1JOF0R.js +64704 -0
  237. package/dist/rolldown-runtime-Cbj13DAv.js +20 -0
  238. package/dist/routes-BxFcXB4m.js +2411 -0
  239. package/dist/routes-Dw3vw8Re.js +2411 -0
  240. package/dist/rpc-DgcF4XNR.js +95 -0
  241. package/dist/rpc-f-LmE9z_.js +95 -0
  242. package/dist/run-main-_bbXf2vQ.js +194 -0
  243. package/dist/sandbox-BcOPJhQv.js +2945 -0
  244. package/dist/sandbox-DfBaWfDh.js +2944 -0
  245. package/dist/sandbox-cli-BRcke02J.js +460 -0
  246. package/dist/sandbox-cli-CbUgIVf2.js +463 -0
  247. package/dist/security-cli-76hHzPsz.js +505 -0
  248. package/dist/security-cli-CQ6iSAev.js +508 -0
  249. package/dist/server-context-BuV65eg5.js +740 -0
  250. package/dist/server-context-CFielb4y.js +740 -0
  251. package/dist/server-node-events-CkLBKtGs.js +216 -0
  252. package/dist/server-node-events-D_3bg9qE.js +219 -0
  253. package/dist/service-CZFM7dlu.js +680 -0
  254. package/dist/service-audit-DBdadurs.js +537 -0
  255. package/dist/service-audit-DptlZVXP.js +537 -0
  256. package/dist/service-sZqtAG53.js +680 -0
  257. package/dist/session-cost-usage-CPvtWzot.js +692 -0
  258. package/dist/session-cost-usage-lYVH5MAy.js +692 -0
  259. package/dist/session-key-DrNCyvP1.js +182 -0
  260. package/dist/session-key-n2HVbrj0.js +182 -0
  261. package/dist/shared-Bl4lcfSF.js +74 -0
  262. package/dist/shared-C79dnas0.js +74 -0
  263. package/dist/shared-CDe5yKDd.js +152 -0
  264. package/dist/shared-Cpd7X2eE.js +152 -0
  265. package/dist/skill-scanner-BoGjHXUZ.js +255 -0
  266. package/dist/skill-scanner-COatt01v.js +255 -0
  267. package/dist/skills-CrYcs9jK.js +694 -0
  268. package/dist/skills-DxzXqcWw.js +693 -0
  269. package/dist/skills-cli-BWqUiFIC.js +287 -0
  270. package/dist/skills-cli-C2rWGqKQ.js +290 -0
  271. package/dist/skills-status-Bhe2beiQ.js +187 -0
  272. package/dist/skills-status-DQyBTrvU.js +187 -0
  273. package/dist/sqlite-BjBQdG8T.js +239 -0
  274. package/dist/sqlite-BjhYBODp.js +221 -0
  275. package/dist/sqlite-CbZh0dx1.js +239 -0
  276. package/dist/status-BF8IVV7c.js +21 -0
  277. package/dist/status-BHPh7bCk.js +27 -0
  278. package/dist/status-CWDof7Cn.js +21 -0
  279. package/dist/status-DyjCSdtm.js +27 -0
  280. package/dist/status-RJGk9wHW.js +3177 -0
  281. package/dist/subsystem-DPYBJG7C.js +838 -0
  282. package/dist/system-cli-BY3oOcLX.js +83 -0
  283. package/dist/system-cli-pg7MxYKd.js +80 -0
  284. package/dist/systemd-DerMq_3Y.js +438 -0
  285. package/dist/systemd-Gt0riLnX.js +438 -0
  286. package/dist/systemd-hints-C6JS-A6Y.js +19 -0
  287. package/dist/systemd-hints-Db4JjAxJ.js +19 -0
  288. package/dist/systemd-linger-CRL7Xf4C.js +75 -0
  289. package/dist/systemd-linger-DS0IcHsk.js +75 -0
  290. package/dist/table-BzJyfJCd.js +279 -0
  291. package/dist/table-DCcFNw6e.js +279 -0
  292. package/dist/tailnet-Byp3obcc.js +42 -0
  293. package/dist/tailnet-DLDGNuH2.js +42 -0
  294. package/dist/tailscale-9MusRvOi.js +225 -0
  295. package/dist/tailscale-CGhNcgVS.js +252 -0
  296. package/dist/tool-display-C9u4CdQu.js +795 -0
  297. package/dist/tool-display-D_HGmnfa.js +795 -0
  298. package/dist/transcript-events-Bv_eRVym.js +17 -0
  299. package/dist/transcript-events-ChU6IQwp.js +17 -0
  300. package/dist/transcript-events-JLH5W4He.js +17 -0
  301. package/dist/tui-BPqDn4Jf.js +3090 -0
  302. package/dist/tui-BniTBjBP.js +3089 -0
  303. package/dist/tui-cli-AeeP52_J.js +58 -0
  304. package/dist/tui-cli-DrWl0dkQ.js +55 -0
  305. package/dist/update-BKGU5x_o.js +317 -0
  306. package/dist/update-CZqqbW73.js +317 -0
  307. package/dist/update-cli-DTXxX27F.js +1036 -0
  308. package/dist/update-cli-j0POazuO.js +1034 -0
  309. package/dist/update-runner-BY-i_k4L.js +1458 -0
  310. package/dist/update-runner-CmdPxJg5.js +1458 -0
  311. package/dist/usage-format-BcU1flOY.js +36 -0
  312. package/dist/usage-format-DvowRSs-.js +36 -0
  313. package/dist/utils-C7NsUvD1.js +192 -0
  314. package/dist/utils-DBu98aoz.js +188 -0
  315. package/dist/webhooks-cli-BBw-pRTs.js +309 -0
  316. package/dist/webhooks-cli-BXxSGFuL.js +312 -0
  317. package/dist/widearea-dns-C2mRm6hu.js +127 -0
  318. package/dist/widearea-dns-DbdWF6kP.js +127 -0
  319. package/dist/ws-CEcdsnN9.js +13 -0
  320. package/dist/ws-D091yo4M.js +13 -0
  321. package/dist/ws-log-Bpm8rpoP.js +267 -0
  322. package/dist/ws-log-vBkmxf4_.js +267 -0
  323. package/dist/wsl-QYB9yGZN.js +160 -0
  324. package/docs/.i18n/README.md +31 -0
  325. package/docs/.i18n/glossary.zh-CN.json +210 -0
  326. package/docs/.i18n/zh-CN.tm.jsonl +1329 -0
  327. package/docs/CNAME +1 -0
  328. package/docs/assets/macos-onboarding/01-macos-warning.jpeg +0 -0
  329. package/docs/assets/macos-onboarding/02-local-networks.jpeg +0 -0
  330. package/docs/assets/macos-onboarding/03-security-notice.png +0 -0
  331. package/docs/assets/macos-onboarding/04-choose-gateway.png +0 -0
  332. package/docs/assets/macos-onboarding/05-permissions.png +0 -0
  333. package/docs/assets/openclaw-logo-text-dark.png +0 -0
  334. package/docs/assets/openclaw-logo-text.png +0 -0
  335. package/docs/assets/pixel-lobster.svg +60 -0
  336. package/docs/assets/showcase/agents-ui.jpg +0 -0
  337. package/docs/assets/showcase/bambu-cli.png +0 -0
  338. package/docs/assets/showcase/codexmonitor.png +0 -0
  339. package/docs/assets/showcase/gohome-grafana.png +0 -0
  340. package/docs/assets/showcase/ios-testflight.jpg +0 -0
  341. package/docs/assets/showcase/oura-health.png +0 -0
  342. package/docs/assets/showcase/padel-cli.svg +11 -0
  343. package/docs/assets/showcase/padel-screenshot.jpg +0 -0
  344. package/docs/assets/showcase/papla-tts.jpg +0 -0
  345. package/docs/assets/showcase/pr-review-telegram.jpg +0 -0
  346. package/docs/assets/showcase/roborock-screenshot.jpg +0 -0
  347. package/docs/assets/showcase/roborock-status.svg +13 -0
  348. package/docs/assets/showcase/roof-camera-sky.jpg +0 -0
  349. package/docs/assets/showcase/snag.png +0 -0
  350. package/docs/assets/showcase/tesco-shop.jpg +0 -0
  351. package/docs/assets/showcase/wienerlinien.png +0 -0
  352. package/docs/assets/showcase/wine-cellar-skill.jpg +0 -0
  353. package/docs/assets/showcase/winix-air-purifier.jpg +0 -0
  354. package/docs/assets/showcase/xuezh-pronunciation.jpeg +0 -0
  355. package/docs/automation/auth-monitoring.md +44 -0
  356. package/docs/automation/cron-jobs.md +471 -0
  357. package/docs/automation/cron-vs-heartbeat.md +282 -0
  358. package/docs/automation/gmail-pubsub.md +256 -0
  359. package/docs/automation/hooks.md +916 -0
  360. package/docs/automation/poll.md +69 -0
  361. package/docs/automation/troubleshooting.md +122 -0
  362. package/docs/automation/webhook.md +163 -0
  363. package/docs/brave-search.md +41 -0
  364. package/docs/channels/bluebubbles.md +340 -0
  365. package/docs/channels/broadcast-groups.md +442 -0
  366. package/docs/channels/channel-routing.md +114 -0
  367. package/docs/channels/discord.md +476 -0
  368. package/docs/channels/feishu.md +579 -0
  369. package/docs/channels/googlechat.md +252 -0
  370. package/docs/channels/grammy.md +31 -0
  371. package/docs/channels/group-messages.md +84 -0
  372. package/docs/channels/groups.md +374 -0
  373. package/docs/channels/imessage.md +321 -0
  374. package/docs/channels/index.md +46 -0
  375. package/docs/channels/line.md +186 -0
  376. package/docs/channels/location.md +56 -0
  377. package/docs/channels/matrix.md +259 -0
  378. package/docs/channels/mattermost.md +138 -0
  379. package/docs/channels/msteams.md +769 -0
  380. package/docs/channels/nextcloud-talk.md +138 -0
  381. package/docs/channels/nostr.md +233 -0
  382. package/docs/channels/pairing.md +86 -0
  383. package/docs/channels/signal.md +228 -0
  384. package/docs/channels/slack.md +574 -0
  385. package/docs/channels/telegram.md +770 -0
  386. package/docs/channels/tlon.md +132 -0
  387. package/docs/channels/troubleshooting.md +116 -0
  388. package/docs/channels/twitch.md +379 -0
  389. package/docs/channels/whatsapp.md +406 -0
  390. package/docs/channels/zalo.md +189 -0
  391. package/docs/channels/zalouser.md +140 -0
  392. package/docs/cli/acp.md +170 -0
  393. package/docs/cli/agent.md +24 -0
  394. package/docs/cli/agents.md +75 -0
  395. package/docs/cli/approvals.md +50 -0
  396. package/docs/cli/browser.md +107 -0
  397. package/docs/cli/channels.md +79 -0
  398. package/docs/cli/config.md +50 -0
  399. package/docs/cli/configure.md +33 -0
  400. package/docs/cli/cron.md +42 -0
  401. package/docs/cli/dashboard.md +16 -0
  402. package/docs/cli/devices.md +70 -0
  403. package/docs/cli/directory.md +63 -0
  404. package/docs/cli/dns.md +23 -0
  405. package/docs/cli/docs.md +15 -0
  406. package/docs/cli/doctor.md +41 -0
  407. package/docs/cli/gateway.md +202 -0
  408. package/docs/cli/health.md +21 -0
  409. package/docs/cli/hooks.md +304 -0
  410. package/docs/cli/index.md +1031 -0
  411. package/docs/cli/logs.md +24 -0
  412. package/docs/cli/memory.md +45 -0
  413. package/docs/cli/message.md +239 -0
  414. package/docs/cli/models.md +79 -0
  415. package/docs/cli/node.md +112 -0
  416. package/docs/cli/nodes.md +73 -0
  417. package/docs/cli/onboard.md +43 -0
  418. package/docs/cli/pairing.md +21 -0
  419. package/docs/cli/plugins.md +62 -0
  420. package/docs/cli/reset.md +17 -0
  421. package/docs/cli/sandbox.md +152 -0
  422. package/docs/cli/security.md +26 -0
  423. package/docs/cli/sessions.md +16 -0
  424. package/docs/cli/setup.md +29 -0
  425. package/docs/cli/skills.md +26 -0
  426. package/docs/cli/status.md +26 -0
  427. package/docs/cli/system.md +60 -0
  428. package/docs/cli/tui.md +23 -0
  429. package/docs/cli/uninstall.md +17 -0
  430. package/docs/cli/update.md +98 -0
  431. package/docs/cli/voicecall.md +34 -0
  432. package/docs/cli/webhooks.md +25 -0
  433. package/docs/concepts/agent-loop.md +146 -0
  434. package/docs/concepts/agent-workspace.md +233 -0
  435. package/docs/concepts/agent.md +123 -0
  436. package/docs/concepts/architecture.md +131 -0
  437. package/docs/concepts/compaction.md +61 -0
  438. package/docs/concepts/context.md +161 -0
  439. package/docs/concepts/features.md +53 -0
  440. package/docs/concepts/markdown-formatting.md +130 -0
  441. package/docs/concepts/memory.md +556 -0
  442. package/docs/concepts/messages.md +154 -0
  443. package/docs/concepts/model-failover.md +149 -0
  444. package/docs/concepts/model-providers.md +316 -0
  445. package/docs/concepts/models.md +208 -0
  446. package/docs/concepts/multi-agent.md +376 -0
  447. package/docs/concepts/oauth.md +145 -0
  448. package/docs/concepts/presence.md +102 -0
  449. package/docs/concepts/queue.md +89 -0
  450. package/docs/concepts/retry.md +69 -0
  451. package/docs/concepts/session-pruning.md +122 -0
  452. package/docs/concepts/session-tool.md +193 -0
  453. package/docs/concepts/session.md +204 -0
  454. package/docs/concepts/sessions.md +10 -0
  455. package/docs/concepts/streaming.md +135 -0
  456. package/docs/concepts/system-prompt.md +115 -0
  457. package/docs/concepts/timezone.md +91 -0
  458. package/docs/concepts/typebox.md +289 -0
  459. package/docs/concepts/typing-indicators.md +68 -0
  460. package/docs/concepts/usage-tracking.md +35 -0
  461. package/docs/date-time.md +128 -0
  462. package/docs/debug/node-issue.md +85 -0
  463. package/docs/diagnostics/flags.md +91 -0
  464. package/docs/docs.json +1802 -0
  465. package/docs/experiments/onboarding-config-protocol.md +40 -0
  466. package/docs/experiments/plans/cron-add-hardening.md +63 -0
  467. package/docs/experiments/plans/group-policy-hardening.md +40 -0
  468. package/docs/experiments/plans/openresponses-gateway.md +123 -0
  469. package/docs/experiments/proposals/model-config.md +36 -0
  470. package/docs/experiments/research/memory.md +228 -0
  471. package/docs/gateway/authentication.md +145 -0
  472. package/docs/gateway/background-process.md +93 -0
  473. package/docs/gateway/bonjour.md +170 -0
  474. package/docs/gateway/bridge-protocol.md +89 -0
  475. package/docs/gateway/cli-backends.md +225 -0
  476. package/docs/gateway/configuration-examples.md +606 -0
  477. package/docs/gateway/configuration.md +3416 -0
  478. package/docs/gateway/discovery.md +116 -0
  479. package/docs/gateway/doctor.md +282 -0
  480. package/docs/gateway/gateway-lock.md +34 -0
  481. package/docs/gateway/health.md +35 -0
  482. package/docs/gateway/heartbeat.md +364 -0
  483. package/docs/gateway/index.md +330 -0
  484. package/docs/gateway/local-models.md +150 -0
  485. package/docs/gateway/logging.md +113 -0
  486. package/docs/gateway/multiple-gateways.md +112 -0
  487. package/docs/gateway/network-model.md +17 -0
  488. package/docs/gateway/openai-http-api.md +118 -0
  489. package/docs/gateway/openresponses-http-api.md +317 -0
  490. package/docs/gateway/pairing.md +99 -0
  491. package/docs/gateway/protocol.md +221 -0
  492. package/docs/gateway/remote-gateway-readme.md +157 -0
  493. package/docs/gateway/remote.md +129 -0
  494. package/docs/gateway/sandbox-vs-tool-policy-vs-elevated.md +128 -0
  495. package/docs/gateway/sandboxing.md +193 -0
  496. package/docs/gateway/security/index.md +829 -0
  497. package/docs/gateway/tailscale.md +127 -0
  498. package/docs/gateway/tools-invoke-http-api.md +85 -0
  499. package/docs/gateway/troubleshooting.md +318 -0
  500. package/docs/help/debugging.md +162 -0
  501. package/docs/help/environment.md +81 -0
  502. package/docs/help/faq.md +2848 -0
  503. package/docs/help/index.md +21 -0
  504. package/docs/help/scripts.md +28 -0
  505. package/docs/help/submitting-a-pr.md +398 -0
  506. package/docs/help/submitting-an-issue.md +152 -0
  507. package/docs/help/testing.md +368 -0
  508. package/docs/help/troubleshooting.md +265 -0
  509. package/docs/hooks/soul-evil.md +69 -0
  510. package/docs/images/feishu-step2-create-app.png +0 -0
  511. package/docs/images/feishu-step3-credentials.png +0 -0
  512. package/docs/images/feishu-step4-permissions.png +0 -0
  513. package/docs/images/feishu-step5-bot-capability.png +0 -0
  514. package/docs/images/feishu-step6-event-subscription.png +0 -0
  515. package/docs/images/groups-flow.svg +52 -0
  516. package/docs/images/mobile-ui-screenshot.png +0 -0
  517. package/docs/index.md +192 -0
  518. package/docs/install/ansible.md +208 -0
  519. package/docs/install/bun.md +59 -0
  520. package/docs/install/development-channels.md +75 -0
  521. package/docs/install/docker.md +567 -0
  522. package/docs/install/exe-dev.md +126 -0
  523. package/docs/install/fly.md +486 -0
  524. package/docs/install/gcp.md +504 -0
  525. package/docs/install/hetzner.md +330 -0
  526. package/docs/install/index.md +203 -0
  527. package/docs/install/installer.md +385 -0
  528. package/docs/install/macos-vm.md +281 -0
  529. package/docs/install/migrating.md +192 -0
  530. package/docs/install/nix.md +96 -0
  531. package/docs/install/node.md +138 -0
  532. package/docs/install/northflank.mdx +53 -0
  533. package/docs/install/railway.mdx +99 -0
  534. package/docs/install/render.mdx +159 -0
  535. package/docs/install/uninstall.md +128 -0
  536. package/docs/install/updating.md +231 -0
  537. package/docs/logging.md +350 -0
  538. package/docs/network.md +54 -0
  539. package/docs/nodes/audio.md +114 -0
  540. package/docs/nodes/camera.md +156 -0
  541. package/docs/nodes/images.md +72 -0
  542. package/docs/nodes/index.md +342 -0
  543. package/docs/nodes/location-command.md +113 -0
  544. package/docs/nodes/media-understanding.md +379 -0
  545. package/docs/nodes/talk.md +90 -0
  546. package/docs/nodes/troubleshooting.md +112 -0
  547. package/docs/nodes/voicewake.md +65 -0
  548. package/docs/perplexity.md +80 -0
  549. package/docs/pi-dev.md +70 -0
  550. package/docs/pi.md +612 -0
  551. package/docs/platforms/android.md +151 -0
  552. package/docs/platforms/digitalocean.md +262 -0
  553. package/docs/platforms/index.md +53 -0
  554. package/docs/platforms/ios.md +107 -0
  555. package/docs/platforms/linux.md +94 -0
  556. package/docs/platforms/mac/bundled-gateway.md +73 -0
  557. package/docs/platforms/mac/canvas.md +125 -0
  558. package/docs/platforms/mac/child-process.md +69 -0
  559. package/docs/platforms/mac/dev-setup.md +104 -0
  560. package/docs/platforms/mac/health.md +34 -0
  561. package/docs/platforms/mac/icon.md +31 -0
  562. package/docs/platforms/mac/logging.md +57 -0
  563. package/docs/platforms/mac/menu-bar.md +81 -0
  564. package/docs/platforms/mac/peekaboo.md +65 -0
  565. package/docs/platforms/mac/permissions.md +50 -0
  566. package/docs/platforms/mac/release.md +85 -0
  567. package/docs/platforms/mac/remote.md +83 -0
  568. package/docs/platforms/mac/signing.md +47 -0
  569. package/docs/platforms/mac/skills.md +33 -0
  570. package/docs/platforms/mac/voice-overlay.md +60 -0
  571. package/docs/platforms/mac/voicewake.md +67 -0
  572. package/docs/platforms/mac/webchat.md +43 -0
  573. package/docs/platforms/mac/xpc.md +61 -0
  574. package/docs/platforms/macos.md +203 -0
  575. package/docs/platforms/oracle.md +303 -0
  576. package/docs/platforms/raspberry-pi.md +358 -0
  577. package/docs/platforms/windows.md +159 -0
  578. package/docs/plugins/agent-tools.md +99 -0
  579. package/docs/plugins/manifest.md +71 -0
  580. package/docs/plugins/voice-call.md +284 -0
  581. package/docs/plugins/zalouser.md +81 -0
  582. package/docs/prose.md +134 -0
  583. package/docs/providers/anthropic.md +152 -0
  584. package/docs/providers/bedrock.md +176 -0
  585. package/docs/providers/claude-max-api-proxy.md +148 -0
  586. package/docs/providers/cloudflare-ai-gateway.md +71 -0
  587. package/docs/providers/deepgram.md +93 -0
  588. package/docs/providers/github-copilot.md +72 -0
  589. package/docs/providers/glm.md +33 -0
  590. package/docs/providers/index.md +64 -0
  591. package/docs/providers/minimax.md +208 -0
  592. package/docs/providers/models.md +52 -0
  593. package/docs/providers/moonshot.md +142 -0
  594. package/docs/providers/ollama.md +277 -0
  595. package/docs/providers/openai.md +62 -0
  596. package/docs/providers/opencode.md +36 -0
  597. package/docs/providers/openrouter.md +37 -0
  598. package/docs/providers/qianfan.md +38 -0
  599. package/docs/providers/qwen.md +53 -0
  600. package/docs/providers/synthetic.md +99 -0
  601. package/docs/providers/venice.md +267 -0
  602. package/docs/providers/vercel-ai-gateway.md +50 -0
  603. package/docs/providers/xiaomi.md +64 -0
  604. package/docs/providers/zai.md +36 -0
  605. package/docs/refactor/clawnet.md +417 -0
  606. package/docs/refactor/exec-host.md +316 -0
  607. package/docs/refactor/outbound-session-mirroring.md +85 -0
  608. package/docs/refactor/plugin-sdk.md +214 -0
  609. package/docs/refactor/strict-config.md +93 -0
  610. package/docs/reference/AGENTS.default.md +123 -0
  611. package/docs/reference/RELEASING.md +120 -0
  612. package/docs/reference/api-usage-costs.md +138 -0
  613. package/docs/reference/credits.md +27 -0
  614. package/docs/reference/device-models.md +47 -0
  615. package/docs/reference/rpc.md +43 -0
  616. package/docs/reference/session-management-compaction.md +285 -0
  617. package/docs/reference/templates/AGENTS.dev.md +83 -0
  618. package/docs/reference/templates/AGENTS.md +218 -0
  619. package/docs/reference/templates/BOOT.md +10 -0
  620. package/docs/reference/templates/BOOTSTRAP.md +61 -0
  621. package/docs/reference/templates/HEARTBEAT.md +11 -0
  622. package/docs/reference/templates/IDENTITY.dev.md +47 -0
  623. package/docs/reference/templates/IDENTITY.md +29 -0
  624. package/docs/reference/templates/SOUL.dev.md +76 -0
  625. package/docs/reference/templates/SOUL.md +42 -0
  626. package/docs/reference/templates/TOOLS.dev.md +24 -0
  627. package/docs/reference/templates/TOOLS.md +46 -0
  628. package/docs/reference/templates/USER.dev.md +18 -0
  629. package/docs/reference/templates/USER.md +23 -0
  630. package/docs/reference/test.md +50 -0
  631. package/docs/reference/token-use.md +112 -0
  632. package/docs/reference/transcript-hygiene.md +129 -0
  633. package/docs/reference/wizard.md +269 -0
  634. package/docs/security/formal-verification.md +164 -0
  635. package/docs/start/bootstrapping.md +41 -0
  636. package/docs/start/docs-directory.md +64 -0
  637. package/docs/start/getting-started.md +120 -0
  638. package/docs/start/hubs.md +197 -0
  639. package/docs/start/lore.md +219 -0
  640. package/docs/start/onboarding.md +80 -0
  641. package/docs/start/openclaw.md +224 -0
  642. package/docs/start/quickstart.md +22 -0
  643. package/docs/start/setup.md +162 -0
  644. package/docs/start/showcase.md +416 -0
  645. package/docs/start/wizard-cli-automation.md +141 -0
  646. package/docs/start/wizard-cli-reference.md +247 -0
  647. package/docs/start/wizard.md +108 -0
  648. package/docs/style.css +3 -0
  649. package/docs/tools/agent-send.md +53 -0
  650. package/docs/tools/apply-patch.md +50 -0
  651. package/docs/tools/browser-linux-troubleshooting.md +139 -0
  652. package/docs/tools/browser-login.md +67 -0
  653. package/docs/tools/browser.md +576 -0
  654. package/docs/tools/chrome-extension.md +178 -0
  655. package/docs/tools/clawhub.md +257 -0
  656. package/docs/tools/creating-skills.md +54 -0
  657. package/docs/tools/elevated.md +57 -0
  658. package/docs/tools/exec-approvals.md +246 -0
  659. package/docs/tools/exec.md +179 -0
  660. package/docs/tools/firecrawl.md +61 -0
  661. package/docs/tools/index.md +512 -0
  662. package/docs/tools/llm-task.md +115 -0
  663. package/docs/tools/lobster.md +342 -0
  664. package/docs/tools/multi-agent-sandbox-tools.md +396 -0
  665. package/docs/tools/plugin.md +664 -0
  666. package/docs/tools/reactions.md +22 -0
  667. package/docs/tools/skills-config.md +76 -0
  668. package/docs/tools/skills.md +300 -0
  669. package/docs/tools/slash-commands.md +198 -0
  670. package/docs/tools/subagents.md +151 -0
  671. package/docs/tools/thinking.md +74 -0
  672. package/docs/tools/web.md +261 -0
  673. package/docs/tts.md +396 -0
  674. package/docs/vps.md +43 -0
  675. package/docs/web/control-ui.md +223 -0
  676. package/docs/web/dashboard.md +46 -0
  677. package/docs/web/index.md +116 -0
  678. package/docs/web/tui.md +162 -0
  679. package/docs/web/webchat.md +49 -0
  680. package/docs/whatsapp-openclaw-ai-zh.jpg +0 -0
  681. package/docs/whatsapp-openclaw.jpg +0 -0
  682. package/docs/zh-CN/AGENTS.md +59 -0
  683. package/docs/zh-CN/automation/auth-monitoring.md +47 -0
  684. package/docs/zh-CN/automation/cron-jobs.md +424 -0
  685. package/docs/zh-CN/automation/cron-vs-heartbeat.md +286 -0
  686. package/docs/zh-CN/automation/gmail-pubsub.md +249 -0
  687. package/docs/zh-CN/automation/hooks.md +919 -0
  688. package/docs/zh-CN/automation/poll.md +76 -0
  689. package/docs/zh-CN/automation/troubleshooting.md +8 -0
  690. package/docs/zh-CN/automation/webhook.md +163 -0
  691. package/docs/zh-CN/brave-search.md +48 -0
  692. package/docs/zh-CN/channels/bluebubbles.md +271 -0
  693. package/docs/zh-CN/channels/broadcast-groups.md +449 -0
  694. package/docs/zh-CN/channels/channel-routing.md +117 -0
  695. package/docs/zh-CN/channels/discord.md +468 -0
  696. package/docs/zh-CN/channels/feishu.md +629 -0
  697. package/docs/zh-CN/channels/googlechat.md +257 -0
  698. package/docs/zh-CN/channels/grammy.md +38 -0
  699. package/docs/zh-CN/channels/group-messages.md +91 -0
  700. package/docs/zh-CN/channels/groups.md +379 -0
  701. package/docs/zh-CN/channels/imessage.md +302 -0
  702. package/docs/zh-CN/channels/index.md +53 -0
  703. package/docs/zh-CN/channels/line.md +180 -0
  704. package/docs/zh-CN/channels/location.md +63 -0
  705. package/docs/zh-CN/channels/matrix.md +221 -0
  706. package/docs/zh-CN/channels/mattermost.md +144 -0
  707. package/docs/zh-CN/channels/msteams.md +775 -0
  708. package/docs/zh-CN/channels/nextcloud-talk.md +142 -0
  709. package/docs/zh-CN/channels/nostr.md +240 -0
  710. package/docs/zh-CN/channels/pairing.md +89 -0
  711. package/docs/zh-CN/channels/signal.md +209 -0
  712. package/docs/zh-CN/channels/slack.md +531 -0
  713. package/docs/zh-CN/channels/telegram.md +751 -0
  714. package/docs/zh-CN/channels/tlon.md +136 -0
  715. package/docs/zh-CN/channels/troubleshooting.md +36 -0
  716. package/docs/zh-CN/channels/twitch.md +385 -0
  717. package/docs/zh-CN/channels/whatsapp.md +411 -0
  718. package/docs/zh-CN/channels/zalo.md +196 -0
  719. package/docs/zh-CN/channels/zalouser.md +147 -0
  720. package/docs/zh-CN/cli/acp.md +173 -0
  721. package/docs/zh-CN/cli/agent.md +30 -0
  722. package/docs/zh-CN/cli/agents.md +82 -0
  723. package/docs/zh-CN/cli/approvals.md +57 -0
  724. package/docs/zh-CN/cli/browser.md +114 -0
  725. package/docs/zh-CN/cli/channels.md +86 -0
  726. package/docs/zh-CN/cli/config.md +57 -0
  727. package/docs/zh-CN/cli/configure.md +38 -0
  728. package/docs/zh-CN/cli/cron.md +43 -0
  729. package/docs/zh-CN/cli/dashboard.md +23 -0
  730. package/docs/zh-CN/cli/devices.md +74 -0
  731. package/docs/zh-CN/cli/directory.md +70 -0
  732. package/docs/zh-CN/cli/dns.md +30 -0
  733. package/docs/zh-CN/cli/docs.md +22 -0
  734. package/docs/zh-CN/cli/doctor.md +48 -0
  735. package/docs/zh-CN/cli/gateway.md +206 -0
  736. package/docs/zh-CN/cli/health.md +28 -0
  737. package/docs/zh-CN/cli/hooks.md +311 -0
  738. package/docs/zh-CN/cli/index.md +1032 -0
  739. package/docs/zh-CN/cli/logs.md +31 -0
  740. package/docs/zh-CN/cli/memory.md +52 -0
  741. package/docs/zh-CN/cli/message.md +246 -0
  742. package/docs/zh-CN/cli/models.md +85 -0
  743. package/docs/zh-CN/cli/node.md +115 -0
  744. package/docs/zh-CN/cli/nodes.md +80 -0
  745. package/docs/zh-CN/cli/onboard.md +36 -0
  746. package/docs/zh-CN/cli/pairing.md +28 -0
  747. package/docs/zh-CN/cli/plugins.md +66 -0
  748. package/docs/zh-CN/cli/reset.md +24 -0
  749. package/docs/zh-CN/cli/sandbox.md +158 -0
  750. package/docs/zh-CN/cli/security.md +33 -0
  751. package/docs/zh-CN/cli/sessions.md +23 -0
  752. package/docs/zh-CN/cli/setup.md +36 -0
  753. package/docs/zh-CN/cli/skills.md +33 -0
  754. package/docs/zh-CN/cli/status.md +33 -0
  755. package/docs/zh-CN/cli/system.md +63 -0
  756. package/docs/zh-CN/cli/tui.md +30 -0
  757. package/docs/zh-CN/cli/uninstall.md +24 -0
  758. package/docs/zh-CN/cli/update.md +101 -0
  759. package/docs/zh-CN/cli/voicecall.md +41 -0
  760. package/docs/zh-CN/cli/webhooks.md +32 -0
  761. package/docs/zh-CN/concepts/agent-loop.md +146 -0
  762. package/docs/zh-CN/concepts/agent-workspace.md +219 -0
  763. package/docs/zh-CN/concepts/agent.md +115 -0
  764. package/docs/zh-CN/concepts/architecture.md +123 -0
  765. package/docs/zh-CN/concepts/compaction.md +67 -0
  766. package/docs/zh-CN/concepts/context.md +168 -0
  767. package/docs/zh-CN/concepts/features.md +59 -0
  768. package/docs/zh-CN/concepts/markdown-formatting.md +117 -0
  769. package/docs/zh-CN/concepts/memory.md +412 -0
  770. package/docs/zh-CN/concepts/messages.md +141 -0
  771. package/docs/zh-CN/concepts/model-failover.md +145 -0
  772. package/docs/zh-CN/concepts/model-providers.md +320 -0
  773. package/docs/zh-CN/concepts/models.md +196 -0
  774. package/docs/zh-CN/concepts/multi-agent.md +372 -0
  775. package/docs/zh-CN/concepts/oauth.md +151 -0
  776. package/docs/zh-CN/concepts/presence.md +99 -0
  777. package/docs/zh-CN/concepts/queue.md +94 -0
  778. package/docs/zh-CN/concepts/retry.md +76 -0
  779. package/docs/zh-CN/concepts/session-pruning.md +129 -0
  780. package/docs/zh-CN/concepts/session-tool.md +200 -0
  781. package/docs/zh-CN/concepts/session.md +166 -0
  782. package/docs/zh-CN/concepts/sessions.md +17 -0
  783. package/docs/zh-CN/concepts/streaming.md +133 -0
  784. package/docs/zh-CN/concepts/system-prompt.md +101 -0
  785. package/docs/zh-CN/concepts/timezone.md +96 -0
  786. package/docs/zh-CN/concepts/typebox.md +284 -0
  787. package/docs/zh-CN/concepts/typing-indicators.md +74 -0
  788. package/docs/zh-CN/concepts/usage-tracking.md +42 -0
  789. package/docs/zh-CN/date-time.md +129 -0
  790. package/docs/zh-CN/debug/node-issue.md +90 -0
  791. package/docs/zh-CN/diagnostics/flags.md +98 -0
  792. package/docs/zh-CN/experiments/onboarding-config-protocol.md +47 -0
  793. package/docs/zh-CN/experiments/plans/cron-add-hardening.md +70 -0
  794. package/docs/zh-CN/experiments/plans/group-policy-hardening.md +45 -0
  795. package/docs/zh-CN/experiments/plans/openresponses-gateway.md +121 -0
  796. package/docs/zh-CN/experiments/proposals/model-config.md +42 -0
  797. package/docs/zh-CN/experiments/research/memory.md +235 -0
  798. package/docs/zh-CN/gateway/authentication.md +142 -0
  799. package/docs/zh-CN/gateway/background-process.md +100 -0
  800. package/docs/zh-CN/gateway/bonjour.md +174 -0
  801. package/docs/zh-CN/gateway/bridge-protocol.md +86 -0
  802. package/docs/zh-CN/gateway/cli-backends.md +213 -0
  803. package/docs/zh-CN/gateway/configuration-examples.md +587 -0
  804. package/docs/zh-CN/gateway/configuration.md +3332 -0
  805. package/docs/zh-CN/gateway/discovery.md +123 -0
  806. package/docs/zh-CN/gateway/doctor.md +238 -0
  807. package/docs/zh-CN/gateway/gateway-lock.md +41 -0
  808. package/docs/zh-CN/gateway/health.md +42 -0
  809. package/docs/zh-CN/gateway/heartbeat.md +274 -0
  810. package/docs/zh-CN/gateway/index.md +335 -0
  811. package/docs/zh-CN/gateway/local-models.md +157 -0
  812. package/docs/zh-CN/gateway/logging.md +114 -0
  813. package/docs/zh-CN/gateway/multiple-gateways.md +119 -0
  814. package/docs/zh-CN/gateway/network-model.md +23 -0
  815. package/docs/zh-CN/gateway/openai-http-api.md +125 -0
  816. package/docs/zh-CN/gateway/openresponses-http-api.md +317 -0
  817. package/docs/zh-CN/gateway/pairing.md +99 -0
  818. package/docs/zh-CN/gateway/protocol.md +220 -0
  819. package/docs/zh-CN/gateway/remote-gateway-readme.md +164 -0
  820. package/docs/zh-CN/gateway/remote.md +133 -0
  821. package/docs/zh-CN/gateway/sandbox-vs-tool-policy-vs-elevated.md +135 -0
  822. package/docs/zh-CN/gateway/sandboxing.md +188 -0
  823. package/docs/zh-CN/gateway/security/index.md +777 -0
  824. package/docs/zh-CN/gateway/tailscale.md +124 -0
  825. package/docs/zh-CN/gateway/tools-invoke-http-api.md +92 -0
  826. package/docs/zh-CN/gateway/troubleshooting.md +771 -0
  827. package/docs/zh-CN/help/debugging.md +160 -0
  828. package/docs/zh-CN/help/environment.md +88 -0
  829. package/docs/zh-CN/help/faq.md +2628 -0
  830. package/docs/zh-CN/help/index.md +28 -0
  831. package/docs/zh-CN/help/scripts.md +35 -0
  832. package/docs/zh-CN/help/submitting-a-pr.md +8 -0
  833. package/docs/zh-CN/help/submitting-an-issue.md +8 -0
  834. package/docs/zh-CN/help/testing.md +375 -0
  835. package/docs/zh-CN/help/troubleshooting.md +104 -0
  836. package/docs/zh-CN/hooks/soul-evil.md +72 -0
  837. package/docs/zh-CN/index.md +186 -0
  838. package/docs/zh-CN/install/ansible.md +215 -0
  839. package/docs/zh-CN/install/bun.md +65 -0
  840. package/docs/zh-CN/install/development-channels.md +81 -0
  841. package/docs/zh-CN/install/docker.md +532 -0
  842. package/docs/zh-CN/install/exe-dev.md +127 -0
  843. package/docs/zh-CN/install/fly.md +490 -0
  844. package/docs/zh-CN/install/gcp.md +510 -0
  845. package/docs/zh-CN/install/hetzner.md +337 -0
  846. package/docs/zh-CN/install/index.md +193 -0
  847. package/docs/zh-CN/install/installer.md +128 -0
  848. package/docs/zh-CN/install/macos-vm.md +288 -0
  849. package/docs/zh-CN/install/migrating.md +199 -0
  850. package/docs/zh-CN/install/nix.md +99 -0
  851. package/docs/zh-CN/install/node.md +8 -0
  852. package/docs/zh-CN/install/northflank.mdx +60 -0
  853. package/docs/zh-CN/install/railway.mdx +106 -0
  854. package/docs/zh-CN/install/render.mdx +169 -0
  855. package/docs/zh-CN/install/uninstall.md +135 -0
  856. package/docs/zh-CN/install/updating.md +233 -0
  857. package/docs/zh-CN/logging.md +329 -0
  858. package/docs/zh-CN/network.md +59 -0
  859. package/docs/zh-CN/nodes/audio.md +120 -0
  860. package/docs/zh-CN/nodes/camera.md +162 -0
  861. package/docs/zh-CN/nodes/images.md +79 -0
  862. package/docs/zh-CN/nodes/index.md +348 -0
  863. package/docs/zh-CN/nodes/location-command.md +120 -0
  864. package/docs/zh-CN/nodes/media-understanding.md +380 -0
  865. package/docs/zh-CN/nodes/talk.md +97 -0
  866. package/docs/zh-CN/nodes/troubleshooting.md +8 -0
  867. package/docs/zh-CN/nodes/voicewake.md +72 -0
  868. package/docs/zh-CN/perplexity.md +84 -0
  869. package/docs/zh-CN/pi-dev.md +77 -0
  870. package/docs/zh-CN/pi.md +619 -0
  871. package/docs/zh-CN/platforms/android.md +155 -0
  872. package/docs/zh-CN/platforms/digitalocean.md +269 -0
  873. package/docs/zh-CN/platforms/index.md +60 -0
  874. package/docs/zh-CN/platforms/ios.md +114 -0
  875. package/docs/zh-CN/platforms/linux.md +101 -0
  876. package/docs/zh-CN/platforms/mac/bundled-gateway.md +75 -0
  877. package/docs/zh-CN/platforms/mac/canvas.md +128 -0
  878. package/docs/zh-CN/platforms/mac/child-process.md +73 -0
  879. package/docs/zh-CN/platforms/mac/dev-setup.md +109 -0
  880. package/docs/zh-CN/platforms/mac/health.md +41 -0
  881. package/docs/zh-CN/platforms/mac/icon.md +38 -0
  882. package/docs/zh-CN/platforms/mac/logging.md +64 -0
  883. package/docs/zh-CN/platforms/mac/menu-bar.md +88 -0
  884. package/docs/zh-CN/platforms/mac/peekaboo.md +62 -0
  885. package/docs/zh-CN/platforms/mac/permissions.md +46 -0
  886. package/docs/zh-CN/platforms/mac/release.md +92 -0
  887. package/docs/zh-CN/platforms/mac/remote.md +90 -0
  888. package/docs/zh-CN/platforms/mac/signing.md +54 -0
  889. package/docs/zh-CN/platforms/mac/skills.md +40 -0
  890. package/docs/zh-CN/platforms/mac/voice-overlay.md +67 -0
  891. package/docs/zh-CN/platforms/mac/voicewake.md +74 -0
  892. package/docs/zh-CN/platforms/mac/webchat.md +43 -0
  893. package/docs/zh-CN/platforms/mac/xpc.md +68 -0
  894. package/docs/zh-CN/platforms/macos.md +193 -0
  895. package/docs/zh-CN/platforms/oracle.md +310 -0
  896. package/docs/zh-CN/platforms/raspberry-pi.md +365 -0
  897. package/docs/zh-CN/platforms/windows.md +156 -0
  898. package/docs/zh-CN/plugins/agent-tools.md +99 -0
  899. package/docs/zh-CN/plugins/manifest.md +68 -0
  900. package/docs/zh-CN/plugins/voice-call.md +250 -0
  901. package/docs/zh-CN/plugins/zalouser.md +88 -0
  902. package/docs/zh-CN/prose.md +141 -0
  903. package/docs/zh-CN/providers/anthropic.md +159 -0
  904. package/docs/zh-CN/providers/bedrock.md +170 -0
  905. package/docs/zh-CN/providers/claude-max-api-proxy.md +155 -0
  906. package/docs/zh-CN/providers/deepgram.md +97 -0
  907. package/docs/zh-CN/providers/github-copilot.md +67 -0
  908. package/docs/zh-CN/providers/glm.md +39 -0
  909. package/docs/zh-CN/providers/index.md +68 -0
  910. package/docs/zh-CN/providers/minimax.md +206 -0
  911. package/docs/zh-CN/providers/models.md +55 -0
  912. package/docs/zh-CN/providers/moonshot.md +145 -0
  913. package/docs/zh-CN/providers/ollama.md +230 -0
  914. package/docs/zh-CN/providers/openai.md +68 -0
  915. package/docs/zh-CN/providers/opencode.md +41 -0
  916. package/docs/zh-CN/providers/openrouter.md +43 -0
  917. package/docs/zh-CN/providers/qianfan.md +8 -0
  918. package/docs/zh-CN/providers/qwen.md +55 -0
  919. package/docs/zh-CN/providers/synthetic.md +102 -0
  920. package/docs/zh-CN/providers/venice.md +274 -0
  921. package/docs/zh-CN/providers/vercel-ai-gateway.md +57 -0
  922. package/docs/zh-CN/providers/xiaomi.md +68 -0
  923. package/docs/zh-CN/providers/zai.md +41 -0
  924. package/docs/zh-CN/refactor/clawnet.md +424 -0
  925. package/docs/zh-CN/refactor/exec-host.md +323 -0
  926. package/docs/zh-CN/refactor/outbound-session-mirroring.md +92 -0
  927. package/docs/zh-CN/refactor/plugin-sdk.md +221 -0
  928. package/docs/zh-CN/refactor/strict-config.md +100 -0
  929. package/docs/zh-CN/reference/AGENTS.default.md +131 -0
  930. package/docs/zh-CN/reference/RELEASING.md +123 -0
  931. package/docs/zh-CN/reference/api-usage-costs.md +136 -0
  932. package/docs/zh-CN/reference/credits.md +34 -0
  933. package/docs/zh-CN/reference/device-models.md +54 -0
  934. package/docs/zh-CN/reference/rpc.md +48 -0
  935. package/docs/zh-CN/reference/session-management-compaction.md +287 -0
  936. package/docs/zh-CN/reference/templates/AGENTS.dev.md +89 -0
  937. package/docs/zh-CN/reference/templates/AGENTS.md +225 -0
  938. package/docs/zh-CN/reference/templates/BOOT.md +17 -0
  939. package/docs/zh-CN/reference/templates/BOOTSTRAP.md +68 -0
  940. package/docs/zh-CN/reference/templates/HEARTBEAT.md +18 -0
  941. package/docs/zh-CN/reference/templates/IDENTITY.dev.md +54 -0
  942. package/docs/zh-CN/reference/templates/IDENTITY.md +36 -0
  943. package/docs/zh-CN/reference/templates/SOUL.dev.md +83 -0
  944. package/docs/zh-CN/reference/templates/SOUL.md +49 -0
  945. package/docs/zh-CN/reference/templates/TOOLS.dev.md +31 -0
  946. package/docs/zh-CN/reference/templates/TOOLS.md +53 -0
  947. package/docs/zh-CN/reference/templates/USER.dev.md +25 -0
  948. package/docs/zh-CN/reference/templates/USER.md +30 -0
  949. package/docs/zh-CN/reference/test.md +57 -0
  950. package/docs/zh-CN/reference/token-use.md +119 -0
  951. package/docs/zh-CN/reference/transcript-hygiene.md +109 -0
  952. package/docs/zh-CN/reference/wizard.md +9 -0
  953. package/docs/zh-CN/security/formal-verification.md +171 -0
  954. package/docs/zh-CN/start/bootstrapping.md +9 -0
  955. package/docs/zh-CN/start/docs-directory.md +70 -0
  956. package/docs/zh-CN/start/getting-started.md +206 -0
  957. package/docs/zh-CN/start/hubs.md +200 -0
  958. package/docs/zh-CN/start/lore.md +226 -0
  959. package/docs/zh-CN/start/onboarding.md +105 -0
  960. package/docs/zh-CN/start/openclaw.md +248 -0
  961. package/docs/zh-CN/start/quickstart.md +88 -0
  962. package/docs/zh-CN/start/setup.md +153 -0
  963. package/docs/zh-CN/start/showcase.md +423 -0
  964. package/docs/zh-CN/start/wizard.md +331 -0
  965. package/docs/zh-CN/tools/agent-send.md +59 -0
  966. package/docs/zh-CN/tools/apply-patch.md +57 -0
  967. package/docs/zh-CN/tools/browser-linux-troubleshooting.md +144 -0
  968. package/docs/zh-CN/tools/browser-login.md +75 -0
  969. package/docs/zh-CN/tools/browser.md +553 -0
  970. package/docs/zh-CN/tools/chrome-extension.md +183 -0
  971. package/docs/zh-CN/tools/clawhub.md +209 -0
  972. package/docs/zh-CN/tools/creating-skills.md +61 -0
  973. package/docs/zh-CN/tools/elevated.md +64 -0
  974. package/docs/zh-CN/tools/exec-approvals.md +234 -0
  975. package/docs/zh-CN/tools/exec.md +169 -0
  976. package/docs/zh-CN/tools/firecrawl.md +68 -0
  977. package/docs/zh-CN/tools/index.md +515 -0
  978. package/docs/zh-CN/tools/llm-task.md +117 -0
  979. package/docs/zh-CN/tools/lobster.md +349 -0
  980. package/docs/zh-CN/tools/multi-agent-sandbox-tools.md +401 -0
  981. package/docs/zh-CN/tools/plugin.md +639 -0
  982. package/docs/zh-CN/tools/reactions.md +29 -0
  983. package/docs/zh-CN/tools/skills-config.md +78 -0
  984. package/docs/zh-CN/tools/skills.md +279 -0
  985. package/docs/zh-CN/tools/slash-commands.md +205 -0
  986. package/docs/zh-CN/tools/subagents.md +156 -0
  987. package/docs/zh-CN/tools/thinking.md +80 -0
  988. package/docs/zh-CN/tools/web.md +257 -0
  989. package/docs/zh-CN/tts.md +375 -0
  990. package/docs/zh-CN/vps.md +47 -0
  991. package/docs/zh-CN/web/control-ui.md +191 -0
  992. package/docs/zh-CN/web/dashboard.md +53 -0
  993. package/docs/zh-CN/web/index.md +118 -0
  994. package/docs/zh-CN/web/tui.md +166 -0
  995. package/docs/zh-CN/web/webchat.md +56 -0
  996. package/extensions/bluebubbles/README.md +45 -0
  997. package/extensions/bluebubbles/index.ts +19 -0
  998. package/extensions/bluebubbles/node_modules/.bin/clawdbot +21 -0
  999. package/extensions/bluebubbles/node_modules/.bin/clawdbot.CMD +12 -0
  1000. package/extensions/bluebubbles/node_modules/.bin/clawdbot.ps1 +41 -0
  1001. package/extensions/bluebubbles/node_modules/.bin/openclaw +21 -0
  1002. package/extensions/bluebubbles/node_modules/.bin/openclaw.CMD +12 -0
  1003. package/extensions/bluebubbles/node_modules/.bin/openclaw.ps1 +41 -0
  1004. package/extensions/bluebubbles/node_modules/.bin/synurex +21 -0
  1005. package/extensions/bluebubbles/node_modules/.bin/synurex.CMD +12 -0
  1006. package/extensions/bluebubbles/node_modules/.bin/synurex.ps1 +41 -0
  1007. package/extensions/bluebubbles/package.json +36 -0
  1008. package/extensions/bluebubbles/src/accounts.ts +88 -0
  1009. package/extensions/bluebubbles/src/actions.test.ts +650 -0
  1010. package/extensions/bluebubbles/src/actions.ts +438 -0
  1011. package/extensions/bluebubbles/src/attachments.test.ts +345 -0
  1012. package/extensions/bluebubbles/src/attachments.ts +302 -0
  1013. package/extensions/bluebubbles/src/channel.ts +414 -0
  1014. package/extensions/bluebubbles/src/chat.test.ts +461 -0
  1015. package/extensions/bluebubbles/src/chat.ts +382 -0
  1016. package/extensions/bluebubbles/src/config-schema.ts +51 -0
  1017. package/extensions/bluebubbles/src/media-send.ts +174 -0
  1018. package/extensions/bluebubbles/src/monitor.test.ts +2384 -0
  1019. package/extensions/bluebubbles/src/monitor.ts +2517 -0
  1020. package/extensions/bluebubbles/src/onboarding.ts +352 -0
  1021. package/extensions/bluebubbles/src/probe.ts +144 -0
  1022. package/extensions/bluebubbles/src/reactions.test.ts +392 -0
  1023. package/extensions/bluebubbles/src/reactions.ts +188 -0
  1024. package/extensions/bluebubbles/src/runtime.ts +14 -0
  1025. package/extensions/bluebubbles/src/send.test.ts +889 -0
  1026. package/extensions/bluebubbles/src/send.ts +474 -0
  1027. package/extensions/bluebubbles/src/targets.test.ts +183 -0
  1028. package/extensions/bluebubbles/src/targets.ts +422 -0
  1029. package/extensions/bluebubbles/src/types.ts +127 -0
  1030. package/extensions/bluebubbles/synurex.plugin.json +9 -0
  1031. package/extensions/copilot-proxy/README.md +24 -0
  1032. package/extensions/copilot-proxy/index.ts +149 -0
  1033. package/extensions/copilot-proxy/node_modules/.bin/clawdbot +21 -0
  1034. package/extensions/copilot-proxy/node_modules/.bin/clawdbot.CMD +12 -0
  1035. package/extensions/copilot-proxy/node_modules/.bin/clawdbot.ps1 +41 -0
  1036. package/extensions/copilot-proxy/node_modules/.bin/openclaw +21 -0
  1037. package/extensions/copilot-proxy/node_modules/.bin/openclaw.CMD +12 -0
  1038. package/extensions/copilot-proxy/node_modules/.bin/openclaw.ps1 +41 -0
  1039. package/extensions/copilot-proxy/node_modules/.bin/synurex +21 -0
  1040. package/extensions/copilot-proxy/node_modules/.bin/synurex.CMD +12 -0
  1041. package/extensions/copilot-proxy/node_modules/.bin/synurex.ps1 +41 -0
  1042. package/extensions/copilot-proxy/package.json +14 -0
  1043. package/extensions/copilot-proxy/synurex.plugin.json +9 -0
  1044. package/extensions/diagnostics-otel/index.ts +15 -0
  1045. package/extensions/diagnostics-otel/node_modules/.bin/clawdbot +21 -0
  1046. package/extensions/diagnostics-otel/node_modules/.bin/clawdbot.CMD +12 -0
  1047. package/extensions/diagnostics-otel/node_modules/.bin/clawdbot.ps1 +41 -0
  1048. package/extensions/diagnostics-otel/node_modules/.bin/openclaw +21 -0
  1049. package/extensions/diagnostics-otel/node_modules/.bin/openclaw.CMD +12 -0
  1050. package/extensions/diagnostics-otel/node_modules/.bin/openclaw.ps1 +41 -0
  1051. package/extensions/diagnostics-otel/node_modules/.bin/synurex +21 -0
  1052. package/extensions/diagnostics-otel/node_modules/.bin/synurex.CMD +12 -0
  1053. package/extensions/diagnostics-otel/node_modules/.bin/synurex.ps1 +41 -0
  1054. package/extensions/diagnostics-otel/package.json +27 -0
  1055. package/extensions/diagnostics-otel/src/service.test.ts +226 -0
  1056. package/extensions/diagnostics-otel/src/service.ts +635 -0
  1057. package/extensions/diagnostics-otel/synurex.plugin.json +8 -0
  1058. package/extensions/discord/index.ts +17 -0
  1059. package/extensions/discord/node_modules/.bin/clawdbot +21 -0
  1060. package/extensions/discord/node_modules/.bin/clawdbot.CMD +12 -0
  1061. package/extensions/discord/node_modules/.bin/clawdbot.ps1 +41 -0
  1062. package/extensions/discord/node_modules/.bin/openclaw +21 -0
  1063. package/extensions/discord/node_modules/.bin/openclaw.CMD +12 -0
  1064. package/extensions/discord/node_modules/.bin/openclaw.ps1 +41 -0
  1065. package/extensions/discord/node_modules/.bin/synurex +21 -0
  1066. package/extensions/discord/node_modules/.bin/synurex.CMD +12 -0
  1067. package/extensions/discord/node_modules/.bin/synurex.ps1 +41 -0
  1068. package/extensions/discord/package.json +14 -0
  1069. package/extensions/discord/src/channel.ts +422 -0
  1070. package/extensions/discord/src/runtime.ts +14 -0
  1071. package/extensions/discord/synurex.plugin.json +9 -0
  1072. package/extensions/feishu/index.ts +63 -0
  1073. package/extensions/feishu/node_modules/.bin/clawdbot +21 -0
  1074. package/extensions/feishu/node_modules/.bin/clawdbot.CMD +12 -0
  1075. package/extensions/feishu/node_modules/.bin/clawdbot.ps1 +41 -0
  1076. package/extensions/feishu/node_modules/.bin/openclaw +21 -0
  1077. package/extensions/feishu/node_modules/.bin/openclaw.CMD +12 -0
  1078. package/extensions/feishu/node_modules/.bin/openclaw.ps1 +41 -0
  1079. package/extensions/feishu/node_modules/.bin/synurex +21 -0
  1080. package/extensions/feishu/node_modules/.bin/synurex.CMD +12 -0
  1081. package/extensions/feishu/node_modules/.bin/synurex.ps1 +41 -0
  1082. package/extensions/feishu/package.json +37 -0
  1083. package/extensions/feishu/skills/feishu-doc/SKILL.md +105 -0
  1084. package/extensions/feishu/skills/feishu-doc/references/block-types.md +103 -0
  1085. package/extensions/feishu/skills/feishu-drive/SKILL.md +97 -0
  1086. package/extensions/feishu/skills/feishu-perm/SKILL.md +119 -0
  1087. package/extensions/feishu/skills/feishu-wiki/SKILL.md +111 -0
  1088. package/extensions/feishu/src/accounts.ts +144 -0
  1089. package/extensions/feishu/src/bitable.ts +459 -0
  1090. package/extensions/feishu/src/bot.ts +871 -0
  1091. package/extensions/feishu/src/channel.ts +341 -0
  1092. package/extensions/feishu/src/client.ts +118 -0
  1093. package/extensions/feishu/src/config-schema.ts +172 -0
  1094. package/extensions/feishu/src/directory.ts +177 -0
  1095. package/extensions/feishu/src/doc-schema.ts +47 -0
  1096. package/extensions/feishu/src/docx.ts +521 -0
  1097. package/extensions/feishu/src/drive-schema.ts +46 -0
  1098. package/extensions/feishu/src/drive.ts +227 -0
  1099. package/extensions/feishu/src/media.ts +527 -0
  1100. package/extensions/feishu/src/mention.ts +126 -0
  1101. package/extensions/feishu/src/monitor.ts +190 -0
  1102. package/extensions/feishu/src/onboarding.ts +356 -0
  1103. package/extensions/feishu/src/outbound.ts +40 -0
  1104. package/extensions/feishu/src/perm-schema.ts +52 -0
  1105. package/extensions/feishu/src/perm.ts +173 -0
  1106. package/extensions/feishu/src/policy.ts +104 -0
  1107. package/extensions/feishu/src/probe.ts +44 -0
  1108. package/extensions/feishu/src/reactions.ts +160 -0
  1109. package/extensions/feishu/src/reply-dispatcher.ts +184 -0
  1110. package/extensions/feishu/src/runtime.ts +14 -0
  1111. package/extensions/feishu/src/send.ts +358 -0
  1112. package/extensions/feishu/src/targets.ts +78 -0
  1113. package/extensions/feishu/src/tools-config.ts +21 -0
  1114. package/extensions/feishu/src/types.ts +75 -0
  1115. package/extensions/feishu/src/typing.ts +80 -0
  1116. package/extensions/feishu/src/wiki-schema.ts +55 -0
  1117. package/extensions/feishu/src/wiki.ts +232 -0
  1118. package/extensions/feishu/synurex.plugin.json +10 -0
  1119. package/extensions/google-antigravity-auth/README.md +24 -0
  1120. package/extensions/google-antigravity-auth/index.ts +461 -0
  1121. package/extensions/google-antigravity-auth/node_modules/.bin/clawdbot +21 -0
  1122. package/extensions/google-antigravity-auth/node_modules/.bin/clawdbot.CMD +12 -0
  1123. package/extensions/google-antigravity-auth/node_modules/.bin/clawdbot.ps1 +41 -0
  1124. package/extensions/google-antigravity-auth/node_modules/.bin/openclaw +21 -0
  1125. package/extensions/google-antigravity-auth/node_modules/.bin/openclaw.CMD +12 -0
  1126. package/extensions/google-antigravity-auth/node_modules/.bin/openclaw.ps1 +41 -0
  1127. package/extensions/google-antigravity-auth/node_modules/.bin/synurex +21 -0
  1128. package/extensions/google-antigravity-auth/node_modules/.bin/synurex.CMD +12 -0
  1129. package/extensions/google-antigravity-auth/node_modules/.bin/synurex.ps1 +41 -0
  1130. package/extensions/google-antigravity-auth/package.json +14 -0
  1131. package/extensions/google-antigravity-auth/synurex.plugin.json +9 -0
  1132. package/extensions/google-gemini-cli-auth/README.md +35 -0
  1133. package/extensions/google-gemini-cli-auth/index.ts +88 -0
  1134. package/extensions/google-gemini-cli-auth/node_modules/.bin/clawdbot +21 -0
  1135. package/extensions/google-gemini-cli-auth/node_modules/.bin/clawdbot.CMD +12 -0
  1136. package/extensions/google-gemini-cli-auth/node_modules/.bin/clawdbot.ps1 +41 -0
  1137. package/extensions/google-gemini-cli-auth/node_modules/.bin/openclaw +21 -0
  1138. package/extensions/google-gemini-cli-auth/node_modules/.bin/openclaw.CMD +12 -0
  1139. package/extensions/google-gemini-cli-auth/node_modules/.bin/openclaw.ps1 +41 -0
  1140. package/extensions/google-gemini-cli-auth/node_modules/.bin/synurex +21 -0
  1141. package/extensions/google-gemini-cli-auth/node_modules/.bin/synurex.CMD +12 -0
  1142. package/extensions/google-gemini-cli-auth/node_modules/.bin/synurex.ps1 +41 -0
  1143. package/extensions/google-gemini-cli-auth/oauth.test.ts +240 -0
  1144. package/extensions/google-gemini-cli-auth/oauth.ts +662 -0
  1145. package/extensions/google-gemini-cli-auth/package.json +14 -0
  1146. package/extensions/google-gemini-cli-auth/synurex.plugin.json +9 -0
  1147. package/extensions/googlechat/index.ts +19 -0
  1148. package/extensions/googlechat/node_modules/.bin/clawdbot +21 -0
  1149. package/extensions/googlechat/node_modules/.bin/clawdbot.CMD +12 -0
  1150. package/extensions/googlechat/node_modules/.bin/clawdbot.ps1 +41 -0
  1151. package/extensions/googlechat/node_modules/.bin/openclaw +21 -0
  1152. package/extensions/googlechat/node_modules/.bin/openclaw.CMD +12 -0
  1153. package/extensions/googlechat/node_modules/.bin/openclaw.ps1 +41 -0
  1154. package/extensions/googlechat/node_modules/.bin/synurex +21 -0
  1155. package/extensions/googlechat/node_modules/.bin/synurex.CMD +12 -0
  1156. package/extensions/googlechat/node_modules/.bin/synurex.ps1 +41 -0
  1157. package/extensions/googlechat/package.json +39 -0
  1158. package/extensions/googlechat/src/accounts.ts +147 -0
  1159. package/extensions/googlechat/src/actions.ts +181 -0
  1160. package/extensions/googlechat/src/api.test.ts +61 -0
  1161. package/extensions/googlechat/src/api.ts +282 -0
  1162. package/extensions/googlechat/src/auth.ts +137 -0
  1163. package/extensions/googlechat/src/channel.ts +583 -0
  1164. package/extensions/googlechat/src/monitor.test.ts +22 -0
  1165. package/extensions/googlechat/src/monitor.ts +960 -0
  1166. package/extensions/googlechat/src/onboarding.ts +269 -0
  1167. package/extensions/googlechat/src/runtime.ts +14 -0
  1168. package/extensions/googlechat/src/targets.test.ts +32 -0
  1169. package/extensions/googlechat/src/targets.ts +65 -0
  1170. package/extensions/googlechat/src/types.config.ts +3 -0
  1171. package/extensions/googlechat/src/types.ts +73 -0
  1172. package/extensions/googlechat/synurex.plugin.json +9 -0
  1173. package/extensions/imessage/index.ts +17 -0
  1174. package/extensions/imessage/node_modules/.bin/clawdbot +21 -0
  1175. package/extensions/imessage/node_modules/.bin/clawdbot.CMD +12 -0
  1176. package/extensions/imessage/node_modules/.bin/clawdbot.ps1 +41 -0
  1177. package/extensions/imessage/node_modules/.bin/openclaw +21 -0
  1178. package/extensions/imessage/node_modules/.bin/openclaw.CMD +12 -0
  1179. package/extensions/imessage/node_modules/.bin/openclaw.ps1 +41 -0
  1180. package/extensions/imessage/node_modules/.bin/synurex +21 -0
  1181. package/extensions/imessage/node_modules/.bin/synurex.CMD +12 -0
  1182. package/extensions/imessage/node_modules/.bin/synurex.ps1 +41 -0
  1183. package/extensions/imessage/package.json +14 -0
  1184. package/extensions/imessage/src/channel.ts +294 -0
  1185. package/extensions/imessage/src/runtime.ts +14 -0
  1186. package/extensions/imessage/synurex.plugin.json +9 -0
  1187. package/extensions/line/index.ts +19 -0
  1188. package/extensions/line/node_modules/.bin/clawdbot +21 -0
  1189. package/extensions/line/node_modules/.bin/clawdbot.CMD +12 -0
  1190. package/extensions/line/node_modules/.bin/clawdbot.ps1 +41 -0
  1191. package/extensions/line/node_modules/.bin/openclaw +21 -0
  1192. package/extensions/line/node_modules/.bin/openclaw.CMD +12 -0
  1193. package/extensions/line/node_modules/.bin/openclaw.ps1 +41 -0
  1194. package/extensions/line/node_modules/.bin/synurex +21 -0
  1195. package/extensions/line/node_modules/.bin/synurex.CMD +12 -0
  1196. package/extensions/line/node_modules/.bin/synurex.ps1 +41 -0
  1197. package/extensions/line/package.json +29 -0
  1198. package/extensions/line/src/card-command.ts +344 -0
  1199. package/extensions/line/src/channel.logout.test.ts +99 -0
  1200. package/extensions/line/src/channel.sendPayload.test.ts +306 -0
  1201. package/extensions/line/src/channel.ts +780 -0
  1202. package/extensions/line/src/runtime.ts +14 -0
  1203. package/extensions/line/synurex.plugin.json +9 -0
  1204. package/extensions/llm-task/README.md +97 -0
  1205. package/extensions/llm-task/index.ts +6 -0
  1206. package/extensions/llm-task/node_modules/.bin/clawdbot +21 -0
  1207. package/extensions/llm-task/node_modules/.bin/clawdbot.CMD +12 -0
  1208. package/extensions/llm-task/node_modules/.bin/clawdbot.ps1 +41 -0
  1209. package/extensions/llm-task/node_modules/.bin/openclaw +21 -0
  1210. package/extensions/llm-task/node_modules/.bin/openclaw.CMD +12 -0
  1211. package/extensions/llm-task/node_modules/.bin/openclaw.ps1 +41 -0
  1212. package/extensions/llm-task/node_modules/.bin/synurex +21 -0
  1213. package/extensions/llm-task/node_modules/.bin/synurex.CMD +12 -0
  1214. package/extensions/llm-task/node_modules/.bin/synurex.ps1 +41 -0
  1215. package/extensions/llm-task/package.json +14 -0
  1216. package/extensions/llm-task/src/llm-task-tool.test.ts +138 -0
  1217. package/extensions/llm-task/src/llm-task-tool.ts +245 -0
  1218. package/extensions/llm-task/synurex.plugin.json +21 -0
  1219. package/extensions/lobster/README.md +75 -0
  1220. package/extensions/lobster/SKILL.md +97 -0
  1221. package/extensions/lobster/index.ts +14 -0
  1222. package/extensions/lobster/node_modules/.bin/clawdbot +21 -0
  1223. package/extensions/lobster/node_modules/.bin/clawdbot.CMD +12 -0
  1224. package/extensions/lobster/node_modules/.bin/clawdbot.ps1 +41 -0
  1225. package/extensions/lobster/node_modules/.bin/openclaw +21 -0
  1226. package/extensions/lobster/node_modules/.bin/openclaw.CMD +12 -0
  1227. package/extensions/lobster/node_modules/.bin/openclaw.ps1 +41 -0
  1228. package/extensions/lobster/node_modules/.bin/synurex +21 -0
  1229. package/extensions/lobster/node_modules/.bin/synurex.CMD +12 -0
  1230. package/extensions/lobster/node_modules/.bin/synurex.ps1 +41 -0
  1231. package/extensions/lobster/package.json +14 -0
  1232. package/extensions/lobster/src/lobster-tool.test.ts +247 -0
  1233. package/extensions/lobster/src/lobster-tool.ts +328 -0
  1234. package/extensions/lobster/synurex.plugin.json +10 -0
  1235. package/extensions/matrix/CHANGELOG.md +111 -0
  1236. package/extensions/matrix/index.ts +17 -0
  1237. package/extensions/matrix/node_modules/.bin/clawdbot +21 -0
  1238. package/extensions/matrix/node_modules/.bin/clawdbot.CMD +12 -0
  1239. package/extensions/matrix/node_modules/.bin/clawdbot.ps1 +41 -0
  1240. package/extensions/matrix/node_modules/.bin/markdown-it +21 -0
  1241. package/extensions/matrix/node_modules/.bin/markdown-it.CMD +12 -0
  1242. package/extensions/matrix/node_modules/.bin/markdown-it.ps1 +41 -0
  1243. package/extensions/matrix/node_modules/.bin/openclaw +21 -0
  1244. package/extensions/matrix/node_modules/.bin/openclaw.CMD +12 -0
  1245. package/extensions/matrix/node_modules/.bin/openclaw.ps1 +41 -0
  1246. package/extensions/matrix/node_modules/.bin/synurex +21 -0
  1247. package/extensions/matrix/node_modules/.bin/synurex.CMD +12 -0
  1248. package/extensions/matrix/node_modules/.bin/synurex.ps1 +41 -0
  1249. package/extensions/matrix/package.json +36 -0
  1250. package/extensions/matrix/src/actions.ts +195 -0
  1251. package/extensions/matrix/src/channel.directory.test.ts +64 -0
  1252. package/extensions/matrix/src/channel.ts +439 -0
  1253. package/extensions/matrix/src/config-schema.ts +63 -0
  1254. package/extensions/matrix/src/directory-live.ts +188 -0
  1255. package/extensions/matrix/src/group-mentions.ts +66 -0
  1256. package/extensions/matrix/src/matrix/accounts.test.ts +82 -0
  1257. package/extensions/matrix/src/matrix/accounts.ts +65 -0
  1258. package/extensions/matrix/src/matrix/actions/client.ts +57 -0
  1259. package/extensions/matrix/src/matrix/actions/messages.ts +128 -0
  1260. package/extensions/matrix/src/matrix/actions/pins.ts +76 -0
  1261. package/extensions/matrix/src/matrix/actions/reactions.ts +96 -0
  1262. package/extensions/matrix/src/matrix/actions/room.ts +85 -0
  1263. package/extensions/matrix/src/matrix/actions/summary.ts +75 -0
  1264. package/extensions/matrix/src/matrix/actions/types.ts +84 -0
  1265. package/extensions/matrix/src/matrix/actions.ts +15 -0
  1266. package/extensions/matrix/src/matrix/active-client.ts +11 -0
  1267. package/extensions/matrix/src/matrix/client/config.ts +160 -0
  1268. package/extensions/matrix/src/matrix/client/create-client.ts +123 -0
  1269. package/extensions/matrix/src/matrix/client/logging.ts +36 -0
  1270. package/extensions/matrix/src/matrix/client/runtime.ts +4 -0
  1271. package/extensions/matrix/src/matrix/client/shared.ts +170 -0
  1272. package/extensions/matrix/src/matrix/client/storage.ts +131 -0
  1273. package/extensions/matrix/src/matrix/client/types.ts +34 -0
  1274. package/extensions/matrix/src/matrix/client.test.ts +56 -0
  1275. package/extensions/matrix/src/matrix/client.ts +5 -0
  1276. package/extensions/matrix/src/matrix/credentials.ts +105 -0
  1277. package/extensions/matrix/src/matrix/deps.ts +60 -0
  1278. package/extensions/matrix/src/matrix/format.test.ts +33 -0
  1279. package/extensions/matrix/src/matrix/format.ts +22 -0
  1280. package/extensions/matrix/src/matrix/index.ts +11 -0
  1281. package/extensions/matrix/src/matrix/monitor/allowlist.test.ts +45 -0
  1282. package/extensions/matrix/src/matrix/monitor/allowlist.ts +103 -0
  1283. package/extensions/matrix/src/matrix/monitor/auto-join.ts +71 -0
  1284. package/extensions/matrix/src/matrix/monitor/direct.ts +104 -0
  1285. package/extensions/matrix/src/matrix/monitor/events.ts +101 -0
  1286. package/extensions/matrix/src/matrix/monitor/handler.ts +665 -0
  1287. package/extensions/matrix/src/matrix/monitor/index.ts +338 -0
  1288. package/extensions/matrix/src/matrix/monitor/location.ts +100 -0
  1289. package/extensions/matrix/src/matrix/monitor/media.test.ts +102 -0
  1290. package/extensions/matrix/src/matrix/monitor/media.ts +113 -0
  1291. package/extensions/matrix/src/matrix/monitor/mentions.ts +31 -0
  1292. package/extensions/matrix/src/matrix/monitor/replies.ts +97 -0
  1293. package/extensions/matrix/src/matrix/monitor/room-info.ts +55 -0
  1294. package/extensions/matrix/src/matrix/monitor/rooms.test.ts +39 -0
  1295. package/extensions/matrix/src/matrix/monitor/rooms.ts +47 -0
  1296. package/extensions/matrix/src/matrix/monitor/threads.ts +68 -0
  1297. package/extensions/matrix/src/matrix/monitor/types.ts +39 -0
  1298. package/extensions/matrix/src/matrix/poll-types.test.ts +21 -0
  1299. package/extensions/matrix/src/matrix/poll-types.ts +166 -0
  1300. package/extensions/matrix/src/matrix/probe.ts +70 -0
  1301. package/extensions/matrix/src/matrix/send/client.ts +66 -0
  1302. package/extensions/matrix/src/matrix/send/formatting.ts +89 -0
  1303. package/extensions/matrix/src/matrix/send/media.ts +229 -0
  1304. package/extensions/matrix/src/matrix/send/targets.test.ts +98 -0
  1305. package/extensions/matrix/src/matrix/send/targets.ts +147 -0
  1306. package/extensions/matrix/src/matrix/send/types.ts +109 -0
  1307. package/extensions/matrix/src/matrix/send.test.ts +171 -0
  1308. package/extensions/matrix/src/matrix/send.ts +260 -0
  1309. package/extensions/matrix/src/onboarding.ts +449 -0
  1310. package/extensions/matrix/src/outbound.ts +52 -0
  1311. package/extensions/matrix/src/resolve-targets.test.ts +48 -0
  1312. package/extensions/matrix/src/resolve-targets.ts +135 -0
  1313. package/extensions/matrix/src/runtime.ts +14 -0
  1314. package/extensions/matrix/src/tool-actions.ts +164 -0
  1315. package/extensions/matrix/src/types.ts +97 -0
  1316. package/extensions/matrix/synurex.plugin.json +9 -0
  1317. package/extensions/mattermost/index.ts +17 -0
  1318. package/extensions/mattermost/node_modules/.bin/clawdbot +21 -0
  1319. package/extensions/mattermost/node_modules/.bin/clawdbot.CMD +12 -0
  1320. package/extensions/mattermost/node_modules/.bin/clawdbot.ps1 +41 -0
  1321. package/extensions/mattermost/node_modules/.bin/openclaw +21 -0
  1322. package/extensions/mattermost/node_modules/.bin/openclaw.CMD +12 -0
  1323. package/extensions/mattermost/node_modules/.bin/openclaw.ps1 +41 -0
  1324. package/extensions/mattermost/node_modules/.bin/synurex +21 -0
  1325. package/extensions/mattermost/node_modules/.bin/synurex.CMD +12 -0
  1326. package/extensions/mattermost/node_modules/.bin/synurex.ps1 +41 -0
  1327. package/extensions/mattermost/package.json +28 -0
  1328. package/extensions/mattermost/src/channel.test.ts +72 -0
  1329. package/extensions/mattermost/src/channel.ts +337 -0
  1330. package/extensions/mattermost/src/config-schema.ts +56 -0
  1331. package/extensions/mattermost/src/group-mentions.ts +15 -0
  1332. package/extensions/mattermost/src/mattermost/accounts.ts +128 -0
  1333. package/extensions/mattermost/src/mattermost/client.ts +220 -0
  1334. package/extensions/mattermost/src/mattermost/index.ts +9 -0
  1335. package/extensions/mattermost/src/mattermost/monitor-helpers.ts +166 -0
  1336. package/extensions/mattermost/src/mattermost/monitor.ts +991 -0
  1337. package/extensions/mattermost/src/mattermost/probe.ts +74 -0
  1338. package/extensions/mattermost/src/mattermost/send.ts +231 -0
  1339. package/extensions/mattermost/src/normalize.ts +46 -0
  1340. package/extensions/mattermost/src/onboarding-helpers.ts +44 -0
  1341. package/extensions/mattermost/src/onboarding.ts +186 -0
  1342. package/extensions/mattermost/src/runtime.ts +14 -0
  1343. package/extensions/mattermost/src/types.ts +52 -0
  1344. package/extensions/mattermost/synurex.plugin.json +9 -0
  1345. package/extensions/memory-core/index.ts +38 -0
  1346. package/extensions/memory-core/node_modules/.bin/clawdbot +21 -0
  1347. package/extensions/memory-core/node_modules/.bin/clawdbot.CMD +12 -0
  1348. package/extensions/memory-core/node_modules/.bin/clawdbot.ps1 +41 -0
  1349. package/extensions/memory-core/node_modules/.bin/openclaw +21 -0
  1350. package/extensions/memory-core/node_modules/.bin/openclaw.CMD +12 -0
  1351. package/extensions/memory-core/node_modules/.bin/openclaw.ps1 +41 -0
  1352. package/extensions/memory-core/node_modules/.bin/synurex +21 -0
  1353. package/extensions/memory-core/node_modules/.bin/synurex.CMD +12 -0
  1354. package/extensions/memory-core/node_modules/.bin/synurex.ps1 +41 -0
  1355. package/extensions/memory-core/package.json +17 -0
  1356. package/extensions/memory-core/synurex.plugin.json +9 -0
  1357. package/extensions/memory-lancedb/config.ts +139 -0
  1358. package/extensions/memory-lancedb/index.test.ts +253 -0
  1359. package/extensions/memory-lancedb/index.ts +622 -0
  1360. package/extensions/memory-lancedb/node_modules/.bin/clawdbot +21 -0
  1361. package/extensions/memory-lancedb/node_modules/.bin/clawdbot.CMD +12 -0
  1362. package/extensions/memory-lancedb/node_modules/.bin/clawdbot.ps1 +41 -0
  1363. package/extensions/memory-lancedb/node_modules/.bin/openai +21 -0
  1364. package/extensions/memory-lancedb/node_modules/.bin/openai.CMD +12 -0
  1365. package/extensions/memory-lancedb/node_modules/.bin/openai.ps1 +41 -0
  1366. package/extensions/memory-lancedb/node_modules/.bin/openclaw +21 -0
  1367. package/extensions/memory-lancedb/node_modules/.bin/openclaw.CMD +12 -0
  1368. package/extensions/memory-lancedb/node_modules/.bin/openclaw.ps1 +41 -0
  1369. package/extensions/memory-lancedb/node_modules/.bin/synurex +21 -0
  1370. package/extensions/memory-lancedb/node_modules/.bin/synurex.CMD +12 -0
  1371. package/extensions/memory-lancedb/node_modules/.bin/synurex.ps1 +41 -0
  1372. package/extensions/memory-lancedb/package.json +19 -0
  1373. package/extensions/memory-lancedb/synurex.plugin.json +60 -0
  1374. package/extensions/minimax-portal-auth/README.md +33 -0
  1375. package/extensions/minimax-portal-auth/index.ts +155 -0
  1376. package/extensions/minimax-portal-auth/node_modules/.bin/clawdbot +21 -0
  1377. package/extensions/minimax-portal-auth/node_modules/.bin/clawdbot.CMD +12 -0
  1378. package/extensions/minimax-portal-auth/node_modules/.bin/clawdbot.ps1 +41 -0
  1379. package/extensions/minimax-portal-auth/node_modules/.bin/openclaw +21 -0
  1380. package/extensions/minimax-portal-auth/node_modules/.bin/openclaw.CMD +12 -0
  1381. package/extensions/minimax-portal-auth/node_modules/.bin/openclaw.ps1 +41 -0
  1382. package/extensions/minimax-portal-auth/node_modules/.bin/synurex +21 -0
  1383. package/extensions/minimax-portal-auth/node_modules/.bin/synurex.CMD +12 -0
  1384. package/extensions/minimax-portal-auth/node_modules/.bin/synurex.ps1 +41 -0
  1385. package/extensions/minimax-portal-auth/oauth.ts +247 -0
  1386. package/extensions/minimax-portal-auth/package.json +14 -0
  1387. package/extensions/minimax-portal-auth/synurex.plugin.json +9 -0
  1388. package/extensions/msteams/CHANGELOG.md +107 -0
  1389. package/extensions/msteams/index.ts +17 -0
  1390. package/extensions/msteams/node_modules/.bin/clawdbot +21 -0
  1391. package/extensions/msteams/node_modules/.bin/clawdbot.CMD +12 -0
  1392. package/extensions/msteams/node_modules/.bin/clawdbot.ps1 +41 -0
  1393. package/extensions/msteams/node_modules/.bin/openclaw +21 -0
  1394. package/extensions/msteams/node_modules/.bin/openclaw.CMD +12 -0
  1395. package/extensions/msteams/node_modules/.bin/openclaw.ps1 +41 -0
  1396. package/extensions/msteams/node_modules/.bin/synurex +21 -0
  1397. package/extensions/msteams/node_modules/.bin/synurex.CMD +12 -0
  1398. package/extensions/msteams/node_modules/.bin/synurex.ps1 +41 -0
  1399. package/extensions/msteams/package.json +39 -0
  1400. package/extensions/msteams/src/attachments/download.ts +283 -0
  1401. package/extensions/msteams/src/attachments/graph.ts +353 -0
  1402. package/extensions/msteams/src/attachments/html.ts +90 -0
  1403. package/extensions/msteams/src/attachments/payload.ts +22 -0
  1404. package/extensions/msteams/src/attachments/shared.ts +291 -0
  1405. package/extensions/msteams/src/attachments/types.ts +37 -0
  1406. package/extensions/msteams/src/attachments.test.ts +459 -0
  1407. package/extensions/msteams/src/attachments.ts +18 -0
  1408. package/extensions/msteams/src/channel.directory.test.ts +48 -0
  1409. package/extensions/msteams/src/channel.ts +459 -0
  1410. package/extensions/msteams/src/conversation-store-fs.test.ts +88 -0
  1411. package/extensions/msteams/src/conversation-store-fs.ts +165 -0
  1412. package/extensions/msteams/src/conversation-store-memory.ts +47 -0
  1413. package/extensions/msteams/src/conversation-store.ts +41 -0
  1414. package/extensions/msteams/src/directory-live.ts +205 -0
  1415. package/extensions/msteams/src/errors.test.ts +45 -0
  1416. package/extensions/msteams/src/errors.ts +190 -0
  1417. package/extensions/msteams/src/file-consent-helpers.test.ts +243 -0
  1418. package/extensions/msteams/src/file-consent-helpers.ts +73 -0
  1419. package/extensions/msteams/src/file-consent.ts +126 -0
  1420. package/extensions/msteams/src/graph-chat.ts +53 -0
  1421. package/extensions/msteams/src/graph-upload.ts +453 -0
  1422. package/extensions/msteams/src/inbound.test.ts +66 -0
  1423. package/extensions/msteams/src/inbound.ts +48 -0
  1424. package/extensions/msteams/src/index.ts +4 -0
  1425. package/extensions/msteams/src/media-helpers.test.ts +189 -0
  1426. package/extensions/msteams/src/media-helpers.ts +86 -0
  1427. package/extensions/msteams/src/messenger.test.ts +248 -0
  1428. package/extensions/msteams/src/messenger.ts +495 -0
  1429. package/extensions/msteams/src/monitor-handler/inbound-media.ts +128 -0
  1430. package/extensions/msteams/src/monitor-handler/message-handler.ts +641 -0
  1431. package/extensions/msteams/src/monitor-handler.ts +162 -0
  1432. package/extensions/msteams/src/monitor-types.ts +5 -0
  1433. package/extensions/msteams/src/monitor.ts +295 -0
  1434. package/extensions/msteams/src/onboarding.ts +431 -0
  1435. package/extensions/msteams/src/outbound.ts +46 -0
  1436. package/extensions/msteams/src/pending-uploads.ts +89 -0
  1437. package/extensions/msteams/src/policy.test.ts +209 -0
  1438. package/extensions/msteams/src/policy.ts +273 -0
  1439. package/extensions/msteams/src/polls-store-memory.ts +32 -0
  1440. package/extensions/msteams/src/polls-store.test.ts +38 -0
  1441. package/extensions/msteams/src/polls.test.ts +72 -0
  1442. package/extensions/msteams/src/polls.ts +315 -0
  1443. package/extensions/msteams/src/probe.test.ts +58 -0
  1444. package/extensions/msteams/src/probe.ts +107 -0
  1445. package/extensions/msteams/src/reply-dispatcher.ts +132 -0
  1446. package/extensions/msteams/src/resolve-allowlist.ts +297 -0
  1447. package/extensions/msteams/src/runtime.ts +14 -0
  1448. package/extensions/msteams/src/sdk-types.ts +19 -0
  1449. package/extensions/msteams/src/sdk.ts +33 -0
  1450. package/extensions/msteams/src/send-context.ts +164 -0
  1451. package/extensions/msteams/src/send.ts +519 -0
  1452. package/extensions/msteams/src/sent-message-cache.test.ts +15 -0
  1453. package/extensions/msteams/src/sent-message-cache.ts +47 -0
  1454. package/extensions/msteams/src/storage.ts +25 -0
  1455. package/extensions/msteams/src/store-fs.ts +83 -0
  1456. package/extensions/msteams/src/token.ts +19 -0
  1457. package/extensions/msteams/synurex.plugin.json +9 -0
  1458. package/extensions/nextcloud-talk/index.ts +17 -0
  1459. package/extensions/nextcloud-talk/node_modules/.bin/clawdbot +21 -0
  1460. package/extensions/nextcloud-talk/node_modules/.bin/clawdbot.CMD +12 -0
  1461. package/extensions/nextcloud-talk/node_modules/.bin/clawdbot.ps1 +41 -0
  1462. package/extensions/nextcloud-talk/node_modules/.bin/openclaw +21 -0
  1463. package/extensions/nextcloud-talk/node_modules/.bin/openclaw.CMD +12 -0
  1464. package/extensions/nextcloud-talk/node_modules/.bin/openclaw.ps1 +41 -0
  1465. package/extensions/nextcloud-talk/node_modules/.bin/synurex +21 -0
  1466. package/extensions/nextcloud-talk/node_modules/.bin/synurex.CMD +12 -0
  1467. package/extensions/nextcloud-talk/node_modules/.bin/synurex.ps1 +41 -0
  1468. package/extensions/nextcloud-talk/package.json +33 -0
  1469. package/extensions/nextcloud-talk/src/accounts.ts +174 -0
  1470. package/extensions/nextcloud-talk/src/channel.ts +409 -0
  1471. package/extensions/nextcloud-talk/src/config-schema.ts +79 -0
  1472. package/extensions/nextcloud-talk/src/format.ts +79 -0
  1473. package/extensions/nextcloud-talk/src/inbound.ts +327 -0
  1474. package/extensions/nextcloud-talk/src/monitor.ts +246 -0
  1475. package/extensions/nextcloud-talk/src/normalize.ts +39 -0
  1476. package/extensions/nextcloud-talk/src/onboarding.ts +343 -0
  1477. package/extensions/nextcloud-talk/src/policy.test.ts +33 -0
  1478. package/extensions/nextcloud-talk/src/policy.ts +180 -0
  1479. package/extensions/nextcloud-talk/src/room-info.ts +125 -0
  1480. package/extensions/nextcloud-talk/src/runtime.ts +14 -0
  1481. package/extensions/nextcloud-talk/src/send.ts +215 -0
  1482. package/extensions/nextcloud-talk/src/signature.ts +72 -0
  1483. package/extensions/nextcloud-talk/src/types.ts +181 -0
  1484. package/extensions/nextcloud-talk/synurex.plugin.json +9 -0
  1485. package/extensions/nostr/CHANGELOG.md +98 -0
  1486. package/extensions/nostr/README.md +136 -0
  1487. package/extensions/nostr/index.ts +68 -0
  1488. package/extensions/nostr/node_modules/.bin/clawdbot +21 -0
  1489. package/extensions/nostr/node_modules/.bin/clawdbot.CMD +12 -0
  1490. package/extensions/nostr/node_modules/.bin/clawdbot.ps1 +41 -0
  1491. package/extensions/nostr/node_modules/.bin/openclaw +21 -0
  1492. package/extensions/nostr/node_modules/.bin/openclaw.CMD +12 -0
  1493. package/extensions/nostr/node_modules/.bin/openclaw.ps1 +41 -0
  1494. package/extensions/nostr/node_modules/.bin/synurex +21 -0
  1495. package/extensions/nostr/node_modules/.bin/synurex.CMD +12 -0
  1496. package/extensions/nostr/node_modules/.bin/synurex.ps1 +41 -0
  1497. package/extensions/nostr/package.json +34 -0
  1498. package/extensions/nostr/src/channel.test.ts +151 -0
  1499. package/extensions/nostr/src/channel.ts +353 -0
  1500. package/extensions/nostr/src/config-schema.ts +90 -0
  1501. package/extensions/nostr/src/metrics.ts +478 -0
  1502. package/extensions/nostr/src/nostr-bus.fuzz.test.ts +533 -0
  1503. package/extensions/nostr/src/nostr-bus.integration.test.ts +448 -0
  1504. package/extensions/nostr/src/nostr-bus.test.ts +199 -0
  1505. package/extensions/nostr/src/nostr-bus.ts +715 -0
  1506. package/extensions/nostr/src/nostr-profile-http.test.ts +378 -0
  1507. package/extensions/nostr/src/nostr-profile-http.ts +546 -0
  1508. package/extensions/nostr/src/nostr-profile-import.test.ts +119 -0
  1509. package/extensions/nostr/src/nostr-profile-import.ts +262 -0
  1510. package/extensions/nostr/src/nostr-profile.fuzz.test.ts +477 -0
  1511. package/extensions/nostr/src/nostr-profile.test.ts +410 -0
  1512. package/extensions/nostr/src/nostr-profile.ts +277 -0
  1513. package/extensions/nostr/src/nostr-state-store.test.ts +131 -0
  1514. package/extensions/nostr/src/nostr-state-store.ts +226 -0
  1515. package/extensions/nostr/src/runtime.ts +14 -0
  1516. package/extensions/nostr/src/seen-tracker.ts +303 -0
  1517. package/extensions/nostr/src/types.test.ts +157 -0
  1518. package/extensions/nostr/src/types.ts +101 -0
  1519. package/extensions/nostr/synurex.plugin.json +9 -0
  1520. package/extensions/nostr/test/setup.ts +5 -0
  1521. package/extensions/open-prose/README.md +25 -0
  1522. package/extensions/open-prose/index.ts +5 -0
  1523. package/extensions/open-prose/node_modules/.bin/clawdbot +21 -0
  1524. package/extensions/open-prose/node_modules/.bin/clawdbot.CMD +12 -0
  1525. package/extensions/open-prose/node_modules/.bin/clawdbot.ps1 +41 -0
  1526. package/extensions/open-prose/node_modules/.bin/openclaw +21 -0
  1527. package/extensions/open-prose/node_modules/.bin/openclaw.CMD +12 -0
  1528. package/extensions/open-prose/node_modules/.bin/openclaw.ps1 +41 -0
  1529. package/extensions/open-prose/node_modules/.bin/synurex +21 -0
  1530. package/extensions/open-prose/node_modules/.bin/synurex.CMD +12 -0
  1531. package/extensions/open-prose/node_modules/.bin/synurex.ps1 +41 -0
  1532. package/extensions/open-prose/package.json +14 -0
  1533. package/extensions/open-prose/skills/prose/LICENSE +21 -0
  1534. package/extensions/open-prose/skills/prose/SKILL.md +323 -0
  1535. package/extensions/open-prose/skills/prose/alt-borges.md +141 -0
  1536. package/extensions/open-prose/skills/prose/alts/arabian-nights.md +358 -0
  1537. package/extensions/open-prose/skills/prose/alts/borges.md +360 -0
  1538. package/extensions/open-prose/skills/prose/alts/folk.md +322 -0
  1539. package/extensions/open-prose/skills/prose/alts/homer.md +346 -0
  1540. package/extensions/open-prose/skills/prose/alts/kafka.md +373 -0
  1541. package/extensions/open-prose/skills/prose/compiler.md +2971 -0
  1542. package/extensions/open-prose/skills/prose/examples/01-hello-world.prose +4 -0
  1543. package/extensions/open-prose/skills/prose/examples/02-research-and-summarize.prose +6 -0
  1544. package/extensions/open-prose/skills/prose/examples/03-code-review.prose +17 -0
  1545. package/extensions/open-prose/skills/prose/examples/04-write-and-refine.prose +14 -0
  1546. package/extensions/open-prose/skills/prose/examples/05-debug-issue.prose +20 -0
  1547. package/extensions/open-prose/skills/prose/examples/06-explain-codebase.prose +17 -0
  1548. package/extensions/open-prose/skills/prose/examples/07-refactor.prose +20 -0
  1549. package/extensions/open-prose/skills/prose/examples/08-blog-post.prose +20 -0
  1550. package/extensions/open-prose/skills/prose/examples/09-research-with-agents.prose +25 -0
  1551. package/extensions/open-prose/skills/prose/examples/10-code-review-agents.prose +32 -0
  1552. package/extensions/open-prose/skills/prose/examples/11-skills-and-imports.prose +27 -0
  1553. package/extensions/open-prose/skills/prose/examples/12-secure-agent-permissions.prose +43 -0
  1554. package/extensions/open-prose/skills/prose/examples/13-variables-and-context.prose +51 -0
  1555. package/extensions/open-prose/skills/prose/examples/14-composition-blocks.prose +48 -0
  1556. package/extensions/open-prose/skills/prose/examples/15-inline-sequences.prose +23 -0
  1557. package/extensions/open-prose/skills/prose/examples/16-parallel-reviews.prose +19 -0
  1558. package/extensions/open-prose/skills/prose/examples/17-parallel-research.prose +19 -0
  1559. package/extensions/open-prose/skills/prose/examples/18-mixed-parallel-sequential.prose +36 -0
  1560. package/extensions/open-prose/skills/prose/examples/19-advanced-parallel.prose +71 -0
  1561. package/extensions/open-prose/skills/prose/examples/20-fixed-loops.prose +20 -0
  1562. package/extensions/open-prose/skills/prose/examples/21-pipeline-operations.prose +35 -0
  1563. package/extensions/open-prose/skills/prose/examples/22-error-handling.prose +51 -0
  1564. package/extensions/open-prose/skills/prose/examples/23-retry-with-backoff.prose +63 -0
  1565. package/extensions/open-prose/skills/prose/examples/24-choice-blocks.prose +86 -0
  1566. package/extensions/open-prose/skills/prose/examples/25-conditionals.prose +114 -0
  1567. package/extensions/open-prose/skills/prose/examples/26-parameterized-blocks.prose +100 -0
  1568. package/extensions/open-prose/skills/prose/examples/27-string-interpolation.prose +105 -0
  1569. package/extensions/open-prose/skills/prose/examples/28-automated-pr-review.prose +37 -0
  1570. package/extensions/open-prose/skills/prose/examples/28-gas-town.prose +1572 -0
  1571. package/extensions/open-prose/skills/prose/examples/29-captains-chair.prose +218 -0
  1572. package/extensions/open-prose/skills/prose/examples/30-captains-chair-simple.prose +42 -0
  1573. package/extensions/open-prose/skills/prose/examples/31-captains-chair-with-memory.prose +145 -0
  1574. package/extensions/open-prose/skills/prose/examples/33-pr-review-autofix.prose +168 -0
  1575. package/extensions/open-prose/skills/prose/examples/34-content-pipeline.prose +204 -0
  1576. package/extensions/open-prose/skills/prose/examples/35-feature-factory.prose +296 -0
  1577. package/extensions/open-prose/skills/prose/examples/36-bug-hunter.prose +237 -0
  1578. package/extensions/open-prose/skills/prose/examples/37-the-forge.prose +1474 -0
  1579. package/extensions/open-prose/skills/prose/examples/38-skill-scan.prose +455 -0
  1580. package/extensions/open-prose/skills/prose/examples/39-architect-by-simulation.prose +277 -0
  1581. package/extensions/open-prose/skills/prose/examples/40-rlm-self-refine.prose +32 -0
  1582. package/extensions/open-prose/skills/prose/examples/41-rlm-divide-conquer.prose +38 -0
  1583. package/extensions/open-prose/skills/prose/examples/42-rlm-filter-recurse.prose +46 -0
  1584. package/extensions/open-prose/skills/prose/examples/43-rlm-pairwise.prose +50 -0
  1585. package/extensions/open-prose/skills/prose/examples/44-run-endpoint-ux-test.prose +261 -0
  1586. package/extensions/open-prose/skills/prose/examples/45-plugin-release.prose +159 -0
  1587. package/extensions/open-prose/skills/prose/examples/45-run-endpoint-ux-test-with-remediation.prose +637 -0
  1588. package/extensions/open-prose/skills/prose/examples/46-run-endpoint-ux-test-fast.prose +148 -0
  1589. package/extensions/open-prose/skills/prose/examples/46-workflow-crystallizer.prose +225 -0
  1590. package/extensions/open-prose/skills/prose/examples/47-language-self-improvement.prose +356 -0
  1591. package/extensions/open-prose/skills/prose/examples/48-habit-miner.prose +445 -0
  1592. package/extensions/open-prose/skills/prose/examples/49-prose-run-retrospective.prose +210 -0
  1593. package/extensions/open-prose/skills/prose/examples/README.md +391 -0
  1594. package/extensions/open-prose/skills/prose/examples/roadmap/README.md +22 -0
  1595. package/extensions/open-prose/skills/prose/examples/roadmap/iterative-refinement.prose +20 -0
  1596. package/extensions/open-prose/skills/prose/examples/roadmap/parallel-review.prose +18 -0
  1597. package/extensions/open-prose/skills/prose/examples/roadmap/simple-pipeline.prose +17 -0
  1598. package/extensions/open-prose/skills/prose/examples/roadmap/syntax/open-prose-syntax.prose +223 -0
  1599. package/extensions/open-prose/skills/prose/guidance/antipatterns.md +951 -0
  1600. package/extensions/open-prose/skills/prose/guidance/patterns.md +700 -0
  1601. package/extensions/open-prose/skills/prose/guidance/system-prompt.md +180 -0
  1602. package/extensions/open-prose/skills/prose/help.md +144 -0
  1603. package/extensions/open-prose/skills/prose/lib/README.md +108 -0
  1604. package/extensions/open-prose/skills/prose/lib/calibrator.prose +215 -0
  1605. package/extensions/open-prose/skills/prose/lib/cost-analyzer.prose +174 -0
  1606. package/extensions/open-prose/skills/prose/lib/error-forensics.prose +250 -0
  1607. package/extensions/open-prose/skills/prose/lib/inspector.prose +196 -0
  1608. package/extensions/open-prose/skills/prose/lib/profiler.prose +460 -0
  1609. package/extensions/open-prose/skills/prose/lib/program-improver.prose +275 -0
  1610. package/extensions/open-prose/skills/prose/lib/project-memory.prose +118 -0
  1611. package/extensions/open-prose/skills/prose/lib/user-memory.prose +93 -0
  1612. package/extensions/open-prose/skills/prose/lib/vm-improver.prose +243 -0
  1613. package/extensions/open-prose/skills/prose/primitives/session.md +593 -0
  1614. package/extensions/open-prose/skills/prose/prose.md +1237 -0
  1615. package/extensions/open-prose/skills/prose/state/filesystem.md +498 -0
  1616. package/extensions/open-prose/skills/prose/state/in-context.md +384 -0
  1617. package/extensions/open-prose/skills/prose/state/postgres.md +880 -0
  1618. package/extensions/open-prose/skills/prose/state/sqlite.md +574 -0
  1619. package/extensions/open-prose/synurex.plugin.json +11 -0
  1620. package/extensions/qwen-portal-auth/README.md +24 -0
  1621. package/extensions/qwen-portal-auth/index.ts +130 -0
  1622. package/extensions/qwen-portal-auth/oauth.ts +190 -0
  1623. package/extensions/qwen-portal-auth/synurex.plugin.json +9 -0
  1624. package/extensions/signal/index.ts +17 -0
  1625. package/extensions/signal/node_modules/.bin/clawdbot +21 -0
  1626. package/extensions/signal/node_modules/.bin/clawdbot.CMD +12 -0
  1627. package/extensions/signal/node_modules/.bin/clawdbot.ps1 +41 -0
  1628. package/extensions/signal/node_modules/.bin/openclaw +21 -0
  1629. package/extensions/signal/node_modules/.bin/openclaw.CMD +12 -0
  1630. package/extensions/signal/node_modules/.bin/openclaw.ps1 +41 -0
  1631. package/extensions/signal/node_modules/.bin/synurex +21 -0
  1632. package/extensions/signal/node_modules/.bin/synurex.CMD +12 -0
  1633. package/extensions/signal/node_modules/.bin/synurex.ps1 +41 -0
  1634. package/extensions/signal/package.json +14 -0
  1635. package/extensions/signal/src/channel.ts +315 -0
  1636. package/extensions/signal/src/runtime.ts +14 -0
  1637. package/extensions/signal/synurex.plugin.json +9 -0
  1638. package/extensions/slack/index.ts +17 -0
  1639. package/extensions/slack/node_modules/.bin/clawdbot +21 -0
  1640. package/extensions/slack/node_modules/.bin/clawdbot.CMD +12 -0
  1641. package/extensions/slack/node_modules/.bin/clawdbot.ps1 +41 -0
  1642. package/extensions/slack/node_modules/.bin/openclaw +21 -0
  1643. package/extensions/slack/node_modules/.bin/openclaw.CMD +12 -0
  1644. package/extensions/slack/node_modules/.bin/openclaw.ps1 +41 -0
  1645. package/extensions/slack/node_modules/.bin/synurex +21 -0
  1646. package/extensions/slack/node_modules/.bin/synurex.CMD +12 -0
  1647. package/extensions/slack/node_modules/.bin/synurex.ps1 +41 -0
  1648. package/extensions/slack/package.json +14 -0
  1649. package/extensions/slack/src/channel.ts +604 -0
  1650. package/extensions/slack/src/runtime.ts +14 -0
  1651. package/extensions/slack/synurex.plugin.json +9 -0
  1652. package/extensions/telegram/index.ts +17 -0
  1653. package/extensions/telegram/node_modules/.bin/clawdbot +21 -0
  1654. package/extensions/telegram/node_modules/.bin/clawdbot.CMD +12 -0
  1655. package/extensions/telegram/node_modules/.bin/clawdbot.ps1 +41 -0
  1656. package/extensions/telegram/node_modules/.bin/openclaw +21 -0
  1657. package/extensions/telegram/node_modules/.bin/openclaw.CMD +12 -0
  1658. package/extensions/telegram/node_modules/.bin/openclaw.ps1 +41 -0
  1659. package/extensions/telegram/node_modules/.bin/synurex +21 -0
  1660. package/extensions/telegram/node_modules/.bin/synurex.CMD +12 -0
  1661. package/extensions/telegram/node_modules/.bin/synurex.ps1 +41 -0
  1662. package/extensions/telegram/package.json +14 -0
  1663. package/extensions/telegram/src/channel.ts +482 -0
  1664. package/extensions/telegram/src/runtime.ts +14 -0
  1665. package/extensions/telegram/synurex.plugin.json +9 -0
  1666. package/extensions/tlon/README.md +5 -0
  1667. package/extensions/tlon/index.ts +17 -0
  1668. package/extensions/tlon/node_modules/.bin/clawdbot +21 -0
  1669. package/extensions/tlon/node_modules/.bin/clawdbot.CMD +12 -0
  1670. package/extensions/tlon/node_modules/.bin/clawdbot.ps1 +41 -0
  1671. package/extensions/tlon/node_modules/.bin/openclaw +21 -0
  1672. package/extensions/tlon/node_modules/.bin/openclaw.CMD +12 -0
  1673. package/extensions/tlon/node_modules/.bin/openclaw.ps1 +41 -0
  1674. package/extensions/tlon/node_modules/.bin/synurex +21 -0
  1675. package/extensions/tlon/node_modules/.bin/synurex.CMD +12 -0
  1676. package/extensions/tlon/node_modules/.bin/synurex.ps1 +41 -0
  1677. package/extensions/tlon/package.json +33 -0
  1678. package/extensions/tlon/src/channel.ts +392 -0
  1679. package/extensions/tlon/src/config-schema.test.ts +31 -0
  1680. package/extensions/tlon/src/config-schema.ts +45 -0
  1681. package/extensions/tlon/src/monitor/discovery.ts +76 -0
  1682. package/extensions/tlon/src/monitor/history.ts +90 -0
  1683. package/extensions/tlon/src/monitor/index.ts +580 -0
  1684. package/extensions/tlon/src/monitor/processed-messages.test.ts +23 -0
  1685. package/extensions/tlon/src/monitor/processed-messages.ts +46 -0
  1686. package/extensions/tlon/src/monitor/utils.ts +106 -0
  1687. package/extensions/tlon/src/onboarding.ts +214 -0
  1688. package/extensions/tlon/src/runtime.ts +14 -0
  1689. package/extensions/tlon/src/targets.ts +89 -0
  1690. package/extensions/tlon/src/types.ts +92 -0
  1691. package/extensions/tlon/src/urbit/auth.ts +18 -0
  1692. package/extensions/tlon/src/urbit/http-api.ts +38 -0
  1693. package/extensions/tlon/src/urbit/send.test.ts +38 -0
  1694. package/extensions/tlon/src/urbit/send.ts +131 -0
  1695. package/extensions/tlon/src/urbit/sse-client.test.ts +40 -0
  1696. package/extensions/tlon/src/urbit/sse-client.ts +395 -0
  1697. package/extensions/tlon/synurex.plugin.json +9 -0
  1698. package/extensions/twitch/CHANGELOG.md +69 -0
  1699. package/extensions/twitch/README.md +89 -0
  1700. package/extensions/twitch/index.ts +20 -0
  1701. package/extensions/twitch/node_modules/.bin/clawdbot +21 -0
  1702. package/extensions/twitch/node_modules/.bin/clawdbot.CMD +12 -0
  1703. package/extensions/twitch/node_modules/.bin/clawdbot.ps1 +41 -0
  1704. package/extensions/twitch/node_modules/.bin/openclaw +21 -0
  1705. package/extensions/twitch/node_modules/.bin/openclaw.CMD +12 -0
  1706. package/extensions/twitch/node_modules/.bin/openclaw.ps1 +41 -0
  1707. package/extensions/twitch/node_modules/.bin/synurex +21 -0
  1708. package/extensions/twitch/node_modules/.bin/synurex.CMD +12 -0
  1709. package/extensions/twitch/node_modules/.bin/synurex.ps1 +41 -0
  1710. package/extensions/twitch/package.json +20 -0
  1711. package/extensions/twitch/src/access-control.test.ts +489 -0
  1712. package/extensions/twitch/src/access-control.ts +166 -0
  1713. package/extensions/twitch/src/actions.ts +173 -0
  1714. package/extensions/twitch/src/client-manager-registry.ts +115 -0
  1715. package/extensions/twitch/src/config-schema.ts +84 -0
  1716. package/extensions/twitch/src/config.test.ts +87 -0
  1717. package/extensions/twitch/src/config.ts +116 -0
  1718. package/extensions/twitch/src/monitor.ts +272 -0
  1719. package/extensions/twitch/src/onboarding.test.ts +311 -0
  1720. package/extensions/twitch/src/onboarding.ts +417 -0
  1721. package/extensions/twitch/src/outbound.test.ts +373 -0
  1722. package/extensions/twitch/src/outbound.ts +184 -0
  1723. package/extensions/twitch/src/plugin.test.ts +39 -0
  1724. package/extensions/twitch/src/plugin.ts +274 -0
  1725. package/extensions/twitch/src/probe.test.ts +195 -0
  1726. package/extensions/twitch/src/probe.ts +120 -0
  1727. package/extensions/twitch/src/resolver.ts +137 -0
  1728. package/extensions/twitch/src/runtime.ts +14 -0
  1729. package/extensions/twitch/src/send.test.ts +289 -0
  1730. package/extensions/twitch/src/send.ts +136 -0
  1731. package/extensions/twitch/src/status.test.ts +270 -0
  1732. package/extensions/twitch/src/status.ts +178 -0
  1733. package/extensions/twitch/src/token.test.ts +171 -0
  1734. package/extensions/twitch/src/token.ts +91 -0
  1735. package/extensions/twitch/src/twitch-client.test.ts +589 -0
  1736. package/extensions/twitch/src/twitch-client.ts +277 -0
  1737. package/extensions/twitch/src/types.ts +143 -0
  1738. package/extensions/twitch/src/utils/markdown.ts +98 -0
  1739. package/extensions/twitch/src/utils/twitch.ts +78 -0
  1740. package/extensions/twitch/synurex.plugin.json +9 -0
  1741. package/extensions/twitch/test/setup.ts +7 -0
  1742. package/extensions/voice-call/CHANGELOG.md +133 -0
  1743. package/extensions/voice-call/README.md +139 -0
  1744. package/extensions/voice-call/index.ts +493 -0
  1745. package/extensions/voice-call/node_modules/.bin/clawdbot +21 -0
  1746. package/extensions/voice-call/node_modules/.bin/clawdbot.CMD +12 -0
  1747. package/extensions/voice-call/node_modules/.bin/clawdbot.ps1 +41 -0
  1748. package/extensions/voice-call/node_modules/.bin/openclaw +21 -0
  1749. package/extensions/voice-call/node_modules/.bin/openclaw.CMD +12 -0
  1750. package/extensions/voice-call/node_modules/.bin/openclaw.ps1 +41 -0
  1751. package/extensions/voice-call/node_modules/.bin/synurex +21 -0
  1752. package/extensions/voice-call/node_modules/.bin/synurex.CMD +12 -0
  1753. package/extensions/voice-call/node_modules/.bin/synurex.ps1 +41 -0
  1754. package/extensions/voice-call/package.json +19 -0
  1755. package/extensions/voice-call/src/allowlist.ts +19 -0
  1756. package/extensions/voice-call/src/cli.ts +279 -0
  1757. package/extensions/voice-call/src/config.test.ts +234 -0
  1758. package/extensions/voice-call/src/config.ts +523 -0
  1759. package/extensions/voice-call/src/core-bridge.ts +159 -0
  1760. package/extensions/voice-call/src/manager/context.ts +21 -0
  1761. package/extensions/voice-call/src/manager/events.ts +188 -0
  1762. package/extensions/voice-call/src/manager/lookup.ts +35 -0
  1763. package/extensions/voice-call/src/manager/outbound.ts +275 -0
  1764. package/extensions/voice-call/src/manager/state.ts +48 -0
  1765. package/extensions/voice-call/src/manager/store.ts +91 -0
  1766. package/extensions/voice-call/src/manager/timers.ts +89 -0
  1767. package/extensions/voice-call/src/manager/twiml.ts +9 -0
  1768. package/extensions/voice-call/src/manager.test.ts +224 -0
  1769. package/extensions/voice-call/src/manager.ts +887 -0
  1770. package/extensions/voice-call/src/media-stream.test.ts +96 -0
  1771. package/extensions/voice-call/src/media-stream.ts +411 -0
  1772. package/extensions/voice-call/src/providers/base.ts +67 -0
  1773. package/extensions/voice-call/src/providers/index.ts +10 -0
  1774. package/extensions/voice-call/src/providers/mock.ts +165 -0
  1775. package/extensions/voice-call/src/providers/plivo.test.ts +27 -0
  1776. package/extensions/voice-call/src/providers/plivo.ts +515 -0
  1777. package/extensions/voice-call/src/providers/stt-openai-realtime.ts +311 -0
  1778. package/extensions/voice-call/src/providers/telnyx.ts +371 -0
  1779. package/extensions/voice-call/src/providers/tts-openai.ts +259 -0
  1780. package/extensions/voice-call/src/providers/twilio/api.ts +42 -0
  1781. package/extensions/voice-call/src/providers/twilio/webhook.ts +32 -0
  1782. package/extensions/voice-call/src/providers/twilio.test.ts +60 -0
  1783. package/extensions/voice-call/src/providers/twilio.ts +626 -0
  1784. package/extensions/voice-call/src/response-generator.ts +158 -0
  1785. package/extensions/voice-call/src/runtime.ts +212 -0
  1786. package/extensions/voice-call/src/telephony-audio.ts +90 -0
  1787. package/extensions/voice-call/src/telephony-tts.ts +104 -0
  1788. package/extensions/voice-call/src/tunnel.ts +314 -0
  1789. package/extensions/voice-call/src/types.ts +272 -0
  1790. package/extensions/voice-call/src/utils.ts +14 -0
  1791. package/extensions/voice-call/src/voice-mapping.ts +67 -0
  1792. package/extensions/voice-call/src/webhook-security.test.ts +377 -0
  1793. package/extensions/voice-call/src/webhook-security.ts +689 -0
  1794. package/extensions/voice-call/src/webhook.ts +516 -0
  1795. package/extensions/voice-call/synurex.plugin.json +559 -0
  1796. package/extensions/whatsapp/index.ts +17 -0
  1797. package/extensions/whatsapp/node_modules/.bin/clawdbot +21 -0
  1798. package/extensions/whatsapp/node_modules/.bin/clawdbot.CMD +12 -0
  1799. package/extensions/whatsapp/node_modules/.bin/clawdbot.ps1 +41 -0
  1800. package/extensions/whatsapp/node_modules/.bin/openclaw +21 -0
  1801. package/extensions/whatsapp/node_modules/.bin/openclaw.CMD +12 -0
  1802. package/extensions/whatsapp/node_modules/.bin/openclaw.ps1 +41 -0
  1803. package/extensions/whatsapp/node_modules/.bin/synurex +21 -0
  1804. package/extensions/whatsapp/node_modules/.bin/synurex.CMD +12 -0
  1805. package/extensions/whatsapp/node_modules/.bin/synurex.ps1 +41 -0
  1806. package/extensions/whatsapp/package.json +14 -0
  1807. package/extensions/whatsapp/src/channel.ts +508 -0
  1808. package/extensions/whatsapp/src/runtime.ts +14 -0
  1809. package/extensions/whatsapp/synurex.plugin.json +9 -0
  1810. package/extensions/zalo/CHANGELOG.md +113 -0
  1811. package/extensions/zalo/README.md +50 -0
  1812. package/extensions/zalo/index.ts +19 -0
  1813. package/extensions/zalo/node_modules/.bin/clawdbot +21 -0
  1814. package/extensions/zalo/node_modules/.bin/clawdbot.CMD +12 -0
  1815. package/extensions/zalo/node_modules/.bin/clawdbot.ps1 +41 -0
  1816. package/extensions/zalo/node_modules/.bin/openclaw +21 -0
  1817. package/extensions/zalo/node_modules/.bin/openclaw.CMD +12 -0
  1818. package/extensions/zalo/node_modules/.bin/openclaw.ps1 +41 -0
  1819. package/extensions/zalo/node_modules/.bin/synurex +21 -0
  1820. package/extensions/zalo/node_modules/.bin/synurex.CMD +12 -0
  1821. package/extensions/zalo/node_modules/.bin/synurex.ps1 +41 -0
  1822. package/extensions/zalo/package.json +36 -0
  1823. package/extensions/zalo/src/accounts.ts +80 -0
  1824. package/extensions/zalo/src/actions.ts +67 -0
  1825. package/extensions/zalo/src/api.ts +208 -0
  1826. package/extensions/zalo/src/channel.directory.test.ts +43 -0
  1827. package/extensions/zalo/src/channel.ts +414 -0
  1828. package/extensions/zalo/src/config-schema.ts +25 -0
  1829. package/extensions/zalo/src/monitor.ts +764 -0
  1830. package/extensions/zalo/src/monitor.webhook.test.ts +73 -0
  1831. package/extensions/zalo/src/onboarding.ts +401 -0
  1832. package/extensions/zalo/src/probe.ts +46 -0
  1833. package/extensions/zalo/src/proxy.ts +21 -0
  1834. package/extensions/zalo/src/runtime.ts +14 -0
  1835. package/extensions/zalo/src/send.ts +124 -0
  1836. package/extensions/zalo/src/status-issues.ts +53 -0
  1837. package/extensions/zalo/src/token.ts +63 -0
  1838. package/extensions/zalo/src/types.ts +44 -0
  1839. package/extensions/zalo/synurex.plugin.json +9 -0
  1840. package/extensions/zalouser/CHANGELOG.md +85 -0
  1841. package/extensions/zalouser/README.md +225 -0
  1842. package/extensions/zalouser/index.ts +31 -0
  1843. package/extensions/zalouser/node_modules/.bin/clawdbot +21 -0
  1844. package/extensions/zalouser/node_modules/.bin/clawdbot.CMD +12 -0
  1845. package/extensions/zalouser/node_modules/.bin/clawdbot.ps1 +41 -0
  1846. package/extensions/zalouser/node_modules/.bin/openclaw +21 -0
  1847. package/extensions/zalouser/node_modules/.bin/openclaw.CMD +12 -0
  1848. package/extensions/zalouser/node_modules/.bin/openclaw.ps1 +41 -0
  1849. package/extensions/zalouser/node_modules/.bin/synurex +21 -0
  1850. package/extensions/zalouser/node_modules/.bin/synurex.CMD +12 -0
  1851. package/extensions/zalouser/node_modules/.bin/synurex.ps1 +41 -0
  1852. package/extensions/zalouser/package.json +36 -0
  1853. package/extensions/zalouser/src/accounts.ts +135 -0
  1854. package/extensions/zalouser/src/channel.test.ts +18 -0
  1855. package/extensions/zalouser/src/channel.ts +686 -0
  1856. package/extensions/zalouser/src/config-schema.ts +28 -0
  1857. package/extensions/zalouser/src/monitor.ts +601 -0
  1858. package/extensions/zalouser/src/onboarding.ts +504 -0
  1859. package/extensions/zalouser/src/probe.ts +28 -0
  1860. package/extensions/zalouser/src/runtime.ts +14 -0
  1861. package/extensions/zalouser/src/send.ts +160 -0
  1862. package/extensions/zalouser/src/status-issues.test.ts +57 -0
  1863. package/extensions/zalouser/src/status-issues.ts +89 -0
  1864. package/extensions/zalouser/src/tool.ts +164 -0
  1865. package/extensions/zalouser/src/types.ts +110 -0
  1866. package/extensions/zalouser/src/zca.ts +202 -0
  1867. package/extensions/zalouser/synurex.plugin.json +9 -0
  1868. package/package.json +263 -0
  1869. package/skills/1password/SKILL.md +70 -0
  1870. package/skills/1password/references/cli-examples.md +29 -0
  1871. package/skills/1password/references/get-started.md +17 -0
  1872. package/skills/apple-notes/SKILL.md +77 -0
  1873. package/skills/apple-reminders/SKILL.md +96 -0
  1874. package/skills/bear-notes/SKILL.md +107 -0
  1875. package/skills/blogwatcher/SKILL.md +69 -0
  1876. package/skills/blucli/SKILL.md +47 -0
  1877. package/skills/bluebubbles/SKILL.md +131 -0
  1878. package/skills/camsnap/SKILL.md +45 -0
  1879. package/skills/canvas/SKILL.md +198 -0
  1880. package/skills/clawhub/SKILL.md +77 -0
  1881. package/skills/coding-agent/SKILL.md +284 -0
  1882. package/skills/discord/SKILL.md +578 -0
  1883. package/skills/eightctl/SKILL.md +50 -0
  1884. package/skills/food-order/SKILL.md +48 -0
  1885. package/skills/gemini/SKILL.md +43 -0
  1886. package/skills/gifgrep/SKILL.md +79 -0
  1887. package/skills/github/SKILL.md +77 -0
  1888. package/skills/gog/SKILL.md +116 -0
  1889. package/skills/goplaces/SKILL.md +52 -0
  1890. package/skills/healthcheck/SKILL.md +245 -0
  1891. package/skills/himalaya/SKILL.md +257 -0
  1892. package/skills/himalaya/references/configuration.md +184 -0
  1893. package/skills/himalaya/references/message-composition.md +199 -0
  1894. package/skills/imsg/SKILL.md +74 -0
  1895. package/skills/local-places/SERVER_README.md +101 -0
  1896. package/skills/local-places/SKILL.md +102 -0
  1897. package/skills/local-places/pyproject.toml +21 -0
  1898. package/skills/local-places/src/local_places/__init__.py +2 -0
  1899. package/skills/local-places/src/local_places/google_places.py +314 -0
  1900. package/skills/local-places/src/local_places/main.py +65 -0
  1901. package/skills/local-places/src/local_places/schemas.py +107 -0
  1902. package/skills/mcporter/SKILL.md +61 -0
  1903. package/skills/model-usage/SKILL.md +69 -0
  1904. package/skills/model-usage/references/codexbar-cli.md +33 -0
  1905. package/skills/model-usage/scripts/model_usage.py +310 -0
  1906. package/skills/nano-banana-pro/SKILL.md +58 -0
  1907. package/skills/nano-banana-pro/scripts/generate_image.py +184 -0
  1908. package/skills/nano-pdf/SKILL.md +38 -0
  1909. package/skills/notion/SKILL.md +172 -0
  1910. package/skills/obsidian/SKILL.md +81 -0
  1911. package/skills/openai-image-gen/SKILL.md +89 -0
  1912. package/skills/openai-image-gen/scripts/gen.py +240 -0
  1913. package/skills/openai-whisper/SKILL.md +38 -0
  1914. package/skills/openai-whisper-api/SKILL.md +52 -0
  1915. package/skills/openai-whisper-api/scripts/transcribe.sh +85 -0
  1916. package/skills/openhue/SKILL.md +51 -0
  1917. package/skills/oracle/SKILL.md +125 -0
  1918. package/skills/ordercli/SKILL.md +78 -0
  1919. package/skills/peekaboo/SKILL.md +190 -0
  1920. package/skills/sag/SKILL.md +87 -0
  1921. package/skills/session-logs/SKILL.md +115 -0
  1922. package/skills/sherpa-onnx-tts/SKILL.md +103 -0
  1923. package/skills/sherpa-onnx-tts/bin/sherpa-onnx-tts +178 -0
  1924. package/skills/skill-creator/SKILL.md +370 -0
  1925. package/skills/skill-creator/license.txt +202 -0
  1926. package/skills/skill-creator/scripts/init_skill.py +378 -0
  1927. package/skills/skill-creator/scripts/package_skill.py +111 -0
  1928. package/skills/skill-creator/scripts/quick_validate.py +101 -0
  1929. package/skills/slack/SKILL.md +144 -0
  1930. package/skills/songsee/SKILL.md +49 -0
  1931. package/skills/sonoscli/SKILL.md +46 -0
  1932. package/skills/spotify-player/SKILL.md +64 -0
  1933. package/skills/summarize/SKILL.md +87 -0
  1934. package/skills/things-mac/SKILL.md +86 -0
  1935. package/skills/tmux/SKILL.md +135 -0
  1936. package/skills/tmux/scripts/find-sessions.sh +112 -0
  1937. package/skills/tmux/scripts/wait-for-text.sh +83 -0
  1938. package/skills/trello/SKILL.md +95 -0
  1939. package/skills/video-frames/SKILL.md +46 -0
  1940. package/skills/video-frames/scripts/frame.sh +81 -0
  1941. package/skills/voice-call/SKILL.md +45 -0
  1942. package/skills/wacli/SKILL.md +72 -0
  1943. package/skills/weather/SKILL.md +54 -0
  1944. package/synurex.mjs +33 -0
@@ -0,0 +1,4924 @@
1
+ import { t as __exportAll } from "./rolldown-runtime-Cbj13DAv.js";
2
+ import { a as resolveCanonicalConfigPath, c as resolveDefaultConfigCandidates, d as resolveIsNixMode, f as resolveLegacyStateDirs, g as resolveStateDir, h as resolveOAuthPath, i as isNixMode, l as resolveGatewayLockDir, m as resolveOAuthDir, n as DEFAULT_GATEWAY_PORT, o as resolveConfigPath, p as resolveNewStateDir, r as STATE_DIR, s as resolveConfigPathCandidate, t as CONFIG_PATH, u as resolveGatewayPort } from "./paths-Drx5WZ13.js";
3
+ import { l as normalizeAgentId, n as DEFAULT_AGENT_ID } from "./session-key-DrNCyvP1.js";
4
+ import { S as normalizeChatChannelId, p as CHANNEL_IDS } from "./subsystem-DPYBJG7C.js";
5
+ import { h as resolveUserPath } from "./utils-C7NsUvD1.js";
6
+ import { c as resolveDefaultAgentId, s as resolveAgentWorkspaceDir } from "./agent-scope-CRRhJ7Hf.js";
7
+ import { G as shouldDeferShellEnvFallback, K as shouldEnableShellEnvFallback, U as loadShellEnvFallback, W as resolveShellEnvFallbackTimeoutMs, c as parseModelRef, xt as DEFAULT_CONTEXT_TOKENS } from "./model-selection-CjYymzT8.js";
8
+ import { c as resolveEnableState, l as resolveMemorySlotDecision, s as normalizePluginsConfig, t as loadPluginManifestRegistry } from "./manifest-registry-D8FEq9qs.js";
9
+ import { createRequire } from "node:module";
10
+ import os from "node:os";
11
+ import path from "node:path";
12
+ import fs from "node:fs";
13
+ import JSON5 from "json5";
14
+ import crypto from "node:crypto";
15
+ import AjvPkg from "ajv";
16
+ import { z } from "zod";
17
+
18
+ //#region src/version.ts
19
+ const CORE_PACKAGE_NAME = "synurex";
20
+ const PACKAGE_JSON_CANDIDATES = [
21
+ "../package.json",
22
+ "../../package.json",
23
+ "../../../package.json",
24
+ "./package.json"
25
+ ];
26
+ const BUILD_INFO_CANDIDATES = [
27
+ "../build-info.json",
28
+ "../../build-info.json",
29
+ "./build-info.json"
30
+ ];
31
+ function readVersionFromJsonCandidates(moduleUrl, candidates, opts = {}) {
32
+ try {
33
+ const require = createRequire(moduleUrl);
34
+ for (const candidate of candidates) try {
35
+ const parsed = require(candidate);
36
+ const version = parsed.version?.trim();
37
+ if (!version) continue;
38
+ if (opts.requirePackageName && parsed.name !== CORE_PACKAGE_NAME) continue;
39
+ return version;
40
+ } catch {}
41
+ return null;
42
+ } catch {
43
+ return null;
44
+ }
45
+ }
46
+ function readVersionFromPackageJsonForModuleUrl(moduleUrl) {
47
+ return readVersionFromJsonCandidates(moduleUrl, PACKAGE_JSON_CANDIDATES, { requirePackageName: true });
48
+ }
49
+ function readVersionFromBuildInfoForModuleUrl(moduleUrl) {
50
+ return readVersionFromJsonCandidates(moduleUrl, BUILD_INFO_CANDIDATES);
51
+ }
52
+ function resolveVersionFromModuleUrl(moduleUrl) {
53
+ return readVersionFromPackageJsonForModuleUrl(moduleUrl) || readVersionFromBuildInfoForModuleUrl(moduleUrl);
54
+ }
55
+ const VERSION = typeof __SYNUREX_VERSION__ === "string" && __SYNUREX_VERSION__ || process.env.SYNUREX_BUNDLED_VERSION || resolveVersionFromModuleUrl(import.meta.url) || "0.0.0";
56
+
57
+ //#endregion
58
+ //#region src/config/agent-dirs.ts
59
+ var DuplicateAgentDirError = class extends Error {
60
+ constructor(duplicates) {
61
+ super(formatDuplicateAgentDirError(duplicates));
62
+ this.name = "DuplicateAgentDirError";
63
+ this.duplicates = duplicates;
64
+ }
65
+ };
66
+ function canonicalizeAgentDir(agentDir) {
67
+ const resolved = path.resolve(agentDir);
68
+ if (process.platform === "darwin" || process.platform === "win32") return resolved.toLowerCase();
69
+ return resolved;
70
+ }
71
+ function collectReferencedAgentIds(cfg) {
72
+ const ids = /* @__PURE__ */ new Set();
73
+ const agents = Array.isArray(cfg.agents?.list) ? cfg.agents?.list : [];
74
+ const defaultAgentId = agents.find((agent) => agent?.default)?.id ?? agents[0]?.id ?? DEFAULT_AGENT_ID;
75
+ ids.add(normalizeAgentId(defaultAgentId));
76
+ for (const entry of agents) if (entry?.id) ids.add(normalizeAgentId(entry.id));
77
+ const bindings = cfg.bindings;
78
+ if (Array.isArray(bindings)) for (const binding of bindings) {
79
+ const id = binding?.agentId;
80
+ if (typeof id === "string" && id.trim()) ids.add(normalizeAgentId(id));
81
+ }
82
+ return [...ids];
83
+ }
84
+ function resolveEffectiveAgentDir(cfg, agentId, deps) {
85
+ const id = normalizeAgentId(agentId);
86
+ const trimmed = (Array.isArray(cfg.agents?.list) ? cfg.agents?.list.find((agent) => normalizeAgentId(agent.id) === id)?.agentDir : void 0)?.trim();
87
+ if (trimmed) return resolveUserPath(trimmed);
88
+ const root = resolveStateDir(deps?.env ?? process.env, deps?.homedir ?? os.homedir);
89
+ return path.join(root, "agents", id, "agent");
90
+ }
91
+ function findDuplicateAgentDirs(cfg, deps) {
92
+ const byDir = /* @__PURE__ */ new Map();
93
+ for (const agentId of collectReferencedAgentIds(cfg)) {
94
+ const agentDir = resolveEffectiveAgentDir(cfg, agentId, deps);
95
+ const key = canonicalizeAgentDir(agentDir);
96
+ const entry = byDir.get(key);
97
+ if (entry) entry.agentIds.push(agentId);
98
+ else byDir.set(key, {
99
+ agentDir,
100
+ agentIds: [agentId]
101
+ });
102
+ }
103
+ return [...byDir.values()].filter((v) => v.agentIds.length > 1);
104
+ }
105
+ function formatDuplicateAgentDirError(dups) {
106
+ return [
107
+ "Duplicate agentDir detected (multi-agent config).",
108
+ "Each agent must have a unique agentDir; sharing it causes auth/session state collisions and token invalidation.",
109
+ "",
110
+ "Conflicts:",
111
+ ...dups.map((d) => `- ${d.agentDir}: ${d.agentIds.map((id) => `"${id}"`).join(", ")}`),
112
+ "",
113
+ "Fix: remove the shared agents.list[].agentDir override (or give each agent its own directory).",
114
+ "If you want to share credentials, copy auth-profiles.json instead of sharing the entire agentDir."
115
+ ].join("\n");
116
+ }
117
+
118
+ //#endregion
119
+ //#region src/config/agent-limits.ts
120
+ const DEFAULT_AGENT_MAX_CONCURRENT = 4;
121
+ const DEFAULT_SUBAGENT_MAX_CONCURRENT = 8;
122
+ function resolveAgentMaxConcurrent(cfg) {
123
+ const raw = cfg?.agents?.defaults?.maxConcurrent;
124
+ if (typeof raw === "number" && Number.isFinite(raw)) return Math.max(1, Math.floor(raw));
125
+ return DEFAULT_AGENT_MAX_CONCURRENT;
126
+ }
127
+ function resolveSubagentMaxConcurrent(cfg) {
128
+ const raw = cfg?.agents?.defaults?.subagents?.maxConcurrent;
129
+ if (typeof raw === "number" && Number.isFinite(raw)) return Math.max(1, Math.floor(raw));
130
+ return DEFAULT_SUBAGENT_MAX_CONCURRENT;
131
+ }
132
+
133
+ //#endregion
134
+ //#region src/config/talk.ts
135
+ function readTalkApiKeyFromProfile(deps = {}) {
136
+ const fsImpl = deps.fs ?? fs;
137
+ const osImpl = deps.os ?? os;
138
+ const pathImpl = deps.path ?? path;
139
+ const home = osImpl.homedir();
140
+ const candidates = [
141
+ ".profile",
142
+ ".zprofile",
143
+ ".zshrc",
144
+ ".bashrc"
145
+ ].map((name) => pathImpl.join(home, name));
146
+ for (const candidate of candidates) {
147
+ if (!fsImpl.existsSync(candidate)) continue;
148
+ try {
149
+ const value = fsImpl.readFileSync(candidate, "utf-8").match(/(?:^|\n)\s*(?:export\s+)?ELEVENLABS_API_KEY\s*=\s*["']?([^\n"']+)["']?/)?.[1]?.trim();
150
+ if (value) return value;
151
+ } catch {}
152
+ }
153
+ return null;
154
+ }
155
+ function resolveTalkApiKey(env = process.env, deps = {}) {
156
+ const envValue = (env.ELEVENLABS_API_KEY ?? "").trim();
157
+ if (envValue) return envValue;
158
+ return readTalkApiKeyFromProfile(deps);
159
+ }
160
+
161
+ //#endregion
162
+ //#region src/config/defaults.ts
163
+ let defaultWarnState = { warned: false };
164
+ const DEFAULT_MODEL_ALIASES = {
165
+ opus: "anthropic/claude-opus-4-6",
166
+ sonnet: "anthropic/claude-sonnet-4-5",
167
+ gpt: "openai/gpt-5.2",
168
+ "gpt-mini": "openai/gpt-5-mini",
169
+ gemini: "google/gemini-3-pro-preview",
170
+ "gemini-flash": "google/gemini-3-flash-preview"
171
+ };
172
+ const DEFAULT_MODEL_COST = {
173
+ input: 0,
174
+ output: 0,
175
+ cacheRead: 0,
176
+ cacheWrite: 0
177
+ };
178
+ const DEFAULT_MODEL_INPUT = ["text"];
179
+ const DEFAULT_MODEL_MAX_TOKENS = 8192;
180
+ function isPositiveNumber(value) {
181
+ return typeof value === "number" && Number.isFinite(value) && value > 0;
182
+ }
183
+ function resolveModelCost(raw) {
184
+ return {
185
+ input: typeof raw?.input === "number" ? raw.input : DEFAULT_MODEL_COST.input,
186
+ output: typeof raw?.output === "number" ? raw.output : DEFAULT_MODEL_COST.output,
187
+ cacheRead: typeof raw?.cacheRead === "number" ? raw.cacheRead : DEFAULT_MODEL_COST.cacheRead,
188
+ cacheWrite: typeof raw?.cacheWrite === "number" ? raw.cacheWrite : DEFAULT_MODEL_COST.cacheWrite
189
+ };
190
+ }
191
+ function resolveAnthropicDefaultAuthMode(cfg) {
192
+ const profiles = cfg.auth?.profiles ?? {};
193
+ const anthropicProfiles = Object.entries(profiles).filter(([, profile]) => profile?.provider === "anthropic");
194
+ const order = cfg.auth?.order?.anthropic ?? [];
195
+ for (const profileId of order) {
196
+ const entry = profiles[profileId];
197
+ if (!entry || entry.provider !== "anthropic") continue;
198
+ if (entry.mode === "api_key") return "api_key";
199
+ if (entry.mode === "oauth" || entry.mode === "token") return "oauth";
200
+ }
201
+ const hasApiKey = anthropicProfiles.some(([, profile]) => profile?.mode === "api_key");
202
+ const hasOauth = anthropicProfiles.some(([, profile]) => profile?.mode === "oauth" || profile?.mode === "token");
203
+ if (hasApiKey && !hasOauth) return "api_key";
204
+ if (hasOauth && !hasApiKey) return "oauth";
205
+ if (process.env.ANTHROPIC_OAUTH_TOKEN?.trim()) return "oauth";
206
+ if (process.env.ANTHROPIC_API_KEY?.trim()) return "api_key";
207
+ return null;
208
+ }
209
+ function resolvePrimaryModelRef(raw) {
210
+ if (!raw || typeof raw !== "string") return null;
211
+ const trimmed = raw.trim();
212
+ if (!trimmed) return null;
213
+ return DEFAULT_MODEL_ALIASES[trimmed.toLowerCase()] ?? trimmed;
214
+ }
215
+ function applyMessageDefaults(cfg) {
216
+ const messages = cfg.messages;
217
+ if (messages?.ackReactionScope !== void 0) return cfg;
218
+ const nextMessages = messages ? { ...messages } : {};
219
+ nextMessages.ackReactionScope = "group-mentions";
220
+ return {
221
+ ...cfg,
222
+ messages: nextMessages
223
+ };
224
+ }
225
+ function applySessionDefaults(cfg, options = {}) {
226
+ const session = cfg.session;
227
+ if (!session || session.mainKey === void 0) return cfg;
228
+ const trimmed = session.mainKey.trim();
229
+ const warn = options.warn ?? console.warn;
230
+ const warnState = options.warnState ?? defaultWarnState;
231
+ const next = {
232
+ ...cfg,
233
+ session: {
234
+ ...session,
235
+ mainKey: "main"
236
+ }
237
+ };
238
+ if (trimmed && trimmed !== "main" && !warnState.warned) {
239
+ warnState.warned = true;
240
+ warn("session.mainKey is ignored; main session is always \"main\".");
241
+ }
242
+ return next;
243
+ }
244
+ function applyTalkApiKey(config) {
245
+ const resolved = resolveTalkApiKey();
246
+ if (!resolved) return config;
247
+ if (config.talk?.apiKey?.trim()) return config;
248
+ return {
249
+ ...config,
250
+ talk: {
251
+ ...config.talk,
252
+ apiKey: resolved
253
+ }
254
+ };
255
+ }
256
+ function applyModelDefaults(cfg) {
257
+ let mutated = false;
258
+ let nextCfg = cfg;
259
+ const providerConfig = nextCfg.models?.providers;
260
+ if (providerConfig) {
261
+ const nextProviders = { ...providerConfig };
262
+ for (const [providerId, provider] of Object.entries(providerConfig)) {
263
+ const models = provider.models;
264
+ if (!Array.isArray(models) || models.length === 0) continue;
265
+ let providerMutated = false;
266
+ const nextModels = models.map((model) => {
267
+ const raw = model;
268
+ let modelMutated = false;
269
+ const reasoning = typeof raw.reasoning === "boolean" ? raw.reasoning : false;
270
+ if (raw.reasoning !== reasoning) modelMutated = true;
271
+ const input = raw.input ?? [...DEFAULT_MODEL_INPUT];
272
+ if (raw.input === void 0) modelMutated = true;
273
+ const cost = resolveModelCost(raw.cost);
274
+ 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;
275
+ const contextWindow = isPositiveNumber(raw.contextWindow) ? raw.contextWindow : DEFAULT_CONTEXT_TOKENS;
276
+ if (raw.contextWindow !== contextWindow) modelMutated = true;
277
+ const defaultMaxTokens = Math.min(DEFAULT_MODEL_MAX_TOKENS, contextWindow);
278
+ const maxTokens = isPositiveNumber(raw.maxTokens) ? raw.maxTokens : defaultMaxTokens;
279
+ if (raw.maxTokens !== maxTokens) modelMutated = true;
280
+ if (!modelMutated) return model;
281
+ providerMutated = true;
282
+ return {
283
+ ...raw,
284
+ reasoning,
285
+ input,
286
+ cost,
287
+ contextWindow,
288
+ maxTokens
289
+ };
290
+ });
291
+ if (!providerMutated) continue;
292
+ nextProviders[providerId] = {
293
+ ...provider,
294
+ models: nextModels
295
+ };
296
+ mutated = true;
297
+ }
298
+ if (mutated) nextCfg = {
299
+ ...nextCfg,
300
+ models: {
301
+ ...nextCfg.models,
302
+ providers: nextProviders
303
+ }
304
+ };
305
+ }
306
+ const existingAgent = nextCfg.agents?.defaults;
307
+ if (!existingAgent) return mutated ? nextCfg : cfg;
308
+ const existingModels = existingAgent.models ?? {};
309
+ if (Object.keys(existingModels).length === 0) return mutated ? nextCfg : cfg;
310
+ const nextModels = { ...existingModels };
311
+ for (const [alias, target] of Object.entries(DEFAULT_MODEL_ALIASES)) {
312
+ const entry = nextModels[target];
313
+ if (!entry) continue;
314
+ if (entry.alias !== void 0) continue;
315
+ nextModels[target] = {
316
+ ...entry,
317
+ alias
318
+ };
319
+ mutated = true;
320
+ }
321
+ if (!mutated) return cfg;
322
+ return {
323
+ ...nextCfg,
324
+ agents: {
325
+ ...nextCfg.agents,
326
+ defaults: {
327
+ ...existingAgent,
328
+ models: nextModels
329
+ }
330
+ }
331
+ };
332
+ }
333
+ function applyAgentDefaults(cfg) {
334
+ const agents = cfg.agents;
335
+ const defaults = agents?.defaults;
336
+ const hasMax = typeof defaults?.maxConcurrent === "number" && Number.isFinite(defaults.maxConcurrent);
337
+ const hasSubMax = typeof defaults?.subagents?.maxConcurrent === "number" && Number.isFinite(defaults.subagents.maxConcurrent);
338
+ if (hasMax && hasSubMax) return cfg;
339
+ let mutated = false;
340
+ const nextDefaults = defaults ? { ...defaults } : {};
341
+ if (!hasMax) {
342
+ nextDefaults.maxConcurrent = DEFAULT_AGENT_MAX_CONCURRENT;
343
+ mutated = true;
344
+ }
345
+ const nextSubagents = defaults?.subagents ? { ...defaults.subagents } : {};
346
+ if (!hasSubMax) {
347
+ nextSubagents.maxConcurrent = DEFAULT_SUBAGENT_MAX_CONCURRENT;
348
+ mutated = true;
349
+ }
350
+ if (!mutated) return cfg;
351
+ return {
352
+ ...cfg,
353
+ agents: {
354
+ ...agents,
355
+ defaults: {
356
+ ...nextDefaults,
357
+ subagents: nextSubagents
358
+ }
359
+ }
360
+ };
361
+ }
362
+ function applyLoggingDefaults(cfg) {
363
+ const logging = cfg.logging;
364
+ if (!logging) return cfg;
365
+ if (logging.redactSensitive) return cfg;
366
+ return {
367
+ ...cfg,
368
+ logging: {
369
+ ...logging,
370
+ redactSensitive: "tools"
371
+ }
372
+ };
373
+ }
374
+ function applyContextPruningDefaults(cfg) {
375
+ const defaults = cfg.agents?.defaults;
376
+ if (!defaults) return cfg;
377
+ const authMode = resolveAnthropicDefaultAuthMode(cfg);
378
+ if (!authMode) return cfg;
379
+ let mutated = false;
380
+ const nextDefaults = { ...defaults };
381
+ const contextPruning = defaults.contextPruning ?? {};
382
+ const heartbeat = defaults.heartbeat ?? {};
383
+ if (defaults.contextPruning?.mode === void 0) {
384
+ nextDefaults.contextPruning = {
385
+ ...contextPruning,
386
+ mode: "cache-ttl",
387
+ ttl: defaults.contextPruning?.ttl ?? "1h"
388
+ };
389
+ mutated = true;
390
+ }
391
+ if (defaults.heartbeat?.every === void 0) {
392
+ nextDefaults.heartbeat = {
393
+ ...heartbeat,
394
+ every: authMode === "oauth" ? "1h" : "30m"
395
+ };
396
+ mutated = true;
397
+ }
398
+ if (authMode === "api_key") {
399
+ const nextModels = defaults.models ? { ...defaults.models } : {};
400
+ let modelsMutated = false;
401
+ for (const [key, entry] of Object.entries(nextModels)) {
402
+ const parsed = parseModelRef(key, "anthropic");
403
+ if (!parsed || parsed.provider !== "anthropic") continue;
404
+ const current = entry ?? {};
405
+ const params = current.params ?? {};
406
+ if (typeof params.cacheRetention === "string") continue;
407
+ nextModels[key] = {
408
+ ...current,
409
+ params: {
410
+ ...params,
411
+ cacheRetention: "short"
412
+ }
413
+ };
414
+ modelsMutated = true;
415
+ }
416
+ const primary = resolvePrimaryModelRef(defaults.model?.primary ?? void 0);
417
+ if (primary) {
418
+ const parsedPrimary = parseModelRef(primary, "anthropic");
419
+ if (parsedPrimary?.provider === "anthropic") {
420
+ const key = `${parsedPrimary.provider}/${parsedPrimary.model}`;
421
+ const current = nextModels[key] ?? {};
422
+ const params = current.params ?? {};
423
+ if (typeof params.cacheRetention !== "string") {
424
+ nextModels[key] = {
425
+ ...current,
426
+ params: {
427
+ ...params,
428
+ cacheRetention: "short"
429
+ }
430
+ };
431
+ modelsMutated = true;
432
+ }
433
+ }
434
+ }
435
+ if (modelsMutated) {
436
+ nextDefaults.models = nextModels;
437
+ mutated = true;
438
+ }
439
+ }
440
+ if (!mutated) return cfg;
441
+ return {
442
+ ...cfg,
443
+ agents: {
444
+ ...cfg.agents,
445
+ defaults: nextDefaults
446
+ }
447
+ };
448
+ }
449
+ function applyCompactionDefaults(cfg) {
450
+ const defaults = cfg.agents?.defaults;
451
+ if (!defaults) return cfg;
452
+ const compaction = defaults?.compaction;
453
+ if (compaction?.mode) return cfg;
454
+ return {
455
+ ...cfg,
456
+ agents: {
457
+ ...cfg.agents,
458
+ defaults: {
459
+ ...defaults,
460
+ compaction: {
461
+ ...compaction,
462
+ mode: "safeguard"
463
+ }
464
+ }
465
+ }
466
+ };
467
+ }
468
+
469
+ //#endregion
470
+ //#region src/config/env-substitution.ts
471
+ /**
472
+ * Environment variable substitution for config values.
473
+ *
474
+ * Supports `${VAR_NAME}` syntax in string values, substituted at config load time.
475
+ * - Only uppercase env vars are matched: `[A-Z_][A-Z0-9_]*`
476
+ * - Escape with `$${}` to output literal `${}`
477
+ * - Missing env vars throw `MissingEnvVarError` with context
478
+ *
479
+ * @example
480
+ * ```json5
481
+ * {
482
+ * models: {
483
+ * providers: {
484
+ * "vercel-gateway": {
485
+ * apiKey: "${VERCEL_GATEWAY_API_KEY}"
486
+ * }
487
+ * }
488
+ * }
489
+ * }
490
+ * ```
491
+ */
492
+ const ENV_VAR_NAME_PATTERN = /^[A-Z_][A-Z0-9_]*$/;
493
+ var MissingEnvVarError = class extends Error {
494
+ constructor(varName, configPath) {
495
+ super(`Missing env var "${varName}" referenced at config path: ${configPath}`);
496
+ this.varName = varName;
497
+ this.configPath = configPath;
498
+ this.name = "MissingEnvVarError";
499
+ }
500
+ };
501
+ function isPlainObject$4(value) {
502
+ return typeof value === "object" && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
503
+ }
504
+ function substituteString(value, env, configPath) {
505
+ if (!value.includes("$")) return value;
506
+ const chunks = [];
507
+ for (let i = 0; i < value.length; i += 1) {
508
+ const char = value[i];
509
+ if (char !== "$") {
510
+ chunks.push(char);
511
+ continue;
512
+ }
513
+ const next = value[i + 1];
514
+ const afterNext = value[i + 2];
515
+ if (next === "$" && afterNext === "{") {
516
+ const start = i + 3;
517
+ const end = value.indexOf("}", start);
518
+ if (end !== -1) {
519
+ const name = value.slice(start, end);
520
+ if (ENV_VAR_NAME_PATTERN.test(name)) {
521
+ chunks.push(`\${${name}}`);
522
+ i = end;
523
+ continue;
524
+ }
525
+ }
526
+ }
527
+ if (next === "{") {
528
+ const start = i + 2;
529
+ const end = value.indexOf("}", start);
530
+ if (end !== -1) {
531
+ const name = value.slice(start, end);
532
+ if (ENV_VAR_NAME_PATTERN.test(name)) {
533
+ const envValue = env[name];
534
+ if (envValue === void 0 || envValue === "") throw new MissingEnvVarError(name, configPath);
535
+ chunks.push(envValue);
536
+ i = end;
537
+ continue;
538
+ }
539
+ }
540
+ }
541
+ chunks.push(char);
542
+ }
543
+ return chunks.join("");
544
+ }
545
+ function substituteAny(value, env, path) {
546
+ if (typeof value === "string") return substituteString(value, env, path);
547
+ if (Array.isArray(value)) return value.map((item, index) => substituteAny(item, env, `${path}[${index}]`));
548
+ if (isPlainObject$4(value)) {
549
+ const result = {};
550
+ for (const [key, val] of Object.entries(value)) result[key] = substituteAny(val, env, path ? `${path}.${key}` : key);
551
+ return result;
552
+ }
553
+ return value;
554
+ }
555
+ /**
556
+ * Resolves `${VAR_NAME}` environment variable references in config values.
557
+ *
558
+ * @param obj - The parsed config object (after JSON5 parse and $include resolution)
559
+ * @param env - Environment variables to use for substitution (defaults to process.env)
560
+ * @returns The config object with env vars substituted
561
+ * @throws {MissingEnvVarError} If a referenced env var is not set or empty
562
+ */
563
+ function resolveConfigEnvVars(obj, env = process.env) {
564
+ return substituteAny(obj, env, "");
565
+ }
566
+
567
+ //#endregion
568
+ //#region src/config/env-vars.ts
569
+ function collectConfigEnvVars(cfg) {
570
+ const envConfig = cfg?.env;
571
+ if (!envConfig) return {};
572
+ const entries = {};
573
+ if (envConfig.vars) for (const [key, value] of Object.entries(envConfig.vars)) {
574
+ if (!value) continue;
575
+ entries[key] = value;
576
+ }
577
+ for (const [key, value] of Object.entries(envConfig)) {
578
+ if (key === "shellEnv" || key === "vars") continue;
579
+ if (typeof value !== "string" || !value.trim()) continue;
580
+ entries[key] = value;
581
+ }
582
+ return entries;
583
+ }
584
+
585
+ //#endregion
586
+ //#region src/config/includes.ts
587
+ /**
588
+ * Config includes: $include directive for modular configs
589
+ *
590
+ * @example
591
+ * ```json5
592
+ * {
593
+ * "$include": "./base.json5", // single file
594
+ * "$include": ["./a.json5", "./b.json5"] // merge multiple
595
+ * }
596
+ * ```
597
+ */
598
+ const INCLUDE_KEY = "$include";
599
+ const MAX_INCLUDE_DEPTH = 10;
600
+ var ConfigIncludeError = class extends Error {
601
+ constructor(message, includePath, cause) {
602
+ super(message);
603
+ this.includePath = includePath;
604
+ this.cause = cause;
605
+ this.name = "ConfigIncludeError";
606
+ }
607
+ };
608
+ var CircularIncludeError = class extends ConfigIncludeError {
609
+ constructor(chain) {
610
+ super(`Circular include detected: ${chain.join(" -> ")}`, chain[chain.length - 1]);
611
+ this.chain = chain;
612
+ this.name = "CircularIncludeError";
613
+ }
614
+ };
615
+ function isPlainObject$3(value) {
616
+ return typeof value === "object" && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
617
+ }
618
+ /** Deep merge: arrays concatenate, objects merge recursively, primitives: source wins */
619
+ function deepMerge(target, source) {
620
+ if (Array.isArray(target) && Array.isArray(source)) return [...target, ...source];
621
+ if (isPlainObject$3(target) && isPlainObject$3(source)) {
622
+ const result = { ...target };
623
+ for (const key of Object.keys(source)) result[key] = key in result ? deepMerge(result[key], source[key]) : source[key];
624
+ return result;
625
+ }
626
+ return source;
627
+ }
628
+ var IncludeProcessor = class IncludeProcessor {
629
+ constructor(basePath, resolver) {
630
+ this.basePath = basePath;
631
+ this.resolver = resolver;
632
+ this.visited = /* @__PURE__ */ new Set();
633
+ this.depth = 0;
634
+ this.visited.add(path.normalize(basePath));
635
+ }
636
+ process(obj) {
637
+ if (Array.isArray(obj)) return obj.map((item) => this.process(item));
638
+ if (!isPlainObject$3(obj)) return obj;
639
+ if (!(INCLUDE_KEY in obj)) return this.processObject(obj);
640
+ return this.processInclude(obj);
641
+ }
642
+ processObject(obj) {
643
+ const result = {};
644
+ for (const [key, value] of Object.entries(obj)) result[key] = this.process(value);
645
+ return result;
646
+ }
647
+ processInclude(obj) {
648
+ const includeValue = obj[INCLUDE_KEY];
649
+ const otherKeys = Object.keys(obj).filter((k) => k !== INCLUDE_KEY);
650
+ const included = this.resolveInclude(includeValue);
651
+ if (otherKeys.length === 0) return included;
652
+ if (!isPlainObject$3(included)) throw new ConfigIncludeError("Sibling keys require included content to be an object", typeof includeValue === "string" ? includeValue : INCLUDE_KEY);
653
+ const rest = {};
654
+ for (const key of otherKeys) rest[key] = this.process(obj[key]);
655
+ return deepMerge(included, rest);
656
+ }
657
+ resolveInclude(value) {
658
+ if (typeof value === "string") return this.loadFile(value);
659
+ if (Array.isArray(value)) return value.reduce((merged, item) => {
660
+ if (typeof item !== "string") throw new ConfigIncludeError(`Invalid $include array item: expected string, got ${typeof item}`, String(item));
661
+ return deepMerge(merged, this.loadFile(item));
662
+ }, {});
663
+ throw new ConfigIncludeError(`Invalid $include value: expected string or array of strings, got ${typeof value}`, String(value));
664
+ }
665
+ loadFile(includePath) {
666
+ const resolvedPath = this.resolvePath(includePath);
667
+ this.checkCircular(resolvedPath);
668
+ this.checkDepth(includePath);
669
+ const raw = this.readFile(includePath, resolvedPath);
670
+ const parsed = this.parseFile(includePath, resolvedPath, raw);
671
+ return this.processNested(resolvedPath, parsed);
672
+ }
673
+ resolvePath(includePath) {
674
+ const resolved = path.isAbsolute(includePath) ? includePath : path.resolve(path.dirname(this.basePath), includePath);
675
+ return path.normalize(resolved);
676
+ }
677
+ checkCircular(resolvedPath) {
678
+ if (this.visited.has(resolvedPath)) throw new CircularIncludeError([...this.visited, resolvedPath]);
679
+ }
680
+ checkDepth(includePath) {
681
+ if (this.depth >= MAX_INCLUDE_DEPTH) throw new ConfigIncludeError(`Maximum include depth (${MAX_INCLUDE_DEPTH}) exceeded at: ${includePath}`, includePath);
682
+ }
683
+ readFile(includePath, resolvedPath) {
684
+ try {
685
+ return this.resolver.readFile(resolvedPath);
686
+ } catch (err) {
687
+ throw new ConfigIncludeError(`Failed to read include file: ${includePath} (resolved: ${resolvedPath})`, includePath, err instanceof Error ? err : void 0);
688
+ }
689
+ }
690
+ parseFile(includePath, resolvedPath, raw) {
691
+ try {
692
+ return this.resolver.parseJson(raw);
693
+ } catch (err) {
694
+ throw new ConfigIncludeError(`Failed to parse include file: ${includePath} (resolved: ${resolvedPath})`, includePath, err instanceof Error ? err : void 0);
695
+ }
696
+ }
697
+ processNested(resolvedPath, parsed) {
698
+ const nested = new IncludeProcessor(resolvedPath, this.resolver);
699
+ nested.visited = new Set([...this.visited, resolvedPath]);
700
+ nested.depth = this.depth + 1;
701
+ return nested.process(parsed);
702
+ }
703
+ };
704
+ const defaultResolver = {
705
+ readFile: (p) => fs.readFileSync(p, "utf-8"),
706
+ parseJson: (raw) => JSON5.parse(raw)
707
+ };
708
+ /**
709
+ * Resolves all $include directives in a parsed config object.
710
+ */
711
+ function resolveConfigIncludes(obj, configPath, resolver = defaultResolver) {
712
+ return new IncludeProcessor(configPath, resolver).process(obj);
713
+ }
714
+
715
+ //#endregion
716
+ //#region src/config/legacy.shared.ts
717
+ const isRecord$1 = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
718
+ const getRecord = (value) => isRecord$1(value) ? value : null;
719
+ const ensureRecord = (root, key) => {
720
+ const existing = root[key];
721
+ if (isRecord$1(existing)) return existing;
722
+ const next = {};
723
+ root[key] = next;
724
+ return next;
725
+ };
726
+ const mergeMissing = (target, source) => {
727
+ for (const [key, value] of Object.entries(source)) {
728
+ if (value === void 0) continue;
729
+ const existing = target[key];
730
+ if (existing === void 0) {
731
+ target[key] = value;
732
+ continue;
733
+ }
734
+ if (isRecord$1(existing) && isRecord$1(value)) mergeMissing(existing, value);
735
+ }
736
+ };
737
+ const AUDIO_TRANSCRIPTION_CLI_ALLOWLIST = new Set(["whisper"]);
738
+ const mapLegacyAudioTranscription = (value) => {
739
+ const transcriber = getRecord(value);
740
+ const command = Array.isArray(transcriber?.command) ? transcriber?.command : null;
741
+ if (!command || command.length === 0) return null;
742
+ const rawExecutable = String(command[0] ?? "").trim();
743
+ if (!rawExecutable) return null;
744
+ const executableName = rawExecutable.split(/[\\/]/).pop() ?? rawExecutable;
745
+ if (!AUDIO_TRANSCRIPTION_CLI_ALLOWLIST.has(executableName)) return null;
746
+ const args = command.slice(1).map((part) => String(part));
747
+ const timeoutSeconds = typeof transcriber?.timeoutSeconds === "number" ? transcriber?.timeoutSeconds : void 0;
748
+ const result = {
749
+ command: rawExecutable,
750
+ type: "cli"
751
+ };
752
+ if (args.length > 0) result.args = args;
753
+ if (timeoutSeconds !== void 0) result.timeoutSeconds = timeoutSeconds;
754
+ return result;
755
+ };
756
+ const getAgentsList = (agents) => {
757
+ const list = agents?.list;
758
+ return Array.isArray(list) ? list : [];
759
+ };
760
+ const resolveDefaultAgentIdFromRaw = (raw) => {
761
+ const list = getAgentsList(getRecord(raw.agents));
762
+ const defaultEntry = list.find((entry) => isRecord$1(entry) && entry.default === true && typeof entry.id === "string" && entry.id.trim() !== "");
763
+ if (defaultEntry) return defaultEntry.id.trim();
764
+ const routing = getRecord(raw.routing);
765
+ const routingDefault = typeof routing?.defaultAgentId === "string" ? routing.defaultAgentId.trim() : "";
766
+ if (routingDefault) return routingDefault;
767
+ const firstEntry = list.find((entry) => isRecord$1(entry) && typeof entry.id === "string" && entry.id.trim() !== "");
768
+ if (firstEntry) return firstEntry.id.trim();
769
+ return "main";
770
+ };
771
+ const ensureAgentEntry = (list, id) => {
772
+ const normalized = id.trim();
773
+ const existing = list.find((entry) => isRecord$1(entry) && typeof entry.id === "string" && entry.id.trim() === normalized);
774
+ if (existing) return existing;
775
+ const created = { id: normalized };
776
+ list.push(created);
777
+ return created;
778
+ };
779
+
780
+ //#endregion
781
+ //#region src/config/legacy.migrations.part-1.ts
782
+ const LEGACY_CONFIG_MIGRATIONS_PART_1 = [
783
+ {
784
+ id: "bindings.match.provider->bindings.match.channel",
785
+ describe: "Move bindings[].match.provider to bindings[].match.channel",
786
+ apply: (raw, changes) => {
787
+ const bindings = Array.isArray(raw.bindings) ? raw.bindings : null;
788
+ if (!bindings) return;
789
+ let touched = false;
790
+ for (const entry of bindings) {
791
+ if (!isRecord$1(entry)) continue;
792
+ const match = getRecord(entry.match);
793
+ if (!match) continue;
794
+ if (typeof match.channel === "string" && match.channel.trim()) continue;
795
+ const provider = typeof match.provider === "string" ? match.provider.trim() : "";
796
+ if (!provider) continue;
797
+ match.channel = provider;
798
+ delete match.provider;
799
+ entry.match = match;
800
+ touched = true;
801
+ }
802
+ if (touched) {
803
+ raw.bindings = bindings;
804
+ changes.push("Moved bindings[].match.provider → bindings[].match.channel.");
805
+ }
806
+ }
807
+ },
808
+ {
809
+ id: "bindings.match.accountID->bindings.match.accountId",
810
+ describe: "Move bindings[].match.accountID to bindings[].match.accountId",
811
+ apply: (raw, changes) => {
812
+ const bindings = Array.isArray(raw.bindings) ? raw.bindings : null;
813
+ if (!bindings) return;
814
+ let touched = false;
815
+ for (const entry of bindings) {
816
+ if (!isRecord$1(entry)) continue;
817
+ const match = getRecord(entry.match);
818
+ if (!match) continue;
819
+ if (match.accountId !== void 0) continue;
820
+ const accountID = typeof match.accountID === "string" ? match.accountID.trim() : match.accountID;
821
+ if (!accountID) continue;
822
+ match.accountId = accountID;
823
+ delete match.accountID;
824
+ entry.match = match;
825
+ touched = true;
826
+ }
827
+ if (touched) {
828
+ raw.bindings = bindings;
829
+ changes.push("Moved bindings[].match.accountID → bindings[].match.accountId.");
830
+ }
831
+ }
832
+ },
833
+ {
834
+ id: "session.sendPolicy.rules.match.provider->match.channel",
835
+ describe: "Move session.sendPolicy.rules[].match.provider to match.channel",
836
+ apply: (raw, changes) => {
837
+ const session = getRecord(raw.session);
838
+ if (!session) return;
839
+ const sendPolicy = getRecord(session.sendPolicy);
840
+ if (!sendPolicy) return;
841
+ const rules = Array.isArray(sendPolicy.rules) ? sendPolicy.rules : null;
842
+ if (!rules) return;
843
+ let touched = false;
844
+ for (const rule of rules) {
845
+ if (!isRecord$1(rule)) continue;
846
+ const match = getRecord(rule.match);
847
+ if (!match) continue;
848
+ if (typeof match.channel === "string" && match.channel.trim()) continue;
849
+ const provider = typeof match.provider === "string" ? match.provider.trim() : "";
850
+ if (!provider) continue;
851
+ match.channel = provider;
852
+ delete match.provider;
853
+ rule.match = match;
854
+ touched = true;
855
+ }
856
+ if (touched) {
857
+ sendPolicy.rules = rules;
858
+ session.sendPolicy = sendPolicy;
859
+ raw.session = session;
860
+ changes.push("Moved session.sendPolicy.rules[].match.provider → match.channel.");
861
+ }
862
+ }
863
+ },
864
+ {
865
+ id: "messages.queue.byProvider->byChannel",
866
+ describe: "Move messages.queue.byProvider to messages.queue.byChannel",
867
+ apply: (raw, changes) => {
868
+ const messages = getRecord(raw.messages);
869
+ if (!messages) return;
870
+ const queue = getRecord(messages.queue);
871
+ if (!queue) return;
872
+ if (queue.byProvider === void 0) return;
873
+ if (queue.byChannel === void 0) {
874
+ queue.byChannel = queue.byProvider;
875
+ changes.push("Moved messages.queue.byProvider → messages.queue.byChannel.");
876
+ } else changes.push("Removed messages.queue.byProvider (messages.queue.byChannel already set).");
877
+ delete queue.byProvider;
878
+ messages.queue = queue;
879
+ raw.messages = messages;
880
+ }
881
+ },
882
+ {
883
+ id: "providers->channels",
884
+ describe: "Move provider config sections to channels.*",
885
+ apply: (raw, changes) => {
886
+ const legacyEntries = [
887
+ "whatsapp",
888
+ "telegram",
889
+ "discord",
890
+ "slack",
891
+ "signal",
892
+ "imessage",
893
+ "msteams"
894
+ ].filter((key) => isRecord$1(raw[key]));
895
+ if (legacyEntries.length === 0) return;
896
+ const channels = ensureRecord(raw, "channels");
897
+ for (const key of legacyEntries) {
898
+ const legacy = getRecord(raw[key]);
899
+ if (!legacy) continue;
900
+ const channelEntry = ensureRecord(channels, key);
901
+ const hadEntries = Object.keys(channelEntry).length > 0;
902
+ mergeMissing(channelEntry, legacy);
903
+ channels[key] = channelEntry;
904
+ delete raw[key];
905
+ changes.push(hadEntries ? `Merged ${key} → channels.${key}.` : `Moved ${key} → channels.${key}.`);
906
+ }
907
+ raw.channels = channels;
908
+ }
909
+ },
910
+ {
911
+ id: "routing.allowFrom->channels.whatsapp.allowFrom",
912
+ describe: "Move routing.allowFrom to channels.whatsapp.allowFrom",
913
+ apply: (raw, changes) => {
914
+ const routing = raw.routing;
915
+ if (!routing || typeof routing !== "object") return;
916
+ const allowFrom = routing.allowFrom;
917
+ if (allowFrom === void 0) return;
918
+ const channels = getRecord(raw.channels);
919
+ const whatsapp = channels ? getRecord(channels.whatsapp) : null;
920
+ if (!whatsapp) {
921
+ delete routing.allowFrom;
922
+ if (Object.keys(routing).length === 0) delete raw.routing;
923
+ changes.push("Removed routing.allowFrom (channels.whatsapp not configured).");
924
+ return;
925
+ }
926
+ if (whatsapp.allowFrom === void 0) {
927
+ whatsapp.allowFrom = allowFrom;
928
+ changes.push("Moved routing.allowFrom → channels.whatsapp.allowFrom.");
929
+ } else changes.push("Removed routing.allowFrom (channels.whatsapp.allowFrom already set).");
930
+ delete routing.allowFrom;
931
+ if (Object.keys(routing).length === 0) delete raw.routing;
932
+ channels.whatsapp = whatsapp;
933
+ raw.channels = channels;
934
+ }
935
+ },
936
+ {
937
+ id: "routing.groupChat.requireMention->groups.*.requireMention",
938
+ describe: "Move routing.groupChat.requireMention to channels.whatsapp/telegram/imessage groups",
939
+ apply: (raw, changes) => {
940
+ const routing = raw.routing;
941
+ if (!routing || typeof routing !== "object") return;
942
+ const groupChat = routing.groupChat && typeof routing.groupChat === "object" ? routing.groupChat : null;
943
+ if (!groupChat) return;
944
+ const requireMention = groupChat.requireMention;
945
+ if (requireMention === void 0) return;
946
+ const channels = ensureRecord(raw, "channels");
947
+ const applyTo = (key, options) => {
948
+ if (options?.requireExisting && !isRecord$1(channels[key])) return;
949
+ const section = channels[key] && typeof channels[key] === "object" ? channels[key] : {};
950
+ const groups = section.groups && typeof section.groups === "object" ? section.groups : {};
951
+ const defaultKey = "*";
952
+ const entry = groups[defaultKey] && typeof groups[defaultKey] === "object" ? groups[defaultKey] : {};
953
+ if (entry.requireMention === void 0) {
954
+ entry.requireMention = requireMention;
955
+ groups[defaultKey] = entry;
956
+ section.groups = groups;
957
+ channels[key] = section;
958
+ changes.push(`Moved routing.groupChat.requireMention → channels.${key}.groups."*".requireMention.`);
959
+ } else changes.push(`Removed routing.groupChat.requireMention (channels.${key}.groups."*" already set).`);
960
+ };
961
+ applyTo("whatsapp", { requireExisting: true });
962
+ applyTo("telegram");
963
+ applyTo("imessage");
964
+ delete groupChat.requireMention;
965
+ if (Object.keys(groupChat).length === 0) delete routing.groupChat;
966
+ if (Object.keys(routing).length === 0) delete raw.routing;
967
+ raw.channels = channels;
968
+ }
969
+ },
970
+ {
971
+ id: "gateway.token->gateway.auth.token",
972
+ describe: "Move gateway.token to gateway.auth.token",
973
+ apply: (raw, changes) => {
974
+ const gateway = raw.gateway;
975
+ if (!gateway || typeof gateway !== "object") return;
976
+ const token = gateway.token;
977
+ if (token === void 0) return;
978
+ const gatewayObj = gateway;
979
+ const auth = gatewayObj.auth && typeof gatewayObj.auth === "object" ? gatewayObj.auth : {};
980
+ if (auth.token === void 0) {
981
+ auth.token = token;
982
+ if (!auth.mode) auth.mode = "token";
983
+ changes.push("Moved gateway.token → gateway.auth.token.");
984
+ } else changes.push("Removed gateway.token (gateway.auth.token already set).");
985
+ delete gatewayObj.token;
986
+ if (Object.keys(auth).length > 0) gatewayObj.auth = auth;
987
+ raw.gateway = gatewayObj;
988
+ }
989
+ },
990
+ {
991
+ id: "telegram.requireMention->channels.telegram.groups.*.requireMention",
992
+ describe: "Move telegram.requireMention to channels.telegram.groups.*.requireMention",
993
+ apply: (raw, changes) => {
994
+ const channels = ensureRecord(raw, "channels");
995
+ const telegram = channels.telegram;
996
+ if (!telegram || typeof telegram !== "object") return;
997
+ const requireMention = telegram.requireMention;
998
+ if (requireMention === void 0) return;
999
+ const groups = telegram.groups && typeof telegram.groups === "object" ? telegram.groups : {};
1000
+ const defaultKey = "*";
1001
+ const entry = groups[defaultKey] && typeof groups[defaultKey] === "object" ? groups[defaultKey] : {};
1002
+ if (entry.requireMention === void 0) {
1003
+ entry.requireMention = requireMention;
1004
+ groups[defaultKey] = entry;
1005
+ telegram.groups = groups;
1006
+ changes.push("Moved telegram.requireMention → channels.telegram.groups.\"*\".requireMention.");
1007
+ } else changes.push("Removed telegram.requireMention (channels.telegram.groups.\"*\" already set).");
1008
+ delete telegram.requireMention;
1009
+ channels.telegram = telegram;
1010
+ raw.channels = channels;
1011
+ }
1012
+ }
1013
+ ];
1014
+
1015
+ //#endregion
1016
+ //#region src/config/legacy.migrations.part-2.ts
1017
+ const LEGACY_CONFIG_MIGRATIONS_PART_2 = [
1018
+ {
1019
+ id: "agent.model-config-v2",
1020
+ describe: "Migrate legacy agent.model/allowedModels/modelAliases/modelFallbacks/imageModelFallbacks to agent.models + model lists",
1021
+ apply: (raw, changes) => {
1022
+ const agentRoot = getRecord(raw.agent);
1023
+ const defaults = getRecord(getRecord(raw.agents)?.defaults);
1024
+ const agent = agentRoot ?? defaults;
1025
+ if (!agent) return;
1026
+ const label = agentRoot ? "agent" : "agents.defaults";
1027
+ const legacyModel = typeof agent.model === "string" ? String(agent.model) : void 0;
1028
+ const legacyImageModel = typeof agent.imageModel === "string" ? String(agent.imageModel) : void 0;
1029
+ const legacyAllowed = Array.isArray(agent.allowedModels) ? agent.allowedModels.map(String) : [];
1030
+ const legacyModelFallbacks = Array.isArray(agent.modelFallbacks) ? agent.modelFallbacks.map(String) : [];
1031
+ const legacyImageModelFallbacks = Array.isArray(agent.imageModelFallbacks) ? agent.imageModelFallbacks.map(String) : [];
1032
+ const legacyAliases = agent.modelAliases && typeof agent.modelAliases === "object" ? agent.modelAliases : {};
1033
+ if (!(legacyModel || legacyImageModel || legacyAllowed.length > 0 || legacyModelFallbacks.length > 0 || legacyImageModelFallbacks.length > 0 || Object.keys(legacyAliases).length > 0)) return;
1034
+ const models = agent.models && typeof agent.models === "object" ? agent.models : {};
1035
+ const ensureModel = (rawKey) => {
1036
+ if (typeof rawKey !== "string") return;
1037
+ const key = rawKey.trim();
1038
+ if (!key) return;
1039
+ if (!models[key]) models[key] = {};
1040
+ };
1041
+ ensureModel(legacyModel);
1042
+ ensureModel(legacyImageModel);
1043
+ for (const key of legacyAllowed) ensureModel(key);
1044
+ for (const key of legacyModelFallbacks) ensureModel(key);
1045
+ for (const key of legacyImageModelFallbacks) ensureModel(key);
1046
+ for (const target of Object.values(legacyAliases)) {
1047
+ if (typeof target !== "string") continue;
1048
+ ensureModel(target);
1049
+ }
1050
+ for (const [alias, targetRaw] of Object.entries(legacyAliases)) {
1051
+ if (typeof targetRaw !== "string") continue;
1052
+ const target = targetRaw.trim();
1053
+ if (!target) continue;
1054
+ const entry = models[target] && typeof models[target] === "object" ? models[target] : {};
1055
+ if (!("alias" in entry)) {
1056
+ entry.alias = alias;
1057
+ models[target] = entry;
1058
+ }
1059
+ }
1060
+ const currentModel = agent.model && typeof agent.model === "object" ? agent.model : null;
1061
+ if (currentModel) {
1062
+ if (!currentModel.primary && legacyModel) currentModel.primary = legacyModel;
1063
+ if (legacyModelFallbacks.length > 0 && (!Array.isArray(currentModel.fallbacks) || currentModel.fallbacks.length === 0)) currentModel.fallbacks = legacyModelFallbacks;
1064
+ agent.model = currentModel;
1065
+ } else if (legacyModel || legacyModelFallbacks.length > 0) agent.model = {
1066
+ primary: legacyModel,
1067
+ fallbacks: legacyModelFallbacks.length ? legacyModelFallbacks : []
1068
+ };
1069
+ const currentImageModel = agent.imageModel && typeof agent.imageModel === "object" ? agent.imageModel : null;
1070
+ if (currentImageModel) {
1071
+ if (!currentImageModel.primary && legacyImageModel) currentImageModel.primary = legacyImageModel;
1072
+ if (legacyImageModelFallbacks.length > 0 && (!Array.isArray(currentImageModel.fallbacks) || currentImageModel.fallbacks.length === 0)) currentImageModel.fallbacks = legacyImageModelFallbacks;
1073
+ agent.imageModel = currentImageModel;
1074
+ } else if (legacyImageModel || legacyImageModelFallbacks.length > 0) agent.imageModel = {
1075
+ primary: legacyImageModel,
1076
+ fallbacks: legacyImageModelFallbacks.length ? legacyImageModelFallbacks : []
1077
+ };
1078
+ agent.models = models;
1079
+ if (legacyModel !== void 0) changes.push(`Migrated ${label}.model string → ${label}.model.primary.`);
1080
+ if (legacyModelFallbacks.length > 0) changes.push(`Migrated ${label}.modelFallbacks → ${label}.model.fallbacks.`);
1081
+ if (legacyImageModel !== void 0) changes.push(`Migrated ${label}.imageModel string → ${label}.imageModel.primary.`);
1082
+ if (legacyImageModelFallbacks.length > 0) changes.push(`Migrated ${label}.imageModelFallbacks → ${label}.imageModel.fallbacks.`);
1083
+ if (legacyAllowed.length > 0) changes.push(`Migrated ${label}.allowedModels → ${label}.models.`);
1084
+ if (Object.keys(legacyAliases).length > 0) changes.push(`Migrated ${label}.modelAliases → ${label}.models.*.alias.`);
1085
+ delete agent.allowedModels;
1086
+ delete agent.modelAliases;
1087
+ delete agent.modelFallbacks;
1088
+ delete agent.imageModelFallbacks;
1089
+ }
1090
+ },
1091
+ {
1092
+ id: "routing.agents-v2",
1093
+ describe: "Move routing.agents/defaultAgentId to agents.list",
1094
+ apply: (raw, changes) => {
1095
+ const routing = getRecord(raw.routing);
1096
+ if (!routing) return;
1097
+ const routingAgents = getRecord(routing.agents);
1098
+ const agents = ensureRecord(raw, "agents");
1099
+ const list = getAgentsList(agents);
1100
+ if (routingAgents) {
1101
+ for (const [rawId, entryRaw] of Object.entries(routingAgents)) {
1102
+ const agentId = String(rawId ?? "").trim();
1103
+ const entry = getRecord(entryRaw);
1104
+ if (!agentId || !entry) continue;
1105
+ const target = ensureAgentEntry(list, agentId);
1106
+ const entryCopy = { ...entry };
1107
+ if ("mentionPatterns" in entryCopy) {
1108
+ const mentionPatterns = entryCopy.mentionPatterns;
1109
+ const groupChat = ensureRecord(target, "groupChat");
1110
+ if (groupChat.mentionPatterns === void 0) {
1111
+ groupChat.mentionPatterns = mentionPatterns;
1112
+ changes.push(`Moved routing.agents.${agentId}.mentionPatterns → agents.list (id "${agentId}").groupChat.mentionPatterns.`);
1113
+ } else changes.push(`Removed routing.agents.${agentId}.mentionPatterns (agents.list groupChat mentionPatterns already set).`);
1114
+ delete entryCopy.mentionPatterns;
1115
+ }
1116
+ const legacyGroupChat = getRecord(entryCopy.groupChat);
1117
+ if (legacyGroupChat) {
1118
+ mergeMissing(ensureRecord(target, "groupChat"), legacyGroupChat);
1119
+ delete entryCopy.groupChat;
1120
+ }
1121
+ const legacySandbox = getRecord(entryCopy.sandbox);
1122
+ if (legacySandbox) {
1123
+ const sandboxTools = getRecord(legacySandbox.tools);
1124
+ if (sandboxTools) {
1125
+ mergeMissing(ensureRecord(ensureRecord(ensureRecord(target, "tools"), "sandbox"), "tools"), sandboxTools);
1126
+ delete legacySandbox.tools;
1127
+ changes.push(`Moved routing.agents.${agentId}.sandbox.tools → agents.list (id "${agentId}").tools.sandbox.tools.`);
1128
+ }
1129
+ entryCopy.sandbox = legacySandbox;
1130
+ }
1131
+ mergeMissing(target, entryCopy);
1132
+ }
1133
+ delete routing.agents;
1134
+ changes.push("Moved routing.agents → agents.list.");
1135
+ }
1136
+ const defaultAgentId = typeof routing.defaultAgentId === "string" ? routing.defaultAgentId.trim() : "";
1137
+ if (defaultAgentId) {
1138
+ if (!list.some((entry) => isRecord$1(entry) && entry.default === true)) {
1139
+ const entry = ensureAgentEntry(list, defaultAgentId);
1140
+ entry.default = true;
1141
+ changes.push(`Moved routing.defaultAgentId → agents.list (id "${defaultAgentId}").default.`);
1142
+ } else changes.push("Removed routing.defaultAgentId (agents.list default already set).");
1143
+ delete routing.defaultAgentId;
1144
+ }
1145
+ if (list.length > 0) agents.list = list;
1146
+ if (Object.keys(routing).length === 0) delete raw.routing;
1147
+ }
1148
+ },
1149
+ {
1150
+ id: "routing.config-v2",
1151
+ describe: "Move routing bindings/groupChat/queue/agentToAgent/transcribeAudio",
1152
+ apply: (raw, changes) => {
1153
+ const routing = getRecord(raw.routing);
1154
+ if (!routing) return;
1155
+ if (routing.bindings !== void 0) {
1156
+ if (raw.bindings === void 0) {
1157
+ raw.bindings = routing.bindings;
1158
+ changes.push("Moved routing.bindings → bindings.");
1159
+ } else changes.push("Removed routing.bindings (bindings already set).");
1160
+ delete routing.bindings;
1161
+ }
1162
+ if (routing.agentToAgent !== void 0) {
1163
+ const tools = ensureRecord(raw, "tools");
1164
+ if (tools.agentToAgent === void 0) {
1165
+ tools.agentToAgent = routing.agentToAgent;
1166
+ changes.push("Moved routing.agentToAgent → tools.agentToAgent.");
1167
+ } else changes.push("Removed routing.agentToAgent (tools.agentToAgent already set).");
1168
+ delete routing.agentToAgent;
1169
+ }
1170
+ if (routing.queue !== void 0) {
1171
+ const messages = ensureRecord(raw, "messages");
1172
+ if (messages.queue === void 0) {
1173
+ messages.queue = routing.queue;
1174
+ changes.push("Moved routing.queue → messages.queue.");
1175
+ } else changes.push("Removed routing.queue (messages.queue already set).");
1176
+ delete routing.queue;
1177
+ }
1178
+ const groupChat = getRecord(routing.groupChat);
1179
+ if (groupChat) {
1180
+ const historyLimit = groupChat.historyLimit;
1181
+ if (historyLimit !== void 0) {
1182
+ const messagesGroup = ensureRecord(ensureRecord(raw, "messages"), "groupChat");
1183
+ if (messagesGroup.historyLimit === void 0) {
1184
+ messagesGroup.historyLimit = historyLimit;
1185
+ changes.push("Moved routing.groupChat.historyLimit → messages.groupChat.historyLimit.");
1186
+ } else changes.push("Removed routing.groupChat.historyLimit (messages.groupChat.historyLimit already set).");
1187
+ delete groupChat.historyLimit;
1188
+ }
1189
+ const mentionPatterns = groupChat.mentionPatterns;
1190
+ if (mentionPatterns !== void 0) {
1191
+ const messagesGroup = ensureRecord(ensureRecord(raw, "messages"), "groupChat");
1192
+ if (messagesGroup.mentionPatterns === void 0) {
1193
+ messagesGroup.mentionPatterns = mentionPatterns;
1194
+ changes.push("Moved routing.groupChat.mentionPatterns → messages.groupChat.mentionPatterns.");
1195
+ } else changes.push("Removed routing.groupChat.mentionPatterns (messages.groupChat.mentionPatterns already set).");
1196
+ delete groupChat.mentionPatterns;
1197
+ }
1198
+ if (Object.keys(groupChat).length === 0) delete routing.groupChat;
1199
+ else routing.groupChat = groupChat;
1200
+ }
1201
+ if (routing.transcribeAudio !== void 0) {
1202
+ const mapped = mapLegacyAudioTranscription(routing.transcribeAudio);
1203
+ if (mapped) {
1204
+ const mediaAudio = ensureRecord(ensureRecord(ensureRecord(raw, "tools"), "media"), "audio");
1205
+ if ((Array.isArray(mediaAudio.models) ? mediaAudio.models : []).length === 0) {
1206
+ mediaAudio.enabled = true;
1207
+ mediaAudio.models = [mapped];
1208
+ changes.push("Moved routing.transcribeAudio → tools.media.audio.models.");
1209
+ } else changes.push("Removed routing.transcribeAudio (tools.media.audio.models already set).");
1210
+ } else changes.push("Removed routing.transcribeAudio (unsupported transcription CLI).");
1211
+ delete routing.transcribeAudio;
1212
+ }
1213
+ const audio = getRecord(raw.audio);
1214
+ if (audio?.transcription !== void 0) {
1215
+ const mapped = mapLegacyAudioTranscription(audio.transcription);
1216
+ if (mapped) {
1217
+ const mediaAudio = ensureRecord(ensureRecord(ensureRecord(raw, "tools"), "media"), "audio");
1218
+ if ((Array.isArray(mediaAudio.models) ? mediaAudio.models : []).length === 0) {
1219
+ mediaAudio.enabled = true;
1220
+ mediaAudio.models = [mapped];
1221
+ changes.push("Moved audio.transcription → tools.media.audio.models.");
1222
+ } else changes.push("Removed audio.transcription (tools.media.audio.models already set).");
1223
+ delete audio.transcription;
1224
+ if (Object.keys(audio).length === 0) delete raw.audio;
1225
+ else raw.audio = audio;
1226
+ } else {
1227
+ delete audio.transcription;
1228
+ changes.push("Removed audio.transcription (unsupported transcription CLI).");
1229
+ if (Object.keys(audio).length === 0) delete raw.audio;
1230
+ else raw.audio = audio;
1231
+ }
1232
+ }
1233
+ if (Object.keys(routing).length === 0) delete raw.routing;
1234
+ }
1235
+ }
1236
+ ];
1237
+
1238
+ //#endregion
1239
+ //#region src/config/legacy.migrations.part-3.ts
1240
+ const LEGACY_CONFIG_MIGRATIONS_PART_3 = [
1241
+ {
1242
+ id: "auth.anthropic-claude-cli-mode-oauth",
1243
+ describe: "Switch anthropic:claude-cli auth profile mode to oauth",
1244
+ apply: (raw, changes) => {
1245
+ const profiles = getRecord(getRecord(raw.auth)?.profiles);
1246
+ if (!profiles) return;
1247
+ const claudeCli = getRecord(profiles["anthropic:claude-cli"]);
1248
+ if (!claudeCli) return;
1249
+ if (claudeCli.mode !== "token") return;
1250
+ claudeCli.mode = "oauth";
1251
+ changes.push("Updated auth.profiles[\"anthropic:claude-cli\"].mode → \"oauth\".");
1252
+ }
1253
+ },
1254
+ {
1255
+ id: "tools.bash->tools.exec",
1256
+ describe: "Move tools.bash to tools.exec",
1257
+ apply: (raw, changes) => {
1258
+ const tools = ensureRecord(raw, "tools");
1259
+ const bash = getRecord(tools.bash);
1260
+ if (!bash) return;
1261
+ if (tools.exec === void 0) {
1262
+ tools.exec = bash;
1263
+ changes.push("Moved tools.bash → tools.exec.");
1264
+ } else changes.push("Removed tools.bash (tools.exec already set).");
1265
+ delete tools.bash;
1266
+ }
1267
+ },
1268
+ {
1269
+ id: "messages.tts.enabled->auto",
1270
+ describe: "Move messages.tts.enabled to messages.tts.auto",
1271
+ apply: (raw, changes) => {
1272
+ const tts = getRecord(getRecord(raw.messages)?.tts);
1273
+ if (!tts) return;
1274
+ if (tts.auto !== void 0) {
1275
+ if ("enabled" in tts) {
1276
+ delete tts.enabled;
1277
+ changes.push("Removed messages.tts.enabled (messages.tts.auto already set).");
1278
+ }
1279
+ return;
1280
+ }
1281
+ if (typeof tts.enabled !== "boolean") return;
1282
+ tts.auto = tts.enabled ? "always" : "off";
1283
+ delete tts.enabled;
1284
+ changes.push(`Moved messages.tts.enabled → messages.tts.auto (${String(tts.auto)}).`);
1285
+ }
1286
+ },
1287
+ {
1288
+ id: "agent.defaults-v2",
1289
+ describe: "Move agent config to agents.defaults and tools",
1290
+ apply: (raw, changes) => {
1291
+ const agent = getRecord(raw.agent);
1292
+ if (!agent) return;
1293
+ const agents = ensureRecord(raw, "agents");
1294
+ const defaults = getRecord(agents.defaults) ?? {};
1295
+ const tools = ensureRecord(raw, "tools");
1296
+ const agentTools = getRecord(agent.tools);
1297
+ if (agentTools) {
1298
+ if (tools.allow === void 0 && agentTools.allow !== void 0) {
1299
+ tools.allow = agentTools.allow;
1300
+ changes.push("Moved agent.tools.allow → tools.allow.");
1301
+ }
1302
+ if (tools.deny === void 0 && agentTools.deny !== void 0) {
1303
+ tools.deny = agentTools.deny;
1304
+ changes.push("Moved agent.tools.deny → tools.deny.");
1305
+ }
1306
+ }
1307
+ const elevated = getRecord(agent.elevated);
1308
+ if (elevated) if (tools.elevated === void 0) {
1309
+ tools.elevated = elevated;
1310
+ changes.push("Moved agent.elevated → tools.elevated.");
1311
+ } else changes.push("Removed agent.elevated (tools.elevated already set).");
1312
+ const bash = getRecord(agent.bash);
1313
+ if (bash) if (tools.exec === void 0) {
1314
+ tools.exec = bash;
1315
+ changes.push("Moved agent.bash → tools.exec.");
1316
+ } else changes.push("Removed agent.bash (tools.exec already set).");
1317
+ const sandbox = getRecord(agent.sandbox);
1318
+ if (sandbox) {
1319
+ const sandboxTools = getRecord(sandbox.tools);
1320
+ if (sandboxTools) {
1321
+ mergeMissing(ensureRecord(ensureRecord(tools, "sandbox"), "tools"), sandboxTools);
1322
+ delete sandbox.tools;
1323
+ changes.push("Moved agent.sandbox.tools → tools.sandbox.tools.");
1324
+ }
1325
+ }
1326
+ const subagents = getRecord(agent.subagents);
1327
+ if (subagents) {
1328
+ const subagentTools = getRecord(subagents.tools);
1329
+ if (subagentTools) {
1330
+ mergeMissing(ensureRecord(ensureRecord(tools, "subagents"), "tools"), subagentTools);
1331
+ delete subagents.tools;
1332
+ changes.push("Moved agent.subagents.tools → tools.subagents.tools.");
1333
+ }
1334
+ }
1335
+ const agentCopy = structuredClone(agent);
1336
+ delete agentCopy.tools;
1337
+ delete agentCopy.elevated;
1338
+ delete agentCopy.bash;
1339
+ if (isRecord$1(agentCopy.sandbox)) delete agentCopy.sandbox.tools;
1340
+ if (isRecord$1(agentCopy.subagents)) delete agentCopy.subagents.tools;
1341
+ mergeMissing(defaults, agentCopy);
1342
+ agents.defaults = defaults;
1343
+ raw.agents = agents;
1344
+ delete raw.agent;
1345
+ changes.push("Moved agent → agents.defaults.");
1346
+ }
1347
+ },
1348
+ {
1349
+ id: "identity->agents.list",
1350
+ describe: "Move identity to agents.list[].identity",
1351
+ apply: (raw, changes) => {
1352
+ const identity = getRecord(raw.identity);
1353
+ if (!identity) return;
1354
+ const agents = ensureRecord(raw, "agents");
1355
+ const list = getAgentsList(agents);
1356
+ const defaultId = resolveDefaultAgentIdFromRaw(raw);
1357
+ const entry = ensureAgentEntry(list, defaultId);
1358
+ if (entry.identity === void 0) {
1359
+ entry.identity = identity;
1360
+ changes.push(`Moved identity → agents.list (id "${defaultId}").identity.`);
1361
+ } else changes.push("Removed identity (agents.list identity already set).");
1362
+ agents.list = list;
1363
+ raw.agents = agents;
1364
+ delete raw.identity;
1365
+ }
1366
+ }
1367
+ ];
1368
+
1369
+ //#endregion
1370
+ //#region src/config/legacy.migrations.ts
1371
+ const LEGACY_CONFIG_MIGRATIONS = [
1372
+ ...LEGACY_CONFIG_MIGRATIONS_PART_1,
1373
+ ...LEGACY_CONFIG_MIGRATIONS_PART_2,
1374
+ ...LEGACY_CONFIG_MIGRATIONS_PART_3
1375
+ ];
1376
+
1377
+ //#endregion
1378
+ //#region src/config/legacy.rules.ts
1379
+ const LEGACY_CONFIG_RULES = [
1380
+ {
1381
+ path: ["whatsapp"],
1382
+ message: "whatsapp config moved to channels.whatsapp (auto-migrated on load)."
1383
+ },
1384
+ {
1385
+ path: ["telegram"],
1386
+ message: "telegram config moved to channels.telegram (auto-migrated on load)."
1387
+ },
1388
+ {
1389
+ path: ["discord"],
1390
+ message: "discord config moved to channels.discord (auto-migrated on load)."
1391
+ },
1392
+ {
1393
+ path: ["slack"],
1394
+ message: "slack config moved to channels.slack (auto-migrated on load)."
1395
+ },
1396
+ {
1397
+ path: ["signal"],
1398
+ message: "signal config moved to channels.signal (auto-migrated on load)."
1399
+ },
1400
+ {
1401
+ path: ["imessage"],
1402
+ message: "imessage config moved to channels.imessage (auto-migrated on load)."
1403
+ },
1404
+ {
1405
+ path: ["msteams"],
1406
+ message: "msteams config moved to channels.msteams (auto-migrated on load)."
1407
+ },
1408
+ {
1409
+ path: ["routing", "allowFrom"],
1410
+ message: "routing.allowFrom was removed; use channels.whatsapp.allowFrom instead (auto-migrated on load)."
1411
+ },
1412
+ {
1413
+ path: ["routing", "bindings"],
1414
+ message: "routing.bindings was moved; use top-level bindings instead (auto-migrated on load)."
1415
+ },
1416
+ {
1417
+ path: ["routing", "agents"],
1418
+ message: "routing.agents was moved; use agents.list instead (auto-migrated on load)."
1419
+ },
1420
+ {
1421
+ path: ["routing", "defaultAgentId"],
1422
+ message: "routing.defaultAgentId was moved; use agents.list[].default instead (auto-migrated on load)."
1423
+ },
1424
+ {
1425
+ path: ["routing", "agentToAgent"],
1426
+ message: "routing.agentToAgent was moved; use tools.agentToAgent instead (auto-migrated on load)."
1427
+ },
1428
+ {
1429
+ path: [
1430
+ "routing",
1431
+ "groupChat",
1432
+ "requireMention"
1433
+ ],
1434
+ message: "routing.groupChat.requireMention was removed; use channels.whatsapp/telegram/imessage groups defaults (e.g. channels.whatsapp.groups.\"*\".requireMention) instead (auto-migrated on load)."
1435
+ },
1436
+ {
1437
+ path: [
1438
+ "routing",
1439
+ "groupChat",
1440
+ "mentionPatterns"
1441
+ ],
1442
+ message: "routing.groupChat.mentionPatterns was moved; use agents.list[].groupChat.mentionPatterns or messages.groupChat.mentionPatterns instead (auto-migrated on load)."
1443
+ },
1444
+ {
1445
+ path: ["routing", "queue"],
1446
+ message: "routing.queue was moved; use messages.queue instead (auto-migrated on load)."
1447
+ },
1448
+ {
1449
+ path: ["routing", "transcribeAudio"],
1450
+ message: "routing.transcribeAudio was moved; use tools.media.audio.models instead (auto-migrated on load)."
1451
+ },
1452
+ {
1453
+ path: ["telegram", "requireMention"],
1454
+ message: "telegram.requireMention was removed; use channels.telegram.groups.\"*\".requireMention instead (auto-migrated on load)."
1455
+ },
1456
+ {
1457
+ path: ["identity"],
1458
+ message: "identity was moved; use agents.list[].identity instead (auto-migrated on load)."
1459
+ },
1460
+ {
1461
+ path: ["agent"],
1462
+ message: "agent.* was moved; use agents.defaults (and tools.* for tool/elevated/exec settings) instead (auto-migrated on load)."
1463
+ },
1464
+ {
1465
+ path: ["tools", "bash"],
1466
+ message: "tools.bash was removed; use tools.exec instead (auto-migrated on load)."
1467
+ },
1468
+ {
1469
+ path: ["agent", "model"],
1470
+ message: "agent.model string was replaced by agents.defaults.model.primary/fallbacks and agents.defaults.models (auto-migrated on load).",
1471
+ match: (value) => typeof value === "string"
1472
+ },
1473
+ {
1474
+ path: ["agent", "imageModel"],
1475
+ message: "agent.imageModel string was replaced by agents.defaults.imageModel.primary/fallbacks (auto-migrated on load).",
1476
+ match: (value) => typeof value === "string"
1477
+ },
1478
+ {
1479
+ path: ["agent", "allowedModels"],
1480
+ message: "agent.allowedModels was replaced by agents.defaults.models (auto-migrated on load)."
1481
+ },
1482
+ {
1483
+ path: ["agent", "modelAliases"],
1484
+ message: "agent.modelAliases was replaced by agents.defaults.models.*.alias (auto-migrated on load)."
1485
+ },
1486
+ {
1487
+ path: ["agent", "modelFallbacks"],
1488
+ message: "agent.modelFallbacks was replaced by agents.defaults.model.fallbacks (auto-migrated on load)."
1489
+ },
1490
+ {
1491
+ path: ["agent", "imageModelFallbacks"],
1492
+ message: "agent.imageModelFallbacks was replaced by agents.defaults.imageModel.fallbacks (auto-migrated on load)."
1493
+ },
1494
+ {
1495
+ path: [
1496
+ "messages",
1497
+ "tts",
1498
+ "enabled"
1499
+ ],
1500
+ message: "messages.tts.enabled was replaced by messages.tts.auto (auto-migrated on load)."
1501
+ },
1502
+ {
1503
+ path: ["gateway", "token"],
1504
+ message: "gateway.token is ignored; use gateway.auth.token instead (auto-migrated on load)."
1505
+ }
1506
+ ];
1507
+
1508
+ //#endregion
1509
+ //#region src/config/legacy.ts
1510
+ function findLegacyConfigIssues(raw) {
1511
+ if (!raw || typeof raw !== "object") return [];
1512
+ const root = raw;
1513
+ const issues = [];
1514
+ for (const rule of LEGACY_CONFIG_RULES) {
1515
+ let cursor = root;
1516
+ for (const key of rule.path) {
1517
+ if (!cursor || typeof cursor !== "object") {
1518
+ cursor = void 0;
1519
+ break;
1520
+ }
1521
+ cursor = cursor[key];
1522
+ }
1523
+ if (cursor !== void 0 && (!rule.match || rule.match(cursor, root))) issues.push({
1524
+ path: rule.path.join("."),
1525
+ message: rule.message
1526
+ });
1527
+ }
1528
+ return issues;
1529
+ }
1530
+ function applyLegacyMigrations(raw) {
1531
+ if (!raw || typeof raw !== "object") return {
1532
+ next: null,
1533
+ changes: []
1534
+ };
1535
+ const next = structuredClone(raw);
1536
+ const changes = [];
1537
+ for (const migration of LEGACY_CONFIG_MIGRATIONS) migration.apply(next, changes);
1538
+ if (changes.length === 0) return {
1539
+ next: null,
1540
+ changes: []
1541
+ };
1542
+ return {
1543
+ next,
1544
+ changes
1545
+ };
1546
+ }
1547
+
1548
+ //#endregion
1549
+ //#region src/config/normalize-paths.ts
1550
+ const PATH_VALUE_RE = /^~(?=$|[\\/])/;
1551
+ const PATH_KEY_RE = /(dir|path|paths|file|root|workspace)$/i;
1552
+ const PATH_LIST_KEYS = new Set(["paths", "pathPrepend"]);
1553
+ function isPlainObject$2(value) {
1554
+ return Boolean(value) && typeof value === "object" && !Array.isArray(value);
1555
+ }
1556
+ function normalizeStringValue(key, value) {
1557
+ if (!PATH_VALUE_RE.test(value.trim())) return value;
1558
+ if (!key) return value;
1559
+ if (PATH_KEY_RE.test(key) || PATH_LIST_KEYS.has(key)) return resolveUserPath(value);
1560
+ return value;
1561
+ }
1562
+ function normalizeAny(key, value) {
1563
+ if (typeof value === "string") return normalizeStringValue(key, value);
1564
+ if (Array.isArray(value)) {
1565
+ const normalizeChildren = Boolean(key && PATH_LIST_KEYS.has(key));
1566
+ return value.map((entry) => {
1567
+ if (typeof entry === "string") return normalizeChildren ? normalizeStringValue(key, entry) : entry;
1568
+ if (Array.isArray(entry)) return normalizeAny(void 0, entry);
1569
+ if (isPlainObject$2(entry)) return normalizeAny(void 0, entry);
1570
+ return entry;
1571
+ });
1572
+ }
1573
+ if (!isPlainObject$2(value)) return value;
1574
+ for (const [childKey, childValue] of Object.entries(value)) {
1575
+ const next = normalizeAny(childKey, childValue);
1576
+ if (next !== childValue) value[childKey] = next;
1577
+ }
1578
+ return value;
1579
+ }
1580
+ /**
1581
+ * Normalize "~" paths in path-ish config fields.
1582
+ *
1583
+ * Goal: accept `~/...` consistently across config file + env overrides, while
1584
+ * keeping the surface area small and predictable.
1585
+ */
1586
+ function normalizeConfigPaths(cfg) {
1587
+ if (!cfg || typeof cfg !== "object") return cfg;
1588
+ normalizeAny(void 0, cfg);
1589
+ return cfg;
1590
+ }
1591
+
1592
+ //#endregion
1593
+ //#region src/config/config-paths.ts
1594
+ const BLOCKED_KEYS = new Set([
1595
+ "__proto__",
1596
+ "prototype",
1597
+ "constructor"
1598
+ ]);
1599
+ function parseConfigPath(raw) {
1600
+ const trimmed = raw.trim();
1601
+ if (!trimmed) return {
1602
+ ok: false,
1603
+ error: "Invalid path. Use dot notation (e.g. foo.bar)."
1604
+ };
1605
+ const parts = trimmed.split(".").map((part) => part.trim());
1606
+ if (parts.some((part) => !part)) return {
1607
+ ok: false,
1608
+ error: "Invalid path. Use dot notation (e.g. foo.bar)."
1609
+ };
1610
+ if (parts.some((part) => BLOCKED_KEYS.has(part))) return {
1611
+ ok: false,
1612
+ error: "Invalid path segment."
1613
+ };
1614
+ return {
1615
+ ok: true,
1616
+ path: parts
1617
+ };
1618
+ }
1619
+ function setConfigValueAtPath(root, path, value) {
1620
+ let cursor = root;
1621
+ for (let idx = 0; idx < path.length - 1; idx += 1) {
1622
+ const key = path[idx];
1623
+ const next = cursor[key];
1624
+ if (!isPlainObject$1(next)) cursor[key] = {};
1625
+ cursor = cursor[key];
1626
+ }
1627
+ cursor[path[path.length - 1]] = value;
1628
+ }
1629
+ function unsetConfigValueAtPath(root, path) {
1630
+ const stack = [];
1631
+ let cursor = root;
1632
+ for (let idx = 0; idx < path.length - 1; idx += 1) {
1633
+ const key = path[idx];
1634
+ const next = cursor[key];
1635
+ if (!isPlainObject$1(next)) return false;
1636
+ stack.push({
1637
+ node: cursor,
1638
+ key
1639
+ });
1640
+ cursor = next;
1641
+ }
1642
+ const leafKey = path[path.length - 1];
1643
+ if (!(leafKey in cursor)) return false;
1644
+ delete cursor[leafKey];
1645
+ for (let idx = stack.length - 1; idx >= 0; idx -= 1) {
1646
+ const { node, key } = stack[idx];
1647
+ const child = node[key];
1648
+ if (isPlainObject$1(child) && Object.keys(child).length === 0) delete node[key];
1649
+ else break;
1650
+ }
1651
+ return true;
1652
+ }
1653
+ function getConfigValueAtPath(root, path) {
1654
+ let cursor = root;
1655
+ for (const key of path) {
1656
+ if (!isPlainObject$1(cursor)) return;
1657
+ cursor = cursor[key];
1658
+ }
1659
+ return cursor;
1660
+ }
1661
+ function isPlainObject$1(value) {
1662
+ return typeof value === "object" && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
1663
+ }
1664
+
1665
+ //#endregion
1666
+ //#region src/config/runtime-overrides.ts
1667
+ let overrides = {};
1668
+ function mergeOverrides(base, override) {
1669
+ if (!isPlainObject(base) || !isPlainObject(override)) return override;
1670
+ const next = { ...base };
1671
+ for (const [key, value] of Object.entries(override)) {
1672
+ if (value === void 0) continue;
1673
+ next[key] = mergeOverrides(base[key], value);
1674
+ }
1675
+ return next;
1676
+ }
1677
+ function isPlainObject(value) {
1678
+ return typeof value === "object" && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
1679
+ }
1680
+ function getConfigOverrides() {
1681
+ return overrides;
1682
+ }
1683
+ function resetConfigOverrides() {
1684
+ overrides = {};
1685
+ }
1686
+ function setConfigOverride(pathRaw, value) {
1687
+ const parsed = parseConfigPath(pathRaw);
1688
+ if (!parsed.ok || !parsed.path) return {
1689
+ ok: false,
1690
+ error: parsed.error ?? "Invalid path."
1691
+ };
1692
+ setConfigValueAtPath(overrides, parsed.path, value);
1693
+ return { ok: true };
1694
+ }
1695
+ function unsetConfigOverride(pathRaw) {
1696
+ const parsed = parseConfigPath(pathRaw);
1697
+ if (!parsed.ok || !parsed.path) return {
1698
+ ok: false,
1699
+ removed: false,
1700
+ error: parsed.error ?? "Invalid path."
1701
+ };
1702
+ return {
1703
+ ok: true,
1704
+ removed: unsetConfigValueAtPath(overrides, parsed.path)
1705
+ };
1706
+ }
1707
+ function applyConfigOverrides(cfg) {
1708
+ if (!overrides || Object.keys(overrides).length === 0) return cfg;
1709
+ return mergeOverrides(cfg, overrides);
1710
+ }
1711
+
1712
+ //#endregion
1713
+ //#region src/plugins/schema-validator.ts
1714
+ const ajv = new AjvPkg({
1715
+ allErrors: true,
1716
+ strict: false,
1717
+ removeAdditional: false
1718
+ });
1719
+ const schemaCache = /* @__PURE__ */ new Map();
1720
+ function formatAjvErrors(errors) {
1721
+ if (!errors || errors.length === 0) return ["invalid config"];
1722
+ return errors.map((error) => {
1723
+ return `${error.instancePath?.replace(/^\//, "").replace(/\//g, ".") || "<root>"}: ${error.message ?? "invalid"}`;
1724
+ });
1725
+ }
1726
+ function validateJsonSchemaValue(params) {
1727
+ let cached = schemaCache.get(params.cacheKey);
1728
+ if (!cached || cached.schema !== params.schema) {
1729
+ cached = {
1730
+ validate: ajv.compile(params.schema),
1731
+ schema: params.schema
1732
+ };
1733
+ schemaCache.set(params.cacheKey, cached);
1734
+ }
1735
+ if (cached.validate(params.value)) return { ok: true };
1736
+ return {
1737
+ ok: false,
1738
+ errors: formatAjvErrors(cached.validate.errors)
1739
+ };
1740
+ }
1741
+
1742
+ //#endregion
1743
+ //#region src/cli/parse-duration.ts
1744
+ function parseDurationMs(raw, opts) {
1745
+ const trimmed = String(raw ?? "").trim().toLowerCase();
1746
+ if (!trimmed) throw new Error("invalid duration (empty)");
1747
+ const m = /^(\d+(?:\.\d+)?)(ms|s|m|h|d)?$/.exec(trimmed);
1748
+ if (!m) throw new Error(`invalid duration: ${raw}`);
1749
+ const value = Number(m[1]);
1750
+ if (!Number.isFinite(value) || value < 0) throw new Error(`invalid duration: ${raw}`);
1751
+ const unit = m[2] ?? opts?.defaultUnit ?? "ms";
1752
+ const multiplier = unit === "ms" ? 1 : unit === "s" ? 1e3 : unit === "m" ? 6e4 : unit === "h" ? 36e5 : 864e5;
1753
+ const ms = Math.round(value * multiplier);
1754
+ if (!Number.isFinite(ms)) throw new Error(`invalid duration: ${raw}`);
1755
+ return ms;
1756
+ }
1757
+
1758
+ //#endregion
1759
+ //#region src/infra/exec-safety.ts
1760
+ const SHELL_METACHARS = /[;&|`$<>]/;
1761
+ const CONTROL_CHARS = /[\r\n]/;
1762
+ const QUOTE_CHARS = /["']/;
1763
+ const BARE_NAME_PATTERN = /^[A-Za-z0-9._+-]+$/;
1764
+ function isLikelyPath(value) {
1765
+ if (value.startsWith(".") || value.startsWith("~")) return true;
1766
+ if (value.includes("/") || value.includes("\\")) return true;
1767
+ return /^[A-Za-z]:[\\/]/.test(value);
1768
+ }
1769
+ function isSafeExecutableValue(value) {
1770
+ if (!value) return false;
1771
+ const trimmed = value.trim();
1772
+ if (!trimmed) return false;
1773
+ if (trimmed.includes("\0")) return false;
1774
+ if (CONTROL_CHARS.test(trimmed)) return false;
1775
+ if (SHELL_METACHARS.test(trimmed)) return false;
1776
+ if (QUOTE_CHARS.test(trimmed)) return false;
1777
+ if (isLikelyPath(trimmed)) return true;
1778
+ if (trimmed.startsWith("-")) return false;
1779
+ return BARE_NAME_PATTERN.test(trimmed);
1780
+ }
1781
+
1782
+ //#endregion
1783
+ //#region src/config/zod-schema.core.ts
1784
+ const ModelApiSchema = z.union([
1785
+ z.literal("openai-completions"),
1786
+ z.literal("openai-responses"),
1787
+ z.literal("anthropic-messages"),
1788
+ z.literal("google-generative-ai"),
1789
+ z.literal("github-copilot"),
1790
+ z.literal("bedrock-converse-stream")
1791
+ ]);
1792
+ const ModelCompatSchema = z.object({
1793
+ supportsStore: z.boolean().optional(),
1794
+ supportsDeveloperRole: z.boolean().optional(),
1795
+ supportsReasoningEffort: z.boolean().optional(),
1796
+ maxTokensField: z.union([z.literal("max_completion_tokens"), z.literal("max_tokens")]).optional()
1797
+ }).strict().optional();
1798
+ const ModelDefinitionSchema = z.object({
1799
+ id: z.string().min(1),
1800
+ name: z.string().min(1),
1801
+ api: ModelApiSchema.optional(),
1802
+ reasoning: z.boolean().optional(),
1803
+ input: z.array(z.union([z.literal("text"), z.literal("image")])).optional(),
1804
+ cost: z.object({
1805
+ input: z.number().optional(),
1806
+ output: z.number().optional(),
1807
+ cacheRead: z.number().optional(),
1808
+ cacheWrite: z.number().optional()
1809
+ }).strict().optional(),
1810
+ contextWindow: z.number().positive().optional(),
1811
+ maxTokens: z.number().positive().optional(),
1812
+ headers: z.record(z.string(), z.string()).optional(),
1813
+ compat: ModelCompatSchema
1814
+ }).strict();
1815
+ const ModelProviderSchema = z.object({
1816
+ baseUrl: z.string().min(1),
1817
+ apiKey: z.string().optional(),
1818
+ auth: z.union([
1819
+ z.literal("api-key"),
1820
+ z.literal("aws-sdk"),
1821
+ z.literal("oauth"),
1822
+ z.literal("token")
1823
+ ]).optional(),
1824
+ api: ModelApiSchema.optional(),
1825
+ headers: z.record(z.string(), z.string()).optional(),
1826
+ authHeader: z.boolean().optional(),
1827
+ models: z.array(ModelDefinitionSchema)
1828
+ }).strict();
1829
+ const BedrockDiscoverySchema = z.object({
1830
+ enabled: z.boolean().optional(),
1831
+ region: z.string().optional(),
1832
+ providerFilter: z.array(z.string()).optional(),
1833
+ refreshInterval: z.number().int().nonnegative().optional(),
1834
+ defaultContextWindow: z.number().int().positive().optional(),
1835
+ defaultMaxTokens: z.number().int().positive().optional()
1836
+ }).strict().optional();
1837
+ const ModelsConfigSchema = z.object({
1838
+ mode: z.union([z.literal("merge"), z.literal("replace")]).optional(),
1839
+ providers: z.record(z.string(), ModelProviderSchema).optional(),
1840
+ bedrockDiscovery: BedrockDiscoverySchema
1841
+ }).strict().optional();
1842
+ const GroupChatSchema = z.object({
1843
+ mentionPatterns: z.array(z.string()).optional(),
1844
+ historyLimit: z.number().int().positive().optional()
1845
+ }).strict().optional();
1846
+ const DmConfigSchema = z.object({ historyLimit: z.number().int().min(0).optional() }).strict();
1847
+ const IdentitySchema = z.object({
1848
+ name: z.string().optional(),
1849
+ theme: z.string().optional(),
1850
+ emoji: z.string().optional(),
1851
+ avatar: z.string().optional()
1852
+ }).strict().optional();
1853
+ const QueueModeSchema = z.union([
1854
+ z.literal("steer"),
1855
+ z.literal("followup"),
1856
+ z.literal("collect"),
1857
+ z.literal("steer-backlog"),
1858
+ z.literal("steer+backlog"),
1859
+ z.literal("queue"),
1860
+ z.literal("interrupt")
1861
+ ]);
1862
+ const QueueDropSchema = z.union([
1863
+ z.literal("old"),
1864
+ z.literal("new"),
1865
+ z.literal("summarize")
1866
+ ]);
1867
+ const ReplyToModeSchema = z.union([
1868
+ z.literal("off"),
1869
+ z.literal("first"),
1870
+ z.literal("all")
1871
+ ]);
1872
+ const GroupPolicySchema = z.enum([
1873
+ "open",
1874
+ "disabled",
1875
+ "allowlist"
1876
+ ]);
1877
+ const DmPolicySchema = z.enum([
1878
+ "pairing",
1879
+ "allowlist",
1880
+ "open",
1881
+ "disabled"
1882
+ ]);
1883
+ const BlockStreamingCoalesceSchema = z.object({
1884
+ minChars: z.number().int().positive().optional(),
1885
+ maxChars: z.number().int().positive().optional(),
1886
+ idleMs: z.number().int().nonnegative().optional()
1887
+ }).strict();
1888
+ const BlockStreamingChunkSchema = z.object({
1889
+ minChars: z.number().int().positive().optional(),
1890
+ maxChars: z.number().int().positive().optional(),
1891
+ breakPreference: z.union([
1892
+ z.literal("paragraph"),
1893
+ z.literal("newline"),
1894
+ z.literal("sentence")
1895
+ ]).optional()
1896
+ }).strict();
1897
+ const MarkdownTableModeSchema = z.enum([
1898
+ "off",
1899
+ "bullets",
1900
+ "code"
1901
+ ]);
1902
+ const MarkdownConfigSchema = z.object({ tables: MarkdownTableModeSchema.optional() }).strict().optional();
1903
+ const TtsProviderSchema = z.enum([
1904
+ "elevenlabs",
1905
+ "openai",
1906
+ "edge"
1907
+ ]);
1908
+ const TtsModeSchema = z.enum(["final", "all"]);
1909
+ const TtsAutoSchema = z.enum([
1910
+ "off",
1911
+ "always",
1912
+ "inbound",
1913
+ "tagged"
1914
+ ]);
1915
+ const TtsConfigSchema = z.object({
1916
+ auto: TtsAutoSchema.optional(),
1917
+ enabled: z.boolean().optional(),
1918
+ mode: TtsModeSchema.optional(),
1919
+ provider: TtsProviderSchema.optional(),
1920
+ summaryModel: z.string().optional(),
1921
+ modelOverrides: z.object({
1922
+ enabled: z.boolean().optional(),
1923
+ allowText: z.boolean().optional(),
1924
+ allowProvider: z.boolean().optional(),
1925
+ allowVoice: z.boolean().optional(),
1926
+ allowModelId: z.boolean().optional(),
1927
+ allowVoiceSettings: z.boolean().optional(),
1928
+ allowNormalization: z.boolean().optional(),
1929
+ allowSeed: z.boolean().optional()
1930
+ }).strict().optional(),
1931
+ elevenlabs: z.object({
1932
+ apiKey: z.string().optional(),
1933
+ baseUrl: z.string().optional(),
1934
+ voiceId: z.string().optional(),
1935
+ modelId: z.string().optional(),
1936
+ seed: z.number().int().min(0).max(4294967295).optional(),
1937
+ applyTextNormalization: z.enum([
1938
+ "auto",
1939
+ "on",
1940
+ "off"
1941
+ ]).optional(),
1942
+ languageCode: z.string().optional(),
1943
+ voiceSettings: z.object({
1944
+ stability: z.number().min(0).max(1).optional(),
1945
+ similarityBoost: z.number().min(0).max(1).optional(),
1946
+ style: z.number().min(0).max(1).optional(),
1947
+ useSpeakerBoost: z.boolean().optional(),
1948
+ speed: z.number().min(.5).max(2).optional()
1949
+ }).strict().optional()
1950
+ }).strict().optional(),
1951
+ openai: z.object({
1952
+ apiKey: z.string().optional(),
1953
+ model: z.string().optional(),
1954
+ voice: z.string().optional()
1955
+ }).strict().optional(),
1956
+ edge: z.object({
1957
+ enabled: z.boolean().optional(),
1958
+ voice: z.string().optional(),
1959
+ lang: z.string().optional(),
1960
+ outputFormat: z.string().optional(),
1961
+ pitch: z.string().optional(),
1962
+ rate: z.string().optional(),
1963
+ volume: z.string().optional(),
1964
+ saveSubtitles: z.boolean().optional(),
1965
+ proxy: z.string().optional(),
1966
+ timeoutMs: z.number().int().min(1e3).max(12e4).optional()
1967
+ }).strict().optional(),
1968
+ prefsPath: z.string().optional(),
1969
+ maxTextLength: z.number().int().min(1).optional(),
1970
+ timeoutMs: z.number().int().min(1e3).max(12e4).optional()
1971
+ }).strict().optional();
1972
+ const HumanDelaySchema = z.object({
1973
+ mode: z.union([
1974
+ z.literal("off"),
1975
+ z.literal("natural"),
1976
+ z.literal("custom")
1977
+ ]).optional(),
1978
+ minMs: z.number().int().nonnegative().optional(),
1979
+ maxMs: z.number().int().nonnegative().optional()
1980
+ }).strict();
1981
+ const CliBackendSchema = z.object({
1982
+ command: z.string(),
1983
+ args: z.array(z.string()).optional(),
1984
+ output: z.union([
1985
+ z.literal("json"),
1986
+ z.literal("text"),
1987
+ z.literal("jsonl")
1988
+ ]).optional(),
1989
+ resumeOutput: z.union([
1990
+ z.literal("json"),
1991
+ z.literal("text"),
1992
+ z.literal("jsonl")
1993
+ ]).optional(),
1994
+ input: z.union([z.literal("arg"), z.literal("stdin")]).optional(),
1995
+ maxPromptArgChars: z.number().int().positive().optional(),
1996
+ env: z.record(z.string(), z.string()).optional(),
1997
+ clearEnv: z.array(z.string()).optional(),
1998
+ modelArg: z.string().optional(),
1999
+ modelAliases: z.record(z.string(), z.string()).optional(),
2000
+ sessionArg: z.string().optional(),
2001
+ sessionArgs: z.array(z.string()).optional(),
2002
+ resumeArgs: z.array(z.string()).optional(),
2003
+ sessionMode: z.union([
2004
+ z.literal("always"),
2005
+ z.literal("existing"),
2006
+ z.literal("none")
2007
+ ]).optional(),
2008
+ sessionIdFields: z.array(z.string()).optional(),
2009
+ systemPromptArg: z.string().optional(),
2010
+ systemPromptMode: z.union([z.literal("append"), z.literal("replace")]).optional(),
2011
+ systemPromptWhen: z.union([
2012
+ z.literal("first"),
2013
+ z.literal("always"),
2014
+ z.literal("never")
2015
+ ]).optional(),
2016
+ imageArg: z.string().optional(),
2017
+ imageMode: z.union([z.literal("repeat"), z.literal("list")]).optional(),
2018
+ serialize: z.boolean().optional()
2019
+ }).strict();
2020
+ const normalizeAllowFrom = (values) => (values ?? []).map((v) => String(v).trim()).filter(Boolean);
2021
+ const requireOpenAllowFrom = (params) => {
2022
+ if (params.policy !== "open") return;
2023
+ if (normalizeAllowFrom(params.allowFrom).includes("*")) return;
2024
+ params.ctx.addIssue({
2025
+ code: z.ZodIssueCode.custom,
2026
+ path: params.path,
2027
+ message: params.message
2028
+ });
2029
+ };
2030
+ const MSTeamsReplyStyleSchema = z.enum(["thread", "top-level"]);
2031
+ const RetryConfigSchema = z.object({
2032
+ attempts: z.number().int().min(1).optional(),
2033
+ minDelayMs: z.number().int().min(0).optional(),
2034
+ maxDelayMs: z.number().int().min(0).optional(),
2035
+ jitter: z.number().min(0).max(1).optional()
2036
+ }).strict().optional();
2037
+ const QueueModeBySurfaceSchema = z.object({
2038
+ whatsapp: QueueModeSchema.optional(),
2039
+ telegram: QueueModeSchema.optional(),
2040
+ discord: QueueModeSchema.optional(),
2041
+ slack: QueueModeSchema.optional(),
2042
+ mattermost: QueueModeSchema.optional(),
2043
+ signal: QueueModeSchema.optional(),
2044
+ imessage: QueueModeSchema.optional(),
2045
+ msteams: QueueModeSchema.optional(),
2046
+ webchat: QueueModeSchema.optional()
2047
+ }).strict().optional();
2048
+ const DebounceMsBySurfaceSchema = z.record(z.string(), z.number().int().nonnegative()).optional();
2049
+ const QueueSchema = z.object({
2050
+ mode: QueueModeSchema.optional(),
2051
+ byChannel: QueueModeBySurfaceSchema,
2052
+ debounceMs: z.number().int().nonnegative().optional(),
2053
+ debounceMsByChannel: DebounceMsBySurfaceSchema,
2054
+ cap: z.number().int().positive().optional(),
2055
+ drop: QueueDropSchema.optional()
2056
+ }).strict().optional();
2057
+ const InboundDebounceSchema = z.object({
2058
+ debounceMs: z.number().int().nonnegative().optional(),
2059
+ byChannel: DebounceMsBySurfaceSchema
2060
+ }).strict().optional();
2061
+ const TranscribeAudioSchema = z.object({
2062
+ command: z.array(z.string()).superRefine((value, ctx) => {
2063
+ const executable = value[0];
2064
+ if (!isSafeExecutableValue(executable)) ctx.addIssue({
2065
+ code: z.ZodIssueCode.custom,
2066
+ path: [0],
2067
+ message: "expected safe executable name or path"
2068
+ });
2069
+ }),
2070
+ timeoutSeconds: z.number().int().positive().optional()
2071
+ }).strict().optional();
2072
+ const HexColorSchema = z.string().regex(/^#?[0-9a-fA-F]{6}$/, "expected hex color (RRGGBB)");
2073
+ const ExecutableTokenSchema = z.string().refine(isSafeExecutableValue, "expected safe executable name or path");
2074
+ const MediaUnderstandingScopeSchema = z.object({
2075
+ default: z.union([z.literal("allow"), z.literal("deny")]).optional(),
2076
+ rules: z.array(z.object({
2077
+ action: z.union([z.literal("allow"), z.literal("deny")]),
2078
+ match: z.object({
2079
+ channel: z.string().optional(),
2080
+ chatType: z.union([
2081
+ z.literal("direct"),
2082
+ z.literal("group"),
2083
+ z.literal("channel")
2084
+ ]).optional(),
2085
+ keyPrefix: z.string().optional()
2086
+ }).strict().optional()
2087
+ }).strict()).optional()
2088
+ }).strict().optional();
2089
+ const MediaUnderstandingCapabilitiesSchema = z.array(z.union([
2090
+ z.literal("image"),
2091
+ z.literal("audio"),
2092
+ z.literal("video")
2093
+ ])).optional();
2094
+ const MediaUnderstandingAttachmentsSchema = z.object({
2095
+ mode: z.union([z.literal("first"), z.literal("all")]).optional(),
2096
+ maxAttachments: z.number().int().positive().optional(),
2097
+ prefer: z.union([
2098
+ z.literal("first"),
2099
+ z.literal("last"),
2100
+ z.literal("path"),
2101
+ z.literal("url")
2102
+ ]).optional()
2103
+ }).strict().optional();
2104
+ const DeepgramAudioSchema = z.object({
2105
+ detectLanguage: z.boolean().optional(),
2106
+ punctuate: z.boolean().optional(),
2107
+ smartFormat: z.boolean().optional()
2108
+ }).strict().optional();
2109
+ const ProviderOptionValueSchema = z.union([
2110
+ z.string(),
2111
+ z.number(),
2112
+ z.boolean()
2113
+ ]);
2114
+ const ProviderOptionsSchema = z.record(z.string(), z.record(z.string(), ProviderOptionValueSchema)).optional();
2115
+ const MediaUnderstandingModelSchema = z.object({
2116
+ provider: z.string().optional(),
2117
+ model: z.string().optional(),
2118
+ capabilities: MediaUnderstandingCapabilitiesSchema,
2119
+ type: z.union([z.literal("provider"), z.literal("cli")]).optional(),
2120
+ command: z.string().optional(),
2121
+ args: z.array(z.string()).optional(),
2122
+ prompt: z.string().optional(),
2123
+ maxChars: z.number().int().positive().optional(),
2124
+ maxBytes: z.number().int().positive().optional(),
2125
+ timeoutSeconds: z.number().int().positive().optional(),
2126
+ language: z.string().optional(),
2127
+ providerOptions: ProviderOptionsSchema,
2128
+ deepgram: DeepgramAudioSchema,
2129
+ baseUrl: z.string().optional(),
2130
+ headers: z.record(z.string(), z.string()).optional(),
2131
+ profile: z.string().optional(),
2132
+ preferredProfile: z.string().optional()
2133
+ }).strict().optional();
2134
+ const ToolsMediaUnderstandingSchema = z.object({
2135
+ enabled: z.boolean().optional(),
2136
+ scope: MediaUnderstandingScopeSchema,
2137
+ maxBytes: z.number().int().positive().optional(),
2138
+ maxChars: z.number().int().positive().optional(),
2139
+ prompt: z.string().optional(),
2140
+ timeoutSeconds: z.number().int().positive().optional(),
2141
+ language: z.string().optional(),
2142
+ providerOptions: ProviderOptionsSchema,
2143
+ deepgram: DeepgramAudioSchema,
2144
+ baseUrl: z.string().optional(),
2145
+ headers: z.record(z.string(), z.string()).optional(),
2146
+ attachments: MediaUnderstandingAttachmentsSchema,
2147
+ models: z.array(MediaUnderstandingModelSchema).optional()
2148
+ }).strict().optional();
2149
+ const ToolsMediaSchema = z.object({
2150
+ models: z.array(MediaUnderstandingModelSchema).optional(),
2151
+ concurrency: z.number().int().positive().optional(),
2152
+ image: ToolsMediaUnderstandingSchema.optional(),
2153
+ audio: ToolsMediaUnderstandingSchema.optional(),
2154
+ video: ToolsMediaUnderstandingSchema.optional()
2155
+ }).strict().optional();
2156
+ const LinkModelSchema = z.object({
2157
+ type: z.literal("cli").optional(),
2158
+ command: z.string().min(1),
2159
+ args: z.array(z.string()).optional(),
2160
+ timeoutSeconds: z.number().int().positive().optional()
2161
+ }).strict();
2162
+ const ToolsLinksSchema = z.object({
2163
+ enabled: z.boolean().optional(),
2164
+ scope: MediaUnderstandingScopeSchema,
2165
+ maxLinks: z.number().int().positive().optional(),
2166
+ timeoutSeconds: z.number().int().positive().optional(),
2167
+ models: z.array(LinkModelSchema).optional()
2168
+ }).strict().optional();
2169
+ const NativeCommandsSettingSchema = z.union([z.boolean(), z.literal("auto")]);
2170
+ const ProviderCommandsSchema = z.object({
2171
+ native: NativeCommandsSettingSchema.optional(),
2172
+ nativeSkills: NativeCommandsSettingSchema.optional()
2173
+ }).strict().optional();
2174
+
2175
+ //#endregion
2176
+ //#region src/config/zod-schema.agent-runtime.ts
2177
+ const HeartbeatSchema = z.object({
2178
+ every: z.string().optional(),
2179
+ activeHours: z.object({
2180
+ start: z.string().optional(),
2181
+ end: z.string().optional(),
2182
+ timezone: z.string().optional()
2183
+ }).strict().optional(),
2184
+ model: z.string().optional(),
2185
+ session: z.string().optional(),
2186
+ includeReasoning: z.boolean().optional(),
2187
+ target: z.string().optional(),
2188
+ to: z.string().optional(),
2189
+ accountId: z.string().optional(),
2190
+ prompt: z.string().optional(),
2191
+ ackMaxChars: z.number().int().nonnegative().optional()
2192
+ }).strict().superRefine((val, ctx) => {
2193
+ if (!val.every) return;
2194
+ try {
2195
+ parseDurationMs(val.every, { defaultUnit: "m" });
2196
+ } catch {
2197
+ ctx.addIssue({
2198
+ code: z.ZodIssueCode.custom,
2199
+ path: ["every"],
2200
+ message: "invalid duration (use ms, s, m, h)"
2201
+ });
2202
+ }
2203
+ const active = val.activeHours;
2204
+ if (!active) return;
2205
+ const timePattern = /^([01]\d|2[0-3]|24):([0-5]\d)$/;
2206
+ const validateTime = (raw, opts, path) => {
2207
+ if (!raw) return;
2208
+ if (!timePattern.test(raw)) {
2209
+ ctx.addIssue({
2210
+ code: z.ZodIssueCode.custom,
2211
+ path: ["activeHours", path],
2212
+ message: "invalid time (use \"HH:MM\" 24h format)"
2213
+ });
2214
+ return;
2215
+ }
2216
+ const [hourStr, minuteStr] = raw.split(":");
2217
+ const hour = Number(hourStr);
2218
+ if (hour === 24 && Number(minuteStr) !== 0) {
2219
+ ctx.addIssue({
2220
+ code: z.ZodIssueCode.custom,
2221
+ path: ["activeHours", path],
2222
+ message: "invalid time (24:00 is the only allowed 24:xx value)"
2223
+ });
2224
+ return;
2225
+ }
2226
+ if (hour === 24 && !opts.allow24) ctx.addIssue({
2227
+ code: z.ZodIssueCode.custom,
2228
+ path: ["activeHours", path],
2229
+ message: "invalid time (start cannot be 24:00)"
2230
+ });
2231
+ };
2232
+ validateTime(active.start, { allow24: false }, "start");
2233
+ validateTime(active.end, { allow24: true }, "end");
2234
+ }).optional();
2235
+ const SandboxDockerSchema = z.object({
2236
+ image: z.string().optional(),
2237
+ containerPrefix: z.string().optional(),
2238
+ workdir: z.string().optional(),
2239
+ readOnlyRoot: z.boolean().optional(),
2240
+ tmpfs: z.array(z.string()).optional(),
2241
+ network: z.string().optional(),
2242
+ user: z.string().optional(),
2243
+ capDrop: z.array(z.string()).optional(),
2244
+ env: z.record(z.string(), z.string()).optional(),
2245
+ setupCommand: z.string().optional(),
2246
+ pidsLimit: z.number().int().positive().optional(),
2247
+ memory: z.union([z.string(), z.number()]).optional(),
2248
+ memorySwap: z.union([z.string(), z.number()]).optional(),
2249
+ cpus: z.number().positive().optional(),
2250
+ ulimits: z.record(z.string(), z.union([
2251
+ z.string(),
2252
+ z.number(),
2253
+ z.object({
2254
+ soft: z.number().int().nonnegative().optional(),
2255
+ hard: z.number().int().nonnegative().optional()
2256
+ }).strict()
2257
+ ])).optional(),
2258
+ seccompProfile: z.string().optional(),
2259
+ apparmorProfile: z.string().optional(),
2260
+ dns: z.array(z.string()).optional(),
2261
+ extraHosts: z.array(z.string()).optional(),
2262
+ binds: z.array(z.string()).optional()
2263
+ }).strict().optional();
2264
+ const SandboxBrowserSchema = z.object({
2265
+ enabled: z.boolean().optional(),
2266
+ image: z.string().optional(),
2267
+ containerPrefix: z.string().optional(),
2268
+ cdpPort: z.number().int().positive().optional(),
2269
+ vncPort: z.number().int().positive().optional(),
2270
+ noVncPort: z.number().int().positive().optional(),
2271
+ headless: z.boolean().optional(),
2272
+ enableNoVnc: z.boolean().optional(),
2273
+ allowHostControl: z.boolean().optional(),
2274
+ autoStart: z.boolean().optional(),
2275
+ autoStartTimeoutMs: z.number().int().positive().optional()
2276
+ }).strict().optional();
2277
+ const SandboxPruneSchema = z.object({
2278
+ idleHours: z.number().int().nonnegative().optional(),
2279
+ maxAgeDays: z.number().int().nonnegative().optional()
2280
+ }).strict().optional();
2281
+ const ToolPolicyBaseSchema = z.object({
2282
+ allow: z.array(z.string()).optional(),
2283
+ alsoAllow: z.array(z.string()).optional(),
2284
+ deny: z.array(z.string()).optional()
2285
+ }).strict();
2286
+ const ToolPolicySchema = ToolPolicyBaseSchema.superRefine((value, ctx) => {
2287
+ if (value.allow && value.allow.length > 0 && value.alsoAllow && value.alsoAllow.length > 0) ctx.addIssue({
2288
+ code: z.ZodIssueCode.custom,
2289
+ message: "tools policy cannot set both allow and alsoAllow in the same scope (merge alsoAllow into allow, or remove allow and use profile + alsoAllow)"
2290
+ });
2291
+ }).optional();
2292
+ const ToolsWebSearchSchema = z.object({
2293
+ enabled: z.boolean().optional(),
2294
+ provider: z.union([z.literal("brave"), z.literal("perplexity")]).optional(),
2295
+ apiKey: z.string().optional(),
2296
+ maxResults: z.number().int().positive().optional(),
2297
+ timeoutSeconds: z.number().int().positive().optional(),
2298
+ cacheTtlMinutes: z.number().nonnegative().optional(),
2299
+ perplexity: z.object({
2300
+ apiKey: z.string().optional(),
2301
+ baseUrl: z.string().optional(),
2302
+ model: z.string().optional()
2303
+ }).strict().optional()
2304
+ }).strict().optional();
2305
+ const ToolsWebFetchSchema = z.object({
2306
+ enabled: z.boolean().optional(),
2307
+ maxChars: z.number().int().positive().optional(),
2308
+ maxCharsCap: z.number().int().positive().optional(),
2309
+ timeoutSeconds: z.number().int().positive().optional(),
2310
+ cacheTtlMinutes: z.number().nonnegative().optional(),
2311
+ maxRedirects: z.number().int().nonnegative().optional(),
2312
+ userAgent: z.string().optional()
2313
+ }).strict().optional();
2314
+ const ToolsWebSchema = z.object({
2315
+ search: ToolsWebSearchSchema,
2316
+ fetch: ToolsWebFetchSchema
2317
+ }).strict().optional();
2318
+ const ToolProfileSchema = z.union([
2319
+ z.literal("minimal"),
2320
+ z.literal("coding"),
2321
+ z.literal("messaging"),
2322
+ z.literal("full")
2323
+ ]).optional();
2324
+ const ToolPolicyWithProfileSchema = z.object({
2325
+ allow: z.array(z.string()).optional(),
2326
+ alsoAllow: z.array(z.string()).optional(),
2327
+ deny: z.array(z.string()).optional(),
2328
+ profile: ToolProfileSchema
2329
+ }).strict().superRefine((value, ctx) => {
2330
+ if (value.allow && value.allow.length > 0 && value.alsoAllow && value.alsoAllow.length > 0) ctx.addIssue({
2331
+ code: z.ZodIssueCode.custom,
2332
+ 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)"
2333
+ });
2334
+ });
2335
+ const ElevatedAllowFromSchema = z.record(z.string(), z.array(z.union([z.string(), z.number()]))).optional();
2336
+ const AgentSandboxSchema = z.object({
2337
+ mode: z.union([
2338
+ z.literal("off"),
2339
+ z.literal("non-main"),
2340
+ z.literal("all")
2341
+ ]).optional(),
2342
+ workspaceAccess: z.union([
2343
+ z.literal("none"),
2344
+ z.literal("ro"),
2345
+ z.literal("rw")
2346
+ ]).optional(),
2347
+ sessionToolsVisibility: z.union([z.literal("spawned"), z.literal("all")]).optional(),
2348
+ scope: z.union([
2349
+ z.literal("session"),
2350
+ z.literal("agent"),
2351
+ z.literal("shared")
2352
+ ]).optional(),
2353
+ perSession: z.boolean().optional(),
2354
+ workspaceRoot: z.string().optional(),
2355
+ docker: SandboxDockerSchema,
2356
+ browser: SandboxBrowserSchema,
2357
+ prune: SandboxPruneSchema
2358
+ }).strict().optional();
2359
+ const AgentToolsSchema = z.object({
2360
+ profile: ToolProfileSchema,
2361
+ allow: z.array(z.string()).optional(),
2362
+ alsoAllow: z.array(z.string()).optional(),
2363
+ deny: z.array(z.string()).optional(),
2364
+ byProvider: z.record(z.string(), ToolPolicyWithProfileSchema).optional(),
2365
+ elevated: z.object({
2366
+ enabled: z.boolean().optional(),
2367
+ allowFrom: ElevatedAllowFromSchema
2368
+ }).strict().optional(),
2369
+ exec: z.object({
2370
+ host: z.enum([
2371
+ "sandbox",
2372
+ "gateway",
2373
+ "node"
2374
+ ]).optional(),
2375
+ security: z.enum([
2376
+ "deny",
2377
+ "allowlist",
2378
+ "full"
2379
+ ]).optional(),
2380
+ ask: z.enum([
2381
+ "off",
2382
+ "on-miss",
2383
+ "always"
2384
+ ]).optional(),
2385
+ node: z.string().optional(),
2386
+ pathPrepend: z.array(z.string()).optional(),
2387
+ safeBins: z.array(z.string()).optional(),
2388
+ backgroundMs: z.number().int().positive().optional(),
2389
+ timeoutSec: z.number().int().positive().optional(),
2390
+ approvalRunningNoticeMs: z.number().int().nonnegative().optional(),
2391
+ cleanupMs: z.number().int().positive().optional(),
2392
+ notifyOnExit: z.boolean().optional(),
2393
+ applyPatch: z.object({
2394
+ enabled: z.boolean().optional(),
2395
+ allowModels: z.array(z.string()).optional()
2396
+ }).strict().optional()
2397
+ }).strict().optional(),
2398
+ sandbox: z.object({ tools: ToolPolicySchema }).strict().optional()
2399
+ }).strict().superRefine((value, ctx) => {
2400
+ if (value.allow && value.allow.length > 0 && value.alsoAllow && value.alsoAllow.length > 0) ctx.addIssue({
2401
+ code: z.ZodIssueCode.custom,
2402
+ message: "agent tools cannot set both allow and alsoAllow in the same scope (merge alsoAllow into allow, or remove allow and use profile + alsoAllow)"
2403
+ });
2404
+ }).optional();
2405
+ const MemorySearchSchema = z.object({
2406
+ enabled: z.boolean().optional(),
2407
+ sources: z.array(z.union([z.literal("memory"), z.literal("sessions")])).optional(),
2408
+ extraPaths: z.array(z.string()).optional(),
2409
+ experimental: z.object({ sessionMemory: z.boolean().optional() }).strict().optional(),
2410
+ provider: z.union([
2411
+ z.literal("openai"),
2412
+ z.literal("local"),
2413
+ z.literal("gemini"),
2414
+ z.literal("voyage")
2415
+ ]).optional(),
2416
+ remote: z.object({
2417
+ baseUrl: z.string().optional(),
2418
+ apiKey: z.string().optional(),
2419
+ headers: z.record(z.string(), z.string()).optional(),
2420
+ batch: z.object({
2421
+ enabled: z.boolean().optional(),
2422
+ wait: z.boolean().optional(),
2423
+ concurrency: z.number().int().positive().optional(),
2424
+ pollIntervalMs: z.number().int().nonnegative().optional(),
2425
+ timeoutMinutes: z.number().int().positive().optional()
2426
+ }).strict().optional()
2427
+ }).strict().optional(),
2428
+ fallback: z.union([
2429
+ z.literal("openai"),
2430
+ z.literal("gemini"),
2431
+ z.literal("local"),
2432
+ z.literal("voyage"),
2433
+ z.literal("none")
2434
+ ]).optional(),
2435
+ model: z.string().optional(),
2436
+ local: z.object({
2437
+ modelPath: z.string().optional(),
2438
+ modelCacheDir: z.string().optional()
2439
+ }).strict().optional(),
2440
+ store: z.object({
2441
+ driver: z.literal("sqlite").optional(),
2442
+ path: z.string().optional(),
2443
+ vector: z.object({
2444
+ enabled: z.boolean().optional(),
2445
+ extensionPath: z.string().optional()
2446
+ }).strict().optional()
2447
+ }).strict().optional(),
2448
+ chunking: z.object({
2449
+ tokens: z.number().int().positive().optional(),
2450
+ overlap: z.number().int().nonnegative().optional()
2451
+ }).strict().optional(),
2452
+ sync: z.object({
2453
+ onSessionStart: z.boolean().optional(),
2454
+ onSearch: z.boolean().optional(),
2455
+ watch: z.boolean().optional(),
2456
+ watchDebounceMs: z.number().int().nonnegative().optional(),
2457
+ intervalMinutes: z.number().int().nonnegative().optional(),
2458
+ sessions: z.object({
2459
+ deltaBytes: z.number().int().nonnegative().optional(),
2460
+ deltaMessages: z.number().int().nonnegative().optional()
2461
+ }).strict().optional()
2462
+ }).strict().optional(),
2463
+ query: z.object({
2464
+ maxResults: z.number().int().positive().optional(),
2465
+ minScore: z.number().min(0).max(1).optional(),
2466
+ hybrid: z.object({
2467
+ enabled: z.boolean().optional(),
2468
+ vectorWeight: z.number().min(0).max(1).optional(),
2469
+ textWeight: z.number().min(0).max(1).optional(),
2470
+ candidateMultiplier: z.number().int().positive().optional()
2471
+ }).strict().optional()
2472
+ }).strict().optional(),
2473
+ cache: z.object({
2474
+ enabled: z.boolean().optional(),
2475
+ maxEntries: z.number().int().positive().optional()
2476
+ }).strict().optional()
2477
+ }).strict().optional();
2478
+ const AgentModelSchema = z.union([z.string(), z.object({
2479
+ primary: z.string().optional(),
2480
+ fallbacks: z.array(z.string()).optional()
2481
+ }).strict()]);
2482
+ const AgentEntrySchema = z.object({
2483
+ id: z.string(),
2484
+ default: z.boolean().optional(),
2485
+ name: z.string().optional(),
2486
+ workspace: z.string().optional(),
2487
+ agentDir: z.string().optional(),
2488
+ model: AgentModelSchema.optional(),
2489
+ skills: z.array(z.string()).optional(),
2490
+ memorySearch: MemorySearchSchema,
2491
+ humanDelay: HumanDelaySchema.optional(),
2492
+ heartbeat: HeartbeatSchema,
2493
+ identity: IdentitySchema,
2494
+ groupChat: GroupChatSchema,
2495
+ subagents: z.object({
2496
+ allowAgents: z.array(z.string()).optional(),
2497
+ model: z.union([z.string(), z.object({
2498
+ primary: z.string().optional(),
2499
+ fallbacks: z.array(z.string()).optional()
2500
+ }).strict()]).optional(),
2501
+ thinking: z.string().optional()
2502
+ }).strict().optional(),
2503
+ sandbox: AgentSandboxSchema,
2504
+ tools: AgentToolsSchema
2505
+ }).strict();
2506
+ const ToolsSchema = z.object({
2507
+ profile: ToolProfileSchema,
2508
+ allow: z.array(z.string()).optional(),
2509
+ alsoAllow: z.array(z.string()).optional(),
2510
+ deny: z.array(z.string()).optional(),
2511
+ byProvider: z.record(z.string(), ToolPolicyWithProfileSchema).optional(),
2512
+ web: ToolsWebSchema,
2513
+ media: ToolsMediaSchema,
2514
+ links: ToolsLinksSchema,
2515
+ message: z.object({
2516
+ allowCrossContextSend: z.boolean().optional(),
2517
+ crossContext: z.object({
2518
+ allowWithinProvider: z.boolean().optional(),
2519
+ allowAcrossProviders: z.boolean().optional(),
2520
+ marker: z.object({
2521
+ enabled: z.boolean().optional(),
2522
+ prefix: z.string().optional(),
2523
+ suffix: z.string().optional()
2524
+ }).strict().optional()
2525
+ }).strict().optional(),
2526
+ broadcast: z.object({ enabled: z.boolean().optional() }).strict().optional()
2527
+ }).strict().optional(),
2528
+ agentToAgent: z.object({
2529
+ enabled: z.boolean().optional(),
2530
+ allow: z.array(z.string()).optional()
2531
+ }).strict().optional(),
2532
+ elevated: z.object({
2533
+ enabled: z.boolean().optional(),
2534
+ allowFrom: ElevatedAllowFromSchema
2535
+ }).strict().optional(),
2536
+ exec: z.object({
2537
+ host: z.enum([
2538
+ "sandbox",
2539
+ "gateway",
2540
+ "node"
2541
+ ]).optional(),
2542
+ security: z.enum([
2543
+ "deny",
2544
+ "allowlist",
2545
+ "full"
2546
+ ]).optional(),
2547
+ ask: z.enum([
2548
+ "off",
2549
+ "on-miss",
2550
+ "always"
2551
+ ]).optional(),
2552
+ node: z.string().optional(),
2553
+ pathPrepend: z.array(z.string()).optional(),
2554
+ safeBins: z.array(z.string()).optional(),
2555
+ backgroundMs: z.number().int().positive().optional(),
2556
+ timeoutSec: z.number().int().positive().optional(),
2557
+ cleanupMs: z.number().int().positive().optional(),
2558
+ notifyOnExit: z.boolean().optional(),
2559
+ applyPatch: z.object({
2560
+ enabled: z.boolean().optional(),
2561
+ allowModels: z.array(z.string()).optional()
2562
+ }).strict().optional()
2563
+ }).strict().optional(),
2564
+ subagents: z.object({ tools: ToolPolicySchema }).strict().optional(),
2565
+ sandbox: z.object({ tools: ToolPolicySchema }).strict().optional()
2566
+ }).strict().superRefine((value, ctx) => {
2567
+ if (value.allow && value.allow.length > 0 && value.alsoAllow && value.alsoAllow.length > 0) ctx.addIssue({
2568
+ code: z.ZodIssueCode.custom,
2569
+ message: "tools cannot set both allow and alsoAllow in the same scope (merge alsoAllow into allow, or remove allow and use profile + alsoAllow)"
2570
+ });
2571
+ }).optional();
2572
+
2573
+ //#endregion
2574
+ //#region src/config/zod-schema.agent-defaults.ts
2575
+ const AgentDefaultsSchema = z.object({
2576
+ model: z.object({
2577
+ primary: z.string().optional(),
2578
+ fallbacks: z.array(z.string()).optional()
2579
+ }).strict().optional(),
2580
+ imageModel: z.object({
2581
+ primary: z.string().optional(),
2582
+ fallbacks: z.array(z.string()).optional()
2583
+ }).strict().optional(),
2584
+ models: z.record(z.string(), z.object({
2585
+ alias: z.string().optional(),
2586
+ params: z.record(z.string(), z.unknown()).optional(),
2587
+ streaming: z.boolean().optional()
2588
+ }).strict()).optional(),
2589
+ workspace: z.string().optional(),
2590
+ repoRoot: z.string().optional(),
2591
+ skipBootstrap: z.boolean().optional(),
2592
+ bootstrapMaxChars: z.number().int().positive().optional(),
2593
+ userTimezone: z.string().optional(),
2594
+ timeFormat: z.union([
2595
+ z.literal("auto"),
2596
+ z.literal("12"),
2597
+ z.literal("24")
2598
+ ]).optional(),
2599
+ envelopeTimezone: z.string().optional(),
2600
+ envelopeTimestamp: z.union([z.literal("on"), z.literal("off")]).optional(),
2601
+ envelopeElapsed: z.union([z.literal("on"), z.literal("off")]).optional(),
2602
+ contextTokens: z.number().int().positive().optional(),
2603
+ cliBackends: z.record(z.string(), CliBackendSchema).optional(),
2604
+ memorySearch: MemorySearchSchema,
2605
+ contextPruning: z.object({
2606
+ mode: z.union([z.literal("off"), z.literal("cache-ttl")]).optional(),
2607
+ ttl: z.string().optional(),
2608
+ keepLastAssistants: z.number().int().nonnegative().optional(),
2609
+ softTrimRatio: z.number().min(0).max(1).optional(),
2610
+ hardClearRatio: z.number().min(0).max(1).optional(),
2611
+ minPrunableToolChars: z.number().int().nonnegative().optional(),
2612
+ tools: z.object({
2613
+ allow: z.array(z.string()).optional(),
2614
+ deny: z.array(z.string()).optional()
2615
+ }).strict().optional(),
2616
+ softTrim: z.object({
2617
+ maxChars: z.number().int().nonnegative().optional(),
2618
+ headChars: z.number().int().nonnegative().optional(),
2619
+ tailChars: z.number().int().nonnegative().optional()
2620
+ }).strict().optional(),
2621
+ hardClear: z.object({
2622
+ enabled: z.boolean().optional(),
2623
+ placeholder: z.string().optional()
2624
+ }).strict().optional()
2625
+ }).strict().optional(),
2626
+ compaction: z.object({
2627
+ mode: z.union([z.literal("default"), z.literal("safeguard")]).optional(),
2628
+ reserveTokensFloor: z.number().int().nonnegative().optional(),
2629
+ maxHistoryShare: z.number().min(.1).max(.9).optional(),
2630
+ memoryFlush: z.object({
2631
+ enabled: z.boolean().optional(),
2632
+ softThresholdTokens: z.number().int().nonnegative().optional(),
2633
+ prompt: z.string().optional(),
2634
+ systemPrompt: z.string().optional()
2635
+ }).strict().optional()
2636
+ }).strict().optional(),
2637
+ thinkingDefault: z.union([
2638
+ z.literal("off"),
2639
+ z.literal("minimal"),
2640
+ z.literal("low"),
2641
+ z.literal("medium"),
2642
+ z.literal("high"),
2643
+ z.literal("xhigh")
2644
+ ]).optional(),
2645
+ verboseDefault: z.union([
2646
+ z.literal("off"),
2647
+ z.literal("on"),
2648
+ z.literal("full")
2649
+ ]).optional(),
2650
+ elevatedDefault: z.union([
2651
+ z.literal("off"),
2652
+ z.literal("on"),
2653
+ z.literal("ask"),
2654
+ z.literal("full")
2655
+ ]).optional(),
2656
+ blockStreamingDefault: z.union([z.literal("off"), z.literal("on")]).optional(),
2657
+ blockStreamingBreak: z.union([z.literal("text_end"), z.literal("message_end")]).optional(),
2658
+ blockStreamingChunk: BlockStreamingChunkSchema.optional(),
2659
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
2660
+ humanDelay: HumanDelaySchema.optional(),
2661
+ timeoutSeconds: z.number().int().positive().optional(),
2662
+ mediaMaxMb: z.number().positive().optional(),
2663
+ typingIntervalSeconds: z.number().int().positive().optional(),
2664
+ typingMode: z.union([
2665
+ z.literal("never"),
2666
+ z.literal("instant"),
2667
+ z.literal("thinking"),
2668
+ z.literal("message")
2669
+ ]).optional(),
2670
+ heartbeat: HeartbeatSchema,
2671
+ maxConcurrent: z.number().int().positive().optional(),
2672
+ subagents: z.object({
2673
+ maxConcurrent: z.number().int().positive().optional(),
2674
+ archiveAfterMinutes: z.number().int().positive().optional(),
2675
+ model: z.union([z.string(), z.object({
2676
+ primary: z.string().optional(),
2677
+ fallbacks: z.array(z.string()).optional()
2678
+ }).strict()]).optional(),
2679
+ thinking: z.string().optional()
2680
+ }).strict().optional(),
2681
+ sandbox: z.object({
2682
+ mode: z.union([
2683
+ z.literal("off"),
2684
+ z.literal("non-main"),
2685
+ z.literal("all")
2686
+ ]).optional(),
2687
+ workspaceAccess: z.union([
2688
+ z.literal("none"),
2689
+ z.literal("ro"),
2690
+ z.literal("rw")
2691
+ ]).optional(),
2692
+ sessionToolsVisibility: z.union([z.literal("spawned"), z.literal("all")]).optional(),
2693
+ scope: z.union([
2694
+ z.literal("session"),
2695
+ z.literal("agent"),
2696
+ z.literal("shared")
2697
+ ]).optional(),
2698
+ perSession: z.boolean().optional(),
2699
+ workspaceRoot: z.string().optional(),
2700
+ docker: SandboxDockerSchema,
2701
+ browser: SandboxBrowserSchema,
2702
+ prune: SandboxPruneSchema
2703
+ }).strict().optional()
2704
+ }).strict().optional();
2705
+
2706
+ //#endregion
2707
+ //#region src/config/zod-schema.agents.ts
2708
+ const AgentsSchema = z.object({
2709
+ defaults: z.lazy(() => AgentDefaultsSchema).optional(),
2710
+ list: z.array(AgentEntrySchema).optional()
2711
+ }).strict().optional();
2712
+ const BindingsSchema = z.array(z.object({
2713
+ agentId: z.string(),
2714
+ match: z.object({
2715
+ channel: z.string(),
2716
+ accountId: z.string().optional(),
2717
+ peer: z.object({
2718
+ kind: z.union([
2719
+ z.literal("dm"),
2720
+ z.literal("group"),
2721
+ z.literal("channel")
2722
+ ]),
2723
+ id: z.string()
2724
+ }).strict().optional(),
2725
+ guildId: z.string().optional(),
2726
+ teamId: z.string().optional()
2727
+ }).strict()
2728
+ }).strict()).optional();
2729
+ const BroadcastStrategySchema = z.enum(["parallel", "sequential"]);
2730
+ const BroadcastSchema = z.object({ strategy: BroadcastStrategySchema.optional() }).catchall(z.array(z.string())).optional();
2731
+ const AudioSchema = z.object({ transcription: TranscribeAudioSchema }).strict().optional();
2732
+
2733
+ //#endregion
2734
+ //#region src/config/zod-schema.approvals.ts
2735
+ const ExecApprovalForwardTargetSchema = z.object({
2736
+ channel: z.string().min(1),
2737
+ to: z.string().min(1),
2738
+ accountId: z.string().optional(),
2739
+ threadId: z.union([z.string(), z.number()]).optional()
2740
+ }).strict();
2741
+ const ExecApprovalForwardingSchema = z.object({
2742
+ enabled: z.boolean().optional(),
2743
+ mode: z.union([
2744
+ z.literal("session"),
2745
+ z.literal("targets"),
2746
+ z.literal("both")
2747
+ ]).optional(),
2748
+ agentFilter: z.array(z.string()).optional(),
2749
+ sessionFilter: z.array(z.string()).optional(),
2750
+ targets: z.array(ExecApprovalForwardTargetSchema).optional()
2751
+ }).strict().optional();
2752
+ const ApprovalsSchema = z.object({ exec: ExecApprovalForwardingSchema }).strict().optional();
2753
+
2754
+ //#endregion
2755
+ //#region src/config/zod-schema.hooks.ts
2756
+ const HookMappingSchema = z.object({
2757
+ id: z.string().optional(),
2758
+ match: z.object({
2759
+ path: z.string().optional(),
2760
+ source: z.string().optional()
2761
+ }).optional(),
2762
+ action: z.union([z.literal("wake"), z.literal("agent")]).optional(),
2763
+ wakeMode: z.union([z.literal("now"), z.literal("next-heartbeat")]).optional(),
2764
+ name: z.string().optional(),
2765
+ sessionKey: z.string().optional(),
2766
+ messageTemplate: z.string().optional(),
2767
+ textTemplate: z.string().optional(),
2768
+ deliver: z.boolean().optional(),
2769
+ allowUnsafeExternalContent: z.boolean().optional(),
2770
+ channel: z.union([
2771
+ z.literal("last"),
2772
+ z.literal("whatsapp"),
2773
+ z.literal("telegram"),
2774
+ z.literal("discord"),
2775
+ z.literal("slack"),
2776
+ z.literal("signal"),
2777
+ z.literal("imessage"),
2778
+ z.literal("msteams")
2779
+ ]).optional(),
2780
+ to: z.string().optional(),
2781
+ model: z.string().optional(),
2782
+ thinking: z.string().optional(),
2783
+ timeoutSeconds: z.number().int().positive().optional(),
2784
+ transform: z.object({
2785
+ module: z.string(),
2786
+ export: z.string().optional()
2787
+ }).strict().optional()
2788
+ }).strict().optional();
2789
+ const InternalHookHandlerSchema = z.object({
2790
+ event: z.string(),
2791
+ module: z.string(),
2792
+ export: z.string().optional()
2793
+ }).strict();
2794
+ const HookConfigSchema = z.object({
2795
+ enabled: z.boolean().optional(),
2796
+ env: z.record(z.string(), z.string()).optional()
2797
+ }).strict();
2798
+ const HookInstallRecordSchema = z.object({
2799
+ source: z.union([
2800
+ z.literal("npm"),
2801
+ z.literal("archive"),
2802
+ z.literal("path")
2803
+ ]),
2804
+ spec: z.string().optional(),
2805
+ sourcePath: z.string().optional(),
2806
+ installPath: z.string().optional(),
2807
+ version: z.string().optional(),
2808
+ installedAt: z.string().optional(),
2809
+ hooks: z.array(z.string()).optional()
2810
+ }).strict();
2811
+ const InternalHooksSchema = z.object({
2812
+ enabled: z.boolean().optional(),
2813
+ handlers: z.array(InternalHookHandlerSchema).optional(),
2814
+ entries: z.record(z.string(), HookConfigSchema).optional(),
2815
+ load: z.object({ extraDirs: z.array(z.string()).optional() }).strict().optional(),
2816
+ installs: z.record(z.string(), HookInstallRecordSchema).optional()
2817
+ }).strict().optional();
2818
+ const HooksGmailSchema = z.object({
2819
+ account: z.string().optional(),
2820
+ label: z.string().optional(),
2821
+ topic: z.string().optional(),
2822
+ subscription: z.string().optional(),
2823
+ pushToken: z.string().optional(),
2824
+ hookUrl: z.string().optional(),
2825
+ includeBody: z.boolean().optional(),
2826
+ maxBytes: z.number().int().positive().optional(),
2827
+ renewEveryMinutes: z.number().int().positive().optional(),
2828
+ allowUnsafeExternalContent: z.boolean().optional(),
2829
+ serve: z.object({
2830
+ bind: z.string().optional(),
2831
+ port: z.number().int().positive().optional(),
2832
+ path: z.string().optional()
2833
+ }).strict().optional(),
2834
+ tailscale: z.object({
2835
+ mode: z.union([
2836
+ z.literal("off"),
2837
+ z.literal("serve"),
2838
+ z.literal("funnel")
2839
+ ]).optional(),
2840
+ path: z.string().optional(),
2841
+ target: z.string().optional()
2842
+ }).strict().optional(),
2843
+ model: z.string().optional(),
2844
+ thinking: z.union([
2845
+ z.literal("off"),
2846
+ z.literal("minimal"),
2847
+ z.literal("low"),
2848
+ z.literal("medium"),
2849
+ z.literal("high")
2850
+ ]).optional()
2851
+ }).strict().optional();
2852
+
2853
+ //#endregion
2854
+ //#region src/config/zod-schema.channels.ts
2855
+ const ChannelHeartbeatVisibilitySchema = z.object({
2856
+ showOk: z.boolean().optional(),
2857
+ showAlerts: z.boolean().optional(),
2858
+ useIndicator: z.boolean().optional()
2859
+ }).strict().optional();
2860
+
2861
+ //#endregion
2862
+ //#region src/config/telegram-custom-commands.ts
2863
+ const TELEGRAM_COMMAND_NAME_PATTERN = /^[a-z0-9_]{1,32}$/;
2864
+ function normalizeTelegramCommandName(value) {
2865
+ const trimmed = value.trim();
2866
+ if (!trimmed) return "";
2867
+ return (trimmed.startsWith("/") ? trimmed.slice(1) : trimmed).trim().toLowerCase();
2868
+ }
2869
+ function normalizeTelegramCommandDescription(value) {
2870
+ return value.trim();
2871
+ }
2872
+ function resolveTelegramCustomCommands(params) {
2873
+ const entries = Array.isArray(params.commands) ? params.commands : [];
2874
+ const reserved = params.reservedCommands ?? /* @__PURE__ */ new Set();
2875
+ const checkReserved = params.checkReserved !== false;
2876
+ const checkDuplicates = params.checkDuplicates !== false;
2877
+ const seen = /* @__PURE__ */ new Set();
2878
+ const resolved = [];
2879
+ const issues = [];
2880
+ for (let index = 0; index < entries.length; index += 1) {
2881
+ const entry = entries[index];
2882
+ const normalized = normalizeTelegramCommandName(String(entry?.command ?? ""));
2883
+ if (!normalized) {
2884
+ issues.push({
2885
+ index,
2886
+ field: "command",
2887
+ message: "Telegram custom command is missing a command name."
2888
+ });
2889
+ continue;
2890
+ }
2891
+ if (!TELEGRAM_COMMAND_NAME_PATTERN.test(normalized)) {
2892
+ issues.push({
2893
+ index,
2894
+ field: "command",
2895
+ message: `Telegram custom command "/${normalized}" is invalid (use a-z, 0-9, underscore; max 32 chars).`
2896
+ });
2897
+ continue;
2898
+ }
2899
+ if (checkReserved && reserved.has(normalized)) {
2900
+ issues.push({
2901
+ index,
2902
+ field: "command",
2903
+ message: `Telegram custom command "/${normalized}" conflicts with a native command.`
2904
+ });
2905
+ continue;
2906
+ }
2907
+ if (checkDuplicates && seen.has(normalized)) {
2908
+ issues.push({
2909
+ index,
2910
+ field: "command",
2911
+ message: `Telegram custom command "/${normalized}" is duplicated.`
2912
+ });
2913
+ continue;
2914
+ }
2915
+ const description = normalizeTelegramCommandDescription(String(entry?.description ?? ""));
2916
+ if (!description) {
2917
+ issues.push({
2918
+ index,
2919
+ field: "description",
2920
+ message: `Telegram custom command "/${normalized}" is missing a description.`
2921
+ });
2922
+ continue;
2923
+ }
2924
+ if (checkDuplicates) seen.add(normalized);
2925
+ resolved.push({
2926
+ command: normalized,
2927
+ description
2928
+ });
2929
+ }
2930
+ return {
2931
+ commands: resolved,
2932
+ issues
2933
+ };
2934
+ }
2935
+
2936
+ //#endregion
2937
+ //#region src/config/zod-schema.providers-core.ts
2938
+ const ToolPolicyBySenderSchema$1 = z.record(z.string(), ToolPolicySchema).optional();
2939
+ const TelegramInlineButtonsScopeSchema = z.enum([
2940
+ "off",
2941
+ "dm",
2942
+ "group",
2943
+ "all",
2944
+ "allowlist"
2945
+ ]);
2946
+ const TelegramCapabilitiesSchema = z.union([z.array(z.string()), z.object({ inlineButtons: TelegramInlineButtonsScopeSchema.optional() }).strict()]);
2947
+ const TelegramTopicSchema = z.object({
2948
+ requireMention: z.boolean().optional(),
2949
+ groupPolicy: GroupPolicySchema.optional(),
2950
+ skills: z.array(z.string()).optional(),
2951
+ enabled: z.boolean().optional(),
2952
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
2953
+ systemPrompt: z.string().optional()
2954
+ }).strict();
2955
+ const TelegramGroupSchema = z.object({
2956
+ requireMention: z.boolean().optional(),
2957
+ groupPolicy: GroupPolicySchema.optional(),
2958
+ tools: ToolPolicySchema,
2959
+ toolsBySender: ToolPolicyBySenderSchema$1,
2960
+ skills: z.array(z.string()).optional(),
2961
+ enabled: z.boolean().optional(),
2962
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
2963
+ systemPrompt: z.string().optional(),
2964
+ topics: z.record(z.string(), TelegramTopicSchema.optional()).optional()
2965
+ }).strict();
2966
+ const TelegramCustomCommandSchema = z.object({
2967
+ command: z.string().transform(normalizeTelegramCommandName),
2968
+ description: z.string().transform(normalizeTelegramCommandDescription)
2969
+ }).strict();
2970
+ const validateTelegramCustomCommands = (value, ctx) => {
2971
+ if (!value.customCommands || value.customCommands.length === 0) return;
2972
+ const { issues } = resolveTelegramCustomCommands({
2973
+ commands: value.customCommands,
2974
+ checkReserved: false,
2975
+ checkDuplicates: false
2976
+ });
2977
+ for (const issue of issues) ctx.addIssue({
2978
+ code: z.ZodIssueCode.custom,
2979
+ path: [
2980
+ "customCommands",
2981
+ issue.index,
2982
+ issue.field
2983
+ ],
2984
+ message: issue.message
2985
+ });
2986
+ };
2987
+ const TelegramAccountSchemaBase = z.object({
2988
+ name: z.string().optional(),
2989
+ capabilities: TelegramCapabilitiesSchema.optional(),
2990
+ markdown: MarkdownConfigSchema,
2991
+ enabled: z.boolean().optional(),
2992
+ commands: ProviderCommandsSchema,
2993
+ customCommands: z.array(TelegramCustomCommandSchema).optional(),
2994
+ configWrites: z.boolean().optional(),
2995
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
2996
+ botToken: z.string().optional(),
2997
+ tokenFile: z.string().optional(),
2998
+ replyToMode: ReplyToModeSchema.optional(),
2999
+ groups: z.record(z.string(), TelegramGroupSchema.optional()).optional(),
3000
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3001
+ groupAllowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3002
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3003
+ historyLimit: z.number().int().min(0).optional(),
3004
+ dmHistoryLimit: z.number().int().min(0).optional(),
3005
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3006
+ textChunkLimit: z.number().int().positive().optional(),
3007
+ chunkMode: z.enum(["length", "newline"]).optional(),
3008
+ blockStreaming: z.boolean().optional(),
3009
+ draftChunk: BlockStreamingChunkSchema.optional(),
3010
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3011
+ streamMode: z.enum([
3012
+ "off",
3013
+ "partial",
3014
+ "block"
3015
+ ]).optional().default("partial"),
3016
+ mediaMaxMb: z.number().positive().optional(),
3017
+ timeoutSeconds: z.number().int().positive().optional(),
3018
+ retry: RetryConfigSchema,
3019
+ network: z.object({ autoSelectFamily: z.boolean().optional() }).strict().optional(),
3020
+ proxy: z.string().optional(),
3021
+ webhookUrl: z.string().optional(),
3022
+ webhookSecret: z.string().optional(),
3023
+ webhookPath: z.string().optional(),
3024
+ actions: z.object({
3025
+ reactions: z.boolean().optional(),
3026
+ sendMessage: z.boolean().optional(),
3027
+ deleteMessage: z.boolean().optional(),
3028
+ sticker: z.boolean().optional()
3029
+ }).strict().optional(),
3030
+ reactionNotifications: z.enum([
3031
+ "off",
3032
+ "own",
3033
+ "all"
3034
+ ]).optional(),
3035
+ reactionLevel: z.enum([
3036
+ "off",
3037
+ "ack",
3038
+ "minimal",
3039
+ "extensive"
3040
+ ]).optional(),
3041
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3042
+ linkPreview: z.boolean().optional(),
3043
+ responsePrefix: z.string().optional()
3044
+ }).strict();
3045
+ const TelegramAccountSchema = TelegramAccountSchemaBase.superRefine((value, ctx) => {
3046
+ requireOpenAllowFrom({
3047
+ policy: value.dmPolicy,
3048
+ allowFrom: value.allowFrom,
3049
+ ctx,
3050
+ path: ["allowFrom"],
3051
+ message: "channels.telegram.dmPolicy=\"open\" requires channels.telegram.allowFrom to include \"*\""
3052
+ });
3053
+ validateTelegramCustomCommands(value, ctx);
3054
+ });
3055
+ const TelegramConfigSchema = TelegramAccountSchemaBase.extend({ accounts: z.record(z.string(), TelegramAccountSchema.optional()).optional() }).superRefine((value, ctx) => {
3056
+ requireOpenAllowFrom({
3057
+ policy: value.dmPolicy,
3058
+ allowFrom: value.allowFrom,
3059
+ ctx,
3060
+ path: ["allowFrom"],
3061
+ message: "channels.telegram.dmPolicy=\"open\" requires channels.telegram.allowFrom to include \"*\""
3062
+ });
3063
+ validateTelegramCustomCommands(value, ctx);
3064
+ const baseWebhookUrl = typeof value.webhookUrl === "string" ? value.webhookUrl.trim() : "";
3065
+ const baseWebhookSecret = typeof value.webhookSecret === "string" ? value.webhookSecret.trim() : "";
3066
+ if (baseWebhookUrl && !baseWebhookSecret) ctx.addIssue({
3067
+ code: z.ZodIssueCode.custom,
3068
+ message: "channels.telegram.webhookUrl requires channels.telegram.webhookSecret",
3069
+ path: ["webhookSecret"]
3070
+ });
3071
+ if (!value.accounts) return;
3072
+ for (const [accountId, account] of Object.entries(value.accounts)) {
3073
+ if (!account) continue;
3074
+ if (account.enabled === false) continue;
3075
+ if (!(typeof account.webhookUrl === "string" ? account.webhookUrl.trim() : "")) continue;
3076
+ if (!(typeof account.webhookSecret === "string" ? account.webhookSecret.trim() : "") && !baseWebhookSecret) ctx.addIssue({
3077
+ code: z.ZodIssueCode.custom,
3078
+ message: "channels.telegram.accounts.*.webhookUrl requires channels.telegram.webhookSecret or channels.telegram.accounts.*.webhookSecret",
3079
+ path: [
3080
+ "accounts",
3081
+ accountId,
3082
+ "webhookSecret"
3083
+ ]
3084
+ });
3085
+ }
3086
+ });
3087
+ const DiscordDmSchema = z.object({
3088
+ enabled: z.boolean().optional(),
3089
+ policy: DmPolicySchema.optional().default("pairing"),
3090
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3091
+ groupEnabled: z.boolean().optional(),
3092
+ groupChannels: z.array(z.union([z.string(), z.number()])).optional()
3093
+ }).strict().superRefine((value, ctx) => {
3094
+ requireOpenAllowFrom({
3095
+ policy: value.policy,
3096
+ allowFrom: value.allowFrom,
3097
+ ctx,
3098
+ path: ["allowFrom"],
3099
+ message: "channels.discord.dm.policy=\"open\" requires channels.discord.dm.allowFrom to include \"*\""
3100
+ });
3101
+ });
3102
+ const DiscordGuildChannelSchema = z.object({
3103
+ allow: z.boolean().optional(),
3104
+ requireMention: z.boolean().optional(),
3105
+ tools: ToolPolicySchema,
3106
+ toolsBySender: ToolPolicyBySenderSchema$1,
3107
+ skills: z.array(z.string()).optional(),
3108
+ enabled: z.boolean().optional(),
3109
+ users: z.array(z.union([z.string(), z.number()])).optional(),
3110
+ systemPrompt: z.string().optional(),
3111
+ includeThreadStarter: z.boolean().optional(),
3112
+ autoThread: z.boolean().optional()
3113
+ }).strict();
3114
+ const DiscordGuildSchema = z.object({
3115
+ slug: z.string().optional(),
3116
+ requireMention: z.boolean().optional(),
3117
+ tools: ToolPolicySchema,
3118
+ toolsBySender: ToolPolicyBySenderSchema$1,
3119
+ reactionNotifications: z.enum([
3120
+ "off",
3121
+ "own",
3122
+ "all",
3123
+ "allowlist"
3124
+ ]).optional(),
3125
+ users: z.array(z.union([z.string(), z.number()])).optional(),
3126
+ channels: z.record(z.string(), DiscordGuildChannelSchema.optional()).optional()
3127
+ }).strict();
3128
+ const DiscordAccountSchema = z.object({
3129
+ name: z.string().optional(),
3130
+ capabilities: z.array(z.string()).optional(),
3131
+ markdown: MarkdownConfigSchema,
3132
+ enabled: z.boolean().optional(),
3133
+ commands: ProviderCommandsSchema,
3134
+ configWrites: z.boolean().optional(),
3135
+ token: z.string().optional(),
3136
+ allowBots: z.boolean().optional(),
3137
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3138
+ historyLimit: z.number().int().min(0).optional(),
3139
+ dmHistoryLimit: z.number().int().min(0).optional(),
3140
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3141
+ textChunkLimit: z.number().int().positive().optional(),
3142
+ chunkMode: z.enum(["length", "newline"]).optional(),
3143
+ blockStreaming: z.boolean().optional(),
3144
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3145
+ maxLinesPerMessage: z.number().int().positive().optional(),
3146
+ mediaMaxMb: z.number().positive().optional(),
3147
+ retry: RetryConfigSchema,
3148
+ actions: z.object({
3149
+ reactions: z.boolean().optional(),
3150
+ stickers: z.boolean().optional(),
3151
+ emojiUploads: z.boolean().optional(),
3152
+ stickerUploads: z.boolean().optional(),
3153
+ polls: z.boolean().optional(),
3154
+ permissions: z.boolean().optional(),
3155
+ messages: z.boolean().optional(),
3156
+ threads: z.boolean().optional(),
3157
+ pins: z.boolean().optional(),
3158
+ search: z.boolean().optional(),
3159
+ memberInfo: z.boolean().optional(),
3160
+ roleInfo: z.boolean().optional(),
3161
+ roles: z.boolean().optional(),
3162
+ channelInfo: z.boolean().optional(),
3163
+ voiceStatus: z.boolean().optional(),
3164
+ events: z.boolean().optional(),
3165
+ moderation: z.boolean().optional(),
3166
+ channels: z.boolean().optional(),
3167
+ presence: z.boolean().optional()
3168
+ }).strict().optional(),
3169
+ replyToMode: ReplyToModeSchema.optional(),
3170
+ dm: DiscordDmSchema.optional(),
3171
+ guilds: z.record(z.string(), DiscordGuildSchema.optional()).optional(),
3172
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3173
+ execApprovals: z.object({
3174
+ enabled: z.boolean().optional(),
3175
+ approvers: z.array(z.union([z.string(), z.number()])).optional(),
3176
+ agentFilter: z.array(z.string()).optional(),
3177
+ sessionFilter: z.array(z.string()).optional()
3178
+ }).strict().optional(),
3179
+ intents: z.object({
3180
+ presence: z.boolean().optional(),
3181
+ guildMembers: z.boolean().optional()
3182
+ }).strict().optional(),
3183
+ pluralkit: z.object({
3184
+ enabled: z.boolean().optional(),
3185
+ token: z.string().optional()
3186
+ }).strict().optional(),
3187
+ responsePrefix: z.string().optional()
3188
+ }).strict();
3189
+ const DiscordConfigSchema = DiscordAccountSchema.extend({ accounts: z.record(z.string(), DiscordAccountSchema.optional()).optional() });
3190
+ const GoogleChatDmSchema = z.object({
3191
+ enabled: z.boolean().optional(),
3192
+ policy: DmPolicySchema.optional().default("pairing"),
3193
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional()
3194
+ }).strict().superRefine((value, ctx) => {
3195
+ requireOpenAllowFrom({
3196
+ policy: value.policy,
3197
+ allowFrom: value.allowFrom,
3198
+ ctx,
3199
+ path: ["allowFrom"],
3200
+ message: "channels.googlechat.dm.policy=\"open\" requires channels.googlechat.dm.allowFrom to include \"*\""
3201
+ });
3202
+ });
3203
+ const GoogleChatGroupSchema = z.object({
3204
+ enabled: z.boolean().optional(),
3205
+ allow: z.boolean().optional(),
3206
+ requireMention: z.boolean().optional(),
3207
+ users: z.array(z.union([z.string(), z.number()])).optional(),
3208
+ systemPrompt: z.string().optional()
3209
+ }).strict();
3210
+ const GoogleChatAccountSchema = z.object({
3211
+ name: z.string().optional(),
3212
+ capabilities: z.array(z.string()).optional(),
3213
+ enabled: z.boolean().optional(),
3214
+ configWrites: z.boolean().optional(),
3215
+ allowBots: z.boolean().optional(),
3216
+ requireMention: z.boolean().optional(),
3217
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3218
+ groupAllowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3219
+ groups: z.record(z.string(), GoogleChatGroupSchema.optional()).optional(),
3220
+ serviceAccount: z.union([z.string(), z.record(z.string(), z.unknown())]).optional(),
3221
+ serviceAccountFile: z.string().optional(),
3222
+ audienceType: z.enum(["app-url", "project-number"]).optional(),
3223
+ audience: z.string().optional(),
3224
+ webhookPath: z.string().optional(),
3225
+ webhookUrl: z.string().optional(),
3226
+ botUser: z.string().optional(),
3227
+ historyLimit: z.number().int().min(0).optional(),
3228
+ dmHistoryLimit: z.number().int().min(0).optional(),
3229
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3230
+ textChunkLimit: z.number().int().positive().optional(),
3231
+ chunkMode: z.enum(["length", "newline"]).optional(),
3232
+ blockStreaming: z.boolean().optional(),
3233
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3234
+ mediaMaxMb: z.number().positive().optional(),
3235
+ replyToMode: ReplyToModeSchema.optional(),
3236
+ actions: z.object({ reactions: z.boolean().optional() }).strict().optional(),
3237
+ dm: GoogleChatDmSchema.optional(),
3238
+ typingIndicator: z.enum([
3239
+ "none",
3240
+ "message",
3241
+ "reaction"
3242
+ ]).optional(),
3243
+ responsePrefix: z.string().optional()
3244
+ }).strict();
3245
+ const GoogleChatConfigSchema = GoogleChatAccountSchema.extend({
3246
+ accounts: z.record(z.string(), GoogleChatAccountSchema.optional()).optional(),
3247
+ defaultAccount: z.string().optional()
3248
+ });
3249
+ const SlackDmSchema = z.object({
3250
+ enabled: z.boolean().optional(),
3251
+ policy: DmPolicySchema.optional().default("pairing"),
3252
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3253
+ groupEnabled: z.boolean().optional(),
3254
+ groupChannels: z.array(z.union([z.string(), z.number()])).optional(),
3255
+ replyToMode: ReplyToModeSchema.optional()
3256
+ }).strict().superRefine((value, ctx) => {
3257
+ requireOpenAllowFrom({
3258
+ policy: value.policy,
3259
+ allowFrom: value.allowFrom,
3260
+ ctx,
3261
+ path: ["allowFrom"],
3262
+ message: "channels.slack.dm.policy=\"open\" requires channels.slack.dm.allowFrom to include \"*\""
3263
+ });
3264
+ });
3265
+ const SlackChannelSchema = z.object({
3266
+ enabled: z.boolean().optional(),
3267
+ allow: z.boolean().optional(),
3268
+ requireMention: z.boolean().optional(),
3269
+ tools: ToolPolicySchema,
3270
+ toolsBySender: ToolPolicyBySenderSchema$1,
3271
+ allowBots: z.boolean().optional(),
3272
+ users: z.array(z.union([z.string(), z.number()])).optional(),
3273
+ skills: z.array(z.string()).optional(),
3274
+ systemPrompt: z.string().optional()
3275
+ }).strict();
3276
+ const SlackThreadSchema = z.object({
3277
+ historyScope: z.enum(["thread", "channel"]).optional(),
3278
+ inheritParent: z.boolean().optional()
3279
+ }).strict();
3280
+ const SlackReplyToModeByChatTypeSchema = z.object({
3281
+ direct: ReplyToModeSchema.optional(),
3282
+ group: ReplyToModeSchema.optional(),
3283
+ channel: ReplyToModeSchema.optional()
3284
+ }).strict();
3285
+ const SlackAccountSchema = z.object({
3286
+ name: z.string().optional(),
3287
+ mode: z.enum(["socket", "http"]).optional(),
3288
+ signingSecret: z.string().optional(),
3289
+ webhookPath: z.string().optional(),
3290
+ capabilities: z.array(z.string()).optional(),
3291
+ markdown: MarkdownConfigSchema,
3292
+ enabled: z.boolean().optional(),
3293
+ commands: ProviderCommandsSchema,
3294
+ configWrites: z.boolean().optional(),
3295
+ botToken: z.string().optional(),
3296
+ appToken: z.string().optional(),
3297
+ userToken: z.string().optional(),
3298
+ userTokenReadOnly: z.boolean().optional().default(true),
3299
+ allowBots: z.boolean().optional(),
3300
+ requireMention: z.boolean().optional(),
3301
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3302
+ historyLimit: z.number().int().min(0).optional(),
3303
+ dmHistoryLimit: z.number().int().min(0).optional(),
3304
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3305
+ textChunkLimit: z.number().int().positive().optional(),
3306
+ chunkMode: z.enum(["length", "newline"]).optional(),
3307
+ blockStreaming: z.boolean().optional(),
3308
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3309
+ mediaMaxMb: z.number().positive().optional(),
3310
+ reactionNotifications: z.enum([
3311
+ "off",
3312
+ "own",
3313
+ "all",
3314
+ "allowlist"
3315
+ ]).optional(),
3316
+ reactionAllowlist: z.array(z.union([z.string(), z.number()])).optional(),
3317
+ replyToMode: ReplyToModeSchema.optional(),
3318
+ replyToModeByChatType: SlackReplyToModeByChatTypeSchema.optional(),
3319
+ thread: SlackThreadSchema.optional(),
3320
+ actions: z.object({
3321
+ reactions: z.boolean().optional(),
3322
+ messages: z.boolean().optional(),
3323
+ pins: z.boolean().optional(),
3324
+ search: z.boolean().optional(),
3325
+ permissions: z.boolean().optional(),
3326
+ memberInfo: z.boolean().optional(),
3327
+ channelInfo: z.boolean().optional(),
3328
+ emojiList: z.boolean().optional()
3329
+ }).strict().optional(),
3330
+ slashCommand: z.object({
3331
+ enabled: z.boolean().optional(),
3332
+ name: z.string().optional(),
3333
+ sessionPrefix: z.string().optional(),
3334
+ ephemeral: z.boolean().optional()
3335
+ }).strict().optional(),
3336
+ dm: SlackDmSchema.optional(),
3337
+ channels: z.record(z.string(), SlackChannelSchema.optional()).optional(),
3338
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3339
+ responsePrefix: z.string().optional()
3340
+ }).strict();
3341
+ const SlackConfigSchema = SlackAccountSchema.extend({
3342
+ mode: z.enum(["socket", "http"]).optional().default("socket"),
3343
+ signingSecret: z.string().optional(),
3344
+ webhookPath: z.string().optional().default("/slack/events"),
3345
+ accounts: z.record(z.string(), SlackAccountSchema.optional()).optional()
3346
+ }).superRefine((value, ctx) => {
3347
+ const baseMode = value.mode ?? "socket";
3348
+ if (baseMode === "http" && !value.signingSecret) ctx.addIssue({
3349
+ code: z.ZodIssueCode.custom,
3350
+ message: "channels.slack.mode=\"http\" requires channels.slack.signingSecret",
3351
+ path: ["signingSecret"]
3352
+ });
3353
+ if (!value.accounts) return;
3354
+ for (const [accountId, account] of Object.entries(value.accounts)) {
3355
+ if (!account) continue;
3356
+ if (account.enabled === false) continue;
3357
+ if ((account.mode ?? baseMode) !== "http") continue;
3358
+ if (!(account.signingSecret ?? value.signingSecret)) ctx.addIssue({
3359
+ code: z.ZodIssueCode.custom,
3360
+ message: "channels.slack.accounts.*.mode=\"http\" requires channels.slack.signingSecret or channels.slack.accounts.*.signingSecret",
3361
+ path: [
3362
+ "accounts",
3363
+ accountId,
3364
+ "signingSecret"
3365
+ ]
3366
+ });
3367
+ }
3368
+ });
3369
+ const SignalAccountSchemaBase = z.object({
3370
+ name: z.string().optional(),
3371
+ capabilities: z.array(z.string()).optional(),
3372
+ markdown: MarkdownConfigSchema,
3373
+ enabled: z.boolean().optional(),
3374
+ configWrites: z.boolean().optional(),
3375
+ account: z.string().optional(),
3376
+ httpUrl: z.string().optional(),
3377
+ httpHost: z.string().optional(),
3378
+ httpPort: z.number().int().positive().optional(),
3379
+ cliPath: ExecutableTokenSchema.optional(),
3380
+ autoStart: z.boolean().optional(),
3381
+ startupTimeoutMs: z.number().int().min(1e3).max(12e4).optional(),
3382
+ receiveMode: z.union([z.literal("on-start"), z.literal("manual")]).optional(),
3383
+ ignoreAttachments: z.boolean().optional(),
3384
+ ignoreStories: z.boolean().optional(),
3385
+ sendReadReceipts: z.boolean().optional(),
3386
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3387
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3388
+ groupAllowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3389
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3390
+ historyLimit: z.number().int().min(0).optional(),
3391
+ dmHistoryLimit: z.number().int().min(0).optional(),
3392
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3393
+ textChunkLimit: z.number().int().positive().optional(),
3394
+ chunkMode: z.enum(["length", "newline"]).optional(),
3395
+ blockStreaming: z.boolean().optional(),
3396
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3397
+ mediaMaxMb: z.number().int().positive().optional(),
3398
+ reactionNotifications: z.enum([
3399
+ "off",
3400
+ "own",
3401
+ "all",
3402
+ "allowlist"
3403
+ ]).optional(),
3404
+ reactionAllowlist: z.array(z.union([z.string(), z.number()])).optional(),
3405
+ actions: z.object({ reactions: z.boolean().optional() }).strict().optional(),
3406
+ reactionLevel: z.enum([
3407
+ "off",
3408
+ "ack",
3409
+ "minimal",
3410
+ "extensive"
3411
+ ]).optional(),
3412
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3413
+ responsePrefix: z.string().optional()
3414
+ }).strict();
3415
+ const SignalAccountSchema = SignalAccountSchemaBase.superRefine((value, ctx) => {
3416
+ requireOpenAllowFrom({
3417
+ policy: value.dmPolicy,
3418
+ allowFrom: value.allowFrom,
3419
+ ctx,
3420
+ path: ["allowFrom"],
3421
+ message: "channels.signal.dmPolicy=\"open\" requires channels.signal.allowFrom to include \"*\""
3422
+ });
3423
+ });
3424
+ const SignalConfigSchema = SignalAccountSchemaBase.extend({ accounts: z.record(z.string(), SignalAccountSchema.optional()).optional() }).superRefine((value, ctx) => {
3425
+ requireOpenAllowFrom({
3426
+ policy: value.dmPolicy,
3427
+ allowFrom: value.allowFrom,
3428
+ ctx,
3429
+ path: ["allowFrom"],
3430
+ message: "channels.signal.dmPolicy=\"open\" requires channels.signal.allowFrom to include \"*\""
3431
+ });
3432
+ });
3433
+ const IMessageAccountSchemaBase = z.object({
3434
+ name: z.string().optional(),
3435
+ capabilities: z.array(z.string()).optional(),
3436
+ markdown: MarkdownConfigSchema,
3437
+ enabled: z.boolean().optional(),
3438
+ configWrites: z.boolean().optional(),
3439
+ cliPath: ExecutableTokenSchema.optional(),
3440
+ dbPath: z.string().optional(),
3441
+ remoteHost: z.string().optional(),
3442
+ service: z.union([
3443
+ z.literal("imessage"),
3444
+ z.literal("sms"),
3445
+ z.literal("auto")
3446
+ ]).optional(),
3447
+ region: z.string().optional(),
3448
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3449
+ allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3450
+ groupAllowFrom: z.array(z.union([z.string(), z.number()])).optional(),
3451
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3452
+ historyLimit: z.number().int().min(0).optional(),
3453
+ dmHistoryLimit: z.number().int().min(0).optional(),
3454
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3455
+ includeAttachments: z.boolean().optional(),
3456
+ mediaMaxMb: z.number().int().positive().optional(),
3457
+ textChunkLimit: z.number().int().positive().optional(),
3458
+ chunkMode: z.enum(["length", "newline"]).optional(),
3459
+ blockStreaming: z.boolean().optional(),
3460
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3461
+ groups: z.record(z.string(), z.object({
3462
+ requireMention: z.boolean().optional(),
3463
+ tools: ToolPolicySchema,
3464
+ toolsBySender: ToolPolicyBySenderSchema$1
3465
+ }).strict().optional()).optional(),
3466
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3467
+ responsePrefix: z.string().optional()
3468
+ }).strict();
3469
+ const IMessageAccountSchema = IMessageAccountSchemaBase.superRefine((value, ctx) => {
3470
+ requireOpenAllowFrom({
3471
+ policy: value.dmPolicy,
3472
+ allowFrom: value.allowFrom,
3473
+ ctx,
3474
+ path: ["allowFrom"],
3475
+ message: "channels.imessage.dmPolicy=\"open\" requires channels.imessage.allowFrom to include \"*\""
3476
+ });
3477
+ });
3478
+ const IMessageConfigSchema = IMessageAccountSchemaBase.extend({ accounts: z.record(z.string(), IMessageAccountSchema.optional()).optional() }).superRefine((value, ctx) => {
3479
+ requireOpenAllowFrom({
3480
+ policy: value.dmPolicy,
3481
+ allowFrom: value.allowFrom,
3482
+ ctx,
3483
+ path: ["allowFrom"],
3484
+ message: "channels.imessage.dmPolicy=\"open\" requires channels.imessage.allowFrom to include \"*\""
3485
+ });
3486
+ });
3487
+ const BlueBubblesAllowFromEntry = z.union([z.string(), z.number()]);
3488
+ const BlueBubblesActionSchema = z.object({
3489
+ reactions: z.boolean().optional(),
3490
+ edit: z.boolean().optional(),
3491
+ unsend: z.boolean().optional(),
3492
+ reply: z.boolean().optional(),
3493
+ sendWithEffect: z.boolean().optional(),
3494
+ renameGroup: z.boolean().optional(),
3495
+ setGroupIcon: z.boolean().optional(),
3496
+ addParticipant: z.boolean().optional(),
3497
+ removeParticipant: z.boolean().optional(),
3498
+ leaveGroup: z.boolean().optional(),
3499
+ sendAttachment: z.boolean().optional()
3500
+ }).strict().optional();
3501
+ const BlueBubblesGroupConfigSchema = z.object({
3502
+ requireMention: z.boolean().optional(),
3503
+ tools: ToolPolicySchema,
3504
+ toolsBySender: ToolPolicyBySenderSchema$1
3505
+ }).strict();
3506
+ const BlueBubblesAccountSchemaBase = z.object({
3507
+ name: z.string().optional(),
3508
+ capabilities: z.array(z.string()).optional(),
3509
+ markdown: MarkdownConfigSchema,
3510
+ configWrites: z.boolean().optional(),
3511
+ enabled: z.boolean().optional(),
3512
+ serverUrl: z.string().optional(),
3513
+ password: z.string().optional(),
3514
+ webhookPath: z.string().optional(),
3515
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3516
+ allowFrom: z.array(BlueBubblesAllowFromEntry).optional(),
3517
+ groupAllowFrom: z.array(BlueBubblesAllowFromEntry).optional(),
3518
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3519
+ historyLimit: z.number().int().min(0).optional(),
3520
+ dmHistoryLimit: z.number().int().min(0).optional(),
3521
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3522
+ textChunkLimit: z.number().int().positive().optional(),
3523
+ chunkMode: z.enum(["length", "newline"]).optional(),
3524
+ mediaMaxMb: z.number().int().positive().optional(),
3525
+ sendReadReceipts: z.boolean().optional(),
3526
+ blockStreaming: z.boolean().optional(),
3527
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3528
+ groups: z.record(z.string(), BlueBubblesGroupConfigSchema.optional()).optional(),
3529
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3530
+ responsePrefix: z.string().optional()
3531
+ }).strict();
3532
+ const BlueBubblesAccountSchema = BlueBubblesAccountSchemaBase.superRefine((value, ctx) => {
3533
+ requireOpenAllowFrom({
3534
+ policy: value.dmPolicy,
3535
+ allowFrom: value.allowFrom,
3536
+ ctx,
3537
+ path: ["allowFrom"],
3538
+ message: "channels.bluebubbles.accounts.*.dmPolicy=\"open\" requires allowFrom to include \"*\""
3539
+ });
3540
+ });
3541
+ const BlueBubblesConfigSchema = BlueBubblesAccountSchemaBase.extend({
3542
+ accounts: z.record(z.string(), BlueBubblesAccountSchema.optional()).optional(),
3543
+ actions: BlueBubblesActionSchema
3544
+ }).superRefine((value, ctx) => {
3545
+ requireOpenAllowFrom({
3546
+ policy: value.dmPolicy,
3547
+ allowFrom: value.allowFrom,
3548
+ ctx,
3549
+ path: ["allowFrom"],
3550
+ message: "channels.bluebubbles.dmPolicy=\"open\" requires channels.bluebubbles.allowFrom to include \"*\""
3551
+ });
3552
+ });
3553
+ const MSTeamsChannelSchema = z.object({
3554
+ requireMention: z.boolean().optional(),
3555
+ tools: ToolPolicySchema,
3556
+ toolsBySender: ToolPolicyBySenderSchema$1,
3557
+ replyStyle: MSTeamsReplyStyleSchema.optional()
3558
+ }).strict();
3559
+ const MSTeamsTeamSchema = z.object({
3560
+ requireMention: z.boolean().optional(),
3561
+ tools: ToolPolicySchema,
3562
+ toolsBySender: ToolPolicyBySenderSchema$1,
3563
+ replyStyle: MSTeamsReplyStyleSchema.optional(),
3564
+ channels: z.record(z.string(), MSTeamsChannelSchema.optional()).optional()
3565
+ }).strict();
3566
+ const MSTeamsConfigSchema = z.object({
3567
+ enabled: z.boolean().optional(),
3568
+ capabilities: z.array(z.string()).optional(),
3569
+ markdown: MarkdownConfigSchema,
3570
+ configWrites: z.boolean().optional(),
3571
+ appId: z.string().optional(),
3572
+ appPassword: z.string().optional(),
3573
+ tenantId: z.string().optional(),
3574
+ webhook: z.object({
3575
+ port: z.number().int().positive().optional(),
3576
+ path: z.string().optional()
3577
+ }).strict().optional(),
3578
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3579
+ allowFrom: z.array(z.string()).optional(),
3580
+ groupAllowFrom: z.array(z.string()).optional(),
3581
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3582
+ textChunkLimit: z.number().int().positive().optional(),
3583
+ chunkMode: z.enum(["length", "newline"]).optional(),
3584
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3585
+ mediaAllowHosts: z.array(z.string()).optional(),
3586
+ mediaAuthAllowHosts: z.array(z.string()).optional(),
3587
+ requireMention: z.boolean().optional(),
3588
+ historyLimit: z.number().int().min(0).optional(),
3589
+ dmHistoryLimit: z.number().int().min(0).optional(),
3590
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3591
+ replyStyle: MSTeamsReplyStyleSchema.optional(),
3592
+ teams: z.record(z.string(), MSTeamsTeamSchema.optional()).optional(),
3593
+ mediaMaxMb: z.number().positive().optional(),
3594
+ sharePointSiteId: z.string().optional(),
3595
+ heartbeat: ChannelHeartbeatVisibilitySchema,
3596
+ responsePrefix: z.string().optional()
3597
+ }).strict().superRefine((value, ctx) => {
3598
+ requireOpenAllowFrom({
3599
+ policy: value.dmPolicy,
3600
+ allowFrom: value.allowFrom,
3601
+ ctx,
3602
+ path: ["allowFrom"],
3603
+ message: "channels.msteams.dmPolicy=\"open\" requires channels.msteams.allowFrom to include \"*\""
3604
+ });
3605
+ });
3606
+
3607
+ //#endregion
3608
+ //#region src/config/zod-schema.providers-whatsapp.ts
3609
+ const ToolPolicyBySenderSchema = z.record(z.string(), ToolPolicySchema).optional();
3610
+ const WhatsAppAccountSchema = z.object({
3611
+ name: z.string().optional(),
3612
+ capabilities: z.array(z.string()).optional(),
3613
+ markdown: MarkdownConfigSchema,
3614
+ configWrites: z.boolean().optional(),
3615
+ enabled: z.boolean().optional(),
3616
+ sendReadReceipts: z.boolean().optional(),
3617
+ messagePrefix: z.string().optional(),
3618
+ responsePrefix: z.string().optional(),
3619
+ authDir: z.string().optional(),
3620
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3621
+ selfChatMode: z.boolean().optional(),
3622
+ allowFrom: z.array(z.string()).optional(),
3623
+ groupAllowFrom: z.array(z.string()).optional(),
3624
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3625
+ historyLimit: z.number().int().min(0).optional(),
3626
+ dmHistoryLimit: z.number().int().min(0).optional(),
3627
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3628
+ textChunkLimit: z.number().int().positive().optional(),
3629
+ chunkMode: z.enum(["length", "newline"]).optional(),
3630
+ mediaMaxMb: z.number().int().positive().optional(),
3631
+ blockStreaming: z.boolean().optional(),
3632
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3633
+ groups: z.record(z.string(), z.object({
3634
+ requireMention: z.boolean().optional(),
3635
+ tools: ToolPolicySchema,
3636
+ toolsBySender: ToolPolicyBySenderSchema
3637
+ }).strict().optional()).optional(),
3638
+ ackReaction: z.object({
3639
+ emoji: z.string().optional(),
3640
+ direct: z.boolean().optional().default(true),
3641
+ group: z.enum([
3642
+ "always",
3643
+ "mentions",
3644
+ "never"
3645
+ ]).optional().default("mentions")
3646
+ }).strict().optional(),
3647
+ debounceMs: z.number().int().nonnegative().optional().default(0),
3648
+ heartbeat: ChannelHeartbeatVisibilitySchema
3649
+ }).strict().superRefine((value, ctx) => {
3650
+ if (value.dmPolicy !== "open") return;
3651
+ if ((value.allowFrom ?? []).map((v) => String(v).trim()).filter(Boolean).includes("*")) return;
3652
+ ctx.addIssue({
3653
+ code: z.ZodIssueCode.custom,
3654
+ path: ["allowFrom"],
3655
+ message: "channels.whatsapp.accounts.*.dmPolicy=\"open\" requires allowFrom to include \"*\""
3656
+ });
3657
+ });
3658
+ const WhatsAppConfigSchema = z.object({
3659
+ accounts: z.record(z.string(), WhatsAppAccountSchema.optional()).optional(),
3660
+ capabilities: z.array(z.string()).optional(),
3661
+ markdown: MarkdownConfigSchema,
3662
+ configWrites: z.boolean().optional(),
3663
+ sendReadReceipts: z.boolean().optional(),
3664
+ dmPolicy: DmPolicySchema.optional().default("pairing"),
3665
+ messagePrefix: z.string().optional(),
3666
+ responsePrefix: z.string().optional(),
3667
+ selfChatMode: z.boolean().optional(),
3668
+ allowFrom: z.array(z.string()).optional(),
3669
+ groupAllowFrom: z.array(z.string()).optional(),
3670
+ groupPolicy: GroupPolicySchema.optional().default("allowlist"),
3671
+ historyLimit: z.number().int().min(0).optional(),
3672
+ dmHistoryLimit: z.number().int().min(0).optional(),
3673
+ dms: z.record(z.string(), DmConfigSchema.optional()).optional(),
3674
+ textChunkLimit: z.number().int().positive().optional(),
3675
+ chunkMode: z.enum(["length", "newline"]).optional(),
3676
+ mediaMaxMb: z.number().int().positive().optional().default(50),
3677
+ blockStreaming: z.boolean().optional(),
3678
+ blockStreamingCoalesce: BlockStreamingCoalesceSchema.optional(),
3679
+ actions: z.object({
3680
+ reactions: z.boolean().optional(),
3681
+ sendMessage: z.boolean().optional(),
3682
+ polls: z.boolean().optional()
3683
+ }).strict().optional(),
3684
+ groups: z.record(z.string(), z.object({
3685
+ requireMention: z.boolean().optional(),
3686
+ tools: ToolPolicySchema,
3687
+ toolsBySender: ToolPolicyBySenderSchema
3688
+ }).strict().optional()).optional(),
3689
+ ackReaction: z.object({
3690
+ emoji: z.string().optional(),
3691
+ direct: z.boolean().optional().default(true),
3692
+ group: z.enum([
3693
+ "always",
3694
+ "mentions",
3695
+ "never"
3696
+ ]).optional().default("mentions")
3697
+ }).strict().optional(),
3698
+ debounceMs: z.number().int().nonnegative().optional().default(0),
3699
+ heartbeat: ChannelHeartbeatVisibilitySchema
3700
+ }).strict().superRefine((value, ctx) => {
3701
+ if (value.dmPolicy !== "open") return;
3702
+ if ((value.allowFrom ?? []).map((v) => String(v).trim()).filter(Boolean).includes("*")) return;
3703
+ ctx.addIssue({
3704
+ code: z.ZodIssueCode.custom,
3705
+ path: ["allowFrom"],
3706
+ message: "channels.whatsapp.dmPolicy=\"open\" requires channels.whatsapp.allowFrom to include \"*\""
3707
+ });
3708
+ });
3709
+
3710
+ //#endregion
3711
+ //#region src/config/zod-schema.providers.ts
3712
+ const ChannelsSchema = z.object({
3713
+ defaults: z.object({
3714
+ groupPolicy: GroupPolicySchema.optional(),
3715
+ heartbeat: ChannelHeartbeatVisibilitySchema
3716
+ }).strict().optional(),
3717
+ whatsapp: WhatsAppConfigSchema.optional(),
3718
+ telegram: TelegramConfigSchema.optional(),
3719
+ discord: DiscordConfigSchema.optional(),
3720
+ googlechat: GoogleChatConfigSchema.optional(),
3721
+ slack: SlackConfigSchema.optional(),
3722
+ signal: SignalConfigSchema.optional(),
3723
+ imessage: IMessageConfigSchema.optional(),
3724
+ bluebubbles: BlueBubblesConfigSchema.optional(),
3725
+ msteams: MSTeamsConfigSchema.optional()
3726
+ }).passthrough().optional();
3727
+
3728
+ //#endregion
3729
+ //#region src/config/zod-schema.session.ts
3730
+ const SessionResetConfigSchema = z.object({
3731
+ mode: z.union([z.literal("daily"), z.literal("idle")]).optional(),
3732
+ atHour: z.number().int().min(0).max(23).optional(),
3733
+ idleMinutes: z.number().int().positive().optional()
3734
+ }).strict();
3735
+ const SessionSendPolicySchema = z.object({
3736
+ default: z.union([z.literal("allow"), z.literal("deny")]).optional(),
3737
+ rules: z.array(z.object({
3738
+ action: z.union([z.literal("allow"), z.literal("deny")]),
3739
+ match: z.object({
3740
+ channel: z.string().optional(),
3741
+ chatType: z.union([
3742
+ z.literal("direct"),
3743
+ z.literal("group"),
3744
+ z.literal("channel")
3745
+ ]).optional(),
3746
+ keyPrefix: z.string().optional()
3747
+ }).strict().optional()
3748
+ }).strict()).optional()
3749
+ }).strict();
3750
+ const SessionSchema = z.object({
3751
+ scope: z.union([z.literal("per-sender"), z.literal("global")]).optional(),
3752
+ dmScope: z.union([
3753
+ z.literal("main"),
3754
+ z.literal("per-peer"),
3755
+ z.literal("per-channel-peer"),
3756
+ z.literal("per-account-channel-peer")
3757
+ ]).optional(),
3758
+ identityLinks: z.record(z.string(), z.array(z.string())).optional(),
3759
+ resetTriggers: z.array(z.string()).optional(),
3760
+ idleMinutes: z.number().int().positive().optional(),
3761
+ reset: SessionResetConfigSchema.optional(),
3762
+ resetByType: z.object({
3763
+ dm: SessionResetConfigSchema.optional(),
3764
+ group: SessionResetConfigSchema.optional(),
3765
+ thread: SessionResetConfigSchema.optional()
3766
+ }).strict().optional(),
3767
+ resetByChannel: z.record(z.string(), SessionResetConfigSchema).optional(),
3768
+ store: z.string().optional(),
3769
+ typingIntervalSeconds: z.number().int().positive().optional(),
3770
+ typingMode: z.union([
3771
+ z.literal("never"),
3772
+ z.literal("instant"),
3773
+ z.literal("thinking"),
3774
+ z.literal("message")
3775
+ ]).optional(),
3776
+ mainKey: z.string().optional(),
3777
+ sendPolicy: SessionSendPolicySchema.optional(),
3778
+ agentToAgent: z.object({ maxPingPongTurns: z.number().int().min(0).max(5).optional() }).strict().optional()
3779
+ }).strict().optional();
3780
+ const MessagesSchema = z.object({
3781
+ messagePrefix: z.string().optional(),
3782
+ responsePrefix: z.string().optional(),
3783
+ groupChat: GroupChatSchema,
3784
+ queue: QueueSchema,
3785
+ inbound: InboundDebounceSchema,
3786
+ ackReaction: z.string().optional(),
3787
+ ackReactionScope: z.enum([
3788
+ "group-mentions",
3789
+ "group-all",
3790
+ "direct",
3791
+ "all"
3792
+ ]).optional(),
3793
+ removeAckAfterReply: z.boolean().optional(),
3794
+ tts: TtsConfigSchema
3795
+ }).strict().optional();
3796
+ const CommandsSchema = z.object({
3797
+ native: NativeCommandsSettingSchema.optional().default("auto"),
3798
+ nativeSkills: NativeCommandsSettingSchema.optional().default("auto"),
3799
+ text: z.boolean().optional(),
3800
+ bash: z.boolean().optional(),
3801
+ bashForegroundMs: z.number().int().min(0).max(3e4).optional(),
3802
+ config: z.boolean().optional(),
3803
+ debug: z.boolean().optional(),
3804
+ restart: z.boolean().optional(),
3805
+ useAccessGroups: z.boolean().optional(),
3806
+ ownerAllowFrom: z.array(z.union([z.string(), z.number()])).optional()
3807
+ }).strict().optional().default({
3808
+ native: "auto",
3809
+ nativeSkills: "auto"
3810
+ });
3811
+
3812
+ //#endregion
3813
+ //#region src/config/zod-schema.ts
3814
+ const BrowserSnapshotDefaultsSchema = z.object({ mode: z.literal("efficient").optional() }).strict().optional();
3815
+ const NodeHostSchema = z.object({ browserProxy: z.object({
3816
+ enabled: z.boolean().optional(),
3817
+ allowProfiles: z.array(z.string()).optional()
3818
+ }).strict().optional() }).strict().optional();
3819
+ const MemoryQmdPathSchema = z.object({
3820
+ path: z.string(),
3821
+ name: z.string().optional(),
3822
+ pattern: z.string().optional()
3823
+ }).strict();
3824
+ const MemoryQmdSessionSchema = z.object({
3825
+ enabled: z.boolean().optional(),
3826
+ exportDir: z.string().optional(),
3827
+ retentionDays: z.number().int().nonnegative().optional()
3828
+ }).strict();
3829
+ const MemoryQmdUpdateSchema = z.object({
3830
+ interval: z.string().optional(),
3831
+ debounceMs: z.number().int().nonnegative().optional(),
3832
+ onBoot: z.boolean().optional(),
3833
+ waitForBootSync: z.boolean().optional(),
3834
+ embedInterval: z.string().optional(),
3835
+ commandTimeoutMs: z.number().int().nonnegative().optional(),
3836
+ updateTimeoutMs: z.number().int().nonnegative().optional(),
3837
+ embedTimeoutMs: z.number().int().nonnegative().optional()
3838
+ }).strict();
3839
+ const MemoryQmdLimitsSchema = z.object({
3840
+ maxResults: z.number().int().positive().optional(),
3841
+ maxSnippetChars: z.number().int().positive().optional(),
3842
+ maxInjectedChars: z.number().int().positive().optional(),
3843
+ timeoutMs: z.number().int().nonnegative().optional()
3844
+ }).strict();
3845
+ const MemoryQmdSchema = z.object({
3846
+ command: z.string().optional(),
3847
+ includeDefaultMemory: z.boolean().optional(),
3848
+ paths: z.array(MemoryQmdPathSchema).optional(),
3849
+ sessions: MemoryQmdSessionSchema.optional(),
3850
+ update: MemoryQmdUpdateSchema.optional(),
3851
+ limits: MemoryQmdLimitsSchema.optional(),
3852
+ scope: SessionSendPolicySchema.optional()
3853
+ }).strict();
3854
+ const MemorySchema = z.object({
3855
+ backend: z.union([z.literal("builtin"), z.literal("qmd")]).optional(),
3856
+ citations: z.union([
3857
+ z.literal("auto"),
3858
+ z.literal("on"),
3859
+ z.literal("off")
3860
+ ]).optional(),
3861
+ qmd: MemoryQmdSchema.optional()
3862
+ }).strict().optional();
3863
+ const SynurexSchema = z.object({
3864
+ meta: z.object({
3865
+ lastTouchedVersion: z.string().optional(),
3866
+ lastTouchedAt: z.string().optional()
3867
+ }).strict().optional(),
3868
+ env: z.object({
3869
+ shellEnv: z.object({
3870
+ enabled: z.boolean().optional(),
3871
+ timeoutMs: z.number().int().nonnegative().optional()
3872
+ }).strict().optional(),
3873
+ vars: z.record(z.string(), z.string()).optional()
3874
+ }).catchall(z.string()).optional(),
3875
+ wizard: z.object({
3876
+ lastRunAt: z.string().optional(),
3877
+ lastRunVersion: z.string().optional(),
3878
+ lastRunCommit: z.string().optional(),
3879
+ lastRunCommand: z.string().optional(),
3880
+ lastRunMode: z.union([z.literal("local"), z.literal("remote")]).optional()
3881
+ }).strict().optional(),
3882
+ diagnostics: z.object({
3883
+ enabled: z.boolean().optional(),
3884
+ flags: z.array(z.string()).optional(),
3885
+ otel: z.object({
3886
+ enabled: z.boolean().optional(),
3887
+ endpoint: z.string().optional(),
3888
+ protocol: z.union([z.literal("http/protobuf"), z.literal("grpc")]).optional(),
3889
+ headers: z.record(z.string(), z.string()).optional(),
3890
+ serviceName: z.string().optional(),
3891
+ traces: z.boolean().optional(),
3892
+ metrics: z.boolean().optional(),
3893
+ logs: z.boolean().optional(),
3894
+ sampleRate: z.number().min(0).max(1).optional(),
3895
+ flushIntervalMs: z.number().int().nonnegative().optional()
3896
+ }).strict().optional(),
3897
+ cacheTrace: z.object({
3898
+ enabled: z.boolean().optional(),
3899
+ filePath: z.string().optional(),
3900
+ includeMessages: z.boolean().optional(),
3901
+ includePrompt: z.boolean().optional(),
3902
+ includeSystem: z.boolean().optional()
3903
+ }).strict().optional()
3904
+ }).strict().optional(),
3905
+ logging: z.object({
3906
+ level: z.union([
3907
+ z.literal("silent"),
3908
+ z.literal("fatal"),
3909
+ z.literal("error"),
3910
+ z.literal("warn"),
3911
+ z.literal("info"),
3912
+ z.literal("debug"),
3913
+ z.literal("trace")
3914
+ ]).optional(),
3915
+ file: z.string().optional(),
3916
+ consoleLevel: z.union([
3917
+ z.literal("silent"),
3918
+ z.literal("fatal"),
3919
+ z.literal("error"),
3920
+ z.literal("warn"),
3921
+ z.literal("info"),
3922
+ z.literal("debug"),
3923
+ z.literal("trace")
3924
+ ]).optional(),
3925
+ consoleStyle: z.union([
3926
+ z.literal("pretty"),
3927
+ z.literal("compact"),
3928
+ z.literal("json")
3929
+ ]).optional(),
3930
+ redactSensitive: z.union([z.literal("off"), z.literal("tools")]).optional(),
3931
+ redactPatterns: z.array(z.string()).optional()
3932
+ }).strict().optional(),
3933
+ update: z.object({
3934
+ channel: z.union([
3935
+ z.literal("stable"),
3936
+ z.literal("beta"),
3937
+ z.literal("dev")
3938
+ ]).optional(),
3939
+ checkOnStart: z.boolean().optional()
3940
+ }).strict().optional(),
3941
+ browser: z.object({
3942
+ enabled: z.boolean().optional(),
3943
+ evaluateEnabled: z.boolean().optional(),
3944
+ cdpUrl: z.string().optional(),
3945
+ remoteCdpTimeoutMs: z.number().int().nonnegative().optional(),
3946
+ remoteCdpHandshakeTimeoutMs: z.number().int().nonnegative().optional(),
3947
+ color: z.string().optional(),
3948
+ executablePath: z.string().optional(),
3949
+ headless: z.boolean().optional(),
3950
+ noSandbox: z.boolean().optional(),
3951
+ attachOnly: z.boolean().optional(),
3952
+ defaultProfile: z.string().optional(),
3953
+ snapshotDefaults: BrowserSnapshotDefaultsSchema,
3954
+ profiles: z.record(z.string().regex(/^[a-z0-9-]+$/, "Profile names must be alphanumeric with hyphens only"), z.object({
3955
+ cdpPort: z.number().int().min(1).max(65535).optional(),
3956
+ cdpUrl: z.string().optional(),
3957
+ driver: z.union([z.literal("clawd"), z.literal("extension")]).optional(),
3958
+ color: HexColorSchema
3959
+ }).strict().refine((value) => value.cdpPort || value.cdpUrl, { message: "Profile must set cdpPort or cdpUrl" })).optional()
3960
+ }).strict().optional(),
3961
+ ui: z.object({
3962
+ seamColor: HexColorSchema.optional(),
3963
+ assistant: z.object({
3964
+ name: z.string().max(50).optional(),
3965
+ avatar: z.string().max(200).optional()
3966
+ }).strict().optional()
3967
+ }).strict().optional(),
3968
+ auth: z.object({
3969
+ profiles: z.record(z.string(), z.object({
3970
+ provider: z.string(),
3971
+ mode: z.union([
3972
+ z.literal("api_key"),
3973
+ z.literal("oauth"),
3974
+ z.literal("token")
3975
+ ]),
3976
+ email: z.string().optional()
3977
+ }).strict()).optional(),
3978
+ order: z.record(z.string(), z.array(z.string())).optional(),
3979
+ cooldowns: z.object({
3980
+ billingBackoffHours: z.number().positive().optional(),
3981
+ billingBackoffHoursByProvider: z.record(z.string(), z.number().positive()).optional(),
3982
+ billingMaxHours: z.number().positive().optional(),
3983
+ failureWindowHours: z.number().positive().optional()
3984
+ }).strict().optional()
3985
+ }).strict().optional(),
3986
+ models: ModelsConfigSchema,
3987
+ nodeHost: NodeHostSchema,
3988
+ agents: AgentsSchema,
3989
+ tools: ToolsSchema,
3990
+ bindings: BindingsSchema,
3991
+ broadcast: BroadcastSchema,
3992
+ audio: AudioSchema,
3993
+ media: z.object({ preserveFilenames: z.boolean().optional() }).strict().optional(),
3994
+ messages: MessagesSchema,
3995
+ commands: CommandsSchema,
3996
+ approvals: ApprovalsSchema,
3997
+ session: SessionSchema,
3998
+ cron: z.object({
3999
+ enabled: z.boolean().optional(),
4000
+ store: z.string().optional(),
4001
+ maxConcurrentRuns: z.number().int().positive().optional()
4002
+ }).strict().optional(),
4003
+ hooks: z.object({
4004
+ enabled: z.boolean().optional(),
4005
+ path: z.string().optional(),
4006
+ token: z.string().optional(),
4007
+ maxBodyBytes: z.number().int().positive().optional(),
4008
+ presets: z.array(z.string()).optional(),
4009
+ transformsDir: z.string().optional(),
4010
+ mappings: z.array(HookMappingSchema).optional(),
4011
+ gmail: HooksGmailSchema,
4012
+ internal: InternalHooksSchema
4013
+ }).strict().optional(),
4014
+ web: z.object({
4015
+ enabled: z.boolean().optional(),
4016
+ heartbeatSeconds: z.number().int().positive().optional(),
4017
+ reconnect: z.object({
4018
+ initialMs: z.number().positive().optional(),
4019
+ maxMs: z.number().positive().optional(),
4020
+ factor: z.number().positive().optional(),
4021
+ jitter: z.number().min(0).max(1).optional(),
4022
+ maxAttempts: z.number().int().min(0).optional()
4023
+ }).strict().optional()
4024
+ }).strict().optional(),
4025
+ channels: ChannelsSchema,
4026
+ discovery: z.object({
4027
+ wideArea: z.object({ enabled: z.boolean().optional() }).strict().optional(),
4028
+ mdns: z.object({ mode: z.enum([
4029
+ "off",
4030
+ "minimal",
4031
+ "full"
4032
+ ]).optional() }).strict().optional()
4033
+ }).strict().optional(),
4034
+ canvasHost: z.object({
4035
+ enabled: z.boolean().optional(),
4036
+ root: z.string().optional(),
4037
+ port: z.number().int().positive().optional(),
4038
+ liveReload: z.boolean().optional()
4039
+ }).strict().optional(),
4040
+ talk: z.object({
4041
+ voiceId: z.string().optional(),
4042
+ voiceAliases: z.record(z.string(), z.string()).optional(),
4043
+ modelId: z.string().optional(),
4044
+ outputFormat: z.string().optional(),
4045
+ apiKey: z.string().optional(),
4046
+ interruptOnSpeech: z.boolean().optional()
4047
+ }).strict().optional(),
4048
+ gateway: z.object({
4049
+ port: z.number().int().positive().optional(),
4050
+ mode: z.union([z.literal("local"), z.literal("remote")]).optional(),
4051
+ bind: z.union([
4052
+ z.literal("auto"),
4053
+ z.literal("lan"),
4054
+ z.literal("loopback"),
4055
+ z.literal("custom"),
4056
+ z.literal("tailnet")
4057
+ ]).optional(),
4058
+ controlUi: z.object({
4059
+ enabled: z.boolean().optional(),
4060
+ basePath: z.string().optional(),
4061
+ root: z.string().optional(),
4062
+ allowedOrigins: z.array(z.string()).optional(),
4063
+ allowInsecureAuth: z.boolean().optional(),
4064
+ dangerouslyDisableDeviceAuth: z.boolean().optional()
4065
+ }).strict().optional(),
4066
+ auth: z.object({
4067
+ mode: z.union([z.literal("token"), z.literal("password")]).optional(),
4068
+ token: z.string().optional(),
4069
+ password: z.string().optional(),
4070
+ allowTailscale: z.boolean().optional()
4071
+ }).strict().optional(),
4072
+ trustedProxies: z.array(z.string()).optional(),
4073
+ tailscale: z.object({
4074
+ mode: z.union([
4075
+ z.literal("off"),
4076
+ z.literal("serve"),
4077
+ z.literal("funnel")
4078
+ ]).optional(),
4079
+ resetOnExit: z.boolean().optional()
4080
+ }).strict().optional(),
4081
+ remote: z.object({
4082
+ url: z.string().optional(),
4083
+ transport: z.union([z.literal("ssh"), z.literal("direct")]).optional(),
4084
+ token: z.string().optional(),
4085
+ password: z.string().optional(),
4086
+ tlsFingerprint: z.string().optional(),
4087
+ sshTarget: z.string().optional(),
4088
+ sshIdentity: z.string().optional()
4089
+ }).strict().optional(),
4090
+ reload: z.object({
4091
+ mode: z.union([
4092
+ z.literal("off"),
4093
+ z.literal("restart"),
4094
+ z.literal("hot"),
4095
+ z.literal("hybrid")
4096
+ ]).optional(),
4097
+ debounceMs: z.number().int().min(0).optional()
4098
+ }).strict().optional(),
4099
+ tls: z.object({
4100
+ enabled: z.boolean().optional(),
4101
+ autoGenerate: z.boolean().optional(),
4102
+ certPath: z.string().optional(),
4103
+ keyPath: z.string().optional(),
4104
+ caPath: z.string().optional()
4105
+ }).optional(),
4106
+ http: z.object({ endpoints: z.object({
4107
+ chatCompletions: z.object({ enabled: z.boolean().optional() }).strict().optional(),
4108
+ responses: z.object({
4109
+ enabled: z.boolean().optional(),
4110
+ maxBodyBytes: z.number().int().positive().optional(),
4111
+ files: z.object({
4112
+ allowUrl: z.boolean().optional(),
4113
+ allowedMimes: z.array(z.string()).optional(),
4114
+ maxBytes: z.number().int().positive().optional(),
4115
+ maxChars: z.number().int().positive().optional(),
4116
+ maxRedirects: z.number().int().nonnegative().optional(),
4117
+ timeoutMs: z.number().int().positive().optional(),
4118
+ pdf: z.object({
4119
+ maxPages: z.number().int().positive().optional(),
4120
+ maxPixels: z.number().int().positive().optional(),
4121
+ minTextChars: z.number().int().nonnegative().optional()
4122
+ }).strict().optional()
4123
+ }).strict().optional(),
4124
+ images: z.object({
4125
+ allowUrl: z.boolean().optional(),
4126
+ allowedMimes: z.array(z.string()).optional(),
4127
+ maxBytes: z.number().int().positive().optional(),
4128
+ maxRedirects: z.number().int().nonnegative().optional(),
4129
+ timeoutMs: z.number().int().positive().optional()
4130
+ }).strict().optional()
4131
+ }).strict().optional()
4132
+ }).strict().optional() }).strict().optional(),
4133
+ nodes: z.object({
4134
+ browser: z.object({
4135
+ mode: z.union([
4136
+ z.literal("auto"),
4137
+ z.literal("manual"),
4138
+ z.literal("off")
4139
+ ]).optional(),
4140
+ node: z.string().optional()
4141
+ }).strict().optional(),
4142
+ allowCommands: z.array(z.string()).optional(),
4143
+ denyCommands: z.array(z.string()).optional()
4144
+ }).strict().optional()
4145
+ }).strict().optional(),
4146
+ memory: MemorySchema,
4147
+ skills: z.object({
4148
+ allowBundled: z.array(z.string()).optional(),
4149
+ load: z.object({
4150
+ extraDirs: z.array(z.string()).optional(),
4151
+ watch: z.boolean().optional(),
4152
+ watchDebounceMs: z.number().int().min(0).optional()
4153
+ }).strict().optional(),
4154
+ install: z.object({
4155
+ preferBrew: z.boolean().optional(),
4156
+ nodeManager: z.union([
4157
+ z.literal("npm"),
4158
+ z.literal("pnpm"),
4159
+ z.literal("yarn"),
4160
+ z.literal("bun")
4161
+ ]).optional()
4162
+ }).strict().optional(),
4163
+ entries: z.record(z.string(), z.object({
4164
+ enabled: z.boolean().optional(),
4165
+ apiKey: z.string().optional(),
4166
+ env: z.record(z.string(), z.string()).optional(),
4167
+ config: z.record(z.string(), z.unknown()).optional()
4168
+ }).strict()).optional()
4169
+ }).strict().optional(),
4170
+ plugins: z.object({
4171
+ enabled: z.boolean().optional(),
4172
+ allow: z.array(z.string()).optional(),
4173
+ deny: z.array(z.string()).optional(),
4174
+ load: z.object({ paths: z.array(z.string()).optional() }).strict().optional(),
4175
+ slots: z.object({ memory: z.string().optional() }).strict().optional(),
4176
+ entries: z.record(z.string(), z.object({
4177
+ enabled: z.boolean().optional(),
4178
+ config: z.record(z.string(), z.unknown()).optional()
4179
+ }).strict()).optional(),
4180
+ installs: z.record(z.string(), z.object({
4181
+ source: z.union([
4182
+ z.literal("npm"),
4183
+ z.literal("archive"),
4184
+ z.literal("path")
4185
+ ]),
4186
+ spec: z.string().optional(),
4187
+ sourcePath: z.string().optional(),
4188
+ installPath: z.string().optional(),
4189
+ version: z.string().optional(),
4190
+ installedAt: z.string().optional()
4191
+ }).strict()).optional()
4192
+ }).strict().optional()
4193
+ }).strict().superRefine((cfg, ctx) => {
4194
+ const agents = cfg.agents?.list ?? [];
4195
+ if (agents.length === 0) return;
4196
+ const agentIds = new Set(agents.map((agent) => agent.id));
4197
+ const broadcast = cfg.broadcast;
4198
+ if (!broadcast) return;
4199
+ for (const [peerId, ids] of Object.entries(broadcast)) {
4200
+ if (peerId === "strategy") continue;
4201
+ if (!Array.isArray(ids)) continue;
4202
+ for (let idx = 0; idx < ids.length; idx += 1) {
4203
+ const agentId = ids[idx];
4204
+ if (!agentIds.has(agentId)) ctx.addIssue({
4205
+ code: z.ZodIssueCode.custom,
4206
+ path: [
4207
+ "broadcast",
4208
+ peerId,
4209
+ idx
4210
+ ],
4211
+ message: `Unknown agent id "${agentId}" (not in agents.list).`
4212
+ });
4213
+ }
4214
+ }
4215
+ });
4216
+
4217
+ //#endregion
4218
+ //#region src/config/validation.ts
4219
+ const AVATAR_SCHEME_RE = /^[a-z][a-z0-9+.-]*:/i;
4220
+ const AVATAR_DATA_RE = /^data:/i;
4221
+ const AVATAR_HTTP_RE = /^https?:\/\//i;
4222
+ const WINDOWS_ABS_RE = /^[a-zA-Z]:[\\/]/;
4223
+ function isWorkspaceAvatarPath(value, workspaceDir) {
4224
+ const workspaceRoot = path.resolve(workspaceDir);
4225
+ const resolved = path.resolve(workspaceRoot, value);
4226
+ const relative = path.relative(workspaceRoot, resolved);
4227
+ if (relative === "") return true;
4228
+ if (relative.startsWith("..")) return false;
4229
+ return !path.isAbsolute(relative);
4230
+ }
4231
+ function validateIdentityAvatar(config) {
4232
+ const agents = config.agents?.list;
4233
+ if (!Array.isArray(agents) || agents.length === 0) return [];
4234
+ const issues = [];
4235
+ for (const [index, entry] of agents.entries()) {
4236
+ if (!entry || typeof entry !== "object") continue;
4237
+ const avatarRaw = entry.identity?.avatar;
4238
+ if (typeof avatarRaw !== "string") continue;
4239
+ const avatar = avatarRaw.trim();
4240
+ if (!avatar) continue;
4241
+ if (AVATAR_DATA_RE.test(avatar) || AVATAR_HTTP_RE.test(avatar)) continue;
4242
+ if (avatar.startsWith("~")) {
4243
+ issues.push({
4244
+ path: `agents.list.${index}.identity.avatar`,
4245
+ message: "identity.avatar must be a workspace-relative path, http(s) URL, or data URI."
4246
+ });
4247
+ continue;
4248
+ }
4249
+ if (AVATAR_SCHEME_RE.test(avatar) && !WINDOWS_ABS_RE.test(avatar)) {
4250
+ issues.push({
4251
+ path: `agents.list.${index}.identity.avatar`,
4252
+ message: "identity.avatar must be a workspace-relative path, http(s) URL, or data URI."
4253
+ });
4254
+ continue;
4255
+ }
4256
+ if (!isWorkspaceAvatarPath(avatar, resolveAgentWorkspaceDir(config, entry.id ?? resolveDefaultAgentId(config)))) issues.push({
4257
+ path: `agents.list.${index}.identity.avatar`,
4258
+ message: "identity.avatar must stay within the agent workspace."
4259
+ });
4260
+ }
4261
+ return issues;
4262
+ }
4263
+ function validateConfigObject(raw) {
4264
+ const legacyIssues = findLegacyConfigIssues(raw);
4265
+ if (legacyIssues.length > 0) return {
4266
+ ok: false,
4267
+ issues: legacyIssues.map((iss) => ({
4268
+ path: iss.path,
4269
+ message: iss.message
4270
+ }))
4271
+ };
4272
+ const validated = SynurexSchema.safeParse(raw);
4273
+ if (!validated.success) return {
4274
+ ok: false,
4275
+ issues: validated.error.issues.map((iss) => ({
4276
+ path: iss.path.join("."),
4277
+ message: iss.message
4278
+ }))
4279
+ };
4280
+ const duplicates = findDuplicateAgentDirs(validated.data);
4281
+ if (duplicates.length > 0) return {
4282
+ ok: false,
4283
+ issues: [{
4284
+ path: "agents.list",
4285
+ message: formatDuplicateAgentDirError(duplicates)
4286
+ }]
4287
+ };
4288
+ const avatarIssues = validateIdentityAvatar(validated.data);
4289
+ if (avatarIssues.length > 0) return {
4290
+ ok: false,
4291
+ issues: avatarIssues
4292
+ };
4293
+ return {
4294
+ ok: true,
4295
+ config: applyModelDefaults(applyAgentDefaults(applySessionDefaults(validated.data)))
4296
+ };
4297
+ }
4298
+ function isRecord(value) {
4299
+ return Boolean(value && typeof value === "object" && !Array.isArray(value));
4300
+ }
4301
+ function validateConfigObjectWithPlugins(raw) {
4302
+ const base = validateConfigObject(raw);
4303
+ if (!base.ok) return {
4304
+ ok: false,
4305
+ issues: base.issues,
4306
+ warnings: []
4307
+ };
4308
+ const config = base.config;
4309
+ const issues = [];
4310
+ const warnings = [];
4311
+ const pluginsConfig = config.plugins;
4312
+ const normalizedPlugins = normalizePluginsConfig(pluginsConfig);
4313
+ const registry = loadPluginManifestRegistry({
4314
+ config,
4315
+ workspaceDir: resolveAgentWorkspaceDir(config, resolveDefaultAgentId(config)) ?? void 0
4316
+ });
4317
+ const knownIds = new Set(registry.plugins.map((record) => record.id));
4318
+ for (const diag of registry.diagnostics) {
4319
+ let path = diag.pluginId ? `plugins.entries.${diag.pluginId}` : "plugins";
4320
+ if (!diag.pluginId && diag.message.includes("plugin path not found")) path = "plugins.load.paths";
4321
+ const message = `${diag.pluginId ? `plugin ${diag.pluginId}` : "plugin"}: ${diag.message}`;
4322
+ if (diag.level === "error") issues.push({
4323
+ path,
4324
+ message
4325
+ });
4326
+ else warnings.push({
4327
+ path,
4328
+ message
4329
+ });
4330
+ }
4331
+ const entries = pluginsConfig?.entries;
4332
+ if (entries && isRecord(entries)) {
4333
+ for (const pluginId of Object.keys(entries)) if (!knownIds.has(pluginId)) issues.push({
4334
+ path: `plugins.entries.${pluginId}`,
4335
+ message: `plugin not found: ${pluginId}`
4336
+ });
4337
+ }
4338
+ const allow = pluginsConfig?.allow ?? [];
4339
+ for (const pluginId of allow) {
4340
+ if (typeof pluginId !== "string" || !pluginId.trim()) continue;
4341
+ if (!knownIds.has(pluginId)) issues.push({
4342
+ path: "plugins.allow",
4343
+ message: `plugin not found: ${pluginId}`
4344
+ });
4345
+ }
4346
+ const deny = pluginsConfig?.deny ?? [];
4347
+ for (const pluginId of deny) {
4348
+ if (typeof pluginId !== "string" || !pluginId.trim()) continue;
4349
+ if (!knownIds.has(pluginId)) issues.push({
4350
+ path: "plugins.deny",
4351
+ message: `plugin not found: ${pluginId}`
4352
+ });
4353
+ }
4354
+ const memorySlot = normalizedPlugins.slots.memory;
4355
+ if (typeof memorySlot === "string" && memorySlot.trim() && !knownIds.has(memorySlot)) issues.push({
4356
+ path: "plugins.slots.memory",
4357
+ message: `plugin not found: ${memorySlot}`
4358
+ });
4359
+ const allowedChannels = new Set(["defaults", ...CHANNEL_IDS]);
4360
+ for (const record of registry.plugins) for (const channelId of record.channels) allowedChannels.add(channelId);
4361
+ if (config.channels && isRecord(config.channels)) for (const key of Object.keys(config.channels)) {
4362
+ const trimmed = key.trim();
4363
+ if (!trimmed) continue;
4364
+ if (!allowedChannels.has(trimmed)) issues.push({
4365
+ path: `channels.${trimmed}`,
4366
+ message: `unknown channel id: ${trimmed}`
4367
+ });
4368
+ }
4369
+ const heartbeatChannelIds = /* @__PURE__ */ new Set();
4370
+ for (const channelId of CHANNEL_IDS) heartbeatChannelIds.add(channelId.toLowerCase());
4371
+ for (const record of registry.plugins) for (const channelId of record.channels) {
4372
+ const trimmed = channelId.trim();
4373
+ if (trimmed) heartbeatChannelIds.add(trimmed.toLowerCase());
4374
+ }
4375
+ const validateHeartbeatTarget = (target, path) => {
4376
+ if (typeof target !== "string") return;
4377
+ const trimmed = target.trim();
4378
+ if (!trimmed) {
4379
+ issues.push({
4380
+ path,
4381
+ message: "heartbeat target must not be empty"
4382
+ });
4383
+ return;
4384
+ }
4385
+ const normalized = trimmed.toLowerCase();
4386
+ if (normalized === "last" || normalized === "none") return;
4387
+ if (normalizeChatChannelId(trimmed)) return;
4388
+ if (heartbeatChannelIds.has(normalized)) return;
4389
+ issues.push({
4390
+ path,
4391
+ message: `unknown heartbeat target: ${target}`
4392
+ });
4393
+ };
4394
+ validateHeartbeatTarget(config.agents?.defaults?.heartbeat?.target, "agents.defaults.heartbeat.target");
4395
+ if (Array.isArray(config.agents?.list)) for (const [index, entry] of config.agents.list.entries()) validateHeartbeatTarget(entry?.heartbeat?.target, `agents.list.${index}.heartbeat.target`);
4396
+ let selectedMemoryPluginId = null;
4397
+ const seenPlugins = /* @__PURE__ */ new Set();
4398
+ for (const record of registry.plugins) {
4399
+ const pluginId = record.id;
4400
+ if (seenPlugins.has(pluginId)) continue;
4401
+ seenPlugins.add(pluginId);
4402
+ const entry = normalizedPlugins.entries[pluginId];
4403
+ const entryHasConfig = Boolean(entry?.config);
4404
+ const enableState = resolveEnableState(pluginId, record.origin, normalizedPlugins);
4405
+ let enabled = enableState.enabled;
4406
+ let reason = enableState.reason;
4407
+ if (enabled) {
4408
+ const memoryDecision = resolveMemorySlotDecision({
4409
+ id: pluginId,
4410
+ kind: record.kind,
4411
+ slot: memorySlot,
4412
+ selectedId: selectedMemoryPluginId
4413
+ });
4414
+ if (!memoryDecision.enabled) {
4415
+ enabled = false;
4416
+ reason = memoryDecision.reason;
4417
+ }
4418
+ if (memoryDecision.selected && record.kind === "memory") selectedMemoryPluginId = pluginId;
4419
+ }
4420
+ if (enabled || entryHasConfig) if (record.configSchema) {
4421
+ const res = validateJsonSchemaValue({
4422
+ schema: record.configSchema,
4423
+ cacheKey: record.schemaCacheKey ?? record.manifestPath ?? pluginId,
4424
+ value: entry?.config ?? {}
4425
+ });
4426
+ if (!res.ok) for (const error of res.errors) issues.push({
4427
+ path: `plugins.entries.${pluginId}.config`,
4428
+ message: `invalid config: ${error}`
4429
+ });
4430
+ } else issues.push({
4431
+ path: `plugins.entries.${pluginId}`,
4432
+ message: `plugin schema missing for ${pluginId}`
4433
+ });
4434
+ if (!enabled && entryHasConfig) warnings.push({
4435
+ path: `plugins.entries.${pluginId}`,
4436
+ message: `plugin disabled (${reason ?? "disabled"}) but config is present`
4437
+ });
4438
+ }
4439
+ if (issues.length > 0) return {
4440
+ ok: false,
4441
+ issues,
4442
+ warnings
4443
+ };
4444
+ return {
4445
+ ok: true,
4446
+ config,
4447
+ warnings
4448
+ };
4449
+ }
4450
+
4451
+ //#endregion
4452
+ //#region src/config/version.ts
4453
+ const VERSION_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:-(\d+))?/;
4454
+ function parseSynurexVersion(raw) {
4455
+ if (!raw) return null;
4456
+ const match = raw.trim().match(VERSION_RE);
4457
+ if (!match) return null;
4458
+ const [, major, minor, patch, revision] = match;
4459
+ return {
4460
+ major: Number.parseInt(major, 10),
4461
+ minor: Number.parseInt(minor, 10),
4462
+ patch: Number.parseInt(patch, 10),
4463
+ revision: revision ? Number.parseInt(revision, 10) : 0
4464
+ };
4465
+ }
4466
+ function compareSynurexVersions(a, b) {
4467
+ const parsedA = parseSynurexVersion(a);
4468
+ const parsedB = parseSynurexVersion(b);
4469
+ if (!parsedA || !parsedB) return null;
4470
+ if (parsedA.major !== parsedB.major) return parsedA.major < parsedB.major ? -1 : 1;
4471
+ if (parsedA.minor !== parsedB.minor) return parsedA.minor < parsedB.minor ? -1 : 1;
4472
+ if (parsedA.patch !== parsedB.patch) return parsedA.patch < parsedB.patch ? -1 : 1;
4473
+ if (parsedA.revision !== parsedB.revision) return parsedA.revision < parsedB.revision ? -1 : 1;
4474
+ return 0;
4475
+ }
4476
+
4477
+ //#endregion
4478
+ //#region src/config/io.ts
4479
+ const SHELL_ENV_EXPECTED_KEYS = [
4480
+ "OPENAI_API_KEY",
4481
+ "ANTHROPIC_API_KEY",
4482
+ "ANTHROPIC_OAUTH_TOKEN",
4483
+ "GEMINI_API_KEY",
4484
+ "ZAI_API_KEY",
4485
+ "OPENROUTER_API_KEY",
4486
+ "AI_GATEWAY_API_KEY",
4487
+ "MINIMAX_API_KEY",
4488
+ "SYNTHETIC_API_KEY",
4489
+ "ELEVENLABS_API_KEY",
4490
+ "TELEGRAM_BOT_TOKEN",
4491
+ "DISCORD_BOT_TOKEN",
4492
+ "SLACK_BOT_TOKEN",
4493
+ "SLACK_APP_TOKEN",
4494
+ "SYNUREX_GATEWAY_TOKEN",
4495
+ "SYNUREX_GATEWAY_TOKEN",
4496
+ "SYNUREX_GATEWAY_PASSWORD",
4497
+ "SYNUREX_GATEWAY_PASSWORD"
4498
+ ];
4499
+ const CONFIG_BACKUP_COUNT = 5;
4500
+ const loggedInvalidConfigs = /* @__PURE__ */ new Set();
4501
+ function hashConfigRaw(raw) {
4502
+ return crypto.createHash("sha256").update(raw ?? "").digest("hex");
4503
+ }
4504
+ function resolveConfigSnapshotHash(snapshot) {
4505
+ if (typeof snapshot.hash === "string") {
4506
+ const trimmed = snapshot.hash.trim();
4507
+ if (trimmed) return trimmed;
4508
+ }
4509
+ if (typeof snapshot.raw !== "string") return null;
4510
+ return hashConfigRaw(snapshot.raw);
4511
+ }
4512
+ function coerceConfig(value) {
4513
+ if (!value || typeof value !== "object" || Array.isArray(value)) return {};
4514
+ return value;
4515
+ }
4516
+ async function rotateConfigBackups(configPath, ioFs) {
4517
+ if (CONFIG_BACKUP_COUNT <= 1) return;
4518
+ const backupBase = `${configPath}.bak`;
4519
+ const maxIndex = CONFIG_BACKUP_COUNT - 1;
4520
+ await ioFs.unlink(`${backupBase}.${maxIndex}`).catch(() => {});
4521
+ for (let index = maxIndex - 1; index >= 1; index -= 1) await ioFs.rename(`${backupBase}.${index}`, `${backupBase}.${index + 1}`).catch(() => {});
4522
+ await ioFs.rename(backupBase, `${backupBase}.1`).catch(() => {});
4523
+ }
4524
+ function warnOnConfigMiskeys(raw, logger) {
4525
+ if (!raw || typeof raw !== "object") return;
4526
+ const gateway = raw.gateway;
4527
+ if (!gateway || typeof gateway !== "object") return;
4528
+ if ("token" in gateway) logger.warn("Config uses \"gateway.token\". This key is ignored; use \"gateway.auth.token\" instead.");
4529
+ }
4530
+ function stampConfigVersion(cfg) {
4531
+ const now = (/* @__PURE__ */ new Date()).toISOString();
4532
+ return {
4533
+ ...cfg,
4534
+ meta: {
4535
+ ...cfg.meta,
4536
+ lastTouchedVersion: VERSION,
4537
+ lastTouchedAt: now
4538
+ }
4539
+ };
4540
+ }
4541
+ function warnIfConfigFromFuture(cfg, logger) {
4542
+ const touched = cfg.meta?.lastTouchedVersion;
4543
+ if (!touched) return;
4544
+ const cmp = compareSynurexVersions(VERSION, touched);
4545
+ if (cmp === null) return;
4546
+ if (cmp < 0) logger.warn(`Config was last written by a newer Synurex (${touched}); current version is ${VERSION}.`);
4547
+ }
4548
+ function applyConfigEnv(cfg, env) {
4549
+ const entries = collectConfigEnvVars(cfg);
4550
+ for (const [key, value] of Object.entries(entries)) {
4551
+ if (env[key]?.trim()) continue;
4552
+ env[key] = value;
4553
+ }
4554
+ }
4555
+ function resolveConfigPathForDeps(deps) {
4556
+ if (deps.configPath) return deps.configPath;
4557
+ return resolveConfigPath(deps.env, resolveStateDir(deps.env, deps.homedir));
4558
+ }
4559
+ function normalizeDeps(overrides = {}) {
4560
+ return {
4561
+ fs: overrides.fs ?? fs,
4562
+ json5: overrides.json5 ?? JSON5,
4563
+ env: overrides.env ?? process.env,
4564
+ homedir: overrides.homedir ?? os.homedir,
4565
+ configPath: overrides.configPath ?? "",
4566
+ logger: overrides.logger ?? console
4567
+ };
4568
+ }
4569
+ function parseConfigJson5(raw, json5 = JSON5) {
4570
+ try {
4571
+ return {
4572
+ ok: true,
4573
+ parsed: json5.parse(raw)
4574
+ };
4575
+ } catch (err) {
4576
+ return {
4577
+ ok: false,
4578
+ error: String(err)
4579
+ };
4580
+ }
4581
+ }
4582
+ function createConfigIO(overrides = {}) {
4583
+ const deps = normalizeDeps(overrides);
4584
+ const requestedConfigPath = resolveConfigPathForDeps(deps);
4585
+ const configPath = (deps.configPath ? [requestedConfigPath] : resolveDefaultConfigCandidates(deps.env, deps.homedir)).find((candidate) => deps.fs.existsSync(candidate)) ?? requestedConfigPath;
4586
+ function loadConfig() {
4587
+ try {
4588
+ if (!deps.fs.existsSync(configPath)) {
4589
+ if (shouldEnableShellEnvFallback(deps.env) && !shouldDeferShellEnvFallback(deps.env)) loadShellEnvFallback({
4590
+ enabled: true,
4591
+ env: deps.env,
4592
+ expectedKeys: SHELL_ENV_EXPECTED_KEYS,
4593
+ logger: deps.logger,
4594
+ timeoutMs: resolveShellEnvFallbackTimeoutMs(deps.env)
4595
+ });
4596
+ return {};
4597
+ }
4598
+ const raw = deps.fs.readFileSync(configPath, "utf-8");
4599
+ const resolved = resolveConfigIncludes(deps.json5.parse(raw), configPath, {
4600
+ readFile: (p) => deps.fs.readFileSync(p, "utf-8"),
4601
+ parseJson: (raw) => deps.json5.parse(raw)
4602
+ });
4603
+ if (resolved && typeof resolved === "object" && "env" in resolved) applyConfigEnv(resolved, deps.env);
4604
+ const resolvedConfig = resolveConfigEnvVars(resolved, deps.env);
4605
+ warnOnConfigMiskeys(resolvedConfig, deps.logger);
4606
+ if (typeof resolvedConfig !== "object" || resolvedConfig === null) return {};
4607
+ const preValidationDuplicates = findDuplicateAgentDirs(resolvedConfig, {
4608
+ env: deps.env,
4609
+ homedir: deps.homedir
4610
+ });
4611
+ if (preValidationDuplicates.length > 0) throw new DuplicateAgentDirError(preValidationDuplicates);
4612
+ const validated = validateConfigObjectWithPlugins(resolvedConfig);
4613
+ if (!validated.ok) {
4614
+ const details = validated.issues.map((iss) => `- ${iss.path || "<root>"}: ${iss.message}`).join("\n");
4615
+ if (!loggedInvalidConfigs.has(configPath)) {
4616
+ loggedInvalidConfigs.add(configPath);
4617
+ deps.logger.error(`Invalid config at ${configPath}:\\n${details}`);
4618
+ }
4619
+ const error = /* @__PURE__ */ new Error("Invalid config");
4620
+ error.code = "INVALID_CONFIG";
4621
+ error.details = details;
4622
+ throw error;
4623
+ }
4624
+ if (validated.warnings.length > 0) {
4625
+ const details = validated.warnings.map((iss) => `- ${iss.path || "<root>"}: ${iss.message}`).join("\n");
4626
+ deps.logger.warn(`Config warnings:\\n${details}`);
4627
+ }
4628
+ warnIfConfigFromFuture(validated.config, deps.logger);
4629
+ const cfg = applyModelDefaults(applyCompactionDefaults(applyContextPruningDefaults(applyAgentDefaults(applySessionDefaults(applyLoggingDefaults(applyMessageDefaults(validated.config)))))));
4630
+ normalizeConfigPaths(cfg);
4631
+ const duplicates = findDuplicateAgentDirs(cfg, {
4632
+ env: deps.env,
4633
+ homedir: deps.homedir
4634
+ });
4635
+ if (duplicates.length > 0) throw new DuplicateAgentDirError(duplicates);
4636
+ applyConfigEnv(cfg, deps.env);
4637
+ if ((shouldEnableShellEnvFallback(deps.env) || cfg.env?.shellEnv?.enabled === true) && !shouldDeferShellEnvFallback(deps.env)) loadShellEnvFallback({
4638
+ enabled: true,
4639
+ env: deps.env,
4640
+ expectedKeys: SHELL_ENV_EXPECTED_KEYS,
4641
+ logger: deps.logger,
4642
+ timeoutMs: cfg.env?.shellEnv?.timeoutMs ?? resolveShellEnvFallbackTimeoutMs(deps.env)
4643
+ });
4644
+ return applyConfigOverrides(cfg);
4645
+ } catch (err) {
4646
+ if (err instanceof DuplicateAgentDirError) {
4647
+ deps.logger.error(err.message);
4648
+ throw err;
4649
+ }
4650
+ if (err?.code === "INVALID_CONFIG") return {};
4651
+ deps.logger.error(`Failed to read config at ${configPath}`, err);
4652
+ return {};
4653
+ }
4654
+ }
4655
+ async function readConfigFileSnapshot() {
4656
+ if (!deps.fs.existsSync(configPath)) {
4657
+ const hash = hashConfigRaw(null);
4658
+ return {
4659
+ path: configPath,
4660
+ exists: false,
4661
+ raw: null,
4662
+ parsed: {},
4663
+ valid: true,
4664
+ config: applyTalkApiKey(applyModelDefaults(applyCompactionDefaults(applyContextPruningDefaults(applyAgentDefaults(applySessionDefaults(applyMessageDefaults({}))))))),
4665
+ hash,
4666
+ issues: [],
4667
+ warnings: [],
4668
+ legacyIssues: []
4669
+ };
4670
+ }
4671
+ try {
4672
+ const raw = deps.fs.readFileSync(configPath, "utf-8");
4673
+ const hash = hashConfigRaw(raw);
4674
+ const parsedRes = parseConfigJson5(raw, deps.json5);
4675
+ if (!parsedRes.ok) return {
4676
+ path: configPath,
4677
+ exists: true,
4678
+ raw,
4679
+ parsed: {},
4680
+ valid: false,
4681
+ config: {},
4682
+ hash,
4683
+ issues: [{
4684
+ path: "",
4685
+ message: `JSON5 parse failed: ${parsedRes.error}`
4686
+ }],
4687
+ warnings: [],
4688
+ legacyIssues: []
4689
+ };
4690
+ let resolved;
4691
+ try {
4692
+ resolved = resolveConfigIncludes(parsedRes.parsed, configPath, {
4693
+ readFile: (p) => deps.fs.readFileSync(p, "utf-8"),
4694
+ parseJson: (raw) => deps.json5.parse(raw)
4695
+ });
4696
+ } catch (err) {
4697
+ const message = err instanceof ConfigIncludeError ? err.message : `Include resolution failed: ${String(err)}`;
4698
+ return {
4699
+ path: configPath,
4700
+ exists: true,
4701
+ raw,
4702
+ parsed: parsedRes.parsed,
4703
+ valid: false,
4704
+ config: coerceConfig(parsedRes.parsed),
4705
+ hash,
4706
+ issues: [{
4707
+ path: "",
4708
+ message
4709
+ }],
4710
+ warnings: [],
4711
+ legacyIssues: []
4712
+ };
4713
+ }
4714
+ if (resolved && typeof resolved === "object" && "env" in resolved) applyConfigEnv(resolved, deps.env);
4715
+ let substituted;
4716
+ try {
4717
+ substituted = resolveConfigEnvVars(resolved, deps.env);
4718
+ } catch (err) {
4719
+ const message = err instanceof MissingEnvVarError ? err.message : `Env var substitution failed: ${String(err)}`;
4720
+ return {
4721
+ path: configPath,
4722
+ exists: true,
4723
+ raw,
4724
+ parsed: parsedRes.parsed,
4725
+ valid: false,
4726
+ config: coerceConfig(resolved),
4727
+ hash,
4728
+ issues: [{
4729
+ path: "",
4730
+ message
4731
+ }],
4732
+ warnings: [],
4733
+ legacyIssues: []
4734
+ };
4735
+ }
4736
+ const resolvedConfigRaw = substituted;
4737
+ const legacyIssues = findLegacyConfigIssues(resolvedConfigRaw);
4738
+ const validated = validateConfigObjectWithPlugins(resolvedConfigRaw);
4739
+ if (!validated.ok) return {
4740
+ path: configPath,
4741
+ exists: true,
4742
+ raw,
4743
+ parsed: parsedRes.parsed,
4744
+ valid: false,
4745
+ config: coerceConfig(resolvedConfigRaw),
4746
+ hash,
4747
+ issues: validated.issues,
4748
+ warnings: validated.warnings,
4749
+ legacyIssues
4750
+ };
4751
+ warnIfConfigFromFuture(validated.config, deps.logger);
4752
+ return {
4753
+ path: configPath,
4754
+ exists: true,
4755
+ raw,
4756
+ parsed: parsedRes.parsed,
4757
+ valid: true,
4758
+ config: normalizeConfigPaths(applyTalkApiKey(applyModelDefaults(applyAgentDefaults(applySessionDefaults(applyLoggingDefaults(applyMessageDefaults(validated.config))))))),
4759
+ hash,
4760
+ issues: [],
4761
+ warnings: validated.warnings,
4762
+ legacyIssues
4763
+ };
4764
+ } catch (err) {
4765
+ return {
4766
+ path: configPath,
4767
+ exists: true,
4768
+ raw: null,
4769
+ parsed: {},
4770
+ valid: false,
4771
+ config: {},
4772
+ hash: hashConfigRaw(null),
4773
+ issues: [{
4774
+ path: "",
4775
+ message: `read failed: ${String(err)}`
4776
+ }],
4777
+ warnings: [],
4778
+ legacyIssues: []
4779
+ };
4780
+ }
4781
+ }
4782
+ async function writeConfigFile(cfg) {
4783
+ clearConfigCache();
4784
+ const validated = validateConfigObjectWithPlugins(cfg);
4785
+ if (!validated.ok) {
4786
+ const issue = validated.issues[0];
4787
+ const pathLabel = issue?.path ? issue.path : "<root>";
4788
+ throw new Error(`Config validation failed: ${pathLabel}: ${issue?.message ?? "invalid"}`);
4789
+ }
4790
+ if (validated.warnings.length > 0) {
4791
+ const details = validated.warnings.map((warning) => `- ${warning.path}: ${warning.message}`).join("\n");
4792
+ deps.logger.warn(`Config warnings:\n${details}`);
4793
+ }
4794
+ const dir = path.dirname(configPath);
4795
+ await deps.fs.promises.mkdir(dir, {
4796
+ recursive: true,
4797
+ mode: 448
4798
+ });
4799
+ const json = JSON.stringify(applyModelDefaults(stampConfigVersion(cfg)), null, 2).trimEnd().concat("\n");
4800
+ const tmp = path.join(dir, `${path.basename(configPath)}.${process.pid}.${crypto.randomUUID()}.tmp`);
4801
+ await deps.fs.promises.writeFile(tmp, json, {
4802
+ encoding: "utf-8",
4803
+ mode: 384
4804
+ });
4805
+ if (deps.fs.existsSync(configPath)) {
4806
+ await rotateConfigBackups(configPath, deps.fs.promises);
4807
+ await deps.fs.promises.copyFile(configPath, `${configPath}.bak`).catch(() => {});
4808
+ }
4809
+ try {
4810
+ await deps.fs.promises.rename(tmp, configPath);
4811
+ } catch (err) {
4812
+ const code = err.code;
4813
+ if (code === "EPERM" || code === "EEXIST") {
4814
+ await deps.fs.promises.copyFile(tmp, configPath);
4815
+ await deps.fs.promises.chmod(configPath, 384).catch(() => {});
4816
+ await deps.fs.promises.unlink(tmp).catch(() => {});
4817
+ return;
4818
+ }
4819
+ await deps.fs.promises.unlink(tmp).catch(() => {});
4820
+ throw err;
4821
+ }
4822
+ }
4823
+ return {
4824
+ configPath,
4825
+ loadConfig,
4826
+ readConfigFileSnapshot,
4827
+ writeConfigFile
4828
+ };
4829
+ }
4830
+ const DEFAULT_CONFIG_CACHE_MS = 200;
4831
+ let configCache = null;
4832
+ function resolveConfigCacheMs(env) {
4833
+ const raw = env.SYNUREX_CONFIG_CACHE_MS?.trim();
4834
+ if (raw === "" || raw === "0") return 0;
4835
+ if (!raw) return DEFAULT_CONFIG_CACHE_MS;
4836
+ const parsed = Number.parseInt(raw, 10);
4837
+ if (!Number.isFinite(parsed)) return DEFAULT_CONFIG_CACHE_MS;
4838
+ return Math.max(0, parsed);
4839
+ }
4840
+ function shouldUseConfigCache(env) {
4841
+ if (env.SYNUREX_DISABLE_CONFIG_CACHE?.trim()) return false;
4842
+ return resolveConfigCacheMs(env) > 0;
4843
+ }
4844
+ function clearConfigCache() {
4845
+ configCache = null;
4846
+ }
4847
+ function loadConfig() {
4848
+ const io = createConfigIO();
4849
+ const configPath = io.configPath;
4850
+ const now = Date.now();
4851
+ if (shouldUseConfigCache(process.env)) {
4852
+ const cached = configCache;
4853
+ if (cached && cached.configPath === configPath && cached.expiresAt > now) return cached.config;
4854
+ }
4855
+ const config = io.loadConfig();
4856
+ if (shouldUseConfigCache(process.env)) {
4857
+ const cacheMs = resolveConfigCacheMs(process.env);
4858
+ if (cacheMs > 0) configCache = {
4859
+ configPath,
4860
+ expiresAt: now + cacheMs,
4861
+ config
4862
+ };
4863
+ }
4864
+ return config;
4865
+ }
4866
+ async function readConfigFileSnapshot() {
4867
+ return await createConfigIO().readConfigFileSnapshot();
4868
+ }
4869
+ async function writeConfigFile(cfg) {
4870
+ clearConfigCache();
4871
+ await createConfigIO().writeConfigFile(cfg);
4872
+ }
4873
+
4874
+ //#endregion
4875
+ //#region src/config/legacy-migrate.ts
4876
+ function migrateLegacyConfig(raw) {
4877
+ const { next, changes } = applyLegacyMigrations(raw);
4878
+ if (!next) return {
4879
+ config: null,
4880
+ changes: []
4881
+ };
4882
+ const validated = validateConfigObjectWithPlugins(next);
4883
+ if (!validated.ok) {
4884
+ changes.push("Migration applied, but config still invalid; fix remaining issues manually.");
4885
+ return {
4886
+ config: null,
4887
+ changes
4888
+ };
4889
+ }
4890
+ return {
4891
+ config: validated.config,
4892
+ changes
4893
+ };
4894
+ }
4895
+
4896
+ //#endregion
4897
+ //#region src/config/config.ts
4898
+ var config_exports = /* @__PURE__ */ __exportAll({
4899
+ CONFIG_PATH: () => CONFIG_PATH,
4900
+ DEFAULT_GATEWAY_PORT: () => DEFAULT_GATEWAY_PORT,
4901
+ STATE_DIR: () => STATE_DIR,
4902
+ applyConfigOverrides: () => applyConfigOverrides,
4903
+ getConfigOverrides: () => getConfigOverrides,
4904
+ isNixMode: () => isNixMode,
4905
+ loadConfig: () => loadConfig,
4906
+ resetConfigOverrides: () => resetConfigOverrides,
4907
+ resolveCanonicalConfigPath: () => resolveCanonicalConfigPath,
4908
+ resolveConfigPath: () => resolveConfigPath,
4909
+ resolveConfigPathCandidate: () => resolveConfigPathCandidate,
4910
+ resolveDefaultConfigCandidates: () => resolveDefaultConfigCandidates,
4911
+ resolveGatewayLockDir: () => resolveGatewayLockDir,
4912
+ resolveGatewayPort: () => resolveGatewayPort,
4913
+ resolveIsNixMode: () => resolveIsNixMode,
4914
+ resolveLegacyStateDirs: () => resolveLegacyStateDirs,
4915
+ resolveNewStateDir: () => resolveNewStateDir,
4916
+ resolveOAuthDir: () => resolveOAuthDir,
4917
+ resolveOAuthPath: () => resolveOAuthPath,
4918
+ resolveStateDir: () => resolveStateDir,
4919
+ setConfigOverride: () => setConfigOverride,
4920
+ unsetConfigOverride: () => unsetConfigOverride
4921
+ });
4922
+
4923
+ //#endregion
4924
+ 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, SynurexSchema as u, resetConfigOverrides as v, unsetConfigValueAtPath as w, getConfigValueAtPath as x, setConfigOverride as y };