@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,30 @@
1
+ /**
2
+ * Shared addressing helpers for guardian requester-facing channel notices.
3
+ *
4
+ * Requester notices (approval, denial, expiry) are delivered straight to the
5
+ * requester's chat via `deliverChannelReply` — independent of the
6
+ * guardian-facing notification pipeline. Centralizing the addressing rules here
7
+ * keeps the decision resolvers and the timer-driven expiry sweep from drifting
8
+ * apart on how a requester is reached.
9
+ */
10
+
11
+ /**
12
+ * Resolve the callback-less delivery route for a channel (e.g. `/deliver/slack`).
13
+ *
14
+ * Used when there is no inbound reply callback URL to post back to — the
15
+ * guardian decided off-channel (desktop), or the expiry sweep fired on a timer
16
+ * with no originating request in hand. Returns null for channels that have no
17
+ * deliverable route (e.g. email, the in-app vellum surface).
18
+ */
19
+ export function resolveDeliverCallbackUrlForChannel(
20
+ channel: string,
21
+ ): string | null {
22
+ switch (channel) {
23
+ case "telegram":
24
+ case "whatsapp":
25
+ case "slack":
26
+ return `/deliver/${channel}`;
27
+ default:
28
+ return null;
29
+ }
30
+ }
@@ -0,0 +1,148 @@
1
+ /**
2
+ * Expiry side effects for canonical guardian requests.
3
+ *
4
+ * When the canonical expiry sweep transitions a pending request to `expired`,
5
+ * the request's cards are withdrawn — but nobody is told and any in-memory
6
+ * interaction is left dangling. This module fills that gap:
7
+ *
8
+ * - the requester is told their request expired (for the persistent,
9
+ * requester-facing kinds: `access_request`, `tool_grant_request`), and
10
+ * - the in-memory pending interaction is released (for the interaction-bound
11
+ * `tool_approval` kind).
12
+ *
13
+ * Delivery goes straight to the requester via `deliverChannelReply` on the
14
+ * callback-less `/deliver/<channel>` route — NOT the notification pipeline,
15
+ * which is guardian-facing (`emitNotificationSignal` resolves the *guardian's*
16
+ * delivery channels). The guardian is intentionally left passive here: the
17
+ * withdrawn card already reflects the expired state, so a fresh ping would be
18
+ * noise.
19
+ *
20
+ * Best-effort by contract: the request is already resolved (CAS committed)
21
+ * before this runs, so a failed notice or interaction release must never
22
+ * surface as a sweep failure. Nothing here throws.
23
+ */
24
+
25
+ import type { CanonicalGuardianRequest } from "../memory/canonical-guardian-store.js";
26
+ import { DAEMON_INTERNAL_ASSISTANT_ID } from "../runtime/assistant-scope.js";
27
+ import { deliverChannelReply } from "../runtime/gateway-client.js";
28
+ import * as pendingInteractions from "../runtime/pending-interactions.js";
29
+ import { getLogger } from "../util/logger.js";
30
+ import { resolveDeliverCallbackUrlForChannel } from "./guardian-channel-delivery.js";
31
+
32
+ const log = getLogger("guardian-expiry-notifier");
33
+
34
+ /**
35
+ * Run the expiry side effects for a single canonical guardian request that the
36
+ * sweep just transitioned to `expired`. Dispatches by kind; never throws.
37
+ */
38
+ export async function notifyExpiredGuardianRequest(
39
+ request: CanonicalGuardianRequest,
40
+ ): Promise<void> {
41
+ try {
42
+ switch (request.kind) {
43
+ case "tool_approval":
44
+ releaseExpiredInteraction(request);
45
+ return;
46
+ case "access_request":
47
+ await notifyRequesterOfExpiry(
48
+ request,
49
+ "Your access request expired before it was reviewed. " +
50
+ "Send a new message if you still need access.",
51
+ );
52
+ return;
53
+ case "tool_grant_request":
54
+ await notifyRequesterOfExpiry(
55
+ request,
56
+ `Your request to use "${request.toolName ?? "a tool"}" expired ` +
57
+ "before it was reviewed. Ask again if you still need it.",
58
+ );
59
+ return;
60
+ case "pending_question":
61
+ // Voice call sessions own their own lifecycle and timeout. By the time
62
+ // the canonical TTL lapses the call is long over and there is no
63
+ // durable requester channel to notify, so there is nothing to do.
64
+ return;
65
+ default:
66
+ return;
67
+ }
68
+ } catch (err) {
69
+ log.warn(
70
+ { err, requestId: request.id, kind: request.kind },
71
+ "Expiry side effects failed for canonical guardian request (non-fatal)",
72
+ );
73
+ }
74
+ }
75
+
76
+ /**
77
+ * Release the in-memory pending interaction for an expired `tool_approval`.
78
+ *
79
+ * `tool_approval` is the one interaction-bound kind the periodic sweep can
80
+ * reach (it carries a 30-minute `expiresAt`). In practice the canonical request
81
+ * id does not key a *blocking* prompter interaction: ingress escalations — the
82
+ * sole producer of this kind — register no interaction at all, and
83
+ * PermissionPrompter confirmations are keyed by their own request id with their
84
+ * own (far shorter) timeout. So this is a safe cleanup: it no-ops when nothing
85
+ * is registered under the request id, and otherwise drops a waiter-less async
86
+ * entry and emits `interaction_resolved` so clients clear the attention
87
+ * indicator. `cancelled` is the documented runtime-termination/timeout outcome.
88
+ */
89
+ function releaseExpiredInteraction(request: CanonicalGuardianRequest): void {
90
+ const released = pendingInteractions.resolve(request.id, "cancelled");
91
+ if (released) {
92
+ log.info(
93
+ { requestId: request.id, kind: request.kind },
94
+ "Released pending interaction for expired guardian request",
95
+ );
96
+ }
97
+ }
98
+
99
+ /**
100
+ * Deliver an expiry notice straight to the requester's chat.
101
+ *
102
+ * The sweep is timer-driven and holds no inbound reply callback URL, so this
103
+ * mirrors the resolvers' off-channel (desktop) delivery path: post to the
104
+ * callback-less `/deliver/<channel>` route. On Slack the notice is routed to
105
+ * the requester's DM via their user id rather than the channel id, so it is
106
+ * never posted into a shared channel. No-ops on channels without a deliverable
107
+ * route (e.g. email, the in-app vellum surface) or when the requester chat is
108
+ * unknown. Best-effort: a delivery failure is logged, never thrown.
109
+ */
110
+ async function notifyRequesterOfExpiry(
111
+ request: CanonicalGuardianRequest,
112
+ text: string,
113
+ ): Promise<void> {
114
+ const channel = request.sourceChannel ?? "";
115
+ const deliverUrl = resolveDeliverCallbackUrlForChannel(channel);
116
+ const requesterChatId =
117
+ request.requesterChatId ?? request.requesterExternalUserId ?? "";
118
+ const requesterExternalUserId = request.requesterExternalUserId ?? "";
119
+
120
+ if (!deliverUrl || !requesterChatId) {
121
+ return;
122
+ }
123
+
124
+ // On Slack, target the requester's DM (their `U…` user id) instead of the
125
+ // channel id so the expiry notice stays private. Other channels deliver to
126
+ // the requester chat directly.
127
+ const targetChatId =
128
+ channel === "slack" && requesterExternalUserId
129
+ ? requesterExternalUserId
130
+ : requesterChatId;
131
+
132
+ try {
133
+ await deliverChannelReply(deliverUrl, {
134
+ chatId: targetChatId,
135
+ text,
136
+ assistantId: DAEMON_INTERNAL_ASSISTANT_ID,
137
+ });
138
+ log.info(
139
+ { requestId: request.id, kind: request.kind, channel },
140
+ "Notified requester that guardian request expired",
141
+ );
142
+ } catch (err) {
143
+ log.warn(
144
+ { err, requestId: request.id, channel },
145
+ "Failed to notify requester of guardian request expiry (non-fatal)",
146
+ );
147
+ }
148
+ }
@@ -13,7 +13,7 @@
13
13
 
