@openparachute/agent 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (598) hide show
  1. package/.parachute/module.json +124 -8
  2. package/LICENSE +2 -16
  3. package/README.md +118 -166
  4. package/package.json +32 -43
  5. package/scripts/spawn-agent.ts +371 -0
  6. package/src/_parked/interactive-spawn.test.ts +324 -0
  7. package/src/_parked/interactive-spawn.ts +701 -0
  8. package/src/agent-defs.test.ts +1504 -0
  9. package/src/agent-defs.ts +1702 -0
  10. package/src/agent-mcp-config.test.ts +115 -0
  11. package/src/agent-mcp-config.ts +115 -0
  12. package/src/agents.test.ts +360 -0
  13. package/src/agents.ts +379 -0
  14. package/src/auth.test.ts +46 -0
  15. package/src/auth.ts +140 -0
  16. package/src/backends/attached-queue.test.ts +376 -0
  17. package/src/backends/attached-queue.ts +372 -0
  18. package/src/backends/programmatic.test.ts +1715 -0
  19. package/src/backends/programmatic.ts +927 -0
  20. package/src/backends/registry.test.ts +1494 -0
  21. package/src/backends/registry.ts +1202 -0
  22. package/src/backends/stream-json.test.ts +570 -0
  23. package/src/backends/stream-json.ts +392 -0
  24. package/src/backends/types.ts +223 -0
  25. package/src/bridge.ts +417 -0
  26. package/src/channel-backend-wiring.test.ts +237 -0
  27. package/src/credentials.test.ts +274 -0
  28. package/src/credentials.ts +380 -0
  29. package/src/cron.test.ts +342 -0
  30. package/src/cron.ts +380 -0
  31. package/src/daemon-agent-def-api.test.ts +166 -0
  32. package/src/daemon-agent-defs-api.test.ts +953 -0
  33. package/src/daemon-agent-env-api.test.ts +338 -0
  34. package/src/daemon-attached-queue-store.test.ts +65 -0
  35. package/src/daemon-config-api.test.ts +962 -0
  36. package/src/daemon-jobs-api.test.ts +271 -0
  37. package/src/daemon-vault-chat.test.ts +250 -0
  38. package/src/daemon.test.ts +746 -0
  39. package/src/daemon.ts +3314 -0
  40. package/src/def-vaults.test.ts +136 -0
  41. package/src/def-vaults.ts +165 -0
  42. package/src/delivery-state.test.ts +110 -0
  43. package/src/delivery-state.ts +154 -0
  44. package/src/effective-env.test.ts +114 -0
  45. package/src/effective-env.ts +184 -0
  46. package/src/env-compat.ts +39 -0
  47. package/src/grants.test.ts +638 -0
  48. package/src/grants.ts +675 -0
  49. package/src/hub-jwt.test.ts +161 -0
  50. package/src/hub-jwt.ts +182 -0
  51. package/src/jobs.test.ts +245 -0
  52. package/src/jobs.ts +266 -0
  53. package/src/mcp-http.test.ts +265 -0
  54. package/src/mcp-http.ts +771 -0
  55. package/src/mint-token.test.ts +152 -0
  56. package/src/mint-token.ts +139 -0
  57. package/src/module-manifest.test.ts +158 -0
  58. package/src/oauth-discovery.ts +134 -0
  59. package/src/programmatic-wiring.test.ts +838 -0
  60. package/src/registry.test.ts +227 -0
  61. package/src/registry.ts +228 -0
  62. package/src/resolve-port.test.ts +64 -0
  63. package/src/routing.test.ts +184 -0
  64. package/src/routing.ts +76 -0
  65. package/src/runner.test.ts +506 -0
  66. package/src/runner.ts +255 -0
  67. package/src/sandbox/config.test.ts +150 -0
  68. package/src/sandbox/config.ts +102 -0
  69. package/src/sandbox/egress.test.ts +113 -0
  70. package/src/sandbox/egress.ts +123 -0
  71. package/src/sandbox/index.ts +180 -0
  72. package/src/sandbox/live-seatbelt.test.ts +277 -0
  73. package/src/sandbox/mounts.test.ts +154 -0
  74. package/src/sandbox/mounts.ts +133 -0
  75. package/src/sandbox/sandbox.test.ts +168 -0
  76. package/src/sandbox/types.ts +382 -0
  77. package/src/services-manifest.test.ts +106 -0
  78. package/src/services-manifest.ts +95 -0
  79. package/src/spa-serve.test.ts +116 -0
  80. package/src/spa-serve.ts +116 -0
  81. package/src/spawn-agent-cli.test.ts +172 -0
  82. package/src/spawn-agent.test.ts +1218 -0
  83. package/src/spawn-agent.ts +569 -0
  84. package/src/spawn-deps.test.ts +54 -0
  85. package/src/spawn-deps.ts +166 -0
  86. package/src/telegram/api.ts +153 -0
  87. package/src/terminal-assets.test.ts +50 -0
  88. package/src/terminal-assets.ts +79 -0
  89. package/src/terminal-ui.ts +305 -0
  90. package/src/terminal.test.ts +530 -0
  91. package/src/terminal.ts +458 -0
  92. package/src/transport.ts +270 -0
  93. package/src/transports/http-ui.test.ts +455 -0
  94. package/src/transports/http-ui.ts +201 -0
  95. package/src/transports/telegram.test.ts +174 -0
  96. package/src/transports/telegram.ts +426 -0
  97. package/src/transports/vault.test.ts +2011 -0
  98. package/src/transports/vault.ts +1790 -0
  99. package/src/ui-kit.test.ts +178 -0
  100. package/src/ui-kit.ts +402 -0
  101. package/tsconfig.json +8 -14
  102. package/web/ui/tsconfig.json +2 -1
  103. package/.claude/scheduled_tasks.lock +0 -1
  104. package/.claude/settings.json +0 -5
  105. package/.claude/skills/add-atomic-chat-tool/SKILL.md +0 -243
  106. package/.claude/skills/add-atomic-chat-tool/atomic-chat-mcp-stdio.ts +0 -229
  107. package/.claude/skills/add-codex/SKILL.md +0 -161
  108. package/.claude/skills/add-dashboard/SKILL.md +0 -138
  109. package/.claude/skills/add-dashboard/resources/dashboard-pusher.ts +0 -495
  110. package/.claude/skills/add-emacs/SKILL.md +0 -296
  111. package/.claude/skills/add-gcal-tool/SKILL.md +0 -210
  112. package/.claude/skills/add-gchat/REMOVE.md +0 -6
  113. package/.claude/skills/add-gchat/SKILL.md +0 -92
  114. package/.claude/skills/add-gchat/VERIFY.md +0 -3
  115. package/.claude/skills/add-github/REMOVE.md +0 -6
  116. package/.claude/skills/add-github/SKILL.md +0 -148
  117. package/.claude/skills/add-github/VERIFY.md +0 -3
  118. package/.claude/skills/add-gmail-tool/SKILL.md +0 -229
  119. package/.claude/skills/add-imessage/REMOVE.md +0 -6
  120. package/.claude/skills/add-imessage/SKILL.md +0 -113
  121. package/.claude/skills/add-imessage/VERIFY.md +0 -3
  122. package/.claude/skills/add-karpathy-llm-wiki/SKILL.md +0 -110
  123. package/.claude/skills/add-karpathy-llm-wiki/llm-wiki.md +0 -75
  124. package/.claude/skills/add-linear/REMOVE.md +0 -6
  125. package/.claude/skills/add-linear/SKILL.md +0 -168
  126. package/.claude/skills/add-linear/VERIFY.md +0 -3
  127. package/.claude/skills/add-macos-statusbar/SKILL.md +0 -133
  128. package/.claude/skills/add-macos-statusbar/add/src/statusbar.swift +0 -147
  129. package/.claude/skills/add-matrix/REMOVE.md +0 -6
  130. package/.claude/skills/add-matrix/SKILL.md +0 -148
  131. package/.claude/skills/add-matrix/VERIFY.md +0 -3
  132. package/.claude/skills/add-ollama-provider/SKILL.md +0 -179
  133. package/.claude/skills/add-ollama-tool/SKILL.md +0 -193
  134. package/.claude/skills/add-opencode/SKILL.md +0 -229
  135. package/.claude/skills/add-parallel/SKILL.md +0 -290
  136. package/.claude/skills/add-resend/REMOVE.md +0 -6
  137. package/.claude/skills/add-resend/SKILL.md +0 -93
  138. package/.claude/skills/add-resend/VERIFY.md +0 -3
  139. package/.claude/skills/add-signal/REMOVE.md +0 -13
  140. package/.claude/skills/add-signal/SKILL.md +0 -318
  141. package/.claude/skills/add-signal/VERIFY.md +0 -5
  142. package/.claude/skills/add-slack/REMOVE.md +0 -6
  143. package/.claude/skills/add-slack/SKILL.md +0 -112
  144. package/.claude/skills/add-slack/VERIFY.md +0 -3
  145. package/.claude/skills/add-teams/REMOVE.md +0 -6
  146. package/.claude/skills/add-teams/SKILL.md +0 -207
  147. package/.claude/skills/add-teams/VERIFY.md +0 -3
  148. package/.claude/skills/add-vercel/SKILL.md +0 -147
  149. package/.claude/skills/add-vercel/container-skills/vercel-cli/SKILL.md +0 -103
  150. package/.claude/skills/add-webex/REMOVE.md +0 -6
  151. package/.claude/skills/add-webex/SKILL.md +0 -88
  152. package/.claude/skills/add-webex/VERIFY.md +0 -3
  153. package/.claude/skills/add-wechat/REMOVE.md +0 -49
  154. package/.claude/skills/add-wechat/SKILL.md +0 -170
  155. package/.claude/skills/add-wechat/scripts/wire-dm.ts +0 -172
  156. package/.claude/skills/add-whatsapp/SKILL.md +0 -264
  157. package/.claude/skills/add-whatsapp-cloud/REMOVE.md +0 -6
  158. package/.claude/skills/add-whatsapp-cloud/SKILL.md +0 -95
  159. package/.claude/skills/add-whatsapp-cloud/VERIFY.md +0 -3
  160. package/.claude/skills/claw/SKILL.md +0 -131
  161. package/.claude/skills/claw/scripts/claw +0 -374
  162. package/.claude/skills/convert-to-apple-container/SKILL.md +0 -212
  163. package/.claude/skills/customize/SKILL.md +0 -110
  164. package/.claude/skills/debug/SKILL.md +0 -349
  165. package/.claude/skills/get-qodo-rules/SKILL.md +0 -122
  166. package/.claude/skills/get-qodo-rules/references/output-format.md +0 -41
  167. package/.claude/skills/get-qodo-rules/references/pagination.md +0 -33
  168. package/.claude/skills/get-qodo-rules/references/repository-scope.md +0 -26
  169. package/.claude/skills/init-first-agent/SKILL.md +0 -120
  170. package/.claude/skills/init-onecli/SKILL.md +0 -270
  171. package/.claude/skills/manage-channels/SKILL.md +0 -87
  172. package/.claude/skills/manage-mounts/SKILL.md +0 -47
  173. package/.claude/skills/migrate-from-openclaw/MIGRATE_CRONS.md +0 -100
  174. package/.claude/skills/migrate-from-openclaw/SKILL.md +0 -447
  175. package/.claude/skills/migrate-from-openclaw/scripts/discover-openclaw.ts +0 -734
  176. package/.claude/skills/migrate-from-openclaw/scripts/extract-channel-credentials.ts +0 -476
  177. package/.claude/skills/migrate-nanoclaw/SKILL.md +0 -484
  178. package/.claude/skills/migrate-nanoclaw/diagnostics.md +0 -51
  179. package/.claude/skills/qodo-pr-resolver/SKILL.md +0 -326
  180. package/.claude/skills/qodo-pr-resolver/resources/providers.md +0 -329
  181. package/.claude/skills/update-nanoclaw/SKILL.md +0 -243
  182. package/.claude/skills/update-nanoclaw/diagnostics.md +0 -48
  183. package/.claude/skills/update-skills/SKILL.md +0 -130
  184. package/.claude/skills/use-native-credential-proxy/SKILL.md +0 -167
  185. package/.claude/skills/x-integration/SKILL.md +0 -417
  186. package/.claude/skills/x-integration/agent.ts +0 -243
  187. package/.claude/skills/x-integration/host.ts +0 -155
  188. package/.claude/skills/x-integration/lib/browser.ts +0 -148
  189. package/.claude/skills/x-integration/lib/config.ts +0 -62
  190. package/.claude/skills/x-integration/scripts/like.ts +0 -56
  191. package/.claude/skills/x-integration/scripts/post.ts +0 -66
  192. package/.claude/skills/x-integration/scripts/quote.ts +0 -80
  193. package/.claude/skills/x-integration/scripts/reply.ts +0 -74
  194. package/.claude/skills/x-integration/scripts/retweet.ts +0 -62
  195. package/.claude/skills/x-integration/scripts/setup.ts +0 -87
  196. package/.github/CODEOWNERS +0 -10
  197. package/.github/PULL_REQUEST_TEMPLATE.md +0 -18
  198. package/.github/workflows/bump-version.yml +0 -35
  199. package/.github/workflows/ci.yml +0 -39
  200. package/.github/workflows/label-pr.yml +0 -40
  201. package/.github/workflows/update-tokens.yml +0 -43
  202. package/.husky/pre-commit +0 -1
  203. package/.mcp.json +0 -3
  204. package/.nvmrc +0 -1
  205. package/.prettierrc +0 -4
  206. package/CHANGELOG.md +0 -221
  207. package/CLAUDE.md +0 -307
  208. package/CODE_OF_CONDUCT.md +0 -128
  209. package/CONTRIBUTING.md +0 -159
  210. package/CONTRIBUTORS.md +0 -26
  211. package/LICENSE-NANOCLAW-MIT +0 -21
  212. package/README_ja.md +0 -194
  213. package/README_zh.md +0 -194
  214. package/assets/nanoclaw-favicon.png +0 -0
  215. package/assets/nanoclaw-icon.png +0 -0
  216. package/assets/nanoclaw-logo-dark.png +0 -0
  217. package/assets/nanoclaw-logo.png +0 -0
  218. package/assets/nanoclaw-profile.jpeg +0 -0
  219. package/assets/nanoclaw-sales.png +0 -0
  220. package/assets/social-preview.jpg +0 -0
  221. package/config-examples/mount-allowlist.json +0 -25
  222. package/container/.dockerignore +0 -2
  223. package/container/CLAUDE.md +0 -21
  224. package/container/Dockerfile +0 -121
  225. package/container/agent-runner/bun.lock +0 -243
  226. package/container/agent-runner/package.json +0 -22
  227. package/container/agent-runner/scripts/sdk-signal-probe.ts +0 -169
  228. package/container/agent-runner/src/config.ts +0 -55
  229. package/container/agent-runner/src/db/connection.ts +0 -267
  230. package/container/agent-runner/src/db/index.ts +0 -20
  231. package/container/agent-runner/src/db/messages-in.ts +0 -138
  232. package/container/agent-runner/src/db/messages-out.ts +0 -143
  233. package/container/agent-runner/src/db/session-routing.ts +0 -30
  234. package/container/agent-runner/src/db/session-state.test.ts +0 -100
  235. package/container/agent-runner/src/db/session-state.ts +0 -79
  236. package/container/agent-runner/src/destinations.ts +0 -135
  237. package/container/agent-runner/src/formatter.test.ts +0 -167
  238. package/container/agent-runner/src/formatter.ts +0 -260
  239. package/container/agent-runner/src/index.ts +0 -110
  240. package/container/agent-runner/src/integration.test.ts +0 -121
  241. package/container/agent-runner/src/mcp-tools/agents.instructions.md +0 -26
  242. package/container/agent-runner/src/mcp-tools/agents.ts +0 -66
  243. package/container/agent-runner/src/mcp-tools/core.instructions.md +0 -27
  244. package/container/agent-runner/src/mcp-tools/core.ts +0 -262
  245. package/container/agent-runner/src/mcp-tools/index.ts +0 -22
  246. package/container/agent-runner/src/mcp-tools/interactive.instructions.md +0 -22
  247. package/container/agent-runner/src/mcp-tools/interactive.ts +0 -169
  248. package/container/agent-runner/src/mcp-tools/scheduling.instructions.md +0 -40
  249. package/container/agent-runner/src/mcp-tools/scheduling.ts +0 -299
  250. package/container/agent-runner/src/mcp-tools/self-mod.instructions.md +0 -25
  251. package/container/agent-runner/src/mcp-tools/self-mod.ts +0 -120
  252. package/container/agent-runner/src/mcp-tools/server.ts +0 -54
  253. package/container/agent-runner/src/mcp-tools/types.ts +0 -6
  254. package/container/agent-runner/src/poll-loop.test.ts +0 -248
  255. package/container/agent-runner/src/poll-loop.ts +0 -437
  256. package/container/agent-runner/src/providers/claude.ts +0 -379
  257. package/container/agent-runner/src/providers/factory.test.ts +0 -19
  258. package/container/agent-runner/src/providers/factory.ts +0 -13
  259. package/container/agent-runner/src/providers/index.ts +0 -6
  260. package/container/agent-runner/src/providers/mock.ts +0 -77
  261. package/container/agent-runner/src/providers/provider-registry.ts +0 -33
  262. package/container/agent-runner/src/providers/types.ts +0 -82
  263. package/container/agent-runner/src/scheduling/task-script.ts +0 -121
  264. package/container/agent-runner/src/timezone.test.ts +0 -93
  265. package/container/agent-runner/src/timezone.ts +0 -107
  266. package/container/agent-runner/tsconfig.json +0 -14
  267. package/container/build.sh +0 -48
  268. package/container/entrypoint.sh +0 -16
  269. package/container/skills/agent-browser/SKILL.md +0 -159
  270. package/container/skills/frontend-engineer/SKILL.md +0 -157
  271. package/container/skills/self-customize/SKILL.md +0 -87
  272. package/container/skills/slack-formatting/SKILL.md +0 -94
  273. package/container/skills/vercel-cli/SKILL.md +0 -111
  274. package/container/skills/welcome/SKILL.md +0 -85
  275. package/docs/APPLE-CONTAINER-NETWORKING.md +0 -90
  276. package/docs/BRANCH-FORK-MAINTENANCE.md +0 -81
  277. package/docs/README.md +0 -25
  278. package/docs/SDK_DEEP_DIVE.md +0 -643
  279. package/docs/SECURITY.md +0 -162
  280. package/docs/agent-runner-details.md +0 -749
  281. package/docs/api-details.md +0 -365
  282. package/docs/architecture-diagram.html +0 -422
  283. package/docs/architecture-diagram.md +0 -215
  284. package/docs/architecture.md +0 -751
  285. package/docs/audit/2026-04-30-channel-endpoint-audit.md +0 -36
  286. package/docs/build-and-runtime.md +0 -80
  287. package/docs/cross-mount-stress/README.md +0 -112
  288. package/docs/cross-mount-stress/container-writer-retry.mjs +0 -55
  289. package/docs/cross-mount-stress/container-writer-slow.mjs +0 -42
  290. package/docs/cross-mount-stress/container-writer.mjs +0 -47
  291. package/docs/cross-mount-stress/host-writer-retry.mjs +0 -55
  292. package/docs/cross-mount-stress/host-writer-slow.mjs +0 -43
  293. package/docs/cross-mount-stress/host-writer.mjs +0 -47
  294. package/docs/db-central.md +0 -316
  295. package/docs/db-session.md +0 -183
  296. package/docs/db.md +0 -119
  297. package/docs/design/2026-04-29-vault-management-ui.md +0 -231
  298. package/docs/design/2026-04-30-channel-wiring-rework.md +0 -234
  299. package/docs/design/2026-05-01-channel-wiring-approvals-deep-dive.md +0 -272
  300. package/docs/design/2026-05-02-channel-policy-and-approval-routing.md +0 -250
  301. package/docs/docker-sandboxes.md +0 -359
  302. package/docs/isolation-model.md +0 -88
  303. package/docs/ollama.md +0 -79
  304. package/docs/parachute-integration.md +0 -109
  305. package/docs/post-night-rebirth-reflections.md +0 -151
  306. package/eslint.config.js +0 -32
  307. package/pnpm-workspace.yaml +0 -8
  308. package/repo-tokens/README.md +0 -113
  309. package/repo-tokens/action.yml +0 -186
  310. package/repo-tokens/badge.svg +0 -23
  311. package/repo-tokens/examples/green.svg +0 -14
  312. package/repo-tokens/examples/red.svg +0 -14
  313. package/repo-tokens/examples/yellow-green.svg +0 -14
  314. package/repo-tokens/examples/yellow.svg +0 -14
  315. package/scripts/chat.ts +0 -101
  316. package/scripts/cleanup-sessions.sh +0 -150
  317. package/scripts/init-cli-agent.ts +0 -171
  318. package/scripts/init-first-agent.ts +0 -377
  319. package/scripts/parachute.ts +0 -158
  320. package/scripts/run-migrations.ts +0 -105
  321. package/scripts/sanity-live-poll.ts +0 -95
  322. package/scripts/seed-discord.ts +0 -79
  323. package/scripts/test-v2-agent.ts +0 -106
  324. package/scripts/test-v2-channel-e2e.ts +0 -265
  325. package/scripts/test-v2-host.ts +0 -184
  326. package/src/channels/adapter.ts +0 -214
  327. package/src/channels/ask-question.ts +0 -46
  328. package/src/channels/channel-registry.test.ts +0 -421
  329. package/src/channels/channel-registry.ts +0 -313
  330. package/src/channels/chat-sdk-bridge.test.ts +0 -84
  331. package/src/channels/chat-sdk-bridge.ts +0 -652
  332. package/src/channels/cli.ts +0 -276
  333. package/src/channels/discord.ts +0 -90
  334. package/src/channels/index.ts +0 -17
  335. package/src/channels/telegram-markdown-sanitize.test.ts +0 -78
  336. package/src/channels/telegram-markdown-sanitize.ts +0 -55
  337. package/src/channels/telegram-pairing.test.ts +0 -254
  338. package/src/channels/telegram-pairing.ts +0 -339
  339. package/src/channels/telegram.ts +0 -279
  340. package/src/channels/trust-hint.test.ts +0 -48
  341. package/src/channels/trust-hint.ts +0 -75
  342. package/src/claude-md-compose.migrate.test.ts +0 -64
  343. package/src/claude-md-compose.ts +0 -205
  344. package/src/command-gate.ts +0 -63
  345. package/src/config.test.ts +0 -93
  346. package/src/config.ts +0 -108
  347. package/src/container-config.ts +0 -167
  348. package/src/container-runner.test.ts +0 -32
  349. package/src/container-runner.ts +0 -576
  350. package/src/container-runtime.test.ts +0 -169
  351. package/src/container-runtime.ts +0 -92
  352. package/src/db/_bun-sqlite-shim.ts +0 -88
  353. package/src/db/agent-activity.test.ts +0 -155
  354. package/src/db/agent-activity.ts +0 -121
  355. package/src/db/agent-groups.ts +0 -77
  356. package/src/db/connection.migrate.test.ts +0 -143
  357. package/src/db/connection.ts +0 -224
  358. package/src/db/db-v2.test.ts +0 -440
  359. package/src/db/dropped-messages.ts +0 -44
  360. package/src/db/index.ts +0 -40
  361. package/src/db/messaging-groups.ts +0 -252
  362. package/src/db/migrations/001-initial.ts +0 -112
  363. package/src/db/migrations/002-chat-sdk-state.ts +0 -36
  364. package/src/db/migrations/008-dropped-messages.ts +0 -27
  365. package/src/db/migrations/009-drop-pending-credentials.ts +0 -13
  366. package/src/db/migrations/010-engage-modes.ts +0 -103
  367. package/src/db/migrations/011-pending-sender-approvals.ts +0 -40
  368. package/src/db/migrations/012-channel-registration.ts +0 -48
  369. package/src/db/migrations/013-approval-render-metadata.ts +0 -27
  370. package/src/db/migrations/014-secrets.ts +0 -44
  371. package/src/db/migrations/015-secrets-drop-host-pattern.ts +0 -18
  372. package/src/db/migrations/016-secret-assignments.ts +0 -30
  373. package/src/db/migrations/017-agent-activity.ts +0 -40
  374. package/src/db/migrations/018-oauth-app-configs.ts +0 -34
  375. package/src/db/migrations/019-oauth-app-connections.ts +0 -48
  376. package/src/db/migrations/020-agent-app-connections.ts +0 -28
  377. package/src/db/migrations/021-pending-oauth-states.ts +0 -35
  378. package/src/db/migrations/022-app-connections-provider.ts +0 -25
  379. package/src/db/migrations/023-agent-group-secret-mode.test.ts +0 -124
  380. package/src/db/migrations/023-agent-group-secret-mode.ts +0 -65
  381. package/src/db/migrations/024-collapse-approvals.test.ts +0 -249
  382. package/src/db/migrations/024-collapse-approvals.ts +0 -182
  383. package/src/db/migrations/025-secret-mode-check.test.ts +0 -155
  384. package/src/db/migrations/025-secret-mode-check.ts +0 -49
  385. package/src/db/migrations/026-user-dms-bot-id.test.ts +0 -116
  386. package/src/db/migrations/026-user-dms-bot-id.ts +0 -54
  387. package/src/db/migrations/027-provider-credentials.ts +0 -41
  388. package/src/db/migrations/_test-helpers.ts +0 -41
  389. package/src/db/migrations/index.ts +0 -127
  390. package/src/db/migrations/module-agent-to-agent-destinations.ts +0 -84
  391. package/src/db/migrations/module-approvals-pending-approvals.ts +0 -42
  392. package/src/db/migrations/module-approvals-title-options.ts +0 -40
  393. package/src/db/schema.ts +0 -258
  394. package/src/db/session-db.test.ts +0 -93
  395. package/src/db/session-db.ts +0 -325
  396. package/src/db/sessions.ts +0 -241
  397. package/src/delivery.test.ts +0 -148
  398. package/src/delivery.ts +0 -445
  399. package/src/env.ts +0 -74
  400. package/src/group-folder.test.ts +0 -35
  401. package/src/group-folder.ts +0 -44
  402. package/src/group-init.ts +0 -92
  403. package/src/host-core.test.ts +0 -456
  404. package/src/host-sweep.test.ts +0 -146
  405. package/src/host-sweep.ts +0 -287
  406. package/src/index.ts +0 -227
  407. package/src/install-slug.ts +0 -33
  408. package/src/log.test.ts +0 -81
  409. package/src/log.ts +0 -117
  410. package/src/mcp/http.ts +0 -72
  411. package/src/mcp/server.ts +0 -92
  412. package/src/mcp/stdio.ts +0 -51
  413. package/src/mcp/tools/activity.ts +0 -88
  414. package/src/mcp/tools/agent-groups.ts +0 -183
  415. package/src/mcp/tools/approvals.ts +0 -122
  416. package/src/mcp/tools/channels.ts +0 -199
  417. package/src/mcp/tools/index.ts +0 -27
  418. package/src/mcp/tools/oauth.ts +0 -48
  419. package/src/mcp/tools/secrets.ts +0 -169
  420. package/src/mcp/tools/sessions.ts +0 -135
  421. package/src/mcp/types.ts +0 -51
  422. package/src/modules/agent-to-agent/agent-route.test.ts +0 -46
  423. package/src/modules/agent-to-agent/agent-route.ts +0 -223
  424. package/src/modules/agent-to-agent/create-agent.ts +0 -127
  425. package/src/modules/agent-to-agent/db/agent-destinations.ts +0 -135
  426. package/src/modules/agent-to-agent/index.ts +0 -22
  427. package/src/modules/agent-to-agent/write-destinations.ts +0 -59
  428. package/src/modules/approvals/agent.md +0 -45
  429. package/src/modules/approvals/index.ts +0 -21
  430. package/src/modules/approvals/picks.test.ts +0 -291
  431. package/src/modules/approvals/primitive.ts +0 -279
  432. package/src/modules/approvals/project.md +0 -27
  433. package/src/modules/approvals/response-handler.ts +0 -87
  434. package/src/modules/index.ts +0 -24
  435. package/src/modules/interactive/agent.md +0 -21
  436. package/src/modules/interactive/index.ts +0 -69
  437. package/src/modules/interactive/project.md +0 -12
  438. package/src/modules/mount-security/index.ts +0 -448
  439. package/src/modules/mount-security/migrate.test.ts +0 -91
  440. package/src/modules/permissions/access.ts +0 -28
  441. package/src/modules/permissions/channel-approval.test.ts +0 -389
  442. package/src/modules/permissions/channel-approval.ts +0 -188
  443. package/src/modules/permissions/db/agent-group-members.ts +0 -44
  444. package/src/modules/permissions/db/pending-channel-approvals.test.ts +0 -86
  445. package/src/modules/permissions/db/pending-channel-approvals.ts +0 -66
  446. package/src/modules/permissions/db/pending-sender-approvals.ts +0 -60
  447. package/src/modules/permissions/db/user-dms.ts +0 -58
  448. package/src/modules/permissions/db/user-roles.ts +0 -85
  449. package/src/modules/permissions/db/users.ts +0 -38
  450. package/src/modules/permissions/index.ts +0 -421
  451. package/src/modules/permissions/permissions.test.ts +0 -358
  452. package/src/modules/permissions/sender-approval.test.ts +0 -470
  453. package/src/modules/permissions/sender-approval.ts +0 -165
  454. package/src/modules/permissions/user-dm.ts +0 -200
  455. package/src/modules/provider-credentials/db.ts +0 -121
  456. package/src/modules/provider-credentials/index.ts +0 -12
  457. package/src/modules/provider-credentials/spawn.test.ts +0 -206
  458. package/src/modules/provider-credentials/spawn.ts +0 -114
  459. package/src/modules/scheduling/actions.ts +0 -113
  460. package/src/modules/scheduling/db.test.ts +0 -282
  461. package/src/modules/scheduling/db.ts +0 -148
  462. package/src/modules/scheduling/index.ts +0 -34
  463. package/src/modules/scheduling/recurrence.test.ts +0 -98
  464. package/src/modules/scheduling/recurrence.ts +0 -54
  465. package/src/modules/self-mod/agent.md +0 -30
  466. package/src/modules/self-mod/apply.ts +0 -85
  467. package/src/modules/self-mod/index.ts +0 -30
  468. package/src/modules/self-mod/project.md +0 -39
  469. package/src/modules/self-mod/request.ts +0 -91
  470. package/src/modules/typing/index.ts +0 -165
  471. package/src/oauth/agent-app-connections.ts +0 -103
  472. package/src/oauth/app-configs.test.ts +0 -64
  473. package/src/oauth/app-configs.ts +0 -114
  474. package/src/oauth/app-connections.test.ts +0 -109
  475. package/src/oauth/app-connections.ts +0 -178
  476. package/src/oauth/crypto.ts +0 -56
  477. package/src/oauth/flow.ts +0 -104
  478. package/src/oauth/providers/google.test.ts +0 -38
  479. package/src/oauth/providers/google.ts +0 -46
  480. package/src/oauth/providers/index.ts +0 -48
  481. package/src/oauth/state-store.test.ts +0 -54
  482. package/src/oauth/state-store.ts +0 -93
  483. package/src/parachute/README.md +0 -27
  484. package/src/parachute/create-agent.test.ts +0 -83
  485. package/src/parachute/create-agent.ts +0 -122
  486. package/src/parachute/group-status.test.ts +0 -165
  487. package/src/parachute/group-status.ts +0 -136
  488. package/src/parachute/types.ts +0 -41
  489. package/src/parachute/vault-mcp.test.ts +0 -251
  490. package/src/parachute/vault-mcp.ts +0 -232
  491. package/src/platform-id.test.ts +0 -104
  492. package/src/platform-id.ts +0 -109
  493. package/src/providers/index.ts +0 -6
  494. package/src/providers/provider-container-registry.ts +0 -58
  495. package/src/response-registry.ts +0 -45
  496. package/src/router.ts +0 -530
  497. package/src/secrets/crypto.test.ts +0 -45
  498. package/src/secrets/crypto.ts +0 -55
  499. package/src/secrets/index.ts +0 -355
  500. package/src/secrets/master-key.ts +0 -70
  501. package/src/secrets/secrets.test.ts +0 -354
  502. package/src/session-manager.migrate.test.ts +0 -59
  503. package/src/session-manager.ts +0 -433
  504. package/src/startup-bootstrap.test.ts +0 -226
  505. package/src/startup-bootstrap.ts +0 -207
  506. package/src/state-sqlite.ts +0 -182
  507. package/src/timezone.test.ts +0 -64
  508. package/src/timezone.ts +0 -37
  509. package/src/types.ts +0 -230
  510. package/src/web/auth.test.ts +0 -335
  511. package/src/web/auth.ts +0 -214
  512. package/src/web/discord-validate.test.ts +0 -77
  513. package/src/web/discord-validate.ts +0 -88
  514. package/src/web/hub-discovery.test.ts +0 -98
  515. package/src/web/hub-discovery.ts +0 -69
  516. package/src/web/routes/activity.ts +0 -106
  517. package/src/web/routes/agent-provider.test.ts +0 -282
  518. package/src/web/routes/agent-provider.ts +0 -309
  519. package/src/web/routes/approvals.ts +0 -185
  520. package/src/web/routes/apps.ts +0 -434
  521. package/src/web/routes/channels-mg-detail.test.ts +0 -324
  522. package/src/web/routes/channels-mga-detail.test.ts +0 -425
  523. package/src/web/routes/channels.ts +0 -489
  524. package/src/web/routes/oauth-providers.ts +0 -42
  525. package/src/web/routes/secrets.test.ts +0 -175
  526. package/src/web/routes/secrets.ts +0 -282
  527. package/src/web/routes/sessions.ts +0 -123
  528. package/src/web/routes/settings.test.ts +0 -106
  529. package/src/web/routes/settings.ts +0 -247
  530. package/src/web/routes/setup-status.ts +0 -205
  531. package/src/web/routes/vaults.test.ts +0 -389
  532. package/src/web/routes/vaults.ts +0 -225
  533. package/src/web/server-version.test.ts +0 -16
  534. package/src/web/server.ts +0 -1003
  535. package/src/web/services-manifest.test.ts +0 -120
  536. package/src/web/services-manifest.ts +0 -61
  537. package/src/web/static-serve.test.ts +0 -255
  538. package/src/web/static-serve.ts +0 -104
  539. package/src/web/telegram-validate.test.ts +0 -116
  540. package/src/web/telegram-validate.ts +0 -107
  541. package/src/web/vault-proxy.test.ts +0 -214
  542. package/src/web/vault-proxy.ts +0 -120
  543. package/src/web/wire-channel.ts +0 -181
  544. package/src/webhook-server.ts +0 -134
  545. package/vitest.config.ts +0 -18
  546. package/web/README.md +0 -63
  547. package/web/ui/index.html +0 -13
  548. package/web/ui/package.json +0 -35
  549. package/web/ui/pnpm-lock.yaml +0 -2164
  550. package/web/ui/scripts/verify-base.mjs +0 -31
  551. package/web/ui/src/App.tsx +0 -88
  552. package/web/ui/src/components/ActivityFeed.tsx +0 -444
  553. package/web/ui/src/components/AgentGroupPicker.tsx +0 -263
  554. package/web/ui/src/components/AgentProviderCards.tsx +0 -220
  555. package/web/ui/src/components/CredentialForm.tsx +0 -214
  556. package/web/ui/src/components/ScopeGrants.tsx +0 -74
  557. package/web/ui/src/components/StatusDot.tsx +0 -43
  558. package/web/ui/src/components/VaultPicker.tsx +0 -127
  559. package/web/ui/src/components/setup/AdapterInstallStep.tsx +0 -178
  560. package/web/ui/src/components/setup/AgentGroupStep.tsx +0 -43
  561. package/web/ui/src/components/setup/ChannelPickStep.tsx +0 -74
  562. package/web/ui/src/components/setup/DoneStep.tsx +0 -49
  563. package/web/ui/src/components/setup/PrereqStep.tsx +0 -129
  564. package/web/ui/src/components/setup/TestConnectionStep.tsx +0 -108
  565. package/web/ui/src/components/setup/TestMessageStep.tsx +0 -104
  566. package/web/ui/src/components/setup/WireChannelStep.tsx +0 -166
  567. package/web/ui/src/components/setup/types.ts +0 -105
  568. package/web/ui/src/lib/api.test.ts +0 -410
  569. package/web/ui/src/lib/api.ts +0 -1210
  570. package/web/ui/src/lib/auth.test.ts +0 -139
  571. package/web/ui/src/lib/auth.ts +0 -348
  572. package/web/ui/src/lib/channel-adapters.ts +0 -136
  573. package/web/ui/src/main.tsx +0 -19
  574. package/web/ui/src/routes/ApprovalsList.tsx +0 -294
  575. package/web/ui/src/routes/Apps.tsx +0 -613
  576. package/web/ui/src/routes/ChannelWireDetail.test.tsx +0 -233
  577. package/web/ui/src/routes/ChannelWireDetail.tsx +0 -403
  578. package/web/ui/src/routes/ChannelsList.tsx +0 -158
  579. package/web/ui/src/routes/GroupDetail.tsx +0 -755
  580. package/web/ui/src/routes/GroupList.tsx +0 -187
  581. package/web/ui/src/routes/MessagingGroupDetail.test.tsx +0 -233
  582. package/web/ui/src/routes/MessagingGroupDetail.tsx +0 -306
  583. package/web/ui/src/routes/NewGroupWizard.tsx +0 -390
  584. package/web/ui/src/routes/OAuthCallback.tsx +0 -56
  585. package/web/ui/src/routes/SecretsList.tsx +0 -921
  586. package/web/ui/src/routes/SessionsList.tsx +0 -220
  587. package/web/ui/src/routes/SettingsAgentProvider.tsx +0 -109
  588. package/web/ui/src/routes/SettingsApprovals.tsx +0 -234
  589. package/web/ui/src/routes/SetupWizard.tsx +0 -219
  590. package/web/ui/src/routes/VaultDetail.test.tsx +0 -361
  591. package/web/ui/src/routes/VaultDetail.tsx +0 -960
  592. package/web/ui/src/routes/VaultsList.tsx +0 -295
  593. package/web/ui/src/routes/WireChannelPage.tsx +0 -413
  594. package/web/ui/src/styles.css +0 -608
  595. package/web/ui/src/test/setup.ts +0 -23
  596. package/web/ui/src/vite-env.d.ts +0 -10
  597. package/web/ui/vite.config.ts +0 -34
  598. package/web/ui/vitest.config.ts +0 -25
