@vellumai/assistant 0.10.12 → 0.11.0-staging.2

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 (809) 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 +264 -14
  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__/app-conversation-ids-backfill.test.ts +33 -2
  39. package/src/__tests__/app-conversation-ids.test.ts +204 -0
  40. package/src/__tests__/approval-cascade.test.ts +5 -5
  41. package/src/__tests__/approval-routes-http.test.ts +3 -3
  42. package/src/__tests__/ask-question-resolver.test.ts +207 -0
  43. package/src/__tests__/assistant-event-hub-self-exclusion.test.ts +16 -16
  44. package/src/__tests__/assistant-event-hub-targeted.test.ts +13 -11
  45. package/src/__tests__/assistant-event-hub.test.ts +13 -11
  46. package/src/__tests__/assistant-event.test.ts +12 -9
  47. package/src/__tests__/assistant-feature-flag-guard.test.ts +3 -3
  48. package/src/__tests__/assistant-feature-flag-guardrails.test.ts +1 -1
  49. package/src/__tests__/assistant-id-boundary-guard.test.ts +0 -58
  50. package/src/__tests__/assistant-stream-state.test.ts +17 -7
  51. package/src/__tests__/avatar-identity-sync.test.ts +3 -3
  52. package/src/__tests__/background-workers-disk-pressure.test.ts +1 -0
  53. package/src/__tests__/call-conversation-messages.test.ts +134 -18
  54. package/src/__tests__/call-start-guardian-guard.test.ts +27 -0
  55. package/src/__tests__/channel-approvals.test.ts +0 -27
  56. package/src/__tests__/channel-guardian.test.ts +85 -512
  57. package/src/__tests__/channel-readiness-slack-remote.test.ts +151 -3
  58. package/src/__tests__/channel-retry-sweep.test.ts +88 -1
  59. package/src/__tests__/channel-setup-panel-ack.test.ts +12 -9
  60. package/src/__tests__/chat-reveal-guard-priming.test.ts +31 -34
  61. package/src/__tests__/cli-memory-v2-reembed-skills.test.ts +2 -2
  62. package/src/__tests__/compaction-events.test.ts +8 -8
  63. package/src/__tests__/config-loader-platform-defaults.test.ts +54 -28
  64. package/src/__tests__/config-model-image-provider.test.ts +20 -0
  65. package/src/__tests__/config-schema-memory-substrate.test.ts +306 -0
  66. package/src/__tests__/config-schema.test.ts +14 -2
  67. package/src/__tests__/config-set-platform-guard.test.ts +11 -12
  68. package/src/__tests__/config-sounds-sync.test.ts +4 -4
  69. package/src/__tests__/confirmation-request-guardian-bridge.test.ts +5 -0
  70. package/src/__tests__/context-search-memory-source.test.ts +1 -1
  71. package/src/__tests__/context-search-memory-v2-source.test.ts +6 -6
  72. package/src/__tests__/context-token-estimator.test.ts +54 -1
  73. package/src/__tests__/conversation-agent-loop-disk-pressure.test.ts +12 -3
  74. package/src/__tests__/conversation-agent-loop-fatal-cleanup.test.ts +13 -4
  75. package/src/__tests__/conversation-agent-loop-handlers-max-tokens.test.ts +4 -4
  76. package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +10 -1
  77. package/src/__tests__/conversation-agent-loop-overflow.test.ts +22 -13
  78. package/src/__tests__/conversation-agent-loop.test.ts +39 -30
  79. package/src/__tests__/conversation-confirmation-signals.test.ts +14 -14
  80. package/src/__tests__/conversation-evictor.test.ts +49 -0
  81. package/src/__tests__/conversation-fork-crud.test.ts +1 -1
  82. package/src/__tests__/conversation-group-tools.test.ts +279 -0
  83. package/src/__tests__/conversation-history-web-search.test.ts +1 -1
  84. package/src/__tests__/conversation-key-store-disk-view.test.ts +5 -5
  85. package/src/__tests__/conversation-lineage.test.ts +235 -0
  86. package/src/__tests__/conversation-loop-db-lock-resilience.test.ts +5 -5
  87. package/src/__tests__/conversation-message-sync-tags.test.ts +4 -4
  88. package/src/__tests__/conversation-queue.test.ts +81 -81
  89. package/src/__tests__/conversation-routes-enabled-plugins.test.ts +8 -1
  90. package/src/__tests__/conversation-routes-hidden-queue.test.ts +8 -1
  91. package/src/__tests__/conversation-routes-slash-commands.test.ts +10 -1
  92. package/src/__tests__/conversation-runtime-assembly.test.ts +29 -2
  93. package/src/__tests__/conversation-slash-queue.test.ts +11 -11
  94. package/src/__tests__/conversation-slash-unknown.test.ts +2 -2
  95. package/src/__tests__/conversation-speed-override.test.ts +2 -2
  96. package/src/__tests__/conversation-summarize-route.test.ts +9 -0
  97. package/src/__tests__/conversation-surfaces-action-delivery.test.ts +18 -16
  98. package/src/__tests__/conversation-surfaces-activation-emit.test.ts +17 -17
  99. package/src/__tests__/conversation-surfaces-app-open.test.ts +7 -4
  100. package/src/__tests__/conversation-surfaces-data-persist.test.ts +7 -7
  101. package/src/__tests__/conversation-surfaces-standalone-payloads.test.ts +9 -9
  102. package/src/__tests__/conversation-surfaces-standalone.test.ts +12 -12
  103. package/src/__tests__/conversation-surfaces-state-update.test.ts +8 -5
  104. package/src/__tests__/conversation-surfaces-table-action.test.ts +6 -3
  105. package/src/__tests__/conversation-surfaces-task-progress.test.ts +46 -46
  106. package/src/__tests__/conversation-sync-tags.test.ts +5 -5
  107. package/src/__tests__/conversation-wait-for-idle.test.ts +2 -2
  108. package/src/__tests__/conversation-workspace-cache-state.test.ts +0 -4
  109. package/src/__tests__/conversation-workspace-injection.test.ts +0 -3
  110. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +0 -3
  111. package/src/__tests__/copy-composer-tc-templates.test.ts +3 -131
  112. package/src/__tests__/credential-security-invariants.test.ts +1 -0
  113. package/src/__tests__/daemon-assistant-events.test.ts +14 -15
  114. package/src/__tests__/db-test-helpers.ts +13 -27
  115. package/src/__tests__/disk-pressure-routes.test.ts +12 -3
  116. package/src/__tests__/document-tool-security.test.ts +95 -0
  117. package/src/__tests__/drain-kick-guard.test.ts +232 -0
  118. package/src/__tests__/dynamic-skill-background-guard.test.ts +19 -6
  119. package/src/__tests__/emit-event-signal.test.ts +5 -6
  120. package/src/__tests__/encrypted-store-test-helpers.ts +10 -20
  121. package/src/__tests__/events-tail-route.test.ts +6 -4
  122. package/src/__tests__/feature-flag-test-helpers.ts +10 -20
  123. package/src/__tests__/file-edit-tool.test.ts +24 -4
  124. package/src/__tests__/file-list-tool.test.ts +2 -1
  125. package/src/__tests__/file-read-tool.test.ts +62 -10
  126. package/src/__tests__/file-write-tool.test.ts +24 -5
  127. package/src/__tests__/followup-tools.test.ts +58 -0
  128. package/src/__tests__/gateway-threshold-reader-mock.ts +99 -0
  129. package/src/__tests__/graph-extraction-event-date.test.ts +1 -1
  130. package/src/__tests__/guardian-question-mode.test.ts +42 -3
  131. package/src/__tests__/guardian-reply-router-answer-mode.test.ts +283 -0
  132. package/src/__tests__/guardian-vellum-destination-pinning.test.ts +221 -0
  133. package/src/__tests__/heartbeat-disk-pressure.test.ts +1 -0
  134. package/src/__tests__/heartbeat-service.test.ts +1 -0
  135. package/src/__tests__/helpers/native-web-search-harness.ts +10 -10
  136. package/src/__tests__/host-browser-proxy.test.ts +1 -1
  137. package/src/__tests__/host-file-edit-tool.test.ts +3 -3
  138. package/src/__tests__/host-file-read-tool.test.ts +2 -2
  139. package/src/__tests__/host-file-write-tool.test.ts +7 -3
  140. package/src/__tests__/host-shell-tool.test.ts +17 -5
  141. package/src/__tests__/host-transfer-pending-interactions.test.ts +8 -8
  142. package/src/__tests__/image-credentials.test.ts +65 -8
  143. package/src/__tests__/injection-block.test.ts +4 -4
  144. package/src/__tests__/injector-chain.test.ts +1 -1
  145. package/src/__tests__/injector-pkb-v2-silenced.test.ts +2 -2
  146. package/src/__tests__/injector-registry-order-guard.test.ts +4 -9
  147. package/src/__tests__/injector-v3-suppression.test.ts +6 -4
  148. package/src/__tests__/lifecycle-memory-v2-seed.test.ts +27 -28
  149. package/src/__tests__/list-messages-page-latest.test.ts +2 -2
  150. package/src/__tests__/llm-usage-store.test.ts +67 -4
  151. package/src/__tests__/log-redact.test.ts +18 -0
  152. package/src/__tests__/managed-profile-guard.test.ts +27 -0
  153. package/src/__tests__/managed-skill-lifecycle.test.ts +2 -2
  154. package/src/__tests__/media-generate-image.test.ts +62 -11
  155. package/src/__tests__/memory-identity-context-parity.test.ts +1 -1
  156. package/src/__tests__/memory-jobs-worker-lanes.test.ts +9 -1
  157. package/src/__tests__/memory-retrieval-hook.test.ts +4 -4
  158. package/src/__tests__/notification-decision-strategy.test.ts +115 -11
  159. package/src/__tests__/notification-deep-link.test.ts +12 -12
  160. package/src/__tests__/notification-vellum-adapter.test.ts +8 -8
  161. package/src/__tests__/outbound-slack-persistence.test.ts +8 -8
  162. package/src/__tests__/path-policy.test.ts +315 -0
  163. package/src/__tests__/pending-interactions-resolved-event.test.ts +6 -6
  164. package/src/__tests__/persistence-layering-guard.test.ts +2 -2
  165. package/src/__tests__/pkb-autoinject.test.ts +1 -1
  166. package/src/__tests__/platform-bash-auto-approve.test.ts +1 -0
  167. package/src/__tests__/platform-callback-registration.test.ts +10 -10
  168. package/src/__tests__/plugin-event-hub-facade.test.ts +22 -15
  169. package/src/__tests__/plugin-import-boundary-guard.test.ts +15 -15
  170. package/src/__tests__/processing-flag-persist-failure.test.ts +0 -4
  171. package/src/__tests__/provider-platform-proxy-integration.test.ts +0 -1
  172. package/src/__tests__/rebuild-index-graph-nodes.test.ts +1 -1
  173. package/src/__tests__/request-secret-standalone-channel-gate.test.ts +5 -5
  174. package/src/__tests__/require-fresh-approval.test.ts +38 -38
  175. package/src/__tests__/resolve-app-id.test.ts +32 -0
  176. package/src/__tests__/run-due-schedules.test.ts +72 -1
  177. package/src/__tests__/runtime-events-sse-parity.test.ts +11 -10
  178. package/src/__tests__/runtime-events-sse.test.ts +1 -1
  179. package/src/__tests__/schedule-routes.test.ts +44 -5
  180. package/src/__tests__/schedule-store.test.ts +3 -3
  181. package/src/__tests__/schedule-tools.test.ts +176 -0
  182. package/src/__tests__/secret-prompt-log-hygiene.test.ts +3 -3
  183. package/src/__tests__/secret-prompter-channel-fallback.test.ts +3 -3
  184. package/src/__tests__/secret-response-routing.test.ts +3 -3
  185. package/src/__tests__/secret-routes-platform-proxy.test.ts +4 -7
  186. package/src/__tests__/secret-scanner.test.ts +36 -0
  187. package/src/__tests__/send-endpoint-busy.test.ts +7 -7
  188. package/src/__tests__/slack-required-scopes-mirror.test.ts +81 -0
  189. package/src/__tests__/starter-task-flow.test.ts +26 -3
  190. package/src/__tests__/subagent-call-site-routing.test.ts +2 -2
  191. package/src/__tests__/subagent-disposal.test.ts +40 -11
  192. package/src/__tests__/subagent-fork-notifications.test.ts +4 -4
  193. package/src/__tests__/subagent-fork-prompt-role.test.ts +3 -3
  194. package/src/__tests__/subagent-fork-spawn.test.ts +4 -4
  195. package/src/__tests__/subagent-manager-notify.test.ts +73 -14
  196. package/src/__tests__/subagent-notify-parent.test.ts +48 -4
  197. package/src/__tests__/subagent-spawn-and-await.test.ts +62 -14
  198. package/src/__tests__/subagent-tools.test.ts +64 -0
  199. package/src/__tests__/sync-message-contract.test.ts +3 -3
  200. package/src/__tests__/terminal-tools.test.ts +12 -3
  201. package/src/__tests__/test-preload.ts +9 -0
  202. package/src/__tests__/tool-approval-handler.test.ts +587 -43
  203. package/src/__tests__/tool-execution-pipeline.benchmark.test.ts +7 -4
  204. package/src/__tests__/tool-executor.test.ts +116 -0
  205. package/src/__tests__/tool-grant-request-escalation.test.ts +5 -0
  206. package/src/__tests__/tool-preview-lifecycle.test.ts +32 -29
  207. package/src/__tests__/tool-result-metadata-plumbing.test.ts +5 -5
  208. package/src/__tests__/tool-side-effects-slack-dm.test.ts +1 -0
  209. package/src/__tests__/tool-start-timestamp.test.ts +4 -4
  210. package/src/__tests__/trusted-contact-lifecycle-notifications.test.ts +9 -22
  211. package/src/__tests__/ui-choice-copy-surfaces.test.ts +13 -13
  212. package/src/__tests__/ui-work-result-surface.test.ts +3 -3
  213. package/src/__tests__/voice-scoped-grant-consumer.test.ts +6 -6
  214. package/src/__tests__/voice-session-bridge.test.ts +44 -44
  215. package/src/__tests__/workspace-migration-134-image-generation-mode-to-provider.test.ts +284 -0
  216. package/src/__tests__/workspace-policy.test.ts +482 -2
  217. package/src/acp/__tests__/client-handler.test.ts +3 -3
  218. package/src/acp/__tests__/session-manager-persistence.test.ts +10 -10
  219. package/src/acp/__tests__/session-manager-resume.test.ts +7 -7
  220. package/src/acp/client-handler.ts +3 -3
  221. package/src/acp/session-manager.ts +8 -8
  222. package/src/api/events/subagent-event.ts +2 -2
  223. package/src/api/responses/memory-v2-activation-log.ts +2 -2
  224. package/src/api/responses/subagent-detail.ts +13 -0
  225. package/src/approvals/AGENTS.md +2 -0
  226. package/src/approvals/guardian-request-resolvers.ts +118 -24
  227. package/src/apps/app-store.ts +95 -4
  228. package/src/calls/__tests__/voice-control-protocol.test.ts +57 -0
  229. package/src/calls/__tests__/voice-session-bridge.test.ts +229 -7
  230. package/src/calls/__tests__/voice-triage-escalate.test.ts +3 -4
  231. package/src/calls/call-controller.ts +27 -27
  232. package/src/calls/call-conversation-messages.ts +58 -18
  233. package/src/calls/voice-control-protocol.ts +56 -0
  234. package/src/calls/voice-session-bridge.ts +178 -65
  235. package/src/calls/voice-triage-escalate.ts +2 -3
  236. package/src/channels/config.ts +8 -0
  237. package/src/channels/types.ts +1 -0
  238. package/src/cli/commands/config.ts +49 -13
  239. package/src/cli/commands/memory/index.help.ts +4 -2
  240. package/src/cli/commands/memory/memory-retrospective.ts +5 -0
  241. package/src/cli/commands/webhooks.help.ts +9 -4
  242. package/src/cli/lib/bundled-marketplace.json +12 -0
  243. package/src/cli.ts +2 -109
  244. package/src/config/__tests__/deployment-context-defaults.test.ts +9 -0
  245. package/src/config/__tests__/substrate-twin-shadowing.test.ts +191 -0
  246. package/src/config/assistant-feature-flags.ts +1 -1
  247. package/src/config/bundled-skills/conversation-groups/SKILL.md +29 -0
  248. package/src/config/bundled-skills/conversation-groups/TOOLS.json +58 -0
  249. package/src/config/bundled-skills/conversation-groups/tools/group-create.ts +12 -0
  250. package/src/config/bundled-skills/conversation-groups/tools/group-list.ts +12 -0
  251. package/src/config/bundled-skills/conversation-groups/tools/move-to-group.ts +12 -0
  252. package/src/config/bundled-skills/image-studio/tools/media-generate-image.ts +13 -7
  253. package/src/config/bundled-skills/schedule/SKILL.md +2 -0
  254. package/src/config/feature-flag-cache.ts +6 -16
  255. package/src/config/feature-flag-registry.json +14 -38
  256. package/src/config/loader.ts +7 -1
  257. package/src/config/memory-tier.ts +15 -10
  258. package/src/config/memory-v3-gate.test.ts +278 -1
  259. package/src/config/memory-v3-gate.ts +88 -26
  260. package/src/config/raw-config-utils.ts +1 -1
  261. package/src/config/schemas/__tests__/live-voice.test.ts +27 -16
  262. package/src/config/schemas/__tests__/memory-v3.test.ts +1 -0
  263. package/src/config/schemas/live-voice.ts +33 -7
  264. package/src/config/schemas/llm.ts +1 -0
  265. package/src/config/schemas/memory-retrospective.ts +13 -0
  266. package/src/config/schemas/memory-substrate.ts +183 -0
  267. package/src/config/schemas/memory-v2.ts +3 -2
  268. package/src/config/schemas/memory-v3.ts +11 -4
  269. package/src/config/schemas/memory.ts +35 -1
  270. package/src/config/schemas/services.ts +10 -2
  271. package/src/config/substrate-twin-shadowing.ts +195 -0
  272. package/src/config/webhook-routing.ts +67 -0
  273. package/src/context/compactor.ts +10 -3
  274. package/src/context/token-estimator.ts +21 -0
  275. package/src/daemon/__tests__/channel-ui-capability.test.ts +85 -0
  276. package/src/daemon/__tests__/conversation-surfaces-launch.test.ts +3 -3
  277. package/src/daemon/__tests__/embedding-reconcile.test.ts +3 -3
  278. package/src/daemon/__tests__/inference-profile-notification.test.ts +3 -6
  279. package/src/daemon/__tests__/native-web-search-metadata.test.ts +5 -5
  280. package/src/daemon/__tests__/web-search-status-text.test.ts +2 -2
  281. package/src/daemon/channel-ui-capability.ts +70 -1
  282. package/src/daemon/conversation-agent-loop-handlers.ts +4 -4
  283. package/src/daemon/conversation-agent-loop.ts +12 -5
  284. package/src/daemon/conversation-evictor.ts +26 -4
  285. package/src/daemon/conversation-launch.ts +11 -14
  286. package/src/daemon/conversation-lineage.ts +76 -0
  287. package/src/daemon/conversation-messaging.ts +14 -14
  288. package/src/daemon/conversation-notifiers.ts +2 -2
  289. package/src/daemon/conversation-process.ts +133 -21
  290. package/src/daemon/conversation-queue-manager.ts +7 -7
  291. package/src/daemon/conversation-runtime-assembly.ts +16 -0
  292. package/src/daemon/conversation-store.ts +11 -3
  293. package/src/daemon/conversation-surfaces.ts +8 -14
  294. package/src/daemon/conversation-tool-setup.ts +13 -7
  295. package/src/daemon/conversation-usage.ts +12 -11
  296. package/src/daemon/conversation.ts +38 -15
  297. package/src/daemon/disk-pressure-guard.ts +5 -12
  298. package/src/daemon/embedding-reconcile.ts +14 -9
  299. package/src/daemon/handlers/config-channels.ts +40 -134
  300. package/src/daemon/handlers/config-model.ts +15 -7
  301. package/src/daemon/handlers/conversations.ts +4 -2
  302. package/src/daemon/handlers/shared.ts +29 -0
  303. package/src/daemon/host-proxy-base.ts +4 -4
  304. package/src/daemon/lifecycle.ts +13 -0
  305. package/src/daemon/message-protocol.ts +8 -144
  306. package/src/daemon/message-types/computer-use.ts +0 -12
  307. package/src/daemon/message-types/conversations.ts +9 -345
  308. package/src/daemon/message-types/host-app-control.ts +0 -9
  309. package/src/daemon/message-types/host-browser.ts +0 -7
  310. package/src/daemon/message-types/host-ui-snapshot.ts +0 -7
  311. package/src/daemon/message-types/messages.ts +0 -48
  312. package/src/daemon/message-types/notifications.ts +0 -7
  313. package/src/daemon/message-types/skills.ts +0 -5
  314. package/src/daemon/message-types/surfaces.ts +0 -9
  315. package/src/daemon/message-types/sync.ts +0 -2
  316. package/src/daemon/process-message.ts +5 -5
  317. package/src/daemon/skill-memory-refresh.ts +5 -5
  318. package/src/daemon/tool-side-effects.ts +32 -16
  319. package/src/daemon/trust-context.ts +1 -1
  320. package/src/daemon/wake-conversation-ops.ts +4 -4
  321. package/src/heartbeat/__tests__/heartbeat-run-store.test.ts +100 -7
  322. package/src/heartbeat/__tests__/heartbeat-service.test.ts +67 -0
  323. package/src/heartbeat/heartbeat-run-store.ts +81 -4
  324. package/src/heartbeat/heartbeat-service.ts +32 -1
  325. package/src/home/__tests__/feed-writer.test.ts +7 -7
  326. package/src/home/__tests__/home-content-refresh.test.ts +3 -0
  327. package/src/home/__tests__/suggested-prompts.test.ts +1 -0
  328. package/src/home/feed-writer.ts +6 -13
  329. package/src/home/home-content-refresh.ts +6 -9
  330. package/src/home/relationship-state-writer.ts +5 -12
  331. package/src/home/suggested-prompts-cache.ts +6 -19
  332. package/src/ipc/__tests__/events-publish-client.test.ts +67 -0
  333. package/src/ipc/events-publish-client.ts +44 -0
  334. package/src/ipc/routes/__tests__/conversation-sync-ipc-routes.test.ts +2 -2
  335. package/src/ipc/routes/__tests__/events-ipc-routes.test.ts +38 -9
  336. package/src/ipc/routes/events-ipc-routes.ts +11 -31
  337. package/src/live-voice/__tests__/front-decision.test.ts +4 -176
  338. package/src/live-voice/__tests__/live-voice-agent-turn.test.ts +276 -68
  339. package/src/live-voice/__tests__/live-voice-continuation-fork-hydration.test.ts +286 -0
  340. package/src/live-voice/__tests__/live-voice-events.test.ts +6 -3
  341. package/src/live-voice/__tests__/live-voice-progress.test.ts +185 -46
  342. package/src/live-voice/__tests__/live-voice-triage-escalate.test.ts +24 -59
  343. package/src/live-voice/__tests__/live-voice-tts-session.test.ts +38 -54
  344. package/src/live-voice/__tests__/live-voice-vad.test.ts +1154 -636
  345. package/src/live-voice/front-decision.ts +5 -155
  346. package/src/live-voice/live-voice-metrics.ts +4 -1
  347. package/src/live-voice/live-voice-session.ts +1288 -439
  348. package/src/live-voice/progress-phrases.ts +17 -0
  349. package/src/live-voice/protocol.ts +15 -0
  350. package/src/media/app-icon-generator.ts +15 -8
  351. package/src/media/avatar-router.ts +9 -5
  352. package/src/media/image-credentials.ts +42 -10
  353. package/src/media/image-service.ts +1 -13
  354. package/src/media/types.ts +26 -3
  355. package/src/notifications/AGENTS.md +2 -0
  356. package/src/notifications/__tests__/broadcaster.test.ts +95 -0
  357. package/src/notifications/adapters/macos.ts +3 -3
  358. package/src/notifications/broadcaster.ts +57 -0
  359. package/src/notifications/copy-composer.ts +0 -15
  360. package/src/notifications/decision-engine.ts +21 -22
  361. package/src/notifications/guardian-question-mode.ts +57 -2
  362. package/src/notifications/home-feed-side-effect.ts +4 -0
  363. package/src/notifications/signal.ts +6 -4
  364. package/src/notifications/trusted-contact-payloads.ts +3 -4
  365. package/src/notifications/vellum-card-affinity.ts +39 -0
  366. package/src/oauth/AGENTS.md +1 -1
  367. package/src/permissions/channel-permission-query.test.ts +69 -0
  368. package/src/permissions/channel-permission-query.ts +73 -1
  369. package/src/permissions/checker.test.ts +298 -15
  370. package/src/permissions/checker.ts +102 -36
  371. package/src/permissions/confirmation-guardian-request.test.ts +2 -2
  372. package/src/permissions/confirmation-guardian-request.ts +2 -2
  373. package/src/permissions/gateway-threshold-reader.test.ts +224 -17
  374. package/src/permissions/gateway-threshold-reader.ts +82 -10
  375. package/src/permissions/ipc-risk-types.ts +8 -0
  376. package/src/permissions/prompter.ts +5 -5
  377. package/src/permissions/question-guardian-request.test.ts +222 -0
  378. package/src/permissions/question-guardian-request.ts +179 -0
  379. package/src/permissions/question-prompter.test.ts +8 -8
  380. package/src/permissions/question-prompter.ts +18 -0
  381. package/src/permissions/secret-prompter.ts +2 -4
  382. package/src/permissions/workspace-policy.ts +269 -34
  383. package/src/persistence/__tests__/lifecycle-quiesce.test.ts +82 -0
  384. package/src/persistence/__tests__/message-content-file.test.ts +58 -3
  385. package/src/persistence/conversation-crud.ts +93 -0
  386. package/src/persistence/conversation-key-store.ts +63 -0
  387. package/src/persistence/conversation-parent.ts +27 -0
  388. package/src/persistence/db-async-query.ts +1 -1
  389. package/src/persistence/db-singleton.ts +14 -27
  390. package/src/persistence/delivery-crud.ts +45 -0
  391. package/src/persistence/embeddings/embedding-backend.ts +2 -1
  392. package/src/persistence/embeddings/embedding-identity.ts +7 -3
  393. package/src/persistence/job-utils.ts +32 -27
  394. package/src/persistence/jobs-store.ts +92 -3
  395. package/src/persistence/lifecycle-quiesce.ts +80 -0
  396. package/src/persistence/llm-usage-store.ts +45 -8
  397. package/src/persistence/message-content-file.ts +4 -4
  398. package/src/persistence/migrations/336-move-memory-v2-activation-logs-to-memory-db.ts +1 -1
  399. package/src/persistence/migrations/351-schedule-skill-script-handoff.ts +39 -0
  400. package/src/persistence/migrations/352-drop-schedule-skill-script-handoff.test.ts +83 -0
  401. package/src/persistence/migrations/352-drop-schedule-skill-script-handoff.ts +36 -0
  402. package/src/persistence/migrations/353-add-llm-usage-conversation-type.test.ts +110 -0
  403. package/src/persistence/migrations/353-add-llm-usage-conversation-type.ts +49 -0
  404. package/src/persistence/migrations/354-backfill-app-conversation-lineage.ts +41 -0
  405. package/src/persistence/schema/infrastructure.ts +11 -0
  406. package/src/persistence/steps.ts +9 -1
  407. package/src/plugin-api/__tests__/publish-event-forwarding.test.ts +113 -0
  408. package/src/plugin-api/__tests__/publish-event.test.ts +57 -0
  409. package/src/plugin-api/conversation-turn.ts +4 -4
  410. package/src/plugin-api/event-hub-facade.ts +15 -6
  411. package/src/plugin-api/index.ts +10 -4
  412. package/src/plugin-api/publish-event.ts +36 -0
  413. package/src/plugins/AGENTS.md +2 -0
  414. package/src/plugins/defaults/compaction/window-manager.ts +9 -0
  415. package/src/plugins/defaults/index.ts +9 -13
  416. package/src/plugins/defaults/memory/AGENTS.md +775 -0
  417. package/src/plugins/defaults/memory/__tests__/capability-seed-embed-gate.test.ts +186 -0
  418. package/src/plugins/defaults/memory/__tests__/fixtures/memory-v2-activation-fixtures.ts +1 -1
  419. package/src/plugins/defaults/memory/__tests__/indexer-tier-dispatch.test.ts +129 -0
  420. package/src/plugins/defaults/memory/__tests__/jobs-worker-quiesce-gate.test.ts +91 -0
  421. package/src/plugins/defaults/memory/__tests__/jobs-worker-v1-graph-substrate-noop.test.ts +342 -0
  422. package/src/plugins/defaults/memory/__tests__/jobs-worker-v2-graph-trigger-embed.test.ts +9 -1
  423. package/src/plugins/defaults/memory/__tests__/jobs-worker-v2-schedule.test.ts +36 -1
  424. package/src/plugins/defaults/memory/__tests__/jobs-worker-v2-sweep-defer.test.ts +9 -1
  425. package/src/plugins/defaults/memory/__tests__/memory-log-stores-degraded.test.ts +2 -2
  426. package/src/plugins/defaults/memory/__tests__/memory-retrospective-job.test.ts +44 -10
  427. package/src/plugins/defaults/memory/__tests__/memory-retrospective-sweep.test.ts +151 -10
  428. package/src/plugins/defaults/memory/__tests__/memory-tier-boundary-guard.test.ts +1155 -0
  429. package/src/plugins/defaults/memory/__tests__/memory-v2-activation-log-store.test.ts +1 -1
  430. package/src/plugins/defaults/memory/__tests__/memory-v2-concept-frequency.test.ts +3 -3
  431. package/src/plugins/defaults/memory/__tests__/tools-delete-memory-page.test.ts +1 -1
  432. package/src/plugins/defaults/memory/context-search/sources/memory-v2.ts +71 -35
  433. package/src/plugins/defaults/memory/context-search/sources/memory.ts +5 -1
  434. package/src/plugins/defaults/memory/fork-conversation-memory.ts +4 -4
  435. package/src/plugins/defaults/memory/graph/__tests__/conversation-graph-memory-v2-routing.test.ts +80 -10
  436. package/src/plugins/defaults/memory/graph/__tests__/handle-remember-v2.test.ts +1 -1
  437. package/src/plugins/defaults/memory/graph/capability-seed.ts +24 -10
  438. package/src/plugins/defaults/memory/graph/conversation-graph-memory.ts +123 -49
  439. package/src/plugins/defaults/memory/graph/graph-search.ts +6 -118
  440. package/src/plugins/defaults/memory/graph/in-context-tracker.test.ts +173 -0
  441. package/src/plugins/defaults/memory/graph/in-context-tracker.ts +109 -0
  442. package/src/plugins/defaults/memory/graph/store.ts +1 -0
  443. package/src/plugins/defaults/memory/graph/tool-handlers.test.ts +1 -1
  444. package/src/plugins/defaults/memory/graph/tool-handlers.ts +5 -2
  445. package/src/plugins/defaults/memory/graph-topology/__tests__/build-memory-graph.test.ts +1 -1
  446. package/src/plugins/defaults/memory/graph-topology/build-memory-graph.ts +6 -9
  447. package/src/plugins/defaults/memory/hooks/__tests__/user-prompt-submit.test.ts +30 -16
  448. package/src/plugins/defaults/memory/hooks/user-prompt-submit.ts +18 -14
  449. package/src/plugins/defaults/memory/indexer.ts +146 -89
  450. package/src/plugins/defaults/memory/injectors.ts +86 -41
  451. package/src/plugins/defaults/memory/job-handlers.ts +130 -39
  452. package/src/plugins/defaults/memory/jobs/__tests__/embed-concept-page.test.ts +2 -2
  453. package/src/plugins/defaults/memory/jobs/embed-concept-page.ts +22 -10
  454. package/src/plugins/defaults/memory/jobs-worker.ts +279 -208
  455. package/src/plugins/defaults/memory/memory-retrospective-enqueue.ts +4 -2
  456. package/src/plugins/defaults/memory/memory-retrospective-job.ts +40 -3
  457. package/src/plugins/defaults/memory/memory-retrospective-sweep.ts +99 -11
  458. package/src/plugins/defaults/memory/src/__tests__/memory-v2-routes.test.ts +5 -3
  459. package/src/plugins/defaults/memory/src/__tests__/memory-v2-simulate-route.test.ts +3 -4
  460. package/src/plugins/defaults/memory/src/memory-graph-routes.ts +2 -1
  461. package/src/plugins/defaults/memory/src/memory-item-routes.test.ts +7 -5
  462. package/src/plugins/defaults/memory/src/memory-item-routes.ts +51 -19
  463. package/src/plugins/defaults/memory/src/memory-v2-routes.ts +31 -20
  464. package/src/plugins/defaults/memory/startup.ts +58 -21
  465. package/src/plugins/defaults/memory/substrate/__tests__/boot-maintenance.test.ts +335 -0
  466. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/cli-command-store.test.ts +14 -8
  467. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/consolidation-job.test.ts +51 -21
  468. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/edge-index.test.ts +1 -1
  469. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/frontmatter-sweep.test.ts +3 -3
  470. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/page-index.test.ts +1 -1
  471. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/page-store.test.ts +1 -1
  472. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/prompts-consolidation.test.ts +2 -2
  473. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/qdrant.test.ts +23 -14
  474. package/src/plugins/defaults/memory/substrate/__tests__/reembed-job.test.ts +262 -0
  475. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/sim.test.ts +9 -12
  476. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/skill-content.test.ts +2 -2
  477. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/skill-store.test.ts +9 -9
  478. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/sparse-bm25.test.ts +12 -5
  479. package/src/plugins/defaults/memory/substrate/__tests__/spread.test.ts +276 -0
  480. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/static-context.test.ts +17 -8
  481. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/sweep-job.test.ts +9 -9
  482. package/src/plugins/defaults/memory/{v3/substrate/memory-v2-startup.ts → substrate/boot-maintenance.ts} +43 -24
  483. package/src/plugins/defaults/memory/{v3/substrate → substrate}/cli-command-store.ts +13 -8
  484. package/src/plugins/defaults/memory/{v3/substrate → substrate}/consolidation-job.ts +51 -27
  485. package/src/plugins/defaults/memory/{v3/substrate → substrate}/constants.ts +1 -0
  486. package/src/plugins/defaults/memory/{v3/substrate → substrate}/edge-index.ts +28 -9
  487. package/src/plugins/defaults/memory/{v3/substrate → substrate}/frontmatter-sweep.ts +14 -7
  488. package/src/plugins/defaults/memory/{v3/substrate → substrate}/injected-block-slugs.ts +9 -3
  489. package/src/plugins/defaults/memory/{v3/substrate → substrate}/page-index.ts +29 -10
  490. package/src/plugins/defaults/memory/{v3/substrate → substrate}/page-store.ts +35 -12
  491. package/src/plugins/defaults/memory/{v3/substrate → substrate}/prompts/consolidation.ts +14 -8
  492. package/src/plugins/defaults/memory/{v3/substrate → substrate}/prompts/sweep.ts +4 -1
  493. package/src/plugins/defaults/memory/{v3/substrate → substrate}/qdrant.ts +96 -36
  494. package/src/plugins/defaults/memory/substrate/reembed-job.ts +54 -0
  495. package/src/plugins/defaults/memory/{v3/substrate → substrate}/sim.ts +26 -15
  496. package/src/plugins/defaults/memory/{v3/substrate → substrate}/skill-content.ts +1 -1
  497. package/src/plugins/defaults/memory/{v3/substrate → substrate}/skill-store.ts +13 -8
  498. package/src/plugins/defaults/memory/{v3/substrate → substrate}/sparse-bm25.ts +27 -10
  499. package/src/plugins/defaults/memory/substrate/spread.ts +165 -0
  500. package/src/plugins/defaults/memory/{v3/substrate → substrate}/static-context.ts +12 -7
  501. package/src/plugins/defaults/memory/{v3/substrate → substrate}/sweep-job.ts +20 -15
  502. package/src/plugins/defaults/memory/substrate/tuning.ts +93 -0
  503. package/src/plugins/defaults/memory/{v3/substrate → substrate}/types.ts +7 -4
  504. package/src/plugins/defaults/memory/tools.test.ts +1 -1
  505. package/src/plugins/defaults/memory/tools.ts +1 -1
  506. package/src/plugins/defaults/memory/v1/README.md +5 -0
  507. package/src/plugins/defaults/memory/{__tests__ → v1/__tests__}/filing-jobs.test.ts +4 -4
  508. package/src/plugins/defaults/memory/{filing-jobs.ts → v1/filing-jobs.ts} +3 -3
  509. package/src/plugins/defaults/memory/{graph → v1/graph}/bootstrap.test.ts +68 -6
  510. package/src/plugins/defaults/memory/{graph → v1/graph}/bootstrap.ts +40 -21
  511. package/src/plugins/defaults/memory/{graph → v1/graph}/consolidation.ts +14 -14
  512. package/src/plugins/defaults/memory/{graph → v1/graph}/decay.test.ts +1 -1
  513. package/src/plugins/defaults/memory/{graph → v1/graph}/decay.ts +3 -3
  514. package/src/plugins/defaults/memory/{graph → v1/graph}/extraction-job.ts +5 -5
  515. package/src/plugins/defaults/memory/{graph → v1/graph}/extraction.test.ts +1 -1
  516. package/src/plugins/defaults/memory/{graph → v1/graph}/extraction.ts +20 -14
  517. package/src/plugins/defaults/memory/{graph → v1/graph}/graph-search.test.ts +3 -3
  518. package/src/plugins/defaults/memory/v1/graph/graph-search.ts +123 -0
  519. package/src/plugins/defaults/memory/{graph → v1/graph}/injection.test.ts +1 -118
  520. package/src/plugins/defaults/memory/{graph → v1/graph}/injection.ts +9 -111
  521. package/src/plugins/defaults/memory/{graph → v1/graph}/narrative.ts +6 -6
  522. package/src/plugins/defaults/memory/{graph → v1/graph}/pattern-scan.ts +5 -5
  523. package/src/plugins/defaults/memory/{graph → v1/graph}/retriever.test.ts +135 -42
  524. package/src/plugins/defaults/memory/{graph → v1/graph}/retriever.ts +40 -22
  525. package/src/plugins/defaults/memory/{graph → v1/graph}/scoring.test.ts +1 -1
  526. package/src/plugins/defaults/memory/{graph → v1/graph}/scoring.ts +1 -1
  527. package/src/plugins/defaults/memory/{graph → v1/graph}/serendipity.ts +1 -1
  528. package/src/plugins/defaults/memory/{graph → v1/graph}/triggers.test.ts +1 -1
  529. package/src/plugins/defaults/memory/{graph → v1/graph}/triggers.ts +1 -1
  530. package/src/plugins/defaults/memory/{identity-context.ts → v1/identity-context.ts} +4 -4
  531. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/backfill.ts +6 -6
  532. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/embedding.test.ts +6 -6
  533. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/embedding.ts +6 -6
  534. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/index-maintenance.ts +8 -8
  535. package/src/plugins/defaults/memory/{jobs → v1/jobs}/embed-pkb-file.test.ts +7 -7
  536. package/src/plugins/defaults/memory/{jobs → v1/jobs}/embed-pkb-file.ts +5 -5
  537. package/src/plugins/defaults/memory/{pkb → v1/pkb}/autoinject.ts +1 -1
  538. package/src/plugins/defaults/memory/{pkb → v1/pkb}/context.ts +2 -2
  539. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-index.test.ts +3 -3
  540. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-index.ts +2 -2
  541. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-reconcile.test.ts +3 -3
  542. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-reconcile.ts +2 -2
  543. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-search.test.ts +3 -3
  544. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-search.ts +6 -6
  545. package/src/plugins/defaults/memory/{pkb → v1/pkb}/types.ts +3 -5
  546. package/src/plugins/defaults/memory/{pkb-schedule.ts → v1/pkb-schedule.ts} +2 -2
  547. package/src/plugins/defaults/memory/{search/semantic.ts → v1/semantic-search.ts} +1 -1
  548. package/src/plugins/defaults/memory/v2/__tests__/activation-store.test.ts +1 -1
  549. package/src/plugins/defaults/memory/v2/__tests__/activation.test.ts +11 -274
  550. package/src/plugins/defaults/memory/v2/__tests__/backfill-jobs.test.ts +9 -131
  551. package/src/plugins/defaults/memory/v2/__tests__/harness-compare.test.ts +1 -1
  552. package/src/plugins/defaults/memory/v2/__tests__/harness-oracle.test.ts +1 -1
  553. package/src/plugins/defaults/memory/v2/__tests__/harness-replay-input.test.ts +1 -1
  554. package/src/plugins/defaults/memory/v2/__tests__/injection.test.ts +14 -10
  555. package/src/plugins/defaults/memory/v2/__tests__/reranker.test.ts +7 -5
  556. package/src/plugins/defaults/memory/v2/__tests__/router.test.ts +12 -6
  557. package/src/plugins/defaults/memory/{memory-v2-activation-log-store.ts → v2/activation-log-store.ts} +2 -2
  558. package/src/plugins/defaults/memory/v2/activation-store.ts +22 -8
  559. package/src/plugins/defaults/memory/v2/activation.ts +30 -163
  560. package/src/plugins/defaults/memory/v2/backfill-jobs.ts +7 -54
  561. package/src/plugins/defaults/memory/{memory-v2-concept-frequency.ts → v2/concept-frequency.ts} +3 -3
  562. package/src/plugins/defaults/memory/v2/harness/oracle.ts +1 -1
  563. package/src/plugins/defaults/memory/v2/harness/replay-input.ts +2 -2
  564. package/src/plugins/defaults/memory/v2/harness/retriever.ts +1 -1
  565. package/src/plugins/defaults/memory/v2/injection.ts +36 -26
  566. package/src/plugins/defaults/memory/v2/migration.ts +2 -2
  567. package/src/plugins/defaults/memory/{rerank-local.ts → v2/rerank-local.ts} +44 -18
  568. package/src/plugins/defaults/memory/v2/reranker.ts +29 -11
  569. package/src/plugins/defaults/memory/v2/router.ts +38 -15
  570. package/src/plugins/defaults/memory/v3/__tests__/candidate-match.test.ts +5 -3
  571. package/src/plugins/defaults/memory/v3/__tests__/carry-integration.test.ts +21 -8
  572. package/src/plugins/defaults/memory/v3/__tests__/edge.test.ts +1 -1
  573. package/src/plugins/defaults/memory/v3/__tests__/live-integration.test.ts +1 -1
  574. package/src/plugins/defaults/memory/v3/__tests__/maintain-job.test.ts +4 -1
  575. package/src/plugins/defaults/memory/v3/__tests__/orchestrate.test.ts +181 -3
  576. package/src/plugins/defaults/memory/v3/__tests__/selection-log-store.test.ts +3 -0
  577. package/src/plugins/defaults/memory/v3/__tests__/shadow-integration.test.ts +14 -5
  578. package/src/plugins/defaults/memory/v3/__tests__/shadow-plugin.test.ts +40 -50
  579. package/src/plugins/defaults/memory/v3/__tests__/tuning-profile.test.ts +1 -0
  580. package/src/plugins/defaults/memory/v3/candidate-match.ts +2 -2
  581. package/src/plugins/defaults/memory/v3/capabilities.ts +6 -4
  582. package/src/plugins/defaults/memory/v3/card.ts +25 -9
  583. package/src/plugins/defaults/memory/v3/edge.ts +52 -18
  584. package/src/plugins/defaults/memory/v3/gate.ts +4 -4
  585. package/src/plugins/defaults/memory/v3/injector.ts +10 -3
  586. package/src/plugins/defaults/memory/v3/maintain-job.ts +3 -3
  587. package/src/plugins/defaults/memory/v3/orchestrate.ts +100 -18
  588. package/src/plugins/defaults/memory/v3/page-content.ts +26 -10
  589. package/src/plugins/defaults/memory/v3/prune.ts +40 -16
  590. package/src/plugins/defaults/memory/v3/selection-log-store.ts +34 -12
  591. package/src/plugins/defaults/memory/v3/shadow-plugin.ts +9 -13
  592. package/src/plugins/defaults/memory/v3/span-query.test.ts +86 -0
  593. package/src/plugins/defaults/memory/v3/span-query.ts +71 -0
  594. package/src/plugins/defaults/memory/v3/tuning-profile.ts +3 -0
  595. package/src/plugins/defaults/memory/v3/types.ts +4 -1
  596. package/src/plugins/defaults/memory/v3-eval/eval-packets.ts +2 -2
  597. package/src/plugins/defaults/memory/validation.ts +1 -1
  598. package/src/plugins/defaults/memory/worker.ts +2 -1
  599. package/src/plugins/defaults/platform-hosted/__tests__/reengage.test.ts +104 -12
  600. package/src/plugins/defaults/platform-hosted/routes/reengage.ts +104 -12
  601. package/src/plugins/types.ts +2 -2
  602. package/src/prompts/sections.ts +4 -16
  603. package/src/providers/__tests__/registry-native-web-search.test.ts +47 -2
  604. package/src/providers/anthropic/client.ts +15 -6
  605. package/src/providers/content-block-schema.ts +26 -0
  606. package/src/providers/inference/__tests__/connections-credential-normalize.test.ts +87 -0
  607. package/src/providers/inference/adapter-factory.ts +6 -0
  608. package/src/providers/inference/connections.ts +30 -14
  609. package/src/providers/model-catalog.ts +77 -0
  610. package/src/providers/openai/__tests__/chat-completions-input-audio.test.ts +260 -0
  611. package/src/providers/openai/chat-completions-provider.ts +65 -17
  612. package/src/providers/openai/input-audio.ts +76 -0
  613. package/src/providers/openrouter/client.ts +0 -2
  614. package/src/providers/platform-proxy/constants.ts +4 -0
  615. package/src/providers/poolside/client.ts +42 -0
  616. package/src/providers/registry.ts +40 -8
  617. package/src/providers/retry.ts +2 -0
  618. package/src/providers/types.ts +39 -1
  619. package/src/providers/vercel-ai-gateway/client.ts +0 -2
  620. package/src/runtime/AGENTS.md +7 -5
  621. package/src/runtime/__tests__/question-request-guardian-bridge.test.ts +173 -0
  622. package/src/runtime/__tests__/question-resolution.test.ts +111 -0
  623. package/src/runtime/access-request-helper.ts +7 -15
  624. package/src/runtime/assistant-event-hub.ts +43 -31
  625. package/src/runtime/assistant-event-publish-options.ts +31 -0
  626. package/src/runtime/assistant-event.ts +19 -30
  627. package/src/runtime/assistant-stream-state.ts +4 -4
  628. package/src/runtime/channel-approvals.ts +0 -25
  629. package/src/runtime/channel-readiness-service.ts +99 -40
  630. package/src/runtime/channel-retry-sweep.ts +38 -15
  631. package/src/runtime/confirmation-request-guardian-bridge.ts +4 -0
  632. package/src/runtime/guardian-reply-router.ts +108 -0
  633. package/src/runtime/http-server.ts +8 -0
  634. package/src/runtime/http-types.ts +2 -2
  635. package/src/runtime/process-role.ts +42 -0
  636. package/src/runtime/question-request-guardian-bridge.ts +184 -0
  637. package/src/runtime/question-resolution.ts +153 -0
  638. package/src/runtime/routes/__tests__/bookmark-routes.test.ts +6 -2
  639. package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +1 -1
  640. package/src/runtime/routes/__tests__/subagents-routes.test.ts +250 -0
  641. package/src/runtime/routes/__tests__/webhook-routes.test.ts +201 -0
  642. package/src/runtime/routes/acp-routes.ts +2 -2
  643. package/src/runtime/routes/bookmark-routes.ts +3 -15
  644. package/src/runtime/routes/canned-message-complete.ts +2 -2
  645. package/src/runtime/routes/consolidation-routes.ts +8 -2
  646. package/src/runtime/routes/conversation-list-routes.ts +3 -19
  647. package/src/runtime/routes/conversation-management-routes.ts +1 -5
  648. package/src/runtime/routes/conversation-query-routes.ts +52 -8
  649. package/src/runtime/routes/conversation-routes.ts +36 -22
  650. package/src/runtime/routes/credential-request-routes.ts +0 -1
  651. package/src/runtime/routes/filing-routes.ts +7 -7
  652. package/src/runtime/routes/global-search-routes.ts +1 -1
  653. package/src/runtime/routes/guardian-approval-prompt.ts +2 -2
  654. package/src/runtime/routes/image-generation-routes.ts +12 -9
  655. package/src/runtime/routes/inbound-message-handler.ts +17 -0
  656. package/src/runtime/routes/inbound-stages/acl-enforcement.test.ts +50 -0
  657. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +19 -0
  658. package/src/runtime/routes/inbound-stages/background-dispatch.ts +4 -4
  659. package/src/runtime/routes/inbound-stages/inbound-content-prep.test.ts +129 -0
  660. package/src/runtime/routes/inbound-stages/inbound-content-prep.ts +141 -9
  661. package/src/runtime/routes/index.ts +2 -0
  662. package/src/runtime/routes/lifecycle-routes.ts +199 -0
  663. package/src/runtime/routes/platform-routes.ts +3 -8
  664. package/src/runtime/routes/playground/__tests__/inject-failures.test.ts +7 -7
  665. package/src/runtime/routes/playground/__tests__/reset-circuit.test.ts +5 -5
  666. package/src/runtime/routes/question-routes.ts +34 -87
  667. package/src/runtime/routes/secret-routes.ts +11 -1
  668. package/src/runtime/routes/settings-routes.ts +8 -18
  669. package/src/runtime/routes/subagents-routes.ts +35 -8
  670. package/src/runtime/routes/upgrade-broadcast-routes.ts +4 -5
  671. package/src/runtime/routes/webhook-routes.ts +89 -30
  672. package/src/runtime/routes/workspace-routes.test.ts +7 -4
  673. package/src/runtime/slack-reply-session.test.ts +12 -12
  674. package/src/runtime/slack-reply-session.ts +17 -17
  675. package/src/runtime/sync/sync-publisher.test.ts +7 -5
  676. package/src/runtime/tool-grant-request-helper.ts +4 -0
  677. package/src/schedule/schedule-store.ts +70 -0
  678. package/src/schedule/scheduler.ts +27 -0
  679. package/src/security/AGENTS.md +1 -1
  680. package/src/security/credential-key.ts +17 -0
  681. package/src/security/secret-ingress.ts +14 -105
  682. package/src/security/secret-patterns.ts +8 -139
  683. package/src/security/secret-scanner.ts +8 -3
  684. package/src/security/store-path-override.ts +6 -16
  685. package/src/sequence/store.ts +8 -0
  686. package/src/signals/emit-event.ts +5 -10
  687. package/src/signals/event-stream.ts +20 -10
  688. package/src/subagent/manager.ts +76 -25
  689. package/src/subagent/notify.ts +8 -0
  690. package/src/subagent/types.ts +13 -3
  691. package/src/telegram/__tests__/webhook-health.test.ts +442 -0
  692. package/src/telegram/webhook-health.ts +478 -0
  693. package/src/telemetry/AGENTS.md +6 -0
  694. package/src/telemetry/memory-corpus-size.test.ts +129 -0
  695. package/src/telemetry/memory-corpus-size.ts +184 -0
  696. package/src/telemetry/memory-tier-reporter.test.ts +67 -2
  697. package/src/telemetry/memory-tier-reporter.ts +30 -3
  698. package/src/tools/__tests__/conversation-group-tool-input-schemas.test.ts +61 -0
  699. package/src/tools/__tests__/document-tool-input-schemas.test.ts +103 -0
  700. package/src/tools/__tests__/followup-call-acp-tool-input-schemas.test.ts +125 -0
  701. package/src/tools/__tests__/schedule-tool-input-schemas.test.ts +83 -0
  702. package/src/tools/__tests__/subagent-workflow-tool-input-schemas.test.ts +116 -0
  703. package/src/tools/__tests__/tool-input-schemas.test.ts +192 -0
  704. package/src/tools/__tests__/tool-schema-drift-harness.ts +142 -0
  705. package/src/tools/acp/abort.ts +21 -1
  706. package/src/tools/acp/context.ts +5 -5
  707. package/src/tools/acp/spawn.test.ts +15 -5
  708. package/src/tools/acp/spawn.ts +26 -3
  709. package/src/tools/acp/status.ts +20 -1
  710. package/src/tools/acp/steer.test.ts +20 -0
  711. package/src/tools/acp/steer.ts +23 -2
  712. package/src/tools/apps/resolve-app-id.ts +15 -3
  713. package/src/tools/ask-question/ask-question-tool.test.ts +65 -0
  714. package/src/tools/ask-question/ask-question-tool.ts +68 -92
  715. package/src/tools/browser/browser-screencast.ts +6 -6
  716. package/src/tools/calls/call-end.ts +24 -3
  717. package/src/tools/calls/call-start.ts +35 -11
  718. package/src/tools/calls/call-status.ts +20 -1
  719. package/src/tools/conversation-groups/group_create.ts +63 -0
  720. package/src/tools/conversation-groups/group_list.ts +20 -0
  721. package/src/tools/conversation-groups/group_shared.ts +52 -0
  722. package/src/tools/conversation-groups/move_to_group.ts +106 -0
  723. package/src/tools/document/document-comment-tool.test.ts +49 -0
  724. package/src/tools/document/document-comment-tool.ts +45 -6
  725. package/src/tools/document/document-tool.ts +142 -24
  726. package/src/tools/executor.ts +27 -13
  727. package/src/tools/filesystem/edit.ts +62 -60
  728. package/src/tools/filesystem/list.ts +36 -29
  729. package/src/tools/filesystem/read.ts +56 -39
  730. package/src/tools/filesystem/write.ts +44 -38
  731. package/src/tools/followups/followup_create.ts +41 -12
  732. package/src/tools/followups/followup_list.ts +34 -6
  733. package/src/tools/followups/followup_resolve.ts +26 -4
  734. package/src/tools/host-filesystem/edit.ts +50 -60
  735. package/src/tools/host-filesystem/read.ts +45 -39
  736. package/src/tools/host-filesystem/write.ts +31 -36
  737. package/src/tools/host-terminal/host-shell.ts +76 -62
  738. package/src/tools/policy-context.ts +27 -10
  739. package/src/tools/schedule/create.ts +76 -33
  740. package/src/tools/schedule/delete.ts +21 -2
  741. package/src/tools/schedule/list.ts +25 -3
  742. package/src/tools/schedule/update.ts +105 -48
  743. package/src/tools/shared/filesystem/path-policy.ts +246 -40
  744. package/src/tools/shared/zod-tool-schema.ts +117 -0
  745. package/src/tools/subagent/abort.ts +12 -4
  746. package/src/tools/subagent/consult-deadline.ts +9 -3
  747. package/src/tools/subagent/message.ts +21 -5
  748. package/src/tools/subagent/notify-parent.ts +44 -23
  749. package/src/tools/subagent/read.ts +15 -4
  750. package/src/tools/subagent/resolve.ts +26 -4
  751. package/src/tools/subagent/spawn.ts +37 -13
  752. package/src/tools/subagent/status.ts +12 -4
  753. package/src/tools/system/request-permission.ts +35 -26
  754. package/src/tools/terminal/shell.ts +68 -55
  755. package/src/tools/tool-approval-handler.ts +327 -53
  756. package/src/tools/tool-input-schemas.ts +85 -0
  757. package/src/tools/tool-types.ts +7 -0
  758. package/src/tools/types.ts +8 -0
  759. package/src/tools/workflows/manage-workflows.ts +30 -2
  760. package/src/tools/workflows/run-workflow.test.ts +54 -2
  761. package/src/tools/workflows/run-workflow.ts +32 -4
  762. package/src/util/fs-symlinks.ts +30 -0
  763. package/src/util/log-redact.ts +7 -3
  764. package/src/util/platform.ts +15 -0
  765. package/src/vellum-assistant-namespace.d.ts +80 -0
  766. package/src/watcher/watcher-store.ts +8 -0
  767. package/src/workflows/leaf-runner.test.ts +104 -2
  768. package/src/workflows/leaf-runner.ts +31 -6
  769. package/src/workspace/migrations/070-memory-v2-summary-schema-rebuild.ts +2 -2
  770. package/src/workspace/migrations/134-image-generation-mode-to-provider.ts +128 -0
  771. package/src/workspace/migrations/135-copy-substrate-tunables.ts +248 -0
  772. package/src/workspace/migrations/__tests__/135-copy-substrate-tunables.test.ts +446 -0
  773. package/src/workspace/migrations/__tests__/backfill-v3-leaves.test.ts +2 -2
  774. package/src/workspace/migrations/registry.ts +4 -0
  775. package/tsconfig.plugin-api.json +1 -1
  776. package/src/__tests__/memory-retrieval-budget.test.ts +0 -49
  777. package/src/__tests__/secret-patterns.test.ts +0 -27
  778. package/src/config/__tests__/proc-to-skills.test.ts +0 -21
  779. package/src/config/memory-tier.test.ts +0 -44
  780. package/src/daemon/message-types/acp.ts +0 -20
  781. package/src/daemon/message-types/apps.ts +0 -11
  782. package/src/daemon/message-types/background-tools.ts +0 -14
  783. package/src/daemon/message-types/bookmarks.ts +0 -13
  784. package/src/daemon/message-types/contacts.ts +0 -13
  785. package/src/daemon/message-types/document-comments.ts +0 -14
  786. package/src/daemon/message-types/documents.ts +0 -13
  787. package/src/daemon/message-types/home.ts +0 -15
  788. package/src/daemon/message-types/host-bash.ts +0 -12
  789. package/src/daemon/message-types/host-cu.ts +0 -10
  790. package/src/daemon/message-types/host-file.ts +0 -12
  791. package/src/daemon/message-types/host-transfer.ts +0 -12
  792. package/src/daemon/message-types/integrations.ts +0 -90
  793. package/src/daemon/message-types/memory.ts +0 -10
  794. package/src/daemon/message-types/schedules.ts +0 -14
  795. package/src/daemon/message-types/settings.ts +0 -17
  796. package/src/daemon/message-types/subagents.ts +0 -63
  797. package/src/daemon/message-types/upgrades.ts +0 -14
  798. package/src/daemon/message-types/workflows.ts +0 -25
  799. package/src/daemon/message-types/workspace.ts +0 -137
  800. package/src/live-voice/ack-phrases.ts +0 -58
  801. package/src/plugins/defaults/memory/retrieval-budget.ts +0 -29
  802. package/src/plugins/defaults/memory/v3/__tests__/gate-flag.test.ts +0 -69
  803. package/src/plugins/defaults/memory/v3/gate-flag.ts +0 -20
  804. package/src/plugins/defaults/memory/v3/substrate/__tests__/memory-v2-startup.test.ts +0 -86
  805. package/src/plugins/defaults/memory/v3/substrate/memory-v2-startup.test.ts +0 -205
  806. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/concept-page-frontmatter-schema.test.ts +0 -0
  807. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/consolidation-prompt-flag-gating-guard.test.ts +0 -0
  808. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/injected-block-slugs.test.ts +0 -0
  809. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/cli-command-content.ts +0 -0