14
14
  import { answerCall } from "../calls/call-domain.js";
15
15
  import { findContactChannel } from "../contacts/contact-store.js";
16
- import { upsertContactChannel } from "../contacts/contacts-write.js";
16
+ import { activateMemberChannel } from "../contacts/member-write-relay.js";
17
17
  import { findConversation } from "../daemon/conversation-registry.js";
18
18
  import {
19
19
  type CanonicalGuardianRequest,
@@ -36,6 +36,7 @@ import { deliverChannelReply } from "../runtime/gateway-client.js";
36
36
  import * as pendingInteractions from "../runtime/pending-interactions.js";
37
37
  import { TC_GRANT_WAIT_MAX_MS } from "../tools/tool-approval-handler.js";
38
38
  import { getLogger } from "../util/logger.js";
39
+ import { resolveDeliverCallbackUrlForChannel } from "./guardian-channel-delivery.js";
39
40
 
40
41
  const log = getLogger("guardian-request-resolvers");
41
42
 
@@ -242,17 +243,6 @@ export type ResolverResult =
242
243
  }
243
244
  | { ok: false; reason: string };
244
245
 
245
- function resolveDeliverCallbackUrlForChannel(channel: string): string | null {
246
- switch (channel) {
247
- case "telegram":
248
- case "whatsapp":
249
- case "slack":
250
- return `/deliver/${channel}`;
251
- default:
252
- return null;
253
- }
254
- }
255
-
256
246
  /** Interface that kind-specific resolvers implement. */
