@stage-labs/metro 0.1.0-beta.23 → 0.1.0-beta.231

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 (457) hide show
  1. package/dist/api.js +9 -101
  2. package/dist/background.js +123 -0
  3. package/dist/claude-settings.js +40 -0
  4. package/dist/claude.js +197 -0
  5. package/dist/cli.js +52 -110
  6. package/dist/control.js +19 -103
  7. package/dist/hold.js +210 -0
  8. package/dist/local.js +43 -0
  9. package/dist/mcp-config.js +25 -0
  10. package/dist/memory.js +222 -0
  11. package/dist/node-name.js +71 -0
  12. package/dist/onboarding.js +44 -0
  13. package/dist/provider-flags.js +9 -0
  14. package/dist/route.js +58 -0
  15. package/dist/runtime-install.js +96 -0
  16. package/dist/runtime.js +29 -52
  17. package/dist/serve.js +157 -0
  18. package/dist/service.js +304 -0
  19. package/dist/tail.js +119 -0
  20. package/dist/update.js +13 -1
  21. package/package.json +2 -23
  22. package/runtime/marketplace/.claude-plugin/marketplace.json +12 -0
  23. package/runtime/marketplace/plugin/.claude-plugin/plugin.json +17 -0
  24. package/runtime/marketplace/plugin/.mcp.json +1 -0
  25. package/runtime/marketplace/plugin/MEMORY.md +78 -0
  26. package/runtime/marketplace/plugin/METRO.md +26 -0
  27. package/runtime/marketplace/plugin/STAGE.md +42 -0
  28. package/runtime/marketplace/plugin/bin/guard.mjs +71 -0
  29. package/runtime/marketplace/plugin/bin/metro-plugin.mjs +30 -0
  30. package/runtime/marketplace/plugin/bin/policy.mjs +97 -0
  31. package/runtime/marketplace/plugin/bin/session-start.mjs +31 -0
  32. package/runtime/marketplace/plugin/hooks/hooks.json +25 -0
  33. package/runtime/node_modules/@metro-labs/core/package.json +51 -0
  34. package/runtime/node_modules/@metro-labs/core/src/endpoints.ts +7 -0
  35. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → core/src}/events.ts +11 -7
  36. package/runtime/node_modules/@metro-labs/{mcp/src/db → core/src}/ids.ts +5 -0
  37. package/runtime/node_modules/@metro-labs/core/src/is-record.ts +2 -0
  38. package/runtime/node_modules/@metro-labs/{mcp/src/stations → core/src}/lines.ts +22 -26
  39. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → core/src}/protocol.ts +7 -4
  40. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → core/src}/secure-fs.ts +17 -0
  41. package/runtime/node_modules/@metro-labs/core/src/station-names.ts +14 -0
  42. package/runtime/node_modules/@metro-labs/core/src/stations/account-files.ts +41 -0
  43. package/runtime/node_modules/@metro-labs/core/src/stations/account-store.ts +83 -0
  44. package/runtime/node_modules/@metro-labs/{mcp → core}/src/stations/attachments.ts +0 -1
  45. package/runtime/node_modules/@metro-labs/core/src/stations/mail-text.ts +72 -0
  46. package/runtime/node_modules/@metro-labs/core/src/stations/mail-trust.ts +29 -0
  47. package/runtime/node_modules/@metro-labs/core/src/stations/mail.ts +212 -0
  48. package/runtime/node_modules/@metro-labs/core/src/stations/messaging-normalize.ts +16 -0
  49. package/runtime/node_modules/@metro-labs/core/src/stations/oauth.ts +126 -0
  50. package/runtime/node_modules/@metro-labs/core/src/stations/profile.ts +58 -0
  51. package/runtime/node_modules/@metro-labs/core/src/stations/sender-profile.ts +64 -0
  52. package/runtime/node_modules/@metro-labs/{mcp → core}/src/stations/station-runtime.ts +6 -11
  53. package/runtime/node_modules/@metro-labs/core/src/stations/train-boot.ts +42 -0
  54. package/runtime/node_modules/@metro-labs/core/src/stations/train-events.ts +84 -0
  55. package/runtime/node_modules/@metro-labs/{mcp → core}/src/stations/types.ts +18 -1
  56. package/runtime/node_modules/@metro-labs/core/src/tickets.ts +37 -0
  57. package/runtime/node_modules/@metro-labs/core/src/version.ts +2 -0
  58. package/runtime/node_modules/@metro-labs/daemon/package.json +49 -0
  59. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/agent-fs.ts +134 -0
  60. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/crontab.ts +44 -0
  61. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/files-api.ts +12 -0
  62. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/files.ts +89 -0
  63. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/home-fs.ts +113 -0
  64. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/job-env.ts +39 -0
  65. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/provision.ts +80 -0
  66. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/schedule-detail.ts +99 -0
  67. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/schedules-api.ts +27 -0
  68. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/schedules.ts +144 -0
  69. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/unit-files.ts +43 -0
  70. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/user.ts +91 -0
  71. package/runtime/node_modules/@metro-labs/daemon/src/agent-user/view.ts +87 -0
  72. package/runtime/node_modules/@metro-labs/daemon/src/agents/account-attach.ts +19 -0
  73. package/runtime/node_modules/@metro-labs/daemon/src/agents/account-lookups.ts +55 -0
  74. package/runtime/node_modules/@metro-labs/daemon/src/agents/account-routes.ts +76 -0
  75. package/runtime/node_modules/@metro-labs/daemon/src/agents/accounts-api.ts +357 -0
  76. package/runtime/node_modules/@metro-labs/daemon/src/agents/admin.ts +30 -0
  77. package/runtime/node_modules/@metro-labs/daemon/src/agents/allowlist.ts +59 -0
  78. package/runtime/node_modules/@metro-labs/daemon/src/agents/api.ts +131 -0
  79. package/runtime/node_modules/@metro-labs/daemon/src/agents/bundle.ts +132 -0
  80. package/runtime/node_modules/@metro-labs/daemon/src/agents/file-admin.ts +305 -0
  81. package/runtime/node_modules/@metro-labs/daemon/src/agents/files.ts +142 -0
  82. package/runtime/node_modules/@metro-labs/{mcp/src/db/key-map.ts → daemon/src/agents/keys.ts} +1 -11
  83. package/runtime/node_modules/@metro-labs/daemon/src/agents/map.ts +133 -0
  84. package/runtime/node_modules/@metro-labs/daemon/src/agents/policy-route.ts +27 -0
  85. package/runtime/node_modules/@metro-labs/{mcp/src/db/agent-scope.ts → daemon/src/agents/scope.ts} +2 -2
  86. package/runtime/node_modules/@metro-labs/daemon/src/agents/sender-cards.ts +94 -0
  87. package/runtime/node_modules/@metro-labs/daemon/src/agents/senders.ts +38 -0
  88. package/runtime/node_modules/@metro-labs/daemon/src/approvals/api.ts +55 -0
  89. package/runtime/node_modules/@metro-labs/daemon/src/approvals/pending.ts +150 -0
  90. package/runtime/node_modules/@metro-labs/daemon/src/approvals/preview.ts +66 -0
  91. package/runtime/node_modules/@metro-labs/daemon/src/boot/boot.ts +223 -0
  92. package/runtime/node_modules/@metro-labs/daemon/src/boot/connect-hint.ts +36 -0
  93. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/boot}/crash-guard.ts +1 -1
  94. package/runtime/node_modules/@metro-labs/daemon/src/boot/local-owner.ts +21 -0
  95. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/boot}/paths.ts +6 -34
  96. package/runtime/node_modules/@metro-labs/daemon/src/channels/addressed.ts +26 -0
  97. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/channels/inbound.ts +75 -45
  98. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/channels/media-note.ts +11 -7
  99. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/channels/pending.ts +4 -1
  100. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/channels/relay.ts +2 -2
  101. package/runtime/node_modules/@metro-labs/daemon/src/claude/api.ts +380 -0
  102. package/runtime/node_modules/@metro-labs/daemon/src/claude/files.ts +359 -0
  103. package/runtime/node_modules/@metro-labs/daemon/src/claude/login.ts +208 -0
  104. package/runtime/node_modules/@metro-labs/daemon/src/claude/memory-routine.ts +114 -0
  105. package/runtime/node_modules/@metro-labs/daemon/src/claude/memory.ts +32 -0
  106. package/runtime/node_modules/@metro-labs/daemon/src/claude/onboarding.ts +60 -0
  107. package/runtime/node_modules/@metro-labs/daemon/src/claude/plugin-install.ts +149 -0
  108. package/runtime/node_modules/@metro-labs/daemon/src/claude/session-files.ts +75 -0
  109. package/runtime/node_modules/@metro-labs/daemon/src/claude/session.ts +295 -0
  110. package/runtime/node_modules/@metro-labs/daemon/src/claude/settings.ts +109 -0
  111. package/runtime/node_modules/@metro-labs/daemon/src/claude/setup.ts +346 -0
  112. package/runtime/node_modules/@metro-labs/daemon/src/claude/skills.ts +120 -0
  113. package/runtime/node_modules/@metro-labs/daemon/src/claude/usage-probe.ts +127 -0
  114. package/runtime/node_modules/@metro-labs/daemon/src/claude/version.ts +113 -0
  115. package/runtime/node_modules/@metro-labs/{mcp/src/daemon/connector-api.ts → daemon/src/connectors/api.ts} +79 -113
  116. package/runtime/node_modules/@metro-labs/{mcp/src/db/connector-config.ts → daemon/src/connectors/config.ts} +67 -41
  117. package/runtime/node_modules/@metro-labs/daemon/src/connectors/gates.ts +72 -0
  118. package/runtime/node_modules/@metro-labs/daemon/src/connectors/health.ts +18 -0
  119. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/connectors}/oauth-client.ts +14 -17
  120. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/connectors}/oauth-discovery.ts +33 -20
  121. package/runtime/node_modules/@metro-labs/{mcp/src/daemon/connector-oauth-routes.ts → daemon/src/connectors/oauth-routes.ts} +30 -32
  122. package/runtime/node_modules/@metro-labs/{mcp/src/daemon/connector-oauth.ts → daemon/src/connectors/oauth.ts} +61 -22
  123. package/runtime/node_modules/@metro-labs/daemon/src/connectors/plugin-sync.ts +131 -0
  124. package/runtime/node_modules/@metro-labs/daemon/src/connectors/reach.ts +27 -0
  125. package/runtime/node_modules/@metro-labs/daemon/src/connectors/relay-policy.ts +90 -0
  126. package/runtime/node_modules/@metro-labs/daemon/src/connectors/relay.ts +347 -0
  127. package/runtime/node_modules/@metro-labs/daemon/src/connectors/store.ts +385 -0
  128. package/runtime/node_modules/@metro-labs/daemon/src/connectors/tools.ts +81 -0
  129. package/runtime/node_modules/@metro-labs/daemon/src/connectors/transfer-api.ts +116 -0
  130. package/runtime/node_modules/@metro-labs/daemon/src/connectors/transfer-crypto.ts +44 -0
  131. package/runtime/node_modules/@metro-labs/daemon/src/connectors/transfer-store.ts +48 -0
  132. package/runtime/node_modules/@metro-labs/daemon/src/connectors/url.ts +37 -0
  133. package/runtime/node_modules/@metro-labs/daemon/src/connectors/verify.ts +106 -0
  134. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/files}/attach-grant.ts +4 -4
  135. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/files}/attach-owner.ts +3 -3
  136. package/runtime/node_modules/@metro-labs/daemon/src/files/attach-reaper.ts +174 -0
  137. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/files}/attach-serve.ts +12 -13
  138. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/files}/upload-api.ts +10 -27
  139. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/files}/upload-store.ts +4 -4
  140. package/runtime/node_modules/@metro-labs/daemon/src/gateway/bedrock.ts +233 -0
  141. package/runtime/node_modules/@metro-labs/daemon/src/gateway/codex-auth.ts +214 -0
  142. package/runtime/node_modules/@metro-labs/daemon/src/gateway/codex-device.ts +91 -0
  143. package/runtime/node_modules/@metro-labs/daemon/src/gateway/codex-stream.ts +173 -0
  144. package/runtime/node_modules/@metro-labs/daemon/src/gateway/codex-translate.ts +209 -0
  145. package/runtime/node_modules/@metro-labs/daemon/src/gateway/codex-version.ts +44 -0
  146. package/runtime/node_modules/@metro-labs/daemon/src/gateway/codex.ts +155 -0
  147. package/runtime/node_modules/@metro-labs/daemon/src/gateway/effort.ts +93 -0
  148. package/runtime/node_modules/@metro-labs/daemon/src/gateway/eventstream.ts +123 -0
  149. package/runtime/node_modules/@metro-labs/daemon/src/gateway/forward.ts +237 -0
  150. package/runtime/node_modules/@metro-labs/daemon/src/gateway/frames.ts +118 -0
  151. package/runtime/node_modules/@metro-labs/daemon/src/gateway/gateway.ts +307 -0
  152. package/runtime/node_modules/@metro-labs/daemon/src/gateway/gemini-auth.ts +160 -0
  153. package/runtime/node_modules/@metro-labs/daemon/src/gateway/gemini-client.ts +46 -0
  154. package/runtime/node_modules/@metro-labs/daemon/src/gateway/gemini-setup.ts +150 -0
  155. package/runtime/node_modules/@metro-labs/daemon/src/gateway/gemini-stream.ts +139 -0
  156. package/runtime/node_modules/@metro-labs/daemon/src/gateway/gemini-translate.ts +235 -0
  157. package/runtime/node_modules/@metro-labs/daemon/src/gateway/gemini.ts +208 -0
  158. package/runtime/node_modules/@metro-labs/daemon/src/gateway/model-api.ts +203 -0
  159. package/runtime/node_modules/@metro-labs/daemon/src/gateway/model-config.ts +285 -0
  160. package/runtime/node_modules/@metro-labs/daemon/src/gateway/model-lists.ts +57 -0
  161. package/runtime/node_modules/@metro-labs/daemon/src/gateway/model-signin.ts +161 -0
  162. package/runtime/node_modules/@metro-labs/daemon/src/gateway/model-store.ts +72 -0
  163. package/runtime/node_modules/@metro-labs/daemon/src/gateway/openrouter.ts +104 -0
  164. package/runtime/node_modules/@metro-labs/daemon/src/gateway/pkce.ts +36 -0
  165. package/runtime/node_modules/@metro-labs/daemon/src/gateway/provider-models.ts +118 -0
  166. package/runtime/node_modules/@metro-labs/daemon/src/gateway/served.ts +18 -0
  167. package/runtime/node_modules/@metro-labs/daemon/src/gateway/subscription.ts +120 -0
  168. package/runtime/node_modules/@metro-labs/daemon/src/gateway/text.ts +35 -0
  169. package/runtime/node_modules/@metro-labs/daemon/src/gateway/tool-search.ts +126 -0
  170. package/runtime/node_modules/@metro-labs/daemon/src/gateway/usage-refresh.ts +102 -0
  171. package/runtime/node_modules/@metro-labs/daemon/src/gateway/usage.ts +348 -0
  172. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/accounts.ts +28 -17
  173. package/runtime/node_modules/@metro-labs/daemon/src/mcp/attachment-schema.ts +91 -0
  174. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/call-tools.ts +49 -20
  175. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/ctx.ts +4 -4
  176. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/event-store.ts +15 -16
  177. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/group-tools.ts +2 -2
  178. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/index.ts +34 -80
  179. package/runtime/node_modules/@metro-labs/daemon/src/mcp/instructions.ts +19 -0
  180. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/member-tools.ts +2 -2
  181. package/runtime/node_modules/@metro-labs/daemon/src/mcp/permission-prompt.ts +87 -0
  182. package/runtime/node_modules/@metro-labs/daemon/src/mcp/permission-relay.ts +88 -0
  183. package/runtime/node_modules/@metro-labs/daemon/src/mcp/policy-gate.ts +82 -0
  184. package/runtime/node_modules/@metro-labs/daemon/src/mcp/policy-snapshot.ts +79 -0
  185. package/runtime/node_modules/@metro-labs/daemon/src/mcp/profile-lookup.ts +60 -0
  186. package/runtime/node_modules/@metro-labs/daemon/src/mcp/profile-tool.ts +96 -0
  187. package/runtime/node_modules/@metro-labs/daemon/src/mcp/read-tool.ts +87 -0
  188. package/runtime/node_modules/@metro-labs/daemon/src/mcp/request-identity.ts +46 -0
  189. package/runtime/node_modules/@metro-labs/daemon/src/mcp/session-slot.ts +71 -0
  190. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/session.ts +47 -44
  191. package/runtime/node_modules/@metro-labs/daemon/src/mcp/tool-catalog.ts +93 -0
  192. package/runtime/node_modules/@metro-labs/daemon/src/mcp/tool-def.ts +9 -0
  193. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/tool-dispatch.ts +53 -40
  194. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/tool-schemas.ts +64 -113
  195. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/upload-tool.ts +6 -11
  196. package/runtime/node_modules/@metro-labs/daemon/src/metro-user/helper-script.ts +126 -0
  197. package/runtime/node_modules/@metro-labs/daemon/src/metro-user/install.ts +37 -0
  198. package/runtime/node_modules/@metro-labs/daemon/src/metro-user/privilege.ts +48 -0
  199. package/runtime/node_modules/@metro-labs/daemon/src/monitor/api.ts +132 -0
  200. package/runtime/node_modules/@metro-labs/daemon/src/net/tunnel.ts +316 -0
  201. package/runtime/node_modules/@metro-labs/daemon/src/policy/policy.ts +118 -0
  202. package/runtime/node_modules/@metro-labs/daemon/src/routes/bearer.ts +35 -0
  203. package/runtime/node_modules/@metro-labs/daemon/src/routes/body.ts +24 -0
  204. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/routes}/http.ts +63 -51
  205. package/runtime/node_modules/@metro-labs/daemon/src/routes/local-mode.ts +209 -0
  206. package/runtime/node_modules/@metro-labs/daemon/src/routes/session-apis.ts +69 -0
  207. package/runtime/node_modules/@metro-labs/daemon/src/routes/session.ts +29 -0
  208. package/runtime/node_modules/@metro-labs/daemon/src/routes/threema-callback.ts +103 -0
  209. package/runtime/node_modules/@metro-labs/daemon/src/server/cloudwatch.ts +178 -0
  210. package/runtime/node_modules/@metro-labs/daemon/src/server/control.ts +39 -0
  211. package/runtime/node_modules/@metro-labs/daemon/src/server/machine.ts +58 -0
  212. package/runtime/node_modules/@metro-labs/daemon/src/server/owner.ts +26 -0
  213. package/runtime/node_modules/@metro-labs/daemon/src/server/update.ts +90 -0
  214. package/runtime/node_modules/@metro-labs/daemon/src/server.ts +2 -0
  215. package/runtime/node_modules/@metro-labs/daemon/src/stations/attach-browser.ts +102 -0
  216. package/runtime/node_modules/@metro-labs/daemon/src/stations/attach-driver.ts +42 -0
  217. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/stations/attach-inline.ts +29 -1
  218. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/stations/attach-interactive.ts +5 -31
  219. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/stations/attach-resolve.ts +38 -13
  220. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/stations}/attach-session.ts +32 -22
  221. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/stations/attach-xmtp.ts +8 -9
  222. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/stations/attach.ts +69 -3
  223. package/runtime/node_modules/@metro-labs/{mcp/src/db → daemon/src/stations}/materialize.ts +60 -179
  224. package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/stations/registry.ts +20 -2
  225. package/runtime/node_modules/@metro-labs/daemon/src/stations/runtime-deps.ts +82 -0
  226. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/stations}/supervisor-io.ts +3 -3
  227. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/stations}/supervisor.ts +6 -9
  228. package/runtime/node_modules/@metro-labs/daemon/src/stations/threema-callbacks.ts +32 -0
  229. package/runtime/node_modules/@metro-labs/{mcp/src/daemon → daemon/src/stations}/train-call.ts +1 -1
  230. package/runtime/node_modules/@metro-labs/daemon/src/stations/webhook-endpoints.ts +51 -0
  231. package/runtime/node_modules/@metro-labs/daemon/src/terminal/api.ts +84 -0
  232. package/runtime/node_modules/@metro-labs/daemon/src/terminal/socket.ts +124 -0
  233. package/runtime/node_modules/@metro-labs/daemon/src/terminal/tickets.ts +15 -0
  234. package/runtime/node_modules/@metro-labs/daemon/src/vault/api.ts +45 -0
  235. package/runtime/node_modules/@metro-labs/daemon/src/vault/config.ts +51 -0
  236. package/runtime/node_modules/@metro-labs/daemon/src/vault/firewall.ts +9 -0
  237. package/runtime/node_modules/@metro-labs/daemon/src/vault/index.ts +96 -0
  238. package/runtime/node_modules/@metro-labs/daemon/src/vault/install.ts +56 -0
  239. package/runtime/node_modules/@metro-labs/daemon/src/vault/paths.ts +26 -0
  240. package/runtime/node_modules/@metro-labs/daemon/src/vault/proxy.ts +147 -0
  241. package/runtime/node_modules/@metro-labs/daemon/src/vault/store.ts +129 -0
  242. package/runtime/node_modules/@metro-labs/daemon/src/vault/trust.ts +44 -0
  243. package/runtime/node_modules/@metro-labs/discord-bot/package.json +2 -4
  244. package/runtime/node_modules/@metro-labs/discord-bot/src/accounts.ts +3 -23
  245. package/runtime/node_modules/@metro-labs/discord-bot/src/actions.ts +19 -187
  246. package/runtime/node_modules/@metro-labs/discord-bot/src/attachments.ts +2 -2
  247. package/runtime/node_modules/@metro-labs/discord-bot/src/format.ts +26 -67
  248. package/runtime/node_modules/@metro-labs/discord-bot/src/group-actions.ts +1 -1
  249. package/runtime/node_modules/@metro-labs/discord-bot/src/group.ts +2 -2
  250. package/runtime/node_modules/@metro-labs/discord-bot/src/index.ts +8 -14
  251. package/runtime/node_modules/@metro-labs/discord-bot/src/members.ts +2 -2
  252. package/runtime/node_modules/@metro-labs/discord-bot/src/profile.ts +68 -0
  253. package/runtime/node_modules/@metro-labs/discord-bot/src/send-files.ts +12 -13
  254. package/runtime/node_modules/@metro-labs/discord-bot/src/station.ts +5 -1
  255. package/runtime/node_modules/@metro-labs/gmail/package.json +25 -0
  256. package/runtime/node_modules/@metro-labs/gmail/src/accounts.ts +81 -0
  257. package/runtime/node_modules/@metro-labs/gmail/src/actions.ts +14 -0
  258. package/runtime/node_modules/@metro-labs/gmail/src/api.ts +31 -0
  259. package/runtime/node_modules/@metro-labs/gmail/src/attachments.ts +35 -0
  260. package/runtime/node_modules/@metro-labs/gmail/src/auth.ts +105 -0
  261. package/runtime/node_modules/@metro-labs/gmail/src/config.ts +13 -0
  262. package/runtime/node_modules/@metro-labs/gmail/src/inbound.ts +96 -0
  263. package/runtime/node_modules/@metro-labs/gmail/src/index.ts +12 -0
  264. package/runtime/node_modules/@metro-labs/gmail/src/login.ts +37 -0
  265. package/runtime/node_modules/@metro-labs/gmail/src/message.ts +125 -0
  266. package/runtime/node_modules/@metro-labs/gmail/src/mime.ts +70 -0
  267. package/runtime/node_modules/@metro-labs/gmail/src/outbound.ts +124 -0
  268. package/runtime/node_modules/@metro-labs/gmail/src/query.ts +99 -0
  269. package/runtime/node_modules/@metro-labs/gmail/src/state.ts +24 -0
  270. package/runtime/node_modules/@metro-labs/gmail/src/station.ts +15 -0
  271. package/runtime/node_modules/@metro-labs/gmail/src/trust.ts +42 -0
  272. package/runtime/node_modules/@metro-labs/http/package.json +30 -0
  273. package/runtime/node_modules/@metro-labs/http/src/api-http.ts +135 -0
  274. package/runtime/node_modules/@metro-labs/{mcp/src/daemon/session-api.ts → http/src/mode-api.ts} +13 -9
  275. package/runtime/node_modules/@metro-labs/http/src/return-to.ts +21 -0
  276. package/runtime/node_modules/@metro-labs/http/src/sigv4.ts +90 -0
  277. package/runtime/node_modules/@metro-labs/http/src/workos-token.ts +149 -0
  278. package/runtime/node_modules/@metro-labs/outlook/package.json +25 -0
  279. package/runtime/node_modules/@metro-labs/outlook/src/accounts.ts +78 -0
  280. package/runtime/node_modules/@metro-labs/outlook/src/actions.ts +14 -0
  281. package/runtime/node_modules/@metro-labs/outlook/src/attachments.ts +81 -0
  282. package/runtime/node_modules/@metro-labs/outlook/src/auth.ts +120 -0
  283. package/runtime/node_modules/@metro-labs/outlook/src/browser.ts +42 -0
  284. package/runtime/node_modules/@metro-labs/outlook/src/config.ts +23 -0
  285. package/runtime/node_modules/@metro-labs/outlook/src/format.ts +59 -0
  286. package/runtime/node_modules/@metro-labs/outlook/src/graph.ts +55 -0
  287. package/runtime/node_modules/@metro-labs/outlook/src/inbound.ts +96 -0
  288. package/runtime/node_modules/@metro-labs/outlook/src/index.ts +12 -0
  289. package/runtime/node_modules/@metro-labs/outlook/src/login.ts +129 -0
  290. package/runtime/node_modules/@metro-labs/outlook/src/me.ts +31 -0
  291. package/runtime/node_modules/@metro-labs/outlook/src/outbound.ts +103 -0
  292. package/runtime/node_modules/@metro-labs/outlook/src/query.ts +84 -0
  293. package/runtime/node_modules/@metro-labs/outlook/src/state.ts +28 -0
  294. package/runtime/node_modules/@metro-labs/outlook/src/station.ts +15 -0
  295. package/runtime/node_modules/@metro-labs/outlook/src/trust.ts +41 -0
  296. package/runtime/node_modules/@metro-labs/telegram/package.json +1 -3
  297. package/runtime/node_modules/@metro-labs/telegram/src/accounts.ts +5 -24
  298. package/runtime/node_modules/@metro-labs/telegram/src/actions.ts +8 -6
  299. package/runtime/node_modules/@metro-labs/telegram/src/attachments.ts +1 -1
  300. package/runtime/node_modules/@metro-labs/telegram/src/client.ts +2 -2
  301. package/runtime/node_modules/@metro-labs/telegram/src/format.ts +19 -34
  302. package/runtime/node_modules/@metro-labs/telegram/src/group.ts +3 -3
  303. package/runtime/node_modules/@metro-labs/telegram/src/inbound.ts +13 -34
  304. package/runtime/node_modules/@metro-labs/telegram/src/index.ts +4 -43
  305. package/runtime/node_modules/@metro-labs/telegram/src/media-actions.ts +2 -3
  306. package/runtime/node_modules/@metro-labs/telegram/src/members.ts +1 -1
  307. package/runtime/node_modules/@metro-labs/telegram/src/profile.ts +70 -0
  308. package/runtime/node_modules/@metro-labs/telegram/src/reactions.ts +2 -2
  309. package/runtime/node_modules/@metro-labs/telegram/src/station.ts +4 -1
  310. package/runtime/node_modules/@metro-labs/telegram/src/types.ts +0 -1
  311. package/runtime/node_modules/@metro-labs/telegram-bot/package.json +1 -1
  312. package/runtime/node_modules/@metro-labs/telegram-bot/src/accounts.ts +7 -41
  313. package/runtime/node_modules/@metro-labs/telegram-bot/src/actions.ts +22 -77
  314. package/runtime/node_modules/@metro-labs/telegram-bot/src/attachments.ts +2 -2
  315. package/runtime/node_modules/@metro-labs/telegram-bot/src/format.ts +46 -48
  316. package/runtime/node_modules/@metro-labs/telegram-bot/src/index.ts +15 -15
  317. package/runtime/node_modules/@metro-labs/telegram-bot/src/media-actions.ts +6 -82
  318. package/runtime/node_modules/@metro-labs/telegram-bot/src/members.ts +1 -1
  319. package/runtime/node_modules/@metro-labs/telegram-bot/src/profile.ts +85 -0
  320. package/runtime/node_modules/@metro-labs/telegram-bot/src/station.ts +5 -1
  321. package/runtime/node_modules/@metro-labs/telegram-bot/src/types.ts +20 -12
  322. package/runtime/node_modules/@metro-labs/threema/package.json +26 -0
  323. package/runtime/node_modules/@metro-labs/threema/src/accounts.ts +96 -0
  324. package/runtime/node_modules/@metro-labs/threema/src/actions.ts +124 -0
  325. package/runtime/node_modules/@metro-labs/threema/src/api.ts +152 -0
  326. package/runtime/node_modules/@metro-labs/threema/src/crypto.ts +100 -0
  327. package/runtime/node_modules/@metro-labs/threema/src/files.ts +47 -0
  328. package/runtime/node_modules/@metro-labs/threema/src/format.ts +164 -0
  329. package/runtime/node_modules/@metro-labs/threema/src/groups.ts +96 -0
  330. package/runtime/node_modules/@metro-labs/threema/src/ids.ts +21 -0
  331. package/runtime/node_modules/@metro-labs/threema/src/inbound.ts +87 -0
  332. package/runtime/node_modules/@metro-labs/threema/src/index.ts +24 -0
  333. package/runtime/node_modules/@metro-labs/threema/src/messages.ts +264 -0
  334. package/runtime/node_modules/@metro-labs/threema/src/outbound.ts +160 -0
  335. package/runtime/node_modules/@metro-labs/threema/src/station.ts +13 -0
  336. package/runtime/node_modules/@metro-labs/threema/src/verify.ts +117 -0
  337. package/runtime/node_modules/@metro-labs/webhook/package.json +1 -1
  338. package/runtime/node_modules/@metro-labs/webhook/src/station.ts +5 -8
  339. package/runtime/node_modules/@metro-labs/whatsapp/package.json +2 -5
  340. package/runtime/node_modules/@metro-labs/whatsapp/src/accounts.ts +6 -28
  341. package/runtime/node_modules/@metro-labs/whatsapp/src/ack.ts +1 -1
  342. package/runtime/node_modules/@metro-labs/whatsapp/src/actions.ts +54 -11
  343. package/runtime/node_modules/@metro-labs/whatsapp/src/attachments.ts +2 -2
  344. package/runtime/node_modules/@metro-labs/whatsapp/src/auth-state.ts +1 -1
  345. package/runtime/node_modules/@metro-labs/whatsapp/src/client.ts +86 -4
  346. package/runtime/node_modules/@metro-labs/whatsapp/src/format.ts +7 -58
  347. package/runtime/node_modules/@metro-labs/whatsapp/src/inbound.ts +11 -28
  348. package/runtime/node_modules/@metro-labs/whatsapp/src/index.ts +4 -37
  349. package/runtime/node_modules/@metro-labs/whatsapp/src/keys.ts +1 -1
  350. package/runtime/node_modules/@metro-labs/whatsapp/src/login.ts +1 -1
  351. package/runtime/node_modules/@metro-labs/whatsapp/src/media.ts +1 -1
  352. package/runtime/node_modules/@metro-labs/whatsapp/src/names.ts +75 -0
  353. package/runtime/node_modules/@metro-labs/whatsapp/src/parse.ts +44 -0
  354. package/runtime/node_modules/@metro-labs/whatsapp/src/resolve.ts +52 -0
  355. package/runtime/node_modules/@metro-labs/whatsapp/src/station.ts +16 -1
  356. package/runtime/node_modules/@metro-labs/whatsapp/src/token-store.ts +5 -9
  357. package/runtime/node_modules/@metro-labs/whatsapp/src/types.ts +0 -1
  358. package/runtime/node_modules/@metro-labs/xmtp/package.json +3 -2
  359. package/runtime/node_modules/@metro-labs/xmtp/src/accounts.ts +10 -20
  360. package/runtime/node_modules/@metro-labs/xmtp/src/actions-close.ts +2 -2
  361. package/runtime/node_modules/@metro-labs/xmtp/src/actions-conv.ts +15 -204
  362. package/runtime/node_modules/@metro-labs/xmtp/src/actions-meta.ts +40 -53
  363. package/runtime/node_modules/@metro-labs/xmtp/src/actions.ts +72 -220
  364. package/runtime/node_modules/@metro-labs/xmtp/src/attachments.ts +3 -3
  365. package/runtime/node_modules/@metro-labs/xmtp/src/codecs.ts +27 -0
  366. package/runtime/node_modules/@metro-labs/xmtp/src/conv-helpers.ts +11 -7
  367. package/runtime/node_modules/@metro-labs/xmtp/src/emit-payloads.ts +7 -24
  368. package/runtime/node_modules/@metro-labs/xmtp/src/emit.ts +8 -18
  369. package/runtime/node_modules/@metro-labs/xmtp/src/group-members.ts +1 -1
  370. package/runtime/node_modules/@metro-labs/xmtp/src/group.ts +2 -2
  371. package/runtime/node_modules/@metro-labs/xmtp/src/identity.ts +30 -16
  372. package/runtime/node_modules/@metro-labs/xmtp/src/index.ts +12 -20
  373. package/runtime/node_modules/@metro-labs/xmtp/src/labels.ts +57 -33
  374. package/runtime/node_modules/@metro-labs/xmtp/src/member-args.ts +1 -1
  375. package/runtime/node_modules/@metro-labs/xmtp/src/names.ts +61 -0
  376. package/runtime/node_modules/@metro-labs/xmtp/src/profile.ts +153 -0
  377. package/runtime/node_modules/@metro-labs/xmtp/src/resolve.ts +44 -0
  378. package/runtime/node_modules/@metro-labs/xmtp/src/sender.ts +112 -0
  379. package/runtime/node_modules/@metro-labs/xmtp/src/smart.ts +72 -0
  380. package/runtime/node_modules/@metro-labs/xmtp/src/station.ts +7 -2
  381. package/runtime/node_modules/@metro-labs/xmtp/src/tools-handlers.ts +22 -58
  382. package/runtime/node_modules/@metro-labs/xmtp/src/tools.ts +55 -48
  383. package/runtime/node_modules/@metro-labs/xmtp/src/transcribe.ts +4 -6
  384. package/runtime/node_modules/@metro-labs/xmtp/src/verify.ts +19 -5
  385. package/runtime/node_modules/@metro-labs/xmtp/src/wire.ts +14 -4
  386. package/runtime/runtime.json +1 -1
  387. package/runtime/server.ts +1 -0
  388. package/runtime/stations.json +38 -0
  389. package/dist/prompt.js +0 -61
  390. package/dist/store.js +0 -70
  391. package/runtime/node_modules/@metro-labs/discord-bot/src/voice-speak.ts +0 -195
  392. package/runtime/node_modules/@metro-labs/discord-bot/src/voice-transcribe.ts +0 -292
  393. package/runtime/node_modules/@metro-labs/discord-bot/src/voice.ts +0 -197
  394. package/runtime/node_modules/@metro-labs/discord-bot/src/wire.ts +0 -5
  395. package/runtime/node_modules/@metro-labs/mcp/package.json +0 -66
  396. package/runtime/node_modules/@metro-labs/mcp/src/channels/dedupe.ts +0 -24
  397. package/runtime/node_modules/@metro-labs/mcp/src/daemon/account-api.ts +0 -311
  398. package/runtime/node_modules/@metro-labs/mcp/src/daemon/agent-api.ts +0 -341
  399. package/runtime/node_modules/@metro-labs/mcp/src/daemon/api-http.ts +0 -129
  400. package/runtime/node_modules/@metro-labs/mcp/src/daemon/boot.ts +0 -320
  401. package/runtime/node_modules/@metro-labs/mcp/src/daemon/cli-pair-api.ts +0 -111
  402. package/runtime/node_modules/@metro-labs/mcp/src/daemon/cli-pair.ts +0 -20
  403. package/runtime/node_modules/@metro-labs/mcp/src/daemon/collection-api.ts +0 -202
  404. package/runtime/node_modules/@metro-labs/mcp/src/daemon/connector-json.ts +0 -31
  405. package/runtime/node_modules/@metro-labs/mcp/src/daemon/connector-tools.ts +0 -100
  406. package/runtime/node_modules/@metro-labs/mcp/src/daemon/connector-url.ts +0 -57
  407. package/runtime/node_modules/@metro-labs/mcp/src/daemon/connector-verify.ts +0 -333
  408. package/runtime/node_modules/@metro-labs/mcp/src/daemon/google-auth.ts +0 -164
  409. package/runtime/node_modules/@metro-labs/mcp/src/daemon/google-oauth.ts +0 -208
  410. package/runtime/node_modules/@metro-labs/mcp/src/daemon/identity.ts +0 -79
  411. package/runtime/node_modules/@metro-labs/mcp/src/daemon/oauth-pending.ts +0 -65
  412. package/runtime/node_modules/@metro-labs/mcp/src/daemon/pair-codes.ts +0 -58
  413. package/runtime/node_modules/@metro-labs/mcp/src/daemon/project-api.ts +0 -214
  414. package/runtime/node_modules/@metro-labs/mcp/src/daemon/run-api.ts +0 -125
  415. package/runtime/node_modules/@metro-labs/mcp/src/daemon/run-pair.ts +0 -18
  416. package/runtime/node_modules/@metro-labs/mcp/src/daemon/runtime-source.ts +0 -105
  417. package/runtime/node_modules/@metro-labs/mcp/src/daemon/session-apis.ts +0 -41
  418. package/runtime/node_modules/@metro-labs/mcp/src/daemon/session.ts +0 -218
  419. package/runtime/node_modules/@metro-labs/mcp/src/daemon/tunnel.ts +0 -169
  420. package/runtime/node_modules/@metro-labs/mcp/src/db/account-attach.ts +0 -91
  421. package/runtime/node_modules/@metro-labs/mcp/src/db/agent-admin.ts +0 -215
  422. package/runtime/node_modules/@metro-labs/mcp/src/db/agent-map.ts +0 -71
  423. package/runtime/node_modules/@metro-labs/mcp/src/db/client.ts +0 -37
  424. package/runtime/node_modules/@metro-labs/mcp/src/db/connector-collections.ts +0 -218
  425. package/runtime/node_modules/@metro-labs/mcp/src/db/connectors.ts +0 -329
  426. package/runtime/node_modules/@metro-labs/mcp/src/db/projects.ts +0 -300
  427. package/runtime/node_modules/@metro-labs/mcp/src/db/runtime-admin.ts +0 -31
  428. package/runtime/node_modules/@metro-labs/mcp/src/db/runtimes.ts +0 -105
  429. package/runtime/node_modules/@metro-labs/mcp/src/db/schema.ts +0 -131
  430. package/runtime/node_modules/@metro-labs/mcp/src/db/token-carry.ts +0 -45
  431. package/runtime/node_modules/@metro-labs/mcp/src/db/users.ts +0 -57
  432. package/runtime/node_modules/@metro-labs/mcp/src/db/whatsapp-login.ts +0 -18
  433. package/runtime/node_modules/@metro-labs/mcp/src/mcp/channel-owner.ts +0 -29
  434. package/runtime/node_modules/@metro-labs/mcp/src/mcp/frame-scope.ts +0 -21
  435. package/runtime/node_modules/@metro-labs/mcp/src/mcp/permission-relay.ts +0 -66
  436. package/runtime/node_modules/@metro-labs/mcp/src/mcp/request-identity.ts +0 -73
  437. package/runtime/node_modules/@metro-labs/mcp/src/mcp/session-registry.ts +0 -172
  438. package/runtime/node_modules/@metro-labs/mcp/src/mcp/session-route.ts +0 -43
  439. package/runtime/node_modules/@metro-labs/mcp/src/monitor/api.ts +0 -240
  440. package/runtime/node_modules/@metro-labs/mcp/src/server.ts +0 -2
  441. package/runtime/node_modules/@metro-labs/mcp/src/stations/account-store.ts +0 -80
  442. package/runtime/node_modules/@metro-labs/mcp/src/stations/messaging-normalize.ts +0 -88
  443. package/runtime/node_modules/@metro-labs/telegram/src/normalize.ts +0 -22
  444. package/runtime/node_modules/@metro-labs/telegram/src/wire.ts +0 -1
  445. package/runtime/node_modules/@metro-labs/telegram-bot/src/wire.ts +0 -3
  446. package/runtime/node_modules/@metro-labs/whatsapp/src/normalize.ts +0 -22
  447. package/runtime/node_modules/@metro-labs/whatsapp/src/wire.ts +0 -5
  448. package/runtime/node_modules/@metro-labs/xmtp/src/actions-push.ts +0 -87
  449. package/runtime/node_modules/@metro-labs/xmtp/src/emit-core.ts +0 -55
  450. package/runtime/node_modules/@metro-labs/xmtp/src/push.ts +0 -349
  451. /package/runtime/node_modules/@metro-labs/{mcp/src/daemon → core/src}/log.ts +0 -0
  452. /package/runtime/node_modules/@metro-labs/{mcp/src/mcp → core/src}/str.ts +0 -0
  453. /package/runtime/node_modules/@metro-labs/{mcp/src/daemon → core/src}/train-error.ts +0 -0
  454. /package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/channels/webhook-note.ts +0 -0
  455. /package/runtime/node_modules/@metro-labs/{mcp → daemon}/src/mcp/raw-get-stream.ts +0 -0
  456. /package/runtime/node_modules/@metro-labs/{mcp/src/daemon → http/src}/api-error.ts +0 -0
  457. /package/runtime/node_modules/@metro-labs/{mcp/src/daemon → http/src}/cors.ts +0 -0
