@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
@@ -14,6 +14,14 @@ const gatewayIpc = {
14
14
  mirrored: boolean;
15
15
  },
16
16
  claimThrows: false,
17
+ // When set, contacts_get_rich throws (gateway read unreachable) so the
18
+ // gate-status fallback must fail open.
19
+ richThrows: false,
20
+ // When set, overrides the contacts_get_rich response (e.g. a gateway row
21
+ // under a divergent UUID for the same (type,address)).
22
+ richOverride: null as ((contactId: string | undefined) => unknown) | null,
23
+ // Drives the upsert_verified_channel relay verdict; false refuses the actor.
24
+ activationVerified: true,
17
25
  calls: [] as { method: string; params?: Record<string, unknown> }[],
18
26
  };
19
27
 
@@ -23,17 +31,112 @@ mock.module("../ipc/gateway-client.js", () => ({
23
31
  params?: Record<string, unknown>,
24
32
  ) => {
25
33
  gatewayIpc.calls.push({ method, params });
34
+ if (method === "contacts_get_rich") {
35
+ if (gatewayIpc.richThrows) throw new Error("gateway read unreachable");
36
+ if (gatewayIpc.richOverride) {
37
+ return gatewayIpc.richOverride(params?.contactId as string);
38
+ }
39
+ return richContactForId(params?.contactId as string);
40
+ }
26
41
  if (method === "record_invite_redemption") {
27
42
  if (gatewayIpc.claimThrows) throw new Error("gateway unreachable");
28
43
  return gatewayIpc.claim;
29
44
  }
45
+ if (method === "upsert_verified_channel") {
46
+ if (!gatewayIpc.activationVerified) {
47
+ return { ok: true, verified: false };
48
+ }
49
+ return { ok: true, verified: true };
50
+ }
30
51
  return undefined;
31
52
  },
32
53
  }));
33
54
 
55
+ // Serves contacts_get_rich (the gateway ACL read backing the gate-status
56
+ // fallback) from the seeded local contact, so gate resolution sources status
57
+ // from the gateway path rather than the local channel column.
58
+ function richContactForId(contactId: string | undefined) {
59
+ if (!contactId) return undefined;
60
+ const contact = getContact(contactId);
61
+ if (!contact) return undefined;
62
+ // ACL columns live on the still-present DB rows, not the slimmed interfaces;
63
+ // read them raw to build the gateway-rich response the production read parses.
64
+ const contactRole = (
65
+ getSqlite()
66
+ .query("SELECT role FROM contacts WHERE id = ?")
67
+ .get(contact.id) as { role: string } | undefined
68
+ )?.role;
69
+ return {
70
+ ok: true,
71
+ contact: {
72
+ id: contact.id,
73
+ displayName: contact.displayName,
74
+ role: contactRole ?? "contact",
75
+ interactionCount: contact.interactionCount,
76
+ createdAt: contact.createdAt,
77
+ updatedAt: contact.updatedAt,
78
+ channels: contact.channels.map((c) => {
79
+ const acl = rawChannelAcl(c.id);
80
+ return {
81
+ id: c.id,
82
+ contactId: c.contactId,
83
+ type: c.type,
84
+ address: c.address,
85
+ isPrimary: c.isPrimary,
86
+ externalUserId: c.externalChatId,
87
+ status: acl.status,
88
+ policy: acl.policy,
89
+ verifiedAt: acl.verifiedAt,
90
+ verifiedVia: acl.verifiedVia,
91
+ lastSeenAt: acl.lastSeenAt,
92
+ interactionCount: acl.interactionCount,
93
+ lastInteraction: acl.lastInteraction,
94
+ revokedReason: acl.revokedReason,
95
+ blockedReason: acl.blockedReason,
96
+ };
97
+ }),
98
+ },
99
+ };
100
+ }
101
+
102
+ /** Read a channel's ACL columns straight off the still-present DB row. */
103
+ function rawChannelAcl(channelId: string) {
104
+ return getSqlite()
105
+ .query(
106
+ `SELECT status, policy, verified_at AS verifiedAt, verified_via AS verifiedVia,
107
+ last_seen_at AS lastSeenAt, interaction_count AS interactionCount,
108
+ last_interaction AS lastInteraction, revoked_reason AS revokedReason,
109
+ blocked_reason AS blockedReason
110
+ FROM contact_channels WHERE id = ?`,
111
+ )
112
+ .get(channelId) as {
113
+ status: string;
114
+ policy: string;
115
+ verifiedAt: number | null;
116
+ verifiedVia: string | null;
117
+ lastSeenAt: number | null;
118
+ interactionCount: number;
119
+ lastInteraction: number | null;
120
+ revokedReason: string | null;
121
+ blockedReason: string | null;
122
+ };
123
+ }
124
+
125
+ /** Read a contact's local role column (dropped from the Contact interface). */
126
+ function localContactRole(contactId: string): string | undefined {
127
+ return (
128
+ getSqlite()
129
+ .query("SELECT role FROM contacts WHERE id = ?")
130
+ .get(contactId) as { role: string } | undefined
131
+ )?.role;
132
+ }
133
+
34
134
  function resetGatewayIpc() {
35
135
  gatewayIpc.claim = { ok: true, updated: true, mirrored: true };
36
136
  gatewayIpc.claimThrows = false;
137
+ gatewayIpc.richThrows = false;
138
+ gatewayIpc.richOverride = null;
139
+ gatewayIpc.activationVerified = true;
37
140
  gatewayIpc.calls = [];
38
141
  }