@@ -0,0 +1,446 @@
1
+ import {
2
+ chmodSync,
3
+ existsSync,
4
+ mkdtempSync,
5
+ readFileSync,
6
+ rmSync,
7
+ writeFileSync,
8
+ } from "node:fs";
9
+ import { tmpdir } from "node:os";
10
+ import { join } from "node:path";
11
+ import { afterEach, beforeEach, describe, expect, test } from "bun:test";
12
+
13
+ import { MemoryConfigSchema } from "../../../config/schemas/memory.js";
14
+ import { MemoryV2ConfigSchema } from "../../../config/schemas/memory-v2.js";
15
+ import {
16
+ resolveSubstrateTuning,
17
+ type SubstrateTuning,
18
+ } from "../../../plugins/defaults/memory/substrate/tuning.js";
19
+ import { copySubstrateTunablesMigration as MIG } from "../135-copy-substrate-tunables.js";
20
+
21
+ let workspaceDir: string;
22
+ let configPath: string;
23
+
24
+ /** The shipped `memory.v2` defaults, i.e. the effective value of an unset key. */
25
+ const V2_SCHEMA_DEFAULTS = MemoryV2ConfigSchema.parse({});
26
+
27
+ function pick<T>(
28
+ substrate: Record<string, unknown>,
29
+ key: string,
30
+ fallback: T,
31
+ ): T {
32
+ // Presence, not truthiness: `resolveSubstrateTuning` falls back only on
33
+ // `undefined`, so an explicit `null` counts as set.
34
+ return key in substrate ? (substrate[key] as T) : fallback;
35
+ }
36
+
37
+ /**
38
+ * `resolveSubstrateTuning` with the `memory.v2` fallback stripped: every
39
+ * tunable resolves from `memory.substrate` alone, or from the shipped v2
40
+ * schema default when the substrate key is absent.
41
+ *
42
+ * Migration 135's whole purpose is to make this resolver agree with the real
43
+ * one on a migrated workspace — that agreement is what lets the fallback be
44
+ * removed later without changing anyone's behavior.
45
+ */
46
+ function resolveSubstrateOnly(
47
+ substrate: Record<string, unknown>,
48
+ ): SubstrateTuning {
49
+ const d = V2_SCHEMA_DEFAULTS;
50
+ return {
51
+ sweep_enabled: pick(substrate, "sweep_enabled", d.sweep_enabled),
52
+ dense_weight: pick(substrate, "dense_weight", d.dense_weight),
53
+ sparse_weight: pick(substrate, "sparse_weight", d.sparse_weight),
54
+ min_sparse_spread: pick(
55
+ substrate,
56
+ "min_sparse_spread",
57
+ d.min_sparse_spread,
58
+ ),
59
+ full_sparse_spread: pick(
60
+ substrate,
61
+ "full_sparse_spread",
62
+ d.full_sparse_spread,
63
+ ),
64
+ bm25_k1: pick(substrate, "bm25_k1", d.bm25_k1),
65
+ bm25_b: pick(substrate, "bm25_b", d.bm25_b),
66
+ consolidation_interval_hours: pick(
67
+ substrate,
68
+ "consolidation_interval_hours",
69
+ d.consolidation_interval_hours,
70
+ ),
71
+ consolidation_max_buffer_lines: pick(
72
+ substrate,
73
+ "consolidation_max_buffer_lines",
74
+ d.consolidation_max_buffer_lines,
75
+ ),
76
+ consolidation_max_entries_per_run: pick(
77
+ substrate,
78
+ "consolidation_max_entries_per_run",
79
+ d.consolidation_max_entries_per_run,
80
+ ),
81
+ max_page_chars: pick(substrate, "max_page_chars", d.max_page_chars),
82
+ consolidation_prompt_path: pick(
83
+ substrate,
84
+ "consolidation_prompt_path",
85
+ d.consolidation_prompt_path,
86
+ ),
87
+ spread_k: pick(substrate, "spread_k", d.k),
88
+ spread_hops: pick(substrate, "spread_hops", d.hops),
89
+ ann_candidate_limit: pick(
90
+ substrate,
91
+ "ann_candidate_limit",
92
+ d.ann_candidate_limit,
93
+ ),
94
+ };
95
+ }
96
+
97
+ function write(obj: unknown): void {
98
+ writeFileSync(configPath, JSON.stringify(obj, null, 2) + "\n");
99
+ }
100
+ function readRaw(): string {
101
+ return readFileSync(configPath, "utf-8");
102
+ }
103
+ function read(): Record<string, unknown> {
104
+ return JSON.parse(readRaw());
105
+ }
106
+ function memory(): Record<string, unknown> {
107
+ return read().memory as Record<string, unknown>;
108
+ }
109
+
110
+ beforeEach(() => {
111
+ workspaceDir = mkdtempSync(join(tmpdir(), "copy-substrate-tunables-"));
112
+ configPath = join(workspaceDir, "config.json");
113
+ });
114
+ afterEach(() => {
115
+ rmSync(workspaceDir, { recursive: true, force: true });
116
+ });
117
+
118
+ describe("135-copy-substrate-tunables", () => {
119
+ test("has the expected id", () => {
120
+ expect(MIG.id).toBe("135-copy-substrate-tunables");
121
+ });
122
+
123
+ test("no-ops when config.json is absent, unparseable, or has no memory config", () => {
124
+ // Absent config.json.
125
+ expect(() => MIG.run(workspaceDir)).not.toThrow();
126
+
127
+ // Unparseable config.json is left byte-for-byte alone.
128
+ writeFileSync(configPath, "{not json");
129
+ MIG.run(workspaceDir);
130
+ expect(readRaw()).toBe("{not json");
131
+
132
+ // No memory config — fresh-workspace shape.
133
+ write({ llm: { provider: "anthropic" } });
134
+ const before = readRaw();
135
+ MIG.run(workspaceDir);
136
+ expect(readRaw()).toBe(before);
137
+
138
+ // memory present but no v2 subtree.
139
+ write({ memory: { enabled: true } });
140
+ const beforeNoV2 = readRaw();
141
+ MIG.run(workspaceDir);
142
+ expect(readRaw()).toBe(beforeNoV2);
143
+ });
144
+
145
+ test("never introduces memory.substrate when memory.v2 sets no substrate tunables", () => {
146
+ write({ memory: { v2: { enabled: true, hybrid_min_score: 0.02 } } });
147
+ const before = readRaw();
148
+
149
+ MIG.run(workspaceDir);
150
+
151
+ // Nothing copied → no write at all, so no empty substrate object appears.
152
+ expect(readRaw()).toBe(before);
153
+ });
154
+
155
+ test("copies an explicit memory.v2.consolidation_interval_hours, leaving memory.v2 untouched", () => {
156
+ write({
157
+ memory: {
158
+ v2: { enabled: true, consolidation_interval_hours: 6 },
159
+ },
160
+ });
161
+
162
+ MIG.run(workspaceDir);
163
+
164
+ expect(memory()).toEqual({
165
+ v2: { enabled: true, consolidation_interval_hours: 6 },
166
+ substrate: { consolidation_interval_hours: 6 },
167
+ });
168
+ // Temp-then-rename persistence leaves no temp file behind on success.
169
+ expect(existsSync(configPath + ".tmp")).toBe(false);
170
+ });
171
+
172
+ // Root bypasses file permission checks, so chmod cannot make the workspace
173
+ // read-only — skip rather than assert a failure path that cannot be
174
+ // exercised.
175
+ test.skipIf(process.getuid?.() === 0)(
176
+ "throws on a write failure, leaving config.json byte-for-byte intact (retryable via failed checkpoint)",
177
+ () => {
178
+ write({ memory: { v2: { bm25_b: 0.6 } } });
179
+ const before = readRaw();
180
+
181
+ // A read-only workspace dir blocks creation of the config.json.tmp
182
+ // staging file, standing in for any persistence failure.
183
+ chmodSync(workspaceDir, 0o555);
184
+ try {
185
+ expect(() => MIG.run(workspaceDir)).toThrow();
186
+ } finally {
187
+ chmodSync(workspaceDir, 0o755);
188
+ }
189
+
190
+ // The failure surfaces to the runner (failed checkpoint, not completed)
191
+ // and the migration opts into retrying that checkpoint on the next boot.
192
+ expect(MIG.retryFailedCheckpoint).toBe(true);
193
+ // config.json is untouched — the failed write targeted the temp file.
194
+ expect(readRaw()).toBe(before);
195
+ expect(existsSync(configPath + ".tmp")).toBe(false);
196
+
197
+ // The retry succeeds once the workspace is writable again.
198
+ MIG.run(workspaceDir);
199
+ expect(memory().substrate).toEqual({ bm25_b: 0.6 });
200
+ },
201
+ );
202
+
203
+ // Root bypasses file permission checks, so chmod 0o000 cannot make the
204
+ // file unreadable — skip rather than assert a failure path that cannot be
205
+ // exercised.
206
+ test.skipIf(process.getuid?.() === 0)(
207
+ "throws on a filesystem read failure so the failed checkpoint retries; malformed JSON stays a no-op",
208
+ () => {
209
+ write({ memory: { v2: { bm25_b: 0.6 } } });
210
+
211
+ // An unreadable config.json is a transient fs failure, not malformed
212
+ // content — it must surface to the runner instead of completing.
213
+ chmodSync(configPath, 0o000);
214
+ try {
215
+ expect(() => MIG.run(workspaceDir)).toThrow();
216
+ } finally {
217
+ chmodSync(configPath, 0o644);
218
+ }
219
+
220
+ // The retry succeeds once the file is readable again.
221
+ MIG.run(workspaceDir);
222
+ expect(memory().substrate).toEqual({ bm25_b: 0.6 });
223
+ },
224
+ );
225
+
226
+ test("renames k→spread_k and hops→spread_hops; a tuned bm25_b lands on the substrate key", () => {
227
+ write({
228
+ memory: {
229
+ v2: { k: 0.4, hops: 3, bm25_b: 0.6 },
230
+ },
231
+ });
232
+
233
+ MIG.run(workspaceDir);
234
+
235
+ expect(memory().substrate).toEqual({
236
+ spread_k: 0.4,
237
+ spread_hops: 3,
238
+ bm25_b: 0.6,
239
+ });
240
+ expect(memory().v2).toEqual({ k: 0.4, hops: 3, bm25_b: 0.6 });
241
+ });
242
+
243
+ test("a migrated workspace resolves identically with the v2 fallback stripped", () => {
244
+ // A normally-created workspace: loader-seeded defaults alongside real user
245
+ // overrides, including the two no-default spread keys and the nullable
246
+ // keys on both sides of the copy rule.
247
+ write({
248
+ memory: {
249
+ v2: {
250
+ enabled: true,
251
+ // Seeded defaults — the migration must leave these behind.
252
+ sweep_enabled: false,
253
+ dense_weight: 0.85,
254
+ sparse_weight: 0.15,
255
+ bm25_k1: 1.2,
256
+ consolidation_max_entries_per_run: 150,
257
+ consolidation_prompt_path: null,
258
+ hops: 2,
259
+ // User overrides — the migration must carry these across.
260
+ bm25_b: 0.6,
261
+ consolidation_interval_hours: 6,
262
+ consolidation_max_buffer_lines: null,
263
+ max_page_chars: 9000,
264
+ k: 0.4,
265
+ ann_candidate_limit: 500,
266
+ min_sparse_spread: 0.05,
267
+ full_sparse_spread: 0.3,
268
+ },
269
+ },
270
+ });
271
+
272
+ MIG.run(workspaceDir);
273
+
274
+ const parsed = MemoryConfigSchema.parse(memory());
275
+ const withFallback = resolveSubstrateTuning(parsed);
276
+ const substrateOnly = resolveSubstrateOnly(
277
+ memory().substrate as Record<string, unknown>,
278
+ );
279
+
280
+ // The load-bearing claim: after the copy, the substrate namespace plus the
281
+ // shipped defaults reproduce the resolver's substrate→v2 fallback exactly.
282
+ expect(substrateOnly).toEqual(withFallback);
283
+ // Anchored against the operator's actual intent, so the equality above
284
+ // cannot pass by both sides being wrong in the same way.
285
+ expect(withFallback.consolidation_interval_hours).toBe(6);
286
+ expect(withFallback.consolidation_max_buffer_lines).toBeNull();
287
+ expect(withFallback.spread_k).toBe(0.4);
288
+ expect(withFallback.spread_hops).toBe(2);
289
+ expect(withFallback.min_sparse_spread).toBe(0.05);
290
+ });
291
+
292
+ test("bm25_b at the historical 0.75 default is the one value the copy rule cannot carry", () => {
293
+ // The skip list treats 0.75 as loader-seeded, so it never reaches
294
+ // memory.substrate and only the fallback keeps it in effect. Recorded here
295
+ // because it is the single case where dropping the fallback would change
296
+ // behavior.
297
+ write({ memory: { v2: { bm25_b: 0.75 } } });
298
+
299
+ MIG.run(workspaceDir);
300
+
301
+ const parsed = MemoryConfigSchema.parse(memory());
302
+ expect(resolveSubstrateTuning(parsed).bm25_b).toBe(0.75);
303
+ expect(resolveSubstrateOnly({}).bm25_b).toBe(0.4);
304
+ });
305
+
306
+ test("never clobbers an already-set memory.substrate key, but still copies its unset siblings", () => {
307
+ write({
308
+ memory: {
309
+ v2: { bm25_b: 0.6, max_page_chars: 9000 },
310
+ substrate: { bm25_b: 0.3 },
311
+ },
312
+ });
313
+
314
+ MIG.run(workspaceDir);
315
+
316
+ expect(memory().substrate).toEqual({ bm25_b: 0.3, max_page_chars: 9000 });
317
+ expect(memory().v2).toEqual({ bm25_b: 0.6, max_page_chars: 9000 });
318
+ });
319
+
320
+ test("skips loader-seeded values equal to the shipped defaults, including null-default keys", () => {
321
+ // The config loader persists the fully-parsed config for normally-created
322
+ // workspaces, so every defaulted v2 leaf is present in config.json. None
323
+ // of these are user intent — the migration must not pin them into the
324
+ // override-only substrate namespace.
325
+ write({
326
+ memory: {
327
+ v2: {
328
+ enabled: true,
329
+ sweep_enabled: false,
330
+ dense_weight: 0.85,
331
+ sparse_weight: 0.15,
332
+ bm25_k1: 1.2,
333
+ bm25_b: 0.4,
334
+ consolidation_interval_hours: 8,
335
+ consolidation_max_buffer_lines: 100,
336
+ consolidation_max_entries_per_run: 150,
337
+ max_page_chars: 5000,
338
+ consolidation_prompt_path: null,
339
+ k: 0.5,
340
+ hops: 2,
341
+ ann_candidate_limit: null,
342
+ },
343
+ },
344
+ });
345
+ const before = readRaw();
346
+
347
+ MIG.run(workspaceDir);
348
+
349
+ // Nothing differs from a shipped default → no copy, no write at all.
350
+ expect(readRaw()).toBe(before);
351
+ });
352
+
353
+ test("copies non-default values on nullable keys but skips their seeded null defaults", () => {
354
+ write({
355
+ memory: {
356
+ v2: {
357
+ ann_candidate_limit: 500,
358
+ consolidation_prompt_path: null,
359
+ },
360
+ },
361
+ });
362
+
363
+ MIG.run(workspaceDir);
364
+
365
+ // 500 differs from the shipped null default and copies; the seeded null
366
+ // equals its default and stays out of the substrate namespace.
367
+ expect(memory().substrate).toEqual({ ann_candidate_limit: 500 });
368
+ });
369
+
370
+ test("skips bm25_b values seeded by the earlier 0.75 default (multi-default key)", () => {
371
+ write({
372
+ memory: {
373
+ v2: { bm25_b: 0.75, bm25_k1: 1.5 },
374
+ },
375
+ });
376
+
377
+ MIG.run(workspaceDir);
378
+
379
+ // 0.75 matches the pre-migration-075 shipped default and is seeded, not a
380
+ // user override; the tuned bm25_k1 still copies.
381
+ expect(memory().substrate).toEqual({ bm25_k1: 1.5 });
382
+ });
383
+
384
+ test("copies the no-default spread keys on presence alone", () => {
385
+ // min_sparse_spread / full_sparse_spread ship with no schema default, so
386
+ // the loader never seeds them — raw presence IS user intent.
387
+ write({
388
+ memory: {
389
+ v2: { min_sparse_spread: 0.05, full_sparse_spread: 0.3 },
390
+ },
391
+ });
392
+
393
+ MIG.run(workspaceDir);
394
+
395
+ expect(memory().substrate).toEqual({
396
+ min_sparse_spread: 0.05,
397
+ full_sparse_spread: 0.3,
398
+ });
399
+ });
400
+
401
+ test("a tuned weight pair copies whole and still parses after migration (resolved-pair weight check)", () => {
402
+ // The v2 refinement validates dense_weight + sparse_weight on the
403
+ // persisted values, so a valid config with a non-default dense_weight
404
+ // necessarily persists its non-default twin — both copy, and the copied
405
+ // substrate pair is exactly the pair v2 already accepted.
406
+ write({ memory: { v2: { dense_weight: 0.9, sparse_weight: 0.1 } } });
407
+
408
+ MIG.run(workspaceDir);
409
+
410
+ expect(memory().substrate).toEqual({
411
+ dense_weight: 0.9,
412
+ sparse_weight: 0.1,
413
+ });
414
+ expect(() => MemoryConfigSchema.parse(memory())).not.toThrow();
415
+ });
416
+
417
+ test("is idempotent — a second run leaves the file byte-for-byte unchanged", () => {
418
+ write({
419
+ memory: {
420
+ v2: { bm25_b: 0.6, k: 0.4, ann_candidate_limit: 500 },
421
+ substrate: { sweep_enabled: true },
422
+ },
423
+ });
424
+
425
+ MIG.run(workspaceDir);
426
+ const afterFirst = readRaw();
427
+ MIG.run(workspaceDir);
428
+
429
+ expect(readRaw()).toBe(afterFirst);
430
+ expect(memory().substrate).toEqual({
431
+ sweep_enabled: true,
432
+ bm25_b: 0.6,
433
+ spread_k: 0.4,
434
+ ann_candidate_limit: 500,
435
+ });
436
+ });
437
+
438
+ test("down() is a forward-only no-op", () => {
439
+ write({ memory: { v2: { bm25_b: 0.6 }, substrate: { bm25_b: 0.6 } } });
440
+ const before = readRaw();
441
+
442
+ expect(() => MIG.down(workspaceDir)).not.toThrow();
443
+
444
+ expect(readRaw()).toBe(before);
445
+ });
446
+ });
@@ -6,8 +6,8 @@ import { afterEach, beforeEach, describe, expect, it } from "bun:test";
6
6
  import {
7
7
  readPage,
8
8
  writePage,
9
- } from "../../../plugins/defaults/memory/v3/substrate/page-store.js";
10
- import type { ConceptPageFrontmatter } from "../../../plugins/defaults/memory/v3/substrate/types.js";
9
+ } from "../../../plugins/defaults/memory/substrate/page-store.js";
10
+ import type { ConceptPageFrontmatter } from "../../../plugins/defaults/memory/substrate/types.js";
11
11
  import { backfillV3LeavesMigration } from "../092-backfill-v3-leaves.js";
