@vellumai/assistant 0.5.16 → 0.6.0

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 (407) hide show
  1. package/ARCHITECTURE.md +1 -1
  2. package/Dockerfile +0 -3
  3. package/knip.json +2 -1
  4. package/openapi.yaml +660 -80
  5. package/package.json +1 -1
  6. package/src/__tests__/actor-token-service.test.ts +68 -0
  7. package/src/__tests__/agent-loop.test.ts +0 -32
  8. package/src/__tests__/always-loaded-tools-guard.test.ts +2 -2
  9. package/src/__tests__/anthropic-provider.test.ts +57 -3
  10. package/src/__tests__/app-compiler.test.ts +120 -0
  11. package/src/__tests__/assistant-feature-flags-integration.test.ts +2 -2
  12. package/src/__tests__/call-conversation-messages.test.ts +2 -6
  13. package/src/__tests__/call-domain.test.ts +2 -6
  14. package/src/__tests__/call-pointer-messages.test.ts +2 -14
  15. package/src/__tests__/call-recovery.test.ts +2 -6
  16. package/src/__tests__/call-routes-http.test.ts +2 -6
  17. package/src/__tests__/call-store.test.ts +2 -6
  18. package/src/__tests__/cancel-resolves-conversation-key.test.ts +2 -6
  19. package/src/__tests__/canonical-guardian-store.test.ts +2 -6
  20. package/src/__tests__/channel-delivery-store.test.ts +2 -6
  21. package/src/__tests__/channel-retry-sweep.test.ts +2 -6
  22. package/src/__tests__/checker.test.ts +25 -3
  23. package/src/__tests__/clawhub.test.ts +54 -24
  24. package/src/__tests__/cli-command-risk-guard.test.ts +14 -0
  25. package/src/__tests__/cli-memory.test.ts +74 -69
  26. package/src/__tests__/config-schema.test.ts +1 -1
  27. package/src/__tests__/config-set-platform-guard.test.ts +302 -0
  28. package/src/__tests__/confirmation-request-guardian-bridge.test.ts +2 -6
  29. package/src/__tests__/contacts-tools.test.ts +31 -0
  30. package/src/__tests__/context-overflow-reducer.test.ts +86 -0
  31. package/src/__tests__/context-token-estimator.test.ts +175 -10
  32. package/src/__tests__/conversation-agent-loop-overflow.test.ts +9 -0
  33. package/src/__tests__/conversation-agent-loop.test.ts +9 -0
  34. package/src/__tests__/conversation-attachments.test.ts +2 -6
  35. package/src/__tests__/conversation-attention-store.test.ts +2 -6
  36. package/src/__tests__/conversation-clear-safety.test.ts +2 -6
  37. package/src/__tests__/conversation-delete-schedule-cleanup.test.ts +4 -10
  38. package/src/__tests__/conversation-disk-view-integration.test.ts +2 -6
  39. package/src/__tests__/conversation-disk-view.test.ts +2 -6
  40. package/src/__tests__/conversation-error.test.ts +33 -2
  41. package/src/__tests__/conversation-fork-crud.test.ts +2 -6
  42. package/src/__tests__/conversation-history-web-search.test.ts +5 -0
  43. package/src/__tests__/conversation-load-history-repair.test.ts +5 -1
  44. package/src/__tests__/conversation-media-retry.test.ts +91 -0
  45. package/src/__tests__/conversation-starter-routes.test.ts +20 -11
  46. package/src/__tests__/conversation-store.test.ts +2 -6
  47. package/src/__tests__/conversation-usage.test.ts +2 -6
  48. package/src/__tests__/conversation-wipe.test.ts +11 -408
  49. package/src/__tests__/credential-execution-feature-gates.test.ts +3 -3
  50. package/src/__tests__/credential-execution-shell-lockdown.test.ts +2 -2
  51. package/src/__tests__/credential-security-e2e.test.ts +2 -0
  52. package/src/__tests__/followup-tools.test.ts +2 -6
  53. package/src/__tests__/graph-extraction-event-date.test.ts +186 -0
  54. package/src/__tests__/guardian-action-conversation-turn.test.ts +2 -6
  55. package/src/__tests__/guardian-action-followup-executor.test.ts +2 -6
  56. package/src/__tests__/guardian-action-followup-store.test.ts +2 -6
  57. package/src/__tests__/guardian-action-grant-mint-consume.test.ts +2 -6
  58. package/src/__tests__/guardian-action-late-reply.test.ts +2 -6
  59. package/src/__tests__/guardian-action-store.test.ts +2 -6
  60. package/src/__tests__/guardian-binding-drift-heal.test.ts +2 -6
  61. package/src/__tests__/guardian-decision-primitive-canonical.test.ts +8 -8
  62. package/src/__tests__/guardian-dispatch.test.ts +2 -6
  63. package/src/__tests__/guardian-grant-minting.test.ts +2 -14
  64. package/src/__tests__/guardian-principal-id-roundtrip.test.ts +2 -6
  65. package/src/__tests__/guardian-routing-invariants.test.ts +192 -6
  66. package/src/__tests__/guardian-routing-state.test.ts +2 -6
  67. package/src/__tests__/guardian-verification-voice-binding.test.ts +2 -6
  68. package/src/__tests__/inbound-invite-redemption.test.ts +2 -6
  69. package/src/__tests__/injection-block.test.ts +154 -0
  70. package/src/__tests__/install-meta.test.ts +506 -0
  71. package/src/__tests__/install-skill-routing.test.ts +292 -0
  72. package/src/__tests__/invite-redemption-service.test.ts +2 -6
  73. package/src/__tests__/invite-routes-http.test.ts +2 -6
  74. package/src/__tests__/jobs-store-qdrant-breaker.test.ts +2 -14
  75. package/src/__tests__/list-messages-attachments.test.ts +2 -6
  76. package/src/__tests__/llm-context-route-provider.test.ts +2 -6
  77. package/src/__tests__/llm-request-log-turn-query.test.ts +2 -6
  78. package/src/__tests__/llm-usage-store.test.ts +2 -6
  79. package/src/__tests__/log-export-workspace.test.ts +2 -6
  80. package/src/__tests__/managed-store.test.ts +38 -11
  81. package/src/__tests__/memory-jobs-worker-backoff.test.ts +2 -8
  82. package/src/__tests__/memory-recall-log-store.test.ts +2 -6
  83. package/src/__tests__/memory-upsert-concurrency.test.ts +4 -112
  84. package/src/__tests__/non-member-access-request.test.ts +2 -6
  85. package/src/__tests__/notification-guardian-path.test.ts +2 -6
  86. package/src/__tests__/oauth-cli.test.ts +364 -2
  87. package/src/__tests__/oauth2-gateway-transport.test.ts +18 -3
  88. package/src/__tests__/outlook-attachments.test.ts +301 -0
  89. package/src/__tests__/outlook-automation-tools.test.ts +425 -0
  90. package/src/__tests__/outlook-categories.test.ts +212 -0
  91. package/src/__tests__/outlook-client-automation.test.ts +246 -0
  92. package/src/__tests__/outlook-compose-tools.test.ts +325 -0
  93. package/src/__tests__/outlook-declutter-tools.test.ts +585 -0
  94. package/src/__tests__/outlook-email-watcher.test.ts +322 -0
  95. package/src/__tests__/outlook-follow-up.test.ts +196 -0
  96. package/src/__tests__/outlook-messaging-provider.test.ts +498 -3
  97. package/src/__tests__/outlook-trash.test.ts +77 -0
  98. package/src/__tests__/outlook-unsubscribe.test.ts +250 -0
  99. package/src/__tests__/platform-callback-registration.test.ts +4 -4
  100. package/src/__tests__/playbook-execution.test.ts +76 -80
  101. package/src/__tests__/playbook-tools.test.ts +5 -7
  102. package/src/__tests__/provider-error-scenarios.test.ts +21 -0
  103. package/src/__tests__/rebuild-index-graph-nodes.test.ts +273 -0
  104. package/src/__tests__/registry.test.ts +2 -2
  105. package/src/__tests__/require-fresh-approval.test.ts +64 -2
  106. package/src/__tests__/runtime-events-sse-parity.test.ts +2 -6
  107. package/src/__tests__/runtime-events-sse.test.ts +2 -6
  108. package/src/__tests__/schedule-store.test.ts +2 -6
  109. package/src/__tests__/schedule-tools.test.ts +2 -6
  110. package/src/__tests__/scheduler-recurrence.test.ts +1 -5
  111. package/src/__tests__/scoped-approval-grants.test.ts +2 -6
  112. package/src/__tests__/scoped-grant-security-matrix.test.ts +2 -6
  113. package/src/__tests__/search-skills-unified.test.ts +421 -0
  114. package/src/__tests__/secret-onetime-send.test.ts +2 -0
  115. package/src/__tests__/send-endpoint-busy.test.ts +2 -6
  116. package/src/__tests__/sequence-store.test.ts +2 -6
  117. package/src/__tests__/server-history-render.test.ts +2 -6
  118. package/src/__tests__/skill-feature-flags-integration.test.ts +38 -31
  119. package/src/__tests__/skill-feature-flags.test.ts +6 -6
  120. package/src/__tests__/skill-load-feature-flag.test.ts +11 -11
  121. package/src/__tests__/skill-memory.test.ts +140 -98
  122. package/src/__tests__/skills-uninstall.test.ts +2 -2
  123. package/src/__tests__/skills.test.ts +1 -1
  124. package/src/__tests__/slack-inbound-verification.test.ts +2 -6
  125. package/src/__tests__/task-compiler.test.ts +2 -6
  126. package/src/__tests__/task-management-tools.test.ts +2 -6
  127. package/src/__tests__/task-memory-cleanup.test.ts +173 -229
  128. package/src/__tests__/task-runner.test.ts +2 -6
  129. package/src/__tests__/task-scheduler.test.ts +2 -6
  130. package/src/__tests__/test-preload.ts +3 -0
  131. package/src/__tests__/tool-approval-handler.test.ts +2 -6
  132. package/src/__tests__/tool-grant-request-escalation.test.ts +2 -6
  133. package/src/__tests__/tool-side-effects-slack-dm.test.ts +276 -0
  134. package/src/__tests__/trust-store.test.ts +1 -1
  135. package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +2 -6
  136. package/src/__tests__/trusted-contact-lifecycle-notifications.test.ts +2 -6
  137. package/src/__tests__/trusted-contact-multichannel.test.ts +2 -6
  138. package/src/__tests__/trusted-contact-verification.test.ts +2 -6
  139. package/src/__tests__/turn-boundary-resolution.test.ts +2 -6
  140. package/src/__tests__/usage-cache-backfill-migration.test.ts +1 -6
  141. package/src/__tests__/usage-routes.test.ts +2 -6
  142. package/src/__tests__/verification-control-plane-policy.test.ts +0 -2
  143. package/src/__tests__/voice-invite-redemption.test.ts +2 -6
  144. package/src/__tests__/voice-scoped-grant-consumer.test.ts +2 -6
  145. package/src/__tests__/voice-session-bridge.test.ts +2 -6
  146. package/src/__tests__/volume-security-guard.test.ts +2 -0
  147. package/src/__tests__/workspace-lifecycle.test.ts +29 -1
  148. package/src/__tests__/workspace-migration-009-backfill-conversation-disk-view.test.ts +2 -6
  149. package/src/__tests__/workspace-migration-013-repair-conversation-disk-view.test.ts +2 -6
  150. package/src/__tests__/workspace-migration-026-backfill-install-meta.test.ts +558 -0
  151. package/src/__tests__/workspace-policy.test.ts +1 -1
  152. package/src/agent/attachments.ts +7 -2
  153. package/src/agent/image-optimize.ts +165 -0
  154. package/src/agent/loop.ts +1 -15
  155. package/src/bundler/app-compiler.ts +179 -2
  156. package/src/bundler/package-resolver.ts +3 -5
  157. package/src/cli/__tests__/notifications.test.ts +1 -2
  158. package/src/cli/cli-memory.ts +67 -64
  159. package/src/cli/commands/avatar.ts +3 -3
  160. package/src/cli/commands/config.ts +26 -13
  161. package/src/cli/commands/doctor.ts +2 -2
  162. package/src/cli/commands/memory.ts +41 -55
  163. package/src/cli/commands/oauth/__tests__/connect.test.ts +2 -2
  164. package/src/cli/commands/oauth/__tests__/disconnect.test.ts +2 -2
  165. package/src/cli/commands/oauth/__tests__/mode.test.ts +8 -1
  166. package/src/cli/commands/oauth/__tests__/status.test.ts +2 -2
  167. package/src/cli/commands/oauth/connect.ts +11 -6
  168. package/src/cli/commands/oauth/mode.ts +7 -0
  169. package/src/cli/commands/oauth/shared.ts +39 -3
  170. package/src/cli/commands/platform/__tests__/connect.test.ts +1 -1
  171. package/src/cli/commands/platform/__tests__/disconnect.test.ts +1 -1
  172. package/src/cli/commands/platform/__tests__/status.test.ts +5 -5
  173. package/src/cli/commands/platform/index.ts +16 -16
  174. package/src/cli/commands/skills.ts +88 -16
  175. package/src/cli/commands/trust.ts +2 -2
  176. package/src/cli/lib/daemon-credential-client.ts +2 -3
  177. package/src/config/bundled-skills/acp/TOOLS.json +1 -1
  178. package/src/config/bundled-skills/contacts/SKILL.md +0 -1
  179. package/src/config/bundled-skills/contacts/TOOLS.json +0 -8
  180. package/src/config/bundled-skills/contacts/tools/contact-upsert.ts +0 -4
  181. package/src/config/bundled-skills/gmail/SKILL.md +2 -10
  182. package/src/config/bundled-skills/google-calendar/SKILL.md +1 -9
  183. package/src/config/bundled-skills/messaging/SKILL.md +10 -18
  184. package/src/config/bundled-skills/messaging/tools/messaging-analyze-style.ts +40 -33
  185. package/src/config/bundled-skills/outlook/SKILL.md +189 -0
  186. package/src/config/bundled-skills/outlook/TOOLS.json +530 -0
  187. package/src/config/bundled-skills/outlook/tools/outlook-attachments.ts +85 -0
  188. package/src/config/bundled-skills/outlook/tools/outlook-categories.ts +77 -0
  189. package/src/config/bundled-skills/outlook/tools/outlook-draft.ts +84 -0
  190. package/src/config/bundled-skills/outlook/tools/outlook-follow-up.ts +94 -0
  191. package/src/config/bundled-skills/outlook/tools/outlook-forward.ts +49 -0
  192. package/src/config/bundled-skills/outlook/tools/outlook-outreach-scan.ts +237 -0
  193. package/src/config/bundled-skills/outlook/tools/outlook-rules.ts +161 -0
  194. package/src/config/bundled-skills/outlook/tools/outlook-send-draft.ts +32 -0
  195. package/src/config/bundled-skills/outlook/tools/outlook-sender-digest.ts +272 -0
  196. package/src/config/bundled-skills/outlook/tools/outlook-trash.ts +29 -0
  197. package/src/config/bundled-skills/outlook/tools/outlook-unsubscribe.ts +129 -0
  198. package/src/config/bundled-skills/outlook/tools/outlook-vacation.ts +87 -0
  199. package/src/config/bundled-skills/outlook/tools/shared.ts +20 -0
  200. package/src/config/bundled-skills/outlook-calendar/SKILL.md +51 -0
  201. package/src/config/bundled-skills/outlook-calendar/TOOLS.json +221 -0
  202. package/src/config/bundled-skills/outlook-calendar/calendar-client.ts +252 -0
  203. package/src/config/bundled-skills/outlook-calendar/tools/outlook-calendar-check-availability.ts +53 -0
  204. package/src/config/bundled-skills/outlook-calendar/tools/outlook-calendar-create-event.ts +74 -0
  205. package/src/config/bundled-skills/outlook-calendar/tools/outlook-calendar-get-event.ts +18 -0
  206. package/src/config/bundled-skills/outlook-calendar/tools/outlook-calendar-list-events.ts +46 -0
  207. package/src/config/bundled-skills/outlook-calendar/tools/outlook-calendar-rsvp.ts +36 -0
  208. package/src/config/bundled-skills/outlook-calendar/tools/shared.ts +17 -0
  209. package/src/config/bundled-skills/outlook-calendar/types.ts +120 -0
  210. package/src/config/bundled-skills/playbooks/tools/playbook-create.ts +47 -40
  211. package/src/config/bundled-skills/playbooks/tools/playbook-delete.ts +16 -29
  212. package/src/config/bundled-skills/playbooks/tools/playbook-list.ts +16 -18
  213. package/src/config/bundled-skills/playbooks/tools/playbook-update.ts +39 -47
  214. package/src/config/bundled-skills/slack/SKILL.md +1 -7
  215. package/src/config/bundled-tool-registry.ts +56 -4
  216. package/src/config/env-registry.ts +15 -8
  217. package/src/config/feature-flag-registry.json +21 -124
  218. package/src/config/schemas/platform.ts +8 -0
  219. package/src/config/schemas/timeouts.ts +1 -1
  220. package/src/config/skills.ts +18 -7
  221. package/src/context/token-estimator.ts +25 -18
  222. package/src/context/window-manager.ts +6 -2
  223. package/src/credential-execution/process-manager.ts +3 -1
  224. package/src/daemon/context-overflow-reducer.ts +46 -2
  225. package/src/daemon/conversation-agent-loop-handlers.ts +123 -82
  226. package/src/daemon/conversation-agent-loop.ts +96 -61
  227. package/src/daemon/conversation-error.ts +31 -8
  228. package/src/daemon/conversation-lifecycle.ts +33 -0
  229. package/src/daemon/conversation-media-retry.ts +85 -7
  230. package/src/daemon/conversation-notifiers.ts +4 -1
  231. package/src/daemon/conversation-runtime-assembly.ts +5 -0
  232. package/src/daemon/conversation.ts +41 -2
  233. package/src/daemon/daemon-control.ts +8 -2
  234. package/src/daemon/handlers/shared.ts +22 -12
  235. package/src/daemon/handlers/skills.ts +416 -202
  236. package/src/daemon/lifecycle.ts +40 -1
  237. package/src/daemon/main.ts +5 -1
  238. package/src/daemon/message-types/conversations.ts +4 -1
  239. package/src/daemon/message-types/messages.ts +3 -1
  240. package/src/daemon/message-types/skills.ts +97 -36
  241. package/src/daemon/providers-setup.ts +5 -0
  242. package/src/daemon/server.ts +11 -2
  243. package/src/daemon/tool-side-effects.ts +27 -5
  244. package/src/heartbeat/heartbeat-service.ts +1 -0
  245. package/src/hooks/cli.ts +2 -2
  246. package/src/hooks/runner.ts +15 -38
  247. package/src/inbound/platform-callback-registration.ts +14 -14
  248. package/src/memory/admin.ts +11 -45
  249. package/src/memory/conversation-bootstrap.ts +2 -0
  250. package/src/memory/conversation-crud.ts +242 -348
  251. package/src/memory/conversation-group-migration.ts +157 -0
  252. package/src/memory/conversation-queries.ts +4 -2
  253. package/src/memory/db-init.ts +30 -3
  254. package/src/memory/embed.ts +73 -0
  255. package/src/memory/embedding-backend.ts +8 -14
  256. package/src/memory/embedding-runtime-manager.ts +12 -114
  257. package/src/memory/fingerprint.ts +2 -2
  258. package/src/memory/graph/bootstrap.ts +512 -0
  259. package/src/memory/graph/capability-seed.ts +297 -0
  260. package/src/memory/graph/consolidation.ts +691 -0
  261. package/src/memory/graph/conversation-graph-memory.ts +630 -0
  262. package/src/memory/graph/decay.test.ts +208 -0
  263. package/src/memory/graph/decay.ts +195 -0
  264. package/src/memory/graph/extraction-job.ts +69 -0
  265. package/src/memory/graph/extraction.test.ts +936 -0
  266. package/src/memory/graph/extraction.ts +1254 -0
  267. package/src/memory/graph/graph-search.ts +266 -0
  268. package/src/memory/graph/image-ref-utils.ts +29 -0
  269. package/src/memory/graph/injection.test.ts +513 -0
  270. package/src/memory/graph/injection.ts +439 -0
  271. package/src/memory/graph/inspect.ts +534 -0
  272. package/src/memory/graph/narrative.ts +267 -0
  273. package/src/memory/graph/pattern-scan.ts +269 -0
  274. package/src/memory/graph/retriever.ts +1008 -0
  275. package/src/memory/graph/scoring.test.ts +548 -0
  276. package/src/memory/graph/scoring.ts +232 -0
  277. package/src/memory/graph/serendipity.ts +65 -0
  278. package/src/memory/graph/store.test.ts +1050 -0
  279. package/src/memory/graph/store.ts +699 -0
  280. package/src/memory/graph/tool-handlers.ts +426 -0
  281. package/src/memory/graph/tools.ts +141 -0
  282. package/src/memory/graph/triggers.test.ts +487 -0
  283. package/src/memory/graph/triggers.ts +223 -0
  284. package/src/memory/graph/types.ts +271 -0
  285. package/src/memory/group-crud.ts +191 -0
  286. package/src/memory/indexer.ts +37 -19
  287. package/src/memory/job-handlers/cleanup.ts +0 -53
  288. package/src/memory/job-handlers/conversation-starters.ts +91 -53
  289. package/src/memory/job-handlers/embedding.ts +5 -31
  290. package/src/memory/job-handlers/index-maintenance.ts +23 -11
  291. package/src/memory/job-handlers/summarization.ts +32 -17
  292. package/src/memory/job-utils.ts +1 -1
  293. package/src/memory/jobs-store.ts +50 -70
  294. package/src/memory/jobs-worker.ts +147 -112
  295. package/src/memory/message-content.ts +1 -0
  296. package/src/memory/migrations/202-memory-graph-tables.ts +130 -0
  297. package/src/memory/migrations/203-drop-memory-items-tables.ts +23 -0
  298. package/src/memory/migrations/204-rename-memory-graph-type-values.ts +46 -0
  299. package/src/memory/migrations/205-memory-graph-image-refs.ts +11 -0
  300. package/src/memory/migrations/index.ts +4 -0
  301. package/src/memory/migrations/registry.ts +8 -0
  302. package/src/memory/qdrant-client.ts +44 -17
  303. package/src/memory/schema/index.ts +1 -0
  304. package/src/memory/schema/memory-graph.ts +139 -0
  305. package/src/memory/search/semantic.ts +47 -91
  306. package/src/memory/task-memory-cleanup.ts +28 -50
  307. package/src/messaging/providers/outlook/adapter.ts +8 -1
  308. package/src/messaging/providers/outlook/client.ts +299 -0
  309. package/src/messaging/providers/outlook/types.ts +118 -0
  310. package/src/notifications/adapters/macos.ts +1 -0
  311. package/src/notifications/copy-composer.ts +9 -0
  312. package/src/notifications/signal.ts +16 -0
  313. package/src/oauth/seed-providers.ts +2 -1
  314. package/src/permissions/checker.ts +24 -3
  315. package/src/permissions/defaults.ts +4 -4
  316. package/src/permissions/workspace-policy.ts +1 -1
  317. package/src/playbooks/playbook-compiler.ts +19 -18
  318. package/src/playbooks/types.ts +4 -3
  319. package/src/prompts/system-prompt.ts +3 -29
  320. package/src/providers/anthropic/client.ts +47 -19
  321. package/src/providers/gemini/client.ts +1 -1
  322. package/src/providers/openai/client.ts +1 -1
  323. package/src/providers/registry.ts +1 -1
  324. package/src/providers/retry.ts +19 -3
  325. package/src/runtime/actor-trust-resolver.ts +5 -1
  326. package/src/runtime/auth/route-policy.ts +7 -0
  327. package/src/runtime/guardian-reply-router.ts +5 -1
  328. package/src/runtime/http-server.ts +23 -3
  329. package/src/runtime/middleware/auth.ts +20 -0
  330. package/src/runtime/routes/attachment-routes.test.ts +106 -0
  331. package/src/runtime/routes/attachment-routes.ts +106 -16
  332. package/src/runtime/routes/brain-graph-routes.ts +21 -22
  333. package/src/runtime/routes/btw-routes.ts +8 -0
  334. package/src/runtime/routes/conversation-management-routes.ts +2 -0
  335. package/src/runtime/routes/conversation-starter-routes.ts +2 -2
  336. package/src/runtime/routes/debug-routes.ts +1 -1
  337. package/src/runtime/routes/global-search-routes.ts +21 -19
  338. package/src/runtime/routes/group-routes.ts +207 -0
  339. package/src/runtime/routes/guardian-action-routes.ts +21 -10
  340. package/src/runtime/routes/guardian-bootstrap-routes.ts +23 -19
  341. package/src/runtime/routes/inbound-message-handler.ts +19 -0
  342. package/src/runtime/routes/inbound-stages/guardian-activation-intercept.test.ts +292 -0
  343. package/src/runtime/routes/inbound-stages/guardian-activation-intercept.ts +207 -0
  344. package/src/runtime/routes/memory-item-routes.test.ts +2 -14
  345. package/src/runtime/routes/memory-item-routes.ts +341 -388
  346. package/src/runtime/routes/schedule-routes.ts +2 -0
  347. package/src/runtime/routes/skills-routes.ts +103 -37
  348. package/src/runtime/routes/work-items-routes.test.ts +2 -6
  349. package/src/schedule/scheduler.ts +8 -1
  350. package/src/security/oauth2.ts +1 -1
  351. package/src/security/secure-keys.ts +4 -8
  352. package/src/shared/provider-env-vars.ts +19 -0
  353. package/src/skills/catalog-cache.ts +5 -0
  354. package/src/skills/catalog-install.ts +15 -14
  355. package/src/skills/clawhub.ts +134 -154
  356. package/src/skills/install-meta.ts +208 -0
  357. package/src/skills/managed-store.ts +27 -16
  358. package/src/skills/skill-memory.ts +152 -77
  359. package/src/skills/skillssh-registry.ts +19 -17
  360. package/src/tasks/task-runner.ts +3 -1
  361. package/src/telemetry/usage-telemetry-reporter.test.ts +3 -5
  362. package/src/tools/browser/runtime-check.ts +3 -1
  363. package/src/tools/memory/register.ts +63 -46
  364. package/src/tools/permission-checker.ts +7 -1
  365. package/src/tools/shared/filesystem/image-read.ts +22 -85
  366. package/src/tools/terminal/safe-env.ts +1 -0
  367. package/src/tools/tool-manifest.ts +3 -3
  368. package/src/util/browser.ts +25 -10
  369. package/src/util/bun-runtime.ts +172 -0
  370. package/src/watcher/providers/outlook-calendar.ts +343 -0
  371. package/src/watcher/providers/outlook.ts +198 -0
  372. package/src/workspace/migrations/025-remove-oauth-app-setup-skills.ts +76 -0
  373. package/src/workspace/migrations/026-backfill-install-meta.ts +325 -0
  374. package/src/workspace/migrations/027-remove-orphaned-optimized-images-cache.ts +42 -0
  375. package/src/workspace/migrations/registry.ts +6 -0
  376. package/src/__tests__/context-memory-e2e.test.ts +0 -415
  377. package/src/__tests__/journal-context.test.ts +0 -268
  378. package/src/__tests__/memory-context-benchmark.benchmark.test.ts +0 -297
  379. package/src/__tests__/memory-lifecycle-e2e.test.ts +0 -459
  380. package/src/__tests__/memory-query-builder.test.ts +0 -59
  381. package/src/__tests__/memory-recall-quality.test.ts +0 -1046
  382. package/src/__tests__/memory-regressions.experimental.test.ts +0 -629
  383. package/src/__tests__/memory-regressions.test.ts +0 -3696
  384. package/src/__tests__/memory-retrieval.benchmark.test.ts +0 -295
  385. package/src/daemon/conversation-memory.ts +0 -207
  386. package/src/memory/conversation-starters-cadence.ts +0 -74
  387. package/src/memory/items-extractor.ts +0 -860
  388. package/src/memory/job-handlers/batch-extraction.ts +0 -753
  389. package/src/memory/job-handlers/extraction.ts +0 -40
  390. package/src/memory/job-handlers/journal-carry-forward.test.ts +0 -355
  391. package/src/memory/job-handlers/journal-carry-forward.ts +0 -255
  392. package/src/memory/journal-memory.ts +0 -224
  393. package/src/memory/query-builder.ts +0 -47
  394. package/src/memory/query-expansion.ts +0 -83
  395. package/src/memory/retriever.test.ts +0 -1592
  396. package/src/memory/retriever.ts +0 -1331
  397. package/src/memory/search/formatting.test.ts +0 -140
  398. package/src/memory/search/formatting.ts +0 -262
  399. package/src/memory/search/mmr.ts +0 -139
  400. package/src/memory/search/ranking.ts +0 -15
  401. package/src/memory/search/staleness.ts +0 -40
  402. package/src/memory/search/tier-classifier.ts +0 -18
  403. package/src/memory/search/types.ts +0 -121
  404. package/src/prompts/journal-context.ts +0 -154
  405. package/src/tools/memory/definitions.ts +0 -69
  406. package/src/tools/memory/handlers.test.ts +0 -562
  407. package/src/tools/memory/handlers.ts +0 -434
