@vellumai/assistant 0.5.16 → 0.6.1

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 (592) hide show
  1. package/AGENTS.md +4 -0
  2. package/ARCHITECTURE.md +69 -16
  3. package/Dockerfile +2 -5
  4. package/bun.lock +6 -2
  5. package/docker-entrypoint.sh +32 -1
  6. package/docs/architecture/integrations.md +1 -1
  7. package/docs/architecture/memory.md +21 -24
  8. package/knip.json +2 -1
  9. package/openapi.yaml +1198 -83
  10. package/package.json +5 -1
  11. package/src/__tests__/actor-token-service.test.ts +68 -0
  12. package/src/__tests__/agent-loop.test.ts +0 -32
  13. package/src/__tests__/always-loaded-tools-guard.test.ts +2 -2
  14. package/src/__tests__/anthropic-provider.test.ts +217 -98
  15. package/src/__tests__/app-compiler.test.ts +120 -0
  16. package/src/__tests__/app-dir-path-guard.test.ts +1 -0
  17. package/src/__tests__/app-executors.test.ts +47 -1
  18. package/src/__tests__/app-source-watcher.test.ts +159 -0
  19. package/src/__tests__/assistant-feature-flags-integration.test.ts +2 -2
  20. package/src/__tests__/call-conversation-messages.test.ts +2 -6
  21. package/src/__tests__/call-domain.test.ts +2 -6
  22. package/src/__tests__/call-pointer-messages.test.ts +2 -14
  23. package/src/__tests__/call-recovery.test.ts +2 -6
  24. package/src/__tests__/call-routes-http.test.ts +2 -6
  25. package/src/__tests__/call-store.test.ts +2 -6
  26. package/src/__tests__/cancel-resolves-conversation-key.test.ts +2 -6
  27. package/src/__tests__/canonical-guardian-store.test.ts +2 -6
  28. package/src/__tests__/channel-delivery-store.test.ts +2 -6
  29. package/src/__tests__/channel-retry-sweep.test.ts +2 -6
  30. package/src/__tests__/checker.test.ts +63 -9
  31. package/src/__tests__/clawhub.test.ts +54 -24
  32. package/src/__tests__/cli-command-risk-guard.test.ts +14 -0
  33. package/src/__tests__/config-schema.test.ts +6 -1
  34. package/src/__tests__/config-set-platform-guard.test.ts +302 -0
  35. package/src/__tests__/confirmation-request-guardian-bridge.test.ts +2 -6
  36. package/src/__tests__/contacts-tools.test.ts +31 -0
  37. package/src/__tests__/context-overflow-reducer.test.ts +86 -0
  38. package/src/__tests__/context-token-estimator.test.ts +175 -10
  39. package/src/__tests__/conversation-agent-loop-overflow.test.ts +13 -6
  40. package/src/__tests__/conversation-agent-loop.test.ts +13 -51
  41. package/src/__tests__/conversation-attachments.test.ts +2 -6
  42. package/src/__tests__/conversation-attention-store.test.ts +2 -6
  43. package/src/__tests__/conversation-clear-safety.test.ts +2 -6
  44. package/src/__tests__/conversation-delete-schedule-cleanup.test.ts +4 -10
  45. package/src/__tests__/conversation-disk-view-integration.test.ts +2 -6
  46. package/src/__tests__/conversation-disk-view.test.ts +2 -6
  47. package/src/__tests__/conversation-error.test.ts +33 -2
  48. package/src/__tests__/conversation-fork-crud.test.ts +2 -6
  49. package/src/__tests__/conversation-history-web-search.test.ts +6 -1
  50. package/src/__tests__/conversation-load-history-repair.test.ts +5 -1
  51. package/src/__tests__/conversation-media-retry.test.ts +91 -0
  52. package/src/__tests__/conversation-runtime-assembly.test.ts +653 -832
  53. package/src/__tests__/conversation-runtime-workspace.test.ts +1 -93
  54. package/src/__tests__/conversation-starter-routes.test.ts +20 -11
  55. package/src/__tests__/conversation-store.test.ts +2 -6
  56. package/src/__tests__/conversation-tool-setup-app-refresh.test.ts +17 -4
  57. package/src/__tests__/conversation-usage.test.ts +2 -6
  58. package/src/__tests__/conversation-wipe.test.ts +13 -414
  59. package/src/__tests__/conversation-workspace-cache-state.test.ts +6 -12
  60. package/src/__tests__/conversation-workspace-injection.test.ts +25 -26
  61. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +1 -1
  62. package/src/__tests__/copy-composer-tc-templates.test.ts +335 -0
  63. package/src/__tests__/credential-execution-feature-gates.test.ts +3 -3
  64. package/src/__tests__/credential-execution-shell-lockdown.test.ts +2 -2
  65. package/src/__tests__/credential-security-e2e.test.ts +2 -0
  66. package/src/__tests__/date-context.test.ts +76 -210
  67. package/src/__tests__/db-schedule-syntax-migration.test.ts +16 -1
  68. package/src/__tests__/file-list-tool.test.ts +219 -0
  69. package/src/__tests__/first-greeting.test.ts +1 -1
  70. package/src/__tests__/followup-tools.test.ts +2 -6
  71. package/src/__tests__/graph-extraction-event-date.test.ts +186 -0
  72. package/src/__tests__/guardian-action-conversation-turn.test.ts +2 -6
  73. package/src/__tests__/guardian-action-followup-executor.test.ts +2 -6
  74. package/src/__tests__/guardian-action-followup-store.test.ts +2 -6
  75. package/src/__tests__/guardian-action-grant-mint-consume.test.ts +2 -6
  76. package/src/__tests__/guardian-action-late-reply.test.ts +2 -6
  77. package/src/__tests__/guardian-action-store.test.ts +2 -6
  78. package/src/__tests__/guardian-binding-drift-heal.test.ts +2 -6
  79. package/src/__tests__/guardian-decision-primitive-canonical.test.ts +8 -8
  80. package/src/__tests__/guardian-dispatch.test.ts +2 -6
  81. package/src/__tests__/guardian-grant-minting.test.ts +2 -14
  82. package/src/__tests__/guardian-principal-id-roundtrip.test.ts +2 -6
  83. package/src/__tests__/guardian-routing-invariants.test.ts +192 -6
  84. package/src/__tests__/guardian-routing-state.test.ts +2 -6
  85. package/src/__tests__/guardian-verification-voice-binding.test.ts +2 -6
  86. package/src/__tests__/heartbeat-service.test.ts +180 -3
  87. package/src/__tests__/identity-routes.test.ts +328 -0
  88. package/src/__tests__/inbound-invite-redemption.test.ts +2 -6
  89. package/src/__tests__/injection-block.test.ts +178 -0
  90. package/src/__tests__/install-meta.test.ts +506 -0
  91. package/src/__tests__/install-skill-routing.test.ts +293 -0
  92. package/src/__tests__/invite-redemption-service.test.ts +2 -6
  93. package/src/__tests__/invite-routes-http.test.ts +2 -6
  94. package/src/__tests__/jobs-store-qdrant-breaker.test.ts +17 -28
  95. package/src/__tests__/list-messages-attachments.test.ts +2 -6
  96. package/src/__tests__/list-messages-tool-merge.test.ts +300 -0
  97. package/src/__tests__/llm-context-normalization.test.ts +18 -18
  98. package/src/__tests__/llm-context-route-provider.test.ts +103 -6
  99. package/src/__tests__/llm-request-log-turn-query.test.ts +164 -6
  100. package/src/__tests__/llm-usage-store.test.ts +2 -6
  101. package/src/__tests__/log-export-workspace.test.ts +74 -111
  102. package/src/__tests__/managed-store.test.ts +38 -11
  103. package/src/__tests__/mcp-abort-signal.test.ts +5 -0
  104. package/src/__tests__/mcp-client-auth.test.ts +5 -0
  105. package/src/__tests__/memory-jobs-worker-backoff.test.ts +2 -8
  106. package/src/__tests__/memory-recall-log-store.test.ts +134 -6
  107. package/src/__tests__/memory-upsert-concurrency.test.ts +4 -112
  108. package/src/__tests__/migration-export-streaming.test.ts +304 -0
  109. package/src/__tests__/migration-import-commit-http.test.ts +11 -10
  110. package/src/__tests__/mock-fetch.ts +87 -0
  111. package/src/__tests__/non-member-access-request.test.ts +2 -6
  112. package/src/__tests__/notification-decision-recipient-context.test.ts +282 -0
  113. package/src/__tests__/notification-guardian-path.test.ts +2 -6
  114. package/src/__tests__/oauth-cli.test.ts +364 -2
  115. package/src/__tests__/oauth2-gateway-transport.test.ts +18 -3
  116. package/src/__tests__/onboarding-template-contract.test.ts +62 -14
  117. package/src/__tests__/outlook-attachments.test.ts +301 -0
  118. package/src/__tests__/outlook-automation-tools.test.ts +425 -0
  119. package/src/__tests__/outlook-categories.test.ts +212 -0
  120. package/src/__tests__/outlook-client-automation.test.ts +246 -0
  121. package/src/__tests__/outlook-compose-tools.test.ts +325 -0
  122. package/src/__tests__/outlook-declutter-tools.test.ts +585 -0
  123. package/src/__tests__/outlook-email-watcher.test.ts +322 -0
  124. package/src/__tests__/outlook-follow-up.test.ts +196 -0
  125. package/src/__tests__/outlook-messaging-provider.test.ts +498 -3
  126. package/src/__tests__/outlook-trash.test.ts +77 -0
  127. package/src/__tests__/outlook-unsubscribe.test.ts +250 -0
  128. package/src/__tests__/parser.test.ts +32 -0
  129. package/src/__tests__/permission-checker-host-gate.test.ts +452 -0
  130. package/src/__tests__/permission-controls-v2-flag.test.ts +55 -0
  131. package/src/__tests__/permission-mode-sse.test.ts +418 -0
  132. package/src/__tests__/permission-mode-store.test.ts +277 -0
  133. package/src/__tests__/permission-mode.test.ts +101 -0
  134. package/src/__tests__/platform-bash-auto-approve.test.ts +359 -0
  135. package/src/__tests__/platform-callback-registration.test.ts +4 -4
  136. package/src/__tests__/playbook-execution.test.ts +76 -80
  137. package/src/__tests__/playbook-tools.test.ts +5 -7
  138. package/src/__tests__/profiler-routes.test.ts +502 -0
  139. package/src/__tests__/profiler-run-store.test.ts +441 -0
  140. package/src/__tests__/provider-error-scenarios.test.ts +21 -0
  141. package/src/__tests__/proxy-approval-callback.test.ts +4 -75
  142. package/src/__tests__/rebuild-index-graph-nodes.test.ts +273 -0
  143. package/src/__tests__/registry.test.ts +3 -3
  144. package/src/__tests__/require-fresh-approval.test.ts +64 -2
  145. package/src/__tests__/runtime-events-sse-parity.test.ts +2 -6
  146. package/src/__tests__/runtime-events-sse.test.ts +2 -6
  147. package/src/__tests__/sandbox-host-parity.test.ts +5 -4
  148. package/src/__tests__/schedule-store.test.ts +2 -6
  149. package/src/__tests__/schedule-tools.test.ts +2 -6
  150. package/src/__tests__/scheduler-recurrence.test.ts +1 -5
  151. package/src/__tests__/scheduler-reuse-conversation.test.ts +368 -0
  152. package/src/__tests__/scoped-approval-grants.test.ts +2 -6
  153. package/src/__tests__/scoped-grant-security-matrix.test.ts +2 -6
  154. package/src/__tests__/scrub-corrupted-image-attachments.test.ts +278 -0
  155. package/src/__tests__/search-skills-unified.test.ts +422 -0
  156. package/src/__tests__/secret-onetime-send.test.ts +2 -0
  157. package/src/__tests__/send-endpoint-busy.test.ts +44 -9
  158. package/src/__tests__/sequence-store.test.ts +2 -6
  159. package/src/__tests__/server-history-render.test.ts +2 -6
  160. package/src/__tests__/set-permission-mode.test.ts +274 -0
  161. package/src/__tests__/skill-feature-flags-integration.test.ts +38 -31
  162. package/src/__tests__/skill-feature-flags.test.ts +6 -6
  163. package/src/__tests__/skill-load-feature-flag.test.ts +23 -11
  164. package/src/__tests__/skill-memory.test.ts +2 -741
  165. package/src/__tests__/skills-uninstall.test.ts +2 -2
  166. package/src/__tests__/skills.test.ts +1 -1
  167. package/src/__tests__/slack-inbound-verification.test.ts +2 -6
  168. package/src/__tests__/strip-memory-injections.test.ts +187 -0
  169. package/src/__tests__/subagent-detail.test.ts +84 -0
  170. package/src/__tests__/subagent-disposal.test.ts +308 -0
  171. package/src/__tests__/subagent-manager-notify.test.ts +19 -10
  172. package/src/__tests__/subagent-notify-parent.test.ts +390 -0
  173. package/src/__tests__/subagent-role-registry.test.ts +108 -0
  174. package/src/__tests__/subagent-tool-filtering.test.ts +71 -0
  175. package/src/__tests__/subagent-tools.test.ts +464 -4
  176. package/src/__tests__/system-prompt-ask-mode.test.ts +139 -0
  177. package/src/__tests__/task-compiler.test.ts +2 -6
  178. package/src/__tests__/task-management-tools.test.ts +2 -6
  179. package/src/__tests__/task-memory-cleanup.test.ts +185 -241
  180. package/src/__tests__/task-runner.test.ts +2 -6
  181. package/src/__tests__/task-scheduler.test.ts +2 -6
  182. package/src/__tests__/terminal-tools.test.ts +17 -27
  183. package/src/__tests__/test-preload.ts +7 -0
  184. package/src/__tests__/tool-approval-handler.test.ts +2 -6
  185. package/src/__tests__/tool-executor.test.ts +4 -26
  186. package/src/__tests__/tool-grant-request-escalation.test.ts +2 -6
  187. package/src/__tests__/tool-side-effects-slack-dm.test.ts +277 -0
  188. package/src/__tests__/top-level-renderer.test.ts +10 -13
  189. package/src/__tests__/trust-store.test.ts +1 -1
  190. package/src/__tests__/trusted-contact-inline-approval-integration.test.ts +2 -6
  191. package/src/__tests__/trusted-contact-lifecycle-notifications.test.ts +118 -8
  192. package/src/__tests__/trusted-contact-multichannel.test.ts +2 -6
  193. package/src/__tests__/trusted-contact-verification.test.ts +2 -6
  194. package/src/__tests__/turn-boundary-resolution.test.ts +2 -6
  195. package/src/__tests__/usage-cache-backfill-migration.test.ts +1 -6
  196. package/src/__tests__/usage-routes.test.ts +2 -6
  197. package/src/__tests__/verification-control-plane-policy.test.ts +0 -2
  198. package/src/__tests__/voice-invite-redemption.test.ts +2 -6
  199. package/src/__tests__/voice-scoped-grant-consumer.test.ts +2 -6
  200. package/src/__tests__/voice-session-bridge.test.ts +2 -6
  201. package/src/__tests__/volume-security-guard.test.ts +2 -0
  202. package/src/__tests__/workspace-lifecycle.test.ts +29 -1
  203. package/src/__tests__/workspace-migration-009-backfill-conversation-disk-view.test.ts +2 -6
  204. package/src/__tests__/workspace-migration-013-repair-conversation-disk-view.test.ts +2 -6
  205. package/src/__tests__/workspace-migration-026-backfill-install-meta.test.ts +558 -0
  206. package/src/__tests__/workspace-migration-028-recover-conversations-from-disk-view.test.ts +387 -0
  207. package/src/__tests__/workspace-policy.test.ts +1 -1
  208. package/src/agent/attachments.ts +7 -2
  209. package/src/agent/image-optimize.ts +165 -0
  210. package/src/agent/loop.ts +7 -15
  211. package/src/approvals/guardian-request-resolvers.ts +24 -0
  212. package/src/avatar/traits-png-sync.ts +3 -3
  213. package/src/bundler/app-compiler.ts +179 -2
  214. package/src/bundler/package-resolver.ts +3 -5
  215. package/src/cli/__tests__/notifications.test.ts +1 -2
  216. package/src/cli/__tests__/run-assistant-command.ts +29 -0
  217. package/src/cli/commands/__tests__/email-download.test.ts +245 -0
  218. package/src/cli/commands/__tests__/email-list.test.ts +192 -0
  219. package/src/cli/commands/__tests__/email-register.test.ts +186 -0
  220. package/src/cli/commands/__tests__/email-send.test.ts +291 -0
  221. package/src/cli/commands/__tests__/email-status.test.ts +181 -0
  222. package/src/cli/commands/__tests__/email-unregister.test.ts +139 -0
  223. package/src/cli/commands/__tests__/routes.test.ts +562 -0
  224. package/src/cli/commands/avatar.ts +3 -3
  225. package/src/cli/commands/config.ts +26 -13
  226. package/src/cli/commands/conversations.ts +1 -8
  227. package/src/cli/commands/doctor.ts +2 -2
  228. package/src/cli/commands/email.ts +584 -835
  229. package/src/cli/commands/memory.ts +37 -84
  230. package/src/cli/commands/notifications.ts +7 -2
  231. package/src/cli/commands/oauth/__tests__/connect.test.ts +2 -2
  232. package/src/cli/commands/oauth/__tests__/disconnect.test.ts +2 -2
  233. package/src/cli/commands/oauth/__tests__/mode.test.ts +8 -1
  234. package/src/cli/commands/oauth/__tests__/status.test.ts +2 -2
  235. package/src/cli/commands/oauth/connect.ts +25 -11
  236. package/src/cli/commands/oauth/mode.ts +7 -0
  237. package/src/cli/commands/oauth/shared.ts +39 -3
  238. package/src/cli/commands/platform/__tests__/connect.test.ts +1 -1
  239. package/src/cli/commands/platform/__tests__/disconnect.test.ts +1 -1
  240. package/src/cli/commands/platform/__tests__/status.test.ts +5 -5
  241. package/src/cli/commands/platform/index.ts +16 -16
  242. package/src/cli/commands/routes.ts +396 -0
  243. package/src/cli/commands/skills.ts +218 -36
  244. package/src/cli/commands/trust.ts +2 -2
  245. package/src/cli/lib/daemon-credential-client.ts +2 -3
  246. package/src/cli/program.ts +2 -0
  247. package/src/cli.ts +1 -120
  248. package/src/config/bundled-skills/acp/TOOLS.json +1 -1
  249. package/src/config/bundled-skills/app-builder/SKILL.md +4 -1
  250. package/src/config/bundled-skills/contacts/SKILL.md +0 -1
  251. package/src/config/bundled-skills/contacts/TOOLS.json +0 -8
  252. package/src/config/bundled-skills/contacts/tools/contact-upsert.ts +0 -4
  253. package/src/config/bundled-skills/gmail/SKILL.md +4 -12
  254. package/src/config/bundled-skills/google-calendar/SKILL.md +1 -9
  255. package/src/config/bundled-skills/messaging/SKILL.md +17 -18
  256. package/src/config/bundled-skills/messaging/tools/messaging-analyze-style.ts +40 -33
  257. package/src/config/bundled-skills/outlook/SKILL.md +189 -0
  258. package/src/config/bundled-skills/outlook/TOOLS.json +530 -0
  259. package/src/config/bundled-skills/outlook/tools/outlook-attachments.ts +85 -0
  260. package/src/config/bundled-skills/outlook/tools/outlook-categories.ts +77 -0
  261. package/src/config/bundled-skills/outlook/tools/outlook-draft.ts +84 -0
  262. package/src/config/bundled-skills/outlook/tools/outlook-follow-up.ts +94 -0
  263. package/src/config/bundled-skills/outlook/tools/outlook-forward.ts +49 -0
  264. package/src/config/bundled-skills/outlook/tools/outlook-outreach-scan.ts +237 -0
  265. package/src/config/bundled-skills/outlook/tools/outlook-rules.ts +161 -0
  266. package/src/config/bundled-skills/outlook/tools/outlook-send-draft.ts +32 -0
  267. package/src/config/bundled-skills/outlook/tools/outlook-sender-digest.ts +272 -0
  268. package/src/config/bundled-skills/outlook/tools/outlook-trash.ts +29 -0
  269. package/src/config/bundled-skills/outlook/tools/outlook-unsubscribe.ts +129 -0
  270. package/src/config/bundled-skills/outlook/tools/outlook-vacation.ts +87 -0
  271. package/src/config/bundled-skills/outlook/tools/shared.ts +20 -0
  272. package/src/config/bundled-skills/outlook-calendar/SKILL.md +51 -0
  273. package/src/config/bundled-skills/outlook-calendar/TOOLS.json +221 -0
  274. package/src/config/bundled-skills/outlook-calendar/calendar-client.ts +252 -0
  275. package/src/config/bundled-skills/outlook-calendar/tools/outlook-calendar-check-availability.ts +53 -0
  276. package/src/config/bundled-skills/outlook-calendar/tools/outlook-calendar-create-event.ts +74 -0
  277. package/src/config/bundled-skills/outlook-calendar/tools/outlook-calendar-get-event.ts +18 -0
  278. package/src/config/bundled-skills/outlook-calendar/tools/outlook-calendar-list-events.ts +46 -0
  279. package/src/config/bundled-skills/outlook-calendar/tools/outlook-calendar-rsvp.ts +36 -0
  280. package/src/config/bundled-skills/outlook-calendar/tools/shared.ts +17 -0
  281. package/src/config/bundled-skills/outlook-calendar/types.ts +120 -0
  282. package/src/config/bundled-skills/playbooks/tools/playbook-create.ts +47 -40
  283. package/src/config/bundled-skills/playbooks/tools/playbook-delete.ts +16 -29
  284. package/src/config/bundled-skills/playbooks/tools/playbook-list.ts +16 -18
  285. package/src/config/bundled-skills/playbooks/tools/playbook-update.ts +39 -47
  286. package/src/config/bundled-skills/schedule/SKILL.md +22 -2
  287. package/src/config/bundled-skills/schedule/TOOLS.json +8 -0
  288. package/src/config/bundled-skills/settings/tools/avatar-get.ts +3 -13
  289. package/src/config/bundled-skills/settings/tools/avatar-remove.ts +2 -4
  290. package/src/config/bundled-skills/settings/tools/avatar-update.ts +5 -2
  291. package/src/config/bundled-skills/slack/SKILL.md +3 -7
  292. package/src/config/bundled-skills/subagent/SKILL.md +43 -3
  293. package/src/config/bundled-skills/subagent/TOOLS.json +29 -4
  294. package/src/config/bundled-tool-registry.ts +56 -4
  295. package/src/config/env-registry.ts +78 -8
  296. package/src/config/feature-flag-registry.json +38 -125
  297. package/src/config/schema.ts +8 -0
  298. package/src/config/schemas/filing.ts +51 -0
  299. package/src/config/schemas/heartbeat.ts +15 -12
  300. package/src/config/schemas/memory-lifecycle.ts +12 -0
  301. package/src/config/schemas/platform.ts +8 -0
  302. package/src/config/schemas/security.ts +14 -0
  303. package/src/config/schemas/timeouts.ts +1 -1
  304. package/src/config/skills.ts +18 -7
  305. package/src/context/token-estimator.ts +25 -18
  306. package/src/context/window-manager.ts +6 -2
  307. package/src/credential-execution/process-manager.ts +3 -1
  308. package/src/daemon/app-source-watcher.ts +93 -0
  309. package/src/daemon/config-watcher.ts +79 -1
  310. package/src/daemon/context-overflow-reducer.ts +46 -2
  311. package/src/daemon/conversation-agent-loop-handlers.ts +143 -82
  312. package/src/daemon/conversation-agent-loop.ts +236 -108
  313. package/src/daemon/conversation-error.ts +31 -8
  314. package/src/daemon/conversation-history.ts +4 -19
  315. package/src/daemon/conversation-lifecycle.ts +36 -9
  316. package/src/daemon/conversation-media-retry.ts +85 -7
  317. package/src/daemon/conversation-notifiers.ts +4 -1
  318. package/src/daemon/conversation-process.ts +13 -7
  319. package/src/daemon/conversation-runtime-assembly.ts +305 -306
  320. package/src/daemon/conversation-tool-setup.ts +44 -14
  321. package/src/daemon/conversation-workspace.ts +1 -2
  322. package/src/daemon/conversation.ts +59 -2
  323. package/src/daemon/daemon-control.ts +8 -2
  324. package/src/daemon/date-context.ts +26 -53
  325. package/src/daemon/first-greeting.ts +1 -1
  326. package/src/daemon/handlers/conversations.ts +4 -7
  327. package/src/daemon/handlers/shared.test.ts +143 -0
  328. package/src/daemon/handlers/shared.ts +85 -17
  329. package/src/daemon/handlers/skills.ts +416 -209
  330. package/src/daemon/lifecycle.ts +212 -131
  331. package/src/daemon/main.ts +5 -1
  332. package/src/daemon/message-types/conversations.ts +29 -7
  333. package/src/daemon/message-types/messages.ts +12 -2
  334. package/src/daemon/message-types/schedules.ts +1 -0
  335. package/src/daemon/message-types/settings.ts +6 -0
  336. package/src/daemon/message-types/skills.ts +97 -36
  337. package/src/daemon/profiler-run-store.ts +557 -0
  338. package/src/daemon/providers-setup.ts +5 -0
  339. package/src/daemon/server.ts +100 -11
  340. package/src/daemon/shutdown-handlers.ts +5 -0
  341. package/src/daemon/tool-side-effects.ts +50 -8
  342. package/src/export/transcript-formatter.ts +148 -0
  343. package/src/filing/filing-service.ts +228 -0
  344. package/src/heartbeat/heartbeat-service.ts +97 -7
  345. package/src/hooks/cli.ts +2 -2
  346. package/src/hooks/runner.ts +15 -38
  347. package/src/inbound/platform-callback-registration.ts +14 -14
  348. package/src/mcp/client.ts +6 -0
  349. package/src/mcp/mcp-oauth-provider.ts +149 -27
  350. package/src/memory/admin.ts +42 -75
  351. package/src/memory/app-store.ts +69 -0
  352. package/src/memory/conversation-bootstrap.ts +3 -1
  353. package/src/memory/conversation-crud.ts +211 -288
  354. package/src/memory/conversation-group-migration.ts +157 -0
  355. package/src/memory/conversation-queries.ts +61 -13
  356. package/src/memory/conversation-title-service.ts +1 -0
  357. package/src/memory/db-init.ts +194 -361
  358. package/src/memory/embed.ts +73 -0
  359. package/src/memory/embedding-backend.ts +8 -14
  360. package/src/memory/embedding-runtime-manager.ts +12 -114
  361. package/src/memory/fingerprint.ts +2 -2
  362. package/src/memory/graph/bootstrap.ts +521 -0
  363. package/src/memory/graph/capability-seed.ts +449 -0
  364. package/src/memory/graph/consolidation.ts +725 -0
  365. package/src/memory/graph/conversation-graph-memory.ts +659 -0
  366. package/src/memory/graph/decay.test.ts +208 -0
  367. package/src/memory/graph/decay.ts +195 -0
  368. package/src/memory/graph/extraction-job.ts +74 -0
  369. package/src/memory/graph/extraction.test.ts +936 -0
  370. package/src/memory/graph/extraction.ts +1297 -0
  371. package/src/memory/graph/graph-memory-state-store.ts +37 -0
  372. package/src/memory/graph/graph-search.ts +280 -0
  373. package/src/memory/graph/image-ref-utils.ts +29 -0
  374. package/src/memory/graph/injection.test.ts +513 -0
  375. package/src/memory/graph/injection.ts +469 -0
  376. package/src/memory/graph/inspect.ts +543 -0
  377. package/src/memory/graph/narrative.ts +267 -0
  378. package/src/memory/graph/pattern-scan.ts +269 -0
  379. package/src/memory/graph/retriever.ts +1111 -0
  380. package/src/memory/graph/scoring.test.ts +548 -0
  381. package/src/memory/graph/scoring.ts +232 -0
  382. package/src/memory/graph/serendipity.ts +65 -0
  383. package/src/memory/graph/store.test.ts +1098 -0
  384. package/src/memory/graph/store.ts +838 -0
  385. package/src/memory/graph/tool-handlers.ts +301 -0
  386. package/src/memory/graph/tools.ts +97 -0
  387. package/src/memory/graph/triggers.test.ts +487 -0
  388. package/src/memory/graph/triggers.ts +223 -0
  389. package/src/memory/graph/types.ts +295 -0
  390. package/src/memory/group-crud.ts +191 -0
  391. package/src/memory/indexer.ts +37 -19
  392. package/src/memory/job-handlers/cleanup.ts +32 -42
  393. package/src/memory/job-handlers/conversation-starters.ts +91 -53
  394. package/src/memory/job-handlers/embedding.ts +5 -31
  395. package/src/memory/job-handlers/index-maintenance.ts +23 -11
  396. package/src/memory/job-handlers/summarization.ts +32 -17
  397. package/src/memory/job-utils.ts +1 -1
  398. package/src/memory/jobs-store.ts +21 -31
  399. package/src/memory/jobs-worker.ts +180 -129
  400. package/src/memory/llm-request-log-store.ts +96 -12
  401. package/src/memory/memory-recall-log-store.ts +49 -5
  402. package/src/memory/message-content.ts +1 -0
  403. package/src/memory/migrations/202-memory-graph-tables.ts +130 -0
  404. package/src/memory/migrations/203-drop-memory-items-tables.ts +55 -0
  405. package/src/memory/migrations/204-rename-memory-graph-type-values.ts +46 -0
  406. package/src/memory/migrations/205-memory-graph-image-refs.ts +11 -0
  407. package/src/memory/migrations/206-memory-graph-node-edits.ts +19 -0
  408. package/src/memory/migrations/206-scrub-corrupted-image-attachments.ts +131 -0
  409. package/src/memory/migrations/207-conversation-graph-memory-state.ts +20 -0
  410. package/src/memory/migrations/208-conversations-last-message-at.ts +35 -0
  411. package/src/memory/migrations/209-strip-thinking-from-consolidated.ts +85 -0
  412. package/src/memory/migrations/210-schedule-reuse-conversation.ts +13 -0
  413. package/src/memory/migrations/211-memory-recall-logs-query-context.ts +21 -0
  414. package/src/memory/migrations/212-llm-request-logs-created-at-index.ts +19 -0
  415. package/src/memory/migrations/index.ts +12 -0
  416. package/src/memory/migrations/registry.ts +16 -0
  417. package/src/memory/qdrant-client.ts +44 -17
  418. package/src/memory/schema/conversations.ts +14 -0
  419. package/src/memory/schema/index.ts +1 -0
  420. package/src/memory/schema/infrastructure.ts +8 -1
  421. package/src/memory/schema/memory-core.ts +0 -51
  422. package/src/memory/schema/memory-graph.ts +154 -0
  423. package/src/memory/search/semantic.ts +47 -91
  424. package/src/memory/task-memory-cleanup.ts +58 -61
  425. package/src/messaging/providers/outlook/adapter.ts +8 -1
  426. package/src/messaging/providers/outlook/client.ts +299 -0
  427. package/src/messaging/providers/outlook/types.ts +118 -0
  428. package/src/notifications/adapters/macos.ts +1 -0
  429. package/src/notifications/copy-composer.ts +95 -0
  430. package/src/notifications/decision-engine.ts +35 -0
  431. package/src/notifications/signal.ts +16 -0
  432. package/src/oauth/seed-providers.ts +2 -1
  433. package/src/permissions/checker.ts +36 -4
  434. package/src/permissions/defaults.ts +4 -4
  435. package/src/permissions/permission-mode-store.ts +180 -0
  436. package/src/permissions/permission-mode.ts +31 -0
  437. package/src/permissions/workspace-policy.ts +10 -1
  438. package/src/playbooks/playbook-compiler.ts +19 -18
  439. package/src/playbooks/types.ts +4 -3
  440. package/src/prompts/system-prompt.ts +62 -36
  441. package/src/prompts/templates/BOOTSTRAP-REFERENCE.md +100 -0
  442. package/src/prompts/templates/BOOTSTRAP.md +70 -165
  443. package/src/prompts/templates/HEARTBEAT.md +3 -1
  444. package/src/prompts/templates/SOUL.md +25 -4
  445. package/src/prompts/templates/UPDATES.md +8 -0
  446. package/src/providers/anthropic/client.ts +136 -220
  447. package/src/providers/gemini/client.ts +1 -1
  448. package/src/providers/openai/client.ts +1 -1
  449. package/src/providers/registry.ts +1 -1
  450. package/src/providers/retry.ts +19 -3
  451. package/src/runtime/actor-trust-resolver.ts +5 -1
  452. package/src/runtime/auth/route-policy.ts +30 -0
  453. package/src/runtime/guardian-reply-router.ts +5 -1
  454. package/src/runtime/http-server.ts +55 -5
  455. package/src/runtime/http-types.ts +12 -1
  456. package/src/runtime/middleware/auth.ts +20 -0
  457. package/src/runtime/migrations/vbundle-builder.ts +389 -3
  458. package/src/runtime/migrations/vbundle-importer.ts +8 -6
  459. package/src/runtime/routes/__tests__/user-route-dispatcher.test.ts +378 -0
  460. package/src/runtime/routes/app-management-routes.ts +1 -11
  461. package/src/runtime/routes/approval-strategies/guardian-callback-strategy.ts +26 -0
  462. package/src/runtime/routes/archive-utils.ts +29 -0
  463. package/src/runtime/routes/attachment-routes.test.ts +106 -0
  464. package/src/runtime/routes/attachment-routes.ts +106 -16
  465. package/src/runtime/routes/avatar-routes.ts +2 -9
  466. package/src/runtime/routes/brain-graph-routes.ts +21 -22
  467. package/src/runtime/routes/btw-routes.ts +22 -1
  468. package/src/runtime/routes/conversation-analysis-routes.ts +173 -0
  469. package/src/runtime/routes/conversation-management-routes.ts +3 -14
  470. package/src/runtime/routes/conversation-query-routes.ts +49 -3
  471. package/src/runtime/routes/conversation-routes.ts +264 -44
  472. package/src/runtime/routes/conversation-starter-routes.ts +2 -2
  473. package/src/runtime/routes/debug-routes.ts +1 -1
  474. package/src/runtime/routes/global-search-routes.ts +21 -19
  475. package/src/runtime/routes/group-routes.ts +207 -0
  476. package/src/runtime/routes/guardian-action-routes.ts +21 -10
  477. package/src/runtime/routes/guardian-bootstrap-routes.ts +23 -19
  478. package/src/runtime/routes/heartbeat-routes.ts +4 -10
  479. package/src/runtime/routes/identity-routes.ts +53 -18
  480. package/src/runtime/routes/inbound-message-handler.ts +19 -0
  481. package/src/runtime/routes/inbound-stages/guardian-activation-intercept.test.ts +292 -0
  482. package/src/runtime/routes/inbound-stages/guardian-activation-intercept.ts +207 -0
  483. package/src/runtime/routes/llm-context-normalization.ts +14 -10
  484. package/src/runtime/routes/log-export-routes.ts +23 -275
  485. package/src/runtime/routes/memory-item-routes.test.ts +170 -247
  486. package/src/runtime/routes/memory-item-routes.ts +341 -388
  487. package/src/runtime/routes/migration-routes.ts +18 -7
  488. package/src/runtime/routes/profiler-routes.ts +350 -0
  489. package/src/runtime/routes/schedule-routes.ts +28 -11
  490. package/src/runtime/routes/settings-routes.ts +95 -8
  491. package/src/runtime/routes/skills-routes.ts +103 -37
  492. package/src/runtime/routes/subagents-routes.ts +28 -7
  493. package/src/runtime/routes/user-route-dispatcher.ts +223 -0
  494. package/src/runtime/routes/user-routes.ts +41 -0
  495. package/src/runtime/routes/work-items-routes.test.ts +2 -6
  496. package/src/runtime/routes/workspace-routes.ts +0 -1
  497. package/src/schedule/schedule-store.ts +30 -0
  498. package/src/schedule/scheduler.ts +52 -18
  499. package/src/security/oauth2.ts +1 -1
  500. package/src/security/secure-keys.ts +4 -8
  501. package/src/shared/provider-env-vars.ts +19 -0
  502. package/src/skills/catalog-cache.ts +5 -0
  503. package/src/skills/catalog-install.ts +25 -16
  504. package/src/skills/clawhub.ts +134 -154
  505. package/src/skills/install-meta.ts +208 -0
  506. package/src/skills/managed-store.ts +29 -18
  507. package/src/skills/skill-memory.ts +12 -229
  508. package/src/skills/skillssh-registry.ts +19 -17
  509. package/src/subagent/index.ts +13 -3
  510. package/src/subagent/manager.ts +308 -29
  511. package/src/subagent/types.ts +68 -0
  512. package/src/tasks/task-runner.ts +7 -5
  513. package/src/telemetry/usage-telemetry-reporter.test.ts +3 -5
  514. package/src/tools/apps/executors.ts +29 -4
  515. package/src/tools/browser/runtime-check.ts +3 -1
  516. package/src/tools/filesystem/list.ts +93 -0
  517. package/src/tools/memory/register.ts +63 -46
  518. package/src/tools/permission-checker.ts +85 -1
  519. package/src/tools/registry.ts +4 -0
  520. package/src/tools/schedule/create.ts +3 -0
  521. package/src/tools/schedule/list.ts +1 -0
  522. package/src/tools/schedule/update.ts +6 -0
  523. package/src/tools/shared/filesystem/errors.ts +5 -0
  524. package/src/tools/shared/filesystem/file-ops-service.ts +90 -2
  525. package/src/tools/shared/filesystem/image-read.ts +22 -85
  526. package/src/tools/shared/filesystem/types.ts +17 -0
  527. package/src/tools/shared/shell-output.ts +31 -2
  528. package/src/tools/subagent/abort.ts +12 -2
  529. package/src/tools/subagent/message.ts +9 -2
  530. package/src/tools/subagent/notify-parent.ts +79 -0
  531. package/src/tools/subagent/read.ts +29 -8
  532. package/src/tools/subagent/resolve.ts +21 -0
  533. package/src/tools/subagent/spawn.ts +2 -0
  534. package/src/tools/subagent/status.ts +11 -1
  535. package/src/tools/system/avatar-generator.ts +3 -3
  536. package/src/tools/system/register.ts +23 -0
  537. package/src/tools/system/set-permission-mode.ts +103 -0
  538. package/src/tools/terminal/parser.ts +30 -5
  539. package/src/tools/terminal/safe-env.ts +17 -1
  540. package/src/tools/tool-manifest.ts +9 -3
  541. package/src/tools/types.ts +2 -0
  542. package/src/util/browser.ts +25 -10
  543. package/src/util/bun-runtime.ts +172 -0
  544. package/src/util/logger.ts +1 -1
  545. package/src/util/platform.ts +50 -17
  546. package/src/watcher/providers/outlook-calendar.ts +343 -0
  547. package/src/watcher/providers/outlook.ts +198 -0
  548. package/src/workspace/migrations/023-move-config-files-to-workspace.ts +2 -2
  549. package/src/workspace/migrations/024-move-runtime-files-to-workspace.ts +2 -2
  550. package/src/workspace/migrations/025-remove-oauth-app-setup-skills.ts +76 -0
  551. package/src/workspace/migrations/026-backfill-install-meta.ts +325 -0
  552. package/src/workspace/migrations/027-remove-orphaned-optimized-images-cache.ts +42 -0
  553. package/src/workspace/migrations/028-recover-conversations-from-disk-view.ts +270 -0
  554. package/src/workspace/migrations/029-seed-pkb.ts +84 -0
  555. package/src/workspace/migrations/registry.ts +10 -0
  556. package/src/workspace/top-level-renderer.ts +5 -9
  557. package/src/__tests__/cli-memory.test.ts +0 -372
  558. package/src/__tests__/clipboard.test.ts +0 -88
  559. package/src/__tests__/context-memory-e2e.test.ts +0 -415
  560. package/src/__tests__/journal-context.test.ts +0 -268
  561. package/src/__tests__/memory-context-benchmark.benchmark.test.ts +0 -297
  562. package/src/__tests__/memory-lifecycle-e2e.test.ts +0 -459
  563. package/src/__tests__/memory-query-builder.test.ts +0 -59
  564. package/src/__tests__/memory-recall-quality.test.ts +0 -1046
  565. package/src/__tests__/memory-regressions.experimental.test.ts +0 -629
  566. package/src/__tests__/memory-regressions.test.ts +0 -3696
  567. package/src/__tests__/memory-retrieval.benchmark.test.ts +0 -295
  568. package/src/cli/cli-memory.ts +0 -176
  569. package/src/daemon/conversation-memory.ts +0 -207
  570. package/src/memory/conversation-starters-cadence.ts +0 -74
  571. package/src/memory/items-extractor.ts +0 -860
  572. package/src/memory/job-handlers/batch-extraction.ts +0 -753
  573. package/src/memory/job-handlers/extraction.ts +0 -40
  574. package/src/memory/job-handlers/journal-carry-forward.test.ts +0 -355
  575. package/src/memory/job-handlers/journal-carry-forward.ts +0 -255
  576. package/src/memory/journal-memory.ts +0 -224
  577. package/src/memory/query-builder.ts +0 -47
  578. package/src/memory/query-expansion.ts +0 -83
  579. package/src/memory/retriever.test.ts +0 -1592
  580. package/src/memory/retriever.ts +0 -1331
  581. package/src/memory/search/formatting.test.ts +0 -140
  582. package/src/memory/search/formatting.ts +0 -262
  583. package/src/memory/search/mmr.ts +0 -139
  584. package/src/memory/search/ranking.ts +0 -15
  585. package/src/memory/search/staleness.ts +0 -40
  586. package/src/memory/search/tier-classifier.ts +0 -18
  587. package/src/memory/search/types.ts +0 -121
  588. package/src/prompts/journal-context.ts +0 -154
  589. package/src/tools/memory/definitions.ts +0 -69
  590. package/src/tools/memory/handlers.test.ts +0 -562
  591. package/src/tools/memory/handlers.ts +0 -434
  592. package/src/util/clipboard.ts +0 -34
