@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
@@ -0,0 +1,180 @@
1
+ /**
2
+ * Ingress status route: is the assistant's public tunnel actually up?
3
+ *
4
+ * The recorded `ingress.publicBaseUrl` only says a tunnel was configured at
5
+ * some point. It stays behind in both directions: a killed tunnel leaves the
6
+ * URL in place, and an edge can survive while the gateway behind it dies or
7
+ * while it starts fronting a different assistant. This route resolves that by
8
+ * probing the URL live (`inbound/tunnel-probe.ts`) and reporting one of six
9
+ * states, so a client can tell the user what to do instead of guessing. The
10
+ * card the states drive exists to pair devices, so an address that answers
11
+ * without serving the pairing app is its own state (`unpairable`) rather than
12
+ * a healthy one.
13
+ *
14
+ * Platform-hosted assistants receive webhooks through platform callback
15
+ * routing and never run `vellum tunnel`, so they report `unconfigured`
16
+ * rather than a tunnel state they cannot act on. A self-hosted gateway whose
17
+ * Velay tunnel owns the URL is the same story one layer down: that URL
18
+ * carries webhooks alone, so it is `unconfigured` for pairing too, and the
19
+ * gateway publishes and restores it without a tunnel command either way.
20
+ */
21
+ import { normalizePublicBaseUrl } from "@vellumai/service-contracts/ingress";
22
+ import { z } from "zod";
23
+
24
+ import {
25
+ getIngressConfigResult,
26
+ isVelayManagedIngress,
27
+ loadLastTunnelRecord,
28
+ loadPairingTunnelRecord,
29
+ loadRecordedAssistantId,
30
+ } from "../../daemon/handlers/config-ingress.js";
31
+ import { probeTunnel } from "../../inbound/tunnel-probe.js";
32
+ import { ACTOR_PRINCIPALS } from "../auth/route-policy.js";
33
+ import type { RouteDefinition } from "./types.js";
34
+
35
+ // ── Schemas ─────────────────────────────────────────────────────────────
36
+
37
+ /**
38
+ * Flat rather than a union on `state` so the generated client SDK stays a
39
+ * single type; which fields are populated follows from `state`.
40
+ */
41
+ const IngressStatusResponseSchema = z.object({
42
+ state: z.enum([
43
+ "unconfigured",
44
+ "stopped",
45
+ "healthy",
46
+ "unpairable",
47
+ "unreachable",
48
+ "foreign",
49
+ ]),
50
+ publicBaseUrl: z
51
+ .string()
52
+ .optional()
53
+ .describe(
54
+ "The probed URL. Set for healthy, unpairable, unreachable, and foreign.",
55
+ ),
56
+ lastTunnel: z
57
+ .object({ provider: z.string(), publicBaseUrl: z.string() })
58
+ .optional()
59
+ .describe(
60
+ "The tunnel to restart. Set on stopped whenever one is recorded, and on unpairable, unreachable and foreign when the recorded tunnel fronted the configured URL.",
61
+ ),
62
+ servingAssistantName: z
63
+ .string()
64
+ .optional()
65
+ .describe(
66
+ "Name the edge serves under. Set for foreign when it reports one.",
67
+ ),
68
+ detail: z
69
+ .string()
70
+ .optional()
71
+ .describe(
72
+ "Short failure reason, free of the URL. Set for unreachable, and for unpairable when the edge gave one.",
73
+ ),
74
+ checkedAt: z
75
+ .string()
76
+ .optional()
77
+ .describe("ISO-8601 instant the probe finished. Set whenever one ran."),
78
+ });
79
+ type IngressStatusResponse = z.infer<typeof IngressStatusResponseSchema>;
80
+
81
+ // ── Handlers ────────────────────────────────────────────────────────────
82
+
83
+ async function handleIngressStatus(): Promise<IngressStatusResponse> {
84
+ const config = getIngressConfigResult();
85
+ if (config.managedCallbacks) {
86
+ return { state: "unconfigured" };
87
+ }
88
+
89
+ // A tunnel published for pairing alone is the address this route reports on:
90
+ // it exists to answer the pairing card, and the `publicBaseUrl` beside it is
91
+ // a webhook callback base that tunnel deliberately left in place. The user
92
+ // owns and restarts that tunnel even where Velay owns the callback ingress.
93
+ const pairingTunnel = loadPairingTunnelRecord();
94
+ // A Velay-managed URL belongs to the gateway, which writes it, clears it,
95
+ // and reconnects on its own, so there is no tunnel for the user to restart.
96
+ // Velay's allowlist (`gateway/src/velay/allowed-paths.ts`) also exposes
97
+ // neither `/healthz` nor the `/assistant/*` pairing surface, so that URL can
98
+ // only ever probe as dead and prefills a page pairing cannot open. Without a
99
+ // pairing tunnel beside it there is no address to report at all.
100
+ if (isVelayManagedIngress() && !pairingTunnel) {
101
+ return { state: "unconfigured" };
102
+ }
103
+ const lastTunnel = pairingTunnel ?? loadLastTunnelRecord();
104
+
105
+ const publicBaseUrl =
106
+ pairingTunnel?.publicBaseUrl ?? config.publicBaseUrl.trim();
107
+ if (!publicBaseUrl && !lastTunnel) {
108
+ return { state: "unconfigured" };
109
+ }
110
+ // `ingress.enabled` governs callback ingress alone, and the URL survives
111
+ // that toggle, so probing a callback base while ingress is opted out would
112
+ // report an address the user switched off as healthy. A pairing tunnel is
113
+ // published outside the toggle, so the opt-out says nothing about it. An
114
+ // unset flag is not an opt-out either: a bring-your-own-HTTPS front sets
115
+ // only the URL.
116
+ if (!publicBaseUrl || (!pairingTunnel && config.explicitlyDisabled)) {
117
+ return { state: "stopped", ...(lastTunnel ? { lastTunnel } : {}) };
118
+ }
119
+
120
+ // A record left over from an address that is no longer configured names a
121
+ // tunnel that never fronted this one, so it is no help in getting back.
122
+ const restartHint =
123
+ lastTunnel &&
124
+ normalizePublicBaseUrl(lastTunnel.publicBaseUrl) ===
125
+ normalizePublicBaseUrl(publicBaseUrl)
126
+ ? { lastTunnel }
127
+ : {};
128
+
129
+ // Omitted when unrecorded so the probe skips the identity check entirely
130
+ // rather than reading every served id as a mismatch.
131
+ const expectedAssistantId = loadRecordedAssistantId();
132
+ const result = await probeTunnel({
133
+ publicBaseUrl,
134
+ ...(expectedAssistantId ? { expectedAssistantId } : {}),
135
+ });
136
+ const checked = { publicBaseUrl, checkedAt: new Date().toISOString() };
137
+
138
+ switch (result.kind) {
139
+ case "healthy":
140
+ return { state: "healthy", ...checked };
141
+ // One remedy for both: start a tunnel that serves the web app.
142
+ case "unpairable":
143
+ case "unreachable":
144
+ return {
145
+ state: result.kind,
146
+ ...checked,
147
+ ...restartHint,
148
+ ...(result.detail ? { detail: result.detail } : {}),
149
+ };
150
+ case "foreign":
151
+ return {
152
+ state: "foreign",
153
+ ...checked,
154
+ ...restartHint,
155
+ ...(result.assistantName
156
+ ? { servingAssistantName: result.assistantName }
157
+ : {}),
158
+ };
159
+ }
160
+ }
161
+
162
+ // ── Route definitions ───────────────────────────────────────────────────
163
+
164
+ export const ROUTES: RouteDefinition[] = [
165
+ {
166
+ operationId: "integrations_ingress_status",
167
+ endpoint: "integrations/ingress/status",
168
+ method: "GET",
169
+ policy: {
170
+ requiredScopes: ["settings.read"],
171
+ allowedPrincipalTypes: ACTOR_PRINCIPALS,
172
+ },
173
+ summary: "Get ingress tunnel status",
174
+ description:
175
+ "Probe the configured public ingress URL and report whether a tunnel is serving this assistant. `unconfigured` means no tunnel has ever been recorded (or the ingress is managed for this assistant, as it is when platform-hosted or fronted by a Velay tunnel), `stopped` means a tunnel ran before and is not running now (callback ingress is explicitly switched off, or its URL is gone), `healthy` means the URL answers and fronts this assistant's web app, `unpairable` means it answers but does not serve that app, so a pairing link minted against it would not open, `unreachable` means it does not answer, and `foreign` means it answers for a different assistant. `lastTunnel` names the tunnel to restart, on the states where a recorded one applies to the configured URL.",
176
+ tags: ["config"],
177
+ handler: handleIngressStatus,
178
+ responseBody: IngressStatusResponseSchema,
179
+ },
180
+ ];
@@ -56,6 +56,7 @@ const sampleEventsSchema = z.object({
56
56
  const sampleMemoryStatSchema = z.object({
57
57
  anonBytes: z.number().nullable(),
58
58
  fileBytes: z.number().nullable(),
59
+ inactiveFileBytes: z.number().nullable(),
59
60
  kernelBytes: z.number().nullable(),
60
61
  slabReclaimableBytes: z.number().nullable(),
61
62
  slabUnreclaimableBytes: z.number().nullable(),
@@ -195,9 +196,16 @@ function readLatestSample(): ResourceSample | null {
195
196
  }
196
197
  // Samples persisted by an older monitor may predate some fields; fill
197
198
  // them with null so the response always matches the documented shape.
199
+ // The nested memoryStat needs the same backfill for fields added after
200
+ // a sample was written.
198
201
  return {
199
202
  ...sample,
200
- memoryStat: sample.memoryStat ?? null,
203
+ memoryStat: sample.memoryStat
204
+ ? {
205
+ ...sample.memoryStat,
206
+ inactiveFileBytes: sample.memoryStat.inactiveFileBytes ?? null,
207
+ }
208
+ : null,
201
209
  reclaim: sample.reclaim ?? null,
202
210
  cpu: sample.cpu ?? null,
203
211
  deltas: sample.deltas ?? null,
@@ -749,7 +749,7 @@ function readBodyData(data: string): unknown {
749
749
  return tryJsonParse(data);
750
750
  }
751
751
 
752
- async function handleRequest({ body = {} }: RouteHandlerArgs) {
752
+ export async function handleRequest({ body = {} }: RouteHandlerArgs) {
753
753
  const b = body as {
754
754
  provider: string;
755
755
  url: string;
@@ -1641,29 +1641,6 @@ function mapTogglePluginError(err: unknown): RouteError {
1641
1641
  );
1642
1642
  }
1643
1643
 
1644
- /**
1645
- * Converge plugin-declared schedules against the sentinel this route just
1646
- * wrote, so a toggled plugin's rows disarm or re-arm now rather than at the
1647
- * reconciler's next backstop sweep.
1648
- *
1649
- * Fire-and-forget: the toggle itself already succeeded on disk, so a reconcile
1650
- * failure must not turn it into a route error. Imported lazily, matching the
1651
- * plugin source reconcile's own hook, to keep the schedule and notification
1652
- * modules out of this route module's static graph. The scheduler applies the
1653
- * sentinel at fire time as well, so a slow or failed pass here delays the row
1654
- * bookkeeping without letting a disabled plugin run.
1655
- */
1656
- function reconcilePluginSchedulesInBackground(): void {
1657
- void import("../../schedule/plugin-schedule-reconciler.js")
1658
- .then(({ reconcilePluginSchedules }) => reconcilePluginSchedules())
1659
- .catch((err: unknown) => {
1660
- log.error(
1661
- { err },
1662
- "plugin schedule reconcile after a plugin toggle failed",
1663
- );
1664
- });
1665
- }
1666
-
1667
1644
  /**
1668
1645
  * Toggle a plugin's `.disabled` sentinel through the shared toggle-plugin lib,
1669
1646
  * then publish a generic `sync_changed(plugins:list)` so every client refetches
@@ -1671,26 +1648,45 @@ function reconcilePluginSchedulesInBackground(): void {
1671
1648
  * names WHICH resource is stale, not the new value. The origin client id is
1672
1649
  * threaded through for self-echo suppression.
1673
1650
  */
1674
- function handleEnablePlugin({ pathParams = {}, headers }: RouteHandlerArgs) {
1651
+ async function handleEnablePlugin({
1652
+ pathParams = {},
1653
+ headers,
1654
+ }: RouteHandlerArgs) {
1675
1655
  try {
1676
1656
  enablePlugin(pathParams.name ?? "");
1677
- publishPluginsChanged(getOriginClientId(headers));
1678
- reconcilePluginSchedulesInBackground();
1679
- return { ok: true };
1680
1657
  } catch (err) {
1681
1658
  throw mapTogglePluginError(err);
1682
1659
  }
1660
+ // A plugin the boot scan skipped for its sentinel has no hooks, tools or
1661
+ // MCP servers in the caches, so clearing the sentinel is not enough to
1662
+ // bring it up. Run the same imperative source reconcile the install and
1663
+ // upgrade routes use, which activates the plugin and then converges its
1664
+ // schedules and MCP servers. Awaited, like the install route, so a client
1665
+ // that lists tools right after enabling sees the plugin up; the reconcile
1666
+ // contains its own failures, so a broken plugin cannot turn a successful
1667
+ // enable into a route error. The invalidation publishes after it for the
1668
+ // same reason: refetching clients should see the post-activation state.
1669
+ await reconcilePluginSourcesNow();
1670
+ publishPluginsChanged(getOriginClientId(headers));
1671
+ return { ok: true };
1683
1672
  }
1684
1673
 
1685
- function handleDisablePlugin({ pathParams = {}, headers }: RouteHandlerArgs) {
1674
+ async function handleDisablePlugin({
1675
+ pathParams = {},
1676
+ headers,
1677
+ }: RouteHandlerArgs) {
1686
1678
  try {
1687
1679
  disablePlugin(pathParams.name ?? "");
1688
- publishPluginsChanged(getOriginClientId(headers));
1689
- reconcilePluginSchedulesInBackground();
1690
- return { ok: true };
1691
1680
  } catch (err) {
1692
1681
  throw mapTogglePluginError(err);
1693
1682
  }
1683
+ // Same poke enable uses. The sentinel hides tools and hooks at read time,
1684
+ // but a plugin that already ran `init` still owns in-process work (a live
1685
+ // gRPC subscribe, a poll worker). The source reconcile is what runs
1686
+ // `shutdown` and drops that work before this route returns.
1687
+ await reconcilePluginSourcesNow();
1688
+ publishPluginsChanged(getOriginClientId(headers));
1689
+ return { ok: true };
1694
1690
  }
1695
1691
 
1696
1692
  // ---------------------------------------------------------------------------
@@ -2134,7 +2130,7 @@ export const ROUTES: RouteDefinition[] = [
2134
2130
  },
2135
2131
  summary: "Disable a plugin",
2136
2132
  description:
2137
- "Disable a plugin in this workspace by dropping a `.disabled` sentinel, mirroring the CLI's `assistant plugins disable <name>`. The change is honored live at read time by every tool / injector / hook gate — no restart required. Broadcasts a `sync_changed` invalidation carrying the `plugins:list` tag so other clients refetch `GET /v1/plugins`. An already-disabled plugin returns 409; a user plugin with no directory returns 404 (default plugins are stubbed on demand via the `default-` prefix); a malformed name returns 400.",
2133
+ "Disable a plugin in this workspace by dropping a `.disabled` sentinel, mirroring the CLI's `assistant plugins disable <name>`. Awaits the same source reconcile enable uses so the plugin's shutdown hook runs. Tools, injectors, and hook gates also honor the sentinel at read time. Broadcasts a `sync_changed` invalidation carrying the `plugins:list` tag so other clients refetch `GET /v1/plugins`. An already-disabled plugin returns 409; a user plugin with no directory returns 404 (default plugins are stubbed on demand via the `default-` prefix); a malformed name returns 400.",
2138
2134
  tags: ["plugins"],
2139
2135
  pathParams: [
2140
2136
  {
@@ -0,0 +1,22 @@
1
+ import { ResourcePressureStatusResponseSchema } from "../../api/responses/resource-pressure-status.js";
2
+ import { getResourcePressureStatus } from "../../daemon/resource-pressure-guard.js";
3
+ import { ACTOR_PRINCIPALS } from "../auth/route-policy.js";
4
+ import type { RouteDefinition } from "./types.js";
5
+
6
+ export const ROUTES: RouteDefinition[] = [
7
+ {
8
+ operationId: "getResourcePressureStatus",
9
+ endpoint: "resource-pressure/status",
10
+ method: "GET",
11
+ policy: {
12
+ requiredScopes: ["settings.read"],
13
+ allowedPrincipalTypes: ACTOR_PRINCIPALS,
14
+ },
15
+ summary: "Get resource pressure status",
16
+ description:
17
+ "Return the current resource pressure status snapshot. Off-platform the guard does not run, so a disabled status is returned.",
18
+ tags: ["resource-pressure"],
19
+ responseBody: ResourcePressureStatusResponseSchema,
20
+ handler: () => ({ status: getResourcePressureStatus() }),
21
+ },
22
+ ];
@@ -58,7 +58,16 @@ import {
58
58
  } from "../../tools/credentials/metadata-store.js";
59
59
  import { getLogger } from "../../util/logger.js";
60
60
  import { ACTOR_PRINCIPALS } from "../auth/route-policy.js";
61
- import { BadRequestError, InternalError, NotFoundError } from "./errors.js";
61
+ import {
62
+ assertCredentialNotInUse,
63
+ invalidateConnectionsAfterCredentialDelete,
64
+ } from "./credential-in-use.js";
65
+ import {
66
+ BadRequestError,
67
+ InternalError,
68
+ NotFoundError,
69
+ RouteError,
70
+ } from "./errors.js";
62
71
  import type { RouteDefinition, RouteHandlerArgs } from "./types.js";
63
72
 
64
73
  const log = getLogger("runtime-http");
@@ -550,7 +559,11 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
550
559
  throw new BadRequestError("Request body is required");
551
560
  }
552
561
 
553
- const { type, name } = body as { type?: string; name?: string };
562
+ const { type, name, force } = body as {
563
+ type?: string;
564
+ name?: string;
565
+ force?: boolean;
566
+ };
554
567
 
555
568
  if (!type || typeof type !== "string") {
556
569
  throw new BadRequestError("type is required");
@@ -583,6 +596,13 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
583
596
  throw new NotFoundError(`API key not found: ${name}`);
584
597
  }
585
598
  }
599
+ // Provider connections reference the namespaced account, so the in-use
600
+ // check keys off `credKey`: the bare pre-migration account is never a
601
+ // connection's `resolve_auth` target.
602
+ const affectedConnections = assertCredentialNotInUse(
603
+ credKey,
604
+ force === true,
605
+ );
586
606
  // Delete from both locations. During a migration overlap both may exist;
587
607
  // ignore "not-found" since one location may already be empty.
588
608
  const credDeleteResult = await deleteSecureKeyAsync(credKey);
@@ -598,6 +618,7 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
598
618
  );
599
619
  }
600
620
  await refreshProvidersAfterSecretChange();
621
+ invalidateConnectionsAfterCredentialDelete(affectedConnections);
601
622
  log.info({ provider: name }, "API key deleted via HTTP");
602
623
  return { success: true, type, name };
603
624
  }
@@ -617,6 +638,7 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
617
638
  if (existing === undefined) {
618
639
  throw new NotFoundError(`Credential not found: ${name}`);
619
640
  }
641
+ const affectedConnections = assertCredentialNotInUse(key, force === true);
620
642
  const deleteResult = await deleteSecureKeyAsync(key);
621
643
  if (deleteResult === "error") {
622
644
  throw new InternalError(
@@ -639,6 +661,7 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
639
661
  if (isManagedProxyCredential(service, field)) {
640
662
  await refreshProvidersAfterSecretChange();
641
663
  }
664
+ invalidateConnectionsAfterCredentialDelete(affectedConnections);
642
665
  log.info({ service, field }, "Credential deleted via HTTP");
643
666
  return { success: true, type, name };
644
667
  }
@@ -647,11 +670,10 @@ async function handleDeleteSecret({ body }: RouteHandlerArgs) {
647
670
  `Unknown secret type: ${type}. Valid types: api_key, credential`,
648
671
  );
649
672
  } catch (err) {
650
- if (
651
- err instanceof BadRequestError ||
652
- err instanceof InternalError ||
653
- err instanceof NotFoundError
654
- ) {
673
+ // Every RouteError is already a deliberate client-facing outcome (including
674
+ // CREDENTIAL_IN_USE); re-wrapping one as a 500 would hide its code, status,
675
+ // and details from the caller.
676
+ if (err instanceof RouteError) {
655
677
  throw err;
656
678
  }
657
679
  const message = err instanceof Error ? err.message : String(err);
@@ -793,11 +815,20 @@ export const ROUTES: RouteDefinition[] = [
793
815
  allowedPrincipalTypes: ACTOR_PRINCIPALS,
794
816
  },
795
817
  summary: "Delete a secret",
796
- description: "Remove a secret from the credential vault by name.",
818
+ description:
819
+ "Remove a secret from the credential vault by name. Refused with " +
820
+ "CREDENTIAL_IN_USE while an LLM provider connection resolves its auth " +
821
+ "through the credential, unless `force` is set.",
797
822
  tags: ["secrets"],
798
823
  requestBody: z.object({
799
824
  type: z.string().describe("Secret type: 'api_key' or 'credential'"),
800
825
  name: z.string().describe("Name of the secret to delete"),
826
+ force: z
827
+ .boolean()
828
+ .optional()
829
+ .describe(
830
+ "Delete even when provider connections depend on the credential",
831
+ ),
801
832
  }),
802
833
  responseBody: z.object({
803
834
  success: z.boolean(),
@@ -6,6 +6,7 @@
6
6
  import { readFileSync } from "node:fs";
7
7
  import { basename, join } from "node:path";
8
8
 
9
+ import { normalizePublicBaseUrl } from "@vellumai/service-contracts/ingress";
9
10
  import { z } from "zod";
10
11
 
11
12
  import { setImage } from "../../avatar/avatar-store.js";
@@ -24,6 +25,7 @@ import {
24
25
  } from "../../daemon/conversation-tool-setup.js";
25
26
  import {
26
27
  computeGatewayTarget,
28
+ dropTunnelRecordsForNewUrl,
27
29
  getIngressConfigResult,
28
30
  } from "../../daemon/handlers/config-ingress.js";
29
31
  import { normalizeActivationKey } from "../../daemon/handlers/config-voice.js";
@@ -37,7 +39,6 @@ import {
37
39
  import {
38
40
  check,
39
41
  classifyRisk,
40
- generateAllowlistOptions,
41
42
  generateScopeOptions,
42
43
  } from "../../permissions/checker.js";
43
44
  import { resolveGuardianPersonaPath } from "../../prompts/persona-resolver.js";
@@ -710,19 +711,22 @@ async function handleToolPermissionSimulate({ body = {} }: RouteHandlerArgs) {
710
711
  isInteractive === false ? "headless" : "conversation";
711
712
  const policyContext = { executionTarget, executionContext } as const;
712
713
 
713
- const { level: riskLevel } = await classifyRisk(
714
+ const classification = await classifyRisk(
714
715
  toolName,
715
716
  input,
716
717
  workingDir,
717
718
  undefined,
718
719
  manifestOverride,
719
720
  );
721
+ const riskLevel = classification.level;
720
722
  const result = await check(
721
723
  toolName,
722
724
  input,
723
725
  workingDir,
724
726
  policyContext,
725
727
  manifestOverride,
728
+ undefined,
729
+ classification,
726
730
  );
727
731
 
728
732
  if (isInteractive === false && result.decision === "prompt") {
@@ -743,11 +747,9 @@ async function handleToolPermissionSimulate({ body = {} }: RouteHandlerArgs) {
743
747
  | undefined;
744
748
 
745
749
  if (result.decision === "prompt") {
746
- const allowlistOptions = await generateAllowlistOptions(toolName, input);
747
- const scopeOptions = generateScopeOptions(workingDir, toolName);
748
750
  promptPayload = {
749
- allowlistOptions,
750
- scopeOptions,
751
+ allowlistOptions: classification.allowlistOptions ?? [],
752
+ scopeOptions: generateScopeOptions(workingDir, toolName),
751
753
  persistentDecisionsAllowed: true,
752
754
  };
753
755
  }
@@ -837,12 +839,12 @@ function handleGetPlatformConfig() {
837
839
  function handleUpdatePlatformConfig({ body = {} }: RouteHandlerArgs) {
838
840
  try {
839
841
  const { baseUrl: rawBaseUrl } = body as { baseUrl?: string };
840
- const value = (rawBaseUrl ?? "").trim().replace(/\/+$/, "");
842
+ const value = normalizePublicBaseUrl(rawBaseUrl);
841
843
  const raw = loadRawConfig();
842
844
  const platform = (raw?.platform ?? {}) as Record<string, unknown>;
843
- platform.baseUrl = value || undefined;
845
+ platform.baseUrl = value;
844
846
  saveRawConfig({ ...raw, platform });
845
- return { baseUrl: value, success: true };
847
+ return { baseUrl: value ?? "", success: true };
846
848
  } catch (err) {
847
849
  const message = err instanceof Error ? err.message : String(err);
848
850
  log.error({ err }, "Failed to update platform config");
@@ -860,10 +862,11 @@ function handleUpdateIngressConfig({ body = {} }: RouteHandlerArgs) {
860
862
  publicBaseUrl?: string;
861
863
  enabled?: boolean;
862
864
  };
863
- const value = (rawUrl ?? "").trim().replace(/\/+$/, "");
865
+ const value = normalizePublicBaseUrl(rawUrl);
864
866
  const raw = loadRawConfig();
865
867
  const ingress = (raw?.ingress ?? {}) as Record<string, unknown>;
866
- ingress.publicBaseUrl = value || undefined;
868
+ dropTunnelRecordsForNewUrl(ingress, value);
869
+ ingress.publicBaseUrl = value;
867
870
  if (enabled !== undefined) {
868
871
  ingress.enabled = enabled;
869
872
  }
@@ -878,7 +881,7 @@ function handleUpdateIngressConfig({ body = {} }: RouteHandlerArgs) {
878
881
 
879
882
  return {
880
883
  enabled: isEnabled,
881
- publicBaseUrl: value,
884
+ publicBaseUrl: value ?? "",
882
885
  localGatewayTarget: computeGatewayTarget(),
883
886
  success: true,
884
887
  };
@@ -37,26 +37,25 @@ const log = getLogger("surface-action-routes");
37
37
 
38
38
  /**
39
39
  * Resolve trust context for the actor principal from the gateway guardian
40
- * binding and set it on the conversation. A vellum principal is the guardian or
41
- * nobody, so the mapper yields guardian or unknown. Resolution (including the
42
- * dev-bypass principal translation and the mutating reset-drift repair) lives
43
- * in the shared {@link resolveVellumActorTrustContext} so the surface content
44
- * route's read-only requester scoping cannot drift from it.
40
+ * binding, and return it for the caller to attribute this action with. A vellum
41
+ * principal is the guardian or nobody, so the mapper yields guardian or
42
+ * unknown. Resolution (including the dev-bypass principal translation and the
43
+ * mutating reset-drift repair) lives in the shared
44
+ * {@link resolveVellumActorTrustContext} so the surface content route's
45
+ * read-only requester scoping cannot drift from it.
46
+ *
47
+ * Resolution only: the requester travels to `handleSurfaceAction` as an
48
+ * argument, and the conversation's slot is stamped there, at the point the
49
+ * click is committed to starting a turn. Stamping here instead would repoint
50
+ * the actor of a turn already in flight, or of a turn that starts between this
51
+ * call and the dispatch.
45
52
  */
46
- async function applyTrustContext(
47
- conversation: {
48
- setTrustContext?(ctx: TrustContext): void;
49
- },
53
+ async function resolveRequesterTrustContext(
50
54
  actorPrincipalId: string | undefined,
51
- ): Promise<void> {
52
- if (!conversation.setTrustContext) {
53
- return;
54
- }
55
- conversation.setTrustContext(
56
- await resolveVellumActorTrustContext(actorPrincipalId, {
57
- healResetDrift: true,
58
- }),
59
- );
55
+ ): Promise<TrustContext> {
56
+ return resolveVellumActorTrustContext(actorPrincipalId, {
57
+ healResetDrift: true,
58
+ });
60
59
  }
61
60
 
62
61
  // ---------------------------------------------------------------------------
@@ -154,7 +153,8 @@ async function handleSurfaceAction({
154
153
  }
155
154
 
156
155
  const actorPrincipalId = headers?.["x-vellum-actor-principal-id"];
157
- await applyTrustContext(conversation, actorPrincipalId);
156
+ const requesterTrustContext =
157
+ await resolveRequesterTrustContext(actorPrincipalId);
158
158
 
159
159
  // Translate dev-bypass → real guardian so the surface turn's principal matches
160
160
  // the SSE host-proxy client's registered principal; otherwise CU/app-control
@@ -170,6 +170,7 @@ async function handleSurfaceAction({
170
170
  actionId,
171
171
  data,
172
172
  resolvedActorPrincipalId,
173
+ requesterTrustContext,
173
174
  );
174
175
  const result =
175
176
  raw && typeof raw === "object" && "accepted" in raw
@@ -37,6 +37,7 @@
37
37
 
38
38
  import { statSync } from "node:fs";
39
39
 
40
+ import { runInPluginContext } from "../../plugins/plugin-execution-context.js";
40
41
  import { isRouteHostEnabled } from "../../routes/control.js";
41
42
  import {
42
43
  RouteHostClient,
@@ -55,6 +56,7 @@ import {
55
56
  routeSourceRoot,
56
57
  } from "./user-route-import.js";
57
58
  import {
59
+ pluginNameForRoutePath,
58
60
  resolveHandlerFile,
59
61
  resolveRouteLocation,
60
62
  } from "./user-route-resolution.js";
@@ -150,11 +152,36 @@ export class UserRouteDispatcher {
150
152
  );
151
153
  }
152
154
 
155
+ // A plugin's own routes execute as that plugin, so the host APIs a handler
156
+ // reaches scope to it exactly as they do inside its hooks and tools. Both
157
+ // execution paths carry it: in-thread here, and the route host through the
158
+ // invoke params it marks its own execution with.
159
+ const pluginName = pluginNameForRoutePath(routePath);
160
+
153
161
  if (isRouteHostEnabled()) {
154
- return this.dispatchViaHost(filePath, routePath, request);
162
+ return this.dispatchViaHost(filePath, routePath, request, pluginName);
155
163
  }
156
164
 
157
- const mod = await this.loadModule(filePath, location.routesDir);
165
+ // The context covers module evaluation, not just the handler call. A route
166
+ // module can reach a scoped host API at import time (a top-level `await`),
167
+ // and that import happens once per mtime, so a load left outside the
168
+ // context would take the unscoped branch and never be re-run scoped.
169
+ const serve = () =>
170
+ this.serveInThread(filePath, location.routesDir, routePath, request);
171
+ return pluginName ? runInPluginContext(pluginName, serve) : serve();
172
+ }
173
+
174
+ /**
175
+ * Load the handler module and run the method's handler in this thread.
176
+ * Called inside the owning plugin's execution context, when the route has one.
177
+ */
178
+ private async serveInThread(
179
+ filePath: string,
180
+ routesDir: string,
181
+ routePath: string,
182
+ request: Request,
183
+ ): Promise<Response> {
184
+ const mod = await this.loadModule(filePath, routesDir);
158
185
  const method = request.method as HttpMethod;
159
186
  const handler = mod.handlers[method];
160
187
 
@@ -180,6 +207,7 @@ export class UserRouteDispatcher {
180
207
  filePath: string,
181
208
  routePath: string,
182
209
  request: Request,
210
+ pluginName: string | undefined,
183
211
  ): Promise<Response> {
184
212
  const mtimeMs = statSync(filePath).mtimeMs;
185
213
 
@@ -201,6 +229,7 @@ export class UserRouteDispatcher {
201
229
  method: request.method,
202
230
  url: request.url,
203
231
  headers,
232
+ pluginName,
204
233
  },
205
234
  body,
206
235
  );