@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
@@ -0,0 +1,787 @@
1
+ /**
2
+ * Validation for the `visual` ui_show surface: a self-contained HTML fragment
3
+ * rendered inside a sandboxed frame.
4
+ *
5
+ * The frame has no network access and injects a fixed vocabulary of design
6
+ * tokens on `:root`, so an external sub-resource silently never loads and a
7
+ * `var()` to
8
+ * anything outside that vocabulary resolves to nothing. Both failures render a
9
+ * blank or unthemed widget with no error anywhere, so they are caught here and
10
+ * reported as teaching errors the model can act on before the surface is ever
11
+ * emitted.
12
+ */
13
+
14
+ /**
15
+ * Upper bound on fragment size. Sized to what one model response can emit
16
+ * with room to spare: a fragment past this cannot be produced in a single
17
+ * ui_show call, so the turn burns its output budget and renders nothing.
18
+ */
19
+ const MAX_HTML_CHARS = 24000;
20
+
21
+ const RAMP_STEPS = [
22
+ "100",
23
+ "200",
24
+ "300",
25
+ "400",
26
+ "500",
27
+ "600",
28
+ "700",
29
+ "800",
30
+ "900",
31
+ "950",
32
+ ] as const;
33
+
34
+ /** Neutral ramps carry an extra lightest step; the accents start at 100. */
35
+ const NEUTRAL_PALETTES = ["moss", "stone"] as const;
36
+ const ACCENT_PALETTES = ["forest", "emerald", "danger", "amber"] as const;
37
+
38
+ const PALETTE_PROPERTIES: readonly string[] = [
39
+ ...NEUTRAL_PALETTES.flatMap((palette) =>
40
+ ["50", ...RAMP_STEPS].map((step) => `--color-${palette}-${step}`),
41
+ ),
42
+ ...ACCENT_PALETTES.flatMap((palette) =>
43
+ RAMP_STEPS.map((step) => `--color-${palette}-${step}`),
44
+ ),
45
+ ];
46
+
47
+ /**
48
+ * The CSS custom properties that exist inside a widget frame. The host injects
49
+ * exactly these onto `:root` of the sandboxed iframe.
50
+ *
51
+ * Mirrors `WIDGET_TOKEN_PROPERTIES` in
52
+ * `clients/web/src/utils/widget-tokens.ts` — the two must change together.
53
+ */
54
+ export const WIDGET_TOKEN_PROPERTIES: readonly string[] = [
55
+ // Surfaces
56
+ "--surface-base",
57
+ "--surface-lift",
58
+ "--surface-overlay",
59
+ "--surface-active",
60
+ "--surface-hover",
61
+ "--surface-sunken",
62
+ // Content
63
+ "--content-default",
64
+ "--content-emphasised",
65
+ "--content-secondary",
66
+ "--content-tertiary",
67
+ "--content-quiet",
68
+ "--content-strong",
69
+ "--content-faint",
70
+ "--content-disabled",
71
+ "--content-inset",
72
+ // Borders
73
+ "--border-base",
74
+ "--border-subtle",
75
+ "--border-element",
76
+ "--border-hover",
77
+ "--border-disabled",
78
+ "--border-active",
79
+ // System / status
80
+ "--system-positive-strong",
81
+ "--system-positive-weak",
82
+ "--system-negative-strong",
83
+ "--system-negative-weak",
84
+ "--system-negative-hover",
85
+ "--system-mid-strong",
86
+ "--system-mid-weak",
87
+ "--system-info-strong",
88
+ "--system-info-weak",
89
+ // Fonts
90
+ "--font-sans",
91
+ "--font-mono",
92
+ "--font-serif",
93
+ // Radius
94
+ "--radius-xs",
95
+ "--radius-sm",
96
+ "--radius-md",
97
+ "--radius-lg",
98
+ "--radius-xl",
99
+ "--radius-xxl",
100
+ "--radius-pill",
101
+ // Palettes
102
+ ...PALETTE_PROPERTIES,
103
+ ];
104
+
105
+ /** Lookup form of {@link WIDGET_TOKEN_PROPERTIES}. */
106
+ const WIDGET_TOKEN_NAMES: ReadonlySet<string> = new Set(
107
+ WIDGET_TOKEN_PROPERTIES,
108
+ );
109
+
110
+ /**
111
+ * Complete vocabulary, quoted back to the model when a fragment references a
112
+ * variable that does not exist. Enumerating every non-palette name (they are
113
+ * short) lets the first retry succeed instead of the model guessing plausible
114
+ * names or re-reading the skill.
115
+ */
116
+ const TOKEN_FAMILY_SUMMARY =
117
+ WIDGET_TOKEN_PROPERTIES.filter((name) => !name.startsWith("--color-")).join(
118
+ ", ",
119
+ ) +
120
+ ", and the palette ramps --color-<moss|stone>-<50-950> and --color-<forest|emerald|danger|amber>-<100-950>";
121
+
122
+ /**
123
+ * Sub-resource loads the sandbox blocks outright. Catching them here turns a
124
+ * silently blank widget into an actionable error.
125
+ */
126
+ const EXTERNAL_RESOURCE_PATTERNS: { pattern: RegExp; what: string }[] = [
127
+ { pattern: /<script\b[^>]*\bsrc\s*=/i, what: "a <script src=...> tag" },
128
+ {
129
+ pattern: /<link\b[^>]*\bstylesheet\b/i,
130
+ what: "a <link rel=stylesheet> tag",
131
+ },
132
+ { pattern: /@import\b/i, what: "a CSS @import rule" },
133
+ ];
134
+
135
+ /** Every `var(--name)` reference in the fragment. */
136
+ const VAR_REFERENCE_PATTERN = /var\(\s*(--[a-zA-Z0-9-]+)/g;
137
+
138
+ /** Every `--name:` declaration, i.e. properties the fragment defines itself. */
139
+ const CUSTOM_PROPERTY_DECLARATION_PATTERN = /(--[a-zA-Z0-9-]+)\s*:/g;
140
+
141
+ /** Properties the fragment sets from script: `setProperty('--name', …)`. */
142
+ const SET_PROPERTY_DECLARATION_PATTERN =
143
+ /setProperty\(\s*["'](--[a-zA-Z0-9-]+)["']/g;
144
+
145
+ /**
146
+ * Fragments legitimately carry `#`-prefixed identifiers that are not colours:
147
+ * SVG paint and filter references, in-page anchors, and numeric character
148
+ * references. Removing them before the colour scan keeps the check unambiguous.
149
+ */
150
+ const NON_COLOR_HASH_PATTERNS: RegExp[] = [
151
+ /url\(\s*['"]?#[^)]*\)/gi,
152
+ /href\s*=\s*["']#[^"']*["']/gi,
153
+ /&#x?[0-9a-fA-F]+;/g,
154
+ ];
155
+
156
+ /** `#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`. */
157
+ const HEX_TOKEN_PATTERN = /#([0-9a-fA-F]+)\b/g;
158
+ const HEX_COLOR_LENGTHS = new Set([3, 4, 6, 8]);
159
+
160
+ /** Functional colour notations whose first argument is a literal number. */
161
+ const FUNCTIONAL_COLOR_PATTERN =
162
+ /\b(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch)\(\s*(?:\d|\.\d|-\d)[^)]*\)/gi;
163
+
164
+ /** How many offending values a teaching error quotes back. */
165
+ const MAX_QUOTED_PROBLEMS = 5;
166
+
167
+ /** Every root `<svg …>` open tag. Nested `<svg>` is not a thing we author. */
168
+ const SVG_OPEN_TAG_PATTERN = /<svg\b[^>]*>/gi;
169
+
170
+ const VIEWBOX_ATTRIBUTE_PATTERN = /\bviewBox\s*=/i;
171
+
172
+ /** A `width`/`height` attribute whose value is a bare or `px` pixel count. */
173
+ const SVG_PIXEL_SIZE_PATTERN =
174
+ /\b(width|height)\s*=\s*["'](\d+(?:\.\d+)?)(px)?["']/gi;
175
+
176
+ /**
177
+ * Widest an `<svg>` can be sized in pixels before it overruns the frame. The
178
+ * container gives a visual about 660px of usable width, and the drawing
179
+ * conventions lay out against a 680-unit canvas; anything past that is only
180
+ * safe as a viewBox, which scales.
181
+ */
182
+ const MAX_SVG_PIXEL_SIZE = 680;
183
+
184
+ /**
185
+ * The fix for an unscalable `<svg>`, quoted verbatim so the retry lands in one
186
+ * call rather than guessing at a smaller pixel width.
187
+ */
188
+ const VIEWBOX_FIX =
189
+ 'Give the root svg a viewBox="0 0 W H" (W and H are the drawing\'s own coordinate extent, W 680 by convention) plus width="100%", and remove any fixed pixel width and height. ' +
190
+ "A viewBox is what makes a drawing scale to whatever width the frame has; a pixel-sized svg keeps its size and is silently clipped at the right edge, with no scrollbar and nothing on screen to say content is missing.";
191
+
192
+ /** `<rect>` open tags, the one shape whose extent is exact from its attributes. */
193
+ const SVG_RECT_TAG_PATTERN = /<rect\b[^>]*>/gi;
194
+
195
+ /** Numbers of a `viewBox="minX minY width height"` value. */
196
+ const VIEWBOX_VALUE_PATTERN =
197
+ /\bviewBox\s*=\s*["']\s*(-?[\d.]+)[\s,]+(-?[\d.]+)[\s,]+([\d.]+)[\s,]+([\d.]+)/i;
198
+
199
+ /** Sub-pixel slack, so a rounded coordinate is not reported as an overrun. */
200
+ const VIEWBOX_BOUNDS_TOLERANCE = 0.5;
201
+
202
+ function numericAttribute(tag: string, name: string): number | undefined {
203
+ const match = new RegExp(`\\b${name}\\s*=\\s*["'](-?[\\d.]+)`, "i").exec(tag);
204
+ if (!match) {
205
+ return undefined;
206
+ }
207
+ const value = Number(match[1]);
208
+ return Number.isFinite(value) ? value : undefined;
209
+ }
210
+
211
+ /**
212
+ * Shapes drawn outside their own `viewBox`. An SVG clips at the viewBox edge,
213
+ * so a node placed past it is not laid out badly, it is invisible. What a
214
+ * reader sees is a diagram whose last box is sliced off, with nothing to
215
+ * indicate more was drawn.
216
+ */
217
+ function collectViewBoxOverrunProblems(html: string): string[] {
218
+ const overruns = new Set<string>();
219
+
220
+ for (const svg of html.matchAll(SVG_OPEN_TAG_PATTERN)) {
221
+ const box = VIEWBOX_VALUE_PATTERN.exec(svg[0]);
222
+ if (!box) {
223
+ continue;
224
+ }
225
+ const minX = Number(box[1]);
226
+ const minY = Number(box[2]);
227
+ const maxX = minX + Number(box[3]);
228
+ const maxY = minY + Number(box[4]);
229
+
230
+ const bodyStart = (svg.index ?? 0) + svg[0].length;
231
+ const closeIndex = html.indexOf("</svg", bodyStart);
232
+ const body = html.slice(
233
+ bodyStart,
234
+ closeIndex === -1 ? html.length : closeIndex,
235
+ );
236
+
237
+ for (const rect of body.matchAll(SVG_RECT_TAG_PATTERN)) {
238
+ const x = numericAttribute(rect[0], "x") ?? 0;
239
+ const y = numericAttribute(rect[0], "y") ?? 0;
240
+ const width = numericAttribute(rect[0], "width");
241
+ const height = numericAttribute(rect[0], "height");
242
+ if (width !== undefined && x + width > maxX + VIEWBOX_BOUNDS_TOLERANCE) {
243
+ overruns.add(
244
+ `x=${x} width=${width} ends at ${x + width}, past ${maxX}`,
245
+ );
246
+ }
247
+ if (
248
+ height !== undefined &&
249
+ y + height > maxY + VIEWBOX_BOUNDS_TOLERANCE
250
+ ) {
251
+ overruns.add(
252
+ `y=${y} height=${height} ends at ${y + height}, past ${maxY}`,
253
+ );
254
+ }
255
+ }
256
+ }
257
+
258
+ if (overruns.size === 0) {
259
+ return [];
260
+ }
261
+ return [
262
+ `Shapes drawn outside the viewBox: ${quote([...overruns])}. ` +
263
+ "An SVG clips at its viewBox edge, so these render sliced off or not at all, with nothing on screen to say " +
264
+ "content is missing. Either move the shapes back inside the box or widen the viewBox to cover them, " +
265
+ "and re-check the packing math: everything has to fit between the viewBox bounds, gaps included.",
266
+ ];
267
+ }
268
+
269
+ /**
270
+ * `transform` attributes anywhere in the fragment. The layout system is built
271
+ * on absolute viewBox coordinates (grid slots, extent checks, label centring),
272
+ * and a translated group invites mixing local and absolute coordinates on its
273
+ * children — the classic symptom is every label rendering below or beside its
274
+ * box. Banning the attribute keeps one coordinate system for everything.
275
+ */
276
+ function collectTransformProblems(html: string): string[] {
277
+ const count = [...html.matchAll(/\stransform\s*=\s*["']/g)].length;
278
+ if (count === 0) {
279
+ return [];
280
+ }
281
+ return [
282
+ `${count} element(s) carry a transform attribute. Every coordinate in the fragment is an absolute viewBox coordinate; ` +
283
+ "remove each transform and place the element directly. A node's text centres at the rect's own position: " +
284
+ 'x = rect x + width/2 with text-anchor="middle", y = rect y + 22 for a single line (or +20 and +38 for a two-line node). ' +
285
+ "Translated groups mix local and absolute coordinates and put labels outside their boxes.",
286
+ ];
287
+ }
288
+
289
+ /**
290
+ * Style rules that paint a surface token as an inheritable fill. `fill`
291
+ * inherits from a group to its text children, so `.note{fill:var(--surface-sunken)}`
292
+ * declared after the text classes silently repaints every label in the tile's
293
+ * own background colour. A surface fill is legitimate only when the rule is
294
+ * scoped to shape elements.
295
+ */
296
+ const SHAPE_SCOPED_SELECTOR_PATTERN =
297
+ /\b(?:rect|path|circle|ellipse|line|polyline|polygon)\b/;
298
+
299
+ function collectSurfaceFillOnTextProblems(html: string): string[] {
300
+ const offenders: string[] = [];
301
+ for (const rule of html.matchAll(/([^{}<>]{1,120})\{([^{}]*)\}/g)) {
302
+ const selector = rule[1].trim();
303
+ const body = rule[2];
304
+ if (!/fill\s*:\s*var\(--surface-/.test(body)) {
305
+ continue;
306
+ }
307
+ if (SHAPE_SCOPED_SELECTOR_PATTERN.test(selector)) {
308
+ continue;
309
+ }
310
+ offenders.push(selector);
311
+ }
312
+ if (offenders.length === 0) {
313
+ return [];
314
+ }
315
+ return [
316
+ `Style rule(s) ${quote(offenders)} set fill to a surface token without scoping to a shape. ` +
317
+ "fill inherits to text, so a group-level surface fill repaints the labels inside it in the background colour " +
318
+ "and they disappear. Scope background fills to the shape (`.note rect{fill:var(--surface-sunken)}`) and keep " +
319
+ "text fills on content tokens or ramp stops.",
320
+ ];
321
+ }
322
+
323
+ /**
324
+ * Problems with how an `<svg>` is sized. Without a `viewBox` the drawing has no
325
+ * intrinsic coordinate system to scale, so it renders at its literal size and
326
+ * the frame crops whatever does not fit.
327
+ */
328
+ function collectSvgSizingProblems(html: string): string[] {
329
+ const problems: string[] = [];
330
+ const oversized: string[] = [];
331
+ let missingViewBox = false;
332
+
333
+ for (const match of html.matchAll(SVG_OPEN_TAG_PATTERN)) {
334
+ const tag = match[0];
335
+ if (VIEWBOX_ATTRIBUTE_PATTERN.test(tag)) {
336
+ continue;
337
+ }
338
+ missingViewBox = true;
339
+ for (const size of tag.matchAll(SVG_PIXEL_SIZE_PATTERN)) {
340
+ if (Number(size[2]) > MAX_SVG_PIXEL_SIZE) {
341
+ oversized.push(`${size[1]}="${size[2]}${size[3] ?? ""}"`);
342
+ }
343
+ }
344
+ }
345
+
346
+ if (missingViewBox) {
347
+ problems.push(`An <svg> element has no viewBox attribute. ${VIEWBOX_FIX}`);
348
+ }
349
+ if (oversized.length > 0) {
350
+ problems.push(
351
+ `An <svg> without a viewBox is sized past the ${MAX_SVG_PIXEL_SIZE}px the frame can show: ${quote(
352
+ oversized,
353
+ )}. Everything beyond that width is cropped away. ${VIEWBOX_FIX}`,
354
+ );
355
+ }
356
+
357
+ return problems;
358
+ }
359
+
360
+ /** Every ramp-token reference, with the palette and stop split out. */
361
+ const RAMP_TOKEN_PATTERN = new RegExp(
362
+ `--color-(${[...NEUTRAL_PALETTES, ...ACCENT_PALETTES].join(
363
+ "|",
364
+ )})-(50|${RAMP_STEPS.join("|")})\\b`,
365
+ "g",
366
+ );
367
+
368
+ /**
369
+ * The two ends of a ramp, the stops that only read against a fill from the
370
+ * opposite end. The host mirrors ramp stops under the dark scheme, so an end
371
+ * stop swaps sides with the theme while the page background it might be
372
+ * painted on does not — pairing is what keeps the relationship intact.
373
+ */
374
+ const DARK_RAMP_STOPS: ReadonlySet<string> = new Set([
375
+ "700",
376
+ "800",
377
+ "900",
378
+ "950",
379
+ ]);
380
+ const LIGHT_RAMP_STOPS: ReadonlySet<string> = new Set(["50", "100", "200"]);
381
+ /** Fill stops light enough to carry dark ramp text. */
382
+ const LIGHT_FILL_STOPS: ReadonlySet<string> = new Set([
383
+ "50",
384
+ "100",
385
+ "200",
386
+ "300",
387
+ ]);
388
+
389
+ /** `color:` declarations, excluding `background-color:`, `stop-color:`, etc. */
390
+ const TEXT_COLOR_DECLARATION_PATTERN = /(?<![-\w])color\s*:\s*[^;}"'>]*/gi;
391
+
392
+ /** Open tags of the two SVG elements that paint glyphs. */
393
+ const SVG_TEXT_TAG_PATTERN = /<(?:text|tspan)\b[^>]*>/gi;
394
+
395
+ /** Any element's open tag, the span that carries one element's own paint. */
396
+ const START_TAG_PATTERN = /<[a-zA-Z][^>]*>/g;
397
+
398
+ /** `<g>` open and close tags, used to bound the group around a label. */
399
+ const GROUP_BOUNDARY_PATTERN = /<g\b[^>]*>|<\/g\s*>/gi;
400
+
401
+ /** Class names an element carries, used to reach the rules that paint it. */
402
+ const CLASS_ATTRIBUTE_PATTERN = /\bclass\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
403
+
404
+ /**
405
+ * Style rules, used to spot the ones that paint text via `fill:`. The selector
406
+ * is bounded by `<`, `>`, `;` and `}` so it cannot swallow preceding markup.
407
+ */
408
+ const CSS_RULE_PATTERN = /[^{};<>]*\{[^{}]*\}/g;
409
+ const FILL_DECLARATION_PATTERN = /\bfill\s*:/i;
410
+ const FONT_DECLARATION_PATTERN = /\bfont(?:-[a-z]+)?\s*:/i;
411
+ const TEXT_SELECTOR_PATTERN = /(?:^|[\s,>+~])(?:text|tspan)\b/i;
412
+
413
+ /**
414
+ * How much markup either side of a painted label counts as "beside it". A
415
+ * two-line SVG node — rect plus title plus subtitle — runs about 350
416
+ * characters, so this reaches the shape a label belongs to without reaching the
417
+ * rest of the drawing.
418
+ */
419
+ const LOCAL_PAIRING_WINDOW = 400;
420
+
421
+ /**
422
+ * Largest `<g>` that still reads as one paired shape. Past this a group is a
423
+ * layout container, and treating it as a pairing context would clear a palette
424
+ * for the whole drawing.
425
+ */
426
+ const MAX_LOCAL_GROUP_CHARS = 2000;
427
+
428
+ type SourceRange = { start: number; end: number };
429
+
430
+ type CssRule = SourceRange & { selector: string; body: string };
431
+
432
+ /** Every `{…}` rule in the fragment, split into selector and body. */
433
+ function collectCssRules(html: string): CssRule[] {
434
+ const rules: CssRule[] = [];
435
+ for (const match of html.matchAll(CSS_RULE_PATTERN)) {
436
+ const text = match[0];
437
+ const start = match.index ?? 0;
438
+ const braceIndex = text.indexOf("{");
439
+ rules.push({
440
+ start,
441
+ end: start + text.length,
442
+ selector: text.slice(0, braceIndex),
443
+ body: text.slice(braceIndex),
444
+ });
445
+ }
446
+ return rules;
447
+ }
448
+
449
+ function collectRanges(html: string, pattern: RegExp): SourceRange[] {
450
+ const ranges: SourceRange[] = [];
451
+ for (const match of html.matchAll(pattern)) {
452
+ const start = match.index ?? 0;
453
+ ranges.push({ start, end: start + match[0].length });
454
+ }
455
+ return ranges;
456
+ }
457
+
458
+ /** Spans of balanced `<g>…</g>` pairs. Unclosed groups are ignored. */
459
+ function collectGroupRanges(html: string): SourceRange[] {
460
+ const ranges: SourceRange[] = [];
461
+ const open: number[] = [];
462
+ for (const match of html.matchAll(GROUP_BOUNDARY_PATTERN)) {
463
+ const index = match.index ?? 0;
464
+ if (match[0].startsWith("</")) {
465
+ const start = open.pop();
466
+ if (start !== undefined) {
467
+ ranges.push({ start, end: index + match[0].length });
468
+ }
469
+ } else if (!match[0].endsWith("/>")) {
470
+ open.push(index);
471
+ }
472
+ }
473
+ return ranges;
474
+ }
475
+
476
+ /**
477
+ * Spans of the fragment that paint text: `color:` declarations, `<text>` and
478
+ * `<tspan>` open tags, and style rules whose `fill:` lands on glyphs — either
479
+ * because the rule also sets a font property or because its selector names a
480
+ * text element. A ramp token inside one of these is a text colour.
481
+ */
482
+ function collectTextColorRanges(html: string, rules: CssRule[]): SourceRange[] {
483
+ const ranges = [
484
+ ...collectRanges(html, TEXT_COLOR_DECLARATION_PATTERN),
485
+ ...collectRanges(html, SVG_TEXT_TAG_PATTERN),
486
+ ];
487
+ for (const rule of rules) {
488
+ if (
489
+ FILL_DECLARATION_PATTERN.test(rule.body) &&
490
+ (FONT_DECLARATION_PATTERN.test(rule.body) ||
491
+ TEXT_SELECTOR_PATTERN.test(rule.selector))
492
+ ) {
493
+ ranges.push({ start: rule.start, end: rule.end });
494
+ }
495
+ }
496
+ return ranges;
497
+ }
498
+
499
+ function isInsideRange(index: number, ranges: SourceRange[]): boolean {
500
+ return ranges.some((range) => index >= range.start && index < range.end);
501
+ }
502
+
503
+ /** The tightest range containing the index, if any. */
504
+ function innermostRange<T extends SourceRange>(
505
+ index: number,
506
+ ranges: T[],
507
+ ): T | undefined {
508
+ let found: T | undefined;
509
+ for (const range of ranges) {
510
+ if (index < range.start || index >= range.end) {
511
+ continue;
512
+ }
513
+ if (!found || range.end - range.start < found.end - found.start) {
514
+ found = range;
515
+ }
516
+ }
517
+ return found;
518
+ }
519
+
520
+ /** Whether a stop of `palette` from `allowed` is painted anywhere in `text`. */
521
+ function hasCounterpartStop(
522
+ text: string,
523
+ palette: string,
524
+ allowed: ReadonlySet<string>,
525
+ ): boolean {
526
+ for (const match of text.matchAll(RAMP_TOKEN_PATTERN)) {
527
+ if (match[1] === palette && allowed.has(match[2])) {
528
+ return true;
529
+ }
530
+ }
531
+ return false;
532
+ }
533
+
534
+ /**
535
+ * The markup a directly painted label is paired against: its own open tag, the
536
+ * window of markup around it, the group immediately containing it, and the
537
+ * bodies of the rules that paint the classes named in that window.
538
+ */
539
+ function localPairingContexts(
540
+ html: string,
541
+ index: number,
542
+ rules: CssRule[],
543
+ tags: SourceRange[],
544
+ groups: SourceRange[],
545
+ ): string[] {
546
+ const nearby = html.slice(
547
+ Math.max(0, index - LOCAL_PAIRING_WINDOW),
548
+ index + LOCAL_PAIRING_WINDOW,
549
+ );
550
+ const contexts = [nearby];
551
+
552
+ const tag = innermostRange(index, tags);
553
+ if (tag) {
554
+ contexts.push(html.slice(tag.start, tag.end));
555
+ }
556
+
557
+ const group = innermostRange(index, groups);
558
+ if (group && group.end - group.start <= MAX_LOCAL_GROUP_CHARS) {
559
+ contexts.push(html.slice(group.start, group.end));
560
+ }
561
+
562
+ const classNames = new Set<string>();
563
+ for (const match of nearby.matchAll(CLASS_ATTRIBUTE_PATTERN)) {
564
+ for (const name of (match[1] ?? match[2] ?? "").split(/\s+/)) {
565
+ if (name) {
566
+ classNames.add(name);
567
+ }
568
+ }
569
+ }
570
+ for (const rule of rules) {
571
+ if ([...classNames].some((name) => rule.selector.includes(`.${name}`))) {
572
+ contexts.push(rule.body);
573
+ }
574
+ }
575
+
576
+ return contexts;
577
+ }
578
+
579
+ /**
580
+ * The host mirrors each ramp stop onto its opposite under the dark scheme, so a
581
+ * ramp is theme-adaptive only relative to itself: a matched fill and text pair
582
+ * inverts together and stays legible, while a lone ramp label is left against
583
+ * the page background, which takes no part in that mirror. Ramp-coloured text
584
+ * therefore only reads when it sits on a matching ramp fill — and the fill has
585
+ * to be the one actually behind the glyphs.
586
+ *
587
+ * Pairing is therefore local. A label painted directly — an inline `style`, a
588
+ * `fill` attribute on `<text>` — pairs against its own element, the markup
589
+ * around it, the group containing it, or the rules painting the classes in that
590
+ * window. A label painted through a style rule pairs inside that rule, and
591
+ * otherwise against the fragment as a whole: which elements a selector reaches
592
+ * is not knowable without a DOM, so the rule's own placement carries no signal.
593
+ */
594
+ function collectRampContrastProblems(html: string): string[] {
595
+ const rules = collectCssRules(html);
596
+ const textRanges = collectTextColorRanges(html, rules);
597
+ const tags = collectRanges(html, START_TAG_PATTERN);
598
+ const groups = collectGroupRanges(html);
599
+
600
+ const occurrences = [...html.matchAll(RAMP_TOKEN_PATTERN)].map((match) => ({
601
+ token: match[0],
602
+ palette: match[1],
603
+ stop: match[2],
604
+ index: match.index ?? 0,
605
+ }));
606
+
607
+ const fillStops = new Map<string, Set<string>>();
608
+ for (const occurrence of occurrences) {
609
+ if (isInsideRange(occurrence.index, textRanges)) {
610
+ continue;
611
+ }
612
+ const stops = fillStops.get(occurrence.palette) ?? new Set<string>();
613
+ stops.add(occurrence.stop);
614
+ fillStops.set(occurrence.palette, stops);
615
+ }
616
+
617
+ const hasFillStopIn = (
618
+ palette: string,
619
+ allowed: ReadonlySet<string>,
620
+ ): boolean =>
621
+ [...(fillStops.get(palette) ?? [])].some((stop) => allowed.has(stop));
622
+
623
+ const unpairedDark = new Set<string>();
624
+ const unpairedLight = new Set<string>();
625
+
626
+ for (const occurrence of occurrences) {
627
+ if (!isInsideRange(occurrence.index, textRanges)) {
628
+ continue;
629
+ }
630
+ const bucket = DARK_RAMP_STOPS.has(occurrence.stop)
631
+ ? unpairedDark
632
+ : LIGHT_RAMP_STOPS.has(occurrence.stop)
633
+ ? unpairedLight
634
+ : undefined;
635
+ if (!bucket) {
636
+ continue;
637
+ }
638
+ const counterparts =
639
+ bucket === unpairedDark ? LIGHT_FILL_STOPS : DARK_RAMP_STOPS;
640
+
641
+ const rule = innermostRange(occurrence.index, rules);
642
+ const paired = rule
643
+ ? hasCounterpartStop(rule.body, occurrence.palette, counterparts) ||
644
+ hasFillStopIn(occurrence.palette, counterparts)
645
+ : localPairingContexts(html, occurrence.index, rules, tags, groups).some(
646
+ (context) =>
647
+ hasCounterpartStop(context, occurrence.palette, counterparts),
648
+ );
649
+
650
+ if (!paired) {
651
+ bucket.add(occurrence.token);
652
+ }
653
+ }
654
+
655
+ const problems: string[] = [];
656
+ if (unpairedDark.size > 0) {
657
+ problems.push(
658
+ `Dark ramp stops used as text colour with no matching light fill behind them: ${quote(
659
+ [...unpairedDark],
660
+ )}. ` +
661
+ "Ramp stops mirror across their own ramp in dark mode, so a dark stop used as text flips to a " +
662
+ "light tint there while the page background takes no part in that mirror — a ramp-coloured " +
663
+ "label sitting on it has no reliable contrast in either theme. Ramp-coloured text has to sit " +
664
+ "on a matching light ramp " +
665
+ "fill (a 50–300 stop of the same palette) set on the same element, in the same style rule, or " +
666
+ "on the group immediately around it — or use a --content-* token for text that sits on the " +
667
+ "page background.",
668
+ );
669
+ }
670
+ if (unpairedLight.size > 0) {
671
+ problems.push(
672
+ `Light ramp stops used as text colour with no matching dark fill behind them: ${quote(
673
+ [...unpairedLight],
674
+ )}. ` +
675
+ "Light ramp text on the transparent widget background is invisible in light mode, and in dark " +
676
+ "mode the stop mirrors to the darkest end of its own ramp — invisible there too. " +
677
+ "Ramp-coloured text has to sit on a matching dark ramp " +
678
+ "fill (a 700–950 stop of the same palette) set on the same element, in the same style rule, or " +
679
+ "on the group immediately around it — or use a --content-* token for text that sits on the " +
680
+ "page background.",
681
+ );
682
+ }
683
+
684
+ return problems;
685
+ }
686
+
687
+ function collectDeclaredProperties(html: string): Set<string> {
688
+ const declared = new Set<string>();
689
+ for (const match of html.matchAll(CUSTOM_PROPERTY_DECLARATION_PATTERN)) {
690
+ declared.add(match[1]);
691
+ }
692
+ for (const match of html.matchAll(SET_PROPERTY_DECLARATION_PATTERN)) {
693
+ declared.add(match[1]);
694
+ }
695
+ return declared;
696
+ }
697
+
698
+ function collectUnknownVariables(html: string): string[] {
699
+ const declared = collectDeclaredProperties(html);
700
+ const unknown = new Set<string>();
701
+ for (const match of html.matchAll(VAR_REFERENCE_PATTERN)) {
702
+ const name = match[1];
703
+ if (!WIDGET_TOKEN_NAMES.has(name) && !declared.has(name)) {
704
+ unknown.add(name);
705
+ }
706
+ }
707
+ return [...unknown];
708
+ }
709
+
710
+ function collectColorLiterals(html: string): string[] {
711
+ let scannable = html;
712
+ for (const pattern of NON_COLOR_HASH_PATTERNS) {
713
+ scannable = scannable.replace(pattern, " ");
714
+ }
715
+
716
+ const literals: string[] = [];
717
+ for (const match of scannable.matchAll(HEX_TOKEN_PATTERN)) {
718
+ if (HEX_COLOR_LENGTHS.has(match[1].length)) {
719
+ literals.push(match[0]);
720
+ }
721
+ }
722
+ for (const match of scannable.matchAll(FUNCTIONAL_COLOR_PATTERN)) {
723
+ literals.push(match[0]);
724
+ }
725
+ return literals;
726
+ }
727
+
728
+ function quote(values: string[]): string {
729
+ const shown = values.slice(0, MAX_QUOTED_PROBLEMS).join(", ");
730
+ const extra = values.length - MAX_QUOTED_PROBLEMS;
731
+ return extra > 0 ? `${shown}, and ${extra} more` : shown;
732
+ }
733
+
734
+ /**
735
+ * Everything wrong with a `visual` fragment, as a list of problems the model
736
+ * can fix in one pass. Empty means the fragment is renderable.
737
+ */
738
+ export function validateVisualHtml(html: string): string[] {
739
+ const problems: string[] = [];
740
+
741
+ if (html.length > MAX_HTML_CHARS) {
742
+ problems.push(
743
+ `The fragment is ${html.length} characters, over the ${MAX_HTML_CHARS} limit. ` +
744
+ "A fragment this size cannot be emitted in one call. Simplify it: cut nodes, drop subtitles, remove decorative markup, or split the idea across two visuals with prose between them.",
745
+ );
746
+ }
747
+
748
+ for (const { pattern, what } of EXTERNAL_RESOURCE_PATTERNS) {
749
+ if (pattern.test(html)) {
750
+ problems.push(
751
+ `The fragment contains ${what}. The sandbox has no network access, so external resources never load. ` +
752
+ "Inline the styles and draw charts and diagrams by hand in SVG.",
753
+ );
754
+ }
755
+ }
756
+
757
+ const unknown = collectUnknownVariables(html);
758
+ if (unknown.length > 0) {
759
+ problems.push(
760
+ `Undefined CSS variables: ${quote(
761
+ unknown,
762
+ )}. Only the injected design tokens exist inside the ` +
763
+ "frame — every other name resolves to nothing and the declaration is dropped. " +
764
+ `The vocabulary is ${TOKEN_FAMILY_SUMMARY}. ` +
765
+ "To use a variable of your own, declare it in the fragment's own style block first.",
766
+ );
767
+ }
768
+
769
+ const literals = collectColorLiterals(html);
770
+ if (literals.length > 0) {
771
+ problems.push(
772
+ `Hardcoded colour values: ${quote(
773
+ literals,
774
+ )}. Every colour — text, background, border, SVG ` +
775
+ "fill and stroke — comes from an injected variable, so the visual follows the user's theme. " +
776
+ `Replace each literal with a token from ${TOKEN_FAMILY_SUMMARY}.`,
777
+ );
778
+ }
779
+
780
+ problems.push(...collectSvgSizingProblems(html));
781
+ problems.push(...collectViewBoxOverrunProblems(html));
782
+ problems.push(...collectRampContrastProblems(html));
783
+ problems.push(...collectTransformProblems(html));
784
+ problems.push(...collectSurfaceFillOnTextProblems(html));
785
+
786
+ return problems;
787
+ }