@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
@@ -36,17 +36,36 @@ mock.module("../prompts/system-prompt.js", () => ({
36
36
  buildCoreIdentityContext: () => null,
37
37
  }));
38
38
 
39
- // ── Guardian contact mock ────────────────────────────────────────────
39
+ // ── Guardian binding + contact notes mocks ───────────────────────────
40
40
 
41
- let mockGuardianResult: {
42
- contact: { notes: string | null };
43
- channels: Record<string, unknown>[];
44
- } | null = null;
41
+ // Guardian binding (ACL) is resolved via the gateway pull; notes (INFO) are
42
+ // joined locally by contactId. Tests drive both via mutable slots.
43
+ let guardianDeliveryFixture: Array<{ contactId: string }> = [];
44
+ let contactInfoFixture: Record<string, { notes: string | null } | null> = {};
45
+
46
+ mock.module("../contacts/guardian-delivery-reader.js", () => ({
47
+ getGuardianDelivery: async () => guardianDeliveryFixture,
48
+ anyGuardian: (list: Array<{ contactId: string }>) => list[0],
49
+ }));
45
50
 
46
51
  mock.module("../contacts/contact-store.js", () => ({
47
- listGuardianChannels: () => mockGuardianResult,
52
+ findContactInfoById: (contactId: string) =>
53
+ contactInfoFixture[contactId] ?? null,
48
54
  }));
49
55
 
56
+ const GUARDIAN_CONTACT_ID = "guardian-contact-1";
57
+
58
+ /** Bind a guardian with the given notes (or no guardian when notes is null). */
59
+ function setGuardian(notes: string | null | undefined): void {
60
+ if (notes === undefined) {
61
+ guardianDeliveryFixture = [];
62
+ contactInfoFixture = {};
63
+ return;
64
+ }
65
+ guardianDeliveryFixture = [{ contactId: GUARDIAN_CONTACT_ID }];
66
+ contactInfoFixture = { [GUARDIAN_CONTACT_ID]: { notes } };
67
+ }
68
+
50
69
  // ── Provider mock with system prompt capture ──────────────────────────
51
70
 
