@mastra/factory 0.29.0-alpha.4 → 0.29.0-alpha.6

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 (401) hide show
  1. package/README.md +172 -89
  2. package/dist/boards/board-events.d.ts +89 -9
  3. package/dist/boards/board-events.d.ts.map +1 -1
  4. package/dist/boards/board-events.js +176 -13
  5. package/dist/boards/board-events.js.map +1 -1
  6. package/dist/boards/board-writes.d.ts.map +1 -1
  7. package/dist/boards/board-writes.js +14 -1
  8. package/dist/boards/board-writes.js.map +1 -1
  9. package/dist/boards/busy-card.d.ts +11 -0
  10. package/dist/boards/busy-card.d.ts.map +1 -0
  11. package/dist/boards/busy-card.js +15 -0
  12. package/dist/boards/busy-card.js.map +1 -0
  13. package/dist/boards/card-facts.d.ts.map +1 -1
  14. package/dist/boards/card-facts.js +18 -4
  15. package/dist/boards/card-facts.js.map +1 -1
  16. package/dist/boards/index.d.ts +2 -1
  17. package/dist/boards/index.d.ts.map +1 -1
  18. package/dist/boards/index.js +3 -2
  19. package/dist/boards/intake-dry-run.d.ts +109 -0
  20. package/dist/boards/intake-dry-run.d.ts.map +1 -0
  21. package/dist/boards/intake-dry-run.js +158 -0
  22. package/dist/boards/intake-dry-run.js.map +1 -0
  23. package/dist/boards/intake-lookup.d.ts +32 -0
  24. package/dist/boards/intake-lookup.d.ts.map +1 -0
  25. package/dist/boards/intake-lookup.js +12 -0
  26. package/dist/boards/intake-lookup.js.map +1 -0
  27. package/dist/boards/intake-order.d.ts +32 -0
  28. package/dist/boards/intake-order.d.ts.map +1 -0
  29. package/dist/boards/intake-order.js +60 -0
  30. package/dist/boards/intake-order.js.map +1 -0
  31. package/dist/boards/intake-routing.d.ts +246 -35
  32. package/dist/boards/intake-routing.d.ts.map +1 -1
  33. package/dist/boards/intake-routing.js +437 -52
  34. package/dist/boards/intake-routing.js.map +1 -1
  35. package/dist/boards/reroute.d.ts +7 -3
  36. package/dist/boards/reroute.d.ts.map +1 -1
  37. package/dist/boards/reroute.js +21 -4
  38. package/dist/boards/reroute.js.map +1 -1
  39. package/dist/boards/semantics.d.ts +8 -28
  40. package/dist/boards/semantics.d.ts.map +1 -1
  41. package/dist/boards/semantics.js +14 -40
  42. package/dist/boards/semantics.js.map +1 -1
  43. package/dist/boards/work-routes.d.ts +31 -11
  44. package/dist/boards/work-routes.d.ts.map +1 -1
  45. package/dist/boards/work-routes.js +104 -20
  46. package/dist/boards/work-routes.js.map +1 -1
  47. package/dist/factory.d.ts +37 -1
  48. package/dist/factory.d.ts.map +1 -1
  49. package/dist/factory.js +127 -48
  50. package/dist/factory.js.map +1 -1
  51. package/dist/integrations/base.d.ts +9 -0
  52. package/dist/integrations/base.d.ts.map +1 -1
  53. package/dist/integrations/dependabot/rules.js +1 -1
  54. package/dist/integrations/dependabot/rules.js.map +1 -1
  55. package/dist/integrations/github/default-rules.d.ts +22 -1
  56. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  57. package/dist/integrations/github/default-rules.js +23 -5
  58. package/dist/integrations/github/default-rules.js.map +1 -1
  59. package/dist/integrations/github/intake-lookup.d.ts +16 -0
  60. package/dist/integrations/github/intake-lookup.d.ts.map +1 -0
  61. package/dist/integrations/github/intake-lookup.js +76 -0
  62. package/dist/integrations/github/intake-lookup.js.map +1 -0
  63. package/dist/integrations/github/integration.d.ts +19 -5
  64. package/dist/integrations/github/integration.d.ts.map +1 -1
  65. package/dist/integrations/github/integration.js +21 -6
  66. package/dist/integrations/github/integration.js.map +1 -1
  67. package/dist/integrations/github/issue-intake.d.ts +15 -0
  68. package/dist/integrations/github/issue-intake.d.ts.map +1 -0
  69. package/dist/integrations/github/issue-intake.js +50 -0
  70. package/dist/integrations/github/issue-intake.js.map +1 -0
  71. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  72. package/dist/integrations/github/issue-reconciler.js +10 -1
  73. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  74. package/dist/integrations/github/review-status-reporter.js +1 -1
  75. package/dist/integrations/github/routes.d.ts.map +1 -1
  76. package/dist/integrations/github/routes.js +14 -2
  77. package/dist/integrations/github/routes.js.map +1 -1
  78. package/dist/integrations/github/rules.d.ts +14 -1
  79. package/dist/integrations/github/rules.d.ts.map +1 -1
  80. package/dist/integrations/github/rules.js +221 -30
  81. package/dist/integrations/github/rules.js.map +1 -1
  82. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  83. package/dist/integrations/github/sandbox.js +30 -4
  84. package/dist/integrations/github/sandbox.js.map +1 -1
  85. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  86. package/dist/integrations/gitlab/default-rules.js +19 -3
  87. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  88. package/dist/integrations/gitlab/intake-lookup.d.ts +17 -0
  89. package/dist/integrations/gitlab/intake-lookup.d.ts.map +1 -0
  90. package/dist/integrations/gitlab/intake-lookup.js +85 -0
  91. package/dist/integrations/gitlab/intake-lookup.js.map +1 -0
  92. package/dist/integrations/gitlab/integration.d.ts +5 -0
  93. package/dist/integrations/gitlab/integration.d.ts.map +1 -1
  94. package/dist/integrations/gitlab/integration.js +21 -1
  95. package/dist/integrations/gitlab/integration.js.map +1 -1
  96. package/dist/integrations/gitlab/rules.d.ts +20 -0
  97. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  98. package/dist/integrations/gitlab/rules.js +108 -12
  99. package/dist/integrations/gitlab/rules.js.map +1 -1
  100. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  101. package/dist/integrations/incidentio/rules.js +14 -4
  102. package/dist/integrations/incidentio/rules.js.map +1 -1
  103. package/dist/integrations/jira/rules.d.ts.map +1 -1
  104. package/dist/integrations/jira/rules.js +12 -2
  105. package/dist/integrations/jira/rules.js.map +1 -1
  106. package/dist/integrations/linear/rules.d.ts.map +1 -1
  107. package/dist/integrations/linear/rules.js +13 -2
  108. package/dist/integrations/linear/rules.js.map +1 -1
  109. package/dist/integrations/platform/connect/routes.d.ts +43 -1
  110. package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
  111. package/dist/integrations/platform/connect/routes.js +82 -7
  112. package/dist/integrations/platform/connect/routes.js.map +1 -1
  113. package/dist/integrations/platform/connect/session-tools.d.ts +12 -0
  114. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -1
  115. package/dist/integrations/platform/connect/session-tools.js +28 -10
  116. package/dist/integrations/platform/connect/session-tools.js.map +1 -1
  117. package/dist/integrations/platform/github/event-worker.js +9 -1
  118. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  119. package/dist/integrations/platform/github/integration.d.ts +6 -6
  120. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  121. package/dist/integrations/platform/github/integration.js +22 -3
  122. package/dist/integrations/platform/github/integration.js.map +1 -1
  123. package/dist/integrations/platform/vanta/integration.d.ts.map +1 -1
  124. package/dist/integrations/platform/vanta/integration.js +3 -3
  125. package/dist/integrations/platform/vanta/integration.js.map +1 -1
  126. package/dist/integrations/pull-request-head.d.ts +1 -1
  127. package/dist/integrations/pull-request-head.d.ts.map +1 -1
  128. package/dist/integrations/pull-request-head.js +5 -0
  129. package/dist/integrations/pull-request-head.js.map +1 -1
  130. package/dist/integrations/vanta/rules.js +1 -1
  131. package/dist/integrations/vanta/rules.js.map +1 -1
  132. package/dist/integrations/vanta/sync.d.ts +9 -0
  133. package/dist/integrations/vanta/sync.d.ts.map +1 -1
  134. package/dist/integrations/vanta/sync.js +10 -1
  135. package/dist/integrations/vanta/sync.js.map +1 -1
  136. package/dist/routes/board-snapshot.d.ts +13 -6
  137. package/dist/routes/board-snapshot.d.ts.map +1 -1
  138. package/dist/routes/board-snapshot.js +42 -20
  139. package/dist/routes/board-snapshot.js.map +1 -1
  140. package/dist/routes/boards.js.map +1 -1
  141. package/dist/routes/config.d.ts +17 -2
  142. package/dist/routes/config.d.ts.map +1 -1
  143. package/dist/routes/config.js +247 -77
  144. package/dist/routes/config.js.map +1 -1
  145. package/dist/routes/contracts.d.ts +1294 -7
  146. package/dist/routes/contracts.d.ts.map +1 -1
  147. package/dist/routes/contracts.js +603 -20
  148. package/dist/routes/contracts.js.map +1 -1
  149. package/dist/routes/custom-endpoint-url.d.ts +8 -0
  150. package/dist/routes/custom-endpoint-url.d.ts.map +1 -0
  151. package/dist/routes/custom-endpoint-url.js +45 -0
  152. package/dist/routes/custom-endpoint-url.js.map +1 -0
  153. package/dist/routes/custom-provider-source.d.ts +24 -8
  154. package/dist/routes/custom-provider-source.d.ts.map +1 -1
  155. package/dist/routes/custom-provider-source.js +93 -43
  156. package/dist/routes/custom-provider-source.js.map +1 -1
  157. package/dist/routes/intake-check.d.ts +92 -0
  158. package/dist/routes/intake-check.d.ts.map +1 -0
  159. package/dist/routes/intake-check.js +322 -0
  160. package/dist/routes/intake-check.js.map +1 -0
  161. package/dist/routes/intake-routes.d.ts +10 -2
  162. package/dist/routes/intake-routes.d.ts.map +1 -1
  163. package/dist/routes/intake-routes.js +292 -11
  164. package/dist/routes/intake-routes.js.map +1 -1
  165. package/dist/routes/intake.d.ts +6 -0
  166. package/dist/routes/intake.d.ts.map +1 -1
  167. package/dist/routes/intake.js +20 -0
  168. package/dist/routes/intake.js.map +1 -1
  169. package/dist/routes/mastra-gateway.d.ts.map +1 -1
  170. package/dist/routes/mastra-gateway.js +3 -2
  171. package/dist/routes/mastra-gateway.js.map +1 -1
  172. package/dist/routes/project-sessions.d.ts +61 -0
  173. package/dist/routes/project-sessions.d.ts.map +1 -0
  174. package/dist/routes/project-sessions.js +135 -0
  175. package/dist/routes/project-sessions.js.map +1 -0
  176. package/dist/routes/projects.d.ts +6 -1
  177. package/dist/routes/projects.d.ts.map +1 -1
  178. package/dist/routes/projects.js +19 -3
  179. package/dist/routes/projects.js.map +1 -1
  180. package/dist/routes/provider-credentials.d.ts +10 -1
  181. package/dist/routes/provider-credentials.d.ts.map +1 -1
  182. package/dist/routes/provider-credentials.js +13 -16
  183. package/dist/routes/provider-credentials.js.map +1 -1
  184. package/dist/routes/run-queue.d.ts +6 -6
  185. package/dist/routes/run-queue.d.ts.map +1 -1
  186. package/dist/routes/run-queue.js +28 -8
  187. package/dist/routes/run-queue.js.map +1 -1
  188. package/dist/routes/session-rows.d.ts +30 -0
  189. package/dist/routes/session-rows.d.ts.map +1 -0
  190. package/dist/routes/session-rows.js +94 -0
  191. package/dist/routes/session-rows.js.map +1 -0
  192. package/dist/routes/source-control-sessions.d.ts +4 -5
  193. package/dist/routes/source-control-sessions.d.ts.map +1 -1
  194. package/dist/routes/source-control-sessions.js +8 -87
  195. package/dist/routes/source-control-sessions.js.map +1 -1
  196. package/dist/routes/surface.d.ts +16 -1
  197. package/dist/routes/surface.d.ts.map +1 -1
  198. package/dist/routes/surface.js +41 -30
  199. package/dist/routes/surface.js.map +1 -1
  200. package/dist/routes/tenant-credentials.d.ts.map +1 -1
  201. package/dist/routes/tenant-credentials.js +4 -4
  202. package/dist/routes/tenant-credentials.js.map +1 -1
  203. package/dist/routes/work-item-starters.d.ts +1 -0
  204. package/dist/routes/work-item-starters.d.ts.map +1 -1
  205. package/dist/routes/work-item-starters.js +14 -2
  206. package/dist/routes/work-item-starters.js.map +1 -1
  207. package/dist/routes/work-items.d.ts +22 -3
  208. package/dist/routes/work-items.d.ts.map +1 -1
  209. package/dist/routes/work-items.js +124 -48
  210. package/dist/routes/work-items.js.map +1 -1
  211. package/dist/rules/binding-context.d.ts +5 -0
  212. package/dist/rules/binding-context.d.ts.map +1 -1
  213. package/dist/rules/binding-context.js +51 -5
  214. package/dist/rules/binding-context.js.map +1 -1
  215. package/dist/rules/dispatch-errors.js +1 -1
  216. package/dist/rules/dispatch-errors.js.map +1 -1
  217. package/dist/rules/dispatcher.d.ts +39 -7
  218. package/dist/rules/dispatcher.d.ts.map +1 -1
  219. package/dist/rules/dispatcher.js +363 -123
  220. package/dist/rules/dispatcher.js.map +1 -1
  221. package/dist/rules/event-rules.d.ts +69 -1
  222. package/dist/rules/event-rules.d.ts.map +1 -1
  223. package/dist/rules/event-rules.js +151 -5
  224. package/dist/rules/event-rules.js.map +1 -1
  225. package/dist/rules/review-source-tool.js +1 -1
  226. package/dist/rules/rule-group.d.ts +18 -1
  227. package/dist/rules/rule-group.d.ts.map +1 -1
  228. package/dist/rules/rule-group.js +52 -8
  229. package/dist/rules/rule-group.js.map +1 -1
  230. package/dist/rules/run-bearing.d.ts +8 -0
  231. package/dist/rules/run-bearing.d.ts.map +1 -0
  232. package/dist/rules/run-bearing.js +11 -0
  233. package/dist/rules/run-bearing.js.map +1 -0
  234. package/dist/rules/start-coordinator.d.ts +2 -3
  235. package/dist/rules/start-coordinator.d.ts.map +1 -1
  236. package/dist/rules/start-coordinator.js +25 -38
  237. package/dist/rules/start-coordinator.js.map +1 -1
  238. package/dist/rules/tools.js +2 -1
  239. package/dist/rules/tools.js.map +1 -1
  240. package/dist/rules/transition-service.d.ts +16 -0
  241. package/dist/rules/transition-service.d.ts.map +1 -1
  242. package/dist/rules/transition-service.js +34 -10
  243. package/dist/rules/transition-service.js.map +1 -1
  244. package/dist/rules/types.d.ts +18 -5
  245. package/dist/rules/types.d.ts.map +1 -1
  246. package/dist/rules/types.js +2 -1
  247. package/dist/rules/types.js.map +1 -1
  248. package/dist/rules/update-fold.d.ts +32 -0
  249. package/dist/rules/update-fold.d.ts.map +1 -0
  250. package/dist/rules/update-fold.js +60 -0
  251. package/dist/rules/update-fold.js.map +1 -0
  252. package/dist/rules/validation.d.ts.map +1 -1
  253. package/dist/rules/validation.js +54 -6
  254. package/dist/rules/validation.js.map +1 -1
  255. package/dist/sandbox/session-retirement.d.ts +6 -0
  256. package/dist/sandbox/session-retirement.d.ts.map +1 -1
  257. package/dist/sandbox/session-retirement.js +17 -0
  258. package/dist/sandbox/session-retirement.js.map +1 -1
  259. package/dist/session/factory-session.d.ts.map +1 -1
  260. package/dist/session/factory-session.js +2 -1
  261. package/dist/session/factory-session.js.map +1 -1
  262. package/dist/session/live-sessions.d.ts +6 -1
  263. package/dist/session/live-sessions.d.ts.map +1 -1
  264. package/dist/session/live-sessions.js +4 -0
  265. package/dist/session/live-sessions.js.map +1 -1
  266. package/dist/session/resource-migration.d.ts.map +1 -1
  267. package/dist/session/resource-migration.js +2 -3
  268. package/dist/session/resource-migration.js.map +1 -1
  269. package/dist/session/run-audit.d.ts +10 -1
  270. package/dist/session/run-audit.d.ts.map +1 -1
  271. package/dist/session/run-audit.js +9 -1
  272. package/dist/session/run-audit.js.map +1 -1
  273. package/dist/session/self-review-gate.d.ts +26 -2
  274. package/dist/session/self-review-gate.d.ts.map +1 -1
  275. package/dist/session/self-review-gate.js +60 -10
  276. package/dist/session/self-review-gate.js.map +1 -1
  277. package/dist/session/session-row-query.d.ts +25 -0
  278. package/dist/session/session-row-query.d.ts.map +1 -0
  279. package/dist/session/session-row-query.js +47 -0
  280. package/dist/session/session-row-query.js.map +1 -0
  281. package/dist/session/session-row-status.d.ts +16 -0
  282. package/dist/session/session-row-status.d.ts.map +1 -0
  283. package/dist/session/session-row-status.js +14 -0
  284. package/dist/session/session-row-status.js.map +1 -0
  285. package/dist/session/session-row-view.d.ts +13 -0
  286. package/dist/session/session-row-view.d.ts.map +1 -0
  287. package/dist/session/session-row-view.js +118 -0
  288. package/dist/session/session-row-view.js.map +1 -0
  289. package/dist/session/session-rows.d.ts +60 -0
  290. package/dist/session/session-rows.d.ts.map +1 -0
  291. package/dist/session/session-rows.js +307 -0
  292. package/dist/session/session-rows.js.map +1 -0
  293. package/dist/session/session-threads.d.ts.map +1 -1
  294. package/dist/session/session-threads.js +1 -0
  295. package/dist/session/session-threads.js.map +1 -1
  296. package/dist/session/session-unloader.d.ts +101 -0
  297. package/dist/session/session-unloader.d.ts.map +1 -0
  298. package/dist/session/session-unloader.js +278 -0
  299. package/dist/session/session-unloader.js.map +1 -0
  300. package/dist/session/source-control-tools.d.ts +14 -7
  301. package/dist/session/source-control-tools.d.ts.map +1 -1
  302. package/dist/session/source-control-tools.js +10 -2
  303. package/dist/session/source-control-tools.js.map +1 -1
  304. package/dist/session/work-item-repository.d.ts +49 -1
  305. package/dist/session/work-item-repository.d.ts.map +1 -1
  306. package/dist/session/work-item-repository.js +118 -15
  307. package/dist/session/work-item-repository.js.map +1 -1
  308. package/dist/session/work-item-state-processor.d.ts.map +1 -1
  309. package/dist/session/work-item-state-processor.js +44 -8
  310. package/dist/session/work-item-state-processor.js.map +1 -1
  311. package/dist/session-list-changes.d.ts +9 -0
  312. package/dist/session-list-changes.d.ts.map +1 -0
  313. package/dist/session-list-changes.js +54 -0
  314. package/dist/session-list-changes.js.map +1 -0
  315. package/dist/storage/announced-lists.d.ts +14 -0
  316. package/dist/storage/announced-lists.d.ts.map +1 -0
  317. package/dist/storage/announced-lists.js +78 -0
  318. package/dist/storage/announced-lists.js.map +1 -0
  319. package/dist/storage/domains/audit/actions.d.ts +2 -1
  320. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  321. package/dist/storage/domains/audit/actions.js +3 -1
  322. package/dist/storage/domains/audit/actions.js.map +1 -1
  323. package/dist/storage/domains/boards/base.d.ts +163 -15
  324. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  325. package/dist/storage/domains/boards/base.js +440 -48
  326. package/dist/storage/domains/boards/base.js.map +1 -1
  327. package/dist/storage/domains/boards/schemas.d.ts +6 -0
  328. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  329. package/dist/storage/domains/boards/schemas.js +95 -1
  330. package/dist/storage/domains/boards/schemas.js.map +1 -1
  331. package/dist/storage/domains/custom-providers/base.d.ts +62 -19
  332. package/dist/storage/domains/custom-providers/base.d.ts.map +1 -1
  333. package/dist/storage/domains/custom-providers/base.js +131 -100
  334. package/dist/storage/domains/custom-providers/base.js.map +1 -1
  335. package/dist/storage/domains/intake/base.d.ts +25 -7
  336. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  337. package/dist/storage/domains/intake/base.js +83 -19
  338. package/dist/storage/domains/intake/base.js.map +1 -1
  339. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  340. package/dist/storage/domains/projects/base.js +19 -10
  341. package/dist/storage/domains/projects/base.js.map +1 -1
  342. package/dist/storage/domains/source-control/base.d.ts +8 -0
  343. package/dist/storage/domains/source-control/base.d.ts.map +1 -1
  344. package/dist/storage/domains/source-control/base.js +110 -61
  345. package/dist/storage/domains/source-control/base.js.map +1 -1
  346. package/dist/storage/domains/source-control/inmemory.d.ts +4 -0
  347. package/dist/storage/domains/source-control/inmemory.d.ts.map +1 -1
  348. package/dist/storage/domains/source-control/inmemory.js +8 -5
  349. package/dist/storage/domains/source-control/inmemory.js.map +1 -1
  350. package/dist/storage/domains/work-items/base.d.ts +57 -18
  351. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  352. package/dist/storage/domains/work-items/base.js +168 -83
  353. package/dist/storage/domains/work-items/base.js.map +1 -1
  354. package/dist/storage/domains/work-items/cards.d.ts +3 -2
  355. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  356. package/dist/storage/domains/work-items/cards.js +4 -2
  357. package/dist/storage/domains/work-items/cards.js.map +1 -1
  358. package/dist/tools/audit-events-tool.d.ts +2 -2
  359. package/dist/tools/read-tools.d.ts +9 -5
  360. package/dist/tools/read-tools.d.ts.map +1 -1
  361. package/dist/tools/read-tools.js +61 -54
  362. package/dist/tools/read-tools.js.map +1 -1
  363. package/dist/tools/session-tools.d.ts +0 -13
  364. package/dist/tools/session-tools.d.ts.map +1 -1
  365. package/dist/tools/session-tools.js +128 -341
  366. package/dist/tools/session-tools.js.map +1 -1
  367. package/dist/tools/work-item-tools.d.ts +3 -0
  368. package/dist/tools/work-item-tools.d.ts.map +1 -1
  369. package/dist/tools/work-item-tools.js +99 -27
  370. package/dist/tools/work-item-tools.js.map +1 -1
  371. package/dist/work-item-branch.d.ts +4 -0
  372. package/dist/work-item-branch.d.ts.map +1 -1
  373. package/dist/work-item-branch.js +7 -1
  374. package/dist/work-item-branch.js.map +1 -1
  375. package/dist/work-items/card-context-sessions.d.ts +50 -0
  376. package/dist/work-items/card-context-sessions.d.ts.map +1 -0
  377. package/dist/work-items/card-context-sessions.js +84 -0
  378. package/dist/work-items/card-context-sessions.js.map +1 -0
  379. package/dist/work-items/card-reference.d.ts +21 -0
  380. package/dist/work-items/card-reference.d.ts.map +1 -0
  381. package/dist/work-items/card-reference.js +58 -0
  382. package/dist/work-items/card-reference.js.map +1 -0
  383. package/dist/work-items/change-requests.d.ts +87 -0
  384. package/dist/work-items/change-requests.d.ts.map +1 -0
  385. package/dist/work-items/change-requests.js +134 -0
  386. package/dist/work-items/change-requests.js.map +1 -0
  387. package/dist/work-items/create-work-item.d.ts +7 -2
  388. package/dist/work-items/create-work-item.d.ts.map +1 -1
  389. package/dist/work-items/create-work-item.js +44 -13
  390. package/dist/work-items/create-work-item.js.map +1 -1
  391. package/dist/work-items/list-related-cards.d.ts.map +1 -1
  392. package/dist/work-items/list-related-cards.js +1 -1
  393. package/dist/work-items/list-related-cards.js.map +1 -1
  394. package/dist/work-items/providers/github.d.ts.map +1 -1
  395. package/dist/work-items/providers/github.js +1 -0
  396. package/dist/work-items/providers/github.js.map +1 -1
  397. package/factory-skills/factory-build/SKILL.md +1 -1
  398. package/factory-skills/factory-plan/SKILL.md +5 -3
  399. package/factory-skills/factory-self-review/SKILL.md +2 -0
  400. package/factory-skills/factory-triage/SKILL.md +1 -1
  401. package/package.json +10 -10
