@vellumai/assistant 0.11.4 → 0.11.5-dev.202608220019.a778cf0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (457) hide show
  1. package/AGENTS.md +6 -2
  2. package/ARCHITECTURE.md +29 -4
  3. package/README.md +1 -1
  4. package/docs/architecture/memory.md +17 -5
  5. package/docs/architecture/security.md +96 -152
  6. package/docs/guardian-request-flow.md +13 -2
  7. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/package.json +1 -0
  8. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +118 -0
  9. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/url-normalization.test.ts +135 -0
  10. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
  11. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/ingress.ts +103 -0
  12. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/url-normalization.ts +107 -0
  13. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/package.json +1 -0
  14. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +118 -0
  15. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/url-normalization.test.ts +135 -0
  16. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
  17. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/ingress.ts +103 -0
  18. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/url-normalization.ts +107 -0
  19. package/node_modules/@vellumai/gateway-client/src/gateway-ipc-contracts.ts +166 -1
  20. package/node_modules/@vellumai/gateway-client/src/http-delivery.ts +7 -14
  21. package/node_modules/@vellumai/gateway-client/src/index.ts +2 -0
  22. package/node_modules/@vellumai/gateway-client/src/outbound-contract.ts +30 -32
  23. package/node_modules/@vellumai/service-contracts/package.json +1 -0
  24. package/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +118 -0
  25. package/node_modules/@vellumai/service-contracts/src/__tests__/url-normalization.test.ts +135 -0
  26. package/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
  27. package/node_modules/@vellumai/service-contracts/src/ingress.ts +103 -0
  28. package/node_modules/@vellumai/service-contracts/src/url-normalization.ts +107 -0
  29. package/openapi.yaml +487 -11
  30. package/package.json +1 -1
  31. package/scripts/sync-web-search-catalog.ts +6 -0
  32. package/src/__tests__/anthropic-provider.test.ts +10 -3
  33. package/src/__tests__/approval-interception-trust-gates.test.ts +40 -0
  34. package/src/__tests__/background-workers-disk-pressure.test.ts +1 -1
  35. package/src/__tests__/channel-approval-routes.test.ts +4 -0
  36. package/src/__tests__/channel-inbound-disk-pressure.test.ts +5 -6
  37. package/src/__tests__/channel-readiness-service.test.ts +126 -0
  38. package/src/__tests__/channel-reply-delivery.test.ts +30 -17
  39. package/src/__tests__/checker.test.ts +20 -314
  40. package/src/__tests__/cli-memory-v2-reembed-skills.test.ts +6 -2
  41. package/src/__tests__/client-os-metadata-persistence.test.ts +16 -0
  42. package/src/__tests__/compactor-retained-image-validation.test.ts +142 -0
  43. package/src/__tests__/config-loader-backfill.test.ts +19 -10
  44. package/src/__tests__/container-cpu-sampler.test.ts +153 -0
  45. package/src/__tests__/context-search-memory-v2-source.test.ts +0 -1
  46. package/src/__tests__/conversation-attachments.test.ts +0 -1
  47. package/src/__tests__/conversation-delete-watch-timeline.test.ts +231 -0
  48. package/src/__tests__/conversation-error.test.ts +17 -0
  49. package/src/__tests__/conversation-lifecycle.test.ts +20 -26
  50. package/src/__tests__/conversation-pairing.test.ts +186 -0
  51. package/src/__tests__/conversation-runtime-assembly.test.ts +21 -2
  52. package/src/__tests__/credential-broker-server-use.test.ts +24 -5
  53. package/src/__tests__/credential-routes.test.ts +22 -3
  54. package/src/__tests__/credential-security-invariants.test.ts +2 -1
  55. package/src/__tests__/daemon-credential-client.test.ts +88 -0
  56. package/src/__tests__/default-plugin-names-guard.test.ts +12 -1
  57. package/src/__tests__/dm-backfill.test.ts +63 -0
  58. package/src/__tests__/dynamic-skill-background-guard.test.ts +0 -2
  59. package/src/__tests__/edit-propagation.test.ts +107 -4
  60. package/src/__tests__/events-client-registration.test.ts +28 -0
  61. package/src/__tests__/file-write-tool.test.ts +4 -2
  62. package/src/__tests__/guardian-prompt-notice-privacy.test.ts +133 -0
  63. package/src/__tests__/guardian-verify-setup-skill-regression.test.ts +143 -97
  64. package/src/__tests__/helpers/gateway-classify-mock.ts +27 -6
  65. package/src/__tests__/host-proxy-interface.test.ts +11 -1
  66. package/src/__tests__/host-shell-tool.test.ts +23 -4
  67. package/src/__tests__/image-conversion.test.ts +143 -1
  68. package/src/__tests__/inline-skill-load-permissions.test.ts +47 -36
  69. package/src/__tests__/input-repairs.test.ts +207 -0
  70. package/src/__tests__/live-workspace-guard.test.ts +75 -0
  71. package/src/__tests__/managed-profile-guard.test.ts +4 -2
  72. package/src/__tests__/mcp-abort-signal.test.ts +1 -1
  73. package/src/__tests__/mcp-client-auth.test.ts +1 -1
  74. package/src/__tests__/mcp-tool-annotations-risk.test.ts +1 -1
  75. package/src/__tests__/media-resolve-image-validation.test.ts +310 -0
  76. package/src/__tests__/mtime-cache.test.ts +2 -0
  77. package/src/__tests__/notification-vellum-adapter.test.ts +124 -1
  78. package/src/__tests__/openai-provider.test.ts +40 -0
  79. package/src/__tests__/openai-responses-provider.test.ts +18 -0
  80. package/src/__tests__/personal-memory-auth-bypass.test.ts +22 -6
  81. package/src/__tests__/platform-bash-auto-approve.test.ts +0 -4
  82. package/src/__tests__/platform.test.ts +16 -1
  83. package/src/__tests__/plugin-api-resolve-credential.test.ts +22 -13
  84. package/src/__tests__/plugin-api-shim.test.ts +5 -0
  85. package/src/__tests__/plugin-api-store-credential.test.ts +268 -0
  86. package/src/__tests__/plugin-config-data-migration.test.ts +8 -1
  87. package/src/__tests__/plugin-disabled-state.test.ts +2 -0
  88. package/src/__tests__/plugin-effective-enabled-set.test.ts +55 -3
  89. package/src/__tests__/plugin-execution-context.test.ts +73 -0
  90. package/src/__tests__/plugin-import-boundary-guard.test.ts +0 -1
  91. package/src/__tests__/plugin-import-boundary-reverse-guard.test.ts +0 -1
  92. package/src/__tests__/reaction-persistence.test.ts +200 -7
  93. package/src/__tests__/require-fresh-approval.test.ts +0 -4
  94. package/src/__tests__/resource-pressure-guard.test.ts +428 -0
  95. package/src/__tests__/resource-pressure-routes.test.ts +113 -0
  96. package/src/__tests__/risk-classification-boundary-guard.test.ts +115 -0
  97. package/src/__tests__/run-conversation-turn-persistence.test.ts +27 -1
  98. package/src/__tests__/sanitize-config-for-transfer.test.ts +28 -0
  99. package/src/__tests__/secret-routes-platform-proxy.test.ts +7 -0
  100. package/src/__tests__/settings-routes.test.ts +85 -3
  101. package/src/__tests__/skill-tool-factory.test.ts +161 -0
  102. package/src/__tests__/tool-execution-pipeline.benchmark.test.ts +1 -1
  103. package/src/__tests__/tool-executor-lifecycle-events.test.ts +132 -5
  104. package/src/__tests__/tool-executor.test.ts +63 -38
  105. package/src/__tests__/tool-policy.test.ts +97 -1
  106. package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +7 -4
  107. package/src/__tests__/user-plugin-loader.test.ts +2 -0
  108. package/src/__tests__/validate-input.test.ts +243 -7
  109. package/src/__tests__/verification-control-plane-policy.test.ts +0 -2
  110. package/src/__tests__/voice-scoped-grant-consumer.test.ts +2 -0
  111. package/src/__tests__/voice-session-bridge.test.ts +42 -0
  112. package/src/__tests__/web-search-catalog-parity.test.ts +8 -0
  113. package/src/acp/__tests__/acp-claude-oauth.test.ts +97 -29
  114. package/src/acp/__tests__/prepare-agent-env.test.ts +376 -153
  115. package/src/acp/acp-claude-oauth.ts +38 -21
  116. package/src/acp/prepare-agent-env.ts +146 -55
  117. package/src/agent/loop-tool-dedup.test.ts +161 -0
  118. package/src/agent/loop.ts +68 -22
  119. package/src/api/constants/app-tools.ts +34 -0
  120. package/src/api/constants/profile-config-validation.ts +60 -0
  121. package/src/api/events/resource-pressure-status-changed.ts +53 -0
  122. package/src/api/events/tool-result.ts +6 -1
  123. package/src/api/events/watch-retro-completed.ts +52 -0
  124. package/src/api/index.ts +30 -0
  125. package/src/api/responses/resource-pressure-status.ts +25 -0
  126. package/src/approvals/guardian-channel-delivery.ts +70 -6
  127. package/src/approvals/guardian-request-resolvers.ts +32 -66
  128. package/src/calls/__tests__/voice-session-bridge.test.ts +114 -0
  129. package/src/calls/voice-session-bridge.ts +60 -6
  130. package/src/channels/__tests__/message-audience.test.ts +49 -0
  131. package/src/channels/__tests__/types.test.ts +17 -3
  132. package/src/channels/message-audience.ts +40 -0
  133. package/src/channels/types.ts +16 -12
  134. package/src/cli/__tests__/catalog-search-help.test.ts +50 -0
  135. package/src/cli/commands/__tests__/channel-verification-sessions.test.ts +31 -0
  136. package/src/cli/commands/__tests__/conversations-search.test.ts +289 -0
  137. package/src/cli/commands/__tests__/conversations-slack.test.ts +2 -1
  138. package/src/cli/commands/__tests__/inference-profiles.test.ts +16 -4
  139. package/src/cli/commands/__tests__/inference-providers.test.ts +135 -2
  140. package/src/cli/commands/__tests__/keys.test.ts +89 -8
  141. package/src/cli/commands/__tests__/plugins.test.ts +57 -1
  142. package/src/cli/commands/channel-verification-sessions.help.ts +11 -9
  143. package/src/cli/commands/channel-verification-sessions.ts +11 -21
  144. package/src/cli/commands/conversations.help.ts +34 -0
  145. package/src/cli/commands/conversations.ts +125 -0
  146. package/src/cli/commands/inference-profiles.ts +56 -3
  147. package/src/cli/commands/inference-providers.ts +37 -6
  148. package/src/cli/commands/inference.help.ts +9 -4
  149. package/src/cli/commands/keys.help.ts +13 -1
  150. package/src/cli/commands/keys.ts +26 -15
  151. package/src/cli/commands/memory/__tests__/memory-v2.test.ts +57 -7
  152. package/src/cli/commands/memory/index.help.ts +41 -27
  153. package/src/cli/commands/memory/index.ts +2 -0
  154. package/src/cli/commands/memory/memory-v2.ts +58 -54
  155. package/src/cli/commands/memory/memory-validate.ts +18 -0
  156. package/src/cli/commands/monitoring.ts +1 -0
  157. package/src/cli/commands/oauth/request.test.ts +93 -0
  158. package/src/cli/commands/oauth/request.ts +23 -9
  159. package/src/cli/commands/plugins.help.ts +28 -31
  160. package/src/cli/commands/plugins.ts +10 -0
  161. package/src/cli/commands/skills.help.ts +13 -16
  162. package/src/cli/commands/trust.ts +3 -14
  163. package/src/cli/lib/__tests__/install-from-github.test.ts +38 -0
  164. package/src/cli/lib/__tests__/merge-plugin-tree.test.ts +34 -0
  165. package/src/cli/lib/__tests__/plugin-surfaces.test.ts +32 -1
  166. package/src/cli/lib/__tests__/toggle-plugin.test.ts +2 -1
  167. package/src/cli/lib/__tests__/upgrade-plugin.test.ts +64 -0
  168. package/src/cli/lib/bundled-marketplace.json +26 -0
  169. package/src/cli/lib/daemon-credential-client.ts +25 -3
  170. package/src/cli/lib/install-from-github.ts +35 -24
  171. package/src/cli/lib/merge-plugin-tree.ts +22 -4
  172. package/src/cli/lib/open-browser.test.ts +67 -0
  173. package/src/cli/lib/open-browser.ts +24 -5
  174. package/src/cli/lib/plugin-surfaces.ts +27 -0
  175. package/src/config/__tests__/balanced-model-experiment.test.ts +7 -7
  176. package/src/config/__tests__/default-profile-catalog.test.ts +3 -3
  177. package/src/config/__tests__/profile-materialization.test.ts +26 -0
  178. package/src/config/default-profile-catalog.ts +5 -6
  179. package/src/config/feature-flag-registry.json +36 -28
  180. package/src/config/profile-materialization.ts +29 -0
  181. package/src/config/sanitize-for-transfer.ts +16 -0
  182. package/src/config/schemas/llm.ts +7 -0
  183. package/src/config/schemas/services.ts +6 -0
  184. package/src/config/webhook-routing.ts +8 -0
  185. package/src/context/compactor.ts +31 -2
  186. package/src/context/outbound-sanitize.ts +6 -0
  187. package/src/daemon/__tests__/lifecycle-watch-timeline-sweep.test.ts +98 -0
  188. package/src/daemon/__tests__/provider-rejection-log-fields.test.ts +272 -0
  189. package/src/daemon/conversation-agent-loop-handlers.ts +4 -1
  190. package/src/daemon/conversation-error.ts +19 -2
  191. package/src/daemon/conversation-messaging.ts +22 -2
  192. package/src/daemon/conversation-process.ts +11 -0
  193. package/src/daemon/conversation-store.ts +10 -0
  194. package/src/daemon/conversation-surfaces.ts +21 -8
  195. package/src/daemon/conversation.ts +12 -10
  196. package/src/daemon/daemon-control.ts +1 -0
  197. package/src/daemon/handlers/__tests__/config-ingress-tunnel-records.test.ts +208 -0
  198. package/src/daemon/handlers/config-ingress.ts +115 -5
  199. package/src/daemon/lifecycle.ts +30 -2
  200. package/src/daemon/message-types/conversations.ts +5 -7
  201. package/src/daemon/message-types/web-activity.ts +3 -2
  202. package/src/daemon/provider-rejection-log-fields.ts +124 -0
  203. package/src/daemon/resource-pressure-guard-lifecycle.ts +66 -0
  204. package/src/daemon/resource-pressure-guard.ts +387 -0
  205. package/src/daemon/shutdown-handlers.ts +2 -0
  206. package/src/daemon/startup-error.ts +16 -0
  207. package/src/daemon/trust-context.ts +14 -10
  208. package/src/daemon/unsendable-image-notice.ts +76 -0
  209. package/src/hooks/registry.ts +65 -51
  210. package/src/inbound/__tests__/tunnel-probe.test.ts +448 -0
  211. package/src/inbound/tunnel-probe.ts +261 -0
  212. package/src/ipc/__tests__/socket-path.test.ts +15 -7
  213. package/src/ipc/gateway-client.test.ts +1 -1
  214. package/src/ipc/gateway-client.ts +14 -21
  215. package/src/ipc/socket-cleanup.ts +2 -11
  216. package/src/mcp/__tests__/mcp-auth-orchestrator.test.ts +1 -1
  217. package/src/messaging/provider-message-metadata.ts +128 -0
  218. package/src/messaging/providers/__tests__/transport-dispatch.test.ts +138 -73
  219. package/src/messaging/providers/channel-transport.ts +100 -16
  220. package/src/messaging/providers/discord/send.ts +16 -0
  221. package/src/messaging/providers/discord/transport.ts +23 -1
  222. package/src/messaging/providers/index.ts +84 -16
  223. package/src/messaging/providers/slack/message-metadata.ts +45 -0
  224. package/src/messaging/providers/slack/render-transcript.ts +1 -4
  225. package/src/messaging/providers/slack/send.test.ts +88 -34
  226. package/src/messaging/providers/slack/send.ts +99 -50
  227. package/src/messaging/providers/slack/transport.ts +35 -37
  228. package/src/messaging/providers/telegram-bot/send.test.ts +88 -18
  229. package/src/messaging/providers/telegram-bot/send.ts +36 -0
  230. package/src/messaging/providers/telegram-bot/transport.ts +22 -8
  231. package/src/messaging/read-provider-metadata.test.ts +157 -0
  232. package/src/messaging/read-provider-metadata.ts +51 -0
  233. package/src/notifications/__tests__/assistant-reply-producer.test.ts +94 -0
  234. package/src/notifications/__tests__/edit-notification.test.ts +174 -2
  235. package/src/notifications/__tests__/home-feed-side-effect.test.ts +536 -4
  236. package/src/notifications/adapters/macos.ts +55 -0
  237. package/src/notifications/adapters/slack.ts +10 -5
  238. package/src/notifications/assistant-reply-producer.ts +37 -4
  239. package/src/notifications/conversation-pairing.ts +111 -21
  240. package/src/notifications/edit-notification.ts +38 -8
  241. package/src/notifications/emit-signal.ts +12 -14
  242. package/src/notifications/home-feed-side-effect.ts +218 -15
  243. package/src/notifications/types.ts +5 -0
  244. package/src/permissions/AGENTS.md +16 -0
  245. package/src/permissions/checker.test.ts +75 -122
  246. package/src/permissions/checker.ts +44 -560
  247. package/src/permissions/confirmation-guardian-request.test.ts +28 -3
  248. package/src/permissions/confirmation-guardian-request.ts +5 -1
  249. package/src/persistence/conversation-crud.ts +69 -20
  250. package/src/persistence/conversation-queries.ts +14 -1
  251. package/src/persistence/conversation-types.ts +22 -0
  252. package/src/persistence/db-async-query.ts +2 -1
  253. package/src/persistence/db-maintenance.ts +15 -0
  254. package/src/persistence/delivery-crud.ts +122 -15
  255. package/src/persistence/embeddings/qdrant-manager.ts +1 -0
  256. package/src/persistence/migrations/367-create-watch-timeline-entries.ts +46 -0
  257. package/src/persistence/migrations/368-watch-timeline-screenshot-blob.ts +33 -0
  258. package/src/persistence/migrations/__tests__/367-create-watch-timeline-entries.test.ts +98 -0
  259. package/src/persistence/migrations/__tests__/368-watch-timeline-screenshot-blob.test.ts +98 -0
  260. package/src/persistence/schema/index.ts +1 -0
  261. package/src/persistence/schema/watch.ts +29 -0
  262. package/src/persistence/steps.ts +4 -0
  263. package/src/plugin-api/__tests__/import-graph-partial-mock.test.ts +67 -0
  264. package/src/plugin-api/conversation-turn.ts +27 -0
  265. package/src/plugin-api/credential-scope.test.ts +15 -0
  266. package/src/plugin-api/credential-scope.ts +14 -0
  267. package/src/plugin-api/index.ts +19 -1
  268. package/src/plugin-api/resolve-credential.ts +15 -10
  269. package/src/plugin-api/store-credential.ts +148 -0
  270. package/src/plugin-api/system-card.ts +36 -0
  271. package/src/plugin-api/vision-support.test.ts +82 -0
  272. package/src/plugin-api/vision-support.ts +14 -2
  273. package/src/plugins/defaults/image-fallback/__tests__/image-fallback.test.ts +361 -110
  274. package/src/plugins/defaults/image-fallback/__tests__/vision-recovery.test.ts +4 -0
  275. package/src/plugins/defaults/image-fallback/hooks/user-prompt-submit.ts +58 -0
  276. package/src/plugins/defaults/image-fallback/src/caption-blocks.ts +64 -23
  277. package/src/plugins/defaults/image-recovery/detect.ts +24 -1
  278. package/src/plugins/defaults/main.ts +15 -0
  279. package/src/plugins/defaults/memory/AGENTS.md +11 -3
  280. package/src/plugins/defaults/memory/__tests__/memory-tier-boundary-guard.test.ts +0 -1
  281. package/src/plugins/defaults/memory/graph-topology/pending-buffer.ts +9 -12
  282. package/src/plugins/defaults/memory/memory-retrospective-prompt.ts +1 -1
  283. package/src/plugins/defaults/memory/src/memory-v2-routes.ts +12 -10
  284. package/src/plugins/defaults/memory/substrate/__tests__/consolidation-job.test.ts +114 -0
  285. package/src/plugins/defaults/memory/substrate/__tests__/consolidation-prompt-flag-gating-guard.test.ts +8 -0
  286. package/src/plugins/defaults/memory/substrate/__tests__/edge-index.test.ts +0 -30
  287. package/src/plugins/defaults/memory/substrate/__tests__/ingest.test.ts +73 -1
  288. package/src/plugins/defaults/memory/substrate/__tests__/page-index.test.ts +37 -0
  289. package/src/plugins/defaults/memory/substrate/__tests__/page-links.test.ts +208 -0
  290. package/src/plugins/defaults/memory/substrate/__tests__/prompts-consolidation.test.ts +158 -1
  291. package/src/plugins/defaults/memory/substrate/__tests__/static-context.test.ts +1 -61
  292. package/src/plugins/defaults/memory/substrate/consolidation-job.ts +68 -6
  293. package/src/plugins/defaults/memory/substrate/edge-index.ts +0 -31
  294. package/src/plugins/defaults/memory/substrate/ingest.ts +59 -0
  295. package/src/plugins/defaults/memory/substrate/page-index.ts +35 -8
  296. package/src/plugins/defaults/memory/substrate/page-links.ts +133 -0
  297. package/src/plugins/defaults/memory/substrate/page-store.ts +10 -0
  298. package/src/plugins/defaults/memory/substrate/prompts/consolidation.ts +124 -34
  299. package/src/plugins/defaults/memory/substrate/static-context.ts +0 -29
  300. package/src/plugins/defaults/memory/v3/__tests__/shadow-plugin.test.ts +3 -1
  301. package/src/plugins/defaults/memory/v3/card.ts +9 -9
  302. package/src/plugins/defaults/memory/v3/core-set.test.ts +7 -0
  303. package/src/plugins/defaults/memory/v3/core-set.ts +5 -1
  304. package/src/plugins/defaults/memory/v3/edge.ts +13 -57
  305. package/src/plugins/mtime-cache.ts +1 -1
  306. package/src/plugins/pipeline.ts +14 -7
  307. package/src/plugins/plugin-execution-context.ts +35 -11
  308. package/src/plugins/plugin-tree-walk.ts +63 -4
  309. package/src/providers/__tests__/retry-network-error.test.ts +84 -0
  310. package/src/providers/anthropic/__tests__/pause-turn-continuation.test.ts +170 -0
  311. package/src/providers/anthropic/client.ts +332 -241
  312. package/src/providers/connection-resolution.ts +25 -2
  313. package/src/providers/content-blocks.ts +22 -0
  314. package/src/providers/fetch-provider-catalog.ts +19 -0
  315. package/src/providers/gemini/client.ts +5 -2
  316. package/src/providers/inference/__tests__/adapter-factory-litellm.test.ts +47 -1
  317. package/src/providers/inference/__tests__/adapter-factory-ollama.test.ts +83 -0
  318. package/src/providers/inference/__tests__/adapter-factory-openai-compatible.test.ts +98 -1
  319. package/src/providers/inference/__tests__/base-url-route-validation.test.ts +38 -0
  320. package/src/providers/inference/__tests__/base-url-security.test.ts +10 -0
  321. package/src/providers/inference/__tests__/connections-ollama.test.ts +90 -0
  322. package/src/providers/inference/__tests__/endpoint-probe.test.ts +92 -0
  323. package/src/providers/inference/__tests__/missing-credential-guard.test.ts +117 -0
  324. package/src/providers/inference/__tests__/profile-config-validation.test.ts +39 -0
  325. package/src/providers/inference/__tests__/profile-probe-classify.test.ts +66 -0
  326. package/src/providers/inference/adapter-factory.ts +33 -2
  327. package/src/providers/inference/auth.ts +13 -2
  328. package/src/providers/inference/credential-usage.ts +37 -0
  329. package/src/providers/inference/endpoint-probe.ts +115 -0
  330. package/src/providers/inference/missing-credential-guard.ts +110 -0
  331. package/src/providers/inference/profile-probe.ts +256 -0
  332. package/src/providers/inference/resolve-auth.ts +7 -7
  333. package/src/providers/media-resolve.ts +176 -15
  334. package/src/providers/model-catalog.ts +10 -0
  335. package/src/providers/openai/__tests__/api-error-normalization.test.ts +17 -1
  336. package/src/providers/openai/__tests__/chat-completions-provider-reasoning.test.ts +576 -46
  337. package/src/providers/openai/__tests__/connection-error-wrap.test.ts +44 -0
  338. package/src/providers/openai/__tests__/tool-choice-mapping.test.ts +125 -2
  339. package/src/providers/openai/api-error-normalization.ts +16 -2
  340. package/src/providers/openai/chat-completions-provider.ts +326 -44
  341. package/src/providers/openai/responses-provider.ts +5 -2
  342. package/src/providers/provider-send-message.ts +11 -0
  343. package/src/providers/retry.ts +6 -0
  344. package/src/providers/search-provider-catalog.ts +20 -0
  345. package/src/routes/route-host-protocol.ts +7 -0
  346. package/src/routes/worker.ts +31 -10
  347. package/src/runtime/AGENTS.md +36 -0
  348. package/src/runtime/__tests__/host-observe.test.ts +302 -0
  349. package/src/runtime/__tests__/runtime-http-port-collision.test.ts +131 -0
  350. package/src/runtime/__tests__/web-presence.test.ts +234 -0
  351. package/src/runtime/assistant-event-hub.ts +38 -0
  352. package/src/runtime/channel-readiness-service.ts +39 -13
  353. package/src/runtime/channel-readiness-types.ts +49 -2
  354. package/src/runtime/channel-reply-delivery.ts +55 -32
  355. package/src/runtime/channel-retry-sweep.ts +6 -4
  356. package/src/runtime/effective-capabilities.test.ts +19 -0
  357. package/src/runtime/effective-capabilities.ts +25 -0
  358. package/src/runtime/guardian-reply-router.ts +6 -2
  359. package/src/runtime/host-observe.ts +246 -0
  360. package/src/runtime/http-errors.ts +1 -0
  361. package/src/runtime/http-server.ts +185 -6
  362. package/src/runtime/routes/__tests__/client-routes.test.ts +150 -0
  363. package/src/runtime/routes/__tests__/conversation-list-routes.test.ts +133 -0
  364. package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +80 -0
  365. package/src/runtime/routes/__tests__/credential-delete-in-use.test.ts +155 -0
  366. package/src/runtime/routes/__tests__/inference-profiles-routes.test.ts +118 -0
  367. package/src/runtime/routes/__tests__/inference-provider-connection-routes.test.ts +72 -1
  368. package/src/runtime/routes/__tests__/ingress-status-routes.test.ts +508 -0
  369. package/src/runtime/routes/__tests__/monitoring-routes.test.ts +1 -0
  370. package/src/runtime/routes/__tests__/pending-interactions-route.test.ts +175 -0
  371. package/src/runtime/routes/__tests__/plugins-routes.test.ts +103 -71
  372. package/src/runtime/routes/__tests__/surface-action-routes.test.ts +55 -6
  373. package/src/runtime/routes/__tests__/system-card-turn-termination.test.ts +107 -0
  374. package/src/runtime/routes/__tests__/user-route-dispatcher-host.test.ts +52 -1
  375. package/src/runtime/routes/__tests__/user-route-dispatcher.test.ts +75 -4
  376. package/src/runtime/routes/__tests__/watch-routes-guardian-cache.test.ts +139 -0
  377. package/src/runtime/routes/__tests__/watch-routes.test.ts +598 -0
  378. package/src/runtime/routes/approval-routes.ts +37 -4
  379. package/src/runtime/routes/approval-strategies/guardian-text-engine-strategy.ts +16 -22
  380. package/src/runtime/routes/canned-message-complete.ts +68 -29
  381. package/src/runtime/routes/channel-readiness-routes.ts +14 -2
  382. package/src/runtime/routes/client-routes.ts +113 -0
  383. package/src/runtime/routes/conversation-list-routes.ts +22 -7
  384. package/src/runtime/routes/conversation-management-routes.ts +15 -9
  385. package/src/runtime/routes/conversation-query-routes.ts +10 -0
  386. package/src/runtime/routes/conversation-routes.ts +36 -22
  387. package/src/runtime/routes/credential-in-use.ts +85 -0
  388. package/src/runtime/routes/credential-routes.ts +55 -85
  389. package/src/runtime/routes/guardian-approval-interception.ts +44 -53
  390. package/src/runtime/routes/guardian-approval-reply-helpers.ts +14 -12
  391. package/src/runtime/routes/host-cu-routes.ts +18 -0
  392. package/src/runtime/routes/identity-routes.ts +5 -121
  393. package/src/runtime/routes/inbound-message-handler.ts +74 -30
  394. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +16 -17
  395. package/src/runtime/routes/inbound-stages/background-dispatch.test.ts +182 -297
  396. package/src/runtime/routes/inbound-stages/background-dispatch.ts +173 -386
  397. package/src/runtime/routes/inbound-stages/edit-intercept.ts +101 -77
  398. package/src/runtime/routes/inbound-stages/guardian-reply-intercept.ts +17 -8
  399. package/src/runtime/routes/inbound-stages/reaction-intercept.test.ts +91 -7
  400. package/src/runtime/routes/inbound-stages/reaction-intercept.ts +72 -70
  401. package/src/runtime/routes/index.ts +4 -0
  402. package/src/runtime/routes/inference-profiles-routes.ts +232 -31
  403. package/src/runtime/routes/inference-provider-connection-routes.ts +33 -11
  404. package/src/runtime/routes/ingress-status-routes.ts +180 -0
  405. package/src/runtime/routes/monitoring-routes.ts +9 -1
  406. package/src/runtime/routes/oauth-commands-routes.ts +1 -1
  407. package/src/runtime/routes/plugins-routes.ts +28 -32
  408. package/src/runtime/routes/resource-pressure-routes.ts +22 -0
  409. package/src/runtime/routes/secret-routes.ts +39 -8
  410. package/src/runtime/routes/settings-routes.ts +15 -12
  411. package/src/runtime/routes/surface-action-routes.ts +20 -19
  412. package/src/runtime/routes/user-route-dispatcher.ts +31 -2
  413. package/src/runtime/routes/user-route-resolution.ts +18 -1
  414. package/src/runtime/routes/watch-routes.ts +807 -0
  415. package/src/runtime/slack-reply-session.test.ts +23 -13
  416. package/src/runtime/slack-reply-session.ts +38 -55
  417. package/src/runtime/web-presence.ts +90 -0
  418. package/src/security/__tests__/untrusted-content.test.ts +42 -0
  419. package/src/security/untrusted-content.ts +28 -9
  420. package/src/skills/validate-input.ts +177 -40
  421. package/src/subagent/__tests__/consult-context-gating.test.ts +6 -10
  422. package/src/subagent/consult-context.ts +7 -23
  423. package/src/tools/credentials/broker.ts +24 -79
  424. package/src/tools/credentials/ref-parse.ts +35 -0
  425. package/src/tools/credentials/resolve.ts +4 -10
  426. package/src/tools/credentials/store.ts +168 -0
  427. package/src/tools/credentials/tool-policy.ts +67 -0
  428. package/src/tools/executor.ts +53 -15
  429. package/src/tools/network/__tests__/firecrawl-compat.test.ts +77 -0
  430. package/src/tools/network/__tests__/web-fetch-fastcrw.test.ts +169 -0
  431. package/src/tools/network/__tests__/web-search.test.ts +138 -3
  432. package/src/tools/network/firecrawl-compat.ts +90 -0
  433. package/src/tools/network/url-safety.ts +9 -16
  434. package/src/tools/network/web-fetch.ts +142 -62
  435. package/src/tools/network/web-search.ts +162 -58
  436. package/src/tools/permission-checker.ts +43 -52
  437. package/src/tools/schema-transforms.ts +40 -5
  438. package/src/tools/shared/input-repairs.ts +160 -0
  439. package/src/tools/skills/skill-tool-factory.ts +18 -4
  440. package/src/tools/subagent/spawn.ts +0 -1
  441. package/src/tools/tool-approval-handler.ts +16 -10
  442. package/src/tools/tool-types.ts +26 -13
  443. package/src/tools/types.ts +6 -6
  444. package/src/util/__tests__/cgroup-memory.test.ts +3 -0
  445. package/src/util/cgroup-memory.ts +3 -0
  446. package/src/util/container-cpu-sampler.ts +250 -0
  447. package/src/util/image-conversion.ts +178 -14
  448. package/src/util/platform.ts +93 -10
  449. package/src/util/worker-process.ts +1 -0
  450. package/src/watch/__tests__/watch-retro.test.ts +665 -0
  451. package/src/watch/__tests__/watch-session-manager.test.ts +566 -0
  452. package/src/watch/__tests__/watch-timeline.test.ts +670 -0
  453. package/src/watch/watch-retro.ts +480 -0
  454. package/src/watch/watch-session-manager.ts +575 -0
  455. package/src/watch/watch-timeline.ts +848 -0
  456. package/src/permissions/ipc-risk-types.ts +0 -143
  457. package/src/permissions/risk-types.ts +0 -76
