@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
@@ -85,6 +85,8 @@ import type {
85
85
  } from "./message-protocol.js";
86
86
  import { INTERACTIVE_SURFACE_TYPES } from "./message-protocol.js";
87
87
  import { isRowVisibleToUntrustedActor } from "./message-provenance.js";
88
+ import type { TrustContext } from "./trust-context-types.js";
89
+ import { restingTrust } from "./trust-context-types.js";
88
90
  export {
89
91
  buildSurfaceShowPair,
90
92
  type CurrentTurnSurface,
@@ -1904,7 +1906,13 @@ export async function handleSurfaceAction(
1904
1906
  // reconstruct the same-user binding for host proxies (CU / app-control),
1905
1907
  // mirroring the normal message path.
1906
1908
  sourceActorPrincipalId?: string,
1909
+ // Trust of the actor committing this action, resolved by the route from the
1910
+ // verified requester. Passed rather than read back off the conversation so a
1911
+ // click that lands mid-turn is attributed to its clicker instead of to
1912
+ // whoever occupies the resting slot.
1913
+ requesterTrustContext?: TrustContext,
1907
1914
  ): Promise<SurfaceActionResult> {
1915
+ const actionTrustContext = requesterTrustContext ?? restingTrust(ctx);
1908
1916
  // ── Standalone surface interception ──────────────────────────────
1909
1917
  // Daemon-driven surfaces (from `requestInteractiveUi`) register a
1910
1918
  // pending entry in `pendingStandaloneSurfaces`. When the user clicks
@@ -2050,7 +2058,7 @@ export async function handleSurfaceAction(
2050
2058
  // `await` resolves as soon as the conversation is created + titled +
2051
2059
  // published to the event hub. The HTTP POST /v1/surface-actions
2052
2060
  // response returns promptly — the seed turn runs in the background.
2053
- const originTrustContext = ctx.trustContext;
2061
+ const originTrustContext = actionTrustContext;
2054
2062
  const { conversationId } = await launchConversation({
2055
2063
  title,
2056
2064
  seedPrompt,
@@ -2069,14 +2077,11 @@ export async function handleSurfaceAction(
2069
2077
  return { accepted: true, conversationId };
2070
2078
  }
2071
2079
 
2072
- // Trust of the actor committing THIS action. `POST /v1/surface-actions`
2073
- // stamps the verified requester's trust onto the conversation before
2074
- // dispatching here, and `loadFromDb` derives the live history filter from
2075
- // the same value, so the completion path's persisted read stays scoped to
2076
- // exactly what this actor's live view would have held. Unresolvable trust
2077
- // fails closed to the untrusted filter.
2080
+ // Trust of the actor committing THIS action, so the completion path's
2081
+ // persisted read stays scoped to exactly what this actor's live view would
2082
+ // have held. Unresolvable trust fails closed to the untrusted filter.
2078
2083
  const requesterCanAccessMemory = resolveCapabilities(
2079
- ctx.trustContext?.trustClass,
2084
+ actionTrustContext?.trustClass,
2080
2085
  ).canAccessMemory;
2081
2086
 
2082
2087
  const pending = ctx.pendingSurfaceActions.get(surfaceId);
@@ -2222,6 +2227,7 @@ export async function handleSurfaceAction(
2222
2227
  activeSurfaceId: surfaceId,
2223
2228
  displayContent,
2224
2229
  sourceActorPrincipalId,
2230
+ trustContext: actionTrustContext,
2225
2231
  isInteractive: SURFACE_ACTION_TURN_IS_INTERACTIVE,
2226
2232
  // Rides the metadata bag rather than a typed option: the queue
2227
2233
  // round-trips `metadata` but not `PersistMessageOptions`.
@@ -2285,6 +2291,9 @@ export async function handleSurfaceAction(
2285
2291
  activeSurfaceId: surfaceId,
2286
2292
  displayContent,
2287
2293
  sourceActorPrincipalId,
2294
+ // Reached only when `enqueueMessage` declined to queue: the click is
2295
+ // starting this turn, so it is the actor the run belongs to.
2296
+ trustContext: actionTrustContext,
2288
2297
  isInteractive: SURFACE_ACTION_TURN_IS_INTERACTIVE,
2289
2298
  scripted: isSyntheticSurfaceActionContent(content),
2290
2299
  })
@@ -2472,6 +2481,7 @@ export async function handleSurfaceAction(
2472
2481
  activeSurfaceId: surfaceId,
2473
2482
  displayContent,
2474
2483
  sourceActorPrincipalId,
2484
+ trustContext: actionTrustContext,
2475
2485
  isInteractive: SURFACE_ACTION_TURN_IS_INTERACTIVE,
2476
2486
  // Rides the metadata bag rather than a typed option: the queue
2477
2487
  // round-trips `metadata` but not `PersistMessageOptions`.
@@ -2545,6 +2555,9 @@ export async function handleSurfaceAction(
2545
2555
  activeSurfaceId: surfaceId,
2546
2556
  displayContent,
2547
2557
  sourceActorPrincipalId,
2558
+ // Same as the history-restored branch: the enqueue declined, so this
2559
+ // click is the turn about to run.
2560
+ trustContext: actionTrustContext,
2548
2561
  isInteractive: SURFACE_ACTION_TURN_IS_INTERACTIVE,
2549
2562
  scripted: isSyntheticSurfaceActionContent(content),
2550
2563
  })
@@ -1119,11 +1119,10 @@ export class Conversation {
1119
1119
  preStrippedCount = boundary === -1 ? slicedDbMessages.length : boundary;
1120
1120
  }
1121
1121
 
1122
- // The injection-time personal-memory gate, so background/local
1123
- // conversations (sourceChannel `undefined` or `"vellum"`) can rehydrate
1124
- // the persisted v2 static memory block. The shared helper folds in the
1125
- // HTTP-auth-disabled dev bypass so rehydration and injection agree on the
1126
- // effective trust class.
1122
+ // The injection-time personal-memory gate, so rehydration of the persisted
1123
+ // blocks admits exactly the actors injection would. The shared helper folds
1124
+ // in the HTTP-auth-disabled dev bypass, so a turn with no bound actor
1125
+ // resolves the same way on both paths.
1127
1126
  const personalMemoryAllowed = isPersonalMemoryAllowed(this.trustContext);
1128
1127
  // Pruned v3 card slugs, read lazily on the first row that carries a v3
1129
1128
  // block (most conversations carry none, so most loads never query). The
@@ -1513,11 +1512,12 @@ export class Conversation {
1513
1512
 
1514
1513
  async ensureActorScopedHistory(): Promise<void> {
1515
1514
  const currentTrustClass = this.trustContext?.trustClass;
1516
- // `loadFromDb` gates personal-memory rehydration on `sourceChannel` too
1517
- // (via `isPersonalMemoryAllowed`), so a same-trust-class reuse from a
1518
- // different channel (e.g. internal `vellum` → remote channel) must also
1519
- // trigger a reload. Otherwise stale personal-memory blocks can leak to
1520
- // an untrusted remote turn, or be hidden when they should be present.
1515
+ // Tracked alongside the trust class because `loadFromDb` gates
1516
+ // personal-memory rehydration on `isPersonalMemoryAllowed`, which folds in
1517
+ // the disabled-auth elevation of an unbound actor: two contexts can share a
1518
+ // trust class and still differ here. A reuse that changes the answer has to
1519
+ // reload, or stale personal-memory blocks persist into a turn that must not
1520
+ // see them, or stay stripped from one that should.
1521
1521
  const currentPersonalMemoryAllowed = isPersonalMemoryAllowed(
1522
1522
  this.trustContext,
1523
1523
  );
@@ -2829,6 +2829,7 @@ export class Conversation {
2829
2829
  actionId: string,
2830
2830
  data?: Record<string, unknown>,
2831
2831
  sourceActorPrincipalId?: string,
2832
+ requesterTrustContext?: TrustContext,
2832
2833
  ): Promise<SurfaceActionResult> {
2833
2834
  return handleSurfaceActionImpl(
2834
2835
  this,
@@ -2836,6 +2837,7 @@ export class Conversation {
2836
2837
  actionId,
2837
2838
  data,
2838
2839
  sourceActorPrincipalId,
2840
+ requesterTrustContext,
2839
2841
  );
2840
2842
  }
2841
2843
 
@@ -413,6 +413,7 @@ async function startDaemonLocked(): Promise<{
413
413
  const child = spawn(bunPath, ["run", mainPath], {
414
414
  detached: true,
415
415
  stdio: ["ignore", "ignore", stderrFd],
416
+ windowsHide: true,
416
417
  env: spawnEnv,
417
418
  });
418
419
 
@@ -0,0 +1,208 @@
1
+ /**
2
+ * Unit tests for the ingress section of the workspace config: the records
3
+ * `vellum tunnel` leaves behind, who owns the public base URL, and when the
4
+ * records are dropped. The record truth table lives on the shared parser
5
+ * (`packages/service-contracts/src/__tests__/ingress.test.ts`); what is
6
+ * checked here is that the daemon reads the keys the CLI and the gateway
7
+ * write, and inherits that validation.
8
+ */
9
+
10
+ import { beforeEach, describe, expect, mock, test } from "bun:test";
11
+
12
+ let rawConfig: Record<string, unknown> = {};
13
+
14
+ mock.module("../../../config/loader.js", () => ({
15
+ loadRawConfig: () => rawConfig,
16
+ }));
17
+
18
+ import {
19
+ dropTunnelRecordsForNewUrl,
20
+ getIngressConfigResult,
21
+ isVelayManagedIngress,
22
+ loadLastTunnelRecord,
23
+ loadPairingTunnelRecord,
24
+ loadRecordedAssistantId,
25
+ } from "../config-ingress.js";
26
+
27
+ const TUNNEL_URL = "https://assistant-1.example.ts.net";
28
+ const PAIRING_URL = "https://assistant-1.pairing.example.ts.net";
29
+
30
+ describe("workspace tunnel records", () => {
31
+ beforeEach(() => {
32
+ rawConfig = {};
33
+ });
34
+
35
+ test("reads a well-formed record", () => {
36
+ rawConfig = {
37
+ ingress: {
38
+ assistantId: "assistant-1",
39
+ lastTunnel: { provider: "tailscale", publicBaseUrl: TUNNEL_URL },
40
+ },
41
+ };
42
+
43
+ expect(loadLastTunnelRecord()).toEqual({
44
+ provider: "tailscale",
45
+ publicBaseUrl: TUNNEL_URL,
46
+ });
47
+ expect(loadRecordedAssistantId()).toBe("assistant-1");
48
+ });
49
+
50
+ test("reads a pairing record beside the tunnel that owns the URL", () => {
51
+ rawConfig = {
52
+ ingress: {
53
+ publicBaseUrl: "https://webhooks.ngrok.app",
54
+ lastTunnel: {
55
+ provider: "ngrok",
56
+ publicBaseUrl: "https://webhooks.ngrok.app",
57
+ },
58
+ pairingTunnel: { provider: "tailscale", publicBaseUrl: PAIRING_URL },
59
+ },
60
+ };
61
+
62
+ expect(loadPairingTunnelRecord()).toEqual({
63
+ provider: "tailscale",
64
+ publicBaseUrl: PAIRING_URL,
65
+ });
66
+ expect(loadLastTunnelRecord()).toEqual({
67
+ provider: "ngrok",
68
+ publicBaseUrl: "https://webhooks.ngrok.app",
69
+ });
70
+ });
71
+
72
+ test("inherits the shared validation for the pairing record", () => {
73
+ rawConfig = {
74
+ ingress: {
75
+ pairingTunnel: { provider: "wireguard", publicBaseUrl: PAIRING_URL },
76
+ },
77
+ };
78
+ expect(loadPairingTunnelRecord()).toBeNull();
79
+
80
+ rawConfig = { ingress: { pairingTunnel: { provider: "tailscale" } } };
81
+ expect(loadPairingTunnelRecord()).toBeNull();
82
+ });
83
+
84
+ test("returns null when the ingress section is absent", () => {
85
+ expect(loadLastTunnelRecord()).toBeNull();
86
+ expect(loadPairingTunnelRecord()).toBeNull();
87
+ expect(loadRecordedAssistantId()).toBeNull();
88
+ });
89
+
90
+ test("returns null when the ingress section is not an object", () => {
91
+ rawConfig = { ingress: "nonsense" };
92
+
93
+ expect(loadLastTunnelRecord()).toBeNull();
94
+ expect(loadRecordedAssistantId()).toBeNull();
95
+ });
96
+
97
+ test("returns null for a provider outside the shared registry", () => {
98
+ // Readers render the provider into a shell command they tell the user to
99
+ // run, so an unknown one makes the whole record unusable.
100
+ rawConfig = {
101
+ ingress: {
102
+ lastTunnel: { provider: "wireguard", publicBaseUrl: TUNNEL_URL },
103
+ },
104
+ };
105
+
106
+ expect(loadLastTunnelRecord()).toBeNull();
107
+ });
108
+
109
+ test("returns null for a malformed record", () => {
110
+ rawConfig = { ingress: { lastTunnel: { provider: "ngrok" } } };
111
+ expect(loadLastTunnelRecord()).toBeNull();
112
+
113
+ rawConfig = {
114
+ ingress: {
115
+ lastTunnel: { provider: "ngrok", publicBaseUrl: "example.ts.net" },
116
+ },
117
+ };
118
+ expect(loadLastTunnelRecord()).toBeNull();
119
+ });
120
+
121
+ test("returns null for a blank recorded assistant id", () => {
122
+ rawConfig = { ingress: { assistantId: " " } };
123
+
124
+ expect(loadRecordedAssistantId()).toBeNull();
125
+ });
126
+
127
+ test("falls back to typed defaults for a mistyped ingress section", () => {
128
+ rawConfig = { ingress: { publicBaseUrl: 42, enabled: "yes" } };
129
+
130
+ const config = getIngressConfigResult();
131
+
132
+ expect(config.publicBaseUrl).toBe("");
133
+ expect(config.enabled).toBe(false);
134
+ expect(config.explicitlyDisabled).toBe(false);
135
+ });
136
+
137
+ test("reports Velay ownership of the public base URL", () => {
138
+ rawConfig = {
139
+ ingress: { publicBaseUrl: TUNNEL_URL, publicBaseUrlManagedBy: "velay" },
140
+ };
141
+ expect(isVelayManagedIngress()).toBe(true);
142
+
143
+ rawConfig = { ingress: { publicBaseUrl: TUNNEL_URL } };
144
+ expect(isVelayManagedIngress()).toBe(false);
145
+ });
146
+ });
147
+
148
+ describe("explicitlyDisabled", () => {
149
+ beforeEach(() => {
150
+ rawConfig = {};
151
+ });
152
+
153
+ test("only an explicit false is an opt-out", () => {
154
+ // `ingress.enabled` is opt-out across the assistant: a URL set through
155
+ // `config set ingress.publicBaseUrl` never writes the flag and is live.
156
+ rawConfig = { ingress: { publicBaseUrl: TUNNEL_URL } };
157
+ expect(getIngressConfigResult().explicitlyDisabled).toBe(false);
158
+
159
+ rawConfig = { ingress: { publicBaseUrl: TUNNEL_URL, enabled: true } };
160
+ expect(getIngressConfigResult().explicitlyDisabled).toBe(false);
161
+
162
+ rawConfig = { ingress: { publicBaseUrl: TUNNEL_URL, enabled: false } };
163
+ expect(getIngressConfigResult().explicitlyDisabled).toBe(true);
164
+ });
165
+ });
166
+
167
+ describe("dropTunnelRecordsForNewUrl", () => {
168
+ const records = () => ({
169
+ publicBaseUrl: TUNNEL_URL,
170
+ assistantId: "assistant-1",
171
+ lastTunnel: { provider: "tailscale", publicBaseUrl: TUNNEL_URL },
172
+ pairingTunnel: { provider: "tailscale", publicBaseUrl: PAIRING_URL },
173
+ });
174
+
175
+ test("keeps the records when the URL is unchanged", () => {
176
+ const ingress: Record<string, unknown> = records();
177
+
178
+ dropTunnelRecordsForNewUrl(ingress, ` ${TUNNEL_URL}/ `);
179
+
180
+ expect(ingress).toEqual(records());
181
+ });
182
+
183
+ test("drops the pairing record too, so a new URL is the one reported", () => {
184
+ // The pairing record outranks `publicBaseUrl` in the status route, so a
185
+ // leftover one would hide the address the user just set.
186
+ const retargeted: Record<string, unknown> = records();
187
+
188
+ dropTunnelRecordsForNewUrl(retargeted, "https://other.example.ts.net");
189
+
190
+ expect(retargeted.pairingTunnel).toBeUndefined();
191
+ });
192
+
193
+ test("drops the records when the URL is retargeted or cleared", () => {
194
+ const retargeted: Record<string, unknown> = records();
195
+ dropTunnelRecordsForNewUrl(retargeted, "https://other.example.ts.net");
196
+ expect(retargeted).toEqual({ publicBaseUrl: TUNNEL_URL });
197
+
198
+ const cleared: Record<string, unknown> = records();
199
+ dropTunnelRecordsForNewUrl(cleared, undefined);
200
+ expect(cleared).toEqual({ publicBaseUrl: TUNNEL_URL });
201
+ });
202
+
203
+ test("is a no-op without an ingress section", () => {
204
+ expect(() =>
205
+ dropTunnelRecordsForNewUrl(undefined, TUNNEL_URL),
206
+ ).not.toThrow();
207
+ });
208
+ });
@@ -1,3 +1,13 @@
1
+ import {
2
+ INGRESS_ASSISTANT_ID_KEY,
3
+ INGRESS_LAST_TUNNEL_KEY,
4
+ INGRESS_PAIRING_TUNNEL_KEY,
5
+ normalizePublicBaseUrl,
6
+ parseRecordedAssistantId,
7
+ parseTunnelRecord,
8
+ type TunnelRecord,
9
+ } from "@vellumai/service-contracts/ingress";
10
+
1
11
  import { updatePhoneNumberWebhooks } from "../../calls/twilio-rest.js";
2
12
  import {
3
13
  getGatewayInternalBaseUrl,
@@ -11,13 +21,105 @@ import {
11
21
  getTwilioStatusCallbackUrl,
12
22
  getTwilioVoiceWebhookUrl,
13
23
  type IngressConfig,
24
+ isPublicIngressDisabled,
14
25
  } from "../../inbound/public-ingress-urls.js";
26
+ import { isPlainObject } from "../../util/object.js";
15
27
  import { log } from "./shared.js";
16
28
 
17
29
  export function computeGatewayTarget(): string {
18
30
  return getGatewayInternalBaseUrl();
19
31
  }
20
32
 
33
+ /**
34
+ * The `ingress` section of the raw workspace config.
35
+ *
36
+ * `vellum tunnel` writes this section (`cli/src/lib/ingress-config.ts`). The
37
+ * CLI is a separate build unit the assistant does not depend on, so the key
38
+ * names and the record validation are shared through
39
+ * `@vellumai/service-contracts/ingress` instead.
40
+ */
41
+ function readIngressSection(): Record<string, unknown> {
42
+ const ingress = loadRawConfig().ingress;
43
+ return isPlainObject(ingress) ? ingress : {};
44
+ }
45
+
46
+ /** Read the last tunnel that ran, or null when it is absent or malformed. */
47
+ export function loadLastTunnelRecord(): TunnelRecord | null {
48
+ return parseTunnelRecord(readIngressSection()[INGRESS_LAST_TUNNEL_KEY]);
49
+ }
50
+
51
+ /**
52
+ * Read the tunnel published for device pairing alone, or null when it is
53
+ * absent or malformed.
54
+ *
55
+ * A tailnet-only tunnel started beside configured webhook integrations records
56
+ * itself here instead of replacing `publicBaseUrl`, which those callbacks need
57
+ * to keep resolving to an address their callers can reach.
58
+ */
59
+ export function loadPairingTunnelRecord(): TunnelRecord | null {
60
+ return parseTunnelRecord(readIngressSection()[INGRESS_PAIRING_TUNNEL_KEY]);
61
+ }
62
+
63
+ /**
64
+ * Read the assistant id the last tunnel fronted, or null when absent. The
65
+ * daemon cannot derive it: it scopes itself as `self` internally.
66
+ */
67
+ export function loadRecordedAssistantId(): string | null {
68
+ return parseRecordedAssistantId(
69
+ readIngressSection()[INGRESS_ASSISTANT_ID_KEY],
70
+ );
71
+ }
72
+
73
+ /** Key under `ingress` naming the component that owns `publicBaseUrl`. */
74
+ const INGRESS_MANAGED_BY_KEY = "publicBaseUrlManagedBy";
75
+
76
+ /** Value that key carries when a self-hosted gateway's Velay tunnel owns it. */
77
+ const VELAY_MANAGED_BY = "velay";
78
+
79
+ /**
80
+ * True when Velay owns `ingress.publicBaseUrl`.
81
+ *
82
+ * A gateway started with `VELAY_BASE_URL` writes the URL when its tunnel comes
83
+ * up, clears it when the tunnel drops, and reconnects on its own
84
+ * (`gateway/src/velay/client.ts`). Readers must not offer the user a tunnel
85
+ * command for an ingress they do not own.
86
+ */
87
+ export function isVelayManagedIngress(): boolean {
88
+ return readIngressSection()[INGRESS_MANAGED_BY_KEY] === VELAY_MANAGED_BY;
89
+ }
90
+
91
+ /**
92
+ * Drop `ingress.assistantId`, `ingress.lastTunnel` and `ingress.pairingTunnel`
93
+ * from `ingress` when `nextPublicBaseUrl` replaces a different address,
94
+ * mutating it in place.
95
+ *
96
+ * The first two describe the address being replaced, so keeping them makes the
97
+ * status route call a legitimate retarget `foreign` and name a tunnel that
98
+ * never fronted the new address. The pairing record goes with them because it
99
+ * outranks `publicBaseUrl` where the status route reports an address: a
100
+ * leftover one would hide the address the user just set behind a tunnel they
101
+ * are no longer running. Every writer of `ingress.publicBaseUrl` owes this
102
+ * cleanup, so it lives here rather than in each of them. An absent `ingress`
103
+ * section carries no records to drop.
104
+ */
105
+ export function dropTunnelRecordsForNewUrl(
106
+ ingress: Record<string, unknown> | undefined,
107
+ nextPublicBaseUrl: unknown,
108
+ ): void {
109
+ if (!ingress) {
110
+ return;
111
+ }
112
+ if (
113
+ normalizePublicBaseUrl(nextPublicBaseUrl) ===
114
+ normalizePublicBaseUrl(ingress.publicBaseUrl)
115
+ ) {
116
+ return;
117
+ }
118
+ delete ingress[INGRESS_ASSISTANT_ID_KEY];
119
+ delete ingress[INGRESS_LAST_TUNNEL_KEY];
120
+ delete ingress[INGRESS_PAIRING_TUNNEL_KEY];
121
+ }
122
+
21
123
  /**
22
124
  * Read the current ingress config from the raw workspace config file.
23
125
  * Extracted so it can be called from both the daemon message handler
@@ -25,6 +127,7 @@ export function computeGatewayTarget(): string {
25
127
  */
26
128
  export function getIngressConfigResult(): {
27
129
  enabled: boolean;
130
+ explicitlyDisabled: boolean;
28
131
  publicBaseUrl: string;
29
132
  localGatewayTarget: string;
30
133
  managedCallbacks: boolean;
@@ -40,6 +143,7 @@ export function getIngressConfigResult(): {
40
143
  if (assistantId) {
41
144
  return {
42
145
  enabled: true,
146
+ explicitlyDisabled: false,
43
147
  publicBaseUrl: `${platformBase}/gateway/callbacks/${assistantId}`,
44
148
  localGatewayTarget: computeGatewayTarget(),
45
149
  managedCallbacks: true,
@@ -48,12 +152,18 @@ export function getIngressConfigResult(): {
48
152
  }
49
153
  }
50
154
 
51
- const raw = loadRawConfig();
52
- const ingress = (raw?.ingress ?? {}) as Record<string, unknown>;
53
- const publicBaseUrl = (ingress.publicBaseUrl as string) ?? "";
54
- const enabled = (ingress.enabled as boolean | undefined) ?? false;
155
+ const ingress = readIngressSection();
156
+ // Typed reads, not casts: a hand-edited config must not hand callers a
157
+ // value whose type contradicts this function's return type.
158
+ const publicBaseUrl =
159
+ typeof ingress.publicBaseUrl === "string" ? ingress.publicBaseUrl : "";
160
+ const enabled =
161
+ typeof ingress.enabled === "boolean" ? ingress.enabled : undefined;
55
162
  return {
56
- enabled,
163
+ enabled: enabled === true,
164
+ // `enabled` is opt-out across the assistant, so an unset flag is not off:
165
+ // callers asking whether ingress is live read this, not `!enabled`.
166
+ explicitlyDisabled: isPublicIngressDisabled({ ingress: { enabled } }),
57
167
  publicBaseUrl,
58
168
  localGatewayTarget: computeGatewayTarget(),
59
169
  managedCallbacks: false,
@@ -62,6 +62,7 @@ import {
62
62
  getWorkspaceDir,
63
63
  } from "../util/platform.js";
64
64
  import { APP_VERSION } from "../version.js";
65
+ import { drainOrphanedWatchTimelineEntries } from "../watch/watch-timeline.js";
65
66
  import { getWorkflowRunManager } from "../workflows/run-manager.js";
66
67
  import { repairAdaptiveThinkingOnManagedProfiles } from "../workspace/adaptive-thinking-repair.js";
67
68
  import { ensureByokDefaultProfiles } from "../workspace/byok-default-profile-ensure.js";
@@ -98,6 +99,7 @@ import {
98
99
  registerMessagingProviders,
99
100
  registerWatcherProviders,
100
101
  } from "./providers-setup.js";
102
+ import { startResourcePressureGuardForLifecycle } from "./resource-pressure-guard-lifecycle.js";
101
103
  import { installShutdownHandlers } from "./shutdown-handlers.js";
102
104
  import { broadcastDaemonStatus } from "./status.js";
103
105
 
@@ -197,8 +199,10 @@ export async function runDaemon(): Promise<void> {
197
199
  }
198
200
  }
199
201
 
200
- // Start the runtime HTTP server early so /healthz answers ASAP. A bind
201
- // failure is non-fatal — the daemon falls back to IPC-only operation.
202
+ // Start the runtime HTTP server early so /healthz answers ASAP. Throws on
203
+ // EADDRINUSE to abort startup: another process holds the port every HTTP
204
+ // client (and the gateway's /v1/* proxy) targets, so an IPC-only daemon
205
+ // would look healthy while all HTTP traffic 502s.
202
206
  await startRuntimeHttpServer();
203
207
 
204
208
  // Warms the configured-probe cache (credential reads only, no DB). Fired
@@ -382,6 +386,29 @@ export async function runDaemon(): Promise<void> {
382
386
  log.warn({ err }, "Profiler retention sweep failed — continuing startup");
383
387
  }
384
388
 
389
+ // Reclaim watch-timeline entries whose conversation is gone. Their purge
390
+ // runs after the conversation row is already committed as deleted and
391
+ // cannot be retried by the caller, and nothing cascades into the table, so
392
+ // a failed purge or a crash between the two writes would otherwise keep
393
+ // narration, AX trees, and screenshots of the user's screen for as long as
394
+ // the database lives. Startup is the pass every install gets: the periodic
395
+ // pass runs from database maintenance on the memory plugin's jobs worker,
396
+ // which an install with that plugin disabled or `memory.enabled: false`
397
+ // never starts, so this is the only sweep that install's residue sees and
398
+ // it drains rather than taking one page. Best-effort inside the sweep,
399
+ // which reports zero rather than throwing.
400
+ try {
401
+ const sweptWatchEntries = await drainOrphanedWatchTimelineEntries();
402
+ if (sweptWatchEntries > 0) {
403
+ log.info(
404
+ { sweptWatchEntries },
405
+ "Swept watch timeline entries for deleted conversations on startup",
406
+ );
407
+ }
408
+ } catch (err) {
409
+ log.warn({ err }, "Watch timeline sweep failed, continuing startup");
410
+ }
411
+
385
412
  // Backfill oauth_connection rows for manual-token providers (Telegram,
386
413
  // Slack channel) that already have stored credentials from before the
387
414
  // oauth_connection migration. Safe to call on every startup.
@@ -700,6 +727,7 @@ export async function runDaemon(): Promise<void> {
700
727
 
701
728
  startUsageTelemetryReporter();
702
729
  startDiskPressureGuardForLifecycle();
730
+ startResourcePressureGuardForLifecycle();
703
731
  startOrphanReaper();
704
732
  startEventLoopWatchdog();
705
733
 
@@ -48,18 +48,16 @@ interface BaseTransportMetadata {
48
48
  }
49
49
 
50
50
  /**
51
- * Transport metadata for interfaces that support the full desktop host-proxy
52
- * set (see `HostProxyInterfaceId` / `supportsHostProxy`). Carries the host
51
+ * Transport metadata for interfaces that support desktop host-proxy tools
52
+ * (see `HostProxyInterfaceId` / `supportsHostProxy`). Carries the host
53
53
  * environment fields the client reports so the `<workspace>` block renders
54
54
  * the user's actual machine rather than a containerized daemon's own OS.
55
55
  *
56
- * Today this variant is populated only by the macOS client, but the shape
57
- * is capability-keyed (not interface-name-keyed) so future host-capable
58
- * clients (e.g. a native Linux or Windows desktop) get the same treatment
59
- * automatically when added to `HostProxyInterfaceId`.
56
+ * The shape is capability-keyed so each native desktop client gets the same
57
+ * host-environment treatment through `HostProxyInterfaceId`.
60
58
  */
61
59
  export interface HostProxyTransportMetadata extends BaseTransportMetadata {
62
- /** Interface identifier — restricted to interfaces that support host proxies. */
60
+ /** Interface identifier restricted to interfaces that support host proxies. */
63
61
  interfaceId: HostProxyInterfaceId;
64
62
  /** Home directory of the user on the host machine (e.g. `NSHomeDirectory()`). */
65
63
  hostHomeDir?: string;
@@ -11,10 +11,11 @@ export type WebSearchProviderId =
11
11
  | "perplexity"
12
12
  | "tavily"
13
13
  | "keenable"
14
- | "firecrawl";
14
+ | "firecrawl"
15
+ | "fastcrw";
15
16
 
16
17
  /** Provider that backed a `web_fetch` call. `default` is the built-in fetcher. */
17
- export type WebFetchProviderId = "default" | "firecrawl";
18
+ export type WebFetchProviderId = "default" | "firecrawl" | "fastcrw";
18
19
 
19
20
  export interface WebSearchResultItem {
20
21
  rank: number; // 1-indexed