@vellumai/assistant 0.6.1 → 0.6.3

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 (463) hide show
  1. package/bun.lock +40 -40
  2. package/bunfig.toml +3 -0
  3. package/docker-entrypoint.sh +12 -2
  4. package/docs/architecture/memory.md +1 -1
  5. package/node_modules/@vellumai/ces-contracts/src/handles.ts +7 -9
  6. package/node_modules/@vellumai/ces-contracts/src/rpc.ts +42 -0
  7. package/openapi.yaml +184 -69
  8. package/package.json +41 -41
  9. package/scripts/generate-openapi.ts +1 -2
  10. package/src/__tests__/acp-session.test.ts +43 -0
  11. package/src/__tests__/app-builder-tool-scripts.test.ts +1 -0
  12. package/src/__tests__/app-executors.test.ts +1 -0
  13. package/src/__tests__/app-source-watcher.test.ts +37 -11
  14. package/src/__tests__/approval-routes-http.test.ts +178 -1
  15. package/src/__tests__/assistant-event-hub.test.ts +30 -0
  16. package/src/__tests__/browser-fill-credential.test.ts +229 -94
  17. package/src/__tests__/browser-manager.test.ts +40 -27
  18. package/src/__tests__/catalog-files.test.ts +862 -0
  19. package/src/__tests__/channel-approvals.test.ts +53 -0
  20. package/src/__tests__/checker.test.ts +104 -170
  21. package/src/__tests__/cli-command-risk-guard.test.ts +1 -1
  22. package/src/__tests__/config-managed-gemini-defaults.test.ts +326 -0
  23. package/src/__tests__/config-schema-cmd.test.ts +2 -2
  24. package/src/__tests__/config-schema.test.ts +125 -48
  25. package/src/__tests__/confirmation-request-guardian-bridge.test.ts +23 -0
  26. package/src/__tests__/context-overflow-approval.test.ts +21 -6
  27. package/src/__tests__/conversation-agent-loop-overflow.test.ts +1 -1
  28. package/src/__tests__/conversation-agent-loop.test.ts +1 -1
  29. package/src/__tests__/conversation-analysis-routes.test.ts +169 -0
  30. package/src/__tests__/conversation-attachments.test.ts +80 -4
  31. package/src/__tests__/conversation-confirmation-signals.test.ts +155 -0
  32. package/src/__tests__/conversation-directories-parse.test.ts +105 -0
  33. package/src/__tests__/conversation-fork-crud.test.ts +17 -0
  34. package/src/__tests__/conversation-history-web-search.test.ts +1 -0
  35. package/src/__tests__/conversation-host-access-routes.test.ts +229 -0
  36. package/src/__tests__/conversation-inject-context.test.ts +103 -0
  37. package/src/__tests__/conversation-queue.test.ts +45 -2
  38. package/src/__tests__/conversation-routes-disk-view.test.ts +5 -0
  39. package/src/__tests__/conversation-routes-guardian-reply.test.ts +16 -0
  40. package/src/__tests__/conversation-routes-slash-commands.test.ts +1 -0
  41. package/src/__tests__/conversation-runtime-assembly.test.ts +269 -46
  42. package/src/__tests__/conversation-starter-routes.test.ts +126 -0
  43. package/src/__tests__/conversation-starters-cadence.test.ts +161 -0
  44. package/src/__tests__/conversation-store.test.ts +195 -0
  45. package/src/__tests__/conversation-workspace-cache-state.test.ts +193 -0
  46. package/src/__tests__/credential-execution-approval-bridge.test.ts +32 -3
  47. package/src/__tests__/credential-security-invariants.test.ts +1 -0
  48. package/src/__tests__/credential-vault-unit.test.ts +4 -4
  49. package/src/__tests__/credential-vault.test.ts +152 -13
  50. package/src/__tests__/credentials-cli.test.ts +2 -2
  51. package/src/__tests__/date-context.test.ts +4 -4
  52. package/src/__tests__/embedding-managed-proxy-selection.test.ts +256 -0
  53. package/src/__tests__/extension-id-sync-guard.test.ts +155 -0
  54. package/src/__tests__/fixtures/mock-chrome-extension.ts +375 -0
  55. package/src/__tests__/gateway-only-guard.test.ts +3 -0
  56. package/src/__tests__/gemini-provider.test.ts +2 -2
  57. package/src/__tests__/guardian-routing-invariants.test.ts +70 -2
  58. package/src/__tests__/headless-browser-interactions.test.ts +707 -371
  59. package/src/__tests__/headless-browser-navigate.test.ts +389 -47
  60. package/src/__tests__/headless-browser-read-tools.test.ts +266 -103
  61. package/src/__tests__/headless-browser-snapshot.test.ts +240 -77
  62. package/src/__tests__/host-bash-proxy.test.ts +150 -1
  63. package/src/__tests__/host-browser-e2e-cloud.test.ts +462 -0
  64. package/src/__tests__/host-browser-e2e-self-hosted-capability.test.ts +286 -0
  65. package/src/__tests__/host-browser-e2e-self-hosted.test.ts +374 -0
  66. package/src/__tests__/host-browser-event-routes.test.ts +350 -0
  67. package/src/__tests__/host-browser-proxy.test.ts +444 -0
  68. package/src/__tests__/host-browser-routes.test.ts +198 -0
  69. package/src/__tests__/host-browser-ws-events-e2e.test.ts +320 -0
  70. package/src/__tests__/host-cu-proxy.test.ts +171 -1
  71. package/src/__tests__/host-file-proxy.test.ts +185 -1
  72. package/src/__tests__/host-file-read-tool.test.ts +52 -0
  73. package/src/__tests__/host-proxy-interface.test.ts +165 -0
  74. package/src/__tests__/host-shell-tool.test.ts +1 -11
  75. package/src/__tests__/http-user-message-parity.test.ts +1 -0
  76. package/src/__tests__/init-feature-flag-overrides.test.ts +167 -0
  77. package/src/__tests__/inline-command-runner.test.ts +7 -5
  78. package/src/__tests__/integration-status.test.ts +6 -7
  79. package/src/__tests__/list-messages-tool-merge.test.ts +37 -12
  80. package/src/__tests__/log-export-workspace.test.ts +190 -0
  81. package/src/__tests__/managed-credential-catalog-cli.test.ts +12 -14
  82. package/src/__tests__/mcp-client-auth.test.ts +40 -4
  83. package/src/__tests__/mcp-health-check.test.ts +10 -3
  84. package/src/__tests__/migration-cross-version-compatibility.test.ts +3 -1
  85. package/src/__tests__/migration-export-http.test.ts +61 -2
  86. package/src/__tests__/migration-export-streaming.test.ts +66 -0
  87. package/src/__tests__/migration-import-commit-http.test.ts +101 -1
  88. package/src/__tests__/native-host-marker-sync-guard.test.ts +157 -0
  89. package/src/__tests__/navigate-settings-tab.test.ts +14 -1
  90. package/src/__tests__/notification-broadcaster.test.ts +65 -0
  91. package/src/__tests__/oauth-apps-routes.test.ts +17 -12
  92. package/src/__tests__/oauth-cli.test.ts +707 -60
  93. package/src/__tests__/oauth-connect-orchestrator.test.ts +116 -24
  94. package/src/__tests__/oauth-provider-seed-logos.test.ts +23 -0
  95. package/src/__tests__/oauth-provider-serializer.test.ts +146 -10
  96. package/src/__tests__/oauth-provider-visibility.test.ts +19 -21
  97. package/src/__tests__/oauth-providers-routes.test.ts +50 -14
  98. package/src/__tests__/oauth-store.test.ts +1386 -182
  99. package/src/__tests__/oauth2-gateway-transport.test.ts +211 -20
  100. package/src/__tests__/onboarding-template-contract.test.ts +74 -55
  101. package/src/__tests__/openai-provider.test.ts +2 -2
  102. package/src/__tests__/outlook-categories.test.ts +1 -1
  103. package/src/__tests__/outlook-client-automation.test.ts +1 -1
  104. package/src/__tests__/outlook-compose-tools.test.ts +1 -1
  105. package/src/__tests__/outlook-email-watcher.test.ts +1 -1
  106. package/src/__tests__/outlook-follow-up.test.ts +1 -1
  107. package/src/__tests__/outlook-messaging-provider.test.ts +2 -2
  108. package/src/__tests__/outlook-trash.test.ts +1 -1
  109. package/src/__tests__/outlook-unsubscribe.test.ts +1 -1
  110. package/src/__tests__/permission-checker-host-gate.test.ts +74 -14
  111. package/src/__tests__/permission-mode.test.ts +28 -56
  112. package/src/__tests__/pkb-autoinject.test.ts +96 -0
  113. package/src/__tests__/platform-callback-registration.test.ts +19 -0
  114. package/src/__tests__/post-turn-tool-result-truncation.test.ts +296 -0
  115. package/src/__tests__/proxy-approval-callback.test.ts +18 -0
  116. package/src/__tests__/require-fresh-approval.test.ts +40 -3
  117. package/src/__tests__/sandbox-diagnostics.test.ts +1 -32
  118. package/src/__tests__/sanitize-config-for-transfer.test.ts +132 -0
  119. package/src/__tests__/schedule-routes.test.ts +162 -0
  120. package/src/__tests__/secret-detection-handler.test.ts +84 -0
  121. package/src/__tests__/secret-ingress-http.test.ts +1 -0
  122. package/src/__tests__/send-endpoint-busy.test.ts +3 -0
  123. package/src/__tests__/set-permission-mode.test.ts +13 -250
  124. package/src/__tests__/skills-file-content-endpoint.test.ts +670 -0
  125. package/src/__tests__/skills-files-catalog-fallback.test.ts +450 -0
  126. package/src/__tests__/slack-channel-config.test.ts +12 -15
  127. package/src/__tests__/subagent-detail.test.ts +44 -2
  128. package/src/__tests__/subagent-disposal.test.ts +1 -0
  129. package/src/__tests__/subagent-fork-notifications.test.ts +291 -0
  130. package/src/__tests__/subagent-fork-spawn.test.ts +384 -0
  131. package/src/__tests__/subagent-manager-notify.test.ts +1 -0
  132. package/src/__tests__/subagent-notify-parent.test.ts +1 -0
  133. package/src/__tests__/subagent-spawn-tool-fork.test.ts +411 -0
  134. package/src/__tests__/subagent-tools.test.ts +1 -0
  135. package/src/__tests__/subagent-types.test.ts +1 -0
  136. package/src/__tests__/system-prompt-ask-mode.test.ts +27 -71
  137. package/src/__tests__/system-prompt.test.ts +72 -1
  138. package/src/__tests__/task-scheduler.test.ts +32 -6
  139. package/src/__tests__/telegram-config.test.ts +10 -13
  140. package/src/__tests__/terminal-sandbox.test.ts +1 -1
  141. package/src/__tests__/terminal-tools.test.ts +11 -5
  142. package/src/__tests__/test-preload.ts +14 -0
  143. package/src/__tests__/tool-approval-handler.test.ts +73 -0
  144. package/src/__tests__/tool-domain-event-publisher.test.ts +0 -1
  145. package/src/__tests__/tool-executor-lifecycle-events.test.ts +1 -8
  146. package/src/__tests__/tool-executor.test.ts +0 -1
  147. package/src/__tests__/tool-side-effects-slack-dm.test.ts +22 -0
  148. package/src/__tests__/top-level-renderer.test.ts +73 -1
  149. package/src/__tests__/transport-hints-queue.test.ts +62 -0
  150. package/src/__tests__/trust-store.test.ts +4 -4
  151. package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +109 -0
  152. package/src/__tests__/v2-consent-policy.test.ts +103 -0
  153. package/src/__tests__/workspace-migration-030-seed-pkb-autoinject.test.ts +168 -0
  154. package/src/__tests__/workspace-policy.test.ts +2 -7
  155. package/src/acp/client-handler.ts +30 -4
  156. package/src/agent/loop.ts +12 -35
  157. package/src/approvals/guardian-request-resolvers.ts +21 -15
  158. package/src/browser-session/__tests__/manager.test.ts +297 -0
  159. package/src/browser-session/backends/cdp-inspect.ts +30 -0
  160. package/src/browser-session/backends/extension.ts +26 -0
  161. package/src/browser-session/backends/local.ts +24 -0
  162. package/src/browser-session/events.ts +164 -0
  163. package/src/browser-session/index.ts +27 -0
  164. package/src/browser-session/manager.ts +159 -0
  165. package/src/browser-session/types.ts +28 -0
  166. package/src/channels/__tests__/types.test.ts +134 -0
  167. package/src/channels/types.ts +55 -0
  168. package/src/cli/__tests__/run-assistant-command.ts +34 -7
  169. package/src/cli/__tests__/unknown-command.test.ts +33 -0
  170. package/src/cli/commands/browser-relay.ts +339 -409
  171. package/src/cli/commands/credentials.ts +3 -3
  172. package/src/cli/commands/default-action.ts +68 -1
  173. package/src/cli/commands/email.ts +18 -13
  174. package/src/cli/commands/mcp.ts +16 -4
  175. package/src/cli/commands/oauth/__tests__/connect.test.ts +68 -41
  176. package/src/cli/commands/oauth/__tests__/disconnect.test.ts +21 -21
  177. package/src/cli/commands/oauth/__tests__/mode.test.ts +17 -17
  178. package/src/cli/commands/oauth/__tests__/ping.test.ts +16 -16
  179. package/src/cli/commands/oauth/__tests__/providers-delete.test.ts +31 -33
  180. package/src/cli/commands/oauth/__tests__/providers-register.test.ts +329 -0
  181. package/src/cli/commands/oauth/__tests__/providers-update.test.ts +116 -12
  182. package/src/cli/commands/oauth/__tests__/status.test.ts +10 -10
  183. package/src/cli/commands/oauth/__tests__/token.test.ts +7 -7
  184. package/src/cli/commands/oauth/apps.ts +7 -4
  185. package/src/cli/commands/oauth/connect.ts +16 -2
  186. package/src/cli/commands/oauth/disconnect.ts +1 -1
  187. package/src/cli/commands/oauth/providers.ts +200 -36
  188. package/src/cli/commands/oauth/shared.ts +5 -5
  189. package/src/cli/commands/platform/__tests__/callback-routes-list.test.ts +259 -0
  190. package/src/cli/commands/platform/__tests__/connect.test.ts +1 -1
  191. package/src/cli/commands/platform/__tests__/disconnect.test.ts +1 -1
  192. package/src/cli/commands/platform/__tests__/status.test.ts +1 -1
  193. package/src/cli/commands/platform/index.ts +107 -10
  194. package/src/cli/commands/usage.ts +10 -9
  195. package/src/cli/lib/daemon-credential-client.ts +4 -0
  196. package/src/cli/program.ts +10 -3
  197. package/src/config/assistant-feature-flags.ts +59 -55
  198. package/src/config/bundled-skills/app-builder/SKILL.md +33 -173
  199. package/src/config/bundled-skills/app-builder/references/CUSTOM_ROUTES.md +105 -0
  200. package/src/config/bundled-skills/app-builder/references/INTERACTION_HOOKS.md +56 -0
  201. package/src/config/bundled-skills/app-builder/references/WIDGETS.md +125 -0
  202. package/src/config/bundled-skills/contacts/SKILL.md +3 -0
  203. package/src/config/bundled-skills/document/SKILL.md +4 -0
  204. package/src/config/bundled-skills/gmail/SKILL.md +12 -7
  205. package/src/config/bundled-skills/gmail/TOOLS.json +1 -1
  206. package/src/config/bundled-skills/gmail/tools/gmail-sender-digest.ts +2 -1
  207. package/src/config/bundled-skills/outlook/SKILL.md +7 -0
  208. package/src/config/bundled-skills/settings/TOOLS.json +1 -1
  209. package/src/config/bundled-skills/settings/tools/navigate-settings-tab.ts +8 -3
  210. package/src/config/bundled-skills/subagent/SKILL.md +21 -0
  211. package/src/config/bundled-skills/subagent/TOOLS.json +8 -4
  212. package/src/config/bundled-skills/tasks/SKILL.md +5 -0
  213. package/src/config/env-registry.ts +14 -0
  214. package/src/config/env.ts +21 -0
  215. package/src/config/feature-flag-registry.json +46 -7
  216. package/src/config/loader.ts +56 -1
  217. package/src/config/sanitize-for-transfer.ts +47 -0
  218. package/src/config/schema.ts +46 -5
  219. package/src/config/schemas/host-browser.ts +66 -0
  220. package/src/config/schemas/memory-lifecycle.ts +1 -1
  221. package/src/config/schemas/memory-retrieval.ts +103 -0
  222. package/src/config/schemas/security.ts +0 -6
  223. package/src/config/schemas/services.ts +16 -0
  224. package/src/config/types.ts +0 -1
  225. package/src/context/post-turn-tool-result-truncation.ts +176 -0
  226. package/src/context/window-manager.ts +19 -1
  227. package/src/credential-execution/approval-bridge.ts +49 -16
  228. package/src/credential-execution/managed-catalog.ts +3 -7
  229. package/src/daemon/__tests__/conversation-tool-setup.test.ts +186 -0
  230. package/src/daemon/app-source-watcher.ts +35 -0
  231. package/src/daemon/config-watcher.ts +6 -2
  232. package/src/daemon/context-overflow-approval.ts +5 -1
  233. package/src/daemon/conversation-agent-loop-handlers.ts +17 -2
  234. package/src/daemon/conversation-agent-loop.ts +74 -19
  235. package/src/daemon/conversation-attachments.ts +40 -1
  236. package/src/daemon/conversation-messaging.ts +3 -0
  237. package/src/daemon/conversation-process.ts +66 -3
  238. package/src/daemon/conversation-queue-manager.ts +8 -0
  239. package/src/daemon/conversation-runtime-assembly.ts +159 -20
  240. package/src/daemon/conversation-surfaces.ts +78 -12
  241. package/src/daemon/conversation-tool-setup.ts +74 -11
  242. package/src/daemon/conversation-workspace.ts +12 -0
  243. package/src/daemon/conversation.ts +227 -11
  244. package/src/daemon/date-context.ts +10 -10
  245. package/src/daemon/first-greeting.ts +3 -2
  246. package/src/daemon/handlers/conversations.ts +9 -139
  247. package/src/daemon/handlers/shared.ts +65 -0
  248. package/src/daemon/handlers/skills.ts +232 -37
  249. package/src/daemon/host-bash-proxy.ts +48 -13
  250. package/src/daemon/host-browser-proxy.ts +191 -0
  251. package/src/daemon/host-cu-proxy.ts +36 -11
  252. package/src/daemon/host-file-proxy.ts +57 -9
  253. package/src/daemon/lifecycle.ts +86 -12
  254. package/src/daemon/message-protocol.ts +7 -0
  255. package/src/daemon/message-types/conversations.ts +59 -13
  256. package/src/daemon/message-types/host-browser.ts +100 -0
  257. package/src/daemon/message-types/messages.ts +5 -6
  258. package/src/daemon/message-types/notifications.ts +12 -0
  259. package/src/daemon/message-types/settings.ts +12 -0
  260. package/src/daemon/message-types/skills.ts +10 -0
  261. package/src/daemon/message-types/subagents.ts +2 -0
  262. package/src/daemon/server.ts +112 -35
  263. package/src/daemon/tool-side-effects.ts +6 -0
  264. package/src/daemon/transport-hints.ts +14 -0
  265. package/src/inbound/platform-callback-registration.ts +18 -17
  266. package/src/index.ts +1 -1
  267. package/src/mcp/client.ts +59 -24
  268. package/src/memory/app-store.ts +31 -1
  269. package/src/memory/conversation-crud.ts +38 -10
  270. package/src/memory/conversation-directories.ts +39 -0
  271. package/src/memory/conversation-group-migration.ts +65 -5
  272. package/src/memory/conversation-starters-cadence.ts +76 -0
  273. package/src/memory/conversation-title-service.ts +5 -2
  274. package/src/memory/db-init.ts +12 -0
  275. package/src/memory/embedding-backend.test.ts +75 -0
  276. package/src/memory/embedding-backend.ts +131 -5
  277. package/src/memory/embedding-gemini.test.ts +54 -0
  278. package/src/memory/embedding-gemini.ts +20 -9
  279. package/src/memory/embedding-local.ts +177 -18
  280. package/src/memory/graph/capability-seed.ts +3 -5
  281. package/src/memory/graph/consolidation.ts +10 -23
  282. package/src/memory/graph/extraction-job.ts +15 -0
  283. package/src/memory/graph/retriever.ts +40 -22
  284. package/src/memory/graph/store.test.ts +7 -3
  285. package/src/memory/graph/store.ts +47 -12
  286. package/src/memory/group-crud.ts +25 -9
  287. package/src/memory/llm-usage-store.ts +45 -4
  288. package/src/memory/migrations/213-oauth-providers-scope-separator.ts +13 -0
  289. package/src/memory/migrations/214-oauth-providers-refresh-url.ts +11 -0
  290. package/src/memory/migrations/215-oauth-providers-revoke.ts +14 -0
  291. package/src/memory/migrations/216-oauth-providers-token-auth-method.ts +30 -0
  292. package/src/memory/migrations/217-conversation-host-access.ts +40 -0
  293. package/src/memory/migrations/218-oauth-providers-logo-url.ts +11 -0
  294. package/src/memory/migrations/index.ts +6 -0
  295. package/src/memory/migrations/registry.ts +8 -0
  296. package/src/memory/schema/conversations.ts +1 -0
  297. package/src/memory/schema/oauth.ts +18 -13
  298. package/src/messaging/provider.ts +1 -1
  299. package/src/notifications/broadcaster.ts +6 -0
  300. package/src/notifications/conversation-pairing.ts +12 -4
  301. package/src/notifications/emit-signal.ts +14 -0
  302. package/src/notifications/signal.ts +11 -0
  303. package/src/oauth/AGENTS.md +76 -0
  304. package/src/oauth/__tests__/identity-verifier.test.ts +24 -19
  305. package/src/oauth/__tests__/seed-providers-managed.test.ts +32 -0
  306. package/src/oauth/byo-connection.test.ts +8 -8
  307. package/src/oauth/byo-connection.ts +7 -7
  308. package/src/oauth/connect-orchestrator.ts +23 -21
  309. package/src/oauth/connect-types.ts +3 -3
  310. package/src/oauth/connection-resolver.test.ts +17 -4
  311. package/src/oauth/connection-resolver.ts +16 -16
  312. package/src/oauth/connection.ts +1 -1
  313. package/src/oauth/manual-token-connection.ts +13 -13
  314. package/src/oauth/oauth-store.ts +214 -100
  315. package/src/oauth/platform-connection.test.ts +5 -5
  316. package/src/oauth/platform-connection.ts +4 -4
  317. package/src/oauth/provider-serializer.ts +31 -5
  318. package/src/oauth/revoke.ts +76 -0
  319. package/src/oauth/seed-providers.ts +127 -87
  320. package/src/oauth/token-persistence.ts +1 -1
  321. package/src/permissions/checker.ts +3 -3
  322. package/src/permissions/defaults.ts +7 -8
  323. package/src/permissions/permission-mode.ts +4 -11
  324. package/src/permissions/prompter.ts +13 -3
  325. package/src/permissions/v2-consent-policy.ts +87 -0
  326. package/src/platform/client.ts +1 -1
  327. package/src/prompts/system-prompt.ts +18 -21
  328. package/src/prompts/templates/BOOTSTRAP-REFERENCE.md +3 -65
  329. package/src/prompts/templates/BOOTSTRAP.md +59 -96
  330. package/src/prompts/templates/SOUL.md +11 -11
  331. package/src/providers/anthropic/client.ts +1 -0
  332. package/src/providers/types.ts +1 -1
  333. package/src/runtime/AGENTS.md +23 -0
  334. package/src/runtime/__tests__/browser-extension-pair-routes.test.ts +715 -0
  335. package/src/runtime/__tests__/capability-tokens.test.ts +258 -0
  336. package/src/runtime/__tests__/chrome-extension-registry.test.ts +518 -0
  337. package/src/runtime/assistant-event-hub.ts +24 -2
  338. package/src/runtime/auth/__tests__/guard-tests.test.ts +1 -0
  339. package/src/runtime/auth/__tests__/middleware.test.ts +116 -1
  340. package/src/runtime/auth/__tests__/route-policy.test.ts +8 -0
  341. package/src/runtime/auth/middleware.ts +98 -0
  342. package/src/runtime/auth/route-policy.ts +6 -7
  343. package/src/runtime/auth/token-service.ts +8 -0
  344. package/src/runtime/capability-tokens.ts +414 -0
  345. package/src/runtime/channel-approvals.ts +18 -5
  346. package/src/runtime/chrome-extension-registry.ts +332 -0
  347. package/src/runtime/confirmation-request-guardian-bridge.ts +6 -0
  348. package/src/runtime/guardian-decision-types.ts +7 -0
  349. package/src/runtime/http-server.ts +425 -70
  350. package/src/runtime/migrations/__tests__/rebind-secrets-credentials.test.ts +172 -0
  351. package/src/runtime/migrations/__tests__/vbundle-builder-credentials.test.ts +276 -0
  352. package/src/runtime/migrations/__tests__/vbundle-import-credentials.test.ts +162 -0
  353. package/src/runtime/migrations/migration-transport.ts +6 -0
  354. package/src/runtime/migrations/migration-wizard.ts +22 -2
  355. package/src/runtime/migrations/rebind-secrets-screen.ts +76 -15
  356. package/src/runtime/migrations/vbundle-builder.ts +145 -38
  357. package/src/runtime/migrations/vbundle-import-analyzer.ts +19 -0
  358. package/src/runtime/migrations/vbundle-importer.ts +55 -5
  359. package/src/runtime/pending-interactions.ts +29 -13
  360. package/src/runtime/routes/approval-routes.ts +90 -16
  361. package/src/runtime/routes/browser-cdp-routes.ts +229 -0
  362. package/src/runtime/routes/browser-extension-pair-routes.ts +497 -0
  363. package/src/runtime/routes/conversation-analysis-routes.ts +18 -5
  364. package/src/runtime/routes/conversation-management-routes.ts +108 -0
  365. package/src/runtime/routes/conversation-routes.ts +308 -28
  366. package/src/runtime/routes/conversation-starter-routes.ts +78 -16
  367. package/src/runtime/routes/group-routes.ts +22 -8
  368. package/src/runtime/routes/guardian-action-routes.ts +24 -13
  369. package/src/runtime/routes/host-browser-routes.ts +279 -0
  370. package/src/runtime/routes/host-file-routes.ts +9 -1
  371. package/src/runtime/routes/identity-routes.ts +259 -16
  372. package/src/runtime/routes/log-export/AGENTS.md +104 -0
  373. package/src/runtime/routes/log-export/__tests__/workspace-allowlist-error-contract.test.ts +103 -0
  374. package/src/runtime/routes/log-export/__tests__/workspace-allowlist.test.ts +716 -0
  375. package/src/runtime/routes/log-export/workspace-allowlist.ts +458 -0
  376. package/src/runtime/routes/log-export-routes.ts +60 -25
  377. package/src/runtime/routes/memory-item-routes.ts +1 -7
  378. package/src/runtime/routes/migration-routes.ts +87 -2
  379. package/src/runtime/routes/oauth-apps.ts +15 -17
  380. package/src/runtime/routes/oauth-providers.ts +4 -0
  381. package/src/runtime/routes/schedule-routes.ts +24 -11
  382. package/src/runtime/routes/settings-routes.ts +9 -97
  383. package/src/runtime/routes/skills-routes.ts +52 -2
  384. package/src/runtime/routes/subagents-routes.ts +14 -10
  385. package/src/runtime/routes/usage-routes.ts +8 -7
  386. package/src/runtime/routes/workspace-routes.test.ts +22 -0
  387. package/src/runtime/routes/workspace-routes.ts +8 -1
  388. package/src/runtime/routes/workspace-utils.ts +2 -0
  389. package/src/schedule/scheduler.ts +7 -5
  390. package/src/security/ces-credential-client.ts +20 -0
  391. package/src/security/ces-rpc-credential-backend.ts +17 -0
  392. package/src/security/credential-backend.ts +5 -0
  393. package/src/security/oauth2.ts +42 -25
  394. package/src/security/secure-keys.ts +118 -25
  395. package/src/security/token-manager.ts +23 -10
  396. package/src/skills/catalog-files.ts +492 -0
  397. package/src/skills/inline-command-runner.ts +12 -14
  398. package/src/subagent/manager.ts +131 -26
  399. package/src/subagent/types.ts +19 -0
  400. package/src/tools/apps/executors.ts +11 -2
  401. package/src/tools/browser/__tests__/auth-detector.test.ts +202 -108
  402. package/src/tools/browser/auth-detector.ts +43 -12
  403. package/src/tools/browser/browser-execution.ts +645 -340
  404. package/src/tools/browser/browser-manager.ts +36 -12
  405. package/src/tools/browser/cdp-client/__tests__/accessibility-snapshot.test.ts +318 -0
  406. package/src/tools/browser/cdp-client/__tests__/cdp-dom-helpers.test.ts +1175 -0
  407. package/src/tools/browser/cdp-client/__tests__/cdp-inspect-client.test.ts +870 -0
  408. package/src/tools/browser/cdp-client/__tests__/extension-cdp-client.test.ts +330 -0
  409. package/src/tools/browser/cdp-client/__tests__/factory.test.ts +377 -0
  410. package/src/tools/browser/cdp-client/__tests__/fixtures/ax-tree-nested-frames.json +64 -0
  411. package/src/tools/browser/cdp-client/__tests__/fixtures/ax-tree-simple.json +69 -0
  412. package/src/tools/browser/cdp-client/__tests__/local-cdp-client.test.ts +310 -0
  413. package/src/tools/browser/cdp-client/__tests__/types.test.ts +96 -0
  414. package/src/tools/browser/cdp-client/accessibility-snapshot.ts +387 -0
  415. package/src/tools/browser/cdp-client/cdp-dom-helpers.ts +695 -0
  416. package/src/tools/browser/cdp-client/cdp-inspect/__tests__/discovery.test.ts +743 -0
  417. package/src/tools/browser/cdp-client/cdp-inspect/__tests__/ws-transport.test.ts +580 -0
  418. package/src/tools/browser/cdp-client/cdp-inspect/discovery.ts +578 -0
  419. package/src/tools/browser/cdp-client/cdp-inspect/ws-transport.ts +579 -0
  420. package/src/tools/browser/cdp-client/cdp-inspect-client.ts +635 -0
  421. package/src/tools/browser/cdp-client/errors.ts +34 -0
  422. package/src/tools/browser/cdp-client/extension-cdp-client.ts +125 -0
  423. package/src/tools/browser/cdp-client/factory.ts +204 -0
  424. package/src/tools/browser/cdp-client/index.ts +14 -0
  425. package/src/tools/browser/cdp-client/local-cdp-client.ts +187 -0
  426. package/src/tools/browser/cdp-client/types.ts +52 -0
  427. package/src/tools/filesystem/edit.ts +1 -1
  428. package/src/tools/filesystem/list.ts +1 -1
  429. package/src/tools/filesystem/read.ts +1 -1
  430. package/src/tools/filesystem/write.ts +2 -1
  431. package/src/tools/host-filesystem/edit.ts +1 -1
  432. package/src/tools/host-filesystem/read.ts +12 -15
  433. package/src/tools/host-filesystem/write.ts +1 -1
  434. package/src/tools/host-terminal/host-shell.ts +21 -16
  435. package/src/tools/permission-checker.ts +77 -100
  436. package/src/tools/registry.ts +0 -2
  437. package/src/tools/secret-detection-handler.ts +34 -1
  438. package/src/tools/shared/filesystem/image-read.ts +61 -40
  439. package/src/tools/skills/sandbox-runner.ts +3 -6
  440. package/src/tools/subagent/spawn.ts +47 -3
  441. package/src/tools/subagent/status.ts +2 -0
  442. package/src/tools/system/register.ts +2 -16
  443. package/src/tools/terminal/safe-env.ts +7 -0
  444. package/src/tools/terminal/sandbox-diagnostics.ts +4 -4
  445. package/src/tools/terminal/sandbox.ts +4 -1
  446. package/src/tools/terminal/shell.ts +24 -21
  447. package/src/tools/tool-approval-handler.ts +48 -2
  448. package/src/tools/types.ts +2 -3
  449. package/src/util/platform.ts +14 -19
  450. package/src/watcher/provider-types.ts +1 -1
  451. package/src/workspace/migrations/029-seed-pkb.ts +1 -0
  452. package/src/workspace/migrations/030-seed-pkb-autoinject.ts +73 -0
  453. package/src/workspace/migrations/registry.ts +2 -0
  454. package/src/workspace/top-level-renderer.ts +19 -1
  455. package/src/__tests__/chrome-cdp.test.ts +0 -419
  456. package/src/__tests__/permission-mode-sse.test.ts +0 -418
  457. package/src/__tests__/permission-mode-store.test.ts +0 -277
  458. package/src/browser-extension-relay/protocol.ts +0 -63
  459. package/src/browser-extension-relay/server.ts +0 -203
  460. package/src/config/schemas/sandbox.ts +0 -14
  461. package/src/permissions/permission-mode-store.ts +0 -180
  462. package/src/tools/browser/chrome-cdp.ts +0 -239
  463. package/src/tools/system/set-permission-mode.ts +0 -103
