@vellumai/assistant 0.11.4 → 0.11.5-dev.202608220019.a778cf0

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 (457) hide show
  1. package/AGENTS.md +6 -2
  2. package/ARCHITECTURE.md +29 -4
  3. package/README.md +1 -1
  4. package/docs/architecture/memory.md +17 -5
  5. package/docs/architecture/security.md +96 -152
  6. package/docs/guardian-request-flow.md +13 -2
  7. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/package.json +1 -0
  8. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +118 -0
  9. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/__tests__/url-normalization.test.ts +135 -0
  10. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
  11. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/ingress.ts +103 -0
  12. package/node_modules/@vellumai/ces-client/node_modules/@vellumai/service-contracts/src/url-normalization.ts +107 -0
  13. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/package.json +1 -0
  14. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +118 -0
  15. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/__tests__/url-normalization.test.ts +135 -0
  16. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
  17. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/ingress.ts +103 -0
  18. package/node_modules/@vellumai/gateway-client/node_modules/@vellumai/service-contracts/src/url-normalization.ts +107 -0
  19. package/node_modules/@vellumai/gateway-client/src/gateway-ipc-contracts.ts +166 -1
  20. package/node_modules/@vellumai/gateway-client/src/http-delivery.ts +7 -14
  21. package/node_modules/@vellumai/gateway-client/src/index.ts +2 -0
  22. package/node_modules/@vellumai/gateway-client/src/outbound-contract.ts +30 -32
  23. package/node_modules/@vellumai/service-contracts/package.json +1 -0
  24. package/node_modules/@vellumai/service-contracts/src/__tests__/ingress.test.ts +118 -0
  25. package/node_modules/@vellumai/service-contracts/src/__tests__/url-normalization.test.ts +135 -0
  26. package/node_modules/@vellumai/service-contracts/src/index.ts +1 -0
  27. package/node_modules/@vellumai/service-contracts/src/ingress.ts +103 -0
  28. package/node_modules/@vellumai/service-contracts/src/url-normalization.ts +107 -0
  29. package/openapi.yaml +487 -11
  30. package/package.json +1 -1
  31. package/scripts/sync-web-search-catalog.ts +6 -0
  32. package/src/__tests__/anthropic-provider.test.ts +10 -3
  33. package/src/__tests__/approval-interception-trust-gates.test.ts +40 -0
  34. package/src/__tests__/background-workers-disk-pressure.test.ts +1 -1
  35. package/src/__tests__/channel-approval-routes.test.ts +4 -0
  36. package/src/__tests__/channel-inbound-disk-pressure.test.ts +5 -6
  37. package/src/__tests__/channel-readiness-service.test.ts +126 -0
  38. package/src/__tests__/channel-reply-delivery.test.ts +30 -17
  39. package/src/__tests__/checker.test.ts +20 -314
  40. package/src/__tests__/cli-memory-v2-reembed-skills.test.ts +6 -2
  41. package/src/__tests__/client-os-metadata-persistence.test.ts +16 -0
  42. package/src/__tests__/compactor-retained-image-validation.test.ts +142 -0
  43. package/src/__tests__/config-loader-backfill.test.ts +19 -10
  44. package/src/__tests__/container-cpu-sampler.test.ts +153 -0
  45. package/src/__tests__/context-search-memory-v2-source.test.ts +0 -1
  46. package/src/__tests__/conversation-attachments.test.ts +0 -1
  47. package/src/__tests__/conversation-delete-watch-timeline.test.ts +231 -0
  48. package/src/__tests__/conversation-error.test.ts +17 -0
  49. package/src/__tests__/conversation-lifecycle.test.ts +20 -26
  50. package/src/__tests__/conversation-pairing.test.ts +186 -0
  51. package/src/__tests__/conversation-runtime-assembly.test.ts +21 -2
  52. package/src/__tests__/credential-broker-server-use.test.ts +24 -5
  53. package/src/__tests__/credential-routes.test.ts +22 -3
  54. package/src/__tests__/credential-security-invariants.test.ts +2 -1
  55. package/src/__tests__/daemon-credential-client.test.ts +88 -0
  56. package/src/__tests__/default-plugin-names-guard.test.ts +12 -1
  57. package/src/__tests__/dm-backfill.test.ts +63 -0
  58. package/src/__tests__/dynamic-skill-background-guard.test.ts +0 -2
  59. package/src/__tests__/edit-propagation.test.ts +107 -4
  60. package/src/__tests__/events-client-registration.test.ts +28 -0
  61. package/src/__tests__/file-write-tool.test.ts +4 -2
  62. package/src/__tests__/guardian-prompt-notice-privacy.test.ts +133 -0
  63. package/src/__tests__/guardian-verify-setup-skill-regression.test.ts +143 -97
  64. package/src/__tests__/helpers/gateway-classify-mock.ts +27 -6
  65. package/src/__tests__/host-proxy-interface.test.ts +11 -1
  66. package/src/__tests__/host-shell-tool.test.ts +23 -4
  67. package/src/__tests__/image-conversion.test.ts +143 -1
  68. package/src/__tests__/inline-skill-load-permissions.test.ts +47 -36
  69. package/src/__tests__/input-repairs.test.ts +207 -0
  70. package/src/__tests__/live-workspace-guard.test.ts +75 -0
  71. package/src/__tests__/managed-profile-guard.test.ts +4 -2
  72. package/src/__tests__/mcp-abort-signal.test.ts +1 -1
  73. package/src/__tests__/mcp-client-auth.test.ts +1 -1
  74. package/src/__tests__/mcp-tool-annotations-risk.test.ts +1 -1
  75. package/src/__tests__/media-resolve-image-validation.test.ts +310 -0
  76. package/src/__tests__/mtime-cache.test.ts +2 -0
  77. package/src/__tests__/notification-vellum-adapter.test.ts +124 -1
  78. package/src/__tests__/openai-provider.test.ts +40 -0
  79. package/src/__tests__/openai-responses-provider.test.ts +18 -0
  80. package/src/__tests__/personal-memory-auth-bypass.test.ts +22 -6
  81. package/src/__tests__/platform-bash-auto-approve.test.ts +0 -4
  82. package/src/__tests__/platform.test.ts +16 -1
  83. package/src/__tests__/plugin-api-resolve-credential.test.ts +22 -13
  84. package/src/__tests__/plugin-api-shim.test.ts +5 -0
  85. package/src/__tests__/plugin-api-store-credential.test.ts +268 -0
  86. package/src/__tests__/plugin-config-data-migration.test.ts +8 -1
  87. package/src/__tests__/plugin-disabled-state.test.ts +2 -0
  88. package/src/__tests__/plugin-effective-enabled-set.test.ts +55 -3
  89. package/src/__tests__/plugin-execution-context.test.ts +73 -0
  90. package/src/__tests__/plugin-import-boundary-guard.test.ts +0 -1
  91. package/src/__tests__/plugin-import-boundary-reverse-guard.test.ts +0 -1
  92. package/src/__tests__/reaction-persistence.test.ts +200 -7
  93. package/src/__tests__/require-fresh-approval.test.ts +0 -4
  94. package/src/__tests__/resource-pressure-guard.test.ts +428 -0
  95. package/src/__tests__/resource-pressure-routes.test.ts +113 -0
  96. package/src/__tests__/risk-classification-boundary-guard.test.ts +115 -0
  97. package/src/__tests__/run-conversation-turn-persistence.test.ts +27 -1
  98. package/src/__tests__/sanitize-config-for-transfer.test.ts +28 -0
  99. package/src/__tests__/secret-routes-platform-proxy.test.ts +7 -0
  100. package/src/__tests__/settings-routes.test.ts +85 -3
  101. package/src/__tests__/skill-tool-factory.test.ts +161 -0
  102. package/src/__tests__/tool-execution-pipeline.benchmark.test.ts +1 -1
  103. package/src/__tests__/tool-executor-lifecycle-events.test.ts +132 -5
  104. package/src/__tests__/tool-executor.test.ts +63 -38
  105. package/src/__tests__/tool-policy.test.ts +97 -1
  106. package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +7 -4
  107. package/src/__tests__/user-plugin-loader.test.ts +2 -0
  108. package/src/__tests__/validate-input.test.ts +243 -7
  109. package/src/__tests__/verification-control-plane-policy.test.ts +0 -2
  110. package/src/__tests__/voice-scoped-grant-consumer.test.ts +2 -0
  111. package/src/__tests__/voice-session-bridge.test.ts +42 -0
  112. package/src/__tests__/web-search-catalog-parity.test.ts +8 -0
  113. package/src/acp/__tests__/acp-claude-oauth.test.ts +97 -29
  114. package/src/acp/__tests__/prepare-agent-env.test.ts +376 -153
  115. package/src/acp/acp-claude-oauth.ts +38 -21
  116. package/src/acp/prepare-agent-env.ts +146 -55
  117. package/src/agent/loop-tool-dedup.test.ts +161 -0
  118. package/src/agent/loop.ts +68 -22
  119. package/src/api/constants/app-tools.ts +34 -0
  120. package/src/api/constants/profile-config-validation.ts +60 -0
  121. package/src/api/events/resource-pressure-status-changed.ts +53 -0
  122. package/src/api/events/tool-result.ts +6 -1
  123. package/src/api/events/watch-retro-completed.ts +52 -0
  124. package/src/api/index.ts +30 -0
  125. package/src/api/responses/resource-pressure-status.ts +25 -0
  126. package/src/approvals/guardian-channel-delivery.ts +70 -6
  127. package/src/approvals/guardian-request-resolvers.ts +32 -66
  128. package/src/calls/__tests__/voice-session-bridge.test.ts +114 -0
  129. package/src/calls/voice-session-bridge.ts +60 -6
  130. package/src/channels/__tests__/message-audience.test.ts +49 -0
  131. package/src/channels/__tests__/types.test.ts +17 -3
  132. package/src/channels/message-audience.ts +40 -0
  133. package/src/channels/types.ts +16 -12
  134. package/src/cli/__tests__/catalog-search-help.test.ts +50 -0
  135. package/src/cli/commands/__tests__/channel-verification-sessions.test.ts +31 -0
  136. package/src/cli/commands/__tests__/conversations-search.test.ts +289 -0
  137. package/src/cli/commands/__tests__/conversations-slack.test.ts +2 -1
  138. package/src/cli/commands/__tests__/inference-profiles.test.ts +16 -4
  139. package/src/cli/commands/__tests__/inference-providers.test.ts +135 -2
  140. package/src/cli/commands/__tests__/keys.test.ts +89 -8
  141. package/src/cli/commands/__tests__/plugins.test.ts +57 -1
  142. package/src/cli/commands/channel-verification-sessions.help.ts +11 -9
  143. package/src/cli/commands/channel-verification-sessions.ts +11 -21
  144. package/src/cli/commands/conversations.help.ts +34 -0
  145. package/src/cli/commands/conversations.ts +125 -0
  146. package/src/cli/commands/inference-profiles.ts +56 -3
  147. package/src/cli/commands/inference-providers.ts +37 -6
  148. package/src/cli/commands/inference.help.ts +9 -4
  149. package/src/cli/commands/keys.help.ts +13 -1
  150. package/src/cli/commands/keys.ts +26 -15
  151. package/src/cli/commands/memory/__tests__/memory-v2.test.ts +57 -7
  152. package/src/cli/commands/memory/index.help.ts +41 -27
  153. package/src/cli/commands/memory/index.ts +2 -0
  154. package/src/cli/commands/memory/memory-v2.ts +58 -54
  155. package/src/cli/commands/memory/memory-validate.ts +18 -0
  156. package/src/cli/commands/monitoring.ts +1 -0
  157. package/src/cli/commands/oauth/request.test.ts +93 -0
  158. package/src/cli/commands/oauth/request.ts +23 -9
  159. package/src/cli/commands/plugins.help.ts +28 -31
  160. package/src/cli/commands/plugins.ts +10 -0
  161. package/src/cli/commands/skills.help.ts +13 -16
  162. package/src/cli/commands/trust.ts +3 -14
  163. package/src/cli/lib/__tests__/install-from-github.test.ts +38 -0
  164. package/src/cli/lib/__tests__/merge-plugin-tree.test.ts +34 -0
  165. package/src/cli/lib/__tests__/plugin-surfaces.test.ts +32 -1
  166. package/src/cli/lib/__tests__/toggle-plugin.test.ts +2 -1
  167. package/src/cli/lib/__tests__/upgrade-plugin.test.ts +64 -0
  168. package/src/cli/lib/bundled-marketplace.json +26 -0
  169. package/src/cli/lib/daemon-credential-client.ts +25 -3
  170. package/src/cli/lib/install-from-github.ts +35 -24
  171. package/src/cli/lib/merge-plugin-tree.ts +22 -4
  172. package/src/cli/lib/open-browser.test.ts +67 -0
  173. package/src/cli/lib/open-browser.ts +24 -5
  174. package/src/cli/lib/plugin-surfaces.ts +27 -0
  175. package/src/config/__tests__/balanced-model-experiment.test.ts +7 -7
  176. package/src/config/__tests__/default-profile-catalog.test.ts +3 -3
  177. package/src/config/__tests__/profile-materialization.test.ts +26 -0
  178. package/src/config/default-profile-catalog.ts +5 -6
  179. package/src/config/feature-flag-registry.json +36 -28
  180. package/src/config/profile-materialization.ts +29 -0
  181. package/src/config/sanitize-for-transfer.ts +16 -0
  182. package/src/config/schemas/llm.ts +7 -0
  183. package/src/config/schemas/services.ts +6 -0
  184. package/src/config/webhook-routing.ts +8 -0
  185. package/src/context/compactor.ts +31 -2
  186. package/src/context/outbound-sanitize.ts +6 -0
  187. package/src/daemon/__tests__/lifecycle-watch-timeline-sweep.test.ts +98 -0
  188. package/src/daemon/__tests__/provider-rejection-log-fields.test.ts +272 -0
  189. package/src/daemon/conversation-agent-loop-handlers.ts +4 -1
  190. package/src/daemon/conversation-error.ts +19 -2
  191. package/src/daemon/conversation-messaging.ts +22 -2
  192. package/src/daemon/conversation-process.ts +11 -0
  193. package/src/daemon/conversation-store.ts +10 -0
  194. package/src/daemon/conversation-surfaces.ts +21 -8
  195. package/src/daemon/conversation.ts +12 -10
  196. package/src/daemon/daemon-control.ts +1 -0
  197. package/src/daemon/handlers/__tests__/config-ingress-tunnel-records.test.ts +208 -0
  198. package/src/daemon/handlers/config-ingress.ts +115 -5
  199. package/src/daemon/lifecycle.ts +30 -2
  200. package/src/daemon/message-types/conversations.ts +5 -7
  201. package/src/daemon/message-types/web-activity.ts +3 -2
  202. package/src/daemon/provider-rejection-log-fields.ts +124 -0
  203. package/src/daemon/resource-pressure-guard-lifecycle.ts +66 -0
  204. package/src/daemon/resource-pressure-guard.ts +387 -0
  205. package/src/daemon/shutdown-handlers.ts +2 -0
  206. package/src/daemon/startup-error.ts +16 -0
  207. package/src/daemon/trust-context.ts +14 -10
  208. package/src/daemon/unsendable-image-notice.ts +76 -0
  209. package/src/hooks/registry.ts +65 -51
  210. package/src/inbound/__tests__/tunnel-probe.test.ts +448 -0
  211. package/src/inbound/tunnel-probe.ts +261 -0
  212. package/src/ipc/__tests__/socket-path.test.ts +15 -7
  213. package/src/ipc/gateway-client.test.ts +1 -1
  214. package/src/ipc/gateway-client.ts +14 -21
  215. package/src/ipc/socket-cleanup.ts +2 -11
  216. package/src/mcp/__tests__/mcp-auth-orchestrator.test.ts +1 -1
  217. package/src/messaging/provider-message-metadata.ts +128 -0
  218. package/src/messaging/providers/__tests__/transport-dispatch.test.ts +138 -73
  219. package/src/messaging/providers/channel-transport.ts +100 -16
  220. package/src/messaging/providers/discord/send.ts +16 -0
  221. package/src/messaging/providers/discord/transport.ts +23 -1
  222. package/src/messaging/providers/index.ts +84 -16
  223. package/src/messaging/providers/slack/message-metadata.ts +45 -0
  224. package/src/messaging/providers/slack/render-transcript.ts +1 -4
  225. package/src/messaging/providers/slack/send.test.ts +88 -34
  226. package/src/messaging/providers/slack/send.ts +99 -50
  227. package/src/messaging/providers/slack/transport.ts +35 -37
  228. package/src/messaging/providers/telegram-bot/send.test.ts +88 -18
  229. package/src/messaging/providers/telegram-bot/send.ts +36 -0
  230. package/src/messaging/providers/telegram-bot/transport.ts +22 -8
  231. package/src/messaging/read-provider-metadata.test.ts +157 -0
  232. package/src/messaging/read-provider-metadata.ts +51 -0
  233. package/src/notifications/__tests__/assistant-reply-producer.test.ts +94 -0
  234. package/src/notifications/__tests__/edit-notification.test.ts +174 -2
  235. package/src/notifications/__tests__/home-feed-side-effect.test.ts +536 -4
  236. package/src/notifications/adapters/macos.ts +55 -0
  237. package/src/notifications/adapters/slack.ts +10 -5
  238. package/src/notifications/assistant-reply-producer.ts +37 -4
  239. package/src/notifications/conversation-pairing.ts +111 -21
  240. package/src/notifications/edit-notification.ts +38 -8
  241. package/src/notifications/emit-signal.ts +12 -14
  242. package/src/notifications/home-feed-side-effect.ts +218 -15
  243. package/src/notifications/types.ts +5 -0
  244. package/src/permissions/AGENTS.md +16 -0
  245. package/src/permissions/checker.test.ts +75 -122
  246. package/src/permissions/checker.ts +44 -560
  247. package/src/permissions/confirmation-guardian-request.test.ts +28 -3
  248. package/src/permissions/confirmation-guardian-request.ts +5 -1
  249. package/src/persistence/conversation-crud.ts +69 -20
  250. package/src/persistence/conversation-queries.ts +14 -1
  251. package/src/persistence/conversation-types.ts +22 -0
  252. package/src/persistence/db-async-query.ts +2 -1
  253. package/src/persistence/db-maintenance.ts +15 -0
  254. package/src/persistence/delivery-crud.ts +122 -15
  255. package/src/persistence/embeddings/qdrant-manager.ts +1 -0
  256. package/src/persistence/migrations/367-create-watch-timeline-entries.ts +46 -0
  257. package/src/persistence/migrations/368-watch-timeline-screenshot-blob.ts +33 -0
  258. package/src/persistence/migrations/__tests__/367-create-watch-timeline-entries.test.ts +98 -0
  259. package/src/persistence/migrations/__tests__/368-watch-timeline-screenshot-blob.test.ts +98 -0
  260. package/src/persistence/schema/index.ts +1 -0
  261. package/src/persistence/schema/watch.ts +29 -0
  262. package/src/persistence/steps.ts +4 -0
  263. package/src/plugin-api/__tests__/import-graph-partial-mock.test.ts +67 -0
  264. package/src/plugin-api/conversation-turn.ts +27 -0
  265. package/src/plugin-api/credential-scope.test.ts +15 -0
  266. package/src/plugin-api/credential-scope.ts +14 -0
  267. package/src/plugin-api/index.ts +19 -1
  268. package/src/plugin-api/resolve-credential.ts +15 -10
  269. package/src/plugin-api/store-credential.ts +148 -0
  270. package/src/plugin-api/system-card.ts +36 -0
  271. package/src/plugin-api/vision-support.test.ts +82 -0
  272. package/src/plugin-api/vision-support.ts +14 -2
  273. package/src/plugins/defaults/image-fallback/__tests__/image-fallback.test.ts +361 -110
  274. package/src/plugins/defaults/image-fallback/__tests__/vision-recovery.test.ts +4 -0
  275. package/src/plugins/defaults/image-fallback/hooks/user-prompt-submit.ts +58 -0
  276. package/src/plugins/defaults/image-fallback/src/caption-blocks.ts +64 -23
  277. package/src/plugins/defaults/image-recovery/detect.ts +24 -1
  278. package/src/plugins/defaults/main.ts +15 -0
  279. package/src/plugins/defaults/memory/AGENTS.md +11 -3
  280. package/src/plugins/defaults/memory/__tests__/memory-tier-boundary-guard.test.ts +0 -1
  281. package/src/plugins/defaults/memory/graph-topology/pending-buffer.ts +9 -12
  282. package/src/plugins/defaults/memory/memory-retrospective-prompt.ts +1 -1
  283. package/src/plugins/defaults/memory/src/memory-v2-routes.ts +12 -10
  284. package/src/plugins/defaults/memory/substrate/__tests__/consolidation-job.test.ts +114 -0
  285. package/src/plugins/defaults/memory/substrate/__tests__/consolidation-prompt-flag-gating-guard.test.ts +8 -0
  286. package/src/plugins/defaults/memory/substrate/__tests__/edge-index.test.ts +0 -30
  287. package/src/plugins/defaults/memory/substrate/__tests__/ingest.test.ts +73 -1
  288. package/src/plugins/defaults/memory/substrate/__tests__/page-index.test.ts +37 -0
  289. package/src/plugins/defaults/memory/substrate/__tests__/page-links.test.ts +208 -0
  290. package/src/plugins/defaults/memory/substrate/__tests__/prompts-consolidation.test.ts +158 -1
  291. package/src/plugins/defaults/memory/substrate/__tests__/static-context.test.ts +1 -61
  292. package/src/plugins/defaults/memory/substrate/consolidation-job.ts +68 -6
  293. package/src/plugins/defaults/memory/substrate/edge-index.ts +0 -31
  294. package/src/plugins/defaults/memory/substrate/ingest.ts +59 -0
  295. package/src/plugins/defaults/memory/substrate/page-index.ts +35 -8
  296. package/src/plugins/defaults/memory/substrate/page-links.ts +133 -0
  297. package/src/plugins/defaults/memory/substrate/page-store.ts +10 -0
  298. package/src/plugins/defaults/memory/substrate/prompts/consolidation.ts +124 -34
  299. package/src/plugins/defaults/memory/substrate/static-context.ts +0 -29
  300. package/src/plugins/defaults/memory/v3/__tests__/shadow-plugin.test.ts +3 -1
  301. package/src/plugins/defaults/memory/v3/card.ts +9 -9
  302. package/src/plugins/defaults/memory/v3/core-set.test.ts +7 -0
  303. package/src/plugins/defaults/memory/v3/core-set.ts +5 -1
  304. package/src/plugins/defaults/memory/v3/edge.ts +13 -57
  305. package/src/plugins/mtime-cache.ts +1 -1
  306. package/src/plugins/pipeline.ts +14 -7
  307. package/src/plugins/plugin-execution-context.ts +35 -11
  308. package/src/plugins/plugin-tree-walk.ts +63 -4
  309. package/src/providers/__tests__/retry-network-error.test.ts +84 -0
  310. package/src/providers/anthropic/__tests__/pause-turn-continuation.test.ts +170 -0
  311. package/src/providers/anthropic/client.ts +332 -241
  312. package/src/providers/connection-resolution.ts +25 -2
  313. package/src/providers/content-blocks.ts +22 -0
  314. package/src/providers/fetch-provider-catalog.ts +19 -0
  315. package/src/providers/gemini/client.ts +5 -2
  316. package/src/providers/inference/__tests__/adapter-factory-litellm.test.ts +47 -1
  317. package/src/providers/inference/__tests__/adapter-factory-ollama.test.ts +83 -0
  318. package/src/providers/inference/__tests__/adapter-factory-openai-compatible.test.ts +98 -1
  319. package/src/providers/inference/__tests__/base-url-route-validation.test.ts +38 -0
  320. package/src/providers/inference/__tests__/base-url-security.test.ts +10 -0
  321. package/src/providers/inference/__tests__/connections-ollama.test.ts +90 -0
  322. package/src/providers/inference/__tests__/endpoint-probe.test.ts +92 -0
  323. package/src/providers/inference/__tests__/missing-credential-guard.test.ts +117 -0
  324. package/src/providers/inference/__tests__/profile-config-validation.test.ts +39 -0
  325. package/src/providers/inference/__tests__/profile-probe-classify.test.ts +66 -0
  326. package/src/providers/inference/adapter-factory.ts +33 -2
  327. package/src/providers/inference/auth.ts +13 -2
  328. package/src/providers/inference/credential-usage.ts +37 -0
  329. package/src/providers/inference/endpoint-probe.ts +115 -0
  330. package/src/providers/inference/missing-credential-guard.ts +110 -0
  331. package/src/providers/inference/profile-probe.ts +256 -0
  332. package/src/providers/inference/resolve-auth.ts +7 -7
  333. package/src/providers/media-resolve.ts +176 -15
  334. package/src/providers/model-catalog.ts +10 -0
  335. package/src/providers/openai/__tests__/api-error-normalization.test.ts +17 -1
  336. package/src/providers/openai/__tests__/chat-completions-provider-reasoning.test.ts +576 -46
  337. package/src/providers/openai/__tests__/connection-error-wrap.test.ts +44 -0
  338. package/src/providers/openai/__tests__/tool-choice-mapping.test.ts +125 -2
  339. package/src/providers/openai/api-error-normalization.ts +16 -2
  340. package/src/providers/openai/chat-completions-provider.ts +326 -44
  341. package/src/providers/openai/responses-provider.ts +5 -2
  342. package/src/providers/provider-send-message.ts +11 -0
  343. package/src/providers/retry.ts +6 -0
  344. package/src/providers/search-provider-catalog.ts +20 -0
  345. package/src/routes/route-host-protocol.ts +7 -0
  346. package/src/routes/worker.ts +31 -10
  347. package/src/runtime/AGENTS.md +36 -0
  348. package/src/runtime/__tests__/host-observe.test.ts +302 -0
  349. package/src/runtime/__tests__/runtime-http-port-collision.test.ts +131 -0
  350. package/src/runtime/__tests__/web-presence.test.ts +234 -0
  351. package/src/runtime/assistant-event-hub.ts +38 -0
  352. package/src/runtime/channel-readiness-service.ts +39 -13
  353. package/src/runtime/channel-readiness-types.ts +49 -2
  354. package/src/runtime/channel-reply-delivery.ts +55 -32
  355. package/src/runtime/channel-retry-sweep.ts +6 -4
  356. package/src/runtime/effective-capabilities.test.ts +19 -0
  357. package/src/runtime/effective-capabilities.ts +25 -0
  358. package/src/runtime/guardian-reply-router.ts +6 -2
  359. package/src/runtime/host-observe.ts +246 -0
  360. package/src/runtime/http-errors.ts +1 -0
  361. package/src/runtime/http-server.ts +185 -6
  362. package/src/runtime/routes/__tests__/client-routes.test.ts +150 -0
  363. package/src/runtime/routes/__tests__/conversation-list-routes.test.ts +133 -0
  364. package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +80 -0
  365. package/src/runtime/routes/__tests__/credential-delete-in-use.test.ts +155 -0
  366. package/src/runtime/routes/__tests__/inference-profiles-routes.test.ts +118 -0
  367. package/src/runtime/routes/__tests__/inference-provider-connection-routes.test.ts +72 -1
  368. package/src/runtime/routes/__tests__/ingress-status-routes.test.ts +508 -0
  369. package/src/runtime/routes/__tests__/monitoring-routes.test.ts +1 -0
  370. package/src/runtime/routes/__tests__/pending-interactions-route.test.ts +175 -0
  371. package/src/runtime/routes/__tests__/plugins-routes.test.ts +103 -71
  372. package/src/runtime/routes/__tests__/surface-action-routes.test.ts +55 -6
  373. package/src/runtime/routes/__tests__/system-card-turn-termination.test.ts +107 -0
  374. package/src/runtime/routes/__tests__/user-route-dispatcher-host.test.ts +52 -1
  375. package/src/runtime/routes/__tests__/user-route-dispatcher.test.ts +75 -4
  376. package/src/runtime/routes/__tests__/watch-routes-guardian-cache.test.ts +139 -0
  377. package/src/runtime/routes/__tests__/watch-routes.test.ts +598 -0
  378. package/src/runtime/routes/approval-routes.ts +37 -4
  379. package/src/runtime/routes/approval-strategies/guardian-text-engine-strategy.ts +16 -22
  380. package/src/runtime/routes/canned-message-complete.ts +68 -29
  381. package/src/runtime/routes/channel-readiness-routes.ts +14 -2
  382. package/src/runtime/routes/client-routes.ts +113 -0
  383. package/src/runtime/routes/conversation-list-routes.ts +22 -7
  384. package/src/runtime/routes/conversation-management-routes.ts +15 -9
  385. package/src/runtime/routes/conversation-query-routes.ts +10 -0
  386. package/src/runtime/routes/conversation-routes.ts +36 -22
  387. package/src/runtime/routes/credential-in-use.ts +85 -0
  388. package/src/runtime/routes/credential-routes.ts +55 -85
  389. package/src/runtime/routes/guardian-approval-interception.ts +44 -53
  390. package/src/runtime/routes/guardian-approval-reply-helpers.ts +14 -12
  391. package/src/runtime/routes/host-cu-routes.ts +18 -0
  392. package/src/runtime/routes/identity-routes.ts +5 -121
  393. package/src/runtime/routes/inbound-message-handler.ts +74 -30
  394. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +16 -17
  395. package/src/runtime/routes/inbound-stages/background-dispatch.test.ts +182 -297
  396. package/src/runtime/routes/inbound-stages/background-dispatch.ts +173 -386
  397. package/src/runtime/routes/inbound-stages/edit-intercept.ts +101 -77
  398. package/src/runtime/routes/inbound-stages/guardian-reply-intercept.ts +17 -8
  399. package/src/runtime/routes/inbound-stages/reaction-intercept.test.ts +91 -7
  400. package/src/runtime/routes/inbound-stages/reaction-intercept.ts +72 -70
  401. package/src/runtime/routes/index.ts +4 -0
  402. package/src/runtime/routes/inference-profiles-routes.ts +232 -31
  403. package/src/runtime/routes/inference-provider-connection-routes.ts +33 -11
  404. package/src/runtime/routes/ingress-status-routes.ts +180 -0
  405. package/src/runtime/routes/monitoring-routes.ts +9 -1
  406. package/src/runtime/routes/oauth-commands-routes.ts +1 -1
  407. package/src/runtime/routes/plugins-routes.ts +28 -32
  408. package/src/runtime/routes/resource-pressure-routes.ts +22 -0
  409. package/src/runtime/routes/secret-routes.ts +39 -8
  410. package/src/runtime/routes/settings-routes.ts +15 -12
  411. package/src/runtime/routes/surface-action-routes.ts +20 -19
  412. package/src/runtime/routes/user-route-dispatcher.ts +31 -2
  413. package/src/runtime/routes/user-route-resolution.ts +18 -1
  414. package/src/runtime/routes/watch-routes.ts +807 -0
  415. package/src/runtime/slack-reply-session.test.ts +23 -13
  416. package/src/runtime/slack-reply-session.ts +38 -55
  417. package/src/runtime/web-presence.ts +90 -0
  418. package/src/security/__tests__/untrusted-content.test.ts +42 -0
  419. package/src/security/untrusted-content.ts +28 -9
  420. package/src/skills/validate-input.ts +177 -40
  421. package/src/subagent/__tests__/consult-context-gating.test.ts +6 -10
  422. package/src/subagent/consult-context.ts +7 -23
  423. package/src/tools/credentials/broker.ts +24 -79
  424. package/src/tools/credentials/ref-parse.ts +35 -0
  425. package/src/tools/credentials/resolve.ts +4 -10
  426. package/src/tools/credentials/store.ts +168 -0
  427. package/src/tools/credentials/tool-policy.ts +67 -0
  428. package/src/tools/executor.ts +53 -15
  429. package/src/tools/network/__tests__/firecrawl-compat.test.ts +77 -0
  430. package/src/tools/network/__tests__/web-fetch-fastcrw.test.ts +169 -0
  431. package/src/tools/network/__tests__/web-search.test.ts +138 -3
  432. package/src/tools/network/firecrawl-compat.ts +90 -0
  433. package/src/tools/network/url-safety.ts +9 -16
  434. package/src/tools/network/web-fetch.ts +142 -62
  435. package/src/tools/network/web-search.ts +162 -58
  436. package/src/tools/permission-checker.ts +43 -52
  437. package/src/tools/schema-transforms.ts +40 -5
  438. package/src/tools/shared/input-repairs.ts +160 -0
  439. package/src/tools/skills/skill-tool-factory.ts +18 -4
  440. package/src/tools/subagent/spawn.ts +0 -1
  441. package/src/tools/tool-approval-handler.ts +16 -10
  442. package/src/tools/tool-types.ts +26 -13
  443. package/src/tools/types.ts +6 -6
  444. package/src/util/__tests__/cgroup-memory.test.ts +3 -0
  445. package/src/util/cgroup-memory.ts +3 -0
  446. package/src/util/container-cpu-sampler.ts +250 -0
  447. package/src/util/image-conversion.ts +178 -14
  448. package/src/util/platform.ts +93 -10
  449. package/src/util/worker-process.ts +1 -0
  450. package/src/watch/__tests__/watch-retro.test.ts +665 -0
  451. package/src/watch/__tests__/watch-session-manager.test.ts +566 -0
  452. package/src/watch/__tests__/watch-timeline.test.ts +670 -0
  453. package/src/watch/watch-retro.ts +480 -0
  454. package/src/watch/watch-session-manager.ts +575 -0
  455. package/src/watch/watch-timeline.ts +848 -0
  456. package/src/permissions/ipc-risk-types.ts +0 -143
  457. package/src/permissions/risk-types.ts +0 -76
