@vellumai/assistant 0.11.0 → 0.11.1-dev.202608010027.2cfe358

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 (1689) hide show
  1. package/ARCHITECTURE.md +14 -9
  2. package/Dockerfile +1 -0
  3. package/docs/architecture/memory.md +59 -0
  4. package/docs/stt-provider-onboarding.md +10 -7
  5. package/eslint.config.mjs +34 -1
  6. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/package.json +2 -0
  7. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/conversation-handle.test.ts +316 -0
  8. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/redacted-credential.test.ts +1 -1
  9. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/stripe-currency.test.ts +37 -0
  10. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/conversation-handle.ts +246 -0
  11. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
  12. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/remote-web-pairing.ts +2 -2
  13. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/stripe-currency.ts +55 -0
  14. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/package.json +2 -0
  15. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/conversation-handle.test.ts +316 -0
  16. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/redacted-credential.test.ts +1 -1
  17. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/stripe-currency.test.ts +37 -0
  18. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/conversation-handle.ts +246 -0
  19. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
  20. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/remote-web-pairing.ts +2 -2
  21. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/stripe-currency.ts +55 -0
  22. package/node_modules/@vellumai/ipc-server-utils/src/index.ts +10 -0
  23. package/{src/ipc → node_modules/@vellumai/ipc-server-utils/src}/ipc-framing.ts +21 -7
  24. package/node_modules/@vellumai/service-contracts/package.json +2 -0
  25. package/node_modules/@vellumai/service-contracts/src/__tests__/conversation-handle.test.ts +316 -0
  26. package/node_modules/@vellumai/service-contracts/src/__tests__/redacted-credential.test.ts +1 -1
  27. package/node_modules/@vellumai/service-contracts/src/__tests__/stripe-currency.test.ts +37 -0
  28. package/node_modules/@vellumai/service-contracts/src/conversation-handle.ts +246 -0
  29. package/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
  30. package/node_modules/@vellumai/service-contracts/src/remote-web-pairing.ts +2 -2
  31. package/node_modules/@vellumai/service-contracts/src/stripe-currency.ts +55 -0
  32. package/openapi.yaml +504 -11
  33. package/package.json +1 -1
  34. package/scripts/build-plugin-api.ts +11 -4
  35. package/scripts/capture-x-graphql.ts +54 -20
  36. package/scripts/generate-openapi.ts +7 -3
  37. package/scripts/memory-inspect.ts +17 -6
  38. package/scripts/sync-llm-catalog.ts +44 -19
  39. package/scripts/sync-web-search-catalog.ts +3 -1
  40. package/scripts/voice-ttft-spike.ts +6 -3
  41. package/src/__tests__/add-message-skip-indexing.test.ts +3 -2
  42. package/src/__tests__/agent-loop-history-repair.test.ts +180 -0
  43. package/src/__tests__/agent-loop-output-hooks.test.ts +35 -11
  44. package/src/__tests__/agent-loop-override-profile.test.ts +21 -14
  45. package/src/__tests__/agent-loop-regrowth-guard.test.ts +3 -1
  46. package/src/__tests__/agent-loop.test.ts +5 -2
  47. package/src/__tests__/anthropic-error-formatting.test.ts +3 -1
  48. package/src/__tests__/app-control-flow.test.ts +3 -1
  49. package/src/__tests__/app-control-tool-schemas.test.ts +6 -2
  50. package/src/__tests__/app-dir-path-guard.test.ts +9 -3
  51. package/src/__tests__/app-routes-csp.test.ts +12 -4
  52. package/src/__tests__/app-source-watcher.test.ts +3 -1
  53. package/src/__tests__/approval-primitive.test.ts +66 -22
  54. package/src/__tests__/assistant-feature-flag-guard.test.ts +6 -2
  55. package/src/__tests__/assistant-feature-flag-guardrails.test.ts +12 -4
  56. package/src/__tests__/assistant-id-boundary-guard.test.ts +26 -9
  57. package/src/__tests__/attachments-store.test.ts +12 -4
  58. package/src/__tests__/avatar-generator.test.ts +3 -1
  59. package/src/__tests__/background-shell-bash.test.ts +3 -1
  60. package/src/__tests__/browser-fill-credential.test.ts +6 -2
  61. package/src/__tests__/browser-runtime-check.test.ts +3 -1
  62. package/src/__tests__/build-persisted-content.test.ts +3 -1
  63. package/src/__tests__/bundled-skill-retrieval-guard.test.ts +15 -5
  64. package/src/__tests__/byok-default-profile-ensure.test.ts +1095 -0
  65. package/src/__tests__/call-controller.test.ts +9 -3
  66. package/src/__tests__/call-domain.test.ts +15 -8
  67. package/src/__tests__/call-setup-flow-midcall-trust.test.ts +3 -1
  68. package/src/__tests__/call-state-machine.test.ts +3 -1
  69. package/src/__tests__/channel-approval-routes.test.ts +2 -1
  70. package/src/__tests__/channel-approval.test.ts +9 -6
  71. package/src/__tests__/channel-guardian.test.ts +3 -1
  72. package/src/__tests__/channel-setup-panel-ack.test.ts +1 -3
  73. package/src/__tests__/clawhub.test.ts +3 -1
  74. package/src/__tests__/cli-memory-v2-reembed-skills.test.ts +3 -1
  75. package/src/__tests__/compact-event-conversation-id-guard.test.ts +3 -2
  76. package/src/__tests__/compaction-summary-head-persisted-count.test.ts +1 -1
  77. package/src/__tests__/config-callsite-patch-merge.test.ts +92 -0
  78. package/src/__tests__/config-get-vision-flag.test.ts +1 -1
  79. package/src/__tests__/config-loader-backfill.test.ts +209 -144
  80. package/src/__tests__/config-loader-corrupt.test.ts +3 -1
  81. package/src/__tests__/config-loader-platform-defaults.test.ts +3 -1
  82. package/src/__tests__/config-loader-quarantine-notice.test.ts +3 -1
  83. package/src/__tests__/config-loader-validation-reset-notice.test.ts +3 -1
  84. package/src/__tests__/config-model-image-provider.test.ts +3 -1
  85. package/src/__tests__/config-set-platform-guard.test.ts +3 -1
  86. package/src/__tests__/config-watcher.test.ts +3 -1
  87. package/src/__tests__/connection-model-compat.test.ts +3 -1
  88. package/src/__tests__/contact-store-user-file.test.ts +18 -6
  89. package/src/__tests__/contacts-relay-reads.test.ts +31 -22
  90. package/src/__tests__/contacts-tools.test.ts +3 -1
  91. package/src/__tests__/context-overflow-reducer.test.ts +3 -1
  92. package/src/__tests__/context-search-conversations-source.test.ts +4 -1
  93. package/src/__tests__/context-search-memory-v2-source.test.ts +3 -1
  94. package/src/__tests__/conversation-agent-loop-handlers-max-tokens.test.ts +3 -1
  95. package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +1 -1
  96. package/src/__tests__/conversation-agent-loop-overflow.test.ts +1 -1
  97. package/src/__tests__/conversation-agent-loop.test.ts +121 -1
  98. package/src/__tests__/conversation-delete-schedule-cleanup.test.ts +3 -3
  99. package/src/__tests__/conversation-delete-subagent-rows.test.ts +303 -0
  100. package/src/__tests__/conversation-fork-route.test.ts +3 -1
  101. package/src/__tests__/conversation-inference-profile-list.test.ts +3 -1
  102. package/src/__tests__/conversation-list-source.test.ts +3 -1
  103. package/src/__tests__/conversation-loop-db-lock-resilience.test.ts +9 -8
  104. package/src/__tests__/conversation-pairing.test.ts +6 -2
  105. package/src/__tests__/conversation-pre-run-repair.test.ts +1 -1
  106. package/src/__tests__/conversation-queue.test.ts +145 -1
  107. package/src/__tests__/conversation-retry-route.test.ts +46 -7
  108. package/src/__tests__/conversation-routes-disk-view.test.ts +18 -6
  109. package/src/__tests__/conversation-slash-commands.test.ts +27 -9
  110. package/src/__tests__/conversation-slash.test.ts +92 -0
  111. package/src/__tests__/conversation-starter-routes.test.ts +6 -2
  112. package/src/__tests__/conversation-surfaces-app-control.test.ts +3 -1
  113. package/src/__tests__/conversation-surfaces-app-open.test.ts +1 -3
  114. package/src/__tests__/conversation-surfaces-queued-emit.test.ts +86 -0
  115. package/src/__tests__/conversation-surfaces-standalone.test.ts +6 -2
  116. package/src/__tests__/conversation-surfaces-state-update.test.ts +1 -3
  117. package/src/__tests__/conversation-surfaces-table-action.test.ts +1 -3
  118. package/src/__tests__/conversation-usage.test.ts +159 -0
  119. package/src/__tests__/conversations-import-system-filter.test.ts +101 -4
  120. package/src/__tests__/credential-broker-server-use.test.ts +21 -7
  121. package/src/__tests__/credential-broker.test.ts +30 -10
  122. package/src/__tests__/credential-execution-client.test.ts +17 -6
  123. package/src/__tests__/credential-security-invariants.test.ts +3 -1
  124. package/src/__tests__/custom-group-listing-visibility.test.ts +93 -0
  125. package/src/__tests__/db-migration-rollback.test.ts +21 -7
  126. package/src/__tests__/db-readiness-http-gate.test.ts +3 -1
  127. package/src/__tests__/db-schedule-syntax-migration.test.ts +1 -0
  128. package/src/__tests__/default-provider-ensure.test.ts +10 -1
  129. package/src/__tests__/disk-pressure-guard.test.ts +3 -1
  130. package/src/__tests__/dm-backfill.test.ts +3 -1
  131. package/src/__tests__/dm-persistence.test.ts +3 -1
  132. package/src/__tests__/docker-signing-key-bootstrap.test.ts +2 -1
  133. package/src/__tests__/drain-requeue-on-contention.test.ts +124 -0
  134. package/src/__tests__/edit-engine.test.ts +42 -14
  135. package/src/__tests__/emit-signal-routing-intent.test.ts +290 -49
  136. package/src/__tests__/events-dev-bypass-actor.test.ts +3 -1
  137. package/src/__tests__/file-ops-service.test.ts +60 -20
  138. package/src/__tests__/filesystem-tools.test.ts +90 -30
  139. package/src/__tests__/fixtures/mock-chrome-extension.ts +18 -6
  140. package/src/__tests__/fixtures/mock-signup-server.ts +6 -2
  141. package/src/__tests__/fuzzy-match-property.test.ts +18 -6
  142. package/src/__tests__/gateway-flag-listener.test.ts +9 -3
  143. package/src/__tests__/gateway-only-enforcement.test.ts +2 -1
  144. package/src/__tests__/gateway-only-guard.test.ts +12 -4
  145. package/src/__tests__/gemini-image-service.test.ts +3 -1
  146. package/src/__tests__/gemini-provider.test.ts +81 -2
  147. package/src/__tests__/get-skill-detail-audit.test.ts +9 -3
  148. package/src/__tests__/google-calendar-watcher.test.ts +75 -0
  149. package/src/__tests__/guardian-card-rehydration.test.ts +210 -0
  150. package/src/__tests__/guardian-card-withdrawal.test.ts +37 -2
  151. package/src/__tests__/guardian-decision-primitive-canonical.test.ts +42 -14
  152. package/src/__tests__/guardian-expiry-notifier.test.ts +3 -1
  153. package/src/__tests__/guardian-question-mode.test.ts +12 -4
  154. package/src/__tests__/headless-browser-interactions.test.ts +6 -2
  155. package/src/__tests__/headless-browser-mode.test.ts +6 -2
  156. package/src/__tests__/headless-browser-navigate.test.ts +33 -11
  157. package/src/__tests__/headless-browser-read-tools.test.ts +24 -8
  158. package/src/__tests__/headless-browser-snapshot.test.ts +3 -1
  159. package/src/__tests__/helpers/channel-test-adapter.ts +17 -7
  160. package/src/__tests__/helpers/create-guardian-binding.ts +3 -1
  161. package/src/__tests__/helpers/derive-guardian-delivery.ts +3 -1
  162. package/src/__tests__/helpers/gateway-acl-store.ts +6 -2
  163. package/src/__tests__/helpers/gateway-classify-mock.ts +3 -1
  164. package/src/__tests__/helpers/seed-contact-channel.ts +3 -1
  165. package/src/__tests__/helpers/tar-fixtures.ts +3 -1
  166. package/src/__tests__/history-repair-observability.test.ts +1 -1
  167. package/src/__tests__/history-repair.test.ts +2 -2
  168. package/src/__tests__/host-app-control-routes.test.ts +98 -2
  169. package/src/__tests__/host-bash-routes.test.ts +66 -0
  170. package/src/__tests__/host-cu-proxy.test.ts +7 -1
  171. package/src/__tests__/host-cu-routes-targeted.test.ts +87 -0
  172. package/src/__tests__/host-file-routes-targeted.test.ts +60 -0
  173. package/src/__tests__/host-proxy-preactivation.test.ts +1 -5
  174. package/src/__tests__/host-transfer-proxy.test.ts +4 -4
  175. package/src/__tests__/host-transfer-routes-targeted.test.ts +3 -1
  176. package/src/__tests__/image-recovery-hook.test.ts +3 -3
  177. package/src/__tests__/inbound-slack-persistence.test.ts +3 -1
  178. package/src/__tests__/injector-config-quarantine-notice.test.ts +3 -1
  179. package/src/__tests__/injector-config-validation-reset-notice.test.ts +3 -1
  180. package/src/__tests__/injector-disk-pressure.test.ts +3 -1
  181. package/src/__tests__/injector-document-comments.test.ts +3 -1
  182. package/src/__tests__/injector-v3-suppression.test.ts +6 -2
  183. package/src/__tests__/inline-skill-authoring-guard.test.ts +12 -4
  184. package/src/__tests__/internal-telemetry-routes.test.ts +3 -1
  185. package/src/__tests__/lexical-index-dual-write.test.ts +3 -1
  186. package/src/__tests__/lifecycle-memory-v2-seed.test.ts +9 -3
  187. package/src/__tests__/llm-callsite-catalog.test.ts +3 -1
  188. package/src/__tests__/llm-catalog-parity.test.ts +21 -7
  189. package/src/__tests__/managed-profile-guard.test.ts +55 -4
  190. package/src/__tests__/max-tokens-continue-hook.test.ts +120 -0
  191. package/src/__tests__/mcp-cli.test.ts +10 -3
  192. package/src/__tests__/media-stream-output.test.ts +9 -3
  193. package/src/__tests__/media-stream-parser.test.ts +111 -37
  194. package/src/__tests__/media-stream-stt-session.test.ts +34 -11
  195. package/src/__tests__/memory-upsert-concurrency.test.ts +19 -16
  196. package/src/__tests__/message-delete-segment-purge.test.ts +98 -0
  197. package/src/__tests__/migration-cross-version-compatibility.test.ts +3 -1
  198. package/src/__tests__/migration-export-http.test.ts +9 -3
  199. package/src/__tests__/migration-export-streaming.test.ts +9 -3
  200. package/src/__tests__/migration-import-commit-http.test.ts +21 -7
  201. package/src/__tests__/migration-import-preflight-http.test.ts +3 -1
  202. package/src/__tests__/migration-validate-http.test.ts +3 -1
  203. package/src/__tests__/mock-fetch.ts +3 -1
  204. package/src/__tests__/mock-gateway-ipc.ts +20 -7
  205. package/src/__tests__/mock-signup-server.test.ts +9 -3
  206. package/src/__tests__/model-intents.test.ts +1 -1
  207. package/src/__tests__/native-web-search.test.ts +3 -1
  208. package/src/__tests__/no-is-trusted-guard.test.ts +3 -1
  209. package/src/__tests__/notification-broadcaster.test.ts +5 -3
  210. package/src/__tests__/notification-platform-adapter.test.ts +114 -5
  211. package/src/__tests__/notification-vellum-adapter.test.ts +41 -0
  212. package/src/__tests__/oauth-apps-routes.test.ts +3 -1
  213. package/src/__tests__/oauth-commands-routes.test.ts +9 -3
  214. package/src/__tests__/oauth-connect-orchestrator.test.ts +33 -11
  215. package/src/__tests__/oauth-connect-routes.test.ts +3 -1
  216. package/src/__tests__/oauth-providers-routes.test.ts +15 -10
  217. package/src/__tests__/oauth2-refresh-retry.test.ts +3 -1
  218. package/src/__tests__/onboarding-persona-write.test.ts +12 -10
  219. package/src/__tests__/openai-image-service.test.ts +6 -2
  220. package/src/__tests__/openai-provider.test.ts +3 -1
  221. package/src/__tests__/openai-responses-cutover-guard.test.ts +3 -1
  222. package/src/__tests__/openai-responses-provider.test.ts +3 -1
  223. package/src/__tests__/outbound-slack-persistence.test.ts +18 -6
  224. package/src/__tests__/persist-media-references.test.ts +3 -1
  225. package/src/__tests__/persist-onboarding-artifacts.test.ts +3 -1
  226. package/src/__tests__/persist-unsendable-image-downscale.test.ts +3 -3
  227. package/src/__tests__/persist-unsendable-image.test.ts +3 -3
  228. package/src/__tests__/persist-user-message-set-processing-failure.test.ts +3 -1
  229. package/src/__tests__/persistence-secret-redaction.test.ts +9 -3
  230. package/src/__tests__/persona-resolver.test.ts +3 -1
  231. package/src/__tests__/plugin-api-tool-definition.test.ts +5 -8
  232. package/src/__tests__/plugin-bootstrap.test.ts +2 -3
  233. package/src/__tests__/plugin-import-boundary-guard.test.ts +3 -0
  234. package/src/__tests__/plugin-import-boundary-reverse-guard.test.ts +1 -4
  235. package/src/__tests__/post-turn-tool-result-truncation.test.ts +112 -1
  236. package/src/__tests__/prechat-onboarding-contract.test.ts +6 -2
  237. package/src/__tests__/pricing.test.ts +2 -2
  238. package/src/__tests__/process-message-background-slack.test.ts +3 -1
  239. package/src/__tests__/profiler-routes.test.ts +10 -12
  240. package/src/__tests__/provider-catalog-visibility.test.ts +12 -4
  241. package/src/__tests__/provider-error-scenarios.test.ts +27 -9
  242. package/src/__tests__/provider-streaming.benchmark.test.ts +12 -4
  243. package/src/__tests__/queued-message-delete-contract.test.ts +339 -0
  244. package/src/__tests__/recording-handler.test.ts +7 -3
  245. package/src/__tests__/retry-thinking-preadaptive.test.ts +204 -0
  246. package/src/__tests__/run-conversation-turn-persistence.test.ts +69 -4
  247. package/src/__tests__/runtime-events-sse-reconnect.test.ts +3 -1
  248. package/src/__tests__/schedule-retry.test.ts +3 -1
  249. package/src/__tests__/schedule-routes-workflow-validation.test.ts +9 -3
  250. package/src/__tests__/schedule-routes.test.ts +3 -1
  251. package/src/__tests__/schedule-store.test.ts +113 -9
  252. package/src/__tests__/schedule-tools.test.ts +106 -0
  253. package/src/__tests__/scheduler-reuse-conversation.test.ts +3 -1
  254. package/src/__tests__/scheduler-wake.test.ts +47 -8
  255. package/src/__tests__/script-proxy-injection-runtime.test.ts +14 -5
  256. package/src/__tests__/script-proxy-mitm-handler.test.ts +12 -4
  257. package/src/__tests__/script-proxy-rewrite-specificity.test.ts +12 -4
  258. package/src/__tests__/search-skills-unified.test.ts +27 -9
  259. package/src/__tests__/service-contracts-import-guard.test.ts +12 -4
  260. package/src/__tests__/settings-routes.test.ts +3 -1
  261. package/src/__tests__/shell-credential-ref.test.ts +6 -2
  262. package/src/__tests__/shell-observability.test.ts +3 -1
  263. package/src/__tests__/skill-cache-store.test.ts +3 -1
  264. package/src/__tests__/skill-feature-flags-integration.test.ts +3 -1
  265. package/src/__tests__/skill-secret-handling-guard.test.ts +11 -4
  266. package/src/__tests__/skills-file-content-endpoint.test.ts +93 -31
  267. package/src/__tests__/skills-files-catalog-fallback.test.ts +33 -11
  268. package/src/__tests__/skills.test.ts +60 -14
  269. package/src/__tests__/slack-channel-config.test.ts +6 -2
  270. package/src/__tests__/slack-messaging-token-resolution.test.ts +6 -2
  271. package/src/__tests__/sse-actor-principal-guardian-source.test.ts +3 -1
  272. package/src/__tests__/steer-on-enqueue-question.test.ts +3 -1
  273. package/src/__tests__/steer-tool-repair.test.ts +6 -2
  274. package/src/__tests__/stt-language-catalog-parity.test.ts +131 -0
  275. package/src/__tests__/subagent-allowlist-validation.test.ts +3 -1
  276. package/src/__tests__/subagent-detail.test.ts +317 -3
  277. package/src/__tests__/subagent-disposal.test.ts +149 -1
  278. package/src/__tests__/subagent-fork-prompt-role.test.ts +3 -1
  279. package/src/__tests__/subagent-notify-parent.test.ts +1 -0
  280. package/src/__tests__/subagent-persistence.test.ts +444 -7
  281. package/src/__tests__/subagent-reconcile-route.test.ts +423 -0
  282. package/src/__tests__/subagent-role-registry.test.ts +3 -1
  283. package/src/__tests__/subagent-tools.test.ts +315 -0
  284. package/src/__tests__/system-prompt.test.ts +12 -5
  285. package/src/__tests__/task-progress-nudge-hook.test.ts +3 -1
  286. package/src/__tests__/telegram-bot-username-resolution.test.ts +3 -1
  287. package/src/__tests__/telegram-config.test.ts +3 -1
  288. package/src/__tests__/telemetry-routes.test.ts +8 -3
  289. package/src/__tests__/thinking-block-replay.test.ts +1 -2
  290. package/src/__tests__/thread-backfill.test.ts +24 -8
  291. package/src/__tests__/token-estimator-accuracy.benchmark.test.ts +6 -2
  292. package/src/__tests__/token-manager.test.ts +36 -12
  293. package/src/__tests__/tool-preview-lifecycle.test.ts +61 -6
  294. package/src/__tests__/tool-result-spool.test.ts +5 -4
  295. package/src/__tests__/tool-result-truncation.test.ts +3 -1
  296. package/src/__tests__/trusted-contact-approval-notifier.test.ts +6 -2
  297. package/src/__tests__/tts-catalog-parity.test.ts +6 -2
  298. package/src/__tests__/twilio-provider.test.ts +6 -2
  299. package/src/__tests__/ui-visual-surface.test.ts +695 -0
  300. package/src/__tests__/unicode.test.ts +1 -3
  301. package/src/__tests__/usage-cli.test.ts +3 -1
  302. package/src/__tests__/usage-routes.test.ts +3 -1
  303. package/src/__tests__/validate-input.test.ts +27 -9
  304. package/src/__tests__/voice-approval-resolver-relay.test.ts +15 -5
  305. package/src/__tests__/voice-config-update.test.ts +257 -2
  306. package/src/__tests__/wake-schedule-escalation.test.ts +477 -0
  307. package/src/__tests__/wake-schedule-trust.test.ts +255 -0
  308. package/src/__tests__/web-fetch.test.ts +21 -7
  309. package/src/__tests__/web-search-catalog-parity.test.ts +11 -4
  310. package/src/__tests__/web-search-history.test.ts +72 -78
  311. package/src/__tests__/web-search.test.ts +15 -5
  312. package/src/__tests__/worker-entrypoint-guards.test.ts +39 -0
  313. package/src/__tests__/workspace-greetings.test.ts +3 -1
  314. package/src/__tests__/workspace-migration-026-backfill-install-meta.test.ts +3 -1
  315. package/src/__tests__/workspace-migration-043-release-notes-latex-rendering.test.ts +3 -1
  316. package/src/__tests__/workspace-migration-082-backfill-managed-profile-labels.test.ts +1 -4
  317. package/src/__tests__/workspace-migration-130-speech-mode-to-provider.test.ts +3 -1
  318. package/src/__tests__/workspace-migration-136-repair-stale-fireworks-kimi-model-id.test.ts +139 -0
  319. package/src/__tests__/workspace-migration-137-repair-retired-fireworks-minimax-model-id.test.ts +157 -0
  320. package/src/__tests__/workspace-migration-down-functions.test.ts +5 -2
  321. package/src/__tests__/workspace-migration-meets.test.ts +4 -6
  322. package/src/__tests__/workspace-migration-memory-v2-init.test.ts +3 -1
  323. package/src/__tests__/workspace-migration-seed-device-id.test.ts +3 -1
  324. package/src/a2a/__tests__/agent-card.test.ts +5 -21
  325. package/src/a2a/agent-card.ts +11 -17
  326. package/src/acp/__tests__/helpers/exec-file-stub.ts +3 -1
  327. package/src/acp/__tests__/prepare-agent-env.test.ts +3 -1
  328. package/src/acp/agent-process.ts +18 -6
  329. package/src/acp/auto-install.test.ts +9 -3
  330. package/src/acp/auto-install.ts +6 -2
  331. package/src/acp/failure-error.ts +8 -3
  332. package/src/acp/prepare-agent-env.ts +3 -1
  333. package/src/acp/resolve-agent.test.ts +81 -27
  334. package/src/acp/resolve-agent.ts +9 -3
  335. package/src/{plugins/defaults/history-repair/terminal.ts → agent/history-repair/history-repair.ts} +42 -11
  336. package/src/agent/image-optimize.ts +18 -6
  337. package/src/agent/loop.ts +45 -10
  338. package/src/api/events/contact-request.ts +1 -0
  339. package/src/api/events/message-dequeued.ts +4 -0
  340. package/src/api/events/message-queued-deleted.ts +4 -0
  341. package/src/api/events/message-queued.ts +4 -0
  342. package/src/api/events/message-requeued.ts +35 -0
  343. package/src/api/events/notification-intent.ts +5 -0
  344. package/src/api/events/tool-result.ts +1 -0
  345. package/src/api/events/ui-surface-pending.ts +35 -0
  346. package/src/api/index.ts +14 -0
  347. package/src/api/responses/subagent-detail.ts +13 -6
  348. package/src/api/surfaces.ts +90 -1
  349. package/src/approvals/guardian-card-withdrawal.ts +30 -11
  350. package/src/apps/app-store.ts +65 -22
  351. package/src/apps/shared-app-links-store.ts +9 -3
  352. package/src/avatar/__tests__/avatar-store.test.ts +6 -2
  353. package/src/avatar/avatar-manifest.ts +18 -6
  354. package/src/avatar/resvg-lazy.test.ts +6 -2
  355. package/src/background-wake/background-wake-routes.test.ts +9 -3
  356. package/src/background-wake/next-wake.ts +15 -5
  357. package/src/background-wake/platform-client.ts +18 -6
  358. package/src/background-wake/publisher.ts +3 -1
  359. package/src/backup/__tests__/paths.test.ts +0 -1
  360. package/src/backup/__tests__/restore.test.ts +1 -6
  361. package/src/backup/__tests__/snapshot-lock.test.ts +3 -2
  362. package/src/backup/list-snapshots.ts +15 -5
  363. package/src/backup/local-writer.ts +9 -3
  364. package/src/backup/paths.ts +6 -3
  365. package/src/backup/snapshot-lock.ts +18 -6
  366. package/src/browser-session/__tests__/manager.test.ts +6 -2
  367. package/src/browser-session/manager.ts +6 -2
  368. package/src/bundler/app-compiler.ts +44 -15
  369. package/src/bundler/bundle-scanner.ts +29 -10
  370. package/src/bundler/bundle-signer.ts +3 -1
  371. package/src/bundler/compiler-tools.ts +15 -5
  372. package/src/bundler/package-resolver.ts +3 -1
  373. package/src/bundler/signature-verifier.ts +3 -1
  374. package/src/calls/__tests__/inbound-trust-reader.test.ts +1 -4
  375. package/src/calls/__tests__/tts-text-sanitizer.test.ts +11 -11
  376. package/src/calls/__tests__/voice-session-bridge.test.ts +14 -4
  377. package/src/calls/access-request-wait.ts +9 -3
  378. package/src/calls/audio-store.ts +9 -3
  379. package/src/calls/call-constants.ts +6 -2
  380. package/src/calls/call-controller.ts +72 -25
  381. package/src/calls/call-pointer-message-composer.ts +11 -4
  382. package/src/calls/call-pointer-messages.ts +24 -8
  383. package/src/calls/call-store.ts +12 -4
  384. package/src/calls/guardian-action-sweep.ts +3 -1
  385. package/src/calls/inbound-trust-reader.ts +5 -1
  386. package/src/calls/media-stream-audio-transcode.ts +9 -3
  387. package/src/calls/media-stream-output.ts +41 -15
  388. package/src/calls/media-stream-stt-session.ts +21 -7
  389. package/src/calls/media-turn-detector.ts +9 -3
  390. package/src/calls/speaker-identification.ts +21 -7
  391. package/src/calls/telephony-credential-preflight.ts +1 -3
  392. package/src/calls/tts-text-sanitizer.ts +2 -8
  393. package/src/calls/twilio-config.ts +3 -1
  394. package/src/calls/twilio-provider.ts +3 -1
  395. package/src/calls/twilio-rest.ts +3 -1
  396. package/src/calls/voice-control-protocol.ts +12 -4
  397. package/src/calls/voice-session-bridge.ts +6 -1
  398. package/src/channels/__tests__/gateway-verification-sessions.test.ts +2 -3
  399. package/src/channels/permission-profiles.ts +9 -3
  400. package/src/channels/slack-callback-url.ts +9 -3
  401. package/src/channels/types.ts +17 -6
  402. package/src/cli/__tests__/run-assistant-command.ts +3 -1
  403. package/src/cli/__tests__/unknown-command.test.ts +3 -1
  404. package/src/cli/commands/__tests__/attachment.test.ts +3 -1
  405. package/src/cli/commands/__tests__/avatar.test.ts +18 -10
  406. package/src/cli/commands/__tests__/backup.test.ts +30 -10
  407. package/src/cli/commands/__tests__/browser.test.ts +3 -1
  408. package/src/cli/commands/__tests__/cache.test.ts +3 -1
  409. package/src/cli/commands/__tests__/changelog.test.ts +3 -1
  410. package/src/cli/commands/__tests__/channel-verification-sessions.test.ts +11 -6
  411. package/src/cli/commands/__tests__/conversations-import.test.ts +3 -1
  412. package/src/cli/commands/__tests__/conversations-new.test.ts +9 -3
  413. package/src/cli/commands/__tests__/conversations-slack.test.ts +15 -5
  414. package/src/cli/commands/__tests__/conversations-wake.test.ts +13 -3
  415. package/src/cli/commands/__tests__/domain-register.test.ts +1 -3
  416. package/src/cli/commands/__tests__/domain-status.test.ts +13 -5
  417. package/src/cli/commands/__tests__/email-attachment.test.ts +61 -19
  418. package/src/cli/commands/__tests__/email-core.test.ts +126 -49
  419. package/src/cli/commands/__tests__/gateway.test.ts +6 -2
  420. package/src/cli/commands/__tests__/image-generation.test.ts +5 -2
  421. package/src/cli/commands/__tests__/inference-send.test.ts +3 -1
  422. package/src/cli/commands/__tests__/skills.test.ts +3 -1
  423. package/src/cli/commands/__tests__/status.test.ts +16 -3
  424. package/src/cli/commands/__tests__/stt.test.ts +23 -5
  425. package/src/cli/commands/__tests__/trust.test.ts +3 -1
  426. package/src/cli/commands/__tests__/tts.test.ts +6 -2
  427. package/src/cli/commands/__tests__/ui-confirm.test.ts +3 -1
  428. package/src/cli/commands/__tests__/ui.test.ts +3 -1
  429. package/src/cli/commands/__tests__/watchers.test.ts +3 -1
  430. package/src/cli/commands/__tests__/webhooks.test.ts +23 -5
  431. package/src/cli/commands/audit.ts +7 -3
  432. package/src/cli/commands/avatar.ts +14 -7
  433. package/src/cli/commands/backup.ts +42 -17
  434. package/src/cli/commands/cache.ts +9 -3
  435. package/src/cli/commands/changelog.ts +50 -18
  436. package/src/cli/commands/channel-verification-sessions.ts +25 -10
  437. package/src/cli/commands/channels/__tests__/channels.test.ts +8 -13
  438. package/src/cli/commands/channels/index.ts +12 -4
  439. package/src/cli/commands/clients.ts +12 -4
  440. package/src/cli/commands/contacts.help.ts +5 -0
  441. package/src/cli/commands/contacts.ts +30 -12
  442. package/src/cli/commands/conversations-import.ts +2 -1
  443. package/src/cli/commands/conversations.ts +12 -4
  444. package/src/cli/commands/db/__tests__/repair.test.ts +6 -2
  445. package/src/cli/commands/db/format.ts +18 -6
  446. package/src/cli/commands/db/repair-steps.ts +3 -1
  447. package/src/cli/commands/db/status.ts +6 -2
  448. package/src/cli/commands/gateway.ts +25 -9
  449. package/src/cli/commands/image-generation.ts +5 -2
  450. package/src/cli/commands/inference-session.ts +6 -2
  451. package/src/cli/commands/inference.help.ts +3 -3
  452. package/src/cli/commands/inference.ts +44 -6
  453. package/src/cli/commands/memory/__tests__/memory-ingest.test.ts +591 -0
  454. package/src/cli/commands/memory/__tests__/memory-v2.test.ts +3 -1
  455. package/src/cli/commands/memory/__tests__/memory-v3.test.ts +3 -1
  456. package/src/cli/commands/memory/__tests__/worker.test.ts +3 -1
  457. package/src/cli/commands/memory/index.help.ts +55 -1
  458. package/src/cli/commands/memory/index.ts +2 -0
  459. package/src/cli/commands/memory/memory-ingest.ts +273 -0
  460. package/src/cli/commands/memory/memory-v2-compare-render.ts +3 -1
  461. package/src/cli/commands/memory/memory-v2.ts +12 -4
  462. package/src/cli/commands/memory/memory-v3.ts +3 -1
  463. package/src/cli/commands/notifications.ts +56 -19
  464. package/src/cli/commands/oauth/apps.ts +15 -5
  465. package/src/cli/commands/oauth/disconnect.ts +9 -3
  466. package/src/cli/commands/oauth/mode.ts +6 -2
  467. package/src/cli/commands/oauth/ping.ts +9 -3
  468. package/src/cli/commands/oauth/providers.ts +223 -92
  469. package/src/cli/commands/oauth/request.ts +26 -9
  470. package/src/cli/commands/oauth/token.ts +9 -3
  471. package/src/cli/commands/platform/__tests__/callback-routes-list.test.ts +48 -135
  472. package/src/cli/commands/platform/__tests__/credits.test.ts +9 -78
  473. package/src/cli/commands/platform/__tests__/helpers.ts +90 -0
  474. package/src/cli/commands/platform/__tests__/invoices.test.ts +238 -0
  475. package/src/cli/commands/platform/__tests__/plans.test.ts +50 -0
  476. package/src/cli/commands/platform/__tests__/status.test.ts +12 -87
  477. package/src/cli/commands/platform/__tests__/subscription.test.ts +44 -0
  478. package/src/cli/commands/platform/connect.ts +2 -1
  479. package/src/cli/commands/platform/disconnect.ts +2 -1
  480. package/src/cli/commands/platform/index.help.ts +147 -0
  481. package/src/cli/commands/platform/index.ts +125 -4
  482. package/src/cli/commands/platform/invoices.ts +132 -0
  483. package/src/cli/commands/ps.ts +3 -1
  484. package/src/cli/commands/sequence.ts +43 -15
  485. package/src/cli/commands/skills.ts +103 -45
  486. package/src/cli/commands/status.ts +3 -1
  487. package/src/cli/commands/telemetry.ts +2 -1
  488. package/src/cli/commands/ui.ts +6 -2
  489. package/src/cli/commands/usage.help.ts +1 -1
  490. package/src/cli/commands/watchers.ts +31 -11
  491. package/src/cli/commands/webhooks.ts +4 -2
  492. package/src/cli/lib/__tests__/inspect-plugin.test.ts +3 -1
  493. package/src/cli/lib/__tests__/list-installed-plugins.test.ts +4 -2
  494. package/src/cli/lib/__tests__/plugin-catalog-cache.test.ts +5 -2
  495. package/src/cli/lib/__tests__/plugin-catalog-resolve.test.ts +20 -11
  496. package/src/cli/lib/__tests__/plugin-details.test.ts +13 -7
  497. package/src/cli/lib/__tests__/plugin-pin-history.test.ts +3 -1
  498. package/src/cli/lib/__tests__/plugins-install-offline.test.ts +17 -5
  499. package/src/cli/lib/__tests__/publish-plugin.test.ts +51 -22
  500. package/src/cli/lib/__tests__/search-plugins.test.ts +13 -6
  501. package/src/cli/lib/__tests__/upgrade-plugin.test.ts +9 -3
  502. package/src/cli/lib/bundled-marketplace.json +13 -0
  503. package/src/cli/lib/cli-colors.ts +24 -8
  504. package/src/cli/lib/confirm-prompt.ts +3 -1
  505. package/src/cli/lib/install-from-github.ts +6 -2
  506. package/src/cli/lib/ipc-params.ts +6 -2
  507. package/src/cli/lib/list-installed-plugins.ts +21 -7
  508. package/src/cli/lib/parse-github-plugin-spec.ts +15 -5
  509. package/src/cli/lib/plugin-artifact.ts +9 -3
  510. package/src/cli/lib/plugin-catalog-platform.ts +7 -2
  511. package/src/cli/lib/plugin-catalog-resolve.ts +7 -5
  512. package/src/cli/lib/plugin-marketplace.ts +12 -4
  513. package/src/cli/lib/plugin-surfaces.ts +15 -5
  514. package/src/cli/lib/publish-plugin.ts +24 -8
  515. package/src/cli/lib/search-plugins.ts +3 -1
  516. package/src/cli/lib/time-ago.ts +18 -6
  517. package/src/cli/lib/unknown-command.ts +12 -4
  518. package/src/cli/output.ts +3 -1
  519. package/src/cli/program.ts +3 -1
  520. package/src/cli/utils/__tests__/conversation-id.test.ts +3 -3
  521. package/src/cli/utils/conversation-id.ts +9 -3
  522. package/src/cli/utils/parse-duration.ts +6 -2
  523. package/src/config/__tests__/default-plugin-skill-discovery.test.ts +158 -0
  524. package/src/config/__tests__/default-profile-catalog.test.ts +69 -1
  525. package/src/config/__tests__/deployment-context-defaults.test.ts +9 -3
  526. package/src/config/__tests__/feature-flag-registry-guard.test.ts +7 -2
  527. package/src/config/__tests__/loader-callsite-strip-fallback.test.ts +9 -3
  528. package/src/config/__tests__/plugin-resident-skill-discovery.test.ts +5 -2
  529. package/src/config/__tests__/seed-default-provider.test.ts +16 -0
  530. package/src/config/__tests__/sync-gated-profiles.test.ts +6 -2
  531. package/src/config/assistant-feature-flags.ts +39 -13
  532. package/src/config/bundled-skills/app-builder/SKILL.md +6 -5
  533. package/src/config/bundled-skills/app-builder/references/CUSTOM_ROUTES.md +24 -34
  534. package/src/config/bundled-skills/app-builder/references/DESIGN_SYSTEM.md +1 -1
  535. package/src/config/bundled-skills/app-builder/references/SLIDES.md +1 -0
  536. package/src/config/bundled-skills/app-builder/references/WIDGETS.md +1 -1
  537. package/src/config/bundled-skills/app-builder/tools/app-generate-icon.ts +3 -1
  538. package/src/config/bundled-skills/app-builder/tools/app-refresh.ts +3 -1
  539. package/src/config/bundled-skills/app-builder/tools/app-update.ts +3 -1
  540. package/src/config/bundled-skills/contacts/tools/contact-search.ts +11 -4
  541. package/src/config/bundled-skills/contacts/tools/google-contacts.ts +6 -2
  542. package/src/config/bundled-skills/media-processing/__tests__/extract-keyframes.test.ts +3 -1
  543. package/src/config/bundled-skills/media-processing/services/preprocess.ts +9 -3
  544. package/src/config/bundled-skills/media-processing/services/processing-pipeline.ts +9 -3
  545. package/src/config/bundled-skills/media-processing/services/reduce.ts +3 -1
  546. package/src/config/bundled-skills/media-processing/tools/generate-clip.ts +3 -1
  547. package/src/config/bundled-skills/media-processing/tools/ingest-media.ts +12 -4
  548. package/src/config/bundled-skills/messaging/SKILL.md +2 -2
  549. package/src/config/bundled-skills/messaging/tools/messaging-analyze-style.ts +6 -2
  550. package/src/config/bundled-skills/messaging/tools/messaging-draft.ts +23 -8
  551. package/src/config/bundled-skills/messaging/tools/messaging-send.ts +5 -2
  552. package/src/config/bundled-skills/messaging/tools/shared.ts +21 -7
  553. package/src/config/bundled-skills/phone-calls/references/TRANSCRIPTS.md +7 -7
  554. package/src/config/bundled-skills/playbooks/tools/playbook-list.ts +11 -4
  555. package/src/config/bundled-skills/schedule/SKILL.md +4 -0
  556. package/src/config/bundled-skills/schedule/TOOLS.json +8 -0
  557. package/src/config/bundled-skills/sequences/tools/sequence-create.ts +8 -3
  558. package/src/config/bundled-skills/sequences/tools/sequence-delete.ts +6 -2
  559. package/src/config/bundled-skills/sequences/tools/sequence-enroll.ts +12 -4
  560. package/src/config/bundled-skills/sequences/tools/sequence-enrollment-list.ts +3 -1
  561. package/src/config/bundled-skills/sequences/tools/sequence-get.ts +6 -2
  562. package/src/config/bundled-skills/sequences/tools/sequence-import.ts +13 -5
  563. package/src/config/bundled-skills/sequences/tools/sequence-list.ts +3 -1
  564. package/src/config/bundled-skills/sequences/tools/sequence-update.ts +17 -7
  565. package/src/config/bundled-skills/settings/TOOLS.json +4 -3
  566. package/src/config/bundled-skills/settings/tools/voice-config-update.ts +226 -2
  567. package/src/config/bundled-skills/skill-management/SKILL.md +1 -1
  568. package/src/config/bundled-skills/skill-management/TOOLS.json +1 -1
  569. package/src/config/bundled-skills/subagent/SKILL.md +3 -1
  570. package/src/config/bundled-skills/subagent/TOOLS.json +3 -3
  571. package/src/config/bundled-skills/transcribe/tools/transcribe-media.test.ts +3 -1
  572. package/src/config/bundled-skills/transcribe/tools/transcribe-media.ts +15 -5
  573. package/src/config/bundled-skills/visualize/SKILL.md +163 -0
  574. package/src/config/default-profile-catalog.ts +104 -43
  575. package/src/config/default-profile-names.ts +16 -2
  576. package/src/config/env-registry.ts +3 -1
  577. package/src/config/env.ts +6 -2
  578. package/src/config/feature-flag-registry.json +21 -5
  579. package/src/config/llm-resolver.ts +4 -4
  580. package/src/config/loader.ts +42 -14
  581. package/src/config/prune-seeded-callsite-defaults.ts +30 -10
  582. package/src/config/schema-utils.ts +9 -3
  583. package/src/config/schemas/__tests__/stt.test.ts +27 -0
  584. package/src/config/schemas/llm.ts +48 -4
  585. package/src/config/schemas/memory-v3.ts +7 -7
  586. package/src/config/schemas/monitoring.ts +28 -2
  587. package/src/config/schemas/stt.ts +20 -1
  588. package/src/config/seed-inference-profiles.ts +84 -160
  589. package/src/config/skills.ts +195 -45
  590. package/src/config/sync-gated-profiles.ts +21 -7
  591. package/src/contacts/__tests__/guardian-contact-reader.test.ts +3 -1
  592. package/src/contacts/contact-store.ts +106 -37
  593. package/src/contacts/guardian-contact-reader.ts +3 -1
  594. package/src/contacts/guardian-delivery-reader.ts +15 -5
  595. package/src/context/compactor.ts +96 -32
  596. package/src/context/estimator-calibration.ts +9 -3
  597. package/src/context/image-dimensions.ts +75 -25
  598. package/src/context/post-turn-tool-result-truncation.ts +160 -25
  599. package/src/context/strip-injections.ts +15 -5
  600. package/src/context/token-estimator.ts +3 -1
  601. package/src/context/tool-result-spool.ts +3 -1
  602. package/src/context/tool-result-truncation.ts +6 -2
  603. package/src/conversations/job-handlers/summarization.ts +18 -6
  604. package/src/credential-execution/ces-runtime.ts +10 -10
  605. package/src/credential-execution/process-manager.test.ts +3 -1
  606. package/src/credential-execution/process-manager.ts +6 -2
  607. package/src/credential-health/credential-health-service.ts +30 -10
  608. package/src/daemon/__tests__/embedding-reconcile.test.ts +3 -1
  609. package/src/daemon/__tests__/turn-tail-assistant-reply-notify.test.ts +182 -0
  610. package/src/daemon/__tests__/turn-tail-deleted-conversation.test.ts +181 -0
  611. package/src/daemon/app-source-watcher.ts +21 -7
  612. package/src/daemon/assistant-attachments.ts +44 -15
  613. package/src/daemon/classifier.ts +9 -3
  614. package/src/daemon/connection-policy.ts +6 -2
  615. package/src/daemon/conversation-agent-loop-handlers.ts +66 -1
  616. package/src/daemon/conversation-agent-loop.ts +43 -2
  617. package/src/daemon/conversation-error.ts +12 -4
  618. package/src/daemon/conversation-evictor.ts +12 -4
  619. package/src/daemon/conversation-media-retry.ts +18 -6
  620. package/src/daemon/conversation-messaging.ts +58 -15
  621. package/src/daemon/conversation-notices.ts +6 -2
  622. package/src/daemon/conversation-plugin-scope.ts +3 -1
  623. package/src/daemon/conversation-process.ts +104 -53
  624. package/src/daemon/conversation-queue-manager.ts +35 -8
  625. package/src/daemon/conversation-registry.ts +9 -3
  626. package/src/daemon/conversation-resting-trust.ts +64 -0
  627. package/src/daemon/conversation-runtime-assembly.ts +6 -2
  628. package/src/daemon/conversation-slash.ts +50 -17
  629. package/src/daemon/conversation-store.ts +16 -5
  630. package/src/daemon/conversation-surfaces.ts +35 -13
  631. package/src/daemon/conversation-turn-finalize.ts +76 -18
  632. package/src/daemon/conversation-usage.ts +109 -15
  633. package/src/daemon/conversation-workspace.ts +5 -2
  634. package/src/daemon/conversation.ts +12 -1
  635. package/src/daemon/daemon-control.ts +42 -14
  636. package/src/daemon/date-context.ts +15 -5
  637. package/src/daemon/dictation-profile-store.ts +26 -10
  638. package/src/daemon/dictation-text-processing.ts +9 -3
  639. package/src/daemon/disk-pressure-guard.ts +12 -4
  640. package/src/daemon/disk-pressure-policy.ts +15 -5
  641. package/src/daemon/first-greeting.ts +9 -3
  642. package/src/daemon/handlers/__tests__/config-channels.test.ts +9 -3
  643. package/src/daemon/handlers/config-channels.ts +3 -1
  644. package/src/daemon/handlers/conversations.ts +83 -11
  645. package/src/daemon/handlers/identity.ts +6 -2
  646. package/src/daemon/handlers/skills.ts +138 -48
  647. package/src/daemon/host-app-control-proxy.ts +3 -1
  648. package/src/daemon/host-bash-proxy.ts +11 -4
  649. package/src/daemon/host-cu-proxy.ts +20 -7
  650. package/src/daemon/host-transfer-proxy.ts +24 -8
  651. package/src/daemon/identity-helpers.ts +3 -1
  652. package/src/daemon/install-symlink.ts +18 -6
  653. package/src/daemon/interrupted-turn-reconciler.ts +7 -33
  654. package/src/daemon/lifecycle.ts +29 -5
  655. package/src/daemon/message-types/surfaces.ts +3 -0
  656. package/src/daemon/message-types/web-activity.ts +1 -0
  657. package/src/daemon/now-scratchpad.ts +3 -1
  658. package/src/daemon/orphan-reaper.test.ts +17 -6
  659. package/src/daemon/orphan-reaper.ts +24 -8
  660. package/src/daemon/parse-actual-tokens-from-error.ts +27 -9
  661. package/src/daemon/persist-media-references.ts +6 -2
  662. package/src/daemon/pkb-context-tracker.test.ts +37 -9
  663. package/src/daemon/pkb-context-tracker.ts +12 -4
  664. package/src/daemon/pointer-conversation-trust.ts +3 -1
  665. package/src/daemon/process-message.ts +3 -1
  666. package/src/daemon/profiler-run-store.ts +21 -7
  667. package/src/daemon/shutdown-handlers.ts +20 -7
  668. package/src/daemon/sqlite-corruption-watchdog.ts +6 -2
  669. package/src/daemon/summarize-boundary.ts +3 -1
  670. package/src/daemon/turn-latency-tracker.ts +33 -11
  671. package/src/daemon/verification-session-intent.ts +3 -1
  672. package/src/daemon/wake-conversation-ops.ts +3 -1
  673. package/src/daemon/web-search-history.ts +12 -4
  674. package/src/documents/document-store.ts +15 -5
  675. package/src/followups/followup-store.ts +9 -3
  676. package/src/heartbeat/heartbeat-run-store.ts +3 -1
  677. package/src/home/conversation-starter-checkpoints.ts +3 -1
  678. package/src/home/feed-source-enrichment.test.ts +7 -0
  679. package/src/home/feed-source-enrichment.ts +11 -2
  680. package/src/home/feed-writer.ts +27 -9
  681. package/src/home/home-greeting-cache.ts +3 -1
  682. package/src/home/job-handlers/conversation-starters.ts +15 -5
  683. package/src/home/post-connect-feed.ts +3 -1
  684. package/src/home/progress-formula.ts +6 -2
  685. package/src/home/relationship-state-writer.ts +78 -25
  686. package/src/ipc/__tests__/exit-helper.test.ts +12 -8
  687. package/src/ipc/__tests__/streaming-client.test.ts +54 -16
  688. package/src/ipc/__tests__/streaming-framing.test.ts +31 -8
  689. package/src/ipc/__tests__/ui-request-route.test.ts +3 -1
  690. package/src/ipc/__tests__/watcher-ipc.test.ts +6 -2
  691. package/src/ipc/assistant-server.ts +21 -13
  692. package/src/ipc/cli-client.ts +38 -13
  693. package/src/ipc/gateway-client.ts +6 -2
  694. package/src/ipc/gateway-flag-listener.ts +9 -3
  695. package/src/ipc/routes/__tests__/contacts-mirror-apply-atomicity.test.ts +7 -4
  696. package/src/ipc/routes/__tests__/contacts-mirror-apply.test.ts +22 -10
  697. package/src/ipc/routes/__tests__/contacts-mirror-ipc-routes.test.ts +26 -13
  698. package/src/ipc/routes/__tests__/contacts-mirror-merge-contact.test.ts +35 -9
  699. package/src/ipc/routes/__tests__/contacts-mirror-upsert-full.test.ts +37 -20
  700. package/src/ipc/routes/__tests__/guardian-label-ipc-routes.test.ts +4 -6
  701. package/src/ipc/routes/contacts-info-ipc-routes.ts +9 -6
  702. package/src/ipc/routes/trust-rules.test.ts +6 -2
  703. package/src/ipc/socket-cleanup.ts +6 -2
  704. package/src/live-voice/__tests__/live-activity-reporter.test.ts +194 -0
  705. package/src/live-voice/__tests__/live-voice-archive.test.ts +24 -8
  706. package/src/live-voice/__tests__/live-voice-stt.test.ts +330 -3
  707. package/src/live-voice/__tests__/live-voice-vad.test.ts +11 -1
  708. package/src/live-voice/__tests__/protocol.test.ts +45 -15
  709. package/src/live-voice/__tests__/runtime-websocket-shell.test.ts +6 -2
  710. package/src/live-voice/live-activity-reporter.ts +180 -0
  711. package/src/live-voice/live-voice-archive.ts +18 -6
  712. package/src/live-voice/live-voice-metrics.ts +24 -8
  713. package/src/live-voice/live-voice-session.ts +154 -15
  714. package/src/live-voice/protocol.ts +6 -2
  715. package/src/mcp/client.ts +9 -3
  716. package/src/mcp/manager.ts +3 -1
  717. package/src/mcp/mcp-auth-orchestrator.ts +3 -1
  718. package/src/mcp/mcp-header-store.ts +3 -1
  719. package/src/mcp/mcp-oauth-provider.ts +12 -4
  720. package/src/media/gemini-image-service.ts +15 -5
  721. package/src/media/openai-image-service.ts +9 -3
  722. package/src/messaging/draft-store.ts +3 -1
  723. package/src/messaging/providers/__tests__/transport-dispatch.test.ts +3 -1
  724. package/src/messaging/providers/a2a/__tests__/deliver.test.ts +3 -1
  725. package/src/messaging/providers/a2a/deliver.ts +3 -1
  726. package/src/messaging/providers/callback-routing.ts +3 -1
  727. package/src/messaging/providers/gmail/adapter.ts +36 -12
  728. package/src/messaging/providers/gmail/client.ts +71 -24
  729. package/src/messaging/providers/gmail/mime-builder.ts +6 -2
  730. package/src/messaging/providers/gmail/people-client.ts +3 -1
  731. package/src/messaging/providers/outlook/client.ts +30 -10
  732. package/src/messaging/providers/slack/__tests__/adapter-token-routing.test.ts +15 -6
  733. package/src/messaging/providers/slack/adapter.ts +51 -17
  734. package/src/messaging/providers/slack/api.ts +39 -13
  735. package/src/messaging/providers/slack/client.ts +9 -3
  736. package/src/messaging/providers/slack/deep-link.ts +15 -5
  737. package/src/messaging/providers/slack/message-metadata.ts +21 -7
  738. package/src/messaging/providers/slack/render-transcript.ts +54 -18
  739. package/src/messaging/providers/slack/render.ts +50 -17
  740. package/src/messaging/providers/slack/transport.ts +9 -3
  741. package/src/messaging/providers/telegram-bot/adapter.ts +6 -2
  742. package/src/messaging/providers/telegram-bot/api.ts +3 -1
  743. package/src/messaging/providers/telegram-bot/render.ts +33 -11
  744. package/src/messaging/providers/telegram-bot/send.ts +3 -1
  745. package/src/messaging/providers/whatsapp/adapter.ts +3 -1
  746. package/src/messaging/providers/whatsapp/api.ts +9 -3
  747. package/src/messaging/registry.ts +3 -1
  748. package/src/messaging/style-analyzer.ts +3 -1
  749. package/src/monitoring/__tests__/db-integrity-sample.test.ts +110 -0
  750. package/src/monitoring/__tests__/file-descriptors.test.ts +144 -0
  751. package/src/monitoring/__tests__/sample-ring-buffer.test.ts +12 -4
  752. package/src/monitoring/db-integrity-check.ts +163 -0
  753. package/src/monitoring/db-integrity-sample.ts +171 -0
  754. package/src/monitoring/file-descriptors.ts +262 -0
  755. package/src/monitoring/process-memory.ts +4 -10
  756. package/src/monitoring/resource-sampler.ts +5 -0
  757. package/src/monitoring/sample-ring-buffer.ts +15 -5
  758. package/src/monitoring/worker.ts +24 -0
  759. package/src/notifications/__tests__/assistant-reply-producer.test.ts +740 -0
  760. package/src/notifications/__tests__/broadcaster.test.ts +321 -7
  761. package/src/notifications/__tests__/decision-engine.test.ts +201 -11
  762. package/src/notifications/__tests__/deterministic-checks.test.ts +21 -0
  763. package/src/notifications/__tests__/guardian-delivery-recorder.test.ts +71 -0
  764. package/src/notifications/adapters/macos.ts +1 -0
  765. package/src/notifications/adapters/platform.ts +36 -5
  766. package/src/notifications/adapters/shared.ts +9 -3
  767. package/src/notifications/assistant-reply-producer.ts +219 -0
  768. package/src/notifications/broadcaster.ts +512 -317
  769. package/src/notifications/conversation-candidates.ts +21 -7
  770. package/src/notifications/conversation-seed-composer.ts +21 -7
  771. package/src/notifications/copy-composer.ts +16 -7
  772. package/src/notifications/decision-engine.ts +129 -74
  773. package/src/notifications/decisions-store.ts +6 -2
  774. package/src/notifications/deferred-emit.ts +18 -6
  775. package/src/notifications/deliveries-store.ts +3 -1
  776. package/src/notifications/destination-resolver.ts +12 -6
  777. package/src/notifications/deterministic-checks.ts +12 -9
  778. package/src/notifications/edit-notification.ts +3 -1
  779. package/src/notifications/emit-signal.ts +49 -16
  780. package/src/notifications/events-store.ts +3 -1
  781. package/src/notifications/guardian-delivery-recorder.ts +8 -2
  782. package/src/notifications/guardian-question-mode.ts +15 -5
  783. package/src/notifications/home-feed-side-effect.ts +12 -4
  784. package/src/notifications/notification-utils.ts +40 -6
  785. package/src/notifications/preference-extractor.ts +5 -2
  786. package/src/notifications/preference-summary.ts +3 -1
  787. package/src/notifications/signal.ts +10 -0
  788. package/src/notifications/types.ts +9 -0
  789. package/src/oauth/__tests__/oauth-connect-state.test.ts +4 -1
  790. package/src/oauth/byo-connection.test.ts +15 -5
  791. package/src/oauth/byo-connection.ts +6 -2
  792. package/src/oauth/connect-orchestrator.ts +3 -1
  793. package/src/oauth/connection-resolver.test.ts +6 -2
  794. package/src/oauth/connection-resolver.ts +12 -4
  795. package/src/oauth/identity-verifier.ts +30 -10
  796. package/src/oauth/manual-token-connection.ts +12 -4
  797. package/src/oauth/oauth-connect-state.ts +15 -3
  798. package/src/oauth/oauth-store.ts +132 -52
  799. package/src/oauth/provider-serializer.ts +9 -3
  800. package/src/oauth/provider-visibility.ts +3 -1
  801. package/src/oauth/scope-utils.ts +3 -1
  802. package/src/onboarding/checkin-event.ts +33 -11
  803. package/src/outbound-proxy/certs.ts +6 -2
  804. package/src/outbound-proxy/connect-tunnel.ts +15 -5
  805. package/src/outbound-proxy/host-pattern-match.ts +3 -1
  806. package/src/outbound-proxy/http-forwarder.ts +9 -3
  807. package/src/outbound-proxy/logging.ts +6 -2
  808. package/src/outbound-proxy/mitm-handler.ts +9 -3
  809. package/src/outbound-proxy/policy.ts +12 -4
  810. package/src/outbound-proxy/router.ts +3 -1
  811. package/src/outbound-proxy/server.ts +15 -5
  812. package/src/permissions/approval-provenance.test.ts +13 -4
  813. package/src/permissions/question-prompter.test.ts +12 -4
  814. package/src/permissions/question-prompter.ts +6 -2
  815. package/src/persistence/__tests__/raw-query-telemetry.test.ts +3 -1
  816. package/src/persistence/a2a-invite-store.ts +1 -4
  817. package/src/persistence/attachments-store.ts +60 -20
  818. package/src/persistence/bookmark-crud.ts +6 -2
  819. package/src/persistence/compaction-ledger-store.ts +6 -2
  820. package/src/persistence/compaction-log-store-clickhouse.ts +29 -10
  821. package/src/persistence/conversation-attention-store.ts +29 -1
  822. package/src/persistence/conversation-crud.ts +258 -103
  823. package/src/persistence/conversation-directories.ts +9 -3
  824. package/src/persistence/conversation-group-migration.ts +17 -1
  825. package/src/persistence/conversation-key-store.ts +3 -1
  826. package/src/persistence/conversation-queries.ts +174 -60
  827. package/src/persistence/conversation-search-lexical.ts +3 -1
  828. package/src/persistence/conversation-types.ts +192 -1
  829. package/src/persistence/db-async-query.ts +9 -3
  830. package/src/persistence/delivery-channels.ts +3 -1
  831. package/src/persistence/embeddings/__tests__/embedding-identity.test.ts +9 -3
  832. package/src/persistence/embeddings/__tests__/embedding-local-lifecycle.test.ts +755 -0
  833. package/src/persistence/embeddings/__tests__/plugin-facade-index.test.ts +73 -0
  834. package/src/persistence/embeddings/__tests__/plugin-index.test.ts +323 -0
  835. package/src/persistence/embeddings/embed.ts +21 -7
  836. package/src/persistence/embeddings/embedding-backend.test.ts +12 -4
  837. package/src/persistence/embeddings/embedding-backend.ts +181 -24
  838. package/src/persistence/embeddings/embedding-billing-breaker.ts +21 -7
  839. package/src/persistence/embeddings/embedding-cache.ts +6 -2
  840. package/src/persistence/embeddings/embedding-gemini.ts +6 -2
  841. package/src/persistence/embeddings/embedding-identity.ts +12 -4
  842. package/src/persistence/embeddings/embedding-local.ts +719 -142
  843. package/src/persistence/embeddings/embedding-ollama.ts +6 -2
  844. package/src/persistence/embeddings/embedding-openai.ts +3 -1
  845. package/src/persistence/embeddings/embedding-runtime-manager.ts +25 -9
  846. package/src/persistence/embeddings/embedding-types.ts +22 -1
  847. package/src/persistence/embeddings/messages-lexical-index.ts +12 -4
  848. package/src/persistence/embeddings/plugin-facade.ts +102 -3
  849. package/src/persistence/embeddings/plugin-index.ts +341 -0
  850. package/src/persistence/embeddings/qdrant-circuit-breaker.ts +6 -2
  851. package/src/persistence/embeddings/qdrant-client.test.ts +10 -4
  852. package/src/persistence/embeddings/qdrant-client.ts +173 -9
  853. package/src/persistence/embeddings/qdrant-manager.ts +21 -7
  854. package/src/persistence/external-conversation-store.ts +6 -2
  855. package/src/persistence/group-crud.test.ts +59 -0
  856. package/src/persistence/group-crud.ts +36 -11
  857. package/src/persistence/job-handlers/cleanup.ts +30 -12
  858. package/src/persistence/job-utils.ts +46 -26
  859. package/src/persistence/llm-request-log-sink-clickhouse.ts +12 -4
  860. package/src/persistence/llm-request-log-source-clickhouse.ts +18 -6
  861. package/src/persistence/llm-request-log-store.ts +26 -9
  862. package/src/persistence/migrations/001-job-deferrals.ts +3 -1
  863. package/src/persistence/migrations/002-tool-invocations-fk.ts +6 -2
  864. package/src/persistence/migrations/003-memory-fts-backfill.ts +3 -1
  865. package/src/persistence/migrations/004-entity-relation-dedup.ts +3 -1
  866. package/src/persistence/migrations/005-fingerprint-scope-unique.ts +3 -1
  867. package/src/persistence/migrations/006-scope-salted-fingerprints.ts +6 -2
  868. package/src/persistence/migrations/007-assistant-id-to-self.ts +3 -1
  869. package/src/persistence/migrations/008-remove-assistant-id-columns.ts +6 -2
  870. package/src/persistence/migrations/009-llm-usage-events-drop-assistant-id.ts +6 -2
  871. package/src/persistence/migrations/011-call-sessions-provider-sid-dedup.ts +9 -3
  872. package/src/persistence/migrations/014-backfill-inbox-thread-state.ts +3 -1
  873. package/src/persistence/migrations/015-drop-active-search-index.ts +3 -1
  874. package/src/persistence/migrations/019-notification-tables-schema-migration.ts +3 -1
  875. package/src/persistence/migrations/020-rename-macos-ios-channel-to-vellum.ts +3 -1
  876. package/src/persistence/migrations/024-embedding-vector-blob.ts +6 -2
  877. package/src/persistence/migrations/025-messages-fts-backfill.ts +3 -1
  878. package/src/persistence/migrations/026a-embeddings-nullable-vector-json.ts +9 -3
  879. package/src/persistence/migrations/036-normalize-phone-identities.ts +36 -12
  880. package/src/persistence/migrations/120-fk-cascade-rebuilds.ts +12 -4
  881. package/src/persistence/migrations/126-backfill-guardian-principal-id.ts +6 -2
  882. package/src/persistence/migrations/127-guardian-principal-id-not-null.ts +15 -5
  883. package/src/persistence/migrations/134-contacts-notes-column.ts +10 -4
  884. package/src/persistence/migrations/135-backfill-contact-interaction-stats.ts +6 -2
  885. package/src/persistence/migrations/136-drop-assistant-id-columns.ts +12 -4
  886. package/src/persistence/migrations/140-backfill-usage-cache-accounting.ts +24 -8
  887. package/src/persistence/migrations/141-rename-verification-table.ts +12 -4
  888. package/src/persistence/migrations/142-rename-verification-session-id-column.ts +6 -2
  889. package/src/persistence/migrations/147-migrate-reminders-to-schedules.ts +6 -2
  890. package/src/persistence/migrations/150-oauth-apps-client-secret-path.ts +12 -4
  891. package/src/persistence/migrations/157-invite-contact-id.ts +3 -1
  892. package/src/persistence/migrations/162-guardian-timestamps-epoch-ms.ts +21 -8
  893. package/src/persistence/migrations/174-rename-thread-starters-table.ts +12 -4
  894. package/src/persistence/migrations/180-backfill-inline-attachments-to-disk.ts +3 -1
  895. package/src/persistence/migrations/196-strip-integration-prefix-from-provider-keys.ts +6 -2
  896. package/src/persistence/migrations/206-scrub-corrupted-image-attachments.ts +3 -1
  897. package/src/persistence/migrations/209-strip-thinking-from-consolidated.ts +3 -1
  898. package/src/persistence/migrations/220-normalize-user-file-by-principal.ts +24 -8
  899. package/src/persistence/migrations/222-strip-placeholder-sentinels-from-messages.ts +3 -1
  900. package/src/persistence/migrations/231-repair-memory-graph-event-dates.ts +18 -6
  901. package/src/persistence/migrations/241-activation-state-fk-cascade.ts +6 -2
  902. package/src/persistence/migrations/246-backfill-provider-connection-label.ts +3 -1
  903. package/src/persistence/migrations/247-external-conversation-binding-thread-id.ts +3 -1
  904. package/src/persistence/migrations/249-normalize-slack-external-content.ts +30 -10
  905. package/src/persistence/migrations/256-memory-v2-injection-events.ts +24 -8
  906. package/src/persistence/migrations/296-rewrite-balanced-economy-profile-pins.test.ts +3 -1
  907. package/src/persistence/migrations/296-rewrite-balanced-economy-profile-pins.ts +6 -2
  908. package/src/persistence/migrations/297-move-llm-request-logs-to-logs-db.ts +3 -1
  909. package/src/persistence/migrations/302-create-compaction-events.ts +3 -1
  910. package/src/persistence/migrations/306-rewrite-frontier-profile-pins.test.ts +3 -1
  911. package/src/persistence/migrations/306-rewrite-frontier-profile-pins.ts +6 -2
  912. package/src/persistence/migrations/311-create-subagents-table.ts +5 -3
  913. package/src/persistence/migrations/318-drop-contact-channel-telemetry.ts +3 -1
  914. package/src/persistence/migrations/319-remove-legacy-managed-connections.ts +3 -1
  915. package/src/persistence/migrations/329-move-onboarding-events-to-telemetry-db.ts +3 -1
  916. package/src/persistence/migrations/340-sweep-orphaned-graph-node-vectors.test.ts +9 -0
  917. package/src/persistence/migrations/342-add-conversation-parent-id.test.ts +1 -3
  918. package/src/persistence/migrations/352-drop-schedule-skill-script-handoff.ts +3 -1
  919. package/src/persistence/migrations/355-add-schedule-group-id.ts +22 -0
  920. package/src/persistence/migrations/356-add-subagent-parent-tool-use-id.test.ts +87 -0
  921. package/src/persistence/migrations/356-add-subagent-parent-tool-use-id.ts +31 -0
  922. package/src/persistence/migrations/357-move-memory-segments-to-memory-db.ts +95 -0
  923. package/src/persistence/migrations/358-move-memory-embeddings-to-memory-db.ts +83 -0
  924. package/src/persistence/migrations/359-move-memory-summaries-to-memory-db.ts +86 -0
  925. package/src/persistence/migrations/__tests__/350-conversations-total-input-tokens-nullable.test.ts +3 -1
  926. package/src/persistence/migrations/run-migrations.ts +12 -4
  927. package/src/persistence/migrations/validate-migration-state.ts +12 -4
  928. package/src/persistence/raw-query.ts +9 -3
  929. package/src/persistence/schema/conversation-groups.ts +2 -0
  930. package/src/persistence/schema/infrastructure.ts +1 -0
  931. package/src/persistence/slow-query-log.ts +27 -9
  932. package/src/persistence/slow-sync-log.ts +3 -1
  933. package/src/persistence/steps.ts +60 -0
  934. package/src/persistence/subagent-store.ts +187 -8
  935. package/src/persistence/usage-buckets.ts +9 -3
  936. package/src/persistence/usage-grouped-buckets.ts +6 -2
  937. package/src/platform/client.test.ts +172 -2
  938. package/src/platform/client.ts +178 -55
  939. package/src/platform/feature-gate.ts +3 -1
  940. package/src/platform/sync-identity.ts +9 -3
  941. package/src/playbooks/playbook-compiler.ts +3 -1
  942. package/src/plugin-api/conversation-turn.ts +13 -0
  943. package/src/plugin-api/index.ts +34 -1
  944. package/src/plugin-api/model-profiles.test.ts +30 -0
  945. package/src/plugin-api/model-profiles.ts +11 -4
  946. package/src/plugin-api/vision-support.test.ts +66 -2
  947. package/src/plugin-api/vision-support.ts +15 -3
  948. package/src/plugins/defaults/channel/injectors.ts +12 -4
  949. package/src/plugins/defaults/compaction/window-manager.ts +30 -10
  950. package/src/plugins/defaults/documents/injectors.ts +18 -6
  951. package/src/plugins/defaults/empty-response/hooks/post-model-call.ts +9 -3
  952. package/src/plugins/defaults/exploration-drift/hooks/post-tool-use.ts +26 -8
  953. package/src/plugins/defaults/image-fallback/hooks/post-compact.ts +3 -1
  954. package/src/plugins/defaults/image-fallback/hooks/post-tool-use.ts +6 -2
  955. package/src/plugins/defaults/image-fallback/hooks/user-prompt-submit.ts +3 -1
  956. package/src/plugins/defaults/image-fallback/src/caption-blocks.ts +6 -2
  957. package/src/plugins/defaults/image-fallback/src/image-persist.ts +3 -1
  958. package/src/plugins/defaults/image-fallback/src/vision-caption.ts +6 -2
  959. package/src/plugins/defaults/index.ts +0 -28
  960. package/src/plugins/defaults/injection-presence.ts +3 -1
  961. package/src/plugins/defaults/main.ts +31 -0
  962. package/src/plugins/defaults/max-tokens-continue/hooks/post-model-call.ts +62 -6
  963. package/src/plugins/defaults/memory/AGENTS.md +10 -7
  964. package/src/plugins/defaults/memory/__tests__/capability-seed-embed-gate.test.ts +4 -4
  965. package/src/plugins/defaults/memory/__tests__/compaction-log-store-clickhouse.test.ts +6 -2
  966. package/src/plugins/defaults/memory/__tests__/conversation-memory-purge.test.ts +1 -0
  967. package/src/plugins/defaults/memory/__tests__/conversation-queries.test.ts +246 -0
  968. package/src/plugins/defaults/memory/__tests__/conversation-row-batch-delete.test.ts +18 -34
  969. package/src/plugins/defaults/memory/__tests__/db-async-query.test.ts +3 -1
  970. package/src/plugins/defaults/memory/__tests__/db-memory-attach.test.ts +3 -0
  971. package/src/plugins/defaults/memory/__tests__/embedding-cache.test.ts +10 -7
  972. package/src/plugins/defaults/memory/__tests__/indexer-tier-dispatch.test.ts +62 -2
  973. package/src/plugins/defaults/memory/__tests__/memory-retrospective-sweep.test.ts +1 -1
  974. package/src/plugins/defaults/memory/__tests__/memory-tier-boundary-guard.test.ts +1 -1
  975. package/src/plugins/defaults/memory/__tests__/relocated-memory-test-rows.ts +16 -0
  976. package/src/plugins/defaults/memory/__tests__/table-relocation.test.ts +183 -0
  977. package/src/plugins/defaults/memory/__tests__/worker-control.test.ts +6 -2
  978. package/src/plugins/defaults/memory/anisotropy.test.ts +18 -6
  979. package/src/plugins/defaults/memory/anisotropy.ts +45 -15
  980. package/src/plugins/defaults/memory/context-search/agent-protocol.ts +3 -1
  981. package/src/plugins/defaults/memory/context-search/agent-runner.ts +6 -2
  982. package/src/plugins/defaults/memory/context-search/limits.ts +6 -2
  983. package/src/plugins/defaults/memory/context-search/search.ts +30 -10
  984. package/src/plugins/defaults/memory/context-search/sources/memory.ts +9 -3
  985. package/src/plugins/defaults/memory/context-search/sources/workspace.ts +33 -11
  986. package/src/plugins/defaults/memory/conversation-memory-purge.ts +5 -0
  987. package/src/plugins/defaults/memory/find-most-recent-retrospective-for.ts +3 -1
  988. package/src/plugins/defaults/memory/frontmatter.ts +3 -1
  989. package/src/plugins/defaults/memory/graph/__tests__/conversation-graph-memory-recent-summaries.test.ts +142 -0
  990. package/src/plugins/defaults/memory/graph/__tests__/conversation-graph-memory-v2-routing.test.ts +9 -4
  991. package/src/plugins/defaults/memory/graph/conversation-graph-memory.ts +117 -45
  992. package/src/plugins/defaults/memory/graph/graph-memory-state-store.ts +9 -3
  993. package/src/plugins/defaults/memory/graph/graph-search.ts +3 -1
  994. package/src/plugins/defaults/memory/graph/store.ts +113 -45
  995. package/src/plugins/defaults/memory/graph/types.ts +20 -7
  996. package/src/plugins/defaults/memory/graph-topology/__tests__/build-memory-graph.test.ts +1 -0
  997. package/src/plugins/defaults/memory/indexer.ts +40 -3
  998. package/src/plugins/defaults/memory/jobs/__tests__/embed-concept-page.test.ts +2 -2
  999. package/src/plugins/defaults/memory/jobs/embed-concept-page.ts +20 -21
  1000. package/src/plugins/defaults/memory/memory-db.ts +3 -1
  1001. package/src/plugins/defaults/memory/memory-retrospective-accounting.ts +18 -6
  1002. package/src/plugins/defaults/memory/memory-retrospective-enqueue.ts +1 -1
  1003. package/src/plugins/defaults/memory/memory-retrospective-state.ts +30 -10
  1004. package/src/plugins/defaults/memory/memory-retrospective-sweep.ts +1 -1
  1005. package/src/plugins/defaults/memory/memory-retrospective-trigger-check.ts +18 -6
  1006. package/src/plugins/defaults/memory/prompt-override.ts +6 -2
  1007. package/src/plugins/defaults/memory/segmenter.ts +6 -2
  1008. package/src/plugins/defaults/memory/src/__tests__/memory-ingest-routes.test.ts +176 -0
  1009. package/src/plugins/defaults/memory/src/__tests__/memory-v2-simulate-route.test.ts +1 -0
  1010. package/src/plugins/defaults/memory/src/__tests__/memory-worker-routes.test.ts +3 -1
  1011. package/src/plugins/defaults/memory/src/memory-ingest-routes.ts +125 -0
  1012. package/src/plugins/defaults/memory/src/memory-v2-routes.ts +5 -2
  1013. package/src/plugins/defaults/memory/substrate/__tests__/consolidation-lock.test.ts +136 -0
  1014. package/src/plugins/defaults/memory/substrate/__tests__/ingest.test.ts +440 -0
  1015. package/src/plugins/defaults/memory/substrate/__tests__/page-index.test.ts +129 -2
  1016. package/src/plugins/defaults/memory/substrate/__tests__/page-store.test.ts +31 -0
  1017. package/src/plugins/defaults/memory/substrate/__tests__/skill-store.test.ts +195 -1
  1018. package/src/plugins/defaults/memory/substrate/consolidation-job.ts +11 -219
  1019. package/src/plugins/defaults/memory/substrate/consolidation-lock.ts +250 -0
  1020. package/src/plugins/defaults/memory/substrate/ingest.ts +360 -0
  1021. package/src/plugins/defaults/memory/substrate/page-index.ts +110 -1
  1022. package/src/plugins/defaults/memory/substrate/page-store.ts +20 -24
  1023. package/src/plugins/defaults/memory/substrate/skill-store.ts +167 -29
  1024. package/src/plugins/defaults/memory/substrate/types.ts +12 -0
  1025. package/src/plugins/defaults/memory/task-memory-cleanup.ts +18 -6
  1026. package/src/plugins/defaults/memory/v1/graph/bootstrap.ts +27 -10
  1027. package/src/plugins/defaults/memory/v1/graph/consolidation.ts +57 -21
  1028. package/src/plugins/defaults/memory/v1/graph/decay.ts +6 -2
  1029. package/src/plugins/defaults/memory/v1/graph/extraction-job.ts +3 -1
  1030. package/src/plugins/defaults/memory/v1/graph/injection.ts +24 -8
  1031. package/src/plugins/defaults/memory/v1/graph/narrative.ts +3 -1
  1032. package/src/plugins/defaults/memory/v1/graph/pattern-scan.ts +3 -1
  1033. package/src/plugins/defaults/memory/v1/graph/scoring.ts +18 -6
  1034. package/src/plugins/defaults/memory/v1/graph/serendipity.ts +9 -3
  1035. package/src/plugins/defaults/memory/v1/graph/triggers.ts +30 -10
  1036. package/src/plugins/defaults/memory/v1/job-handlers/embedding.ts +10 -3
  1037. package/src/plugins/defaults/memory/v1/job-handlers/index-maintenance.ts +12 -12
  1038. package/src/plugins/defaults/memory/v1/jobs/embed-pkb-file.ts +9 -3
  1039. package/src/plugins/defaults/memory/v1/pkb/autoinject.ts +3 -1
  1040. package/src/plugins/defaults/memory/v1/pkb/context.ts +12 -4
  1041. package/src/plugins/defaults/memory/v1/pkb/pkb-reconcile.test.ts +3 -1
  1042. package/src/plugins/defaults/memory/v1/pkb/pkb-reconcile.ts +3 -1
  1043. package/src/plugins/defaults/memory/v1/pkb/pkb-search.test.ts +6 -2
  1044. package/src/plugins/defaults/memory/v1/pkb/pkb-search.ts +15 -5
  1045. package/src/plugins/defaults/memory/v1/pkb-schedule.ts +3 -1
  1046. package/src/plugins/defaults/memory/v1/semantic-search.ts +30 -15
  1047. package/src/plugins/defaults/memory/v2/__tests__/injection.test.ts +131 -0
  1048. package/src/plugins/defaults/memory/v2/__tests__/router.test.ts +1 -0
  1049. package/src/plugins/defaults/memory/v2/activation-log-store.ts +4 -0
  1050. package/src/plugins/defaults/memory/v2/harness/metrics.ts +9 -3
  1051. package/src/plugins/defaults/memory/v2/harness/runner.ts +9 -3
  1052. package/src/plugins/defaults/memory/v2/injection-events.ts +21 -7
  1053. package/src/plugins/defaults/memory/v2/injection.ts +48 -3
  1054. package/src/plugins/defaults/memory/v3/__tests__/card.test.ts +2 -2
  1055. package/src/plugins/defaults/memory/v3/__tests__/carry-integration.test.ts +1 -0
  1056. package/src/plugins/defaults/memory/v3/__tests__/dense.test.ts +9 -3
  1057. package/src/plugins/defaults/memory/v3/__tests__/edge.test.ts +9 -1
  1058. package/src/plugins/defaults/memory/v3/__tests__/fresh-set.test.ts +39 -5
  1059. package/src/plugins/defaults/memory/v3/__tests__/injection.test.ts +6 -2
  1060. package/src/plugins/defaults/memory/v3/__tests__/live-integration.test.ts +1 -0
  1061. package/src/plugins/defaults/memory/v3/__tests__/orchestrate.test.ts +2 -0
  1062. package/src/plugins/defaults/memory/v3/__tests__/section-dense-store.test.ts +13 -3
  1063. package/src/plugins/defaults/memory/v3/__tests__/shadow-integration.test.ts +1 -0
  1064. package/src/plugins/defaults/memory/v3/__tests__/shadow-plugin.test.ts +4 -0
  1065. package/src/plugins/defaults/memory/v3/card.ts +1 -1
  1066. package/src/plugins/defaults/memory/v3/core-set.ts +6 -2
  1067. package/src/plugins/defaults/memory/v3/dense.ts +15 -5
  1068. package/src/plugins/defaults/memory/v3/entity-lane.ts +9 -3
  1069. package/src/plugins/defaults/memory/v3/ever-injected-store.ts +39 -13
  1070. package/src/plugins/defaults/memory/v3/fresh-set.ts +27 -15
  1071. package/src/plugins/defaults/memory/v3/hot-set.ts +6 -2
  1072. package/src/plugins/defaults/memory/v3/injector.ts +51 -17
  1073. package/src/plugins/defaults/memory/v3/learned-edges.ts +21 -7
  1074. package/src/plugins/defaults/memory/v3/llm-retry.ts +3 -1
  1075. package/src/plugins/defaults/memory/v3/orchestrate.ts +15 -5
  1076. package/src/plugins/defaults/memory/v3/pool-select.test.ts +3 -1
  1077. package/src/plugins/defaults/memory/v3/pool-select.ts +15 -5
  1078. package/src/plugins/defaults/memory/v3/render-injection.ts +6 -2
  1079. package/src/plugins/defaults/memory/v3/section-dense-store.ts +51 -25
  1080. package/src/plugins/defaults/memory/v3/section-needle.ts +27 -9
  1081. package/src/plugins/defaults/memory/v3/sections.ts +6 -2
  1082. package/src/plugins/defaults/memory/v3/shadow-plugin.ts +24 -17
  1083. package/src/plugins/defaults/memory/v3-eval/__tests__/eval-tally.test.ts +9 -3
  1084. package/src/plugins/defaults/memory/v3-eval/eval-packets.ts +6 -0
  1085. package/src/plugins/defaults/memory/v3-eval/eval-tally.ts +22 -9
  1086. package/src/plugins/defaults/memory/worker.ts +54 -10
  1087. package/src/plugins/defaults/session/injectors.ts +15 -5
  1088. package/src/plugins/defaults/surface-completion-nudge/hooks/post-model-call.ts +49 -17
  1089. package/src/plugins/defaults/task-progress-nudge/hooks/post-tool-use.ts +33 -11
  1090. package/src/plugins/defaults/title-generate/hooks/stop.ts +15 -5
  1091. package/src/plugins/defaults/title-generate/hooks/user-prompt-submit.ts +6 -2
  1092. package/src/plugins/defaults/tool-error/hooks/post-tool-use.ts +21 -7
  1093. package/src/plugins/defaults/tool-result-truncate/terminal.ts +3 -1
  1094. package/src/plugins/defaults/turn-context/injectors.ts +3 -1
  1095. package/src/plugins/defaults/workspace/injectors.ts +52 -18
  1096. package/src/plugins/external-plugin-loader.ts +21 -7
  1097. package/src/plugins/injector-registry.ts +6 -2
  1098. package/src/prompts/__tests__/system-prompt.test.ts +5 -2
  1099. package/src/prompts/bootstrap-cleanup.ts +3 -1
  1100. package/src/prompts/normalize-onboarding.ts +9 -3
  1101. package/src/prompts/persona-resolver.ts +33 -11
  1102. package/src/prompts/sections.ts +42 -14
  1103. package/src/prompts/system-prompt.ts +30 -10
  1104. package/src/prompts/template-detection.ts +6 -2
  1105. package/src/prompts/templates/system-sections.ts +55 -20
  1106. package/src/prompts/user-reference.ts +6 -2
  1107. package/src/providers/__tests__/connection-model-compat.test.ts +6 -1
  1108. package/src/providers/__tests__/inference.test.ts +24 -8
  1109. package/src/providers/__tests__/preflight-resolved-config.test.ts +25 -0
  1110. package/src/providers/__tests__/request-diagnostics.test.ts +131 -0
  1111. package/src/providers/__tests__/retry-callsite.test.ts +30 -0
  1112. package/src/providers/__tests__/search-provider-catalog.test.ts +4 -1
  1113. package/src/providers/__tests__/vellum-mismatch-routing.test.ts +108 -1
  1114. package/src/providers/anthropic/client.ts +119 -41
  1115. package/src/providers/call-site-routing.ts +7 -0
  1116. package/src/providers/connection-model-compat.ts +12 -4
  1117. package/src/providers/connection-resolution.ts +61 -1
  1118. package/src/providers/fetch-provider-catalog.ts +3 -2
  1119. package/src/providers/gemini/client.ts +86 -12
  1120. package/src/providers/inference/codex-token-refresh.ts +6 -2
  1121. package/src/providers/inference/connection-availability.ts +13 -1
  1122. package/src/providers/inference/connections.ts +78 -15
  1123. package/src/providers/media-resolve.ts +21 -7
  1124. package/src/providers/model-catalog.ts +104 -74
  1125. package/src/providers/model-intents.ts +2 -2
  1126. package/src/providers/ollama/client.ts +3 -1
  1127. package/src/providers/openai/__tests__/chat-completions-input-audio.test.ts +3 -1
  1128. package/src/providers/openai/__tests__/chat-completions-provider-endpoint.test.ts +3 -1
  1129. package/src/providers/openai/__tests__/chat-completions-provider-reasoning.test.ts +3 -1
  1130. package/src/providers/openai/api-error-normalization.ts +75 -25
  1131. package/src/providers/openai/chat-completions-provider.ts +49 -16
  1132. package/src/providers/openai/codex-models.ts +9 -5
  1133. package/src/providers/openai/coerce-object-args.ts +12 -4
  1134. package/src/providers/openai/responses-provider.ts +31 -11
  1135. package/src/providers/openrouter/client.ts +9 -3
  1136. package/src/providers/platform-proxy/context.ts +9 -3
  1137. package/src/providers/provider-catalog-visibility.ts +4 -4
  1138. package/src/providers/provider-send-message.ts +6 -0
  1139. package/src/providers/ratelimit.ts +6 -2
  1140. package/src/providers/request-diagnostics.ts +225 -0
  1141. package/src/providers/retry.ts +68 -17
  1142. package/src/providers/routing-identity.ts +2 -1
  1143. package/src/providers/search-provider-catalog.ts +18 -0
  1144. package/src/providers/speech-to-text/__tests__/deepgram.test.ts +27 -0
  1145. package/src/providers/speech-to-text/__tests__/provider-catalog.test.ts +25 -0
  1146. package/src/providers/speech-to-text/__tests__/resolve.test.ts +195 -1
  1147. package/src/providers/speech-to-text/deepgram-realtime.test.ts +18 -6
  1148. package/src/providers/speech-to-text/deepgram-realtime.ts +9 -1
  1149. package/src/providers/speech-to-text/deepgram.ts +117 -1
  1150. package/src/providers/speech-to-text/google-gemini-live-stream.test.ts +116 -132
  1151. package/src/providers/speech-to-text/google-gemini-live-stream.ts +87 -31
  1152. package/src/providers/speech-to-text/provider-catalog.ts +17 -0
  1153. package/src/providers/speech-to-text/resolve.ts +64 -5
  1154. package/src/providers/speech-to-text/xai-realtime.test.ts +18 -6
  1155. package/src/providers/speech-to-text/xai-realtime.ts +60 -20
  1156. package/src/providers/speech-to-text/xai.test.ts +43 -0
  1157. package/src/providers/speech-to-text/xai.ts +48 -7
  1158. package/src/providers/stop-reasons.ts +3 -1
  1159. package/src/providers/thinking-config.ts +7 -1
  1160. package/src/providers/tool-progress-events.ts +15 -5
  1161. package/src/providers/usage-tracking.ts +6 -2
  1162. package/src/routes/route-host-client.ts +3 -2
  1163. package/src/routes/route-host-protocol.ts +1 -1
  1164. package/src/routes/worker.ts +3 -2
  1165. package/src/runtime/__tests__/agent-wake.test.ts +3 -1
  1166. package/src/runtime/__tests__/interactive-ui.test.ts +3 -1
  1167. package/src/runtime/__tests__/local-principal-trust.test.ts +10 -8
  1168. package/src/runtime/anchored-guardian.test.ts +45 -8
  1169. package/src/runtime/anchored-guardian.ts +4 -1
  1170. package/src/runtime/approval-conversation-turn.ts +17 -7
  1171. package/src/runtime/approval-message-composer.ts +6 -2
  1172. package/src/runtime/auth/__tests__/guard-tests.test.ts +24 -8
  1173. package/src/runtime/auth/middleware.ts +0 -2
  1174. package/src/runtime/auth/owner-caller.ts +95 -0
  1175. package/src/runtime/auth/require-bound-guardian.ts +7 -22
  1176. package/src/runtime/auth/same-actor.ts +12 -4
  1177. package/src/runtime/background-job-runner.ts +12 -4
  1178. package/src/runtime/channel-invite-transports/slack.ts +6 -2
  1179. package/src/runtime/channel-invite-transports/telegram.ts +6 -2
  1180. package/src/runtime/channel-verification-service.ts +9 -3
  1181. package/src/runtime/decision-token.ts +3 -1
  1182. package/src/runtime/guardian-action-message-composer.ts +6 -2
  1183. package/src/runtime/guardian-vellum-migration.ts +18 -6
  1184. package/src/runtime/http-router.ts +18 -6
  1185. package/src/runtime/invite-service.ts +6 -2
  1186. package/src/runtime/local-principal-trust.ts +6 -2
  1187. package/src/runtime/member-verdict-cache.ts +18 -6
  1188. package/src/runtime/middleware/__tests__/request-logger.test.ts +1 -3
  1189. package/src/runtime/middleware/auth.ts +37 -13
  1190. package/src/runtime/middleware/error-handler.ts +1 -4
  1191. package/src/runtime/middleware/rate-limiter.ts +12 -4
  1192. package/src/runtime/middleware/request-logger.ts +12 -4
  1193. package/src/runtime/migrations/__tests__/rebind-secrets-credentials.test.ts +18 -6
  1194. package/src/runtime/migrations/__tests__/vbundle-builder-credentials.test.ts +3 -1
  1195. package/src/runtime/migrations/__tests__/vbundle-import-parity.test.ts +9 -3
  1196. package/src/runtime/migrations/__tests__/vbundle-import-version-compat.test.ts +11 -4
  1197. package/src/runtime/migrations/__tests__/vbundle-streaming-importer.test.ts +84 -28
  1198. package/src/runtime/migrations/__tests__/vbundle-symlink-importer.test.ts +18 -6
  1199. package/src/runtime/migrations/__tests__/vbundle-symlink-streaming-importer.test.ts +0 -0
  1200. package/src/runtime/migrations/__tests__/vbundle-symlink-tar.test.ts +24 -8
  1201. package/src/runtime/migrations/__tests__/vbundle-tar-stream.test.ts +3 -1
  1202. package/src/runtime/migrations/__tests__/vbundle-validator-v1-schema.test.ts +6 -2
  1203. package/src/runtime/migrations/gcs-signed-url.ts +21 -7
  1204. package/src/runtime/migrations/job-registry.ts +24 -8
  1205. package/src/runtime/migrations/migration-wizard.ts +9 -3
  1206. package/src/runtime/migrations/transfer-progress-screen.ts +3 -1
  1207. package/src/runtime/migrations/validation-results-screen.ts +3 -1
  1208. package/src/runtime/migrations/vbundle-builder.ts +33 -11
  1209. package/src/runtime/migrations/vbundle-import-analyzer.ts +3 -1
  1210. package/src/runtime/migrations/vbundle-import-policy.ts +21 -7
  1211. package/src/runtime/migrations/vbundle-importer.ts +9 -3
  1212. package/src/runtime/migrations/vbundle-metadata-merge.ts +12 -4
  1213. package/src/runtime/migrations/vbundle-streaming-importer.ts +57 -19
  1214. package/src/runtime/migrations/vbundle-tar-stream.ts +15 -5
  1215. package/src/runtime/migrations/vbundle-validator.ts +6 -2
  1216. package/src/runtime/nl-approval-parser.ts +6 -3
  1217. package/src/runtime/no-response.ts +12 -4
  1218. package/src/runtime/pending-interactions.ts +9 -3
  1219. package/src/runtime/pre-first-message-gate.ts +3 -1
  1220. package/src/runtime/routes/__tests__/acp-routes.test.ts +24 -8
  1221. package/src/runtime/routes/__tests__/avatar-state-routes.test.ts +9 -3
  1222. package/src/runtime/routes/__tests__/backup-routes.test.ts +3 -1
  1223. package/src/runtime/routes/__tests__/channel-verification-revoke.test.ts +9 -3
  1224. package/src/runtime/routes/__tests__/client-routes.test.ts +3 -1
  1225. package/src/runtime/routes/__tests__/connection-routes-vs-cli-parity.test.ts +12 -4
  1226. package/src/runtime/routes/__tests__/consolidation-routes.test.ts +3 -1
  1227. package/src/runtime/routes/__tests__/contact-routes-update-channel-relay.test.ts +3 -1
  1228. package/src/runtime/routes/__tests__/contact-routes.test.ts +3 -1
  1229. package/src/runtime/routes/__tests__/content-source-routes.test.ts +3 -1
  1230. package/src/runtime/routes/__tests__/conversation-compaction-routes.test.ts +3 -1
  1231. package/src/runtime/routes/__tests__/conversation-list-routes.test.ts +3 -1
  1232. package/src/runtime/routes/__tests__/conversation-management-routes.test.ts +3 -1
  1233. package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +116 -1
  1234. package/src/runtime/routes/__tests__/conversation-surface-routes.test.ts +3 -1
  1235. package/src/runtime/routes/__tests__/default-plugin-routes.test.ts +4 -14
  1236. package/src/runtime/routes/__tests__/default-provider-routes.test.ts +4 -4
  1237. package/src/runtime/routes/__tests__/deprecated-route-context.test.ts +112 -0
  1238. package/src/runtime/routes/__tests__/gateway-log-routes.test.ts +3 -1
  1239. package/src/runtime/routes/__tests__/gateway-status-routes.test.ts +3 -1
  1240. package/src/runtime/routes/__tests__/global-search-routes.test.ts +12 -0
  1241. package/src/runtime/routes/__tests__/heartbeat-routes.test.ts +3 -1
  1242. package/src/runtime/routes/__tests__/home-feed-routes.test.ts +6 -3
  1243. package/src/runtime/routes/__tests__/inference-provider-connection-routes.test.ts +57 -4
  1244. package/src/runtime/routes/__tests__/inference-send-routes.test.ts +79 -2
  1245. package/src/runtime/routes/__tests__/invite-relay-routes.test.ts +3 -1
  1246. package/src/runtime/routes/__tests__/platform-invoice-routes.test.ts +392 -0
  1247. package/src/runtime/routes/__tests__/ps-routes.test.ts +12 -4
  1248. package/src/runtime/routes/__tests__/question-routes.test.ts +6 -2
  1249. package/src/runtime/routes/__tests__/retrospective-routes.test.ts +3 -1
  1250. package/src/runtime/routes/__tests__/sanity-routes.test.ts +6 -2
  1251. package/src/runtime/routes/__tests__/schedule-routes-create.test.ts +3 -1
  1252. package/src/runtime/routes/__tests__/slack-channel-routes.test.ts +3 -1
  1253. package/src/runtime/routes/__tests__/stt-routes.test.ts +22 -3
  1254. package/src/runtime/routes/__tests__/surface-action-routes.test.ts +9 -3
  1255. package/src/runtime/routes/__tests__/surface-content-routes.test.ts +3 -1
  1256. package/src/runtime/routes/__tests__/tts-routes.test.ts +9 -3
  1257. package/src/runtime/routes/__tests__/user-route-dispatcher-host.test.ts +3 -12
  1258. package/src/runtime/routes/__tests__/user-route-dispatcher.test.ts +26 -115
  1259. package/src/runtime/routes/__tests__/wake-conversation-routes.test.ts +3 -1
  1260. package/src/runtime/routes/acp-routes-list.test.ts +9 -3
  1261. package/src/runtime/routes/acp-routes.test.ts +18 -6
  1262. package/src/runtime/routes/app-management-routes.ts +13 -5
  1263. package/src/runtime/routes/app-routes.ts +3 -1
  1264. package/src/runtime/routes/archive-utils.ts +3 -1
  1265. package/src/runtime/routes/attachment-routes.ts +6 -2
  1266. package/src/runtime/routes/background-wake-routes.ts +12 -4
  1267. package/src/runtime/routes/backup-routes.ts +6 -2
  1268. package/src/runtime/routes/browser-routes.ts +3 -1
  1269. package/src/runtime/routes/call-routes.ts +3 -1
  1270. package/src/runtime/routes/consolidation-routes.ts +1 -1
  1271. package/src/runtime/routes/contact-prompt-routes.ts +8 -1
  1272. package/src/runtime/routes/contact-routes.ts +9 -3
  1273. package/src/runtime/routes/conversation-list-routes.ts +3 -1
  1274. package/src/runtime/routes/conversation-management-routes.ts +16 -7
  1275. package/src/runtime/routes/conversation-query-routes.ts +105 -35
  1276. package/src/runtime/routes/conversation-routes.ts +8 -5
  1277. package/src/runtime/routes/conversation-starter-routes.ts +12 -4
  1278. package/src/runtime/routes/conversations-import-routes.ts +28 -2
  1279. package/src/runtime/routes/credential-routes.ts +1 -5
  1280. package/src/runtime/routes/debug-bash-routes.ts +3 -1
  1281. package/src/runtime/routes/default-provider-routes.ts +8 -4
  1282. package/src/runtime/routes/defer-routes.ts +17 -14
  1283. package/src/runtime/routes/deprecated-route-context.ts +125 -0
  1284. package/src/runtime/routes/diagnostics-routes.ts +3 -1
  1285. package/src/runtime/routes/disk-pressure-routes.ts +12 -4
  1286. package/src/runtime/routes/email-routes.ts +18 -6
  1287. package/src/runtime/routes/errors.ts +13 -0
  1288. package/src/runtime/routes/events-routes.ts +9 -3
  1289. package/src/runtime/routes/global-search-routes.ts +28 -8
  1290. package/src/runtime/routes/group-routes.ts +47 -5
  1291. package/src/runtime/routes/guardian-action-routes.ts +2 -1
  1292. package/src/runtime/routes/heartbeat-routes.ts +12 -6
  1293. package/src/runtime/routes/home-feed-routes.ts +51 -18
  1294. package/src/runtime/routes/host-app-control-routes.ts +40 -45
  1295. package/src/runtime/routes/host-bash-routes.ts +31 -22
  1296. package/src/runtime/routes/host-browser-routes.ts +6 -3
  1297. package/src/runtime/routes/host-cu-routes.ts +26 -36
  1298. package/src/runtime/routes/host-file-routes.ts +29 -40
  1299. package/src/runtime/routes/host-transfer-routes.ts +21 -9
  1300. package/src/runtime/routes/http-adapter.ts +15 -5
  1301. package/src/runtime/routes/identity-routes.ts +15 -5
  1302. package/src/runtime/routes/inbound-stages/admission-policy.test.ts +9 -3
  1303. package/src/runtime/routes/inbound-stages/channel-turn-admission.ts +2 -2
  1304. package/src/runtime/routes/inbound-stages/guardian-activation-intercept.ts +12 -4
  1305. package/src/runtime/routes/index.ts +2 -0
  1306. package/src/runtime/routes/inference-profile-session-handler.ts +6 -2
  1307. package/src/runtime/routes/inference-profile-session-reaper.ts +6 -2
  1308. package/src/runtime/routes/inference-profiles-routes.ts +10 -5
  1309. package/src/runtime/routes/inference-provider-connection-routes.ts +36 -6
  1310. package/src/runtime/routes/inference-send-routes.ts +88 -22
  1311. package/src/runtime/routes/integrations/twilio.ts +3 -1
  1312. package/src/runtime/routes/internal-oauth-routes.ts +6 -2
  1313. package/src/runtime/routes/llm-call-sites-routes.ts +5 -2
  1314. package/src/runtime/routes/llm-context-normalization.ts +36 -12
  1315. package/src/runtime/routes/log-export/__tests__/workspace-allowlist.test.ts +12 -4
  1316. package/src/runtime/routes/log-export/workspace-allowlist.ts +33 -11
  1317. package/src/runtime/routes/log-export-routes.ts +51 -17
  1318. package/src/runtime/routes/mcp-auth-routes.ts +23 -8
  1319. package/src/runtime/routes/migration-rollback-routes.ts +4 -2
  1320. package/src/runtime/routes/migration-routes.ts +24 -8
  1321. package/src/runtime/routes/oauth-apps.ts +3 -1
  1322. package/src/runtime/routes/oauth-commands-routes.ts +66 -22
  1323. package/src/runtime/routes/oauth-connect-routes.ts +14 -5
  1324. package/src/runtime/routes/oauth-providers.ts +89 -34
  1325. package/src/runtime/routes/onboarding-checkin-routes.ts +3 -1
  1326. package/src/runtime/routes/platform-routes.ts +398 -51
  1327. package/src/runtime/routes/playground/__tests__/force-compact.test.ts +6 -2
  1328. package/src/runtime/routes/playground/__tests__/inject-failures.test.ts +9 -3
  1329. package/src/runtime/routes/playground/__tests__/reset-circuit.test.ts +3 -1
  1330. package/src/runtime/routes/playground/__tests__/seed-conversation.test.ts +3 -1
  1331. package/src/runtime/routes/playground/__tests__/seeded-conversations.test.ts +3 -1
  1332. package/src/runtime/routes/playground/__tests__/state.test.ts +3 -1
  1333. package/src/runtime/routes/playground/guard.ts +1 -2
  1334. package/src/runtime/routes/playground/helpers.ts +9 -3
  1335. package/src/runtime/routes/playground/seeded-conversations.ts +3 -1
  1336. package/src/runtime/routes/profiler-routes.ts +12 -4
  1337. package/src/runtime/routes/question-routes.ts +3 -1
  1338. package/src/runtime/routes/redact-staged-export.ts +15 -5
  1339. package/src/runtime/routes/schedule-routes.ts +135 -38
  1340. package/src/runtime/routes/sequence-routes.ts +23 -10
  1341. package/src/runtime/routes/skills-routes.ts +45 -15
  1342. package/src/runtime/routes/slack-channel-routes.ts +6 -2
  1343. package/src/runtime/routes/sounds-config-routes.ts +15 -5
  1344. package/src/runtime/routes/stt-routes.ts +12 -3
  1345. package/src/runtime/routes/subagents-routes.ts +182 -47
  1346. package/src/runtime/routes/tool-call-question-enrichment.ts +6 -2
  1347. package/src/runtime/routes/user-route-dispatcher.ts +23 -64
  1348. package/src/runtime/routes/user-routes-cli.ts +3 -1
  1349. package/src/runtime/routes/user-routes.ts +1 -10
  1350. package/src/runtime/routes/watcher-routes.ts +15 -5
  1351. package/src/runtime/routes/workflow-routes.test.ts +9 -3
  1352. package/src/runtime/routes/workflow-routes.ts +12 -4
  1353. package/src/runtime/routes/workspace-greetings.ts +12 -4
  1354. package/src/runtime/routes/workspace-routes.ts +12 -4
  1355. package/src/runtime/routes/workspace-utils.ts +6 -2
  1356. package/src/runtime/services/conversation-serializer.ts +11 -7
  1357. package/src/runtime/slack-reply-session.test.ts +3 -1
  1358. package/src/runtime/slack-reply-session.ts +42 -14
  1359. package/src/runtime/trust-verdict-consumer.ts +9 -3
  1360. package/src/runtime/verification-outbound-actions.ts +3 -1
  1361. package/src/runtime/verification-rate-limiter.ts +6 -2
  1362. package/src/schedule/__tests__/run-script.test.ts +62 -0
  1363. package/src/schedule/defer-provenance.ts +51 -0
  1364. package/src/schedule/integration-status.ts +6 -2
  1365. package/src/schedule/recurrence-engine.ts +35 -13
  1366. package/src/schedule/recurrence-types.ts +6 -2
  1367. package/src/schedule/run-script.ts +111 -21
  1368. package/src/schedule/schedule-recovery.ts +6 -2
  1369. package/src/schedule/schedule-store.ts +308 -57
  1370. package/src/schedule/scheduler.ts +9 -11
  1371. package/src/schedule/wake-schedule-options.ts +94 -0
  1372. package/src/security/AGENTS.md +14 -0
  1373. package/src/security/__tests__/oauth2-exchange-body.test.ts +1 -4
  1374. package/src/security/__tests__/provider-key-env-fallback.test.ts +6 -2
  1375. package/src/security/__tests__/untrusted-content.test.ts +21 -2
  1376. package/src/security/ces-credential-client.ts +15 -5
  1377. package/src/security/ces-rpc-credential-backend.ts +6 -2
  1378. package/src/security/credential-key.ts +6 -2
  1379. package/src/security/encrypted-store.ts +47 -18
  1380. package/src/security/oauth-callback-registry.ts +6 -2
  1381. package/src/security/oauth2-device-code.ts +7 -2
  1382. package/src/security/oauth2.ts +36 -7
  1383. package/src/security/redact-json.ts +3 -1
  1384. package/src/security/redaction.ts +3 -1
  1385. package/src/security/secret-allowlist.ts +21 -7
  1386. package/src/security/secret-ingress.ts +3 -1
  1387. package/src/security/secret-scanner.ts +23 -8
  1388. package/src/security/token-manager.ts +4 -2
  1389. package/src/security/tool-approval-digest.ts +3 -1
  1390. package/src/security/untrusted-content.ts +11 -3
  1391. package/src/sequence/analytics.ts +6 -2
  1392. package/src/sequence/guardrails.ts +6 -2
  1393. package/src/sequence/importer.ts +18 -6
  1394. package/src/sequence/reply-matcher.ts +18 -6
  1395. package/src/sequence/store.ts +40 -15
  1396. package/src/services/published-app-updater.ts +9 -3
  1397. package/src/signals/cancel.ts +3 -1
  1398. package/src/signals/conversation-undo.ts +3 -1
  1399. package/src/skills/active-skill-tools.ts +9 -3
  1400. package/src/skills/catalog-cache.ts +4 -1
  1401. package/src/skills/catalog-files.ts +93 -31
  1402. package/src/skills/catalog-install.ts +30 -10
  1403. package/src/skills/categories-cache.ts +9 -3
  1404. package/src/skills/clawhub-files.ts +21 -7
  1405. package/src/skills/clawhub.ts +18 -6
  1406. package/src/skills/frontmatter.ts +3 -1
  1407. package/src/skills/include-graph.ts +33 -11
  1408. package/src/skills/inline-command-expansions.ts +9 -3
  1409. package/src/skills/inline-command-runner.ts +6 -2
  1410. package/src/skills/install-meta.ts +17 -6
  1411. package/src/skills/managed-store.ts +3 -1
  1412. package/src/skills/remote-skill-policy.ts +6 -2
  1413. package/src/skills/skill-cache-store.ts +6 -2
  1414. package/src/skills/skillssh-files.ts +42 -14
  1415. package/src/skills/skillssh-registry.ts +18 -6
  1416. package/src/skills/validate-input.ts +60 -20
  1417. package/src/skills/version-hash.ts +6 -2
  1418. package/src/stt/__tests__/daemon-batch-transcriber.test.ts +136 -2
  1419. package/src/stt/daemon-batch-transcriber.ts +39 -22
  1420. package/src/subagent/__tests__/consult-context-gating.test.ts +98 -0
  1421. package/src/subagent/__tests__/consult-context-skills.test.ts +82 -0
  1422. package/src/subagent/__tests__/consult-context.test.ts +78 -0
  1423. package/src/subagent/__tests__/consult-prompt.test.ts +36 -0
  1424. package/src/subagent/consult-context.ts +410 -0
  1425. package/src/subagent/consult-prompt.ts +39 -4
  1426. package/src/subagent/consult-transcript.ts +6 -2
  1427. package/src/subagent/index.ts +11 -2
  1428. package/src/subagent/manager.ts +171 -51
  1429. package/src/subagent/types.ts +75 -0
  1430. package/src/subagent/validate-allowlists.ts +6 -2
  1431. package/src/telemetry/tool-usage-store.ts +6 -2
  1432. package/src/telemetry/watchdog-direct-emit.ts +6 -2
  1433. package/src/telemetry/watchdog-events-store.ts +6 -3
  1434. package/src/tools/background-tool-registry.ts +6 -2
  1435. package/src/tools/browser/__tests__/auth-detector.test.ts +20 -0
  1436. package/src/tools/browser/__tests__/browser-untrusted-content.test.ts +512 -0
  1437. package/src/tools/browser/auth-cache.ts +6 -2
  1438. package/src/tools/browser/auth-detector.ts +24 -6
  1439. package/src/tools/browser/browser-execution.ts +245 -47
  1440. package/src/tools/browser/browser-manager.ts +66 -24
  1441. package/src/tools/browser/browser-screencast.ts +6 -2
  1442. package/src/tools/browser/cdp-client/__tests__/accessibility-snapshot.test.ts +27 -0
  1443. package/src/tools/browser/cdp-client/__tests__/browser-tabs-factory.test.ts +75 -27
  1444. package/src/tools/browser/cdp-client/__tests__/cdp-dom-helpers.test.ts +39 -14
  1445. package/src/tools/browser/cdp-client/__tests__/cdp-inspect-client.test.ts +9 -3
  1446. package/src/tools/browser/cdp-client/__tests__/types.test.ts +4 -1
  1447. package/src/tools/browser/cdp-client/accessibility-snapshot.ts +67 -19
  1448. package/src/tools/browser/cdp-client/cdp-dom-helpers.ts +15 -5
  1449. package/src/tools/browser/cdp-client/cdp-inspect/__tests__/ws-transport.test.ts +9 -3
  1450. package/src/tools/browser/cdp-client/cdp-inspect/discovery.ts +33 -11
  1451. package/src/tools/browser/cdp-client/cdp-inspect/ws-transport.ts +42 -14
  1452. package/src/tools/browser/cdp-client/cdp-inspect-client.ts +36 -11
  1453. package/src/tools/browser/cdp-client/extension-cdp-client.ts +9 -3
  1454. package/src/tools/browser/cdp-client/factory.ts +45 -27
  1455. package/src/tools/browser/cdp-client/local-cdp-client.ts +21 -6
  1456. package/src/tools/browser/cdp-client/types.ts +5 -1
  1457. package/src/tools/browser/network-recorder.ts +45 -15
  1458. package/src/tools/browser/pinned-tabs.ts +28 -9
  1459. package/src/tools/browser/runtime-check.ts +21 -7
  1460. package/src/tools/credentials/broker.ts +3 -1
  1461. package/src/tools/credentials/domain-policy.ts +12 -4
  1462. package/src/tools/credentials/host-pattern-match.ts +3 -1
  1463. package/src/tools/credentials/post-connect-hooks.ts +6 -2
  1464. package/src/tools/credentials/resolve.ts +21 -7
  1465. package/src/tools/credentials/selection.ts +15 -5
  1466. package/src/tools/credentials/tool-policy.ts +6 -2
  1467. package/src/tools/execution-target.ts +3 -1
  1468. package/src/tools/filesystem/fuzzy-match.ts +54 -18
  1469. package/src/tools/filesystem/search.ts +34 -12
  1470. package/src/tools/filesystem/write.ts +12 -4
  1471. package/src/tools/network/__tests__/web-search-metadata.test.ts +9 -3
  1472. package/src/tools/network/__tests__/web-search.test.ts +111 -4
  1473. package/src/tools/network/domain-normalize.ts +12 -4
  1474. package/src/tools/network/managed-search-proxy.ts +24 -8
  1475. package/src/tools/network/script-proxy/session-manager.ts +39 -13
  1476. package/src/tools/network/url-safety.ts +63 -21
  1477. package/src/tools/network/web-fetch.ts +62 -21
  1478. package/src/tools/network/web-search-error.ts +30 -13
  1479. package/src/tools/network/web-search.ts +237 -10
  1480. package/src/tools/schedule/create.ts +18 -0
  1481. package/src/tools/schedule/update.ts +19 -2
  1482. package/src/tools/sensitive-output-placeholders.ts +15 -5
  1483. package/src/tools/shared/filesystem/file-ops-service.ts +6 -2
  1484. package/src/tools/shared/filesystem/image-read.ts +3 -1
  1485. package/src/tools/shared/filesystem/size-guard.ts +6 -2
  1486. package/src/tools/skills/execute.ts +24 -8
  1487. package/src/tools/skills/find-similar-skills.ts +6 -2
  1488. package/src/tools/skills/load.ts +25 -9
  1489. package/src/tools/skills/sandbox-runner.ts +6 -2
  1490. package/src/tools/subagent/read.ts +7 -4
  1491. package/src/tools/subagent/resolve.ts +73 -3
  1492. package/src/tools/subagent/spawn.ts +23 -1
  1493. package/src/tools/subagent/status.ts +66 -5
  1494. package/src/tools/tool-input-summary.ts +3 -1
  1495. package/src/tools/tool-name-aliases.ts +3 -1
  1496. package/src/tools/ui-surface/definitions.ts +39 -1
  1497. package/src/tools/ui-surface/surface-shape-docs.ts +38 -4
  1498. package/src/tools/ui-surface/visual-validation.ts +787 -0
  1499. package/src/tools/verification-control-plane-policy.ts +12 -4
  1500. package/src/tools/workflows/manage-workflows.ts +5 -2
  1501. package/src/tts/__tests__/provider-adapters.test.ts +9 -3
  1502. package/src/tts/__tests__/speakable-segments.test.ts +4 -4
  1503. package/src/tts/providers/__tests__/xai-tts-socket.test.ts +26 -12
  1504. package/src/tts/providers/deepgram-provider.ts +3 -1
  1505. package/src/tts/providers/elevenlabs-provider.ts +9 -3
  1506. package/src/tts/providers/fish-audio-provider.ts +3 -1
  1507. package/src/tts/providers/xai-provider.ts +3 -1
  1508. package/src/tts/providers/xai-tts-socket.ts +36 -11
  1509. package/src/tts/synthesize-text.ts +3 -1
  1510. package/src/usage/pricing.ts +27 -9
  1511. package/src/util/abort-reasons.ts +3 -1
  1512. package/src/util/bun-runtime.ts +9 -3
  1513. package/src/util/bundled-asset.ts +6 -2
  1514. package/src/util/canonicalize-identity.ts +3 -1
  1515. package/src/util/cgroup-memory.ts +12 -4
  1516. package/src/util/debounce.ts +11 -4
  1517. package/src/util/diff.ts +18 -6
  1518. package/src/util/disk-usage.ts +15 -5
  1519. package/src/util/errors.ts +1 -0
  1520. package/src/util/favicon.ts +9 -3
  1521. package/src/util/fs.ts +3 -1
  1522. package/src/util/image-conversion.ts +15 -5
  1523. package/src/util/log-redact.ts +6 -2
  1524. package/src/util/logger.ts +15 -5
  1525. package/src/util/phone.ts +6 -2
  1526. package/src/util/platform.ts +18 -6
  1527. package/src/util/pricing.ts +30 -10
  1528. package/src/util/process-liveness.ts +6 -2
  1529. package/src/util/process-tree.ts +19 -0
  1530. package/src/util/promise-guard.ts +3 -1
  1531. package/src/util/retry.ts +21 -7
  1532. package/src/util/row-mapper.ts +6 -2
  1533. package/src/util/spinner.ts +6 -2
  1534. package/src/util/strip-comment-lines.ts +3 -1
  1535. package/src/util/time.ts +18 -6
  1536. package/src/util/truncate.ts +6 -2
  1537. package/src/util/unicode.ts +9 -3
  1538. package/src/util/xml.ts +1 -4
  1539. package/src/version.ts +9 -3
  1540. package/src/watcher/__tests__/engine.test.ts +331 -4
  1541. package/src/watcher/__tests__/payload-bounds.test.ts +414 -0
  1542. package/src/watcher/constants.ts +69 -0
  1543. package/src/watcher/engine.ts +135 -25
  1544. package/src/watcher/payload-bounds.ts +443 -0
  1545. package/src/watcher/provider-types.ts +13 -0
  1546. package/src/watcher/providers/github.ts +18 -6
  1547. package/src/watcher/providers/gmail.ts +1 -0
  1548. package/src/watcher/providers/google-calendar.ts +36 -16
  1549. package/src/watcher/providers/linear.ts +16 -5
  1550. package/src/watcher/providers/outlook-calendar.ts +4 -1
  1551. package/src/watcher/providers/outlook.ts +1 -0
  1552. package/src/watcher/telemetry.ts +3 -1
  1553. package/src/watcher/watcher-store.ts +32 -12
  1554. package/src/workflows/deterministic-stringify.ts +6 -2
  1555. package/src/workflows/engine-integration.test.ts +3 -1
  1556. package/src/workflows/engine.test.ts +17 -6
  1557. package/src/workflows/engine.ts +88 -32
  1558. package/src/workflows/journal-store.ts +3 -1
  1559. package/src/workflows/leaf-runner.ts +9 -2
  1560. package/src/workflows/library.test.ts +5 -2
  1561. package/src/workflows/library.ts +15 -5
  1562. package/src/workflows/run-manager.test.ts +9 -3
  1563. package/src/workflows/run-manager.ts +18 -6
  1564. package/src/workflows/sandbox.ts +6 -2
  1565. package/src/workspace/adaptive-thinking-repair.ts +33 -11
  1566. package/src/workspace/byok-default-profile-ensure.ts +627 -0
  1567. package/src/workspace/commit-message-enrichment-service.ts +15 -5
  1568. package/src/workspace/custom-profile-ensure.ts +26 -15
  1569. package/src/workspace/default-provider-ensure.ts +11 -10
  1570. package/src/workspace/git-service.ts +12 -4
  1571. package/src/workspace/hatched-date.ts +12 -4
  1572. package/src/workspace/heartbeat-service.ts +3 -1
  1573. package/src/workspace/migrations/003-seed-device-id.ts +12 -4
  1574. package/src/workspace/migrations/004-extract-collect-usage-data.ts +27 -9
  1575. package/src/workspace/migrations/006-services-config.ts +17 -6
  1576. package/src/workspace/migrations/007-web-search-provider-rename.ts +34 -10
  1577. package/src/workspace/migrations/010-app-dir-rename.ts +21 -7
  1578. package/src/workspace/migrations/012-rename-conversation-disk-view-dirs.ts +30 -10
  1579. package/src/workspace/migrations/016-extract-feature-flags-to-protected.ts +12 -4
  1580. package/src/workspace/migrations/017-seed-persona-dirs.ts +15 -5
  1581. package/src/workspace/migrations/018-rekey-compound-credential-keys.ts +30 -10
  1582. package/src/workspace/migrations/019-scope-journal-to-guardian.ts +18 -6
  1583. package/src/workspace/migrations/020-rename-oauth-skill-dirs.ts +6 -2
  1584. package/src/workspace/migrations/021-move-signals-to-workspace.ts +6 -2
  1585. package/src/workspace/migrations/022-move-hooks-to-workspace.ts +6 -2
  1586. package/src/workspace/migrations/023-move-config-files-to-workspace.ts +6 -2
  1587. package/src/workspace/migrations/024-move-runtime-files-to-workspace.ts +6 -2
  1588. package/src/workspace/migrations/025-remove-oauth-app-setup-skills.ts +3 -1
  1589. package/src/workspace/migrations/026-backfill-install-meta.ts +27 -9
  1590. package/src/workspace/migrations/028-recover-conversations-from-disk-view.ts +9 -3
  1591. package/src/workspace/migrations/029-seed-pkb.ts +3 -1
  1592. package/src/workspace/migrations/030-seed-pkb-autoinject.ts +6 -2
  1593. package/src/workspace/migrations/031-drop-user-md.ts +25 -10
  1594. package/src/workspace/migrations/031-llm-log-retention-zero-to-null.ts +28 -10
  1595. package/src/workspace/migrations/032-tts-provider-unification.ts +33 -11
  1596. package/src/workspace/migrations/033-stt-service-explicit-config.ts +12 -4
  1597. package/src/workspace/migrations/034-remove-calls-voice-transcription-provider.ts +24 -8
  1598. package/src/workspace/migrations/036-update-pkb-index-bar.ts +6 -2
  1599. package/src/workspace/migrations/037-create-meets-dir.ts +3 -1
  1600. package/src/workspace/migrations/038-unify-llm-callsite-configs.ts +27 -9
  1601. package/src/workspace/migrations/039-drop-legacy-llm-keys.ts +9 -3
  1602. package/src/workspace/migrations/040-seed-latency-callsite-defaults.ts +15 -5
  1603. package/src/workspace/migrations/041-backfill-google-gmail-settings-scope.ts +9 -3
  1604. package/src/workspace/migrations/042-fix-backfill-google-gmail-settings-scope.ts +9 -3
  1605. package/src/workspace/migrations/044-bump-stale-provider-stream-timeout.ts +11 -4
  1606. package/src/workspace/migrations/046-seed-conversation-starters-callsite.ts +12 -4
  1607. package/src/workspace/migrations/047-remove-watch-callsites.ts +18 -5
  1608. package/src/workspace/migrations/050-seed-main-agent-opus-callsite.ts +9 -3
  1609. package/src/workspace/migrations/051-seed-conversation-summarization-callsite.ts +12 -4
  1610. package/src/workspace/migrations/052-seed-default-inference-profiles.ts +12 -4
  1611. package/src/workspace/migrations/054-seed-recall-callsite.ts +12 -4
  1612. package/src/workspace/migrations/057-repair-stale-gemini-model-ids.ts +39 -13
  1613. package/src/workspace/migrations/059-move-pid-to-workspace.ts +6 -2
  1614. package/src/workspace/migrations/061-move-backup-key-to-workspace.ts +6 -2
  1615. package/src/workspace/migrations/064-unwind-main-agent-opus-seed.ts +21 -7
  1616. package/src/workspace/migrations/065-bump-stale-heartbeat-interval.ts +12 -3
  1617. package/src/workspace/migrations/066-seed-heartbeat-callsite-cost-default.ts +18 -6
  1618. package/src/workspace/migrations/069-seed-onboarding-threads.ts +9 -3
  1619. package/src/workspace/migrations/072-seed-reply-suggestion-callsite.ts +12 -4
  1620. package/src/workspace/migrations/073-repair-recall-callsite-empty-profile.ts +21 -7
  1621. package/src/workspace/migrations/074-drop-deprecated-secret-detection-keys.ts +12 -4
  1622. package/src/workspace/migrations/075-memory-v2-bm25-b-default-reembed.ts +9 -3
  1623. package/src/workspace/migrations/076-drop-services-inference-mode.ts +13 -5
  1624. package/src/workspace/migrations/077-seed-memory-router-callsite.ts +9 -3
  1625. package/src/workspace/migrations/079-home-feed-notification-only.ts +21 -7
  1626. package/src/workspace/migrations/080-restrict-vercel-api-token-metadata.ts +3 -1
  1627. package/src/workspace/migrations/081-backfill-bash-allowed-tools-for-injection-credentials.ts +9 -3
  1628. package/src/workspace/migrations/082-backfill-managed-profile-labels.ts +15 -5
  1629. package/src/workspace/migrations/083-system-prompt-prefix-to-file.ts +8 -3
  1630. package/src/workspace/migrations/084-remove-legacy-skills-index.ts +42 -14
  1631. package/src/workspace/migrations/085-memory-v2-bm25-b-reembed-disabled-v2-pages.ts +12 -4
  1632. package/src/workspace/migrations/086-revert-stale-gemini-mis-rewrites.ts +33 -11
  1633. package/src/workspace/migrations/087-memory-router-balanced-profile.ts +15 -5
  1634. package/src/workspace/migrations/088-deprecate-background-conversation-override.ts +9 -3
  1635. package/src/workspace/migrations/089-move-memory-tree-out-of-v3.ts +6 -2
  1636. package/src/workspace/migrations/090-memory-router-cost-optimized-profile.ts +21 -7
  1637. package/src/workspace/migrations/091-retighten-migration-onboarding-thread.ts +9 -3
  1638. package/src/workspace/migrations/092-backfill-v3-leaves.ts +30 -10
  1639. package/src/workspace/migrations/093-backfill-leaf-ids.ts +15 -5
  1640. package/src/workspace/migrations/094-seed-avatar-manifest.ts +9 -3
  1641. package/src/workspace/migrations/095-bump-heartbeat-interval-30m-to-60m.ts +12 -3
  1642. package/src/workspace/migrations/096-reduce-quality-profile-effort.ts +18 -6
  1643. package/src/workspace/migrations/097-enable-adaptive-thinking-managed-profiles.ts +27 -9
  1644. package/src/workspace/migrations/099-disable-cache-one-shot-callsites.ts +24 -8
  1645. package/src/workspace/migrations/100-upgrade-quality-profile-to-fable-5.ts +21 -7
  1646. package/src/workspace/migrations/101-upgrade-balanced-economy-to-minimax-m3.ts +15 -5
  1647. package/src/workspace/migrations/102-preserve-heartbeat-enabled-for-existing-workspaces.ts +9 -3
  1648. package/src/workspace/migrations/103-upgrade-quality-profile-to-opus-4-8.ts +21 -7
  1649. package/src/workspace/migrations/104-recheck-adaptive-thinking-model-implied-anthropic.ts +27 -9
  1650. package/src/workspace/migrations/105-enable-memory-v3-live-for-new-workspaces.ts +21 -7
  1651. package/src/workspace/migrations/106-drop-collect-usage-data.ts +9 -3
  1652. package/src/workspace/migrations/107-drop-send-diagnostics.ts +9 -3
  1653. package/src/workspace/migrations/108-drop-balanced-economy-profile.ts +18 -6
  1654. package/src/workspace/migrations/109-swap-quality-profile-to-glm-5p2.ts +9 -3
  1655. package/src/workspace/migrations/110-flip-balanced-profile-to-together.ts +12 -4
  1656. package/src/workspace/migrations/111-prune-seeded-callsite-defaults.ts +36 -12
  1657. package/src/workspace/migrations/112-remove-advisor-callsite-override.ts +18 -5
  1658. package/src/workspace/migrations/113-swap-balanced-profile-to-glm-5p2.ts +18 -6
  1659. package/src/workspace/migrations/114-swap-quality-profile-to-opus.ts +12 -4
  1660. package/src/workspace/migrations/115-drop-frontier-profile.ts +18 -6
  1661. package/src/workspace/migrations/117-normalize-stale-lean-memory-v3-defaults.ts +15 -5
  1662. package/src/workspace/migrations/118-seed-now-md.ts +3 -1
  1663. package/src/workspace/migrations/119-strip-persisted-memory-v3-tuning-defaults.ts +18 -6
  1664. package/src/workspace/migrations/120-revise-onboarding-threads.ts +9 -3
  1665. package/src/workspace/migrations/121-seed-default-user-guardrails.ts +3 -1
  1666. package/src/workspace/migrations/123-swap-quality-profile-to-fable.ts +24 -8
  1667. package/src/workspace/migrations/125-repoint-managed-connections-to-vellum.ts +21 -7
  1668. package/src/workspace/migrations/126-strip-managed-profile-bodies.ts +21 -7
  1669. package/src/workspace/migrations/129-remove-analyze-conversation-config.ts +9 -3
  1670. package/src/workspace/migrations/130-speech-mode-to-provider.ts +24 -8
  1671. package/src/workspace/migrations/131-drop-web-fetch-mode.ts +13 -5
  1672. package/src/workspace/migrations/133-collapse-provider-connections.ts +30 -10
  1673. package/src/workspace/migrations/136-repair-stale-fireworks-kimi-model-id.ts +127 -0
  1674. package/src/workspace/migrations/137-repair-retired-fireworks-minimax-model-id.ts +131 -0
  1675. package/src/workspace/migrations/__tests__/backfill-leaf-ids.test.ts +3 -1
  1676. package/src/workspace/migrations/migrate-to-workspace-volume.ts +9 -3
  1677. package/src/workspace/migrations/rebuild-conversation-disk-view.ts +23 -8
  1678. package/src/workspace/migrations/registry.ts +4 -0
  1679. package/src/workspace/migrations/utils.ts +3 -1
  1680. package/src/workspace/top-level-renderer.ts +3 -1
  1681. package/src/__tests__/history-repair-hook.test.ts +0 -392
  1682. package/src/daemon/__tests__/route-conversation-post.test.ts +0 -158
  1683. package/src/daemon/route-conversation-post.ts +0 -158
  1684. package/src/plugins/defaults/history-repair/hooks/post-model-call.ts +0 -50
  1685. package/src/plugins/defaults/history-repair/hooks/stop.ts +0 -22
  1686. package/src/plugins/defaults/history-repair/hooks/user-prompt-submit.ts +0 -35
  1687. package/src/plugins/defaults/history-repair/package.json +0 -14
  1688. package/src/plugins/defaults/history-repair/repair-state-store.ts +0 -51
  1689. package/src/plugins/defaults/memory/substrate/constants.ts +0 -8
