@vellumai/assistant 0.10.12 → 0.11.0-staging.1

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 (776) hide show
  1. package/AGENTS.md +1 -1
  2. package/ARCHITECTURE.md +4 -5
  3. package/README.md +1 -1
  4. package/docs/architecture/memory.md +60 -23
  5. package/docs/error-handling.md +3 -3
  6. package/docs/guardian-request-flow.md +112 -0
  7. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/package.json +1 -0
  8. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/channels.test.ts +9 -1
  9. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/secret-detection.test.ts +449 -0
  10. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/channels.ts +1 -0
  11. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/secret-detection.ts +468 -0
  12. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/app.d.ts +28 -0
  13. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/app.d.ts.map +1 -1
  14. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/index.d.ts +2 -2
  15. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/index.d.ts.map +1 -1
  16. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/index.js.map +1 -1
  17. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/message.d.ts +2 -0
  18. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/message.d.ts.map +1 -1
  19. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/package.json +1 -1
  20. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/package.json +1 -0
  21. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/channels.test.ts +9 -1
  22. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/secret-detection.test.ts +449 -0
  23. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/channels.ts +1 -0
  24. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/secret-detection.ts +468 -0
  25. package/node_modules/@vellumai/gateway-client/package.json +1 -1
  26. package/node_modules/@vellumai/gateway-client/src/admission-policy-contract.ts +6 -0
  27. package/node_modules/@vellumai/gateway-client/src/inbound-contract.ts +34 -0
  28. package/node_modules/@vellumai/service-contracts/package.json +1 -0
  29. package/node_modules/@vellumai/service-contracts/src/__tests__/channels.test.ts +9 -1
  30. package/node_modules/@vellumai/service-contracts/src/__tests__/secret-detection.test.ts +449 -0
  31. package/node_modules/@vellumai/service-contracts/src/channels.ts +1 -0
  32. package/node_modules/@vellumai/service-contracts/src/secret-detection.ts +468 -0
  33. package/openapi.yaml +246 -10
  34. package/package.json +2 -2
  35. package/src/__tests__/acp-session.test.ts +3 -3
  36. package/src/__tests__/agent-loop-mutable-latest-user-message.test.ts +3 -0
  37. package/src/__tests__/anthropic-provider.test.ts +40 -0
  38. package/src/__tests__/approval-cascade.test.ts +5 -5
  39. package/src/__tests__/approval-routes-http.test.ts +3 -3
  40. package/src/__tests__/ask-question-resolver.test.ts +207 -0
  41. package/src/__tests__/assistant-event-hub-self-exclusion.test.ts +16 -16
  42. package/src/__tests__/assistant-event-hub-targeted.test.ts +13 -11
  43. package/src/__tests__/assistant-event-hub.test.ts +13 -11
  44. package/src/__tests__/assistant-event.test.ts +12 -9
  45. package/src/__tests__/assistant-feature-flag-guard.test.ts +3 -3
  46. package/src/__tests__/assistant-feature-flag-guardrails.test.ts +1 -1
  47. package/src/__tests__/assistant-id-boundary-guard.test.ts +0 -58
  48. package/src/__tests__/assistant-stream-state.test.ts +17 -7
  49. package/src/__tests__/avatar-identity-sync.test.ts +3 -3
  50. package/src/__tests__/background-workers-disk-pressure.test.ts +1 -0
  51. package/src/__tests__/call-conversation-messages.test.ts +134 -18
  52. package/src/__tests__/call-start-guardian-guard.test.ts +27 -0
  53. package/src/__tests__/channel-approvals.test.ts +0 -27
  54. package/src/__tests__/channel-guardian.test.ts +85 -512
  55. package/src/__tests__/channel-readiness-slack-remote.test.ts +151 -3
  56. package/src/__tests__/channel-retry-sweep.test.ts +88 -1
  57. package/src/__tests__/channel-setup-panel-ack.test.ts +12 -9
  58. package/src/__tests__/chat-reveal-guard-priming.test.ts +31 -34
  59. package/src/__tests__/cli-memory-v2-reembed-skills.test.ts +2 -2
  60. package/src/__tests__/compaction-events.test.ts +8 -8
  61. package/src/__tests__/config-loader-platform-defaults.test.ts +54 -28
  62. package/src/__tests__/config-model-image-provider.test.ts +20 -0
  63. package/src/__tests__/config-schema-memory-substrate.test.ts +306 -0
  64. package/src/__tests__/config-schema.test.ts +14 -2
  65. package/src/__tests__/config-set-platform-guard.test.ts +11 -12
  66. package/src/__tests__/config-sounds-sync.test.ts +4 -4
  67. package/src/__tests__/confirmation-request-guardian-bridge.test.ts +5 -0
  68. package/src/__tests__/context-search-memory-source.test.ts +1 -1
  69. package/src/__tests__/context-search-memory-v2-source.test.ts +6 -6
  70. package/src/__tests__/context-token-estimator.test.ts +54 -1
  71. package/src/__tests__/conversation-agent-loop-disk-pressure.test.ts +12 -3
  72. package/src/__tests__/conversation-agent-loop-fatal-cleanup.test.ts +13 -4
  73. package/src/__tests__/conversation-agent-loop-handlers-max-tokens.test.ts +4 -4
  74. package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +10 -1
  75. package/src/__tests__/conversation-agent-loop-overflow.test.ts +22 -13
  76. package/src/__tests__/conversation-agent-loop.test.ts +39 -30
  77. package/src/__tests__/conversation-confirmation-signals.test.ts +14 -14
  78. package/src/__tests__/conversation-evictor.test.ts +49 -0
  79. package/src/__tests__/conversation-fork-crud.test.ts +1 -1
  80. package/src/__tests__/conversation-history-web-search.test.ts +1 -1
  81. package/src/__tests__/conversation-key-store-disk-view.test.ts +5 -5
  82. package/src/__tests__/conversation-loop-db-lock-resilience.test.ts +5 -5
  83. package/src/__tests__/conversation-message-sync-tags.test.ts +4 -4
  84. package/src/__tests__/conversation-queue.test.ts +81 -81
  85. package/src/__tests__/conversation-routes-enabled-plugins.test.ts +8 -1
  86. package/src/__tests__/conversation-routes-hidden-queue.test.ts +8 -1
  87. package/src/__tests__/conversation-routes-slash-commands.test.ts +10 -1
  88. package/src/__tests__/conversation-runtime-assembly.test.ts +29 -2
  89. package/src/__tests__/conversation-slash-queue.test.ts +11 -11
  90. package/src/__tests__/conversation-slash-unknown.test.ts +2 -2
  91. package/src/__tests__/conversation-speed-override.test.ts +2 -2
  92. package/src/__tests__/conversation-summarize-route.test.ts +9 -0
  93. package/src/__tests__/conversation-surfaces-action-delivery.test.ts +18 -16
  94. package/src/__tests__/conversation-surfaces-activation-emit.test.ts +17 -17
  95. package/src/__tests__/conversation-surfaces-app-open.test.ts +7 -4
  96. package/src/__tests__/conversation-surfaces-data-persist.test.ts +7 -7
  97. package/src/__tests__/conversation-surfaces-standalone-payloads.test.ts +9 -9
  98. package/src/__tests__/conversation-surfaces-standalone.test.ts +12 -12
  99. package/src/__tests__/conversation-surfaces-state-update.test.ts +8 -5
  100. package/src/__tests__/conversation-surfaces-table-action.test.ts +6 -3
  101. package/src/__tests__/conversation-surfaces-task-progress.test.ts +46 -46
  102. package/src/__tests__/conversation-sync-tags.test.ts +5 -5
  103. package/src/__tests__/conversation-wait-for-idle.test.ts +2 -2
  104. package/src/__tests__/conversation-workspace-cache-state.test.ts +0 -4
  105. package/src/__tests__/conversation-workspace-injection.test.ts +0 -3
  106. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +0 -3
  107. package/src/__tests__/copy-composer-tc-templates.test.ts +3 -131
  108. package/src/__tests__/credential-security-invariants.test.ts +1 -0
  109. package/src/__tests__/daemon-assistant-events.test.ts +14 -15
  110. package/src/__tests__/db-test-helpers.ts +13 -27
  111. package/src/__tests__/disk-pressure-routes.test.ts +12 -3
  112. package/src/__tests__/document-tool-security.test.ts +95 -0
  113. package/src/__tests__/drain-kick-guard.test.ts +232 -0
  114. package/src/__tests__/dynamic-skill-background-guard.test.ts +19 -6
  115. package/src/__tests__/emit-event-signal.test.ts +5 -6
  116. package/src/__tests__/encrypted-store-test-helpers.ts +10 -20
  117. package/src/__tests__/events-tail-route.test.ts +6 -4
  118. package/src/__tests__/feature-flag-test-helpers.ts +10 -20
  119. package/src/__tests__/file-edit-tool.test.ts +24 -4
  120. package/src/__tests__/file-list-tool.test.ts +2 -1
  121. package/src/__tests__/file-read-tool.test.ts +62 -10
  122. package/src/__tests__/file-write-tool.test.ts +24 -5
  123. package/src/__tests__/followup-tools.test.ts +58 -0
  124. package/src/__tests__/gateway-threshold-reader-mock.ts +99 -0
  125. package/src/__tests__/graph-extraction-event-date.test.ts +1 -1
  126. package/src/__tests__/guardian-question-mode.test.ts +42 -3
  127. package/src/__tests__/guardian-reply-router-answer-mode.test.ts +283 -0
  128. package/src/__tests__/guardian-vellum-destination-pinning.test.ts +221 -0
  129. package/src/__tests__/heartbeat-disk-pressure.test.ts +1 -0
  130. package/src/__tests__/heartbeat-service.test.ts +1 -0
  131. package/src/__tests__/helpers/native-web-search-harness.ts +10 -10
  132. package/src/__tests__/host-browser-proxy.test.ts +1 -1
  133. package/src/__tests__/host-file-edit-tool.test.ts +3 -3
  134. package/src/__tests__/host-file-read-tool.test.ts +2 -2
  135. package/src/__tests__/host-file-write-tool.test.ts +7 -3
  136. package/src/__tests__/host-shell-tool.test.ts +17 -5
  137. package/src/__tests__/host-transfer-pending-interactions.test.ts +8 -8
  138. package/src/__tests__/image-credentials.test.ts +65 -8
  139. package/src/__tests__/injection-block.test.ts +4 -4
  140. package/src/__tests__/injector-chain.test.ts +1 -1
  141. package/src/__tests__/injector-pkb-v2-silenced.test.ts +2 -2
  142. package/src/__tests__/injector-registry-order-guard.test.ts +4 -9
  143. package/src/__tests__/injector-v3-suppression.test.ts +6 -4
  144. package/src/__tests__/lifecycle-memory-v2-seed.test.ts +27 -28
  145. package/src/__tests__/list-messages-page-latest.test.ts +2 -2
  146. package/src/__tests__/llm-usage-store.test.ts +67 -4
  147. package/src/__tests__/log-redact.test.ts +18 -0
  148. package/src/__tests__/managed-profile-guard.test.ts +27 -0
  149. package/src/__tests__/managed-skill-lifecycle.test.ts +2 -2
  150. package/src/__tests__/media-generate-image.test.ts +62 -11
  151. package/src/__tests__/memory-identity-context-parity.test.ts +1 -1
  152. package/src/__tests__/memory-jobs-worker-lanes.test.ts +9 -1
  153. package/src/__tests__/memory-retrieval-hook.test.ts +4 -4
  154. package/src/__tests__/notification-decision-strategy.test.ts +115 -11
  155. package/src/__tests__/notification-deep-link.test.ts +12 -12
  156. package/src/__tests__/notification-vellum-adapter.test.ts +8 -8
  157. package/src/__tests__/outbound-slack-persistence.test.ts +8 -8
  158. package/src/__tests__/path-policy.test.ts +315 -0
  159. package/src/__tests__/pending-interactions-resolved-event.test.ts +6 -6
  160. package/src/__tests__/persistence-layering-guard.test.ts +2 -2
  161. package/src/__tests__/pkb-autoinject.test.ts +1 -1
  162. package/src/__tests__/platform-bash-auto-approve.test.ts +1 -0
  163. package/src/__tests__/plugin-event-hub-facade.test.ts +22 -15
  164. package/src/__tests__/plugin-import-boundary-guard.test.ts +15 -15
  165. package/src/__tests__/processing-flag-persist-failure.test.ts +0 -4
  166. package/src/__tests__/provider-platform-proxy-integration.test.ts +0 -1
  167. package/src/__tests__/rebuild-index-graph-nodes.test.ts +1 -1
  168. package/src/__tests__/request-secret-standalone-channel-gate.test.ts +5 -5
  169. package/src/__tests__/require-fresh-approval.test.ts +38 -38
  170. package/src/__tests__/run-due-schedules.test.ts +72 -1
  171. package/src/__tests__/runtime-events-sse-parity.test.ts +11 -10
  172. package/src/__tests__/runtime-events-sse.test.ts +1 -1
  173. package/src/__tests__/schedule-routes.test.ts +44 -5
  174. package/src/__tests__/schedule-store.test.ts +3 -3
  175. package/src/__tests__/schedule-tools.test.ts +176 -0
  176. package/src/__tests__/secret-prompt-log-hygiene.test.ts +3 -3
  177. package/src/__tests__/secret-prompter-channel-fallback.test.ts +3 -3
  178. package/src/__tests__/secret-response-routing.test.ts +3 -3
  179. package/src/__tests__/secret-routes-platform-proxy.test.ts +4 -7
  180. package/src/__tests__/secret-scanner.test.ts +36 -0
  181. package/src/__tests__/send-endpoint-busy.test.ts +7 -7
  182. package/src/__tests__/slack-required-scopes-mirror.test.ts +81 -0
  183. package/src/__tests__/starter-task-flow.test.ts +6 -3
  184. package/src/__tests__/subagent-call-site-routing.test.ts +2 -2
  185. package/src/__tests__/subagent-disposal.test.ts +40 -11
  186. package/src/__tests__/subagent-fork-notifications.test.ts +4 -4
  187. package/src/__tests__/subagent-fork-prompt-role.test.ts +3 -3
  188. package/src/__tests__/subagent-fork-spawn.test.ts +4 -4
  189. package/src/__tests__/subagent-manager-notify.test.ts +73 -14
  190. package/src/__tests__/subagent-notify-parent.test.ts +48 -4
  191. package/src/__tests__/subagent-spawn-and-await.test.ts +62 -14
  192. package/src/__tests__/subagent-tools.test.ts +64 -0
  193. package/src/__tests__/sync-message-contract.test.ts +3 -3
  194. package/src/__tests__/terminal-tools.test.ts +12 -3
  195. package/src/__tests__/test-preload.ts +9 -0
  196. package/src/__tests__/tool-approval-handler.test.ts +583 -43
  197. package/src/__tests__/tool-execution-pipeline.benchmark.test.ts +7 -4
  198. package/src/__tests__/tool-executor.test.ts +116 -0
  199. package/src/__tests__/tool-grant-request-escalation.test.ts +5 -0
  200. package/src/__tests__/tool-preview-lifecycle.test.ts +32 -29
  201. package/src/__tests__/tool-result-metadata-plumbing.test.ts +5 -5
  202. package/src/__tests__/tool-start-timestamp.test.ts +4 -4
  203. package/src/__tests__/trusted-contact-lifecycle-notifications.test.ts +9 -22
  204. package/src/__tests__/ui-choice-copy-surfaces.test.ts +13 -13
  205. package/src/__tests__/ui-work-result-surface.test.ts +3 -3
  206. package/src/__tests__/voice-scoped-grant-consumer.test.ts +6 -6
  207. package/src/__tests__/voice-session-bridge.test.ts +44 -44
  208. package/src/__tests__/workspace-migration-134-image-generation-mode-to-provider.test.ts +284 -0
  209. package/src/__tests__/workspace-policy.test.ts +399 -0
  210. package/src/acp/__tests__/client-handler.test.ts +3 -3
  211. package/src/acp/__tests__/session-manager-persistence.test.ts +10 -10
  212. package/src/acp/__tests__/session-manager-resume.test.ts +7 -7
  213. package/src/acp/client-handler.ts +3 -3
  214. package/src/acp/session-manager.ts +8 -8
  215. package/src/api/events/subagent-event.ts +2 -2
  216. package/src/api/responses/memory-v2-activation-log.ts +2 -2
  217. package/src/approvals/AGENTS.md +2 -0
  218. package/src/approvals/guardian-request-resolvers.ts +118 -24
  219. package/src/calls/__tests__/voice-control-protocol.test.ts +57 -0
  220. package/src/calls/__tests__/voice-session-bridge.test.ts +158 -4
  221. package/src/calls/__tests__/voice-triage-escalate.test.ts +3 -4
  222. package/src/calls/call-controller.ts +27 -27
  223. package/src/calls/call-conversation-messages.ts +58 -18
  224. package/src/calls/voice-control-protocol.ts +56 -0
  225. package/src/calls/voice-session-bridge.ts +156 -58
  226. package/src/calls/voice-triage-escalate.ts +2 -3
  227. package/src/channels/config.ts +8 -0
  228. package/src/channels/types.ts +1 -0
  229. package/src/cli/commands/config.ts +49 -13
  230. package/src/cli/commands/memory/index.help.ts +4 -2
  231. package/src/cli/commands/memory/memory-retrospective.ts +5 -0
  232. package/src/cli/lib/bundled-marketplace.json +12 -0
  233. package/src/cli.ts +2 -109
  234. package/src/config/__tests__/deployment-context-defaults.test.ts +9 -0
  235. package/src/config/__tests__/substrate-twin-shadowing.test.ts +191 -0
  236. package/src/config/assistant-feature-flags.ts +1 -1
  237. package/src/config/bundled-skills/image-studio/tools/media-generate-image.ts +13 -7
  238. package/src/config/feature-flag-cache.ts +6 -16
  239. package/src/config/feature-flag-registry.json +14 -30
  240. package/src/config/loader.ts +7 -1
  241. package/src/config/memory-tier.ts +15 -10
  242. package/src/config/memory-v3-gate.test.ts +278 -1
  243. package/src/config/memory-v3-gate.ts +88 -26
  244. package/src/config/raw-config-utils.ts +1 -1
  245. package/src/config/schemas/__tests__/live-voice.test.ts +27 -16
  246. package/src/config/schemas/__tests__/memory-v3.test.ts +1 -0
  247. package/src/config/schemas/live-voice.ts +33 -7
  248. package/src/config/schemas/llm.ts +1 -0
  249. package/src/config/schemas/memory-retrospective.ts +13 -0
  250. package/src/config/schemas/memory-substrate.ts +183 -0
  251. package/src/config/schemas/memory-v2.ts +3 -2
  252. package/src/config/schemas/memory-v3.ts +11 -4
  253. package/src/config/schemas/memory.ts +35 -1
  254. package/src/config/schemas/services.ts +10 -2
  255. package/src/config/substrate-twin-shadowing.ts +195 -0
  256. package/src/config/webhook-routing.ts +67 -0
  257. package/src/context/compactor.ts +10 -3
  258. package/src/context/token-estimator.ts +21 -0
  259. package/src/daemon/__tests__/channel-ui-capability.test.ts +85 -0
  260. package/src/daemon/__tests__/conversation-surfaces-launch.test.ts +3 -3
  261. package/src/daemon/__tests__/embedding-reconcile.test.ts +3 -3
  262. package/src/daemon/__tests__/inference-profile-notification.test.ts +3 -6
  263. package/src/daemon/__tests__/native-web-search-metadata.test.ts +5 -5
  264. package/src/daemon/__tests__/web-search-status-text.test.ts +2 -2
  265. package/src/daemon/channel-ui-capability.ts +70 -1
  266. package/src/daemon/conversation-agent-loop-handlers.ts +4 -4
  267. package/src/daemon/conversation-agent-loop.ts +12 -5
  268. package/src/daemon/conversation-evictor.ts +26 -4
  269. package/src/daemon/conversation-launch.ts +11 -14
  270. package/src/daemon/conversation-messaging.ts +14 -14
  271. package/src/daemon/conversation-notifiers.ts +2 -2
  272. package/src/daemon/conversation-process.ts +133 -21
  273. package/src/daemon/conversation-queue-manager.ts +7 -7
  274. package/src/daemon/conversation-runtime-assembly.ts +16 -0
  275. package/src/daemon/conversation-store.ts +11 -3
  276. package/src/daemon/conversation-surfaces.ts +4 -4
  277. package/src/daemon/conversation-tool-setup.ts +13 -7
  278. package/src/daemon/conversation-usage.ts +12 -11
  279. package/src/daemon/conversation.ts +38 -15
  280. package/src/daemon/disk-pressure-guard.ts +5 -12
  281. package/src/daemon/embedding-reconcile.ts +14 -9
  282. package/src/daemon/handlers/config-channels.ts +40 -134
  283. package/src/daemon/handlers/config-model.ts +15 -7
  284. package/src/daemon/handlers/conversations.ts +4 -2
  285. package/src/daemon/handlers/shared.ts +29 -0
  286. package/src/daemon/host-proxy-base.ts +4 -4
  287. package/src/daemon/lifecycle.ts +13 -0
  288. package/src/daemon/message-protocol.ts +8 -144
  289. package/src/daemon/message-types/computer-use.ts +0 -12
  290. package/src/daemon/message-types/conversations.ts +9 -345
  291. package/src/daemon/message-types/host-app-control.ts +0 -9
  292. package/src/daemon/message-types/host-browser.ts +0 -7
  293. package/src/daemon/message-types/host-ui-snapshot.ts +0 -7
  294. package/src/daemon/message-types/messages.ts +0 -48
  295. package/src/daemon/message-types/notifications.ts +0 -7
  296. package/src/daemon/message-types/skills.ts +0 -5
  297. package/src/daemon/message-types/surfaces.ts +0 -9
  298. package/src/daemon/message-types/sync.ts +0 -2
  299. package/src/daemon/process-message.ts +5 -5
  300. package/src/daemon/skill-memory-refresh.ts +5 -5
  301. package/src/daemon/tool-side-effects.ts +13 -13
  302. package/src/daemon/trust-context.ts +1 -1
  303. package/src/daemon/wake-conversation-ops.ts +4 -4
  304. package/src/heartbeat/__tests__/heartbeat-run-store.test.ts +100 -7
  305. package/src/heartbeat/__tests__/heartbeat-service.test.ts +67 -0
  306. package/src/heartbeat/heartbeat-run-store.ts +81 -4
  307. package/src/heartbeat/heartbeat-service.ts +32 -1
  308. package/src/home/__tests__/feed-writer.test.ts +7 -7
  309. package/src/home/__tests__/home-content-refresh.test.ts +3 -0
  310. package/src/home/__tests__/suggested-prompts.test.ts +1 -0
  311. package/src/home/feed-writer.ts +6 -13
  312. package/src/home/home-content-refresh.ts +6 -9
  313. package/src/home/relationship-state-writer.ts +5 -12
  314. package/src/home/suggested-prompts-cache.ts +6 -19
  315. package/src/ipc/__tests__/events-publish-client.test.ts +67 -0
  316. package/src/ipc/events-publish-client.ts +44 -0
  317. package/src/ipc/routes/__tests__/conversation-sync-ipc-routes.test.ts +2 -2
  318. package/src/ipc/routes/__tests__/events-ipc-routes.test.ts +38 -9
  319. package/src/ipc/routes/events-ipc-routes.ts +11 -31
  320. package/src/live-voice/__tests__/front-decision.test.ts +4 -176
  321. package/src/live-voice/__tests__/live-voice-agent-turn.test.ts +276 -68
  322. package/src/live-voice/__tests__/live-voice-events.test.ts +6 -3
  323. package/src/live-voice/__tests__/live-voice-progress.test.ts +185 -46
  324. package/src/live-voice/__tests__/live-voice-triage-escalate.test.ts +24 -59
  325. package/src/live-voice/__tests__/live-voice-tts-session.test.ts +38 -54
  326. package/src/live-voice/__tests__/live-voice-vad.test.ts +218 -422
  327. package/src/live-voice/front-decision.ts +5 -155
  328. package/src/live-voice/live-voice-metrics.ts +4 -1
  329. package/src/live-voice/live-voice-session.ts +650 -333
  330. package/src/live-voice/progress-phrases.ts +17 -0
  331. package/src/live-voice/protocol.ts +15 -0
  332. package/src/media/app-icon-generator.ts +15 -8
  333. package/src/media/avatar-router.ts +9 -5
  334. package/src/media/image-credentials.ts +42 -10
  335. package/src/media/image-service.ts +1 -13
  336. package/src/media/types.ts +26 -3
  337. package/src/notifications/AGENTS.md +2 -0
  338. package/src/notifications/__tests__/broadcaster.test.ts +95 -0
  339. package/src/notifications/adapters/macos.ts +3 -3
  340. package/src/notifications/broadcaster.ts +57 -0
  341. package/src/notifications/copy-composer.ts +0 -15
  342. package/src/notifications/decision-engine.ts +21 -22
  343. package/src/notifications/guardian-question-mode.ts +57 -2
  344. package/src/notifications/home-feed-side-effect.ts +4 -0
  345. package/src/notifications/signal.ts +6 -4
  346. package/src/notifications/trusted-contact-payloads.ts +3 -4
  347. package/src/notifications/vellum-card-affinity.ts +39 -0
  348. package/src/oauth/AGENTS.md +1 -1
  349. package/src/permissions/channel-permission-query.test.ts +69 -0
  350. package/src/permissions/channel-permission-query.ts +73 -1
  351. package/src/permissions/checker.test.ts +85 -9
  352. package/src/permissions/checker.ts +17 -22
  353. package/src/permissions/confirmation-guardian-request.test.ts +2 -2
  354. package/src/permissions/confirmation-guardian-request.ts +2 -2
  355. package/src/permissions/gateway-threshold-reader.test.ts +224 -17
  356. package/src/permissions/gateway-threshold-reader.ts +82 -10
  357. package/src/permissions/ipc-risk-types.ts +8 -0
  358. package/src/permissions/prompter.ts +5 -5
  359. package/src/permissions/question-guardian-request.test.ts +222 -0
  360. package/src/permissions/question-guardian-request.ts +179 -0
  361. package/src/permissions/question-prompter.test.ts +8 -8
  362. package/src/permissions/question-prompter.ts +18 -0
  363. package/src/permissions/secret-prompter.ts +2 -4
  364. package/src/permissions/workspace-policy.ts +236 -34
  365. package/src/persistence/__tests__/lifecycle-quiesce.test.ts +82 -0
  366. package/src/persistence/__tests__/message-content-file.test.ts +58 -3
  367. package/src/persistence/conversation-crud.ts +93 -0
  368. package/src/persistence/conversation-key-store.ts +63 -0
  369. package/src/persistence/db-async-query.ts +1 -1
  370. package/src/persistence/db-singleton.ts +14 -27
  371. package/src/persistence/delivery-crud.ts +45 -0
  372. package/src/persistence/embeddings/embedding-backend.ts +2 -1
  373. package/src/persistence/embeddings/embedding-identity.ts +7 -3
  374. package/src/persistence/job-utils.ts +32 -27
  375. package/src/persistence/jobs-store.ts +92 -3
  376. package/src/persistence/lifecycle-quiesce.ts +80 -0
  377. package/src/persistence/llm-usage-store.ts +45 -8
  378. package/src/persistence/message-content-file.ts +4 -4
  379. package/src/persistence/migrations/336-move-memory-v2-activation-logs-to-memory-db.ts +1 -1
  380. package/src/persistence/migrations/351-schedule-skill-script-handoff.ts +39 -0
  381. package/src/persistence/migrations/352-drop-schedule-skill-script-handoff.test.ts +83 -0
  382. package/src/persistence/migrations/352-drop-schedule-skill-script-handoff.ts +36 -0
  383. package/src/persistence/migrations/353-add-llm-usage-conversation-type.test.ts +110 -0
  384. package/src/persistence/migrations/353-add-llm-usage-conversation-type.ts +49 -0
  385. package/src/persistence/schema/infrastructure.ts +11 -0
  386. package/src/persistence/steps.ts +7 -1
  387. package/src/plugin-api/__tests__/publish-event-forwarding.test.ts +113 -0
  388. package/src/plugin-api/__tests__/publish-event.test.ts +57 -0
  389. package/src/plugin-api/conversation-turn.ts +4 -4
  390. package/src/plugin-api/event-hub-facade.ts +15 -6
  391. package/src/plugin-api/index.ts +10 -4
  392. package/src/plugin-api/publish-event.ts +36 -0
  393. package/src/plugins/AGENTS.md +2 -0
  394. package/src/plugins/defaults/compaction/window-manager.ts +9 -0
  395. package/src/plugins/defaults/index.ts +9 -13
  396. package/src/plugins/defaults/memory/AGENTS.md +775 -0
  397. package/src/plugins/defaults/memory/__tests__/capability-seed-embed-gate.test.ts +186 -0
  398. package/src/plugins/defaults/memory/__tests__/fixtures/memory-v2-activation-fixtures.ts +1 -1
  399. package/src/plugins/defaults/memory/__tests__/indexer-tier-dispatch.test.ts +129 -0
  400. package/src/plugins/defaults/memory/__tests__/jobs-worker-quiesce-gate.test.ts +91 -0
  401. package/src/plugins/defaults/memory/__tests__/jobs-worker-v1-graph-substrate-noop.test.ts +342 -0
  402. package/src/plugins/defaults/memory/__tests__/jobs-worker-v2-graph-trigger-embed.test.ts +9 -1
  403. package/src/plugins/defaults/memory/__tests__/jobs-worker-v2-schedule.test.ts +36 -1
  404. package/src/plugins/defaults/memory/__tests__/jobs-worker-v2-sweep-defer.test.ts +9 -1
  405. package/src/plugins/defaults/memory/__tests__/memory-log-stores-degraded.test.ts +2 -2
  406. package/src/plugins/defaults/memory/__tests__/memory-retrospective-job.test.ts +44 -10
  407. package/src/plugins/defaults/memory/__tests__/memory-retrospective-sweep.test.ts +151 -10
  408. package/src/plugins/defaults/memory/__tests__/memory-tier-boundary-guard.test.ts +1155 -0
  409. package/src/plugins/defaults/memory/__tests__/memory-v2-activation-log-store.test.ts +1 -1
  410. package/src/plugins/defaults/memory/__tests__/memory-v2-concept-frequency.test.ts +3 -3
  411. package/src/plugins/defaults/memory/__tests__/tools-delete-memory-page.test.ts +1 -1
  412. package/src/plugins/defaults/memory/context-search/sources/memory-v2.ts +71 -35
  413. package/src/plugins/defaults/memory/context-search/sources/memory.ts +5 -1
  414. package/src/plugins/defaults/memory/fork-conversation-memory.ts +4 -4
  415. package/src/plugins/defaults/memory/graph/__tests__/conversation-graph-memory-v2-routing.test.ts +80 -10
  416. package/src/plugins/defaults/memory/graph/__tests__/handle-remember-v2.test.ts +1 -1
  417. package/src/plugins/defaults/memory/graph/capability-seed.ts +24 -10
  418. package/src/plugins/defaults/memory/graph/conversation-graph-memory.ts +123 -49
  419. package/src/plugins/defaults/memory/graph/graph-search.ts +6 -118
  420. package/src/plugins/defaults/memory/graph/in-context-tracker.test.ts +173 -0
  421. package/src/plugins/defaults/memory/graph/in-context-tracker.ts +109 -0
  422. package/src/plugins/defaults/memory/graph/store.ts +1 -0
  423. package/src/plugins/defaults/memory/graph/tool-handlers.test.ts +1 -1
  424. package/src/plugins/defaults/memory/graph/tool-handlers.ts +5 -2
  425. package/src/plugins/defaults/memory/graph-topology/__tests__/build-memory-graph.test.ts +1 -1
  426. package/src/plugins/defaults/memory/graph-topology/build-memory-graph.ts +6 -9
  427. package/src/plugins/defaults/memory/hooks/__tests__/user-prompt-submit.test.ts +30 -16
  428. package/src/plugins/defaults/memory/hooks/user-prompt-submit.ts +18 -14
  429. package/src/plugins/defaults/memory/indexer.ts +146 -89
  430. package/src/plugins/defaults/memory/injectors.ts +86 -41
  431. package/src/plugins/defaults/memory/job-handlers.ts +130 -39
  432. package/src/plugins/defaults/memory/jobs/__tests__/embed-concept-page.test.ts +2 -2
  433. package/src/plugins/defaults/memory/jobs/embed-concept-page.ts +22 -10
  434. package/src/plugins/defaults/memory/jobs-worker.ts +279 -208
  435. package/src/plugins/defaults/memory/memory-retrospective-enqueue.ts +4 -2
  436. package/src/plugins/defaults/memory/memory-retrospective-job.ts +40 -3
  437. package/src/plugins/defaults/memory/memory-retrospective-sweep.ts +99 -11
  438. package/src/plugins/defaults/memory/src/__tests__/memory-v2-routes.test.ts +5 -3
  439. package/src/plugins/defaults/memory/src/__tests__/memory-v2-simulate-route.test.ts +3 -4
  440. package/src/plugins/defaults/memory/src/memory-graph-routes.ts +2 -1
  441. package/src/plugins/defaults/memory/src/memory-item-routes.test.ts +7 -5
  442. package/src/plugins/defaults/memory/src/memory-item-routes.ts +51 -19
  443. package/src/plugins/defaults/memory/src/memory-v2-routes.ts +31 -20
  444. package/src/plugins/defaults/memory/startup.ts +58 -21
  445. package/src/plugins/defaults/memory/substrate/__tests__/boot-maintenance.test.ts +335 -0
  446. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/cli-command-store.test.ts +14 -8
  447. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/consolidation-job.test.ts +51 -21
  448. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/edge-index.test.ts +1 -1
  449. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/frontmatter-sweep.test.ts +3 -3
  450. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/page-index.test.ts +1 -1
  451. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/page-store.test.ts +1 -1
  452. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/prompts-consolidation.test.ts +2 -2
  453. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/qdrant.test.ts +23 -14
  454. package/src/plugins/defaults/memory/substrate/__tests__/reembed-job.test.ts +262 -0
  455. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/sim.test.ts +9 -12
  456. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/skill-content.test.ts +2 -2
  457. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/skill-store.test.ts +9 -9
  458. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/sparse-bm25.test.ts +12 -5
  459. package/src/plugins/defaults/memory/substrate/__tests__/spread.test.ts +276 -0
  460. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/static-context.test.ts +17 -8
  461. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/sweep-job.test.ts +9 -9
  462. package/src/plugins/defaults/memory/{v3/substrate/memory-v2-startup.ts → substrate/boot-maintenance.ts} +43 -24
  463. package/src/plugins/defaults/memory/{v3/substrate → substrate}/cli-command-store.ts +13 -8
  464. package/src/plugins/defaults/memory/{v3/substrate → substrate}/consolidation-job.ts +51 -27
  465. package/src/plugins/defaults/memory/{v3/substrate → substrate}/constants.ts +1 -0
  466. package/src/plugins/defaults/memory/{v3/substrate → substrate}/edge-index.ts +28 -9
  467. package/src/plugins/defaults/memory/{v3/substrate → substrate}/frontmatter-sweep.ts +14 -7
  468. package/src/plugins/defaults/memory/{v3/substrate → substrate}/injected-block-slugs.ts +9 -3
  469. package/src/plugins/defaults/memory/{v3/substrate → substrate}/page-index.ts +29 -10
  470. package/src/plugins/defaults/memory/{v3/substrate → substrate}/page-store.ts +35 -12
  471. package/src/plugins/defaults/memory/{v3/substrate → substrate}/prompts/consolidation.ts +14 -8
  472. package/src/plugins/defaults/memory/{v3/substrate → substrate}/prompts/sweep.ts +4 -1
  473. package/src/plugins/defaults/memory/{v3/substrate → substrate}/qdrant.ts +96 -36
  474. package/src/plugins/defaults/memory/substrate/reembed-job.ts +54 -0
  475. package/src/plugins/defaults/memory/{v3/substrate → substrate}/sim.ts +26 -15
  476. package/src/plugins/defaults/memory/{v3/substrate → substrate}/skill-content.ts +1 -1
  477. package/src/plugins/defaults/memory/{v3/substrate → substrate}/skill-store.ts +13 -8
  478. package/src/plugins/defaults/memory/{v3/substrate → substrate}/sparse-bm25.ts +27 -10
  479. package/src/plugins/defaults/memory/substrate/spread.ts +165 -0
  480. package/src/plugins/defaults/memory/{v3/substrate → substrate}/static-context.ts +12 -7
  481. package/src/plugins/defaults/memory/{v3/substrate → substrate}/sweep-job.ts +20 -15
  482. package/src/plugins/defaults/memory/substrate/tuning.ts +93 -0
  483. package/src/plugins/defaults/memory/{v3/substrate → substrate}/types.ts +7 -4
  484. package/src/plugins/defaults/memory/tools.test.ts +1 -1
  485. package/src/plugins/defaults/memory/tools.ts +1 -1
  486. package/src/plugins/defaults/memory/v1/README.md +5 -0
  487. package/src/plugins/defaults/memory/{__tests__ → v1/__tests__}/filing-jobs.test.ts +4 -4
  488. package/src/plugins/defaults/memory/{filing-jobs.ts → v1/filing-jobs.ts} +3 -3
  489. package/src/plugins/defaults/memory/{graph → v1/graph}/bootstrap.test.ts +68 -6
  490. package/src/plugins/defaults/memory/{graph → v1/graph}/bootstrap.ts +40 -21
  491. package/src/plugins/defaults/memory/{graph → v1/graph}/consolidation.ts +14 -14
  492. package/src/plugins/defaults/memory/{graph → v1/graph}/decay.test.ts +1 -1
  493. package/src/plugins/defaults/memory/{graph → v1/graph}/decay.ts +3 -3
  494. package/src/plugins/defaults/memory/{graph → v1/graph}/extraction-job.ts +5 -5
  495. package/src/plugins/defaults/memory/{graph → v1/graph}/extraction.test.ts +1 -1
  496. package/src/plugins/defaults/memory/{graph → v1/graph}/extraction.ts +20 -14
  497. package/src/plugins/defaults/memory/{graph → v1/graph}/graph-search.test.ts +3 -3
  498. package/src/plugins/defaults/memory/v1/graph/graph-search.ts +123 -0
  499. package/src/plugins/defaults/memory/{graph → v1/graph}/injection.test.ts +1 -118
  500. package/src/plugins/defaults/memory/{graph → v1/graph}/injection.ts +9 -111
  501. package/src/plugins/defaults/memory/{graph → v1/graph}/narrative.ts +6 -6
  502. package/src/plugins/defaults/memory/{graph → v1/graph}/pattern-scan.ts +5 -5
  503. package/src/plugins/defaults/memory/{graph → v1/graph}/retriever.test.ts +135 -42
  504. package/src/plugins/defaults/memory/{graph → v1/graph}/retriever.ts +40 -22
  505. package/src/plugins/defaults/memory/{graph → v1/graph}/scoring.test.ts +1 -1
  506. package/src/plugins/defaults/memory/{graph → v1/graph}/scoring.ts +1 -1
  507. package/src/plugins/defaults/memory/{graph → v1/graph}/serendipity.ts +1 -1
  508. package/src/plugins/defaults/memory/{graph → v1/graph}/triggers.test.ts +1 -1
  509. package/src/plugins/defaults/memory/{graph → v1/graph}/triggers.ts +1 -1
  510. package/src/plugins/defaults/memory/{identity-context.ts → v1/identity-context.ts} +4 -4
  511. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/backfill.ts +6 -6
  512. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/embedding.test.ts +6 -6
  513. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/embedding.ts +6 -6
  514. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/index-maintenance.ts +8 -8
  515. package/src/plugins/defaults/memory/{jobs → v1/jobs}/embed-pkb-file.test.ts +7 -7
  516. package/src/plugins/defaults/memory/{jobs → v1/jobs}/embed-pkb-file.ts +5 -5
  517. package/src/plugins/defaults/memory/{pkb → v1/pkb}/autoinject.ts +1 -1
  518. package/src/plugins/defaults/memory/{pkb → v1/pkb}/context.ts +2 -2
  519. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-index.test.ts +3 -3
  520. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-index.ts +2 -2
  521. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-reconcile.test.ts +3 -3
  522. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-reconcile.ts +2 -2
  523. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-search.test.ts +3 -3
  524. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-search.ts +6 -6
  525. package/src/plugins/defaults/memory/{pkb → v1/pkb}/types.ts +3 -5
  526. package/src/plugins/defaults/memory/{pkb-schedule.ts → v1/pkb-schedule.ts} +2 -2
  527. package/src/plugins/defaults/memory/{search/semantic.ts → v1/semantic-search.ts} +1 -1
  528. package/src/plugins/defaults/memory/v2/__tests__/activation-store.test.ts +1 -1
  529. package/src/plugins/defaults/memory/v2/__tests__/activation.test.ts +11 -274
  530. package/src/plugins/defaults/memory/v2/__tests__/backfill-jobs.test.ts +9 -131
  531. package/src/plugins/defaults/memory/v2/__tests__/harness-compare.test.ts +1 -1
  532. package/src/plugins/defaults/memory/v2/__tests__/harness-oracle.test.ts +1 -1
  533. package/src/plugins/defaults/memory/v2/__tests__/harness-replay-input.test.ts +1 -1
  534. package/src/plugins/defaults/memory/v2/__tests__/injection.test.ts +14 -10
  535. package/src/plugins/defaults/memory/v2/__tests__/reranker.test.ts +7 -5
  536. package/src/plugins/defaults/memory/v2/__tests__/router.test.ts +12 -6
  537. package/src/plugins/defaults/memory/{memory-v2-activation-log-store.ts → v2/activation-log-store.ts} +2 -2
  538. package/src/plugins/defaults/memory/v2/activation-store.ts +22 -8
  539. package/src/plugins/defaults/memory/v2/activation.ts +30 -163
  540. package/src/plugins/defaults/memory/v2/backfill-jobs.ts +7 -54
  541. package/src/plugins/defaults/memory/{memory-v2-concept-frequency.ts → v2/concept-frequency.ts} +3 -3
  542. package/src/plugins/defaults/memory/v2/harness/oracle.ts +1 -1
  543. package/src/plugins/defaults/memory/v2/harness/replay-input.ts +2 -2
  544. package/src/plugins/defaults/memory/v2/harness/retriever.ts +1 -1
  545. package/src/plugins/defaults/memory/v2/injection.ts +36 -26
  546. package/src/plugins/defaults/memory/v2/migration.ts +2 -2
  547. package/src/plugins/defaults/memory/{rerank-local.ts → v2/rerank-local.ts} +44 -18
  548. package/src/plugins/defaults/memory/v2/reranker.ts +29 -11
  549. package/src/plugins/defaults/memory/v2/router.ts +38 -15
  550. package/src/plugins/defaults/memory/v3/__tests__/candidate-match.test.ts +5 -3
  551. package/src/plugins/defaults/memory/v3/__tests__/carry-integration.test.ts +21 -8
  552. package/src/plugins/defaults/memory/v3/__tests__/edge.test.ts +1 -1
  553. package/src/plugins/defaults/memory/v3/__tests__/live-integration.test.ts +1 -1
  554. package/src/plugins/defaults/memory/v3/__tests__/maintain-job.test.ts +4 -1
  555. package/src/plugins/defaults/memory/v3/__tests__/orchestrate.test.ts +181 -3
  556. package/src/plugins/defaults/memory/v3/__tests__/selection-log-store.test.ts +3 -0
  557. package/src/plugins/defaults/memory/v3/__tests__/shadow-integration.test.ts +14 -5
  558. package/src/plugins/defaults/memory/v3/__tests__/shadow-plugin.test.ts +40 -50
  559. package/src/plugins/defaults/memory/v3/__tests__/tuning-profile.test.ts +1 -0
  560. package/src/plugins/defaults/memory/v3/candidate-match.ts +2 -2
  561. package/src/plugins/defaults/memory/v3/capabilities.ts +6 -4
  562. package/src/plugins/defaults/memory/v3/card.ts +25 -9
  563. package/src/plugins/defaults/memory/v3/edge.ts +52 -18
  564. package/src/plugins/defaults/memory/v3/gate.ts +4 -4
  565. package/src/plugins/defaults/memory/v3/injector.ts +10 -3
  566. package/src/plugins/defaults/memory/v3/maintain-job.ts +3 -3
  567. package/src/plugins/defaults/memory/v3/orchestrate.ts +100 -18
  568. package/src/plugins/defaults/memory/v3/page-content.ts +26 -10
  569. package/src/plugins/defaults/memory/v3/prune.ts +40 -16
  570. package/src/plugins/defaults/memory/v3/selection-log-store.ts +34 -12
  571. package/src/plugins/defaults/memory/v3/shadow-plugin.ts +9 -13
  572. package/src/plugins/defaults/memory/v3/span-query.test.ts +86 -0
  573. package/src/plugins/defaults/memory/v3/span-query.ts +71 -0
  574. package/src/plugins/defaults/memory/v3/tuning-profile.ts +3 -0
  575. package/src/plugins/defaults/memory/v3/types.ts +4 -1
  576. package/src/plugins/defaults/memory/v3-eval/eval-packets.ts +2 -2
  577. package/src/plugins/defaults/memory/validation.ts +1 -1
  578. package/src/plugins/defaults/memory/worker.ts +2 -1
  579. package/src/plugins/defaults/platform-hosted/__tests__/reengage.test.ts +104 -12
  580. package/src/plugins/defaults/platform-hosted/routes/reengage.ts +104 -12
  581. package/src/plugins/types.ts +2 -2
  582. package/src/providers/__tests__/registry-native-web-search.test.ts +47 -2
  583. package/src/providers/anthropic/client.ts +15 -6
  584. package/src/providers/content-block-schema.ts +26 -0
  585. package/src/providers/inference/__tests__/connections-credential-normalize.test.ts +87 -0
  586. package/src/providers/inference/adapter-factory.ts +6 -0
  587. package/src/providers/inference/connections.ts +30 -14
  588. package/src/providers/model-catalog.ts +77 -0
  589. package/src/providers/openai/__tests__/chat-completions-input-audio.test.ts +260 -0
  590. package/src/providers/openai/chat-completions-provider.ts +65 -17
  591. package/src/providers/openai/input-audio.ts +76 -0
  592. package/src/providers/openrouter/client.ts +0 -2
  593. package/src/providers/platform-proxy/constants.ts +4 -0
  594. package/src/providers/poolside/client.ts +42 -0
  595. package/src/providers/registry.ts +40 -8
  596. package/src/providers/retry.ts +2 -0
  597. package/src/providers/types.ts +39 -1
  598. package/src/providers/vercel-ai-gateway/client.ts +0 -2
  599. package/src/runtime/AGENTS.md +7 -5
  600. package/src/runtime/__tests__/question-request-guardian-bridge.test.ts +173 -0
  601. package/src/runtime/__tests__/question-resolution.test.ts +111 -0
  602. package/src/runtime/access-request-helper.ts +7 -15
  603. package/src/runtime/assistant-event-hub.ts +43 -31
  604. package/src/runtime/assistant-event-publish-options.ts +31 -0
  605. package/src/runtime/assistant-event.ts +19 -30
  606. package/src/runtime/assistant-stream-state.ts +4 -4
  607. package/src/runtime/channel-approvals.ts +0 -25
  608. package/src/runtime/channel-readiness-service.ts +99 -40
  609. package/src/runtime/channel-retry-sweep.ts +38 -15
  610. package/src/runtime/confirmation-request-guardian-bridge.ts +4 -0
  611. package/src/runtime/guardian-reply-router.ts +108 -0
  612. package/src/runtime/http-server.ts +8 -0
  613. package/src/runtime/http-types.ts +2 -2
  614. package/src/runtime/process-role.ts +42 -0
  615. package/src/runtime/question-request-guardian-bridge.ts +184 -0
  616. package/src/runtime/question-resolution.ts +153 -0
  617. package/src/runtime/routes/__tests__/bookmark-routes.test.ts +6 -2
  618. package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +1 -1
  619. package/src/runtime/routes/acp-routes.ts +2 -2
  620. package/src/runtime/routes/bookmark-routes.ts +3 -15
  621. package/src/runtime/routes/canned-message-complete.ts +2 -2
  622. package/src/runtime/routes/consolidation-routes.ts +8 -2
  623. package/src/runtime/routes/conversation-list-routes.ts +3 -19
  624. package/src/runtime/routes/conversation-management-routes.ts +1 -5
  625. package/src/runtime/routes/conversation-query-routes.ts +52 -8
  626. package/src/runtime/routes/conversation-routes.ts +36 -22
  627. package/src/runtime/routes/credential-request-routes.ts +0 -1
  628. package/src/runtime/routes/filing-routes.ts +7 -7
  629. package/src/runtime/routes/global-search-routes.ts +1 -1
  630. package/src/runtime/routes/guardian-approval-prompt.ts +2 -2
  631. package/src/runtime/routes/image-generation-routes.ts +12 -9
  632. package/src/runtime/routes/inbound-message-handler.ts +17 -0
  633. package/src/runtime/routes/inbound-stages/acl-enforcement.test.ts +50 -0
  634. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +19 -0
  635. package/src/runtime/routes/inbound-stages/background-dispatch.ts +4 -4
  636. package/src/runtime/routes/inbound-stages/inbound-content-prep.test.ts +129 -0
  637. package/src/runtime/routes/inbound-stages/inbound-content-prep.ts +141 -9
  638. package/src/runtime/routes/index.ts +2 -0
  639. package/src/runtime/routes/lifecycle-routes.ts +199 -0
  640. package/src/runtime/routes/platform-routes.ts +3 -8
  641. package/src/runtime/routes/playground/__tests__/inject-failures.test.ts +7 -7
  642. package/src/runtime/routes/playground/__tests__/reset-circuit.test.ts +5 -5
  643. package/src/runtime/routes/question-routes.ts +34 -87
  644. package/src/runtime/routes/secret-routes.ts +11 -1
  645. package/src/runtime/routes/settings-routes.ts +8 -18
  646. package/src/runtime/routes/upgrade-broadcast-routes.ts +4 -5
  647. package/src/runtime/routes/workspace-routes.test.ts +7 -4
  648. package/src/runtime/slack-reply-session.test.ts +12 -12
  649. package/src/runtime/slack-reply-session.ts +17 -17
  650. package/src/runtime/sync/sync-publisher.test.ts +7 -5
  651. package/src/runtime/tool-grant-request-helper.ts +4 -0
  652. package/src/schedule/schedule-store.ts +70 -0
  653. package/src/schedule/scheduler.ts +27 -0
  654. package/src/security/AGENTS.md +1 -1
  655. package/src/security/credential-key.ts +17 -0
  656. package/src/security/secret-ingress.ts +14 -105
  657. package/src/security/secret-patterns.ts +8 -139
  658. package/src/security/secret-scanner.ts +8 -3
  659. package/src/security/store-path-override.ts +6 -16
  660. package/src/sequence/store.ts +8 -0
  661. package/src/signals/emit-event.ts +5 -10
  662. package/src/signals/event-stream.ts +20 -10
  663. package/src/subagent/manager.ts +76 -25
  664. package/src/subagent/notify.ts +8 -0
  665. package/src/subagent/types.ts +13 -3
  666. package/src/telegram/__tests__/webhook-health.test.ts +442 -0
  667. package/src/telegram/webhook-health.ts +478 -0
  668. package/src/telemetry/AGENTS.md +6 -0
  669. package/src/telemetry/memory-corpus-size.test.ts +129 -0
  670. package/src/telemetry/memory-corpus-size.ts +184 -0
  671. package/src/telemetry/memory-tier-reporter.test.ts +67 -2
  672. package/src/telemetry/memory-tier-reporter.ts +30 -3
  673. package/src/tools/__tests__/document-tool-input-schemas.test.ts +103 -0
  674. package/src/tools/__tests__/followup-call-acp-tool-input-schemas.test.ts +125 -0
  675. package/src/tools/__tests__/schedule-tool-input-schemas.test.ts +83 -0
  676. package/src/tools/__tests__/subagent-workflow-tool-input-schemas.test.ts +116 -0
  677. package/src/tools/__tests__/tool-input-schemas.test.ts +192 -0
  678. package/src/tools/__tests__/tool-schema-drift-harness.ts +142 -0
  679. package/src/tools/acp/abort.ts +21 -1
  680. package/src/tools/acp/context.ts +5 -5
  681. package/src/tools/acp/spawn.test.ts +15 -5
  682. package/src/tools/acp/spawn.ts +26 -3
  683. package/src/tools/acp/status.ts +20 -1
  684. package/src/tools/acp/steer.test.ts +20 -0
  685. package/src/tools/acp/steer.ts +23 -2
  686. package/src/tools/ask-question/ask-question-tool.test.ts +65 -0
  687. package/src/tools/ask-question/ask-question-tool.ts +68 -92
  688. package/src/tools/browser/browser-screencast.ts +6 -6
  689. package/src/tools/calls/call-end.ts +24 -3
  690. package/src/tools/calls/call-start.ts +35 -11
  691. package/src/tools/calls/call-status.ts +20 -1
  692. package/src/tools/document/document-comment-tool.test.ts +49 -0
  693. package/src/tools/document/document-comment-tool.ts +45 -6
  694. package/src/tools/document/document-tool.ts +142 -24
  695. package/src/tools/executor.ts +27 -13
  696. package/src/tools/filesystem/edit.ts +62 -60
  697. package/src/tools/filesystem/list.ts +36 -29
  698. package/src/tools/filesystem/read.ts +56 -39
  699. package/src/tools/filesystem/write.ts +44 -38
  700. package/src/tools/followups/followup_create.ts +41 -12
  701. package/src/tools/followups/followup_list.ts +34 -6
  702. package/src/tools/followups/followup_resolve.ts +26 -4
  703. package/src/tools/host-filesystem/edit.ts +50 -60
  704. package/src/tools/host-filesystem/read.ts +45 -39
  705. package/src/tools/host-filesystem/write.ts +31 -36
  706. package/src/tools/host-terminal/host-shell.ts +76 -62
  707. package/src/tools/policy-context.ts +27 -10
  708. package/src/tools/schedule/create.ts +76 -33
  709. package/src/tools/schedule/delete.ts +21 -2
  710. package/src/tools/schedule/list.ts +25 -3
  711. package/src/tools/schedule/update.ts +105 -48
  712. package/src/tools/shared/filesystem/path-policy.ts +246 -40
  713. package/src/tools/shared/zod-tool-schema.ts +117 -0
  714. package/src/tools/subagent/abort.ts +12 -4
  715. package/src/tools/subagent/consult-deadline.ts +9 -3
  716. package/src/tools/subagent/message.ts +21 -5
  717. package/src/tools/subagent/notify-parent.ts +44 -23
  718. package/src/tools/subagent/read.ts +15 -4
  719. package/src/tools/subagent/resolve.ts +26 -4
  720. package/src/tools/subagent/spawn.ts +37 -13
  721. package/src/tools/subagent/status.ts +12 -4
  722. package/src/tools/system/request-permission.ts +35 -26
  723. package/src/tools/terminal/shell.ts +68 -55
  724. package/src/tools/tool-approval-handler.ts +327 -53
  725. package/src/tools/tool-input-schemas.ts +85 -0
  726. package/src/tools/tool-types.ts +7 -0
  727. package/src/tools/types.ts +8 -0
  728. package/src/tools/workflows/manage-workflows.ts +30 -2
  729. package/src/tools/workflows/run-workflow.test.ts +54 -2
  730. package/src/tools/workflows/run-workflow.ts +32 -4
  731. package/src/util/fs-symlinks.ts +30 -0
  732. package/src/util/log-redact.ts +7 -3
  733. package/src/vellum-assistant-namespace.d.ts +80 -0
  734. package/src/watcher/watcher-store.ts +8 -0
  735. package/src/workflows/leaf-runner.test.ts +104 -2
  736. package/src/workflows/leaf-runner.ts +31 -6
  737. package/src/workspace/migrations/070-memory-v2-summary-schema-rebuild.ts +2 -2
  738. package/src/workspace/migrations/134-image-generation-mode-to-provider.ts +128 -0
  739. package/src/workspace/migrations/135-copy-substrate-tunables.ts +248 -0
  740. package/src/workspace/migrations/__tests__/135-copy-substrate-tunables.test.ts +446 -0
  741. package/src/workspace/migrations/__tests__/backfill-v3-leaves.test.ts +2 -2
  742. package/src/workspace/migrations/registry.ts +4 -0
  743. package/src/__tests__/memory-retrieval-budget.test.ts +0 -49
  744. package/src/__tests__/secret-patterns.test.ts +0 -27
  745. package/src/config/__tests__/proc-to-skills.test.ts +0 -21
  746. package/src/config/memory-tier.test.ts +0 -44
  747. package/src/daemon/message-types/acp.ts +0 -20
  748. package/src/daemon/message-types/apps.ts +0 -11
  749. package/src/daemon/message-types/background-tools.ts +0 -14
  750. package/src/daemon/message-types/bookmarks.ts +0 -13
  751. package/src/daemon/message-types/contacts.ts +0 -13
  752. package/src/daemon/message-types/document-comments.ts +0 -14
  753. package/src/daemon/message-types/documents.ts +0 -13
  754. package/src/daemon/message-types/home.ts +0 -15
  755. package/src/daemon/message-types/host-bash.ts +0 -12
  756. package/src/daemon/message-types/host-cu.ts +0 -10
  757. package/src/daemon/message-types/host-file.ts +0 -12
  758. package/src/daemon/message-types/host-transfer.ts +0 -12
  759. package/src/daemon/message-types/integrations.ts +0 -90
  760. package/src/daemon/message-types/memory.ts +0 -10
  761. package/src/daemon/message-types/schedules.ts +0 -14
  762. package/src/daemon/message-types/settings.ts +0 -17
  763. package/src/daemon/message-types/subagents.ts +0 -63
  764. package/src/daemon/message-types/upgrades.ts +0 -14
  765. package/src/daemon/message-types/workflows.ts +0 -25
  766. package/src/daemon/message-types/workspace.ts +0 -137
  767. package/src/live-voice/ack-phrases.ts +0 -58
  768. package/src/plugins/defaults/memory/retrieval-budget.ts +0 -29
  769. package/src/plugins/defaults/memory/v3/__tests__/gate-flag.test.ts +0 -69
  770. package/src/plugins/defaults/memory/v3/gate-flag.ts +0 -20
  771. package/src/plugins/defaults/memory/v3/substrate/__tests__/memory-v2-startup.test.ts +0 -86
  772. package/src/plugins/defaults/memory/v3/substrate/memory-v2-startup.test.ts +0 -205
  773. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/concept-page-frontmatter-schema.test.ts +0 -0
  774. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/consolidation-prompt-flag-gating-guard.test.ts +0 -0
  775. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/injected-block-slugs.test.ts +0 -0
  776. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/cli-command-content.ts +0 -0
