@openparachute/agent 0.1.1 → 0.2.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 (598) hide show
  1. package/.parachute/module.json +124 -8
  2. package/LICENSE +2 -16
  3. package/README.md +118 -166
  4. package/package.json +32 -43
  5. package/scripts/spawn-agent.ts +371 -0
  6. package/src/_parked/interactive-spawn.test.ts +324 -0
  7. package/src/_parked/interactive-spawn.ts +701 -0
  8. package/src/agent-defs.test.ts +1504 -0
  9. package/src/agent-defs.ts +1702 -0
  10. package/src/agent-mcp-config.test.ts +115 -0
  11. package/src/agent-mcp-config.ts +115 -0
  12. package/src/agents.test.ts +360 -0
  13. package/src/agents.ts +379 -0
  14. package/src/auth.test.ts +46 -0
  15. package/src/auth.ts +140 -0
  16. package/src/backends/attached-queue.test.ts +376 -0
  17. package/src/backends/attached-queue.ts +372 -0
  18. package/src/backends/programmatic.test.ts +1715 -0
  19. package/src/backends/programmatic.ts +927 -0
  20. package/src/backends/registry.test.ts +1494 -0
  21. package/src/backends/registry.ts +1202 -0
  22. package/src/backends/stream-json.test.ts +570 -0
  23. package/src/backends/stream-json.ts +392 -0
  24. package/src/backends/types.ts +223 -0
  25. package/src/bridge.ts +417 -0
  26. package/src/channel-backend-wiring.test.ts +237 -0
  27. package/src/credentials.test.ts +274 -0
  28. package/src/credentials.ts +380 -0
  29. package/src/cron.test.ts +342 -0
  30. package/src/cron.ts +380 -0
  31. package/src/daemon-agent-def-api.test.ts +166 -0
  32. package/src/daemon-agent-defs-api.test.ts +953 -0
  33. package/src/daemon-agent-env-api.test.ts +338 -0
  34. package/src/daemon-attached-queue-store.test.ts +65 -0
  35. package/src/daemon-config-api.test.ts +962 -0
  36. package/src/daemon-jobs-api.test.ts +271 -0
  37. package/src/daemon-vault-chat.test.ts +250 -0
  38. package/src/daemon.test.ts +746 -0
  39. package/src/daemon.ts +3314 -0
  40. package/src/def-vaults.test.ts +136 -0
  41. package/src/def-vaults.ts +165 -0
  42. package/src/delivery-state.test.ts +110 -0
  43. package/src/delivery-state.ts +154 -0
  44. package/src/effective-env.test.ts +114 -0
  45. package/src/effective-env.ts +184 -0
  46. package/src/env-compat.ts +39 -0
  47. package/src/grants.test.ts +638 -0
  48. package/src/grants.ts +675 -0
  49. package/src/hub-jwt.test.ts +161 -0
  50. package/src/hub-jwt.ts +182 -0
  51. package/src/jobs.test.ts +245 -0
  52. package/src/jobs.ts +266 -0
  53. package/src/mcp-http.test.ts +265 -0
  54. package/src/mcp-http.ts +771 -0
  55. package/src/mint-token.test.ts +152 -0
  56. package/src/mint-token.ts +139 -0
  57. package/src/module-manifest.test.ts +158 -0
  58. package/src/oauth-discovery.ts +134 -0
  59. package/src/programmatic-wiring.test.ts +838 -0
  60. package/src/registry.test.ts +227 -0
  61. package/src/registry.ts +228 -0
  62. package/src/resolve-port.test.ts +64 -0
  63. package/src/routing.test.ts +184 -0
  64. package/src/routing.ts +76 -0
  65. package/src/runner.test.ts +506 -0
  66. package/src/runner.ts +255 -0
  67. package/src/sandbox/config.test.ts +150 -0
  68. package/src/sandbox/config.ts +102 -0
  69. package/src/sandbox/egress.test.ts +113 -0
  70. package/src/sandbox/egress.ts +123 -0
  71. package/src/sandbox/index.ts +180 -0
  72. package/src/sandbox/live-seatbelt.test.ts +277 -0
  73. package/src/sandbox/mounts.test.ts +154 -0
  74. package/src/sandbox/mounts.ts +133 -0
  75. package/src/sandbox/sandbox.test.ts +168 -0
  76. package/src/sandbox/types.ts +382 -0
  77. package/src/services-manifest.test.ts +106 -0
  78. package/src/services-manifest.ts +95 -0
  79. package/src/spa-serve.test.ts +116 -0
  80. package/src/spa-serve.ts +116 -0
  81. package/src/spawn-agent-cli.test.ts +172 -0
  82. package/src/spawn-agent.test.ts +1218 -0
  83. package/src/spawn-agent.ts +569 -0
  84. package/src/spawn-deps.test.ts +54 -0
  85. package/src/spawn-deps.ts +166 -0
  86. package/src/telegram/api.ts +153 -0
  87. package/src/terminal-assets.test.ts +50 -0
  88. package/src/terminal-assets.ts +79 -0
  89. package/src/terminal-ui.ts +305 -0
  90. package/src/terminal.test.ts +530 -0
  91. package/src/terminal.ts +458 -0
  92. package/src/transport.ts +270 -0
  93. package/src/transports/http-ui.test.ts +455 -0
  94. package/src/transports/http-ui.ts +201 -0
  95. package/src/transports/telegram.test.ts +174 -0
  96. package/src/transports/telegram.ts +426 -0
  97. package/src/transports/vault.test.ts +2011 -0
  98. package/src/transports/vault.ts +1790 -0
  99. package/src/ui-kit.test.ts +178 -0
  100. package/src/ui-kit.ts +402 -0
  101. package/tsconfig.json +8 -14
  102. package/web/ui/tsconfig.json +2 -1
  103. package/.claude/scheduled_tasks.lock +0 -1
  104. package/.claude/settings.json +0 -5
  105. package/.claude/skills/add-atomic-chat-tool/SKILL.md +0 -243
  106. package/.claude/skills/add-atomic-chat-tool/atomic-chat-mcp-stdio.ts +0 -229
  107. package/.claude/skills/add-codex/SKILL.md +0 -161
  108. package/.claude/skills/add-dashboard/SKILL.md +0 -138
  109. package/.claude/skills/add-dashboard/resources/dashboard-pusher.ts +0 -495
  110. package/.claude/skills/add-emacs/SKILL.md +0 -296
  111. package/.claude/skills/add-gcal-tool/SKILL.md +0 -210
  112. package/.claude/skills/add-gchat/REMOVE.md +0 -6
  113. package/.claude/skills/add-gchat/SKILL.md +0 -92
  114. package/.claude/skills/add-gchat/VERIFY.md +0 -3
  115. package/.claude/skills/add-github/REMOVE.md +0 -6
  116. package/.claude/skills/add-github/SKILL.md +0 -148
  117. package/.claude/skills/add-github/VERIFY.md +0 -3
  118. package/.claude/skills/add-gmail-tool/SKILL.md +0 -229
  119. package/.claude/skills/add-imessage/REMOVE.md +0 -6
  120. package/.claude/skills/add-imessage/SKILL.md +0 -113
  121. package/.claude/skills/add-imessage/VERIFY.md +0 -3
  122. package/.claude/skills/add-karpathy-llm-wiki/SKILL.md +0 -110
  123. package/.claude/skills/add-karpathy-llm-wiki/llm-wiki.md +0 -75
  124. package/.claude/skills/add-linear/REMOVE.md +0 -6
  125. package/.claude/skills/add-linear/SKILL.md +0 -168
  126. package/.claude/skills/add-linear/VERIFY.md +0 -3
  127. package/.claude/skills/add-macos-statusbar/SKILL.md +0 -133
  128. package/.claude/skills/add-macos-statusbar/add/src/statusbar.swift +0 -147
  129. package/.claude/skills/add-matrix/REMOVE.md +0 -6
  130. package/.claude/skills/add-matrix/SKILL.md +0 -148
  131. package/.claude/skills/add-matrix/VERIFY.md +0 -3
  132. package/.claude/skills/add-ollama-provider/SKILL.md +0 -179
  133. package/.claude/skills/add-ollama-tool/SKILL.md +0 -193
  134. package/.claude/skills/add-opencode/SKILL.md +0 -229
  135. package/.claude/skills/add-parallel/SKILL.md +0 -290
  136. package/.claude/skills/add-resend/REMOVE.md +0 -6
  137. package/.claude/skills/add-resend/SKILL.md +0 -93
  138. package/.claude/skills/add-resend/VERIFY.md +0 -3
  139. package/.claude/skills/add-signal/REMOVE.md +0 -13
  140. package/.claude/skills/add-signal/SKILL.md +0 -318
  141. package/.claude/skills/add-signal/VERIFY.md +0 -5
  142. package/.claude/skills/add-slack/REMOVE.md +0 -6
  143. package/.claude/skills/add-slack/SKILL.md +0 -112
  144. package/.claude/skills/add-slack/VERIFY.md +0 -3
  145. package/.claude/skills/add-teams/REMOVE.md +0 -6
  146. package/.claude/skills/add-teams/SKILL.md +0 -207
  147. package/.claude/skills/add-teams/VERIFY.md +0 -3
  148. package/.claude/skills/add-vercel/SKILL.md +0 -147
  149. package/.claude/skills/add-vercel/container-skills/vercel-cli/SKILL.md +0 -103
  150. package/.claude/skills/add-webex/REMOVE.md +0 -6
  151. package/.claude/skills/add-webex/SKILL.md +0 -88
  152. package/.claude/skills/add-webex/VERIFY.md +0 -3
  153. package/.claude/skills/add-wechat/REMOVE.md +0 -49
  154. package/.claude/skills/add-wechat/SKILL.md +0 -170
  155. package/.claude/skills/add-wechat/scripts/wire-dm.ts +0 -172
  156. package/.claude/skills/add-whatsapp/SKILL.md +0 -264
  157. package/.claude/skills/add-whatsapp-cloud/REMOVE.md +0 -6
  158. package/.claude/skills/add-whatsapp-cloud/SKILL.md +0 -95
  159. package/.claude/skills/add-whatsapp-cloud/VERIFY.md +0 -3
  160. package/.claude/skills/claw/SKILL.md +0 -131
  161. package/.claude/skills/claw/scripts/claw +0 -374
  162. package/.claude/skills/convert-to-apple-container/SKILL.md +0 -212
  163. package/.claude/skills/customize/SKILL.md +0 -110
  164. package/.claude/skills/debug/SKILL.md +0 -349
  165. package/.claude/skills/get-qodo-rules/SKILL.md +0 -122
  166. package/.claude/skills/get-qodo-rules/references/output-format.md +0 -41
  167. package/.claude/skills/get-qodo-rules/references/pagination.md +0 -33
  168. package/.claude/skills/get-qodo-rules/references/repository-scope.md +0 -26
  169. package/.claude/skills/init-first-agent/SKILL.md +0 -120
  170. package/.claude/skills/init-onecli/SKILL.md +0 -270
  171. package/.claude/skills/manage-channels/SKILL.md +0 -87
  172. package/.claude/skills/manage-mounts/SKILL.md +0 -47
  173. package/.claude/skills/migrate-from-openclaw/MIGRATE_CRONS.md +0 -100
  174. package/.claude/skills/migrate-from-openclaw/SKILL.md +0 -447
  175. package/.claude/skills/migrate-from-openclaw/scripts/discover-openclaw.ts +0 -734
  176. package/.claude/skills/migrate-from-openclaw/scripts/extract-channel-credentials.ts +0 -476
  177. package/.claude/skills/migrate-nanoclaw/SKILL.md +0 -484
  178. package/.claude/skills/migrate-nanoclaw/diagnostics.md +0 -51
  179. package/.claude/skills/qodo-pr-resolver/SKILL.md +0 -326
  180. package/.claude/skills/qodo-pr-resolver/resources/providers.md +0 -329
  181. package/.claude/skills/update-nanoclaw/SKILL.md +0 -243
  182. package/.claude/skills/update-nanoclaw/diagnostics.md +0 -48
  183. package/.claude/skills/update-skills/SKILL.md +0 -130
  184. package/.claude/skills/use-native-credential-proxy/SKILL.md +0 -167
  185. package/.claude/skills/x-integration/SKILL.md +0 -417
  186. package/.claude/skills/x-integration/agent.ts +0 -243
  187. package/.claude/skills/x-integration/host.ts +0 -155
  188. package/.claude/skills/x-integration/lib/browser.ts +0 -148
  189. package/.claude/skills/x-integration/lib/config.ts +0 -62
  190. package/.claude/skills/x-integration/scripts/like.ts +0 -56
  191. package/.claude/skills/x-integration/scripts/post.ts +0 -66
  192. package/.claude/skills/x-integration/scripts/quote.ts +0 -80
  193. package/.claude/skills/x-integration/scripts/reply.ts +0 -74
  194. package/.claude/skills/x-integration/scripts/retweet.ts +0 -62
  195. package/.claude/skills/x-integration/scripts/setup.ts +0 -87
  196. package/.github/CODEOWNERS +0 -10
  197. package/.github/PULL_REQUEST_TEMPLATE.md +0 -18
  198. package/.github/workflows/bump-version.yml +0 -35
  199. package/.github/workflows/ci.yml +0 -39
  200. package/.github/workflows/label-pr.yml +0 -40
  201. package/.github/workflows/update-tokens.yml +0 -43
  202. package/.husky/pre-commit +0 -1
  203. package/.mcp.json +0 -3
  204. package/.nvmrc +0 -1
  205. package/.prettierrc +0 -4
  206. package/CHANGELOG.md +0 -221
  207. package/CLAUDE.md +0 -307
  208. package/CODE_OF_CONDUCT.md +0 -128
  209. package/CONTRIBUTING.md +0 -159
  210. package/CONTRIBUTORS.md +0 -26
  211. package/LICENSE-NANOCLAW-MIT +0 -21
  212. package/README_ja.md +0 -194
  213. package/README_zh.md +0 -194
  214. package/assets/nanoclaw-favicon.png +0 -0
  215. package/assets/nanoclaw-icon.png +0 -0
  216. package/assets/nanoclaw-logo-dark.png +0 -0
  217. package/assets/nanoclaw-logo.png +0 -0
  218. package/assets/nanoclaw-profile.jpeg +0 -0
  219. package/assets/nanoclaw-sales.png +0 -0
  220. package/assets/social-preview.jpg +0 -0
  221. package/config-examples/mount-allowlist.json +0 -25
  222. package/container/.dockerignore +0 -2
  223. package/container/CLAUDE.md +0 -21
  224. package/container/Dockerfile +0 -121
  225. package/container/agent-runner/bun.lock +0 -243
  226. package/container/agent-runner/package.json +0 -22
  227. package/container/agent-runner/scripts/sdk-signal-probe.ts +0 -169
  228. package/container/agent-runner/src/config.ts +0 -55
  229. package/container/agent-runner/src/db/connection.ts +0 -267
  230. package/container/agent-runner/src/db/index.ts +0 -20
  231. package/container/agent-runner/src/db/messages-in.ts +0 -138
  232. package/container/agent-runner/src/db/messages-out.ts +0 -143
  233. package/container/agent-runner/src/db/session-routing.ts +0 -30
  234. package/container/agent-runner/src/db/session-state.test.ts +0 -100
  235. package/container/agent-runner/src/db/session-state.ts +0 -79
  236. package/container/agent-runner/src/destinations.ts +0 -135
  237. package/container/agent-runner/src/formatter.test.ts +0 -167
  238. package/container/agent-runner/src/formatter.ts +0 -260
  239. package/container/agent-runner/src/index.ts +0 -110
  240. package/container/agent-runner/src/integration.test.ts +0 -121
  241. package/container/agent-runner/src/mcp-tools/agents.instructions.md +0 -26
  242. package/container/agent-runner/src/mcp-tools/agents.ts +0 -66
  243. package/container/agent-runner/src/mcp-tools/core.instructions.md +0 -27
  244. package/container/agent-runner/src/mcp-tools/core.ts +0 -262
  245. package/container/agent-runner/src/mcp-tools/index.ts +0 -22
  246. package/container/agent-runner/src/mcp-tools/interactive.instructions.md +0 -22
  247. package/container/agent-runner/src/mcp-tools/interactive.ts +0 -169
  248. package/container/agent-runner/src/mcp-tools/scheduling.instructions.md +0 -40
  249. package/container/agent-runner/src/mcp-tools/scheduling.ts +0 -299
  250. package/container/agent-runner/src/mcp-tools/self-mod.instructions.md +0 -25
  251. package/container/agent-runner/src/mcp-tools/self-mod.ts +0 -120
  252. package/container/agent-runner/src/mcp-tools/server.ts +0 -54
  253. package/container/agent-runner/src/mcp-tools/types.ts +0 -6
  254. package/container/agent-runner/src/poll-loop.test.ts +0 -248
  255. package/container/agent-runner/src/poll-loop.ts +0 -437
  256. package/container/agent-runner/src/providers/claude.ts +0 -379
  257. package/container/agent-runner/src/providers/factory.test.ts +0 -19
  258. package/container/agent-runner/src/providers/factory.ts +0 -13
  259. package/container/agent-runner/src/providers/index.ts +0 -6
  260. package/container/agent-runner/src/providers/mock.ts +0 -77
  261. package/container/agent-runner/src/providers/provider-registry.ts +0 -33
  262. package/container/agent-runner/src/providers/types.ts +0 -82
  263. package/container/agent-runner/src/scheduling/task-script.ts +0 -121
  264. package/container/agent-runner/src/timezone.test.ts +0 -93
  265. package/container/agent-runner/src/timezone.ts +0 -107
  266. package/container/agent-runner/tsconfig.json +0 -14
  267. package/container/build.sh +0 -48
  268. package/container/entrypoint.sh +0 -16
  269. package/container/skills/agent-browser/SKILL.md +0 -159
  270. package/container/skills/frontend-engineer/SKILL.md +0 -157
  271. package/container/skills/self-customize/SKILL.md +0 -87
  272. package/container/skills/slack-formatting/SKILL.md +0 -94
  273. package/container/skills/vercel-cli/SKILL.md +0 -111
  274. package/container/skills/welcome/SKILL.md +0 -85
  275. package/docs/APPLE-CONTAINER-NETWORKING.md +0 -90
  276. package/docs/BRANCH-FORK-MAINTENANCE.md +0 -81
  277. package/docs/README.md +0 -25
  278. package/docs/SDK_DEEP_DIVE.md +0 -643
  279. package/docs/SECURITY.md +0 -162
  280. package/docs/agent-runner-details.md +0 -749
  281. package/docs/api-details.md +0 -365
  282. package/docs/architecture-diagram.html +0 -422
  283. package/docs/architecture-diagram.md +0 -215
  284. package/docs/architecture.md +0 -751
  285. package/docs/audit/2026-04-30-channel-endpoint-audit.md +0 -36
  286. package/docs/build-and-runtime.md +0 -80
  287. package/docs/cross-mount-stress/README.md +0 -112
  288. package/docs/cross-mount-stress/container-writer-retry.mjs +0 -55
  289. package/docs/cross-mount-stress/container-writer-slow.mjs +0 -42
  290. package/docs/cross-mount-stress/container-writer.mjs +0 -47
  291. package/docs/cross-mount-stress/host-writer-retry.mjs +0 -55
  292. package/docs/cross-mount-stress/host-writer-slow.mjs +0 -43
  293. package/docs/cross-mount-stress/host-writer.mjs +0 -47
  294. package/docs/db-central.md +0 -316
  295. package/docs/db-session.md +0 -183
  296. package/docs/db.md +0 -119
  297. package/docs/design/2026-04-29-vault-management-ui.md +0 -231
  298. package/docs/design/2026-04-30-channel-wiring-rework.md +0 -234
  299. package/docs/design/2026-05-01-channel-wiring-approvals-deep-dive.md +0 -272
  300. package/docs/design/2026-05-02-channel-policy-and-approval-routing.md +0 -250
  301. package/docs/docker-sandboxes.md +0 -359
  302. package/docs/isolation-model.md +0 -88
  303. package/docs/ollama.md +0 -79
  304. package/docs/parachute-integration.md +0 -109
  305. package/docs/post-night-rebirth-reflections.md +0 -151
  306. package/eslint.config.js +0 -32
  307. package/pnpm-workspace.yaml +0 -8
  308. package/repo-tokens/README.md +0 -113
  309. package/repo-tokens/action.yml +0 -186
  310. package/repo-tokens/badge.svg +0 -23
  311. package/repo-tokens/examples/green.svg +0 -14
  312. package/repo-tokens/examples/red.svg +0 -14
  313. package/repo-tokens/examples/yellow-green.svg +0 -14
  314. package/repo-tokens/examples/yellow.svg +0 -14
  315. package/scripts/chat.ts +0 -101
  316. package/scripts/cleanup-sessions.sh +0 -150
  317. package/scripts/init-cli-agent.ts +0 -171
  318. package/scripts/init-first-agent.ts +0 -377
  319. package/scripts/parachute.ts +0 -158
  320. package/scripts/run-migrations.ts +0 -105
  321. package/scripts/sanity-live-poll.ts +0 -95
  322. package/scripts/seed-discord.ts +0 -79
  323. package/scripts/test-v2-agent.ts +0 -106
  324. package/scripts/test-v2-channel-e2e.ts +0 -265
  325. package/scripts/test-v2-host.ts +0 -184
  326. package/src/channels/adapter.ts +0 -214
  327. package/src/channels/ask-question.ts +0 -46
  328. package/src/channels/channel-registry.test.ts +0 -421
  329. package/src/channels/channel-registry.ts +0 -313
  330. package/src/channels/chat-sdk-bridge.test.ts +0 -84
  331. package/src/channels/chat-sdk-bridge.ts +0 -652
  332. package/src/channels/cli.ts +0 -276
  333. package/src/channels/discord.ts +0 -90
  334. package/src/channels/index.ts +0 -17
  335. package/src/channels/telegram-markdown-sanitize.test.ts +0 -78
  336. package/src/channels/telegram-markdown-sanitize.ts +0 -55
  337. package/src/channels/telegram-pairing.test.ts +0 -254
  338. package/src/channels/telegram-pairing.ts +0 -339
  339. package/src/channels/telegram.ts +0 -279
  340. package/src/channels/trust-hint.test.ts +0 -48
  341. package/src/channels/trust-hint.ts +0 -75
  342. package/src/claude-md-compose.migrate.test.ts +0 -64
  343. package/src/claude-md-compose.ts +0 -205
  344. package/src/command-gate.ts +0 -63
  345. package/src/config.test.ts +0 -93
  346. package/src/config.ts +0 -108
  347. package/src/container-config.ts +0 -167
  348. package/src/container-runner.test.ts +0 -32
  349. package/src/container-runner.ts +0 -576
  350. package/src/container-runtime.test.ts +0 -169
  351. package/src/container-runtime.ts +0 -92
  352. package/src/db/_bun-sqlite-shim.ts +0 -88
  353. package/src/db/agent-activity.test.ts +0 -155
  354. package/src/db/agent-activity.ts +0 -121
  355. package/src/db/agent-groups.ts +0 -77
  356. package/src/db/connection.migrate.test.ts +0 -143
  357. package/src/db/connection.ts +0 -224
  358. package/src/db/db-v2.test.ts +0 -440
  359. package/src/db/dropped-messages.ts +0 -44
  360. package/src/db/index.ts +0 -40
  361. package/src/db/messaging-groups.ts +0 -252
  362. package/src/db/migrations/001-initial.ts +0 -112
  363. package/src/db/migrations/002-chat-sdk-state.ts +0 -36
  364. package/src/db/migrations/008-dropped-messages.ts +0 -27
  365. package/src/db/migrations/009-drop-pending-credentials.ts +0 -13
  366. package/src/db/migrations/010-engage-modes.ts +0 -103
  367. package/src/db/migrations/011-pending-sender-approvals.ts +0 -40
  368. package/src/db/migrations/012-channel-registration.ts +0 -48
  369. package/src/db/migrations/013-approval-render-metadata.ts +0 -27
  370. package/src/db/migrations/014-secrets.ts +0 -44
  371. package/src/db/migrations/015-secrets-drop-host-pattern.ts +0 -18
  372. package/src/db/migrations/016-secret-assignments.ts +0 -30
  373. package/src/db/migrations/017-agent-activity.ts +0 -40
  374. package/src/db/migrations/018-oauth-app-configs.ts +0 -34
  375. package/src/db/migrations/019-oauth-app-connections.ts +0 -48
  376. package/src/db/migrations/020-agent-app-connections.ts +0 -28
  377. package/src/db/migrations/021-pending-oauth-states.ts +0 -35
  378. package/src/db/migrations/022-app-connections-provider.ts +0 -25
  379. package/src/db/migrations/023-agent-group-secret-mode.test.ts +0 -124
  380. package/src/db/migrations/023-agent-group-secret-mode.ts +0 -65
  381. package/src/db/migrations/024-collapse-approvals.test.ts +0 -249
  382. package/src/db/migrations/024-collapse-approvals.ts +0 -182
  383. package/src/db/migrations/025-secret-mode-check.test.ts +0 -155
  384. package/src/db/migrations/025-secret-mode-check.ts +0 -49
  385. package/src/db/migrations/026-user-dms-bot-id.test.ts +0 -116
  386. package/src/db/migrations/026-user-dms-bot-id.ts +0 -54
  387. package/src/db/migrations/027-provider-credentials.ts +0 -41
  388. package/src/db/migrations/_test-helpers.ts +0 -41
  389. package/src/db/migrations/index.ts +0 -127
  390. package/src/db/migrations/module-agent-to-agent-destinations.ts +0 -84
  391. package/src/db/migrations/module-approvals-pending-approvals.ts +0 -42
  392. package/src/db/migrations/module-approvals-title-options.ts +0 -40
  393. package/src/db/schema.ts +0 -258
  394. package/src/db/session-db.test.ts +0 -93
  395. package/src/db/session-db.ts +0 -325
  396. package/src/db/sessions.ts +0 -241
  397. package/src/delivery.test.ts +0 -148
  398. package/src/delivery.ts +0 -445
  399. package/src/env.ts +0 -74
  400. package/src/group-folder.test.ts +0 -35
  401. package/src/group-folder.ts +0 -44
  402. package/src/group-init.ts +0 -92
  403. package/src/host-core.test.ts +0 -456
  404. package/src/host-sweep.test.ts +0 -146
  405. package/src/host-sweep.ts +0 -287
  406. package/src/index.ts +0 -227
  407. package/src/install-slug.ts +0 -33
  408. package/src/log.test.ts +0 -81
  409. package/src/log.ts +0 -117
  410. package/src/mcp/http.ts +0 -72
  411. package/src/mcp/server.ts +0 -92
  412. package/src/mcp/stdio.ts +0 -51
  413. package/src/mcp/tools/activity.ts +0 -88
  414. package/src/mcp/tools/agent-groups.ts +0 -183
  415. package/src/mcp/tools/approvals.ts +0 -122
  416. package/src/mcp/tools/channels.ts +0 -199
  417. package/src/mcp/tools/index.ts +0 -27
  418. package/src/mcp/tools/oauth.ts +0 -48
  419. package/src/mcp/tools/secrets.ts +0 -169
  420. package/src/mcp/tools/sessions.ts +0 -135
  421. package/src/mcp/types.ts +0 -51
  422. package/src/modules/agent-to-agent/agent-route.test.ts +0 -46
  423. package/src/modules/agent-to-agent/agent-route.ts +0 -223
  424. package/src/modules/agent-to-agent/create-agent.ts +0 -127
  425. package/src/modules/agent-to-agent/db/agent-destinations.ts +0 -135
  426. package/src/modules/agent-to-agent/index.ts +0 -22
  427. package/src/modules/agent-to-agent/write-destinations.ts +0 -59
  428. package/src/modules/approvals/agent.md +0 -45
  429. package/src/modules/approvals/index.ts +0 -21
  430. package/src/modules/approvals/picks.test.ts +0 -291
  431. package/src/modules/approvals/primitive.ts +0 -279
  432. package/src/modules/approvals/project.md +0 -27
  433. package/src/modules/approvals/response-handler.ts +0 -87
  434. package/src/modules/index.ts +0 -24
  435. package/src/modules/interactive/agent.md +0 -21
  436. package/src/modules/interactive/index.ts +0 -69
  437. package/src/modules/interactive/project.md +0 -12
  438. package/src/modules/mount-security/index.ts +0 -448
  439. package/src/modules/mount-security/migrate.test.ts +0 -91
  440. package/src/modules/permissions/access.ts +0 -28
  441. package/src/modules/permissions/channel-approval.test.ts +0 -389
  442. package/src/modules/permissions/channel-approval.ts +0 -188
  443. package/src/modules/permissions/db/agent-group-members.ts +0 -44
  444. package/src/modules/permissions/db/pending-channel-approvals.test.ts +0 -86
  445. package/src/modules/permissions/db/pending-channel-approvals.ts +0 -66
  446. package/src/modules/permissions/db/pending-sender-approvals.ts +0 -60
  447. package/src/modules/permissions/db/user-dms.ts +0 -58
  448. package/src/modules/permissions/db/user-roles.ts +0 -85
  449. package/src/modules/permissions/db/users.ts +0 -38
  450. package/src/modules/permissions/index.ts +0 -421
  451. package/src/modules/permissions/permissions.test.ts +0 -358
  452. package/src/modules/permissions/sender-approval.test.ts +0 -470
  453. package/src/modules/permissions/sender-approval.ts +0 -165
  454. package/src/modules/permissions/user-dm.ts +0 -200
  455. package/src/modules/provider-credentials/db.ts +0 -121
  456. package/src/modules/provider-credentials/index.ts +0 -12
  457. package/src/modules/provider-credentials/spawn.test.ts +0 -206
  458. package/src/modules/provider-credentials/spawn.ts +0 -114
  459. package/src/modules/scheduling/actions.ts +0 -113
  460. package/src/modules/scheduling/db.test.ts +0 -282
  461. package/src/modules/scheduling/db.ts +0 -148
  462. package/src/modules/scheduling/index.ts +0 -34
  463. package/src/modules/scheduling/recurrence.test.ts +0 -98
  464. package/src/modules/scheduling/recurrence.ts +0 -54
  465. package/src/modules/self-mod/agent.md +0 -30
  466. package/src/modules/self-mod/apply.ts +0 -85
  467. package/src/modules/self-mod/index.ts +0 -30
  468. package/src/modules/self-mod/project.md +0 -39
  469. package/src/modules/self-mod/request.ts +0 -91
  470. package/src/modules/typing/index.ts +0 -165
  471. package/src/oauth/agent-app-connections.ts +0 -103
  472. package/src/oauth/app-configs.test.ts +0 -64
  473. package/src/oauth/app-configs.ts +0 -114
  474. package/src/oauth/app-connections.test.ts +0 -109
  475. package/src/oauth/app-connections.ts +0 -178
  476. package/src/oauth/crypto.ts +0 -56
  477. package/src/oauth/flow.ts +0 -104
  478. package/src/oauth/providers/google.test.ts +0 -38
  479. package/src/oauth/providers/google.ts +0 -46
  480. package/src/oauth/providers/index.ts +0 -48
  481. package/src/oauth/state-store.test.ts +0 -54
  482. package/src/oauth/state-store.ts +0 -93
  483. package/src/parachute/README.md +0 -27
  484. package/src/parachute/create-agent.test.ts +0 -83
  485. package/src/parachute/create-agent.ts +0 -122
  486. package/src/parachute/group-status.test.ts +0 -165
  487. package/src/parachute/group-status.ts +0 -136
  488. package/src/parachute/types.ts +0 -41
  489. package/src/parachute/vault-mcp.test.ts +0 -251
  490. package/src/parachute/vault-mcp.ts +0 -232
  491. package/src/platform-id.test.ts +0 -104
  492. package/src/platform-id.ts +0 -109
  493. package/src/providers/index.ts +0 -6
  494. package/src/providers/provider-container-registry.ts +0 -58
  495. package/src/response-registry.ts +0 -45
  496. package/src/router.ts +0 -530
  497. package/src/secrets/crypto.test.ts +0 -45
  498. package/src/secrets/crypto.ts +0 -55
  499. package/src/secrets/index.ts +0 -355
  500. package/src/secrets/master-key.ts +0 -70
  501. package/src/secrets/secrets.test.ts +0 -354
  502. package/src/session-manager.migrate.test.ts +0 -59
  503. package/src/session-manager.ts +0 -433
  504. package/src/startup-bootstrap.test.ts +0 -226
  505. package/src/startup-bootstrap.ts +0 -207
  506. package/src/state-sqlite.ts +0 -182
  507. package/src/timezone.test.ts +0 -64
  508. package/src/timezone.ts +0 -37
  509. package/src/types.ts +0 -230
  510. package/src/web/auth.test.ts +0 -335
  511. package/src/web/auth.ts +0 -214
  512. package/src/web/discord-validate.test.ts +0 -77
  513. package/src/web/discord-validate.ts +0 -88
  514. package/src/web/hub-discovery.test.ts +0 -98
  515. package/src/web/hub-discovery.ts +0 -69
  516. package/src/web/routes/activity.ts +0 -106
  517. package/src/web/routes/agent-provider.test.ts +0 -282
  518. package/src/web/routes/agent-provider.ts +0 -309
  519. package/src/web/routes/approvals.ts +0 -185
  520. package/src/web/routes/apps.ts +0 -434
  521. package/src/web/routes/channels-mg-detail.test.ts +0 -324
  522. package/src/web/routes/channels-mga-detail.test.ts +0 -425
  523. package/src/web/routes/channels.ts +0 -489
  524. package/src/web/routes/oauth-providers.ts +0 -42
  525. package/src/web/routes/secrets.test.ts +0 -175
  526. package/src/web/routes/secrets.ts +0 -282
  527. package/src/web/routes/sessions.ts +0 -123
  528. package/src/web/routes/settings.test.ts +0 -106
  529. package/src/web/routes/settings.ts +0 -247
  530. package/src/web/routes/setup-status.ts +0 -205
  531. package/src/web/routes/vaults.test.ts +0 -389
  532. package/src/web/routes/vaults.ts +0 -225
  533. package/src/web/server-version.test.ts +0 -16
  534. package/src/web/server.ts +0 -1003
  535. package/src/web/services-manifest.test.ts +0 -120
  536. package/src/web/services-manifest.ts +0 -61
  537. package/src/web/static-serve.test.ts +0 -255
  538. package/src/web/static-serve.ts +0 -104
  539. package/src/web/telegram-validate.test.ts +0 -116
  540. package/src/web/telegram-validate.ts +0 -107
  541. package/src/web/vault-proxy.test.ts +0 -214
  542. package/src/web/vault-proxy.ts +0 -120
  543. package/src/web/wire-channel.ts +0 -181
  544. package/src/webhook-server.ts +0 -134
  545. package/vitest.config.ts +0 -18
  546. package/web/README.md +0 -63
  547. package/web/ui/index.html +0 -13
  548. package/web/ui/package.json +0 -35
  549. package/web/ui/pnpm-lock.yaml +0 -2164
  550. package/web/ui/scripts/verify-base.mjs +0 -31
  551. package/web/ui/src/App.tsx +0 -88
  552. package/web/ui/src/components/ActivityFeed.tsx +0 -444
  553. package/web/ui/src/components/AgentGroupPicker.tsx +0 -263
  554. package/web/ui/src/components/AgentProviderCards.tsx +0 -220
  555. package/web/ui/src/components/CredentialForm.tsx +0 -214
  556. package/web/ui/src/components/ScopeGrants.tsx +0 -74
  557. package/web/ui/src/components/StatusDot.tsx +0 -43
  558. package/web/ui/src/components/VaultPicker.tsx +0 -127
  559. package/web/ui/src/components/setup/AdapterInstallStep.tsx +0 -178
  560. package/web/ui/src/components/setup/AgentGroupStep.tsx +0 -43
  561. package/web/ui/src/components/setup/ChannelPickStep.tsx +0 -74
  562. package/web/ui/src/components/setup/DoneStep.tsx +0 -49
  563. package/web/ui/src/components/setup/PrereqStep.tsx +0 -129
  564. package/web/ui/src/components/setup/TestConnectionStep.tsx +0 -108
  565. package/web/ui/src/components/setup/TestMessageStep.tsx +0 -104
  566. package/web/ui/src/components/setup/WireChannelStep.tsx +0 -166
  567. package/web/ui/src/components/setup/types.ts +0 -105
  568. package/web/ui/src/lib/api.test.ts +0 -410
  569. package/web/ui/src/lib/api.ts +0 -1210
  570. package/web/ui/src/lib/auth.test.ts +0 -139
  571. package/web/ui/src/lib/auth.ts +0 -348
  572. package/web/ui/src/lib/channel-adapters.ts +0 -136
  573. package/web/ui/src/main.tsx +0 -19
  574. package/web/ui/src/routes/ApprovalsList.tsx +0 -294
  575. package/web/ui/src/routes/Apps.tsx +0 -613
  576. package/web/ui/src/routes/ChannelWireDetail.test.tsx +0 -233
  577. package/web/ui/src/routes/ChannelWireDetail.tsx +0 -403
  578. package/web/ui/src/routes/ChannelsList.tsx +0 -158
  579. package/web/ui/src/routes/GroupDetail.tsx +0 -755
  580. package/web/ui/src/routes/GroupList.tsx +0 -187
  581. package/web/ui/src/routes/MessagingGroupDetail.test.tsx +0 -233
  582. package/web/ui/src/routes/MessagingGroupDetail.tsx +0 -306
  583. package/web/ui/src/routes/NewGroupWizard.tsx +0 -390
  584. package/web/ui/src/routes/OAuthCallback.tsx +0 -56
  585. package/web/ui/src/routes/SecretsList.tsx +0 -921
  586. package/web/ui/src/routes/SessionsList.tsx +0 -220
  587. package/web/ui/src/routes/SettingsAgentProvider.tsx +0 -109
  588. package/web/ui/src/routes/SettingsApprovals.tsx +0 -234
  589. package/web/ui/src/routes/SetupWizard.tsx +0 -219
  590. package/web/ui/src/routes/VaultDetail.test.tsx +0 -361
  591. package/web/ui/src/routes/VaultDetail.tsx +0 -960
  592. package/web/ui/src/routes/VaultsList.tsx +0 -295
  593. package/web/ui/src/routes/WireChannelPage.tsx +0 -413
  594. package/web/ui/src/styles.css +0 -608
  595. package/web/ui/src/test/setup.ts +0 -23
  596. package/web/ui/src/vite-env.d.ts +0 -10
  597. package/web/ui/vite.config.ts +0 -34
  598. package/web/ui/vitest.config.ts +0 -25
