@openparachute/agent 0.1.2 → 0.2.0

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