@@ -0,0 +1,184 @@
1
+ import { readdirSync, readFileSync, statSync } from "node:fs";
2
+ import { join } from "node:path";
3
+
4
+ import { getWorkspaceDir } from "../util/platform.js";
5
+
6
+ /**
7
+ * Coarse on-disk size of the assistant's memory corpus, in the snake_case
8
+ * shape the `memory_tier` watchdog `detail` bag carries to the platform.
9
+ *
10
+ * Both corpora are measured on every tier rather than branching on the tier
11
+ * itself: an assistant part-way through a v1 -> v2 -> v3 migration has content
12
+ * in both trees, and a `memory.enabled: false` assistant still has whatever it
13
+ * accumulated before being switched off. Reporting both unconditionally keeps
14
+ * the numbers legible across a migration instead of blinking to zero the
15
+ * moment a tier flips.
16
+ *
17
+ * KNOWN GAP: this measures on-disk Markdown only. It does NOT count
18
+ * `memory_graph_nodes`, which is a real part of a v1 assistant's learned state
19
+ * — `v2/migration.ts` gathers graph nodes alongside PKB Markdown when it
20
+ * migrates v1 — so a v1 assistant rich in graph nodes but holding only the
21
+ * seeded PKB files reads as near-empty here. Counting them means opening the
22
+ * memory SQLite DB from the resource-monitor process, which this probe
23
+ * deliberately does not do. Treat `pkb_files` as a lower bound on v1 corpus
24
+ * size and confirm v1 assistants directly before sizing a migration off it.
25
+ */
26
+ export interface MemoryCorpusSize {
27
+ /** `.md` files under `memory/concepts/` — the v2/v3 concept-page count. */
28
+ concept_pages: number;
29
+ /** Total bytes of those concept pages. */
30
+ concept_bytes: number;
31
+ /** `.md` files under `pkb/` — the v1 personal-knowledge-base corpus. */
32
+ pkb_files: number;
33
+ /** Total bytes of those PKB files. */
34
+ pkb_bytes: number;
35
+ /**
36
+ * Non-empty lines in `memory/buffer.md` — remembered facts still waiting on
37
+ * consolidation. Matches `countBufferLines` in the substrate's
38
+ * consolidation job: for a well-formed buffer, one non-empty line is one
39
+ * entry.
40
+ */
41
+ buffer_lines: number;
42
+ }
43
+
44
+ /**
45
+ * Ceiling on directory entries examined per tree. The largest corpus observed
46
+ * in the fleet is in the low hundreds of pages, so this never binds in
47
+ * practice; it exists so a pathological workspace cannot turn a telemetry
48
+ * probe into a long walk.
49
+ *
50
+ * It counts every dirent seen — directories and non-Markdown files included —
51
+ * not just the Markdown matches. A cap on matches alone would not bound the
52
+ * walk at all: a tree of a million empty directories contains zero Markdown
53
+ * files and would still be traversed in full by this synchronous probe.
54
+ *
55
+ * A tree that hits the cap returns what it counted so far, making the result
56
+ * a floor rather than an error.
57
+ */
58
+ const MAX_ENTRIES_PER_TREE = 20_000;
59
+
60
+ interface TreeSize {
61
+ files: number;
62
+ bytes: number;
63
+ }
64
+
65
+ const EMPTY_TREE: TreeSize = { files: 0, bytes: 0 };
66
+
67
+ /**
68
+ * Recursively total the `.md` files under `dir`.
69
+ *
70
+ * Deliberately synchronous, and deliberately not routed through the memory
71
+ * plugin's `listPages` / `getPageIndex`. This runs in the resource-monitor
72
+ * process, where the plugin's page-index cache is cold — going through it
73
+ * would read and parse every concept page on each six-hour cycle, and would
74
+ * add an import out of `telemetry/` into the plugin tree that the plugin
75
+ * import-boundary guard exists to prevent. A bare readdir + stat is the whole
76
+ * job here.
77
+ *
78
+ * `withFileTypes` dirents carry lstat semantics, so a symlinked directory
79
+ * reports as a symlink rather than a directory and is skipped — the walk
80
+ * cannot follow a link into a cycle, and needs no visited-inode bookkeeping.
81
+ *
82
+ * `maxEntries` is a parameter only so the ceiling is testable without
83
+ * materializing twenty thousand files; production callers take the default.
84
+ */
85
+ export function measureMarkdownTree(
86
+ dir: string,
87
+ maxEntries: number = MAX_ENTRIES_PER_TREE,
88
+ ): TreeSize {
89
+ let files = 0;
90
+ let bytes = 0;
91
+ let visited = 0;
92
+ const pending: string[] = [dir];
93
+
94
+ while (pending.length > 0) {
95
+ const current = pending.pop();
96
+ if (current === undefined) {
97
+ break;
98
+ }
99
+
100
+ let entries;
101
+ try {
102
+ entries = readdirSync(current, { withFileTypes: true });
103
+ } catch {
104
+ // A missing or unreadable subtree contributes nothing. The common case
105
+ // is ENOENT: the tier that owns this tree was never active here.
106
+ continue;
107
+ }
108
+
109
+ for (const entry of entries) {
110
+ visited += 1;
111
+ if (visited > maxEntries) {
112
+ return { files, bytes };
113
+ }
114
+ if (entry.isDirectory()) {
115
+ pending.push(join(current, entry.name));
116
+ continue;
117
+ }
118
+ if (!entry.isFile() || !entry.name.endsWith(".md")) {
119
+ continue;
120
+ }
121
+ files += 1;
122
+ try {
123
+ bytes += statSync(join(current, entry.name)).size;
124
+ } catch {
125
+ // Counted in `files` but contributes no bytes — a file that vanished
126
+ // between the readdir and the stat is a race, not a failure.
127
+ }
128
+ }
129
+ }
130
+
131
+ return { files, bytes };
132
+ }
133
+
134
+ /** Non-empty-line count of the file at `path`; 0 when it is absent or empty. */
135
+ function countNonEmptyLines(path: string): number {
136
+ let content: string;
137
+ try {
138
+ content = readFileSync(path, "utf8");
139
+ } catch {
140
+ return 0;
141
+ }
142
+ if (content.length === 0) {
143
+ return 0;
144
+ }
145
+ return content.split("\n").filter((line) => line.trim().length > 0).length;
146
+ }
147
+
148
+ /**
149
+ * Measure the on-disk memory corpus for this assistant.
150
+ *
151
+ * Never throws: every probe degrades to zero independently, so a corpus that
152
+ * is partly unreadable still reports the part that is.
153
+ */
154
+ export function measureMemoryCorpusSize(): MemoryCorpusSize {
155
+ const workspaceDir = getWorkspaceDir();
156
+
157
+ let concepts: TreeSize = EMPTY_TREE;
158
+ let pkb: TreeSize = EMPTY_TREE;
159
+ let bufferLines = 0;
160
+
161
+ try {
162
+ concepts = measureMarkdownTree(join(workspaceDir, "memory", "concepts"));
163
+ } catch {
164
+ concepts = EMPTY_TREE;
165
+ }
166
+ try {
167
+ pkb = measureMarkdownTree(join(workspaceDir, "pkb"));
168
+ } catch {
169
+ pkb = EMPTY_TREE;
170
+ }
171
+ try {
172
+ bufferLines = countNonEmptyLines(join(workspaceDir, "memory", "buffer.md"));
173
+ } catch {
174
+ bufferLines = 0;
175
+ }
176
+
177
+ return {
178
+ concept_pages: concepts.files,
179
+ concept_bytes: concepts.bytes,
180
+ pkb_files: pkb.files,
181
+ pkb_bytes: pkb.bytes,
182
+ buffer_lines: bufferLines,
183
+ };
184
+ }
@@ -3,6 +3,7 @@ import { afterEach, beforeEach, describe, expect, mock, test } from "bun:test";
3
3
  import { memoryTier } from "../config/memory-tier.js";
