@vellumai/assistant 0.6.2 → 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 (396) hide show
  1. package/bun.lock +40 -40
  2. package/bunfig.toml +3 -0
  3. package/docs/architecture/memory.md +1 -1
  4. package/node_modules/@vellumai/ces-contracts/src/rpc.ts +42 -0
  5. package/openapi.yaml +184 -69
  6. package/package.json +41 -41
  7. package/scripts/generate-openapi.ts +1 -2
  8. package/src/__tests__/acp-session.test.ts +43 -0
  9. package/src/__tests__/app-builder-tool-scripts.test.ts +1 -0
  10. package/src/__tests__/app-executors.test.ts +1 -0
  11. package/src/__tests__/app-source-watcher.test.ts +37 -11
  12. package/src/__tests__/approval-routes-http.test.ts +178 -1
  13. package/src/__tests__/browser-fill-credential.test.ts +229 -94
  14. package/src/__tests__/browser-manager.test.ts +40 -27
  15. package/src/__tests__/catalog-files.test.ts +862 -0
  16. package/src/__tests__/channel-approvals.test.ts +53 -0
  17. package/src/__tests__/config-managed-gemini-defaults.test.ts +326 -0
  18. package/src/__tests__/config-schema-cmd.test.ts +2 -2
  19. package/src/__tests__/config-schema.test.ts +125 -48
  20. package/src/__tests__/confirmation-request-guardian-bridge.test.ts +23 -0
  21. package/src/__tests__/context-overflow-approval.test.ts +16 -1
  22. package/src/__tests__/conversation-agent-loop-overflow.test.ts +1 -1
  23. package/src/__tests__/conversation-agent-loop.test.ts +1 -1
  24. package/src/__tests__/conversation-analysis-routes.test.ts +2 -2
  25. package/src/__tests__/conversation-attachments.test.ts +80 -4
  26. package/src/__tests__/conversation-confirmation-signals.test.ts +155 -0
  27. package/src/__tests__/conversation-fork-crud.test.ts +17 -0
  28. package/src/__tests__/conversation-history-web-search.test.ts +1 -0
  29. package/src/__tests__/conversation-host-access-routes.test.ts +229 -0
  30. package/src/__tests__/conversation-inject-context.test.ts +103 -0
  31. package/src/__tests__/conversation-queue.test.ts +45 -2
  32. package/src/__tests__/conversation-routes-disk-view.test.ts +5 -0
  33. package/src/__tests__/conversation-routes-guardian-reply.test.ts +16 -0
  34. package/src/__tests__/conversation-routes-slash-commands.test.ts +1 -0
  35. package/src/__tests__/conversation-runtime-assembly.test.ts +269 -46
  36. package/src/__tests__/conversation-starter-routes.test.ts +126 -0
  37. package/src/__tests__/conversation-starters-cadence.test.ts +161 -0
  38. package/src/__tests__/conversation-store.test.ts +195 -0
  39. package/src/__tests__/conversation-workspace-cache-state.test.ts +193 -0
  40. package/src/__tests__/credential-execution-approval-bridge.test.ts +32 -1
  41. package/src/__tests__/credential-security-invariants.test.ts +1 -0
  42. package/src/__tests__/credential-vault-unit.test.ts +4 -4
  43. package/src/__tests__/credential-vault.test.ts +152 -13
  44. package/src/__tests__/credentials-cli.test.ts +2 -2
  45. package/src/__tests__/date-context.test.ts +4 -4
  46. package/src/__tests__/embedding-managed-proxy-selection.test.ts +256 -0
  47. package/src/__tests__/extension-id-sync-guard.test.ts +155 -0
  48. package/src/__tests__/fixtures/mock-chrome-extension.ts +375 -0
  49. package/src/__tests__/gateway-only-guard.test.ts +3 -0
  50. package/src/__tests__/gemini-provider.test.ts +2 -2
  51. package/src/__tests__/guardian-routing-invariants.test.ts +70 -2
  52. package/src/__tests__/headless-browser-interactions.test.ts +707 -371
  53. package/src/__tests__/headless-browser-navigate.test.ts +389 -47
  54. package/src/__tests__/headless-browser-read-tools.test.ts +266 -103
  55. package/src/__tests__/headless-browser-snapshot.test.ts +240 -77
  56. package/src/__tests__/host-bash-proxy.test.ts +150 -1
  57. package/src/__tests__/host-browser-e2e-cloud.test.ts +462 -0
  58. package/src/__tests__/host-browser-e2e-self-hosted-capability.test.ts +286 -0
  59. package/src/__tests__/host-browser-e2e-self-hosted.test.ts +374 -0
  60. package/src/__tests__/host-browser-event-routes.test.ts +350 -0
  61. package/src/__tests__/host-browser-proxy.test.ts +444 -0
  62. package/src/__tests__/host-browser-routes.test.ts +198 -0
  63. package/src/__tests__/host-browser-ws-events-e2e.test.ts +320 -0
  64. package/src/__tests__/host-cu-proxy.test.ts +171 -1
  65. package/src/__tests__/host-file-proxy.test.ts +185 -1
  66. package/src/__tests__/host-file-read-tool.test.ts +52 -0
  67. package/src/__tests__/host-proxy-interface.test.ts +165 -0
  68. package/src/__tests__/host-shell-tool.test.ts +1 -11
  69. package/src/__tests__/http-user-message-parity.test.ts +1 -0
  70. package/src/__tests__/integration-status.test.ts +6 -7
  71. package/src/__tests__/list-messages-tool-merge.test.ts +37 -12
  72. package/src/__tests__/mcp-client-auth.test.ts +40 -4
  73. package/src/__tests__/mcp-health-check.test.ts +10 -3
  74. package/src/__tests__/migration-cross-version-compatibility.test.ts +3 -1
  75. package/src/__tests__/migration-export-http.test.ts +61 -2
  76. package/src/__tests__/migration-export-streaming.test.ts +66 -0
  77. package/src/__tests__/migration-import-commit-http.test.ts +101 -1
  78. package/src/__tests__/native-host-marker-sync-guard.test.ts +157 -0
  79. package/src/__tests__/oauth-apps-routes.test.ts +17 -12
  80. package/src/__tests__/oauth-cli.test.ts +707 -60
  81. package/src/__tests__/oauth-connect-orchestrator.test.ts +116 -24
  82. package/src/__tests__/oauth-provider-seed-logos.test.ts +23 -0
  83. package/src/__tests__/oauth-provider-serializer.test.ts +146 -10
  84. package/src/__tests__/oauth-provider-visibility.test.ts +19 -21
  85. package/src/__tests__/oauth-providers-routes.test.ts +50 -14
  86. package/src/__tests__/oauth-store.test.ts +1386 -182
  87. package/src/__tests__/oauth2-gateway-transport.test.ts +211 -20
  88. package/src/__tests__/onboarding-template-contract.test.ts +75 -57
  89. package/src/__tests__/openai-provider.test.ts +2 -2
  90. package/src/__tests__/outlook-categories.test.ts +1 -1
  91. package/src/__tests__/outlook-client-automation.test.ts +1 -1
  92. package/src/__tests__/outlook-compose-tools.test.ts +1 -1
  93. package/src/__tests__/outlook-email-watcher.test.ts +1 -1
  94. package/src/__tests__/outlook-follow-up.test.ts +1 -1
  95. package/src/__tests__/outlook-messaging-provider.test.ts +2 -2
  96. package/src/__tests__/outlook-trash.test.ts +1 -1
  97. package/src/__tests__/outlook-unsubscribe.test.ts +1 -1
  98. package/src/__tests__/permission-checker-host-gate.test.ts +74 -14
  99. package/src/__tests__/permission-mode.test.ts +28 -56
  100. package/src/__tests__/platform-callback-registration.test.ts +19 -0
  101. package/src/__tests__/post-turn-tool-result-truncation.test.ts +296 -0
  102. package/src/__tests__/proxy-approval-callback.test.ts +18 -0
  103. package/src/__tests__/require-fresh-approval.test.ts +40 -1
  104. package/src/__tests__/sanitize-config-for-transfer.test.ts +132 -0
  105. package/src/__tests__/schedule-routes.test.ts +162 -0
  106. package/src/__tests__/secret-detection-handler.test.ts +84 -0
  107. package/src/__tests__/secret-ingress-http.test.ts +1 -0
  108. package/src/__tests__/send-endpoint-busy.test.ts +3 -0
  109. package/src/__tests__/set-permission-mode.test.ts +13 -250
  110. package/src/__tests__/skills-file-content-endpoint.test.ts +670 -0
  111. package/src/__tests__/skills-files-catalog-fallback.test.ts +450 -0
  112. package/src/__tests__/slack-channel-config.test.ts +12 -15
  113. package/src/__tests__/subagent-detail.test.ts +44 -2
  114. package/src/__tests__/subagent-disposal.test.ts +1 -0
  115. package/src/__tests__/subagent-fork-notifications.test.ts +291 -0
  116. package/src/__tests__/subagent-fork-spawn.test.ts +384 -0
  117. package/src/__tests__/subagent-manager-notify.test.ts +1 -0
  118. package/src/__tests__/subagent-notify-parent.test.ts +1 -0
  119. package/src/__tests__/subagent-spawn-tool-fork.test.ts +411 -0
  120. package/src/__tests__/subagent-tools.test.ts +1 -0
  121. package/src/__tests__/subagent-types.test.ts +1 -0
  122. package/src/__tests__/system-prompt-ask-mode.test.ts +27 -71
  123. package/src/__tests__/system-prompt.test.ts +72 -1
  124. package/src/__tests__/task-scheduler.test.ts +32 -6
  125. package/src/__tests__/telegram-config.test.ts +10 -13
  126. package/src/__tests__/terminal-tools.test.ts +9 -0
  127. package/src/__tests__/tool-approval-handler.test.ts +73 -0
  128. package/src/__tests__/tool-side-effects-slack-dm.test.ts +22 -0
  129. package/src/__tests__/top-level-renderer.test.ts +73 -1
  130. package/src/__tests__/transport-hints-queue.test.ts +14 -29
  131. package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +109 -0
  132. package/src/__tests__/v2-consent-policy.test.ts +103 -0
  133. package/src/acp/client-handler.ts +30 -4
  134. package/src/agent/loop.ts +12 -6
  135. package/src/approvals/guardian-request-resolvers.ts +21 -15
  136. package/src/browser-session/__tests__/manager.test.ts +297 -0
  137. package/src/browser-session/backends/cdp-inspect.ts +30 -0
  138. package/src/browser-session/backends/extension.ts +26 -0
  139. package/src/browser-session/backends/local.ts +24 -0
  140. package/src/browser-session/events.ts +164 -0
  141. package/src/browser-session/index.ts +27 -0
  142. package/src/browser-session/manager.ts +159 -0
  143. package/src/browser-session/types.ts +28 -0
  144. package/src/channels/__tests__/types.test.ts +134 -0
  145. package/src/channels/types.ts +53 -3
  146. package/src/cli/commands/browser-relay.ts +339 -409
  147. package/src/cli/commands/credentials.ts +3 -3
  148. package/src/cli/commands/email.ts +18 -13
  149. package/src/cli/commands/mcp.ts +16 -4
  150. package/src/cli/commands/oauth/__tests__/connect.test.ts +44 -44
  151. package/src/cli/commands/oauth/__tests__/disconnect.test.ts +21 -21
  152. package/src/cli/commands/oauth/__tests__/mode.test.ts +17 -17
  153. package/src/cli/commands/oauth/__tests__/ping.test.ts +16 -16
  154. package/src/cli/commands/oauth/__tests__/providers-delete.test.ts +31 -33
  155. package/src/cli/commands/oauth/__tests__/providers-register.test.ts +329 -0
  156. package/src/cli/commands/oauth/__tests__/providers-update.test.ts +116 -12
  157. package/src/cli/commands/oauth/__tests__/status.test.ts +10 -10
  158. package/src/cli/commands/oauth/__tests__/token.test.ts +7 -7
  159. package/src/cli/commands/oauth/apps.ts +7 -4
  160. package/src/cli/commands/oauth/connect.ts +6 -3
  161. package/src/cli/commands/oauth/disconnect.ts +1 -1
  162. package/src/cli/commands/oauth/providers.ts +200 -36
  163. package/src/cli/commands/oauth/shared.ts +5 -5
  164. package/src/cli/commands/platform/__tests__/callback-routes-list.test.ts +259 -0
  165. package/src/cli/commands/platform/index.ts +107 -10
  166. package/src/cli/commands/usage.ts +10 -9
  167. package/src/cli/lib/daemon-credential-client.ts +4 -0
  168. package/src/cli/program.ts +1 -1
  169. package/src/config/bundled-skills/app-builder/SKILL.md +26 -249
  170. package/src/config/bundled-skills/app-builder/references/CUSTOM_ROUTES.md +105 -0
  171. package/src/config/bundled-skills/app-builder/references/INTERACTION_HOOKS.md +56 -0
  172. package/src/config/bundled-skills/app-builder/references/WIDGETS.md +125 -0
  173. package/src/config/bundled-skills/contacts/SKILL.md +3 -0
  174. package/src/config/bundled-skills/document/SKILL.md +4 -0
  175. package/src/config/bundled-skills/gmail/SKILL.md +1 -1
  176. package/src/config/bundled-skills/outlook/SKILL.md +7 -0
  177. package/src/config/bundled-skills/subagent/SKILL.md +21 -0
  178. package/src/config/bundled-skills/subagent/TOOLS.json +8 -4
  179. package/src/config/bundled-skills/tasks/SKILL.md +5 -0
  180. package/src/config/env-registry.ts +14 -0
  181. package/src/config/env.ts +21 -0
  182. package/src/config/feature-flag-registry.json +44 -5
  183. package/src/config/loader.ts +56 -1
  184. package/src/config/sanitize-for-transfer.ts +47 -0
  185. package/src/config/schema.ts +46 -5
  186. package/src/config/schemas/host-browser.ts +66 -0
  187. package/src/config/schemas/memory-lifecycle.ts +1 -1
  188. package/src/config/schemas/memory-retrieval.ts +103 -0
  189. package/src/config/schemas/security.ts +0 -6
  190. package/src/config/schemas/services.ts +8 -0
  191. package/src/config/types.ts +0 -1
  192. package/src/context/post-turn-tool-result-truncation.ts +176 -0
  193. package/src/context/window-manager.ts +19 -1
  194. package/src/credential-execution/approval-bridge.ts +49 -15
  195. package/src/daemon/__tests__/conversation-tool-setup.test.ts +186 -0
  196. package/src/daemon/app-source-watcher.ts +35 -0
  197. package/src/daemon/context-overflow-approval.ts +5 -0
  198. package/src/daemon/conversation-agent-loop-handlers.ts +17 -2
  199. package/src/daemon/conversation-agent-loop.ts +58 -24
  200. package/src/daemon/conversation-attachments.ts +40 -0
  201. package/src/daemon/conversation-process.ts +48 -1
  202. package/src/daemon/conversation-runtime-assembly.ts +118 -36
  203. package/src/daemon/conversation-surfaces.ts +37 -36
  204. package/src/daemon/conversation-tool-setup.ts +74 -8
  205. package/src/daemon/conversation-workspace.ts +12 -0
  206. package/src/daemon/conversation.ts +226 -8
  207. package/src/daemon/date-context.ts +10 -10
  208. package/src/daemon/first-greeting.ts +3 -2
  209. package/src/daemon/handlers/conversations.ts +9 -140
  210. package/src/daemon/handlers/shared.ts +58 -0
  211. package/src/daemon/handlers/skills.ts +232 -37
  212. package/src/daemon/host-bash-proxy.ts +48 -13
  213. package/src/daemon/host-browser-proxy.ts +191 -0
  214. package/src/daemon/host-cu-proxy.ts +36 -11
  215. package/src/daemon/host-file-proxy.ts +57 -9
  216. package/src/daemon/lifecycle.ts +65 -11
  217. package/src/daemon/message-protocol.ts +7 -0
  218. package/src/daemon/message-types/conversations.ts +55 -13
  219. package/src/daemon/message-types/host-browser.ts +100 -0
  220. package/src/daemon/message-types/messages.ts +5 -5
  221. package/src/daemon/message-types/skills.ts +10 -0
  222. package/src/daemon/message-types/subagents.ts +2 -0
  223. package/src/daemon/server.ts +92 -12
  224. package/src/daemon/tool-side-effects.ts +6 -0
  225. package/src/daemon/transport-hints.ts +5 -24
  226. package/src/inbound/platform-callback-registration.ts +18 -17
  227. package/src/mcp/client.ts +59 -24
  228. package/src/memory/app-store.ts +31 -1
  229. package/src/memory/conversation-crud.ts +23 -0
  230. package/src/memory/conversation-starters-cadence.ts +76 -0
  231. package/src/memory/conversation-title-service.ts +5 -2
  232. package/src/memory/db-init.ts +12 -0
  233. package/src/memory/embedding-backend.test.ts +75 -0
  234. package/src/memory/embedding-backend.ts +131 -5
  235. package/src/memory/embedding-gemini.test.ts +54 -0
  236. package/src/memory/embedding-gemini.ts +20 -9
  237. package/src/memory/embedding-local.ts +176 -17
  238. package/src/memory/graph/consolidation.ts +10 -23
  239. package/src/memory/graph/extraction-job.ts +15 -0
  240. package/src/memory/graph/retriever.ts +40 -22
  241. package/src/memory/graph/store.test.ts +7 -3
  242. package/src/memory/graph/store.ts +47 -12
  243. package/src/memory/llm-usage-store.ts +45 -4
  244. package/src/memory/migrations/213-oauth-providers-scope-separator.ts +13 -0
  245. package/src/memory/migrations/214-oauth-providers-refresh-url.ts +11 -0
  246. package/src/memory/migrations/215-oauth-providers-revoke.ts +14 -0
  247. package/src/memory/migrations/216-oauth-providers-token-auth-method.ts +30 -0
  248. package/src/memory/migrations/217-conversation-host-access.ts +40 -0
  249. package/src/memory/migrations/218-oauth-providers-logo-url.ts +11 -0
  250. package/src/memory/migrations/index.ts +6 -0
  251. package/src/memory/migrations/registry.ts +8 -0
  252. package/src/memory/schema/conversations.ts +1 -0
  253. package/src/memory/schema/oauth.ts +18 -13
  254. package/src/oauth/AGENTS.md +76 -0
  255. package/src/oauth/__tests__/identity-verifier.test.ts +24 -19
  256. package/src/oauth/__tests__/seed-providers-managed.test.ts +32 -0
  257. package/src/oauth/byo-connection.test.ts +8 -8
  258. package/src/oauth/byo-connection.ts +7 -7
  259. package/src/oauth/connect-orchestrator.ts +23 -21
  260. package/src/oauth/connect-types.ts +3 -3
  261. package/src/oauth/connection-resolver.test.ts +17 -4
  262. package/src/oauth/connection-resolver.ts +16 -16
  263. package/src/oauth/connection.ts +1 -1
  264. package/src/oauth/manual-token-connection.ts +13 -13
  265. package/src/oauth/oauth-store.ts +214 -100
  266. package/src/oauth/platform-connection.test.ts +3 -3
  267. package/src/oauth/platform-connection.ts +4 -4
  268. package/src/oauth/provider-serializer.ts +31 -5
  269. package/src/oauth/revoke.ts +76 -0
  270. package/src/oauth/seed-providers.ts +126 -87
  271. package/src/oauth/token-persistence.ts +1 -1
  272. package/src/permissions/permission-mode.ts +4 -11
  273. package/src/permissions/prompter.ts +13 -1
  274. package/src/permissions/v2-consent-policy.ts +87 -0
  275. package/src/prompts/system-prompt.ts +18 -21
  276. package/src/prompts/templates/BOOTSTRAP-REFERENCE.md +3 -65
  277. package/src/prompts/templates/BOOTSTRAP.md +59 -105
  278. package/src/providers/anthropic/client.ts +1 -0
  279. package/src/providers/types.ts +1 -1
  280. package/src/runtime/AGENTS.md +23 -0
  281. package/src/runtime/__tests__/browser-extension-pair-routes.test.ts +715 -0
  282. package/src/runtime/__tests__/capability-tokens.test.ts +258 -0
  283. package/src/runtime/__tests__/chrome-extension-registry.test.ts +518 -0
  284. package/src/runtime/assistant-event-hub.ts +2 -2
  285. package/src/runtime/auth/__tests__/guard-tests.test.ts +1 -0
  286. package/src/runtime/auth/__tests__/middleware.test.ts +116 -1
  287. package/src/runtime/auth/__tests__/route-policy.test.ts +8 -0
  288. package/src/runtime/auth/middleware.ts +98 -0
  289. package/src/runtime/auth/route-policy.ts +6 -7
  290. package/src/runtime/capability-tokens.ts +414 -0
  291. package/src/runtime/channel-approvals.ts +18 -5
  292. package/src/runtime/chrome-extension-registry.ts +332 -0
  293. package/src/runtime/confirmation-request-guardian-bridge.ts +6 -0
  294. package/src/runtime/guardian-decision-types.ts +7 -0
  295. package/src/runtime/http-server.ts +425 -70
  296. package/src/runtime/migrations/__tests__/rebind-secrets-credentials.test.ts +172 -0
  297. package/src/runtime/migrations/__tests__/vbundle-builder-credentials.test.ts +276 -0
  298. package/src/runtime/migrations/__tests__/vbundle-import-credentials.test.ts +162 -0
  299. package/src/runtime/migrations/migration-transport.ts +6 -0
  300. package/src/runtime/migrations/migration-wizard.ts +22 -2
  301. package/src/runtime/migrations/rebind-secrets-screen.ts +76 -15
  302. package/src/runtime/migrations/vbundle-builder.ts +145 -38
  303. package/src/runtime/migrations/vbundle-import-analyzer.ts +19 -0
  304. package/src/runtime/migrations/vbundle-importer.ts +55 -5
  305. package/src/runtime/pending-interactions.ts +29 -13
  306. package/src/runtime/routes/approval-routes.ts +90 -16
  307. package/src/runtime/routes/browser-cdp-routes.ts +229 -0
  308. package/src/runtime/routes/browser-extension-pair-routes.ts +497 -0
  309. package/src/runtime/routes/conversation-analysis-routes.ts +2 -1
  310. package/src/runtime/routes/conversation-management-routes.ts +108 -0
  311. package/src/runtime/routes/conversation-routes.ts +301 -27
  312. package/src/runtime/routes/conversation-starter-routes.ts +78 -16
  313. package/src/runtime/routes/guardian-action-routes.ts +24 -13
  314. package/src/runtime/routes/host-browser-routes.ts +279 -0
  315. package/src/runtime/routes/host-file-routes.ts +9 -1
  316. package/src/runtime/routes/identity-routes.ts +259 -16
  317. package/src/runtime/routes/log-export-routes.ts +42 -22
  318. package/src/runtime/routes/memory-item-routes.ts +1 -7
  319. package/src/runtime/routes/migration-routes.ts +87 -2
  320. package/src/runtime/routes/oauth-apps.ts +15 -17
  321. package/src/runtime/routes/oauth-providers.ts +4 -0
  322. package/src/runtime/routes/schedule-routes.ts +24 -11
  323. package/src/runtime/routes/settings-routes.ts +9 -97
  324. package/src/runtime/routes/skills-routes.ts +52 -2
  325. package/src/runtime/routes/subagents-routes.ts +14 -10
  326. package/src/runtime/routes/usage-routes.ts +8 -7
  327. package/src/runtime/routes/workspace-routes.test.ts +22 -0
  328. package/src/runtime/routes/workspace-routes.ts +8 -1
  329. package/src/runtime/routes/workspace-utils.ts +2 -0
  330. package/src/schedule/scheduler.ts +7 -5
  331. package/src/security/ces-credential-client.ts +20 -0
  332. package/src/security/ces-rpc-credential-backend.ts +17 -0
  333. package/src/security/credential-backend.ts +5 -0
  334. package/src/security/oauth2.ts +42 -25
  335. package/src/security/secure-keys.ts +118 -25
  336. package/src/security/token-manager.ts +23 -10
  337. package/src/skills/catalog-files.ts +492 -0
  338. package/src/subagent/manager.ts +131 -26
  339. package/src/subagent/types.ts +19 -0
  340. package/src/tools/apps/executors.ts +11 -2
  341. package/src/tools/browser/__tests__/auth-detector.test.ts +202 -108
  342. package/src/tools/browser/auth-detector.ts +43 -12
  343. package/src/tools/browser/browser-execution.ts +645 -340
  344. package/src/tools/browser/browser-manager.ts +36 -12
  345. package/src/tools/browser/cdp-client/__tests__/accessibility-snapshot.test.ts +318 -0
  346. package/src/tools/browser/cdp-client/__tests__/cdp-dom-helpers.test.ts +1175 -0
  347. package/src/tools/browser/cdp-client/__tests__/cdp-inspect-client.test.ts +870 -0
  348. package/src/tools/browser/cdp-client/__tests__/extension-cdp-client.test.ts +330 -0
  349. package/src/tools/browser/cdp-client/__tests__/factory.test.ts +377 -0
  350. package/src/tools/browser/cdp-client/__tests__/fixtures/ax-tree-nested-frames.json +64 -0
  351. package/src/tools/browser/cdp-client/__tests__/fixtures/ax-tree-simple.json +69 -0
  352. package/src/tools/browser/cdp-client/__tests__/local-cdp-client.test.ts +310 -0
  353. package/src/tools/browser/cdp-client/__tests__/types.test.ts +96 -0
  354. package/src/tools/browser/cdp-client/accessibility-snapshot.ts +387 -0
  355. package/src/tools/browser/cdp-client/cdp-dom-helpers.ts +695 -0
  356. package/src/tools/browser/cdp-client/cdp-inspect/__tests__/discovery.test.ts +743 -0
  357. package/src/tools/browser/cdp-client/cdp-inspect/__tests__/ws-transport.test.ts +580 -0
  358. package/src/tools/browser/cdp-client/cdp-inspect/discovery.ts +578 -0
  359. package/src/tools/browser/cdp-client/cdp-inspect/ws-transport.ts +579 -0
  360. package/src/tools/browser/cdp-client/cdp-inspect-client.ts +635 -0
  361. package/src/tools/browser/cdp-client/errors.ts +34 -0
  362. package/src/tools/browser/cdp-client/extension-cdp-client.ts +125 -0
  363. package/src/tools/browser/cdp-client/factory.ts +204 -0
  364. package/src/tools/browser/cdp-client/index.ts +14 -0
  365. package/src/tools/browser/cdp-client/local-cdp-client.ts +187 -0
  366. package/src/tools/browser/cdp-client/types.ts +52 -0
  367. package/src/tools/filesystem/edit.ts +1 -1
  368. package/src/tools/filesystem/list.ts +1 -1
  369. package/src/tools/filesystem/read.ts +1 -1
  370. package/src/tools/filesystem/write.ts +2 -1
  371. package/src/tools/host-filesystem/edit.ts +1 -1
  372. package/src/tools/host-filesystem/read.ts +12 -15
  373. package/src/tools/host-filesystem/write.ts +1 -1
  374. package/src/tools/host-terminal/host-shell.ts +21 -16
  375. package/src/tools/permission-checker.ts +77 -82
  376. package/src/tools/registry.ts +0 -2
  377. package/src/tools/secret-detection-handler.ts +34 -0
  378. package/src/tools/shared/filesystem/image-read.ts +61 -40
  379. package/src/tools/subagent/spawn.ts +47 -3
  380. package/src/tools/subagent/status.ts +2 -0
  381. package/src/tools/system/register.ts +2 -16
  382. package/src/tools/terminal/safe-env.ts +7 -0
  383. package/src/tools/terminal/shell.ts +21 -16
  384. package/src/tools/tool-approval-handler.ts +48 -2
  385. package/src/tools/types.ts +2 -0
  386. package/src/util/platform.ts +14 -19
  387. package/src/workspace/top-level-renderer.ts +19 -1
  388. package/src/__tests__/chrome-cdp.test.ts +0 -419
  389. package/src/__tests__/permission-mode-sse.test.ts +0 -418
  390. package/src/__tests__/permission-mode-store.test.ts +0 -277
  391. package/src/browser-extension-relay/protocol.ts +0 -63
  392. package/src/browser-extension-relay/server.ts +0 -203
  393. package/src/config/schemas/sandbox.ts +0 -14
  394. package/src/permissions/permission-mode-store.ts +0 -180
  395. package/src/tools/browser/chrome-cdp.ts +0 -239
  396. package/src/tools/system/set-permission-mode.ts +0 -103
