@openparachute/agent 0.1.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 (501) hide show
  1. package/.claude/scheduled_tasks.lock +1 -0
  2. package/.claude/settings.json +5 -0
  3. package/.claude/skills/add-atomic-chat-tool/SKILL.md +243 -0
  4. package/.claude/skills/add-atomic-chat-tool/atomic-chat-mcp-stdio.ts +229 -0
  5. package/.claude/skills/add-codex/SKILL.md +161 -0
  6. package/.claude/skills/add-dashboard/SKILL.md +138 -0
  7. package/.claude/skills/add-dashboard/resources/dashboard-pusher.ts +495 -0
  8. package/.claude/skills/add-emacs/SKILL.md +296 -0
  9. package/.claude/skills/add-gcal-tool/SKILL.md +210 -0
  10. package/.claude/skills/add-gchat/REMOVE.md +6 -0
  11. package/.claude/skills/add-gchat/SKILL.md +92 -0
  12. package/.claude/skills/add-gchat/VERIFY.md +3 -0
  13. package/.claude/skills/add-github/REMOVE.md +6 -0
  14. package/.claude/skills/add-github/SKILL.md +148 -0
  15. package/.claude/skills/add-github/VERIFY.md +3 -0
  16. package/.claude/skills/add-gmail-tool/SKILL.md +229 -0
  17. package/.claude/skills/add-imessage/REMOVE.md +6 -0
  18. package/.claude/skills/add-imessage/SKILL.md +113 -0
  19. package/.claude/skills/add-imessage/VERIFY.md +3 -0
  20. package/.claude/skills/add-karpathy-llm-wiki/SKILL.md +110 -0
  21. package/.claude/skills/add-karpathy-llm-wiki/llm-wiki.md +75 -0
  22. package/.claude/skills/add-linear/REMOVE.md +6 -0
  23. package/.claude/skills/add-linear/SKILL.md +168 -0
  24. package/.claude/skills/add-linear/VERIFY.md +3 -0
  25. package/.claude/skills/add-macos-statusbar/SKILL.md +133 -0
  26. package/.claude/skills/add-macos-statusbar/add/src/statusbar.swift +147 -0
  27. package/.claude/skills/add-matrix/REMOVE.md +6 -0
  28. package/.claude/skills/add-matrix/SKILL.md +148 -0
  29. package/.claude/skills/add-matrix/VERIFY.md +3 -0
  30. package/.claude/skills/add-ollama-provider/SKILL.md +179 -0
  31. package/.claude/skills/add-ollama-tool/SKILL.md +193 -0
  32. package/.claude/skills/add-opencode/SKILL.md +229 -0
  33. package/.claude/skills/add-parallel/SKILL.md +290 -0
  34. package/.claude/skills/add-resend/REMOVE.md +6 -0
  35. package/.claude/skills/add-resend/SKILL.md +93 -0
  36. package/.claude/skills/add-resend/VERIFY.md +3 -0
  37. package/.claude/skills/add-signal/REMOVE.md +13 -0
  38. package/.claude/skills/add-signal/SKILL.md +318 -0
  39. package/.claude/skills/add-signal/VERIFY.md +5 -0
  40. package/.claude/skills/add-slack/REMOVE.md +6 -0
  41. package/.claude/skills/add-slack/SKILL.md +112 -0
  42. package/.claude/skills/add-slack/VERIFY.md +3 -0
  43. package/.claude/skills/add-teams/REMOVE.md +6 -0
  44. package/.claude/skills/add-teams/SKILL.md +207 -0
  45. package/.claude/skills/add-teams/VERIFY.md +3 -0
  46. package/.claude/skills/add-vercel/SKILL.md +147 -0
  47. package/.claude/skills/add-vercel/container-skills/vercel-cli/SKILL.md +103 -0
  48. package/.claude/skills/add-webex/REMOVE.md +6 -0
  49. package/.claude/skills/add-webex/SKILL.md +88 -0
  50. package/.claude/skills/add-webex/VERIFY.md +3 -0
  51. package/.claude/skills/add-wechat/REMOVE.md +49 -0
  52. package/.claude/skills/add-wechat/SKILL.md +170 -0
  53. package/.claude/skills/add-wechat/scripts/wire-dm.ts +172 -0
  54. package/.claude/skills/add-whatsapp/SKILL.md +264 -0
  55. package/.claude/skills/add-whatsapp-cloud/REMOVE.md +6 -0
  56. package/.claude/skills/add-whatsapp-cloud/SKILL.md +95 -0
  57. package/.claude/skills/add-whatsapp-cloud/VERIFY.md +3 -0
  58. package/.claude/skills/claw/SKILL.md +131 -0
  59. package/.claude/skills/claw/scripts/claw +374 -0
  60. package/.claude/skills/convert-to-apple-container/SKILL.md +212 -0
  61. package/.claude/skills/customize/SKILL.md +110 -0
  62. package/.claude/skills/debug/SKILL.md +349 -0
  63. package/.claude/skills/get-qodo-rules/SKILL.md +122 -0
  64. package/.claude/skills/get-qodo-rules/references/output-format.md +41 -0
  65. package/.claude/skills/get-qodo-rules/references/pagination.md +33 -0
  66. package/.claude/skills/get-qodo-rules/references/repository-scope.md +26 -0
  67. package/.claude/skills/init-first-agent/SKILL.md +120 -0
  68. package/.claude/skills/init-onecli/SKILL.md +270 -0
  69. package/.claude/skills/manage-channels/SKILL.md +87 -0
  70. package/.claude/skills/manage-mounts/SKILL.md +47 -0
  71. package/.claude/skills/migrate-from-openclaw/MIGRATE_CRONS.md +100 -0
  72. package/.claude/skills/migrate-from-openclaw/SKILL.md +447 -0
  73. package/.claude/skills/migrate-from-openclaw/scripts/discover-openclaw.ts +734 -0
  74. package/.claude/skills/migrate-from-openclaw/scripts/extract-channel-credentials.ts +476 -0
  75. package/.claude/skills/migrate-nanoclaw/SKILL.md +484 -0
  76. package/.claude/skills/migrate-nanoclaw/diagnostics.md +51 -0
  77. package/.claude/skills/qodo-pr-resolver/SKILL.md +326 -0
  78. package/.claude/skills/qodo-pr-resolver/resources/providers.md +329 -0
  79. package/.claude/skills/update-nanoclaw/SKILL.md +243 -0
  80. package/.claude/skills/update-nanoclaw/diagnostics.md +48 -0
  81. package/.claude/skills/update-skills/SKILL.md +130 -0
  82. package/.claude/skills/use-native-credential-proxy/SKILL.md +167 -0
  83. package/.claude/skills/x-integration/SKILL.md +417 -0
  84. package/.claude/skills/x-integration/agent.ts +243 -0
  85. package/.claude/skills/x-integration/host.ts +155 -0
  86. package/.claude/skills/x-integration/lib/browser.ts +148 -0
  87. package/.claude/skills/x-integration/lib/config.ts +62 -0
  88. package/.claude/skills/x-integration/scripts/like.ts +56 -0
  89. package/.claude/skills/x-integration/scripts/post.ts +66 -0
  90. package/.claude/skills/x-integration/scripts/quote.ts +80 -0
  91. package/.claude/skills/x-integration/scripts/reply.ts +74 -0
  92. package/.claude/skills/x-integration/scripts/retweet.ts +62 -0
  93. package/.claude/skills/x-integration/scripts/setup.ts +87 -0
  94. package/.github/CODEOWNERS +10 -0
  95. package/.github/PULL_REQUEST_TEMPLATE.md +18 -0
  96. package/.github/workflows/bump-version.yml +35 -0
  97. package/.github/workflows/ci.yml +39 -0
  98. package/.github/workflows/label-pr.yml +40 -0
  99. package/.github/workflows/update-tokens.yml +43 -0
  100. package/.husky/pre-commit +1 -0
  101. package/.mcp.json +3 -0
  102. package/.nvmrc +1 -0
  103. package/.parachute/module.json +14 -0
  104. package/.prettierrc +4 -0
  105. package/CHANGELOG.md +215 -0
  106. package/CLAUDE.md +307 -0
  107. package/CODE_OF_CONDUCT.md +128 -0
  108. package/CONTRIBUTING.md +159 -0
  109. package/CONTRIBUTORS.md +26 -0
  110. package/LICENSE +21 -0
  111. package/README.md +190 -0
  112. package/README_ja.md +194 -0
  113. package/README_zh.md +194 -0
  114. package/assets/nanoclaw-favicon.png +0 -0
  115. package/assets/nanoclaw-icon.png +0 -0
  116. package/assets/nanoclaw-logo-dark.png +0 -0
  117. package/assets/nanoclaw-logo.png +0 -0
  118. package/assets/nanoclaw-profile.jpeg +0 -0
  119. package/assets/nanoclaw-sales.png +0 -0
  120. package/assets/social-preview.jpg +0 -0
  121. package/config-examples/mount-allowlist.json +25 -0
  122. package/container/.dockerignore +2 -0
  123. package/container/CLAUDE.md +21 -0
  124. package/container/Dockerfile +121 -0
  125. package/container/agent-runner/bun.lock +243 -0
  126. package/container/agent-runner/package.json +22 -0
  127. package/container/agent-runner/scripts/sdk-signal-probe.ts +169 -0
  128. package/container/agent-runner/src/config.ts +55 -0
  129. package/container/agent-runner/src/db/connection.ts +267 -0
  130. package/container/agent-runner/src/db/index.ts +20 -0
  131. package/container/agent-runner/src/db/messages-in.ts +138 -0
  132. package/container/agent-runner/src/db/messages-out.ts +143 -0
  133. package/container/agent-runner/src/db/session-routing.ts +30 -0
  134. package/container/agent-runner/src/db/session-state.test.ts +100 -0
  135. package/container/agent-runner/src/db/session-state.ts +79 -0
  136. package/container/agent-runner/src/destinations.ts +135 -0
  137. package/container/agent-runner/src/formatter.test.ts +167 -0
  138. package/container/agent-runner/src/formatter.ts +260 -0
  139. package/container/agent-runner/src/index.ts +110 -0
  140. package/container/agent-runner/src/integration.test.ts +121 -0
  141. package/container/agent-runner/src/mcp-tools/agents.instructions.md +26 -0
  142. package/container/agent-runner/src/mcp-tools/agents.ts +66 -0
  143. package/container/agent-runner/src/mcp-tools/core.instructions.md +27 -0
  144. package/container/agent-runner/src/mcp-tools/core.ts +262 -0
  145. package/container/agent-runner/src/mcp-tools/index.ts +22 -0
  146. package/container/agent-runner/src/mcp-tools/interactive.instructions.md +22 -0
  147. package/container/agent-runner/src/mcp-tools/interactive.ts +169 -0
  148. package/container/agent-runner/src/mcp-tools/scheduling.instructions.md +40 -0
  149. package/container/agent-runner/src/mcp-tools/scheduling.ts +299 -0
  150. package/container/agent-runner/src/mcp-tools/self-mod.instructions.md +25 -0
  151. package/container/agent-runner/src/mcp-tools/self-mod.ts +120 -0
  152. package/container/agent-runner/src/mcp-tools/server.ts +54 -0
  153. package/container/agent-runner/src/mcp-tools/types.ts +6 -0
  154. package/container/agent-runner/src/poll-loop.test.ts +248 -0
  155. package/container/agent-runner/src/poll-loop.ts +437 -0
  156. package/container/agent-runner/src/providers/claude.ts +379 -0
  157. package/container/agent-runner/src/providers/factory.test.ts +19 -0
  158. package/container/agent-runner/src/providers/factory.ts +13 -0
  159. package/container/agent-runner/src/providers/index.ts +6 -0
  160. package/container/agent-runner/src/providers/mock.ts +77 -0
  161. package/container/agent-runner/src/providers/provider-registry.ts +33 -0
  162. package/container/agent-runner/src/providers/types.ts +82 -0
  163. package/container/agent-runner/src/scheduling/task-script.ts +121 -0
  164. package/container/agent-runner/src/timezone.test.ts +93 -0
  165. package/container/agent-runner/src/timezone.ts +107 -0
  166. package/container/agent-runner/tsconfig.json +14 -0
  167. package/container/build.sh +48 -0
  168. package/container/entrypoint.sh +16 -0
  169. package/container/skills/agent-browser/SKILL.md +159 -0
  170. package/container/skills/frontend-engineer/SKILL.md +157 -0
  171. package/container/skills/self-customize/SKILL.md +87 -0
  172. package/container/skills/slack-formatting/SKILL.md +94 -0
  173. package/container/skills/vercel-cli/SKILL.md +111 -0
  174. package/container/skills/welcome/SKILL.md +85 -0
  175. package/docs/APPLE-CONTAINER-NETWORKING.md +90 -0
  176. package/docs/BRANCH-FORK-MAINTENANCE.md +81 -0
  177. package/docs/README.md +25 -0
  178. package/docs/SDK_DEEP_DIVE.md +643 -0
  179. package/docs/SECURITY.md +162 -0
  180. package/docs/agent-runner-details.md +749 -0
  181. package/docs/api-details.md +365 -0
  182. package/docs/architecture-diagram.html +422 -0
  183. package/docs/architecture-diagram.md +215 -0
  184. package/docs/architecture.md +751 -0
  185. package/docs/audit/2026-04-30-channel-endpoint-audit.md +36 -0
  186. package/docs/build-and-runtime.md +80 -0
  187. package/docs/cross-mount-stress/README.md +112 -0
  188. package/docs/cross-mount-stress/container-writer-retry.mjs +55 -0
  189. package/docs/cross-mount-stress/container-writer-slow.mjs +42 -0
  190. package/docs/cross-mount-stress/container-writer.mjs +47 -0
  191. package/docs/cross-mount-stress/host-writer-retry.mjs +55 -0
  192. package/docs/cross-mount-stress/host-writer-slow.mjs +43 -0
  193. package/docs/cross-mount-stress/host-writer.mjs +47 -0
  194. package/docs/db-central.md +316 -0
  195. package/docs/db-session.md +183 -0
  196. package/docs/db.md +119 -0
  197. package/docs/design/2026-04-29-vault-management-ui.md +231 -0
  198. package/docs/design/2026-04-30-channel-wiring-rework.md +234 -0
  199. package/docs/design/2026-05-01-channel-wiring-approvals-deep-dive.md +272 -0
  200. package/docs/design/2026-05-02-channel-policy-and-approval-routing.md +250 -0
  201. package/docs/docker-sandboxes.md +359 -0
  202. package/docs/isolation-model.md +88 -0
  203. package/docs/ollama.md +79 -0
  204. package/docs/parachute-integration.md +109 -0
  205. package/docs/post-night-rebirth-reflections.md +151 -0
  206. package/eslint.config.js +32 -0
  207. package/package.json +54 -0
  208. package/pnpm-workspace.yaml +8 -0
  209. package/repo-tokens/README.md +113 -0
  210. package/repo-tokens/action.yml +186 -0
  211. package/repo-tokens/badge.svg +23 -0
  212. package/repo-tokens/examples/green.svg +14 -0
  213. package/repo-tokens/examples/red.svg +14 -0
  214. package/repo-tokens/examples/yellow-green.svg +14 -0
  215. package/repo-tokens/examples/yellow.svg +14 -0
  216. package/scripts/chat.ts +101 -0
  217. package/scripts/cleanup-sessions.sh +150 -0
  218. package/scripts/init-cli-agent.ts +171 -0
  219. package/scripts/init-first-agent.ts +377 -0
  220. package/scripts/parachute.ts +158 -0
  221. package/scripts/run-migrations.ts +105 -0
  222. package/scripts/sanity-live-poll.ts +95 -0
  223. package/scripts/seed-discord.ts +79 -0
  224. package/scripts/test-v2-agent.ts +106 -0
  225. package/scripts/test-v2-channel-e2e.ts +265 -0
  226. package/scripts/test-v2-host.ts +184 -0
  227. package/src/channels/adapter.ts +214 -0
  228. package/src/channels/ask-question.ts +46 -0
  229. package/src/channels/channel-registry.test.ts +421 -0
  230. package/src/channels/channel-registry.ts +313 -0
  231. package/src/channels/chat-sdk-bridge.test.ts +84 -0
  232. package/src/channels/chat-sdk-bridge.ts +652 -0
  233. package/src/channels/cli.ts +276 -0
  234. package/src/channels/discord.ts +90 -0
  235. package/src/channels/index.ts +17 -0
  236. package/src/channels/telegram-markdown-sanitize.test.ts +78 -0
  237. package/src/channels/telegram-markdown-sanitize.ts +55 -0
  238. package/src/channels/telegram-pairing.test.ts +254 -0
  239. package/src/channels/telegram-pairing.ts +339 -0
  240. package/src/channels/telegram.ts +279 -0
  241. package/src/channels/trust-hint.test.ts +48 -0
  242. package/src/channels/trust-hint.ts +75 -0
  243. package/src/claude-md-compose.migrate.test.ts +64 -0
  244. package/src/claude-md-compose.ts +205 -0
  245. package/src/command-gate.ts +63 -0
  246. package/src/config.test.ts +93 -0
  247. package/src/config.ts +108 -0
  248. package/src/container-config.ts +167 -0
  249. package/src/container-runner.test.ts +32 -0
  250. package/src/container-runner.ts +576 -0
  251. package/src/container-runtime.test.ts +169 -0
  252. package/src/container-runtime.ts +92 -0
  253. package/src/db/_bun-sqlite-shim.ts +88 -0
  254. package/src/db/agent-activity.test.ts +155 -0
  255. package/src/db/agent-activity.ts +121 -0
  256. package/src/db/agent-groups.ts +77 -0
  257. package/src/db/connection.migrate.test.ts +143 -0
  258. package/src/db/connection.ts +224 -0
  259. package/src/db/db-v2.test.ts +440 -0
  260. package/src/db/dropped-messages.ts +44 -0
  261. package/src/db/index.ts +40 -0
  262. package/src/db/messaging-groups.ts +252 -0
  263. package/src/db/migrations/001-initial.ts +112 -0
  264. package/src/db/migrations/002-chat-sdk-state.ts +36 -0
  265. package/src/db/migrations/008-dropped-messages.ts +27 -0
  266. package/src/db/migrations/009-drop-pending-credentials.ts +13 -0
  267. package/src/db/migrations/010-engage-modes.ts +103 -0
  268. package/src/db/migrations/011-pending-sender-approvals.ts +40 -0
  269. package/src/db/migrations/012-channel-registration.ts +48 -0
  270. package/src/db/migrations/013-approval-render-metadata.ts +27 -0
  271. package/src/db/migrations/014-secrets.ts +44 -0
  272. package/src/db/migrations/015-secrets-drop-host-pattern.ts +18 -0
  273. package/src/db/migrations/016-secret-assignments.ts +30 -0
  274. package/src/db/migrations/017-agent-activity.ts +40 -0
  275. package/src/db/migrations/018-oauth-app-configs.ts +34 -0
  276. package/src/db/migrations/019-oauth-app-connections.ts +48 -0
  277. package/src/db/migrations/020-agent-app-connections.ts +28 -0
  278. package/src/db/migrations/021-pending-oauth-states.ts +35 -0
  279. package/src/db/migrations/022-app-connections-provider.ts +25 -0
  280. package/src/db/migrations/023-agent-group-secret-mode.test.ts +124 -0
  281. package/src/db/migrations/023-agent-group-secret-mode.ts +65 -0
  282. package/src/db/migrations/024-collapse-approvals.test.ts +249 -0
  283. package/src/db/migrations/024-collapse-approvals.ts +182 -0
  284. package/src/db/migrations/025-secret-mode-check.test.ts +155 -0
  285. package/src/db/migrations/025-secret-mode-check.ts +49 -0
  286. package/src/db/migrations/026-user-dms-bot-id.test.ts +116 -0
  287. package/src/db/migrations/026-user-dms-bot-id.ts +54 -0
  288. package/src/db/migrations/027-provider-credentials.ts +41 -0
  289. package/src/db/migrations/_test-helpers.ts +41 -0
  290. package/src/db/migrations/index.ts +127 -0
  291. package/src/db/migrations/module-agent-to-agent-destinations.ts +84 -0
  292. package/src/db/migrations/module-approvals-pending-approvals.ts +42 -0
  293. package/src/db/migrations/module-approvals-title-options.ts +40 -0
  294. package/src/db/schema.ts +258 -0
  295. package/src/db/session-db.test.ts +93 -0
  296. package/src/db/session-db.ts +325 -0
  297. package/src/db/sessions.ts +241 -0
  298. package/src/delivery.test.ts +148 -0
  299. package/src/delivery.ts +445 -0
  300. package/src/env.ts +74 -0
  301. package/src/group-folder.test.ts +35 -0
  302. package/src/group-folder.ts +44 -0
  303. package/src/group-init.ts +92 -0
  304. package/src/host-core.test.ts +456 -0
  305. package/src/host-sweep.test.ts +146 -0
  306. package/src/host-sweep.ts +287 -0
  307. package/src/index.ts +227 -0
  308. package/src/install-slug.ts +33 -0
  309. package/src/log.test.ts +81 -0
  310. package/src/log.ts +117 -0
  311. package/src/mcp/http.ts +72 -0
  312. package/src/mcp/server.ts +92 -0
  313. package/src/mcp/stdio.ts +51 -0
  314. package/src/mcp/tools/activity.ts +88 -0
  315. package/src/mcp/tools/agent-groups.ts +183 -0
  316. package/src/mcp/tools/approvals.ts +122 -0
  317. package/src/mcp/tools/channels.ts +199 -0
  318. package/src/mcp/tools/index.ts +27 -0
  319. package/src/mcp/tools/oauth.ts +48 -0
  320. package/src/mcp/tools/secrets.ts +169 -0
  321. package/src/mcp/tools/sessions.ts +135 -0
  322. package/src/mcp/types.ts +51 -0
  323. package/src/modules/agent-to-agent/agent-route.test.ts +46 -0
  324. package/src/modules/agent-to-agent/agent-route.ts +223 -0
  325. package/src/modules/agent-to-agent/create-agent.ts +127 -0
  326. package/src/modules/agent-to-agent/db/agent-destinations.ts +135 -0
  327. package/src/modules/agent-to-agent/index.ts +22 -0
  328. package/src/modules/agent-to-agent/write-destinations.ts +59 -0
  329. package/src/modules/approvals/agent.md +45 -0
  330. package/src/modules/approvals/index.ts +21 -0
  331. package/src/modules/approvals/picks.test.ts +291 -0
  332. package/src/modules/approvals/primitive.ts +279 -0
  333. package/src/modules/approvals/project.md +27 -0
  334. package/src/modules/approvals/response-handler.ts +87 -0
  335. package/src/modules/index.ts +24 -0
  336. package/src/modules/interactive/agent.md +21 -0
  337. package/src/modules/interactive/index.ts +69 -0
  338. package/src/modules/interactive/project.md +12 -0
  339. package/src/modules/mount-security/index.ts +448 -0
  340. package/src/modules/mount-security/migrate.test.ts +91 -0
  341. package/src/modules/permissions/access.ts +28 -0
  342. package/src/modules/permissions/channel-approval.test.ts +389 -0
  343. package/src/modules/permissions/channel-approval.ts +188 -0
  344. package/src/modules/permissions/db/agent-group-members.ts +44 -0
  345. package/src/modules/permissions/db/pending-channel-approvals.test.ts +86 -0
  346. package/src/modules/permissions/db/pending-channel-approvals.ts +66 -0
  347. package/src/modules/permissions/db/pending-sender-approvals.ts +60 -0
  348. package/src/modules/permissions/db/user-dms.ts +58 -0
  349. package/src/modules/permissions/db/user-roles.ts +85 -0
  350. package/src/modules/permissions/db/users.ts +38 -0
  351. package/src/modules/permissions/index.ts +421 -0
  352. package/src/modules/permissions/permissions.test.ts +358 -0
  353. package/src/modules/permissions/sender-approval.test.ts +470 -0
  354. package/src/modules/permissions/sender-approval.ts +165 -0
  355. package/src/modules/permissions/user-dm.ts +200 -0
  356. package/src/modules/provider-credentials/db.ts +121 -0
  357. package/src/modules/provider-credentials/index.ts +12 -0
  358. package/src/modules/provider-credentials/spawn.test.ts +206 -0
  359. package/src/modules/provider-credentials/spawn.ts +114 -0
  360. package/src/modules/scheduling/actions.ts +113 -0
  361. package/src/modules/scheduling/db.test.ts +282 -0
  362. package/src/modules/scheduling/db.ts +148 -0
  363. package/src/modules/scheduling/index.ts +34 -0
  364. package/src/modules/scheduling/recurrence.test.ts +98 -0
  365. package/src/modules/scheduling/recurrence.ts +54 -0
  366. package/src/modules/self-mod/agent.md +30 -0
  367. package/src/modules/self-mod/apply.ts +85 -0
  368. package/src/modules/self-mod/index.ts +30 -0
  369. package/src/modules/self-mod/project.md +39 -0
  370. package/src/modules/self-mod/request.ts +91 -0
  371. package/src/modules/typing/index.ts +165 -0
  372. package/src/oauth/agent-app-connections.ts +103 -0
  373. package/src/oauth/app-configs.test.ts +64 -0
  374. package/src/oauth/app-configs.ts +114 -0
  375. package/src/oauth/app-connections.test.ts +109 -0
  376. package/src/oauth/app-connections.ts +178 -0
  377. package/src/oauth/crypto.ts +56 -0
  378. package/src/oauth/flow.ts +104 -0
  379. package/src/oauth/providers/google.test.ts +38 -0
  380. package/src/oauth/providers/google.ts +46 -0
  381. package/src/oauth/providers/index.ts +48 -0
  382. package/src/oauth/state-store.test.ts +54 -0
  383. package/src/oauth/state-store.ts +93 -0
  384. package/src/parachute/README.md +27 -0
  385. package/src/parachute/create-agent.test.ts +83 -0
  386. package/src/parachute/create-agent.ts +122 -0
  387. package/src/parachute/group-status.test.ts +165 -0
  388. package/src/parachute/group-status.ts +136 -0
  389. package/src/parachute/types.ts +41 -0
  390. package/src/parachute/vault-mcp.test.ts +251 -0
  391. package/src/parachute/vault-mcp.ts +232 -0
  392. package/src/platform-id.test.ts +104 -0
  393. package/src/platform-id.ts +109 -0
  394. package/src/providers/index.ts +6 -0
  395. package/src/providers/provider-container-registry.ts +58 -0
  396. package/src/response-registry.ts +45 -0
  397. package/src/router.ts +530 -0
  398. package/src/secrets/crypto.test.ts +45 -0
  399. package/src/secrets/crypto.ts +55 -0
  400. package/src/secrets/index.ts +355 -0
  401. package/src/secrets/master-key.ts +70 -0
  402. package/src/secrets/secrets.test.ts +354 -0
  403. package/src/session-manager.migrate.test.ts +59 -0
  404. package/src/session-manager.ts +433 -0
  405. package/src/startup-bootstrap.test.ts +226 -0
  406. package/src/startup-bootstrap.ts +207 -0
  407. package/src/state-sqlite.ts +182 -0
  408. package/src/timezone.test.ts +64 -0
  409. package/src/timezone.ts +37 -0
  410. package/src/types.ts +230 -0
  411. package/src/web/auth.test.ts +335 -0
  412. package/src/web/auth.ts +214 -0
  413. package/src/web/discord-validate.test.ts +77 -0
  414. package/src/web/discord-validate.ts +88 -0
  415. package/src/web/hub-discovery.test.ts +98 -0
  416. package/src/web/hub-discovery.ts +69 -0
  417. package/src/web/routes/activity.ts +106 -0
  418. package/src/web/routes/agent-provider.test.ts +282 -0
  419. package/src/web/routes/agent-provider.ts +309 -0
  420. package/src/web/routes/approvals.ts +185 -0
  421. package/src/web/routes/apps.ts +434 -0
  422. package/src/web/routes/channels-mg-detail.test.ts +324 -0
  423. package/src/web/routes/channels-mga-detail.test.ts +425 -0
  424. package/src/web/routes/channels.ts +489 -0
  425. package/src/web/routes/oauth-providers.ts +42 -0
  426. package/src/web/routes/secrets.test.ts +175 -0
  427. package/src/web/routes/secrets.ts +282 -0
  428. package/src/web/routes/sessions.ts +123 -0
  429. package/src/web/routes/settings.test.ts +106 -0
  430. package/src/web/routes/settings.ts +247 -0
  431. package/src/web/routes/setup-status.ts +205 -0
  432. package/src/web/routes/vaults.test.ts +389 -0
  433. package/src/web/routes/vaults.ts +225 -0
  434. package/src/web/server-version.test.ts +16 -0
  435. package/src/web/server.ts +1003 -0
  436. package/src/web/services-manifest.test.ts +120 -0
  437. package/src/web/services-manifest.ts +61 -0
  438. package/src/web/static-serve.test.ts +255 -0
  439. package/src/web/static-serve.ts +104 -0
  440. package/src/web/telegram-validate.test.ts +116 -0
  441. package/src/web/telegram-validate.ts +107 -0
  442. package/src/web/vault-proxy.test.ts +214 -0
  443. package/src/web/vault-proxy.ts +120 -0
  444. package/src/web/wire-channel.ts +181 -0
  445. package/src/webhook-server.ts +134 -0
  446. package/tsconfig.json +21 -0
  447. package/vitest.config.ts +18 -0
  448. package/web/README.md +63 -0
  449. package/web/ui/index.html +13 -0
  450. package/web/ui/package.json +35 -0
  451. package/web/ui/pnpm-lock.yaml +2164 -0
  452. package/web/ui/scripts/verify-base.mjs +31 -0
  453. package/web/ui/src/App.tsx +88 -0
  454. package/web/ui/src/components/ActivityFeed.tsx +444 -0
  455. package/web/ui/src/components/AgentGroupPicker.tsx +263 -0
  456. package/web/ui/src/components/AgentProviderCards.tsx +220 -0
  457. package/web/ui/src/components/CredentialForm.tsx +214 -0
  458. package/web/ui/src/components/ScopeGrants.tsx +74 -0
  459. package/web/ui/src/components/StatusDot.tsx +43 -0
  460. package/web/ui/src/components/VaultPicker.tsx +127 -0
  461. package/web/ui/src/components/setup/AdapterInstallStep.tsx +178 -0
  462. package/web/ui/src/components/setup/AgentGroupStep.tsx +43 -0
  463. package/web/ui/src/components/setup/ChannelPickStep.tsx +74 -0
  464. package/web/ui/src/components/setup/DoneStep.tsx +49 -0
  465. package/web/ui/src/components/setup/PrereqStep.tsx +129 -0
  466. package/web/ui/src/components/setup/TestConnectionStep.tsx +108 -0
  467. package/web/ui/src/components/setup/TestMessageStep.tsx +104 -0
  468. package/web/ui/src/components/setup/WireChannelStep.tsx +166 -0
  469. package/web/ui/src/components/setup/types.ts +105 -0
  470. package/web/ui/src/lib/api.test.ts +410 -0
  471. package/web/ui/src/lib/api.ts +1210 -0
  472. package/web/ui/src/lib/auth.test.ts +139 -0
  473. package/web/ui/src/lib/auth.ts +348 -0
  474. package/web/ui/src/lib/channel-adapters.ts +136 -0
  475. package/web/ui/src/main.tsx +19 -0
  476. package/web/ui/src/routes/ApprovalsList.tsx +294 -0
  477. package/web/ui/src/routes/Apps.tsx +613 -0
  478. package/web/ui/src/routes/ChannelWireDetail.test.tsx +233 -0
  479. package/web/ui/src/routes/ChannelWireDetail.tsx +403 -0
  480. package/web/ui/src/routes/ChannelsList.tsx +158 -0
  481. package/web/ui/src/routes/GroupDetail.tsx +755 -0
  482. package/web/ui/src/routes/GroupList.tsx +187 -0
  483. package/web/ui/src/routes/MessagingGroupDetail.test.tsx +233 -0
  484. package/web/ui/src/routes/MessagingGroupDetail.tsx +306 -0
  485. package/web/ui/src/routes/NewGroupWizard.tsx +390 -0
  486. package/web/ui/src/routes/OAuthCallback.tsx +56 -0
  487. package/web/ui/src/routes/SecretsList.tsx +921 -0
  488. package/web/ui/src/routes/SessionsList.tsx +220 -0
  489. package/web/ui/src/routes/SettingsAgentProvider.tsx +109 -0
  490. package/web/ui/src/routes/SettingsApprovals.tsx +234 -0
  491. package/web/ui/src/routes/SetupWizard.tsx +219 -0
  492. package/web/ui/src/routes/VaultDetail.test.tsx +361 -0
  493. package/web/ui/src/routes/VaultDetail.tsx +960 -0
  494. package/web/ui/src/routes/VaultsList.tsx +295 -0
  495. package/web/ui/src/routes/WireChannelPage.tsx +413 -0
  496. package/web/ui/src/styles.css +608 -0
  497. package/web/ui/src/test/setup.ts +23 -0
  498. package/web/ui/src/vite-env.d.ts +10 -0
  499. package/web/ui/tsconfig.json +20 -0
  500. package/web/ui/vite.config.ts +34 -0
  501. package/web/ui/vitest.config.ts +25 -0