@@ -0,0 +1,107 @@
1
+ /**
2
+ * Tests which system cards terminate a turn.
3
+ *
4
+ * Clients treat `message_complete` as terminal: it clears the processing state
5
+ * and closes the turn. A card that is itself the reply (a slash-command
6
+ * result) must emit it; a card a plugin posts while a turn is still running
7
+ * must not, or the client ends a turn that is still streaming.
8
+ */
9
+
10
+ import { beforeEach, describe, expect, mock, test } from "bun:test";
11
+
12
+ import { setConfig } from "../../../__tests__/helpers/set-config.js";
13
+ import type { AssistantEvent } from "../../../api/index.js";
14
+
15
+ // Keep the memory system off so addMessage skips indexing side effects.
16
+ setConfig("memory", { enabled: false });
17
+
18
+ // Capture what reaches connected clients, keeping the rest of the hub's
19
+ // surface intact for the module graph's other importers.
20
+ const eventHub = await import("../../assistant-event-hub.js");
21
+ const broadcastEvents: AssistantEvent[] = [];
22
+
23
+ /** The terminal turn events among everything broadcast so far. */
24
+ function completions(): AssistantEvent[] {
25
+ return broadcastEvents.filter((e) => e.type === "message_complete");
26
+ }
27
+
28
+ mock.module("../../assistant-event-hub.js", () => ({
29
+ ...eventHub,
30
+ broadcastMessage: (event: AssistantEvent) => {
31
+ broadcastEvents.push(event);
32
+ },
33
+ }));
34
+
35
+ const { createConversation } =
36
+ await import("../../../persistence/conversation-crud.js");
37
+ const { initializeDb } = await import("../../../persistence/db-init.js");
38
+ const { persistSystemCard } = await import("../canned-message-complete.js");
39
+
40
+ await initializeDb();
41
+
42
+ describe("persistSystemCard turn termination", () => {
43
+ beforeEach(() => {
44
+ broadcastEvents.length = 0;
45
+ });
46
+
47
+ test("announces a card that is the reply as a completed turn", async () => {
48
+ /**
49
+ * Tests that a card standing in for the assistant's reply closes the turn
50
+ * so the client stops showing it as processing.
51
+ */
52
+
53
+ // GIVEN a conversation
54
+ const conv = createConversation();
55
+
56
+ // WHEN a card that ends the turn is persisted
57
+ const card = await persistSystemCard({
58
+ conversationId: conv.id,
59
+ text: "Compacted 12 messages.",
60
+ metadata: {},
61
+ endsTurn: true,
62
+ });
63
+
64
+ // THEN clients are told the turn completed, pointing at the card row
65
+ expect(completions()).toEqual([
66
+ {
67
+ type: "message_complete",
68
+ conversationId: conv.id,
69
+ messageId: card.id,
70
+ },
71
+ ]);
72
+ });
73
+
74
+ test("leaves an in-flight turn running when a card is posted mid-turn", async () => {
75
+ /**
76
+ * Tests that a card written while the model is still working does not end
77
+ * the turn in the client, which would clear processing state and let a
78
+ * second message start while the first turn is still streaming.
79
+ */
80
+
81
+ // GIVEN a conversation
82
+ const conv = createConversation();
83
+
84
+ // WHEN a non-terminal card is persisted
85
+ const card = await persistSystemCard({
86
+ conversationId: conv.id,
87
+ text: "The image you attached was not sent to the model.",
88
+ metadata: { plugin: "image-fallback" },
89
+ endsTurn: false,
90
+ });
91
+
92
+ // THEN the card is persisted
93
+ expect(card.id).toBeTruthy();
94
+
95
+ // AND no terminal turn event reaches clients
96
+ expect(completions()).toEqual([]);
97
+
98
+ // AND clients are still told to refetch the transcript so the card shows
99
+ expect(
100
+ broadcastEvents.some(
101
+ (e) =>
102
+ e.type === "sync_changed" &&
103
+ e.tags.includes(`conversation:${conv.id}:messages`),
104
+ ),
105
+ ).toBe(true);
106
+ });
107
+ });
@@ -3,7 +3,10 @@ import { join } from "node:path";
3
3
  import { afterEach, beforeEach, describe, expect, mock, test } from "bun:test";
