@vellumai/assistant 0.5.1 → 0.5.2

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 (338) hide show
  1. package/ARCHITECTURE.md +54 -54
  2. package/docs/architecture/integrations.md +62 -67
  3. package/docs/credential-execution-service.md +3 -3
  4. package/package.json +1 -1
  5. package/src/__tests__/agent-loop.test.ts +111 -0
  6. package/src/__tests__/always-loaded-tools-guard.test.ts +3 -4
  7. package/src/__tests__/app-builder-tool-scripts.test.ts +13 -151
  8. package/src/__tests__/app-dir-path-guard.test.ts +78 -0
  9. package/src/__tests__/app-executors.test.ts +1 -291
  10. package/src/__tests__/app-git-history.test.ts +4 -4
  11. package/src/__tests__/app-routes-csp.test.ts +1 -0
  12. package/src/__tests__/app-store-dir-names.test.ts +426 -0
  13. package/src/__tests__/attachments-store.test.ts +169 -21
  14. package/src/__tests__/attachments.test.ts +115 -1
  15. package/src/__tests__/btw-routes.test.ts +1 -0
  16. package/src/__tests__/canonical-guardian-store.test.ts +38 -0
  17. package/src/__tests__/channel-reply-delivery.test.ts +55 -0
  18. package/src/__tests__/checker.test.ts +54 -0
  19. package/src/__tests__/claude-code-skill-regression.test.ts +2 -0
  20. package/src/__tests__/claude-code-tool-profiles.test.ts +2 -0
  21. package/src/__tests__/compaction.benchmark.test.ts +2 -1
  22. package/src/__tests__/config-schema-cmd.test.ts +68 -21
  23. package/src/__tests__/config-schema.test.ts +1 -1
  24. package/src/__tests__/conversation-agent-loop-overflow.test.ts +149 -5
  25. package/src/__tests__/conversation-agent-loop.test.ts +290 -2
  26. package/src/__tests__/conversation-attachments.test.ts +17 -19
  27. package/src/__tests__/conversation-disk-view-integration.test.ts +277 -0
  28. package/src/__tests__/conversation-disk-view.test.ts +810 -0
  29. package/src/__tests__/conversation-error.test.ts +1 -1
  30. package/src/__tests__/conversation-fork-crud.test.ts +551 -0
  31. package/src/__tests__/conversation-fork-route.test.ts +386 -0
  32. package/src/__tests__/conversation-history-web-search.test.ts +1 -1
  33. package/src/__tests__/conversation-key-store-disk-view.test.ts +130 -0
  34. package/src/__tests__/conversation-media-retry.test.ts +8 -2
  35. package/src/__tests__/conversation-queue.test.ts +36 -1
  36. package/src/__tests__/conversation-routes-disk-view.test.ts +439 -0
  37. package/src/__tests__/conversation-routes-guardian-reply.test.ts +2 -2
  38. package/src/__tests__/conversation-routes-slash-commands.test.ts +2 -7
  39. package/src/__tests__/conversation-runtime-assembly.test.ts +17 -2
  40. package/src/__tests__/conversation-skill-tools.test.ts +4 -9
  41. package/src/__tests__/conversation-slash-commands.test.ts +149 -0
  42. package/src/__tests__/conversation-store.test.ts +24 -21
  43. package/src/__tests__/conversation-surfaces-state-update.test.ts +246 -0
  44. package/src/__tests__/conversation-surfaces-task-progress.test.ts +1 -0
  45. package/src/__tests__/conversation-title-service.test.ts +137 -0
  46. package/src/__tests__/conversation-tool-setup-app-refresh.test.ts +25 -315
  47. package/src/__tests__/conversation-tool-setup-memory-scope.test.ts +1 -0
  48. package/src/__tests__/conversation-tool-setup-side-effect-flag.test.ts +1 -0
  49. package/src/__tests__/conversation-workspace-cache-state.test.ts +44 -2
  50. package/src/__tests__/conversation-workspace-injection.test.ts +11 -0
  51. package/src/__tests__/credential-security-invariants.test.ts +3 -0
  52. package/src/__tests__/credential-vault-unit.test.ts +5 -10
  53. package/src/__tests__/cu-unified-flow.test.ts +1 -0
  54. package/src/__tests__/db-conversation-fork-lineage-migration.test.ts +241 -0
  55. package/src/__tests__/db-llm-request-log-provider-migration.test.ts +214 -0
  56. package/src/__tests__/diagnostics-export.test.ts +70 -1
  57. package/src/__tests__/first-greeting.test.ts +80 -0
  58. package/src/__tests__/gateway-only-guard.test.ts +1 -0
  59. package/src/__tests__/handlers-user-message-approval-consumption.test.ts +3 -7
  60. package/src/__tests__/history-repair.test.ts +32 -10
  61. package/src/__tests__/http-conversation-lineage.test.ts +251 -0
  62. package/src/__tests__/image-source-path-reinject.test.ts +136 -0
  63. package/src/__tests__/llm-context-normalization.test.ts +1116 -0
  64. package/src/__tests__/llm-context-route-provider.test.ts +217 -0
  65. package/src/__tests__/llm-request-log-turn-query.test.ts +270 -0
  66. package/src/__tests__/media-generate-image.test.ts +47 -94
  67. package/src/__tests__/memory-lifecycle-e2e.test.ts +3 -1
  68. package/src/__tests__/memory-recall-quality.test.ts +5 -5
  69. package/src/__tests__/migration-cross-version-compatibility.test.ts +4 -1
  70. package/src/__tests__/migration-export-http.test.ts +3 -1
  71. package/src/__tests__/migration-import-commit-http.test.ts +18 -4
  72. package/src/__tests__/migration-import-preflight-http.test.ts +1 -3
  73. package/src/__tests__/mime-builder.test.ts +3 -2
  74. package/src/__tests__/non-member-access-request.test.ts +12 -1
  75. package/src/__tests__/notification-decision-identity.test.ts +52 -0
  76. package/src/__tests__/oauth-apps-routes.test.ts +103 -0
  77. package/src/__tests__/oauth-store.test.ts +115 -0
  78. package/src/__tests__/provider-error-scenarios.test.ts +1 -3
  79. package/src/__tests__/provider-failover-actual-provider.test.ts +66 -0
  80. package/src/__tests__/recording-handler.test.ts +17 -0
  81. package/src/__tests__/registry.test.ts +3 -8
  82. package/src/__tests__/relay-server.test.ts +1 -1
  83. package/src/__tests__/runtime-attachment-metadata.test.ts +7 -3
  84. package/src/__tests__/schema-transforms.test.ts +165 -5
  85. package/src/__tests__/server-history-render.test.ts +2 -2
  86. package/src/__tests__/slack-app-setup-skill-regression.test.ts +3 -1
  87. package/src/__tests__/slack-inbound-verification.test.ts +2 -2
  88. package/src/__tests__/starter-task-flow.test.ts +1 -0
  89. package/src/__tests__/suggestion-routes.test.ts +443 -0
  90. package/src/__tests__/swarm-conversation-integration.test.ts +1 -0
  91. package/src/__tests__/swarm-recursion.test.ts +1 -0
  92. package/src/__tests__/swarm-tool.test.ts +1 -0
  93. package/src/__tests__/tool-execution-abort-cleanup.test.ts +1 -0
  94. package/src/__tests__/tool-preview-lifecycle.test.ts +32 -5
  95. package/src/__tests__/top-level-renderer.test.ts +22 -0
  96. package/src/__tests__/turn-boundary-resolution.test.ts +243 -0
  97. package/src/__tests__/web-fetch.test.ts +6 -2
  98. package/src/__tests__/workspace-migration-006-services-config.test.ts +335 -0
  99. package/src/__tests__/workspace-migration-007-web-search-provider-rename.test.ts +312 -0
  100. package/src/__tests__/workspace-migration-009-backfill-conversation-disk-view.test.ts +278 -0
  101. package/src/__tests__/workspace-migration-010-app-dir-rename.test.ts +275 -0
  102. package/src/__tests__/workspace-migration-012-rename-conversation-disk-view-dirs.test.ts +77 -0
  103. package/src/__tests__/workspace-migration-013-repair-conversation-disk-view.test.ts +401 -0
  104. package/src/__tests__/workspace-migration-backfill-installation-id.test.ts +328 -0
  105. package/src/__tests__/workspace-migration-seed-device-id.test.ts +6 -10
  106. package/src/agent/attachments.ts +27 -1
  107. package/src/agent/loop.ts +29 -1
  108. package/src/avatar/traits-png-sync.ts +80 -25
  109. package/src/bundler/app-bundler.ts +4 -4
  110. package/src/calls/call-domain.ts +1 -0
  111. package/src/calls/voice-session-bridge.ts +1 -0
  112. package/src/cli/commands/auth.ts +92 -0
  113. package/src/cli/commands/avatar.ts +7 -6
  114. package/src/cli/commands/config.ts +2 -0
  115. package/src/cli/commands/oauth/providers.ts +29 -0
  116. package/src/cli/program.ts +12 -0
  117. package/src/cli.ts +15 -48
  118. package/src/config/bundled-skills/app-builder/SKILL.md +103 -28
  119. package/src/config/bundled-skills/app-builder/TOOLS.json +5 -199
  120. package/src/config/bundled-skills/app-builder/tools/{app-query.ts → app-refresh.ts} +2 -2
  121. package/src/config/bundled-skills/contacts/tools/google-contacts.ts +2 -3
  122. package/src/config/bundled-skills/gmail/tools/gmail-archive.ts +6 -9
  123. package/src/config/bundled-skills/gmail/tools/gmail-attachments.ts +4 -6
  124. package/src/config/bundled-skills/gmail/tools/gmail-draft.ts +2 -3
  125. package/src/config/bundled-skills/gmail/tools/gmail-filters.ts +2 -3
  126. package/src/config/bundled-skills/gmail/tools/gmail-follow-up.ts +2 -3
  127. package/src/config/bundled-skills/gmail/tools/gmail-forward.ts +2 -3
  128. package/src/config/bundled-skills/gmail/tools/gmail-label.ts +4 -6
  129. package/src/config/bundled-skills/gmail/tools/gmail-outreach-scan.ts +2 -3
  130. package/src/config/bundled-skills/gmail/tools/gmail-send-draft.ts +2 -3
  131. package/src/config/bundled-skills/gmail/tools/gmail-sender-digest.ts +2 -3
  132. package/src/config/bundled-skills/gmail/tools/gmail-trash.ts +2 -3
  133. package/src/config/bundled-skills/gmail/tools/gmail-unsubscribe.ts +2 -3
  134. package/src/config/bundled-skills/gmail/tools/gmail-vacation.ts +2 -3
  135. package/src/config/bundled-skills/google-calendar/tools/shared.ts +1 -1
  136. package/src/config/bundled-skills/image-studio/SKILL.md +2 -2
  137. package/src/config/bundled-skills/image-studio/TOOLS.json +2 -2
  138. package/src/config/bundled-skills/image-studio/tools/media-generate-image.ts +45 -72
  139. package/src/config/bundled-skills/media-processing/tools/extract-keyframes.ts +2 -2
  140. package/src/config/bundled-skills/messaging/tools/shared.ts +1 -1
  141. package/src/config/bundled-skills/settings/tools/voice-config-update.ts +19 -3
  142. package/src/config/bundled-skills/skill-management/TOOLS.json +2 -2
  143. package/src/config/bundled-skills/slack/tools/shared.ts +19 -4
  144. package/src/config/bundled-skills/slack/tools/slack-scan-digest.ts +2 -3
  145. package/src/config/bundled-skills/transcribe/SKILL.md +1 -1
  146. package/src/config/bundled-skills/transcribe/TOOLS.json +2 -6
  147. package/src/config/bundled-skills/transcribe/tools/transcribe-media.ts +19 -83
  148. package/src/config/bundled-tool-registry.ts +2 -14
  149. package/src/config/feature-flag-registry.json +8 -0
  150. package/src/config/loader.ts +64 -0
  151. package/src/config/raw-config-utils.ts +30 -0
  152. package/src/config/schema-utils.ts +28 -7
  153. package/src/config/schema.ts +8 -0
  154. package/src/config/schemas/elevenlabs.ts +18 -0
  155. package/src/config/schemas/memory-lifecycle.ts +4 -2
  156. package/src/config/schemas/memory-storage.ts +1 -1
  157. package/src/config/schemas/services.ts +8 -6
  158. package/src/contacts/contact-store.ts +13 -6
  159. package/src/contacts/contacts-write.ts +0 -1
  160. package/src/context/window-manager.ts +13 -2
  161. package/src/daemon/conversation-agent-loop-handlers.ts +48 -7
  162. package/src/daemon/conversation-agent-loop.ts +56 -19
  163. package/src/daemon/conversation-attachments.ts +18 -36
  164. package/src/daemon/conversation-error.ts +2 -1
  165. package/src/daemon/conversation-history.ts +18 -4
  166. package/src/daemon/conversation-lifecycle.ts +39 -15
  167. package/src/daemon/conversation-messaging.ts +70 -26
  168. package/src/daemon/conversation-process.ts +58 -34
  169. package/src/daemon/conversation-runtime-assembly.ts +21 -38
  170. package/src/daemon/conversation-slash.ts +121 -256
  171. package/src/daemon/conversation-surfaces.ts +143 -20
  172. package/src/daemon/conversation-tool-setup.ts +0 -6
  173. package/src/daemon/conversation-workspace.ts +21 -1
  174. package/src/daemon/conversation.ts +51 -29
  175. package/src/daemon/first-greeting.ts +35 -0
  176. package/src/daemon/handlers/config-embeddings.ts +148 -0
  177. package/src/daemon/handlers/config-model.ts +71 -26
  178. package/src/daemon/handlers/conversations.ts +0 -23
  179. package/src/daemon/handlers/recording.ts +26 -21
  180. package/src/daemon/host-cu-proxy.ts +2 -2
  181. package/src/daemon/lifecycle.ts +106 -64
  182. package/src/daemon/message-protocol.ts +3 -0
  183. package/src/daemon/message-types/conversations.ts +19 -0
  184. package/src/daemon/message-types/messages.ts +1 -0
  185. package/src/daemon/message-types/shared.ts +2 -0
  186. package/src/daemon/message-types/surfaces.ts +2 -0
  187. package/src/daemon/message-types/upgrades.ts +23 -0
  188. package/src/daemon/server.ts +83 -12
  189. package/src/daemon/shutdown-handlers.ts +8 -5
  190. package/src/daemon/startup-error.ts +9 -0
  191. package/src/daemon/tool-side-effects.ts +11 -28
  192. package/src/events/tool-permission-telemetry-listener.ts +1 -3
  193. package/src/instrument.ts +0 -4
  194. package/src/media/app-icon-generator.ts +2 -2
  195. package/src/memory/app-git-service.ts +28 -16
  196. package/src/memory/app-store.ts +230 -41
  197. package/src/memory/attachments-store.ts +558 -130
  198. package/src/memory/conversation-attention-store.ts +70 -0
  199. package/src/memory/conversation-crud.ts +442 -3
  200. package/src/memory/conversation-directories.ts +125 -0
  201. package/src/memory/conversation-disk-view.ts +390 -0
  202. package/src/memory/conversation-key-store.ts +17 -5
  203. package/src/memory/conversation-queries.ts +5 -1
  204. package/src/memory/conversation-title-service.ts +21 -49
  205. package/src/memory/db-init.ts +28 -0
  206. package/src/memory/embedding-backend.ts +42 -53
  207. package/src/memory/embedding-gemini.test.ts +4 -4
  208. package/src/memory/embedding-local.ts +1 -3
  209. package/src/memory/embedding-ollama.ts +1 -3
  210. package/src/memory/embedding-openai.ts +1 -3
  211. package/src/memory/indexer.ts +9 -7
  212. package/src/memory/items-extractor.ts +42 -13
  213. package/src/memory/job-handlers/conversation-starters.ts +6 -1
  214. package/src/memory/job-handlers/embedding.test.ts +1 -4
  215. package/src/memory/llm-request-log-store.ts +100 -1
  216. package/src/memory/migrations/102-alter-table-columns.ts +5 -0
  217. package/src/memory/migrations/146-schedule-oneshot-routing.ts +3 -3
  218. package/src/memory/migrations/147-migrate-reminders-to-schedules.ts +66 -70
  219. package/src/memory/migrations/148-drop-reminders-table.ts +5 -9
  220. package/src/memory/migrations/160-drop-loopback-port-column.ts +1 -3
  221. package/src/memory/migrations/174-rename-thread-starters-table.ts +0 -7
  222. package/src/memory/migrations/178-oauth-providers-managed-service-config-key.ts +15 -0
  223. package/src/memory/migrations/179-llm-request-log-message-id.ts +16 -0
  224. package/src/memory/migrations/180-backfill-inline-attachments-to-disk.ts +66 -0
  225. package/src/memory/migrations/181-rename-thread-starters-checkpoints.ts +46 -0
  226. package/src/memory/migrations/182-oauth-providers-display-metadata.ts +20 -0
  227. package/src/memory/migrations/183-add-conversation-fork-lineage.ts +22 -0
  228. package/src/memory/migrations/184-llm-request-log-provider.ts +12 -0
  229. package/src/memory/migrations/index.ts +7 -0
  230. package/src/memory/migrations/registry.ts +13 -0
  231. package/src/memory/retriever.test.ts +601 -2
  232. package/src/memory/retriever.ts +85 -9
  233. package/src/memory/schema/conversations.ts +6 -0
  234. package/src/memory/schema/infrastructure.ts +13 -7
  235. package/src/memory/schema/oauth.ts +6 -0
  236. package/src/messaging/providers/gmail/mime-builder.ts +3 -1
  237. package/src/notifications/copy-composer.ts +26 -0
  238. package/src/notifications/decision-engine.ts +14 -1
  239. package/src/notifications/emit-signal.ts +1 -1
  240. package/src/notifications/signal.ts +36 -0
  241. package/src/oauth/byo-connection.test.ts +1 -45
  242. package/src/oauth/byo-connection.ts +2 -8
  243. package/src/oauth/connect-orchestrator.ts +15 -11
  244. package/src/oauth/connection-resolver.test.ts +191 -0
  245. package/src/oauth/connection-resolver.ts +66 -38
  246. package/src/oauth/connection.ts +0 -1
  247. package/src/oauth/oauth-store.ts +97 -47
  248. package/src/oauth/platform-connection.test.ts +0 -1
  249. package/src/oauth/platform-connection.ts +11 -3
  250. package/src/oauth/seed-providers.ts +78 -3
  251. package/src/oauth/token-persistence.ts +16 -10
  252. package/src/permissions/checker.ts +71 -8
  253. package/src/prompts/templates/BOOTSTRAP.md +2 -0
  254. package/src/providers/anthropic/client.ts +8 -1
  255. package/src/providers/failover.ts +4 -1
  256. package/src/providers/gemini/client.ts +50 -0
  257. package/src/providers/model-catalog.ts +92 -0
  258. package/src/providers/model-intents.ts +29 -20
  259. package/src/providers/openai/client.ts +49 -0
  260. package/src/providers/types.ts +2 -0
  261. package/src/runtime/access-request-helper.ts +16 -7
  262. package/src/runtime/auth/credential-service.ts +3 -1
  263. package/src/runtime/auth/route-policy.ts +14 -1
  264. package/src/runtime/btw-sidechain.ts +101 -0
  265. package/src/runtime/channel-reply-delivery.ts +17 -1
  266. package/src/runtime/http-router.ts +3 -1
  267. package/src/runtime/http-server.ts +196 -141
  268. package/src/runtime/http-types.ts +1 -0
  269. package/src/runtime/migrations/vbundle-builder.ts +5 -1
  270. package/src/runtime/routes/access-request-decision.ts +41 -0
  271. package/src/runtime/routes/app-management-routes.ts +6 -3
  272. package/src/runtime/routes/app-routes.ts +7 -3
  273. package/src/runtime/routes/approval-routes.ts +1 -0
  274. package/src/runtime/routes/approval-strategies/guardian-callback-strategy.ts +34 -2
  275. package/src/runtime/routes/attachment-routes.ts +45 -15
  276. package/src/runtime/routes/btw-routes.ts +21 -61
  277. package/src/runtime/routes/conversation-management-routes.ts +68 -0
  278. package/src/runtime/routes/conversation-query-routes.ts +180 -10
  279. package/src/runtime/routes/conversation-routes.ts +222 -28
  280. package/src/runtime/routes/conversation-starter-routes.ts +9 -11
  281. package/src/runtime/routes/diagnostics-routes.ts +1 -0
  282. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +2 -2
  283. package/src/runtime/routes/llm-context-normalization.ts +1199 -0
  284. package/src/runtime/routes/log-export-routes.ts +3 -0
  285. package/src/runtime/routes/memory-item-routes.test.ts +34 -0
  286. package/src/runtime/routes/memory-item-routes.ts +4 -0
  287. package/src/runtime/routes/migration-routes.ts +4 -1
  288. package/src/runtime/routes/oauth-apps.ts +291 -0
  289. package/src/runtime/routes/secret-routes.ts +28 -1
  290. package/src/runtime/routes/settings-routes.ts +14 -0
  291. package/src/runtime/routes/trace-event-routes.ts +4 -1
  292. package/src/schedule/schedule-store.ts +9 -21
  293. package/src/security/secure-keys.ts +21 -0
  294. package/src/signals/bash.ts +1 -1
  295. package/src/swarm/backend-claude-code.ts +3 -6
  296. package/src/telemetry/usage-telemetry-reporter.test.ts +3 -2
  297. package/src/telemetry/usage-telemetry-reporter.ts +3 -1
  298. package/src/tools/AGENTS.md +6 -10
  299. package/src/tools/apps/executors.ts +17 -232
  300. package/src/tools/claude-code/claude-code.ts +2 -3
  301. package/src/tools/credentials/vault.ts +7 -12
  302. package/src/tools/host-filesystem/read.ts +13 -10
  303. package/src/tools/network/__tests__/web-search.test.ts +4 -2
  304. package/src/tools/schedule/list.ts +2 -7
  305. package/src/tools/schema-transforms.ts +5 -0
  306. package/src/tools/shared/filesystem/format-diff.ts +2 -7
  307. package/src/tools/skills/execute.ts +1 -1
  308. package/src/tools/tool-manifest.ts +0 -6
  309. package/src/tools/ui-surface/definitions.ts +2 -2
  310. package/src/util/device-id.ts +28 -5
  311. package/src/util/platform.ts +6 -0
  312. package/src/util/pricing.ts +1 -0
  313. package/src/util/retry.ts +1 -3
  314. package/src/workspace/migrations/002-backfill-installation-id.ts +23 -12
  315. package/src/workspace/migrations/003-seed-device-id.ts +3 -4
  316. package/src/workspace/migrations/006-services-config.ts +5 -0
  317. package/src/workspace/migrations/008-voice-timeout-and-max-steps.ts +12 -0
  318. package/src/workspace/migrations/009-backfill-conversation-disk-view.ts +10 -0
  319. package/src/workspace/migrations/010-app-dir-rename.ts +223 -0
  320. package/src/workspace/migrations/012-rename-conversation-disk-view-dirs.ts +64 -0
  321. package/src/workspace/migrations/013-repair-conversation-disk-view.ts +11 -0
  322. package/src/workspace/migrations/rebuild-conversation-disk-view.ts +186 -0
  323. package/src/workspace/migrations/registry.ts +10 -0
  324. package/src/workspace/top-level-renderer.ts +12 -0
  325. package/src/__tests__/asset-materialize-tool.test.ts +0 -523
  326. package/src/__tests__/asset-search-tool.test.ts +0 -536
  327. package/src/__tests__/fixtures/media-reuse-fixtures.ts +0 -56
  328. package/src/__tests__/media-reuse-story.e2e.test.ts +0 -762
  329. package/src/__tests__/media-visibility-policy.test.ts +0 -190
  330. package/src/config/bundled-skills/app-builder/tools/app-file-edit.ts +0 -14
  331. package/src/config/bundled-skills/app-builder/tools/app-file-list.ts +0 -13
  332. package/src/config/bundled-skills/app-builder/tools/app-file-read.ts +0 -21
  333. package/src/config/bundled-skills/app-builder/tools/app-file-write.ts +0 -14
  334. package/src/config/bundled-skills/app-builder/tools/app-list.ts +0 -13
  335. package/src/config/bundled-skills/app-builder/tools/app-update.ts +0 -23
  336. package/src/daemon/media-visibility-policy.ts +0 -59
  337. package/src/tools/assets/materialize.ts +0 -248
  338. package/src/tools/assets/search.ts +0 -400