39
142
 
@@ -42,12 +145,12 @@ import {
42
145
  getContact,
43
146
  upsertContact,
44
147
  } from "../contacts/contact-store.js";
45
- import { upsertContactChannel } from "../contacts/contacts-write.js";
46
148
  import { getSqlite } from "../memory/db-connection.js";
47
149
  import { initializeDb } from "../memory/db-init.js";
48
150
  import { createInvite, revokeInvite } from "../memory/invite-store.js";
49
151
  import { redeemVoiceInviteCode } from "../runtime/invite-redemption-service.js";
50
152
  import { generateVoiceCode, hashVoiceCode } from "../util/voice-code.js";
153
+ import { seedContactChannel } from "./helpers/seed-contact-channel.js";
51
154
 
52
155
  await initializeDb();
53
156
 
@@ -204,6 +307,13 @@ describe("redeemVoiceInviteCode", () => {
204
307
  );
205
308
  expect(claim).toBeDefined();
206
309
  expect(claim!.params).toMatchObject({ redeemedByExternalUserId: phone });
310
+
311
+ // The activation is written to the gateway via upsert_verified_channel.
312
+ const upsert = gatewayIpc.calls.find(
313
+ (c) => c.method === "upsert_verified_channel",
314
+ );
315
+ expect(upsert).toBeDefined();
316
+ expect(upsert!.params).toMatchObject({ type: "phone", address: phone });
207
317
  });
208
318
 
