@openparachute/agent 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (598) hide show
  1. package/.parachute/module.json +124 -8
  2. package/LICENSE +2 -16
  3. package/README.md +118 -166
  4. package/package.json +32 -43
  5. package/scripts/spawn-agent.ts +371 -0
  6. package/src/_parked/interactive-spawn.test.ts +324 -0
  7. package/src/_parked/interactive-spawn.ts +701 -0
  8. package/src/agent-defs.test.ts +1504 -0
  9. package/src/agent-defs.ts +1702 -0
  10. package/src/agent-mcp-config.test.ts +115 -0
  11. package/src/agent-mcp-config.ts +115 -0
  12. package/src/agents.test.ts +360 -0
  13. package/src/agents.ts +379 -0
  14. package/src/auth.test.ts +46 -0
  15. package/src/auth.ts +140 -0
  16. package/src/backends/attached-queue.test.ts +376 -0
  17. package/src/backends/attached-queue.ts +372 -0
  18. package/src/backends/programmatic.test.ts +1715 -0
  19. package/src/backends/programmatic.ts +927 -0
  20. package/src/backends/registry.test.ts +1494 -0
  21. package/src/backends/registry.ts +1202 -0
  22. package/src/backends/stream-json.test.ts +570 -0
  23. package/src/backends/stream-json.ts +392 -0
  24. package/src/backends/types.ts +223 -0
  25. package/src/bridge.ts +417 -0
  26. package/src/channel-backend-wiring.test.ts +237 -0
  27. package/src/credentials.test.ts +274 -0
  28. package/src/credentials.ts +380 -0
  29. package/src/cron.test.ts +342 -0
  30. package/src/cron.ts +380 -0
  31. package/src/daemon-agent-def-api.test.ts +166 -0
  32. package/src/daemon-agent-defs-api.test.ts +953 -0
  33. package/src/daemon-agent-env-api.test.ts +338 -0
  34. package/src/daemon-attached-queue-store.test.ts +65 -0
  35. package/src/daemon-config-api.test.ts +962 -0
  36. package/src/daemon-jobs-api.test.ts +271 -0
  37. package/src/daemon-vault-chat.test.ts +250 -0
  38. package/src/daemon.test.ts +746 -0
  39. package/src/daemon.ts +3314 -0
  40. package/src/def-vaults.test.ts +136 -0
  41. package/src/def-vaults.ts +165 -0
  42. package/src/delivery-state.test.ts +110 -0
  43. package/src/delivery-state.ts +154 -0
  44. package/src/effective-env.test.ts +114 -0
  45. package/src/effective-env.ts +184 -0
  46. package/src/env-compat.ts +39 -0
  47. package/src/grants.test.ts +638 -0
  48. package/src/grants.ts +675 -0
  49. package/src/hub-jwt.test.ts +161 -0
  50. package/src/hub-jwt.ts +182 -0
  51. package/src/jobs.test.ts +245 -0
  52. package/src/jobs.ts +266 -0
  53. package/src/mcp-http.test.ts +265 -0
  54. package/src/mcp-http.ts +771 -0
  55. package/src/mint-token.test.ts +152 -0
  56. package/src/mint-token.ts +139 -0
  57. package/src/module-manifest.test.ts +158 -0
  58. package/src/oauth-discovery.ts +134 -0
  59. package/src/programmatic-wiring.test.ts +838 -0
  60. package/src/registry.test.ts +227 -0
  61. package/src/registry.ts +228 -0
  62. package/src/resolve-port.test.ts +64 -0
  63. package/src/routing.test.ts +184 -0
  64. package/src/routing.ts +76 -0
  65. package/src/runner.test.ts +506 -0
  66. package/src/runner.ts +255 -0
  67. package/src/sandbox/config.test.ts +150 -0
  68. package/src/sandbox/config.ts +102 -0
  69. package/src/sandbox/egress.test.ts +113 -0
  70. package/src/sandbox/egress.ts +123 -0
  71. package/src/sandbox/index.ts +180 -0
  72. package/src/sandbox/live-seatbelt.test.ts +277 -0
  73. package/src/sandbox/mounts.test.ts +154 -0
  74. package/src/sandbox/mounts.ts +133 -0
  75. package/src/sandbox/sandbox.test.ts +168 -0
  76. package/src/sandbox/types.ts +382 -0
  77. package/src/services-manifest.test.ts +106 -0
  78. package/src/services-manifest.ts +95 -0
  79. package/src/spa-serve.test.ts +116 -0
  80. package/src/spa-serve.ts +116 -0
  81. package/src/spawn-agent-cli.test.ts +172 -0
  82. package/src/spawn-agent.test.ts +1218 -0
  83. package/src/spawn-agent.ts +569 -0
  84. package/src/spawn-deps.test.ts +54 -0
  85. package/src/spawn-deps.ts +166 -0
  86. package/src/telegram/api.ts +153 -0
  87. package/src/terminal-assets.test.ts +50 -0
  88. package/src/terminal-assets.ts +79 -0
  89. package/src/terminal-ui.ts +305 -0
  90. package/src/terminal.test.ts +530 -0
  91. package/src/terminal.ts +458 -0
  92. package/src/transport.ts +270 -0
  93. package/src/transports/http-ui.test.ts +455 -0
  94. package/src/transports/http-ui.ts +201 -0
  95. package/src/transports/telegram.test.ts +174 -0
  96. package/src/transports/telegram.ts +426 -0
  97. package/src/transports/vault.test.ts +2011 -0
  98. package/src/transports/vault.ts +1790 -0
  99. package/src/ui-kit.test.ts +178 -0
  100. package/src/ui-kit.ts +402 -0
  101. package/tsconfig.json +8 -14
  102. package/web/ui/tsconfig.json +2 -1
  103. package/.claude/scheduled_tasks.lock +0 -1
  104. package/.claude/settings.json +0 -5
  105. package/.claude/skills/add-atomic-chat-tool/SKILL.md +0 -243
  106. package/.claude/skills/add-atomic-chat-tool/atomic-chat-mcp-stdio.ts +0 -229
  107. package/.claude/skills/add-codex/SKILL.md +0 -161
  108. package/.claude/skills/add-dashboard/SKILL.md +0 -138
  109. package/.claude/skills/add-dashboard/resources/dashboard-pusher.ts +0 -495
  110. package/.claude/skills/add-emacs/SKILL.md +0 -296
  111. package/.claude/skills/add-gcal-tool/SKILL.md +0 -210
  112. package/.claude/skills/add-gchat/REMOVE.md +0 -6
  113. package/.claude/skills/add-gchat/SKILL.md +0 -92
  114. package/.claude/skills/add-gchat/VERIFY.md +0 -3
  115. package/.claude/skills/add-github/REMOVE.md +0 -6
  116. package/.claude/skills/add-github/SKILL.md +0 -148
  117. package/.claude/skills/add-github/VERIFY.md +0 -3
  118. package/.claude/skills/add-gmail-tool/SKILL.md +0 -229
  119. package/.claude/skills/add-imessage/REMOVE.md +0 -6
  120. package/.claude/skills/add-imessage/SKILL.md +0 -113
  121. package/.claude/skills/add-imessage/VERIFY.md +0 -3
  122. package/.claude/skills/add-karpathy-llm-wiki/SKILL.md +0 -110
  123. package/.claude/skills/add-karpathy-llm-wiki/llm-wiki.md +0 -75
  124. package/.claude/skills/add-linear/REMOVE.md +0 -6
  125. package/.claude/skills/add-linear/SKILL.md +0 -168
  126. package/.claude/skills/add-linear/VERIFY.md +0 -3
  127. package/.claude/skills/add-macos-statusbar/SKILL.md +0 -133
  128. package/.claude/skills/add-macos-statusbar/add/src/statusbar.swift +0 -147
  129. package/.claude/skills/add-matrix/REMOVE.md +0 -6
  130. package/.claude/skills/add-matrix/SKILL.md +0 -148
  131. package/.claude/skills/add-matrix/VERIFY.md +0 -3
  132. package/.claude/skills/add-ollama-provider/SKILL.md +0 -179
  133. package/.claude/skills/add-ollama-tool/SKILL.md +0 -193
  134. package/.claude/skills/add-opencode/SKILL.md +0 -229
  135. package/.claude/skills/add-parallel/SKILL.md +0 -290
  136. package/.claude/skills/add-resend/REMOVE.md +0 -6
  137. package/.claude/skills/add-resend/SKILL.md +0 -93
  138. package/.claude/skills/add-resend/VERIFY.md +0 -3
  139. package/.claude/skills/add-signal/REMOVE.md +0 -13
  140. package/.claude/skills/add-signal/SKILL.md +0 -318
  141. package/.claude/skills/add-signal/VERIFY.md +0 -5
  142. package/.claude/skills/add-slack/REMOVE.md +0 -6
  143. package/.claude/skills/add-slack/SKILL.md +0 -112
  144. package/.claude/skills/add-slack/VERIFY.md +0 -3
  145. package/.claude/skills/add-teams/REMOVE.md +0 -6
  146. package/.claude/skills/add-teams/SKILL.md +0 -207
  147. package/.claude/skills/add-teams/VERIFY.md +0 -3
  148. package/.claude/skills/add-vercel/SKILL.md +0 -147
  149. package/.claude/skills/add-vercel/container-skills/vercel-cli/SKILL.md +0 -103
  150. package/.claude/skills/add-webex/REMOVE.md +0 -6
  151. package/.claude/skills/add-webex/SKILL.md +0 -88
  152. package/.claude/skills/add-webex/VERIFY.md +0 -3
  153. package/.claude/skills/add-wechat/REMOVE.md +0 -49
  154. package/.claude/skills/add-wechat/SKILL.md +0 -170
  155. package/.claude/skills/add-wechat/scripts/wire-dm.ts +0 -172
  156. package/.claude/skills/add-whatsapp/SKILL.md +0 -264
  157. package/.claude/skills/add-whatsapp-cloud/REMOVE.md +0 -6
  158. package/.claude/skills/add-whatsapp-cloud/SKILL.md +0 -95
  159. package/.claude/skills/add-whatsapp-cloud/VERIFY.md +0 -3
  160. package/.claude/skills/claw/SKILL.md +0 -131
  161. package/.claude/skills/claw/scripts/claw +0 -374
  162. package/.claude/skills/convert-to-apple-container/SKILL.md +0 -212
  163. package/.claude/skills/customize/SKILL.md +0 -110
  164. package/.claude/skills/debug/SKILL.md +0 -349
  165. package/.claude/skills/get-qodo-rules/SKILL.md +0 -122
  166. package/.claude/skills/get-qodo-rules/references/output-format.md +0 -41
  167. package/.claude/skills/get-qodo-rules/references/pagination.md +0 -33
  168. package/.claude/skills/get-qodo-rules/references/repository-scope.md +0 -26
  169. package/.claude/skills/init-first-agent/SKILL.md +0 -120
  170. package/.claude/skills/init-onecli/SKILL.md +0 -270
  171. package/.claude/skills/manage-channels/SKILL.md +0 -87
  172. package/.claude/skills/manage-mounts/SKILL.md +0 -47
  173. package/.claude/skills/migrate-from-openclaw/MIGRATE_CRONS.md +0 -100
  174. package/.claude/skills/migrate-from-openclaw/SKILL.md +0 -447
  175. package/.claude/skills/migrate-from-openclaw/scripts/discover-openclaw.ts +0 -734
  176. package/.claude/skills/migrate-from-openclaw/scripts/extract-channel-credentials.ts +0 -476
  177. package/.claude/skills/migrate-nanoclaw/SKILL.md +0 -484
  178. package/.claude/skills/migrate-nanoclaw/diagnostics.md +0 -51
  179. package/.claude/skills/qodo-pr-resolver/SKILL.md +0 -326
  180. package/.claude/skills/qodo-pr-resolver/resources/providers.md +0 -329
  181. package/.claude/skills/update-nanoclaw/SKILL.md +0 -243
  182. package/.claude/skills/update-nanoclaw/diagnostics.md +0 -48
  183. package/.claude/skills/update-skills/SKILL.md +0 -130
  184. package/.claude/skills/use-native-credential-proxy/SKILL.md +0 -167
  185. package/.claude/skills/x-integration/SKILL.md +0 -417
  186. package/.claude/skills/x-integration/agent.ts +0 -243
  187. package/.claude/skills/x-integration/host.ts +0 -155
  188. package/.claude/skills/x-integration/lib/browser.ts +0 -148
  189. package/.claude/skills/x-integration/lib/config.ts +0 -62
  190. package/.claude/skills/x-integration/scripts/like.ts +0 -56
  191. package/.claude/skills/x-integration/scripts/post.ts +0 -66
  192. package/.claude/skills/x-integration/scripts/quote.ts +0 -80
  193. package/.claude/skills/x-integration/scripts/reply.ts +0 -74
  194. package/.claude/skills/x-integration/scripts/retweet.ts +0 -62
  195. package/.claude/skills/x-integration/scripts/setup.ts +0 -87
  196. package/.github/CODEOWNERS +0 -10
  197. package/.github/PULL_REQUEST_TEMPLATE.md +0 -18
  198. package/.github/workflows/bump-version.yml +0 -35
  199. package/.github/workflows/ci.yml +0 -39
  200. package/.github/workflows/label-pr.yml +0 -40
  201. package/.github/workflows/update-tokens.yml +0 -43
  202. package/.husky/pre-commit +0 -1
  203. package/.mcp.json +0 -3
  204. package/.nvmrc +0 -1
  205. package/.prettierrc +0 -4
  206. package/CHANGELOG.md +0 -221
  207. package/CLAUDE.md +0 -307
  208. package/CODE_OF_CONDUCT.md +0 -128
  209. package/CONTRIBUTING.md +0 -159
  210. package/CONTRIBUTORS.md +0 -26
  211. package/LICENSE-NANOCLAW-MIT +0 -21
  212. package/README_ja.md +0 -194
  213. package/README_zh.md +0 -194
  214. package/assets/nanoclaw-favicon.png +0 -0
  215. package/assets/nanoclaw-icon.png +0 -0
  216. package/assets/nanoclaw-logo-dark.png +0 -0
  217. package/assets/nanoclaw-logo.png +0 -0
  218. package/assets/nanoclaw-profile.jpeg +0 -0
  219. package/assets/nanoclaw-sales.png +0 -0
  220. package/assets/social-preview.jpg +0 -0
  221. package/config-examples/mount-allowlist.json +0 -25
  222. package/container/.dockerignore +0 -2
  223. package/container/CLAUDE.md +0 -21
  224. package/container/Dockerfile +0 -121
  225. package/container/agent-runner/bun.lock +0 -243
  226. package/container/agent-runner/package.json +0 -22
  227. package/container/agent-runner/scripts/sdk-signal-probe.ts +0 -169
  228. package/container/agent-runner/src/config.ts +0 -55
  229. package/container/agent-runner/src/db/connection.ts +0 -267
  230. package/container/agent-runner/src/db/index.ts +0 -20
  231. package/container/agent-runner/src/db/messages-in.ts +0 -138
  232. package/container/agent-runner/src/db/messages-out.ts +0 -143
  233. package/container/agent-runner/src/db/session-routing.ts +0 -30
  234. package/container/agent-runner/src/db/session-state.test.ts +0 -100
  235. package/container/agent-runner/src/db/session-state.ts +0 -79
  236. package/container/agent-runner/src/destinations.ts +0 -135
  237. package/container/agent-runner/src/formatter.test.ts +0 -167
  238. package/container/agent-runner/src/formatter.ts +0 -260
  239. package/container/agent-runner/src/index.ts +0 -110
  240. package/container/agent-runner/src/integration.test.ts +0 -121
  241. package/container/agent-runner/src/mcp-tools/agents.instructions.md +0 -26
  242. package/container/agent-runner/src/mcp-tools/agents.ts +0 -66
  243. package/container/agent-runner/src/mcp-tools/core.instructions.md +0 -27
  244. package/container/agent-runner/src/mcp-tools/core.ts +0 -262
  245. package/container/agent-runner/src/mcp-tools/index.ts +0 -22
  246. package/container/agent-runner/src/mcp-tools/interactive.instructions.md +0 -22
  247. package/container/agent-runner/src/mcp-tools/interactive.ts +0 -169
  248. package/container/agent-runner/src/mcp-tools/scheduling.instructions.md +0 -40
  249. package/container/agent-runner/src/mcp-tools/scheduling.ts +0 -299
  250. package/container/agent-runner/src/mcp-tools/self-mod.instructions.md +0 -25
  251. package/container/agent-runner/src/mcp-tools/self-mod.ts +0 -120
  252. package/container/agent-runner/src/mcp-tools/server.ts +0 -54
  253. package/container/agent-runner/src/mcp-tools/types.ts +0 -6
  254. package/container/agent-runner/src/poll-loop.test.ts +0 -248
  255. package/container/agent-runner/src/poll-loop.ts +0 -437
  256. package/container/agent-runner/src/providers/claude.ts +0 -379
  257. package/container/agent-runner/src/providers/factory.test.ts +0 -19
  258. package/container/agent-runner/src/providers/factory.ts +0 -13
  259. package/container/agent-runner/src/providers/index.ts +0 -6
  260. package/container/agent-runner/src/providers/mock.ts +0 -77
  261. package/container/agent-runner/src/providers/provider-registry.ts +0 -33
  262. package/container/agent-runner/src/providers/types.ts +0 -82
  263. package/container/agent-runner/src/scheduling/task-script.ts +0 -121
  264. package/container/agent-runner/src/timezone.test.ts +0 -93
  265. package/container/agent-runner/src/timezone.ts +0 -107
  266. package/container/agent-runner/tsconfig.json +0 -14
  267. package/container/build.sh +0 -48
  268. package/container/entrypoint.sh +0 -16
  269. package/container/skills/agent-browser/SKILL.md +0 -159
  270. package/container/skills/frontend-engineer/SKILL.md +0 -157
  271. package/container/skills/self-customize/SKILL.md +0 -87
  272. package/container/skills/slack-formatting/SKILL.md +0 -94
  273. package/container/skills/vercel-cli/SKILL.md +0 -111
  274. package/container/skills/welcome/SKILL.md +0 -85
  275. package/docs/APPLE-CONTAINER-NETWORKING.md +0 -90
  276. package/docs/BRANCH-FORK-MAINTENANCE.md +0 -81
  277. package/docs/README.md +0 -25
  278. package/docs/SDK_DEEP_DIVE.md +0 -643
  279. package/docs/SECURITY.md +0 -162
  280. package/docs/agent-runner-details.md +0 -749
  281. package/docs/api-details.md +0 -365
  282. package/docs/architecture-diagram.html +0 -422
  283. package/docs/architecture-diagram.md +0 -215
  284. package/docs/architecture.md +0 -751
  285. package/docs/audit/2026-04-30-channel-endpoint-audit.md +0 -36
  286. package/docs/build-and-runtime.md +0 -80
  287. package/docs/cross-mount-stress/README.md +0 -112
  288. package/docs/cross-mount-stress/container-writer-retry.mjs +0 -55
  289. package/docs/cross-mount-stress/container-writer-slow.mjs +0 -42
  290. package/docs/cross-mount-stress/container-writer.mjs +0 -47
  291. package/docs/cross-mount-stress/host-writer-retry.mjs +0 -55
  292. package/docs/cross-mount-stress/host-writer-slow.mjs +0 -43
  293. package/docs/cross-mount-stress/host-writer.mjs +0 -47
  294. package/docs/db-central.md +0 -316
  295. package/docs/db-session.md +0 -183
  296. package/docs/db.md +0 -119
  297. package/docs/design/2026-04-29-vault-management-ui.md +0 -231
  298. package/docs/design/2026-04-30-channel-wiring-rework.md +0 -234
  299. package/docs/design/2026-05-01-channel-wiring-approvals-deep-dive.md +0 -272
  300. package/docs/design/2026-05-02-channel-policy-and-approval-routing.md +0 -250
  301. package/docs/docker-sandboxes.md +0 -359
  302. package/docs/isolation-model.md +0 -88
  303. package/docs/ollama.md +0 -79
  304. package/docs/parachute-integration.md +0 -109
  305. package/docs/post-night-rebirth-reflections.md +0 -151
  306. package/eslint.config.js +0 -32
  307. package/pnpm-workspace.yaml +0 -8
  308. package/repo-tokens/README.md +0 -113
  309. package/repo-tokens/action.yml +0 -186
  310. package/repo-tokens/badge.svg +0 -23
  311. package/repo-tokens/examples/green.svg +0 -14
  312. package/repo-tokens/examples/red.svg +0 -14
  313. package/repo-tokens/examples/yellow-green.svg +0 -14
  314. package/repo-tokens/examples/yellow.svg +0 -14
  315. package/scripts/chat.ts +0 -101
  316. package/scripts/cleanup-sessions.sh +0 -150
  317. package/scripts/init-cli-agent.ts +0 -171
  318. package/scripts/init-first-agent.ts +0 -377
  319. package/scripts/parachute.ts +0 -158
  320. package/scripts/run-migrations.ts +0 -105
  321. package/scripts/sanity-live-poll.ts +0 -95
  322. package/scripts/seed-discord.ts +0 -79
  323. package/scripts/test-v2-agent.ts +0 -106
  324. package/scripts/test-v2-channel-e2e.ts +0 -265
  325. package/scripts/test-v2-host.ts +0 -184
  326. package/src/channels/adapter.ts +0 -214
  327. package/src/channels/ask-question.ts +0 -46
  328. package/src/channels/channel-registry.test.ts +0 -421
  329. package/src/channels/channel-registry.ts +0 -313
  330. package/src/channels/chat-sdk-bridge.test.ts +0 -84
  331. package/src/channels/chat-sdk-bridge.ts +0 -652
  332. package/src/channels/cli.ts +0 -276
  333. package/src/channels/discord.ts +0 -90
  334. package/src/channels/index.ts +0 -17
  335. package/src/channels/telegram-markdown-sanitize.test.ts +0 -78
  336. package/src/channels/telegram-markdown-sanitize.ts +0 -55
  337. package/src/channels/telegram-pairing.test.ts +0 -254
  338. package/src/channels/telegram-pairing.ts +0 -339
  339. package/src/channels/telegram.ts +0 -279
  340. package/src/channels/trust-hint.test.ts +0 -48
  341. package/src/channels/trust-hint.ts +0 -75
  342. package/src/claude-md-compose.migrate.test.ts +0 -64
  343. package/src/claude-md-compose.ts +0 -205
  344. package/src/command-gate.ts +0 -63
  345. package/src/config.test.ts +0 -93
  346. package/src/config.ts +0 -108
  347. package/src/container-config.ts +0 -167
  348. package/src/container-runner.test.ts +0 -32
  349. package/src/container-runner.ts +0 -576
  350. package/src/container-runtime.test.ts +0 -169
  351. package/src/container-runtime.ts +0 -92
  352. package/src/db/_bun-sqlite-shim.ts +0 -88
  353. package/src/db/agent-activity.test.ts +0 -155
  354. package/src/db/agent-activity.ts +0 -121
  355. package/src/db/agent-groups.ts +0 -77
  356. package/src/db/connection.migrate.test.ts +0 -143
  357. package/src/db/connection.ts +0 -224
  358. package/src/db/db-v2.test.ts +0 -440
  359. package/src/db/dropped-messages.ts +0 -44
  360. package/src/db/index.ts +0 -40
  361. package/src/db/messaging-groups.ts +0 -252
  362. package/src/db/migrations/001-initial.ts +0 -112
  363. package/src/db/migrations/002-chat-sdk-state.ts +0 -36
  364. package/src/db/migrations/008-dropped-messages.ts +0 -27
  365. package/src/db/migrations/009-drop-pending-credentials.ts +0 -13
  366. package/src/db/migrations/010-engage-modes.ts +0 -103
  367. package/src/db/migrations/011-pending-sender-approvals.ts +0 -40
  368. package/src/db/migrations/012-channel-registration.ts +0 -48
  369. package/src/db/migrations/013-approval-render-metadata.ts +0 -27
  370. package/src/db/migrations/014-secrets.ts +0 -44
  371. package/src/db/migrations/015-secrets-drop-host-pattern.ts +0 -18
  372. package/src/db/migrations/016-secret-assignments.ts +0 -30
  373. package/src/db/migrations/017-agent-activity.ts +0 -40
  374. package/src/db/migrations/018-oauth-app-configs.ts +0 -34
  375. package/src/db/migrations/019-oauth-app-connections.ts +0 -48
  376. package/src/db/migrations/020-agent-app-connections.ts +0 -28
  377. package/src/db/migrations/021-pending-oauth-states.ts +0 -35
  378. package/src/db/migrations/022-app-connections-provider.ts +0 -25
  379. package/src/db/migrations/023-agent-group-secret-mode.test.ts +0 -124
  380. package/src/db/migrations/023-agent-group-secret-mode.ts +0 -65
  381. package/src/db/migrations/024-collapse-approvals.test.ts +0 -249
  382. package/src/db/migrations/024-collapse-approvals.ts +0 -182
  383. package/src/db/migrations/025-secret-mode-check.test.ts +0 -155
  384. package/src/db/migrations/025-secret-mode-check.ts +0 -49
  385. package/src/db/migrations/026-user-dms-bot-id.test.ts +0 -116
  386. package/src/db/migrations/026-user-dms-bot-id.ts +0 -54
  387. package/src/db/migrations/027-provider-credentials.ts +0 -41
  388. package/src/db/migrations/_test-helpers.ts +0 -41
  389. package/src/db/migrations/index.ts +0 -127
  390. package/src/db/migrations/module-agent-to-agent-destinations.ts +0 -84
  391. package/src/db/migrations/module-approvals-pending-approvals.ts +0 -42
  392. package/src/db/migrations/module-approvals-title-options.ts +0 -40
  393. package/src/db/schema.ts +0 -258
  394. package/src/db/session-db.test.ts +0 -93
  395. package/src/db/session-db.ts +0 -325
  396. package/src/db/sessions.ts +0 -241
  397. package/src/delivery.test.ts +0 -148
  398. package/src/delivery.ts +0 -445
  399. package/src/env.ts +0 -74
  400. package/src/group-folder.test.ts +0 -35
  401. package/src/group-folder.ts +0 -44
  402. package/src/group-init.ts +0 -92
  403. package/src/host-core.test.ts +0 -456
  404. package/src/host-sweep.test.ts +0 -146
  405. package/src/host-sweep.ts +0 -287
  406. package/src/index.ts +0 -227
  407. package/src/install-slug.ts +0 -33
  408. package/src/log.test.ts +0 -81
  409. package/src/log.ts +0 -117
  410. package/src/mcp/http.ts +0 -72
  411. package/src/mcp/server.ts +0 -92
  412. package/src/mcp/stdio.ts +0 -51
  413. package/src/mcp/tools/activity.ts +0 -88
  414. package/src/mcp/tools/agent-groups.ts +0 -183
  415. package/src/mcp/tools/approvals.ts +0 -122
  416. package/src/mcp/tools/channels.ts +0 -199
  417. package/src/mcp/tools/index.ts +0 -27
  418. package/src/mcp/tools/oauth.ts +0 -48
  419. package/src/mcp/tools/secrets.ts +0 -169
  420. package/src/mcp/tools/sessions.ts +0 -135
  421. package/src/mcp/types.ts +0 -51
  422. package/src/modules/agent-to-agent/agent-route.test.ts +0 -46
  423. package/src/modules/agent-to-agent/agent-route.ts +0 -223
  424. package/src/modules/agent-to-agent/create-agent.ts +0 -127
  425. package/src/modules/agent-to-agent/db/agent-destinations.ts +0 -135
  426. package/src/modules/agent-to-agent/index.ts +0 -22
  427. package/src/modules/agent-to-agent/write-destinations.ts +0 -59
  428. package/src/modules/approvals/agent.md +0 -45
  429. package/src/modules/approvals/index.ts +0 -21
  430. package/src/modules/approvals/picks.test.ts +0 -291
  431. package/src/modules/approvals/primitive.ts +0 -279
  432. package/src/modules/approvals/project.md +0 -27
  433. package/src/modules/approvals/response-handler.ts +0 -87
  434. package/src/modules/index.ts +0 -24
  435. package/src/modules/interactive/agent.md +0 -21
  436. package/src/modules/interactive/index.ts +0 -69
  437. package/src/modules/interactive/project.md +0 -12
  438. package/src/modules/mount-security/index.ts +0 -448
  439. package/src/modules/mount-security/migrate.test.ts +0 -91
  440. package/src/modules/permissions/access.ts +0 -28
  441. package/src/modules/permissions/channel-approval.test.ts +0 -389
  442. package/src/modules/permissions/channel-approval.ts +0 -188
  443. package/src/modules/permissions/db/agent-group-members.ts +0 -44
  444. package/src/modules/permissions/db/pending-channel-approvals.test.ts +0 -86
  445. package/src/modules/permissions/db/pending-channel-approvals.ts +0 -66
  446. package/src/modules/permissions/db/pending-sender-approvals.ts +0 -60
  447. package/src/modules/permissions/db/user-dms.ts +0 -58
  448. package/src/modules/permissions/db/user-roles.ts +0 -85
  449. package/src/modules/permissions/db/users.ts +0 -38
  450. package/src/modules/permissions/index.ts +0 -421
  451. package/src/modules/permissions/permissions.test.ts +0 -358
  452. package/src/modules/permissions/sender-approval.test.ts +0 -470
  453. package/src/modules/permissions/sender-approval.ts +0 -165
  454. package/src/modules/permissions/user-dm.ts +0 -200
  455. package/src/modules/provider-credentials/db.ts +0 -121
  456. package/src/modules/provider-credentials/index.ts +0 -12
  457. package/src/modules/provider-credentials/spawn.test.ts +0 -206
  458. package/src/modules/provider-credentials/spawn.ts +0 -114
  459. package/src/modules/scheduling/actions.ts +0 -113
  460. package/src/modules/scheduling/db.test.ts +0 -282
  461. package/src/modules/scheduling/db.ts +0 -148
  462. package/src/modules/scheduling/index.ts +0 -34
  463. package/src/modules/scheduling/recurrence.test.ts +0 -98
  464. package/src/modules/scheduling/recurrence.ts +0 -54
  465. package/src/modules/self-mod/agent.md +0 -30
  466. package/src/modules/self-mod/apply.ts +0 -85
  467. package/src/modules/self-mod/index.ts +0 -30
  468. package/src/modules/self-mod/project.md +0 -39
  469. package/src/modules/self-mod/request.ts +0 -91
  470. package/src/modules/typing/index.ts +0 -165
  471. package/src/oauth/agent-app-connections.ts +0 -103
  472. package/src/oauth/app-configs.test.ts +0 -64
  473. package/src/oauth/app-configs.ts +0 -114
  474. package/src/oauth/app-connections.test.ts +0 -109
  475. package/src/oauth/app-connections.ts +0 -178
  476. package/src/oauth/crypto.ts +0 -56
  477. package/src/oauth/flow.ts +0 -104
  478. package/src/oauth/providers/google.test.ts +0 -38
  479. package/src/oauth/providers/google.ts +0 -46
  480. package/src/oauth/providers/index.ts +0 -48
  481. package/src/oauth/state-store.test.ts +0 -54
  482. package/src/oauth/state-store.ts +0 -93
  483. package/src/parachute/README.md +0 -27
  484. package/src/parachute/create-agent.test.ts +0 -83
  485. package/src/parachute/create-agent.ts +0 -122
  486. package/src/parachute/group-status.test.ts +0 -165
  487. package/src/parachute/group-status.ts +0 -136
  488. package/src/parachute/types.ts +0 -41
  489. package/src/parachute/vault-mcp.test.ts +0 -251
  490. package/src/parachute/vault-mcp.ts +0 -232
  491. package/src/platform-id.test.ts +0 -104
  492. package/src/platform-id.ts +0 -109
  493. package/src/providers/index.ts +0 -6
  494. package/src/providers/provider-container-registry.ts +0 -58
  495. package/src/response-registry.ts +0 -45
  496. package/src/router.ts +0 -530
  497. package/src/secrets/crypto.test.ts +0 -45
  498. package/src/secrets/crypto.ts +0 -55
  499. package/src/secrets/index.ts +0 -355
  500. package/src/secrets/master-key.ts +0 -70
  501. package/src/secrets/secrets.test.ts +0 -354
  502. package/src/session-manager.migrate.test.ts +0 -59
  503. package/src/session-manager.ts +0 -433
  504. package/src/startup-bootstrap.test.ts +0 -226
  505. package/src/startup-bootstrap.ts +0 -207
  506. package/src/state-sqlite.ts +0 -182
  507. package/src/timezone.test.ts +0 -64
  508. package/src/timezone.ts +0 -37
  509. package/src/types.ts +0 -230
  510. package/src/web/auth.test.ts +0 -335
  511. package/src/web/auth.ts +0 -214
  512. package/src/web/discord-validate.test.ts +0 -77
  513. package/src/web/discord-validate.ts +0 -88
  514. package/src/web/hub-discovery.test.ts +0 -98
  515. package/src/web/hub-discovery.ts +0 -69
  516. package/src/web/routes/activity.ts +0 -106
  517. package/src/web/routes/agent-provider.test.ts +0 -282
  518. package/src/web/routes/agent-provider.ts +0 -309
  519. package/src/web/routes/approvals.ts +0 -185
  520. package/src/web/routes/apps.ts +0 -434
  521. package/src/web/routes/channels-mg-detail.test.ts +0 -324
  522. package/src/web/routes/channels-mga-detail.test.ts +0 -425
  523. package/src/web/routes/channels.ts +0 -489
  524. package/src/web/routes/oauth-providers.ts +0 -42
  525. package/src/web/routes/secrets.test.ts +0 -175
  526. package/src/web/routes/secrets.ts +0 -282
  527. package/src/web/routes/sessions.ts +0 -123
  528. package/src/web/routes/settings.test.ts +0 -106
  529. package/src/web/routes/settings.ts +0 -247
  530. package/src/web/routes/setup-status.ts +0 -205
  531. package/src/web/routes/vaults.test.ts +0 -389
  532. package/src/web/routes/vaults.ts +0 -225
  533. package/src/web/server-version.test.ts +0 -16
  534. package/src/web/server.ts +0 -1003
  535. package/src/web/services-manifest.test.ts +0 -120
  536. package/src/web/services-manifest.ts +0 -61
  537. package/src/web/static-serve.test.ts +0 -255
  538. package/src/web/static-serve.ts +0 -104
  539. package/src/web/telegram-validate.test.ts +0 -116
  540. package/src/web/telegram-validate.ts +0 -107
  541. package/src/web/vault-proxy.test.ts +0 -214
  542. package/src/web/vault-proxy.ts +0 -120
  543. package/src/web/wire-channel.ts +0 -181
  544. package/src/webhook-server.ts +0 -134
  545. package/vitest.config.ts +0 -18
  546. package/web/README.md +0 -63
  547. package/web/ui/index.html +0 -13
  548. package/web/ui/package.json +0 -35
  549. package/web/ui/pnpm-lock.yaml +0 -2164
  550. package/web/ui/scripts/verify-base.mjs +0 -31
  551. package/web/ui/src/App.tsx +0 -88
  552. package/web/ui/src/components/ActivityFeed.tsx +0 -444
  553. package/web/ui/src/components/AgentGroupPicker.tsx +0 -263
  554. package/web/ui/src/components/AgentProviderCards.tsx +0 -220
  555. package/web/ui/src/components/CredentialForm.tsx +0 -214
  556. package/web/ui/src/components/ScopeGrants.tsx +0 -74
  557. package/web/ui/src/components/StatusDot.tsx +0 -43
  558. package/web/ui/src/components/VaultPicker.tsx +0 -127
  559. package/web/ui/src/components/setup/AdapterInstallStep.tsx +0 -178
  560. package/web/ui/src/components/setup/AgentGroupStep.tsx +0 -43
  561. package/web/ui/src/components/setup/ChannelPickStep.tsx +0 -74
  562. package/web/ui/src/components/setup/DoneStep.tsx +0 -49
  563. package/web/ui/src/components/setup/PrereqStep.tsx +0 -129
  564. package/web/ui/src/components/setup/TestConnectionStep.tsx +0 -108
  565. package/web/ui/src/components/setup/TestMessageStep.tsx +0 -104
  566. package/web/ui/src/components/setup/WireChannelStep.tsx +0 -166
  567. package/web/ui/src/components/setup/types.ts +0 -105
  568. package/web/ui/src/lib/api.test.ts +0 -410
  569. package/web/ui/src/lib/api.ts +0 -1210
  570. package/web/ui/src/lib/auth.test.ts +0 -139
  571. package/web/ui/src/lib/auth.ts +0 -348
  572. package/web/ui/src/lib/channel-adapters.ts +0 -136
  573. package/web/ui/src/main.tsx +0 -19
  574. package/web/ui/src/routes/ApprovalsList.tsx +0 -294
  575. package/web/ui/src/routes/Apps.tsx +0 -613
  576. package/web/ui/src/routes/ChannelWireDetail.test.tsx +0 -233
  577. package/web/ui/src/routes/ChannelWireDetail.tsx +0 -403
  578. package/web/ui/src/routes/ChannelsList.tsx +0 -158
  579. package/web/ui/src/routes/GroupDetail.tsx +0 -755
  580. package/web/ui/src/routes/GroupList.tsx +0 -187
  581. package/web/ui/src/routes/MessagingGroupDetail.test.tsx +0 -233
  582. package/web/ui/src/routes/MessagingGroupDetail.tsx +0 -306
  583. package/web/ui/src/routes/NewGroupWizard.tsx +0 -390
  584. package/web/ui/src/routes/OAuthCallback.tsx +0 -56
  585. package/web/ui/src/routes/SecretsList.tsx +0 -921
  586. package/web/ui/src/routes/SessionsList.tsx +0 -220
  587. package/web/ui/src/routes/SettingsAgentProvider.tsx +0 -109
  588. package/web/ui/src/routes/SettingsApprovals.tsx +0 -234
  589. package/web/ui/src/routes/SetupWizard.tsx +0 -219
  590. package/web/ui/src/routes/VaultDetail.test.tsx +0 -361
  591. package/web/ui/src/routes/VaultDetail.tsx +0 -960
  592. package/web/ui/src/routes/VaultsList.tsx +0 -295
  593. package/web/ui/src/routes/WireChannelPage.tsx +0 -413
  594. package/web/ui/src/styles.css +0 -608
  595. package/web/ui/src/test/setup.ts +0 -23
  596. package/web/ui/src/vite-env.d.ts +0 -10
  597. package/web/ui/vite.config.ts +0 -34
  598. package/web/ui/vitest.config.ts +0 -25