@@ -7,6 +7,7 @@ import {
7
7
  CODE_DEFAULT_PROFILE_ENTRIES,
8
8
  getEffectiveProfile,
9
9
  getEffectiveProfiles,
10
+ PROFILE_IMPLS,
10
11
  resolveDefaultProfileForProvider,
11
12
  } from "../default-profile-catalog.js";
12
13
  import {
@@ -19,6 +20,7 @@ import {
19
20
  resolveDefaultProfileKey,
20
21
  } from "../llm-resolver.js";
21
22
  import {
23
+ type DefaultProviderConfig,
22
24
  type LLMCallSite,
23
25
  LLMSchema,
24
26
  type ProfileEntry,
@@ -53,6 +55,15 @@ describe("getEffectiveProfiles", () => {
53
55
  }
54
56
  });
55
57
 
58
+ test("the managed Balanced profile routes GPT-5.6 Luna through OpenAI", () => {
59
+ const balanced = CODE_DEFAULT_PROFILE_ENTRIES.balanced;
60
+ expect(balanced.model).toBe("gpt-5.6-luna");
61
+ expect(resolveRoutingIdentity(balanced.provider, balanced.model)).toEqual({
62
+ connectionName: "vellum",
63
+ expectedProvider: "openai",
64
+ });
65
+ });
66
+
56
67
  test("the managed Quality profile routes GPT-5.6 Sol through OpenAI", () => {
57
68
  const quality = CODE_DEFAULT_PROFILE_ENTRIES["quality-optimized"];
58
69
  expect(quality.model).toBe("gpt-5.6-sol");
@@ -281,11 +292,25 @@ describe("schema validation", () => {
281
292
  LLMSchema.parse({ callSites: { mainAgent: { profile: "no-such" } } }),
282
293
  ).toThrow();
283
294
  });
295
+
296
+ test("defaultProvider accepts any default-capable API-key provider and drops the rest", () => {
297
+ expect(
298
+ LLMSchema.parse({ defaultProvider: { provider: "together" } })
299
+ .defaultProvider,
300
+ ).toEqual({ provider: "together" });
301
+ // Endpoint-supplied and keyless providers have no code-resolvable
302
+ // default profile implementation; the catch drops them atomically.
303
+ for (const provider of ["litellm", "openai-compatible", "ollama"]) {
304
+ expect(
305
+ LLMSchema.parse({ defaultProvider: { provider } }).defaultProvider,
306
+ ).toBeUndefined();
307
+ }
308
+ });
284
309
  });