@@ -0,0 +1,278 @@
1
+ // src/session/session-unloader.ts
2
+ /**
3
+ * Whether the session's sandbox runs a process its process manager tracks, such as a dev server
4
+ * the agent started. The handle lives in this process: a reloaded session gets a new sandbox
5
+ * object that no longer lists it, so the agent could neither read its output nor stop it.
6
+ * Only a running sandbox is asked, because listing would start a stopped one. Rejects when
7
+ * the sandbox cannot be asked.
8
+ */
9
+ async function hasRunningProcess(session) {
10
+ const sandbox = session.getWorkspace?.()?.sandbox;
11
+ if (sandbox?.status !== "running" || !sandbox.processes) return false;
12
+ return (await sandbox.processes.list()).some((process) => process.running);
13
+ }
14
+ /**
15
+ * Whether a session holds work only this process can finish: a run in flight, or a tool
16
+ * parked on an answer. Both live in memory, so a session holding work must stay loaded.
17
+ */
18
+ function sessionHoldsWork(session) {
19
+ return session.suspensions.hasPending() || session.run.isRunning();
20
+ }
21
+ const DEFAULT_IDLE_SESSION_UNLOAD_MS = 18e5;
22
+ const DEFAULT_IDLE_SESSION_SWEEP_INTERVAL_MS = 6e4;
23
+ /**
24
+ * Unloads controller sessions this process no longer needs, so their in-memory state (display
25
+ * state, workspace, bus) can be collected. The controller keeps every session it creates until
26
+ * the host deletes it; unloading is that delete, which keeps the thread, its messages, the
27
+ * session row and the sandbox VM. The next request, run or wake for the session creates it
28
+ * again from storage, as after a restart.
29
+ *
30
+ * A session is never unloaded while it runs, holds a parked tool, or has an event stream open:
31
+ * all three exist only in this process. Membership comes from the controller's notifications,
32
+ * so a session this process never loaded (another replica's) is never touched.
33
+ */
34
+ var SessionUnloader = class {
35
+ #controller;
36
+ #invalidateSession;
37
+ #settle;
38
+ #idleMs;
39
+ #sweepIntervalMs;
40
+ #now;
41
+ #warn;
42
+ #byId = /* @__PURE__ */ new Map();
43
+ /** Streams opened before the session finished loading, counted until it is tracked. */
44
+ #pendingWatchers = /* @__PURE__ */ new Map();
45
+ #unsubscribes = [];
46
+ #timer;
47
+ #sweeping;
48
+ constructor(options) {
49
+ this.#controller = options.controller;
50
+ this.#invalidateSession = options.invalidateSession ?? (() => {});
51
+ this.#settle = options.settle ?? (async () => {});
52
+ this.#idleMs = options.idleMs ?? 18e5;
53
+ this.#sweepIntervalMs = options.sweepIntervalMs ?? 6e4;
54
+ if (!Number.isFinite(this.#idleMs) || this.#idleMs < 0) throw new Error(`idleSessionUnload.idleMs must be a non-negative number of milliseconds, got ${this.#idleMs}`);
55
+ if (!Number.isFinite(this.#sweepIntervalMs) || this.#sweepIntervalMs <= 0) throw new Error(`idleSessionUnload.sweepIntervalMs must be a positive number of milliseconds, got ${this.#sweepIntervalMs}`);
56
+ this.#now = options.now ?? Date.now;
57
+ this.#warn = options.warn ?? ((message, details) => console.warn(`[Mastra Factory] ${message}`, details));
58
+ this.#unsubscribes.push(this.#controller.onSessionCreated((session) => this.#track(session)), this.#controller.onSessionDeleted((session) => this.#untrack(session)));
59
+ }
60
+ #track(session) {
61
+ const id = session.identity.getId();
62
+ this.#byId.get(id)?.unsubscribe();
63
+ const tracked = {
64
+ session,
65
+ lastActiveAt: this.#now(),
66
+ watchers: this.#pendingWatchers.get(id) ?? 0,
67
+ unloadWhenIdle: false,
68
+ unloading: false,
69
+ unsubscribe: () => {}
70
+ };
71
+ this.#pendingWatchers.delete(id);
72
+ tracked.unsubscribe = session.subscribe((event) => {
73
+ tracked.lastActiveAt = this.#now();
74
+ if (event.type === "agent_start") tracked.unloadWhenIdle = false;
75
+ });
76
+ this.#byId.set(id, tracked);
77
+ }
78
+ #untrack(session) {
79
+ const id = session.identity.getId();
80
+ const tracked = this.#byId.get(id);
81
+ if (tracked?.session !== session) return;
82
+ tracked.unsubscribe();
83
+ this.#byId.delete(id);
84
+ if (tracked.watchers > 0) this.#pendingWatchers.set(id, tracked.watchers);
85
+ }
86
+ /** Start sweeping. With a non-positive `idleMs` the sweep only unloads released sessions. */
87
+ start() {
88
+ if (this.#timer) return;
89
+ this.#timer = setInterval(() => void this.sweep(), this.#sweepIntervalMs);
90
+ this.#timer.unref?.();
91
+ }
92
+ async stop() {
93
+ if (this.#timer) clearInterval(this.#timer);
94
+ this.#timer = void 0;
95
+ for (const unsubscribe of this.#unsubscribes.splice(0)) unsubscribe();
96
+ for (const tracked of this.#byId.values()) tracked.unsubscribe();
97
+ this.#byId.clear();
98
+ this.#pendingWatchers.clear();
99
+ await this.#sweeping;
100
+ }
101
+ /** Whether the session is loaded in this process. */
102
+ isLoaded(sessionId) {
103
+ return this.#byId.has(sessionId);
104
+ }
105
+ /** Mark activity that reaches the session without an event, such as a request addressing it. */
106
+ touch(sessionId) {
107
+ const tracked = this.#byId.get(sessionId);
108
+ if (tracked) tracked.lastActiveAt = this.#now();
109
+ }
110
+ /** Count an open event stream on the session; call the returned function when it closes. */
111
+ watch(sessionId) {
112
+ const tracked = this.#byId.get(sessionId);
113
+ if (tracked) tracked.watchers += 1;
114
+ else this.#pendingWatchers.set(sessionId, (this.#pendingWatchers.get(sessionId) ?? 0) + 1);
115
+ let released = false;
116
+ return () => {
117
+ if (released) return;
118
+ released = true;
119
+ const current = this.#byId.get(sessionId);
120
+ if (current && current.watchers > 0) {
121
+ current.watchers -= 1;
122
+ current.lastActiveAt = this.#now();
123
+ return;
124
+ }
125
+ const pending = (this.#pendingWatchers.get(sessionId) ?? 0) - 1;
126
+ if (pending > 0) this.#pendingWatchers.set(sessionId, pending);
127
+ else this.#pendingWatchers.delete(sessionId);
128
+ };
129
+ }
130
+ /**
131
+ * Unload the session now its sandbox was stopped or released. A session still holding work, or
132
+ * followed by an open stream, is unloaded on the first sweep after it goes idle instead, unless
133
+ * it starts a new run first.
134
+ */
135
+ async unloadReleased(sessionId) {
136
+ const tracked = this.#byId.get(sessionId);
137
+ if (!tracked) return "not-loaded";
138
+ const idleSince = tracked.lastActiveAt;
139
+ tracked.unloadWhenIdle = true;
140
+ if (!this.#inUse(tracked)) {
141
+ if (await this.#unload(tracked, () => !this.#inUse(tracked) && tracked.lastActiveAt === idleSince)) return "unloaded";
142
+ if (this.#byId.get(sessionId) !== tracked) return "not-loaded";
143
+ }
144
+ return "deferred";
145
+ }
146
+ /** Unload every session idle past `idleMs`, and every released one now idle. Resolves how many were unloaded. */
147
+ sweep() {
148
+ this.#sweeping ??= this.#sweep().finally(() => {
149
+ this.#sweeping = void 0;
150
+ });
151
+ return this.#sweeping;
152
+ }
153
+ async #sweep() {
154
+ const now = this.#now();
155
+ const due = [];
156
+ for (const tracked of this.#byId.values()) {
157
+ if (tracked.unloading) continue;
158
+ if (this.#inUse(tracked)) {
159
+ tracked.lastActiveAt = now;
160
+ continue;
161
+ }
162
+ const idleFor = now - tracked.lastActiveAt;
163
+ if (tracked.unloadWhenIdle || this.#idleMs > 0 && idleFor >= this.#idleMs) due.push({
164
+ tracked,
165
+ idleSince: tracked.lastActiveAt
166
+ });
167
+ }
168
+ let unloaded = 0;
169
+ for (const { tracked, idleSince } of due) {
170
+ if (!tracked.unloadWhenIdle && await this.#runsProcess(tracked.session)) {
171
+ if (tracked.lastActiveAt === idleSince) tracked.lastActiveAt = this.#now();
172
+ continue;
173
+ }
174
+ const stillIdle = () => !this.#inUse(tracked) && tracked.lastActiveAt === idleSince;
175
+ if (await this.#unload(tracked, stillIdle)) unloaded += 1;
176
+ }
177
+ return unloaded;
178
+ }
179
+ /** A sandbox that cannot be asked counts as running one: unloading would lose the handle for good. */
180
+ async #runsProcess(session) {
181
+ try {
182
+ return await hasRunningProcess(session);
183
+ } catch (error) {
184
+ this.#warn("Factory session kept loaded: its sandbox processes could not be listed", {
185
+ sessionId: session.identity.getId(),
186
+ error: error instanceof Error ? error.message : String(error)
187
+ });
188
+ return true;
189
+ }
190
+ }
191
+ #inUse(tracked) {
192
+ return tracked.watchers > 0 || tracked.session.stream.isActive() || sessionHoldsWork(tracked.session);
193
+ }
194
+ async #unload(tracked, stillIdle) {
195
+ const sessionId = tracked.session.identity.getId();
196
+ if (tracked.unloading || this.#byId.get(sessionId) !== tracked || !stillIdle()) return false;
197
+ tracked.unloading = true;
198
+ try {
199
+ await this.#settle(tracked.session);
200
+ if (this.#byId.get(sessionId) !== tracked || !stillIdle()) return false;
201
+ await this.#invalidateSession(sessionId);
202
+ if (this.#byId.get(sessionId) !== tracked || !stillIdle()) return false;
203
+ return await this.#controller.deleteSession({ sessionId });
204
+ } catch (error) {
205
+ this.#warn("Factory session unload failed", {
206
+ sessionId,
207
+ error: error instanceof Error ? error.message : String(error)
208
+ });
209
+ return false;
210
+ } finally {
211
+ tracked.unloading = false;
212
+ }
213
+ }
214
+ };
215
+ const SESSION_PATH = /\/agent-controller\/[^/]+\/sessions\/([^/]+)/;
216
+ const SESSION_STREAM_PATH = /\/agent-controller\/[^/]+\/sessions\/[^/]+\/stream\/?$/;
217
+ function decodeSegment(segment) {
218
+ try {
219
+ return decodeURIComponent(segment);
220
+ } catch {
221
+ return segment;
222
+ }
223
+ }
224
+ /** The same body, calling `onClose` once when it ends, errors, or the reader cancels it. */
225
+ function closingWith(body, onClose) {
226
+ const reader = body.getReader();
227
+ return new ReadableStream({
228
+ async pull(controller) {
229
+ try {
230
+ const { done, value } = await reader.read();
231
+ if (done) {
232
+ onClose();
233
+ controller.close();
234
+ return;
235
+ }
236
+ controller.enqueue(value);
237
+ } catch (error) {
238
+ onClose();
239
+ controller.error(error);
240
+ }
241
+ },
242
+ async cancel(reason) {
243
+ onClose();
244
+ await reader.cancel(reason);
245
+ }
246
+ });
247
+ }
248
+ /**
249
+ * Reports controller session requests to the unloader: every request addressing a session counts
250
+ * as activity, and an open event stream keeps the session loaded until it closes.
251
+ */
252
+ function createSessionActivityMiddleware(unloader) {
253
+ return async (c, next) => {
254
+ const sessions = unloader();
255
+ const match = sessions ? SESSION_PATH.exec(c.req.path) : null;
256
+ if (!sessions || !match) return next();
257
+ const sessionId = decodeSegment(match[1]);
258
+ sessions.touch(sessionId);
259
+ if (c.req.method !== "GET" || !SESSION_STREAM_PATH.test(c.req.path)) return next();
260
+ const release = sessions.watch(sessionId);
261
+ c.req.raw.signal.addEventListener("abort", release, { once: true });
262
+ try {
263
+ await next();
264
+ } catch (error) {
265
+ release();
266
+ throw error;
267
+ }
268
+ const body = c.res.body;
269
+ if (!body || !c.res.ok) {
270
+ release();
271
+ return;
272
+ }
273
+ c.res = new Response(closingWith(body, release), c.res);
274
+ };
275
+ }
276
+ export { DEFAULT_IDLE_SESSION_SWEEP_INTERVAL_MS, DEFAULT_IDLE_SESSION_UNLOAD_MS, SessionUnloader, createSessionActivityMiddleware, sessionHoldsWork };
277
+
278
+ //# sourceMappingURL=session-unloader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-unloader.js","names":[],"sources":["../../src/session/session-unloader.ts"],"sourcesContent":["import type { AgentControllerEvent } from '@mastra/core/agent-controller';\nimport type { MiddlewareHandler } from 'hono';\n\n/** The slice of a live session the unloader reads: its id, its run, its parked tools, and its events. */\nexport interface UnloadableSession {\n readonly identity: { getId(): string };\n readonly run: { isRunning(): boolean };\n readonly stream: { isActive(): boolean };\n readonly suspensions: { hasPending(): boolean };\n getWorkspace?(): UnloadableWorkspace | undefined;\n subscribe(listener: (event: AgentControllerEvent) => void): () => void;\n}\n\ninterface UnloadableWorkspace {\n readonly sandbox?: {\n readonly status?: string;\n readonly processes?: { list(): Promise<Array<{ running: boolean }>> };\n };\n}\n\n/**\n * Whether the session's sandbox runs a process its process manager tracks, such as a dev server\n * the agent started. The handle lives in this process: a reloaded session gets a new sandbox\n * object that no longer lists it, so the agent could neither read its output nor stop it.\n * Only a running sandbox is asked, because listing would start a stopped one. Rejects when\n * the sandbox cannot be asked.\n */\nasync function hasRunningProcess(session: UnloadableSession): Promise<boolean> {\n const sandbox = session.getWorkspace?.()?.sandbox;\n if (sandbox?.status !== 'running' || !sandbox.processes) return false;\n return (await sandbox.processes.list()).some(process => process.running);\n}\n\nexport interface UnloadableController {\n onSessionCreated(listener: (session: UnloadableSession) => void): () => void;\n onSessionDeleted(listener: (session: UnloadableSession) => void): () => void;\n deleteSession(input: { sessionId: string }): Promise<boolean>;\n}\n\n/**\n * Whether a session holds work only this process can finish: a run in flight, or a tool\n * parked on an answer. Both live in memory, so a session holding work must stay loaded.\n */\nexport function sessionHoldsWork(session: Pick<UnloadableSession, 'run' | 'suspensions'>): boolean {\n return session.suspensions.hasPending() || session.run.isRunning();\n}\n\nexport interface IdleSessionUnloadOptions {\n /**\n * How long a session goes without activity before it is unloaded. Default: 30 minutes.\n * `0` turns the idle sweep off while still unloading sessions whose sandbox Factory stops.\n */\n idleMs?: number;\n /** How often idle sessions are looked for. Default: 1 minute. */\n sweepIntervalMs?: number;\n}\n\nexport const DEFAULT_IDLE_SESSION_UNLOAD_MS = 30 * 60_000;\nexport const DEFAULT_IDLE_SESSION_SWEEP_INTERVAL_MS = 60_000;\n\nexport interface SessionUnloaderOptions extends IdleSessionUnloadOptions {\n controller: UnloadableController;\n /** Drops what Factory keeps for the session outside the controller: its workspaces and sandbox handle. */\n invalidateSession?: (sessionId: string) => Promise<void> | void;\n /** Resolves once writes Factory makes through the session after a run, such as its run-end audit, are done. */\n settle?: (session: UnloadableSession) => Promise<void>;\n now?: () => number;\n warn?: (message: string, details: Record<string, unknown>) => void;\n}\n\ninterface TrackedSession {\n session: UnloadableSession;\n lastActiveAt: number;\n /** Open event streams (a browser tab following the session). */\n watchers: number;\n /** Its sandbox was released while it still held work: unload once it is idle. */\n unloadWhenIdle: boolean;\n unloading: boolean;\n unsubscribe: () => void;\n}\n\nexport type SessionUnloadResult = 'unloaded' | 'deferred' | 'not-loaded';\n\n/**\n * Unloads controller sessions this process no longer needs, so their in-memory state (display\n * state, workspace, bus) can be collected. The controller keeps every session it creates until\n * the host deletes it; unloading is that delete, which keeps the thread, its messages, the\n * session row and the sandbox VM. The next request, run or wake for the session creates it\n * again from storage, as after a restart.\n *\n * A session is never unloaded while it runs, holds a parked tool, or has an event stream open:\n * all three exist only in this process. Membership comes from the controller's notifications,\n * so a session this process never loaded (another replica's) is never touched.\n */\nexport class SessionUnloader {\n readonly #controller: UnloadableController;\n readonly #invalidateSession: (sessionId: string) => Promise<void> | void;\n readonly #settle: (session: UnloadableSession) => Promise<void>;\n readonly #idleMs: number;\n readonly #sweepIntervalMs: number;\n readonly #now: () => number;\n readonly #warn: NonNullable<SessionUnloaderOptions['warn']>;\n readonly #byId = new Map<string, TrackedSession>();\n /** Streams opened before the session finished loading, counted until it is tracked. */\n readonly #pendingWatchers = new Map<string, number>();\n readonly #unsubscribes: Array<() => void> = [];\n #timer: ReturnType<typeof setInterval> | undefined;\n #sweeping: Promise<number> | undefined;\n\n constructor(options: SessionUnloaderOptions) {\n this.#controller = options.controller;\n this.#invalidateSession = options.invalidateSession ?? (() => {});\n this.#settle = options.settle ?? (async () => {});\n this.#idleMs = options.idleMs ?? DEFAULT_IDLE_SESSION_UNLOAD_MS;\n this.#sweepIntervalMs = options.sweepIntervalMs ?? DEFAULT_IDLE_SESSION_SWEEP_INTERVAL_MS;\n if (!Number.isFinite(this.#idleMs) || this.#idleMs < 0) {\n throw new Error(`idleSessionUnload.idleMs must be a non-negative number of milliseconds, got ${this.#idleMs}`);\n }\n if (!Number.isFinite(this.#sweepIntervalMs) || this.#sweepIntervalMs <= 0) {\n throw new Error(\n `idleSessionUnload.sweepIntervalMs must be a positive number of milliseconds, got ${this.#sweepIntervalMs}`,\n );\n }\n this.#now = options.now ?? Date.now;\n this.#warn = options.warn ?? ((message, details) => console.warn(`[Mastra Factory] ${message}`, details));\n this.#unsubscribes.push(\n this.#controller.onSessionCreated(session => this.#track(session)),\n this.#controller.onSessionDeleted(session => this.#untrack(session)),\n );\n }\n\n #track(session: UnloadableSession): void {\n const id = session.identity.getId();\n this.#byId.get(id)?.unsubscribe();\n const tracked: TrackedSession = {\n session,\n lastActiveAt: this.#now(),\n watchers: this.#pendingWatchers.get(id) ?? 0,\n unloadWhenIdle: false,\n unloading: false,\n unsubscribe: () => {},\n };\n this.#pendingWatchers.delete(id);\n tracked.unsubscribe = session.subscribe(event => {\n tracked.lastActiveAt = this.#now();\n // A new run means someone is using the session again.\n if (event.type === 'agent_start') tracked.unloadWhenIdle = false;\n });\n this.#byId.set(id, tracked);\n }\n\n #untrack(session: UnloadableSession): void {\n const id = session.identity.getId();\n const tracked = this.#byId.get(id);\n if (tracked?.session !== session) return;\n tracked.unsubscribe();\n this.#byId.delete(id);\n // Streams still open on the deleted session follow whichever session takes its id next.\n if (tracked.watchers > 0) this.#pendingWatchers.set(id, tracked.watchers);\n }\n\n /** Start sweeping. With a non-positive `idleMs` the sweep only unloads released sessions. */\n start(): void {\n if (this.#timer) return;\n this.#timer = setInterval(() => void this.sweep(), this.#sweepIntervalMs);\n this.#timer.unref?.();\n }\n\n async stop(): Promise<void> {\n if (this.#timer) clearInterval(this.#timer);\n this.#timer = undefined;\n for (const unsubscribe of this.#unsubscribes.splice(0)) unsubscribe();\n for (const tracked of this.#byId.values()) tracked.unsubscribe();\n this.#byId.clear();\n this.#pendingWatchers.clear();\n await this.#sweeping;\n }\n\n /** Whether the session is loaded in this process. */\n isLoaded(sessionId: string): boolean {\n return this.#byId.has(sessionId);\n }\n\n /** Mark activity that reaches the session without an event, such as a request addressing it. */\n touch(sessionId: string): void {\n const tracked = this.#byId.get(sessionId);\n if (tracked) tracked.lastActiveAt = this.#now();\n }\n\n /** Count an open event stream on the session; call the returned function when it closes. */\n watch(sessionId: string): () => void {\n const tracked = this.#byId.get(sessionId);\n if (tracked) tracked.watchers += 1;\n else this.#pendingWatchers.set(sessionId, (this.#pendingWatchers.get(sessionId) ?? 0) + 1);\n let released = false;\n return () => {\n if (released) return;\n released = true;\n const current = this.#byId.get(sessionId);\n if (current && current.watchers > 0) {\n current.watchers -= 1;\n current.lastActiveAt = this.#now();\n return;\n }\n const pending = (this.#pendingWatchers.get(sessionId) ?? 0) - 1;\n if (pending > 0) this.#pendingWatchers.set(sessionId, pending);\n else this.#pendingWatchers.delete(sessionId);\n };\n }\n\n /**\n * Unload the session now its sandbox was stopped or released. A session still holding work, or\n * followed by an open stream, is unloaded on the first sweep after it goes idle instead, unless\n * it starts a new run first.\n */\n async unloadReleased(sessionId: string): Promise<SessionUnloadResult> {\n const tracked = this.#byId.get(sessionId);\n if (!tracked) return 'not-loaded';\n const idleSince = tracked.lastActiveAt;\n // Marked before the unload awaits, so a run starting meanwhile still cancels the release.\n tracked.unloadWhenIdle = true;\n if (!this.#inUse(tracked)) {\n // Anything that touched the session since, such as its run's end, leaves it to the sweep.\n if (await this.#unload(tracked, () => !this.#inUse(tracked) && tracked.lastActiveAt === idleSince)) {\n return 'unloaded';\n }\n if (this.#byId.get(sessionId) !== tracked) return 'not-loaded';\n }\n return 'deferred';\n }\n\n /** Unload every session idle past `idleMs`, and every released one now idle. Resolves how many were unloaded. */\n sweep(): Promise<number> {\n this.#sweeping ??= this.#sweep().finally(() => {\n this.#sweeping = undefined;\n });\n return this.#sweeping;\n }\n\n async #sweep(): Promise<number> {\n const now = this.#now();\n const due: Array<{ tracked: TrackedSession; idleSince: number }> = [];\n for (const tracked of this.#byId.values()) {\n if (tracked.unloading) continue;\n if (this.#inUse(tracked)) {\n // The idle clock starts once the work ends, not when the work started.\n tracked.lastActiveAt = now;\n continue;\n }\n const idleFor = now - tracked.lastActiveAt;\n if (tracked.unloadWhenIdle || (this.#idleMs > 0 && idleFor >= this.#idleMs)) {\n due.push({ tracked, idleSince: tracked.lastActiveAt });\n }\n }\n let unloaded = 0;\n for (const { tracked, idleSince } of due) {\n // A released session's sandbox was stopped with it; an idle one may still run a process.\n if (!tracked.unloadWhenIdle && (await this.#runsProcess(tracked.session))) {\n // Looked at again once another idle timeout has passed, not on every sweep.\n if (tracked.lastActiveAt === idleSince) tracked.lastActiveAt = this.#now();\n continue;\n }\n // Anything that touched the session since it was picked keeps it.\n const stillIdle = () => !this.#inUse(tracked) && tracked.lastActiveAt === idleSince;\n if (await this.#unload(tracked, stillIdle)) unloaded += 1;\n }\n return unloaded;\n }\n\n /** A sandbox that cannot be asked counts as running one: unloading would lose the handle for good. */\n async #runsProcess(session: UnloadableSession): Promise<boolean> {\n try {\n return await hasRunningProcess(session);\n } catch (error) {\n this.#warn('Factory session kept loaded: its sandbox processes could not be listed', {\n sessionId: session.identity.getId(),\n error: error instanceof Error ? error.message : String(error),\n });\n return true;\n }\n }\n\n #inUse(tracked: TrackedSession): boolean {\n return tracked.watchers > 0 || tracked.session.stream.isActive() || sessionHoldsWork(tracked.session);\n }\n\n async #unload(tracked: TrackedSession, stillIdle: () => boolean): Promise<boolean> {\n const sessionId = tracked.session.identity.getId();\n if (tracked.unloading || this.#byId.get(sessionId) !== tracked || !stillIdle()) return false;\n tracked.unloading = true;\n try {\n // Deleting the session unbinds its thread, so writes still going through it would fail.\n await this.#settle(tracked.session);\n if (this.#byId.get(sessionId) !== tracked || !stillIdle()) return false;\n // Factory's caches go first: a request racing the unload then rebuilds them for the\n // session it gets, instead of having them dropped from under it.\n await this.#invalidateSession(sessionId);\n if (this.#byId.get(sessionId) !== tracked || !stillIdle()) return false;\n return await this.#controller.deleteSession({ sessionId });\n } catch (error) {\n this.#warn('Factory session unload failed', {\n sessionId,\n error: error instanceof Error ? error.message : String(error),\n });\n return false;\n } finally {\n tracked.unloading = false;\n }\n }\n}\n\nconst SESSION_PATH = /\\/agent-controller\\/[^/]+\\/sessions\\/([^/]+)/;\nconst SESSION_STREAM_PATH = /\\/agent-controller\\/[^/]+\\/sessions\\/[^/]+\\/stream\\/?$/;\n\nfunction decodeSegment(segment: string): string {\n try {\n return decodeURIComponent(segment);\n } catch {\n return segment;\n }\n}\n\n/** The same body, calling `onClose` once when it ends, errors, or the reader cancels it. */\nfunction closingWith(body: ReadableStream<Uint8Array>, onClose: () => void): ReadableStream<Uint8Array> {\n const reader = body.getReader();\n return new ReadableStream<Uint8Array>({\n async pull(controller) {\n try {\n const { done, value } = await reader.read();\n if (done) {\n onClose();\n controller.close();\n return;\n }\n controller.enqueue(value);\n } catch (error) {\n onClose();\n controller.error(error);\n }\n },\n async cancel(reason) {\n onClose();\n await reader.cancel(reason);\n },\n });\n}\n\n/**\n * Reports controller session requests to the unloader: every request addressing a session counts\n * as activity, and an open event stream keeps the session loaded until it closes.\n */\nexport function createSessionActivityMiddleware(unloader: () => SessionUnloader | undefined): MiddlewareHandler {\n return async (c, next) => {\n const sessions = unloader();\n const match = sessions ? SESSION_PATH.exec(c.req.path) : null;\n if (!sessions || !match) return next();\n const sessionId = decodeSegment(match[1]!);\n sessions.touch(sessionId);\n if (c.req.method !== 'GET' || !SESSION_STREAM_PATH.test(c.req.path)) return next();\n\n const release = sessions.watch(sessionId);\n c.req.raw.signal.addEventListener('abort', release, { once: true });\n try {\n await next();\n } catch (error) {\n release();\n throw error;\n }\n const body = c.res.body;\n if (!body || !c.res.ok) {\n release();\n return;\n }\n c.res = new Response(closingWith(body, release), c.res);\n };\n}\n"],"mappings":"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"}
@@ -3,6 +3,7 @@ import type { CommitCheck, CommitCheckStatus, VersionControl } from '../capabili
3
3
  import type { IntegrationTools } from '../integrations/base.js';
4
4
  import type { AuditAgentEmitter } from '../storage/domains/audit/domain.js';
5
5
  import type { SourceControlStorageHandle } from '../storage/domains/source-control/base.js';
6
+ import type { ChangeTarget } from './self-review-gate.js';
6
7
  export interface SourceControlToolProvider {
7
8
  id: string;
8
9
  storage: SourceControlStorageHandle;
@@ -16,16 +17,22 @@ export declare function verdictEventMismatch(event: ReviewEvent, body: string |
16
17
  * disagree, or `undefined` when absent.
17
18
  */
18
19
  export declare function reviewedHeadFromBody(body: string | undefined): string | null | undefined;
19
- export declare function createSourceControlTools({ requestContext, providers, audit, selfReviewApprovedHead, }: {
20
+ export declare function createSourceControlTools({ requestContext, providers, audit, workItem, }: {
20
21
  requestContext: RequestContext;
21
22
  providers: readonly SourceControlToolProvider[];
22
23
  audit: AuditAgentEmitter;
23
- /**
24
- * Self-review gate for opening a change request. `undefined` means the session
25
- * is not gated (no Work item, or its change request predates Self-review);
26
- * `null` means Self-review has not approved; a SHA is the approved head.
27
- */
28
- selfReviewApprovedHead?: () => Promise<string | null | undefined>;
24
+ /** The session's card, when it is bound to one. */
25
+ workItem?: {
26
+ /**
27
+ * Self-review gate for opening a change request in `target`. `undefined` means
28
+ * it is not gated (no Work item, another repository than the card's, or its
29
+ * change request predates Self-review); `null` means Self-review has not
30
+ * approved; a SHA is the approved head.
31
+ */
32
+ selfReviewApprovedHead(target: ChangeTarget): Promise<string | null | undefined>;
33
+ /** Records `target` as the card's repository when the card names none. */
34
+ recordRepository(sourceControl: SourceControlStorageHandle, target: ChangeTarget): Promise<void>;
35
+ };
29
36
  }): Promise<IntegrationTools>;
30
37
  /** The change request a Review run reviews, as `MastraFactory.reviewedChangeRequest()` returns it to an app tool. */
31
38
  export interface ReviewedChangeRequest {
@@ -1 +1 @@
1
- {"version":3,"file":"source-control-tools.d.ts","sourceRoot":"","sources":["../../src/session/source-control-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAUhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAIV,0BAA0B,EAC3B,MAAM,2CAA2C,CAAC;AAUnD,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,0BAA0B,CAAC;IACpC,cAAc,EAAE,cAAc,CAAC;CAChC;AAcD,KAAK,WAAW,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAE7D,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUrG;AAKD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CASxF;AAuJD,wBAAsB,wBAAwB,CAAC,EAC7C,cAAc,EACd,SAAS,EACT,KAAK,EACL,sBAAsB,GACvB,EAAE;IACD,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAChD,KAAK,EAAE,iBAAiB,CAAC;IACzB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACnE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4d5B;AAED,qHAAqH;AACrH,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,+BAA+B;IAC9C,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,EACjD,cAAc,EACd,SAAS,EACT,oBAAoB,GACrB,EAAE;IACD,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAChD,oBAAoB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACzD,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAmD7C"}
1
+ {"version":3,"file":"source-control-tools.d.ts","sourceRoot":"","sources":["../../src/session/source-control-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAUhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAIV,0BAA0B,EAC3B,MAAM,2CAA2C,CAAC;AAInD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAO1D,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,0BAA0B,CAAC;IACpC,cAAc,EAAE,cAAc,CAAC;CAChC;AAcD,KAAK,WAAW,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAE7D,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUrG;AAKD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CASxF;AA2JD,wBAAsB,wBAAwB,CAAC,EAC7C,cAAc,EACd,SAAS,EACT,KAAK,EACL,QAAQ,GACT,EAAE;IACD,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAChD,KAAK,EAAE,iBAAiB,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,EAAE;QACT;;;;;WAKG;QACH,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;QACjF,0EAA0E;QAC1E,gBAAgB,CAAC,aAAa,EAAE,0BAA0B,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAClG,CAAC;CACH,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8d5B;AAED,qHAAqH;AACrH,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,+BAA+B;IAC9C,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,EACjD,cAAc,EACd,SAAS,EACT,oBAAoB,GACrB,EAAE;IACD,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAChD,oBAAoB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACzD,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAmD7C"}
@@ -144,9 +144,15 @@ async function emitAgentAudit(audit, requestContext, input) {
144
144
  });
145
145
  }
146
146
  }
147
+ function changeTarget(target) {
148
+ return {
149
+ slug: target.repository.slug,
150
+ ownRepository: target.ownRepository
151
+ };
152
+ }
147
153
  const repositorySchema = z.object({ repository: z.string().trim().min(1).optional() });
148
154
  const changeRequestSchema = repositorySchema.extend({ changeRequestId: z.union([z.string().trim().min(1), z.number().int().positive()]) });
149
- async function createSourceControlTools({ requestContext, providers, audit, selfReviewApprovedHead }) {
155
+ async function createSourceControlTools({ requestContext, providers, audit, workItem }) {
150
156
  if (!requestContext || typeof requestContext.get !== "function") return {};
151
157
  const controller = requestContext.get("controller");
152
158
  const identity = authIdentity(requestContext);
@@ -212,6 +218,7 @@ async function createSourceControlTools({ requestContext, providers, audit, self
212
218
  branch
213
219
  });
214
220
  updateSessionEnvironmentRepository(target.session.sessionId, target.repository.slug, { branch });
221
+ await workItem?.recordRepository(target.provider.storage, changeTarget(target));
215
222
  await emitAgentAudit(audit, requestContext, {
216
223
  action: "factory.agent.push",
217
224
  targets: [{
@@ -266,7 +273,7 @@ async function createSourceControlTools({ requestContext, providers, audit, self
266
273
  }),
267
274
  execute: async (input, execution) => {
268
275
  const target = await targetFor(input);
269
- const approvedHead = target.ownRepository ? await selfReviewApprovedHead?.() : void 0;
276
+ const approvedHead = await workItem?.selfReviewApprovedHead(changeTarget(target));
270
277
  if (approvedHead === null) throw new Error("Self-review has not approved this branch. Move the work item to Self-review; the change request opens after it approves.");
271
278
  const baseBranch = target.ownRepository ? target.session.baseBranch : target.projectRepository.branch ?? target.repository.defaultBranch;
272
279
  const created = await target.provider.versionControl.createPullRequest({
@@ -292,6 +299,7 @@ async function createSourceControlTools({ requestContext, providers, audit, self
292
299
  changeRequestUrl: created.url
293
300
  });
294
301
  updateSessionEnvironmentRepository(target.session.sessionId, target.repository.slug, { changeRequestUrl: created.url });
302
+ await workItem?.recordRepository(target.provider.storage, changeTarget(target));
295
303
  await emitAgentAudit(audit, requestContext, {
296
304
  action: "factory.agent.pr_opened",
297
305
  targets: [{