@vellumai/assistant 0.8.2 → 0.8.4

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 (503) hide show
  1. package/ARCHITECTURE.md +11 -12
  2. package/docker-entrypoint.sh +13 -2
  3. package/docker-init-apt-root.sh +79 -6
  4. package/node_modules/@vellumai/gateway-client/src/types.ts +2 -0
  5. package/openapi.yaml +945 -36
  6. package/package.json +1 -1
  7. package/src/__tests__/agent-loop-exit-reason.test.ts +271 -0
  8. package/src/__tests__/agent-loop-override-profile.test.ts +1 -1
  9. package/src/__tests__/agent-loop-provider-error-recording.test.ts +195 -0
  10. package/src/__tests__/agent-loop.test.ts +88 -3
  11. package/src/__tests__/anthropic-provider.test.ts +272 -0
  12. package/src/__tests__/approval-cascade.test.ts +1 -1
  13. package/src/__tests__/background-workers-disk-pressure.test.ts +2 -1
  14. package/src/__tests__/channel-delivery-store.test.ts +193 -0
  15. package/src/__tests__/channel-reply-delivery.test.ts +284 -5
  16. package/src/__tests__/channel-retry-sweep.test.ts +274 -1
  17. package/src/__tests__/compaction-events.test.ts +1 -1
  18. package/src/__tests__/compactor-preserved-tail-count.test.ts +110 -0
  19. package/src/__tests__/compactor-tail-resolution.test.ts +107 -1
  20. package/src/__tests__/config-get-vision-flag.test.ts +136 -0
  21. package/src/__tests__/config-loader-backfill.test.ts +115 -18
  22. package/src/__tests__/config-watcher.test.ts +1 -1
  23. package/src/__tests__/context-token-estimator.test.ts +112 -57
  24. package/src/__tests__/conversation-abort-tool-results.test.ts +1 -1
  25. package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +54 -3
  26. package/src/__tests__/conversation-agent-loop-overflow.test.ts +31 -6
  27. package/src/__tests__/conversation-agent-loop.test.ts +77 -3
  28. package/src/__tests__/conversation-app-control-lifecycle.test.ts +1 -1
  29. package/src/__tests__/conversation-clean-command.test.ts +137 -0
  30. package/src/__tests__/conversation-confirmation-signals.test.ts +1 -1
  31. package/src/__tests__/conversation-fork-crud.test.ts +161 -0
  32. package/src/__tests__/conversation-lifecycle.test.ts +1 -1
  33. package/src/__tests__/conversation-load-cleaned-at.test.ts +279 -0
  34. package/src/__tests__/conversation-load-history-repair.test.ts +1 -1
  35. package/src/__tests__/conversation-media-retry.test.ts +19 -8
  36. package/src/__tests__/conversation-pairing.test.ts +2 -2
  37. package/src/__tests__/conversation-process-callsite.test.ts +1 -1
  38. package/src/__tests__/conversation-provider-retry-repair.test.ts +1 -1
  39. package/src/__tests__/conversation-queue.test.ts +1 -1
  40. package/src/__tests__/conversation-runtime-assembly.test.ts +290 -85
  41. package/src/__tests__/conversation-seed-composer.test.ts +66 -4
  42. package/src/__tests__/conversation-slash-commands.test.ts +36 -8
  43. package/src/__tests__/conversation-slash-queue.test.ts +1 -1
  44. package/src/__tests__/conversation-slash-unknown.test.ts +1 -1
  45. package/src/__tests__/conversation-speed-override.test.ts +1 -1
  46. package/src/__tests__/conversation-surfaces-task-progress.test.ts +220 -0
  47. package/src/__tests__/conversation-workspace-cache-state.test.ts +1 -1
  48. package/src/__tests__/conversation-workspace-injection.test.ts +5 -1
  49. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +5 -1
  50. package/src/__tests__/credential-security-invariants.test.ts +6 -0
  51. package/src/__tests__/cu-unified-flow.test.ts +10 -1
  52. package/src/__tests__/date-context.test.ts +45 -0
  53. package/src/__tests__/dm-backfill.test.ts +64 -0
  54. package/src/__tests__/dm-persistence.test.ts +33 -0
  55. package/src/__tests__/document-find-replace.test.ts +501 -0
  56. package/src/__tests__/external-plugin-loader.test.ts +91 -19
  57. package/src/__tests__/first-greeting.test.ts +23 -2
  58. package/src/__tests__/guardian-action-no-hardcoded-copy.test.ts +0 -1
  59. package/src/__tests__/guardian-dispatch.test.ts +1 -0
  60. package/src/__tests__/headless-browser-navigate.test.ts +172 -0
  61. package/src/__tests__/heartbeat-service.test.ts +24 -164
  62. package/src/__tests__/helpers/channel-test-adapter.ts +0 -2
  63. package/src/__tests__/host-app-control-proxy.test.ts +241 -0
  64. package/src/__tests__/host-bash-proxy.test.ts +6 -0
  65. package/src/__tests__/host-browser-proxy.test.ts +10 -0
  66. package/src/__tests__/host-cu-proxy.test.ts +8 -1
  67. package/src/__tests__/host-file-proxy.test.ts +8 -1
  68. package/src/__tests__/host-proxy-preactivation.test.ts +200 -13
  69. package/src/__tests__/host-transfer-proxy.test.ts +8 -1
  70. package/src/__tests__/identity-routes.test.ts +57 -0
  71. package/src/__tests__/inbound-slack-persistence.test.ts +3 -0
  72. package/src/__tests__/injector-background-turn.test.ts +153 -0
  73. package/src/__tests__/injector-chain.test.ts +7 -0
  74. package/src/__tests__/injector-document-comments.test.ts +378 -0
  75. package/src/__tests__/injector-pkb-v2-silenced.test.ts +4 -25
  76. package/src/__tests__/lifecycle-memory-v2-seed.test.ts +9 -2
  77. package/src/__tests__/list-messages-attachments.test.ts +21 -17
  78. package/src/__tests__/list-messages-hidden-metadata.test.ts +217 -0
  79. package/src/__tests__/list-messages-page-latest.test.ts +130 -14
  80. package/src/__tests__/list-messages-tool-merge.test.ts +17 -16
  81. package/src/__tests__/llm-callsite-catalog.test.ts +25 -0
  82. package/src/__tests__/llm-catalog-parity.test.ts +3 -0
  83. package/src/__tests__/llm-context-normalization.test.ts +0 -2
  84. package/src/__tests__/llm-request-log-agent-loop-exit-reason.test.ts +116 -0
  85. package/src/__tests__/llm-request-log-error-payload.test.ts +138 -0
  86. package/src/__tests__/llm-request-log-source-clickhouse.test.ts +2 -0
  87. package/src/__tests__/llm-resolver.test.ts +340 -3
  88. package/src/__tests__/log-export-routes.test.ts +99 -2
  89. package/src/__tests__/managed-profile-guard.test.ts +10 -0
  90. package/src/__tests__/message-queue-steer.test.ts +114 -0
  91. package/src/__tests__/notification-decision-fallback.test.ts +0 -91
  92. package/src/__tests__/notification-decision-strategy.test.ts +14 -31
  93. package/src/__tests__/notification-deep-link.test.ts +15 -0
  94. package/src/__tests__/notification-guardian-path.test.ts +1 -2
  95. package/src/__tests__/notification-platform-adapter.test.ts +5 -4
  96. package/src/__tests__/notification-telegram-adapter.test.ts +1 -0
  97. package/src/__tests__/notification-vellum-adapter.test.ts +113 -0
  98. package/src/__tests__/openai-provider.test.ts +323 -3
  99. package/src/__tests__/openai-responses-cutover-guard.test.ts +3 -3
  100. package/src/__tests__/openai-responses-provider.test.ts +4 -4
  101. package/src/__tests__/openrouter-provider-only.test.ts +51 -3
  102. package/src/__tests__/openrouter-token-estimation.test.ts +34 -25
  103. package/src/__tests__/outbound-slack-persistence.test.ts +187 -20
  104. package/src/__tests__/pending-interactions-resolved-event.test.ts +190 -0
  105. package/src/__tests__/platform-proxy-context.test.ts +6 -1
  106. package/src/__tests__/platform.test.ts +0 -3
  107. package/src/__tests__/plugin-source-watcher.test.ts +302 -0
  108. package/src/__tests__/plugin-tool-contribution.test.ts +3 -3
  109. package/src/__tests__/plugin-types.test.ts +2 -2
  110. package/src/__tests__/process-message-background-slack.test.ts +1 -51
  111. package/src/__tests__/process-message-display-content.test.ts +21 -16
  112. package/src/__tests__/provider-catalog-visibility.test.ts +16 -0
  113. package/src/__tests__/provider-platform-proxy-integration.test.ts +27 -25
  114. package/src/__tests__/secret-routes-platform-proxy.test.ts +1 -1
  115. package/src/__tests__/server-history-render.test.ts +83 -4
  116. package/src/__tests__/steer-tool-repair.test.ts +249 -0
  117. package/src/__tests__/system-prompt.test.ts +57 -101
  118. package/src/__tests__/terminal-tools.test.ts +11 -1
  119. package/src/__tests__/thinking-block-replay.test.ts +113 -0
  120. package/src/__tests__/thread-backfill.test.ts +370 -22
  121. package/src/__tests__/tool-executor.test.ts +90 -1
  122. package/src/__tests__/tool-result-metadata-plumbing.test.ts +167 -0
  123. package/src/__tests__/twilio-routes.test.ts +1 -1
  124. package/src/__tests__/web-fetch.test.ts +2 -2
  125. package/src/__tests__/workspace-git-service.test.ts +88 -5
  126. package/src/__tests__/workspace-migration-087-memory-router-balanced-profile.test.ts +228 -0
  127. package/src/__tests__/workspace-migration-088-deprecate-background-conversation-override.test.ts +158 -0
  128. package/src/a2a/__tests__/agent-card.test.ts +98 -0
  129. package/src/a2a/__tests__/e2e-a2a-channel.test.ts +597 -0
  130. package/src/a2a/__tests__/protocol-helpers.test.ts +113 -0
  131. package/src/a2a/__tests__/task-store.test.ts +246 -0
  132. package/src/a2a/agent-card.ts +58 -0
  133. package/src/a2a/feature-gate.ts +8 -0
  134. package/src/a2a/protocol-constants.ts +21 -0
  135. package/src/a2a/protocol-errors.ts +50 -0
  136. package/src/a2a/protocol-types.ts +162 -0
  137. package/src/a2a/task-store.ts +168 -0
  138. package/src/agent/attachments.ts +1 -0
  139. package/src/agent/loop.ts +208 -22
  140. package/src/background-wake/next-wake.test.ts +289 -0
  141. package/src/background-wake/next-wake.ts +172 -0
  142. package/src/browser/operations.ts +15 -0
  143. package/src/channels/config.ts +9 -0
  144. package/src/channels/types.ts +14 -0
  145. package/src/cli/commands/__tests__/conversations-slack.test.ts +572 -0
  146. package/src/cli/commands/__tests__/memory-v2.test.ts +9 -12
  147. package/src/cli/{__tests__ → commands/__tests__}/notifications.test.ts +201 -28
  148. package/src/cli/commands/__tests__/schedules.test.ts +469 -0
  149. package/src/cli/commands/conversations.ts +128 -1
  150. package/src/cli/commands/inference-providers.ts +147 -1
  151. package/src/cli/commands/memory-v2.ts +308 -0
  152. package/src/cli/commands/notifications.ts +89 -37
  153. package/src/cli/commands/plugins.ts +67 -0
  154. package/src/cli/commands/schedules.ts +297 -5
  155. package/src/cli/lib/__tests__/search-plugins.test.ts +261 -0
  156. package/src/cli/lib/install-from-github.ts +8 -9
  157. package/src/cli/lib/search-plugins.ts +163 -0
  158. package/src/cli/program.ts +14 -0
  159. package/src/cli/utils/conversation-id.ts +17 -5
  160. package/src/config/assistant-feature-flags.ts +24 -54
  161. package/src/config/bundled-skills/app-builder/SKILL.md +117 -1
  162. package/src/config/bundled-skills/document-editor/SKILL.md +115 -0
  163. package/src/config/bundled-skills/document-editor/TOOLS.json +240 -0
  164. package/src/config/bundled-skills/document-editor/tools/comment-list.ts +12 -0
  165. package/src/config/bundled-skills/document-editor/tools/comment-reply.ts +12 -0
  166. package/src/config/bundled-skills/document-editor/tools/comment-resolve.ts +12 -0
  167. package/src/config/bundled-skills/document-editor/tools/document-find.ts +12 -0
  168. package/src/config/bundled-skills/document-editor/tools/document-replace-text.ts +12 -0
  169. package/src/config/bundled-skills/media-processing/SKILL.md +8 -0
  170. package/src/config/bundled-skills/phone-calls/SKILL.md +1 -1
  171. package/src/config/bundled-skills/schedule/SKILL.md +8 -0
  172. package/src/config/bundled-tool-registry.ts +22 -12
  173. package/src/config/call-site-defaults.ts +124 -0
  174. package/src/config/feature-flag-registry.json +111 -23
  175. package/src/config/llm-resolver.ts +66 -1
  176. package/src/config/schema.ts +2 -0
  177. package/src/config/schemas/__tests__/memory-v2.test.ts +7 -3
  178. package/src/config/schemas/call-site-catalog.ts +21 -0
  179. package/src/config/schemas/channels.ts +9 -0
  180. package/src/config/schemas/conversations.ts +10 -0
  181. package/src/config/schemas/heartbeat.ts +14 -0
  182. package/src/config/schemas/llm.ts +4 -3
  183. package/src/config/schemas/memory-retrospective.ts +1 -1
  184. package/src/config/schemas/memory-v2.ts +51 -4
  185. package/src/config/schemas/memory.ts +3 -1
  186. package/src/config/seed-inference-profiles.ts +99 -29
  187. package/src/context/compactor.ts +80 -13
  188. package/src/context/token-estimator.ts +72 -31
  189. package/src/context/window-manager.ts +25 -0
  190. package/src/credential-health/credential-health-service.ts +34 -19
  191. package/src/daemon/__tests__/conversation-lifecycle-auto-analyze.test.ts +3 -22
  192. package/src/daemon/__tests__/conversation-tool-setup.test.ts +66 -6
  193. package/src/daemon/__tests__/native-web-search-metadata.test.ts +357 -0
  194. package/src/daemon/__tests__/web-search-status-text.test.ts +287 -0
  195. package/src/daemon/conversation-agent-loop-handlers.ts +231 -23
  196. package/src/daemon/conversation-agent-loop.ts +252 -56
  197. package/src/daemon/conversation-lifecycle.ts +142 -116
  198. package/src/daemon/conversation-messaging.ts +3 -0
  199. package/src/daemon/conversation-process.ts +273 -0
  200. package/src/daemon/conversation-queue-manager.ts +14 -0
  201. package/src/daemon/conversation-runtime-assembly.ts +144 -75
  202. package/src/daemon/conversation-slash.ts +37 -5
  203. package/src/daemon/conversation-surfaces.ts +45 -2
  204. package/src/daemon/conversation-tool-setup.ts +7 -0
  205. package/src/daemon/conversation.ts +42 -12
  206. package/src/daemon/date-context.ts +40 -0
  207. package/src/daemon/first-greeting.ts +10 -0
  208. package/src/daemon/guardian-action-generators.ts +1 -125
  209. package/src/daemon/handlers/__tests__/config-a2a-accept.test.ts +498 -0
  210. package/src/daemon/handlers/__tests__/config-a2a-complete.test.ts +248 -0
  211. package/src/daemon/handlers/__tests__/config-a2a-invite.test.ts +154 -0
  212. package/src/daemon/handlers/__tests__/config-a2a-redeem.test.ts +133 -0
  213. package/src/daemon/handlers/__tests__/config-a2a.test.ts +95 -0
  214. package/src/daemon/handlers/config-a2a.ts +449 -0
  215. package/src/daemon/handlers/config-model.test.ts +1 -0
  216. package/src/daemon/handlers/conversations.ts +80 -0
  217. package/src/daemon/handlers/shared.ts +92 -29
  218. package/src/daemon/host-app-control-proxy.ts +69 -18
  219. package/src/daemon/host-bash-proxy.ts +1 -1
  220. package/src/daemon/host-cu-proxy.ts +1 -1
  221. package/src/daemon/host-file-proxy.ts +1 -1
  222. package/src/daemon/host-proxy-preactivation.ts +85 -18
  223. package/src/daemon/host-transfer-proxy.ts +1 -1
  224. package/src/daemon/lifecycle.ts +67 -65
  225. package/src/daemon/memory-v2-startup.ts +49 -13
  226. package/src/daemon/message-protocol.ts +4 -0
  227. package/src/daemon/message-types/conversations.ts +8 -0
  228. package/src/daemon/message-types/document-comments.ts +50 -0
  229. package/src/daemon/message-types/messages.ts +68 -1
  230. package/src/daemon/message-types/notifications.ts +21 -0
  231. package/src/daemon/message-types/surfaces.ts +3 -1
  232. package/src/daemon/message-types/web-activity.ts +57 -0
  233. package/src/daemon/pkb-reminder-builder.test.ts +10 -53
  234. package/src/daemon/pkb-reminder-builder.ts +4 -19
  235. package/src/daemon/plugin-source-watcher.ts +135 -3
  236. package/src/daemon/process-message.ts +72 -12
  237. package/src/daemon/query-complexity-router.ts +75 -0
  238. package/src/daemon/skill-memory-refresh.ts +5 -1
  239. package/src/daemon/trust-context.ts +6 -0
  240. package/src/daemon/wake-target-adapter.ts +2 -0
  241. package/src/documents/document-comments-store.test.ts +338 -0
  242. package/src/documents/document-comments-store.ts +237 -0
  243. package/src/documents/document-store.ts +202 -0
  244. package/src/export/__tests__/transcript-formatter.test.ts +121 -0
  245. package/src/export/transcript-formatter.ts +54 -20
  246. package/src/heartbeat/__tests__/heartbeat-service.test.ts +44 -1
  247. package/src/heartbeat/heartbeat-service.ts +35 -191
  248. package/src/home/__tests__/feed-types.test.ts +40 -0
  249. package/src/home/__tests__/suggested-prompts.test.ts +33 -2
  250. package/src/home/feed-types.ts +20 -3
  251. package/src/home/home-content-refresh.ts +52 -0
  252. package/src/home/home-greeting-cache.ts +69 -0
  253. package/src/home/home-greeting.ts +94 -0
  254. package/src/home/suggested-prompts.ts +177 -9
  255. package/src/ipc/cli-client.ts +147 -45
  256. package/src/memory/__tests__/conversation-queries.test.ts +220 -0
  257. package/src/memory/__tests__/jobs-worker-v2-schedule.test.ts +135 -2
  258. package/src/memory/__tests__/memory-retrospective-enqueue.test.ts +2 -50
  259. package/src/memory/__tests__/memory-retrospective-job.test.ts +407 -10
  260. package/src/memory/conversation-crud.ts +133 -43
  261. package/src/memory/conversation-queries.ts +87 -1
  262. package/src/memory/conversation-title-service.ts +26 -4
  263. package/src/memory/db-init.ts +22 -0
  264. package/src/memory/delivery-crud.ts +41 -0
  265. package/src/memory/delivery-status.ts +141 -15
  266. package/src/memory/external-conversation-store.ts +32 -1
  267. package/src/memory/graph/__tests__/conversation-graph-memory-v2-routing.test.ts +84 -3
  268. package/src/memory/graph/conversation-graph-memory.ts +18 -6
  269. package/src/memory/graph/tools.ts +6 -37
  270. package/src/memory/invite-store.ts +53 -0
  271. package/src/memory/jobs-worker.ts +21 -1
  272. package/src/memory/llm-request-log-source-clickhouse.ts +7 -2
  273. package/src/memory/llm-request-log-store.ts +92 -1
  274. package/src/memory/memory-retrospective-constants.ts +28 -0
  275. package/src/memory/memory-retrospective-enqueue.ts +4 -22
  276. package/src/memory/memory-retrospective-job.ts +438 -21
  277. package/src/memory/memory-retrospective-startup-cleanup.ts +3 -3
  278. package/src/memory/memory-v2-activation-log-store.ts +26 -8
  279. package/src/memory/migrations/100-core-tables.ts +1 -0
  280. package/src/memory/migrations/109-external-conversation-bindings.ts +1 -0
  281. package/src/memory/migrations/250-provider-connection-base-url-and-models.ts +28 -0
  282. package/src/memory/migrations/251-a2a-tasks.ts +49 -0
  283. package/src/memory/migrations/252-llm-request-log-agent-loop-exit-reason.ts +32 -0
  284. package/src/memory/migrations/253-conversation-last-notified-profile.ts +15 -0
  285. package/src/memory/migrations/253-document-comments.ts +47 -0
  286. package/src/memory/migrations/254-external-conversation-binding-chat-name.ts +43 -0
  287. package/src/memory/migrations/255-channel-inbound-delivery-attempts.ts +24 -0
  288. package/src/memory/migrations/256-memory-v2-injection-events.ts +113 -0
  289. package/src/memory/migrations/257-strip-base-url-non-openai-compatible.ts +22 -0
  290. package/src/memory/migrations/258-onboarding-events-prior-assistants.ts +13 -0
  291. package/src/memory/migrations/259-conversation-cleaned-at.ts +33 -0
  292. package/src/memory/migrations/index.ts +20 -0
  293. package/src/memory/migrations/registry.ts +33 -0
  294. package/src/memory/onboarding-events-store.ts +7 -0
  295. package/src/memory/schema/a2a.ts +15 -0
  296. package/src/memory/schema/calls.ts +1 -0
  297. package/src/memory/schema/conversations.ts +3 -0
  298. package/src/memory/schema/index.ts +1 -0
  299. package/src/memory/schema/inference.ts +2 -0
  300. package/src/memory/schema/infrastructure.ts +2 -0
  301. package/src/memory/v2/__tests__/activation-store.test.ts +25 -23
  302. package/src/memory/v2/__tests__/cli-command-store.test.ts +404 -0
  303. package/src/memory/v2/__tests__/frontmatter-sweep.test.ts +25 -4
  304. package/src/memory/v2/__tests__/injection-events.test.ts +318 -0
  305. package/src/memory/v2/__tests__/injection.test.ts +221 -17
  306. package/src/memory/v2/__tests__/page-index.test.ts +365 -1
  307. package/src/memory/v2/__tests__/router.test.ts +489 -1
  308. package/src/memory/v2/__tests__/static-context.test.ts +12 -1
  309. package/src/memory/v2/activation-store.ts +14 -16
  310. package/src/memory/v2/cli-command-content.ts +19 -0
  311. package/src/memory/v2/cli-command-store.ts +304 -0
  312. package/src/memory/v2/consolidation-job.ts +14 -0
  313. package/src/memory/v2/frontmatter-sweep.ts +7 -1
  314. package/src/memory/v2/injection-events.ts +101 -0
  315. package/src/memory/v2/injection.ts +69 -29
  316. package/src/memory/v2/page-index.ts +246 -19
  317. package/src/memory/v2/page-store.ts +18 -0
  318. package/src/memory/v2/router.ts +209 -55
  319. package/src/memory/v2/static-context.ts +4 -4
  320. package/src/memory/v2/types.ts +23 -0
  321. package/src/messaging/providers/a2a/__tests__/deliver.test.ts +274 -0
  322. package/src/messaging/providers/a2a/deliver.ts +156 -0
  323. package/src/messaging/providers/gmail/client.ts +9 -2
  324. package/src/messaging/providers/index.ts +18 -3
  325. package/src/messaging/providers/slack/__tests__/adapter-mention-rendering.test.ts +329 -3
  326. package/src/messaging/providers/slack/__tests__/adapter-token-routing.test.ts +34 -1
  327. package/src/messaging/providers/slack/adapter.ts +178 -25
  328. package/src/messaging/providers/slack/api.test.ts +54 -0
  329. package/src/messaging/providers/slack/api.ts +119 -3
  330. package/src/messaging/providers/slack/client.ts +12 -0
  331. package/src/messaging/providers/slack/deep-link.ts +20 -1
  332. package/src/messaging/providers/slack/message-metadata.test.ts +48 -0
  333. package/src/messaging/providers/slack/message-metadata.ts +156 -0
  334. package/src/messaging/providers/slack/render-transcript.test.ts +107 -75
  335. package/src/messaging/providers/slack/render-transcript.ts +176 -49
  336. package/src/messaging/providers/slack/send.test.ts +77 -0
  337. package/src/messaging/providers/slack/send.ts +8 -2
  338. package/src/messaging/providers/slack/types.ts +14 -0
  339. package/src/notifications/__tests__/broadcaster.test.ts +203 -0
  340. package/src/notifications/__tests__/decision-engine.test.ts +283 -0
  341. package/src/notifications/__tests__/deterministic-checks.test.ts +286 -0
  342. package/src/notifications/__tests__/emit-signal-home-feed.test.ts +5 -1
  343. package/src/notifications/__tests__/home-feed-side-effect.test.ts +521 -36
  344. package/src/notifications/adapters/macos.ts +12 -2
  345. package/src/notifications/broadcaster.ts +29 -4
  346. package/src/notifications/conversation-seed-composer.ts +14 -2
  347. package/src/notifications/copy-composer.ts +17 -64
  348. package/src/notifications/decision-engine.ts +111 -44
  349. package/src/notifications/deferred-emit.ts +135 -0
  350. package/src/notifications/deterministic-checks.ts +96 -0
  351. package/src/notifications/emit-signal.ts +10 -1
  352. package/src/notifications/home-feed-side-effect.ts +136 -27
  353. package/src/notifications/signal.ts +0 -4
  354. package/src/notifications/types.ts +8 -0
  355. package/src/oauth/connect-orchestrator.ts +3 -0
  356. package/src/oauth/credential-token-resolver.ts +2 -0
  357. package/src/oauth/manual-token-connection.ts +19 -0
  358. package/src/oauth/oauth-store.ts +12 -0
  359. package/src/oauth/platform-connection.test.ts +43 -3
  360. package/src/oauth/platform-connection.ts +13 -4
  361. package/src/oauth/seed-providers.ts +22 -0
  362. package/src/permissions/prompter.ts +5 -2
  363. package/src/permissions/secret-prompter.ts +4 -1
  364. package/src/plugins/defaults/injectors.ts +118 -26
  365. package/src/plugins/external-plugin-loader.ts +82 -10
  366. package/src/plugins/types.ts +16 -7
  367. package/src/prompts/__tests__/system-prompt.test.ts +44 -45
  368. package/src/prompts/__tests__/task-progress-hint-section.test.ts +4 -8
  369. package/src/prompts/normalize-onboarding.ts +40 -0
  370. package/src/prompts/sections.ts +32 -14
  371. package/src/prompts/system-prompt.ts +105 -76
  372. package/src/prompts/template-detection.ts +37 -0
  373. package/src/prompts/templates/BOOTSTRAP-CONTENT-AUTOMATION.md +141 -0
  374. package/src/prompts/templates/BOOTSTRAP.md +13 -5
  375. package/src/prompts/templates/VOICE.md +3 -0
  376. package/src/prompts/templates/system-sections.ts +51 -10
  377. package/src/providers/__tests__/inference.test.ts +2 -0
  378. package/src/providers/anthropic/client.ts +132 -5
  379. package/src/providers/call-site-routing.ts +24 -6
  380. package/src/providers/connection-resolution.ts +63 -13
  381. package/src/providers/fireworks/client.ts +20 -2
  382. package/src/providers/inference/__tests__/adapter-factory-openai-compatible.test.ts +74 -0
  383. package/src/providers/inference/__tests__/base-url-route-validation.test.ts +342 -0
  384. package/src/providers/inference/__tests__/base-url-security.test.ts +189 -0
  385. package/src/providers/inference/__tests__/codex-token-refresh.test.ts +254 -0
  386. package/src/providers/inference/__tests__/connections-openai-compatible.test.ts +175 -0
  387. package/src/providers/inference/__tests__/connections-status-label.test.ts +15 -0
  388. package/src/providers/inference/adapter-factory.ts +24 -21
  389. package/src/providers/inference/auth.ts +15 -3
  390. package/src/providers/inference/backfill.ts +14 -1
  391. package/src/providers/inference/codex-token-refresh.ts +128 -0
  392. package/src/providers/inference/connections.ts +85 -5
  393. package/src/providers/inference/resolve-auth.ts +50 -5
  394. package/src/providers/model-catalog.ts +244 -242
  395. package/src/providers/model-intents.ts +3 -3
  396. package/src/providers/openai/__tests__/chat-completions-provider-reasoning.test.ts +235 -0
  397. package/src/providers/openai/chat-completions-provider.ts +215 -25
  398. package/src/providers/openai/responses-provider.ts +9 -3
  399. package/src/providers/openrouter/client.ts +46 -4
  400. package/src/providers/platform-proxy/constants.ts +3 -4
  401. package/src/providers/provider-catalog-visibility.ts +3 -1
  402. package/src/providers/provider-send-message.ts +27 -12
  403. package/src/providers/registry.ts +30 -1
  404. package/src/providers/types.ts +25 -0
  405. package/src/runtime/__tests__/agent-wake.test.ts +214 -0
  406. package/src/runtime/__tests__/background-job-runner.test.ts +128 -0
  407. package/src/runtime/agent-wake.ts +212 -57
  408. package/src/runtime/auth/route-policy.ts +20 -3
  409. package/src/runtime/background-job-runner.ts +26 -0
  410. package/src/runtime/channel-reply-delivery.ts +182 -47
  411. package/src/runtime/channel-retry-sweep.ts +141 -16
  412. package/src/runtime/http-server.ts +7 -16
  413. package/src/runtime/http-types.ts +7 -51
  414. package/src/runtime/pending-interactions.ts +51 -8
  415. package/src/runtime/routes/__tests__/consolidation-routes.test.ts +258 -0
  416. package/src/runtime/routes/__tests__/content-source-routes.test.ts +162 -0
  417. package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +121 -5
  418. package/src/runtime/routes/__tests__/inference-provider-connection-routes.test.ts +275 -44
  419. package/src/runtime/routes/__tests__/llm-call-sites-routes.test.ts +12 -0
  420. package/src/runtime/routes/__tests__/memory-v2-routes.test.ts +14 -0
  421. package/src/runtime/routes/__tests__/memory-v2-simulate-route.test.ts +271 -0
  422. package/src/runtime/routes/__tests__/sanity-routes.test.ts +280 -0
  423. package/src/runtime/routes/__tests__/slack-channel-routes.test.ts +266 -0
  424. package/src/runtime/routes/approval-routes.ts +4 -1
  425. package/src/runtime/routes/channel-availability-routes.ts +5 -0
  426. package/src/runtime/routes/chatgpt-subscription-auth-routes.ts +246 -0
  427. package/src/runtime/routes/consolidation-routes.ts +100 -0
  428. package/src/runtime/routes/content-source-routes.ts +78 -0
  429. package/src/runtime/routes/conversation-cli-routes.ts +146 -1
  430. package/src/runtime/routes/conversation-query-routes.ts +130 -12
  431. package/src/runtime/routes/conversation-routes.ts +288 -76
  432. package/src/runtime/routes/document-comments-routes.ts +287 -0
  433. package/src/runtime/routes/documents-routes.ts +33 -0
  434. package/src/runtime/routes/home-feed-routes.ts +6 -3
  435. package/src/runtime/routes/host-app-control-routes.ts +1 -1
  436. package/src/runtime/routes/host-browser-routes.ts +8 -1
  437. package/src/runtime/routes/identity-routes.ts +21 -0
  438. package/src/runtime/routes/inbound-message-handler.ts +288 -58
  439. package/src/runtime/routes/inbound-stages/background-dispatch.test.ts +365 -6
  440. package/src/runtime/routes/inbound-stages/background-dispatch.ts +283 -82
  441. package/src/runtime/routes/index.ts +14 -4
  442. package/src/runtime/routes/inference-provider-connection-routes.ts +192 -3
  443. package/src/runtime/routes/integrations/a2a.ts +294 -0
  444. package/src/runtime/routes/llm-call-sites-routes.ts +11 -1
  445. package/src/runtime/routes/log-export-routes.ts +39 -0
  446. package/src/runtime/routes/memory-v2-routes.ts +217 -0
  447. package/src/runtime/routes/notification-routes.ts +19 -2
  448. package/src/runtime/routes/question-routes.ts +4 -1
  449. package/src/runtime/routes/sanity-routes.ts +159 -0
  450. package/src/runtime/routes/slack-channel-routes.ts +187 -0
  451. package/src/runtime/routes/subagents-routes.ts +41 -0
  452. package/src/runtime/services/conversation-serializer.ts +30 -4
  453. package/src/schedule/integration-status.ts +3 -1
  454. package/src/security/__tests__/oauth2-device-code.test.ts +479 -0
  455. package/src/security/oauth2-device-code.ts +307 -0
  456. package/src/security/oauth2.ts +26 -9
  457. package/src/security/secure-keys.ts +5 -0
  458. package/src/skills/catalog-install.ts +6 -2
  459. package/src/subagent/manager.ts +2 -0
  460. package/src/tools/browser/__tests__/pinned-tabs.test.ts +80 -0
  461. package/src/tools/browser/browser-execution.ts +93 -0
  462. package/src/tools/browser/cdp-client/__tests__/factory.test.ts +28 -0
  463. package/src/tools/browser/cdp-client/__tests__/types.test.ts +1 -0
  464. package/src/tools/browser/cdp-client/cdp-inspect-client.ts +10 -0
  465. package/src/tools/browser/cdp-client/extension-cdp-client.ts +15 -1
  466. package/src/tools/browser/cdp-client/factory.ts +87 -3
  467. package/src/tools/browser/cdp-client/local-cdp-client.ts +9 -0
  468. package/src/tools/browser/cdp-client/types.ts +36 -0
  469. package/src/tools/browser/pinned-tabs.ts +90 -0
  470. package/src/tools/document/document-comment-tool.test.ts +379 -0
  471. package/src/tools/document/document-comment-tool.ts +156 -0
  472. package/src/tools/document/document-tool.ts +128 -2
  473. package/src/tools/memory/register.ts +1 -9
  474. package/src/tools/network/__tests__/web-fetch-metadata.test.ts +229 -0
  475. package/src/tools/network/__tests__/web-search-metadata.test.ts +346 -0
  476. package/src/tools/network/domain-normalize.ts +17 -0
  477. package/src/tools/network/web-fetch.ts +213 -64
  478. package/src/tools/network/web-search.ts +191 -66
  479. package/src/tools/registry.ts +2 -2
  480. package/src/tools/terminal/safe-env.ts +3 -2
  481. package/src/tools/tool-approval-handler.ts +19 -12
  482. package/src/tools/types.ts +41 -2
  483. package/src/tools/ui-surface/definitions.ts +3 -1
  484. package/src/types/onboarding-context.ts +4 -0
  485. package/src/util/__tests__/favicon.test.ts +84 -0
  486. package/src/util/favicon.ts +40 -0
  487. package/src/util/platform.ts +0 -5
  488. package/src/workspace/git-service.ts +75 -4
  489. package/src/workspace/migrations/087-memory-router-balanced-profile.ts +91 -0
  490. package/src/workspace/migrations/088-deprecate-background-conversation-override.ts +103 -0
  491. package/src/workspace/migrations/registry.ts +4 -0
  492. package/src/__tests__/guardian-action-conversation-turn.test.ts +0 -441
  493. package/src/config/bundled-skills/document/SKILL.md +0 -54
  494. package/src/config/bundled-skills/document/TOOLS.json +0 -106
  495. package/src/daemon/seed-files.ts +0 -18
  496. package/src/memory/graph/__tests__/remember-description.test.ts +0 -55
  497. package/src/runtime/guardian-action-conversation-turn.ts +0 -99
  498. package/src/runtime/routes/interface-routes.ts +0 -43
  499. /package/src/config/bundled-skills/{document → document-editor}/tools/document-create.ts +0 -0
  500. /package/src/config/bundled-skills/{document → document-editor}/tools/document-delete.ts +0 -0
  501. /package/src/config/bundled-skills/{document → document-editor}/tools/document-list.ts +0 -0
  502. /package/src/config/bundled-skills/{document → document-editor}/tools/document-read.ts +0 -0
  503. /package/src/config/bundled-skills/{document → document-editor}/tools/document-update.ts +0 -0
