@vellumai/assistant 0.6.2 → 0.6.4

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 (895) hide show
  1. package/ARCHITECTURE.md +273 -10
  2. package/Dockerfile +2 -3
  3. package/bun.lock +41 -49
  4. package/bunfig.toml +3 -0
  5. package/docs/architecture/memory.md +1 -1
  6. package/docs/backup-troubleshooting.md +52 -0
  7. package/docs/browser-use-architecture-phase2.md +174 -0
  8. package/docs/stt-provider-onboarding.md +120 -0
  9. package/knip.json +12 -2
  10. package/node_modules/@vellumai/ces-contracts/bun.lock +8 -6
  11. package/node_modules/@vellumai/ces-contracts/package.json +3 -3
  12. package/node_modules/@vellumai/ces-contracts/src/rpc.ts +42 -0
  13. package/openapi.yaml +1111 -86
  14. package/package.json +40 -42
  15. package/scripts/generate-openapi.ts +0 -2
  16. package/scripts/test.sh +73 -18
  17. package/src/__tests__/acp-session.test.ts +43 -0
  18. package/src/__tests__/agent-image-optimize.test.ts +28 -0
  19. package/src/__tests__/agent-loop.test.ts +123 -0
  20. package/src/__tests__/anthropic-provider.test.ts +263 -10
  21. package/src/__tests__/app-builder-tool-scripts.test.ts +1 -0
  22. package/src/__tests__/app-executors.test.ts +1 -0
  23. package/src/__tests__/app-source-watcher.test.ts +37 -11
  24. package/src/__tests__/approval-routes-http.test.ts +178 -1
  25. package/src/__tests__/auto-analysis-end-to-end.test.ts +550 -0
  26. package/src/__tests__/auto-analysis-prompt.test.ts +50 -0
  27. package/src/__tests__/browser-fill-credential.test.ts +240 -94
  28. package/src/__tests__/browser-manager.test.ts +40 -27
  29. package/src/__tests__/browser-skill-baseline-tool-payload.test.ts +2 -2
  30. package/src/__tests__/browser-skill-endstate.test.ts +31 -7
  31. package/src/__tests__/btw-routes.test.ts +7 -0
  32. package/src/__tests__/call-controller.test.ts +581 -20
  33. package/src/__tests__/catalog-files.test.ts +1000 -0
  34. package/src/__tests__/channel-approvals.test.ts +53 -0
  35. package/src/__tests__/channel-invite-transport.test.ts +2 -2
  36. package/src/__tests__/channel-readiness-routes.test.ts +16 -20
  37. package/src/__tests__/channel-readiness-service.test.ts +12 -7
  38. package/src/__tests__/checker.test.ts +157 -10
  39. package/src/__tests__/clawhub-files.test.ts +347 -0
  40. package/src/__tests__/commit-message-enrichment-service.test.ts +36 -19
  41. package/src/__tests__/config-analysis.test.ts +100 -0
  42. package/src/__tests__/config-managed-gemini-defaults.test.ts +326 -0
  43. package/src/__tests__/config-schema-cmd.test.ts +2 -2
  44. package/src/__tests__/config-schema.test.ts +1248 -224
  45. package/src/__tests__/config-watcher-cleanup-throttle.test.ts +339 -0
  46. package/src/__tests__/config-watcher.test.ts +43 -8
  47. package/src/__tests__/confirmation-request-guardian-bridge.test.ts +23 -0
  48. package/src/__tests__/contact-store-user-file.test.ts +512 -0
  49. package/src/__tests__/contacts-write.test.ts +197 -0
  50. package/src/__tests__/context-overflow-approval.test.ts +16 -1
  51. package/src/__tests__/context-window-manager.test.ts +88 -0
  52. package/src/__tests__/conversation-abort-tool-results.test.ts +2 -0
  53. package/src/__tests__/conversation-agent-loop-overflow.test.ts +2 -1
  54. package/src/__tests__/conversation-agent-loop.test.ts +99 -3
  55. package/src/__tests__/conversation-analysis-routes.test.ts +2 -2
  56. package/src/__tests__/conversation-attachments.test.ts +80 -4
  57. package/src/__tests__/conversation-confirmation-signals.test.ts +290 -0
  58. package/src/__tests__/conversation-error.test.ts +70 -0
  59. package/src/__tests__/conversation-fork-crud.test.ts +17 -0
  60. package/src/__tests__/conversation-history-web-search.test.ts +12 -4
  61. package/src/__tests__/conversation-host-access-routes.test.ts +229 -0
  62. package/src/__tests__/conversation-init.benchmark.test.ts +6 -1
  63. package/src/__tests__/conversation-inject-context.test.ts +103 -0
  64. package/src/__tests__/conversation-launcher-skill-regression.test.ts +51 -0
  65. package/src/__tests__/conversation-list-source.test.ts +145 -0
  66. package/src/__tests__/conversation-pre-run-repair.test.ts +2 -0
  67. package/src/__tests__/conversation-provider-retry-repair.test.ts +2 -0
  68. package/src/__tests__/conversation-queue.test.ts +946 -62
  69. package/src/__tests__/conversation-routes-disk-view.test.ts +275 -0
  70. package/src/__tests__/conversation-routes-guardian-reply.test.ts +16 -0
  71. package/src/__tests__/conversation-routes-slash-commands.test.ts +1 -0
  72. package/src/__tests__/conversation-runtime-assembly.test.ts +324 -46
  73. package/src/__tests__/conversation-skill-tools.test.ts +7 -4
  74. package/src/__tests__/conversation-slash-commands.test.ts +33 -0
  75. package/src/__tests__/conversation-slash-queue.test.ts +89 -18
  76. package/src/__tests__/conversation-slash-unknown.test.ts +2 -0
  77. package/src/__tests__/conversation-starter-routes.test.ts +126 -0
  78. package/src/__tests__/conversation-starters-cadence.test.ts +161 -0
  79. package/src/__tests__/conversation-store.test.ts +195 -0
  80. package/src/__tests__/conversation-tool-setup-batch-authorized.test.ts +226 -0
  81. package/src/__tests__/conversation-workspace-cache-state.test.ts +193 -0
  82. package/src/__tests__/conversation-workspace-injection.test.ts +2 -0
  83. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +2 -0
  84. package/src/__tests__/credential-execution-approval-bridge.test.ts +32 -1
  85. package/src/__tests__/credential-health-service.test.ts +352 -0
  86. package/src/__tests__/credential-security-invariants.test.ts +6 -3
  87. package/src/__tests__/credential-vault-unit.test.ts +383 -7
  88. package/src/__tests__/credential-vault.test.ts +152 -13
  89. package/src/__tests__/credentials-cli.test.ts +42 -18
  90. package/src/__tests__/cross-provider-web-search.test.ts +146 -35
  91. package/src/__tests__/date-context.test.ts +4 -4
  92. package/src/__tests__/deterministic-verification-control-plane.test.ts +10 -1
  93. package/src/__tests__/device-id.test.ts +112 -0
  94. package/src/__tests__/docker-signing-key-bootstrap.test.ts +167 -4
  95. package/src/__tests__/dynamic-skill-workflow-prompt.test.ts +1 -3
  96. package/src/__tests__/email-html-renderer.test.ts +71 -0
  97. package/src/__tests__/email-invite-adapter.test.ts +36 -32
  98. package/src/__tests__/embedding-managed-proxy-selection.test.ts +256 -0
  99. package/src/__tests__/emit-event-signal.test.ts +71 -0
  100. package/src/__tests__/extension-id-sync-guard.test.ts +222 -0
  101. package/src/__tests__/fixtures/mock-chrome-extension.ts +386 -0
  102. package/src/__tests__/gateway-only-enforcement.test.ts +206 -1
  103. package/src/__tests__/gateway-only-guard.test.ts +2 -0
  104. package/src/__tests__/gemini-provider.test.ts +66 -2
  105. package/src/__tests__/get-skill-detail-audit.test.ts +325 -0
  106. package/src/__tests__/gmail-archive-fallback.test.ts +193 -0
  107. package/src/__tests__/gmail-archive-gate.test.ts +246 -0
  108. package/src/__tests__/gmail-preferences.test.ts +117 -0
  109. package/src/__tests__/guardian-routing-invariants.test.ts +70 -2
  110. package/src/__tests__/headless-browser-interactions.test.ts +738 -359
  111. package/src/__tests__/headless-browser-mode.test.ts +614 -0
  112. package/src/__tests__/headless-browser-navigate.test.ts +528 -49
  113. package/src/__tests__/headless-browser-read-tools.test.ts +274 -100
  114. package/src/__tests__/headless-browser-snapshot.test.ts +250 -77
  115. package/src/__tests__/heartbeat-service.test.ts +70 -17
  116. package/src/__tests__/home-state-routes.test.ts +162 -0
  117. package/src/__tests__/host-bash-proxy.test.ts +145 -1
  118. package/src/__tests__/host-browser-e2e-cloud.test.ts +596 -0
  119. package/src/__tests__/host-browser-e2e-self-hosted-capability.test.ts +286 -0
  120. package/src/__tests__/host-browser-e2e-self-hosted.test.ts +374 -0
  121. package/src/__tests__/host-browser-event-routes.test.ts +350 -0
  122. package/src/__tests__/host-browser-proxy.test.ts +444 -0
  123. package/src/__tests__/host-browser-routes.test.ts +198 -0
  124. package/src/__tests__/host-browser-ws-events-e2e.test.ts +423 -0
  125. package/src/__tests__/host-cu-proxy.test.ts +166 -1
  126. package/src/__tests__/host-file-proxy.test.ts +185 -1
  127. package/src/__tests__/host-file-read-tool.test.ts +52 -0
  128. package/src/__tests__/host-proxy-interface.test.ts +165 -0
  129. package/src/__tests__/host-shell-tool.test.ts +1 -11
  130. package/src/__tests__/http-user-message-parity.test.ts +1 -0
  131. package/src/__tests__/identity-intro-cache.test.ts +40 -10
  132. package/src/__tests__/init-feature-flag-overrides.test.ts +38 -112
  133. package/src/__tests__/integration-status.test.ts +6 -7
  134. package/src/__tests__/jobs-store-upsert-debounced.test.ts +141 -0
  135. package/src/__tests__/list-messages-tool-merge.test.ts +37 -12
  136. package/src/__tests__/llm-context-normalization.test.ts +488 -0
  137. package/src/__tests__/llm-context-route-provider.test.ts +86 -5
  138. package/src/__tests__/llm-usage-store.test.ts +363 -0
  139. package/src/__tests__/mcp-client-auth.test.ts +40 -4
  140. package/src/__tests__/mcp-health-check.test.ts +10 -3
  141. package/src/__tests__/media-stream-output.test.ts +555 -0
  142. package/src/__tests__/media-stream-parser.test.ts +374 -0
  143. package/src/__tests__/media-stream-server-integration.test.ts +1234 -0
  144. package/src/__tests__/media-stream-stt-session.test.ts +588 -0
  145. package/src/__tests__/media-turn-detector.test.ts +440 -0
  146. package/src/__tests__/message-queue.test.ts +125 -0
  147. package/src/__tests__/migration-cross-version-compatibility.test.ts +3 -1
  148. package/src/__tests__/migration-export-http.test.ts +67 -8
  149. package/src/__tests__/migration-export-streaming.test.ts +66 -0
  150. package/src/__tests__/migration-import-commit-http.test.ts +109 -7
  151. package/src/__tests__/migration-import-preflight-http.test.ts +6 -5
  152. package/src/__tests__/migration-validate-http.test.ts +3 -3
  153. package/src/__tests__/mock-gateway-ipc.ts +151 -0
  154. package/src/__tests__/model-intents.test.ts +2 -2
  155. package/src/__tests__/native-host-marker-sync-guard.test.ts +157 -0
  156. package/src/__tests__/oauth-apps-routes.test.ts +18 -12
  157. package/src/__tests__/oauth-cli.test.ts +709 -60
  158. package/src/__tests__/oauth-connect-orchestrator.test.ts +118 -24
  159. package/src/__tests__/oauth-provider-seed-logos.test.ts +23 -0
  160. package/src/__tests__/oauth-provider-serializer.test.ts +147 -10
  161. package/src/__tests__/oauth-provider-visibility.test.ts +19 -21
  162. package/src/__tests__/oauth-providers-routes.test.ts +52 -14
  163. package/src/__tests__/oauth-store.test.ts +1465 -176
  164. package/src/__tests__/oauth2-gateway-transport.test.ts +460 -26
  165. package/src/__tests__/onboarding-template-contract.test.ts +81 -70
  166. package/src/__tests__/openai-provider.test.ts +178 -2
  167. package/src/__tests__/openai-responses-cutover-guard.test.ts +184 -0
  168. package/src/__tests__/openai-responses-provider.test.ts +1105 -0
  169. package/src/__tests__/openrouter-token-estimation.test.ts +100 -0
  170. package/src/__tests__/outlook-categories.test.ts +1 -1
  171. package/src/__tests__/outlook-client-automation.test.ts +1 -1
  172. package/src/__tests__/outlook-compose-tools.test.ts +1 -1
  173. package/src/__tests__/outlook-email-watcher.test.ts +1 -1
  174. package/src/__tests__/outlook-follow-up.test.ts +1 -1
  175. package/src/__tests__/outlook-messaging-provider.test.ts +2 -2
  176. package/src/__tests__/outlook-trash.test.ts +1 -1
  177. package/src/__tests__/outlook-unsubscribe.test.ts +32 -3
  178. package/src/__tests__/permission-checker-host-gate.test.ts +74 -14
  179. package/src/__tests__/permission-mode.test.ts +28 -56
  180. package/src/__tests__/persona-resolver.test.ts +251 -0
  181. package/src/__tests__/platform-bash-auto-approve.test.ts +4 -0
  182. package/src/__tests__/platform-callback-registration.test.ts +19 -0
  183. package/src/__tests__/platform.test.ts +92 -1
  184. package/src/__tests__/post-turn-tool-result-truncation.test.ts +343 -0
  185. package/src/__tests__/prechat-onboarding-contract.test.ts +267 -0
  186. package/src/__tests__/pricing.test.ts +174 -0
  187. package/src/__tests__/proxy-approval-callback.test.ts +18 -0
  188. package/src/__tests__/qdrant-manager.test.ts +29 -8
  189. package/src/__tests__/regenerate-fire-and-forget-trace.test.ts +194 -0
  190. package/src/__tests__/relationship-state-contract.test.ts +175 -0
  191. package/src/__tests__/relay-server.test.ts +423 -5
  192. package/src/__tests__/require-fresh-approval.test.ts +40 -1
  193. package/src/__tests__/sanitize-config-for-transfer.test.ts +132 -0
  194. package/src/__tests__/schedule-routes.test.ts +162 -0
  195. package/src/__tests__/search-skills-unified.test.ts +118 -0
  196. package/src/__tests__/secret-detection-handler.test.ts +84 -0
  197. package/src/__tests__/secret-ingress-http.test.ts +1 -0
  198. package/src/__tests__/secret-scanner-executor.test.ts +4 -0
  199. package/src/__tests__/secure-keys.test.ts +107 -0
  200. package/src/__tests__/send-endpoint-busy.test.ts +8 -1
  201. package/src/__tests__/sequence-store.test.ts +1 -1
  202. package/src/__tests__/server-history-render.test.ts +49 -0
  203. package/src/__tests__/set-permission-mode.test.ts +13 -250
  204. package/src/__tests__/settings-routes.test.ts +201 -0
  205. package/src/__tests__/skill-load-feature-flag.test.ts +1 -0
  206. package/src/__tests__/skills-file-content-endpoint.test.ts +801 -0
  207. package/src/__tests__/skills-files-catalog-fallback.test.ts +738 -0
  208. package/src/__tests__/skills.test.ts +5 -2
  209. package/src/__tests__/skillssh-files.test.ts +446 -0
  210. package/src/__tests__/slack-block-formatting.test.ts +110 -0
  211. package/src/__tests__/slack-channel-config.test.ts +576 -16
  212. package/src/__tests__/stt-catalog-parity.test.ts +282 -0
  213. package/src/__tests__/stt-stream-session.test.ts +535 -0
  214. package/src/__tests__/subagent-detail.test.ts +44 -2
  215. package/src/__tests__/subagent-disposal.test.ts +1 -0
  216. package/src/__tests__/subagent-fork-notifications.test.ts +291 -0
  217. package/src/__tests__/subagent-fork-spawn.test.ts +384 -0
  218. package/src/__tests__/subagent-manager-notify.test.ts +1 -0
  219. package/src/__tests__/subagent-notify-parent.test.ts +1 -0
  220. package/src/__tests__/subagent-spawn-tool-fork.test.ts +411 -0
  221. package/src/__tests__/subagent-tools.test.ts +1 -0
  222. package/src/__tests__/subagent-types.test.ts +1 -0
  223. package/src/__tests__/system-prompt-ask-mode.test.ts +27 -71
  224. package/src/__tests__/system-prompt.test.ts +184 -27
  225. package/src/__tests__/task-scheduler.test.ts +32 -6
  226. package/src/__tests__/telegram-config.test.ts +10 -13
  227. package/src/__tests__/telephony-stt-routing.test.ts +329 -0
  228. package/src/__tests__/terminal-tools.test.ts +25 -5
  229. package/src/__tests__/test-preload.ts +18 -0
  230. package/src/__tests__/test-support/browser-skill-harness.ts +4 -1
  231. package/src/__tests__/tool-approval-handler.test.ts +73 -0
  232. package/src/__tests__/tool-executor-lifecycle-events.test.ts +9 -5
  233. package/src/__tests__/tool-executor-shell-integration.test.ts +4 -0
  234. package/src/__tests__/tool-executor.test.ts +33 -24
  235. package/src/__tests__/tool-result-truncation.test.ts +36 -0
  236. package/src/__tests__/tool-side-effects-slack-dm.test.ts +22 -0
  237. package/src/__tests__/top-level-renderer.test.ts +73 -1
  238. package/src/__tests__/transport-hints-queue.test.ts +14 -29
  239. package/src/__tests__/trust-store.test.ts +7 -1
  240. package/src/__tests__/trusted-contact-approval-notifier.test.ts +1 -1
  241. package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +109 -0
  242. package/src/__tests__/tts-catalog-parity.test.ts +345 -0
  243. package/src/__tests__/twilio-routes-twiml.test.ts +512 -114
  244. package/src/__tests__/twilio-routes.test.ts +376 -0
  245. package/src/__tests__/unicode.test.ts +293 -0
  246. package/src/__tests__/update-bulletin-format.test.ts +59 -0
  247. package/src/__tests__/update-bulletin.test.ts +206 -5
  248. package/src/__tests__/usage-routes.test.ts +25 -4
  249. package/src/__tests__/user-reference.test.ts +46 -61
  250. package/src/__tests__/v2-consent-policy.test.ts +103 -0
  251. package/src/__tests__/verification-control-plane-policy.test.ts +4 -0
  252. package/src/__tests__/voice-config-update.test.ts +403 -0
  253. package/src/__tests__/voice-quality.test.ts +434 -19
  254. package/src/__tests__/workspace-heartbeat-service.test.ts +7 -0
  255. package/src/__tests__/workspace-migration-033-stt-service-explicit-config.test.ts +547 -0
  256. package/src/__tests__/workspace-migration-034-remove-calls-voice-transcription-provider.test.ts +596 -0
  257. package/src/__tests__/workspace-migration-drop-user-md.test.ts +368 -0
  258. package/src/__tests__/workspace-migration-meets.test.ts +244 -0
  259. package/src/__tests__/workspace-migration-seed-device-id.test.ts +14 -20
  260. package/src/__tests__/workspace-policy.test.ts +2 -0
  261. package/src/acp/client-handler.ts +30 -4
  262. package/src/agent/image-optimize.ts +24 -12
  263. package/src/agent/loop.ts +55 -9
  264. package/src/approvals/guardian-request-resolvers.ts +21 -15
  265. package/src/backup/__tests__/backup-key.test.ts +152 -0
  266. package/src/backup/__tests__/backup-worker.test.ts +767 -0
  267. package/src/backup/__tests__/list-snapshots.test.ts +87 -0
  268. package/src/backup/__tests__/local-writer.test.ts +218 -0
  269. package/src/backup/__tests__/offsite-writer.test.ts +641 -0
  270. package/src/backup/__tests__/paths.test.ts +300 -0
  271. package/src/backup/__tests__/restore.test.ts +498 -0
  272. package/src/backup/__tests__/snapshot-lock.test.ts +352 -0
  273. package/src/backup/__tests__/stream-crypt.test.ts +228 -0
  274. package/src/backup/backup-key.ts +137 -0
  275. package/src/backup/backup-worker.ts +459 -0
  276. package/src/backup/list-snapshots.ts +147 -0
  277. package/src/backup/local-writer.ts +133 -0
  278. package/src/backup/offsite-writer.ts +222 -0
  279. package/src/backup/paths.ts +226 -0
  280. package/src/backup/restore.ts +322 -0
  281. package/src/backup/snapshot-lock.ts +431 -0
  282. package/src/backup/stream-crypt.ts +263 -0
  283. package/src/browser-session/__tests__/manager.test.ts +297 -0
  284. package/src/browser-session/backends/cdp-inspect.ts +30 -0
  285. package/src/browser-session/backends/extension.ts +26 -0
  286. package/src/browser-session/backends/local.ts +24 -0
  287. package/src/browser-session/events.ts +164 -0
  288. package/src/browser-session/index.ts +27 -0
  289. package/src/browser-session/manager.ts +159 -0
  290. package/src/browser-session/types.ts +28 -0
  291. package/src/bundler/package-resolver.ts +4 -0
  292. package/src/calls/audio-store.ts +11 -5
  293. package/src/calls/call-controller.ts +226 -71
  294. package/src/calls/call-domain.ts +9 -0
  295. package/src/calls/call-speech-output.ts +190 -0
  296. package/src/calls/call-transport.ts +77 -0
  297. package/src/calls/media-stream-audio-transcode.ts +173 -0
  298. package/src/calls/media-stream-output.ts +660 -0
  299. package/src/calls/media-stream-parser.ts +300 -0
  300. package/src/calls/media-stream-protocol.ts +166 -0
  301. package/src/calls/media-stream-server.ts +592 -0
  302. package/src/calls/media-stream-stt-session.ts +460 -0
  303. package/src/calls/media-turn-detector.ts +230 -0
  304. package/src/calls/relay-server.ts +90 -75
  305. package/src/calls/resolve-call-tts-provider.ts +136 -0
  306. package/src/calls/telephony-stt-routing.ts +145 -0
  307. package/src/calls/tts-call-strategy.ts +161 -0
  308. package/src/calls/tts-text-sanitizer.ts +32 -16
  309. package/src/calls/twilio-routes.ts +281 -17
  310. package/src/calls/voice-quality.ts +78 -35
  311. package/src/calls/voice-session-bridge.ts +8 -1
  312. package/src/channels/__tests__/types.test.ts +134 -0
  313. package/src/channels/types.ts +69 -3
  314. package/src/cli/__tests__/run-assistant-command.ts +11 -1
  315. package/src/cli/commands/__tests__/backup.test.ts +1165 -0
  316. package/src/cli/commands/__tests__/domain-register.test.ts +234 -0
  317. package/src/cli/commands/__tests__/domain-status.test.ts +132 -0
  318. package/src/cli/commands/__tests__/email-attachment.test.ts +422 -0
  319. package/src/cli/commands/__tests__/email-download.test.ts +16 -1
  320. package/src/cli/commands/__tests__/email-list.test.ts +22 -4
  321. package/src/cli/commands/__tests__/email-register.test.ts +4 -4
  322. package/src/cli/commands/__tests__/email-send.test.ts +37 -4
  323. package/src/cli/commands/__tests__/email-status.test.ts +5 -1
  324. package/src/cli/commands/__tests__/email-unregister.test.ts +34 -5
  325. package/src/cli/commands/backup.ts +993 -0
  326. package/src/cli/commands/conversations.ts +77 -0
  327. package/src/cli/commands/credentials.ts +3 -4
  328. package/src/cli/commands/domain.ts +210 -0
  329. package/src/cli/commands/email.ts +273 -16
  330. package/src/cli/commands/mcp.ts +16 -4
  331. package/src/cli/commands/oauth/__tests__/connect.test.ts +56 -44
  332. package/src/cli/commands/oauth/__tests__/disconnect.test.ts +21 -21
  333. package/src/cli/commands/oauth/__tests__/mode.test.ts +17 -17
  334. package/src/cli/commands/oauth/__tests__/ping.test.ts +16 -16
  335. package/src/cli/commands/oauth/__tests__/providers-delete.test.ts +32 -33
  336. package/src/cli/commands/oauth/__tests__/providers-register.test.ts +330 -0
  337. package/src/cli/commands/oauth/__tests__/providers-update.test.ts +117 -12
  338. package/src/cli/commands/oauth/__tests__/status.test.ts +10 -10
  339. package/src/cli/commands/oauth/__tests__/token.test.ts +7 -7
  340. package/src/cli/commands/oauth/apps.ts +7 -4
  341. package/src/cli/commands/oauth/connect.ts +6 -3
  342. package/src/cli/commands/oauth/disconnect.ts +1 -1
  343. package/src/cli/commands/oauth/mode.ts +12 -3
  344. package/src/cli/commands/oauth/providers.ts +215 -36
  345. package/src/cli/commands/oauth/shared.ts +7 -6
  346. package/src/cli/commands/platform/__tests__/callback-routes-list.test.ts +254 -0
  347. package/src/cli/commands/platform/__tests__/connect.test.ts +6 -0
  348. package/src/cli/commands/platform/__tests__/disconnect.test.ts +7 -1
  349. package/src/cli/commands/platform/__tests__/status.test.ts +6 -0
  350. package/src/cli/commands/platform/index.ts +107 -10
  351. package/src/cli/commands/usage.ts +10 -9
  352. package/src/cli/lib/daemon-credential-client.ts +4 -0
  353. package/src/cli/program.ts +30 -4
  354. package/src/config/__tests__/backup-schema.test.ts +134 -0
  355. package/src/config/assistant-feature-flags.ts +61 -62
  356. package/src/config/bundled-skills/app-builder/SKILL.md +26 -249
  357. package/src/config/bundled-skills/app-builder/references/CUSTOM_ROUTES.md +141 -0
  358. package/src/config/bundled-skills/app-builder/references/INTERACTION_HOOKS.md +56 -0
  359. package/src/config/bundled-skills/app-builder/references/WIDGETS.md +125 -0
  360. package/src/config/bundled-skills/browser/SKILL.md +30 -5
  361. package/src/config/bundled-skills/browser/TOOLS.json +123 -0
  362. package/src/config/bundled-skills/browser/tools/browser-attach.ts +12 -0
  363. package/src/config/bundled-skills/browser/tools/browser-detach.ts +12 -0
  364. package/src/config/bundled-skills/browser/tools/browser-status.ts +12 -0
  365. package/src/config/bundled-skills/browser/tools/browser-wait-for-download.ts +17 -0
  366. package/src/config/bundled-skills/contacts/SKILL.md +5 -2
  367. package/src/config/bundled-skills/document/SKILL.md +4 -0
  368. package/src/config/bundled-skills/gmail/SKILL.md +54 -8
  369. package/src/config/bundled-skills/gmail/TOOLS.json +33 -3
  370. package/src/config/bundled-skills/gmail/tools/gmail-archive.ts +116 -9
  371. package/src/config/bundled-skills/gmail/tools/gmail-outreach-scan.ts +138 -11
  372. package/src/config/bundled-skills/gmail/tools/gmail-preferences-tool.ts +59 -0
  373. package/src/config/bundled-skills/gmail/tools/gmail-preferences.ts +82 -0
  374. package/src/config/bundled-skills/gmail/tools/gmail-sender-digest.ts +113 -17
  375. package/src/config/bundled-skills/gmail/tools/gmail-unsubscribe.ts +2 -2
  376. package/src/config/bundled-skills/media-processing/SKILL.md +3 -9
  377. package/src/config/bundled-skills/media-processing/TOOLS.json +1 -6
  378. package/src/config/bundled-skills/media-processing/__tests__/audio-transcribe.test.ts +125 -0
  379. package/src/config/bundled-skills/media-processing/__tests__/extract-keyframes.test.ts +181 -0
  380. package/src/config/bundled-skills/media-processing/__tests__/preprocess-audio.test.ts +141 -0
  381. package/src/config/bundled-skills/media-processing/services/audio-transcribe.ts +32 -87
  382. package/src/config/bundled-skills/media-processing/services/preprocess.ts +8 -4
  383. package/src/config/bundled-skills/media-processing/tools/extract-keyframes.ts +0 -10
  384. package/src/config/bundled-skills/messaging/SKILL.md +3 -3
  385. package/src/config/bundled-skills/messaging/tools/messaging-archive-by-sender.ts +2 -2
  386. package/src/config/bundled-skills/outlook/SKILL.md +9 -2
  387. package/src/config/bundled-skills/outlook/tools/outlook-unsubscribe.ts +2 -2
  388. package/src/config/bundled-skills/phone-calls/SKILL.md +2 -2
  389. package/src/config/bundled-skills/phone-calls/references/CONFIG.md +27 -18
  390. package/src/config/bundled-skills/phone-calls/references/TROUBLESHOOTING.md +3 -3
  391. package/src/config/bundled-skills/settings/TOOLS.json +3 -3
  392. package/src/config/bundled-skills/settings/tools/voice-config-update.ts +26 -22
  393. package/src/config/bundled-skills/slack/SKILL.md +1 -0
  394. package/src/config/bundled-skills/subagent/SKILL.md +21 -0
  395. package/src/config/bundled-skills/subagent/TOOLS.json +8 -4
  396. package/src/config/bundled-skills/tasks/SKILL.md +5 -0
  397. package/src/config/bundled-skills/transcribe/SKILL.md +9 -14
  398. package/src/config/bundled-skills/transcribe/TOOLS.json +2 -7
  399. package/src/config/bundled-skills/transcribe/tools/transcribe-media.test.ts +256 -0
  400. package/src/config/bundled-skills/transcribe/tools/transcribe-media.ts +38 -188
  401. package/src/config/bundled-tool-registry.ts +8 -0
  402. package/src/config/env-registry.ts +38 -0
  403. package/src/config/env.ts +49 -4
  404. package/src/config/feature-flag-registry.json +85 -14
  405. package/src/config/loader.ts +82 -13
  406. package/src/config/sanitize-for-transfer.ts +47 -0
  407. package/src/config/schema.ts +81 -15
  408. package/src/config/schemas/__tests__/stt.test.ts +43 -0
  409. package/src/config/schemas/analysis.ts +51 -0
  410. package/src/config/schemas/backup.ts +72 -0
  411. package/src/config/schemas/calls.ts +1 -26
  412. package/src/config/schemas/elevenlabs.ts +0 -59
  413. package/src/config/schemas/filing.ts +47 -7
  414. package/src/config/schemas/heartbeat.ts +27 -5
  415. package/src/config/schemas/host-browser.ts +112 -0
  416. package/src/config/schemas/inference.ts +1 -1
  417. package/src/config/schemas/memory-lifecycle.ts +14 -2
  418. package/src/config/schemas/memory-retrieval.ts +103 -0
  419. package/src/config/schemas/security.ts +0 -6
  420. package/src/config/schemas/services.ts +52 -0
  421. package/src/config/schemas/stt.ts +59 -0
  422. package/src/config/schemas/tts.ts +230 -0
  423. package/src/config/schemas/updates.ts +14 -0
  424. package/src/config/skills.ts +4 -0
  425. package/src/config/types.ts +4 -1
  426. package/src/contacts/contact-store.ts +56 -11
  427. package/src/contacts/contacts-write.ts +38 -1
  428. package/src/context/post-turn-tool-result-truncation.ts +177 -0
  429. package/src/context/tool-result-truncation.ts +2 -1
  430. package/src/context/window-manager.ts +61 -10
  431. package/src/credential-execution/approval-bridge.ts +49 -15
  432. package/src/credential-execution/executable-discovery.ts +12 -2
  433. package/src/credential-execution/process-manager.ts +33 -2
  434. package/src/credential-health/credential-health-service.ts +366 -0
  435. package/src/daemon/__tests__/conversation-lifecycle-auto-analyze.test.ts +324 -0
  436. package/src/daemon/__tests__/conversation-surfaces-launch.test.ts +497 -0
  437. package/src/daemon/__tests__/conversation-tool-setup.test.ts +195 -0
  438. package/src/daemon/__tests__/lifecycle-startup-ordering.test.ts +127 -0
  439. package/src/daemon/app-source-watcher.ts +35 -0
  440. package/src/daemon/config-watcher.ts +99 -5
  441. package/src/daemon/context-overflow-approval.ts +5 -0
  442. package/src/daemon/conversation-agent-loop-handlers.ts +23 -2
  443. package/src/daemon/conversation-agent-loop.ts +153 -42
  444. package/src/daemon/conversation-attachments.ts +40 -0
  445. package/src/daemon/conversation-error.ts +11 -0
  446. package/src/daemon/conversation-history.ts +40 -6
  447. package/src/daemon/conversation-launch.ts +220 -0
  448. package/src/daemon/conversation-lifecycle.ts +59 -9
  449. package/src/daemon/conversation-messaging.ts +37 -3
  450. package/src/daemon/conversation-notifiers.ts +5 -0
  451. package/src/daemon/conversation-process.ts +622 -13
  452. package/src/daemon/conversation-queue-manager.ts +24 -0
  453. package/src/daemon/conversation-runtime-assembly.ts +128 -36
  454. package/src/daemon/conversation-slash.ts +36 -0
  455. package/src/daemon/conversation-surfaces.ts +131 -40
  456. package/src/daemon/conversation-tool-setup.ts +99 -8
  457. package/src/daemon/conversation-usage.ts +7 -4
  458. package/src/daemon/conversation-workspace.ts +12 -0
  459. package/src/daemon/conversation.ts +292 -16
  460. package/src/daemon/date-context.ts +10 -10
  461. package/src/daemon/first-greeting.ts +3 -2
  462. package/src/daemon/handlers/config-slack-channel.ts +269 -94
  463. package/src/daemon/handlers/conversations.ts +13 -141
  464. package/src/daemon/handlers/shared.ts +80 -0
  465. package/src/daemon/handlers/skills.ts +483 -44
  466. package/src/daemon/host-bash-proxy.ts +48 -13
  467. package/src/daemon/host-browser-proxy.ts +192 -0
  468. package/src/daemon/host-cu-proxy.ts +36 -11
  469. package/src/daemon/host-file-proxy.ts +57 -9
  470. package/src/daemon/lifecycle.ts +179 -28
  471. package/src/daemon/message-protocol.ts +13 -0
  472. package/src/daemon/message-types/conversations.ts +89 -14
  473. package/src/daemon/message-types/home.ts +40 -0
  474. package/src/daemon/message-types/host-browser.ts +100 -0
  475. package/src/daemon/message-types/meet.ts +143 -0
  476. package/src/daemon/message-types/messages.ts +19 -5
  477. package/src/daemon/message-types/schedules.ts +34 -2
  478. package/src/daemon/message-types/skills.ts +26 -0
  479. package/src/daemon/message-types/subagents.ts +2 -0
  480. package/src/daemon/message-types/surfaces.ts +2 -0
  481. package/src/daemon/server.ts +439 -14
  482. package/src/daemon/shutdown-handlers.ts +32 -4
  483. package/src/daemon/shutdown-registry.ts +40 -0
  484. package/src/daemon/tool-side-effects.ts +15 -0
  485. package/src/daemon/transport-hints.ts +5 -24
  486. package/src/email/html-renderer.ts +76 -0
  487. package/src/heartbeat/heartbeat-service.ts +93 -7
  488. package/src/home/__tests__/assistant-feed-authoring.test.ts +156 -0
  489. package/src/home/__tests__/emit-feed-event.test.ts +169 -0
  490. package/src/home/__tests__/feed-scheduler.test.ts +194 -0
  491. package/src/home/__tests__/feed-types.test.ts +275 -0
  492. package/src/home/__tests__/feed-writer.test.ts +688 -0
  493. package/src/home/__tests__/phase5-exit-criteria.test.ts +212 -0
  494. package/src/home/__tests__/platform-gmail-digest.test.ts +222 -0
  495. package/src/home/__tests__/progress-formula.test.ts +213 -0
  496. package/src/home/__tests__/relationship-state-writer.test.ts +740 -0
  497. package/src/home/__tests__/rollup-producer.test.ts +398 -0
  498. package/src/home/assistant-feed-authoring.ts +124 -0
  499. package/src/home/emit-feed-event.ts +158 -0
  500. package/src/home/feed-scheduler.ts +247 -0
  501. package/src/home/feed-types.ts +181 -0
  502. package/src/home/feed-writer.ts +469 -0
  503. package/src/home/platform-gmail-digest.ts +163 -0
  504. package/src/home/progress-formula.ts +86 -0
  505. package/src/home/relationship-state-writer.ts +824 -0
  506. package/src/home/relationship-state.ts +143 -0
  507. package/src/home/rollup-producer.ts +384 -0
  508. package/src/hooks/runner.ts +7 -0
  509. package/src/inbound/platform-callback-registration.ts +30 -20
  510. package/src/inbound/public-ingress-urls.ts +12 -0
  511. package/src/instrument.ts +1 -1
  512. package/src/ipc/__tests__/cli-ipc.test.ts +200 -0
  513. package/src/ipc/cli-client.ts +151 -0
  514. package/src/ipc/cli-server.ts +234 -0
  515. package/src/ipc/gateway-client.ts +180 -0
  516. package/src/ipc/routes/index.ts +5 -0
  517. package/src/ipc/routes/wake-conversation.ts +19 -0
  518. package/src/mcp/client.ts +59 -24
  519. package/src/memory/__tests__/auto-analysis-enqueue.test.ts +356 -0
  520. package/src/memory/__tests__/auto-analysis-guard.test.ts +57 -0
  521. package/src/memory/__tests__/conversation-analyze-job.test.ts +232 -0
  522. package/src/memory/__tests__/find-analysis-conversation.test.ts +196 -0
  523. package/src/memory/app-store.ts +31 -1
  524. package/src/memory/attachments-store.ts +70 -0
  525. package/src/memory/auto-analysis-enqueue.ts +127 -0
  526. package/src/memory/auto-analysis-guard.ts +27 -0
  527. package/src/memory/cleanup-schedule-state.ts +37 -0
  528. package/src/memory/conversation-analyze-job.ts +73 -0
  529. package/src/memory/conversation-crud.ts +122 -0
  530. package/src/memory/conversation-disk-view.ts +7 -0
  531. package/src/memory/conversation-group-migration.ts +34 -2
  532. package/src/memory/conversation-queries.ts +6 -5
  533. package/src/memory/conversation-starters-cadence.ts +76 -0
  534. package/src/memory/conversation-title-service.ts +5 -2
  535. package/src/memory/db-init.ts +18 -0
  536. package/src/memory/db-maintenance.ts +108 -0
  537. package/src/memory/db.ts +1 -0
  538. package/src/memory/embedding-backend.test.ts +75 -0
  539. package/src/memory/embedding-backend.ts +131 -5
  540. package/src/memory/embedding-gemini.test.ts +54 -0
  541. package/src/memory/embedding-gemini.ts +20 -9
  542. package/src/memory/embedding-local.ts +176 -17
  543. package/src/memory/graph/consolidation.ts +10 -23
  544. package/src/memory/graph/conversation-graph-memory.ts +15 -0
  545. package/src/memory/graph/extraction-job.ts +15 -0
  546. package/src/memory/graph/extraction.test.ts +23 -0
  547. package/src/memory/graph/extraction.ts +8 -0
  548. package/src/memory/graph/retriever.ts +67 -40
  549. package/src/memory/graph/scoring.test.ts +186 -0
  550. package/src/memory/graph/scoring.ts +31 -1
  551. package/src/memory/graph/store.test.ts +7 -3
  552. package/src/memory/graph/store.ts +47 -12
  553. package/src/memory/graph/tools.ts +1 -1
  554. package/src/memory/group-crud.ts +6 -1
  555. package/src/memory/indexer.ts +95 -16
  556. package/src/memory/job-handlers/cleanup.ts +11 -8
  557. package/src/memory/job-handlers/conversation-starters.ts +16 -10
  558. package/src/memory/jobs-store.ts +64 -4
  559. package/src/memory/jobs-worker.ts +22 -9
  560. package/src/memory/llm-usage-store.ts +137 -60
  561. package/src/memory/migrations/213-oauth-providers-scope-separator.ts +13 -0
  562. package/src/memory/migrations/214-oauth-providers-refresh-url.ts +11 -0
  563. package/src/memory/migrations/215-oauth-providers-revoke.ts +14 -0
  564. package/src/memory/migrations/216-oauth-providers-token-auth-method.ts +30 -0
  565. package/src/memory/migrations/217-conversation-host-access.ts +40 -0
  566. package/src/memory/migrations/218-oauth-providers-logo-url.ts +11 -0
  567. package/src/memory/migrations/219-oauth-providers-token-exchange-body-format.ts +15 -0
  568. package/src/memory/migrations/220-normalize-user-file-by-principal.ts +190 -0
  569. package/src/memory/migrations/221-conversations-archived-at.ts +16 -0
  570. package/src/memory/migrations/index.ts +12 -0
  571. package/src/memory/migrations/registry.ts +16 -0
  572. package/src/memory/qdrant-manager.ts +43 -16
  573. package/src/memory/schema/conversations.ts +3 -0
  574. package/src/memory/schema/oauth.ts +21 -13
  575. package/src/memory/usage-buckets.ts +396 -0
  576. package/src/messaging/providers/gmail/client.ts +57 -6
  577. package/src/messaging/providers/slack/__tests__/adapter-token-routing.test.ts +282 -0
  578. package/src/messaging/providers/slack/adapter.ts +143 -38
  579. package/src/messaging/providers/slack/client.ts +16 -0
  580. package/src/messaging/providers/slack/types.ts +4 -0
  581. package/src/notifications/decision-engine.ts +3 -3
  582. package/src/notifications/signal.ts +5 -0
  583. package/src/oauth/AGENTS.md +76 -0
  584. package/src/oauth/__tests__/identity-verifier.test.ts +25 -19
  585. package/src/oauth/__tests__/seed-providers-managed.test.ts +32 -0
  586. package/src/oauth/byo-connection.test.ts +26 -9
  587. package/src/oauth/byo-connection.ts +10 -8
  588. package/src/oauth/connect-orchestrator.ts +25 -21
  589. package/src/oauth/connect-types.ts +3 -3
  590. package/src/oauth/connection-resolver.test.ts +17 -4
  591. package/src/oauth/connection-resolver.ts +22 -18
  592. package/src/oauth/connection.ts +3 -1
  593. package/src/oauth/manual-token-connection.ts +13 -13
  594. package/src/oauth/oauth-store.ts +223 -100
  595. package/src/oauth/platform-connection.test.ts +101 -3
  596. package/src/oauth/platform-connection.ts +56 -35
  597. package/src/oauth/provider-serializer.ts +31 -5
  598. package/src/oauth/revoke.ts +76 -0
  599. package/src/oauth/seed-providers.ts +133 -87
  600. package/src/oauth/token-persistence.ts +1 -1
  601. package/src/permissions/checker.ts +16 -6
  602. package/src/permissions/defaults.ts +49 -1
  603. package/src/permissions/permission-mode.ts +4 -11
  604. package/src/permissions/prompter.ts +13 -1
  605. package/src/permissions/trust-store.ts +3 -3
  606. package/src/permissions/v2-consent-policy.ts +87 -0
  607. package/src/permissions/workspace-policy.ts +3 -0
  608. package/src/platform/client.test.ts +10 -0
  609. package/src/platform/sync-identity.ts +129 -0
  610. package/src/prompts/persona-resolver.ts +126 -2
  611. package/src/prompts/system-prompt.ts +76 -38
  612. package/src/prompts/templates/BOOTSTRAP-REFERENCE.md +3 -65
  613. package/src/prompts/templates/BOOTSTRAP.md +59 -105
  614. package/src/prompts/templates/SOUL.md +3 -1
  615. package/src/prompts/templates/UPDATES.md +12 -0
  616. package/src/prompts/templates/channels/slack.md +20 -0
  617. package/src/prompts/update-bulletin-format.ts +26 -9
  618. package/src/prompts/update-bulletin.ts +34 -23
  619. package/src/prompts/user-reference.ts +20 -17
  620. package/src/providers/__tests__/provider-secret-catalog.test.ts +42 -0
  621. package/src/providers/anthropic/client.ts +157 -60
  622. package/src/providers/fireworks/client.ts +2 -2
  623. package/src/providers/gemini/client.ts +9 -1
  624. package/src/providers/model-catalog.ts +6 -0
  625. package/src/providers/model-intents.ts +4 -4
  626. package/src/providers/ollama/client.ts +2 -2
  627. package/src/providers/openai/chat-completions-provider.ts +474 -0
  628. package/src/providers/openai/client.ts +25 -440
  629. package/src/providers/openai/responses-provider.ts +502 -0
  630. package/src/providers/openrouter/client.ts +101 -4
  631. package/src/providers/provider-secret-catalog.ts +139 -0
  632. package/src/providers/registry.ts +2 -2
  633. package/src/providers/retry.ts +14 -3
  634. package/src/providers/speech-to-text/__tests__/provider-catalog.test.ts +251 -0
  635. package/src/providers/speech-to-text/__tests__/resolve.test.ts +828 -0
  636. package/src/providers/speech-to-text/deepgram-realtime.test.ts +980 -0
  637. package/src/providers/speech-to-text/deepgram-realtime.ts +767 -0
  638. package/src/providers/speech-to-text/deepgram.test.ts +332 -0
  639. package/src/providers/speech-to-text/deepgram.ts +115 -0
  640. package/src/providers/speech-to-text/google-gemini-live-stream.test.ts +743 -0
  641. package/src/providers/speech-to-text/google-gemini-live-stream.ts +625 -0
  642. package/src/providers/speech-to-text/google-gemini.test.ts +226 -0
  643. package/src/providers/speech-to-text/google-gemini.ts +101 -0
  644. package/src/providers/speech-to-text/openai-whisper-stream.test.ts +564 -0
  645. package/src/providers/speech-to-text/openai-whisper-stream.ts +381 -0
  646. package/src/providers/speech-to-text/openai-whisper.test.ts +1 -37
  647. package/src/providers/speech-to-text/openai-whisper.ts +63 -33
  648. package/src/providers/speech-to-text/provider-catalog.ts +306 -0
  649. package/src/providers/speech-to-text/resolve.ts +386 -6
  650. package/src/providers/types.ts +10 -1
  651. package/src/runtime/AGENTS.md +65 -0
  652. package/src/runtime/__tests__/agent-wake.test.ts +831 -0
  653. package/src/runtime/__tests__/browser-extension-pair-routes.test.ts +715 -0
  654. package/src/runtime/__tests__/capability-tokens.test.ts +258 -0
  655. package/src/runtime/__tests__/chrome-extension-registry.test.ts +518 -0
  656. package/src/runtime/__tests__/runtime-mode.test.ts +62 -0
  657. package/src/runtime/__tests__/slack-block-formatting.test.ts +481 -0
  658. package/src/runtime/agent-wake.ts +512 -0
  659. package/src/runtime/assistant-event-hub.ts +2 -2
  660. package/src/runtime/auth/__tests__/guard-tests.test.ts +1 -0
  661. package/src/runtime/auth/__tests__/middleware.test.ts +116 -1
  662. package/src/runtime/auth/__tests__/route-policy.test.ts +48 -0
  663. package/src/runtime/auth/middleware.ts +98 -0
  664. package/src/runtime/auth/route-policy.ts +33 -9
  665. package/src/runtime/auth/token-service.ts +56 -1
  666. package/src/runtime/btw-sidechain.ts +2 -0
  667. package/src/runtime/capability-tokens.ts +414 -0
  668. package/src/runtime/channel-approvals.ts +18 -5
  669. package/src/runtime/channel-invite-transport.ts +1 -1
  670. package/src/runtime/channel-invite-transports/email.ts +14 -6
  671. package/src/runtime/channel-readiness-service.ts +12 -22
  672. package/src/runtime/chrome-extension-registry.ts +368 -0
  673. package/src/runtime/confirmation-request-guardian-bridge.ts +6 -0
  674. package/src/runtime/guardian-decision-types.ts +7 -0
  675. package/src/runtime/http-server.ts +815 -75
  676. package/src/runtime/http-types.ts +6 -2
  677. package/src/runtime/migrations/__tests__/rebind-secrets-credentials.test.ts +172 -0
  678. package/src/runtime/migrations/__tests__/vbundle-builder-credentials.test.ts +276 -0
  679. package/src/runtime/migrations/__tests__/vbundle-import-credentials.test.ts +198 -0
  680. package/src/runtime/migrations/__tests__/vbundle-legacy-user-md.test.ts +360 -0
  681. package/src/runtime/migrations/migration-transport.ts +7 -0
  682. package/src/runtime/migrations/migration-wizard.ts +23 -2
  683. package/src/runtime/migrations/rebind-secrets-screen.ts +76 -15
  684. package/src/runtime/migrations/vbundle-builder.ts +145 -38
  685. package/src/runtime/migrations/vbundle-import-analyzer.ts +96 -1
  686. package/src/runtime/migrations/vbundle-importer.ts +89 -5
  687. package/src/runtime/pending-interactions.ts +18 -13
  688. package/src/runtime/routes/__tests__/backup-routes.test.ts +967 -0
  689. package/src/runtime/routes/__tests__/home-feed-routes.test.ts +507 -0
  690. package/src/runtime/routes/__tests__/migration-import-credential-filter.test.ts +208 -0
  691. package/src/runtime/routes/__tests__/stt-routes.test.ts +406 -0
  692. package/src/runtime/routes/__tests__/tts-routes.test.ts +474 -0
  693. package/src/runtime/routes/__tests__/user-route-dispatcher.test.ts +148 -17
  694. package/src/runtime/routes/app-management-routes.ts +12 -18
  695. package/src/runtime/routes/approval-routes.ts +90 -16
  696. package/src/runtime/routes/attachment-routes.test.ts +9 -3
  697. package/src/runtime/routes/attachment-routes.ts +216 -17
  698. package/src/runtime/routes/backup-routes.ts +519 -0
  699. package/src/runtime/routes/browser-extension-pair-routes.ts +556 -0
  700. package/src/runtime/routes/btw-routes.ts +8 -6
  701. package/src/runtime/routes/contact-routes.test.ts +298 -0
  702. package/src/runtime/routes/contact-routes.ts +132 -5
  703. package/src/runtime/routes/conversation-analysis-routes.ts +22 -141
  704. package/src/runtime/routes/conversation-management-routes.ts +223 -0
  705. package/src/runtime/routes/conversation-routes.ts +598 -103
  706. package/src/runtime/routes/conversation-starter-routes.ts +78 -16
  707. package/src/runtime/routes/filing-routes.ts +93 -0
  708. package/src/runtime/routes/guardian-action-routes.ts +24 -13
  709. package/src/runtime/routes/home-feed-routes.ts +334 -0
  710. package/src/runtime/routes/home-state-routes.ts +138 -0
  711. package/src/runtime/routes/host-browser-routes.ts +268 -0
  712. package/src/runtime/routes/host-file-routes.ts +9 -1
  713. package/src/runtime/routes/identity-intro-cache.ts +7 -3
  714. package/src/runtime/routes/identity-routes.ts +262 -33
  715. package/src/runtime/routes/inbound-stages/transcribe-audio.test.ts +46 -39
  716. package/src/runtime/routes/inbound-stages/transcribe-audio.ts +15 -15
  717. package/src/runtime/routes/integrations/slack/__tests__/channel.test.ts +137 -0
  718. package/src/runtime/routes/integrations/slack/__tests__/share.test.ts +179 -0
  719. package/src/runtime/routes/integrations/slack/channel.ts +11 -3
  720. package/src/runtime/routes/integrations/slack/share.ts +45 -7
  721. package/src/runtime/routes/llm-context-normalization.ts +303 -0
  722. package/src/runtime/routes/log-export-routes.ts +42 -22
  723. package/src/runtime/routes/memory-item-routes.test.ts +3 -2
  724. package/src/runtime/routes/memory-item-routes.ts +1 -7
  725. package/src/runtime/routes/migration-routes.ts +122 -2
  726. package/src/runtime/routes/oauth-apps.ts +15 -17
  727. package/src/runtime/routes/oauth-providers.ts +4 -0
  728. package/src/runtime/routes/schedule-routes.ts +24 -11
  729. package/src/runtime/routes/settings-routes.ts +31 -102
  730. package/src/runtime/routes/skills-routes.ts +128 -9
  731. package/src/runtime/routes/stt-routes.ts +233 -0
  732. package/src/runtime/routes/subagents-routes.ts +14 -10
  733. package/src/runtime/routes/surface-action-routes.ts +41 -2
  734. package/src/runtime/routes/tts-routes.ts +108 -24
  735. package/src/runtime/routes/usage-routes.ts +38 -9
  736. package/src/runtime/routes/user-route-dispatcher.ts +50 -5
  737. package/src/runtime/routes/user-routes.ts +13 -1
  738. package/src/runtime/routes/work-items-routes.ts +8 -1
  739. package/src/runtime/routes/workspace-routes.test.ts +22 -0
  740. package/src/runtime/routes/workspace-routes.ts +8 -1
  741. package/src/runtime/routes/workspace-utils.ts +2 -0
  742. package/src/runtime/runtime-mode.ts +33 -0
  743. package/src/runtime/services/__tests__/analyze-conversation.test.ts +444 -0
  744. package/src/runtime/services/__tests__/analyze-deps-singleton.test.ts +67 -0
  745. package/src/runtime/services/__tests__/auto-analysis-prompt.test.ts +53 -0
  746. package/src/runtime/services/__tests__/manual-analysis-prompt.test.ts +41 -0
  747. package/src/runtime/services/analyze-conversation.ts +344 -0
  748. package/src/runtime/services/analyze-deps-singleton.ts +32 -0
  749. package/src/runtime/services/auto-analysis-prompt.ts +55 -0
  750. package/src/runtime/skill-route-registry.ts +49 -0
  751. package/src/runtime/slack-block-formatting.ts +437 -10
  752. package/src/schedule/scheduler.ts +57 -5
  753. package/src/security/ces-credential-client.ts +20 -0
  754. package/src/security/ces-rpc-credential-backend.ts +17 -0
  755. package/src/security/credential-backend.ts +5 -0
  756. package/src/security/oauth2.ts +68 -29
  757. package/src/security/secure-keys.ts +143 -27
  758. package/src/security/token-manager.ts +31 -10
  759. package/src/sequence/engine.ts +23 -0
  760. package/src/sequence/types.ts +1 -1
  761. package/src/skills/catalog-files.ts +554 -0
  762. package/src/skills/category-inference.ts +122 -0
  763. package/src/skills/clawhub-files.ts +213 -0
  764. package/src/skills/clawhub.ts +84 -23
  765. package/src/skills/skill-file-provider.ts +40 -0
  766. package/src/skills/skillssh-files.ts +395 -0
  767. package/src/skills/skillssh-registry.ts +4 -4
  768. package/src/stt/__tests__/daemon-batch-transcriber.test.ts +392 -0
  769. package/src/stt/__tests__/types.test.ts +89 -0
  770. package/src/stt/daemon-batch-transcriber.ts +195 -0
  771. package/src/stt/stt-stream-session.ts +499 -0
  772. package/src/stt/types.ts +330 -0
  773. package/src/stt/wav-encoder.test.ts +373 -0
  774. package/src/stt/wav-encoder.ts +175 -0
  775. package/src/subagent/manager.ts +169 -40
  776. package/src/subagent/types.ts +19 -0
  777. package/src/tools/apps/executors.ts +11 -2
  778. package/src/tools/browser/__tests__/auth-detector.test.ts +202 -108
  779. package/src/tools/browser/__tests__/browser-mode.test.ts +119 -0
  780. package/src/tools/browser/__tests__/browser-status.test.ts +123 -0
  781. package/src/tools/browser/auth-detector.ts +43 -12
  782. package/src/tools/browser/browser-execution.ts +1787 -342
  783. package/src/tools/browser/browser-manager.ts +81 -12
  784. package/src/tools/browser/browser-mode-constants.ts +12 -0
  785. package/src/tools/browser/browser-mode.ts +92 -0
  786. package/src/tools/browser/browser-status-constants.ts +33 -0
  787. package/src/tools/browser/cdp-client/__tests__/accessibility-snapshot.test.ts +318 -0
  788. package/src/tools/browser/cdp-client/__tests__/cdp-dom-helpers.test.ts +1175 -0
  789. package/src/tools/browser/cdp-client/__tests__/cdp-inspect-client.test.ts +1263 -0
  790. package/src/tools/browser/cdp-client/__tests__/extension-cdp-client.test.ts +359 -0
  791. package/src/tools/browser/cdp-client/__tests__/factory.test.ts +1993 -0
  792. package/src/tools/browser/cdp-client/__tests__/fixtures/ax-tree-nested-frames.json +64 -0
  793. package/src/tools/browser/cdp-client/__tests__/fixtures/ax-tree-simple.json +69 -0
  794. package/src/tools/browser/cdp-client/__tests__/local-cdp-client.test.ts +310 -0
  795. package/src/tools/browser/cdp-client/__tests__/types.test.ts +96 -0
  796. package/src/tools/browser/cdp-client/accessibility-snapshot.ts +387 -0
  797. package/src/tools/browser/cdp-client/cdp-dom-helpers.ts +695 -0
  798. package/src/tools/browser/cdp-client/cdp-inspect/__tests__/discovery.test.ts +1007 -0
  799. package/src/tools/browser/cdp-client/cdp-inspect/__tests__/ws-transport.test.ts +580 -0
  800. package/src/tools/browser/cdp-client/cdp-inspect/discovery.ts +744 -0
  801. package/src/tools/browser/cdp-client/cdp-inspect/ws-transport.ts +579 -0
  802. package/src/tools/browser/cdp-client/cdp-inspect-client.ts +868 -0
  803. package/src/tools/browser/cdp-client/errors.ts +49 -0
  804. package/src/tools/browser/cdp-client/extension-cdp-client.ts +148 -0
  805. package/src/tools/browser/cdp-client/factory.ts +914 -0
  806. package/src/tools/browser/cdp-client/index.ts +28 -0
  807. package/src/tools/browser/cdp-client/local-cdp-client.ts +187 -0
  808. package/src/tools/browser/cdp-client/types.ts +120 -0
  809. package/src/tools/credentials/vault.ts +35 -6
  810. package/src/tools/filesystem/edit.ts +1 -1
  811. package/src/tools/filesystem/list.ts +1 -1
  812. package/src/tools/filesystem/read.ts +1 -1
  813. package/src/tools/filesystem/write.ts +2 -1
  814. package/src/tools/host-filesystem/edit.ts +1 -1
  815. package/src/tools/host-filesystem/read.ts +12 -15
  816. package/src/tools/host-filesystem/write.ts +1 -1
  817. package/src/tools/host-terminal/host-shell.ts +21 -16
  818. package/src/tools/network/web-fetch.ts +5 -2
  819. package/src/tools/network/web-search.ts +5 -2
  820. package/src/tools/permission-checker.ts +77 -82
  821. package/src/tools/registry.ts +0 -2
  822. package/src/tools/secret-detection-handler.ts +34 -0
  823. package/src/tools/shared/filesystem/image-read.ts +61 -40
  824. package/src/tools/shared/shell-output.ts +3 -1
  825. package/src/tools/side-effects.ts +2 -0
  826. package/src/tools/skills/sandbox-runner.ts +3 -2
  827. package/src/tools/subagent/spawn.ts +47 -3
  828. package/src/tools/subagent/status.ts +2 -0
  829. package/src/tools/system/register.ts +2 -16
  830. package/src/tools/terminal/safe-env.ts +15 -0
  831. package/src/tools/terminal/shell.ts +36 -20
  832. package/src/tools/tool-approval-handler.ts +48 -2
  833. package/src/tools/tool-manifest.ts +21 -0
  834. package/src/tools/types.ts +19 -0
  835. package/src/tools/ui-surface/definitions.ts +6 -1
  836. package/src/tts/__tests__/provider-adapters.test.ts +834 -0
  837. package/src/tts/__tests__/provider-catalog-consistency.test.ts +196 -0
  838. package/src/tts/__tests__/provider-catalog.test.ts +183 -0
  839. package/src/tts/__tests__/provider-registry.test.ts +90 -0
  840. package/src/tts/provider-catalog.ts +201 -0
  841. package/src/tts/provider-registry.ts +73 -0
  842. package/src/tts/providers/deepgram-provider.ts +219 -0
  843. package/src/tts/providers/elevenlabs-provider.ts +211 -0
  844. package/src/tts/providers/fish-audio-provider.ts +183 -0
  845. package/src/tts/providers/index.ts +42 -0
  846. package/src/tts/providers/register-builtins.ts +130 -0
  847. package/src/tts/synthesize-text.ts +110 -0
  848. package/src/tts/tts-config-resolver.ts +78 -0
  849. package/src/tts/types.ts +153 -0
  850. package/src/types/onboarding-context.ts +7 -0
  851. package/src/util/abort-reasons.ts +58 -0
  852. package/src/util/device-id.ts +32 -16
  853. package/src/util/errors.ts +9 -1
  854. package/src/util/platform.ts +63 -24
  855. package/src/util/pricing.ts +66 -3
  856. package/src/util/spawn.ts +1 -1
  857. package/src/util/truncate.ts +4 -2
  858. package/src/util/unicode.ts +201 -0
  859. package/src/version.ts +19 -24
  860. package/src/watcher/engine.ts +23 -0
  861. package/src/watcher/watcher-store.ts +31 -0
  862. package/src/workspace/migrations/003-seed-device-id.ts +9 -3
  863. package/src/workspace/migrations/017-seed-persona-dirs.ts +68 -4
  864. package/src/workspace/migrations/029-seed-pkb.ts +1 -1
  865. package/src/workspace/migrations/031-drop-user-md.ts +317 -0
  866. package/src/workspace/migrations/031-llm-log-retention-zero-to-null.ts +73 -0
  867. package/src/workspace/migrations/032-tts-provider-unification.ts +227 -0
  868. package/src/workspace/migrations/033-stt-service-explicit-config.ts +122 -0
  869. package/src/workspace/migrations/034-remove-calls-voice-transcription-provider.ts +215 -0
  870. package/src/workspace/migrations/035-seed-slack-channel-persona.ts +50 -0
  871. package/src/workspace/migrations/036-update-pkb-index-bar.ts +37 -0
  872. package/src/workspace/migrations/037-create-meets-dir.ts +61 -0
  873. package/src/workspace/migrations/registry.ts +16 -0
  874. package/src/workspace/top-level-renderer.ts +31 -1
  875. package/src/workspace/turn-commit.ts +31 -0
  876. package/src/__tests__/chrome-cdp.test.ts +0 -419
  877. package/src/__tests__/email-cli.test.ts +0 -297
  878. package/src/__tests__/email-service-config-fallback.test.ts +0 -102
  879. package/src/__tests__/permission-mode-sse.test.ts +0 -418
  880. package/src/__tests__/permission-mode-store.test.ts +0 -277
  881. package/src/browser-extension-relay/protocol.ts +0 -63
  882. package/src/browser-extension-relay/server.ts +0 -203
  883. package/src/cli/commands/browser-relay.ts +0 -536
  884. package/src/config/schemas/sandbox.ts +0 -14
  885. package/src/email/guardrails.ts +0 -221
  886. package/src/email/provider.ts +0 -117
  887. package/src/email/providers/agentmail.ts +0 -361
  888. package/src/email/providers/index.ts +0 -65
  889. package/src/email/service.ts +0 -384
  890. package/src/email/types.ts +0 -126
  891. package/src/permissions/permission-mode-store.ts +0 -180
  892. package/src/prompts/templates/USER.md +0 -13
  893. package/src/providers/speech-to-text/types.ts +0 -17
  894. package/src/tools/browser/chrome-cdp.ts +0 -239
  895. package/src/tools/system/set-permission-mode.ts +0 -103
