@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
@@ -31,6 +31,14 @@ mock.module("../../daemon/conversation-store.js", () => ({
31
31
  getOrCreateConversation: async () => fakeConversation,
32
32
  }));
33
33
 
34
+ // Vision capability of the image pin's target profile. Install-dependent in
35
+ // production (a BYO provider resolves the profile key through its own column
36
+ // of the intent matrix), so it is scripted rather than read from a catalog.
37
+ let pinProfileSupportsVision = true;
38
+ mock.module("../../plugin-api/vision-support.js", () => ({
39
+ doesSupportVision: () => pinProfileSupportsVision,
40
+ }));
41
+
34
42
  // Conversation-CRUD doubles for the teardown transcript-hygiene pass. The
35
43
  // real module is spread so every other export keeps its production behavior;
36
44
  // only the functions the hygiene pass (and discard) touch are recorded.
@@ -133,6 +141,7 @@ interface FakeConversation {
133
141
  opts?: { decisionContext?: string },
134
142
  ) => void;
135
143
  runAgentLoop: (...args: unknown[]) => Promise<void>;
144
+ getMessages: () => Array<{ role: string; content: unknown[] }>;
136
145
  abort: (reason?: unknown) => void;
137
146
  loadFromDb: () => Promise<void>;
138
147
  toolsDisabledDepth: number;