@@ -1,418 +0,0 @@
1
- /**
2
- * Tests for permission mode SSE broadcast and HTTP endpoints.
3
- *
4
- * Verifies:
5
- * - SSE `permission_mode_update` event is published on mode change
6
- * - GET /v1/permission-mode returns current state (always available)
7
- * - PUT /v1/permission-mode updates state and broadcasts (flag on)
8
- * - PUT /v1/permission-mode returns 404 when flag is off
9
- */
10
- import { existsSync, mkdirSync, rmSync } from "node:fs";
11
- import { join } from "node:path";
12
- import {
13
- afterAll,
14
- afterEach,
15
- beforeEach,
16
- describe,
17
- expect,
18
- mock,
19
- test,
20
- } from "bun:test";
21
-
22
- // ---------------------------------------------------------------------------
23
- // Mocks — declared before imports that depend on platform/logger
24
- // ---------------------------------------------------------------------------
25
-
26
- const WORKSPACE_DIR = process.env.VELLUM_WORKSPACE_DIR!;
27
- const CONFIG_PATH = join(WORKSPACE_DIR, "config.json");
28
-
29
- function ensureTestDir(): void {
30
- const dirs = [
31
- WORKSPACE_DIR,
32
- join(WORKSPACE_DIR, "data"),
33
- join(WORKSPACE_DIR, "data", "logs"),
34
- ];
35
- for (const dir of dirs) {
36
- if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
37
- }
38
- }
39
-
40
- function makeLoggerStub(): Record<string, unknown> {
41
- const stub: Record<string, unknown> = {};
42
- for (const m of [
43
- "info",
44
- "warn",
45
- "error",
46
- "debug",
47
- "trace",
48
- "fatal",
49
- "silent",
50
- "child",
51
- ]) {
52
- stub[m] = m === "child" ? () => makeLoggerStub() : () => {};
53
- }
54
- return stub;
55
- }
56
-
57
- mock.module("../util/logger.js", () => ({
58
- getLogger: () => makeLoggerStub(),
59
- }));
60
-
61
- let mockFeatureFlagEnabled = false;
62
-
63
- mock.module("../config/assistant-feature-flags.js", () => ({
64
- isAssistantFeatureFlagEnabled: () => mockFeatureFlagEnabled,
65
- _setOverridesForTesting: () => {},
66
- clearFeatureFlagOverridesCache: () => {},
67
- getAssistantFeatureFlagDefaults: () => ({}),
68
- }));
69
-
70
- mock.module("../config/loader.js", () => ({
71
- getConfig: () => ({
72
- ui: {},
73
- model: "test",
74
- provider: "test",
75
- memory: { enabled: false },
76
- rateLimit: { maxRequestsPerMinute: 0 },
77
- secretDetection: { enabled: false },
78
- permissions: {
79
- askBeforeActing: true,
80
- hostAccess: false,
81
- },
82
- }),
83
- loadConfig: () => ({
84
- permissions: {
85
- askBeforeActing: true,
86
- hostAccess: false,
87
- },
88
- }),
89
- loadRawConfig: () => ({}),
90
- saveRawConfig: () => {},
91
- invalidateConfigCache: () => {},
92
- }));
93
-
94
- // Heavy dependency stubs — prevent settings-routes.ts transitive imports from
95
- // reaching real OAuth orchestration, secure-key decryption, tool registry, etc.
96
- // Only the permission-mode GET/PUT handlers are exercised in this file, so these
97
- // stubs are never called.
98
- mock.module("../config/skills.js", () => ({
99
- loadSkillCatalog: () => [],
100
- }));
101
- mock.module("../config/env.js", () => ({
102
- getPlatformBaseUrl: () => "http://localhost",
103
- setIngressPublicBaseUrl: () => {},
104
- }));
105
- mock.module("../daemon/handlers/config-ingress.js", () => ({
106
- computeGatewayTarget: () => "",
107
- getIngressConfigResult: () => ({}),
108
- }));
109
- mock.module("../daemon/handlers/config-voice.js", () => ({
110
- normalizeActivationKey: () => ({ ok: true, value: "" }),
111
- }));
112
- mock.module("../oauth/connect-orchestrator.js", () => ({
113
- orchestrateOAuthConnect: async () => ({ success: false, error: "stub" }),
114
- }));
115
- mock.module("../oauth/oauth-store.js", () => ({
116
- getApp: () => undefined,
117
- getConnectionByProvider: () => undefined,
118
- getMostRecentAppByProvider: () => undefined,
119
- getProvider: () => undefined,
120
- }));
121
- mock.module("../security/secure-keys.js", () => ({
122
- getSecureKeyAsync: async () => undefined,
123
- }));
124
- mock.module("../skills/tool-manifest.js", () => ({
125
- parseToolManifestFile: () => ({ tools: [] }),
126
- }));
127
- mock.module("../tools/execution-target.js", () => ({
128
- resolveExecutionTarget: () => undefined,
129
- }));
130
- mock.module("../tools/registry.js", () => ({
131
- getAllTools: () => [],
132
- getTool: () => undefined,
133
- }));
134
- mock.module("../tools/schema-transforms.js", () => ({
135
- ACTIVITY_SKIP_SET: new Set(),
136
- injectActivityField: (defs: unknown[]) => defs,
137
- }));
138
- mock.module("../tools/side-effects.js", () => ({
139
- isSideEffectTool: () => false,
140
- }));
141
- mock.module("../tools/system/avatar-generator.js", () => ({
142
- generateAndSaveAvatar: async () => ({ isError: true, content: "stub" }),
143
- }));
144
- mock.module("../permissions/checker.js", () => ({
145
- check: async () => ({ decision: "allow", reason: "" }),
146
- classifyRisk: async () => "low",
147
- generateAllowlistOptions: async () => [],
148
- generateScopeOptions: () => [],
149
- }));
150
-
151
- afterAll(() => {
152
- mock.restore();
153
- });
154
-
155
- import {
156
- getMode,
157
- onModeChanged,
158
- resetForTesting,
159
- setAskBeforeActing,
160
- setHostAccess,
161
- } from "../permissions/permission-mode-store.js";
162
- import type { AssistantEvent } from "../runtime/assistant-event.js";
163
- import { AssistantEventHub } from "../runtime/assistant-event-hub.js";
164
- import { DAEMON_INTERNAL_ASSISTANT_ID } from "../runtime/assistant-scope.js";
165
- import type { RouteDefinition } from "../runtime/http-router.js";
166
- import { settingsRouteDefinitions } from "../runtime/routes/settings-routes.js";
167
-
168
- // ---------------------------------------------------------------------------
169
- // Route helpers — call actual route handlers
170
- // ---------------------------------------------------------------------------
171
-
172
- const routes = settingsRouteDefinitions();
173
-
174
- function getRoute(method: string, endpoint: string): RouteDefinition {
175
- const route = routes.find(
176
- (r) => r.method === method && r.endpoint === endpoint,
177
- );
178
- if (!route) throw new Error(`Route not found: ${method} ${endpoint}`);
179
- return route;
180
- }
181
-
182
- function callPut(
183
- body: Record<string, unknown>,
184
- ): Promise<Response> | Response {
185
- const req = new Request("http://localhost/v1/permission-mode", {
186
- method: "PUT",
187
- headers: { "Content-Type": "application/json" },
188
- body: JSON.stringify(body),
189
- });
190
- return getRoute("PUT", "permission-mode").handler({
191
- req,
192
- url: new URL(req.url),
193
- server: null as never,
194
- authContext: null as never,
195
- params: {},
196
- });
197
- }
198
-
199
- function callGet(): Promise<Response> | Response {
200
- const req = new Request("http://localhost/v1/permission-mode");
201
- return getRoute("GET", "permission-mode").handler({
202
- req,
203
- url: new URL(req.url),
204
- server: null as never,
205
- authContext: null as never,
206
- params: {},
207
- });
208
- }
209
-
210
- // ---------------------------------------------------------------------------
211
- // Setup / teardown
212
- // ---------------------------------------------------------------------------
213
-
214
- beforeEach(() => {
215
- ensureTestDir();
216
- resetForTesting();
217
- mockFeatureFlagEnabled = false;
218
- // Remove config file to start clean
219
- try {
220
- rmSync(CONFIG_PATH, { force: true });
221
- } catch {
222
- /* noop */
223
- }
224
- });
225
-
226
- afterEach(() => {
227
- resetForTesting();
228
- });
229
-
230
- // ---------------------------------------------------------------------------
231
- // Tests
232
- // ---------------------------------------------------------------------------
233
-
234
- describe("Permission mode SSE broadcast", () => {
235
- test("publishes permission_mode_update event when askBeforeActing changes", async () => {
236
- const hub = new AssistantEventHub();
237
- const received: AssistantEvent[] = [];
238
-
239
- hub.subscribe({ assistantId: DAEMON_INTERNAL_ASSISTANT_ID }, (event) => {
240
- received.push(event);
241
- });
242
-
243
- // Wire up a listener that publishes to our test hub
244
- const { buildAssistantEvent } =
245
- await import("../runtime/assistant-event.js");
246
- onModeChanged((mode) => {
247
- void hub.publish(
248
- buildAssistantEvent(DAEMON_INTERNAL_ASSISTANT_ID, {
249
- type: "permission_mode_update",
250
- askBeforeActing: mode.askBeforeActing,
251
- hostAccess: mode.hostAccess,
252
- }),
253
- );
254
- });
255
-
256
- setAskBeforeActing(false);
257
-
258
- // Allow async publish to settle
259
- await new Promise((resolve) => setTimeout(resolve, 10));
260
-
261
- expect(received).toHaveLength(1);
262
- expect(received[0].message.type).toBe("permission_mode_update");
263
- const payload = received[0].message as {
264
- type: "permission_mode_update";
265
- askBeforeActing: boolean;
266
- hostAccess: boolean;
267
- };
268
- expect(payload.askBeforeActing).toBe(false);
269
- expect(payload.hostAccess).toBe(false);
270
- });
271
-
272
- test("publishes permission_mode_update event when hostAccess changes", async () => {
273
- const hub = new AssistantEventHub();
274
- const received: AssistantEvent[] = [];
275
-
276
- hub.subscribe({ assistantId: DAEMON_INTERNAL_ASSISTANT_ID }, (event) => {
277
- received.push(event);
278
- });
279
-
280
- const { buildAssistantEvent } =
281
- await import("../runtime/assistant-event.js");
282
- onModeChanged((mode) => {
283
- void hub.publish(
284
- buildAssistantEvent(DAEMON_INTERNAL_ASSISTANT_ID, {
285
- type: "permission_mode_update",
286
- askBeforeActing: mode.askBeforeActing,
287
- hostAccess: mode.hostAccess,
288
- }),
289
- );
290
- });
291
-
292
- setHostAccess(true);
293
-
294
- await new Promise((resolve) => setTimeout(resolve, 10));
295
-
296
- expect(received).toHaveLength(1);
297
- expect(received[0].message.type).toBe("permission_mode_update");
298
- const payload = received[0].message as {
299
- type: "permission_mode_update";
300
- askBeforeActing: boolean;
301
- hostAccess: boolean;
302
- };
303
- expect(payload.askBeforeActing).toBe(true);
304
- expect(payload.hostAccess).toBe(true);
305
- });
306
-
307
- test("does not publish event when value is unchanged", async () => {
308
- const hub = new AssistantEventHub();
309
- const received: AssistantEvent[] = [];
310
-
311
- hub.subscribe({ assistantId: DAEMON_INTERNAL_ASSISTANT_ID }, (event) => {
312
- received.push(event);
313
- });
314
-
315
- const { buildAssistantEvent } =
316
- await import("../runtime/assistant-event.js");
317
- onModeChanged((mode) => {
318
- void hub.publish(
319
- buildAssistantEvent(DAEMON_INTERNAL_ASSISTANT_ID, {
320
- type: "permission_mode_update",
321
- askBeforeActing: mode.askBeforeActing,
322
- hostAccess: mode.hostAccess,
323
- }),
324
- );
325
- });
326
-
327
- // Default is askBeforeActing=true, setting to true is a no-op
328
- setAskBeforeActing(true);
329
- // Default is hostAccess=false, setting to false is a no-op
330
- setHostAccess(false);
331
-
332
- await new Promise((resolve) => setTimeout(resolve, 10));
333
-
334
- expect(received).toHaveLength(0);
335
- });
336
- });
337
-
338
- describe("GET /v1/permission-mode", () => {
339
- test("returns current permission mode state via route handler", async () => {
340
- const res = await callGet();
341
- expect(res.status).toBe(200);
342
- const body = (await res.json()) as {
343
- askBeforeActing: boolean;
344
- hostAccess: boolean;
345
- };
346
- expect(body.askBeforeActing).toBe(true);
347
- expect(body.hostAccess).toBe(false);
348
- });
349
-
350
- test("returns updated state after mutation via route handler", async () => {
351
- setAskBeforeActing(false);
352
- setHostAccess(true);
353
-
354
- const res = await callGet();
355
- expect(res.status).toBe(200);
356
- const body = (await res.json()) as {
357
- askBeforeActing: boolean;
358
- hostAccess: boolean;
359
- };
360
- expect(body.askBeforeActing).toBe(false);
361
- expect(body.hostAccess).toBe(true);
362
- });
363
- });
364
-
365
- describe("PUT /v1/permission-mode", () => {
366
- test("updates askBeforeActing via route handler when flag is enabled", async () => {
367
- mockFeatureFlagEnabled = true;
368
-
369
- const res = await callPut({ askBeforeActing: false });
370
- expect(res.status).toBe(200);
371
- const body = (await res.json()) as {
372
- askBeforeActing: boolean;
373
- hostAccess: boolean;
374
- };
375
- expect(body.askBeforeActing).toBe(false);
376
- expect(body.hostAccess).toBe(false);
377
- });
378
-
379
- test("updates hostAccess via route handler when flag is enabled", async () => {
380
- mockFeatureFlagEnabled = true;
381
-
382
- const res = await callPut({ hostAccess: true });
383
- expect(res.status).toBe(200);
384
- const body = (await res.json()) as {
385
- askBeforeActing: boolean;
386
- hostAccess: boolean;
387
- };
388
- expect(body.askBeforeActing).toBe(true);
389
- expect(body.hostAccess).toBe(true);
390
- });
391
-
392
- test("updates both axes independently via route handler", async () => {
393
- mockFeatureFlagEnabled = true;
394
-
395
- const res1 = await callPut({ askBeforeActing: false });
396
- expect(res1.status).toBe(200);
397
-
398
- const res2 = await callPut({ hostAccess: true });
399
- expect(res2.status).toBe(200);
400
- const body = (await res2.json()) as {
401
- askBeforeActing: boolean;
402
- hostAccess: boolean;
403
- };
404
- expect(body.askBeforeActing).toBe(false);
405
- expect(body.hostAccess).toBe(true);
406
- });
407
-
408
- test("returns 404 when feature flag is off", async () => {
409
- mockFeatureFlagEnabled = false;
410
-
411
- const res = await callPut({ askBeforeActing: false });
412
- expect(res.status).toBe(404);
413
-
414
- // Verify the store was NOT mutated — askBeforeActing should remain at default
415
- const mode = getMode();
416
- expect(mode.askBeforeActing).toBe(true);
417
- });
418
- });
@@ -1,277 +0,0 @@
1
- import {
2
- existsSync,
3
- mkdirSync,
4
- readFileSync,
5
- rmSync,
6
- writeFileSync,
7
- } from "node:fs";
8
- import { join } from "node:path";
9
- import {
10
- afterAll,
11
- afterEach,
12
- beforeEach,
13
- describe,
14
- expect,
15
- mock,
16
- test,
17
- } from "bun:test";
18
-
19
- // ---------------------------------------------------------------------------
20
- // Mocks — declared before imports that depend on platform/logger
21
- // ---------------------------------------------------------------------------
22
-
23
- const WORKSPACE_DIR = process.env.VELLUM_WORKSPACE_DIR!;
24
- const CONFIG_PATH = join(WORKSPACE_DIR, "config.json");
25
-
26
- function ensureTestDir(): void {
27
- const dirs = [
28
- WORKSPACE_DIR,
29
- join(WORKSPACE_DIR, "data"),
30
- join(WORKSPACE_DIR, "data", "logs"),
31
- ];
32
- for (const dir of dirs) {
33
- if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
34
- }
35
- }
36
-
37
- function makeLoggerStub(): Record<string, unknown> {
38
- const stub: Record<string, unknown> = {};
39
- for (const m of [
40
- "info",
41
- "warn",
42
- "error",
43
- "debug",
44
- "trace",
45
- "fatal",
46
- "silent",
47
- "child",
48
- ]) {
49
- stub[m] = m === "child" ? () => makeLoggerStub() : () => {};
50
- }
51
- return stub;
52
- }
53
-
54
- mock.module("../util/logger.js", () => ({
55
- getLogger: () => makeLoggerStub(),
56
- }));
57
-
58
- afterAll(() => {
59
- mock.restore();
60
- });
61
-
62
- import { invalidateConfigCache } from "../config/loader.js";
63
- import {
64
- getMode,
65
- initPermissionModeStore,
66
- onModeChanged,
67
- resetForTesting,
68
- setAskBeforeActing,
69
- setHostAccess,
70
- } from "../permissions/permission-mode-store.js";
71
-
72
- // ---------------------------------------------------------------------------
73
- // Helpers
74
- // ---------------------------------------------------------------------------
75
-
76
- function writeConfig(obj: unknown): void {
77
- ensureTestDir();
78
- writeFileSync(CONFIG_PATH, JSON.stringify(obj, null, 2) + "\n");
79
- }
80
-
81
- function readConfig(): Record<string, unknown> {
82
- return JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
83
- }
84
-
85
- // ---------------------------------------------------------------------------
86
- // Setup / teardown
87
- // ---------------------------------------------------------------------------
88
-
89
- beforeEach(() => {
90
- ensureTestDir();
91
- resetForTesting();
92
- invalidateConfigCache();
93
- // Remove config file to start clean
94
- try {
95
- rmSync(CONFIG_PATH, { force: true });
96
- } catch {
97
- /* noop */
98
- }
99
- });
100
-
101
- afterEach(() => {
102
- resetForTesting();
103
- invalidateConfigCache();
104
- });
105
-
106
- // ---------------------------------------------------------------------------
107
- // Tests
108
- // ---------------------------------------------------------------------------
109
-
110
- describe("PermissionModeStore", () => {
111
- describe("getMode", () => {
112
- test("returns defaults when no config exists", () => {
113
- const mode = getMode();
114
- expect(mode.askBeforeActing).toBe(true);
115
- expect(mode.hostAccess).toBe(false);
116
- });
117
-
118
- test("reads initial state from config", () => {
119
- writeConfig({
120
- permissions: {
121
- askBeforeActing: false,
122
- hostAccess: true,
123
- },
124
- });
125
-
126
- initPermissionModeStore();
127
- const mode = getMode();
128
- expect(mode.askBeforeActing).toBe(false);
129
- expect(mode.hostAccess).toBe(true);
130
- });
131
-
132
- test("returns a defensive copy (mutations do not affect store)", () => {
133
- const mode = getMode();
134
- mode.askBeforeActing = false;
135
- mode.hostAccess = true;
136
-
137
- const fresh = getMode();
138
- expect(fresh.askBeforeActing).toBe(true);
139
- expect(fresh.hostAccess).toBe(false);
140
- });
141
- });
142
-
143
- describe("setAskBeforeActing", () => {
144
- test("updates in-memory state", () => {
145
- expect(getMode().askBeforeActing).toBe(true);
146
-
147
- setAskBeforeActing(false);
148
- expect(getMode().askBeforeActing).toBe(false);
149
- });
150
-
151
- test("persists to config.json", () => {
152
- setAskBeforeActing(false);
153
-
154
- const raw = readConfig();
155
- const permissions = raw.permissions as Record<string, unknown>;
156
- expect(permissions.askBeforeActing).toBe(false);
157
- });
158
-
159
- test("no-op when value is unchanged", () => {
160
- const calls: unknown[] = [];
161
- onModeChanged((mode) => calls.push(mode));
162
-
163
- // Default is true; setting to true should not fire
164
- setAskBeforeActing(true);
165
- expect(calls).toHaveLength(0);
166
- });
167
- });
168
-
169
- describe("setHostAccess", () => {
170
- test("updates in-memory state", () => {
171
- expect(getMode().hostAccess).toBe(false);
172
-
173
- setHostAccess(true);
174
- expect(getMode().hostAccess).toBe(true);
175
- });
176
-
177
- test("persists to config.json", () => {
178
- setHostAccess(true);
179
-
180
- const raw = readConfig();
181
- const permissions = raw.permissions as Record<string, unknown>;
182
- expect(permissions.hostAccess).toBe(true);
183
- });
184
-
185
- test("no-op when value is unchanged", () => {
186
- const calls: unknown[] = [];
187
- onModeChanged((mode) => calls.push(mode));
188
-
189
- // Default is false; setting to false should not fire
190
- setHostAccess(false);
191
- expect(calls).toHaveLength(0);
192
- });
193
- });
194
-
195
- describe("onModeChanged", () => {
196
- test("fires on askBeforeActing change", () => {
197
- const received: Array<{ askBeforeActing: boolean; hostAccess: boolean }> =
198
- [];
199
- onModeChanged((mode) => received.push(mode));
200
-
201
- setAskBeforeActing(false);
202
- expect(received).toHaveLength(1);
203
- expect(received[0].askBeforeActing).toBe(false);
204
- expect(received[0].hostAccess).toBe(false);
205
- });
206
-
207
- test("fires on hostAccess change", () => {
208
- const received: Array<{ askBeforeActing: boolean; hostAccess: boolean }> =
209
- [];
210
- onModeChanged((mode) => received.push(mode));
211
-
212
- setHostAccess(true);
213
- expect(received).toHaveLength(1);
214
- expect(received[0].askBeforeActing).toBe(true);
215
- expect(received[0].hostAccess).toBe(true);
216
- });
217
-
218
- test("unsubscribe stops notifications", () => {
219
- const received: unknown[] = [];
220
- const unsubscribe = onModeChanged((mode) => received.push(mode));
221
-
222
- setAskBeforeActing(false);
223
- expect(received).toHaveLength(1);
224
-
225
- unsubscribe();
226
- setHostAccess(true);
227
- expect(received).toHaveLength(1); // no new notification
228
- });
229
-
230
- test("listener errors do not break other listeners", () => {
231
- const received: unknown[] = [];
232
- onModeChanged(() => {
233
- throw new Error("boom");
234
- });
235
- onModeChanged((mode) => received.push(mode));
236
-
237
- setAskBeforeActing(false);
238
- expect(received).toHaveLength(1);
239
- });
240
- });
241
-
242
- describe("persistence round-trip", () => {
243
- test("state survives store reset and re-initialization", () => {
244
- setAskBeforeActing(false);
245
- setHostAccess(true);
246
-
247
- // Simulate daemon restart: reset store and re-init from config
248
- resetForTesting();
249
- invalidateConfigCache();
250
- initPermissionModeStore();
251
-
252
- const mode = getMode();
253
- expect(mode.askBeforeActing).toBe(false);
254
- expect(mode.hostAccess).toBe(true);
255
- });
256
-
257
- test("preserves other config fields when persisting", () => {
258
- writeConfig({
259
- maxTokens: 8000,
260
- permissions: {
261
- mode: "strict",
262
- askBeforeActing: true,
263
- hostAccess: false,
264
- },
265
- });
266
-
267
- initPermissionModeStore();
268
- setHostAccess(true);
269
-
270
- const raw = readConfig();
271
- expect(raw.maxTokens).toBe(8000);
272
- const permissions = raw.permissions as Record<string, unknown>;
273
- expect(permissions.mode).toBe("strict");
274
- expect(permissions.hostAccess).toBe(true);
275
- });
276
- });
277
- });