@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,557 +0,0 @@
1
- import { beforeEach, describe, expect, mock, test } from "bun:test";
2
-
3
- import type { AgentEvent } from "../agent/loop.js";
4
- import type { ServerMessage } from "../daemon/message-protocol.js";
5
- import type { Message, ProviderResponse } from "../providers/types.js";
6
-
7
- let runCalls: Message[][] = [];
8
- let profileCompilerCalls = 0;
9
- let profileCompilerArgs: Array<Record<string, unknown>> = [];
10
- let recallArgs: Array<Record<string, unknown>> = [];
11
- let profileEnabled = true;
12
- let memoryEnabled = true;
13
- let profileText =
14
- "<dynamic-user-profile>\n- timezone: America/Los_Angeles\n</dynamic-user-profile>";
15
-
16
- const persistedMessages: Array<{
17
- id: string;
18
- role: string;
19
- content: string;
20
- createdAt: number;
21
- }> = [];
22
-
23
- mock.module("../util/logger.js", () => ({
24
- getLogger: () =>
25
- new Proxy({} as Record<string, unknown>, { get: () => () => {} }),
26
- }));
27
-
28
- mock.module("../util/platform.js", () => ({
29
- getDataDir: () => "/tmp",
30
- }));
31
-
32
- mock.module("../memory/guardian-action-store.js", () => ({
33
- getPendingDeliveryByConversation: () => null,
34
- getGuardianActionRequest: () => null,
35
- resolveGuardianActionRequest: () => {},
36
- }));
37
-
38
- mock.module("../providers/registry.js", () => ({
39
- getProvider: () => ({ name: "mock-provider" }),
40
- initializeProviders: () => {},
41
- }));
42
-
43
- mock.module("../config/loader.js", () => ({
44
- getConfig: () => ({
45
- ui: {},
46
-
47
- provider: "mock-provider",
48
- maxTokens: 4096,
49
- thinking: false,
50
- contextWindow: {
51
- enabled: true,
52
- maxInputTokens: 100000,
53
- targetBudgetRatio: 0.30,
54
- compactThreshold: 0.8, summaryBudgetRatio: 0.05,
55
- overflowRecovery: {
56
- enabled: true,
57
- safetyMarginRatio: 0.05,
58
- maxAttempts: 3,
59
- interactiveLatestTurnCompression: "summarize",
60
- nonInteractiveLatestTurnCompression: "truncate",
61
- },
62
- },
63
- rateLimit: { maxRequestsPerMinute: 0, maxTokensPerSession: 0 },
64
- apiKeys: {},
65
- daemon: {
66
- startupSocketWaitMs: 5000,
67
- stopTimeoutMs: 5000,
68
- sigkillGracePeriodMs: 2000,
69
- titleGenerationMaxTokens: 30,
70
- standaloneRecording: true,
71
- },
72
- memory: {
73
- enabled: memoryEnabled,
74
- retrieval: {
75
- injectionStrategy: "prepend_user_block",
76
- dynamicBudget: {
77
- enabled: false,
78
- minInjectTokens: 1200,
79
- maxInjectTokens: 10000,
80
- targetHeadroomTokens: 10000,
81
- },
82
- },
83
- conflicts: {
84
- enabled: false,
85
- gateMode: "soft",
86
- resolverLlmTimeoutMs: 250,
87
- relevanceThreshold: 0.2,
88
- },
89
- profile: {
90
- enabled: profileEnabled,
91
- maxInjectTokens: 300,
92
- },
93
- },
94
- }),
95
- loadRawConfig: () => ({}),
96
- saveRawConfig: () => {},
97
- invalidateConfigCache: () => {},
98
- }));
99
-
100
- mock.module("../prompts/system-prompt.js", () => ({
101
- buildSystemPrompt: () => "system prompt",
102
- }));
103
-
104
- mock.module("../config/skills.js", () => ({
105
- loadSkillCatalog: () => [],
106
- loadSkillBySelector: () => ({ skill: null }),
107
- ensureSkillIcon: async () => null,
108
- }));
109
-
110
- mock.module("../config/skill-state.js", () => ({
111
- resolveSkillStates: () => [],
112
- }));
113
-
114
- mock.module("../skills/slash-commands.js", () => ({
115
- buildInvocableSlashCatalog: () => new Map(),
116
- resolveSlashSkillCommand: () => ({ kind: "not_slash" }),
117
- rewriteKnownSlashCommandPrompt: () => "",
118
- parseSlashCandidate: () => ({ kind: "not_slash" }),
119
- }));
120
-
121
- mock.module("../permissions/trust-store.js", () => ({
122
- addRule: () => {},
123
- findHighestPriorityRule: () => null,
124
- clearCache: () => {},
125
- }));
126
-
127
- mock.module("../security/secret-allowlist.js", () => ({
128
- resetAllowlist: () => {},
129
- }));
130
-
131
- mock.module("../memory/conversation-crud.js", () => ({
132
- getConversationThreadType: () => "default",
133
- setConversationOriginChannelIfUnset: () => {},
134
- provenanceFromTrustContext: () => ({
135
- source: "user",
136
- trustContext: undefined,
137
- }),
138
- getConversationOriginInterface: () => null,
139
- getConversationOriginChannel: () => null,
140
- getMessages: () => persistedMessages,
141
- getConversation: () => ({
142
- id: "conv-1",
143
- contextSummary: null,
144
- contextCompactedMessageCount: 0,
145
- contextCompactedAt: null,
146
- totalInputTokens: 0,
147
- totalOutputTokens: 0,
148
- totalEstimatedCost: 0,
149
- }),
150
- addMessage: (_conversationId: string, role: string, content: string) => {
151
- const row = {
152
- id: `msg-${persistedMessages.length + 1}`,
153
- role,
154
- content,
155
- createdAt: Date.now(),
156
- };
157
- persistedMessages.push(row);
158
- return { id: row.id };
159
- },
160
- updateConversationUsage: () => {},
161
- updateConversationTitle: () => {},
162
- updateConversationContextWindow: () => {},
163
- deleteMessageById: () => ({ segmentIds: [], orphanedItemIds: [] }),
164
- deleteLastExchange: () => 0,
165
- }));
166
-
167
- mock.module("../memory/conversation-queries.js", () => ({
168
- isLastUserMessageToolResult: () => false,
169
- }));
170
-
171
- mock.module("../memory/attachments-store.js", () => ({
172
- uploadAttachment: () => ({ id: "att-1" }),
173
- linkAttachmentToMessage: () => {},
174
- }));
175
-
176
- mock.module("../memory/retriever.js", () => ({
177
- buildMemoryRecall: async (
178
- _query: string,
179
- _convId: string,
180
- _config: unknown,
181
- options?: Record<string, unknown>,
182
- ) => {
183
- if (options) recallArgs.push(options);
184
- return {
185
- enabled: true,
186
- degraded: false,
187
- reason: null,
188
- provider: "mock",
189
- model: "mock",
190
- injectedText: "",
191
- lexicalHits: 0,
192
- semanticHits: 0,
193
- recencyHits: 0,
194
- entityHits: 0,
195
- relationSeedEntityCount: 0,
196
- relationTraversedEdgeCount: 0,
197
- relationNeighborEntityCount: 0,
198
- relationExpandedItemCount: 0,
199
- earlyTerminated: false,
200
- mergedCount: 0,
201
- selectedCount: 0,
202
- rerankApplied: false,
203
- injectedTokens: 0,
204
- latencyMs: 0,
205
- topCandidates: [],
206
- };
207
- },
208
- injectMemoryRecallIntoUserMessage: (msg: Message) => msg,
209
- injectMemoryRecallAsSeparateMessage: (msgs: Message[]) => msgs,
210
- stripMemoryRecallMessages: (msgs: Message[]) => msgs,
211
- }));
212
-
213
- mock.module("../context/window-manager.js", () => ({
214
- ContextWindowManager: class {
215
- constructor() {}
216
- shouldCompact() {
217
- return { needed: false, estimatedTokens: 0 };
218
- }
219
- async maybeCompact() {
220
- return { compacted: false };
221
- }
222
- },
223
- createContextSummaryMessage: () => ({
224
- role: "user",
225
- content: [{ type: "text", text: "summary" }],
226
- }),
227
- getSummaryFromContextMessage: () => null,
228
- }));
229
-
230
- mock.module("../memory/conflict-store.js", () => ({
231
- listPendingConflictDetails: () => [],
232
- applyConflictResolution: () => true,
233
- }));
234
-
235
- mock.module("../memory/clarification-resolver.js", () => ({
236
- resolveConflictClarification: async () => ({
237
- resolution: "still_unclear",
238
- strategy: "heuristic",
239
- resolvedStatement: null,
240
- explanation: "Need user clarification.",
241
- }),
242
- }));
243
-
244
- mock.module("../memory/admin.js", () => ({
245
- getMemoryConflictAndCleanupStats: () => ({
246
- conflicts: { pending: 0, resolved: 0, oldestPendingAgeMs: null },
247
- cleanup: {
248
- resolvedBacklog: 0,
249
- supersededBacklog: 0,
250
- resolvedCompleted24h: 0,
251
- supersededCompleted24h: 0,
252
- },
253
- }),
254
- }));
255
-
256
- mock.module("../memory/profile-compiler.js", () => ({
257
- compileDynamicProfile: (options?: Record<string, unknown>) => {
258
- profileCompilerCalls += 1;
259
- if (options) profileCompilerArgs.push(options);
260
- return {
261
- text: profileText,
262
- sourceCount: 2,
263
- selectedCount: 1,
264
- budgetTokens: 300,
265
- tokenEstimate: 28,
266
- };
267
- },
268
- }));
269
-
270
- mock.module("../memory/llm-usage-store.js", () => ({
271
- recordUsageEvent: () => ({ id: "usage-1", createdAt: Date.now() }),
272
- }));
273
-
274
- mock.module("../agent/loop.js", () => ({
275
- AgentLoop: class {
276
- constructor() {}
277
- async run(
278
- messages: Message[],
279
- onEvent: (event: AgentEvent) => void,
280
- ): Promise<Message[]> {
281
- runCalls.push(messages);
282
- const assistantMessage: Message = {
283
- role: "assistant",
284
- content: [{ type: "text", text: "normal assistant answer" }],
285
- };
286
- onEvent({
287
- type: "usage",
288
- inputTokens: 10,
289
- outputTokens: 5,
290
- model: "mock",
291
- providerDurationMs: 10,
292
- });
293
- onEvent({ type: "message_complete", message: assistantMessage });
294
- return [...messages, assistantMessage];
295
- }
296
- },
297
- }));
298
- mock.module("../memory/canonical-guardian-store.js", () => ({
299
- listPendingCanonicalGuardianRequestsByDestinationConversation: () => [],
300
- listCanonicalGuardianRequests: () => [],
301
- listPendingRequestsByConversationScope: () => [],
302
- createCanonicalGuardianRequest: () => ({
303
- id: "mock-cg-id",
304
- code: "MOCK",
305
- status: "pending",
306
- }),
307
- getCanonicalGuardianRequest: () => null,
308
- getCanonicalGuardianRequestByCode: () => null,
309
- updateCanonicalGuardianRequest: () => {},
310
- resolveCanonicalGuardianRequest: () => {},
311
- createCanonicalGuardianDelivery: () => ({ id: "mock-cgd-id" }),
312
- listCanonicalGuardianDeliveries: () => [],
313
- listPendingCanonicalGuardianRequestsByDestinationChat: () => [],
314
- updateCanonicalGuardianDelivery: () => {},
315
- generateCanonicalRequestCode: () => "MOCK-CODE",
316
- }));
317
-
318
- import type { SessionMemoryPolicy } from "../daemon/session.js";
319
- import { DEFAULT_MEMORY_POLICY, Session } from "../daemon/session.js";
320
- import {
321
- injectDynamicProfileIntoUserMessage,
322
- stripDynamicProfileMessages,
323
- } from "../daemon/session-dynamic-profile.js";
324
-
325
- function makeSession(memoryPolicy?: SessionMemoryPolicy): Session {
326
- const provider = {
327
- name: "mock",
328
- async sendMessage(): Promise<ProviderResponse> {
329
- return {
330
- content: [],
331
- model: "mock",
332
- usage: { inputTokens: 0, outputTokens: 0 },
333
- stopReason: "end_turn",
334
- };
335
- },
336
- };
337
- const session = new Session(
338
- "conv-1",
339
- provider,
340
- "system prompt",
341
- 4096,
342
- () => {},
343
- "/tmp",
344
- undefined,
345
- memoryPolicy,
346
- );
347
- session.setTrustContext({ trustClass: "guardian", sourceChannel: "vellum" });
348
- return session;
349
- }
350
-
351
- function messageText(message: Message): string {
352
- return message.content
353
- .filter((block) => block.type === "text")
354
- .map((block) => (block as { type: "text"; text: string }).text)
355
- .join("\n");
356
- }
357
-
358
- describe("Session dynamic profile injection", () => {
359
- beforeEach(() => {
360
- runCalls = [];
361
- persistedMessages.length = 0;
362
- profileCompilerCalls = 0;
363
- profileCompilerArgs = [];
364
- recallArgs = [];
365
- profileEnabled = true;
366
- memoryEnabled = true;
367
- profileText =
368
- "<dynamic-user-profile>\n- timezone: America/Los_Angeles\n</dynamic-user-profile>";
369
- });
370
-
371
- test("injects profile context for runtime and strips it from persisted history", async () => {
372
- const session = makeSession();
373
- await session.loadFromDb();
374
-
375
- const events: ServerMessage[] = [];
376
- await session.processMessage("What should I do next?", [], (event) =>
377
- events.push(event),
378
- );
379
-
380
- expect(runCalls).toHaveLength(1);
381
- const runtimeUser = runCalls[0][runCalls[0].length - 1];
382
- expect(runtimeUser.role).toBe("user");
383
- const runtimeText = messageText(runtimeUser);
384
- expect(runtimeText).toContain("<dynamic-profile-context>");
385
- expect(runtimeText).toContain("<dynamic-user-profile>");
386
- expect(runtimeText).toContain("</dynamic-profile-context>");
387
-
388
- const persistedUser = session
389
- .getMessages()
390
- .find((message) => message.role === "user");
391
- expect(persistedUser).toBeDefined();
392
- if (persistedUser) {
393
- const persistedText = messageText(persistedUser);
394
- expect(persistedText).not.toContain("<dynamic-profile-context>");
395
- expect(persistedText).not.toContain("<dynamic-user-profile>");
396
- expect(persistedText).not.toContain("</dynamic-profile-context>");
397
- // No empty text blocks should remain after stripping
398
- const emptyBlocks = persistedUser.content.filter(
399
- (b) => b.type === "text" && (b as { text: string }).text === "",
400
- );
401
- expect(emptyBlocks).toHaveLength(0);
402
- }
403
- expect(profileCompilerCalls).toBe(1);
404
- expect(events.some((event) => event.type === "message_complete")).toBe(
405
- true,
406
- );
407
- });
408
-
409
- test("strip removes empty text blocks left by dedicated injection block", () => {
410
- const profile = "timezone: US/Pacific";
411
- const userMsg: Message = {
412
- role: "user",
413
- content: [{ type: "text", text: "hello" }],
414
- };
415
- const injected = injectDynamicProfileIntoUserMessage(userMsg, profile);
416
- // The injected message has 2 content blocks: original + profile
417
- expect(injected.content).toHaveLength(2);
418
- const stripped = stripDynamicProfileMessages([injected], profile);
419
- // After stripping, the dedicated profile block should be removed entirely
420
- expect(stripped[0].content).toHaveLength(1);
421
- expect(
422
- stripped[0].content.every((b) => {
423
- return b.type !== "text" || (b as { text: string }).text.length > 0;
424
- }),
425
- ).toBe(true);
426
- });
427
-
428
- test("strip only targets the last user message, not earlier ones", () => {
429
- const profile = "timezone: US/Pacific";
430
- const profileMarker = "<dynamic-profile-context>";
431
- const earlyUser: Message = {
432
- role: "user",
433
- content: [
434
- {
435
- type: "text",
436
- text: `I pasted: ${profileMarker}\ntimezone: US/Pacific\n</dynamic-profile-context>`,
437
- },
438
- ],
439
- };
440
- const assistant: Message = {
441
- role: "assistant",
442
- content: [{ type: "text", text: "ok" }],
443
- };
444
- const latestUser: Message = {
445
- role: "user",
446
- content: [{ type: "text", text: "follow up" }],
447
- };
448
- const injected = injectDynamicProfileIntoUserMessage(latestUser, profile);
449
- const msgs = [earlyUser, assistant, injected];
450
- const stripped = stripDynamicProfileMessages(msgs, profile);
451
- // Earlier user message should be untouched
452
- expect(messageText(stripped[0])).toContain(profileMarker);
453
- // Latest user message should have profile removed
454
- expect(messageText(stripped[2])).not.toContain(profileMarker);
455
- });
456
-
457
- test("strip finds injected message even when tool_result user messages follow it", () => {
458
- const profile = "timezone: US/Pacific";
459
- const profileMarker = "<dynamic-profile-context>";
460
- const injectedUser = injectDynamicProfileIntoUserMessage(
461
- { role: "user", content: [{ type: "text", text: "hello" }] },
462
- profile,
463
- );
464
- const assistantMsg: Message = {
465
- role: "assistant",
466
- content: [{ type: "text", text: "calling tool" }],
467
- };
468
- // Simulate tool_result user message appended by agent loop
469
- const toolResultUser: Message = {
470
- role: "user",
471
- content: [
472
- { type: "tool_result", tool_use_id: "tu-1", content: "result" },
473
- ],
474
- };
475
- const msgs = [injectedUser, assistantMsg, toolResultUser];
476
- const stripped = stripDynamicProfileMessages(msgs, profile);
477
- // The injected profile should be stripped from the first user message
478
- expect(messageText(stripped[0])).not.toContain(profileMarker);
479
- // tool_result message should be untouched
480
- expect(stripped[2]).toBe(toolResultUser);
481
- });
482
-
483
- test("skips profile compilation/injection when memory.profile.enabled is false", async () => {
484
- profileEnabled = false;
485
- const session = makeSession();
486
- await session.loadFromDb();
487
-
488
- await session.processMessage("Explain rebase strategy", [], () => {});
489
-
490
- expect(runCalls).toHaveLength(1);
491
- const runtimeUser = runCalls[0][runCalls[0].length - 1];
492
- const runtimeText = messageText(runtimeUser);
493
- expect(runtimeText).not.toContain("<dynamic-profile-context>");
494
- expect(profileCompilerCalls).toBe(0);
495
- });
496
-
497
- test("skips profile injection when top-level memory.enabled is false", async () => {
498
- memoryEnabled = false;
499
- const session = makeSession();
500
- await session.loadFromDb();
501
-
502
- await session.processMessage("What is my timezone?", [], () => {});
503
-
504
- expect(runCalls).toHaveLength(1);
505
- const runtimeUser = runCalls[0][runCalls[0].length - 1];
506
- const runtimeText = messageText(runtimeUser);
507
- expect(runtimeText).not.toContain("<dynamic-profile-context>");
508
- expect(profileCompilerCalls).toBe(0);
509
- });
510
-
511
- test("private thread session uses private scope + default fallback in profile compile and recall", async () => {
512
- const privatePolicy: SessionMemoryPolicy = {
513
- scopeId: "private-thread-abc",
514
- includeDefaultFallback: true,
515
- strictSideEffects: false,
516
- };
517
- const session = makeSession(privatePolicy);
518
- await session.loadFromDb();
519
-
520
- await session.processMessage("What do I prefer?", [], () => {});
521
-
522
- // Profile compiler should receive the private scope with fallback enabled
523
- expect(profileCompilerCalls).toBe(1);
524
- expect(profileCompilerArgs).toHaveLength(1);
525
- expect(profileCompilerArgs[0].scopeId).toBe("private-thread-abc");
526
- expect(profileCompilerArgs[0].includeDefaultFallback).toBe(true);
527
-
528
- // Memory recall should receive scopeId and a scopePolicyOverride for the private scope
529
- expect(recallArgs).toHaveLength(1);
530
- expect(recallArgs[0].scopeId).toBe("private-thread-abc");
531
- expect(recallArgs[0].scopePolicyOverride).toEqual({
532
- scopeId: "private-thread-abc",
533
- fallbackToDefault: true,
534
- });
535
- });
536
-
537
- test("standard thread uses default scope without fallback in profile compile and no scope override in recall", async () => {
538
- // Default policy: scopeId='default', includeDefaultFallback=false
539
- const session = makeSession(DEFAULT_MEMORY_POLICY);
540
- await session.loadFromDb();
541
-
542
- await session.processMessage("Tell me about TypeScript", [], () => {});
543
-
544
- // Profile compiler should receive default scope without fallback
545
- expect(profileCompilerCalls).toBe(1);
546
- expect(profileCompilerArgs).toHaveLength(1);
547
- expect(profileCompilerArgs[0].scopeId).toBe("default");
548
- expect(profileCompilerArgs[0].includeDefaultFallback).toBe(false);
549
-
550
- // Memory recall should forward scopeId='default' so buildScopeFilter
551
- // properly filters to the default scope, and should NOT have a
552
- // scopePolicyOverride (default scope relies on the global config policy)
553
- expect(recallArgs).toHaveLength(1);
554
- expect(recallArgs[0].scopeId).toBe("default");
555
- expect(recallArgs[0].scopePolicyOverride).toBeUndefined();
556
- });
557
- });
@@ -1,25 +0,0 @@
1
- ---
2
- name: knowledge-graph
3
- description: Query the entity knowledge graph to explore relationships between people, projects, tools, and other entities tracked in memory
4
- compatibility: "Designed for Vellum personal assistants"
5
- metadata:
6
- emoji: "πŸ•ΈοΈ"
7
- vellum:
8
- display-name: "Knowledge Graph"
9
- ---
10
-
11
- # Knowledge Graph
12
-
13
- Query the entity knowledge graph to explore relationships between people, projects, tools, and other entities tracked in memory.
14
-
15
- ## When to use
16
-
17
- - When the user asks about relationships between entities ("what tools does project X use?", "who works on project Y?")
18
- - When the user wants to explore connected entities across the knowledge graph
19
- - When automatic memory recall doesn't surface the right relationship-based information
20
-
21
- ## Capabilities
22
-
23
- - **Neighbors**: Find entities directly connected to seed entities (optionally filtered by relation and entity type)
24
- - **Typed traversal**: Multi-step traversal with type constraints at each step (e.g., "me -> works_on -> projects -> uses -> tools")
25
- - **Intersection**: Find entities reachable from ALL given seeds (e.g., "projects both Alice and Bob work on")
@@ -1,66 +0,0 @@
1
- {
2
- "version": 1,
3
- "tools": [
4
- {
5
- "name": "knowledge_graph_query",
6
- "description": "Query the entity knowledge graph to find related entities and their associated memory items. Supports three query types: 'neighbors' (direct connections), 'typed_traversal' (multi-step with type filters), and 'intersection' (entities reachable from ALL seeds).",
7
- "category": "memory",
8
- "risk": "low",
9
- "input_schema": {
10
- "type": "object",
11
- "properties": {
12
- "query_type": {
13
- "type": "string",
14
- "enum": ["neighbors", "typed_traversal", "intersection"],
15
- "description": "Type of graph query to execute"
16
- },
17
- "seeds": {
18
- "type": "array",
19
- "items": {
20
- "type": "string"
21
- },
22
- "description": "Entity names or aliases to use as starting points"
23
- },
24
- "steps": {
25
- "type": "array",
26
- "items": {
27
- "type": "object",
28
- "properties": {
29
- "relation_types": {
30
- "type": "array",
31
- "items": {
32
- "type": "string"
33
- },
34
- "description": "Relation types to follow (e.g., 'uses', 'works_on', 'depends_on')"
35
- },
36
- "entity_types": {
37
- "type": "array",
38
- "items": {
39
- "type": "string"
40
- },
41
- "description": "Entity types to include (e.g., 'person', 'project', 'tool')"
42
- }
43
- }
44
- },
45
- "description": "Traversal steps for typed_traversal and intersection queries. Each step defines type filters for one hop."
46
- },
47
- "max_results": {
48
- "type": "number",
49
- "description": "Maximum number of entities to return (default: 20)"
50
- },
51
- "include_items": {
52
- "type": "boolean",
53
- "description": "Include associated memory items for each found entity (default: true)"
54
- },
55
- "reason": {
56
- "type": "string",
57
- "description": "Brief non-technical explanation of why this tool is being called"
58
- }
59
- },
60
- "required": ["query_type", "seeds"]
61
- },
62
- "executor": "tools/graph-query.ts",
63
- "execution_target": "host"
64
- }
65
- ]
66
- }