@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
@@ -30,7 +30,8 @@ mock.module("./api.js", () => ({
30
30
  }));
31
31
 
32
32
  const { TelegramNonRetryableError } = await import("./api.js");
33
- const { sendTelegramReply, sendTelegramRichReply } = await import("./send.js");
33
+ const { editTelegramMessage, sendTelegramReply, sendTelegramRichReply } =
34
+ await import("./send.js");
34
35
  const { telegramTransport } = await import("./transport.js");
35
36
 
36
37
  const approval: ApprovalUIMetadata = {
@@ -191,15 +192,15 @@ describe("telegramTransport.deliver routing", () => {
191
192
  } as ChannelReplyPayload;
192
193
  }
193
194
 
194
- test("routes to the rich send when useBlocks is set", async () => {
195
- await telegramTransport.deliver(ctx, payload({ useBlocks: true }));
195
+ test("routes to the rich send when a rich render is asked for", async () => {
196
+ await telegramTransport.deliver(ctx, payload({ renderRichly: true }));
196
197
 
197
198
  expect(callsTo("sendRichMessage")).toHaveLength(1);
198
199
  expect(callsTo("sendMessage")).toHaveLength(0);
199
200
  });
200
201
 
201
- test("stays on the plain send when useBlocks is absent", async () => {
202
- await telegramTransport.deliver(ctx, payload({ useBlocks: false }));
202
+ test("stays on the plain send when it is not", async () => {
203
+ await telegramTransport.deliver(ctx, payload({ renderRichly: false }));
203
204
 
204
205
  expect(callsTo("sendRichMessage")).toHaveLength(0);
205
206
  expect(callsTo("sendMessage")).toHaveLength(1);
@@ -208,7 +209,7 @@ describe("telegramTransport.deliver routing", () => {
208
209
  test("forwards approval metadata through the rich path", async () => {
209
210
  await telegramTransport.deliver(
210
211
  ctx,
211
- payload({ useBlocks: true, approval } as Partial<ChannelReplyPayload>),
212
+ payload({ renderRichly: true, approval } as Partial<ChannelReplyPayload>),
212
213
  );
213
214
 
214
215
  expect(callTelegramBotApiMock).toHaveBeenCalledWith("sendRichMessage", {
@@ -238,7 +239,7 @@ describe("telegramTransport topic targeting", () => {
238
239
  }
239
240
 
240
241
  test("plain replies target the topic from the callback threadId param", async () => {
241
- await telegramTransport.deliver(topicCtx, payload({ useBlocks: false }));
242
+ await telegramTransport.deliver(topicCtx, payload({ renderRichly: false }));
242
243
 
243
244
  expect(callTelegramBotApiMock).toHaveBeenCalledWith("sendMessage", {
244
245
  chat_id: "123",
@@ -248,7 +249,7 @@ describe("telegramTransport topic targeting", () => {
248
249
  });
249
250
 
250
251
  test("rich replies target the topic", async () => {
251
- await telegramTransport.deliver(topicCtx, payload({ useBlocks: true }));
252
+ await telegramTransport.deliver(topicCtx, payload({ renderRichly: true }));
252
253
 
253
254
  expect(callTelegramBotApiMock).toHaveBeenCalledWith("sendRichMessage", {
254
255
  chat_id: "123",
@@ -262,7 +263,7 @@ describe("telegramTransport topic targeting", () => {
262
263
  throw new TelegramNonRetryableError("rejected", "rejected");
263
264
  });
264
265
 
265
- await telegramTransport.deliver(topicCtx, payload({ useBlocks: true }));
266
+ await telegramTransport.deliver(topicCtx, payload({ renderRichly: true }));
266
267
 
267
268
  expect(callTelegramBotApiMock).toHaveBeenNthCalledWith(2, "sendMessage", {
268
269
  chat_id: "123",
@@ -272,10 +273,10 @@ describe("telegramTransport topic targeting", () => {
272
273
  });
273
274
 
274
275
  test("typing indicators target the topic", async () => {
275
- await telegramTransport.sendTyping!(
276
- topicCtx,
277
- payload({ chatAction: "typing" }),
278
- );
276
+ await telegramTransport.setActivity!(topicCtx, {
277
+ chatId: "123",
278
+ phase: "thinking",
279
+ });
279
280
 
280
281
  expect(callTelegramBotApiMock).toHaveBeenCalledWith("sendChatAction", {
281
282
  chat_id: "123",
@@ -284,17 +285,32 @@ describe("telegramTransport topic targeting", () => {
284
285
  });
285
286
  });
286
287
 
288
+ // Telegram's chat action expires on its own, so a phase that is not running
289
+ // has nothing to say. Asserting the call count rather than the absence of a
290
+ // "stop" call is what catches a clearing request being invented later.
291
+ test.each(["idle", "awaiting_confirmation"] as const)(
292
+ "says nothing to Telegram for the %s phase",
293
+ async (phase) => {
294
+ await telegramTransport.setActivity!(topicCtx, {
295
+ chatId: "123",
296
+ phase,
297
+ });
298
+
299
+ expect(callTelegramBotApiMock).not.toHaveBeenCalled();
300
+ },
301
+ );
302
+
287
303
  test("a callback URL without threadId keeps sends thread-less", async () => {
288
304
  const bareCtx: CallbackContext = {
289
305
  callbackUrl: "/deliver/telegram",
290
306
  params: {},
291
307
  };
292
308
 
293
- await telegramTransport.deliver(bareCtx, payload({ useBlocks: false }));
294
- await telegramTransport.sendTyping!(
295
- bareCtx,
296
- payload({ chatAction: "typing" }),
297
- );
309
+ await telegramTransport.deliver(bareCtx, payload({ renderRichly: false }));
310
+ await telegramTransport.setActivity!(bareCtx, {
311
+ chatId: "123",
312
+ phase: "thinking",
313
+ });
298
314
 
299
315
  expect(callTelegramBotApiMock).toHaveBeenCalledWith("sendMessage", {
300
316
  chat_id: "123",
@@ -306,3 +322,57 @@ describe("telegramTransport topic targeting", () => {
306
322
  });
307
323
  });
308
324
  });
325
+
326
+ describe("editTelegramMessage", () => {
327
+ const ctx = { callbackUrl: "http://gw/deliver/telegram", params: {} };
328
+
329
+ const sendMessageCalls = () =>
330
+ callTelegramBotApiMock.mock.calls.filter(
331
+ (call) => call[0] === "sendMessage",
332
+ );
333
+
334
+ test("edits in place and never posts a new message", async () => {
335
+ await telegramTransport.edit!(ctx as CallbackContext, {
336
+ chatId: "123",
337
+ messageId: "456",
338
+ text: "revised",
339
+ });
340
+
341
+ expect(callTelegramBotApiMock).toHaveBeenCalledTimes(1);
342
+ const [method, body] = callTelegramBotApiMock.mock.calls[0]!;
343
+ expect(method).toBe("editMessageText");
344
+ // Telegram wants a numeric message id, where the capability carries the
345
+ // channel's id as a string.
346
+ expect(body).toEqual({ chat_id: "123", message_id: 456, text: "revised" });
347
+ });
348
+
349
+ test("treats an unchanged message as already done", async () => {
350
+ callTelegramBotApiMock.mockImplementationOnce(async () => {
351
+ throw new TelegramNonRetryableError(
352
+ "Bad Request",
353
+ "Bad Request: message is not modified",
354
+ );
355
+ });
356
+
357
+ // The edit asked for a state the message is already in, which is the
358
+ // request satisfied rather than refused.
359
+ await expect(
360
+ editTelegramMessage("123", "456", "same"),
361
+ ).resolves.toBeUndefined();
362
+ expect(sendMessageCalls()).toHaveLength(0);
363
+ });
364
+
365
+ test("throws on any other rejection rather than posting a replacement", async () => {
366
+ callTelegramBotApiMock.mockImplementationOnce(async () => {
367
+ throw new TelegramNonRetryableError(
368
+ "Bad Request",
369
+ "Bad Request: message to edit not found",
370
+ );
371
+ });
372
+
373
+ // Posting instead would leave the original beside a duplicate, so the
374
+ // failure has to reach the caller.
375
+ await expect(editTelegramMessage("123", "456", "gone")).rejects.toThrow();
376
+ expect(sendMessageCalls()).toHaveLength(0);
377
+ });
378
+ });
@@ -137,6 +137,42 @@ export interface TelegramSendResult {
137
137
  * Send a Telegram text reply, splitting long messages and optionally
138
138
  * attaching inline keyboard buttons for approval prompts.
139
139
  */
140
+ /**
141
+ * Replace a Telegram message in place.
142
+ *
143
+ * Telegram rejects an edit whose text already matches the message. That is the
144
+ * request having been satisfied rather than a failure, so it resolves. Every
145
+ * other rejection throws: an edit that quietly became a new message would
146
+ * leave the original sitting beside it, which reads as answering twice.
147
+ *
148
+ * Unlike a send, this cannot split long text across messages, because an edit
149
+ * addresses exactly one. Telegram rejects text past its limit, and that
150
+ * rejection reaches the caller rather than being papered over.
151
+ */
152
+ export async function editTelegramMessage(
153
+ chatId: string,
154
+ messageId: string,
155
+ text: string,
156
+ ): Promise<void> {
157
+ try {
158
+ await callTelegramBotApi<TelegramMessage>("editMessageText", {
159
+ chat_id: chatId,
160
+ message_id: Number(messageId),
161
+ text,
162
+ });
163
+ } catch (err) {
164
+ if (
165
+ err instanceof TelegramNonRetryableError &&
166
+ err.description?.includes("message is not modified")
167
+ ) {
168
+ log.debug({ chatId, messageId }, "Telegram edit already applied");
169
+ return;
170
+ }
171
+ throw err;
172
+ }
173
+ log.debug({ chatId, messageId }, "Telegram message edited");
174
+ }
175
+
140
176
  export async function sendTelegramReply(
141
177
  chatId: string,
142
178
  text: string,
@@ -5,8 +5,10 @@ import type {
5
5
  CallbackContext,
6
6
  ChannelTransport,
7
7
  } from "../channel-transport.js";
8
+ import { isBusyActivityPhase } from "../channel-transport.js";
8
9
  import type { TelegramSendOptions } from "./send.js";
9
10
  import {
11
+ editTelegramMessage,
10
12
  sendTelegramAttachments,
11
13
  sendTelegramReply,
12
14
  sendTelegramRichReply,
@@ -27,16 +29,18 @@ function threadOptions(ctx: CallbackContext): TelegramSendOptions | undefined {
27
29
  export const telegramTransport: ChannelTransport = {
28
30
  channel: "telegram",
29
31
 
32
+ // Telegram clears a chat action after about five seconds.
33
+ activityRefreshMs: 4_000,
34
+
30
35
  async deliver(ctx, payload) {
31
36
  const { chatId, text, attachments, approval } = payload;
32
37
  const opts = threadOptions(ctx);
33
38
 
34
39
  if (text) {
35
- // `useBlocks` is the channel-neutral "render richly" intent set by the
36
- // delivery layer; the Telegram adapter honors it by forwarding markdown
37
- // to `sendRichMessage`, degrading to plain text otherwise (and on any
38
- // rich-send rejection).
39
- if (payload.useBlocks) {
40
+ // Telegram answers a rich render by forwarding markdown to
41
+ // `sendRichMessage`, degrading to plain text otherwise and on any
42
+ // rich-send rejection.
43
+ if (payload.renderRichly) {
40
44
  await sendTelegramRichReply(chatId, text, approval, opts);
41
45
  } else {
42
46
  await sendTelegramReply(chatId, text, approval, opts);
@@ -67,10 +71,20 @@ export const telegramTransport: ChannelTransport = {
67
71
  return { ok: true };
68
72
  },
69
73
 
70
- async sendTyping(ctx, payload) {
71
- await sendTelegramTypingIndicator(payload.chatId, threadOptions(ctx));
74
+ async edit(_ctx, target) {
75
+ await editTelegramMessage(target.chatId, target.messageId, target.text);
76
+ return { ok: true };
77
+ },
78
+
79
+ async setActivity(ctx, target) {
80
+ // Telegram's chat action expires by itself after a few seconds, so a phase
81
+ // that is not running needs no clearing call.
82
+ if (!isBusyActivityPhase(target.phase)) {
83
+ return { ok: true };
84
+ }
85
+ await sendTelegramTypingIndicator(target.chatId, threadOptions(ctx));
72
86
  log.debug(
73
- { chatId: payload.chatId },
87
+ { chatId: target.chatId, phase: target.phase },
74
88
  "Telegram typing indicator delivered (direct)",
75
89
  );
76
90
  return { ok: true };
@@ -0,0 +1,157 @@
1
+ import { describe, expect, it } from "bun:test";
2
+
3
+ import {
4
+ groupingMessageId,
5
+ type ProviderMessageMetadata,
6
+ } from "./provider-message-metadata.js";
7
+ import type { SlackMessageMetadata } from "./providers/slack/message-metadata.js";
8
+ import { readProviderMetadata } from "./read-provider-metadata.js";
9
+
10
+ const CHANNEL = "C0123CHANNEL";
11
+ const MESSAGE_TS = "1700000000.000100";
12
+ const TARGET_TS = "1699999999.000001";
13
+
14
+ function slackRow(
15
+ overrides: Partial<SlackMessageMetadata> = {},
16
+ ): SlackMessageMetadata {
17
+ return {
18
+ source: "slack",
19
+ channelId: CHANNEL,
20
+ channelTs: MESSAGE_TS,
21
+ eventKind: "message",
22
+ ...overrides,
23
+ };
24
+ }
25
+
26
+ describe("readProviderMetadata", () => {
27
+ it("reads a row that only has the legacy Slack envelope", () => {
28
+ // Slack's own envelope is mapped on read, so no row is rewritten.
29
+ const metadata = JSON.stringify({
30
+ slackMeta: JSON.stringify(slackRow({ threadTs: TARGET_TS })),
31
+ });
32
+
33
+ expect(readProviderMetadata(metadata)).toEqual({
34
+ source: "slack",
35
+ conversationExternalId: CHANNEL,
36
+ messageId: MESSAGE_TS,
37
+ threadId: TARGET_TS,
38
+ eventKind: "message",
39
+ } satisfies ProviderMessageMetadata);
40
+ });
41
+
42
+ it("carries the actor's provider id, not just a display name", () => {
43
+ // Trust is keyed on the actor everywhere else, and a channel describing
44
+ // who reacted needs an identity rather than a label.
45
+ const metadata = JSON.stringify({
46
+ slackMeta: JSON.stringify(
47
+ slackRow({ actorExternalUserId: "U0123", displayName: "Jason" }),
48
+ ),
49
+ });
50
+
51
+ const meta = readProviderMetadata(metadata);
52
+ expect(meta?.actorExternalId).toBe("U0123");
53
+ expect(meta?.displayName).toBe("Jason");
54
+ });
55
+
56
+ it("maps a reaction's target onto the neutral name", () => {
57
+ const metadata = JSON.stringify({
58
+ slackMeta: JSON.stringify(
59
+ slackRow({
60
+ eventKind: "reaction",
61
+ reaction: {
62
+ emoji: "thumbsup",
63
+ targetChannelTs: TARGET_TS,
64
+ op: "added",
65
+ actorDisplayName: "Jason",
66
+ },
67
+ }),
68
+ ),
69
+ });
70
+
71
+ const meta = readProviderMetadata(metadata);
72
+ expect(meta?.eventKind).toBe("reaction");
73
+ // No channel gives a reaction an id of its own, so the row must not claim
74
+ // its target's: two rows sharing one id break resolution by message id.
75
+ expect(meta?.messageId).toBeUndefined();
76
+ expect(meta?.reaction).toEqual({
77
+ targetMessageId: TARGET_TS,
78
+ emoji: "thumbsup",
79
+ op: "added",
80
+ actorDisplayName: "Jason",
81
+ });
82
+ });
83
+
84
+ it("leaves threadId absent when the row is not in a thread", () => {
85
+ // A thread id here asserts that a thread exists. Synthesizing one from
86
+ // the message's own id is what keyed conversations on threads that never
87
+ // did (LUM-3330, LUM-3340), so absence has to survive the mapping.
88
+ const metadata = JSON.stringify({
89
+ slackMeta: JSON.stringify(slackRow()),
90
+ });
91
+
92
+ const meta = readProviderMetadata(metadata);
93
+ expect(meta).not.toBeNull();
94
+ expect(meta?.threadId).toBeUndefined();
95
+ expect(meta?.messageId).toBe(MESSAGE_TS);
96
+ });
97
+
98
+ it("reads a channel this repo has no code for", () => {
99
+ // The point of the neutral shape. A plugin channel cannot add an adapter
100
+ // here, so it describes its own rows directly and every channel-agnostic
101
+ // reader understands them with no Vellum code naming that channel.
102
+ const metadata = JSON.stringify({
103
+ providerMeta: JSON.stringify({
104
+ source: "plugin",
105
+ conversationExternalId: "room-42",
106
+ messageId: "evt-9",
107
+ threadId: "evt-1",
108
+ eventKind: "reaction",
109
+ reaction: {
110
+ targetMessageId: "evt-1",
111
+ emoji: "tada",
112
+ op: "added",
113
+ },
114
+ } satisfies ProviderMessageMetadata),
115
+ });
116
+
117
+ const meta = readProviderMetadata(metadata);
118
+ expect(meta?.source).toBe("plugin");
119
+ expect(meta?.reaction?.targetMessageId).toBe("evt-1");
120
+ // Grouping is what history assembly keys on, so a reaction from an
121
+ // unknown channel lands beside the message it was attached to.
122
+ expect(groupingMessageId(meta!)).toBe("evt-1");
123
+ });
124
+
125
+ it("groups a message by its own id", () => {
126
+ const metadata = JSON.stringify({
127
+ slackMeta: JSON.stringify(slackRow()),
128
+ });
129
+
130
+ expect(groupingMessageId(readProviderMetadata(metadata)!)).toBe(MESSAGE_TS);
131
+ });
132
+
133
+ it("keeps provider fields the neutral schema does not name", () => {
134
+ // The schema passes through, so a channel can carry its own fields on the
135
+ // same object instead of getting a second envelope.
136
+ const metadata = JSON.stringify({
137
+ providerMeta: JSON.stringify({
138
+ source: "slack",
139
+ conversationExternalId: CHANNEL,
140
+ messageId: MESSAGE_TS,
141
+ eventKind: "message",
142
+ slackFiles: [{ name: "diagram.png" }],
143
+ }),
144
+ });
145
+
146
+ expect(
147
+ (readProviderMetadata(metadata) as Record<string, unknown> | null)
148
+ ?.slackFiles,
149
+ ).toEqual([{ name: "diagram.png" }]);
150
+ });
151
+
152
+ it("reads as null when the row carries neither envelope", () => {
153
+ expect(readProviderMetadata(JSON.stringify({ other: 1 }))).toBeNull();
154
+ expect(readProviderMetadata("not json")).toBeNull();
155
+ expect(readProviderMetadata(null)).toBeNull();
156
+ });
157
+ });
@@ -0,0 +1,51 @@
1
+ import { safeParseRecord } from "../util/json.js";
2
+ import {
3
+ type ProviderMessageMetadata,
4
+ readProviderMessageMetadata,
5
+ } from "./provider-message-metadata.js";
6
+ import {
7
+ readSlackMetadataFromMessageMetadata,
8
+ slackMetadataAsProviderMetadata,
9
+ } from "./providers/slack/message-metadata.js";
10
+
11
+ /**
12
+ * Read a stored row's channel metadata in terms no single provider owns.
13
+ *
14
+ * Two ways a row can carry it, in this order.
15
+ *
16
+ * `providerMeta` is the neutral shape written directly. This is the path that
17
+ * matters most: a channel we have no code for, a plugin channel above all,
18
+ * can describe its own rows in it and every channel-agnostic reader
19
+ * understands them. History assembly, the conversation route and the
20
+ * transcript renderer then work for a channel nobody here has heard of.
21
+ *
22
+ * `slackMeta` is Slack's own envelope, mapped on read. It holds fields no
23
+ * other channel has an equivalent for, so Slack keeps writing it and loses
24
+ * nothing. A channel that writes `providerMeta` needs no adapter at all.
25
+ *
26
+ * Normalizing on read is what allows both. Writing stays where provider
27
+ * detail legitimately lives, and nothing is stored twice.
28
+ *
29
+ * A row with no recognized envelope, or one that fails validation, reads as
30
+ * null: callers already treat absent metadata as "not a channel row".
31
+ */
32
+ export function readProviderMetadata(
33
+ metadata: string | null | undefined,
34
+ opts?: { allowFlatLegacy?: boolean },
35
+ ): ProviderMessageMetadata | null {
36
+ if (!metadata) {
37
+ return null;
38
+ }
39
+
40
+ // Malformed neutral metadata falls through to the provider envelopes rather
41
+ // than failing the read outright.
42
+ const neutral = readProviderMessageMetadata(
43
+ safeParseRecord(metadata).providerMeta,
44
+ );
45
+ if (neutral) {
46
+ return neutral;
47
+ }
48
+
49
+ const slackMeta = readSlackMetadataFromMessageMetadata(metadata, opts);
50
+ return slackMeta ? slackMetadataAsProviderMetadata(slackMeta) : null;
51
+ }
@@ -94,6 +94,23 @@ mock.module("../../runtime/desktop-presence.js", () => ({
94
94
  },
95
95
  }));
96
96
 
97
+ // Defaults to unfocused, so every other case in this file exercises the
98
+ // unsuppressed path.
99
+ let webFocused = false;
100
+ let webPresenceShouldThrow = false;
101
+ const webPresenceArgs: unknown[][] = [];
102
+ const realWebPresence = await import("../../runtime/web-presence.js");
103
+ mock.module("../../runtime/web-presence.js", () => ({
104
+ ...realWebPresence,
105
+ isWebConversationFocused: (...args: unknown[]) => {
106
+ webPresenceArgs.push(args);
107
+ if (webPresenceShouldThrow) {
108
+ throw new Error("simulated presence read failure");
109
+ }
110
+ return webFocused;
111
+ },
112
+ }));
113
+
97
114
  const realAttentionStore =
98
115
  await import("../../persistence/conversation-attention-store.js");
99
116
  mock.module("../../persistence/conversation-attention-store.js", () => ({
@@ -183,6 +200,22 @@ function makeMacOriginatedMessage(): MessageRow {
183
200
  });
184
201
  }
185
202
 
203
+ /**
204
+ * A turn opened from a plain browser tab, as opposed to the Electron desktop
205
+ * renderer sharing the same web bundle: `client.os` is `"web"` only when
206
+ * `detectClientOs()` fails to resolve an Electron host OS first.
207
+ */
208
+ function makeWebOriginatedMessage(): MessageRow {
209
+ return makeMessage({
210
+ metadata: JSON.stringify({
211
+ userMessageChannel: "vellum",
212
+ userMessageInterface: "web",
213
+ client: { os: "web" },
214
+ clientOsFromRequest: true,
215
+ }),
216
+ });
217
+ }
218
+
186
219
  function makeAssistantRow(content: ContentBlock[]): MessageRow {
187
220
  return makeMessage({
188
221
  id: ASSISTANT_MESSAGE_ID,
@@ -250,9 +283,12 @@ beforeEach(() => {
250
283
  messageLookups.length = 0;
251
284
  attachmentLookups.length = 0;
252
285
  desktopPresenceArgs.length = 0;
286
+ webPresenceArgs.length = 0;
253
287
  assistantAttachments = [];
254
288
  desktopAttended = false;
255
289
  desktopPresenceShouldThrow = false;
290
+ webFocused = false;
291
+ webPresenceShouldThrow = false;
256
292
  getConversationShouldThrow = false;
257
293
  conversationRow = makeConversation();
258
294
  assistantRow = makeAssistantRow([
@@ -433,6 +469,64 @@ describe("emitAssistantReplyNotification", () => {
433
469
  });
434
470
  });
435
471
 
472
+ // Same pre-gate as "desktop presence" above, scoped to a browser tab
473
+ // instead of the whole app.
474
+ describe("web presence", () => {
475
+ beforeEach(() => {
476
+ initiatingRow = makeWebOriginatedMessage();
477
+ webFocused = true;
478
+ });
479
+
480
+ test("marks the signal source-active while a web tab reports itself focused on this conversation", async () => {
481
+ await run();
482
+
483
+ expect(emitCalls).toHaveLength(1);
484
+ expect(emitCalls[0].attentionHints.visibleInSourceNow).toBe(true);
485
+ // Scoped to this conversation, unlike desktop attendance: a focused tab
486
+ // only speaks for the conversation it is actually looking at.
487
+ expect(webPresenceArgs).toEqual([[CONVERSATION_ID]]);
488
+ });
489
+
490
+ test("leaves the signal live when no web tab is focused on this conversation", async () => {
491
+ webFocused = false;
492
+
493
+ await run();
494
+
495
+ expect(emitCalls).toHaveLength(1);
496
+ expect(emitCalls[0].attentionHints.visibleInSourceNow).toBe(false);
497
+ });
498
+
499
+ test("leaves the signal live when the web presence flag is off", async () => {
500
+ setOverridesForTesting({ "web-presence-suppression": false });
501
+
502
+ await run();
503
+
504
+ expect(emitCalls).toHaveLength(1);
505
+ expect(emitCalls[0].attentionHints.visibleInSourceNow).toBe(false);
506
+ expect(webPresenceArgs).toEqual([]);
507
+ });
508
+
509
+ test("leaves the signal live when the web presence read throws", async () => {
510
+ webPresenceShouldThrow = true;
511
+
512
+ await run();
513
+
514
+ expect(emitCalls).toHaveLength(1);
515
+ expect(emitCalls[0].attentionHints.visibleInSourceNow).toBe(false);
516
+ expect(warnCalls).toHaveLength(1);
517
+ });
518
+
519
+ test("marks the signal source-active for a turn opened from the macOS app when a web tab is focused here", async () => {
520
+ initiatingRow = makeMacOriginatedMessage();
521
+
522
+ await run();
523
+
524
+ expect(emitCalls).toHaveLength(1);
525
+ expect(emitCalls[0].attentionHints.visibleInSourceNow).toBe(true);
526
+ expect(webPresenceArgs).toEqual([[CONVERSATION_ID]]);
527
+ });
528
+ });
529
+
436
530
  test("omits requestedTitle when the conversation has no title", async () => {
437
531
  conversationRow = makeConversation({ title: " " });
438
532