@@ -0,0 +1,142 @@
1
+ import { existsSync, readFileSync } from 'node:fs';
2
+ import { homedir } from 'node:os';
3
+ import { join } from 'node:path';
4
+ import { AGENT_NAME_RE, ID_RE } from '@metro-labs/core/ids';
5
+ import { STATIONS, type StationName } from '@metro-labs/core/station-names';
6
+ import type { LoadedAccount, LoadedAgent, StationSource } from '../stations/materialize.js';
7
+ import { isRecord } from '@metro-labs/core/is-record';
8
+ import { parsePolicy } from '../policy/policy.js';
9
+
10
+ const AGENT_FILE = 'agent.json';
11
+
12
+ const KEY_RE = /^[A-Za-z0-9_-]{16,128}$/;
13
+ const STATION_NAMES = new Set<string>(STATIONS);
14
+
15
+ export class AgentFileError extends Error {}
16
+
17
+ export interface AgentFile {
18
+ version: 1;
19
+ id: string;
20
+ name: string | null;
21
+ key: string | null;
22
+ stations: LoadedAccount[];
23
+ }
24
+
25
+ export const agentFilePath = (dir = agentsDir()): string => join(dir, AGENT_FILE);
26
+
27
+ export function agentsDir(): string {
28
+ const explicit = process.env.METRO_AGENTS_DIR?.trim();
29
+ return explicit !== undefined && explicit !== ''
30
+ ? explicit
31
+ : join(homedir(), '.metro', 'agents');
32
+ }
33
+
34
+ function fail(path: string, reason: string): never {
35
+ throw new AgentFileError(`${path}: ${reason}`);
36
+ }
37
+
38
+ function isStationName(value: unknown): value is StationName {
39
+ return typeof value === 'string' && STATION_NAMES.has(value);
40
+ }
41
+
42
+ function allowlistOf(raw: unknown, path: string, where: string): string[] | null {
43
+ if (raw === null || raw === undefined) return null;
44
+ if (!Array.isArray(raw)) fail(path, `${where}.allowlist is not a list of strings`);
45
+ const list = raw.filter((entry): entry is string => typeof entry === 'string');
46
+ if (list.length !== raw.length)
47
+ fail(path, `${where}.allowlist is not a list of strings`);
48
+ return list;
49
+ }
50
+
51
+ export function approversOf(raw: unknown): { approvers?: string[] } {
52
+ if (!Array.isArray(raw)) return {};
53
+ const list = raw.filter((entry): entry is string => typeof entry === 'string' && entry !== '*' && entry.trim() !== '');
54
+ return list.length === 0 ? {} : { approvers: list };
55
+ }
56
+
57
+ function stationOf(raw: unknown, path: string, index: number): LoadedAccount {
58
+ const where = `stations[${String(index)}]`;
59
+ if (!isRecord(raw)) fail(path, `${where} is not an object`);
60
+ const { station, id, config } = raw;
61
+ if (!isStationName(station)) fail(path, `${where}.station is not a known station`);
62
+ if (typeof id !== 'string' || !ID_RE.test(id))
63
+ fail(path, `${where}.id is not an 11-character id`);
64
+ if (!isRecord(config)) fail(path, `${where}.config is not an object`);
65
+ const policy = parsePolicy(raw.policy, `${path} ${where}`);
66
+ return {
67
+ station,
68
+ id,
69
+ allowlist: allowlistOf(raw.allowlist, path, where),
70
+ ...approversOf(raw.approvers),
71
+ enabled: raw.enabled !== false,
72
+ ...(policy === undefined ? {} : { policy }),
73
+ config,
74
+ };
75
+ }
76
+
77
+ function optionalMatch(
78
+ value: unknown,
79
+ re: RegExp,
80
+ path: string,
81
+ what: string,
82
+ ): string | null {
83
+ if (value === null || value === undefined) return null;
84
+ if (typeof value !== 'string' || !re.test(value)) fail(path, what);
85
+ return value;
86
+ }
87
+
88
+ function nameOf(raw: unknown, path: string): string | null {
89
+ if (raw === undefined || raw === null) return null;
90
+ if (typeof raw !== 'string' || !AGENT_NAME_RE.test(raw)) fail(path, 'name is not a valid agent name');
91
+ return raw;
92
+ }
93
+
94
+ export function parseAgentFile(raw: string, path: string): AgentFile {
95
+ let parsed: unknown;
96
+ try {
97
+ parsed = JSON.parse(raw);
98
+ } catch {
99
+ fail(path, 'is not valid JSON');
100
+ }
101
+ if (!isRecord(parsed)) fail(path, 'is not a JSON object');
102
+ if (parsed.version !== 1) fail(path, 'version must be 1');
103
+ const { id, name, stations } = parsed;
104
+ if (typeof id !== 'string' || !ID_RE.test(id))
105
+ fail(path, 'id is not an 11-character id');
106
+ const label = nameOf(name, path);
107
+ const key = optionalMatch(parsed.key, KEY_RE, path, 'key is not an agent key');
108
+ if (!Array.isArray(stations)) fail(path, 'stations is not a list');
109
+ return {
110
+ version: 1,
111
+ id,
112
+ name: label,
113
+ key,
114
+ stations: stations.map((s, i) => stationOf(s, path, i)),
115
+ };
116
+ }
117
+
118
+ export function readAgentFile(path: string): AgentFile {
119
+ let raw: string;
120
+ try {
121
+ raw = readFileSync(path, 'utf8');
122
+ } catch {
123
+ fail(path, 'cannot be read');
124
+ }
125
+ return parseAgentFile(raw, path);
126
+ }
127
+
128
+ export function listAgentFiles(dir = agentsDir()): string[] {
129
+ const fixed = agentFilePath(dir);
130
+ return existsSync(fixed) ? [fixed] : [];
131
+ }
132
+
133
+ export function loadFileAgents(dir = agentsDir()): LoadedAgent[] {
134
+ return listAgentFiles(dir).map(readAgentFile).map((agent) => ({
135
+ id: agent.id,
136
+ name: agent.name ?? agent.id,
137
+ key: agent.key,
138
+ accounts: agent.stations,
139
+ }));
140
+ }
141
+
142
+ export const fileSource: StationSource = () => Promise.resolve(loadFileAgents());
@@ -1,5 +1,5 @@
1
1
  import { createHash } from 'node:crypto';