@@ -1,318 +0,0 @@
1
- ---
2
- name: add-signal
3
- description: Add Signal channel integration via signal-cli TCP daemon. Native adapter — no Chat SDK bridge.
4
- ---
5
-
6
- # Add Signal Channel
7
-
8
- Adds Signal messaging support via a native adapter that speaks JSON-RPC to a [signal-cli](https://github.com/AsamK/signal-cli) TCP daemon. No Chat SDK bridge — only Node.js builtins (`node:net`, `node:child_process`, `node:fs`).
9
-
10
- Unlike Telegram or Discord, Signal has no bot API. NanoClaw registers as a full Signal account on a dedicated phone number (recommended) or links as a secondary device on your existing number.
11
-
12
- ## Prerequisites
13
-
14
- ### Java
15
-
16
- signal-cli requires Java 17+:
17
-
18
- ```bash
19
- java -version
20
- ```
21
-
22
- If missing:
23
- - **macOS:** `brew install --cask temurin@17`
24
- - **Debian/Ubuntu:** `sudo apt-get install -y default-jre`
25
- - **RHEL/Fedora:** `sudo dnf install -y java-17-openjdk`
26
-
27
- Java 17–25 all work.
28
-
29
- ### signal-cli
30
-
31
- - **macOS:** `brew install signal-cli`
32
- - **Linux:** download the native binary from [GitHub releases](https://github.com/AsamK/signal-cli/releases):
33
-
34
- ```bash
35
- SIGNAL_CLI_VERSION=$(curl -fsSL https://api.github.com/repos/AsamK/signal-cli/releases/latest | python3 -c "import sys,json; print(json.load(sys.stdin)['tag_name'][1:])")
36
- curl -fsSL "https://github.com/AsamK/signal-cli/releases/download/v${SIGNAL_CLI_VERSION}/signal-cli-${SIGNAL_CLI_VERSION}-Linux-native.tar.gz" \
37
- | tar -xz -C ~/.local
38
- ln -sf ~/.local/signal-cli ~/.local/bin/signal-cli
39
- signal-cli --version
40
- ```
41
-
42
- > The Linux native tarball extracts a single binary directly to `~/.local/signal-cli` (not into a subdirectory). The symlink above puts it on PATH.
43
-
44
- ## Registration
45
-
46
- Two paths. The new-number path is recommended and battle-tested.
47
-
48
- ### Path A: Register a new number (recommended)
49
-
50
- Use a dedicated SIM or VoIP number. NanoClaw owns it entirely.
51
-
52
- > **VoIP numbers:** Signal requires SMS verification before voice. Some VoIP providers are blocked even for voice calls. If registration fails with an auth error, try a different provider or a physical SIM.
53
-
54
- **Step 1: Solve the CAPTCHA**
55
-
56
- Signal requires a CAPTCHA on first registration:
57
-
58
- 1. Open `https://signalcaptchas.org/registration/generate.html` in a browser
59
- 2. Solve the captcha
60
- 3. Right-click the **"Open Signal"** button → **Copy Link**
61
- 4. The link starts with `signalcaptcha://` — the token is everything after that prefix
62
-
63
- **Step 2: Request SMS verification**
64
-
65
- ```bash
66
- signal-cli -a +1YOURNUMBER register --captcha "PASTE_TOKEN_HERE"
67
- ```
68
-
69
- **Step 3: Voice call fallback (if your number can't receive SMS)**
70
-
71
- Wait ~60 seconds after the SMS request, then:
72
-
73
- ```bash
74
- signal-cli -a +1YOURNUMBER register --voice --captcha "SAME_TOKEN"
75
- ```
76
-
77
- Signal calls your number and reads a 6-digit code. The same captcha token is reusable — no need to solve a new one.
78
-
79
- > You must request SMS first. Requesting voice immediately fails with `Invalid verification method: Before requesting voice verification…`
80
-
81
- **Step 4: Verify**
82
-
83
- ```bash
84
- signal-cli -a +1YOURNUMBER verify CODE
85
- ```
86
-
87
- No output = success.
88
-
89
- **Step 5: Set profile name (optional)**
90
-
91
- > ⚠ Stop NanoClaw before running signal-cli commands — the daemon holds an exclusive lock on its data directory while running.
92
-
93
- ```bash
94
- # macOS
95
- launchctl unload ~/Library/LaunchAgents/com.nanoclaw.plist
96
- signal-cli -a +1YOURNUMBER updateProfile --name "YourBotName"
97
- # optionally: --avatar /path/to/avatar.jpg
98
- launchctl load ~/Library/LaunchAgents/com.nanoclaw.plist
99
-
100
- # Linux
101
- systemctl --user stop nanoclaw
102
- signal-cli -a +1YOURNUMBER updateProfile --name "YourBotName"
103
- systemctl --user start nanoclaw
104
- ```
105
-
106
- ### Path B: Link as secondary device
107
-
108
- Joins an existing Signal account as a secondary device. Simpler, but NanoClaw shares your personal number.
109
-
110
- ```bash
111
- signal-cli -a +1YOURNUMBER link --name "NanoClaw"
112
- ```
113
-
114
- This prints a `tsdevice:` URI. Scan it as a QR code on your phone: **Settings → Linked Devices → Link New Device**. QR codes expire in ~30 seconds — re-run if it expires.
115
-
116
- ## Install
117
-
118
- ### Pre-flight (idempotent)
119
-
120
- Skip to **Credentials** if all of these are already in place:
121
-
122
- - `src/channels/signal.ts` and `src/channels/signal.test.ts` both exist
123
- - `src/channels/index.ts` contains `import './signal.js';`
124
-
125
- Otherwise continue. Every step below is safe to re-run.
126
-
127
- ### 1. Fetch the channels branch
128
-
129
- ```bash
130
- git fetch origin channels
131
- ```
132
-
133
- ### 2. Copy the adapter and tests
134
-
135
- ```bash
136
- git show origin/channels:src/channels/signal.ts > src/channels/signal.ts
137
- git show origin/channels:src/channels/signal.test.ts > src/channels/signal.test.ts
138
- ```
139
-
140
- ### 3. Append the self-registration import
141
-
142
- Append to `src/channels/index.ts` (skip if the line is already present):
143
-
144
- ```typescript
145
- import './signal.js';
146
- ```
147
-
148
- ### 4. Build
149
-
150
- ```bash
151
- pnpm run build
152
- ```
153
-
154
- No npm packages to install — the adapter uses only Node.js builtins.
155
-
156
- ## Credentials
157
-
158
- Add to `.env`:
159
-
160
- ```bash
161
- SIGNAL_ACCOUNT=+1YOURNUMBER
162
- ```
163
-
164
- ### Optional settings
165
-
166
- ```bash
167
- # TCP daemon host and port (default: 127.0.0.1:7583)
168
- SIGNAL_TCP_HOST=127.0.0.1
169
- SIGNAL_TCP_PORT=7583
170
-
171
- # Path to the signal-cli binary (default: resolved on PATH)
172
- SIGNAL_CLI_PATH=/usr/local/bin/signal-cli
173
-
174
- # Whether NanoClaw manages the daemon lifecycle (default: true).
175
- # Set to false if you run signal-cli daemon externally.
176
- SIGNAL_MANAGE_DAEMON=true
177
-
178
- # signal-cli data directory (default: ~/.local/share/signal-cli)
179
- SIGNAL_DATA_DIR=~/.local/share/signal-cli
180
- ```
181
-
182
- **Security note:** keep the TCP host on `127.0.0.1`. The daemon has no auth — binding it to a public interface would expose your full Signal account to the network.
183
-
184
- Sync to container: `mkdir -p data/env && cp .env data/env/env`
185
-
186
- ### Restart
187
-
188
- ```bash
189
- # macOS
190
- launchctl kickstart -k gui/$(id -u)/com.nanoclaw
191
-
192
- # Linux
193
- systemctl --user restart nanoclaw
194
- ```
195
-
196
- ## Wiring
197
-
198
- ### DMs
199
-
200
- After the service starts, send any message to the Signal number from your personal Signal app. The router auto-creates a `messaging_groups` row. Then:
201
-
202
- ```bash
203
- sqlite3 data/v2.db \
204
- "SELECT id, platform_id FROM messaging_groups WHERE channel_type='signal' ORDER BY created_at DESC LIMIT 5"
205
- ```
206
-
207
- Pass the `id` to `/init-first-agent` or `/manage-channels` to wire it to an agent group.
208
-
209
- ### Groups
210
-
211
- Add the Signal number to a group from your phone, send any message, then wire the resulting row the same way. For isolated per-group sessions:
212
-
213
- ```bash
214
- NOW=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
215
- sqlite3 data/v2.db "
216
- INSERT OR IGNORE INTO messaging_group_agents
217
- (id, messaging_group_id, agent_group_id, session_mode, priority, created_at)
218
- VALUES
219
- ('mga-'||hex(randomblob(8)), 'mg-GROUPID', 'ag-AGENTID', 'isolated', 0, '$NOW');
220
- "
221
- ```
222
-
223
- ### Grant user access
224
-
225
- New Signal users (including the owner's Signal identity) are silently dropped with `not_member` until granted access. After the user's first message appears in `messaging_groups`:
226
-
227
- ```bash
228
- NOW=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
229
- sqlite3 data/v2.db "
230
- INSERT OR REPLACE INTO user_roles (user_id, role, agent_group_id, granted_by, granted_at)
231
- VALUES ('signal:UUID', 'owner', NULL, 'system', '$NOW');
232
- INSERT OR IGNORE INTO agent_group_members (user_id, agent_group_id, added_by, added_at)
233
- VALUES ('signal:UUID', 'ag-AGENTID', 'system', '$NOW');
234
- "
235
- ```
236
-
237
- Find the UUID from `messaging_groups.platform_id` or the `users` table.
238
-
239
- ## Next Steps
240
-
241
- If you're in the middle of `/setup`, return to the setup flow now.
242
-
243
- Otherwise, run `/init-first-agent` to create an agent and wire it to your Signal DM, or `/manage-channels` to wire this channel to an existing agent group.
244
-
245
- ## Channel Info
246
-
247
- - **type**: `signal`
248
- - **terminology**: Signal has "chats" (1:1 DMs) and "groups"
249
- - **supports-threads**: no
250
- - **platform-id-format**:
251
- - DM: `signal:{UUID}` — sender's Signal UUID (ACI), **not** their phone number
252
- - Group: `signal:{base64GroupId}` — base64-encoded GroupV2 ID
253
- - **how-to-find-id**: Send a message to the bot, then query `messaging_groups` as shown above
254
- - **typical-use**: Personal assistant via Signal DMs or small group chats
255
- - **default-isolation**: One agent per Signal account. Multiple chats with the same operator can share an agent group; groups with other people should typically use `isolated` session mode
256
-
257
- ### Features
258
-
259
- - Markdown formatting — `**bold**`, `*italic*` / `_italic_`, `` `code` ``, ` ```code fence``` `, `~~strike~~`, `||spoiler||` (converted to Signal's offset-based text styles)
260
- - Quoted replies — `replyTo*` fields populated from Signal quotes
261
- - Typing indicators — DMs only (Signal doesn't support group typing)
262
- - Echo suppression — outbound messages matched on `(platformId, text)` within a 10 s TTL to avoid syncMessage loops
263
- - Note to Self — messages you send to your own account from another device route to the agent as inbound with `isFromMe: true`
264
- - Voice attachments — detected but not transcribed by default; the agent receives `[Voice Message]` placeholder text. Run `/add-voice-transcription` for local transcription via parakeet-mlx
265
-
266
- Not supported yet: outbound file attachments (logged and dropped), edit/delete messages, reactions.
267
-
268
- ## Troubleshooting
269
-
270
- ### Daemon not reachable
271
-
272
- ```bash
273
- grep "Signal" logs/nanoclaw.log | tail
274
- ```
275
-
276
- If you see `Signal daemon failed to start. Is signal-cli installed and your account linked?`:
277
- - Confirm `signal-cli` is on PATH (or set `SIGNAL_CLI_PATH`)
278
- - Confirm the account is linked: `signal-cli -a +1YOURNUMBER listIdentities` should succeed without prompting
279
-
280
- If you see `Signal daemon not reachable at 127.0.0.1:7583` and `SIGNAL_MANAGE_DAEMON=false`, start the daemon yourself: `signal-cli -a +1YOURNUMBER daemon --tcp 127.0.0.1:7583`.
281
-
282
- ### Bot not responding
283
-
284
- 1. Channel initialized: `grep "Signal channel connected" logs/nanoclaw.log | tail -1`
285
- 2. Channel wired: `sqlite3 data/v2.db "SELECT mg.platform_id, mg.name FROM messaging_groups mg JOIN messaging_group_agents mga ON mg.id = mga.messaging_group_id WHERE mg.channel_type='signal'"`
286
- 3. Service running: `launchctl print gui/$(id -u)/com.nanoclaw` (macOS) / `systemctl --user status nanoclaw` (Linux)
287
-
288
- ### Lost connection mid-session
289
-
290
- If you see `Signal channel lost TCP connection to signal-cli daemon` in the logs, the daemon dropped the connection. Restart the service to re-establish.
291
-
292
- ### Messages dropped with `not_member`
293
-
294
- The Signal user hasn't been granted membership. See "Grant user access" above. This affects every new Signal user, including the owner's Signal identity — which is a separate user record from their identity on other channels even if it's the same person.
295
-
296
- ### Captcha required
297
-
298
- Signal requires a captcha for new registrations. Go to `https://signalcaptchas.org/registration/generate.html`, solve it, right-click "Open Signal", copy the link, extract the token after `signalcaptcha://`.
299
-
300
- ### `Invalid verification method: Before requesting voice verification…`
301
-
302
- You must request SMS first, wait ~60 seconds, then request voice. Both steps can use the same captcha token.
303
-
304
- ### Config file in use / daemon lock
305
-
306
- signal-cli holds an exclusive lock on its data directory while the daemon is running. Stop NanoClaw before running any `signal-cli` commands directly, then restart afterward.
307
-
308
- ### Group replies going to DM instead of group
309
-
310
- Modern Signal groups use GroupV2. The adapter must extract the group ID from `envelope?.dataMessage?.groupV2?.id` — not `groupInfo?.groupId`, which is GroupV1/legacy. If group messages are routing as DMs, check `src/channels/signal.ts` and confirm the groupId extraction falls through to `groupV2.id`.
311
-
312
- ### Java not found
313
-
314
- Install Java 17+ — see the Prerequisites section above.
315
-
316
- ### QR code expired (Path B)
317
-
318
- QR codes expire in ~30 seconds. Re-run the link command to generate a new one.
@@ -1,5 +0,0 @@
1
- # Verify Signal
2
-
3
- Send a message to your own Signal number (Note to Self) from another device, or have someone send your linked number a DM. The bot should respond within a few seconds.
4
-
5
- If nothing happens, tail `logs/nanoclaw.log` for `Signal channel connected` and `Signal message received`.
@@ -1,6 +0,0 @@
1
- # Remove Slack
2
-
3
- 1. Comment out `import './slack.js'` in `src/channels/index.ts`
4
- 2. Remove `SLACK_BOT_TOKEN` and `SLACK_SIGNING_SECRET` from `.env`
5
- 3. `pnpm uninstall @chat-adapter/slack`
6
- 4. Rebuild and restart
@@ -1,112 +0,0 @@
1
- ---
2
- name: add-slack
3
- description: Add Slack channel integration via Chat SDK.
4
- ---
5
-
6
- # Add Slack Channel
7
-
8
- Adds Slack support via the Chat SDK bridge.
9
-
10
- ## Install
11
-
12
- NanoClaw doesn't ship channels in trunk. This skill copies the Slack adapter in from the `channels` branch.
13
-
14
- ### Pre-flight (idempotent)
15
-
16
- Skip to **Credentials** if all of these are already in place:
17
-
18
- - `src/channels/slack.ts` exists
19
- - `src/channels/index.ts` contains `import './slack.js';`
20
- - `@chat-adapter/slack` is listed in `package.json` dependencies
21
-
22
- Otherwise continue. Every step below is safe to re-run.
23
-
24
- ### 1. Fetch the channels branch
25
-
26
- ```bash
27
- git fetch origin channels
28
- ```
29
-
30
- ### 2. Copy the adapter
31
-
32
- ```bash
33
- git show origin/channels:src/channels/slack.ts > src/channels/slack.ts
34
- ```
35
-
36
- ### 3. Append the self-registration import
37
-
38
- Append to `src/channels/index.ts` (skip if the line is already present):
39
-
40
- ```typescript
41
- import './slack.js';
42
- ```
43
-
44
- ### 4. Install the adapter package (pinned)
45
-
46
- ```bash
47
- pnpm install @chat-adapter/slack@4.26.0
48
- ```
49
-
50
- ### 5. Build
51
-
52
- ```bash
53
- pnpm run build
54
- ```
55
-
56
- ## Credentials
57
-
58
- ### Create Slack App
59
-
60
- 1. Go to [api.slack.com/apps](https://api.slack.com/apps) and click **Create New App** > **From scratch**
61
- 2. Name it (e.g., "NanoClaw") and select your workspace
62
- 3. Go to **OAuth & Permissions** and add Bot Token Scopes:
63
- - `chat:write`, `channels:history`, `groups:history`, `im:history`, `channels:read`, `groups:read`, `users:read`, `reactions:write`
64
- 4. Click **Install to Workspace** and copy the **Bot User OAuth Token** (`xoxb-...`)
65
- 5. Go to **Basic Information** and copy the **Signing Secret**
66
-
67
- ### Enable DMs
68
-
69
- 6. Go to **App Home** and enable the **Messages Tab**
70
- 7. Check **"Allow users to send Slash commands and messages from the messages tab"**
71
-
72
- ### Event Subscriptions
73
-
74
- 8. Go to **Event Subscriptions** and toggle **Enable Events**
75
- 9. Set the **Request URL** to `https://your-domain/webhook/slack` — Slack will send a verification challenge; it must pass before you can save
76
- 10. Under **Subscribe to bot events**, add:
77
- - `message.channels`, `message.groups`, `message.im`, `app_mention`
78
- 11. Click **Save Changes**
79
- 12. Slack will show a banner asking you to **reinstall the app** — click it to apply the new event subscriptions
80
-
81
- ### Configure environment
82
-
83
- Add to `.env`:
84
-
85
- ```bash
86
- SLACK_BOT_TOKEN=xoxb-your-bot-token
87
- SLACK_SIGNING_SECRET=your-signing-secret
88
- ```
89
-
90
- Sync to container: `mkdir -p data/env && cp .env data/env/env`
91
-
92
- ### Webhook server
93
-
94
- The Chat SDK bridge automatically starts a shared webhook server on port 3000 (configurable via `WEBHOOK_PORT` env var). The server handles `/webhook/slack` for Slack and other webhook-based adapters. This port must be publicly reachable from the internet for Slack to deliver events.
95
-
96
- If running locally, discuss options for exposing the server — e.g. ngrok (`ngrok http 3000`), Cloudflare Tunnel, or a reverse proxy on a VPS. The resulting public URL becomes the base for `https://your-domain/webhook/slack`.
97
-
98
- ## Next Steps
99
-
100
- If you're in the middle of `/setup`, return to the setup flow now.
101
-
102
- Otherwise, run `/manage-channels` to wire this channel to an agent group.
103
-
104
- ## Channel Info
105
-
106
- - **type**: `slack`
107
- - **terminology**: Slack has "workspaces" containing "channels." Channels can be public (#general) or private. The bot can also receive direct messages.
108
- - **platform-id-format**: `slack:{channelId}` for channels (e.g., `slack:C0123ABC`), `slack:{dmId}` for DMs (e.g., `slack:D0ARWEBLV63`)
109
- - **how-to-find-id**: Right-click a channel name > "View channel details" — the Channel ID is at the bottom (starts with C). For DMs, the ID starts with D. Or copy the channel link — the ID is the last segment of the URL.
110
- - **supports-threads**: yes
111
- - **typical-use**: Interactive chat — team channels or direct messages
112
- - **default-isolation**: Same agent group for channels where you're the primary user. Separate agent group for channels with different teams or sensitive contexts.
@@ -1,3 +0,0 @@
1
- # Verify Slack
2
-
3
- Add the bot to a Slack channel, then send a message or @mention the bot. The bot should respond within a few seconds.
@@ -1,6 +0,0 @@
1
- # Remove Microsoft Teams Channel
2
-
3
- 1. Comment out `import './teams.js'` in `src/channels/index.ts`
4
- 2. Remove `TEAMS_APP_ID` and `TEAMS_APP_PASSWORD` from `.env`
5
- 3. `pnpm uninstall @chat-adapter/teams`
6
- 4. Rebuild and restart
@@ -1,207 +0,0 @@
1
- ---
2
- name: add-teams
3
- description: Add Microsoft Teams channel integration via Chat SDK.
4
- ---
5
-
6
- # Add Microsoft Teams Channel
7
-
8
- Connect NanoClaw to Microsoft Teams for interactive chat in team channels, group chats, and direct messages.
9
-
10
- ## Install
11
-
12
- NanoClaw doesn't ship channels in trunk. This skill copies the Teams adapter in from the `channels` branch.
13
-
14
- ### Pre-flight (idempotent)
15
-
16
- Skip to **Credentials** if all of these are already in place:
17
-
18
- - `src/channels/teams.ts` exists
19
- - `src/channels/index.ts` contains `import './teams.js';`
20
- - `@chat-adapter/teams` is listed in `package.json` dependencies
21
-
22
- Otherwise continue. Every step below is safe to re-run.
23
-
24
- ### 1. Fetch the channels branch
25
-
26
- ```bash
27
- git fetch origin channels
28
- ```
29
-
30
- ### 2. Copy the adapter
31
-
32
- ```bash
33
- git show origin/channels:src/channels/teams.ts > src/channels/teams.ts
34
- ```
35
-
36
- ### 3. Append the self-registration import
37
-
38
- Append to `src/channels/index.ts` (skip if the line is already present):
39
-
40
- ```typescript
41
- import './teams.js';
42
- ```
43
-
44
- ### 4. Install the adapter package (pinned)
45
-
46
- ```bash
47
- pnpm install @chat-adapter/teams@4.26.0
48
- ```
49
-
50
- ### 5. Build
51
-
52
- ```bash
53
- pnpm run build
54
- ```
55
-
56
- ## Credentials
57
-
58
- ### Step 1: Create an Azure AD App Registration
59
-
60
- 1. Go to [Azure Portal](https://portal.azure.com) > **App registrations** > **New registration**
61
- 2. Name it (e.g., "NanoClaw")
62
- 3. Supported account types: **Single tenant** (your org only) or **Multi tenant** (any org)
63
- 4. Click **Register**
64
- 5. Copy the **Application (client) ID** and **Directory (tenant) ID** from the Overview page
65
-
66
- ### Step 2: Create a Client Secret
67
-
68
- 1. In the App Registration, go to **Certificates & secrets**
69
- 2. Click **New client secret**, description "nanoclaw", expiry 180 days
70
- 3. Click **Add** and **copy the Value immediately** (shown only once)
71
-
72
- ### Step 3: Create an Azure Bot
73
-
74
- 1. Go to Azure Portal > search **Azure Bot** > **Create**
75
- 2. Fill in:
76
- - **Bot handle**: unique name (e.g., "nanoclaw-bot")
77
- - **Type of App**: match your app registration (Single or Multi Tenant)
78
- - **Creation type**: **Use existing app registration**
79
- - **App ID**: paste from Step 1
80
- - **App tenant ID**: paste from Step 1 (Single Tenant only)
81
- 3. Click **Review + create** > **Create**
82
-
83
- Or use Azure CLI:
84
-
85
- ```bash
86
- az group create --name nanoclaw-rg --location eastus
87
- az bot create \
88
- --resource-group nanoclaw-rg \
89
- --name nanoclaw-bot \
90
- --app-type SingleTenant \
91
- --appid YOUR_APP_ID \
92
- --tenant-id YOUR_TENANT_ID \
93
- --endpoint "https://your-domain/api/webhooks/teams"
94
- ```
95
-
96
- ### Step 4: Configure Messaging Endpoint
97
-
98
- 1. Go to your Azure Bot resource > **Configuration**
99
- 2. Set **Messaging endpoint** to `https://your-domain/api/webhooks/teams`
100
- 3. Click **Apply**
101
-
102
- ### Step 5: Enable Teams Channel
103
-
104
- 1. In the Azure Bot resource, go to **Channels**
105
- 2. Click **Microsoft Teams** > Accept terms > **Apply**
106
-
107
- Or via CLI:
108
-
109
- ```bash
110
- az bot msteams create --resource-group nanoclaw-rg --name nanoclaw-bot
111
- ```
112
-
113
- ### Step 6: Create and Sideload Teams App
114
-
115
- Create a `manifest.json`:
116
-
117
- ```json
118
- {
119
- "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
120
- "manifestVersion": "1.16",
121
- "version": "1.0.0",
122
- "id": "YOUR_APP_ID",
123
- "packageName": "com.nanoclaw.bot",
124
- "developer": {
125
- "name": "NanoClaw",
126
- "websiteUrl": "https://your-domain",
127
- "privacyUrl": "https://your-domain",
128
- "termsOfUseUrl": "https://your-domain"
129
- },
130
- "name": { "short": "NanoClaw", "full": "NanoClaw Assistant" },
131
- "description": {
132
- "short": "NanoClaw assistant bot",
133
- "full": "NanoClaw personal assistant powered by Claude."
134
- },
135
- "icons": { "outline": "outline.png", "color": "color.png" },
136
- "accentColor": "#4A90D9",
137
- "bots": [{
138
- "botId": "YOUR_APP_ID",
139
- "scopes": ["personal", "team", "groupchat"],
140
- "supportsFiles": false,
141
- "isNotificationOnly": false
142
- }],
143
- "permissions": ["identity", "messageTeamMembers"],
144
- "validDomains": ["your-domain"]
145
- }
146
- ```
147
-
148
- Create two icon PNGs (32x32 `outline.png`, 192x192 `color.png`), zip all three files together.
149
-
150
- **Sideload in Teams:**
151
- 1. Open Teams > **Apps** > **Manage your apps**
152
- 2. Click **Upload an app** > **Upload a custom app**
153
- 3. Select the zip file
154
-
155
- Sideloading requires Teams admin access. Free personal Teams does NOT support sideloading. Use a Microsoft 365 Business account or developer tenant.
156
-
157
- ### Step 7: Receive All Messages (Optional)
158
-
159
- By default, the bot only receives messages when @-mentioned. To receive all messages in a channel without @-mention, add RSC permissions to `manifest.json`:
160
-
161
- ```json
162
- {
163
- "authorization": {
164
- "permissions": {
165
- "resourceSpecific": [
166
- { "name": "ChannelMessage.Read.Group", "type": "Application" }
167
- ]
168
- }
169
- }
170
- }
171
- ```
172
-
173
- ### Configure environment
174
-
175
- Add to `.env`:
176
-
177
- ```bash
178
- TEAMS_APP_ID=your-app-id
179
- TEAMS_APP_PASSWORD=your-client-secret
180
- # For Single Tenant only:
181
- TEAMS_APP_TENANT_ID=your-tenant-id
182
- TEAMS_APP_TYPE=SingleTenant
183
- ```
184
-
185
- Sync to container: `mkdir -p data/env && cp .env data/env/env`
186
-
187
- ### Webhook server
188
-
189
- The Chat SDK bridge automatically starts a shared webhook server on port 3000 (configurable via `WEBHOOK_PORT` env var). The server handles `/api/webhooks/teams` for Teams and other webhook-based adapters. This port must be publicly reachable from the internet for Azure Bot Service to deliver activities.
190
-
191
- For local development without a public URL, use a tunnel (e.g., `ngrok http 3000`) and update the messaging endpoint in Azure Bot Configuration.
192
-
193
- ## Next Steps
194
-
195
- If you're in the middle of `/setup`, return to the setup flow now.
196
-
197
- Otherwise, run `/manage-channels` to wire this channel to an agent group.
198
-
199
- ## Channel Info
200
-
201
- - **type**: `teams`
202
- - **terminology**: Teams has "teams" containing "channels." The bot can also receive DMs (personal scope) and group chat messages. Channels support threaded replies.
203
- - **platform-id-format**: `teams:{base64-encoded-conversation-id}:{base64-encoded-service-url}` — auto-generated by the adapter, not human-readable. Use the auto-created messaging group ID for wiring.
204
- - **how-to-find-id**: Send a message to the bot in the channel. NanoClaw auto-creates a messaging group and logs the platform ID. Use that messaging group ID for wiring.
205
- - **supports-threads**: yes (channels only; DMs and group chats are flat)
206
- - **typical-use**: Team collaboration with the bot in channels; personal assistant via DMs
207
- - **default-isolation**: Separate agent group per team. DMs can share an agent group with your main channel for unified personal memory.
@@ -1,3 +0,0 @@
1
- # Verify Microsoft Teams Channel
2
-
3
- Add the bot to a Teams channel or send it a direct message. The bot should respond within a few seconds.