@@ -108,16 +108,20 @@ mock.module("../permissions/checker.js", () => ({
108
108
 
109
109
  mock.module("../memory/tool-usage-store.js", () => ({
110
110
  recordToolInvocation: () => {},
111
+ getRecentInvocations: () => [],
112
+ rotateToolInvocations: () => 0,
111
113
  }));
112
114
 
113
115
  mock.module("../tools/registry.js", () => ({
114
116
  getTool: (name: string) => {
115
117
  if (name === "unknown_tool") return undefined;
118
+ const isGmailTool = name.startsWith("gmail_");
116
119
  return {
117
120
  name,
118
121
  description: "test tool",
119
- category: "credential-execution",
122
+ category: isGmailTool ? "gmail" : "credential-execution",
120
123
  defaultRiskLevel: "high",
124
+ executionTarget: isGmailTool ? ("host" as const) : undefined,
121
125
  getDefinition: () => ({}),
122
126
  execute: async () => fakeToolResult,
123
127
  };
@@ -257,6 +261,41 @@ describe("requireFreshApproval: non-interactive guardian denial", () => {
257
261
  expect(result.isError).toBe(false);
258
262
  });
259
263
 
264
+ test("medium-risk gmail archive is auto-approved in non-interactive guardian sessions", async () => {
265
+ riskOverride = RiskLevel.Medium;
266
+ checkResultOverride = {
267
+ decision: "prompt",
268
+ reason: "Needs approval",
269
+ };
270
+
271
+ const executor = new ToolExecutor(makePrompter());
272
+ const result = await executor.execute(
273
+ "gmail_archive",
274
+ { query: "in:inbox", confidence: 0.92 },
275
+ makeContext({ isInteractive: false, trustClass: "guardian" }),
276
+ );
277
+
278
+ expect(result.isError).toBe(false);
279
+ });
280
+
281
+ test("high-risk gmail send_draft is denied in non-interactive guardian sessions", async () => {
282
+ riskOverride = RiskLevel.High;
283
+ checkResultOverride = {
284
+ decision: "prompt",
285
+ reason: "Needs approval",
286
+ };
287
+
288
+ const executor = new ToolExecutor(makePrompter());
289
+ const result = await executor.execute(
290
+ "gmail_send_draft",
291
+ { draft_id: "draft-123", confidence: 0.99 },
292
+ makeContext({ isInteractive: false, trustClass: "guardian" }),
293
+ );
294
+
295
+ expect(result.isError).toBe(true);
296
+ expect(result.content).toContain("requires user approval");
297
+ });
298
+
260
299
  test("low-risk tools are still auto-approved in non-interactive guardian sessions", async () => {
261
300
  riskOverride = RiskLevel.Low;
262
301
  checkResultOverride = {
@@ -0,0 +1,132 @@
1
+ import { describe, expect, test } from "bun:test";
2
+
3
+ import { sanitizeConfigForTransfer } from "../config/sanitize-for-transfer.js";
4
+
5
+ describe("sanitizeConfigForTransfer", () => {
6
+ test("strips all four field groups", () => {
7
+ const input = {
8
+ ingress: {
9
+ publicBaseUrl: "https://example.com",
10
+ enabled: true,
11
+ webhook: { path: "/hook" },
12
+ },
13
+ daemon: { port: 3000, logLevel: "debug" },
14
+ skills: {
15
+ load: {
16
+ extraDirs: ["/custom/skills"],
17
+ builtIn: true,
18
+ },
19
+ },
20
+ name: "my-assistant",
21
+ };
22
+
23
+ const result = JSON.parse(sanitizeConfigForTransfer(JSON.stringify(input)));
24
+
25
+ expect(result.ingress.publicBaseUrl).toBe("");
26
+ expect(result.ingress.enabled).toBeUndefined();
27
+ expect(result.daemon).toBeUndefined();
28
+ expect(result.skills.load.extraDirs).toEqual([]);
29
+ });
30
+
31
+ test("preserves non-target fields unchanged", () => {
32
+ const input = {
33
+ name: "test",
34
+ model: "claude-3",
35
+ ingress: {
36
+ publicBaseUrl: "https://example.com",
37
+ enabled: true,
38
+ webhook: { path: "/hook" },
39
+ rateLimit: { max: 100 },
40
+ },
41
+ daemon: { port: 3000 },
42
+ skills: {
43
+ load: {
44
+ extraDirs: ["/dir"],
45
+ builtIn: true,
46
+ },
47
+ catalog: ["skill-a"],
48
+ },
49
+ memory: { enabled: true },
50
+ };
51
+
52
+ const result = JSON.parse(sanitizeConfigForTransfer(JSON.stringify(input)));
53
+
54
+ expect(result.name).toBe("test");
55
+ expect(result.model).toBe("claude-3");
56
+ expect(result.memory).toEqual({ enabled: true });
57
+ expect(result.skills.catalog).toEqual(["skill-a"]);
58
+ expect(result.skills.load.builtIn).toBe(true);
59
+ });
60
+
61
+ test("preserves nested ingress fields other than publicBaseUrl and enabled", () => {
62
+ const input = {
63
+ ingress: {
64
+ publicBaseUrl: "https://old.url",
65
+ enabled: false,
66
+ webhook: { path: "/webhook", secret: "abc" },
67
+ rateLimit: { max: 50, window: 60 },
68
+ },
69
+ };
70
+
71
+ const result = JSON.parse(sanitizeConfigForTransfer(JSON.stringify(input)));
72
+
73
+ expect(result.ingress.webhook).toEqual({ path: "/webhook", secret: "abc" });
74
+ expect(result.ingress.rateLimit).toEqual({ max: 50, window: 60 });
75
+ expect(result.ingress.publicBaseUrl).toBe("");
76
+ expect(result.ingress.enabled).toBeUndefined();
77
+ });
78
+
79
+ test("handles config missing some target fields", () => {
80
+ const input = {
81
+ name: "test",
82
+ ingress: { webhook: { path: "/hook" } },
83
+ };
84
+
85
+ const result = JSON.parse(sanitizeConfigForTransfer(JSON.stringify(input)));
86
+
87
+ expect(result.name).toBe("test");
88
+ expect(result.ingress.publicBaseUrl).toBe("");
89
+ expect(result.ingress.webhook).toEqual({ path: "/hook" });
90
+ });
91
+
92
+ test("handles config missing all target fields", () => {
93
+ const input = {
94
+ name: "test",
95
+ model: "claude-3",
96
+ };
97
+
98
+ const result = JSON.parse(sanitizeConfigForTransfer(JSON.stringify(input)));
99
+
100
+ expect(result.name).toBe("test");
101
+ expect(result.model).toBe("claude-3");
102
+ });
103
+
104
+ test("handles empty object", () => {
105
+ const result = sanitizeConfigForTransfer("{}");
106
+ expect(JSON.parse(result)).toEqual({});
107
+ });
108
+
109
+ test("handles invalid JSON by returning original string", () => {
110
+ const malformed = "{ not valid json }}}";
111
+ const result = sanitizeConfigForTransfer(malformed);
112
+ expect(result).toBe(malformed);
113
+ });
114
+
115
+ test("handles JSON null by returning original string", () => {
116
+ const result = sanitizeConfigForTransfer("null");
117
+ expect(result).toBe("null");
118
+ });
119
+
120
+ test("handles JSON array by returning original string", () => {
121
+ const result = sanitizeConfigForTransfer("[1, 2, 3]");
122
+ expect(result).toBe("[1, 2, 3]");
123
+ });
124
+
125
+ test("output uses 2-space indentation with trailing newline", () => {
126
+ const input = { name: "test" };
127
+ const result = sanitizeConfigForTransfer(JSON.stringify(input));
128
+
129
+ expect(result).toBe(JSON.stringify(input, null, 2) + "\n");
130
+ expect(result.endsWith("\n")).toBe(true);
131
+ });
132
+ });
@@ -0,0 +1,162 @@
1
+ import { beforeEach, describe, expect, mock, test } from "bun:test";
2
+
3
+ mock.module("../util/logger.js", () => ({
4
+ getLogger: () =>
5
+ new Proxy({} as Record<string, unknown>, {
6
+ get: () => () => {},
7
+ }),
8
+ }));
9
+
10
+ import { getDb, initializeDb } from "../memory/db.js";
11
+ import { scheduleRouteDefinitions } from "../runtime/routes/schedule-routes.js";
12
+ import { createSchedule } from "../schedule/schedule-store.js";
13
+ import { scheduleTask } from "../tasks/task-scheduler.js";
14
+ import { createTask } from "../tasks/task-store.js";
15
+
16
+ initializeDb();
17
+
18
+ function clearTables(): void {
19
+ const db = getDb();
20
+ db.run("DELETE FROM cron_runs");
21
+ db.run("DELETE FROM cron_jobs");
22
+ db.run("DELETE FROM task_runs");
23
+ db.run("DELETE FROM tasks");
24
+ db.run("DELETE FROM messages");
25
+ db.run("DELETE FROM conversations");
26
+ }
27
+
28
+ function getRunNowHandler(sendMessageDeps: {
29
+ getOrCreateConversation: (
30
+ conversationId: string,
31
+ options?: Record<string, unknown>,
32
+ ) => Promise<unknown>;
33
+ }) {
34
+ const route = scheduleRouteDefinitions({
35
+ sendMessageDeps: sendMessageDeps as never,
36
+ }).find(
37
+ (candidate) =>
38
+ candidate.endpoint === "schedules/:id/run" && candidate.method === "POST",
39
+ );
40
+ if (!route) {
41
+ throw new Error("Run-now schedule route not found");
42
+ }
43
+ return route.handler;
44
+ }
45
+
46
+ describe("schedule run-now trust propagation", () => {
47
+ beforeEach(() => {
48
+ clearTables();
49
+ });
50
+
51
+ test("manual run-now executes plain schedules with guardian trust", async () => {
52
+ const schedule = createSchedule({
53
+ name: "Direct schedule",
54
+ cronExpression: "* * * * *",
55
+ message: "scan my inbox",
56
+ syntax: "cron",
57
+ });
58
+
59
+ const getOrCreateCalls: Array<{
60
+ conversationId: string;
61
+ options?: Record<string, unknown>;
62
+ }> = [];
63
+ const processCalls: Array<unknown[]> = [];
64
+ const fakeConversation: {
65
+ taskRunId?: string;
66
+ processMessage: (...args: unknown[]) => Promise<string>;
67
+ } = {
68
+ taskRunId: "stale-task-run",
69
+ async processMessage(...args: unknown[]) {
70
+ processCalls.push(args);
71
+ return "message-id";
72
+ },
73
+ };
74
+
75
+ const handler = getRunNowHandler({
76
+ getOrCreateConversation: async (conversationId, options) => {
77
+ getOrCreateCalls.push({ conversationId, options });
78
+ return fakeConversation;
79
+ },
80
+ });
81
+
82
+ const response = await handler({
83
+ req: new Request(`http://localhost/v1/schedules/${schedule.id}/run`, {
84
+ method: "POST",
85
+ }),
86
+ url: new URL(`http://localhost/v1/schedules/${schedule.id}/run`),
87
+ server: {} as never,
88
+ authContext: {} as never,
89
+ params: { id: schedule.id },
90
+ });
91
+
92
+ expect(response.status).toBe(200);
93
+ expect(getOrCreateCalls).toHaveLength(1);
94
+ expect(getOrCreateCalls[0].options?.trustContext).toEqual({
95
+ sourceChannel: "vellum",
96
+ trustClass: "guardian",
97
+ });
98
+ expect(processCalls).toHaveLength(1);
99
+ expect(processCalls[0][0]).toBe("scan my inbox");
100
+ expect(processCalls[0][6]).toEqual({ isInteractive: false });
101
+ expect(fakeConversation.taskRunId).toBeUndefined();
102
+ });
103
+
104
+ test("manual run-now executes scheduled tasks with guardian trust and taskRunId", async () => {
105
+ const task = createTask({
106
+ title: "Email triage",
107
+ template: "triage inbox in background",
108
+ });
109
+ const schedule = scheduleTask({
110
+ taskId: task.id,
111
+ name: "Scheduled task",
112
+ cronExpression: "* * * * *",
113
+ });
114
+
115
+ const getOrCreateCalls: Array<{
116
+ conversationId: string;
117
+ options?: Record<string, unknown>;
118
+ }> = [];
119
+ const observedTaskRunIds: Array<string | undefined> = [];
120
+ const processCalls: Array<unknown[]> = [];
121
+ const fakeConversation: {
122
+ taskRunId?: string;
123
+ processMessage: (...args: unknown[]) => Promise<string>;
124
+ } = {
125
+ taskRunId: undefined,
126
+ async processMessage(...args: unknown[]) {
127
+ observedTaskRunIds.push(fakeConversation.taskRunId);
128
+ processCalls.push(args);
129
+ return "message-id";
130
+ },
131
+ };
132
+
133
+ const handler = getRunNowHandler({
134
+ getOrCreateConversation: async (conversationId, options) => {
135
+ getOrCreateCalls.push({ conversationId, options });
136
+ return fakeConversation;
137
+ },
138
+ });
139
+
140
+ const response = await handler({
141
+ req: new Request(`http://localhost/v1/schedules/${schedule.id}/run`, {
142
+ method: "POST",
143
+ }),
144
+ url: new URL(`http://localhost/v1/schedules/${schedule.id}/run`),
145
+ server: {} as never,
146
+ authContext: {} as never,
147
+ params: { id: schedule.id },
148
+ });
149
+
150
+ expect(response.status).toBe(200);
151
+ expect(getOrCreateCalls).toHaveLength(1);
152
+ expect(getOrCreateCalls[0].options?.trustContext).toEqual({
153
+ sourceChannel: "vellum",
154
+ trustClass: "guardian",
155
+ });
156
+ expect(processCalls).toHaveLength(1);
157
+ expect(processCalls[0][0]).toBe("triage inbox in background");
158
+ expect(processCalls[0][6]).toEqual({ isInteractive: false });
159
+ expect(typeof observedTaskRunIds[0]).toBe("string");
160
+ expect(fakeConversation.taskRunId).toBeUndefined();
161
+ });
162
+ });
@@ -0,0 +1,84 @@
1
+ import { beforeEach, describe, expect, mock, test } from "bun:test";
2
+
3
+ import { _setOverridesForTesting } from "../config/assistant-feature-flags.js";
4
+
5
+ const triggerMock = mock(async () => {});
6
+ const scanTextMock = mock(() => [
7
+ { type: "api_key", redactedValue: "sk-***redacted***" },
8
+ ]);
9
+
10
+ mock.module("../config/loader.js", () => ({
11
+ getConfig: () => ({
12
+ secretDetection: {
13
+ enabled: true,
14
+ action: "prompt",
15
+ entropyThreshold: 4.5,
16
+ customPatterns: [],
17
+ },
18
+ }),
19
+ }));
20
+
21
+ mock.module("../hooks/manager.js", () => ({
22
+ getHookManager: () => ({
23
+ trigger: triggerMock,
24
+ }),
25
+ }));
26
+
27
+ mock.module("../security/secret-scanner.js", () => ({
28
+ compileCustomPatterns: () => [],
29
+ redactSecrets: (content: string) => content,
30
+ scanText: scanTextMock,
31
+ }));
32
+
33
+ import { SecretDetectionHandler } from "../tools/secret-detection-handler.js";
34
+
35
+ describe("SecretDetectionHandler under v2", () => {
36
+ beforeEach(() => {
37
+ _setOverridesForTesting({});
38
+ triggerMock.mockClear();
39
+ scanTextMock.mockClear();
40
+ });
41
+
42
+ test("blocks secret output without opening a deterministic approval prompt", async () => {
43
+ _setOverridesForTesting({ "permission-controls-v2": true });
44
+
45
+ const promptMock = mock(async () => ({ decision: "allow" as const }));
46
+ const handler = new SecretDetectionHandler({
47
+ prompt: promptMock,
48
+ } as never);
49
+ const emitLifecycleEvent = mock(() => {});
50
+
51
+ const result = await handler.handle(
52
+ { content: "secret output", isError: false },
53
+ "bash",
54
+ { command: "print-secret" },
55
+ {
56
+ conversationId: "conv-1",
57
+ workingDir: "/tmp",
58
+ requestId: "req-1",
59
+ isInteractive: true,
60
+ } as never,
61
+ "sandbox",
62
+ "medium",
63
+ "allow",
64
+ Date.now(),
65
+ emitLifecycleEvent,
66
+ (_toolName, input) => input,
67
+ );
68
+
69
+ expect(result.earlyReturn).toBe(true);
70
+ expect(result.result.isError).toBe(true);
71
+ expect(result.result.content).toContain(
72
+ "Secret-output approval cards are disabled under v2",
73
+ );
74
+ expect(promptMock).not.toHaveBeenCalled();
75
+ expect(emitLifecycleEvent).toHaveBeenCalledWith(
76
+ expect.anything(),
77
+ expect.objectContaining({
78
+ type: "permission_denied",
79
+ decision: "deny",
80
+ }),
81
+ );
82
+ expect(triggerMock).toHaveBeenCalled();
83
+ });
84
+ });
@@ -175,6 +175,7 @@ function makeSendMessageDeps() {
175
175
  trustContext: undefined,
176
176
  hasPendingConfirmation: () => false,
177
177
  setHostBashProxy: () => {},
178
+ setHostBrowserProxy: () => {},
178
179
  setHostFileProxy: () => {},
179
180
  setHostCuProxy: () => {},
180
181
  addPreactivatedSkillId: () => {},
@@ -115,6 +115,7 @@ function makeCompletingConversation(): Conversation {
115
115
  usageStats: { inputTokens: 0, outputTokens: 0, estimatedCost: 0 },
116
116
  updateClient: () => {},
117
117
  setHostBashProxy: () => {},
118
+ setHostBrowserProxy: () => {},
118
119
  setHostFileProxy: () => {},
119
120
  setHostCuProxy: () => {},
120
121
  addPreactivatedSkillId: () => {},
@@ -173,6 +174,7 @@ function makeHangingConversation(): Conversation {
173
174
  usageStats: { inputTokens: 0, outputTokens: 0, estimatedCost: 0 },
174
175
  updateClient: () => {},
175
176
  setHostBashProxy: () => {},
177
+ setHostBrowserProxy: () => {},
176
178
  setHostFileProxy: () => {},
177
179
  setHostCuProxy: () => {},
178
180
  addPreactivatedSkillId: () => {},
@@ -259,6 +261,7 @@ function makePendingApprovalConversation(
259
261
  usageStats: { inputTokens: 0, outputTokens: 0, estimatedCost: 0 },
260
262
  updateClient: () => {},
261
263
  setHostBashProxy: () => {},
264
+ setHostBrowserProxy: () => {},
262
265
  setHostFileProxy: () => {},
263
266
  setHostCuProxy: () => {},
264
267
  addPreactivatedSkillId: () => {},