2
- import { ID_RE } from './ids.js';
2
+ import { ID_RE } from '@metro-labs/core/ids';
3
3
 
4
4
  const digest = (token: string): string =>
5
5
  createHash('sha256').update(token).digest('hex');
@@ -25,16 +25,6 @@ export function registerKey(key: string, agentId: string): void {
25
25
  agentIdByKeyHash.set(digest(key), agentId);
26
26
  }
27
27
 
28
- export function unregisterAgentKey(agentId: string): void {
29
- for (const [hash, id] of agentIdByKeyHash)
30
- if (id === agentId) agentIdByKeyHash.delete(hash);
31
- }
32
-
33
- export function rotateAgentKey(agentId: string, key: string | null): void {
34
- unregisterAgentKey(agentId);
35
- if (key !== null) registerKey(key, agentId);
36
- }
37
-
38
28
  export function agentIdForKey(token: string): string | undefined {
39
29
  if (token === '') return undefined;
40
30
  return agentIdByKeyHash.get(digest(token));
@@ -0,0 +1,133 @@
1
+ export type AgentMap = Record<string, string>;
2
+ export type AgentNameMap = Record<string, string>;
3
+ export type AllowlistMap = Record<string, string[]>;
4
+
5
+ const mapKey = (station: string, accountId: string): string =>
6
+ `${station}/${accountId}`;
7
+
8
+ let agentMap: AgentMap = {};
9
+ let agentNames: AgentNameMap = {};
10
+ let allowlistMap: AllowlistMap = {};
11
+ let approversMap: AllowlistMap = {};
12
+ let disabledAccounts = new Set<string>();
13
+
14
+ export function setAgentMap(map: AgentMap, names: AgentNameMap): void {
15
+ agentMap = map;
16
+ agentNames = names;
17
+ }
18
+
19
+ export function setAllowlistMap(map: AllowlistMap): void {
20
+ allowlistMap = map;
21
+ }
22
+
23
+ export function setApproversMap(map: AllowlistMap): void {
24
+ approversMap = map;
25
+ }
26
+
27
+ export const approversForAccount = (station: string, accountId: string): string[] => approversMap[mapKey(station, accountId)] ?? [];
28
+
29
+ export function approversForLine(line: string): string[] {
30
+ const a = accountFromLine(line);
31
+ return a ? approversForAccount(a.station, a.accountId) : [];
32
+ }
33
+
34
+ export const mayApprove = (line: string, from: string): boolean => {
35
+ const approvers = approversForLine(line);
36
+ return approvers.length > 0 && senderMatchesAllowlist(approvers, from);
37
+ };
38
+
39
+ export function setDisabledAccounts(ids: Set<string>): void {
40
+ disabledAccounts = ids;
41
+ }
42
+
43
+ export const accountEnabled = (station: string, accountId: string): boolean => !disabledAccounts.has(mapKey(station, accountId));
44
+
45
+ export function lineReceives(line: string): boolean {
46
+ const a = accountFromLine(line);
47
+ return a === undefined || accountEnabled(a.station, a.accountId);
48
+ }
49
+
50
+ export function accountFromLine(
51
+ line: string,
52
+ ): { station: string; accountId: string } | undefined {
53
+ const parts = line.split('/');
54
+ const station = parts[2];
55
+ const accountId = parts[3];
56
+ if (!station || !accountId) return undefined;
57
+ return { station, accountId };
58
+ }
59
+
60
+ export function agentIdForAccount(
61
+ station: string,
62
+ accountId: string,
63
+ ): string | undefined {
64
+ return agentMap[mapKey(station, accountId)];
65
+ }
66
+
67
+ export function agentIdForLine(line: string): string | undefined {
68
+ const a = accountFromLine(line);
69
+ return a ? agentIdForAccount(a.station, a.accountId) : undefined;
70
+ }
71
+
72
+ export function agentForLine(line: string): string | undefined {
73
+ const id = agentIdForLine(line);
74
+ return id === undefined ? undefined : agentNames[id];
75
+ }
76
+
77
+ export interface KnownAccount {
78
+ station: string;
79
+ id: string;
80
+ agentId: string;
81
+ }
82
+
83
+ export function knownAccounts(): KnownAccount[] {
84
+ return Object.entries(agentMap).flatMap(([key, agentId]) => {
85
+ const cut = key.indexOf('/');
86
+ return cut === -1 ? [] : [{ station: key.slice(0, cut), id: key.slice(cut + 1), agentId }];
87
+ });
88
+ }
89
+
90
+ export function stationAgentIds(station: string): string[] {
91
+ const prefix = `${station}/`;
92
+ return Object.entries(agentMap)
93
+ .filter(([key]) => key.startsWith(prefix))
94
+ .map(([, id]) => id);
95
+ }
96
+
97
+ export function allowlistForAccount(station: string, accountId: string): string[] | undefined {
98
+ return allowlistMap[mapKey(station, accountId)];
99
+ }
100
+
101
+ export function allowlistForLine(line: string): string[] | undefined {
102
+ const a = accountFromLine(line);
103
+ return a ? allowlistMap[mapKey(a.station, a.accountId)] : undefined;
104
+ }
105
+
106
+ export function senderPermitted(
107
+ allowlist: string[] | undefined,
108
+ from: string,
109
+ verified?: boolean,
110
+ ): boolean {
111
+ if (allowlist === undefined || allowlist.length === 0 || allowlist.includes('*')) return true;
112
+ return verified !== false && senderMatchesAllowlist(allowlist, from);
113
+ }
114
+
115
+ export function senderMatchesAllowlist(
116
+ allowlist: string[],
117
+ from: string,
118
+ ): boolean {
119
+ if (allowlist.length === 0 || allowlist.includes('*')) return true;
120
+ const f = (from ?? '').toLowerCase();
121
+ const id = f.split('/').pop() ?? f;
122
+ return allowlist.some((a) => {
123
+ const v = a.toLowerCase();
124
+ return v === f || v === id || domainMatches(v, id);
125
+ });
126
+ }
127
+
128
+ const EMAIL_RE = /^[^@\s/]+@([^@\s/]+)$/;
129
+
130
+ function domainMatches(entry: string, id: string): boolean {
131
+ if (!entry.startsWith('@') || entry.length < 2) return false;
132
+ return EMAIL_RE.exec(id)?.[1] === entry.slice(1);
133
+ }
@@ -0,0 +1,27 @@
1
+ import type { IncomingMessage, ServerResponse } from 'node:http';
2
+ import { errMsg, log } from '@metro-labs/core/log';
3
+ import { bodyField, readJsonBody, sendJson } from '@metro-labs/http/api-http';
4
+ import type { StationName } from '@metro-labs/core/station-names';
5
+ import { normalizePolicy, type ToolPolicy } from '../policy/policy.js';
6
+
7
+ export type SetPolicy = (agentId: string, station: StationName, accountId: string, policy: ToolPolicy) => Promise<ToolPolicy>;
8
+
9
+ export async function handlePolicy(
10
+ req: IncomingMessage,
11
+ res: ServerResponse,
12
+ deps: { setPolicy: SetPolicy; reloadAgents: () => Promise<void> },
13
+ agentId: string,
14
+ target: { station: StationName; accountId: string },
15
+ ): Promise<void> {
16
+ const wanted = normalizePolicy(bodyField(await readJsonBody(req), 'policy'));
17
+ const policy = await deps.setPolicy(agentId, target.station, target.accountId, wanted);
18
+ log.info({ agentId, station: target.station, account: target.accountId, policy }, 'account-api: tool policy set');
19
+ const activated = await deps.reloadAgents().then(
20
+ () => true,
21
+ (err: unknown) => {
22
+ log.warn({ err: errMsg(err) }, 'account-api: policy reload failed, the change lands at the next boot');
23
+ return false;
24
+ },
25
+ );
26
+ sendJson(req, res, 200, { agentId, station: target.station, accountId: target.accountId, policy, activated });
27
+ }
@@ -2,8 +2,8 @@ import {
2
2
  accountFromLine,
3
3
  agentIdForAccount,
4
4
  stationAgentIds,
5
- } from './agent-map.js';
6
- import { STATIONS } from './schema.js';
5
+ } from './map.js';
6
+ import { STATIONS } from '@metro-labs/core/station-names';
7
7
 
