@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,54 +0,0 @@
1
- /**
2
- * Sweep hook for recurring tasks.
3
- *
4
- * Every sweep tick, find `messages_in` rows that are `completed` AND still
5
- * have a `recurrence` cron expression. For each, compute the next run via
6
- * cron-parser, insert a fresh pending row (copying series_id forward), then
7
- * clear the recurrence on the original so it isn't re-cloned next tick.
8
- *
9
- * Called from `src/host-sweep.ts` inside `MODULE-HOOK:scheduling-recurrence`.
10
- * When scheduling ships inline (current state through PR #7), the hook is a
11
- * direct dynamic import. When scheduling moves to the modules branch in
12
- * PR #8, the install skill re-fills the marker on install.
13
- */
14
- import type { Database } from '../../db/connection.js';
15
-
16
- import { TIMEZONE } from '../../config.js';
17
- import { log } from '../../log.js';
18
- import type { Session } from '../../types.js';
19
- import { clearRecurrence, getCompletedRecurring, insertRecurrence } from './db.js';
20
-
21
- export async function handleRecurrence(inDb: Database, session: Session): Promise<void> {
22
- const recurring = getCompletedRecurring(inDb);
23
-
24
- for (const msg of recurring) {
25
- try {
26
- const { CronExpressionParser } = await import('cron-parser');
27
- // Interpret the cron expression in the user's timezone. v1 did this
28
- // (src/v1/task-scheduler.ts:20-49); without it, a task written "0 9 * * *"
29
- // by an agent running in a user's local TZ fires at 09:00 UTC instead of
30
- // 09:00 user-local.
31
- const interval = CronExpressionParser.parse(msg.recurrence, { tz: TIMEZONE });
32
- const nextRun = interval.next().toISOString();
33
- const prefix = msg.kind === 'task' ? 'task' : 'msg';
34
- const newId = `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
35
-
36
- insertRecurrence(inDb, msg, newId, nextRun);
37
- clearRecurrence(inDb, msg.id);
38
-
39
- log.info('Inserted next recurrence', {
40
- originalId: msg.id,
41
- newId,
42
- seriesId: msg.series_id,
43
- nextRun,
44
- sessionId: session.id,
45
- });
46
- } catch (err) {
47
- log.error('Failed to compute next recurrence', {
48
- messageId: msg.id,
49
- recurrence: msg.recurrence,
50
- err,
51
- });
52
- }
53
- }
54
- }
@@ -1,30 +0,0 @@
1
- # Self-modification
2
-
3
- You can install additional OS or npm packages or add new MCP servers — but
4
- only with admin approval.
5
-
6
- ## Tools
7
-
8
- - `install_packages({ apt?: string[], npm?: string[], reason?: string })` —
9
- adds the listed packages to your container config, rebuilds the image,
10
- and restarts your container, all in a single admin approval step.
11
- Package names are validated strictly (`[a-z0-9._+-]` for apt, standard
12
- npm naming with optional scope). Max 20 packages per request.
13
-
14
- - `add_mcp_server({ name, command, args?, env? })` — adds a new MCP server
15
- to your container config and restarts the container so the new server
16
- is wired up on the next message. No image rebuild is required (bun runs
17
- TS directly).
18
-
19
- ## Flow
20
-
21
- You call one of these tools → the host asks an admin via DM → admin approves
22
- or rejects. On approve, the config is applied, the image is rebuilt if
23
- needed, and the container is killed; the host respawns it on the next
24
- message. You'll get a system chat message confirming the outcome (either
25
- "Packages installed..." or a failure reason).
26
-
27
- On reject you'll see "Your X request was rejected by admin."
28
-
29
- If no admin is configured or reachable, the request fails immediately with
30
- a chat notification explaining why.
@@ -1,85 +0,0 @@
1
- /**
2
- * Approval handlers for self-modification actions.
3
- *
4
- * The approvals module calls these when an admin clicks Approve on a
5
- * pending_approvals row whose action matches. Each handler mutates the
6
- * container config, rebuilds/kills the container as needed, and lets the
7
- * host sweep respawn it on the new image on the next message.
8
- *
9
- * install_packages: rebuild image + kill container (apt/npm global installs
10
- * must be baked into the image layer).
11
- * add_mcp_server: kill container only — bun runs TS directly, so a pure
12
- * MCP wiring change needs nothing more than a process restart.
13
- */
14
- import { updateContainerConfig } from '../../container-config.js';
15
- import { buildAgentGroupImage, killContainer } from '../../container-runner.js';
16
- import { getAgentGroup } from '../../db/agent-groups.js';
17
- import { log } from '../../log.js';
18
- import { writeSessionMessage } from '../../session-manager.js';
19
- import type { ApprovalHandler } from '../approvals/index.js';
20
-
21
- export const applyInstallPackages: ApprovalHandler = async ({ session, payload, userId, notify }) => {
22
- const agentGroup = getAgentGroup(session.agent_group_id);
23
- if (!agentGroup) {
24
- notify('install_packages approved but agent group missing.');
25
- return;
26
- }
27
- updateContainerConfig(agentGroup.folder, (cfg) => {
28
- if (payload.apt) cfg.packages.apt.push(...(payload.apt as string[]));
29
- if (payload.npm) cfg.packages.npm.push(...(payload.npm as string[]));
30
- });
31
-
32
- const pkgs = [
33
- ...((payload.apt as string[] | undefined) || []),
34
- ...((payload.npm as string[] | undefined) || []),
35
- ].join(', ');
36
- log.info('Package install approved', { agentGroupId: session.agent_group_id, userId });
37
- try {
38
- await buildAgentGroupImage(session.agent_group_id);
39
- killContainer(session.id, 'rebuild applied');
40
- // Schedule a follow-up prompt a few seconds after kill so the host sweep
41
- // respawns the container on the new image and the agent verifies + reports.
42
- writeSessionMessage(session.agent_group_id, session.id, {
43
- id: `appr-note-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
44
- kind: 'chat',
45
- timestamp: new Date().toISOString(),
46
- platformId: session.agent_group_id,
47
- channelType: 'agent',
48
- threadId: null,
49
- content: JSON.stringify({
50
- text: `Packages installed (${pkgs}) and container rebuilt. Verify the new packages are available (e.g. run them or check versions) and report the result to the user.`,
51
- sender: 'system',
52
- senderId: 'system',
53
- }),
54
- processAfter: new Date(Date.now() + 5000)
55
- .toISOString()
56
- .replace('T', ' ')
57
- .replace(/\.\d+Z$/, ''),
58
- });
59
- log.info('Container rebuild completed (bundled with install)', { agentGroupId: session.agent_group_id });
60
- } catch (e) {
61
- notify(
62
- `Packages added to config (${pkgs}) but rebuild failed: ${e instanceof Error ? e.message : String(e)}. Tell the user — an admin will need to retry the install_packages request or inspect the build logs.`,
63
- );
64
- log.error('Bundled rebuild failed after install approval', { agentGroupId: session.agent_group_id, err: e });
65
- }
66
- };
67
-
68
- export const applyAddMcpServer: ApprovalHandler = async ({ session, payload, userId, notify }) => {
69
- const agentGroup = getAgentGroup(session.agent_group_id);
70
- if (!agentGroup) {
71
- notify('add_mcp_server approved but agent group missing.');
72
- return;
73
- }
74
- updateContainerConfig(agentGroup.folder, (cfg) => {
75
- cfg.mcpServers[payload.name as string] = {
76
- command: payload.command as string,
77
- args: (payload.args as string[]) || [],
78
- env: (payload.env as Record<string, string>) || {},
79
- };
80
- });
81
-
82
- killContainer(session.id, 'mcp server added');
83
- notify(`MCP server "${payload.name}" added. Your container will restart with it on the next message.`);
84
- log.info('MCP server add approved', { agentGroupId: session.agent_group_id, userId });
85
- };
@@ -1,30 +0,0 @@
1
- /**
2
- * Self-modification module — admin-approved container mutations.
3
- *
4
- * Optional tier. Depends on the approvals default module for the request/
5
- * handler plumbing. On install the module registers:
6
- * - Two delivery actions (install_packages, add_mcp_server) that validate
7
- * input and queue an approval via requestApproval().
8
- * - Two matching approval handlers that run on approve and perform the
9
- * complete follow-up:
10
- * install_packages → update container.json, rebuild image, kill
11
- * container (next wake respawns on the new image), schedule a
12
- * verify-and-report follow-up prompt.
13
- * add_mcp_server → update container.json, kill container. No image
14
- * rebuild — bun runs TS directly, so the new MCP server is wired
15
- * by the next container start.
16
- *
17
- * Without this module: the MCP tools in the container still write outbound
18
- * system messages with these actions, but delivery logs "Unknown system
19
- * action" and drops them. Admin never sees a card; nothing changes.
20
- */
21
- import { registerDeliveryAction } from '../../delivery.js';
22
- import { registerApprovalHandler } from '../approvals/index.js';
23
- import { applyAddMcpServer, applyInstallPackages } from './apply.js';
24
- import { handleAddMcpServer, handleInstallPackages } from './request.js';
25
-
26
- registerDeliveryAction('install_packages', handleInstallPackages);
27
- registerDeliveryAction('add_mcp_server', handleAddMcpServer);
28
-
29
- registerApprovalHandler('install_packages', applyInstallPackages);
30
- registerApprovalHandler('add_mcp_server', applyAddMcpServer);
@@ -1,39 +0,0 @@
1
- # Self-mod module
2
-
3
- Optional-tier module that gives agents admin-gated self-modification:
4
- installing OS/npm packages and registering new MCP servers. Both paths go
5
- through the approvals module's request primitive — no unapproved changes
6
- ever land. The rebuild+restart (or restart-only) follow-up is bundled into
7
- the approval handler itself — there is no separate "request rebuild" step.
8
-
9
- ## What this module adds
10
-
11
- - Two delivery actions (`install_packages`, `add_mcp_server`) that the
12
- container's self-mod MCP tools write into outbound.db. On the host, each
13
- handler validates input and queues an approval via
14
- `approvals.requestApproval()`.
15
- - Two matching approval handlers that run on approve:
16
- - `install_packages` → update `container.json`, rebuild the image via
17
- `buildAgentGroupImage`, and kill the container so the host sweep
18
- respawns it on the new image. Also schedules a verify-and-report
19
- follow-up prompt ~5 s after kill.
20
- - `add_mcp_server` → update `container.json` and kill the container.
21
- No image rebuild — bun runs TS directly, so the new MCP wiring is
22
- picked up on the next container start.
23
-
24
- ## Dependency
25
-
26
- Self-mod depends on the approvals default module for:
27
- - `requestApproval()` to enqueue admin confirmation cards
28
- - `registerApprovalHandler(action, handler)` to run orchestration on approve
29
- - `notifyAgent()` to send failure feedback back to the requesting agent
30
-
31
- It also calls core's `buildAgentGroupImage`, `killContainer`, and
32
- `updateContainerConfig`.
33
-
34
- ## Removing the module
35
-
36
- Delete `src/modules/self-mod/` and its import line in `src/modules/index.ts`.
37
- The container's self-mod MCP tools will still write outbound system messages,
38
- but core delivery will log `"Unknown system action"` and drop them — no
39
- admin card, no container mutation.
@@ -1,91 +0,0 @@
1
- /**
2
- * Delivery-action handlers for agent-initiated self-modification requests.
3
- *
4
- * Two actions the container can write into messages_out (via the self-mod
5
- * MCP tools): install_packages, add_mcp_server. Each one validates input
6
- * and queues an approval request. The admin's approval triggers the
7
- * matching approval handler in ./apply.ts, which also performs the
8
- * required follow-up (rebuild+restart for install_packages, restart-only
9
- * for add_mcp_server).
10
- *
11
- * Host-side sanitization for install_packages is defense-in-depth — the MCP
12
- * tool validates first. Both layers matter: the DB row carries the payload
13
- * verbatim through to shell exec on apply.
14
- */
15
- import { getAgentGroup } from '../../db/agent-groups.js';
16
- import { log } from '../../log.js';
17
- import type { Session } from '../../types.js';
18
- import { notifyAgent, requestApproval } from '../approvals/index.js';
19
-
20
- export async function handleInstallPackages(content: Record<string, unknown>, session: Session): Promise<void> {
21
- const agentGroup = getAgentGroup(session.agent_group_id);
22
- if (!agentGroup) {
23
- notifyAgent(session, 'install_packages failed: agent group not found.');
24
- return;
25
- }
26
-
27
- const apt = (content.apt as string[]) || [];
28
- const npm = (content.npm as string[]) || [];
29
- const reason = (content.reason as string) || '';
30
-
31
- const APT_RE = /^[a-z0-9][a-z0-9._+-]*$/;
32
- const NPM_RE = /^(@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
33
- const MAX_PACKAGES = 20;
34
- if (apt.length + npm.length === 0) {
35
- notifyAgent(session, 'install_packages failed: at least one apt or npm package is required.');
36
- return;
37
- }
38
- if (apt.length + npm.length > MAX_PACKAGES) {
39
- notifyAgent(session, `install_packages failed: max ${MAX_PACKAGES} packages per request.`);
40
- return;
41
- }
42
- const invalidApt = apt.find((p) => !APT_RE.test(p));
43
- if (invalidApt) {
44
- notifyAgent(session, `install_packages failed: invalid apt package name "${invalidApt}".`);
45
- log.warn('install_packages: invalid apt package rejected', { pkg: invalidApt });
46
- return;
47
- }
48
- const invalidNpm = npm.find((p) => !NPM_RE.test(p));
49
- if (invalidNpm) {
50
- notifyAgent(session, `install_packages failed: invalid npm package name "${invalidNpm}".`);
51
- log.warn('install_packages: invalid npm package rejected', { pkg: invalidNpm });
52
- return;
53
- }
54
-
55
- const packageList = [...apt.map((p) => `apt: ${p}`), ...npm.map((p) => `npm: ${p}`)].join(', ');
56
- await requestApproval({
57
- session,
58
- agentName: agentGroup.name,
59
- action: 'install_packages',
60
- payload: { apt, npm, reason },
61
- title: 'Install Packages Request',
62
- question: `Agent "${agentGroup.name}" is attempting to install a package + rebuild container:\n${packageList}${reason ? `\nReason: ${reason}` : ''}`,
63
- });
64
- }
65
-
66
- export async function handleAddMcpServer(content: Record<string, unknown>, session: Session): Promise<void> {
67
- const agentGroup = getAgentGroup(session.agent_group_id);
68
- if (!agentGroup) {
69
- notifyAgent(session, 'add_mcp_server failed: agent group not found.');
70
- return;
71
- }
72
- const serverName = content.name as string;
73
- const command = content.command as string;
74
- if (!serverName || !command) {
75
- notifyAgent(session, 'add_mcp_server failed: name and command are required.');
76
- return;
77
- }
78
- await requestApproval({
79
- session,
80
- agentName: agentGroup.name,
81
- action: 'add_mcp_server',
82
- payload: {
83
- name: serverName,
84
- command,
85
- args: (content.args as string[]) || [],
86
- env: (content.env as Record<string, string>) || {},
87
- },
88
- title: 'Add MCP Request',
89
- question: `Agent "${agentGroup.name}" is attempting to add a new MCP server:\n${serverName} (${command})`,
90
- });
91
- }
@@ -1,165 +0,0 @@
1
- /**
2
- * Typing indicator refresh — default module.
3
- *
4
- * Most platforms expire a typing indicator after 5–10s, so a one-shot
5
- * call on message arrival goes stale long before the agent finishes
6
- * thinking. This module keeps it alive by re-firing `setTyping` on a
7
- * short interval — but only while the agent is actually WORKING, gated
8
- * on the heartbeat file's mtime after an initial grace period.
9
- *
10
- * After delivering a user-facing message, the refresh is paused for
11
- * POST_DELIVERY_PAUSE_MS so the client-side indicator can visually
12
- * clear.
13
- *
14
- * Default module status:
15
- * - Lives in src/modules/ for signaling (not really core), but ships
16
- * on main and is imported directly by core. No registry, no hook.
17
- * - Removing requires editing src/router.ts, src/delivery.ts, and
18
- * src/container-runner.ts to drop the calls.
19
- */
20
- import fs from 'fs';
21
-
22
- import { heartbeatPath } from '../../session-manager.js';
23
-
24
- const TYPING_REFRESH_MS = 4000;
25
- /**
26
- * Grace window from startTypingRefresh: fire typing unconditionally
27
- * for this long regardless of heartbeat state. Covers container
28
- * spawn/wake latency (5–12s on cold start before first heartbeat).
29
- */
30
- const TYPING_GRACE_MS = 15000;
31
- /**
32
- * After the grace window, a heartbeat must be mtimed within this
33
- * many ms of now to count as "agent is working." Heartbeats land
34
- * every few hundred ms during active work, so 6s is well above
35
- * the working floor and small enough to stop typing quickly when
36
- * the agent goes idle.
37
- */
38
- const HEARTBEAT_FRESH_MS = 6000;
39
- /**
40
- * After we deliver a user-facing message, pause typing for this
41
- * long so the client-side indicator has time to visually clear.
42
- * Tuned for the longest common expiry (Discord ~10s). The interval
43
- * stays running; ticks inside the pause just skip the setTyping call.
44
- */
45
- const POST_DELIVERY_PAUSE_MS = 10000;
46
-
47
- interface TypingAdapter {
48
- setTyping?(channelType: string, platformId: string, threadId: string | null): Promise<void>;
49
- }
50
-
51
- interface TypingTarget {
52
- agentGroupId: string;
53
- channelType: string;
54
- platformId: string;
55
- threadId: string | null;
56
- interval: NodeJS.Timeout;
57
- startedAt: number;
58
- pausedUntil: number; // epoch ms; 0 = not paused
59
- }
60
-
61
- let adapter: TypingAdapter | null = null;
62
- const typingRefreshers = new Map<string, TypingTarget>();
63
-
64
- /**
65
- * Bind the typing module to the channel delivery adapter so it can
66
- * call `setTyping`. Called once by `src/delivery.ts` inside
67
- * `setDeliveryAdapter`. Passing a fresh adapter replaces the prior
68
- * binding and leaves active refreshers in place (they'll use the
69
- * new adapter on their next tick).
70
- */
71
- export function setTypingAdapter(a: TypingAdapter): void {
72
- adapter = a;
73
- }
74
-
75
- async function triggerTyping(channelType: string, platformId: string, threadId: string | null): Promise<void> {
76
- try {
77
- await adapter?.setTyping?.(channelType, platformId, threadId);
78
- } catch {
79
- // Typing is best-effort — don't let it fail delivery or routing.
80
- }
81
- }
82
-
83
- function isHeartbeatFresh(agentGroupId: string, sessionId: string): boolean {
84
- const hbPath = heartbeatPath(agentGroupId, sessionId);
85
- try {
86
- const stat = fs.statSync(hbPath);
87
- return Date.now() - stat.mtimeMs < HEARTBEAT_FRESH_MS;
88
- } catch {
89
- return false;
90
- }
91
- }
92
-
93
- export function startTypingRefresh(
94
- sessionId: string,
95
- agentGroupId: string,
96
- channelType: string,
97
- platformId: string,
98
- threadId: string | null,
99
- ): void {
100
- const existing = typingRefreshers.get(sessionId);
101
- if (existing) {
102
- // Already refreshing. Fire an immediate tick for the new inbound
103
- // event and reset the grace window — the new message restarts
104
- // the container-wake latency budget. Also clear any lingering
105
- // post-delivery pause: a new inbound means the user expects
106
- // typing to show immediately.
107
- triggerTyping(channelType, platformId, threadId).catch(() => {});
108
- existing.startedAt = Date.now();
109
- existing.pausedUntil = 0;
110
- return;
111
- }
112
-
113
- // Immediate tick + periodic refresh.
114
- triggerTyping(channelType, platformId, threadId).catch(() => {});
115
- const startedAt = Date.now();
116
- const interval = setInterval(() => {
117
- const entry = typingRefreshers.get(sessionId);
118
- if (!entry) return; // stopped externally since this tick was scheduled
119
-
120
- // Inside a post-delivery pause: skip setTyping but keep the
121
- // interval running so we resume automatically once the pause
122
- // expires.
123
- if (entry.pausedUntil > Date.now()) return;
124
-
125
- const withinGrace = Date.now() - entry.startedAt < TYPING_GRACE_MS;
126
- if (withinGrace || isHeartbeatFresh(entry.agentGroupId, sessionId)) {
127
- triggerTyping(entry.channelType, entry.platformId, entry.threadId).catch(() => {});
128
- return;
129
- }
130
-
131
- // Out of grace AND heartbeat stale — agent is idle, stop refreshing.
132
- clearInterval(entry.interval);
133
- typingRefreshers.delete(sessionId);
134
- }, TYPING_REFRESH_MS);
135
- // unref so a stale refresher can't hold the event loop alive.
136
- interval.unref();
137
- typingRefreshers.set(sessionId, {
138
- agentGroupId,
139
- channelType,
140
- platformId,
141
- threadId,
142
- interval,
143
- startedAt,
144
- pausedUntil: 0,
145
- });
146
- }
147
-
148
- /**
149
- * Pause the typing refresh for POST_DELIVERY_PAUSE_MS. Called after
150
- * a user-facing message is delivered so the client-side indicator
151
- * has a chance to visually clear before the agent's next SDK event
152
- * pushes it back on. No-op if no refresh is active for this session.
153
- */
154
- export function pauseTypingRefreshAfterDelivery(sessionId: string): void {
155
- const entry = typingRefreshers.get(sessionId);
156
- if (!entry) return;
157
- entry.pausedUntil = Date.now() + POST_DELIVERY_PAUSE_MS;
158
- }
159
-
160
- export function stopTypingRefresh(sessionId: string): void {
161
- const entry = typingRefreshers.get(sessionId);
162
- if (!entry) return;
163
- clearInterval(entry.interval);
164
- typingRefreshers.delete(sessionId);
165
- }
@@ -1,103 +0,0 @@
1
- /**
2
- * Per-agent allowlist for OAuth connections — the `agent_app_connections`
3
- * join table. A connection is only visible/injectable to an agent group
4
- * if there's a row joining the two.
5
- */
6
- import { getDb } from '../db/connection.js';
7
- import type { Database } from '../db/connection.js';
8
-
9
- function db(): Database {
10
- return getDb();
11
- }
12
-
13
- function nowIso(): string {
14
- return new Date().toISOString();
15
- }
16
-
17
- export interface AgentForConnection {
18
- agent_group_id: string;
19
- agent_group_folder: string;
20
- agent_group_name: string;
21
- created_at: string;
22
- }
23
-
24
- export function listAgentsForConnection(connectionId: string): AgentForConnection[] {
25
- return db()
26
- .prepare<AgentForConnection>(
27
- `SELECT a.agent_group_id AS agent_group_id,
28
- g.folder AS agent_group_folder,
29
- g.name AS agent_group_name,
30
- a.created_at AS created_at
31
- FROM agent_app_connections a
32
- JOIN agent_groups g ON g.id = a.agent_group_id
33
- WHERE a.app_connection_id = @connection_id
34
- ORDER BY g.name`,
35
- )
36
- .all({ connection_id: connectionId });
37
- }
38
-
39
- /** Map of connectionId → agent count, populated in one query for the list view. */
40
- export function countAgentsByConnection(): Map<string, number> {
41
- const rows = db()
42
- .prepare<{ app_connection_id: string; n: number }>(
43
- `SELECT app_connection_id, COUNT(*) AS n
44
- FROM agent_app_connections
45
- GROUP BY app_connection_id`,
46
- )
47
- .all();
48
- const out = new Map<string, number>();
49
- for (const r of rows) out.set(r.app_connection_id, r.n);
50
- return out;
51
- }
52
-
53
- export function listConnectionsForAgent(agentGroupId: string): string[] {
54
- return db()
55
- .prepare<{ app_connection_id: string }>(
56
- `SELECT app_connection_id FROM agent_app_connections WHERE agent_group_id = @agent_group_id`,
57
- )
58
- .all({ agent_group_id: agentGroupId })
59
- .map((r) => r.app_connection_id);
60
- }
61
-
62
- /** Atomically replace the allowlist for a connection. */
63
- export function setAgentsForConnection(connectionId: string, agentGroupIds: string[]): void {
64
- const tx = db().transaction((ids: string[]) => {
65
- db()
66
- .prepare(`DELETE FROM agent_app_connections WHERE app_connection_id = @connection_id`)
67
- .run({ connection_id: connectionId });
68
- const insert = db().prepare(
69
- `INSERT OR IGNORE INTO agent_app_connections
70
- (agent_group_id, app_connection_id, created_at)
71
- VALUES (@agent_group_id, @app_connection_id, @created_at)`,
72
- );
73
- const now = nowIso();
74
- for (const id of ids) {
75
- insert.run({ agent_group_id: id, app_connection_id: connectionId, created_at: now });
76
- }
77
- });
78
- tx(agentGroupIds);
79
- }
80
-
81
- export function addAgentToConnection(connectionId: string, agentGroupId: string): void {
82
- db()
83
- .prepare(
84
- `INSERT OR IGNORE INTO agent_app_connections
85
- (agent_group_id, app_connection_id, created_at)
86
- VALUES (@agent_group_id, @app_connection_id, @created_at)`,
87
- )
88
- .run({
89
- agent_group_id: agentGroupId,
90
- app_connection_id: connectionId,
91
- created_at: nowIso(),
92
- });
93
- }
94
-
95
- export function removeAgentFromConnection(connectionId: string, agentGroupId: string): boolean {
96
- const r = db()
97
- .prepare(
98
- `DELETE FROM agent_app_connections
99
- WHERE app_connection_id = @connection_id AND agent_group_id = @agent_group_id`,
100
- )
101
- .run({ connection_id: connectionId, agent_group_id: agentGroupId });
102
- return r.changes > 0;
103
- }
@@ -1,64 +0,0 @@
1
- import crypto from 'crypto';
2
- import { afterEach, beforeEach, describe, expect, it } from 'vitest';
3
-
4
- import { closeDb, initTestDb, runMigrations } from '../db/index.js';
5
- import { _setMasterKeyForTest } from '../secrets/master-key.js';
6
- import { deleteAppConfig, getAppConfig, getAppConfigWithSecret, listAppConfigs, putAppConfig } from './app-configs.js';
7
-
8
- beforeEach(() => {
9
- const db = initTestDb();
10
- runMigrations(db);
11
- _setMasterKeyForTest(crypto.randomBytes(32));
12
- });
13
-
14
- afterEach(() => closeDb());
15
-
16
- describe('app_configs DB layer', () => {
17
- it('inserts a config and returns its id', () => {
18
- const id = putAppConfig('google', {
19
- client_id: 'abc.apps.googleusercontent.com',
20
- client_secret: 'super-secret',
21
- scopes_default: 'openid email',
22
- });
23
- expect(id).toMatch(/^[0-9a-f-]{36}$/);
24
- });
25
-
26
- it('round-trips client_secret via getAppConfigWithSecret', () => {
27
- putAppConfig('google', {
28
- client_id: 'abc',
29
- client_secret: 'shhh',
30
- });
31
- const got = getAppConfigWithSecret('google');
32
- expect(got?.client_secret).toBe('shhh');
33
- expect(got?.client_id).toBe('abc');
34
- });
35
-
36
- it('hides client_secret from public reads', () => {
37
- putAppConfig('google', { client_id: 'abc', client_secret: 'shhh' });
38
- const row = getAppConfig('google') as Record<string, unknown> | undefined;
39
- expect(row).toBeDefined();
40
- expect(row).not.toHaveProperty('client_secret');
41
- expect(row).not.toHaveProperty('client_secret_encrypted');
42
- });
43
-
44
- it('updates an existing provider in place', () => {
45
- const id1 = putAppConfig('google', { client_id: 'v1', client_secret: 's1' });
46
- const id2 = putAppConfig('google', { client_id: 'v2', client_secret: 's2' });
47
- expect(id1).toBe(id2);
48
- expect(getAppConfig('google')?.client_id).toBe('v2');
49
- expect(getAppConfigWithSecret('google')?.client_secret).toBe('s2');
50
- });
51
-
52
- it('lists configs alphabetically by provider', () => {
53
- putAppConfig('zeta', { client_id: 'z', client_secret: 'sz' });
54
- putAppConfig('alpha', { client_id: 'a', client_secret: 'sa' });
55
- expect(listAppConfigs().map((r) => r.provider)).toEqual(['alpha', 'zeta']);
56
- });
57
-
58
- it('deletes by provider', () => {
59
- putAppConfig('google', { client_id: 'abc', client_secret: 'shhh' });
60
- expect(deleteAppConfig('google')).toBe(true);
61
- expect(getAppConfig('google')).toBeUndefined();
62
- expect(deleteAppConfig('google')).toBe(false);
63
- });
64
- });