@openparachute/agent 0.1.2 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (608) hide show
  1. package/.parachute/module.json +124 -8
  2. package/LICENSE +2 -16
  3. package/README.md +118 -166
  4. package/package.json +35 -42
  5. package/scripts/spawn-agent.ts +371 -0
  6. package/src/_parked/interactive-spawn.test.ts +324 -0
  7. package/src/_parked/interactive-spawn.ts +701 -0
  8. package/src/agent-defs.test.ts +1504 -0
  9. package/src/agent-defs.ts +1702 -0
  10. package/src/agent-mcp-config.test.ts +115 -0
  11. package/src/agent-mcp-config.ts +115 -0
  12. package/src/agents.test.ts +360 -0
  13. package/src/agents.ts +379 -0
  14. package/src/auth.test.ts +46 -0
  15. package/src/auth.ts +140 -0
  16. package/src/backends/attached-queue.test.ts +376 -0
  17. package/src/backends/attached-queue.ts +372 -0
  18. package/src/backends/programmatic.test.ts +1715 -0
  19. package/src/backends/programmatic.ts +927 -0
  20. package/src/backends/registry.test.ts +1494 -0
  21. package/src/backends/registry.ts +1202 -0
  22. package/src/backends/stream-json.test.ts +570 -0
  23. package/src/backends/stream-json.ts +392 -0
  24. package/src/backends/types.ts +223 -0
  25. package/src/bridge.ts +417 -0
  26. package/src/channel-backend-wiring.test.ts +237 -0
  27. package/src/credentials.test.ts +274 -0
  28. package/src/credentials.ts +380 -0
  29. package/src/cron.test.ts +342 -0
  30. package/src/cron.ts +380 -0
  31. package/src/daemon-agent-def-api.test.ts +166 -0
  32. package/src/daemon-agent-defs-api.test.ts +953 -0
  33. package/src/daemon-agent-env-api.test.ts +338 -0
  34. package/src/daemon-attached-queue-store.test.ts +65 -0
  35. package/src/daemon-config-api.test.ts +962 -0
  36. package/src/daemon-jobs-api.test.ts +271 -0
  37. package/src/daemon-vault-chat.test.ts +250 -0
  38. package/src/daemon.test.ts +746 -0
  39. package/src/daemon.ts +3314 -0
  40. package/src/def-vaults.test.ts +136 -0
  41. package/src/def-vaults.ts +165 -0
  42. package/src/delivery-state.test.ts +110 -0
  43. package/src/delivery-state.ts +154 -0
  44. package/src/effective-env.test.ts +114 -0
  45. package/src/effective-env.ts +184 -0
  46. package/src/env-compat.ts +39 -0
  47. package/src/grants.test.ts +638 -0
  48. package/src/grants.ts +675 -0
  49. package/src/hub-jwt.test.ts +161 -0
  50. package/src/hub-jwt.ts +182 -0
  51. package/src/jobs.test.ts +245 -0
  52. package/src/jobs.ts +266 -0
  53. package/src/mcp-http.test.ts +265 -0
  54. package/src/mcp-http.ts +771 -0
  55. package/src/mint-token.test.ts +152 -0
  56. package/src/mint-token.ts +139 -0
  57. package/src/module-manifest.test.ts +158 -0
  58. package/src/oauth-discovery.ts +134 -0
  59. package/src/programmatic-wiring.test.ts +838 -0
  60. package/src/registry.test.ts +227 -0
  61. package/src/registry.ts +228 -0
  62. package/src/resolve-port.test.ts +64 -0
  63. package/src/routing.test.ts +184 -0
  64. package/src/routing.ts +76 -0
  65. package/src/runner.test.ts +506 -0
  66. package/src/runner.ts +255 -0
  67. package/src/sandbox/config.test.ts +150 -0
  68. package/src/sandbox/config.ts +102 -0
  69. package/src/sandbox/egress.test.ts +113 -0
  70. package/src/sandbox/egress.ts +123 -0
  71. package/src/sandbox/index.ts +180 -0
  72. package/src/sandbox/live-seatbelt.test.ts +277 -0
  73. package/src/sandbox/mounts.test.ts +154 -0
  74. package/src/sandbox/mounts.ts +133 -0
  75. package/src/sandbox/sandbox.test.ts +168 -0
  76. package/src/sandbox/types.ts +382 -0
  77. package/src/services-manifest.test.ts +106 -0
  78. package/src/services-manifest.ts +95 -0
  79. package/src/spa-serve.test.ts +116 -0
  80. package/src/spa-serve.ts +116 -0
  81. package/src/spawn-agent-cli.test.ts +172 -0
  82. package/src/spawn-agent.test.ts +1218 -0
  83. package/src/spawn-agent.ts +569 -0
  84. package/src/spawn-deps.test.ts +54 -0
  85. package/src/spawn-deps.ts +166 -0
  86. package/src/telegram/api.ts +153 -0
  87. package/src/terminal-assets.test.ts +50 -0
  88. package/src/terminal-assets.ts +79 -0
  89. package/src/terminal-ui.ts +305 -0
  90. package/src/terminal.test.ts +530 -0
  91. package/src/terminal.ts +458 -0
  92. package/src/transport.ts +270 -0
  93. package/src/transports/http-ui.test.ts +455 -0
  94. package/src/transports/http-ui.ts +201 -0
  95. package/src/transports/telegram.test.ts +174 -0
  96. package/src/transports/telegram.ts +426 -0
  97. package/src/transports/vault.test.ts +2011 -0
  98. package/src/transports/vault.ts +1790 -0
  99. package/src/ui-kit.test.ts +178 -0
  100. package/src/ui-kit.ts +402 -0
  101. package/tsconfig.json +8 -14
  102. package/web/ui/dist/assets/index-C-iWdFFV.css +1 -0
  103. package/web/ui/dist/assets/index-VFETBk0a.js +60 -0
  104. package/web/ui/dist/index.html +15 -0
  105. package/web/ui/tsconfig.json +2 -1
  106. package/.claude/scheduled_tasks.lock +0 -1
  107. package/.claude/settings.json +0 -5
  108. package/.claude/skills/add-atomic-chat-tool/SKILL.md +0 -243
  109. package/.claude/skills/add-atomic-chat-tool/atomic-chat-mcp-stdio.ts +0 -229
  110. package/.claude/skills/add-codex/SKILL.md +0 -161
  111. package/.claude/skills/add-dashboard/SKILL.md +0 -138
  112. package/.claude/skills/add-dashboard/resources/dashboard-pusher.ts +0 -495
  113. package/.claude/skills/add-emacs/SKILL.md +0 -296
  114. package/.claude/skills/add-gcal-tool/SKILL.md +0 -210
  115. package/.claude/skills/add-gchat/REMOVE.md +0 -6
  116. package/.claude/skills/add-gchat/SKILL.md +0 -92
  117. package/.claude/skills/add-gchat/VERIFY.md +0 -3
  118. package/.claude/skills/add-github/REMOVE.md +0 -6
  119. package/.claude/skills/add-github/SKILL.md +0 -148
  120. package/.claude/skills/add-github/VERIFY.md +0 -3
  121. package/.claude/skills/add-gmail-tool/SKILL.md +0 -229
  122. package/.claude/skills/add-imessage/REMOVE.md +0 -6
  123. package/.claude/skills/add-imessage/SKILL.md +0 -113
  124. package/.claude/skills/add-imessage/VERIFY.md +0 -3
  125. package/.claude/skills/add-karpathy-llm-wiki/SKILL.md +0 -110
  126. package/.claude/skills/add-karpathy-llm-wiki/llm-wiki.md +0 -75
  127. package/.claude/skills/add-linear/REMOVE.md +0 -6
  128. package/.claude/skills/add-linear/SKILL.md +0 -168
  129. package/.claude/skills/add-linear/VERIFY.md +0 -3
  130. package/.claude/skills/add-macos-statusbar/SKILL.md +0 -133
  131. package/.claude/skills/add-macos-statusbar/add/src/statusbar.swift +0 -147
  132. package/.claude/skills/add-matrix/REMOVE.md +0 -6
  133. package/.claude/skills/add-matrix/SKILL.md +0 -148
  134. package/.claude/skills/add-matrix/VERIFY.md +0 -3
  135. package/.claude/skills/add-ollama-provider/SKILL.md +0 -179
  136. package/.claude/skills/add-ollama-tool/SKILL.md +0 -193
  137. package/.claude/skills/add-opencode/SKILL.md +0 -229
  138. package/.claude/skills/add-parallel/SKILL.md +0 -290
  139. package/.claude/skills/add-resend/REMOVE.md +0 -6
  140. package/.claude/skills/add-resend/SKILL.md +0 -93
  141. package/.claude/skills/add-resend/VERIFY.md +0 -3
  142. package/.claude/skills/add-signal/REMOVE.md +0 -13
  143. package/.claude/skills/add-signal/SKILL.md +0 -318
  144. package/.claude/skills/add-signal/VERIFY.md +0 -5
  145. package/.claude/skills/add-slack/REMOVE.md +0 -6
  146. package/.claude/skills/add-slack/SKILL.md +0 -112
  147. package/.claude/skills/add-slack/VERIFY.md +0 -3
  148. package/.claude/skills/add-teams/REMOVE.md +0 -6
  149. package/.claude/skills/add-teams/SKILL.md +0 -207
  150. package/.claude/skills/add-teams/VERIFY.md +0 -3
  151. package/.claude/skills/add-vercel/SKILL.md +0 -147
  152. package/.claude/skills/add-vercel/container-skills/vercel-cli/SKILL.md +0 -103
  153. package/.claude/skills/add-webex/REMOVE.md +0 -6
  154. package/.claude/skills/add-webex/SKILL.md +0 -88
  155. package/.claude/skills/add-webex/VERIFY.md +0 -3
  156. package/.claude/skills/add-wechat/REMOVE.md +0 -49
  157. package/.claude/skills/add-wechat/SKILL.md +0 -170
  158. package/.claude/skills/add-wechat/scripts/wire-dm.ts +0 -172
  159. package/.claude/skills/add-whatsapp/SKILL.md +0 -264
  160. package/.claude/skills/add-whatsapp-cloud/REMOVE.md +0 -6
  161. package/.claude/skills/add-whatsapp-cloud/SKILL.md +0 -95
  162. package/.claude/skills/add-whatsapp-cloud/VERIFY.md +0 -3
  163. package/.claude/skills/claw/SKILL.md +0 -131
  164. package/.claude/skills/claw/scripts/claw +0 -374
  165. package/.claude/skills/convert-to-apple-container/SKILL.md +0 -212
  166. package/.claude/skills/customize/SKILL.md +0 -110
  167. package/.claude/skills/debug/SKILL.md +0 -349
  168. package/.claude/skills/get-qodo-rules/SKILL.md +0 -122
  169. package/.claude/skills/get-qodo-rules/references/output-format.md +0 -41
  170. package/.claude/skills/get-qodo-rules/references/pagination.md +0 -33
  171. package/.claude/skills/get-qodo-rules/references/repository-scope.md +0 -26
  172. package/.claude/skills/init-first-agent/SKILL.md +0 -120
  173. package/.claude/skills/init-onecli/SKILL.md +0 -270
  174. package/.claude/skills/manage-channels/SKILL.md +0 -87
  175. package/.claude/skills/manage-mounts/SKILL.md +0 -47
  176. package/.claude/skills/migrate-from-openclaw/MIGRATE_CRONS.md +0 -100
  177. package/.claude/skills/migrate-from-openclaw/SKILL.md +0 -447
  178. package/.claude/skills/migrate-from-openclaw/scripts/discover-openclaw.ts +0 -734
  179. package/.claude/skills/migrate-from-openclaw/scripts/extract-channel-credentials.ts +0 -476
  180. package/.claude/skills/migrate-nanoclaw/SKILL.md +0 -484
  181. package/.claude/skills/migrate-nanoclaw/diagnostics.md +0 -51
  182. package/.claude/skills/qodo-pr-resolver/SKILL.md +0 -326
  183. package/.claude/skills/qodo-pr-resolver/resources/providers.md +0 -329
  184. package/.claude/skills/update-nanoclaw/SKILL.md +0 -243
  185. package/.claude/skills/update-nanoclaw/diagnostics.md +0 -48
  186. package/.claude/skills/update-skills/SKILL.md +0 -130
  187. package/.claude/skills/use-native-credential-proxy/SKILL.md +0 -167
  188. package/.claude/skills/x-integration/SKILL.md +0 -417
  189. package/.claude/skills/x-integration/agent.ts +0 -243
  190. package/.claude/skills/x-integration/host.ts +0 -155
  191. package/.claude/skills/x-integration/lib/browser.ts +0 -148
  192. package/.claude/skills/x-integration/lib/config.ts +0 -62
  193. package/.claude/skills/x-integration/scripts/like.ts +0 -56
  194. package/.claude/skills/x-integration/scripts/post.ts +0 -66
  195. package/.claude/skills/x-integration/scripts/quote.ts +0 -80
  196. package/.claude/skills/x-integration/scripts/reply.ts +0 -74
  197. package/.claude/skills/x-integration/scripts/retweet.ts +0 -62
  198. package/.claude/skills/x-integration/scripts/setup.ts +0 -87
  199. package/.github/CODEOWNERS +0 -10
  200. package/.github/PULL_REQUEST_TEMPLATE.md +0 -18
  201. package/.github/workflows/bump-version.yml +0 -35
  202. package/.github/workflows/ci.yml +0 -39
  203. package/.github/workflows/label-pr.yml +0 -40
  204. package/.github/workflows/update-tokens.yml +0 -43
  205. package/.husky/pre-commit +0 -1
  206. package/.mcp.json +0 -3
  207. package/.nvmrc +0 -1
  208. package/.prettierrc +0 -4
  209. package/CHANGELOG.md +0 -263
  210. package/CLAUDE.md +0 -307
  211. package/CODE_OF_CONDUCT.md +0 -128
  212. package/CONTRIBUTING.md +0 -159
  213. package/CONTRIBUTORS.md +0 -26
  214. package/LICENSE-NANOCLAW-MIT +0 -21
  215. package/README_ja.md +0 -194
  216. package/README_zh.md +0 -194
  217. package/assets/nanoclaw-favicon.png +0 -0
  218. package/assets/nanoclaw-icon.png +0 -0
  219. package/assets/nanoclaw-logo-dark.png +0 -0
  220. package/assets/nanoclaw-logo.png +0 -0
  221. package/assets/nanoclaw-profile.jpeg +0 -0
  222. package/assets/nanoclaw-sales.png +0 -0
  223. package/assets/social-preview.jpg +0 -0
  224. package/config-examples/mount-allowlist.json +0 -25
  225. package/container/.dockerignore +0 -2
  226. package/container/CLAUDE.md +0 -21
  227. package/container/Dockerfile +0 -121
  228. package/container/agent-runner/bun.lock +0 -243
  229. package/container/agent-runner/package.json +0 -22
  230. package/container/agent-runner/scripts/sdk-signal-probe.ts +0 -169
  231. package/container/agent-runner/src/config.ts +0 -55
  232. package/container/agent-runner/src/db/connection.ts +0 -267
  233. package/container/agent-runner/src/db/index.ts +0 -20
  234. package/container/agent-runner/src/db/messages-in.ts +0 -138
  235. package/container/agent-runner/src/db/messages-out.ts +0 -143
  236. package/container/agent-runner/src/db/session-routing.ts +0 -30
  237. package/container/agent-runner/src/db/session-state.test.ts +0 -100
  238. package/container/agent-runner/src/db/session-state.ts +0 -79
  239. package/container/agent-runner/src/destinations.ts +0 -135
  240. package/container/agent-runner/src/formatter.test.ts +0 -167
  241. package/container/agent-runner/src/formatter.ts +0 -260
  242. package/container/agent-runner/src/index.ts +0 -110
  243. package/container/agent-runner/src/integration.test.ts +0 -121
  244. package/container/agent-runner/src/mcp-tools/agents.instructions.md +0 -26
  245. package/container/agent-runner/src/mcp-tools/agents.ts +0 -66
  246. package/container/agent-runner/src/mcp-tools/core.instructions.md +0 -27
  247. package/container/agent-runner/src/mcp-tools/core.ts +0 -262
  248. package/container/agent-runner/src/mcp-tools/index.ts +0 -22
  249. package/container/agent-runner/src/mcp-tools/interactive.instructions.md +0 -22
  250. package/container/agent-runner/src/mcp-tools/interactive.ts +0 -169
  251. package/container/agent-runner/src/mcp-tools/scheduling.instructions.md +0 -40
  252. package/container/agent-runner/src/mcp-tools/scheduling.ts +0 -299
  253. package/container/agent-runner/src/mcp-tools/self-mod.instructions.md +0 -25
  254. package/container/agent-runner/src/mcp-tools/self-mod.ts +0 -120
  255. package/container/agent-runner/src/mcp-tools/server.ts +0 -54
  256. package/container/agent-runner/src/mcp-tools/types.ts +0 -6
  257. package/container/agent-runner/src/poll-loop.test.ts +0 -248
  258. package/container/agent-runner/src/poll-loop.ts +0 -437
  259. package/container/agent-runner/src/providers/claude.ts +0 -379
  260. package/container/agent-runner/src/providers/factory.test.ts +0 -19
  261. package/container/agent-runner/src/providers/factory.ts +0 -13
  262. package/container/agent-runner/src/providers/index.ts +0 -6
  263. package/container/agent-runner/src/providers/mock.ts +0 -77
  264. package/container/agent-runner/src/providers/provider-registry.ts +0 -33
  265. package/container/agent-runner/src/providers/types.ts +0 -82
  266. package/container/agent-runner/src/scheduling/task-script.ts +0 -121
  267. package/container/agent-runner/src/timezone.test.ts +0 -93
  268. package/container/agent-runner/src/timezone.ts +0 -107
  269. package/container/agent-runner/tsconfig.json +0 -14
  270. package/container/build.sh +0 -48
  271. package/container/entrypoint.sh +0 -16
  272. package/container/skills/agent-browser/SKILL.md +0 -159
  273. package/container/skills/frontend-engineer/SKILL.md +0 -157
  274. package/container/skills/self-customize/SKILL.md +0 -87
  275. package/container/skills/slack-formatting/SKILL.md +0 -94
  276. package/container/skills/vercel-cli/SKILL.md +0 -111
  277. package/container/skills/welcome/SKILL.md +0 -85
  278. package/docs/APPLE-CONTAINER-NETWORKING.md +0 -90
  279. package/docs/BRANCH-FORK-MAINTENANCE.md +0 -81
  280. package/docs/README.md +0 -25
  281. package/docs/SDK_DEEP_DIVE.md +0 -643
  282. package/docs/SECURITY.md +0 -162
  283. package/docs/agent-runner-details.md +0 -749
  284. package/docs/api-details.md +0 -365
  285. package/docs/architecture-diagram.html +0 -422
  286. package/docs/architecture-diagram.md +0 -215
  287. package/docs/architecture.md +0 -751
  288. package/docs/audit/2026-04-30-channel-endpoint-audit.md +0 -36
  289. package/docs/build-and-runtime.md +0 -80
  290. package/docs/cross-mount-stress/README.md +0 -112
  291. package/docs/cross-mount-stress/container-writer-retry.mjs +0 -55
  292. package/docs/cross-mount-stress/container-writer-slow.mjs +0 -42
  293. package/docs/cross-mount-stress/container-writer.mjs +0 -47
  294. package/docs/cross-mount-stress/host-writer-retry.mjs +0 -55
  295. package/docs/cross-mount-stress/host-writer-slow.mjs +0 -43
  296. package/docs/cross-mount-stress/host-writer.mjs +0 -47
  297. package/docs/db-central.md +0 -316
  298. package/docs/db-session.md +0 -183
  299. package/docs/db.md +0 -119
  300. package/docs/design/2026-04-29-vault-management-ui.md +0 -231
  301. package/docs/design/2026-04-30-channel-wiring-rework.md +0 -234
  302. package/docs/design/2026-05-01-channel-wiring-approvals-deep-dive.md +0 -272
  303. package/docs/design/2026-05-02-channel-policy-and-approval-routing.md +0 -250
  304. package/docs/docker-sandboxes.md +0 -359
  305. package/docs/isolation-model.md +0 -88
  306. package/docs/ollama.md +0 -79
  307. package/docs/parachute-integration.md +0 -109
  308. package/docs/post-night-rebirth-reflections.md +0 -151
  309. package/eslint.config.js +0 -32
  310. package/pnpm-workspace.yaml +0 -8
  311. package/repo-tokens/README.md +0 -113
  312. package/repo-tokens/action.yml +0 -186
  313. package/repo-tokens/badge.svg +0 -23
  314. package/repo-tokens/examples/green.svg +0 -14
  315. package/repo-tokens/examples/red.svg +0 -14
  316. package/repo-tokens/examples/yellow-green.svg +0 -14
  317. package/repo-tokens/examples/yellow.svg +0 -14
  318. package/scripts/chat.ts +0 -101
  319. package/scripts/cleanup-sessions.sh +0 -150
  320. package/scripts/init-cli-agent.ts +0 -172
  321. package/scripts/init-first-agent.ts +0 -378
  322. package/scripts/parachute.ts +0 -158
  323. package/scripts/run-migrations.ts +0 -105
  324. package/scripts/sanity-live-poll.ts +0 -95
  325. package/scripts/seed-discord.ts +0 -80
  326. package/scripts/test-v2-agent.ts +0 -106
  327. package/scripts/test-v2-channel-e2e.ts +0 -265
  328. package/scripts/test-v2-host.ts +0 -184
  329. package/src/channels/adapter.ts +0 -214
  330. package/src/channels/api-translator.test.ts +0 -306
  331. package/src/channels/api-translator.ts +0 -214
  332. package/src/channels/ask-question.ts +0 -46
  333. package/src/channels/channel-registry.test.ts +0 -421
  334. package/src/channels/channel-registry.ts +0 -313
  335. package/src/channels/chat-sdk-bridge.test.ts +0 -84
  336. package/src/channels/chat-sdk-bridge.ts +0 -652
  337. package/src/channels/cli.ts +0 -276
  338. package/src/channels/discord.ts +0 -90
  339. package/src/channels/index.ts +0 -17
  340. package/src/channels/telegram-markdown-sanitize.test.ts +0 -78
  341. package/src/channels/telegram-markdown-sanitize.ts +0 -55
  342. package/src/channels/telegram-pairing.test.ts +0 -254
  343. package/src/channels/telegram-pairing.ts +0 -339
  344. package/src/channels/telegram.ts +0 -279
  345. package/src/channels/trust-hint.test.ts +0 -48
  346. package/src/channels/trust-hint.ts +0 -75
  347. package/src/claude-md-compose.migrate.test.ts +0 -64
  348. package/src/claude-md-compose.ts +0 -205
  349. package/src/command-gate.ts +0 -63
  350. package/src/config.test.ts +0 -93
  351. package/src/config.ts +0 -128
  352. package/src/container-config.ts +0 -167
  353. package/src/container-runner.test.ts +0 -32
  354. package/src/container-runner.ts +0 -576
  355. package/src/container-runtime.test.ts +0 -269
  356. package/src/container-runtime.ts +0 -167
  357. package/src/db/_bun-sqlite-shim.ts +0 -88
  358. package/src/db/agent-activity.test.ts +0 -155
  359. package/src/db/agent-activity.ts +0 -121
  360. package/src/db/agent-groups.ts +0 -77
  361. package/src/db/connection.migrate.test.ts +0 -176
  362. package/src/db/connection.ts +0 -259
  363. package/src/db/db-v2.test.ts +0 -440
  364. package/src/db/dropped-messages.ts +0 -44
  365. package/src/db/index.ts +0 -40
  366. package/src/db/messaging-groups.ts +0 -252
  367. package/src/db/migrations/001-initial.ts +0 -112
  368. package/src/db/migrations/002-chat-sdk-state.ts +0 -36
  369. package/src/db/migrations/008-dropped-messages.ts +0 -27
  370. package/src/db/migrations/009-drop-pending-credentials.ts +0 -13
  371. package/src/db/migrations/010-engage-modes.ts +0 -103
  372. package/src/db/migrations/011-pending-sender-approvals.ts +0 -40
  373. package/src/db/migrations/012-channel-registration.ts +0 -48
  374. package/src/db/migrations/013-approval-render-metadata.ts +0 -27
  375. package/src/db/migrations/014-secrets.ts +0 -44
  376. package/src/db/migrations/015-secrets-drop-host-pattern.ts +0 -18
  377. package/src/db/migrations/016-secret-assignments.ts +0 -30
  378. package/src/db/migrations/017-agent-activity.ts +0 -40
  379. package/src/db/migrations/018-oauth-app-configs.ts +0 -34
  380. package/src/db/migrations/019-oauth-app-connections.ts +0 -48
  381. package/src/db/migrations/020-agent-app-connections.ts +0 -28
  382. package/src/db/migrations/021-pending-oauth-states.ts +0 -35
  383. package/src/db/migrations/022-app-connections-provider.ts +0 -25
  384. package/src/db/migrations/023-agent-group-secret-mode.test.ts +0 -124
  385. package/src/db/migrations/023-agent-group-secret-mode.ts +0 -65
  386. package/src/db/migrations/024-collapse-approvals.test.ts +0 -249
  387. package/src/db/migrations/024-collapse-approvals.ts +0 -182
  388. package/src/db/migrations/025-secret-mode-check.test.ts +0 -155
  389. package/src/db/migrations/025-secret-mode-check.ts +0 -49
  390. package/src/db/migrations/026-user-dms-bot-id.test.ts +0 -116
  391. package/src/db/migrations/026-user-dms-bot-id.ts +0 -54
  392. package/src/db/migrations/027-provider-credentials.ts +0 -41
  393. package/src/db/migrations/_test-helpers.ts +0 -41
  394. package/src/db/migrations/index.ts +0 -127
  395. package/src/db/migrations/module-agent-to-agent-destinations.ts +0 -84
  396. package/src/db/migrations/module-approvals-pending-approvals.ts +0 -42
  397. package/src/db/migrations/module-approvals-title-options.ts +0 -40
  398. package/src/db/schema.ts +0 -258
  399. package/src/db/session-db.test.ts +0 -93
  400. package/src/db/session-db.ts +0 -325
  401. package/src/db/sessions.ts +0 -241
  402. package/src/delivery.test.ts +0 -148
  403. package/src/delivery.ts +0 -445
  404. package/src/env.ts +0 -74
  405. package/src/group-folder.test.ts +0 -35
  406. package/src/group-folder.ts +0 -44
  407. package/src/group-init.ts +0 -92
  408. package/src/host-core.test.ts +0 -456
  409. package/src/host-sweep.test.ts +0 -146
  410. package/src/host-sweep.ts +0 -287
  411. package/src/index.ts +0 -232
  412. package/src/install-slug.ts +0 -33
  413. package/src/log.test.ts +0 -81
  414. package/src/log.ts +0 -117
  415. package/src/mcp/http.ts +0 -72
  416. package/src/mcp/server.ts +0 -92
  417. package/src/mcp/stdio.ts +0 -51
  418. package/src/mcp/tools/activity.ts +0 -88
  419. package/src/mcp/tools/agent-groups.ts +0 -183
  420. package/src/mcp/tools/approvals.ts +0 -122
  421. package/src/mcp/tools/channels.test.ts +0 -126
  422. package/src/mcp/tools/channels.ts +0 -134
  423. package/src/mcp/tools/index.ts +0 -27
  424. package/src/mcp/tools/oauth.ts +0 -48
  425. package/src/mcp/tools/secrets.ts +0 -169
  426. package/src/mcp/tools/sessions.ts +0 -135
  427. package/src/mcp/types.ts +0 -51
  428. package/src/modules/agent-to-agent/agent-route.test.ts +0 -46
  429. package/src/modules/agent-to-agent/agent-route.ts +0 -223
  430. package/src/modules/agent-to-agent/create-agent.ts +0 -127
  431. package/src/modules/agent-to-agent/db/agent-destinations.ts +0 -135
  432. package/src/modules/agent-to-agent/index.ts +0 -22
  433. package/src/modules/agent-to-agent/write-destinations.ts +0 -59
  434. package/src/modules/approvals/agent.md +0 -45
  435. package/src/modules/approvals/index.ts +0 -21
  436. package/src/modules/approvals/picks.test.ts +0 -291
  437. package/src/modules/approvals/primitive.ts +0 -279
  438. package/src/modules/approvals/project.md +0 -27
  439. package/src/modules/approvals/response-handler.ts +0 -87
  440. package/src/modules/index.ts +0 -24
  441. package/src/modules/interactive/agent.md +0 -21
  442. package/src/modules/interactive/index.ts +0 -69
  443. package/src/modules/interactive/project.md +0 -12
  444. package/src/modules/mount-security/expand-path.test.ts +0 -82
  445. package/src/modules/mount-security/index.ts +0 -459
  446. package/src/modules/mount-security/migrate.test.ts +0 -91
  447. package/src/modules/permissions/access.ts +0 -28
  448. package/src/modules/permissions/channel-approval.test.ts +0 -389
  449. package/src/modules/permissions/channel-approval.ts +0 -188
  450. package/src/modules/permissions/db/agent-group-members.ts +0 -44
  451. package/src/modules/permissions/db/pending-channel-approvals.test.ts +0 -86
  452. package/src/modules/permissions/db/pending-channel-approvals.ts +0 -66
  453. package/src/modules/permissions/db/pending-sender-approvals.ts +0 -60
  454. package/src/modules/permissions/db/user-dms.ts +0 -58
  455. package/src/modules/permissions/db/user-roles.ts +0 -85
  456. package/src/modules/permissions/db/users.ts +0 -38
  457. package/src/modules/permissions/index.ts +0 -421
  458. package/src/modules/permissions/permissions.test.ts +0 -358
  459. package/src/modules/permissions/sender-approval.test.ts +0 -641
  460. package/src/modules/permissions/sender-approval.ts +0 -165
  461. package/src/modules/permissions/user-dm.ts +0 -200
  462. package/src/modules/provider-credentials/db.ts +0 -121
  463. package/src/modules/provider-credentials/index.ts +0 -12
  464. package/src/modules/provider-credentials/spawn.test.ts +0 -206
  465. package/src/modules/provider-credentials/spawn.ts +0 -114
  466. package/src/modules/scheduling/actions.ts +0 -113
  467. package/src/modules/scheduling/db.test.ts +0 -282
  468. package/src/modules/scheduling/db.ts +0 -148
  469. package/src/modules/scheduling/index.ts +0 -34
  470. package/src/modules/scheduling/recurrence.test.ts +0 -98
  471. package/src/modules/scheduling/recurrence.ts +0 -54
  472. package/src/modules/self-mod/agent.md +0 -30
  473. package/src/modules/self-mod/apply.ts +0 -85
  474. package/src/modules/self-mod/index.ts +0 -30
  475. package/src/modules/self-mod/project.md +0 -39
  476. package/src/modules/self-mod/request.ts +0 -91
  477. package/src/modules/typing/index.ts +0 -165
  478. package/src/oauth/agent-app-connections.ts +0 -103
  479. package/src/oauth/app-configs.test.ts +0 -64
  480. package/src/oauth/app-configs.ts +0 -114
  481. package/src/oauth/app-connections.test.ts +0 -109
  482. package/src/oauth/app-connections.ts +0 -178
  483. package/src/oauth/crypto.ts +0 -56
  484. package/src/oauth/flow.ts +0 -104
  485. package/src/oauth/providers/google.test.ts +0 -38
  486. package/src/oauth/providers/google.ts +0 -46
  487. package/src/oauth/providers/index.ts +0 -48
  488. package/src/oauth/state-store.test.ts +0 -54
  489. package/src/oauth/state-store.ts +0 -93
  490. package/src/parachute/README.md +0 -27
  491. package/src/parachute/create-agent.test.ts +0 -83
  492. package/src/parachute/create-agent.ts +0 -122
  493. package/src/parachute/group-status.test.ts +0 -165
  494. package/src/parachute/group-status.ts +0 -136
  495. package/src/parachute/types.ts +0 -41
  496. package/src/parachute/vault-mcp.test.ts +0 -251
  497. package/src/parachute/vault-mcp.ts +0 -232
  498. package/src/platform-id.test.ts +0 -104
  499. package/src/platform-id.ts +0 -109
  500. package/src/providers/index.ts +0 -6
  501. package/src/providers/provider-container-registry.ts +0 -58
  502. package/src/response-registry.ts +0 -45
  503. package/src/router.ts +0 -530
  504. package/src/secrets/crypto.test.ts +0 -45
  505. package/src/secrets/crypto.ts +0 -55
  506. package/src/secrets/index.ts +0 -461
  507. package/src/secrets/master-key.ts +0 -70
  508. package/src/secrets/secrets.test.ts +0 -651
  509. package/src/session-manager.attachments.test.ts +0 -171
  510. package/src/session-manager.dup-skip.test.ts +0 -173
  511. package/src/session-manager.migrate.test.ts +0 -59
  512. package/src/session-manager.ts +0 -451
  513. package/src/startup-bootstrap.test.ts +0 -226
  514. package/src/startup-bootstrap.ts +0 -207
  515. package/src/state-sqlite.ts +0 -182
  516. package/src/timezone.test.ts +0 -64
  517. package/src/timezone.ts +0 -37
  518. package/src/types.ts +0 -233
  519. package/src/web/auth.test.ts +0 -335
  520. package/src/web/auth.ts +0 -214
  521. package/src/web/discord-validate.test.ts +0 -77
  522. package/src/web/discord-validate.ts +0 -88
  523. package/src/web/hub-discovery.test.ts +0 -98
  524. package/src/web/hub-discovery.ts +0 -69
  525. package/src/web/routes/activity.ts +0 -106
  526. package/src/web/routes/agent-provider.test.ts +0 -282
  527. package/src/web/routes/agent-provider.ts +0 -309
  528. package/src/web/routes/approvals.ts +0 -185
  529. package/src/web/routes/apps.ts +0 -434
  530. package/src/web/routes/channels-mg-detail.test.ts +0 -324
  531. package/src/web/routes/channels-mga-detail.test.ts +0 -472
  532. package/src/web/routes/channels.ts +0 -311
  533. package/src/web/routes/oauth-providers.ts +0 -42
  534. package/src/web/routes/secrets.test.ts +0 -220
  535. package/src/web/routes/secrets.ts +0 -317
  536. package/src/web/routes/sessions.ts +0 -123
  537. package/src/web/routes/settings.test.ts +0 -106
  538. package/src/web/routes/settings.ts +0 -247
  539. package/src/web/routes/setup-status.ts +0 -205
  540. package/src/web/routes/vaults.test.ts +0 -389
  541. package/src/web/routes/vaults.ts +0 -225
  542. package/src/web/server-version.test.ts +0 -16
  543. package/src/web/server.ts +0 -1024
  544. package/src/web/services-manifest.test.ts +0 -148
  545. package/src/web/services-manifest.ts +0 -66
  546. package/src/web/static-serve.test.ts +0 -255
  547. package/src/web/static-serve.ts +0 -104
  548. package/src/web/telegram-validate.test.ts +0 -116
  549. package/src/web/telegram-validate.ts +0 -107
  550. package/src/web/vault-proxy.test.ts +0 -214
  551. package/src/web/vault-proxy.ts +0 -120
  552. package/src/web/wire-channel.ts +0 -181
  553. package/src/webhook-server.ts +0 -134
  554. package/vitest.config.ts +0 -18
  555. package/web/README.md +0 -63
  556. package/web/ui/index.html +0 -13
  557. package/web/ui/package.json +0 -35
  558. package/web/ui/pnpm-lock.yaml +0 -2164
  559. package/web/ui/scripts/verify-base.mjs +0 -31
  560. package/web/ui/src/App.tsx +0 -88
  561. package/web/ui/src/components/ActivityFeed.tsx +0 -444
  562. package/web/ui/src/components/AgentGroupPicker.tsx +0 -263
  563. package/web/ui/src/components/AgentProviderCards.tsx +0 -220
  564. package/web/ui/src/components/CredentialForm.tsx +0 -214
  565. package/web/ui/src/components/ScopeGrants.tsx +0 -74
  566. package/web/ui/src/components/StatusDot.tsx +0 -43
  567. package/web/ui/src/components/VaultPicker.tsx +0 -127
  568. package/web/ui/src/components/setup/AdapterInstallStep.tsx +0 -178
  569. package/web/ui/src/components/setup/AgentGroupStep.tsx +0 -43
  570. package/web/ui/src/components/setup/ChannelPickStep.tsx +0 -74
  571. package/web/ui/src/components/setup/DoneStep.tsx +0 -49
  572. package/web/ui/src/components/setup/PrereqStep.tsx +0 -129
  573. package/web/ui/src/components/setup/TestConnectionStep.tsx +0 -108
  574. package/web/ui/src/components/setup/TestMessageStep.tsx +0 -104
  575. package/web/ui/src/components/setup/WireChannelStep.tsx +0 -166
  576. package/web/ui/src/components/setup/types.ts +0 -105
  577. package/web/ui/src/lib/api.test.ts +0 -410
  578. package/web/ui/src/lib/api.ts +0 -1248
  579. package/web/ui/src/lib/auth.test.ts +0 -352
  580. package/web/ui/src/lib/auth.ts +0 -405
  581. package/web/ui/src/lib/channel-adapters.ts +0 -136
  582. package/web/ui/src/main.tsx +0 -19
  583. package/web/ui/src/routes/ApprovalsList.tsx +0 -294
  584. package/web/ui/src/routes/Apps.tsx +0 -613
  585. package/web/ui/src/routes/ChannelWireDetail.test.tsx +0 -233
  586. package/web/ui/src/routes/ChannelWireDetail.tsx +0 -403
  587. package/web/ui/src/routes/ChannelsList.tsx +0 -158
  588. package/web/ui/src/routes/GroupDetail.test.tsx +0 -206
  589. package/web/ui/src/routes/GroupDetail.tsx +0 -880
  590. package/web/ui/src/routes/GroupList.tsx +0 -187
  591. package/web/ui/src/routes/MessagingGroupDetail.test.tsx +0 -233
  592. package/web/ui/src/routes/MessagingGroupDetail.tsx +0 -306
  593. package/web/ui/src/routes/NewGroupWizard.tsx +0 -390
  594. package/web/ui/src/routes/OAuthCallback.tsx +0 -56
  595. package/web/ui/src/routes/SecretsList.tsx +0 -942
  596. package/web/ui/src/routes/SessionsList.tsx +0 -220
  597. package/web/ui/src/routes/SettingsAgentProvider.tsx +0 -109
  598. package/web/ui/src/routes/SettingsApprovals.tsx +0 -234
  599. package/web/ui/src/routes/SetupWizard.tsx +0 -219
  600. package/web/ui/src/routes/VaultDetail.test.tsx +0 -363
  601. package/web/ui/src/routes/VaultDetail.tsx +0 -960
  602. package/web/ui/src/routes/VaultsList.tsx +0 -295
  603. package/web/ui/src/routes/WireChannelPage.tsx +0 -413
  604. package/web/ui/src/styles.css +0 -608
  605. package/web/ui/src/test/setup.ts +0 -23
  606. package/web/ui/src/vite-env.d.ts +0 -10
  607. package/web/ui/vite.config.ts +0 -34
  608. package/web/ui/vitest.config.ts +0 -25
@@ -1,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
- });