@@ -0,0 +1,1098 @@
1
+ import { beforeAll, beforeEach, describe, expect, test } from "bun:test";
2
+
3
+ import { initializeDb, resetTestTables } from "../db.js";
4
+ import {
5
+ applyDiff,
6
+ countNodes,
7
+ createEdge,
8
+ createNode,
9
+ createTrigger,
10
+ deduplicateParagraphs,
11
+ deleteEdge,
12
+ deleteNode,
13
+ deleteTrigger,
14
+ getActiveTriggersByType,
15
+ getEdgesForNode,
16
+ getNode,
17
+ getNodesByIds,
18
+ getTriggersForNode,
19
+ queryNodes,
20
+ reinforceNode,
21
+ supersedeNode,
22
+ updateNode,
23
+ updateTrigger,
24
+ } from "./store.js";
25
+ import type { NewNode } from "./types.js";
26
+
27
+ // ---------------------------------------------------------------------------
28
+ // Setup
29
+ // ---------------------------------------------------------------------------
30
+
31
+ function makeNewNode(overrides: Partial<NewNode> = {}): NewNode {
32
+ const now = Date.now();
33
+ return {
34
+ content: "Test memory.",
35
+ type: "episodic",
36
+ created: now,
37
+ lastAccessed: now,
38
+ lastConsolidated: now,
39
+ eventDate: null,
40
+ emotionalCharge: {
41
+ valence: 0,
42
+ intensity: 0.3,
43
+ decayCurve: "linear",
44
+ decayRate: 0.05,
45
+ originalIntensity: 0.3,
46
+ },
47
+ fidelity: "vivid",
48
+ confidence: 0.8,
49
+ significance: 0.5,
50
+ stability: 14,
51
+ reinforcementCount: 0,
52
+ lastReinforced: now,
53
+ sourceConversations: ["conv-1"],
54
+ sourceType: "direct",
55
+ narrativeRole: null,
56
+ partOfStory: null,
57
+ imageRefs: null,
58
+ scopeId: "default",
59
+ ...overrides,
60
+ };
61
+ }
62
+
63
+ beforeAll(() => {
64
+ initializeDb();
65
+ });
66
+
67
+ beforeEach(() => {
68
+ resetTestTables(
69
+ "memory_graph_triggers",
70
+ "memory_graph_edges",
71
+ "memory_graph_nodes",
72
+ );
73
+ });
74
+
75
+ // ---------------------------------------------------------------------------
76
+ // Node CRUD
77
+ // ---------------------------------------------------------------------------
78
+
79
+ describe("node CRUD", () => {
80
+ test("createNode assigns an ID and returns the full node", () => {
81
+ const node = createNode(makeNewNode({ content: "Hello world." }));
82
+ expect(node.id).toBeTruthy();
83
+ expect(typeof node.id).toBe("string");
84
+ expect(node.content).toBe("Hello world.");
85
+ expect(node.type).toBe("episodic");
86
+ });
87
+
88
+ test("getNode returns the node by ID", () => {
89
+ const created = createNode(makeNewNode({ content: "Find me." }));
90
+ const found = getNode(created.id);
91
+ expect(found).not.toBeNull();
92
+ expect(found!.id).toBe(created.id);
93
+ expect(found!.content).toBe("Find me.");
94
+ });
95
+
96
+ test("getNode returns null for non-existent ID", () => {
97
+ expect(getNode("non-existent")).toBeNull();
98
+ });
99
+
100
+ test("getNodesByIds returns multiple nodes", () => {
101
+ const a = createNode(makeNewNode({ content: "Node A." }));
102
+ const b = createNode(makeNewNode({ content: "Node B." }));
103
+ createNode(makeNewNode({ content: "Node C." }));
104
+
105
+ const found = getNodesByIds([a.id, b.id]);
106
+ expect(found).toHaveLength(2);
107
+ const contents = found.map((n) => n.content).sort();
108
+ expect(contents).toEqual(["Node A.", "Node B."]);
109
+ });
110
+
111
+ test("getNodesByIds returns empty for empty input", () => {
112
+ expect(getNodesByIds([])).toEqual([]);
113
+ });
114
+
115
+ test("updateNode modifies specified fields", () => {
116
+ const node = createNode(makeNewNode({ content: "Original." }));
117
+ updateNode(node.id, {
118
+ content: "Updated.",
119
+ significance: 0.9,
120
+ });
121
+ const updated = getNode(node.id);
122
+ expect(updated!.content).toBe("Updated.");
123
+ expect(updated!.significance).toBe(0.9);
124
+ // Untouched fields should remain
125
+ expect(updated!.type).toBe("episodic");
126
+ });
127
+
128
+ test("updateNode with empty changes is a no-op", () => {
129
+ const node = createNode(makeNewNode({ content: "Unchanged." }));
130
+ updateNode(node.id, {});
131
+ const same = getNode(node.id);
132
+ expect(same!.content).toBe("Unchanged.");
133
+ });
134
+
135
+ test("updateNode serializes emotionalCharge as JSON", () => {
136
+ const node = createNode(makeNewNode());
137
+ updateNode(node.id, {
138
+ emotionalCharge: {
139
+ valence: 0.8,
140
+ intensity: 0.9,
141
+ decayCurve: "permanent",
142
+ decayRate: 0,
143
+ originalIntensity: 0.9,
144
+ },
145
+ });
146
+ const updated = getNode(node.id);
147
+ expect(updated!.emotionalCharge.valence).toBe(0.8);
148
+ expect(updated!.emotionalCharge.decayCurve).toBe("permanent");
149
+ });
150
+
151
+ test("createNode with eventDate round-trips through getNode", () => {
152
+ const eventDate = Date.now() - 86400000; // yesterday
153
+ const node = createNode(makeNewNode({ eventDate }));
154
+ const found = getNode(node.id);
155
+ expect(found).not.toBeNull();
156
+ expect(found!.eventDate).toBe(eventDate);
157
+ });
158
+
159
+ test("createNode with null eventDate round-trips as null", () => {
160
+ const node = createNode(makeNewNode({ eventDate: null }));
161
+ const found = getNode(node.id);
162
+ expect(found).not.toBeNull();
163
+ expect(found!.eventDate).toBeNull();
164
+ });
165
+
166
+ test("updateNode updates eventDate", () => {
167
+ const node = createNode(makeNewNode({ eventDate: null }));
168
+ const newEventDate = Date.now() - 86400000;
169
+ updateNode(node.id, { eventDate: newEventDate });
170
+ const updated = getNode(node.id);
171
+ expect(updated!.eventDate).toBe(newEventDate);
172
+ });
173
+
174
+ test("updateNode can set eventDate to null", () => {
175
+ const eventDate = Date.now() - 86400000;
176
+ const node = createNode(makeNewNode({ eventDate }));
177
+ updateNode(node.id, { eventDate: null });
178
+ const updated = getNode(node.id);
179
+ expect(updated!.eventDate).toBeNull();
180
+ });
181
+
182
+ test("deleteNode removes the node", () => {
183
+ const node = createNode(makeNewNode());
184
+ deleteNode(node.id);
185
+ expect(getNode(node.id)).toBeNull();
186
+ });
187
+ });
188
+
189
+ // ---------------------------------------------------------------------------
190
+ // Node queries
191
+ // ---------------------------------------------------------------------------
192
+
193
+ describe("queryNodes", () => {
194
+ test("filters by scopeId", () => {
195
+ createNode(makeNewNode({ scopeId: "scope-a", content: "A." }));
196
+ createNode(makeNewNode({ scopeId: "scope-b", content: "B." }));
197
+
198
+ const results = queryNodes({ scopeId: "scope-a" });
199
+ expect(results).toHaveLength(1);
200
+ expect(results[0].content).toBe("A.");
201
+ });
202
+
203
+ test("filters by type", () => {
204
+ createNode(makeNewNode({ type: "episodic", content: "Ep." }));
205
+ createNode(makeNewNode({ type: "semantic", content: "Sem." }));
206
+ createNode(makeNewNode({ type: "emotional", content: "Em." }));
207
+
208
+ const results = queryNodes({ types: ["semantic", "emotional"] });
209
+ expect(results).toHaveLength(2);
210
+ });
211
+
212
+ test("excludes fidelity levels", () => {
213
+ createNode(makeNewNode({ fidelity: "vivid", content: "Vivid." }));
214
+ createNode(makeNewNode({ fidelity: "gone", content: "Gone." }));
215
+
216
+ const results = queryNodes({ fidelityNot: ["gone"] });
217
+ expect(results).toHaveLength(1);
218
+ expect(results[0].content).toBe("Vivid.");
219
+ });
220
+
221
+ test("filters by minimum significance", () => {
222
+ createNode(makeNewNode({ significance: 0.3, content: "Low." }));
223
+ createNode(makeNewNode({ significance: 0.7, content: "High." }));
224
+
225
+ const results = queryNodes({ minSignificance: 0.5 });
226
+ expect(results).toHaveLength(1);
227
+ expect(results[0].content).toBe("High.");
228
+ });
229
+
230
+ test("respects limit", () => {
231
+ for (let i = 0; i < 5; i++) {
232
+ createNode(makeNewNode({ content: `Node ${i}.` }));
233
+ }
234
+ const results = queryNodes({ limit: 3 });
235
+ expect(results).toHaveLength(3);
236
+ });
237
+
238
+ test("orders by significance descending", () => {
239
+ createNode(makeNewNode({ significance: 0.3 }));
240
+ createNode(makeNewNode({ significance: 0.9 }));
241
+ createNode(makeNewNode({ significance: 0.6 }));
242
+
243
+ const results = queryNodes({});
244
+ expect(results[0].significance).toBe(0.9);
245
+ expect(results[1].significance).toBe(0.6);
246
+ expect(results[2].significance).toBe(0.3);
247
+ });
248
+
249
+ test("filters by hasEventDate", () => {
250
+ createNode(makeNewNode({ content: "Dated.", eventDate: 1700000000000 }));
251
+ createNode(makeNewNode({ content: "Undated.", eventDate: null }));
252
+
253
+ const results = queryNodes({ hasEventDate: true });
254
+ expect(results).toHaveLength(1);
255
+ expect(results[0].content).toBe("Dated.");
256
+ });
257
+
258
+ test("filters by eventDateAfter", () => {
259
+ createNode(
260
+ makeNewNode({ content: "Old.", eventDate: 1700000000000 }),
261
+ );
262
+ createNode(
263
+ makeNewNode({ content: "Recent.", eventDate: 1710000000000 }),
264
+ );
265
+ createNode(makeNewNode({ content: "None.", eventDate: null }));
266
+
267
+ const results = queryNodes({ eventDateAfter: 1705000000000 });
268
+ expect(results).toHaveLength(1);
269
+ expect(results[0].content).toBe("Recent.");
270
+ });
271
+
272
+ test("filters by eventDateBefore", () => {
273
+ createNode(
274
+ makeNewNode({ content: "Old.", eventDate: 1700000000000 }),
275
+ );
276
+ createNode(
277
+ makeNewNode({ content: "Recent.", eventDate: 1710000000000 }),
278
+ );
279
+ createNode(makeNewNode({ content: "None.", eventDate: null }));
280
+
281
+ const results = queryNodes({ eventDateBefore: 1705000000000 });
282
+ expect(results).toHaveLength(1);
283
+ expect(results[0].content).toBe("Old.");
284
+ });
285
+
286
+ test("combines eventDateAfter and eventDateBefore for range query", () => {
287
+ createNode(
288
+ makeNewNode({ content: "Before.", eventDate: 1690000000000 }),
289
+ );
290
+ createNode(
291
+ makeNewNode({ content: "In range.", eventDate: 1700000000000 }),
292
+ );
293
+ createNode(
294
+ makeNewNode({ content: "After.", eventDate: 1720000000000 }),
295
+ );
296
+
297
+ const results = queryNodes({
298
+ eventDateAfter: 1695000000000,
299
+ eventDateBefore: 1710000000000,
300
+ });
301
+ expect(results).toHaveLength(1);
302
+ expect(results[0].content).toBe("In range.");
303
+ });
304
+ });
305
+
306
+ describe("countNodes", () => {
307
+ test("counts non-gone nodes in a scope", () => {
308
+ createNode(makeNewNode({ scopeId: "s1", fidelity: "vivid" }));
309
+ createNode(makeNewNode({ scopeId: "s1", fidelity: "clear" }));
310
+ createNode(makeNewNode({ scopeId: "s1", fidelity: "gone" }));
311
+ createNode(makeNewNode({ scopeId: "s2", fidelity: "vivid" }));
312
+
313
+ expect(countNodes("s1")).toBe(2);
314
+ expect(countNodes("s2")).toBe(1);
315
+ expect(countNodes("s3")).toBe(0);
316
+ });
317
+ });
318
+
319
+ // ---------------------------------------------------------------------------
320
+ // Edge CRUD
321
+ // ---------------------------------------------------------------------------
322
+
323
+ describe("edge CRUD", () => {
324
+ test("createEdge assigns an ID and returns the full edge", () => {
325
+ const a = createNode(makeNewNode());
326
+ const b = createNode(makeNewNode());
327
+ const edge = createEdge({
328
+ sourceNodeId: a.id,
329
+ targetNodeId: b.id,
330
+ relationship: "caused-by",
331
+ weight: 0.8,
332
+ created: Date.now(),
333
+ });
334
+ expect(edge.id).toBeTruthy();
335
+ expect(edge.sourceNodeId).toBe(a.id);
336
+ expect(edge.targetNodeId).toBe(b.id);
337
+ expect(edge.relationship).toBe("caused-by");
338
+ expect(edge.weight).toBe(0.8);
339
+ });
340
+
341
+ test("getEdgesForNode returns all edges (both directions)", () => {
342
+ const a = createNode(makeNewNode());
343
+ const b = createNode(makeNewNode());
344
+ const c = createNode(makeNewNode());
345
+ createEdge({
346
+ sourceNodeId: a.id,
347
+ targetNodeId: b.id,
348
+ relationship: "reminds-of",
349
+ weight: 1.0,
350
+ created: Date.now(),
351
+ });
352
+ createEdge({
353
+ sourceNodeId: c.id,
354
+ targetNodeId: a.id,
355
+ relationship: "part-of",
356
+ weight: 0.5,
357
+ created: Date.now(),
358
+ });
359
+
360
+ const edges = getEdgesForNode(a.id);
361
+ expect(edges).toHaveLength(2);
362
+ });
363
+
364
+ test("getEdgesForNode with outgoing direction", () => {
365
+ const a = createNode(makeNewNode());
366
+ const b = createNode(makeNewNode());
367
+ createEdge({
368
+ sourceNodeId: a.id,
369
+ targetNodeId: b.id,
370
+ relationship: "reminds-of",
371
+ weight: 1.0,
372
+ created: Date.now(),
373
+ });
374
+ createEdge({
375
+ sourceNodeId: b.id,
376
+ targetNodeId: a.id,
377
+ relationship: "caused-by",
378
+ weight: 1.0,
379
+ created: Date.now(),
380
+ });
381
+
382
+ const outgoing = getEdgesForNode(a.id, "outgoing");
383
+ expect(outgoing).toHaveLength(1);
384
+ expect(outgoing[0].targetNodeId).toBe(b.id);
385
+ });
386
+
387
+ test("getEdgesForNode with incoming direction", () => {
388
+ const a = createNode(makeNewNode());
389
+ const b = createNode(makeNewNode());
390
+ createEdge({
391
+ sourceNodeId: b.id,
392
+ targetNodeId: a.id,
393
+ relationship: "caused-by",
394
+ weight: 1.0,
395
+ created: Date.now(),
396
+ });
397
+
398
+ const incoming = getEdgesForNode(a.id, "incoming");
399
+ expect(incoming).toHaveLength(1);
400
+ expect(incoming[0].sourceNodeId).toBe(b.id);
401
+ });
402
+
403
+ test("deleteEdge removes the edge", () => {
404
+ const a = createNode(makeNewNode());
405
+ const b = createNode(makeNewNode());
406
+ const edge = createEdge({
407
+ sourceNodeId: a.id,
408
+ targetNodeId: b.id,
409
+ relationship: "reminds-of",
410
+ weight: 1.0,
411
+ created: Date.now(),
412
+ });
413
+ deleteEdge(edge.id);
414
+ expect(getEdgesForNode(a.id)).toHaveLength(0);
415
+ });
416
+ });
417
+
418
+ // ---------------------------------------------------------------------------
419
+ // Trigger CRUD
420
+ // ---------------------------------------------------------------------------
421
+
422
+ describe("trigger CRUD", () => {
423
+ test("createTrigger assigns an ID and returns the full trigger", () => {
424
+ const node = createNode(makeNewNode());
425
+ const trigger = createTrigger({
426
+ nodeId: node.id,
427
+ type: "temporal",
428
+ schedule: "day-of-week:monday",
429
+ condition: null,
430
+ conditionEmbedding: null,
431
+ threshold: null,
432
+ eventDate: null,
433
+ rampDays: null,
434
+ followUpDays: null,
435
+ recurring: true,
436
+ consumed: false,
437
+ cooldownMs: 1000 * 60 * 60 * 12,
438
+ lastFired: null,
439
+ });
440
+ expect(trigger.id).toBeTruthy();
441
+ expect(trigger.type).toBe("temporal");
442
+ expect(trigger.schedule).toBe("day-of-week:monday");
443
+ expect(trigger.recurring).toBe(true);
444
+ });
445
+
446
+ test("getTriggersForNode returns triggers for a given node", () => {
447
+ const node = createNode(makeNewNode());
448
+ createTrigger({
449
+ nodeId: node.id,
450
+ type: "temporal",
451
+ schedule: "time:morning",
452
+ condition: null,
453
+ conditionEmbedding: null,
454
+ threshold: null,
455
+ eventDate: null,
456
+ rampDays: null,
457
+ followUpDays: null,
458
+ recurring: false,
459
+ consumed: false,
460
+ cooldownMs: null,
461
+ lastFired: null,
462
+ });
463
+ createTrigger({
464
+ nodeId: node.id,
465
+ type: "semantic",
466
+ schedule: null,
467
+ condition: "cooking topic",
468
+ conditionEmbedding: null,
469
+ threshold: 0.7,
470
+ eventDate: null,
471
+ rampDays: null,
472
+ followUpDays: null,
473
+ recurring: false,
474
+ consumed: false,
475
+ cooldownMs: null,
476
+ lastFired: null,
477
+ });
478
+
479
+ const triggers = getTriggersForNode(node.id);
480
+ expect(triggers).toHaveLength(2);
481
+ });
482
+
483
+ test("updateTrigger modifies consumed and lastFired", () => {
484
+ const node = createNode(makeNewNode());
485
+ const trigger = createTrigger({
486
+ nodeId: node.id,
487
+ type: "temporal",
488
+ schedule: "date:04-08",
489
+ condition: null,
490
+ conditionEmbedding: null,
491
+ threshold: null,
492
+ eventDate: null,
493
+ rampDays: null,
494
+ followUpDays: null,
495
+ recurring: false,
496
+ consumed: false,
497
+ cooldownMs: null,
498
+ lastFired: null,
499
+ });
500
+
501
+ const now = Date.now();
502
+ updateTrigger(trigger.id, { consumed: true, lastFired: now });
503
+
504
+ const updated = getTriggersForNode(node.id);
505
+ expect(updated[0].consumed).toBe(true);
506
+ expect(updated[0].lastFired).toBe(now);
507
+ });
508
+
509
+ test("getActiveTriggersByType returns only non-consumed triggers", () => {
510
+ const node = createNode(makeNewNode());
511
+ createTrigger({
512
+ nodeId: node.id,
513
+ type: "temporal",
514
+ schedule: "time:morning",
515
+ condition: null,
516
+ conditionEmbedding: null,
517
+ threshold: null,
518
+ eventDate: null,
519
+ rampDays: null,
520
+ followUpDays: null,
521
+ recurring: false,
522
+ consumed: false,
523
+ cooldownMs: null,
524
+ lastFired: null,
525
+ });
526
+ createTrigger({
527
+ nodeId: node.id,
528
+ type: "temporal",
529
+ schedule: "time:evening",
530
+ condition: null,
531
+ conditionEmbedding: null,
532
+ threshold: null,
533
+ eventDate: null,
534
+ rampDays: null,
535
+ followUpDays: null,
536
+ recurring: false,
537
+ consumed: true,
538
+ cooldownMs: null,
539
+ lastFired: null,
540
+ });
541
+
542
+ const active = getActiveTriggersByType("temporal");
543
+ expect(active).toHaveLength(1);
544
+ expect(active[0].schedule).toBe("time:morning");
545
+ });
546
+
547
+ test("getActiveTriggersByType filters by scope when provided", () => {
548
+ const nodeA = createNode(makeNewNode({ scopeId: "scope-a" }));
549
+ const nodeB = createNode(makeNewNode({ scopeId: "scope-b" }));
550
+ createTrigger({
551
+ nodeId: nodeA.id,
552
+ type: "temporal",
553
+ schedule: "time:morning",
554
+ condition: null,
555
+ conditionEmbedding: null,
556
+ threshold: null,
557
+ eventDate: null,
558
+ rampDays: null,
559
+ followUpDays: null,
560
+ recurring: false,
561
+ consumed: false,
562
+ cooldownMs: null,
563
+ lastFired: null,
564
+ });
565
+ createTrigger({
566
+ nodeId: nodeB.id,
567
+ type: "temporal",
568
+ schedule: "time:evening",
569
+ condition: null,
570
+ conditionEmbedding: null,
571
+ threshold: null,
572
+ eventDate: null,
573
+ rampDays: null,
574
+ followUpDays: null,
575
+ recurring: false,
576
+ consumed: false,
577
+ cooldownMs: null,
578
+ lastFired: null,
579
+ });
580
+
581
+ const scopeA = getActiveTriggersByType("temporal", "scope-a");
582
+ expect(scopeA).toHaveLength(1);
583
+ expect(scopeA[0].schedule).toBe("time:morning");
584
+ });
585
+ });
586
+
587
+ // ---------------------------------------------------------------------------
588
+ // Reinforcement
589
+ // ---------------------------------------------------------------------------
590
+
591
+ describe("reinforceNode", () => {
592
+ test("increments reinforcementCount", () => {
593
+ const node = createNode(
594
+ makeNewNode({ reinforcementCount: 0, stability: 14, significance: 0.5 }),
595
+ );
596
+ reinforceNode(node.id);
597
+ const updated = getNode(node.id)!;
598
+ expect(updated.reinforcementCount).toBe(1);
599
+ });
600
+
601
+ test("multiplies stability by 1.5", () => {
602
+ const node = createNode(makeNewNode({ stability: 14 }));
603
+ reinforceNode(node.id);
604
+ const updated = getNode(node.id)!;
605
+ expect(updated.stability).toBeCloseTo(21, 5); // 14 × 1.5
606
+ });
607
+
608
+ test("boosts significance by 10%, capped at 1.0", () => {
609
+ const node = createNode(makeNewNode({ significance: 0.5 }));
610
+ reinforceNode(node.id);
611
+ const updated = getNode(node.id)!;
612
+ expect(updated.significance).toBeCloseTo(0.55, 5); // 0.5 × 1.1
613
+ });
614
+
615
+ test("significance does not exceed 1.0", () => {
616
+ const node = createNode(makeNewNode({ significance: 0.95 }));
617
+ reinforceNode(node.id);
618
+ const updated = getNode(node.id)!;
619
+ expect(updated.significance).toBeLessThanOrEqual(1.0);
620
+ });
621
+
622
+ test("updates lastReinforced timestamp", () => {
623
+ const oldTime = Date.now() - 10000;
624
+ const node = createNode(makeNewNode({ lastReinforced: oldTime }));
625
+ reinforceNode(node.id);
626
+ const updated = getNode(node.id)!;
627
+ expect(updated.lastReinforced).toBeGreaterThan(oldTime);
628
+ });
629
+
630
+ test("multiple reinforcements compound stability", () => {
631
+ const node = createNode(makeNewNode({ stability: 14 }));
632
+ reinforceNode(node.id);
633
+ reinforceNode(node.id);
634
+ reinforceNode(node.id);
635
+ const updated = getNode(node.id)!;
636
+ expect(updated.reinforcementCount).toBe(3);
637
+ // 14 × 1.5^3 = 47.25
638
+ expect(updated.stability).toBeCloseTo(47.25, 1);
639
+ });
640
+ });
641
+
642
+ // ---------------------------------------------------------------------------
643
+ // Supersession
644
+ // ---------------------------------------------------------------------------
645
+
646
+ describe("supersedeNode", () => {
647
+ test("creates new node with inherited durability", () => {
648
+ const old = createNode(
649
+ makeNewNode({
650
+ content: "Old fact.",
651
+ stability: 50,
652
+ reinforcementCount: 5,
653
+ significance: 0.9,
654
+ }),
655
+ );
656
+ const newNodeInput = makeNewNode({
657
+ content: "Updated fact.",
658
+ stability: 14,
659
+ reinforcementCount: 0,
660
+ significance: 0.5,
661
+ });
662
+
663
+ const { newNode, oldNode } = supersedeNode(old.id, newNodeInput);
664
+
665
+ expect(newNode.content).toBe("Updated fact.");
666
+ // Inherits max of each durability metric
667
+ expect(newNode.stability).toBe(50); // max(14, 50)
668
+ expect(newNode.reinforcementCount).toBe(5); // max(0, 5)
669
+ expect(newNode.significance).toBe(0.9); // max(0.5, 0.9)
670
+ expect(oldNode).not.toBeNull();
671
+ expect(oldNode!.id).toBe(old.id);
672
+ });
673
+
674
+ test("creates a supersedes edge between new and old node", () => {
675
+ const old = createNode(makeNewNode({ content: "Old." }));
676
+ const { newNode } = supersedeNode(old.id, makeNewNode({ content: "New." }));
677
+
678
+ const edges = getEdgesForNode(newNode.id, "outgoing");
679
+ expect(edges).toHaveLength(1);
680
+ expect(edges[0].relationship).toBe("supersedes");
681
+ expect(edges[0].targetNodeId).toBe(old.id);
682
+ expect(edges[0].weight).toBe(1.0);
683
+ });
684
+
685
+ test("inherits eventDate from old node when new node has null eventDate", () => {
686
+ const eventDate = 1712534400000; // April 8 2024
687
+ const old = createNode(makeNewNode({ content: "Dentist April 8.", eventDate }));
688
+ const newNodeInput = makeNewNode({
689
+ content: "Dentist appointment rescheduled.",
690
+ eventDate: null,
691
+ });
692
+
693
+ const { newNode } = supersedeNode(old.id, newNodeInput);
694
+
695
+ expect(newNode.eventDate).toBe(eventDate);
696
+ });
697
+
698
+ test("uses new node eventDate when both nodes have eventDate", () => {
699
+ const old = createNode(makeNewNode({ content: "Flight Tuesday.", eventDate: 1712534400000 }));
700
+ const newEventDate = 1712620800000;
701
+ const newNodeInput = makeNewNode({
702
+ content: "Flight moved to Thursday.",
703
+ eventDate: newEventDate,
704
+ });
705
+
706
+ const { newNode } = supersedeNode(old.id, newNodeInput);
707
+
708
+ expect(newNode.eventDate).toBe(newEventDate);
709
+ });
710
+
711
+ test("handles non-existent old node by just creating new node", () => {
712
+ const { newNode, oldNode } = supersedeNode(
713
+ "non-existent",
714
+ makeNewNode({ content: "Brand new." }),
715
+ );
716
+ expect(newNode.content).toBe("Brand new.");
717
+ expect(oldNode).toBeNull();
718
+ });
719
+ });
720
+
721
+ // ---------------------------------------------------------------------------
722
+ // applyDiff
723
+ // ---------------------------------------------------------------------------
724
+
725
+ describe("applyDiff", () => {
726
+ test("creates nodes and returns counts", () => {
727
+ const result = applyDiff({
728
+ createNodes: [
729
+ makeNewNode({ content: "Node 1." }),
730
+ makeNewNode({ content: "Node 2." }),
731
+ ],
732
+ updateNodes: [],
733
+ deleteNodeIds: [],
734
+ createEdges: [],
735
+ deleteEdgeIds: [],
736
+ createTriggers: [],
737
+ deleteTriggerIds: [],
738
+ reinforceNodeIds: [],
739
+ });
740
+
741
+ expect(result.nodesCreated).toBe(2);
742
+ expect(result.createdNodeIds).toHaveLength(2);
743
+ });
744
+
745
+ test("deletes nodes", () => {
746
+ const node = createNode(makeNewNode());
747
+ const result = applyDiff({
748
+ createNodes: [],
749
+ updateNodes: [],
750
+ deleteNodeIds: [node.id],
751
+ createEdges: [],
752
+ deleteEdgeIds: [],
753
+ createTriggers: [],
754
+ deleteTriggerIds: [],
755
+ reinforceNodeIds: [],
756
+ });
757
+ expect(result.nodesDeleted).toBe(1);
758
+ expect(getNode(node.id)).toBeNull();
759
+ });
760
+
761
+ test("updates nodes", () => {
762
+ const node = createNode(makeNewNode({ content: "Before." }));
763
+ const result = applyDiff({
764
+ createNodes: [],
765
+ updateNodes: [{ id: node.id, changes: { content: "After." } }],
766
+ deleteNodeIds: [],
767
+ createEdges: [],
768
+ deleteEdgeIds: [],
769
+ createTriggers: [],
770
+ deleteTriggerIds: [],
771
+ reinforceNodeIds: [],
772
+ });
773
+ expect(result.nodesUpdated).toBe(1);
774
+ expect(getNode(node.id)!.content).toBe("After.");
775
+ });
776
+
777
+ test("reinforces nodes", () => {
778
+ const node = createNode(makeNewNode({ reinforcementCount: 0 }));
779
+ const result = applyDiff({
780
+ createNodes: [],
781
+ updateNodes: [],
782
+ deleteNodeIds: [],
783
+ createEdges: [],
784
+ deleteEdgeIds: [],
785
+ createTriggers: [],
786
+ deleteTriggerIds: [],
787
+ reinforceNodeIds: [node.id],
788
+ });
789
+ expect(result.nodesReinforced).toBe(1);
790
+ expect(getNode(node.id)!.reinforcementCount).toBe(1);
791
+ });
792
+
793
+ test("creates and deletes edges", () => {
794
+ const a = createNode(makeNewNode());
795
+ const b = createNode(makeNewNode());
796
+ const existingEdge = createEdge({
797
+ sourceNodeId: a.id,
798
+ targetNodeId: b.id,
799
+ relationship: "reminds-of",
800
+ weight: 1.0,
801
+ created: Date.now(),
802
+ });
803
+
804
+ const result = applyDiff({
805
+ createNodes: [],
806
+ updateNodes: [],
807
+ deleteNodeIds: [],
808
+ createEdges: [
809
+ {
810
+ sourceNodeId: b.id,
811
+ targetNodeId: a.id,
812
+ relationship: "caused-by",
813
+ weight: 0.5,
814
+ created: Date.now(),
815
+ },
816
+ ],
817
+ deleteEdgeIds: [existingEdge.id],
818
+ createTriggers: [],
819
+ deleteTriggerIds: [],
820
+ reinforceNodeIds: [],
821
+ });
822
+ expect(result.edgesCreated).toBe(1);
823
+ expect(result.edgesDeleted).toBe(1);
824
+ });
825
+
826
+ test("creates and deletes triggers", () => {
827
+ const node = createNode(makeNewNode());
828
+ const existingTrigger = createTrigger({
829
+ nodeId: node.id,
830
+ type: "temporal",
831
+ schedule: "time:morning",
832
+ condition: null,
833
+ conditionEmbedding: null,
834
+ threshold: null,
835
+ eventDate: null,
836
+ rampDays: null,
837
+ followUpDays: null,
838
+ recurring: false,
839
+ consumed: false,
840
+ cooldownMs: null,
841
+ lastFired: null,
842
+ });
843
+
844
+ const result = applyDiff({
845
+ createNodes: [],
846
+ updateNodes: [],
847
+ deleteNodeIds: [],
848
+ createEdges: [],
849
+ deleteEdgeIds: [],
850
+ createTriggers: [
851
+ {
852
+ nodeId: node.id,
853
+ type: "semantic",
854
+ schedule: null,
855
+ condition: "test",
856
+ conditionEmbedding: null,
857
+ threshold: 0.7,
858
+ eventDate: null,
859
+ rampDays: null,
860
+ followUpDays: null,
861
+ recurring: false,
862
+ consumed: false,
863
+ cooldownMs: null,
864
+ lastFired: null,
865
+ },
866
+ ],
867
+ deleteTriggerIds: [existingTrigger.id],
868
+ reinforceNodeIds: [],
869
+ });
870
+ expect(result.triggersCreated).toBe(1);
871
+ expect(result.triggersDeleted).toBe(1);
872
+ const remaining = getTriggersForNode(node.id);
873
+ expect(remaining).toHaveLength(1);
874
+ expect(remaining[0].type).toBe("semantic");
875
+ });
876
+
877
+ test("applies all operations atomically", () => {
878
+ // Verify all operations are in the same transaction by creating
879
+ // a complex diff and checking the result counts.
880
+ const existingNode = createNode(makeNewNode({ content: "Existing." }));
881
+
882
+ const result = applyDiff({
883
+ createNodes: [makeNewNode({ content: "New 1." })],
884
+ updateNodes: [{ id: existingNode.id, changes: { content: "Updated." } }],
885
+ deleteNodeIds: [],
886
+ createEdges: [],
887
+ deleteEdgeIds: [],
888
+ createTriggers: [],
889
+ deleteTriggerIds: [],
890
+ reinforceNodeIds: [existingNode.id],
891
+ });
892
+
893
+ expect(result.nodesCreated).toBe(1);
894
+ expect(result.nodesUpdated).toBe(1);
895
+ expect(result.nodesReinforced).toBe(1);
896
+ expect(getNode(existingNode.id)!.content).toBe("Updated.");
897
+ expect(getNode(existingNode.id)!.reinforcementCount).toBe(1);
898
+ });
899
+ });
900
+
901
+ // ---------------------------------------------------------------------------
902
+ // deleteTrigger
903
+ // ---------------------------------------------------------------------------
904
+
905
+ describe("deleteTrigger", () => {
906
+ test("removes a trigger by ID", () => {
907
+ const node = createNode(makeNewNode());
908
+ const trigger = createTrigger({
909
+ nodeId: node.id,
910
+ type: "event",
911
+ schedule: null,
912
+ condition: null,
913
+ conditionEmbedding: null,
914
+ threshold: null,
915
+ eventDate: Date.now(),
916
+ rampDays: 7,
917
+ followUpDays: 2,
918
+ recurring: false,
919
+ consumed: false,
920
+ cooldownMs: null,
921
+ lastFired: null,
922
+ });
923
+ deleteTrigger(trigger.id);
924
+ expect(getTriggersForNode(node.id)).toHaveLength(0);
925
+ });
926
+ });
927
+
928
+ // ---------------------------------------------------------------------------
929
+ // updateNode — event trigger sync
930
+ // ---------------------------------------------------------------------------
931
+
932
+ describe("updateNode event trigger sync", () => {
933
+ test("syncs event trigger eventDate when node eventDate is updated", () => {
934
+ const originalDate = 1712534400000;
935
+ const newDate = 1712620800000;
936
+ const node = createNode(makeNewNode({ eventDate: originalDate }));
937
+ createTrigger({
938
+ nodeId: node.id,
939
+ type: "event",
940
+ schedule: null,
941
+ condition: null,
942
+ conditionEmbedding: null,
943
+ threshold: null,
944
+ eventDate: originalDate,
945
+ rampDays: 7,
946
+ followUpDays: 2,
947
+ recurring: false,
948
+ consumed: false,
949
+ cooldownMs: null,
950
+ lastFired: null,
951
+ });
952
+
953
+ updateNode(node.id, { eventDate: newDate });
954
+
955
+ const triggers = getTriggersForNode(node.id);
956
+ expect(triggers).toHaveLength(1);
957
+ expect(triggers[0].eventDate).toBe(newDate);
958
+ });
959
+
960
+ test("deletes event trigger when node eventDate is cleared to null", () => {
961
+ const eventDate = 1712534400000;
962
+ const node = createNode(makeNewNode({ eventDate }));
963
+ createTrigger({
964
+ nodeId: node.id,
965
+ type: "event",
966
+ schedule: null,
967
+ condition: null,
968
+ conditionEmbedding: null,
969
+ threshold: null,
970
+ eventDate,
971
+ rampDays: 7,
972
+ followUpDays: 2,
973
+ recurring: false,
974
+ consumed: false,
975
+ cooldownMs: null,
976
+ lastFired: null,
977
+ });
978
+
979
+ updateNode(node.id, { eventDate: null });
980
+
981
+ const triggers = getTriggersForNode(node.id);
982
+ expect(triggers).toHaveLength(0);
983
+ });
984
+
985
+ test("does not affect non-event triggers when eventDate changes", () => {
986
+ const node = createNode(makeNewNode({ eventDate: 1712534400000 }));
987
+ createTrigger({
988
+ nodeId: node.id,
989
+ type: "event",
990
+ schedule: null,
991
+ condition: null,
992
+ conditionEmbedding: null,
993
+ threshold: null,
994
+ eventDate: 1712534400000,
995
+ rampDays: 7,
996
+ followUpDays: 2,
997
+ recurring: false,
998
+ consumed: false,
999
+ cooldownMs: null,
1000
+ lastFired: null,
1001
+ });
1002
+ createTrigger({
1003
+ nodeId: node.id,
1004
+ type: "semantic",
1005
+ schedule: null,
1006
+ condition: "cooking topic",
1007
+ conditionEmbedding: null,
1008
+ threshold: 0.7,
1009
+ eventDate: null,
1010
+ rampDays: null,
1011
+ followUpDays: null,
1012
+ recurring: false,
1013
+ consumed: false,
1014
+ cooldownMs: null,
1015
+ lastFired: null,
1016
+ });
1017
+
1018
+ updateNode(node.id, { eventDate: null });
1019
+
1020
+ const triggers = getTriggersForNode(node.id);
1021
+ expect(triggers).toHaveLength(1);
1022
+ expect(triggers[0].type).toBe("semantic");
1023
+ });
1024
+
1025
+ test("does not touch triggers when eventDate is not in changes", () => {
1026
+ const eventDate = 1712534400000;
1027
+ const node = createNode(makeNewNode({ eventDate }));
1028
+ createTrigger({
1029
+ nodeId: node.id,
1030
+ type: "event",
1031
+ schedule: null,
1032
+ condition: null,
1033
+ conditionEmbedding: null,
1034
+ threshold: null,
1035
+ eventDate,
1036
+ rampDays: 7,
1037
+ followUpDays: 2,
1038
+ recurring: false,
1039
+ consumed: false,
1040
+ cooldownMs: null,
1041
+ lastFired: null,
1042
+ });
1043
+
1044
+ // Update something other than eventDate
1045
+ updateNode(node.id, { content: "Updated content." });
1046
+
1047
+ const triggers = getTriggersForNode(node.id);
1048
+ expect(triggers).toHaveLength(1);
1049
+ expect(triggers[0].eventDate).toBe(eventDate);
1050
+ });
1051
+ });
1052
+
1053
+ // ---------------------------------------------------------------------------
1054
+ // Paragraph deduplication
1055
+ // ---------------------------------------------------------------------------
1056
+
1057
+ describe("deduplicateParagraphs", () => {
1058
+ test("content with no duplicates passes through unchanged", () => {
1059
+ const input = "First paragraph.\n\nSecond paragraph.\n\nThird paragraph.";
1060
+ expect(deduplicateParagraphs(input)).toBe(input);
1061
+ });
1062
+
1063
+ test("two identical paragraphs separated by \\n\\n collapses to one", () => {
1064
+ const input = "Hello world.\n\nHello world.";
1065
+ expect(deduplicateParagraphs(input)).toBe("Hello world.");
1066
+ });
1067
+
1068
+ test("paragraphs that differ only in trailing whitespace are treated as duplicates", () => {
1069
+ const input = "Hello world. \n\nHello world.";
1070
+ expect(deduplicateParagraphs(input)).toBe("Hello world. ");
1071
+ });
1072
+
1073
+ test("bullet lists with repeated items are deduped", () => {
1074
+ const input = "- item one\n- item two\n- item one\n- item three";
1075
+ expect(deduplicateParagraphs(input)).toBe(
1076
+ "- item one\n- item two\n- item three",
1077
+ );
1078
+ });
1079
+
1080
+ test("empty content returns empty string", () => {
1081
+ expect(deduplicateParagraphs("")).toBe("");
1082
+ });
1083
+
1084
+ test("multiple duplicate paragraphs with different content", () => {
1085
+ const input = "Alpha.\n\nBeta.\n\nAlpha.\n\nGamma.\n\nBeta.";
1086
+ expect(deduplicateParagraphs(input)).toBe("Alpha.\n\nBeta.\n\nGamma.");
1087
+ });
1088
+
1089
+ test("bullet dedup within a paragraph preserves non-bullet lines", () => {
1090
+ const input = "Header:\n- item A\n- item B\n- item A";
1091
+ expect(deduplicateParagraphs(input)).toBe("Header:\n- item A\n- item B");
1092
+ });
1093
+
1094
+ test("paragraphs differing only in internal whitespace are treated as duplicates", () => {
1095
+ const input = "hello world\n\nhello world";
1096
+ expect(deduplicateParagraphs(input)).toBe("hello world");
1097
+ });
1098
+ });