@openparachute/agent 0.1.2 → 0.2.2

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 (608) hide show
  1. package/.parachute/module.json +124 -8
  2. package/LICENSE +2 -16
  3. package/README.md +118 -166
  4. package/package.json +35 -42
  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/dist/assets/index-C-iWdFFV.css +1 -0
  103. package/web/ui/dist/assets/index-VFETBk0a.js +60 -0
  104. package/web/ui/dist/index.html +15 -0
  105. package/web/ui/tsconfig.json +2 -1
  106. package/.claude/scheduled_tasks.lock +0 -1
  107. package/.claude/settings.json +0 -5
  108. package/.claude/skills/add-atomic-chat-tool/SKILL.md +0 -243
  109. package/.claude/skills/add-atomic-chat-tool/atomic-chat-mcp-stdio.ts +0 -229
  110. package/.claude/skills/add-codex/SKILL.md +0 -161
  111. package/.claude/skills/add-dashboard/SKILL.md +0 -138
  112. package/.claude/skills/add-dashboard/resources/dashboard-pusher.ts +0 -495
  113. package/.claude/skills/add-emacs/SKILL.md +0 -296
  114. package/.claude/skills/add-gcal-tool/SKILL.md +0 -210
  115. package/.claude/skills/add-gchat/REMOVE.md +0 -6
  116. package/.claude/skills/add-gchat/SKILL.md +0 -92
  117. package/.claude/skills/add-gchat/VERIFY.md +0 -3
  118. package/.claude/skills/add-github/REMOVE.md +0 -6
  119. package/.claude/skills/add-github/SKILL.md +0 -148
  120. package/.claude/skills/add-github/VERIFY.md +0 -3
  121. package/.claude/skills/add-gmail-tool/SKILL.md +0 -229
  122. package/.claude/skills/add-imessage/REMOVE.md +0 -6
  123. package/.claude/skills/add-imessage/SKILL.md +0 -113
  124. package/.claude/skills/add-imessage/VERIFY.md +0 -3
  125. package/.claude/skills/add-karpathy-llm-wiki/SKILL.md +0 -110
  126. package/.claude/skills/add-karpathy-llm-wiki/llm-wiki.md +0 -75
  127. package/.claude/skills/add-linear/REMOVE.md +0 -6
  128. package/.claude/skills/add-linear/SKILL.md +0 -168
  129. package/.claude/skills/add-linear/VERIFY.md +0 -3
  130. package/.claude/skills/add-macos-statusbar/SKILL.md +0 -133
  131. package/.claude/skills/add-macos-statusbar/add/src/statusbar.swift +0 -147
  132. package/.claude/skills/add-matrix/REMOVE.md +0 -6
  133. package/.claude/skills/add-matrix/SKILL.md +0 -148
  134. package/.claude/skills/add-matrix/VERIFY.md +0 -3
  135. package/.claude/skills/add-ollama-provider/SKILL.md +0 -179
  136. package/.claude/skills/add-ollama-tool/SKILL.md +0 -193
  137. package/.claude/skills/add-opencode/SKILL.md +0 -229
  138. package/.claude/skills/add-parallel/SKILL.md +0 -290
  139. package/.claude/skills/add-resend/REMOVE.md +0 -6
  140. package/.claude/skills/add-resend/SKILL.md +0 -93
  141. package/.claude/skills/add-resend/VERIFY.md +0 -3
  142. package/.claude/skills/add-signal/REMOVE.md +0 -13
  143. package/.claude/skills/add-signal/SKILL.md +0 -318
  144. package/.claude/skills/add-signal/VERIFY.md +0 -5
  145. package/.claude/skills/add-slack/REMOVE.md +0 -6
  146. package/.claude/skills/add-slack/SKILL.md +0 -112
  147. package/.claude/skills/add-slack/VERIFY.md +0 -3
  148. package/.claude/skills/add-teams/REMOVE.md +0 -6
  149. package/.claude/skills/add-teams/SKILL.md +0 -207
  150. package/.claude/skills/add-teams/VERIFY.md +0 -3
  151. package/.claude/skills/add-vercel/SKILL.md +0 -147
  152. package/.claude/skills/add-vercel/container-skills/vercel-cli/SKILL.md +0 -103
  153. package/.claude/skills/add-webex/REMOVE.md +0 -6
  154. package/.claude/skills/add-webex/SKILL.md +0 -88
  155. package/.claude/skills/add-webex/VERIFY.md +0 -3
  156. package/.claude/skills/add-wechat/REMOVE.md +0 -49
  157. package/.claude/skills/add-wechat/SKILL.md +0 -170
  158. package/.claude/skills/add-wechat/scripts/wire-dm.ts +0 -172
  159. package/.claude/skills/add-whatsapp/SKILL.md +0 -264
  160. package/.claude/skills/add-whatsapp-cloud/REMOVE.md +0 -6
  161. package/.claude/skills/add-whatsapp-cloud/SKILL.md +0 -95
  162. package/.claude/skills/add-whatsapp-cloud/VERIFY.md +0 -3
  163. package/.claude/skills/claw/SKILL.md +0 -131
  164. package/.claude/skills/claw/scripts/claw +0 -374
  165. package/.claude/skills/convert-to-apple-container/SKILL.md +0 -212
  166. package/.claude/skills/customize/SKILL.md +0 -110
  167. package/.claude/skills/debug/SKILL.md +0 -349
  168. package/.claude/skills/get-qodo-rules/SKILL.md +0 -122
  169. package/.claude/skills/get-qodo-rules/references/output-format.md +0 -41
  170. package/.claude/skills/get-qodo-rules/references/pagination.md +0 -33
  171. package/.claude/skills/get-qodo-rules/references/repository-scope.md +0 -26
  172. package/.claude/skills/init-first-agent/SKILL.md +0 -120
  173. package/.claude/skills/init-onecli/SKILL.md +0 -270
  174. package/.claude/skills/manage-channels/SKILL.md +0 -87
  175. package/.claude/skills/manage-mounts/SKILL.md +0 -47
  176. package/.claude/skills/migrate-from-openclaw/MIGRATE_CRONS.md +0 -100
  177. package/.claude/skills/migrate-from-openclaw/SKILL.md +0 -447
  178. package/.claude/skills/migrate-from-openclaw/scripts/discover-openclaw.ts +0 -734
  179. package/.claude/skills/migrate-from-openclaw/scripts/extract-channel-credentials.ts +0 -476
  180. package/.claude/skills/migrate-nanoclaw/SKILL.md +0 -484
  181. package/.claude/skills/migrate-nanoclaw/diagnostics.md +0 -51
  182. package/.claude/skills/qodo-pr-resolver/SKILL.md +0 -326
  183. package/.claude/skills/qodo-pr-resolver/resources/providers.md +0 -329
  184. package/.claude/skills/update-nanoclaw/SKILL.md +0 -243
  185. package/.claude/skills/update-nanoclaw/diagnostics.md +0 -48
  186. package/.claude/skills/update-skills/SKILL.md +0 -130
  187. package/.claude/skills/use-native-credential-proxy/SKILL.md +0 -167
  188. package/.claude/skills/x-integration/SKILL.md +0 -417
  189. package/.claude/skills/x-integration/agent.ts +0 -243
  190. package/.claude/skills/x-integration/host.ts +0 -155
  191. package/.claude/skills/x-integration/lib/browser.ts +0 -148
  192. package/.claude/skills/x-integration/lib/config.ts +0 -62
  193. package/.claude/skills/x-integration/scripts/like.ts +0 -56
  194. package/.claude/skills/x-integration/scripts/post.ts +0 -66
  195. package/.claude/skills/x-integration/scripts/quote.ts +0 -80
  196. package/.claude/skills/x-integration/scripts/reply.ts +0 -74
  197. package/.claude/skills/x-integration/scripts/retweet.ts +0 -62
  198. package/.claude/skills/x-integration/scripts/setup.ts +0 -87
  199. package/.github/CODEOWNERS +0 -10
  200. package/.github/PULL_REQUEST_TEMPLATE.md +0 -18
  201. package/.github/workflows/bump-version.yml +0 -35
  202. package/.github/workflows/ci.yml +0 -39
  203. package/.github/workflows/label-pr.yml +0 -40
  204. package/.github/workflows/update-tokens.yml +0 -43
  205. package/.husky/pre-commit +0 -1
  206. package/.mcp.json +0 -3
  207. package/.nvmrc +0 -1
  208. package/.prettierrc +0 -4
  209. package/CHANGELOG.md +0 -263
  210. package/CLAUDE.md +0 -307
  211. package/CODE_OF_CONDUCT.md +0 -128
  212. package/CONTRIBUTING.md +0 -159
  213. package/CONTRIBUTORS.md +0 -26
  214. package/LICENSE-NANOCLAW-MIT +0 -21
  215. package/README_ja.md +0 -194
  216. package/README_zh.md +0 -194
  217. package/assets/nanoclaw-favicon.png +0 -0
  218. package/assets/nanoclaw-icon.png +0 -0
  219. package/assets/nanoclaw-logo-dark.png +0 -0
  220. package/assets/nanoclaw-logo.png +0 -0
  221. package/assets/nanoclaw-profile.jpeg +0 -0
  222. package/assets/nanoclaw-sales.png +0 -0
  223. package/assets/social-preview.jpg +0 -0
  224. package/config-examples/mount-allowlist.json +0 -25
  225. package/container/.dockerignore +0 -2
  226. package/container/CLAUDE.md +0 -21
  227. package/container/Dockerfile +0 -121
  228. package/container/agent-runner/bun.lock +0 -243
  229. package/container/agent-runner/package.json +0 -22
  230. package/container/agent-runner/scripts/sdk-signal-probe.ts +0 -169
  231. package/container/agent-runner/src/config.ts +0 -55
  232. package/container/agent-runner/src/db/connection.ts +0 -267
  233. package/container/agent-runner/src/db/index.ts +0 -20
  234. package/container/agent-runner/src/db/messages-in.ts +0 -138
  235. package/container/agent-runner/src/db/messages-out.ts +0 -143
  236. package/container/agent-runner/src/db/session-routing.ts +0 -30
  237. package/container/agent-runner/src/db/session-state.test.ts +0 -100
  238. package/container/agent-runner/src/db/session-state.ts +0 -79
  239. package/container/agent-runner/src/destinations.ts +0 -135
  240. package/container/agent-runner/src/formatter.test.ts +0 -167
  241. package/container/agent-runner/src/formatter.ts +0 -260
  242. package/container/agent-runner/src/index.ts +0 -110
  243. package/container/agent-runner/src/integration.test.ts +0 -121
  244. package/container/agent-runner/src/mcp-tools/agents.instructions.md +0 -26
  245. package/container/agent-runner/src/mcp-tools/agents.ts +0 -66
  246. package/container/agent-runner/src/mcp-tools/core.instructions.md +0 -27
  247. package/container/agent-runner/src/mcp-tools/core.ts +0 -262
  248. package/container/agent-runner/src/mcp-tools/index.ts +0 -22
  249. package/container/agent-runner/src/mcp-tools/interactive.instructions.md +0 -22
  250. package/container/agent-runner/src/mcp-tools/interactive.ts +0 -169
  251. package/container/agent-runner/src/mcp-tools/scheduling.instructions.md +0 -40
  252. package/container/agent-runner/src/mcp-tools/scheduling.ts +0 -299
  253. package/container/agent-runner/src/mcp-tools/self-mod.instructions.md +0 -25
  254. package/container/agent-runner/src/mcp-tools/self-mod.ts +0 -120
  255. package/container/agent-runner/src/mcp-tools/server.ts +0 -54
  256. package/container/agent-runner/src/mcp-tools/types.ts +0 -6
  257. package/container/agent-runner/src/poll-loop.test.ts +0 -248
  258. package/container/agent-runner/src/poll-loop.ts +0 -437
  259. package/container/agent-runner/src/providers/claude.ts +0 -379
  260. package/container/agent-runner/src/providers/factory.test.ts +0 -19
  261. package/container/agent-runner/src/providers/factory.ts +0 -13
  262. package/container/agent-runner/src/providers/index.ts +0 -6
  263. package/container/agent-runner/src/providers/mock.ts +0 -77
  264. package/container/agent-runner/src/providers/provider-registry.ts +0 -33
  265. package/container/agent-runner/src/providers/types.ts +0 -82
  266. package/container/agent-runner/src/scheduling/task-script.ts +0 -121
  267. package/container/agent-runner/src/timezone.test.ts +0 -93
  268. package/container/agent-runner/src/timezone.ts +0 -107
  269. package/container/agent-runner/tsconfig.json +0 -14
  270. package/container/build.sh +0 -48
  271. package/container/entrypoint.sh +0 -16
  272. package/container/skills/agent-browser/SKILL.md +0 -159
  273. package/container/skills/frontend-engineer/SKILL.md +0 -157
  274. package/container/skills/self-customize/SKILL.md +0 -87
  275. package/container/skills/slack-formatting/SKILL.md +0 -94
  276. package/container/skills/vercel-cli/SKILL.md +0 -111
  277. package/container/skills/welcome/SKILL.md +0 -85
  278. package/docs/APPLE-CONTAINER-NETWORKING.md +0 -90
  279. package/docs/BRANCH-FORK-MAINTENANCE.md +0 -81
  280. package/docs/README.md +0 -25
  281. package/docs/SDK_DEEP_DIVE.md +0 -643
  282. package/docs/SECURITY.md +0 -162
  283. package/docs/agent-runner-details.md +0 -749
  284. package/docs/api-details.md +0 -365
  285. package/docs/architecture-diagram.html +0 -422
  286. package/docs/architecture-diagram.md +0 -215
  287. package/docs/architecture.md +0 -751
  288. package/docs/audit/2026-04-30-channel-endpoint-audit.md +0 -36
  289. package/docs/build-and-runtime.md +0 -80
  290. package/docs/cross-mount-stress/README.md +0 -112
  291. package/docs/cross-mount-stress/container-writer-retry.mjs +0 -55
  292. package/docs/cross-mount-stress/container-writer-slow.mjs +0 -42
  293. package/docs/cross-mount-stress/container-writer.mjs +0 -47
  294. package/docs/cross-mount-stress/host-writer-retry.mjs +0 -55
  295. package/docs/cross-mount-stress/host-writer-slow.mjs +0 -43
  296. package/docs/cross-mount-stress/host-writer.mjs +0 -47
  297. package/docs/db-central.md +0 -316
  298. package/docs/db-session.md +0 -183
  299. package/docs/db.md +0 -119
  300. package/docs/design/2026-04-29-vault-management-ui.md +0 -231
  301. package/docs/design/2026-04-30-channel-wiring-rework.md +0 -234
  302. package/docs/design/2026-05-01-channel-wiring-approvals-deep-dive.md +0 -272
  303. package/docs/design/2026-05-02-channel-policy-and-approval-routing.md +0 -250
  304. package/docs/docker-sandboxes.md +0 -359
  305. package/docs/isolation-model.md +0 -88
  306. package/docs/ollama.md +0 -79
  307. package/docs/parachute-integration.md +0 -109
  308. package/docs/post-night-rebirth-reflections.md +0 -151
  309. package/eslint.config.js +0 -32
  310. package/pnpm-workspace.yaml +0 -8
  311. package/repo-tokens/README.md +0 -113
  312. package/repo-tokens/action.yml +0 -186
  313. package/repo-tokens/badge.svg +0 -23
  314. package/repo-tokens/examples/green.svg +0 -14
  315. package/repo-tokens/examples/red.svg +0 -14
  316. package/repo-tokens/examples/yellow-green.svg +0 -14
  317. package/repo-tokens/examples/yellow.svg +0 -14
  318. package/scripts/chat.ts +0 -101
  319. package/scripts/cleanup-sessions.sh +0 -150
  320. package/scripts/init-cli-agent.ts +0 -172
  321. package/scripts/init-first-agent.ts +0 -378
  322. package/scripts/parachute.ts +0 -158
  323. package/scripts/run-migrations.ts +0 -105
  324. package/scripts/sanity-live-poll.ts +0 -95
  325. package/scripts/seed-discord.ts +0 -80
  326. package/scripts/test-v2-agent.ts +0 -106
  327. package/scripts/test-v2-channel-e2e.ts +0 -265
  328. package/scripts/test-v2-host.ts +0 -184
  329. package/src/channels/adapter.ts +0 -214
  330. package/src/channels/api-translator.test.ts +0 -306
  331. package/src/channels/api-translator.ts +0 -214
  332. package/src/channels/ask-question.ts +0 -46
  333. package/src/channels/channel-registry.test.ts +0 -421
  334. package/src/channels/channel-registry.ts +0 -313
  335. package/src/channels/chat-sdk-bridge.test.ts +0 -84
  336. package/src/channels/chat-sdk-bridge.ts +0 -652
  337. package/src/channels/cli.ts +0 -276
  338. package/src/channels/discord.ts +0 -90
  339. package/src/channels/index.ts +0 -17
  340. package/src/channels/telegram-markdown-sanitize.test.ts +0 -78
  341. package/src/channels/telegram-markdown-sanitize.ts +0 -55
  342. package/src/channels/telegram-pairing.test.ts +0 -254
  343. package/src/channels/telegram-pairing.ts +0 -339
  344. package/src/channels/telegram.ts +0 -279
  345. package/src/channels/trust-hint.test.ts +0 -48
  346. package/src/channels/trust-hint.ts +0 -75
  347. package/src/claude-md-compose.migrate.test.ts +0 -64
  348. package/src/claude-md-compose.ts +0 -205
  349. package/src/command-gate.ts +0 -63
  350. package/src/config.test.ts +0 -93
  351. package/src/config.ts +0 -128
  352. package/src/container-config.ts +0 -167
  353. package/src/container-runner.test.ts +0 -32
  354. package/src/container-runner.ts +0 -576
  355. package/src/container-runtime.test.ts +0 -269
  356. package/src/container-runtime.ts +0 -167
  357. package/src/db/_bun-sqlite-shim.ts +0 -88
  358. package/src/db/agent-activity.test.ts +0 -155
  359. package/src/db/agent-activity.ts +0 -121
  360. package/src/db/agent-groups.ts +0 -77
  361. package/src/db/connection.migrate.test.ts +0 -176
  362. package/src/db/connection.ts +0 -259
  363. package/src/db/db-v2.test.ts +0 -440
  364. package/src/db/dropped-messages.ts +0 -44
  365. package/src/db/index.ts +0 -40
  366. package/src/db/messaging-groups.ts +0 -252
  367. package/src/db/migrations/001-initial.ts +0 -112
  368. package/src/db/migrations/002-chat-sdk-state.ts +0 -36
  369. package/src/db/migrations/008-dropped-messages.ts +0 -27
  370. package/src/db/migrations/009-drop-pending-credentials.ts +0 -13
  371. package/src/db/migrations/010-engage-modes.ts +0 -103
  372. package/src/db/migrations/011-pending-sender-approvals.ts +0 -40
  373. package/src/db/migrations/012-channel-registration.ts +0 -48
  374. package/src/db/migrations/013-approval-render-metadata.ts +0 -27
  375. package/src/db/migrations/014-secrets.ts +0 -44
  376. package/src/db/migrations/015-secrets-drop-host-pattern.ts +0 -18
  377. package/src/db/migrations/016-secret-assignments.ts +0 -30
  378. package/src/db/migrations/017-agent-activity.ts +0 -40
  379. package/src/db/migrations/018-oauth-app-configs.ts +0 -34
  380. package/src/db/migrations/019-oauth-app-connections.ts +0 -48
  381. package/src/db/migrations/020-agent-app-connections.ts +0 -28
  382. package/src/db/migrations/021-pending-oauth-states.ts +0 -35
  383. package/src/db/migrations/022-app-connections-provider.ts +0 -25
  384. package/src/db/migrations/023-agent-group-secret-mode.test.ts +0 -124
  385. package/src/db/migrations/023-agent-group-secret-mode.ts +0 -65
  386. package/src/db/migrations/024-collapse-approvals.test.ts +0 -249
  387. package/src/db/migrations/024-collapse-approvals.ts +0 -182
  388. package/src/db/migrations/025-secret-mode-check.test.ts +0 -155
  389. package/src/db/migrations/025-secret-mode-check.ts +0 -49
  390. package/src/db/migrations/026-user-dms-bot-id.test.ts +0 -116
  391. package/src/db/migrations/026-user-dms-bot-id.ts +0 -54
  392. package/src/db/migrations/027-provider-credentials.ts +0 -41
  393. package/src/db/migrations/_test-helpers.ts +0 -41
  394. package/src/db/migrations/index.ts +0 -127
  395. package/src/db/migrations/module-agent-to-agent-destinations.ts +0 -84
  396. package/src/db/migrations/module-approvals-pending-approvals.ts +0 -42
  397. package/src/db/migrations/module-approvals-title-options.ts +0 -40
  398. package/src/db/schema.ts +0 -258
  399. package/src/db/session-db.test.ts +0 -93
  400. package/src/db/session-db.ts +0 -325
  401. package/src/db/sessions.ts +0 -241
  402. package/src/delivery.test.ts +0 -148
  403. package/src/delivery.ts +0 -445
  404. package/src/env.ts +0 -74
  405. package/src/group-folder.test.ts +0 -35
  406. package/src/group-folder.ts +0 -44
  407. package/src/group-init.ts +0 -92
  408. package/src/host-core.test.ts +0 -456
  409. package/src/host-sweep.test.ts +0 -146
  410. package/src/host-sweep.ts +0 -287
  411. package/src/index.ts +0 -232
  412. package/src/install-slug.ts +0 -33
  413. package/src/log.test.ts +0 -81
  414. package/src/log.ts +0 -117
  415. package/src/mcp/http.ts +0 -72
  416. package/src/mcp/server.ts +0 -92
  417. package/src/mcp/stdio.ts +0 -51
  418. package/src/mcp/tools/activity.ts +0 -88
  419. package/src/mcp/tools/agent-groups.ts +0 -183
  420. package/src/mcp/tools/approvals.ts +0 -122
  421. package/src/mcp/tools/channels.test.ts +0 -126
  422. package/src/mcp/tools/channels.ts +0 -134
  423. package/src/mcp/tools/index.ts +0 -27
  424. package/src/mcp/tools/oauth.ts +0 -48
  425. package/src/mcp/tools/secrets.ts +0 -169
  426. package/src/mcp/tools/sessions.ts +0 -135
  427. package/src/mcp/types.ts +0 -51
  428. package/src/modules/agent-to-agent/agent-route.test.ts +0 -46
  429. package/src/modules/agent-to-agent/agent-route.ts +0 -223
  430. package/src/modules/agent-to-agent/create-agent.ts +0 -127
  431. package/src/modules/agent-to-agent/db/agent-destinations.ts +0 -135
  432. package/src/modules/agent-to-agent/index.ts +0 -22
  433. package/src/modules/agent-to-agent/write-destinations.ts +0 -59
  434. package/src/modules/approvals/agent.md +0 -45
  435. package/src/modules/approvals/index.ts +0 -21
  436. package/src/modules/approvals/picks.test.ts +0 -291
  437. package/src/modules/approvals/primitive.ts +0 -279
  438. package/src/modules/approvals/project.md +0 -27
  439. package/src/modules/approvals/response-handler.ts +0 -87
  440. package/src/modules/index.ts +0 -24
  441. package/src/modules/interactive/agent.md +0 -21
  442. package/src/modules/interactive/index.ts +0 -69
  443. package/src/modules/interactive/project.md +0 -12
  444. package/src/modules/mount-security/expand-path.test.ts +0 -82
  445. package/src/modules/mount-security/index.ts +0 -459
  446. package/src/modules/mount-security/migrate.test.ts +0 -91
  447. package/src/modules/permissions/access.ts +0 -28
  448. package/src/modules/permissions/channel-approval.test.ts +0 -389
  449. package/src/modules/permissions/channel-approval.ts +0 -188
  450. package/src/modules/permissions/db/agent-group-members.ts +0 -44
  451. package/src/modules/permissions/db/pending-channel-approvals.test.ts +0 -86
  452. package/src/modules/permissions/db/pending-channel-approvals.ts +0 -66
  453. package/src/modules/permissions/db/pending-sender-approvals.ts +0 -60
  454. package/src/modules/permissions/db/user-dms.ts +0 -58
  455. package/src/modules/permissions/db/user-roles.ts +0 -85
  456. package/src/modules/permissions/db/users.ts +0 -38
  457. package/src/modules/permissions/index.ts +0 -421
  458. package/src/modules/permissions/permissions.test.ts +0 -358
  459. package/src/modules/permissions/sender-approval.test.ts +0 -641
  460. package/src/modules/permissions/sender-approval.ts +0 -165
  461. package/src/modules/permissions/user-dm.ts +0 -200
  462. package/src/modules/provider-credentials/db.ts +0 -121
  463. package/src/modules/provider-credentials/index.ts +0 -12
  464. package/src/modules/provider-credentials/spawn.test.ts +0 -206
  465. package/src/modules/provider-credentials/spawn.ts +0 -114
  466. package/src/modules/scheduling/actions.ts +0 -113
  467. package/src/modules/scheduling/db.test.ts +0 -282
  468. package/src/modules/scheduling/db.ts +0 -148
  469. package/src/modules/scheduling/index.ts +0 -34
  470. package/src/modules/scheduling/recurrence.test.ts +0 -98
  471. package/src/modules/scheduling/recurrence.ts +0 -54
  472. package/src/modules/self-mod/agent.md +0 -30
  473. package/src/modules/self-mod/apply.ts +0 -85
  474. package/src/modules/self-mod/index.ts +0 -30
  475. package/src/modules/self-mod/project.md +0 -39
  476. package/src/modules/self-mod/request.ts +0 -91
  477. package/src/modules/typing/index.ts +0 -165
  478. package/src/oauth/agent-app-connections.ts +0 -103
  479. package/src/oauth/app-configs.test.ts +0 -64
  480. package/src/oauth/app-configs.ts +0 -114
  481. package/src/oauth/app-connections.test.ts +0 -109
  482. package/src/oauth/app-connections.ts +0 -178
  483. package/src/oauth/crypto.ts +0 -56
  484. package/src/oauth/flow.ts +0 -104
  485. package/src/oauth/providers/google.test.ts +0 -38
  486. package/src/oauth/providers/google.ts +0 -46
  487. package/src/oauth/providers/index.ts +0 -48
  488. package/src/oauth/state-store.test.ts +0 -54
  489. package/src/oauth/state-store.ts +0 -93
  490. package/src/parachute/README.md +0 -27
  491. package/src/parachute/create-agent.test.ts +0 -83
  492. package/src/parachute/create-agent.ts +0 -122
  493. package/src/parachute/group-status.test.ts +0 -165
  494. package/src/parachute/group-status.ts +0 -136
  495. package/src/parachute/types.ts +0 -41
  496. package/src/parachute/vault-mcp.test.ts +0 -251
  497. package/src/parachute/vault-mcp.ts +0 -232
  498. package/src/platform-id.test.ts +0 -104
  499. package/src/platform-id.ts +0 -109
  500. package/src/providers/index.ts +0 -6
  501. package/src/providers/provider-container-registry.ts +0 -58
  502. package/src/response-registry.ts +0 -45
  503. package/src/router.ts +0 -530
  504. package/src/secrets/crypto.test.ts +0 -45
  505. package/src/secrets/crypto.ts +0 -55
  506. package/src/secrets/index.ts +0 -461
  507. package/src/secrets/master-key.ts +0 -70
  508. package/src/secrets/secrets.test.ts +0 -651
  509. package/src/session-manager.attachments.test.ts +0 -171
  510. package/src/session-manager.dup-skip.test.ts +0 -173
  511. package/src/session-manager.migrate.test.ts +0 -59
  512. package/src/session-manager.ts +0 -451
  513. package/src/startup-bootstrap.test.ts +0 -226
  514. package/src/startup-bootstrap.ts +0 -207
  515. package/src/state-sqlite.ts +0 -182
  516. package/src/timezone.test.ts +0 -64
  517. package/src/timezone.ts +0 -37
  518. package/src/types.ts +0 -233
  519. package/src/web/auth.test.ts +0 -335
  520. package/src/web/auth.ts +0 -214
  521. package/src/web/discord-validate.test.ts +0 -77
  522. package/src/web/discord-validate.ts +0 -88
  523. package/src/web/hub-discovery.test.ts +0 -98
  524. package/src/web/hub-discovery.ts +0 -69
  525. package/src/web/routes/activity.ts +0 -106
  526. package/src/web/routes/agent-provider.test.ts +0 -282
  527. package/src/web/routes/agent-provider.ts +0 -309
  528. package/src/web/routes/approvals.ts +0 -185
  529. package/src/web/routes/apps.ts +0 -434
  530. package/src/web/routes/channels-mg-detail.test.ts +0 -324
  531. package/src/web/routes/channels-mga-detail.test.ts +0 -472
  532. package/src/web/routes/channels.ts +0 -311
  533. package/src/web/routes/oauth-providers.ts +0 -42
  534. package/src/web/routes/secrets.test.ts +0 -220
  535. package/src/web/routes/secrets.ts +0 -317
  536. package/src/web/routes/sessions.ts +0 -123
  537. package/src/web/routes/settings.test.ts +0 -106
  538. package/src/web/routes/settings.ts +0 -247
  539. package/src/web/routes/setup-status.ts +0 -205
  540. package/src/web/routes/vaults.test.ts +0 -389
  541. package/src/web/routes/vaults.ts +0 -225
  542. package/src/web/server-version.test.ts +0 -16
  543. package/src/web/server.ts +0 -1024
  544. package/src/web/services-manifest.test.ts +0 -148
  545. package/src/web/services-manifest.ts +0 -66
  546. package/src/web/static-serve.test.ts +0 -255
  547. package/src/web/static-serve.ts +0 -104
  548. package/src/web/telegram-validate.test.ts +0 -116
  549. package/src/web/telegram-validate.ts +0 -107
  550. package/src/web/vault-proxy.test.ts +0 -214
  551. package/src/web/vault-proxy.ts +0 -120
  552. package/src/web/wire-channel.ts +0 -181
  553. package/src/webhook-server.ts +0 -134
  554. package/vitest.config.ts +0 -18
  555. package/web/README.md +0 -63
  556. package/web/ui/index.html +0 -13
  557. package/web/ui/package.json +0 -35
  558. package/web/ui/pnpm-lock.yaml +0 -2164
  559. package/web/ui/scripts/verify-base.mjs +0 -31
  560. package/web/ui/src/App.tsx +0 -88
  561. package/web/ui/src/components/ActivityFeed.tsx +0 -444
  562. package/web/ui/src/components/AgentGroupPicker.tsx +0 -263
  563. package/web/ui/src/components/AgentProviderCards.tsx +0 -220
  564. package/web/ui/src/components/CredentialForm.tsx +0 -214
  565. package/web/ui/src/components/ScopeGrants.tsx +0 -74
  566. package/web/ui/src/components/StatusDot.tsx +0 -43
  567. package/web/ui/src/components/VaultPicker.tsx +0 -127
  568. package/web/ui/src/components/setup/AdapterInstallStep.tsx +0 -178
  569. package/web/ui/src/components/setup/AgentGroupStep.tsx +0 -43
  570. package/web/ui/src/components/setup/ChannelPickStep.tsx +0 -74
  571. package/web/ui/src/components/setup/DoneStep.tsx +0 -49
  572. package/web/ui/src/components/setup/PrereqStep.tsx +0 -129
  573. package/web/ui/src/components/setup/TestConnectionStep.tsx +0 -108
  574. package/web/ui/src/components/setup/TestMessageStep.tsx +0 -104
  575. package/web/ui/src/components/setup/WireChannelStep.tsx +0 -166
  576. package/web/ui/src/components/setup/types.ts +0 -105
  577. package/web/ui/src/lib/api.test.ts +0 -410
  578. package/web/ui/src/lib/api.ts +0 -1248
  579. package/web/ui/src/lib/auth.test.ts +0 -352
  580. package/web/ui/src/lib/auth.ts +0 -405
  581. package/web/ui/src/lib/channel-adapters.ts +0 -136
  582. package/web/ui/src/main.tsx +0 -19
  583. package/web/ui/src/routes/ApprovalsList.tsx +0 -294
  584. package/web/ui/src/routes/Apps.tsx +0 -613
  585. package/web/ui/src/routes/ChannelWireDetail.test.tsx +0 -233
  586. package/web/ui/src/routes/ChannelWireDetail.tsx +0 -403
  587. package/web/ui/src/routes/ChannelsList.tsx +0 -158
  588. package/web/ui/src/routes/GroupDetail.test.tsx +0 -206
  589. package/web/ui/src/routes/GroupDetail.tsx +0 -880
  590. package/web/ui/src/routes/GroupList.tsx +0 -187
  591. package/web/ui/src/routes/MessagingGroupDetail.test.tsx +0 -233
  592. package/web/ui/src/routes/MessagingGroupDetail.tsx +0 -306
  593. package/web/ui/src/routes/NewGroupWizard.tsx +0 -390
  594. package/web/ui/src/routes/OAuthCallback.tsx +0 -56
  595. package/web/ui/src/routes/SecretsList.tsx +0 -942
  596. package/web/ui/src/routes/SessionsList.tsx +0 -220
  597. package/web/ui/src/routes/SettingsAgentProvider.tsx +0 -109
  598. package/web/ui/src/routes/SettingsApprovals.tsx +0 -234
  599. package/web/ui/src/routes/SetupWizard.tsx +0 -219
  600. package/web/ui/src/routes/VaultDetail.test.tsx +0 -363
  601. package/web/ui/src/routes/VaultDetail.tsx +0 -960
  602. package/web/ui/src/routes/VaultsList.tsx +0 -295
  603. package/web/ui/src/routes/WireChannelPage.tsx +0 -413
  604. package/web/ui/src/styles.css +0 -608
  605. package/web/ui/src/test/setup.ts +0 -23
  606. package/web/ui/src/vite-env.d.ts +0 -10
  607. package/web/ui/vite.config.ts +0 -34
  608. package/web/ui/vitest.config.ts +0 -25