4
4
  import type { AssistantConfig } from "../config/schema.js";
5
5
  import type { ConsentState } from "../platform/consent-cache.js";
6
+ import type { MemoryCorpusSize } from "./memory-corpus-size.js";
6
7
  import type { WatchdogEventRecord } from "./watchdog-events-store.js";
7
8
 
8
9
  // Mutable stubs flipped per test. bun's `mock.module` patches retroactively
@@ -14,6 +15,27 @@ let consent: ConsentState = true;
14
15
  let currentConfig: AssistantConfig = {} as AssistantConfig;
15
16
  let recorded: WatchdogEventRecord[] = [];
16
17
 
18
+ // Stubbed so the assertions below stay exact-match: the real probe walks the
19
+ // live workspace, whose contents differ per machine. `measureMemoryCorpusSize`
20
+ // has its own tests against a temp tree.
21
+ const ZERO_CORPUS: MemoryCorpusSize = {
22
+ concept_pages: 0,
23
+ concept_bytes: 0,
24
+ pkb_files: 0,
25
+ pkb_bytes: 0,
26
+ buffer_lines: 0,
27
+ };
28
+ let corpus: MemoryCorpusSize = ZERO_CORPUS;
29
+ let corpusError: Error | null = null;
30
+
31
+ mock.module("./memory-corpus-size.js", () => ({
32
+ measureMemoryCorpusSize: () => {
33
+ if (corpusError) {
34
+ throw corpusError;
35
+ }
36
+ return corpus;
37
+ },
38
+ }));
17
39
  mock.module("../platform/consent-cache.js", () => ({
18
40
  getRawShareAnalytics: () => consent,
19
41
  }));
