@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
@@ -0,0 +1,223 @@
1
+ /**
2
+ * Gateway-backed guardian binding + delivery reader.
3
+ *
4
+ * Resolves the active guardian binding(s) and their per-channel delivery
5
+ * endpoints from the gateway via the `resolve_guardian_delivery` IPC route,
6
+ * validating the response against {@link ResolveGuardianDeliveryResponseSchema}.
7
+ *
8
+ * Guardian binding is near-static — it only changes on guardian onboarding /
9
+ * verification or revocation — yet this reader sits on many hot paths. To keep
10
+ * those paths off the IPC, results are cached behind a minutes-scale TTL and
11
+ * coalesced single-flight so a cold cache storms the gateway at most once.
12
+ *
13
+ * Freshness comes from two sources: the {@link invalidateGuardianDeliveryCache}
14
+ * subscription to `onContactChange` (contact mutations clear the cache), and
15
+ * {@link getGuardianDeliveryFresh} reads on existence guards (gateway-side
16
+ * binding writes don't invalidate the daemon cache, so those paths read fresh).
17
+ *
18
+ * Returns `null` on ANY failure (transport failure, malformed shape, timeout,
19
+ * or thrown error); failures are NOT cached, so a recovered gateway is retried
20
+ * on the next call.
21
+ */
22
+
23
+ import {
24
+ type GuardianDelivery,
25
+ ResolveGuardianDeliveryResponseSchema,
26
+ } from "@vellumai/gateway-client";
27
+
28
+ import { ipcCall } from "../ipc/gateway-client.js";
29
+ import { onContactChange } from "./contact-events.js";
30
+
31
+ // Short IPC timeout so the read resolves promptly rather than stalling a hot
32
+ // path on a gateway that accepts the socket but hangs.
33
+ const GUARDIAN_DELIVERY_IPC_TIMEOUT_MS = 2_000;
34
+
35
+ // Guardian binding is near-static, so a minutes-scale TTL is safe; freshness is
36
+ // driven primarily by event-based invalidation, not by this backstop expiry.
37
+ const GUARDIAN_DELIVERY_CACHE_TTL_MS = 300_000;
38
+
39
+ interface CacheEntry {
40
+ guardians: GuardianDelivery[];
41
+ fetchedAt: number;
42
+ }
43
+
44
+ const cache = new Map<string, CacheEntry>();
45
+ // Tracks whether the in-flight fetch was a force-refresh, so a fresh read never
46
+ // coalesces with an older non-force fetch that may predate a gateway-side write.
47
+ const inFlight = new Map<
48
+ string,
49
+ { promise: Promise<GuardianDelivery[] | null>; fresh: boolean }
50
+ >();
51
+
52
+ // Bumped on every invalidation. A fetch captures the generation when it starts
53
+ // and only writes its result to the cache if the generation is unchanged on
54
+ // resolve, so an invalidation mid-flight can't repopulate a stale pre-change
55
+ // result and mask a guardian-binding change.
56
+ let cacheGeneration = 0;
57
+
58
+ function cacheKey(channelTypes?: string[]): string {
59
+ if (!channelTypes || channelTypes.length === 0) return "ALL";
60
+ return [...channelTypes].sort().join(",");
61
+ }
62
+
63
+ async function fetchGuardianDelivery(
64
+ input: { channelTypes?: string[] },
65
+ ): Promise<GuardianDelivery[] | null> {
66
+ try {
67
+ const result = await ipcCall(
68
+ "resolve_guardian_delivery",
69
+ input,
70
+ GUARDIAN_DELIVERY_IPC_TIMEOUT_MS,
71
+ );
72
+ if (!result) return null;
73
+
74
+ const parsed = ResolveGuardianDeliveryResponseSchema.safeParse(result);
75
+ return parsed.success ? parsed.data.guardians : null;
76
+ } catch {
77
+ return null;
78
+ }
79
+ }
80
+
81
+ // Shared fetch path for both the cached and fresh public surfaces. When
82
+ // `forceRefresh` is set the cached entry is bypassed; the read is still
83
+ // single-flight and still populates the cache with the fresh result.
84
+ async function readGuardianDelivery(
85
+ input: { channelTypes?: string[]; forceRefresh?: boolean },
86
+ ): Promise<GuardianDelivery[] | null> {
87
+ const key = cacheKey(input.channelTypes);
88
+
89
+ if (!input.forceRefresh) {
90
+ const cached = cache.get(key);
91
+ if (
92
+ cached &&
93
+ Date.now() - cached.fetchedAt < GUARDIAN_DELIVERY_CACHE_TTL_MS
94
+ ) {
95
+ return cached.guardians;
96
+ }
97
+ }
98
+
99
+ // A non-force read may coalesce with any in-flight fetch. A force read may
100
+ // only coalesce with another force fetch — never with a non-force fetch that
101
+ // could have started before a gateway-side binding write and resolve stale.
102
+ const pending = inFlight.get(key);
103
+ if (pending && (!input.forceRefresh || pending.fresh)) return pending.promise;
104
+
105
+ const startGen = cacheGeneration;
106
+ const promise = fetchGuardianDelivery({ channelTypes: input.channelTypes })
107
+ .then((guardians) => {
108
+ // Skip the write if an invalidation fired during the fetch: the result
109
+ // may predate the change. Return it to this caller (freshest it has) but
110
+ // leave the cache empty so the next call re-fetches.
111
+ if (guardians && cacheGeneration === startGen) {
112
+ cache.set(key, { guardians, fetchedAt: Date.now() });
113
+ }
114
+ return guardians;
115
+ })
116
+ .finally(() => {
117
+ // Only clear the slot if it still holds this fetch — a concurrent force
118
+ // read may have replaced a non-force entry (or vice versa).
119
+ if (inFlight.get(key)?.promise === promise) inFlight.delete(key);
120
+ });
121
+
122
+ inFlight.set(key, { promise, fresh: !!input.forceRefresh });
123
+ return promise;
124
+ }
125
+
126
+ /**
127
+ * Resolve active guardian deliveries, optionally filtered by channel type.
128
+ * Returns the cached list when fresh, otherwise fetches (single-flight) and
129
+ * caches on success. Returns `null` on failure without caching.
130
+ *
131
+ * To force an uncached read, call {@link getGuardianDeliveryFresh} — the only
132
+ * public fresh-read entry point.
133
+ */
134
+ export async function getGuardianDelivery(
135
+ input?: { channelTypes?: string[] },
136
+ ): Promise<GuardianDelivery[] | null> {
137
+ return readGuardianDelivery({ channelTypes: input?.channelTypes });
138
+ }
139
+
140
+ /**
141
+ * Synchronous read of the already-cached guardian deliveries, without any IO.
142
+ *
143
+ * Returns the fresh cached list for the given channel filter, or `undefined`
144
+ * when the cache is cold or expired. Used by sync hot paths (SSE subscribe)
145
+ * that cannot await {@link getGuardianDelivery} but must resolve the SAME
146
+ * gateway-owned principal the async paths land on. A cold/expired return lets
147
+ * the caller fall back to the local store as before.
148
+ */
149
+ export function peekCachedGuardianDelivery(
150
+ input?: { channelTypes?: string[] },
151
+ ): GuardianDelivery[] | undefined {
152
+ const cached = cache.get(cacheKey(input?.channelTypes));
153
+ if (!cached) return undefined;
154
+ if (Date.now() - cached.fetchedAt >= GUARDIAN_DELIVERY_CACHE_TTL_MS) {
155
+ return undefined;
156
+ }
157
+ return cached.guardians;
158
+ }
159
+
160
+ /**
161
+ * Fresh (uncached) variant of {@link getGuardianDelivery}. Existence guards read
162
+ * fresh because gateway-side binding writes don't invalidate the daemon cache.
163
+ * Still single-flight, and still populates the cache with the fresh result.
164
+ */
165
+ export async function getGuardianDeliveryFresh(
166
+ input?: { channelTypes?: string[] },
167
+ ): Promise<GuardianDelivery[] | null> {
168
+ return readGuardianDelivery({
169
+ channelTypes: input?.channelTypes,
170
+ forceRefresh: true,
171
+ });
172
+ }
173
+
174
+ /**
175
+ * Clear ALL cached guardian deliveries. Subscribed to `onContactChange` so
176
+ * contact mutations refetch on the next read; also exported for any caller that
177
+ * wants to invalidate explicitly.
178
+ */
179
+ export function invalidateGuardianDeliveryCache(): void {
180
+ cacheGeneration += 1;
181
+ cache.clear();
182
+ inFlight.clear();
183
+ }
184
+
185
+ onContactChange(invalidateGuardianDeliveryCache);
186
+
187
+ /** First active guardian delivery for the given channel type, if any. */
188
+ export function guardianForChannel(
189
+ list: GuardianDelivery[],
190
+ channelType: string,
191
+ ): GuardianDelivery | undefined {
192
+ return list.find(
193
+ (g) => g.channelType === channelType && g.status === "active",
194
+ );
195
+ }
196
+
197
+ /** First guardian delivery overall — the `listGuardianChannels` fallback. */
198
+ export function anyGuardian(
199
+ list: GuardianDelivery[],
200
+ ): GuardianDelivery | undefined {
201
+ return list[0];
202
+ }
203
+
204
+ /**
205
+ * Resolve a guardian displayName for voice surfaces: prefer the phone-channel
206
+ * guardian, falling back to any guardian. Returns `undefined` when the list is
207
+ * absent or no guardian carries a displayName.
208
+ */
209
+ export function voiceGuardianDisplayName(
210
+ list: GuardianDelivery[] | null,
211
+ ): string | undefined {
212
+ const guardian = list
213
+ ? (guardianForChannel(list, "phone") ?? anyGuardian(list))
214
+ : undefined;
215
+ return guardian?.displayName ?? undefined;
216
+ }
217
+
218
+ /** Test-only: reset cache + in-flight state for deterministic test runs. */
219
+ export function __resetGuardianDeliveryCacheForTest(): void {
220
+ cache.clear();
221
+ inFlight.clear();
222
+ cacheGeneration = 0;
223
+ }
@@ -0,0 +1,183 @@
1
+ /**
2
+ * Gateway-first member-channel write relay.
3
+ *
4
+ * The gateway is the ACL source of truth. Each write goes to the gateway first;
5
+ * the assistant-DB write in contacts-write.ts is a best-effort local mirror that
6
+ * never throws and never gates the gateway-owned outcome.
7
+ */
8
+
9
+ import {
10
+ MarkChannelRevokedIpcResponseSchema,
11
+ UpsertVerifiedChannelIpcResponseSchema,
12
+ } from "@vellumai/gateway-client/gateway-ipc-contracts";
13
+
14
+ import { log } from "../daemon/handlers/shared.js";
15
+ import { ipcCallPersistent } from "../ipc/gateway-client.js";
16
+ import { revokeMember, upsertContactChannel } from "./contacts-write.js";
17
+ import type { ContactWriteResult } from "./types.js";
18
+
19
+ // ── Activate ─────────────────────────────────────────────────────────
20
+
21
+ export interface ActivateMemberChannelParams {
22
+ sourceChannel: string;
23
+ externalUserId?: string;
24
+ externalChatId?: string;
25
+ contactId?: string;
26
+ displayName?: string;
27
+ username?: string;
28
+ inviteId?: string;
29
+ verifiedAt?: number;
30
+ verifiedVia?: string;
31
+ policy?: string;
32
+ }
33
+
34
+ /**
35
+ * Outcome of a gateway-first member activation. The gateway owns the ACL
36
+ * verdict; `activated` carries a stable memberId (gateway channel id, or the
37
+ * local mirror's id when present) regardless of whether the best-effort local
38
+ * mirror produced a row. `refused` means the gateway authoritatively denied the
39
+ * actor (blocked/revoked) — callers must NOT treat it as an activation.
40
+ */
41
+ export type ActivateMemberOutcome =
42
+ | { status: "activated"; memberId: string; member: ContactWriteResult | null }
43
+ | { status: "refused" };
44
+
45
+ /**
46
+ * Activate a member channel gateway-first, then mirror the activation to the
47
+ * assistant DB best-effort. The gateway owns the ACL outcome; the local mirror
48
+ * supplies the native contact/channel callers still wire downstream.
49
+ *
50
+ * A gateway write failure fails closed: the mirror is identity-only, so a
51
+ * gateway that did not persist the activation must surface as `refused` rather
52
+ * than reporting success off a local row the gateway never verified.
53
+ *
54
+ * Returns an `activated` outcome with a stable memberId on success, or
55
+ * `refused` when the gateway denies the actor or the gateway write fails. A
56
+ * best-effort local-mirror failure never downgrades a verified gateway
57
+ * activation.
58
+ */
59
+ export async function activateMemberChannel(
60
+ params: ActivateMemberChannelParams,
61
+ ): Promise<ActivateMemberOutcome> {
62
+ const address = params.externalUserId ?? params.externalChatId;
63
+ const externalChatId = params.externalChatId ?? params.externalUserId;
64
+
65
+ let gatewayChannelId: string | undefined;
66
+
67
+ if (address && externalChatId) {
68
+ try {
69
+ const result = await ipcCallPersistent("upsert_verified_channel", {
70
+ type: params.sourceChannel,
71
+ address,
72
+ externalChatId,
73
+ displayName: params.displayName,
74
+ username: params.username,
75
+ verifiedVia: params.verifiedVia ?? "invite",
76
+ contactId: params.contactId,
77
+ // Invite redemption may reactivate a revoked member; blocked actors are
78
+ // still refused by the gateway guard.
79
+ allowRevokedReactivation: true,
80
+ });
81
+ const parsed = UpsertVerifiedChannelIpcResponseSchema.parse(result);
82
+ // The gateway refused the actor (blocked/revoked): do NOT mirror an
83
+ // active local channel for an actor the gateway has denied.
84
+ if (!parsed.verified) {
85
+ log.warn(
86
+ { sourceChannel: params.sourceChannel },
87
+ "Gateway refused the channel activation; skipping the local mirror",
88
+ );
89
+ return { status: "refused" };
90
+ }
91
+ gatewayChannelId = parsed.channel?.id;
92
+ } catch (err) {
93
+ // Fail-closed: the gateway owns the ACL verdict and the local mirror is
94
+ // identity-only. If the gateway write did not land, the activation is not
95
+ // persisted to the source of truth, so we must not report success.
96
+ log.warn(
97
+ { err, sourceChannel: params.sourceChannel },
98
+ "upsert_verified_channel relay failed — refusing activation (gateway write did not land)",
99
+ );
100
+ return { status: "refused" };
101
+ }
102
+ }
103
+
104
+ const member = mirrorLocalActivation(params);
105
+ const memberId = member?.channel.id ?? gatewayChannelId;
106
+ if (!memberId) {
107
+ // No gateway channel (the relay threw or was skipped) AND no local mirror —
108
+ // no stable id to hand the caller. Surface as refused so the caller maps it
109
+ // to a non-redeemed outcome instead of crashing on a missing memberId.
110
+ log.error(
111
+ { sourceChannel: params.sourceChannel },
112
+ "Member activation produced no gateway channel and no local mirror; no memberId to return",
113
+ );
114
+ return { status: "refused" };
115
+ }
116
+ return { status: "activated", memberId, member };
117
+ }
118
+
119
+ /**
120
+ * Best-effort local mirror of the activation. Swallows failures. Persists only
121
+ * the native contact/channel identity row — the gateway owns the ACL verdict.
122
+ */
123
+ function mirrorLocalActivation(
124
+ params: ActivateMemberChannelParams,
125
+ ): ContactWriteResult | null {
126
+ try {
127
+ return upsertContactChannel({
128
+ sourceChannel: params.sourceChannel,
129
+ externalUserId: params.externalUserId,
130
+ externalChatId: params.externalChatId,
131
+ displayName: params.displayName,
132
+ username: params.username,
133
+ inviteId: params.inviteId,
134
+ contactId: params.contactId,
135
+ });
136
+ } catch (err) {
137
+ log.error(
138
+ { err, sourceChannel: params.sourceChannel },
139
+ "Local activation mirror failed after gateway activation; gateway outcome stands",
140
+ );
141
+ return null;
142
+ }
143
+ }
144
+
145
+ // ── Revoke ───────────────────────────────────────────────────────────
146
+
147
+ /**
148
+ * Revoke a member channel gateway-first. The gateway owns the ACL outcome; the
149
+ * memberId may be a plain channel ID or the composite contactId:channelId form
150
+ * revokeMember accepts.
151
+ *
152
+ * Returns the locally-resolved native contact/channel for the revoked id, or
153
+ * null when no local row exists. The local read is best-effort and never gates
154
+ * the gateway-owned downgrade.
155
+ */
156
+ export async function revokeMemberChannel(
157
+ memberId: string,
158
+ reason?: string,
159
+ ): Promise<ContactWriteResult | null> {
160
+ const channelId = memberId.includes(":") ? memberId.split(":")[1] : memberId;
161
+
162
+ // Always relay; the gateway owns the ACL outcome and mark_channel_revoked is
163
+ // idempotent (already-revoked → didWrite:false). Skipping on the local row
164
+ // status would suppress a needed revoke when the local read lags the gateway.
165
+ const result = await ipcCallPersistent("mark_channel_revoked", {
166
+ contactChannelId: channelId,
167
+ reason,
168
+ });
169
+ const parsed = MarkChannelRevokedIpcResponseSchema.parse(result);
170
+ if (!parsed.ok) {
171
+ throw new Error("mark_channel_revoked relay returned ok: false");
172
+ }
173
+
174
+ try {
175
+ return revokeMember(memberId);
176
+ } catch (err) {
177
+ log.error(
178
+ { err, memberId },
179
+ "Local revoke read failed after gateway revoke; gateway downgrade stands",
180
+ );
181
+ return null;
182
+ }
183
+ }
@@ -30,20 +30,12 @@ export interface Contact {
30
30
  displayName: string;
31
31
  /** Free-text notes about this contact (e.g. relationship, communication preferences). */
32
32
  notes: string | null;
33
+ role: ContactRole;
33
34
  lastInteraction: number | null;
34
35
  interactionCount: number;
35
36
  createdAt: number;
36
37
  updatedAt: number;
37
- role: ContactRole;
38
38
  contactType: ContactType;
39
- /**
40
- * Internal auth identity (e.g. "vellum-principal-<uuid>"). Only meaningful
41
- * for guardian contacts — it ties the contact record to the auth layer so
42
- * the system can verify "this API caller IS this guardian" via JWT
43
- * actorPrincipalId. Always null for non-guardian contacts, which are
44
- * identified by channel address instead.
45
- */
46
- principalId: string | null;
47
39
  /** Workspace-relative path to a per-user persona file for this contact. */
48
40
  userFile: string | null;
49
41
  }
