@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
@@ -0,0 +1,936 @@
1
+ import { describe, expect, test } from "bun:test";
2
+
3
+ import { parseExtractionResponse } from "./extraction.js";
4
+
5
+ // ---------------------------------------------------------------------------
6
+ // Helpers
7
+ // ---------------------------------------------------------------------------
8
+
9
+ const CONV_ID = "conv-test-1";
10
+ const SCOPE_ID = "default";
11
+ const NOW = Date.now();
12
+
13
+ function parse(input: Record<string, unknown>, candidateIds: string[] = []) {
14
+ return parseExtractionResponse(
15
+ input,
16
+ CONV_ID,
17
+ SCOPE_ID,
18
+ new Set(candidateIds),
19
+ NOW,
20
+ );
21
+ }
22
+
23
+ // ---------------------------------------------------------------------------
24
+ // Node creation
25
+ // ---------------------------------------------------------------------------
26
+
27
+ describe("parseExtractionResponse — node creation", () => {
28
+ test("parses a valid create_node into a NewNode", () => {
29
+ const { diff } = parse({
30
+ create_nodes: [
31
+ {
32
+ content: "User loves hiking.",
33
+ type: "semantic",
34
+ emotional_charge: {
35
+ valence: 0.3,
36
+ intensity: 0.2,
37
+ decay_curve: "linear",
38
+ decay_rate: 0.05,
39
+ },
40
+ significance: 0.6,
41
+ confidence: 0.9,
42
+ source_type: "direct",
43
+ },
44
+ ],
45
+ reinforce_node_ids: [],
46
+ });
47
+
48
+ expect(diff.createNodes).toHaveLength(1);
49
+ const node = diff.createNodes[0];
50
+ expect(node.content).toBe("User loves hiking.");
51
+ expect(node.type).toBe("semantic");
52
+ expect(node.emotionalCharge.valence).toBe(0.3);
53
+ expect(node.emotionalCharge.intensity).toBe(0.2);
54
+ expect(node.emotionalCharge.decayCurve).toBe("linear");
55
+ expect(node.emotionalCharge.decayRate).toBe(0.05);
56
+ expect(node.emotionalCharge.originalIntensity).toBe(0.2);
57
+ expect(node.significance).toBe(0.6);
58
+ expect(node.confidence).toBe(0.9);
59
+ expect(node.sourceType).toBe("direct");
60
+ expect(node.fidelity).toBe("vivid");
61
+ expect(node.stability).toBe(14);
62
+ expect(node.reinforcementCount).toBe(0);
63
+ expect(node.created).toBe(NOW);
64
+ expect(node.sourceConversations).toEqual([CONV_ID]);
65
+ expect(node.scopeId).toBe(SCOPE_ID);
66
+ });
67
+
68
+ test("prospective nodes get stability=5", () => {
69
+ const { diff } = parse({
70
+ create_nodes: [
71
+ {
72
+ content: "Deploy the new version tomorrow.",
73
+ type: "prospective",
74
+ emotional_charge: {
75
+ valence: 0.1,
76
+ intensity: 0.1,
77
+ decay_curve: "linear",
78
+ decay_rate: 0.05,
79
+ },
80
+ significance: 0.5,
81
+ confidence: 0.8,
82
+ source_type: "direct",
83
+ },
84
+ ],
85
+ reinforce_node_ids: [],
86
+ });
87
+
88
+ expect(diff.createNodes[0].stability).toBe(5);
89
+ });
90
+
91
+ test("non-prospective nodes get default stability=14", () => {
92
+ const { diff } = parse({
93
+ create_nodes: [
94
+ {
95
+ content: "User graduated from MIT.",
96
+ type: "semantic",
97
+ emotional_charge: {
98
+ valence: 0.5,
99
+ intensity: 0.3,
100
+ decay_curve: "transformative",
101
+ decay_rate: 0.02,
102
+ },
103
+ significance: 0.7,
104
+ confidence: 0.95,
105
+ source_type: "direct",
106
+ },
107
+ ],
108
+ reinforce_node_ids: [],
109
+ });
110
+
111
+ expect(diff.createNodes[0].stability).toBe(14);
112
+ });
113
+
114
+ test("clamps significance to [0, 1]", () => {
115
+ const { diff } = parse({
116
+ create_nodes: [
117
+ {
118
+ content: "Test",
119
+ type: "semantic",
120
+ emotional_charge: {
121
+ valence: 0,
122
+ intensity: 0,
123
+ decay_curve: "linear",
124
+ decay_rate: 0.05,
125
+ },
126
+ significance: 1.5, // over max
127
+ confidence: 0.5,
128
+ source_type: "direct",
129
+ },
130
+ ],
131
+ reinforce_node_ids: [],
132
+ });
133
+ expect(diff.createNodes[0].significance).toBe(1.0);
134
+ });
135
+
136
+ test("clamps negative significance to 0", () => {
137
+ const { diff } = parse({
138
+ create_nodes: [
139
+ {
140
+ content: "Test",
141
+ type: "semantic",
142
+ emotional_charge: {
143
+ valence: 0,
144
+ intensity: 0,
145
+ decay_curve: "linear",
146
+ decay_rate: 0.05,
147
+ },
148
+ significance: -0.5,
149
+ confidence: 0.5,
150
+ source_type: "direct",
151
+ },
152
+ ],
153
+ reinforce_node_ids: [],
154
+ });
155
+ expect(diff.createNodes[0].significance).toBe(0);
156
+ });
157
+
158
+ test("clamps valence to [-1, 1]", () => {
159
+ const { diff } = parse({
160
+ create_nodes: [
161
+ {
162
+ content: "Test",
163
+ type: "semantic",
164
+ emotional_charge: {
165
+ valence: 2.0,
166
+ intensity: 0.5,
167
+ decay_curve: "linear",
168
+ decay_rate: 0.05,
169
+ },
170
+ significance: 0.5,
171
+ confidence: 0.5,
172
+ source_type: "direct",
173
+ },
174
+ ],
175
+ reinforce_node_ids: [],
176
+ });
177
+ expect(diff.createNodes[0].emotionalCharge.valence).toBe(1);
178
+ });
179
+
180
+ test("defaults invalid decay_curve to linear", () => {
181
+ const { diff } = parse({
182
+ create_nodes: [
183
+ {
184
+ content: "Test",
185
+ type: "semantic",
186
+ emotional_charge: {
187
+ valence: 0,
188
+ intensity: 0.5,
189
+ decay_curve: "bogus",
190
+ decay_rate: 0.05,
191
+ },
192
+ significance: 0.5,
193
+ confidence: 0.5,
194
+ source_type: "direct",
195
+ },
196
+ ],
197
+ reinforce_node_ids: [],
198
+ });
199
+ expect(diff.createNodes[0].emotionalCharge.decayCurve).toBe("linear");
200
+ });
201
+
202
+ test("defaults invalid source_type to inferred", () => {
203
+ const { diff } = parse({
204
+ create_nodes: [
205
+ {
206
+ content: "Test",
207
+ type: "semantic",
208
+ emotional_charge: {
209
+ valence: 0,
210
+ intensity: 0,
211
+ decay_curve: "linear",
212
+ decay_rate: 0.05,
213
+ },
214
+ significance: 0.5,
215
+ confidence: 0.5,
216
+ source_type: "bogus",
217
+ },
218
+ ],
219
+ reinforce_node_ids: [],
220
+ });
221
+ expect(diff.createNodes[0].sourceType).toBe("inferred");
222
+ });
223
+
224
+ test("skips nodes with missing content", () => {
225
+ const { diff } = parse({
226
+ create_nodes: [{ type: "semantic" }],
227
+ reinforce_node_ids: [],
228
+ });
229
+ expect(diff.createNodes).toHaveLength(0);
230
+ });
231
+
232
+ test("skips nodes with invalid type", () => {
233
+ const { diff } = parse({
234
+ create_nodes: [
235
+ {
236
+ content: "Test",
237
+ type: "invalid_type",
238
+ emotional_charge: {
239
+ valence: 0,
240
+ intensity: 0,
241
+ decay_curve: "linear",
242
+ decay_rate: 0.05,
243
+ },
244
+ significance: 0.5,
245
+ confidence: 0.5,
246
+ source_type: "direct",
247
+ },
248
+ ],
249
+ reinforce_node_ids: [],
250
+ });
251
+ expect(diff.createNodes).toHaveLength(0);
252
+ });
253
+
254
+ test("defaults missing emotional_charge fields", () => {
255
+ const { diff } = parse({
256
+ create_nodes: [
257
+ {
258
+ content: "Test",
259
+ type: "semantic",
260
+ emotional_charge: {}, // all fields missing
261
+ significance: 0.5,
262
+ confidence: 0.5,
263
+ source_type: "direct",
264
+ },
265
+ ],
266
+ reinforce_node_ids: [],
267
+ });
268
+ const charge = diff.createNodes[0].emotionalCharge;
269
+ expect(charge.valence).toBe(0);
270
+ expect(charge.intensity).toBe(0);
271
+ expect(charge.decayCurve).toBe("linear");
272
+ expect(charge.decayRate).toBe(0.05);
273
+ expect(charge.originalIntensity).toBe(0);
274
+ });
275
+ });
276
+
277
+ // ---------------------------------------------------------------------------
278
+ // Reinforcement
279
+ // ---------------------------------------------------------------------------
280
+
281
+ describe("parseExtractionResponse — reinforcement", () => {
282
+ test("only includes IDs that exist in candidate set", () => {
283
+ const { diff } = parse(
284
+ {
285
+ create_nodes: [],
286
+ reinforce_node_ids: ["existing-1", "fake-id", "existing-2"],
287
+ },
288
+ ["existing-1", "existing-2"],
289
+ );
290
+ expect(diff.reinforceNodeIds).toEqual(["existing-1", "existing-2"]);
291
+ });
292
+
293
+ test("returns empty array when no IDs match candidates", () => {
294
+ const { diff } = parse(
295
+ {
296
+ create_nodes: [],
297
+ reinforce_node_ids: ["fake-1", "fake-2"],
298
+ },
299
+ ["real-1"],
300
+ );
301
+ expect(diff.reinforceNodeIds).toEqual([]);
302
+ });
303
+ });
304
+
305
+ // ---------------------------------------------------------------------------
306
+ // Node updates
307
+ // ---------------------------------------------------------------------------
308
+
309
+ describe("parseExtractionResponse — updates", () => {
310
+ test("parses content update for existing node", () => {
311
+ const { diff } = parse(
312
+ {
313
+ create_nodes: [],
314
+ reinforce_node_ids: [],
315
+ update_nodes: [{ id: "node-1", content: "Updated content." }],
316
+ },
317
+ ["node-1"],
318
+ );
319
+ expect(diff.updateNodes).toHaveLength(1);
320
+ expect(diff.updateNodes[0].id).toBe("node-1");
321
+ expect(diff.updateNodes[0].changes.content).toBe("Updated content.");
322
+ });
323
+
324
+ test("parses fidelity downgrade", () => {
325
+ const { diff } = parse(
326
+ {
327
+ create_nodes: [],
328
+ reinforce_node_ids: [],
329
+ update_nodes: [{ id: "node-1", fidelity: "gist" }],
330
+ },
331
+ ["node-1"],
332
+ );
333
+ expect(diff.updateNodes[0].changes.fidelity).toBe("gist");
334
+ });
335
+
336
+ test("ignores invalid fidelity values", () => {
337
+ const { diff } = parse(
338
+ {
339
+ create_nodes: [],
340
+ reinforce_node_ids: [],
341
+ update_nodes: [{ id: "node-1", fidelity: "super-vivid" }],
342
+ },
343
+ ["node-1"],
344
+ );
345
+ // No valid changes → should not produce an update entry
346
+ expect(diff.updateNodes).toHaveLength(0);
347
+ });
348
+
349
+ test("clamps updated significance to [0, 1]", () => {
350
+ const { diff } = parse(
351
+ {
352
+ create_nodes: [],
353
+ reinforce_node_ids: [],
354
+ update_nodes: [{ id: "node-1", significance: 1.5 }],
355
+ },
356
+ ["node-1"],
357
+ );
358
+ expect(diff.updateNodes[0].changes.significance).toBe(1.0);
359
+ });
360
+
361
+ test("skips updates for nodes not in candidate set", () => {
362
+ const { diff } = parse(
363
+ {
364
+ create_nodes: [],
365
+ reinforce_node_ids: [],
366
+ update_nodes: [{ id: "unknown-node", content: "New content." }],
367
+ },
368
+ ["node-1"],
369
+ );
370
+ expect(diff.updateNodes).toHaveLength(0);
371
+ });
372
+ });
373
+
374
+ // ---------------------------------------------------------------------------
375
+ // Edges between existing nodes
376
+ // ---------------------------------------------------------------------------
377
+
378
+ describe("parseExtractionResponse — edges", () => {
379
+ test("creates edges between existing candidate nodes", () => {
380
+ const { diff } = parse(
381
+ {
382
+ create_nodes: [],
383
+ reinforce_node_ids: [],
384
+ new_edges: [
385
+ {
386
+ source_node_id: "a",
387
+ target_node_id: "b",
388
+ relationship: "caused-by",
389
+ weight: 0.8,
390
+ },
391
+ ],
392
+ },
393
+ ["a", "b"],
394
+ );
395
+ expect(diff.createEdges).toHaveLength(1);
396
+ expect(diff.createEdges[0].sourceNodeId).toBe("a");
397
+ expect(diff.createEdges[0].targetNodeId).toBe("b");
398
+ expect(diff.createEdges[0].relationship).toBe("caused-by");
399
+ expect(diff.createEdges[0].weight).toBe(0.8);
400
+ });
401
+
402
+ test("skips edges referencing non-candidate nodes", () => {
403
+ const { diff } = parse(
404
+ {
405
+ create_nodes: [],
406
+ reinforce_node_ids: [],
407
+ new_edges: [
408
+ {
409
+ source_node_id: "a",
410
+ target_node_id: "unknown",
411
+ relationship: "caused-by",
412
+ },
413
+ ],
414
+ },
415
+ ["a"],
416
+ );
417
+ expect(diff.createEdges).toHaveLength(0);
418
+ });
419
+
420
+ test("skips edges with invalid relationships", () => {
421
+ const { diff } = parse(
422
+ {
423
+ create_nodes: [],
424
+ reinforce_node_ids: [],
425
+ new_edges: [
426
+ {
427
+ source_node_id: "a",
428
+ target_node_id: "b",
429
+ relationship: "invalid-rel",
430
+ },
431
+ ],
432
+ },
433
+ ["a", "b"],
434
+ );
435
+ expect(diff.createEdges).toHaveLength(0);
436
+ });
437
+
438
+ test("defaults edge weight to 1.0", () => {
439
+ const { diff } = parse(
440
+ {
441
+ create_nodes: [],
442
+ reinforce_node_ids: [],
443
+ new_edges: [
444
+ {
445
+ source_node_id: "a",
446
+ target_node_id: "b",
447
+ relationship: "reminds-of",
448
+ },
449
+ ],
450
+ },
451
+ ["a", "b"],
452
+ );
453
+ expect(diff.createEdges[0].weight).toBe(1.0);
454
+ });
455
+ });
456
+
457
+ // ---------------------------------------------------------------------------
458
+ // Deferred edges (new node → existing node)
459
+ // ---------------------------------------------------------------------------
460
+
461
+ describe("parseExtractionResponse — deferred edges", () => {
462
+ test("collects edges from new nodes to existing candidates", () => {
463
+ const { deferredEdges } = parse(
464
+ {
465
+ create_nodes: [
466
+ {
467
+ content: "New memory.",
468
+ type: "episodic",
469
+ emotional_charge: {
470
+ valence: 0,
471
+ intensity: 0,
472
+ decay_curve: "linear",
473
+ decay_rate: 0.05,
474
+ },
475
+ significance: 0.5,
476
+ confidence: 0.5,
477
+ source_type: "direct",
478
+ edges_to_existing: [
479
+ {
480
+ target_node_id: "existing-1",
481
+ relationship: "caused-by",
482
+ weight: 0.7,
483
+ },
484
+ ],
485
+ },
486
+ ],
487
+ reinforce_node_ids: [],
488
+ },
489
+ ["existing-1"],
490
+ );
491
+ expect(deferredEdges).toHaveLength(1);
492
+ expect(deferredEdges[0].newNodeIndex).toBe(0);
493
+ expect(deferredEdges[0].targetNodeId).toBe("existing-1");
494
+ expect(deferredEdges[0].relationship).toBe("caused-by");
495
+ expect(deferredEdges[0].weight).toBe(0.7);
496
+ });
497
+
498
+ test("ignores deferred edges to non-candidate targets", () => {
499
+ const { deferredEdges } = parse(
500
+ {
501
+ create_nodes: [
502
+ {
503
+ content: "New memory.",
504
+ type: "episodic",
505
+ emotional_charge: {
506
+ valence: 0,
507
+ intensity: 0,
508
+ decay_curve: "linear",
509
+ decay_rate: 0.05,
510
+ },
511
+ significance: 0.5,
512
+ confidence: 0.5,
513
+ source_type: "direct",
514
+ edges_to_existing: [
515
+ {
516
+ target_node_id: "non-existing",
517
+ relationship: "caused-by",
518
+ },
519
+ ],
520
+ },
521
+ ],
522
+ reinforce_node_ids: [],
523
+ },
524
+ ["other-node"],
525
+ );
526
+ expect(deferredEdges).toHaveLength(0);
527
+ });
528
+ });
529
+
530
+ // ---------------------------------------------------------------------------
531
+ // Deferred triggers
532
+ // ---------------------------------------------------------------------------
533
+
534
+ describe("parseExtractionResponse — deferred triggers", () => {
535
+ test("collects temporal triggers for new nodes", () => {
536
+ const { deferredTriggers } = parse({
537
+ create_nodes: [
538
+ {
539
+ content: "Check in every Monday.",
540
+ type: "prospective",
541
+ emotional_charge: {
542
+ valence: 0,
543
+ intensity: 0,
544
+ decay_curve: "linear",
545
+ decay_rate: 0.05,
546
+ },
547
+ significance: 0.4,
548
+ confidence: 0.8,
549
+ source_type: "direct",
550
+ triggers: [
551
+ {
552
+ type: "temporal",
553
+ schedule: "day-of-week:monday",
554
+ recurring: true,
555
+ },
556
+ ],
557
+ },
558
+ ],
559
+ reinforce_node_ids: [],
560
+ });
561
+
562
+ expect(deferredTriggers).toHaveLength(1);
563
+ expect(deferredTriggers[0].newNodeIndex).toBe(0);
564
+ expect(deferredTriggers[0].trigger.type).toBe("temporal");
565
+ expect(deferredTriggers[0].trigger.schedule).toBe("day-of-week:monday");
566
+ expect(deferredTriggers[0].trigger.recurring).toBe(true);
567
+ expect(deferredTriggers[0].trigger.cooldownMs).toBe(1000 * 60 * 60 * 12);
568
+ });
569
+
570
+ test("collects semantic triggers with default threshold 0.7", () => {
571
+ const { deferredTriggers } = parse({
572
+ create_nodes: [
573
+ {
574
+ content: "When cooking comes up, mention the recipe.",
575
+ type: "semantic",
576
+ emotional_charge: {
577
+ valence: 0.3,
578
+ intensity: 0.2,
579
+ decay_curve: "linear",
580
+ decay_rate: 0.05,
581
+ },
582
+ significance: 0.4,
583
+ confidence: 0.7,
584
+ source_type: "direct",
585
+ triggers: [
586
+ {
587
+ type: "semantic",
588
+ condition: "topic of cooking comes up",
589
+ },
590
+ ],
591
+ },
592
+ ],
593
+ reinforce_node_ids: [],
594
+ });
595
+
596
+ expect(deferredTriggers[0].trigger.type).toBe("semantic");
597
+ expect(deferredTriggers[0].trigger.threshold).toBe(0.7);
598
+ expect(deferredTriggers[0].trigger.condition).toBe(
599
+ "topic of cooking comes up",
600
+ );
601
+ });
602
+
603
+ test("collects event triggers with date and ramp settings", () => {
604
+ const eventDate = Date.now() + 7 * 24 * 60 * 60 * 1000;
605
+ const { deferredTriggers } = parse({
606
+ create_nodes: [
607
+ {
608
+ content: "Trip next week.",
609
+ type: "prospective",
610
+ emotional_charge: {
611
+ valence: 0.5,
612
+ intensity: 0.4,
613
+ decay_curve: "linear",
614
+ decay_rate: 0.05,
615
+ },
616
+ significance: 0.6,
617
+ confidence: 0.9,
618
+ source_type: "direct",
619
+ triggers: [
620
+ {
621
+ type: "event",
622
+ event_date: eventDate,
623
+ ramp_days: 5,
624
+ follow_up_days: 3,
625
+ },
626
+ ],
627
+ },
628
+ ],
629
+ reinforce_node_ids: [],
630
+ });
631
+
632
+ expect(deferredTriggers[0].trigger.type).toBe("event");
633
+ expect(deferredTriggers[0].trigger.eventDate).toBe(eventDate);
634
+ expect(deferredTriggers[0].trigger.rampDays).toBe(5);
635
+ expect(deferredTriggers[0].trigger.followUpDays).toBe(3);
636
+ });
637
+
638
+ test("skips triggers with invalid types", () => {
639
+ const { deferredTriggers } = parse({
640
+ create_nodes: [
641
+ {
642
+ content: "Test.",
643
+ type: "semantic",
644
+ emotional_charge: {
645
+ valence: 0,
646
+ intensity: 0,
647
+ decay_curve: "linear",
648
+ decay_rate: 0.05,
649
+ },
650
+ significance: 0.5,
651
+ confidence: 0.5,
652
+ source_type: "direct",
653
+ triggers: [{ type: "invalid-type" }],
654
+ },
655
+ ],
656
+ reinforce_node_ids: [],
657
+ });
658
+ expect(deferredTriggers).toHaveLength(0);
659
+ });
660
+
661
+ test("non-recurring triggers get null cooldownMs", () => {
662
+ const { deferredTriggers } = parse({
663
+ create_nodes: [
664
+ {
665
+ content: "One-time check.",
666
+ type: "prospective",
667
+ emotional_charge: {
668
+ valence: 0,
669
+ intensity: 0,
670
+ decay_curve: "linear",
671
+ decay_rate: 0.05,
672
+ },
673
+ significance: 0.5,
674
+ confidence: 0.5,
675
+ source_type: "direct",
676
+ triggers: [
677
+ {
678
+ type: "temporal",
679
+ schedule: "date:04-08",
680
+ recurring: false,
681
+ },
682
+ ],
683
+ },
684
+ ],
685
+ reinforce_node_ids: [],
686
+ });
687
+ expect(deferredTriggers[0].trigger.recurring).toBe(false);
688
+ expect(deferredTriggers[0].trigger.cooldownMs).toBeNull();
689
+ });
690
+ });
691
+
692
+ // ---------------------------------------------------------------------------
693
+ // event_date parsing
694
+ // ---------------------------------------------------------------------------
695
+
696
+ describe("parseExtractionResponse — event_date parsing", () => {
697
+ test("parses event_date onto node.eventDate", () => {
698
+ const eventDate = NOW + 7 * 24 * 60 * 60 * 1000;
699
+ const { diff } = parse({
700
+ create_nodes: [
701
+ {
702
+ content: "Flight to NYC on April 8.",
703
+ type: "prospective",
704
+ emotional_charge: {
705
+ valence: 0.4,
706
+ intensity: 0.3,
707
+ decay_curve: "linear",
708
+ decay_rate: 0.05,
709
+ },
710
+ significance: 0.6,
711
+ confidence: 0.9,
712
+ source_type: "direct",
713
+ event_date: eventDate,
714
+ },
715
+ ],
716
+ reinforce_node_ids: [],
717
+ });
718
+
719
+ expect(diff.createNodes).toHaveLength(1);
720
+ expect(diff.createNodes[0].eventDate).toBe(eventDate);
721
+ });
722
+
723
+ test("event_date: null results in eventDate: null", () => {
724
+ const { diff } = parse({
725
+ create_nodes: [
726
+ {
727
+ content: "User likes hiking.",
728
+ type: "semantic",
729
+ emotional_charge: {
730
+ valence: 0.3,
731
+ intensity: 0.2,
732
+ decay_curve: "linear",
733
+ decay_rate: 0.05,
734
+ },
735
+ significance: 0.5,
736
+ confidence: 0.8,
737
+ source_type: "direct",
738
+ event_date: null,
739
+ },
740
+ ],
741
+ reinforce_node_ids: [],
742
+ });
743
+
744
+ expect(diff.createNodes[0].eventDate).toBeNull();
745
+ });
746
+
747
+ test("missing event_date results in eventDate: null", () => {
748
+ const { diff } = parse({
749
+ create_nodes: [
750
+ {
751
+ content: "User likes dark mode.",
752
+ type: "semantic",
753
+ emotional_charge: {
754
+ valence: 0,
755
+ intensity: 0.1,
756
+ decay_curve: "linear",
757
+ decay_rate: 0.05,
758
+ },
759
+ significance: 0.3,
760
+ confidence: 0.9,
761
+ source_type: "direct",
762
+ },
763
+ ],
764
+ reinforce_node_ids: [],
765
+ });
766
+
767
+ expect(diff.createNodes[0].eventDate).toBeNull();
768
+ });
769
+ });
770
+
771
+ // ---------------------------------------------------------------------------
772
+ // Auto-trigger for event_date
773
+ // ---------------------------------------------------------------------------
774
+
775
+ describe("parseExtractionResponse — event_date auto-trigger", () => {
776
+ test("auto-creates event trigger when event_date is set but no event trigger provided", () => {
777
+ const eventDate = NOW + 7 * 24 * 60 * 60 * 1000;
778
+ const { diff, deferredTriggers } = parse({
779
+ create_nodes: [
780
+ {
781
+ content: "Dentist appointment next week.",
782
+ type: "prospective",
783
+ emotional_charge: {
784
+ valence: -0.1,
785
+ intensity: 0.2,
786
+ decay_curve: "linear",
787
+ decay_rate: 0.05,
788
+ },
789
+ significance: 0.5,
790
+ confidence: 0.9,
791
+ source_type: "direct",
792
+ event_date: eventDate,
793
+ },
794
+ ],
795
+ reinforce_node_ids: [],
796
+ });
797
+
798
+ expect(diff.createNodes).toHaveLength(1);
799
+ expect(diff.createNodes[0].eventDate).toBe(eventDate);
800
+ expect(deferredTriggers).toHaveLength(1);
801
+ expect(deferredTriggers[0].newNodeIndex).toBe(0);
802
+ expect(deferredTriggers[0].trigger.type).toBe("event");
803
+ expect(deferredTriggers[0].trigger.eventDate).toBe(eventDate);
804
+ expect(deferredTriggers[0].trigger.rampDays).toBe(7);
805
+ expect(deferredTriggers[0].trigger.followUpDays).toBe(2);
806
+ expect(deferredTriggers[0].trigger.recurring).toBe(false);
807
+ expect(deferredTriggers[0].trigger.consumed).toBe(false);
808
+ expect(deferredTriggers[0].trigger.cooldownMs).toBeNull();
809
+ });
810
+
811
+ test("no duplicate trigger when LLM already provided an event trigger", () => {
812
+ const eventDate = NOW + 7 * 24 * 60 * 60 * 1000;
813
+ const { deferredTriggers } = parse({
814
+ create_nodes: [
815
+ {
816
+ content: "Trip to Paris next week.",
817
+ type: "prospective",
818
+ emotional_charge: {
819
+ valence: 0.6,
820
+ intensity: 0.5,
821
+ decay_curve: "linear",
822
+ decay_rate: 0.05,
823
+ },
824
+ significance: 0.7,
825
+ confidence: 0.9,
826
+ source_type: "direct",
827
+ event_date: eventDate,
828
+ triggers: [
829
+ {
830
+ type: "event",
831
+ event_date: eventDate,
832
+ ramp_days: 5,
833
+ follow_up_days: 3,
834
+ },
835
+ ],
836
+ },
837
+ ],
838
+ reinforce_node_ids: [],
839
+ });
840
+
841
+ // Should only have the LLM-provided trigger, no auto-created duplicate
842
+ expect(deferredTriggers).toHaveLength(1);
843
+ expect(deferredTriggers[0].trigger.type).toBe("event");
844
+ expect(deferredTriggers[0].trigger.rampDays).toBe(5); // LLM's value, not auto-trigger's 7
845
+ });
846
+
847
+ test("auto-creates event trigger alongside non-event triggers", () => {
848
+ const eventDate = NOW + 14 * 24 * 60 * 60 * 1000;
849
+ const { deferredTriggers } = parse({
850
+ create_nodes: [
851
+ {
852
+ content: "Project deadline in two weeks.",
853
+ type: "prospective",
854
+ emotional_charge: {
855
+ valence: -0.2,
856
+ intensity: 0.4,
857
+ decay_curve: "linear",
858
+ decay_rate: 0.05,
859
+ },
860
+ significance: 0.6,
861
+ confidence: 0.8,
862
+ source_type: "direct",
863
+ event_date: eventDate,
864
+ triggers: [
865
+ {
866
+ type: "semantic",
867
+ condition: "project deadline discussion",
868
+ },
869
+ ],
870
+ },
871
+ ],
872
+ reinforce_node_ids: [],
873
+ });
874
+
875
+ // Should have the LLM-provided semantic trigger plus an auto-created event trigger
876
+ expect(deferredTriggers).toHaveLength(2);
877
+ const types = deferredTriggers.map((t) => t.trigger.type);
878
+ expect(types).toContain("semantic");
879
+ expect(types).toContain("event");
880
+
881
+ const autoTrigger = deferredTriggers.find(
882
+ (t) => t.trigger.type === "event",
883
+ )!;
884
+ expect(autoTrigger.trigger.eventDate).toBe(eventDate);
885
+ expect(autoTrigger.trigger.rampDays).toBe(7);
886
+ });
887
+
888
+ test("no auto-trigger when event_date is not set", () => {
889
+ const { deferredTriggers } = parse({
890
+ create_nodes: [
891
+ {
892
+ content: "User likes functional programming.",
893
+ type: "semantic",
894
+ emotional_charge: {
895
+ valence: 0.2,
896
+ intensity: 0.1,
897
+ decay_curve: "linear",
898
+ decay_rate: 0.05,
899
+ },
900
+ significance: 0.3,
901
+ confidence: 0.9,
902
+ source_type: "direct",
903
+ },
904
+ ],
905
+ reinforce_node_ids: [],
906
+ });
907
+
908
+ expect(deferredTriggers).toHaveLength(0);
909
+ });
910
+ });
911
+
912
+ // ---------------------------------------------------------------------------
913
+ // Empty / missing fields
914
+ // ---------------------------------------------------------------------------
915
+
916
+ describe("parseExtractionResponse — robustness", () => {
917
+ test("handles completely empty input", () => {
918
+ const { diff, deferredEdges, deferredTriggers } = parse({});
919
+ expect(diff.createNodes).toHaveLength(0);
920
+ expect(diff.updateNodes).toHaveLength(0);
921
+ expect(diff.reinforceNodeIds).toEqual([]);
922
+ expect(diff.createEdges).toHaveLength(0);
923
+ expect(deferredEdges).toHaveLength(0);
924
+ expect(deferredTriggers).toHaveLength(0);
925
+ });
926
+
927
+ test("handles missing create_nodes gracefully", () => {
928
+ const { diff } = parse({ reinforce_node_ids: [] });
929
+ expect(diff.createNodes).toHaveLength(0);
930
+ });
931
+
932
+ test("handles missing reinforce_node_ids gracefully", () => {
933
+ const { diff } = parse({ create_nodes: [] });
934
+ expect(diff.reinforceNodeIds).toEqual([]);
935
+ });
936
+ });