@@ -149,6 +158,8 @@ function makeFakeConversation(opts: {
149
158
  onPersist?: (attempt: number) => void;
150
159
  /** Workspace root; pass empty to model a missing boundary. */
151
160
  workingDir?: string;
161
+ /** In-memory history the profile pin reads; undefined models a text-only call. */
162
+ messages?: Array<{ role: string; content: unknown[] }>;
152
163
  }) {
153
164
  const waitForIdleCalls: WaitForIdleCall[] = [];
154
165
  const confirmationDecisions: Array<{ requestId: string; decision: string }> =
@@ -206,6 +217,7 @@ function makeFakeConversation(opts: {
206
217
  confirmationDecisions.push({ requestId, decision });
207
218
  },
208
219
  runAgentLoop: () => (opts.runAgentLoop ?? (async () => {}))(),
220
+ getMessages: () => opts.messages ?? [],
209
221
  abort: () => {},
210
222
  loadFromDb: async () => {
211
223
  opts.events?.push("loadFromDb");
@@ -2165,3 +2177,105 @@ describe("transcript hygiene (teardown pass)", () => {
2165
2177
  expect(crudLog.deletes).toContain("assistant-row-1");
2166
2178
  });
2167
2179
  });
2180
+
2181
+ describe("startVoiceTurn image-bearing profile pin", () => {
2182
+ /** A persisted user message carrying a photo taken mid-call. */
2183
+ const PHOTO_HISTORY = [
2184
+ { role: "user", content: [{ type: "text", text: "here's a photo:" }] },
2185
+ {
2186
+ role: "user",
2187
+ content: [
2188
+ { type: "text", text: "here's a photo:" },
2189
+ { type: "image", source: { type: "base64", data: "abc" } },
2190
+ ],
2191
+ },
2192
+ ];
2193
+
2194
+ beforeEach(() => {
2195
+ pinProfileSupportsVision = true;
2196
+ });
2197
+
2198
+ async function runOptionsFor(opts: {
2199
+ messages?: Array<{ role: string; content: unknown[] }>;
2200
+ turn?: Record<string, unknown>;
2201
+ }): Promise<Record<string, unknown>> {
2202
+ const fake = makeFakeConversation({
2203
+ processing: false,
2204
+ ...(opts.messages ? { messages: opts.messages } : {}),
2205
+ });
2206
+ fakeConversation = fake.conversation;
2207
+ let runOptions: Record<string, unknown> = {};
2208
+ fake.conversation.runAgentLoop = async (...args: unknown[]) => {
2209
+ runOptions = args[2] as Record<string, unknown>;
2210
+ };
2211
+ await startVoiceTurn({ ...makeTurnOptions(), ...(opts.turn ?? {}) });
2212
+ return runOptions;
2213
+ }
2214
+
2215
+ test("a text-only call keeps the call-site profile", async () => {
2216
+ const runOptions = await runOptionsFor({});
2217
+
2218
+ expect(runOptions.overrideProfile).toBeUndefined();
2219
+ expect(runOptions.forceOverrideProfile).toBeUndefined();
2220
+ });
2221
+
2222
+ test("an image in history pins the image-capable profile", async () => {
2223
+ // `callAgent`'s balanced profile carries no guarantee that its model takes
2224
+ // an image, and a model that rejects one fails the whole leg.
2225
+ const runOptions = await runOptionsFor({ messages: PHOTO_HISTORY });
2226
+
2227
+ expect(runOptions.overrideProfile).toBe("latency-optimized");
2228
+ // callAgent is not `mainAgent`, so an unforced override would sit below
2229
+ // the call-site profile and never apply.
2230
+ expect(runOptions.forceOverrideProfile).toBe(true);
2231
+ });
2232
+
2233
+ test("an image nested in a tool result counts too", async () => {
2234
+ const runOptions = await runOptionsFor({
2235
+ messages: [
2236
+ {
2237
+ role: "user",
2238
+ content: [
2239
+ {
2240
+ type: "tool_result",
2241
+ contentBlocks: [{ type: "image", source: { data: "abc" } }],
2242
+ },
2243
+ ],
2244
+ },
2245
+ ],
2246
+ });
2247
+
2248
+ expect(runOptions.overrideProfile).toBe("latency-optimized");
2249
+ });
2250
+
2251
+ test("a front-door leg is left alone — its own call site pins it", async () => {
2252
+ const runOptions = await runOptionsFor({
2253
+ messages: PHOTO_HISTORY,
2254
+ turn: { routingLeg: "front-door" },
2255
+ });
2256
+
2257
+ expect(runOptions.overrideProfile).toBeUndefined();
2258
+ expect(runOptions.callSite).toBe("voiceFrontDoor");
2259
+ });
2260
+
2261
+ test("no pin when the pin target can't take an image either", async () => {
2262
+ // Fireworks: `latency-optimized` resolves to a text-only model while
2263
+ // `balanced` is vision-capable, so pinning would break the very turn the
2264
+ // pin exists to save.
2265
+ pinProfileSupportsVision = false;
2266
+
2267
+ const runOptions = await runOptionsFor({ messages: PHOTO_HISTORY });
2268
+
2269
+ expect(runOptions.overrideProfile).toBeUndefined();
2270
+ expect(runOptions.forceOverrideProfile).toBeUndefined();
2271
+ });
2272
+
2273
+ test("an explicit routing pin wins over the image pin", async () => {
2274
+ const runOptions = await runOptionsFor({
2275
+ messages: PHOTO_HISTORY,
2276
+ turn: { overrideProfile: "quality-optimized" },
2277
+ });
2278
+
2279
+ expect(runOptions.overrideProfile).toBe("quality-optimized");
2280
+ });
2281
+ });
@@ -35,8 +35,9 @@ import {
35
35
  updateMessageContent,
36
36
  } from "../persistence/conversation-crud.js";
37
37
  import { VOICE_ESCALATION_CONTINUATION_MESSAGE_KIND } from "../plugin-api/constants.js";
38
+ import { doesSupportVision } from "../plugin-api/vision-support.js";
38
39
  import { pinnedListeningLanguage } from "../providers/speech-to-text/provider-catalog.js";
39
- import type { ContentBlock } from "../providers/types.js";
40
+ import type { ContentBlock, Message } from "../providers/types.js";
40
41
  import { broadcastMessage } from "../runtime/assistant-event-hub.js";
41
42
  import { DAEMON_INTERNAL_ASSISTANT_ID } from "../runtime/assistant-scope.js";
42
43
  import { getCurrentSeq } from "../runtime/assistant-stream-state.js";
@@ -67,6 +68,40 @@ import {
67
68
 
68
69
  const log = getLogger("voice-session-bridge");
69
70
 
71
+ /**
72
+ * Profile an image-bearing voice leg is pinned to.
73
+ *
74
+ * The latency-class profile is the one voice already leans on (it fronts every
75
+ * turn through `voiceFrontDoor`); `callAgent`'s `balanced` profile carries no
76
+ * guarantee that its model takes images, and a model that rejects an image
77
+ * fails the whole leg rather than degrading it.
78
+ *
79
+ * Whether THIS profile takes images is an install-level question, not a
80
+ * constant: a BYO provider resolves the key through its own column of the
81
+ * intent matrix, and on Fireworks that lands on a text-only model while its
82
+ * `balanced` column is vision-capable. Pinning there would break the exact
83
+ * turns this pin exists to save, hence the capability check at the call site.
84
+ */
85
+ const VOICE_IMAGE_PROFILE = "latency-optimized";
86
+
87
+ /**
88
+ * Does this conversation's history carry an image?
89
+ *
90
+ * Images persist inline and are re-sent on every later turn, so one photo
91
+ * taken mid-call makes every remaining turn of that call an image turn -- the
92
+ * check is over the whole history, not just this turn's own content.
93
+ */
94
+ function conversationCarriesImage(messages: readonly Message[]): boolean {
95
+ return messages.some((message) =>
96
+ message.content.some(
97
+ (block) =>
98
+ block.type === "image" ||
99
+ (block.type === "tool_result" &&
100
+ block.contentBlocks?.some((nested) => nested.type === "image")),
101
+ ),
102
+ );
103
+ }
104
+
70
105
  /**
71
106
  * Front-door decision rule with the registry-derived capability digest. The
72
107
  * front-door leg runs toolless (see the `toolsDisabledDepth` bracket in
@@ -1657,6 +1692,23 @@ export async function startVoiceTurn(
1657
1692
  conversation.toolsDisabledDepth++;
1658
1693
  frontDoorToolsSuppressed = true;
1659
1694
  }
1695
+ // Resolved once here rather than inside the options literal below, so
1696
+ // the history scan happens once per leg. A front-door leg is skipped:
1697
+ // its own call site already resolves to the same profile. The
1698
+ // capability check comes before the scan because it is the cheaper of
1699
+ // the two and it decides whether the pin is worth anything at all.
1700
+ const carriesImage =
1701
+ opts.routingLeg !== "front-door" &&
1702
+ doesSupportVision(VOICE_IMAGE_PROFILE) &&
1703
+ conversationCarriesImage(conversation.getMessages());
1704
+ if (carriesImage) {
1705
+ log.info(
1706
+ { turnId, routingLeg: opts.routingLeg ?? null },
1707
+ "Voice leg carries an image; pinning the image-capable profile",
1708
+ );
1709
+ }
1710
+ const profilePin =
1711
+ opts.overrideProfile ?? (carriesImage ? VOICE_IMAGE_PROFILE : null);
1660
1712
  await conversation.runAgentLoop(persistedContent, messageId, {
1661
1713
  onEvent: (msg: AssistantEvent) => {
1662
1714
  if (msg.type === "assistant_turn_start") {
@@ -1737,11 +1789,13 @@ export async function startVoiceTurn(
1737
1789
  // strong escalation profile. `forceOverrideProfile` floats it above the
1738
1790
  // callAgent call-site layers (callAgent is not `mainAgent`, so the
1739
1791
  // override would otherwise sit below the call-site profile).
1740
- ...(opts.overrideProfile != null
1741
- ? {
1742
- overrideProfile: opts.overrideProfile,
1743
- forceOverrideProfile: true,
1744
- }
1792
+ //
1793
+ // An explicit routing pin wins; failing that, a leg whose history
1794
+ // carries an image is pinned to a profile whose model takes one. A
1795
+ // front-door leg needs neither: its own call site already resolves
1796
+ // there.
1797
+ ...(profilePin != null
1798
+ ? { overrideProfile: profilePin, forceOverrideProfile: true }
1745
1799
  : {}),
1746
1800
  });
1747
1801
  if (lastError) {
@@ -0,0 +1,49 @@
1
+ import { describe, expect, test } from "bun:test";
2
+
3
+ import { audienceForReader } from "../message-audience.js";
4
+
5
+ describe("audienceForReader", () => {
6
+ test("restricts a reply in a Slack channel to the named reader", () => {
7
+ expect(audienceForReader("slack", "C0ROOM", "U0READER")).toEqual({
8
+ kind: "oneReader",
9
+ userId: "U0READER",
10
+ });
11
+ });
12
+
13
+ test("leaves a Slack DM unrestricted", () => {
14
+ // Nobody else can read a DM, so restricting buys no privacy and costs
15
+ // durability: an ephemeral message does not survive a reload.
16
+ expect(audienceForReader("slack", "D0DIRECT", "U0READER")).toBeUndefined();
17
+ });
18
+
19
+ test("restricts a private group, which several readers share", () => {
20
+ // A `G` id is a shared room like a `C` one. Testing for a DM rather than
21
+ // for a channel id is what keeps this from leaking into the group.
22
+ expect(audienceForReader("slack", "G0PRIVATE", "U0READER")).toEqual({
23
+ kind: "oneReader",
24
+ userId: "U0READER",
25
+ });
26
+ });
27
+
28
+ test("leaves every other channel unrestricted", () => {
29
+ for (const channel of ["telegram", "discord", "whatsapp", "email"]) {
30
+ expect(
31
+ audienceForReader(channel, "C0ROOM", "U0READER"),
32
+ `${channel} has no way to show one reader a message in a shared room`,
33
+ ).toBeUndefined();
34
+ }
35
+ });
36
+
37
+ test("stays unrestricted when there is no reader to name", () => {
38
+ expect(audienceForReader("slack", "C0ROOM", undefined)).toBeUndefined();
39
+ expect(audienceForReader("slack", "C0ROOM", null)).toBeUndefined();
40
+ });
41
+
42
+ test("tolerates an absent channel or room rather than throwing", () => {
43
+ // Several callers hold values that were never narrowed, so the answer for
44
+ // an unknown channel has to be the safe one rather than an exception.
45
+ expect(audienceForReader(undefined, "C0ROOM", "U0READER")).toBeUndefined();
46
+ expect(audienceForReader(null, "C0ROOM", "U0READER")).toBeUndefined();
47
+ expect(audienceForReader("slack", null, "U0READER")).toBeUndefined();
48
+ });
49
+ });
@@ -17,9 +17,10 @@ describe("INTERFACE_IDS", () => {
17
17
  ).toBe(true);
18
18
  });
19
19
 
20
- test("still includes macos and other existing interfaces", () => {
20
+ test("includes desktop and existing interfaces", () => {
21
21
  for (const id of [
22
22
  "macos",
23
+ "windows",
23
24
  "ios",
24
25
  "cli",
25
26
  "telegram",
@@ -41,8 +42,9 @@ describe("INTERACTIVE_INTERFACES", () => {
41
42
  expect(INTERACTIVE_INTERFACES.has("chrome-extension" as never)).toBe(false);
42
43
  });
43
44
 
44
- test("still includes macos", () => {
45
+ test("includes desktop clients", () => {
45
46
  expect(INTERACTIVE_INTERFACES.has("macos")).toBe(true);
47
+ expect(INTERACTIVE_INTERFACES.has("windows")).toBe(true);
46
48
  });
47
49
  });
48
50
 
@@ -51,8 +53,9 @@ describe("isInterfaceId", () => {
51
53
  expect(isInterfaceId("chrome-extension")).toBe(true);
52
54
  });
53
55
 
54
- test("returns true for macos", () => {
56
+ test("returns true for desktop interfaces", () => {
55
57
  expect(isInterfaceId("macos")).toBe(true);
58
+ expect(isInterfaceId("windows")).toBe(true);
56
59
  });
57
60
 
58
61
  test("returns false for unknown interface", () => {
@@ -68,6 +71,7 @@ describe("parseInterfaceId", () => {
68
71
  test("returns canonical ID for valid interface", () => {
69
72
  expect(parseInterfaceId("web")).toBe("web");
70
73
  expect(parseInterfaceId("macos")).toBe("macos");
74
+ expect(parseInterfaceId("windows")).toBe("windows");
71
75
  });
72
76
 
73
77
  test("normalizes legacy 'vellum' alias to 'web'", () => {
@@ -103,6 +107,16 @@ describe("supportsHostProxy", () => {
103
107
  expect(supportsHostProxy("macos", "host_browser")).toBe(true);
104
108
  });
105
109
 
110
+ test("windows exposes its implemented host capabilities", () => {
111
+ expect(supportsHostProxy("windows")).toBe(true);
112
+ expect(supportsHostProxy("windows", "host_bash")).toBe(true);
113
+ expect(supportsHostProxy("windows", "host_file")).toBe(true);
114
+ expect(supportsHostProxy("windows", "host_cu")).toBe(true);
115
+ expect(supportsHostProxy("windows", "host_browser")).toBe(true);
116
+ expect(supportsHostProxy("windows", "host_ui_snapshot")).toBe(true);
117
+ expect(supportsHostProxy("windows", "host_app_control")).toBe(false);
118
+ });
119
+
106
120
  // ── chrome-extension: only host_browser. ──
107
121
  test("chrome-extension returns false (no capability)", () => {
108
122
  // Chrome extension does not support "any host proxy at all" — it only
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Who a reply should be visible to, decided once for every producer.
3
+ */
4
+
5
+ import type { MessageAudience } from "@vellumai/gateway-client";
6
+
7
+ import { isSlackDmConversation } from "../messaging/providers/slack/message-metadata.js";
8
+
9
+ /**
10
+ * The audience a reply addressed at `userId` should carry, or `undefined` when
11
+ * the whole room may see it.
12
+ *
13
+ * Restricting a message only means something where someone else could read it.
14
+ * A room with one reader gets no restriction: a Slack DM is already private,
15
+ * and marking it restricted there costs durability, because an ephemeral
16
+ * message does not survive a reload.
17
+ *
18
+ * Slack is the only channel that can show one reader a message in a room it
19
+ * shares with others. The test is for a DM rather than for a channel id, so
20
+ * every other room shape counts as shared: a private group holds several
21
+ * readers even though its id begins with `G` rather than `C`.
22
+ *
23
+ * `sourceChannel` and `chatId` are loosely typed because the only questions
24
+ * asked of them are whether the channel is Slack and whether the room is a
25
+ * DM, and several callers hold values that were never narrowed. An unknown
26
+ * channel answers with no restriction rather than throwing.
27
+ */
28
+ export function audienceForReader(
29
+ sourceChannel: string | null | undefined,
30
+ chatId: string | null | undefined,
31
+ userId: string | null | undefined,
32
+ ): MessageAudience | undefined {
33
+ if (sourceChannel !== "slack" || !userId || !chatId) {
34
+ return undefined;
35
+ }
36
+ if (isSlackDmConversation(chatId)) {
37
+ return undefined;
38
+ }
39
+ return { kind: "oneReader", userId };
40
+ }
@@ -166,6 +166,7 @@ export const CHANNEL_METADATA: Partial<Record<ChannelId, ChannelInfo>> = {
166
166
 
167
167
  export const INTERFACE_IDS = [
168
168
  "macos",
169
+ "windows",
169
170
  "ios",
170
171
  "cli",
171
172
  "telegram",
@@ -264,6 +265,7 @@ export function parseClientOs(value: unknown): ClientOs | null {
264
265
  */
265
266
  export const INTERACTIVE_INTERFACES: ReadonlySet<InterfaceId> = new Set([
266
267
  "macos",
268
+ "windows",
267
269
  "ios",
268
270
  "cli",
269
271
  "web",
@@ -274,9 +276,9 @@ export function isInteractiveInterface(id: InterfaceId): boolean {
274
276
  }
275
277
 
276
278
  /**
277
- * Host proxy capabilities that an interface can support. The macOS client
278
- * supports all of them; the chrome-extension interface only supports
279
- * host_browser (via the Chrome DevTools Protocol proxy).
279
+ * Host proxy capabilities that an interface can support. macOS supports all
280
+ * of them, Windows withholds app control, and chrome-extension supports only
281
+ * host_browser through the Chrome DevTools Protocol proxy.
280
282
  */
281
283
  export const HOST_PROXY_CAPABILITIES = [
282
284
  "host_bash",
@@ -290,29 +292,28 @@ export const HOST_PROXY_CAPABILITIES = [
290
292
  export type HostProxyCapability = (typeof HOST_PROXY_CAPABILITIES)[number];
291
293
 
292
294
  /**
293
- * Interfaces that support the full desktop host-proxy set (every
294
- * `HostProxyCapability` value). This is the capability-level identity used
295
- * by the discriminated transport metadata union and by the
295
+ * Interfaces that support desktop host-proxy tools. This identity is used by
296
+ * the discriminated transport metadata union and by the
296
297
  * `supportsHostProxy(id)` type predicate.
297
298
  *
298
299
  * Extend this literal type AND the `supportsHostProxy` implementation
299
- * below in lock-step when adding a new host-capable client (e.g. a native
300
- * Linux or Windows desktop).
300
+ * below in lock-step when adding a new host-capable client such as native
301
+ * Linux.
301
302
  */
302
- export type HostProxyInterfaceId = "macos";
303
+ export type HostProxyInterfaceId = "macos" | "windows";
303
304
 
304
305
  /**
305
306
  * Whether the interface supports a host proxy capability.
306
307
  *
307
308
  * The no-arg form `supportsHostProxy(id)` asks "is this interface a desktop
308
- * host-proxy client?" — it returns `true` only for macOS and is the type
309
+ * host-proxy client?" It returns `true` for native desktop clients and is the
309
310
  * predicate that narrows `InterfaceId` to `HostProxyInterfaceId`. It returns
310
311
  * `false` for chrome-extension because chrome-extension only supports
311
312
  * `host_browser`, and the no-arg form is the gate that legacy desktop-only
312
313
  * call sites use (e.g. preactivating computer-use, restoring host proxies
313
- * in the drain queue). Callers that want to check a single capability —
314
+ * in the drain queue). Callers that want to check a single capability,
314
315
  * for example, to decide whether to keep `hostBrowserProxy` available for
315
- * chrome-extension — should pass the capability explicitly:
316
+ * chrome-extension, should pass the capability explicitly:
316
317
  * `supportsHostProxy(id, "host_browser")`.
317
318
  */
318
319
  export function supportsHostProxy(id: InterfaceId): id is HostProxyInterfaceId;
@@ -331,6 +332,9 @@ export function supportsHostProxy(
331
332
  if (id === "macos") {
332
333
  return true;
333
334
  }
335
+ if (id === "windows") {
336
+ return capability == null || capability !== "host_app_control";
337
+ }
334
338
  if (id === "chrome-extension" && capability === "host_browser") {
335
339
  return true;
336
340
  }
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Memory injection indexes CLI help via {@link buildCliCommandHelpContent}.
3
+ * Setup prompts like "Setup <app> for me" should retrieve `plugins search` /
4
+ * `skills search` before the model falls back to web search.
5
+ *
6
+ * These assertions lock the retrieval phrases in the indexed blob so a later
7
+ * wording change cannot silently drop them.
8
+ */
9
+ import { describe, expect, test } from "bun:test";
10
+
11
+ import { buildCliCommandHelpContent } from "../../plugins/defaults/memory/substrate/cli-command-content.js";
12
+ import { pluginsHelp } from "../commands/plugins.help.js";
13
+ import { skillsHelp } from "../commands/skills.help.js";
14
+
15
+ function searchHelp(
16
+ help: { subcommands?: Array<{ name: string; helpText?: string }> },
17
+ ): { name: string; helpText?: string } {
18
+ const search = help.subcommands?.find((sub) => sub.name === "search");
19
+ if (!search) {
20
+ throw new Error("expected a search subcommand");
21
+ }
22
+ return search;
23
+ }
24
+
25
+ describe("catalog search help for setup-intent retrieval", () => {
26
+ test("plugins help indexes setup, superpowers, and web-search fallback", () => {
27
+ const indexed = buildCliCommandHelpContent(pluginsHelp);
28
+ const search = searchHelp(pluginsHelp);
29
+
30
+ expect(search.helpText).toBeDefined();
31
+ expect(indexed.toLowerCase()).toContain("superpowers");
32
+ expect(indexed).toContain("Setup <app> for me");
33
+ expect(indexed.toLowerCase()).toContain("before searching the web");
34
+ expect(indexed).toContain("assistant plugins search");
35
+ expect(indexed).toContain("assistant skills search");
36
+ expect(indexed.toLowerCase()).not.toContain("empty query");
37
+ });
38
+
39
+ test("skills help indexes setup as the second stop before web search", () => {
40
+ const indexed = buildCliCommandHelpContent(skillsHelp);
41
+ const search = searchHelp(skillsHelp);
42
+
43
+ expect(search.helpText).toBeDefined();
44
+ expect(indexed).toContain("Second stop after plugin search");
45
+ expect(indexed).toContain("Setup <app> for me");
46
+ expect(indexed.toLowerCase()).toContain("before searching the web");
47
+ expect(indexed).toContain("assistant skills search");
48
+ expect(indexed).toContain("try web search");
49
+ });
50
+ });
@@ -13,10 +13,12 @@
13
13
  * - `revoke` with no flags (channel: undefined)
14
14
  * - `revoke --channel phone` sends channel param
15
15
  * - `create --channel fax` → invalid channel, exits with code 1, IPC not called
16
+ * - the accepted `--channel` set is the canonical CHANNEL_IDS vocabulary
16
17
  */
17
18
 
18
19
  import { beforeEach, describe, expect, mock, test } from "bun:test";
19
20
 
21
+ import { CHANNEL_IDS } from "@vellumai/service-contracts/channels";
20
22
  import { Command } from "commander";
21
23
 
22
24
  // ---------------------------------------------------------------------------
@@ -242,6 +244,35 @@ describe("channel-verification-sessions create", () => {
242
244
  expect(lastIpcCall).toBeNull();
243
245
  });
244
246
 
247
+ test("--channel discord reaches IPC (canonical vocabulary, not a local copy)", async () => {
248
+ const { exitCode } = await runCommand([
249
+ "channel-verification-sessions",
250
+ "create",
251
+ "--channel",
252
+ "discord",
253
+ ]);
254
+
255
+ expect(exitCode).toBe(0);
256
+ expect(lastIpcCall!.method).toBe("channel_verification_sessions_create");
257
+ expect(lastIpcCall!.params).toMatchObject({
258
+ body: { channel: "discord", purpose: "guardian" },
259
+ });
260
+ });
261
+
262
+ test("every canonical channel id is accepted", async () => {
263
+ for (const channel of CHANNEL_IDS) {
264
+ const { exitCode } = await runCommand([
265
+ "channel-verification-sessions",
266
+ "create",
267
+ "--channel",
268
+ channel,
269
+ ]);
270
+
271
+ expect(exitCode).toBe(0);
272
+ expect(lastIpcCall!.params).toMatchObject({ body: { channel } });
273
+ }
274
+ });
275
+
245
276
  test("IPC error results in exit code 1", async () => {
246
277
  mockIpcResult = { ok: false, error: "Could not connect" };
247
278