@vellumai/assistant 0.8.3 → 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 (342) hide show
  1. package/docker-entrypoint.sh +0 -1
  2. package/node_modules/@vellumai/gateway-client/src/types.ts +2 -0
  3. package/openapi.yaml +610 -16
  4. package/package.json +1 -1
  5. package/src/__tests__/agent-loop-exit-reason.test.ts +4 -5
  6. package/src/__tests__/agent-loop-override-profile.test.ts +1 -1
  7. package/src/__tests__/agent-loop.test.ts +88 -3
  8. package/src/__tests__/anthropic-provider.test.ts +272 -0
  9. package/src/__tests__/approval-cascade.test.ts +1 -1
  10. package/src/__tests__/background-workers-disk-pressure.test.ts +2 -1
  11. package/src/__tests__/channel-delivery-store.test.ts +193 -0
  12. package/src/__tests__/channel-reply-delivery.test.ts +284 -5
  13. package/src/__tests__/channel-retry-sweep.test.ts +274 -1
  14. package/src/__tests__/compaction-events.test.ts +1 -1
  15. package/src/__tests__/compactor-preserved-tail-count.test.ts +110 -0
  16. package/src/__tests__/config-watcher.test.ts +1 -1
  17. package/src/__tests__/context-token-estimator.test.ts +91 -1
  18. package/src/__tests__/conversation-abort-tool-results.test.ts +1 -1
  19. package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +54 -3
  20. package/src/__tests__/conversation-agent-loop-overflow.test.ts +31 -6
  21. package/src/__tests__/conversation-agent-loop.test.ts +25 -7
  22. package/src/__tests__/conversation-app-control-lifecycle.test.ts +1 -1
  23. package/src/__tests__/conversation-clean-command.test.ts +137 -0
  24. package/src/__tests__/conversation-confirmation-signals.test.ts +1 -1
  25. package/src/__tests__/conversation-fork-crud.test.ts +161 -0
  26. package/src/__tests__/conversation-lifecycle.test.ts +1 -1
  27. package/src/__tests__/conversation-load-cleaned-at.test.ts +279 -0
  28. package/src/__tests__/conversation-load-history-repair.test.ts +1 -1
  29. package/src/__tests__/conversation-pairing.test.ts +2 -2
  30. package/src/__tests__/conversation-process-callsite.test.ts +1 -1
  31. package/src/__tests__/conversation-provider-retry-repair.test.ts +1 -1
  32. package/src/__tests__/conversation-queue.test.ts +1 -1
  33. package/src/__tests__/conversation-runtime-assembly.test.ts +264 -81
  34. package/src/__tests__/conversation-seed-composer.test.ts +66 -4
  35. package/src/__tests__/conversation-slash-commands.test.ts +36 -8
  36. package/src/__tests__/conversation-slash-queue.test.ts +1 -1
  37. package/src/__tests__/conversation-slash-unknown.test.ts +1 -1
  38. package/src/__tests__/conversation-speed-override.test.ts +1 -1
  39. package/src/__tests__/conversation-surfaces-task-progress.test.ts +220 -0
  40. package/src/__tests__/conversation-workspace-cache-state.test.ts +1 -1
  41. package/src/__tests__/conversation-workspace-injection.test.ts +5 -1
  42. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +5 -1
  43. package/src/__tests__/credential-security-invariants.test.ts +6 -0
  44. package/src/__tests__/cu-unified-flow.test.ts +10 -1
  45. package/src/__tests__/dm-backfill.test.ts +64 -0
  46. package/src/__tests__/dm-persistence.test.ts +33 -0
  47. package/src/__tests__/document-find-replace.test.ts +501 -0
  48. package/src/__tests__/first-greeting.test.ts +23 -2
  49. package/src/__tests__/headless-browser-navigate.test.ts +172 -0
  50. package/src/__tests__/host-bash-proxy.test.ts +6 -0
  51. package/src/__tests__/host-browser-proxy.test.ts +10 -0
  52. package/src/__tests__/host-cu-proxy.test.ts +8 -1
  53. package/src/__tests__/host-file-proxy.test.ts +8 -1
  54. package/src/__tests__/host-transfer-proxy.test.ts +8 -1
  55. package/src/__tests__/identity-routes.test.ts +57 -0
  56. package/src/__tests__/inbound-slack-persistence.test.ts +3 -0
  57. package/src/__tests__/injector-chain.test.ts +2 -0
  58. package/src/__tests__/injector-document-comments.test.ts +378 -0
  59. package/src/__tests__/injector-pkb-v2-silenced.test.ts +4 -25
  60. package/src/__tests__/list-messages-attachments.test.ts +21 -17
  61. package/src/__tests__/list-messages-hidden-metadata.test.ts +217 -0
  62. package/src/__tests__/list-messages-page-latest.test.ts +130 -14
  63. package/src/__tests__/list-messages-tool-merge.test.ts +17 -16
  64. package/src/__tests__/llm-context-normalization.test.ts +0 -2
  65. package/src/__tests__/llm-resolver.test.ts +85 -1
  66. package/src/__tests__/log-export-routes.test.ts +99 -2
  67. package/src/__tests__/message-queue-steer.test.ts +114 -0
  68. package/src/__tests__/openai-provider.test.ts +105 -0
  69. package/src/__tests__/openai-responses-provider.test.ts +4 -4
  70. package/src/__tests__/outbound-slack-persistence.test.ts +187 -20
  71. package/src/__tests__/pending-interactions-resolved-event.test.ts +190 -0
  72. package/src/__tests__/platform.test.ts +0 -3
  73. package/src/__tests__/plugin-source-watcher.test.ts +302 -0
  74. package/src/__tests__/process-message-background-slack.test.ts +1 -51
  75. package/src/__tests__/process-message-display-content.test.ts +21 -16
  76. package/src/__tests__/server-history-render.test.ts +83 -4
  77. package/src/__tests__/steer-tool-repair.test.ts +249 -0
  78. package/src/__tests__/system-prompt.test.ts +51 -28
  79. package/src/__tests__/terminal-tools.test.ts +11 -1
  80. package/src/__tests__/thinking-block-replay.test.ts +113 -0
  81. package/src/__tests__/thread-backfill.test.ts +370 -22
  82. package/src/__tests__/tool-executor.test.ts +90 -1
  83. package/src/__tests__/tool-result-metadata-plumbing.test.ts +167 -0
  84. package/src/__tests__/twilio-routes.test.ts +1 -1
  85. package/src/__tests__/web-fetch.test.ts +2 -2
  86. package/src/__tests__/workspace-git-service.test.ts +88 -5
  87. package/src/__tests__/workspace-migration-088-deprecate-background-conversation-override.test.ts +158 -0
  88. package/src/agent/attachments.ts +1 -0
  89. package/src/agent/loop.ts +57 -20
  90. package/src/background-wake/next-wake.test.ts +289 -0
  91. package/src/background-wake/next-wake.ts +172 -0
  92. package/src/browser/operations.ts +15 -0
  93. package/src/cli/commands/__tests__/conversations-slack.test.ts +572 -0
  94. package/src/cli/commands/__tests__/memory-v2.test.ts +9 -12
  95. package/src/cli/commands/conversations.ts +128 -1
  96. package/src/cli/commands/inference-providers.ts +147 -1
  97. package/src/cli/commands/memory-v2.ts +308 -0
  98. package/src/cli/commands/notifications.ts +24 -2
  99. package/src/cli/utils/conversation-id.ts +17 -5
  100. package/src/config/bundled-skills/app-builder/SKILL.md +2 -2
  101. package/src/config/bundled-skills/document-editor/SKILL.md +115 -0
  102. package/src/config/bundled-skills/document-editor/TOOLS.json +240 -0
  103. package/src/config/bundled-skills/document-editor/tools/comment-list.ts +12 -0
  104. package/src/config/bundled-skills/document-editor/tools/comment-reply.ts +12 -0
  105. package/src/config/bundled-skills/document-editor/tools/comment-resolve.ts +12 -0
  106. package/src/config/bundled-skills/document-editor/tools/document-find.ts +12 -0
  107. package/src/config/bundled-skills/document-editor/tools/document-replace-text.ts +12 -0
  108. package/src/config/bundled-skills/media-processing/SKILL.md +8 -0
  109. package/src/config/bundled-skills/schedule/SKILL.md +8 -0
  110. package/src/config/bundled-tool-registry.ts +22 -12
  111. package/src/config/call-site-defaults.ts +19 -0
  112. package/src/config/feature-flag-registry.json +99 -3
  113. package/src/config/llm-resolver.ts +16 -2
  114. package/src/config/schemas/__tests__/memory-v2.test.ts +4 -0
  115. package/src/config/schemas/call-site-catalog.ts +21 -0
  116. package/src/config/schemas/llm.ts +3 -0
  117. package/src/config/schemas/memory-v2.ts +48 -1
  118. package/src/context/compactor.ts +8 -1
  119. package/src/context/token-estimator.ts +47 -4
  120. package/src/context/window-manager.ts +25 -0
  121. package/src/credential-health/credential-health-service.ts +34 -19
  122. package/src/daemon/__tests__/conversation-tool-setup.test.ts +66 -6
  123. package/src/daemon/__tests__/native-web-search-metadata.test.ts +357 -0
  124. package/src/daemon/__tests__/web-search-status-text.test.ts +287 -0
  125. package/src/daemon/conversation-agent-loop-handlers.ts +153 -23
  126. package/src/daemon/conversation-agent-loop.ts +223 -54
  127. package/src/daemon/conversation-lifecycle.ts +142 -116
  128. package/src/daemon/conversation-messaging.ts +3 -0
  129. package/src/daemon/conversation-process.ts +273 -0
  130. package/src/daemon/conversation-queue-manager.ts +14 -0
  131. package/src/daemon/conversation-runtime-assembly.ts +135 -75
  132. package/src/daemon/conversation-slash.ts +37 -5
  133. package/src/daemon/conversation-surfaces.ts +45 -2
  134. package/src/daemon/conversation-tool-setup.ts +7 -0
  135. package/src/daemon/conversation.ts +42 -5
  136. package/src/daemon/first-greeting.ts +10 -0
  137. package/src/daemon/handlers/__tests__/config-a2a-accept.test.ts +498 -0
  138. package/src/daemon/handlers/config-a2a.ts +160 -0
  139. package/src/daemon/handlers/config-model.test.ts +1 -0
  140. package/src/daemon/handlers/conversations.ts +79 -0
  141. package/src/daemon/handlers/shared.ts +92 -29
  142. package/src/daemon/host-bash-proxy.ts +1 -1
  143. package/src/daemon/host-cu-proxy.ts +1 -1
  144. package/src/daemon/host-file-proxy.ts +1 -1
  145. package/src/daemon/host-transfer-proxy.ts +1 -1
  146. package/src/daemon/lifecycle.ts +18 -4
  147. package/src/daemon/message-protocol.ts +4 -0
  148. package/src/daemon/message-types/conversations.ts +8 -0
  149. package/src/daemon/message-types/document-comments.ts +50 -0
  150. package/src/daemon/message-types/messages.ts +68 -1
  151. package/src/daemon/message-types/surfaces.ts +3 -1
  152. package/src/daemon/message-types/web-activity.ts +57 -0
  153. package/src/daemon/plugin-source-watcher.ts +135 -3
  154. package/src/daemon/process-message.ts +69 -12
  155. package/src/daemon/query-complexity-router.ts +75 -0
  156. package/src/daemon/trust-context.ts +6 -0
  157. package/src/documents/document-comments-store.test.ts +338 -0
  158. package/src/documents/document-comments-store.ts +237 -0
  159. package/src/documents/document-store.ts +202 -0
  160. package/src/heartbeat/__tests__/heartbeat-service.test.ts +0 -1
  161. package/src/heartbeat/heartbeat-service.ts +1 -0
  162. package/src/home/__tests__/suggested-prompts.test.ts +33 -2
  163. package/src/home/feed-types.ts +6 -1
  164. package/src/home/home-content-refresh.ts +52 -0
  165. package/src/home/home-greeting-cache.ts +69 -0
  166. package/src/home/home-greeting.ts +94 -0
  167. package/src/home/suggested-prompts.ts +177 -9
  168. package/src/memory/__tests__/jobs-worker-v2-schedule.test.ts +135 -2
  169. package/src/memory/__tests__/memory-retrospective-job.test.ts +320 -6
  170. package/src/memory/conversation-crud.ts +133 -43
  171. package/src/memory/db-init.ts +16 -0
  172. package/src/memory/delivery-crud.ts +41 -0
  173. package/src/memory/delivery-status.ts +141 -15
  174. package/src/memory/external-conversation-store.ts +32 -1
  175. package/src/memory/jobs-worker.ts +21 -1
  176. package/src/memory/memory-retrospective-constants.ts +28 -0
  177. package/src/memory/memory-retrospective-enqueue.ts +3 -2
  178. package/src/memory/memory-retrospective-job.ts +408 -18
  179. package/src/memory/memory-retrospective-startup-cleanup.ts +3 -3
  180. package/src/memory/memory-v2-activation-log-store.ts +26 -8
  181. package/src/memory/migrations/100-core-tables.ts +1 -0
  182. package/src/memory/migrations/109-external-conversation-bindings.ts +1 -0
  183. package/src/memory/migrations/253-conversation-last-notified-profile.ts +15 -0
  184. package/src/memory/migrations/253-document-comments.ts +47 -0
  185. package/src/memory/migrations/254-external-conversation-binding-chat-name.ts +43 -0
  186. package/src/memory/migrations/255-channel-inbound-delivery-attempts.ts +24 -0
  187. package/src/memory/migrations/256-memory-v2-injection-events.ts +113 -0
  188. package/src/memory/migrations/257-strip-base-url-non-openai-compatible.ts +22 -0
  189. package/src/memory/migrations/258-onboarding-events-prior-assistants.ts +13 -0
  190. package/src/memory/migrations/259-conversation-cleaned-at.ts +33 -0
  191. package/src/memory/migrations/index.ts +17 -0
  192. package/src/memory/migrations/registry.ts +25 -0
  193. package/src/memory/onboarding-events-store.ts +7 -0
  194. package/src/memory/schema/calls.ts +1 -0
  195. package/src/memory/schema/conversations.ts +3 -0
  196. package/src/memory/schema/infrastructure.ts +1 -0
  197. package/src/memory/v2/__tests__/injection-events.test.ts +318 -0
  198. package/src/memory/v2/__tests__/injection.test.ts +31 -14
  199. package/src/memory/v2/__tests__/page-index.test.ts +365 -1
  200. package/src/memory/v2/__tests__/router.test.ts +489 -1
  201. package/src/memory/v2/consolidation-job.ts +14 -0
  202. package/src/memory/v2/injection-events.ts +101 -0
  203. package/src/memory/v2/injection.ts +21 -10
  204. package/src/memory/v2/page-index.ts +209 -7
  205. package/src/memory/v2/page-store.ts +18 -0
  206. package/src/memory/v2/router.ts +209 -55
  207. package/src/messaging/providers/index.ts +7 -1
  208. package/src/messaging/providers/slack/__tests__/adapter-mention-rendering.test.ts +329 -3
  209. package/src/messaging/providers/slack/__tests__/adapter-token-routing.test.ts +34 -1
  210. package/src/messaging/providers/slack/adapter.ts +178 -25
  211. package/src/messaging/providers/slack/api.test.ts +54 -0
  212. package/src/messaging/providers/slack/api.ts +119 -3
  213. package/src/messaging/providers/slack/client.ts +12 -0
  214. package/src/messaging/providers/slack/deep-link.ts +20 -1
  215. package/src/messaging/providers/slack/message-metadata.test.ts +48 -0
  216. package/src/messaging/providers/slack/message-metadata.ts +156 -0
  217. package/src/messaging/providers/slack/render-transcript.test.ts +107 -75
  218. package/src/messaging/providers/slack/render-transcript.ts +176 -49
  219. package/src/messaging/providers/slack/send.test.ts +77 -0
  220. package/src/messaging/providers/slack/send.ts +8 -2
  221. package/src/messaging/providers/slack/types.ts +14 -0
  222. package/src/notifications/__tests__/emit-signal-home-feed.test.ts +4 -1
  223. package/src/notifications/__tests__/home-feed-side-effect.test.ts +116 -54
  224. package/src/notifications/conversation-seed-composer.ts +14 -2
  225. package/src/notifications/deferred-emit.ts +135 -0
  226. package/src/notifications/emit-signal.ts +9 -1
  227. package/src/notifications/home-feed-side-effect.ts +60 -30
  228. package/src/oauth/connect-orchestrator.ts +3 -0
  229. package/src/oauth/credential-token-resolver.ts +2 -0
  230. package/src/oauth/manual-token-connection.ts +19 -0
  231. package/src/oauth/oauth-store.ts +12 -0
  232. package/src/oauth/seed-providers.ts +22 -0
  233. package/src/permissions/prompter.ts +5 -2
  234. package/src/permissions/secret-prompter.ts +4 -1
  235. package/src/plugins/defaults/injectors.ts +82 -9
  236. package/src/prompts/__tests__/system-prompt.test.ts +46 -2
  237. package/src/prompts/normalize-onboarding.ts +40 -0
  238. package/src/prompts/sections.ts +32 -14
  239. package/src/prompts/system-prompt.ts +105 -68
  240. package/src/prompts/template-detection.ts +37 -0
  241. package/src/prompts/templates/BOOTSTRAP-CONTENT-AUTOMATION.md +141 -0
  242. package/src/prompts/templates/BOOTSTRAP.md +8 -0
  243. package/src/prompts/templates/VOICE.md +3 -0
  244. package/src/prompts/templates/system-sections.ts +53 -3
  245. package/src/providers/anthropic/client.ts +132 -5
  246. package/src/providers/fireworks/client.ts +20 -2
  247. package/src/providers/inference/__tests__/base-url-route-validation.test.ts +342 -0
  248. package/src/providers/inference/__tests__/base-url-security.test.ts +189 -0
  249. package/src/providers/inference/__tests__/codex-token-refresh.test.ts +254 -0
  250. package/src/providers/inference/adapter-factory.ts +15 -1
  251. package/src/providers/inference/auth.ts +3 -3
  252. package/src/providers/inference/codex-token-refresh.ts +128 -0
  253. package/src/providers/inference/resolve-auth.ts +49 -6
  254. package/src/providers/model-catalog.ts +48 -1
  255. package/src/providers/openai/chat-completions-provider.ts +57 -20
  256. package/src/providers/openai/responses-provider.ts +9 -3
  257. package/src/providers/openrouter/client.ts +5 -1
  258. package/src/providers/types.ts +25 -0
  259. package/src/runtime/__tests__/agent-wake.test.ts +214 -0
  260. package/src/runtime/__tests__/background-job-runner.test.ts +128 -0
  261. package/src/runtime/agent-wake.ts +151 -56
  262. package/src/runtime/auth/route-policy.ts +7 -3
  263. package/src/runtime/background-job-runner.ts +26 -0
  264. package/src/runtime/channel-reply-delivery.ts +182 -47
  265. package/src/runtime/channel-retry-sweep.ts +141 -16
  266. package/src/runtime/http-types.ts +7 -4
  267. package/src/runtime/pending-interactions.ts +51 -8
  268. package/src/runtime/routes/__tests__/content-source-routes.test.ts +162 -0
  269. package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +55 -1
  270. package/src/runtime/routes/__tests__/memory-v2-routes.test.ts +14 -0
  271. package/src/runtime/routes/__tests__/memory-v2-simulate-route.test.ts +271 -0
  272. package/src/runtime/routes/__tests__/sanity-routes.test.ts +280 -0
  273. package/src/runtime/routes/__tests__/slack-channel-routes.test.ts +266 -0
  274. package/src/runtime/routes/approval-routes.ts +4 -1
  275. package/src/runtime/routes/chatgpt-subscription-auth-routes.ts +246 -0
  276. package/src/runtime/routes/content-source-routes.ts +78 -0
  277. package/src/runtime/routes/conversation-cli-routes.ts +146 -1
  278. package/src/runtime/routes/conversation-query-routes.ts +60 -1
  279. package/src/runtime/routes/conversation-routes.ts +281 -76
  280. package/src/runtime/routes/document-comments-routes.ts +287 -0
  281. package/src/runtime/routes/documents-routes.ts +33 -0
  282. package/src/runtime/routes/home-feed-routes.ts +6 -3
  283. package/src/runtime/routes/host-app-control-routes.ts +1 -1
  284. package/src/runtime/routes/host-browser-routes.ts +8 -1
  285. package/src/runtime/routes/identity-routes.ts +21 -0
  286. package/src/runtime/routes/inbound-message-handler.ts +288 -58
  287. package/src/runtime/routes/inbound-stages/background-dispatch.test.ts +365 -6
  288. package/src/runtime/routes/inbound-stages/background-dispatch.ts +283 -82
  289. package/src/runtime/routes/index.ts +12 -4
  290. package/src/runtime/routes/inference-provider-connection-routes.ts +63 -7
  291. package/src/runtime/routes/integrations/a2a.ts +60 -1
  292. package/src/runtime/routes/log-export-routes.ts +39 -0
  293. package/src/runtime/routes/memory-v2-routes.ts +217 -0
  294. package/src/runtime/routes/notification-routes.ts +19 -2
  295. package/src/runtime/routes/question-routes.ts +4 -1
  296. package/src/runtime/routes/sanity-routes.ts +159 -0
  297. package/src/runtime/routes/slack-channel-routes.ts +187 -0
  298. package/src/runtime/services/conversation-serializer.ts +30 -4
  299. package/src/schedule/integration-status.ts +3 -1
  300. package/src/security/__tests__/oauth2-device-code.test.ts +479 -0
  301. package/src/security/oauth2-device-code.ts +307 -0
  302. package/src/security/oauth2.ts +26 -9
  303. package/src/security/secure-keys.ts +5 -0
  304. package/src/skills/catalog-install.ts +6 -2
  305. package/src/tools/browser/__tests__/pinned-tabs.test.ts +80 -0
  306. package/src/tools/browser/browser-execution.ts +93 -0
  307. package/src/tools/browser/cdp-client/__tests__/factory.test.ts +28 -0
  308. package/src/tools/browser/cdp-client/__tests__/types.test.ts +1 -0
  309. package/src/tools/browser/cdp-client/cdp-inspect-client.ts +10 -0
  310. package/src/tools/browser/cdp-client/extension-cdp-client.ts +15 -1
  311. package/src/tools/browser/cdp-client/factory.ts +87 -3
  312. package/src/tools/browser/cdp-client/local-cdp-client.ts +9 -0
  313. package/src/tools/browser/cdp-client/types.ts +36 -0
  314. package/src/tools/browser/pinned-tabs.ts +90 -0
  315. package/src/tools/document/document-comment-tool.test.ts +379 -0
  316. package/src/tools/document/document-comment-tool.ts +156 -0
  317. package/src/tools/document/document-tool.ts +128 -2
  318. package/src/tools/network/__tests__/web-fetch-metadata.test.ts +229 -0
  319. package/src/tools/network/__tests__/web-search-metadata.test.ts +346 -0
  320. package/src/tools/network/domain-normalize.ts +17 -0
  321. package/src/tools/network/web-fetch.ts +213 -64
  322. package/src/tools/network/web-search.ts +191 -66
  323. package/src/tools/terminal/safe-env.ts +3 -2
  324. package/src/tools/tool-approval-handler.ts +19 -12
  325. package/src/tools/types.ts +4 -0
  326. package/src/tools/ui-surface/definitions.ts +3 -1
  327. package/src/types/onboarding-context.ts +4 -0
  328. package/src/util/__tests__/favicon.test.ts +84 -0
  329. package/src/util/favicon.ts +40 -0
  330. package/src/util/platform.ts +0 -5
  331. package/src/workspace/git-service.ts +75 -4
  332. package/src/workspace/migrations/088-deprecate-background-conversation-override.ts +103 -0
  333. package/src/workspace/migrations/registry.ts +2 -0
  334. package/src/config/bundled-skills/document/SKILL.md +0 -54
  335. package/src/config/bundled-skills/document/TOOLS.json +0 -106
  336. package/src/daemon/seed-files.ts +0 -18
  337. package/src/runtime/routes/interface-routes.ts +0 -43
  338. /package/src/config/bundled-skills/{document → document-editor}/tools/document-create.ts +0 -0
  339. /package/src/config/bundled-skills/{document → document-editor}/tools/document-delete.ts +0 -0
  340. /package/src/config/bundled-skills/{document → document-editor}/tools/document-list.ts +0 -0
  341. /package/src/config/bundled-skills/{document → document-editor}/tools/document-read.ts +0 -0
  342. /package/src/config/bundled-skills/{document → document-editor}/tools/document-update.ts +0 -0