@@ -22,24 +22,33 @@ mock.module("../util/logger.js", () => ({
22
22
  }),
23
23
  }));
24
24
 
25
- mock.module("../config/loader.js", () => ({
26
- getConfig: () => ({
27
- skills: {
28
- entries: {},
29
- load: { extraDirs: [], watch: true, watchDebounceMs: 250 },
30
- install: { nodeManager: "npm" },
31
- allowBundled: null,
32
- remoteProviders: {
33
- skillssh: { enabled: true },
34
- clawhub: { enabled: true },
35
- },
36
- remotePolicy: {
37
- blockSuspicious: true,
38
- blockMalware: true,
39
- maxSkillsShRisk: "medium",
40
- },
25
+ type TestConfig = {
26
+ ui: { userTimezone?: string; detectedTimezone?: string };
27
+ skills: Record<string, unknown>;
28
+ };
29
+
30
+ const baseConfig: TestConfig = {
31
+ ui: {},
32
+ skills: {
33
+ entries: {},
34
+ load: { extraDirs: [], watch: true, watchDebounceMs: 250 },
35
+ install: { nodeManager: "npm" },
36
+ allowBundled: null,
37
+ remoteProviders: {
38
+ skillssh: { enabled: true },
39
+ clawhub: { enabled: true },
41
40
  },
42
- }),
41
+ remotePolicy: {
42
+ blockSuspicious: true,
43
+ blockMalware: true,
44
+ maxSkillsShRisk: "medium",
45
+ },
46
+ },
47
+ };
48
+ let currentConfig: TestConfig = structuredClone(baseConfig);
49
+
50
+ mock.module("../config/loader.js", () => ({
51
+ getConfig: () => currentConfig,
43
52
  loadConfig: () => ({}),
44
53
  }));
45
54
 
@@ -47,12 +56,21 @@ mock.module("../config/loader.js", () => ({
47
56
  // its arguments per test invocation so each case can assert on the metadata
48
57
  // that was actually persisted.
49
58
  interface AddMessageCall {
59
+ id: string;
50
60
  conversationId: string;
51
61
  role: string;
52
62
  content: string;
53
63
  metadata?: Record<string, unknown>;
54
64
  }
55
65
  const addMessageCalls: AddMessageCall[] = [];
66
+ const persistedRows: Array<{
67
+ id: string;
68
+ conversationId: string;
69
+ role: string;
70
+ content: string;
71
+ createdAt: number;
72
+ metadata: string | null;
73
+ }> = [];
56
74
  mock.module("../memory/conversation-crud.js", () => ({
57
75
  addMessage: (
58
76
  conversationId: string,
@@ -60,11 +78,35 @@ mock.module("../memory/conversation-crud.js", () => ({
60
78
  content: string,
61
79
  metadata?: Record<string, unknown>,
62
80
  ) => {
63
- addMessageCalls.push({ conversationId, role, content, metadata });
64
- return { id: `mock-msg-${addMessageCalls.length}` };
81
+ const id = `mock-msg-${addMessageCalls.length + 1}`;
82
+ addMessageCalls.push({ id, conversationId, role, content, metadata });
83
+ persistedRows.push({
84
+ id,
85
+ conversationId,
86
+ role,
87
+ content,
88
+ createdAt: Date.now(),
89
+ metadata: metadata ? JSON.stringify(metadata) : null,
90
+ });
91
+ return { id };
65
92
  },
66
93
  getConversation: () => null,
67
- getMessageById: () => null,
94
+ getMessageById: (messageId: string) =>
95
+ persistedRows.find((row) => row.id === messageId) ?? null,
96
+ getMessages: (conversationId: string) =>
97
+ persistedRows.filter((row) => row.conversationId === conversationId),
98
+ updateMessageMetadata: (
99
+ messageId: string,
100
+ updates: Record<string, unknown>,
101
+ ) => {
102
+ const row = persistedRows.find((candidate) => candidate.id === messageId);
103
+ if (!row) return;
104
+ const existing =
105
+ row.metadata && typeof row.metadata === "string"
106
+ ? (JSON.parse(row.metadata) as Record<string, unknown>)
107
+ : {};
108
+ row.metadata = JSON.stringify({ ...existing, ...updates });
109
+ },
68
110
  updateMessageContent: () => {},
69
111
  // The handler treats provenance as a flat spread; returning {} keeps the
70
112
  // metadata snapshot focused on the fields under test.
@@ -84,6 +126,18 @@ mock.module("../memory/conversation-disk-view.js", () => ({
84
126
  syncMessageToDisk: () => {},
85
127
  }));
86
128
 
129
+ let nextDeliveryTs: string | null = null;
130
+ mock.module("../runtime/gateway-client.js", () => ({
131
+ deliverChannelReply: async () => ({
132
+ ok: true,
133
+ ...(nextDeliveryTs ? { ts: nextDeliveryTs } : {}),
134
+ }),
135
+ }));
136
+
137
+ mock.module("../memory/attachments-store.js", () => ({
138
+ getAttachmentMetadataForMessage: () => [],
139
+ }));
140
+
87
141
  // ── Imports (after mocks) ──────────────────────────────────────────────────
88
142
 
89
143
  import type { AgentEvent } from "../agent/loop.js";
@@ -98,6 +152,7 @@ import {
98
152
  import type { ServerMessage } from "../daemon/message-protocol.js";
99
153
  import { clearThreadTs, setThreadTs } from "../memory/slack-thread-store.js";
100
154
  import { readSlackMetadata } from "../messaging/providers/slack/message-metadata.js";
155
+ import { deliverReplyViaCallback } from "../runtime/channel-reply-delivery.js";
101
156
 
102
157
  // ── Helpers ────────────────────────────────────────────────────────────────
103
158
 
@@ -106,6 +161,8 @@ function makeDeps(
106
161
  overrides: {
107
162
  assistantMessageChannel?: "slack" | "vellum" | "telegram";
108
163
  requesterChatId?: string;
164
+ requesterTimezoneLabel?: string;
165
+ clientTimezone?: string;
109
166
  } = {},
110
167
  ): EventHandlerDeps {
111
168
  const assistantMessageChannel = overrides.assistantMessageChannel ?? "slack";
@@ -119,7 +176,9 @@ function makeDeps(
119
176
  sourceChannel: assistantMessageChannel,
120
177
  trustClass: "guardian",
121
178
  requesterChatId: overrides.requesterChatId,
179
+ requesterTimezoneLabel: overrides.requesterTimezoneLabel,
122
180
  },
181
+ clientTimezone: overrides.clientTimezone,
123
182
  } as unknown as EventHandlerDeps["ctx"],
124
183
  onEvent: (_msg: ServerMessage) => {},
125
184
  reqId: "test-req-id",
@@ -172,12 +231,17 @@ describe("outbound assistant Slack metadata persistence", () => {
172
231
 
173
232
  beforeEach(() => {
174
233
  addMessageCalls.length = 0;
234
+ persistedRows.length = 0;
235
+ currentConfig = structuredClone(baseConfig);
236
+ nextDeliveryTs = null;
175
237
  state = createEventHandlerState();
176
238
  state.turnStartedAt = 1_700_000_000_000;
177
239
  });
178
240
 
179
241
  afterEach(() => {
180
242
  addMessageCalls.length = 0;
243
+ persistedRows.length = 0;
244
+ nextDeliveryTs = null;
181
245
  });
182
246
 
183
247
  test("stamps slackMeta with threadTs when the conversation has a Slack thread mapping", async () => {
@@ -217,6 +281,109 @@ describe("outbound assistant Slack metadata persistence", () => {
217
281
  expect(readSlackMetadata(slackMetaRaw as string)).toBeNull();
218
282
  });
219
283
 
284
+ test("stamps assistant Slack rows with effective timestamp timezone and no speaker suffix", async () => {
285
+ currentConfig = {
286
+ ...structuredClone(baseConfig),
287
+ ui: { userTimezone: "America/Denver" },
288
+ };
289
+ state.turnStartedAt = Date.parse("2026-03-05T03:38:00Z");
290
+ const conversationId = "conv-slack-timezone";
291
+ const channelId = "C999TIMEZONE";
292
+
293
+ const deps = makeDeps(conversationId, {
294
+ assistantMessageChannel: "slack",
295
+ requesterChatId: channelId,
296
+ requesterTimezoneLabel: "ET",
297
+ clientTimezone: "America/Los_Angeles",
298
+ });
299
+ await handleMessageComplete(
300
+ state,
301
+ deps,
302
+ makeMessageCompleteEvent("timezone-aware reply"),
303
+ );
304
+
305
+ const persisted = lastAssistantPersisted();
306
+ const slackMetaRaw = persisted.metadata?.slackMeta;
307
+ expect(typeof slackMetaRaw).toBe("string");
308
+
309
+ const slackMeta = JSON.parse(slackMetaRaw as string) as Record<
310
+ string,
311
+ unknown
312
+ >;
313
+ expect(slackMeta.timestampTimezone).toBe("America/Denver");
314
+ expect(slackMeta.timestampTimezoneLabel).toBe("MT");
315
+ expect(slackMeta.speakerTimezoneLabel).toBeUndefined();
316
+ });
317
+
318
+ test("falls back to the turn client timezone when no configured user timezone is set", async () => {
319
+ const conversationId = "conv-slack-client-timezone";
320
+ const channelId = "C999CLIENTTZ";
321
+
322
+ const deps = makeDeps(conversationId, {
323
+ assistantMessageChannel: "slack",
324
+ requesterChatId: channelId,
325
+ clientTimezone: "America/Los_Angeles",
326
+ });
327
+ await handleMessageComplete(
328
+ state,
329
+ deps,
330
+ makeMessageCompleteEvent("client timezone reply"),
331
+ );
332
+
333
+ const persisted = lastAssistantPersisted();
334
+ const slackMeta = JSON.parse(
335
+ persisted.metadata?.slackMeta as string,
336
+ ) as Record<string, unknown>;
337
+ expect(slackMeta.timestampTimezone).toBe("America/Los_Angeles");
338
+ expect(slackMeta.timestampTimezoneLabel).toBe("PT");
339
+ });
340
+
341
+ test("post-send reconciliation preserves assistant Slack timezone metadata", async () => {
342
+ currentConfig = {
343
+ ...structuredClone(baseConfig),
344
+ ui: { userTimezone: "America/Denver" },
345
+ };
346
+ const conversationId = "conv-slack-reconcile-timezone";
347
+ const channelId = "C999RECONCILE";
348
+
349
+ const deps = makeDeps(conversationId, {
350
+ assistantMessageChannel: "slack",
351
+ requesterChatId: channelId,
352
+ requesterTimezoneLabel: "ET",
353
+ });
354
+ await handleMessageComplete(
355
+ state,
356
+ deps,
357
+ makeMessageCompleteEvent("delivery reconciliation reply"),
358
+ );
359
+
360
+ const persisted = lastAssistantPersisted();
361
+ const beforeRaw = persisted.metadata?.slackMeta;
362
+ expect(typeof beforeRaw).toBe("string");
363
+ expect(readSlackMetadata(beforeRaw as string)).toBeNull();
364
+
365
+ nextDeliveryTs = "1772678280.000200";
366
+ await deliverReplyViaCallback(
367
+ conversationId,
368
+ channelId,
369
+ "http://gateway/deliver/slack",
370
+ "assistant-1",
371
+ { messageId: persisted.id },
372
+ );
373
+
374
+ const row = persistedRows.find(
375
+ (candidate) => candidate.id === persisted.id,
376
+ );
377
+ expect(typeof row?.metadata).toBe("string");
378
+ const envelope = JSON.parse(row!.metadata!) as Record<string, unknown>;
379
+ const reconciled = readSlackMetadata(envelope.slackMeta as string);
380
+ expect(reconciled).not.toBeNull();
381
+ expect(reconciled!.channelTs).toBe("1772678280.000200");
382
+ expect(reconciled!.timestampTimezone).toBe("America/Denver");
383
+ expect(reconciled!.timestampTimezoneLabel).toBe("MT");
384
+ expect(reconciled!.speakerTimezoneLabel).toBeUndefined();
385
+ });
386
+
220
387
  test("stamps slackMeta WITHOUT threadTs for top-level Slack replies", async () => {
221
388
  const conversationId = "conv-slack-toplevel";
222
389
  const channelId = "C456NOTHREAD";
@@ -0,0 +1,190 @@
1
+ /**
2
+ * Verifies that every resolution path through
3
+ * `runtime/pending-interactions.ts` publishes an `interaction_resolved`
4
+ * envelope on the event hub with the right state.
5
+ *
6
+ * Each test registers an interaction directly and calls `resolve()` or
7
+ * `removeByConversation()` so we exercise the tracker in isolation
8
+ * without spinning up a Conversation, prompter, or proxy.
9
+ */
10
+
11
+ import { afterEach, beforeEach, describe, expect, mock, test } from "bun:test";
12
+
13
+ import type { ServerMessage } from "../daemon/message-protocol.js";
14
+
15
+ // Capture every broadcast emitted by the tracker. The real hub is replaced
16
+ // with a thin recorder so we can assert payloads deterministically.
17
+ const publishedMessages: ServerMessage[] = [];
18
+
19
+ mock.module("../runtime/assistant-event-hub.js", () => ({
20
+ broadcastMessage: (msg: ServerMessage) => {
21
+ publishedMessages.push(msg);
22
+ },
23
+ capabilityForMessageType: () => undefined,
24
+ assistantEventHub: {
25
+ publish: async () => {},
26
+ subscribe: () => ({ dispose: () => {}, active: true }),
27
+ },
28
+ }));
29
+
30
+ const pendingInteractions = await import("../runtime/pending-interactions.js");
31
+
32
+ beforeEach(() => {
33
+ publishedMessages.length = 0;
34
+ pendingInteractions.clear();
35
+ });
36
+
37
+ afterEach(() => {
38
+ pendingInteractions.clear();
39
+ });
40
+
41
+ function lastResolvedEvent() {
42
+ const evt = publishedMessages.find((m) => m.type === "interaction_resolved");
43
+ expect(evt).toBeDefined();
44
+ return evt as Extract<ServerMessage, { type: "interaction_resolved" }>;
45
+ }
46
+
47
+ describe("pendingInteractions.resolve emits interaction_resolved", () => {
48
+ test("default state is 'cancelled'", () => {
49
+ pendingInteractions.register("req-1", {
50
+ conversationId: "conv-1",
51
+ kind: "confirmation",
52
+ });
53
+ const returned = pendingInteractions.resolve("req-1");
54
+ expect(returned).toBeDefined();
55
+ const evt = lastResolvedEvent();
56
+ expect(evt.requestId).toBe("req-1");
57
+ expect(evt.conversationKey).toBe("conv-1");
58
+ expect(evt.conversationId).toBe("conv-1");
59
+ expect(evt.state).toBe("cancelled");
60
+ expect(evt.kind).toBe("confirmation");
61
+ });
62
+
63
+ test("approved state propagates", () => {
64
+ pendingInteractions.register("req-approve", {
65
+ conversationId: "conv-a",
66
+ kind: "confirmation",
67
+ });
68
+ pendingInteractions.resolve("req-approve", "approved");
69
+ expect(lastResolvedEvent().state).toBe("approved");
70
+ });
71
+
72
+ test("rejected state propagates", () => {
73
+ pendingInteractions.register("req-reject", {
74
+ conversationId: "conv-b",
75
+ kind: "confirmation",
76
+ });
77
+ pendingInteractions.resolve("req-reject", "rejected");
78
+ expect(lastResolvedEvent().state).toBe("rejected");
79
+ });
80
+
81
+ test("answered state propagates (secret response)", () => {
82
+ pendingInteractions.register("req-secret", {
83
+ conversationId: "conv-c",
84
+ kind: "secret",
85
+ });
86
+ pendingInteractions.resolve("req-secret", "answered");
87
+ const evt = lastResolvedEvent();
88
+ expect(evt.state).toBe("answered");
89
+ expect(evt.kind).toBe("secret");
90
+ });
91
+
92
+ test("superseded state propagates", () => {
93
+ pendingInteractions.register("req-super", {
94
+ conversationId: "conv-d",
95
+ kind: "confirmation",
96
+ });
97
+ pendingInteractions.resolve("req-super", "superseded");
98
+ expect(lastResolvedEvent().state).toBe("superseded");
99
+ });
100
+
101
+ test("no event is emitted when the requestId is unknown", () => {
102
+ pendingInteractions.resolve("never-registered", "approved");
103
+ expect(publishedMessages).toHaveLength(0);
104
+ });
105
+
106
+ test("a single resolve emits exactly one event", () => {
107
+ pendingInteractions.register("req-once", {
108
+ conversationId: "conv-e",
109
+ kind: "host_bash",
110
+ });
111
+ pendingInteractions.resolve("req-once", "answered");
112
+ // Second resolve is a no-op because the entry was already consumed.
113
+ pendingInteractions.resolve("req-once", "answered");
114
+ const events = publishedMessages.filter(
115
+ (m) => m.type === "interaction_resolved",
116
+ );
117
+ expect(events).toHaveLength(1);
118
+ });
119
+
120
+ test("clears the registered timer on resolve", () => {
121
+ let fired = false;
122
+ const timer = setTimeout(() => {
123
+ fired = true;
124
+ }, 10_000);
125
+ pendingInteractions.register("req-timer", {
126
+ conversationId: "conv-f",
127
+ kind: "confirmation",
128
+ timer,
129
+ });
130
+ pendingInteractions.resolve("req-timer", "approved");
131
+ clearTimeout(timer);
132
+ expect(fired).toBe(false);
133
+ });
134
+ });
135
+
136
+ describe("removeByConversation emits interaction_resolved per entry", () => {
137
+ test("emits superseded for every non-host interaction in the conversation", () => {
138
+ pendingInteractions.register("conf-1", {
139
+ conversationId: "conv-x",
140
+ kind: "confirmation",
141
+ });
142
+ pendingInteractions.register("secret-1", {
143
+ conversationId: "conv-x",
144
+ kind: "secret",
145
+ });
146
+ pendingInteractions.register("question-1", {
147
+ conversationId: "conv-x",
148
+ kind: "question",
149
+ });
150
+ pendingInteractions.register("host-bash-1", {
151
+ conversationId: "conv-x",
152
+ kind: "host_bash",
153
+ });
154
+ pendingInteractions.register("conf-other", {
155
+ conversationId: "conv-y",
156
+ kind: "confirmation",
157
+ });
158
+
159
+ pendingInteractions.removeByConversation("conv-x");
160
+
161
+ const events = publishedMessages.filter(
162
+ (m) => m.type === "interaction_resolved",
163
+ ) as Extract<ServerMessage, { type: "interaction_resolved" }>[];
164
+ expect(events).toHaveLength(3);
165
+ expect(events.every((e) => e.state === "superseded")).toBe(true);
166
+ const requestIds = new Set(events.map((e) => e.requestId));
167
+ expect(requestIds).toEqual(new Set(["conf-1", "secret-1", "question-1"]));
168
+
169
+ // host_bash entries survive auto-deny — no event for them.
170
+ expect(pendingInteractions.get("host-bash-1")).toBeDefined();
171
+ // Unrelated conversation is untouched.
172
+ expect(pendingInteractions.get("conf-other")).toBeDefined();
173
+ });
174
+
175
+ test("explicit state arg overrides the default 'superseded'", () => {
176
+ pendingInteractions.register("conf-2", {
177
+ conversationId: "conv-z",
178
+ kind: "confirmation",
179
+ });
180
+ pendingInteractions.removeByConversation("conv-z", "cancelled");
181
+ const events = publishedMessages.filter(
182
+ (m) => m.type === "interaction_resolved",
183
+ );
184
+ expect(events).toHaveLength(1);
185
+ expect(
186
+ (events[0] as Extract<ServerMessage, { type: "interaction_resolved" }>)
187
+ .state,
188
+ ).toBe("cancelled");
189
+ });
190
+ });
@@ -117,8 +117,13 @@ describe("buildManagedBaseUrl", () => {
117
117
  );
118
118
  });
119
119
 
120
+ test("returns managed URL for fireworks", async () => {
121
+ expect(await buildManagedBaseUrl("fireworks")).toBe(
122
+ "https://platform.example.com/v1/runtime-proxy/fireworks",
123
+ );
124
+ });
125
+
120
126
  test("returns undefined for non-managed providers", async () => {
121
- expect(await buildManagedBaseUrl("fireworks")).toBeUndefined();
122
127
  expect(await buildManagedBaseUrl("openrouter")).toBeUndefined();
123
128
  expect(await buildManagedBaseUrl("ollama")).toBeUndefined();
124
129
  });
@@ -8,7 +8,6 @@ import {
8
8
  getDataDir,
9
9
  getDbPath,
10
10
  getHistoryPath,
11
- getInterfacesDir,
12
11
  getLogPath,
13
12
  getPidPath,
14
13
  getSandboxRootDir,
@@ -67,7 +66,6 @@ describe("path characterization", () => {
67
66
  expect(getDbPath()).toBe(join(data, "db", "assistant.db"));
68
67
  expect(getLogPath()).toBe(join(data, "logs", "vellum.log"));
69
68
  expect(getHistoryPath()).toBe(join(data, "history"));
70
- expect(getInterfacesDir()).toBe(join(data, "interfaces"));
71
69
  expect(getSandboxRootDir()).toBe(join(data, "sandbox"));
72
70
  expect(getSandboxWorkingDir()).toBe(ws);
73
71
 
@@ -117,7 +115,6 @@ describe("path characterization", () => {
117
115
  expect(existsSync(join(data, "memory"))).toBe(true);
118
116
  expect(existsSync(join(data, "memory", "knowledge"))).toBe(true);
119
117
  expect(existsSync(join(data, "apps"))).toBe(true);
120
- expect(existsSync(join(data, "interfaces"))).toBe(true);
121
118
 
122
119
  rmSync(wsDir, { recursive: true, force: true });
123
120
  });