@namzu/sdk 0.1.8 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (626) hide show
  1. package/CHANGELOG.md +69 -2
  2. package/dist/agents/ReactiveAgent.d.ts.map +1 -1
  3. package/dist/agents/ReactiveAgent.js +5 -2
  4. package/dist/agents/ReactiveAgent.js.map +1 -1
  5. package/dist/agents/RouterAgent.d.ts.map +1 -1
  6. package/dist/agents/RouterAgent.js +3 -0
  7. package/dist/agents/RouterAgent.js.map +1 -1
  8. package/dist/agents/SupervisorAgent.d.ts.map +1 -1
  9. package/dist/agents/SupervisorAgent.js +21 -5
  10. package/dist/agents/SupervisorAgent.js.map +1 -1
  11. package/dist/bridge/a2a/index.d.ts +1 -1
  12. package/dist/bridge/a2a/index.d.ts.map +1 -1
  13. package/dist/bridge/a2a/index.js +1 -1
  14. package/dist/bridge/a2a/index.js.map +1 -1
  15. package/dist/bridge/a2a/mapper.d.ts.map +1 -1
  16. package/dist/bridge/a2a/mapper.js +6 -0
  17. package/dist/bridge/a2a/mapper.js.map +1 -1
  18. package/dist/bridge/a2a/message.d.ts +0 -2
  19. package/dist/bridge/a2a/message.d.ts.map +1 -1
  20. package/dist/bridge/a2a/message.js +0 -26
  21. package/dist/bridge/a2a/message.js.map +1 -1
  22. package/dist/bridge/a2a/task.d.ts +5 -4
  23. package/dist/bridge/a2a/task.d.ts.map +1 -1
  24. package/dist/bridge/a2a/task.js +4 -4
  25. package/dist/bridge/a2a/task.js.map +1 -1
  26. package/dist/bridge/sse/mapper.d.ts.map +1 -1
  27. package/dist/bridge/sse/mapper.js +6 -0
  28. package/dist/bridge/sse/mapper.js.map +1 -1
  29. package/dist/constants/a2a/index.d.ts +2 -2
  30. package/dist/constants/a2a/index.d.ts.map +1 -1
  31. package/dist/constants/a2a/index.js.map +1 -1
  32. package/dist/contracts/api.d.ts +14 -27
  33. package/dist/contracts/api.d.ts.map +1 -1
  34. package/dist/contracts/ids.d.ts +1 -1
  35. package/dist/contracts/ids.d.ts.map +1 -1
  36. package/dist/contracts/index.d.ts +3 -3
  37. package/dist/contracts/index.d.ts.map +1 -1
  38. package/dist/contracts/index.js +1 -1
  39. package/dist/contracts/index.js.map +1 -1
  40. package/dist/contracts/schemas.d.ts +1 -31
  41. package/dist/contracts/schemas.d.ts.map +1 -1
  42. package/dist/contracts/schemas.js +1 -7
  43. package/dist/contracts/schemas.js.map +1 -1
  44. package/dist/gateway/local.d.ts.map +1 -1
  45. package/dist/gateway/local.js +6 -0
  46. package/dist/gateway/local.js.map +1 -1
  47. package/dist/index.d.ts +6 -3
  48. package/dist/index.d.ts.map +1 -1
  49. package/dist/index.js +6 -3
  50. package/dist/index.js.map +1 -1
  51. package/dist/manager/agent/__tests__/lifecycle.test.d.ts +2 -0
  52. package/dist/manager/agent/__tests__/lifecycle.test.d.ts.map +1 -0
  53. package/dist/manager/agent/__tests__/lifecycle.test.js +316 -0
  54. package/dist/manager/agent/__tests__/lifecycle.test.js.map +1 -0
  55. package/dist/manager/agent/lifecycle.d.ts +67 -3
  56. package/dist/manager/agent/lifecycle.d.ts.map +1 -1
  57. package/dist/manager/agent/lifecycle.js +375 -14
  58. package/dist/manager/agent/lifecycle.js.map +1 -1
  59. package/dist/manager/index.d.ts +2 -0
  60. package/dist/manager/index.d.ts.map +1 -1
  61. package/dist/manager/index.js +1 -0
  62. package/dist/manager/index.js.map +1 -1
  63. package/dist/manager/run/persistence.d.ts +10 -1
  64. package/dist/manager/run/persistence.d.ts.map +1 -1
  65. package/dist/manager/run/persistence.js +20 -0
  66. package/dist/manager/run/persistence.js.map +1 -1
  67. package/dist/manager/thread/__tests__/lifecycle.test.d.ts +2 -0
  68. package/dist/manager/thread/__tests__/lifecycle.test.d.ts.map +1 -0
  69. package/dist/manager/thread/__tests__/lifecycle.test.js +216 -0
  70. package/dist/manager/thread/__tests__/lifecycle.test.js.map +1 -0
  71. package/dist/manager/thread/lifecycle.d.ts +105 -0
  72. package/dist/manager/thread/lifecycle.d.ts.map +1 -0
  73. package/dist/manager/thread/lifecycle.js +186 -0
  74. package/dist/manager/thread/lifecycle.js.map +1 -0
  75. package/dist/rag/retriever.js +2 -2
  76. package/dist/run/reporter.d.ts.map +1 -1
  77. package/dist/run/reporter.js +25 -0
  78. package/dist/run/reporter.js.map +1 -1
  79. package/dist/runtime/query/__tests__/context.test.d.ts +2 -0
  80. package/dist/runtime/query/__tests__/context.test.d.ts.map +1 -0
  81. package/dist/runtime/query/__tests__/context.test.js +85 -0
  82. package/dist/runtime/query/__tests__/context.test.js.map +1 -0
  83. package/dist/runtime/query/context-cache.d.ts +3 -3
  84. package/dist/runtime/query/context-cache.d.ts.map +1 -1
  85. package/dist/runtime/query/context-cache.js +2 -2
  86. package/dist/runtime/query/context-cache.js.map +1 -1
  87. package/dist/runtime/query/context.d.ts +45 -1
  88. package/dist/runtime/query/context.d.ts.map +1 -1
  89. package/dist/runtime/query/context.js +50 -8
  90. package/dist/runtime/query/context.js.map +1 -1
  91. package/dist/runtime/query/events.d.ts.map +1 -1
  92. package/dist/runtime/query/events.js +8 -0
  93. package/dist/runtime/query/events.js.map +1 -1
  94. package/dist/runtime/query/index.d.ts +22 -1
  95. package/dist/runtime/query/index.d.ts.map +1 -1
  96. package/dist/runtime/query/index.js +11 -0
  97. package/dist/runtime/query/index.js.map +1 -1
  98. package/dist/session/__tests__/integration/_fixtures.d.ts +122 -0
  99. package/dist/session/__tests__/integration/_fixtures.d.ts.map +1 -0
  100. package/dist/session/__tests__/integration/_fixtures.js +215 -0
  101. package/dist/session/__tests__/integration/_fixtures.js.map +1 -0
  102. package/dist/session/__tests__/integration/archive-gate.test.d.ts +15 -0
  103. package/dist/session/__tests__/integration/archive-gate.test.d.ts.map +1 -0
  104. package/dist/session/__tests__/integration/archive-gate.test.js +214 -0
  105. package/dist/session/__tests__/integration/archive-gate.test.js.map +1 -0
  106. package/dist/session/__tests__/integration/capacity-caps.test.d.ts +13 -0
  107. package/dist/session/__tests__/integration/capacity-caps.test.d.ts.map +1 -0
  108. package/dist/session/__tests__/integration/capacity-caps.test.js +123 -0
  109. package/dist/session/__tests__/integration/capacity-caps.test.js.map +1 -0
  110. package/dist/session/__tests__/integration/e2e-spawn.test.d.ts +18 -0
  111. package/dist/session/__tests__/integration/e2e-spawn.test.d.ts.map +1 -0
  112. package/dist/session/__tests__/integration/e2e-spawn.test.js +238 -0
  113. package/dist/session/__tests__/integration/e2e-spawn.test.js.map +1 -0
  114. package/dist/session/__tests__/integration/event-stream-ordering.test.d.ts +15 -0
  115. package/dist/session/__tests__/integration/event-stream-ordering.test.d.ts.map +1 -0
  116. package/dist/session/__tests__/integration/event-stream-ordering.test.js +330 -0
  117. package/dist/session/__tests__/integration/event-stream-ordering.test.js.map +1 -0
  118. package/dist/session/__tests__/integration/handoff-broadcast-e2e.test.d.ts +12 -0
  119. package/dist/session/__tests__/integration/handoff-broadcast-e2e.test.d.ts.map +1 -0
  120. package/dist/session/__tests__/integration/handoff-broadcast-e2e.test.js +182 -0
  121. package/dist/session/__tests__/integration/handoff-broadcast-e2e.test.js.map +1 -0
  122. package/dist/session/__tests__/integration/handoff-illegal-transition.test.d.ts +18 -0
  123. package/dist/session/__tests__/integration/handoff-illegal-transition.test.d.ts.map +1 -0
  124. package/dist/session/__tests__/integration/handoff-illegal-transition.test.js +156 -0
  125. package/dist/session/__tests__/integration/handoff-illegal-transition.test.js.map +1 -0
  126. package/dist/session/__tests__/integration/handoff-single-e2e.test.d.ts +15 -0
  127. package/dist/session/__tests__/integration/handoff-single-e2e.test.d.ts.map +1 -0
  128. package/dist/session/__tests__/integration/handoff-single-e2e.test.js +179 -0
  129. package/dist/session/__tests__/integration/handoff-single-e2e.test.js.map +1 -0
  130. package/dist/session/__tests__/integration/hierarchy-lifecycle.test.d.ts +12 -0
  131. package/dist/session/__tests__/integration/hierarchy-lifecycle.test.d.ts.map +1 -0
  132. package/dist/session/__tests__/integration/hierarchy-lifecycle.test.js +158 -0
  133. package/dist/session/__tests__/integration/hierarchy-lifecycle.test.js.map +1 -0
  134. package/dist/session/__tests__/integration/migration-filesystem.test.d.ts +11 -0
  135. package/dist/session/__tests__/integration/migration-filesystem.test.d.ts.map +1 -0
  136. package/dist/session/__tests__/integration/migration-filesystem.test.js +140 -0
  137. package/dist/session/__tests__/integration/migration-filesystem.test.js.map +1 -0
  138. package/dist/session/__tests__/integration/migration-id-prefix.test.d.ts +13 -0
  139. package/dist/session/__tests__/integration/migration-id-prefix.test.d.ts.map +1 -0
  140. package/dist/session/__tests__/integration/migration-id-prefix.test.js +84 -0
  141. package/dist/session/__tests__/integration/migration-id-prefix.test.js.map +1 -0
  142. package/dist/session/__tests__/integration/prev-artifact-dag.test.d.ts +14 -0
  143. package/dist/session/__tests__/integration/prev-artifact-dag.test.d.ts.map +1 -0
  144. package/dist/session/__tests__/integration/prev-artifact-dag.test.js +242 -0
  145. package/dist/session/__tests__/integration/prev-artifact-dag.test.js.map +1 -0
  146. package/dist/session/__tests__/integration/retention-archive.test.d.ts +12 -0
  147. package/dist/session/__tests__/integration/retention-archive.test.d.ts.map +1 -0
  148. package/dist/session/__tests__/integration/retention-archive.test.js +187 -0
  149. package/dist/session/__tests__/integration/retention-archive.test.js.map +1 -0
  150. package/dist/session/__tests__/integration/spawn-rollback.test.d.ts +26 -0
  151. package/dist/session/__tests__/integration/spawn-rollback.test.d.ts.map +1 -0
  152. package/dist/session/__tests__/integration/spawn-rollback.test.js +236 -0
  153. package/dist/session/__tests__/integration/spawn-rollback.test.js.map +1 -0
  154. package/dist/session/__tests__/integration/summary-materialization-e2e.test.d.ts +18 -0
  155. package/dist/session/__tests__/integration/summary-materialization-e2e.test.d.ts.map +1 -0
  156. package/dist/session/__tests__/integration/summary-materialization-e2e.test.js +201 -0
  157. package/dist/session/__tests__/integration/summary-materialization-e2e.test.js.map +1 -0
  158. package/dist/session/__tests__/integration/tenant-isolation.test.d.ts +14 -0
  159. package/dist/session/__tests__/integration/tenant-isolation.test.d.ts.map +1 -0
  160. package/dist/session/__tests__/integration/tenant-isolation.test.js +189 -0
  161. package/dist/session/__tests__/integration/tenant-isolation.test.js.map +1 -0
  162. package/dist/session/errors.d.ts +139 -0
  163. package/dist/session/errors.d.ts.map +1 -0
  164. package/dist/session/errors.js +107 -0
  165. package/dist/session/errors.js.map +1 -0
  166. package/dist/session/events/index.d.ts +4 -0
  167. package/dist/session/events/index.d.ts.map +1 -0
  168. package/dist/session/events/index.js +8 -0
  169. package/dist/session/events/index.js.map +1 -0
  170. package/dist/session/events/schema-version.d.ts +13 -0
  171. package/dist/session/events/schema-version.d.ts.map +1 -0
  172. package/dist/session/events/schema-version.js +12 -0
  173. package/dist/session/events/schema-version.js.map +1 -0
  174. package/dist/session/events/types.d.ts +64 -0
  175. package/dist/session/events/types.d.ts.map +1 -0
  176. package/dist/session/events/types.js +2 -0
  177. package/dist/session/events/types.js.map +1 -0
  178. package/dist/session/handoff/__tests__/broadcast.test.d.ts +2 -0
  179. package/dist/session/handoff/__tests__/broadcast.test.d.ts.map +1 -0
  180. package/dist/session/handoff/__tests__/broadcast.test.js +261 -0
  181. package/dist/session/handoff/__tests__/broadcast.test.js.map +1 -0
  182. package/dist/session/handoff/__tests__/capacity.test.d.ts +2 -0
  183. package/dist/session/handoff/__tests__/capacity.test.d.ts.map +1 -0
  184. package/dist/session/handoff/__tests__/capacity.test.js +103 -0
  185. package/dist/session/handoff/__tests__/capacity.test.js.map +1 -0
  186. package/dist/session/handoff/__tests__/single.test.d.ts +2 -0
  187. package/dist/session/handoff/__tests__/single.test.d.ts.map +1 -0
  188. package/dist/session/handoff/__tests__/single.test.js +239 -0
  189. package/dist/session/handoff/__tests__/single.test.js.map +1 -0
  190. package/dist/session/handoff/assignment.d.ts +71 -0
  191. package/dist/session/handoff/assignment.d.ts.map +1 -0
  192. package/dist/session/handoff/assignment.js +11 -0
  193. package/dist/session/handoff/assignment.js.map +1 -0
  194. package/dist/session/handoff/broadcast.d.ts +54 -0
  195. package/dist/session/handoff/broadcast.d.ts.map +1 -0
  196. package/dist/session/handoff/broadcast.js +311 -0
  197. package/dist/session/handoff/broadcast.js.map +1 -0
  198. package/dist/session/handoff/capacity.d.ts +66 -0
  199. package/dist/session/handoff/capacity.d.ts.map +1 -0
  200. package/dist/session/handoff/capacity.js +60 -0
  201. package/dist/session/handoff/capacity.js.map +1 -0
  202. package/dist/session/handoff/events.d.ts +66 -0
  203. package/dist/session/handoff/events.d.ts.map +1 -0
  204. package/dist/session/handoff/events.js +13 -0
  205. package/dist/session/handoff/events.js.map +1 -0
  206. package/dist/session/handoff/index.d.ts +12 -0
  207. package/dist/session/handoff/index.d.ts.map +1 -0
  208. package/dist/session/handoff/index.js +9 -0
  209. package/dist/session/handoff/index.js.map +1 -0
  210. package/dist/session/handoff/single.d.ts +69 -0
  211. package/dist/session/handoff/single.d.ts.map +1 -0
  212. package/dist/session/handoff/single.js +229 -0
  213. package/dist/session/handoff/single.js.map +1 -0
  214. package/dist/session/handoff/version.d.ts +52 -0
  215. package/dist/session/handoff/version.d.ts.map +1 -0
  216. package/dist/session/handoff/version.js +36 -0
  217. package/dist/session/handoff/version.js.map +1 -0
  218. package/dist/session/hierarchy/__tests__/session.test.d.ts +2 -0
  219. package/dist/session/hierarchy/__tests__/session.test.d.ts.map +1 -0
  220. package/dist/session/hierarchy/__tests__/session.test.js +69 -0
  221. package/dist/session/hierarchy/__tests__/session.test.js.map +1 -0
  222. package/dist/session/hierarchy/actor.d.ts +26 -0
  223. package/dist/session/hierarchy/actor.d.ts.map +1 -0
  224. package/dist/session/hierarchy/actor.js +2 -0
  225. package/dist/session/hierarchy/actor.js.map +1 -0
  226. package/dist/session/hierarchy/index.d.ts +9 -0
  227. package/dist/session/hierarchy/index.d.ts.map +1 -0
  228. package/dist/session/hierarchy/index.js +4 -0
  229. package/dist/session/hierarchy/index.js.map +1 -0
  230. package/dist/session/hierarchy/lineage.d.ts +15 -0
  231. package/dist/session/hierarchy/lineage.d.ts.map +1 -0
  232. package/dist/session/hierarchy/lineage.js +2 -0
  233. package/dist/session/hierarchy/lineage.js.map +1 -0
  234. package/dist/session/hierarchy/project.d.ts +40 -0
  235. package/dist/session/hierarchy/project.d.ts.map +1 -0
  236. package/dist/session/hierarchy/project.js +2 -0
  237. package/dist/session/hierarchy/project.js.map +1 -0
  238. package/dist/session/hierarchy/session.d.ts +71 -0
  239. package/dist/session/hierarchy/session.d.ts.map +1 -0
  240. package/dist/session/hierarchy/session.js +51 -0
  241. package/dist/session/hierarchy/session.js.map +1 -0
  242. package/dist/session/hierarchy/sub-session.d.ts +76 -0
  243. package/dist/session/hierarchy/sub-session.d.ts.map +1 -0
  244. package/dist/session/hierarchy/sub-session.js +2 -0
  245. package/dist/session/hierarchy/sub-session.js.map +1 -0
  246. package/dist/session/hierarchy/tenant.d.ts +13 -0
  247. package/dist/session/hierarchy/tenant.d.ts.map +1 -0
  248. package/dist/session/hierarchy/tenant.js +2 -0
  249. package/dist/session/hierarchy/tenant.js.map +1 -0
  250. package/dist/session/hierarchy/thread.d.ts +54 -0
  251. package/dist/session/hierarchy/thread.d.ts.map +1 -0
  252. package/dist/session/hierarchy/thread.js +2 -0
  253. package/dist/session/hierarchy/thread.js.map +1 -0
  254. package/dist/session/index.d.ts +10 -0
  255. package/dist/session/index.d.ts.map +1 -0
  256. package/dist/session/index.js +15 -0
  257. package/dist/session/index.js.map +1 -0
  258. package/dist/session/intervention/__tests__/prev-artifact.test.d.ts +2 -0
  259. package/dist/session/intervention/__tests__/prev-artifact.test.d.ts.map +1 -0
  260. package/dist/session/intervention/__tests__/prev-artifact.test.js +179 -0
  261. package/dist/session/intervention/__tests__/prev-artifact.test.js.map +1 -0
  262. package/dist/session/intervention/index.d.ts +3 -0
  263. package/dist/session/intervention/index.d.ts.map +1 -0
  264. package/dist/session/intervention/index.js +8 -0
  265. package/dist/session/intervention/index.js.map +1 -0
  266. package/dist/session/intervention/prev-artifact.d.ts +103 -0
  267. package/dist/session/intervention/prev-artifact.d.ts.map +1 -0
  268. package/dist/session/intervention/prev-artifact.js +112 -0
  269. package/dist/session/intervention/prev-artifact.js.map +1 -0
  270. package/dist/session/migration/__tests__/filesystem.test.d.ts +2 -0
  271. package/dist/session/migration/__tests__/filesystem.test.d.ts.map +1 -0
  272. package/dist/session/migration/__tests__/filesystem.test.js +188 -0
  273. package/dist/session/migration/__tests__/filesystem.test.js.map +1 -0
  274. package/dist/session/migration/__tests__/id-prefix.test.d.ts +2 -0
  275. package/dist/session/migration/__tests__/id-prefix.test.d.ts.map +1 -0
  276. package/dist/session/migration/__tests__/id-prefix.test.js +83 -0
  277. package/dist/session/migration/__tests__/id-prefix.test.js.map +1 -0
  278. package/dist/session/migration/__tests__/marker.test.d.ts +2 -0
  279. package/dist/session/migration/__tests__/marker.test.d.ts.map +1 -0
  280. package/dist/session/migration/__tests__/marker.test.js +75 -0
  281. package/dist/session/migration/__tests__/marker.test.js.map +1 -0
  282. package/dist/session/migration/errors.d.ts +26 -0
  283. package/dist/session/migration/errors.d.ts.map +1 -0
  284. package/dist/session/migration/errors.js +22 -0
  285. package/dist/session/migration/errors.js.map +1 -0
  286. package/dist/session/migration/filesystem.d.ts +94 -0
  287. package/dist/session/migration/filesystem.d.ts.map +1 -0
  288. package/dist/session/migration/filesystem.js +319 -0
  289. package/dist/session/migration/filesystem.js.map +1 -0
  290. package/dist/session/migration/id-prefix.d.ts +93 -0
  291. package/dist/session/migration/id-prefix.d.ts.map +1 -0
  292. package/dist/session/migration/id-prefix.js +111 -0
  293. package/dist/session/migration/id-prefix.js.map +1 -0
  294. package/dist/session/migration/index.d.ts +8 -0
  295. package/dist/session/migration/index.d.ts.map +1 -0
  296. package/dist/session/migration/index.js +8 -0
  297. package/dist/session/migration/index.js.map +1 -0
  298. package/dist/session/migration/marker.d.ts +57 -0
  299. package/dist/session/migration/marker.d.ts.map +1 -0
  300. package/dist/session/migration/marker.js +111 -0
  301. package/dist/session/migration/marker.js.map +1 -0
  302. package/dist/session/retention/__tests__/archive.test.d.ts +2 -0
  303. package/dist/session/retention/__tests__/archive.test.d.ts.map +1 -0
  304. package/dist/session/retention/__tests__/archive.test.js +253 -0
  305. package/dist/session/retention/__tests__/archive.test.js.map +1 -0
  306. package/dist/session/retention/__tests__/disk-backend.test.d.ts +2 -0
  307. package/dist/session/retention/__tests__/disk-backend.test.d.ts.map +1 -0
  308. package/dist/session/retention/__tests__/disk-backend.test.js +154 -0
  309. package/dist/session/retention/__tests__/disk-backend.test.js.map +1 -0
  310. package/dist/session/retention/archive-backend-ref.d.ts +18 -0
  311. package/dist/session/retention/archive-backend-ref.d.ts.map +1 -0
  312. package/dist/session/retention/archive-backend-ref.js +2 -0
  313. package/dist/session/retention/archive-backend-ref.js.map +1 -0
  314. package/dist/session/retention/archive.d.ts +130 -0
  315. package/dist/session/retention/archive.d.ts.map +1 -0
  316. package/dist/session/retention/archive.js +203 -0
  317. package/dist/session/retention/archive.js.map +1 -0
  318. package/dist/session/retention/backend.d.ts +101 -0
  319. package/dist/session/retention/backend.d.ts.map +1 -0
  320. package/dist/session/retention/backend.js +15 -0
  321. package/dist/session/retention/backend.js.map +1 -0
  322. package/dist/session/retention/disk-backend.d.ts +59 -0
  323. package/dist/session/retention/disk-backend.d.ts.map +1 -0
  324. package/dist/session/retention/disk-backend.js +236 -0
  325. package/dist/session/retention/disk-backend.js.map +1 -0
  326. package/dist/session/retention/index.d.ts +9 -0
  327. package/dist/session/retention/index.d.ts.map +1 -0
  328. package/dist/session/retention/index.js +6 -0
  329. package/dist/session/retention/index.js.map +1 -0
  330. package/dist/session/retention/policy.d.ts +49 -0
  331. package/dist/session/retention/policy.d.ts.map +1 -0
  332. package/dist/session/retention/policy.js +21 -0
  333. package/dist/session/retention/policy.js.map +1 -0
  334. package/dist/session/summary/__tests__/materialize.test.d.ts +2 -0
  335. package/dist/session/summary/__tests__/materialize.test.d.ts.map +1 -0
  336. package/dist/session/summary/__tests__/materialize.test.js +270 -0
  337. package/dist/session/summary/__tests__/materialize.test.js.map +1 -0
  338. package/dist/session/summary/deliverable.d.ts +74 -0
  339. package/dist/session/summary/deliverable.d.ts.map +1 -0
  340. package/dist/session/summary/deliverable.js +20 -0
  341. package/dist/session/summary/deliverable.js.map +1 -0
  342. package/dist/session/summary/index.d.ts +6 -0
  343. package/dist/session/summary/index.d.ts.map +1 -0
  344. package/dist/session/summary/index.js +9 -0
  345. package/dist/session/summary/index.js.map +1 -0
  346. package/dist/session/summary/materialize.d.ts +82 -0
  347. package/dist/session/summary/materialize.d.ts.map +1 -0
  348. package/dist/session/summary/materialize.js +117 -0
  349. package/dist/session/summary/materialize.js.map +1 -0
  350. package/dist/session/summary/ref.d.ts +91 -0
  351. package/dist/session/summary/ref.d.ts.map +1 -0
  352. package/dist/session/summary/ref.js +51 -0
  353. package/dist/session/summary/ref.js.map +1 -0
  354. package/dist/session/workspace/__tests__/git-worktree.test.d.ts +2 -0
  355. package/dist/session/workspace/__tests__/git-worktree.test.d.ts.map +1 -0
  356. package/dist/session/workspace/__tests__/git-worktree.test.js +244 -0
  357. package/dist/session/workspace/__tests__/git-worktree.test.js.map +1 -0
  358. package/dist/session/workspace/__tests__/path-builder.test.d.ts +2 -0
  359. package/dist/session/workspace/__tests__/path-builder.test.d.ts.map +1 -0
  360. package/dist/session/workspace/__tests__/path-builder.test.js +37 -0
  361. package/dist/session/workspace/__tests__/path-builder.test.js.map +1 -0
  362. package/dist/session/workspace/driver.d.ts +55 -0
  363. package/dist/session/workspace/driver.d.ts.map +1 -0
  364. package/dist/session/workspace/driver.js +12 -0
  365. package/dist/session/workspace/driver.js.map +1 -0
  366. package/dist/session/workspace/git-worktree.d.ts +65 -0
  367. package/dist/session/workspace/git-worktree.d.ts.map +1 -0
  368. package/dist/session/workspace/git-worktree.js +156 -0
  369. package/dist/session/workspace/git-worktree.js.map +1 -0
  370. package/dist/session/workspace/index.d.ts +8 -0
  371. package/dist/session/workspace/index.d.ts.map +1 -0
  372. package/dist/session/workspace/index.js +7 -0
  373. package/dist/session/workspace/index.js.map +1 -0
  374. package/dist/session/workspace/path-builder.d.ts +50 -0
  375. package/dist/session/workspace/path-builder.d.ts.map +1 -0
  376. package/dist/session/workspace/path-builder.js +50 -0
  377. package/dist/session/workspace/path-builder.js.map +1 -0
  378. package/dist/session/workspace/ref.d.ts +46 -0
  379. package/dist/session/workspace/ref.d.ts.map +1 -0
  380. package/dist/session/workspace/ref.js +11 -0
  381. package/dist/session/workspace/ref.js.map +1 -0
  382. package/dist/session/workspace/registry.d.ts +26 -0
  383. package/dist/session/workspace/registry.d.ts.map +1 -0
  384. package/dist/session/workspace/registry.js +35 -0
  385. package/dist/session/workspace/registry.js.map +1 -0
  386. package/dist/store/index.d.ts +0 -2
  387. package/dist/store/index.d.ts.map +1 -1
  388. package/dist/store/index.js +0 -1
  389. package/dist/store/index.js.map +1 -1
  390. package/dist/store/session/__tests__/disk.test.d.ts +2 -0
  391. package/dist/store/session/__tests__/disk.test.d.ts.map +1 -0
  392. package/dist/store/session/__tests__/disk.test.js +267 -0
  393. package/dist/store/session/__tests__/disk.test.js.map +1 -0
  394. package/dist/store/session/__tests__/memory.test.d.ts +2 -0
  395. package/dist/store/session/__tests__/memory.test.d.ts.map +1 -0
  396. package/dist/store/session/__tests__/memory.test.js +258 -0
  397. package/dist/store/session/__tests__/memory.test.js.map +1 -0
  398. package/dist/store/session/disk.d.ts +86 -0
  399. package/dist/store/session/disk.d.ts.map +1 -0
  400. package/dist/store/session/disk.js +818 -0
  401. package/dist/store/session/disk.js.map +1 -0
  402. package/dist/store/session/index.d.ts +7 -0
  403. package/dist/store/session/index.d.ts.map +1 -0
  404. package/dist/store/session/index.js +10 -0
  405. package/dist/store/session/index.js.map +1 -0
  406. package/dist/store/session/linkage.d.ts +38 -0
  407. package/dist/store/session/linkage.d.ts.map +1 -0
  408. package/dist/store/session/linkage.js +64 -0
  409. package/dist/store/session/linkage.js.map +1 -0
  410. package/dist/store/session/memory.d.ts +49 -0
  411. package/dist/store/session/memory.d.ts.map +1 -0
  412. package/dist/store/session/memory.js +335 -0
  413. package/dist/store/session/memory.js.map +1 -0
  414. package/dist/store/session/messages.d.ts +20 -0
  415. package/dist/store/session/messages.d.ts.map +1 -0
  416. package/dist/store/session/messages.js +12 -0
  417. package/dist/store/session/messages.js.map +1 -0
  418. package/dist/store/thread/disk.d.ts +41 -0
  419. package/dist/store/thread/disk.d.ts.map +1 -0
  420. package/dist/store/thread/disk.js +229 -0
  421. package/dist/store/thread/disk.js.map +1 -0
  422. package/dist/store/thread/index.d.ts +4 -0
  423. package/dist/store/thread/index.d.ts.map +1 -0
  424. package/dist/store/thread/index.js +6 -0
  425. package/dist/store/thread/index.js.map +1 -0
  426. package/dist/store/thread/memory.d.ts +23 -0
  427. package/dist/store/thread/memory.d.ts.map +1 -0
  428. package/dist/store/thread/memory.js +90 -0
  429. package/dist/store/thread/memory.js.map +1 -0
  430. package/dist/tools/builtins/__tests__/structuredOutput.example.d.ts +1 -1
  431. package/dist/types/agent/base.d.ts +24 -1
  432. package/dist/types/agent/base.d.ts.map +1 -1
  433. package/dist/types/agent/factory.d.ts +8 -2
  434. package/dist/types/agent/factory.d.ts.map +1 -1
  435. package/dist/types/agent/task.d.ts +57 -2
  436. package/dist/types/agent/task.d.ts.map +1 -1
  437. package/dist/types/agent/task.js.map +1 -1
  438. package/dist/types/ids/index.d.ts +22 -3
  439. package/dist/types/ids/index.d.ts.map +1 -1
  440. package/dist/types/ids/index.js +8 -1
  441. package/dist/types/ids/index.js.map +1 -1
  442. package/dist/types/invocation/__tests__/state.test.js +36 -29
  443. package/dist/types/invocation/__tests__/state.test.js.map +1 -1
  444. package/dist/types/invocation/index.d.ts +20 -4
  445. package/dist/types/invocation/index.d.ts.map +1 -1
  446. package/dist/types/invocation/index.js +10 -7
  447. package/dist/types/invocation/index.js.map +1 -1
  448. package/dist/types/rag/retrieval.d.ts +4 -3
  449. package/dist/types/rag/retrieval.d.ts.map +1 -1
  450. package/dist/types/run/config.d.ts +12 -1
  451. package/dist/types/run/config.d.ts.map +1 -1
  452. package/dist/types/run/events.d.ts +26 -1
  453. package/dist/types/run/events.d.ts.map +1 -1
  454. package/dist/types/run/index.d.ts.map +1 -1
  455. package/dist/types/run/index.js +8 -0
  456. package/dist/types/run/index.js.map +1 -1
  457. package/dist/types/run/metadata.d.ts +12 -2
  458. package/dist/types/run/metadata.d.ts.map +1 -1
  459. package/dist/types/run/status.d.ts +26 -0
  460. package/dist/types/run/status.d.ts.map +1 -0
  461. package/dist/types/run/status.js +2 -0
  462. package/dist/types/run/status.js.map +1 -0
  463. package/dist/types/session/ids.d.ts +9 -0
  464. package/dist/types/session/ids.d.ts.map +1 -0
  465. package/dist/types/session/ids.js +9 -0
  466. package/dist/types/session/ids.js.map +1 -0
  467. package/dist/types/session/index.d.ts +3 -0
  468. package/dist/types/session/index.d.ts.map +1 -0
  469. package/dist/types/session/index.js +5 -0
  470. package/dist/types/session/index.js.map +1 -0
  471. package/dist/types/session/store.d.ts +210 -0
  472. package/dist/types/session/store.d.ts.map +1 -0
  473. package/dist/types/session/store.js +9 -0
  474. package/dist/types/session/store.js.map +1 -0
  475. package/dist/types/thread/index.d.ts +2 -0
  476. package/dist/types/thread/index.d.ts.map +1 -0
  477. package/dist/types/thread/index.js +5 -0
  478. package/dist/types/thread/index.js.map +1 -0
  479. package/dist/types/thread/store.d.ts +86 -0
  480. package/dist/types/thread/store.d.ts.map +1 -0
  481. package/dist/types/thread/store.js +22 -0
  482. package/dist/types/thread/store.js.map +1 -0
  483. package/dist/utils/id.d.ts +8 -2
  484. package/dist/utils/id.d.ts.map +1 -1
  485. package/dist/utils/id.js +22 -4
  486. package/dist/utils/id.js.map +1 -1
  487. package/package.json +6 -11
  488. package/src/agents/ReactiveAgent.ts +7 -2
  489. package/src/agents/RouterAgent.ts +5 -0
  490. package/src/agents/SupervisorAgent.ts +29 -6
  491. package/src/bridge/a2a/index.ts +0 -1
  492. package/src/bridge/a2a/mapper.ts +7 -0
  493. package/src/bridge/a2a/message.ts +0 -32
  494. package/src/bridge/a2a/task.ts +9 -8
  495. package/src/bridge/sse/mapper.ts +8 -1
  496. package/src/constants/a2a/index.ts +2 -2
  497. package/src/contracts/api.ts +14 -30
  498. package/src/contracts/ids.ts +1 -1
  499. package/src/contracts/index.ts +3 -7
  500. package/src/contracts/schemas.ts +1 -8
  501. package/src/gateway/local.ts +6 -0
  502. package/src/index.ts +14 -4
  503. package/src/manager/agent/__tests__/lifecycle.test.ts +473 -0
  504. package/src/manager/agent/lifecycle.ts +515 -21
  505. package/src/manager/index.ts +3 -0
  506. package/src/manager/run/persistence.ts +26 -1
  507. package/src/manager/thread/__tests__/lifecycle.test.ts +286 -0
  508. package/src/manager/thread/lifecycle.ts +217 -0
  509. package/src/rag/retriever.ts +2 -2
  510. package/src/run/reporter.ts +28 -0
  511. package/src/runtime/query/__tests__/context.test.ts +102 -0
  512. package/src/runtime/query/context-cache.ts +4 -4
  513. package/src/runtime/query/context.ts +98 -9
  514. package/src/runtime/query/events.ts +8 -0
  515. package/src/runtime/query/index.ts +38 -1
  516. package/src/session/__tests__/integration/_fixtures.ts +310 -0
  517. package/src/session/__tests__/integration/archive-gate.test.ts +288 -0
  518. package/src/session/__tests__/integration/capacity-caps.test.ts +171 -0
  519. package/src/session/__tests__/integration/e2e-spawn.test.ts +296 -0
  520. package/src/session/__tests__/integration/event-stream-ordering.test.ts +410 -0
  521. package/src/session/__tests__/integration/handoff-broadcast-e2e.test.ts +271 -0
  522. package/src/session/__tests__/integration/handoff-illegal-transition.test.ts +214 -0
  523. package/src/session/__tests__/integration/handoff-single-e2e.test.ts +251 -0
  524. package/src/session/__tests__/integration/hierarchy-lifecycle.test.ts +240 -0
  525. package/src/session/__tests__/integration/migration-filesystem.test.ts +209 -0
  526. package/src/session/__tests__/integration/migration-id-prefix.test.ts +101 -0
  527. package/src/session/__tests__/integration/prev-artifact-dag.test.ts +325 -0
  528. package/src/session/__tests__/integration/retention-archive.test.ts +233 -0
  529. package/src/session/__tests__/integration/spawn-rollback.test.ts +313 -0
  530. package/src/session/__tests__/integration/summary-materialization-e2e.test.ts +239 -0
  531. package/src/session/__tests__/integration/tenant-isolation.test.ts +292 -0
  532. package/src/session/errors.ts +159 -0
  533. package/src/session/events/index.ts +16 -0
  534. package/src/session/events/schema-version.ts +13 -0
  535. package/src/session/events/types.ts +71 -0
  536. package/src/session/handoff/__tests__/broadcast.test.ts +378 -0
  537. package/src/session/handoff/__tests__/capacity.test.ts +129 -0
  538. package/src/session/handoff/__tests__/single.test.ts +333 -0
  539. package/src/session/handoff/assignment.ts +74 -0
  540. package/src/session/handoff/broadcast.ts +406 -0
  541. package/src/session/handoff/capacity.ts +121 -0
  542. package/src/session/handoff/events.ts +72 -0
  543. package/src/session/handoff/index.ts +29 -0
  544. package/src/session/handoff/single.ts +310 -0
  545. package/src/session/handoff/version.ts +59 -0
  546. package/src/session/hierarchy/__tests__/session.test.ts +100 -0
  547. package/src/session/hierarchy/actor.ts +17 -0
  548. package/src/session/hierarchy/index.ts +18 -0
  549. package/src/session/hierarchy/lineage.ts +15 -0
  550. package/src/session/hierarchy/project.ts +41 -0
  551. package/src/session/hierarchy/session.ts +109 -0
  552. package/src/session/hierarchy/sub-session.ts +92 -0
  553. package/src/session/hierarchy/tenant.ts +13 -0
  554. package/src/session/hierarchy/thread.ts +55 -0
  555. package/src/session/index.ts +15 -0
  556. package/src/session/intervention/__tests__/prev-artifact.test.ts +234 -0
  557. package/src/session/intervention/index.ts +16 -0
  558. package/src/session/intervention/prev-artifact.ts +180 -0
  559. package/src/session/migration/__tests__/filesystem.test.ts +263 -0
  560. package/src/session/migration/__tests__/id-prefix.test.ts +101 -0
  561. package/src/session/migration/__tests__/marker.test.ts +84 -0
  562. package/src/session/migration/errors.ts +23 -0
  563. package/src/session/migration/filesystem.ts +401 -0
  564. package/src/session/migration/id-prefix.ts +141 -0
  565. package/src/session/migration/index.ts +38 -0
  566. package/src/session/migration/marker.ts +131 -0
  567. package/src/session/retention/__tests__/archive.test.ts +318 -0
  568. package/src/session/retention/__tests__/disk-backend.test.ts +180 -0
  569. package/src/session/retention/archive-backend-ref.ts +17 -0
  570. package/src/session/retention/archive.ts +281 -0
  571. package/src/session/retention/backend.ts +107 -0
  572. package/src/session/retention/disk-backend.ts +304 -0
  573. package/src/session/retention/index.ts +16 -0
  574. package/src/session/retention/policy.ts +53 -0
  575. package/src/session/summary/__tests__/materialize.test.ts +343 -0
  576. package/src/session/summary/deliverable.ts +84 -0
  577. package/src/session/summary/index.ts +31 -0
  578. package/src/session/summary/materialize.ts +169 -0
  579. package/src/session/summary/ref.ts +104 -0
  580. package/src/session/workspace/__tests__/git-worktree.test.ts +258 -0
  581. package/src/session/workspace/__tests__/path-builder.test.ts +51 -0
  582. package/src/session/workspace/driver.ts +60 -0
  583. package/src/session/workspace/git-worktree.ts +209 -0
  584. package/src/session/workspace/index.ts +25 -0
  585. package/src/session/workspace/path-builder.ts +71 -0
  586. package/src/session/workspace/ref.ts +50 -0
  587. package/src/session/workspace/registry.ts +42 -0
  588. package/src/store/index.ts +0 -3
  589. package/src/store/session/__tests__/disk.test.ts +397 -0
  590. package/src/store/session/__tests__/memory.test.ts +402 -0
  591. package/src/store/session/disk.ts +976 -0
  592. package/src/store/session/index.ts +13 -0
  593. package/src/store/session/linkage.ts +80 -0
  594. package/src/store/session/memory.ts +412 -0
  595. package/src/store/session/messages.ts +21 -0
  596. package/src/store/thread/disk.ts +261 -0
  597. package/src/store/thread/index.ts +7 -0
  598. package/src/store/thread/memory.ts +104 -0
  599. package/src/types/agent/base.ts +27 -1
  600. package/src/types/agent/factory.ts +8 -3
  601. package/src/types/agent/task.ts +66 -2
  602. package/src/types/ids/index.ts +34 -3
  603. package/src/types/invocation/__tests__/state.test.ts +37 -29
  604. package/src/types/invocation/index.ts +26 -10
  605. package/src/types/rag/retrieval.ts +4 -3
  606. package/src/types/run/config.ts +13 -1
  607. package/src/types/run/events.ts +36 -1
  608. package/src/types/run/index.ts +8 -0
  609. package/src/types/run/metadata.ts +12 -2
  610. package/src/types/run/status.ts +33 -0
  611. package/src/types/session/ids.ts +23 -0
  612. package/src/types/session/index.ts +27 -0
  613. package/src/types/session/store.ts +252 -0
  614. package/src/types/thread/index.ts +5 -0
  615. package/src/types/thread/store.ts +92 -0
  616. package/src/utils/id.ts +34 -4
  617. package/dist/store/conversation/memory.d.ts +0 -21
  618. package/dist/store/conversation/memory.d.ts.map +0 -1
  619. package/dist/store/conversation/memory.js +0 -86
  620. package/dist/store/conversation/memory.js.map +0 -1
  621. package/dist/types/conversation/index.d.ts +0 -7
  622. package/dist/types/conversation/index.d.ts.map +0 -1
  623. package/dist/types/conversation/index.js +0 -2
  624. package/dist/types/conversation/index.js.map +0 -1
  625. package/src/store/conversation/memory.ts +0 -121
  626. package/src/types/conversation/index.ts +0 -8
