@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,168 @@
1
+ /**
2
+ * Credential write path. The single sequence every "store a credential"
3
+ * caller runs.
4
+ *
5
+ * Storing a credential is not one write: the plaintext goes to the secure
6
+ * backend, the value is scrubbed from recent transcripts, the metadata record
7
+ * is upserted, and manual-token providers reconcile their connection row.
8
+ * Order matters (see {@link storeCredentialValue}), so the sequence lives here
9
+ * rather than being re-typed per entry point. The `credentials/set` route and
10
+ * the plugin-facing {@link ../../plugin-api/store-credential.storeCredential}
11
+ * both compose it.
12
+ *
13
+ * The transcript scrub and the connection sync are imported lazily, at the
14
+ * point of use. Both pull heavy graphs behind them (the scrub reaches the
15
+ * conversation database and registry; the sync reaches the OAuth store), and
16
+ * this module sits under `@vellumai/plugin-api`, so a static edge would drag
17
+ * that machinery into every plugin-api consumer for a write most of them never
18
+ * perform.
19
+ *
20
+ * Callers own their own transport-level argument validation and error mapping;
21
+ * this module throws {@link InvalidCredentialInputError} for a value it will
22
+ * not store and {@link CredentialStorageError} when the secure backend write
23
+ * fails.
24
+ */
25
+
26
+ import {
27
+ ACP_SERVICE,
28
+ assertAcpCredentialFormat,
29
+ } from "../../acp/acp-credentials.js";
30
+ import { credentialKey } from "../../security/credential-key.js";
31
+ import { normalizeSecretValue } from "../../security/secret-normalize.js";
32
+ import {
33
+ getActiveBackendName,
34
+ setSecureKeyAsync,
35
+ } from "../../security/secure-keys.js";
36
+ import { getLogger } from "../../util/logger.js";
37
+ import {
38
+ assertMetadataWritable,
39
+ upsertCredentialMetadata,
40
+ } from "./metadata-store.js";
41
+ import type { CredentialInjectionTemplate } from "./policy-types.js";
42
+
43
+ const log = getLogger("credential-store");
44
+
45
+ /** Raised for a value the store refuses before writing anything. */
46
+ export class InvalidCredentialInputError extends Error {
47
+ constructor(message: string) {
48
+ super(message);
49
+ this.name = "InvalidCredentialInputError";
50
+ }
51
+ }
52
+
53
+ /** Raised when the secure backend write itself fails. */
54
+ export class CredentialStorageError extends Error {
55
+ constructor(message: string) {
56
+ super(message);
57
+ this.name = "CredentialStorageError";
58
+ }
59
+ }
60
+
61
+ export interface StoreCredentialValueInput {
62
+ service: string;
63
+ field: string;
64
+ /** Plaintext value. Edge whitespace is trimmed before storage. */
65
+ value: string;
66
+ /** Human-friendly alias shown in credential listings. */
67
+ alias?: string;
68
+ /** What the credential is for, surfaced to the agent. */
69
+ usageDescription?: string;
70
+ allowedTools?: string[];
71
+ allowedDomains?: string[];
72
+ injectionTemplates?: CredentialInjectionTemplate[];
73
+ /**
74
+ * Skip the retroactive transcript scrub. Set it only when the plaintext
75
+ * provably never transited a conversation (a token minted by an OAuth
76
+ * refresh, say), since the scrub is a bounded but real sweep of recent
77
+ * history.
78
+ */
79
+ skipTranscriptScrub?: boolean;
80
+ }
81
+
82
+ export interface StoredCredential {
83
+ credentialId: string;
84
+ service: string;
85
+ field: string;
86
+ }
87
+
88
+ /**
89
+ * Store a credential's plaintext and reconcile everything that hangs off it.
90
+ *
91
+ * The order is load-bearing:
92
+ * 1. Validate the value (and the ACP format guard) so a rejected write leaves
93
+ * no side effects.
94
+ * 2. Fail early when credential metadata is not writable.
95
+ * 3. Write the plaintext to the secure backend.
96
+ * 4. Scrub the value from recent transcripts. This runs BEFORE the metadata
97
+ * upsert and the connection sync, because those can throw and a
98
+ * stored-but-unscrubbed secret must not depend on them succeeding. The
99
+ * credential IS stored at this point, so the scrub is best-effort hygiene
100
+ * and stays invisible to the caller.
101
+ * 5. Upsert metadata and reconcile the manual-token connection row.
102
+ *
103
+ * @throws {InvalidCredentialInputError} when the value is empty or malformed
104
+ * for its service.
105
+ * @throws {CredentialStorageError} when the secure backend rejects the write.
106
+ */
107
+ export async function storeCredentialValue(
108
+ input: StoreCredentialValueInput,
109
+ ): Promise<StoredCredential> {
110
+ const { service, field } = input;
111
+
112
+ const value = normalizeSecretValue(input.value);
113
+ if (value.length === 0) {
114
+ throw new InvalidCredentialInputError("value is required");
115
+ }
116
+
117
+ // Reject an Anthropic API key pasted into the ACP OAuth-token field (a 401
118
+ // footgun) before it reaches storage.
119
+ if (service === ACP_SERVICE) {
120
+ assertAcpCredentialFormat(field, value);
121
+ }
122
+
123
+ assertMetadataWritable();
124
+
125
+ const stored = await setSecureKeyAsync(credentialKey(service, field), value);
126
+ if (!stored) {
127
+ throw new CredentialStorageError(
128
+ `Failed to store credential in secure storage (backend: ${getActiveBackendName()})`,
129
+ );
130
+ }
131
+
132
+ // The stored plaintext may already sit in recent transcripts: the user
133
+ // message that pasted it, the persisted tool_use input, the tool result
134
+ // echoing the command. This is the scrub seam, not setSecureKeyAsync, which
135
+ // also fires on OAuth refresh rotations and MCP header writes whose values
136
+ // never transited a transcript.
137
+ if (!input.skipTranscriptScrub) {
138
+ const { isNonSecretPlatformField, scrubStoredCredentialFromTranscripts } =
139
+ await import("../../daemon/credential-transcript-scrub.js");
140
+ if (!isNonSecretPlatformField(service, field)) {
141
+ try {
142
+ const scrubbed = await scrubStoredCredentialFromTranscripts(value);
143
+ log.info(
144
+ { service, field, ...scrubbed },
145
+ "Credential stored; scrubbed value from recent transcripts",
146
+ );
147
+ } catch (err) {
148
+ log.warn(
149
+ { err, service, field },
150
+ "Credential stored, but transcript scrub failed",
151
+ );
152
+ }
153
+ }
154
+ }
155
+
156
+ const metadata = upsertCredentialMetadata(service, field, {
157
+ alias: input.alias,
158
+ usageDescription: input.usageDescription,
159
+ allowedTools: input.allowedTools,
160
+ allowedDomains: input.allowedDomains,
161
+ injectionTemplates: input.injectionTemplates,
162
+ });
163
+ const { syncManualTokenConnection } =
164
+ await import("../../oauth/manual-token-connection.js");
165
+ await syncManualTokenConnection(service);
166
+
167
+ return { credentialId: metadata.credentialId, service, field };
168
+ }
@@ -5,6 +5,8 @@
5
5
  * based on the credential's allowed tools list.
