@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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vellumai/assistant",
3
- "version": "0.11.4",
3
+ "version": "0.11.5-dev.202608220019.a778cf0",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "exports": {
@@ -67,6 +67,12 @@ function projectProvider(
67
67
  if (entry.privacyPolicyUrl !== undefined) {
68
68
  projected.privacyPolicyUrl = entry.privacyPolicyUrl;
69
69
  }
70
+ if (entry.supportsApiBase !== undefined) {
71
+ projected.supportsApiBase = entry.supportsApiBase;
72
+ }
73
+ if (entry.defaultApiBase !== undefined) {
74
+ projected.defaultApiBase = entry.defaultApiBase;
75
+ }
70
76
  return projected;
71
77
  }
72
78
 
@@ -160,6 +160,13 @@ function cachedPrefixBlock(text: string): ContentBlock {
160
160
  } as unknown as ContentBlock;
161
161
  }
162
162
 
163
+ /**
164
+ * A 1x1 PNG. The send boundary validates image bytes before serialization, so
165
+ * an image fixture has to carry a real signature to reach the wire.
166
+ */
167
+ const PNG_B64 =
168
+ "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8DwHwAFAAH/q842iQAAAABJRU5ErkJggg==";
169
+
163
170
  const sampleTools: ToolDefinition[] = [
164
171
  {
165
172
  name: "file_read",
@@ -2754,7 +2761,7 @@ describe("AnthropicProvider — Cache-Control Characterization", () => {
2754
2761
  source: {
2755
2762
  type: "base64",
2756
2763
  media_type: "image/png",
2757
- data: "iVBOR",
2764
+ data: PNG_B64,
2758
2765
  },
2759
2766
  },
2760
2767
  { type: "text", text: "extra error detail" },
@@ -2806,7 +2813,7 @@ describe("AnthropicProvider — Cache-Control Characterization", () => {
2806
2813
  source: {
2807
2814
  type: "base64",
2808
2815
  media_type: "image/png",
2809
- data: "iVBOR",
2816
+ data: PNG_B64,
2810
2817
  },
2811
2818
  },
2812
2819
  ],
@@ -2853,7 +2860,7 @@ describe("AnthropicProvider — Cache-Control Characterization", () => {
2853
2860
  source: {
2854
2861
  type: "base64",
2855
2862
  media_type: "image/png",
2856
- data: "iVBOR",
2863
+ data: PNG_B64,
2857
2864
  },
2858
2865
  },
2859
2866
  ],
@@ -188,6 +188,46 @@ describe("approval interception trust-class gates", () => {
188
188
  );
189
189
  });
190
190
 
191
+ test("the principal-gate rejection stays visible only to the actor on Slack", async () => {
192
+ // A rejection that loses its audience is posted to the whole channel,
193
+ // telling everyone present that someone failed a guardian check. The
194
+ // audience is one object rather than a flag beside an id so it cannot be
195
+ // half-dropped, and this pins that it is actually sent.
196
+ _anchorPrincipalId = "the-real-guardian-principal";
197
+ registerPendingInteraction(
198
+ "req-guardian-mismatch-slack",
199
+ CONVERSATION_ID,
200
+ TOOL_NAME,
201
+ TOOL_INPUT,
202
+ );
203
+
204
+ await handleApprovalInterception({
205
+ conversationId: CONVERSATION_ID,
206
+ callbackData: "apr:req-guardian-mismatch-slack:approve_once",
207
+ content: "",
208
+ conversationExternalId: "C0SLACKROOM",
209
+ sourceChannel: "slack",
210
+ actorExternalId: "U0STALEGUARDIAN",
211
+ replyCallbackUrl: "https://gateway.test/deliver",
212
+ trustCtx: {
213
+ sourceChannel: "slack",
214
+ trustClass: "guardian",
215
+ requesterExternalUserId: "U0STALEGUARDIAN",
216
+ guardianExternalUserId: "U0STALEGUARDIAN",
217
+ guardianPrincipalId: "some-other-principal",
218
+ },
219
+ assistantId: ASSISTANT_ID,
220
+ });
221
+
222
+ expect(deliverSpy).toHaveBeenCalledWith(
223
+ "https://gateway.test/deliver",
224
+ expect.objectContaining({
225
+ text: "Sorry, I couldn't process that. Please try again.",
226
+ audience: { kind: "oneReader", userId: "U0STALEGUARDIAN" },
227
+ }),
228
+ );
229
+ });
230
+
191
231
  test("guardian without a resolved acting principal is rejected before any decision", async () => {
192
232
  // Address-only guardian classification (e.g. a binding row with a null
193
233
  // principal) must not authorize decisions.
@@ -99,7 +99,7 @@ mock.module("../persistence/conversation-crud.js", () => ({
99
99
  parseConversation: (row: unknown) => row,
100
100
  provenanceFromTrustContext: () => ({ source: "user" }),
101
101
  relinkAttachments: mock(() => {}),
102
- selectSlackMetaCandidateMetadata: () => null,
102
+ selectProviderMetaCandidateMetadata: () => null,
103
103
  setConversationOriginChannelIfUnset: mock(() => {}),
104
104
  setConversationOriginInterfaceIfUnset: mock(() => {}),
105
105
  setConversationInferenceProfile: mock(() => {}),
@@ -1614,6 +1614,10 @@ describe("background channel processing approval prompts", () => {
1614
1614
  | { requestId?: string }
1615
1615
  | undefined;
1616
1616
  expect(approvalMeta?.requestId).toBe("req-bg-1");
1617
+ // Telegram's chat is already one-to-one, so the prompt stays where the
1618
+ // turn is. Slack, where it does not, is covered in
1619
+ // guardian-prompt-notice-privacy.test.ts.
1620
+ expect(deliverPromptSpy.mock.calls[0]?.[1]).toBe("chat-123");
1617
1621
 
1618
1622
  deliverPromptSpy.mockRestore();
1619
1623
  });
@@ -250,7 +250,7 @@ describe("channel inbound disk pressure gate", () => {
250
250
 
251
251
  expect(body).toMatchObject({
252
252
  accepted: true,
253
- duplicate: false,
253
+ reaction: "dropped_disk_pressure",
254
254
  diskPressure: "blocked",
255
255
  reason: "trusted-contact",
256
256
  });
@@ -268,9 +268,9 @@ describe("channel inbound disk pressure gate", () => {
268
268
  eq(channelInboundEvents.externalMessageId, "slack-reaction-blocked"),
269
269
  )
270
270
  .get();
271
- expect(event?.processingStatus).toBe("processed");
272
- expect(event?.messageId).toBeNull();
273
- expect(event?.rawPayload).toBeNull();
271
+ // A blocked reaction writes nothing at all: it is dropped before the
272
+ // reacted message is resolved, so no event row is opened either.
273
+ expect(event).toBeUndefined();
274
274
  expect(db.select().from(messages).all()).toHaveLength(0);
275
275
  });
276
276
 
@@ -414,8 +414,7 @@ describe("channel inbound disk pressure gate", () => {
414
414
  chatId: "slack-channel-1",
415
415
  text: expectedRemoteBlockReply,
416
416
  assistantId: "self",
417
- ephemeral: true,
418
- user: "slack-user-1",
417
+ audience: { kind: "oneReader", userId: "slack-user-1" },
419
418
  },
420
419
  ],
421
420
  ]);
@@ -566,3 +566,129 @@ describe("ChannelReadinessService", () => {
566
566
  expect(probe.remoteCallCount).toBe(1);
567
567
  });
568
568
  });
569
+
570
+ describe("setup progress and operational health are separate axes", () => {
571
+ const configured = (name: string): ReadinessCheckResult => ({
572
+ name,
573
+ passed: true,
574
+ message: "configured",
575
+ });
576
+
577
+ test("a configured channel whose delivery fails is set up, not half set up", () => {
578
+ // The defect this separates: telling the owner of a fully configured
579
+ // channel to finish setup sends them to fix the one thing that is not
580
+ // broken. Setup is done; delivery is down.
581
+ const service = new ChannelReadinessService();
582
+ service.registerProbe(
583
+ makeProbe(
584
+ "phone",
585
+ [configured("creds")],
586
+ [
587
+ {
588
+ name: "inbound_delivery",
589
+ passed: false,
590
+ message: "nothing is arriving",
591
+ kind: "operational",
592
+ },
593
+ ],
594
+ ),
595
+ );
596
+
597
+ return service.getReadiness("phone", true).then(([snapshot]) => {
598
+ expect(snapshot.setupStatus).toBe("ready");
599
+ expect(snapshot.health).toBe("failing");
600
+ expect(snapshot.ready).toBe(false);
601
+ });
602
+ });
603
+
604
+ test("a delivery check that establishes nothing reads unknown, not failing", async () => {
605
+ const service = new ChannelReadinessService();
606
+ service.registerProbe(
607
+ makeProbe(
608
+ "phone",
609
+ [configured("creds")],
610
+ [
611
+ {
612
+ name: "inbound_delivery",
613
+ passed: true,
614
+ indeterminate: true,
615
+ message: "could not reach the provider",
616
+ kind: "operational",
617
+ },
618
+ ],
619
+ ),
620
+ );
621
+
622
+ const [snapshot] = await service.getReadiness("phone", true);
623
+ expect(snapshot.setupStatus).toBe("ready");
624
+ expect(snapshot.health).toBe("unknown");
625
+ // Unknown is not proof, so it cannot make the channel ready, and it is
626
+ // not a fault, so it must not be reported as one.
627
+ expect(snapshot.ready).toBe(false);
628
+ expect(snapshot.reasons).toEqual([]);
629
+ });
630
+
631
+ test("a channel that measures nothing operational reports no health at all", async () => {
632
+ // Absent, not "unknown": nothing was asked, so nothing is claimed, and
633
+ // readiness rests on configuration alone. This is the shape every channel
634
+ // without a delivery check still has today.
635
+ const service = new ChannelReadinessService();
636
+ service.registerProbe(makeProbe("phone", [configured("creds")]));
637
+
638
+ const [snapshot] = await service.getReadiness("phone", true);
639
+ expect(snapshot.health).toBeUndefined();
640
+ expect(snapshot.setupStatus).toBe("ready");
641
+ expect(snapshot.ready).toBe(true);
642
+ });
643
+
644
+ test("incomplete configuration still reads incomplete", async () => {
645
+ const service = new ChannelReadinessService();
646
+ service.registerProbe(
647
+ makeProbe("phone", [
648
+ configured("creds"),
649
+ { name: "ingress", passed: false, message: "no public URL" },
650
+ ]),
651
+ );
652
+
653
+ const [snapshot] = await service.getReadiness("phone", true);
654
+ expect(snapshot.setupStatus).toBe("incomplete");
655
+ expect(snapshot.ready).toBe(false);
656
+ });
657
+
658
+ test("an untouched channel is not_configured, not incomplete", async () => {
659
+ const service = new ChannelReadinessService();
660
+ service.registerProbe(
661
+ makeProbe("phone", [
662
+ { name: "creds", passed: false, message: "not configured" },
663
+ ]),
664
+ );
665
+
666
+ const [snapshot] = await service.getReadiness("phone", true);
667
+ expect(snapshot.setupStatus).toBe("not_configured");
668
+ expect(snapshot.ready).toBe(false);
669
+ });
670
+
671
+ test("ready still means every check verified, exactly as before", async () => {
672
+ // The safety property for this change: splitting the derivation must not
673
+ // move `ready` for any input, because the CLI and the web both gate on it.
674
+ const service = new ChannelReadinessService();
675
+ service.registerProbe(
676
+ makeProbe(
677
+ "phone",
678
+ [configured("creds")],
679
+ [
680
+ {
681
+ name: "inbound_delivery",
682
+ passed: true,
683
+ message: "arriving",
684
+ kind: "operational",
685
+ },
686
+ ],
687
+ ),
688
+ );
689
+
690
+ const [snapshot] = await service.getReadiness("phone", true);
691
+ expect(snapshot.ready).toBe(true);
692
+ expect(snapshot.health).toBe("ok");
693
+ });
694
+ });
@@ -58,6 +58,19 @@ const renderedHistoryContentQueue: RenderedHistoryStub[] = [];
58
58
 
59
59
  let deliveryFailAtIndex = -1;
60
60
 
61
+ const editCalls: { callbackUrl: string; target: Record<string, unknown> }[] =
62
+ [];
63
+
64
+ mock.module("../messaging/providers/index.js", () => ({
65
+ editChannelMessage: async (
66
+ callbackUrl: string,
67
+ target: Record<string, unknown>,
68
+ ) => {
69
+ editCalls.push({ callbackUrl, target });
70
+ return { ok: true };
71
+ },
72
+ }));
73
+
61
74
  mock.module("../runtime/gateway-client.js", () => ({
62
75
  deliverChannelReply: async (
63
76
  callbackUrl: string,
@@ -253,7 +266,7 @@ describe("channel-reply-delivery", () => {
253
266
  payload: {
254
267
  chatId: "chat-1",
255
268
  text: "Before tool.",
256
- useBlocks: true,
269
+ renderRichly: true,
257
270
  attachments: undefined,
258
271
  assistantId: "assistant-1",
259
272
  },
@@ -263,7 +276,7 @@ describe("channel-reply-delivery", () => {
263
276
  payload: {
264
277
  chatId: "chat-1",
265
278
  text: "After tool.",
266
- useBlocks: true,
279
+ renderRichly: true,
267
280
  attachments,
268
281
  assistantId: "assistant-1",
269
282
  },
@@ -322,14 +335,14 @@ describe("channel-reply-delivery", () => {
322
335
  expect(deliveryCalls[0].payload).toEqual({
323
336
  chatId: "chat-3",
324
337
  text: "Before tool.",
325
- useBlocks: true,
338
+ renderRichly: true,
326
339
  attachments: undefined,
327
340
  assistantId: "assistant-2",
328
341
  });
329
342
  expect(deliveryCalls[1].payload).toEqual({
330
343
  chatId: "chat-3",
331
344
  text: "After tool.",
332
- useBlocks: true,
345
+ renderRichly: true,
333
346
  attachments: [
334
347
  {
335
348
  id: "att-2",
@@ -782,31 +795,32 @@ describe("channel-reply-delivery", () => {
782
795
  chatId: "chat-live",
783
796
  attachments,
784
797
  assistantId: undefined,
785
- ephemeral: undefined,
786
- user: undefined,
787
- messageTs: "1700000000.000055",
798
+ audience: undefined,
788
799
  });
800
+ // Attachments post as new messages, so nothing is edited on this path.
801
+ expect(editCalls).toHaveLength(0);
789
802
  expect(seenTs).toEqual(["1700000000.000055"]);
790
803
  });
791
804
 
792
- it("passes ephemeral and user through to each delivery call", async () => {
805
+ it("carries the audience through to every delivery call", async () => {
806
+ const audience = { kind: "oneReader", userId: "U456" } as const;
793
807
  await deliverRenderedReplyViaCallback({
794
808
  callbackUrl: "http://gateway/deliver/slack",
795
809
  chatId: "C123",
796
810
  textSegments: ["Part 1.", "Part 2."],
797
811
  interSegmentDelayMs: 0,
798
- ephemeral: true,
799
- user: "U456",
812
+ audience,
800
813
  });
801
814
 
802
815
  expect(deliveryCalls).toHaveLength(2);
803
- expect(deliveryCalls[0].payload.ephemeral).toBe(true);
804
- expect(deliveryCalls[0].payload.user).toBe("U456");
805
- expect(deliveryCalls[1].payload.ephemeral).toBe(true);
806
- expect(deliveryCalls[1].payload.user).toBe("U456");
816
+ // Every segment, not just the first: a reply restricted to one reader
817
+ // that loses the restriction partway becomes a public one.
818
+ for (const call of deliveryCalls) {
819
+ expect(call.payload.audience).toEqual(audience);
820
+ }
807
821
  });
808
822
 
809
- it("does not include ephemeral fields when not set", async () => {
823
+ it("leaves the audience unset when the reply is for the room", async () => {
810
824
  await deliverRenderedReplyViaCallback({
811
825
  callbackUrl: "http://gateway/deliver/slack",
812
826
  chatId: "C123",
@@ -815,8 +829,7 @@ describe("channel-reply-delivery", () => {
815
829
  });
816
830
 
817
831
  expect(deliveryCalls).toHaveLength(1);
818
- expect(deliveryCalls[0].payload.ephemeral).toBeUndefined();
819
- expect(deliveryCalls[0].payload.user).toBeUndefined();
832
+ expect(deliveryCalls[0].payload.audience).toBeUndefined();
820
833
  });
821
834
 
822
835
  it("suppresses delivery when the only text segment is <no_response/>", async () => {