@@ -0,0 +1,330 @@
1
+ /**
2
+ * Integration — event stream ordering + lineage + schemaVersion envelope.
3
+ *
4
+ * Covers roadmap §5 invariants:
5
+ * - §10.1 schemaVersion: 2 on every sub-session RunEvent
6
+ * - §10.3 tree-scoped monotonic ordering by (rootSessionId, eventId)
7
+ * - §10.3 depth filter ('self' vs 'tree') at subscribe time
8
+ * - §10.4 lineage stamped on every sub-session event with parent + root + depth
9
+ *
10
+ * Orthogonal to `e2e-spawn.test.ts` (covers single-level spawn). This file
11
+ * drives a multi-level (3-deep) delegation tree so monotonic ordering across
12
+ * concurrent descendants is observable.
13
+ */
14
+ import { describe, expect, it } from 'vitest';
15
+ import { EMPTY_TOKEN_USAGE } from '../../../constants/limits.js';
16
+ import { createAssistantMessage } from '../../../types/message/index.js';
17
+ import { ZERO_COST } from '../../../utils/cost.js';
18
+ import { DEFAULT_TENANT, buildAgent, buildAgentCustom, buildDefinition, buildHarness, buildSendMessageOptions, buildTaskContext, seedActiveParent, } from './_fixtures.js';
19
+ describe('Integration — event stream ordering + lineage + schemaVersion', () => {
20
+ it('every sub-session RunEvent carries schemaVersion: 2', async () => {
21
+ const harness = buildHarness();
22
+ const { project, thread, session, actor } = await seedActiveParent(harness);
23
+ harness.registry.register(buildDefinition(buildAgent('worker')));
24
+ const captured = [];
25
+ const task = await harness.manager.sendMessage(buildSendMessageOptions({
26
+ agentId: 'worker',
27
+ parentSessionId: session.id,
28
+ projectId: project.id,
29
+ tenantId: DEFAULT_TENANT,
30
+ parentActor: actor,
31
+ }), buildTaskContext({
32
+ sessionId: session.id,
33
+ projectId: project.id,
34
+ threadId: thread.id,
35
+ tenantId: DEFAULT_TENANT,
36
+ parentActor: actor,
37
+ }), (ev) => {
38
+ captured.push(ev);
39
+ });
40
+ await harness.manager.waitForCompletion(task.taskId);
41
+ // Every sub-session lifecycle event is stamped with schemaVersion: 2.
42
+ const subSessionEvents = captured.filter((e) => e.type === 'subsession_spawned' ||
43
+ e.type === 'subsession_messaged' ||
44
+ e.type === 'subsession_idled');
45
+ expect(subSessionEvents.length).toBeGreaterThan(0);
46
+ for (const ev of subSessionEvents) {
47
+ expect(ev.schemaVersion).toBe(2);
48
+ }
49
+ });
50
+ it('every sub-session event carries lineage { parentSessionId, rootSessionId, depth }', async () => {
51
+ const harness = buildHarness();
52
+ const { project, thread, session, actor } = await seedActiveParent(harness);
53
+ harness.registry.register(buildDefinition(buildAgent('worker')));
54
+ const captured = [];
55
+ const task = await harness.manager.sendMessage(buildSendMessageOptions({
56
+ agentId: 'worker',
57
+ parentSessionId: session.id,
58
+ projectId: project.id,
59
+ tenantId: DEFAULT_TENANT,
60
+ parentActor: actor,
61
+ }), buildTaskContext({
62
+ sessionId: session.id,
63
+ projectId: project.id,
64
+ threadId: thread.id,
65
+ tenantId: DEFAULT_TENANT,
66
+ parentActor: actor,
67
+ }), (ev) => {
68
+ captured.push(ev);
69
+ });
70
+ await harness.manager.waitForCompletion(task.taskId);
71
+ const spawned = captured.find((e) => e.type === 'subsession_spawned');
72
+ const idled = captured.find((e) => e.type === 'subsession_idled');
73
+ expect(spawned).toBeDefined();
74
+ expect(idled).toBeDefined();
75
+ if (spawned && 'lineage' in spawned) {
76
+ expect(spawned.lineage.parentSessionId).toBe(session.id);
77
+ expect(spawned.lineage.rootSessionId).toBe(session.id);
78
+ expect(spawned.lineage.depth).toBe(1);
79
+ }
80
+ if (idled && 'lineage' in idled) {
81
+ expect(idled.lineage.parentSessionId).toBe(session.id);
82
+ expect(idled.lineage.rootSessionId).toBe(session.id);
83
+ expect(idled.lineage.depth).toBe(1);
84
+ }
85
+ });
86
+ it('3-deep delegation: rootSessionId identical across tree; depth ascends 1→2→3', async () => {
87
+ const harness = buildHarness();
88
+ const { project, thread, session, actor } = await seedActiveParent(harness);
89
+ // Wire a cascading agent: level-1 child spawns level-2 via its own
90
+ // sendMessage. We hand a reference to the manager into the child agent
91
+ // via a closure so level-2 can spawn level-3.
92
+ const manager = harness.manager;
93
+ const nestedEventsCaptured = [];
94
+ const leafAgent = buildAgent('leaf', 'leaf result');
95
+ const midAgent = buildAgentCustom('mid', async (_input, config) => {
96
+ // Spawn a level-2 child from inside the mid-agent's run.
97
+ if (!config.sessionId || !config.threadId || !config.projectId || !config.tenantId) {
98
+ throw new Error('mid agent missing session scoping');
99
+ }
100
+ // Flip child session to active so it is a legal spawn parent.
101
+ const childSessionId = config.sessionId;
102
+ const cs = await harness.store.getSession(childSessionId, config.tenantId);
103
+ if (cs && cs.status !== 'active') {
104
+ await harness.store.updateSession({ ...cs, status: 'active' }, config.tenantId);
105
+ }
106
+ const task2 = await manager.sendMessage({
107
+ agentId: 'leaf',
108
+ input: { messages: [], workingDirectory: '/tmp' },
109
+ parentSessionId: childSessionId,
110
+ tenantId: config.tenantId,
111
+ projectId: config.projectId,
112
+ parentActor: { kind: 'agent', agentId: 'mid', tenantId: config.tenantId },
113
+ }, {
114
+ parentRunId: 'run_mid',
115
+ parentAgentId: 'mid',
116
+ parentAbortController: new AbortController(),
117
+ depth: 1,
118
+ budgetTracker: { total: 10_000, remaining: 10_000 },
119
+ tenantId: config.tenantId,
120
+ threadId: config.threadId,
121
+ sessionId: childSessionId,
122
+ projectId: config.projectId,
123
+ parentActor: { kind: 'agent', agentId: 'mid', tenantId: config.tenantId },
124
+ }, (ev) => {
125
+ nestedEventsCaptured.push(ev);
126
+ });
127
+ await manager.waitForCompletion(task2.taskId);
128
+ return {
129
+ runId: 'run_mid_result',
130
+ status: 'completed',
131
+ usage: { ...EMPTY_TOKEN_USAGE },
132
+ cost: { ...ZERO_COST },
133
+ iterations: 1,
134
+ durationMs: 1,
135
+ messages: [createAssistantMessage('mid done')],
136
+ result: 'mid done',
137
+ };
138
+ });
139
+ harness.registry.register(buildDefinition(leafAgent));
140
+ harness.registry.register(buildDefinition(midAgent));
141
+ const outerCaptured = [];
142
+ const task = await harness.manager.sendMessage(buildSendMessageOptions({
143
+ agentId: 'mid',
144
+ parentSessionId: session.id,
145
+ projectId: project.id,
146
+ tenantId: DEFAULT_TENANT,
147
+ parentActor: actor,
148
+ }), buildTaskContext({
149
+ sessionId: session.id,
150
+ projectId: project.id,
151
+ threadId: thread.id,
152
+ tenantId: DEFAULT_TENANT,
153
+ parentActor: actor,
154
+ }), (ev) => {
155
+ outerCaptured.push(ev);
156
+ });
157
+ await harness.manager.waitForCompletion(task.taskId);
158
+ // Outer capture has level-1 events with rootSessionId === session.id,
159
+ // depth 1. The nested capture has level-2 events with rootSessionId
160
+ // also === session.id (the whole tree shares a root) and depth 2.
161
+ const outerLineages = outerCaptured
162
+ .filter((e) => 'lineage' in e && e.lineage)
163
+ .map((e) => {
164
+ const l = e.lineage;
165
+ return { rootSessionId: l.rootSessionId, depth: l.depth };
166
+ });
167
+ expect(outerLineages.length).toBeGreaterThan(0);
168
+ for (const l of outerLineages) {
169
+ expect(l.rootSessionId).toBe(session.id);
170
+ expect(l.depth).toBe(1);
171
+ }
172
+ // Nested level-2 events: same rootSessionId, depth 2.
173
+ const nestedLineages = nestedEventsCaptured
174
+ .filter((e) => 'lineage' in e && e.lineage)
175
+ .map((e) => {
176
+ const l = e.lineage;
177
+ return { rootSessionId: l.rootSessionId, depth: l.depth };
178
+ });
179
+ expect(nestedLineages.length).toBeGreaterThan(0);
180
+ for (const l of nestedLineages) {
181
+ expect(l.rootSessionId).toBe(session.id);
182
+ expect(l.depth).toBe(2);
183
+ }
184
+ });
185
+ it('self vs tree depth filter: outer listener sees only its session events; nested listener sees its own tree', async () => {
186
+ // The subscribe-time depth filter is implemented at the listener
187
+ // injection seam — the parent passes a listener that captures events
188
+ // from its own sendMessage call. A nested child's sendMessage receives
189
+ // its own listener — the outer listener does NOT see the nested
190
+ // listener's events (no cross-contamination).
191
+ const harness = buildHarness();
192
+ const { project, thread, session, actor } = await seedActiveParent(harness);
193
+ const outerCaptured = [];
194
+ const nestedCaptured = [];
195
+ const leafAgent = buildAgent('leaf', 'leaf');
196
+ const midAgent = buildAgentCustom('mid', async (_input, config) => {
197
+ if (!config.sessionId || !config.threadId || !config.projectId || !config.tenantId) {
198
+ throw new Error('mid missing scope');
199
+ }
200
+ const cs = await harness.store.getSession(config.sessionId, config.tenantId);
201
+ if (cs && cs.status !== 'active') {
202
+ await harness.store.updateSession({ ...cs, status: 'active' }, config.tenantId);
203
+ }
204
+ const inner = await harness.manager.sendMessage({
205
+ agentId: 'leaf',
206
+ input: { messages: [], workingDirectory: '/tmp' },
207
+ parentSessionId: config.sessionId,
208
+ tenantId: config.tenantId,
209
+ projectId: config.projectId,
210
+ parentActor: {
211
+ kind: 'agent',
212
+ agentId: 'mid',
213
+ tenantId: config.tenantId,
214
+ },
215
+ }, {
216
+ parentRunId: 'run_mid_inner',
217
+ parentAgentId: 'mid',
218
+ parentAbortController: new AbortController(),
219
+ depth: 1,
220
+ budgetTracker: { total: 10_000, remaining: 10_000 },
221
+ tenantId: config.tenantId,
222
+ threadId: config.threadId,
223
+ sessionId: config.sessionId,
224
+ projectId: config.projectId,
225
+ parentActor: {
226
+ kind: 'agent',
227
+ agentId: 'mid',
228
+ tenantId: config.tenantId,
229
+ },
230
+ }, (ev) => {
231
+ nestedCaptured.push(ev);
232
+ });
233
+ await harness.manager.waitForCompletion(inner.taskId);
234
+ return {
235
+ runId: 'run_mid_done',
236
+ status: 'completed',
237
+ usage: { ...EMPTY_TOKEN_USAGE },
238
+ cost: { ...ZERO_COST },
239
+ iterations: 1,
240
+ durationMs: 1,
241
+ messages: [createAssistantMessage('mid')],
242
+ result: 'mid',
243
+ };
244
+ });
245
+ harness.registry.register(buildDefinition(leafAgent));
246
+ harness.registry.register(buildDefinition(midAgent));
247
+ const task = await harness.manager.sendMessage(buildSendMessageOptions({
248
+ agentId: 'mid',
249
+ parentSessionId: session.id,
250
+ projectId: project.id,
251
+ tenantId: DEFAULT_TENANT,
252
+ parentActor: actor,
253
+ }), buildTaskContext({
254
+ sessionId: session.id,
255
+ projectId: project.id,
256
+ threadId: thread.id,
257
+ tenantId: DEFAULT_TENANT,
258
+ parentActor: actor,
259
+ }), (ev) => {
260
+ outerCaptured.push(ev);
261
+ });
262
+ await harness.manager.waitForCompletion(task.taskId);
263
+ // Outer only sees its own spawn events (depth 1).
264
+ const outerSpawnedDepths = outerCaptured
265
+ .filter((e) => e.type === 'subsession_spawned')
266
+ .map((e) => ('lineage' in e && e.lineage ? e.lineage.depth : -1));
267
+ expect(outerSpawnedDepths).toEqual([1]);
268
+ // Nested listener only sees its own spawn events (depth 2).
269
+ const nestedSpawnedDepths = nestedCaptured
270
+ .filter((e) => e.type === 'subsession_spawned')
271
+ .map((e) => ('lineage' in e && e.lineage ? e.lineage.depth : -1));
272
+ expect(nestedSpawnedDepths).toEqual([2]);
273
+ // Cross-contamination sentinel: outer listener MUST NOT contain any
274
+ // depth-2 events (those belong to the nested scope).
275
+ const outerDepths = outerCaptured
276
+ .filter((e) => 'lineage' in e && e.lineage)
277
+ .map((e) => ('lineage' in e && e.lineage ? e.lineage.depth : -1));
278
+ expect(outerDepths.every((d) => d === 1)).toBe(true);
279
+ });
280
+ it('run_started and other core RunEvents also carry schemaVersion: 2 when stamped by the child listener wrapper', async () => {
281
+ // The listener wrapper in `manager/agent/lifecycle.ts#wrapChildListener`
282
+ // stamps `schemaVersion: 2` + `lineage` on EVERY event emitted inside
283
+ // the child's run. Core events that pass through the wrapped listener
284
+ // therefore inherit the envelope even though they have no lineage in
285
+ // their own type definition.
286
+ const harness = buildHarness();
287
+ const { project, thread, session, actor } = await seedActiveParent(harness);
288
+ const leafAgent = buildAgentCustom('leaf-emit', async (_i, _c, listener) => {
289
+ // Emit a core event inside the child's run via the listener passed in.
290
+ await listener?.({
291
+ type: 'run_started',
292
+ runId: 'run_child_inner',
293
+ });
294
+ return {
295
+ runId: 'run_child_inner',
296
+ status: 'completed',
297
+ usage: { ...EMPTY_TOKEN_USAGE },
298
+ cost: { ...ZERO_COST },
299
+ iterations: 1,
300
+ durationMs: 1,
301
+ messages: [createAssistantMessage('done')],
302
+ result: 'done',
303
+ };
304
+ });
305
+ harness.registry.register(buildDefinition(leafAgent));
306
+ const captured = [];
307
+ const task = await harness.manager.sendMessage(buildSendMessageOptions({
308
+ agentId: 'leaf-emit',
309
+ parentSessionId: session.id,
310
+ projectId: project.id,
311
+ tenantId: DEFAULT_TENANT,
312
+ parentActor: actor,
313
+ }), buildTaskContext({
314
+ sessionId: session.id,
315
+ projectId: project.id,
316
+ threadId: thread.id,
317
+ tenantId: DEFAULT_TENANT,
318
+ parentActor: actor,
319
+ }), (ev) => {
320
+ captured.push(ev);
321
+ });
322
+ await harness.manager.waitForCompletion(task.taskId);
323
+ const runStarted = captured.find((e) => e.type === 'run_started');
324
+ expect(runStarted).toBeDefined();
325
+ if (runStarted && 'schemaVersion' in runStarted) {
326
+ expect(runStarted.schemaVersion).toBe(2);
327
+ }
328
+ });
329
+ });
330
+ //# sourceMappingURL=event-stream-ordering.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"event-stream-ordering.test.js","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/event-stream-ordering.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Integration — broadcast handoff atomic fan-out + rollback wired through
3
+ * the real stack.
4
+ *
5
+ * Covers roadmap §5 invariants: §5.4 (source → `awaiting_merge` after
6
+ * successful commit), §6.2 (broadcast atomic rollback — zero orphan
7
+ * sub-sessions/sessions after rollback via `deleteSubSession` +
8
+ * `deleteSession`), §10.2 (broadcast.rollback event carries accurate
9
+ * partialState counts).
10
+ */
11
+ export {};
12
+ //# sourceMappingURL=handoff-broadcast-e2e.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handoff-broadcast-e2e.test.d.ts","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/handoff-broadcast-e2e.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}
@@ -0,0 +1,182 @@
1
+ /**
2
+ * Integration — broadcast handoff atomic fan-out + rollback wired through
3
+ * the real stack.
4
+ *
5
+ * Covers roadmap §5 invariants: §5.4 (source → `awaiting_merge` after
6
+ * successful commit), §6.2 (broadcast atomic rollback — zero orphan
7
+ * sub-sessions/sessions after rollback via `deleteSubSession` +
8
+ * `deleteSession`), §10.2 (broadcast.rollback event carries accurate
9
+ * partialState counts).
10
+ */
11
+ import { describe, expect, it, vi } from 'vitest';
12
+ import { ThreadManager } from '../../../manager/thread/lifecycle.js';
13
+ import { InMemorySessionStore } from '../../../store/session/memory.js';
14
+ import { InMemoryThreadStore } from '../../../store/thread/memory.js';
15
+ import { generateHandoffId } from '../../../utils/id.js';
16
+ import { executeBroadcastHandoff } from '../../handoff/broadcast.js';
17
+ import { DefaultCapacityValidator } from '../../handoff/capacity.js';
18
+ import { GitWorktreeDriver } from '../../workspace/git-worktree.js';
19
+ import { WorkspaceBackendRegistry } from '../../workspace/registry.js';
20
+ import { DEFAULT_TENANT, okExec, stubLogger, userActor } from './_fixtures.js';
21
+ function buildDeps(store, threadStore, execOverride) {
22
+ const exec = execOverride ?? (async () => okExec());
23
+ const driver = new GitWorktreeDriver({
24
+ repoRoot: '/repo',
25
+ logger: stubLogger(),
26
+ execFile: exec,
27
+ });
28
+ const workspaceRegistry = new WorkspaceBackendRegistry();
29
+ workspaceRegistry.register(driver);
30
+ const onBroadcastRollback = vi.fn();
31
+ const sink = {
32
+ onLocked: vi.fn(),
33
+ onUnlocked: vi.fn(),
34
+ onCommitted: vi.fn(),
35
+ onBroadcastRollback,
36
+ };
37
+ return {
38
+ deps: {
39
+ store,
40
+ workspaceRegistry,
41
+ capacity: new DefaultCapacityValidator(store),
42
+ events: sink,
43
+ threadManager: new ThreadManager({ threadStore, sessionStore: store }),
44
+ },
45
+ events: { ...sink, onBroadcastRollback },
46
+ };
47
+ }
48
+ function buildAssignments(sourceSessionId, projectId, threadId, recipients, broadcastId = 'bc_integration', expectedOwnerVersion = 0) {
49
+ return recipients.map((recipientActor) => ({
50
+ id: generateHandoffId(),
51
+ mode: 'broadcast',
52
+ sourceSessionId,
53
+ tenantId: DEFAULT_TENANT,
54
+ threadId,
55
+ projectId,
56
+ sourceActor: userActor('usr_source'),
57
+ recipientActor,
58
+ expectedOwnerVersion,
59
+ broadcastId,
60
+ createdAt: new Date('2026-04-17'),
61
+ }));
62
+ }
63
+ describe('Integration — broadcast handoff E2E', () => {
64
+ it('happy: 3-recipient fan-out → each recipient has isolated worktree + source reaches awaiting_merge', async () => {
65
+ const store = new InMemorySessionStore();
66
+ const threadStore = new InMemoryThreadStore();
67
+ const project = await store.createProject({ tenantId: DEFAULT_TENANT, name: 'bc-happy' }, DEFAULT_TENANT);
68
+ const thread = await threadStore.createThread({ projectId: project.id, title: 'bc-happy' }, DEFAULT_TENANT);
69
+ const source = await store.createSession({ threadId: thread.id, projectId: project.id, currentActor: userActor('usr_source') }, DEFAULT_TENANT);
70
+ // Track each `worktree add` call so we can assert each recipient got a
71
+ // distinct worktree path (isolation).
72
+ const addCalls = [];
73
+ const exec = async (_file, args) => {
74
+ if (args.includes('add')) {
75
+ // args contains ['-C', ..., 'worktree', 'add', '-b', branch, path].
76
+ const path = args[args.length - 1];
77
+ if (typeof path === 'string')
78
+ addCalls.push(path);
79
+ }
80
+ return okExec();
81
+ };
82
+ const { deps } = buildDeps(store, threadStore, exec);
83
+ const recipients = [userActor('usr_bob'), userActor('usr_carol'), userActor('usr_dan')];
84
+ const assignments = buildAssignments(source.id, project.id, thread.id, recipients);
85
+ const outcomes = await executeBroadcastHandoff(deps, assignments, DEFAULT_TENANT);
86
+ expect(outcomes).toHaveLength(3);
87
+ expect(new Set(outcomes.map((o) => o.newSessionId)).size).toBe(3);
88
+ expect(new Set(outcomes.map((o) => o.workspaceId)).size).toBe(3);
89
+ // Each recipient landed on a distinct worktree path — isolation holds.
90
+ expect(new Set(addCalls).size).toBe(3);
91
+ // §5.4: source transitions to awaiting_merge post-commit.
92
+ const reloaded = await store.getSession(source.id, DEFAULT_TENANT);
93
+ expect(reloaded?.status).toBe('awaiting_merge');
94
+ // Three children visible via getChildren.
95
+ const children = await store.getChildren(source.id, DEFAULT_TENANT);
96
+ expect(children).toHaveLength(3);
97
+ expect(children.every((c) => c.kind === 'user_handoff')).toBe(true);
98
+ });
99
+ it('rollback on 2nd-recipient provisioning failure: zero orphan records, partialState accurate', async () => {
100
+ const store = new InMemorySessionStore();
101
+ const threadStore = new InMemoryThreadStore();
102
+ const project = await store.createProject({ tenantId: DEFAULT_TENANT, name: 'bc-rb' }, DEFAULT_TENANT);
103
+ const thread = await threadStore.createThread({ projectId: project.id, title: 'bc-rb' }, DEFAULT_TENANT);
104
+ const source = await store.createSession({ threadId: thread.id, projectId: project.id, currentActor: userActor('usr_source') }, DEFAULT_TENANT);
105
+ let addCount = 0;
106
+ const exec = async (_file, args) => {
107
+ if (args.includes('add')) {
108
+ addCount += 1;
109
+ if (addCount === 2)
110
+ throw new Error('simulated fault on 2nd recipient');
111
+ }
112
+ return okExec();
113
+ };
114
+ const { deps, events } = buildDeps(store, threadStore, exec);
115
+ const assignments = buildAssignments(source.id, project.id, thread.id, [
116
+ userActor('usr_b'),
117
+ userActor('usr_c'),
118
+ userActor('usr_d'),
119
+ ]);
120
+ await expect(executeBroadcastHandoff(deps, assignments, DEFAULT_TENANT)).rejects.toThrow(/Workspace backend git-worktree failed on create/);
121
+ // Phase 8 closed the Known Delta: rollback now calls deleteSubSession +
122
+ // deleteSession rather than flipping to 'archived'. Zero orphan
123
+ // sub-session records remain.
124
+ const children = await store.getChildren(source.id, DEFAULT_TENANT);
125
+ expect(children).toHaveLength(0);
126
+ // Source reverted to idle with original ownerVersion.
127
+ const reloaded = await store.getSession(source.id, DEFAULT_TENANT);
128
+ expect(reloaded?.status).toBe('idle');
129
+ expect(reloaded?.ownerVersion).toBe(0);
130
+ // onBroadcastRollback emitted with accurate counts.
131
+ expect(events.onBroadcastRollback).toHaveBeenCalledTimes(1);
132
+ const rollbackCall = events.onBroadcastRollback.mock.calls[0]?.[0];
133
+ expect(rollbackCall?.partialState.worktreesProvisioned).toBe(1);
134
+ expect(rollbackCall?.partialState.subsessionsCreated).toBe(1);
135
+ expect(rollbackCall?.partialState.assignmentsWritten).toBe(1);
136
+ });
137
+ it('source transitions to awaiting_merge + retains currentActor as coordinator (§5.4)', async () => {
138
+ const store = new InMemorySessionStore();
139
+ const threadStore = new InMemoryThreadStore();
140
+ const project = await store.createProject({ tenantId: DEFAULT_TENANT, name: 'coord' }, DEFAULT_TENANT);
141
+ const thread = await threadStore.createThread({ projectId: project.id, title: 'coord' }, DEFAULT_TENANT);
142
+ const coordinator = userActor('usr_source');
143
+ const source = await store.createSession({ threadId: thread.id, projectId: project.id, currentActor: coordinator }, DEFAULT_TENANT);
144
+ const { deps } = buildDeps(store, threadStore);
145
+ const assignments = buildAssignments(source.id, project.id, thread.id, [
146
+ userActor('usr_b'),
147
+ userActor('usr_c'),
148
+ ]);
149
+ await executeBroadcastHandoff(deps, assignments, DEFAULT_TENANT);
150
+ const reloaded = await store.getSession(source.id, DEFAULT_TENANT);
151
+ expect(reloaded?.status).toBe('awaiting_merge');
152
+ // Coordinator retained as current actor (§5.4).
153
+ expect(reloaded?.currentActor).toEqual(coordinator);
154
+ expect(reloaded?.ownerVersion).toBe(1);
155
+ });
156
+ it('all recipients get isolated worktrees — zero path collisions even under N=8', async () => {
157
+ const store = new InMemorySessionStore();
158
+ const threadStore = new InMemoryThreadStore();
159
+ const project = await store.createProject({ tenantId: DEFAULT_TENANT, name: 'iso' }, DEFAULT_TENANT);
160
+ const thread = await threadStore.createThread({ projectId: project.id, title: 'iso' }, DEFAULT_TENANT);
161
+ const source = await store.createSession({ threadId: thread.id, projectId: project.id, currentActor: userActor('usr_source') }, DEFAULT_TENANT);
162
+ const seenPaths = new Set();
163
+ const exec = async (_file, args) => {
164
+ if (args.includes('add')) {
165
+ const path = args[args.length - 1];
166
+ if (typeof path === 'string') {
167
+ if (seenPaths.has(path))
168
+ throw new Error(`path collision: ${path}`);
169
+ seenPaths.add(path);
170
+ }
171
+ }
172
+ return okExec();
173
+ };
174
+ const { deps } = buildDeps(store, threadStore, exec);
175
+ const recipients = Array.from({ length: 8 }, (_, i) => userActor(`usr_${i}`));
176
+ const assignments = buildAssignments(source.id, project.id, thread.id, recipients);
177
+ const outcomes = await executeBroadcastHandoff(deps, assignments, DEFAULT_TENANT);
178
+ expect(outcomes).toHaveLength(8);
179
+ expect(seenPaths.size).toBe(8);
180
+ });
181
+ });
182
+ //# sourceMappingURL=handoff-broadcast-e2e.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handoff-broadcast-e2e.test.js","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/handoff-broadcast-e2e.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Integration — `active → locked` illegal-transition rejection matrix per
3
+ * pattern doc §5.1.
4
+ *
5
+ * A handoff request against a session whose current Run is `running`,
6
+ * `awaiting_hitl`, `awaiting_hitl_resolution`, or `awaiting_subsession`
7
+ * rejects with typed {@link HandoffLockRejected}. The reason enum maps:
8
+ * - running → 'active_run'
9
+ * - awaiting_hitl → 'pending_hitl'
10
+ * - awaiting_hitl_resol. → 'pending_hitl'
11
+ * - awaiting_subsession → 'pending_subsession'
12
+ *
13
+ * This integration test wires the `RunStatusResolver` seam into a full
14
+ * single-handoff flow so the rejection triggers from the run-fan-in check
15
+ * (§5.1), not just from a status precondition.
16
+ */
17
+ export {};
18
+ //# sourceMappingURL=handoff-illegal-transition.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handoff-illegal-transition.test.d.ts","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/handoff-illegal-transition.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}