clawdbot 2026.1.4-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 (550) hide show
  1. package/CHANGELOG.md +120 -0
  2. package/LICENSE +21 -0
  3. package/README-header.png +0 -0
  4. package/README.md +297 -0
  5. package/dist/agents/agent-paths.js +17 -0
  6. package/dist/agents/bash-process-registry.js +126 -0
  7. package/dist/agents/bash-tools.js +837 -0
  8. package/dist/agents/clawdbot-tools.js +30 -0
  9. package/dist/agents/clawdis-tools.js +27 -0
  10. package/dist/agents/context.js +34 -0
  11. package/dist/agents/defaults.js +6 -0
  12. package/dist/agents/model-auth.js +112 -0
  13. package/dist/agents/model-catalog.js +55 -0
  14. package/dist/agents/model-fallback.js +191 -0
  15. package/dist/agents/model-scan.js +263 -0
  16. package/dist/agents/model-selection.js +116 -0
  17. package/dist/agents/models-config.js +49 -0
  18. package/dist/agents/pi-embedded-helpers.js +74 -0
  19. package/dist/agents/pi-embedded-runner.js +407 -0
  20. package/dist/agents/pi-embedded-subscribe.js +568 -0
  21. package/dist/agents/pi-embedded-utils.js +20 -0
  22. package/dist/agents/pi-embedded.js +1 -0
  23. package/dist/agents/pi-oauth.js +88 -0
  24. package/dist/agents/pi-tools.js +433 -0
  25. package/dist/agents/sandbox-paths.js +68 -0
  26. package/dist/agents/sandbox.js +644 -0
  27. package/dist/agents/shell-utils.js +53 -0
  28. package/dist/agents/skills-install.js +244 -0
  29. package/dist/agents/skills-status.js +157 -0
  30. package/dist/agents/skills.js +470 -0
  31. package/dist/agents/steerable-agent-loop.js +338 -0
  32. package/dist/agents/steerable-provider-transport.js +48 -0
  33. package/dist/agents/system-prompt.js +104 -0
  34. package/dist/agents/tool-display.js +162 -0
  35. package/dist/agents/tool-images.js +138 -0
  36. package/dist/agents/tools/browser-tool.js +339 -0
  37. package/dist/agents/tools/canvas-tool.js +193 -0
  38. package/dist/agents/tools/common.js +88 -0
  39. package/dist/agents/tools/cron-tool.js +124 -0
  40. package/dist/agents/tools/discord-actions-guild.js +186 -0
  41. package/dist/agents/tools/discord-actions-messaging.js +285 -0
  42. package/dist/agents/tools/discord-actions-moderation.js +70 -0
  43. package/dist/agents/tools/discord-actions.js +56 -0
  44. package/dist/agents/tools/discord-schema.js +199 -0
  45. package/dist/agents/tools/discord-tool.js +16 -0
  46. package/dist/agents/tools/gateway-tool.js +46 -0
  47. package/dist/agents/tools/gateway.js +27 -0
  48. package/dist/agents/tools/image-tool.js +132 -0
  49. package/dist/agents/tools/nodes-tool.js +413 -0
  50. package/dist/agents/tools/nodes-utils.js +92 -0
  51. package/dist/agents/tools/sessions-helpers.js +88 -0
  52. package/dist/agents/tools/sessions-history-tool.js +53 -0
  53. package/dist/agents/tools/sessions-list-tool.js +143 -0
  54. package/dist/agents/tools/sessions-send-helpers.js +100 -0
  55. package/dist/agents/tools/sessions-send-tool.js +347 -0
  56. package/dist/agents/tools/slack-actions.js +129 -0
  57. package/dist/agents/tools/slack-schema.js +59 -0
  58. package/dist/agents/tools/slack-tool.js +16 -0
  59. package/dist/agents/usage.js +39 -0
  60. package/dist/agents/workspace.js +241 -0
  61. package/dist/auto-reply/chunk.js +76 -0
  62. package/dist/auto-reply/envelope.js +38 -0
  63. package/dist/auto-reply/group-activation.js +20 -0
  64. package/dist/auto-reply/heartbeat.js +57 -0
  65. package/dist/auto-reply/model.js +14 -0
  66. package/dist/auto-reply/reply/abort.js +14 -0
  67. package/dist/auto-reply/reply/agent-runner.js +371 -0
  68. package/dist/auto-reply/reply/block-streaming.js +34 -0
  69. package/dist/auto-reply/reply/body.js +29 -0
  70. package/dist/auto-reply/reply/commands.js +207 -0
  71. package/dist/auto-reply/reply/directive-handling.js +361 -0
  72. package/dist/auto-reply/reply/directives.js +47 -0
  73. package/dist/auto-reply/reply/followup-runner.js +149 -0
  74. package/dist/auto-reply/reply/groups.js +91 -0
  75. package/dist/auto-reply/reply/mentions.js +38 -0
  76. package/dist/auto-reply/reply/model-selection.js +114 -0
  77. package/dist/auto-reply/reply/queue.js +399 -0
  78. package/dist/auto-reply/reply/reply-tags.js +26 -0
  79. package/dist/auto-reply/reply/session-updates.js +87 -0
  80. package/dist/auto-reply/reply/session.js +160 -0
  81. package/dist/auto-reply/reply/typing.js +75 -0
  82. package/dist/auto-reply/reply.js +535 -0
  83. package/dist/auto-reply/send-policy.js +28 -0
  84. package/dist/auto-reply/status.js +158 -0
  85. package/dist/auto-reply/templating.js +9 -0
  86. package/dist/auto-reply/thinking.js +49 -0
  87. package/dist/auto-reply/tokens.js +2 -0
  88. package/dist/auto-reply/tool-meta.js +74 -0
  89. package/dist/auto-reply/transcription.js +57 -0
  90. package/dist/auto-reply/types.js +1 -0
  91. package/dist/browser/bridge-server.js +37 -0
  92. package/dist/browser/cdp.js +382 -0
  93. package/dist/browser/chrome.js +432 -0
  94. package/dist/browser/client-actions-core.js +67 -0
  95. package/dist/browser/client-actions-observe.js +24 -0
  96. package/dist/browser/client-actions-types.js +1 -0
  97. package/dist/browser/client-actions.js +3 -0
  98. package/dist/browser/client-fetch.js +43 -0
  99. package/dist/browser/client.js +105 -0
  100. package/dist/browser/config.js +140 -0
  101. package/dist/browser/constants.js +4 -0
  102. package/dist/browser/profiles-service.js +122 -0
  103. package/dist/browser/profiles.js +85 -0
  104. package/dist/browser/pw-ai.js +2 -0
  105. package/dist/browser/pw-session.js +144 -0
  106. package/dist/browser/pw-tools-core.js +363 -0
  107. package/dist/browser/routes/agent.js +535 -0
  108. package/dist/browser/routes/basic.js +155 -0
  109. package/dist/browser/routes/index.js +8 -0
  110. package/dist/browser/routes/tabs.js +105 -0
  111. package/dist/browser/routes/utils.js +62 -0
  112. package/dist/browser/screenshot.js +40 -0
  113. package/dist/browser/server-context.js +377 -0
  114. package/dist/browser/server.js +81 -0
  115. package/dist/browser/target-id.js +18 -0
  116. package/dist/browser/trash.js +21 -0
  117. package/dist/canvas-host/a2ui/.bundle.hash +1 -0
  118. package/dist/canvas-host/a2ui/a2ui.bundle.js +17768 -0
  119. package/dist/canvas-host/a2ui/index.html +246 -0
  120. package/dist/canvas-host/a2ui.js +187 -0
  121. package/dist/canvas-host/server.js +382 -0
  122. package/dist/cli/browser-cli-actions-input.js +459 -0
  123. package/dist/cli/browser-cli-actions-observe.js +56 -0
  124. package/dist/cli/browser-cli-examples.js +31 -0
  125. package/dist/cli/browser-cli-inspect.js +97 -0
  126. package/dist/cli/browser-cli-manage.js +286 -0
  127. package/dist/cli/browser-cli-shared.js +1 -0
  128. package/dist/cli/browser-cli.js +26 -0
  129. package/dist/cli/canvas-cli.js +416 -0
  130. package/dist/cli/cron-cli.js +454 -0
  131. package/dist/cli/deps.js +17 -0
  132. package/dist/cli/dns-cli.js +180 -0
  133. package/dist/cli/gateway-cli.js +489 -0
  134. package/dist/cli/gateway-rpc.js +20 -0
  135. package/dist/cli/hooks-cli.js +135 -0
  136. package/dist/cli/models-cli.js +248 -0
  137. package/dist/cli/nodes-camera.js +57 -0
  138. package/dist/cli/nodes-canvas.js +26 -0
  139. package/dist/cli/nodes-cli.js +946 -0
  140. package/dist/cli/nodes-screen.js +37 -0
  141. package/dist/cli/parse-duration.js +20 -0
  142. package/dist/cli/ports.js +97 -0
  143. package/dist/cli/program.js +406 -0
  144. package/dist/cli/prompt.js +19 -0
  145. package/dist/cli/tui-cli.js +35 -0
  146. package/dist/cli/wait.js +8 -0
  147. package/dist/commands/agent.js +645 -0
  148. package/dist/commands/antigravity-oauth.js +327 -0
  149. package/dist/commands/configure.js +480 -0
  150. package/dist/commands/doctor.js +484 -0
  151. package/dist/commands/health.js +108 -0
  152. package/dist/commands/models/aliases.js +64 -0
  153. package/dist/commands/models/fallbacks.js +99 -0
  154. package/dist/commands/models/image-fallbacks.js +99 -0
  155. package/dist/commands/models/list.js +323 -0
  156. package/dist/commands/models/scan.js +266 -0
  157. package/dist/commands/models/set-image.js +23 -0
  158. package/dist/commands/models/set.js +23 -0
  159. package/dist/commands/models/shared.js +72 -0
  160. package/dist/commands/models.js +7 -0
  161. package/dist/commands/onboard-auth.js +70 -0
  162. package/dist/commands/onboard-helpers.js +295 -0
  163. package/dist/commands/onboard-interactive.js +17 -0
  164. package/dist/commands/onboard-non-interactive.js +202 -0
  165. package/dist/commands/onboard-providers.js +634 -0
  166. package/dist/commands/onboard-remote.js +120 -0
  167. package/dist/commands/onboard-skills.js +148 -0
  168. package/dist/commands/onboard-types.js +1 -0
  169. package/dist/commands/onboard.js +12 -0
  170. package/dist/commands/send.js +124 -0
  171. package/dist/commands/sessions.js +212 -0
  172. package/dist/commands/setup.js +58 -0
  173. package/dist/commands/signal-install.js +135 -0
  174. package/dist/commands/status.js +207 -0
  175. package/dist/commands/update.js +16 -0
  176. package/dist/config/config.js +6 -0
  177. package/dist/config/defaults.js +61 -0
  178. package/dist/config/io.js +147 -0
  179. package/dist/config/legacy-migrate.js +13 -0
  180. package/dist/config/legacy.js +159 -0
  181. package/dist/config/paths.js +71 -0
  182. package/dist/config/schema.js +150 -0
  183. package/dist/config/sessions.js +282 -0
  184. package/dist/config/talk.js +31 -0
  185. package/dist/config/types.js +1 -0
  186. package/dist/config/validation.js +29 -0
  187. package/dist/config/zod-schema.js +831 -0
  188. package/dist/control-ui/assets/index-BFID3yAA.css +1 -0
  189. package/dist/control-ui/assets/index-CE_axlTS.js +2235 -0
  190. package/dist/control-ui/assets/index-CE_axlTS.js.map +1 -0
  191. package/dist/control-ui/index.html +15 -0
  192. package/dist/cron/isolated-agent.js +499 -0
  193. package/dist/cron/run-log.js +72 -0
  194. package/dist/cron/schedule.js +24 -0
  195. package/dist/cron/service.js +471 -0
  196. package/dist/cron/store.js +43 -0
  197. package/dist/cron/types.js +1 -0
  198. package/dist/daemon/constants.js +10 -0
  199. package/dist/daemon/launchd.js +276 -0
  200. package/dist/daemon/legacy.js +63 -0
  201. package/dist/daemon/program-args.js +76 -0
  202. package/dist/daemon/schtasks.js +257 -0
  203. package/dist/daemon/service.js +60 -0
  204. package/dist/daemon/systemd.js +266 -0
  205. package/dist/discord/index.js +2 -0
  206. package/dist/discord/monitor.js +1188 -0
  207. package/dist/discord/probe.js +54 -0
  208. package/dist/discord/send.js +577 -0
  209. package/dist/discord/token.js +8 -0
  210. package/dist/gateway/auth.js +121 -0
  211. package/dist/gateway/call.js +94 -0
  212. package/dist/gateway/chat-attachments.js +41 -0
  213. package/dist/gateway/client.js +180 -0
  214. package/dist/gateway/config-reload.js +274 -0
  215. package/dist/gateway/control-ui.js +184 -0
  216. package/dist/gateway/hooks-mapping.js +282 -0
  217. package/dist/gateway/hooks.js +168 -0
  218. package/dist/gateway/net.js +29 -0
  219. package/dist/gateway/protocol/index.js +61 -0
  220. package/dist/gateway/protocol/schema.js +560 -0
  221. package/dist/gateway/server-bridge-subscriptions.js +93 -0
  222. package/dist/gateway/server-bridge.js +1013 -0
  223. package/dist/gateway/server-browser.js +12 -0
  224. package/dist/gateway/server-chat.js +159 -0
  225. package/dist/gateway/server-constants.js +8 -0
  226. package/dist/gateway/server-discovery.js +62 -0
  227. package/dist/gateway/server-http.js +165 -0
  228. package/dist/gateway/server-methods/agent-job.js +125 -0
  229. package/dist/gateway/server-methods/agent.js +250 -0
  230. package/dist/gateway/server-methods/chat.js +200 -0
  231. package/dist/gateway/server-methods/config.js +50 -0
  232. package/dist/gateway/server-methods/connect.js +6 -0
  233. package/dist/gateway/server-methods/cron.js +83 -0
  234. package/dist/gateway/server-methods/health.js +28 -0
  235. package/dist/gateway/server-methods/models.js +16 -0
  236. package/dist/gateway/server-methods/nodes.js +294 -0
  237. package/dist/gateway/server-methods/providers.js +217 -0
  238. package/dist/gateway/server-methods/send.js +166 -0
  239. package/dist/gateway/server-methods/sessions.js +305 -0
  240. package/dist/gateway/server-methods/skills.js +83 -0
  241. package/dist/gateway/server-methods/system.js +118 -0
  242. package/dist/gateway/server-methods/talk.js +22 -0
  243. package/dist/gateway/server-methods/types.js +1 -0
  244. package/dist/gateway/server-methods/voicewake.js +30 -0
  245. package/dist/gateway/server-methods/web.js +58 -0
  246. package/dist/gateway/server-methods/wizard.js +100 -0
  247. package/dist/gateway/server-methods.js +53 -0
  248. package/dist/gateway/server-providers.js +644 -0
  249. package/dist/gateway/server-shared.js +1 -0
  250. package/dist/gateway/server-utils.js +35 -0
  251. package/dist/gateway/server.js +1437 -0
  252. package/dist/gateway/session-utils.js +216 -0
  253. package/dist/gateway/ws-log.js +349 -0
  254. package/dist/gateway/ws-logging.js +8 -0
  255. package/dist/globals.js +41 -0
  256. package/dist/hooks/gmail-ops.js +236 -0
  257. package/dist/hooks/gmail-setup-utils.js +278 -0
  258. package/dist/hooks/gmail-watcher.js +175 -0
  259. package/dist/hooks/gmail.js +177 -0
  260. package/dist/imessage/client.js +165 -0
  261. package/dist/imessage/index.js +3 -0
  262. package/dist/imessage/monitor.js +272 -0
  263. package/dist/imessage/probe.js +26 -0
  264. package/dist/imessage/send.js +83 -0
  265. package/dist/imessage/targets.js +176 -0
  266. package/dist/index.js +50 -0
  267. package/dist/infra/agent-events.js +46 -0
  268. package/dist/infra/binaries.js +9 -0
  269. package/dist/infra/bonjour-discovery.js +163 -0
  270. package/dist/infra/bonjour.js +200 -0
  271. package/dist/infra/bridge/server.js +562 -0
  272. package/dist/infra/canvas-host-url.js +54 -0
  273. package/dist/infra/env.js +8 -0
  274. package/dist/infra/errors.js +28 -0
  275. package/dist/infra/gateway-lock.js +8 -0
  276. package/dist/infra/heartbeat-events.js +21 -0
  277. package/dist/infra/heartbeat-runner.js +453 -0
  278. package/dist/infra/heartbeat-wake.js +61 -0
  279. package/dist/infra/is-main.js +37 -0
  280. package/dist/infra/machine-name.js +40 -0
  281. package/dist/infra/node-pairing.js +211 -0
  282. package/dist/infra/pam.js +42 -0
  283. package/dist/infra/path-env.js +92 -0
  284. package/dist/infra/ports.js +87 -0
  285. package/dist/infra/provider-summary.js +80 -0
  286. package/dist/infra/restart.js +29 -0
  287. package/dist/infra/retry.js +16 -0
  288. package/dist/infra/runtime-guard.js +59 -0
  289. package/dist/infra/system-events.js +44 -0
  290. package/dist/infra/system-presence.js +216 -0
  291. package/dist/infra/tailnet.js +46 -0
  292. package/dist/infra/tailscale.js +149 -0
  293. package/dist/infra/voicewake.js +77 -0
  294. package/dist/infra/widearea-dns.js +123 -0
  295. package/dist/infra/ws.js +13 -0
  296. package/dist/logger.js +52 -0
  297. package/dist/logging.js +490 -0
  298. package/dist/macos/gateway-daemon.js +141 -0
  299. package/dist/macos/relay.js +46 -0
  300. package/dist/media/constants.js +33 -0
  301. package/dist/media/host.js +42 -0
  302. package/dist/media/image-ops.js +121 -0
  303. package/dist/media/mime.js +115 -0
  304. package/dist/media/parse.js +81 -0
  305. package/dist/media/server.js +64 -0
  306. package/dist/media/store.js +139 -0
  307. package/dist/process/command-queue.js +97 -0
  308. package/dist/process/exec.js +75 -0
  309. package/dist/protocol.schema.json +2918 -0
  310. package/dist/provider-web.js +8 -0
  311. package/dist/providers/web/index.js +2 -0
  312. package/dist/runtime.js +8 -0
  313. package/dist/sessions/send-policy.js +68 -0
  314. package/dist/signal/client.js +134 -0
  315. package/dist/signal/daemon.js +69 -0
  316. package/dist/signal/index.js +3 -0
  317. package/dist/signal/monitor.js +336 -0
  318. package/dist/signal/probe.js +46 -0
  319. package/dist/signal/send.js +91 -0
  320. package/dist/slack/actions.js +97 -0
  321. package/dist/slack/index.js +5 -0
  322. package/dist/slack/monitor.js +1029 -0
  323. package/dist/slack/probe.js +47 -0
  324. package/dist/slack/send.js +131 -0
  325. package/dist/slack/token.js +10 -0
  326. package/dist/telegram/bot.js +394 -0
  327. package/dist/telegram/download.js +34 -0
  328. package/dist/telegram/index.js +4 -0
  329. package/dist/telegram/monitor.js +47 -0
  330. package/dist/telegram/probe.js +63 -0
  331. package/dist/telegram/proxy.js +9 -0
  332. package/dist/telegram/send.js +138 -0
  333. package/dist/telegram/token.js +30 -0
  334. package/dist/telegram/webhook-set.js +12 -0
  335. package/dist/telegram/webhook.js +56 -0
  336. package/dist/tui/commands.js +74 -0
  337. package/dist/tui/components/assistant-message.js +16 -0
  338. package/dist/tui/components/chat-log.js +92 -0
  339. package/dist/tui/components/custom-editor.js +53 -0
  340. package/dist/tui/components/selectors.js +8 -0
  341. package/dist/tui/components/tool-execution.js +111 -0
  342. package/dist/tui/components/user-message.js +17 -0
  343. package/dist/tui/gateway-chat.js +140 -0
  344. package/dist/tui/layout.js +41 -0
  345. package/dist/tui/message-list.js +57 -0
  346. package/dist/tui/theme/theme.js +80 -0
  347. package/dist/tui/theme.js +25 -0
  348. package/dist/tui/tui.js +708 -0
  349. package/dist/utils.js +133 -0
  350. package/dist/version.js +18 -0
  351. package/dist/web/active-listener.js +7 -0
  352. package/dist/web/auto-reply.js +1203 -0
  353. package/dist/web/inbound.js +481 -0
  354. package/dist/web/login-qr.js +204 -0
  355. package/dist/web/login.js +59 -0
  356. package/dist/web/media.js +148 -0
  357. package/dist/web/outbound.js +67 -0
  358. package/dist/web/qr-image.js +97 -0
  359. package/dist/web/reconnect.js +60 -0
  360. package/dist/web/reply-heartbeat-wake.js +61 -0
  361. package/dist/web/session.js +346 -0
  362. package/dist/wizard/clack-prompter.js +56 -0
  363. package/dist/wizard/onboarding.js +452 -0
  364. package/dist/wizard/prompts.js +6 -0
  365. package/dist/wizard/session.js +203 -0
  366. package/docs/AGENTS.default.md +116 -0
  367. package/docs/CNAME +1 -0
  368. package/docs/RELEASING.md +64 -0
  369. package/docs/_config.yml +51 -0
  370. package/docs/_layouts/default.html +145 -0
  371. package/docs/agent-send.md +21 -0
  372. package/docs/agent.md +104 -0
  373. package/docs/android/connect.md +131 -0
  374. package/docs/architecture.md +89 -0
  375. package/docs/assets/markdown.css +130 -0
  376. package/docs/assets/pixel-lobster.svg +60 -0
  377. package/docs/assets/terminal.css +497 -0
  378. package/docs/assets/theme.js +55 -0
  379. package/docs/audio.md +50 -0
  380. package/docs/background-process.md +74 -0
  381. package/docs/bash.md +32 -0
  382. package/docs/bonjour.md +159 -0
  383. package/docs/browser.md +289 -0
  384. package/docs/camera.md +152 -0
  385. package/docs/clawd.md +199 -0
  386. package/docs/clawdbot-mac.md +104 -0
  387. package/docs/configuration.md +1177 -0
  388. package/docs/control-api.md +49 -0
  389. package/docs/control-ui.md +83 -0
  390. package/docs/cron.md +374 -0
  391. package/docs/dashboard.md +17 -0
  392. package/docs/device-models.md +46 -0
  393. package/docs/discord.md +293 -0
  394. package/docs/discovery.md +112 -0
  395. package/docs/docker.md +251 -0
  396. package/docs/docs.json +86 -0
  397. package/docs/doctor.md +47 -0
  398. package/docs/elevated.md +31 -0
  399. package/docs/faq.md +640 -0
  400. package/docs/gateway/pairing.md +109 -0
  401. package/docs/gateway-lock.md +28 -0
  402. package/docs/gateway.md +174 -0
  403. package/docs/gmail-pubsub.md +191 -0
  404. package/docs/grammy.md +27 -0
  405. package/docs/group-messages.md +71 -0
  406. package/docs/groups.md +78 -0
  407. package/docs/health.md +28 -0
  408. package/docs/heartbeat.md +64 -0
  409. package/docs/images.md +52 -0
  410. package/docs/imessage.md +63 -0
  411. package/docs/index.md +182 -0
  412. package/docs/ios/connect.md +177 -0
  413. package/docs/ios/spec.md +236 -0
  414. package/docs/location-command.md +95 -0
  415. package/docs/logging.md +99 -0
  416. package/docs/lore.md +131 -0
  417. package/docs/mac/bun.md +133 -0
  418. package/docs/mac/canvas.md +161 -0
  419. package/docs/mac/child-process.md +72 -0
  420. package/docs/mac/dev-setup.md +81 -0
  421. package/docs/mac/health.md +28 -0
  422. package/docs/mac/icon.md +26 -0
  423. package/docs/mac/logging.md +51 -0
  424. package/docs/mac/menu-bar.md +69 -0
  425. package/docs/mac/peekaboo.md +170 -0
  426. package/docs/mac/permissions.md +40 -0
  427. package/docs/mac/release.md +76 -0
  428. package/docs/mac/remote.md +57 -0
  429. package/docs/mac/signing.md +41 -0
  430. package/docs/mac/skills.md +27 -0
  431. package/docs/mac/voice-overlay.md +52 -0
  432. package/docs/mac/voicewake.md +56 -0
  433. package/docs/mac/webchat.md +27 -0
  434. package/docs/mac/xpc.md +40 -0
  435. package/docs/models.md +90 -0
  436. package/docs/nix.md +49 -0
  437. package/docs/nodes.md +157 -0
  438. package/docs/onboarding-config-protocol.md +29 -0
  439. package/docs/onboarding.md +185 -0
  440. package/docs/presence.md +133 -0
  441. package/docs/queue.md +78 -0
  442. package/docs/refactor/browser-control-simplification.md +58 -0
  443. package/docs/refactor/canvas-a2ui.md +93 -0
  444. package/docs/refactor/cli-unification.md +64 -0
  445. package/docs/refactor/gateway-client.md +31 -0
  446. package/docs/refactor/gateway.md +99 -0
  447. package/docs/refactor/new-arch.md +171 -0
  448. package/docs/refactor/tui.md +26 -0
  449. package/docs/refactor/web-gateway-troubleshooting.md +37 -0
  450. package/docs/refactor/webagent-session.md +46 -0
  451. package/docs/remote-gateway-readme.md +148 -0
  452. package/docs/remote.md +66 -0
  453. package/docs/research/memory.md +227 -0
  454. package/docs/rpc.md +35 -0
  455. package/docs/security.md +168 -0
  456. package/docs/session-tool.md +119 -0
  457. package/docs/session.md +84 -0
  458. package/docs/sessions.md +8 -0
  459. package/docs/setup.md +118 -0
  460. package/docs/signal.md +113 -0
  461. package/docs/skills-config.md +58 -0
  462. package/docs/skills.md +149 -0
  463. package/docs/slack.md +158 -0
  464. package/docs/surface.md +20 -0
  465. package/docs/tailscale.md +71 -0
  466. package/docs/talk.md +79 -0
  467. package/docs/telegram.md +90 -0
  468. package/docs/templates/AGENTS.md +126 -0
  469. package/docs/templates/BOOTSTRAP.md +53 -0
  470. package/docs/templates/IDENTITY.md +17 -0
  471. package/docs/templates/SOUL.md +41 -0
  472. package/docs/templates/TOOLS.md +41 -0
  473. package/docs/templates/USER.md +22 -0
  474. package/docs/test.md +35 -0
  475. package/docs/thinking.md +46 -0
  476. package/docs/tools.md +248 -0
  477. package/docs/troubleshooting.md +227 -0
  478. package/docs/tui.md +69 -0
  479. package/docs/typebox.md +42 -0
  480. package/docs/voicewake.md +61 -0
  481. package/docs/web.md +115 -0
  482. package/docs/webchat.md +34 -0
  483. package/docs/webhook.md +132 -0
  484. package/docs/whatsapp-clawd.jpg +0 -0
  485. package/docs/whatsapp.md +142 -0
  486. package/docs/wizard.md +158 -0
  487. package/package.json +186 -0
  488. package/skills/apple-notes/SKILL.md +50 -0
  489. package/skills/apple-reminders/SKILL.md +67 -0
  490. package/skills/bear-notes/SKILL.md +79 -0
  491. package/skills/bird/SKILL.md +25 -0
  492. package/skills/blogwatcher/SKILL.md +46 -0
  493. package/skills/blucli/SKILL.md +27 -0
  494. package/skills/brave-search/SKILL.md +30 -0
  495. package/skills/brave-search/scripts/content.mjs +53 -0
  496. package/skills/brave-search/scripts/search.mjs +79 -0
  497. package/skills/camsnap/SKILL.md +25 -0
  498. package/skills/clawdhub/SKILL.md +53 -0
  499. package/skills/coding-agent/SKILL.md +275 -0
  500. package/skills/discord/SKILL.md +369 -0
  501. package/skills/eightctl/SKILL.md +29 -0
  502. package/skills/food-order/SKILL.md +41 -0
  503. package/skills/gemini/SKILL.md +23 -0
  504. package/skills/gifgrep/SKILL.md +47 -0
  505. package/skills/github/SKILL.md +47 -0
  506. package/skills/gog/SKILL.md +36 -0
  507. package/skills/goplaces/SKILL.md +30 -0
  508. package/skills/imsg/SKILL.md +25 -0
  509. package/skills/local-places/SERVER_README.md +101 -0
  510. package/skills/local-places/SKILL.md +91 -0
  511. package/skills/local-places/pyproject.toml +27 -0
  512. package/skills/local-places/src/local_places/__init__.py +2 -0
  513. package/skills/local-places/src/local_places/__pycache__/__init__.cpython-314.pyc +0 -0
  514. package/skills/local-places/src/local_places/__pycache__/google_places.cpython-314.pyc +0 -0
  515. package/skills/local-places/src/local_places/__pycache__/main.cpython-314.pyc +0 -0
  516. package/skills/local-places/src/local_places/__pycache__/schemas.cpython-314.pyc +0 -0
  517. package/skills/local-places/src/local_places/google_places.py +314 -0
  518. package/skills/local-places/src/local_places/main.py +65 -0
  519. package/skills/local-places/src/local_places/schemas.py +107 -0
  520. package/skills/mcporter/SKILL.md +38 -0
  521. package/skills/nano-banana-pro/SKILL.md +29 -0
  522. package/skills/nano-banana-pro/scripts/generate_image.py +167 -0
  523. package/skills/nano-pdf/SKILL.md +20 -0
  524. package/skills/notion/SKILL.md +156 -0
  525. package/skills/obsidian/SKILL.md +55 -0
  526. package/skills/openai-image-gen/SKILL.md +31 -0
  527. package/skills/openai-image-gen/scripts/gen.py +173 -0
  528. package/skills/openai-whisper/SKILL.md +19 -0
  529. package/skills/openai-whisper-api/SKILL.md +43 -0
  530. package/skills/openai-whisper-api/scripts/transcribe.sh +85 -0
  531. package/skills/openhue/SKILL.md +30 -0
  532. package/skills/oracle/SKILL.md +105 -0
  533. package/skills/ordercli/SKILL.md +47 -0
  534. package/skills/peekaboo/SKILL.md +153 -0
  535. package/skills/qmd/SKILL.md +26 -0
  536. package/skills/sag/SKILL.md +62 -0
  537. package/skills/slack/SKILL.md +143 -0
  538. package/skills/songsee/SKILL.md +29 -0
  539. package/skills/sonoscli/SKILL.md +26 -0
  540. package/skills/spotify-player/SKILL.md +34 -0
  541. package/skills/summarize/SKILL.md +49 -0
  542. package/skills/things-mac/SKILL.md +61 -0
  543. package/skills/tmux/SKILL.md +121 -0
  544. package/skills/tmux/scripts/find-sessions.sh +112 -0
  545. package/skills/tmux/scripts/wait-for-text.sh +83 -0
  546. package/skills/trello/SKILL.md +84 -0
  547. package/skills/video-frames/SKILL.md +29 -0
  548. package/skills/video-frames/scripts/frame.sh +81 -0
  549. package/skills/wacli/SKILL.md +42 -0
  550. package/skills/weather/SKILL.md +49 -0