@@ -51,6 +73,8 @@ describe("memory-tier-reporter", () => {
51
73
  consent = true;
52
74
  currentConfig = {} as AssistantConfig;
53
75
  recorded = [];
76
+ corpus = ZERO_CORPUS;
77
+ corpusError = null;
54
78
  // Clear any interval/boot-retry timer a prior test's start left behind.
55
79
  stopMemoryTierReporter();
56
80
  });
@@ -69,7 +93,7 @@ describe("memory-tier-reporter", () => {
69
93
  expect(recorded).toHaveLength(1);
70
94
  expect(recorded[0]).toEqual({
71
95
  checkName: "memory_tier",
72
- detail: { tier: memoryTier(config) },
96
+ detail: { tier: memoryTier(config), ...ZERO_CORPUS },
73
97
  });
74
98
  expect(recorded[0]?.detail?.tier).toBe("v2");
75
99
  });
@@ -78,6 +102,33 @@ describe("memory-tier-reporter", () => {
78
102
  currentConfig = makeConfig(true, true, true); // v3 live wins over v2
79
103
  recordMemoryTierOnce();
80
104
 
105
+ expect(recorded[0]?.detail).toEqual({ tier: "v3", ...ZERO_CORPUS });
106
+ });
107
+
108
+ test("carries the measured corpus size alongside the tier", () => {
109
+ currentConfig = makeConfig(true, true, true);
110
+ corpus = {
111
+ concept_pages: 42,
112
+ concept_bytes: 133_700,
113
+ pkb_files: 3,
114
+ pkb_bytes: 900,
115
+ buffer_lines: 7,
116
+ };
117
+
118
+ recordMemoryTierOnce();
119
+
120
+ expect(recorded[0]?.detail).toEqual({ tier: "v3", ...corpus });
121
+ });
122
+
123
+ test("a failed corpus probe still emits the tier heartbeat", () => {
124
+ // The fleet-mix dashboards read `detail.tier`; a sizing failure must
125
+ // degrade the payload, never drop the event and gap the series.
126
+ currentConfig = makeConfig(true, true, true);
127
+ corpusError = new Error("workspace unreadable");
128
+
129
+ recordMemoryTierOnce();
130
+
131
+ expect(recorded).toHaveLength(1);
81
132
  expect(recorded[0]?.detail).toEqual({ tier: "v3" });
82
133
  });