@@ -0,0 +1,734 @@
1
+ /**
2
+ * Discover an existing OpenClaw installation and emit a structured summary.
3
+ *
4
+ * Usage: pnpm exec tsx .claude/skills/migrate-from-openclaw/scripts/discover-openclaw.ts [--state-dir <path>]
5
+ *
6
+ * Checks (in order): --state-dir arg, $OPENCLAW_STATE_DIR, ~/.openclaw, ~/.clawdbot
7
+ * Parses openclaw.json (JSON5-tolerant), scans workspace for identity/memory files,
8
+ * checks cron jobs, MCP servers, and channel credentials.
9
+ *
10
+ * Emits a status block on stdout:
11
+ * === NANOCLAW MIGRATE: DISCOVERY ===
12
+ * ...
13
+ * === END ===
14
+ */
15
+
16
+ import fs from 'fs';
17
+ import os from 'os';
18
+ import path from 'path';
19
+
20
+ // ---------------------------------------------------------------------------
21
+ // JSON5-tolerant parser (no dependency)
22
+ // ---------------------------------------------------------------------------
23
+
24
+ function parseJson5(text: string): unknown {
25
+ // Strip single-line comments (// ...) that aren't inside strings
26
+ let cleaned = text.replace(
27
+ /("(?:[^"\\]|\\.)*")|\/\/[^\n]*/g,
28
+ (match, str) => (str ? str : ''),
29
+ );
30
+ // Strip block comments (/* ... */)
31
+ cleaned = cleaned.replace(
32
+ /("(?:[^"\\]|\\.)*")|\/\*[\s\S]*?\*\//g,
33
+ (match, str) => (str ? str : ''),
34
+ );
35
+ // Strip trailing commas before } or ]
36
+ cleaned = cleaned.replace(/,\s*([}\]])/g, '$1');
37
+ return JSON.parse(cleaned);
38
+ }
39
+
40
+ // ---------------------------------------------------------------------------
41
+ // Status block emitter (mirrors setup/status.ts convention)
42
+ // ---------------------------------------------------------------------------
43
+
44
+ function emitStatus(fields: Record<string, string | number | boolean>): void {
45
+ const lines = ['=== NANOCLAW MIGRATE: DISCOVERY ==='];
46
+ for (const [key, value] of Object.entries(fields)) {
47
+ lines.push(`${key}: ${value}`);
48
+ }
49
+ lines.push('=== END ===');
50
+ console.log(lines.join('\n'));
51
+ }
52
+
53
+ // ---------------------------------------------------------------------------
54
+ // CLI arg parsing
55
+ // ---------------------------------------------------------------------------
56
+
57
+ function parseArgs(): { stateDir?: string } {
58
+ const args = process.argv.slice(2);
59
+ for (let i = 0; i < args.length; i++) {
60
+ if (args[i] === '--state-dir' && args[i + 1]) {
61
+ return { stateDir: args[i + 1] };
62
+ }
63
+ }
64
+ return {};
65
+ }
66
+
67
+ // ---------------------------------------------------------------------------
68
+ // Path resolution
69
+ // ---------------------------------------------------------------------------
70
+
71
+ function resolveStateDir(explicit?: string): string | null {
72
+ const home = os.homedir();
73
+ const candidates: string[] = [];
74
+
75
+ if (explicit) {
76
+ // Expand ~ prefix
77
+ const expanded = explicit.startsWith('~')
78
+ ? path.join(home, explicit.slice(1))
79
+ : explicit;
80
+ candidates.push(expanded);
81
+ }
82
+
83
+ if (process.env.OPENCLAW_STATE_DIR) {
84
+ candidates.push(process.env.OPENCLAW_STATE_DIR);
85
+ }
86
+
87
+ candidates.push(path.join(home, '.openclaw'));
88
+ candidates.push(path.join(home, '.clawdbot'));
89
+
90
+ for (const dir of candidates) {
91
+ if (fs.existsSync(dir) && fs.statSync(dir).isDirectory()) {
92
+ return dir;
93
+ }
94
+ }
95
+ return null;
96
+ }
97
+
98
+ // ---------------------------------------------------------------------------
99
+ // Config loading
100
+ // ---------------------------------------------------------------------------
101
+
102
+ function loadConfig(
103
+ stateDir: string,
104
+ ): Record<string, unknown> | null {
105
+ for (const name of ['openclaw.json', 'clawdbot.json']) {
106
+ const configPath = path.join(stateDir, name);
107
+ if (fs.existsSync(configPath)) {
108
+ try {
109
+ const raw = fs.readFileSync(configPath, 'utf-8');
110
+ return parseJson5(raw) as Record<string, unknown>;
111
+ } catch {
112
+ // Try next name
113
+ }
114
+ }
115
+ }
116
+ return null;
117
+ }
118
+
119
+ // ---------------------------------------------------------------------------
120
+ // Channel detection
121
+ // ---------------------------------------------------------------------------
122
+
123
+ interface ChannelInfo {
124
+ name: string;
125
+ hasCreds: boolean;
126
+ }
127
+
128
+ const SUPPORTED_CHANNELS = new Set([
129
+ 'whatsapp',
130
+ 'telegram',
131
+ 'slack',
132
+ 'discord',
133
+ ]);
134
+
135
+ // Fields that indicate a credential is present for each channel
136
+ const CREDENTIAL_FIELDS: Record<string, string[]> = {
137
+ telegram: ['botToken'],
138
+ discord: ['token'],
139
+ slack: ['botToken', 'appToken'],
140
+ whatsapp: [], // Auth-state based, no token
141
+ signal: ['account'],
142
+ imessage: [],
143
+ matrix: ['homeserverUrl', 'accessToken'],
144
+ irc: ['server'],
145
+ msteams: ['appId'],
146
+ feishu: ['appId'],
147
+ googlechat: [],
148
+ mattermost: ['token', 'url'],
149
+ zalo: [],
150
+ bluebubbles: ['url'],
151
+ };
152
+
153
+ const ALL_KNOWN_CHANNELS = new Set([
154
+ 'whatsapp', 'telegram', 'slack', 'discord', 'signal',
155
+ 'imessage', 'matrix', 'irc', 'msteams', 'feishu',
156
+ 'googlechat', 'mattermost', 'zalo', 'bluebubbles',
157
+ ]);
158
+
159
+ function detectChannels(
160
+ config: Record<string, unknown>,
161
+ ): ChannelInfo[] {
162
+ // Check both config.channels.* (newer) and top-level config.* (older/legacy)
163
+ const channelsSections: Record<string, unknown> = {};
164
+
165
+ // Source 1: channels.* (standard location)
166
+ const nested = config.channels as Record<string, unknown> | undefined;
167
+ if (nested) {
168
+ for (const [k, v] of Object.entries(nested)) {
169
+ if (v && typeof v === 'object') channelsSections[k] = v;
170
+ }
171
+ }
172
+
173
+ // Source 2: top-level keys matching known channel names (legacy format)
174
+ for (const key of Object.keys(config)) {
175
+ if (ALL_KNOWN_CHANNELS.has(key) && !channelsSections[key]) {
176
+ const v = config[key];
177
+ if (v && typeof v === 'object') channelsSections[key] = v;
178
+ }
179
+ }
180
+
181
+ const results: ChannelInfo[] = [];
182
+
183
+ for (const [name, section] of Object.entries(channelsSections)) {
184
+ if (!section || typeof section !== 'object') continue;
185
+ const ch = section as Record<string, unknown>;
186
+
187
+ // Check if any credential field is present and non-empty
188
+ const credFields = CREDENTIAL_FIELDS[name] ?? [];
189
+ let hasCreds = false;
190
+
191
+ for (const field of credFields) {
192
+ const val = ch[field];
193
+ if (val && (typeof val === 'string' || typeof val === 'object')) {
194
+ hasCreds = true;
195
+ break;
196
+ }
197
+ }
198
+
199
+ // Also check accounts for multi-account setups
200
+ if (!hasCreds && ch.accounts && typeof ch.accounts === 'object') {
201
+ for (const acct of Object.values(
202
+ ch.accounts as Record<string, unknown>,
203
+ )) {
204
+ if (!acct || typeof acct !== 'object') continue;
205
+ const a = acct as Record<string, unknown>;
206
+ for (const field of credFields) {
207
+ if (
208
+ a[field] &&
209
+ (typeof a[field] === 'string' || typeof a[field] === 'object')
210
+ ) {
211
+ hasCreds = true;
212
+ break;
213
+ }
214
+ }
215
+ if (hasCreds) break;
216
+ }
217
+ }
218
+
219
+ // WhatsApp: check for auth state directory instead of token
220
+ if (name === 'whatsapp' && !hasCreds) {
221
+ // Will be checked separately via agents directory
222
+ hasCreds = false;
223
+ }
224
+
225
+ results.push({ name, hasCreds });
226
+ }
227
+
228
+ return results;
229
+ }
230
+
231
+ // ---------------------------------------------------------------------------
232
+ // Workspace scanning
233
+ // ---------------------------------------------------------------------------
234
+
235
+ const WORKSPACE_FILES = [
236
+ 'SOUL.md',
237
+ 'USER.md',
238
+ 'MEMORY.md',
239
+ 'IDENTITY.md',
240
+ 'TOOLS.md',
241
+ 'HEARTBEAT.md',
242
+ 'BOOTSTRAP.md',
243
+ 'AGENTS.md',
244
+ ];
245
+
246
+ function findWorkspace(stateDir: string, config: Record<string, unknown> | null): {
247
+ dir: string | null;
248
+ files: string[];
249
+ } {
250
+ // Check config-specified workspace path first (agent.workspace or agents.defaults.workspace)
251
+ const configPaths: string[] = [];
252
+ if (config) {
253
+ const agentWs = (config.agent as Record<string, unknown> | undefined)?.workspace as string | undefined;
254
+ if (agentWs) configPaths.push(agentWs.startsWith('~') ? path.join(os.homedir(), agentWs.slice(1)) : agentWs);
255
+ const defaultsWs = ((config.agents as Record<string, unknown> | undefined)?.defaults as Record<string, unknown> | undefined)?.workspace as string | undefined;
256
+ if (defaultsWs) configPaths.push(defaultsWs.startsWith('~') ? path.join(os.homedir(), defaultsWs.slice(1)) : defaultsWs);
257
+ }
258
+
259
+ // Check config-specified paths, then default locations
260
+ const candidates = [
261
+ ...configPaths,
262
+ ...['workspace', 'workspace.default'].map((n) => path.join(stateDir, n)),
263
+ ];
264
+
265
+ for (const ws of candidates) {
266
+ if (fs.existsSync(ws) && fs.statSync(ws).isDirectory()) {
267
+ const found = WORKSPACE_FILES.filter((f) =>
268
+ fs.existsSync(path.join(ws, f)),
269
+ );
270
+ if (found.length > 0) {
271
+ return { dir: ws, files: found };
272
+ }
273
+ }
274
+ }
275
+
276
+ // Check agent-specific workspaces
277
+ const agentsDir = path.join(stateDir, 'agents');
278
+ if (fs.existsSync(agentsDir)) {
279
+ for (const agentId of fs.readdirSync(agentsDir)) {
280
+ for (const wsName of ['workspace', 'workspace.default']) {
281
+ const ws = path.join(agentsDir, agentId, wsName);
282
+ if (fs.existsSync(ws) && fs.statSync(ws).isDirectory()) {
283
+ const found = WORKSPACE_FILES.filter((f) =>
284
+ fs.existsSync(path.join(ws, f)),
285
+ );
286
+ if (found.length > 0) {
287
+ return { dir: ws, files: found };
288
+ }
289
+ }
290
+ }
291
+ }
292
+ }
293
+
294
+ return { dir: null, files: [] };
295
+ }
296
+
297
+ // ---------------------------------------------------------------------------
298
+ // Daily memory file detection
299
+ // ---------------------------------------------------------------------------
300
+
301
+ function countDailyMemoryFiles(workspaceDir: string | null): number {
302
+ if (!workspaceDir) return 0;
303
+ const memoryDir = path.join(workspaceDir, 'memory');
304
+ if (!fs.existsSync(memoryDir) || !fs.statSync(memoryDir).isDirectory()) {
305
+ return 0;
306
+ }
307
+ try {
308
+ return fs
309
+ .readdirSync(memoryDir)
310
+ .filter((f) => f.endsWith('.md'))
311
+ .length;
312
+ } catch {
313
+ return 0;
314
+ }
315
+ }
316
+
317
+ // ---------------------------------------------------------------------------
318
+ // Skills detection
319
+ // ---------------------------------------------------------------------------
320
+
321
+ interface SkillInfo {
322
+ name: string;
323
+ source: string; // 'workspace' | 'shared' | 'personal' | 'project'
324
+ path: string;
325
+ }
326
+
327
+ function detectSkills(
328
+ stateDir: string,
329
+ workspaceDir: string | null,
330
+ ): SkillInfo[] {
331
+ const skills: SkillInfo[] = [];
332
+ const seen = new Set<string>();
333
+
334
+ const scanDir = (dir: string, source: string) => {
335
+ if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) return;
336
+ try {
337
+ for (const entry of fs.readdirSync(dir)) {
338
+ const skillDir = path.join(dir, entry);
339
+ if (!fs.statSync(skillDir).isDirectory()) continue;
340
+ // A directory is a skill if it contains SKILL.md
341
+ if (fs.existsSync(path.join(skillDir, 'SKILL.md'))) {
342
+ if (seen.has(entry)) continue;
343
+ seen.add(entry);
344
+ skills.push({ name: entry, source, path: skillDir });
345
+ }
346
+ }
347
+ } catch {
348
+ // ignore read errors
349
+ }
350
+ };
351
+
352
+ // 1. Workspace skills
353
+ if (workspaceDir) {
354
+ scanDir(path.join(workspaceDir, 'skills'), 'workspace');
355
+ // 4. Project-level shared skills
356
+ scanDir(path.join(workspaceDir, '.agents', 'skills'), 'project');
357
+ }
358
+
359
+ // 2. Managed/shared skills
360
+ scanDir(path.join(stateDir, 'skills'), 'shared');
361
+
362
+ // 3. Personal cross-project skills
363
+ const personalSkills = path.join(os.homedir(), '.agents', 'skills');
364
+ scanDir(personalSkills, 'personal');
365
+
366
+ return skills;
367
+ }
368
+
369
+ // ---------------------------------------------------------------------------
370
+ // Identity extraction
371
+ // ---------------------------------------------------------------------------
372
+
373
+ function extractIdentityName(stateDir: string, workspaceDir: string | null): string {
374
+ if (!workspaceDir) return '';
375
+
376
+ const identityPath = path.join(workspaceDir, 'IDENTITY.md');
377
+ if (!fs.existsSync(identityPath)) return '';
378
+
379
+ try {
380
+ const content = fs.readFileSync(identityPath, 'utf-8');
381
+ // IDENTITY.md uses key:value format, e.g. "name: Claw"
382
+ const match = content.match(/^name:\s*(.+)/im);
383
+ return match ? match[1].trim() : '';
384
+ } catch {
385
+ return '';
386
+ }
387
+ }
388
+
389
+ // ---------------------------------------------------------------------------
390
+ // Agent detection
391
+ // ---------------------------------------------------------------------------
392
+
393
+ function detectAgents(stateDir: string): string[] {
394
+ const agentsDir = path.join(stateDir, 'agents');
395
+ if (!fs.existsSync(agentsDir)) return [];
396
+
397
+ try {
398
+ return fs
399
+ .readdirSync(agentsDir)
400
+ .filter((f) => {
401
+ const p = path.join(agentsDir, f);
402
+ return fs.statSync(p).isDirectory() && !f.startsWith('.');
403
+ });
404
+ } catch {
405
+ return [];
406
+ }
407
+ }
408
+
409
+ // ---------------------------------------------------------------------------
410
+ // Group detection — from session store and channel config
411
+ // ---------------------------------------------------------------------------
412
+
413
+ interface GroupInfo {
414
+ channel: string;
415
+ id: string; // Platform-specific ID (WhatsApp JID, Telegram chat ID, etc.)
416
+ name: string;
417
+ source: 'session' | 'config';
418
+ }
419
+
420
+ /**
421
+ * Map OpenClaw session key channel:kind:id to NanoClaw JID format.
422
+ * OpenClaw keys: "whatsapp:group:120...@g.us", "telegram:group:-10012345"
423
+ * NanoClaw JIDs: "120...@g.us", "tg:-10012345", "dc:12345", "slack:C12345"
424
+ */
425
+ function toNanoClawJid(channel: string, id: string): string {
426
+ switch (channel) {
427
+ case 'whatsapp':
428
+ return id; // Already in JID format (120...@g.us)
429
+ case 'telegram':
430
+ return `tg:${id}`;
431
+ case 'discord':
432
+ return `dc:${id}`;
433
+ case 'slack':
434
+ return `slack:${id}`;
435
+ default:
436
+ return `${channel}:${id}`;
437
+ }
438
+ }
439
+
440
+ function detectGroups(
441
+ stateDir: string,
442
+ config: Record<string, unknown> | null,
443
+ agents: string[],
444
+ ): GroupInfo[] {
445
+ const groups: GroupInfo[] = [];
446
+ const seen = new Set<string>();
447
+
448
+ // Source 1: Session store — scan for group session keys
449
+ for (const agentId of agents) {
450
+ const sessionsPath = path.join(
451
+ stateDir,
452
+ 'agents',
453
+ agentId,
454
+ 'sessions',
455
+ 'sessions.json',
456
+ );
457
+ if (!fs.existsSync(sessionsPath)) continue;
458
+
459
+ try {
460
+ const raw = fs.readFileSync(sessionsPath, 'utf-8');
461
+ const data = JSON.parse(raw) as Record<string, unknown>;
462
+
463
+ // Sessions can be stored as an object with session keys, or as
464
+ // { sessions: { key: entry } } or { entries: [...] }
465
+ const entries =
466
+ (data.sessions as Record<string, unknown>) ??
467
+ (data.entries as Record<string, unknown>) ??
468
+ data;
469
+
470
+ for (const [key, value] of Object.entries(entries)) {
471
+ // Match session keys like "whatsapp:group:120...@g.us"
472
+ // or prefixed "agent:main:whatsapp:group:120...@g.us"
473
+ // Also match DM sessions: "whatsapp:dm:number@s.whatsapp.net"
474
+ const match = key.match(/(\w+):(group|dm|channel):(.+)$/i);
475
+ if (!match) continue;
476
+
477
+ const [, channel, kind, id] = match;
478
+ // Skip DM sessions for group detection — they're individual chats
479
+ if (kind === 'dm') continue;
480
+ const dedupKey = `${channel}:${id}`;
481
+ if (seen.has(dedupKey)) continue;
482
+ seen.add(dedupKey);
483
+
484
+ // Try to extract display name from session entry
485
+ let name = '';
486
+ if (value && typeof value === 'object') {
487
+ const entry = value as Record<string, unknown>;
488
+ name =
489
+ (entry.displayName as string) ??
490
+ (entry.label as string) ??
491
+ (entry.subject as string) ??
492
+ '';
493
+ }
494
+
495
+ groups.push({
496
+ channel,
497
+ id,
498
+ name: name || id,
499
+ source: 'session',
500
+ });
501
+ }
502
+ } catch {
503
+ // Ignore parse errors
504
+ }
505
+ }
506
+
507
+ // Source 2: Channel config — groups explicitly configured
508
+ if (config) {
509
+ const channels =
510
+ (config.channels as Record<string, unknown> | undefined) ?? {};
511
+ for (const [channelName, channelSection] of Object.entries(channels)) {
512
+ if (!channelSection || typeof channelSection !== 'object') continue;
513
+ const ch = channelSection as Record<string, unknown>;
514
+
515
+ // WhatsApp/Telegram: channels.<channel>.groups.<groupId>
516
+ const configGroups = ch.groups as Record<string, unknown> | undefined;
517
+ if (configGroups) {
518
+ for (const groupId of Object.keys(configGroups)) {
519
+ const dedupKey = `${channelName}:${groupId}`;
520
+ if (seen.has(dedupKey)) continue;
521
+ seen.add(dedupKey);
522
+ groups.push({
523
+ channel: channelName,
524
+ id: groupId,
525
+ name: groupId,
526
+ source: 'config',
527
+ });
528
+ }
529
+ }
530
+
531
+ // Discord: channels.discord.guilds.<guildId>
532
+ if (channelName === 'discord') {
533
+ const guilds = ch.guilds as Record<string, unknown> | undefined;
534
+ if (guilds) {
535
+ for (const guildId of Object.keys(guilds)) {
536
+ const dedupKey = `discord:${guildId}`;
537
+ if (seen.has(dedupKey)) continue;
538
+ seen.add(dedupKey);
539
+ groups.push({
540
+ channel: 'discord',
541
+ id: guildId,
542
+ name: guildId,
543
+ source: 'config',
544
+ });
545
+ }
546
+ }
547
+ }
548
+ }
549
+ }
550
+
551
+ return groups;
552
+ }
553
+
554
+ // ---------------------------------------------------------------------------
555
+ // Cron job counting
556
+ // ---------------------------------------------------------------------------
557
+
558
+ function countCronJobs(stateDir: string): {
559
+ count: number;
560
+ summaries: string[];
561
+ } {
562
+ const jobsPath = path.join(stateDir, 'cron', 'jobs.json');
563
+ if (!fs.existsSync(jobsPath)) return { count: 0, summaries: [] };
564
+
565
+ try {
566
+ const raw = fs.readFileSync(jobsPath, 'utf-8');
567
+ const data = JSON.parse(raw) as {
568
+ jobs?: Array<{ name?: string; enabled?: boolean }>;
569
+ };
570
+ const jobs = data.jobs ?? [];
571
+ const summaries = jobs
572
+ .filter((j) => j.enabled !== false)
573
+ .map((j) => j.name || 'unnamed')
574
+ .slice(0, 10);
575
+ return { count: jobs.length, summaries };
576
+ } catch {
577
+ return { count: 0, summaries: [] };
578
+ }
579
+ }
580
+
581
+ // ---------------------------------------------------------------------------
582
+ // Config-registered plugins and skills (with API keys)
583
+ // ---------------------------------------------------------------------------
584
+
585
+ interface ConfigPlugin {
586
+ name: string;
587
+ source: 'skills.entries' | 'plugins.entries';
588
+ hasApiKey: boolean;
589
+ }
590
+
591
+ function detectConfigPlugins(
592
+ config: Record<string, unknown>,
593
+ ): ConfigPlugin[] {
594
+ const results: ConfigPlugin[] = [];
595
+
596
+ // Check skills.entries (e.g. openai-whisper-api with apiKey)
597
+ const skills = config.skills as Record<string, unknown> | undefined;
598
+ const skillEntries = skills?.entries as Record<string, unknown> | undefined;
599
+ if (skillEntries) {
600
+ for (const [name, entry] of Object.entries(skillEntries)) {
601
+ if (!entry || typeof entry !== 'object') continue;
602
+ const e = entry as Record<string, unknown>;
603
+ const hasKey = !!(e.apiKey || e.token || e.key);
604
+ results.push({ name, source: 'skills.entries', hasApiKey: hasKey });
605
+ }
606
+ }
607
+
608
+ // Check plugins.entries (e.g. brave with config.webSearch.apiKey)
609
+ const plugins = config.plugins as Record<string, unknown> | undefined;
610
+ const pluginEntries = plugins?.entries as Record<string, unknown> | undefined;
611
+ if (pluginEntries) {
612
+ for (const [name, entry] of Object.entries(pluginEntries)) {
613
+ if (!entry || typeof entry !== 'object') continue;
614
+ // Deep-search for apiKey in nested config
615
+ const hasKey = JSON.stringify(entry).includes('apiKey');
616
+ results.push({ name, source: 'plugins.entries', hasApiKey: hasKey });
617
+ }
618
+ }
619
+
620
+ return results;
621
+ }
622
+
623
+ // ---------------------------------------------------------------------------
624
+ // MCP server detection
625
+ // ---------------------------------------------------------------------------
626
+
627
+ function detectMcpServers(
628
+ config: Record<string, unknown>,
629
+ ): string[] {
630
+ const mcp = config.mcp as Record<string, unknown> | undefined;
631
+ if (!mcp) return [];
632
+ const servers = mcp.servers as Record<string, unknown> | undefined;
633
+ if (!servers) return [];
634
+ return Object.keys(servers);
635
+ }
636
+
637
+ // ---------------------------------------------------------------------------
638
+ // Main
639
+ // ---------------------------------------------------------------------------
640
+
641
+ function main(): void {
642
+ const { stateDir: explicitDir } = parseArgs();
643
+ const stateDir = resolveStateDir(explicitDir);
644
+
645
+ if (!stateDir) {
646
+ emitStatus({ STATUS: 'not_found' });
647
+ return;
648
+ }
649
+
650
+ const config = loadConfig(stateDir);
651
+ const channels = config ? detectChannels(config) : [];
652
+ const { dir: workspaceDir, files: workspaceFiles } =
653
+ findWorkspace(stateDir, config);
654
+ const identityName = extractIdentityName(stateDir, workspaceDir);
655
+ const agents = detectAgents(stateDir);
656
+ const groups = detectGroups(stateDir, config, agents);
657
+ const { count: cronCount, summaries: cronSummaries } =
658
+ countCronJobs(stateDir);
659
+ const mcpServers = config ? detectMcpServers(config) : [];
660
+ const dailyMemoryFiles = countDailyMemoryFiles(workspaceDir);
661
+ const skills = detectSkills(stateDir, workspaceDir);
662
+ const configPlugins = config ? detectConfigPlugins(config) : [];
663
+
664
+ // Format channels as "name(has_creds)" or "name(no_creds)"
665
+ const channelList = channels
666
+ .map((c) => `${c.name}(${c.hasCreds ? 'has_creds' : 'no_creds'})`)
667
+ .join(',');
668
+
669
+ // Separate supported vs unsupported
670
+ const unsupported = channels
671
+ .filter((c) => !SUPPORTED_CHANNELS.has(c.name))
672
+ .map((c) => c.name)
673
+ .join(',');
674
+
675
+ // Format groups as "channel:id(name)" — also include NanoClaw JID mapping
676
+ const groupList = groups
677
+ .map(
678
+ (g) =>
679
+ `${g.channel}:${g.id}(${g.name})=>${toNanoClawJid(g.channel, g.id)}`,
680
+ )
681
+ .join('|');
682
+
683
+ // Format skills as "name(source)" list
684
+ const skillList = skills
685
+ .map((s) => `${s.name}(${s.source})`)
686
+ .join(',');
687
+
688
+ // Dump raw top-level config keys so Claude can see what exists
689
+ // beyond what this script specifically detects
690
+ const configTopKeys = config ? Object.keys(config).sort().join(',') : 'none';
691
+ const configChannelKeys = config?.channels
692
+ ? Object.keys(config.channels as Record<string, unknown>).sort().join(',')
693
+ : 'none';
694
+
695
+ // List files/dirs at the state dir root for manual inspection
696
+ let stateDirContents = 'unknown';
697
+ try {
698
+ stateDirContents = fs
699
+ .readdirSync(stateDir)
700
+ .filter((f) => !f.startsWith('.'))
701
+ .sort()
702
+ .join(',');
703
+ } catch {
704
+ // ignore
705
+ }
706
+
707
+ emitStatus({
708
+ STATUS: 'found',
709
+ STATE_DIR: stateDir,
710
+ CONFIG_FOUND: config !== null,
711
+ CONFIG_TOP_KEYS: configTopKeys,
712
+ CONFIG_CHANNEL_KEYS: configChannelKeys,
713
+ STATE_DIR_CONTENTS: stateDirContents,
714
+ CHANNELS: channelList || 'none',
715
+ UNSUPPORTED_CHANNELS: unsupported || 'none',
716
+ WORKSPACE_DIR: workspaceDir || 'not_found',
717
+ WORKSPACE_FILES: workspaceFiles.join(',') || 'none',
718
+ IDENTITY_NAME: identityName || 'unknown',
719
+ AGENT_COUNT: agents.length,
720
+ AGENT_IDS: agents.join(',') || 'none',
721
+ GROUPS: groupList || 'none',
722
+ GROUP_COUNT: groups.length,
723
+ DAILY_MEMORY_FILES: dailyMemoryFiles,
724
+ SKILL_COUNT: skills.length,
725
+ SKILLS: skillList || 'none',
726
+ CONFIG_PLUGINS: configPlugins.map((p) => `${p.name}(${p.source}${p.hasApiKey ? ',has_key' : ''})`).join(',') || 'none',
727
+ CONFIG_PLUGIN_COUNT: configPlugins.length,
728
+ CRON_JOBS: cronCount,
729
+ CRON_SUMMARIES: cronSummaries.join('|') || 'none',
730
+ MCP_SERVERS: mcpServers.join(',') || 'none',
731
+ });
732
+ }
733
+
734
+ main();