8
8
  const ACCOUNT_STATIONS = new Set<string>(STATIONS);
9
9
 
@@ -0,0 +1,94 @@
1
+ import type { IncomingMessage, ServerResponse } from 'node:http';
2
+ import type { StationName } from '@metro-labs/core/station-names';
3
+ import { errMsg, log } from '@metro-labs/core/log';
4
+ import { sendJson } from '@metro-labs/http/api-http';
5
+ import { isRecord } from '@metro-labs/core/is-record';
6
+ import { stationByName } from '../stations/registry.js';
7
+ import { allowlistForAccount } from './map.js';
8
+ import type { RecentSender } from './senders.js';
9
+
10
+ export interface SenderCard {
11
+ id: string;
12
+ name?: string;
13
+ handle?: string;
14
+ avatar?: string;
15
+ }
16
+
17
+ export interface SenderCardDeps {
18
+ recentSenders: (station: StationName, accountId: string) => RecentSender[];
19
+ accountCall: (station: StationName, action: string, args: Record<string, unknown>) => Promise<unknown>;
20
+ }
21
+
22
+ const MAX_LOOKUPS = 50;
23
+ const LOOKUP_MS = 8_000;
24
+
25
+ const filled = (value: unknown): string | undefined => (typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined);
26
+
27
+ const AVATAR_DATA_MAX = 100_000;
28
+
29
+ const shownAvatar = (avatar: string): boolean =>
30
+ avatar.startsWith('https://') || (avatar.startsWith('data:image/') && avatar.length <= AVATAR_DATA_MAX);
31
+
32
+ function cardOf(id: string, profile: unknown, seenName: string | undefined): SenderCard {
33
+ const p = isRecord(profile) ? profile : {};
34
+ const display = filled(p.display_name);
35
+ const handle = filled(p.name);
36
+ const name = display ?? seenName ?? handle;
37
+ const avatar = filled(p.avatar);
38
+ return {
39
+ id,
40
+ ...(name === undefined ? {} : { name }),
41
+ ...(handle === undefined || handle === name ? {} : { handle }),
42
+ ...(avatar !== undefined && shownAvatar(avatar) ? { avatar } : {}),
43
+ };
44
+ }
45
+
46
+ async function lookup(deps: SenderCardDeps, station: StationName, accountId: string, user: string): Promise<unknown> {
47
+ let timer: ReturnType<typeof setTimeout> | undefined;
48
+ const late = new Promise<null>((resolve) => {
49
+ timer = setTimeout(() => {
50
+ resolve(null);
51
+ }, LOOKUP_MS);
52
+ });
53
+ try {
54
+ return await Promise.race([deps.accountCall(station, 'profile', { account: accountId, user }), late]);
55
+ } catch (err) {
56
+ log.info({ station, account: accountId, err: errMsg(err) }, 'account-api: could not read the profile of a listed sender');
57
+ return null;
58
+ } finally {
59
+ clearTimeout(timer);
60
+ }
61
+ }
62
+
63
+ export async function senderCards(deps: SenderCardDeps, station: StationName, accountId: string): Promise<SenderCard[]> {
64
+ const ids = (allowlistForAccount(station, accountId) ?? []).filter((id) => id !== '*' && !id.startsWith('@'));
65
+ const seen = new Map(deps.recentSenders(station, accountId).map((s) => [s.id.toLowerCase(), filled(s.name)]));
66
+ const reads = stationByName(station)?.readsProfiles === true;
67
+ return Promise.all(
68
+ ids.map(async (id, at) => {
69
+ const profile = reads && at < MAX_LOOKUPS ? await lookup(deps, station, accountId, id) : null;
70
+ return cardOf(id, profile, seen.get(id.toLowerCase()));
71
+ }),
72
+ );
73
+ }
74
+
75
+ const known = (profile: unknown): boolean =>
76
+ isRecord(profile) && ['name', 'display_name', 'about', 'avatar', 'address'].some((key) => filled(profile[key]) !== undefined);
77
+
78
+ export async function unconfirmedSenders(deps: SenderCardDeps, station: StationName, accountId: string, ids: string[]): Promise<string[]> {
79
+ if (stationByName(station)?.readsProfiles !== true || ids.length === 0) return [];
80
+ const seen = new Set(deps.recentSenders(station, accountId).map((s) => s.id.toLowerCase()));
81
+ const checks = await Promise.all(
82
+ ids.map(async (id) => (seen.has(id.toLowerCase()) || known(await lookup(deps, station, accountId, id)) ? null : id)),
83
+ );
84
+ return checks.filter((id): id is string => id !== null);
85
+ }
86
+
87
+ export async function handleSenderCards(
88
+ req: IncomingMessage,
89
+ res: ServerResponse,
90
+ deps: SenderCardDeps,
91
+ target: { station: StationName; accountId: string },
92
+ ): Promise<void> {
93
+ sendJson(req, res, 200, { senders: await senderCards(deps, target.station, target.accountId) });
94
+ }
@@ -0,0 +1,38 @@
1
+ import { bufferedSince, type MetroEvent } from '@metro-labs/core/events';
2
+ import { accountFromLine } from './map.js';
3
+
4
+ export interface RecentSender {
5
+ id: string;
6
+ name: string;
7
+ at: string;
8
+ }
9
+
10
+ const DEFAULT_LIMIT = 20;
11
+
12
+ const SKIP = new Set(['', 'self', 'unknown']);
13
+
14
+ function sameAccount(from: string, station: string, accountId: string): boolean {
15
+ const account = accountFromLine(from);
16
+ return account?.station === station && account.accountId === accountId;
17
+ }
18
+
19
+ function senderOf(event: MetroEvent, station: string, accountId: string): { id: string; name: string } | null {
20
+ const from = String(event.from);
21
+ if (event.station !== station || !sameAccount(from, station, accountId)) return null;
22
+ const id = from.split('/').pop() ?? '';
23
+ if (SKIP.has(id)) return null;
24
+ return { id, name: event.fromDisplayName ?? event.fromName ?? '' };
25
+ }
26
+
27
+ export function recentSenders(station: string, accountId: string, limit = DEFAULT_LIMIT): RecentSender[] {
28
+ const seen = new Set<string>();
29
+ const out: RecentSender[] = [];
30
+ for (const { event } of bufferedSince(0).reverse()) {
31
+ const sender = senderOf(event, station, accountId);
32
+ if (sender === null || seen.has(sender.id.toLowerCase())) continue;
33
+ seen.add(sender.id.toLowerCase());
34
+ out.push({ ...sender, at: event.ts });
35
+ if (out.length >= limit) break;
36
+ }
37
+ return out;
38
+ }
@@ -0,0 +1,55 @@
1
+ import type { IncomingMessage, ServerResponse } from 'node:http';
2
+ import { ApiError } from '@metro-labs/http/api-error';
3
+ import { apiFailure, apiSession, bodyField, cors, readJsonBody, sendJson } from '@metro-labs/http/api-http';
4
+ import { answerPrompt, pendingPrompts, type Behavior, type PendingPrompt } from './pending.js';
5
+
6
+ const PREFIX = '/api/approvals';
7
+ const ID_RE = /^[a-km-z]{5}$/;
8
+
9
+ const approvalView = (p: PendingPrompt): Record<string, unknown> => ({
10
+ id: p.requestId,
11
+ tool: p.tool,
12
+ description: p.description,
13
+ preview: p.preview,
14
+ line: p.line ?? null,
15
+ requestedAt: new Date(p.at).toISOString(),
16
+ });
17
+
18
+ function decisionOf(body: unknown): Behavior {
19
+ const value = bodyField(body, 'decision');
20
+ if (value !== 'allow' && value !== 'deny') throw new ApiError("decision is 'allow' or 'deny'", 400);
21
+ return value;
22
+ }
23
+
24
+ async function answer(req: IncomingMessage, id: string | undefined, subject: string): Promise<unknown> {
25
+ if (id === undefined) {
26
+ if (req.method !== 'GET') throw new ApiError('method not allowed', 405);
27
+ return { approvals: pendingPrompts().map(approvalView) };
28
+ }
29
+ if (req.method !== 'POST') throw new ApiError('method not allowed', 405);
30
+ if (!ID_RE.test(id)) throw new ApiError('no such approval', 404);
31
+ const decision = decisionOf(await readJsonBody(req));
32
+ const answered = await answerPrompt(id, decision, 'page', subject);
33
+ if (answered === undefined) throw new ApiError('no such approval', 404);
34
+ return { approval: approvalView(answered), decision };
35
+ }
36
+
37
+ export function handleApprovalsRequest(req: IncomingMessage, res: ServerResponse): boolean {
38
+ const path = (req.url ?? '').split('?')[0] ?? '';
39
+ if (path !== PREFIX && !path.startsWith(`${PREFIX}/`)) return false;
40
+ const rest = path.slice(PREFIX.length + 1).split('/').filter(Boolean);
41
+ if (rest.length > 1) return false;
42
+ if (req.method === 'OPTIONS') {
43
+ res.writeHead(204, cors(req)).end();
44
+ return true;
45
+ }
46
+ apiSession(req)
47
+ .then(async (session) => {
48
+ if (!session) throw new ApiError('unauthorized', 401);
49
+ sendJson(req, res, 200, await answer(req, rest[0], session.subject));
50
+ })
51
+ .catch((err: unknown) => {
52
+ apiFailure(req, res, err, 'approvals-api');
53
+ });
54
+ return true;
55
+ }
@@ -0,0 +1,150 @@
1
+ import { errMsg, log } from '@metro-labs/core/log';
2
+ import { previewMatches } from './preview.js';
3
+
4
+ export const NEEDS_APPROVAL = (where: string, tool: string): string =>
5
+ `Needs the owner's approval for ${where} (${tool}). Make this exact call from a background worker so Claude Code asks the owner in chat, and wait for the answer. An approval given only in the terminal does not count.`;
6
+
7
+ export type Behavior = 'allow' | 'deny';
8
+
9
+ export type AnsweredVia = 'chat' | 'page' | 'expiry';
10
+
11
+ export interface PendingPrompt {
12
+ requestId: string;
13
+ tool: string;
14
+ description: string;
15
+ preview: string;
16
+ line: string | undefined;
17
+ at: number;
18
+ }
19
+
20
+ interface Held extends PendingPrompt {
21
+ owner: object;
22
+ send: (behavior: Behavior) => Promise<void>;
23
+ tell: ((text: string) => Promise<void>) | undefined;
24
+ }
25
+
26
+ const PENDING_MAX = 500;
27
+ const SWEEP_MS = 60_000;
28
+ const APPROVAL_TTL_MS = 24 * 3_600_000;
29
+
30
+ const held = new Map<string, Held>();
31
+
32
+ interface Grant {
33
+ tool: string;
34
+ preview: string;
35
+ at: number;
36
+ }
37
+
38
+ const GRANT_TTL_MS = 10 * 60_000;
39
+ const GRANTS_MAX = 200;
40
+ let grants: Grant[] = [];
41
+
42
+ function grant(entry: Held, now = Date.now()): void {
43
+ grants = [...grants.filter((g) => now - g.at < GRANT_TTL_MS), { tool: entry.tool, preview: entry.preview, at: now }].slice(-GRANTS_MAX);
44
+ }
45
+
46
+ export function takeGrant(toolMatches: (tool: string) => boolean, args: Record<string, unknown>, now = Date.now()): boolean {
47
+ const at = grants.findIndex((g) => now - g.at < GRANT_TTL_MS && toolMatches(g.tool) && previewMatches(g.preview, args));
48
+ if (at < 0) return false;
49
+ grants = grants.filter((_, i) => i !== at);
50
+ return true;
51
+ }
52
+
53
+ const shown = ({ requestId, tool, description, preview, line, at }: Held): PendingPrompt => ({
54
+ requestId,
55
+ tool,
56
+ description,
57
+ preview,
58
+ line,
59
+ at,
60
+ });
61
+
62
+ export function holdPrompt(
63
+ prompt: PendingPrompt,
64
+ owner: object,
65
+ send: (behavior: Behavior) => Promise<void>,
66
+ tell?: (text: string) => Promise<void>,
67
+ ): void {
68
+ held.set(prompt.requestId, { ...prompt, owner, send, tell });
69
+ while (held.size > PENDING_MAX) {
70
+ const oldest = held.keys().next();
71
+ if (oldest.done) break;
72
+ held.delete(oldest.value);
73
+ }
74
+ }
75
+
76
+ export const pendingPrompts = (): PendingPrompt[] => [...held.values()].map(shown).sort((a, b) => b.at - a.at);
77
+
78
+ export const promptLine = (requestId: string): string | undefined => held.get(requestId)?.line;
79
+
80
+ function chatNotice(via: AnsweredVia, behavior: Behavior): string | undefined {
81
+ if (via === 'expiry') return 'Expired, denied.';
82
+ if (via === 'page') return behavior === 'allow' ? 'Approved on the page.' : 'Denied on the page.';
83
+ return undefined;
84
+ }
85
+
86
+ async function tellChat(entry: Held, via: AnsweredVia, behavior: Behavior): Promise<void> {
87
+ const text = chatNotice(via, behavior);
88
+ if (text === undefined || entry.tell === undefined) return;
89
+ await entry.tell(text).catch((err: unknown) => {
90
+ log.warn({ requestId: entry.requestId, err: errMsg(err) }, 'approvals: the chat could not be told the answer');
91
+ });
92
+ }
93
+
94
+ export async function answerPrompt(
95
+ requestId: string,
96
+ behavior: Behavior,
97
+ via: AnsweredVia,
98
+ who: string = via,
99
+ ): Promise<PendingPrompt | undefined> {
100
+ const entry = held.get(requestId);
101
+ if (entry === undefined) return undefined;
102
+ held.delete(requestId);
103
+ if (behavior === 'allow' && via !== 'expiry') grant(entry);
104
+ log.info({ requestId, tool: entry.tool, behavior, by: who === via ? via : `${via} ${who}` }, 'approvals: a Claude Code permission prompt answered');
105
+ await entry.send(behavior);
106
+ await tellChat(entry, via, behavior);
107
+ return shown(entry);
108
+ }
109
+
110
+ export function forgetPromptsOf(owner: object): void {
111
+ for (const [id, entry] of held) if (entry.owner === owner) held.delete(id);
112
+ }
113
+
114
+ export function settlePrompts(toolMatches: (tool: string) => boolean, args: Record<string, unknown>): void {
115
+ for (const [id, entry] of held)
116
+ if (toolMatches(entry.tool) && previewMatches(entry.preview, args)) {
117
+ held.delete(id);
118
+ log.info({ requestId: id, tool: entry.tool }, 'approvals: the call reached metro, so Claude Code already closed the prompt');
119
+ }
120
+ }
121
+
122
+ export const settlePromptsFor = (name: string, args: Record<string, unknown>): void => {
123
+ settlePrompts((tool) => tool.endsWith(`__${name}`), args);
124
+ };
125
+
126
+ export async function expirePrompts(now = Date.now(), ttl = APPROVAL_TTL_MS): Promise<number> {
127
+ const overdue = [...held.values()].filter((entry) => now - entry.at >= ttl);
128
+ for (const entry of overdue)
129
+ await answerPrompt(entry.requestId, 'deny', 'expiry').catch((err: unknown) => {
130
+ log.warn({ requestId: entry.requestId, err: errMsg(err) }, 'approvals: the expiry answer could not be sent');
131
+ });
132
+ return overdue.length;
133
+ }
134
+
135
+ export function startPromptExpiry(): () => void {
136
+ const timer = setInterval(() => {
137
+ expirePrompts().catch((err: unknown) => {
138
+ log.warn({ err: errMsg(err) }, 'approvals: the expiry sweep failed');
139
+ });
140
+ }, SWEEP_MS);
141
+ timer.unref();
142
+ return () => {
143
+ clearInterval(timer);
144
+ };
145
+ }
146
+
147
+ export function forgetAllPrompts(): void {
148
+ held.clear();
149
+ grants = [];
150
+ }