@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
@@ -99,7 +99,7 @@ afterAll(() => {
99
99
 
100
100
  const handleTransferContentGet = ROUTES.find(
101
101
  (r) => r.endpoint === "transfers/:transferId/content" && r.method === "GET",
102
- )!.handler;
102
+ )!.handler as (args: Record<string, unknown>) => Promise<unknown>;
103
103
 
104
104
  const handleTransferContentPut = ROUTES.find(
105
105
  (r) => r.endpoint === "transfers/:transferId/content" && r.method === "PUT",
@@ -107,7 +107,7 @@ const handleTransferContentPut = ROUTES.find(
107
107
 
108
108
  const handleTransferResult = ROUTES.find(
109
109
  (r) => r.endpoint === "host-transfer-result",
110
- )!.handler;
110
+ )!.handler as (args: Record<string, unknown>) => Promise<unknown>;
111
111
 
112
112
  // ── Helpers ─────────────────────────────────────────────────────────────────
113
113
 
@@ -186,15 +186,13 @@ describe("handleTransferContentGet — Phase 3 targetClientId guard", () => {
186
186
  ).toThrow(BadRequestError);
187
187
  });
188
188
 
189
- test("getTransferContent NOT called on 400", () => {
189
+ test("getTransferContent NOT called on 400", async () => {
190
190
  stubTargetClientId = "client-A";
191
- try {
192
- handleTransferContentGet({
193
- pathParams: { transferId: TEST_TRANSFER_ID },
194
- });
195
- } catch {
191
+ await handleTransferContentGet({
192
+ pathParams: { transferId: TEST_TRANSFER_ID },
193
+ }).catch(() => {
196
194
  // expected
197
- }
195
+ });
198
196
  expect(getTransferContentCalls).toHaveLength(0);
199
197
  });
200
198
  });
@@ -212,16 +210,14 @@ describe("handleTransferContentGet — Phase 3 targetClientId guard", () => {
212
210
  ).toThrow(ForbiddenError);
213
211
  });
214
212
 
215
- test("getTransferContent NOT called on 403", () => {
213
+ test("getTransferContent NOT called on 403", async () => {
216
214
  stubTargetClientId = "client-A";
217
- try {
218
- handleTransferContentGet({
219
- pathParams: { transferId: TEST_TRANSFER_ID },
220
- headers: { "x-vellum-client-id": "client-B" },
221
- });
222
- } catch {
215
+ await handleTransferContentGet({
216
+ pathParams: { transferId: TEST_TRANSFER_ID },
217
+ headers: { "x-vellum-client-id": "client-B" },
218
+ }).catch(() => {
223
219
  // expected
224
- }
220
+ });
225
221
  expect(getTransferContentCalls).toHaveLength(0);
226
222
  });
227
223
  });
@@ -526,23 +522,19 @@ describe("handleTransferResult — Phase 3 targetClientId guard", () => {
526
522
  );
527
523
  });
528
524
 
