@vellumai/assistant 0.8.8 → 0.8.9-staging.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 (340) hide show
  1. package/bun.lock +2 -2
  2. package/examples/plugins/echo/README.md +61 -60
  3. package/examples/plugins/echo/hooks/post-tool-use.ts +18 -0
  4. package/examples/plugins/echo/hooks/stop.ts +16 -0
  5. package/examples/plugins/echo/hooks/user-prompt-submit.ts +18 -0
  6. package/examples/plugins/echo/package.json +1 -2
  7. package/examples/plugins/echo/src/emit.ts +19 -0
  8. package/node_modules/@vellumai/skill-host-contracts/src/skill-host.ts +7 -6
  9. package/openapi.yaml +236 -6
  10. package/package.json +2 -2
  11. package/src/__tests__/agent-loop-callsite-precedence.test.ts +69 -14
  12. package/src/__tests__/agent-loop-exit-reason.test.ts +185 -140
  13. package/src/__tests__/agent-loop-mutable-latest-user-message.test.ts +50 -35
  14. package/src/__tests__/agent-loop-output-hooks.test.ts +357 -0
  15. package/src/__tests__/agent-loop-override-profile.test.ts +25 -6
  16. package/src/__tests__/agent-loop-provider-error-recording.test.ts +41 -21
  17. package/src/__tests__/agent-loop-thinking.test.ts +36 -20
  18. package/src/__tests__/agent-loop.test.ts +441 -96
  19. package/src/__tests__/agent-wake-disk-pressure-callsite.test.ts +14 -14
  20. package/src/__tests__/agent-wake-override-profile.test.ts +17 -21
  21. package/src/__tests__/anthropic-provider.test.ts +1 -1
  22. package/src/__tests__/app-control-flow.test.ts +1 -1
  23. package/src/__tests__/app-dir-path-guard.test.ts +1 -0
  24. package/src/__tests__/approval-cascade.test.ts +5 -4
  25. package/src/__tests__/approval-routes-http.test.ts +4 -1
  26. package/src/__tests__/background-workers-disk-pressure.test.ts +1 -1
  27. package/src/__tests__/channel-approval-routes.test.ts +1 -1
  28. package/src/__tests__/channel-approvals.test.ts +1 -1
  29. package/src/__tests__/compaction-circuit.test.ts +258 -0
  30. package/src/__tests__/compaction-direct.test.ts +132 -0
  31. package/src/__tests__/compaction-events.test.ts +5 -5
  32. package/src/__tests__/conversation-abort-tool-results.test.ts +6 -4
  33. package/src/__tests__/conversation-agent-loop-disk-pressure.test.ts +7 -10
  34. package/src/__tests__/conversation-agent-loop-inference-profile.test.ts +59 -103
  35. package/src/__tests__/conversation-agent-loop-overflow.test.ts +94 -189
  36. package/src/__tests__/conversation-agent-loop.test.ts +249 -490
  37. package/src/__tests__/conversation-clean-command.test.ts +5 -2
  38. package/src/__tests__/conversation-confirmation-signals.test.ts +5 -4
  39. package/src/__tests__/conversation-crud-inference-profile.test.ts +7 -9
  40. package/src/__tests__/conversation-process-app-control-preactivation.test.ts +4 -4
  41. package/src/__tests__/conversation-process-callsite.test.ts +14 -14
  42. package/src/__tests__/conversation-provider-retry-repair.test.ts +18 -16
  43. package/src/__tests__/conversation-queue.test.ts +9 -9
  44. package/src/__tests__/conversation-runtime-assembly.test.ts +923 -231
  45. package/src/__tests__/conversation-runtime-workspace.test.ts +115 -20
  46. package/src/__tests__/conversation-slash-queue.test.ts +6 -4
  47. package/src/__tests__/conversation-slash-unknown.test.ts +6 -4
  48. package/src/__tests__/conversation-speed-override.test.ts +10 -9
  49. package/src/__tests__/conversation-starter-routes.test.ts +14 -6
  50. package/src/__tests__/conversation-workspace-cache-state.test.ts +23 -20
  51. package/src/__tests__/conversation-workspace-injection.test.ts +68 -6
  52. package/src/__tests__/conversation-workspace-tool-tracking.test.ts +14 -11
  53. package/src/__tests__/conversations-import-system-filter.test.ts +101 -0
  54. package/src/__tests__/credential-security-invariants.test.ts +0 -1
  55. package/src/__tests__/db-acp-history.test.ts +101 -0
  56. package/src/__tests__/dynamic-page-surface.test.ts +31 -0
  57. package/src/__tests__/empty-response-hook.test.ts +1 -1
  58. package/src/__tests__/file-write-tool.test.ts +63 -0
  59. package/src/__tests__/gateway-only-guard.test.ts +12 -2
  60. package/src/__tests__/guardian-grant-minting.test.ts +1 -1
  61. package/src/__tests__/guardian-routing-invariants.test.ts +2 -4
  62. package/src/__tests__/handlers-user-message-approval-consumption.test.ts +1 -1
  63. package/src/__tests__/heartbeat-disk-pressure.test.ts +1 -0
  64. package/src/__tests__/heartbeat-service.test.ts +1 -0
  65. package/src/__tests__/history-repair-hook.test.ts +1 -1
  66. package/src/__tests__/host-app-control-routes.test.ts +1 -1
  67. package/src/__tests__/host-cu-routes-targeted.test.ts +3 -3
  68. package/src/__tests__/inference-profile-reaper.test.ts +62 -0
  69. package/src/__tests__/inference-profile-session-handler.test.ts +86 -0
  70. package/src/__tests__/injector-background-turn.test.ts +13 -23
  71. package/src/__tests__/injector-chain.test.ts +268 -44
  72. package/src/__tests__/injector-disk-pressure.test.ts +210 -52
  73. package/src/__tests__/injector-document-comments.test.ts +97 -114
  74. package/src/__tests__/injector-pkb-v2-silenced.test.ts +2 -2
  75. package/src/__tests__/injector-v3-suppression.test.ts +4 -4
  76. package/src/__tests__/list-messages-client-message-id.test.ts +91 -0
  77. package/src/__tests__/list-messages-hidden-metadata.test.ts +38 -0
  78. package/src/__tests__/memory-retrieval-hook.test.ts +73 -6
  79. package/src/__tests__/memory-v2-static-injector.test.ts +86 -8
  80. package/src/__tests__/parallel-tool.benchmark.test.ts +35 -8
  81. package/src/__tests__/plugin-api-shim.test.ts +6 -9
  82. package/src/__tests__/plugin-bootstrap.test.ts +12 -23
  83. package/src/__tests__/plugin-registry.test.ts +3 -49
  84. package/src/__tests__/plugin-types.test.ts +0 -70
  85. package/src/__tests__/reaction-persistence.test.ts +1 -1
  86. package/src/__tests__/send-endpoint-busy.test.ts +4 -1
  87. package/src/__tests__/skill-feature-flags-integration.test.ts +33 -0
  88. package/src/__tests__/steer-tool-repair.test.ts +1 -1
  89. package/src/__tests__/subagent-call-site-routing.test.ts +1 -1
  90. package/src/__tests__/subagent-detail.test.ts +25 -7
  91. package/src/__tests__/subagent-fork-notifications.test.ts +1 -3
  92. package/src/__tests__/subagent-fork-spawn.test.ts +1 -1
  93. package/src/__tests__/subagent-manager-notify.test.ts +1 -3
  94. package/src/__tests__/subagent-notify-parent.test.ts +1 -3
  95. package/src/__tests__/subagent-spawn-tool-fork.test.ts +1 -1
  96. package/src/__tests__/title-generate-hook.test.ts +1 -1
  97. package/src/__tests__/tool-error-hook.test.ts +1 -1
  98. package/src/__tests__/tool-result-truncate-hook.test.ts +1 -1
  99. package/src/__tests__/user-plugin-loader.test.ts +54 -286
  100. package/src/acp/__tests__/agent-process.test.ts +161 -0
  101. package/src/acp/__tests__/client-handler.test.ts +40 -0
  102. package/src/acp/__tests__/helpers/acp-history-db.ts +82 -0
  103. package/src/acp/__tests__/helpers/exec-file-stub.ts +101 -0
  104. package/src/acp/__tests__/prepare-agent-env.test.ts +137 -0
  105. package/src/acp/__tests__/session-manager-persistence.test.ts +95 -28
  106. package/src/acp/__tests__/session-manager-resume.test.ts +736 -0
  107. package/src/acp/agent-process.ts +61 -1
  108. package/src/acp/auto-install.test.ts +196 -0
  109. package/src/acp/auto-install.ts +177 -0
  110. package/src/acp/client-handler.ts +31 -0
  111. package/src/acp/feature-gate.test.ts +48 -0
  112. package/src/acp/feature-gate.ts +34 -0
  113. package/src/acp/prepare-agent-env.ts +83 -29
  114. package/src/acp/resolve-agent.test.ts +320 -7
  115. package/src/acp/resolve-agent.ts +182 -18
  116. package/src/acp/resume-hint.ts +25 -0
  117. package/src/acp/session-manager.ts +495 -73
  118. package/src/acp/types.ts +8 -0
  119. package/src/agent/compaction-circuit.ts +60 -102
  120. package/src/agent/loop.ts +390 -240
  121. package/src/api/responses/conversation-message.ts +14 -1
  122. package/src/approvals/guardian-request-resolvers.ts +1 -1
  123. package/src/background-wake/next-wake.ts +1 -0
  124. package/src/cli/commands/db/__tests__/repair.test.ts +3 -1
  125. package/src/cli/commands/plugins.ts +43 -37
  126. package/src/cli/lib/__tests__/install-from-github.test.ts +429 -111
  127. package/src/cli/lib/__tests__/plugin-catalog-cache.test.ts +196 -0
  128. package/src/cli/lib/__tests__/plugin-details.test.ts +372 -0
  129. package/src/cli/lib/__tests__/plugin-marketplace.test.ts +220 -0
  130. package/src/cli/lib/__tests__/search-plugins.test.ts +226 -32
  131. package/src/cli/lib/install-from-github.ts +464 -55
  132. package/src/cli/lib/plugin-catalog-cache.ts +84 -0
  133. package/src/cli/lib/plugin-details.ts +409 -0
  134. package/src/cli/lib/plugin-marketplace.ts +197 -0
  135. package/src/cli/lib/search-plugins.ts +195 -29
  136. package/src/config/__tests__/feature-flag-registry-guard.test.ts +2 -2
  137. package/src/config/acp-defaults.test.ts +10 -0
  138. package/src/config/acp-defaults.ts +6 -0
  139. package/src/config/bundled-skills/acp/SKILL.md +83 -31
  140. package/src/config/bundled-skills/acp/TOOLS.json +4 -4
  141. package/src/config/bundled-skills/app-builder/SKILL.md +224 -381
  142. package/src/config/bundled-skills/app-builder/TOOLS.json +29 -0
  143. package/src/config/bundled-skills/app-builder/references/DESIGN_SYSTEM.md +48 -0
  144. package/src/config/bundled-skills/app-builder/references/RESPONSIVE.md +57 -0
  145. package/src/config/bundled-skills/app-builder/references/SLIDES.md +38 -0
  146. package/src/config/bundled-skills/app-builder/tools/app-list.ts +62 -0
  147. package/src/config/bundled-skills/document-editor/SKILL.md +28 -23
  148. package/src/config/bundled-skills/document-editor/TOOLS.json +1 -1
  149. package/src/config/bundled-tool-registry.ts +2 -0
  150. package/src/config/feature-flag-registry.json +14 -5
  151. package/src/config/schemas/heartbeat.ts +9 -0
  152. package/src/context/strip-injections.ts +8 -2
  153. package/src/context/window-manager.ts +27 -13
  154. package/src/daemon/conversation-agent-loop-handlers.ts +10 -35
  155. package/src/daemon/conversation-agent-loop.ts +167 -1005
  156. package/src/daemon/conversation-lifecycle.ts +11 -255
  157. package/src/daemon/conversation-process.ts +8 -136
  158. package/src/daemon/conversation-registry.ts +159 -0
  159. package/src/daemon/conversation-runtime-assembly.ts +293 -392
  160. package/src/daemon/conversation-store.ts +9 -90
  161. package/src/daemon/conversation-surfaces.ts +24 -8
  162. package/src/daemon/conversation-workspace.ts +17 -0
  163. package/src/daemon/conversation.ts +383 -56
  164. package/src/daemon/external-plugins-bootstrap.ts +14 -19
  165. package/src/daemon/handlers/conversations.ts +3 -1
  166. package/src/daemon/handlers/skills.ts +4 -1
  167. package/src/daemon/host-proxy-preactivation.ts +1 -3
  168. package/src/daemon/lifecycle.ts +21 -0
  169. package/src/daemon/server.ts +2 -0
  170. package/src/daemon/wake-conversation-ops.ts +269 -0
  171. package/src/embedded/plugin-api.ts +2 -2
  172. package/src/export/__tests__/transcript-formatter.test.ts +5 -0
  173. package/src/heartbeat/__tests__/heartbeat-service.test.ts +3 -0
  174. package/src/heartbeat/heartbeat-run-store.ts +23 -1
  175. package/src/heartbeat/heartbeat-service.ts +26 -0
  176. package/src/ipc/__tests__/browser-ipc.test.ts +1 -1
  177. package/src/ipc/__tests__/ui-request-route.test.ts +3 -3
  178. package/src/ipc/skill-routes/__tests__/memory.test.ts +15 -0
  179. package/src/ipc/skill-routes/memory.ts +4 -2
  180. package/src/memory/__tests__/jobs-worker-v2-schedule.test.ts +87 -0
  181. package/src/memory/conversation-crud.ts +29 -19
  182. package/src/memory/conversation-starter-checkpoints.ts +1 -0
  183. package/src/memory/db-init.ts +2 -0
  184. package/src/memory/job-handlers/conversation-starters.ts +13 -2
  185. package/src/memory/jobs/__tests__/embed-concept-page.test.ts +5 -4
  186. package/src/memory/jobs-worker.ts +25 -1
  187. package/src/memory/migrations/272-acp-session-history-cwd.ts +36 -0
  188. package/src/memory/migrations/index.ts +1 -0
  189. package/src/memory/schema/acp.ts +4 -0
  190. package/src/memory/v2/__tests__/consolidation-job.test.ts +3 -3
  191. package/src/memory/v2/consolidation-job.ts +13 -4
  192. package/src/plugin-api/constants.ts +4 -0
  193. package/src/plugin-api/index.ts +6 -5
  194. package/src/plugin-api/types.ts +75 -0
  195. package/src/plugins/defaults/compaction/compact.ts +59 -0
  196. package/src/plugins/defaults/compaction/manager-store.ts +44 -0
  197. package/src/plugins/defaults/compaction/package.json +1 -2
  198. package/src/plugins/defaults/empty-response/package.json +0 -1
  199. package/src/plugins/defaults/history-repair/package.json +0 -1
  200. package/src/plugins/defaults/index.ts +135 -26
  201. package/src/plugins/defaults/memory-retrieval/hooks/post-compact.ts +103 -38
  202. package/src/plugins/defaults/memory-retrieval/hooks/user-prompt-submit-temp.ts +167 -56
  203. package/src/plugins/defaults/memory-retrieval/injector-chain.ts +2 -2
  204. package/src/plugins/defaults/{injectors/register.ts → memory-retrieval/injectors.ts} +148 -73
  205. package/src/plugins/defaults/memory-retrieval/unified-turn-context.ts +223 -0
  206. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/assign.test.ts +4 -4
  207. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/live-integration.test.ts +9 -6
  208. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/maintain-job.test.ts +5 -5
  209. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/orchestrate.test.ts +8 -5
  210. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/reconcile.test.ts +2 -2
  211. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/render-injection.test.ts +1 -1
  212. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/router.test.ts +10 -5
  213. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/selection-log-store.test.ts +8 -8
  214. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/selector.test.ts +5 -5
  215. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/shadow-plugin.test.ts +16 -17
  216. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/types.test.ts +2 -2
  217. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/assign.ts +9 -5
  218. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/capabilities.ts +5 -2
  219. package/src/plugins/defaults/memory-v3-shadow/hooks/post-compact.ts +14 -0
  220. package/src/plugins/defaults/memory-v3-shadow/hooks/user-prompt-submit.ts +19 -0
  221. package/src/plugins/defaults/memory-v3-shadow/injector.ts +75 -0
  222. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/maintain-job.ts +15 -8
  223. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/orchestrate.ts +2 -2
  224. package/src/plugins/defaults/memory-v3-shadow/package.json +14 -0
  225. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/page-content.ts +2 -2
  226. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/provider-blocks.ts +1 -1
  227. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/reconcile.ts +7 -3
  228. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/render-injection.ts +1 -1
  229. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/router.ts +5 -5
  230. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/selection-log-store.ts +4 -4
  231. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/selector.ts +7 -7
  232. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/shadow-plugin.ts +32 -94
  233. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/tree.ts +1 -1
  234. package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/types.ts +1 -1
  235. package/src/plugins/defaults/title-generate/package.json +0 -1
  236. package/src/plugins/defaults/tool-error/package.json +0 -1
  237. package/src/plugins/defaults/tool-result-truncate/package.json +0 -1
  238. package/src/plugins/pipeline.ts +6 -293
  239. package/src/plugins/registry.ts +9 -37
  240. package/src/plugins/types.ts +76 -381
  241. package/src/plugins/user-loader.ts +30 -127
  242. package/src/proactive-artifact/aux-message-injector.ts +1 -1
  243. package/src/proactive-artifact/job.test.ts +1 -1
  244. package/src/prompts/__tests__/system-prompt.test.ts +6 -0
  245. package/src/prompts/templates/BOOTSTRAP-ACTIVATION-RAIL.md +35 -3
  246. package/src/runtime/__tests__/agent-wake.test.ts +555 -691
  247. package/src/runtime/__tests__/interactive-ui.test.ts +1 -1
  248. package/src/runtime/agent-wake.ts +108 -209
  249. package/src/runtime/assistant-event-hub.ts +1 -1
  250. package/src/runtime/channel-approvals.ts +1 -1
  251. package/src/runtime/interactive-ui.ts +1 -1
  252. package/src/runtime/routes/__tests__/acp-routes.test.ts +283 -55
  253. package/src/runtime/routes/__tests__/conversation-list-routes.test.ts +1 -1
  254. package/src/runtime/routes/__tests__/plugins-routes.test.ts +398 -73
  255. package/src/runtime/routes/__tests__/surface-action-routes.test.ts +5 -4
  256. package/src/runtime/routes/__tests__/surface-content-routes.test.ts +4 -1
  257. package/src/runtime/routes/acp-routes.test.ts +89 -25
  258. package/src/runtime/routes/acp-routes.ts +81 -29
  259. package/src/runtime/routes/approval-routes.ts +1 -1
  260. package/src/runtime/routes/browser-routes.ts +1 -1
  261. package/src/runtime/routes/browser-tabs-routes.ts +6 -10
  262. package/src/runtime/routes/conversation-cli-routes.ts +1 -1
  263. package/src/runtime/routes/conversation-list-routes.ts +1 -1
  264. package/src/runtime/routes/conversation-query-routes.ts +1 -1
  265. package/src/runtime/routes/conversation-routes.ts +28 -2
  266. package/src/runtime/routes/conversation-starter-routes.ts +13 -7
  267. package/src/runtime/routes/conversations-import-routes.ts +24 -7
  268. package/src/runtime/routes/host-app-control-routes.ts +1 -1
  269. package/src/runtime/routes/host-cu-routes.ts +1 -1
  270. package/src/runtime/routes/identity-routes.ts +18 -3
  271. package/src/runtime/routes/inbound-message-handler.ts +1 -1
  272. package/src/runtime/routes/inference-profile-session-handler.ts +11 -0
  273. package/src/runtime/routes/inference-profile-session-reaper.ts +6 -0
  274. package/src/runtime/routes/memory-v3-routes.ts +16 -6
  275. package/src/runtime/routes/playground/helpers.ts +1 -1
  276. package/src/runtime/routes/plugins-routes.ts +336 -35
  277. package/src/runtime/routes/surface-conversation-resolver.ts +4 -3
  278. package/src/runtime/routes/work-items-routes.ts +2 -4
  279. package/src/runtime/services/conversation-serializer.ts +1 -1
  280. package/src/signals/cancel.ts +2 -4
  281. package/src/subagent/manager.ts +21 -5
  282. package/src/tools/acp/context.ts +20 -0
  283. package/src/tools/acp/list-agents.test.ts +7 -1
  284. package/src/tools/acp/spawn.test.ts +158 -55
  285. package/src/tools/acp/spawn.ts +47 -72
  286. package/src/tools/acp/steer.test.ts +105 -8
  287. package/src/tools/acp/steer.ts +48 -17
  288. package/src/tools/apps/executors.ts +13 -8
  289. package/src/tools/filesystem/write.ts +34 -0
  290. package/src/tools/subagent/spawn.ts +2 -4
  291. package/src/tools/ui-surface/definitions.ts +25 -5
  292. package/src/workspace/migrations/051-seed-conversation-summarization-callsite.ts +4 -5
  293. package/src/workspace/migrations/097-enable-adaptive-thinking-managed-profiles.ts +69 -45
  294. package/docs/plugins.md +0 -832
  295. package/examples/plugins/echo/register.ts +0 -143
  296. package/src/__tests__/circuit-breaker-pipeline.test.ts +0 -405
  297. package/src/__tests__/compaction-pipeline.test.ts +0 -210
  298. package/src/__tests__/compaction-timeout-recovery.test.ts +0 -251
  299. package/src/__tests__/overflow-reduce-pipeline.test.ts +0 -667
  300. package/src/__tests__/pipeline-runner.test.ts +0 -554
  301. package/src/__tests__/plugin-external-api.test.ts +0 -68
  302. package/src/daemon/wake-target-adapter.ts +0 -253
  303. package/src/plugins/defaults/circuit-breaker/middlewares/circuitBreaker.ts +0 -93
  304. package/src/plugins/defaults/circuit-breaker/package.json +0 -15
  305. package/src/plugins/defaults/circuit-breaker/register.ts +0 -39
  306. package/src/plugins/defaults/compaction/middlewares/compaction.ts +0 -25
  307. package/src/plugins/defaults/compaction/register.ts +0 -35
  308. package/src/plugins/defaults/compaction/terminal.ts +0 -73
  309. package/src/plugins/defaults/empty-response/register.ts +0 -23
  310. package/src/plugins/defaults/history-repair/register.ts +0 -24
  311. package/src/plugins/defaults/overflow-reduce/middlewares/overflowReduce.ts +0 -126
  312. package/src/plugins/defaults/overflow-reduce/package.json +0 -15
  313. package/src/plugins/defaults/overflow-reduce/register.ts +0 -42
  314. package/src/plugins/defaults/title-generate/register.ts +0 -35
  315. package/src/plugins/defaults/tool-error/register.ts +0 -23
  316. package/src/plugins/defaults/tool-result-truncate/register.ts +0 -24
  317. package/src/plugins/external-api.ts +0 -104
  318. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/capabilities.test.ts +0 -0
  319. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/core.test.ts +0 -0
  320. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/fixtures/eval-turns.json +0 -0
  321. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/fixtures/live-turns.json +0 -0
  322. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/health.test.ts +0 -0
  323. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/needle.test.ts +0 -0
  324. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/provider-blocks.test.ts +0 -0
  325. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/snapshot.test.ts +0 -0
  326. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/tree.test.ts +0 -0
  327. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/working-set-eviction.test.ts +0 -0
  328. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/__tests__/working-set-skeleton.test.ts +0 -0
  329. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/core.ts +0 -0
  330. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/data/README.md +0 -0
  331. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/data/assignments.json +0 -0
  332. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/data/core.json +0 -0
  333. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/data/leaves/domain-a/topic-x.md +0 -0
  334. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/data/leaves/domain-a/topic-y.md +0 -0
  335. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/data/leaves/domain-b/topic-z.md +0 -0
  336. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/health.ts +0 -0
  337. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/llm-retry.ts +0 -0
  338. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/needle.ts +0 -0
  339. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/snapshot.ts +0 -0
  340. /package/src/{memory/v3 → plugins/defaults/memory-v3-shadow}/working-set.ts +0 -0