12
12
 
13
13
  describe("092 backfill v3 leaves", () => {
@@ -131,6 +131,8 @@ import { speechModeToProviderMigration } from "./130-speech-mode-to-provider.js"
131
131
  import { dropWebFetchModeMigration } from "./131-drop-web-fetch-mode.js";
132
132
  import { webSearchModeToProviderMigration } from "./132-web-search-mode-to-provider.js";
133
133
  import { collapseProviderConnectionsMigration } from "./133-collapse-provider-connections.js";
134
+ import { imageGenerationModeToProviderMigration } from "./134-image-generation-mode-to-provider.js";
135
+ import { copySubstrateTunablesMigration } from "./135-copy-substrate-tunables.js";
134
136
  import { migrateToWorkspaceVolumeMigration } from "./migrate-to-workspace-volume.js";
135
137
  import type { WorkspaceMigration } from "./types.js";
136
138
 
@@ -277,4 +279,6 @@ export const WORKSPACE_MIGRATIONS: WorkspaceMigration[] = [
277
279
  dropWebFetchModeMigration,
278
280
  webSearchModeToProviderMigration,
279
281
  collapseProviderConnectionsMigration,
282
+ imageGenerationModeToProviderMigration,
283
+ copySubstrateTunablesMigration,
280
284
  ];
@@ -9,5 +9,5 @@
9
9
  "outDir": "./.plugin-api-build/dts",
10
10
  "rootDir": "./src"
11
11
  },
12
- "include": ["src/plugin-api/index.ts"]
12
+ "include": ["src/plugin-api/index.ts", "src/vellum-assistant-namespace.d.ts"]
13
13
  }
