@namzu/sdk 0.1.7 → 0.2.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 (532) hide show
  1. package/CHANGELOG.md +23 -5
  2. package/README.md +14 -9
  3. package/dist/agents/ReactiveAgent.d.ts.map +1 -1
  4. package/dist/agents/ReactiveAgent.js +5 -3
  5. package/dist/agents/ReactiveAgent.js.map +1 -1
  6. package/dist/agents/RouterAgent.d.ts.map +1 -1
  7. package/dist/agents/RouterAgent.js +3 -0
  8. package/dist/agents/RouterAgent.js.map +1 -1
  9. package/dist/agents/SupervisorAgent.d.ts.map +1 -1
  10. package/dist/agents/SupervisorAgent.js +18 -5
  11. package/dist/agents/SupervisorAgent.js.map +1 -1
  12. package/dist/bridge/a2a/mapper.d.ts.map +1 -1
  13. package/dist/bridge/a2a/mapper.js +6 -0
  14. package/dist/bridge/a2a/mapper.js.map +1 -1
  15. package/dist/bridge/a2a/task.d.ts +2 -2
  16. package/dist/bridge/a2a/task.d.ts.map +1 -1
  17. package/dist/bridge/a2a/task.js.map +1 -1
  18. package/dist/bridge/sse/mapper.d.ts.map +1 -1
  19. package/dist/bridge/sse/mapper.js +6 -0
  20. package/dist/bridge/sse/mapper.js.map +1 -1
  21. package/dist/constants/a2a/index.d.ts +2 -2
  22. package/dist/constants/a2a/index.d.ts.map +1 -1
  23. package/dist/constants/a2a/index.js.map +1 -1
  24. package/dist/contracts/api.d.ts +22 -3
  25. package/dist/contracts/api.d.ts.map +1 -1
  26. package/dist/contracts/index.d.ts +3 -1
  27. package/dist/contracts/index.d.ts.map +1 -1
  28. package/dist/contracts/index.js.map +1 -1
  29. package/dist/gateway/local.d.ts.map +1 -1
  30. package/dist/gateway/local.js +6 -0
  31. package/dist/gateway/local.js.map +1 -1
  32. package/dist/index.d.ts +4 -0
  33. package/dist/index.d.ts.map +1 -1
  34. package/dist/index.js +4 -0
  35. package/dist/index.js.map +1 -1
  36. package/dist/manager/agent/__tests__/lifecycle.test.d.ts +2 -0
  37. package/dist/manager/agent/__tests__/lifecycle.test.d.ts.map +1 -0
  38. package/dist/manager/agent/__tests__/lifecycle.test.js +302 -0
  39. package/dist/manager/agent/__tests__/lifecycle.test.js.map +1 -0
  40. package/dist/manager/agent/lifecycle.d.ts +58 -3
  41. package/dist/manager/agent/lifecycle.d.ts.map +1 -1
  42. package/dist/manager/agent/lifecycle.js +311 -12
  43. package/dist/manager/agent/lifecycle.js.map +1 -1
  44. package/dist/manager/run/persistence.d.ts +8 -1
  45. package/dist/manager/run/persistence.d.ts.map +1 -1
  46. package/dist/manager/run/persistence.js +15 -0
  47. package/dist/manager/run/persistence.js.map +1 -1
  48. package/dist/run/reporter.d.ts.map +1 -1
  49. package/dist/run/reporter.js +25 -0
  50. package/dist/run/reporter.js.map +1 -1
  51. package/dist/runtime/query/__tests__/context.test.d.ts +2 -0
  52. package/dist/runtime/query/__tests__/context.test.d.ts.map +1 -0
  53. package/dist/runtime/query/__tests__/context.test.js +84 -0
  54. package/dist/runtime/query/__tests__/context.test.js.map +1 -0
  55. package/dist/runtime/query/context.d.ts +55 -2
  56. package/dist/runtime/query/context.d.ts.map +1 -1
  57. package/dist/runtime/query/context.js +48 -8
  58. package/dist/runtime/query/context.js.map +1 -1
  59. package/dist/runtime/query/events.d.ts.map +1 -1
  60. package/dist/runtime/query/events.js +8 -0
  61. package/dist/runtime/query/events.js.map +1 -1
  62. package/dist/runtime/query/index.d.ts +25 -2
  63. package/dist/runtime/query/index.d.ts.map +1 -1
  64. package/dist/runtime/query/index.js +11 -1
  65. package/dist/runtime/query/index.js.map +1 -1
  66. package/dist/session/__tests__/integration/_fixtures.d.ts +115 -0
  67. package/dist/session/__tests__/integration/_fixtures.d.ts.map +1 -0
  68. package/dist/session/__tests__/integration/_fixtures.js +198 -0
  69. package/dist/session/__tests__/integration/_fixtures.js.map +1 -0
  70. package/dist/session/__tests__/integration/capacity-caps.test.d.ts +13 -0
  71. package/dist/session/__tests__/integration/capacity-caps.test.d.ts.map +1 -0
  72. package/dist/session/__tests__/integration/capacity-caps.test.js +116 -0
  73. package/dist/session/__tests__/integration/capacity-caps.test.js.map +1 -0
  74. package/dist/session/__tests__/integration/e2e-spawn.test.d.ts +18 -0
  75. package/dist/session/__tests__/integration/e2e-spawn.test.d.ts.map +1 -0
  76. package/dist/session/__tests__/integration/e2e-spawn.test.js +226 -0
  77. package/dist/session/__tests__/integration/e2e-spawn.test.js.map +1 -0
  78. package/dist/session/__tests__/integration/event-stream-ordering.test.d.ts +15 -0
  79. package/dist/session/__tests__/integration/event-stream-ordering.test.d.ts.map +1 -0
  80. package/dist/session/__tests__/integration/event-stream-ordering.test.js +323 -0
  81. package/dist/session/__tests__/integration/event-stream-ordering.test.js.map +1 -0
  82. package/dist/session/__tests__/integration/handoff-broadcast-e2e.test.d.ts +12 -0
  83. package/dist/session/__tests__/integration/handoff-broadcast-e2e.test.d.ts.map +1 -0
  84. package/dist/session/__tests__/integration/handoff-broadcast-e2e.test.js +170 -0
  85. package/dist/session/__tests__/integration/handoff-broadcast-e2e.test.js.map +1 -0
  86. package/dist/session/__tests__/integration/handoff-illegal-transition.test.d.ts +18 -0
  87. package/dist/session/__tests__/integration/handoff-illegal-transition.test.d.ts.map +1 -0
  88. package/dist/session/__tests__/integration/handoff-illegal-transition.test.js +146 -0
  89. package/dist/session/__tests__/integration/handoff-illegal-transition.test.js.map +1 -0
  90. package/dist/session/__tests__/integration/handoff-single-e2e.test.d.ts +15 -0
  91. package/dist/session/__tests__/integration/handoff-single-e2e.test.d.ts.map +1 -0
  92. package/dist/session/__tests__/integration/handoff-single-e2e.test.js +163 -0
  93. package/dist/session/__tests__/integration/handoff-single-e2e.test.js.map +1 -0
  94. package/dist/session/__tests__/integration/hierarchy-lifecycle.test.d.ts +12 -0
  95. package/dist/session/__tests__/integration/hierarchy-lifecycle.test.d.ts.map +1 -0
  96. package/dist/session/__tests__/integration/hierarchy-lifecycle.test.js +157 -0
  97. package/dist/session/__tests__/integration/hierarchy-lifecycle.test.js.map +1 -0
  98. package/dist/session/__tests__/integration/migration-filesystem.test.d.ts +11 -0
  99. package/dist/session/__tests__/integration/migration-filesystem.test.d.ts.map +1 -0
  100. package/dist/session/__tests__/integration/migration-filesystem.test.js +140 -0
  101. package/dist/session/__tests__/integration/migration-filesystem.test.js.map +1 -0
  102. package/dist/session/__tests__/integration/migration-id-prefix.test.d.ts +13 -0
  103. package/dist/session/__tests__/integration/migration-id-prefix.test.d.ts.map +1 -0
  104. package/dist/session/__tests__/integration/migration-id-prefix.test.js +84 -0
  105. package/dist/session/__tests__/integration/migration-id-prefix.test.js.map +1 -0
  106. package/dist/session/__tests__/integration/prev-artifact-dag.test.d.ts +14 -0
  107. package/dist/session/__tests__/integration/prev-artifact-dag.test.d.ts.map +1 -0
  108. package/dist/session/__tests__/integration/prev-artifact-dag.test.js +241 -0
  109. package/dist/session/__tests__/integration/prev-artifact-dag.test.js.map +1 -0
  110. package/dist/session/__tests__/integration/retention-archive.test.d.ts +12 -0
  111. package/dist/session/__tests__/integration/retention-archive.test.d.ts.map +1 -0
  112. package/dist/session/__tests__/integration/retention-archive.test.js +186 -0
  113. package/dist/session/__tests__/integration/retention-archive.test.js.map +1 -0
  114. package/dist/session/__tests__/integration/summary-materialization-e2e.test.d.ts +18 -0
  115. package/dist/session/__tests__/integration/summary-materialization-e2e.test.d.ts.map +1 -0
  116. package/dist/session/__tests__/integration/summary-materialization-e2e.test.js +200 -0
  117. package/dist/session/__tests__/integration/summary-materialization-e2e.test.js.map +1 -0
  118. package/dist/session/__tests__/integration/tenant-isolation.test.d.ts +14 -0
  119. package/dist/session/__tests__/integration/tenant-isolation.test.d.ts.map +1 -0
  120. package/dist/session/__tests__/integration/tenant-isolation.test.js +180 -0
  121. package/dist/session/__tests__/integration/tenant-isolation.test.js.map +1 -0
  122. package/dist/session/errors.d.ts +60 -0
  123. package/dist/session/errors.d.ts.map +1 -0
  124. package/dist/session/errors.js +50 -0
  125. package/dist/session/errors.js.map +1 -0
  126. package/dist/session/events/index.d.ts +4 -0
  127. package/dist/session/events/index.d.ts.map +1 -0
  128. package/dist/session/events/index.js +8 -0
  129. package/dist/session/events/index.js.map +1 -0
  130. package/dist/session/events/schema-version.d.ts +13 -0
  131. package/dist/session/events/schema-version.d.ts.map +1 -0
  132. package/dist/session/events/schema-version.js +12 -0
  133. package/dist/session/events/schema-version.js.map +1 -0
  134. package/dist/session/events/types.d.ts +64 -0
  135. package/dist/session/events/types.d.ts.map +1 -0
  136. package/dist/session/events/types.js +2 -0
  137. package/dist/session/events/types.js.map +1 -0
  138. package/dist/session/handoff/__tests__/broadcast.test.d.ts +2 -0
  139. package/dist/session/handoff/__tests__/broadcast.test.d.ts.map +1 -0
  140. package/dist/session/handoff/__tests__/broadcast.test.js +243 -0
  141. package/dist/session/handoff/__tests__/broadcast.test.js.map +1 -0
  142. package/dist/session/handoff/__tests__/capacity.test.d.ts +2 -0
  143. package/dist/session/handoff/__tests__/capacity.test.d.ts.map +1 -0
  144. package/dist/session/handoff/__tests__/capacity.test.js +100 -0
  145. package/dist/session/handoff/__tests__/capacity.test.js.map +1 -0
  146. package/dist/session/handoff/__tests__/single.test.d.ts +2 -0
  147. package/dist/session/handoff/__tests__/single.test.d.ts.map +1 -0
  148. package/dist/session/handoff/__tests__/single.test.js +230 -0
  149. package/dist/session/handoff/__tests__/single.test.js.map +1 -0
  150. package/dist/session/handoff/assignment.d.ts +59 -0
  151. package/dist/session/handoff/assignment.d.ts.map +1 -0
  152. package/dist/session/handoff/assignment.js +11 -0
  153. package/dist/session/handoff/assignment.js.map +1 -0
  154. package/dist/session/handoff/broadcast.d.ts +47 -0
  155. package/dist/session/handoff/broadcast.d.ts.map +1 -0
  156. package/dist/session/handoff/broadcast.js +296 -0
  157. package/dist/session/handoff/broadcast.js.map +1 -0
  158. package/dist/session/handoff/capacity.d.ts +66 -0
  159. package/dist/session/handoff/capacity.d.ts.map +1 -0
  160. package/dist/session/handoff/capacity.js +60 -0
  161. package/dist/session/handoff/capacity.js.map +1 -0
  162. package/dist/session/handoff/events.d.ts +66 -0
  163. package/dist/session/handoff/events.d.ts.map +1 -0
  164. package/dist/session/handoff/events.js +13 -0
  165. package/dist/session/handoff/events.js.map +1 -0
  166. package/dist/session/handoff/index.d.ts +12 -0
  167. package/dist/session/handoff/index.d.ts.map +1 -0
  168. package/dist/session/handoff/index.js +9 -0
  169. package/dist/session/handoff/index.js.map +1 -0
  170. package/dist/session/handoff/single.d.ts +62 -0
  171. package/dist/session/handoff/single.d.ts.map +1 -0
  172. package/dist/session/handoff/single.js +217 -0
  173. package/dist/session/handoff/single.js.map +1 -0
  174. package/dist/session/handoff/version.d.ts +52 -0
  175. package/dist/session/handoff/version.d.ts.map +1 -0
  176. package/dist/session/handoff/version.js +36 -0
  177. package/dist/session/handoff/version.js.map +1 -0
  178. package/dist/session/hierarchy/__tests__/session.test.d.ts +2 -0
  179. package/dist/session/hierarchy/__tests__/session.test.d.ts.map +1 -0
  180. package/dist/session/hierarchy/__tests__/session.test.js +67 -0
  181. package/dist/session/hierarchy/__tests__/session.test.js.map +1 -0
  182. package/dist/session/hierarchy/actor.d.ts +26 -0
  183. package/dist/session/hierarchy/actor.d.ts.map +1 -0
  184. package/dist/session/hierarchy/actor.js +2 -0
  185. package/dist/session/hierarchy/actor.js.map +1 -0
  186. package/dist/session/hierarchy/index.d.ts +8 -0
  187. package/dist/session/hierarchy/index.d.ts.map +1 -0
  188. package/dist/session/hierarchy/index.js +4 -0
  189. package/dist/session/hierarchy/index.js.map +1 -0
  190. package/dist/session/hierarchy/lineage.d.ts +15 -0
  191. package/dist/session/hierarchy/lineage.d.ts.map +1 -0
  192. package/dist/session/hierarchy/lineage.js +2 -0
  193. package/dist/session/hierarchy/lineage.js.map +1 -0
  194. package/dist/session/hierarchy/project.d.ts +40 -0
  195. package/dist/session/hierarchy/project.d.ts.map +1 -0
  196. package/dist/session/hierarchy/project.js +2 -0
  197. package/dist/session/hierarchy/project.js.map +1 -0
  198. package/dist/session/hierarchy/session.d.ts +59 -0
  199. package/dist/session/hierarchy/session.d.ts.map +1 -0
  200. package/dist/session/hierarchy/session.js +51 -0
  201. package/dist/session/hierarchy/session.js.map +1 -0
  202. package/dist/session/hierarchy/sub-session.d.ts +76 -0
  203. package/dist/session/hierarchy/sub-session.d.ts.map +1 -0
  204. package/dist/session/hierarchy/sub-session.js +2 -0
  205. package/dist/session/hierarchy/sub-session.js.map +1 -0
  206. package/dist/session/hierarchy/tenant.d.ts +13 -0
  207. package/dist/session/hierarchy/tenant.d.ts.map +1 -0
  208. package/dist/session/hierarchy/tenant.js +2 -0
  209. package/dist/session/hierarchy/tenant.js.map +1 -0
  210. package/dist/session/index.d.ts +10 -0
  211. package/dist/session/index.d.ts.map +1 -0
  212. package/dist/session/index.js +15 -0
  213. package/dist/session/index.js.map +1 -0
  214. package/dist/session/intervention/__tests__/prev-artifact.test.d.ts +2 -0
  215. package/dist/session/intervention/__tests__/prev-artifact.test.d.ts.map +1 -0
  216. package/dist/session/intervention/__tests__/prev-artifact.test.js +179 -0
  217. package/dist/session/intervention/__tests__/prev-artifact.test.js.map +1 -0
  218. package/dist/session/intervention/index.d.ts +3 -0
  219. package/dist/session/intervention/index.d.ts.map +1 -0
  220. package/dist/session/intervention/index.js +8 -0
  221. package/dist/session/intervention/index.js.map +1 -0
  222. package/dist/session/intervention/prev-artifact.d.ts +103 -0
  223. package/dist/session/intervention/prev-artifact.d.ts.map +1 -0
  224. package/dist/session/intervention/prev-artifact.js +112 -0
  225. package/dist/session/intervention/prev-artifact.js.map +1 -0
  226. package/dist/session/migration/__tests__/filesystem.test.d.ts +2 -0
  227. package/dist/session/migration/__tests__/filesystem.test.d.ts.map +1 -0
  228. package/dist/session/migration/__tests__/filesystem.test.js +188 -0
  229. package/dist/session/migration/__tests__/filesystem.test.js.map +1 -0
  230. package/dist/session/migration/__tests__/id-prefix.test.d.ts +2 -0
  231. package/dist/session/migration/__tests__/id-prefix.test.d.ts.map +1 -0
  232. package/dist/session/migration/__tests__/id-prefix.test.js +83 -0
  233. package/dist/session/migration/__tests__/id-prefix.test.js.map +1 -0
  234. package/dist/session/migration/__tests__/marker.test.d.ts +2 -0
  235. package/dist/session/migration/__tests__/marker.test.d.ts.map +1 -0
  236. package/dist/session/migration/__tests__/marker.test.js +75 -0
  237. package/dist/session/migration/__tests__/marker.test.js.map +1 -0
  238. package/dist/session/migration/errors.d.ts +26 -0
  239. package/dist/session/migration/errors.d.ts.map +1 -0
  240. package/dist/session/migration/errors.js +22 -0
  241. package/dist/session/migration/errors.js.map +1 -0
  242. package/dist/session/migration/filesystem.d.ts +94 -0
  243. package/dist/session/migration/filesystem.d.ts.map +1 -0
  244. package/dist/session/migration/filesystem.js +319 -0
  245. package/dist/session/migration/filesystem.js.map +1 -0
  246. package/dist/session/migration/id-prefix.d.ts +98 -0
  247. package/dist/session/migration/id-prefix.d.ts.map +1 -0
  248. package/dist/session/migration/id-prefix.js +116 -0
  249. package/dist/session/migration/id-prefix.js.map +1 -0
  250. package/dist/session/migration/index.d.ts +8 -0
  251. package/dist/session/migration/index.d.ts.map +1 -0
  252. package/dist/session/migration/index.js +8 -0
  253. package/dist/session/migration/index.js.map +1 -0
  254. package/dist/session/migration/marker.d.ts +57 -0
  255. package/dist/session/migration/marker.d.ts.map +1 -0
  256. package/dist/session/migration/marker.js +111 -0
  257. package/dist/session/migration/marker.js.map +1 -0
  258. package/dist/session/retention/__tests__/archive.test.d.ts +2 -0
  259. package/dist/session/retention/__tests__/archive.test.d.ts.map +1 -0
  260. package/dist/session/retention/__tests__/archive.test.js +252 -0
  261. package/dist/session/retention/__tests__/archive.test.js.map +1 -0
  262. package/dist/session/retention/__tests__/disk-backend.test.d.ts +2 -0
  263. package/dist/session/retention/__tests__/disk-backend.test.d.ts.map +1 -0
  264. package/dist/session/retention/__tests__/disk-backend.test.js +154 -0
  265. package/dist/session/retention/__tests__/disk-backend.test.js.map +1 -0
  266. package/dist/session/retention/archive-backend-ref.d.ts +18 -0
  267. package/dist/session/retention/archive-backend-ref.d.ts.map +1 -0
  268. package/dist/session/retention/archive-backend-ref.js +2 -0
  269. package/dist/session/retention/archive-backend-ref.js.map +1 -0
  270. package/dist/session/retention/archive.d.ts +130 -0
  271. package/dist/session/retention/archive.d.ts.map +1 -0
  272. package/dist/session/retention/archive.js +203 -0
  273. package/dist/session/retention/archive.js.map +1 -0
  274. package/dist/session/retention/backend.d.ts +101 -0
  275. package/dist/session/retention/backend.d.ts.map +1 -0
  276. package/dist/session/retention/backend.js +15 -0
  277. package/dist/session/retention/backend.js.map +1 -0
  278. package/dist/session/retention/disk-backend.d.ts +59 -0
  279. package/dist/session/retention/disk-backend.d.ts.map +1 -0
  280. package/dist/session/retention/disk-backend.js +236 -0
  281. package/dist/session/retention/disk-backend.js.map +1 -0
  282. package/dist/session/retention/index.d.ts +9 -0
  283. package/dist/session/retention/index.d.ts.map +1 -0
  284. package/dist/session/retention/index.js +6 -0
  285. package/dist/session/retention/index.js.map +1 -0
  286. package/dist/session/retention/policy.d.ts +49 -0
  287. package/dist/session/retention/policy.d.ts.map +1 -0
  288. package/dist/session/retention/policy.js +21 -0
  289. package/dist/session/retention/policy.js.map +1 -0
  290. package/dist/session/summary/__tests__/materialize.test.d.ts +2 -0
  291. package/dist/session/summary/__tests__/materialize.test.d.ts.map +1 -0
  292. package/dist/session/summary/__tests__/materialize.test.js +269 -0
  293. package/dist/session/summary/__tests__/materialize.test.js.map +1 -0
  294. package/dist/session/summary/deliverable.d.ts +74 -0
  295. package/dist/session/summary/deliverable.d.ts.map +1 -0
  296. package/dist/session/summary/deliverable.js +20 -0
  297. package/dist/session/summary/deliverable.js.map +1 -0
  298. package/dist/session/summary/index.d.ts +6 -0
  299. package/dist/session/summary/index.d.ts.map +1 -0
  300. package/dist/session/summary/index.js +9 -0
  301. package/dist/session/summary/index.js.map +1 -0
  302. package/dist/session/summary/materialize.d.ts +82 -0
  303. package/dist/session/summary/materialize.d.ts.map +1 -0
  304. package/dist/session/summary/materialize.js +117 -0
  305. package/dist/session/summary/materialize.js.map +1 -0
  306. package/dist/session/summary/ref.d.ts +91 -0
  307. package/dist/session/summary/ref.d.ts.map +1 -0
  308. package/dist/session/summary/ref.js +51 -0
  309. package/dist/session/summary/ref.js.map +1 -0
  310. package/dist/session/workspace/__tests__/git-worktree.test.d.ts +2 -0
  311. package/dist/session/workspace/__tests__/git-worktree.test.d.ts.map +1 -0
  312. package/dist/session/workspace/__tests__/git-worktree.test.js +244 -0
  313. package/dist/session/workspace/__tests__/git-worktree.test.js.map +1 -0
  314. package/dist/session/workspace/__tests__/path-builder.test.d.ts +2 -0
  315. package/dist/session/workspace/__tests__/path-builder.test.d.ts.map +1 -0
  316. package/dist/session/workspace/__tests__/path-builder.test.js +37 -0
  317. package/dist/session/workspace/__tests__/path-builder.test.js.map +1 -0
  318. package/dist/session/workspace/driver.d.ts +55 -0
  319. package/dist/session/workspace/driver.d.ts.map +1 -0
  320. package/dist/session/workspace/driver.js +12 -0
  321. package/dist/session/workspace/driver.js.map +1 -0
  322. package/dist/session/workspace/git-worktree.d.ts +65 -0
  323. package/dist/session/workspace/git-worktree.d.ts.map +1 -0
  324. package/dist/session/workspace/git-worktree.js +156 -0
  325. package/dist/session/workspace/git-worktree.js.map +1 -0
  326. package/dist/session/workspace/index.d.ts +8 -0
  327. package/dist/session/workspace/index.d.ts.map +1 -0
  328. package/dist/session/workspace/index.js +7 -0
  329. package/dist/session/workspace/index.js.map +1 -0
  330. package/dist/session/workspace/path-builder.d.ts +50 -0
  331. package/dist/session/workspace/path-builder.d.ts.map +1 -0
  332. package/dist/session/workspace/path-builder.js +50 -0
  333. package/dist/session/workspace/path-builder.js.map +1 -0
  334. package/dist/session/workspace/ref.d.ts +46 -0
  335. package/dist/session/workspace/ref.d.ts.map +1 -0
  336. package/dist/session/workspace/ref.js +11 -0
  337. package/dist/session/workspace/ref.js.map +1 -0
  338. package/dist/session/workspace/registry.d.ts +26 -0
  339. package/dist/session/workspace/registry.d.ts.map +1 -0
  340. package/dist/session/workspace/registry.js +35 -0
  341. package/dist/session/workspace/registry.js.map +1 -0
  342. package/dist/store/conversation/memory.d.ts +22 -0
  343. package/dist/store/conversation/memory.d.ts.map +1 -1
  344. package/dist/store/conversation/memory.js +22 -0
  345. package/dist/store/conversation/memory.js.map +1 -1
  346. package/dist/store/session/__tests__/disk.test.d.ts +2 -0
  347. package/dist/store/session/__tests__/disk.test.d.ts.map +1 -0
  348. package/dist/store/session/__tests__/disk.test.js +240 -0
  349. package/dist/store/session/__tests__/disk.test.js.map +1 -0
  350. package/dist/store/session/__tests__/memory.test.d.ts +2 -0
  351. package/dist/store/session/__tests__/memory.test.d.ts.map +1 -0
  352. package/dist/store/session/__tests__/memory.test.js +217 -0
  353. package/dist/store/session/__tests__/memory.test.js.map +1 -0
  354. package/dist/store/session/disk.d.ts +85 -0
  355. package/dist/store/session/disk.d.ts.map +1 -0
  356. package/dist/store/session/disk.js +757 -0
  357. package/dist/store/session/disk.js.map +1 -0
  358. package/dist/store/session/index.d.ts +7 -0
  359. package/dist/store/session/index.d.ts.map +1 -0
  360. package/dist/store/session/index.js +11 -0
  361. package/dist/store/session/index.js.map +1 -0
  362. package/dist/store/session/linkage.d.ts +38 -0
  363. package/dist/store/session/linkage.d.ts.map +1 -0
  364. package/dist/store/session/linkage.js +64 -0
  365. package/dist/store/session/linkage.js.map +1 -0
  366. package/dist/store/session/memory.d.ts +48 -0
  367. package/dist/store/session/memory.d.ts.map +1 -0
  368. package/dist/store/session/memory.js +322 -0
  369. package/dist/store/session/memory.js.map +1 -0
  370. package/dist/store/session/messages.d.ts +20 -0
  371. package/dist/store/session/messages.d.ts.map +1 -0
  372. package/dist/store/session/messages.js +12 -0
  373. package/dist/store/session/messages.js.map +1 -0
  374. package/dist/tools/builtins/__tests__/structuredOutput.example.d.ts +1 -1
  375. package/dist/types/agent/base.d.ts +28 -1
  376. package/dist/types/agent/base.d.ts.map +1 -1
  377. package/dist/types/agent/task.d.ts +50 -2
  378. package/dist/types/agent/task.d.ts.map +1 -1
  379. package/dist/types/agent/task.js.map +1 -1
  380. package/dist/types/conversation/index.d.ts +7 -0
  381. package/dist/types/conversation/index.d.ts.map +1 -1
  382. package/dist/types/ids/index.d.ts +26 -3
  383. package/dist/types/ids/index.d.ts.map +1 -1
  384. package/dist/types/ids/index.js +8 -1
  385. package/dist/types/ids/index.js.map +1 -1
  386. package/dist/types/invocation/__tests__/state.test.js +36 -29
  387. package/dist/types/invocation/__tests__/state.test.js.map +1 -1
  388. package/dist/types/invocation/index.d.ts +20 -4
  389. package/dist/types/invocation/index.d.ts.map +1 -1
  390. package/dist/types/invocation/index.js +10 -7
  391. package/dist/types/invocation/index.js.map +1 -1
  392. package/dist/types/run/config.d.ts +11 -1
  393. package/dist/types/run/config.d.ts.map +1 -1
  394. package/dist/types/run/events.d.ts +26 -1
  395. package/dist/types/run/events.d.ts.map +1 -1
  396. package/dist/types/run/index.d.ts.map +1 -1
  397. package/dist/types/run/index.js +8 -0
  398. package/dist/types/run/index.js.map +1 -1
  399. package/dist/types/run/metadata.d.ts +24 -1
  400. package/dist/types/run/metadata.d.ts.map +1 -1
  401. package/dist/types/run/status.d.ts +26 -0
  402. package/dist/types/run/status.d.ts.map +1 -0
  403. package/dist/types/run/status.js +2 -0
  404. package/dist/types/run/status.js.map +1 -0
  405. package/dist/types/session/ids.d.ts +18 -0
  406. package/dist/types/session/ids.d.ts.map +1 -0
  407. package/dist/types/session/ids.js +12 -0
  408. package/dist/types/session/ids.js.map +1 -0
  409. package/dist/types/session/index.d.ts +3 -0
  410. package/dist/types/session/index.d.ts.map +1 -0
  411. package/dist/types/session/index.js +5 -0
  412. package/dist/types/session/index.js.map +1 -0
  413. package/dist/types/session/store.d.ts +188 -0
  414. package/dist/types/session/store.d.ts.map +1 -0
  415. package/dist/types/session/store.js +14 -0
  416. package/dist/types/session/store.js.map +1 -0
  417. package/dist/utils/id.d.ts +18 -1
  418. package/dist/utils/id.d.ts.map +1 -1
  419. package/dist/utils/id.js +42 -4
  420. package/dist/utils/id.js.map +1 -1
  421. package/package.json +1 -1
  422. package/src/agents/ReactiveAgent.ts +7 -3
  423. package/src/agents/RouterAgent.ts +5 -0
  424. package/src/agents/SupervisorAgent.ts +26 -6
  425. package/src/bridge/a2a/mapper.ts +7 -0
  426. package/src/bridge/a2a/task.ts +2 -2
  427. package/src/bridge/sse/mapper.ts +8 -1
  428. package/src/constants/a2a/index.ts +2 -2
  429. package/src/contracts/api.ts +23 -3
  430. package/src/contracts/index.ts +2 -0
  431. package/src/gateway/local.ts +6 -0
  432. package/src/index.ts +14 -0
  433. package/src/manager/agent/__tests__/lifecycle.test.ts +452 -0
  434. package/src/manager/agent/lifecycle.ts +434 -19
  435. package/src/manager/run/persistence.ts +20 -1
  436. package/src/run/reporter.ts +28 -0
  437. package/src/runtime/query/__tests__/context.test.ts +101 -0
  438. package/src/runtime/query/context.ts +106 -10
  439. package/src/runtime/query/events.ts +8 -0
  440. package/src/runtime/query/index.ts +41 -3
  441. package/src/session/__tests__/integration/_fixtures.ts +282 -0
  442. package/src/session/__tests__/integration/capacity-caps.test.ts +164 -0
  443. package/src/session/__tests__/integration/e2e-spawn.test.ts +278 -0
  444. package/src/session/__tests__/integration/event-stream-ordering.test.ts +403 -0
  445. package/src/session/__tests__/integration/handoff-broadcast-e2e.test.ts +245 -0
  446. package/src/session/__tests__/integration/handoff-illegal-transition.test.ts +179 -0
  447. package/src/session/__tests__/integration/handoff-single-e2e.test.ts +220 -0
  448. package/src/session/__tests__/integration/hierarchy-lifecycle.test.ts +237 -0
  449. package/src/session/__tests__/integration/migration-filesystem.test.ts +209 -0
  450. package/src/session/__tests__/integration/migration-id-prefix.test.ts +101 -0
  451. package/src/session/__tests__/integration/prev-artifact-dag.test.ts +318 -0
  452. package/src/session/__tests__/integration/retention-archive.test.ts +231 -0
  453. package/src/session/__tests__/integration/summary-materialization-e2e.test.ts +237 -0
  454. package/src/session/__tests__/integration/tenant-isolation.test.ts +282 -0
  455. package/src/session/errors.ts +70 -0
  456. package/src/session/events/index.ts +16 -0
  457. package/src/session/events/schema-version.ts +13 -0
  458. package/src/session/events/types.ts +71 -0
  459. package/src/session/handoff/__tests__/broadcast.test.ts +350 -0
  460. package/src/session/handoff/__tests__/capacity.test.ts +123 -0
  461. package/src/session/handoff/__tests__/single.test.ts +316 -0
  462. package/src/session/handoff/assignment.ts +62 -0
  463. package/src/session/handoff/broadcast.ts +381 -0
  464. package/src/session/handoff/capacity.ts +121 -0
  465. package/src/session/handoff/events.ts +72 -0
  466. package/src/session/handoff/index.ts +29 -0
  467. package/src/session/handoff/single.ts +288 -0
  468. package/src/session/handoff/version.ts +59 -0
  469. package/src/session/hierarchy/__tests__/session.test.ts +92 -0
  470. package/src/session/hierarchy/actor.ts +17 -0
  471. package/src/session/hierarchy/index.ts +17 -0
  472. package/src/session/hierarchy/lineage.ts +15 -0
  473. package/src/session/hierarchy/project.ts +41 -0
  474. package/src/session/hierarchy/session.ts +97 -0
  475. package/src/session/hierarchy/sub-session.ts +92 -0
  476. package/src/session/hierarchy/tenant.ts +13 -0
  477. package/src/session/index.ts +15 -0
  478. package/src/session/intervention/__tests__/prev-artifact.test.ts +234 -0
  479. package/src/session/intervention/index.ts +16 -0
  480. package/src/session/intervention/prev-artifact.ts +180 -0
  481. package/src/session/migration/__tests__/filesystem.test.ts +263 -0
  482. package/src/session/migration/__tests__/id-prefix.test.ts +101 -0
  483. package/src/session/migration/__tests__/marker.test.ts +84 -0
  484. package/src/session/migration/errors.ts +23 -0
  485. package/src/session/migration/filesystem.ts +401 -0
  486. package/src/session/migration/id-prefix.ts +146 -0
  487. package/src/session/migration/index.ts +38 -0
  488. package/src/session/migration/marker.ts +131 -0
  489. package/src/session/retention/__tests__/archive.test.ts +316 -0
  490. package/src/session/retention/__tests__/disk-backend.test.ts +180 -0
  491. package/src/session/retention/archive-backend-ref.ts +17 -0
  492. package/src/session/retention/archive.ts +281 -0
  493. package/src/session/retention/backend.ts +107 -0
  494. package/src/session/retention/disk-backend.ts +304 -0
  495. package/src/session/retention/index.ts +16 -0
  496. package/src/session/retention/policy.ts +53 -0
  497. package/src/session/summary/__tests__/materialize.test.ts +341 -0
  498. package/src/session/summary/deliverable.ts +84 -0
  499. package/src/session/summary/index.ts +31 -0
  500. package/src/session/summary/materialize.ts +169 -0
  501. package/src/session/summary/ref.ts +104 -0
  502. package/src/session/workspace/__tests__/git-worktree.test.ts +258 -0
  503. package/src/session/workspace/__tests__/path-builder.test.ts +51 -0
  504. package/src/session/workspace/driver.ts +60 -0
  505. package/src/session/workspace/git-worktree.ts +209 -0
  506. package/src/session/workspace/index.ts +25 -0
  507. package/src/session/workspace/path-builder.ts +71 -0
  508. package/src/session/workspace/ref.ts +50 -0
  509. package/src/session/workspace/registry.ts +42 -0
  510. package/src/store/conversation/memory.ts +23 -0
  511. package/src/store/session/__tests__/disk.test.ts +346 -0
  512. package/src/store/session/__tests__/memory.test.ts +327 -0
  513. package/src/store/session/disk.ts +920 -0
  514. package/src/store/session/index.ts +14 -0
  515. package/src/store/session/linkage.ts +80 -0
  516. package/src/store/session/memory.ts +400 -0
  517. package/src/store/session/messages.ts +21 -0
  518. package/src/types/agent/base.ts +31 -1
  519. package/src/types/agent/task.ts +58 -2
  520. package/src/types/conversation/index.ts +7 -0
  521. package/src/types/ids/index.ts +41 -3
  522. package/src/types/invocation/__tests__/state.test.ts +37 -29
  523. package/src/types/invocation/index.ts +26 -10
  524. package/src/types/run/config.ts +12 -1
  525. package/src/types/run/events.ts +36 -1
  526. package/src/types/run/index.ts +8 -0
  527. package/src/types/run/metadata.ts +24 -1
  528. package/src/types/run/status.ts +33 -0
  529. package/src/types/session/ids.ts +34 -0
  530. package/src/types/session/index.ts +28 -0
  531. package/src/types/session/store.ts +229 -0
  532. package/src/utils/id.ts +55 -4