@@ -22,7 +22,6 @@ import type { Message } from "../providers/types.js";
22
22
 
23
23
  mock.module("../memory/conversation-crud.js", () => ({
24
24
  getConversationOverrideProfile: () => undefined,
25
- reserveMessage: mock(async () => ({ id: "msg-reserve" })),
26
25
  }));
27
26
 
28
27
  mock.module("../config/loader.js", () => ({
@@ -62,36 +61,37 @@ mock.module("../daemon/disk-pressure-guard.js", () => ({
62
61
  }),
63
62
  }));
64
63
 
64
+ import type { Conversation } from "../daemon/conversation.js";
65
65
  import {
66
66
  __resetWakeChainForTests,
67
67
  wakeAgentForOpportunity,
68
- type WakeTarget,
69
68
  } from "../runtime/agent-wake.js";
70
69
 
71
- function makeTarget(): WakeTarget {
72
- const history: Message[] = [];
70
+ function makeTarget(): Conversation {
71
+ const messages: Message[] = [];
73
72
  let processing = false;
74
- return {
73
+ const target = {
75
74
  conversationId: "conv-wake-callsite",
76
75
  agentLoop: {
77
- run: (async (messages: Message[]) => ({
76
+ run: async ({ messages }: { messages: Message[] }) => ({
78
77
  history: messages,
79
78
  exitReason: null,
80
79
  appendedNewMessages: false,
81
80
  newMessages: [],
82
- })) as WakeTarget["agentLoop"]["run"],
81
+ }),
83
82
  },
84
- getMessages: () => history,
85
- pushMessage: (msg) => {
86
- history.push(msg);
87
- },
88
- emitAgentEvent: () => {},
83
+ messages,
84
+ getMessages: () => messages,
89
85
  isProcessing: () => processing,
90
- markProcessing: (on) => {
86
+ setProcessing: (on: boolean) => {
91
87
  processing = on;
92
88
  },
93
- persistTailMessage: async () => {},
89
+ setTrustContext: () => {},
90
+ getTurnChannelContext: () => null,
91
+ getTurnInterfaceContext: () => null,
92
+ drainQueue: async () => {},
94
93
  };
94
+ return target as unknown as Conversation;
95
95
  }
96
96
 
97
97
  beforeEach(() => {
@@ -48,8 +48,9 @@ mock.module("../config/loader.js", () => ({
48
48
  }),
49
49
  }));
50
50
 
51
- import type { AgentEvent, AgentLoopRunOptions } from "../agent/loop.js";
51
+ import type { AgentLoopRunOptions } from "../agent/loop.js";
52
52
  import { LLMSchema } from "../config/schemas/llm.js";
53
+ import type { Conversation } from "../daemon/conversation.js";
53
54
  import { RetryProvider } from "../providers/retry.js";
54
55
  import type {
55
56
  Message,
@@ -60,7 +61,6 @@ import type {
60
61
  import {
61
62
  __resetWakeChainForTests,
62
63
  wakeAgentForOpportunity,
63
- type WakeTarget,
64
64
  } from "../runtime/agent-wake.js";
65
65
 
66
66
  interface RunArgs {
@@ -69,44 +69,40 @@ interface RunArgs {
69
69
  }
70
70
 
71
71
  function makeTarget(): {
72
- target: WakeTarget;
72
+ target: Conversation;
73
73
  runArgs: RunArgs[];
74
74
  } {
75
75
  const runArgs: RunArgs[] = [];
76
- const history: Message[] = [
76
+ const messages: Message[] = [
77
77
  { role: "user", content: [{ type: "text", text: "hi" }] },
78
78
  ];
79
79
  let processing = false;
80
80
 
81
- const target: WakeTarget = {
81
+ const target = {
82
82
  conversationId: "conv-wake-override",
83
83
  agentLoop: {
84
- run: (async (
85
- messages: Message[],
86
- _onEvent: (event: AgentEvent) => void | Promise<void>,
87
- options?: AgentLoopRunOptions,
88
- ) => {
84
+ run: async (options: AgentLoopRunOptions) => {
89
85
  runArgs.push({
90
- messages: [...messages],
86
+ messages: [...options.messages],
91
87
  options,
92
88
  });
93
89
  // Return the input verbatim → silent no-op (no assistant tail).
94
90
  // Wake never yields at a checkpoint, so the pause-reason is null.
95
- return { history: messages, exitReason: null };
96
- }) as WakeTarget["agentLoop"]["run"],
97
- },
98
- getMessages: () => history,
99
- pushMessage: (msg) => {
100
- history.push(msg);
91
+ return { history: options.messages, exitReason: null };
92
+ },
101
93
  },
102
- emitAgentEvent: () => {},
94
+ messages,
95
+ getMessages: () => messages,
103
96
  isProcessing: () => processing,
104
- markProcessing: (on) => {
97
+ setProcessing: (on: boolean) => {
105
98
  processing = on;
106
99
  },
107
- persistTailMessage: async () => {},
100
+ setTrustContext: () => {},
101
+ getTurnChannelContext: () => null,
102
+ getTurnInterfaceContext: () => null,
103
+ drainQueue: async () => {},
108
104
  };
109
- return { target, runArgs };
105
+ return { target: target as unknown as Conversation, runArgs };
110
106
  }
111
107
 
112
108
  beforeEach(() => {
@@ -102,7 +102,7 @@ mock.module("@anthropic-ai/sdk", () => ({
102
102
  }));
103
103
 
104
104
  // Import after mocking
105
- import { cachedTextBlock } from "../memory/v3/provider-blocks.js";
105
+ import { cachedTextBlock } from "../plugins/defaults/memory-v3-shadow/provider-blocks.js";
106
106
  import { AnthropicProvider } from "../providers/anthropic/client.js";
107
107
  import {
108
108
  isPlaceholderSentinelText,
@@ -103,7 +103,7 @@ const { ROUTES } = await import("../runtime/routes/host-app-control-routes.js");
103
103
  const { surfaceProxyResolver } =
104
104
  await import("../daemon/conversation-surfaces.js");
105
105
  const { setConversation, clearConversations } =
106
- await import("../daemon/conversation-store.js");
106
+ await import("../daemon/conversation-registry.js");
107
107
  type SurfaceConversationContext =
108
108
  import("../daemon/conversation-surfaces.js").SurfaceConversationContext;
109
109
 
@@ -19,6 +19,7 @@ const ALLOWLIST = new Set([
19
19
  "assistant/src/memory/app-store.ts", // defines getAppsDir
20
20
  "assistant/src/memory/app-git-service.ts", // uses getAppsDir for git repo root, not per-app paths
21
21
  "assistant/src/daemon/app-source-watcher.ts", // uses getAppsDir for recursive fs.watch root, not per-app paths
22
+ "assistant/src/tools/filesystem/write.ts", // uses getAppsDir as an exemption root for the artifact-HTML guard, not per-app paths
22
23
  ]);
23
24
 
24
25
  function isTestFile(filePath: string): boolean {
@@ -176,6 +176,7 @@ mock.module("../memory/retriever.js", () => ({
176
176
  mock.module("../context/window-manager.js", () => ({
177
177
  ContextWindowManager: class {
178
178
  constructor() {}
179
+ updateConfig() {}
179
180
  shouldCompact() {
180
181
  return { needed: false, estimatedTokens: 0 };
181
182
  }
@@ -208,10 +209,10 @@ mock.module("../agent/loop.js", () => ({
208
209
  getActiveModel() {
209
210
  return undefined;
210
211
  }
211
- async run(
212
- _messages: Message[],
213
- _onEvent: (event: AgentEvent) => void,
214
- ): Promise<Message[]> {
212
+ async run(_options: {
213
+ messages: Message[];
214
+ onEvent: (event: AgentEvent) => void;
215
+ }): Promise<Message[]> {
215
216
  return [];
216
217
  }
217
218
  },
@@ -119,12 +119,15 @@ mock.module("../permissions/trust-store.js", () => ({
119
119
  // ---------------------------------------------------------------------------
120
120
  let _conversationFactory: (() => Conversation) | undefined;
121
121
 
122
- mock.module("../daemon/conversation-store.js", () => ({
122
+ mock.module("../daemon/conversation-registry.js", () => ({
123
123
  findConversation: () => {
124
124
  // Return the current test session for any conversation ID lookup.
125
125
  if (!_conversationFactory) return undefined;
126
126
  return _conversationFactory();
127
127
  },
128
+ }));
129
+
130
+ mock.module("../daemon/conversation-store.js", () => ({
128
131
  getOrCreateConversation: async () => {
129
132
  if (!_conversationFactory)
130
133
  throw new Error("_conversationFactory not set in test");
@@ -117,7 +117,7 @@ mock.module("../memory/conversation-crud.js", () => ({
117
117
  findMostRecentRetrospectiveFor: mock(() => null),
118
118
  forkConversation: mock(() => ({ id: "conv-fork" })),
119
119
  getConversationOverrideProfile: () => undefined,
120
- getConversationOverrideProfileFromRow: () => undefined,
120
+ resolveOverrideProfile: () => undefined,
121
121
  getConversationMemoryScopeId: () => "default",
122
122
  getConversationOriginChannel: () => null,
123
123
  getConversationOriginInterface: () => null,
@@ -16,7 +16,7 @@ mock.module("../util/logger.js", () => ({
16
16
  }));
17
17
 
18
18
  const _conversationMocks = new Map<string, unknown>();
19
- mock.module("../daemon/conversation-store.js", () => ({
19
+ mock.module("../daemon/conversation-registry.js", () => ({
20
20
  findConversation: (id: string) => _conversationMocks.get(id),
21
21
  }));
22
22
 
@@ -11,7 +11,7 @@ mock.module("../util/logger.js", () => ({
11
11
 
12
12
  // Map conversationId → mock session so findConversation returns the right mock.
13
13
  const conversationMocks = new Map<string, unknown>();
14
- mock.module("../daemon/conversation-store.js", () => ({
14
+ mock.module("../daemon/conversation-registry.js", () => ({
15
15
  findConversation: (id: string) => conversationMocks.get(id),
16
16
  }));
17
17
 
@@ -0,0 +1,258 @@
1
+ /**
2
+ * Tests for the `CompactionCircuit` class.
3
+ *
4
+ * The breaker logic lives as direct methods on the per-conversation
5
+ * `CompactionCircuit` state container (`agent/compaction-circuit.ts`). These
6
+ * tests assert the threshold (3 consecutive failures) and cooldown (1 hour)
7
+ * exactly match the user-visible behavior:
8
+ * (a) counter increments on each failure outcome
9
+ * (b) circuit opens after exactly 3 consecutive failures
10
+ * (c) successful compaction resets counter and clears the circuit
11
+ * (d) isOpen() reflects state and cooldown expiry
12
+ * (e) circuit re-opens after cooldown expiry when 3 more failures
13
+ * accumulate (guards the stale-timestamp regression)
14
+ * (f) isOpen() is query-only and never mutates the counter
15
+ * (g) open→closed transition emits `compaction_circuit_closed` exactly once
16
+ * (h) closed→closed transition emits nothing
17
+ */
18
+
19
+ import { afterEach, beforeEach, describe, expect, test } from "bun:test";
20
+
21
+ import {
22
+ COMPACTION_CIRCUIT_COOLDOWN_MS,
23
+ COMPACTION_CIRCUIT_FAILURE_THRESHOLD,
24
+ CompactionCircuit,
25
+ } from "../agent/compaction-circuit.js";
26
+ import type { CompactionCircuitEvent } from "../plugins/types.js";
27
+
28
+ // ─── Fixtures ───────────────────────────────────────────────────────────────
29
+
30
+ const CONVERSATION_ID = "conv-breaker-test";
31
+
32
+ function collectEvents(): {
33
+ events: CompactionCircuitEvent[];
34
+ onEvent: (msg: CompactionCircuitEvent) => void;
35
+ } {
36
+ const events: CompactionCircuitEvent[] = [];
37
+ return { events, onEvent: (msg) => events.push(msg) };
38
+ }
39
+
40
+ describe("CompactionCircuit", () => {
41
+ let originalDateNow: () => number;
42
+
43
+ beforeEach(() => {
44
+ originalDateNow = Date.now;
45
+ });
46
+
47
+ afterEach(() => {
48
+ Date.now = originalDateNow;
49
+ });
50
+
51
+ test("threshold and cooldown constants match the user-visible contract", () => {
52
+ expect(COMPACTION_CIRCUIT_FAILURE_THRESHOLD).toBe(3);
53
+ expect(COMPACTION_CIRCUIT_COOLDOWN_MS).toBe(60 * 60 * 1000);
54
+ });
55
+
56
+ test("(a) counter increments on each failure outcome", async () => {
57
+ const circuit = new CompactionCircuit(CONVERSATION_ID);
58
+ const { onEvent, events } = collectEvents();
59
+
60
+ await circuit.recordOutcome(true, onEvent);
61
+ expect(circuit.consecutiveCompactionFailures).toBe(1);
62
+ expect(circuit.compactionCircuitOpenUntil).toBeNull();
63
+ expect(events).toHaveLength(0);
64
+
65
+ await circuit.recordOutcome(true, onEvent);
66
+ expect(circuit.consecutiveCompactionFailures).toBe(2);
67
+ expect(circuit.compactionCircuitOpenUntil).toBeNull();
68
+ expect(events).toHaveLength(0);
69
+ });
70
+
71
+ test("(b) circuit opens after exactly 3 consecutive failures", async () => {
72
+ const fixedNow = 1_700_000_000_000;
73
+ Date.now = () => fixedNow;
74
+
75
+ const circuit = new CompactionCircuit(CONVERSATION_ID);
76
+ const { onEvent, events } = collectEvents();
77
+
78
+ await circuit.recordOutcome(true, onEvent);
79
+ await circuit.recordOutcome(true, onEvent);
80
+ // Two failures — circuit still closed.
81
+ expect(circuit.compactionCircuitOpenUntil).toBeNull();
82
+ expect(events).toHaveLength(0);
83
+
84
+ await circuit.recordOutcome(true, onEvent);
85
+ // Third failure — circuit trips and fires the event exactly once.
86
+ expect(circuit.consecutiveCompactionFailures).toBe(3);
87
+ expect(circuit.compactionCircuitOpenUntil).toBe(fixedNow + 60 * 60 * 1000);
88
+ expect(await circuit.isOpen()).toBe(true);
89
+ expect(events).toHaveLength(1);
90
+ expect(events[0]).toEqual({
91
+ type: "compaction_circuit_open",
92
+ conversationId: CONVERSATION_ID,
93
+ reason: "3_consecutive_failures",
94
+ openUntil: fixedNow + 60 * 60 * 1000,
95
+ });
96
+
97
+ // Further failures do not re-fire the event while the circuit is open.
98
+ await circuit.recordOutcome(true, onEvent);
99
+ expect(circuit.consecutiveCompactionFailures).toBe(4);
100
+ expect(events).toHaveLength(1);
101
+ });
102
+
103
+ test("(c) successful outcome resets counter and clears circuit", async () => {
104
+ const fixedNow = 1_700_000_000_000;
105
+ Date.now = () => fixedNow;
106
+
107
+ const circuit = new CompactionCircuit(CONVERSATION_ID);
108
+ const { onEvent } = collectEvents();
109
+
110
+ // Trip the breaker.
111
+ await circuit.recordOutcome(true, onEvent);
112
+ await circuit.recordOutcome(true, onEvent);
113
+ await circuit.recordOutcome(true, onEvent);
114
+ expect(circuit.compactionCircuitOpenUntil).not.toBeNull();
115
+
116
+ // Success resets state.
117
+ await circuit.recordOutcome(false, onEvent);
118
+ expect(circuit.consecutiveCompactionFailures).toBe(0);
119
+ expect(circuit.compactionCircuitOpenUntil).toBeNull();
120
+ });
121
+
122
+ test("(d) isOpen() reflects state and expiry", async () => {
123
+ const fixedNow = 1_700_000_000_000;
124
+ Date.now = () => fixedNow;
125
+
126
+ const circuit = new CompactionCircuit(CONVERSATION_ID);
127
+ const { onEvent } = collectEvents();
128
+
129
+ // Fresh state: closed.
130
+ expect(await circuit.isOpen()).toBe(false);
131
+
132
+ // Trip the breaker.
133
+ await circuit.recordOutcome(true, onEvent);
134
+ await circuit.recordOutcome(true, onEvent);
135
+ await circuit.recordOutcome(true, onEvent);
136
+
137
+ // While open.
138
+ expect(await circuit.isOpen()).toBe(true);
139
+
140
+ // After cooldown expires the breaker reports closed again, even without
141
+ // an explicit reset — the open-until timestamp is the only source of
142
+ // truth for the gate.
143
+ Date.now = () => fixedNow + 60 * 60 * 1000 + 1;
144
+ expect(await circuit.isOpen()).toBe(false);
145
+ });
146
+
147
+ test("(e) circuit re-opens after cooldown expiry when 3 more failures accumulate", async () => {
148
+ // Regression: opening the breaker a second time must not require
149
+ // `compactionCircuitOpenUntil === null`. Once a cooldown expires, the
150
+ // gate correctly reports "closed" but a stale past-timestamp stays on the
151
+ // state, so the next 3-strike window must still trip a new cooldown. Any
152
+ // expired timestamp is treated the same as null.
153
+ const t0 = 1_700_000_000_000;
154
+ Date.now = () => t0;
155
+
156
+ const circuit = new CompactionCircuit(CONVERSATION_ID);
157
+ const { onEvent, events } = collectEvents();
158
+
159
+ // Trip the breaker the first time.
160
+ await circuit.recordOutcome(true, onEvent);
161
+ await circuit.recordOutcome(true, onEvent);
162
+ await circuit.recordOutcome(true, onEvent);
163
+ expect(circuit.compactionCircuitOpenUntil).toBe(t0 + 60 * 60 * 1000);
164
+ expect(events).toHaveLength(1);
165
+
166
+ // Advance past the cooldown window. Reset the counter — in production this
167
+ // happens when a subsequent `maybeCompact` call succeeds after the
168
+ // cooldown elapses, but the bug manifests even when the counter is reset:
169
+ // the stale `compactionCircuitOpenUntil` is what breaks re-opening.
170
+ const t1 = t0 + 60 * 60 * 1000 + 1;
171
+ Date.now = () => t1;
172
+ expect(await circuit.isOpen()).toBe(false);
173
+ circuit.consecutiveCompactionFailures = 0;
174
+ // `compactionCircuitOpenUntil` is deliberately left as the old timestamp
175
+ // to reproduce the bug condition.
176
+ expect(circuit.compactionCircuitOpenUntil).toBe(t0 + 60 * 60 * 1000);
177
+
178
+ // Three more failures must trip a fresh cooldown even though the old
179
+ // timestamp is still set.
180
+ await circuit.recordOutcome(true, onEvent);
181
+ await circuit.recordOutcome(true, onEvent);
182
+ await circuit.recordOutcome(true, onEvent);
183
+ expect(circuit.consecutiveCompactionFailures).toBe(3);
184
+ expect(circuit.compactionCircuitOpenUntil).toBe(t1 + 60 * 60 * 1000);
185
+ expect(events).toHaveLength(2);
186
+ expect(events[1]).toEqual({
187
+ type: "compaction_circuit_open",
188
+ conversationId: CONVERSATION_ID,
189
+ reason: "3_consecutive_failures",
190
+ openUntil: t1 + 60 * 60 * 1000,
191
+ });
192
+ });
193
+
194
+ test("(f) isOpen() is query-only and never mutates the counter", async () => {
195
+ // `maybeCompact()` early-return paths skip `recordOutcome` entirely and
196
+ // only gate on `isOpen()`. The query must never touch the 3-strike
197
+ // counter so those early returns can't silently reset it.
198
+ const circuit = new CompactionCircuit(CONVERSATION_ID);
199
+ const { onEvent } = collectEvents();
200
+
201
+ await circuit.recordOutcome(true, onEvent);
202
+ await circuit.recordOutcome(true, onEvent);
203
+ expect(circuit.consecutiveCompactionFailures).toBe(2);
204
+
205
+ // Query-only — must NOT touch the counter.
206
+ expect(await circuit.isOpen()).toBe(false);
207
+ expect(circuit.consecutiveCompactionFailures).toBe(2);
208
+
209
+ // A third real failure then trips the breaker as expected.
210
+ await circuit.recordOutcome(true, onEvent);
211
+ expect(circuit.consecutiveCompactionFailures).toBe(3);
212
+ expect(circuit.compactionCircuitOpenUntil).not.toBeNull();
213
+ });
214
+
215
+ test("(g) open→closed transition emits compaction_circuit_closed exactly once", async () => {
216
+ // Regression: the reset branch must notify the client on open→closed.
217
+ // Otherwise the Swift banner set from `compaction_circuit_open` stays
218
+ // visible until the original `openUntil` deadline (up to 1h),
219
+ // misrepresenting the live state.
220
+ const fixedNow = 1_700_000_000_000;
221
+ Date.now = () => fixedNow;
222
+
223
+ const circuit = new CompactionCircuit(CONVERSATION_ID);
224
+ const { onEvent, events } = collectEvents();
225
+
226
+ // Force the circuit into the open state directly — the emitted-event
227
+ // transition logic is what we're testing, not the tripping path.
228
+ circuit.compactionCircuitOpenUntil = fixedNow + 60 * 60 * 1000;
229
+ circuit.consecutiveCompactionFailures = 3;
230
+
231
+ await circuit.recordOutcome(false, onEvent);
232
+
233
+ expect(circuit.consecutiveCompactionFailures).toBe(0);
234
+ expect(circuit.compactionCircuitOpenUntil).toBeNull();
235
+ expect(events).toHaveLength(1);
236
+ expect(events[0]).toEqual({
237
+ type: "compaction_circuit_closed",
238
+ conversationId: CONVERSATION_ID,
239
+ });
240
+ });
241
+
242
+ test("(h) successful outcome against an already-closed circuit emits no event", async () => {
243
+ // Emitting `compaction_circuit_closed` on every successful compaction
244
+ // would spam the client (the breaker is closed in the common case).
245
+ // Only the open→closed transition is meaningful.
246
+ const circuit = new CompactionCircuit(CONVERSATION_ID);
247
+ const { onEvent, events } = collectEvents();
248
+
249
+ expect(circuit.compactionCircuitOpenUntil).toBeNull();
250
+ await circuit.recordOutcome(false, onEvent);
251
+ expect(circuit.compactionCircuitOpenUntil).toBeNull();
252
+ expect(events).toHaveLength(0);
253
+
254
+ // A second successful outcome while still closed — still no event.
255
+ await circuit.recordOutcome(false, onEvent);
256
+ expect(events).toHaveLength(0);
257
+ });
258
+ });
@@ -0,0 +1,132 @@
1
+ /**
2
+ * Tests for the default compaction plugin (`defaultCompact`).
3
+ *
4
+ * The agent loop calls {@link defaultCompact} directly with a
5
+ * {@link CompactionContext} rather than routing through a middleware pipeline.
6
+ * These tests assert that the default implementation delegates to the
7
+ * supplied {@link ContextWindowManager} and forwards the request's
8
+ * conversational options verbatim. The orchestrator integration path
9
+ * (conversation-agent-loop) is exercised by
10
+ * `conversation-agent-loop-overflow.test.ts`.
11
+ */
12
+
13
+ import { describe, expect, test } from "bun:test";
14
+
15
+ import {
16
+ type CompactionContext,
17
+ defaultCompact,
18
+ } from "../plugins/defaults/compaction/compact.js";
19
+
20
+ type ContextWindowResultShape = {
21
+ compacted: boolean;
22
+ summaryText: string;
23
+ messages: unknown[];
24
+ previousEstimatedInputTokens: number;
25
+ estimatedInputTokens: number;
26
+ maxInputTokens: number;
27
+ thresholdTokens: number;
28
+ compactedMessages: number;
29
+ compactedPersistedMessages: number;
30
+ summaryCalls: number;
31
+ summaryInputTokens: number;
32
+ summaryOutputTokens: number;
33
+ summaryModel: string;
34
+ reason?: string;
35
+ };
36
+
37
+ function makeResult(
38
+ overrides: Partial<ContextWindowResultShape> = {},
39
+ ): ContextWindowResultShape {
40
+ return {
41
+ compacted: true,
42
+ summaryText: "default-summary",
43
+ messages: [],
44
+ previousEstimatedInputTokens: 1000,
45
+ estimatedInputTokens: 100,
46
+ maxInputTokens: 100000,
47
+ thresholdTokens: 80000,
48
+ compactedMessages: 3,
49
+ compactedPersistedMessages: 3,
50
+ summaryCalls: 1,
51
+ summaryInputTokens: 500,
52
+ summaryOutputTokens: 120,
53
+ summaryModel: "default-model",
54
+ ...overrides,
55
+ };
56
+ }
57
+
58
+ function makeManager(result: ContextWindowResultShape) {
59
+ const observed: {
60
+ messages: unknown;
61
+ signal: unknown;
62
+ options: unknown;
63
+ }[] = [];
64
+ const manager = {
65
+ maybeCompact: async (
66
+ messages: unknown,
67
+ signal: unknown,
68
+ options: unknown,
69
+ ) => {
70
+ observed.push({ messages, signal, options });
71
+ return result;
72
+ },
73
+ } as unknown as CompactionContext["manager"];
74
+ return { manager, observed };
75
+ }
76
+
77
+ describe("defaultCompact", () => {
78
+ test("delegates to the manager and returns its result unchanged", async () => {
79
+ // GIVEN a manager whose maybeCompact records its arguments
80
+ const expected = makeResult({
81
+ summaryText: "manager-summary",
82
+ compactedMessages: 7,
83
+ });
84
+ const { manager, observed } = makeManager(expected);
85
+ const messages = [{ role: "user", content: "hi" }] as never;
86
+ const signal = new AbortController().signal;
87
+
88
+ // WHEN defaultCompact runs with those messages and a signal
89
+ const result = (await defaultCompact({
90
+ manager,
91
+ messages,
92
+ signal,
93
+ })) as unknown as ContextWindowResultShape;
94
+
95
+ // THEN the manager saw the same messages and signal
96
+ expect(observed).toHaveLength(1);
97
+ expect(observed[0]!.messages).toBe(messages);
98
+ expect(observed[0]!.signal).toBe(signal);
99
+
100
+ // AND the returned result is the manager's object, unmodified
101
+ expect(result).toBe(expected);
102
+ expect(result.summaryText).toBe("manager-summary");
103
+ expect(result.compactedMessages).toBe(7);
104
+ });
105
+
106
+ test("forwards the request's compaction options to the manager", async () => {
107
+ // GIVEN a manager and a fully-populated compaction context
108
+ const { manager, observed } = makeManager(makeResult());
109
+
110
+ // WHEN defaultCompact runs with force/profile/trust options
111
+ await defaultCompact({
112
+ manager,
113
+ messages: [] as never,
114
+ force: true,
115
+ overrideProfile: "fast-profile",
116
+ precomputedEstimate: 1234,
117
+ minKeepRecentUserTurns: 0,
118
+ actorTrustClass: "guardian",
119
+ });
120
+
121
+ // THEN the manager received exactly those options, and the manager,
122
+ // messages, and signal are not leaked into the options bag
123
+ expect(observed).toHaveLength(1);
124
+ expect(observed[0]!.options).toEqual({
125
+ force: true,
126
+ overrideProfile: "fast-profile",
127
+ precomputedEstimate: 1234,
128
+ minKeepRecentUserTurns: 0,
129
+ actorTrustClass: "guardian",
130
+ });
131
+ });
132
+ });
@@ -190,8 +190,8 @@ let mockCompactResult: ContextWindowResult = {
190
190
  mock.module("../context/window-manager.js", () => ({
191
191
  ContextWindowManager: class {
192
192
  nonPersistedPrefixCount = 0;
193
- summaryIsInjected = false;
194
193
  constructor() {}
194
+ updateConfig() {}
195
195
  shouldCompact() {
196
196
  return { needed: false, estimatedTokens: 0 };
197
197
  }
@@ -228,10 +228,10 @@ mock.module("../agent/loop.js", () => ({
228
228
  getActiveModel() {
229
229
  return undefined;
230
230
  }
231
- async run(
232
- _messages: Message[],
233
- _onEvent: (event: AgentEvent) => void,
234
- ): Promise<Message[]> {
231
+ async run(_options: {
232
+ messages: Message[];
233
+ onEvent: (event: AgentEvent) => void;
234
+ }): Promise<Message[]> {
235
235
  return [];
236
236
  }
237
237
  },
@@ -170,6 +170,7 @@ mock.module("../memory/retriever.js", () => ({
170
170
  mock.module("../context/window-manager.js", () => ({
171
171
  ContextWindowManager: class {
172
172
  constructor() {}
173
+ updateConfig() {}
173
174
  shouldCompact() {
174
175
  return { needed: false, estimatedTokens: 0 };
175
176
  }
@@ -198,10 +199,11 @@ mock.module("../agent/loop.js", () => ({
198
199
  getActiveModel() {
199
200
  return undefined;
200
201
  }
201
- async run(
202
- messages: Message[],
203
- onEvent: (event: AgentEvent) => void,
204
- ): Promise<AgentLoopRunResult> {
202
+ async run(options: {
203
+ messages: Message[];
204
+ onEvent: (event: AgentEvent) => void;
205
+ }): Promise<AgentLoopRunResult> {
206
+ const { messages, onEvent } = options;
205
207
  // Prime the assistant row anchor — production code emits this from
206
208
  // `AgentLoop.run` just before `provider.sendMessage`.
207
209
  await onEvent({ type: "llm_call_started" });