4
4
 
5
5
  import type { RouteInvokeParams } from "../../../routes/route-host-protocol.js";
6
- import { getWorkspaceRoutesDir } from "../../../util/platform.js";
6
+ import {
7
+ getWorkspacePluginsDir,
8
+ getWorkspaceRoutesDir,
9
+ } from "../../../util/platform.js";
7
10
 
8
11
  // The dispatcher constructs the route host client inline and reads the enabled
9
12
  // flag from config, so both are mocked here (there is no injection seam).
@@ -58,6 +61,16 @@ function writeHandler(name: string, content: string): void {
58
61
  writeFileSync(join(getWorkspaceRoutesDir(), name), content);
59
62
  }
60
63
 
64
+ function writePluginHandler(
65
+ pluginName: string,
66
+ name: string,
67
+ content: string,
68
+ ): void {
69
+ const dir = join(getWorkspacePluginsDir(), pluginName, "routes");
70
+ mkdirSync(dir, { recursive: true });
71
+ writeFileSync(join(dir, name), content);
72
+ }
73
+
61
74
  function jsonResponse(status: number, value: unknown): RouteInvokeResponse {
62
75
  return {
63
76
  status,
@@ -75,6 +88,7 @@ beforeEach(() => {
75
88
 
76
89
  afterEach(() => {
77
90
  rmSync(getWorkspaceRoutesDir(), { recursive: true, force: true });
91
+ rmSync(getWorkspacePluginsDir(), { recursive: true, force: true });
78
92
  });
79
93
 
80
94
  describe("UserRouteDispatcher — route host delegation", () => {
@@ -101,6 +115,43 @@ describe("UserRouteDispatcher — route host delegation", () => {
101
115
  expect(invokeCalls[0].params.url).toContain("/v1/x/foo");
102
116
  });
103
117
 
118
+ test("names the owning plugin so the host executes in its context", async () => {
119
+ // The host marks this plugin as in context for the handler, so
120
+ // plugin-scoped host APIs behave the same in the host and in-thread.
121
+ writePluginHandler(
122
+ "my-plugin",
123
+ "status.ts",
124
+ `export function GET() { return new Response(); }`,
125
+ );
126
+ hostEnabled = true;
127
+ const dispatcher = makeDispatcher();
128
+
129
+ await dispatcher.dispatch(
130
+ "plugins/my-plugin/status",
131
+ new Request("http://localhost/v1/x/plugins/my-plugin/status", {
132
+ method: "GET",
133
+ }),
134
+ );
135
+
136
+ expect(invokeCalls[0].params.pluginName).toBe("my-plugin");
137
+ });
138
+
139
+ test("leaves a workspace route unowned", async () => {
140
+ writeHandler(
141
+ "plain.ts",
142
+ `export function GET() { return new Response(); }`,
143
+ );
144
+ hostEnabled = true;
145
+ const dispatcher = makeDispatcher();
146
+
147
+ await dispatcher.dispatch(
148
+ "plain",
149
+ new Request("http://localhost/v1/x/plain", { method: "GET" }),
150
+ );
151
+
152
+ expect(invokeCalls[0].params.pluginName).toBeUndefined();
153
+ });
154
+
104
155
  test("runs in-band when disabled (host never called)", async () => {
105
156
  writeHandler(
106
157
  "bar.ts",
@@ -56,6 +56,15 @@ function writePluginHandler(
56
56
  return fullPath;
57
57
  }
58
58
 
59
+ /**
60
+ * Absolute specifier for the plugin execution context, so a handler written to
61
+ * a temp routes directory imports the same module instance this process holds.
62
+ */
63
+ const PLUGIN_CONTEXT_MODULE = new URL(
64
+ "../../../plugins/plugin-execution-context.ts",
65
+ import.meta.url,
66
+ ).href;
67
+
59
68
  async function readErrorBody(
60
69
  response: Response,
61
70
  ): Promise<{ error: { code: string; message: string } }> {
@@ -466,6 +475,71 @@ describe("plugin routes", () => {
466
475
  expect(body.plugin).toBe(true);
467
476
  });
468
477
 
478
+ test("executes the handler as the plugin that owns the namespace", async () => {
479
+ // Plugin-scoped host APIs (resolveCredential, indexDocument) read the
480
+ // execution context to decide what the caller may touch. A route handler
481
+ // that ran outside it would fall through to their unscoped branch and
482
+ // reach every plugin's credentials.
483
+ writePluginHandler(
484
+ "my-plugin",
485
+ "whoami.ts",
486
+ `import { getCurrentPluginName } from ${JSON.stringify(PLUGIN_CONTEXT_MODULE)};
487
+ export function GET(request) {
488
+ return Response.json({ plugin: getCurrentPluginName() ?? null });
489
+ }`,
490
+ );
491
+
492
+ const dispatcher = makeDispatcher();
493
+ const res = await dispatcher.dispatch(
494
+ "plugins/my-plugin/whoami",
495
+ makeRequest("GET"),
496
+ );
497
+ expect(res.status).toBe(200);
498
+ const body = await res.json();
499
+ expect(body.plugin).toBe("my-plugin");
500
+ });
501
+
502
+ test("evaluates the route module in the plugin's context too", async () => {
503
+ // A module can reach a scoped host API at import time, and the import
504
+ // happens once per mtime. A load left outside the context would take the
505
+ // unscoped branch and never be re-run scoped, so the context has to cover
506
+ // module evaluation and not just the handler call.
507
+ writePluginHandler(
508
+ "my-plugin",
509
+ "at-import.ts",
510
+ `import { getCurrentPluginName } from ${JSON.stringify(PLUGIN_CONTEXT_MODULE)};
511
+ const atImport = getCurrentPluginName() ?? null;
512
+ export function GET(request) {
513
+ return Response.json({ atImport });
514
+ }`,
515
+ );
516
+
517
+ const dispatcher = makeDispatcher();
518
+ const res = await dispatcher.dispatch(
519
+ "plugins/my-plugin/at-import",
520
+ makeRequest("GET"),
521
+ );
522
+ expect(res.status).toBe(200);
523
+ const body = await res.json();
524
+ expect(body.atImport).toBe("my-plugin");
525
+ });
526
+
527
+ test("leaves a workspace route outside any plugin context", async () => {
528
+ writeHandler(
529
+ "whoami.ts",
530
+ `import { getCurrentPluginName } from ${JSON.stringify(PLUGIN_CONTEXT_MODULE)};
531
+ export function GET(request) {
532
+ return Response.json({ plugin: getCurrentPluginName() ?? null });
533
+ }`,
534
+ );
535
+
536
+ const dispatcher = makeDispatcher();
537
+ const res = await dispatcher.dispatch("whoami", makeRequest("GET"));
538
+ expect(res.status).toBe(200);
539
+ const body = await res.json();
540
+ expect(body.plugin).toBeNull();
541
+ });
542
+
469
543
  test("resolves nested paths and the index (namespace root)", async () => {
470
544
  writePluginHandler(
471
545
  "my-plugin",
@@ -583,10 +657,7 @@ describe("plugin routes", () => {
583
657
  const plugin = "stale-helper";
584
658
  const helperPath = join(getWorkspacePluginsDir(), plugin, "src", "http.ts");
585
659
  mkdirSync(dirname(helperPath), { recursive: true });
586
- writeFileSync(
587
- helperPath,
588
- `export function label() { return "v1"; }\n`,
589
- );
660
+ writeFileSync(helperPath, `export function label() { return "v1"; }\n`);
590
661
  writePluginHandler(
591
662
  plugin,
592
663
  "frame.ts",
@@ -0,0 +1,139 @@
1
+ /**
2
+ * A watch session's principal lookup against a stale guardian-delivery cache.
3
+ *
4
+ * The cache keeps a successful read that found no binding, and a gateway-side
5
+ * binding write does not invalidate it, so the read a session start depends on
6
+ * has to force a refresh or a first run fails for the cache's whole TTL. The
7
+ * guardian reader is mocked here rather than in the main watch-routes suite so
8
+ * the substitution stays inside this file.
9
+ */
10
+ import { afterAll, beforeEach, describe, expect, mock, test } from "bun:test";
11
+
12
+ import type { GuardianDelivery } from "@vellumai/gateway-client";
13
+
14
+ let cachedResult: GuardianDelivery[] | null = null;
15
+ let freshResult: GuardianDelivery[] | null = null;
16
+ let cachedCalls = 0;
17
+ let freshCalls = 0;
18
+
19
+ // Only the two read entry points are substituted; the rest of the reader's
20
+ // surface stays real, because other modules in this graph import from it.
21
+ const realReader =
22
+ await import("../../../contacts/guardian-delivery-reader.js");
23
+ mock.module("../../../contacts/guardian-delivery-reader.js", () => ({
24
+ ...realReader,
25
+ getGuardianDelivery: () => {
26
+ cachedCalls++;
27
+ return Promise.resolve(cachedResult);
28
+ },
29
+ getGuardianDeliveryFresh: () => {
30
+ freshCalls++;
31
+ return Promise.resolve(freshResult);
32
+ },
33
+ peekCachedGuardianDelivery: () => undefined,
34
+ }));
35
+
36
+ const { initializeDb } = await import("../../../persistence/db-init.js");
37
+ const { WatchSessionManager } =
38
+ await import("../../../watch/watch-session-manager.js");
39
+ const { WatchStreamSession, resolveWatchActorPrincipalId } =
40
+ await import("../watch-routes.js");
41
+
42
+ await initializeDb();
43
+
44
+ afterAll(() => {
45
+ mock.restore();
46
+ });
47
+
48
+ /** The shape `guardianForChannel` matches on for the vellum binding. */
49
+ function guardian(principalId: string): GuardianDelivery {
50
+ return {
51
+ principalId,
52
+ channelType: "vellum",
53
+ status: "active",
54
+ } as unknown as GuardianDelivery;
55
+ }
56
+
57
+ /** A socket that keeps the frame types the session sent it. */
58
+ function newSocket() {
59
+ const types: string[] = [];
60
+ return {
61
+ types,
62
+ send: (data: string) => {
63
+ types.push((JSON.parse(data) as { type: string }).type);
64
+ },
65
+ close: () => {},
66
+ };
67
+ }
68
+
69
+ /** A transcriber that opens without reaching any provider. */
70
+ function newTranscriber() {
71
+ return {
72
+ providerId: "deepgram" as const,
73
+ boundaryId: "daemon-streaming" as const,
74
+ start: async () => {},
75
+ sendAudio: () => {},
76
+ stop: () => {},
77
+ };
78
+ }
79
+
80
+ describe("watch principal lookup against a stale guardian cache", () => {
81
+ beforeEach(() => {
82
+ cachedCalls = 0;
83
+ freshCalls = 0;
84
+ cachedResult = [];
85
+ freshResult = [];
86
+ });
87
+
88
+ test("reads past an empty cached answer to the binding that now exists", async () => {
89
+ cachedResult = [];
90
+ freshResult = [guardian("guardian-just-bound")];
91
+
92
+ expect(await resolveWatchActorPrincipalId()).toBe("guardian-just-bound");
93
+ expect(freshCalls).toBe(1);
94
+ expect(cachedCalls).toBe(0);
95
+ });
96
+
97
+ test("a session started after the binding appears reaches ready", async () => {
98
+ // The cache still holds the empty answer from before the guardian was
99
+ // bound, which is the state a first run starts in.
100
+ cachedResult = [];
101
+ freshResult = [guardian("guardian-just-bound")];
102
+
103
+ const manager = new WatchSessionManager({
104
+ observe: async () => ({ ok: true, axTree: "Window: Editor" }),
105
+ });
106
+ const ws = newSocket();
107
+ const session = new WatchStreamSession(ws, {
108
+ mimeType: "audio/webm",
109
+ manager,
110
+ resolveTranscriber: async () => newTranscriber(),
111
+ });
112
+
113
+ await session.start();
114
+
115
+ // The handshake rather than the exact sequence: the session reads the
116
+ // screen as it opens, so its capture acknowledgement lands in here too.
117
+ expect(ws.types[0]).toBe("ready");
118
+ expect(ws.types).not.toContain("error");
119
+ expect(manager.isActive()).toBe(true);
120
+
121
+ session.destroy();
122
+ });
123
+
124
+ test("no binding at all still fails closed", async () => {
125
+ cachedResult = [];
126
+ freshResult = [];
127
+
128
+ const ws = newSocket();
129
+ const session = new WatchStreamSession(ws, {
130
+ mimeType: "audio/webm",
131
+ manager: new WatchSessionManager(),
132
+ resolveTranscriber: async () => newTranscriber(),
133
+ });
134
+
135
+ await session.start();
136
+
137
+ expect(ws.types).toEqual(["error", "closed"]);
138
+ });
139
+ });