209
319
  test("rejects voice redemption when the gateway claim is not consumable (no mutation)", async () => {
@@ -223,6 +333,23 @@ describe("redeemVoiceInviteCode", () => {
223
333
  expect(findContactChannel({ channelType: "phone", address: phone })).toBeNull();
224
334
  });
225
335
 
336
+ test("returns invalid_or_expired (no throw) when the gateway refuses the activation", async () => {
337
+ const phone = "+15551234567";
338
+ const { code } = createVoiceInvite({ callerPhone: phone });
339
+
340
+ // Gateway claim consumes the row, then refuses the channel activation
341
+ // (blocked/revoked actor). The branch returns its generic failure, not a 500.
342
+ gatewayIpc.activationVerified = false;
343
+
344
+ const result = await redeemVoiceInviteCode({
345
+ callerExternalUserId: phone,
346
+ sourceChannel: "phone",
347
+ code,
348
+ });
349
+
350
+ expect(result).toEqual({ ok: false, reason: "invalid_or_expired" });
351
+ });
352
+
226
353
  test("proceeds for a legacy voice invite the gateway has never seen (mirrored:false)", async () => {
227
354
  const phone = "+15551234567";
228
355
  const { code } = createVoiceInvite({ callerPhone: phone });
@@ -259,6 +386,83 @@ describe("redeemVoiceInviteCode", () => {
259
386
  ).not.toBeNull();
260
387
  });
261
388
 
389
+ test("matches an active member by (type,address) when the gateway row has a divergent uuid", async () => {
390
+ const phone = "+15551234567";
391
+ const member = seedContactChannel({
392
+ sourceChannel: "phone",
393
+ externalUserId: phone,
394
+ status: "active",
395
+ });
396
+ const { code } = createVoiceInvite({
397
+ callerPhone: phone,
398
+ contactId: member.contactId,
399
+ });
400
+
401
+ // Gateway row for the same (type,address) under a DIFFERENT id.
402
+ gatewayIpc.richOverride = () => ({
403
+ ok: true,
404
+ contact: {
405
+ id: member.contactId,
406
+ displayName: phone,
407
+ role: "contact",
408
+ interactionCount: 0,
409
+ createdAt: 1,
410
+ updatedAt: 1,
411
+ channels: [
412
+ {
413
+ id: "gateway-divergent-uuid",
414
+ contactId: member.contactId,
415
+ type: "phone",
416
+ address: phone,
417
+ isPrimary: false,
418
+ externalUserId: null,
419
+ status: "active",
420
+ policy: "allow",
421
+ verifiedAt: 1,
422
+ verifiedVia: "invite",
423
+ lastSeenAt: null,
424
+ interactionCount: 0,
425
+ lastInteraction: null,
426
+ revokedReason: null,
427
+ blockedReason: null,
428
+ },
429
+ ],
430
+ },
431
+ });
432
+
433
+ const result = await redeemVoiceInviteCode({
434
+ callerExternalUserId: phone,
435
+ sourceChannel: "phone",
436
+ code,
437
+ });
438
+
439
+ expect(result.ok).toBe(true);
440
+ expect((result as { type: string }).type).toBe("already_member");
441
+ });
442
+
443
+ test("fails open (no throw) when the gateway gate-status read is unreachable", async () => {
444
+ const phone = "+15551234567";
445
+ const member = seedContactChannel({
446
+ sourceChannel: "phone",
447
+ externalUserId: phone,
448
+ status: "revoked",
449
+ });
450
+ const { code } = createVoiceInvite({
451
+ callerPhone: phone,
452
+ contactId: member.contactId,
453
+ });
454
+
455
+ gatewayIpc.richThrows = true;
456
+
457
+ const result = await redeemVoiceInviteCode({
458
+ callerExternalUserId: phone,
459
+ sourceChannel: "phone",
460
+ code,
461
+ });
462
+
463
+ expect(result.ok).toBe(true);
464
+ });
465
+
262
466
  test("marks channel as verified via invite on voice redemption", async () => {
263
467
  const phone = "+15551234567";
264
468
  const { code } = createVoiceInvite({ callerPhone: phone });
@@ -271,15 +475,12 @@ describe("redeemVoiceInviteCode", () => {
271
475
 
272
476
  expect(result.ok).toBe(true);
273
477
 
478
+ // The gateway owns the verified ACL verdict; the local mirror is identity-only.
274
479
  const channelResult = findContactChannel({
275
480
  channelType: "phone",
276
481
  address: phone,
277
482
  });
278
-
279
483
  expect(channelResult).not.toBeNull();
280
- expect(channelResult!.channel.verifiedAt).toBeGreaterThan(0);
281
- expect(channelResult!.channel.verifiedVia).toBe("invite");
282
- expect(channelResult!.channel.status).toBe("active");
283
484
  });
284
485
 
285
486
  test("wrong caller identity fails with generic error", async () => {
@@ -387,7 +588,7 @@ describe("redeemVoiceInviteCode", () => {
387
588
  const phone = "+15551234567";
388
589
 
389
590
  // Pre-create an active member for this phone on voice channel
390
- const member = upsertContactChannel({
591
+ const member = seedContactChannel({
391
592
  sourceChannel: "phone",
392
593
  externalUserId: phone,
393
594
  status: "active",
@@ -397,7 +598,7 @@ describe("redeemVoiceInviteCode", () => {
397
598
  // Create a voice invite targeting the same contact that owns the channel
398
599
  const { code } = createVoiceInvite({
399
600
  callerPhone: phone,
400
- contactId: member!.contact.id,
601
+ contactId: member.contactId,
401
602
  });
402
603
 
403
604
  const result = await redeemVoiceInviteCode({
@@ -423,7 +624,7 @@ describe("redeemVoiceInviteCode", () => {
423
624
  const phone = "+15551234567";
424
625
 
425
626
  // Pre-create a blocked member and find their contact
426
- const member = upsertContactChannel({
627
+ const member = seedContactChannel({
427
628
  sourceChannel: "phone",
428
629
  externalUserId: phone,
429
630
  status: "blocked",
@@ -433,7 +634,7 @@ describe("redeemVoiceInviteCode", () => {
433
634
  // Create a voice invite targeting the same contact that owns the channel
434
635
  const { code } = createVoiceInvite({
435
636
  callerPhone: phone,
436
- contactId: member!.contact.id,
637
+ contactId: member.contactId,
437
638
  });
438
639
 
439
640
  const result = await redeemVoiceInviteCode({
@@ -459,16 +660,12 @@ describe("redeemVoiceInviteCode", () => {
459
660
  const phone = "+15559998888";
460
661
 
461
662
  // Pre-create a guardian contact with a revoked phone channel
462
- const guardianContact = upsertContact({
663
+ const guardianSeed = seedContactChannel({
664
+ sourceChannel: "phone",
665
+ externalUserId: phone,
463
666
  displayName: "Guardian",
464
667
  role: "guardian",
465
- channels: [
466
- {
467
- type: "phone",
468
- address: phone,
469
- status: "revoked",
470
- },
471
- ],
668
+ status: "revoked",
472
669
  });
473
670
 
474
671
  // Create a separate target contact "Mom"
@@ -500,11 +697,10 @@ describe("redeemVoiceInviteCode", () => {
500
697
  });
501
698
  expect(contactResult).not.toBeNull();
502
699
  expect(contactResult!.contact.id).toBe(momContact.id);
503
- expect(contactResult!.channel.status).toBe("active");
504
700
 
505
701
  // Verify the original guardian contact was NOT modified
506
- const guardian = getContact(guardianContact.id);
702
+ const guardian = getContact(guardianSeed.contactId);
507
703
  expect(guardian).not.toBeNull();
508
- expect(guardian!.role).toBe("guardian");
704
+ expect(localContactRole(guardianSeed.contactId)).toBe("guardian");
509
705
  });
510
706
  });
@@ -57,6 +57,8 @@ mock.module("../config/loader.js", () => ({
57
57
  }));
58
58
 
59
59
  mock.module("../memory/conversation-crud.js", () => ({
60
+ setConversationProcessingStartedAt: () => {},
61
+ isConversationProcessing: () => false,
60
62
  addMessage: () => ({ id: "mock-msg-id" }),
61
63
  getMessageById: () => null,
62
64
  updateMessageContent: () => {},
@@ -55,11 +55,11 @@ describe("102-preserve-heartbeat-enabled-for-existing-workspaces migration", ()
55
55
  ).toContain("heartbeat.enabled");
56
56
  });
57
57
 
58
- test("schema default is disabled (the flip this migration compensates for)", () => {
59
- expect(HeartbeatConfigSchema.parse({}).enabled).toBe(false);
58
+ test("schema default is enabled", () => {
59
+ expect(HeartbeatConfigSchema.parse({}).enabled).toBe(true);
60
60
  });
61
61
 
62
- test("skips fresh workspaces so new users get the opt-in default", () => {
62
+ test("skips fresh workspaces so new users inherit the schema default", () => {
63
63
  preserveHeartbeatEnabledForExistingWorkspacesMigration.run(
64
64
  workspaceDir,
65
65
  NEW_WORKSPACE_CTX,
@@ -0,0 +1,208 @@
1
+ import {
2
+ existsSync,
3
+ mkdirSync,
4
+ readFileSync,
5
+ rmSync,
6
+ writeFileSync,
7
+ } from "node:fs";
8
+ import { tmpdir } from "node:os";
9
+ import { join } from "node:path";
10
+ import { afterEach, beforeEach, describe, expect, test } from "bun:test";
11
+
12
+ import { pruneSeededCallsiteDefaultsMigration } from "../workspace/migrations/111-prune-seeded-callsite-defaults.js";
13
+ import { WORKSPACE_MIGRATIONS } from "../workspace/migrations/registry.js";
14
+
15
+ let workspaceDir: string;
16
+ let previousOverlayPath: string | undefined;
17
+
18
+ function writeConfig(data: Record<string, unknown>): void {
19
+ writeFileSync(
20
+ join(workspaceDir, "config.json"),
21
+ JSON.stringify(data, null, 2) + "\n",
22
+ );
23
+ }
24
+
25
+ function readConfig(): Record<string, unknown> {
26
+ return JSON.parse(readFileSync(join(workspaceDir, "config.json"), "utf-8"));
27
+ }
28
+
29
+ function readLlm(): Record<string, unknown> | undefined {
30
+ return readConfig().llm as Record<string, unknown> | undefined;
31
+ }
32
+
33
+ function latencySeed(): Record<string, unknown> {
34
+ return {
35
+ model: "claude-haiku-4-5-20251001",
36
+ effort: "low",
37
+ thinking: { enabled: false },
38
+ };
39
+ }
40
+
41
+ function fullSeededCallSites(): Record<string, Record<string, unknown>> {
42
+ return {
43
+ guardianQuestionCopy: latencySeed(),
44
+ interactionClassifier: latencySeed(),
45
+ skillCategoryInference: latencySeed(),
46
+ inviteInstructionGenerator: latencySeed(),
47
+ notificationDecision: latencySeed(),
48
+ preferenceExtraction: latencySeed(),
49
+ commitMessage: {
50
+ model: "claude-haiku-4-5-20251001",
51
+ maxTokens: 120,
52
+ temperature: 0.2,
53
+ effort: "low",
54
+ thinking: { enabled: false },
55
+ },
56
+ conversationStarters: latencySeed(),
57
+ conversationSummarization: {
58
+ model: "claude-opus-4-7",
59
+ effort: "low",
60
+ thinking: { enabled: false },
61
+ },
62
+ recall: {
63
+ profile: "cost-optimized",
64
+ maxTokens: 4096,
65
+ effort: "low",
66
+ thinking: { enabled: false, streamThinking: false },
67
+ temperature: 0,
68
+ disableCache: true,
69
+ },
70
+ heartbeatAgent: {
71
+ profile: "cost-optimized",
72
+ maxTokens: 2048,
73
+ effort: "low",
74
+ temperature: 0,
75
+ thinking: { enabled: false, streamThinking: false },
76
+ contextWindow: { maxInputTokens: 16000 },
77
+ },
78
+ replySuggestion: {
79
+ model: "claude-haiku-4-5-20251001",
80
+ effort: "low",
81
+ thinking: { enabled: false },
82
+ disableCache: true,
83
+ },
84
+ memoryRouter: {
85
+ profile: "cost-optimized",
86
+ contextWindow: { maxInputTokens: 1_000_000 },
87
+ },
88
+ };
89
+ }
90
+
91
+ beforeEach(() => {
92
+ workspaceDir = join(
93
+ tmpdir(),
94
+ `vellum-migration-111-test-${Date.now()}-${Math.random().toString(36).slice(2)}`,
95
+ );
96
+ mkdirSync(workspaceDir, { recursive: true });
97
+ previousOverlayPath = process.env.VELLUM_DEFAULT_WORKSPACE_CONFIG_PATH;
98
+ delete process.env.VELLUM_DEFAULT_WORKSPACE_CONFIG_PATH;
99
+ });
100
+
101
+ afterEach(() => {
102
+ if (previousOverlayPath === undefined) {
103
+ delete process.env.VELLUM_DEFAULT_WORKSPACE_CONFIG_PATH;
104
+ } else {
105
+ process.env.VELLUM_DEFAULT_WORKSPACE_CONFIG_PATH = previousOverlayPath;
106
+ }
107
+ if (existsSync(workspaceDir)) {
108
+ rmSync(workspaceDir, { recursive: true, force: true });
109
+ }
110
+ });
111
+
112
+ describe("111-prune-seeded-callsite-defaults migration", () => {
113
+ test("is registered", () => {
114
+ expect(WORKSPACE_MIGRATIONS).toContain(
115
+ pruneSeededCallsiteDefaultsMigration,
116
+ );
117
+ });
118
+
119
+ test("no-op when config.json does not exist", () => {
120
+ pruneSeededCallsiteDefaultsMigration.run(workspaceDir);
121
+ expect(existsSync(join(workspaceDir, "config.json"))).toBe(false);
122
+ });
123
+
124
+ test("gracefully handles invalid JSON", () => {
125
+ writeFileSync(join(workspaceDir, "config.json"), "not-valid-json");
126
+ pruneSeededCallsiteDefaultsMigration.run(workspaceDir);
127
+ expect(readFileSync(join(workspaceDir, "config.json"), "utf-8")).toBe(
128
+ "not-valid-json",
129
+ );
130
+ });
131
+
132
+ test("removes exact system-owned call-site default materializations", () => {
133
+ writeConfig({
134
+ llm: {
135
+ activeProfile: "balanced",
136
+ advisorProfile: "frontier",
137
+ callSites: fullSeededCallSites(),
138
+ },
139
+ });
140
+
141
+ pruneSeededCallsiteDefaultsMigration.run(workspaceDir);
142
+
143
+ expect(readLlm()?.activeProfile).toBe("balanced");
144
+ expect(readLlm()?.advisorProfile).toBe("frontier");
145
+ expect(readLlm()?.callSites).toBeUndefined();
146
+ });
147
+
148
+ test("preserves user-customized call-site entries", () => {
149
+ writeConfig({
150
+ llm: {
151
+ callSites: {
152
+ ...fullSeededCallSites(),
153
+ commitMessage: {
154
+ model: "claude-haiku-4-5-20251001",
155
+ maxTokens: 256,
156
+ temperature: 0.2,
157
+ effort: "low",
158
+ thinking: { enabled: false },
159
+ },
160
+ recall: {
161
+ profile: "cost-optimized",
162
+ maxTokens: 4096,
163
+ effort: "low",
164
+ thinking: { enabled: false, streamThinking: false },
165
+ temperature: 0,
166
+ disableCache: false,
167
+ },
168
+ customSite: { profile: "frontier" },
169
+ },
170
+ },
171
+ });
172
+
173
+ pruneSeededCallsiteDefaultsMigration.run(workspaceDir);
174
+
175
+ const callSites = readLlm()?.callSites as Record<
176
+ string,
177
+ Record<string, unknown>
178
+ >;
179
+ expect(Object.keys(callSites).sort()).toEqual([
180
+ "commitMessage",
181
+ "customSite",
182
+ "recall",
183
+ ]);
184
+ expect(callSites.commitMessage?.maxTokens).toBe(256);
185
+ expect(callSites.recall?.disableCache).toBe(false);
186
+ expect(callSites.customSite).toEqual({ profile: "frontier" });
187
+ });
188
+
189
+ test("platform-style config keeps gateway settings while pruning seeded call sites", () => {
190
+ writeConfig({
191
+ gateway: {
192
+ unmappedPolicy: "default",
193
+ defaultAssistantId: "self",
194
+ },
195
+ llm: {
196
+ callSites: fullSeededCallSites(),
197
+ },
198
+ });
199
+
200
+ pruneSeededCallsiteDefaultsMigration.run(workspaceDir);
201
+
202
+ expect(readConfig().gateway).toEqual({
203
+ unmappedPolicy: "default",
204
+ defaultAssistantId: "self",
205
+ });
206
+ expect(readLlm()?.callSites).toBeUndefined();
207
+ });
208
+ });