@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,641 +0,0 @@
1
- /**
2
- * Integration tests for the unknown-sender request_approval flow
3
- * (ACTION-ITEMS item 5).
4
- *
5
- * Covers:
6
- * - request_approval policy fires `requestSenderApproval` on first unknown
7
- * message from a sender
8
- * - In-flight dedup: second message from the same sender while pending is
9
- * silently dropped (no second card, no second row)
10
- * - Approve path: member added, original message replayed via routeInbound,
11
- * container woken
12
- * - Deny path: pending row deleted, no member added
13
- * - Approve replay with attachment: row + file land cleanly at the
14
- * namespaced messages_in.id path (paraclaw#97)
15
- * - Approve replay with MUTATED original_message: on-disk attachment file
16
- * is preserved byte-for-byte; the dup-skip path absorbs the second write
17
- * so a path-normalization or any pre-replay mutation can't clobber state
18
- * that's already committed (paraclaw#97 — #96 invariant under the
19
- * sender-approval entry point)
20
- */
21
- import fs from 'fs';
22
- import path from 'path';
23
- import { beforeEach, afterEach, describe, expect, it, vi } from 'vitest';
24
-
25
- import { openDb } from '../../db/connection.js';
26
- import { initTestDb, closeDb, runMigrations } from '../../db/index.js';
27
- import { createAgentGroup } from '../../db/agent-groups.js';
28
- import { createMessagingGroup, createMessagingGroupAgent } from '../../db/messaging-groups.js';
29
- import { inboundDbPath, sessionDir } from '../../session-manager.js';
30
- import { upsertUser } from './db/users.js';
31
- import { grantRole } from './db/user-roles.js';
32
-
33
- // Mock container runner — prevent actual docker spawn.
34
- vi.mock('../../container-runner.js', () => ({
35
- wakeContainer: vi.fn().mockResolvedValue(undefined),
36
- isContainerRunning: vi.fn().mockReturnValue(false),
37
- getActiveContainerCount: vi.fn().mockReturnValue(0),
38
- killContainer: vi.fn(),
39
- }));
40
-
41
- // Mock delivery adapter — record card deliveries for assertions.
42
- const deliverMock = vi.fn().mockResolvedValue('plat-msg-id');
43
- vi.mock('../../delivery.js', () => ({
44
- getDeliveryAdapter: () => ({
45
- deliver: deliverMock,
46
- }),
47
- }));
48
-
49
- // Mock ensureUserDm to return the approver's existing messaging group
50
- // instead of hitting a real openDM RPC.
51
- vi.mock('./user-dm.js', () => ({
52
- ensureUserDm: vi.fn(async (userId: string) => {
53
- const { getDb } = await import('../../db/connection.js');
54
- const row = getDb()
55
- .prepare(
56
- `SELECT mg.* FROM messaging_groups mg
57
- JOIN user_dms ud ON ud.messaging_group_id = mg.id
58
- WHERE ud.user_id = ?`,
59
- )
60
- .get(userId);
61
- return row;
62
- }),
63
- }));
64
-
65
- vi.mock('../../config.js', async () => {
66
- const actual = await vi.importActual('../../config.js');
67
- return { ...actual, DATA_DIR: '/tmp/paraclaw-test-sender-approval' };
68
- });
69
-
70
- const TEST_DIR = '/tmp/paraclaw-test-sender-approval';
71
-
72
- function now() {
73
- return new Date().toISOString();
74
- }
75
-
76
- beforeEach(async () => {
77
- if (fs.existsSync(TEST_DIR)) fs.rmSync(TEST_DIR, { recursive: true });
78
- fs.mkdirSync(TEST_DIR, { recursive: true });
79
- const db = initTestDb();
80
- runMigrations(db);
81
-
82
- // Side-effect imports: register hooks (permissions module) AFTER the
83
- // mocks are in place so the access gate / response handler pick up the
84
- // mocked delivery + user-dm helpers.
85
- await import('./index.js');
86
-
87
- // Fixtures: agent group, messaging group with request_approval, wiring,
88
- // owner + DM messaging group for approver delivery.
89
- createAgentGroup({ id: 'ag-1', name: 'Agent', folder: 'agent', agent_provider: null, created_at: now() });
90
-
91
- createMessagingGroup({
92
- id: 'mg-chat',
93
- channel_type: 'telegram',
94
- platform_id: 'chat-123',
95
- name: 'Group Chat',
96
- is_group: 1,
97
- unknown_sender_policy: 'request_approval',
98
- created_at: now(),
99
- });
100
- createMessagingGroupAgent({
101
- id: 'mga-1',
102
- messaging_group_id: 'mg-chat',
103
- agent_group_id: 'ag-1',
104
- engage_mode: 'pattern',
105
- engage_pattern: '.',
106
- sender_scope: 'all',
107
- ignored_message_policy: 'drop',
108
- session_mode: 'shared',
109
- priority: 0,
110
- created_at: now(),
111
- });
112
-
113
- // Owner user + their DM messaging group (pickApprover + ensureUserDm target).
114
- upsertUser({ id: 'telegram:owner', kind: 'telegram', display_name: 'Owner', created_at: now() });
115
- grantRole({
116
- user_id: 'telegram:owner',
117
- role: 'owner',
118
- agent_group_id: null,
119
- granted_by: null,
120
- granted_at: now(),
121
- });
122
- createMessagingGroup({
123
- id: 'mg-dm-owner',
124
- channel_type: 'telegram',
125
- platform_id: 'dm-owner',
126
- name: 'Owner DM',
127
- is_group: 0,
128
- unknown_sender_policy: 'public',
129
- created_at: now(),
130
- });
131
- const { getDb } = await import('../../db/connection.js');
132
- getDb()
133
- .prepare(
134
- `INSERT INTO user_dms (user_id, channel_type, messaging_group_id, resolved_at)
135
- VALUES (?, ?, ?, ?)`,
136
- )
137
- .run('telegram:owner', 'telegram', 'mg-dm-owner', now());
138
-
139
- deliverMock.mockClear();
140
- });
141
-
142
- afterEach(() => {
143
- closeDb();
144
- if (fs.existsSync(TEST_DIR)) fs.rmSync(TEST_DIR, { recursive: true });
145
- });
146
-
147
- function stranger(text: string) {
148
- return {
149
- channelType: 'telegram',
150
- platformId: 'chat-123',
151
- threadId: null,
152
- message: {
153
- id: `stranger-${Math.random().toString(36).slice(2, 8)}`,
154
- kind: 'chat' as const,
155
- content: JSON.stringify({
156
- senderId: 'tg:stranger',
157
- senderName: 'Stranger',
158
- text,
159
- }),
160
- timestamp: now(),
161
- },
162
- };
163
- }
164
-
165
- describe('unknown-sender request_approval flow', () => {
166
- it('delivers an approval card on first unknown message', async () => {
167
- const { routeInbound } = await import('../../router.js');
168
- await routeInbound(stranger('hi'));
169
-
170
- // Wait for the fire-and-forget requestSenderApproval to resolve.
171
- await new Promise((r) => setTimeout(r, 10));
172
-
173
- expect(deliverMock).toHaveBeenCalledTimes(1);
174
- const [channel, platformId, thread, kind, content] = deliverMock.mock.calls[0];
175
- expect(channel).toBe('telegram');
176
- expect(platformId).toBe('dm-owner'); // delivered to owner's DM
177
- expect(thread).toBeNull();
178
- expect(kind).toBe('chat-sdk');
179
- const payload = JSON.parse(content as string);
180
- expect(payload.type).toBe('ask_question');
181
- expect(payload.questionId).toMatch(/^nsa-/);
182
-
183
- const { getDb } = await import('../../db/connection.js');
184
- const rows = getDb().prepare('SELECT * FROM pending_sender_approvals').all();
185
- expect(rows).toHaveLength(1);
186
- });
187
-
188
- it('dedups a second message from the same stranger while pending', async () => {
189
- const { routeInbound } = await import('../../router.js');
190
- await routeInbound(stranger('hello'));
191
- await new Promise((r) => setTimeout(r, 10));
192
- await routeInbound(stranger('are you there?'));
193
- await new Promise((r) => setTimeout(r, 10));
194
-
195
- expect(deliverMock).toHaveBeenCalledTimes(1);
196
- const { getDb } = await import('../../db/connection.js');
197
- const count = (getDb().prepare('SELECT COUNT(*) AS c FROM pending_sender_approvals').get() as { c: number }).c;
198
- expect(count).toBe(1);
199
- });
200
-
201
- it('approve → adds member and replays the original message', async () => {
202
- const { routeInbound } = await import('../../router.js');
203
- const { getResponseHandlers } = await import('../../response-registry.js');
204
- const { wakeContainer } = await import('../../container-runner.js');
205
- (wakeContainer as unknown as ReturnType<typeof vi.fn>).mockClear();
206
-
207
- await routeInbound(stranger('please let me in'));
208
- await new Promise((r) => setTimeout(r, 10));
209
-
210
- const { getDb } = await import('../../db/connection.js');
211
- const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
212
- expect(pending).toBeDefined();
213
-
214
- // Fire the approve click through the response-handler chain.
215
- for (const handler of getResponseHandlers()) {
216
- const claimed = await handler({
217
- questionId: pending.id,
218
- value: 'approve',
219
- // Chat SDK's onAction surfaces the raw platform userId (e.g. Telegram
220
- // chat id). The permissions handler namespaces it with channelType to
221
- // match users(id).
222
- userId: 'owner',
223
- channelType: 'telegram',
224
- platformId: 'dm-owner',
225
- threadId: null,
226
- });
227
- if (claimed) break;
228
- }
229
-
230
- // Member row added for the stranger against the wired agent group.
231
- const member = getDb()
232
- .prepare('SELECT 1 AS x FROM agent_group_members WHERE user_id = ? AND agent_group_id = ?')
233
- .get('tg:stranger', 'ag-1');
234
- expect(member).toBeDefined();
235
-
236
- // Pending row cleared.
237
- const stillPending = getDb().prepare('SELECT COUNT(*) AS c FROM pending_sender_approvals').get() as { c: number };
238
- expect(stillPending.c).toBe(0);
239
-
240
- // Message replayed + container woken.
241
- expect(wakeContainer).toHaveBeenCalled();
242
- });
243
-
244
- it('deny → deletes the pending row without adding a member', async () => {
245
- const { routeInbound } = await import('../../router.js');
246
- const { getResponseHandlers } = await import('../../response-registry.js');
247
-
248
- await routeInbound(stranger('hello'));
249
- await new Promise((r) => setTimeout(r, 10));
250
-
251
- const { getDb } = await import('../../db/connection.js');
252
- const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
253
- expect(pending).toBeDefined();
254
-
255
- for (const handler of getResponseHandlers()) {
256
- const claimed = await handler({
257
- questionId: pending.id,
258
- value: 'reject',
259
- userId: 'owner', // raw platform id — handler namespaces with channelType
260
- channelType: 'telegram',
261
- platformId: 'dm-owner',
262
- threadId: null,
263
- });
264
- if (claimed) break;
265
- }
266
-
267
- const count = (getDb().prepare('SELECT COUNT(*) AS c FROM pending_sender_approvals').get() as { c: number }).c;
268
- expect(count).toBe(0);
269
- const member = getDb()
270
- .prepare('SELECT 1 AS x FROM agent_group_members WHERE user_id = ? AND agent_group_id = ?')
271
- .get('tg:stranger', 'ag-1');
272
- expect(member).toBeUndefined();
273
- });
274
-
275
- it('approve_and_allow → admits the sender, flips MG policy to public, and emits an audit log', async () => {
276
- const { routeInbound } = await import('../../router.js');
277
- const { getResponseHandlers } = await import('../../response-registry.js');
278
- const { getMessagingGroup } = await import('../../db/messaging-groups.js');
279
- const { log } = await import('../../log.js');
280
-
281
- const infoSpy = vi.spyOn(log, 'info');
282
-
283
- await routeInbound(stranger('let everyone in'));
284
- await new Promise((r) => setTimeout(r, 10));
285
-
286
- const { getDb } = await import('../../db/connection.js');
287
- const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
288
- expect(pending).toBeDefined();
289
-
290
- for (const handler of getResponseHandlers()) {
291
- const claimed = await handler({
292
- questionId: pending.id,
293
- value: 'approve_and_allow',
294
- userId: 'owner',
295
- channelType: 'telegram',
296
- platformId: 'dm-owner',
297
- threadId: null,
298
- });
299
- if (claimed) break;
300
- }
301
-
302
- // Sender admitted (same as 'approve' branch).
303
- const member = getDb()
304
- .prepare('SELECT 1 AS x FROM agent_group_members WHERE user_id = ? AND agent_group_id = ?')
305
- .get('tg:stranger', 'ag-1');
306
- expect(member).toBeDefined();
307
-
308
- // MG flipped to public so future strangers skip the gate.
309
- const mg = getMessagingGroup('mg-chat');
310
- expect(mg?.unknown_sender_policy).toBe('public');
311
-
312
- // Audit log entry includes operator + MG + before-state for traceability.
313
- const auditCalls = infoSpy.mock.calls.filter(([, data]) => {
314
- return (
315
- typeof data === 'object' &&
316
- data !== null &&
317
- (data as { audit?: string }).audit === 'sender_approval_policy_flip'
318
- );
319
- });
320
- expect(auditCalls).toHaveLength(1);
321
- const [, auditFields] = auditCalls[0] as [string, Record<string, unknown>];
322
- expect(auditFields).toMatchObject({
323
- messagingGroupId: 'mg-chat',
324
- agentGroupId: 'ag-1',
325
- approverId: 'telegram:owner',
326
- fromPolicy: 'request_approval',
327
- toPolicy: 'public',
328
- });
329
-
330
- // Pending row cleared.
331
- const stillPending = (getDb().prepare('SELECT COUNT(*) AS c FROM pending_sender_approvals').get() as { c: number })
332
- .c;
333
- expect(stillPending).toBe(0);
334
-
335
- infoSpy.mockRestore();
336
- });
337
-
338
- it('approve_and_allow → idempotent on already-public MG, audit still fires with fromPolicy=public', async () => {
339
- // Pre-flip the MG to public to simulate a second click after a prior
340
- // always-allow has already happened. The button is shown unconditionally
341
- // (Aaron's call) so this branch can fire even when policy is already
342
- // public.
343
- const { updateMessagingGroup, getMessagingGroup } = await import('../../db/messaging-groups.js');
344
- updateMessagingGroup('mg-chat', { unknown_sender_policy: 'public' });
345
-
346
- // With public policy, the access gate skips the unknown-sender flow —
347
- // so we can't trigger the approval via routeInbound. Seed the pending
348
- // row directly to exercise just the click handler. Upsert the sender
349
- // user first so addMember's FK to users(id) holds.
350
- upsertUser({ id: 'tg:later-stranger', kind: 'telegram', display_name: 'Later', created_at: now() });
351
- const { createPendingSenderApproval } = await import('./db/pending-sender-approvals.js');
352
- const approvalId = 'nsa-test-idempotent';
353
- createPendingSenderApproval({
354
- id: approvalId,
355
- messaging_group_id: 'mg-chat',
356
- agent_group_id: 'ag-1',
357
- sender_identity: 'tg:later-stranger',
358
- sender_name: 'Later',
359
- original_message: JSON.stringify(stranger('hello again')),
360
- approver_user_id: 'telegram:owner',
361
- created_at: now(),
362
- title: 'New sender',
363
- options_json: '[]',
364
- });
365
-
366
- const { log } = await import('../../log.js');
367
- const infoSpy = vi.spyOn(log, 'info');
368
-
369
- const { getResponseHandlers } = await import('../../response-registry.js');
370
- for (const handler of getResponseHandlers()) {
371
- const claimed = await handler({
372
- questionId: approvalId,
373
- value: 'approve_and_allow',
374
- userId: 'owner',
375
- channelType: 'telegram',
376
- platformId: 'dm-owner',
377
- threadId: null,
378
- });
379
- if (claimed) break;
380
- }
381
-
382
- // Policy stays public (no regression).
383
- expect(getMessagingGroup('mg-chat')?.unknown_sender_policy).toBe('public');
384
-
385
- // Audit log fires with fromPolicy='public' so the click is traceable
386
- // even when the DB write was a no-op.
387
- const auditCalls = infoSpy.mock.calls.filter(([, data]) => {
388
- return (
389
- typeof data === 'object' &&
390
- data !== null &&
391
- (data as { audit?: string }).audit === 'sender_approval_policy_flip'
392
- );
393
- });
394
- expect(auditCalls).toHaveLength(1);
395
- const [, auditFields] = auditCalls[0] as [string, Record<string, unknown>];
396
- expect(auditFields).toMatchObject({ fromPolicy: 'public', toPolicy: 'public' });
397
-
398
- infoSpy.mockRestore();
399
- });
400
-
401
- it('rejects clicks from an unauthorized user (prevents self-admit via forwarded card)', async () => {
402
- // Stranger triggers the approval flow; card goes to the owner.
403
- const { routeInbound } = await import('../../router.js');
404
- const { getResponseHandlers } = await import('../../response-registry.js');
405
-
406
- await routeInbound(stranger('can I play'));
407
- await new Promise((r) => setTimeout(r, 10));
408
-
409
- const { getDb } = await import('../../db/connection.js');
410
- const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
411
- expect(pending).toBeDefined();
412
-
413
- // A random user (not the stranger, not the owner, not an admin) tries to
414
- // click the approval — e.g. they got the card forwarded. Should be
415
- // rejected without admitting them.
416
- for (const handler of getResponseHandlers()) {
417
- const claimed = await handler({
418
- questionId: pending.id,
419
- value: 'approve',
420
- userId: 'random-bystander', // not owner, not admin
421
- channelType: 'telegram',
422
- platformId: 'dm-random',
423
- threadId: null,
424
- });
425
- if (claimed) break;
426
- }
427
-
428
- // No member added for the stranger.
429
- const member = getDb()
430
- .prepare('SELECT 1 AS x FROM agent_group_members WHERE user_id = ? AND agent_group_id = ?')
431
- .get('tg:stranger', 'ag-1');
432
- expect(member).toBeUndefined();
433
-
434
- // Pending row is still there — a legitimate approver can still act on it.
435
- const stillPending = (getDb().prepare('SELECT COUNT(*) AS c FROM pending_sender_approvals').get() as { c: number })
436
- .c;
437
- expect(stillPending).toBe(1);
438
- });
439
-
440
- it('accepts a click from a global admin even if they are not the designated approver', async () => {
441
- // Pre-seed a separate admin user so we can click as them.
442
- upsertUser({ id: 'telegram:admin-bob', kind: 'telegram', display_name: 'Bob', created_at: now() });
443
- grantRole({
444
- user_id: 'telegram:admin-bob',
445
- role: 'admin',
446
- agent_group_id: null,
447
- granted_by: 'telegram:owner',
448
- granted_at: now(),
449
- });
450
-
451
- const { routeInbound } = await import('../../router.js');
452
- const { getResponseHandlers } = await import('../../response-registry.js');
453
-
454
- await routeInbound(stranger('knock knock'));
455
- await new Promise((r) => setTimeout(r, 10));
456
-
457
- const { getDb } = await import('../../db/connection.js');
458
- const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
459
- expect(pending).toBeDefined();
460
-
461
- // Admin clicks approve (not the designated approver, which was owner).
462
- for (const handler of getResponseHandlers()) {
463
- const claimed = await handler({
464
- questionId: pending.id,
465
- value: 'approve',
466
- userId: 'admin-bob',
467
- channelType: 'telegram',
468
- platformId: 'dm-bob',
469
- threadId: null,
470
- });
471
- if (claimed) break;
472
- }
473
-
474
- // Stranger admitted thanks to the admin's authority.
475
- const member = getDb()
476
- .prepare('SELECT 1 AS x FROM agent_group_members WHERE user_id = ? AND agent_group_id = ?')
477
- .get('tg:stranger', 'ag-1');
478
- expect(member).toBeDefined();
479
- });
480
-
481
- // ── paraclaw#97: replay-path coverage ──────────────────────────────────
482
- //
483
- // The unit tests above prove the response handler's bookkeeping (member
484
- // added, pending row cleared, wake fired). The two tests below assert the
485
- // full chain through routeInbound → writeSessionMessage on a message
486
- // carrying a real attachment, plus the #96 file-clobber invariant under
487
- // this entry point.
488
-
489
- function strangerWithAttachment(textValue: string, attachmentBytes: Buffer) {
490
- return {
491
- channelType: 'telegram',
492
- platformId: 'chat-123',
493
- threadId: null,
494
- message: {
495
- id: 'tg-msg-with-att',
496
- kind: 'chat' as const,
497
- content: JSON.stringify({
498
- senderId: 'tg:stranger',
499
- senderName: 'Stranger',
500
- text: textValue,
501
- attachments: [
502
- {
503
- name: 'photo.jpg',
504
- type: 'image',
505
- size: attachmentBytes.length,
506
- data: attachmentBytes.toString('base64'),
507
- },
508
- ],
509
- }),
510
- timestamp: now(),
511
- },
512
- };
513
- }
514
-
515
- it('approve replay → attachment lands cleanly at the namespaced messages_in.id path (paraclaw#97)', async () => {
516
- const ORIGINAL_BYTES = Buffer.from('first-pic');
517
- const event = strangerWithAttachment('see photo', ORIGINAL_BYTES);
518
-
519
- const { routeInbound } = await import('../../router.js');
520
- const { getResponseHandlers } = await import('../../response-registry.js');
521
-
522
- // First route: gate denies (request_approval), pending row created. The
523
- // wired agent has ignored_message_policy='drop', so no accumulate write
524
- // happens — the replay will be the first writer of this messages_in.id.
525
- await routeInbound(event);
526
- await new Promise((r) => setTimeout(r, 10));
527
-
528
- const { getDb } = await import('../../db/connection.js');
529
- const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
530
- expect(pending).toBeDefined();
531
-
532
- for (const handler of getResponseHandlers()) {
533
- const claimed = await handler({
534
- questionId: pending.id,
535
- value: 'approve',
536
- userId: 'owner',
537
- channelType: 'telegram',
538
- platformId: 'dm-owner',
539
- threadId: null,
540
- });
541
- if (claimed) break;
542
- }
543
-
544
- // The replay's deliverToAgent created the session — find it for the
545
- // wired agent group and assert the row + file landed at the right spot.
546
- const sess = getDb().prepare('SELECT id FROM sessions WHERE agent_group_id = ?').get('ag-1') as { id: string };
547
- expect(sess).toBeDefined();
548
-
549
- const inboundDb = openDb(inboundDbPath('ag-1', sess.id));
550
- const rows = inboundDb.prepare('SELECT id, content FROM messages_in').all() as Array<{
551
- id: string;
552
- content: string;
553
- }>;
554
- inboundDb.close();
555
-
556
- expect(rows).toHaveLength(1);
557
- // messageIdForAgent namespaces the platform id with agent_group_id so a
558
- // multi-agent fan-out can't collide on messages_in.id (router.ts).
559
- const namespacedId = 'tg-msg-with-att:ag-1';
560
- expect(rows[0].id).toBe(namespacedId);
561
-
562
- // Row content carries localPath after extractAttachmentFiles ran post-
563
- // commit; inline base64 is gone.
564
- const parsed = JSON.parse(rows[0].content);
565
- expect(parsed.attachments[0].localPath).toBe(`inbox/${namespacedId}/photo.jpg`);
566
- expect(parsed.attachments[0].data).toBeUndefined();
567
-
568
- const filePath = path.join(sessionDir('ag-1', sess.id), 'inbox', namespacedId, 'photo.jpg');
569
- expect(fs.existsSync(filePath)).toBe(true);
570
- expect(fs.readFileSync(filePath).equals(ORIGINAL_BYTES)).toBe(true);
571
- });
572
-
573
- it('approve replay with MUTATED original_message: on-disk file preserved (paraclaw#97 — #96 invariant)', async () => {
574
- // Switch the wired agent to accumulate so the gate-denied first attempt
575
- // writes the row + extracts the file BEFORE the approval card is acted
576
- // on. This is the racing-dispatch shape #92 caught: two writers for the
577
- // same messages_in.id, one from accumulate-on-gate-deny, one from the
578
- // approval replay.
579
- const { getDb } = await import('../../db/connection.js');
580
- getDb()
581
- .prepare(`UPDATE messaging_group_agents SET ignored_message_policy = 'accumulate' WHERE id = ?`)
582
- .run('mga-1');
583
-
584
- const ORIGINAL_BYTES = Buffer.from('first-pic');
585
- const MUTATED_BYTES = Buffer.from('CLOBBERED');
586
- const event = strangerWithAttachment('see photo', ORIGINAL_BYTES);
587
-
588
- const { routeInbound } = await import('../../router.js');
589
- const { getResponseHandlers } = await import('../../response-registry.js');
590
-
591
- // First route: gate denies, but accumulate writes the row + extracts the
592
- // file with ORIGINAL_BYTES.
593
- await routeInbound(event);
594
- await new Promise((r) => setTimeout(r, 10));
595
-
596
- const sess = getDb().prepare('SELECT id FROM sessions WHERE agent_group_id = ?').get('ag-1') as { id: string };
597
- expect(sess).toBeDefined();
598
- const namespacedId = 'tg-msg-with-att:ag-1';
599
- const filePath = path.join(sessionDir('ag-1', sess.id), 'inbox', namespacedId, 'photo.jpg');
600
- expect(fs.readFileSync(filePath).equals(ORIGINAL_BYTES)).toBe(true);
601
-
602
- // Mutate the pending row's original_message to carry MUTATED_BYTES. This
603
- // mirrors any pre-replay normalization (path replacement, ContentRecord
604
- // re-encoding, retry with re-fetched payload) that produces a JSON event
605
- // whose attachment bytes don't match what's already on disk.
606
- const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
607
- expect(pending).toBeDefined();
608
- const mutatedEvent = strangerWithAttachment('see photo', MUTATED_BYTES);
609
- getDb()
610
- .prepare('UPDATE pending_sender_approvals SET original_message = ? WHERE id = ?')
611
- .run(JSON.stringify(mutatedEvent), pending.id);
612
-
613
- // Approve. Replay's writeSessionMessage hits ON CONFLICT (id already
614
- // present from the accumulate write), so extractAttachmentFiles never
615
- // runs and the on-disk file stays put.
616
- for (const handler of getResponseHandlers()) {
617
- const claimed = await handler({
618
- questionId: pending.id,
619
- value: 'approve',
620
- userId: 'owner',
621
- channelType: 'telegram',
622
- platformId: 'dm-owner',
623
- threadId: null,
624
- });
625
- if (claimed) break;
626
- }
627
-
628
- // 1. File on disk is byte-for-byte the original — no mutated clobber.
629
- const onDisk = fs.readFileSync(filePath);
630
- expect(onDisk.equals(ORIGINAL_BYTES)).toBe(true);
631
- expect(onDisk.equals(MUTATED_BYTES)).toBe(false);
632
-
633
- // 2. Exactly one row in messages_in (the accumulate write); the replay
634
- // didn't slip a second row in.
635
- const inboundDb = openDb(inboundDbPath('ag-1', sess.id));
636
- const rows = inboundDb.prepare('SELECT id FROM messages_in').all() as Array<{ id: string }>;
637
- inboundDb.close();
638
- expect(rows).toHaveLength(1);
639
- expect(rows[0].id).toBe(namespacedId);
640
- });
641
- });