@@ -1,139 +0,0 @@
1
- /**
2
- * auth.ts unit tests. Today's surface is the localStorage / sessionStorage
3
- * key migration from the paraclaw-era prefix to `parachute-agent.*`. Existing
4
- * 0.0.x operators have cached discovery + DCR client_id + tokens under the
5
- * old prefix; without migration their first reload after upgrading to
6
- * 0.1.0 silently re-runs OAuth + leaves a stale client row on the hub.
7
- *
8
- * Tracked in parachute-agent#108. The migration is meant to be called once
9
- * at SPA bootstrap (in main.tsx) before anything else touches storage.
10
- */
11
- import { beforeEach, describe, expect, it, vi } from 'vitest';
12
-
13
- import { migrateLegacyAuthKeys } from './auth.ts';
14
-
15
- // jsdom's Storage in this vitest config doesn't reliably expose the full
16
- // Storage prototype methods (the `--localstorage-file` warning at runtime
17
- // hints the underlying impl is a partial). Install a Map-backed fake on
18
- // the global so the migration helper sees a real-feeling Storage surface.
19
- function makeStorageFake(): Storage {
20
- const m = new Map<string, string>();
21
- return {
22
- get length() {
23
- return m.size;
24
- },
25
- key(i: number): string | null {
26
- return Array.from(m.keys())[i] ?? null;
27
- },
28
- getItem(k: string): string | null {
29
- return m.has(k) ? (m.get(k) as string) : null;
30
- },
31
- setItem(k: string, v: string): void {
32
- m.set(k, String(v));
33
- },
34
- removeItem(k: string): void {
35
- m.delete(k);
36
- },
37
- clear(): void {
38
- m.clear();
39
- },
40
- };
41
- }
42
-
43
- beforeEach(() => {
44
- vi.stubGlobal('localStorage', makeStorageFake());
45
- vi.stubGlobal('sessionStorage', makeStorageFake());
46
- });
47
-
48
- describe('migrateLegacyAuthKeys', () => {
49
- it('migrates the static localStorage keys (discovery + setup wizard)', () => {
50
- localStorage.setItem('paraclaw.discovery', '{"hubOrigin":"http://hub"}');
51
- localStorage.setItem('paraclaw.setupWizard.v2', '{"furthestStep":"prereqs"}');
52
-
53
- migrateLegacyAuthKeys();
54
-
55
- expect(localStorage.getItem('parachute-agent.discovery')).toBe('{"hubOrigin":"http://hub"}');
56
- expect(localStorage.getItem('parachute-agent.setupWizard.v2')).toBe('{"furthestStep":"prereqs"}');
57
- expect(localStorage.getItem('paraclaw.discovery')).toBeNull();
58
- expect(localStorage.getItem('paraclaw.setupWizard.v2')).toBeNull();
59
- });
60
-
61
- it('migrates the in-flight OAuth flow key from sessionStorage', () => {
62
- sessionStorage.setItem('paraclaw.flow', '{"verifier":"v","state":"s"}');
63
-
64
- migrateLegacyAuthKeys();
65
-
66
- expect(sessionStorage.getItem('parachute-agent.flow')).toBe('{"verifier":"v","state":"s"}');
67
- expect(sessionStorage.getItem('paraclaw.flow')).toBeNull();
68
- });
69
-
70
- it('migrates per-hub-origin client + tokens keys, preserving the suffix', () => {
71
- localStorage.setItem('paraclaw.client.http://hub-a', '{"client_id":"a"}');
72
- localStorage.setItem('paraclaw.client.http://hub-b', '{"client_id":"b"}');
73
- localStorage.setItem('paraclaw.tokens.http://hub-a', '{"access_token":"t-a"}');
74
- localStorage.setItem('paraclaw.tokens.http://hub-b', '{"access_token":"t-b"}');
75
-
76
- migrateLegacyAuthKeys();
77
-
78
- expect(localStorage.getItem('parachute-agent.client.http://hub-a')).toBe('{"client_id":"a"}');
79
- expect(localStorage.getItem('parachute-agent.client.http://hub-b')).toBe('{"client_id":"b"}');
80
- expect(localStorage.getItem('parachute-agent.tokens.http://hub-a')).toBe('{"access_token":"t-a"}');
81
- expect(localStorage.getItem('parachute-agent.tokens.http://hub-b')).toBe('{"access_token":"t-b"}');
82
- expect(localStorage.getItem('paraclaw.client.http://hub-a')).toBeNull();
83
- expect(localStorage.getItem('paraclaw.tokens.http://hub-b')).toBeNull();
84
- });
85
-
86
- it('is a no-op when no legacy keys exist (fresh install)', () => {
87
- localStorage.setItem('parachute-agent.discovery', '{"hubOrigin":"http://hub"}');
88
-
89
- migrateLegacyAuthKeys();
90
-
91
- expect(localStorage.getItem('parachute-agent.discovery')).toBe('{"hubOrigin":"http://hub"}');
92
- expect(localStorage.length).toBe(1);
93
- });
94
-
95
- it('is idempotent — repeated calls leave already-migrated state untouched', () => {
96
- localStorage.setItem('paraclaw.discovery', '{"hubOrigin":"http://hub"}');
97
- localStorage.setItem('paraclaw.tokens.http://hub', '{"access_token":"t"}');
98
-
99
- migrateLegacyAuthKeys();
100
- migrateLegacyAuthKeys();
101
-
102
- // Spreading a Storage fake enumerates its method properties, not the
103
- // stored data — so a snapshot-equality check would pass regardless of
104
- // behavior. Assert the post-state explicitly: legacy keys gone, new
105
- // keys hold the original values, and storage holds exactly the two
106
- // migrated entries (no orphans, no duplicates).
107
- expect(localStorage.getItem('paraclaw.discovery')).toBeNull();
108
- expect(localStorage.getItem('paraclaw.tokens.http://hub')).toBeNull();
109
- expect(localStorage.getItem('parachute-agent.discovery')).toBe('{"hubOrigin":"http://hub"}');
110
- expect(localStorage.getItem('parachute-agent.tokens.http://hub')).toBe('{"access_token":"t"}');
111
- expect(localStorage.length).toBe(2);
112
- });
113
-
114
- it('drops the stale legacy key when both old and new exist (new wins)', () => {
115
- // This shape only happens if something wrote the legacy key after a
116
- // prior migration ran — extremely unlikely in production, but the
117
- // helper has to be deterministic about which value survives.
118
- localStorage.setItem('paraclaw.discovery', '{"hubOrigin":"http://stale"}');
119
- localStorage.setItem('parachute-agent.discovery', '{"hubOrigin":"http://current"}');
120
-
121
- migrateLegacyAuthKeys();
122
-
123
- expect(localStorage.getItem('parachute-agent.discovery')).toBe('{"hubOrigin":"http://current"}');
124
- expect(localStorage.getItem('paraclaw.discovery')).toBeNull();
125
- });
126
-
127
- it('does not touch unrelated paraclaw-prefixed keys outside the OAuth surface', () => {
128
- // Defensive: if some other module ever uses a `paraclaw.foo` key, the
129
- // OAuth migration shouldn't sweep it. Only the four documented prefixes
130
- // and two static keys move.
131
- localStorage.setItem('paraclaw.unrelated', 'keep-me');
132
- localStorage.setItem('paraclaw.discovery', '{"hubOrigin":"http://hub"}');
133
-
134
- migrateLegacyAuthKeys();
135
-
136
- expect(localStorage.getItem('paraclaw.unrelated')).toBe('keep-me');
137
- expect(localStorage.getItem('parachute-agent.discovery')).toBe('{"hubOrigin":"http://hub"}');
138
- });
139
- });
@@ -1,348 +0,0 @@
1
- /**
2
- * OAuth 2.0 client for the Parachute Agent web UI. The hub is the authorization
3
- * server (parachute-patterns/patterns/hub-as-issuer.md):
4
- *
5
- * 1. GET /api/discovery — returns `{ hubOrigin }` so the bundle
6
- * doesn't bake the origin in.
7
- * 2. POST <hub>/oauth/register — RFC 7591 DCR; we cache the client_id
8
- * in localStorage keyed by hub origin.
9
- * 3. GET <hub>/oauth/authorize — PKCE-S256, redirect-back.
10
- * 4. <app>/oauth/callback — code + state; we exchange for tokens.
11
- * 5. POST <hub>/oauth/token — authorization_code, then refresh_token
12
- * on 401 from /api/* before re-login.
13
- *
14
- * Scopes: `agent:admin agent:write vault:read vault:write`. `agent:admin` is
15
- * required for /api/secrets writes + the setup wizard install-channel
16
- * step; `agent:write` is the bar for /api/approvals decisions and
17
- * /api/sessions/:id/close. The vault scopes anticipate the vault tokens-API
18
- * REST endpoint (paraclaw#4 companion vault issue); today the server still
19
- * shells out, but minting the user JWT with vault:* now means no re-consent
20
- * later.
21
- *
22
- * Existing users with cached tokens that lack a newly-required scope will
23
- * hit 403 with a body like `requires the X scope`. The api.ts wrapper
24
- * detects that shape and triggers re-auth (clearTokens + beginLogin) so
25
- * upgrades don't strand users behind a manual `localStorage.clear()`.
26
- * (paraclaw#33)
27
- */
28
- interface DiscoveryResponse {
29
- hubOrigin: string;
30
- }
31
-
32
- interface ClientRecord {
33
- client_id: string;
34
- }
35
-
36
- interface TokenSet {
37
- access_token: string;
38
- refresh_token: string;
39
- expires_at: number; // epoch seconds
40
- }
41
-
42
- interface FlowState {
43
- verifier: string;
44
- state: string;
45
- redirect_uri: string;
46
- hub_origin: string;
47
- }
48
-
49
- const REQUESTED_SCOPES = "agent:admin agent:write vault:read vault:write";
50
- const DISCOVERY_KEY = "parachute-agent.discovery";
51
- const FLOW_KEY = "parachute-agent.flow";
52
-
53
- function clientKey(hubOrigin: string): string {
54
- return `parachute-agent.client.${hubOrigin}`;
55
- }
56
- function tokensKey(hubOrigin: string): string {
57
- return `parachute-agent.tokens.${hubOrigin}`;
58
- }
59
-
60
- /**
61
- * One-shot migration of the OAuth localStorage / sessionStorage keys from
62
- * the paraclaw-era prefix (`paraclaw.*`) to the post-rename prefix
63
- * (`parachute-agent.*`). Idempotent — safe to call on every bootstrap.
64
- *
65
- * Without this, an existing operator hitting 0.1.0 would lose their
66
- * cached discovery, registered client_id, and tokens, and get bounced to
67
- * the hub for a fresh consent. The DCR client_id is one-shot per origin,
68
- * so re-registering would also leave a stale client row on the hub.
69
- *
70
- * The static keys are migrated by name. The per-hub-origin keys
71
- * (`paraclaw.client.<origin>`, `paraclaw.tokens.<origin>`) are
72
- * pattern-scanned because we don't know the operator's hub origin until
73
- * after we've already read DISCOVERY_KEY — which has its own migration.
74
- *
75
- * Tracked in parachute-agent#108. Keep this through 0.2.0 then drop;
76
- * by then every operator who's going to migrate has hit the SPA at
77
- * least once.
78
- */
79
- export function migrateLegacyAuthKeys(): void {
80
- if (typeof localStorage === "undefined") return;
81
- migrateOneKey(localStorage, "paraclaw.discovery", "parachute-agent.discovery");
82
- migrateOneKey(localStorage, "paraclaw.setupWizard.v2", "parachute-agent.setupWizard.v2");
83
- migratePrefix(localStorage, "paraclaw.client.", "parachute-agent.client.");
84
- migratePrefix(localStorage, "paraclaw.tokens.", "parachute-agent.tokens.");
85
- if (typeof sessionStorage !== "undefined") {
86
- migrateOneKey(sessionStorage, "paraclaw.flow", "parachute-agent.flow");
87
- }
88
- }
89
-
90
- function migrateOneKey(storage: Storage, oldKey: string, newKey: string): void {
91
- const oldVal = storage.getItem(oldKey);
92
- if (oldVal === null) return;
93
- // If both exist (rare — only happens if migration ran, then old was
94
- // re-set somehow), the new one wins as the already-migrated truth.
95
- if (storage.getItem(newKey) === null) {
96
- storage.setItem(newKey, oldVal);
97
- }
98
- storage.removeItem(oldKey);
99
- }
100
-
101
- function migratePrefix(storage: Storage, oldPrefix: string, newPrefix: string): void {
102
- // Snapshot keys before mutating — iterating Object.keys while removing
103
- // is implementation-defined.
104
- const stale: string[] = [];
105
- for (let i = 0; i < storage.length; i++) {
106
- const k = storage.key(i);
107
- if (k && k.startsWith(oldPrefix)) stale.push(k);
108
- }
109
- for (const oldKey of stale) {
110
- const suffix = oldKey.slice(oldPrefix.length);
111
- migrateOneKey(storage, oldKey, `${newPrefix}${suffix}`);
112
- }
113
- }
114
-
115
- function readJson<T>(storage: Storage, key: string): T | null {
116
- const raw = storage.getItem(key);
117
- if (!raw) return null;
118
- try {
119
- return JSON.parse(raw) as T;
120
- } catch {
121
- storage.removeItem(key);
122
- return null;
123
- }
124
- }
125
-
126
- function writeJson(storage: Storage, key: string, value: unknown): void {
127
- storage.setItem(key, JSON.stringify(value));
128
- }
129
-
130
- function getRedirectUri(): string {
131
- // Vite's BASE_URL has a trailing slash (`/` or `/agent/`), so the join
132
- // yields `http://host/oauth/callback` or `http://host/agent/oauth/callback`.
133
- return `${window.location.origin}${import.meta.env.BASE_URL}oauth/callback`;
134
- }
135
-
136
- async function getDiscovery(): Promise<DiscoveryResponse> {
137
- const cached = readJson<DiscoveryResponse>(localStorage, DISCOVERY_KEY);
138
- if (cached) return cached;
139
- // Fetch raw — discovery is unauthenticated, and routing it through the API
140
- // wrapper would create a bootstrap dep cycle (api ↔ auth). Mount-aware:
141
- // BASE_URL prepended so the request hits parachute-agent under /agent/ on
142
- // tailnet rather than the hub origin's root (which 404s on /api/discovery).
143
- const url = `${import.meta.env.BASE_URL.replace(/\/$/, "")}/api/discovery`;
144
- const res = await fetch(url, { headers: { accept: "application/json" } });
145
- if (!res.ok) throw new Error(`${url} failed: ${res.status}`);
146
- const fresh = (await res.json()) as DiscoveryResponse;
147
- writeJson(localStorage, DISCOVERY_KEY, fresh);
148
- return fresh;
149
- }
150
-
151
- async function ensureClient(hubOrigin: string): Promise<string> {
152
- const cached = readJson<ClientRecord>(localStorage, clientKey(hubOrigin));
153
- if (cached?.client_id) return cached.client_id;
154
- const redirectUri = getRedirectUri();
155
- const res = await fetch(`${hubOrigin}/oauth/register`, {
156
- method: "POST",
157
- headers: { "content-type": "application/json", accept: "application/json" },
158
- body: JSON.stringify({
159
- redirect_uris: [redirectUri],
160
- scope: REQUESTED_SCOPES,
161
- client_name: "Parachute Agent web UI",
162
- token_endpoint_auth_method: "none",
163
- }),
164
- });
165
- if (!res.ok) {
166
- throw new Error(`hub /oauth/register failed: ${res.status} ${await res.text()}`);
167
- }
168
- const body = (await res.json()) as { client_id: string };
169
- writeJson(localStorage, clientKey(hubOrigin), { client_id: body.client_id });
170
- return body.client_id;
171
- }
172
-
173
- function randomBytes(n: number): Uint8Array {
174
- const out = new Uint8Array(n);
175
- crypto.getRandomValues(out);
176
- return out;
177
- }
178
-
179
- function base64UrlEncode(bytes: Uint8Array): string {
180
- let s = "";
181
- for (const b of bytes) s += String.fromCharCode(b);
182
- return btoa(s).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
183
- }
184
-
185
- async function sha256(input: string): Promise<Uint8Array> {
186
- const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(input));
187
- return new Uint8Array(digest);
188
- }
189
-
190
- async function makePkcePair(): Promise<{ verifier: string; challenge: string }> {
191
- const verifier = base64UrlEncode(randomBytes(32));
192
- const challenge = base64UrlEncode(await sha256(verifier));
193
- return { verifier, challenge };
194
- }
195
-
196
- /**
197
- * Kick off the OAuth dance. Top-level navigation; never returns.
198
- *
199
- * `extraScopes` lets a caller request narrow per-vault scopes
200
- * (`vault:<name>:admin`) on top of `REQUESTED_SCOPES`. The vault detail
201
- * page (paraclaw#38 Phase 3) uses this when the operator's existing JWT
202
- * doesn't carry admin for the targeted vault — re-running the OAuth flow
203
- * with the narrow scope appended produces a JWT that does, without
204
- * widening every other operator's grant. Duplicates are de-duped so the
205
- * hub's consent screen doesn't show the same scope twice.
206
- */
207
- export async function beginLogin(extraScopes: string[] = []): Promise<never> {
208
- const { hubOrigin } = await getDiscovery();
209
- const clientId = await ensureClient(hubOrigin);
210
- const { verifier, challenge } = await makePkcePair();
211
- const state = base64UrlEncode(randomBytes(16));
212
- const redirectUri = getRedirectUri();
213
- const flow: FlowState = {
214
- verifier,
215
- state,
216
- redirect_uri: redirectUri,
217
- hub_origin: hubOrigin,
218
- };
219
- writeJson(sessionStorage, FLOW_KEY, flow);
220
- const scopes = new Set(REQUESTED_SCOPES.split(/\s+/).filter(Boolean));
221
- for (const s of extraScopes) {
222
- const trimmed = s.trim();
223
- if (trimmed) scopes.add(trimmed);
224
- }
225
- const u = new URL(`${hubOrigin}/oauth/authorize`);
226
- u.searchParams.set("client_id", clientId);
227
- u.searchParams.set("redirect_uri", redirectUri);
228
- u.searchParams.set("response_type", "code");
229
- u.searchParams.set("scope", Array.from(scopes).join(" "));
230
- u.searchParams.set("code_challenge", challenge);
231
- u.searchParams.set("code_challenge_method", "S256");
232
- u.searchParams.set("state", state);
233
- window.location.replace(u.toString());
234
- // Block until navigation actually happens — callers expect this never
235
- // returns control.
236
- return new Promise<never>(() => {});
237
- }
238
-
239
- /**
240
- * Exchange `code` for tokens. Throws on any failure (state mismatch, hub
241
- * error, missing flow). Callers should catch + show the error and offer a
242
- * retry that calls beginLogin().
243
- */
244
- export async function handleCallback(params: URLSearchParams): Promise<void> {
245
- const flow = readJson<FlowState>(sessionStorage, FLOW_KEY);
246
- if (!flow) throw new Error("no in-flight OAuth flow — restart sign-in");
247
- sessionStorage.removeItem(FLOW_KEY);
248
- const err = params.get("error");
249
- if (err) {
250
- throw new Error(`hub returned OAuth error: ${err} — ${params.get("error_description") ?? ""}`);
251
- }
252
- const code = params.get("code");
253
- const state = params.get("state");
254
- if (!code || !state) throw new Error("hub callback missing code or state");
255
- if (state !== flow.state) throw new Error("OAuth state mismatch — possible CSRF");
256
- const clientId = readJson<ClientRecord>(localStorage, clientKey(flow.hub_origin))?.client_id;
257
- if (!clientId) throw new Error("client registration missing — restart sign-in");
258
- const tokens = await postToken(flow.hub_origin, {
259
- grant_type: "authorization_code",
260
- code,
261
- client_id: clientId,
262
- redirect_uri: flow.redirect_uri,
263
- code_verifier: flow.verifier,
264
- });
265
- storeTokens(flow.hub_origin, tokens);
266
- }
267
-
268
- async function postToken(
269
- hubOrigin: string,
270
- form: Record<string, string>,
271
- ): Promise<{ access_token: string; refresh_token: string; expires_in: number }> {
272
- const body = new URLSearchParams();
273
- for (const [k, v] of Object.entries(form)) body.set(k, v);
274
- const res = await fetch(`${hubOrigin}/oauth/token`, {
275
- method: "POST",
276
- headers: {
277
- "content-type": "application/x-www-form-urlencoded",
278
- accept: "application/json",
279
- },
280
- body: body.toString(),
281
- });
282
- if (!res.ok) {
283
- const txt = await res.text();
284
- throw new Error(`hub /oauth/token failed: ${res.status} ${txt}`);
285
- }
286
- return (await res.json()) as { access_token: string; refresh_token: string; expires_in: number };
287
- }
288
-
289
- function storeTokens(
290
- hubOrigin: string,
291
- t: { access_token: string; refresh_token: string; expires_in: number },
292
- ): void {
293
- const expires_at = Math.floor(Date.now() / 1000) + t.expires_in;
294
- const ts: TokenSet = {
295
- access_token: t.access_token,
296
- refresh_token: t.refresh_token,
297
- expires_at,
298
- };
299
- writeJson(localStorage, tokensKey(hubOrigin), ts);
300
- }
301
-
302
- function readTokens(hubOrigin: string): TokenSet | null {
303
- return readJson<TokenSet>(localStorage, tokensKey(hubOrigin));
304
- }
305
-
306
- /**
307
- * Returns the current access token if we have one for the cached hub
308
- * origin, regardless of expiry — the API wrapper handles 401-refresh. If
309
- * we don't even have discovery yet, returns null (caller should prompt
310
- * login).
311
- */
312
- export function getAccessToken(): string | null {
313
- const disc = readJson<DiscoveryResponse>(localStorage, DISCOVERY_KEY);
314
- if (!disc) return null;
315
- return readTokens(disc.hubOrigin)?.access_token ?? null;
316
- }
317
-
318
- /**
319
- * Refresh the access token using the stored refresh token. Returns the
320
- * new access token, or null if refresh isn't possible (no refresh, hub
321
- * rejected). Caller should fall back to beginLogin() on null.
322
- */
323
- export async function refreshAccessToken(): Promise<string | null> {
324
- const disc = readJson<DiscoveryResponse>(localStorage, DISCOVERY_KEY);
325
- if (!disc) return null;
326
- const tokens = readTokens(disc.hubOrigin);
327
- if (!tokens?.refresh_token) return null;
328
- const clientId = readJson<ClientRecord>(localStorage, clientKey(disc.hubOrigin))?.client_id;
329
- if (!clientId) return null;
330
- try {
331
- const fresh = await postToken(disc.hubOrigin, {
332
- grant_type: "refresh_token",
333
- refresh_token: tokens.refresh_token,
334
- client_id: clientId,
335
- });
336
- storeTokens(disc.hubOrigin, fresh);
337
- return fresh.access_token;
338
- } catch {
339
- return null;
340
- }
341
- }
342
-
343
- /** Drop tokens; keeps discovery + client_id (DCR is one-shot per origin). */
344
- export function clearTokens(): void {
345
- const disc = readJson<DiscoveryResponse>(localStorage, DISCOVERY_KEY);
346
- if (!disc) return;
347
- localStorage.removeItem(tokensKey(disc.hubOrigin));
348
- }
@@ -1,136 +0,0 @@
1
- /**
2
- * Channel adapter descriptors.
3
- *
4
- * The /channels/new page and the setup wizard both need the same handful of
5
- * facts about each supported adapter: how to validate a bot token, what the
6
- * platform_id looks like, what to ask the operator for, and where to send
7
- * them for token-procurement docs. This table is the single source of those
8
- * facts so a new adapter (slack, whatsapp, …) lands as a one-file addition,
9
- * not a sprawl of switch statements across components.
10
- *
11
- * Two arrays:
12
- * SUPPORTED_ADAPTERS — currently installable on the trunk install
13
- * COMING_SOON_ADAPTERS — visible in the picker as "coming soon" affordances
14
- * per design 2026-04-30 §"adapter parity"
15
- *
16
- * If you add a row here you also need to extend the wire-channel + validator
17
- * routes server-side; the descriptor is the *UI* contract, not the schema.
18
- */
19
- import {
20
- testDiscordToken,
21
- testTelegramToken,
22
- type DiscordIdentity,
23
- type TelegramIdentity,
24
- } from './api.ts';
25
-
26
- export type ChannelAdapter = 'discord' | 'telegram';
27
-
28
- export interface ResolvedIdentity {
29
- /** Bot's user id at the upstream platform, normalized to string. */
30
- id: string;
31
- /** Bot's @-handle / username for "DM @<bot>" copy. */
32
- username: string;
33
- }
34
-
35
- /**
36
- * What the operator needs to provide on the new-channel page in addition to
37
- * the bot token. Today only Telegram has a non-empty list (the operator's
38
- * own user id is needed because Telegram DMs are chat-routed).
39
- */
40
- export interface OperatorInputField {
41
- key: 'operatorUserId';
42
- label: string;
43
- hint: string;
44
- /** Where to send the operator to find this value, if anywhere. */
45
- helpHref?: string;
46
- /** Pattern for client-side validation (kept loose; server is the gate). */
47
- pattern: RegExp;
48
- }
49
-
50
- export interface ChannelAdapterDescriptor {
51
- key: ChannelAdapter;
52
- label: string;
53
- blurb: string;
54
- /** Path on the upstream platform's API the validator hits — for display copy. */
55
- upstreamProbePath: string;
56
- /** Where the operator gets the bot token. */
57
- tokenHelp: { title: string; href: string };
58
- /** Validate a token; throws on rejection. The body in the throw carries the user-facing error. */
59
- validate: (token: string) => Promise<ResolvedIdentity>;
60
- /** Adapter-specific extra fields the wiring step needs from the operator. */
61
- operatorFields: OperatorInputField[];
62
- /**
63
- * Build the messaging-group `platform_id` shown as a preview before wiring.
64
- * `botUserId` is the validate() id; `operatorUserId` is from operatorFields.
65
- */
66
- platformIdPreview: (args: { botUserId: string | null; operatorUserId: string | null }) => string;
67
- /**
68
- * The id that gets POST-ed to /groups/:folder/wire-channel as `botUserId`.
69
- * Discord uses the bot's snowflake (DMs are addressee-routed). Telegram
70
- * uses the OPERATOR's user id (DMs are chat-routed). Both ride the same
71
- * wire field name — the server's wire-channel.ts knows which one is which
72
- * based on `channelType`.
73
- */
74
- wireIdFor: (args: { botUserId: string | null; operatorUserId: string | null }) => string | null;
75
- }
76
-
77
- export interface ComingSoonAdapter {
78
- key: string;
79
- label: string;
80
- blurb: string;
81
- }
82
-
83
- export const SUPPORTED_ADAPTERS: ChannelAdapterDescriptor[] = [
84
- {
85
- key: 'telegram',
86
- label: 'Telegram',
87
- blurb: 'Easiest first run — BotFather + @userinfobot, ~1 minute.',
88
- upstreamProbePath: '/getMe',
89
- tokenHelp: { title: '@BotFather → /newbot', href: 'https://t.me/BotFather' },
90
- validate: async (token: string): Promise<ResolvedIdentity> => {
91
- const r: { identity: TelegramIdentity } = await testTelegramToken(token);
92
- return { id: String(r.identity.id), username: r.identity.username };
93
- },
94
- operatorFields: [
95
- {
96
- key: 'operatorUserId',
97
- label: 'Telegram admin user ID',
98
- hint:
99
- 'The user this bot serves — usually you. Telegram routes DMs by chat id (= your user id); ' +
100
- 'this is the user whose DMs reach your agent. New here? DM @userinfobot to get your ID.',
101
- helpHref: 'https://t.me/userinfobot',
102
- pattern: /^[0-9]+$/,
103
- },
104
- ],
105
- platformIdPreview: ({ operatorUserId }) =>
106
- `telegram:${operatorUserId ?? '(no user id)'}`,
107
- wireIdFor: ({ operatorUserId }) => operatorUserId,
108
- },
109
- {
110
- key: 'discord',
111
- label: 'Discord',
112
- blurb: 'DM your bot or @-mention it in a server.',
113
- upstreamProbePath: '/users/@me',
114
- tokenHelp: {
115
- title: 'Discord developer portal → Bot → Token',
116
- href: 'https://discord.com/developers/applications',
117
- },
118
- validate: async (token: string): Promise<ResolvedIdentity> => {
119
- const r: { identity: DiscordIdentity } = await testDiscordToken(token);
120
- return { id: r.identity.id, username: r.identity.username };
121
- },
122
- operatorFields: [],
123
- platformIdPreview: ({ botUserId }) => `discord:@me:${botUserId ?? '(no bot id)'}`,
124
- wireIdFor: ({ botUserId }) => botUserId,
125
- },
126
- ];
127
-
128
- export const COMING_SOON_ADAPTERS: ComingSoonAdapter[] = [
129
- { key: 'slack', label: 'Slack', blurb: 'Workspace bot — coming soon.' },
130
- { key: 'whatsapp', label: 'WhatsApp', blurb: 'Cloud API — coming soon.' },
131
- { key: 'teams', label: 'Microsoft Teams', blurb: 'Coming soon.' },
132
- ];
133
-
134
- export function findAdapter(key: string): ChannelAdapterDescriptor | null {
135
- return SUPPORTED_ADAPTERS.find((a) => a.key === key) ?? null;
136
- }
@@ -1,19 +0,0 @@
1
- import { StrictMode } from "react";
2
- import { createRoot } from "react-dom/client";
3
- import { BrowserRouter } from "react-router-dom";
4
- import { App } from "./App.tsx";
5
- import { migrateLegacyAuthKeys } from "./lib/auth.ts";
6
- import "./styles.css";
7
-
8
- migrateLegacyAuthKeys();
9
-
10
- const root = document.getElementById("root");
11
- if (!root) throw new Error("#root not found");
12
-
13
- createRoot(root).render(
14
- <StrictMode>
15
- <BrowserRouter basename={import.meta.env.BASE_URL.replace(/\/$/, "")}>
16
- <App />
17
- </BrowserRouter>
18
- </StrictMode>,
19
- );