@vellumai/assistant 0.10.12 → 0.11.0-dev.202607290043.3b26b6b

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 (2064) 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 +67 -23
  5. package/docs/error-handling.md +3 -3
  6. package/docs/guardian-request-flow.md +112 -0
  7. package/eslint.config.mjs +34 -1
  8. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/package.json +1 -0
  9. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/channels.test.ts +9 -1
  10. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/secret-detection.test.ts +449 -0
  11. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/channels.ts +1 -0
  12. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/secret-detection.ts +468 -0
  13. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/app.d.ts +28 -0
  14. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/app.d.ts.map +1 -1
  15. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/index.d.ts +2 -2
  16. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/index.d.ts.map +1 -1
  17. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/index.js.map +1 -1
  18. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/message.d.ts +2 -0
  19. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/dist/events/message.d.ts.map +1 -1
  20. package/node_modules/@vellumai/gateway-client/node_modules/@slack/types/package.json +1 -1
  21. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/package.json +1 -0
  22. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/channels.test.ts +9 -1
  23. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/secret-detection.test.ts +449 -0
  24. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/channels.ts +1 -0
  25. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/secret-detection.ts +468 -0
  26. package/node_modules/@vellumai/gateway-client/package.json +1 -1
  27. package/node_modules/@vellumai/gateway-client/src/admission-policy-contract.ts +6 -0
  28. package/node_modules/@vellumai/gateway-client/src/inbound-contract.ts +34 -0
  29. package/node_modules/@vellumai/service-contracts/package.json +1 -0
  30. package/node_modules/@vellumai/service-contracts/src/__tests__/channels.test.ts +9 -1
  31. package/node_modules/@vellumai/service-contracts/src/__tests__/secret-detection.test.ts +449 -0
  32. package/node_modules/@vellumai/service-contracts/src/channels.ts +1 -0
  33. package/node_modules/@vellumai/service-contracts/src/secret-detection.ts +468 -0
  34. package/openapi.yaml +345 -16
  35. package/package.json +2 -2
  36. package/scripts/build-plugin-api.ts +11 -4
  37. package/scripts/capture-x-graphql.ts +54 -20
  38. package/scripts/generate-openapi.ts +7 -3
  39. package/scripts/memory-inspect.ts +17 -6
  40. package/scripts/sync-llm-catalog.ts +44 -19
  41. package/scripts/sync-web-search-catalog.ts +3 -1
  42. package/scripts/voice-ttft-spike.ts +6 -3
  43. package/src/__tests__/acp-session.test.ts +3 -3
  44. package/src/__tests__/agent-loop-history-repair.test.ts +180 -0
  45. package/src/__tests__/agent-loop-mutable-latest-user-message.test.ts +3 -0
  46. package/src/__tests__/agent-loop-output-hooks.test.ts +35 -11
  47. package/src/__tests__/agent-loop-regrowth-guard.test.ts +3 -1
  48. package/src/__tests__/agent-loop.test.ts +5 -2
  49. package/src/__tests__/anthropic-error-formatting.test.ts +3 -1
  50. package/src/__tests__/anthropic-provider.test.ts +40 -0
  51. package/src/__tests__/app-control-flow.test.ts +3 -1
  52. package/src/__tests__/app-control-tool-schemas.test.ts +6 -2
  53. package/src/__tests__/app-conversation-ids-backfill.test.ts +33 -2
  54. package/src/__tests__/app-conversation-ids.test.ts +204 -0
  55. package/src/__tests__/app-dir-path-guard.test.ts +9 -3
  56. package/src/__tests__/app-routes-csp.test.ts +12 -4
  57. package/src/__tests__/app-source-watcher.test.ts +3 -1
  58. package/src/__tests__/approval-cascade.test.ts +5 -5
  59. package/src/__tests__/approval-primitive.test.ts +66 -22
  60. package/src/__tests__/approval-routes-http.test.ts +3 -3
  61. package/src/__tests__/ask-question-resolver.test.ts +207 -0
  62. package/src/__tests__/assistant-event-hub-self-exclusion.test.ts +16 -16
  63. package/src/__tests__/assistant-event-hub-targeted.test.ts +13 -11
  64. package/src/__tests__/assistant-event-hub.test.ts +13 -11
  65. package/src/__tests__/assistant-event.test.ts +12 -9
  66. package/src/__tests__/assistant-feature-flag-guard.test.ts +9 -5
  67. package/src/__tests__/assistant-feature-flag-guardrails.test.ts +13 -5
  68. package/src/__tests__/assistant-id-boundary-guard.test.ts +26 -67
  69. package/src/__tests__/assistant-stream-state.test.ts +17 -7
  70. package/src/__tests__/attachments-store.test.ts +12 -4
  71. package/src/__tests__/avatar-generator.test.ts +3 -1
  72. package/src/__tests__/avatar-identity-sync.test.ts +3 -3
  73. package/src/__tests__/background-shell-bash.test.ts +3 -1
  74. package/src/__tests__/background-workers-disk-pressure.test.ts +1 -0
  75. package/src/__tests__/browser-fill-credential.test.ts +6 -2
  76. package/src/__tests__/browser-runtime-check.test.ts +3 -1
  77. package/src/__tests__/build-persisted-content.test.ts +3 -1
  78. package/src/__tests__/bundled-skill-retrieval-guard.test.ts +15 -5
  79. package/src/__tests__/call-controller.test.ts +9 -3
  80. package/src/__tests__/call-conversation-messages.test.ts +134 -18
  81. package/src/__tests__/call-domain.test.ts +15 -8
  82. package/src/__tests__/call-setup-flow-midcall-trust.test.ts +3 -1
  83. package/src/__tests__/call-start-guardian-guard.test.ts +27 -0
  84. package/src/__tests__/call-state-machine.test.ts +3 -1
  85. package/src/__tests__/channel-approval-routes.test.ts +2 -1
  86. package/src/__tests__/channel-approval.test.ts +9 -6
  87. package/src/__tests__/channel-approvals.test.ts +0 -27
  88. package/src/__tests__/channel-guardian.test.ts +88 -513
  89. package/src/__tests__/channel-readiness-service.test.ts +107 -1
  90. package/src/__tests__/channel-readiness-slack-remote.test.ts +151 -3
  91. package/src/__tests__/channel-retry-sweep.test.ts +88 -1
  92. package/src/__tests__/channel-setup-panel-ack.test.ts +10 -9
  93. package/src/__tests__/chat-reveal-guard-priming.test.ts +31 -34
  94. package/src/__tests__/clawhub.test.ts +3 -1
  95. package/src/__tests__/cli-memory-v2-reembed-skills.test.ts +4 -2
  96. package/src/__tests__/compact-event-conversation-id-guard.test.ts +3 -2
  97. package/src/__tests__/compaction-events.test.ts +8 -8
  98. package/src/__tests__/compaction-summary-head-persisted-count.test.ts +1 -1
  99. package/src/__tests__/config-get-vision-flag.test.ts +1 -1
  100. package/src/__tests__/config-loader-corrupt.test.ts +3 -1
  101. package/src/__tests__/config-loader-platform-defaults.test.ts +57 -29
  102. package/src/__tests__/config-loader-quarantine-notice.test.ts +3 -1
  103. package/src/__tests__/config-loader-validation-reset-notice.test.ts +3 -1
  104. package/src/__tests__/config-model-image-provider.test.ts +23 -1
  105. package/src/__tests__/config-schema-memory-substrate.test.ts +306 -0
  106. package/src/__tests__/config-schema.test.ts +14 -2
  107. package/src/__tests__/config-set-platform-guard.test.ts +14 -13
  108. package/src/__tests__/config-sounds-sync.test.ts +4 -4
  109. package/src/__tests__/config-watcher.test.ts +3 -1
  110. package/src/__tests__/confirmation-request-guardian-bridge.test.ts +5 -0
  111. package/src/__tests__/connection-model-compat.test.ts +3 -1
  112. package/src/__tests__/contact-store-user-file.test.ts +18 -6
  113. package/src/__tests__/contacts-relay-reads.test.ts +31 -22
  114. package/src/__tests__/contacts-tools.test.ts +3 -1
  115. package/src/__tests__/context-overflow-reducer.test.ts +3 -1
  116. package/src/__tests__/context-search-conversations-source.test.ts +4 -1
  117. package/src/__tests__/context-search-memory-source.test.ts +1 -1
  118. package/src/__tests__/context-search-memory-v2-source.test.ts +8 -6
  119. package/src/__tests__/context-token-estimator.test.ts +54 -1
  120. package/src/__tests__/conversation-agent-loop-disk-pressure.test.ts +12 -3
  121. package/src/__tests__/conversation-agent-loop-fatal-cleanup.test.ts +13 -4
  122. package/src/__tests__/conversation-agent-loop-handlers-max-tokens.test.ts +6 -4
  123. package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +11 -2
  124. package/src/__tests__/conversation-agent-loop-overflow.test.ts +23 -14
  125. package/src/__tests__/conversation-agent-loop.test.ts +40 -31
  126. package/src/__tests__/conversation-confirmation-signals.test.ts +14 -14
  127. package/src/__tests__/conversation-evictor.test.ts +49 -0
  128. package/src/__tests__/conversation-fork-crud.test.ts +1 -1
  129. package/src/__tests__/conversation-fork-route.test.ts +3 -1
  130. package/src/__tests__/conversation-group-tools.test.ts +279 -0
  131. package/src/__tests__/conversation-history-web-search.test.ts +1 -1
  132. package/src/__tests__/conversation-inference-profile-list.test.ts +3 -1
  133. package/src/__tests__/conversation-key-store-disk-view.test.ts +5 -5
  134. package/src/__tests__/conversation-lineage.test.ts +235 -0
  135. package/src/__tests__/conversation-list-source.test.ts +3 -1
  136. package/src/__tests__/conversation-loop-db-lock-resilience.test.ts +11 -10
  137. package/src/__tests__/conversation-message-sync-tags.test.ts +4 -4
  138. package/src/__tests__/conversation-pairing.test.ts +6 -2
  139. package/src/__tests__/conversation-pre-run-repair.test.ts +1 -1
  140. package/src/__tests__/conversation-queue.test.ts +146 -82
  141. package/src/__tests__/conversation-routes-disk-view.test.ts +18 -6
  142. package/src/__tests__/conversation-routes-enabled-plugins.test.ts +8 -1
  143. package/src/__tests__/conversation-routes-hidden-queue.test.ts +8 -1
  144. package/src/__tests__/conversation-routes-slash-commands.test.ts +10 -1
  145. package/src/__tests__/conversation-runtime-assembly.test.ts +29 -2
  146. package/src/__tests__/conversation-slash-commands.test.ts +27 -9
  147. package/src/__tests__/conversation-slash-queue.test.ts +11 -11
  148. package/src/__tests__/conversation-slash-unknown.test.ts +2 -2
  149. package/src/__tests__/conversation-slash.test.ts +92 -0
  150. package/src/__tests__/conversation-speed-override.test.ts +2 -2
  151. package/src/__tests__/conversation-starter-routes.test.ts +6 -2
  152. package/src/__tests__/conversation-summarize-route.test.ts +9 -0
  153. package/src/__tests__/conversation-surfaces-action-delivery.test.ts +18 -16
  154. package/src/__tests__/conversation-surfaces-activation-emit.test.ts +17 -17
  155. package/src/__tests__/conversation-surfaces-app-control.test.ts +3 -1
  156. package/src/__tests__/conversation-surfaces-app-open.test.ts +5 -4
  157. package/src/__tests__/conversation-surfaces-data-persist.test.ts +7 -7
  158. package/src/__tests__/conversation-surfaces-queued-emit.test.ts +86 -0
  159. package/src/__tests__/conversation-surfaces-standalone-payloads.test.ts +9 -9
  160. package/src/__tests__/conversation-surfaces-standalone.test.ts +16 -12
  161. package/src/__tests__/conversation-surfaces-state-update.test.ts +6 -5
  162. package/src/__tests__/conversation-surfaces-table-action.test.ts +4 -3
  163. package/src/__tests__/conversation-surfaces-task-progress.test.ts +46 -46
  164. package/src/__tests__/conversation-sync-tags.test.ts +5 -5
  165. package/src/__tests__/conversation-wait-for-idle.test.ts +2 -2
  166. package/src/__tests__/conversation-workspace-cache-state.test.ts +0 -4
  167. package/src/__tests__/conversation-workspace-injection.test.ts +0 -3
  168. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +0 -3
  169. package/src/__tests__/copy-composer-tc-templates.test.ts +3 -131
  170. package/src/__tests__/credential-broker-server-use.test.ts +21 -7
  171. package/src/__tests__/credential-broker.test.ts +30 -10
  172. package/src/__tests__/credential-execution-client.test.ts +17 -6
  173. package/src/__tests__/credential-security-invariants.test.ts +4 -1
  174. package/src/__tests__/custom-group-listing-visibility.test.ts +93 -0
  175. package/src/__tests__/daemon-assistant-events.test.ts +14 -15
  176. package/src/__tests__/db-migration-rollback.test.ts +21 -7
  177. package/src/__tests__/db-readiness-http-gate.test.ts +3 -1
  178. package/src/__tests__/db-schedule-syntax-migration.test.ts +1 -0
  179. package/src/__tests__/db-test-helpers.ts +13 -27
  180. package/src/__tests__/disk-pressure-guard.test.ts +3 -1
  181. package/src/__tests__/disk-pressure-routes.test.ts +12 -3
  182. package/src/__tests__/dm-backfill.test.ts +3 -1
  183. package/src/__tests__/dm-persistence.test.ts +3 -1
  184. package/src/__tests__/docker-signing-key-bootstrap.test.ts +2 -1
  185. package/src/__tests__/document-tool-security.test.ts +95 -0
  186. package/src/__tests__/drain-kick-guard.test.ts +232 -0
  187. package/src/__tests__/dynamic-skill-background-guard.test.ts +19 -6
  188. package/src/__tests__/edit-engine.test.ts +42 -14
  189. package/src/__tests__/emit-event-signal.test.ts +5 -6
  190. package/src/__tests__/encrypted-store-test-helpers.ts +10 -20
  191. package/src/__tests__/events-dev-bypass-actor.test.ts +3 -1
  192. package/src/__tests__/events-tail-route.test.ts +6 -4
  193. package/src/__tests__/feature-flag-test-helpers.ts +10 -20
  194. package/src/__tests__/file-edit-tool.test.ts +24 -4
  195. package/src/__tests__/file-list-tool.test.ts +2 -1
  196. package/src/__tests__/file-ops-service.test.ts +60 -20
  197. package/src/__tests__/file-read-tool.test.ts +62 -10
  198. package/src/__tests__/file-write-tool.test.ts +24 -5
  199. package/src/__tests__/filesystem-tools.test.ts +90 -30
  200. package/src/__tests__/fixtures/mock-chrome-extension.ts +18 -6
  201. package/src/__tests__/fixtures/mock-signup-server.ts +6 -2
  202. package/src/__tests__/followup-tools.test.ts +58 -0
  203. package/src/__tests__/fuzzy-match-property.test.ts +18 -6
  204. package/src/__tests__/gateway-flag-listener.test.ts +9 -3
  205. package/src/__tests__/gateway-only-enforcement.test.ts +2 -1
  206. package/src/__tests__/gateway-only-guard.test.ts +12 -4
  207. package/src/__tests__/gateway-threshold-reader-mock.ts +99 -0
  208. package/src/__tests__/gemini-image-service.test.ts +3 -1
  209. package/src/__tests__/gemini-provider.test.ts +3 -1
  210. package/src/__tests__/get-skill-detail-audit.test.ts +9 -3
  211. package/src/__tests__/graph-extraction-event-date.test.ts +1 -1
  212. package/src/__tests__/guardian-decision-primitive-canonical.test.ts +42 -14
  213. package/src/__tests__/guardian-expiry-notifier.test.ts +3 -1
  214. package/src/__tests__/guardian-question-mode.test.ts +53 -6
  215. package/src/__tests__/guardian-reply-router-answer-mode.test.ts +283 -0
  216. package/src/__tests__/guardian-vellum-destination-pinning.test.ts +221 -0
  217. package/src/__tests__/headless-browser-interactions.test.ts +6 -2
  218. package/src/__tests__/headless-browser-mode.test.ts +6 -2
  219. package/src/__tests__/headless-browser-navigate.test.ts +33 -11
  220. package/src/__tests__/headless-browser-read-tools.test.ts +24 -8
  221. package/src/__tests__/headless-browser-snapshot.test.ts +3 -1
  222. package/src/__tests__/heartbeat-disk-pressure.test.ts +1 -0
  223. package/src/__tests__/heartbeat-service.test.ts +1 -0
  224. package/src/__tests__/helpers/channel-test-adapter.ts +17 -7
  225. package/src/__tests__/helpers/create-guardian-binding.ts +3 -1
  226. package/src/__tests__/helpers/derive-guardian-delivery.ts +3 -1
  227. package/src/__tests__/helpers/gateway-acl-store.ts +6 -2
  228. package/src/__tests__/helpers/gateway-classify-mock.ts +3 -1
  229. package/src/__tests__/helpers/native-web-search-harness.ts +10 -10
  230. package/src/__tests__/helpers/seed-contact-channel.ts +3 -1
  231. package/src/__tests__/helpers/tar-fixtures.ts +3 -1
  232. package/src/__tests__/history-repair-observability.test.ts +1 -1
  233. package/src/__tests__/history-repair.test.ts +2 -2
  234. package/src/__tests__/host-app-control-routes.test.ts +98 -2
  235. package/src/__tests__/host-browser-proxy.test.ts +1 -1
  236. package/src/__tests__/host-cu-proxy.test.ts +7 -1
  237. package/src/__tests__/host-file-edit-tool.test.ts +3 -3
  238. package/src/__tests__/host-file-read-tool.test.ts +2 -2
  239. package/src/__tests__/host-file-write-tool.test.ts +7 -3
  240. package/src/__tests__/host-proxy-preactivation.test.ts +1 -5
  241. package/src/__tests__/host-shell-tool.test.ts +17 -5
  242. package/src/__tests__/host-transfer-pending-interactions.test.ts +8 -8
  243. package/src/__tests__/host-transfer-proxy.test.ts +4 -4
  244. package/src/__tests__/host-transfer-routes-targeted.test.ts +3 -1
  245. package/src/__tests__/image-credentials.test.ts +65 -8
  246. package/src/__tests__/inbound-slack-persistence.test.ts +3 -1
  247. package/src/__tests__/injection-block.test.ts +4 -4
  248. package/src/__tests__/injector-chain.test.ts +1 -1
  249. package/src/__tests__/injector-config-quarantine-notice.test.ts +3 -1
  250. package/src/__tests__/injector-config-validation-reset-notice.test.ts +3 -1
  251. package/src/__tests__/injector-disk-pressure.test.ts +3 -1
  252. package/src/__tests__/injector-document-comments.test.ts +3 -1
  253. package/src/__tests__/injector-pkb-v2-silenced.test.ts +2 -2
  254. package/src/__tests__/injector-registry-order-guard.test.ts +4 -9
  255. package/src/__tests__/injector-v3-suppression.test.ts +12 -6
  256. package/src/__tests__/inline-skill-authoring-guard.test.ts +12 -4
  257. package/src/__tests__/internal-telemetry-routes.test.ts +3 -1
  258. package/src/__tests__/lexical-index-dual-write.test.ts +3 -1
  259. package/src/__tests__/lifecycle-memory-v2-seed.test.ts +33 -28
  260. package/src/__tests__/list-messages-page-latest.test.ts +2 -2
  261. package/src/__tests__/llm-callsite-catalog.test.ts +3 -1
  262. package/src/__tests__/llm-catalog-parity.test.ts +21 -7
  263. package/src/__tests__/llm-usage-store.test.ts +67 -4
  264. package/src/__tests__/log-redact.test.ts +18 -0
  265. package/src/__tests__/managed-profile-guard.test.ts +80 -0
  266. package/src/__tests__/managed-skill-lifecycle.test.ts +2 -2
  267. package/src/__tests__/mcp-cli.test.ts +10 -3
  268. package/src/__tests__/media-generate-image.test.ts +62 -11
  269. package/src/__tests__/media-stream-output.test.ts +9 -3
  270. package/src/__tests__/media-stream-parser.test.ts +111 -37
  271. package/src/__tests__/media-stream-stt-session.test.ts +34 -11
  272. package/src/__tests__/memory-identity-context-parity.test.ts +1 -1
  273. package/src/__tests__/memory-jobs-worker-lanes.test.ts +9 -1
  274. package/src/__tests__/memory-retrieval-hook.test.ts +4 -4
  275. package/src/__tests__/migration-cross-version-compatibility.test.ts +3 -1
  276. package/src/__tests__/migration-export-http.test.ts +9 -3
  277. package/src/__tests__/migration-export-streaming.test.ts +9 -3
  278. package/src/__tests__/migration-import-commit-http.test.ts +21 -7
  279. package/src/__tests__/migration-import-preflight-http.test.ts +3 -1
  280. package/src/__tests__/migration-validate-http.test.ts +3 -1
  281. package/src/__tests__/mock-fetch.ts +3 -1
  282. package/src/__tests__/mock-gateway-ipc.ts +20 -7
  283. package/src/__tests__/mock-signup-server.test.ts +9 -3
  284. package/src/__tests__/native-web-search.test.ts +3 -1
  285. package/src/__tests__/no-is-trusted-guard.test.ts +3 -1
  286. package/src/__tests__/notification-broadcaster.test.ts +5 -3
  287. package/src/__tests__/notification-decision-strategy.test.ts +115 -11
  288. package/src/__tests__/notification-deep-link.test.ts +12 -12
  289. package/src/__tests__/notification-platform-adapter.test.ts +12 -4
  290. package/src/__tests__/notification-vellum-adapter.test.ts +8 -8
  291. package/src/__tests__/oauth-apps-routes.test.ts +3 -1
  292. package/src/__tests__/oauth-commands-routes.test.ts +9 -3
  293. package/src/__tests__/oauth-connect-orchestrator.test.ts +33 -11
  294. package/src/__tests__/oauth-connect-routes.test.ts +3 -1
  295. package/src/__tests__/oauth-providers-routes.test.ts +15 -10
  296. package/src/__tests__/oauth2-refresh-retry.test.ts +3 -1
  297. package/src/__tests__/onboarding-persona-write.test.ts +12 -10
  298. package/src/__tests__/openai-image-service.test.ts +6 -2
  299. package/src/__tests__/openai-provider.test.ts +3 -1
  300. package/src/__tests__/openai-responses-cutover-guard.test.ts +3 -1
  301. package/src/__tests__/openai-responses-provider.test.ts +3 -1
  302. package/src/__tests__/outbound-slack-persistence.test.ts +20 -8
  303. package/src/__tests__/path-policy.test.ts +315 -0
  304. package/src/__tests__/pending-interactions-resolved-event.test.ts +6 -6
  305. package/src/__tests__/persist-media-references.test.ts +3 -1
  306. package/src/__tests__/persist-onboarding-artifacts.test.ts +3 -1
  307. package/src/__tests__/persist-user-message-set-processing-failure.test.ts +3 -1
  308. package/src/__tests__/persistence-layering-guard.test.ts +2 -2
  309. package/src/__tests__/persistence-secret-redaction.test.ts +9 -3
  310. package/src/__tests__/persona-resolver.test.ts +3 -1
  311. package/src/__tests__/pkb-autoinject.test.ts +1 -1
  312. package/src/__tests__/platform-bash-auto-approve.test.ts +1 -0
  313. package/src/__tests__/platform-callback-registration.test.ts +142 -12
  314. package/src/__tests__/plugin-api-tool-definition.test.ts +5 -8
  315. package/src/__tests__/plugin-bootstrap.test.ts +2 -3
  316. package/src/__tests__/plugin-event-hub-facade.test.ts +22 -15
  317. package/src/__tests__/plugin-import-boundary-guard.test.ts +21 -15
  318. package/src/__tests__/plugin-import-boundary-reverse-guard.test.ts +0 -4
  319. package/src/__tests__/post-turn-tool-result-truncation.test.ts +112 -1
  320. package/src/__tests__/prechat-onboarding-contract.test.ts +6 -2
  321. package/src/__tests__/process-message-background-slack.test.ts +3 -1
  322. package/src/__tests__/processing-flag-persist-failure.test.ts +0 -4
  323. package/src/__tests__/profiler-routes.test.ts +10 -12
  324. package/src/__tests__/provider-catalog-visibility.test.ts +12 -4
  325. package/src/__tests__/provider-error-scenarios.test.ts +27 -9
  326. package/src/__tests__/provider-platform-proxy-integration.test.ts +0 -1
  327. package/src/__tests__/provider-streaming.benchmark.test.ts +12 -4
  328. package/src/__tests__/rebuild-index-graph-nodes.test.ts +1 -1
  329. package/src/__tests__/recording-handler.test.ts +7 -3
  330. package/src/__tests__/request-secret-standalone-channel-gate.test.ts +5 -5
  331. package/src/__tests__/require-fresh-approval.test.ts +38 -38
  332. package/src/__tests__/resolve-app-id.test.ts +32 -0
  333. package/src/__tests__/run-conversation-turn-persistence.test.ts +3 -1
  334. package/src/__tests__/run-due-schedules.test.ts +72 -1
  335. package/src/__tests__/runtime-events-sse-parity.test.ts +11 -10
  336. package/src/__tests__/runtime-events-sse-reconnect.test.ts +3 -1
  337. package/src/__tests__/runtime-events-sse.test.ts +1 -1
  338. package/src/__tests__/schedule-retry.test.ts +3 -1
  339. package/src/__tests__/schedule-routes-workflow-validation.test.ts +9 -3
  340. package/src/__tests__/schedule-routes.test.ts +44 -5
  341. package/src/__tests__/schedule-store.test.ts +3 -3
  342. package/src/__tests__/schedule-tools.test.ts +282 -0
  343. package/src/__tests__/scheduler-reuse-conversation.test.ts +3 -1
  344. package/src/__tests__/script-proxy-injection-runtime.test.ts +14 -5
  345. package/src/__tests__/script-proxy-mitm-handler.test.ts +12 -4
  346. package/src/__tests__/script-proxy-rewrite-specificity.test.ts +12 -4
  347. package/src/__tests__/search-skills-unified.test.ts +27 -9
  348. package/src/__tests__/secret-prompt-log-hygiene.test.ts +3 -3
  349. package/src/__tests__/secret-prompter-channel-fallback.test.ts +3 -3
  350. package/src/__tests__/secret-response-routing.test.ts +3 -3
  351. package/src/__tests__/secret-routes-platform-proxy.test.ts +4 -7
  352. package/src/__tests__/secret-scanner.test.ts +36 -0
  353. package/src/__tests__/send-endpoint-busy.test.ts +7 -7
  354. package/src/__tests__/service-contracts-import-guard.test.ts +12 -4
  355. package/src/__tests__/settings-routes.test.ts +3 -1
  356. package/src/__tests__/shell-credential-ref.test.ts +6 -2
  357. package/src/__tests__/shell-observability.test.ts +3 -1
  358. package/src/__tests__/skill-cache-store.test.ts +3 -1
  359. package/src/__tests__/skill-feature-flags-integration.test.ts +3 -1
  360. package/src/__tests__/skill-secret-handling-guard.test.ts +11 -4
  361. package/src/__tests__/skills-file-content-endpoint.test.ts +93 -31
  362. package/src/__tests__/skills-files-catalog-fallback.test.ts +33 -11
  363. package/src/__tests__/skills.test.ts +33 -14
  364. package/src/__tests__/slack-channel-config.test.ts +6 -2
  365. package/src/__tests__/slack-messaging-token-resolution.test.ts +6 -2
  366. package/src/__tests__/slack-required-scopes-mirror.test.ts +81 -0
  367. package/src/__tests__/sse-actor-principal-guardian-source.test.ts +3 -1
  368. package/src/__tests__/starter-task-flow.test.ts +26 -3
  369. package/src/__tests__/steer-on-enqueue-question.test.ts +3 -1
  370. package/src/__tests__/steer-tool-repair.test.ts +6 -2
  371. package/src/__tests__/subagent-allowlist-validation.test.ts +3 -1
  372. package/src/__tests__/subagent-call-site-routing.test.ts +2 -2
  373. package/src/__tests__/subagent-disposal.test.ts +40 -11
  374. package/src/__tests__/subagent-fork-notifications.test.ts +4 -4
  375. package/src/__tests__/subagent-fork-prompt-role.test.ts +5 -3
  376. package/src/__tests__/subagent-fork-spawn.test.ts +4 -4
  377. package/src/__tests__/subagent-manager-notify.test.ts +73 -14
  378. package/src/__tests__/subagent-notify-parent.test.ts +48 -4
  379. package/src/__tests__/subagent-role-registry.test.ts +3 -1
  380. package/src/__tests__/subagent-spawn-and-await.test.ts +62 -14
  381. package/src/__tests__/subagent-tools.test.ts +64 -0
  382. package/src/__tests__/sync-message-contract.test.ts +3 -3
  383. package/src/__tests__/system-prompt.test.ts +12 -5
  384. package/src/__tests__/task-progress-nudge-hook.test.ts +3 -1
  385. package/src/__tests__/telegram-bot-username-resolution.test.ts +3 -1
  386. package/src/__tests__/telegram-config.test.ts +99 -3
  387. package/src/__tests__/telemetry-routes.test.ts +8 -3
  388. package/src/__tests__/terminal-tools.test.ts +12 -3
  389. package/src/__tests__/test-preload.ts +9 -0
  390. package/src/__tests__/thinking-block-replay.test.ts +1 -2
  391. package/src/__tests__/thread-backfill.test.ts +24 -8
  392. package/src/__tests__/token-estimator-accuracy.benchmark.test.ts +6 -2
  393. package/src/__tests__/token-manager.test.ts +36 -12
  394. package/src/__tests__/tool-approval-handler.test.ts +587 -43
  395. package/src/__tests__/tool-execution-pipeline.benchmark.test.ts +7 -4
  396. package/src/__tests__/tool-executor.test.ts +116 -0
  397. package/src/__tests__/tool-grant-request-escalation.test.ts +5 -0
  398. package/src/__tests__/tool-preview-lifecycle.test.ts +34 -34
  399. package/src/__tests__/tool-result-metadata-plumbing.test.ts +5 -5
  400. package/src/__tests__/tool-result-truncation.test.ts +3 -1
  401. package/src/__tests__/tool-side-effects-slack-dm.test.ts +1 -0
  402. package/src/__tests__/tool-start-timestamp.test.ts +4 -4
  403. package/src/__tests__/trusted-contact-approval-notifier.test.ts +6 -2
  404. package/src/__tests__/trusted-contact-lifecycle-notifications.test.ts +9 -22
  405. package/src/__tests__/tts-catalog-parity.test.ts +6 -2
  406. package/src/__tests__/twilio-provider.test.ts +6 -2
  407. package/src/__tests__/ui-choice-copy-surfaces.test.ts +13 -13
  408. package/src/__tests__/ui-work-result-surface.test.ts +3 -3
  409. package/src/__tests__/unicode.test.ts +1 -3
  410. package/src/__tests__/usage-cli.test.ts +3 -1
  411. package/src/__tests__/usage-routes.test.ts +3 -1
  412. package/src/__tests__/validate-input.test.ts +27 -9
  413. package/src/__tests__/voice-approval-resolver-relay.test.ts +15 -5
  414. package/src/__tests__/voice-config-update.test.ts +3 -1
  415. package/src/__tests__/voice-scoped-grant-consumer.test.ts +6 -6
  416. package/src/__tests__/voice-session-bridge.test.ts +44 -44
  417. package/src/__tests__/web-fetch.test.ts +21 -7
  418. package/src/__tests__/web-search-catalog-parity.test.ts +11 -4
  419. package/src/__tests__/web-search-history.test.ts +72 -78
  420. package/src/__tests__/web-search.test.ts +15 -5
  421. package/src/__tests__/workspace-greetings.test.ts +3 -1
  422. package/src/__tests__/workspace-migration-026-backfill-install-meta.test.ts +3 -1
  423. package/src/__tests__/workspace-migration-043-release-notes-latex-rendering.test.ts +3 -1
  424. package/src/__tests__/workspace-migration-082-backfill-managed-profile-labels.test.ts +1 -4
  425. package/src/__tests__/workspace-migration-130-speech-mode-to-provider.test.ts +3 -1
  426. package/src/__tests__/workspace-migration-134-image-generation-mode-to-provider.test.ts +284 -0
  427. package/src/__tests__/workspace-migration-136-repair-stale-fireworks-kimi-model-id.test.ts +139 -0
  428. package/src/__tests__/workspace-migration-down-functions.test.ts +5 -2
  429. package/src/__tests__/workspace-migration-meets.test.ts +4 -6
  430. package/src/__tests__/workspace-migration-memory-v2-init.test.ts +3 -1
  431. package/src/__tests__/workspace-migration-seed-device-id.test.ts +3 -1
  432. package/src/__tests__/workspace-policy.test.ts +482 -2
  433. package/src/acp/__tests__/client-handler.test.ts +3 -3
  434. package/src/acp/__tests__/helpers/exec-file-stub.ts +3 -1
  435. package/src/acp/__tests__/prepare-agent-env.test.ts +3 -1
  436. package/src/acp/__tests__/session-manager-persistence.test.ts +10 -10
  437. package/src/acp/__tests__/session-manager-resume.test.ts +7 -7
  438. package/src/acp/agent-process.ts +18 -6
  439. package/src/acp/auto-install.test.ts +9 -3
  440. package/src/acp/auto-install.ts +6 -2
  441. package/src/acp/client-handler.ts +3 -3
  442. package/src/acp/failure-error.ts +8 -3
  443. package/src/acp/prepare-agent-env.ts +3 -1
  444. package/src/acp/resolve-agent.test.ts +81 -27
  445. package/src/acp/resolve-agent.ts +9 -3
  446. package/src/acp/session-manager.ts +8 -8
  447. package/src/{plugins/defaults/history-repair/terminal.ts → agent/history-repair/history-repair.ts} +42 -11
  448. package/src/agent/image-optimize.ts +18 -6
  449. package/src/agent/loop.ts +45 -10
  450. package/src/api/events/message-dequeued.ts +4 -0
  451. package/src/api/events/message-queued-deleted.ts +4 -0
  452. package/src/api/events/message-queued.ts +4 -0
  453. package/src/api/events/subagent-event.ts +2 -2
  454. package/src/api/events/tool-result.ts +1 -0
  455. package/src/api/responses/memory-v2-activation-log.ts +2 -2
  456. package/src/api/responses/subagent-detail.ts +13 -0
  457. package/src/approvals/AGENTS.md +2 -0
  458. package/src/approvals/guardian-request-resolvers.ts +118 -24
  459. package/src/apps/app-store.ts +160 -26
  460. package/src/apps/shared-app-links-store.ts +9 -3
  461. package/src/avatar/__tests__/avatar-store.test.ts +6 -2
  462. package/src/avatar/avatar-manifest.ts +18 -6
  463. package/src/avatar/resvg-lazy.test.ts +6 -2
  464. package/src/background-wake/background-wake-routes.test.ts +9 -3
  465. package/src/background-wake/next-wake.ts +15 -5
  466. package/src/background-wake/platform-client.ts +18 -6
  467. package/src/background-wake/publisher.ts +3 -1
  468. package/src/backup/__tests__/paths.test.ts +0 -1
  469. package/src/backup/__tests__/restore.test.ts +1 -6
  470. package/src/backup/__tests__/snapshot-lock.test.ts +3 -2
  471. package/src/backup/list-snapshots.ts +15 -5
  472. package/src/backup/local-writer.ts +9 -3
  473. package/src/backup/paths.ts +6 -3
  474. package/src/backup/snapshot-lock.ts +18 -6
  475. package/src/browser-session/__tests__/manager.test.ts +6 -2
  476. package/src/browser-session/manager.ts +6 -2
  477. package/src/bundler/app-compiler.ts +44 -15
  478. package/src/bundler/bundle-scanner.ts +29 -10
  479. package/src/bundler/bundle-signer.ts +3 -1
  480. package/src/bundler/compiler-tools.ts +15 -5
  481. package/src/bundler/package-resolver.ts +3 -1
  482. package/src/bundler/signature-verifier.ts +3 -1
  483. package/src/calls/__tests__/inbound-trust-reader.test.ts +1 -4
  484. package/src/calls/__tests__/tts-text-sanitizer.test.ts +11 -11
  485. package/src/calls/__tests__/voice-control-protocol.test.ts +57 -0
  486. package/src/calls/__tests__/voice-session-bridge.test.ts +229 -7
  487. package/src/calls/__tests__/voice-triage-escalate.test.ts +3 -4
  488. package/src/calls/access-request-wait.ts +9 -3
  489. package/src/calls/audio-store.ts +9 -3
  490. package/src/calls/call-constants.ts +6 -2
  491. package/src/calls/call-controller.ts +74 -27
  492. package/src/calls/call-conversation-messages.ts +58 -18
  493. package/src/calls/call-pointer-message-composer.ts +11 -4
  494. package/src/calls/call-pointer-messages.ts +24 -8
  495. package/src/calls/call-store.ts +12 -4
  496. package/src/calls/guardian-action-sweep.ts +3 -1
  497. package/src/calls/inbound-trust-reader.ts +5 -1
  498. package/src/calls/media-stream-audio-transcode.ts +9 -3
  499. package/src/calls/media-stream-output.ts +41 -15
  500. package/src/calls/media-stream-stt-session.ts +21 -7
  501. package/src/calls/media-turn-detector.ts +9 -3
  502. package/src/calls/speaker-identification.ts +21 -7
  503. package/src/calls/telephony-credential-preflight.ts +1 -3
  504. package/src/calls/tts-text-sanitizer.ts +2 -8
  505. package/src/calls/twilio-config.ts +3 -1
  506. package/src/calls/twilio-provider.ts +3 -1
  507. package/src/calls/twilio-rest.ts +3 -1
  508. package/src/calls/voice-control-protocol.ts +68 -4
  509. package/src/calls/voice-session-bridge.ts +178 -65
  510. package/src/calls/voice-triage-escalate.ts +2 -3
  511. package/src/channels/__tests__/gateway-verification-sessions.test.ts +2 -3
  512. package/src/channels/config.ts +8 -0
  513. package/src/channels/permission-profiles.ts +9 -3
  514. package/src/channels/slack-callback-url.ts +9 -3
  515. package/src/channels/types.ts +18 -6
  516. package/src/cli/__tests__/run-assistant-command.ts +3 -1
  517. package/src/cli/__tests__/unknown-command.test.ts +3 -1
  518. package/src/cli/commands/__tests__/attachment.test.ts +3 -1
  519. package/src/cli/commands/__tests__/avatar.test.ts +18 -10
  520. package/src/cli/commands/__tests__/backup.test.ts +30 -10
  521. package/src/cli/commands/__tests__/browser.test.ts +3 -1
  522. package/src/cli/commands/__tests__/cache.test.ts +3 -1
  523. package/src/cli/commands/__tests__/changelog.test.ts +3 -1
  524. package/src/cli/commands/__tests__/channel-verification-sessions.test.ts +11 -6
  525. package/src/cli/commands/__tests__/conversations-import.test.ts +3 -1
  526. package/src/cli/commands/__tests__/conversations-new.test.ts +9 -3
  527. package/src/cli/commands/__tests__/conversations-slack.test.ts +15 -5
  528. package/src/cli/commands/__tests__/conversations-wake.test.ts +13 -3
  529. package/src/cli/commands/__tests__/domain-register.test.ts +1 -3
  530. package/src/cli/commands/__tests__/domain-status.test.ts +13 -5
  531. package/src/cli/commands/__tests__/email-attachment.test.ts +61 -19
  532. package/src/cli/commands/__tests__/email-core.test.ts +126 -49
  533. package/src/cli/commands/__tests__/gateway.test.ts +6 -2
  534. package/src/cli/commands/__tests__/image-generation.test.ts +5 -2
  535. package/src/cli/commands/__tests__/inference-send.test.ts +3 -1
  536. package/src/cli/commands/__tests__/skills.test.ts +3 -1
  537. package/src/cli/commands/__tests__/status.test.ts +16 -3
  538. package/src/cli/commands/__tests__/stt.test.ts +23 -5
  539. package/src/cli/commands/__tests__/trust.test.ts +3 -1
  540. package/src/cli/commands/__tests__/tts.test.ts +6 -2
  541. package/src/cli/commands/__tests__/ui-confirm.test.ts +3 -1
  542. package/src/cli/commands/__tests__/ui.test.ts +3 -1
  543. package/src/cli/commands/__tests__/watchers.test.ts +3 -1
  544. package/src/cli/commands/__tests__/webhooks.test.ts +23 -5
  545. package/src/cli/commands/audit.ts +7 -3
  546. package/src/cli/commands/avatar.ts +14 -7
  547. package/src/cli/commands/backup.ts +42 -17
  548. package/src/cli/commands/cache.ts +9 -3
  549. package/src/cli/commands/changelog.ts +50 -18
  550. package/src/cli/commands/channel-verification-sessions.ts +25 -10
  551. package/src/cli/commands/channels/__tests__/channels.test.ts +8 -13
  552. package/src/cli/commands/channels/index.ts +12 -4
  553. package/src/cli/commands/clients.ts +12 -4
  554. package/src/cli/commands/config.ts +49 -13
  555. package/src/cli/commands/contacts.ts +28 -12
  556. package/src/cli/commands/conversations-import.ts +2 -1
  557. package/src/cli/commands/conversations.ts +12 -4
  558. package/src/cli/commands/db/__tests__/repair.test.ts +6 -2
  559. package/src/cli/commands/db/format.ts +18 -6
  560. package/src/cli/commands/db/repair-steps.ts +3 -1
  561. package/src/cli/commands/db/status.ts +6 -2
  562. package/src/cli/commands/gateway.ts +25 -9
  563. package/src/cli/commands/image-generation.ts +5 -2
  564. package/src/cli/commands/inference-session.ts +6 -2
  565. package/src/cli/commands/memory/__tests__/memory-v2.test.ts +3 -1
  566. package/src/cli/commands/memory/__tests__/memory-v3.test.ts +3 -1
  567. package/src/cli/commands/memory/__tests__/worker.test.ts +3 -1
  568. package/src/cli/commands/memory/index.help.ts +4 -2
  569. package/src/cli/commands/memory/memory-retrospective.ts +5 -0
  570. package/src/cli/commands/memory/memory-v2-compare-render.ts +3 -1
  571. package/src/cli/commands/memory/memory-v2.ts +12 -4
  572. package/src/cli/commands/memory/memory-v3.ts +3 -1
  573. package/src/cli/commands/notifications.ts +56 -19
  574. package/src/cli/commands/oauth/apps.ts +15 -5
  575. package/src/cli/commands/oauth/disconnect.ts +9 -3
  576. package/src/cli/commands/oauth/mode.ts +6 -2
  577. package/src/cli/commands/oauth/ping.ts +9 -3
  578. package/src/cli/commands/oauth/providers.ts +223 -92
  579. package/src/cli/commands/oauth/request.ts +26 -9
  580. package/src/cli/commands/oauth/token.ts +9 -3
  581. package/src/cli/commands/platform/__tests__/callback-routes-list.test.ts +7 -8
  582. package/src/cli/commands/platform/connect.ts +2 -1
  583. package/src/cli/commands/platform/disconnect.ts +2 -1
  584. package/src/cli/commands/platform/index.ts +8 -4
  585. package/src/cli/commands/ps.ts +3 -1
  586. package/src/cli/commands/sequence.ts +43 -15
  587. package/src/cli/commands/skills.ts +103 -45
  588. package/src/cli/commands/status.ts +3 -1
  589. package/src/cli/commands/telemetry.ts +2 -1
  590. package/src/cli/commands/ui.ts +6 -2
  591. package/src/cli/commands/watchers.ts +31 -11
  592. package/src/cli/commands/webhooks.help.ts +9 -4
  593. package/src/cli/commands/webhooks.ts +4 -2
  594. package/src/cli/lib/__tests__/inspect-plugin.test.ts +3 -1
  595. package/src/cli/lib/__tests__/list-installed-plugins.test.ts +4 -2
  596. package/src/cli/lib/__tests__/plugin-catalog-cache.test.ts +5 -2
  597. package/src/cli/lib/__tests__/plugin-catalog-resolve.test.ts +20 -11
  598. package/src/cli/lib/__tests__/plugin-details.test.ts +13 -7
  599. package/src/cli/lib/__tests__/plugin-pin-history.test.ts +3 -1
  600. package/src/cli/lib/__tests__/plugins-install-offline.test.ts +17 -5
  601. package/src/cli/lib/__tests__/search-plugins.test.ts +13 -6
  602. package/src/cli/lib/__tests__/upgrade-plugin.test.ts +9 -3
  603. package/src/cli/lib/bundled-marketplace.json +12 -0
  604. package/src/cli/lib/cli-colors.ts +24 -8
  605. package/src/cli/lib/confirm-prompt.ts +3 -1
  606. package/src/cli/lib/install-from-github.ts +6 -2
  607. package/src/cli/lib/ipc-params.ts +6 -2
  608. package/src/cli/lib/list-installed-plugins.ts +21 -7
  609. package/src/cli/lib/parse-github-plugin-spec.ts +15 -5
  610. package/src/cli/lib/plugin-artifact.ts +9 -3
  611. package/src/cli/lib/plugin-catalog-platform.ts +7 -2
  612. package/src/cli/lib/plugin-catalog-resolve.ts +7 -5
  613. package/src/cli/lib/plugin-marketplace.ts +12 -4
  614. package/src/cli/lib/plugin-surfaces.ts +15 -5
  615. package/src/cli/lib/publish-plugin.ts +24 -8
  616. package/src/cli/lib/search-plugins.ts +3 -1
  617. package/src/cli/lib/time-ago.ts +18 -6
  618. package/src/cli/lib/unknown-command.ts +12 -4
  619. package/src/cli/output.ts +3 -1
  620. package/src/cli/program.ts +3 -1
  621. package/src/cli/utils/__tests__/conversation-id.test.ts +3 -3
  622. package/src/cli/utils/conversation-id.ts +9 -3
  623. package/src/cli/utils/parse-duration.ts +6 -2
  624. package/src/cli.ts +2 -109
  625. package/src/config/__tests__/deployment-context-defaults.test.ts +18 -3
  626. package/src/config/__tests__/feature-flag-registry-guard.test.ts +7 -2
  627. package/src/config/__tests__/loader-callsite-strip-fallback.test.ts +9 -3
  628. package/src/config/__tests__/plugin-resident-skill-discovery.test.ts +5 -2
  629. package/src/config/__tests__/substrate-twin-shadowing.test.ts +191 -0
  630. package/src/config/__tests__/sync-gated-profiles.test.ts +6 -2
  631. package/src/config/__tests__/webhook-routing.test.ts +229 -0
  632. package/src/config/assistant-feature-flags.ts +33 -12
  633. package/src/config/bundled-skills/app-builder/SKILL.md +3 -3
  634. package/src/config/bundled-skills/app-builder/references/CUSTOM_ROUTES.md +24 -34
  635. package/src/config/bundled-skills/app-builder/references/DESIGN_SYSTEM.md +1 -1
  636. package/src/config/bundled-skills/app-builder/references/SLIDES.md +1 -0
  637. package/src/config/bundled-skills/app-builder/references/WIDGETS.md +1 -1
  638. package/src/config/bundled-skills/app-builder/tools/app-generate-icon.ts +3 -1
  639. package/src/config/bundled-skills/app-builder/tools/app-refresh.ts +3 -1
  640. package/src/config/bundled-skills/app-builder/tools/app-update.ts +3 -1
  641. package/src/config/bundled-skills/contacts/tools/contact-search.ts +11 -4
  642. package/src/config/bundled-skills/contacts/tools/google-contacts.ts +6 -2
  643. package/src/config/bundled-skills/conversation-groups/SKILL.md +29 -0
  644. package/src/config/bundled-skills/conversation-groups/TOOLS.json +58 -0
  645. package/src/config/bundled-skills/conversation-groups/tools/group-create.ts +12 -0
  646. package/src/config/bundled-skills/conversation-groups/tools/group-list.ts +12 -0
  647. package/src/config/bundled-skills/conversation-groups/tools/move-to-group.ts +12 -0
  648. package/src/config/bundled-skills/image-studio/tools/media-generate-image.ts +13 -7
  649. package/src/config/bundled-skills/media-processing/__tests__/extract-keyframes.test.ts +3 -1
  650. package/src/config/bundled-skills/media-processing/services/preprocess.ts +9 -3
  651. package/src/config/bundled-skills/media-processing/services/processing-pipeline.ts +9 -3
  652. package/src/config/bundled-skills/media-processing/services/reduce.ts +3 -1
  653. package/src/config/bundled-skills/media-processing/tools/generate-clip.ts +3 -1
  654. package/src/config/bundled-skills/media-processing/tools/ingest-media.ts +12 -4
  655. package/src/config/bundled-skills/messaging/SKILL.md +2 -2
  656. package/src/config/bundled-skills/messaging/tools/messaging-analyze-style.ts +6 -2
  657. package/src/config/bundled-skills/messaging/tools/messaging-draft.ts +23 -8
  658. package/src/config/bundled-skills/messaging/tools/messaging-send.ts +5 -2
  659. package/src/config/bundled-skills/messaging/tools/shared.ts +21 -7
  660. package/src/config/bundled-skills/phone-calls/references/TRANSCRIPTS.md +7 -7
  661. package/src/config/bundled-skills/playbooks/tools/playbook-list.ts +11 -4
  662. package/src/config/bundled-skills/schedule/SKILL.md +6 -0
  663. package/src/config/bundled-skills/schedule/TOOLS.json +8 -0
  664. package/src/config/bundled-skills/sequences/tools/sequence-create.ts +8 -3
  665. package/src/config/bundled-skills/sequences/tools/sequence-delete.ts +6 -2
  666. package/src/config/bundled-skills/sequences/tools/sequence-enroll.ts +12 -4
  667. package/src/config/bundled-skills/sequences/tools/sequence-enrollment-list.ts +3 -1
  668. package/src/config/bundled-skills/sequences/tools/sequence-get.ts +6 -2
  669. package/src/config/bundled-skills/sequences/tools/sequence-import.ts +13 -5
  670. package/src/config/bundled-skills/sequences/tools/sequence-list.ts +3 -1
  671. package/src/config/bundled-skills/sequences/tools/sequence-update.ts +17 -7
  672. package/src/config/bundled-skills/transcribe/tools/transcribe-media.test.ts +3 -1
  673. package/src/config/bundled-skills/transcribe/tools/transcribe-media.ts +15 -5
  674. package/src/config/default-profile-catalog.ts +4 -1
  675. package/src/config/env-registry.ts +3 -1
  676. package/src/config/env.ts +6 -2
  677. package/src/config/feature-flag-cache.ts +6 -16
  678. package/src/config/feature-flag-registry.json +14 -38
  679. package/src/config/llm-resolver.ts +4 -4
  680. package/src/config/loader.ts +49 -15
  681. package/src/config/memory-tier.ts +15 -10
  682. package/src/config/memory-v3-gate.test.ts +278 -1
  683. package/src/config/memory-v3-gate.ts +88 -26
  684. package/src/config/prune-seeded-callsite-defaults.ts +30 -10
  685. package/src/config/raw-config-utils.ts +1 -1
  686. package/src/config/schema-utils.ts +9 -3
  687. package/src/config/schemas/__tests__/live-voice.test.ts +27 -16
  688. package/src/config/schemas/__tests__/memory-v3.test.ts +1 -0
  689. package/src/config/schemas/live-voice.ts +33 -7
  690. package/src/config/schemas/llm.ts +1 -0
  691. package/src/config/schemas/memory-retrospective.ts +13 -0
  692. package/src/config/schemas/memory-substrate.ts +183 -0
  693. package/src/config/schemas/memory-v2.ts +3 -2
  694. package/src/config/schemas/memory-v3.ts +11 -4
  695. package/src/config/schemas/memory.ts +35 -1
  696. package/src/config/schemas/services.ts +10 -2
  697. package/src/config/seed-inference-profiles.ts +27 -9
  698. package/src/config/skills.ts +93 -31
  699. package/src/config/substrate-twin-shadowing.ts +195 -0
  700. package/src/config/sync-gated-profiles.ts +21 -7
  701. package/src/config/webhook-routing.ts +108 -0
  702. package/src/contacts/__tests__/guardian-contact-reader.test.ts +3 -1
  703. package/src/contacts/contact-store.ts +106 -37
  704. package/src/contacts/guardian-contact-reader.ts +3 -1
  705. package/src/contacts/guardian-delivery-reader.ts +15 -5
  706. package/src/context/compactor.ts +106 -35
  707. package/src/context/estimator-calibration.ts +9 -3
  708. package/src/context/image-dimensions.ts +75 -25
  709. package/src/context/post-turn-tool-result-truncation.ts +158 -23
  710. package/src/context/strip-injections.ts +15 -5
  711. package/src/context/token-estimator.ts +24 -1
  712. package/src/context/tool-result-spool.ts +3 -1
  713. package/src/context/tool-result-truncation.ts +6 -2
  714. package/src/conversations/job-handlers/summarization.ts +12 -4
  715. package/src/credential-execution/ces-runtime.ts +10 -10
  716. package/src/credential-execution/process-manager.test.ts +3 -1
  717. package/src/credential-execution/process-manager.ts +6 -2
  718. package/src/credential-health/credential-health-service.ts +30 -10
  719. package/src/daemon/__tests__/channel-ui-capability.test.ts +85 -0
  720. package/src/daemon/__tests__/conversation-surfaces-launch.test.ts +3 -3
  721. package/src/daemon/__tests__/embedding-reconcile.test.ts +5 -3
  722. package/src/daemon/__tests__/inference-profile-notification.test.ts +3 -6
  723. package/src/daemon/__tests__/native-web-search-metadata.test.ts +5 -5
  724. package/src/daemon/__tests__/web-search-status-text.test.ts +2 -2
  725. package/src/daemon/app-source-watcher.ts +21 -7
  726. package/src/daemon/assistant-attachments.ts +44 -15
  727. package/src/daemon/channel-ui-capability.ts +70 -1
  728. package/src/daemon/classifier.ts +9 -3
  729. package/src/daemon/connection-policy.ts +6 -2
  730. package/src/daemon/conversation-agent-loop-handlers.ts +4 -4
  731. package/src/daemon/conversation-agent-loop.ts +22 -6
  732. package/src/daemon/conversation-error.ts +4 -4
  733. package/src/daemon/conversation-evictor.ts +38 -8
  734. package/src/daemon/conversation-launch.ts +11 -14
  735. package/src/daemon/conversation-lineage.ts +76 -0
  736. package/src/daemon/conversation-media-retry.ts +18 -6
  737. package/src/daemon/conversation-messaging.ts +60 -17
  738. package/src/daemon/conversation-notices.ts +6 -2
  739. package/src/daemon/conversation-notifiers.ts +2 -2
  740. package/src/daemon/conversation-plugin-scope.ts +3 -1
  741. package/src/daemon/conversation-process.ts +135 -21
  742. package/src/daemon/conversation-queue-manager.ts +18 -10
  743. package/src/daemon/conversation-registry.ts +9 -3
  744. package/src/daemon/conversation-runtime-assembly.ts +22 -2
  745. package/src/daemon/conversation-slash.ts +50 -17
  746. package/src/daemon/conversation-store.ts +11 -3
  747. package/src/daemon/conversation-surfaces.ts +10 -21
  748. package/src/daemon/conversation-tool-setup.ts +13 -7
  749. package/src/daemon/conversation-usage.ts +30 -11
  750. package/src/daemon/conversation-workspace.ts +5 -2
  751. package/src/daemon/conversation.ts +39 -16
  752. package/src/daemon/daemon-control.ts +42 -14
  753. package/src/daemon/date-context.ts +15 -5
  754. package/src/daemon/dictation-profile-store.ts +26 -10
  755. package/src/daemon/dictation-text-processing.ts +9 -3
  756. package/src/daemon/disk-pressure-guard.ts +17 -16
  757. package/src/daemon/disk-pressure-policy.ts +15 -5
  758. package/src/daemon/embedding-reconcile.ts +14 -9
  759. package/src/daemon/first-greeting.ts +9 -3
  760. package/src/daemon/handlers/__tests__/config-channels.test.ts +9 -3
  761. package/src/daemon/handlers/config-channels.ts +43 -135
  762. package/src/daemon/handlers/config-model.ts +15 -7
  763. package/src/daemon/handlers/config-telegram.ts +12 -7
  764. package/src/daemon/handlers/conversations.ts +10 -4
  765. package/src/daemon/handlers/identity.ts +6 -2
  766. package/src/daemon/handlers/shared.ts +29 -0
  767. package/src/daemon/handlers/skills.ts +138 -48
  768. package/src/daemon/host-app-control-proxy.ts +3 -1
  769. package/src/daemon/host-bash-proxy.ts +11 -4
  770. package/src/daemon/host-cu-proxy.ts +20 -7
  771. package/src/daemon/host-proxy-base.ts +4 -4
  772. package/src/daemon/host-transfer-proxy.ts +24 -8
  773. package/src/daemon/identity-helpers.ts +3 -1
  774. package/src/daemon/install-symlink.ts +18 -6
  775. package/src/daemon/lifecycle.ts +13 -0
  776. package/src/daemon/message-protocol.ts +8 -144
  777. package/src/daemon/message-types/computer-use.ts +0 -12
  778. package/src/daemon/message-types/conversations.ts +9 -345
  779. package/src/daemon/message-types/host-app-control.ts +0 -9
  780. package/src/daemon/message-types/host-browser.ts +0 -7
  781. package/src/daemon/message-types/host-ui-snapshot.ts +0 -7
  782. package/src/daemon/message-types/messages.ts +0 -48
  783. package/src/daemon/message-types/notifications.ts +0 -7
  784. package/src/daemon/message-types/skills.ts +0 -5
  785. package/src/daemon/message-types/surfaces.ts +0 -9
  786. package/src/daemon/message-types/sync.ts +0 -2
  787. package/src/daemon/message-types/web-activity.ts +1 -0
  788. package/src/daemon/now-scratchpad.ts +3 -1
  789. package/src/daemon/orphan-reaper.test.ts +17 -6
  790. package/src/daemon/orphan-reaper.ts +24 -8
  791. package/src/daemon/parse-actual-tokens-from-error.ts +27 -9
  792. package/src/daemon/persist-media-references.ts +6 -2
  793. package/src/daemon/pkb-context-tracker.test.ts +37 -9
  794. package/src/daemon/pkb-context-tracker.ts +12 -4
  795. package/src/daemon/pointer-conversation-trust.ts +3 -1
  796. package/src/daemon/process-message.ts +7 -5
  797. package/src/daemon/profiler-run-store.ts +21 -7
  798. package/src/daemon/skill-memory-refresh.ts +5 -5
  799. package/src/daemon/sqlite-corruption-watchdog.ts +6 -2
  800. package/src/daemon/summarize-boundary.ts +3 -1
  801. package/src/daemon/tool-side-effects.ts +32 -16
  802. package/src/daemon/trust-context.ts +1 -1
  803. package/src/daemon/turn-latency-tracker.ts +33 -11
  804. package/src/daemon/verification-session-intent.ts +3 -1
  805. package/src/daemon/wake-conversation-ops.ts +6 -4
  806. package/src/daemon/web-search-history.ts +12 -4
  807. package/src/documents/document-store.ts +15 -5
  808. package/src/followups/followup-store.ts +9 -3
  809. package/src/heartbeat/__tests__/heartbeat-run-store.test.ts +100 -7
  810. package/src/heartbeat/__tests__/heartbeat-service.test.ts +67 -0
  811. package/src/heartbeat/heartbeat-run-store.ts +84 -5
  812. package/src/heartbeat/heartbeat-service.ts +32 -1
  813. package/src/home/__tests__/feed-writer.test.ts +7 -7
  814. package/src/home/__tests__/home-content-refresh.test.ts +3 -0
  815. package/src/home/__tests__/suggested-prompts.test.ts +1 -0
  816. package/src/home/conversation-starter-checkpoints.ts +3 -1
  817. package/src/home/feed-source-enrichment.ts +6 -2
  818. package/src/home/feed-writer.ts +33 -22
  819. package/src/home/home-content-refresh.ts +6 -9
  820. package/src/home/home-greeting-cache.ts +3 -1
  821. package/src/home/job-handlers/conversation-starters.ts +15 -5
  822. package/src/home/post-connect-feed.ts +3 -1
  823. package/src/home/progress-formula.ts +6 -2
  824. package/src/home/relationship-state-writer.ts +83 -37
  825. package/src/home/suggested-prompts-cache.ts +6 -19
  826. package/src/inbound/platform-callback-registration.ts +44 -10
  827. package/src/inbound/public-ingress-urls.ts +40 -9
  828. package/src/ipc/__tests__/events-publish-client.test.ts +67 -0
  829. package/src/ipc/__tests__/exit-helper.test.ts +12 -8
  830. package/src/ipc/__tests__/streaming-client.test.ts +52 -15
  831. package/src/ipc/__tests__/streaming-framing.test.ts +27 -7
  832. package/src/ipc/__tests__/ui-request-route.test.ts +3 -1
  833. package/src/ipc/__tests__/watcher-ipc.test.ts +6 -2
  834. package/src/ipc/assistant-server.ts +6 -2
  835. package/src/ipc/cli-client.ts +36 -12
  836. package/src/ipc/events-publish-client.ts +44 -0
  837. package/src/ipc/gateway-client.ts +6 -2
  838. package/src/ipc/gateway-flag-listener.ts +9 -3
  839. package/src/ipc/ipc-framing.ts +21 -7
  840. package/src/ipc/routes/__tests__/contacts-mirror-apply-atomicity.test.ts +7 -4
  841. package/src/ipc/routes/__tests__/contacts-mirror-apply.test.ts +22 -10
  842. package/src/ipc/routes/__tests__/contacts-mirror-ipc-routes.test.ts +26 -13
  843. package/src/ipc/routes/__tests__/contacts-mirror-merge-contact.test.ts +35 -9
  844. package/src/ipc/routes/__tests__/contacts-mirror-upsert-full.test.ts +37 -20
  845. package/src/ipc/routes/__tests__/conversation-sync-ipc-routes.test.ts +2 -2
  846. package/src/ipc/routes/__tests__/events-ipc-routes.test.ts +38 -9
  847. package/src/ipc/routes/__tests__/guardian-label-ipc-routes.test.ts +4 -6
  848. package/src/ipc/routes/contacts-info-ipc-routes.ts +9 -6
  849. package/src/ipc/routes/events-ipc-routes.ts +11 -31
  850. package/src/ipc/routes/trust-rules.test.ts +6 -2
  851. package/src/ipc/socket-cleanup.ts +6 -2
  852. package/src/live-voice/__tests__/front-decision.test.ts +4 -176
  853. package/src/live-voice/__tests__/live-voice-agent-turn.test.ts +276 -68
  854. package/src/live-voice/__tests__/live-voice-archive.test.ts +24 -8
  855. package/src/live-voice/__tests__/live-voice-continuation-fork-hydration.test.ts +286 -0
  856. package/src/live-voice/__tests__/live-voice-events.test.ts +6 -3
  857. package/src/live-voice/__tests__/live-voice-progress.test.ts +185 -46
  858. package/src/live-voice/__tests__/live-voice-stt.test.ts +9 -3
  859. package/src/live-voice/__tests__/live-voice-triage-escalate.test.ts +24 -59
  860. package/src/live-voice/__tests__/live-voice-tts-session.test.ts +38 -54
  861. package/src/live-voice/__tests__/live-voice-vad.test.ts +1154 -636
  862. package/src/live-voice/__tests__/protocol.test.ts +45 -15
  863. package/src/live-voice/__tests__/runtime-websocket-shell.test.ts +6 -2
  864. package/src/live-voice/front-decision.ts +5 -155
  865. package/src/live-voice/live-voice-archive.ts +18 -6
  866. package/src/live-voice/live-voice-metrics.ts +28 -9
  867. package/src/live-voice/live-voice-session.ts +1288 -439
  868. package/src/live-voice/progress-phrases.ts +17 -0
  869. package/src/live-voice/protocol.ts +21 -2
  870. package/src/mcp/client.ts +9 -3
  871. package/src/mcp/manager.ts +3 -1
  872. package/src/mcp/mcp-auth-orchestrator.ts +3 -1
  873. package/src/mcp/mcp-header-store.ts +3 -1
  874. package/src/mcp/mcp-oauth-provider.ts +12 -4
  875. package/src/media/app-icon-generator.ts +15 -8
  876. package/src/media/avatar-router.ts +9 -5
  877. package/src/media/gemini-image-service.ts +15 -5
  878. package/src/media/image-credentials.ts +42 -10
  879. package/src/media/image-service.ts +1 -13
  880. package/src/media/openai-image-service.ts +9 -3
  881. package/src/media/types.ts +26 -3
  882. package/src/messaging/draft-store.ts +3 -1
  883. package/src/messaging/providers/__tests__/transport-dispatch.test.ts +3 -1
  884. package/src/messaging/providers/a2a/__tests__/deliver.test.ts +3 -1
  885. package/src/messaging/providers/a2a/deliver.ts +3 -1
  886. package/src/messaging/providers/callback-routing.ts +3 -1
  887. package/src/messaging/providers/gmail/adapter.ts +36 -12
  888. package/src/messaging/providers/gmail/client.ts +71 -24
  889. package/src/messaging/providers/gmail/mime-builder.ts +6 -2
  890. package/src/messaging/providers/gmail/people-client.ts +3 -1
  891. package/src/messaging/providers/outlook/client.ts +30 -10
  892. package/src/messaging/providers/slack/__tests__/adapter-token-routing.test.ts +15 -6
  893. package/src/messaging/providers/slack/adapter.ts +51 -17
  894. package/src/messaging/providers/slack/api.ts +39 -13
  895. package/src/messaging/providers/slack/binding-metadata.test.ts +37 -8
  896. package/src/messaging/providers/slack/binding-metadata.ts +21 -21
  897. package/src/messaging/providers/slack/client.ts +9 -3
  898. package/src/messaging/providers/slack/deep-link.test.ts +91 -0
  899. package/src/messaging/providers/slack/deep-link.ts +42 -13
  900. package/src/messaging/providers/slack/message-metadata.ts +21 -7
  901. package/src/messaging/providers/slack/render-transcript.ts +54 -18
  902. package/src/messaging/providers/slack/render.ts +50 -17
  903. package/src/messaging/providers/slack/transport.ts +9 -3
  904. package/src/messaging/providers/telegram-bot/adapter.ts +6 -2
  905. package/src/messaging/providers/telegram-bot/api.ts +3 -1
  906. package/src/messaging/providers/telegram-bot/render.ts +33 -11
  907. package/src/messaging/providers/telegram-bot/send.ts +3 -1
  908. package/src/messaging/providers/whatsapp/adapter.ts +3 -1
  909. package/src/messaging/providers/whatsapp/api.ts +9 -3
  910. package/src/messaging/registry.ts +3 -1
  911. package/src/messaging/style-analyzer.ts +3 -1
  912. package/src/monitoring/__tests__/db-integrity-sample.test.ts +96 -0
  913. package/src/monitoring/__tests__/sample-ring-buffer.test.ts +12 -4
  914. package/src/monitoring/db-integrity-check.ts +163 -0
  915. package/src/monitoring/db-integrity-sample.ts +171 -0
  916. package/src/monitoring/process-memory.ts +2 -1
  917. package/src/monitoring/sample-ring-buffer.ts +15 -5
  918. package/src/monitoring/worker.ts +12 -0
  919. package/src/notifications/AGENTS.md +2 -0
  920. package/src/notifications/__tests__/broadcaster.test.ts +95 -0
  921. package/src/notifications/adapters/macos.ts +3 -3
  922. package/src/notifications/adapters/platform.ts +6 -7
  923. package/src/notifications/adapters/shared.ts +9 -3
  924. package/src/notifications/broadcaster.ts +57 -0
  925. package/src/notifications/conversation-candidates.ts +21 -7
  926. package/src/notifications/conversation-seed-composer.ts +21 -7
  927. package/src/notifications/copy-composer.ts +12 -19
  928. package/src/notifications/decision-engine.ts +21 -22
  929. package/src/notifications/decisions-store.ts +6 -2
  930. package/src/notifications/deferred-emit.ts +18 -6
  931. package/src/notifications/deliveries-store.ts +3 -1
  932. package/src/notifications/destination-resolver.ts +12 -6
  933. package/src/notifications/deterministic-checks.ts +6 -2
  934. package/src/notifications/edit-notification.ts +3 -1
  935. package/src/notifications/events-store.ts +3 -1
  936. package/src/notifications/guardian-question-mode.ts +72 -7
  937. package/src/notifications/home-feed-side-effect.ts +16 -4
  938. package/src/notifications/notification-utils.ts +8 -3
  939. package/src/notifications/preference-extractor.ts +5 -2
  940. package/src/notifications/preference-summary.ts +3 -1
  941. package/src/notifications/signal.ts +6 -4
  942. package/src/notifications/trusted-contact-payloads.ts +3 -4
  943. package/src/notifications/vellum-card-affinity.ts +39 -0
  944. package/src/oauth/AGENTS.md +1 -1
  945. package/src/oauth/__tests__/oauth-connect-state.test.ts +4 -1
  946. package/src/oauth/byo-connection.test.ts +15 -5
  947. package/src/oauth/byo-connection.ts +6 -2
  948. package/src/oauth/connect-orchestrator.ts +3 -1
  949. package/src/oauth/connection-resolver.test.ts +6 -2
  950. package/src/oauth/connection-resolver.ts +12 -4
  951. package/src/oauth/identity-verifier.ts +30 -10
  952. package/src/oauth/manual-token-connection.ts +12 -4
  953. package/src/oauth/oauth-connect-state.ts +15 -3
  954. package/src/oauth/oauth-store.ts +132 -52
  955. package/src/oauth/provider-serializer.ts +9 -3
  956. package/src/oauth/provider-visibility.ts +3 -1
  957. package/src/oauth/scope-utils.ts +3 -1
  958. package/src/onboarding/checkin-event.ts +33 -11
  959. package/src/outbound-proxy/certs.ts +6 -2
  960. package/src/outbound-proxy/connect-tunnel.ts +15 -5
  961. package/src/outbound-proxy/host-pattern-match.ts +3 -1
  962. package/src/outbound-proxy/http-forwarder.ts +9 -3
  963. package/src/outbound-proxy/logging.ts +6 -2
  964. package/src/outbound-proxy/mitm-handler.ts +9 -3
  965. package/src/outbound-proxy/policy.ts +12 -4
  966. package/src/outbound-proxy/router.ts +3 -1
  967. package/src/outbound-proxy/server.ts +15 -5
  968. package/src/permissions/approval-provenance.test.ts +13 -4
  969. package/src/permissions/channel-permission-query.test.ts +69 -0
  970. package/src/permissions/channel-permission-query.ts +73 -1
  971. package/src/permissions/checker.test.ts +298 -15
  972. package/src/permissions/checker.ts +102 -36
  973. package/src/permissions/confirmation-guardian-request.test.ts +2 -2
  974. package/src/permissions/confirmation-guardian-request.ts +2 -2
  975. package/src/permissions/gateway-threshold-reader.test.ts +224 -17
  976. package/src/permissions/gateway-threshold-reader.ts +82 -10
  977. package/src/permissions/ipc-risk-types.ts +8 -0
  978. package/src/permissions/prompter.ts +5 -5
  979. package/src/permissions/question-guardian-request.test.ts +222 -0
  980. package/src/permissions/question-guardian-request.ts +179 -0
  981. package/src/permissions/question-prompter.test.ts +16 -8
  982. package/src/permissions/question-prompter.ts +24 -2
  983. package/src/permissions/secret-prompter.ts +2 -4
  984. package/src/permissions/workspace-policy.ts +269 -34
  985. package/src/persistence/__tests__/lifecycle-quiesce.test.ts +82 -0
  986. package/src/persistence/__tests__/message-content-file.test.ts +58 -3
  987. package/src/persistence/__tests__/raw-query-telemetry.test.ts +3 -1
  988. package/src/persistence/a2a-invite-store.ts +1 -4
  989. package/src/persistence/attachments-store.ts +60 -20
  990. package/src/persistence/bookmark-crud.ts +6 -2
  991. package/src/persistence/compaction-ledger-store.ts +6 -2
  992. package/src/persistence/compaction-log-store-clickhouse.ts +29 -10
  993. package/src/persistence/conversation-attention-store.ts +3 -1
  994. package/src/persistence/conversation-crud.ts +93 -0
  995. package/src/persistence/conversation-directories.ts +9 -3
  996. package/src/persistence/conversation-group-migration.ts +17 -1
  997. package/src/persistence/conversation-key-store.ts +66 -1
  998. package/src/persistence/conversation-parent.ts +27 -0
  999. package/src/persistence/conversation-queries.ts +25 -2
  1000. package/src/persistence/conversation-search-lexical.ts +3 -1
  1001. package/src/persistence/db-async-query.ts +10 -4
  1002. package/src/persistence/db-singleton.ts +14 -27
  1003. package/src/persistence/delivery-channels.ts +3 -1
  1004. package/src/persistence/delivery-crud.ts +45 -0
  1005. package/src/persistence/embeddings/__tests__/embedding-identity.test.ts +9 -3
  1006. package/src/persistence/embeddings/embed.ts +21 -7
  1007. package/src/persistence/embeddings/embedding-backend.test.ts +12 -4
  1008. package/src/persistence/embeddings/embedding-backend.ts +74 -25
  1009. package/src/persistence/embeddings/embedding-billing-breaker.ts +21 -7
  1010. package/src/persistence/embeddings/embedding-cache.ts +6 -2
  1011. package/src/persistence/embeddings/embedding-gemini.ts +6 -2
  1012. package/src/persistence/embeddings/embedding-identity.ts +19 -7
  1013. package/src/persistence/embeddings/embedding-local.ts +54 -19
  1014. package/src/persistence/embeddings/embedding-ollama.ts +6 -2
  1015. package/src/persistence/embeddings/embedding-openai.ts +3 -1
  1016. package/src/persistence/embeddings/embedding-runtime-manager.ts +25 -9
  1017. package/src/persistence/embeddings/embedding-types.ts +3 -1
  1018. package/src/persistence/embeddings/messages-lexical-index.ts +12 -4
  1019. package/src/persistence/embeddings/qdrant-circuit-breaker.ts +6 -2
  1020. package/src/persistence/embeddings/qdrant-client.test.ts +10 -4
  1021. package/src/persistence/embeddings/qdrant-client.ts +24 -8
  1022. package/src/persistence/embeddings/qdrant-manager.ts +21 -7
  1023. package/src/persistence/external-conversation-store.ts +6 -2
  1024. package/src/persistence/group-crud.test.ts +59 -0
  1025. package/src/persistence/group-crud.ts +36 -11
  1026. package/src/persistence/job-handlers/cleanup.ts +23 -8
  1027. package/src/persistence/job-utils.ts +56 -35
  1028. package/src/persistence/jobs-store.ts +92 -3
  1029. package/src/persistence/lifecycle-quiesce.ts +80 -0
  1030. package/src/persistence/llm-request-log-sink-clickhouse.ts +12 -4
  1031. package/src/persistence/llm-request-log-source-clickhouse.ts +18 -6
  1032. package/src/persistence/llm-request-log-store.ts +26 -9
  1033. package/src/persistence/llm-usage-store.ts +45 -8
  1034. package/src/persistence/message-content-file.ts +4 -4
  1035. package/src/persistence/migrations/001-job-deferrals.ts +3 -1
  1036. package/src/persistence/migrations/002-tool-invocations-fk.ts +6 -2
  1037. package/src/persistence/migrations/003-memory-fts-backfill.ts +3 -1
  1038. package/src/persistence/migrations/004-entity-relation-dedup.ts +3 -1
  1039. package/src/persistence/migrations/005-fingerprint-scope-unique.ts +3 -1
  1040. package/src/persistence/migrations/006-scope-salted-fingerprints.ts +6 -2
  1041. package/src/persistence/migrations/007-assistant-id-to-self.ts +3 -1
  1042. package/src/persistence/migrations/008-remove-assistant-id-columns.ts +6 -2
  1043. package/src/persistence/migrations/009-llm-usage-events-drop-assistant-id.ts +6 -2
  1044. package/src/persistence/migrations/011-call-sessions-provider-sid-dedup.ts +9 -3
  1045. package/src/persistence/migrations/014-backfill-inbox-thread-state.ts +3 -1
  1046. package/src/persistence/migrations/015-drop-active-search-index.ts +3 -1
  1047. package/src/persistence/migrations/019-notification-tables-schema-migration.ts +3 -1
  1048. package/src/persistence/migrations/020-rename-macos-ios-channel-to-vellum.ts +3 -1
  1049. package/src/persistence/migrations/024-embedding-vector-blob.ts +6 -2
  1050. package/src/persistence/migrations/025-messages-fts-backfill.ts +3 -1
  1051. package/src/persistence/migrations/026a-embeddings-nullable-vector-json.ts +9 -3
  1052. package/src/persistence/migrations/036-normalize-phone-identities.ts +36 -12
  1053. package/src/persistence/migrations/120-fk-cascade-rebuilds.ts +12 -4
  1054. package/src/persistence/migrations/126-backfill-guardian-principal-id.ts +6 -2
  1055. package/src/persistence/migrations/127-guardian-principal-id-not-null.ts +15 -5
  1056. package/src/persistence/migrations/134-contacts-notes-column.ts +10 -4
  1057. package/src/persistence/migrations/135-backfill-contact-interaction-stats.ts +6 -2
  1058. package/src/persistence/migrations/136-drop-assistant-id-columns.ts +12 -4
  1059. package/src/persistence/migrations/140-backfill-usage-cache-accounting.ts +24 -8
  1060. package/src/persistence/migrations/141-rename-verification-table.ts +12 -4
  1061. package/src/persistence/migrations/142-rename-verification-session-id-column.ts +6 -2
  1062. package/src/persistence/migrations/147-migrate-reminders-to-schedules.ts +6 -2
  1063. package/src/persistence/migrations/150-oauth-apps-client-secret-path.ts +12 -4
  1064. package/src/persistence/migrations/157-invite-contact-id.ts +3 -1
  1065. package/src/persistence/migrations/162-guardian-timestamps-epoch-ms.ts +21 -8
  1066. package/src/persistence/migrations/174-rename-thread-starters-table.ts +12 -4
  1067. package/src/persistence/migrations/180-backfill-inline-attachments-to-disk.ts +3 -1
  1068. package/src/persistence/migrations/196-strip-integration-prefix-from-provider-keys.ts +6 -2
  1069. package/src/persistence/migrations/206-scrub-corrupted-image-attachments.ts +3 -1
  1070. package/src/persistence/migrations/209-strip-thinking-from-consolidated.ts +3 -1
  1071. package/src/persistence/migrations/220-normalize-user-file-by-principal.ts +24 -8
  1072. package/src/persistence/migrations/222-strip-placeholder-sentinels-from-messages.ts +3 -1
  1073. package/src/persistence/migrations/231-repair-memory-graph-event-dates.ts +18 -6
  1074. package/src/persistence/migrations/241-activation-state-fk-cascade.ts +6 -2
  1075. package/src/persistence/migrations/246-backfill-provider-connection-label.ts +3 -1
  1076. package/src/persistence/migrations/247-external-conversation-binding-thread-id.ts +3 -1
  1077. package/src/persistence/migrations/249-normalize-slack-external-content.ts +30 -10
  1078. package/src/persistence/migrations/256-memory-v2-injection-events.ts +24 -8
  1079. package/src/persistence/migrations/296-rewrite-balanced-economy-profile-pins.test.ts +3 -1
  1080. package/src/persistence/migrations/296-rewrite-balanced-economy-profile-pins.ts +6 -2
  1081. package/src/persistence/migrations/297-move-llm-request-logs-to-logs-db.ts +3 -1
  1082. package/src/persistence/migrations/302-create-compaction-events.ts +3 -1
  1083. package/src/persistence/migrations/306-rewrite-frontier-profile-pins.test.ts +3 -1
  1084. package/src/persistence/migrations/306-rewrite-frontier-profile-pins.ts +6 -2
  1085. package/src/persistence/migrations/318-drop-contact-channel-telemetry.ts +3 -1
  1086. package/src/persistence/migrations/319-remove-legacy-managed-connections.ts +3 -1
  1087. package/src/persistence/migrations/329-move-onboarding-events-to-telemetry-db.ts +3 -1
  1088. package/src/persistence/migrations/336-move-memory-v2-activation-logs-to-memory-db.ts +1 -1
  1089. package/src/persistence/migrations/342-add-conversation-parent-id.test.ts +1 -3
  1090. package/src/persistence/migrations/351-schedule-skill-script-handoff.ts +39 -0
  1091. package/src/persistence/migrations/352-drop-schedule-skill-script-handoff.test.ts +83 -0
  1092. package/src/persistence/migrations/352-drop-schedule-skill-script-handoff.ts +38 -0
  1093. package/src/persistence/migrations/353-add-llm-usage-conversation-type.test.ts +110 -0
  1094. package/src/persistence/migrations/353-add-llm-usage-conversation-type.ts +49 -0
  1095. package/src/persistence/migrations/354-backfill-app-conversation-lineage.ts +41 -0
  1096. package/src/persistence/migrations/355-add-schedule-group-id.ts +22 -0
  1097. package/src/persistence/migrations/__tests__/350-conversations-total-input-tokens-nullable.test.ts +3 -1
  1098. package/src/persistence/migrations/run-migrations.ts +12 -4
  1099. package/src/persistence/migrations/validate-migration-state.ts +12 -4
  1100. package/src/persistence/raw-query.ts +9 -3
  1101. package/src/persistence/schema/conversation-groups.ts +2 -0
  1102. package/src/persistence/schema/infrastructure.ts +12 -0
  1103. package/src/persistence/slow-query-log.ts +27 -9
  1104. package/src/persistence/slow-sync-log.ts +3 -1
  1105. package/src/persistence/steps.ts +11 -1
  1106. package/src/persistence/usage-buckets.ts +9 -3
  1107. package/src/persistence/usage-grouped-buckets.ts +6 -2
  1108. package/src/platform/feature-gate.ts +3 -1
  1109. package/src/platform/sync-identity.ts +9 -3
  1110. package/src/playbooks/playbook-compiler.ts +3 -1
  1111. package/src/plugin-api/__tests__/publish-event-forwarding.test.ts +113 -0
  1112. package/src/plugin-api/__tests__/publish-event.test.ts +57 -0
  1113. package/src/plugin-api/conversation-turn.ts +4 -4
  1114. package/src/plugin-api/event-hub-facade.ts +15 -6
  1115. package/src/plugin-api/index.ts +10 -4
  1116. package/src/plugin-api/model-profiles.test.ts +30 -0
  1117. package/src/plugin-api/model-profiles.ts +11 -4
  1118. package/src/plugin-api/publish-event.ts +36 -0
  1119. package/src/plugin-api/vision-support.test.ts +65 -2
  1120. package/src/plugin-api/vision-support.ts +15 -3
  1121. package/src/plugins/AGENTS.md +2 -0
  1122. package/src/plugins/defaults/channel/injectors.ts +12 -4
  1123. package/src/plugins/defaults/compaction/window-manager.ts +39 -10
  1124. package/src/plugins/defaults/documents/injectors.ts +18 -6
  1125. package/src/plugins/defaults/empty-response/hooks/post-model-call.ts +9 -3
  1126. package/src/plugins/defaults/exploration-drift/hooks/post-tool-use.ts +26 -8
  1127. package/src/plugins/defaults/image-fallback/hooks/post-compact.ts +3 -1
  1128. package/src/plugins/defaults/image-fallback/hooks/post-tool-use.ts +6 -2
  1129. package/src/plugins/defaults/image-fallback/hooks/user-prompt-submit.ts +3 -1
  1130. package/src/plugins/defaults/image-fallback/src/caption-blocks.ts +6 -2
  1131. package/src/plugins/defaults/image-fallback/src/image-persist.ts +3 -1
  1132. package/src/plugins/defaults/image-fallback/src/vision-caption.ts +6 -2
  1133. package/src/plugins/defaults/index.ts +9 -41
  1134. package/src/plugins/defaults/injection-presence.ts +3 -1
  1135. package/src/plugins/defaults/max-tokens-continue/hooks/post-model-call.ts +12 -4
  1136. package/src/plugins/defaults/memory/AGENTS.md +775 -0
  1137. package/src/plugins/defaults/memory/__tests__/capability-seed-embed-gate.test.ts +186 -0
  1138. package/src/plugins/defaults/memory/__tests__/compaction-log-store-clickhouse.test.ts +6 -2
  1139. package/src/plugins/defaults/memory/__tests__/db-async-query.test.ts +3 -1
  1140. package/src/plugins/defaults/memory/__tests__/fixtures/memory-v2-activation-fixtures.ts +1 -1
  1141. package/src/plugins/defaults/memory/__tests__/indexer-tier-dispatch.test.ts +129 -0
  1142. package/src/plugins/defaults/memory/__tests__/jobs-worker-quiesce-gate.test.ts +91 -0
  1143. package/src/plugins/defaults/memory/__tests__/jobs-worker-v1-graph-substrate-noop.test.ts +342 -0
  1144. package/src/plugins/defaults/memory/__tests__/jobs-worker-v2-graph-trigger-embed.test.ts +9 -1
  1145. package/src/plugins/defaults/memory/__tests__/jobs-worker-v2-schedule.test.ts +36 -1
  1146. package/src/plugins/defaults/memory/__tests__/jobs-worker-v2-sweep-defer.test.ts +9 -1
  1147. package/src/plugins/defaults/memory/__tests__/memory-log-stores-degraded.test.ts +2 -2
  1148. package/src/plugins/defaults/memory/__tests__/memory-retrospective-job.test.ts +44 -10
  1149. package/src/plugins/defaults/memory/__tests__/memory-retrospective-sweep.test.ts +151 -10
  1150. package/src/plugins/defaults/memory/__tests__/memory-tier-boundary-guard.test.ts +1155 -0
  1151. package/src/plugins/defaults/memory/__tests__/memory-v2-activation-log-store.test.ts +1 -1
  1152. package/src/plugins/defaults/memory/__tests__/memory-v2-concept-frequency.test.ts +3 -3
  1153. package/src/plugins/defaults/memory/__tests__/tools-delete-memory-page.test.ts +1 -1
  1154. package/src/plugins/defaults/memory/__tests__/worker-control.test.ts +6 -2
  1155. package/src/plugins/defaults/memory/anisotropy.test.ts +18 -6
  1156. package/src/plugins/defaults/memory/anisotropy.ts +45 -15
  1157. package/src/plugins/defaults/memory/context-search/agent-protocol.ts +3 -1
  1158. package/src/plugins/defaults/memory/context-search/agent-runner.ts +6 -2
  1159. package/src/plugins/defaults/memory/context-search/limits.ts +6 -2
  1160. package/src/plugins/defaults/memory/context-search/search.ts +30 -10
  1161. package/src/plugins/defaults/memory/context-search/sources/memory-v2.ts +71 -35
  1162. package/src/plugins/defaults/memory/context-search/sources/memory.ts +14 -4
  1163. package/src/plugins/defaults/memory/context-search/sources/workspace.ts +33 -11
  1164. package/src/plugins/defaults/memory/find-most-recent-retrospective-for.ts +3 -1
  1165. package/src/plugins/defaults/memory/fork-conversation-memory.ts +4 -4
  1166. package/src/plugins/defaults/memory/frontmatter.ts +3 -1
  1167. package/src/plugins/defaults/memory/graph/__tests__/conversation-graph-memory-v2-routing.test.ts +80 -10
  1168. package/src/plugins/defaults/memory/graph/__tests__/handle-remember-v2.test.ts +1 -1
  1169. package/src/plugins/defaults/memory/graph/capability-seed.ts +24 -10
  1170. package/src/plugins/defaults/memory/graph/conversation-graph-memory.ts +123 -49
  1171. package/src/plugins/defaults/memory/graph/graph-memory-state-store.ts +9 -3
  1172. package/src/plugins/defaults/memory/graph/graph-search.ts +9 -119
  1173. package/src/plugins/defaults/memory/graph/in-context-tracker.test.ts +173 -0
  1174. package/src/plugins/defaults/memory/graph/in-context-tracker.ts +109 -0
  1175. package/src/plugins/defaults/memory/graph/store.ts +114 -45
  1176. package/src/plugins/defaults/memory/graph/tool-handlers.test.ts +1 -1
  1177. package/src/plugins/defaults/memory/graph/tool-handlers.ts +5 -2
  1178. package/src/plugins/defaults/memory/graph/types.ts +20 -7
  1179. package/src/plugins/defaults/memory/graph-topology/__tests__/build-memory-graph.test.ts +1 -1
  1180. package/src/plugins/defaults/memory/graph-topology/build-memory-graph.ts +6 -9
  1181. package/src/plugins/defaults/memory/hooks/__tests__/user-prompt-submit.test.ts +30 -16
  1182. package/src/plugins/defaults/memory/hooks/user-prompt-submit.ts +18 -14
  1183. package/src/plugins/defaults/memory/indexer.ts +146 -89
  1184. package/src/plugins/defaults/memory/injectors.ts +86 -41
  1185. package/src/plugins/defaults/memory/job-handlers.ts +130 -39
  1186. package/src/plugins/defaults/memory/jobs/__tests__/embed-concept-page.test.ts +2 -2
  1187. package/src/plugins/defaults/memory/jobs/embed-concept-page.ts +22 -10
  1188. package/src/plugins/defaults/memory/jobs-worker.ts +279 -208
  1189. package/src/plugins/defaults/memory/memory-db.ts +3 -1
  1190. package/src/plugins/defaults/memory/memory-retrospective-accounting.ts +18 -6
  1191. package/src/plugins/defaults/memory/memory-retrospective-enqueue.ts +4 -2
  1192. package/src/plugins/defaults/memory/memory-retrospective-job.ts +40 -3
  1193. package/src/plugins/defaults/memory/memory-retrospective-state.ts +30 -10
  1194. package/src/plugins/defaults/memory/memory-retrospective-sweep.ts +99 -11
  1195. package/src/plugins/defaults/memory/memory-retrospective-trigger-check.ts +18 -6
  1196. package/src/plugins/defaults/memory/prompt-override.ts +6 -2
  1197. package/src/plugins/defaults/memory/segmenter.ts +6 -2
  1198. package/src/plugins/defaults/memory/src/__tests__/memory-v2-routes.test.ts +5 -3
  1199. package/src/plugins/defaults/memory/src/__tests__/memory-v2-simulate-route.test.ts +3 -4
  1200. package/src/plugins/defaults/memory/src/__tests__/memory-worker-routes.test.ts +3 -1
  1201. package/src/plugins/defaults/memory/src/memory-graph-routes.ts +2 -1
  1202. package/src/plugins/defaults/memory/src/memory-item-routes.test.ts +29 -5
  1203. package/src/plugins/defaults/memory/src/memory-item-routes.ts +72 -21
  1204. package/src/plugins/defaults/memory/src/memory-v2-routes.ts +36 -22
  1205. package/src/plugins/defaults/memory/startup.ts +58 -21
  1206. package/src/plugins/defaults/memory/substrate/__tests__/boot-maintenance.test.ts +335 -0
  1207. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/cli-command-store.test.ts +14 -8
  1208. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/consolidation-job.test.ts +51 -21
  1209. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/edge-index.test.ts +1 -1
  1210. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/frontmatter-sweep.test.ts +3 -3
  1211. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/page-index.test.ts +1 -1
  1212. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/page-store.test.ts +1 -1
  1213. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/prompts-consolidation.test.ts +2 -2
  1214. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/qdrant.test.ts +23 -14
  1215. package/src/plugins/defaults/memory/substrate/__tests__/reembed-job.test.ts +262 -0
  1216. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/sim.test.ts +9 -12
  1217. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/skill-content.test.ts +2 -2
  1218. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/skill-store.test.ts +9 -9
  1219. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/sparse-bm25.test.ts +12 -5
  1220. package/src/plugins/defaults/memory/substrate/__tests__/spread.test.ts +276 -0
  1221. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/static-context.test.ts +17 -8
  1222. package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/sweep-job.test.ts +9 -9
  1223. package/src/plugins/defaults/memory/{v3/substrate/memory-v2-startup.ts → substrate/boot-maintenance.ts} +43 -24
  1224. package/src/plugins/defaults/memory/{v3/substrate → substrate}/cli-command-store.ts +13 -8
  1225. package/src/plugins/defaults/memory/{v3/substrate → substrate}/consolidation-job.ts +51 -27
  1226. package/src/plugins/defaults/memory/{v3/substrate → substrate}/constants.ts +1 -0
  1227. package/src/plugins/defaults/memory/{v3/substrate → substrate}/edge-index.ts +28 -9
  1228. package/src/plugins/defaults/memory/{v3/substrate → substrate}/frontmatter-sweep.ts +14 -7
  1229. package/src/plugins/defaults/memory/{v3/substrate → substrate}/injected-block-slugs.ts +9 -3
  1230. package/src/plugins/defaults/memory/{v3/substrate → substrate}/page-index.ts +29 -10
  1231. package/src/plugins/defaults/memory/{v3/substrate → substrate}/page-store.ts +35 -12
  1232. package/src/plugins/defaults/memory/{v3/substrate → substrate}/prompts/consolidation.ts +14 -8
  1233. package/src/plugins/defaults/memory/{v3/substrate → substrate}/prompts/sweep.ts +4 -1
  1234. package/src/plugins/defaults/memory/{v3/substrate → substrate}/qdrant.ts +96 -36
  1235. package/src/plugins/defaults/memory/substrate/reembed-job.ts +54 -0
  1236. package/src/plugins/defaults/memory/{v3/substrate → substrate}/sim.ts +26 -15
  1237. package/src/plugins/defaults/memory/{v3/substrate → substrate}/skill-content.ts +1 -1
  1238. package/src/plugins/defaults/memory/{v3/substrate → substrate}/skill-store.ts +13 -8
  1239. package/src/plugins/defaults/memory/{v3/substrate → substrate}/sparse-bm25.ts +27 -10
  1240. package/src/plugins/defaults/memory/substrate/spread.ts +165 -0
  1241. package/src/plugins/defaults/memory/{v3/substrate → substrate}/static-context.ts +12 -7
  1242. package/src/plugins/defaults/memory/{v3/substrate → substrate}/sweep-job.ts +20 -15
  1243. package/src/plugins/defaults/memory/substrate/tuning.ts +93 -0
  1244. package/src/plugins/defaults/memory/{v3/substrate → substrate}/types.ts +7 -4
  1245. package/src/plugins/defaults/memory/task-memory-cleanup.ts +18 -6
  1246. package/src/plugins/defaults/memory/tools.test.ts +1 -1
  1247. package/src/plugins/defaults/memory/tools.ts +1 -1
  1248. package/src/plugins/defaults/memory/v1/README.md +5 -0
  1249. package/src/plugins/defaults/memory/{__tests__ → v1/__tests__}/filing-jobs.test.ts +4 -4
  1250. package/src/plugins/defaults/memory/{filing-jobs.ts → v1/filing-jobs.ts} +3 -3
  1251. package/src/plugins/defaults/memory/{graph → v1/graph}/bootstrap.test.ts +68 -6
  1252. package/src/plugins/defaults/memory/{graph → v1/graph}/bootstrap.ts +64 -29
  1253. package/src/plugins/defaults/memory/{graph → v1/graph}/consolidation.ts +71 -35
  1254. package/src/plugins/defaults/memory/{graph → v1/graph}/decay.test.ts +1 -1
  1255. package/src/plugins/defaults/memory/{graph → v1/graph}/decay.ts +9 -5
  1256. package/src/plugins/defaults/memory/{graph → v1/graph}/extraction-job.ts +8 -6
  1257. package/src/plugins/defaults/memory/{graph → v1/graph}/extraction.test.ts +1 -1
  1258. package/src/plugins/defaults/memory/{graph → v1/graph}/extraction.ts +20 -14
  1259. package/src/plugins/defaults/memory/{graph → v1/graph}/graph-search.test.ts +3 -3
  1260. package/src/plugins/defaults/memory/v1/graph/graph-search.ts +123 -0
  1261. package/src/plugins/defaults/memory/{graph → v1/graph}/injection.test.ts +1 -118
  1262. package/src/plugins/defaults/memory/{graph → v1/graph}/injection.ts +33 -119
  1263. package/src/plugins/defaults/memory/{graph → v1/graph}/narrative.ts +9 -7
  1264. package/src/plugins/defaults/memory/{graph → v1/graph}/pattern-scan.ts +8 -6
  1265. package/src/plugins/defaults/memory/{graph → v1/graph}/retriever.test.ts +135 -42
  1266. package/src/plugins/defaults/memory/{graph → v1/graph}/retriever.ts +40 -22
  1267. package/src/plugins/defaults/memory/{graph → v1/graph}/scoring.test.ts +1 -1
  1268. package/src/plugins/defaults/memory/{graph → v1/graph}/scoring.ts +19 -7
  1269. package/src/plugins/defaults/memory/{graph → v1/graph}/serendipity.ts +10 -4
  1270. package/src/plugins/defaults/memory/{graph → v1/graph}/triggers.test.ts +1 -1
  1271. package/src/plugins/defaults/memory/{graph → v1/graph}/triggers.ts +31 -11
  1272. package/src/plugins/defaults/memory/{identity-context.ts → v1/identity-context.ts} +4 -4
  1273. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/backfill.ts +6 -6
  1274. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/embedding.test.ts +6 -6
  1275. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/embedding.ts +6 -6
  1276. package/src/plugins/defaults/memory/{job-handlers → v1/job-handlers}/index-maintenance.ts +8 -8
  1277. package/src/plugins/defaults/memory/{jobs → v1/jobs}/embed-pkb-file.test.ts +7 -7
  1278. package/src/plugins/defaults/memory/{jobs → v1/jobs}/embed-pkb-file.ts +14 -8
  1279. package/src/plugins/defaults/memory/{pkb → v1/pkb}/autoinject.ts +4 -2
  1280. package/src/plugins/defaults/memory/{pkb → v1/pkb}/context.ts +14 -6
  1281. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-index.test.ts +3 -3
  1282. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-index.ts +2 -2
  1283. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-reconcile.test.ts +6 -4
  1284. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-reconcile.ts +5 -3
  1285. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-search.test.ts +9 -5
  1286. package/src/plugins/defaults/memory/{pkb → v1/pkb}/pkb-search.ts +21 -11
  1287. package/src/plugins/defaults/memory/{pkb → v1/pkb}/types.ts +3 -5
  1288. package/src/plugins/defaults/memory/{pkb-schedule.ts → v1/pkb-schedule.ts} +5 -3
  1289. package/src/plugins/defaults/memory/{search/semantic.ts → v1/semantic-search.ts} +25 -10
  1290. package/src/plugins/defaults/memory/v2/__tests__/activation-store.test.ts +1 -1
  1291. package/src/plugins/defaults/memory/v2/__tests__/activation.test.ts +11 -274
  1292. package/src/plugins/defaults/memory/v2/__tests__/backfill-jobs.test.ts +9 -131
  1293. package/src/plugins/defaults/memory/v2/__tests__/harness-compare.test.ts +1 -1
  1294. package/src/plugins/defaults/memory/v2/__tests__/harness-oracle.test.ts +1 -1
  1295. package/src/plugins/defaults/memory/v2/__tests__/harness-replay-input.test.ts +1 -1
  1296. package/src/plugins/defaults/memory/v2/__tests__/injection.test.ts +14 -10
  1297. package/src/plugins/defaults/memory/v2/__tests__/reranker.test.ts +7 -5
  1298. package/src/plugins/defaults/memory/v2/__tests__/router.test.ts +12 -6
  1299. package/src/plugins/defaults/memory/{memory-v2-activation-log-store.ts → v2/activation-log-store.ts} +2 -2
  1300. package/src/plugins/defaults/memory/v2/activation-store.ts +22 -8
  1301. package/src/plugins/defaults/memory/v2/activation.ts +30 -163
  1302. package/src/plugins/defaults/memory/v2/backfill-jobs.ts +7 -54
  1303. package/src/plugins/defaults/memory/{memory-v2-concept-frequency.ts → v2/concept-frequency.ts} +3 -3
  1304. package/src/plugins/defaults/memory/v2/harness/metrics.ts +9 -3
  1305. package/src/plugins/defaults/memory/v2/harness/oracle.ts +1 -1
  1306. package/src/plugins/defaults/memory/v2/harness/replay-input.ts +2 -2
  1307. package/src/plugins/defaults/memory/v2/harness/retriever.ts +1 -1
  1308. package/src/plugins/defaults/memory/v2/harness/runner.ts +9 -3
  1309. package/src/plugins/defaults/memory/v2/injection-events.ts +21 -7
  1310. package/src/plugins/defaults/memory/v2/injection.ts +36 -26
  1311. package/src/plugins/defaults/memory/v2/migration.ts +2 -2
  1312. package/src/plugins/defaults/memory/{rerank-local.ts → v2/rerank-local.ts} +44 -18
  1313. package/src/plugins/defaults/memory/v2/reranker.ts +29 -11
  1314. package/src/plugins/defaults/memory/v2/router.ts +38 -15
  1315. package/src/plugins/defaults/memory/v3/__tests__/candidate-match.test.ts +5 -3
  1316. package/src/plugins/defaults/memory/v3/__tests__/carry-integration.test.ts +21 -8
  1317. package/src/plugins/defaults/memory/v3/__tests__/dense.test.ts +9 -3
  1318. package/src/plugins/defaults/memory/v3/__tests__/edge.test.ts +1 -1
  1319. package/src/plugins/defaults/memory/v3/__tests__/injection.test.ts +6 -2
  1320. package/src/plugins/defaults/memory/v3/__tests__/live-integration.test.ts +1 -1
  1321. package/src/plugins/defaults/memory/v3/__tests__/maintain-job.test.ts +4 -1
  1322. package/src/plugins/defaults/memory/v3/__tests__/orchestrate.test.ts +181 -3
  1323. package/src/plugins/defaults/memory/v3/__tests__/section-dense-store.test.ts +9 -3
  1324. package/src/plugins/defaults/memory/v3/__tests__/selection-log-store.test.ts +3 -0
  1325. package/src/plugins/defaults/memory/v3/__tests__/shadow-integration.test.ts +14 -5
  1326. package/src/plugins/defaults/memory/v3/__tests__/shadow-plugin.test.ts +40 -50
  1327. package/src/plugins/defaults/memory/v3/__tests__/tuning-profile.test.ts +1 -0
  1328. package/src/plugins/defaults/memory/v3/candidate-match.ts +2 -2
  1329. package/src/plugins/defaults/memory/v3/capabilities.ts +6 -4
  1330. package/src/plugins/defaults/memory/v3/card.ts +25 -9
  1331. package/src/plugins/defaults/memory/v3/core-set.ts +6 -2
  1332. package/src/plugins/defaults/memory/v3/dense.ts +15 -5
  1333. package/src/plugins/defaults/memory/v3/edge.ts +52 -18
  1334. package/src/plugins/defaults/memory/v3/entity-lane.ts +9 -3
  1335. package/src/plugins/defaults/memory/v3/ever-injected-store.ts +39 -13
  1336. package/src/plugins/defaults/memory/v3/fresh-set.ts +3 -1
  1337. package/src/plugins/defaults/memory/v3/gate.ts +4 -4
  1338. package/src/plugins/defaults/memory/v3/hot-set.ts +6 -2
  1339. package/src/plugins/defaults/memory/v3/injector.ts +61 -20
  1340. package/src/plugins/defaults/memory/v3/learned-edges.ts +21 -7
  1341. package/src/plugins/defaults/memory/v3/llm-retry.ts +3 -1
  1342. package/src/plugins/defaults/memory/v3/maintain-job.ts +3 -3
  1343. package/src/plugins/defaults/memory/v3/orchestrate.ts +115 -23
  1344. package/src/plugins/defaults/memory/v3/page-content.ts +26 -10
  1345. package/src/plugins/defaults/memory/v3/pool-select.test.ts +3 -1
  1346. package/src/plugins/defaults/memory/v3/pool-select.ts +15 -5
  1347. package/src/plugins/defaults/memory/v3/prune.ts +40 -16
  1348. package/src/plugins/defaults/memory/v3/render-injection.ts +6 -2
  1349. package/src/plugins/defaults/memory/v3/section-dense-store.ts +36 -12
  1350. package/src/plugins/defaults/memory/v3/section-needle.ts +27 -9
  1351. package/src/plugins/defaults/memory/v3/sections.ts +6 -2
  1352. package/src/plugins/defaults/memory/v3/selection-log-store.ts +34 -12
  1353. package/src/plugins/defaults/memory/v3/shadow-plugin.ts +9 -13
  1354. package/src/plugins/defaults/memory/v3/span-query.test.ts +86 -0
  1355. package/src/plugins/defaults/memory/v3/span-query.ts +71 -0
  1356. package/src/plugins/defaults/memory/v3/tuning-profile.ts +3 -0
  1357. package/src/plugins/defaults/memory/v3/types.ts +4 -1
  1358. package/src/plugins/defaults/memory/v3-eval/__tests__/eval-tally.test.ts +9 -3
  1359. package/src/plugins/defaults/memory/v3-eval/eval-packets.ts +2 -2
  1360. package/src/plugins/defaults/memory/v3-eval/eval-tally.ts +22 -9
  1361. package/src/plugins/defaults/memory/validation.ts +1 -1
  1362. package/src/plugins/defaults/memory/worker.ts +2 -1
  1363. package/src/plugins/defaults/platform-hosted/__tests__/reengage.test.ts +104 -12
  1364. package/src/plugins/defaults/platform-hosted/routes/reengage.ts +104 -12
  1365. package/src/plugins/defaults/session/injectors.ts +15 -5
  1366. package/src/plugins/defaults/surface-completion-nudge/hooks/post-model-call.ts +49 -17
  1367. package/src/plugins/defaults/task-progress-nudge/hooks/post-tool-use.ts +33 -11
  1368. package/src/plugins/defaults/title-generate/hooks/stop.ts +15 -5
  1369. package/src/plugins/defaults/title-generate/hooks/user-prompt-submit.ts +6 -2
  1370. package/src/plugins/defaults/tool-error/hooks/post-tool-use.ts +21 -7
  1371. package/src/plugins/defaults/tool-result-truncate/terminal.ts +3 -1
  1372. package/src/plugins/defaults/turn-context/injectors.ts +3 -1
  1373. package/src/plugins/defaults/workspace/injectors.ts +52 -18
  1374. package/src/plugins/external-plugin-loader.ts +21 -7
  1375. package/src/plugins/injector-registry.ts +6 -2
  1376. package/src/plugins/types.ts +2 -2
  1377. package/src/prompts/__tests__/system-prompt.test.ts +5 -2
  1378. package/src/prompts/bootstrap-cleanup.ts +3 -1
  1379. package/src/prompts/normalize-onboarding.ts +9 -3
  1380. package/src/prompts/persona-resolver.ts +33 -11
  1381. package/src/prompts/sections.ts +46 -30
  1382. package/src/prompts/system-prompt.ts +30 -10
  1383. package/src/prompts/template-detection.ts +6 -2
  1384. package/src/prompts/templates/system-sections.ts +55 -20
  1385. package/src/prompts/user-reference.ts +6 -2
  1386. package/src/providers/__tests__/connection-model-compat.test.ts +3 -1
  1387. package/src/providers/__tests__/inference.test.ts +24 -8
  1388. package/src/providers/__tests__/registry-native-web-search.test.ts +47 -2
  1389. package/src/providers/__tests__/search-provider-catalog.test.ts +4 -1
  1390. package/src/providers/anthropic/client.ts +132 -47
  1391. package/src/providers/connection-model-compat.ts +12 -4
  1392. package/src/providers/content-block-schema.ts +26 -0
  1393. package/src/providers/fetch-provider-catalog.ts +3 -2
  1394. package/src/providers/gemini/client.ts +30 -10
  1395. package/src/providers/inference/__tests__/connections-credential-normalize.test.ts +87 -0
  1396. package/src/providers/inference/adapter-factory.ts +6 -0
  1397. package/src/providers/inference/codex-token-refresh.ts +6 -2
  1398. package/src/providers/inference/connections.ts +61 -23
  1399. package/src/providers/media-resolve.ts +21 -7
  1400. package/src/providers/model-catalog.ts +82 -15
  1401. package/src/providers/model-intents.ts +1 -1
  1402. package/src/providers/ollama/client.ts +3 -1
  1403. package/src/providers/openai/__tests__/chat-completions-input-audio.test.ts +262 -0
  1404. package/src/providers/openai/__tests__/chat-completions-provider-endpoint.test.ts +3 -1
  1405. package/src/providers/openai/__tests__/chat-completions-provider-reasoning.test.ts +3 -1
  1406. package/src/providers/openai/api-error-normalization.ts +75 -25
  1407. package/src/providers/openai/chat-completions-provider.ts +109 -33
  1408. package/src/providers/openai/coerce-object-args.ts +12 -4
  1409. package/src/providers/openai/input-audio.ts +76 -0
  1410. package/src/providers/openai/responses-provider.ts +29 -11
  1411. package/src/providers/openrouter/client.ts +9 -5
  1412. package/src/providers/platform-proxy/constants.ts +4 -0
  1413. package/src/providers/platform-proxy/context.ts +9 -3
  1414. package/src/providers/poolside/client.ts +42 -0
  1415. package/src/providers/provider-catalog-visibility.ts +4 -4
  1416. package/src/providers/ratelimit.ts +6 -2
  1417. package/src/providers/registry.ts +40 -8
  1418. package/src/providers/retry.ts +50 -16
  1419. package/src/providers/search-provider-catalog.ts +18 -0
  1420. package/src/providers/speech-to-text/deepgram-realtime.test.ts +18 -6
  1421. package/src/providers/speech-to-text/google-gemini-live-stream.test.ts +108 -129
  1422. package/src/providers/speech-to-text/google-gemini-live-stream.ts +66 -22
  1423. package/src/providers/speech-to-text/xai-realtime.test.ts +18 -6
  1424. package/src/providers/speech-to-text/xai-realtime.ts +60 -20
  1425. package/src/providers/stop-reasons.ts +3 -1
  1426. package/src/providers/thinking-config.ts +3 -1
  1427. package/src/providers/tool-progress-events.ts +15 -5
  1428. package/src/providers/types.ts +39 -1
  1429. package/src/providers/usage-tracking.ts +6 -2
  1430. package/src/providers/vercel-ai-gateway/client.ts +0 -2
  1431. package/src/runtime/AGENTS.md +7 -5
  1432. package/src/runtime/__tests__/agent-wake.test.ts +3 -1
  1433. package/src/runtime/__tests__/interactive-ui.test.ts +3 -1
  1434. package/src/runtime/__tests__/local-principal-trust.test.ts +10 -8
  1435. package/src/runtime/__tests__/question-request-guardian-bridge.test.ts +173 -0
  1436. package/src/runtime/__tests__/question-resolution.test.ts +111 -0
  1437. package/src/runtime/access-request-helper.ts +7 -15
  1438. package/src/runtime/anchored-guardian.test.ts +45 -8
  1439. package/src/runtime/anchored-guardian.ts +4 -1
  1440. package/src/runtime/approval-conversation-turn.ts +17 -7
  1441. package/src/runtime/approval-message-composer.ts +6 -2
  1442. package/src/runtime/assistant-event-hub.ts +43 -31
  1443. package/src/runtime/assistant-event-publish-options.ts +31 -0
  1444. package/src/runtime/assistant-event.ts +19 -30
  1445. package/src/runtime/assistant-stream-state.ts +4 -4
  1446. package/src/runtime/auth/__tests__/guard-tests.test.ts +24 -8
  1447. package/src/runtime/auth/middleware.ts +0 -2
  1448. package/src/runtime/auth/same-actor.ts +12 -4
  1449. package/src/runtime/background-job-runner.ts +12 -4
  1450. package/src/runtime/channel-approvals.ts +0 -25
  1451. package/src/runtime/channel-invite-transports/slack.ts +6 -2
  1452. package/src/runtime/channel-invite-transports/telegram.ts +6 -2
  1453. package/src/runtime/channel-readiness-service.ts +107 -50
  1454. package/src/runtime/channel-retry-sweep.ts +38 -15
  1455. package/src/runtime/channel-verification-service.ts +9 -3
  1456. package/src/runtime/confirmation-request-guardian-bridge.ts +4 -0
  1457. package/src/runtime/decision-token.ts +3 -1
  1458. package/src/runtime/guardian-action-message-composer.ts +6 -2
  1459. package/src/runtime/guardian-reply-router.ts +108 -0
  1460. package/src/runtime/guardian-vellum-migration.ts +18 -6
  1461. package/src/runtime/http-router.ts +18 -6
  1462. package/src/runtime/http-server.ts +8 -0
  1463. package/src/runtime/http-types.ts +2 -2
  1464. package/src/runtime/invite-service.ts +6 -2
  1465. package/src/runtime/local-principal-trust.ts +6 -2
  1466. package/src/runtime/member-verdict-cache.ts +18 -6
  1467. package/src/runtime/middleware/__tests__/request-logger.test.ts +1 -3
  1468. package/src/runtime/middleware/auth.ts +37 -13
  1469. package/src/runtime/middleware/error-handler.ts +1 -4
  1470. package/src/runtime/middleware/rate-limiter.ts +12 -4
  1471. package/src/runtime/middleware/request-logger.ts +12 -4
  1472. package/src/runtime/migrations/__tests__/rebind-secrets-credentials.test.ts +18 -6
  1473. package/src/runtime/migrations/__tests__/vbundle-builder-credentials.test.ts +3 -1
  1474. package/src/runtime/migrations/__tests__/vbundle-import-parity.test.ts +9 -3
  1475. package/src/runtime/migrations/__tests__/vbundle-import-version-compat.test.ts +11 -4
  1476. package/src/runtime/migrations/__tests__/vbundle-streaming-importer.test.ts +84 -28
  1477. package/src/runtime/migrations/__tests__/vbundle-symlink-importer.test.ts +18 -6
  1478. package/src/runtime/migrations/__tests__/vbundle-symlink-streaming-importer.test.ts +0 -0
  1479. package/src/runtime/migrations/__tests__/vbundle-symlink-tar.test.ts +24 -8
  1480. package/src/runtime/migrations/__tests__/vbundle-tar-stream.test.ts +3 -1
  1481. package/src/runtime/migrations/__tests__/vbundle-validator-v1-schema.test.ts +6 -2
  1482. package/src/runtime/migrations/gcs-signed-url.ts +21 -7
  1483. package/src/runtime/migrations/job-registry.ts +24 -8
  1484. package/src/runtime/migrations/migration-wizard.ts +9 -3
  1485. package/src/runtime/migrations/transfer-progress-screen.ts +3 -1
  1486. package/src/runtime/migrations/validation-results-screen.ts +3 -1
  1487. package/src/runtime/migrations/vbundle-builder.ts +33 -11
  1488. package/src/runtime/migrations/vbundle-import-analyzer.ts +3 -1
  1489. package/src/runtime/migrations/vbundle-import-policy.ts +21 -7
  1490. package/src/runtime/migrations/vbundle-importer.ts +9 -3
  1491. package/src/runtime/migrations/vbundle-metadata-merge.ts +12 -4
  1492. package/src/runtime/migrations/vbundle-streaming-importer.ts +57 -19
  1493. package/src/runtime/migrations/vbundle-tar-stream.ts +15 -5
  1494. package/src/runtime/migrations/vbundle-validator.ts +6 -2
  1495. package/src/runtime/nl-approval-parser.ts +6 -3
  1496. package/src/runtime/no-response.ts +12 -4
  1497. package/src/runtime/pending-interactions.ts +9 -3
  1498. package/src/runtime/pre-first-message-gate.ts +3 -1
  1499. package/src/runtime/process-role.ts +42 -0
  1500. package/src/runtime/question-request-guardian-bridge.ts +184 -0
  1501. package/src/runtime/question-resolution.ts +153 -0
  1502. package/src/runtime/routes/__tests__/acp-routes.test.ts +24 -8
  1503. package/src/runtime/routes/__tests__/avatar-state-routes.test.ts +9 -3
  1504. package/src/runtime/routes/__tests__/backup-routes.test.ts +3 -1
  1505. package/src/runtime/routes/__tests__/bookmark-routes.test.ts +6 -2
  1506. package/src/runtime/routes/__tests__/channel-verification-revoke.test.ts +9 -3
  1507. package/src/runtime/routes/__tests__/client-routes.test.ts +3 -1
  1508. package/src/runtime/routes/__tests__/connection-routes-vs-cli-parity.test.ts +12 -4
  1509. package/src/runtime/routes/__tests__/consolidation-routes.test.ts +3 -1
  1510. package/src/runtime/routes/__tests__/contact-routes-update-channel-relay.test.ts +3 -1
  1511. package/src/runtime/routes/__tests__/contact-routes.test.ts +3 -1
  1512. package/src/runtime/routes/__tests__/content-source-routes.test.ts +3 -1
  1513. package/src/runtime/routes/__tests__/conversation-compaction-routes.test.ts +3 -1
  1514. package/src/runtime/routes/__tests__/conversation-list-routes.test.ts +3 -1
  1515. package/src/runtime/routes/__tests__/conversation-management-routes.test.ts +3 -1
  1516. package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +1 -1
  1517. package/src/runtime/routes/__tests__/conversation-surface-routes.test.ts +3 -1
  1518. package/src/runtime/routes/__tests__/default-plugin-routes.test.ts +4 -14
  1519. package/src/runtime/routes/__tests__/deprecated-route-context.test.ts +112 -0
  1520. package/src/runtime/routes/__tests__/gateway-log-routes.test.ts +3 -1
  1521. package/src/runtime/routes/__tests__/gateway-status-routes.test.ts +3 -1
  1522. package/src/runtime/routes/__tests__/heartbeat-routes.test.ts +3 -1
  1523. package/src/runtime/routes/__tests__/home-feed-routes.test.ts +6 -3
  1524. package/src/runtime/routes/__tests__/invite-relay-routes.test.ts +3 -1
  1525. package/src/runtime/routes/__tests__/ps-routes.test.ts +12 -4
  1526. package/src/runtime/routes/__tests__/question-routes.test.ts +6 -2
  1527. package/src/runtime/routes/__tests__/retrospective-routes.test.ts +3 -1
  1528. package/src/runtime/routes/__tests__/sanity-routes.test.ts +6 -2
  1529. package/src/runtime/routes/__tests__/schedule-routes-create.test.ts +3 -1
  1530. package/src/runtime/routes/__tests__/slack-channel-routes.test.ts +3 -1
  1531. package/src/runtime/routes/__tests__/stt-routes.test.ts +9 -3
  1532. package/src/runtime/routes/__tests__/subagents-routes.test.ts +250 -0
  1533. package/src/runtime/routes/__tests__/surface-action-routes.test.ts +9 -3
  1534. package/src/runtime/routes/__tests__/surface-content-routes.test.ts +3 -1
  1535. package/src/runtime/routes/__tests__/tts-routes.test.ts +9 -3
  1536. package/src/runtime/routes/__tests__/user-route-dispatcher-host.test.ts +3 -12
  1537. package/src/runtime/routes/__tests__/user-route-dispatcher.test.ts +26 -115
  1538. package/src/runtime/routes/__tests__/wake-conversation-routes.test.ts +3 -1
  1539. package/src/runtime/routes/__tests__/webhook-routes.test.ts +201 -0
  1540. package/src/runtime/routes/acp-routes-list.test.ts +9 -3
  1541. package/src/runtime/routes/acp-routes.test.ts +18 -6
  1542. package/src/runtime/routes/acp-routes.ts +2 -2
  1543. package/src/runtime/routes/app-management-routes.ts +13 -5
  1544. package/src/runtime/routes/app-routes.ts +3 -1
  1545. package/src/runtime/routes/archive-utils.ts +3 -1
  1546. package/src/runtime/routes/attachment-routes.ts +6 -2
  1547. package/src/runtime/routes/background-wake-routes.ts +12 -4
  1548. package/src/runtime/routes/backup-routes.ts +6 -2
  1549. package/src/runtime/routes/bookmark-routes.ts +3 -15
  1550. package/src/runtime/routes/browser-routes.ts +3 -1
  1551. package/src/runtime/routes/call-routes.ts +3 -1
  1552. package/src/runtime/routes/canned-message-complete.ts +2 -2
  1553. package/src/runtime/routes/consolidation-routes.ts +8 -2
  1554. package/src/runtime/routes/contact-routes.ts +9 -3
  1555. package/src/runtime/routes/conversation-list-routes.ts +6 -20
  1556. package/src/runtime/routes/conversation-management-routes.ts +4 -6
  1557. package/src/runtime/routes/conversation-query-routes.ts +81 -15
  1558. package/src/runtime/routes/conversation-routes.ts +42 -24
  1559. package/src/runtime/routes/conversation-starter-routes.ts +12 -4
  1560. package/src/runtime/routes/credential-request-routes.ts +0 -1
  1561. package/src/runtime/routes/debug-bash-routes.ts +3 -1
  1562. package/src/runtime/routes/defer-routes.ts +3 -1
  1563. package/src/runtime/routes/deprecated-route-context.ts +125 -0
  1564. package/src/runtime/routes/diagnostics-routes.ts +3 -1
  1565. package/src/runtime/routes/disk-pressure-routes.ts +12 -4
  1566. package/src/runtime/routes/email-routes.ts +18 -6
  1567. package/src/runtime/routes/events-routes.ts +9 -3
  1568. package/src/runtime/routes/filing-routes.ts +7 -7
  1569. package/src/runtime/routes/global-search-routes.ts +22 -8
  1570. package/src/runtime/routes/group-routes.ts +47 -5
  1571. package/src/runtime/routes/guardian-action-routes.ts +2 -1
  1572. package/src/runtime/routes/guardian-approval-prompt.ts +2 -2
  1573. package/src/runtime/routes/heartbeat-routes.ts +12 -6
  1574. package/src/runtime/routes/home-feed-routes.ts +51 -18
  1575. package/src/runtime/routes/host-app-control-routes.ts +40 -45
  1576. package/src/runtime/routes/host-browser-routes.ts +6 -3
  1577. package/src/runtime/routes/host-transfer-routes.ts +21 -9
  1578. package/src/runtime/routes/http-adapter.ts +15 -5
  1579. package/src/runtime/routes/identity-routes.ts +15 -5
  1580. package/src/runtime/routes/image-generation-routes.ts +12 -9
  1581. package/src/runtime/routes/inbound-message-handler.ts +17 -0
  1582. package/src/runtime/routes/inbound-stages/acl-enforcement.test.ts +50 -0
  1583. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +19 -0
  1584. package/src/runtime/routes/inbound-stages/admission-policy.test.ts +9 -3
  1585. package/src/runtime/routes/inbound-stages/background-dispatch.ts +4 -4
  1586. package/src/runtime/routes/inbound-stages/channel-turn-admission.ts +2 -2
  1587. package/src/runtime/routes/inbound-stages/guardian-activation-intercept.ts +12 -4
  1588. package/src/runtime/routes/inbound-stages/inbound-content-prep.test.ts +129 -0
  1589. package/src/runtime/routes/inbound-stages/inbound-content-prep.ts +141 -9
  1590. package/src/runtime/routes/index.ts +2 -0
  1591. package/src/runtime/routes/inference-profile-session-handler.ts +6 -2
  1592. package/src/runtime/routes/inference-profile-session-reaper.ts +6 -2
  1593. package/src/runtime/routes/inference-profiles-routes.ts +10 -5
  1594. package/src/runtime/routes/inference-provider-connection-routes.ts +9 -3
  1595. package/src/runtime/routes/inference-send-routes.ts +6 -2
  1596. package/src/runtime/routes/integrations/twilio.ts +3 -1
  1597. package/src/runtime/routes/internal-oauth-routes.ts +6 -2
  1598. package/src/runtime/routes/lifecycle-routes.ts +199 -0
  1599. package/src/runtime/routes/llm-call-sites-routes.ts +5 -2
  1600. package/src/runtime/routes/llm-context-normalization.ts +36 -12
  1601. package/src/runtime/routes/log-export/__tests__/workspace-allowlist.test.ts +12 -4
  1602. package/src/runtime/routes/log-export/workspace-allowlist.ts +33 -11
  1603. package/src/runtime/routes/log-export-routes.ts +51 -17
  1604. package/src/runtime/routes/mcp-auth-routes.ts +23 -8
  1605. package/src/runtime/routes/migration-rollback-routes.ts +4 -2
  1606. package/src/runtime/routes/migration-routes.ts +24 -8
  1607. package/src/runtime/routes/oauth-apps.ts +3 -1
  1608. package/src/runtime/routes/oauth-commands-routes.ts +66 -22
  1609. package/src/runtime/routes/oauth-connect-routes.ts +14 -5
  1610. package/src/runtime/routes/oauth-providers.ts +89 -34
  1611. package/src/runtime/routes/onboarding-checkin-routes.ts +3 -1
  1612. package/src/runtime/routes/platform-routes.ts +3 -8
  1613. package/src/runtime/routes/playground/__tests__/force-compact.test.ts +6 -2
  1614. package/src/runtime/routes/playground/__tests__/inject-failures.test.ts +13 -7
  1615. package/src/runtime/routes/playground/__tests__/reset-circuit.test.ts +7 -5
  1616. package/src/runtime/routes/playground/__tests__/seed-conversation.test.ts +3 -1
  1617. package/src/runtime/routes/playground/__tests__/seeded-conversations.test.ts +3 -1
  1618. package/src/runtime/routes/playground/__tests__/state.test.ts +3 -1
  1619. package/src/runtime/routes/playground/helpers.ts +6 -2
  1620. package/src/runtime/routes/playground/seeded-conversations.ts +3 -1
  1621. package/src/runtime/routes/profiler-routes.ts +12 -4
  1622. package/src/runtime/routes/question-routes.ts +37 -88
  1623. package/src/runtime/routes/redact-staged-export.ts +15 -5
  1624. package/src/runtime/routes/schedule-routes.ts +37 -12
  1625. package/src/runtime/routes/secret-routes.ts +11 -1
  1626. package/src/runtime/routes/sequence-routes.ts +23 -10
  1627. package/src/runtime/routes/settings-routes.ts +8 -18
  1628. package/src/runtime/routes/skills-routes.ts +45 -15
  1629. package/src/runtime/routes/slack-channel-routes.ts +6 -2
  1630. package/src/runtime/routes/sounds-config-routes.ts +15 -5
  1631. package/src/runtime/routes/stt-routes.ts +9 -3
  1632. package/src/runtime/routes/subagents-routes.ts +35 -8
  1633. package/src/runtime/routes/tool-call-question-enrichment.ts +6 -2
  1634. package/src/runtime/routes/upgrade-broadcast-routes.ts +4 -5
  1635. package/src/runtime/routes/user-route-dispatcher.ts +23 -64
  1636. package/src/runtime/routes/user-routes-cli.ts +3 -1
  1637. package/src/runtime/routes/user-routes.ts +1 -10
  1638. package/src/runtime/routes/watcher-routes.ts +15 -5
  1639. package/src/runtime/routes/webhook-routes.ts +77 -30
  1640. package/src/runtime/routes/workflow-routes.test.ts +9 -3
  1641. package/src/runtime/routes/workflow-routes.ts +12 -4
  1642. package/src/runtime/routes/workspace-greetings.ts +12 -4
  1643. package/src/runtime/routes/workspace-routes.test.ts +7 -4
  1644. package/src/runtime/routes/workspace-routes.ts +12 -4
  1645. package/src/runtime/routes/workspace-utils.ts +6 -2
  1646. package/src/runtime/services/conversation-serializer.ts +9 -3
  1647. package/src/runtime/slack-reply-session.test.ts +14 -12
  1648. package/src/runtime/slack-reply-session.ts +45 -17
  1649. package/src/runtime/sync/sync-publisher.test.ts +7 -5
  1650. package/src/runtime/tool-grant-request-helper.ts +4 -0
  1651. package/src/runtime/trust-verdict-consumer.ts +9 -3
  1652. package/src/runtime/verification-outbound-actions.ts +3 -1
  1653. package/src/runtime/verification-rate-limiter.ts +6 -2
  1654. package/src/schedule/__tests__/run-script.test.ts +62 -0
  1655. package/src/schedule/integration-status.ts +6 -2
  1656. package/src/schedule/recurrence-engine.ts +35 -13
  1657. package/src/schedule/recurrence-types.ts +6 -2
  1658. package/src/schedule/run-script.ts +111 -21
  1659. package/src/schedule/schedule-recovery.ts +6 -2
  1660. package/src/schedule/schedule-store.ts +236 -48
  1661. package/src/schedule/scheduler.ts +32 -2
  1662. package/src/security/AGENTS.md +15 -1
  1663. package/src/security/__tests__/oauth2-exchange-body.test.ts +1 -4
  1664. package/src/security/__tests__/provider-key-env-fallback.test.ts +6 -2
  1665. package/src/security/__tests__/untrusted-content.test.ts +21 -2
  1666. package/src/security/ces-credential-client.ts +15 -5
  1667. package/src/security/ces-rpc-credential-backend.ts +6 -2
  1668. package/src/security/credential-key.ts +21 -0
  1669. package/src/security/encrypted-store.ts +47 -18
  1670. package/src/security/oauth-callback-registry.ts +6 -2
  1671. package/src/security/oauth2-device-code.ts +7 -2
  1672. package/src/security/oauth2.ts +36 -7
  1673. package/src/security/redact-json.ts +3 -1
  1674. package/src/security/redaction.ts +3 -1
  1675. package/src/security/secret-allowlist.ts +21 -7
  1676. package/src/security/secret-ingress.ts +17 -106
  1677. package/src/security/secret-patterns.ts +8 -139
  1678. package/src/security/secret-scanner.ts +31 -11
  1679. package/src/security/store-path-override.ts +6 -16
  1680. package/src/security/token-manager.ts +4 -2
  1681. package/src/security/tool-approval-digest.ts +3 -1
  1682. package/src/security/untrusted-content.ts +11 -3
  1683. package/src/sequence/analytics.ts +6 -2
  1684. package/src/sequence/guardrails.ts +6 -2
  1685. package/src/sequence/importer.ts +18 -6
  1686. package/src/sequence/reply-matcher.ts +18 -6
  1687. package/src/sequence/store.ts +48 -15
  1688. package/src/services/published-app-updater.ts +9 -3
  1689. package/src/signals/cancel.ts +3 -1
  1690. package/src/signals/conversation-undo.ts +3 -1
  1691. package/src/signals/emit-event.ts +5 -10
  1692. package/src/signals/event-stream.ts +20 -10
  1693. package/src/skills/active-skill-tools.ts +9 -3
  1694. package/src/skills/catalog-cache.ts +4 -1
  1695. package/src/skills/catalog-files.ts +93 -31
  1696. package/src/skills/catalog-install.ts +30 -10
  1697. package/src/skills/categories-cache.ts +9 -3
  1698. package/src/skills/clawhub-files.ts +21 -7
  1699. package/src/skills/clawhub.ts +18 -6
  1700. package/src/skills/frontmatter.ts +3 -1
  1701. package/src/skills/include-graph.ts +33 -11
  1702. package/src/skills/inline-command-expansions.ts +9 -3
  1703. package/src/skills/inline-command-runner.ts +6 -2
  1704. package/src/skills/install-meta.ts +17 -6
  1705. package/src/skills/managed-store.ts +3 -1
  1706. package/src/skills/remote-skill-policy.ts +6 -2
  1707. package/src/skills/skill-cache-store.ts +6 -2
  1708. package/src/skills/skillssh-files.ts +42 -14
  1709. package/src/skills/skillssh-registry.ts +18 -6
  1710. package/src/skills/validate-input.ts +60 -20
  1711. package/src/skills/version-hash.ts +6 -2
  1712. package/src/subagent/consult-prompt.ts +3 -1
  1713. package/src/subagent/consult-transcript.ts +6 -2
  1714. package/src/subagent/manager.ts +76 -25
  1715. package/src/subagent/notify.ts +8 -0
  1716. package/src/subagent/types.ts +13 -3
  1717. package/src/subagent/validate-allowlists.ts +6 -2
  1718. package/src/telegram/__tests__/webhook-health.test.ts +505 -0
  1719. package/src/telegram/webhook-health.ts +478 -0
  1720. package/src/telemetry/AGENTS.md +6 -0
  1721. package/src/telemetry/memory-corpus-size.test.ts +129 -0
  1722. package/src/telemetry/memory-corpus-size.ts +184 -0
  1723. package/src/telemetry/memory-tier-reporter.test.ts +67 -2
  1724. package/src/telemetry/memory-tier-reporter.ts +30 -3
  1725. package/src/telemetry/tool-usage-store.ts +6 -2
  1726. package/src/telemetry/watchdog-direct-emit.ts +6 -2
  1727. package/src/telemetry/watchdog-events-store.ts +6 -3
  1728. package/src/tools/__tests__/conversation-group-tool-input-schemas.test.ts +61 -0
  1729. package/src/tools/__tests__/document-tool-input-schemas.test.ts +103 -0
  1730. package/src/tools/__tests__/followup-call-acp-tool-input-schemas.test.ts +125 -0
  1731. package/src/tools/__tests__/schedule-tool-input-schemas.test.ts +83 -0
  1732. package/src/tools/__tests__/subagent-workflow-tool-input-schemas.test.ts +116 -0
  1733. package/src/tools/__tests__/tool-input-schemas.test.ts +192 -0
  1734. package/src/tools/__tests__/tool-schema-drift-harness.ts +142 -0
  1735. package/src/tools/acp/abort.ts +21 -1
  1736. package/src/tools/acp/context.ts +5 -5
  1737. package/src/tools/acp/spawn.test.ts +15 -5
  1738. package/src/tools/acp/spawn.ts +26 -3
  1739. package/src/tools/acp/status.ts +20 -1
  1740. package/src/tools/acp/steer.test.ts +20 -0
  1741. package/src/tools/acp/steer.ts +23 -2
  1742. package/src/tools/apps/resolve-app-id.ts +15 -3
  1743. package/src/tools/ask-question/ask-question-tool.test.ts +65 -0
  1744. package/src/tools/ask-question/ask-question-tool.ts +68 -92
  1745. package/src/tools/background-tool-registry.ts +6 -2
  1746. package/src/tools/browser/__tests__/auth-detector.test.ts +20 -0
  1747. package/src/tools/browser/__tests__/browser-untrusted-content.test.ts +512 -0
  1748. package/src/tools/browser/auth-cache.ts +6 -2
  1749. package/src/tools/browser/auth-detector.ts +24 -6
  1750. package/src/tools/browser/browser-execution.ts +245 -47
  1751. package/src/tools/browser/browser-manager.ts +66 -24
  1752. package/src/tools/browser/browser-screencast.ts +10 -6
  1753. package/src/tools/browser/cdp-client/__tests__/accessibility-snapshot.test.ts +27 -0
  1754. package/src/tools/browser/cdp-client/__tests__/browser-tabs-factory.test.ts +75 -27
  1755. package/src/tools/browser/cdp-client/__tests__/cdp-dom-helpers.test.ts +39 -14
  1756. package/src/tools/browser/cdp-client/__tests__/cdp-inspect-client.test.ts +9 -3
  1757. package/src/tools/browser/cdp-client/__tests__/types.test.ts +4 -1
  1758. package/src/tools/browser/cdp-client/accessibility-snapshot.ts +67 -19
  1759. package/src/tools/browser/cdp-client/cdp-dom-helpers.ts +15 -5
  1760. package/src/tools/browser/cdp-client/cdp-inspect/__tests__/ws-transport.test.ts +9 -3
  1761. package/src/tools/browser/cdp-client/cdp-inspect/discovery.ts +33 -11
  1762. package/src/tools/browser/cdp-client/cdp-inspect/ws-transport.ts +42 -14
  1763. package/src/tools/browser/cdp-client/cdp-inspect-client.ts +36 -11
  1764. package/src/tools/browser/cdp-client/extension-cdp-client.ts +9 -3
  1765. package/src/tools/browser/cdp-client/factory.ts +45 -27
  1766. package/src/tools/browser/cdp-client/local-cdp-client.ts +21 -6
  1767. package/src/tools/browser/cdp-client/types.ts +5 -1
  1768. package/src/tools/browser/network-recorder.ts +45 -15
  1769. package/src/tools/browser/pinned-tabs.ts +28 -9
  1770. package/src/tools/browser/runtime-check.ts +21 -7
  1771. package/src/tools/calls/call-end.ts +24 -3
  1772. package/src/tools/calls/call-start.ts +35 -11
  1773. package/src/tools/calls/call-status.ts +20 -1
  1774. package/src/tools/conversation-groups/group_create.ts +63 -0
  1775. package/src/tools/conversation-groups/group_list.ts +20 -0
  1776. package/src/tools/conversation-groups/group_shared.ts +52 -0
  1777. package/src/tools/conversation-groups/move_to_group.ts +106 -0
  1778. package/src/tools/credentials/broker.ts +3 -1
  1779. package/src/tools/credentials/domain-policy.ts +12 -4
  1780. package/src/tools/credentials/host-pattern-match.ts +3 -1
  1781. package/src/tools/credentials/post-connect-hooks.ts +6 -2
  1782. package/src/tools/credentials/resolve.ts +21 -7
  1783. package/src/tools/credentials/selection.ts +15 -5
  1784. package/src/tools/credentials/tool-policy.ts +6 -2
  1785. package/src/tools/document/document-comment-tool.test.ts +49 -0
  1786. package/src/tools/document/document-comment-tool.ts +45 -6
  1787. package/src/tools/document/document-tool.ts +142 -24
  1788. package/src/tools/execution-target.ts +3 -1
  1789. package/src/tools/executor.ts +27 -13
  1790. package/src/tools/filesystem/edit.ts +62 -60
  1791. package/src/tools/filesystem/fuzzy-match.ts +54 -18
  1792. package/src/tools/filesystem/list.ts +36 -29
  1793. package/src/tools/filesystem/read.ts +56 -39
  1794. package/src/tools/filesystem/search.ts +34 -12
  1795. package/src/tools/filesystem/write.ts +56 -42
  1796. package/src/tools/followups/followup_create.ts +41 -12
  1797. package/src/tools/followups/followup_list.ts +34 -6
  1798. package/src/tools/followups/followup_resolve.ts +26 -4
  1799. package/src/tools/host-filesystem/edit.ts +50 -60
  1800. package/src/tools/host-filesystem/read.ts +45 -39
  1801. package/src/tools/host-filesystem/write.ts +31 -36
  1802. package/src/tools/host-terminal/host-shell.ts +76 -62
  1803. package/src/tools/network/__tests__/web-search-metadata.test.ts +9 -3
  1804. package/src/tools/network/__tests__/web-search.test.ts +111 -4
  1805. package/src/tools/network/domain-normalize.ts +12 -4
  1806. package/src/tools/network/managed-search-proxy.ts +24 -8
  1807. package/src/tools/network/script-proxy/session-manager.ts +39 -13
  1808. package/src/tools/network/url-safety.ts +63 -21
  1809. package/src/tools/network/web-fetch.ts +62 -21
  1810. package/src/tools/network/web-search-error.ts +30 -13
  1811. package/src/tools/network/web-search.ts +237 -10
  1812. package/src/tools/policy-context.ts +27 -10
  1813. package/src/tools/schedule/create.ts +94 -33
  1814. package/src/tools/schedule/delete.ts +21 -2
  1815. package/src/tools/schedule/list.ts +25 -3
  1816. package/src/tools/schedule/update.ts +122 -48
  1817. package/src/tools/sensitive-output-placeholders.ts +15 -5
  1818. package/src/tools/shared/filesystem/file-ops-service.ts +6 -2
  1819. package/src/tools/shared/filesystem/image-read.ts +3 -1
  1820. package/src/tools/shared/filesystem/path-policy.ts +246 -40
  1821. package/src/tools/shared/filesystem/size-guard.ts +6 -2
  1822. package/src/tools/shared/zod-tool-schema.ts +117 -0
  1823. package/src/tools/skills/execute.ts +24 -8
  1824. package/src/tools/skills/find-similar-skills.ts +6 -2
  1825. package/src/tools/skills/load.ts +25 -9
  1826. package/src/tools/skills/sandbox-runner.ts +6 -2
  1827. package/src/tools/subagent/abort.ts +12 -4
  1828. package/src/tools/subagent/consult-deadline.ts +9 -3
  1829. package/src/tools/subagent/message.ts +21 -5
  1830. package/src/tools/subagent/notify-parent.ts +44 -23
  1831. package/src/tools/subagent/read.ts +15 -4
  1832. package/src/tools/subagent/resolve.ts +26 -4
  1833. package/src/tools/subagent/spawn.ts +37 -13
  1834. package/src/tools/subagent/status.ts +12 -4
  1835. package/src/tools/system/request-permission.ts +35 -26
  1836. package/src/tools/terminal/shell.ts +68 -55
  1837. package/src/tools/tool-approval-handler.ts +327 -53
  1838. package/src/tools/tool-input-schemas.ts +85 -0
  1839. package/src/tools/tool-input-summary.ts +3 -1
  1840. package/src/tools/tool-name-aliases.ts +3 -1
  1841. package/src/tools/tool-types.ts +7 -0
  1842. package/src/tools/types.ts +8 -0
  1843. package/src/tools/verification-control-plane-policy.ts +12 -4
  1844. package/src/tools/workflows/manage-workflows.ts +35 -4
  1845. package/src/tools/workflows/run-workflow.test.ts +54 -2
  1846. package/src/tools/workflows/run-workflow.ts +32 -4
  1847. package/src/tts/__tests__/provider-adapters.test.ts +9 -3
  1848. package/src/tts/__tests__/speakable-segments.test.ts +4 -4
  1849. package/src/tts/providers/__tests__/xai-tts-socket.test.ts +26 -12
  1850. package/src/tts/providers/deepgram-provider.ts +3 -1
  1851. package/src/tts/providers/elevenlabs-provider.ts +9 -3
  1852. package/src/tts/providers/fish-audio-provider.ts +3 -1
  1853. package/src/tts/providers/xai-provider.ts +3 -1
  1854. package/src/tts/providers/xai-tts-socket.ts +36 -11
  1855. package/src/tts/synthesize-text.ts +3 -1
  1856. package/src/usage/pricing.ts +27 -9
  1857. package/src/util/abort-reasons.ts +3 -1
  1858. package/src/util/bun-runtime.ts +9 -3
  1859. package/src/util/bundled-asset.ts +6 -2
  1860. package/src/util/canonicalize-identity.ts +3 -1
  1861. package/src/util/cgroup-memory.ts +12 -4
  1862. package/src/util/debounce.ts +11 -4
  1863. package/src/util/diff.ts +18 -6
  1864. package/src/util/disk-usage.ts +15 -5
  1865. package/src/util/favicon.ts +9 -3
  1866. package/src/util/fs-symlinks.ts +30 -0
  1867. package/src/util/fs.ts +3 -1
  1868. package/src/util/image-conversion.ts +15 -5
  1869. package/src/util/log-redact.ts +13 -5
  1870. package/src/util/logger.ts +15 -5
  1871. package/src/util/phone.ts +6 -2
  1872. package/src/util/platform.ts +33 -6
  1873. package/src/util/pricing.ts +30 -10
  1874. package/src/util/process-liveness.ts +6 -2
  1875. package/src/util/promise-guard.ts +3 -1
  1876. package/src/util/retry.ts +21 -7
  1877. package/src/util/row-mapper.ts +6 -2
  1878. package/src/util/spinner.ts +6 -2
  1879. package/src/util/strip-comment-lines.ts +3 -1
  1880. package/src/util/time.ts +18 -6
  1881. package/src/util/truncate.ts +6 -2
  1882. package/src/util/unicode.ts +9 -3
  1883. package/src/util/xml.ts +1 -4
  1884. package/src/vellum-assistant-namespace.d.ts +80 -0
  1885. package/src/version.ts +9 -3
  1886. package/src/watcher/__tests__/engine.test.ts +6 -2
  1887. package/src/watcher/providers/github.ts +17 -6
  1888. package/src/watcher/providers/google-calendar.ts +27 -9
  1889. package/src/watcher/providers/linear.ts +15 -5
  1890. package/src/watcher/providers/outlook-calendar.ts +3 -1
  1891. package/src/watcher/telemetry.ts +3 -1
  1892. package/src/watcher/watcher-store.ts +40 -12
  1893. package/src/workflows/deterministic-stringify.ts +6 -2
  1894. package/src/workflows/engine-integration.test.ts +3 -1
  1895. package/src/workflows/engine.test.ts +17 -6
  1896. package/src/workflows/engine.ts +88 -32
  1897. package/src/workflows/journal-store.ts +3 -1
  1898. package/src/workflows/leaf-runner.test.ts +104 -2
  1899. package/src/workflows/leaf-runner.ts +40 -8
  1900. package/src/workflows/library.test.ts +5 -2
  1901. package/src/workflows/library.ts +15 -5
  1902. package/src/workflows/run-manager.test.ts +9 -3
  1903. package/src/workflows/run-manager.ts +18 -6
  1904. package/src/workflows/sandbox.ts +6 -2
  1905. package/src/workspace/adaptive-thinking-repair.ts +33 -11
  1906. package/src/workspace/commit-message-enrichment-service.ts +15 -5
  1907. package/src/workspace/git-service.ts +12 -4
  1908. package/src/workspace/hatched-date.ts +12 -4
  1909. package/src/workspace/heartbeat-service.ts +3 -1
  1910. package/src/workspace/migrations/003-seed-device-id.ts +12 -4
  1911. package/src/workspace/migrations/004-extract-collect-usage-data.ts +27 -9
  1912. package/src/workspace/migrations/006-services-config.ts +17 -6
  1913. package/src/workspace/migrations/007-web-search-provider-rename.ts +34 -10
  1914. package/src/workspace/migrations/010-app-dir-rename.ts +21 -7
  1915. package/src/workspace/migrations/012-rename-conversation-disk-view-dirs.ts +30 -10
  1916. package/src/workspace/migrations/016-extract-feature-flags-to-protected.ts +12 -4
  1917. package/src/workspace/migrations/017-seed-persona-dirs.ts +15 -5
  1918. package/src/workspace/migrations/018-rekey-compound-credential-keys.ts +30 -10
  1919. package/src/workspace/migrations/019-scope-journal-to-guardian.ts +18 -6
  1920. package/src/workspace/migrations/020-rename-oauth-skill-dirs.ts +6 -2
  1921. package/src/workspace/migrations/021-move-signals-to-workspace.ts +6 -2
  1922. package/src/workspace/migrations/022-move-hooks-to-workspace.ts +6 -2
  1923. package/src/workspace/migrations/023-move-config-files-to-workspace.ts +6 -2
  1924. package/src/workspace/migrations/024-move-runtime-files-to-workspace.ts +6 -2
  1925. package/src/workspace/migrations/025-remove-oauth-app-setup-skills.ts +3 -1
  1926. package/src/workspace/migrations/026-backfill-install-meta.ts +27 -9
  1927. package/src/workspace/migrations/028-recover-conversations-from-disk-view.ts +9 -3
  1928. package/src/workspace/migrations/029-seed-pkb.ts +3 -1
  1929. package/src/workspace/migrations/030-seed-pkb-autoinject.ts +6 -2
  1930. package/src/workspace/migrations/031-drop-user-md.ts +25 -10
  1931. package/src/workspace/migrations/031-llm-log-retention-zero-to-null.ts +28 -10
  1932. package/src/workspace/migrations/032-tts-provider-unification.ts +33 -11
  1933. package/src/workspace/migrations/033-stt-service-explicit-config.ts +12 -4
  1934. package/src/workspace/migrations/034-remove-calls-voice-transcription-provider.ts +24 -8
  1935. package/src/workspace/migrations/036-update-pkb-index-bar.ts +6 -2
  1936. package/src/workspace/migrations/037-create-meets-dir.ts +3 -1
  1937. package/src/workspace/migrations/038-unify-llm-callsite-configs.ts +27 -9
  1938. package/src/workspace/migrations/039-drop-legacy-llm-keys.ts +9 -3
  1939. package/src/workspace/migrations/040-seed-latency-callsite-defaults.ts +15 -5
  1940. package/src/workspace/migrations/041-backfill-google-gmail-settings-scope.ts +9 -3
  1941. package/src/workspace/migrations/042-fix-backfill-google-gmail-settings-scope.ts +9 -3
  1942. package/src/workspace/migrations/044-bump-stale-provider-stream-timeout.ts +11 -4
  1943. package/src/workspace/migrations/046-seed-conversation-starters-callsite.ts +12 -4
  1944. package/src/workspace/migrations/047-remove-watch-callsites.ts +18 -5
  1945. package/src/workspace/migrations/050-seed-main-agent-opus-callsite.ts +9 -3
  1946. package/src/workspace/migrations/051-seed-conversation-summarization-callsite.ts +12 -4
  1947. package/src/workspace/migrations/052-seed-default-inference-profiles.ts +12 -4
  1948. package/src/workspace/migrations/054-seed-recall-callsite.ts +12 -4
  1949. package/src/workspace/migrations/057-repair-stale-gemini-model-ids.ts +39 -13
  1950. package/src/workspace/migrations/059-move-pid-to-workspace.ts +6 -2
  1951. package/src/workspace/migrations/061-move-backup-key-to-workspace.ts +6 -2
  1952. package/src/workspace/migrations/064-unwind-main-agent-opus-seed.ts +21 -7
  1953. package/src/workspace/migrations/065-bump-stale-heartbeat-interval.ts +12 -3
  1954. package/src/workspace/migrations/066-seed-heartbeat-callsite-cost-default.ts +18 -6
  1955. package/src/workspace/migrations/069-seed-onboarding-threads.ts +9 -3
  1956. package/src/workspace/migrations/070-memory-v2-summary-schema-rebuild.ts +2 -2
  1957. package/src/workspace/migrations/072-seed-reply-suggestion-callsite.ts +12 -4
  1958. package/src/workspace/migrations/073-repair-recall-callsite-empty-profile.ts +21 -7
  1959. package/src/workspace/migrations/074-drop-deprecated-secret-detection-keys.ts +12 -4
  1960. package/src/workspace/migrations/075-memory-v2-bm25-b-default-reembed.ts +9 -3
  1961. package/src/workspace/migrations/076-drop-services-inference-mode.ts +13 -5
  1962. package/src/workspace/migrations/077-seed-memory-router-callsite.ts +9 -3
  1963. package/src/workspace/migrations/079-home-feed-notification-only.ts +21 -7
  1964. package/src/workspace/migrations/080-restrict-vercel-api-token-metadata.ts +3 -1
  1965. package/src/workspace/migrations/081-backfill-bash-allowed-tools-for-injection-credentials.ts +9 -3
  1966. package/src/workspace/migrations/082-backfill-managed-profile-labels.ts +15 -5
  1967. package/src/workspace/migrations/083-system-prompt-prefix-to-file.ts +8 -3
  1968. package/src/workspace/migrations/084-remove-legacy-skills-index.ts +42 -14
  1969. package/src/workspace/migrations/085-memory-v2-bm25-b-reembed-disabled-v2-pages.ts +12 -4
  1970. package/src/workspace/migrations/086-revert-stale-gemini-mis-rewrites.ts +33 -11
  1971. package/src/workspace/migrations/087-memory-router-balanced-profile.ts +15 -5
  1972. package/src/workspace/migrations/088-deprecate-background-conversation-override.ts +9 -3
  1973. package/src/workspace/migrations/089-move-memory-tree-out-of-v3.ts +6 -2
  1974. package/src/workspace/migrations/090-memory-router-cost-optimized-profile.ts +21 -7
  1975. package/src/workspace/migrations/091-retighten-migration-onboarding-thread.ts +9 -3
  1976. package/src/workspace/migrations/092-backfill-v3-leaves.ts +30 -10
  1977. package/src/workspace/migrations/093-backfill-leaf-ids.ts +15 -5
  1978. package/src/workspace/migrations/094-seed-avatar-manifest.ts +9 -3
  1979. package/src/workspace/migrations/095-bump-heartbeat-interval-30m-to-60m.ts +12 -3
  1980. package/src/workspace/migrations/096-reduce-quality-profile-effort.ts +18 -6
  1981. package/src/workspace/migrations/097-enable-adaptive-thinking-managed-profiles.ts +27 -9
  1982. package/src/workspace/migrations/099-disable-cache-one-shot-callsites.ts +24 -8
  1983. package/src/workspace/migrations/100-upgrade-quality-profile-to-fable-5.ts +21 -7
  1984. package/src/workspace/migrations/101-upgrade-balanced-economy-to-minimax-m3.ts +15 -5
  1985. package/src/workspace/migrations/102-preserve-heartbeat-enabled-for-existing-workspaces.ts +9 -3
  1986. package/src/workspace/migrations/103-upgrade-quality-profile-to-opus-4-8.ts +21 -7
  1987. package/src/workspace/migrations/104-recheck-adaptive-thinking-model-implied-anthropic.ts +27 -9
  1988. package/src/workspace/migrations/105-enable-memory-v3-live-for-new-workspaces.ts +21 -7
  1989. package/src/workspace/migrations/106-drop-collect-usage-data.ts +9 -3
  1990. package/src/workspace/migrations/107-drop-send-diagnostics.ts +9 -3
  1991. package/src/workspace/migrations/108-drop-balanced-economy-profile.ts +18 -6
  1992. package/src/workspace/migrations/109-swap-quality-profile-to-glm-5p2.ts +9 -3
  1993. package/src/workspace/migrations/110-flip-balanced-profile-to-together.ts +12 -4
  1994. package/src/workspace/migrations/111-prune-seeded-callsite-defaults.ts +36 -12
  1995. package/src/workspace/migrations/112-remove-advisor-callsite-override.ts +18 -5
  1996. package/src/workspace/migrations/113-swap-balanced-profile-to-glm-5p2.ts +18 -6
  1997. package/src/workspace/migrations/114-swap-quality-profile-to-opus.ts +12 -4
  1998. package/src/workspace/migrations/115-drop-frontier-profile.ts +18 -6
  1999. package/src/workspace/migrations/117-normalize-stale-lean-memory-v3-defaults.ts +15 -5
  2000. package/src/workspace/migrations/118-seed-now-md.ts +3 -1
  2001. package/src/workspace/migrations/119-strip-persisted-memory-v3-tuning-defaults.ts +18 -6
  2002. package/src/workspace/migrations/120-revise-onboarding-threads.ts +9 -3
  2003. package/src/workspace/migrations/121-seed-default-user-guardrails.ts +3 -1
  2004. package/src/workspace/migrations/123-swap-quality-profile-to-fable.ts +24 -8
  2005. package/src/workspace/migrations/125-repoint-managed-connections-to-vellum.ts +21 -7
  2006. package/src/workspace/migrations/126-strip-managed-profile-bodies.ts +21 -7
  2007. package/src/workspace/migrations/129-remove-analyze-conversation-config.ts +9 -3
  2008. package/src/workspace/migrations/130-speech-mode-to-provider.ts +24 -8
  2009. package/src/workspace/migrations/131-drop-web-fetch-mode.ts +13 -5
  2010. package/src/workspace/migrations/133-collapse-provider-connections.ts +30 -10
  2011. package/src/workspace/migrations/134-image-generation-mode-to-provider.ts +128 -0
  2012. package/src/workspace/migrations/135-copy-substrate-tunables.ts +248 -0
  2013. package/src/workspace/migrations/136-repair-stale-fireworks-kimi-model-id.ts +127 -0
  2014. package/src/workspace/migrations/__tests__/135-copy-substrate-tunables.test.ts +446 -0
  2015. package/src/workspace/migrations/__tests__/backfill-leaf-ids.test.ts +3 -1
  2016. package/src/workspace/migrations/__tests__/backfill-v3-leaves.test.ts +2 -2
  2017. package/src/workspace/migrations/migrate-to-workspace-volume.ts +9 -3
  2018. package/src/workspace/migrations/rebuild-conversation-disk-view.ts +23 -8
  2019. package/src/workspace/migrations/registry.ts +6 -0
  2020. package/src/workspace/migrations/utils.ts +3 -1
  2021. package/src/workspace/top-level-renderer.ts +3 -1
  2022. package/tsconfig.plugin-api.json +1 -1
  2023. package/src/__tests__/history-repair-hook.test.ts +0 -392
  2024. package/src/__tests__/memory-retrieval-budget.test.ts +0 -49
  2025. package/src/__tests__/secret-patterns.test.ts +0 -27
  2026. package/src/config/__tests__/proc-to-skills.test.ts +0 -21
  2027. package/src/config/memory-tier.test.ts +0 -44
  2028. package/src/daemon/__tests__/route-conversation-post.test.ts +0 -158
  2029. package/src/daemon/message-types/acp.ts +0 -20
  2030. package/src/daemon/message-types/apps.ts +0 -11
  2031. package/src/daemon/message-types/background-tools.ts +0 -14
  2032. package/src/daemon/message-types/bookmarks.ts +0 -13
  2033. package/src/daemon/message-types/contacts.ts +0 -13
  2034. package/src/daemon/message-types/document-comments.ts +0 -14
  2035. package/src/daemon/message-types/documents.ts +0 -13
  2036. package/src/daemon/message-types/home.ts +0 -15
  2037. package/src/daemon/message-types/host-bash.ts +0 -12
  2038. package/src/daemon/message-types/host-cu.ts +0 -10
  2039. package/src/daemon/message-types/host-file.ts +0 -12
  2040. package/src/daemon/message-types/host-transfer.ts +0 -12
  2041. package/src/daemon/message-types/integrations.ts +0 -90
  2042. package/src/daemon/message-types/memory.ts +0 -10
  2043. package/src/daemon/message-types/schedules.ts +0 -14
  2044. package/src/daemon/message-types/settings.ts +0 -17
  2045. package/src/daemon/message-types/subagents.ts +0 -63
  2046. package/src/daemon/message-types/upgrades.ts +0 -14
  2047. package/src/daemon/message-types/workflows.ts +0 -25
  2048. package/src/daemon/message-types/workspace.ts +0 -137
  2049. package/src/daemon/route-conversation-post.ts +0 -158
  2050. package/src/live-voice/ack-phrases.ts +0 -58
  2051. package/src/plugins/defaults/history-repair/hooks/post-model-call.ts +0 -50
  2052. package/src/plugins/defaults/history-repair/hooks/stop.ts +0 -22
  2053. package/src/plugins/defaults/history-repair/hooks/user-prompt-submit.ts +0 -35
  2054. package/src/plugins/defaults/history-repair/package.json +0 -14
  2055. package/src/plugins/defaults/history-repair/repair-state-store.ts +0 -51
  2056. package/src/plugins/defaults/memory/retrieval-budget.ts +0 -29
  2057. package/src/plugins/defaults/memory/v3/__tests__/gate-flag.test.ts +0 -69
  2058. package/src/plugins/defaults/memory/v3/gate-flag.ts +0 -20
  2059. package/src/plugins/defaults/memory/v3/substrate/__tests__/memory-v2-startup.test.ts +0 -86
  2060. package/src/plugins/defaults/memory/v3/substrate/memory-v2-startup.test.ts +0 -205
  2061. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/concept-page-frontmatter-schema.test.ts +0 -0
  2062. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/consolidation-prompt-flag-gating-guard.test.ts +0 -0
  2063. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/__tests__/injected-block-slugs.test.ts +0 -0
  2064. /package/src/plugins/defaults/memory/{v3/substrate → substrate}/cli-command-content.ts +0 -0
