@openparachute/agent 0.1.2 → 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 (605) 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 -263
  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 -172
  318. package/scripts/init-first-agent.ts +0 -378
  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 -80
  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/api-translator.test.ts +0 -306
  328. package/src/channels/api-translator.ts +0 -214
  329. package/src/channels/ask-question.ts +0 -46
  330. package/src/channels/channel-registry.test.ts +0 -421
  331. package/src/channels/channel-registry.ts +0 -313
  332. package/src/channels/chat-sdk-bridge.test.ts +0 -84
  333. package/src/channels/chat-sdk-bridge.ts +0 -652
  334. package/src/channels/cli.ts +0 -276
  335. package/src/channels/discord.ts +0 -90
  336. package/src/channels/index.ts +0 -17
  337. package/src/channels/telegram-markdown-sanitize.test.ts +0 -78
  338. package/src/channels/telegram-markdown-sanitize.ts +0 -55
  339. package/src/channels/telegram-pairing.test.ts +0 -254
  340. package/src/channels/telegram-pairing.ts +0 -339
  341. package/src/channels/telegram.ts +0 -279
  342. package/src/channels/trust-hint.test.ts +0 -48
  343. package/src/channels/trust-hint.ts +0 -75
  344. package/src/claude-md-compose.migrate.test.ts +0 -64
  345. package/src/claude-md-compose.ts +0 -205
  346. package/src/command-gate.ts +0 -63
  347. package/src/config.test.ts +0 -93
  348. package/src/config.ts +0 -128
  349. package/src/container-config.ts +0 -167
  350. package/src/container-runner.test.ts +0 -32
  351. package/src/container-runner.ts +0 -576
  352. package/src/container-runtime.test.ts +0 -269
  353. package/src/container-runtime.ts +0 -167
  354. package/src/db/_bun-sqlite-shim.ts +0 -88
  355. package/src/db/agent-activity.test.ts +0 -155
  356. package/src/db/agent-activity.ts +0 -121
  357. package/src/db/agent-groups.ts +0 -77
  358. package/src/db/connection.migrate.test.ts +0 -176
  359. package/src/db/connection.ts +0 -259
  360. package/src/db/db-v2.test.ts +0 -440
  361. package/src/db/dropped-messages.ts +0 -44
  362. package/src/db/index.ts +0 -40
  363. package/src/db/messaging-groups.ts +0 -252
  364. package/src/db/migrations/001-initial.ts +0 -112
  365. package/src/db/migrations/002-chat-sdk-state.ts +0 -36
  366. package/src/db/migrations/008-dropped-messages.ts +0 -27
  367. package/src/db/migrations/009-drop-pending-credentials.ts +0 -13
  368. package/src/db/migrations/010-engage-modes.ts +0 -103
  369. package/src/db/migrations/011-pending-sender-approvals.ts +0 -40
  370. package/src/db/migrations/012-channel-registration.ts +0 -48
  371. package/src/db/migrations/013-approval-render-metadata.ts +0 -27
  372. package/src/db/migrations/014-secrets.ts +0 -44
  373. package/src/db/migrations/015-secrets-drop-host-pattern.ts +0 -18
  374. package/src/db/migrations/016-secret-assignments.ts +0 -30
  375. package/src/db/migrations/017-agent-activity.ts +0 -40
  376. package/src/db/migrations/018-oauth-app-configs.ts +0 -34
  377. package/src/db/migrations/019-oauth-app-connections.ts +0 -48
  378. package/src/db/migrations/020-agent-app-connections.ts +0 -28
  379. package/src/db/migrations/021-pending-oauth-states.ts +0 -35
  380. package/src/db/migrations/022-app-connections-provider.ts +0 -25
  381. package/src/db/migrations/023-agent-group-secret-mode.test.ts +0 -124
  382. package/src/db/migrations/023-agent-group-secret-mode.ts +0 -65
  383. package/src/db/migrations/024-collapse-approvals.test.ts +0 -249
  384. package/src/db/migrations/024-collapse-approvals.ts +0 -182
  385. package/src/db/migrations/025-secret-mode-check.test.ts +0 -155
  386. package/src/db/migrations/025-secret-mode-check.ts +0 -49
  387. package/src/db/migrations/026-user-dms-bot-id.test.ts +0 -116
  388. package/src/db/migrations/026-user-dms-bot-id.ts +0 -54
  389. package/src/db/migrations/027-provider-credentials.ts +0 -41
  390. package/src/db/migrations/_test-helpers.ts +0 -41
  391. package/src/db/migrations/index.ts +0 -127
  392. package/src/db/migrations/module-agent-to-agent-destinations.ts +0 -84
  393. package/src/db/migrations/module-approvals-pending-approvals.ts +0 -42
  394. package/src/db/migrations/module-approvals-title-options.ts +0 -40
  395. package/src/db/schema.ts +0 -258
  396. package/src/db/session-db.test.ts +0 -93
  397. package/src/db/session-db.ts +0 -325
  398. package/src/db/sessions.ts +0 -241
  399. package/src/delivery.test.ts +0 -148
  400. package/src/delivery.ts +0 -445
  401. package/src/env.ts +0 -74
  402. package/src/group-folder.test.ts +0 -35
  403. package/src/group-folder.ts +0 -44
  404. package/src/group-init.ts +0 -92
  405. package/src/host-core.test.ts +0 -456
  406. package/src/host-sweep.test.ts +0 -146
  407. package/src/host-sweep.ts +0 -287
  408. package/src/index.ts +0 -232
  409. package/src/install-slug.ts +0 -33
  410. package/src/log.test.ts +0 -81
  411. package/src/log.ts +0 -117
  412. package/src/mcp/http.ts +0 -72
  413. package/src/mcp/server.ts +0 -92
  414. package/src/mcp/stdio.ts +0 -51
  415. package/src/mcp/tools/activity.ts +0 -88
  416. package/src/mcp/tools/agent-groups.ts +0 -183
  417. package/src/mcp/tools/approvals.ts +0 -122
  418. package/src/mcp/tools/channels.test.ts +0 -126
  419. package/src/mcp/tools/channels.ts +0 -134
  420. package/src/mcp/tools/index.ts +0 -27
  421. package/src/mcp/tools/oauth.ts +0 -48
  422. package/src/mcp/tools/secrets.ts +0 -169
  423. package/src/mcp/tools/sessions.ts +0 -135
  424. package/src/mcp/types.ts +0 -51
  425. package/src/modules/agent-to-agent/agent-route.test.ts +0 -46
  426. package/src/modules/agent-to-agent/agent-route.ts +0 -223
  427. package/src/modules/agent-to-agent/create-agent.ts +0 -127
  428. package/src/modules/agent-to-agent/db/agent-destinations.ts +0 -135
  429. package/src/modules/agent-to-agent/index.ts +0 -22
  430. package/src/modules/agent-to-agent/write-destinations.ts +0 -59
  431. package/src/modules/approvals/agent.md +0 -45
  432. package/src/modules/approvals/index.ts +0 -21
  433. package/src/modules/approvals/picks.test.ts +0 -291
  434. package/src/modules/approvals/primitive.ts +0 -279
  435. package/src/modules/approvals/project.md +0 -27
  436. package/src/modules/approvals/response-handler.ts +0 -87
  437. package/src/modules/index.ts +0 -24
  438. package/src/modules/interactive/agent.md +0 -21
  439. package/src/modules/interactive/index.ts +0 -69
  440. package/src/modules/interactive/project.md +0 -12
  441. package/src/modules/mount-security/expand-path.test.ts +0 -82
  442. package/src/modules/mount-security/index.ts +0 -459
  443. package/src/modules/mount-security/migrate.test.ts +0 -91
  444. package/src/modules/permissions/access.ts +0 -28
  445. package/src/modules/permissions/channel-approval.test.ts +0 -389
  446. package/src/modules/permissions/channel-approval.ts +0 -188
  447. package/src/modules/permissions/db/agent-group-members.ts +0 -44
  448. package/src/modules/permissions/db/pending-channel-approvals.test.ts +0 -86
  449. package/src/modules/permissions/db/pending-channel-approvals.ts +0 -66
  450. package/src/modules/permissions/db/pending-sender-approvals.ts +0 -60
  451. package/src/modules/permissions/db/user-dms.ts +0 -58
  452. package/src/modules/permissions/db/user-roles.ts +0 -85
  453. package/src/modules/permissions/db/users.ts +0 -38
  454. package/src/modules/permissions/index.ts +0 -421
  455. package/src/modules/permissions/permissions.test.ts +0 -358
  456. package/src/modules/permissions/sender-approval.test.ts +0 -641
  457. package/src/modules/permissions/sender-approval.ts +0 -165
  458. package/src/modules/permissions/user-dm.ts +0 -200
  459. package/src/modules/provider-credentials/db.ts +0 -121
  460. package/src/modules/provider-credentials/index.ts +0 -12
  461. package/src/modules/provider-credentials/spawn.test.ts +0 -206
  462. package/src/modules/provider-credentials/spawn.ts +0 -114
  463. package/src/modules/scheduling/actions.ts +0 -113
  464. package/src/modules/scheduling/db.test.ts +0 -282
  465. package/src/modules/scheduling/db.ts +0 -148
  466. package/src/modules/scheduling/index.ts +0 -34
  467. package/src/modules/scheduling/recurrence.test.ts +0 -98
  468. package/src/modules/scheduling/recurrence.ts +0 -54
  469. package/src/modules/self-mod/agent.md +0 -30
  470. package/src/modules/self-mod/apply.ts +0 -85
  471. package/src/modules/self-mod/index.ts +0 -30
  472. package/src/modules/self-mod/project.md +0 -39
  473. package/src/modules/self-mod/request.ts +0 -91
  474. package/src/modules/typing/index.ts +0 -165
  475. package/src/oauth/agent-app-connections.ts +0 -103
  476. package/src/oauth/app-configs.test.ts +0 -64
  477. package/src/oauth/app-configs.ts +0 -114
  478. package/src/oauth/app-connections.test.ts +0 -109
  479. package/src/oauth/app-connections.ts +0 -178
  480. package/src/oauth/crypto.ts +0 -56
  481. package/src/oauth/flow.ts +0 -104
  482. package/src/oauth/providers/google.test.ts +0 -38
  483. package/src/oauth/providers/google.ts +0 -46
  484. package/src/oauth/providers/index.ts +0 -48
  485. package/src/oauth/state-store.test.ts +0 -54
  486. package/src/oauth/state-store.ts +0 -93
  487. package/src/parachute/README.md +0 -27
  488. package/src/parachute/create-agent.test.ts +0 -83
  489. package/src/parachute/create-agent.ts +0 -122
  490. package/src/parachute/group-status.test.ts +0 -165
  491. package/src/parachute/group-status.ts +0 -136
  492. package/src/parachute/types.ts +0 -41
  493. package/src/parachute/vault-mcp.test.ts +0 -251
  494. package/src/parachute/vault-mcp.ts +0 -232
  495. package/src/platform-id.test.ts +0 -104
  496. package/src/platform-id.ts +0 -109
  497. package/src/providers/index.ts +0 -6
  498. package/src/providers/provider-container-registry.ts +0 -58
  499. package/src/response-registry.ts +0 -45
  500. package/src/router.ts +0 -530
  501. package/src/secrets/crypto.test.ts +0 -45
  502. package/src/secrets/crypto.ts +0 -55
  503. package/src/secrets/index.ts +0 -461
  504. package/src/secrets/master-key.ts +0 -70
  505. package/src/secrets/secrets.test.ts +0 -651
  506. package/src/session-manager.attachments.test.ts +0 -171
  507. package/src/session-manager.dup-skip.test.ts +0 -173
  508. package/src/session-manager.migrate.test.ts +0 -59
  509. package/src/session-manager.ts +0 -451
  510. package/src/startup-bootstrap.test.ts +0 -226
  511. package/src/startup-bootstrap.ts +0 -207
  512. package/src/state-sqlite.ts +0 -182
  513. package/src/timezone.test.ts +0 -64
  514. package/src/timezone.ts +0 -37
  515. package/src/types.ts +0 -233
  516. package/src/web/auth.test.ts +0 -335
  517. package/src/web/auth.ts +0 -214
  518. package/src/web/discord-validate.test.ts +0 -77
  519. package/src/web/discord-validate.ts +0 -88
  520. package/src/web/hub-discovery.test.ts +0 -98
  521. package/src/web/hub-discovery.ts +0 -69
  522. package/src/web/routes/activity.ts +0 -106
  523. package/src/web/routes/agent-provider.test.ts +0 -282
  524. package/src/web/routes/agent-provider.ts +0 -309
  525. package/src/web/routes/approvals.ts +0 -185
  526. package/src/web/routes/apps.ts +0 -434
  527. package/src/web/routes/channels-mg-detail.test.ts +0 -324
  528. package/src/web/routes/channels-mga-detail.test.ts +0 -472
  529. package/src/web/routes/channels.ts +0 -311
  530. package/src/web/routes/oauth-providers.ts +0 -42
  531. package/src/web/routes/secrets.test.ts +0 -220
  532. package/src/web/routes/secrets.ts +0 -317
  533. package/src/web/routes/sessions.ts +0 -123
  534. package/src/web/routes/settings.test.ts +0 -106
  535. package/src/web/routes/settings.ts +0 -247
  536. package/src/web/routes/setup-status.ts +0 -205
  537. package/src/web/routes/vaults.test.ts +0 -389
  538. package/src/web/routes/vaults.ts +0 -225
  539. package/src/web/server-version.test.ts +0 -16
  540. package/src/web/server.ts +0 -1024
  541. package/src/web/services-manifest.test.ts +0 -148
  542. package/src/web/services-manifest.ts +0 -66
  543. package/src/web/static-serve.test.ts +0 -255
  544. package/src/web/static-serve.ts +0 -104
  545. package/src/web/telegram-validate.test.ts +0 -116
  546. package/src/web/telegram-validate.ts +0 -107
  547. package/src/web/vault-proxy.test.ts +0 -214
  548. package/src/web/vault-proxy.ts +0 -120
  549. package/src/web/wire-channel.ts +0 -181
  550. package/src/webhook-server.ts +0 -134
  551. package/vitest.config.ts +0 -18
  552. package/web/README.md +0 -63
  553. package/web/ui/index.html +0 -13
  554. package/web/ui/package.json +0 -35
  555. package/web/ui/pnpm-lock.yaml +0 -2164
  556. package/web/ui/scripts/verify-base.mjs +0 -31
  557. package/web/ui/src/App.tsx +0 -88
  558. package/web/ui/src/components/ActivityFeed.tsx +0 -444
  559. package/web/ui/src/components/AgentGroupPicker.tsx +0 -263
  560. package/web/ui/src/components/AgentProviderCards.tsx +0 -220
  561. package/web/ui/src/components/CredentialForm.tsx +0 -214
  562. package/web/ui/src/components/ScopeGrants.tsx +0 -74
  563. package/web/ui/src/components/StatusDot.tsx +0 -43
  564. package/web/ui/src/components/VaultPicker.tsx +0 -127
  565. package/web/ui/src/components/setup/AdapterInstallStep.tsx +0 -178
  566. package/web/ui/src/components/setup/AgentGroupStep.tsx +0 -43
  567. package/web/ui/src/components/setup/ChannelPickStep.tsx +0 -74
  568. package/web/ui/src/components/setup/DoneStep.tsx +0 -49
  569. package/web/ui/src/components/setup/PrereqStep.tsx +0 -129
  570. package/web/ui/src/components/setup/TestConnectionStep.tsx +0 -108
  571. package/web/ui/src/components/setup/TestMessageStep.tsx +0 -104
  572. package/web/ui/src/components/setup/WireChannelStep.tsx +0 -166
  573. package/web/ui/src/components/setup/types.ts +0 -105
  574. package/web/ui/src/lib/api.test.ts +0 -410
  575. package/web/ui/src/lib/api.ts +0 -1248
  576. package/web/ui/src/lib/auth.test.ts +0 -352
  577. package/web/ui/src/lib/auth.ts +0 -405
  578. package/web/ui/src/lib/channel-adapters.ts +0 -136
  579. package/web/ui/src/main.tsx +0 -19
  580. package/web/ui/src/routes/ApprovalsList.tsx +0 -294
  581. package/web/ui/src/routes/Apps.tsx +0 -613
  582. package/web/ui/src/routes/ChannelWireDetail.test.tsx +0 -233
  583. package/web/ui/src/routes/ChannelWireDetail.tsx +0 -403
  584. package/web/ui/src/routes/ChannelsList.tsx +0 -158
  585. package/web/ui/src/routes/GroupDetail.test.tsx +0 -206
  586. package/web/ui/src/routes/GroupDetail.tsx +0 -880
  587. package/web/ui/src/routes/GroupList.tsx +0 -187
  588. package/web/ui/src/routes/MessagingGroupDetail.test.tsx +0 -233
  589. package/web/ui/src/routes/MessagingGroupDetail.tsx +0 -306
  590. package/web/ui/src/routes/NewGroupWizard.tsx +0 -390
  591. package/web/ui/src/routes/OAuthCallback.tsx +0 -56
  592. package/web/ui/src/routes/SecretsList.tsx +0 -942
  593. package/web/ui/src/routes/SessionsList.tsx +0 -220
  594. package/web/ui/src/routes/SettingsAgentProvider.tsx +0 -109
  595. package/web/ui/src/routes/SettingsApprovals.tsx +0 -234
  596. package/web/ui/src/routes/SetupWizard.tsx +0 -219
  597. package/web/ui/src/routes/VaultDetail.test.tsx +0 -363
  598. package/web/ui/src/routes/VaultDetail.tsx +0 -960
  599. package/web/ui/src/routes/VaultsList.tsx +0 -295
  600. package/web/ui/src/routes/WireChannelPage.tsx +0 -413
  601. package/web/ui/src/styles.css +0 -608
  602. package/web/ui/src/test/setup.ts +0 -23
  603. package/web/ui/src/vite-env.d.ts +0 -10
  604. package/web/ui/vite.config.ts +0 -34
  605. 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.