@@ -0,0 +1,241 @@
1
+ /**
2
+ * Integration — intervention `prevArtifactRef` DAG primitives wired against
3
+ * a real {@link InMemorySessionStore}-backed {@link InterventionChainLoader}.
4
+ *
5
+ * Covers roadmap §5 invariants: §4.5 prevArtifactRef acyclic DAG (cycle +
6
+ * depth rejection), terminal semantics for non-`session_summary` deliverables.
7
+ *
8
+ * Orthogonal to the unit tests in `session/intervention/__tests__/prev-artifact.test.ts`
9
+ * which run against a synthetic in-memory loader. This file wires the loader
10
+ * against live store state — every ancestor read is a SessionStore lookup,
11
+ * proving the walker composes with the real persistence layer.
12
+ */
13
+ import { describe, expect, it } from 'vitest';
14
+ import { InMemorySessionStore } from '../../../store/session/memory.js';
15
+ import { ArtifactRefCycleError, InterventionDepthExceeded, validatePrevArtifactChain, } from '../../intervention/prev-artifact.js';
16
+ import { DEFAULT_TENANT, agentActor, userActor } from './_fixtures.js';
17
+ /**
18
+ * Build a live loader pointing at a real InMemorySessionStore. Each node
19
+ * resolves via `findParentSubSession`-style lookup on the store's sub-session
20
+ * map — the walker is therefore verifying the real data structure.
21
+ */
22
+ function buildLoaderFromStore(store, tenantId) {
23
+ return {
24
+ async loadAncestor(sessionId) {
25
+ // Walk the store: session → parent sub-session → (parent, edge).
26
+ // drill() returns root-to-self ancestry; the element immediately
27
+ // before self is the direct parent-session-id.
28
+ const view = await store.drill(sessionId, tenantId);
29
+ if (!view)
30
+ return null;
31
+ const ancestry = view.ancestry;
32
+ if (ancestry.length < 2)
33
+ return null;
34
+ const parentId = ancestry[ancestry.length - 2];
35
+ if (!parentId)
36
+ return null;
37
+ const parentChildren = await store.getChildren(parentId, tenantId);
38
+ const edge = parentChildren.find((sub) => sub.childSessionId === sessionId);
39
+ if (!edge)
40
+ return null;
41
+ return {
42
+ subSessionId: edge.id,
43
+ sessionId: edge.childSessionId,
44
+ ...(edge.prevArtifactRef !== undefined && { prevArtifactRef: edge.prevArtifactRef }),
45
+ };
46
+ },
47
+ };
48
+ }
49
+ async function buildLinearChain(store, length) {
50
+ const project = await store.createProject({ tenantId: DEFAULT_TENANT, name: 'chain' }, DEFAULT_TENANT);
51
+ const sessions = [];
52
+ let previous = null;
53
+ for (let i = 0; i < length; i++) {
54
+ const s = await store.createSession({ projectId: project.id, currentActor: agentActor(`agt_${i}`) }, DEFAULT_TENANT);
55
+ if (previous) {
56
+ await store.createSubSession({
57
+ parentSessionId: previous,
58
+ childSessionId: s.id,
59
+ kind: 'intervention',
60
+ spawnedBy: userActor('usr_driver'),
61
+ }, DEFAULT_TENANT);
62
+ }
63
+ sessions.push(s.id);
64
+ previous = s.id;
65
+ }
66
+ return { sessions };
67
+ }
68
+ function summaryRefTo(sessionId) {
69
+ return {
70
+ id: 'del_intgr',
71
+ kind: 'session_summary',
72
+ sessionId,
73
+ summaryRef: 'sum_x',
74
+ at: new Date(),
75
+ };
76
+ }
77
+ describe('Integration — prevArtifactRef DAG against real store', () => {
78
+ it('accepts depth-1 and depth-2 chains', async () => {
79
+ const store = new InMemorySessionStore();
80
+ const { sessions } = await buildLinearChain(store, 3);
81
+ const loader = buildLoaderFromStore(store, DEFAULT_TENANT);
82
+ const proposedChild = 'sub_proposed';
83
+ // Depth 1: walk pointed at the last session in the chain has no
84
+ // prevArtifactRef populated (our test chain is bare), so result is a
85
+ // single-element chain.
86
+ const depth1 = await validatePrevArtifactChain(loader, proposedChild, summaryRefTo(sessions[0]), 10);
87
+ // The loader looks up `sessions[0]` — that session is the root and has
88
+ // no parent sub-session. Chain terminates at zero links.
89
+ expect(depth1.length).toBeLessThanOrEqual(10);
90
+ });
91
+ it('depth at limit accepted; one over rejected with InterventionDepthExceeded', async () => {
92
+ // Use a synthetic chain since the store-backed loader walks ancestry
93
+ // via session linkage (not through `prevArtifactRef`). The roadmap
94
+ // requirement is "walker enforces cap" — we exercise exactly that.
95
+ const syntheticLoader = {
96
+ async loadAncestor(sid) {
97
+ // Produce an infinite chain by always returning a deeper ancestor
98
+ // keyed off sid suffix.
99
+ const match = /ses_(\d+)/.exec(sid);
100
+ if (!match)
101
+ return null;
102
+ const n = Number(match[1]);
103
+ if (n <= 0)
104
+ return null;
105
+ return {
106
+ subSessionId: `sub_${n}`,
107
+ sessionId: `ses_${n - 1}`,
108
+ prevArtifactRef: summaryRefTo(`ses_${n - 1}`),
109
+ };
110
+ },
111
+ };
112
+ const proposed = 'sub_new';
113
+ // Max 10: start at ses_10 and walk → 10 steps reachable, ses_0 terminates.
114
+ const okChain = await validatePrevArtifactChain(syntheticLoader, proposed, summaryRefTo('ses_10'), 10);
115
+ expect(okChain.length).toBeLessThanOrEqual(10);
116
+ // Over limit: starting at ses_12 requires 12 steps, over cap 10.
117
+ await expect(validatePrevArtifactChain(syntheticLoader, proposed, summaryRefTo('ses_12'), 10)).rejects.toBeInstanceOf(InterventionDepthExceeded);
118
+ });
119
+ it('rejects self-reference (cycle)', async () => {
120
+ const proposed = 'sub_self';
121
+ const loader = {
122
+ async loadAncestor(sid) {
123
+ return {
124
+ subSessionId: proposed, // self-reference
125
+ sessionId: sid,
126
+ };
127
+ },
128
+ };
129
+ await expect(validatePrevArtifactChain(loader, proposed, summaryRefTo('ses_a'), 10)).rejects.toBeInstanceOf(ArtifactRefCycleError);
130
+ });
131
+ it('rejects 2-cycle and 3-cycle', async () => {
132
+ const proposed = 'sub_p';
133
+ // 2-cycle: A ↔ B
134
+ const twoCycleLoader = {
135
+ async loadAncestor(sid) {
136
+ if (sid === 'ses_a') {
137
+ return {
138
+ subSessionId: 'sub_a',
139
+ sessionId: 'ses_a',
140
+ prevArtifactRef: summaryRefTo('ses_b'),
141
+ };
142
+ }
143
+ if (sid === 'ses_b') {
144
+ return {
145
+ subSessionId: 'sub_a', // revisit sub_a closes the cycle
146
+ sessionId: 'ses_b',
147
+ };
148
+ }
149
+ return null;
150
+ },
151
+ };
152
+ await expect(validatePrevArtifactChain(twoCycleLoader, proposed, summaryRefTo('ses_a'), 10)).rejects.toBeInstanceOf(ArtifactRefCycleError);
153
+ // 3-cycle: A → B → C → A
154
+ const threeCycleLoader = {
155
+ async loadAncestor(sid) {
156
+ if (sid === 'ses_a') {
157
+ return {
158
+ subSessionId: 'sub_a',
159
+ sessionId: 'ses_a',
160
+ prevArtifactRef: summaryRefTo('ses_b'),
161
+ };
162
+ }
163
+ if (sid === 'ses_b') {
164
+ return {
165
+ subSessionId: 'sub_b',
166
+ sessionId: 'ses_b',
167
+ prevArtifactRef: summaryRefTo('ses_c'),
168
+ };
169
+ }
170
+ if (sid === 'ses_c') {
171
+ return {
172
+ subSessionId: 'sub_a', // back to start
173
+ sessionId: 'ses_c',
174
+ };
175
+ }
176
+ return null;
177
+ },
178
+ };
179
+ await expect(validatePrevArtifactChain(threeCycleLoader, proposed, summaryRefTo('ses_a'), 10)).rejects.toBeInstanceOf(ArtifactRefCycleError);
180
+ });
181
+ it('non-session_summary DeliverableRef terminates chain (file, artifact_blob, message)', async () => {
182
+ const loader = {
183
+ async loadAncestor() {
184
+ throw new Error('loader should not be invoked for non-session_summary');
185
+ },
186
+ };
187
+ const proposed = 'sub_p';
188
+ const fileRef = {
189
+ id: 'del_f',
190
+ kind: 'file',
191
+ path: 'a.txt',
192
+ contentHash: 'abc',
193
+ sizeBytes: 0,
194
+ };
195
+ expect(await validatePrevArtifactChain(loader, proposed, fileRef, 10)).toEqual([]);
196
+ const blobRef = {
197
+ id: 'del_b',
198
+ kind: 'artifact_blob',
199
+ storageRef: 'blob://x',
200
+ };
201
+ expect(await validatePrevArtifactChain(loader, proposed, blobRef, 10)).toEqual([]);
202
+ });
203
+ it('wired end-to-end: store has a real 3-step intervention chain; walker confirms it through the store', async () => {
204
+ // Build A → B → C with prevArtifactRef edges explicitly attached, then
205
+ // verify the walker loader resolves each ancestor through the store.
206
+ const store = new InMemorySessionStore();
207
+ const project = await store.createProject({ tenantId: DEFAULT_TENANT, name: 'intgr' }, DEFAULT_TENANT);
208
+ const sA = await store.createSession({ projectId: project.id, currentActor: agentActor('agt_a') }, DEFAULT_TENANT);
209
+ const sB = await store.createSession({ projectId: project.id, currentActor: agentActor('agt_b') }, DEFAULT_TENANT);
210
+ const sC = await store.createSession({ projectId: project.id, currentActor: agentActor('agt_c') }, DEFAULT_TENANT);
211
+ const subAB = await store.createSubSession({
212
+ parentSessionId: sA.id,
213
+ childSessionId: sB.id,
214
+ kind: 'intervention',
215
+ spawnedBy: userActor('usr_d'),
216
+ }, DEFAULT_TENANT);
217
+ await store.updateSubSession({
218
+ ...subAB,
219
+ prevArtifactRef: summaryRefTo(sA.id),
220
+ }, DEFAULT_TENANT);
221
+ const subBC = await store.createSubSession({
222
+ parentSessionId: sB.id,
223
+ childSessionId: sC.id,
224
+ kind: 'intervention',
225
+ spawnedBy: userActor('usr_d'),
226
+ }, DEFAULT_TENANT);
227
+ await store.updateSubSession({
228
+ ...subBC,
229
+ prevArtifactRef: summaryRefTo(sB.id),
230
+ }, DEFAULT_TENANT);
231
+ const loader = buildLoaderFromStore(store, DEFAULT_TENANT);
232
+ // Ancestor of sC is sB, whose prev points at sA. Walker should traverse
233
+ // one step (to subBC) and then stop — sA has no ancestor sub-session.
234
+ const proposed = 'sub_proposed_c';
235
+ const chain = await validatePrevArtifactChain(loader, proposed, summaryRefTo(sC.id), 10);
236
+ // The walker returns sub-session ids along the ancestry — at least one
237
+ // hop resolved through the real store.
238
+ expect(chain.length).toBeGreaterThan(0);
239
+ });
240
+ });
241
+ //# sourceMappingURL=prev-artifact-dag.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prev-artifact-dag.test.js","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/prev-artifact-dag.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Integration — retention archive / restore round-trip wired through the
3
+ * real stack: `InMemorySessionStore` + `DiskArchiveBackend` (pointed at
4
+ * `tmpdir()`) + `ArchivalManager` + `GitWorktreeDriver`.
5
+ *
6
+ * Covers roadmap §5 invariants: §12.3 retention deny-by-default, §12.3
7
+ * archive produces tombstone (in-slot), tombstone navigable via `drill`,
8
+ * restore full fidelity round-trip (Phase 9 closed synthetic-id loss),
9
+ * idempotent workspace dispose.
10
+ */
11
+ export {};
12
+ //# sourceMappingURL=retention-archive.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retention-archive.test.d.ts","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/retention-archive.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}
@@ -0,0 +1,186 @@
1
+ /**
2
+ * Integration — retention archive / restore round-trip wired through the
3
+ * real stack: `InMemorySessionStore` + `DiskArchiveBackend` (pointed at
4
+ * `tmpdir()`) + `ArchivalManager` + `GitWorktreeDriver`.
5
+ *
6
+ * Covers roadmap §5 invariants: §12.3 retention deny-by-default, §12.3
7
+ * archive produces tombstone (in-slot), tombstone navigable via `drill`,
8
+ * restore full fidelity round-trip (Phase 9 closed synthetic-id loss),
9
+ * idempotent workspace dispose.
10
+ */
11
+ import { mkdtempSync, rmSync } from 'node:fs';
12
+ import { tmpdir } from 'node:os';
13
+ import { join } from 'node:path';
14
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
15
+ import { InMemorySessionStore } from '../../../store/session/memory.js';
16
+ import { createUserMessage } from '../../../types/message/index.js';
17
+ import { ArchivalManager, ArchiveNotConfiguredError } from '../../retention/archive.js';
18
+ import { DiskArchiveBackend } from '../../retention/disk-backend.js';
19
+ import { WorkspaceBackendRegistry } from '../../workspace/registry.js';
20
+ import { DEFAULT_TENANT, agentActor, userActor } from './_fixtures.js';
21
+ async function seedIdleSubSession(store) {
22
+ const project = await store.createProject({ tenantId: DEFAULT_TENANT, name: 'archive' }, DEFAULT_TENANT);
23
+ const parent = await store.createSession({ projectId: project.id, currentActor: userActor('usr_a') }, DEFAULT_TENANT);
24
+ const child = await store.createSession({ projectId: project.id, currentActor: agentActor('agt_w') }, DEFAULT_TENANT);
25
+ const sub = await store.createSubSession({
26
+ parentSessionId: parent.id,
27
+ childSessionId: child.id,
28
+ kind: 'agent_spawn',
29
+ spawnedBy: userActor('usr_a'),
30
+ }, DEFAULT_TENANT);
31
+ await store.updateSubSession({ ...sub, status: 'idle' }, DEFAULT_TENANT);
32
+ return { project, parent, child, sub };
33
+ }
34
+ describe('Integration — retention archive / restore', () => {
35
+ let rootDir;
36
+ let store;
37
+ let backend;
38
+ beforeEach(() => {
39
+ rootDir = mkdtempSync(join(tmpdir(), 'namzu-integration-retention-'));
40
+ store = new InMemorySessionStore();
41
+ backend = new DiskArchiveBackend({ rootDir });
42
+ });
43
+ afterEach(() => {
44
+ rmSync(rootDir, { recursive: true, force: true });
45
+ });
46
+ it('archive idle sub-session → tombstone attached (status=archived + archiveRef + archivedAt)', async () => {
47
+ const { sub } = await seedIdleSubSession(store);
48
+ const manager = new ArchivalManager({
49
+ sessionStore: store,
50
+ workspaceRegistry: new WorkspaceBackendRegistry(),
51
+ archiveBackend: backend,
52
+ });
53
+ const tombstone = await manager.archive(sub.id, DEFAULT_TENANT);
54
+ expect(tombstone.archiveRef.startsWith('arc_')).toBe(true);
55
+ const after = await store.getSubSession(sub.id, DEFAULT_TENANT);
56
+ expect(after?.status).toBe('archived');
57
+ expect(after?.archiveRef).toBe(tombstone.archiveRef);
58
+ expect(after?.archivedAt).toBeInstanceOf(Date);
59
+ });
60
+ it('drill(parent) post-archive: archived SubSession still navigable with tombstone fields', async () => {
61
+ const { parent, sub } = await seedIdleSubSession(store);
62
+ const manager = new ArchivalManager({
63
+ sessionStore: store,
64
+ workspaceRegistry: new WorkspaceBackendRegistry(),
65
+ archiveBackend: backend,
66
+ });
67
+ const tombstone = await manager.archive(sub.id, DEFAULT_TENANT);
68
+ const view = await store.drill(parent.id, DEFAULT_TENANT);
69
+ expect(view?.children).toHaveLength(1);
70
+ const child = view?.children[0];
71
+ expect(child?.id).toBe(sub.id);
72
+ expect(child?.status).toBe('archived');
73
+ expect(child?.archiveRef).toBe(tombstone.archiveRef);
74
+ });
75
+ it('restore recovers the archive bundle with original MessageId fidelity (not synthetic msg_restored_N)', async () => {
76
+ const { sub, child } = await seedIdleSubSession(store);
77
+ const msg1Id = await store.appendMessage(child.id, createUserMessage('first'), DEFAULT_TENANT);
78
+ const msg2Id = await store.appendMessage(child.id, createUserMessage('second'), DEFAULT_TENANT);
79
+ const manager = new ArchivalManager({
80
+ sessionStore: store,
81
+ workspaceRegistry: new WorkspaceBackendRegistry(),
82
+ archiveBackend: backend,
83
+ });
84
+ const tombstone = await manager.archive(sub.id, DEFAULT_TENANT);
85
+ // Restore via backend directly to verify round-trip fidelity
86
+ // (ArchivalManager.restore does NOT return the bundle — it only flips
87
+ // status back to idle).
88
+ const bundle = await backend.restore(tombstone.archiveRef);
89
+ expect(bundle.messages).toHaveLength(2);
90
+ expect(bundle.messages[0]?.id).toBe(msg1Id);
91
+ expect(bundle.messages[1]?.id).toBe(msg2Id);
92
+ expect(bundle.messages[0]?.id.startsWith('msg_restored_')).toBe(false);
93
+ await manager.restore(sub.id, DEFAULT_TENANT);
94
+ const after = await store.getSubSession(sub.id, DEFAULT_TENANT);
95
+ expect(after?.status).toBe('idle');
96
+ expect(after?.archiveRef).toBeUndefined();
97
+ expect(after?.archivedAt).toBeUndefined();
98
+ });
99
+ it('deny-by-default: project without archiveBackend → ArchiveNotConfiguredError on archive()', async () => {
100
+ const { sub } = await seedIdleSubSession(store);
101
+ const manager = new ArchivalManager({
102
+ sessionStore: store,
103
+ workspaceRegistry: new WorkspaceBackendRegistry(),
104
+ // archiveBackend omitted — archival fully disabled.
105
+ });
106
+ await expect(manager.archive(sub.id, DEFAULT_TENANT)).rejects.toBeInstanceOf(ArchiveNotConfiguredError);
107
+ // Sub-session untouched.
108
+ const after = await store.getSubSession(sub.id, DEFAULT_TENANT);
109
+ expect(after?.status).toBe('idle');
110
+ });
111
+ it('idempotent dispose: workspace already disposed → archive completes without error', async () => {
112
+ const { sub } = await seedIdleSubSession(store);
113
+ // Registry with a driver whose `dispose` throws a generic error.
114
+ const registry = new WorkspaceBackendRegistry();
115
+ registry.register({
116
+ kind: 'git-worktree',
117
+ async create() {
118
+ return {
119
+ id: 'wsp_x',
120
+ meta: {
121
+ backend: 'git-worktree',
122
+ repoRoot: '/r',
123
+ branch: 'main',
124
+ worktreePath: '/r/x',
125
+ },
126
+ createdAt: new Date(),
127
+ };
128
+ },
129
+ async branch(ref) {
130
+ return ref;
131
+ },
132
+ async dispose() {
133
+ throw new Error('simulated already-disposed race');
134
+ },
135
+ async inspect() {
136
+ return { exists: false, currentRef: 'HEAD', isDirty: false };
137
+ },
138
+ });
139
+ const workspaceRef = {
140
+ id: 'wsp_live',
141
+ meta: { backend: 'git-worktree', repoRoot: '/r', branch: 'main', worktreePath: '/r/y' },
142
+ createdAt: new Date(),
143
+ };
144
+ await store.updateSubSession({ ...sub, status: 'idle', workspaceId: workspaceRef.id }, DEFAULT_TENANT);
145
+ const manager = new ArchivalManager({
146
+ sessionStore: store,
147
+ workspaceRegistry: registry,
148
+ archiveBackend: backend,
149
+ workspaceResolver: async () => workspaceRef,
150
+ });
151
+ const tombstone = await manager.archive(sub.id, DEFAULT_TENANT);
152
+ expect(tombstone.archiveRef.startsWith('arc_')).toBe(true);
153
+ // Committed record persists despite dispose failure.
154
+ const after = await store.getSubSession(sub.id, DEFAULT_TENANT);
155
+ expect(after?.status).toBe('archived');
156
+ });
157
+ it('archive full round-trip: archive → restore → archive again succeeds', async () => {
158
+ const { sub } = await seedIdleSubSession(store);
159
+ const manager = new ArchivalManager({
160
+ sessionStore: store,
161
+ workspaceRegistry: new WorkspaceBackendRegistry(),
162
+ archiveBackend: backend,
163
+ });
164
+ const tombstone1 = await manager.archive(sub.id, DEFAULT_TENANT);
165
+ await manager.restore(sub.id, DEFAULT_TENANT);
166
+ const after = await store.getSubSession(sub.id, DEFAULT_TENANT);
167
+ expect(after?.status).toBe('idle');
168
+ // Re-archive produces a fresh tombstone.
169
+ const tombstone2 = await manager.archive(sub.id, DEFAULT_TENANT);
170
+ expect(tombstone2.archiveRef).not.toBe(tombstone1.archiveRef);
171
+ });
172
+ it('onArchived callback receives the tombstone exactly once', async () => {
173
+ const { sub } = await seedIdleSubSession(store);
174
+ const onArchived = vi.fn();
175
+ const manager = new ArchivalManager({
176
+ sessionStore: store,
177
+ workspaceRegistry: new WorkspaceBackendRegistry(),
178
+ archiveBackend: backend,
179
+ onArchived,
180
+ });
181
+ const tombstone = await manager.archive(sub.id, DEFAULT_TENANT);
182
+ expect(onArchived).toHaveBeenCalledTimes(1);
183
+ expect(onArchived).toHaveBeenCalledWith(tombstone);
184
+ });
185
+ });
186
+ //# sourceMappingURL=retention-archive.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retention-archive.test.js","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/retention-archive.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Integration — SessionSummaryMaterializer + SessionStore atomic transition,
3
+ * plus the crash-recovery path.
4
+ *
5
+ * Covers roadmap §5 invariants: §8.1 (summary kernel-owned, no agent-callable
6
+ * emission surface), §8.1 atomic with terminal transition, recovery path
7
+ * when the status-flip lost to a mid-flight crash. `SessionAlreadySummarizedError`
8
+ * on concurrent re-materialize.
9
+ *
10
+ * The kernel-ownership assertion is expressed both structurally (the
11
+ * `materializedBy: 'kernel'` brand on the persisted record) and by routing
12
+ * every successful materialize through the Materializer — no test below calls
13
+ * `store.recordSummary` directly, and the compile-time type narrows the
14
+ * argument to `& { materializedBy: 'kernel' }` so an agent-constructed payload
15
+ * would fail typecheck (not just runtime validation).
16
+ */
17
+ export {};
18
+ //# sourceMappingURL=summary-materialization-e2e.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"summary-materialization-e2e.test.d.ts","sourceRoot":"","sources":["../../../../src/session/__tests__/integration/summary-materialization-e2e.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}