@@ -13,7 +13,7 @@ let lastStartArgs: {
13
13
  } | null = null;
14
14
 
15
15
  let mockPrepareResult: {
16
- authUrl: string;
16
+ authorizeUrl: string;
17
17
  state: string;
18
18
  completion: Promise<{
19
19
  tokens: { accessToken: string; refreshToken?: string };
@@ -21,7 +21,7 @@ let mockPrepareResult: {
21
21
  rawTokenResponse: Record<string, unknown>;
22
22
  }>;
23
23
  } = {
24
- authUrl: "https://provider.example.com/authorize?prepared",
24
+ authorizeUrl: "https://provider.example.com/authorize?prepared",
25
25
  state: "mock-state-123",
26
26
  completion: new Promise(() => {}), // never resolves by default
27
27
  };
@@ -86,21 +86,26 @@ mock.module("../oauth/scope-policy.js", () => ({
86
86
 
87
87
  // Provider store mock — configurable per test
88
88
  type ProviderRow = {
89
- providerKey: string;
90
- authUrl: string;
91
- tokenUrl: string;
92
- tokenEndpointAuthMethod: string | null;
89
+ provider: string;
90
+ authorizeUrl: string;
91
+ tokenExchangeUrl: string;
92
+ refreshUrl: string | null;
93
+ tokenEndpointAuthMethod: string;
94
+ tokenExchangeBodyFormat: string;
93
95
  userinfoUrl: string | null;
94
96
  baseUrl: string | null;
95
97
  defaultScopes: string;
96
98
  scopePolicy: string;
97
- extraParams: string | null;
99
+ scopeSeparator: string;
100
+ authorizeParams: string | null;
98
101
  pingUrl: string | null;
99
102
  pingMethod: string | null;
100
103
  pingHeaders: string | null;
101
104
  pingBody: string | null;
105
+ revokeUrl: string | null;
106
+ revokeBodyTemplate: string | null;
102
107
  managedServiceConfigKey: string | null;
103
- displayName: string | null;
108
+ displayLabel: string | null;
104
109
  description: string | null;
105
110
  dashboardUrl: string | null;
106
111
  clientIdPlaceholder: string | null;
@@ -157,25 +162,30 @@ import { orchestrateOAuthConnect } from "../oauth/connect-orchestrator.js";
157
162
  // ---------------------------------------------------------------------------
158
163
 
159
164
  function makeProviderRow(
160
- overrides: Partial<ProviderRow> & { providerKey: string },
165
+ overrides: Partial<ProviderRow> & { provider: string },
161
166
  ): ProviderRow {
162
167
  const now = Date.now();
163
168
  return {
164
- authUrl: "https://provider.example.com/authorize",
165
- tokenUrl: "https://provider.example.com/token",
166
- tokenEndpointAuthMethod: null,
169
+ authorizeUrl: "https://provider.example.com/authorize",
170
+ tokenExchangeUrl: "https://provider.example.com/token",
171
+ refreshUrl: null,
172
+ tokenEndpointAuthMethod: "client_secret_post",
173
+ tokenExchangeBodyFormat: "form",
167
174
  userinfoUrl: null,
168
175
  baseUrl: null,
169
176
  defaultScopes: '["openid","email"]',
170
177
  scopePolicy:
171
178
  '{"allowAdditionalScopes":false,"allowedOptionalScopes":[],"forbiddenScopes":[]}',
172
- extraParams: null,
179
+ scopeSeparator: " ",
180
+ authorizeParams: null,
173
181
  pingUrl: null,
174
182
  pingMethod: null,
175
183
  pingHeaders: null,
176
184
  pingBody: null,
185
+ revokeUrl: null,
186
+ revokeBodyTemplate: null,
177
187
  managedServiceConfigKey: null,
178
- displayName: null,
188
+ displayLabel: null,
179
189
  description: null,
180
190
  dashboardUrl: null,
181
191
  clientIdPlaceholder: null,
@@ -200,19 +210,21 @@ function makeProviderRow(
200
210
 
201
211
  // Shared provider definitions used across tests
202
212
  const GOOGLE_PROVIDER = makeProviderRow({
203
- providerKey: "google",
204
- authUrl: "https://accounts.google.com/o/oauth2/v2/auth",
205
- tokenUrl: "https://oauth2.googleapis.com/token",
213
+ provider: "google",
214
+ authorizeUrl: "https://accounts.google.com/o/oauth2/v2/auth",
215
+ tokenExchangeUrl: "https://oauth2.googleapis.com/token",
206
216
  loopbackPort: 17332,
207
- displayName: "Google",
217
+ displayLabel: "Google",
208
218
  });
209
219
 
210
220
  const OUTLOOK_PROVIDER = makeProviderRow({
211
- providerKey: "outlook",
212
- authUrl: "https://login.microsoftonline.com/common/oauth2/v2.0/authorize",
213
- tokenUrl: "https://login.microsoftonline.com/common/oauth2/v2.0/token",
221
+ provider: "outlook",
222
+ authorizeUrl:
223
+ "https://login.microsoftonline.com/common/oauth2/v2.0/authorize",
224
+ tokenExchangeUrl:
225
+ "https://login.microsoftonline.com/common/oauth2/v2.0/token",
214
226
  loopbackPort: 17334,
215
- displayName: "Outlook",
227
+ displayLabel: "Outlook",
216
228
  });
217
229
 
218
230
  // ---------------------------------------------------------------------------
@@ -227,7 +239,7 @@ beforeEach(() => {
227
239
  mockProviderStore = {};
228
240
 
229
241
  mockPrepareResult = {
230
- authUrl: "https://provider.example.com/authorize?prepared",
242
+ authorizeUrl: "https://provider.example.com/authorize?prepared",
231
243
  state: "mock-state-123",
232
244
  completion: new Promise(() => {}),
233
245
  };
@@ -689,7 +701,7 @@ describe("orchestrateOAuthConnect — transport selection", () => {
689
701
  describe("provider without loopbackPort", () => {
690
702
  test("loopback transport passes undefined loopbackPort when provider has none", async () => {
691
703
  mockProviderStore["custom"] = makeProviderRow({
692
- providerKey: "custom",
704
+ provider: "custom",
693
705
  loopbackPort: null, // no fixed port
694
706
  });
695
707
 
@@ -706,4 +718,86 @@ describe("orchestrateOAuthConnect — transport selection", () => {
706
718
  });
707
719
  });
708
720
  });
721
+
722
+ // -------------------------------------------------------------------------
723
+ // Scope separator propagation
724
+ // -------------------------------------------------------------------------
725
+
726
+ describe("scope separator propagation", () => {
727
+ test("comma separator from providerRow propagates to oauthConfig (deferred)", async () => {
728
+ mockProviderStore["linear"] = makeProviderRow({
729
+ provider: "linear",
730
+ scopeSeparator: ",",
731
+ });
732
+
733
+ await orchestrateOAuthConnect({
734
+ service: "linear",
735
+ clientId: "client-id",
736
+ isInteractive: false,
737
+ callbackTransport: "loopback",
738
+ });
739
+
740
+ expect(lastPrepareArgs).not.toBeNull();
741
+ const capturedConfig = lastPrepareArgs!.config as {
742
+ scopeSeparator: string;
743
+ };
744
+ expect(capturedConfig.scopeSeparator).toBe(",");
745
+ });
746
+
747
+ test("space separator (default) from providerRow propagates to oauthConfig (deferred)", async () => {
748
+ mockProviderStore["google"] = GOOGLE_PROVIDER;
749
+
750
+ await orchestrateOAuthConnect({
751
+ service: "google",
752
+ clientId: "client-id",
753
+ isInteractive: false,
754
+ callbackTransport: "loopback",
755
+ });
756
+
757
+ expect(lastPrepareArgs).not.toBeNull();
758
+ const capturedConfig = lastPrepareArgs!.config as {
759
+ scopeSeparator: string;
760
+ };
761
+ expect(capturedConfig.scopeSeparator).toBe(" ");
762
+ });
763
+
764
+ test("comma separator from providerRow propagates to oauthConfig (interactive)", async () => {
765
+ mockProviderStore["linear"] = makeProviderRow({
766
+ provider: "linear",
767
+ scopeSeparator: ",",
768
+ });
769
+
770
+ await orchestrateOAuthConnect({
771
+ service: "linear",
772
+ clientId: "client-id",
773
+ isInteractive: true,
774
+ callbackTransport: "loopback",
775
+ openUrl: () => {},
776
+ });
777
+
778
+ expect(lastStartArgs).not.toBeNull();
779
+ const capturedConfig = lastStartArgs!.config as {
780
+ scopeSeparator: string;
781
+ };
782
+ expect(capturedConfig.scopeSeparator).toBe(",");
783
+ });
784
+
785
+ test("space separator from providerRow propagates to oauthConfig (interactive)", async () => {
786
+ mockProviderStore["google"] = GOOGLE_PROVIDER;
787
+
788
+ await orchestrateOAuthConnect({
789
+ service: "google",
790
+ clientId: "client-id",
791
+ isInteractive: true,
792
+ callbackTransport: "loopback",
793
+ openUrl: () => {},
794
+ });
795
+
796
+ expect(lastStartArgs).not.toBeNull();
797
+ const capturedConfig = lastStartArgs!.config as {
798
+ scopeSeparator: string;
799
+ };
800
+ expect(capturedConfig.scopeSeparator).toBe(" ");
801
+ });
802
+ });
709
803
  });
@@ -0,0 +1,23 @@
1
+ import { describe, expect, test } from "bun:test";
2
+
3
+ import { PROVIDER_SEED_DATA } from "../oauth/seed-providers.js";
4
+
5
+ describe("PROVIDER_SEED_DATA logo URLs", () => {
6
+ test("every well-known provider has a Simple Icons CDN logoUrl", () => {
7
+ const missing: string[] = [];
8
+ const invalid: Array<{ provider: string; logoUrl: string }> = [];
9
+
10
+ for (const [key, seed] of Object.entries(PROVIDER_SEED_DATA)) {
11
+ if (!seed.logoUrl) {
12
+ missing.push(key);
13
+ continue;
14
+ }
15
+ if (!seed.logoUrl.startsWith("https://cdn.simpleicons.org/")) {
16
+ invalid.push({ provider: key, logoUrl: seed.logoUrl });
17
+ }
18
+ }
19
+
20
+ expect(missing).toEqual([]);
21
+ expect(invalid).toEqual([]);
22
+ });
23
+ });
@@ -10,24 +10,30 @@ import {
10
10
  function makeRow(overrides: Partial<OAuthProviderRow> = {}): OAuthProviderRow {
11
11
  const now = Date.now();
12
12
  return {
13
- providerKey: "test-provider",
14
- authUrl: "https://auth.example.com/authorize",
15
- tokenUrl: "https://auth.example.com/token",
16
- tokenEndpointAuthMethod: null,
13
+ provider: "test-provider",
14
+ authorizeUrl: "https://auth.example.com/authorize",
15
+ tokenExchangeUrl: "https://auth.example.com/token",
16
+ refreshUrl: null,
17
+ tokenEndpointAuthMethod: "client_secret_post",
18
+ tokenExchangeBodyFormat: "form",
17
19
  userinfoUrl: null,
18
20
  baseUrl: null,
19
21
  defaultScopes: "[]",
20
22
  scopePolicy: "{}",
21
- extraParams: null,
23
+ scopeSeparator: " ",
24
+ authorizeParams: null,
22
25
  pingUrl: null,
23
26
  pingMethod: null,
24
27
  pingHeaders: null,
25
28
  pingBody: null,
29
+ revokeUrl: null,
30
+ revokeBodyTemplate: null,
26
31
  managedServiceConfigKey: null,
27
- displayName: null,
32
+ displayLabel: null,
28
33
  description: null,
29
34
  dashboardUrl: null,
30
35
  clientIdPlaceholder: null,
36
+ logoUrl: null,
31
37
  requiresClientSecret: 1,
32
38
  loopbackPort: null,
33
39
  injectionTemplates: null,
@@ -52,7 +58,7 @@ describe("serializeProvider", () => {
52
58
  const row = makeRow({
53
59
  defaultScopes: JSON.stringify(["openid", "email"]),
54
60
  scopePolicy: JSON.stringify({ required: ["openid"] }),
55
- extraParams: JSON.stringify({ access_type: "offline" }),
61
+ authorizeParams: JSON.stringify({ access_type: "offline" }),
56
62
  pingHeaders: JSON.stringify({ "X-Api-Version": "2" }),
57
63
  pingBody: JSON.stringify({ query: "{ me { id } }" }),
58
64
  injectionTemplates: JSON.stringify([
@@ -167,13 +173,103 @@ describe("serializeProvider", () => {
167
173
  test("returns null for null input", () => {
168
174
  expect(serializeProvider(null)).toBeNull();
169
175
  });
176
+
177
+ test("emits scopeSeparator from the row when set to ','", () => {
178
+ const row = makeRow({ scopeSeparator: "," });
179
+ const result = serializeProvider(row)!;
180
+ expect(result.scopeSeparator).toBe(",");
181
+ });
182
+
183
+ test("emits scopeSeparator default ' ' when row uses the default", () => {
184
+ const row = makeRow({ scopeSeparator: " " });
185
+ const result = serializeProvider(row)!;
186
+ expect(result.scopeSeparator).toBe(" ");
187
+ });
188
+
189
+ test("emits refreshUrl from the row when set to a URL", () => {
190
+ const row = makeRow({
191
+ refreshUrl: "https://refresh.example.com/token",
192
+ });
193
+ const result = serializeProvider(row)!;
194
+ expect(result.refreshUrl).toBe("https://refresh.example.com/token");
195
+ });
196
+
197
+ test("emits refreshUrl as null when the row value is null", () => {
198
+ const row = makeRow({ refreshUrl: null });
199
+ const result = serializeProvider(row)!;
200
+ expect(result.refreshUrl).toBeNull();
201
+ });
202
+
203
+ test("emits revokeUrl from the row and parses revokeBodyTemplate JSON", () => {
204
+ const row = makeRow({
205
+ revokeUrl: "https://revoke.example.com",
206
+ revokeBodyTemplate: JSON.stringify({ token: "{access_token}" }),
207
+ });
208
+ const result = serializeProvider(row)!;
209
+ expect(result.revokeUrl).toBe("https://revoke.example.com");
210
+ expect(result.revokeBodyTemplate).toEqual({ token: "{access_token}" });
211
+ // Make sure it's a parsed object, not a string.
212
+ expect(typeof result.revokeBodyTemplate).toBe("object");
213
+ expect(result.revokeBodyTemplate).not.toBe(
214
+ JSON.stringify({ token: "{access_token}" }),
215
+ );
216
+ });
217
+
218
+ test("emits revokeUrl and revokeBodyTemplate as null when the row values are null", () => {
219
+ const row = makeRow({
220
+ revokeUrl: null,
221
+ revokeBodyTemplate: null,
222
+ });
223
+ const result = serializeProvider(row)!;
224
+ expect(result.revokeUrl).toBeNull();
225
+ expect(result.revokeBodyTemplate).toBeNull();
226
+ });
227
+
228
+ test("normalizes empty string revokeUrl to null on the serialized output", () => {
229
+ // Legacy rows or rows that reached the store via an empty-string update
230
+ // may persist `revokeUrl: ""`. The serializer should normalize this to
231
+ // null so wire consumers (CLI --json, HTTP API) see a consistent
232
+ // "disabled" signal.
233
+ const row = makeRow({ revokeUrl: "" });
234
+ const result = serializeProvider(row)!;
235
+ expect(result.revokeUrl).toBeNull();
236
+ });
237
+
238
+ test("preserves all keys in a complex revokeBodyTemplate", () => {
239
+ const template = {
240
+ token: "{access_token}",
241
+ client_id: "{client_id}",
242
+ token_type_hint: "access_token",
243
+ extra_field: "static-value",
244
+ };
245
+ const row = makeRow({
246
+ revokeUrl: "https://revoke.example.com/oauth/revoke",
247
+ revokeBodyTemplate: JSON.stringify(template),
248
+ });
249
+ const result = serializeProvider(row)!;
250
+ expect(result.revokeBodyTemplate).toEqual(template);
251
+ });
252
+
253
+ test("serializeProvider exposes logoUrl", () => {
254
+ const row = makeRow({
255
+ logoUrl: "https://cdn.simpleicons.org/notion",
256
+ });
257
+ const result = serializeProvider(row)!;
258
+ expect(result.logoUrl).toBe("https://cdn.simpleicons.org/notion");
259
+ });
260
+
261
+ test("serializeProvider emits logoUrl as null when row value is null", () => {
262
+ const row = makeRow({ logoUrl: null });
263
+ const result = serializeProvider(row)!;
264
+ expect(result.logoUrl).toBeNull();
265
+ });
170
266
  });
171
267
 
172
268
  describe("serializeProviderSummary", () => {
173
269
  test("returns the expected subset of fields in snake_case", () => {
174
270
  const row = makeRow({
175
- providerKey: "google",
176
- displayName: "Google",
271
+ provider: "google",
272
+ displayLabel: "Google",
177
273
  description: "Google OAuth 2.0",
178
274
  dashboardUrl: "https://console.cloud.google.com",
179
275
  clientIdPlaceholder: "your-client-id.apps.googleusercontent.com",
@@ -190,6 +286,7 @@ describe("serializeProviderSummary", () => {
190
286
  dashboard_url: "https://console.cloud.google.com",
191
287
  client_id_placeholder: "your-client-id.apps.googleusercontent.com",
192
288
  requires_client_secret: true,
289
+ logo_url: null,
193
290
  supports_managed_mode: true,
194
291
  feature_flag: null,
195
292
  });
@@ -197,7 +294,7 @@ describe("serializeProviderSummary", () => {
197
294
 
198
295
  test("nullifies missing optional fields", () => {
199
296
  const row = makeRow({
200
- displayName: null,
297
+ displayLabel: null,
201
298
  description: null,
202
299
  dashboardUrl: null,
203
300
  clientIdPlaceholder: null,
@@ -230,4 +327,44 @@ describe("serializeProviderSummary", () => {
230
327
  test("returns null for undefined input", () => {
231
328
  expect(serializeProviderSummary(undefined)).toBeNull();
232
329
  });
330
+
331
+ test("does NOT include scope_separator (intentionally omitted from the HTTP summary)", () => {
332
+ const row = makeRow({ scopeSeparator: "," });
333
+ const result = serializeProviderSummary(row)!;
334
+ expect(result).not.toHaveProperty("scope_separator");
335
+ expect(result).not.toHaveProperty("scopeSeparator");
336
+ });
337
+
338
+ test("does NOT include refresh_url (intentionally omitted from the HTTP summary)", () => {
339
+ const row = makeRow({ refreshUrl: "https://refresh.example.com/token" });
340
+ const result = serializeProviderSummary(row)!;
341
+ expect(result).not.toHaveProperty("refresh_url");
342
+ expect(result).not.toHaveProperty("refreshUrl");
343
+ });
344
+
345
+ test("does NOT include revoke_url or revoke_body_template (internal protocol details)", () => {
346
+ const row = makeRow({
347
+ revokeUrl: "https://revoke.example.com",
348
+ revokeBodyTemplate: JSON.stringify({ token: "{access_token}" }),
349
+ });
350
+ const result = serializeProviderSummary(row)!;
351
+ expect(result).not.toHaveProperty("revoke_url");
352
+ expect(result).not.toHaveProperty("revokeUrl");
353
+ expect(result).not.toHaveProperty("revoke_body_template");
354
+ expect(result).not.toHaveProperty("revokeBodyTemplate");
355
+ });
356
+
357
+ test("serializeProviderSummary exposes logo_url", () => {
358
+ const row = makeRow({
359
+ logoUrl: "https://cdn.simpleicons.org/notion",
360
+ });
361
+ const result = serializeProviderSummary(row)!;
362
+ expect(result).toHaveProperty("logo_url");
363
+ expect(result.logo_url).toBe("https://cdn.simpleicons.org/notion");
364
+ });
365
+
366
+ test("logo_url is null when row logoUrl is null", () => {
367
+ const result = serializeProviderSummary({ ...makeRow(), logoUrl: null })!;
368
+ expect(result.logo_url).toBeNull();
369
+ });
233
370
  });
@@ -51,18 +51,16 @@ describe("isProviderVisible", () => {
51
51
  test("returns true when featureFlag is null", () => {
52
52
  seedProviders([
53
53
  {
54
- providerKey: "no-flag-provider",
55
- authUrl: "https://example.com/auth",
56
- tokenUrl: "https://example.com/token",
54
+ provider: "no-flag-provider",
55
+ authorizeUrl: "https://example.com/auth",
56
+ tokenExchangeUrl: "https://example.com/token",
57
57
  defaultScopes: ["read"],
58
58
  scopePolicy: {},
59
59
  },
60
60
  ]);
61
61
 
62
62
  const providers = listProviders();
63
- const provider = providers.find(
64
- (p) => p.providerKey === "no-flag-provider",
65
- );
63
+ const provider = providers.find((p) => p.provider === "no-flag-provider");
66
64
  expect(provider).toBeDefined();
67
65
  expect(provider!.featureFlag).toBeNull();
68
66
 
@@ -75,9 +73,9 @@ describe("isProviderVisible", () => {
75
73
 
76
74
  seedProviders([
77
75
  {
78
- providerKey: "gated-provider",
79
- authUrl: "https://example.com/auth",
80
- tokenUrl: "https://example.com/token",
76
+ provider: "gated-provider",
77
+ authorizeUrl: "https://example.com/auth",
78
+ tokenExchangeUrl: "https://example.com/token",
81
79
  defaultScopes: ["read"],
82
80
  scopePolicy: {},
83
81
  featureFlag: "test-gate",
@@ -85,7 +83,7 @@ describe("isProviderVisible", () => {
85
83
  ]);
86
84
 
87
85
  const providers = listProviders();
88
- const provider = providers.find((p) => p.providerKey === "gated-provider");
86
+ const provider = providers.find((p) => p.provider === "gated-provider");
89
87
  expect(provider).toBeDefined();
90
88
  expect(provider!.featureFlag).toBe("test-gate");
91
89
 
@@ -98,9 +96,9 @@ describe("isProviderVisible", () => {
98
96
 
99
97
  seedProviders([
100
98
  {
101
- providerKey: "gated-provider",
102
- authUrl: "https://example.com/auth",
103
- tokenUrl: "https://example.com/token",
99
+ provider: "gated-provider",
100
+ authorizeUrl: "https://example.com/auth",
101
+ tokenExchangeUrl: "https://example.com/token",
104
102
  defaultScopes: ["read"],
105
103
  scopePolicy: {},
106
104
  featureFlag: "test-gate",
@@ -108,7 +106,7 @@ describe("isProviderVisible", () => {
108
106
  ]);
109
107
 
110
108
  const providers = listProviders();
111
- const provider = providers.find((p) => p.providerKey === "gated-provider");
109
+ const provider = providers.find((p) => p.provider === "gated-provider");
112
110
  expect(provider).toBeDefined();
113
111
 
114
112
  const config = makeConfig();
@@ -120,16 +118,16 @@ describe("isProviderVisible", () => {
120
118
 
121
119
  seedProviders([
122
120
  {
123
- providerKey: "visible-provider",
124
- authUrl: "https://example.com/auth",
125
- tokenUrl: "https://example.com/token",
121
+ provider: "visible-provider",
122
+ authorizeUrl: "https://example.com/auth",
123
+ tokenExchangeUrl: "https://example.com/token",
126
124
  defaultScopes: ["read"],
127
125
  scopePolicy: {},
128
126
  },
129
127
  {
130
- providerKey: "gated-provider",
131
- authUrl: "https://gated.example.com/auth",
132
- tokenUrl: "https://gated.example.com/token",
128
+ provider: "gated-provider",
129
+ authorizeUrl: "https://gated.example.com/auth",
130
+ tokenExchangeUrl: "https://gated.example.com/token",
133
131
  defaultScopes: ["read"],
134
132
  scopePolicy: {},
135
133
  featureFlag: "test-gate",
@@ -144,6 +142,6 @@ describe("isProviderVisible", () => {
144
142
  isProviderVisible(p, config),
145
143
  );
146
144
  expect(visibleProviders).toHaveLength(1);
147
- expect(visibleProviders[0]!.providerKey).toBe("visible-provider");
145
+ expect(visibleProviders[0]!.provider).toBe("visible-provider");
148
146
  });
149
147
  });
@@ -2,26 +2,32 @@ import { describe, expect, mock, test } from "bun:test";
2
2
 
3
3
  const mockListProviders = mock(() => [
4
4
  {
5
- providerKey: "google",
6
- displayName: "Google",
5
+ provider: "google",
6
+ displayLabel: "Google",
7
7
  description: "Google OAuth provider",
8
8
  dashboardUrl: "https://console.cloud.google.com/apis/credentials",
9
9
  clientIdPlaceholder: null,
10
+ logoUrl: "https://cdn.simpleicons.org/google",
10
11
  requiresClientSecret: 1,
11
12
  managedServiceConfigKey: "google-oauth",
12
- authUrl: "https://accounts.google.com/o/oauth2/v2/auth",
13
- tokenUrl: "https://oauth2.googleapis.com/token",
14
- tokenEndpointAuthMethod: null,
13
+ authorizeUrl: "https://accounts.google.com/o/oauth2/v2/auth",
14
+ tokenExchangeUrl: "https://oauth2.googleapis.com/token",
15
+ refreshUrl: null,
16
+ tokenEndpointAuthMethod: "client_secret_post",
17
+ tokenExchangeBodyFormat: "form",
15
18
  userinfoUrl: null,
16
19
  baseUrl: null,
17
20
  defaultScopes: "[]",
18
21
  scopePolicy: "[]",
19
- extraParams: null,
22
+ scopeSeparator: null,
23
+ authorizeParams: null,
20
24
 
21
25
  pingUrl: null,
22
26
  pingMethod: null,
23
27
  pingHeaders: null,
24
28
  pingBody: null,
29
+ revokeUrl: null,
30
+ revokeBodyTemplate: null,
25
31
  loopbackPort: null,
26
32
  injectionTemplates: null,
27
33
  appType: null,
@@ -38,26 +44,32 @@ const mockListProviders = mock(() => [
38
44
  updatedAt: 1735689550000,
39
45
  },
40
46
  {
41
- providerKey: "github",
42
- displayName: "GitHub",
47
+ provider: "github",
48
+ displayLabel: "GitHub",
43
49
  description: "GitHub OAuth provider",
44
50
  dashboardUrl: "https://github.com/settings/developers",
45
51
  clientIdPlaceholder: null,
52
+ logoUrl: null,
46
53
  requiresClientSecret: 1,
47
54
  managedServiceConfigKey: null,
48
- authUrl: "https://github.com/login/oauth/authorize",
49
- tokenUrl: "https://github.com/login/oauth/access_token",
50
- tokenEndpointAuthMethod: null,
55
+ authorizeUrl: "https://github.com/login/oauth/authorize",
56
+ tokenExchangeUrl: "https://github.com/login/oauth/access_token",
57
+ refreshUrl: null,
58
+ tokenEndpointAuthMethod: "client_secret_post",
59
+ tokenExchangeBodyFormat: "form",
51
60
  userinfoUrl: null,
52
61
  baseUrl: null,
53
62
  defaultScopes: "[]",
54
63
  scopePolicy: "[]",
55
- extraParams: null,
64
+ scopeSeparator: null,
65
+ authorizeParams: null,
56
66
 
57
67
  pingUrl: null,
58
68
  pingMethod: null,
59
69
  pingHeaders: null,
60
70
  pingBody: null,
71
+ revokeUrl: null,
72
+ revokeBodyTemplate: null,
61
73
  loopbackPort: null,
62
74
  injectionTemplates: null,
63
75
  appType: null,
@@ -75,9 +87,9 @@ const mockListProviders = mock(() => [
75
87
  },
76
88
  ]);
77
89
 
78
- const mockGetProvider = mock((providerKey: string) => {
90
+ const mockGetProvider = mock((provider: string) => {
79
91
  const all = mockListProviders();
80
- return all.find((p) => p.providerKey === providerKey) ?? undefined;
92
+ return all.find((p) => p.provider === provider) ?? undefined;
81
93
  });
82
94
 
83
95
  mock.module("../oauth/oauth-store.js", () => ({
@@ -149,6 +161,7 @@ describe("GET /v1/oauth/providers", () => {
149
161
  "dashboard_url",
150
162
  "client_id_placeholder",
151
163
  "requires_client_secret",
164
+ "logo_url",
152
165
  "supports_managed_mode",
153
166
  "feature_flag",
154
167
  ];
@@ -158,6 +171,31 @@ describe("GET /v1/oauth/providers", () => {
158
171
  }
159
172
  });
160
173
 
174
+ test("response includes logo_url for each provider", async () => {
175
+ const req = new Request("http://localhost/v1/oauth/providers");
176
+ const url = new URL(req.url);
177
+ const res = await getRoute("GET", "oauth/providers").handler({
178
+ req,
179
+ url,
180
+ server: null as never,
181
+ authContext: null as never,
182
+ params: {},
183
+ });
184
+
185
+ expect(res.status).toBe(200);
186
+ const body = (await res.json()) as {
187
+ providers: Array<{
188
+ provider_key: string;
189
+ logo_url: string | null;
190
+ }>;
191
+ };
192
+
193
+ expect(body.providers[0]!.logo_url).toBe(
194
+ "https://cdn.simpleicons.org/google",
195
+ );
196
+ expect(body.providers[1]!.logo_url).toBeNull();
197
+ });
198
+
161
199
  test("supports_managed_mode=true returns only managed providers", async () => {
162
200
  const req = new Request(
163
201
  "http://localhost/v1/oauth/providers?supports_managed_mode=true",