macro-agent 0.0.10 → 0.0.12

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 (518) hide show
  1. package/.macro-agent/teams/self-driving/prompts/grinder.md +27 -0
  2. package/.macro-agent/teams/self-driving/prompts/judge.md +27 -0
  3. package/.macro-agent/teams/self-driving/prompts/planner.md +33 -0
  4. package/.macro-agent/teams/self-driving/roles/grinder.yaml +17 -0
  5. package/.macro-agent/teams/self-driving/roles/judge.yaml +24 -0
  6. package/.macro-agent/teams/self-driving/roles/planner.yaml +18 -0
  7. package/.macro-agent/teams/self-driving/team.yaml +103 -0
  8. package/.macro-agent/teams/structured/prompts/developer.md +26 -0
  9. package/.macro-agent/teams/structured/prompts/lead.md +25 -0
  10. package/.macro-agent/teams/structured/prompts/reviewer.md +24 -0
  11. package/.macro-agent/teams/structured/roles/developer.yaml +12 -0
  12. package/.macro-agent/teams/structured/roles/lead.yaml +11 -0
  13. package/.macro-agent/teams/structured/roles/reviewer.yaml +19 -0
  14. package/.macro-agent/teams/structured/team.yaml +89 -0
  15. package/.sudocode/issues.jsonl +56 -51
  16. package/.sudocode/specs.jsonl +8 -1
  17. package/CLAUDE.md +121 -30
  18. package/README.md +60 -3
  19. package/dist/acp/macro-agent.d.ts +4 -0
  20. package/dist/acp/macro-agent.d.ts.map +1 -1
  21. package/dist/acp/macro-agent.js +50 -4
  22. package/dist/acp/macro-agent.js.map +1 -1
  23. package/dist/acp/session-mapper.d.ts +20 -1
  24. package/dist/acp/session-mapper.d.ts.map +1 -1
  25. package/dist/acp/session-mapper.js +90 -1
  26. package/dist/acp/session-mapper.js.map +1 -1
  27. package/dist/acp/types.d.ts +24 -1
  28. package/dist/acp/types.d.ts.map +1 -1
  29. package/dist/acp/types.js.map +1 -1
  30. package/dist/agent/agent-manager.d.ts +40 -1
  31. package/dist/agent/agent-manager.d.ts.map +1 -1
  32. package/dist/agent/agent-manager.js +172 -8
  33. package/dist/agent/agent-manager.js.map +1 -1
  34. package/dist/agent/types.d.ts +22 -0
  35. package/dist/agent/types.d.ts.map +1 -1
  36. package/dist/agent/types.js.map +1 -1
  37. package/dist/agent/wake.d.ts +15 -0
  38. package/dist/agent/wake.d.ts.map +1 -1
  39. package/dist/agent/wake.js +15 -0
  40. package/dist/agent/wake.js.map +1 -1
  41. package/dist/agent-detection/command-builder.d.ts +30 -0
  42. package/dist/agent-detection/command-builder.d.ts.map +1 -0
  43. package/dist/agent-detection/command-builder.js +71 -0
  44. package/dist/agent-detection/command-builder.js.map +1 -0
  45. package/dist/agent-detection/detector.d.ts +84 -0
  46. package/dist/agent-detection/detector.d.ts.map +1 -0
  47. package/dist/agent-detection/detector.js +240 -0
  48. package/dist/agent-detection/detector.js.map +1 -0
  49. package/dist/agent-detection/index.d.ts +12 -0
  50. package/dist/agent-detection/index.d.ts.map +1 -0
  51. package/dist/agent-detection/index.js +14 -0
  52. package/dist/agent-detection/index.js.map +1 -0
  53. package/dist/agent-detection/registry.d.ts +53 -0
  54. package/dist/agent-detection/registry.d.ts.map +1 -0
  55. package/dist/agent-detection/registry.js +177 -0
  56. package/dist/agent-detection/registry.js.map +1 -0
  57. package/dist/agent-detection/types.d.ts +121 -0
  58. package/dist/agent-detection/types.d.ts.map +1 -0
  59. package/dist/agent-detection/types.js +20 -0
  60. package/dist/agent-detection/types.js.map +1 -0
  61. package/dist/api/server.d.ts +5 -1
  62. package/dist/api/server.d.ts.map +1 -1
  63. package/dist/api/server.js +362 -0
  64. package/dist/api/server.js.map +1 -1
  65. package/dist/api/types.d.ts +50 -1
  66. package/dist/api/types.d.ts.map +1 -1
  67. package/dist/cli/acp.d.ts +2 -0
  68. package/dist/cli/acp.d.ts.map +1 -1
  69. package/dist/cli/acp.js +8 -1
  70. package/dist/cli/acp.js.map +1 -1
  71. package/dist/cli/index.js +29 -0
  72. package/dist/cli/index.js.map +1 -1
  73. package/dist/cli/mcp.js +38 -0
  74. package/dist/cli/mcp.js.map +1 -1
  75. package/dist/config/index.d.ts +2 -0
  76. package/dist/config/index.d.ts.map +1 -0
  77. package/dist/config/index.js +2 -0
  78. package/dist/config/index.js.map +1 -0
  79. package/dist/config/project-config.d.ts +46 -0
  80. package/dist/config/project-config.d.ts.map +1 -0
  81. package/dist/config/project-config.js +68 -0
  82. package/dist/config/project-config.js.map +1 -0
  83. package/dist/lifecycle/cascade.d.ts +1 -1
  84. package/dist/lifecycle/cascade.d.ts.map +1 -1
  85. package/dist/lifecycle/handlers/index.d.ts +4 -0
  86. package/dist/lifecycle/handlers/index.d.ts.map +1 -1
  87. package/dist/lifecycle/handlers/index.js +2 -0
  88. package/dist/lifecycle/handlers/index.js.map +1 -1
  89. package/dist/lifecycle/handlers/worker.d.ts +4 -0
  90. package/dist/lifecycle/handlers/worker.d.ts.map +1 -1
  91. package/dist/lifecycle/handlers/worker.js +35 -3
  92. package/dist/lifecycle/handlers/worker.js.map +1 -1
  93. package/dist/mail/conversation-map.d.ts +33 -0
  94. package/dist/mail/conversation-map.d.ts.map +1 -0
  95. package/dist/mail/conversation-map.js +61 -0
  96. package/dist/mail/conversation-map.js.map +1 -0
  97. package/dist/mail/index.d.ts +11 -0
  98. package/dist/mail/index.d.ts.map +1 -0
  99. package/dist/mail/index.js +11 -0
  100. package/dist/mail/index.js.map +1 -0
  101. package/dist/mail/mail-service.d.ts +85 -0
  102. package/dist/mail/mail-service.d.ts.map +1 -0
  103. package/dist/mail/mail-service.js +121 -0
  104. package/dist/mail/mail-service.js.map +1 -0
  105. package/dist/mail/stores/eventstore-conversation-store.d.ts +40 -0
  106. package/dist/mail/stores/eventstore-conversation-store.d.ts.map +1 -0
  107. package/dist/mail/stores/eventstore-conversation-store.js +131 -0
  108. package/dist/mail/stores/eventstore-conversation-store.js.map +1 -0
  109. package/dist/mail/stores/eventstore-participant-store.d.ts +43 -0
  110. package/dist/mail/stores/eventstore-participant-store.d.ts.map +1 -0
  111. package/dist/mail/stores/eventstore-participant-store.js +145 -0
  112. package/dist/mail/stores/eventstore-participant-store.js.map +1 -0
  113. package/dist/mail/stores/eventstore-thread-store.d.ts +46 -0
  114. package/dist/mail/stores/eventstore-thread-store.d.ts.map +1 -0
  115. package/dist/mail/stores/eventstore-thread-store.js +118 -0
  116. package/dist/mail/stores/eventstore-thread-store.js.map +1 -0
  117. package/dist/mail/stores/eventstore-turn-store.d.ts +47 -0
  118. package/dist/mail/stores/eventstore-turn-store.d.ts.map +1 -0
  119. package/dist/mail/stores/eventstore-turn-store.js +153 -0
  120. package/dist/mail/stores/eventstore-turn-store.js.map +1 -0
  121. package/dist/mail/stores/index.d.ts +12 -0
  122. package/dist/mail/stores/index.d.ts.map +1 -0
  123. package/dist/mail/stores/index.js +12 -0
  124. package/dist/mail/stores/index.js.map +1 -0
  125. package/dist/mail/stores/types.d.ts +146 -0
  126. package/dist/mail/stores/types.d.ts.map +1 -0
  127. package/dist/mail/stores/types.js +13 -0
  128. package/dist/mail/stores/types.js.map +1 -0
  129. package/dist/mail/turn-recorder.d.ts +30 -0
  130. package/dist/mail/turn-recorder.d.ts.map +1 -0
  131. package/dist/mail/turn-recorder.js +98 -0
  132. package/dist/mail/turn-recorder.js.map +1 -0
  133. package/dist/map/adapter/acp-over-map.d.ts.map +1 -1
  134. package/dist/map/adapter/acp-over-map.js +32 -2
  135. package/dist/map/adapter/acp-over-map.js.map +1 -1
  136. package/dist/map/adapter/event-translator.d.ts.map +1 -1
  137. package/dist/map/adapter/event-translator.js +4 -0
  138. package/dist/map/adapter/event-translator.js.map +1 -1
  139. package/dist/map/adapter/extensions/agent-detection.d.ts +49 -0
  140. package/dist/map/adapter/extensions/agent-detection.d.ts.map +1 -0
  141. package/dist/map/adapter/extensions/agent-detection.js +91 -0
  142. package/dist/map/adapter/extensions/agent-detection.js.map +1 -0
  143. package/dist/map/adapter/extensions/index.d.ts +10 -1
  144. package/dist/map/adapter/extensions/index.d.ts.map +1 -1
  145. package/dist/map/adapter/extensions/index.js +39 -0
  146. package/dist/map/adapter/extensions/index.js.map +1 -1
  147. package/dist/map/adapter/extensions/resume.d.ts +47 -0
  148. package/dist/map/adapter/extensions/resume.d.ts.map +1 -0
  149. package/dist/map/adapter/extensions/resume.js +59 -0
  150. package/dist/map/adapter/extensions/resume.js.map +1 -0
  151. package/dist/map/adapter/extensions/workspace-files.d.ts +42 -0
  152. package/dist/map/adapter/extensions/workspace-files.d.ts.map +1 -0
  153. package/dist/map/adapter/extensions/workspace-files.js +338 -0
  154. package/dist/map/adapter/extensions/workspace-files.js.map +1 -0
  155. package/dist/map/adapter/mail-handler-adapter.d.ts +27 -0
  156. package/dist/map/adapter/mail-handler-adapter.d.ts.map +1 -0
  157. package/dist/map/adapter/mail-handler-adapter.js +292 -0
  158. package/dist/map/adapter/mail-handler-adapter.js.map +1 -0
  159. package/dist/map/adapter/map-adapter.d.ts +34 -10
  160. package/dist/map/adapter/map-adapter.d.ts.map +1 -1
  161. package/dist/map/adapter/map-adapter.js +110 -14
  162. package/dist/map/adapter/map-adapter.js.map +1 -1
  163. package/dist/map/adapter/rpc-handler.d.ts +4 -1
  164. package/dist/map/adapter/rpc-handler.d.ts.map +1 -1
  165. package/dist/map/adapter/rpc-handler.js +6 -0
  166. package/dist/map/adapter/rpc-handler.js.map +1 -1
  167. package/dist/map/index.d.ts +1 -0
  168. package/dist/map/index.d.ts.map +1 -1
  169. package/dist/map/index.js +2 -0
  170. package/dist/map/index.js.map +1 -1
  171. package/dist/map/types.d.ts +3 -1
  172. package/dist/map/types.d.ts.map +1 -1
  173. package/dist/map/types.js.map +1 -1
  174. package/dist/mcp/mcp-server.d.ts +6 -0
  175. package/dist/mcp/mcp-server.d.ts.map +1 -1
  176. package/dist/mcp/mcp-server.js +45 -0
  177. package/dist/mcp/mcp-server.js.map +1 -1
  178. package/dist/mcp/tools/claim_task.d.ts +35 -0
  179. package/dist/mcp/tools/claim_task.d.ts.map +1 -0
  180. package/dist/mcp/tools/claim_task.js +58 -0
  181. package/dist/mcp/tools/claim_task.js.map +1 -0
  182. package/dist/mcp/tools/done.d.ts +15 -2
  183. package/dist/mcp/tools/done.d.ts.map +1 -1
  184. package/dist/mcp/tools/done.js +45 -10
  185. package/dist/mcp/tools/done.js.map +1 -1
  186. package/dist/mcp/tools/list_claimable_tasks.d.ts +38 -0
  187. package/dist/mcp/tools/list_claimable_tasks.d.ts.map +1 -0
  188. package/dist/mcp/tools/list_claimable_tasks.js +63 -0
  189. package/dist/mcp/tools/list_claimable_tasks.js.map +1 -0
  190. package/dist/mcp/tools/unclaim_task.d.ts +31 -0
  191. package/dist/mcp/tools/unclaim_task.d.ts.map +1 -0
  192. package/dist/mcp/tools/unclaim_task.js +47 -0
  193. package/dist/mcp/tools/unclaim_task.js.map +1 -0
  194. package/dist/metrics/index.d.ts +2 -0
  195. package/dist/metrics/index.d.ts.map +1 -0
  196. package/dist/metrics/index.js +2 -0
  197. package/dist/metrics/index.js.map +1 -0
  198. package/dist/metrics/metrics.d.ts +79 -0
  199. package/dist/metrics/metrics.d.ts.map +1 -0
  200. package/dist/metrics/metrics.js +166 -0
  201. package/dist/metrics/metrics.js.map +1 -0
  202. package/dist/roles/capabilities.d.ts +1 -0
  203. package/dist/roles/capabilities.d.ts.map +1 -1
  204. package/dist/roles/capabilities.js +3 -0
  205. package/dist/roles/capabilities.js.map +1 -1
  206. package/dist/roles/types.d.ts +1 -1
  207. package/dist/roles/types.d.ts.map +1 -1
  208. package/dist/router/channels.d.ts +2 -4
  209. package/dist/router/channels.d.ts.map +1 -1
  210. package/dist/router/channels.js.map +1 -1
  211. package/dist/router/message-router.d.ts +85 -9
  212. package/dist/router/message-router.d.ts.map +1 -1
  213. package/dist/router/message-router.js +203 -14
  214. package/dist/router/message-router.js.map +1 -1
  215. package/dist/router/role-resolver.d.ts +10 -1
  216. package/dist/router/role-resolver.d.ts.map +1 -1
  217. package/dist/router/role-resolver.js +15 -1
  218. package/dist/router/role-resolver.js.map +1 -1
  219. package/dist/router/types.d.ts +30 -1
  220. package/dist/router/types.d.ts.map +1 -1
  221. package/dist/router/types.js.map +1 -1
  222. package/dist/server/combined-server.d.ts +6 -0
  223. package/dist/server/combined-server.d.ts.map +1 -1
  224. package/dist/server/combined-server.js +24 -2
  225. package/dist/server/combined-server.js.map +1 -1
  226. package/dist/store/event-store.d.ts +14 -1
  227. package/dist/store/event-store.d.ts.map +1 -1
  228. package/dist/store/event-store.js +456 -4
  229. package/dist/store/event-store.js.map +1 -1
  230. package/dist/store/types/agents.d.ts +1 -1
  231. package/dist/store/types/agents.d.ts.map +1 -1
  232. package/dist/store/types/conversations.d.ts +91 -0
  233. package/dist/store/types/conversations.d.ts.map +1 -0
  234. package/dist/store/types/conversations.js +8 -0
  235. package/dist/store/types/conversations.js.map +1 -0
  236. package/dist/store/types/events.d.ts +1 -1
  237. package/dist/store/types/events.d.ts.map +1 -1
  238. package/dist/store/types/events.js.map +1 -1
  239. package/dist/store/types/index.d.ts +2 -0
  240. package/dist/store/types/index.d.ts.map +1 -1
  241. package/dist/store/types/index.js +2 -0
  242. package/dist/store/types/index.js.map +1 -1
  243. package/dist/store/types/sessions.d.ts +44 -0
  244. package/dist/store/types/sessions.d.ts.map +1 -0
  245. package/dist/store/types/sessions.js +9 -0
  246. package/dist/store/types/sessions.js.map +1 -0
  247. package/dist/store/types/tasks.d.ts +2 -0
  248. package/dist/store/types/tasks.d.ts.map +1 -1
  249. package/dist/task/backend/memory.d.ts +4 -1
  250. package/dist/task/backend/memory.d.ts.map +1 -1
  251. package/dist/task/backend/memory.js +81 -0
  252. package/dist/task/backend/memory.js.map +1 -1
  253. package/dist/task/backend/types.d.ts +30 -0
  254. package/dist/task/backend/types.d.ts.map +1 -1
  255. package/dist/task/backend/types.js.map +1 -1
  256. package/dist/teams/index.d.ts +4 -0
  257. package/dist/teams/index.d.ts.map +1 -0
  258. package/dist/teams/index.js +4 -0
  259. package/dist/teams/index.js.map +1 -0
  260. package/dist/teams/team-loader.d.ts +20 -0
  261. package/dist/teams/team-loader.d.ts.map +1 -0
  262. package/dist/teams/team-loader.js +293 -0
  263. package/dist/teams/team-loader.js.map +1 -0
  264. package/dist/teams/team-runtime.d.ts +139 -0
  265. package/dist/teams/team-runtime.d.ts.map +1 -0
  266. package/dist/teams/team-runtime.js +613 -0
  267. package/dist/teams/team-runtime.js.map +1 -0
  268. package/dist/teams/types.d.ts +266 -0
  269. package/dist/teams/types.d.ts.map +1 -0
  270. package/dist/teams/types.js +20 -0
  271. package/dist/teams/types.js.map +1 -0
  272. package/dist/trigger/router/trigger-router.d.ts +30 -3
  273. package/dist/trigger/router/trigger-router.d.ts.map +1 -1
  274. package/dist/trigger/router/trigger-router.js +30 -3
  275. package/dist/trigger/router/trigger-router.js.map +1 -1
  276. package/dist/trigger/wake/types.d.ts +31 -5
  277. package/dist/trigger/wake/types.d.ts.map +1 -1
  278. package/dist/trigger/wake/types.js +19 -0
  279. package/dist/trigger/wake/types.js.map +1 -1
  280. package/dist/workspace/dataplane-adapter.d.ts +1 -1
  281. package/dist/workspace/dataplane-adapter.d.ts.map +1 -1
  282. package/dist/workspace/dataplane-adapter.js +1 -1
  283. package/dist/workspace/dataplane-adapter.js.map +1 -1
  284. package/dist/workspace/index.d.ts +1 -1
  285. package/dist/workspace/index.d.ts.map +1 -1
  286. package/dist/workspace/strategies/index.d.ts +6 -0
  287. package/dist/workspace/strategies/index.d.ts.map +1 -0
  288. package/dist/workspace/strategies/index.js +5 -0
  289. package/dist/workspace/strategies/index.js.map +1 -0
  290. package/dist/workspace/strategies/optimistic.d.ts +26 -0
  291. package/dist/workspace/strategies/optimistic.d.ts.map +1 -0
  292. package/dist/workspace/strategies/optimistic.js +121 -0
  293. package/dist/workspace/strategies/optimistic.js.map +1 -0
  294. package/dist/workspace/strategies/queue.d.ts +26 -0
  295. package/dist/workspace/strategies/queue.d.ts.map +1 -0
  296. package/dist/workspace/strategies/queue.js +67 -0
  297. package/dist/workspace/strategies/queue.js.map +1 -0
  298. package/dist/workspace/strategies/registry.d.ts +37 -0
  299. package/dist/workspace/strategies/registry.d.ts.map +1 -0
  300. package/dist/workspace/strategies/registry.js +63 -0
  301. package/dist/workspace/strategies/registry.js.map +1 -0
  302. package/dist/workspace/strategies/trunk.d.ts +20 -0
  303. package/dist/workspace/strategies/trunk.d.ts.map +1 -0
  304. package/dist/workspace/strategies/trunk.js +108 -0
  305. package/dist/workspace/strategies/trunk.js.map +1 -0
  306. package/dist/workspace/strategies/types.d.ts +104 -0
  307. package/dist/workspace/strategies/types.d.ts.map +1 -0
  308. package/dist/workspace/strategies/types.js +11 -0
  309. package/dist/workspace/strategies/types.js.map +1 -0
  310. package/dist/workspace/types.d.ts +1 -1
  311. package/dist/workspace/types.d.ts.map +1 -1
  312. package/dist/workspace/workspace-manager.d.ts +1 -1
  313. package/dist/workspace/workspace-manager.d.ts.map +1 -1
  314. package/docs/implementation-details.md +1127 -0
  315. package/docs/implementation-summary.md +448 -0
  316. package/docs/mail-integration.md +608 -0
  317. package/docs/plan-self-driving-support.md +433 -0
  318. package/docs/spec-self-driving-support.md +462 -0
  319. package/docs/team-templates.md +860 -0
  320. package/docs/teams.md +233 -0
  321. package/package.json +5 -3
  322. package/src/acp/__tests__/integration.test.ts +161 -1
  323. package/src/acp/__tests__/macro-agent.test.ts +95 -0
  324. package/src/acp/__tests__/session-persistence.test.ts +276 -0
  325. package/src/acp/macro-agent.ts +79 -7
  326. package/src/acp/session-mapper.ts +108 -1
  327. package/src/acp/types.ts +33 -1
  328. package/src/agent/agent-manager.ts +278 -6
  329. package/src/agent/types.ts +27 -0
  330. package/src/agent/wake.ts +15 -0
  331. package/src/agent-detection/__tests__/command-builder.test.ts +336 -0
  332. package/src/agent-detection/__tests__/detector.test.ts +768 -0
  333. package/src/agent-detection/__tests__/registry.test.ts +254 -0
  334. package/src/agent-detection/command-builder.ts +90 -0
  335. package/src/agent-detection/detector.ts +307 -0
  336. package/src/agent-detection/index.ts +36 -0
  337. package/src/agent-detection/registry.ts +200 -0
  338. package/src/agent-detection/types.ts +184 -0
  339. package/src/api/__tests__/conversation-api.test.ts +468 -0
  340. package/src/api/server.ts +425 -1
  341. package/src/api/types.ts +64 -1
  342. package/src/cli/acp.ts +9 -1
  343. package/src/cli/index.ts +44 -0
  344. package/src/cli/mcp.ts +47 -0
  345. package/src/config/index.ts +9 -0
  346. package/src/config/project-config.ts +107 -0
  347. package/src/lifecycle/cascade.ts +1 -1
  348. package/src/lifecycle/handlers/index.ts +8 -0
  349. package/src/lifecycle/handlers/worker.ts +48 -3
  350. package/src/mail/__tests__/conversation-lifecycle.test.ts +409 -0
  351. package/src/mail/__tests__/eventstore-stores.test.ts +1073 -0
  352. package/src/mail/__tests__/mail-full-agent.e2e.test.ts +575 -0
  353. package/src/mail/__tests__/mail-integration.test.ts +759 -0
  354. package/src/mail/__tests__/mail-map-protocol.e2e.test.ts +1068 -0
  355. package/src/mail/__tests__/mail-service.test.ts +506 -0
  356. package/src/mail/__tests__/turn-recorder.test.ts +328 -0
  357. package/src/mail/conversation-map.ts +107 -0
  358. package/src/mail/index.ts +25 -0
  359. package/src/mail/mail-service.ts +257 -0
  360. package/src/mail/stores/eventstore-conversation-store.ts +146 -0
  361. package/src/mail/stores/eventstore-participant-store.ts +172 -0
  362. package/src/mail/stores/eventstore-thread-store.ts +129 -0
  363. package/src/mail/stores/eventstore-turn-store.ts +173 -0
  364. package/src/mail/stores/index.ts +12 -0
  365. package/src/mail/stores/types.ts +160 -0
  366. package/src/mail/turn-recorder.ts +124 -0
  367. package/src/map/README.md +79 -0
  368. package/src/map/adapter/__tests__/extensions.test.ts +359 -0
  369. package/src/map/adapter/__tests__/map-adapter.test.ts +90 -0
  370. package/src/map/adapter/__tests__/workspace-files.test.ts +673 -0
  371. package/src/map/adapter/acp-over-map.ts +45 -2
  372. package/src/map/adapter/event-translator.ts +4 -0
  373. package/src/map/adapter/extensions/agent-detection.ts +201 -0
  374. package/src/map/adapter/extensions/index.ts +63 -0
  375. package/src/map/adapter/extensions/resume.ts +114 -0
  376. package/src/map/adapter/extensions/workspace-files.ts +449 -0
  377. package/src/map/adapter/mail-handler-adapter.ts +429 -0
  378. package/src/map/adapter/map-adapter.ts +173 -27
  379. package/src/map/adapter/rpc-handler.ts +8 -1
  380. package/src/map/index.ts +3 -0
  381. package/src/map/types.ts +3 -1
  382. package/src/mcp/mcp-server.ts +67 -0
  383. package/src/mcp/tools/claim_task.ts +86 -0
  384. package/src/mcp/tools/done.ts +59 -10
  385. package/src/mcp/tools/list_claimable_tasks.ts +93 -0
  386. package/src/mcp/tools/unclaim_task.ts +71 -0
  387. package/src/metrics/index.ts +9 -0
  388. package/src/metrics/metrics.ts +280 -0
  389. package/src/roles/capabilities.ts +3 -0
  390. package/src/roles/types.ts +2 -1
  391. package/src/router/README.md +120 -0
  392. package/src/router/__tests__/message-router.test.ts +561 -0
  393. package/src/router/channels.ts +3 -4
  394. package/src/router/message-router.ts +308 -22
  395. package/src/router/role-resolver.ts +22 -1
  396. package/src/router/types.ts +36 -1
  397. package/src/server/combined-server.ts +36 -2
  398. package/src/store/README.md +134 -0
  399. package/src/store/event-store.ts +546 -3
  400. package/src/store/types/agents.ts +1 -1
  401. package/src/store/types/conversations.ts +129 -0
  402. package/src/store/types/events.ts +5 -1
  403. package/src/store/types/index.ts +2 -0
  404. package/src/store/types/sessions.ts +53 -0
  405. package/src/store/types/tasks.ts +3 -0
  406. package/src/task/backend/memory.ts +116 -0
  407. package/src/task/backend/types.ts +43 -0
  408. package/src/teams/__tests__/cross-subsystem.integration.test.ts +983 -0
  409. package/src/teams/__tests__/e2e/team-runtime.e2e.test.ts +553 -0
  410. package/src/teams/__tests__/team-system.test.ts +1280 -0
  411. package/src/teams/index.ts +13 -0
  412. package/src/teams/team-loader.ts +434 -0
  413. package/src/teams/team-runtime.ts +727 -0
  414. package/src/teams/types.ts +377 -0
  415. package/src/trigger/router/trigger-router.ts +30 -3
  416. package/src/trigger/wake/types.ts +32 -5
  417. package/src/trigger/wake/wake-manager.ts +2 -2
  418. package/src/workspace/dataplane-adapter.ts +1 -1
  419. package/src/workspace/index.ts +1 -1
  420. package/src/workspace/strategies/index.ts +18 -0
  421. package/src/workspace/strategies/optimistic.ts +136 -0
  422. package/src/workspace/strategies/queue.ts +81 -0
  423. package/src/workspace/strategies/registry.ts +89 -0
  424. package/src/workspace/strategies/trunk.ts +123 -0
  425. package/src/workspace/strategies/types.ts +145 -0
  426. package/src/workspace/types.ts +1 -1
  427. package/src/workspace/workspace-manager.ts +1 -1
  428. package/.claude/settings.local.json +0 -59
  429. package/dist/map/utils/address-translation.d.ts +0 -99
  430. package/dist/map/utils/address-translation.d.ts.map +0 -1
  431. package/dist/map/utils/address-translation.js +0 -285
  432. package/dist/map/utils/address-translation.js.map +0 -1
  433. package/dist/map/utils/index.d.ts +0 -7
  434. package/dist/map/utils/index.d.ts.map +0 -1
  435. package/dist/map/utils/index.js +0 -7
  436. package/dist/map/utils/index.js.map +0 -1
  437. package/openspec/AGENTS.md +0 -456
  438. package/openspec/changes/archive/2025-12-21-add-mvp-foundation/design.md +0 -128
  439. package/openspec/changes/archive/2025-12-21-add-mvp-foundation/proposal.md +0 -49
  440. package/openspec/changes/archive/2025-12-21-add-mvp-foundation/specs/agent-manager/spec.md +0 -150
  441. package/openspec/changes/archive/2025-12-21-add-mvp-foundation/specs/cli-api/spec.md +0 -258
  442. package/openspec/changes/archive/2025-12-21-add-mvp-foundation/specs/event-store/spec.md +0 -160
  443. package/openspec/changes/archive/2025-12-21-add-mvp-foundation/specs/mcp-tools/spec.md +0 -224
  444. package/openspec/changes/archive/2025-12-21-add-mvp-foundation/specs/message-router/spec.md +0 -153
  445. package/openspec/changes/archive/2025-12-21-add-mvp-foundation/specs/task-manager/spec.md +0 -136
  446. package/openspec/changes/archive/2025-12-21-add-mvp-foundation/tasks.md +0 -147
  447. package/openspec/project.md +0 -31
  448. package/openspec/specs/agent-manager/spec.md +0 -154
  449. package/openspec/specs/cli-api/spec.md +0 -262
  450. package/openspec/specs/event-store/spec.md +0 -164
  451. package/openspec/specs/mcp-tools/spec.md +0 -228
  452. package/openspec/specs/message-router/spec.md +0 -157
  453. package/openspec/specs/task-manager/spec.md +0 -140
  454. package/references/acp-factory-ref/CHANGELOG.md +0 -33
  455. package/references/acp-factory-ref/LICENSE +0 -21
  456. package/references/acp-factory-ref/README.md +0 -341
  457. package/references/acp-factory-ref/package-lock.json +0 -3102
  458. package/references/acp-factory-ref/package.json +0 -96
  459. package/references/acp-factory-ref/python/CHANGELOG.md +0 -33
  460. package/references/acp-factory-ref/python/LICENSE +0 -21
  461. package/references/acp-factory-ref/python/Makefile +0 -57
  462. package/references/acp-factory-ref/python/README.md +0 -253
  463. package/references/acp-factory-ref/python/pyproject.toml +0 -73
  464. package/references/acp-factory-ref/python/tests/__init__.py +0 -0
  465. package/references/acp-factory-ref/python/tests/e2e/__init__.py +0 -1
  466. package/references/acp-factory-ref/python/tests/e2e/test_codex_e2e.py +0 -349
  467. package/references/acp-factory-ref/python/tests/e2e/test_gemini_e2e.py +0 -165
  468. package/references/acp-factory-ref/python/tests/e2e/test_opencode_e2e.py +0 -296
  469. package/references/acp-factory-ref/python/tests/test_client_handler.py +0 -543
  470. package/references/acp-factory-ref/python/tests/test_pushable.py +0 -199
  471. package/references/claude-code-acp/.github/workflows/ci.yml +0 -45
  472. package/references/claude-code-acp/.github/workflows/publish.yml +0 -34
  473. package/references/claude-code-acp/.prettierrc.json +0 -4
  474. package/references/claude-code-acp/CHANGELOG.md +0 -249
  475. package/references/claude-code-acp/LICENSE +0 -222
  476. package/references/claude-code-acp/README.md +0 -53
  477. package/references/claude-code-acp/docs/RELEASES.md +0 -24
  478. package/references/claude-code-acp/eslint.config.js +0 -48
  479. package/references/claude-code-acp/package-lock.json +0 -4570
  480. package/references/claude-code-acp/package.json +0 -88
  481. package/references/claude-code-acp/scripts/release.sh +0 -119
  482. package/references/claude-code-acp/src/acp-agent.ts +0 -2065
  483. package/references/claude-code-acp/src/index.ts +0 -26
  484. package/references/claude-code-acp/src/lib.ts +0 -38
  485. package/references/claude-code-acp/src/mcp-server.ts +0 -911
  486. package/references/claude-code-acp/src/settings.ts +0 -522
  487. package/references/claude-code-acp/src/tests/.claude/commands/quick-math.md +0 -5
  488. package/references/claude-code-acp/src/tests/.claude/commands/say-hello.md +0 -6
  489. package/references/claude-code-acp/src/tests/acp-agent-fork.test.ts +0 -479
  490. package/references/claude-code-acp/src/tests/acp-agent.test.ts +0 -1502
  491. package/references/claude-code-acp/src/tests/extract-lines.test.ts +0 -103
  492. package/references/claude-code-acp/src/tests/fork-session.test.ts +0 -335
  493. package/references/claude-code-acp/src/tests/replace-and-calculate-location.test.ts +0 -334
  494. package/references/claude-code-acp/src/tests/settings.test.ts +0 -617
  495. package/references/claude-code-acp/src/tests/skills-options.test.ts +0 -187
  496. package/references/claude-code-acp/src/tests/tools.test.ts +0 -318
  497. package/references/claude-code-acp/src/tests/typescript-declarations.test.ts +0 -558
  498. package/references/claude-code-acp/src/tools.ts +0 -819
  499. package/references/claude-code-acp/src/utils.ts +0 -171
  500. package/references/claude-code-acp/tsconfig.json +0 -18
  501. package/references/claude-code-acp/vitest.config.ts +0 -19
  502. package/references/multi-agent-protocol/.sudocode/issues.jsonl +0 -82
  503. package/references/multi-agent-protocol/.sudocode/specs.jsonl +0 -9
  504. package/references/multi-agent-protocol/LICENSE +0 -21
  505. package/references/multi-agent-protocol/README.md +0 -113
  506. package/references/multi-agent-protocol/docs/00-design-specification.md +0 -460
  507. package/references/multi-agent-protocol/docs/01-open-questions.md +0 -1050
  508. package/references/multi-agent-protocol/docs/02-wire-protocol.md +0 -296
  509. package/references/multi-agent-protocol/docs/03-streaming-semantics.md +0 -252
  510. package/references/multi-agent-protocol/docs/04-error-handling.md +0 -231
  511. package/references/multi-agent-protocol/docs/05-connection-model.md +0 -244
  512. package/references/multi-agent-protocol/docs/06-visibility-permissions.md +0 -243
  513. package/references/multi-agent-protocol/docs/07-federation.md +0 -259
  514. package/references/multi-agent-protocol/docs/08-macro-agent-migration.md +0 -253
  515. package/references/multi-agent-protocol/package-lock.json +0 -3239
  516. package/references/multi-agent-protocol/package.json +0 -56
  517. package/references/multi-agent-protocol/schema/meta.json +0 -337
  518. package/references/multi-agent-protocol/schema/schema.json +0 -1828
