@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,652 +0,0 @@
1
- /**
2
- * Chat SDK bridge — wraps a Chat SDK adapter + Chat instance
3
- * to conform to the Paraclaw ChannelAdapter interface.
4
- *
5
- * Used by Discord, Slack, and other Chat SDK-supported platforms.
6
- */
7
- import http from 'http';
8
-
9
- import {
10
- Chat,
11
- Card,
12
- CardText,
13
- Actions,
14
- Button,
15
- type Adapter,
16
- type ConcurrencyStrategy,
17
- type Message as ChatMessage,
18
- } from 'chat';
19
- import { log } from '../log.js';
20
- import { SqliteStateAdapter } from '../state-sqlite.js';
21
- import { registerWebhookAdapter } from '../webhook-server.js';
22
- import { getAskQuestionRender } from '../db/sessions.js';
23
- import { encodePlatformId } from '../platform-id.js';
24
- import { normalizeOptions, type NormalizedOption } from './ask-question.js';
25
- import type { ChannelAdapter, ChannelSetup, InboundMessage } from './adapter.js';
26
-
27
- /** Adapter with optional gateway support (e.g., Discord). */
28
- interface GatewayAdapter extends Adapter {
29
- startGatewayListener?(
30
- options: { waitUntil?: (task: Promise<unknown>) => void },
31
- durationMs?: number,
32
- abortSignal?: AbortSignal,
33
- webhookUrl?: string,
34
- ): Promise<Response>;
35
- }
36
-
37
- /** Reply context extracted from a platform's raw message. */
38
- export interface ReplyContext {
39
- text: string;
40
- sender: string;
41
- }
42
-
43
- /** Extract reply context from a platform-specific raw message. Return null if no reply. */
44
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
45
- export type ReplyContextExtractor = (raw: Record<string, any>) => ReplyContext | null;
46
-
47
- export interface ChatSdkBridgeConfig {
48
- adapter: Adapter;
49
- concurrency?: ConcurrencyStrategy;
50
- /**
51
- * Bot identity for v2 platform_id encoding. The bridge prefixes inbound
52
- * platform_ids with `<botId>` so multiple bots on the same channel
53
- * (e.g. two Telegram bots in the same install) route to distinct
54
- * messaging_groups rows. Outbound deliveries strip the bot dim back out
55
- * before handing to the SDK adapter, which only knows the v1 form.
56
- *
57
- * Rationale: see src/platform-id.ts module comment.
58
- */
59
- botId: string;
60
- /** Bot token for authenticating forwarded Gateway events (required for interaction handling). */
61
- botToken?: string;
62
- /** Platform-specific reply context extraction. */
63
- extractReplyContext?: ReplyContextExtractor;
64
- /**
65
- * Whether this platform uses threads as the primary conversation unit.
66
- * See `ChannelAdapter.supportsThreads`. Declared by the calling channel
67
- * skill, not inferred, because some platforms (Discord) can be used either
68
- * way and the default depends on installation style.
69
- */
70
- supportsThreads: boolean;
71
- /**
72
- * Optional transform applied to outbound text/markdown before it reaches the
73
- * adapter. Used by channels that need to sanitize for a platform-specific
74
- * quirk (e.g. Telegram's legacy Markdown parse mode).
75
- */
76
- transformOutboundText?: (text: string) => string;
77
- /**
78
- * Maximum text length the underlying adapter accepts in a single message.
79
- * When set, the bridge splits outbound text longer than this on paragraph
80
- * → line → hard-char boundaries and posts multiple messages. Without this,
81
- * adapters like Discord (2000) and Telegram (4096) silently truncate
82
- * mid-response. The returned id is the first chunk's id so subsequent edits
83
- * and reactions still target the head of the reply.
84
- */
85
- maxTextLength?: number;
86
- }
87
-
88
- /**
89
- * Split `text` into chunks no larger than `limit`, preferring paragraph
90
- * breaks, then line breaks, then a hard character cut as a last resort.
91
- * Preserves code fences only structurally — a fenced block that straddles a
92
- * chunk boundary will render as two independent blocks on the receiving
93
- * platform, which is the same behavior as manually re-opening a fence.
94
- */
95
- /**
96
- * Decode the actual option value from a button callback. Buttons are encoded
97
- * with an integer index (to keep under Telegram's 64-byte callback_data cap),
98
- * and the real value is looked up via `getAskQuestionRender(questionId)`.
99
- * Falls back to treating the tail as a literal value so old in-flight cards
100
- * (encoded before this shortening landed) still resolve.
101
- */
102
- function resolveSelectedOption(
103
- render: { options: NormalizedOption[] } | undefined,
104
- eventValue: string | undefined,
105
- tail: string | undefined,
106
- ): string {
107
- const candidate = eventValue ?? tail ?? '';
108
- if (render && /^\d+$/.test(candidate)) {
109
- const idx = Number(candidate);
110
- if (render.options[idx]) return render.options[idx].value;
111
- }
112
- return candidate;
113
- }
114
-
115
- export function splitForLimit(text: string, limit: number): string[] {
116
- if (text.length <= limit) return [text];
117
- const chunks: string[] = [];
118
- let remaining = text;
119
- while (remaining.length > limit) {
120
- let cut = remaining.lastIndexOf('\n\n', limit);
121
- if (cut <= 0) cut = remaining.lastIndexOf('\n', limit);
122
- if (cut <= 0) cut = remaining.lastIndexOf(' ', limit);
123
- if (cut <= 0) cut = limit;
124
- chunks.push(remaining.slice(0, cut).trimEnd());
125
- remaining = remaining.slice(cut).trimStart();
126
- }
127
- if (remaining.length > 0) chunks.push(remaining);
128
- return chunks;
129
- }
130
-
131
- export function createChatSdkBridge(config: ChatSdkBridgeConfig): ChannelAdapter {
132
- const { adapter, botId } = config;
133
- const transformText = (t: string): string => (config.transformOutboundText ? config.transformOutboundText(t) : t);
134
-
135
- /**
136
- * Insert the bot id into a v1 platform_id from the SDK.
137
- * `<channel>:<native>` → `<channel>:<botId>:<native>`.
138
- * If the input does not start with `<channel>:` (defensive — shouldn't
139
- * happen for Chat-SDK-namespaced ids), it is returned unchanged.
140
- */
141
- function withBot(sdkPlatformId: string): string {
142
- const colon = sdkPlatformId.indexOf(':');
143
- if (colon === -1) return sdkPlatformId;
144
- const channel = sdkPlatformId.slice(0, colon);
145
- const native = sdkPlatformId.slice(colon + 1);
146
- return encodePlatformId(channel, botId, native);
147
- }
148
-
149
- /**
150
- * Inverse of {@link withBot}: strip the bot id from a v2 platform_id so
151
- * the SDK adapter sees the form it produced. Tolerates already-v1 input
152
- * (legacy queue rows that haven't been backfilled) — passes through.
153
- */
154
- function withoutBot(v2PlatformId: string): string {
155
- const colon = v2PlatformId.indexOf(':');
156
- if (colon === -1) return v2PlatformId;
157
- const rest = v2PlatformId.slice(colon + 1);
158
- if (rest.startsWith(`${botId}:`)) {
159
- return `${v2PlatformId.slice(0, colon + 1)}${rest.slice(botId.length + 1)}`;
160
- }
161
- return v2PlatformId;
162
- }
163
- let chat: Chat;
164
- let state: SqliteStateAdapter;
165
- let setupConfig: ChannelSetup;
166
- let gatewayAbort: AbortController | null = null;
167
-
168
- async function messageToInbound(
169
- message: ChatMessage,
170
- isMention: boolean,
171
- isGroup?: boolean,
172
- ): Promise<InboundMessage> {
173
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
174
- const serialized = message.toJSON() as Record<string, any>;
175
-
176
- // Download attachment data before serialization loses fetchData()
177
- if (message.attachments && message.attachments.length > 0) {
178
- const enriched = [];
179
- for (const att of message.attachments) {
180
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
181
- const entry: Record<string, any> = {
182
- type: att.type,
183
- name: att.name,
184
- mimeType: att.mimeType,
185
- size: att.size,
186
- width: (att as unknown as Record<string, unknown>).width,
187
- height: (att as unknown as Record<string, unknown>).height,
188
- };
189
- if (att.fetchData) {
190
- try {
191
- const buffer = await att.fetchData();
192
- entry.data = buffer.toString('base64');
193
- } catch (err) {
194
- log.warn('Failed to download attachment', { type: att.type, err });
195
- }
196
- }
197
- enriched.push(entry);
198
- }
199
- serialized.attachments = enriched;
200
- }
201
-
202
- // Extract reply context via platform-specific hook
203
- if (config.extractReplyContext && message.raw) {
204
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
205
- const replyTo = config.extractReplyContext(message.raw as Record<string, any>);
206
- if (replyTo) serialized.replyTo = replyTo;
207
- }
208
-
209
- // Project chat-sdk's nested author into the flat sender fields the router
210
- // expects (see src/router.ts extractAndUpsertUser). Native adapters already
211
- // populate these directly; this brings chat-sdk adapters in line.
212
- const author = serialized.author as { userId?: string; fullName?: string; userName?: string } | undefined;
213
- if (author) {
214
- const name = author.fullName ?? author.userName;
215
- serialized.senderId = author.userId;
216
- serialized.sender = name;
217
- serialized.senderName = name;
218
- }
219
-
220
- // Drop raw to save DB space (can be very large)
221
- serialized.raw = undefined;
222
-
223
- return {
224
- id: message.id,
225
- kind: 'chat-sdk',
226
- content: serialized,
227
- timestamp: message.metadata.dateSent.toISOString(),
228
- isMention,
229
- isGroup,
230
- };
231
- }
232
-
233
- const bridge: ChannelAdapter = {
234
- name: adapter.name,
235
- channelType: adapter.name,
236
- supportsThreads: config.supportsThreads,
237
-
238
- async setup(hostConfig: ChannelSetup) {
239
- setupConfig = hostConfig;
240
-
241
- state = new SqliteStateAdapter();
242
-
243
- chat = new Chat({
244
- adapters: { [adapter.name]: adapter },
245
- userName: adapter.userName || 'Parachute Agent',
246
- concurrency: config.concurrency ?? 'concurrent',
247
- state,
248
- logger: 'silent',
249
- });
250
-
251
- // Four SDK dispatch paths — bridge just forwards. All per-wiring
252
- // engage / accumulate / drop / subscribe decisions live in the host
253
- // router (src/router.ts routeInbound / evaluateEngage). The bridge
254
- // only resolves channel ids and sets the platform-confirmed isMention
255
- // flag that routeInbound evaluates; the router calls back into
256
- // bridge.subscribe(...) when a mention-sticky wiring engages.
257
-
258
- // Subscribed threads — every message in a thread we've previously
259
- // engaged. Carry the SDK's `message.isMention` through so mention-mode
260
- // wirings still fire on in-thread mentions.
261
- chat.onSubscribedMessage(async (thread, message) => {
262
- const channelId = withBot(adapter.channelIdFromThreadId(thread.id));
263
- await setupConfig.onInbound(
264
- channelId,
265
- thread.id,
266
- await messageToInbound(message, message.isMention === true, true),
267
- );
268
- });
269
-
270
- // @mention in an unsubscribed thread — SDK-confirmed bot mention.
271
- chat.onNewMention(async (thread, message) => {
272
- const channelId = withBot(adapter.channelIdFromThreadId(thread.id));
273
- await setupConfig.onInbound(channelId, thread.id, await messageToInbound(message, true, true));
274
- });
275
-
276
- // DMs — by definition addressed to the bot. Thread id flows through
277
- // so sub-thread context reaches delivery (Slack users can open threads
278
- // inside a DM). Router collapses DM sub-threads to one session via
279
- // is_group=0 short-circuit.
280
- chat.onDirectMessage(async (thread, message) => {
281
- const channelId = withBot(adapter.channelIdFromThreadId(thread.id));
282
- log.info('Inbound DM received', {
283
- adapter: adapter.name,
284
- channelId,
285
- sender: (message.author as any)?.fullName ?? (message.author as any)?.userId ?? 'unknown',
286
- threadId: thread.id,
287
- });
288
- await setupConfig.onInbound(channelId, thread.id, await messageToInbound(message, true, false));
289
- });
290
-
291
- // Plain messages in unsubscribed threads.
292
- //
293
- // Chat SDK dispatch (handling-events.mdx §"Handler dispatch order") is
294
- // exclusive: subscribed → onSubscribedMessage; unsubscribed+mention →
295
- // onNewMention; unsubscribed+pattern-match → onNewMessage. Registering
296
- // with `/./` lets the router see every plain message on every
297
- // unsubscribed thread the bot can see. The router short-circuits via
298
- // getMessagingGroupWithAgentCount (~1 DB read) for unwired channels,
299
- // so forwarding every one is cheap enough to not need a bridge-side
300
- // flood gate.
301
- chat.onNewMessage(/./, async (thread, message) => {
302
- const channelId = withBot(adapter.channelIdFromThreadId(thread.id));
303
- await setupConfig.onInbound(channelId, thread.id, await messageToInbound(message, false, true));
304
- });
305
-
306
- // Handle button clicks (ask_user_question)
307
- chat.onAction(async (event) => {
308
- if (!event.actionId.startsWith('ncq:')) return;
309
- const parts = event.actionId.split(':');
310
- if (parts.length < 3) return;
311
- const questionId = parts[1];
312
- const tail = parts.slice(2).join(':');
313
- const userId = event.user?.userId || '';
314
-
315
- // Resolve render metadata BEFORE dispatching onAction (which deletes the row).
316
- const render = getAskQuestionRender(questionId);
317
- // New format: button id/value is an integer index into options (kept
318
- // short to fit Telegram's 64-byte callback_data cap). Old format:
319
- // the full value is embedded in actionId/value directly.
320
- const selectedOption = resolveSelectedOption(render, event.value, tail);
321
- const title = render?.title ?? '❓ Question';
322
- const matched = render?.options.find((o) => o.value === selectedOption);
323
- const selectedLabel = matched?.selectedLabel ?? selectedOption ?? '(clicked)';
324
-
325
- // Update the card to show the selected answer and remove buttons
326
- try {
327
- const tid = event.threadId;
328
- await adapter.editMessage(tid, event.messageId, {
329
- markdown: `${title}\n\n${selectedLabel}`,
330
- });
331
- } catch (err) {
332
- log.warn('Failed to update card after action', { err });
333
- }
334
-
335
- setupConfig.onAction(questionId, selectedOption, userId);
336
- });
337
-
338
- await chat.initialize();
339
-
340
- // Start Gateway listener for adapters that support it (e.g., Discord)
341
- const gatewayAdapter = adapter as GatewayAdapter;
342
- if (gatewayAdapter.startGatewayListener) {
343
- gatewayAbort = new AbortController();
344
-
345
- // Start local HTTP server to receive forwarded Gateway events (including interactions)
346
- const webhookUrl = await startLocalWebhookServer(gatewayAdapter, setupConfig, config.botToken);
347
-
348
- const startGateway = () => {
349
- if (gatewayAbort?.signal.aborted) return;
350
- // Capture the long-running listener promise via waitUntil
351
- let listenerPromise: Promise<unknown> | undefined;
352
- gatewayAdapter.startGatewayListener!(
353
- {
354
- waitUntil: (p: Promise<unknown>) => {
355
- listenerPromise = p;
356
- },
357
- },
358
- 24 * 60 * 60 * 1000,
359
- gatewayAbort!.signal,
360
- webhookUrl,
361
- ).then(() => {
362
- // startGatewayListener resolves immediately with a Response;
363
- // the actual work is in the listenerPromise passed to waitUntil
364
- if (listenerPromise) {
365
- listenerPromise
366
- .then(() => {
367
- if (!gatewayAbort?.signal.aborted) {
368
- log.info('Gateway listener expired, restarting', { adapter: adapter.name });
369
- startGateway();
370
- }
371
- })
372
- .catch((err) => {
373
- if (!gatewayAbort?.signal.aborted) {
374
- log.error('Gateway listener error, restarting in 5s', { adapter: adapter.name, err });
375
- setTimeout(startGateway, 5000);
376
- }
377
- });
378
- }
379
- });
380
- };
381
- startGateway();
382
- log.info('Gateway listener started', { adapter: adapter.name });
383
- } else {
384
- // Non-gateway adapters (Slack, Teams, GitHub, etc.) — register on the shared webhook server
385
- registerWebhookAdapter(chat, adapter.name);
386
- }
387
-
388
- log.info('Chat SDK bridge initialized', { adapter: adapter.name });
389
- },
390
-
391
- async deliver(platformId: string, threadId: string | null, message): Promise<string | undefined> {
392
- // platformId arrives in v2 form (`<channel>:<botId>:<native>`); the SDK
393
- // adapter only understands v1 (`<channel>:<native>`), so strip the bot
394
- // dim before using it as the thread id. threadId, when present, is
395
- // already an SDK-native thread id and goes through unchanged.
396
- const tid = threadId ?? withoutBot(platformId);
397
- const content = message.content as Record<string, unknown>;
398
-
399
- if (content.operation === 'edit' && content.messageId) {
400
- await adapter.editMessage(tid, content.messageId as string, {
401
- markdown: transformText((content.text as string) || (content.markdown as string) || ''),
402
- });
403
- return;
404
- }
405
-
406
- if (content.operation === 'reaction' && content.messageId && content.emoji) {
407
- await adapter.addReaction(tid, content.messageId as string, content.emoji as string);
408
- return;
409
- }
410
-
411
- // Ask question card — render as Card with buttons
412
- if (content.type === 'ask_question' && content.questionId && content.options) {
413
- const questionId = content.questionId as string;
414
- const title = content.title as string;
415
- const question = content.question as string;
416
- if (!title) {
417
- log.error('ask_question missing required title — skipping delivery', { questionId });
418
- return;
419
- }
420
- const options: NormalizedOption[] = normalizeOptions(content.options as never);
421
- const card = Card({
422
- title,
423
- children: [
424
- CardText(question),
425
- Actions(
426
- // Encode button id/value with the option index rather than the
427
- // full value. Telegram caps callback_data at 64 bytes, and
428
- // long values (e.g. ISO datetimes, URLs) push the JSON payload
429
- // well past that. The onAction handlers resolve the index back
430
- // to the real value via getAskQuestionRender(questionId).
431
- options.map((opt, idx) =>
432
- Button({ id: `ncq:${questionId}:${idx}`, label: opt.label, value: String(idx) }),
433
- ),
434
- ),
435
- ],
436
- });
437
- const result = await adapter.postMessage(tid, {
438
- card,
439
- fallbackText: `${title}\n\n${question}\nOptions: ${options.map((o) => o.label).join(', ')}`,
440
- });
441
- return result?.id;
442
- }
443
-
444
- // Normal message
445
- const rawText = (content.markdown as string) || (content.text as string);
446
- const text = rawText ? transformText(rawText) : rawText;
447
- if (text) {
448
- // Attach files if present (FileUpload format: { data, filename })
449
- const fileUploads = message.files?.map((f: { data: Buffer; filename: string }) => ({
450
- data: f.data,
451
- filename: f.filename,
452
- }));
453
- // Split if over the adapter's max length. Files ride on the first
454
- // chunk so the head of the reply still carries them.
455
- const chunks =
456
- config.maxTextLength && text.length > config.maxTextLength
457
- ? splitForLimit(text, config.maxTextLength)
458
- : [text];
459
- let firstId: string | undefined;
460
- for (let i = 0; i < chunks.length; i++) {
461
- const chunk = chunks[i];
462
- const attachFiles = i === 0 && fileUploads && fileUploads.length > 0;
463
- const result = await adapter.postMessage(
464
- tid,
465
- attachFiles ? { markdown: chunk, files: fileUploads } : { markdown: chunk },
466
- );
467
- if (i === 0) firstId = result?.id;
468
- }
469
- return firstId;
470
- } else if (message.files && message.files.length > 0) {
471
- // Files only, no text
472
- const fileUploads = message.files.map((f: { data: Buffer; filename: string }) => ({
473
- data: f.data,
474
- filename: f.filename,
475
- }));
476
- const result = await adapter.postMessage(tid, { markdown: '', files: fileUploads });
477
- return result?.id;
478
- }
479
- },
480
-
481
- async setTyping(platformId: string, threadId: string | null) {
482
- const tid = threadId ?? withoutBot(platformId);
483
- await adapter.startTyping(tid);
484
- },
485
-
486
- async teardown() {
487
- gatewayAbort?.abort();
488
- await chat.shutdown();
489
- log.info('Chat SDK bridge shut down', { adapter: adapter.name });
490
- },
491
-
492
- isConnected() {
493
- return true;
494
- },
495
-
496
- async subscribe(_platformId: string, threadId: string) {
497
- // Chat SDK's subscription state lives on the StateAdapter (not on the
498
- // Chat instance itself). SqliteStateAdapter.subscribe is idempotent —
499
- // a second call on an already-subscribed thread is a no-op. threadId
500
- // is the SDK's thread id, which is what the router already has from
501
- // the original inbound event.
502
- await state.subscribe(threadId);
503
- },
504
- };
505
-
506
- // Only expose openDM when the underlying Chat SDK adapter implements it.
507
- // Delegate straight to adapter.openDM rather than going through chat.openDM:
508
- // the latter dispatches via inferAdapterFromUserId, which only recognizes
509
- // Discord snowflakes, Slack U-ids, Teams 29:-ids, and gChat users/-ids, and
510
- // throws for everything else (Telegram numeric ids, iMessage, Matrix, …).
511
- // Calling adapter.openDM directly also preserves the adapter's native
512
- // platform_id encoding via channelIdFromThreadId (e.g. "telegram:<chatId>"),
513
- // which matches what onInbound stores in messaging_groups — avoiding a
514
- // duplicate-row / decode-error cascade at delivery time. See user-dm.ts for
515
- // the direct-addressable fallback when the adapter has no openDM at all.
516
- if (adapter.openDM) {
517
- bridge.openDM = async (userHandle: string): Promise<string> => {
518
- const threadId = await adapter.openDM!(userHandle);
519
- return withBot(adapter.channelIdFromThreadId(threadId));
520
- };
521
- }
522
-
523
- return bridge;
524
- }
525
-
526
- /**
527
- * Start a local HTTP server to receive forwarded Gateway events.
528
- * This is needed because the Gateway listener in webhook-forwarding mode
529
- * sends ALL raw events (including INTERACTION_CREATE for button clicks)
530
- * to the webhookUrl, which we handle here.
531
- */
532
- function startLocalWebhookServer(
533
- adapter: GatewayAdapter,
534
- setupConfig: ChannelSetup,
535
- botToken?: string,
536
- ): Promise<string> {
537
- return new Promise((resolve) => {
538
- const server = http.createServer((req, res) => {
539
- const chunks: Buffer[] = [];
540
- req.on('data', (chunk: Buffer) => chunks.push(chunk));
541
- req.on('end', () => {
542
- const body = Buffer.concat(chunks).toString();
543
- handleForwardedEvent(body, adapter, setupConfig, botToken)
544
- .then(() => {
545
- res.writeHead(200, { 'Content-Type': 'application/json' });
546
- res.end('{"ok":true}');
547
- })
548
- .catch((err) => {
549
- log.error('Webhook server error', { err });
550
- res.writeHead(500);
551
- res.end('{"error":"internal"}');
552
- });
553
- });
554
- });
555
-
556
- server.listen(0, '127.0.0.1', () => {
557
- const addr = server.address() as { port: number };
558
- const url = `http://127.0.0.1:${addr.port}/webhook`;
559
- log.info('Local webhook server started', { port: addr.port });
560
- resolve(url);
561
- });
562
- });
563
- }
564
-
565
- async function handleForwardedEvent(
566
- body: string,
567
- adapter: GatewayAdapter,
568
- setupConfig: ChannelSetup,
569
- botToken?: string,
570
- ): Promise<void> {
571
- let event: { type: string; data: Record<string, unknown> };
572
- try {
573
- event = JSON.parse(body);
574
- } catch {
575
- return;
576
- }
577
-
578
- // Handle interaction events (button clicks) — not handled by adapter's handleForwardedGatewayEvent
579
- if (event.type === 'GATEWAY_INTERACTION_CREATE' && event.data) {
580
- const interaction = event.data;
581
- // type 3 = MessageComponent (button/select)
582
- if (interaction.type === 3) {
583
- const customId = (interaction.data as Record<string, unknown>)?.custom_id as string;
584
- // In guilds the clicker is at interaction.member.user; in DMs it's interaction.user directly.
585
- const user =
586
- ((interaction.member as Record<string, unknown>)?.user as Record<string, string> | undefined) ??
587
- (interaction.user as Record<string, string> | undefined);
588
- const interactionId = interaction.id as string;
589
- const interactionToken = interaction.token as string;
590
-
591
- // Parse the selected option from custom_id
592
- let questionId: string | undefined;
593
- let tail: string | undefined;
594
- if (customId?.startsWith('ncq:')) {
595
- const colonIdx = customId.indexOf(':', 4); // after "ncq:"
596
- if (colonIdx !== -1) {
597
- questionId = customId.slice(4, colonIdx);
598
- tail = customId.slice(colonIdx + 1);
599
- }
600
- }
601
-
602
- // Update the card to show the selected answer and remove buttons
603
- const originalEmbeds =
604
- ((interaction.message as Record<string, unknown>)?.embeds as Array<Record<string, unknown>>) || [];
605
- const originalDescription = (originalEmbeds[0]?.description as string) || '';
606
- const render = questionId ? getAskQuestionRender(questionId) : undefined;
607
- // Discord custom_id mirrors the new index-based encoding (see Button
608
- // construction). Decode back to the real option value for downstream.
609
- const selectedOption = resolveSelectedOption(render, tail, tail);
610
- const cardTitle = render?.title ?? ((originalEmbeds[0]?.title as string) || '❓ Question');
611
- const matchedOpt = render?.options.find((o) => o.value === selectedOption);
612
- const selectedLabel = matchedOpt?.selectedLabel ?? selectedOption ?? customId;
613
- try {
614
- await fetch(`https://discord.com/api/v10/interactions/${interactionId}/${interactionToken}/callback`, {
615
- method: 'POST',
616
- headers: { 'Content-Type': 'application/json' },
617
- body: JSON.stringify({
618
- type: 7, // UPDATE_MESSAGE — acknowledge + update in one call
619
- data: {
620
- embeds: [
621
- {
622
- title: cardTitle,
623
- description: `${originalDescription}\n\n${selectedLabel}`,
624
- },
625
- ],
626
- components: [], // remove buttons
627
- },
628
- }),
629
- });
630
- } catch (err) {
631
- log.error('Failed to update interaction', { err });
632
- }
633
-
634
- // Dispatch to host
635
- if (questionId && selectedOption) {
636
- setupConfig.onAction(questionId, selectedOption, user?.id || '');
637
- }
638
- return;
639
- }
640
- }
641
-
642
- // Forward other events to the adapter's webhook handler for normal processing
643
- const fakeRequest = new Request('http://localhost/webhook', {
644
- method: 'POST',
645
- headers: {
646
- 'Content-Type': 'application/json',
647
- 'x-discord-gateway-token': botToken || '',
648
- },
649
- body,
650
- });
651
- await adapter.handleWebhook(fakeRequest, {});
652
- }