@vellumai/assistant 0.7.2 → 0.7.3

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 (347) hide show
  1. package/ARCHITECTURE.md +16 -1
  2. package/docs/architecture/memory.md +5 -2
  3. package/node_modules/@vellumai/gateway-client/src/ipc-client.ts +13 -4
  4. package/node_modules/@vellumai/skill-host-contracts/src/assistant-event.ts +0 -9
  5. package/node_modules/@vellumai/slack-text/src/index.test.ts +18 -35
  6. package/node_modules/@vellumai/slack-text/src/index.ts +2 -48
  7. package/openapi.yaml +449 -22
  8. package/package.json +1 -1
  9. package/src/__tests__/app-control-flow.test.ts +21 -11
  10. package/src/__tests__/assistant-event-hub.test.ts +48 -0
  11. package/src/__tests__/assistant-event.test.ts +0 -10
  12. package/src/__tests__/assistant-events-sse-hardening.test.ts +2 -7
  13. package/src/__tests__/assistant-feature-flags-integration.test.ts +18 -0
  14. package/src/__tests__/auto-analysis-end-to-end.test.ts +62 -1
  15. package/src/__tests__/background-workers-disk-pressure.test.ts +268 -0
  16. package/src/__tests__/call-conversation-messages.test.ts +8 -2
  17. package/src/__tests__/channel-inbound-disk-pressure.test.ts +537 -0
  18. package/src/__tests__/channel-readiness-service.test.ts +4 -2
  19. package/src/__tests__/config-loader-backfill.test.ts +379 -0
  20. package/src/__tests__/config-schema.test.ts +1 -0
  21. package/src/__tests__/config-watcher-cleanup-throttle.test.ts +18 -9
  22. package/src/__tests__/config-watcher.test.ts +140 -69
  23. package/src/__tests__/context-search-agent-runner.test.ts +61 -3
  24. package/src/__tests__/context-search-conversations-source.test.ts +0 -24
  25. package/src/__tests__/context-search-fanout.test.ts +0 -1
  26. package/src/__tests__/context-search-memory-source.test.ts +3 -7
  27. package/src/__tests__/context-search-memory-v2-source.test.ts +0 -2
  28. package/src/__tests__/context-search-pkb-source.test.ts +0 -1
  29. package/src/__tests__/context-search-workspace-source.test.ts +0 -1
  30. package/src/__tests__/conversation-abort-tool-results.test.ts +6 -0
  31. package/src/__tests__/conversation-agent-loop-disk-pressure.test.ts +223 -0
  32. package/src/__tests__/conversation-agent-loop.test.ts +454 -5
  33. package/src/__tests__/conversation-error.test.ts +150 -3
  34. package/src/__tests__/conversation-process-callsite.test.ts +43 -0
  35. package/src/__tests__/conversation-provider-retry-repair.test.ts +6 -0
  36. package/src/__tests__/conversation-runtime-assembly.test.ts +65 -0
  37. package/src/__tests__/conversation-slash-unknown.test.ts +6 -0
  38. package/src/__tests__/conversation-speed-override.test.ts +0 -3
  39. package/src/__tests__/conversation-store.test.ts +0 -18
  40. package/src/__tests__/conversation-surfaces-app-control.test.ts +15 -4
  41. package/src/__tests__/conversation-surfaces-data-persist.test.ts +404 -0
  42. package/src/__tests__/conversation-tool-setup-app-refresh.test.ts +2 -5
  43. package/src/__tests__/conversation-workspace-injection.test.ts +6 -0
  44. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +6 -0
  45. package/src/__tests__/credentials-cli.test.ts +7 -0
  46. package/src/__tests__/cu-unified-flow.test.ts +176 -10
  47. package/src/__tests__/date-context.test.ts +164 -2
  48. package/src/__tests__/disk-pressure-guard.test.ts +262 -0
  49. package/src/__tests__/disk-pressure-lifecycle.test.ts +168 -0
  50. package/src/__tests__/disk-pressure-policy.test.ts +241 -0
  51. package/src/__tests__/disk-pressure-routes.test.ts +379 -0
  52. package/src/__tests__/disk-pressure-tools.test.ts +277 -0
  53. package/src/__tests__/disk-usage.test.ts +150 -0
  54. package/src/__tests__/events-client-registration.test.ts +52 -0
  55. package/src/__tests__/events-dev-bypass-actor.test.ts +162 -0
  56. package/src/__tests__/file-write-tool.test.ts +4 -10
  57. package/src/__tests__/filing-service.test.ts +3 -4
  58. package/src/__tests__/heartbeat-disk-pressure.test.ts +183 -0
  59. package/src/__tests__/heartbeat-service.test.ts +260 -11
  60. package/src/__tests__/host-app-control-proxy.test.ts +195 -25
  61. package/src/__tests__/host-bash-proxy.test.ts +227 -34
  62. package/src/__tests__/host-bash-routes.test.ts +178 -13
  63. package/src/__tests__/host-cu-proxy.test.ts +210 -3
  64. package/src/__tests__/host-cu-routes-targeted.test.ts +141 -12
  65. package/src/__tests__/host-file-proxy-targeted.test.ts +48 -9
  66. package/src/__tests__/host-file-proxy.test.ts +268 -6
  67. package/src/__tests__/host-file-routes-targeted.test.ts +175 -17
  68. package/src/__tests__/host-transfer-proxy-targeted.test.ts +408 -59
  69. package/src/__tests__/host-transfer-routes-targeted.test.ts +232 -17
  70. package/src/__tests__/http-user-message-parity.test.ts +107 -1
  71. package/src/__tests__/injector-chain.test.ts +18 -6
  72. package/src/__tests__/injector-disk-pressure.test.ts +224 -0
  73. package/src/__tests__/managed-profile-guard.test.ts +18 -0
  74. package/src/__tests__/mcp-abort-signal.test.ts +130 -0
  75. package/src/__tests__/memory-admin-recall.test.ts +3 -11
  76. package/src/__tests__/memory-retrieval-pipeline.test.ts +22 -1
  77. package/src/__tests__/normalize-onboarding.test.ts +180 -0
  78. package/src/__tests__/oauth-connect-routes.test.ts +316 -0
  79. package/src/__tests__/oauth-provider-seed-logos.test.ts +24 -2
  80. package/src/__tests__/onboarding-persona-write.test.ts +308 -0
  81. package/src/__tests__/openai-provider.test.ts +45 -8
  82. package/src/__tests__/persist-onboarding-artifacts.test.ts +44 -64
  83. package/src/__tests__/platform-callback-registration.test.ts +21 -4
  84. package/src/__tests__/platform.test.ts +2 -1
  85. package/src/__tests__/playbook-execution.test.ts +0 -43
  86. package/src/__tests__/plugin-tool-contribution.test.ts +47 -0
  87. package/src/__tests__/prechat-onboarding-contract.test.ts +214 -27
  88. package/src/__tests__/provider-tool-name.test.ts +23 -0
  89. package/src/__tests__/relay-server.test.ts +15 -4
  90. package/src/__tests__/runtime-events-sse.test.ts +4 -8
  91. package/src/__tests__/scheduler-disk-pressure.test.ts +148 -0
  92. package/src/__tests__/secret-ingress-http.test.ts +0 -1
  93. package/src/__tests__/suggestion-routes.test.ts +46 -0
  94. package/src/__tests__/twilio-validation.test.ts +2 -2
  95. package/src/__tests__/workspace-migration-065-bump-stale-heartbeat-interval.test.ts +122 -0
  96. package/src/__tests__/workspace-migration-066-seed-heartbeat-callsite-cost-default.test.ts +285 -0
  97. package/src/__tests__/workspace-migration-068-release-notes-local-timezone.test.ts +90 -0
  98. package/src/__tests__/workspace-migration-safe-storage-limits-release.test.ts +90 -0
  99. package/src/approvals/guardian-decision-primitive.ts +13 -0
  100. package/src/approvals/guardian-request-resolvers.ts +16 -17
  101. package/src/backup/snapshot-lock.ts +2 -27
  102. package/src/bundler/compiler-tools.ts +3 -2
  103. package/src/calls/call-conversation-messages.ts +46 -10
  104. package/src/cli/commands/__tests__/webhooks.test.ts +0 -4
  105. package/src/cli/commands/bash.ts +35 -108
  106. package/src/cli/commands/contacts.ts +64 -25
  107. package/src/cli/commands/credentials.ts +56 -0
  108. package/src/cli/commands/memory-v2.ts +7 -6
  109. package/src/cli/commands/oauth/__tests__/connect.test.ts +437 -1
  110. package/src/cli/commands/oauth/connect.ts +127 -1
  111. package/src/cli/commands/platform/__tests__/callback-routes-list.test.ts +0 -3
  112. package/src/cli/commands/platform/__tests__/connect.test.ts +7 -1
  113. package/src/cli/commands/platform/__tests__/disconnect.test.ts +7 -1
  114. package/src/cli/commands/platform/__tests__/status.test.ts +103 -6
  115. package/src/cli/commands/platform/index.ts +16 -7
  116. package/src/cli/commands/status.ts +57 -0
  117. package/src/cli/program.ts +4 -2
  118. package/src/config/assistant-feature-flags.ts +13 -3
  119. package/src/config/bundled-skills/messaging/tools/messaging-analyze-style.ts +4 -3
  120. package/src/config/bundled-skills/phone-calls/references/TROUBLESHOOTING.md +13 -7
  121. package/src/config/bundled-skills/playbooks/tools/playbook-create.ts +2 -2
  122. package/src/config/bundled-skills/playbooks/tools/playbook-delete.ts +2 -2
  123. package/src/config/bundled-skills/playbooks/tools/playbook-list.ts +2 -2
  124. package/src/config/bundled-skills/playbooks/tools/playbook-update.ts +2 -2
  125. package/src/config/env.ts +0 -8
  126. package/src/config/feature-flag-registry.json +27 -3
  127. package/src/config/loader.ts +127 -8
  128. package/src/config/schemas/__tests__/memory-v2.test.ts +10 -5
  129. package/src/config/schemas/call-site-catalog.ts +14 -0
  130. package/src/config/schemas/channels.ts +0 -5
  131. package/src/config/schemas/heartbeat.ts +1 -1
  132. package/src/config/schemas/llm.ts +2 -0
  133. package/src/config/schemas/memory-lifecycle.ts +13 -0
  134. package/src/config/schemas/memory-v2.ts +75 -11
  135. package/src/config/schemas/platform.ts +43 -3
  136. package/src/config/schemas/services.ts +28 -0
  137. package/src/config/seed-inference-profiles.ts +230 -33
  138. package/src/contacts/contact-store.ts +0 -25
  139. package/src/daemon/__tests__/conversation-tool-setup.test.ts +86 -25
  140. package/src/daemon/assistant-attachments.ts +4 -4
  141. package/src/daemon/config-watcher.ts +85 -57
  142. package/src/daemon/conversation-agent-loop-handlers.ts +6 -0
  143. package/src/daemon/conversation-agent-loop.ts +170 -33
  144. package/src/daemon/conversation-error.ts +87 -15
  145. package/src/daemon/conversation-lifecycle.ts +1 -3
  146. package/src/daemon/conversation-process.ts +8 -0
  147. package/src/daemon/conversation-runtime-assembly.ts +26 -0
  148. package/src/daemon/conversation-store.ts +2 -2
  149. package/src/daemon/conversation-surfaces.ts +195 -15
  150. package/src/daemon/conversation-tool-setup.ts +57 -14
  151. package/src/daemon/conversation.ts +17 -22
  152. package/src/daemon/date-context.ts +71 -22
  153. package/src/daemon/disk-pressure-background-gate.ts +73 -0
  154. package/src/daemon/disk-pressure-guard.ts +343 -0
  155. package/src/daemon/disk-pressure-policy.ts +163 -0
  156. package/src/daemon/handlers/shared.ts +0 -1
  157. package/src/daemon/handlers/skills.ts +3 -4
  158. package/src/daemon/host-app-control-proxy.ts +137 -41
  159. package/src/daemon/host-bash-proxy.ts +46 -21
  160. package/src/daemon/host-cu-proxy.ts +49 -3
  161. package/src/daemon/host-file-proxy.ts +43 -7
  162. package/src/daemon/host-transfer-proxy.ts +95 -4
  163. package/src/daemon/lifecycle.ts +79 -28
  164. package/src/daemon/meet-host-supervisor.ts +4 -4
  165. package/src/daemon/meet-manifest-loader.ts +0 -1
  166. package/src/daemon/memory-v2-startup.ts +14 -4
  167. package/src/daemon/message-protocol.ts +3 -0
  168. package/src/daemon/message-types/conversations.ts +4 -0
  169. package/src/daemon/message-types/disk-pressure.ts +9 -0
  170. package/src/daemon/message-types/messages.ts +3 -0
  171. package/src/daemon/profiler-run-store.ts +5 -5
  172. package/src/daemon/tool-setup-types.ts +2 -2
  173. package/src/documents/document-store.ts +85 -0
  174. package/src/filing/filing-service.ts +30 -5
  175. package/src/heartbeat/__tests__/heartbeat-feed-event.test.ts +9 -16
  176. package/src/heartbeat/__tests__/heartbeat-run-store.test.ts +36 -0
  177. package/src/heartbeat/heartbeat-run-store.ts +13 -0
  178. package/src/heartbeat/heartbeat-service.ts +205 -31
  179. package/src/home/feed-scheduler.ts +18 -0
  180. package/src/inbound/platform-callback-registration.ts +8 -15
  181. package/src/ipc/__tests__/clients-list-ipc.test.ts +169 -0
  182. package/src/ipc/assistant-server.ts +56 -2
  183. package/src/ipc/gateway-client.ts +37 -3
  184. package/src/live-voice/live-voice-archive.ts +4 -4
  185. package/src/live-voice/protocol.ts +5 -7
  186. package/src/media/image-service.ts +1 -7
  187. package/src/memory/__tests__/fixtures/memory-v2-activation-fixtures.ts +21 -13
  188. package/src/memory/__tests__/jobs-worker-v2-schedule.test.ts +52 -22
  189. package/src/memory/__tests__/memory-v2-activation-log-store.test.ts +0 -6
  190. package/src/memory/__tests__/memory-v2-concept-frequency.test.ts +272 -0
  191. package/src/memory/admin.ts +5 -9
  192. package/src/memory/context-search/agent-runner.ts +19 -2
  193. package/src/memory/context-search/sources/conversations.ts +2 -11
  194. package/src/memory/context-search/sources/memory-v2.ts +5 -4
  195. package/src/memory/context-search/sources/memory.ts +0 -1
  196. package/src/memory/context-search/types.ts +0 -1
  197. package/src/memory/conversation-crud.ts +4 -12
  198. package/src/memory/db-init.ts +2 -0
  199. package/src/memory/embedding-runtime-manager.ts +119 -5
  200. package/src/memory/graph/__tests__/conversation-graph-memory-v2-routing.test.ts +32 -21
  201. package/src/memory/graph/conversation-graph-memory.ts +42 -54
  202. package/src/memory/graph/extraction.ts +1 -3
  203. package/src/memory/graph/graph-search.test.ts +10 -67
  204. package/src/memory/graph/graph-search.ts +1 -20
  205. package/src/memory/graph/retriever.test.ts +6 -0
  206. package/src/memory/graph/retriever.ts +6 -10
  207. package/src/memory/indexer.ts +54 -45
  208. package/src/memory/job-handlers/backfill.ts +2 -11
  209. package/src/memory/job-handlers/cleanup.ts +43 -0
  210. package/src/memory/job-handlers/embedding.ts +6 -8
  211. package/src/memory/job-handlers/summarization.ts +2 -7
  212. package/src/memory/jobs-store.ts +48 -0
  213. package/src/memory/jobs-worker.ts +81 -43
  214. package/src/memory/memory-v2-activation-log-store.ts +32 -14
  215. package/src/memory/memory-v2-concept-frequency.ts +169 -0
  216. package/src/memory/migrations/239-trace-events-created-at-index.ts +18 -0
  217. package/src/memory/migrations/index.ts +1 -0
  218. package/src/memory/pkb/pkb-search.test.ts +6 -0
  219. package/src/memory/qdrant-client.ts +0 -13
  220. package/src/memory/rerank-local.ts +374 -0
  221. package/src/memory/search/semantic.ts +6 -67
  222. package/src/memory/trace-event-store.ts +1 -17
  223. package/src/memory/v2/__tests__/activation.test.ts +311 -250
  224. package/src/memory/v2/__tests__/consolidation-job.test.ts +40 -8
  225. package/src/memory/v2/__tests__/injection.test.ts +157 -167
  226. package/src/memory/v2/__tests__/prompts-consolidation.test.ts +61 -2
  227. package/src/memory/v2/__tests__/qdrant.test.ts +16 -0
  228. package/src/memory/v2/__tests__/reranker.test.ts +338 -0
  229. package/src/memory/v2/__tests__/sim.test.ts +5 -199
  230. package/src/memory/v2/__tests__/skill-store.test.ts +71 -65
  231. package/src/memory/v2/__tests__/static-context.test.ts +76 -1
  232. package/src/memory/v2/activation.ts +149 -156
  233. package/src/memory/v2/consolidation-job.ts +62 -12
  234. package/src/memory/v2/injection.ts +47 -60
  235. package/src/memory/v2/prompts/consolidation.ts +36 -1
  236. package/src/memory/v2/qdrant.ts +99 -0
  237. package/src/memory/v2/reranker.ts +177 -0
  238. package/src/memory/v2/sim.ts +10 -84
  239. package/src/memory/v2/skill-content.ts +4 -3
  240. package/src/memory/v2/skill-store.ts +82 -59
  241. package/src/memory/v2/static-context.ts +22 -0
  242. package/src/memory/v2/types.ts +10 -10
  243. package/src/notifications/copy-composer.ts +13 -0
  244. package/src/notifications/signal.ts +4 -0
  245. package/src/oauth/AGENTS.md +3 -1
  246. package/src/oauth/__tests__/oauth-connect-state.test.ts +137 -0
  247. package/src/oauth/connect-orchestrator.ts +2 -0
  248. package/src/oauth/connection-resolver.test.ts +66 -1
  249. package/src/oauth/connection-resolver.ts +55 -1
  250. package/src/oauth/oauth-connect-state.ts +77 -0
  251. package/src/oauth/seed-providers.ts +58 -1
  252. package/src/plugins/defaults/injectors.ts +35 -2
  253. package/src/plugins/defaults/memory-retrieval.ts +5 -6
  254. package/src/plugins/types.ts +7 -0
  255. package/src/proactive-artifact/aux-message-injector.ts +74 -0
  256. package/src/proactive-artifact/decision.test.ts +226 -0
  257. package/src/proactive-artifact/decision.ts +165 -0
  258. package/src/proactive-artifact/index.ts +7 -0
  259. package/src/proactive-artifact/job.test.ts +867 -0
  260. package/src/proactive-artifact/job.ts +352 -0
  261. package/src/proactive-artifact/message-copy.ts +41 -0
  262. package/src/proactive-artifact/trigger-state.test.ts +277 -0
  263. package/src/proactive-artifact/trigger-state.ts +119 -0
  264. package/src/prompts/normalize-onboarding.ts +80 -0
  265. package/src/prompts/persona-resolver.ts +101 -9
  266. package/src/prompts/system-prompt.ts +21 -7
  267. package/src/prompts/templates/BOOTSTRAP.md +13 -5
  268. package/src/providers/__tests__/retry-callsite.test.ts +222 -1
  269. package/src/providers/model-intents.ts +7 -0
  270. package/src/providers/openrouter/client.ts +8 -0
  271. package/src/providers/retry.ts +50 -0
  272. package/src/providers/types.ts +1 -0
  273. package/src/runtime/__tests__/agent-wake.test.ts +456 -3
  274. package/src/runtime/agent-wake.ts +238 -100
  275. package/src/runtime/assistant-event-hub.ts +36 -6
  276. package/src/runtime/assistant-event.ts +0 -1
  277. package/src/runtime/auth/__tests__/route-policy.test.ts +64 -0
  278. package/src/runtime/auth/route-policy.ts +14 -1
  279. package/src/runtime/auth/same-actor.ts +216 -0
  280. package/src/runtime/channel-retry-sweep.ts +65 -1
  281. package/src/runtime/guardian-reply-router.ts +10 -0
  282. package/src/runtime/local-actor-identity.ts +52 -11
  283. package/src/runtime/pending-interactions.ts +8 -0
  284. package/src/runtime/routes/__tests__/client-routes.test.ts +155 -0
  285. package/src/runtime/routes/__tests__/conversation-query-routes.test.ts +0 -5
  286. package/src/runtime/routes/__tests__/heartbeat-routes.test.ts +1 -1
  287. package/src/runtime/routes/client-routes.ts +20 -2
  288. package/src/runtime/routes/contact-routes.ts +0 -25
  289. package/src/runtime/routes/conversation-routes.ts +35 -26
  290. package/src/runtime/routes/debug-bash-routes.ts +163 -0
  291. package/src/runtime/routes/disk-pressure-routes.ts +121 -0
  292. package/src/runtime/routes/document-pdf-renderer.ts +6 -2
  293. package/src/runtime/routes/documents-routes.ts +2 -75
  294. package/src/runtime/routes/events-routes.ts +41 -9
  295. package/src/runtime/routes/host-bash-routes.ts +23 -3
  296. package/src/runtime/routes/host-cu-routes.ts +33 -6
  297. package/src/runtime/routes/host-file-routes.ts +32 -6
  298. package/src/runtime/routes/host-transfer-routes.ts +79 -16
  299. package/src/runtime/routes/identity-routes.ts +7 -138
  300. package/src/runtime/routes/inbound-message-handler.ts +77 -12
  301. package/src/runtime/routes/inbound-stages/guardian-reply-intercept.ts +3 -0
  302. package/src/runtime/routes/index.ts +6 -0
  303. package/src/runtime/routes/memory-item-routes.test.ts +41 -15
  304. package/src/runtime/routes/memory-v2-routes.ts +33 -0
  305. package/src/runtime/routes/oauth-connect-routes.ts +153 -0
  306. package/src/runtime/verification-outbound-actions.ts +4 -4
  307. package/src/schedule/run-script.ts +37 -5
  308. package/src/schedule/scheduler.ts +20 -1
  309. package/src/security/encrypted-store.ts +2 -0
  310. package/src/security/secure-keys.ts +55 -0
  311. package/src/skills/remote-skill-policy.ts +4 -10
  312. package/src/subagent/index.ts +1 -7
  313. package/src/subagent/manager.ts +1 -15
  314. package/src/tasks/task-runner.ts +0 -1
  315. package/src/tasks/task-store.ts +0 -3
  316. package/src/tools/background-tool-registry.ts +17 -3
  317. package/src/tools/host-filesystem/edit.test.ts +151 -0
  318. package/src/tools/host-filesystem/edit.ts +43 -1
  319. package/src/tools/host-filesystem/read.test.ts +129 -0
  320. package/src/tools/host-filesystem/read.ts +43 -1
  321. package/src/tools/host-filesystem/transfer.test.ts +127 -2
  322. package/src/tools/host-filesystem/transfer.ts +56 -11
  323. package/src/tools/host-filesystem/write.test.ts +134 -0
  324. package/src/tools/host-filesystem/write.ts +43 -1
  325. package/src/tools/host-terminal/host-shell.ts +13 -6
  326. package/src/tools/mcp/mcp-tool-factory.ts +2 -1
  327. package/src/tools/memory/register.test.ts +12 -9
  328. package/src/tools/memory/register.ts +1 -2
  329. package/src/tools/provider-tool-name.ts +28 -0
  330. package/src/tools/registry.ts +30 -9
  331. package/src/tools/terminal/shell.ts +9 -1
  332. package/src/tools/tool-approval-handler.ts +31 -6
  333. package/src/tools/types.ts +24 -2
  334. package/src/tts/provider-catalog.ts +3 -5
  335. package/src/util/disk-usage.ts +138 -0
  336. package/src/util/platform.ts +21 -11
  337. package/src/util/process-liveness.ts +26 -0
  338. package/src/workspace/heartbeat-service.ts +19 -0
  339. package/src/workspace/migrations/065-bump-stale-heartbeat-interval.ts +60 -0
  340. package/src/workspace/migrations/066-seed-heartbeat-callsite-cost-default.ts +146 -0
  341. package/src/workspace/migrations/067-release-notes-safe-storage-limits.ts +72 -0
  342. package/src/workspace/migrations/068-release-notes-local-timezone.ts +65 -0
  343. package/src/workspace/migrations/registry.ts +8 -0
  344. package/src/__tests__/conversation-tool-setup-memory-scope.test.ts +0 -167
  345. package/src/memory/v2/__tests__/skill-qdrant.test.ts +0 -657
  346. package/src/memory/v2/skill-qdrant.ts +0 -404
  347. package/src/signals/bash.ts +0 -198