@@ -1,629 +0,0 @@
1
- import {
2
- afterAll,
3
- beforeAll,
4
- beforeEach,
5
- describe,
6
- expect,
7
- mock,
8
- test,
9
- } from "bun:test";
10
-
11
- mock.module("../security/secure-keys.js", () => ({
12
- getProviderKeyAsync: async () => undefined,
13
- getSecureKeyAsync: async () => undefined,
14
- getSecureKeyResultAsync: async () => ({ status: "missing" }),
15
- listSecureKeysAsync: async () => [],
16
- setSecureKeyAsync: async () => ({ status: "ok" }),
17
- deleteSecureKeyAsync: async () => ({ status: "ok" }),
18
- getActiveBackendName: () => "mock",
19
- _resetBackend: () => {},
20
- }));
21
-
22
- mock.module("../util/logger.js", () => ({
23
- getLogger: () =>
24
- new Proxy({} as Record<string, unknown>, {
25
- get: () => () => {},
26
- }),
27
- }));
28
-
29
- // Dynamic Qdrant mock: tests can push results to be returned by searchWithFilter/hybridSearch
30
- let mockQdrantResults: Array<{
31
- id: string;
32
- score: number;
33
- payload: Record<string, unknown>;
34
- }> = [];
35
-
36
- mock.module("../memory/qdrant-client.js", () => ({
37
- getQdrantClient: () => ({
38
- searchWithFilter: async () => mockQdrantResults,
39
- hybridSearch: async () => mockQdrantResults,
40
- upsert: async () => {},
41
- deletePoints: async () => {},
42
- }),
43
- initQdrantClient: () => {},
44
- }));
45
-
46
- import { eq } from "drizzle-orm";
47
-
48
- import { DEFAULT_CONFIG } from "../config/defaults.js";
49
-
50
- // Disable LLM extraction in tests to avoid real API calls and ensure
51
- // deterministic pattern-based extraction.
52
- const TEST_CONFIG = {
53
- ...DEFAULT_CONFIG,
54
- memory: {
55
- ...DEFAULT_CONFIG.memory,
56
- extraction: {
57
- ...DEFAULT_CONFIG.memory.extraction,
58
- useLLM: false,
59
- },
60
- },
61
- };
62
-
63
- mock.module("../config/loader.js", () => ({
64
- loadConfig: () => TEST_CONFIG,
65
- getConfig: () => TEST_CONFIG,
66
- invalidateConfigCache: () => {},
67
- }));
68
- import { getDb, initializeDb, resetDb } from "../memory/db.js";
69
- import { indexMessageNow } from "../memory/indexer.js";
70
- import { enqueueMemoryJob } from "../memory/jobs-store.js";
71
- import {
72
- resetCleanupScheduleThrottle,
73
- resetStaleSweepThrottle,
74
- runMemoryJobsOnce,
75
- } from "../memory/jobs-worker.js";
76
- import { buildMemoryRecall } from "../memory/retriever.js";
77
- import {
78
- conversations,
79
- memoryItems,
80
- memoryItemSources,
81
- memoryJobs,
82
- memorySummaries,
83
- messages,
84
- } from "../memory/schema.js";
85
-
86
- describe("Memory regressions (experimental)", () => {
87
- beforeAll(() => {
88
- initializeDb();
89
- });
90
-
91
- beforeEach(() => {
92
- const db = getDb();
93
- db.run("DELETE FROM memory_item_sources");
94
- db.run("DELETE FROM memory_embeddings");
95
- db.run("DELETE FROM memory_items");
96
-
97
- db.run("DELETE FROM memory_summaries");
98
- db.run("DELETE FROM memory_segments");
99
- db.run("DELETE FROM messages");
100
- db.run("DELETE FROM conversations");
101
- db.run("DELETE FROM memory_jobs");
102
- db.run("DELETE FROM memory_checkpoints");
103
- resetCleanupScheduleThrottle();
104
- resetStaleSweepThrottle();
105
- mockQdrantResults = [];
106
- });
107
-
108
- afterAll(() => {
109
- resetDb();
110
- });
111
-
112
- async function withMockOllamaQueryEmbedding<T>(
113
- run: () => Promise<T>,
114
- ): Promise<T> {
115
- const originalFetch = globalThis.fetch;
116
- // Return 384-dim vectors to match the Qdrant collection's expected size
117
- const mockVector = new Array(384).fill(0);
118
- mockVector[0] = 1;
119
- globalThis.fetch = (async () =>
120
- new Response(JSON.stringify({ data: [{ embedding: mockVector }] }), {
121
- status: 200,
122
- headers: { "content-type": "application/json" },
123
- })) as unknown as typeof globalThis.fetch;
124
- try {
125
- return await run();
126
- } finally {
127
- globalThis.fetch = originalFetch;
128
- }
129
- }
130
-
131
- function semanticRecallConfig() {
132
- return {
133
- ...DEFAULT_CONFIG,
134
- memory: {
135
- ...DEFAULT_CONFIG.memory,
136
- embeddings: {
137
- ...DEFAULT_CONFIG.memory.embeddings,
138
- provider: "ollama" as const,
139
- required: true,
140
- },
141
- retrieval: {
142
- ...DEFAULT_CONFIG.memory.retrieval,
143
- maxInjectTokens: 2000,
144
- },
145
- },
146
- };
147
- }
148
-
149
- test("semantic recall excludes items backed only by excluded message ids", async () => {
150
- const db = getDb();
151
- const now = 1_700_000_120_000;
152
- db.insert(conversations)
153
- .values({
154
- id: "conv-semantic-exclude",
155
- title: null,
156
- createdAt: now,
157
- updatedAt: now,
158
- totalInputTokens: 0,
159
- totalOutputTokens: 0,
160
- totalEstimatedCost: 0,
161
- contextSummary: null,
162
- contextCompactedMessageCount: 1,
163
- contextCompactedAt: null,
164
- })
165
- .run();
166
- db.insert(messages)
167
- .values([
168
- {
169
- id: "msg-semantic-old",
170
- conversationId: "conv-semantic-exclude",
171
- role: "user",
172
- content: JSON.stringify([{ type: "text", text: "Timezone is PST." }]),
173
- createdAt: now - 10_000,
174
- },
175
- {
176
- id: "msg-semantic-current",
177
- conversationId: "conv-semantic-exclude",
178
- role: "user",
179
- content: JSON.stringify([
180
- { type: "text", text: "Remember timezone PST for this turn." },
181
- ]),
182
- createdAt: now,
183
- },
184
- ])
185
- .run();
186
- db.insert(memoryItems)
187
- .values([
188
- {
189
- id: "item-semantic-old",
190
- kind: "identity",
191
- subject: "timezone",
192
- statement: "User timezone is PST",
193
- status: "active",
194
- confidence: 0.9,
195
- fingerprint: "item-semantic-old-fingerprint",
196
- firstSeenAt: now - 10_000,
197
- lastSeenAt: now - 10_000,
198
- lastUsedAt: null,
199
- },
200
- {
201
- id: "item-semantic-current",
202
- kind: "identity",
203
- subject: "timezone",
204
- statement: "User timezone is PST (current turn)",
205
- status: "active",
206
- confidence: 0.9,
207
- fingerprint: "item-semantic-current-fingerprint",
208
- firstSeenAt: now,
209
- lastSeenAt: now,
210
- lastUsedAt: null,
211
- },
212
- ])
213
- .run();
214
- db.insert(memoryItemSources)
215
- .values([
216
- {
217
- memoryItemId: "item-semantic-old",
218
- messageId: "msg-semantic-old",
219
- evidence: "old source",
220
- createdAt: now - 10_000,
221
- },
222
- {
223
- memoryItemId: "item-semantic-current",
224
- messageId: "msg-semantic-current",
225
- evidence: "current turn source",
226
- createdAt: now,
227
- },
228
- ])
229
- .run();
230
- // Mock Qdrant to return both items as search results
231
- mockQdrantResults = [
232
- {
233
- id: "emb-semantic-old",
234
- score: 0.95,
235
- payload: {
236
- target_type: "item",
237
- target_id: "item-semantic-old",
238
- text: "User timezone is PST",
239
- kind: "identity",
240
- status: "active",
241
- created_at: now - 10_000,
242
- last_seen_at: now - 10_000,
243
- },
244
- },
245
- {
246
- id: "emb-semantic-current",
247
- score: 0.93,
248
- payload: {
249
- target_type: "item",
250
- target_id: "item-semantic-current",
251
- text: "User timezone is PST (current turn)",
252
- kind: "identity",
253
- status: "active",
254
- created_at: now,
255
- last_seen_at: now,
256
- },
257
- },
258
- ];
259
-
260
- const recall = await withMockOllamaQueryEmbedding(() =>
261
- buildMemoryRecall(
262
- "timezone",
263
- "conv-semantic-exclude",
264
- semanticRecallConfig(),
265
- { excludeMessageIds: ["msg-semantic-current"] },
266
- ),
267
- );
268
- expect(recall.semanticHits).toBe(1);
269
- expect(recall.injectedText).toContain("User timezone is PST");
270
- expect(recall.injectedText).not.toContain("(current turn)");
271
- });
272
-
273
- test("semantic recall skips active items that have no remaining evidence rows", async () => {
274
- const db = getDb();
275
- const now = 1_700_000_130_000;
276
- db.insert(conversations)
277
- .values({
278
- id: "conv-semantic-evidence",
279
- title: null,
280
- createdAt: now,
281
- updatedAt: now,
282
- totalInputTokens: 0,
283
- totalOutputTokens: 0,
284
- totalEstimatedCost: 0,
285
- contextSummary: null,
286
- contextCompactedMessageCount: 1,
287
- contextCompactedAt: null,
288
- })
289
- .run();
290
- db.insert(messages)
291
- .values({
292
- id: "msg-semantic-evidence",
293
- conversationId: "conv-semantic-evidence",
294
- role: "user",
295
- content: JSON.stringify([{ type: "text", text: "Timezone is PST." }]),
296
- createdAt: now,
297
- })
298
- .run();
299
- db.insert(memoryItems)
300
- .values([
301
- {
302
- id: "item-semantic-with-evidence",
303
- kind: "identity",
304
- subject: "timezone",
305
- statement: "User timezone is PST",
306
- status: "active",
307
- confidence: 0.9,
308
- fingerprint: "item-semantic-with-evidence-fingerprint",
309
- firstSeenAt: now,
310
- lastSeenAt: now,
311
- lastUsedAt: null,
312
- },
313
- {
314
- id: "item-semantic-orphan",
315
- kind: "identity",
316
- subject: "timezone",
317
- statement: "Stale orphan fact",
318
- status: "active",
319
- confidence: 0.9,
320
- fingerprint: "item-semantic-orphan-fingerprint",
321
- firstSeenAt: now,
322
- lastSeenAt: now,
323
- lastUsedAt: null,
324
- },
325
- ])
326
- .run();
327
- db.insert(memoryItemSources)
328
- .values({
329
- memoryItemId: "item-semantic-with-evidence",
330
- messageId: "msg-semantic-evidence",
331
- evidence: "message evidence",
332
- createdAt: now,
333
- })
334
- .run();
335
- // Mock Qdrant to return both items as search results
336
- mockQdrantResults = [
337
- {
338
- id: "emb-semantic-with-evidence",
339
- score: 0.95,
340
- payload: {
341
- target_type: "item",
342
- target_id: "item-semantic-with-evidence",
343
- text: "User timezone is PST",
344
- kind: "identity",
345
- status: "active",
346
- created_at: now,
347
- last_seen_at: now,
348
- },
349
- },
350
- {
351
- id: "emb-semantic-orphan",
352
- score: 0.9,
353
- payload: {
354
- target_type: "item",
355
- target_id: "item-semantic-orphan",
356
- text: "Stale orphan fact",
357
- kind: "identity",
358
- status: "active",
359
- created_at: now,
360
- last_seen_at: now,
361
- },
362
- },
363
- ];
364
-
365
- const recall = await withMockOllamaQueryEmbedding(() =>
366
- buildMemoryRecall(
367
- "timezone",
368
- "conv-semantic-evidence",
369
- semanticRecallConfig(),
370
- ),
371
- );
372
- expect(recall.semanticHits).toBe(1);
373
- expect(recall.injectedText).toContain("User timezone is PST");
374
- expect(recall.injectedText).not.toContain("Stale orphan fact");
375
- });
376
-
377
- test("semantic recall excludes conversation summaries that overlap excluded messages", async () => {
378
- const db = getDb();
379
- const now = 1_700_000_140_000;
380
- const conversationId = "conv-semantic-summary";
381
- db.insert(conversations)
382
- .values({
383
- id: conversationId,
384
- title: null,
385
- createdAt: now,
386
- updatedAt: now,
387
- totalInputTokens: 0,
388
- totalOutputTokens: 0,
389
- totalEstimatedCost: 0,
390
- contextSummary: null,
391
- contextCompactedMessageCount: 0,
392
- contextCompactedAt: null,
393
- })
394
- .run();
395
- db.insert(messages)
396
- .values({
397
- id: "msg-semantic-summary-excluded",
398
- conversationId,
399
- role: "user",
400
- content: JSON.stringify([
401
- { type: "text", text: "This is the current turn message." },
402
- ]),
403
- createdAt: now,
404
- })
405
- .run();
406
- db.insert(memorySummaries)
407
- .values([
408
- {
409
- id: "summary-semantic-conversation",
410
- scope: "conversation",
411
- scopeKey: conversationId,
412
- summary: "Conversation summary containing current turn details",
413
- tokenEstimate: 12,
414
- startAt: now - 500,
415
- endAt: now + 500,
416
- createdAt: now,
417
- updatedAt: now,
418
- },
419
- {
420
- id: "summary-semantic-weekly",
421
- scope: "weekly_global",
422
- scopeKey: "2026-W07",
423
- summary: "Weekly summary that should remain eligible",
424
- tokenEstimate: 12,
425
- startAt: now - 10_000,
426
- endAt: now + 10_000,
427
- createdAt: now,
428
- updatedAt: now,
429
- },
430
- ])
431
- .run();
432
- // Mock Qdrant to return both summaries as search results.
433
- // The new pipeline does not exclude conversation summaries based on
434
- // time overlap with excluded messages — that was old-pipeline behavior.
435
- // Both summaries pass through; we verify the pipeline runs correctly.
436
- mockQdrantResults = [
437
- {
438
- id: "emb-summary-semantic-conversation",
439
- score: 0.95,
440
- payload: {
441
- target_type: "summary",
442
- target_id: "summary-semantic-conversation",
443
- text: "[conversation] Conversation summary containing current turn details",
444
- kind: "conversation",
445
- created_at: now,
446
- last_seen_at: now,
447
- },
448
- },
449
- {
450
- id: "emb-summary-semantic-weekly",
451
- score: 0.9,
452
- payload: {
453
- target_type: "summary",
454
- target_id: "summary-semantic-weekly",
455
- text: "[weekly_global] Weekly summary that should remain eligible",
456
- kind: "global",
457
- created_at: now,
458
- last_seen_at: now,
459
- },
460
- },
461
- ];
462
-
463
- const recall = await withMockOllamaQueryEmbedding(() =>
464
- buildMemoryRecall("summary", conversationId, semanticRecallConfig(), {
465
- excludeMessageIds: ["msg-semantic-summary-excluded"],
466
- }),
467
- );
468
- // Both summaries are returned from Qdrant and both pass post-filtering.
469
- // Verify the pipeline completes successfully with semantic hits.
470
- expect(recall.semanticHits).toBe(2);
471
- expect(recall.injectedText).toContain(
472
- "Weekly summary that should remain eligible",
473
- );
474
- });
475
-
476
- test("indexing enqueues embed_segment, extract_items, and build_conversation_summary for user messages", async () => {
477
- const db = getDb();
478
- const createdAt = 2_000;
479
- db.insert(conversations)
480
- .values({
481
- id: "conv-index",
482
- title: null,
483
- createdAt,
484
- updatedAt: createdAt,
485
- totalInputTokens: 0,
486
- totalOutputTokens: 0,
487
- totalEstimatedCost: 0,
488
- contextSummary: null,
489
- contextCompactedMessageCount: 0,
490
- contextCompactedAt: null,
491
- })
492
- .run();
493
- db.insert(messages)
494
- .values({
495
- id: "msg-index",
496
- conversationId: "conv-index",
497
- role: "user",
498
- content: JSON.stringify([
499
- {
500
- type: "text",
501
- text: "Please remember this important implementation detail about our project configuration.",
502
- },
503
- ]),
504
- createdAt,
505
- })
506
- .run();
507
-
508
- const result = await indexMessageNow(
509
- {
510
- messageId: "msg-index",
511
- conversationId: "conv-index",
512
- role: "user",
513
- content: JSON.stringify([
514
- {
515
- type: "text",
516
- text: "Please remember this important implementation detail about our project configuration.",
517
- },
518
- ]),
519
- createdAt,
520
- },
521
- DEFAULT_CONFIG.memory,
522
- );
523
- // embed_segment (1 segment) — extraction and conversation summary are batched, not per-message
524
- expect(result.enqueuedJobs).toBe(1);
525
-
526
- const embedSegmentJobs = db
527
- .select()
528
- .from(memoryJobs)
529
- .where(eq(memoryJobs.type, "embed_segment"))
530
- .all();
531
- expect(embedSegmentJobs).toHaveLength(1);
532
- });
533
-
534
- test("indexing skips durable item extraction for assistant messages when extractFromAssistant is false", async () => {
535
- const db = getDb();
536
- const createdAt = 2_100;
537
- db.insert(conversations)
538
- .values({
539
- id: "conv-assistant-index",
540
- title: null,
541
- createdAt,
542
- updatedAt: createdAt,
543
- totalInputTokens: 0,
544
- totalOutputTokens: 0,
545
- totalEstimatedCost: 0,
546
- contextSummary: null,
547
- contextCompactedMessageCount: 0,
548
- contextCompactedAt: null,
549
- })
550
- .run();
551
- db.insert(messages)
552
- .values({
553
- id: "msg-assistant-index",
554
- conversationId: "conv-assistant-index",
555
- role: "assistant",
556
- content: JSON.stringify([
557
- {
558
- type: "text",
559
- text: "I think your timezone is PST based on your previous messages and location data.",
560
- },
561
- ]),
562
- createdAt,
563
- })
564
- .run();
565
-
566
- const memoryConfig = {
567
- ...DEFAULT_CONFIG.memory,
568
- extraction: {
569
- ...DEFAULT_CONFIG.memory.extraction,
570
- extractFromAssistant: false,
571
- },
572
- };
573
-
574
- const result = await indexMessageNow(
575
- {
576
- messageId: "msg-assistant-index",
577
- conversationId: "conv-assistant-index",
578
- role: "assistant",
579
- content: JSON.stringify([
580
- {
581
- type: "text",
582
- text: "I think your timezone is PST based on your previous messages and location data.",
583
- },
584
- ]),
585
- createdAt,
586
- },
587
- memoryConfig,
588
- );
589
- // embed_segment (1 segment) — extraction and conversation summary are batched, not per-message
590
- expect(result.enqueuedJobs).toBe(1);
591
-
592
- const extractionJobs = db
593
- .select()
594
- .from(memoryJobs)
595
- .where(eq(memoryJobs.type, "extract_items"))
596
- .all();
597
- expect(extractionJobs).toHaveLength(0);
598
- });
599
-
600
- test("embed jobs complete successfully when backend and Qdrant mock are available", async () => {
601
- const db = getDb();
602
- const now = 3_000;
603
- db.insert(memoryItems)
604
- .values({
605
- id: "item-embed-test",
606
- kind: "identity",
607
- subject: "backend",
608
- statement: "Embedding pipeline test item",
609
- status: "active",
610
- confidence: 0.8,
611
- fingerprint: "item-embed-test-fingerprint",
612
- firstSeenAt: now,
613
- lastSeenAt: now,
614
- lastUsedAt: null,
615
- })
616
- .run();
617
- const jobId = enqueueMemoryJob("embed_item", { itemId: "item-embed-test" });
618
-
619
- const processed = await runMemoryJobsOnce();
620
- expect(processed).toBe(1);
621
-
622
- const row = db
623
- .select()
624
- .from(memoryJobs)
625
- .where(eq(memoryJobs.id, jobId))
626
- .get();
627
- expect(row?.status).toBe("completed");
628
- });
629
- });