83
134
 
@@ -91,7 +142,7 @@ describe("memory-tier-reporter", () => {
91
142
  for (const event of recorded) {
92
143
  expect(event).toEqual({
93
144
  checkName: "memory_tier",
94
- detail: { tier: "v1" },
145
+ detail: { tier: "v1", ...ZERO_CORPUS },
95
146
  });
96
147
  }
97
148
  });
@@ -117,6 +168,20 @@ describe("memory-tier-reporter", () => {
117
168
  expect(recorded).toHaveLength(1);
118
169
  });
119
170
 
171
+ test("a confirmed opt-out skips the corpus probe entirely", () => {
172
+ // The event is dropped one layer down, so walking the workspace for it
173
+ // would be pure cost on an assistant that asked us not to collect. The
174
+ // throwing stub asserts the probe is never reached.
175
+ consent = false;
176
+ currentConfig = makeConfig(true, true);
177
+ corpusError = new Error("probe must not run");
178
+
179
+ recordMemoryTierOnce();
180
+
181
+ expect(recorded).toHaveLength(1);
182
+ expect(recorded[0]?.detail).toEqual({ tier: "v2" });
183
+ });
184
+
120
185
  test("startMemoryTierReporter is a no-op under VELLUM_DEV=1", () => {
121
186
  process.env.VELLUM_DEV = "1";
122
187
  consent = true; // consent known → a non-dev start would emit immediately
@@ -2,6 +2,7 @@ import { getConfigReadOnly } from "../config/loader.js";
2
2
  import { memoryTier } from "../config/memory-tier.js";
3
3
  import { getRawShareAnalytics } from "../platform/consent-cache.js";
4
4
  import { getLogger } from "../util/logger.js";
5
+ import { measureMemoryCorpusSize } from "./memory-corpus-size.js";
5
6
  import { recordWatchdogEvent } from "./watchdog-events-store.js";
6
7
 
7
8
  const log = getLogger("memory-tier-reporter");
@@ -17,7 +18,14 @@ const log = getLogger("memory-tier-reporter");
17
18
  */
18
19
  const MEMORY_TIER_INTERVAL_MS = 6 * 60 * 60 * 1000;
19
20
 
20
- /** Watchdog `check_name` carrying the coarse memory tier in `detail.tier`. */
21
+ /**
22
+ * Watchdog `check_name` carrying the coarse memory tier in `detail.tier`,
23
+ * alongside the on-disk corpus size (see {@link measureMemoryCorpusSize}).
24
+ *
25
+ * The check name and the `detail.tier` bucket strings are frozen — platform
26
+ * dashboards group on them. The rest of `detail` is an open bag, so the
27
+ * corpus-size keys are additive and need no wire, serializer, or dbt change.
28
+ */
21
29
  const MEMORY_TIER_CHECK_NAME = "memory_tier";
22
30
 
23
31
  // The boot-time emit races the first consent refresh (fire-and-forget in the
@@ -38,18 +46,37 @@ const BOOT_RETRY_INTERVAL_MS = 60_000;
38
46
  * no-ops on a `false` share_analytics, so the call still goes through and the
39
47
  * record layer drops it. Never throws: a storage failure is logged and
40
48
  * retried on the next cycle.
49
+ *
50
+ * The event also carries the on-disk corpus size. That probe is best-effort
51
+ * and isolated: if it fails the event still goes out with the tier alone,
52
+ * because the tier heartbeat is what the fleet-mix dashboards depend on and a
53
+ * sizing failure must not create a gap in that series. It is also skipped
54
+ * outright on a confirmed opt-out — the event is dropped one layer down, so
55
+ * walking the workspace for it would be pure cost on the assistants that
56
+ * asked us not to collect.
41
57
  */
42
58
  export function recordMemoryTierOnce(): void {
43
- if (getRawShareAnalytics() === "unknown") {
59
+ const consent = getRawShareAnalytics();
60
+ if (consent === "unknown") {
44
61
  return;
45
62
  }
46
63
  try {
47
64
  // `getConfigReadOnly()` re-reads config.json on change (capturing live
48
65
  // edits) and never writes to disk — safe for the monitor process.
49
66
  const tier = memoryTier(getConfigReadOnly());
67
+
68
+ let corpus: Record<string, number> = {};
69
+ if (consent !== false) {
70
+ try {
71
+ corpus = { ...measureMemoryCorpusSize() };
72
+ } catch (err) {
73
+ log.warn({ err }, "memory corpus sizing failed (emitting tier only)");
74
+ }
75
+ }
76
+
50
77
  recordWatchdogEvent({
51
78
  checkName: MEMORY_TIER_CHECK_NAME,
52
- detail: { tier },
79
+ detail: { tier, ...corpus },
53
80
  });
54
81
  } catch (err) {
55
82
  log.warn({ err }, "memory_tier watchdog emit failed (non-fatal)");
@@ -0,0 +1,103 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { describe, test } from "bun:test";
4
+
5
+ import type { z } from "zod";
6
+
7
+ import {
8
+ commentListInputSchema,
9
+ commentReplyInputSchema,
10
+ commentResolveInputSchema,
11
+ } from "../document/document-comment-tool.js";
12
+ import {
13
+ documentCreateInputSchema,
14
+ documentDeleteInputSchema,
15
+ documentFindInputSchema,
16
+ documentListInputSchema,
17
+ documentOpenInputSchema,
18
+ documentReadInputSchema,
19
+ documentReplaceTextInputSchema,
20
+ documentUpdateInputSchema,
21
+ } from "../document/document-tool.js";
22
+ import { toToolInputSchema } from "../shared/zod-tool-schema.js";
23
+ import { expectNoSchemaDrift } from "./tool-schema-drift-harness.js";
24
+
25
+ /**
26
+ * Drift guard between the document-editor skill's hand-written `TOOLS.json`
27
+ * `input_schema`s (the advertised contract) and the executors' runtime Zod
28
+ * schemas. See `tool-schema-drift-harness.ts` for what is (and deliberately
29
+ * is not) compared.
30
+ */
31
+
32
+ const TOOLS_JSON = JSON.parse(
33
+ readFileSync(
34
+ join(
35
+ import.meta.dir,
36
+ "../../config/bundled-skills/document-editor/TOOLS.json",
37
+ ),
38
+ "utf8",
39
+ ),
40
+ ) as Parameters<typeof expectNoSchemaDrift>[1];
41
+
42
+ const CASES: {
43
+ name: string;
44
+ schema: z.ZodType;
45
+ advertiseRequired?: string[];
46
+ passthrough?: Record<string, string>;
47
+ }[] = [
48
+ {
49
+ name: "document_open",
50
+ schema: documentOpenInputSchema,
51
+ advertiseRequired: ["surface_id"],
52
+ },
53
+ { name: "document_create", schema: documentCreateInputSchema },
54
+ {
55
+ name: "document_update",
56
+ schema: documentUpdateInputSchema,
57
+ advertiseRequired: ["content"],
58
+ passthrough: {
59
+ mode: "bespoke check owns the error message and the { mode: null } tolerance that mirrors validateInputAgainstSchema",
60
+ },
61
+ },
62
+ {
63
+ name: "document_read",
64
+ schema: documentReadInputSchema,
65
+ advertiseRequired: ["surface_id"],
66
+ },
67
+ { name: "document_list", schema: documentListInputSchema },
68
+ {
69
+ name: "document_delete",
70
+ schema: documentDeleteInputSchema,
71
+ advertiseRequired: ["surface_id"],
72
+ },
73
+ {
74
+ name: "document_find",
75
+ schema: documentFindInputSchema,
76
+ advertiseRequired: ["surface_id"],
77
+ },
78
+ {
79
+ name: "document_replace_text",
80
+ schema: documentReplaceTextInputSchema,
81
+ advertiseRequired: ["surface_id", "replace"],
82
+ },
83
+ { name: "comment_list", schema: commentListInputSchema },
84
+ { name: "comment_resolve", schema: commentResolveInputSchema },
85
+ { name: "comment_reply", schema: commentReplyInputSchema },
86
+ ];
87
+
88
+ describe("document-editor TOOLS.json ↔ runtime Zod schema drift guard", () => {
89
+ for (const c of CASES) {
90
+ test(c.name, () => {
91
+ expectNoSchemaDrift(
92
+ {
93
+ name: c.name,
94
+ derived: toToolInputSchema(c.schema, {
95
+ advertiseRequired: c.advertiseRequired,
96
+ }),
97
+ passthrough: c.passthrough,
98
+ },
99
+ TOOLS_JSON,
100
+ );
101
+ });
102
+ }
103
+ });
@@ -0,0 +1,125 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { describe, test } from "bun:test";
4
+
5
+ import type { z } from "zod";
6
+
7
+ import { acpAbortInputSchema } from "../acp/abort.js";
8
+ import { acpSpawnInputSchema } from "../acp/spawn.js";
9
+ import { acpStatusInputSchema } from "../acp/status.js";
10
+ import { acpSteerInputSchema } from "../acp/steer.js";
11
+ import { callEndInputSchema } from "../calls/call-end.js";
12
+ import { callStartInputSchema } from "../calls/call-start.js";
13
+ import { callStatusInputSchema } from "../calls/call-status.js";
14
+ import { followupCreateInputSchema } from "../followups/followup_create.js";
15
+ import { followupListInputSchema } from "../followups/followup_list.js";
16
+ import { followupResolveInputSchema } from "../followups/followup_resolve.js";
17
+ import { toToolInputSchema } from "../shared/zod-tool-schema.js";
18
+ import { expectNoSchemaDrift } from "./tool-schema-drift-harness.js";
19
+
20
+ /**
21
+ * Drift guard between the followups / phone-calls / acp skills' hand-written
22
+ * `TOOLS.json` `input_schema`s (the advertised contract) and the executors'
23
+ * runtime Zod schemas. See `tool-schema-drift-harness.ts` for what is (and
24
+ * deliberately is not) compared. `acp_list_agents` takes no input and has no
25
+ * runtime schema, so it has no entry here.
26
+ */
27
+
28
+ function loadToolsJson(
29
+ skill: string,
30
+ ): Parameters<typeof expectNoSchemaDrift>[1] {
31
+ return JSON.parse(
32
+ readFileSync(
33
+ join(import.meta.dir, `../../config/bundled-skills/${skill}/TOOLS.json`),
34
+ "utf8",
35
+ ),
36
+ ) as Parameters<typeof expectNoSchemaDrift>[1];
37
+ }
38
+
39
+ const CASES: {
40
+ skill: string;
41
+ name: string;
42
+ schema: z.ZodType;
43
+ advertiseRequired?: string[];
44
+ passthrough?: Record<string, string>;
45
+ }[] = [
46
+ {
47
+ skill: "followups",
48
+ name: "followup_create",
49
+ schema: followupCreateInputSchema,
50
+ advertiseRequired: ["channel", "conversation_id"],
51
+ passthrough: {
52
+ expected_response_hours:
53
+ "bespoke positive-number check owns the error message for every malformed shape (per LUM-2856)",
54
+ },
55
+ },
56
+ {
57
+ skill: "followups",
58
+ name: "followup_list",
59
+ schema: followupListInputSchema,
60
+ passthrough: {
61
+ status:
62
+ "bespoke VALID_STATUSES check owns the 'Invalid status' error (test-asserted)",
63
+ },
64
+ },
65
+ {
66
+ skill: "followups",
67
+ name: "followup_resolve",
68
+ schema: followupResolveInputSchema,
69
+ },
70
+ {
71
+ skill: "phone-calls",
72
+ name: "call_start",
73
+ schema: callStartInputSchema,
74
+ passthrough: {
75
+ skip_disclosure: "deliberate `=== true` coercion owns malformed values",
76
+ },
77
+ },
78
+ {
79
+ skill: "phone-calls",
80
+ name: "call_status",
81
+ schema: callStatusInputSchema,
82
+ },
83
+ {
84
+ skill: "phone-calls",
85
+ name: "call_end",
86
+ schema: callEndInputSchema,
87
+ advertiseRequired: ["call_session_id"],
88
+ },
89
+ {
90
+ skill: "acp",
91
+ name: "acp_spawn",
92
+ schema: acpSpawnInputSchema,
93
+ advertiseRequired: ["task"],
94
+ },
95
+ { skill: "acp", name: "acp_status", schema: acpStatusInputSchema },
96
+ {
97
+ skill: "acp",
98
+ name: "acp_abort",
99
+ schema: acpAbortInputSchema,
100
+ advertiseRequired: ["acp_session_id"],
101
+ },
102
+ {
103
+ skill: "acp",
104
+ name: "acp_steer",
105
+ schema: acpSteerInputSchema,
106
+ advertiseRequired: ["acp_session_id", "instruction"],
107
+ },
108
+ ];
109
+
110
+ describe("followups + phone-calls + acp TOOLS.json ↔ runtime Zod schema drift guard", () => {
111
+ for (const c of CASES) {
112
+ test(`${c.skill}:${c.name}`, () => {
113
+ expectNoSchemaDrift(
114
+ {
115
+ name: c.name,
116
+ derived: toToolInputSchema(c.schema, {
117
+ advertiseRequired: c.advertiseRequired,
118
+ }),
119
+ passthrough: c.passthrough,
120
+ },
121
+ loadToolsJson(c.skill),
122
+ );
123
+ });
124
+ }
125
+ });
@@ -0,0 +1,83 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { describe, test } from "bun:test";
4
+
5
+ import type { z } from "zod";
6
+
7
+ import { scheduleCreateInputSchema } from "../schedule/create.js";
8
+ import { scheduleDeleteInputSchema } from "../schedule/delete.js";
9
+ import { scheduleListInputSchema } from "../schedule/list.js";
10
+ import { scheduleUpdateInputSchema } from "../schedule/update.js";
11
+ import { toToolInputSchema } from "../shared/zod-tool-schema.js";
12
+ import { expectNoSchemaDrift } from "./tool-schema-drift-harness.js";
13
+
14
+ /**
15
+ * Drift guard between the schedule skill's hand-written `TOOLS.json`
16
+ * `input_schema`s (the advertised contract) and the executors' runtime Zod
17
+ * schemas. See `tool-schema-drift-harness.ts` for what is (and deliberately
18
+ * is not) compared.
19
+ */
20
+
21
+ const TOOLS_JSON = JSON.parse(
22
+ readFileSync(
23
+ join(import.meta.dir, "../../config/bundled-skills/schedule/TOOLS.json"),
24
+ "utf8",
25
+ ),
26
+ ) as Parameters<typeof expectNoSchemaDrift>[1];
27
+
28
+ const CASES: {
29
+ name: string;
30
+ schema: z.ZodType;
31
+ advertiseRequired?: string[];
32
+ passthrough?: Record<string, string>;
33
+ nullableAtRuntime?: string[];
34
+ }[] = [
35
+ {
36
+ name: "schedule_create",
37
+ schema: scheduleCreateInputSchema,
38
+ advertiseRequired: ["name", "description"],
39
+ passthrough: {
40
+ mode: "bespoke VALID_MODES check owns the error semantics",
41
+ routing_intent: "bespoke VALID_ROUTING_INTENTS check owns the error",
42
+ capabilities:
43
+ "CapabilityManifestSchema is the single validation authority; must reach the executor (and the requireFreshApproval promotion) unaltered",
44
+ workflow_args: "workflow runtime accepts any JSON value as args",
45
+ },
46
+ },
47
+ {
48
+ name: "schedule_update",
49
+ schema: scheduleUpdateInputSchema,
50
+ advertiseRequired: ["job_id"],
51
+ passthrough: {
52
+ mode: "bespoke VALID_MODES check owns the error semantics",
53
+ routing_intent: "bespoke VALID_ROUTING_INTENTS check owns the error",
54
+ workflow_name: "typeof-guarded null fallback (non-string clears)",
55
+ workflow_args: "workflow runtime accepts any JSON value as args",
56
+ },
57
+ nullableAtRuntime: ["timezone", "script", "routing_hints"],
58
+ },
59
+ { name: "schedule_list", schema: scheduleListInputSchema },
60
+ {
61
+ name: "schedule_delete",
62
+ schema: scheduleDeleteInputSchema,
63
+ advertiseRequired: ["job_id"],
64
+ },
65
+ ];
66
+
67
+ describe("schedule TOOLS.json ↔ runtime Zod schema drift guard", () => {
68
+ for (const c of CASES) {
69
+ test(c.name, () => {
70
+ expectNoSchemaDrift(
71
+ {
72
+ name: c.name,
73
+ derived: toToolInputSchema(c.schema, {
74
+ advertiseRequired: c.advertiseRequired,
75
+ }),
76
+ passthrough: c.passthrough,
77
+ nullableAtRuntime: c.nullableAtRuntime,
78
+ },
79
+ TOOLS_JSON,
80
+ );
81
+ });
82
+ }
83
+ });