6
6
  */
7
7
 
8
+ import type { CredentialMetadata } from "./metadata-store.js";
9
+
8
10
  /**
9
11
  * Canonical capability key for browser-based credential fills.
10
12
  *
@@ -64,3 +66,68 @@ export function isToolAllowed(
64
66
  (allowed) => resolveCanonical(allowed) === canonical,
65
67
  );
66
68
  }
69
+
70
+ /**
71
+ * Remediation for a credential whose allowed_tools list is empty. Points at
72
+ * `credentials prompt` (not inline `credentials set`, which agent shells
73
+ * refuse): the secure prompt re-collects the value and sets allowed_tools.
74
+ */
75
+ const NO_TOOLS_ALLOWED_REMEDIATION =
76
+ "No tools are currently allowed - grant access via `assistant credentials prompt --service <service> --field <field> --label <label> --allowed-tools <tools>` (re-collects the value securely and sets allowed_tools).";
77
+
78
+ /** Denial reason for a tool that is not in a credential's allowed_tools list. */
79
+ export function toolNotAllowedReason(
80
+ toolName: string,
81
+ service: string,
82
+ field: string,
83
+ allowedTools: string[] | undefined,
84
+ ): string {
85
+ const tools = allowedTools ?? [];
86
+ return (
87
+ `Tool "${toolName}" is not allowed to use credential ${service}/${field}. ` +
88
+ (tools.length === 0
89
+ ? NO_TOOLS_ALLOWED_REMEDIATION
90
+ : `Allowed tools: ${tools.join(", ")}.`)
91
+ );
92
+ }
93
+
94
+ /**
95
+ * Evaluate the policy that gates server-side use of a credential.
96
+ *
97
+ * Pure: it inspects only the metadata it is handed, performs no store reads,
98
+ * and has no side effects. Returns the denial reason, or `undefined` when the
99
+ * tool may read the credential server-side.
100
+ *
101
+ * Domain-restricted credentials are scoped to browser fills on those domains,
102
+ * so they are refused here even when the tool itself is allowed.
103
+ */
104
+ export function serverUseDenialReason(
105
+ metadata: CredentialMetadata | undefined,
106
+ toolName: string,
107
+ service: string,
108
+ field: string,
109
+ ): string | undefined {
110
+ if (!metadata) {
111
+ return `No credential found for ${service}/${field}`;
112
+ }
113
+
114
+ if (!isToolAllowed(toolName, metadata.allowedTools)) {
115
+ return toolNotAllowedReason(
116
+ toolName,
117
+ service,
118
+ field,
119
+ metadata.allowedTools,
120
+ );
121
+ }
122
+
123
+ const serverDomains = metadata.allowedDomains ?? [];
124
+ if (serverDomains.length > 0) {
125
+ return (
126
+ `Credential ${service}/${field} has domain restrictions ` +
127
+ `(${serverDomains.join(", ")}) and cannot be used server-side. ` +
128
+ "Remove domain restrictions or use a separate credential without domain policy."
129
+ );
130
+ }
131
+
132
+ return undefined;
133
+ }
@@ -1,9 +1,21 @@
1
1
  import { readFile } from "node:fs/promises";
