@vellumai/assistant 0.11.6 → 0.11.7-staging.2

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 (478) hide show
  1. package/ARCHITECTURE.md +31 -19
  2. package/Dockerfile +1 -0
  3. package/docs/architecture/security.md +3 -3
  4. package/docs/flux-turn-detection-spike.md +8 -7
  5. package/docs/runbook-trusted-contacts.md +14 -0
  6. package/docs/stt-provider-onboarding.md +8 -4
  7. package/knip.json +1 -0
  8. package/node_modules/@vellumai/avatar-manifest/package.json +18 -0
  9. package/node_modules/@vellumai/avatar-manifest/src/__tests__/manifest.test.ts +173 -0
  10. package/node_modules/@vellumai/avatar-manifest/src/__tests__/read.test.ts +114 -0
  11. package/node_modules/@vellumai/avatar-manifest/src/index.ts +29 -0
  12. package/node_modules/@vellumai/avatar-manifest/src/layout.ts +18 -0
  13. package/node_modules/@vellumai/avatar-manifest/src/manifest.ts +156 -0
  14. package/node_modules/@vellumai/avatar-manifest/src/read.ts +109 -0
  15. package/node_modules/@vellumai/avatar-manifest/tsconfig.json +20 -0
  16. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +37 -0
  17. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/remote-web-pairing.test.ts +389 -0
  18. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/ingress.ts +22 -0
  19. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/remote-web-pairing.ts +508 -18
  20. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/rpc.ts +174 -0
  21. package/node_modules/@vellumai/ces-client/src/http-credentials.ts +161 -0
  22. package/node_modules/@vellumai/ces-client/src/index.ts +1 -0
  23. package/node_modules/@vellumai/environments/package.json +2 -1
  24. package/node_modules/@vellumai/environments/src/shell.test.ts +56 -0
  25. package/node_modules/@vellumai/environments/src/shell.ts +65 -0
  26. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +37 -0
  27. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/remote-web-pairing.test.ts +389 -0
  28. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/ingress.ts +22 -0
  29. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/remote-web-pairing.ts +508 -18
  30. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/rpc.ts +174 -0
  31. package/node_modules/@vellumai/gateway-client/src/__tests__/contact-read-contracts.test.ts +32 -0
  32. package/node_modules/@vellumai/gateway-client/src/__tests__/gateway-client.test.ts +1 -0
  33. package/node_modules/@vellumai/gateway-client/src/__tests__/inbound-event-kind.test.ts +82 -0
  34. package/node_modules/@vellumai/gateway-client/src/__tests__/plugin-admission-denied-contract.test.ts +56 -0
  35. package/node_modules/@vellumai/gateway-client/src/__tests__/trust-verdict-contract.test.ts +18 -0
  36. package/node_modules/@vellumai/gateway-client/src/admission-policy-contract.ts +5 -11
  37. package/node_modules/@vellumai/gateway-client/src/channel-permission-contract.ts +3 -1
  38. package/node_modules/@vellumai/gateway-client/src/gateway-ipc-contracts.ts +9 -0
  39. package/node_modules/@vellumai/gateway-client/src/inbound-contract.ts +4 -0
  40. package/node_modules/@vellumai/gateway-client/src/inbound-event-kind.ts +75 -0
  41. package/node_modules/@vellumai/gateway-client/src/index.ts +17 -0
  42. package/node_modules/@vellumai/gateway-client/src/outbound-contract.ts +8 -0
  43. package/node_modules/@vellumai/gateway-client/src/plugin-admission-denied-contract.ts +47 -0
  44. package/node_modules/@vellumai/gateway-client/src/trust-verdict-contract.ts +11 -0
  45. package/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +37 -0
  46. package/node_modules/@vellumai/service-contracts/src/__tests__/remote-web-pairing.test.ts +389 -0
  47. package/node_modules/@vellumai/service-contracts/src/ingress.ts +22 -0
  48. package/node_modules/@vellumai/service-contracts/src/remote-web-pairing.ts +508 -18
  49. package/node_modules/@vellumai/service-contracts/src/rpc.ts +174 -0
  50. package/openapi.yaml +419 -55
  51. package/package.json +4 -1
  52. package/scripts/sync-llm-catalog.ts +6 -0
  53. package/src/__tests__/approval-card-edit-inbound-handoff.test.ts +199 -0
  54. package/src/__tests__/approval-card-edit.test.ts +153 -0
  55. package/src/__tests__/attachments-store-heic-normalize.test.ts +1 -1
  56. package/src/__tests__/available-skills.test.ts +54 -0
  57. package/src/__tests__/avatar-identity-sync.test.ts +5 -1
  58. package/src/__tests__/catalog-install-normalize.test.ts +9 -1
  59. package/src/__tests__/channel-policy.test.ts +1 -3
  60. package/src/__tests__/channel-readiness-discord.test.ts +9 -70
  61. package/src/__tests__/compactor-call-site-logging.test.ts +61 -0
  62. package/src/__tests__/config-loader-backfill.test.ts +69 -0
  63. package/src/__tests__/config-schema.test.ts +2 -3
  64. package/src/__tests__/conversation-agent-loop.test.ts +238 -0
  65. package/src/__tests__/conversation-attachments.test.ts +0 -1
  66. package/src/__tests__/conversation-error.test.ts +44 -0
  67. package/src/__tests__/conversation-evictor.test.ts +19 -0
  68. package/src/__tests__/conversation-fork-referential.test.ts +73 -63
  69. package/src/__tests__/conversation-fork-retrospective.test.ts +99 -74
  70. package/src/__tests__/conversation-runtime-assembly.test.ts +23 -0
  71. package/src/__tests__/conversation-slash.test.ts +9 -0
  72. package/src/__tests__/conversation-title-service.test.ts +97 -0
  73. package/src/__tests__/conversation-tool-setup-attribution.test.ts +16 -0
  74. package/src/__tests__/credential-broker-server-use.test.ts +0 -218
  75. package/src/__tests__/credential-broker.test.ts +43 -420
  76. package/src/__tests__/credential-record-write-through.test.ts +78 -0
  77. package/src/__tests__/credential-routes.test.ts +17 -1
  78. package/src/__tests__/credential-security-invariants.test.ts +8 -9
  79. package/src/__tests__/default-profile-catalog-fallback.test.ts +289 -0
  80. package/src/__tests__/delete-propagation.test.ts +92 -2
  81. package/src/__tests__/discord-callback-round-trip.test.ts +93 -0
  82. package/src/__tests__/discord-channel-config.test.ts +237 -0
  83. package/src/__tests__/edit-propagation.test.ts +42 -2
  84. package/src/__tests__/evict-conversations-for-reload.test.ts +51 -1
  85. package/src/__tests__/fallback-breaker.test.ts +1335 -0
  86. package/src/__tests__/gateway-threshold-reader-mock.ts +6 -0
  87. package/src/__tests__/guardian-card-withdrawal.test.ts +30 -0
  88. package/src/__tests__/handlers-user-message-approval-consumption.test.ts +0 -2
  89. package/src/__tests__/image-conversion.test.ts +38 -4
  90. package/src/__tests__/install-skill-routing.test.ts +25 -0
  91. package/src/__tests__/llm-catalog-parity.test.ts +4 -0
  92. package/src/__tests__/llm-resolver.test.ts +74 -0
  93. package/src/__tests__/llm-schema-fallback-profile.test.ts +359 -0
  94. package/src/__tests__/managed-fallback-dispatch.test.ts +430 -0
  95. package/src/__tests__/managed-profile-guard.test.ts +28 -0
  96. package/src/__tests__/managed-speech-defaults.test.ts +196 -1
  97. package/src/__tests__/mcp-cli.test.ts +23 -1
  98. package/src/__tests__/mcp-tool-annotations-risk.test.ts +43 -34
  99. package/src/__tests__/media-stream-stt-session.test.ts +2 -0
  100. package/src/__tests__/notification-decision-fallback.test.ts +106 -0
  101. package/src/__tests__/notification-discord-adapter.test.ts +162 -0
  102. package/src/__tests__/oauth-connect-orchestrator.test.ts +95 -0
  103. package/src/__tests__/persist-unsendable-image-downscale.test.ts +6 -8
  104. package/src/__tests__/persist-unsendable-image.test.ts +3 -3
  105. package/src/__tests__/platform.test.ts +19 -1
  106. package/src/__tests__/plugin-import-boundary-guard.test.ts +5 -1
  107. package/src/__tests__/provider-catalog-visibility.test.ts +17 -0
  108. package/src/__tests__/provider-platform-proxy-integration.test.ts +8 -1
  109. package/src/__tests__/provider-usage-tracking.test.ts +56 -0
  110. package/src/__tests__/require-fresh-approval.test.ts +5 -2
  111. package/src/__tests__/retry-fallback-escalation.test.ts +1093 -0
  112. package/src/__tests__/schedule-retry.test.ts +183 -4
  113. package/src/__tests__/scheduler-reuse-conversation.test.ts +6 -6
  114. package/src/__tests__/secret-routes-platform-proxy.test.ts +55 -0
  115. package/src/__tests__/skill-load-tool.test.ts +34 -0
  116. package/src/__tests__/skill-tool-factory.test.ts +6 -1
  117. package/src/__tests__/skill-tool-manifest.test.ts +20 -0
  118. package/src/__tests__/skills.test.ts +25 -0
  119. package/src/__tests__/subagent-manager-notify.test.ts +38 -0
  120. package/src/__tests__/terminal-tools.test.ts +2 -0
  121. package/src/__tests__/tool-approval-handler.test.ts +146 -2
  122. package/src/__tests__/tool-approval-seed-content-blocks.test.ts +108 -2
  123. package/src/__tests__/tool-audit.test.ts +111 -40
  124. package/src/__tests__/tool-executor-lifecycle-events.test.ts +228 -18
  125. package/src/__tests__/ui-shape-teaching.test.ts +1 -1
  126. package/src/__tests__/verification-control-plane-policy.test.ts +6 -2
  127. package/src/__tests__/voice-config-update.test.ts +43 -0
  128. package/src/__tests__/workspace-migration-147-rename-colliding-backup-profile-names.test.ts +480 -0
  129. package/src/__tests__/workspace-migration-148-strip-unsupported-fallback-profiles.test.ts +167 -0
  130. package/src/__tests__/workspace-migration-149-repoint-backup-profile-selections.test.ts +144 -0
  131. package/src/agent/loop.ts +31 -2
  132. package/src/approvals/guardian-card-withdrawal.ts +22 -0
  133. package/src/avatar/__tests__/ensure-raster.test.ts +291 -0
  134. package/src/avatar/avatar-manifest.ts +48 -100
  135. package/src/avatar/avatar-store.ts +7 -7
  136. package/src/avatar/ensure-raster.ts +146 -0
  137. package/src/avatar/resvg-lazy.test.ts +0 -1
  138. package/src/avatar/traits-png-sync.ts +9 -10
  139. package/src/background-wake/wake-intent-hooks.test.ts +0 -1
  140. package/src/backup/__tests__/paths.test.ts +6 -2
  141. package/src/backup/paths.ts +6 -4
  142. package/src/bundler/app-compiler.ts +2 -2
  143. package/src/bundler/compiler-tools.test.ts +36 -0
  144. package/src/bundler/compiler-tools.ts +54 -18
  145. package/src/calls/__tests__/telephony-synthesis-language.test.ts +81 -0
  146. package/src/calls/__tests__/voice-session-bridge.test.ts +57 -0
  147. package/src/calls/media-stream-stt-session.ts +2 -1
  148. package/src/calls/telephony-synthesis-language.ts +13 -5
  149. package/src/calls/voice-session-bridge.ts +19 -4
  150. package/src/channels/config.ts +23 -12
  151. package/src/cli/AGENTS.md +3 -1
  152. package/src/cli/commands/backup.help.ts +10 -13
  153. package/src/cli/commands/contacts.help.ts +16 -4
  154. package/src/cli/commands/contacts.ts +5 -1
  155. package/src/cli/commands/credentials.help.ts +1 -1
  156. package/src/cli/commands/inference-providers.ts +18 -53
  157. package/src/cli/commands/mcp.help.ts +6 -5
  158. package/src/cli/commands/mcp.ts +1 -1
  159. package/src/cli/commands/memory/memory-retrospective.ts +1 -0
  160. package/src/cli/commands/stt.help.ts +2 -2
  161. package/src/config/__tests__/backup-schema.test.ts +1 -1
  162. package/src/config/__tests__/default-profile-catalog.test.ts +83 -2
  163. package/src/config/__tests__/loader-sparse-array-cleanup.test.ts +1 -1
  164. package/src/config/__tests__/memory-retrospective-schema.test.ts +12 -15
  165. package/src/config/bundled-skills/computer-use/SKILL.md +6 -6
  166. package/src/config/bundled-skills/computer-use/TOOLS.json +9 -6
  167. package/src/config/bundled-skills/media-processing/services/audio-transcribe.ts +3 -1
  168. package/src/config/bundled-skills/media-processing/services/preprocess.ts +1 -1
  169. package/src/config/bundled-skills/phone-calls/SKILL.md +1 -1
  170. package/src/config/bundled-skills/phone-calls/references/CONFIG.md +16 -15
  171. package/src/config/bundled-skills/phone-calls/references/TROUBLESHOOTING.md +2 -1
  172. package/src/config/bundled-skills/settings/TOOLS.json +11 -5
  173. package/src/config/bundled-skills/settings/tools/open-system-settings.test.ts +85 -0
  174. package/src/config/bundled-skills/settings/tools/open-system-settings.ts +33 -8
  175. package/src/config/bundled-skills/settings/tools/voice-config-update.ts +54 -3
  176. package/src/config/bundled-skills/transcribe/tools/transcribe-media.ts +1 -1
  177. package/src/config/default-profile-catalog.ts +195 -10
  178. package/src/config/default-profile-names.ts +41 -0
  179. package/src/config/feature-flag-registry.json +34 -2
  180. package/src/config/inference-profile-validation.ts +11 -2
  181. package/src/config/llm-resolver.ts +25 -0
  182. package/src/config/loader.ts +3 -0
  183. package/src/config/managed-speech-defaults.ts +160 -10
  184. package/src/config/schema.ts +2 -0
  185. package/src/config/schemas/__tests__/live-voice.test.ts +7 -6
  186. package/src/config/schemas/__tests__/stt.test.ts +94 -0
  187. package/src/config/schemas/backup.ts +1 -1
  188. package/src/config/schemas/channels.ts +32 -0
  189. package/src/config/schemas/live-voice.ts +13 -4
  190. package/src/config/schemas/llm.ts +263 -15
  191. package/src/config/schemas/mcp.ts +10 -2
  192. package/src/config/schemas/memory-retrospective.ts +1 -19
  193. package/src/config/schemas/services.ts +24 -0
  194. package/src/config/schemas/stt.ts +128 -5
  195. package/src/config/seed-inference-profiles.ts +32 -3
  196. package/src/config/skill-state.ts +5 -0
  197. package/src/config/skills.ts +21 -0
  198. package/src/contacts/notify-contacts-changed.ts +5 -2
  199. package/src/context/compactor.ts +74 -1
  200. package/src/daemon/__tests__/conversation-tool-setup.test.ts +138 -1
  201. package/src/daemon/config-watcher.ts +2 -1
  202. package/src/daemon/conversation-agent-loop-handlers.ts +27 -0
  203. package/src/daemon/conversation-agent-loop.ts +86 -10
  204. package/src/daemon/conversation-error.ts +25 -0
  205. package/src/daemon/conversation-evictor.ts +2 -4
  206. package/src/daemon/conversation-runtime-assembly.ts +19 -7
  207. package/src/daemon/conversation-skill-tools.ts +5 -1
  208. package/src/daemon/conversation-slash.ts +2 -2
  209. package/src/daemon/conversation-store.ts +8 -1
  210. package/src/daemon/conversation-tool-setup.ts +37 -0
  211. package/src/daemon/conversation.ts +0 -4
  212. package/src/daemon/handlers/channel-config-result.ts +30 -0
  213. package/src/daemon/handlers/config-discord-channel.ts +301 -0
  214. package/src/daemon/handlers/config-ingress.ts +9 -0
  215. package/src/daemon/handlers/config-slack-channel.ts +13 -15
  216. package/src/daemon/handlers/config-telegram.ts +2 -5
  217. package/src/daemon/handlers/conversations.ts +0 -2
  218. package/src/daemon/handlers/skills.ts +25 -7
  219. package/src/daemon/lifecycle.ts +3 -1
  220. package/src/daemon/message-types/messages.ts +0 -2
  221. package/src/daemon/tool-setup-types.ts +5 -3
  222. package/src/daemon/trust-context-types.test.ts +33 -0
  223. package/src/heartbeat/__tests__/heartbeat-service.test.ts +0 -1
  224. package/src/live-voice/__tests__/live-voice-flux-turn-end.test.ts +58 -4
  225. package/src/live-voice/__tests__/live-voice-managed-speech-fallback.test.ts +8 -3
  226. package/src/live-voice/__tests__/live-voice-session-manager.test.ts +73 -11
  227. package/src/live-voice/__tests__/live-voice-session-preflight.test.ts +148 -2
  228. package/src/live-voice/__tests__/live-voice-session-telemetry.test.ts +64 -0
  229. package/src/live-voice/__tests__/live-voice-stt.test.ts +3 -0
  230. package/src/live-voice/__tests__/live-voice-text-turn.test.ts +391 -0
  231. package/src/live-voice/__tests__/protocol.test.ts +224 -0
  232. package/src/live-voice/live-voice-credential-preflight.ts +5 -1
  233. package/src/live-voice/live-voice-session-manager.ts +39 -2
  234. package/src/live-voice/live-voice-session.ts +224 -9
  235. package/src/live-voice/protocol.ts +187 -1
  236. package/src/messaging/providers/discord/api.ts +2 -1
  237. package/src/messaging/providers/discord/withdraw.ts +62 -0
  238. package/src/messaging/read-provider-metadata.ts +32 -0
  239. package/src/monitoring/__tests__/file-descriptors.test.ts +32 -0
  240. package/src/monitoring/__tests__/process-memory.test.ts +34 -1
  241. package/src/monitoring/db-integrity-sample.ts +1 -0
  242. package/src/monitoring/file-descriptors.ts +39 -6
  243. package/src/monitoring/process-memory.ts +37 -5
  244. package/src/monitoring/resource-sampler.ts +25 -8
  245. package/src/notifications/__tests__/activity-failed-dedupe.test.ts +161 -0
  246. package/src/notifications/__tests__/background-failure-signal.test.ts +107 -0
  247. package/src/notifications/__tests__/connected-channels.test.ts +12 -0
  248. package/src/notifications/__tests__/copy-composer.test.ts +83 -0
  249. package/src/notifications/__tests__/destination-resolver.test.ts +38 -0
  250. package/src/notifications/activity-failed-dedupe.ts +95 -0
  251. package/src/notifications/adapters/discord.ts +132 -0
  252. package/src/notifications/adapters/shared.ts +16 -0
  253. package/src/notifications/adapters/slack.ts +6 -1
  254. package/src/notifications/adapters/telegram.ts +5 -8
  255. package/src/notifications/approval-card-data.ts +94 -1
  256. package/src/notifications/background-failure-signal.ts +116 -0
  257. package/src/notifications/broadcaster.ts +3 -9
  258. package/src/notifications/copy-composer.ts +41 -8
  259. package/src/notifications/decision-engine.ts +55 -0
  260. package/src/notifications/destination-resolver.ts +45 -5
  261. package/src/notifications/emit-signal.ts +19 -5
  262. package/src/notifications/guardian-question-mode.ts +57 -0
  263. package/src/notifications/types.ts +2 -8
  264. package/src/oauth/__tests__/seed-providers-managed.test.ts +18 -0
  265. package/src/oauth/connect-orchestrator.ts +16 -0
  266. package/src/oauth/seed-providers.ts +262 -0
  267. package/src/permissions/checker.test.ts +21 -0
  268. package/src/permissions/checker.ts +6 -0
  269. package/src/permissions/gateway-threshold-reader.test.ts +184 -0
  270. package/src/permissions/gateway-threshold-reader.ts +144 -10
  271. package/src/permissions/prompter.ts +0 -6
  272. package/src/permissions/types.ts +5 -4
  273. package/src/persistence/__tests__/bulk-write-gate.test.ts +0 -38
  274. package/src/persistence/bulk-write-gate.ts +9 -10
  275. package/src/persistence/conversation-crud.ts +88 -134
  276. package/src/persistence/conversation-title-service.ts +43 -29
  277. package/src/persistence/embeddings/embedding-local.ts +14 -85
  278. package/src/persistence/embeddings/embedding-runtime-manager.ts +1 -0
  279. package/src/persistence/lifecycle-events-store.test.ts +50 -0
  280. package/src/persistence/lifecycle-events-store.ts +75 -5
  281. package/src/platform/platform-patch-queue.test.ts +368 -0
  282. package/src/platform/platform-patch-queue.ts +190 -0
  283. package/src/platform/sync-avatar.test.ts +527 -0
  284. package/src/platform/sync-avatar.ts +209 -0
  285. package/src/platform/sync-identity.test.ts +75 -0
  286. package/src/platform/sync-identity.ts +17 -110
  287. package/src/plugin-api/model-profiles.test.ts +2 -2
  288. package/src/plugin-api/model-profiles.ts +7 -7
  289. package/src/plugin-api/transcription-session.ts +1 -1
  290. package/src/plugins/defaults/compaction/window-manager.ts +4 -0
  291. package/src/plugins/defaults/image-recovery/recover.ts +2 -2
  292. package/src/plugins/defaults/memory/__tests__/memory-retrospective-job.test.ts +133 -34
  293. package/src/plugins/defaults/memory/__tests__/memory-retrospective-prompt.test.ts +21 -31
  294. package/src/plugins/defaults/memory/__tests__/memory-retrospective-provider-path.test.ts +13 -9
  295. package/src/plugins/defaults/memory/__tests__/memory-retrospective-wake-chain.test.ts +31 -4
  296. package/src/plugins/defaults/memory/memory-retrospective-constants.ts +0 -11
  297. package/src/plugins/defaults/memory/memory-retrospective-fork-boundary.ts +27 -13
  298. package/src/plugins/defaults/memory/memory-retrospective-job.ts +183 -113
  299. package/src/plugins/defaults/memory/memory-retrospective-prompt.ts +13 -13
  300. package/src/plugins/defaults/memory/src/memory-v2-routes.ts +2 -2
  301. package/src/plugins/defaults/memory/substrate/__tests__/consolidation-job.test.ts +1 -1
  302. package/src/plugins/defaults/memory/substrate/consolidation-job.ts +4 -2
  303. package/src/plugins/defaults/memory/substrate/sweep-job.ts +9 -42
  304. package/src/plugins/defaults/memory/v2/rerank-local.ts +1 -0
  305. package/src/plugins/defaults/memory/worker.ts +7 -0
  306. package/src/providers/__tests__/provider-secret-catalog.test.ts +1 -0
  307. package/src/providers/__tests__/retry-callsite.test.ts +55 -0
  308. package/src/providers/__tests__/vellum-connection-routing.test.ts +21 -3
  309. package/src/providers/connection-resolution.ts +2 -17
  310. package/src/providers/fallback-breaker.ts +389 -0
  311. package/src/providers/inference/__tests__/adapter-factory-opencode.test.ts +92 -0
  312. package/src/providers/inference/__tests__/base-url-route-validation.test.ts +16 -0
  313. package/src/providers/inference/__tests__/base-url-security.test.ts +12 -0
  314. package/src/providers/inference/adapter-factory.ts +246 -3
  315. package/src/providers/inference/auth.ts +15 -14
  316. package/src/providers/inference/chatgpt-subscription-auth.ts +70 -0
  317. package/src/providers/inference/chatgpt-subscription-credentials.ts +84 -0
  318. package/src/providers/inference/resolve-auth.ts +1 -1
  319. package/src/providers/media-resolve.ts +2 -3
  320. package/src/providers/model-catalog.ts +100 -0
  321. package/src/providers/openai/__tests__/api-error-normalization.test.ts +22 -0
  322. package/src/providers/openai/__tests__/chat-template-flatten.test.ts +198 -0
  323. package/src/providers/openai/api-error-normalization.ts +13 -0
  324. package/src/providers/openai/chat-completions-provider.ts +84 -0
  325. package/src/providers/opencode/client.test.ts +150 -0
  326. package/src/providers/opencode/client.ts +61 -0
  327. package/src/providers/platform-proxy/constants.ts +5 -0
  328. package/src/providers/provider-resolvability.ts +20 -0
  329. package/src/providers/provider-secret-catalog.ts +3 -2
  330. package/src/providers/retry.ts +956 -68
  331. package/src/providers/speech-to-text/__tests__/deepgram-flux-frames.test.ts +42 -0
  332. package/src/providers/speech-to-text/__tests__/deepgram-flux-realtime.test.ts +136 -0
  333. package/src/providers/speech-to-text/__tests__/provider-catalog.test.ts +120 -0
  334. package/src/providers/speech-to-text/__tests__/resolve.test.ts +316 -12
  335. package/src/providers/speech-to-text/deepgram-flux-frames.ts +83 -3
  336. package/src/providers/speech-to-text/deepgram-flux-realtime.ts +132 -4
  337. package/src/providers/speech-to-text/provider-catalog.ts +191 -3
  338. package/src/providers/speech-to-text/resolve.ts +132 -24
  339. package/src/providers/speech-to-text/vellum-managed-flux-realtime.ts +296 -0
  340. package/src/providers/types.ts +39 -0
  341. package/src/providers/usage-tracking.ts +12 -1
  342. package/src/providers/vellum/client.ts +29 -0
  343. package/src/providers/vellum-model-routing.test.ts +2 -0
  344. package/src/providers/vellum-model-routing.ts +3 -3
  345. package/src/runtime/AGENTS.md +1 -2
  346. package/src/runtime/__tests__/agent-wake.test.ts +105 -3
  347. package/src/runtime/__tests__/background-job-runner.test.ts +89 -3
  348. package/src/runtime/agent-wake.ts +44 -5
  349. package/src/runtime/background-job-runner.ts +68 -50
  350. package/src/runtime/channel-readiness-service.ts +0 -39
  351. package/src/runtime/http-server.ts +12 -4
  352. package/src/runtime/routes/__tests__/avatar-state-routes.test.ts +18 -18
  353. package/src/runtime/routes/__tests__/backup-routes.test.ts +9 -5
  354. package/src/runtime/routes/__tests__/chatgpt-subscription-auth-routes.test.ts +372 -0
  355. package/src/runtime/routes/__tests__/contact-routes.test.ts +7 -0
  356. package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +96 -0
  357. package/src/runtime/routes/__tests__/inference-profiles-routes.test.ts +37 -0
  358. package/src/runtime/routes/__tests__/ingress-status-routes.test.ts +2 -1
  359. package/src/runtime/routes/__tests__/mcp-add-default-risk.test.ts +87 -0
  360. package/src/runtime/routes/acp-claude-auth-routes.ts +25 -54
  361. package/src/runtime/routes/approval-routes.ts +0 -12
  362. package/src/runtime/routes/avatar-routes.ts +17 -30
  363. package/src/runtime/routes/backup-routes.ts +2 -2
  364. package/src/runtime/routes/chatgpt-subscription-auth-routes.ts +296 -113
  365. package/src/runtime/routes/contact-prompt-routes.ts +65 -6
  366. package/src/runtime/routes/contact-routes.ts +20 -15
  367. package/src/runtime/routes/conversation-query-routes.ts +98 -10
  368. package/src/runtime/routes/conversation-routes.ts +2 -2
  369. package/src/runtime/routes/credential-routes.ts +2 -1
  370. package/src/runtime/routes/guardian-approval-interception.ts +12 -9
  371. package/src/runtime/routes/inbound-message-handler.ts +47 -48
  372. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +18 -13
  373. package/src/runtime/routes/inbound-stages/admission-policy.ts +2 -2
  374. package/src/runtime/routes/inbound-stages/edit-intercept.ts +20 -2
  375. package/src/runtime/routes/inbound-stages/reaction-intercept.ts +9 -8
  376. package/src/runtime/routes/inbound-stages/transcribe-audio.ts +1 -1
  377. package/src/runtime/routes/index.ts +2 -0
  378. package/src/runtime/routes/inference-profile-session-handler.ts +2 -2
  379. package/src/runtime/routes/inference-profiles-routes.ts +12 -7
  380. package/src/runtime/routes/inference-provider-connection-routes.ts +2 -2
  381. package/src/runtime/routes/inference-send-routes.ts +2 -2
  382. package/src/runtime/routes/ingress-status-routes.ts +2 -2
  383. package/src/runtime/routes/integrations/discord.ts +119 -0
  384. package/src/runtime/routes/llm-call-sites-routes.ts +2 -2
  385. package/src/runtime/routes/mcp-auth-routes.ts +12 -6
  386. package/src/runtime/routes/migration-routes.ts +3 -1
  387. package/src/runtime/routes/oauth-pending-flows.ts +136 -0
  388. package/src/runtime/routes/secret-routes.ts +7 -0
  389. package/src/runtime/routes/stt-routes.ts +38 -6
  390. package/src/runtime/routes/wake-conversation-routes.ts +8 -1
  391. package/src/runtime/routes/watch-routes.ts +9 -5
  392. package/src/runtime/sync/resource-sync-events.ts +2 -0
  393. package/src/runtime/trust-verdict-consumer.ts +3 -3
  394. package/src/schedule/__tests__/worker-feature-flags.test.ts +58 -0
  395. package/src/schedule/retry-policy.ts +8 -8
  396. package/src/schedule/run-script.ts +14 -23
  397. package/src/schedule/schedule-recovery.ts +0 -1
  398. package/src/schedule/scheduler.ts +89 -51
  399. package/src/schedule/worker.ts +57 -0
  400. package/src/security/__tests__/openai-device-auth.test.ts +355 -0
  401. package/src/security/ces-rpc-record-backend.ts +123 -0
  402. package/src/security/oauth2.ts +7 -0
  403. package/src/security/openai-device-auth.ts +364 -0
  404. package/src/security/secure-keys.ts +15 -0
  405. package/src/skills/available-skills.ts +10 -1
  406. package/src/skills/catalog-install.ts +19 -1
  407. package/src/skills/inline-command-runner.ts +6 -2
  408. package/src/skills/platform-compatibility.test.ts +49 -0
  409. package/src/skills/platform-compatibility.ts +65 -0
  410. package/src/skills/tool-manifest.ts +20 -0
  411. package/src/stt/__tests__/roles.test.ts +152 -0
  412. package/src/stt/daemon-batch-transcriber.ts +4 -1
  413. package/src/stt/roles.ts +180 -0
  414. package/src/stt/stt-stream-session.ts +3 -2
  415. package/src/stt/types.ts +33 -3
  416. package/src/subagent/manager.ts +12 -0
  417. package/src/telemetry/__tests__/live-voice-funnel.test.ts +34 -0
  418. package/src/telemetry/live-voice-funnel.ts +12 -2
  419. package/src/telemetry/telemetry-wire.generated.ts +6 -0
  420. package/src/telemetry/tool-audit.ts +83 -30
  421. package/src/telemetry/tool-executed-events-store.test.ts +0 -1
  422. package/src/telemetry/turn-outcome.ts +75 -4
  423. package/src/tools/client-os.ts +115 -0
  424. package/src/tools/computer-use/definitions.ts +11 -7
  425. package/src/tools/computer-use/skill-proxy-bridge.ts +2 -2
  426. package/src/tools/credentials/broker-types.ts +0 -71
  427. package/src/tools/credentials/broker.ts +6 -201
  428. package/src/tools/credentials/metadata-store.ts +65 -16
  429. package/src/tools/credentials/store.ts +2 -0
  430. package/src/tools/executor.ts +2 -8
  431. package/src/tools/host-shell.test.ts +75 -0
  432. package/src/tools/host-shell.ts +24 -0
  433. package/src/tools/host-terminal/host-shell.ts +15 -44
  434. package/src/tools/mcp/mcp-tool-factory.ts +44 -9
  435. package/src/tools/permission-checker.ts +73 -21
  436. package/src/tools/policy-context.ts +1 -0
  437. package/src/tools/shared/filesystem/image-read.ts +1 -1
  438. package/src/tools/skills/find-similar-skills.ts +10 -2
  439. package/src/tools/skills/load.ts +41 -6
  440. package/src/tools/skills/sandbox-runner.ts +8 -16
  441. package/src/tools/skills/skill-tool-factory.ts +1 -0
  442. package/src/tools/terminal/__tests__/safe-env.test.ts +64 -1
  443. package/src/tools/terminal/safe-env.ts +39 -9
  444. package/src/tools/terminal/shell.ts +12 -31
  445. package/src/tools/tool-approval-handler.ts +64 -10
  446. package/src/tools/tool-types.ts +10 -0
  447. package/src/tools/types.ts +19 -3
  448. package/src/tools/ui-surface/surface-shape-docs.ts +4 -3
  449. package/src/tools/workflows/manage-workflows.ts +2 -2
  450. package/src/tools/workflows/run-workflow.test.ts +2 -1
  451. package/src/util/__tests__/file-use.test.ts +61 -0
  452. package/src/util/__tests__/process-table.test.ts +66 -0
  453. package/src/util/__tests__/process-tree.test.ts +46 -0
  454. package/src/util/errors.ts +1 -0
  455. package/src/util/file-use.ts +91 -0
  456. package/src/util/host-process.test.ts +17 -0
  457. package/src/util/host-process.ts +75 -0
  458. package/src/util/image-conversion.ts +39 -7
  459. package/src/util/platform.ts +32 -13
  460. package/src/util/process-table.ts +249 -0
  461. package/src/util/process-tree.ts +85 -129
  462. package/src/util/provider-error-patterns.ts +20 -0
  463. package/src/util/spawn.ts +9 -2
  464. package/src/watch/__tests__/watch-retro.test.ts +48 -1
  465. package/src/watch/watch-retro.ts +46 -4
  466. package/src/workspace/git-service.ts +4 -14
  467. package/src/workspace/migrations/147-rename-colliding-backup-profile-names.ts +360 -0
  468. package/src/workspace/migrations/148-strip-unsupported-fallback-profiles.ts +117 -0
  469. package/src/workspace/migrations/149-repoint-backup-profile-selections.ts +204 -0
  470. package/src/workspace/migrations/150-stt-flux-provider-to-model-family.ts +139 -0
  471. package/src/workspace/migrations/__tests__/150-stt-flux-provider-to-model-family.test.ts +160 -0
  472. package/src/workspace/migrations/registry.ts +8 -0
  473. package/src/__tests__/permission-types.test.ts +0 -17
  474. package/src/channels/gateway-discord-admission.ts +0 -32
  475. package/src/persistence/fork-message-copy.ts +0 -239
  476. package/src/plugins/defaults/memory/__tests__/fork-message-copy.test.ts +0 -221
  477. package/src/security/__tests__/oauth2-device-code.test.ts +0 -431
  478. package/src/security/oauth2-device-code.ts +0 -312
