@vellumai/assistant 0.10.2 → 0.10.3-dev.202606252046.9075fd5

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 (546) hide show
  1. package/bun.lock +20 -0
  2. package/docs/workspace-tools.md +42 -33
  3. package/eslint-rules/cli-no-daemon-internals.js +6 -0
  4. package/node_modules/@vellumai/gateway-client/src/__tests__/guardian-delivery-contract.test.ts +91 -0
  5. package/node_modules/@vellumai/gateway-client/src/__tests__/trust-verdict-contract.test.ts +31 -0
  6. package/node_modules/@vellumai/gateway-client/src/gateway-ipc-contracts.ts +44 -0
  7. package/node_modules/@vellumai/gateway-client/src/guardian-delivery-contract.ts +48 -0
  8. package/node_modules/@vellumai/gateway-client/src/index.ts +14 -0
  9. package/node_modules/@vellumai/gateway-client/src/trust-verdict-contract.ts +17 -0
  10. package/node_modules/@vellumai/service-contracts/package.json +1 -0
  11. package/node_modules/@vellumai/service-contracts/src/__tests__/channels.test.ts +28 -0
  12. package/node_modules/@vellumai/service-contracts/src/channels.ts +41 -0
  13. package/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
  14. package/openapi.yaml +196 -56
  15. package/package.json +4 -1
  16. package/scripts/test.sh +36 -15
  17. package/src/__tests__/actor-token-service.test.ts +36 -14
  18. package/src/__tests__/actor-trust-resolver-address-fallback.test.ts +83 -31
  19. package/src/__tests__/agent-loop-override-profile.test.ts +1 -0
  20. package/src/__tests__/agent-wake-disk-pressure-callsite.test.ts +2 -0
  21. package/src/__tests__/agent-wake-override-profile.test.ts +2 -0
  22. package/src/__tests__/annotate-activity-metadata.test.ts +2 -0
  23. package/src/__tests__/annotate-risk-options.test.ts +2 -0
  24. package/src/__tests__/approval-cascade.test.ts +2 -0
  25. package/src/__tests__/assistant-attachments.test.ts +42 -0
  26. package/src/__tests__/background-workers-disk-pressure.test.ts +2 -0
  27. package/src/__tests__/btw-routes.test.ts +2 -0
  28. package/src/__tests__/build-persisted-content.test.ts +2 -0
  29. package/src/__tests__/call-controller.test.ts +19 -0
  30. package/src/__tests__/channel-approval-routes.test.ts +21 -26
  31. package/src/__tests__/channel-delivery-store.test.ts +28 -0
  32. package/src/__tests__/channel-guardian.test.ts +164 -78
  33. package/src/__tests__/channel-inbound-disk-pressure.test.ts +11 -19
  34. package/src/__tests__/channel-reply-delivery.test.ts +2 -0
  35. package/src/__tests__/code-search-tool.test.ts +585 -0
  36. package/src/__tests__/compaction-events.test.ts +2 -0
  37. package/src/__tests__/compaction-ledger-store.test.ts +128 -0
  38. package/src/__tests__/compaction.benchmark.test.ts +2 -0
  39. package/src/__tests__/compactor-call-site-logging.test.ts +2 -0
  40. package/src/__tests__/compactor-low-watermark-cut.test.ts +2 -0
  41. package/src/__tests__/compactor-preserved-tail-count.test.ts +2 -0
  42. package/src/__tests__/compactor-summary-call-truncation.test.ts +2 -0
  43. package/src/__tests__/compactor-web-search-strip.test.ts +2 -0
  44. package/src/__tests__/config-loader-backfill.test.ts +123 -10
  45. package/src/__tests__/config-schema.test.ts +1 -0
  46. package/src/__tests__/confirmation-request-guardian-bridge.test.ts +31 -29
  47. package/src/__tests__/consult-deadline.test.ts +60 -0
  48. package/src/__tests__/contact-store-interaction-info.test.ts +156 -0
  49. package/src/__tests__/contact-store-user-file.test.ts +7 -10
  50. package/src/__tests__/contacts-relay-reads.test.ts +19 -24
  51. package/src/__tests__/contacts-write.test.ts +0 -2
  52. package/src/__tests__/conversation-abort-tool-results.test.ts +2 -0
  53. package/src/__tests__/conversation-agent-loop-disk-pressure.test.ts +2 -0
  54. package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +2 -0
  55. package/src/__tests__/conversation-agent-loop-overflow.test.ts +2 -0
  56. package/src/__tests__/conversation-agent-loop.test.ts +134 -0
  57. package/src/__tests__/conversation-analysis-routes.test.ts +2 -0
  58. package/src/__tests__/conversation-app-control-lifecycle.test.ts +2 -0
  59. package/src/__tests__/conversation-attention-telegram.test.ts +9 -11
  60. package/src/__tests__/conversation-confirmation-signals.test.ts +2 -0
  61. package/src/__tests__/conversation-fork-crud.test.ts +354 -24
  62. package/src/__tests__/conversation-history-web-search.test.ts +2 -0
  63. package/src/__tests__/conversation-load-history-repair.test.ts +2 -0
  64. package/src/__tests__/conversation-load-history-stripped.test.ts +2 -0
  65. package/src/__tests__/conversation-pairing.test.ts +2 -0
  66. package/src/__tests__/conversation-process-app-control-preactivation.test.ts +2 -0
  67. package/src/__tests__/conversation-process-callsite.test.ts +2 -0
  68. package/src/__tests__/conversation-provider-retry-repair.test.ts +2 -0
  69. package/src/__tests__/conversation-queue.test.ts +91 -0
  70. package/src/__tests__/conversation-routes-guardian-reply.test.ts +14 -0
  71. package/src/__tests__/conversation-routes-slash-commands.test.ts +14 -0
  72. package/src/__tests__/conversation-slash-queue.test.ts +2 -0
  73. package/src/__tests__/conversation-slash-unknown.test.ts +2 -0
  74. package/src/__tests__/conversation-speed-override.test.ts +2 -0
  75. package/src/__tests__/conversation-surfaces-task-progress.test.ts +29 -0
  76. package/src/__tests__/conversation-title-service.test.ts +2 -0
  77. package/src/__tests__/conversation-tool-setup-attribution.test.ts +47 -0
  78. package/src/__tests__/conversation-usage.test.ts +2 -0
  79. package/src/__tests__/conversation-workspace-cache-state.test.ts +2 -0
  80. package/src/__tests__/conversation-workspace-injection.test.ts +2 -0
  81. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +2 -0
  82. package/src/__tests__/credential-security-invariants.test.ts +1 -1
  83. package/src/__tests__/db-compaction-events-migration.test.ts +129 -0
  84. package/src/__tests__/db-migration-rollback.test.ts +205 -171
  85. package/src/__tests__/db-test-helpers.ts +5 -4
  86. package/src/__tests__/delete-propagation.test.ts +5 -3
  87. package/src/__tests__/deterministic-verification-control-plane.test.ts +4 -2
  88. package/src/__tests__/disk-pressure-guard.test.ts +41 -0
  89. package/src/__tests__/dm-backfill.test.ts +6 -4
  90. package/src/__tests__/dm-persistence.test.ts +2 -0
  91. package/src/__tests__/emit-signal-routing-intent.test.ts +7 -6
  92. package/src/__tests__/events-dev-bypass-actor.test.ts +7 -1
  93. package/src/__tests__/exploration-drift-hook.test.ts +3 -2
  94. package/src/__tests__/filing-service.test.ts +2 -0
  95. package/src/__tests__/guardian-binding-drift-heal.test.ts +104 -19
  96. package/src/__tests__/guardian-dispatch.test.ts +140 -1
  97. package/src/__tests__/guardian-expiry-notifier.test.ts +282 -0
  98. package/src/__tests__/guardian-outbound-http.test.ts +13 -0
  99. package/src/__tests__/guardian-routing-state.test.ts +6 -10
  100. package/src/__tests__/heartbeat-disk-pressure.test.ts +2 -0
  101. package/src/__tests__/heartbeat-service.test.ts +2 -0
  102. package/src/__tests__/helpers/channel-test-adapter.ts +46 -19
  103. package/src/__tests__/helpers/create-guardian-binding.ts +15 -23
  104. package/src/__tests__/helpers/mock-logger.ts +1 -0
  105. package/src/__tests__/helpers/seed-contact-channel.ts +96 -0
  106. package/src/__tests__/host-app-control-routes.test.ts +24 -30
  107. package/src/__tests__/host-bash-routes.test.ts +31 -41
  108. package/src/__tests__/host-browser-routes.test.ts +26 -32
  109. package/src/__tests__/host-cu-routes-targeted.test.ts +25 -33
  110. package/src/__tests__/host-file-routes-targeted.test.ts +40 -52
  111. package/src/__tests__/host-transfer-routes-targeted.test.ts +31 -43
  112. package/src/__tests__/http-user-message-parity.test.ts +290 -8
  113. package/src/__tests__/inbound-invite-redemption.test.ts +115 -10
  114. package/src/__tests__/inbound-slack-persistence.test.ts +2 -0
  115. package/src/__tests__/invite-redemption-service.test.ts +471 -53
  116. package/src/__tests__/invite-routes-http.test.ts +34 -0
  117. package/src/__tests__/invite-service-ipc.test.ts +65 -2
  118. package/src/__tests__/llm-context-normalization.test.ts +105 -0
  119. package/src/__tests__/llm-request-log-error-payload.test.ts +71 -9
  120. package/src/__tests__/llm-usage-store.test.ts +25 -0
  121. package/src/__tests__/mcp-config-secret-boundary.test.ts +392 -0
  122. package/src/__tests__/mcp-health-check.test.ts +2 -1
  123. package/src/__tests__/media-stream-server-integration.test.ts +127 -0
  124. package/src/__tests__/memory-retrieval-hook.test.ts +2 -0
  125. package/src/__tests__/messaging-send-tool.test.ts +2 -0
  126. package/src/__tests__/migration-import-from-url.test.ts +2 -2
  127. package/src/__tests__/mtime-cache.test.ts +275 -5
  128. package/src/__tests__/native-web-search.test.ts +2 -0
  129. package/src/__tests__/non-member-access-request.test.ts +191 -17
  130. package/src/__tests__/notification-broadcaster.test.ts +4 -0
  131. package/src/__tests__/notification-decision-recipient-context.test.ts +33 -32
  132. package/src/__tests__/notification-deep-link.test.ts +6 -0
  133. package/src/__tests__/notification-guardian-path.test.ts +19 -0
  134. package/src/__tests__/onboarding-persona-write.test.ts +52 -22
  135. package/src/__tests__/openai-provider.test.ts +22 -12
  136. package/src/__tests__/openai-responses-provider.test.ts +12 -2
  137. package/src/__tests__/outbound-slack-persistence.test.ts +2 -0
  138. package/src/__tests__/pending-interactions-resolved-event.test.ts +7 -4
  139. package/src/__tests__/persist-onboarding-artifacts.test.ts +1 -0
  140. package/src/__tests__/persistence-secret-redaction.test.ts +2 -0
  141. package/src/__tests__/persona-resolver.test.ts +75 -45
  142. package/src/__tests__/plugin-bootstrap.test.ts +21 -83
  143. package/src/__tests__/plugin-disabled-state.test.ts +190 -0
  144. package/src/__tests__/plugin-pipeline.test.ts +96 -0
  145. package/src/__tests__/plugin-route-contribution.test.ts +6 -19
  146. package/src/__tests__/plugin-tool-contribution.test.ts +5 -20
  147. package/src/__tests__/plugin-types.test.ts +2 -4
  148. package/src/__tests__/process-message-background-slack.test.ts +2 -0
  149. package/src/__tests__/process-message-display-content.test.ts +2 -0
  150. package/src/__tests__/provider-error-scenarios.test.ts +5 -4
  151. package/src/__tests__/provider-usage-tracking.test.ts +39 -0
  152. package/src/__tests__/reaction-intercept-cold-cache-warm.test.ts +135 -0
  153. package/src/__tests__/reaction-intercept-member-verdict-warm.test.ts +158 -0
  154. package/src/__tests__/reaction-persistence.test.ts +51 -4
  155. package/src/__tests__/regenerate-fire-and-forget-trace.test.ts +2 -0
  156. package/src/__tests__/registry.test.ts +4 -1
  157. package/src/__tests__/relay-server.test.ts +758 -32
  158. package/src/__tests__/runtime-attachment-metadata.test.ts +9 -12
  159. package/src/__tests__/secret-ingress-http.test.ts +14 -0
  160. package/src/__tests__/send-endpoint-busy.test.ts +30 -8
  161. package/src/__tests__/settings-routes.test.ts +32 -0
  162. package/src/__tests__/skills.test.ts +44 -0
  163. package/src/__tests__/slack-inbound-verification.test.ts +47 -2
  164. package/src/__tests__/sse-actor-principal-guardian-source.test.ts +79 -0
  165. package/src/__tests__/steer-on-enqueue-question.test.ts +181 -0
  166. package/src/__tests__/stt-hints.test.ts +49 -15
  167. package/src/__tests__/subagent-detail.test.ts +27 -0
  168. package/src/__tests__/subagent-disposal.test.ts +65 -0
  169. package/src/__tests__/subagent-fork-prompt-role.test.ts +195 -0
  170. package/src/__tests__/subagent-fork-spawn.test.ts +6 -7
  171. package/src/__tests__/subagent-notify-parent.test.ts +2 -0
  172. package/src/__tests__/subagent-role-registry.test.ts +24 -6
  173. package/src/__tests__/subagent-spawn-and-await.test.ts +546 -0
  174. package/src/__tests__/subagent-spawn-tool-fork.test.ts +2 -0
  175. package/src/__tests__/subagent-tools.test.ts +398 -1
  176. package/src/__tests__/suggestion-routes.test.ts +2 -0
  177. package/src/__tests__/thread-backfill.test.ts +3 -3
  178. package/src/__tests__/title-generate-hook.test.ts +2 -0
  179. package/src/__tests__/tool-executor-lifecycle-events.test.ts +2 -0
  180. package/src/__tests__/tool-executor.test.ts +16 -11
  181. package/src/__tests__/tool-preview-lifecycle.test.ts +2 -0
  182. package/src/__tests__/tool-result-metadata-plumbing.test.ts +2 -0
  183. package/src/__tests__/tool-start-timestamp.test.ts +2 -0
  184. package/src/__tests__/trusted-contact-approval-notifier.test.ts +37 -51
  185. package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +12 -12
  186. package/src/__tests__/trusted-contact-lifecycle-notifications.test.ts +9 -7
  187. package/src/__tests__/trusted-contact-multichannel.test.ts +16 -7
  188. package/src/__tests__/trusted-contact-verification.test.ts +79 -54
  189. package/src/__tests__/twilio-routes.test.ts +96 -0
  190. package/src/__tests__/ui-file-upload-surface.test.ts +86 -0
  191. package/src/__tests__/verification-control-plane-policy.test.ts +2 -0
  192. package/src/__tests__/voice-guardian-cold-cache-warm.test.ts +137 -0
  193. package/src/__tests__/voice-invite-redemption.test.ts +216 -20
  194. package/src/__tests__/web-search-backend-failure.test.ts +2 -0
  195. package/src/__tests__/workspace-migration-102-preserve-heartbeat-enabled-for-existing-workspaces.test.ts +3 -3
  196. package/src/__tests__/workspace-migration-111-prune-seeded-callsite-defaults.test.ts +208 -0
  197. package/src/__tests__/workspace-migration-112-remove-advisor-callsite-override.test.ts +170 -0
  198. package/src/__tests__/workspace-migration-drop-user-md.test.ts +196 -238
  199. package/src/__tests__/workspace-migration-remove-hooks.test.ts +14 -35
  200. package/src/__tests__/workspace-tool-loader.test.ts +195 -2
  201. package/src/a2a/__tests__/e2e-a2a-channel.test.ts +35 -47
  202. package/src/agent/loop-exclusive-tool.test.ts +154 -0
  203. package/src/agent/loop-native-web-search.test.ts +200 -0
  204. package/src/agent/loop.ts +164 -1
  205. package/src/api/constants/sse-replay.ts +41 -0
  206. package/src/api/events/conversation-notice.ts +26 -0
  207. package/src/api/index.ts +19 -1
  208. package/src/api/responses/llm-request-log-entry.ts +29 -0
  209. package/src/api/responses/subagent-detail.ts +17 -0
  210. package/src/api/surfaces.ts +39 -3
  211. package/src/approvals/guardian-channel-delivery.ts +30 -0
  212. package/src/approvals/guardian-expiry-notifier.ts +148 -0
  213. package/src/approvals/guardian-request-resolvers.ts +17 -15
  214. package/src/calls/__tests__/relay-setup-router.test.ts +267 -17
  215. package/src/calls/call-domain.ts +3 -3
  216. package/src/calls/guardian-dispatch.ts +14 -9
  217. package/src/calls/inbound-trust-reader.ts +24 -2
  218. package/src/calls/media-stream-server.ts +21 -0
  219. package/src/calls/relay-access-wait.ts +6 -6
  220. package/src/calls/relay-server.ts +188 -51
  221. package/src/calls/relay-setup-router.ts +47 -17
  222. package/src/calls/relay-verification.ts +4 -4
  223. package/src/calls/stt-hints.ts +9 -12
  224. package/src/calls/twilio-routes.ts +14 -4
  225. package/src/channels/types.ts +10 -20
  226. package/src/cli/commands/__tests__/cache.test.ts +8 -1
  227. package/src/cli/commands/__tests__/conversations-slack.test.ts +1 -0
  228. package/src/cli/commands/cache.ts +194 -181
  229. package/src/cli/commands/contacts.ts +10 -7
  230. package/src/cli/commands/db/__tests__/repair.test.ts +6 -5
  231. package/src/cli/commands/db/status.ts +37 -1
  232. package/src/cli/commands/mcp.ts +252 -218
  233. package/src/cli/commands/memory/__tests__/worker.test.ts +432 -0
  234. package/src/cli/commands/memory/index.ts +2 -0
  235. package/src/cli/commands/memory/worker.ts +242 -0
  236. package/src/cli/commands/plugins.ts +125 -13
  237. package/src/cli/lib/__tests__/install-from-github.test.ts +102 -0
  238. package/src/cli/lib/__tests__/list-installed-plugins.test.ts +160 -1
  239. package/src/cli/lib/__tests__/publish-plugin.test.ts +404 -0
  240. package/src/cli/lib/list-installed-plugins.ts +179 -1
  241. package/src/cli/lib/publish-plugin.ts +633 -0
  242. package/src/config/__tests__/loader-callsite-strip-fallback.test.ts +143 -0
  243. package/src/config/__tests__/sync-gated-profiles.test.ts +16 -10
  244. package/src/config/bundled-skills/contacts/tools/contact-merge.ts +27 -17
  245. package/src/config/bundled-skills/contacts/tools/contact-search.ts +13 -3
  246. package/src/config/bundled-skills/subagent/SKILL.md +17 -2
  247. package/src/config/bundled-skills/subagent/TOOLS.json +5 -4
  248. package/src/config/call-site-defaults.ts +0 -6
  249. package/src/config/feature-flag-registry.json +5 -13
  250. package/src/config/llm-resolver.ts +0 -3
  251. package/src/config/loader.ts +38 -5
  252. package/src/config/prune-seeded-callsite-defaults.ts +110 -0
  253. package/src/config/schemas/__tests__/memory-v3.test.ts +1 -0
  254. package/src/config/schemas/call-site-catalog.ts +0 -7
  255. package/src/config/schemas/heartbeat.ts +2 -5
  256. package/src/config/schemas/llm.ts +3 -12
  257. package/src/config/schemas/memory-lifecycle.ts +12 -0
  258. package/src/config/schemas/memory-v3.ts +7 -0
  259. package/src/config/schemas/memory.ts +4 -0
  260. package/src/config/schemas/timeouts.ts +8 -0
  261. package/src/config/seed-inference-profiles.ts +30 -34
  262. package/src/config/skills.ts +27 -5
  263. package/src/config/sync-gated-profiles.ts +12 -16
  264. package/src/contacts/__tests__/contacts-write-revoke-relay.test.ts +128 -0
  265. package/src/contacts/__tests__/guardian-delivery-reader.test.ts +312 -0
  266. package/src/contacts/__tests__/member-write-relay.test.ts +226 -0
  267. package/src/contacts/contact-store.ts +27 -237
  268. package/src/contacts/contacts-write.ts +18 -55
  269. package/src/contacts/gateway-channel-read.ts +51 -0
  270. package/src/contacts/guardian-delivery-reader.ts +223 -0
  271. package/src/contacts/member-write-relay.ts +183 -0
  272. package/src/contacts/types.ts +3 -15
  273. package/src/daemon/__tests__/conversation-tool-setup-exclude.test.ts +35 -0
  274. package/src/daemon/__tests__/conversation-tool-setup.test.ts +0 -44
  275. package/src/daemon/assistant-attachments.ts +27 -4
  276. package/src/daemon/conversation-agent-loop.ts +28 -0
  277. package/src/daemon/conversation-notices.ts +60 -0
  278. package/src/daemon/conversation-process.ts +35 -16
  279. package/src/daemon/conversation-surfaces.ts +111 -38
  280. package/src/daemon/conversation-tool-setup.ts +71 -30
  281. package/src/daemon/conversation.ts +23 -1
  282. package/src/daemon/disk-pressure-guard.ts +12 -2
  283. package/src/daemon/event-loop-watchdog.ts +28 -1
  284. package/src/daemon/external-plugins-bootstrap.ts +17 -41
  285. package/src/daemon/handlers/__tests__/config-a2a-accept.test.ts +0 -1
  286. package/src/daemon/handlers/__tests__/config-a2a-complete.test.ts +0 -2
  287. package/src/daemon/handlers/__tests__/config-a2a-redeem.test.ts +25 -2
  288. package/src/daemon/handlers/__tests__/config-channels.test.ts +220 -0
  289. package/src/daemon/handlers/config-a2a.ts +6 -14
  290. package/src/daemon/handlers/config-channels.ts +67 -26
  291. package/src/daemon/handlers/conversations.ts +77 -0
  292. package/src/daemon/lifecycle.ts +16 -0
  293. package/src/daemon/mcp-reload-service.ts +10 -0
  294. package/src/daemon/memory-v2-startup.test.ts +72 -0
  295. package/src/daemon/memory-v2-startup.ts +87 -19
  296. package/src/daemon/message-types/conversations.ts +2 -0
  297. package/src/daemon/message-types/surfaces.ts +12 -12
  298. package/src/daemon/server.ts +0 -4
  299. package/src/daemon/shutdown-handlers.ts +20 -0
  300. package/src/daemon/tool-setup-types.ts +9 -0
  301. package/src/heartbeat/heartbeat-service.ts +5 -0
  302. package/src/home/relationship-state-writer.ts +5 -0
  303. package/src/hooks/hook-loader.ts +341 -0
  304. package/src/ipc/__tests__/clients-list-ipc.test.ts +1 -1
  305. package/src/ipc/assistant-server.ts +2 -2
  306. package/src/mcp/__tests__/mcp-auth-orchestrator.test.ts +1 -0
  307. package/src/mcp/client.ts +15 -1
  308. package/src/mcp/mcp-auth-orchestrator.ts +6 -1
  309. package/src/mcp/mcp-header-store.ts +134 -0
  310. package/src/mcp/mcp-oauth-provider.ts +19 -8
  311. package/src/memory/__tests__/301-create-watchdog-events.test.ts +110 -0
  312. package/src/memory/__tests__/memory-retrospective-job.test.ts +8 -0
  313. package/src/memory/__tests__/prompt-override.test.ts +192 -0
  314. package/src/memory/__tests__/watchdog-events-store.test.ts +161 -0
  315. package/src/memory/compaction-ledger-store.ts +107 -0
  316. package/src/memory/conversation-crud.ts +129 -61
  317. package/src/memory/db-connection.ts +22 -3
  318. package/src/memory/db-init.ts +37 -503
  319. package/src/memory/db-singleton.ts +6 -4
  320. package/src/memory/jobs-worker.ts +104 -0
  321. package/src/memory/llm-request-log-store.ts +26 -1
  322. package/src/memory/llm-usage-store.ts +48 -20
  323. package/src/memory/memory-retrospective-job.ts +14 -8
  324. package/src/memory/migrations/209-strip-thinking-from-consolidated.ts +152 -56
  325. package/src/memory/migrations/300-add-processing-started-at.ts +30 -0
  326. package/src/memory/migrations/301-create-watchdog-events.ts +45 -0
  327. package/src/memory/migrations/302-create-compaction-events.ts +107 -0
  328. package/src/memory/migrations/__tests__/209-strip-thinking-from-consolidated.test.ts +297 -0
  329. package/src/memory/migrations/__tests__/run-migrations.test.ts +2 -2
  330. package/src/memory/migrations/run-migrations.ts +106 -10
  331. package/src/memory/migrations/validate-migration-state.ts +105 -67
  332. package/src/memory/prompt-override.ts +129 -0
  333. package/src/memory/schema/contacts.ts +6 -2
  334. package/src/memory/schema/conversations.ts +37 -0
  335. package/src/memory/schema/infrastructure.ts +20 -0
  336. package/src/memory/steps.ts +1294 -0
  337. package/src/memory/v2/__tests__/cli-command-store.test.ts +25 -0
  338. package/src/memory/v2/__tests__/skill-store.test.ts +80 -0
  339. package/src/memory/v2/cli-command-store.ts +75 -38
  340. package/src/memory/v2/prompts/consolidation.ts +13 -82
  341. package/src/memory/v2/prompts/router.ts +21 -93
  342. package/src/memory/v2/skill-store.ts +68 -31
  343. package/src/memory/watchdog-events-store.ts +87 -0
  344. package/src/memory/worker-control.ts +204 -0
  345. package/src/memory/worker-process.ts +89 -0
  346. package/src/messaging/channel-binding-metadata.ts +31 -0
  347. package/src/messaging/provider-types.ts +8 -0
  348. package/src/messaging/providers/slack/binding-metadata.ts +60 -0
  349. package/src/notifications/__tests__/broadcaster.test.ts +8 -8
  350. package/src/notifications/__tests__/connected-channels.test.ts +86 -0
  351. package/src/notifications/__tests__/decision-engine.test.ts +78 -9
  352. package/src/notifications/__tests__/destination-resolver.test.ts +151 -0
  353. package/src/notifications/broadcaster.ts +8 -1
  354. package/src/notifications/decision-engine.ts +15 -7
  355. package/src/notifications/destination-resolver.ts +53 -25
  356. package/src/notifications/emit-signal.ts +34 -15
  357. package/src/onboarding/checkin-event.test.ts +222 -0
  358. package/src/onboarding/checkin-event.ts +321 -0
  359. package/src/onboarding/schedule-checkin.ts +190 -0
  360. package/src/permissions/question-prompter.test.ts +1 -1
  361. package/src/permissions/question-prompter.ts +7 -4
  362. package/src/plugin-api/index.ts +12 -12
  363. package/src/plugin-api/types.ts +12 -14
  364. package/src/plugin-api/vision-support.test.ts +28 -4
  365. package/src/plugin-api/vision-support.ts +66 -31
  366. package/src/plugins/defaults/empty-response/hooks/post-model-call.ts +2 -2
  367. package/src/plugins/defaults/empty-response/hooks/stop.ts +2 -2
  368. package/src/plugins/defaults/exploration-drift/hooks/post-tool-use.ts +4 -3
  369. package/src/plugins/defaults/history-repair/hooks/post-model-call.ts +2 -2
  370. package/src/plugins/defaults/history-repair/hooks/stop.ts +2 -2
  371. package/src/plugins/defaults/history-repair/hooks/user-prompt-submit.ts +2 -2
  372. package/src/plugins/defaults/image-fallback/__tests__/image-fallback.test.ts +47 -7
  373. package/src/plugins/defaults/image-fallback/hooks/post-tool-use.ts +12 -13
  374. package/src/plugins/defaults/image-fallback/hooks/user-prompt-submit.ts +14 -22
  375. package/src/plugins/defaults/image-fallback/src/caption-blocks.ts +42 -11
  376. package/src/plugins/defaults/image-recovery/hooks/post-model-call.ts +2 -2
  377. package/src/plugins/defaults/image-recovery/hooks/stop.ts +2 -2
  378. package/src/plugins/defaults/index.ts +0 -35
  379. package/src/plugins/defaults/max-tokens-continue/hooks/post-model-call.ts +2 -2
  380. package/src/plugins/defaults/max-tokens-continue/hooks/stop.ts +2 -2
  381. package/src/plugins/defaults/memory-retrieval/hooks/post-compact.ts +2 -2
  382. package/src/plugins/defaults/memory-retrieval/hooks/user-prompt-submit.ts +2 -2
  383. package/src/plugins/defaults/memory-v3-shadow/__tests__/injection.test.ts +33 -3
  384. package/src/plugins/defaults/memory-v3-shadow/__tests__/pool-select.test.ts +48 -4
  385. package/src/plugins/defaults/memory-v3-shadow/__tests__/shadow-plugin.test.ts +4 -8
  386. package/src/plugins/defaults/memory-v3-shadow/hooks/post-compact.ts +2 -2
  387. package/src/plugins/defaults/memory-v3-shadow/hooks/user-prompt-submit.ts +2 -2
  388. package/src/plugins/defaults/memory-v3-shadow/injector.ts +43 -15
  389. package/src/plugins/defaults/memory-v3-shadow/orchestrate.ts +11 -2
  390. package/src/plugins/defaults/memory-v3-shadow/pool-select.test.ts +146 -0
  391. package/src/plugins/defaults/memory-v3-shadow/pool-select.ts +77 -13
  392. package/src/plugins/defaults/memory-v3-shadow/shadow-plugin.ts +12 -11
  393. package/src/plugins/defaults/surface-completion-nudge/hooks/post-model-call.ts +2 -2
  394. package/src/plugins/defaults/surface-completion-nudge/hooks/stop.ts +2 -2
  395. package/src/plugins/defaults/task-progress-nudge/hooks/post-tool-use.ts +2 -2
  396. package/src/plugins/defaults/title-generate/hooks/stop.ts +2 -2
  397. package/src/plugins/defaults/title-generate/hooks/user-prompt-submit.ts +2 -2
  398. package/src/plugins/defaults/tool-error/hooks/post-tool-use.ts +2 -2
  399. package/src/plugins/defaults/tool-result-truncate/hooks/post-tool-use.ts +2 -2
  400. package/src/plugins/disabled-state.ts +31 -0
  401. package/src/plugins/external-plugin-loader.ts +2 -2
  402. package/src/plugins/mtime-cache.ts +186 -330
  403. package/src/plugins/pipeline.ts +111 -13
  404. package/src/plugins/registry.ts +59 -16
  405. package/src/plugins/surface-import.ts +121 -0
  406. package/src/plugins/types.ts +7 -9
  407. package/src/prompts/persona-resolver.ts +43 -11
  408. package/src/providers/anthropic/client.ts +5 -0
  409. package/src/providers/call-site-routing.ts +45 -0
  410. package/src/providers/model-catalog.ts +16 -0
  411. package/src/providers/openai/__tests__/api-error-normalization.test.ts +321 -0
  412. package/src/providers/openai/api-error-normalization.ts +270 -0
  413. package/src/providers/openai/chat-completions-provider.ts +37 -83
  414. package/src/providers/openai/responses-provider.ts +50 -46
  415. package/src/providers/openrouter/client.ts +5 -0
  416. package/src/providers/provider-send-message.ts +10 -0
  417. package/src/providers/ratelimit.ts +10 -0
  418. package/src/providers/registry.ts +1 -1
  419. package/src/providers/retry.ts +10 -0
  420. package/src/providers/types.ts +22 -0
  421. package/src/providers/usage-tracking.ts +10 -0
  422. package/src/runtime/__tests__/channel-verification-service.test.ts +133 -0
  423. package/src/runtime/__tests__/guardian-vellum-migration.test.ts +184 -0
  424. package/src/runtime/__tests__/is-guardian-bound-for-channel.test.ts +66 -0
  425. package/src/runtime/__tests__/local-principal-trust.test.ts +162 -0
  426. package/src/runtime/__tests__/member-verdict-cache.test.ts +119 -0
  427. package/src/runtime/__tests__/trust-verdict-consumer.test.ts +402 -123
  428. package/src/runtime/access-request-helper.ts +18 -39
  429. package/src/runtime/actor-trust-resolver.ts +46 -19
  430. package/src/runtime/anchored-guardian.test.ts +109 -0
  431. package/src/runtime/anchored-guardian.ts +86 -0
  432. package/src/runtime/assistant-event-hub.ts +1 -1
  433. package/src/runtime/assistant-stream-state.ts +9 -2
  434. package/src/runtime/auth/__tests__/require-bound-guardian.test.ts +99 -0
  435. package/src/runtime/auth/require-bound-guardian.ts +21 -11
  436. package/src/runtime/channel-verification-service.ts +56 -31
  437. package/src/runtime/confirmation-request-guardian-bridge.ts +3 -3
  438. package/src/runtime/guardian-vellum-migration.ts +69 -8
  439. package/src/runtime/invite-redemption-service.ts +213 -187
  440. package/src/runtime/local-actor-identity.test.ts +108 -0
  441. package/src/runtime/local-actor-identity.ts +85 -13
  442. package/src/runtime/local-principal-trust.ts +52 -0
  443. package/src/runtime/member-verdict-cache.ts +0 -0
  444. package/src/runtime/pending-interactions.ts +11 -1
  445. package/src/runtime/routes/__tests__/channel-verification-revoke.test.ts +56 -5
  446. package/src/runtime/routes/__tests__/channel-verification-routes.test.ts +1 -1
  447. package/src/runtime/routes/__tests__/contact-routes.test.ts +305 -0
  448. package/src/runtime/routes/__tests__/global-search-routes.test.ts +92 -0
  449. package/src/runtime/routes/__tests__/http-adapter-actor-header.test.ts +129 -0
  450. package/src/runtime/routes/__tests__/surface-action-routes.test.ts +188 -0
  451. package/src/runtime/routes/browser-routes.ts +1 -1
  452. package/src/runtime/routes/canonical-guardian-expiry-sweep.ts +13 -5
  453. package/src/runtime/routes/channel-verification-routes.ts +3 -3
  454. package/src/runtime/routes/contact-routes.ts +48 -57
  455. package/src/runtime/routes/conversation-cli-routes.ts +4 -5
  456. package/src/runtime/routes/conversation-list-routes.ts +4 -7
  457. package/src/runtime/routes/conversation-query-routes.ts +72 -0
  458. package/src/runtime/routes/conversation-routes.ts +84 -85
  459. package/src/runtime/routes/events-routes.ts +2 -2
  460. package/src/runtime/routes/global-search-routes.ts +3 -1
  461. package/src/runtime/routes/guardian-action-routes.ts +4 -5
  462. package/src/runtime/routes/host-app-control-routes.ts +5 -4
  463. package/src/runtime/routes/host-bash-routes.ts +5 -4
  464. package/src/runtime/routes/host-browser-routes.ts +9 -11
  465. package/src/runtime/routes/host-cu-routes.ts +5 -4
  466. package/src/runtime/routes/host-file-routes.ts +5 -4
  467. package/src/runtime/routes/host-transfer-routes.ts +6 -6
  468. package/src/runtime/routes/http-adapter.ts +16 -1
  469. package/src/runtime/routes/identity-routes.ts +3 -2
  470. package/src/runtime/routes/inbound-message-handler.ts +5 -5
  471. package/src/runtime/routes/inbound-stages/acl-enforcement.test.ts +97 -5
  472. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +61 -59
  473. package/src/runtime/routes/inbound-stages/background-dispatch.ts +13 -5
  474. package/src/runtime/routes/inbound-stages/escalation-intercept.ts +7 -7
  475. package/src/runtime/routes/inbound-stages/guardian-activation-intercept.test.ts +21 -8
  476. package/src/runtime/routes/inbound-stages/guardian-activation-intercept.ts +14 -3
  477. package/src/runtime/routes/inbound-stages/reaction-intercept.ts +19 -0
  478. package/src/runtime/routes/index.ts +2 -0
  479. package/src/runtime/routes/llm-context-normalization.ts +83 -0
  480. package/src/runtime/routes/mcp-auth-routes.ts +171 -19
  481. package/src/runtime/routes/migration-rollback-routes.ts +4 -3
  482. package/src/runtime/routes/migration-routes.ts +4 -1
  483. package/src/runtime/routes/onboarding-checkin-routes.ts +86 -0
  484. package/src/runtime/routes/settings-routes.ts +8 -3
  485. package/src/runtime/routes/subagents-routes.ts +5 -0
  486. package/src/runtime/routes/surface-action-routes.ts +42 -56
  487. package/src/runtime/services/__tests__/conversation-serializer.test.ts +1 -0
  488. package/src/runtime/services/conversation-serializer.ts +13 -58
  489. package/src/runtime/tool-grant-request-helper.ts +3 -3
  490. package/src/runtime/trust-verdict-consumer.ts +111 -40
  491. package/src/runtime/verification-outbound-actions.ts +18 -18
  492. package/src/signals/user-message.ts +16 -0
  493. package/src/subagent/__tests__/consult-prompt.test.ts +35 -0
  494. package/src/{plugins/defaults/advisor/__tests__/transcript.test.ts → subagent/__tests__/consult-transcript.test.ts} +47 -10
  495. package/src/{plugins/defaults/advisor/steering.ts → subagent/consult-prompt.ts} +22 -32
  496. package/src/{plugins/defaults/advisor/transcript.ts → subagent/consult-transcript.ts} +18 -8
  497. package/src/subagent/index.ts +1 -1
  498. package/src/subagent/manager.ts +254 -33
  499. package/src/subagent/types.ts +11 -4
  500. package/src/telemetry/types.ts +34 -1
  501. package/src/telemetry/usage-telemetry-reporter.test.ts +3 -2
  502. package/src/telemetry/usage-telemetry-reporter.ts +87 -3
  503. package/src/tools/ask-question/ask-question-tool.test.ts +29 -0
  504. package/src/tools/ask-question/ask-question-tool.ts +13 -0
  505. package/src/tools/executor.ts +4 -4
  506. package/src/tools/filesystem/search.ts +543 -0
  507. package/src/tools/registry.ts +38 -0
  508. package/src/tools/shared/filesystem/path-policy.ts +12 -5
  509. package/src/tools/subagent/consult-deadline.ts +49 -0
  510. package/src/tools/subagent/spawn.ts +234 -5
  511. package/src/tools/tool-approval-handler.ts +1 -1
  512. package/src/tools/tool-defaults.ts +9 -2
  513. package/src/tools/tool-manifest.ts +3 -0
  514. package/src/tools/types.ts +131 -25
  515. package/src/tools/workspace-tools/loader.ts +348 -244
  516. package/src/util/errors.ts +26 -1
  517. package/src/util/logger.ts +9 -0
  518. package/src/util/platform.ts +19 -0
  519. package/src/util/telemetry-db-path.ts +24 -0
  520. package/src/workflows/library.test.ts +140 -0
  521. package/src/workflows/library.ts +82 -28
  522. package/src/workspace/migrations/017-seed-persona-dirs.ts +3 -34
  523. package/src/workspace/migrations/019-scope-journal-to-guardian.ts +3 -24
  524. package/src/workspace/migrations/031-drop-user-md.ts +232 -148
  525. package/src/workspace/migrations/048-remove-workspace-hooks.ts +14 -66
  526. package/src/workspace/migrations/111-prune-seeded-callsite-defaults.ts +134 -0
  527. package/src/workspace/migrations/112-remove-advisor-callsite-override.ts +64 -0
  528. package/src/workspace/migrations/registry.ts +4 -0
  529. package/src/__tests__/workspace-tools-watcher-flag.test.ts +0 -70
  530. package/src/daemon/workspace-tools-watcher.ts +0 -328
  531. package/src/memory/migrations/registry.ts +0 -573
  532. package/src/plugins/defaults/advisor/__tests__/advisor-gate.test.ts +0 -56
  533. package/src/plugins/defaults/advisor/__tests__/advisor-state-store.test.ts +0 -43
  534. package/src/plugins/defaults/advisor/__tests__/agent-loop-integration.test.ts +0 -137
  535. package/src/plugins/defaults/advisor/__tests__/consult.test.ts +0 -153
  536. package/src/plugins/defaults/advisor/__tests__/hooks.test.ts +0 -138
  537. package/src/plugins/defaults/advisor/advisor-gate.ts +0 -29
  538. package/src/plugins/defaults/advisor/advisor-state-store.ts +0 -94
  539. package/src/plugins/defaults/advisor/config.ts +0 -21
  540. package/src/plugins/defaults/advisor/consult.ts +0 -93
  541. package/src/plugins/defaults/advisor/hooks/post-model-call.ts +0 -34
  542. package/src/plugins/defaults/advisor/hooks/pre-model-call.ts +0 -30
  543. package/src/plugins/defaults/advisor/hooks/user-prompt-submit.ts +0 -19
  544. package/src/plugins/defaults/advisor/package.json +0 -14
  545. package/src/plugins/defaults/advisor/tools/advisor.ts +0 -65
  546. package/src/providers/openai/__tests__/api-error-detail.test.ts +0 -120
