@vellumai/assistant 0.4.49 → 0.4.51

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 (353) hide show
  1. package/ARCHITECTURE.md +24 -33
  2. package/README.md +3 -3
  3. package/docs/architecture/integrations.md +2 -2
  4. package/docs/architecture/keychain-broker.md +6 -6
  5. package/docs/architecture/memory.md +180 -119
  6. package/knip.json +32 -0
  7. package/package.json +3 -2
  8. package/src/__tests__/agent-loop.test.ts +3 -1
  9. package/src/__tests__/anthropic-provider.test.ts +114 -23
  10. package/src/__tests__/approval-cascade.test.ts +1 -15
  11. package/src/__tests__/approval-routes-http.test.ts +2 -0
  12. package/src/__tests__/assistant-feature-flag-guard.test.ts +0 -23
  13. package/src/__tests__/btw-routes.test.ts +61 -5
  14. package/src/__tests__/canonical-guardian-store.test.ts +95 -0
  15. package/src/__tests__/checker.test.ts +13 -0
  16. package/src/__tests__/config-schema.test.ts +1 -68
  17. package/src/__tests__/config-watcher.test.ts +8 -0
  18. package/src/__tests__/context-memory-e2e.test.ts +11 -100
  19. package/src/__tests__/conversation-routes-guardian-reply.test.ts +8 -0
  20. package/src/__tests__/conversation-routes-slash-commands.test.ts +1 -0
  21. package/src/__tests__/credential-security-e2e.test.ts +1 -0
  22. package/src/__tests__/credential-security-invariants.test.ts +8 -7
  23. package/src/__tests__/credential-vault-unit.test.ts +23 -18
  24. package/src/__tests__/credential-vault.test.ts +30 -18
  25. package/src/__tests__/credentials-cli.test.ts +257 -82
  26. package/src/__tests__/cu-unified-flow.test.ts +532 -0
  27. package/src/__tests__/date-context.test.ts +93 -77
  28. package/src/__tests__/deterministic-verification-control-plane.test.ts +64 -0
  29. package/src/__tests__/guardian-routing-invariants.test.ts +93 -0
  30. package/src/__tests__/history-repair.test.ts +245 -0
  31. package/src/__tests__/host-cu-proxy.test.ts +165 -3
  32. package/src/__tests__/http-user-message-parity.test.ts +1 -0
  33. package/src/__tests__/inbound-invite-redemption.test.ts +36 -7
  34. package/src/__tests__/integration-status.test.ts +31 -30
  35. package/src/__tests__/invite-redemption-service.test.ts +166 -13
  36. package/src/__tests__/invite-routes-http.test.ts +166 -5
  37. package/src/__tests__/keychain-broker-client.test.ts +4 -4
  38. package/src/__tests__/list-messages-attachments.test.ts +193 -0
  39. package/src/__tests__/memory-context-benchmark.benchmark.test.ts +56 -18
  40. package/src/__tests__/memory-lifecycle-e2e.test.ts +244 -387
  41. package/src/__tests__/memory-recall-quality.test.ts +244 -407
  42. package/src/__tests__/memory-regressions.experimental.test.ts +126 -101
  43. package/src/__tests__/memory-regressions.test.ts +477 -2841
  44. package/src/__tests__/memory-retrieval.benchmark.test.ts +33 -150
  45. package/src/__tests__/memory-upsert-concurrency.test.ts +5 -244
  46. package/src/__tests__/mime-builder.test.ts +28 -0
  47. package/src/__tests__/native-web-search.test.ts +1 -0
  48. package/src/__tests__/oauth-cli.test.ts +824 -31
  49. package/src/__tests__/oauth-provider-profiles.test.ts +1 -1
  50. package/src/__tests__/oauth-store.test.ts +363 -17
  51. package/src/__tests__/qdrant-collection-migration.test.ts +53 -8
  52. package/src/__tests__/registry.test.ts +0 -1
  53. package/src/__tests__/relay-server.test.ts +55 -1
  54. package/src/__tests__/schedule-tools.test.ts +32 -0
  55. package/src/__tests__/script-proxy-certs.test.ts +1 -1
  56. package/src/__tests__/secret-onetime-send.test.ts +1 -0
  57. package/src/__tests__/secret-routes-managed-proxy.test.ts +183 -0
  58. package/src/__tests__/secure-keys.test.ts +78 -18
  59. package/src/__tests__/send-endpoint-busy.test.ts +3 -0
  60. package/src/__tests__/server-history-render.test.ts +2 -2
  61. package/src/__tests__/session-abort-tool-results.test.ts +1 -14
  62. package/src/__tests__/session-agent-loop-overflow.test.ts +1583 -0
  63. package/src/__tests__/session-agent-loop.test.ts +19 -15
  64. package/src/__tests__/session-confirmation-signals.test.ts +1 -15
  65. package/src/__tests__/session-error.test.ts +124 -2
  66. package/src/__tests__/session-history-web-search.test.ts +918 -0
  67. package/src/__tests__/session-pre-run-repair.test.ts +1 -14
  68. package/src/__tests__/session-provider-retry-repair.test.ts +25 -28
  69. package/src/__tests__/session-queue.test.ts +37 -27
  70. package/src/__tests__/session-runtime-assembly.test.ts +54 -0
  71. package/src/__tests__/session-slash-known.test.ts +1 -15
  72. package/src/__tests__/session-slash-queue.test.ts +1 -15
  73. package/src/__tests__/session-slash-unknown.test.ts +1 -15
  74. package/src/__tests__/session-workspace-cache-state.test.ts +3 -33
  75. package/src/__tests__/session-workspace-injection.test.ts +3 -37
  76. package/src/__tests__/session-workspace-tool-tracking.test.ts +3 -37
  77. package/src/__tests__/skills-install-extract.test.ts +93 -0
  78. package/src/__tests__/skills.test.ts +2 -2
  79. package/src/__tests__/skillssh-registry.test.ts +451 -0
  80. package/src/__tests__/slack-channel-config.test.ts +10 -8
  81. package/src/__tests__/trust-store.test.ts +15 -0
  82. package/src/__tests__/twilio-config.test.ts +11 -10
  83. package/src/__tests__/twilio-provider.test.ts +9 -4
  84. package/src/__tests__/voice-invite-redemption.test.ts +85 -5
  85. package/src/agent/ax-tree-compaction.test.ts +51 -0
  86. package/src/agent/loop.ts +39 -12
  87. package/src/approvals/AGENTS.md +1 -1
  88. package/src/approvals/guardian-request-resolvers.ts +14 -2
  89. package/src/bundler/compiler-tools.ts +66 -2
  90. package/src/calls/call-domain.ts +134 -3
  91. package/src/calls/call-store.ts +6 -0
  92. package/src/calls/relay-server.ts +44 -6
  93. package/src/calls/relay-setup-router.ts +17 -1
  94. package/src/calls/twilio-config.ts +5 -4
  95. package/src/calls/twilio-provider.ts +14 -9
  96. package/src/calls/twilio-rest.ts +10 -7
  97. package/src/calls/types.ts +3 -1
  98. package/src/cli/commands/config.ts +14 -9
  99. package/src/cli/commands/contacts.ts +3 -0
  100. package/src/cli/commands/credentials.ts +170 -174
  101. package/src/cli/commands/doctor.ts +11 -8
  102. package/src/cli/commands/keys.ts +9 -9
  103. package/src/cli/commands/mcp.ts +46 -59
  104. package/src/cli/commands/memory.ts +16 -165
  105. package/src/cli/commands/oauth/apps.ts +68 -10
  106. package/src/cli/commands/oauth/connections.ts +475 -105
  107. package/src/cli/commands/oauth/index.ts +3 -3
  108. package/src/cli/commands/oauth/providers.ts +18 -4
  109. package/src/cli/commands/sessions.ts +5 -2
  110. package/src/cli/commands/skills.ts +173 -1
  111. package/src/cli/http-client.ts +0 -20
  112. package/src/cli/main-screen.tsx +2 -2
  113. package/src/cli/program.ts +5 -6
  114. package/src/cli.ts +20 -22
  115. package/src/config/__tests__/feature-flag-registry-bundled.test.ts +39 -0
  116. package/src/config/bundled-skills/computer-use/TOOLS.json +1 -1
  117. package/src/config/bundled-skills/computer-use/tools/computer-use-observe.ts +12 -0
  118. package/src/config/bundled-skills/contacts/SKILL.md +35 -11
  119. package/src/config/bundled-skills/contacts/tools/google-contacts.ts +1 -1
  120. package/src/config/bundled-skills/gmail/SKILL.md +1 -1
  121. package/src/config/bundled-skills/gmail/TOOLS.json +52 -0
  122. package/src/config/bundled-skills/gmail/tools/gmail-archive.ts +13 -3
  123. package/src/config/bundled-skills/gmail/tools/gmail-attachments.ts +9 -2
  124. package/src/config/bundled-skills/gmail/tools/gmail-draft.ts +5 -1
  125. package/src/config/bundled-skills/gmail/tools/gmail-filters.ts +5 -1
  126. package/src/config/bundled-skills/gmail/tools/gmail-follow-up.ts +5 -1
  127. package/src/config/bundled-skills/gmail/tools/gmail-forward.ts +5 -1
  128. package/src/config/bundled-skills/gmail/tools/gmail-label.ts +9 -2
  129. package/src/config/bundled-skills/gmail/tools/gmail-outreach-scan.ts +5 -1
  130. package/src/config/bundled-skills/gmail/tools/gmail-send-draft.ts +5 -1
  131. package/src/config/bundled-skills/gmail/tools/gmail-sender-digest.ts +5 -1
  132. package/src/config/bundled-skills/gmail/tools/gmail-trash.ts +5 -1
  133. package/src/config/bundled-skills/gmail/tools/gmail-unsubscribe.ts +5 -1
  134. package/src/config/bundled-skills/gmail/tools/gmail-vacation.ts +5 -1
  135. package/src/config/bundled-skills/google-calendar/TOOLS.json +20 -0
  136. package/src/config/bundled-skills/google-calendar/tools/calendar-check-availability.ts +2 -1
  137. package/src/config/bundled-skills/google-calendar/tools/calendar-create-event.ts +2 -1
  138. package/src/config/bundled-skills/google-calendar/tools/calendar-get-event.ts +2 -1
  139. package/src/config/bundled-skills/google-calendar/tools/calendar-list-events.ts +2 -1
  140. package/src/config/bundled-skills/google-calendar/tools/calendar-rsvp.ts +2 -1
  141. package/src/config/bundled-skills/google-calendar/tools/shared.ts +8 -2
  142. package/src/config/bundled-skills/messaging/SKILL.md +1 -1
  143. package/src/config/bundled-skills/messaging/tools/messaging-analyze-style.ts +2 -2
  144. package/src/config/bundled-skills/messaging/tools/messaging-archive-by-sender.ts +2 -2
  145. package/src/config/bundled-skills/messaging/tools/messaging-auth-test.ts +2 -2
  146. package/src/config/bundled-skills/messaging/tools/messaging-list-conversations.ts +2 -2
  147. package/src/config/bundled-skills/messaging/tools/messaging-mark-read.ts +2 -2
  148. package/src/config/bundled-skills/messaging/tools/messaging-read.ts +2 -2
  149. package/src/config/bundled-skills/messaging/tools/messaging-search.ts +2 -2
  150. package/src/config/bundled-skills/messaging/tools/messaging-send.ts +2 -2
  151. package/src/config/bundled-skills/messaging/tools/messaging-sender-digest.ts +2 -2
  152. package/src/config/bundled-skills/messaging/tools/shared.ts +7 -5
  153. package/src/config/bundled-skills/slack/tools/shared.ts +1 -1
  154. package/src/config/bundled-skills/slack/tools/slack-add-reaction.ts +1 -1
  155. package/src/config/bundled-skills/slack/tools/slack-channel-details.ts +1 -1
  156. package/src/config/bundled-skills/slack/tools/slack-delete-message.ts +1 -1
  157. package/src/config/bundled-skills/slack/tools/slack-edit-message.ts +1 -1
  158. package/src/config/bundled-skills/slack/tools/slack-leave-channel.ts +1 -1
  159. package/src/config/bundled-skills/slack/tools/slack-scan-digest.ts +1 -1
  160. package/src/config/bundled-tool-registry.ts +2 -5
  161. package/src/config/loader.ts +6 -42
  162. package/src/config/schema.ts +1 -12
  163. package/src/config/schemas/memory-lifecycle.ts +0 -9
  164. package/src/config/schemas/memory-processing.ts +0 -180
  165. package/src/config/schemas/memory-retrieval.ts +32 -104
  166. package/src/config/schemas/memory.ts +0 -10
  167. package/src/config/types.ts +0 -4
  168. package/src/contacts/contact-store.ts +39 -2
  169. package/src/contacts/contacts-write.ts +9 -0
  170. package/src/context/window-manager.ts +4 -1
  171. package/src/daemon/config-watcher.ts +55 -2
  172. package/src/daemon/daemon-control.ts +1 -1
  173. package/src/daemon/date-context.ts +114 -31
  174. package/src/daemon/handlers/config-ingress.ts +2 -2
  175. package/src/daemon/handlers/config-slack-channel.ts +59 -39
  176. package/src/daemon/handlers/config-telegram.ts +23 -14
  177. package/src/daemon/handlers/session-history.ts +1 -358
  178. package/src/daemon/handlers/sessions.ts +18 -13
  179. package/src/daemon/handlers/shared.ts +3 -17
  180. package/src/daemon/handlers/skills.ts +20 -1
  181. package/src/daemon/history-repair.ts +72 -8
  182. package/src/daemon/host-cu-proxy.ts +55 -26
  183. package/src/daemon/lifecycle.ts +39 -4
  184. package/src/daemon/mcp-reload-service.ts +2 -2
  185. package/src/daemon/message-types/computer-use.ts +1 -12
  186. package/src/daemon/message-types/memory.ts +4 -16
  187. package/src/daemon/message-types/messages.ts +1 -0
  188. package/src/daemon/message-types/sessions.ts +4 -42
  189. package/src/daemon/server.ts +6 -1
  190. package/src/daemon/session-agent-loop-handlers.ts +38 -0
  191. package/src/daemon/session-agent-loop.ts +334 -48
  192. package/src/daemon/session-error.ts +89 -6
  193. package/src/daemon/session-history.ts +17 -7
  194. package/src/daemon/session-media-retry.ts +6 -2
  195. package/src/daemon/session-memory.ts +69 -149
  196. package/src/daemon/session-process.ts +10 -1
  197. package/src/daemon/session-runtime-assembly.ts +49 -19
  198. package/src/daemon/session-slash.ts +3 -5
  199. package/src/daemon/session-surfaces.ts +4 -1
  200. package/src/daemon/session-tool-setup.ts +7 -1
  201. package/src/daemon/session.ts +12 -2
  202. package/src/email/providers/index.ts +2 -2
  203. package/src/instrument.ts +61 -1
  204. package/src/media/avatar-router.ts +1 -1
  205. package/src/memory/admin.ts +2 -191
  206. package/src/memory/canonical-guardian-store.ts +38 -2
  207. package/src/memory/conversation-crud.ts +0 -33
  208. package/src/memory/conversation-queries.ts +25 -83
  209. package/src/memory/db-init.ts +32 -0
  210. package/src/memory/embedding-backend.ts +84 -8
  211. package/src/memory/embedding-types.ts +9 -1
  212. package/src/memory/indexer.ts +7 -46
  213. package/src/memory/invite-store.ts +19 -0
  214. package/src/memory/items-extractor.ts +274 -76
  215. package/src/memory/job-handlers/backfill.ts +2 -127
  216. package/src/memory/job-handlers/cleanup.ts +2 -16
  217. package/src/memory/job-handlers/extraction.ts +2 -138
  218. package/src/memory/job-handlers/index-maintenance.ts +1 -6
  219. package/src/memory/job-handlers/summarization.ts +3 -148
  220. package/src/memory/job-utils.ts +21 -59
  221. package/src/memory/jobs-store.ts +1 -159
  222. package/src/memory/jobs-worker.ts +9 -52
  223. package/src/memory/migrations/104-core-indexes.ts +3 -3
  224. package/src/memory/migrations/149-oauth-tables.ts +2 -0
  225. package/src/memory/migrations/150-oauth-apps-client-secret-path.ts +98 -0
  226. package/src/memory/migrations/151-oauth-providers-ping-url.ts +11 -0
  227. package/src/memory/migrations/152-memory-item-supersession.ts +44 -0
  228. package/src/memory/migrations/153-drop-entity-tables.ts +15 -0
  229. package/src/memory/migrations/154-drop-fts.ts +20 -0
  230. package/src/memory/migrations/155-drop-conflicts.ts +7 -0
  231. package/src/memory/migrations/156-call-session-invite-metadata.ts +24 -0
  232. package/src/memory/migrations/157-invite-contact-id.ts +104 -0
  233. package/src/memory/migrations/index.ts +8 -0
  234. package/src/memory/migrations/registry.ts +6 -0
  235. package/src/memory/qdrant-client.ts +148 -51
  236. package/src/memory/raw-query.ts +1 -1
  237. package/src/memory/retriever.test.ts +294 -273
  238. package/src/memory/retriever.ts +421 -645
  239. package/src/memory/schema/calls.ts +2 -0
  240. package/src/memory/schema/contacts.ts +1 -0
  241. package/src/memory/schema/memory-core.ts +3 -48
  242. package/src/memory/schema/oauth.ts +2 -0
  243. package/src/memory/search/formatting.ts +263 -176
  244. package/src/memory/search/lexical.ts +1 -254
  245. package/src/memory/search/ranking.ts +0 -455
  246. package/src/memory/search/semantic.ts +100 -14
  247. package/src/memory/search/staleness.ts +47 -0
  248. package/src/memory/search/tier-classifier.ts +21 -0
  249. package/src/memory/search/types.ts +15 -77
  250. package/src/memory/task-memory-cleanup.ts +4 -6
  251. package/src/messaging/provider.ts +1 -1
  252. package/src/messaging/providers/gmail/adapter.ts +1 -1
  253. package/src/messaging/providers/gmail/mime-builder.ts +17 -7
  254. package/src/messaging/providers/telegram-bot/adapter.ts +17 -8
  255. package/src/messaging/providers/whatsapp/adapter.ts +13 -9
  256. package/src/messaging/registry.ts +9 -5
  257. package/src/oauth/byo-connection.test.ts +40 -25
  258. package/src/oauth/connect-orchestrator.ts +4 -10
  259. package/src/oauth/connection-resolver.ts +20 -6
  260. package/src/oauth/manual-token-connection.ts +5 -5
  261. package/src/oauth/oauth-store.ts +183 -31
  262. package/src/oauth/platform-connection.test.ts +1 -1
  263. package/src/oauth/provider-behaviors.ts +503 -4
  264. package/src/oauth/seed-providers.ts +214 -8
  265. package/src/oauth/token-persistence.ts +31 -16
  266. package/src/permissions/defaults.ts +1 -0
  267. package/src/permissions/trust-store.ts +23 -1
  268. package/src/playbooks/playbook-compiler.ts +1 -1
  269. package/src/prompts/system-prompt.ts +18 -2
  270. package/src/providers/anthropic/client.ts +56 -126
  271. package/src/providers/types.ts +7 -1
  272. package/src/runtime/AGENTS.md +9 -0
  273. package/src/runtime/auth/route-policy.ts +6 -3
  274. package/src/runtime/channel-readiness-service.ts +48 -40
  275. package/src/runtime/guardian-reply-router.ts +24 -22
  276. package/src/runtime/http-server.ts +2 -2
  277. package/src/runtime/http-types.ts +2 -0
  278. package/src/runtime/invite-redemption-service.ts +72 -12
  279. package/src/runtime/invite-service.ts +43 -0
  280. package/src/runtime/middleware/twilio-validation.ts +1 -1
  281. package/src/runtime/pending-interactions.ts +2 -2
  282. package/src/runtime/routes/brain-graph-routes.ts +10 -90
  283. package/src/runtime/routes/btw-routes.ts +10 -5
  284. package/src/runtime/routes/conversation-routes.ts +56 -11
  285. package/src/runtime/routes/inbound-stages/acl-enforcement.ts +21 -12
  286. package/src/runtime/routes/integrations/slack/channel.ts +2 -2
  287. package/src/runtime/routes/integrations/telegram.ts +2 -2
  288. package/src/runtime/routes/integrations/twilio.ts +17 -17
  289. package/src/runtime/routes/invite-routes.ts +29 -4
  290. package/src/runtime/routes/memory-item-routes.test.ts +754 -0
  291. package/src/runtime/routes/memory-item-routes.ts +503 -0
  292. package/src/runtime/routes/secret-routes.ts +17 -0
  293. package/src/runtime/routes/session-management-routes.ts +3 -3
  294. package/src/runtime/routes/settings-routes.ts +3 -3
  295. package/src/runtime/routes/trust-rules-routes.ts +14 -0
  296. package/src/runtime/routes/workspace-routes.ts +9 -4
  297. package/src/runtime/routes/workspace-utils.ts +8 -2
  298. package/src/schedule/integration-status.ts +26 -19
  299. package/src/security/keychain-broker-client.ts +17 -4
  300. package/src/security/oauth2.ts +6 -7
  301. package/src/security/secure-keys.ts +44 -19
  302. package/src/security/token-manager.ts +46 -39
  303. package/src/services/vercel-deploy.ts +0 -24
  304. package/src/signals/confirm.ts +78 -0
  305. package/src/signals/mcp-reload.ts +18 -0
  306. package/src/skills/catalog-install.ts +74 -18
  307. package/src/skills/skillssh-registry.ts +503 -0
  308. package/src/tools/assets/search.ts +5 -1
  309. package/src/tools/computer-use/definitions.ts +0 -10
  310. package/src/tools/computer-use/registry.ts +1 -1
  311. package/src/tools/credentials/vault.ts +22 -7
  312. package/src/tools/memory/definitions.ts +4 -13
  313. package/src/tools/memory/handlers.test.ts +83 -103
  314. package/src/tools/memory/handlers.ts +50 -85
  315. package/src/tools/network/script-proxy/session-manager.ts +8 -8
  316. package/src/tools/schedule/create.ts +10 -3
  317. package/src/tools/schedule/update.ts +8 -1
  318. package/src/tools/skills/load.ts +25 -2
  319. package/src/watcher/provider-types.ts +1 -1
  320. package/src/watcher/providers/github.ts +1 -1
  321. package/src/watcher/providers/gmail.ts +3 -3
  322. package/src/watcher/providers/google-calendar.ts +3 -3
  323. package/src/watcher/providers/linear.ts +1 -1
  324. package/src/__tests__/clarification-resolver.test.ts +0 -193
  325. package/src/__tests__/conflict-intent-tokenization.test.ts +0 -160
  326. package/src/__tests__/conflict-policy.test.ts +0 -269
  327. package/src/__tests__/conflict-store.test.ts +0 -372
  328. package/src/__tests__/contradiction-checker.test.ts +0 -361
  329. package/src/__tests__/entity-extractor.test.ts +0 -211
  330. package/src/__tests__/entity-search.test.ts +0 -1117
  331. package/src/__tests__/profile-compiler.test.ts +0 -392
  332. package/src/__tests__/session-conflict-gate.test.ts +0 -1228
  333. package/src/__tests__/session-profile-injection.test.ts +0 -557
  334. package/src/config/bundled-skills/knowledge-graph/SKILL.md +0 -25
  335. package/src/config/bundled-skills/knowledge-graph/TOOLS.json +0 -66
  336. package/src/config/bundled-skills/knowledge-graph/tools/graph-query.ts +0 -211
  337. package/src/daemon/session-conflict-gate.ts +0 -167
  338. package/src/daemon/session-dynamic-profile.ts +0 -77
  339. package/src/memory/clarification-resolver.ts +0 -417
  340. package/src/memory/conflict-intent.ts +0 -205
  341. package/src/memory/conflict-policy.ts +0 -127
  342. package/src/memory/conflict-store.ts +0 -410
  343. package/src/memory/contradiction-checker.ts +0 -508
  344. package/src/memory/entity-extractor.ts +0 -535
  345. package/src/memory/format-recall.ts +0 -47
  346. package/src/memory/fts-reconciler.ts +0 -165
  347. package/src/memory/job-handlers/conflict.ts +0 -200
  348. package/src/memory/profile-compiler.ts +0 -195
  349. package/src/memory/recall-cache.ts +0 -117
  350. package/src/memory/search/entity.ts +0 -535
  351. package/src/memory/search/query-expansion.test.ts +0 -70
  352. package/src/memory/search/query-expansion.ts +0 -118
  353. package/src/runtime/routes/mcp-routes.ts +0 -20