@@ -21,7 +21,7 @@ mock.module("../../../../oauth/oauth-store.js", () => ({
21
21
  isProviderConnected: async () => false,
22
22
  }));
23
23
 
24
- const findContactChannelMock = mock(() => undefined);
24
+ const findContactChannelMock = mock((): unknown => undefined);
25
25
  const upsertContactChannelMock = mock(() => {});
26
26
  mock.module("../../../../contacts/contact-store.js", () => ({
27
27
  findContactChannel: findContactChannelMock,
@@ -30,9 +30,13 @@ mock.module("../../../../contacts/contacts-write.js", () => ({
30
30
  upsertContactChannel: upsertContactChannelMock,
31
31
  }));
32
32
 
33
- import { slackProvider } from "../adapter.js";
33
+ import {
34
+ __resetSlackUserInfoCacheForTests,
35
+ slackProvider,
36
+ } from "../adapter.js";
34
37
 
35
38
  const originalFetch = globalThis.fetch;
39
+ let userInfoCalls: string[] = [];
36
40
 
37
41
  function installFetchStub() {
38
42
  globalThis.fetch = (async (
@@ -60,6 +64,73 @@ function fakeSlackResponse(url: string): Record<string, unknown> {
60
64
  const method = parsed.pathname.split("/").at(-1);
61
65
 
62
66
  if (method === "conversations.history") {
67
+ if (parsed.searchParams.get("channel") === "C_USERINFO_FAIL") {
68
+ return {
69
+ ok: true,
70
+ has_more: false,
71
+ messages: [
72
+ {
73
+ type: "message",
74
+ ts: "1700000006.000700",
75
+ user: "UMISSING",
76
+ text: "Fallback sender message",
77
+ },
78
+ ],
79
+ };
80
+ }
81
+
82
+ if (parsed.searchParams.get("channel") === "C_USERINFO_RETRY") {
83
+ return {
84
+ ok: true,
85
+ has_more: false,
86
+ messages: [
87
+ {
88
+ type: "message",
89
+ ts: "1700000007.000800",
90
+ user: "URETRY",
91
+ text: "Retry sender message",
92
+ },
93
+ ],
94
+ };
95
+ }
96
+
97
+ if (parsed.searchParams.get("channel") === "C_TIMEZONE_CACHE") {
98
+ return {
99
+ ok: true,
100
+ has_more: false,
101
+ messages: [
102
+ {
103
+ type: "message",
104
+ ts: "1700000004.000500",
105
+ user: "USENDER",
106
+ text: "First timezone-bearing message",
107
+ },
108
+ {
109
+ type: "message",
110
+ ts: "1700000005.000600",
111
+ user: "USENDER",
112
+ text: "Second timezone-bearing message",
113
+ },
114
+ ],
115
+ };
116
+ }
117
+
118
+ if (parsed.searchParams.get("channel") === "C_BOT_HISTORY") {
119
+ return {
120
+ ok: true,
121
+ has_more: false,
122
+ messages: [
123
+ {
124
+ type: "message",
125
+ subtype: "bot_message",
126
+ ts: "1700000003.000400",
127
+ bot_id: "B_ASSISTANT",
128
+ text: "Bot-authored history",
129
+ },
130
+ ],
131
+ };
132
+ }
133
+
63
134
  return {
64
135
  ok: true,
65
136
  has_more: false,
@@ -117,7 +188,9 @@ function fakeSlackResponse(url: string): Record<string, unknown> {
117
188
  }
118
189
 
119
190
  if (method === "users.info") {
120
- return fakeUserInfoResponse(parsed.searchParams.get("user") ?? "");
191
+ const userId = parsed.searchParams.get("user") ?? "";
192
+ userInfoCalls.push(userId);
193
+ return fakeUserInfoResponse(userId);
121
194
  }
122
195
 
123
196
  return { ok: true };
@@ -141,6 +214,9 @@ function fakeUserInfoResponse(userId: string): Record<string, unknown> {
141
214
  user: {
142
215
  id: "USENDER",
143
216
  name: "sender",
217
+ tz: "America/New_York",
218
+ tz_label: "Eastern Time",
219
+ tz_offset: -18000,
144
220
  profile: { display_name: "Sender" },
145
221
  },
146
222
  };
@@ -157,11 +233,93 @@ function fakeUserInfoResponse(userId: string): Record<string, unknown> {
157
233
  };
158
234
  }
159
235
 
236
+ if (userId === "URETRY") {
237
+ const retryCalls = userInfoCalls.filter((call) => call === userId).length;
238
+ if (retryCalls === 1) {
239
+ return { ok: false, error: "temporarily_unavailable" };
240
+ }
241
+ return {
242
+ ok: true,
243
+ user: {
244
+ id: "URETRY",
245
+ name: "retry_sender",
246
+ tz: "America/Chicago",
247
+ tz_label: "Central Time",
248
+ tz_offset: -21600,
249
+ profile: { display_name: "Retry Sender" },
250
+ },
251
+ };
252
+ }
253
+
160
254
  return { ok: false, error: "user_not_found" };
161
255
  }
162
256
 
257
+ function makeOAuthConnection(
258
+ id: string,
259
+ accountInfo: string,
260
+ displayName: string,
261
+ timezone: string,
262
+ timezoneLabel: string,
263
+ timezoneOffsetSeconds: number,
264
+ ): OAuthConnection {
265
+ return {
266
+ id,
267
+ provider: "slack",
268
+ accountInfo,
269
+ request: async (req) => {
270
+ if (req.path === "/conversations.history") {
271
+ return {
272
+ status: 200,
273
+ headers: {},
274
+ body: {
275
+ ok: true,
276
+ has_more: false,
277
+ messages: [
278
+ {
279
+ type: "message",
280
+ ts: "1700000008.000900",
281
+ user: "USAME",
282
+ text: "Account scoped sender",
283
+ },
284
+ ],
285
+ },
286
+ };
287
+ }
288
+ if (req.path === "/users.info") {
289
+ const userId = req.query?.user;
290
+ userInfoCalls.push(`${id}:${userId}`);
291
+ return {
292
+ status: 200,
293
+ headers: {},
294
+ body: {
295
+ ok: true,
296
+ user: {
297
+ id: "USAME",
298
+ name: displayName.toLowerCase().replaceAll(" ", "_"),
299
+ tz: timezone,
300
+ tz_label: timezoneLabel,
301
+ tz_offset: timezoneOffsetSeconds,
302
+ profile: { display_name: displayName },
303
+ },
304
+ },
305
+ };
306
+ }
307
+ return {
308
+ status: 200,
309
+ headers: {},
310
+ body: { ok: true },
311
+ };
312
+ },
313
+ withToken: async <T>(_fn: (token: string) => Promise<T>): Promise<T> => {
314
+ throw new Error("withToken was not expected");
315
+ },
316
+ };
317
+ }
318
+
163
319
  describe("Slack adapter mention rendering", () => {
164
320
  beforeEach(async () => {
321
+ __resetSlackUserInfoCacheForTests();
322
+ userInfoCalls = [];
165
323
  getSecureKeyAsyncMock.mockReset();
166
324
  getSecureKeyAsyncMock.mockImplementation(async (key: string) => {
167
325
  if (key === credentialKey("slack_channel", "bot_token")) {
@@ -190,6 +348,174 @@ describe("Slack adapter mention rendering", () => {
190
348
  expect(messages[0].reactions).toEqual([{ name: "eyes", count: 1 }]);
191
349
  });
192
350
 
351
+ test("getHistory preserves bot ids for bot-authored Slack messages", async () => {
352
+ const messages = await slackProvider.getHistory(undefined, "C_BOT_HISTORY");
353
+
354
+ expect(messages).toHaveLength(1);
355
+ expect(messages[0].sender).toEqual({ id: "B_ASSISTANT", name: "unknown" });
356
+ expect(messages[0].metadata).toEqual({
357
+ isBot: true,
358
+ slackBotId: "B_ASSISTANT",
359
+ });
360
+ });
361
+
362
+ test("getHistory caches Slack user info and maps timezone metadata", async () => {
363
+ const messages = await slackProvider.getHistory(
364
+ undefined,
365
+ "C_TIMEZONE_CACHE",
366
+ );
367
+
368
+ expect(messages).toHaveLength(2);
369
+ expect(userInfoCalls.filter((userId) => userId === "USENDER")).toHaveLength(
370
+ 1,
371
+ );
372
+ expect(messages.map((message) => message.sender)).toEqual([
373
+ { id: "USENDER", name: "Sender" },
374
+ { id: "USENDER", name: "Sender" },
375
+ ]);
376
+ expect(messages.map((message) => message.metadata)).toEqual([
377
+ {
378
+ actorTimezone: "America/New_York",
379
+ actorTimezoneLabel: "Eastern Time",
380
+ actorTimezoneOffsetSeconds: -18000,
381
+ },
382
+ {
383
+ actorTimezone: "America/New_York",
384
+ actorTimezoneLabel: "Eastern Time",
385
+ actorTimezoneOffsetSeconds: -18000,
386
+ },
387
+ ]);
388
+ });
389
+
390
+ test("getHistory prefers contact display names while still fetching Slack timezone facts", async () => {
391
+ findContactChannelMock.mockImplementationOnce(() => ({
392
+ contact: { displayName: "Saved Sender" },
393
+ }));
394
+
395
+ const messages = await slackProvider.getHistory(
396
+ undefined,
397
+ "C_TIMEZONE_CACHE",
398
+ );
399
+
400
+ expect(userInfoCalls.filter((userId) => userId === "USENDER")).toHaveLength(
401
+ 1,
402
+ );
403
+ expect(messages[0].sender).toEqual({
404
+ id: "USENDER",
405
+ name: "Saved Sender",
406
+ });
407
+ expect(messages[0].metadata).toEqual({
408
+ actorTimezone: "America/New_York",
409
+ actorTimezoneLabel: "Eastern Time",
410
+ actorTimezoneOffsetSeconds: -18000,
411
+ });
412
+ });
413
+
414
+ test("getHistory caches fallback user info for permanent users.info failures", async () => {
415
+ const firstMessages = await slackProvider.getHistory(
416
+ undefined,
417
+ "C_USERINFO_FAIL",
418
+ );
419
+ const secondMessages = await slackProvider.getHistory(
420
+ undefined,
421
+ "C_USERINFO_FAIL",
422
+ );
423
+
424
+ expect(firstMessages).toHaveLength(1);
425
+ expect(secondMessages).toHaveLength(1);
426
+ expect(
427
+ userInfoCalls.filter((userId) => userId === "UMISSING"),
428
+ ).toHaveLength(1);
429
+ expect(firstMessages[0].sender).toEqual({
430
+ id: "UMISSING",
431
+ name: "UMISSING",
432
+ });
433
+ expect(secondMessages[0].sender).toEqual({
434
+ id: "UMISSING",
435
+ name: "UMISSING",
436
+ });
437
+ expect(firstMessages[0].metadata).toBeUndefined();
438
+ expect(secondMessages[0].metadata).toBeUndefined();
439
+ });
440
+
441
+ test("getHistory does not cache fallback user info after transient users.info failures", async () => {
442
+ const firstMessages = await slackProvider.getHistory(
443
+ undefined,
444
+ "C_USERINFO_RETRY",
445
+ );
446
+ const secondMessages = await slackProvider.getHistory(
447
+ undefined,
448
+ "C_USERINFO_RETRY",
449
+ );
450
+
451
+ expect(userInfoCalls.filter((userId) => userId === "URETRY")).toHaveLength(
452
+ 2,
453
+ );
454
+ expect(firstMessages[0].sender).toEqual({
455
+ id: "URETRY",
456
+ name: "URETRY",
457
+ });
458
+ expect(firstMessages[0].metadata).toBeUndefined();
459
+ expect(secondMessages[0].sender).toEqual({
460
+ id: "URETRY",
461
+ name: "Retry Sender",
462
+ });
463
+ expect(secondMessages[0].metadata).toEqual({
464
+ actorTimezone: "America/Chicago",
465
+ actorTimezoneLabel: "Central Time",
466
+ actorTimezoneOffsetSeconds: -21600,
467
+ });
468
+ });
469
+
470
+ test("getHistory scopes Slack user info cache by OAuth connection", async () => {
471
+ const workspaceA = makeOAuthConnection(
472
+ "conn-workspace-a",
473
+ "workspace-a",
474
+ "Workspace A Sender",
475
+ "America/Los_Angeles",
476
+ "Pacific Time",
477
+ -28800,
478
+ );
479
+ const workspaceB = makeOAuthConnection(
480
+ "conn-workspace-b",
481
+ "workspace-b",
482
+ "Workspace B Sender",
483
+ "Europe/London",
484
+ "Greenwich Mean Time",
485
+ 0,
486
+ );
487
+
488
+ const messagesA = await slackProvider.getHistory(
489
+ workspaceA,
490
+ "C_ACCOUNT_SCOPE",
491
+ );
492
+ const messagesB = await slackProvider.getHistory(
493
+ workspaceB,
494
+ "C_ACCOUNT_SCOPE",
495
+ );
496
+
497
+ expect(userInfoCalls).toContain("conn-workspace-a:USAME");
498
+ expect(userInfoCalls).toContain("conn-workspace-b:USAME");
499
+ expect(messagesA[0].sender).toEqual({
500
+ id: "USAME",
501
+ name: "Workspace A Sender",
502
+ });
503
+ expect(messagesA[0].metadata).toEqual({
504
+ actorTimezone: "America/Los_Angeles",
505
+ actorTimezoneLabel: "Pacific Time",
506
+ actorTimezoneOffsetSeconds: -28800,
507
+ });
508
+ expect(messagesB[0].sender).toEqual({
509
+ id: "USAME",
510
+ name: "Workspace B Sender",
511
+ });
512
+ expect(messagesB[0].metadata).toEqual({
513
+ actorTimezone: "Europe/London",
514
+ actorTimezoneLabel: "Greenwich Mean Time",
515
+ actorTimezoneOffsetSeconds: 0,
516
+ });
517
+ });
518
+
193
519
  test("getThreadReplies renders Slack user mentions for model-facing text without changing sender identity", async () => {
194
520
  const messages = await slackProvider.getThreadReplies!(
195
521
  undefined,
@@ -49,7 +49,11 @@ mock.module("../../../../contacts/contacts-write.js", () => ({
49
49
  upsertContactChannel: () => {},
50
50
  }));
51
51
 
52
- import { slackProvider, withSlackBotToken } from "../adapter.js";
52
+ import {
53
+ resolveSlackBotUserId,
54
+ slackProvider,
55
+ withSlackBotToken,
56
+ } from "../adapter.js";
53
57
 
54
58
  // ── fetch capture ───────────────────────────────────────────────────────────
55
59
 
@@ -104,6 +108,16 @@ function fakeSlackResponse(url: string): Record<string, unknown> {
104
108
  if (url.includes("/chat.postMessage")) {
105
109
  return { ok: true, ts: "1700000000.000100", channel: "C123" };
106
110
  }
111
+ if (url.includes("/bots.info")) {
112
+ const botId = new URL(url).searchParams.get("bot");
113
+ return {
114
+ ok: true,
115
+ bot: {
116
+ id: botId,
117
+ user_id: botId === "B_ASSISTANT" ? "U_BOT" : "U_OTHER_BOT",
118
+ },
119
+ };
120
+ }
107
121
  // Default envelope for any other method the adapter might call.
108
122
  return { ok: true };
109
123
  }
@@ -319,4 +333,23 @@ describe("Slack adapter token routing", () => {
319
333
  account: "workspace-b",
320
334
  });
321
335
  });
336
+
337
+ test("bot id resolver maps Slack bot ids through the bot token", async () => {
338
+ const resolved = await slackProvider.resolveConnection!();
339
+ expect(resolved).toBeUndefined();
340
+
341
+ const userId = await resolveSlackBotUserId(undefined, "B_ASSISTANT");
342
+ const repeatedUserId = await resolveSlackBotUserId(
343
+ undefined,
344
+ "B_ASSISTANT",
345
+ );
346
+
347
+ expect(userId).toBe("U_BOT");
348
+ expect(repeatedUserId).toBe("U_BOT");
349
+ const botsInfoCalls = captured.filter((c) => c.url.includes("/bots.info"));
350
+ expect(botsInfoCalls).toHaveLength(2);
351
+ for (const call of botsInfoCalls) {
352
+ expect(call.authorization).toBe(`Bearer ${BOT_TOKEN}`);
353
+ }
354
+ });
322
355
  });