2
2
 
3
+ import type {
4
+ RiskAllowlistOption,
5
+ RiskDirectoryScopeOption,
6
+ RiskPatternScopeOption,
7
+ } from "@vellumai/gateway-client";
8
+
3
9
  import { getConfig } from "../config/loader.js";
10
+ import {
11
+ classifyRisk,
12
+ type RiskClassificationWithMeta,
13
+ } from "../permissions/checker.js";
4
14
  import { PermissionPrompter } from "../permissions/prompter.js";
5
- import { RiskLevel } from "../permissions/types.js";
6
- import { runInPluginContext } from "../plugins/plugin-execution-context.js";
15
+ import {
16
+ runInPluginContext,
17
+ runOutsidePluginContext,
18
+ } from "../plugins/plugin-execution-context.js";
7
19
  import { TokenExpiredError } from "../security/token-manager.js";
8
20
  import {
9
21
  recordToolError,
@@ -30,6 +42,7 @@ import { MAX_FILE_SIZE_BYTES } from "./shared/filesystem/size-guard.js";
30
42
  import { ToolApprovalHandler } from "./tool-approval-handler.js";
31
43
  import { resolveToolInvocationAlias } from "./tool-name-aliases.js";
32
44
  import { recordToolCompletion } from "./tool-profiler.js";
45
+ import { RISK_LEVEL_UNCLASSIFIED } from "./tool-types.js";
33
46
  import { type ToolContext, type ToolExecutionResult } from "./types.js";
34
47
 
35
48
  export class ToolExecutor {
@@ -60,18 +73,34 @@ export class ToolExecutor {
60
73
  ): Promise<ToolExecutionResult> {
61
74
  const startTime = Date.now();
62
75
  let decision = "allow";
63
- let riskLevel: string = RiskLevel.Low;
76
+ // The invocation's one classification, taken before the gates so every
77
+ // audit row this call can produce (gate denial, gate error, grant-consumed
78
+ // execution, permission decision) records the risk of what the model asked
79
+ // for, then handed down to `checkPermission`. A classification that does
80
+ // not complete (aborted, gateway unreachable) is recorded as such rather
81
+ // than as a level; the permission check still requires one and fails
82
+ // closed on its own.
83
+ let classification: RiskClassificationWithMeta | undefined;
84
+ try {
85
+ classification = await classifyRisk(
86
+ name,
87
+ input,
88
+ context.workingDir,
89
+ undefined,
90
+ undefined,
91
+ context.signal,
92
+ );
93
+ } catch {
94
+ // Stays undefined; the audit row records RISK_LEVEL_UNCLASSIFIED.
95
+ }
96
+ let riskLevel: string = classification?.level ?? RISK_LEVEL_UNCLASSIFIED;
64
97
  let permRiskMeta:
65
98
  | {
66
99
  riskLevel: string;
67
100
  riskReason: string;
68
- riskScopeOptions: Array<{ pattern: string; label: string }>;
69
- riskAllowlistOptions?: Array<{
70
- label: string;
71
- description: string;
72
- pattern: string;
73
- }>;
74
- riskDirectoryScopeOptions?: Array<{ scope: string; label: string }>;
101
+ riskScopeOptions: RiskPatternScopeOption[];
102
+ riskAllowlistOptions?: RiskAllowlistOption[];
103
+ riskDirectoryScopeOptions?: RiskDirectoryScopeOption[];
75
104
  isContainerized?: boolean;
76
105
  }
77
106
  | undefined;
@@ -106,6 +135,11 @@ export class ToolExecutor {
106
135
  // consumed; substitute the parsed value (with `.catch()` recoveries
107
136
  // applied) so validation and execution see the same input.
108
137
  if (gateResult.parsedInput) {
138
+ // The permission decision is about the input that runs, so a parse that
139
+ // reshaped it (a `.catch()` recovery) gets its own classification.
140
+ if (!Bun.deepEquals(input, gateResult.parsedInput)) {
141
+ classification = undefined;
142
+ }
109
143
  input = gateResult.parsedInput;
110
144
  }
111
145
 
@@ -189,6 +223,7 @@ export class ToolExecutor {
189
223
  context,
190
224
  startTime,
191
225
  computePreviewDiff,
226
+ classification,
192
227
  );
193
228
 
194
229
  riskLevel = permResult.riskLevel;
@@ -235,15 +270,18 @@ export class ToolExecutor {
235
270
  const execContext = context;
236
271
 
237
272
  // Mark the owning plugin as in context (via AsyncLocalStorage) so host
238
- // APIs the tool reaches — e.g. resolveCredential — can scope to it. The
273
+ // APIs the tool reaches, e.g. resolveCredential, can scope to it. The
239
274
  // context must be established around the `execute()` call itself so the
240
- // returned promise carries the binding across its awaits. Non-plugin
241
- // tools (default/skill/mcp/workspace) establish no context.
275
+ // returned promise carries the binding across its awaits. A non-plugin
276
+ // tool (default/skill/mcp/workspace) runs with the context explicitly
277
+ // cleared rather than merely unset: the turn may have been started by a
278
+ // plugin (a route handler calling `runConversationTurn`), and this tool
279
+ // is host code that must not inherit that plugin's identity.
242
280
  const owner = getToolOwner(name);
243
281
  const execPromise =
244
282
  owner?.kind === "plugin"
245
283
  ? runInPluginContext(owner.id, () => tool.execute(input, execContext))
246
- : tool.execute(input, execContext);
284
+ : runOutsidePluginContext(() => tool.execute(input, execContext));
247
285
 
248
286
  let execResult: ToolExecutionResult = await executeWithTimeout(
249
287
  execPromise,
@@ -295,7 +333,7 @@ export class ToolExecutor {
295
333
  safeResult.isError,
296
334
  );
297
335
 
298
- // Merge risk metadata from the classifier assessment cache onto the
336
+ // Merge the classification's risk metadata onto the
299
337
  // tool result so downstream consumers (AgentEvent → handleToolResult →
300
338
  // ToolResult SSE message) can forward it to the client.
301
339
  if (permRiskMeta) {
@@ -0,0 +1,77 @@
1
+ import { describe, expect, test } from "bun:test";
2
+
3
+ import {
4
+ extractFirecrawlCompatSearchResults,
5
+ resolveProviderApiUrl,
6
+ searchResultSnippet,
7
+ } from "../firecrawl-compat.js";
8
+
9
+ describe("resolveProviderApiUrl", () => {
10
+ test("uses the default base when apiBase is empty", () => {
11
+ expect(
12
+ resolveProviderApiUrl("", "/v1/search", "https://api.fastcrw.com"),
13
+ ).toBe("https://api.fastcrw.com/v1/search");
14
+ expect(
15
+ resolveProviderApiUrl(undefined, "/v1/scrape", "https://api.fastcrw.com"),
16
+ ).toBe("https://api.fastcrw.com/v1/scrape");
17
+ });
18
+
19
+ test("strips trailing slashes from a custom base", () => {
20
+ expect(
21
+ resolveProviderApiUrl(
22
+ "http://localhost:3000///",
23
+ "/v1/search",
24
+ "https://api.fastcrw.com",
25
+ ),
26
+ ).toBe("http://localhost:3000/v1/search");
27
+ });
28
+ });
29
+
30
+ describe("extractFirecrawlCompatSearchResults", () => {
31
+ test("reads grouped data.web", () => {
32
+ expect(
33
+ extractFirecrawlCompatSearchResults({
34
+ data: { web: [{ title: "A", url: "https://a.test" }] },
35
+ }),
36
+ ).toEqual([{ title: "A", url: "https://a.test" }]);
37
+ });
38
+
39
+ test("reads data.results as a flat array", () => {
40
+ expect(
41
+ extractFirecrawlCompatSearchResults({
42
+ data: { results: [{ title: "B", url: "https://b.test" }] },
43
+ }),
44
+ ).toEqual([{ title: "B", url: "https://b.test" }]);
45
+ });
46
+
47
+ test("reads self-hosted data.results.web when sources group by type", () => {
48
+ expect(
49
+ extractFirecrawlCompatSearchResults({
50
+ data: {
51
+ results: {
52
+ web: [{ title: "Self-host", url: "https://local.test" }],
53
+ news: [{ title: "News", url: "https://news.test" }],
54
+ },
55
+ },
56
+ }),
57
+ ).toEqual([{ title: "Self-host", url: "https://local.test" }]);
58
+ });
59
+
60
+ test("reads a flat data array", () => {
61
+ expect(
62
+ extractFirecrawlCompatSearchResults({
63
+ data: [{ title: "C", url: "https://c.test" }],
64
+ }),
65
+ ).toEqual([{ title: "C", url: "https://c.test" }]);
66
+ });
67
+ });
68
+
69
+ describe("searchResultSnippet", () => {
70
+ test("prefers description then snippet", () => {
71
+ expect(
72
+ searchResultSnippet({ description: "desc", snippet: "snip" }),
73
+ ).toBe("desc");
74
+ expect(searchResultSnippet({ snippet: "snip" })).toBe("snip");
75
+ expect(searchResultSnippet({})).toBeUndefined();
76
+ });
77
+ });
@@ -0,0 +1,169 @@
1
+ import { afterEach, beforeEach, describe, expect, mock, test } from "bun:test";
2
+
3
+ import { setConfig } from "../../../__tests__/helpers/set-config.js";
4
+
5
+ let mockFastcrwSecureKey: string | undefined;
6
+
7
+ function seedWebFetch(provider: string, apiBase?: string): void {
8
+ const entry: Record<string, string> = { provider };
9
+ if (apiBase !== undefined) {
10
+ entry.apiBase = apiBase;
11
+ }
12
+ setConfig("services", { "web-fetch": entry });
13
+ }
14
+
15
+ mock.module("../../../security/secure-keys.js", () => ({
16
+ getProviderKeyAsync: async (provider: string) =>
17
+ provider === "fastcrw" ? mockFastcrwSecureKey : undefined,
18
+ }));
19
+
20
+ const realLogger = await import("../../../util/logger.js");
21
+ mock.module("../../../util/logger.js", () => ({
22
+ ...realLogger,
23
+ getLogger: () =>
24
+ new Proxy({} as Record<string, unknown>, { get: () => () => {} }),
25
+ }));
26
+
27
+ mock.module("../../../permissions/types.js", () => ({
28
+ RiskLevel: { Low: "low", Medium: "medium", High: "high" },
29
+ }));
30
+
31
+ let mockResolveAddresses: string[] = [];
32
+ const realUrlSafety = await import("../url-safety.js");
33
+ mock.module("../url-safety.js", () => ({
34
+ ...realUrlSafety,
35
+ resolveHostAddresses: async () => mockResolveAddresses,
36
+ }));
37
+
38
+ const { executeFastcrwScrape, webFetchTool } = await import("../web-fetch.js");
39
+
40
+ function scrapeResponse(body: unknown, status = 200): Response {
41
+ return new Response(JSON.stringify(body), {
42
+ status,
43
+ headers: { "content-type": "application/json" },
44
+ });
45
+ }
46
+
47
+ describe("executeFastcrwScrape", () => {
48
+ let originalFetch: typeof globalThis.fetch;
49
+
50
+ beforeEach(() => {
51
+ originalFetch = globalThis.fetch;
52
+ mockFastcrwSecureKey = undefined;
53
+ mockResolveAddresses = ["93.184.216.34"];
54
+ });
55
+ afterEach(() => {
56
+ globalThis.fetch = originalFetch;
57
+ });
58
+
59
+ test("hits the cloud default /v1/scrape endpoint", async () => {
60
+ let capturedUrl = "";
61
+ let capturedHeaders: any = null;
62
+ globalThis.fetch = (async (url: string, init?: RequestInit) => {
63
+ capturedUrl = url;
64
+ capturedHeaders = new Headers(init?.headers);
65
+ return scrapeResponse({
66
+ success: true,
67
+ data: {
68
+ markdown: "# Hello\n\nFrom fastCRW.",
69
+ metadata: {
70
+ title: "Example",
71
+ url: "https://example.com/",
72
+ statusCode: 200,
73
+ },
74
+ },
75
+ });
76
+ }) as typeof fetch;
77
+
78
+ const result = await executeFastcrwScrape(
79
+ { url: "https://example.com" },
80
+ { apiKey: "crw_live_test" },
81
+ );
82
+
83
+ expect(result.isError).toBe(false);
84
+ expect(capturedUrl).toBe("https://api.fastcrw.com/v1/scrape");
85
+ expect(capturedHeaders?.get("authorization")).toBe("Bearer crw_live_test");
86
+ expect(result.activityMetadata?.webFetch?.provider).toBe("fastcrw");
87
+ expect(result.content).toContain("From fastCRW.");
88
+ });
89
+
90
+ test("uses a custom API base from config", async () => {
91
+ seedWebFetch("fastcrw", "http://localhost:3000/");
92
+ let capturedUrl = "";
93
+ globalThis.fetch = (async (url: string) => {
94
+ capturedUrl = url;
95
+ return scrapeResponse({
96
+ success: true,
97
+ data: { markdown: "local", metadata: { statusCode: 200 } },
98
+ });
99
+ }) as typeof fetch;
100
+
101
+ const result = await executeFastcrwScrape(
102
+ { url: "https://example.com" },
103
+ { apiKey: "" },
104
+ );
105
+
106
+ expect(result.isError).toBe(false);
107
+ expect(capturedUrl).toBe("http://localhost:3000/v1/scrape");
108
+ });
109
+ });
110
+
111
+ describe("webFetchTool fastCRW dispatch", () => {
112
+ let originalFetch: typeof globalThis.fetch;
113
+
114
+ const execute = (input: Record<string, unknown>, ctx: any = {}) =>
115
+ webFetchTool.execute(input, ctx);
116
+
117
+ beforeEach(() => {
118
+ originalFetch = globalThis.fetch;
119
+ mockFastcrwSecureKey = "crw_live_test";
120
+ mockResolveAddresses = ["93.184.216.34"];
121
+ });
122
+ afterEach(() => {
123
+ globalThis.fetch = originalFetch;
124
+ });
125
+
126
+ test("routes to fastCRW when provider=fastcrw and a key is set", async () => {
127
+ seedWebFetch("fastcrw");
128
+ let fastcrwHit = false;
129
+ globalThis.fetch = (async (url: string) => {
130
+ if (String(url).includes("api.fastcrw.com")) {
131
+ fastcrwHit = true;
132
+ }
133
+ return scrapeResponse({
134
+ success: true,
135
+ data: {
136
+ markdown: "ok",
137
+ metadata: { statusCode: 200, url: "https://example.com/" },
138
+ },
139
+ });
140
+ }) as typeof fetch;
141
+
142
+ const result = await execute({ url: "https://example.com" });
143
+ expect(fastcrwHit).toBe(true);
144
+ expect(result.activityMetadata?.webFetch?.provider).toBe("fastcrw");
145
+ });
146
+
147
+ test("routes to fastCRW without a key when a custom API base is set", async () => {
148
+ seedWebFetch("fastcrw", "http://127.0.0.1:3000");
149
+ mockFastcrwSecureKey = undefined;
150
+ let capturedUrl = "";
151
+ let capturedHeaders: any = null;
152
+ globalThis.fetch = (async (url: string, init?: RequestInit) => {
153
+ capturedUrl = String(url);
154
+ capturedHeaders = new Headers(init?.headers);
155
+ return scrapeResponse({
156
+ success: true,
157
+ data: {
158
+ markdown: "self-host",
159
+ metadata: { statusCode: 200, url: "https://example.com/" },
160
+ },
161
+ });
162
+ }) as typeof fetch;
163
+
164
+ const result = await execute({ url: "https://example.com" });
165
+ expect(capturedUrl).toBe("http://127.0.0.1:3000/v1/scrape");
166
+ expect(capturedHeaders?.get("authorization")).toBeNull();
167
+ expect(result.activityMetadata?.webFetch?.provider).toBe("fastcrw");
168
+ });
169
+ });