@@ -3,6 +3,7 @@
3
3
  * the conversational approval engine when an approvalConversationGenerator is
4
4
  * available. Classifies natural language and responds conversationally.
5
5
  */
6
+ import { audienceForReader } from "../../../channels/message-audience.js";
6
7
  import type { ChannelId } from "../../../channels/types.js";
7
8
  import { getLogger } from "../../../util/logger.js";
8
9
  import { runApprovalConversationTurn } from "../../approval-conversation-turn.js";
@@ -22,17 +23,6 @@ import { deliverStaleApprovalReply } from "../guardian-approval-reply-helpers.js
22
23
 
23
24
  const log = getLogger("runtime-http");
24
25
 
25
- /**
26
- * Resolve the Slack ephemeral user ID when the source channel is Slack.
27
- * Returns `undefined` for non-Slack channels.
28
- */
29
- function slackEphemeralUserId(
30
- sourceChannel: ChannelId,
31
- userId: string | undefined,
32
- ): string | undefined {
33
- return sourceChannel === "slack" && userId ? userId : undefined;
34
- }
35
-
36
26
  export interface TextEngineDecisionParams {
37
27
  conversationId: string;
38
28
  conversationExternalId: string;
@@ -96,11 +86,11 @@ export async function handleGuardianTextEngineDecision(
96
86
  text: engineResult.replyText,
97
87
  assistantId,
98
88
  };
99
- const ephemeral = slackEphemeralUserId(sourceChannel, actorExternalId);
100
- if (ephemeral) {
101
- keepPendingPayload.ephemeral = true;
102
- keepPendingPayload.user = ephemeral;
103
- }
89
+ keepPendingPayload.audience = audienceForReader(
90
+ sourceChannel,
91
+ conversationExternalId,
92
+ actorExternalId,
93
+ );
104
94
  await deliverChannelReply(replyCallbackUrl, keepPendingPayload);
105
95
  } catch (err) {
106
96
  log.error(
@@ -131,11 +121,11 @@ export async function handleGuardianTextEngineDecision(
131
121
  text: engineResult.replyText,
132
122
  assistantId,
133
123
  };
134
- const ephemeral = slackEphemeralUserId(sourceChannel, actorExternalId);
135
- if (ephemeral) {
136
- decisionPayload.ephemeral = true;
137
- decisionPayload.user = ephemeral;
138
- }
124
+ decisionPayload.audience = audienceForReader(
125
+ sourceChannel,
126
+ conversationExternalId,
127
+ actorExternalId,
128
+ );
139
129
  await deliverChannelReply(replyCallbackUrl, decisionPayload);
140
130
  } catch (err) {
141
131
  log.error(
@@ -160,7 +150,11 @@ export async function handleGuardianTextEngineDecision(
160
150
  logger: log,
161
151
  errorLogMessage: "Failed to deliver stale approval notice",
162
152
  errorLogContext: { conversationId },
163
- ephemeralUserId: slackEphemeralUserId(sourceChannel, actorExternalId),
153
+ audience: audienceForReader(
154
+ sourceChannel,
155
+ conversationExternalId,
156
+ actorExternalId,
157
+ ),
164
158
  });
165
159
 
166
160
  return { handled: true, type: "stale_ignored" };
@@ -3,8 +3,8 @@ import type { AssistantEvent } from "../../api/index.js";
3
3
  import {
4
4
  addMessage,
5
5
  recordConversationPersistedSeq,
6
- SYSTEM_CARD_MESSAGE_KIND,
7
6
  } from "../../persistence/conversation-crud.js";
7
+ import { SYSTEM_CARD_MESSAGE_KIND } from "../../persistence/conversation-types.js";
8
8
  import type { Message } from "../../providers/types.js";
9
9
  import { broadcastMessage } from "../assistant-event-hub.js";
10
10
  import { getCurrentSeq } from "../assistant-stream-state.js";
@@ -40,33 +40,42 @@ export function emitCannedMessageComplete(
40
40
  }
41
41
 
42
42
  /**
43
- * Persist a canned assistant "card" — a pre-composed reply that bypasses the
44
- * agent loop (the /compact, /clean, and summarize-up-to result cards). The
45
- * row is stamped `messageKind: "system_card"` so transcripts render it as a
46
- * standalone system notice instead of assistant-persona speech, and display
47
- * merging never folds it into an adjacent assistant turn.
43
+ * Persist a system card: a daemon-authored notice that bypasses the agent
44
+ * loop. The row is stamped `messageKind: "system_card"` so transcripts render
45
+ * it as a standalone system notice instead of assistant-persona speech, and
46
+ * display merging never folds it into an adjacent assistant turn.
48
47
  *
49
- * Cards are announced with `message_complete` (persisted assistant id), the
50
- * persisted-seq anchor advance (so a stale /messages reseed cannot erase the
51
- * card), and the messages-changed sync invalidation that drives every client
52
- * to refetch. That invalidation carries no origin-client id: the card body
53
- * streams nowhere (`message_complete` is bodyless, no `assistant_text_delta`),
54
- * so the initiating client materializes it only by refetching, and origin
55
- * self-echo suppression (meant for content the origin already rendered) would
56
- * otherwise hide the card from the initiator until a reload. A delta is
57
- * deliberately omitted; it would stream the card into the tail assistant
58
- * bubble as if the persona were speaking.
48
+ * The card is persisted and announced to clients but not appended to the live
49
+ * conversation's working history, so a card written while a turn is in flight
50
+ * cannot leave a trailing assistant message for the next provider call to
51
+ * continue from. Callers whose card ends the turn use
52
+ * {@link persistCannedAssistantCard}, which also seats it in the live history.
59
53
  *
60
- * Returns the persisted card's message id so callers can link related
61
- * records to it (e.g. the compaction `llm_request_logs` row).
54
+ * Every card advances the persisted-seq anchor (so a stale /messages reseed
55
+ * cannot erase it) and publishes the messages-changed sync invalidation that
56
+ * drives every client to refetch. That invalidation carries no origin-client
57
+ * id: the card body streams nowhere (no `assistant_text_delta`), so the
58
+ * initiating client materializes it only by refetching, and origin self-echo
59
+ * suppression (meant for content the origin already rendered) would otherwise
60
+ * hide the card from the initiator until a reload. A delta is deliberately
61
+ * omitted; it would stream the card into the tail assistant bubble as if the
62
+ * persona were speaking.
63
+ *
64
+ * `endsTurn` decides whether the card also emits `message_complete`. Clients
65
+ * treat that event as terminal (it clears the processing state and closes the
66
+ * turn), so only a card that *is* the reply carries it. A card posted while a
67
+ * turn is still running (`endsTurn: false`) rides the sync invalidation alone,
68
+ * leaving the in-flight turn's streaming state intact.
69
+ *
70
+ * Returns the persisted card's id and the in-memory message it persisted.
62
71
  */
63
- export async function persistCannedAssistantCard(opts: {
64
- conversation: { getMessages(): Message[] };
72
+ export async function persistSystemCard(opts: {
65
73
  conversationId: string;
66
74
  text: string;
67
75
  metadata: Record<string, unknown>;
68
- }): Promise<string> {
69
- const { conversation, conversationId, text, metadata } = opts;
76
+ endsTurn: boolean;
77
+ }): Promise<{ id: string; message: Message }> {
78
+ const { conversationId, text, metadata, endsTurn } = opts;
70
79
  const assistantMsg = createAssistantMessage(text);
71
80
  const persistedAssistant = await addMessage(
72
81
  conversationId,
@@ -74,13 +83,43 @@ export async function persistCannedAssistantCard(opts: {
74
83
  JSON.stringify(assistantMsg.content),
75
84
  { metadata: { ...metadata, messageKind: SYSTEM_CARD_MESSAGE_KIND } },
76
85
  );
77
- conversation.getMessages().push(assistantMsg);
78
- emitCannedMessageComplete(
79
- broadcastMessage,
80
- conversationId,
81
- persistedAssistant.id,
82
- );
86
+ if (endsTurn) {
87
+ emitCannedMessageComplete(
88
+ broadcastMessage,
89
+ conversationId,
90
+ persistedAssistant.id,
91
+ );
92
+ }
83
93
  recordConversationPersistedSeq(conversationId, getCurrentSeq());
84
94
  publishConversationMessagesChanged(conversationId);
85
- return persistedAssistant.id;
95
+ return { id: persistedAssistant.id, message: assistantMsg };
96
+ }
97
+
98
+ /**
99
+ * Persist a canned assistant "card" (a pre-composed reply that bypasses the
100
+ * agent loop: the /compact, /clean, and summarize-up-to result cards) and
101
+ * seat it in the live conversation's history so the turn that follows sees it.
102
+ * The row is stamped `messageKind: "system_card"` so transcripts render it as a
103
+ * standalone system notice instead of assistant-persona speech, and display
104
+ * merging never folds it into an adjacent assistant turn. Delivery is
105
+ * {@link persistSystemCard}'s.
106
+ *
107
+ * Returns the persisted card's message id so callers can link related
108
+ * records to it (e.g. the compaction `llm_request_logs` row).
109
+ */
110
+ export async function persistCannedAssistantCard(opts: {
111
+ conversation: { getMessages(): Message[] };
112
+ conversationId: string;
113
+ text: string;
114
+ metadata: Record<string, unknown>;
115
+ }): Promise<string> {
116
+ const { conversation, conversationId, text, metadata } = opts;
117
+ const card = await persistSystemCard({
118
+ conversationId,
119
+ text,
120
+ metadata,
121
+ endsTurn: true,
122
+ });
123
+ conversation.getMessages().push(card.message);
124
+ return card.id;
86
125
  }
@@ -14,6 +14,11 @@ import {
14
14
  getInviteAdapterRegistry,
15
15
  resolveAdapterHandle,
16
16
  } from "../channel-invite-transport.js";
17
+ import {
18
+ CHANNEL_HEALTHS,
19
+ CHECK_KINDS,
20
+ SETUP_STATUSES,
21
+ } from "../channel-readiness-types.js";
17
22
  import type { RouteDefinition, RouteHandlerArgs } from "./types.js";
18
23
 
19
24
  async function enrichSnapshots(
@@ -32,6 +37,7 @@ async function enrichSnapshots(
32
37
  channel: s.channel,
33
38
  ready: s.ready,
34
39
  setupStatus: s.setupStatus,
40
+ health: s.health,
35
41
  checkedAt: s.checkedAt,
36
42
  stale: s.stale,
37
43
  reasons: s.reasons,
@@ -89,15 +95,21 @@ const readinessCheckSchema = z.object({
89
95
  name: z.string(),
90
96
  passed: z.boolean(),
91
97
  message: z.string().nullable().optional(),
98
+ // `passed` alone cannot say "I could not tell", and dropping this at the
99
+ // boundary is why a client cannot distinguish a channel that is broken from
100
+ // one whose state could not be established.
101
+ indeterminate: z.boolean().optional(),
102
+ kind: z.enum(CHECK_KINDS).optional(),
92
103
  });
93
104
 
94
105
  const readinessSnapshotSchema = z.object({
95
106
  channel: z.enum(CHANNEL_IDS),
96
107
  ready: z.boolean(),
97
- setupStatus: z.string().nullable().optional(),
108
+ setupStatus: z.enum(SETUP_STATUSES).nullable().optional(),
109
+ health: z.enum(CHANNEL_HEALTHS).optional(),
98
110
  checkedAt: z.number().nullable().optional(),
99
111
  stale: z.boolean().optional(),
100
- reasons: z.array(z.string()).optional(),
112
+ reasons: z.array(z.object({ code: z.string(), text: z.string() })).optional(),
101
113
  localChecks: z.array(readinessCheckSchema).optional(),
102
114
  remoteChecks: z.array(readinessCheckSchema).optional(),
103
115
  channelHandle: z.string().nullable().optional(),
@@ -37,6 +37,23 @@ const PresenceBodySchema = z.object({
37
37
  .describe("Reported desktop presence state."),
38
38
  });
39
39
 
40
+ /**
41
+ * Body of `POST /v1/clients/web-presence`, declared as the route's
42
+ * `requestBody` and parsed by the handler, so the OpenAPI contract and the
43
+ * runtime check are one schema rather than two hand-kept copies.
44
+ */
45
+ const WebPresenceBodySchema = z.object({
46
+ visible: z
47
+ .boolean()
48
+ .describe("Whether the reporting tab is currently visible."),
49
+ focusedConversationId: z
50
+ .string()
51
+ .nullable()
52
+ .describe(
53
+ "The conversation currently focused (chat composer on screen) in the tab, or null.",
54
+ ),
55
+ });
56
+
40
57
  export const ROUTES: RouteDefinition[] = [
41
58
  {
42
59
  operationId: "list_clients",
@@ -228,4 +245,100 @@ export const ROUTES: RouteDefinition[] = [
228
245
  return { recorded: true };
229
246
  },
230
247
  },
248
+ {
249
+ operationId: "report_web_presence",
250
+ endpoint: "clients/web-presence",
251
+ method: "POST",
252
+ policy: {
253
+ requiredScopes: ["settings.write"],
254
+ allowedPrincipalTypes: ACTOR_PRINCIPALS,
255
+ },
256
+ summary: "Report web tab visibility and focused conversation",
257
+ description:
258
+ "Record the visibility and focused conversation reported by the web client identified by the X-Vellum-Client-Id header.",
259
+ tags: ["clients"],
260
+ requestBody: WebPresenceBodySchema,
261
+ responseBody: z.object({
262
+ recorded: z
263
+ .boolean()
264
+ .describe("Whether a connected client matched the reporting clientId."),
265
+ }),
266
+ handler: ({ body, headers }) => {
267
+ const clientId = headers?.["x-vellum-client-id"]?.trim();
268
+ if (!clientId) {
269
+ throw new BadRequestError(
270
+ "x-vellum-client-id header is required to report presence.",
271
+ );
272
+ }
273
+ const { visible, focusedConversationId } = parseBody(
274
+ WebPresenceBodySchema,
275
+ body,
276
+ );
277
+
278
+ // Resolving the client first separates "nobody is listening" from
279
+ // "somebody else owns this", so only the second one is worth a warn.
280
+ const client = assistantEventHub.getClientById(clientId);
281
+ if (!client) {
282
+ // Debug, not warn: a report racing an SSE reconnect matches nothing,
283
+ // and a reconnect storm would otherwise emit a warn per client for a
284
+ // benign race. Not a 404 either, for the same reason.
285
+ log.debug(
286
+ { op: "report_web_presence" },
287
+ "Web presence report matched no connected client",
288
+ );
289
+ return { recorded: false };
290
+ }
291
+
292
+ // Only the actor that opened the target client's SSE stream may report
293
+ // its presence, so a caller who learns another user's clientId cannot
294
+ // spoof that tab. Clients with no stored `actorPrincipalId` (legacy SSE
295
+ // subscribers, service-gateway tokens) never match: fail-closed, the
296
+ // same posture as `report_client_presence`. Dev-bypass mode
297
+ // (DISABLE_HTTP_AUTH=true) skips the check for platform-managed
298
+ // deployments where the platform handles auth.
299
+ if (!isHttpAuthDisabled()) {
300
+ const callerPrincipalId = headers?.["x-vellum-actor-principal-id"];
301
+ const ownerPrincipalId = client.actorPrincipalId;
302
+ if (
303
+ ownerPrincipalId === undefined ||
304
+ ownerPrincipalId !== callerPrincipalId
305
+ ) {
306
+ // Warn, not debug: the client is connected, so a mismatch means the
307
+ // gateway stopped forwarding the actor header, a scope profile
308
+ // shifted, or a caller is probing someone else's client. Without
309
+ // this line presence gating dies silently and every suppressed
310
+ // push quietly resumes. Client and principal ids stay out of the
311
+ // entry so the log cannot be used to enumerate them.
312
+ log.warn(
313
+ {
314
+ op: "report_web_presence",
315
+ hasStoredOwner: ownerPrincipalId !== undefined,
316
+ hasCallerPrincipal: callerPrincipalId !== undefined,
317
+ targetInterfaceId: client.interfaceId,
318
+ },
319
+ "Rejecting web presence report from a caller that does not own the client",
320
+ );
321
+ // Answering like "no match" keeps the reply from probing client ids.
322
+ return { recorded: false };
323
+ }
324
+ }
325
+
326
+ // The lookup ran in this same synchronous handler, so the write lands on
327
+ // the entry it resolved.
328
+ assistantEventHub.setClientWebPresence(clientId, {
329
+ visible,
330
+ focusedConversationId,
331
+ });
332
+
333
+ log.debug(
334
+ {
335
+ op: "report_web_presence",
336
+ visible,
337
+ interfaceId: client.interfaceId,
338
+ },
339
+ "Recorded web presence",
340
+ );
341
+ return { recorded: true };
342
+ },
343
+ },
231
344
  ];
@@ -269,12 +269,18 @@ function handleListConversations({ queryParams = {} }: RouteHandlerArgs) {
269
269
  ? true
270
270
  : undefined;
271
271
 
272
+ const foregroundOnly =
273
+ parseEnumQueryParam(queryParams, "foregroundOnly", ["true"]) === "true"
274
+ ? true
275
+ : undefined;
276
+
272
277
  const filter: ConversationListFilter = {
273
278
  conversationType,
274
279
  archiveStatus,
275
280
  originChannel,
276
281
  groupId,
277
282
  needsAttention,
283
+ foregroundOnly,
278
284
  };
279
285
  let rows = listConversations({ ...filter, limit, offset });
280
286
  const totalCount = countConversations(filter);
@@ -289,19 +295,20 @@ function handleListConversations({ queryParams = {} }: RouteHandlerArgs) {
289
295
  // Skipped for group-scoped queries for the same reason: a caller asking
290
296
  // for one group gets that group, and a client that fetches the Pinned
291
297
  // section via `groupId=system:pinned` has no use for rows appended to
292
- // some other group's page. Skipped for attention-scoped queries too: the
293
- // caller asked for the unseen subset, and a seen pinned row appended to
294
- // it would put a row outside the filter in the page while `hasMore` is
295
- // computed from the filtered count. This is the compatibility shim for
296
- // clients that still read Pinned out of the unfiltered list; it goes
297
- // away once every section fetches its own group.
298
+ // some other group's page. Skipped for attention-scoped and
299
+ // foreground-only queries too: the caller asked for a subset, and a
300
+ // pinned row outside it appended to the page would sit there while
301
+ // `hasMore` is computed from the filtered count. This is the
302
+ // compatibility shim for clients that still read Pinned out of the
303
+ // unfiltered list; it goes away once every section fetches its own group.
298
304
  if (
299
305
  offset === 0 &&
300
306
  conversationType === "standard" &&
301
307
  archiveStatus === "active" &&
302
308
  originChannel === undefined &&
303
309
  groupId === undefined &&
304
- needsAttention === undefined
310
+ needsAttention === undefined &&
311
+ foregroundOnly === undefined
305
312
  ) {
306
313
  const pinned = listPinnedConversations(archiveStatus);
307
314
  const seen = new Set(rows.map((c) => c.id));
@@ -611,6 +618,14 @@ export const ROUTES: RouteDefinition[] = [
611
618
  'Pass "true" to return only conversations whose latest assistant message the user has not seen: the same predicate behind the unread count and the section index, so a client that keeps no complete conversation list can ask for exactly the rows its attention surfaces need. Composes with every other filter. Any value other than "true" is rejected. Omit to span every conversation.',
612
619
  schema: { type: "string", enum: ["true"] },
613
620
  },
621
+ {
622
+ name: "foregroundOnly",
623
+ type: "string",
624
+ required: false,
625
+ description:
626
+ 'Pass "true" to return only user-facing foreground conversations, dropping the automated background and scheduled runs the standard listing admits when they are filed in a custom group (a surfaced run stays). This is the same predicate the unread count and the section index apply, so a client can ask for the newest conversation a user can open in one row instead of paging past runs it would skip. Composes with every other filter; a foreground-only first page never has pinned rows appended to it. Any value other than "true" is rejected. Omit to keep every visible row.',
627
+ schema: { type: "string", enum: ["true"] },
628
+ },
614
629
  ],
615
630
  responseBody: listConversationsResponseSchema,
616
631
  handler: handleListConversations,
@@ -691,17 +691,16 @@ async function handleRetryLastAssistantTurn({
691
691
  const conversation = await getOrCreateConversationInstance(conversationId);
692
692
  touchConversation(conversationId);
693
693
 
694
- // Bind the requesting actor's trust before the turn. A freshly hydrated
695
- // conversation has no trust context, and `loadFromDb` under an unset
696
- // context filters guardian-provenance history — the re-run would see an
697
- // empty transcript.
694
+ // Resolved before the busy gate so the awaits stay outside the
695
+ // check-then-claim window below, but bound only once the claim succeeds: a
696
+ // retry that loses the race is rejected, and a rejected request must not
697
+ // repoint the conversation's actor at its requester.
698
698
  const actorPrincipalId = headers?.["x-vellum-actor-principal-id"];
699
- conversation.setTrustContext(
700
- await resolveVellumActorTrustContext(actorPrincipalId, {
701
- healResetDrift: true,
702
- }),
699
+ const retryTrustContext = await resolveVellumActorTrustContext(
700
+ actorPrincipalId,
701
+ { healResetDrift: true },
703
702
  );
704
- conversation.currentTurnSourceActorPrincipalId =
703
+ const retrySourceActorPrincipalId =
705
704
  await resolveActorPrincipalIdForLocalGuardian(actorPrincipalId);
706
705
 
707
706
  // Synchronous check-then-claim (no await between them) so a concurrent
@@ -714,6 +713,13 @@ async function handleRetryLastAssistantTurn({
714
713
  }
715
714
  conversation.setProcessing(true);
716
715
 
716
+ // Bind the requesting actor's trust for the turn we just claimed. A freshly
717
+ // hydrated conversation has no trust context, and `loadFromDb` under an
718
+ // unset context filters guardian-provenance history — the re-run would see
719
+ // an empty transcript.
720
+ conversation.setTrustContext(retryTrustContext);
721
+ conversation.currentTurnSourceActorPrincipalId = retrySourceActorPrincipalId;
722
+
717
723
  const requestId = uuidv7();
718
724
  const abortController = new AbortController();
719
725
  let discarded: ReturnType<typeof discardLastAssistantDisplayTurn>;
@@ -66,6 +66,7 @@ import {
66
66
  getEmbeddingConfigInfo,
67
67
  setEmbeddingConfig,
68
68
  } from "../../daemon/handlers/config-embeddings.js";
69
+ import { dropTunnelRecordsForNewUrl } from "../../daemon/handlers/config-ingress.js";
69
70
  import {
70
71
  getModelInfo,
71
72
  type ModelSetContext,
@@ -1525,6 +1526,10 @@ async function handlePatchConfig({ body }: RouteHandlerArgs) {
1525
1526
 
1526
1527
  const raw = loadRawConfig();
1527
1528
  const patch = body as Record<string, unknown>;
1529
+ const patchedIngressUrl = readPlainObject(patch.ingress)?.publicBaseUrl;
1530
+ if (patchedIngressUrl !== undefined) {
1531
+ dropTunnelRecordsForNewUrl(readPlainObject(raw.ingress), patchedIngressUrl);
1532
+ }
1528
1533
  deepMergeOverwrite(raw, patch);
1529
1534
  scrubRemovedServiceModes(raw);
1530
1535
  seedSttProviderForSparseBlock(raw);
@@ -1615,6 +1620,11 @@ async function handleSetConfig({ body }: RouteHandlerArgs) {
1615
1620
  readPlainObject(readPlainObject(raw.llm)?.profiles)?.[managedEntryName],
1616
1621
  )
1617
1622
  : undefined;
1623
+ // `assistant config set ingress.publicBaseUrl <url>`, what the webhook
1624
+ // diagnostics tell users to run, retargets ingress like the settings route.
1625
+ if (path === "ingress.publicBaseUrl") {
1626
+ dropTunnelRecordsForNewUrl(readPlainObject(raw.ingress), value);
1627
+ }
1618
1628
  setNestedValue(raw, path, value);
1619
1629
  if (
1620
1630
  managedEntryName &&
@@ -1236,12 +1236,10 @@ export async function handleListMessages({
1236
1236
 
1237
1237
  const alignedContentOrder = aligned.rewriteContentOrder(contentOrder);
1238
1238
 
1239
- // Use sentAt (actual event time) for the display timestamp when available,
1240
- // falling back to createdAt (persistence time). Clients use this display
1241
- // timestamp as their pagination cursor after memory-pressure trimming,
1242
- // while server-side pagination filters on createdAt. The mismatch is
1243
- // benign: it may return slightly extra data on a page boundary but never
1244
- // loses messages.
1239
+ // Use sentAt (actual event time) for the display timestamp when
1240
+ // available, falling back to createdAt (persistence time). Pagination
1241
+ // is unaffected: the cursor is `oldestTimestamp`, built from
1242
+ // `createdAt` on both ends.
1245
1243
  const displayTimestamp = m.sentAt ?? m.createdAt;
1246
1244
  return {
1247
1245
  id: m.id ?? "",
@@ -1849,6 +1847,11 @@ export async function handleSendMessage(
1849
1847
 
1850
1848
  // Resolve guardian context from the AuthContext's actorPrincipalId via the
1851
1849
  // gateway guardian binding: a vellum principal is the guardian or nobody.
1850
+ //
1851
+ // Resolved into a local; the conversation's slot is stamped only where this
1852
+ // request commits to running a turn, since that write is what supplies the
1853
+ // acting actor for a run and must not fire for a send that merely queues.
1854
+ let resolvedTrustCtx: TrustContext;
1852
1855
  if (actorPrincipalId) {
1853
1856
  // Dev bypass (HTTP auth disabled): the synthetic "dev-bypass" principal
1854
1857
  // won't match any guardian binding. Resolve the real guardian principal and
@@ -1874,7 +1877,7 @@ export async function handleSendMessage(
1874
1877
  trustCtx = healed;
1875
1878
  }
1876
1879
  }
1877
- conversation.setTrustContext(trustCtx);
1880
+ resolvedTrustCtx = trustCtx;
1878
1881
  } else {
1879
1882
  let trustCtx = withSourceChannel(
1880
1883
  sourceChannel,
@@ -1907,22 +1910,19 @@ export async function handleSendMessage(
1907
1910
  );
1908
1911
  }
1909
1912
  }
1910
- conversation.setTrustContext(trustCtx);
1913
+ resolvedTrustCtx = trustCtx;
1911
1914
  }
1912
1915
  } else {
1913
1916
  // Service principals (svc_gateway) or tokens without an actor ID
1914
1917
  // get a minimal guardian context so downstream code has something.
1915
- conversation.setTrustContext({ trustClass: "guardian", sourceChannel });
1918
+ resolvedTrustCtx = { trustClass: "guardian", sourceChannel };
1916
1919
  }
1917
1920
 
1918
- // The trust this request's turn runs under, captured here rather than read
1919
- // back at the agent loop below. Every branch above has just written it and
1920
- // nothing awaits in between, so this is the resolved sender. Between here
1921
- // and the loop the conversation slot is writable by paths that do not own
1922
- // this turn (channel ingress for another actor, live-voice hydration,
1923
- // pointer elevation, the voice bridge), and the loop would otherwise
1924
- // re-read it and run this turn as whoever wrote last.
1925
- const turnTrustContext = conversation.trustContext;
1921
+ // The trust this request's turn runs under: the sender resolved above,
1922
+ // never a read of the shared slot. Between here and the loop that slot is
1923
+ // writable by paths that do not own this turn (channel ingress for another
1924
+ // actor, live-voice hydration, pointer elevation, the voice bridge).
1925
+ const turnTrustContext = resolvedTrustCtx;
1926
1926
 
1927
1927
  const isInteractive = isInteractiveInterface(sourceInterface);
1928
1928
  // Translate the dev-bypass actor principal to the real guardian principal
@@ -2053,12 +2053,15 @@ export async function handleSendMessage(
2053
2053
  requestId: uuidv7(),
2054
2054
  metadata: greetingMeta,
2055
2055
  clientMessageId,
2056
+ // This path answers and returns without starting a turn, so it never
2057
+ // reaches the stamp below; name the sender on the row directly.
2058
+ trustContext: resolvedTrustCtx,
2056
2059
  ...(clientOs ? { requestClientOs: clientOs } : {}),
2057
2060
  });
2058
2061
 
2059
2062
  const conversationId = mapping.conversationId;
2060
2063
  const channelMeta = buildChannelMetadata(sourceChannel, sourceInterface, {
2061
- trustContext: conversation.trustContext,
2064
+ trustContext: resolvedTrustCtx,
2062
2065
  });
2063
2066
 
2064
2067
  const assistantMsg = createAssistantMessage(cannedGreeting);
@@ -2165,10 +2168,9 @@ export async function handleSendMessage(
2165
2168
 
2166
2169
  // Resolve the verified actor's external user ID and principal for inline
2167
2170
  // approval routing from the conversation's guardian context.
2168
- const verifiedActorExternalUserId =
2169
- conversation.trustContext?.guardianExternalUserId;
2171
+ const verifiedActorExternalUserId = resolvedTrustCtx.guardianExternalUserId;
2170
2172
  const verifiedActorPrincipalId =
2171
- conversation.trustContext?.guardianPrincipalId ?? undefined;
2173
+ resolvedTrustCtx.guardianPrincipalId ?? undefined;
2172
2174
 
2173
2175
  // Try to consume the message as a guardian approval/rejection reply.
2174
2176
  // On failure, degrade to the existing queue/auto-deny path rather than
@@ -2242,6 +2244,10 @@ export async function handleSendMessage(
2242
2244
  sourceActorPrincipalId,
2243
2245
  transport,
2244
2246
  clientMessageId,
2247
+ // The sender's own trust, so the drain runs this message as the actor
2248
+ // who sent it rather than as whoever the slot happens to hold when the
2249
+ // queue is worked.
2250
+ trustContext: resolvedTrustCtx,
2245
2251
  });
2246
2252
  if (enqueueResult.rejected) {
2247
2253
  return new RouteResponse(
@@ -2340,7 +2346,15 @@ export async function handleSendMessage(
2340
2346
  // matching in-memory pending interaction (e.g. prompter timeouts).
2341
2347
  await expireOrphanedGuardianRequests(mapping.conversationId);
2342
2348
 
2343
- // Conversation is idle — persist and fire agent loop immediately
2349
+ // Conversation is idle — persist and fire agent loop immediately.
2350
+ //
2351
+ // Stamping the sender here rather than at resolution is what keeps the two
2352
+ // in step: the slot hydrates and scopes the turn started just below
2353
+ // (`ensureActorScopedHistory`, persisted provenance, the loop's own trust),
2354
+ // so it must name whoever this request is about to run as. A request that
2355
+ // queues instead returns above without stamping — it is not starting a run,
2356
+ // and its actor rides the queue item to the drain.
2357
+ conversation.setTrustContext(resolvedTrustCtx);
2344
2358
  conversation.setTurnChannelContext({
2345
2359
  userMessageChannel: sourceChannel,
2346
2360
  assistantMessageChannel: sourceChannel,