@@ -0,0 +1,1073 @@
1
+ /**
2
+ * Tests for EventStore mail materialized views and store adapters.
3
+ *
4
+ * Validates:
5
+ * - Conversation/turn/thread events are processed into materialized views
6
+ * - Store adapters correctly delegate to EventStore
7
+ * - Views survive rebuild from event replay
8
+ * - Listener notifications work
9
+ */
10
+
11
+ import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
12
+ import { createEventStore, type EventStore } from "../../store/event-store.js";
13
+ import {
14
+ EventStoreConversationStore,
15
+ EventStoreTurnStore,
16
+ EventStoreThreadStore,
17
+ EventStoreParticipantStore,
18
+ } from "../stores/index.js";
19
+
20
+ describe("EventStore Mail Views", () => {
21
+ let eventStore: EventStore;
22
+
23
+ beforeEach(async () => {
24
+ eventStore = await createEventStore({ inMemory: true });
25
+ });
26
+
27
+ afterEach(async () => {
28
+ await eventStore.close();
29
+ });
30
+
31
+ // ===========================================================================
32
+ // Direct EventStore view tests (emitting events, checking views)
33
+ // ===========================================================================
34
+
35
+ describe("Conversation Events", () => {
36
+ it("should create a conversation from a conversation event", () => {
37
+ eventStore.emit({
38
+ type: "conversation",
39
+ source: { agent_id: "user" },
40
+ payload: {
41
+ action: "created",
42
+ conversation_id: "conv-1",
43
+ conversation_type: "session",
44
+ subject: "Test conversation",
45
+ },
46
+ });
47
+
48
+ const conv = eventStore.getConversation("conv-1");
49
+ expect(conv).not.toBeNull();
50
+ expect(conv!.id).toBe("conv-1");
51
+ expect(conv!.type).toBe("session");
52
+ expect(conv!.status).toBe("active");
53
+ expect(conv!.subject).toBe("Test conversation");
54
+ expect(conv!.createdBy).toBe("user");
55
+ expect(conv!.participantCount).toBe(0);
56
+ });
57
+
58
+ it("should close a conversation", () => {
59
+ eventStore.emit({
60
+ type: "conversation",
61
+ source: { agent_id: "user" },
62
+ payload: {
63
+ action: "created",
64
+ conversation_id: "conv-1",
65
+ conversation_type: "session",
66
+ },
67
+ });
68
+
69
+ eventStore.emit({
70
+ type: "conversation",
71
+ source: { agent_id: "agent-1" },
72
+ payload: {
73
+ action: "closed",
74
+ conversation_id: "conv-1",
75
+ closed_by: "agent-1",
76
+ close_reason: "completed",
77
+ },
78
+ });
79
+
80
+ const conv = eventStore.getConversation("conv-1");
81
+ expect(conv!.status).toBe("completed");
82
+ expect(conv!.closedBy).toBe("agent-1");
83
+ expect(conv!.closedAt).toBeGreaterThan(0);
84
+ });
85
+
86
+ it("should track participants", () => {
87
+ eventStore.emit({
88
+ type: "conversation",
89
+ source: { agent_id: "user" },
90
+ payload: {
91
+ action: "created",
92
+ conversation_id: "conv-1",
93
+ conversation_type: "session",
94
+ },
95
+ });
96
+
97
+ eventStore.emit({
98
+ type: "conversation",
99
+ source: { agent_id: "user" },
100
+ payload: {
101
+ action: "participant_joined",
102
+ conversation_id: "conv-1",
103
+ participant_id: "user",
104
+ participant_type: "user",
105
+ participant_role: "initiator",
106
+ },
107
+ });
108
+
109
+ eventStore.emit({
110
+ type: "conversation",
111
+ source: { agent_id: "agent-1" },
112
+ payload: {
113
+ action: "participant_joined",
114
+ conversation_id: "conv-1",
115
+ participant_id: "agent-1",
116
+ participant_type: "agent",
117
+ participant_role: "worker",
118
+ agent_id: "agent-1",
119
+ },
120
+ });
121
+
122
+ const conv = eventStore.getConversation("conv-1");
123
+ expect(conv!.participantCount).toBe(2);
124
+
125
+ const participants = eventStore.listParticipants("conv-1");
126
+ expect(participants).toHaveLength(2);
127
+ expect(participants[0].id).toBe("user");
128
+ expect(participants[0].role).toBe("initiator");
129
+ expect(participants[1].id).toBe("agent-1");
130
+ expect(participants[1].role).toBe("worker");
131
+ expect(participants[1].agentId).toBe("agent-1");
132
+ });
133
+
134
+ it("should handle participant leaving", () => {
135
+ eventStore.emit({
136
+ type: "conversation",
137
+ source: { agent_id: "user" },
138
+ payload: {
139
+ action: "created",
140
+ conversation_id: "conv-1",
141
+ conversation_type: "session",
142
+ },
143
+ });
144
+
145
+ eventStore.emit({
146
+ type: "conversation",
147
+ source: { agent_id: "agent-1" },
148
+ payload: {
149
+ action: "participant_joined",
150
+ conversation_id: "conv-1",
151
+ participant_id: "agent-1",
152
+ participant_type: "agent",
153
+ participant_role: "worker",
154
+ },
155
+ });
156
+
157
+ eventStore.emit({
158
+ type: "conversation",
159
+ source: { agent_id: "agent-1" },
160
+ payload: {
161
+ action: "participant_left",
162
+ conversation_id: "conv-1",
163
+ participant_id: "agent-1",
164
+ },
165
+ });
166
+
167
+ const conv = eventStore.getConversation("conv-1");
168
+ expect(conv!.participantCount).toBe(0);
169
+
170
+ // Active-only filter should exclude left participants
171
+ const activeParticipants = eventStore.listParticipants("conv-1", true);
172
+ expect(activeParticipants).toHaveLength(0);
173
+
174
+ // All participants should still include left ones
175
+ const allParticipants = eventStore.listParticipants("conv-1");
176
+ expect(allParticipants).toHaveLength(1);
177
+ expect(allParticipants[0].leftAt).toBeGreaterThan(0);
178
+ });
179
+
180
+ it("should list conversations with filters", () => {
181
+ eventStore.emit({
182
+ type: "conversation",
183
+ source: { agent_id: "user" },
184
+ payload: {
185
+ action: "created",
186
+ conversation_id: "conv-session",
187
+ conversation_type: "session",
188
+ },
189
+ });
190
+
191
+ eventStore.emit({
192
+ type: "conversation",
193
+ source: { agent_id: "agent-1" },
194
+ payload: {
195
+ action: "created",
196
+ conversation_id: "conv-task",
197
+ conversation_type: "task",
198
+ parent_conversation_id: "conv-session",
199
+ },
200
+ });
201
+
202
+ // Filter by type
203
+ const sessions = eventStore.listConversations({ type: "session" });
204
+ expect(sessions).toHaveLength(1);
205
+ expect(sessions[0].id).toBe("conv-session");
206
+
207
+ const tasks = eventStore.listConversations({ type: "task" });
208
+ expect(tasks).toHaveLength(1);
209
+ expect(tasks[0].id).toBe("conv-task");
210
+
211
+ // Filter by parent
212
+ const children = eventStore.listConversations({
213
+ parentConversationId: "conv-session",
214
+ });
215
+ expect(children).toHaveLength(1);
216
+ expect(children[0].id).toBe("conv-task");
217
+
218
+ // All
219
+ const all = eventStore.listConversations();
220
+ expect(all).toHaveLength(2);
221
+ });
222
+
223
+ it("should set parent conversation ID", () => {
224
+ eventStore.emit({
225
+ type: "conversation",
226
+ source: { agent_id: "user" },
227
+ payload: {
228
+ action: "created",
229
+ conversation_id: "parent",
230
+ conversation_type: "session",
231
+ },
232
+ });
233
+
234
+ eventStore.emit({
235
+ type: "conversation",
236
+ source: { agent_id: "agent-1" },
237
+ payload: {
238
+ action: "created",
239
+ conversation_id: "child",
240
+ conversation_type: "task",
241
+ parent_conversation_id: "parent",
242
+ },
243
+ });
244
+
245
+ const child = eventStore.getConversation("child");
246
+ expect(child!.parentConversationId).toBe("parent");
247
+ });
248
+ });
249
+
250
+ describe("Turn Events", () => {
251
+ beforeEach(() => {
252
+ eventStore.emit({
253
+ type: "conversation",
254
+ source: { agent_id: "user" },
255
+ payload: {
256
+ action: "created",
257
+ conversation_id: "conv-1",
258
+ conversation_type: "session",
259
+ },
260
+ });
261
+ });
262
+
263
+ it("should record a turn from a turn event", () => {
264
+ eventStore.emit({
265
+ type: "turn",
266
+ source: { agent_id: "user" },
267
+ payload: {
268
+ action: "recorded",
269
+ turn_id: "turn-1",
270
+ conversation_id: "conv-1",
271
+ participant: "user",
272
+ content_type: "text",
273
+ content: { text: "Hello" },
274
+ source_type: "explicit",
275
+ },
276
+ });
277
+
278
+ const turns = eventStore.listTurns({ conversationId: "conv-1" });
279
+ expect(turns).toHaveLength(1);
280
+ expect(turns[0].id).toBe("turn-1");
281
+ expect(turns[0].conversationId).toBe("conv-1");
282
+ expect(turns[0].participant).toBe("user");
283
+ expect(turns[0].contentType).toBe("text");
284
+ expect(turns[0].content).toEqual({ text: "Hello" });
285
+ expect(turns[0].sourceType).toBe("explicit");
286
+ });
287
+
288
+ it("should record an intercepted turn with source message ID", () => {
289
+ eventStore.emit({
290
+ type: "turn",
291
+ source: { agent_id: "agent-1" },
292
+ payload: {
293
+ action: "recorded",
294
+ turn_id: "turn-1",
295
+ conversation_id: "conv-1",
296
+ participant: "agent-1",
297
+ content_type: "data",
298
+ content: { message: "delegated work" },
299
+ source_type: "intercepted",
300
+ source_message_id: "msg-123",
301
+ },
302
+ });
303
+
304
+ const turns = eventStore.listTurns({ conversationId: "conv-1" });
305
+ expect(turns[0].sourceType).toBe("intercepted");
306
+ expect(turns[0].sourceMessageId).toBe("msg-123");
307
+ });
308
+
309
+ it("should sort turns by timestamp", async () => {
310
+ eventStore.emit({
311
+ type: "turn",
312
+ source: { agent_id: "user" },
313
+ payload: {
314
+ action: "recorded",
315
+ turn_id: "turn-1",
316
+ conversation_id: "conv-1",
317
+ participant: "user",
318
+ content_type: "text",
319
+ content: { text: "First" },
320
+ source_type: "explicit",
321
+ },
322
+ });
323
+
324
+ await new Promise((r) => setTimeout(r, 10));
325
+
326
+ eventStore.emit({
327
+ type: "turn",
328
+ source: { agent_id: "agent-1" },
329
+ payload: {
330
+ action: "recorded",
331
+ turn_id: "turn-2",
332
+ conversation_id: "conv-1",
333
+ participant: "agent-1",
334
+ content_type: "text",
335
+ content: { text: "Second" },
336
+ source_type: "explicit",
337
+ },
338
+ });
339
+
340
+ const asc = eventStore.listTurns({
341
+ conversationId: "conv-1",
342
+ order: "asc",
343
+ });
344
+ expect(asc[0].id).toBe("turn-1");
345
+ expect(asc[1].id).toBe("turn-2");
346
+
347
+ const desc = eventStore.listTurns({
348
+ conversationId: "conv-1",
349
+ order: "desc",
350
+ });
351
+ expect(desc[0].id).toBe("turn-2");
352
+ expect(desc[1].id).toBe("turn-1");
353
+ });
354
+
355
+ it("should filter turns by content type", () => {
356
+ eventStore.emit({
357
+ type: "turn",
358
+ source: { agent_id: "user" },
359
+ payload: {
360
+ action: "recorded",
361
+ turn_id: "turn-text",
362
+ conversation_id: "conv-1",
363
+ participant: "user",
364
+ content_type: "text",
365
+ content: { text: "Hello" },
366
+ source_type: "explicit",
367
+ },
368
+ });
369
+
370
+ eventStore.emit({
371
+ type: "turn",
372
+ source: { agent_id: "agent-1" },
373
+ payload: {
374
+ action: "recorded",
375
+ turn_id: "turn-event",
376
+ conversation_id: "conv-1",
377
+ participant: "agent-1",
378
+ content_type: "event",
379
+ content: { event: "agent.started" },
380
+ source_type: "intercepted",
381
+ source_message_id: "msg-1",
382
+ },
383
+ });
384
+
385
+ const textOnly = eventStore.listTurns({
386
+ conversationId: "conv-1",
387
+ contentType: "text",
388
+ });
389
+ expect(textOnly).toHaveLength(1);
390
+ expect(textOnly[0].id).toBe("turn-text");
391
+ });
392
+
393
+ it("should limit turn results", () => {
394
+ for (let i = 0; i < 5; i++) {
395
+ eventStore.emit({
396
+ type: "turn",
397
+ source: { agent_id: "user" },
398
+ payload: {
399
+ action: "recorded",
400
+ turn_id: `turn-${i}`,
401
+ conversation_id: "conv-1",
402
+ participant: "user",
403
+ content_type: "text",
404
+ content: { text: `Message ${i}` },
405
+ source_type: "explicit",
406
+ },
407
+ });
408
+ }
409
+
410
+ const limited = eventStore.listTurns({
411
+ conversationId: "conv-1",
412
+ limit: 3,
413
+ });
414
+ expect(limited).toHaveLength(3);
415
+ });
416
+ });
417
+
418
+ describe("Thread Events", () => {
419
+ it("should create a thread from a thread event", () => {
420
+ eventStore.emit({
421
+ type: "conversation",
422
+ source: { agent_id: "user" },
423
+ payload: {
424
+ action: "created",
425
+ conversation_id: "conv-1",
426
+ conversation_type: "session",
427
+ },
428
+ });
429
+
430
+ eventStore.emit({
431
+ type: "thread",
432
+ source: { agent_id: "user" },
433
+ payload: {
434
+ action: "created",
435
+ thread_id: "thread-1",
436
+ conversation_id: "conv-1",
437
+ root_turn_id: "turn-1",
438
+ subject: "Sub-discussion",
439
+ },
440
+ });
441
+
442
+ // Verify via thread events query
443
+ const threadEvents = eventStore.query({ type: "thread" });
444
+ expect(threadEvents).toHaveLength(1);
445
+ expect(threadEvents[0].payload.thread_id).toBe("thread-1");
446
+ });
447
+ });
448
+
449
+ describe("Listeners", () => {
450
+ it("should notify on conversation changes", () => {
451
+ const callback = vi.fn();
452
+ const unsub = eventStore.onConversationChange(callback);
453
+
454
+ eventStore.emit({
455
+ type: "conversation",
456
+ source: { agent_id: "user" },
457
+ payload: {
458
+ action: "created",
459
+ conversation_id: "conv-1",
460
+ conversation_type: "session",
461
+ },
462
+ });
463
+
464
+ expect(callback).toHaveBeenCalledTimes(1);
465
+ expect(callback).toHaveBeenCalledWith(
466
+ "conv-1",
467
+ expect.objectContaining({ id: "conv-1", type: "session" })
468
+ );
469
+
470
+ unsub();
471
+
472
+ eventStore.emit({
473
+ type: "conversation",
474
+ source: { agent_id: "user" },
475
+ payload: {
476
+ action: "created",
477
+ conversation_id: "conv-2",
478
+ conversation_type: "task",
479
+ },
480
+ });
481
+
482
+ // Should not be called again after unsubscribe
483
+ expect(callback).toHaveBeenCalledTimes(1);
484
+ });
485
+
486
+ it("should notify on turn changes", () => {
487
+ const callback = vi.fn();
488
+ const unsub = eventStore.onTurnChange(callback);
489
+
490
+ eventStore.emit({
491
+ type: "conversation",
492
+ source: { agent_id: "user" },
493
+ payload: {
494
+ action: "created",
495
+ conversation_id: "conv-1",
496
+ conversation_type: "session",
497
+ },
498
+ });
499
+
500
+ eventStore.emit({
501
+ type: "turn",
502
+ source: { agent_id: "user" },
503
+ payload: {
504
+ action: "recorded",
505
+ turn_id: "turn-1",
506
+ conversation_id: "conv-1",
507
+ participant: "user",
508
+ content_type: "text",
509
+ content: { text: "Hello" },
510
+ source_type: "explicit",
511
+ },
512
+ });
513
+
514
+ expect(callback).toHaveBeenCalledTimes(1);
515
+ expect(callback).toHaveBeenCalledWith(
516
+ "conv-1",
517
+ expect.objectContaining({ id: "turn-1", conversationId: "conv-1" })
518
+ );
519
+
520
+ unsub();
521
+ });
522
+ });
523
+
524
+ describe("View Rebuild", () => {
525
+ it("should rebuild conversation views from event replay", async () => {
526
+ // Emit events
527
+ eventStore.emit({
528
+ type: "conversation",
529
+ source: { agent_id: "user" },
530
+ payload: {
531
+ action: "created",
532
+ conversation_id: "conv-1",
533
+ conversation_type: "session",
534
+ subject: "Test session",
535
+ },
536
+ });
537
+
538
+ eventStore.emit({
539
+ type: "conversation",
540
+ source: { agent_id: "agent-1" },
541
+ payload: {
542
+ action: "participant_joined",
543
+ conversation_id: "conv-1",
544
+ participant_id: "agent-1",
545
+ participant_type: "agent",
546
+ participant_role: "worker",
547
+ },
548
+ });
549
+
550
+ eventStore.emit({
551
+ type: "turn",
552
+ source: { agent_id: "user" },
553
+ payload: {
554
+ action: "recorded",
555
+ turn_id: "turn-1",
556
+ conversation_id: "conv-1",
557
+ participant: "user",
558
+ content_type: "text",
559
+ content: { text: "Hello" },
560
+ source_type: "explicit",
561
+ },
562
+ });
563
+
564
+ // Force a reload (rebuilds views from event log)
565
+ await eventStore.reload();
566
+
567
+ // Views should be rebuilt
568
+ const conv = eventStore.getConversation("conv-1");
569
+ expect(conv).not.toBeNull();
570
+ expect(conv!.subject).toBe("Test session");
571
+ expect(conv!.participantCount).toBe(1);
572
+
573
+ const turns = eventStore.listTurns({ conversationId: "conv-1" });
574
+ expect(turns).toHaveLength(1);
575
+ expect(turns[0].content).toEqual({ text: "Hello" });
576
+
577
+ const participants = eventStore.listParticipants("conv-1");
578
+ expect(participants).toHaveLength(1);
579
+ });
580
+ });
581
+
582
+ // ===========================================================================
583
+ // Store Adapter Tests
584
+ // ===========================================================================
585
+
586
+ describe("EventStoreConversationStore", () => {
587
+ let convStore: EventStoreConversationStore;
588
+
589
+ beforeEach(() => {
590
+ convStore = new EventStoreConversationStore(eventStore);
591
+ });
592
+
593
+ it("should save a new conversation", () => {
594
+ convStore.save({
595
+ id: "conv-1",
596
+ type: "session",
597
+ status: "active",
598
+ subject: "Test",
599
+ participantCount: 0,
600
+ createdAt: Date.now(),
601
+ updatedAt: Date.now(),
602
+ createdBy: "user",
603
+ metadata: {},
604
+ });
605
+
606
+ const result = convStore.get("conv-1");
607
+ expect(result).toBeDefined();
608
+ expect(result!.id).toBe("conv-1");
609
+ expect(result!.type).toBe("session");
610
+ expect(result!.status).toBe("active");
611
+ });
612
+
613
+ it("should list conversations with MAP filters", () => {
614
+ convStore.save({
615
+ id: "conv-1",
616
+ type: "session",
617
+ status: "active",
618
+ participantCount: 0,
619
+ createdAt: Date.now(),
620
+ updatedAt: Date.now(),
621
+ createdBy: "user",
622
+ metadata: {},
623
+ });
624
+
625
+ convStore.save({
626
+ id: "conv-2",
627
+ type: "task",
628
+ status: "active",
629
+ parentConversationId: "conv-1",
630
+ participantCount: 0,
631
+ createdAt: Date.now(),
632
+ updatedAt: Date.now(),
633
+ createdBy: "agent-1",
634
+ metadata: {},
635
+ });
636
+
637
+ const sessions = convStore.list({ type: ["session"] });
638
+ expect(sessions).toHaveLength(1);
639
+
640
+ const children = convStore.list({
641
+ parentConversationId: "conv-1",
642
+ });
643
+ expect(children).toHaveLength(1);
644
+ expect(children[0].id).toBe("conv-2");
645
+ });
646
+
647
+ it("should close a conversation via save with changed status", () => {
648
+ convStore.save({
649
+ id: "conv-1",
650
+ type: "session",
651
+ status: "active",
652
+ participantCount: 0,
653
+ createdAt: Date.now(),
654
+ updatedAt: Date.now(),
655
+ createdBy: "user",
656
+ metadata: {},
657
+ });
658
+
659
+ // Save again with completed status
660
+ convStore.save({
661
+ id: "conv-1",
662
+ type: "session",
663
+ status: "completed",
664
+ participantCount: 0,
665
+ createdAt: Date.now(),
666
+ updatedAt: Date.now(),
667
+ createdBy: "user",
668
+ metadata: {},
669
+ });
670
+
671
+ const result = convStore.get("conv-1");
672
+ expect(result!.status).toBe("completed");
673
+ expect(result!.closedAt).toBeGreaterThan(0);
674
+ });
675
+
676
+ it("should return undefined for non-existent conversation", () => {
677
+ expect(convStore.get("nonexistent")).toBeUndefined();
678
+ });
679
+ });
680
+
681
+ describe("EventStoreTurnStore", () => {
682
+ let turnStore: EventStoreTurnStore;
683
+
684
+ beforeEach(() => {
685
+ turnStore = new EventStoreTurnStore(eventStore);
686
+
687
+ // Create a conversation first
688
+ eventStore.emit({
689
+ type: "conversation",
690
+ source: { agent_id: "user" },
691
+ payload: {
692
+ action: "created",
693
+ conversation_id: "conv-1",
694
+ conversation_type: "session",
695
+ },
696
+ });
697
+ });
698
+
699
+ it("should append a turn", () => {
700
+ turnStore.append({
701
+ id: "turn-1",
702
+ conversationId: "conv-1",
703
+ participant: "user",
704
+ timestamp: Date.now(),
705
+ contentType: "text",
706
+ content: { text: "Hello" },
707
+ source: { type: "explicit", method: "mail/turn" },
708
+ metadata: {},
709
+ });
710
+
711
+ const turns = turnStore.list({ conversationId: "conv-1" });
712
+ expect(turns).toHaveLength(1);
713
+ expect(turns[0].id).toBe("turn-1");
714
+ expect(turns[0].content).toEqual({ text: "Hello" });
715
+ expect(turns[0].source.type).toBe("explicit");
716
+ });
717
+
718
+ it("should append an intercepted turn", () => {
719
+ turnStore.append({
720
+ id: "turn-1",
721
+ conversationId: "conv-1",
722
+ participant: "agent-1",
723
+ timestamp: Date.now(),
724
+ contentType: "data",
725
+ content: { message: "intercepted content" },
726
+ source: { type: "intercepted", messageId: "msg-123" },
727
+ metadata: {},
728
+ });
729
+
730
+ const turns = turnStore.list({ conversationId: "conv-1" });
731
+ expect(turns[0].source).toEqual({
732
+ type: "intercepted",
733
+ messageId: "msg-123",
734
+ });
735
+ });
736
+
737
+ it("should list turns with cursor pagination", async () => {
738
+ for (let i = 0; i < 5; i++) {
739
+ turnStore.append({
740
+ id: `turn-${i}`,
741
+ conversationId: "conv-1",
742
+ participant: "user",
743
+ timestamp: Date.now() + i,
744
+ contentType: "text",
745
+ content: { text: `Message ${i}` },
746
+ source: { type: "explicit", method: "mail/turn" },
747
+ metadata: {},
748
+ });
749
+ }
750
+
751
+ // After cursor
752
+ const afterTurn1 = turnStore.list({
753
+ conversationId: "conv-1",
754
+ afterTurnId: "turn-1",
755
+ });
756
+ expect(afterTurn1).toHaveLength(3);
757
+ expect(afterTurn1[0].id).toBe("turn-2");
758
+
759
+ // Before cursor
760
+ const beforeTurn3 = turnStore.list({
761
+ conversationId: "conv-1",
762
+ beforeTurnId: "turn-3",
763
+ });
764
+ expect(beforeTurn3).toHaveLength(3);
765
+ expect(beforeTurn3[2].id).toBe("turn-2");
766
+
767
+ // With limit
768
+ const limited = turnStore.list({
769
+ conversationId: "conv-1",
770
+ limit: 2,
771
+ });
772
+ expect(limited).toHaveLength(2);
773
+ });
774
+
775
+ it("should count turns", () => {
776
+ for (let i = 0; i < 3; i++) {
777
+ turnStore.append({
778
+ id: `turn-${i}`,
779
+ conversationId: "conv-1",
780
+ participant: "user",
781
+ timestamp: Date.now() + i,
782
+ contentType: "text",
783
+ content: { text: `Message ${i}` },
784
+ source: { type: "explicit", method: "mail/turn" },
785
+ metadata: {},
786
+ });
787
+ }
788
+
789
+ expect(turnStore.count("conv-1")).toBe(3);
790
+ expect(turnStore.count("nonexistent")).toBe(0);
791
+ });
792
+ });
793
+
794
+ describe("EventStoreThreadStore", () => {
795
+ let threadStore: EventStoreThreadStore;
796
+
797
+ beforeEach(() => {
798
+ threadStore = new EventStoreThreadStore(eventStore);
799
+
800
+ eventStore.emit({
801
+ type: "conversation",
802
+ source: { agent_id: "user" },
803
+ payload: {
804
+ action: "created",
805
+ conversation_id: "conv-1",
806
+ conversation_type: "session",
807
+ },
808
+ });
809
+ });
810
+
811
+ it("should save and list threads", () => {
812
+ threadStore.save({
813
+ id: "thread-1",
814
+ conversationId: "conv-1",
815
+ rootTurnId: "turn-1",
816
+ subject: "Sub-topic",
817
+ turnCount: 0,
818
+ participantCount: 0,
819
+ createdAt: Date.now(),
820
+ updatedAt: Date.now(),
821
+ createdBy: "user",
822
+ });
823
+
824
+ const threads = threadStore.list({ conversationId: "conv-1" });
825
+ expect(threads).toHaveLength(1);
826
+ expect(threads[0].id).toBe("thread-1");
827
+ expect(threads[0].subject).toBe("Sub-topic");
828
+ });
829
+
830
+ it("should get a thread by ID", () => {
831
+ threadStore.save({
832
+ id: "thread-1",
833
+ conversationId: "conv-1",
834
+ rootTurnId: "turn-1",
835
+ turnCount: 0,
836
+ participantCount: 0,
837
+ createdAt: Date.now(),
838
+ updatedAt: Date.now(),
839
+ createdBy: "user",
840
+ });
841
+
842
+ const thread = threadStore.get("thread-1");
843
+ expect(thread).toBeDefined();
844
+ expect(thread!.id).toBe("thread-1");
845
+ expect(thread!.conversationId).toBe("conv-1");
846
+ });
847
+
848
+ it("should return undefined for non-existent thread", () => {
849
+ expect(threadStore.get("nonexistent")).toBeUndefined();
850
+ });
851
+
852
+ it("should compute turnCount from actual turns with matching threadId", () => {
853
+ threadStore.save({
854
+ id: "thread-1",
855
+ conversationId: "conv-1",
856
+ rootTurnId: "turn-1",
857
+ turnCount: 0,
858
+ participantCount: 0,
859
+ createdAt: Date.now(),
860
+ updatedAt: Date.now(),
861
+ createdBy: "user",
862
+ });
863
+
864
+ // Record some turns with this threadId
865
+ for (let i = 0; i < 3; i++) {
866
+ eventStore.emit({
867
+ type: "turn",
868
+ source: { agent_id: "user" },
869
+ payload: {
870
+ action: "recorded",
871
+ turn_id: `turn-t1-${i}`,
872
+ conversation_id: "conv-1",
873
+ thread_id: "thread-1",
874
+ participant: "user",
875
+ content_type: "text",
876
+ content: `Thread msg ${i}`,
877
+ source_type: "explicit",
878
+ },
879
+ });
880
+ }
881
+
882
+ // Record a turn WITHOUT threadId (should not count)
883
+ eventStore.emit({
884
+ type: "turn",
885
+ source: { agent_id: "user" },
886
+ payload: {
887
+ action: "recorded",
888
+ turn_id: "turn-no-thread",
889
+ conversation_id: "conv-1",
890
+ participant: "user",
891
+ content_type: "text",
892
+ content: "No thread",
893
+ source_type: "explicit",
894
+ },
895
+ });
896
+
897
+ // get() should reflect actual turn count
898
+ const thread = threadStore.get("thread-1");
899
+ expect(thread).toBeDefined();
900
+ expect(thread!.turnCount).toBe(3);
901
+
902
+ // list() should also reflect actual turn count
903
+ const threads = threadStore.list({ conversationId: "conv-1" });
904
+ expect(threads).toHaveLength(1);
905
+ expect(threads[0].turnCount).toBe(3);
906
+ });
907
+ });
908
+
909
+ describe("EventStoreParticipantStore", () => {
910
+ let participantStore: EventStoreParticipantStore;
911
+
912
+ beforeEach(() => {
913
+ participantStore = new EventStoreParticipantStore(eventStore);
914
+
915
+ eventStore.emit({
916
+ type: "conversation",
917
+ source: { agent_id: "user" },
918
+ payload: {
919
+ action: "created",
920
+ conversation_id: "conv-1",
921
+ conversation_type: "session",
922
+ },
923
+ });
924
+ });
925
+
926
+ it("should save a participant", () => {
927
+ participantStore.save({
928
+ id: "user-1",
929
+ conversationId: "conv-1",
930
+ type: "user",
931
+ role: "initiator",
932
+ joinedAt: Date.now(),
933
+ permissions: {
934
+ canSend: true,
935
+ canObserve: true,
936
+ canInvite: false,
937
+ canRemove: false,
938
+ canCreateThreads: true,
939
+ historyAccess: "full",
940
+ canSeeInternal: false,
941
+ },
942
+ });
943
+
944
+ const result = participantStore.get("conv-1", "user-1");
945
+ expect(result).toBeDefined();
946
+ expect(result!.id).toBe("user-1");
947
+ expect(result!.role).toBe("initiator");
948
+ });
949
+
950
+ it("should list participants for a conversation", () => {
951
+ participantStore.save({
952
+ id: "user-1",
953
+ conversationId: "conv-1",
954
+ type: "user",
955
+ role: "initiator",
956
+ joinedAt: Date.now(),
957
+ permissions: {
958
+ canSend: true,
959
+ canObserve: true,
960
+ canInvite: false,
961
+ canRemove: false,
962
+ canCreateThreads: true,
963
+ historyAccess: "full",
964
+ canSeeInternal: false,
965
+ },
966
+ });
967
+
968
+ participantStore.save({
969
+ id: "agent-1",
970
+ conversationId: "conv-1",
971
+ type: "agent",
972
+ role: "worker",
973
+ joinedAt: Date.now(),
974
+ permissions: {
975
+ canSend: true,
976
+ canObserve: true,
977
+ canInvite: false,
978
+ canRemove: false,
979
+ canCreateThreads: true,
980
+ historyAccess: "full",
981
+ canSeeInternal: false,
982
+ },
983
+ agentInfo: { agentId: "agent-1" },
984
+ });
985
+
986
+ const participants = participantStore.list({
987
+ conversationId: "conv-1",
988
+ });
989
+ expect(participants).toHaveLength(2);
990
+ });
991
+
992
+ it("should remove a participant", () => {
993
+ participantStore.save({
994
+ id: "agent-1",
995
+ conversationId: "conv-1",
996
+ type: "agent",
997
+ role: "worker",
998
+ joinedAt: Date.now(),
999
+ permissions: {
1000
+ canSend: true,
1001
+ canObserve: true,
1002
+ canInvite: false,
1003
+ canRemove: false,
1004
+ canCreateThreads: true,
1005
+ historyAccess: "full",
1006
+ canSeeInternal: false,
1007
+ },
1008
+ });
1009
+
1010
+ const removed = participantStore.delete("conv-1", "agent-1");
1011
+ expect(removed).toBe(true);
1012
+
1013
+ // Active filter should exclude them
1014
+ const active = participantStore.list({
1015
+ conversationId: "conv-1",
1016
+ active: true,
1017
+ });
1018
+ expect(active).toHaveLength(0);
1019
+ });
1020
+
1021
+ it("should get conversations for a participant", () => {
1022
+ eventStore.emit({
1023
+ type: "conversation",
1024
+ source: { agent_id: "agent-1" },
1025
+ payload: {
1026
+ action: "created",
1027
+ conversation_id: "conv-2",
1028
+ conversation_type: "task",
1029
+ },
1030
+ });
1031
+
1032
+ participantStore.save({
1033
+ id: "agent-1",
1034
+ conversationId: "conv-1",
1035
+ type: "agent",
1036
+ role: "worker",
1037
+ joinedAt: Date.now(),
1038
+ permissions: {
1039
+ canSend: true,
1040
+ canObserve: true,
1041
+ canInvite: false,
1042
+ canRemove: false,
1043
+ canCreateThreads: true,
1044
+ historyAccess: "full",
1045
+ canSeeInternal: false,
1046
+ },
1047
+ });
1048
+
1049
+ participantStore.save({
1050
+ id: "agent-1",
1051
+ conversationId: "conv-2",
1052
+ type: "agent",
1053
+ role: "initiator",
1054
+ joinedAt: Date.now(),
1055
+ permissions: {
1056
+ canSend: true,
1057
+ canObserve: true,
1058
+ canInvite: false,
1059
+ canRemove: false,
1060
+ canCreateThreads: true,
1061
+ historyAccess: "full",
1062
+ canSeeInternal: false,
1063
+ },
1064
+ });
1065
+
1066
+ const convIds =
1067
+ participantStore.getConversationsForParticipant("agent-1");
1068
+ expect(convIds).toHaveLength(2);
1069
+ expect(convIds).toContain("conv-1");
1070
+ expect(convIds).toContain("conv-2");
1071
+ });
1072
+ });
1073
+ });