@@ -62,7 +62,7 @@ afterAll(() => {
62
62
 
63
63
  const handleHostAppControlResult = ROUTES.find(
64
64
  (r) => r.endpoint === "host-app-control-result",
65
- )!.handler;
65
+ )!.handler as (args: Record<string, unknown>) => Promise<unknown>;
66
66
 
67
67
  // ── Tests ────────────────────────────────────────────────────────────
68
68
 
@@ -395,7 +395,7 @@ describe("handleHostAppControlResult — same-actor guard", () => {
395
395
  ).toThrow(BadRequestError);
396
396
  });
397
397
 
398
- test("targeted + missing header: interaction is NOT consumed (still pending)", () => {
398
+ test("targeted + missing header: interaction is NOT consumed (still pending)", async () => {
399
399
  const requestId = "ac-req-targeted-no-header-stays";
400
400
  pending.set(requestId, {
401
401
  conversationId: "conv-1",
@@ -404,13 +404,11 @@ describe("handleHostAppControlResult — same-actor guard", () => {
404
404
  targetActorPrincipalId: "user-1",
405
405
  });
406
406
 
407
- try {
408
- handleHostAppControlResult({
409
- body: { requestId, state: "running" },
410
- });
411
- } catch {
407
+ await handleHostAppControlResult({
408
+ body: { requestId, state: "running" },
409
+ }).catch(() => {
412
410
  // expected
413
- }
411
+ });
414
412
 
415
413
  expect(pending.has(requestId)).toBe(true);
416
414
  });
@@ -437,7 +435,7 @@ describe("handleHostAppControlResult — same-actor guard", () => {
437
435
  ).toThrow(ForbiddenError);
438
436
  });
439
437
 
440
- test("targeted + wrong client id: interaction is NOT consumed", () => {
438
+ test("targeted + wrong client id: interaction is NOT consumed", async () => {
441
439
  const requestId = "ac-req-targeted-wrong-client-stays";
442
440
  pending.set(requestId, {
443
441
  conversationId: "conv-1",
@@ -446,17 +444,15 @@ describe("handleHostAppControlResult — same-actor guard", () => {
446
444
  targetActorPrincipalId: "user-1",
447
445
  });
448
446
 
449
- try {
450
- handleHostAppControlResult({
451
- body: { requestId, state: "running" },
452
- headers: {
453
- "x-vellum-client-id": "client-B",
454
- "x-vellum-actor-principal-id": "user-1",
455
- },
456
- });
457
- } catch {
447
+ await handleHostAppControlResult({
448
+ body: { requestId, state: "running" },
449
+ headers: {
450
+ "x-vellum-client-id": "client-B",
451
+ "x-vellum-actor-principal-id": "user-1",
452
+ },
453
+ }).catch(() => {
458
454
  // expected
459
- }
455
+ });
460
456
 
461
457
  expect(pending.has(requestId)).toBe(true);
462
458
  });
@@ -483,7 +479,7 @@ describe("handleHostAppControlResult — same-actor guard", () => {
483
479
  ).toThrow(ForbiddenError);
484
480
  });
485
481
 
486
- test("targeted + wrong actor principal: interaction is NOT consumed", () => {
482
+ test("targeted + wrong actor principal: interaction is NOT consumed", async () => {
487
483
  const requestId = "ac-req-targeted-wrong-actor-stays";
488
484
  pending.set(requestId, {
489
485
  conversationId: "conv-1",
@@ -492,17 +488,15 @@ describe("handleHostAppControlResult — same-actor guard", () => {
492
488
  targetActorPrincipalId: "user-1",
493
489
  });
494
490
 
495
- try {
496
- handleHostAppControlResult({
497
- body: { requestId, state: "running" },
498
- headers: {
499
- "x-vellum-client-id": "client-A",
500
- "x-vellum-actor-principal-id": "user-2",
501
- },
502
- });
503
- } catch {
491
+ await handleHostAppControlResult({
492
+ body: { requestId, state: "running" },
493
+ headers: {
494
+ "x-vellum-client-id": "client-A",
495
+ "x-vellum-actor-principal-id": "user-2",
496
+ },
497
+ }).catch(() => {
504
498
  // expected
505
- }
499
+ });
506
500
 
507
501
  expect(pending.has(requestId)).toBe(true);
508
502
  });
@@ -95,7 +95,7 @@ afterAll(() => {
95
95
 
96
96
  const handleHostBashResult = ROUTES.find(
97
97
  (r) => r.endpoint === "host-bash-result",
98
- )!.handler;
98
+ )!.handler as (args: Record<string, unknown>) => Promise<unknown>;
99
99
 
100
100
  // ── Helpers ──────────────────────────────────────────────────────────
101
101
 
@@ -244,22 +244,20 @@ describe("handleHostBashResult", () => {
244
244
  ).toThrow(ForbiddenError);
245
245
  });
246
246
 
247
- test("interaction is NOT resolved on cross-actor 403 (still pending)", () => {
247
+ test("interaction is NOT resolved on cross-actor 403 (still pending)", async () => {
248
248
  const requestId = "req-actor-mismatch-stays";
249
249
  clientActorPrincipals.set("client-abc", "principal-victim");
250
250
  registerPending(requestId, { targetClientId: "client-abc" });
251
251
 
252
- try {
253
- handleHostBashResult({
254
- body: bashBody(requestId),
255
- headers: {
256
- "x-vellum-client-id": "client-abc",
257
- "x-vellum-actor-principal-id": "principal-attacker",
258
- },
259
- });
260
- } catch {
252
+ await handleHostBashResult({
253
+ body: bashBody(requestId),
254
+ headers: {
255
+ "x-vellum-client-id": "client-abc",
256
+ "x-vellum-actor-principal-id": "principal-attacker",
257
+ },
258
+ }).catch(() => {
261
259
  // expected
262
- }
260
+ });
263
261
 
264
262
  expect(resolvedIds).not.toContain(requestId);
265
263
  expect(pendingStore.has(requestId)).toBe(true);
@@ -278,19 +276,17 @@ describe("handleHostBashResult", () => {
278
276
  ).toThrow(ForbiddenError);
279
277
  });
280
278
 
281
- test("interaction is NOT resolved when submitting actor is missing (still pending)", () => {
279
+ test("interaction is NOT resolved when submitting actor is missing (still pending)", async () => {
282
280
  const requestId = "req-actor-missing-stays";
283
281
  clientActorPrincipals.set("client-abc", "principal-victim");
284
282
  registerPending(requestId, { targetClientId: "client-abc" });
285
283
 
286
- try {
287
- handleHostBashResult({
288
- body: bashBody(requestId),
289
- headers: { "x-vellum-client-id": "client-abc" },
290
- });
291
- } catch {
284
+ await handleHostBashResult({
285
+ body: bashBody(requestId),
286
+ headers: { "x-vellum-client-id": "client-abc" },
287
+ }).catch(() => {
292
288
  // expected
293
- }
289
+ });
294
290
 
295
291
  expect(resolvedIds).not.toContain(requestId);
296
292
  expect(pendingStore.has(requestId)).toBe(true);
@@ -358,15 +354,13 @@ describe("handleHostBashResult", () => {
358
354
  ).toThrow(BadRequestError);
359
355
  });
360
356
 
361
- test("interaction is NOT resolved on 400 (still pending)", () => {
357
+ test("interaction is NOT resolved on 400 (still pending)", async () => {
362
358
  const requestId = "req-targeted-no-header-stays";
363
359
  registerPending(requestId, { targetClientId: "client-abc" });
364
360
 
365
- try {
366
- handleHostBashResult({ body: bashBody(requestId) });
367
- } catch {
361
+ await handleHostBashResult({ body: bashBody(requestId) }).catch(() => {
368
362
  // expected
369
- }
363
+ });
370
364
 
371
365
  expect(resolvedIds).not.toContain(requestId);
372
366
  expect(pendingStore.has(requestId)).toBe(true);
@@ -388,19 +382,17 @@ describe("handleHostBashResult", () => {
388
382
  ).toThrow(ForbiddenError);
389
383
  });
390
384
 
391
- test("ForbiddenError message names both the submitting and expected client", () => {
385
+ test("ForbiddenError message names both the submitting and expected client", async () => {
392
386
  const requestId = "req-targeted-mismatch-msg";
393
387
  registerPending(requestId, { targetClientId: "client-abc" });
394
388
 
395
389
  let caught: unknown;
396
- try {
397
- handleHostBashResult({
398
- body: bashBody(requestId),
399
- headers: { "x-vellum-client-id": "client-xyz" },
400
- });
401
- } catch (e) {
390
+ await handleHostBashResult({
391
+ body: bashBody(requestId),
392
+ headers: { "x-vellum-client-id": "client-xyz" },
393
+ }).catch((e: unknown) => {
402
394
  caught = e;
403
- }
395
+ });
404
396
 
405
397
  expect(caught).toBeInstanceOf(ForbiddenError);
406
398
  const msg = (caught as ForbiddenError).message;
@@ -408,18 +400,16 @@ describe("handleHostBashResult", () => {
408
400
  expect(msg).toContain("client-abc");
409
401
  });
410
402
 
411
- test("interaction is NOT resolved on 403 (still pending)", () => {
403
+ test("interaction is NOT resolved on 403 (still pending)", async () => {
412
404
  const requestId = "req-targeted-mismatch-stays";
413
405
  registerPending(requestId, { targetClientId: "client-abc" });
414
406
 
415
- try {
416
- handleHostBashResult({
417
- body: bashBody(requestId),
418
- headers: { "x-vellum-client-id": "client-xyz" },
419
- });
420
- } catch {
407
+ await handleHostBashResult({
408
+ body: bashBody(requestId),
409
+ headers: { "x-vellum-client-id": "client-xyz" },
410
+ }).catch(() => {
421
411
  // expected
422
- }
412
+ });
423
413
 
424
414
  expect(resolvedIds).not.toContain(requestId);
425
415
  expect(pendingStore.has(requestId)).toBe(true);
@@ -39,7 +39,7 @@ afterAll(() => {
39
39
 
40
40
  const handleHostBrowserResult = ROUTES.find(
41
41
  (r) => r.endpoint === "host-browser-result",
42
- )!.handler;
42
+ )!.handler as (args: Record<string, unknown>) => Promise<unknown>;
43
43
 
44
44
  // ── Tests ────────────────────────────────────────────────────────────
45
45
 
@@ -212,7 +212,7 @@ describe("handleHostBrowserResult — same-actor guard", () => {
212
212
  ).toThrow(BadRequestError);
213
213
  });
214
214
 
215
- test("interaction is NOT consumed on 400 (still pending)", () => {
215
+ test("interaction is NOT consumed on 400 (still pending)", async () => {
216
216
  const requestId = "browser-req-targeted-no-header-stays";
217
217
  pendingInteractions.register(requestId, {
218
218
  conversationId: "conv-1",
@@ -221,13 +221,11 @@ describe("handleHostBrowserResult — same-actor guard", () => {
221
221
  targetActorPrincipalId: "user-1",
222
222
  });
223
223
 
224
- try {
225
- handleHostBrowserResult({
226
- body: { requestId, content: "ok", isError: false },
227
- });
228
- } catch {
224
+ await handleHostBrowserResult({
225
+ body: { requestId, content: "ok", isError: false },
226
+ }).catch(() => {
229
227
  // expected
230
- }
228
+ });
231
229
 
232
230
  expect(pendingInteractions.get(requestId)).toBeDefined();
233
231
  });
@@ -256,7 +254,7 @@ describe("handleHostBrowserResult — same-actor guard", () => {
256
254
  ).toThrow(ForbiddenError);
257
255
  });
258
256
 
259
- test("ForbiddenError message names both submitting and expected client", () => {
257
+ test("ForbiddenError message names both submitting and expected client", async () => {
260
258
  const requestId = "browser-req-targeted-mismatch-msg";
261
259
  pendingInteractions.register(requestId, {
262
260
  conversationId: "conv-1",
@@ -267,7 +265,7 @@ describe("handleHostBrowserResult — same-actor guard", () => {
267
265
 
268
266
  let caught: unknown;
269
267
  try {
270
- handleHostBrowserResult({
268
+ await handleHostBrowserResult({
271
269
  body: { requestId, content: "ok", isError: false },
272
270
  headers: {
273
271
  "x-vellum-client-id": "client-B",
@@ -284,7 +282,7 @@ describe("handleHostBrowserResult — same-actor guard", () => {
284
282
  expect(msg).toContain("client-B");
285
283
  });
286
284
 
287
- test("interaction is NOT consumed on 403 (still pending)", () => {
285
+ test("interaction is NOT consumed on 403 (still pending)", async () => {
288
286
  const requestId = "browser-req-targeted-mismatch-stays";
289
287
  pendingInteractions.register(requestId, {
290
288
  conversationId: "conv-1",
@@ -293,17 +291,15 @@ describe("handleHostBrowserResult — same-actor guard", () => {
293
291
  targetActorPrincipalId: "user-1",
294
292
  });
295
293
 
296
- try {
297
- handleHostBrowserResult({
298
- body: { requestId, content: "ok", isError: false },
299
- headers: {
300
- "x-vellum-client-id": "client-B",
301
- "x-vellum-actor-principal-id": "user-1",
302
- },
303
- });
304
- } catch {
294
+ await handleHostBrowserResult({
295
+ body: { requestId, content: "ok", isError: false },
296
+ headers: {
297
+ "x-vellum-client-id": "client-B",
298
+ "x-vellum-actor-principal-id": "user-1",
299
+ },
300
+ }).catch(() => {
305
301
  // expected
306
- }
302
+ });
307
303
 
308
304
  expect(pendingInteractions.get(requestId)).toBeDefined();
309
305
  });
@@ -369,7 +365,7 @@ describe("handleHostBrowserResult — same-actor guard", () => {
369
365
  ).toThrow(ForbiddenError);
370
366
  });
371
367
 
372
- test("interaction NOT consumed on actor-mismatch 403", () => {
368
+ test("interaction NOT consumed on actor-mismatch 403", async () => {
373
369
  const requestId = "browser-req-actor-mismatch-stays";
374
370
  pendingInteractions.register(requestId, {
375
371
  conversationId: "conv-1",
@@ -378,17 +374,15 @@ describe("handleHostBrowserResult — same-actor guard", () => {
378
374
  targetActorPrincipalId: "user-1",
379
375
  });
380
376
 
381
- try {
382
- handleHostBrowserResult({
383
- body: { requestId, content: "ok", isError: false },
384
- headers: {
385
- "x-vellum-client-id": "client-A",
386
- "x-vellum-actor-principal-id": "user-2",
387
- },
388
- });
389
- } catch {
377
+ await handleHostBrowserResult({
378
+ body: { requestId, content: "ok", isError: false },
379
+ headers: {
380
+ "x-vellum-client-id": "client-A",
381
+ "x-vellum-actor-principal-id": "user-2",
382
+ },
383
+ }).catch(() => {
390
384
  // expected
391
- }
385
+ });
392
386
 
393
387
  expect(pendingInteractions.get(requestId)).toBeDefined();
394
388
  });
@@ -104,7 +104,7 @@ afterAll(() => {
104
104
 
105
105
  const handleHostCuResult = ROUTES.find(
106
106
  (r: { endpoint: string }) => r.endpoint === "host-cu-result",
107
- )!.handler;
107
+ )!.handler as (args: Record<string, unknown>) => Promise<unknown>;
108
108
 
109
109
  // ── Helpers ──────────────────────────────────────────────────────────────────
110
110
 
@@ -226,15 +226,13 @@ describe("handleHostCuResult — Phase 2 targetClientId guard", () => {
226
226
  ).toThrow(BadRequestError);
227
227
  });
228
228
 
229
- test("interaction is NOT resolved on 400 (still pending)", () => {
229
+ test("interaction is NOT resolved on 400 (still pending)", async () => {
230
230
  const requestId = "req-cu-targeted-no-header-stays";
231
231
  registerPending(requestId, { targetClientId: "client-A" });
232
232
 
233
- try {
234
- handleHostCuResult({ body: cuBody(requestId) });
235
- } catch {
233
+ await handleHostCuResult({ body: cuBody(requestId) }).catch(() => {
236
234
  // expected
237
- }
235
+ });
238
236
 
239
237
  expect(resolvedIds).not.toContain(requestId);
240
238
  expect(pendingStore.has(requestId)).toBe(true);
@@ -256,19 +254,17 @@ describe("handleHostCuResult — Phase 2 targetClientId guard", () => {
256
254
  ).toThrow(ForbiddenError);
257
255
  });
258
256
 
259
- test("ForbiddenError message names both submitting and expected client", () => {
257
+ test("ForbiddenError message names both submitting and expected client", async () => {
260
258
  const requestId = "req-cu-targeted-mismatch-msg";
261
259
  registerPending(requestId, { targetClientId: "client-A" });
262
260
 
263
261
  let caught: unknown;
264
- try {
265
- handleHostCuResult({
266
- body: cuBody(requestId),
267
- headers: { "x-vellum-client-id": "client-B" },
268
- });
269
- } catch (e) {
262
+ await handleHostCuResult({
263
+ body: cuBody(requestId),
264
+ headers: { "x-vellum-client-id": "client-B" },
265
+ }).catch((e: unknown) => {
270
266
  caught = e;
271
- }
267
+ });
272
268
 
273
269
  expect(caught).toBeInstanceOf(ForbiddenError);
274
270
  const msg = (caught as ForbiddenError).message;
@@ -276,18 +272,16 @@ describe("handleHostCuResult — Phase 2 targetClientId guard", () => {
276
272
  expect(msg).toContain("client-A");
277
273
  });
278
274
 
279
- test("interaction is NOT consumed on 403 (pendingInteractions.get still returns it)", () => {
275
+ test("interaction is NOT consumed on 403 (pendingInteractions.get still returns it)", async () => {
280
276
  const requestId = "req-cu-targeted-mismatch-stays";
281
277
  registerPending(requestId, { targetClientId: "client-A" });
282
278
 
283
- try {
284
- handleHostCuResult({
285
- body: cuBody(requestId),
286
- headers: { "x-vellum-client-id": "client-B" },
287
- });
288
- } catch {
279
+ await handleHostCuResult({
280
+ body: cuBody(requestId),
281
+ headers: { "x-vellum-client-id": "client-B" },
282
+ }).catch(() => {
289
283
  // expected
290
- }
284
+ });
291
285
 
292
286
  expect(resolvedIds).not.toContain(requestId);
293
287
  expect(pendingStore.has(requestId)).toBe(true);
@@ -331,22 +325,20 @@ describe("handleHostCuResult — Phase 2 targetClientId guard", () => {
331
325
  ).toThrow(ForbiddenError);
332
326
  });
333
327
 
334
- test("interaction NOT consumed on 403 actor mismatch", () => {
328
+ test("interaction NOT consumed on 403 actor mismatch", async () => {
335
329
  const requestId = "req-cu-actor-mismatch-stays";
336
330
  actorPrincipalByClient.set("client-A", "user-1");
337
331
  registerPending(requestId, { targetClientId: "client-A" });
338
332
 
339
- try {
340
- handleHostCuResult({
341
- body: cuBody(requestId),
342
- headers: {
343
- "x-vellum-client-id": "client-A",
344
- "x-vellum-actor-principal-id": "user-2",
345
- },
346
- });
347
- } catch {
333
+ await handleHostCuResult({
334
+ body: cuBody(requestId),
335
+ headers: {
336
+ "x-vellum-client-id": "client-A",
337
+ "x-vellum-actor-principal-id": "user-2",
338
+ },
339
+ }).catch(() => {
348
340
  // expected
349
- }
341
+ });
350
342
 
351
343
  expect(resolvedIds).not.toContain(requestId);
352
344
  expect(pendingStore.has(requestId)).toBe(true);
@@ -87,7 +87,7 @@ afterAll(() => {
87
87
 
88
88
  const handleHostFileResult = ROUTES.find(
89
89
  (r) => r.endpoint === "host-file-result",
90
- )!.handler;
90
+ )!.handler as (args: Record<string, unknown>) => Promise<unknown>;
91
91
 
92
92
  // ── Helpers ─────────────────────────────────────────────────────────────────
93
93
 
@@ -189,15 +189,13 @@ describe("handleHostFileResult — targetClientId guard", () => {
189
189
  ).toThrow(BadRequestError);
190
190
  });
191
191
 
192
- test("interaction is NOT resolved on 400 (still pending)", () => {
192
+ test("interaction is NOT resolved on 400 (still pending)", async () => {
193
193
  const requestId = "req-file-targeted-no-header-stays";
194
194
  registerPending(requestId, { targetClientId: "client-A" });
195
195
 
196
- try {
197
- handleHostFileResult({ body: fileBody(requestId) });
198
- } catch {
196
+ await handleHostFileResult({ body: fileBody(requestId) }).catch(() => {
199
197
  // expected
200
- }
198
+ });
201
199
 
202
200
  expect(resolvedIds).not.toContain(requestId);
203
201
  expect(pendingStore.has(requestId)).toBe(true);
@@ -219,19 +217,17 @@ describe("handleHostFileResult — targetClientId guard", () => {
219
217
  ).toThrow(ForbiddenError);
220
218
  });
221
219
 
222
- test("ForbiddenError message names both submitting and expected client", () => {
220
+ test("ForbiddenError message names both submitting and expected client", async () => {
223
221
  const requestId = "req-file-targeted-mismatch-msg";
224
222
  registerPending(requestId, { targetClientId: "client-A" });
225
223
 
226
224
  let caught: unknown;
227
- try {
228
- handleHostFileResult({
229
- body: fileBody(requestId),
230
- headers: { "x-vellum-client-id": "client-B" },
231
- });
232
- } catch (e) {
225
+ await handleHostFileResult({
226
+ body: fileBody(requestId),
227
+ headers: { "x-vellum-client-id": "client-B" },
228
+ }).catch((e: unknown) => {
233
229
  caught = e;
234
- }
230
+ });
235
231
 
236
232
  expect(caught).toBeInstanceOf(ForbiddenError);
237
233
  const msg = (caught as ForbiddenError).message;
@@ -239,18 +235,16 @@ describe("handleHostFileResult — targetClientId guard", () => {
239
235
  expect(msg).toContain("client-A");
240
236
  });
241
237
 
242
- test("interaction is NOT consumed on 403 (pendingInteractions.get still returns it)", () => {
238
+ test("interaction is NOT consumed on 403 (pendingInteractions.get still returns it)", async () => {
243
239
  const requestId = "req-file-targeted-mismatch-stays";
244
240
  registerPending(requestId, { targetClientId: "client-A" });
245
241
 
246
- try {
247
- handleHostFileResult({
248
- body: fileBody(requestId),
249
- headers: { "x-vellum-client-id": "client-B" },
250
- });
251
- } catch {
242
+ await handleHostFileResult({
243
+ body: fileBody(requestId),
244
+ headers: { "x-vellum-client-id": "client-B" },
245
+ }).catch(() => {
252
246
  // expected
253
- }
247
+ });
254
248
 
255
249
  expect(resolvedIds).not.toContain(requestId);
256
250
  expect(pendingStore.has(requestId)).toBe(true);
@@ -306,22 +300,20 @@ describe("handleHostFileResult — targetClientId guard", () => {
306
300
  ).toThrow(ForbiddenError);
307
301
  });
308
302
 
309
- test("interaction is NOT consumed on actor-mismatch 403", () => {
303
+ test("interaction is NOT consumed on actor-mismatch 403", async () => {
310
304
  const requestId = "req-file-actor-mismatch-stays";
311
305
  clientActors.set("client-A", "actor-1");
312
306
  registerPending(requestId, { targetClientId: "client-A" });
313
307
 
314
- try {
315
- handleHostFileResult({
316
- body: fileBody(requestId),
317
- headers: {
318
- "x-vellum-client-id": "client-A",
319
- "x-vellum-actor-principal-id": "actor-2",
320
- },
321
- });
322
- } catch {
308
+ await handleHostFileResult({
309
+ body: fileBody(requestId),
310
+ headers: {
311
+ "x-vellum-client-id": "client-A",
312
+ "x-vellum-actor-principal-id": "actor-2",
313
+ },
314
+ }).catch(() => {
323
315
  // expected
324
- }
316
+ });
325
317
 
326
318
  expect(resolvedIds).not.toContain(requestId);
327
319
  expect(pendingStore.has(requestId)).toBe(true);
@@ -360,19 +352,17 @@ describe("handleHostFileResult — targetClientId guard", () => {
360
352
  ).toThrow(ForbiddenError);
361
353
  });
362
354
 
363
- test("interaction is NOT consumed when submitting actor is missing", () => {
355
+ test("interaction is NOT consumed when submitting actor is missing", async () => {
364
356
  const requestId = "req-file-actor-missing-stays";
365
357
  clientActors.set("client-A", "actor-1");
366
358
  registerPending(requestId, { targetClientId: "client-A" });
367
359
 
368
- try {
369
- handleHostFileResult({
370
- body: fileBody(requestId),
371
- headers: { "x-vellum-client-id": "client-A" },
372
- });
373
- } catch {
360
+ await handleHostFileResult({
361
+ body: fileBody(requestId),
362
+ headers: { "x-vellum-client-id": "client-A" },
363
+ }).catch(() => {
374
364
  // expected
375
- }
365
+ });
376
366
 
377
367
  expect(resolvedIds).not.toContain(requestId);
378
368
  expect(pendingStore.has(requestId)).toBe(true);
@@ -398,21 +388,19 @@ describe("handleHostFileResult — targetClientId guard", () => {
398
388
  ).toThrow(ForbiddenError);
399
389
  });
400
390
 
401
- test("interaction is NOT consumed when target client has no stored actor", () => {
391
+ test("interaction is NOT consumed when target client has no stored actor", async () => {
402
392
  const requestId = "req-file-target-no-actor-stays";
403
393
  registerPending(requestId, { targetClientId: "client-A" });
404
394
 
405
- try {
406
- handleHostFileResult({
407
- body: fileBody(requestId),
408
- headers: {
409
- "x-vellum-client-id": "client-A",
410
- "x-vellum-actor-principal-id": "actor-1",
411
- },
412
- });
413
- } catch {
395
+ await handleHostFileResult({
396
+ body: fileBody(requestId),
397
+ headers: {
398
+ "x-vellum-client-id": "client-A",
399
+ "x-vellum-actor-principal-id": "actor-1",
400
+ },
401
+ }).catch(() => {
414
402
  // expected
415
- }
403
+ });
416
404
 
417
405
  expect(resolvedIds).not.toContain(requestId);
418
406
  expect(pendingStore.has(requestId)).toBe(true);