@@ -1,433 +0,0 @@
1
- /**
2
- * Session lifecycle: folders, DBs, messages, container status.
3
- *
4
- * Two-DB split — inbound.db (host writes) + outbound.db (container writes).
5
- * Three cross-mount invariants are load-bearing:
6
- * 1. journal_mode=DELETE — WAL's mmapped -shm doesn't refresh host→guest;
7
- * the container would silently miss every new message.
8
- * 2. Host opens-writes-CLOSES per op — close invalidates the container's
9
- * page cache; a long-lived connection freezes its view at first read.
10
- * 3. One writer per file — DELETE-mode journal-unlink isn't atomic across
11
- * the mount; concurrent writers corrupt the DB.
12
- */
13
- import type { Database } from './db/connection.js';
14
- import fs from 'fs';
15
- import path from 'path';
16
-
17
- import type { OutboundFile } from './channels/adapter.js';
18
- import { DATA_DIR } from './config.js';
19
- import { getMessagingGroup } from './db/messaging-groups.js';
20
- import {
21
- createSession,
22
- findSession,
23
- findSessionByAgentGroup,
24
- findSessionForAgent,
25
- getSession,
26
- updateSession,
27
- } from './db/sessions.js';
28
- import {
29
- ensureSchema,
30
- openInboundDb as openInboundDbRaw,
31
- openOutboundDb as openOutboundDbRaw,
32
- upsertSessionRouting,
33
- insertMessage,
34
- migrateMessagesInTable,
35
- } from './db/session-db.js';
36
- import { log } from './log.js';
37
- import type { Session } from './types.js';
38
-
39
- /** Root directory for all session data. */
40
- export function sessionsBaseDir(): string {
41
- return path.join(DATA_DIR, 'sessions');
42
- }
43
-
44
- /** Legacy location, pre-rename. Kept only so `migrateSessionsDir` can find it. */
45
- export function legacySessionsBaseDir(): string {
46
- return path.join(DATA_DIR, 'v2-sessions');
47
- }
48
-
49
- /**
50
- * One-shot rename: `data/v2-sessions/` → `data/sessions/`. Idempotent — noop
51
- * if the legacy directory doesn't exist or the new directory already does.
52
- *
53
- * Called from `src/index.ts` at startup, before any session DB is opened.
54
- * Same-filesystem rename is atomic, so partial-migration recovery is not a
55
- * concern (unlike the central-DB copy in `migrateCentralDbLocation`).
56
- *
57
- * Path overrides exist for tests; production callers pass no args.
58
- */
59
- export function migrateSessionsDir(
60
- legacy: string = legacySessionsBaseDir(),
61
- current: string = sessionsBaseDir(),
62
- ): void {
63
- if (fs.existsSync(current)) return;
64
- if (!fs.existsSync(legacy)) return;
65
- fs.renameSync(legacy, current);
66
- log.info('Sessions directory renamed', { from: legacy, to: current });
67
- }
68
-
69
- /** Directory for a specific session: sessions/{agent_group_id}/{session_id}/ */
70
- export function sessionDir(agentGroupId: string, sessionId: string): string {
71
- return path.join(sessionsBaseDir(), agentGroupId, sessionId);
72
- }
73
-
74
- /** Path to the host-owned inbound DB (messages_in + delivered). */
75
- export function inboundDbPath(agentGroupId: string, sessionId: string): string {
76
- return path.join(sessionDir(agentGroupId, sessionId), 'inbound.db');
77
- }
78
-
79
- /** Path to the container-owned outbound DB (messages_out + processing_ack). */
80
- export function outboundDbPath(agentGroupId: string, sessionId: string): string {
81
- return path.join(sessionDir(agentGroupId, sessionId), 'outbound.db');
82
- }
83
-
84
- /** Path to the container heartbeat file (touched instead of DB writes). */
85
- export function heartbeatPath(agentGroupId: string, sessionId: string): string {
86
- return path.join(sessionDir(agentGroupId, sessionId), '.heartbeat');
87
- }
88
-
89
- /**
90
- * @deprecated Use inboundDbPath / outboundDbPath instead.
91
- * Kept temporarily for test compatibility during migration.
92
- */
93
- export function sessionDbPath(agentGroupId: string, sessionId: string): string {
94
- return inboundDbPath(agentGroupId, sessionId);
95
- }
96
-
97
- function generateId(): string {
98
- return `sess-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
99
- }
100
-
101
- /**
102
- * Find or create a session for a messaging group + thread.
103
- *
104
- * Session modes:
105
- * - 'shared': one session per messaging group (ignores threadId)
106
- * - 'per-thread': one session per (messaging group, thread)
107
- * - 'agent-shared': one session per agent group — all messaging groups
108
- * wired with this mode share a single session (e.g. GitHub + Slack)
109
- */
110
- export function resolveSession(
111
- agentGroupId: string,
112
- messagingGroupId: string | null,
113
- threadId: string | null,
114
- sessionMode: 'shared' | 'per-thread' | 'agent-shared',
115
- ): { session: Session; created: boolean } {
116
- // agent-shared: single session per agent group, regardless of messaging group
117
- if (sessionMode === 'agent-shared') {
118
- const existing = findSessionByAgentGroup(agentGroupId);
119
- if (existing) {
120
- return { session: existing, created: false };
121
- }
122
- } else if (messagingGroupId) {
123
- const lookupThreadId = sessionMode === 'shared' ? null : threadId;
124
- // Scope lookup by agent_group_id so fan-out to multiple agents in the
125
- // same chat doesn't accidentally deliver to the wrong agent's session.
126
- const existing = findSessionForAgent(agentGroupId, messagingGroupId, lookupThreadId);
127
- if (existing) {
128
- return { session: existing, created: false };
129
- }
130
- }
131
-
132
- const id = generateId();
133
- const lookupThreadId = sessionMode === 'per-thread' ? threadId : null;
134
- const session: Session = {
135
- id,
136
- agent_group_id: agentGroupId,
137
- messaging_group_id: messagingGroupId,
138
- thread_id: lookupThreadId,
139
- agent_provider: null,
140
- status: 'active',
141
- container_status: 'stopped',
142
- last_active: null,
143
- created_at: new Date().toISOString(),
144
- };
145
-
146
- createSession(session);
147
- initSessionFolder(agentGroupId, id);
148
- log.info('Session created', { id, agentGroupId, messagingGroupId, threadId: lookupThreadId, sessionMode });
149
-
150
- return { session, created: true };
151
- }
152
-
153
- /** Create the session folder and initialize both DBs. */
154
- export function initSessionFolder(agentGroupId: string, sessionId: string): void {
155
- const dir = sessionDir(agentGroupId, sessionId);
156
- fs.mkdirSync(dir, { recursive: true });
157
- fs.mkdirSync(path.join(dir, 'outbox'), { recursive: true });
158
-
159
- ensureSchema(inboundDbPath(agentGroupId, sessionId), 'inbound');
160
- ensureSchema(outboundDbPath(agentGroupId, sessionId), 'outbound');
161
- }
162
-
163
- /**
164
- * Write the default reply routing for a session into its inbound.db.
165
- *
166
- * The container reads this as the default (channel_type, platform_id, thread_id)
167
- * for outbound messages when the agent doesn't specify an explicit destination.
168
- * Derived from session.messaging_group_id → messaging_groups row + session.thread_id.
169
- *
170
- * Called on every container wake alongside the agent-to-agent module's
171
- * writeDestinations() (when installed) so the latest routing is always in
172
- * place, including after admin rewiring.
173
- */
174
- export function writeSessionRouting(agentGroupId: string, sessionId: string): void {
175
- const dbPath = inboundDbPath(agentGroupId, sessionId);
176
- if (!fs.existsSync(dbPath)) return;
177
-
178
- const session = getSession(sessionId);
179
- if (!session) return;
180
-
181
- let channelType: string | null = null;
182
- let platformId: string | null = null;
183
- if (session.messaging_group_id) {
184
- const mg = getMessagingGroup(session.messaging_group_id);
185
- if (mg) {
186
- channelType = mg.channel_type;
187
- platformId = mg.platform_id;
188
- }
189
- }
190
-
191
- const db = openInboundDb(agentGroupId, sessionId);
192
- try {
193
- upsertSessionRouting(db, {
194
- channel_type: channelType,
195
- platform_id: platformId,
196
- thread_id: session.thread_id,
197
- });
198
- } finally {
199
- db.close();
200
- }
201
- log.debug('Session routing written', { sessionId, channelType, platformId, threadId: session.thread_id });
202
- }
203
-
204
- /**
205
- * Write a message to a session's inbound DB (messages_in). Host-only.
206
- *
207
- * ⚠ Opens and closes the DB on every call. Do not refactor to reuse a
208
- * long-lived connection — see the "Cross-mount visibility invariants" note
209
- * at the top of this file.
210
- */
211
- export function writeSessionMessage(
212
- agentGroupId: string,
213
- sessionId: string,
214
- message: {
215
- id: string;
216
- kind: string;
217
- timestamp: string;
218
- platformId?: string | null;
219
- channelType?: string | null;
220
- threadId?: string | null;
221
- content: string;
222
- processAfter?: string | null;
223
- recurrence?: string | null;
224
- /**
225
- * 1 = this message should wake the agent (the default); 0 = accumulate
226
- * as context only, don't wake. Host's countDueMessages gates on this
227
- * column; the container still reads all prior messages as context when
228
- * a trigger-1 message does arrive.
229
- */
230
- trigger?: 0 | 1;
231
- },
232
- ): void {
233
- // Extract base64 attachment data, save to inbox, replace with file paths
234
- const content = extractAttachmentFiles(agentGroupId, sessionId, message.id, message.content);
235
-
236
- const db = openInboundDb(agentGroupId, sessionId);
237
- let inserted: boolean;
238
- try {
239
- ({ inserted } = insertMessage(db, {
240
- id: message.id,
241
- kind: message.kind,
242
- timestamp: message.timestamp,
243
- platformId: message.platformId ?? null,
244
- channelType: message.channelType ?? null,
245
- threadId: message.threadId ?? null,
246
- content,
247
- processAfter: message.processAfter ?? null,
248
- recurrence: message.recurrence ?? null,
249
- trigger: message.trigger ?? 1,
250
- }));
251
- } finally {
252
- db.close();
253
- }
254
-
255
- if (!inserted) {
256
- log.debug('messages_in id already present — duplicate dispatch, skipping', {
257
- agentGroupId,
258
- sessionId,
259
- messageId: message.id,
260
- });
261
- return;
262
- }
263
-
264
- updateSession(sessionId, { last_active: new Date().toISOString() });
265
- }
266
-
267
- /**
268
- * If message content has attachments with base64 `data`, save them to
269
- * the session's inbox directory and replace with `localPath`.
270
- */
271
- function extractAttachmentFiles(
272
- agentGroupId: string,
273
- sessionId: string,
274
- messageId: string,
275
- contentStr: string,
276
- ): string {
277
- let parsed: Record<string, unknown>;
278
- try {
279
- parsed = JSON.parse(contentStr);
280
- } catch {
281
- return contentStr;
282
- }
283
-
284
- const attachments = parsed.attachments as Array<Record<string, unknown>> | undefined;
285
- if (!Array.isArray(attachments)) return contentStr;
286
-
287
- let changed = false;
288
- for (const att of attachments) {
289
- if (typeof att.data === 'string') {
290
- const inboxDir = path.join(sessionDir(agentGroupId, sessionId), 'inbox', messageId);
291
- fs.mkdirSync(inboxDir, { recursive: true });
292
- const filename = (att.name as string) || `attachment-${Date.now()}`;
293
- const filePath = path.join(inboxDir, filename);
294
- fs.writeFileSync(filePath, Buffer.from(att.data as string, 'base64'));
295
- att.localPath = `inbox/${messageId}/${filename}`;
296
- delete att.data;
297
- changed = true;
298
- log.debug('Saved attachment to inbox', { messageId, filename, size: att.size });
299
- }
300
- }
301
-
302
- return changed ? JSON.stringify(parsed) : contentStr;
303
- }
304
-
305
- /** Open the inbound DB for a session (host reads/writes). */
306
- export function openInboundDb(agentGroupId: string, sessionId: string): Database {
307
- const db = openInboundDbRaw(inboundDbPath(agentGroupId, sessionId));
308
- migrateMessagesInTable(db);
309
- return db;
310
- }
311
-
312
- /** Open the outbound DB for a session (host reads only). */
313
- export function openOutboundDb(agentGroupId: string, sessionId: string): Database {
314
- return openOutboundDbRaw(outboundDbPath(agentGroupId, sessionId));
315
- }
316
-
317
- /**
318
- * Write a message directly to a session's outbound DB so the host delivery
319
- * loop picks it up. Used by the command gate to send denial responses
320
- * without waking a container.
321
- */
322
- export function writeOutboundDirect(
323
- agentGroupId: string,
324
- sessionId: string,
325
- message: {
326
- id: string;
327
- kind: string;
328
- platformId: string | null;
329
- channelType: string | null;
330
- threadId: string | null;
331
- content: string;
332
- },
333
- ): void {
334
- const db = openOutboundDb(agentGroupId, sessionId);
335
- try {
336
- db.prepare(
337
- `INSERT OR IGNORE INTO messages_out (id, seq, timestamp, kind, platform_id, channel_type, thread_id, content)
338
- VALUES (?, (SELECT COALESCE(MAX(seq), 0) + 2 FROM messages_out), datetime('now'), ?, ?, ?, ?, ?)`,
339
- ).run(message.id, message.kind, message.platformId, message.channelType, message.threadId, message.content);
340
- } finally {
341
- db.close();
342
- }
343
- }
344
-
345
- /**
346
- * @deprecated Use openInboundDb / openOutboundDb instead.
347
- */
348
- export function openSessionDb(agentGroupId: string, sessionId: string): Database {
349
- return openInboundDb(agentGroupId, sessionId);
350
- }
351
-
352
- /** Write a system response to a session's inbound.db so the container's findQuestionResponse() picks it up. */
353
- export function writeSystemResponse(
354
- agentGroupId: string,
355
- sessionId: string,
356
- requestId: string,
357
- status: string,
358
- result: Record<string, unknown>,
359
- ): void {
360
- writeSessionMessage(agentGroupId, sessionId, {
361
- id: `sys-resp-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
362
- kind: 'system',
363
- timestamp: new Date().toISOString(),
364
- content: JSON.stringify({
365
- type: 'question_response',
366
- questionId: requestId,
367
- status,
368
- result,
369
- }),
370
- });
371
- }
372
-
373
- /**
374
- * Load outbox attachments for a delivered message.
375
- *
376
- * Symmetric with `extractAttachmentFiles` on the inbound side: the container
377
- * writes files into the session's `outbox/<messageId>/` directory alongside
378
- * its `messages_out` row, and the host reads them back at delivery time.
379
- *
380
- * Returns undefined when the outbox dir is missing or no declared file was
381
- * actually on disk — delivery continues without attachments rather than
382
- * failing the whole message.
383
- */
384
- export function readOutboxFiles(
385
- agentGroupId: string,
386
- sessionId: string,
387
- messageId: string,
388
- filenames: string[],
389
- ): OutboundFile[] | undefined {
390
- const outboxDir = path.join(sessionDir(agentGroupId, sessionId), 'outbox', messageId);
391
- if (!fs.existsSync(outboxDir)) return undefined;
392
- const files: OutboundFile[] = [];
393
- for (const filename of filenames) {
394
- const filePath = path.join(outboxDir, filename);
395
- if (fs.existsSync(filePath)) {
396
- files.push({ filename, data: fs.readFileSync(filePath) });
397
- } else {
398
- log.warn('Outbox file not found', { messageId, filename });
399
- }
400
- }
401
- return files.length > 0 ? files : undefined;
402
- }
403
-
404
- /**
405
- * Remove a message's outbox directory after successful delivery. Best-effort:
406
- * failures log and swallow. A cleanup failure must NOT propagate to the
407
- * delivery caller — the message is already on the user's screen, and a
408
- * thrown error would trigger the delivery retry path and deliver twice.
409
- */
410
- export function clearOutbox(agentGroupId: string, sessionId: string, messageId: string): void {
411
- const outboxDir = path.join(sessionDir(agentGroupId, sessionId), 'outbox', messageId);
412
- if (!fs.existsSync(outboxDir)) return;
413
- try {
414
- fs.rmSync(outboxDir, { recursive: true, force: true });
415
- } catch (err) {
416
- log.warn('Outbox cleanup failed (message already delivered)', { messageId, err });
417
- }
418
- }
419
-
420
- /** Mark a container as running for a session. */
421
- export function markContainerRunning(sessionId: string): void {
422
- updateSession(sessionId, { container_status: 'running', last_active: new Date().toISOString() });
423
- }
424
-
425
- /** Mark a container as idle for a session. */
426
- export function markContainerIdle(sessionId: string): void {
427
- updateSession(sessionId, { container_status: 'idle' });
428
- }
429
-
430
- /** Mark a container as stopped for a session. */
431
- export function markContainerStopped(sessionId: string): void {
432
- updateSession(sessionId, { container_status: 'stopped' });
433
- }
@@ -1,226 +0,0 @@
1
- /**
2
- * Tests for the startup bootstrap (`.env` token copy + messaging_groups
3
- * v1→v2 backfill). The bootstrap reads from the registry's getActiveAdapters
4
- * + readEnvFile, so each test stands up a real central DB plus a fake
5
- * adapter and a stubbed env source.
6
- */
7
- import fs from 'node:fs';
8
- import os from 'node:os';
9
- import path from 'node:path';
10
-
11
- import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
12
-
13
- import { _resetActiveAdaptersForTest, _setActiveAdapterForTest } from './channels/channel-registry.js';
14
- import type { ChannelAdapter } from './channels/adapter.js';
15
- import { createMessagingGroup, getMessagingGroup } from './db/messaging-groups.js';
16
- import { closeDb, initTestDb } from './db/connection.js';
17
- import { runMigrations } from './db/migrations/index.js';
18
- import { getSecret, putSecret } from './secrets/index.js';
19
- import {
20
- backfillMessagingGroupsToV2,
21
- bootstrapChannelTokensToSecrets,
22
- channelTokenSecretName,
23
- } from './startup-bootstrap.js';
24
-
25
- let envDir: string | null = null;
26
- let envCwd: string | null = null;
27
-
28
- function fakeAdapter(channelType: string, botId: string | null): ChannelAdapter {
29
- return {
30
- name: channelType,
31
- channelType,
32
- botId,
33
- supportsThreads: false,
34
- setup: async () => {},
35
- teardown: async () => {},
36
- isConnected: () => true,
37
- deliver: async () => undefined,
38
- };
39
- }
40
-
41
- function writeEnvFile(contents: string): void {
42
- envDir = fs.mkdtempSync(path.join(os.tmpdir(), 'paraclaw-bootstrap-test-'));
43
- fs.writeFileSync(path.join(envDir, '.env'), contents);
44
- envCwd = process.cwd();
45
- process.chdir(envDir);
46
- }
47
-
48
- beforeEach(() => {
49
- // master.key for AES-GCM lives next to the central DB; use HOME override
50
- // (master-key.ts reads ~/.parachute/...) by routing HOME at the top of
51
- // each test.
52
- process.env.HOME = fs.mkdtempSync(path.join(os.tmpdir(), 'paraclaw-bootstrap-home-'));
53
- const db = initTestDb();
54
- runMigrations(db);
55
- });
56
-
57
- afterEach(() => {
58
- _resetActiveAdaptersForTest();
59
- closeDb();
60
- if (envCwd) {
61
- process.chdir(envCwd);
62
- envCwd = null;
63
- }
64
- if (envDir) {
65
- fs.rmSync(envDir, { recursive: true, force: true });
66
- envDir = null;
67
- }
68
- vi.unstubAllEnvs();
69
- });
70
-
71
- describe('backfillMessagingGroupsToV2', () => {
72
- it('rewrites legacy telegram:<chatId> → telegram:<botId>:<chatId>', () => {
73
- _setActiveAdapterForTest(fakeAdapter('telegram', '8792496425'));
74
- createMessagingGroup({
75
- id: 'mg-1',
76
- channel_type: 'telegram',
77
- platform_id: 'telegram:1190596288',
78
- name: 'Aaron DM',
79
- is_group: 0,
80
- unknown_sender_policy: 'strict',
81
- created_at: new Date().toISOString(),
82
- });
83
- const upgraded = backfillMessagingGroupsToV2();
84
- expect(upgraded).toBe(1);
85
- expect(getMessagingGroup('mg-1')!.platform_id).toBe('telegram:8792496425:1190596288');
86
- });
87
-
88
- it('rewrites legacy discord:<guildId>:<channelId> → discord:<botId>:<guildId>:<channelId>', () => {
89
- _setActiveAdapterForTest(fakeAdapter('discord', 'app-1'));
90
- createMessagingGroup({
91
- id: 'mg-2',
92
- channel_type: 'discord',
93
- platform_id: 'discord:guild999:chan111',
94
- name: 'guild',
95
- is_group: 1,
96
- unknown_sender_policy: 'strict',
97
- created_at: new Date().toISOString(),
98
- });
99
- backfillMessagingGroupsToV2();
100
- expect(getMessagingGroup('mg-2')!.platform_id).toBe('discord:app-1:guild999:chan111');
101
- });
102
-
103
- it('preserves an @me DM segment intact under the new bot dim', () => {
104
- _setActiveAdapterForTest(fakeAdapter('discord', 'app-1'));
105
- createMessagingGroup({
106
- id: 'mg-3',
107
- channel_type: 'discord',
108
- platform_id: 'discord:@me:user456',
109
- name: 'DM',
110
- is_group: 0,
111
- unknown_sender_policy: 'strict',
112
- created_at: new Date().toISOString(),
113
- });
114
- backfillMessagingGroupsToV2();
115
- expect(getMessagingGroup('mg-3')!.platform_id).toBe('discord:app-1:@me:user456');
116
- });
117
-
118
- it('is idempotent — already-v2 rows are not double-prefixed', () => {
119
- _setActiveAdapterForTest(fakeAdapter('telegram', 'bot1'));
120
- createMessagingGroup({
121
- id: 'mg-4',
122
- channel_type: 'telegram',
123
- platform_id: 'telegram:bot1:1190596288',
124
- name: null,
125
- is_group: 0,
126
- unknown_sender_policy: 'strict',
127
- created_at: new Date().toISOString(),
128
- });
129
- expect(backfillMessagingGroupsToV2()).toBe(0);
130
- expect(getMessagingGroup('mg-4')!.platform_id).toBe('telegram:bot1:1190596288');
131
- // Second run must also be a no-op.
132
- expect(backfillMessagingGroupsToV2()).toBe(0);
133
- expect(getMessagingGroup('mg-4')!.platform_id).toBe('telegram:bot1:1190596288');
134
- });
135
-
136
- it('does not re-prefix already-v2 rows that belong to a registered-but-not-yet-active secondary bot', () => {
137
- // Reproduces the live regression that corrupted TechneRobot's rows on
138
- // reboot: only the .env primary adapter is active at boot, but the
139
- // secondary bot's CHANNEL_BOT_TOKEN secret is already in the table
140
- // (Proposal A: register-bot persists the token before adapter spawn).
141
- // The backfill iterates over the primary; if it forgets the secondary's
142
- // botId, it sees the secondary's already-v2 row, treats it as v1, and
143
- // re-prefixes it under the primary → 4-segment garbage id.
144
- _setActiveAdapterForTest(fakeAdapter('telegram', 'primary-bot'));
145
- putSecret(channelTokenSecretName('telegram', 'secondary-bot'), 'tg-token-2', {
146
- kind: 'channel-token',
147
- agent_group_id: null,
148
- });
149
- createMessagingGroup({
150
- id: 'mg-primary',
151
- channel_type: 'telegram',
152
- platform_id: 'telegram:primary-bot:1190596288',
153
- name: null,
154
- is_group: 0,
155
- unknown_sender_policy: 'strict',
156
- created_at: new Date().toISOString(),
157
- });
158
- createMessagingGroup({
159
- id: 'mg-secondary',
160
- channel_type: 'telegram',
161
- platform_id: 'telegram:secondary-bot:-1002245300962',
162
- name: null,
163
- is_group: 1,
164
- unknown_sender_policy: 'strict',
165
- created_at: new Date().toISOString(),
166
- });
167
-
168
- expect(backfillMessagingGroupsToV2()).toBe(0);
169
- expect(getMessagingGroup('mg-primary')!.platform_id).toBe('telegram:primary-bot:1190596288');
170
- expect(getMessagingGroup('mg-secondary')!.platform_id).toBe('telegram:secondary-bot:-1002245300962');
171
-
172
- // Second pass must remain a no-op even with mixed-bot rows present.
173
- expect(backfillMessagingGroupsToV2()).toBe(0);
174
- expect(getMessagingGroup('mg-primary')!.platform_id).toBe('telegram:primary-bot:1190596288');
175
- expect(getMessagingGroup('mg-secondary')!.platform_id).toBe('telegram:secondary-bot:-1002245300962');
176
- });
177
-
178
- it('skips channels with no active adapter (e.g. install with only Telegram running)', () => {
179
- _setActiveAdapterForTest(fakeAdapter('telegram', 'bot1'));
180
- // Discord row with no Discord adapter — must be left untouched until
181
- // its adapter comes up on a future restart.
182
- createMessagingGroup({
183
- id: 'mg-5',
184
- channel_type: 'discord',
185
- platform_id: 'discord:guild:chan',
186
- name: null,
187
- is_group: 1,
188
- unknown_sender_policy: 'strict',
189
- created_at: new Date().toISOString(),
190
- });
191
- backfillMessagingGroupsToV2();
192
- expect(getMessagingGroup('mg-5')!.platform_id).toBe('discord:guild:chan');
193
- });
194
- });
195
-
196
- describe('bootstrapChannelTokensToSecrets', () => {
197
- it('copies TELEGRAM_BOT_TOKEN into a per-bot secret row keyed by botId', () => {
198
- writeEnvFile('TELEGRAM_BOT_TOKEN=tg-secret-token\n');
199
- _setActiveAdapterForTest(fakeAdapter('telegram', '8792496425'));
200
- bootstrapChannelTokensToSecrets();
201
- const name = channelTokenSecretName('telegram', '8792496425');
202
- expect(getSecret(name)).toBe('tg-secret-token');
203
- });
204
-
205
- it('is idempotent — re-running with the same value does not duplicate', () => {
206
- writeEnvFile('TELEGRAM_BOT_TOKEN=tg-secret-token\n');
207
- _setActiveAdapterForTest(fakeAdapter('telegram', 'bot1'));
208
- bootstrapChannelTokensToSecrets();
209
- bootstrapChannelTokensToSecrets();
210
- expect(getSecret(channelTokenSecretName('telegram', 'bot1'))).toBe('tg-secret-token');
211
- });
212
-
213
- it('skips adapters without a botId (e.g. CLI admin transport)', () => {
214
- writeEnvFile('TELEGRAM_BOT_TOKEN=tg-secret-token\n');
215
- _setActiveAdapterForTest(fakeAdapter('cli', null));
216
- bootstrapChannelTokensToSecrets();
217
- expect(getSecret('CHANNEL_BOT_TOKEN:cli:')).toBeUndefined();
218
- });
219
-
220
- it('skips channels with no env var mapping (no-op for unknown channels)', () => {
221
- writeEnvFile('SOMETHING_ELSE=x\n');
222
- _setActiveAdapterForTest(fakeAdapter('whatsapp', 'wa-bot'));
223
- bootstrapChannelTokensToSecrets();
224
- expect(getSecret(channelTokenSecretName('whatsapp', 'wa-bot'))).toBeUndefined();
225
- });
226
- });