@@ -1,221 +0,0 @@
1
- import { beforeEach, describe, expect, test } from "bun:test";
2
-
3
- import { setConfig } from "../../../../__tests__/helpers/set-config.js";
4
-
5
- // Disable memory so `addMessage` does not index into the real memory
6
- // pipeline (both flags default true under the real loader).
7
- setConfig("memory", { enabled: false, v2: { enabled: false } });
8
-
9
- import {
10
- addMessage,
11
- createConversation,
12
- getMessages,
13
- } from "../../../../persistence/conversation-crud.js";
14
- import { getDb, getSqlite } from "../../../../persistence/db-connection.js";
15
- import { initializeDb } from "../../../../persistence/db-init.js";
16
- import {
17
- buildForkCopyScript,
18
- copyForkMessagesViaSubprocess,
19
- type ForkIdPair,
20
- } from "../../../../persistence/fork-message-copy.js";
21
- import { messages as messagesTable } from "../../../../persistence/schema/index.js";
22
-
23
- await initializeDb();
24
-
25
- function resetTables(): void {
26
- const db = getDb();
27
- db.run("DELETE FROM messages");
28
- db.run("DELETE FROM conversations");
29
- }
30
-
31
- /** Mirror of the production `cloneForkMessageMetadata` semantics. */
32
- function expectedClonedMetadata(
33
- sourceMetadata: string | null,
34
- sourceMessageId: string,
35
- ): unknown {
36
- const parsed = sourceMetadata == null ? null : JSON.parse(sourceMetadata);
37
- if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
38
- const record = parsed as Record<string, unknown>;
39
- const existing = record.forkSourceMessageId;
40
- return {
41
- ...record,
42
- forkSourceMessageId:
43
- typeof existing === "string" ? existing : sourceMessageId,
44
- };
45
- }
46
- return { forkSourceMessageId: sourceMessageId };
47
- }
48
-
49
- /** Build an in-JS old→new id map for a source conversation's messages. */
50
- function idPairsFor(sourceConversationId: string): ForkIdPair[] {
51
- return getMessages(sourceConversationId).map((m) => ({
52
- oldId: m.id,
53
- newId: crypto.randomUUID(),
54
- }));
55
- }
56
-
57
- describe("copyForkMessagesViaSubprocess", () => {
58
- beforeEach(() => {
59
- resetTables();
60
- });
61
-
62
- test("copies rows with cloneForkMessageMetadata parity and a fresh id", async () => {
63
- const source = createConversation("source");
64
- await addMessage(source.id, "user", "draft a plan", {
65
- metadata: { branch: 1, source: "user" },
66
- skipIndexing: true,
67
- });
68
- await addMessage(source.id, "assistant", "here is a pass", {
69
- metadata: { automated: true },
70
- skipIndexing: true,
71
- });
72
- // Already-stamped metadata must be preserved, not overwritten.
73
- await addMessage(source.id, "user", "carry this", {
74
- metadata: { forkSourceMessageId: "pre-existing", note: "x" },
75
- skipIndexing: true,
76
- });
77
- // Null metadata must become a fresh provenance-only object.
78
- await addMessage(source.id, "user", "no metadata", {
79
- skipIndexing: true,
80
- });
81
-
82
- const fork = createConversation({
83
- title: "fork",
84
- conversationType: "background",
85
- });
86
- const sourceMessages = getMessages(source.id);
87
- const idPairs = sourceMessages.map((m) => ({
88
- oldId: m.id,
89
- newId: crypto.randomUUID(),
90
- }));
91
-
92
- const result = await copyForkMessagesViaSubprocess({
93
- forkConversationId: fork.id,
94
- idPairs,
95
- forceInProcess: true,
96
- });
97
- expect(result.ok).toBe(true);
98
-
99
- const forkMessages = getMessages(fork.id);
100
- expect(forkMessages).toHaveLength(sourceMessages.length);
101
- expect(forkMessages.map((m) => m.role)).toEqual(
102
- sourceMessages.map((m) => m.role),
103
- );
104
- expect(forkMessages.map((m) => m.content)).toEqual(
105
- sourceMessages.map((m) => m.content),
106
- );
107
- expect(forkMessages.map((m) => m.createdAt)).toEqual(
108
- sourceMessages.map((m) => m.createdAt),
109
- );
110
- expect(
111
- forkMessages.map((m) => (m.metadata ? JSON.parse(m.metadata) : null)),
112
- ).toEqual(
113
- sourceMessages.map((m) => expectedClonedMetadata(m.metadata, m.id)),
114
- );
115
- // Fresh ids, and assigned exactly per the supplied map.
116
- const byOld = new Map(idPairs.map((p) => [p.oldId, p.newId]));
117
- for (const src of sourceMessages) {
118
- const expectedNewId = byOld.get(src.id);
119
- expect(forkMessages.some((f) => f.id === expectedNewId)).toBe(true);
120
- }
121
- });
122
-
123
- test("does not copy client_message_id onto fork rows", async () => {
124
- const source = createConversation("source");
125
- const db = getDb();
126
- const createdAt = Date.now();
127
- db.run(
128
- `INSERT INTO messages (id, conversation_id, role, content, created_at, client_message_id)
129
- VALUES ('msg-with-client-id', '${source.id}', 'user', 'hi', ${createdAt}, 'client-123')`,
130
- );
131
-
132
- const fork = createConversation({
133
- title: "fork",
134
- conversationType: "background",
135
- });
136
- await copyForkMessagesViaSubprocess({
137
- forkConversationId: fork.id,
138
- idPairs: [{ oldId: "msg-with-client-id", newId: crypto.randomUUID() }],
139
- forceInProcess: true,
140
- });
141
-
142
- const forkRow = db
143
- .select()
144
- .from(messagesTable)
145
- .all()
146
- .find((r) => r.conversationId === fork.id);
147
- expect(forkRow).toBeDefined();
148
- expect(forkRow?.clientMessageId ?? null).toBeNull();
149
- });
150
-
151
- test("copies across batch boundaries", async () => {
152
- const source = createConversation("source");
153
- for (let i = 0; i < 5; i++) {
154
- await addMessage(source.id, "user", `m${i}`, { skipIndexing: true });
155
- }
156
- const fork = createConversation({
157
- title: "fork",
158
- conversationType: "background",
159
- });
160
- const idPairs = idPairsFor(source.id);
161
-
162
- const result = await copyForkMessagesViaSubprocess({
163
- forkConversationId: fork.id,
164
- idPairs,
165
- batchSize: 2,
166
- forceInProcess: true,
167
- });
168
- expect(result.ok).toBe(true);
169
- expect(getMessages(fork.id)).toHaveLength(5);
170
- });
171
-
172
- test("no-op for an empty id map", async () => {
173
- const result = await copyForkMessagesViaSubprocess({
174
- forkConversationId: crypto.randomUUID(),
175
- idPairs: [],
176
- forceInProcess: true,
177
- });
178
- expect(result.ok).toBe(true);
179
- expect(result.elapsedMs).toBe(0);
180
- });
181
-
182
- test("does not leave the staging temp table on the connection", async () => {
183
- const source = createConversation("source");
184
- await addMessage(source.id, "user", "hi", { skipIndexing: true });
185
- const fork = createConversation({
186
- title: "fork",
187
- conversationType: "background",
188
- });
189
- await copyForkMessagesViaSubprocess({
190
- forkConversationId: fork.id,
191
- idPairs: idPairsFor(source.id),
192
- forceInProcess: true,
193
- });
194
- const tempTable = getSqlite()
195
- .query(
196
- "SELECT name FROM sqlite_temp_master WHERE type='table' AND name='_fork_id_map'",
197
- )
198
- .get();
199
- expect(tempTable).toBeNull();
200
- });
201
- });
202
-
203
- describe("buildForkCopyScript", () => {
204
- test("rejects an unsafe fork id", () => {
205
- expect(() =>
206
- buildForkCopyScript({
207
- forkConversationId: "abc'); DROP TABLE messages;--",
208
- idPairs: [],
209
- }),
210
- ).toThrow(/unsafe id/);
211
- });
212
-
213
- test("rejects an unsafe message id", () => {
214
- expect(() =>
215
- buildForkCopyScript({
216
- forkConversationId: crypto.randomUUID(),
217
- idPairs: [{ oldId: "ok", newId: "bad'id" }],
218
- }),
219
- ).toThrow(/unsafe id/);
220
- });
221
- });
@@ -1,431 +0,0 @@
1
- import { afterEach, beforeEach, describe, expect, test } from "bun:test";
2
-
3
- // ---------------------------------------------------------------------------
4
- // Mock logger before importing any code that uses it.
5
- // ---------------------------------------------------------------------------
6
- // ---------------------------------------------------------------------------
7
- // Imports under test
8
- // ---------------------------------------------------------------------------
9
- import type { DeviceCodeConfig } from "../oauth2-device-code.js";
10
- import {
11
- DeviceCodeError,
12
- OPENAI_DEVICE_CODE_CONFIG,
13
- pollForToken,
14
- requestDeviceCode,
15
- startDeviceCodeFlow,
16
- } from "../oauth2-device-code.js";
17
-
18
- // ---------------------------------------------------------------------------
19
- // Fetch mock helpers
20
- // ---------------------------------------------------------------------------
21
-
22
- const originalFetch = globalThis.fetch;
23
-
24
- function mockFetch(
25
- handler: (url: string, init?: RequestInit) => Response | Promise<Response>,
26
- ): void {
27
- globalThis.fetch = handler as typeof globalThis.fetch;
28
- }
29
-
30
- function jsonResponse(data: unknown, status = 200): Response {
31
- return new Response(JSON.stringify(data), {
32
- status,
33
- headers: { "Content-Type": "application/json" },
34
- });
35
- }
36
-
37
- const TEST_CONFIG: DeviceCodeConfig = {
38
- deviceCodeUrl: "https://auth.example.com/device/code",
39
- tokenUrl: "https://auth.example.com/oauth/token",
40
- clientId: "test-client-id",
41
- scopes: ["openid", "profile"],
42
- audience: "https://api.example.com",
43
- };
44
-
45
- // ---------------------------------------------------------------------------
46
- // Tests
47
- // ---------------------------------------------------------------------------
48
-
49
- describe("oauth2-device-code", () => {
50
- beforeEach(() => {
51
- globalThis.fetch = originalFetch;
52
- });
53
-
54
- afterEach(() => {
55
- globalThis.fetch = originalFetch;
56
- });
57
-
58
- describe("OPENAI_DEVICE_CODE_CONFIG", () => {
59
- test("has the expected OpenAI Codex values", () => {
60
- expect(OPENAI_DEVICE_CODE_CONFIG.deviceCodeUrl).toBe(
61
- "https://auth.openai.com/oauth/device/code",
62
- );
63
- expect(OPENAI_DEVICE_CODE_CONFIG.tokenUrl).toBe(
64
- "https://auth.openai.com/oauth/token",
65
- );
66
- expect(OPENAI_DEVICE_CODE_CONFIG.clientId).toBe(
67
- "app_EMoamEEZ73f0CkXaXp7hrann",
68
- );
69
- expect(OPENAI_DEVICE_CODE_CONFIG.scopes).toEqual([
70
- "openid",
71
- "profile",
72
- "email",
73
- "offline_access",
74
- ]);
75
- expect(OPENAI_DEVICE_CODE_CONFIG.audience).toBe("https://chatgpt.com");
76
- });
77
- });
78
-
79
- describe("requestDeviceCode", () => {
80
- test("sends correct request and parses response", async () => {
81
- let capturedUrl = "";
82
- let capturedBody = "";
83
-
84
- mockFetch(async (url, init) => {
85
- capturedUrl = url;
86
- capturedBody = init?.body?.toString() ?? "";
87
- return jsonResponse({
88
- device_code: "dev-code-123",
89
- user_code: "ABCD-1234",
90
- verification_uri: "https://auth.example.com/activate",
91
- verification_uri_complete:
92
- "https://auth.example.com/activate?user_code=ABCD-1234",
93
- expires_in: 900,
94
- interval: 5,
95
- });
96
- });
97
-
98
- const result = await requestDeviceCode(TEST_CONFIG);
99
-
100
- expect(capturedUrl).toBe(TEST_CONFIG.deviceCodeUrl);
101
- const params = new URLSearchParams(capturedBody);
102
- expect(params.get("client_id")).toBe("test-client-id");
103
- expect(params.get("scope")).toBe("openid profile");
104
- expect(params.get("audience")).toBe("https://api.example.com");
105
-
106
- expect(result.deviceCode).toBe("dev-code-123");
107
- expect(result.userCode).toBe("ABCD-1234");
108
- expect(result.verificationUri).toBe("https://auth.example.com/activate");
109
- expect(result.verificationUriComplete).toBe(
110
- "https://auth.example.com/activate?user_code=ABCD-1234",
111
- );
112
- expect(result.expiresIn).toBe(900);
113
- expect(result.interval).toBe(5);
114
- });
115
-
116
- test("defaults interval to 5 when not provided", async () => {
117
- mockFetch(async () =>
118
- jsonResponse({
119
- device_code: "dev-code-123",
120
- user_code: "ABCD-1234",
121
- verification_uri: "https://auth.example.com/activate",
122
- expires_in: 900,
123
- }),
124
- );
125
-
126
- const result = await requestDeviceCode(TEST_CONFIG);
127
- expect(result.interval).toBe(5);
128
- });
129
-
130
- test("omits audience when not configured", async () => {
131
- let capturedBody = "";
132
- mockFetch(async (_url, init) => {
133
- capturedBody = init?.body?.toString() ?? "";
134
- return jsonResponse({
135
- device_code: "dev-code-123",
136
- user_code: "ABCD-1234",
137
- verification_uri: "https://auth.example.com/activate",
138
- expires_in: 900,
139
- interval: 5,
140
- });
141
- });
142
-
143
- const configNoAudience: DeviceCodeConfig = {
144
- ...TEST_CONFIG,
145
- audience: undefined,
146
- };
147
- await requestDeviceCode(configNoAudience);
148
-
149
- const params = new URLSearchParams(capturedBody);
150
- expect(params.has("audience")).toBe(false);
151
- });
152
-
153
- test("throws DeviceCodeError on non-OK response", async () => {
154
- mockFetch(async () => jsonResponse({ error: "invalid_client" }, 400));
155
-
156
- await expect(requestDeviceCode(TEST_CONFIG)).rejects.toThrow(
157
- DeviceCodeError,
158
- );
159
- try {
160
- await requestDeviceCode(TEST_CONFIG);
161
- } catch (err) {
162
- expect(err).toBeInstanceOf(DeviceCodeError);
163
- expect((err as DeviceCodeError).code).toBe("request_failed");
164
- }
165
- });
166
- });
167
-
168
- describe("pollForToken", () => {
169
- test("returns tokens on immediate success", async () => {
170
- mockFetch(async () =>
171
- jsonResponse({
172
- access_token: "at-123",
173
- refresh_token: "rt-456",
174
- expires_in: 3600,
175
- token_type: "Bearer",
176
- scope: "openid profile",
177
- }),
178
- );
179
-
180
- const result = await pollForToken(
181
- TEST_CONFIG,
182
- "dev-code-123",
183
- 0.01, // near-zero interval for test speed
184
- 30,
185
- );
186
-
187
- expect(result.accessToken).toBe("at-123");
188
- expect(result.refreshToken).toBe("rt-456");
189
- expect(result.expiresIn).toBe(3600);
190
- expect(result.tokenType).toBe("Bearer");
191
- expect(result.scope).toBe("openid profile");
192
- });
193
-
194
- test("polls through authorization_pending then succeeds", async () => {
195
- let callCount = 0;
196
-
197
- mockFetch(async () => {
198
- callCount++;
199
- if (callCount < 3) {
200
- return jsonResponse({ error: "authorization_pending" }, 403);
201
- }
202
- return jsonResponse({
203
- access_token: "at-after-pending",
204
- refresh_token: "rt-after-pending",
205
- expires_in: 3600,
206
- });
207
- });
208
-
209
- const result = await pollForToken(TEST_CONFIG, "dev-code-123", 0.01, 30);
210
-
211
- expect(result.accessToken).toBe("at-after-pending");
212
- expect(callCount).toBe(3);
213
- });
214
-
215
- test("increases interval on slow_down", async () => {
216
- let callCount = 0;
217
- const sleepDelays: number[] = [];
218
-
219
- const fakeSleep = async (ms: number) => {
220
- sleepDelays.push(ms);
221
- };
222
-
223
- mockFetch(async () => {
224
- callCount++;
225
- if (callCount === 1) {
226
- return jsonResponse({ error: "slow_down" }, 403);
227
- }
228
- return jsonResponse({
229
- access_token: "at-slow",
230
- expires_in: 3600,
231
- });
232
- });
233
-
234
- const result = await pollForToken(
235
- TEST_CONFIG,
236
- "dev-code-123",
237
- 2,
238
- 60,
239
- undefined,
240
- fakeSleep,
241
- );
242
-
243
- expect(result.accessToken).toBe("at-slow");
244
- expect(callCount).toBe(2);
245
- // First sleep: initial interval (2s = 2000ms)
246
- expect(sleepDelays[0]).toBe(2000);
247
- // Second sleep: initial interval + 5s = 7s = 7000ms (per RFC 8628)
248
- expect(sleepDelays[1]).toBe(7000);
249
- });
250
-
251
- test("throws on expired_token", async () => {
252
- mockFetch(async () => jsonResponse({ error: "expired_token" }, 403));
253
-
254
- try {
255
- await pollForToken(TEST_CONFIG, "dev-code-123", 0.01, 30);
256
- expect(true).toBe(false); // should not reach
257
- } catch (err) {
258
- expect(err).toBeInstanceOf(DeviceCodeError);
259
- expect((err as DeviceCodeError).code).toBe("expired_token");
260
- expect((err as DeviceCodeError).message).toContain("expired");
261
- }
262
- });
263
-
264
- test("throws on access_denied", async () => {
265
- mockFetch(async () => jsonResponse({ error: "access_denied" }, 403));
266
-
267
- try {
268
- await pollForToken(TEST_CONFIG, "dev-code-123", 0.01, 30);
269
- expect(true).toBe(false); // should not reach
270
- } catch (err) {
271
- expect(err).toBeInstanceOf(DeviceCodeError);
272
- expect((err as DeviceCodeError).code).toBe("access_denied");
273
- expect((err as DeviceCodeError).message).toContain("denied");
274
- }
275
- });
276
-
277
- test("throws on abort signal", async () => {
278
- const ac = new AbortController();
279
- // Abort immediately
280
- ac.abort();
281
-
282
- try {
283
- await pollForToken(TEST_CONFIG, "dev-code-123", 0.01, 30, ac.signal);
284
- expect(true).toBe(false); // should not reach
285
- } catch (err) {
286
- expect(err).toBeInstanceOf(DeviceCodeError);
287
- expect((err as DeviceCodeError).code).toBe("aborted");
288
- }
289
- });
290
-
291
- test("aborts mid-poll when signal fires", async () => {
292
- const ac = new AbortController();
293
- let callCount = 0;
294
-
295
- mockFetch(async () => {
296
- callCount++;
297
- // Abort after first pending response
298
- if (callCount === 1) {
299
- ac.abort();
300
- }
301
- return jsonResponse({ error: "authorization_pending" }, 403);
302
- });
303
-
304
- try {
305
- await pollForToken(TEST_CONFIG, "dev-code-123", 0.01, 30, ac.signal);
306
- expect(true).toBe(false); // should not reach
307
- } catch (err) {
308
- expect(err).toBeInstanceOf(DeviceCodeError);
309
- expect((err as DeviceCodeError).code).toBe("aborted");
310
- }
311
- });
312
-
313
- test("sends correct grant_type and parameters", async () => {
314
- let capturedBody = "";
315
-
316
- mockFetch(async (_url, init) => {
317
- capturedBody = init?.body?.toString() ?? "";
318
- return jsonResponse({
319
- access_token: "at-123",
320
- expires_in: 3600,
321
- });
322
- });
323
-
324
- await pollForToken(TEST_CONFIG, "dev-code-xyz", 0.01, 30);
325
-
326
- const params = new URLSearchParams(capturedBody);
327
- expect(params.get("grant_type")).toBe(
328
- "urn:ietf:params:oauth:grant-type:device_code",
329
- );
330
- expect(params.get("device_code")).toBe("dev-code-xyz");
331
- expect(params.get("client_id")).toBe("test-client-id");
332
- });
333
-
334
- test("throws on unexpected error code", async () => {
335
- mockFetch(async () => jsonResponse({ error: "server_error" }, 500));
336
-
337
- try {
338
- await pollForToken(TEST_CONFIG, "dev-code-123", 0.01, 30);
339
- expect(true).toBe(false);
340
- } catch (err) {
341
- expect(err).toBeInstanceOf(DeviceCodeError);
342
- expect((err as DeviceCodeError).code).toBe("request_failed");
343
- }
344
- });
345
-
346
- test("retries on network error then succeeds", async () => {
347
- let callCount = 0;
348
-
349
- mockFetch(async () => {
350
- callCount++;
351
- if (callCount === 1) {
352
- throw new Error("Network error");
353
- }
354
- return jsonResponse({
355
- access_token: "at-retry",
356
- expires_in: 3600,
357
- });
358
- });
359
-
360
- const result = await pollForToken(TEST_CONFIG, "dev-code-123", 0.01, 30);
361
-
362
- expect(result.accessToken).toBe("at-retry");
363
- expect(callCount).toBe(2);
364
- });
365
- });
366
-
367
- describe("startDeviceCodeFlow", () => {
368
- test("runs full flow: device code request then token poll", async () => {
369
- let callCount = 0;
370
-
371
- mockFetch(async (url) => {
372
- callCount++;
373
- if (url === TEST_CONFIG.deviceCodeUrl) {
374
- return jsonResponse({
375
- device_code: "full-flow-dc",
376
- user_code: "FULL-1234",
377
- verification_uri: "https://auth.example.com/activate",
378
- expires_in: 900,
379
- interval: 0.01,
380
- });
381
- }
382
- // Token endpoint — succeed on second poll
383
- if (callCount === 2) {
384
- return jsonResponse({ error: "authorization_pending" }, 403);
385
- }
386
- return jsonResponse({
387
- access_token: "at-full-flow",
388
- refresh_token: "rt-full-flow",
389
- expires_in: 3600,
390
- });
391
- });
392
-
393
- const result = await startDeviceCodeFlow(TEST_CONFIG);
394
-
395
- expect(result.init.deviceCode).toBe("full-flow-dc");
396
- expect(result.init.userCode).toBe("FULL-1234");
397
- expect(result.init.verificationUri).toBe(
398
- "https://auth.example.com/activate",
399
- );
400
- expect(result.tokens.accessToken).toBe("at-full-flow");
401
- expect(result.tokens.refreshToken).toBe("rt-full-flow");
402
- });
403
-
404
- test("propagates abort signal to poll", async () => {
405
- const ac = new AbortController();
406
-
407
- mockFetch(async (url) => {
408
- if (url === TEST_CONFIG.deviceCodeUrl) {
409
- return jsonResponse({
410
- device_code: "abort-dc",
411
- user_code: "ABRT-1234",
412
- verification_uri: "https://auth.example.com/activate",
413
- expires_in: 900,
414
- interval: 0.01,
415
- });
416
- }
417
- // Abort before returning token
418
- ac.abort();
419
- return jsonResponse({ error: "authorization_pending" }, 403);
420
- });
421
-
422
- try {
423
- await startDeviceCodeFlow(TEST_CONFIG, ac.signal);
424
- expect(true).toBe(false);
425
- } catch (err) {
426
- expect(err).toBeInstanceOf(DeviceCodeError);
427
- expect((err as DeviceCodeError).code).toBe("aborted");
428
- }
429
- });
430
- });
431
- });