@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
@@ -7,7 +7,14 @@
7
7
  * cache miss (changed mtime → re-import), plugin deletion (eviction),
8
8
  * and hook collection across multiple plugins.
9
9
  */
10
- import { mkdirSync, rmSync, utimesSync,writeFileSync } from "node:fs";
10
+ import {
11
+ existsSync,
12
+ mkdirSync,
13
+ readFileSync,
14
+ rmSync,
15
+ utimesSync,
16
+ writeFileSync,
17
+ } from "node:fs";
11
18
  import { tmpdir } from "node:os";
12
19
  import { join } from "node:path";
13
20
  import {
@@ -19,14 +26,19 @@ import {
19
26
  test,
20
27
  } from "bun:test";
21
28
 
29
+ import { _inspectHookCacheForTests } from "../hooks/hook-loader.js";
22
30
  import {
23
- _inspectHookCacheForTests,
24
31
  _inspectToolCacheForTests,
25
32
  getCachedUserTools,
26
33
  getUserHooksFor,
27
34
  populateCacheAtBoot,
28
35
  resetPluginCacheForTests,
29
36
  } from "../plugins/mtime-cache.js";
37
+ import {
38
+ getAllToolDefinitions,
39
+ getPluginToolDefinitions,
40
+ getToolOwner,
41
+ } from "../tools/registry.js";
30
42
 
31
43
  // ─── Test fixtures ───────────────────────────────────────────────────────────
32
44
 
@@ -62,7 +74,15 @@ function writeHook(dir: string, hookName: string, body: string): void {
62
74
  function writeInstallMeta(dir: string, installedAt: string): void {
63
75
  writeFileSync(
64
76
  join(dir, "install-meta.json"),
65
- JSON.stringify({ name: "test", installedAt, source: { kind: "github", owner: "test", repo: "test", ref: "main" } }, null, 2),
77
+ JSON.stringify(
78
+ {
79
+ name: "test",
80
+ installedAt,
81
+ source: { kind: "github", owner: "test", repo: "test", ref: "main" },
82
+ },
83
+ null,
84
+ 2,
85
+ ),
66
86
  );
67
87
  }
68
88
 
@@ -72,6 +92,20 @@ function writeTool(dir: string, toolName: string, body: string): void {
72
92
  writeFileSync(join(toolsDir, `${toolName}.ts`), body);
73
93
  }
74
94
 
95
+ /** The standalone workspace hooks directory (`<workspace>/hooks/`). */
96
+ const WORKSPACE_HOOKS_DIR = join(ROOT, "hooks");
97
+
98
+ function ensureWorkspaceHooksDir(): void {
99
+ rmSync(WORKSPACE_HOOKS_DIR, { recursive: true, force: true });
100
+ mkdirSync(WORKSPACE_HOOKS_DIR, { recursive: true });
101
+ }
102
+
103
+ /** Write a standalone hook file directly under `<workspace>/hooks/`. */
104
+ function writeWorkspaceHook(hookName: string, body: string): void {
105
+ mkdirSync(WORKSPACE_HOOKS_DIR, { recursive: true });
106
+ writeFileSync(join(WORKSPACE_HOOKS_DIR, `${hookName}.ts`), body);
107
+ }
108
+
75
109
  /**
76
110
  * Bump a file's mtime forward by ~2 seconds so the mtime cache detects a
77
111
  * change. Using utimesSync avoids race conditions with filesystem mtime
@@ -97,6 +131,7 @@ beforeAll(() => {
97
131
 
98
132
  beforeEach(() => {
99
133
  ensurePluginsDir();
134
+ ensureWorkspaceHooksDir();
100
135
  resetPluginCacheForTests();
101
136
  });
102
137
 
@@ -338,7 +373,9 @@ describe("plugin mtime cache (per-surface)", () => {
338
373
  expect(hooks).toHaveLength(2);
339
374
 
340
375
  // beta was installed earlier (Jan 1) so it should come first.
341
- const results = hooks.map((fn) => (fn as unknown as () => { tag: string })());
376
+ const results = hooks.map((fn) =>
377
+ (fn as unknown as () => { tag: string })(),
378
+ );
342
379
  expect(results[0]!.tag).toBe("beta");
343
380
  expect(results[1]!.tag).toBe("alpha");
344
381
  });
@@ -368,8 +405,241 @@ describe("plugin mtime cache (per-surface)", () => {
368
405
  const hooks = await getUserHooksFor("user-prompt-submit");
369
406
  expect(hooks).toHaveLength(2);
370
407
 
371
- const results = hooks.map((fn) => (fn as unknown as () => { tag: string })());
408
+ const results = hooks.map((fn) =>
409
+ (fn as unknown as () => { tag: string })(),
410
+ );
372
411
  expect(results[0]!.tag).toBe("dated");
373
412
  expect(results[1]!.tag).toBe("undated");
374
413
  });
375
414
  });
415
+
416
+ describe("workspace hooks (<workspace>/hooks/)", () => {
417
+ test("getUserHooksFor loads a standalone workspace hook", async () => {
418
+ writeWorkspaceHook(
419
+ "user-prompt-submit",
420
+ `export default () => ({ ws: 1 });`,
421
+ );
422
+
423
+ await populateCacheAtBoot();
424
+
425
+ const hooks = await getUserHooksFor("user-prompt-submit");
426
+ expect(hooks).toHaveLength(1);
427
+ });
428
+
429
+ test("workspace hooks load even when no plugins directory exists", async () => {
430
+ rmSync(PLUGINS_DIR, { recursive: true, force: true });
431
+ writeWorkspaceHook("post-tool-use", `export default () => ({ ws: 1 });`);
432
+
433
+ await populateCacheAtBoot();
434
+
435
+ const hooks = await getUserHooksFor("post-tool-use");
436
+ expect(hooks).toHaveLength(1);
437
+ expect(getCachedUserTools()).toHaveLength(0);
438
+ });
439
+
440
+ // NB: each test below uses a distinct hook event name so the workspace
441
+ // hook file path is unique. Bun caches dynamic import() by URL and does not
442
+ // bust on content change, so reusing `<workspace>/hooks/<name>.ts` across
443
+ // tests would return a stale module (the existing plugin tests dodge this
444
+ // by using a fresh plugin directory per test).
445
+ test("plugin hooks run before the workspace hook for the same event", async () => {
446
+ const dir = freshPluginDir("ordering-plugin");
447
+ writePackageJson(dir, { ...SIMPLE_PKG, name: "ordering-plugin" });
448
+ writeHook(
449
+ dir,
450
+ "pre-model-call",
451
+ `export default () => ({ tag: "plugin" });`,
452
+ );
453
+ writeWorkspaceHook(
454
+ "pre-model-call",
455
+ `export default () => ({ tag: "workspace" });`,
456
+ );
457
+
458
+ await populateCacheAtBoot();
459
+
460
+ const hooks = await getUserHooksFor("pre-model-call");
461
+ expect(hooks).toHaveLength(2);
462
+ const results = hooks.map((fn) =>
463
+ (fn as unknown as () => { tag: string })(),
464
+ );
465
+ expect(results[0]!.tag).toBe("plugin");
466
+ expect(results[1]!.tag).toBe("workspace");
467
+ });
468
+
469
+ test("editing a workspace hook file triggers re-import", async () => {
470
+ const hookFile = join(WORKSPACE_HOOKS_DIR, "post-model-call.ts");
471
+ writeWorkspaceHook("post-model-call", `export default () => ({ v: 1 });`);
472
+
473
+ await populateCacheAtBoot();
474
+
475
+ const before = _inspectHookCacheForTests().find((c) =>
476
+ c.key.startsWith("__workspace__/"),
477
+ );
478
+ expect(before).toBeDefined();
479
+
480
+ touchFile(hookFile);
481
+ await getUserHooksFor("post-model-call");
482
+
483
+ const after = _inspectHookCacheForTests().find((c) =>
484
+ c.key.startsWith("__workspace__/"),
485
+ );
486
+ expect(after?.sourceMtime).not.toBe(before?.sourceMtime);
487
+ });
488
+
489
+ test("deleting a workspace hook file evicts it on next read", async () => {
490
+ const hookFile = join(WORKSPACE_HOOKS_DIR, "stop.ts");
491
+ writeWorkspaceHook("stop", `export default () => ({ v: 1 });`);
492
+
493
+ await populateCacheAtBoot();
494
+ expect(await getUserHooksFor("stop")).toHaveLength(1);
495
+
496
+ rmSync(hookFile, { force: true });
497
+
498
+ const hooks = await getUserHooksFor("stop");
499
+ expect(hooks).toHaveLength(0);
500
+ });
501
+
502
+ test("a newly added workspace hook is picked up without restart", async () => {
503
+ await populateCacheAtBoot();
504
+ expect(await getUserHooksFor("post-compact")).toHaveLength(0);
505
+
506
+ writeWorkspaceHook("post-compact", `export default () => ({ v: 1 });`);
507
+
508
+ expect(await getUserHooksFor("post-compact")).toHaveLength(1);
509
+ });
510
+
511
+ test("a workspace init hook runs once at boot", async () => {
512
+ // The init hook writes a sentinel file so we can observe it ran exactly
513
+ // once during populateCacheAtBoot.
514
+ const sentinel = join(ROOT, "ws-init-ran.txt");
515
+ rmSync(sentinel, { force: true });
516
+ writeWorkspaceHook(
517
+ "init",
518
+ `import { appendFileSync } from "node:fs";
519
+ export default () => { appendFileSync(${JSON.stringify(sentinel)}, "x"); };`,
520
+ );
521
+
522
+ await populateCacheAtBoot();
523
+
524
+ const { readFileSync: rf, existsSync: ex } = await import("node:fs");
525
+ expect(ex(sentinel)).toBe(true);
526
+ expect(rf(sentinel, "utf8")).toBe("x");
527
+ });
528
+ });
529
+
530
+ // ─── Runtime activation (hot-reload without a daemon restart) ──────────────────
531
+
532
+ /**
533
+ * Write a hook that appends `token` to `markerPath` each time it runs, so a
534
+ * test can count how many times `init`/`shutdown` fired.
535
+ */
536
+ function writeMarkerHook(
537
+ dir: string,
538
+ hookName: string,
539
+ markerPath: string,
540
+ token: string,
541
+ ): void {
542
+ writeHook(
543
+ dir,
544
+ hookName,
545
+ `import { appendFileSync } from "node:fs";\nexport default () => { appendFileSync(${JSON.stringify(markerPath)}, ${JSON.stringify(`${token}\n`)}); };`,
546
+ );
547
+ }
548
+
549
+ const TOOL_SRC = (name: string) =>
550
+ `export default { name: ${JSON.stringify(name)}, description: "test", parameters: { type: "object", properties: {} } };`;
551
+
552
+ /**
553
+ * Simulate the per-turn plugin hook dispatch that drives runtime reconciliation
554
+ * in production: any `getUserHooksFor` call runs `scanPlugins`, which activates
555
+ * newly present plugins and deactivates removed ones. The hook name is
556
+ * irrelevant — the scan runs regardless of whether a plugin defines that hook.
557
+ */
558
+ async function triggerScan(): Promise<void> {
559
+ await getUserHooksFor("user-prompt-submit");
560
+ }
561
+
562
+ describe("plugin runtime activation", () => {
563
+ test("a plugin installed after boot becomes live on the next scan", async () => {
564
+ await populateCacheAtBoot(); // empty plugins dir
565
+ expect(getAllToolDefinitions().some((t) => t.name === "late-tool")).toBe(
566
+ false,
567
+ );
568
+
569
+ const dir = freshPluginDir("late-plugin");
570
+ writePackageJson(dir, { ...SIMPLE_PKG, name: "late-plugin" });
571
+ writeTool(dir, "late-tool", TOOL_SRC("late-tool"));
572
+ const initMarker = join(ROOT, "late-init.log");
573
+ writeMarkerHook(dir, "init", initMarker, "init");
574
+
575
+ await triggerScan();
576
+
577
+ // Registered into the global registry as a plugin-owned tool, and exposed
578
+ // to the per-turn resolver via getPluginToolDefinitions().
579
+ expect(getToolOwner("late-tool")).toEqual({
580
+ kind: "plugin",
581
+ id: "late-plugin",
582
+ });
583
+ expect(getAllToolDefinitions().some((t) => t.name === "late-tool")).toBe(
584
+ true,
585
+ );
586
+ expect(getPluginToolDefinitions().some((t) => t.name === "late-tool")).toBe(
587
+ true,
588
+ );
589
+ // init ran exactly once.
590
+ expect(readFileSync(initMarker, "utf8").trim().split("\n")).toHaveLength(1);
591
+ });
592
+
593
+ test("activation is idempotent — repeated scans do not re-run init", async () => {
594
+ const dir = freshPluginDir("idem-plugin");
595
+ writePackageJson(dir, { ...SIMPLE_PKG, name: "idem-plugin" });
596
+ writeTool(dir, "idem-tool", TOOL_SRC("idem-tool"));
597
+ const initMarker = join(ROOT, "idem-init.log");
598
+ writeMarkerHook(dir, "init", initMarker, "init");
599
+
600
+ await populateCacheAtBoot();
601
+ await triggerScan();
602
+ await triggerScan();
603
+
604
+ expect(readFileSync(initMarker, "utf8").trim().split("\n")).toHaveLength(1);
605
+ // Registered exactly once (no refcount inflation from re-registration).
606
+ expect(getToolOwner("idem-tool")).toEqual({
607
+ kind: "plugin",
608
+ id: "idem-plugin",
609
+ });
610
+ });
611
+
612
+ test("removing a plugin directory deactivates it (unregister + shutdown)", async () => {
613
+ const dir = freshPluginDir("temp-plugin");
614
+ writePackageJson(dir, { ...SIMPLE_PKG, name: "temp-plugin" });
615
+ writeTool(dir, "temp-tool", TOOL_SRC("temp-tool"));
616
+ const shutdownMarker = join(ROOT, "temp-shutdown.log");
617
+ writeMarkerHook(dir, "shutdown", shutdownMarker, "bye");
618
+
619
+ await populateCacheAtBoot();
620
+ expect(getToolOwner("temp-tool")?.kind).toBe("plugin");
621
+
622
+ rmSync(dir, { recursive: true, force: true });
623
+ await triggerScan();
624
+
625
+ expect(getToolOwner("temp-tool")).toBeUndefined();
626
+ expect(getPluginToolDefinitions().some((t) => t.name === "temp-tool")).toBe(
627
+ false,
628
+ );
629
+ expect(existsSync(shutdownMarker)).toBe(true);
630
+ });
631
+
632
+ test("disabling a plugin at runtime tears down its tools", async () => {
633
+ const dir = freshPluginDir("disable-plugin");
634
+ writePackageJson(dir, { ...SIMPLE_PKG, name: "disable-plugin" });
635
+ writeTool(dir, "disable-tool", TOOL_SRC("disable-tool"));
636
+
637
+ await populateCacheAtBoot();
638
+ expect(getToolOwner("disable-tool")?.kind).toBe("plugin");
639
+
640
+ writeFileSync(join(dir, ".disabled"), "");
641
+ await triggerScan();
642
+
643
+ expect(getToolOwner("disable-tool")).toBeUndefined();
644
+ });
645
+ });
@@ -95,6 +95,8 @@ mock.module("../config/loader.js", () => ({
95
95
  }));
96
96
 
97
97
  mock.module("../memory/conversation-crud.js", () => ({
98
+ setConversationProcessingStartedAt: () => {},
99
+ isConversationProcessing: () => false,
98
100
  addMessage: () => ({ id: "mock-msg-id" }),
99
101
  getMessageById: () => null,
100
102
  updateMessageContent: () => {},
@@ -61,6 +61,36 @@ mock.module("../runtime/gateway-client.js", () => ({
61
61
  },
62
62
  }));
63
63
 
64
+ // Guardian identity for the access request resolves via the gateway delivery
65
+ // reader, not the local contacts DB. Seed it per-test via seedGatewayGuardian.
66
+ interface GatewayGuardian {
67
+ channelType: string;
68
+ contactId: string;
69
+ principalId?: string | null;
70
+ displayName?: string | null;
71
+ address: string;
72
+ externalChatId?: string | null;
73
+ status: string;
74
+ verifiedAt?: number | null;
75
+ }
76
+ let gatewayGuardians: GatewayGuardian[] = [];
77
+ mock.module("../contacts/guardian-delivery-reader.js", () => ({
78
+ getGuardianDelivery: async () => gatewayGuardians,
79
+ guardianForChannel: (list: GatewayGuardian[], channelType: string) =>
80
+ list.find((g) => g.channelType === channelType && g.status === "active"),
81
+ }));
82
+
83
+ function seedGatewayGuardian(g: Partial<GatewayGuardian> & {
84
+ channelType: string;
85
+ address: string;
86
+ }): void {
87
+ gatewayGuardians.push({
88
+ contactId: `c-${g.channelType}`,
89
+ status: "active",
90
+ ...g,
91
+ });
92
+ }
93
+
64
94
  import {
65
95
  listCanonicalGuardianDeliveries,
66
96
  listCanonicalGuardianRequests,
@@ -95,6 +125,7 @@ function resetState(): string {
95
125
  db.run("DELETE FROM contacts");
96
126
  emitSignalCalls.length = 0;
97
127
  deliverReplyCalls.length = 0;
128
+ gatewayGuardians = [];
98
129
  mockEmitResult = {
99
130
  signalId: "mock-signal-id",
100
131
  deduplicated: false,
@@ -102,8 +133,15 @@ function resetState(): string {
102
133
  reason: "mock",
103
134
  deliveryResults: [],
104
135
  };
105
- // Seed the vellum anchor binding (gateway does this at startup in production)
136
+ // Seed the vellum anchor binding in the gateway list (gateway does this at
137
+ // startup in production). The DB write mirrors it for any local INFO reads.
106
138
  const principalId = `vellum-principal-${crypto.randomUUID()}`;
139
+ seedGatewayGuardian({
140
+ channelType: "vellum",
141
+ address: principalId,
142
+ principalId,
143
+ displayName: principalId,
144
+ });
107
145
  createGuardianBinding({
108
146
  channel: "vellum",
109
147
  guardianExternalUserId: principalId,
@@ -172,6 +210,12 @@ describe("non-member access request notification", () => {
172
210
 
173
211
  test("guardian is notified when a non-member messages and a guardian binding exists", async () => {
174
212
  // Set up a guardian binding for this channel using the anchor principal
213
+ seedGatewayGuardian({
214
+ channelType: "telegram",
215
+ address: "guardian-user-789",
216
+ externalChatId: "guardian-chat-789",
217
+ principalId: anchorPrincipalId,
218
+ });
175
219
  createGuardianBinding({
176
220
  channel: "telegram",
177
221
  guardianExternalUserId: "guardian-user-789",
@@ -217,6 +261,12 @@ describe("non-member access request notification", () => {
217
261
  });
218
262
 
219
263
  test("no duplicate approval requests for repeated messages from same non-member", async () => {
264
+ seedGatewayGuardian({
265
+ channelType: "telegram",
266
+ address: "guardian-user-789",
267
+ externalChatId: "guardian-chat-789",
268
+ principalId: anchorPrincipalId,
269
+ });
220
270
  createGuardianBinding({
221
271
  channel: "telegram",
222
272
  guardianExternalUserId: "guardian-user-789",
@@ -289,6 +339,12 @@ describe("non-member access request notification", () => {
289
339
  // Only a voice guardian binding exists — no Telegram binding.
290
340
  // Since cross-channel fallback was removed, the access request resolves
291
341
  // to the assistant's vellum anchor identity instead.
342
+ seedGatewayGuardian({
343
+ channelType: "phone",
344
+ address: "guardian-voice-user",
345
+ externalChatId: "guardian-voice-chat",
346
+ principalId: anchorPrincipalId,
347
+ });
292
348
  createGuardianBinding({
293
349
  channel: "phone",
294
350
  guardianExternalUserId: "guardian-voice-user",
@@ -351,8 +407,8 @@ describe("access-request-helper unit tests", () => {
351
407
  anchorPrincipalId = resetState();
352
408
  });
353
409
 
354
- test("notifyGuardianOfAccessRequest returns no_sender_id when actorExternalId is absent", () => {
355
- const result = notifyGuardianOfAccessRequest({
410
+ test("notifyGuardianOfAccessRequest returns no_sender_id when actorExternalId is absent", async () => {
411
+ const result = await notifyGuardianOfAccessRequest({
356
412
  canonicalAssistantId: "self",
357
413
  sourceChannel: "telegram",
358
414
  conversationExternalId: "chat-123",
@@ -372,8 +428,8 @@ describe("access-request-helper unit tests", () => {
372
428
  expect(pending.length).toBe(0);
373
429
  });
374
430
 
375
- test("notifyGuardianOfAccessRequest creates request with self-healed principal when no binding exists", () => {
376
- const result = notifyGuardianOfAccessRequest({
431
+ test("notifyGuardianOfAccessRequest creates request with self-healed principal when no binding exists", async () => {
432
+ const result = await notifyGuardianOfAccessRequest({
377
433
  canonicalAssistantId: "self",
378
434
  sourceChannel: "telegram",
379
435
  conversationExternalId: "chat-123",
@@ -400,8 +456,14 @@ describe("access-request-helper unit tests", () => {
400
456
  expect(emitSignalCalls.length).toBe(1);
401
457
  });
402
458
 
403
- test("notifyGuardianOfAccessRequest falls back to assistant-anchored vellum identity when source-channel binding is missing", () => {
459
+ test("notifyGuardianOfAccessRequest falls back to assistant-anchored vellum identity when source-channel binding is missing", async () => {
404
460
  // Only voice binding exists
461
+ seedGatewayGuardian({
462
+ channelType: "phone",
463
+ address: "guardian-voice",
464
+ externalChatId: "voice-chat",
465
+ principalId: "test-principal-id",
466
+ });
405
467
  createGuardianBinding({
406
468
  channel: "phone",
407
469
  guardianExternalUserId: "guardian-voice",
@@ -410,7 +472,7 @@ describe("access-request-helper unit tests", () => {
410
472
  verifiedVia: "test",
411
473
  });
412
474
 
413
- const result = notifyGuardianOfAccessRequest({
475
+ const result = await notifyGuardianOfAccessRequest({
414
476
  canonicalAssistantId: "self",
415
477
  sourceChannel: "telegram",
416
478
  conversationExternalId: "tg-chat",
@@ -435,8 +497,20 @@ describe("access-request-helper unit tests", () => {
435
497
  expect(payload.guardianBindingChannel).toBe("vellum");
436
498
  });
437
499
 
438
- test("notifyGuardianOfAccessRequest prefers source-channel binding over vellum anchor", () => {
500
+ test("notifyGuardianOfAccessRequest prefers source-channel binding over vellum anchor", async () => {
439
501
  // Both Telegram and voice bindings exist with the anchor principal
502
+ seedGatewayGuardian({
503
+ channelType: "telegram",
504
+ address: "guardian-tg",
505
+ externalChatId: "tg-chat",
506
+ principalId: anchorPrincipalId,
507
+ });
508
+ seedGatewayGuardian({
509
+ channelType: "phone",
510
+ address: "guardian-voice",
511
+ externalChatId: "voice-chat",
512
+ principalId: anchorPrincipalId,
513
+ });
440
514
  createGuardianBinding({
441
515
  channel: "telegram",
442
516
  guardianExternalUserId: "guardian-tg",
@@ -452,7 +526,7 @@ describe("access-request-helper unit tests", () => {
452
526
  verifiedVia: "test",
453
527
  });
454
528
 
455
- const result = notifyGuardianOfAccessRequest({
529
+ const result = await notifyGuardianOfAccessRequest({
456
530
  canonicalAssistantId: "self",
457
531
  sourceChannel: "telegram",
458
532
  conversationExternalId: "chat-123",
@@ -477,8 +551,102 @@ describe("access-request-helper unit tests", () => {
477
551
  expect(payload.guardianBindingChannel).toBe("telegram");
478
552
  });
479
553
 
480
- test("notifyGuardianOfAccessRequest for voice channel includes actorDisplayName in contextPayload", () => {
481
- const result = notifyGuardianOfAccessRequest({
554
+ test("notifyGuardianOfAccessRequest resolves the source-channel guardian from the gateway delivery", async () => {
555
+ // Gateway delivery serves a telegram guardian matching the vellum anchor.
556
+ seedGatewayGuardian({
557
+ channelType: "telegram",
558
+ address: "guardian-tg",
559
+ externalChatId: "tg-chat",
560
+ principalId: anchorPrincipalId,
561
+ });
562
+ createGuardianBinding({
563
+ channel: "telegram",
564
+ guardianExternalUserId: "guardian-tg",
565
+ guardianDeliveryChatId: "tg-chat",
566
+ guardianPrincipalId: anchorPrincipalId,
567
+ verifiedVia: "test",
568
+ });
569
+
570
+ const result = await notifyGuardianOfAccessRequest({
571
+ canonicalAssistantId: "self",
572
+ sourceChannel: "telegram",
573
+ conversationExternalId: "chat-123",
574
+ actorExternalId: "unknown-user",
575
+ });
576
+
577
+ expect(result.notified).toBe(true);
578
+
579
+ const pending = listCanonicalGuardianRequests({
580
+ status: "pending",
581
+ requesterExternalUserId: "unknown-user",
582
+ kind: "access_request",
583
+ });
584
+ expect(pending.length).toBe(1);
585
+ // Request is decidable: gateway delivery supplied the principal + source binding.
586
+ expect(pending[0].guardianPrincipalId).toBe(anchorPrincipalId);
587
+ expect(pending[0].guardianExternalUserId).toBe("guardian-tg");
588
+
589
+ const payload = emitSignalCalls[0].contextPayload as Record<
590
+ string,
591
+ unknown
592
+ >;
593
+ expect(payload.guardianBindingChannel).toBe("telegram");
594
+ });
595
+
596
+ test("notifyGuardianOfAccessRequest resolves the vellum anchor from the gateway delivery", async () => {
597
+ // Only the vellum anchor (seeded in resetState) is served by the gateway.
598
+ const result = await notifyGuardianOfAccessRequest({
599
+ canonicalAssistantId: "self",
600
+ sourceChannel: "telegram",
601
+ conversationExternalId: "chat-123",
602
+ actorExternalId: "unknown-user",
603
+ });
604
+
605
+ expect(result.notified).toBe(true);
606
+
607
+ const pending = listCanonicalGuardianRequests({
608
+ status: "pending",
609
+ requesterExternalUserId: "unknown-user",
610
+ kind: "access_request",
611
+ });
612
+ expect(pending.length).toBe(1);
613
+ // Decidable via the gateway-served vellum anchor principal.
614
+ expect(pending[0].guardianPrincipalId).toBe(anchorPrincipalId);
615
+
616
+ const payload = emitSignalCalls[0].contextPayload as Record<
617
+ string,
618
+ unknown
619
+ >;
620
+ expect(payload.guardianBindingChannel).toBe("vellum");
621
+ });
622
+
623
+ test("notifyGuardianOfAccessRequest does not create a decisionable request when the gateway delivery is empty", async () => {
624
+ // Genuinely unbound assistant: gateway serves no guardian. The guard
625
+ // rejects creation of a decisionable request without a principal.
626
+ gatewayGuardians = [];
627
+ const db = getDb();
628
+ db.run("DELETE FROM contact_channels");
629
+ db.run("DELETE FROM contacts");
630
+
631
+ await expect(
632
+ notifyGuardianOfAccessRequest({
633
+ canonicalAssistantId: "self",
634
+ sourceChannel: "telegram",
635
+ conversationExternalId: "chat-123",
636
+ actorExternalId: "unknown-user",
637
+ }),
638
+ ).rejects.toThrow();
639
+
640
+ const pending = listCanonicalGuardianRequests({
641
+ status: "pending",
642
+ requesterExternalUserId: "unknown-user",
643
+ kind: "access_request",
644
+ });
645
+ expect(pending.length).toBe(0);
646
+ });
647
+
648
+ test("notifyGuardianOfAccessRequest for voice channel includes actorDisplayName in contextPayload", async () => {
649
+ const result = await notifyGuardianOfAccessRequest({
482
650
  canonicalAssistantId: "self",
483
651
  sourceChannel: "phone",
484
652
  conversationExternalId: "+15559998888",
@@ -508,8 +676,8 @@ describe("access-request-helper unit tests", () => {
508
676
  expect(pending.length).toBe(1);
509
677
  });
510
678
 
511
- test("notifyGuardianOfAccessRequest includes requestCode in contextPayload", () => {
512
- const result = notifyGuardianOfAccessRequest({
679
+ test("notifyGuardianOfAccessRequest includes requestCode in contextPayload", async () => {
680
+ const result = await notifyGuardianOfAccessRequest({
513
681
  canonicalAssistantId: "self",
514
682
  sourceChannel: "telegram",
515
683
  conversationExternalId: "chat-123",
@@ -529,8 +697,8 @@ describe("access-request-helper unit tests", () => {
529
697
  expect((payload.requestCode as string).length).toBe(6);
530
698
  });
531
699
 
532
- test("notifyGuardianOfAccessRequest includes previousMemberStatus in contextPayload", () => {
533
- const result = notifyGuardianOfAccessRequest({
700
+ test("notifyGuardianOfAccessRequest includes previousMemberStatus in contextPayload", async () => {
701
+ const result = await notifyGuardianOfAccessRequest({
534
702
  canonicalAssistantId: "self",
535
703
  sourceChannel: "telegram",
536
704
  conversationExternalId: "chat-123",
@@ -570,7 +738,7 @@ describe("access-request-helper unit tests", () => {
570
738
  ],
571
739
  };
572
740
 
573
- const result = notifyGuardianOfAccessRequest({
741
+ const result = await notifyGuardianOfAccessRequest({
574
742
  canonicalAssistantId: "self",
575
743
  sourceChannel: "phone",
576
744
  conversationExternalId: "+15556667777",
@@ -603,6 +771,12 @@ describe("access-request-helper unit tests", () => {
603
771
  // Set up a telegram guardian binding with the anchor principal so
604
772
  // guardianResolutionSource resolves to "source-channel-contact" and
605
773
  // sameChannelOnly is true.
774
+ seedGatewayGuardian({
775
+ channelType: "telegram",
776
+ address: "guardian-user-456",
777
+ externalChatId: "guardian-chat-456",
778
+ principalId: anchorPrincipalId,
779
+ });
606
780
  createGuardianBinding({
607
781
  channel: "telegram",
608
782
  guardianExternalUserId: "guardian-user-456",
@@ -625,7 +799,7 @@ describe("access-request-helper unit tests", () => {
625
799
  ],
626
800
  };
627
801
 
628
- const result = notifyGuardianOfAccessRequest({
802
+ const result = await notifyGuardianOfAccessRequest({
629
803
  canonicalAssistantId: "self",
630
804
  sourceChannel: "telegram",
631
805
  conversationExternalId: "chat-123",
@@ -24,6 +24,10 @@ mock.module("../util/logger.js", () => ({
24
24
  }),
25
25
  }));
26
26
 
27
+ mock.module("../contacts/guardian-delivery-reader.js", () => ({
28
+ getGuardianDelivery: async () => null,
29
+ }));
30
+
27
31
  // Mock destination-resolver to return a destination for every requested channel.
28
32
  // External channels (telegram, slack) include bindingContext.
29
33
  mock.module("../notifications/destination-resolver.js", () => ({