@@ -63,13 +55,9 @@ export interface ContactChannel {
63
55
  address: string;
64
56
  isPrimary: boolean;
65
57
  externalChatId: string | null;
66
- status: ChannelStatus;
67
- policy: ChannelPolicy;
68
- verifiedAt: number | null;
69
- verifiedVia: string | null;
70
58
  inviteId: string | null;
71
- revokedReason: string | null;
72
- blockedReason: string | null;
59
+ // INFO telemetry (not ACL): interaction stats written locally by the gateway's
60
+ // handle-inbound mirror. Model-facing turn context reads these.
73
61
  lastSeenAt: number | null;
74
62
  interactionCount: number;
75
63
  lastInteraction: number | null;
@@ -12,6 +12,7 @@ import type { ToolDefinition } from "../../providers/types.js";
12
12
  import {
13
13
  __clearRegistryForTesting,
14
14
  registerMcpTools,
15
+ registerPluginTools,
15
16
  } from "../../tools/registry.js";
16
17
  import type { Tool } from "../../tools/types.js";
17
18
  import { createResolveToolsCallback } from "../conversation-tool-setup.js";
@@ -33,6 +34,14 @@ function mcpTool(name: string): Tool {
33
34
  } as unknown as Tool;
34
35
  }
35
36
 
