@openparachute/agent 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (501) hide show
  1. package/.claude/scheduled_tasks.lock +1 -0
  2. package/.claude/settings.json +5 -0
  3. package/.claude/skills/add-atomic-chat-tool/SKILL.md +243 -0
  4. package/.claude/skills/add-atomic-chat-tool/atomic-chat-mcp-stdio.ts +229 -0
  5. package/.claude/skills/add-codex/SKILL.md +161 -0
  6. package/.claude/skills/add-dashboard/SKILL.md +138 -0
  7. package/.claude/skills/add-dashboard/resources/dashboard-pusher.ts +495 -0
  8. package/.claude/skills/add-emacs/SKILL.md +296 -0
  9. package/.claude/skills/add-gcal-tool/SKILL.md +210 -0
  10. package/.claude/skills/add-gchat/REMOVE.md +6 -0
  11. package/.claude/skills/add-gchat/SKILL.md +92 -0
  12. package/.claude/skills/add-gchat/VERIFY.md +3 -0
  13. package/.claude/skills/add-github/REMOVE.md +6 -0
  14. package/.claude/skills/add-github/SKILL.md +148 -0
  15. package/.claude/skills/add-github/VERIFY.md +3 -0
  16. package/.claude/skills/add-gmail-tool/SKILL.md +229 -0
  17. package/.claude/skills/add-imessage/REMOVE.md +6 -0
  18. package/.claude/skills/add-imessage/SKILL.md +113 -0
  19. package/.claude/skills/add-imessage/VERIFY.md +3 -0
  20. package/.claude/skills/add-karpathy-llm-wiki/SKILL.md +110 -0
  21. package/.claude/skills/add-karpathy-llm-wiki/llm-wiki.md +75 -0
  22. package/.claude/skills/add-linear/REMOVE.md +6 -0
  23. package/.claude/skills/add-linear/SKILL.md +168 -0
  24. package/.claude/skills/add-linear/VERIFY.md +3 -0
  25. package/.claude/skills/add-macos-statusbar/SKILL.md +133 -0
  26. package/.claude/skills/add-macos-statusbar/add/src/statusbar.swift +147 -0
  27. package/.claude/skills/add-matrix/REMOVE.md +6 -0
  28. package/.claude/skills/add-matrix/SKILL.md +148 -0
  29. package/.claude/skills/add-matrix/VERIFY.md +3 -0
  30. package/.claude/skills/add-ollama-provider/SKILL.md +179 -0
  31. package/.claude/skills/add-ollama-tool/SKILL.md +193 -0
  32. package/.claude/skills/add-opencode/SKILL.md +229 -0
  33. package/.claude/skills/add-parallel/SKILL.md +290 -0
  34. package/.claude/skills/add-resend/REMOVE.md +6 -0
  35. package/.claude/skills/add-resend/SKILL.md +93 -0
  36. package/.claude/skills/add-resend/VERIFY.md +3 -0
  37. package/.claude/skills/add-signal/REMOVE.md +13 -0
  38. package/.claude/skills/add-signal/SKILL.md +318 -0
  39. package/.claude/skills/add-signal/VERIFY.md +5 -0
  40. package/.claude/skills/add-slack/REMOVE.md +6 -0
  41. package/.claude/skills/add-slack/SKILL.md +112 -0
  42. package/.claude/skills/add-slack/VERIFY.md +3 -0
  43. package/.claude/skills/add-teams/REMOVE.md +6 -0
  44. package/.claude/skills/add-teams/SKILL.md +207 -0
  45. package/.claude/skills/add-teams/VERIFY.md +3 -0
  46. package/.claude/skills/add-vercel/SKILL.md +147 -0
  47. package/.claude/skills/add-vercel/container-skills/vercel-cli/SKILL.md +103 -0
  48. package/.claude/skills/add-webex/REMOVE.md +6 -0
  49. package/.claude/skills/add-webex/SKILL.md +88 -0
  50. package/.claude/skills/add-webex/VERIFY.md +3 -0
  51. package/.claude/skills/add-wechat/REMOVE.md +49 -0
  52. package/.claude/skills/add-wechat/SKILL.md +170 -0
  53. package/.claude/skills/add-wechat/scripts/wire-dm.ts +172 -0
  54. package/.claude/skills/add-whatsapp/SKILL.md +264 -0
  55. package/.claude/skills/add-whatsapp-cloud/REMOVE.md +6 -0
  56. package/.claude/skills/add-whatsapp-cloud/SKILL.md +95 -0
  57. package/.claude/skills/add-whatsapp-cloud/VERIFY.md +3 -0
  58. package/.claude/skills/claw/SKILL.md +131 -0
  59. package/.claude/skills/claw/scripts/claw +374 -0
  60. package/.claude/skills/convert-to-apple-container/SKILL.md +212 -0
  61. package/.claude/skills/customize/SKILL.md +110 -0
  62. package/.claude/skills/debug/SKILL.md +349 -0
  63. package/.claude/skills/get-qodo-rules/SKILL.md +122 -0
  64. package/.claude/skills/get-qodo-rules/references/output-format.md +41 -0
  65. package/.claude/skills/get-qodo-rules/references/pagination.md +33 -0
  66. package/.claude/skills/get-qodo-rules/references/repository-scope.md +26 -0
  67. package/.claude/skills/init-first-agent/SKILL.md +120 -0
  68. package/.claude/skills/init-onecli/SKILL.md +270 -0
  69. package/.claude/skills/manage-channels/SKILL.md +87 -0
  70. package/.claude/skills/manage-mounts/SKILL.md +47 -0
  71. package/.claude/skills/migrate-from-openclaw/MIGRATE_CRONS.md +100 -0
  72. package/.claude/skills/migrate-from-openclaw/SKILL.md +447 -0
  73. package/.claude/skills/migrate-from-openclaw/scripts/discover-openclaw.ts +734 -0
  74. package/.claude/skills/migrate-from-openclaw/scripts/extract-channel-credentials.ts +476 -0
  75. package/.claude/skills/migrate-nanoclaw/SKILL.md +484 -0
  76. package/.claude/skills/migrate-nanoclaw/diagnostics.md +51 -0
  77. package/.claude/skills/qodo-pr-resolver/SKILL.md +326 -0
  78. package/.claude/skills/qodo-pr-resolver/resources/providers.md +329 -0
  79. package/.claude/skills/update-nanoclaw/SKILL.md +243 -0
  80. package/.claude/skills/update-nanoclaw/diagnostics.md +48 -0
  81. package/.claude/skills/update-skills/SKILL.md +130 -0
  82. package/.claude/skills/use-native-credential-proxy/SKILL.md +167 -0
  83. package/.claude/skills/x-integration/SKILL.md +417 -0
  84. package/.claude/skills/x-integration/agent.ts +243 -0
  85. package/.claude/skills/x-integration/host.ts +155 -0
  86. package/.claude/skills/x-integration/lib/browser.ts +148 -0
  87. package/.claude/skills/x-integration/lib/config.ts +62 -0
  88. package/.claude/skills/x-integration/scripts/like.ts +56 -0
  89. package/.claude/skills/x-integration/scripts/post.ts +66 -0
  90. package/.claude/skills/x-integration/scripts/quote.ts +80 -0
  91. package/.claude/skills/x-integration/scripts/reply.ts +74 -0
  92. package/.claude/skills/x-integration/scripts/retweet.ts +62 -0
  93. package/.claude/skills/x-integration/scripts/setup.ts +87 -0
  94. package/.github/CODEOWNERS +10 -0
  95. package/.github/PULL_REQUEST_TEMPLATE.md +18 -0
  96. package/.github/workflows/bump-version.yml +35 -0
  97. package/.github/workflows/ci.yml +39 -0
  98. package/.github/workflows/label-pr.yml +40 -0
  99. package/.github/workflows/update-tokens.yml +43 -0
  100. package/.husky/pre-commit +1 -0
  101. package/.mcp.json +3 -0
  102. package/.nvmrc +1 -0
  103. package/.parachute/module.json +14 -0
  104. package/.prettierrc +4 -0
  105. package/CHANGELOG.md +215 -0
  106. package/CLAUDE.md +307 -0
  107. package/CODE_OF_CONDUCT.md +128 -0
  108. package/CONTRIBUTING.md +159 -0
  109. package/CONTRIBUTORS.md +26 -0
  110. package/LICENSE +21 -0
  111. package/README.md +190 -0
  112. package/README_ja.md +194 -0
  113. package/README_zh.md +194 -0
  114. package/assets/nanoclaw-favicon.png +0 -0
  115. package/assets/nanoclaw-icon.png +0 -0
  116. package/assets/nanoclaw-logo-dark.png +0 -0
  117. package/assets/nanoclaw-logo.png +0 -0
  118. package/assets/nanoclaw-profile.jpeg +0 -0
  119. package/assets/nanoclaw-sales.png +0 -0
  120. package/assets/social-preview.jpg +0 -0
  121. package/config-examples/mount-allowlist.json +25 -0
  122. package/container/.dockerignore +2 -0
  123. package/container/CLAUDE.md +21 -0
  124. package/container/Dockerfile +121 -0
  125. package/container/agent-runner/bun.lock +243 -0
  126. package/container/agent-runner/package.json +22 -0
  127. package/container/agent-runner/scripts/sdk-signal-probe.ts +169 -0
  128. package/container/agent-runner/src/config.ts +55 -0
  129. package/container/agent-runner/src/db/connection.ts +267 -0
  130. package/container/agent-runner/src/db/index.ts +20 -0
  131. package/container/agent-runner/src/db/messages-in.ts +138 -0
  132. package/container/agent-runner/src/db/messages-out.ts +143 -0
  133. package/container/agent-runner/src/db/session-routing.ts +30 -0
  134. package/container/agent-runner/src/db/session-state.test.ts +100 -0
  135. package/container/agent-runner/src/db/session-state.ts +79 -0
  136. package/container/agent-runner/src/destinations.ts +135 -0
  137. package/container/agent-runner/src/formatter.test.ts +167 -0
  138. package/container/agent-runner/src/formatter.ts +260 -0
  139. package/container/agent-runner/src/index.ts +110 -0
  140. package/container/agent-runner/src/integration.test.ts +121 -0
  141. package/container/agent-runner/src/mcp-tools/agents.instructions.md +26 -0
  142. package/container/agent-runner/src/mcp-tools/agents.ts +66 -0
  143. package/container/agent-runner/src/mcp-tools/core.instructions.md +27 -0
  144. package/container/agent-runner/src/mcp-tools/core.ts +262 -0
  145. package/container/agent-runner/src/mcp-tools/index.ts +22 -0
  146. package/container/agent-runner/src/mcp-tools/interactive.instructions.md +22 -0
  147. package/container/agent-runner/src/mcp-tools/interactive.ts +169 -0
  148. package/container/agent-runner/src/mcp-tools/scheduling.instructions.md +40 -0
  149. package/container/agent-runner/src/mcp-tools/scheduling.ts +299 -0
  150. package/container/agent-runner/src/mcp-tools/self-mod.instructions.md +25 -0
  151. package/container/agent-runner/src/mcp-tools/self-mod.ts +120 -0
  152. package/container/agent-runner/src/mcp-tools/server.ts +54 -0
  153. package/container/agent-runner/src/mcp-tools/types.ts +6 -0
  154. package/container/agent-runner/src/poll-loop.test.ts +248 -0
  155. package/container/agent-runner/src/poll-loop.ts +437 -0
  156. package/container/agent-runner/src/providers/claude.ts +379 -0
  157. package/container/agent-runner/src/providers/factory.test.ts +19 -0
  158. package/container/agent-runner/src/providers/factory.ts +13 -0
  159. package/container/agent-runner/src/providers/index.ts +6 -0
  160. package/container/agent-runner/src/providers/mock.ts +77 -0
  161. package/container/agent-runner/src/providers/provider-registry.ts +33 -0
  162. package/container/agent-runner/src/providers/types.ts +82 -0
  163. package/container/agent-runner/src/scheduling/task-script.ts +121 -0
  164. package/container/agent-runner/src/timezone.test.ts +93 -0
  165. package/container/agent-runner/src/timezone.ts +107 -0
  166. package/container/agent-runner/tsconfig.json +14 -0
  167. package/container/build.sh +48 -0
  168. package/container/entrypoint.sh +16 -0
  169. package/container/skills/agent-browser/SKILL.md +159 -0
  170. package/container/skills/frontend-engineer/SKILL.md +157 -0
  171. package/container/skills/self-customize/SKILL.md +87 -0
  172. package/container/skills/slack-formatting/SKILL.md +94 -0
  173. package/container/skills/vercel-cli/SKILL.md +111 -0
  174. package/container/skills/welcome/SKILL.md +85 -0
  175. package/docs/APPLE-CONTAINER-NETWORKING.md +90 -0
  176. package/docs/BRANCH-FORK-MAINTENANCE.md +81 -0
  177. package/docs/README.md +25 -0
  178. package/docs/SDK_DEEP_DIVE.md +643 -0
  179. package/docs/SECURITY.md +162 -0
  180. package/docs/agent-runner-details.md +749 -0
  181. package/docs/api-details.md +365 -0
  182. package/docs/architecture-diagram.html +422 -0
  183. package/docs/architecture-diagram.md +215 -0
  184. package/docs/architecture.md +751 -0
  185. package/docs/audit/2026-04-30-channel-endpoint-audit.md +36 -0
  186. package/docs/build-and-runtime.md +80 -0
  187. package/docs/cross-mount-stress/README.md +112 -0
  188. package/docs/cross-mount-stress/container-writer-retry.mjs +55 -0
  189. package/docs/cross-mount-stress/container-writer-slow.mjs +42 -0
  190. package/docs/cross-mount-stress/container-writer.mjs +47 -0
  191. package/docs/cross-mount-stress/host-writer-retry.mjs +55 -0
  192. package/docs/cross-mount-stress/host-writer-slow.mjs +43 -0
  193. package/docs/cross-mount-stress/host-writer.mjs +47 -0
  194. package/docs/db-central.md +316 -0
  195. package/docs/db-session.md +183 -0
  196. package/docs/db.md +119 -0
  197. package/docs/design/2026-04-29-vault-management-ui.md +231 -0
  198. package/docs/design/2026-04-30-channel-wiring-rework.md +234 -0
  199. package/docs/design/2026-05-01-channel-wiring-approvals-deep-dive.md +272 -0
  200. package/docs/design/2026-05-02-channel-policy-and-approval-routing.md +250 -0
  201. package/docs/docker-sandboxes.md +359 -0
  202. package/docs/isolation-model.md +88 -0
  203. package/docs/ollama.md +79 -0
  204. package/docs/parachute-integration.md +109 -0
  205. package/docs/post-night-rebirth-reflections.md +151 -0
  206. package/eslint.config.js +32 -0
  207. package/package.json +54 -0
  208. package/pnpm-workspace.yaml +8 -0
  209. package/repo-tokens/README.md +113 -0
  210. package/repo-tokens/action.yml +186 -0
  211. package/repo-tokens/badge.svg +23 -0
  212. package/repo-tokens/examples/green.svg +14 -0
  213. package/repo-tokens/examples/red.svg +14 -0
  214. package/repo-tokens/examples/yellow-green.svg +14 -0
  215. package/repo-tokens/examples/yellow.svg +14 -0
  216. package/scripts/chat.ts +101 -0
  217. package/scripts/cleanup-sessions.sh +150 -0
  218. package/scripts/init-cli-agent.ts +171 -0
  219. package/scripts/init-first-agent.ts +377 -0
  220. package/scripts/parachute.ts +158 -0
  221. package/scripts/run-migrations.ts +105 -0
  222. package/scripts/sanity-live-poll.ts +95 -0
  223. package/scripts/seed-discord.ts +79 -0
  224. package/scripts/test-v2-agent.ts +106 -0
  225. package/scripts/test-v2-channel-e2e.ts +265 -0
  226. package/scripts/test-v2-host.ts +184 -0
  227. package/src/channels/adapter.ts +214 -0
  228. package/src/channels/ask-question.ts +46 -0
  229. package/src/channels/channel-registry.test.ts +421 -0
  230. package/src/channels/channel-registry.ts +313 -0
  231. package/src/channels/chat-sdk-bridge.test.ts +84 -0
  232. package/src/channels/chat-sdk-bridge.ts +652 -0
  233. package/src/channels/cli.ts +276 -0
  234. package/src/channels/discord.ts +90 -0
  235. package/src/channels/index.ts +17 -0
  236. package/src/channels/telegram-markdown-sanitize.test.ts +78 -0
  237. package/src/channels/telegram-markdown-sanitize.ts +55 -0
  238. package/src/channels/telegram-pairing.test.ts +254 -0
  239. package/src/channels/telegram-pairing.ts +339 -0
  240. package/src/channels/telegram.ts +279 -0
  241. package/src/channels/trust-hint.test.ts +48 -0
  242. package/src/channels/trust-hint.ts +75 -0
  243. package/src/claude-md-compose.migrate.test.ts +64 -0
  244. package/src/claude-md-compose.ts +205 -0
  245. package/src/command-gate.ts +63 -0
  246. package/src/config.test.ts +93 -0
  247. package/src/config.ts +108 -0
  248. package/src/container-config.ts +167 -0
  249. package/src/container-runner.test.ts +32 -0
  250. package/src/container-runner.ts +576 -0
  251. package/src/container-runtime.test.ts +169 -0
  252. package/src/container-runtime.ts +92 -0
  253. package/src/db/_bun-sqlite-shim.ts +88 -0
  254. package/src/db/agent-activity.test.ts +155 -0
  255. package/src/db/agent-activity.ts +121 -0
  256. package/src/db/agent-groups.ts +77 -0
  257. package/src/db/connection.migrate.test.ts +143 -0
  258. package/src/db/connection.ts +224 -0
  259. package/src/db/db-v2.test.ts +440 -0
  260. package/src/db/dropped-messages.ts +44 -0
  261. package/src/db/index.ts +40 -0
  262. package/src/db/messaging-groups.ts +252 -0
  263. package/src/db/migrations/001-initial.ts +112 -0
  264. package/src/db/migrations/002-chat-sdk-state.ts +36 -0
  265. package/src/db/migrations/008-dropped-messages.ts +27 -0
  266. package/src/db/migrations/009-drop-pending-credentials.ts +13 -0
  267. package/src/db/migrations/010-engage-modes.ts +103 -0
  268. package/src/db/migrations/011-pending-sender-approvals.ts +40 -0
  269. package/src/db/migrations/012-channel-registration.ts +48 -0
  270. package/src/db/migrations/013-approval-render-metadata.ts +27 -0
  271. package/src/db/migrations/014-secrets.ts +44 -0
  272. package/src/db/migrations/015-secrets-drop-host-pattern.ts +18 -0
  273. package/src/db/migrations/016-secret-assignments.ts +30 -0
  274. package/src/db/migrations/017-agent-activity.ts +40 -0
  275. package/src/db/migrations/018-oauth-app-configs.ts +34 -0
  276. package/src/db/migrations/019-oauth-app-connections.ts +48 -0
  277. package/src/db/migrations/020-agent-app-connections.ts +28 -0
  278. package/src/db/migrations/021-pending-oauth-states.ts +35 -0
  279. package/src/db/migrations/022-app-connections-provider.ts +25 -0
  280. package/src/db/migrations/023-agent-group-secret-mode.test.ts +124 -0
  281. package/src/db/migrations/023-agent-group-secret-mode.ts +65 -0
  282. package/src/db/migrations/024-collapse-approvals.test.ts +249 -0
  283. package/src/db/migrations/024-collapse-approvals.ts +182 -0
  284. package/src/db/migrations/025-secret-mode-check.test.ts +155 -0
  285. package/src/db/migrations/025-secret-mode-check.ts +49 -0
  286. package/src/db/migrations/026-user-dms-bot-id.test.ts +116 -0
  287. package/src/db/migrations/026-user-dms-bot-id.ts +54 -0
  288. package/src/db/migrations/027-provider-credentials.ts +41 -0
  289. package/src/db/migrations/_test-helpers.ts +41 -0
  290. package/src/db/migrations/index.ts +127 -0
  291. package/src/db/migrations/module-agent-to-agent-destinations.ts +84 -0
  292. package/src/db/migrations/module-approvals-pending-approvals.ts +42 -0
  293. package/src/db/migrations/module-approvals-title-options.ts +40 -0
  294. package/src/db/schema.ts +258 -0
  295. package/src/db/session-db.test.ts +93 -0
  296. package/src/db/session-db.ts +325 -0
  297. package/src/db/sessions.ts +241 -0
  298. package/src/delivery.test.ts +148 -0
  299. package/src/delivery.ts +445 -0
  300. package/src/env.ts +74 -0
  301. package/src/group-folder.test.ts +35 -0
  302. package/src/group-folder.ts +44 -0
  303. package/src/group-init.ts +92 -0
  304. package/src/host-core.test.ts +456 -0
  305. package/src/host-sweep.test.ts +146 -0
  306. package/src/host-sweep.ts +287 -0
  307. package/src/index.ts +227 -0
  308. package/src/install-slug.ts +33 -0
  309. package/src/log.test.ts +81 -0
  310. package/src/log.ts +117 -0
  311. package/src/mcp/http.ts +72 -0
  312. package/src/mcp/server.ts +92 -0
  313. package/src/mcp/stdio.ts +51 -0
  314. package/src/mcp/tools/activity.ts +88 -0
  315. package/src/mcp/tools/agent-groups.ts +183 -0
  316. package/src/mcp/tools/approvals.ts +122 -0
  317. package/src/mcp/tools/channels.ts +199 -0
  318. package/src/mcp/tools/index.ts +27 -0
  319. package/src/mcp/tools/oauth.ts +48 -0
  320. package/src/mcp/tools/secrets.ts +169 -0
  321. package/src/mcp/tools/sessions.ts +135 -0
  322. package/src/mcp/types.ts +51 -0
  323. package/src/modules/agent-to-agent/agent-route.test.ts +46 -0
  324. package/src/modules/agent-to-agent/agent-route.ts +223 -0
  325. package/src/modules/agent-to-agent/create-agent.ts +127 -0
  326. package/src/modules/agent-to-agent/db/agent-destinations.ts +135 -0
  327. package/src/modules/agent-to-agent/index.ts +22 -0
  328. package/src/modules/agent-to-agent/write-destinations.ts +59 -0
  329. package/src/modules/approvals/agent.md +45 -0
  330. package/src/modules/approvals/index.ts +21 -0
  331. package/src/modules/approvals/picks.test.ts +291 -0
  332. package/src/modules/approvals/primitive.ts +279 -0
  333. package/src/modules/approvals/project.md +27 -0
  334. package/src/modules/approvals/response-handler.ts +87 -0
  335. package/src/modules/index.ts +24 -0
  336. package/src/modules/interactive/agent.md +21 -0
  337. package/src/modules/interactive/index.ts +69 -0
  338. package/src/modules/interactive/project.md +12 -0
  339. package/src/modules/mount-security/index.ts +448 -0
  340. package/src/modules/mount-security/migrate.test.ts +91 -0
  341. package/src/modules/permissions/access.ts +28 -0
  342. package/src/modules/permissions/channel-approval.test.ts +389 -0
  343. package/src/modules/permissions/channel-approval.ts +188 -0
  344. package/src/modules/permissions/db/agent-group-members.ts +44 -0
  345. package/src/modules/permissions/db/pending-channel-approvals.test.ts +86 -0
  346. package/src/modules/permissions/db/pending-channel-approvals.ts +66 -0
  347. package/src/modules/permissions/db/pending-sender-approvals.ts +60 -0
  348. package/src/modules/permissions/db/user-dms.ts +58 -0
  349. package/src/modules/permissions/db/user-roles.ts +85 -0
  350. package/src/modules/permissions/db/users.ts +38 -0
  351. package/src/modules/permissions/index.ts +421 -0
  352. package/src/modules/permissions/permissions.test.ts +358 -0
  353. package/src/modules/permissions/sender-approval.test.ts +470 -0
  354. package/src/modules/permissions/sender-approval.ts +165 -0
  355. package/src/modules/permissions/user-dm.ts +200 -0
  356. package/src/modules/provider-credentials/db.ts +121 -0
  357. package/src/modules/provider-credentials/index.ts +12 -0
  358. package/src/modules/provider-credentials/spawn.test.ts +206 -0
  359. package/src/modules/provider-credentials/spawn.ts +114 -0
  360. package/src/modules/scheduling/actions.ts +113 -0
  361. package/src/modules/scheduling/db.test.ts +282 -0
  362. package/src/modules/scheduling/db.ts +148 -0
  363. package/src/modules/scheduling/index.ts +34 -0
  364. package/src/modules/scheduling/recurrence.test.ts +98 -0
  365. package/src/modules/scheduling/recurrence.ts +54 -0
  366. package/src/modules/self-mod/agent.md +30 -0
  367. package/src/modules/self-mod/apply.ts +85 -0
  368. package/src/modules/self-mod/index.ts +30 -0
  369. package/src/modules/self-mod/project.md +39 -0
  370. package/src/modules/self-mod/request.ts +91 -0
  371. package/src/modules/typing/index.ts +165 -0
  372. package/src/oauth/agent-app-connections.ts +103 -0
  373. package/src/oauth/app-configs.test.ts +64 -0
  374. package/src/oauth/app-configs.ts +114 -0
  375. package/src/oauth/app-connections.test.ts +109 -0
  376. package/src/oauth/app-connections.ts +178 -0
  377. package/src/oauth/crypto.ts +56 -0
  378. package/src/oauth/flow.ts +104 -0
  379. package/src/oauth/providers/google.test.ts +38 -0
  380. package/src/oauth/providers/google.ts +46 -0
  381. package/src/oauth/providers/index.ts +48 -0
  382. package/src/oauth/state-store.test.ts +54 -0
  383. package/src/oauth/state-store.ts +93 -0
  384. package/src/parachute/README.md +27 -0
  385. package/src/parachute/create-agent.test.ts +83 -0
  386. package/src/parachute/create-agent.ts +122 -0
  387. package/src/parachute/group-status.test.ts +165 -0
  388. package/src/parachute/group-status.ts +136 -0
  389. package/src/parachute/types.ts +41 -0
  390. package/src/parachute/vault-mcp.test.ts +251 -0
  391. package/src/parachute/vault-mcp.ts +232 -0
  392. package/src/platform-id.test.ts +104 -0
  393. package/src/platform-id.ts +109 -0
  394. package/src/providers/index.ts +6 -0
  395. package/src/providers/provider-container-registry.ts +58 -0
  396. package/src/response-registry.ts +45 -0
  397. package/src/router.ts +530 -0
  398. package/src/secrets/crypto.test.ts +45 -0
  399. package/src/secrets/crypto.ts +55 -0
  400. package/src/secrets/index.ts +355 -0
  401. package/src/secrets/master-key.ts +70 -0
  402. package/src/secrets/secrets.test.ts +354 -0
  403. package/src/session-manager.migrate.test.ts +59 -0
  404. package/src/session-manager.ts +433 -0
  405. package/src/startup-bootstrap.test.ts +226 -0
  406. package/src/startup-bootstrap.ts +207 -0
  407. package/src/state-sqlite.ts +182 -0
  408. package/src/timezone.test.ts +64 -0
  409. package/src/timezone.ts +37 -0
  410. package/src/types.ts +230 -0
  411. package/src/web/auth.test.ts +335 -0
  412. package/src/web/auth.ts +214 -0
  413. package/src/web/discord-validate.test.ts +77 -0
  414. package/src/web/discord-validate.ts +88 -0
  415. package/src/web/hub-discovery.test.ts +98 -0
  416. package/src/web/hub-discovery.ts +69 -0
  417. package/src/web/routes/activity.ts +106 -0
  418. package/src/web/routes/agent-provider.test.ts +282 -0
  419. package/src/web/routes/agent-provider.ts +309 -0
  420. package/src/web/routes/approvals.ts +185 -0
  421. package/src/web/routes/apps.ts +434 -0
  422. package/src/web/routes/channels-mg-detail.test.ts +324 -0
  423. package/src/web/routes/channels-mga-detail.test.ts +425 -0
  424. package/src/web/routes/channels.ts +489 -0
  425. package/src/web/routes/oauth-providers.ts +42 -0
  426. package/src/web/routes/secrets.test.ts +175 -0
  427. package/src/web/routes/secrets.ts +282 -0
  428. package/src/web/routes/sessions.ts +123 -0
  429. package/src/web/routes/settings.test.ts +106 -0
  430. package/src/web/routes/settings.ts +247 -0
  431. package/src/web/routes/setup-status.ts +205 -0
  432. package/src/web/routes/vaults.test.ts +389 -0
  433. package/src/web/routes/vaults.ts +225 -0
  434. package/src/web/server-version.test.ts +16 -0
  435. package/src/web/server.ts +1003 -0
  436. package/src/web/services-manifest.test.ts +120 -0
  437. package/src/web/services-manifest.ts +61 -0
  438. package/src/web/static-serve.test.ts +255 -0
  439. package/src/web/static-serve.ts +104 -0
  440. package/src/web/telegram-validate.test.ts +116 -0
  441. package/src/web/telegram-validate.ts +107 -0
  442. package/src/web/vault-proxy.test.ts +214 -0
  443. package/src/web/vault-proxy.ts +120 -0
  444. package/src/web/wire-channel.ts +181 -0
  445. package/src/webhook-server.ts +134 -0
  446. package/tsconfig.json +21 -0
  447. package/vitest.config.ts +18 -0
  448. package/web/README.md +63 -0
  449. package/web/ui/index.html +13 -0
  450. package/web/ui/package.json +35 -0
  451. package/web/ui/pnpm-lock.yaml +2164 -0
  452. package/web/ui/scripts/verify-base.mjs +31 -0
  453. package/web/ui/src/App.tsx +88 -0
  454. package/web/ui/src/components/ActivityFeed.tsx +444 -0
  455. package/web/ui/src/components/AgentGroupPicker.tsx +263 -0
  456. package/web/ui/src/components/AgentProviderCards.tsx +220 -0
  457. package/web/ui/src/components/CredentialForm.tsx +214 -0
  458. package/web/ui/src/components/ScopeGrants.tsx +74 -0
  459. package/web/ui/src/components/StatusDot.tsx +43 -0
  460. package/web/ui/src/components/VaultPicker.tsx +127 -0
  461. package/web/ui/src/components/setup/AdapterInstallStep.tsx +178 -0
  462. package/web/ui/src/components/setup/AgentGroupStep.tsx +43 -0
  463. package/web/ui/src/components/setup/ChannelPickStep.tsx +74 -0
  464. package/web/ui/src/components/setup/DoneStep.tsx +49 -0
  465. package/web/ui/src/components/setup/PrereqStep.tsx +129 -0
  466. package/web/ui/src/components/setup/TestConnectionStep.tsx +108 -0
  467. package/web/ui/src/components/setup/TestMessageStep.tsx +104 -0
  468. package/web/ui/src/components/setup/WireChannelStep.tsx +166 -0
  469. package/web/ui/src/components/setup/types.ts +105 -0
  470. package/web/ui/src/lib/api.test.ts +410 -0
  471. package/web/ui/src/lib/api.ts +1210 -0
  472. package/web/ui/src/lib/auth.test.ts +139 -0
  473. package/web/ui/src/lib/auth.ts +348 -0
  474. package/web/ui/src/lib/channel-adapters.ts +136 -0
  475. package/web/ui/src/main.tsx +19 -0
  476. package/web/ui/src/routes/ApprovalsList.tsx +294 -0
  477. package/web/ui/src/routes/Apps.tsx +613 -0
  478. package/web/ui/src/routes/ChannelWireDetail.test.tsx +233 -0
  479. package/web/ui/src/routes/ChannelWireDetail.tsx +403 -0
  480. package/web/ui/src/routes/ChannelsList.tsx +158 -0
  481. package/web/ui/src/routes/GroupDetail.tsx +755 -0
  482. package/web/ui/src/routes/GroupList.tsx +187 -0
  483. package/web/ui/src/routes/MessagingGroupDetail.test.tsx +233 -0
  484. package/web/ui/src/routes/MessagingGroupDetail.tsx +306 -0
  485. package/web/ui/src/routes/NewGroupWizard.tsx +390 -0
  486. package/web/ui/src/routes/OAuthCallback.tsx +56 -0
  487. package/web/ui/src/routes/SecretsList.tsx +921 -0
  488. package/web/ui/src/routes/SessionsList.tsx +220 -0
  489. package/web/ui/src/routes/SettingsAgentProvider.tsx +109 -0
  490. package/web/ui/src/routes/SettingsApprovals.tsx +234 -0
  491. package/web/ui/src/routes/SetupWizard.tsx +219 -0
  492. package/web/ui/src/routes/VaultDetail.test.tsx +361 -0
  493. package/web/ui/src/routes/VaultDetail.tsx +960 -0
  494. package/web/ui/src/routes/VaultsList.tsx +295 -0
  495. package/web/ui/src/routes/WireChannelPage.tsx +413 -0
  496. package/web/ui/src/styles.css +608 -0
  497. package/web/ui/src/test/setup.ts +23 -0
  498. package/web/ui/src/vite-env.d.ts +10 -0
  499. package/web/ui/tsconfig.json +20 -0
  500. package/web/ui/vite.config.ts +34 -0
  501. package/web/ui/vitest.config.ts +25 -0