package/AGENTS.md CHANGED
@@ -89,7 +89,7 @@ The rule exists because test machinery and production code have **inverted invar
89
89
 
90
90
  Concretely:
91
91
 
92
- - **Test helpers** (e.g. `src/__tests__/*-test-helpers.ts`) use only node stdlib, `bun:test`, and sibling helpers. If they need to manipulate shared state that production code also reads, both sides declare a typed slot under `globalThis.vellumAssistant.*` and read/write that slot independently. The slot shape is duplicated by design — the helper and the production module both reference the namespace, neither imports the other.
92
+ - **Test helpers** (e.g. `src/__tests__/*-test-helpers.ts`) use only node stdlib, `bun:test`, and sibling helpers. If they need to manipulate shared state that production code also reads, both sides read/write a typed slot under `globalThis.vellumAssistant.*`. The namespace shape is declared once, in the ambient `src/vellum-assistant-namespace.d.ts` (`VellumAssistantNamespace` and its slot value types) — the helper and the production module both refer to those global types by name, so they agree on the shape without either importing the other. Because that declaration is ambient (pure compile-time type info that reaches into no `src/` module), referring to it adds nothing to a helper's runtime import graph, so the no-`src/`-imports invariant still holds. To add a slot: declare its value type in that `.d.ts`, add the optional property to `VellumAssistantNamespace`, and have the owning module plus its test helper reference those globals instead of declaring their own copies.
93
93
  - **The test preload** (`src/__tests__/test-preload.ts`) is the strictest: it must not import from `src/` at all. Its only static imports are node stdlib, `bun:test`, and helpers in `src/__tests__/`. Importing from a source module risks running its import-time side effects before the workspace override is set.