257
247
  export interface GuardianRequestResolver {
258
248
  /** The request kind this resolver handles (matches canonical_guardian_requests.kind). */
@@ -602,19 +592,31 @@ const accessRequestResolver: GuardianRequestResolver = {
602
592
  // a verification session. The caller is already on the line and the
603
593
  // relay server's in-call wait loop will detect the approved status.
604
594
  if (channel === "phone") {
595
+ let activation: Awaited<ReturnType<typeof activateMemberChannel>>;
605
596
  try {
606
- upsertContactChannel({
597
+ // Gateway-first activation: the gateway owns the ACL verdict, the local
598
+ // mirror persists the caller's contact/channel identity.
599
+ activation = await activateMemberChannel({
607
600
  sourceChannel: "phone",
608
601
  externalUserId: requesterExternalUserId,
609
602
  externalChatId: requesterChatId,
610
- status: "active",
611
- policy: "allow",
612
603
  });
613
604
  } catch (err) {
614
605
  log.error(
615
606
  { err, requesterExternalUserId },
616
607
  "Access request resolver: failed to activate voice caller as trusted contact",
617
608
  );
609
+ return { ok: false, reason: "voice_activation_failed" };
610
+ }
611
+
612
+ // Fail-closed: a refused activation did not land on the gateway source of
613
+ // truth, so the caller is not actually trusted — do not report success.
614
+ if (activation.status === "refused") {
615
+ log.error(
616
+ { requesterExternalUserId },
617
+ "Access request resolver: gateway refused voice caller activation",
618
+ );
619
+ return { ok: false, reason: "voice_activation_refused" };
618
620
  }
619
621
 
620
622
  log.info(
@@ -15,7 +15,7 @@
15
15
 
16
16
  import { beforeEach, describe, expect, mock, test } from "bun:test";
17
17
 
18
- import type { AdmissionPolicy } from "@vellumai/gateway-client";
18
+ import type { AdmissionPolicy, TrustVerdict } from "@vellumai/gateway-client";
19
19
 
20
20
  import type {
21
21
  ChannelPolicy,
@@ -38,10 +38,20 @@ mock.module("../../config/loader.js", () => ({
38
38
  getConfig: () => ({ calls: { verification: { enabled: false } } }),
39
39
  }));
40
40
 
41
- // Controllable resolved trust context.
41
+ // Controllable resolved trust context. `resolveActorTrust` is a tracked mock
42
+ // so the verdict-source tests can assert the local fallback fires (or not).
43
+ // The verdict path uses the REAL, pure `actorTrustContextFromVerdict` /
44
+ // `verdictMemberUnresolvable` — no module mock — so this file leaks nothing
45
+ // into sibling test files sharing the bun process.
42
46
  let nextTrust: ActorTrustContext;
47
+ const resolveActorTrustMock = mock(() => nextTrust);
48
+ // Override only `resolveActorTrust`; the real `trust-verdict-consumer` imports
49
+ // `toTrustContext` from this module, so the rest must pass through untouched.
50
+ const actorTrustResolverModule =
51
+ await import("../../runtime/actor-trust-resolver.js");
43
52
  mock.module("../../runtime/actor-trust-resolver.js", () => ({
44
- resolveActorTrust: () => nextTrust,
53
+ ...actorTrustResolverModule,
54
+ resolveActorTrust: resolveActorTrustMock,
45
55
  }));
46
56
 
47
57
  // Controllable pending verification challenge.
@@ -81,13 +91,7 @@ function makeChannel(overrides: Partial<ContactChannel> = {}): ContactChannel {
81
91
  address: "+12025550142",
82
92
  isPrimary: true,
83
93
  externalChatId: null,
84
- status: "active",
85
- policy: "allow",
86
- verifiedAt: null,
87
- verifiedVia: null,
88
94
  inviteId: null,
89
- revokedReason: null,
90
- blockedReason: null,
91
95
  lastSeenAt: null,
92
96
  interactionCount: 0,
93
97
  lastInteraction: null,
@@ -104,13 +108,12 @@ function makeContact(
104
108
  id: "ct_1",
105
109
  displayName: "Test Caller",
106
110
  notes: null,
111
+ role: "contact",
107
112
  lastInteraction: null,
108
113
  interactionCount: 0,
109
114
  createdAt: 0,
110
115
  updatedAt: 0,
111
- role: "contact",
112
116
  contactType: "human",
113
- principalId: null,
114
117
  userFile: null,
115
118
  channels: [],
116
119
  ...overrides,
@@ -127,11 +130,11 @@ function makeTrust(
127
130
  ): ActorTrustContext {
128
131
  const memberRecord = channel
129
132
  ? {
130
- contact: makeContact({ role: channel.role ?? "contact" }),
131
- channel: makeChannel({
132
- status: channel.status,
133
- policy: channel.policy ?? "allow",
134
- }),
133
+ contact: makeContact(),
134
+ channel: makeChannel(),
135
+ status: channel.status,
136
+ policy: channel.policy ?? "allow",
137
+ role: channel.role ?? "contact",
135
138
  }
136
139
  : null;
137
140
  return {
@@ -151,13 +154,17 @@ function makeTrust(
151
154
  };
152
155
  }
153
156
 
154
- function route(admissionPolicy?: AdmissionPolicy | null) {
157
+ function route(
158
+ admissionPolicy?: AdmissionPolicy | null,
159
+ verdict?: TrustVerdict | null,
160
+ ) {
155
161
  return routeSetup({
156
162
  callSessionId: "cs_1",
157
163
  session: null, // inbound
158
164
  from: "+12025550142",
159
165
  to: "+12025550199",
160
166
  admissionPolicy,
167
+ verdict,
161
168
  });
162
169
  }
163
170
 
@@ -165,6 +172,7 @@ beforeEach(() => {
165
172
  pendingChallenge = null;
166
173
  activeInvites = [];
167
174
  boundContact = null;
175
+ resolveActorTrustMock.mockClear();
168
176
  });
169
177
 
170
178
  // ---------------------------------------------------------------------------
@@ -374,3 +382,245 @@ describe("routeSetup — floor bypasses", () => {
374
382
  expect(outcome.action).toBe("verification");
375
383
  });
376
384
  });
385
+
386
+ // ---------------------------------------------------------------------------
387
+ // Caller-trust source: gateway verdict first, local fallback
388
+ // ---------------------------------------------------------------------------
389
+
390
+ function makeVerdict(overrides: Partial<TrustVerdict> = {}): TrustVerdict {
391
+ return {
392
+ trustClass: "guardian",
393
+ canonicalSenderId: "+12025550142",
394
+ ...overrides,
395
+ };
396
+ }
397
+
398
+ // A verdict carrying a fully-resolvable member ACL (contactId/channelId + valid
399
+ // known status·policy enums). The verdict path builds a memberRecord from
400
+ // these, so it enforces blocked/revoked/deny.
401
+ function makeMemberVerdict(
402
+ trustClass: TrustVerdict["trustClass"],
403
+ channel: { status: string; policy?: string },
404
+ overrides: Partial<TrustVerdict> = {},
405
+ ): TrustVerdict {
406
+ return makeVerdict({
407
+ trustClass,
408
+ contactId: "ct_1",
409
+ channelId: "ch_1",
410
+ status: channel.status,
411
+ policy: channel.policy ?? "allow",
412
+ ...overrides,
413
+ });
414
+ }
415
+
416
+ describe("routeSetup — caller-trust source", () => {
417
+ test("present verdict builds trust from the verdict (no local resolve)", () => {
418
+ const { resolved, outcome } = route(
419
+ null,
420
+ makeMemberVerdict("guardian", { status: "active" }),
421
+ );
422
+
423
+ expect(resolveActorTrustMock).not.toHaveBeenCalled();
424
+ expect(resolved.actorTrust.trustClass).toBe("guardian");
425
+ expect(outcome.action).toBe("normal_call");
426
+ });
427
+
428
+ test("resolutionFailed verdict falls back to local resolveActorTrust", () => {
429
+ nextTrust = makeTrust("guardian", { status: "active", role: "guardian" });
430
+ const { resolved } = route(null, makeVerdict({ resolutionFailed: true }));
431
+
432
+ expect(resolveActorTrustMock).toHaveBeenCalledTimes(1);
433
+ expect(resolved.actorTrust.trustClass).toBe("guardian");
434
+ });
435
+
436
+ test("null verdict falls back to local resolveActorTrust", () => {
437
+ nextTrust = makeTrust("trusted_contact", { status: "active" });
438
+ const { resolved } = route(null, null);
439
+
440
+ expect(resolveActorTrustMock).toHaveBeenCalledTimes(1);
441
+ expect(resolved.actorTrust.trustClass).toBe("trusted_contact");
442
+ });
443
+
444
+ test("absent verdict falls back to local resolveActorTrust", () => {
445
+ nextTrust = makeTrust("guardian", { status: "active", role: "guardian" });
446
+ route(null);
447
+
448
+ expect(resolveActorTrustMock).toHaveBeenCalledTimes(1);
449
+ });
450
+
451
+ test("admission floor still applies on the verdict path (guardian_only denies trusted_contact)", () => {
452
+ const { outcome } = route(
453
+ "guardian_only",
454
+ makeMemberVerdict("trusted_contact", { status: "active" }),
455
+ );
456
+
457
+ expect(resolveActorTrustMock).not.toHaveBeenCalled();
458
+ expect(outcome.action).toBe("deny");
459
+ });
460
+
461
+ test("admission floor still applies on the fallback path (guardian_only denies trusted_contact)", () => {
462
+ nextTrust = makeTrust("trusted_contact", { status: "active" });
463
+ const { outcome } = route(
464
+ "guardian_only",
465
+ makeVerdict({ resolutionFailed: true }),
466
+ );
467
+
468
+ expect(resolveActorTrustMock).toHaveBeenCalledTimes(1);
469
+ expect(outcome.action).toBe("deny");
470
+ });
471
+ });
472
+
473
+ // ---------------------------------------------------------------------------
474
+ // Verdict-path ACL: blocked / revoked / deny enforced from the verdict-derived
475
+ // memberRecord (no local fallback). Guards the P1 where a verdict member with
476
+ // no memberRecord bypassed these gates.
477
+ // ---------------------------------------------------------------------------
478
+
479
+ describe("routeSetup — verdict path enforces member ACL", () => {
480
+ test("blocked member via verdict is denied (not normal_call) under permissive floor", () => {
481
+ const { outcome } = route(
482
+ "strangers",
483
+ makeMemberVerdict("unknown", { status: "blocked" }),
484
+ );
485
+
486
+ expect(resolveActorTrustMock).not.toHaveBeenCalled();
487
+ expect(outcome.action).toBe("deny");
488
+ });
489
+
490
+ test("revoked member via verdict is denied under permissive floor", () => {
491
+ const { outcome } = route(
492
+ "strangers",
493
+ makeMemberVerdict("unknown", { status: "revoked" }),
494
+ );
495
+
496
+ expect(resolveActorTrustMock).not.toHaveBeenCalled();
497
+ expect(outcome.action).toBe("deny");
498
+ });
499
+
500
+ test("policy deny member via verdict is denied (not normal_call)", () => {
501
+ const { outcome } = route(
502
+ null,
503
+ makeMemberVerdict("trusted_contact", {
504
+ status: "active",
505
+ policy: "deny",
506
+ }),
507
+ );
508
+
509
+ expect(resolveActorTrustMock).not.toHaveBeenCalled();
510
+ expect(outcome.action).toBe("deny");
511
+ });
512
+
513
+ test("policy escalate member via verdict is denied (live call can't await approval)", () => {
514
+ const { outcome } = route(
515
+ null,
516
+ makeMemberVerdict("trusted_contact", {
517
+ status: "active",
518
+ policy: "escalate",
519
+ }),
520
+ );
521
+
522
+ expect(resolveActorTrustMock).not.toHaveBeenCalled();
523
+ expect(outcome.action).toBe("deny");
524
+ });
525
+
526
+ test("trusted/active member via verdict still admits to normal_call", () => {
527
+ const { outcome } = route(
528
+ null,
529
+ makeMemberVerdict("trusted_contact", {
530
+ status: "active",
531
+ policy: "allow",
532
+ }),
533
+ );
534
+
535
+ expect(resolveActorTrustMock).not.toHaveBeenCalled();
536
+ expect(outcome.action).toBe("normal_call");
537
+ });
538
+
539
+ test("guardian via verdict still admits to normal_call", () => {
540
+ const { outcome } = route(
541
+ null,
542
+ makeMemberVerdict("guardian", { status: "active" }),
543
+ );
544
+
545
+ expect(resolveActorTrustMock).not.toHaveBeenCalled();
546
+ expect(outcome.action).toBe("normal_call");
547
+ });
548
+ });
549
+
550
+ // ---------------------------------------------------------------------------
551
+ // Unresolvable member verdict → local fallback (never trust an un-ACL-checkable
552
+ // member). A verdict claiming a member (contactId/channelId) whose ACL can't be
553
+ // reassembled (missing/unknown status·policy) must take the local resolveActorTrust
554
+ // path so the member is ACL-checked locally, not trusted by trustClass.
555
+ // ---------------------------------------------------------------------------
556
+
557
+ describe("routeSetup — unresolvable member verdict falls back to local", () => {
558
+ test("member identity with missing status falls back to local resolveActorTrust", () => {
559
+ nextTrust = makeTrust("trusted_contact", { status: "active" });
560
+ const { resolved } = route(
561
+ null,
562
+ makeVerdict({
563
+ trustClass: "trusted_contact",
564
+ contactId: "ct_1",
565
+ channelId: "ch_1",
566
+ policy: "allow",
567
+ // status absent → unresolvable
568
+ }),
569
+ );
570
+
571
+ expect(resolveActorTrustMock).toHaveBeenCalledTimes(1);
572
+ expect(resolved.actorTrust.trustClass).toBe("trusted_contact");
573
+ });
574
+
575
+ test("member identity with unknown status falls back to local resolveActorTrust", () => {
576
+ nextTrust = makeTrust("trusted_contact", { status: "active" });
577
+ route(
578
+ null,
579
+ makeVerdict({
580
+ trustClass: "trusted_contact",
581
+ contactId: "ct_1",
582
+ channelId: "ch_1",
583
+ status: "bogus",
584
+ policy: "allow",
585
+ }),
586
+ );
587
+
588
+ expect(resolveActorTrustMock).toHaveBeenCalledTimes(1);
589
+ });
590
+
591
+ test("member identity with unknown policy falls back to local resolveActorTrust", () => {
592
+ nextTrust = makeTrust("trusted_contact", { status: "active" });
593
+ route(
594
+ null,
595
+ makeVerdict({
596
+ trustClass: "trusted_contact",
597
+ contactId: "ct_1",
598
+ channelId: "ch_1",
599
+ status: "active",
600
+ policy: "bogus",
601
+ }),
602
+ );
603
+
604
+ expect(resolveActorTrustMock).toHaveBeenCalledTimes(1);
605
+ });
606
+
607
+ test("real stranger verdict (no member identity) still takes the verdict path", () => {
608
+ const { resolved } = route(null, makeVerdict({ trustClass: "unknown" }));
609
+
610
+ expect(resolveActorTrustMock).not.toHaveBeenCalled();
611
+ expect(resolved.actorTrust.trustClass).toBe("unknown");
612
+ });
613
+
614
+ test("valid member verdict (good status+policy) still takes the verdict path", () => {
615
+ const { outcome } = route(
616
+ null,
617
+ makeMemberVerdict("trusted_contact", {
618
+ status: "active",
619
+ policy: "allow",
620
+ }),
621
+ );
622
+
623
+ expect(resolveActorTrustMock).not.toHaveBeenCalled();
624
+ expect(outcome.action).toBe("normal_call");
625
+ });
626
+ });
@@ -267,9 +267,9 @@ type CreateInboundVoiceSessionResult = {
267
267
  * returned without creating a duplicate. This handles Twilio webhook
268
268
  * replays gracefully.
269
269
  */
270
- export function createInboundVoiceSession(
270
+ export async function createInboundVoiceSession(
271
271
  input: CreateInboundVoiceSessionInput,
272
- ): CreateInboundVoiceSessionResult {
272
+ ): Promise<CreateInboundVoiceSessionResult> {
273
273
  const {
274
274
  callSid,
275
275
  fromNumber,
@@ -312,7 +312,7 @@ export function createInboundVoiceSession(
312
312
  updateCallSession(session.id, { providerCallSid: callSid });
313
313
  session.providerCallSid = callSid;
314
314
 
315
- const callerIsGuardian = isGuardian(assistantId, "phone", fromNumber);
315
+ const callerIsGuardian = await isGuardian(assistantId, "phone", fromNumber);
316
316
  const metadataHints: string[] = [
317
317
  callerIsGuardian
318
318
  ? "Caller is the guardian"
@@ -7,7 +7,10 @@
7
7
  * 3. Records guardian_action_delivery rows from pipeline delivery results
8
8
  */
9
9
 
10
- import { findGuardianForChannel } from "../contacts/contact-store.js";
10
+ import {
11
+ getGuardianDelivery,
12
+ guardianForChannel,
13
+ } from "../contacts/guardian-delivery-reader.js";
11
14
  import {
12
15
  createCanonicalGuardianRequest,
13
16
  listCanonicalGuardianDeliveries,
@@ -86,14 +89,16 @@ async function dispatchGuardianQuestionInner(
86
89
  try {
87
90
  const expiresAt = Date.now() + getUserConsultationTimeoutMs();
88
91
 
89
- // Voice decisions are handled in guardian conversations tied to the assistant-
90
- // level guardian identity. Resolve the principal from the contacts table.
91
- let guardianPrincipalId: string | undefined;
92
-
93
- const guardianResult = findGuardianForChannel("vellum");
94
- if (guardianResult?.contact.principalId) {
95
- guardianPrincipalId = guardianResult.contact.principalId;
96
- }
92
+ // Resolve the request principal from the gateway guardian delivery — the
93
+ // same source the submitting actor (guardian-action-routes /
94
+ // actor-trust-resolver) resolves, so they cannot diverge.
95
+ // applyCanonicalGuardianDecision requires strict equality with
96
+ // request.guardianPrincipalId; sharing this gateway source guarantees the
97
+ // stamped principal == the submitting principal.
98
+ const guardians = await getGuardianDelivery({ channelTypes: ["vellum"] });
99
+ const guardianPrincipalId = guardians
100
+ ? (guardianForChannel(guardians, "vellum")?.principalId ?? undefined)
101
+ : undefined;
97
102
 
98
103
  if (!guardianPrincipalId) {
99
104
  log.error(