37
+ function pluginTool(name: string): Tool {
38
+ return {
39
+ name,
40
+ description: name,
41
+ input_schema: def(name).input_schema,
42
+ } as unknown as Tool;
43
+ }
44
+
36
45
  function makeCtx(
37
46
  overrides: Partial<SkillProjectionContext> = {},
38
47
  ): SkillProjectionContext {
@@ -139,6 +148,32 @@ describe("createResolveToolsCallback — config.tools.exclude", () => {
139
148
  expect(names).toEqual(["recall", "file_read"]);
140
149
  });
141
150
 
151
+ test("plugin tool registered after resolver creation is picked up next turn", () => {
152
+ getConfigSpy = withExclude([]);
153
+ // Resolver created when only a core tool exists — no plugin yet, mirroring
154
+ // a conversation that started before the plugin was installed.
155
+ const resolver = createResolveToolsCallback([def("file_read")], makeCtx());
156
+ expect(resolver!([]).map((d) => d.name)).toEqual(["file_read"]);
157
+
158
+ // A plugin installed + activated mid-conversation lands its tool in the
159
+ // registry. The resolver must surface it on the next turn without the
160
+ // conversation being recreated (the plugin equivalent of `mcp reload`).
161
+ registerPluginTools("late-plugin", [pluginTool("admin_copilot_prefs")]);
162
+ const names = resolver!([]).map((d) => d.name);
163
+ expect(names).toContain("admin_copilot_prefs");
164
+ expect(names).toContain("file_read");
165
+ });
166
+
167
+ test("excluded plugin tool is omitted from the resolved tool list", () => {
168
+ registerPluginTools("ex-plugin", [pluginTool("ex_plugin_tool")]);
169
+ getConfigSpy = withExclude(["ex_plugin_tool"]);
170
+ const resolver = createResolveToolsCallback(
171
+ [def("file_read"), def("ex_plugin_tool")],
172
+ makeCtx(),
173
+ );
174
+ expect(resolver!([]).map((d) => d.name)).toEqual(["file_read"]);
175
+ });
176
+
142
177
  test("excluded tool stays excluded under disk-pressure cleanup mode", () => {
143
178
  // `bash` is a cleanup-safe tool and would normally survive cleanup mode;
144
179
  // the exclude filter must still suppress it.
@@ -47,20 +47,6 @@ mock.module("../../runtime/assistant-event-hub.js", () => ({
47
47
  broadcastMessage: () => {},
48
48
  }));
49
49
 
50
- // Control the advisor profile gate to verify the advisor tool is wired to it.
51
- // The gate's own config semantics (default-on, active-profile fallback) are
52
- // covered by advisor-gate.test.ts; here we only assert the wiring and the
53
- // profile argument isToolActiveForContext passes through.
54
- let advisorGateResult = true;
55
- const advisorGateProfiles: (string | null)[] = [];
56
-
57
- mock.module("../../plugins/defaults/advisor/advisor-gate.js", () => ({
58
- advisorEnabledForProfile: (profile: string | null) => {
59
- advisorGateProfiles.push(profile);
60
- return advisorGateResult;
61
- },
62
- }));
63
-
64
50
  // Dynamic imports after mock.module calls so the stubs take effect
65
51
  // before the modules under test are loaded.
66
52
  const { HOST_TOOL_NAMES, HOST_TOOL_TO_CAPABILITY, isToolActiveForContext } =
@@ -611,36 +597,6 @@ describe("isToolActiveForContext — ask_question macOS gating", () => {
611
597
  });
612
598
  });
613
599
 
614
- describe("isToolActiveForContext — advisor profile gate", () => {
615
- beforeEach(() => {
616
- advisorGateResult = true;
617
- advisorGateProfiles.length = 0;
618
- });
619
-
620
- test("advisor is active when the profile enables it", () => {
621
- advisorGateResult = true;
622
- expect(isToolActiveForContext("advisor", makeCtx())).toBe(true);
623
- });
624
-
625
- test("advisor is NOT active when the profile disables it", () => {
626
- advisorGateResult = false;
627
- expect(isToolActiveForContext("advisor", makeCtx())).toBe(false);
628
- });
629
-
630
- test("consults the gate with the per-turn override profile", () => {
631
- isToolActiveForContext(
632
- "advisor",
633
- makeCtx({ currentTurnOverrideProfile: "cost-optimized" }),
634
- );
635
- expect(advisorGateProfiles).toEqual(["cost-optimized"]);
636
- });
637
-
638
- test("consults the gate with null when no per-turn override is set", () => {
639
- isToolActiveForContext("advisor", makeCtx());
640
- expect(advisorGateProfiles).toEqual([null]);
641
- });
642
- });
643
-
644
600
  describe("HOST_TOOL_NAMES derivation", () => {
645
601
  test("HOST_TOOL_NAMES is derived from HOST_TOOL_TO_CAPABILITY", () => {
646
602
  // Sanity check: every tool in the names set has a capability mapping.
@@ -284,6 +284,19 @@ interface VellumLinkExtractResult {
284
284
  * markdown links from assistant text and return corresponding directive
285
285
  * requests. The text is NOT modified — the links remain as rendered markdown.
286
286
  */
287
+ /**
288
+ * Decode a vellum:// path segment, returning null on malformed percent-encoding
289
+ * (e.g. a literal `%` not followed by two hex digits). This prevents a single
290
+ * bad link from throwing URIError and aborting the entire assistant message.
291
+ */
292
+ function safeDecodePath(rawPath: string): string | null {
293
+ try {
294
+ return decodeURIComponent(rawPath);
295
+ } catch {
296
+ return null;
297
+ }
298
+ }
299
+
287
300
  export function extractVellumLinks(text: string): VellumLinkExtractResult {
288
301
  const directiveRequests: DirectiveRequest[] = [];
289
302
  const parseWarnings: string[] = [];
@@ -294,9 +307,19 @@ export function extractVellumLinks(text: string): VellumLinkExtractResult {
294
307
  const authority = m[2]!;
295
308
  const rawPath = m[3]!;
296
309
 
310
+ const decodedPath = safeDecodePath(rawPath);
311
+ if (decodedPath === null) {
312
+ parseWarnings.push(
313
+ `Ignored vellum://${authority} link "${linkText}": malformed percent-encoding in path.`,
314
+ );
315
+ continue;
316
+ }
317
+
297
318
  if (authority === "workspace") {
298
319
  // Strip the leading "/" to get a workspace-relative path
299
- const path = rawPath.startsWith("/") ? rawPath.slice(1) : rawPath;
320
+ const path = decodedPath.startsWith("/")
321
+ ? decodedPath.slice(1)
322
+ : decodedPath;
300
323
  if (!path) {
301
324
  parseWarnings.push(
302
325
  `Ignored vellum://workspace link "${linkText}": empty path.`,
@@ -310,8 +333,8 @@ export function extractVellumLinks(text: string): VellumLinkExtractResult {
310
333
  mimeType: undefined,
311
334
  });
312
335
  } else {
313
- // host: rawPath is already absolute (starts with /)
314
- if (!rawPath || rawPath === "/") {
336
+ // host: decodedPath is already absolute (starts with /)
337
+ if (!decodedPath || decodedPath === "/") {
315
338
  parseWarnings.push(
316
339
  `Ignored vellum://host link "${linkText}": empty path.`,
317
340
  );
@@ -319,7 +342,7 @@ export function extractVellumLinks(text: string): VellumLinkExtractResult {
319
342
  }
320
343
  directiveRequests.push({
321
344
  source: "host",
322
- path: rawPath,
345
+ path: decodedPath,
323
346
  filename: linkText || undefined,
324
347
  mimeType: undefined,
325
348
  });
@@ -100,6 +100,10 @@ import {
100
100
  isUserCancellation,
101
101
  } from "./conversation-error.js";
102
102
  import { raceWithTimeout } from "./conversation-media-retry.js";
103
+ import {
104
+ clearConversationNotices,
105
+ drainConversationNotices,
106
+ } from "./conversation-notices.js";
103
107
  import {
104
108
  getSlackCompactionWatermarkForPrefix,
105
109
  loadSlackChronologicalContext,
@@ -480,6 +484,11 @@ export async function runAgentLoopImpl(
480
484
  // resolved once here and threaded into every re-injection — including the
481
485
  // post-compaction hook — rather than re-read per assembly call.
482
486
  const isNonInteractive = !isInteractiveResolved;
487
+ // Expose the resolved turn-level interactivity to tool execution so tools
488
+ // (e.g. ask_question) see whether a human is present to answer, rather than
489
+ // re-deriving it from live client state that misclassifies a scheduled turn
490
+ // running on a client-attached conversation.
491
+ ctx.currentTurnIsNonInteractive = isNonInteractive;
483
492
  const diskPressureDecision = classifyDiskPressureTurnPolicy(
484
493
  getDiskPressureStatus(),
485
494
  {
@@ -1012,6 +1021,15 @@ export async function runAgentLoopImpl(
1012
1021
  );
1013
1022
  }
1014
1023
 
1024
+ const shouldEmitQueuedConversationNotices =
1025
+ !overflowTerminalReason &&
1026
+ !yieldedForHandoff &&
1027
+ !state.providerErrorUserMessage &&
1028
+ !abortController.signal.aborted;
1029
+ if (!shouldEmitQueuedConversationNotices) {
1030
+ clearConversationNotices(ctx.conversationId);
1031
+ }
1032
+
1015
1033
  // Flush remaining tool results. On a normal turn these drain at the next
1016
1034
  // `message_complete`; an aborted or yielded loop exits with them still
1017
1035
  // buffered, so finalize the (possibly already on-arrival-reserved) grouped
@@ -1404,10 +1422,16 @@ export async function runAgentLoopImpl(
1404
1422
  ? { messageId: state.lastAssistantMessageId }
1405
1423
  : {}),
1406
1424
  });
1425
+ if (shouldEmitQueuedConversationNotices) {
1426
+ for (const notice of drainConversationNotices(ctx.conversationId)) {
1427
+ onEvent(notice);
1428
+ }
1429
+ }
1407
1430
  publishLoopMessagesChanged();
1408
1431
  }
1409
1432
  }
1410
1433
  } catch (err) {
1434
+ clearConversationNotices(ctx.conversationId);
1411
1435
  const errorCtx = {
1412
1436
  phase: "agent_loop" as const,
1413
1437
  aborted: abortController.signal.aborted,
@@ -1515,6 +1539,10 @@ export async function runAgentLoopImpl(
1515
1539
  ctx.diskPressureCleanupModeActive = false;
1516
1540
  ctx.preactivatedSkillIds = undefined;
1517
1541
  ctx.currentTurnOverrideProfile = undefined;
1542
+ // Turn-scoped interactivity. Clear it so paths that bypass this loop (e.g.
1543
+ // opportunity wakes calling `agentLoop.run` directly) don't inherit a stale
1544
+ // value and instead fall back to live client state in the tool context.
1545
+ ctx.currentTurnIsNonInteractive = undefined;
1518
1546
  // Channel command intents (e.g. Telegram /start) are single-turn metadata.
1519
1547
  // Clear at turn end so they never leak into subsequent unrelated messages.
1520
1548
  ctx.commandIntent = undefined;