94
94
  - **The preload verifier** (`src/__tests__/test-preload-verifier.ts`) runs after the main preload and asserts the override took effect (`VELLUM_WORKSPACE_DIR` must resolve under `os.tmpdir()`).
95
95
  - **Destructive ops** (e.g. `rmSync(dbPath, ...)`) in tests must call `assertNotLiveDb(path)` from `src/__tests__/assert-not-live-db.js` immediately before the destructive call. The check is a per-callsite belt to the preload-verifier suspenders.
package/ARCHITECTURE.md CHANGED
@@ -374,10 +374,9 @@ External users who are not the guardian can gain access to the assistant through
374
374
  **Notification signals:** The flow emits signals at each lifecycle transition via `emitNotificationSignal()`:
375
375
 
376
376
  - `ingress.access_request` — unknown contact denied, guardian notified
377
- - `ingress.trusted_contact.guardian_decision` — guardian approved or denied
378
- - `ingress.trusted_contact.verification_sent` — code created and delivered
377
+ - `ingress.trusted_contact.guardian_decision` — the guardian's verdict (the payload's `decision` field carries approved/denied; exactly one lifecycle signal fires per denial)
378
+ - `ingress.trusted_contact.verification_sent` — code created and delivered (stands in for `guardian_decision` on approve so the pipeline doesn't announce approval before verification)
379
379
  - `ingress.trusted_contact.activated` — requester verified, contact active
380
- - `ingress.trusted_contact.denied` — guardian explicitly denied
381
380
 
382
381
  **HTTP API (for management):**
383
382
 
@@ -752,7 +751,7 @@ Conversation starters follow the same pattern via `GET /v1/conversation-starters
752
751
 
753
752
  The assistant feature-flag resolver (`src/config/assistant-feature-flags.ts`) is the canonical module for determining whether an assistant feature flag is enabled. It loads default values from the unified registry at `meta/feature-flags/feature-flag-registry.json` (bundled copy at `src/config/feature-flag-registry.json`) and resolves the effective state for each declared assistant-scope flag. Assistant feature flags are declaration-driven assistant-scoped booleans that can gate any assistant behavior; skill availability is one consumer.
754
753
 
755
- **Canonical key format:** Simple kebab-case (e.g., `contacts`, `voice-mode`).
754
+ **Canonical key format:** Simple kebab-case (e.g., `contacts`, `browser`).
756
755
 
757
756
  **Resolution priority** (highest wins):
758
757
 
@@ -780,7 +779,7 @@ The assistant feature-flag resolver (`src/config/assistant-feature-flags.ts`) is
780
779
 
781
780
  All six enforcement points derive the flag key via `skillFlagKey(skill)` — which returns `undefined` for ungated skills, short-circuiting the check — and then call `isAssistantFeatureFlagEnabled(flagKey, config)` for consistency.
782
781
 
783
- **Migration path:** The legacy `skills.<id>.enabled` and `feature_flags.<id>.enabled` key formats are no longer supported. All code must use simple kebab-case keys (e.g., `contacts`, `voice-mode`). Guard tests enforce canonical key usage and declaration coverage for literal key references in the unified registry.
782
+ **Migration path:** The legacy `skills.<id>.enabled` and `feature_flags.<id>.enabled` key formats are no longer supported. All code must use simple kebab-case keys (e.g., `contacts`, `browser`). Guard tests enforce canonical key usage and declaration coverage for literal key references in the unified registry.
784
783
 
785
784
  **Key source files:**
786
785
 
package/README.md CHANGED
@@ -145,7 +145,7 @@ All approval prompt delivery paths use a **fail-closed** policy -- if the prompt
145
145
 
146
146
  ### Plain-Text Fallback for Non-Rich Channels
147
147
 
148
- Channels that do not support rich inline approval UI (e.g., inline keyboards) receive plain-text instructions embedded in the message body. The `channelSupportsRichApprovalUI()` check determines whether to send the structured `promptText` (for rich channels like Telegram) or the `plainTextFallback` string (for all other channels). The fallback text includes instructions so the user can respond via text; the conversational approval engine then classifies the free-text response.
148
+ Channels that do not support rich inline approval UI (e.g., inline keyboards) receive plain-text instructions embedded in the message body. The `supportsInlineOptions` channel capability (`channelSupportsInlineOptions()`) determines whether to send the structured `promptText` (for channels whose adapter renders inline buttons like Telegram) or the `plainTextFallback` string (for all other channels). The fallback text includes instructions so the user can respond via text; the conversational approval engine then classifies the free-text response.
149
149
 
150
150
  ### Key modules
151
151
 
@@ -1,31 +1,53 @@
1
1
  # Memory Architecture
2
2
 
3
- Assistant memory and context-injection architecture.
3
+ Assistant memory and context-injection architecture. For the memory plugin's
4
+ internal layering contract — the tier/directory map, the frozen-name registry,
5
+ and the v1/v2 deletion runbooks — see
6
+ `src/plugins/defaults/memory/AGENTS.md`.
4
7
 
5
8
  ## Tiers
6
9
 
7
10
  An assistant runs exactly one memory tier, derived by `memoryTier()` in
8
11
  `src/config/memory-tier.ts`:
9
12
 
10
- | Tier | Selected when | Injection source |
11
- | ----- | -------------------------------------------- | --------------------------------------------- |
12
- | `off` | `memory.enabled === false` | none |
13
- | `v3` | `memory.v3.live === true` | v3 lanes + card (`v3/injector.ts`) |
14
- | `v2` | `memory.v2.enabled === true` and v3 not live | v2 activation/router engine (`v2/`) |
15
- | `v1` | otherwise | PKB `<knowledge_base>` block (`pkb/`, legacy) |
13
+ | Tier | Selected when | Injection source |
14
+ | ----- | -------------------------------------------- | ------------------------------------------------ |
15
+ | `off` | `memory.enabled === false` | none |
16
+ | `v3` | `memory.v3.live === true` | v3 lanes + card (`v3/injector.ts`) |
17
+ | `v2` | `memory.v2.enabled === true` and v3 not live | v2 activation/router engine (`v2/`) |
18
+ | `v1` | otherwise | PKB `<knowledge_base>` block (`v1/pkb/`, legacy) |
16
19
 
17
20
  New workspaces are switched to `v3` at creation (workspace migration 105).
18
21
  `v1` and the `v2` injection engine are in retirement; v3 is the target state.
19
22
 
20
- ## The concept-page substrate (`v3/substrate/`)
23
+ ### Tier predicates
24
+
25
+ Tier decisions are made through named predicates in
26
+ `src/config/memory-v3-gate.ts`, never by reading `memory.v2.*` / `memory.v3.*`
27
+ directly — `memory.v2.enabled` defaults true and typically stays set on v3-live
28
+ assistants, so a raw read misbehaves under v3. `memoryTier()` is fully derived
29
+ from those predicates, so the telemetry buckets and the runtime gates can never
30
+ disagree. The two that shape this document are `usesConceptPageMemory()` (the
31
+ substrate is live) and `isMemoryV3Live()` (v3 is the injected source).
32
+
33
+ The full predicate table — what each one is true for and, importantly, exactly
34
+ which machinery it gates — is in `src/plugins/defaults/memory/AGENTS.md`, which
35
+ is authoritative. Consult it before gating new code.
36
+
37
+ The memory plugin is layered into tier directories (`substrate/`, `v1/`, `v2/`,
38
+ `v3/`) that never import each other — multi-tier composition is confined to a
39
+ frozen set of spine files, and both rules plus the raw-tier-key ban are enforced
40
+ by `src/plugins/defaults/memory/__tests__/memory-tier-boundary-guard.test.ts`.
41
+
42
+ ## The concept-page substrate (`substrate/`)
21
43
 
22
44
  The durable core shared by v2 and v3 is the **concept-page substrate**:
23
45
  markdown articles under `memory/concepts/` (plus the aggregate views
24
46
  `essentials.md`, `threads.md`, `recent.md` and the intake `buffer.md`), their
25
47
  cached page index, and the concept-page Qdrant collection with dense + BM25
26
48
  sparse vectors. It lives in
27
- `src/plugins/defaults/memory/v3/substrate/` because it is memory-v3's
28
- foundation — the v2 injection engine is just a second (transitional) consumer.
49
+ `src/plugins/defaults/memory/substrate/`; it is memory-v3's foundation, and
50
+ the v2 injection engine is a second (transitional) consumer.
29
51
 
30
52
  Substrate activation is a single predicate, `usesConceptPageMemory()` in
31
53
  `src/config/memory-v3-gate.ts`: memory on AND (`memory.v3.live` OR
@@ -50,7 +72,7 @@ graph LR
50
72
  - `handleRemember` (`graph/tool-handlers.ts`) appends timestamped bullets to
51
73
  `memory/buffer.md` + the daily archive whenever memory is enabled. Facts may
52
74
  carry `[[slug]]` page hints that consolidation reads first when filing.
53
- - **Consolidation** (`v3/substrate/consolidation-job.ts`) is a background
75
+ - **Consolidation** (`substrate/consolidation-job.ts`) is a background
54
76
  agent conversation that files buffer entries into concept pages, rewrites
55
77
  the aggregate views, and trims the buffer. Scheduling
56
78
  (`maybeEnqueueGraphMaintenanceJobs` in `jobs-worker.ts`):
@@ -67,10 +89,10 @@ graph LR
67
89
  ### Read paths
68
90
 
69
91
  - **v3 (live)**: per-turn lane selection over concept pages — dense/sparse
70
- retrieval (`v3/substrate/sim.ts` over the concept-page collection),
92
+ retrieval (`substrate/sim.ts` over the concept-page collection),
71
93
  learned edges, entity/hot/fresh/core sets — rendered as the `<memory>`
72
94
  card by `v3/injector.ts`. The static `<info>` block
73
- (`v3/substrate/static-context.ts`: essentials/threads/recent/buffer) also
95
+ (`substrate/static-context.ts`: essentials/threads/recent/buffer) also
74
96
  injects whenever the substrate is active.
75
97
  - **v2 (transitional)**: activation/router engine in `v2/`
76
98
  (`activation.ts`, `router.ts`, `reranker.ts`, `injection.ts`) selects
@@ -82,7 +104,7 @@ graph LR
82
104
 
83
105
  ### Boot-time maintenance
84
106
 
85
- `v3/substrate/memory-v2-startup.ts`, invoked from the memory plugin's
107
+ `substrate/boot-maintenance.ts`, invoked from the memory plugin's
86
108
  startup path: skill + CLI-command capability seeding into the concept-page
87
109
  collection, BM25 corpus-stats rebuild, and collection schema
88
110
  reconcile/reembed. All gated on `usesConceptPageMemory()`.
@@ -94,22 +116,44 @@ substrate as a backend-agnostic node/edge graph for the web Memory tab:
94
116
  concept pages as nodes, authored links + learned co-selection associations as
95
117
  edges, and `memory/buffer.md` entries as `pending` nodes
96
118
  (`graph-topology/pending-buffer.ts`) so a just-saved fact appears before
97
- consolidation files it. Gated on the `memory-concept-graph` feature flag +
98
- `memory.v3.live`. `GET /v1/memory-graph-node` serves node detail, including
99
- `buffer:` ids for pending entries.
119
+ consolidation files it. Gated on `isV3TierActive()` — memory enabled and
120
+ `memory.v3.live` — which is also the source of the cheap `graph_supported`
121
+ bit on `GET /v1/memory/stats`, so the advertised capability and the actual
122
+ build can never drift. The same predicate gates procedural-memory-as-skills,
123
+ so both v3-tier features honor the Memory opt-out identically. `GET /v1/memory-graph-node` serves node detail,
124
+ including `buffer:` ids for pending entries.
125
+
126
+ `GET /v1/memory/stats` also reports `tier` (`memoryTier()`: `off` / `v1` /
127
+ `v2` / `v3`), which is what lets the web Memory tab explain an unavailable
128
+ graph instead of stating a bare "not available": `off` is the user's own
129
+ Memory opt-out and points at Settings, while `v1`/`v2` point at the v3
130
+ migration. `graph_supported` is exactly `tier === "v3"`, so the capability
131
+ bit and its explanation are derived from one gate.
100
132
 
101
133
  ## Capture beyond `remember`
102
134
 
103
135
  - **Retrospective** (`memory-retrospective-*.ts`): periodic per-conversation
104
136
  review pass that saves what wasn't captured in the moment (and, on v3-live
105
137
  assistants, authors procedural skills).
106
- - **Sweep** (`v3/substrate/sweep-job.ts`, `memory.v2.sweep_enabled`, default
107
- off): idle-debounced extraction of recent messages into the buffer.
138
+ - **Sweep** (`substrate/sweep-job.ts`, `sweep_enabled` substrate tunable,
139
+ default off): idle-debounced extraction of recent messages into the buffer.
108
140
 
109
141
  ## Config namespaces
110
142
 
111
- Substrate tuning still lives under the historical `memory.v2.*` keys
112
- (consolidation intervals/limits, embedding + retrieval weights) and v3 lane
113
- tuning under `memory.v3.*`. The `memory.v2.enabled` flag gates only the v2
114
- injection engine's turn-time selection; the substrate runs whenever
143
+ Substrate tuning resolves from `memory.substrate.*` with fallback to the
144
+ historical `memory.v2.*` keys: every substrate tunable (consolidation
145
+ intervals/limits, embedding + retrieval weights, BM25 parameters, sweep
146
+ toggle) is optional under `memory.substrate`, and `resolveSubstrateTuning`
147
+ (`substrate/tuning.ts`) — the substrate's single config choke point — falls
148
+ back per key to the `memory.v2` twin, which supplies the effective defaults
149
+ and which the v2 injection engine also reads. v2 engine-only keys (activation
150
+ weights, router, rerank) live only under `memory.v2.*`, and v3 lane tuning
151
+ under `memory.v3.*`. The `memory.v2.enabled` flag gates only the v2 injection
152
+ engine's turn-time selection; the substrate runs whenever
115
153
  `usesConceptPageMemory()` holds.
154
+
155
+ `src/plugins/defaults/memory/AGENTS.md` carries the details that matter when
156
+ you touch this: the three substrate keys whose names differ from their v2 twin,
157
+ the three disjoint places the dense/sparse sum-to-1 invariant is checked, and
158
+ why workspace migration 135 copies only explicitly-set NON-DEFAULT `memory.v2`
159
+ tunables into `memory.substrate`.
@@ -71,11 +71,11 @@ Returning `undefined` is acceptable only for **lookup functions** where "not fou
71
71
  | Subagent manager (`subagent/manager.ts`) | Throws for precondition violations, string literal unions for expected outcomes | Depth limit exceeded is a bug; `sendMessage` returns `'not_found' \| 'terminal' \| 'queue_full'` as expected states |
72
72
  | Interactive UI (`cli/commands/ui.ts`) | Result object (`InteractiveUiResult`) with `status` + exit codes | User cancel and timeout are expected operational outcomes, not errors. IPC failures are exceptional. |
73
73
 
74
- ## 4. Interactive UI interactions (`assistant ui confirm` / `assistant ui request`)
74
+ ## 4. Interactive UI Interactions (`assistant ui confirm` / `assistant ui request`)
75
75
 
76
76
  The `assistant ui` commands present blocking interactive surfaces (confirmations, forms) to the user and wait for a response. Their error model distinguishes three categories:
77
77
 
78
- ### Expected outcomes (not errors)
78
+ ### Expected Outcomes (Not Errors)
79
79
 
80
80
  User decisions — including declining — are normal operational results:
81
81
 
@@ -92,7 +92,7 @@ User decisions — including declining — are normal operational results:
92
92
 
93
93
  Scripts must handle all three non-confirmation outcomes. A `cancelled` status means the user deliberately chose not to proceed — log it as a normal flow, not an error. A `timed_out` status means the user was unresponsive — abort without side effects.
94
94
 
95
- ### Cancellation reasons (`ui request` only)
95
+ ### Cancellation Reasons (`ui request` only)
96
96
 
97
97
  When using `assistant ui request --json`, a `cancelled` result includes a `cancellationReason` field that distinguishes **user-driven** cancellations from **operational fail-closed** cancellations. This allows scripts to choose different recovery strategies depending on why the surface was cancelled.
98
98
 
@@ -0,0 +1,112 @@
1
+ # Guardian requests: the interactive-request pipeline
2
+
3
+ This is the end-to-end map of how an interactive request — anything the
4
+ assistant needs a person to decide or answer — reaches a user on any channel
5
+ and how their response resolves it. **It is the canonical rail for interactive
6
+ channel features.** If you are adding a feature that shows buttons/options on
7
+ a channel and waits for a reply, extend the seams below; do **not** build a
8
+ per-feature watcher, callback scheme, or parallel delivery stack (that
9
+ anti-pattern was retired in #35642 and again in the ask_question redesign).
10
+
11
+ ## The lifecycle
12
+
13
+ ```
14
+ tool / flow parks a pending interaction (runtime/pending-interactions.ts)
15
+ │
16
+ ▼ promotion (fire-and-forget, at the emitter)
17
+ guardian_requests row, gateway-owned (permissions/confirmation-guardian-request.ts,
18
+ create → decide(CAS) → expire/sweep permissions/question-guardian-request.ts,
19
+ │ gateway/src/db/guardian-request-store.ts)
20
+ ▼ bridge emits guardian.question signal
21
+ notification pipeline (notifications/emit-signal.ts →
22
+ decision engine → destination resolver → decision-engine.ts → destination-resolver.ts →
23
+ broadcaster builds the card context ONCE broadcaster.ts: resolveApprovalContext /
24
+ (generic actions[] + plainTextFallback) resolveQuestionOptionsContext)
25
+ │
26
+ ▼ per-channel rendering ONLY
27
+ channel adapters (notifications/adapters/{telegram,slack,macos,platform},
28
+ telegram: inline keyboard; slack: blocks; vellum: conversation card via approval-card-builder)
29
+ card deliveries recorded per channel (guardian-delivery-recorder.ts → guardian_request_deliveries)
30
+ │
31
+ ▼ user responds: button tap / emoji reaction / "CODE <reply>" / bare text
32
+ guardian reply router (runtime/guardian-reply-router.ts, invoked from
33
+ reactions → callbacks → request codes → routes/inbound-stages/guardian-reply-intercept.ts,
34
+ bare answer → explicit approve/reject → NL BEFORE background dispatch — replies to parked
35
+ │ prompts resolve inline, never deferred)
36
+ ▼ one decision primitive
37
+ applyGuardianDecision (approvals/guardian-decision-primitive.ts:
38
+ status CAS + ACL outcome, atomic; first-writer-wins; card withdrawal on decide)
39
+ │
40
+ ▼ per-kind follow-through
41
+ resolver registry (approvals/guardian-request-resolvers.ts)
42
+ tool_approval → confirmation resume pending_question → voice answerCall OR
43
+ access_request → ACL outcome ask_question interaction resolve
44
+ ```
45
+
46
+ ## Who owns what
47
+
48
+ | Concern | Owner | Never |
49
+ | --------------------------------------- | -------------------------------------------------------- | ----------------------------------- |
50
+ | The "what": card text, actions, options | broadcaster context build (once per broadcast) | built per-adapter |
51
+ | The "how": channel-native rendering | `notifications/adapters/<channel>` | domain logic, payload parsing |
52
+ | Request state | gateway `guardian_requests` (+ deliveries) | daemon-side request tables |
53
+ | Decisions | `applyGuardianDecision` (CAS, atomic ACL outcome) | inline decision logic at call sites |
54
+ | Kind-specific follow-through | resolver registry (`kind` → resolver) | switch statements in the router |
55
+ | Reply understanding | guardian reply router (codes, buttons, reactions, modes) | per-feature inbound intercepts |
56
+
57
+ Two instruction modes exist per request kind (`notifications/guardian-question-mode.ts`):
58
+ **approval** ("CODE approve" / approve–reject buttons) and **answer**
59
+ ("CODE <your answer>" / option buttons). `pending_question` is answer-mode.
60
+
61
+ ## Worked example: `ask_question` on a channel
62
+
63
+ 1. The tool parks on `QuestionPrompter` when the turn can deliver a card
64
+ (`ToolContext.supportsGuardianQuestionCards` — single-question batch,
65
+ guardian turn, channel in `GUARDIAN_QUESTION_CARD_CHANNELS`); otherwise it
66
+ returns the plain-text fallback.
67
+ 2. The prompter promotes the interaction to a `pending_question` row
68
+ (`permissions/question-guardian-request.ts` — request id = interaction
69
+ requestId, mirroring `tool_approval`) and bridges it
70
+ (`runtime/question-request-guardian-bridge.ts`).
71
+ 3. The broadcaster renders the options as card actions with answer-token ids
72
+ (`answer_<idx>` / `answer_skip` — `buildQuestionOptionActionId`); adapters
73
+ need no changes, ever.
74
+ 4. A tap arrives as `apr:<requestId>:answer_<idx>`; the router recognizes the
75
+ token for answer-mode requests. A bare text reply while exactly one
76
+ answer-mode request is pending IS the answer. "CODE <text>" works like any
77
+ request.
78
+ 5. The `pending_question` resolver (no `callSessionId` → ask_question branch)
79
+ maps the token/text to a submission and settles the interaction via
80
+ `resolvePendingQuestion` — the same core `/v1/question-response` uses — so
81
+ the parked tool returns and the turn continues.
82
+ 6. Lifecycle: answered elsewhere / timed out → the orphan sweep in
83
+ `conversation-routes.ts` expires the row (voice rows, which carry
84
+ `callSessionId`, are exempt); daemon restart → boot's
85
+ `expire_interaction_bound`.
86
+
87
+ ## Adding a new interactive request kind
88
+
89
+ 1. Add the kind to `GuardianRequestKindSchema`
90
+ (`packages/gateway-client/src/guardian-request-contract.ts`).
91
+ 2. Promote at the emitter (mirror `confirmation-guardian-request.ts`) and
92
+ bridge to `emitNotificationSignal` with a typed payload
93
+ (`guardian-question-mode.ts` schemas).
94
+ 3. If the card needs non-default actions, add a context branch in the
95
+ broadcaster — actions are generic `{id,label}`; adapters are untouched.
96
+ 4. Add reply-mode config (`REQUEST_KIND_MODE_CONFIG`) if the kind answers
97
+ rather than approves.
98
+ 5. Register a resolver (`guardian-request-resolvers.ts`) for the kind's
99
+ follow-through.
100
+
101
+ That is the whole checklist. If a design requires touching the inbound
102
+ message handler, a channel transport, or a new callback prefix, the design is
103
+ at the wrong level.
104
+
105
+ ## Legacy rail (in-turn approval interception)
106
+
107
+ `routes/guardian-approval-interception.ts` + the approval prompt watcher in
108
+ `background-dispatch.ts` predate this pipeline: they deliver a guardian's own
109
+ tool-approval prompt in-channel mid-turn and resolve `apr:` taps against the
110
+ in-memory confirmation directly. They remain load-bearing for that flow, and
111
+ the reply router runs first for everything the pipeline owns. Converge new
112
+ work on the pipeline; do not extend the legacy interception.
package/eslint.config.mjs CHANGED
@@ -15,7 +15,7 @@ const eslintConfig = defineConfig([
15
15
  // Require braces on every control-statement body (if/else/for/
16
16
  // while/do). A braceless body is a maintenance hazard: a second
17
17
  // line added under the condition reads as guarded but always runs.
18
- curly: ["warn", "all"],
18
+ curly: ["error", "all"],
19
19
  "simple-import-sort/imports": [
20
20
  "error",
21
21
  {
@@ -49,6 +49,39 @@ const eslintConfig = defineConfig([
49
49
  "@typescript-eslint/no-explicit-any": "off",
50
50
  },
51
51
  },
52
+ // Managed-column profile resolution (`getEffectiveProfile(s)`) resolves
53
+ // default profiles against the vellum column only, ignoring
54
+ // `llm.defaultProvider`; on a BYO install that is not the body that
55
+ // dispatches. Runtime code must use `resolveDefaultProfileForProvider` /
56
+ // `getEffectiveProfilesForProvider` instead. The allowlist below is the
57
+ // full set of intentional managed-column consumers: the catalog itself,
58
+ // hatch-time seeding (writes managed stubs by design), and write-path
59
+ // validation.
60
+ {
61
+ files: ["src/**/*.ts"],
62
+ ignores: [
63
+ "src/config/default-profile-catalog.ts",
64
+ "src/config/seed-inference-profiles.ts",
65
+ "src/config/inference-profile-validation.ts",
66
+ "**/__tests__/**",
67
+ "**/*.test.ts",
68
+ ],
69
+ rules: {
70
+ "no-restricted-imports": [
71
+ "error",
72
+ {
73
+ patterns: [
74
+ {
75
+ group: ["**/default-profile-catalog.js"],
76
+ importNames: ["getEffectiveProfile", "getEffectiveProfiles"],
77
+ message:
78
+ "Managed-column resolution ignores llm.defaultProvider. Use resolveDefaultProfileForProvider / getEffectiveProfilesForProvider with the parsed config's llm.defaultProvider ?? null.",
79
+ },
80
+ ],
81
+ },
82
+ ],
83
+ },
84
+ },
52
85
  // `cli/no-daemon-internals` keeps daemon-internal modules out of the CLI's
53
86
  // static import graph, so `assistant …` invocations (including the bash-tool
54
87
  // fast path) don't pay the memory cost of loading daemon subsystems. Keep at
@@ -17,6 +17,7 @@
17
17
  "./rpc": "./src/rpc.ts",
18
18
  "./attachment-naming": "./src/attachment-naming.ts",
19
19
  "./redacted-credential": "./src/redacted-credential.ts",
20
+ "./secret-detection": "./src/secret-detection.ts",
20
21
  "./error": "./src/error.ts"
21
22
  },
22
23
  "scripts": {
@@ -18,8 +18,16 @@ describe("isChannelId", () => {
18
18
  expect(isChannelId("vellum")).toBe(true);
19
19
  });
20
20
 
21
+ test("includes discord", () => {
22
+ // Discord is canonical vocabulary ahead of its ingress implementation:
23
+ // the gateway's inbound list and the admission-policy seed both derive
24
+ // from CHANNEL_IDS, so it must be here for a Discord message to be
25
+ // routable and to carry an admission floor at all.
26
+ expect(isChannelId("discord")).toBe(true);
27
+ });
28
+
21
29
  test("rejects unknown strings and non-string values", () => {
22
- expect(isChannelId("discord")).toBe(false);
30
+ expect(isChannelId("mastodon")).toBe(false);
23
31
  expect(isChannelId("")).toBe(false);
24
32
  expect(isChannelId(undefined)).toBe(false);
25
33
  expect(isChannelId(null)).toBe(false);