package/dist/control-ui/index.html ADDED
@@ -0,0 +1,15 @@
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
+ <title>Clawdbot Control</title>
7
+ <meta name="color-scheme" content="dark light" />
8
+ <script type="module" crossorigin src="/assets/index-CE_axlTS.js"></script>
9
+ <link rel="stylesheet" crossorigin href="/assets/index-BFID3yAA.css">
10
+ </head>
11
+ <body>
12
+ <clawdbot-app></clawdbot-app>
13
+ </body>
14
+ </html>
15
+
package/dist/cron/isolated-agent.js ADDED
@@ -0,0 +1,499 @@
1
+ import crypto from "node:crypto";
2
+ import { lookupContextTokens } from "../agents/context.js";
3
+ import { DEFAULT_CONTEXT_TOKENS, DEFAULT_MODEL, DEFAULT_PROVIDER, } from "../agents/defaults.js";
4
+ import { loadModelCatalog } from "../agents/model-catalog.js";
5
+ import { runWithModelFallback } from "../agents/model-fallback.js";
6
+ import { resolveConfiguredModelRef, resolveThinkingDefault, } from "../agents/model-selection.js";
7
+ import { runEmbeddedPiAgent } from "../agents/pi-embedded.js";
8
+ import { buildWorkspaceSkillSnapshot } from "../agents/skills.js";
9
+ import { DEFAULT_AGENT_WORKSPACE_DIR, ensureAgentWorkspace, } from "../agents/workspace.js";
10
+ import { chunkText, resolveTextChunkLimit } from "../auto-reply/chunk.js";
11
+ import { normalizeThinkLevel } from "../auto-reply/thinking.js";
12
+ import { DEFAULT_IDLE_MINUTES, loadSessionStore, resolveSessionTranscriptPath, resolveStorePath, saveSessionStore, } from "../config/sessions.js";
13
+ import { registerAgentRunContext } from "../infra/agent-events.js";
14
+ import { resolveTelegramToken } from "../telegram/token.js";
15
+ import { normalizeE164 } from "../utils.js";
16
+ function pickSummaryFromOutput(text) {
17
+ const clean = (text ?? "").trim();
18
+ if (!clean)
19
+ return undefined;
20
+ const limit = 2000;
21
+ return clean.length > limit ? `${clean.slice(0, limit)}…` : clean;
22
+ }
23
+ function pickSummaryFromPayloads(payloads) {
24
+ for (let i = payloads.length - 1; i >= 0; i--) {
25
+ const summary = pickSummaryFromOutput(payloads[i]?.text);
26
+ if (summary)
27
+ return summary;
28
+ }
29
+ return undefined;
30
+ }
31
+ function resolveDeliveryTarget(cfg, jobPayload) {
32
+ const requestedChannel = typeof jobPayload.channel === "string" ? jobPayload.channel : "last";
33
+ const explicitTo = typeof jobPayload.to === "string" && jobPayload.to.trim()
34
+ ? jobPayload.to.trim()
35
+ : undefined;
36
+ const sessionCfg = cfg.session;
37
+ const mainKey = (sessionCfg?.mainKey ?? "main").trim() || "main";
38
+ const storePath = resolveStorePath(sessionCfg?.store);
39
+ const store = loadSessionStore(storePath);
40
+ const main = store[mainKey];
41
+ const lastChannel = main?.lastChannel && main.lastChannel !== "webchat"
42
+ ? main.lastChannel
43
+ : undefined;
44
+ const lastTo = typeof main?.lastTo === "string" ? main.lastTo.trim() : "";
45
+ const channel = (() => {
46
+ if (requestedChannel === "whatsapp" ||
47
+ requestedChannel === "telegram" ||
48
+ requestedChannel === "discord" ||
49
+ requestedChannel === "slack" ||
50
+ requestedChannel === "signal" ||
51
+ requestedChannel === "imessage") {
52
+ return requestedChannel;
53
+ }
54
+ return lastChannel ?? "whatsapp";
55
+ })();
56
+ const to = (() => {
57
+ if (explicitTo)
58
+ return explicitTo;
59
+ return lastTo || undefined;
60
+ })();
61
+ const sanitizedWhatsappTo = (() => {
62
+ if (channel !== "whatsapp")
63
+ return to;
64
+ const rawAllow = cfg.whatsapp?.allowFrom ?? [];
65
+ if (rawAllow.includes("*"))
66
+ return to;
67
+ const allowFrom = rawAllow
68
+ .map((val) => normalizeE164(val))
69
+ .filter((val) => val.length > 1);
70
+ if (allowFrom.length === 0)
71
+ return to;
72
+ if (!to)
73
+ return allowFrom[0];
74
+ const normalized = normalizeE164(to);
75
+ if (allowFrom.includes(normalized))
76
+ return normalized;
77
+ return allowFrom[0];
78
+ })();
79
+ return {
80
+ channel,
81
+ to: channel === "whatsapp" ? sanitizedWhatsappTo : to,
82
+ };
83
+ }
84
+ function resolveCronSession(params) {
85
+ const sessionCfg = params.cfg.session;
86
+ const idleMinutes = Math.max(sessionCfg?.idleMinutes ?? DEFAULT_IDLE_MINUTES, 1);
87
+ const idleMs = idleMinutes * 60_000;
88
+ const storePath = resolveStorePath(sessionCfg?.store);
89
+ const store = loadSessionStore(storePath);
90
+ const entry = store[params.sessionKey];
91
+ const fresh = entry && params.nowMs - entry.updatedAt <= idleMs;
92
+ const sessionId = fresh ? entry.sessionId : crypto.randomUUID();
93
+ const systemSent = fresh ? Boolean(entry.systemSent) : false;
94
+ const sessionEntry = {
95
+ sessionId,
96
+ updatedAt: params.nowMs,
97
+ systemSent,
98
+ thinkingLevel: entry?.thinkingLevel,
99
+ verboseLevel: entry?.verboseLevel,
100
+ model: entry?.model,
101
+ contextTokens: entry?.contextTokens,
102
+ sendPolicy: entry?.sendPolicy,
103
+ lastChannel: entry?.lastChannel,
104
+ lastTo: entry?.lastTo,
105
+ };
106
+ return { storePath, store, sessionEntry, systemSent, isNewSession: !fresh };
107
+ }
108
+ export async function runCronIsolatedAgentTurn(params) {
109
+ const agentCfg = params.cfg.agent;
110
+ const workspaceDirRaw = params.cfg.agent?.workspace ?? DEFAULT_AGENT_WORKSPACE_DIR;
111
+ const workspace = await ensureAgentWorkspace({
112
+ dir: workspaceDirRaw,
113
+ ensureBootstrapFiles: true,
114
+ });
115
+ const workspaceDir = workspace.dir;
116
+ const { provider, model } = resolveConfiguredModelRef({
117
+ cfg: params.cfg,
118
+ defaultProvider: DEFAULT_PROVIDER,
119
+ defaultModel: DEFAULT_MODEL,
120
+ });
121
+ const now = Date.now();
122
+ const cronSession = resolveCronSession({
123
+ cfg: params.cfg,
124
+ sessionKey: params.sessionKey,
125
+ nowMs: now,
126
+ });
127
+ const isFirstTurnInSession = cronSession.isNewSession || !cronSession.systemSent;
128
+ const thinkOverride = normalizeThinkLevel(agentCfg?.thinkingDefault);
129
+ const jobThink = normalizeThinkLevel((params.job.payload.kind === "agentTurn"
130
+ ? params.job.payload.thinking
131
+ : undefined) ?? undefined);
132
+ let thinkLevel = jobThink ?? thinkOverride;
133
+ if (!thinkLevel) {
134
+ const catalog = await loadModelCatalog({ config: params.cfg });
135
+ thinkLevel = resolveThinkingDefault({
136
+ cfg: params.cfg,
137
+ provider,
138
+ model,
139
+ catalog,
140
+ });
141
+ }
142
+ const timeoutSecondsRaw = params.job.payload.kind === "agentTurn" && params.job.payload.timeoutSeconds
143
+ ? params.job.payload.timeoutSeconds
144
+ : (agentCfg?.timeoutSeconds ?? 600);
145
+ const timeoutSeconds = Math.max(Math.floor(timeoutSecondsRaw), 1);
146
+ const timeoutMs = timeoutSeconds * 1000;
147
+ const delivery = params.job.payload.kind === "agentTurn" &&
148
+ params.job.payload.deliver === true;
149
+ const bestEffortDeliver = params.job.payload.kind === "agentTurn" &&
150
+ params.job.payload.bestEffortDeliver === true;
151
+ const resolvedDelivery = resolveDeliveryTarget(params.cfg, {
152
+ channel: params.job.payload.kind === "agentTurn"
153
+ ? params.job.payload.channel
154
+ : "last",
155
+ to: params.job.payload.kind === "agentTurn"
156
+ ? params.job.payload.to
157
+ : undefined,
158
+ });
159
+ const { token: telegramToken } = resolveTelegramToken(params.cfg);
160
+ const base = `[cron:${params.job.id} ${params.job.name}] ${params.message}`.trim();
161
+ const commandBody = base;
162
+ const needsSkillsSnapshot = cronSession.isNewSession || !cronSession.sessionEntry.skillsSnapshot;
163
+ const skillsSnapshot = needsSkillsSnapshot
164
+ ? buildWorkspaceSkillSnapshot(workspaceDir, { config: params.cfg })
165
+ : cronSession.sessionEntry.skillsSnapshot;
166
+ if (needsSkillsSnapshot && skillsSnapshot) {
167
+ cronSession.sessionEntry = {
168
+ ...cronSession.sessionEntry,
169
+ updatedAt: Date.now(),
170
+ skillsSnapshot,
171
+ };
172
+ cronSession.store[params.sessionKey] = cronSession.sessionEntry;
173
+ await saveSessionStore(cronSession.storePath, cronSession.store);
174
+ }
175
+ // Persist systemSent before the run, mirroring the inbound auto-reply behavior.
176
+ if (isFirstTurnInSession) {
177
+ cronSession.sessionEntry.systemSent = true;
178
+ cronSession.store[params.sessionKey] = cronSession.sessionEntry;
179
+ await saveSessionStore(cronSession.storePath, cronSession.store);
180
+ }
181
+ else {
182
+ cronSession.store[params.sessionKey] = cronSession.sessionEntry;
183
+ await saveSessionStore(cronSession.storePath, cronSession.store);
184
+ }
185
+ let runResult;
186
+ let fallbackProvider = provider;
187
+ let fallbackModel = model;
188
+ try {
189
+ const sessionFile = resolveSessionTranscriptPath(cronSession.sessionEntry.sessionId);
190
+ registerAgentRunContext(cronSession.sessionEntry.sessionId, {
191
+ sessionKey: params.sessionKey,
192
+ });
193
+ const surface = resolvedDelivery.channel;
194
+ const fallbackResult = await runWithModelFallback({
195
+ cfg: params.cfg,
196
+ provider,
197
+ model,
198
+ run: (providerOverride, modelOverride) => runEmbeddedPiAgent({
199
+ sessionId: cronSession.sessionEntry.sessionId,
200
+ sessionKey: params.sessionKey,
201
+ surface,
202
+ sessionFile,
203
+ workspaceDir,
204
+ config: params.cfg,
205
+ skillsSnapshot,
206
+ prompt: commandBody,
207
+ lane: params.lane ?? "cron",
208
+ provider: providerOverride,
209
+ model: modelOverride,
210
+ thinkLevel,
211
+ verboseLevel: cronSession.sessionEntry.verboseLevel ??
212
+ agentCfg?.verboseDefault,
213
+ timeoutMs,
214
+ runId: cronSession.sessionEntry.sessionId,
215
+ }),
216
+ });
217
+ runResult = fallbackResult.result;
218
+ fallbackProvider = fallbackResult.provider;
219
+ fallbackModel = fallbackResult.model;
220
+ }
221
+ catch (err) {
222
+ return { status: "error", error: String(err) };
223
+ }
224
+ const payloads = runResult.payloads ?? [];
225
+ // Update token+model fields in the session store.
226
+ {
227
+ const usage = runResult.meta.agentMeta?.usage;
228
+ const modelUsed = runResult.meta.agentMeta?.model ?? fallbackModel ?? model;
229
+ const providerUsed = runResult.meta.agentMeta?.provider ?? fallbackProvider ?? provider;
230
+ const contextTokens = agentCfg?.contextTokens ??
231
+ lookupContextTokens(modelUsed) ??
232
+ DEFAULT_CONTEXT_TOKENS;
233
+ cronSession.sessionEntry.modelProvider = providerUsed;
234
+ cronSession.sessionEntry.model = modelUsed;
235
+ cronSession.sessionEntry.contextTokens = contextTokens;
236
+ if (usage) {
237
+ const input = usage.input ?? 0;
238
+ const output = usage.output ?? 0;
239
+ const promptTokens = input + (usage.cacheRead ?? 0) + (usage.cacheWrite ?? 0);
240
+ cronSession.sessionEntry.inputTokens = input;
241
+ cronSession.sessionEntry.outputTokens = output;
242
+ cronSession.sessionEntry.totalTokens =
243
+ promptTokens > 0 ? promptTokens : (usage.total ?? input);
244
+ }
245
+ cronSession.store[params.sessionKey] = cronSession.sessionEntry;
246
+ await saveSessionStore(cronSession.storePath, cronSession.store);
247
+ }
248
+ const firstText = payloads[0]?.text ?? "";
249
+ const summary = pickSummaryFromPayloads(payloads) ?? pickSummaryFromOutput(firstText);
250
+ if (delivery) {
251
+ if (resolvedDelivery.channel === "whatsapp") {
252
+ if (!resolvedDelivery.to) {
253
+ if (!bestEffortDeliver)
254
+ return {
255
+ status: "error",
256
+ summary,
257
+ error: "Cron delivery to WhatsApp requires a recipient.",
258
+ };
259
+ return {
260
+ status: "skipped",
261
+ summary: "Delivery skipped (no WhatsApp recipient).",
262
+ };
263
+ }
264
+ const to = normalizeE164(resolvedDelivery.to);
265
+ try {
266
+ for (const payload of payloads) {
267
+ const mediaList = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []);
268
+ const primaryMedia = mediaList[0];
269
+ await params.deps.sendMessageWhatsApp(to, payload.text ?? "", {
270
+ verbose: false,
271
+ mediaUrl: primaryMedia,
272
+ });
273
+ for (const extra of mediaList.slice(1)) {
274
+ await params.deps.sendMessageWhatsApp(to, "", {
275
+ verbose: false,
276
+ mediaUrl: extra,
277
+ });
278
+ }
279
+ }
280
+ }
281
+ catch (err) {
282
+ if (!bestEffortDeliver)
283
+ return { status: "error", summary, error: String(err) };
284
+ return { status: "ok", summary };
285
+ }
286
+ }
287
+ else if (resolvedDelivery.channel === "telegram") {
288
+ if (!resolvedDelivery.to) {
289
+ if (!bestEffortDeliver)
290
+ return {
291
+ status: "error",
292
+ summary,
293
+ error: "Cron delivery to Telegram requires a chatId.",
294
+ };
295
+ return {
296
+ status: "skipped",
297
+ summary: "Delivery skipped (no Telegram chatId).",
298
+ };
299
+ }
300
+ const chatId = resolvedDelivery.to;
301
+ const textLimit = resolveTextChunkLimit(params.cfg, "telegram");
302
+ try {
303
+ for (const payload of payloads) {
304
+ const mediaList = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []);
305
+ if (mediaList.length === 0) {
306
+ for (const chunk of chunkText(payload.text ?? "", textLimit)) {
307
+ await params.deps.sendMessageTelegram(chatId, chunk, {
308
+ verbose: false,
309
+ token: telegramToken || undefined,
310
+ });
311
+ }
312
+ }
313
+ else {
314
+ let first = true;
315
+ for (const url of mediaList) {
316
+ const caption = first ? (payload.text ?? "") : "";
317
+ first = false;
318
+ await params.deps.sendMessageTelegram(chatId, caption, {
319
+ verbose: false,
320
+ mediaUrl: url,
321
+ token: telegramToken || undefined,
322
+ });
323
+ }
324
+ }
325
+ }
326
+ }
327
+ catch (err) {
328
+ if (!bestEffortDeliver)
329
+ return { status: "error", summary, error: String(err) };
330
+ return { status: "ok", summary };
331
+ }
332
+ }
333
+ else if (resolvedDelivery.channel === "discord") {
334
+ if (!resolvedDelivery.to) {
335
+ if (!bestEffortDeliver)
336
+ return {
337
+ status: "error",
338
+ summary,
339
+ error: "Cron delivery to Discord requires --channel discord and --to <channelId|user:ID>",
340
+ };
341
+ return {
342
+ status: "skipped",
343
+ summary: "Delivery skipped (no Discord destination).",
344
+ };
345
+ }
346
+ const discordTarget = resolvedDelivery.to;
347
+ try {
348
+ for (const payload of payloads) {
349
+ const mediaList = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []);
350
+ if (mediaList.length === 0) {
351
+ await params.deps.sendMessageDiscord(discordTarget, payload.text ?? "", {
352
+ token: process.env.DISCORD_BOT_TOKEN,
353
+ });
354
+ }
355
+ else {
356
+ let first = true;
357
+ for (const url of mediaList) {
358
+ const caption = first ? (payload.text ?? "") : "";
359
+ first = false;
360
+ await params.deps.sendMessageDiscord(discordTarget, caption, {
361
+ token: process.env.DISCORD_BOT_TOKEN,
362
+ mediaUrl: url,
363
+ });
364
+ }
365
+ }
366
+ }
367
+ }
368
+ catch (err) {
369
+ if (!bestEffortDeliver)
370
+ return { status: "error", summary, error: String(err) };
371
+ return { status: "ok", summary };
372
+ }
373
+ }
374
+ else if (resolvedDelivery.channel === "slack") {
375
+ if (!resolvedDelivery.to) {
376
+ if (!bestEffortDeliver)
377
+ return {
378
+ status: "error",
379
+ summary,
380
+ error: "Cron delivery to Slack requires --channel slack and --to <channelId|user:ID>",
381
+ };
382
+ return {
383
+ status: "skipped",
384
+ summary: "Delivery skipped (no Slack destination).",
385
+ };
386
+ }
387
+ const slackTarget = resolvedDelivery.to;
388
+ const textLimit = resolveTextChunkLimit(params.cfg, "slack");
389
+ try {
390
+ for (const payload of payloads) {
391
+ const mediaList = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []);
392
+ if (mediaList.length === 0) {
393
+ for (const chunk of chunkText(payload.text ?? "", textLimit)) {
394
+ await params.deps.sendMessageSlack(slackTarget, chunk);
395
+ }
396
+ }
397
+ else {
398
+ let first = true;
399
+ for (const url of mediaList) {
400
+ const caption = first ? (payload.text ?? "") : "";
401
+ first = false;
402
+ await params.deps.sendMessageSlack(slackTarget, caption, {
403
+ mediaUrl: url,
404
+ });
405
+ }
406
+ }
407
+ }
408
+ }
409
+ catch (err) {
410
+ if (!bestEffortDeliver)
411
+ return { status: "error", summary, error: String(err) };
412
+ return { status: "ok", summary };
413
+ }
414
+ }
415
+ else if (resolvedDelivery.channel === "signal") {
416
+ if (!resolvedDelivery.to) {
417
+ if (!bestEffortDeliver)
418
+ return {
419
+ status: "error",
420
+ summary,
421
+ error: "Cron delivery to Signal requires a recipient.",
422
+ };
423
+ return {
424
+ status: "skipped",
425
+ summary: "Delivery skipped (no Signal recipient).",
426
+ };
427
+ }
428
+ const to = resolvedDelivery.to;
429
+ const textLimit = resolveTextChunkLimit(params.cfg, "signal");
430
+ try {
431
+ for (const payload of payloads) {
432
+ const mediaList = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []);
433
+ if (mediaList.length === 0) {
434
+ for (const chunk of chunkText(payload.text ?? "", textLimit)) {
435
+ await params.deps.sendMessageSignal(to, chunk);
436
+ }
437
+ }
438
+ else {
439
+ let first = true;
440
+ for (const url of mediaList) {
441
+ const caption = first ? (payload.text ?? "") : "";
442
+ first = false;
443
+ await params.deps.sendMessageSignal(to, caption, {
444
+ mediaUrl: url,
445
+ });
446
+ }
447
+ }
448
+ }
449
+ }
450
+ catch (err) {
451
+ if (!bestEffortDeliver)
452
+ return { status: "error", summary, error: String(err) };
453
+ return { status: "ok", summary };
454
+ }
455
+ }
456
+ else if (resolvedDelivery.channel === "imessage") {
457
+ if (!resolvedDelivery.to) {
458
+ if (!bestEffortDeliver)
459
+ return {
460
+ status: "error",
461
+ summary,
462
+ error: "Cron delivery to iMessage requires a recipient.",
463
+ };
464
+ return {
465
+ status: "skipped",
466
+ summary: "Delivery skipped (no iMessage recipient).",
467
+ };
468
+ }
469
+ const to = resolvedDelivery.to;
470
+ const textLimit = resolveTextChunkLimit(params.cfg, "imessage");
471
+ try {
472
+ for (const payload of payloads) {
473
+ const mediaList = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []);
474
+ if (mediaList.length === 0) {
475
+ for (const chunk of chunkText(payload.text ?? "", textLimit)) {
476
+ await params.deps.sendMessageIMessage(to, chunk);
477
+ }
478
+ }
479
+ else {
480
+ let first = true;
481
+ for (const url of mediaList) {
482
+ const caption = first ? (payload.text ?? "") : "";
483
+ first = false;
484
+ await params.deps.sendMessageIMessage(to, caption, {
485
+ mediaUrl: url,
486
+ });
487
+ }
488
+ }
489
+ }
490
+ }
491
+ catch (err) {
492
+ if (!bestEffortDeliver)
493
+ return { status: "error", summary, error: String(err) };
494
+ return { status: "ok", summary };
495
+ }
496
+ }
497
+ }
498
+ return { status: "ok", summary };
499
+ }
package/dist/cron/run-log.js ADDED
@@ -0,0 +1,72 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ export function resolveCronRunLogPath(params) {
4
+ const storePath = path.resolve(params.storePath);
5
+ const dir = path.dirname(storePath);
6
+ return path.join(dir, "runs", `${params.jobId}.jsonl`);
7
+ }
8
+ const writesByPath = new Map();
9
+ async function pruneIfNeeded(filePath, opts) {
10
+ const stat = await fs.stat(filePath).catch(() => null);
11
+ if (!stat || stat.size <= opts.maxBytes)
12
+ return;
13
+ const raw = await fs.readFile(filePath, "utf-8").catch(() => "");
14
+ const lines = raw
15
+ .split("\n")
16
+ .map((l) => l.trim())
17
+ .filter(Boolean);
18
+ const kept = lines.slice(Math.max(0, lines.length - opts.keepLines));
19
+ const tmp = `${filePath}.${process.pid}.${Math.random().toString(16).slice(2)}.tmp`;
20
+ await fs.writeFile(tmp, `${kept.join("\n")}\n`, "utf-8");
21
+ await fs.rename(tmp, filePath);
22
+ }
23
+ export async function appendCronRunLog(filePath, entry, opts) {
24
+ const resolved = path.resolve(filePath);
25
+ const prev = writesByPath.get(resolved) ?? Promise.resolve();
26
+ const next = prev
27
+ .catch(() => undefined)
28
+ .then(async () => {
29
+ await fs.mkdir(path.dirname(resolved), { recursive: true });
30
+ await fs.appendFile(resolved, `${JSON.stringify(entry)}\n`, "utf-8");
31
+ await pruneIfNeeded(resolved, {
32
+ maxBytes: opts?.maxBytes ?? 2_000_000,
33
+ keepLines: opts?.keepLines ?? 2_000,
34
+ });
35
+ });
36
+ writesByPath.set(resolved, next);
37
+ await next;
38
+ }
39
+ export async function readCronRunLogEntries(filePath, opts) {
40
+ const limit = Math.max(1, Math.min(5000, Math.floor(opts?.limit ?? 200)));
41
+ const jobId = opts?.jobId?.trim() || undefined;
42
+ const raw = await fs
43
+ .readFile(path.resolve(filePath), "utf-8")
44
+ .catch(() => "");
45
+ if (!raw.trim())
46
+ return [];
47
+ const parsed = [];
48
+ const lines = raw.split("\n");
49
+ for (let i = lines.length - 1; i >= 0 && parsed.length < limit; i--) {
50
+ const line = lines[i]?.trim();
51
+ if (!line)
52
+ continue;
53
+ try {
54
+ const obj = JSON.parse(line);
55
+ if (!obj || typeof obj !== "object")
56
+ continue;
57
+ if (obj.action !== "finished")
58
+ continue;
59
+ if (typeof obj.jobId !== "string" || obj.jobId.trim().length === 0)
60
+ continue;
61
+ if (typeof obj.ts !== "number" || !Number.isFinite(obj.ts))
62
+ continue;
63
+ if (jobId && obj.jobId !== jobId)
64
+ continue;
65
+ parsed.push(obj);
66
+ }
67
+ catch {
68
+ // ignore invalid lines
69
+ }
70
+ }
71
+ return parsed.reverse();
72
+ }
package/dist/cron/schedule.js ADDED
@@ -0,0 +1,24 @@
1
+ import { Cron } from "croner";
2
+ export function computeNextRunAtMs(schedule, nowMs) {
3
+ if (schedule.kind === "at") {
4
+ return schedule.atMs > nowMs ? schedule.atMs : undefined;
5
+ }
6
+ if (schedule.kind === "every") {
7
+ const everyMs = Math.max(1, Math.floor(schedule.everyMs));
8
+ const anchor = Math.max(0, Math.floor(schedule.anchorMs ?? nowMs));
9
+ if (nowMs < anchor)
10
+ return anchor;
11
+ const elapsed = nowMs - anchor;
12
+ const steps = Math.max(1, Math.floor((elapsed + everyMs - 1) / everyMs));
13
+ return anchor + steps * everyMs;
14
+ }
15
+ const expr = schedule.expr.trim();
16
+ if (!expr)
17
+ return undefined;
18
+ const cron = new Cron(expr, {
19
+ timezone: schedule.tz?.trim() || undefined,
20
+ catch: false,
21
+ });
22
+ const next = cron.nextRun(new Date(nowMs));
23
+ return next ? next.getTime() : undefined;
24
+ }