@@ -1,49 +0,0 @@
1
- import { describe, expect, test } from "bun:test";
2
-
3
- import { computeRecallBudget } from "../plugins/defaults/memory/retrieval-budget.js";
4
-
5
- describe("memory retrieval budget", () => {
6
- test("clamps to maxInjectTokens when headroom is large", () => {
7
- const budget = computeRecallBudget({
8
- estimatedPromptTokens: 20_000,
9
- maxInputTokens: 180_000,
10
- targetHeadroomTokens: 8_000,
11
- minInjectTokens: 1_200,
12
- maxInjectTokens: 10_000,
13
- });
14
- expect(budget).toBe(10_000);
15
- });
16
-
17
- test("clamps to minInjectTokens when headroom is tight", () => {
18
- const budget = computeRecallBudget({
19
- estimatedPromptTokens: 172_000,
20
- maxInputTokens: 180_000,
21
- targetHeadroomTokens: 8_000,
22
- minInjectTokens: 1_200,
23
- maxInjectTokens: 10_000,
24
- });
25
- expect(budget).toBe(1_200);
26
- });
27
-
28
- test("returns computed value when between min and max", () => {
29
- const budget = computeRecallBudget({
30
- estimatedPromptTokens: 165_000,
31
- maxInputTokens: 180_000,
32
- targetHeadroomTokens: 8_000,
33
- minInjectTokens: 1_200,
34
- maxInjectTokens: 10_000,
35
- });
36
- expect(budget).toBe(7_000);
37
- });
38
-
39
- test("normalizes invalid min/max ordering safely", () => {
40
- const budget = computeRecallBudget({
41
- estimatedPromptTokens: 150_000,
42
- maxInputTokens: 180_000,
43
- targetHeadroomTokens: 8_000,
44
- minInjectTokens: 12_000,
45
- maxInjectTokens: 1_200,
46
- });
47
- expect(budget).toBe(12_000);
48
- });
49
- });
@@ -1,27 +0,0 @@
1
- import { describe, expect, test } from "bun:test";
2
-
3
- import { PREFIX_PATTERNS } from "../security/secret-patterns.js";
4
-
5
- function matchingLabels(text: string): string[] {
6
- return PREFIX_PATTERNS.filter((p) => p.regex.test(text)).map((p) => p.label);
7
- }
8
-
9
- describe("Vercel AI Gateway API Key", () => {
10
- test("matches a vck_ key as exactly one pattern", () => {
11
- expect(matchingLabels(`vck_${"a".repeat(32)}`)).toEqual([
12
- "Vercel AI Gateway API Key",
13
- ]);
14
- });
15
-
16
- test("does not match a short vck_ string", () => {
17
- expect(matchingLabels("vck_abc")).toEqual([]);
18
- });
19
- });
20
-
21
- describe("OpenRouter API Key", () => {
22
- test("matches an sk-or-v1- key", () => {
23
- expect(matchingLabels(`sk-or-v1-${"a".repeat(40)}`)).toEqual([
24
- "OpenRouter API Key",
25
- ]);
26
- });
27
- });
@@ -1,21 +0,0 @@
1
- import { describe, expect, test } from "bun:test";
2
-
3
- import { isProcToSkillsActive } from "../memory-v3-gate.js";
4
- import type { AssistantConfig } from "../schema.js";
5
-
6
- describe("isProcToSkillsActive (v3-live)", () => {
7
- const v3Live = { memory: { v3: { live: true } } } as AssistantConfig;
8
- const v3NotLive = { memory: { v3: { live: false } } } as AssistantConfig;
9
-
10
- test("false when v3 is not live", () => {
11
- expect(isProcToSkillsActive(v3NotLive)).toBe(false);
12
- });
13
-
14
- test("false by default (no v3 config)", () => {
15
- expect(isProcToSkillsActive({} as AssistantConfig)).toBe(false);
16
- });
17
-
18
- test("true when v3 is live", () => {
19
- expect(isProcToSkillsActive(v3Live)).toBe(true);
20
- });
21
- });
@@ -1,44 +0,0 @@
1
- import { describe, expect, test } from "bun:test";
2
-
3
- import { memoryTier } from "./memory-tier.js";
4
- import type { AssistantConfig } from "./schema.js";
5
-
6
- describe("memoryTier", () => {
7
- test("off when memory is explicitly disabled", () => {
8
- const config = { memory: { enabled: false } } as AssistantConfig;
9
- expect(memoryTier(config)).toBe("off");
10
- });
11
-
12
- test("off wins even when v3 is live (OFF over v3 precedence)", () => {
13
- const config = {
14
- memory: { enabled: false, v3: { live: true } },
15
- } as AssistantConfig;
16
- expect(memoryTier(config)).toBe("off");
17
- });
18
-
19
- test("v3 when memory-v3 is live", () => {
20
- const config = { memory: { v3: { live: true } } } as AssistantConfig;
21
- expect(memoryTier(config)).toBe("v3");
22
- });
23
-
24
- test("v2 when v2 is enabled and v3 is not live", () => {
25
- const config = {
26
- memory: { v2: { enabled: true }, v3: { live: false } },
27
- } as AssistantConfig;
28
- expect(memoryTier(config)).toBe("v2");
29
- });
30
-
31
- test("v3 wins over v2 when both are truthy (v3 over v2 precedence)", () => {
32
- const config = {
33
- memory: { v2: { enabled: true }, v3: { live: true } },
34
- } as AssistantConfig;
35
- expect(memoryTier(config)).toBe("v3");
36
- });
37
-
38
- test("v1 when memory is on but neither v2 nor v3 is selected", () => {
39
- const config = {
40
- memory: { enabled: true, v2: { enabled: false }, v3: { live: false } },
41
- } as AssistantConfig;
42
- expect(memoryTier(config)).toBe("v1");
43
- });
44
- });
@@ -1,20 +0,0 @@
1
- // ACP (Agent Client Protocol) session lifecycle and communication types.
2
- //
3
- // Server→client events are single-sourced from their canonical `api/events`
4
- // wire schemas; this file only composes them into the domain union consumed by
5
- // `message-protocol.ts`.
6
-
7
- import type { AcpSessionCompletedEvent } from "../../api/events/acp-session-completed.js";
8
- import type { AcpSessionErrorEvent } from "../../api/events/acp-session-error.js";
9
- import type { AcpSessionSpawnedEvent } from "../../api/events/acp-session-spawned.js";
10
- import type { AcpSessionUpdateEvent } from "../../api/events/acp-session-update.js";
11
- import type { AcpSessionUsageEvent } from "../../api/events/acp-session-usage.js";
12
-
13
- // --- Domain-level union alias (consumed by message-protocol.ts) ---
14
-
15
- export type _AcpServerMessages =
16
- | AcpSessionSpawnedEvent
17
- | AcpSessionUpdateEvent
18
- | AcpSessionCompletedEvent
19
- | AcpSessionErrorEvent
20
- | AcpSessionUsageEvent;
@@ -1,11 +0,0 @@
1
- // App management, publishing, and sharing.
2
- //
3
- // Server→client events that are live hub broadcasts are single-sourced from
4
- // their canonical `api/events` wire schemas; this file only composes them into
5
- // the domain union consumed by `message-protocol.ts`. App management — listing,
6
- // bundling, sharing, publishing, history/diff/restore, signing — is served by
7
- // the HTTP app-management routes, not by client messages.
8
-
9
- import type { AppFilesChangedEvent } from "../../api/events/app-files-changed.js";
10
-
11
- export type _AppsServerMessages = AppFilesChangedEvent;
@@ -1,14 +0,0 @@
1
- // Background bash/host_bash command lifecycle types.
2
- //
3
- // Server→client events are single-sourced from their canonical `api/events`
4
- // wire schemas; this file only composes them into the domain union consumed by
5
- // `message-protocol.ts`.
6
-
7
- import type { BackgroundToolCompletedEvent } from "../../api/events/background-tool-completed.js";
8
- import type { BackgroundToolStartedEvent } from "../../api/events/background-tool-started.js";
9
-
10
- // --- Domain-level union alias (consumed by message-protocol.ts) ---
11
-
12
- export type _BackgroundToolsServerMessages =
13
- | BackgroundToolStartedEvent
14
- | BackgroundToolCompletedEvent;
@@ -1,13 +0,0 @@
1
- // Bookmark events. Surfaced over SSE so a `BookmarkStore` instance in any
2
- // connected client can stay in sync when another window mutates the list.
3
- //
4
- // Server→client events are single-sourced from their canonical `api/events`
5
- // wire schemas; this file only composes them into the domain union consumed by
6
- // `message-protocol.ts`.
7
-
8
- import type { BookmarkCreatedEvent } from "../../api/events/bookmark-created.js";
9
- import type { BookmarkDeletedEvent } from "../../api/events/bookmark-deleted.js";
10
-
11
- export type _BookmarksServerMessages =
12
- | BookmarkCreatedEvent
13
- | BookmarkDeletedEvent;