@@ -1,392 +0,0 @@
1
- import { mkdtempSync, rmSync } from "node:fs";
2
- import { tmpdir } from "node:os";
3
- import { join } from "node:path";
4
- import { afterAll, beforeEach, describe, expect, mock, test } from "bun:test";
5
-
6
- const testDir = mkdtempSync(join(tmpdir(), "profile-compiler-test-"));
7
-
8
- let profileEnabled = false;
9
- let profileMaxInjectTokens = 800;
10
-
11
- mock.module("../util/platform.js", () => ({
12
- getDataDir: () => testDir,
13
- isMacOS: () => process.platform === "darwin",
14
- isLinux: () => process.platform === "linux",
15
- isWindows: () => process.platform === "win32",
16
- getPidPath: () => join(testDir, "test.pid"),
17
- getDbPath: () => join(testDir, "test.db"),
18
- getLogPath: () => join(testDir, "test.log"),
19
- ensureDataDir: () => {},
20
- }));
21
-
22
- mock.module("../util/logger.js", () => ({
23
- getLogger: () =>
24
- new Proxy({} as Record<string, unknown>, {
25
- get: () => () => {},
26
- }),
27
- }));
28
-
29
- import { DEFAULT_CONFIG } from "../config/defaults.js";
30
-
31
- mock.module("../config/loader.js", () => ({
32
- getConfig: () => ({
33
- ...DEFAULT_CONFIG,
34
- memory: {
35
- ...DEFAULT_CONFIG.memory,
36
- profile: {
37
- enabled: profileEnabled,
38
- maxInjectTokens: profileMaxInjectTokens,
39
- },
40
- },
41
- }),
42
- }));
43
-
44
- import { estimateTextTokens } from "../context/token-estimator.js";
45
- import { getDb, initializeDb, resetDb } from "../memory/db.js";
46
- import { compileDynamicProfile } from "../memory/profile-compiler.js";
47
- import { memoryItems } from "../memory/schema.js";
48
-
49
- initializeDb();
50
-
51
- afterAll(() => {
52
- resetDb();
53
- try {
54
- rmSync(testDir, { recursive: true });
55
- } catch {
56
- /* best effort */
57
- }
58
- });
59
-
60
- function resetTables() {
61
- const db = getDb();
62
- db.run("DELETE FROM memory_item_sources");
63
- db.run("DELETE FROM memory_items");
64
- }
65
-
66
- function insertItem(input: {
67
- id: string;
68
- kind: string;
69
- subject: string;
70
- statement: string;
71
- verificationState: string;
72
- status?: string;
73
- invalidAt?: number | null;
74
- scopeId?: string;
75
- importance?: number;
76
- }) {
77
- const now = Date.now();
78
- const db = getDb();
79
- db.insert(memoryItems)
80
- .values({
81
- id: input.id,
82
- kind: input.kind,
83
- subject: input.subject,
84
- statement: input.statement,
85
- status: input.status ?? "active",
86
- confidence: 0.8,
87
- importance: input.importance ?? 0.6,
88
- fingerprint: `fp-${input.id}`,
89
- verificationState: input.verificationState,
90
- scopeId: input.scopeId ?? "default",
91
- firstSeenAt: now - 1000,
92
- lastSeenAt: now,
93
- validFrom: now - 1000,
94
- invalidAt: input.invalidAt ?? null,
95
- })
96
- .run();
97
- }
98
-
99
- describe("profile-compiler", () => {
100
- beforeEach(() => {
101
- resetTables();
102
- profileEnabled = false;
103
- profileMaxInjectTokens = 800;
104
- });
105
-
106
- test("returns empty profile when feature is disabled", () => {
107
- insertItem({
108
- id: "profile-disabled-1",
109
- kind: "profile",
110
- subject: "timezone",
111
- statement: "User timezone is PST.",
112
- verificationState: "user_confirmed",
113
- });
114
-
115
- const compiled = compileDynamicProfile();
116
- expect(compiled.text).toBe("");
117
- expect(compiled.selectedCount).toBe(0);
118
- expect(compiled.tokenEstimate).toBe(0);
119
- });
120
-
121
- test("selects active trusted memories and prefers stronger verification states", () => {
122
- profileEnabled = true;
123
-
124
- insertItem({
125
- id: "profile-strong",
126
- kind: "preference",
127
- subject: "package manager",
128
- statement: "Use pnpm for workspace installs.",
129
- verificationState: "user_confirmed",
130
- importance: 0.9,
131
- });
132
- insertItem({
133
- id: "profile-weak",
134
- kind: "preference",
135
- subject: "package manager",
136
- statement: "Use npm for workspace installs.",
137
- verificationState: "assistant_inferred",
138
- importance: 0.7,
139
- });
140
- insertItem({
141
- id: "profile-reported",
142
- kind: "profile",
143
- subject: "timezone",
144
- statement: "Timezone is America/Los_Angeles.",
145
- verificationState: "user_reported",
146
- importance: 0.8,
147
- });
148
- insertItem({
149
- id: "profile-superseded",
150
- kind: "profile",
151
- subject: "location",
152
- statement: "Location is Seattle.",
153
- verificationState: "user_confirmed",
154
- status: "superseded",
155
- });
156
- insertItem({
157
- id: "profile-invalid",
158
- kind: "profile",
159
- subject: "editor",
160
- statement: "Primary editor is Neovim.",
161
- verificationState: "user_confirmed",
162
- invalidAt: Date.now(),
163
- });
164
- insertItem({
165
- id: "profile-untrusted",
166
- kind: "profile",
167
- subject: "phone",
168
- statement: "Phone number is 555-0100.",
169
- verificationState: "legacy_import",
170
- });
171
- insertItem({
172
- id: "profile-project",
173
- kind: "project",
174
- subject: "repo",
175
- statement: "Project uses TypeScript.",
176
- verificationState: "user_confirmed",
177
- });
178
-
179
- const compiled = compileDynamicProfile();
180
- expect(compiled.selectedCount).toBe(2);
181
- expect(compiled.text).toContain("package manager: Use pnpm");
182
- expect(compiled.text).toContain(
183
- "timezone: Timezone is America/Los_Angeles",
184
- );
185
- expect(compiled.text).not.toContain("Use npm");
186
- expect(compiled.text).not.toContain("Location is Seattle");
187
- expect(compiled.text).not.toContain("Project uses TypeScript");
188
- });
189
-
190
- test("enforces strict token cap", () => {
191
- profileEnabled = true;
192
- profileMaxInjectTokens = 500;
193
-
194
- insertItem({
195
- id: "profile-budget-1",
196
- kind: "profile",
197
- subject: "timezone",
198
- statement: "Timezone is Pacific time with daylight savings observed.",
199
- verificationState: "user_confirmed",
200
- importance: 0.9,
201
- });
202
- insertItem({
203
- id: "profile-budget-2",
204
- kind: "preference",
205
- subject: "coding style",
206
- statement: "Prefers explicit types and no wildcard exports.",
207
- verificationState: "user_confirmed",
208
- importance: 0.8,
209
- });
210
- insertItem({
211
- id: "profile-budget-3",
212
- kind: "constraint",
213
- subject: "deployment",
214
- statement: "Never deploy on Friday afternoons.",
215
- verificationState: "user_confirmed",
216
- importance: 0.7,
217
- });
218
-
219
- const full = compileDynamicProfile({ maxInjectTokensOverride: 500 });
220
- expect(full.selectedCount).toBeGreaterThan(1);
221
-
222
- const tightBudget = Math.max(1, full.tokenEstimate - 5);
223
- const limited = compileDynamicProfile({
224
- maxInjectTokensOverride: tightBudget,
225
- });
226
-
227
- expect(limited.tokenEstimate).toBeLessThanOrEqual(tightBudget);
228
- expect(estimateTextTokens(limited.text)).toBeLessThanOrEqual(tightBudget);
229
- expect(limited.selectedCount).toBeLessThan(full.selectedCount);
230
- });
231
-
232
- test("without includeDefaultFallback, queries only the specified scope", () => {
233
- profileEnabled = true;
234
-
235
- // Item in 'default' scope
236
- insertItem({
237
- id: "fb-default-only",
238
- kind: "profile",
239
- subject: "timezone",
240
- statement: "Timezone is America/New_York.",
241
- verificationState: "user_confirmed",
242
- scopeId: "default",
243
- });
244
- // Item in 'project-x' scope
245
- insertItem({
246
- id: "fb-project-only",
247
- kind: "preference",
248
- subject: "language",
249
- statement: "Prefers TypeScript.",
250
- verificationState: "user_confirmed",
251
- scopeId: "project-x",
252
- });
253
-
254
- // Query project-x WITHOUT fallback — should only see the project-x item
255
- const compiled = compileDynamicProfile({ scopeId: "project-x" });
256
- expect(compiled.selectedCount).toBe(1);
257
- expect(compiled.text).toContain("language: Prefers TypeScript");
258
- expect(compiled.text).not.toContain("timezone");
259
- });
260
-
261
- test("includeDefaultFallback: true with non-default scope queries both scopes", () => {
262
- profileEnabled = true;
263
-
264
- insertItem({
265
- id: "fb-default-tz",
266
- kind: "profile",
267
- subject: "timezone",
268
- statement: "Timezone is America/New_York.",
269
- verificationState: "user_confirmed",
270
- scopeId: "default",
271
- });
272
- insertItem({
273
- id: "fb-proj-lang",
274
- kind: "preference",
275
- subject: "language",
276
- statement: "Prefers TypeScript.",
277
- verificationState: "user_confirmed",
278
- scopeId: "project-x",
279
- });
280
-
281
- const compiled = compileDynamicProfile({
282
- scopeId: "project-x",
283
- includeDefaultFallback: true,
284
- });
285
- expect(compiled.selectedCount).toBe(2);
286
- expect(compiled.text).toContain("timezone: Timezone is America/New_York");
287
- expect(compiled.text).toContain("language: Prefers TypeScript");
288
- });
289
-
290
- test("includeDefaultFallback: true with default scope does not duplicate", () => {
291
- profileEnabled = true;
292
-
293
- insertItem({
294
- id: "fb-default-nodup",
295
- kind: "profile",
296
- subject: "timezone",
297
- statement: "Timezone is America/Chicago.",
298
- verificationState: "user_confirmed",
299
- scopeId: "default",
300
- });
301
-
302
- // When scopeId is already 'default', fallback should be a no-op — still just queries 'default'
303
- const compiled = compileDynamicProfile({
304
- scopeId: "default",
305
- includeDefaultFallback: true,
306
- });
307
- expect(compiled.selectedCount).toBe(1);
308
- expect(compiled.text).toContain("timezone: Timezone is America/Chicago");
309
- });
310
-
311
- test("includeDefaultFallback: scoped entry wins over default with same subject", () => {
312
- profileEnabled = true;
313
-
314
- // Default scope entry — higher trust/importance so it would normally rank first
315
- insertItem({
316
- id: "fb-default-lang",
317
- kind: "preference",
318
- subject: "language",
319
- statement: "Prefers JavaScript.",
320
- verificationState: "user_confirmed",
321
- scopeId: "default",
322
- importance: 0.95,
323
- });
324
- // Scoped entry — lower importance but should still win because it is scoped
325
- insertItem({
326
- id: "fb-proj-lang",
327
- kind: "preference",
328
- subject: "language",
329
- statement: "Prefers TypeScript.",
330
- verificationState: "assistant_inferred",
331
- scopeId: "project-x",
332
- importance: 0.5,
333
- });
334
- // Default-only entry with no scoped counterpart — should still appear (gap-filling)
335
- insertItem({
336
- id: "fb-default-tz",
337
- kind: "profile",
338
- subject: "timezone",
339
- statement: "Timezone is America/New_York.",
340
- verificationState: "user_confirmed",
341
- scopeId: "default",
342
- });
343
-
344
- const compiled = compileDynamicProfile({
345
- scopeId: "project-x",
346
- includeDefaultFallback: true,
347
- });
348
-
349
- // Scoped entry should win deduplication for 'language'
350
- expect(compiled.text).toContain("language: Prefers TypeScript");
351
- expect(compiled.text).not.toContain("Prefers JavaScript");
352
- // Default-only entry should still fill in as fallback
353
- expect(compiled.text).toContain("timezone: Timezone is America/New_York");
354
- expect(compiled.selectedCount).toBe(2);
355
- });
356
-
357
- test("uses lower-ranked fallback for same subject when top candidate exceeds budget", () => {
358
- profileEnabled = true;
359
-
360
- insertItem({
361
- id: "profile-long-primary",
362
- kind: "profile",
363
- subject: "deployment policy",
364
- statement:
365
- "Prefer geographically isolated blue-green rollout windows with mandatory canary burn-in and staged health-check gates before each region is promoted.",
366
- verificationState: "user_confirmed",
367
- importance: 0.95,
368
- });
369
- insertItem({
370
- id: "profile-short-fallback",
371
- kind: "profile",
372
- subject: "deployment policy",
373
- statement: "Deploy only on weekdays.",
374
- verificationState: "user_confirmed",
375
- importance: 0.7,
376
- });
377
-
378
- const budget =
379
- estimateTextTokens(
380
- "<dynamic-user-profile>\n- deployment policy: Deploy only on weekdays.\n</dynamic-user-profile>",
381
- ) + 2;
382
- const compiled = compileDynamicProfile({ maxInjectTokensOverride: budget });
383
-
384
- expect(compiled.tokenEstimate).toBeLessThanOrEqual(budget);
385
- expect(compiled.text).toContain(
386
- "deployment policy: Deploy only on weekdays.",
387
- );
388
- expect(compiled.text).not.toContain(
389
- "geographically isolated blue-green rollout",
390
- );
391
- });
392
- });