529
- test("resolveTransferResult NOT called on 400", () => {
525
+ test("resolveTransferResult NOT called on 400", async () => {
530
526
  registerHostTransferPending("client-A");
531
- try {
532
- handleTransferResult({ body: resultBody() });
533
- } catch {
527
+ await handleTransferResult({ body: resultBody() }).catch(() => {
534
528
  // expected
535
- }
529
+ });
536
530
  expect(resolveTransferResultCalls).toHaveLength(0);
537
531
  });
538
532
 
539
- test("pending interaction still present after 400", () => {
533
+ test("pending interaction still present after 400", async () => {
540
534
  registerHostTransferPending("client-A");
541
- try {
542
- handleTransferResult({ body: resultBody() });
543
- } catch {
535
+ await handleTransferResult({ body: resultBody() }).catch(() => {
544
536
  // expected
545
- }
537
+ });
546
538
  expect(pendingStore.has(TEST_REQUEST_ID)).toBe(true);
547
539
  });
548
540
  });
@@ -560,29 +552,25 @@ describe("handleTransferResult — Phase 3 targetClientId guard", () => {
560
552
  ).toThrow(ForbiddenError);
561
553
  });
562
554
 
563
- test("resolveTransferResult NOT called on 403", () => {
555
+ test("resolveTransferResult NOT called on 403", async () => {
564
556
  registerHostTransferPending("client-A");
565
- try {
566
- handleTransferResult({
567
- body: resultBody(),
568
- headers: { "x-vellum-client-id": "client-B" },
569
- });
570
- } catch {
557
+ await handleTransferResult({
558
+ body: resultBody(),
559
+ headers: { "x-vellum-client-id": "client-B" },
560
+ }).catch(() => {
571
561
  // expected
572
- }
562
+ });
573
563
  expect(resolveTransferResultCalls).toHaveLength(0);
574
564
  });
575
565
 
576
- test("pending interaction still present after 403", () => {
566
+ test("pending interaction still present after 403", async () => {
577
567
  registerHostTransferPending("client-A");
578
- try {
579
- handleTransferResult({
580
- body: resultBody(),
581
- headers: { "x-vellum-client-id": "client-B" },
582
- });
583
- } catch {
568
+ await handleTransferResult({
569
+ body: resultBody(),
570
+ headers: { "x-vellum-client-id": "client-B" },
571
+ }).catch(() => {
584
572
  // expected
585
- }
573
+ });
586
574
  expect(pendingStore.has(TEST_REQUEST_ID)).toBe(true);
587
575
  });
588
576
  });
@@ -62,6 +62,21 @@ mock.module("../runtime/guardian-reply-router.js", () => ({
62
62
  routeGuardianReply: routeGuardianReplyMock,
63
63
  }));
64
64
 
65
+ // Stub for the shared reset-drift helper. handleSendMessage only consumes its
66
+ // result (a guardian TrustContext or null) on a first-pass-unknown actor; the
67
+ // gate itself is covered in runtime/__tests__/guardian-vellum-migration.test.ts.
68
+ const reResolveCalls: string[] = [];
69
+ let mockReResolve: { trustClass: string; sourceChannel: string } | null = null;
70
+ mock.module("../runtime/guardian-vellum-migration.js", () => ({
71
+ reResolveTrustOnResetDrift: async (
72
+ incomingPrincipalId: string,
73
+ _sourceChannel: string,
74
+ ) => {
75
+ reResolveCalls.push(incomingPrincipalId);
76
+ return mockReResolve;
77
+ },
78
+ }));
79
+
65
80
  mock.module("../memory/canonical-guardian-store.js", () => ({
66
81
  createCanonicalGuardianRequest: () => ({
67
82
  id: "canonical-id",
@@ -94,6 +109,8 @@ mock.module("../runtime/confirmation-request-guardian-bridge.js", () => ({
94
109
  }));
95
110
 
96
111
  mock.module("../memory/conversation-crud.js", () => ({
112
+ setConversationProcessingStartedAt: () => {},
113
+ isConversationProcessing: () => false,
97
114
  addMessage: (
98
115
  conversationId: string,
99
116
  role: string,
@@ -104,17 +121,70 @@ mock.module("../memory/conversation-crud.js", () => ({
104
121
  }));
105
122
 
106
123
  mock.module("../runtime/local-actor-identity.js", () => ({
107
- resolveLocalTrustContext: () => ({
108
- trustClass: "guardian",
109
- sourceChannel: "vellum",
110
- }),
124
+ findLocalGuardianPrincipalId: async () =>
125
+ mockGuardians?.find(
126
+ (g) => g.channelType === "vellum" && g.status === "active",
127
+ )?.principalId as string | undefined,
128
+ }));
129
+
130
+ // Capture the sourceActorPrincipalId that handleSendMessage threads into
131
+ // shouldAttachHostProxyForCapability / preactivateHostProxySkills, so tests
132
+ // can assert the dev-bypass translation landed before the CU proxy gate.
133
+ // The macOS "native_support" path short-circuits before reading the
134
+ // principal, so only web/ios turns exercise the same-actor branch.
135
+ const hostProxyAttachCalls: Array<{
136
+ capability: string;
137
+ sourceInterface: unknown;
138
+ sourceActorPrincipalId: string | undefined;
139
+ }> = [];
140
+ const preactivateCalls: Array<{
141
+ sourceInterface: unknown;
142
+ sourceActorPrincipalId: string | undefined;
143
+ }> = [];
144
+ mock.module("../daemon/host-proxy-preactivation.js", () => ({
145
+ shouldAttachHostProxyForCapability: (
146
+ capability: string,
147
+ sourceInterface: unknown,
148
+ sourceActorPrincipalId: string | undefined,
149
+ ) => {
150
+ hostProxyAttachCalls.push({
151
+ capability,
152
+ sourceInterface,
153
+ sourceActorPrincipalId,
154
+ });
155
+ // Return false so the route skips proxy instantiation; we only care
156
+ // that the translated principal reached the gate.
157
+ return false;
158
+ },
159
+ preactivateHostProxySkills: (
160
+ _conversation: unknown,
161
+ sourceInterface: unknown,
162
+ sourceActorPrincipalId: string | undefined,
163
+ ) => {
164
+ preactivateCalls.push({ sourceInterface, sourceActorPrincipalId });
165
+ },
111
166
  }));
112
167
 
168
+ let mockGuardians: Array<Record<string, unknown>> | null = [
169
+ {
170
+ channelType: "vellum",
171
+ contactId: "guardian-contact",
172
+ principalId: "test-user",
173
+ address: "test-user",
174
+ status: "active",
175
+ },
176
+ ];
177
+
178
+ mock.module("../contacts/guardian-delivery-reader.js", () => ({
179
+ getGuardianDelivery: async () => mockGuardians,
180
+ guardianForChannel: (
181
+ list: Array<Record<string, unknown>>,
182
+ channelType: string,
183
+ ) => list.find((g) => g.channelType === channelType && g.status === "active"),
184
+ }));
185
+
186
+ // handleSendMessage wraps the first-pass resolve with withSourceChannel.
113
187
  mock.module("../runtime/trust-context-resolver.js", () => ({
114
- resolveTrustContext: () => ({
115
- trustClass: "guardian",
116
- sourceChannel: "vellum",
117
- }),
118
188
  withSourceChannel: (sourceChannel: unknown, ctx: unknown) => ({
119
189
  ...(ctx as Record<string, unknown>),
120
190
  sourceChannel,
@@ -454,3 +524,215 @@ describe("HTTP POST /v1/messages clientTimezone transport metadata", () => {
454
524
  expect(runAgentLoop).toHaveBeenCalledTimes(1);
455
525
  });
456
526
  });
527
+
528
+ // ============================================================================
529
+ // TRUST CONTEXT — derived from the gateway guardian binding
530
+ // ============================================================================
531
+ describe("HTTP POST /v1/messages trust context from the gateway binding", () => {
532
+ beforeEach(() => {
533
+ mockGuardians = [
534
+ {
535
+ channelType: "vellum",
536
+ contactId: "guardian-contact",
537
+ principalId: "test-user",
538
+ address: "test-user",
539
+ status: "active",
540
+ },
541
+ ];
542
+ reResolveCalls.length = 0;
543
+ mockReResolve = null;
544
+ });
545
+
546
+ function requestAs(principalId: string, sourceChannel = "vellum") {
547
+ return new Request("http://localhost/v1/messages", {
548
+ method: "POST",
549
+ headers: {
550
+ "Content-Type": "application/json",
551
+ "x-vellum-actor-principal-id": principalId,
552
+ "x-vellum-principal-type": "actor",
553
+ },
554
+ body: JSON.stringify({
555
+ conversationKey: "trust-test-key",
556
+ content: "hi",
557
+ sourceChannel,
558
+ interface: "macos",
559
+ }),
560
+ });
561
+ }
562
+
563
+ async function trustContextFor(
564
+ principalId: string,
565
+ sourceChannel = "vellum",
566
+ ): Promise<Record<string, unknown>> {
567
+ let captured: Record<string, unknown> | undefined;
568
+ const conversation = makeConversation({
569
+ setTrustContext: (ctx: Record<string, unknown>) => {
570
+ captured = ctx;
571
+ },
572
+ });
573
+ const res = await callHandler(
574
+ (args) =>
575
+ handleSendMessage(args, {
576
+ sendMessageDeps: {
577
+ getOrCreateConversation: async () => conversation,
578
+ assistantEventHub: { publish: async () => {} } as any,
579
+ resolveAttachments: () => [],
580
+ },
581
+ }),
582
+ requestAs(principalId, sourceChannel),
583
+ undefined,
584
+ 202,
585
+ );
586
+ expect(res.status).toBe(202);
587
+ return captured ?? {};
588
+ }
589
+
590
+ async function trustClassFor(principalId: string): Promise<string> {
591
+ return (await trustContextFor(principalId)).trustClass as string;
592
+ }
593
+
594
+ test("guardian principal resolves to guardian context, helper not called", async () => {
595
+ expect(await trustClassFor("test-user")).toBe("guardian");
596
+ expect(reResolveCalls).toEqual([]);
597
+ });
598
+
599
+ test("non-guardian principal: helper consulted, null result stays unknown", async () => {
600
+ mockReResolve = null;
601
+ expect(await trustClassFor("vellum-principal-stranger")).toBe("unknown");
602
+ expect(reResolveCalls).toEqual(["vellum-principal-stranger"]);
603
+ });
604
+
605
+ test("reset drift: helper returns guardian → route adopts it", async () => {
606
+ mockGuardians = [
607
+ {
608
+ channelType: "vellum",
609
+ contactId: "guardian-contact",
610
+ principalId: "vellum-principal-stale",
611
+ address: "vellum-principal-stale",
612
+ status: "active",
613
+ },
614
+ ];
615
+ mockReResolve = { trustClass: "guardian", sourceChannel: "vellum" };
616
+
617
+ expect(await trustClassFor("vellum-principal-healed")).toBe("guardian");
618
+ expect(reResolveCalls).toEqual(["vellum-principal-healed"]);
619
+ });
620
+
621
+ test("helper returns an unknown-class ctx → trust stays unknown (not adopted)", async () => {
622
+ mockGuardians = [
623
+ {
624
+ channelType: "vellum",
625
+ contactId: "guardian-contact",
626
+ principalId: "vellum-principal-stale",
627
+ address: "vellum-principal-stale",
628
+ status: "active",
629
+ },
630
+ ];
631
+ mockReResolve = { trustClass: "unknown", sourceChannel: "vellum" };
632
+
633
+ expect(await trustClassFor("vellum-principal-healed")).toBe("unknown");
634
+ });
635
+
636
+ test("dev-bypass maps the gateway guardian principal to guardian", async () => {
637
+ expect(await trustClassFor("dev-bypass")).toBe("guardian");
638
+ });
639
+
640
+ test("dev-bypass fails closed to unknown on an empty gateway", async () => {
641
+ // No active gateway binding: dev-bypass cannot translate to a real guardian,
642
+ // and the helper (null) leaves trust unknown — parity with /v1/surface-actions.
643
+ mockGuardians = [];
644
+ mockReResolve = null;
645
+ expect(await trustClassFor("dev-bypass")).toBe("unknown");
646
+ });
647
+
648
+ test("preserves the request body channel on the guardian-match happy path", async () => {
649
+ const ctx = await trustContextFor("test-user", "telegram");
650
+ expect(ctx.trustClass).toBe("guardian");
651
+ expect(ctx.sourceChannel).toBe("telegram");
652
+ });
653
+
654
+ // A web turn's "dev-bypass" principal must translate to the real guardian
655
+ // principal before the CU/app-control same-actor proxy-attachment gate,
656
+ // so it matches the macOS client's SSE-registered principal.
657
+ test("dev-bypass is translated to the guardian principal before the CU proxy attach gate (web turn)", async () => {
658
+ hostProxyAttachCalls.length = 0;
659
+ preactivateCalls.length = 0;
660
+ const conversation = makeConversation();
661
+ const res = await callHandler(
662
+ (args) =>
663
+ handleSendMessage(args, {
664
+ sendMessageDeps: {
665
+ getOrCreateConversation: async () => conversation,
666
+ assistantEventHub: { publish: async () => {} } as any,
667
+ resolveAttachments: () => [],
668
+ },
669
+ }),
670
+ new Request("http://localhost/v1/messages", {
671
+ method: "POST",
672
+ headers: {
673
+ "Content-Type": "application/json",
674
+ "x-vellum-actor-principal-id": "dev-bypass",
675
+ "x-vellum-principal-type": "actor",
676
+ },
677
+ body: JSON.stringify({
678
+ conversationKey: "cu-attach-key",
679
+ content: "hi",
680
+ sourceChannel: "vellum",
681
+ interface: "web",
682
+ }),
683
+ }),
684
+ undefined,
685
+ 202,
686
+ );
687
+ expect(res.status).toBe(202);
688
+
689
+ // The CU attach gate receives the translated guardian principal, not
690
+ // the raw "dev-bypass" string.
691
+ const cuCall = hostProxyAttachCalls.find(
692
+ (c) => c.capability === "host_cu",
693
+ );
694
+ expect(cuCall).toBeDefined();
695
+ expect(cuCall?.sourceActorPrincipalId).toBe("test-user");
696
+ expect(cuCall?.sourceActorPrincipalId).not.toBe("dev-bypass");
697
+
698
+ // Preactivation receives the same translated principal.
699
+ const preactivateCall = preactivateCalls[0];
700
+ expect(preactivateCall?.sourceActorPrincipalId).toBe("test-user");
701
+ });
702
+
703
+ test("real (non-dev-bypass) principal passes through the CU proxy attach gate unchanged", async () => {
704
+ hostProxyAttachCalls.length = 0;
705
+ const conversation = makeConversation();
706
+ await callHandler(
707
+ (args) =>
708
+ handleSendMessage(args, {
709
+ sendMessageDeps: {
710
+ getOrCreateConversation: async () => conversation,
711
+ assistantEventHub: { publish: async () => {} } as any,
712
+ resolveAttachments: () => [],
713
+ },
714
+ }),
715
+ new Request("http://localhost/v1/messages", {
716
+ method: "POST",
717
+ headers: {
718
+ "Content-Type": "application/json",
719
+ "x-vellum-actor-principal-id": "real-jwt-principal",
720
+ "x-vellum-principal-type": "actor",
721
+ },
722
+ body: JSON.stringify({
723
+ conversationKey: "cu-attach-real-key",
724
+ content: "hi",
725
+ sourceChannel: "vellum",
726
+ interface: "web",
727
+ }),
728
+ }),
729
+ undefined,
730
+ 202,
731
+ );
732
+
733
+ const cuCall = hostProxyAttachCalls.find(
734
+ (c) => c.capability === "host_cu",
735
+ );
736
+ expect(cuCall?.sourceActorPrincipalId).toBe("real-jwt-principal");
737
+ });
738
+ });
@@ -64,15 +64,113 @@ mock.module("../runtime/approval-message-composer.js", () => ({
64
64
  composeApprovalMessageGenerative: async () => "mock generative message",
65
65
  }));
66
66
 
67
+ // Stub the gateway IPC so redemption claims + activation relays resolve
68
+ // deterministically without a running gateway socket.
69
+ const gatewayIpcCalls: Array<{
70
+ method: string;
71
+ params?: Record<string, unknown>;
72
+ }> = [];
73
+ mock.module("../ipc/gateway-client.js", () => ({
74
+ ipcCallPersistent: async (
75
+ method: string,
76
+ params?: Record<string, unknown>,
77
+ ) => {
78
+ gatewayIpcCalls.push({ method, params });
79
+ if (method === "contacts_get_rich") {
80
+ return richContactForId(params?.contactId as string);
81
+ }
82
+ if (method === "record_invite_redemption") {
83
+ return { ok: true, updated: true, mirrored: true };
84
+ }
85
+ if (method === "upsert_verified_channel") {
86
+ return { ok: true, verified: true };
87
+ }
88
+ return undefined;
89
+ },
90
+ }));
91
+
92
+ // Serves contacts_get_rich (the gateway ACL read backing the gate-status
93
+ // fallback) from the seeded local contact, so gate resolution sources status
94
+ // from the gateway path rather than the local channel column.
95
+ function richContactForId(contactId: string | undefined) {
96
+ if (!contactId) return undefined;
97
+ const contact = getContact(contactId);
98
+ if (!contact) return undefined;
99
+ // ACL columns live on the still-present DB rows, not the slimmed interfaces;
100
+ // read them raw to build the gateway-rich response the production read parses.
101
+ const contactRole = (
102
+ getSqlite()
103
+ .query("SELECT role FROM contacts WHERE id = ?")
104
+ .get(contact.id) as { role: string } | undefined
105
+ )?.role;
106
+ return {
107
+ ok: true,
108
+ contact: {
109
+ id: contact.id,
110
+ displayName: contact.displayName,
111
+ role: contactRole ?? "contact",
112
+ interactionCount: contact.interactionCount,
113
+ createdAt: contact.createdAt,
114
+ updatedAt: contact.updatedAt,
115
+ channels: contact.channels.map((c) => {
116
+ const acl = rawChannelAcl(c.id);
117
+ return {
118
+ id: c.id,
119
+ contactId: c.contactId,
120
+ type: c.type,
121
+ address: c.address,
122
+ isPrimary: c.isPrimary,
123
+ externalUserId: c.externalChatId,
124
+ status: acl.status,
125
+ policy: acl.policy,
126
+ verifiedAt: acl.verifiedAt,
127
+ verifiedVia: acl.verifiedVia,
128
+ lastSeenAt: acl.lastSeenAt,
129
+ interactionCount: acl.interactionCount,
130
+ lastInteraction: acl.lastInteraction,
131
+ revokedReason: acl.revokedReason,
132
+ blockedReason: acl.blockedReason,
133
+ };
134
+ }),
135
+ },
136
+ };
137
+ }
138
+
139
+ /** Read a channel's ACL columns straight off the still-present DB row. */
140
+ function rawChannelAcl(channelId: string) {
141
+ return getSqlite()
142
+ .query(
143
+ `SELECT status, policy, verified_at AS verifiedAt, verified_via AS verifiedVia,
144
+ last_seen_at AS lastSeenAt, interaction_count AS interactionCount,
145
+ last_interaction AS lastInteraction, revoked_reason AS revokedReason,
146
+ blocked_reason AS blockedReason
147
+ FROM contact_channels WHERE id = ?`,
148
+ )
149
+ .get(channelId) as {
150
+ status: string;
151
+ policy: string;
152
+ verifiedAt: number | null;
153
+ verifiedVia: string | null;
154
+ lastSeenAt: number | null;
155
+ interactionCount: number;
156
+ lastInteraction: number | null;
157
+ revokedReason: string | null;
158
+ blockedReason: string | null;
159
+ };
160
+ }
161
+
67
162
  import {
68
163
  findContactChannel,
164
+ getContact,
69
165
  upsertContact,
70
166
  } from "../contacts/contact-store.js";
71
- import { upsertContactChannel } from "../contacts/contacts-write.js";
72
- import { getDb } from "../memory/db-connection.js";
167
+ import { getDb, getSqlite } from "../memory/db-connection.js";
73
168
  import { initializeDb } from "../memory/db-init.js";
74
169
  import { createInvite, revokeInvite } from "../memory/invite-store.js";
75
- import { handleChannelInbound } from "./helpers/channel-test-adapter.js";
170
+ import {
171
+ handleChannelInbound,
172
+ seedContactChannel,
173
+ } from "./helpers/channel-test-adapter.js";
76
174
 
77
175
  await initializeDb();
78
176
 
@@ -98,6 +196,7 @@ function resetState(): void {
98
196
  db.run("DELETE FROM contacts");
99
197
  emitSignalCalls.length = 0;
100
198
  deliverReplyCalls.length = 0;
199
+ gatewayIpcCalls.length = 0;
101
200
  msgCounter = 0;
102
201
  }
103
202
 
@@ -169,13 +268,18 @@ describe("inbound invite redemption intercept", () => {
169
268
  expect(json.memberId).toEqual(expect.any(String));
170
269
  expect(json.denied).toBeUndefined();
171
270
 
172
- // Verify the user is now an active member
271
+ // The local mirror persists the member identity row; the gateway owns the
272
+ // active ACL verdict.
173
273
  const result = findContactChannel({
174
274
  channelType: "telegram",
175
275
  address: "user-invite-123",
176
276
  });
177
277
  expect(result).not.toBeNull();
178
- expect(result!.channel.status).toBe("active");
278
+
279
+ // The activation is written to the gateway via upsert_verified_channel.
280
+ expect(
281
+ gatewayIpcCalls.some((c) => c.method === "upsert_verified_channel"),
282
+ ).toBe(true);
179
283
 
180
284
  // Verify a welcome reply was delivered
181
285
  expect(deliverReplyCalls.length).toBe(1);
@@ -309,7 +413,7 @@ describe("inbound invite redemption intercept", () => {
309
413
 
310
414
  test("existing active member sending normal message is unaffected", async () => {
311
415
  // Pre-create an active member
312
- upsertContactChannel({
416
+ seedContactChannel({
313
417
  sourceChannel: "telegram",
314
418
  externalUserId: "user-active-member",
315
419
  externalChatId: "chat-active",
@@ -363,7 +467,7 @@ describe("inbound invite redemption intercept", () => {
363
467
  });
364
468
 
365
469
  // Pre-create an active member that will click the invite link
366
- upsertContactChannel({
470
+ seedContactChannel({
367
471
  sourceChannel: "telegram",
368
472
  externalUserId: "user-already-active",
369
473
  externalChatId: "chat-invite-test",
@@ -386,7 +490,7 @@ describe("inbound invite redemption intercept", () => {
386
490
  test("reactivation via invite preserves existing guardian-managed member display name", async () => {
387
491
  // Pre-create a revoked member named "Jeff" — the invite should preserve
388
492
  // that guardian-assigned name rather than overwriting with the Telegram name.
389
- upsertContactChannel({
493
+ seedContactChannel({
390
494
  sourceChannel: "telegram",
391
495
  externalUserId: "user-invite-123",
392
496
  externalChatId: "chat-invite-test",
@@ -395,7 +499,7 @@ describe("inbound invite redemption intercept", () => {
395
499
  displayName: "Jeff",
396
500
  });
397
501
 
398
- // Look up the contact that upsertContactChannel created so we can use
502
+ // Look up the contact that the seed created so we can use
399
503
  // its ID as the invite's contactId (satisfies the FK constraint).
400
504
  const existing = findContactChannel({
401
505
  channelType: "telegram",
@@ -425,7 +529,8 @@ describe("inbound invite redemption intercept", () => {
425
529
  externalChatId: "chat-invite-test",
426
530
  });
427
531
  expect(result).not.toBeNull();
428
- expect(result!.channel.status).toBe("active");
532
+ // The gateway owns reactivation; the local mirror preserves the
533
+ // guardian-assigned display name rather than the raw platform identity.
429
534
  expect(result!.contact.displayName).toBe("Jeff");
430
535
  });
431
536
  });
@@ -35,6 +35,8 @@ const addMessageCalls: Array<{
35
35
  }> = [];
36
36
 
37
37
  mock.module("../memory/conversation-crud.js", () => ({
38
+ setConversationProcessingStartedAt: () => {},
39
+ isConversationProcessing: () => false,
38
40
  addMessage: async (
39
41
  conversationId: string,
40
42
  role: string,