@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
@@ -22,6 +22,7 @@ import {
22
22
  readdirSync,
23
23
  readFileSync,
24
24
  readSync,
25
+ renameSync,
25
26
  statSync,
26
27
  unlinkSync,
27
28
  writeFileSync,
@@ -42,26 +43,151 @@ function getCacheDir(): string {
42
43
  return join(tmpdir(), "vellum-optimized-images");
43
44
  }
44
45
 
46
+ /**
47
+ * Structural completeness check for a JPEG payload: SOI marker (FF D8) at the
48
+ * head and EOI marker (FF D9) at the tail. Every cache entry and every sips
49
+ * output is a JPEG, so a payload failing this is truncated or empty (the
50
+ * signature of a torn cache write) and must never reach a provider, which
51
+ * rejects it with a 400 that wedges the conversation (the corrupt block is
52
+ * resent on every subsequent turn).
53
+ */
54
+ export function isCompleteJpeg(bytes: Uint8Array): boolean {
55
+ return (
56
+ bytes.length >= 4 &&
57
+ bytes[0] === 0xff &&
58
+ bytes[1] === 0xd8 &&
59
+ bytes[bytes.length - 2] === 0xff &&
60
+ bytes[bytes.length - 1] === 0xd9
61
+ );
62
+ }
63
+
64
+ /**
65
+ * Structural JPEG truncation check for payloads of arbitrary origin: walk the
66
+ * marker segments from SOI and report whether a terminal EOI is reached.
67
+ * Unlike {@link isCompleteJpeg} (exact tail framing, for sips output and
68
+ * cache entries, which always end on EOI), this tolerates encoders that
69
+ * append padding or metadata after the EOI.
70
+ *
71
+ * A raw byte search for FF D9 is not enough: length-delimited APP/COM
72
+ * segments (an EXIF thumbnail is itself a complete embedded JPEG) may contain
73
+ * FF D9, so a truncated file with an intact metadata prefix would pass.
74
+ * Walking segment boundaries skips those payloads entirely; only an EOI at
75
+ * the top level of the marker stream counts. Entropy-coded scan data is
76
+ * traversed byte-wise, where FF is stuffed as FF 00 and restart markers
77
+ * (D0-D7) continue the scan, so a marker byte there is unambiguous.
78
+ *
79
+ * The EOI only counts after at least one frame header (SOF) and one scan
80
+ * (SOS) have been seen: a degenerate payload such as bare SOI+EOI carries no
81
+ * image data and providers reject it.
82
+ */
83
+ export function hasValidJpegStructure(bytes: Uint8Array): boolean {
84
+ if (bytes.length < 4 || bytes[0] !== 0xff || bytes[1] !== 0xd8) {
85
+ return false;
86
+ }
87
+ let sawFrame = false;
88
+ let sawScan = false;
89
+ let i = 2;
90
+ while (i + 1 < bytes.length) {
91
+ if (bytes[i] !== 0xff) {
92
+ return false;
93
+ }
94
+ // FF fill bytes before a marker are legal padding.
95
+ let j = i + 1;
96
+ while (j < bytes.length && bytes[j] === 0xff) {
97
+ j++;
98
+ }
99
+ if (j >= bytes.length) {
100
+ return false;
101
+ }
102
+ const marker = bytes[j];
103
+ i = j + 1;
104
+ if (marker === 0xd9) {
105
+ return sawFrame && sawScan;
106
+ }
107
+ // SOF0-SOF15 occupy C0-CF, excluding DHT (C4), JPG (C8), and DAC (CC).
108
+ if (
109
+ marker >= 0xc0 &&
110
+ marker <= 0xcf &&
111
+ marker !== 0xc4 &&
112
+ marker !== 0xc8 &&
113
+ marker !== 0xcc
114
+ ) {
115
+ sawFrame = true;
116
+ }
117
+ // Standalone markers carry no length field: repeated SOI, TEM, RST0-7.
118
+ if (
119
+ marker === 0xd8 ||
120
+ marker === 0x01 ||
121
+ (marker >= 0xd0 && marker <= 0xd7)
122
+ ) {
123
+ continue;
124
+ }
125
+ if (i + 1 >= bytes.length) {
126
+ return false;
127
+ }
128
+ const segmentLength = (bytes[i] << 8) | bytes[i + 1];
129
+ if (segmentLength < 2) {
130
+ return false;
131
+ }
132
+ i += segmentLength;
133
+ if (marker === 0xda) {
134
+ sawScan = true;
135
+ // SOS: entropy-coded data follows the header. Scan to the next real
136
+ // marker; FF 00 (stuffed data byte) and FF D0-D7 (restart) stay inside
137
+ // the scan.
138
+ while (i + 1 < bytes.length) {
139
+ if (
140
+ bytes[i] === 0xff &&
141
+ bytes[i + 1] !== 0x00 &&
142
+ !(bytes[i + 1] >= 0xd0 && bytes[i + 1] <= 0xd7)
143
+ ) {
144
+ break;
145
+ }
146
+ i++;
147
+ }
148
+ }
149
+ }
150
+ return false;
151
+ }
152
+
45
153
  function readFromCache(key: string): Buffer | null {
154
+ const cachePath = join(getCacheDir(), `${key}.jpg`);
46
155
  try {
47
- const cachePath = join(getCacheDir(), `${key}.jpg`);
48
156
  if (!existsSync(cachePath)) {
49
157
  return null;
50
158
  }
51
- return readFileSync(cachePath) as Buffer;
159
+ const bytes = readFileSync(cachePath) as Buffer;
160
+ if (!isCompleteJpeg(bytes)) {
161
+ // Poisoned entry (torn write, disk full, etc.): drop it so the caller
162
+ // re-converts and re-caches.
163
+ unlinkSync(cachePath);
164
+ return null;
165
+ }
166
+ return bytes;
52
167
  } catch {
53
168
  return null;
54
169
  }
55
170
  }
56
171
 
57
172
  function writeToCache(key: string, convertedBytes: Buffer): void {
173
+ const dir = getCacheDir();
174
+ // Write-then-rename so concurrent readers (the cache dir is shared across
175
+ // daemon processes) never observe a partially written entry; rename within
176
+ // the same directory is atomic. The pid+uuid suffix keeps concurrent
177
+ // writers of the same key off each other's temp file.
178
+ const tmpPath = join(dir, `${key}.${process.pid}-${uuid().slice(0, 8)}.tmp`);
58
179
  try {
59
- const dir = getCacheDir();
60
180
  mkdirSync(dir, { recursive: true });
61
- writeFileSync(join(dir, `${key}.jpg`), convertedBytes);
181
+ writeFileSync(tmpPath, convertedBytes);
182
+ renameSync(tmpPath, join(dir, `${key}.jpg`));
62
183
  evictIfNeeded(dir);
63
184
  } catch {
64
185
  // Cache write failure is non-fatal.
186
+ try {
187
+ unlinkSync(tmpPath);
188
+ } catch {
189
+ /* ignore */
190
+ }
65
191
  }
66
192
  }
67
193
 
@@ -141,7 +267,14 @@ async function runSips(
141
267
  if (proc.exitCode !== 0) {
142
268
  return null;
143
269
  }
144
- return readFileSync(outPath) as Buffer;
270
+ const out = readFileSync(outPath) as Buffer;
271
+ // A zero-exit sips can still leave a truncated file (disk full, timeout
272
+ // kill racing the write). Returning it would poison the cache and every
273
+ // downstream provider call. Treat it as a failed conversion instead.
274
+ if (!isCompleteJpeg(out)) {
275
+ return null;
276
+ }
277
+ return out;
145
278
  } catch {
146
279
  return null;
147
280
  } finally {
@@ -206,14 +339,22 @@ const HEIF_FTYP_BRANDS = new Set([
206
339
  "msf1",
207
340
  ]);
208
341
 
209
- /**
210
- * Content-based HEIF/HEIC detection. MIME metadata is unreliable here:
211
- * Chromium reports an empty `file.type` for `.heic`, which clients coerce to
212
- * `application/octet-stream`.
213
- */
214
- export function isHeifImage(bytes: Uint8Array): boolean {
342
+ // Brands whose canonical MIME is `image/heic`; the remaining HEIF brands
343
+ // (`heif`, `mif1`, `msf1`) are `image/heif`.
344
+ const HEIC_FTYP_BRANDS = new Set([
345
+ "heic",
346
+ "heix",
347
+ "hevc",
348
+ "hevx",
349
+ "heim",
350
+ "heis",
351
+ "hevm",
352
+ "hevs",
353
+ ]);
354
+
355
+ function heifFtypBrand(bytes: Uint8Array): string | null {
215
356
  if (bytes.length < 12) {
216
- return false;
357
+ return null;
217
358
  }
218
359
  // ISO BMFF layout: bytes 4-8 are "ftyp", bytes 8-12 the major brand.
219
360
  if (
@@ -222,7 +363,7 @@ export function isHeifImage(bytes: Uint8Array): boolean {
222
363
  bytes[6] !== 0x79 || // y
223
364
  bytes[7] !== 0x70 // p
224
365
  ) {
225
- return false;
366
+ return null;
226
367
  }
227
368
  const brand = String.fromCharCode(
228
369
  bytes[8]!,
@@ -230,7 +371,30 @@ export function isHeifImage(bytes: Uint8Array): boolean {
230
371
  bytes[10]!,
231
372
  bytes[11]!,
232
373
  );
233
- return HEIF_FTYP_BRANDS.has(brand);
374
+ return HEIF_FTYP_BRANDS.has(brand) ? brand : null;
375
+ }
376
+
377
+ /**
378
+ * Content-based HEIF/HEIC detection. MIME metadata is unreliable here:
379
+ * Chromium reports an empty `file.type` for `.heic`, which clients coerce to
380
+ * `application/octet-stream`.
381
+ */
382
+ export function isHeifImage(bytes: Uint8Array): boolean {
383
+ return heifFtypBrand(bytes) !== null;
384
+ }
385
+
386
+ /**
387
+ * Canonical HEIF MIME type for bytes whose container brand names one, and null
388
+ * for everything else. For providers that read HEIF directly and key on the
389
+ * declared media type (Gemini accepts `image/heic` and `image/heif`:
390
+ * https://ai.google.dev/gemini-api/docs/image-understanding).
391
+ */
392
+ export function heifImageMimeType(bytes: Uint8Array): string | null {
393
+ const brand = heifFtypBrand(bytes);
394
+ if (!brand) {
395
+ return null;
396
+ }
397
+ return HEIC_FTYP_BRANDS.has(brand) ? "image/heic" : "image/heif";
234
398
  }
235
399
 
236
400
  /**
@@ -1,6 +1,6 @@
1
- import { chmodSync, existsSync, mkdirSync } from "node:fs";
2
- import { homedir } from "node:os";
3
- import { dirname, join } from "node:path";
1
+ import { chmodSync, existsSync, mkdirSync, realpathSync } from "node:fs";
2
+ import { homedir, tmpdir } from "node:os";
3
+ import { basename, dirname, join, sep } from "node:path";
4
4
 
5
5
  import { SEEDS } from "@vellumai/environments";
6
6
 
@@ -24,13 +24,17 @@ const VELLUM_ROOT = join(homedir(), ".vellum");
24
24
  */
25
25
  export function vellumRoot(): string {
26
26
  const override = getWorkspaceDirOverride();
27
+ let root = VELLUM_ROOT;
27
28
  if (override) {
28
29
  const parent = dirname(override);
29
30
  if (parent !== "/") {
30
- return parent;
31
+ root = parent;
31
32
  }
32
33
  }
33
- return VELLUM_ROOT;
34
+ // Same containment rule as getWorkspaceDir(): root-derived paths (protected
35
+ // dir, .env) must stay ephemeral in test processes too.
36
+ assertTestPathIsEphemeral(root);
37
+ return root;
34
38
  }
35
39
 
36
40
  export function isMacOS(): boolean {
@@ -334,19 +338,98 @@ export function getProcPidPath(name: string): string {
334
338
  return join(getProcDir(name), `${name}.pid`);
335
339
  }
336
340
 
341
+ // --- Live-workspace guard for test processes --------------------------------
342
+ //
343
+ // A test process must never resolve the workspace (or the vellum root) to a
344
+ // real, non-temp directory: production code exercised by a test would then
345
+ // read and destructively write live state. The tmpdir redirection normally
346
+ // comes from the bunfig.toml test preload, but bun only loads bunfig from the
347
+ // cwd, so `bun test` run from any other directory (for example a source
348
+ // checkout inside a deployed container's workspace) skips the preload and
349
+ // inherits the ambient VELLUM_WORKSPACE_DIR. The containment assertion
350
+ // therefore lives here, in production code, where it fires no matter how the
351
+ // test process was launched.
352
+ //
353
+ // Containment logic mirrors src/__tests__/assert-not-live-db.ts, which cannot
354
+ // be imported here (production code must not depend on test machinery).
355
+
356
+ /** Lazily computed: is this process a `bun test` run? */
357
+ let isTestProcess: boolean | undefined;
358
+
359
+ /**
360
+ * Resolve symlinks in the deepest existing ancestor of `p`, then re-append
361
+ * the not-yet-created tail. This keeps the containment check honest both for
362
+ * paths under a symlinked temp root (macOS /var/folders) and for symlinks
363
+ * that point outside it, whether or not the leaf exists yet.
364
+ */
365
+ function canonicalizeForWorkspaceGuard(p: string): string {
366
+ let cur = p;
367
+ const tail: string[] = [];
368
+ for (;;) {
369
+ try {
370
+ return join(realpathSync(cur), ...tail);
371
+ } catch {
372
+ const parent = dirname(cur);
373
+ if (parent === cur) {
374
+ return p;
375
+ }
376
+ tail.unshift(basename(cur));
377
+ cur = parent;
378
+ }
379
+ }
380
+ }
381
+
382
+ function assertTestPathIsEphemeral(dir: string): void {
383
+ isTestProcess ??=
384
+ process.env.NODE_ENV === "test" ||
385
+ process.env.BUN_TEST === "1" ||
386
+ // `bun test` sets NODE_ENV=test only when unset; Bun.main being the test
387
+ // file itself is the backstop signal that survives a preset NODE_ENV.
388
+ (typeof Bun !== "undefined" &&
389
+ /\.(test|spec)\.[cm]?[jt]sx?$/.test(Bun.main));
390
+ if (!isTestProcess) {
391
+ return;
392
+ }
393
+ // Escape hatch for the rare intentional run against a real workspace,
394
+ // shared with assertTestDbIsIsolated() in persistence/db-connection.ts.
395
+ // Deliberately NOT added to tools/terminal/safe-env.ts: a daemon-level
396
+ // opt-out must not propagate into agent-spawned shells and disarm the
397
+ // guard for tests run from there.
398
+ if (process.env.VELLUM_ALLOW_REAL_WORKSPACE_IN_TESTS === "1") {
399
+ return;
400
+ }
401
+ const tmpRoot = canonicalizeForWorkspaceGuard(tmpdir());
402
+ const resolved = canonicalizeForWorkspaceGuard(dir);
403
+ if (resolved !== tmpRoot && !resolved.startsWith(tmpRoot + sep)) {
404
+ throw new Error(
405
+ [
406
+ `Refusing to use ${dir} (resolves to ${resolved}) in a test process: it is not under the temp directory (${tmpRoot}).`,
407
+ "",
408
+ "Tests must only touch an ephemeral workspace; a real one would expose",
409
+ "live assistant state to destructive test fixtures. This usually means",
410
+ "`bun test` ran from a cwd without the repo bunfig.toml, so the test",
411
+ "preload that redirects VELLUM_WORKSPACE_DIR to a tmpdir never loaded.",
412
+ "Run tests from the assistant package root, or set",
413
+ "VELLUM_ALLOW_REAL_WORKSPACE_IN_TESTS=1 to bypass deliberately.",
414
+ ].join("\n"),
415
+ );
416
+ }
417
+ }
418
+
337
419
  /**
338
420
  * Returns the workspace root for user-facing state.
339
421
  *
340
422
  * When the VELLUM_WORKSPACE_DIR env var is set, returns that value (used in
341
423
  * containerized deployments where the workspace is a separate volume).
342
424
  * Otherwise falls back to ~/.vellum/workspace.
425
+ *
426
+ * In test processes the resolved directory must live under `os.tmpdir()`
427
+ * (see the live-workspace guard above); anything else throws.
343
428
  */
344
429
  export function getWorkspaceDir(): string {
345
- const override = getWorkspaceDirOverride();
346
- if (override) {
347
- return override;
348
- }
349
- return join(VELLUM_ROOT, "workspace");
430
+ const dir = getWorkspaceDirOverride() ?? join(VELLUM_ROOT, "workspace");
431
+ assertTestPathIsEphemeral(dir);
432
+ return dir;
350
433
  }
351
434
 
352
435
  /**
@@ -253,6 +253,7 @@ export async function spawnWorkerProcess(args: {
253
253
  env: workerMemoryEnv(),
254
254
  stdio: ["ignore", "ignore", stderrFd],
255
255
  detached,
256
+ windowsHide: true,
256
257
  });
257
258
 
258
259
  // Close our copy of the log fd — the child has its own.