52
71
  let configuredProvider: {
@@ -134,15 +153,12 @@ describe("recipient context in notification decision engine", () => {
134
153
  beforeEach(() => {
135
154
  configuredProvider = null;
136
155
  extractedToolUse = null;
137
- mockGuardianResult = null;
156
+ setGuardian(undefined);
138
157
  capturedSystemPrompt = undefined;
139
158
  });
140
159
 
141
160
  test("guardian contact notes appear in system prompt as <recipient-context>", async () => {
142
- mockGuardianResult = {
143
- contact: { notes: "Prefers formal tone. Address as Dr. Smith." },
144
- channels: [{ type: "vellum" }],
145
- };
161
+ setGuardian("Prefers formal tone. Address as Dr. Smith.");
146
162
  setupLLMProvider();
147
163
 
148
164
  const signal = makeSignal();
@@ -157,7 +173,7 @@ describe("recipient context in notification decision engine", () => {
157
173
  });
158
174
 
159
175
  test("recipient-context is omitted when no guardian exists", async () => {
160
- mockGuardianResult = null;
176
+ setGuardian(undefined);
161
177
  setupLLMProvider();
162
178
 
163
179
  const signal = makeSignal();
@@ -169,10 +185,7 @@ describe("recipient context in notification decision engine", () => {
169
185
  });
170
186
 
171
187
  test("recipient-context is omitted when guardian notes are null", async () => {
172
- mockGuardianResult = {
173
- contact: { notes: null },
174
- channels: [{ type: "vellum" }],
175
- };
188
+ setGuardian(null);
176
189
  setupLLMProvider();
177
190
 
178
191
  const signal = makeSignal();
@@ -184,10 +197,7 @@ describe("recipient context in notification decision engine", () => {
184
197
  });
185
198
 
186
199
  test("recipient-context is omitted when guardian notes are empty string", async () => {
187
- mockGuardianResult = {
188
- contact: { notes: "" },
189
- channels: [{ type: "vellum" }],
190
- };
200
+ setGuardian("");
191
201
  setupLLMProvider();
192
202
 
193
203
  const signal = makeSignal();
@@ -199,10 +209,7 @@ describe("recipient context in notification decision engine", () => {
199
209
  });
200
210
 
201
211
  test("large guardian notes are truncated to prevent oversized prompts", async () => {
202
- mockGuardianResult = {
203
- contact: { notes: "N".repeat(3000) },
204
- channels: [{ type: "vellum" }],
205
- };
212
+ setGuardian("N".repeat(3000));
206
213
  setupLLMProvider();
207
214
 
208
215
  const signal = makeSignal();
@@ -226,10 +233,7 @@ describe("recipient context in notification decision engine", () => {
226
233
  });
227
234
 
228
235
  test("fallback path works correctly without recipient context", async () => {
229
- mockGuardianResult = {
230
- contact: { notes: "Prefers formal tone." },
231
- channels: [{ type: "vellum" }],
232
- };
236
+ setGuardian("Prefers formal tone.");
233
237
  // null provider forces fallback path
234
238
  configuredProvider = null;
235
239
 
@@ -247,10 +251,7 @@ describe("recipient context in notification decision engine", () => {
247
251
  });
248
252
 
249
253
  test("recipient-context appears after user-preferences in prompt", async () => {
250
- mockGuardianResult = {
251
- contact: { notes: "Prefers brief updates." },
252
- channels: [{ type: "vellum" }],
253
- };
254
+ setGuardian("Prefers brief updates.");
254
255
  setupLLMProvider();
255
256
 
256
257
  const signal = makeSignal();
@@ -20,6 +20,10 @@ mock.module("../util/logger.js", () => ({
20
20
  }),
21
21
  }));
22
22
 
23
+ mock.module("../contacts/guardian-delivery-reader.js", () => ({
24
+ getGuardianDelivery: async () => null,
25
+ }));
26
+
23
27
  // Mock destination-resolver for broadcaster tests
24
28
  mock.module("../notifications/destination-resolver.js", () => ({
25
29
  resolveDestinations: (channels: string[]) => {
@@ -42,6 +46,8 @@ mock.module("../notifications/deliveries-store.js", () => ({
42
46
  // can be driven from tests without DB access.
43
47
  let mockExistingConversations: Record<string, { id: string }> = {};
44
48
  mock.module("../memory/conversation-crud.js", () => ({
49
+ setConversationProcessingStartedAt: () => {},
50
+ isConversationProcessing: () => false,
45
51
  getConversation: (id: string) => mockExistingConversations[id] ?? null,
46
52
  }));
47
53
 
@@ -68,6 +68,25 @@ mock.module("../notifications/emit-signal.js", () => ({
68
68
  },
69
69
  }));
70
70
 
71
+ // Guardian principalId is resolved from the gateway binding reader. Mirror the
72
+ // seeded vellum binding so dispatch can resolve the principal.
73
+ mock.module("../contacts/guardian-delivery-reader.js", () => ({
74
+ getGuardianDelivery: async () => [
75
+ {
76
+ channelType: "vellum",
77
+ contactId: "guardian-vellum",
78
+ principalId: "test-principal-id",
79
+ address: "local",
80
+ status: "active",
81
+ },
82
+ ],
83
+ guardianForChannel: (
84
+ list: Array<{ channelType: string; status: string }>,
85
+ channelType: string,
86
+ ) => list.find((g) => g.channelType === channelType && g.status === "active"),
87
+ anyGuardian: (list: unknown[]) => list[0],
88
+ }));
89
+
71
90
  import {
72
91
  createCallSession,
73
92
  createPendingQuestion,
@@ -30,11 +30,24 @@ import {
30
30
 
31
31
  // ── Mock state ────────────────────────────────────────────────────
32
32
 
33
+ interface GuardianDeliveryStub {
34
+ channelType: string;
35
+ address: string;
36
+ status: string;
37
+ }
38
+
33
39
  let mockWorkspaceDir: string = "";
34
- let mockVellumGuardian: {
35
- contact: { userFile: string | null };
36
- channel: Record<string, unknown>;
37
- } | null = null;
40
+ // Gateway guardian delivery cache; the guardian's userFile (local INFO) is
41
+ // joined via findContactByAddress on the delivery's address.
42
+ let mockGuardianDeliveries: GuardianDeliveryStub[] = [];
43
+ let mockContactsByAddress: Record<string, { userFile: string | null }> = {};
44
+
45
+ function seedVellumGuardian(userFile: string | null): void {
46
+ mockGuardianDeliveries = [
47
+ { channelType: "vellum", address: "vellum:self", status: "active" },
48
+ ];
49
+ mockContactsByAddress["vellum:vellum:self"] = { userFile };
50
+ }
38
51
 
39
52
  // ── Mock modules (must precede imports from the module under test) ──
40
53
 
@@ -59,10 +72,20 @@ mock.module("../util/platform.js", () => ({
59
72
  }));
60
73
 
61
74
  mock.module("../contacts/contact-store.js", () => ({
62
- findContactByAddress: () => null,
63
- findGuardianForChannel: (channelType: string) =>
64
- channelType === "vellum" ? mockVellumGuardian : null,
65
- listGuardianChannels: () => null,
75
+ findContactByAddress: (channelType: string, address: string) =>
76
+ mockContactsByAddress[`${channelType}:${address}`] ?? null,
77
+ }));
78
+
79
+ mock.module("../contacts/guardian-delivery-reader.js", () => ({
80
+ peekCachedGuardianDelivery: (input?: { channelTypes?: string[] }) => {
81
+ if (!input?.channelTypes) return mockGuardianDeliveries;
82
+ return mockGuardianDeliveries.filter((g) =>
83
+ input.channelTypes!.includes(g.channelType),
84
+ );
85
+ },
86
+ guardianForChannel: (list: GuardianDeliveryStub[], channelType: string) =>
87
+ list.find((g) => g.channelType === channelType && g.status === "active"),
88
+ anyGuardian: (list: GuardianDeliveryStub[]) => list[0],
66
89
  }));
67
90
 
68
91
  // Import AFTER mocks so the module under test binds to the stubbed
@@ -87,7 +110,8 @@ afterAll(() => {
87
110
 
88
111
  beforeEach(() => {
89
112
  mockWorkspaceDir = mkdtempSync(join(testRoot, "ws-"));
90
- mockVellumGuardian = null;
113
+ mockGuardianDeliveries = [];
114
+ mockContactsByAddress = {};
91
115
  });
92
116
 
93
117
  afterEach(() => {
@@ -98,10 +122,7 @@ afterEach(() => {
98
122
 
99
123
  describe("writeOnboardingSection", () => {
100
124
  test("writes section to guardian persona file when it exists", () => {
101
- mockVellumGuardian = {
102
- contact: { userFile: "alice.md" },
103
- channel: {},
104
- };
125
+ seedVellumGuardian("alice.md");
105
126
  const guardianPath = workspacePath("users/alice.md");
106
127
  mkdirSync(workspacePath("users"), { recursive: true });
107
128
  writeFileSync(guardianPath, "# User Profile\n\n- **Name:** Alice\n");
@@ -123,7 +144,8 @@ describe("writeOnboardingSection", () => {
123
144
  });
124
145
 
125
146
  test("falls back to users/default.md when guardian path is null", () => {
126
- mockVellumGuardian = null;
147
+ mockGuardianDeliveries = [];
148
+ mockContactsByAddress = {};
127
149
  mkdirSync(workspacePath("users"), { recursive: true });
128
150
  writeFileSync(
129
151
  workspacePath("users/default.md"),
@@ -147,7 +169,8 @@ describe("writeOnboardingSection", () => {
147
169
  });
148
170
 
149
171
  test("falls back to USER.md when no users/ files exist", () => {
150
- mockVellumGuardian = null;
172
+ mockGuardianDeliveries = [];
173
+ mockContactsByAddress = {};
151
174
 
152
175
  writeOnboardingSection({
153
176
  preferredName: "Alice",
@@ -162,7 +185,8 @@ describe("writeOnboardingSection", () => {
162
185
  });
163
186
 
164
187
  test("creates file with header + section when target doesn't exist", () => {
165
- mockVellumGuardian = null;
188
+ mockGuardianDeliveries = [];
189
+ mockContactsByAddress = {};
166
190
 
167
191
  writeOnboardingSection({
168
192
  preferredName: "Alice",
@@ -179,7 +203,8 @@ describe("writeOnboardingSection", () => {
179
203
  });
180
204
 
181
205
  test("idempotent: calling twice produces the same file content", () => {
182
- mockVellumGuardian = null;
206
+ mockGuardianDeliveries = [];
207
+ mockContactsByAddress = {};
183
208
  const normalized = {
184
209
  preferredName: "Alice",
185
210
  commonWork: ["builds code, apps, or tools"],
@@ -196,7 +221,8 @@ describe("writeOnboardingSection", () => {
196
221
  });
197
222
 
198
223
  test("replaces existing onboarding section with updated data", () => {
199
- mockVellumGuardian = null;
224
+ mockGuardianDeliveries = [];
225
+ mockContactsByAddress = {};
200
226
 
201
227
  writeOnboardingSection({
202
228
  preferredName: "Alice",
@@ -222,7 +248,8 @@ describe("writeOnboardingSection", () => {
222
248
  });
223
249
 
224
250
  test("preserves content outside the managed section", () => {
225
- mockVellumGuardian = null;
251
+ mockGuardianDeliveries = [];
252
+ mockContactsByAddress = {};
226
253
  writeFileSync(
227
254
  workspacePath("USER.md"),
228
255
  "# User Profile\n\n- **Name:** Alice\n- **Role:** Engineer\n",
@@ -242,7 +269,8 @@ describe("writeOnboardingSection", () => {
242
269
  });
243
270
 
244
271
  test("omits empty fields", () => {
245
- mockVellumGuardian = null;
272
+ mockGuardianDeliveries = [];
273
+ mockContactsByAddress = {};
246
274
 
247
275
  writeOnboardingSection({
248
276
  commonWork: [],
@@ -257,7 +285,8 @@ describe("writeOnboardingSection", () => {
257
285
  });
258
286
 
259
287
  test("omits preferredName when undefined", () => {
260
- mockVellumGuardian = null;
288
+ mockGuardianDeliveries = [];
289
+ mockContactsByAddress = {};
261
290
 
262
291
  writeOnboardingSection({
263
292
  preferredName: undefined,
@@ -272,7 +301,8 @@ describe("writeOnboardingSection", () => {
272
301
  });
273
302
 
274
303
  test("preserves content after onboarding section when followed by another heading", () => {
275
- mockVellumGuardian = null;
304
+ mockGuardianDeliveries = [];
305
+ mockContactsByAddress = {};
276
306
  writeFileSync(
277
307
  workspacePath("USER.md"),
278
308
  [
@@ -58,6 +58,16 @@ let lastConstructorOptions: Record<string, unknown> | null = null;
58
58
  let shouldThrow: Error | null = null;
59
59
  const DEFAULT_SDK_TIMEOUT_MS = 1_860_000;
60
60
 
61
+ // Each provider installs a `fetch` wrapper to capture raw error bodies, so the
62
+ // constructor options carry a `fetch` function; assert the meaningful options
63
+ // via objectContaining and confirm `fetch` is wired.
64
+ function expectOpenAIConstructorOptions(
65
+ expected: Record<string, unknown>,
66
+ ): void {
67
+ expect(lastConstructorOptions).toEqual(expect.objectContaining(expected));
68
+ expect(typeof lastConstructorOptions?.fetch).toBe("function");
69
+ }
70
+
61
71
  function userMsg(text: string): Message {
62
72
  return { role: "user", content: [{ type: "text", text }] };
63
73
  }
@@ -309,7 +319,7 @@ describe("OpenAIProvider", () => {
309
319
  });
310
320
 
311
321
  expect(compatible.name).toBe("ollama");
312
- expect(lastConstructorOptions).toEqual({
322
+ expectOpenAIConstructorOptions({
313
323
  apiKey: "sk-local",
314
324
  baseURL: "http://127.0.0.1:11434/v1",
315
325
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -322,7 +332,7 @@ describe("OpenAIProvider", () => {
322
332
  delete process.env.OLLAMA_BASE_URL;
323
333
  const ollama = new OllamaProvider("llama3.2");
324
334
  expect(ollama.name).toBe("ollama");
325
- expect(lastConstructorOptions).toEqual({
335
+ expectOpenAIConstructorOptions({
326
336
  apiKey: "ollama",
327
337
  baseURL: "http://127.0.0.1:11434/v1",
328
338
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -342,7 +352,7 @@ describe("OpenAIProvider", () => {
342
352
  process.env.OLLAMA_BASE_URL = " ";
343
353
  const ollama = new OllamaProvider("llama3.2");
344
354
  expect(ollama.name).toBe("ollama");
345
- expect(lastConstructorOptions).toEqual({
355
+ expectOpenAIConstructorOptions({
346
356
  apiKey: "ollama",
347
357
  baseURL: "http://127.0.0.1:11434/v1",
348
358
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -1260,7 +1270,7 @@ describe("custom baseURL initialization", () => {
1260
1270
  });
1261
1271
 
1262
1272
  expect(managed.name).toBe("openai");
1263
- expect(lastConstructorOptions).toEqual({
1273
+ expectOpenAIConstructorOptions({
1264
1274
  apiKey: "ast-key-123",
1265
1275
  baseURL: "https://platform.example.com/v1/runtime-proxy/openai",
1266
1276
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -1270,7 +1280,7 @@ describe("custom baseURL initialization", () => {
1270
1280
  test("OpenAIProvider without baseURL calls provider directly", () => {
1271
1281
  new OpenAIProvider("sk-user-key", "gpt-4o");
1272
1282
 
1273
- expect(lastConstructorOptions).toEqual({
1283
+ expectOpenAIConstructorOptions({
1274
1284
  apiKey: "sk-user-key",
1275
1285
  baseURL: undefined,
1276
1286
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -1282,7 +1292,7 @@ describe("custom baseURL initialization", () => {
1282
1292
  streamTimeoutMs: 300_000,
1283
1293
  });
1284
1294
 
1285
- expect(lastConstructorOptions).toEqual({
1295
+ expectOpenAIConstructorOptions({
1286
1296
  apiKey: "sk-user-key",
1287
1297
  baseURL: undefined,
1288
1298
  timeout: 360_000,
@@ -1299,7 +1309,7 @@ describe("custom baseURL initialization", () => {
1299
1309
  );
1300
1310
 
1301
1311
  expect(managed.name).toBe("fireworks");
1302
- expect(lastConstructorOptions).toEqual({
1312
+ expectOpenAIConstructorOptions({
1303
1313
  apiKey: "ast-key-123",
1304
1314
  baseURL: "https://platform.example.com/v1/runtime-proxy/fireworks",
1305
1315
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -1312,7 +1322,7 @@ describe("custom baseURL initialization", () => {
1312
1322
  "accounts/fireworks/models/llama-v3p1-70b-instruct",
1313
1323
  );
1314
1324
 
1315
- expect(lastConstructorOptions).toEqual({
1325
+ expectOpenAIConstructorOptions({
1316
1326
  apiKey: "fw-user-key",
1317
1327
  baseURL: "https://api.fireworks.ai/inference/v1",
1318
1328
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -1325,7 +1335,7 @@ describe("custom baseURL initialization", () => {
1325
1335
  });
1326
1336
 
1327
1337
  expect(managed.name).toBe("openrouter");
1328
- expect(lastConstructorOptions).toEqual({
1338
+ expectOpenAIConstructorOptions({
1329
1339
  apiKey: "ast-key-123",
1330
1340
  baseURL: "https://platform.example.com/v1/runtime-proxy/openrouter",
1331
1341
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -1335,7 +1345,7 @@ describe("custom baseURL initialization", () => {
1335
1345
  test("OpenRouterProvider without custom baseURL uses default OpenRouter URL", () => {
1336
1346
  new OpenRouterProvider("or-user-key", "openai/gpt-4o");
1337
1347
 
1338
- expect(lastConstructorOptions).toEqual({
1348
+ expectOpenAIConstructorOptions({
1339
1349
  apiKey: "or-user-key",
1340
1350
  baseURL: "https://openrouter.ai/api/v1",
1341
1351
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -1348,7 +1358,7 @@ describe("custom baseURL initialization", () => {
1348
1358
  });
1349
1359
 
1350
1360
  expect(managed.name).toBe("minimax");
1351
- expect(lastConstructorOptions).toEqual({
1361
+ expectOpenAIConstructorOptions({
1352
1362
  apiKey: "ast-key-123",
1353
1363
  baseURL: "https://platform.example.com/v1/runtime-proxy/minimax",
1354
1364
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -1358,7 +1368,7 @@ describe("custom baseURL initialization", () => {
1358
1368
  test("MinimaxProvider without custom baseURL uses default MiniMax URL", () => {
1359
1369
  new MinimaxProvider("mm-user-key", "MiniMax-M2.7");
1360
1370
 
1361
- expect(lastConstructorOptions).toEqual({
1371
+ expectOpenAIConstructorOptions({
1362
1372
  apiKey: "mm-user-key",
1363
1373
  baseURL: "https://api.minimax.io/v1",
1364
1374
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -24,6 +24,16 @@ let lastConstructorOptions: Record<string, unknown> | null = null;
24
24
  let shouldThrow: Error | null = null;
25
25
  const DEFAULT_SDK_TIMEOUT_MS = 1_860_000;
26
26
 
27
+ // Each provider installs a `fetch` wrapper to capture raw error bodies, so the
28
+ // constructor options carry a `fetch` function; assert the meaningful options
29
+ // via objectContaining and confirm `fetch` is wired.
30
+ function expectOpenAIConstructorOptions(
31
+ expected: Record<string, unknown>,
32
+ ): void {
33
+ expect(lastConstructorOptions).toEqual(expect.objectContaining(expected));
34
+ expect(typeof lastConstructorOptions?.fetch).toBe("function");
35
+ }
36
+
27
37
  // Simulate OpenAI.APIError
28
38
  class FakeAPIError extends Error {
29
39
  status: number;
@@ -218,7 +228,7 @@ describe("OpenAIResponsesProvider", () => {
218
228
  providerLabel: "Managed OpenAI",
219
229
  });
220
230
 
221
- expect(lastConstructorOptions).toEqual({
231
+ expectOpenAIConstructorOptions({
222
232
  apiKey: "sk-custom",
223
233
  baseURL: "https://proxy.example.com/v1",
224
234
  timeout: DEFAULT_SDK_TIMEOUT_MS,
@@ -230,7 +240,7 @@ describe("OpenAIResponsesProvider", () => {
230
240
  streamTimeoutMs: 300_000,
231
241
  });
232
242
 
233
- expect(lastConstructorOptions).toEqual({
243
+ expectOpenAIConstructorOptions({
234
244
  apiKey: "sk-custom",
235
245
  baseURL: undefined,
236
246
  timeout: 360_000,
@@ -72,6 +72,8 @@ const persistedRows: Array<{
72
72
  metadata: string | null;
73
73
  }> = [];
74
74
  mock.module("../memory/conversation-crud.js", () => ({
75
+ setConversationProcessingStartedAt: () => {},
76
+ isConversationProcessing: () => false,
75
77
  addMessage: (
76
78
  conversationId: string,
77
79
  role: string,
@@ -155,7 +155,7 @@ describe("pendingInteractions.resolve emits interaction_resolved", () => {
155
155
  });
156
156
 
157
157
  describe("removeByConversation emits interaction_resolved per entry", () => {
158
- test("emits superseded for every non-host interaction in the conversation", () => {
158
+ test("emits superseded for every confirmation/secret interaction in the conversation", () => {
159
159
  pendingInteractions.register("conf-1", {
160
160
  conversationId: "conv-x",
161
161
  kind: "confirmation",
@@ -182,13 +182,16 @@ describe("removeByConversation emits interaction_resolved per entry", () => {
182
182
  const events = publishedMessages.filter(
183
183
  (m) => m.type === "interaction_resolved",
184
184
  ) as Extract<ServerMessage, { type: "interaction_resolved" }>[];
185
- expect(events).toHaveLength(3);
185
+ expect(events).toHaveLength(2);
186
186
  expect(events.every((e) => e.state === "superseded")).toBe(true);
187
187
  const requestIds = new Set(events.map((e) => e.requestId));
188
- expect(requestIds).toEqual(new Set(["conf-1", "secret-1", "question-1"]));
188
+ expect(requestIds).toEqual(new Set(["conf-1", "secret-1"]));
189
189
 
190
- // host_bash entries survive auto-deny — no event for them.
190
+ // host_bash and question entries both survive auto-deny — no event for
191
+ // either. host proxies are settled by their result POST; questions by the
192
+ // enqueue steer's turn abort (see removeByConversation's skip list).
191
193
  expect(pendingInteractions.get("host-bash-1")).toBeDefined();
194
+ expect(pendingInteractions.get("question-1")).toBeDefined();
192
195
  // Unrelated conversation is untouched.
193
196
  expect(pendingInteractions.get("conf-other")).toBeDefined();
194
197
  });
@@ -23,6 +23,7 @@ mock.module("../util/logger.js", () => ({
23
23
  truncateForLog: (v: string) => v,
24
24
  initLogger: () => {},
25
25
  pruneOldLogFiles: () => 0,
26
+ getCurrentLogFilePath: () => "/tmp/test-assistant.log",
26
27
  }));
27
28
 
28
29
  let writeRelationshipStateCalled = false;
@@ -48,6 +48,8 @@ interface AddMessageCall {
48
48
  }
49
49
  const addMessageCalls: AddMessageCall[] = [];
50
50
  mock.module("../memory/conversation-crud.js", () => ({
51
+ setConversationProcessingStartedAt: () => {},
52
+ isConversationProcessing: () => false,
51
53
  addMessage: (
52
54
  conversationId: string,
53
55
  role: string,