285
310
 
286
311
  describe("resolveDefaultProfileForProvider", () => {
287
312
  const dp = (
288
- provider: (typeof DEFAULT_PROFILE_PROVIDERS)[number],
313
+ provider: DefaultProviderConfig["provider"],
289
314
  connectionName?: string,
290
315
  ) => ({ provider, ...(connectionName ? { connectionName } : {}) });
291
316
 
@@ -311,6 +336,49 @@ describe("resolveDefaultProfileForProvider", () => {
311
336
  }
312
337
  });
313
338
 
339
+ test("a provider without a named matrix column materializes from the shared BYOK templates", () => {
340
+ const entry = resolveDefaultProfileForProvider(
341
+ undefined,
342
+ "balanced",
343
+ dp("together"),
344
+ );
345
+ expect(entry?.provider).toBe("together");
346
+ expect(entry?.provider_connection).toBe("together-personal");
347
+ // No intent table for `together`: the intent falls back to the
348
+ // provider's catalog defaultModel.
349
+ expect(entry?.model).toBe(resolveModelIntent("together", "balanced"));
350
+ expect(entry?.source).toBe("managed");
351
+ });
352
+
353
+ test("maxTokens clamps to the resolved model's catalog output cap", () => {
354
+ // atlascloud has no intent table: every intent resolves to its catalog
355
+ // defaultModel, which caps output at 8192, below the balanced template's
356
+ // 16000.
357
+ const balanced = resolveDefaultProfileForProvider(
358
+ undefined,
359
+ "balanced",
360
+ dp("atlascloud"),
361
+ );
362
+ expect(balanced?.maxTokens).toBe(8192);
363
+ // minimax's defaultModel caps output at 16384, below the quality
364
+ // template's 32000.
365
+ const quality = resolveDefaultProfileForProvider(
366
+ undefined,
367
+ "quality-optimized",
368
+ dp("minimax"),
369
+ );
370
+ expect(quality?.maxTokens).toBe(16384);
371
+ });
372
+
373
+ test("maxTokens stays at the template value when the model's cap allows it", () => {
374
+ const entry = resolveDefaultProfileForProvider(
375
+ undefined,
376
+ "balanced",
377
+ dp("anthropic"),
378
+ );
379
+ expect(entry?.maxTokens).toBe(PROFILE_IMPLS.balanced.anthropic.maxTokens);
380
+ });
381
+
314
382
  test("BYOK columns resolve the intent to a provider-specific model and personal connection", () => {
315
383
  const entry = resolveDefaultProfileForProvider(
316
384
  undefined,
@@ -32,7 +32,9 @@ function ensureTestDir(): void {
32
32
  join(WORKSPACE_DIR, "data", "logs"),
33
33
  ];
34
34
  for (const dir of dirs) {
35
- if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
35
+ if (!existsSync(dir)) {
36
+ mkdirSync(dir, { recursive: true });
37
+ }
36
38
  }
37
39
  }
38
40
 
@@ -132,7 +134,9 @@ describe("deployment-context embedding-provider default (via loadConfig)", () =>
132
134
  test("first launch (no config.json) persists managed service modes but not the platform embedding provider", () => {
133
135
  // No config.json on disk: this is the first-launch SEED path that writes a
134
136
  // default config so the file exists for users to edit.
135
- if (existsSync(CONFIG_PATH)) rmSync(CONFIG_PATH, { force: true });
137
+ if (existsSync(CONFIG_PATH)) {
138
+ rmSync(CONFIG_PATH, { force: true });
139
+ }
136
140
  process.env.IS_PLATFORM = "true";
137
141
 
138
142
  const config = loadConfig();
@@ -218,7 +222,9 @@ describe("deployment-context embedding-provider default (via loadConfig)", () =>
218
222
  });
219
223
 
220
224
  test("first launch seeds memory.v3 with only `live` — tuning knobs resolve from the schema, not disk", () => {
221
- if (existsSync(CONFIG_PATH)) rmSync(CONFIG_PATH, { force: true });
225
+ if (existsSync(CONFIG_PATH)) {
226
+ rmSync(CONFIG_PATH, { force: true });
227
+ }
222
228
  delete process.env.IS_PLATFORM;
223
229
 
224
230
  const config = loadConfig();
@@ -85,8 +85,13 @@ describe("unified feature flag registry guard", () => {
85
85
  ) {
86
86
  violations.push(`${prefix}: missing or non-string 'description'`);
87
87
  }
88
- if (typeof flag.defaultEnabled !== "boolean" && typeof flag.defaultEnabled !== "string") {
89
- violations.push(`${prefix}: missing or invalid 'defaultEnabled' (expected boolean or string)`);
88
+ if (
89
+ typeof flag.defaultEnabled !== "boolean" &&
90
+ typeof flag.defaultEnabled !== "string"
91
+ ) {
92
+ violations.push(
93
+ `${prefix}: missing or invalid 'defaultEnabled' (expected boolean or string)`,
94
+ );
90
95
  }
91
96
  }
92
97
 
@@ -21,7 +21,9 @@ function ensureTestDir(): void {
21
21
  join(WORKSPACE_DIR, "data", "logs"),
22
22
  ];
23
23
  for (const dir of dirs) {
24
- if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
24
+ if (!existsSync(dir)) {
25
+ mkdirSync(dir, { recursive: true });
26
+ }
25
27
  }
26
28
  }
27
29
 
@@ -60,14 +62,18 @@ function baseLlm(callSites: Record<string, unknown>): unknown {
60
62
  describe("config recovery prunes call-site overrides emptied by a strip", () => {
61
63
  beforeEach(() => {
62
64
  ensureTestDir();
63
- if (existsSync(CONFIG_PATH)) rmSync(CONFIG_PATH, { force: true });
65
+ if (existsSync(CONFIG_PATH)) {
66
+ rmSync(CONFIG_PATH, { force: true });
67
+ }
64
68
  delete process.env.IS_PLATFORM;
65
69
  invalidateConfigCache();
66
70
  });
67
71
 
68
72
  afterEach(() => {
69
73
  delete process.env.IS_PLATFORM;
70
- if (existsSync(CONFIG_PATH)) rmSync(CONFIG_PATH, { force: true });
74
+ if (existsSync(CONFIG_PATH)) {
75
+ rmSync(CONFIG_PATH, { force: true });
76
+ }
71
77
  invalidateConfigCache();
72
78
  });
73
79
 
@@ -40,7 +40,9 @@ function writePlugin(
40
40
  );
41
41
  }
42
42
 
43
- if (opts.disabled) writeFileSync(join(pluginDir, ".disabled"), "");
43
+ if (opts.disabled) {
44
+ writeFileSync(join(pluginDir, ".disabled"), "");
45
+ }
44
46
 
45
47
  for (const skill of skills) {
46
48
  const skillDir = join(pluginDir, "skills", skill.id);
@@ -59,8 +61,9 @@ function skillById(id: string) {
59
61
  describe("discoverPluginResidentSkills (via loadSkillCatalog)", () => {
60
62
  beforeEach(() => {
61
63
  const pluginsDir = getWorkspacePluginsDir();
62
- if (existsSync(pluginsDir))
64
+ if (existsSync(pluginsDir)) {
63
65
  rmSync(pluginsDir, { recursive: true, force: true });
66
+ }
64
67
  });
65
68
 
66
69
  test("surfaces a plugin skill when the install dir name differs from package.json name", () => {
@@ -108,6 +108,22 @@ describe("seedInferenceProfiles / llm.defaultProvider", () => {
108
108
  expect(llm.defaultProvider).toEqual({ provider: "openai" });
109
109
  });
110
110
 
111
+ test("BYOK hatch with a non-matrix API-key provider writes that provider", () => {
112
+ const llm = seed(
113
+ { llm: { default: { provider: "together" } } },
114
+ { isHatch: true },
115
+ );
116
+ expect(llm.defaultProvider).toEqual({ provider: "together" });
117
+ });
118
+
119
+ test("BYOK hatch with an endpoint-supplied provider falls back to anthropic", () => {
120
+ const llm = seed(
121
+ { llm: { default: { provider: "litellm" } } },
122
+ { isHatch: true },
123
+ );
124
+ expect(llm.defaultProvider).toEqual({ provider: "anthropic" });
125
+ });
126
+
111
127
  test("BYOK hatch with provider ollama falls back to anthropic", () => {
112
128
  const llm = seed(
113
129
  { llm: { default: { provider: "ollama" } } },
@@ -27,7 +27,9 @@ function ensureTestDir(): void {
27
27
  join(WORKSPACE_DIR, "data", "logs"),
28
28
  ];
29
29
  for (const dir of dirs) {
30
- if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
30
+ if (!existsSync(dir)) {
31
+ mkdirSync(dir, { recursive: true });
32
+ }
31
33
  }
32
34
  }
33
35
 
@@ -68,7 +70,9 @@ function seedBalancedConfig(): void {
68
70
  describe("reconcileFlagGatedProfiles", () => {
69
71
  beforeEach(() => {
70
72
  ensureTestDir();
71
- if (existsSync(CONFIG_PATH)) rmSync(CONFIG_PATH, { force: true });
73
+ if (existsSync(CONFIG_PATH)) {
74
+ rmSync(CONFIG_PATH, { force: true });
75
+ }
72
76
  delete process.env.IS_PLATFORM;
73
77
  setOverridesForTesting({});
74
78
  invalidateConfigCache();
@@ -49,7 +49,9 @@ let cachedDefaults: FeatureFlagDefaultsRegistry | undefined;
49
49
  const REGISTRY_FILENAME = "feature-flag-registry.json";
50
50
 
51
51
  function loadDefaultsRegistry(): FeatureFlagDefaultsRegistry {
52
- if (cachedDefaults) return cachedDefaults;
52
+ if (cachedDefaults) {
53
+ return cachedDefaults;
54
+ }
53
55
 
54
56
  const thisDir = import.meta.dirname ?? __dirname;
55
57
  const candidates = [
@@ -92,22 +94,33 @@ function loadDefaultsRegistry(): FeatureFlagDefaultsRegistry {
92
94
  * filtering to flags the backend consumes (`assistant`- and `both`-scope).
93
95
  */
94
96
  function parseRegistryToDefaults(parsed: unknown): FeatureFlagDefaultsRegistry {
95
- if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
97
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
98
+ return {};
99
+ }
96
100
 
97
101
  const registry = parsed as { version?: number; flags?: unknown[] };
98
- if (!Array.isArray(registry.flags)) return {};
102
+ if (!Array.isArray(registry.flags)) {
103
+ return {};
104
+ }
99
105
 
100
106
  const result: FeatureFlagDefaultsRegistry = {};
101
107
  for (const flag of registry.flags) {
102
- if (!flag || typeof flag !== "object" || Array.isArray(flag)) continue;
108
+ if (!flag || typeof flag !== "object" || Array.isArray(flag)) {
109
+ continue;
110
+ }
103
111
  const entry = flag as Record<string, unknown>;
104
- if (entry.scope !== "assistant" && entry.scope !== "both") continue;
105
- if (typeof entry.key !== "string") continue;
112
+ if (entry.scope !== "assistant" && entry.scope !== "both") {
113
+ continue;
114
+ }
115
+ if (typeof entry.key !== "string") {
116
+ continue;
117
+ }
106
118
  if (
107
119
  typeof entry.defaultEnabled !== "boolean" &&
108
120
  typeof entry.defaultEnabled !== "string"
109
- )
121
+ ) {
110
122
  continue;
123
+ }
111
124
 
112
125
  result[entry.key as string] = {
113
126
  defaultEnabled: entry.defaultEnabled,
@@ -199,7 +212,9 @@ export async function initFeatureFlagOverrides(options?: {
199
212
  */
200
213
  callTimeoutMs?: number;
201
214
  }): Promise<boolean> {
202
- if (isCachedFromGateway()) return true;
215
+ if (isCachedFromGateway()) {
216
+ return true;
217
+ }
203
218
 
204
219
  const backoffs = options?.retryBackoffsMs ?? DEFAULT_INIT_RETRY_BACKOFFS_MS;
205
220
  const callTimeoutMs = options?.callTimeoutMs;
@@ -215,7 +230,9 @@ export async function initFeatureFlagOverrides(options?: {
215
230
  // Re-check after the wait: a concurrent caller (e.g. a test using
216
231
  // `setOverridesForTesting`) may have populated the cache while we
217
232
  // were sleeping. Bail out so we don't clobber their setup.
218
- if (isCachedFromGateway()) return true;
233
+ if (isCachedFromGateway()) {
234
+ return true;
235
+ }
219
236
  }
220
237
 
221
238
  const gatewayOverrides = await fetchOverridesFromGateway(callTimeoutMs);
@@ -296,19 +313,28 @@ export async function refreshOverridesFromGateway(): Promise<boolean> {
296
313
  * registry)
297
314
  * 2. Registry `defaultEnabled` (for declared assistant-scope keys)
298
315
  * 3. `false` (for undeclared keys with no override)
316
+ *
317
+ * Resolution reads only the override and registry caches, so `_config` is
318
+ * accepted for the convenience of call sites that already hold one and never
319
+ * consulted. Callers without a config in hand should omit it rather than load
320
+ * one for this.
299
321
  */
300
322
  export function getAssistantFeatureFlagValue(
301
323
  key: string,
302
- _config: AssistantConfig,
324
+ _config?: AssistantConfig,
303
325
  ): boolean | string {
304
326
  const defaults = loadDefaultsRegistry();
305
327
  const declared = defaults[key];
306
328
  const overrides = loadOverrides();
307
329
 
308
330
  const explicit = overrides[key];
309
- if (explicit !== undefined) return explicit;
331
+ if (explicit !== undefined) {
332
+ return explicit;
333
+ }
310
334
 
311
- if (declared) return declared.defaultEnabled;
335
+ if (declared) {
336
+ return declared.defaultEnabled;
337
+ }
312
338
 
313
339
  return false;
314
340
  }
@@ -322,7 +348,7 @@ export function getAssistantFeatureFlagValue(
322
348
  */
323
349
  export function isAssistantFeatureFlagEnabled(
324
350
  key: string,
325
- config: AssistantConfig,
351
+ config?: AssistantConfig,
326
352
  ): boolean {
327
353
  return !!getAssistantFeatureFlagValue(key, config);
328
354
  }
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: app-builder
3
- description: Build and edit small, personal visual tools and artifacts — dashboards, trackers, calculators, data visualizations, charts, simple landing pages, and slide decks the user wants for THEMSELVES. This is the right skill whenever the user asks to "visualize this," "make a chart," or "build an artifact" for their own use, or to edit an app they already built here. Do NOT reach for a ui_show dynamic_page to fake an artifact — build a real persistent app here. NOT for complex, multi-user, or shippable products — those go to a real project folder with a coding agent (see Scope below).
3
+ description: Build and edit small, personal visual tools and artifacts — dashboards, trackers, calculators, data visualizations, charts, simple landing pages, and slide decks the user wants for THEMSELVES. This is the right skill whenever the user asks to "visualize this," "make a chart," or "build an artifact" for their own use, or to edit an app they already built here. Do NOT reach for a ui_show dynamic_page to fake an artifact — build a real persistent app here. A one-off diagram, chart, or explainer that just accompanies an answer belongs to the visualize skill (ui_show visual), not an app. NOT for complex, multi-user, or shippable products — those go to a real project folder with a coding agent (see Scope below).
4
4
  metadata:
5
5
  emoji: "🛠️"
6
6
  vellum:
@@ -9,10 +9,11 @@ metadata:
9
9
  includes: ["frontend-design"]
10
10
  activation-hints:
11
11
  - "User asks to build a dashboard, tracker, calculator, data visualization, chart, simple landing page, or slide deck for their own use"
12
- - "User asks to visualize something, make a chart, or build an artifact — build a real persistent app here, never a ui_show dynamic_page"
12
+ - "User asks to build an artifact, tool, or app they will keep using — build a real persistent app here, never a ui_show dynamic_page"
13
13
  - "User asks to change, fix, restyle, or extend an app they already built in the sandbox — open it and iterate"
14
14
  - "User asks to open, show, or pull up an app they already built — this skill provides app_list + app_open even when nothing needs editing"
15
15
  avoid-when:
16
+ - "An inline diagram, chart, or explainer that accompanies an answer and will not be reopened — use the visualize skill"
16
17
  - "User wants a complex app, a multi-user app, or something to publish, deploy, or hand off to others — route to a local project folder + coding agent instead (see Scope)"
17
18
  ---
18
19
 
@@ -284,7 +285,7 @@ return src ? <video src={src} controls /> : null;
284
285
 
285
286
  Paths are validated server-side (no traversal, no `records/`); the file is served only from this app's own directory.
286
287
 
287
- **Live updates — `window.vellum.subscribe({ tags }, cb)`.** Instead of polling on a timer, subscribe to your own invalidation tags and refresh when the data actually changes. After a route mutates data it publishes a `sync_changed` event (`context.assistantEventHub.publish({ …, message: { type: "sync_changed", tags: ["my-app:items"] } })`); the app subscribes to that tag and re-fetches when it fires. Returns an unsubscribe function — call it on cleanup. Only your own custom tags are delivered (host namespaces like `conversation:`/`assistant:` are never forwarded), and the payload is just the changed tags — re-fetch through `window.vellum.fetch` for the data.
288
+ **Live updates — `window.vellum.subscribe({ tags }, cb)`.** Instead of polling on a timer, subscribe to your own invalidation tags and refresh when the data actually changes. After a route mutates data it publishes a `sync_changed` event (`import { publishEvent } from "@vellumai/plugin-api"`, then `publishEvent({ …, message: { type: "sync_changed", tags: ["my-app:items"] } })`); the app subscribes to that tag and re-fetches when it fires. Returns an unsubscribe function — call it on cleanup. Only your own custom tags are delivered (host namespaces like `conversation:`/`assistant:` are never forwarded), and the payload is just the changed tags — re-fetch through `window.vellum.fetch` for the data.
288
289
 
289
290
  ```tsx
290
291
  useEffect(() => {
@@ -295,7 +296,7 @@ useEffect(() => {
295
296
  }, []);
296
297
  ```
297
298
 
298
- **Writing a route handler.** Routes are `.ts`/`.js` files in `{workspaceDir}/routes/`, served at `/v1/x/<filename>` (`routes/items.ts` → `/v1/x/items`; `routes/bar/index.ts` → `/v1/x/bar`). Write them with `file_write` **before** `app_refresh`. Each exports named functions per HTTP method (`GET`/`POST`/`PUT`/`PATCH`/`DELETE`), receiving the Web `Request` and an optional `context`. Full Node API access (`fs`, `path`, `crypto`), 30s timeout, hot-reloaded on change. No `[id].ts` dynamic segments — use query params.
299
+ **Writing a route handler.** Routes are `.ts`/`.js` files in `{workspaceDir}/routes/`, served at `/v1/x/<filename>` (`routes/items.ts` → `/v1/x/items`; `routes/bar/index.ts` → `/v1/x/bar`). Write them with `file_write` **before** `app_refresh`. Each exports named functions per HTTP method (`GET`/`POST`/`PUT`/`PATCH`/`DELETE`), receiving the Web `Request`. Full Node API access (`fs`, `path`, `crypto`), 30s timeout, hot-reloaded on change. No `[id].ts` dynamic segments — use query params.
299
300
 
300
301
  ```typescript
301
302
  // routes/items.ts
@@ -314,7 +315,7 @@ export async function POST(req: Request): Promise<Response> {
314
315
  }
315
316
  ```
316
317
 
317
- The optional `context` arg exposes daemon singletons — e.g. `context.assistantEventHub.publish({...})` to push real-time events to connected clients (UI updates, navigation, notifications). It's immutable. Full guide + copyable examples (Focus Timer, Habit Tracker, Expense Tracker): `{baseDir}/references/CUSTOM_ROUTES.md`, `{baseDir}/references/examples/`.
318
+ To reach daemon capabilities, import from `@vellumai/plugin-api` — `publishEvent({...})` to push real-time events to connected clients (UI updates, navigation, notifications), or `runConversationTurn({...})` to post an inbound event into a conversation as a real assistant turn. (An older `context` second argument still works in-process but is deprecated — prefer these imports.) Full guide + copyable examples (Focus Timer, Habit Tracker, Expense Tracker): `{baseDir}/references/CUSTOM_ROUTES.md`, `{baseDir}/references/examples/`.
318
319
 
319
320
  **Persistence options:** `localStorage` for ephemeral UI state (filters, view modes, drafts); custom routes for persistent records and server-side logic.
320
321
 
@@ -6,7 +6,7 @@ When the app needs server-side persistence, custom API logic, or workspace file
6
6
 
7
7
  ## Handler file convention
8
8
 
9
- Each handler file exports named functions for the HTTP methods it supports (`GET`, `POST`, `PUT`, `PATCH`, `DELETE`). Handlers receive two arguments: the standard Web API `Request` and an optional `context` object with runtime singletons.
9
+ Each handler file exports named functions for the HTTP methods it supports (`GET`, `POST`, `PUT`, `PATCH`, `DELETE`). Handlers take the standard Web API `Request`. To reach daemon capabilities (publishing events, running a conversation turn), import them from `@vellumai/plugin-api` — that is the supported way, and it works identically in-process and in the route-host subprocess.
10
10
 
11
11
  ```
12
12
  {workspaceDir}/routes/
@@ -86,27 +86,22 @@ Don't hand-declare `window.vellum` in a local `vellum.d.ts`. If the app depends
86
86
 
87
87
  Equivalently, add `"@vellumai/plugin-api/app"` to `compilerOptions.types` in `tsconfig.json`. Both are types-only — do **not** `import` from `@vellumai/plugin-api` to get the global; a runtime bare import isn't supported for sandboxed apps. If you want to name a type, use `import type { VellumAppBridge } from "@vellumai/plugin-api/app"`.
88
88
 
89
- ## Runtime context
89
+ ## Reaching daemon capabilities (`@vellumai/plugin-api`)
90
90
 
91
- Every handler receives a frozen `context` object as its second argument. This provides access to daemon singletons that are otherwise unreachable from dynamically imported route modules.
92
-
93
- ```typescript
94
- export async function POST(request: Request, context): Promise<Response> {
95
- // context.assistantEventHub — publish events to connected SSE clients
96
- // context.conversations — post messages into conversations as real turns
97
- }
98
- ```
91
+ To reach a daemon capability from a handler, import it from `@vellumai/plugin-api`. These imports work the same way in-process and in the route-host subprocess.
99
92
 
100
93
  ### Publishing events to the client
101
94
 
102
- Use `context.assistantEventHub` to push real-time events to connected desktop/mobile clients. This is how route handlers can trigger client-side navigation, update UI, or deliver notifications.
95
+ Use `publishEvent` to push a real-time event to connected desktop/mobile clients. This is how a route triggers client-side navigation, updates UI, or delivers a notification.
103
96
 
104
97
  ```typescript
105
98
  // routes/open-conversation.ts
106
- export async function POST(request: Request, context): Promise<Response> {
99
+ import { publishEvent } from "@vellumai/plugin-api";
100
+
101
+ export async function POST(request: Request): Promise<Response> {
107
102
  const { conversationId } = await request.json();
108
103
 
109
- await context.assistantEventHub.publish({
104
+ await publishEvent({
110
105
  id: crypto.randomUUID(),
111
106
  assistantId: "self",
112
107
  conversationId,
@@ -118,38 +113,33 @@ export async function POST(request: Request, context): Promise<Response> {
118
113
  }
119
114
  ```
120
115
 
116
+ `publishEvent` rejects daemon-to-client host-proxy control events (`host_*`); everything else — including your own `sync_changed` invalidation tags — flows to subscribed clients.
117
+
121
118
  ### Posting into a conversation
122
119
 
123
- Use `context.conversations.postMessage` to surface an inbound event as a real assistant turn — the way a webhook receiver, a scheduled job, or a device callback turns "your deploy finished" or "payment received" into a message the assistant actually responds to (not just a client-side event).
120
+ Use `runConversationTurn` to surface an inbound event as a real assistant turn — the way a webhook receiver, a scheduled job, or a device callback turns "your deploy finished" or "payment received" into a message the assistant actually responds to (not just a client-side event).
124
121
 
125
122
  ```typescript
126
123
  // routes/deploy-webhook.ts — an external CI system POSTs here when a build finishes
127
- export async function POST(request: Request, context): Promise<Response> {
124
+ import { runConversationTurn } from "@vellumai/plugin-api";
125
+
126
+ export async function POST(request: Request): Promise<Response> {
128
127
  const { conversationId, status } = await request.json();
129
- try {
130
- await context.conversations.postMessage(
131
- conversationId,
132
- `Your deploy finished: ${status}.`,
133
- );
134
- return Response.json({ ok: true });
135
- } catch (err) {
136
- // err.code is "not_found" | "rate_limited" | "invalid"
137
- const code = (err as { code?: string }).code;
138
- const httpStatus =
139
- code === "not_found" ? 404 : code === "rate_limited" ? 429 : 400;
140
- return Response.json(
141
- { ok: false, error: String(err) },
142
- { status: httpStatus },
143
- );
144
- }
128
+
129
+ await runConversationTurn({
130
+ conversationId,
131
+ content: [{ type: "text", text: `Your deploy finished: ${status}.` }],
132
+ });
133
+
134
+ return Response.json({ ok: true });
145
135
  }
146
136
  ```
147
137
 
148
- The posted turn is attributed to a dedicated `route` interface — it can never impersonate a human surface — and runs under the target conversation's existing trust context, so a route cannot elevate privilege by posting. Unknown conversation ids are rejected (a route never silently creates a conversation), and posts are rate-limited per conversation to backstop runaway route→assistant→route loops.
138
+ Omit `conversationId` to start a fresh conversation (the new id is returned). If the conversation is mid-turn the message is queued and runs when the current turn finishes.
149
139
 
150
- The context object is **immutable** — attempting to reassign its properties will throw in strict mode (ESM). This prevents user route handlers from accidentally corrupting shared state.
140
+ ### Deprecated: the `context` argument
151
141
 
152
- Legacy handlers that only accept `(request)` continue to work — the context is passed positionally but ignored if the handler doesn't declare the parameter.
142
+ Older routes were written with a second `context` argument (`context.assistantEventHub.publish(...)`, `context.conversations.postMessage(...)`). That argument still works in-process but is **deprecated** and will be removed — it isn't available in the route-host subprocess, and its use is tracked so remaining callers can be migrated. Port these to the `@vellumai/plugin-api` imports above: `context.assistantEventHub.publish` → `publishEvent`, `context.conversations.postMessage(id, text)` → `runConversationTurn({ conversationId: id, content: [{ type: "text", text }] })`.
153
143
 
154
144
  ## Key rules
155
145
 
@@ -20,7 +20,7 @@ A design system CSS is auto-injected inside a `@layer`, so your styles always ta
20
20
  | **Typography** | `--v-font-family`, `--v-font-mono`, `--v-font-size-xs` (10px) / `-sm` (11px) / `-base` (14px) / `-lg` (17px) / `-xl` (22px) / `-2xl` (26px), `--v-line-height` |
21
21
  | **Animation** | `--v-duration-fast` (0.15s) / `-standard` (0.25s) / `-slow` (0.4s) |
22
22
  | **Palettes** | `--v-slate-{950..50}`, `--v-emerald-*`, `--v-violet-*`, `--v-indigo-*`, `--v-rose-*`, `--v-amber-*` |
23
- | **Constant** | `--v-aux-white` (always `#FFFFFF` in both modes — use for text on filled/accent backgrounds) |
23
+ | **Constant** | `--v-aux-white` (always `#FFFFFF` in both modes — use for text on filled/accent backgrounds) |
24
24
 
25
25
  ---
26
26
 
@@ -14,6 +14,7 @@ Slides are a different domain from apps. Skip app-specific patterns (contextual
14
14
  ## Navigation
15
15
 
16
16
  Build slide navigation as your own component. Common patterns:
17
+
17
18
  - Keyboard: `ArrowLeft` / `ArrowRight` / `Space` / `Escape`
18
19
  - Click affordances at left/right edges
19
20
  - Slide counter pill in a corner (e.g. `3 / 12`)
@@ -18,7 +18,7 @@ A CSS widget library is auto-injected alongside the design system — the `.v-*`
18
18
  | `.v-progress-bar` / `.v-progress-track` / `.v-progress-fill` | Horizontal progress |
19
19
  | `.v-status-badge` | Colored pill with dot (`.success`/`.error`/`.warning`/`.info`) |
20
20
  | `.v-stat-row` / `.v-stat` | Horizontal label-value pairs |
21
- | `.v-toast` | Notification banner (show/hide with your own JS) |
21
+ | `.v-toast` | Notification banner (show/hide with your own JS) |
22
22
  | `.v-avatar-row` | Contact/team display |
23
23
  | `.v-tag-group` | Wrapping tag row |
24
24
 
@@ -15,7 +15,9 @@ export async function run(
15
15
  context: ToolContext,
16
16
  ): Promise<ToolExecutionResult> {
17
17
  const appId = resolveAppId(input, context.conversationId);
18
- if (!appId) return missingAppIdError();
18
+ if (!appId) {
19
+ return missingAppIdError();
20
+ }
19
21
  return executeAppGenerateIcon(
20
22
  { ...input, app_id: appId } as unknown as AppGenerateIconInput,
21
23
  appStore,
@@ -14,6 +14,8 @@ export async function run(
14
14
  context: ToolContext,
15
15
  ): Promise<ToolExecutionResult> {
16
16
  const appId = resolveAppId(input, context.conversationId);
17
- if (!appId) return missingAppIdError();
17
+ if (!appId) {
18
+ return missingAppIdError();
19
+ }
18
20
  return executeAppRefresh({ app_id: appId }, appStore);
19
21
  }
@@ -15,7 +15,9 @@ export async function run(
15
15
  context: ToolContext,
16
16
  ): Promise<ToolExecutionResult> {
17
17
  const appId = resolveAppId(input, context.conversationId);
18
- if (!appId) return missingAppIdError();
18
+ if (!appId) {
19
+ return missingAppIdError();
20
+ }
19
21
  return executeAppUpdate(
20
22
  { ...input, app_id: appId } as unknown as AppUpdateInput,
21
23
  appStore,
@@ -20,16 +20,23 @@ function formatContactSummary(c: SearchContact): string {
20
20
  const displayName =
21
21
  c.role === "guardian" ? resolveGuardianName(c.displayName) : c.displayName;
22
22
  const parts = [`- **${displayName}** (ID: ${c.id})`];
23
- if (c.notes) parts.push(` Notes: ${c.notes}`);
24
- if ((c.interactionCount ?? 0) > 0)
23
+ if (c.notes) {
24
+ parts.push(` Notes: ${c.notes}`);
25
+ }
26
+ if ((c.interactionCount ?? 0) > 0) {
25
27
  parts.push(` Interactions: ${c.interactionCount}`);
28
+ }
26
29
  if (c.channels.length > 0) {
27
30
  const channelList = c.channels
28
31
  .map((ch) => {
29
32
  let s = `${ch.type}:${ch.address}${ch.isPrimary ? "*" : ""}`;
30
33
  const extras: string[] = [];
31
- if (ch.externalChatId) extras.push(`chatId: ${ch.externalChatId}`);
32
- if (extras.length > 0) s += ` (${extras.join(", ")})`;
34
+ if (ch.externalChatId) {
35
+ extras.push(`chatId: ${ch.externalChatId}`);
36
+ }
37
+ if (extras.length > 0) {
38
+ s += ` (${extras.join(", ")})`;
39
+ }
33
40
  return s;
34
41
  })
35
42
  .join(", ");
@@ -59,14 +59,18 @@ export async function run(
59
59
  contacts,
60
60
  total: resp.totalPeople ?? contacts.length,
61
61
  };
62
- if (resp.nextPageToken) result.nextPageToken = resp.nextPageToken;
62
+ if (resp.nextPageToken) {
63
+ result.nextPageToken = resp.nextPageToken;
64
+ }
63
65
 
64
66
  return ok(JSON.stringify(result, null, 2));
65
67
  }
66
68
 
67
69
  case "search": {
68
70
  const query = input.query as string;
69
- if (!query) return err("query is required for search action.");
71
+ if (!query) {
72
+ return err("query is required for search action.");
73
+ }
70
74
 
71
75
  const resp = await searchContacts(connection, query);
72
76
  const contacts = (resp.results ?? []).map((r) =>