@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
@@ -173,9 +173,11 @@ describe("TwiML parameter propagation", () => {
173
173
  // ---------------------------------------------------------------------------
174
174
 
175
175
  describe("Call session mode metadata", () => {
176
+ // Cold DB init runs every migration; give it headroom over Bun's 5s default
177
+ // hook timeout so a loaded CI runner doesn't trip it.
176
178
  beforeEach(async () => {
177
179
  await initializeDb();
178
- });
180
+ }, 30_000);
179
181
 
180
182
  test("createCallSession persists callMode and verificationSessionId", async () => {
181
183
  // Dynamic import to avoid circular dependency issues
@@ -237,7 +239,7 @@ describe("Call session mode metadata", () => {
237
239
  describe("Verification control messages are deterministic (guard)", () => {
238
240
  beforeEach(async () => {
239
241
  await initializeDb();
240
- });
242
+ }, 30_000);
241
243
 
242
244
  test("handleChannelInbound does not call processMessage for /start gv_<token> bootstrap commands", async () => {
243
245
  const { createHash, randomBytes } = await import("node:crypto");
@@ -38,6 +38,7 @@ mock.module("../runtime/assistant-event-hub.js", () => ({
38
38
 
39
39
  const {
40
40
  DISK_PRESSURE_CLEAR_THRESHOLD_PERCENT,
41
+ DISK_PRESSURE_MIN_FREE_FLOOR_MB,
41
42
  DISK_PRESSURE_OVERRIDE_CONFIRMATION,
42
43
  DISK_PRESSURE_THRESHOLD_PERCENT,
43
44
  DISK_PRESSURE_WARNING_CLEAR_THRESHOLD_PERCENT,
@@ -342,4 +343,44 @@ describe("disk pressure guard", () => {
342
343
  setDiskUsage(DISK_PRESSURE_WARNING_CLEAR_THRESHOLD_PERCENT - 1);
343
344
  expect(evaluateDiskPressureNow().state).toBe("ok");
344
345
  });
346
+
347
+ test("stays ok at a critical usage percentage while ample free space remains", () => {
348
+ // 99% used of a large volume still leaves gigabytes free — above the floor.
349
+ const totalMb = 1_000_000;
350
+ const usedMb = Math.round(totalMb * 0.99); // freeMb ~= 10_000 MiB
351
+ setDiskUsage(usedMb, totalMb);
352
+ expect(diskSample!.freeMb).toBeGreaterThanOrEqual(
353
+ DISK_PRESSURE_MIN_FREE_FLOOR_MB,
354
+ );
355
+
356
+ const status = evaluateDiskPressureNow();
357
+
358
+ expect(status.state).toBe("ok");
359
+ expect(status.locked).toBe(false);
360
+ expect(status.effectivelyLocked).toBe(false);
361
+ });
362
+
363
+ test("stays ok at a warning usage percentage while ample free space remains", () => {
364
+ const totalMb = 1_000_000;
365
+ const usedMb = Math.round(totalMb * 0.85); // 85% used, freeMb ~= 150_000 MiB
366
+ setDiskUsage(usedMb, totalMb);
367
+
368
+ const status = evaluateDiskPressureNow();
369
+
370
+ expect(status.state).toBe("ok");
371
+ });
372
+
373
+ test("locks at a critical usage percentage once free space drops below the floor", () => {
374
+ // High percentage AND little absolute headroom: floor does not apply.
375
+ const totalMb = 100_000;
376
+ const freeMb = DISK_PRESSURE_MIN_FREE_FLOOR_MB - 1;
377
+ setDiskUsage(totalMb - freeMb, totalMb);
378
+ expect(diskSample!.freeMb).toBeLessThan(DISK_PRESSURE_MIN_FREE_FLOOR_MB);
379
+
380
+ const status = evaluateDiskPressureNow();
381
+
382
+ expect(status.state).toBe("critical");
383
+ expect(status.locked).toBe(true);
384
+ expect(status.effectivelyLocked).toBe(true);
385
+ });
345
386
  });
@@ -78,7 +78,6 @@ import {
78
78
  saveRawConfig,
79
79
  setNestedValue,
80
80
  } from "../config/loader.js";
81
- import { upsertContactChannel } from "../contacts/contacts-write.js";
82
81
  import { getDb } from "../memory/db-connection.js";
83
82
  import { initializeDb } from "../memory/db-init.js";
84
83
  import { messages } from "../memory/schema/conversations.js";
@@ -86,7 +85,10 @@ import {
86
85
  readSlackMetadata,
87
86
  type SlackMessageMetadata,
88
87
  } from "../messaging/providers/slack/message-metadata.js";
89
- import { handleChannelInbound } from "./helpers/channel-test-adapter.js";
88
+ import {
89
+ handleChannelInbound,
90
+ seedContactChannel,
91
+ } from "./helpers/channel-test-adapter.js";
90
92
 
91
93
  await initializeDb();
92
94
 
@@ -117,7 +119,7 @@ function setConfiguredSlackBotUserId(botUserId: string): void {
117
119
  }
118
120
 
119
121
  function seedActiveMember(): void {
120
- upsertContactChannel({
122
+ seedContactChannel({
121
123
  sourceChannel: "slack",
122
124
  externalUserId: SLACK_DM_USER_ID,
123
125
  externalChatId: SLACK_DM_CHANNEL_ID,
@@ -128,7 +130,7 @@ function seedActiveMember(): void {
128
130
  }
129
131
 
130
132
  function seedSlackGuardian(): void {
131
- upsertContactChannel({
133
+ seedContactChannel({
132
134
  sourceChannel: "slack",
133
135
  externalUserId: SLACK_DM_USER_ID,
134
136
  externalChatId: SLACK_DM_CHANNEL_ID,
@@ -30,6 +30,8 @@ const addMessageCalls: Array<{
30
30
  }> = [];
31
31
 
32
32
  mock.module("../memory/conversation-crud.js", () => ({
33
+ setConversationProcessingStartedAt: () => {},
34
+ isConversationProcessing: () => false,
33
35
  addMessage: async (
34
36
  conversationId: string,
35
37
  role: string,
@@ -19,14 +19,15 @@ mock.module("../channels/config.js", () => ({
19
19
  getDeliverableChannels: () => ["vellum", "telegram"],
20
20
  }));
21
21
 
22
- mock.module("../contacts/contact-store.js", () => ({
23
- findGuardianForChannel: (_channelType: string, _assistantId: string) => null,
22
+ // Guardian connectivity is resolved from the gateway pull. No active guardian
23
+ // binding ⇒ binding-based channels (telegram) are not reported connected.
24
+ // Guardian connectivity resolves solely from the gateway delivery; an empty
25
+ // list ⇒ telegram stays disconnected.
26
+ mock.module("../contacts/guardian-delivery-reader.js", () => ({
27
+ getGuardianDelivery: async () => [],
28
+ guardianForChannel: () => undefined,
24
29
  }));
25
30
 
26
- // Note: stale mock for channel-guardian-store.js removed — the barrel was
27
- // deleted and none of the functions it mocked (getActiveBinding) existed in
28
- // the barrel.
29
-
30
31
  mock.module("../notifications/adapters/macos.js", () => ({
31
32
  VellumAdapter: class {
32
33
  constructor(_broadcastFn: unknown) {}
@@ -29,7 +29,13 @@ mock.module("../config/env.js", () => ({
29
29
  }));
30
30
 
31
31
  mock.module("../runtime/local-actor-identity.js", () => ({
32
- findLocalGuardianPrincipalId: () => fakeGuardianPrincipalId,
32
+ findLocalGuardianPrincipalIdFromStore: () => fakeGuardianPrincipalId,
33
+ resolveActorPrincipalIdForLocalGuardianSync: (
34
+ rawHeader: string | undefined,
35
+ ) => {
36
+ if (rawHeader !== "dev-bypass" || !fakeHttpAuthDisabled) return rawHeader;
37
+ return fakeGuardianPrincipalId;
38
+ },
33
39
  }));
34
40
 
35
41
  mock.module("../util/logger.js", () => ({
@@ -225,10 +225,11 @@ describe("exploration-drift post-tool-use hook — long-dig trigger", () => {
225
225
  expect(ctx.toolResponse.content).toBe(BASE_CONTENT);
226
226
  });
227
227
 
228
- test("counts file_read and file_list as exploration tools", async () => {
228
+ test("counts code_search, file_read, and file_list as exploration tools", async () => {
229
+ const explorationNames = ["code_search", "file_read", "file_list"];
229
230
  const messages: Message[] = [];
230
231
  for (let i = 0; i < EXPLORATION_NUDGE_THRESHOLD - 1; i++) {
231
- const name = i % 2 === 0 ? "file_read" : "file_list";
232
+ const name = explorationNames[i % explorationNames.length];
232
233
  const id = `${name}-${i}`;
233
234
  messages.push(toolUseTurn(id, name, { path: `/tmp/file-${i}` }));
234
235
  messages.push(toolResultTurn(id));
@@ -51,6 +51,8 @@ const createdConversations: Array<{
51
51
  let conversationIdCounter = 0;
52
52
 
53
53
  mock.module("../memory/conversation-crud.js", () => ({
54
+ setConversationProcessingStartedAt: () => {},
55
+ isConversationProcessing: () => false,
54
56
  setConversationOriginChannelIfUnset: () => {},
55
57
  updateConversationContextWindow: () => {},
56
58
  deleteMessageById: () => {},
@@ -7,7 +7,17 @@ mock.module("../util/logger.js", () => ({
7
7
  }),
8
8
  }));
9
9
 
10
- import { findGuardianForChannel } from "../contacts/contact-store.js";
10
+ import type { GuardianDelivery } from "@vellumai/gateway-client";
11
+
12
+ let mockGuardians: GuardianDelivery[] | null = [];
13
+
14
+ mock.module("../contacts/guardian-delivery-reader.js", () => ({
15
+ getGuardianDelivery: async () => mockGuardians,
16
+ guardianForChannel: (list: GuardianDelivery[], channelType: string) =>
17
+ list.find((g) => g.channelType === channelType && g.status === "active"),
18
+ }));
19
+
20
+ import { findContactByAddress } from "../contacts/contact-store.js";
11
21
  import { getDb } from "../memory/db-connection.js";
12
22
  import { initializeDb } from "../memory/db-init.js";
13
23
  import { healGuardianBindingDrift } from "../runtime/guardian-vellum-migration.js";
@@ -21,12 +31,38 @@ function resetTables(): void {
21
31
  db.run("DELETE FROM contacts");
22
32
  }
23
33
 
34
+ /**
35
+ * Gateway delivery for the vellum guardian. `principalId` is the gateway-owned
36
+ * binding principal; `address` is the local channel address the heal resolves
37
+ * its write target by (defaults to the principal for same-principal bindings).
38
+ */
39
+ function gatewayGuardian(
40
+ principalId: string,
41
+ address: string = principalId,
42
+ ): GuardianDelivery {
43
+ return {
44
+ channelType: "vellum",
45
+ contactId: "guardian-contact",
46
+ principalId,
47
+ address,
48
+ status: "active",
49
+ };
50
+ }
51
+
52
+ /** Read the local vellum guardian channel/contact by its channel address. */
53
+ function localVellumGuardian(address: string) {
54
+ const contact = findContactByAddress("vellum", address);
55
+ const channel = contact?.channels.find((c) => c.type === "vellum");
56
+ return contact && channel ? { contact, channel } : null;
57
+ }
58
+
24
59
  describe("healGuardianBindingDrift", () => {
25
60
  beforeEach(() => {
26
61
  resetTables();
62
+ mockGuardians = [];
27
63
  });
28
64
 
29
- test("heals drift when both principals have vellum-principal- prefix", () => {
65
+ test("heals drift when both principals have vellum-principal- prefix", async () => {
30
66
  // Simulate DB reset: new guardian binding with a different UUID
31
67
  createGuardianBinding({
32
68
  channel: "vellum",
@@ -35,19 +71,47 @@ describe("healGuardianBindingDrift", () => {
35
71
  guardianPrincipalId: "vellum-principal-new-uuid",
36
72
  verifiedVia: "startup-migration",
37
73
  });
74
+ mockGuardians = [gatewayGuardian("vellum-principal-new-uuid")];
38
75
 
39
76
  // Client arrives with the old JWT principal
40
- const healed = healGuardianBindingDrift("vellum-principal-old-uuid");
77
+ const healed = await healGuardianBindingDrift("vellum-principal-old-uuid");
41
78
  expect(healed).toBe(true);
42
79
 
43
- // Guardian binding now matches the old JWT
44
- const guardian = findGuardianForChannel("vellum");
80
+ // The heal repairs the channel identity address to match the JWT. The
81
+ // principalId column is gateway-owned and no longer written locally.
82
+ const guardian = localVellumGuardian("vellum-principal-old-uuid");
45
83
  expect(guardian).not.toBeNull();
46
- expect(guardian!.contact.principalId).toBe("vellum-principal-old-uuid");
47
84
  expect(guardian!.channel.address).toBe("vellum-principal-old-uuid");
48
85
  });
49
86
 
50
- test("no-op when principals already match", () => {
87
+ test("repairs the local mirror toward the JWT when the gateway diverges", async () => {
88
+ // Gateway principal diverges from the incoming JWT — the drift signal. The
89
+ // /v1/messages trust path still reads the local mirror in this plan, so the
90
+ // mirror is repaired toward the JWT or the actor stays `unknown`.
91
+ createGuardianBinding({
92
+ channel: "vellum",
93
+ guardianExternalUserId: "vellum-principal-stale-local",
94
+ guardianDeliveryChatId: "local",
95
+ guardianPrincipalId: "vellum-principal-stale-local",
96
+ verifiedVia: "startup-migration",
97
+ });
98
+ // Gateway address matches the local channel address so the heal can resolve
99
+ // its local write target; only the gateway principal has drifted.
100
+ mockGuardians = [
101
+ gatewayGuardian("vellum-principal-gateway", "vellum-principal-stale-local"),
102
+ ];
103
+
104
+ const healed = await healGuardianBindingDrift("vellum-principal-jwt");
105
+ expect(healed).toBe(true);
106
+
107
+ // The local mirror's identity address now matches the JWT, so a subsequent
108
+ // local trust resolution classifies the actor as guardian rather than
109
+ // unknown. The principalId column is gateway-owned and not written locally.
110
+ const guardian = localVellumGuardian("vellum-principal-jwt");
111
+ expect(guardian!.channel.address).toBe("vellum-principal-jwt");
112
+ });
113
+
114
+ test("no-op when principals already match", async () => {
51
115
  createGuardianBinding({
52
116
  channel: "vellum",
53
117
  guardianExternalUserId: "vellum-principal-same",
@@ -55,12 +119,13 @@ describe("healGuardianBindingDrift", () => {
55
119
  guardianPrincipalId: "vellum-principal-same",
56
120
  verifiedVia: "startup-migration",
57
121
  });
122
+ mockGuardians = [gatewayGuardian("vellum-principal-same")];
58
123
 
59
- const healed = healGuardianBindingDrift("vellum-principal-same");
124
+ const healed = await healGuardianBindingDrift("vellum-principal-same");
60
125
  expect(healed).toBe(false);
61
126
  });
62
127
 
63
- test("refuses to heal when incoming principal lacks vellum-principal- prefix", () => {
128
+ test("refuses to heal when incoming principal lacks vellum-principal- prefix", async () => {
64
129
  createGuardianBinding({
65
130
  channel: "vellum",
66
131
  guardianExternalUserId: "vellum-principal-aaa",
@@ -68,17 +133,19 @@ describe("healGuardianBindingDrift", () => {
68
133
  guardianPrincipalId: "vellum-principal-aaa",
69
134
  verifiedVia: "startup-migration",
70
135
  });
136
+ mockGuardians = [gatewayGuardian("vellum-principal-aaa")];
71
137
 
72
138
  // External/platform principal — should NOT be adopted
73
- const healed = healGuardianBindingDrift("platform-user-12345");
139
+ const healed = await healGuardianBindingDrift("platform-user-12345");
74
140
  expect(healed).toBe(false);
75
141
 
76
- // Guardian unchanged
77
- const guardian = findGuardianForChannel("vellum");
78
- expect(guardian!.contact.principalId).toBe("vellum-principal-aaa");
142
+ // Guardian unchanged: the local channel identity address still resolves to
143
+ // the original binding (principalId is gateway-owned, no longer local).
144
+ const guardian = localVellumGuardian("vellum-principal-aaa");
145
+ expect(guardian!.channel.address).toBe("vellum-principal-aaa");
79
146
  });
80
147
 
81
- test("refuses to heal when stored principal lacks vellum-principal- prefix", () => {
148
+ test("refuses to heal when the gateway principal lacks vellum-principal- prefix", async () => {
82
149
  createGuardianBinding({
83
150
  channel: "vellum",
84
151
  guardianExternalUserId: "verified-phone-guardian",
@@ -86,17 +153,35 @@ describe("healGuardianBindingDrift", () => {
86
153
  guardianPrincipalId: "verified-phone-guardian",
87
154
  verifiedVia: "challenge",
88
155
  });
156
+ mockGuardians = [gatewayGuardian("verified-phone-guardian")];
89
157
 
90
158
  // Even with a vellum-principal- incoming, don't overwrite a real binding
91
- const healed = healGuardianBindingDrift("vellum-principal-attacker");
159
+ const healed = await healGuardianBindingDrift("vellum-principal-attacker");
92
160
  expect(healed).toBe(false);
93
161
 
94
- const guardian = findGuardianForChannel("vellum");
95
- expect(guardian!.contact.principalId).toBe("verified-phone-guardian");
162
+ // Guardian unchanged: the local channel identity address still resolves to
163
+ // the original binding (principalId is gateway-owned, no longer local).
164
+ const guardian = localVellumGuardian("verified-phone-guardian");
165
+ expect(guardian!.channel.address).toBe("verified-phone-guardian");
96
166
  });
97
167
 
98
- test("returns false when no guardian binding exists", () => {
99
- const healed = healGuardianBindingDrift("vellum-principal-orphan");
168
+ test("returns false when gateway reports no guardian binding", async () => {
169
+ mockGuardians = [];
170
+ const healed = await healGuardianBindingDrift("vellum-principal-orphan");
171
+ expect(healed).toBe(false);
172
+ });
173
+
174
+ test("returns false when the gateway is unreachable (null list)", async () => {
175
+ createGuardianBinding({
176
+ channel: "vellum",
177
+ guardianExternalUserId: "vellum-principal-aaa",
178
+ guardianDeliveryChatId: "local",
179
+ guardianPrincipalId: "vellum-principal-aaa",
180
+ verifiedVia: "startup-migration",
181
+ });
182
+ mockGuardians = null;
183
+
184
+ const healed = await healGuardianBindingDrift("vellum-principal-old-uuid");
100
185
  expect(healed).toBe(false);
101
186
  });
102
187
  });
@@ -24,6 +24,56 @@ mock.module("../config/loader.js", () => ({
24
24
  }),
25
25
  }));
26
26
 
27
+ // The pending_question request principal is resolved via the gateway guardian
28
+ // delivery for the vellum channel — the SAME source the Vellum actor uses — so
29
+ // the stamped principal always equals the submitting actor principal. The real
30
+ // contacts DB is seeded in resetTables(); the reader mock below derives the
31
+ // gateway delivery from that DB binding so tests model drift / missing guardian
32
+ // by reseeding or clearing the local binding directly.
33
+ mock.module("../contacts/guardian-delivery-reader.js", () => ({
34
+ getGuardianDelivery: async (input?: { channelTypes?: string[] }) => {
35
+ const { getDb } = await import("../memory/db-connection.js");
36
+ const { contacts, contactChannels } = await import("../memory/schema.js");
37
+ const { and, eq } = await import("drizzle-orm");
38
+ const channels = input?.channelTypes ?? [];
39
+ return channels
40
+ .map((channelType) => {
41
+ const row = getDb()
42
+ .select({ contact: contacts, channel: contactChannels })
43
+ .from(contacts)
44
+ .innerJoin(
45
+ contactChannels,
46
+ eq(contacts.id, contactChannels.contactId),
47
+ )
48
+ .where(
49
+ and(
50
+ eq(contacts.role, "guardian"),
51
+ eq(contactChannels.type, channelType),
52
+ eq(contactChannels.status, "active"),
53
+ ),
54
+ )
55
+ .get();
56
+ if (!row) return null;
57
+ return {
58
+ channelType,
59
+ contactId: row.contact.id,
60
+ principalId: row.contact.principalId ?? null,
61
+ displayName: row.contact.displayName ?? null,
62
+ address: row.channel.address,
63
+ externalChatId: row.channel.externalChatId ?? null,
64
+ status: "active",
65
+ verifiedAt: row.channel.verifiedAt ?? null,
66
+ };
67
+ })
68
+ .filter((g) => g !== null);
69
+ },
70
+ guardianForChannel: (
71
+ list: Array<{ channelType: string; status: string }>,
72
+ channelType: string,
73
+ ) =>
74
+ list.find((g) => g.channelType === channelType && g.status === "active"),
75
+ }));
76
+
27
77
  const emitCalls: unknown[] = [];
28
78
  let conversationCreatedFromMock: ConversationCreatedInfo | null = null;
29
79
  let mockEmitResult: {
@@ -154,11 +204,18 @@ describe("guardian-dispatch", () => {
154
204
  "SELECT * FROM canonical_guardian_requests WHERE call_session_id = ?",
155
205
  )
156
206
  .get(session.id) as
157
- | { id: string; status: string; question_text: string }
207
+ | {
208
+ id: string;
209
+ status: string;
210
+ question_text: string;
211
+ guardian_principal_id: string | null;
212
+ }
158
213
  | undefined;
159
214
  expect(request).toBeDefined();
160
215
  expect(request!.status).toBe("pending");
161
216
  expect(request!.question_text).toBe("What is the gate code?");
217
+ // principalId comes from the local guardian binding (same source the actor submits)
218
+ expect(request!.guardian_principal_id).toBe("test-principal-id");
162
219
 
163
220
  const vellumDelivery = raw
164
221
  .query(
@@ -175,6 +232,88 @@ describe("guardian-dispatch", () => {
175
232
  expect(typeof signalParams.onConversationCreated).toBe("function");
176
233
  });
177
234
 
235
+ test("stamps the request principal from the local source the actor submits, not the (possibly drifted) gateway binding", async () => {
236
+ // Simulate gateway/local binding drift: the local guardian binding (the
237
+ // source the actor submit path reads) carries a different principal than
238
+ // the gateway would. The request must be stamped with that local value so
239
+ // a later actor submission matches (no identity_mismatch under drift).
240
+ const db = getDb();
241
+ db.run("DELETE FROM contact_channels");
242
+ db.run("DELETE FROM contacts");
243
+ createGuardianBinding({
244
+ channel: "vellum",
245
+ guardianExternalUserId: "local-actor-principal",
246
+ guardianDeliveryChatId: "local",
247
+ guardianPrincipalId: "local-actor-principal",
248
+ verifiedVia: "bootstrap",
249
+ });
250
+
251
+ const convId = "conv-dispatch-drift";
252
+ ensureConversation(convId);
253
+
254
+ const session = createCallSession({
255
+ conversationId: convId,
256
+ provider: "twilio",
257
+ fromNumber: "+15550001111",
258
+ toNumber: "+15550002222",
259
+ });
260
+ const pq = createPendingQuestion(session.id, "Drifted bindings?");
261
+
262
+ await dispatchGuardianQuestion({
263
+ callSessionId: session.id,
264
+ conversationId: convId,
265
+ assistantId: "self",
266
+ pendingQuestion: pq,
267
+ });
268
+
269
+ const raw = (db as unknown as { $client: import("bun:sqlite").Database })
270
+ .$client;
271
+ const request = raw
272
+ .query(
273
+ "SELECT * FROM canonical_guardian_requests WHERE call_session_id = ?",
274
+ )
275
+ .get(session.id) as
276
+ | { guardian_principal_id: string | null }
277
+ | undefined;
278
+ expect(request).toBeDefined();
279
+ expect(request!.guardian_principal_id).toBe("local-actor-principal");
280
+ });
281
+
282
+ test("skips dispatch when no local guardian binding exists (no principal to stamp)", async () => {
283
+ const db = getDb();
284
+ db.run("DELETE FROM contact_channels");
285
+ db.run("DELETE FROM contacts");
286
+
287
+ const convId = "conv-dispatch-no-principal";
288
+ ensureConversation(convId);
289
+
290
+ const session = createCallSession({
291
+ conversationId: convId,
292
+ provider: "twilio",
293
+ fromNumber: "+15550001111",
294
+ toNumber: "+15550002222",
295
+ });
296
+ const pq = createPendingQuestion(session.id, "No principal available");
297
+
298
+ await dispatchGuardianQuestion({
299
+ callSessionId: session.id,
300
+ conversationId: convId,
301
+ assistantId: "self",
302
+ pendingQuestion: pq,
303
+ });
304
+
305
+ // No request is created and the pipeline is never invoked.
306
+ const raw = (db as unknown as { $client: import("bun:sqlite").Database })
307
+ .$client;
308
+ const request = raw
309
+ .query(
310
+ "SELECT * FROM canonical_guardian_requests WHERE call_session_id = ?",
311
+ )
312
+ .get(session.id) as { id: string } | null;
313
+ expect(request).toBeNull();
314
+ expect(emitCalls).toHaveLength(0);
315
+ });
316
+
178
317
  test("creates a telegram guardian delivery with binding metadata when pipeline sends telegram", async () => {
179
318
  const convId = "conv-dispatch-2";
180
319
  ensureConversation(convId);