@@ -0,0 +1,312 @@
1
+ import {
2
+ existsSync,
3
+ mkdirSync,
4
+ readFileSync,
5
+ rmSync,
6
+ writeFileSync,
7
+ } from "node:fs";
8
+ import { tmpdir } from "node:os";
9
+ import { join } from "node:path";
10
+ import { afterEach, beforeEach, describe, expect, test } from "bun:test";
11
+
12
+ import { webSearchProviderRenameMigration } from "../workspace/migrations/007-web-search-provider-rename.js";
13
+
14
+ // ---------------------------------------------------------------------------
15
+ // Helpers
16
+ // ---------------------------------------------------------------------------
17
+
18
+ let workspaceDir: string;
19
+
20
+ function freshWorkspace(): void {
21
+ workspaceDir = join(
22
+ tmpdir(),
23
+ `vellum-migration-007-test-${Date.now()}-${Math.random().toString(36).slice(2)}`,
24
+ );
25
+ mkdirSync(workspaceDir, { recursive: true });
26
+ }
27
+
28
+ function writeConfig(data: Record<string, unknown>): void {
29
+ writeFileSync(
30
+ join(workspaceDir, "config.json"),
31
+ JSON.stringify(data, null, 2) + "\n",
32
+ );
33
+ }
34
+
35
+ function readConfig(): Record<string, unknown> {
36
+ return JSON.parse(readFileSync(join(workspaceDir, "config.json"), "utf-8"));
37
+ }
38
+
39
+ // ---------------------------------------------------------------------------
40
+ // Setup / teardown
41
+ // ---------------------------------------------------------------------------
42
+
43
+ beforeEach(() => {
44
+ freshWorkspace();
45
+ });
46
+
47
+ afterEach(() => {
48
+ if (existsSync(workspaceDir)) {
49
+ rmSync(workspaceDir, { recursive: true, force: true });
50
+ }
51
+ });
52
+
53
+ // ---------------------------------------------------------------------------
54
+ // Tests
55
+ // ---------------------------------------------------------------------------
56
+
57
+ describe("007-web-search-provider-rename migration", () => {
58
+ test("renames anthropic-native to inference-provider-native", () => {
59
+ writeConfig({
60
+ services: {
61
+ inference: {
62
+ mode: "your-own",
63
+ provider: "anthropic",
64
+ model: "claude-opus-4-6",
65
+ },
66
+ "web-search": {
67
+ mode: "your-own",
68
+ provider: "anthropic-native",
69
+ },
70
+ },
71
+ });
72
+
73
+ webSearchProviderRenameMigration.run(workspaceDir);
74
+
75
+ const config = readConfig();
76
+ const services = config.services as Record<string, Record<string, unknown>>;
77
+ expect(services["web-search"].provider).toBe("inference-provider-native");
78
+
79
+ // Other services should be unchanged
80
+ expect(services.inference.provider).toBe("anthropic");
81
+ expect(services.inference.model).toBe("claude-opus-4-6");
82
+ });
83
+
84
+ test("no-op when provider is already inference-provider-native", () => {
85
+ const original = {
86
+ services: {
87
+ "web-search": {
88
+ mode: "your-own",
89
+ provider: "inference-provider-native",
90
+ },
91
+ },
92
+ };
93
+ writeConfig(original);
94
+
95
+ webSearchProviderRenameMigration.run(workspaceDir);
96
+
97
+ const config = readConfig();
98
+ expect(config).toEqual(original);
99
+ });
100
+
101
+ test("no-op when provider is a different value (e.g. brave)", () => {
102
+ const original = {
103
+ services: {
104
+ "web-search": {
105
+ mode: "your-own",
106
+ provider: "brave",
107
+ },
108
+ },
109
+ };
110
+ writeConfig(original);
111
+
112
+ webSearchProviderRenameMigration.run(workspaceDir);
113
+
114
+ const config = readConfig();
115
+ expect(config).toEqual(original);
116
+ });
117
+
118
+ test("no-op when provider is perplexity", () => {
119
+ const original = {
120
+ services: {
121
+ "web-search": {
122
+ mode: "your-own",
123
+ provider: "perplexity",
124
+ },
125
+ },
126
+ };
127
+ writeConfig(original);
128
+
129
+ webSearchProviderRenameMigration.run(workspaceDir);
130
+
131
+ const config = readConfig();
132
+ expect(config).toEqual(original);
133
+ });
134
+
135
+ test("no-op when config.json does not exist", () => {
136
+ webSearchProviderRenameMigration.run(workspaceDir);
137
+ expect(existsSync(join(workspaceDir, "config.json"))).toBe(false);
138
+ });
139
+
140
+ test("no-op when services key is missing", () => {
141
+ const original = { someOtherKey: true };
142
+ writeConfig(original);
143
+
144
+ webSearchProviderRenameMigration.run(workspaceDir);
145
+
146
+ const config = readConfig();
147
+ expect(config).toEqual(original);
148
+ });
149
+
150
+ test("no-op when web-search section is missing", () => {
151
+ const original = {
152
+ services: {
153
+ inference: {
154
+ mode: "your-own",
155
+ provider: "anthropic",
156
+ model: "claude-opus-4-6",
157
+ },
158
+ },
159
+ };
160
+ writeConfig(original);
161
+
162
+ webSearchProviderRenameMigration.run(workspaceDir);
163
+
164
+ const config = readConfig();
165
+ expect(config).toEqual(original);
166
+ });
167
+
168
+ test("idempotency: running migration twice produces same result", () => {
169
+ writeConfig({
170
+ services: {
171
+ "web-search": {
172
+ mode: "your-own",
173
+ provider: "anthropic-native",
174
+ },
175
+ },
176
+ });
177
+
178
+ webSearchProviderRenameMigration.run(workspaceDir);
179
+ const afterFirst = readConfig();
180
+
181
+ webSearchProviderRenameMigration.run(workspaceDir);
182
+ const afterSecond = readConfig();
183
+
184
+ expect(afterSecond).toEqual(afterFirst);
185
+ const services = afterSecond.services as Record<
186
+ string,
187
+ Record<string, unknown>
188
+ >;
189
+ expect(services["web-search"].provider).toBe("inference-provider-native");
190
+ });
191
+
192
+ test("gracefully handles invalid JSON in config file", () => {
193
+ writeFileSync(join(workspaceDir, "config.json"), "not-valid-json");
194
+
195
+ webSearchProviderRenameMigration.run(workspaceDir);
196
+
197
+ // File should be unchanged
198
+ expect(readFileSync(join(workspaceDir, "config.json"), "utf-8")).toBe(
199
+ "not-valid-json",
200
+ );
201
+ });
202
+
203
+ test("gracefully handles array config", () => {
204
+ writeFileSync(join(workspaceDir, "config.json"), JSON.stringify([1, 2, 3]));
205
+
206
+ webSearchProviderRenameMigration.run(workspaceDir);
207
+
208
+ // File should be unchanged
209
+ const raw = JSON.parse(
210
+ readFileSync(join(workspaceDir, "config.json"), "utf-8"),
211
+ );
212
+ expect(raw).toEqual([1, 2, 3]);
213
+ });
214
+
215
+ test("gracefully handles services as a non-object value", () => {
216
+ const original = { services: "not-an-object" };
217
+ writeConfig(original);
218
+
219
+ webSearchProviderRenameMigration.run(workspaceDir);
220
+
221
+ const config = readConfig();
222
+ expect(config).toEqual(original);
223
+ });
224
+
225
+ test("gracefully handles web-search as a non-object value", () => {
226
+ const original = {
227
+ services: {
228
+ "web-search": "not-an-object",
229
+ },
230
+ };
231
+ writeConfig(original);
232
+
233
+ webSearchProviderRenameMigration.run(workspaceDir);
234
+
235
+ const config = readConfig();
236
+ expect(config).toEqual(original);
237
+ });
238
+
239
+ test("preserves extra fields in web-search config", () => {
240
+ writeConfig({
241
+ services: {
242
+ "web-search": {
243
+ mode: "your-own",
244
+ provider: "anthropic-native",
245
+ extraField: "should-survive",
246
+ },
247
+ },
248
+ });
249
+
250
+ webSearchProviderRenameMigration.run(workspaceDir);
251
+
252
+ const config = readConfig();
253
+ const services = config.services as Record<string, Record<string, unknown>>;
254
+ expect(services["web-search"].provider).toBe("inference-provider-native");
255
+ expect(services["web-search"].extraField).toBe("should-survive");
256
+ expect(services["web-search"].mode).toBe("your-own");
257
+ });
258
+
259
+ test("preserves other top-level config keys", () => {
260
+ writeConfig({
261
+ someTopLevelKey: "value",
262
+ services: {
263
+ inference: {
264
+ mode: "your-own",
265
+ provider: "openai",
266
+ model: "gpt-4o",
267
+ },
268
+ "web-search": {
269
+ mode: "your-own",
270
+ provider: "anthropic-native",
271
+ },
272
+ "custom-service": {
273
+ foo: "bar",
274
+ },
275
+ },
276
+ });
277
+
278
+ webSearchProviderRenameMigration.run(workspaceDir);
279
+
280
+ const config = readConfig();
281
+ expect(config.someTopLevelKey).toBe("value");
282
+
283
+ const services = config.services as Record<string, Record<string, unknown>>;
284
+ expect(services["web-search"].provider).toBe("inference-provider-native");
285
+ expect(services.inference.provider).toBe("openai");
286
+ expect(services["custom-service"]).toEqual({ foo: "bar" });
287
+ });
288
+
289
+ test("gracefully handles services as an array", () => {
290
+ const original = { services: [1, 2, 3] };
291
+ writeConfig(original);
292
+
293
+ webSearchProviderRenameMigration.run(workspaceDir);
294
+
295
+ const config = readConfig();
296
+ expect(config).toEqual(original);
297
+ });
298
+
299
+ test("gracefully handles web-search as an array", () => {
300
+ const original = {
301
+ services: {
302
+ "web-search": [1, 2, 3],
303
+ },
304
+ };
305
+ writeConfig(original);
306
+
307
+ webSearchProviderRenameMigration.run(workspaceDir);
308
+
309
+ const config = readConfig();
310
+ expect(config).toEqual(original);
311
+ });
312
+ });
@@ -0,0 +1,278 @@
1
+ import {
2
+ existsSync,
3
+ mkdirSync,
4
+ mkdtempSync,
5
+ readdirSync,
6
+ readFileSync,
7
+ rmSync,
8
+ writeFileSync,
9
+ } from "node:fs";
10
+ import { tmpdir } from "node:os";
11
+ import { join } from "node:path";
12
+ import { afterAll, beforeEach, describe, expect, mock, test } from "bun:test";
13
+
14
+ // ---------------------------------------------------------------------------
15
+ // Mocks — must come before any imports that depend on them
16
+ // ---------------------------------------------------------------------------
17
+
18
+ const testDir = mkdtempSync(join(tmpdir(), "workspace-migration-009-test-"));
19
+ const workspaceDir = join(testDir, "workspace");
20
+ const conversationsDir = join(workspaceDir, "conversations");
21
+ mkdirSync(conversationsDir, { recursive: true });
22
+
23
+ mock.module("../util/platform.js", () => ({
24
+ getDataDir: () => join(workspaceDir, "data"),
25
+ getWorkspaceDir: () => workspaceDir,
26
+ getConversationsDir: () => conversationsDir,
27
+ isMacOS: () => process.platform === "darwin",
28
+ isLinux: () => process.platform === "linux",
29
+ isWindows: () => process.platform === "win32",
30
+ getPidPath: () => join(testDir, "test.pid"),
31
+ getDbPath: () => join(testDir, "test.db"),
32
+ getLogPath: () => join(testDir, "test.log"),
33
+ ensureDataDir: () => {},
34
+ getRootDir: () => testDir,
35
+ }));
36
+
37
+ mock.module("../util/logger.js", () => ({
38
+ getLogger: () =>
39
+ new Proxy({} as Record<string, unknown>, {
40
+ get: () => () => {},
41
+ }),
42
+ }));
43
+
44
+ mock.module("../config/loader.js", () => ({
45
+ getConfig: () => ({
46
+ ui: {},
47
+ model: "test",
48
+ provider: "test",
49
+ memory: { enabled: false },
50
+ rateLimit: { maxRequestsPerMinute: 0 },
51
+ }),
52
+ }));
53
+
54
+ // ---------------------------------------------------------------------------
55
+ // Imports — after mocks
56
+ // ---------------------------------------------------------------------------
57
+
58
+ import { getConversationDirPath } from "../memory/conversation-disk-view.js";
59
+ import { getDb, initializeDb, resetDb } from "../memory/db.js";
60
+ import {
61
+ attachments,
62
+ conversations,
63
+ messageAttachments,
64
+ messages,
65
+ } from "../memory/schema.js";
66
+ import { backfillConversationDiskViewMigration } from "../workspace/migrations/009-backfill-conversation-disk-view.js";
67
+
68
+ initializeDb();
69
+
70
+ afterAll(() => {
71
+ resetDb();
72
+ try {
73
+ rmSync(testDir, { recursive: true, force: true });
74
+ } catch {
75
+ /* best effort */
76
+ }
77
+ });
78
+
79
+ function resetTables() {
80
+ const db = getDb();
81
+ db.run("DELETE FROM message_attachments");
82
+ db.run("DELETE FROM attachments");
83
+ db.run("DELETE FROM messages");
84
+ db.run("DELETE FROM conversations");
85
+ }
86
+
87
+ function resetConversationsDir() {
88
+ rmSync(conversationsDir, { recursive: true, force: true });
89
+ mkdirSync(conversationsDir, { recursive: true });
90
+ }
91
+
92
+ function seedConversationRows(): {
93
+ conversationId: string;
94
+ conversationCreatedAt: number;
95
+ conversationUpdatedAt: number;
96
+ } {
97
+ const db = getDb();
98
+ const conversationId = "conv-009-backfill";
99
+ const messageId = "msg-009-backfill";
100
+ const attachmentId = "att-009-backfill";
101
+ const conversationCreatedAt = Date.parse("2026-03-18T14:23:00.000Z");
102
+ const messageCreatedAt = Date.parse("2026-03-18T14:24:00.000Z");
103
+ const conversationUpdatedAt = Date.parse("2026-03-18T14:25:00.000Z");
104
+
105
+ db.insert(conversations)
106
+ .values({
107
+ id: conversationId,
108
+ title: "Backfill Test",
109
+ createdAt: conversationCreatedAt,
110
+ updatedAt: conversationUpdatedAt,
111
+ conversationType: "standard",
112
+ source: "user",
113
+ memoryScopeId: "default",
114
+ originChannel: "desktop",
115
+ })
116
+ .run();
117
+
118
+ db.insert(messages)
119
+ .values({
120
+ id: messageId,
121
+ conversationId,
122
+ role: "user",
123
+ content: "Hello from sqlite row",
124
+ createdAt: messageCreatedAt,
125
+ metadata: null,
126
+ })
127
+ .run();
128
+
129
+ db.insert(attachments)
130
+ .values({
131
+ id: attachmentId,
132
+ originalFilename: "note.txt",
133
+ mimeType: "text/plain",
134
+ sizeBytes: 11,
135
+ kind: "document",
136
+ dataBase64: Buffer.from("hello world").toString("base64"),
137
+ contentHash: null,
138
+ thumbnailBase64: null,
139
+ filePath: null,
140
+ createdAt: messageCreatedAt,
141
+ })
142
+ .run();
143
+
144
+ db.insert(messageAttachments)
145
+ .values({
146
+ id: "link-009-backfill",
147
+ messageId,
148
+ attachmentId,
149
+ position: 0,
150
+ createdAt: messageCreatedAt,
151
+ })
152
+ .run();
153
+
154
+ return { conversationId, conversationCreatedAt, conversationUpdatedAt };
155
+ }
156
+
157
+ function toConversationTimestamp(createdAtMs: number): string {
158
+ return new Date(createdAtMs).toISOString().replace(/:/g, "-");
159
+ }
160
+
161
+ describe("009-backfill-conversation-disk-view migration", () => {
162
+ beforeEach(() => {
163
+ resetTables();
164
+ resetConversationsDir();
165
+ });
166
+
167
+ test("materializes disk view from sqlite-only rows and stays idempotent on rerun", () => {
168
+ const { conversationId, conversationCreatedAt, conversationUpdatedAt } =
169
+ seedConversationRows();
170
+ const conversationDir = getConversationDirPath(
171
+ conversationId,
172
+ conversationCreatedAt,
173
+ );
174
+ const metaPath = join(conversationDir, "meta.json");
175
+ const messagesPath = join(conversationDir, "messages.jsonl");
176
+ const attachmentsDir = join(conversationDir, "attachments");
177
+
178
+ // Precondition: only SQLite rows exist, disk view has not been created yet.
179
+ expect(existsSync(conversationDir)).toBe(false);
180
+
181
+ backfillConversationDiskViewMigration.run(workspaceDir);
182
+
183
+ expect(existsSync(conversationDir)).toBe(true);
184
+ expect(existsSync(metaPath)).toBe(true);
185
+ expect(existsSync(messagesPath)).toBe(true);
186
+ expect(existsSync(join(attachmentsDir, "note.txt"))).toBe(true);
187
+
188
+ const meta = JSON.parse(readFileSync(metaPath, "utf-8"));
189
+ expect(meta.id).toBe(conversationId);
190
+ expect(meta.updatedAt).toBe(new Date(conversationUpdatedAt).toISOString());
191
+
192
+ const firstRunLines = readFileSync(messagesPath, "utf-8")
193
+ .trim()
194
+ .split("\n");
195
+ expect(firstRunLines).toHaveLength(1);
196
+ expect(JSON.parse(firstRunLines[0])).toEqual({
197
+ role: "user",
198
+ ts: "2026-03-18T14:24:00.000Z",
199
+ content: "Hello from sqlite row",
200
+ attachments: ["note.txt"],
201
+ });
202
+
203
+ backfillConversationDiskViewMigration.run(workspaceDir);
204
+
205
+ const secondRunLines = readFileSync(messagesPath, "utf-8")
206
+ .trim()
207
+ .split("\n");
208
+ expect(secondRunLines).toHaveLength(1);
209
+ expect(JSON.parse(secondRunLines[0])).toEqual(JSON.parse(firstRunLines[0]));
210
+
211
+ const attachmentFiles = readdirSync(attachmentsDir).sort();
212
+ expect(attachmentFiles).toEqual(["note.txt"]);
213
+ expect(readFileSync(join(attachmentsDir, "note.txt"), "utf-8")).toBe(
214
+ "hello world",
215
+ );
216
+ });
217
+
218
+ test("rebuilds stale legacy-named disk views in-place and stays idempotent", () => {
219
+ const { conversationId, conversationCreatedAt, conversationUpdatedAt } =
220
+ seedConversationRows();
221
+ const timestamp = toConversationTimestamp(conversationCreatedAt);
222
+ const expectedNewDirName = `${timestamp}_${conversationId}`;
223
+ const expectedNewDirPath = join(conversationsDir, expectedNewDirName);
224
+ const legacyDirPath = join(
225
+ conversationsDir,
226
+ `${conversationId}_${timestamp}`,
227
+ );
228
+ const metaPath = join(legacyDirPath, "meta.json");
229
+ const messagesPath = join(legacyDirPath, "messages.jsonl");
230
+ const attachmentsDir = join(legacyDirPath, "attachments");
231
+
232
+ mkdirSync(attachmentsDir, { recursive: true });
233
+ writeFileSync(
234
+ metaPath,
235
+ JSON.stringify(
236
+ {
237
+ id: conversationId,
238
+ title: "Backfill Test",
239
+ type: "standard",
240
+ channel: "desktop",
241
+ createdAt: new Date(conversationCreatedAt).toISOString(),
242
+ updatedAt: new Date(conversationUpdatedAt - 1000).toISOString(),
243
+ },
244
+ null,
245
+ 2,
246
+ ) + "\n",
247
+ );
248
+ writeFileSync(messagesPath, '{"role":"user","content":"stale line"}\n');
249
+ writeFileSync(join(attachmentsDir, "stale.txt"), "stale");
250
+
251
+ backfillConversationDiskViewMigration.run(workspaceDir);
252
+
253
+ expect(existsSync(expectedNewDirPath)).toBe(false);
254
+ expect(existsSync(legacyDirPath)).toBe(true);
255
+ expect(
256
+ JSON.parse(readFileSync(metaPath, "utf-8")).updatedAt,
257
+ ).toBe(new Date(conversationUpdatedAt).toISOString());
258
+ expect(readFileSync(messagesPath, "utf-8").trim().split("\n")).toHaveLength(
259
+ 1,
260
+ );
261
+ expect(JSON.parse(readFileSync(messagesPath, "utf-8").trim())).toEqual({
262
+ role: "user",
263
+ ts: "2026-03-18T14:24:00.000Z",
264
+ content: "Hello from sqlite row",
265
+ attachments: ["note.txt"],
266
+ });
267
+ expect(readdirSync(attachmentsDir).sort()).toEqual(["note.txt"]);
268
+ expect(readFileSync(join(attachmentsDir, "note.txt"), "utf-8")).toBe(
269
+ "hello world",
270
+ );
271
+
272
+ const firstRunMessages = readFileSync(messagesPath, "utf-8");
273
+ backfillConversationDiskViewMigration.run(workspaceDir);
274
+
275
+ expect(readFileSync(messagesPath, "utf-8")).toBe(firstRunMessages);
276
+ expect(readdirSync(attachmentsDir).sort()).toEqual(["note.txt"]);
277
+ });
278
+ });