@@ -0,0 +1,113 @@
1
+ /**
2
+ * Delivery action handlers for scheduling.
3
+ *
4
+ * The container can't write to inbound.db (host-owned). When the agent calls
5
+ * schedule_task / cancel_task / etc. via MCP, the container writes a
6
+ * `kind='system'` outbound message with an `action` field. The delivery path
7
+ * reaches into this module via the delivery-action registry and we apply the
8
+ * change to inbound.db here.
9
+ */
10
+ import type { Database } from '../../db/connection.js';
11
+
12
+ import { wakeContainer } from '../../container-runner.js';
13
+ import { getSession } from '../../db/sessions.js';
14
+ import { log } from '../../log.js';
15
+ import { writeSessionMessage } from '../../session-manager.js';
16
+ import type { Session } from '../../types.js';
17
+ import { cancelTask, insertTask, pauseTask, resumeTask, updateTask, type TaskUpdate } from './db.js';
18
+
19
+ export async function handleScheduleTask(
20
+ content: Record<string, unknown>,
21
+ _session: Session,
22
+ inDb: Database,
23
+ ): Promise<void> {
24
+ const taskId = content.taskId as string;
25
+ const prompt = content.prompt as string;
26
+ const script = content.script as string | null;
27
+ const processAfter = content.processAfter as string;
28
+ const recurrence = (content.recurrence as string) || null;
29
+
30
+ insertTask(inDb, {
31
+ id: taskId,
32
+ processAfter,
33
+ recurrence,
34
+ platformId: (content.platformId as string) ?? null,
35
+ channelType: (content.channelType as string) ?? null,
36
+ threadId: (content.threadId as string) ?? null,
37
+ content: JSON.stringify({ prompt, script }),
38
+ });
39
+ log.info('Scheduled task created', { taskId, processAfter, recurrence });
40
+ }
41
+
42
+ export async function handleCancelTask(
43
+ content: Record<string, unknown>,
44
+ _session: Session,
45
+ inDb: Database,
46
+ ): Promise<void> {
47
+ const taskId = content.taskId as string;
48
+ cancelTask(inDb, taskId);
49
+ log.info('Task cancelled', { taskId });
50
+ }
51
+
52
+ export async function handlePauseTask(
53
+ content: Record<string, unknown>,
54
+ _session: Session,
55
+ inDb: Database,
56
+ ): Promise<void> {
57
+ const taskId = content.taskId as string;
58
+ pauseTask(inDb, taskId);
59
+ log.info('Task paused', { taskId });
60
+ }
61
+
62
+ export async function handleResumeTask(
63
+ content: Record<string, unknown>,
64
+ _session: Session,
65
+ inDb: Database,
66
+ ): Promise<void> {
67
+ const taskId = content.taskId as string;
68
+ resumeTask(inDb, taskId);
69
+ log.info('Task resumed', { taskId });
70
+ }
71
+
72
+ export async function handleUpdateTask(
73
+ content: Record<string, unknown>,
74
+ session: Session,
75
+ inDb: Database,
76
+ ): Promise<void> {
77
+ const taskId = content.taskId as string;
78
+ const update: TaskUpdate = {};
79
+ if (typeof content.prompt === 'string') update.prompt = content.prompt;
80
+ if (typeof content.processAfter === 'string') update.processAfter = content.processAfter;
81
+ if (content.recurrence === null || typeof content.recurrence === 'string') {
82
+ update.recurrence = content.recurrence as string | null;
83
+ }
84
+ if (content.script === null || typeof content.script === 'string') {
85
+ update.script = content.script as string | null;
86
+ }
87
+ const touched = updateTask(inDb, taskId, update);
88
+ log.info('Task updated', { taskId, touched, fields: Object.keys(update) });
89
+ if (touched === 0) {
90
+ // Notify the agent that update_task matched nothing. Replicates the
91
+ // old notifyAgent helper that used to live in delivery.ts — inlined
92
+ // here so scheduling doesn't depend on delivery's private helpers.
93
+ writeSessionMessage(session.agent_group_id, session.id, {
94
+ id: `sys-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
95
+ kind: 'chat',
96
+ timestamp: new Date().toISOString(),
97
+ platformId: session.agent_group_id,
98
+ channelType: 'agent',
99
+ threadId: null,
100
+ content: JSON.stringify({
101
+ text: `update_task: no live task matched id "${taskId}".`,
102
+ sender: 'system',
103
+ senderId: 'system',
104
+ }),
105
+ });
106
+ const fresh = getSession(session.id);
107
+ if (fresh) {
108
+ wakeContainer(fresh).catch((err) =>
109
+ log.error('Failed to wake container after update_task notification', { err }),
110
+ );
111
+ }
112
+ }
113
+ }
@@ -0,0 +1,282 @@
1
+ /**
2
+ * Tests for the scheduling module's task DB helpers — focused on the
3
+ * series_id invariant that lets cancel/pause/resume/update reach the live
4
+ * next occurrence of a recurring task, even after the row the agent
5
+ * remembers has completed and been replaced by a follow-up.
6
+ */
7
+ import fs from 'fs';
8
+ import path from 'path';
9
+ import { describe, it, expect, afterEach } from 'vitest';
10
+
11
+ import { ensureSchema, openInboundDb } from '../../db/session-db.js';
12
+ import {
13
+ insertTask,
14
+ insertRecurrence,
15
+ cancelTask,
16
+ pauseTask,
17
+ resumeTask,
18
+ updateTask,
19
+ getCompletedRecurring,
20
+ type RecurringMessage,
21
+ } from './db.js';
22
+
23
+ const TEST_DIR = '/tmp/paraclaw-scheduling-db-test';
24
+ const DB_PATH = path.join(TEST_DIR, 'inbound.db');
25
+
26
+ function freshDb() {
27
+ if (fs.existsSync(TEST_DIR)) fs.rmSync(TEST_DIR, { recursive: true });
28
+ fs.mkdirSync(TEST_DIR, { recursive: true });
29
+ ensureSchema(DB_PATH, 'inbound');
30
+ return openInboundDb(DB_PATH);
31
+ }
32
+
33
+ function insertBasicTask(db: ReturnType<typeof openInboundDb>, id: string, recurrence: string | null) {
34
+ insertTask(db, {
35
+ id,
36
+ processAfter: new Date().toISOString(),
37
+ recurrence,
38
+ platformId: null,
39
+ channelType: null,
40
+ threadId: null,
41
+ content: JSON.stringify({ prompt: 'noop' }),
42
+ });
43
+ }
44
+
45
+ afterEach(() => {
46
+ if (fs.existsSync(TEST_DIR)) fs.rmSync(TEST_DIR, { recursive: true });
47
+ });
48
+
49
+ describe('insertTask', () => {
50
+ it('stamps series_id = id on insert', () => {
51
+ const db = freshDb();
52
+ insertBasicTask(db, 'task-1', null);
53
+ const row = db.prepare('SELECT series_id FROM messages_in WHERE id = ?').get('task-1') as { series_id: string };
54
+ expect(row.series_id).toBe('task-1');
55
+ db.close();
56
+ });
57
+ });
58
+
59
+ describe('cancelTask / pauseTask / resumeTask series matching', () => {
60
+ // Simulates the recurrence chain that used to survive cancellation:
61
+ // the original task completes → handleRecurrence spawns a follow-up
62
+ // row → agent calls cancel_task(originalId) → historically only hit
63
+ // the completed row, leaving the live one running.
64
+ function seedRecurringChain(db: ReturnType<typeof openInboundDb>) {
65
+ insertBasicTask(db, 'task-orig', '0 9 * * *');
66
+ // Mark the original as completed (as syncProcessingAcks would do).
67
+ db.prepare("UPDATE messages_in SET status = 'completed' WHERE id = 'task-orig'").run();
68
+
69
+ const msg: RecurringMessage = {
70
+ id: 'task-orig',
71
+ kind: 'task',
72
+ content: JSON.stringify({ prompt: 'noop' }),
73
+ recurrence: '0 9 * * *',
74
+ process_after: null,
75
+ platform_id: null,
76
+ channel_type: null,
77
+ thread_id: null,
78
+ series_id: 'task-orig',
79
+ };
80
+ insertRecurrence(db, msg, 'task-next', new Date(Date.now() + 86400000).toISOString());
81
+ }
82
+
83
+ it('cancel by original id reaches the live follow-up via series_id', () => {
84
+ const db = freshDb();
85
+ seedRecurringChain(db);
86
+
87
+ cancelTask(db, 'task-orig');
88
+
89
+ const live = db.prepare("SELECT id, status, recurrence FROM messages_in WHERE status = 'pending'").all();
90
+ expect(live).toHaveLength(0);
91
+
92
+ const followUp = db.prepare("SELECT status, recurrence FROM messages_in WHERE id = 'task-next'").get() as {
93
+ status: string;
94
+ recurrence: string | null;
95
+ };
96
+ expect(followUp.status).toBe('completed');
97
+ // Recurrence cleared so the sweep doesn't spawn another clone.
98
+ expect(followUp.recurrence).toBeNull();
99
+ db.close();
100
+ });
101
+
102
+ it('cancelled task is not picked up by getCompletedRecurring', () => {
103
+ const db = freshDb();
104
+ insertBasicTask(db, 'task-1', '0 9 * * *');
105
+ cancelTask(db, 'task-1');
106
+
107
+ const recurring = getCompletedRecurring(db);
108
+ expect(recurring).toHaveLength(0);
109
+ db.close();
110
+ });
111
+
112
+ it('pause by original id pauses the live follow-up', () => {
113
+ const db = freshDb();
114
+ seedRecurringChain(db);
115
+
116
+ pauseTask(db, 'task-orig');
117
+
118
+ const followUp = db.prepare("SELECT status FROM messages_in WHERE id = 'task-next'").get() as { status: string };
119
+ expect(followUp.status).toBe('paused');
120
+ db.close();
121
+ });
122
+
123
+ it('resume by original id resumes the live follow-up', () => {
124
+ const db = freshDb();
125
+ seedRecurringChain(db);
126
+
127
+ db.prepare("UPDATE messages_in SET status = 'paused' WHERE id = 'task-next'").run();
128
+ resumeTask(db, 'task-orig');
129
+
130
+ const followUp = db.prepare("SELECT status FROM messages_in WHERE id = 'task-next'").get() as { status: string };
131
+ expect(followUp.status).toBe('pending');
132
+ db.close();
133
+ });
134
+ });
135
+
136
+ describe('updateTask', () => {
137
+ it('merges supplied fields into content JSON without clobbering others', () => {
138
+ const db = freshDb();
139
+ insertTask(db, {
140
+ id: 'task-1',
141
+ processAfter: new Date().toISOString(),
142
+ recurrence: null,
143
+ platformId: null,
144
+ channelType: null,
145
+ threadId: null,
146
+ content: JSON.stringify({ prompt: 'old', script: 'echo old', extra: 'keep me' }),
147
+ });
148
+
149
+ const touched = updateTask(db, 'task-1', { prompt: 'new' });
150
+ expect(touched).toBe(1);
151
+
152
+ const row = db.prepare('SELECT content FROM messages_in WHERE id = ?').get('task-1') as { content: string };
153
+ const parsed = JSON.parse(row.content);
154
+ expect(parsed.prompt).toBe('new');
155
+ expect(parsed.script).toBe('echo old');
156
+ expect(parsed.extra).toBe('keep me');
157
+ });
158
+
159
+ it('updates recurrence and process_after when supplied', () => {
160
+ const db = freshDb();
161
+ insertTask(db, {
162
+ id: 'task-1',
163
+ processAfter: '2026-01-01T00:00:00Z',
164
+ recurrence: '0 9 * * *',
165
+ platformId: null,
166
+ channelType: null,
167
+ threadId: null,
168
+ content: JSON.stringify({ prompt: 'p' }),
169
+ });
170
+
171
+ updateTask(db, 'task-1', { recurrence: '0 18 * * *', processAfter: '2026-02-01T00:00:00Z' });
172
+
173
+ const row = db.prepare('SELECT recurrence, process_after FROM messages_in WHERE id = ?').get('task-1') as {
174
+ recurrence: string;
175
+ process_after: string;
176
+ };
177
+ expect(row.recurrence).toBe('0 18 * * *');
178
+ expect(row.process_after).toBe('2026-02-01T00:00:00Z');
179
+ });
180
+
181
+ it('clears recurrence when null is passed', () => {
182
+ const db = freshDb();
183
+ insertTask(db, {
184
+ id: 'task-1',
185
+ processAfter: '2026-01-01T00:00:00Z',
186
+ recurrence: '0 9 * * *',
187
+ platformId: null,
188
+ channelType: null,
189
+ threadId: null,
190
+ content: JSON.stringify({ prompt: 'p' }),
191
+ });
192
+
193
+ updateTask(db, 'task-1', { recurrence: null });
194
+
195
+ const row = db.prepare('SELECT recurrence FROM messages_in WHERE id = ?').get('task-1') as {
196
+ recurrence: string | null;
197
+ };
198
+ expect(row.recurrence).toBeNull();
199
+ });
200
+
201
+ it('reaches the live follow-up via series_id when called with the original id', () => {
202
+ const db = freshDb();
203
+ insertTask(db, {
204
+ id: 'task-orig',
205
+ processAfter: new Date().toISOString(),
206
+ recurrence: '0 9 * * *',
207
+ platformId: null,
208
+ channelType: null,
209
+ threadId: null,
210
+ content: JSON.stringify({ prompt: 'old' }),
211
+ });
212
+ db.prepare("UPDATE messages_in SET status = 'completed' WHERE id = 'task-orig'").run();
213
+
214
+ const msg: RecurringMessage = {
215
+ id: 'task-orig',
216
+ kind: 'task',
217
+ content: JSON.stringify({ prompt: 'old' }),
218
+ recurrence: '0 9 * * *',
219
+ process_after: null,
220
+ platform_id: null,
221
+ channel_type: null,
222
+ thread_id: null,
223
+ series_id: 'task-orig',
224
+ };
225
+ insertRecurrence(db, msg, 'task-next', new Date(Date.now() + 86400000).toISOString());
226
+
227
+ const touched = updateTask(db, 'task-orig', { prompt: 'new' });
228
+ // Only the live follow-up should be touched — completed rows are excluded.
229
+ expect(touched).toBe(1);
230
+
231
+ const live = db.prepare("SELECT content FROM messages_in WHERE id = 'task-next'").get() as { content: string };
232
+ expect(JSON.parse(live.content).prompt).toBe('new');
233
+
234
+ // Original (completed) row left alone.
235
+ const orig = db.prepare("SELECT content FROM messages_in WHERE id = 'task-orig'").get() as { content: string };
236
+ expect(JSON.parse(orig.content).prompt).toBe('old');
237
+ });
238
+
239
+ it('returns 0 when no live task matches', () => {
240
+ const db = freshDb();
241
+ insertTask(db, {
242
+ id: 'task-1',
243
+ processAfter: new Date().toISOString(),
244
+ recurrence: null,
245
+ platformId: null,
246
+ channelType: null,
247
+ threadId: null,
248
+ content: JSON.stringify({ prompt: 'p' }),
249
+ });
250
+ db.prepare("UPDATE messages_in SET status = 'completed' WHERE id = 'task-1'").run();
251
+
252
+ const touched = updateTask(db, 'task-1', { prompt: 'new' });
253
+ expect(touched).toBe(0);
254
+ });
255
+ });
256
+
257
+ describe('insertRecurrence', () => {
258
+ it('copies series_id forward', () => {
259
+ const db = freshDb();
260
+ insertBasicTask(db, 'task-orig', '0 9 * * *');
261
+ db.prepare("UPDATE messages_in SET status = 'completed' WHERE id = 'task-orig'").run();
262
+
263
+ const msg: RecurringMessage = {
264
+ id: 'task-orig',
265
+ kind: 'task',
266
+ content: '{}',
267
+ recurrence: '0 9 * * *',
268
+ process_after: null,
269
+ platform_id: null,
270
+ channel_type: null,
271
+ thread_id: null,
272
+ series_id: 'task-orig',
273
+ };
274
+ insertRecurrence(db, msg, 'task-next', new Date().toISOString());
275
+
276
+ const row = db.prepare('SELECT series_id FROM messages_in WHERE id = ?').get('task-next') as {
277
+ series_id: string;
278
+ };
279
+ expect(row.series_id).toBe('task-orig');
280
+ db.close();
281
+ });
282
+ });
@@ -0,0 +1,148 @@
1
+ /**
2
+ * Task DB helpers used by the scheduling module.
3
+ *
4
+ * Tasks are `messages_in` rows with `kind='task'`. This module doesn't own
5
+ * its own table — it piggybacks on the core schema. That's why there's no
6
+ * `module-scheduling-*.ts` migration file.
7
+ *
8
+ * cancel/pause/resume match any live row in the series, not just the exact id.
9
+ * Recurring tasks get a new row per occurrence (see handleRecurrence), all
10
+ * sharing series_id. Matching by id alone would only hit the completed row
11
+ * the agent remembers, missing the live next occurrence.
12
+ */
13
+ import type { Database } from '../../db/connection.js';
14
+
15
+ import { nextEvenSeq } from '../../db/session-db.js';
16
+
17
+ export function insertTask(
18
+ db: Database,
19
+ task: {
20
+ id: string;
21
+ processAfter: string;
22
+ recurrence: string | null;
23
+ platformId: string | null;
24
+ channelType: string | null;
25
+ threadId: string | null;
26
+ content: string;
27
+ },
28
+ ): void {
29
+ db.prepare(
30
+ `INSERT INTO messages_in (id, seq, timestamp, status, tries, process_after, recurrence, kind, platform_id, channel_type, thread_id, content, series_id)
31
+ VALUES (@id, @seq, datetime('now'), 'pending', 0, @processAfter, @recurrence, 'task', @platformId, @channelType, @threadId, @content, @id)`,
32
+ ).run({
33
+ ...task,
34
+ seq: nextEvenSeq(db),
35
+ });
36
+ }
37
+
38
+ export function cancelTask(db: Database, taskId: string): void {
39
+ db.prepare(
40
+ "UPDATE messages_in SET status = 'completed', recurrence = NULL WHERE (id = ? OR series_id = ?) AND kind = 'task' AND status IN ('pending', 'paused')",
41
+ ).run(taskId, taskId);
42
+ }
43
+
44
+ export function pauseTask(db: Database, taskId: string): void {
45
+ db.prepare(
46
+ "UPDATE messages_in SET status = 'paused' WHERE (id = ? OR series_id = ?) AND kind = 'task' AND status = 'pending'",
47
+ ).run(taskId, taskId);
48
+ }
49
+
50
+ export function resumeTask(db: Database, taskId: string): void {
51
+ db.prepare(
52
+ "UPDATE messages_in SET status = 'pending' WHERE (id = ? OR series_id = ?) AND kind = 'task' AND status = 'paused'",
53
+ ).run(taskId, taskId);
54
+ }
55
+
56
+ export interface TaskUpdate {
57
+ prompt?: string;
58
+ script?: string | null;
59
+ recurrence?: string | null;
60
+ processAfter?: string;
61
+ }
62
+
63
+ // Merges content JSON in-place so callers can update prompt/script without
64
+ // clobbering other fields. Matches by id OR series_id so the live next
65
+ // occurrence of a recurring task is updated, not just the completed row the
66
+ // agent last saw. Returns the number of rows touched.
67
+ export function updateTask(db: Database, taskId: string, update: TaskUpdate): number {
68
+ const rows = db
69
+ .prepare(
70
+ "SELECT id, content FROM messages_in WHERE (id = ? OR series_id = ?) AND kind = 'task' AND status IN ('pending', 'paused')",
71
+ )
72
+ .all(taskId, taskId) as Array<{ id: string; content: string }>;
73
+
74
+ if (rows.length === 0) return 0;
75
+
76
+ const setProcessAfter = update.processAfter !== undefined;
77
+ const setRecurrence = update.recurrence !== undefined;
78
+ const mergeContent = update.prompt !== undefined || update.script !== undefined;
79
+
80
+ const tx = db.transaction(() => {
81
+ for (const row of rows) {
82
+ let content = row.content;
83
+ if (mergeContent) {
84
+ const parsed = JSON.parse(row.content) as Record<string, unknown>;
85
+ if (update.prompt !== undefined) parsed.prompt = update.prompt;
86
+ if (update.script !== undefined) parsed.script = update.script;
87
+ content = JSON.stringify(parsed);
88
+ }
89
+
90
+ // Build SET clause dynamically so callers can update fields independently.
91
+ const sets: string[] = ['content = ?'];
92
+ const params: unknown[] = [content];
93
+ if (setProcessAfter) {
94
+ sets.push('process_after = ?');
95
+ params.push(update.processAfter);
96
+ }
97
+ if (setRecurrence) {
98
+ sets.push('recurrence = ?');
99
+ params.push(update.recurrence);
100
+ }
101
+ params.push(row.id);
102
+
103
+ db.prepare(`UPDATE messages_in SET ${sets.join(', ')} WHERE id = ?`).run(...params);
104
+ }
105
+ });
106
+ tx();
107
+ return rows.length;
108
+ }
109
+
110
+ export interface RecurringMessage {
111
+ id: string;
112
+ kind: string;
113
+ content: string;
114
+ recurrence: string;
115
+ process_after: string | null;
116
+ platform_id: string | null;
117
+ channel_type: string | null;
118
+ thread_id: string | null;
119
+ series_id: string;
120
+ }
121
+
122
+ export function getCompletedRecurring(db: Database): RecurringMessage[] {
123
+ return db
124
+ .prepare("SELECT * FROM messages_in WHERE status = 'completed' AND recurrence IS NOT NULL")
125
+ .all() as RecurringMessage[];
126
+ }
127
+
128
+ export function insertRecurrence(db: Database, msg: RecurringMessage, newId: string, nextRun: string | null): void {
129
+ db.prepare(
130
+ `INSERT INTO messages_in (id, seq, kind, timestamp, status, process_after, recurrence, platform_id, channel_type, thread_id, content, series_id)
131
+ VALUES (?, ?, ?, datetime('now'), 'pending', ?, ?, ?, ?, ?, ?, ?)`,
132
+ ).run(
133
+ newId,
134
+ nextEvenSeq(db),
135
+ msg.kind,
136
+ nextRun,
137
+ msg.recurrence,
138
+ msg.platform_id,
139
+ msg.channel_type,
140
+ msg.thread_id,
141
+ msg.content,
142
+ msg.series_id,
143
+ );
144
+ }
145
+
146
+ export function clearRecurrence(db: Database, messageId: string): void {
147
+ db.prepare('UPDATE messages_in SET recurrence = NULL WHERE id = ?').run(messageId);
148
+ }
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Scheduling module — one-shot and recurring tasks.
3
+ *
4
+ * Registers:
5
+ * - Five delivery action handlers: schedule_task, cancel_task, pause_task,
6
+ * resume_task, update_task. The container's scheduling MCP tools
7
+ * (container/agent-runner/src/mcp-tools/scheduling.ts) write system
8
+ * messages with these actions; the host applies them to inbound.db.
9
+ *
10
+ * Host integration points (filled by MODULE-HOOK markers, validated here
11
+ * with the scheduling module shipping inline):
12
+ * - `src/host-sweep.ts` → MODULE-HOOK:scheduling-recurrence calls
13
+ * `handleRecurrence` each sweep tick.
14
+ * - `container/agent-runner/src/poll-loop.ts` → MODULE-HOOK:scheduling-pre-task
15
+ * runs `applyPreTaskScripts` before the provider call so tasks carrying
16
+ * a pre-agent script can gate their own execution.
17
+ *
18
+ * No DB migration — tasks are `messages_in` rows with `kind='task'`, so the
19
+ * module piggybacks on the core schema.
20
+ */
21
+ import { registerDeliveryAction } from '../../delivery.js';
22
+ import {
23
+ handleCancelTask,
24
+ handlePauseTask,
25
+ handleResumeTask,
26
+ handleScheduleTask,
27
+ handleUpdateTask,
28
+ } from './actions.js';
29
+
30
+ registerDeliveryAction('schedule_task', handleScheduleTask);
31
+ registerDeliveryAction('cancel_task', handleCancelTask);
32
+ registerDeliveryAction('pause_task', handlePauseTask);
33
+ registerDeliveryAction('resume_task', handleResumeTask);
34
+ registerDeliveryAction('update_task', handleUpdateTask);
@@ -0,0 +1,98 @@
1
+ /**
2
+ * Tests for `handleRecurrence` — specifically the timezone-aware cron
3
+ * interpretation ported from v1 (src/v1/task-scheduler.ts).
4
+ *
5
+ * Core invariant: cron expressions are interpreted in the user's TIMEZONE,
6
+ * not UTC. Without this, `"0 9 * * *"` fires at 09:00 UTC instead of 09:00
7
+ * user-local — a recurring scheduling bug users can't diagnose.
8
+ */
9
+ import fs from 'fs';
10
+ import path from 'path';
11
+ import { afterEach, describe, expect, it } from 'vitest';
12
+
13
+ import { ensureSchema, openInboundDb } from '../../db/session-db.js';
14
+ import { insertTask } from './db.js';
15
+ import { handleRecurrence } from './recurrence.js';
16
+ import type { Session } from '../../types.js';
17
+
18
+ const TEST_DIR = '/tmp/paraclaw-recurrence-test';
19
+ const DB_PATH = path.join(TEST_DIR, 'inbound.db');
20
+
21
+ function freshDb() {
22
+ if (fs.existsSync(TEST_DIR)) fs.rmSync(TEST_DIR, { recursive: true });
23
+ fs.mkdirSync(TEST_DIR, { recursive: true });
24
+ ensureSchema(DB_PATH, 'inbound');
25
+ return openInboundDb(DB_PATH);
26
+ }
27
+
28
+ function fakeSession(): Session {
29
+ return {
30
+ id: 'sess-test',
31
+ agent_group_id: 'ag-test',
32
+ messaging_group_id: 'mg-test',
33
+ thread_id: null,
34
+ status: 'active',
35
+ created_at: new Date().toISOString(),
36
+ last_active: new Date().toISOString(),
37
+ container_status: 'stopped',
38
+ } as Session;
39
+ }
40
+
41
+ afterEach(() => {
42
+ if (fs.existsSync(TEST_DIR)) fs.rmSync(TEST_DIR, { recursive: true });
43
+ });
44
+
45
+ describe('handleRecurrence', () => {
46
+ it('clones a completed recurring task with a next-run in the future', async () => {
47
+ const db = freshDb();
48
+ insertTask(db, {
49
+ id: 'task-1',
50
+ processAfter: '2020-01-01T00:00:00.000Z',
51
+ recurrence: '0 9 * * *', // every day at 09:00 (user TZ)
52
+ platformId: null,
53
+ channelType: null,
54
+ threadId: null,
55
+ content: JSON.stringify({ prompt: 'daily digest' }),
56
+ });
57
+ db.prepare(`UPDATE messages_in SET status='completed' WHERE id='task-1'`).run();
58
+
59
+ await handleRecurrence(db, fakeSession());
60
+
61
+ const rows = db
62
+ .prepare(`SELECT id, status, process_after, recurrence, series_id FROM messages_in ORDER BY seq`)
63
+ .all() as Array<{
64
+ id: string;
65
+ status: string;
66
+ process_after: string;
67
+ recurrence: string | null;
68
+ series_id: string;
69
+ }>;
70
+ expect(rows).toHaveLength(2);
71
+ const original = rows.find((r) => r.id === 'task-1')!;
72
+ const follow = rows.find((r) => r.id !== 'task-1')!;
73
+ expect(original.recurrence).toBeNull();
74
+ expect(follow.status).toBe('pending');
75
+ expect(follow.recurrence).toBe('0 9 * * *');
76
+ expect(follow.series_id).toBe('task-1');
77
+ expect(new Date(follow.process_after).getTime()).toBeGreaterThan(Date.now());
78
+ });
79
+
80
+ it('does not clone rows whose recurrence is already cleared', async () => {
81
+ const db = freshDb();
82
+ insertTask(db, {
83
+ id: 'task-1',
84
+ processAfter: '2020-01-01T00:00:00.000Z',
85
+ recurrence: null,
86
+ platformId: null,
87
+ channelType: null,
88
+ threadId: null,
89
+ content: JSON.stringify({ prompt: 'one-off' }),
90
+ });
91
+ db.prepare(`UPDATE messages_in SET status='completed' WHERE id='task-1'`).run();
92
+
93
+ await handleRecurrence(db, fakeSession());
94
+
95
+ const count = (db.prepare(`SELECT COUNT(*) AS c FROM messages_in`).get() as { c: number }).c;
96
+ expect(count).toBe(1);
97
+ });
98
+ });