@@ -1,110 +0,0 @@
1
- /**
2
- * parachute-agent runner
3
- *
4
- * Runs inside a container. All IO goes through the session DB.
5
- * No stdin, no stdout markers, no IPC files.
6
- *
7
- * Config is read from /workspace/agent/container.json (mounted RO).
8
- * Only TZ comes from env.
9
- *
10
- * Mount structure:
11
- * /workspace/
12
- * inbound.db ← host-owned session DB (container reads only)
13
- * outbound.db ← container-owned session DB
14
- * .heartbeat ← container touches for liveness detection
15
- * outbox/ ← outbound files
16
- * agent/ ← agent group folder (CLAUDE.md, container.json, working files)
17
- * container.json ← per-group config (RO nested mount)
18
- * global/ ← shared global memory (RO)
19
- * /app/src/ ← shared agent-runner source (RO)
20
- * /app/skills/ ← shared skills (RO)
21
- * /home/node/.claude/ ← Claude SDK state + skill symlinks (RW)
22
- */
23
-
24
- import fs from 'fs';
25
- import path from 'path';
26
- import { fileURLToPath } from 'url';
27
-
28
- import { loadConfig } from './config.js';
29
- import { buildSystemPromptAddendum } from './destinations.js';
30
- // Providers barrel — each enabled provider self-registers on import.
31
- // Provider skills append imports to providers/index.ts.
32
- import './providers/index.js';
33
- import { createProvider, type ProviderName } from './providers/factory.js';
34
- import { runPollLoop } from './poll-loop.js';
35
-
36
- function log(msg: string): void {
37
- console.error(`[agent-runner] ${msg}`);
38
- }
39
-
40
- const CWD = '/workspace/agent';
41
-
42
- async function main(): Promise<void> {
43
- const config = loadConfig();
44
- const providerName = config.provider.toLowerCase() as ProviderName;
45
-
46
- log(`Starting v2 agent-runner (provider: ${providerName})`);
47
-
48
- // Runtime-generated system-prompt addendum: agent identity (name) plus
49
- // the live destinations map. Everything else (capabilities, per-module
50
- // instructions, per-channel formatting) is loaded by Claude Code from
51
- // /workspace/agent/CLAUDE.md — the composed entry imports the shared
52
- // base (/app/CLAUDE.md) and each enabled module's fragment. Per-group
53
- // memory lives in /workspace/agent/CLAUDE.local.md (auto-loaded).
54
- const instructions = buildSystemPromptAddendum(config.assistantName || undefined);
55
-
56
- // Discover additional directories mounted at /workspace/extra/*
57
- const additionalDirectories: string[] = [];
58
- const extraBase = '/workspace/extra';
59
- if (fs.existsSync(extraBase)) {
60
- for (const entry of fs.readdirSync(extraBase)) {
61
- const fullPath = path.join(extraBase, entry);
62
- if (fs.statSync(fullPath).isDirectory()) {
63
- additionalDirectories.push(fullPath);
64
- }
65
- }
66
- if (additionalDirectories.length > 0) {
67
- log(`Additional directories: ${additionalDirectories.join(', ')}`);
68
- }
69
- }
70
-
71
- // MCP server path — bun runs TS directly; no tsc build step in-image.
72
- const __dirname = path.dirname(fileURLToPath(import.meta.url));
73
- const mcpServerPath = path.join(__dirname, 'mcp-tools', 'index.ts');
74
-
75
- // Build MCP servers config: parachute-agent built-in + any from container.json.
76
- // Tools advertise as `mcp__parachute_agent__<verb>-<noun>` (the SDK's name
77
- // mangle replaces non-alphanum with underscore). Renamed from `paraclaw` in
78
- // 0.1.0; existing sessions need a restart to pick up the new prefix.
79
- const mcpServers: Record<string, { command: string; args: string[]; env: Record<string, string> }> = {
80
- 'parachute-agent': {
81
- command: 'bun',
82
- args: ['run', mcpServerPath],
83
- env: {},
84
- },
85
- };
86
-
87
- for (const [name, serverConfig] of Object.entries(config.mcpServers)) {
88
- mcpServers[name] = serverConfig;
89
- log(`Additional MCP server: ${name} (${serverConfig.command})`);
90
- }
91
-
92
- const provider = createProvider(providerName, {
93
- assistantName: config.assistantName || undefined,
94
- mcpServers,
95
- env: { ...process.env },
96
- additionalDirectories: additionalDirectories.length > 0 ? additionalDirectories : undefined,
97
- });
98
-
99
- await runPollLoop({
100
- provider,
101
- providerName,
102
- cwd: CWD,
103
- systemContext: { instructions },
104
- });
105
- }
106
-
107
- main().catch((err) => {
108
- log(`Fatal error: ${err instanceof Error ? err.message : String(err)}`);
109
- process.exit(1);
110
- });
@@ -1,121 +0,0 @@
1
- import { describe, it, expect, beforeEach, afterEach } from 'bun:test';
2
-
3
- import { initTestSessionDb, closeSessionDb, getInboundDb, getOutboundDb } from './db/connection.js';
4
- import { getUndeliveredMessages } from './db/messages-out.js';
5
- import { getPendingMessages } from './db/messages-in.js';
6
- import { MockProvider } from './providers/mock.js';
7
- import { runPollLoop } from './poll-loop.js';
8
-
9
- beforeEach(() => {
10
- initTestSessionDb();
11
- // Seed a destination so output parsing can resolve "discord-test" → routing
12
- getInboundDb()
13
- .prepare(
14
- `INSERT INTO destinations (name, display_name, type, channel_type, platform_id, agent_group_id)
15
- VALUES ('discord-test', 'Discord Test', 'channel', 'discord', 'chan-1', NULL)`,
16
- )
17
- .run();
18
- });
19
-
20
- afterEach(() => {
21
- closeSessionDb();
22
- });
23
-
24
- function insertMessage(id: string, content: object, opts?: { platformId?: string; channelType?: string; threadId?: string }) {
25
- getInboundDb()
26
- .prepare(
27
- `INSERT INTO messages_in (id, kind, timestamp, status, platform_id, channel_type, thread_id, content)
28
- VALUES (?, 'chat', datetime('now'), 'pending', ?, ?, ?, ?)`,
29
- )
30
- .run(id, opts?.platformId ?? null, opts?.channelType ?? null, opts?.threadId ?? null, JSON.stringify(content));
31
- }
32
-
33
- describe('poll loop integration', () => {
34
- it('should pick up a message, process it, and write a response', async () => {
35
- insertMessage('m1', { sender: 'Alice', text: 'What is the meaning of life?' }, { platformId: 'chan-1', channelType: 'discord', threadId: 'thread-1' });
36
-
37
- const provider = new MockProvider({}, () => '<message to="discord-test">42</message>');
38
-
39
- const controller = new AbortController();
40
- const loopPromise = runPollLoopWithTimeout(provider, controller.signal, 2000);
41
-
42
- await waitFor(() => getUndeliveredMessages().length > 0, 2000);
43
- controller.abort();
44
-
45
- const out = getUndeliveredMessages();
46
- expect(out).toHaveLength(1);
47
- expect(JSON.parse(out[0].content).text).toBe('42');
48
- expect(out[0].platform_id).toBe('chan-1');
49
- expect(out[0].channel_type).toBe('discord');
50
- expect(out[0].in_reply_to).toBe('m1');
51
-
52
- // Input message should be acked (not pending)
53
- const pending = getPendingMessages();
54
- expect(pending).toHaveLength(0);
55
-
56
- await loopPromise.catch(() => {});
57
- });
58
-
59
- it('should process multiple messages in a batch', async () => {
60
- insertMessage('m1', { sender: 'Alice', text: 'Hello' });
61
- insertMessage('m2', { sender: 'Bob', text: 'World' });
62
-
63
- const provider = new MockProvider({}, () => '<message to="discord-test">Got both messages</message>');
64
- const controller = new AbortController();
65
- const loopPromise = runPollLoopWithTimeout(provider, controller.signal, 2000);
66
-
67
- await waitFor(() => getUndeliveredMessages().length > 0, 2000);
68
- controller.abort();
69
-
70
- const out = getUndeliveredMessages();
71
- expect(out).toHaveLength(1);
72
- expect(JSON.parse(out[0].content).text).toBe('Got both messages');
73
-
74
- await loopPromise.catch(() => {});
75
- });
76
-
77
- it('should process messages arriving after loop starts', async () => {
78
- const provider = new MockProvider({}, () => '<message to="discord-test">Processed</message>');
79
- const controller = new AbortController();
80
- const loopPromise = runPollLoopWithTimeout(provider, controller.signal, 3000);
81
-
82
- // Insert message after loop has started
83
- await sleep(200);
84
- insertMessage('m-late', { sender: 'Charlie', text: 'Late arrival' });
85
-
86
- await waitFor(() => getUndeliveredMessages().length > 0, 2000);
87
- controller.abort();
88
-
89
- const out = getUndeliveredMessages();
90
- expect(out.length).toBeGreaterThanOrEqual(1);
91
-
92
- await loopPromise.catch(() => {});
93
- });
94
- });
95
-
96
- // Helper: run poll loop until aborted or timeout
97
- async function runPollLoopWithTimeout(provider: MockProvider, signal: AbortSignal, timeoutMs: number): Promise<void> {
98
- return Promise.race([
99
- runPollLoop({
100
- provider,
101
- providerName: 'mock',
102
- cwd: '/tmp',
103
- }),
104
- new Promise<void>((_, reject) => {
105
- signal.addEventListener('abort', () => reject(new Error('aborted')));
106
- }),
107
- new Promise<void>((_, reject) => setTimeout(() => reject(new Error('timeout')), timeoutMs)),
108
- ]);
109
- }
110
-
111
- async function waitFor(condition: () => boolean, timeoutMs: number): Promise<void> {
112
- const start = Date.now();
113
- while (!condition()) {
114
- if (Date.now() - start > timeoutMs) throw new Error('waitFor timeout');
115
- await sleep(50);
116
- }
117
- }
118
-
119
- function sleep(ms: number): Promise<void> {
120
- return new Promise((resolve) => setTimeout(resolve, ms));
121
- }
@@ -1,26 +0,0 @@
1
- ## Companion and collaborator agents (`create_agent`)
2
-
3
- `mcp__parachute_agent__create_agent({ name, instructions })` spins up a new long-lived agent and wires it as a destination — bidirectional, so you can send it tasks and it can message you back.
4
-
5
- ### How it works
6
-
7
- - Creates a new agent with its own container, workspace, and session. Your `instructions` string seeds the agent's `CLAUDE.local.md` — its starting role and personality.
8
- - The agent's `name` becomes a destination on both sides: you address it via `send_message({ to: "<name>", ... })`, and its replies arrive as inbound messages with `from="<name>"`.
9
- - Each agent has its own persistent workspace under `groups/<folder>/` — memory, conversation history, and notes all survive across sessions. This is a full standalone agent, not a stateless sub-query.
10
- - **Fire-and-forget:** the call returns immediately without waiting for the agent to confirm it's ready. Messages you send will queue until it's up.
11
-
12
- ### When to use
13
-
14
- - **Companions** — a long-running presence that accumulates context over time: a `Researcher` tracking an ongoing inquiry, a `Calendar` agent managing scheduling, an assistant that knows your preferences and history.
15
- - **Collaborators** — a parallel specialist that works independently and reports back: a `Builder` handling code edits while you stay in conversation, a `Reviewer` running checks in the background.
16
-
17
- The right frame is: does this agent need its own memory and context that builds over time, or does it need to work independently without blocking your turn? Either is a good reason to spawn one.
18
-
19
- ### When NOT to use
20
-
21
- - **One-off lookups or short tasks** — use the SDK `Agent` tool instead. It's stateless, spins up and completes in one shot, and leaves no persistent footprint.
22
- - **Work that finishes before the user's next message** — agents persist indefinitely. Don't create one for something you could do inline.
23
-
24
- ### Writing good `instructions`
25
-
26
- Cover: the agent's role, who it takes tasks from (you, by name), how it should report back (on completion only? with milestones for long work?), and any domain-specific rules. Don't restate Parachute Agent base behavior — the shared base is already loaded on the agent's end.
@@ -1,66 +0,0 @@
1
- /**
2
- * Agent management MCP tools: create_agent.
3
- *
4
- * send_to_agent was removed — sending to another agent is now just
5
- * send_message(to="agent-name") since agents and channels share the
6
- * unified destinations namespace.
7
- *
8
- * create_agent is admin-only. Non-admin containers never see this tool
9
- * (see mcp-tools/index.ts). The host re-checks permission on receive.
10
- */
11
- import { writeMessageOut } from '../db/messages-out.js';
12
- import { registerTools } from './server.js';
13
- import type { McpToolDefinition } from './types.js';
14
-
15
- function log(msg: string): void {
16
- console.error(`[mcp-tools] ${msg}`);
17
- }
18
-
19
- function generateId(): string {
20
- return `msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
21
- }
22
-
23
- function ok(text: string) {
24
- return { content: [{ type: 'text' as const, text }] };
25
- }
26
-
27
- function err(text: string) {
28
- return { content: [{ type: 'text' as const, text: `Error: ${text}` }], isError: true };
29
- }
30
-
31
- export const createAgent: McpToolDefinition = {
32
- tool: {
33
- name: 'create_agent',
34
- description:
35
- 'Create a long-lived companion sub-agent (research assistant, task manager, specialist) — the name becomes your destination for it. Admin-only. Fire-and-forget.',
36
- inputSchema: {
37
- type: 'object' as const,
38
- properties: {
39
- name: { type: 'string', description: 'Human-readable name (also becomes your destination name for this agent)' },
40
- instructions: { type: 'string', description: 'CLAUDE.md content for the new agent (personality, role, instructions)' },
41
- },
42
- required: ['name'],
43
- },
44
- },
45
- async handler(args) {
46
- const name = args.name as string;
47
- if (!name) return err('name is required');
48
-
49
- const requestId = generateId();
50
- writeMessageOut({
51
- id: requestId,
52
- kind: 'system',
53
- content: JSON.stringify({
54
- action: 'create_agent',
55
- requestId,
56
- name,
57
- instructions: (args.instructions as string) || null,
58
- }),
59
- });
60
-
61
- log(`create_agent: ${requestId} → "${name}"`);
62
- return ok(`Creating agent "${name}". You will be notified when it is ready.`);
63
- },
64
- };
65
-
66
- registerTools([createAgent]);
@@ -1,27 +0,0 @@
1
- ## Sending messages
2
-
3
- Your final response is delivered via the `## Sending messages` rules in your runtime system prompt (single-destination: just write; multi-destination: use `<message to="name">...</message>` blocks). See that section for the current destination list.
4
-
5
- ### Mid-turn updates (`send_message`)
6
-
7
- Use the `mcp__parachute_agent__send_message` tool to send a message while you're still working (before your final output). If you have one destination, `to` is optional; with multiple, specify it. Pace your updates to the length of the work:
8
-
9
- - **Short turn (≤2 quick tool calls):** Don't narrate. Output any response.
10
- - **Longer turn (multiple tool calls, web searches, installs, sub-agents):** Send a short acknowledgment right away ("On it, checking the logs now") so the user knows you got the message.
11
- - **Long-running turns (long-running tasks with many stages):** Send periodic updates at natural milestones, and especially **before** slow operations like spinning up an explore sub-agent, downloading large files, or installing packages.
12
-
13
- **Never narrate micro-steps.** "I'm going to read the file now… okay, I'm reading it… now I'm parsing it…" is noise. Updates should mark meaningful transitions, not every tool call.
14
-
15
- **Outcomes, not play-by-play.** When the turn is done, the final message should be about the result, not a transcript of what you did.
16
-
17
- ### Sending files (`send_file`)
18
-
19
- Use `mcp__parachute_agent__send_file({ path, text?, filename?, to? })` to deliver a file from your workspace. `path` is absolute or relative to `/workspace/agent/`; `filename` overrides the display name shown in chat (defaults to the file's basename); `text` is an optional accompanying message. Use this for artifacts you produce (charts, PDFs, generated images, reports) rather than dumping contents into chat.
20
-
21
- ### Reacting to messages (`add_reaction`)
22
-
23
- Use `mcp__parachute_agent__add_reaction({ messageId, emoji })` to react to a specific inbound message by its `#N` id — pass `messageId` as an integer (e.g. `22`, not `"22"`). Good for lightweight acknowledgment (`eyes` = seen, `white_check_mark` = done) when a full reply would be noise. `emoji` is the shortcode name (e.g. `thumbs_up`, `heart`), not the raw character.
24
-
25
- ### Internal thoughts
26
-
27
- Wrap reasoning in `<internal>...</internal>` tags to mark it as scratchpad — logged but not sent.
@@ -1,262 +0,0 @@
1
- /**
2
- * Core MCP tools: send_message, send_file, edit_message, add_reaction.
3
- *
4
- * All outbound tools resolve destinations via the local destination map
5
- * (see destinations.ts). Agents reference destinations by name; the map
6
- * translates name → routing tuple. Permission enforcement happens on
7
- * the host side in delivery.ts via the agent_destinations table.
8
- */
9
- import fs from 'fs';
10
- import path from 'path';
11
-
12
- import { findByName, getAllDestinations } from '../destinations.js';
13
- import { getMessageIdBySeq, getRoutingBySeq, writeMessageOut } from '../db/messages-out.js';
14
- import { getSessionRouting } from '../db/session-routing.js';
15
- import { registerTools } from './server.js';
16
- import type { McpToolDefinition } from './types.js';
17
-
18
- function log(msg: string): void {
19
- console.error(`[mcp-tools] ${msg}`);
20
- }
21
-
22
- function generateId(): string {
23
- return `msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
24
- }
25
-
26
- function ok(text: string) {
27
- return { content: [{ type: 'text' as const, text }] };
28
- }
29
-
30
- function err(text: string) {
31
- return { content: [{ type: 'text' as const, text: `Error: ${text}` }], isError: true };
32
- }
33
-
34
- function destinationList(): string {
35
- const all = getAllDestinations();
36
- if (all.length === 0) return '(none)';
37
- return all.map((d) => d.name).join(', ');
38
- }
39
-
40
- /**
41
- * Resolve a destination name to routing fields.
42
- *
43
- * If `to` is omitted, use the session's default reply routing (channel +
44
- * thread the conversation is in) — the agent replies in place.
45
- *
46
- * If `to` is specified, look up the named destination. If it resolves to
47
- * the same channel the session is bound to, the session's thread_id is
48
- * preserved so replies land in the correct thread. Otherwise thread_id
49
- * is null (a cross-destination send starts a new conversation).
50
- */
51
- function resolveRouting(
52
- to: string | undefined,
53
- ):
54
- | { channel_type: string; platform_id: string; thread_id: string | null; resolvedName: string }
55
- | { error: string } {
56
- if (!to) {
57
- // Default: reply to whatever thread/channel this session is bound to.
58
- const session = getSessionRouting();
59
- if (session.channel_type && session.platform_id) {
60
- return {
61
- channel_type: session.channel_type,
62
- platform_id: session.platform_id,
63
- thread_id: session.thread_id,
64
- resolvedName: '(current conversation)',
65
- };
66
- }
67
- // No session routing (e.g., agent-shared or internal-only agent) —
68
- // fall back to the legacy single-destination shortcut.
69
- const all = getAllDestinations();
70
- if (all.length === 0) return { error: 'No destinations configured.' };
71
- if (all.length > 1) {
72
- return {
73
- error: `You have multiple destinations — specify "to". Options: ${all.map((d) => d.name).join(', ')}`,
74
- };
75
- }
76
- to = all[0].name;
77
- }
78
- const dest = findByName(to);
79
- if (!dest) return { error: `Unknown destination "${to}". Known: ${destinationList()}` };
80
- if (dest.type === 'channel') {
81
- // If the destination is the same channel the session is bound to,
82
- // preserve the thread_id so replies land in the correct thread.
83
- const session = getSessionRouting();
84
- const threadId =
85
- session.channel_type === dest.channelType && session.platform_id === dest.platformId
86
- ? session.thread_id
87
- : null;
88
- return {
89
- channel_type: dest.channelType!,
90
- platform_id: dest.platformId!,
91
- thread_id: threadId,
92
- resolvedName: to,
93
- };
94
- }
95
- return { channel_type: 'agent', platform_id: dest.agentGroupId!, thread_id: null, resolvedName: to };
96
- }
97
-
98
- export const sendMessage: McpToolDefinition = {
99
- tool: {
100
- name: 'send_message',
101
- description:
102
- 'Send a message to a named destination. If you have only one destination, you can omit `to`.',
103
- inputSchema: {
104
- type: 'object' as const,
105
- properties: {
106
- to: { type: 'string', description: 'Destination name (e.g., "family", "worker-1"). Optional if you have only one destination.' },
107
- text: { type: 'string', description: 'Message content' },
108
- },
109
- required: ['text'],
110
- },
111
- },
112
- async handler(args) {
113
- const text = args.text as string;
114
- if (!text) return err('text is required');
115
-
116
- const routing = resolveRouting(args.to as string | undefined);
117
- if ('error' in routing) return err(routing.error);
118
-
119
- const id = generateId();
120
- const seq = writeMessageOut({
121
- id,
122
- kind: 'chat',
123
- platform_id: routing.platform_id,
124
- channel_type: routing.channel_type,
125
- thread_id: routing.thread_id,
126
- content: JSON.stringify({ text }),
127
- });
128
-
129
- log(`send_message: #${seq} → ${routing.resolvedName}`);
130
- return ok(`Message sent to ${routing.resolvedName} (id: ${seq})`);
131
- },
132
- };
133
-
134
- export const sendFile: McpToolDefinition = {
135
- tool: {
136
- name: 'send_file',
137
- description: 'Send a file to a named destination. If you have only one destination, you can omit `to`.',
138
- inputSchema: {
139
- type: 'object' as const,
140
- properties: {
141
- to: { type: 'string', description: 'Destination name. Optional if you have only one destination.' },
142
- path: { type: 'string', description: 'File path (relative to /workspace/agent/ or absolute)' },
143
- text: { type: 'string', description: 'Optional accompanying message' },
144
- filename: { type: 'string', description: 'Display name (default: basename of path)' },
145
- },
146
- required: ['path'],
147
- },
148
- },
149
- async handler(args) {
150
- const filePath = args.path as string;
151
- if (!filePath) return err('path is required');
152
-
153
- const routing = resolveRouting(args.to as string | undefined);
154
- if ('error' in routing) return err(routing.error);
155
-
156
- const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve('/workspace/agent', filePath);
157
- if (!fs.existsSync(resolvedPath)) return err(`File not found: ${filePath}`);
158
-
159
- const id = generateId();
160
- const filename = (args.filename as string) || path.basename(resolvedPath);
161
-
162
- const outboxDir = path.join('/workspace/outbox', id);
163
- fs.mkdirSync(outboxDir, { recursive: true });
164
- fs.copyFileSync(resolvedPath, path.join(outboxDir, filename));
165
-
166
- writeMessageOut({
167
- id,
168
- kind: 'chat',
169
- platform_id: routing.platform_id,
170
- channel_type: routing.channel_type,
171
- thread_id: routing.thread_id,
172
- content: JSON.stringify({ text: (args.text as string) || '', files: [filename] }),
173
- });
174
-
175
- log(`send_file: ${id} → ${routing.resolvedName} (${filename})`);
176
- return ok(`File sent to ${routing.resolvedName} (id: ${id}, filename: ${filename})`);
177
- },
178
- };
179
-
180
- export const editMessage: McpToolDefinition = {
181
- tool: {
182
- name: 'edit_message',
183
- description: 'Edit a previously sent message. Targets the same destination the original message was sent to.',
184
- inputSchema: {
185
- type: 'object' as const,
186
- properties: {
187
- messageId: { type: 'integer', description: 'Message ID (the numeric id shown in messages)' },
188
- text: { type: 'string', description: 'New message content' },
189
- },
190
- required: ['messageId', 'text'],
191
- },
192
- },
193
- async handler(args) {
194
- const seq = Number(args.messageId);
195
- const text = args.text as string;
196
- if (!seq || !text) return err('messageId and text are required');
197
-
198
- const platformId = getMessageIdBySeq(seq);
199
- if (!platformId) return err(`Message #${seq} not found`);
200
-
201
- const routing = getRoutingBySeq(seq);
202
- if (!routing || !routing.channel_type || !routing.platform_id) {
203
- return err(`Cannot determine destination for message #${seq}`);
204
- }
205
-
206
- const id = generateId();
207
- writeMessageOut({
208
- id,
209
- kind: 'chat',
210
- platform_id: routing.platform_id,
211
- channel_type: routing.channel_type,
212
- thread_id: routing.thread_id,
213
- content: JSON.stringify({ operation: 'edit', messageId: platformId, text }),
214
- });
215
-
216
- log(`edit_message: #${seq} → ${platformId}`);
217
- return ok(`Message edit queued for #${seq}`);
218
- },
219
- };
220
-
221
- export const addReaction: McpToolDefinition = {
222
- tool: {
223
- name: 'add_reaction',
224
- description: 'Add an emoji reaction to a message.',
225
- inputSchema: {
226
- type: 'object' as const,
227
- properties: {
228
- messageId: { type: 'integer', description: 'Message ID (the numeric id shown in messages)' },
229
- emoji: { type: 'string', description: 'Emoji name (e.g., thumbs_up, heart, check)' },
230
- },
231
- required: ['messageId', 'emoji'],
232
- },
233
- },
234
- async handler(args) {
235
- const seq = Number(args.messageId);
236
- const emoji = args.emoji as string;
237
- if (!seq || !emoji) return err('messageId and emoji are required');
238
-
239
- const platformId = getMessageIdBySeq(seq);
240
- if (!platformId) return err(`Message #${seq} not found`);
241
-
242
- const routing = getRoutingBySeq(seq);
243
- if (!routing || !routing.channel_type || !routing.platform_id) {
244
- return err(`Cannot determine destination for message #${seq}`);
245
- }
246
-
247
- const id = generateId();
248
- writeMessageOut({
249
- id,
250
- kind: 'chat',
251
- platform_id: routing.platform_id,
252
- channel_type: routing.channel_type,
253
- thread_id: routing.thread_id,
254
- content: JSON.stringify({ operation: 'reaction', messageId: platformId, emoji }),
255
- });
256
-
257
- log(`add_reaction: #${seq} → ${emoji} on ${platformId}`);
258
- return ok(`Reaction queued for #${seq}`);
259
- },
260
- };
261
-
262
- registerTools([sendMessage, sendFile, editMessage, addReaction]);
@@ -1,22 +0,0 @@
1
- /**
2
- * MCP tools barrel — imports each tool module for its side-effect
3
- * `registerTools([...])` call, then starts the MCP server.
4
- *
5
- * Adding a new tool module: create the file, call `registerTools([...])`
6
- * at module scope, and append the import here. No central list.
7
- */
8
- import './core.js';
9
- import './scheduling.js';
10
- import './interactive.js';
11
- import './agents.js';
12
- import './self-mod.js';
13
- import { startMcpServer } from './server.js';
14
-
15
- function log(msg: string): void {
16
- console.error(`[mcp-tools] ${msg}`);
17
- }
18
-
19
- startMcpServer().catch((err) => {
20
- log(`MCP server error: ${err instanceof Error ? err.message : String(err)}`);
21
- process.exit(1);
22
- });
@@ -1,22 +0,0 @@
1
- ## Interactive prompts
2
-
3
- The two tools here solve different problems: `ask_user_question` forces a decision and waits for it; `send_card` displays structured content and moves on.
4
-
5
- ### Asking a multiple-choice question (`ask_user_question`)
6
-
7
- `mcp__parachute_agent__ask_user_question({ title, question, options, timeout? })` presents the user with a set of choices and **blocks your turn** until they tap one or the timeout expires (default: 300 seconds). Returns their chosen value.
8
-
9
- `options` can be plain strings or `{ label, selectedLabel?, value? }` objects:
10
- - `label` — the button text shown before selection
11
- - `selectedLabel` — the text shown on the button *after* selection (useful for confirmations, e.g. `"✓ Confirmed"`)
12
- - `value` — the string returned to you when that option is chosen (defaults to `label`)
13
-
14
- Use this when you genuinely cannot proceed without a decision. For free-text input, send a normal message and wait for their reply — don't reach for this tool.
15
-
16
- ### Structured cards (`send_card`)
17
-
18
- `mcp__parachute_agent__send_card({ card, fallbackText? })` renders a structured card and **returns immediately** — it does not pause your turn or collect a response.
19
-
20
- `card` supports: `title`, `description`, `children` (nested text or content blocks), and `actions` (buttons). `fallbackText` is sent as a plain message on platforms without card support.
21
-
22
- Use this for presenting information in a cleaner format than prose: summaries, options the user can read (but you're not waiting on), or results with contextual buttons. If you need the user to actually *choose* something and return a value, use `ask_user_question` instead.