@@ -0,0 +1,537 @@
1
+ import { afterAll, beforeEach, describe, expect, mock, test } from "bun:test";
2
+
3
+ import { eq } from "drizzle-orm";
4
+
5
+ import type { DiskPressureStatus } from "../daemon/disk-pressure-guard.js";
6
+
7
+ const deliverChannelReplyMock = mock(
8
+ async (_callbackUrl: string, _payload: Record<string, unknown>) => {},
9
+ );
10
+ const expectedRemoteBlockReply =
11
+ "Storage is critically low, so remote messages are ignored until the guardian frees enough space. Please try again later.";
12
+
13
+ mock.module("../util/logger.js", () => ({
14
+ getLogger: () =>
15
+ new Proxy({} as Record<string, unknown>, {
16
+ get: () => () => {},
17
+ }),
18
+ }));
19
+
20
+ mock.module("../runtime/gateway-client.js", () => ({
21
+ deliverChannelReply: deliverChannelReplyMock,
22
+ }));
23
+
24
+ const lockedDiskPressureStatus: DiskPressureStatus = {
25
+ enabled: true,
26
+ state: "critical",
27
+ locked: true,
28
+ acknowledged: true,
29
+ overrideActive: false,
30
+ effectivelyLocked: true,
31
+ lockId: "disk-pressure-test",
32
+ usagePercent: 98,
33
+ thresholdPercent: 95,
34
+ path: "/workspace",
35
+ lastCheckedAt: "2026-05-05T00:00:00.000Z",
36
+ blockedCapabilities: ["agent-turns", "background-work", "remote-ingress"],
37
+ error: null,
38
+ };
39
+ const disabledDiskPressureStatus: DiskPressureStatus = {
40
+ enabled: false,
41
+ state: "disabled",
42
+ locked: false,
43
+ acknowledged: false,
44
+ overrideActive: false,
45
+ effectivelyLocked: false,
46
+ lockId: null,
47
+ usagePercent: null,
48
+ thresholdPercent: 95,
49
+ path: null,
50
+ lastCheckedAt: null,
51
+ blockedCapabilities: [],
52
+ error: null,
53
+ };
54
+ let diskPressureStatus = lockedDiskPressureStatus;
55
+ let diskPressureStatusSequence: DiskPressureStatus[] | undefined;
56
+
57
+ mock.module("../daemon/disk-pressure-guard.js", () => ({
58
+ getDiskPressureStatus: () =>
59
+ diskPressureStatusSequence?.shift() ?? diskPressureStatus,
60
+ }));
61
+
62
+ import { upsertContact } from "../contacts/contact-store.js";
63
+ import { getDb } from "../memory/db-connection.js";
64
+ import { initializeDb } from "../memory/db-init.js";
65
+ import * as deliveryCrud from "../memory/delivery-crud.js";
66
+ import {
67
+ canonicalGuardianRequests,
68
+ channelInboundEvents,
69
+ messages,
70
+ } from "../memory/schema.js";
71
+ import { sweepFailedEvents } from "../runtime/channel-retry-sweep.js";
72
+ import {
73
+ handleChannelInbound,
74
+ setAdapterProcessMessage,
75
+ } from "./helpers/channel-test-adapter.js";
76
+ import { createGuardianBinding } from "./helpers/create-guardian-binding.js";
77
+
78
+ initializeDb();
79
+
80
+ function resetTables(): void {
81
+ const db = getDb();
82
+ db.run("DELETE FROM channel_inbound_events");
83
+ db.run("DELETE FROM channel_guardian_approval_requests");
84
+ db.run("DELETE FROM canonical_guardian_requests");
85
+ db.run("DELETE FROM conversation_keys");
86
+ db.run("DELETE FROM messages");
87
+ db.run("DELETE FROM conversations");
88
+ db.run("DELETE FROM external_conversation_bindings");
89
+ db.run("DELETE FROM contact_channels");
90
+ db.run("DELETE FROM contacts");
91
+ }
92
+
93
+ function seedTrustedContact(policy: "allow" | "escalate" = "allow"): void {
94
+ upsertContact({
95
+ displayName: "Example User",
96
+ channels: [
97
+ {
98
+ type: "telegram",
99
+ address: "telegram-user-1",
100
+ externalUserId: "telegram-user-1",
101
+ status: "active",
102
+ policy,
103
+ },
104
+ ],
105
+ });
106
+ }
107
+
108
+ function makeInboundRequest(overrides: Record<string, unknown> = {}): Request {
109
+ return new Request("http://localhost/channels/inbound", {
110
+ method: "POST",
111
+ headers: {
112
+ "Content-Type": "application/json",
113
+ "X-Gateway-Origin": "test-token",
114
+ },
115
+ body: JSON.stringify({
116
+ sourceChannel: "telegram",
117
+ interface: "telegram",
118
+ conversationExternalId: "chat-123",
119
+ externalMessageId: `msg-${Date.now()}-${Math.random()
120
+ .toString(36)
121
+ .slice(2, 8)}`,
122
+ content: "hello",
123
+ actorExternalId: "telegram-user-1",
124
+ replyCallbackUrl: "https://gateway.test/deliver/telegram",
125
+ ...overrides,
126
+ }),
127
+ });
128
+ }
129
+
130
+ describe("channel inbound disk pressure gate", () => {
131
+ beforeEach(() => {
132
+ resetTables();
133
+ seedTrustedContact();
134
+ setAdapterProcessMessage(undefined);
135
+ deliverChannelReplyMock.mockClear();
136
+ deliverChannelReplyMock.mockImplementation(
137
+ async (_callbackUrl: string, _payload: Record<string, unknown>) => {},
138
+ );
139
+ diskPressureStatus = lockedDiskPressureStatus;
140
+ diskPressureStatusSequence = undefined;
141
+ });
142
+
143
+ afterAll(() => {
144
+ diskPressureStatus = disabledDiskPressureStatus;
145
+ });
146
+
147
+ test("blocks trusted-contact ingress before payload persistence or processing", async () => {
148
+ const processMessage = mock(async () => {
149
+ throw new Error("processMessage should not run");
150
+ });
151
+ setAdapterProcessMessage(processMessage);
152
+
153
+ const res = await handleChannelInbound(makeInboundRequest());
154
+ const body = (await res.json()) as Record<string, unknown>;
155
+
156
+ expect(res.status).toBe(200);
157
+ expect(body).toMatchObject({
158
+ accepted: true,
159
+ duplicate: false,
160
+ diskPressure: "blocked",
161
+ reason: "trusted-contact",
162
+ });
163
+ expect(processMessage).not.toHaveBeenCalled();
164
+ expect(deliverChannelReplyMock).toHaveBeenCalledWith(
165
+ "https://gateway.test/deliver/telegram",
166
+ expect.objectContaining({
167
+ chatId: "chat-123",
168
+ text: expect.stringContaining("remote messages are ignored"),
169
+ }),
170
+ );
171
+
172
+ const db = getDb();
173
+ const event = db.select().from(channelInboundEvents).get();
174
+ expect(event?.processingStatus).toBe("processed");
175
+ expect(event?.messageId).toBeNull();
176
+ expect(event?.rawPayload).toBeNull();
177
+ expect(db.select().from(messages).all()).toHaveLength(0);
178
+ });
179
+
180
+ test("preserves retryable duplicate ingress without re-sending block replies", async () => {
181
+ const inbound = deliveryCrud.recordInbound(
182
+ "telegram",
183
+ "chat-123",
184
+ "msg-duplicate-blocked",
185
+ );
186
+ deliveryCrud.storePayload(inbound.eventId, {
187
+ content: "retry me",
188
+ sourceChannel: "telegram",
189
+ interface: "telegram",
190
+ externalChatId: "chat-123",
191
+ trustCtx: {
192
+ trustClass: "trusted_contact",
193
+ sourceChannel: "telegram",
194
+ requesterExternalUserId: "telegram-user-1",
195
+ requesterChatId: "chat-123",
196
+ },
197
+ replyCallbackUrl: "https://gateway.test/deliver/telegram",
198
+ });
199
+
200
+ const db = getDb();
201
+ db.update(channelInboundEvents)
202
+ .set({
203
+ processingStatus: "failed",
204
+ processingAttempts: 1,
205
+ retryAfter: Date.now() - 1,
206
+ })
207
+ .where(eq(channelInboundEvents.id, inbound.eventId))
208
+ .run();
209
+
210
+ const processMessage = mock(async () => {
211
+ throw new Error("processMessage should not run");
212
+ });
213
+ setAdapterProcessMessage(processMessage);
214
+
215
+ const res = await handleChannelInbound(
216
+ makeInboundRequest({ externalMessageId: "msg-duplicate-blocked" }),
217
+ );
218
+ const body = (await res.json()) as Record<string, unknown>;
219
+
220
+ expect(body).toMatchObject({
221
+ accepted: true,
222
+ duplicate: true,
223
+ diskPressure: "blocked",
224
+ reason: "trusted-contact",
225
+ });
226
+ expect(processMessage).not.toHaveBeenCalled();
227
+ expect(deliverChannelReplyMock).not.toHaveBeenCalled();
228
+
229
+ const event = db
230
+ .select()
231
+ .from(channelInboundEvents)
232
+ .where(eq(channelInboundEvents.id, inbound.eventId))
233
+ .get();
234
+ expect(event?.processingStatus).toBe("failed");
235
+ expect(event?.messageId).toBeNull();
236
+ expect(event?.rawPayload).not.toBeNull();
237
+ expect(db.select().from(messages).all()).toHaveLength(0);
238
+ });
239
+
240
+ test("blocks non-guardian Slack reactions before persistence while locked", async () => {
241
+ upsertContact({
242
+ displayName: "Example Slack User",
243
+ channels: [
244
+ {
245
+ type: "slack",
246
+ address: "slack-user-1",
247
+ externalUserId: "slack-user-1",
248
+ status: "active",
249
+ policy: "allow",
250
+ },
251
+ ],
252
+ });
253
+ const processMessage = mock(async () => {
254
+ throw new Error("processMessage should not run");
255
+ });
256
+ setAdapterProcessMessage(processMessage);
257
+
258
+ const res = await handleChannelInbound(
259
+ makeInboundRequest({
260
+ sourceChannel: "slack",
261
+ interface: "slack",
262
+ conversationExternalId: "slack-channel-1",
263
+ externalMessageId: "slack-reaction-blocked",
264
+ content: "reaction:thumbsup",
265
+ actorExternalId: "slack-user-1",
266
+ callbackData: "reaction:thumbsup",
267
+ replyCallbackUrl: "https://gateway.test/deliver/slack",
268
+ }),
269
+ );
270
+ const body = (await res.json()) as Record<string, unknown>;
271
+
272
+ expect(body).toMatchObject({
273
+ accepted: true,
274
+ duplicate: false,
275
+ diskPressure: "blocked",
276
+ reason: "trusted-contact",
277
+ });
278
+ expect(processMessage).not.toHaveBeenCalled();
279
+ expect(deliverChannelReplyMock.mock.calls).toEqual([
280
+ [
281
+ "https://gateway.test/deliver/slack",
282
+ {
283
+ chatId: "slack-channel-1",
284
+ text: expectedRemoteBlockReply,
285
+ assistantId: "self",
286
+ ephemeral: true,
287
+ user: "slack-user-1",
288
+ },
289
+ ],
290
+ ]);
291
+
292
+ const db = getDb();
293
+ const event = db
294
+ .select()
295
+ .from(channelInboundEvents)
296
+ .where(
297
+ eq(channelInboundEvents.externalMessageId, "slack-reaction-blocked"),
298
+ )
299
+ .get();
300
+ expect(event?.processingStatus).toBe("processed");
301
+ expect(event?.messageId).toBeNull();
302
+ expect(event?.rawPayload).toBeNull();
303
+ expect(db.select().from(messages).all()).toHaveLength(0);
304
+ });
305
+
306
+ test("blocks escalation-policy trusted-contact ingress before escalation state", async () => {
307
+ resetTables();
308
+ createGuardianBinding({
309
+ channel: "telegram",
310
+ guardianExternalUserId: "guardian-user-1",
311
+ guardianDeliveryChatId: "guardian-chat-1",
312
+ guardianPrincipalId: "guardian-user-1",
313
+ });
314
+ seedTrustedContact("escalate");
315
+ const processMessage = mock(async () => {
316
+ throw new Error("processMessage should not run");
317
+ });
318
+ setAdapterProcessMessage(processMessage);
319
+
320
+ const res = await handleChannelInbound(
321
+ makeInboundRequest({ externalMessageId: "msg-escalate-blocked" }),
322
+ );
323
+ const body = (await res.json()) as Record<string, unknown>;
324
+
325
+ expect(body).toMatchObject({
326
+ accepted: true,
327
+ duplicate: false,
328
+ diskPressure: "blocked",
329
+ reason: "trusted-contact",
330
+ });
331
+ expect(processMessage).not.toHaveBeenCalled();
332
+
333
+ const db = getDb();
334
+ const event = db
335
+ .select()
336
+ .from(channelInboundEvents)
337
+ .where(eq(channelInboundEvents.externalMessageId, "msg-escalate-blocked"))
338
+ .get();
339
+ expect(event?.processingStatus).toBe("processed");
340
+ expect(event?.messageId).toBeNull();
341
+ expect(event?.rawPayload).toBeNull();
342
+
343
+ expect(db.select().from(canonicalGuardianRequests).all()).toHaveLength(0);
344
+ expect(db.select().from(messages).all()).toHaveLength(0);
345
+ });
346
+
347
+ test("marks trusted-contact retry-sweep events processed without replaying", async () => {
348
+ const inbound = deliveryCrud.recordInbound(
349
+ "telegram",
350
+ "chat-retry",
351
+ "msg-retry",
352
+ );
353
+ deliveryCrud.storePayload(inbound.eventId, {
354
+ content: "retry me",
355
+ sourceChannel: "telegram",
356
+ interface: "telegram",
357
+ externalChatId: "chat-retry",
358
+ trustCtx: {
359
+ trustClass: "trusted_contact",
360
+ sourceChannel: "telegram",
361
+ requesterExternalUserId: "telegram-user-1",
362
+ requesterChatId: "chat-retry",
363
+ },
364
+ replyCallbackUrl: "https://gateway.test/deliver/telegram",
365
+ });
366
+
367
+ const db = getDb();
368
+ db.update(channelInboundEvents)
369
+ .set({
370
+ processingStatus: "failed",
371
+ processingAttempts: 1,
372
+ retryAfter: Date.now() - 1,
373
+ })
374
+ .where(eq(channelInboundEvents.id, inbound.eventId))
375
+ .run();
376
+
377
+ const processMessage = mock(async () => ({ messageId: "msg-should-not" }));
378
+ await sweepFailedEvents(processMessage);
379
+
380
+ expect(processMessage).not.toHaveBeenCalled();
381
+ expect(deliverChannelReplyMock).toHaveBeenCalledWith(
382
+ "https://gateway.test/deliver/telegram",
383
+ expect.objectContaining({
384
+ chatId: "chat-retry",
385
+ text: expect.stringContaining("remote messages are ignored"),
386
+ }),
387
+ );
388
+
389
+ const row = db
390
+ .select()
391
+ .from(channelInboundEvents)
392
+ .where(eq(channelInboundEvents.id, inbound.eventId))
393
+ .get();
394
+ expect(row?.processingStatus).toBe("processed");
395
+ expect(row?.messageId).toBeNull();
396
+ expect(row?.rawPayload).toBeNull();
397
+ });
398
+
399
+ test("uses ephemeral Slack retry block replies targeted to the requester", async () => {
400
+ const inbound = deliveryCrud.recordInbound(
401
+ "slack",
402
+ "slack-channel-1",
403
+ "slack-msg-retry",
404
+ );
405
+ deliveryCrud.storePayload(inbound.eventId, {
406
+ content: "retry me",
407
+ sourceChannel: "slack",
408
+ interface: "slack",
409
+ externalChatId: "slack-channel-1",
410
+ trustCtx: {
411
+ trustClass: "trusted_contact",
412
+ sourceChannel: "slack",
413
+ requesterExternalUserId: "slack-user-1",
414
+ requesterChatId: "slack-channel-1",
415
+ },
416
+ replyCallbackUrl: "https://gateway.test/deliver/slack",
417
+ assistantId: "self",
418
+ });
419
+
420
+ const db = getDb();
421
+ db.update(channelInboundEvents)
422
+ .set({
423
+ processingStatus: "failed",
424
+ processingAttempts: 1,
425
+ retryAfter: Date.now() - 1,
426
+ })
427
+ .where(eq(channelInboundEvents.id, inbound.eventId))
428
+ .run();
429
+
430
+ const processMessage = mock(async () => ({ messageId: "msg-should-not" }));
431
+ await sweepFailedEvents(processMessage);
432
+
433
+ expect(processMessage).not.toHaveBeenCalled();
434
+ expect(deliverChannelReplyMock.mock.calls).toEqual([
435
+ [
436
+ "https://gateway.test/deliver/slack",
437
+ {
438
+ chatId: "slack-channel-1",
439
+ text: expectedRemoteBlockReply,
440
+ assistantId: "self",
441
+ ephemeral: true,
442
+ user: "slack-user-1",
443
+ },
444
+ ],
445
+ ]);
446
+
447
+ const row = db
448
+ .select()
449
+ .from(channelInboundEvents)
450
+ .where(eq(channelInboundEvents.id, inbound.eventId))
451
+ .get();
452
+ expect(row?.processingStatus).toBe("processed");
453
+ expect(row?.messageId).toBeNull();
454
+ expect(row?.rawPayload).toBeNull();
455
+ });
456
+
457
+ test("rechecks disk pressure between retry-sweep events", async () => {
458
+ const blocked = deliveryCrud.recordInbound(
459
+ "telegram",
460
+ "chat-retry-blocked",
461
+ "msg-retry-blocked",
462
+ );
463
+ deliveryCrud.storePayload(blocked.eventId, {
464
+ content: "retry while locked",
465
+ sourceChannel: "telegram",
466
+ interface: "telegram",
467
+ externalChatId: "chat-retry-blocked",
468
+ trustCtx: {
469
+ trustClass: "trusted_contact",
470
+ sourceChannel: "telegram",
471
+ requesterExternalUserId: "telegram-user-1",
472
+ requesterChatId: "chat-retry-blocked",
473
+ },
474
+ replyCallbackUrl: "https://gateway.test/deliver/telegram",
475
+ });
476
+
477
+ const replayed = deliveryCrud.recordInbound(
478
+ "telegram",
479
+ "chat-retry-replayed",
480
+ "msg-retry-replayed",
481
+ );
482
+ deliveryCrud.storePayload(replayed.eventId, {
483
+ content: "retry after unlock",
484
+ sourceChannel: "telegram",
485
+ interface: "telegram",
486
+ externalChatId: "chat-retry-replayed",
487
+ trustCtx: {
488
+ trustClass: "trusted_contact",
489
+ sourceChannel: "telegram",
490
+ requesterExternalUserId: "telegram-user-1",
491
+ requesterChatId: "chat-retry-replayed",
492
+ },
493
+ replyCallbackUrl: "https://gateway.test/deliver/telegram",
494
+ });
495
+
496
+ const db = getDb();
497
+ for (const eventId of [blocked.eventId, replayed.eventId]) {
498
+ db.update(channelInboundEvents)
499
+ .set({
500
+ processingStatus: "failed",
501
+ processingAttempts: 1,
502
+ retryAfter: Date.now() - 1,
503
+ })
504
+ .where(eq(channelInboundEvents.id, eventId))
505
+ .run();
506
+ }
507
+
508
+ diskPressureStatusSequence = [
509
+ lockedDiskPressureStatus,
510
+ disabledDiskPressureStatus,
511
+ ];
512
+ const processMessage = mock(
513
+ async (conversationId: string, content: string) => {
514
+ db.insert(messages)
515
+ .values({
516
+ id: "msg-replayed",
517
+ conversationId,
518
+ role: "user",
519
+ content: JSON.stringify([{ type: "text", text: content }]),
520
+ createdAt: Date.now(),
521
+ })
522
+ .run();
523
+ return { messageId: "msg-replayed" };
524
+ },
525
+ );
526
+
527
+ await sweepFailedEvents(processMessage);
528
+
529
+ expect(processMessage).toHaveBeenCalledTimes(1);
530
+ expect(deliverChannelReplyMock).toHaveBeenCalledTimes(1);
531
+ const rows = db.select().from(channelInboundEvents).all();
532
+ expect(rows.filter((row) => row.rawPayload === null)).toHaveLength(1);
533
+ expect(rows.filter((row) => row.messageId === "msg-replayed")).toHaveLength(
534
+ 1,
535
+ );
536
+ });
537
+ });
@@ -23,7 +23,9 @@ mock.module("../channels/config.js", () => ({
23
23
  }),
24
24
  }));
25
25
 
26
- mock.module("../config/env.js", () => ({}));
26
+ mock.module("../config/env.js", () => ({
27
+ getIngressPublicBaseUrl: () => undefined,
28
+ }));
27
29
 
28
30
  mock.module("../config/loader.js", () => ({
29
31
  loadRawConfig: () => mockRawConfig ?? {},
@@ -305,7 +307,7 @@ describe("ChannelReadinessService", () => {
305
307
  });
306
308
  });
307
309
 
308
- test("phone readiness accepts Twilio-specific ingress without generic public ingress", async () => {
310
+ test("phone readiness accepts configured public ingress", async () => {
309
311
  mockHasTwilioCredentials = true;
310
312
  mockTwilioPhoneNumber = "+15550123";
311
313
  mockRawConfig = {