@mastra/factory 0.28.0-alpha.1 → 0.28.0-alpha.11

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 (662) hide show
  1. package/README.md +363 -162
  2. package/dist/auth.d.ts.map +1 -1
  3. package/dist/auth.js +12 -6
  4. package/dist/auth.js.map +1 -1
  5. package/dist/boards/board-events.d.ts +23 -3
  6. package/dist/boards/board-events.d.ts.map +1 -1
  7. package/dist/boards/board-events.js +44 -7
  8. package/dist/boards/board-events.js.map +1 -1
  9. package/dist/boards/board-writes.d.ts +2 -2
  10. package/dist/boards/board-writes.d.ts.map +1 -1
  11. package/dist/boards/board-writes.js +23 -9
  12. package/dist/boards/board-writes.js.map +1 -1
  13. package/dist/boards/card-facts.d.ts +3 -1
  14. package/dist/boards/card-facts.d.ts.map +1 -1
  15. package/dist/boards/card-facts.js +30 -4
  16. package/dist/boards/card-facts.js.map +1 -1
  17. package/dist/boards/default-board.d.ts +7 -0
  18. package/dist/boards/default-board.d.ts.map +1 -0
  19. package/dist/boards/default-board.js +10 -0
  20. package/dist/boards/default-board.js.map +1 -0
  21. package/dist/boards/define-board.d.ts +40 -18
  22. package/dist/boards/define-board.d.ts.map +1 -1
  23. package/dist/boards/define-board.js +64 -42
  24. package/dist/boards/define-board.js.map +1 -1
  25. package/dist/boards/index.d.ts +6 -9
  26. package/dist/boards/index.d.ts.map +1 -1
  27. package/dist/boards/index.js +6 -20
  28. package/dist/boards/intake-routing.d.ts +29 -9
  29. package/dist/boards/intake-routing.d.ts.map +1 -1
  30. package/dist/boards/intake-routing.js +72 -20
  31. package/dist/boards/intake-routing.js.map +1 -1
  32. package/dist/boards/legacy-plan-role.d.ts.map +1 -1
  33. package/dist/boards/legacy-plan-role.js +7 -2
  34. package/dist/boards/legacy-plan-role.js.map +1 -1
  35. package/dist/boards/phase-automation.d.ts +7 -0
  36. package/dist/boards/phase-automation.d.ts.map +1 -1
  37. package/dist/boards/phase-automation.js +16 -5
  38. package/dist/boards/phase-automation.js.map +1 -1
  39. package/dist/boards/phase-runner.d.ts +18 -10
  40. package/dist/boards/phase-runner.d.ts.map +1 -1
  41. package/dist/boards/phase-runner.js +39 -34
  42. package/dist/boards/phase-runner.js.map +1 -1
  43. package/dist/boards/project-boards.d.ts +57 -11
  44. package/dist/boards/project-boards.d.ts.map +1 -1
  45. package/dist/boards/project-boards.js +161 -34
  46. package/dist/boards/project-boards.js.map +1 -1
  47. package/dist/boards/registry.d.ts +7 -1
  48. package/dist/boards/registry.d.ts.map +1 -1
  49. package/dist/boards/registry.js +19 -4
  50. package/dist/boards/registry.js.map +1 -1
  51. package/dist/boards/relocate.d.ts +1 -1
  52. package/dist/boards/relocate.d.ts.map +1 -1
  53. package/dist/boards/relocate.js +3 -2
  54. package/dist/boards/relocate.js.map +1 -1
  55. package/dist/boards/review.d.ts +5 -2
  56. package/dist/boards/review.d.ts.map +1 -1
  57. package/dist/boards/review.js +12 -11
  58. package/dist/boards/review.js.map +1 -1
  59. package/dist/boards/semantics.d.ts +160 -20
  60. package/dist/boards/semantics.d.ts.map +1 -1
  61. package/dist/boards/semantics.js +255 -23
  62. package/dist/boards/semantics.js.map +1 -1
  63. package/dist/boards/stored-board.d.ts +32 -18
  64. package/dist/boards/stored-board.d.ts.map +1 -1
  65. package/dist/boards/stored-board.js +31 -97
  66. package/dist/boards/stored-board.js.map +1 -1
  67. package/dist/boards/work-migrations.d.ts +43 -0
  68. package/dist/boards/work-migrations.d.ts.map +1 -0
  69. package/dist/boards/work-migrations.js +353 -0
  70. package/dist/boards/work-migrations.js.map +1 -0
  71. package/dist/boards/work-routes.d.ts +58 -0
  72. package/dist/boards/work-routes.d.ts.map +1 -0
  73. package/dist/boards/work-routes.js +270 -0
  74. package/dist/boards/work-routes.js.map +1 -0
  75. package/dist/boards/work-seeds.d.ts +9 -0
  76. package/dist/boards/work-seeds.d.ts.map +1 -0
  77. package/dist/boards/work-seeds.js +56 -0
  78. package/dist/boards/work-seeds.js.map +1 -0
  79. package/dist/boards/work.d.ts +8 -19
  80. package/dist/boards/work.d.ts.map +1 -1
  81. package/dist/boards/work.js +33 -281
  82. package/dist/boards/work.js.map +1 -1
  83. package/dist/capabilities/version-control.d.ts +6 -1
  84. package/dist/capabilities/version-control.d.ts.map +1 -1
  85. package/dist/environment/build-runner.d.ts.map +1 -1
  86. package/dist/environment/build-runner.js +2 -2
  87. package/dist/environment/build-runner.js.map +1 -1
  88. package/dist/environment/build-schedule.js +1 -1
  89. package/dist/environment/build-schedule.js.map +1 -1
  90. package/dist/environment/build-workflow.d.ts.map +1 -1
  91. package/dist/environment/build-workflow.js +6 -5
  92. package/dist/environment/build-workflow.js.map +1 -1
  93. package/dist/environment/build.d.ts +17 -4
  94. package/dist/environment/build.d.ts.map +1 -1
  95. package/dist/environment/build.js +35 -10
  96. package/dist/environment/build.js.map +1 -1
  97. package/dist/environment/heads.d.ts +1 -1
  98. package/dist/environment/heads.d.ts.map +1 -1
  99. package/dist/environment/heads.js +4 -1
  100. package/dist/environment/heads.js.map +1 -1
  101. package/dist/environment/repository-access.d.ts +13 -0
  102. package/dist/environment/repository-access.d.ts.map +1 -0
  103. package/dist/environment/repository-access.js +55 -0
  104. package/dist/environment/repository-access.js.map +1 -0
  105. package/dist/factory.d.ts +34 -7
  106. package/dist/factory.d.ts.map +1 -1
  107. package/dist/factory.js +161 -133
  108. package/dist/factory.js.map +1 -1
  109. package/dist/feed-events.d.ts +4 -4
  110. package/dist/feed-events.d.ts.map +1 -1
  111. package/dist/feed-events.js +6 -6
  112. package/dist/feed-events.js.map +1 -1
  113. package/dist/index.d.ts +7 -2
  114. package/dist/index.d.ts.map +1 -1
  115. package/dist/index.js +5 -3
  116. package/dist/integrations/base.d.ts +6 -13
  117. package/dist/integrations/base.d.ts.map +1 -1
  118. package/dist/integrations/closing-references.d.ts +15 -0
  119. package/dist/integrations/closing-references.d.ts.map +1 -0
  120. package/dist/integrations/closing-references.js +69 -0
  121. package/dist/integrations/closing-references.js.map +1 -0
  122. package/dist/integrations/github/default-rules.d.ts +15 -66
  123. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  124. package/dist/integrations/github/default-rules.js +129 -73
  125. package/dist/integrations/github/default-rules.js.map +1 -1
  126. package/dist/integrations/github/integration.d.ts.map +1 -1
  127. package/dist/integrations/github/integration.js +7 -3
  128. package/dist/integrations/github/integration.js.map +1 -1
  129. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  130. package/dist/integrations/github/issue-reconciler.js +5 -3
  131. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  132. package/dist/integrations/github/provenance.js +1 -1
  133. package/dist/integrations/github/provenance.js.map +1 -1
  134. package/dist/integrations/github/pull-request-source.d.ts +8 -0
  135. package/dist/integrations/github/pull-request-source.d.ts.map +1 -0
  136. package/dist/integrations/github/pull-request-source.js +17 -0
  137. package/dist/integrations/github/pull-request-source.js.map +1 -0
  138. package/dist/integrations/github/reconcile-worker.d.ts +5 -1
  139. package/dist/integrations/github/reconcile-worker.d.ts.map +1 -1
  140. package/dist/integrations/github/reconcile-worker.js +39 -6
  141. package/dist/integrations/github/reconcile-worker.js.map +1 -1
  142. package/dist/integrations/github/review-status-reporter.d.ts.map +1 -1
  143. package/dist/integrations/github/review-status-reporter.js +7 -3
  144. package/dist/integrations/github/review-status-reporter.js.map +1 -1
  145. package/dist/integrations/github/routes.d.ts +4 -3
  146. package/dist/integrations/github/routes.d.ts.map +1 -1
  147. package/dist/integrations/github/routes.js +10 -87
  148. package/dist/integrations/github/routes.js.map +1 -1
  149. package/dist/integrations/github/rules.d.ts +79 -7
  150. package/dist/integrations/github/rules.d.ts.map +1 -1
  151. package/dist/integrations/github/rules.js +426 -102
  152. package/dist/integrations/github/rules.js.map +1 -1
  153. package/dist/integrations/github/sandbox.d.ts +10 -2
  154. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  155. package/dist/integrations/github/sandbox.js +20 -4
  156. package/dist/integrations/github/sandbox.js.map +1 -1
  157. package/dist/integrations/github/session-subscriptions.js +2 -2
  158. package/dist/integrations/github/session-subscriptions.js.map +1 -1
  159. package/dist/integrations/github/token-refresh.d.ts +2 -1
  160. package/dist/integrations/github/token-refresh.d.ts.map +1 -1
  161. package/dist/integrations/github/token-refresh.js.map +1 -1
  162. package/dist/integrations/gitlab/agent-tools.js +1 -1
  163. package/dist/integrations/gitlab/default-rules.d.ts +73 -31
  164. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  165. package/dist/integrations/gitlab/default-rules.js +106 -43
  166. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  167. package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
  168. package/dist/integrations/gitlab/issue-reconciler.js +2 -1
  169. package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
  170. package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
  171. package/dist/integrations/gitlab/merge-request-reconciler.js +12 -5
  172. package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
  173. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  174. package/dist/integrations/gitlab/routes.js +1 -3
  175. package/dist/integrations/gitlab/routes.js.map +1 -1
  176. package/dist/integrations/gitlab/rules.d.ts +6 -1
  177. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  178. package/dist/integrations/gitlab/rules.js +119 -30
  179. package/dist/integrations/gitlab/rules.js.map +1 -1
  180. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  181. package/dist/integrations/incidentio/agent-tools.js +6 -6
  182. package/dist/integrations/incidentio/agent-tools.js.map +1 -1
  183. package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
  184. package/dist/integrations/incidentio/default-rules.js +3 -3
  185. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  186. package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
  187. package/dist/integrations/incidentio/issue-reconciler.js +2 -1
  188. package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
  189. package/dist/integrations/incidentio/routes.d.ts +2 -2
  190. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  191. package/dist/integrations/incidentio/routes.js +10 -13
  192. package/dist/integrations/incidentio/routes.js.map +1 -1
  193. package/dist/integrations/incidentio/rules.d.ts +4 -4
  194. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  195. package/dist/integrations/incidentio/rules.js +18 -14
  196. package/dist/integrations/incidentio/rules.js.map +1 -1
  197. package/dist/integrations/issue-reconciler.js +1 -1
  198. package/dist/integrations/issue-reconciler.js.map +1 -1
  199. package/dist/integrations/jira/agent-tools.js +1 -1
  200. package/dist/integrations/jira/binding-scope.d.ts +5 -6
  201. package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
  202. package/dist/integrations/jira/binding-scope.js +9 -11
  203. package/dist/integrations/jira/binding-scope.js.map +1 -1
  204. package/dist/integrations/jira/default-rules.d.ts.map +1 -1
  205. package/dist/integrations/jira/default-rules.js +3 -3
  206. package/dist/integrations/jira/default-rules.js.map +1 -1
  207. package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
  208. package/dist/integrations/jira/issue-reconciler.js +2 -1
  209. package/dist/integrations/jira/issue-reconciler.js.map +1 -1
  210. package/dist/integrations/jira/routes.d.ts.map +1 -1
  211. package/dist/integrations/jira/routes.js +3 -5
  212. package/dist/integrations/jira/routes.js.map +1 -1
  213. package/dist/integrations/jira/rules.d.ts +4 -4
  214. package/dist/integrations/jira/rules.d.ts.map +1 -1
  215. package/dist/integrations/jira/rules.js +18 -14
  216. package/dist/integrations/jira/rules.js.map +1 -1
  217. package/dist/integrations/linear/agent-tools.d.ts +9 -1
  218. package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
  219. package/dist/integrations/linear/agent-tools.js +81 -3
  220. package/dist/integrations/linear/agent-tools.js.map +1 -1
  221. package/dist/integrations/linear/default-rules.d.ts.map +1 -1
  222. package/dist/integrations/linear/default-rules.js +3 -3
  223. package/dist/integrations/linear/default-rules.js.map +1 -1
  224. package/dist/integrations/linear/integration.d.ts +4 -1
  225. package/dist/integrations/linear/integration.d.ts.map +1 -1
  226. package/dist/integrations/linear/integration.js +21 -1
  227. package/dist/integrations/linear/integration.js.map +1 -1
  228. package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
  229. package/dist/integrations/linear/issue-reconciler.js +2 -1
  230. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  231. package/dist/integrations/linear/routes.d.ts +2 -1
  232. package/dist/integrations/linear/routes.d.ts.map +1 -1
  233. package/dist/integrations/linear/routes.js +15 -17
  234. package/dist/integrations/linear/routes.js.map +1 -1
  235. package/dist/integrations/linear/rules.d.ts +4 -4
  236. package/dist/integrations/linear/rules.d.ts.map +1 -1
  237. package/dist/integrations/linear/rules.js +16 -15
  238. package/dist/integrations/linear/rules.js.map +1 -1
  239. package/dist/integrations/platform/connect/session-tools.d.ts +5 -0
  240. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -1
  241. package/dist/integrations/platform/connect/session-tools.js +5 -0
  242. package/dist/integrations/platform/connect/session-tools.js.map +1 -1
  243. package/dist/integrations/platform/github/event-worker.d.ts +4 -1
  244. package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
  245. package/dist/integrations/platform/github/event-worker.js +39 -3
  246. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  247. package/dist/integrations/platform/github/integration.d.ts +8 -0
  248. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  249. package/dist/integrations/platform/github/integration.js +143 -93
  250. package/dist/integrations/platform/github/integration.js.map +1 -1
  251. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  252. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  253. package/dist/integrations/platform/jira/routes.js +3 -5
  254. package/dist/integrations/platform/jira/routes.js.map +1 -1
  255. package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
  256. package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
  257. package/dist/integrations/platform/linear/event-worker.js +1 -1
  258. package/dist/integrations/platform/linear/event-worker.js.map +1 -1
  259. package/dist/integrations/platform/linear/integration.d.ts +1 -1
  260. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  261. package/dist/integrations/platform/linear/integration.js +6 -5
  262. package/dist/integrations/platform/linear/integration.js.map +1 -1
  263. package/dist/integrations/slack/chat-tools.js +1 -1
  264. package/dist/integrations/slack/integration.d.ts +0 -2
  265. package/dist/integrations/slack/integration.d.ts.map +1 -1
  266. package/dist/integrations/slack/integration.js +7 -9
  267. package/dist/integrations/slack/integration.js.map +1 -1
  268. package/dist/integrations/slack/reply-tool.js +1 -1
  269. package/dist/integrations/slack/run-error-card.js +1 -0
  270. package/dist/integrations/slack/run-error-card.js.map +1 -1
  271. package/dist/integrations/slack/share-file-tool.js +1 -1
  272. package/dist/integrations/slack/slack.d.ts +13 -22
  273. package/dist/integrations/slack/slack.d.ts.map +1 -1
  274. package/dist/integrations/slack/slack.js +22 -83
  275. package/dist/integrations/slack/slack.js.map +1 -1
  276. package/dist/links.d.ts +1 -2
  277. package/dist/links.d.ts.map +1 -1
  278. package/dist/links.js +4 -4
  279. package/dist/links.js.map +1 -1
  280. package/dist/mcp/routes.js +3 -3
  281. package/dist/mcp/routes.js.map +1 -1
  282. package/dist/provider-display-name.d.ts.map +1 -1
  283. package/dist/provider-display-name.js +1 -0
  284. package/dist/provider-display-name.js.map +1 -1
  285. package/dist/routes/attention-parked.d.ts +1 -0
  286. package/dist/routes/attention-parked.d.ts.map +1 -1
  287. package/dist/routes/attention-parked.js +2 -2
  288. package/dist/routes/attention-parked.js.map +1 -1
  289. package/dist/routes/attention-providers.d.ts +0 -25
  290. package/dist/routes/attention-providers.d.ts.map +1 -1
  291. package/dist/routes/attention-providers.js +2 -150
  292. package/dist/routes/attention-providers.js.map +1 -1
  293. package/dist/routes/attention.d.ts +0 -2
  294. package/dist/routes/attention.d.ts.map +1 -1
  295. package/dist/routes/attention.js +2 -13
  296. package/dist/routes/attention.js.map +1 -1
  297. package/dist/routes/automation-runs.d.ts +5 -1
  298. package/dist/routes/automation-runs.d.ts.map +1 -1
  299. package/dist/routes/automation-runs.js +15 -0
  300. package/dist/routes/automation-runs.js.map +1 -1
  301. package/dist/routes/board-snapshot.d.ts +21 -0
  302. package/dist/routes/board-snapshot.d.ts.map +1 -0
  303. package/dist/routes/board-snapshot.js +58 -0
  304. package/dist/routes/board-snapshot.js.map +1 -0
  305. package/dist/routes/boards.d.ts +2 -2
  306. package/dist/routes/boards.d.ts.map +1 -1
  307. package/dist/routes/boards.js +1 -17
  308. package/dist/routes/boards.js.map +1 -1
  309. package/dist/routes/config.d.ts +11 -1
  310. package/dist/routes/config.d.ts.map +1 -1
  311. package/dist/routes/config.js +120 -22
  312. package/dist/routes/config.js.map +1 -1
  313. package/dist/routes/contracts.d.ts +257 -51
  314. package/dist/routes/contracts.d.ts.map +1 -1
  315. package/dist/routes/contracts.js +131 -40
  316. package/dist/routes/contracts.js.map +1 -1
  317. package/dist/routes/feed-events.d.ts +15 -0
  318. package/dist/routes/feed-events.d.ts.map +1 -0
  319. package/dist/routes/feed-events.js +68 -0
  320. package/dist/routes/feed-events.js.map +1 -0
  321. package/dist/routes/fs.d.ts +4 -0
  322. package/dist/routes/fs.d.ts.map +1 -1
  323. package/dist/routes/fs.js +8 -4
  324. package/dist/routes/fs.js.map +1 -1
  325. package/dist/routes/intake-routes.d.ts.map +1 -1
  326. package/dist/routes/intake-routes.js +6 -1
  327. package/dist/routes/intake-routes.js.map +1 -1
  328. package/dist/routes/intake.d.ts +0 -23
  329. package/dist/routes/intake.d.ts.map +1 -1
  330. package/dist/routes/intake.js +13 -309
  331. package/dist/routes/intake.js.map +1 -1
  332. package/dist/routes/knowledge.js +1 -1
  333. package/dist/routes/mastra-gateway.d.ts +19 -0
  334. package/dist/routes/mastra-gateway.d.ts.map +1 -0
  335. package/dist/routes/mastra-gateway.js +120 -0
  336. package/dist/routes/mastra-gateway.js.map +1 -0
  337. package/dist/routes/projects.d.ts +1 -1
  338. package/dist/routes/projects.d.ts.map +1 -1
  339. package/dist/routes/projects.js +74 -58
  340. package/dist/routes/projects.js.map +1 -1
  341. package/dist/routes/provider-credentials.d.ts +6 -1
  342. package/dist/routes/provider-credentials.d.ts.map +1 -1
  343. package/dist/routes/provider-credentials.js +42 -7
  344. package/dist/routes/provider-credentials.js.map +1 -1
  345. package/dist/routes/route.d.ts +6 -0
  346. package/dist/routes/route.d.ts.map +1 -1
  347. package/dist/routes/route.js.map +1 -1
  348. package/dist/routes/running-packages.d.ts +13 -0
  349. package/dist/routes/running-packages.d.ts.map +1 -0
  350. package/dist/routes/running-packages.js +45 -0
  351. package/dist/routes/running-packages.js.map +1 -0
  352. package/dist/routes/sandbox-envs.d.ts +26 -0
  353. package/dist/routes/sandbox-envs.d.ts.map +1 -0
  354. package/dist/routes/sandbox-envs.js +180 -0
  355. package/dist/routes/sandbox-envs.js.map +1 -0
  356. package/dist/routes/session-access.d.ts.map +1 -1
  357. package/dist/routes/session-access.js +12 -3
  358. package/dist/routes/session-access.js.map +1 -1
  359. package/dist/routes/surface.d.ts +10 -8
  360. package/dist/routes/surface.d.ts.map +1 -1
  361. package/dist/routes/surface.js +105 -42
  362. package/dist/routes/surface.js.map +1 -1
  363. package/dist/routes/tenant-credentials.d.ts.map +1 -1
  364. package/dist/routes/tenant-credentials.js +5 -1
  365. package/dist/routes/tenant-credentials.js.map +1 -1
  366. package/dist/routes/work-items.d.ts +0 -3
  367. package/dist/routes/work-items.d.ts.map +1 -1
  368. package/dist/routes/work-items.js +94 -12
  369. package/dist/routes/work-items.js.map +1 -1
  370. package/dist/rules/binding-context.d.ts.map +1 -1
  371. package/dist/rules/binding-context.js +1 -0
  372. package/dist/rules/binding-context.js.map +1 -1
  373. package/dist/rules/dispatcher.d.ts +0 -9
  374. package/dist/rules/dispatcher.d.ts.map +1 -1
  375. package/dist/rules/dispatcher.js +362 -69
  376. package/dist/rules/dispatcher.js.map +1 -1
  377. package/dist/rules/event-rules.d.ts +33 -2
  378. package/dist/rules/event-rules.d.ts.map +1 -1
  379. package/dist/rules/event-rules.js +46 -11
  380. package/dist/rules/event-rules.js.map +1 -1
  381. package/dist/rules/index.d.ts +2 -4
  382. package/dist/rules/index.d.ts.map +1 -1
  383. package/dist/rules/index.js +2 -3
  384. package/dist/rules/phase-goal.d.ts +54 -0
  385. package/dist/rules/phase-goal.d.ts.map +1 -0
  386. package/dist/rules/phase-goal.js +70 -0
  387. package/dist/rules/phase-goal.js.map +1 -0
  388. package/dist/rules/phase-tools.d.ts +11 -0
  389. package/dist/rules/phase-tools.d.ts.map +1 -0
  390. package/dist/rules/phase-tools.js +19 -0
  391. package/dist/rules/phase-tools.js.map +1 -0
  392. package/dist/rules/processor.d.ts.map +1 -1
  393. package/dist/rules/processor.js +116 -15
  394. package/dist/rules/processor.js.map +1 -1
  395. package/dist/rules/review-source-tool.d.ts +4 -1
  396. package/dist/rules/review-source-tool.d.ts.map +1 -1
  397. package/dist/rules/review-source-tool.js +24 -4
  398. package/dist/rules/review-source-tool.js.map +1 -1
  399. package/dist/rules/rule-group.d.ts +1 -1
  400. package/dist/rules/rule-group.d.ts.map +1 -1
  401. package/dist/rules/rule-group.js +15 -6
  402. package/dist/rules/rule-group.js.map +1 -1
  403. package/dist/rules/start-coordinator.d.ts +5 -1
  404. package/dist/rules/start-coordinator.d.ts.map +1 -1
  405. package/dist/rules/start-coordinator.js +9 -3
  406. package/dist/rules/start-coordinator.js.map +1 -1
  407. package/dist/rules/tools.d.ts.map +1 -1
  408. package/dist/rules/tools.js +39 -28
  409. package/dist/rules/tools.js.map +1 -1
  410. package/dist/rules/transition-service.d.ts +4 -10
  411. package/dist/rules/transition-service.d.ts.map +1 -1
  412. package/dist/rules/transition-service.js +61 -55
  413. package/dist/rules/transition-service.js.map +1 -1
  414. package/dist/rules/types.d.ts +86 -36
  415. package/dist/rules/types.d.ts.map +1 -1
  416. package/dist/rules/types.js +5 -41
  417. package/dist/rules/types.js.map +1 -1
  418. package/dist/rules/validation.d.ts.map +1 -1
  419. package/dist/rules/validation.js +32 -2
  420. package/dist/rules/validation.js.map +1 -1
  421. package/dist/run-error.d.ts +1 -1
  422. package/dist/run-error.d.ts.map +1 -1
  423. package/dist/run-error.js +38 -5
  424. package/dist/run-error.js.map +1 -1
  425. package/dist/sandbox/sandbox-env-cache.d.ts +33 -0
  426. package/dist/sandbox/sandbox-env-cache.d.ts.map +1 -0
  427. package/dist/sandbox/sandbox-env-cache.js +140 -0
  428. package/dist/sandbox/sandbox-env-cache.js.map +1 -0
  429. package/dist/sandbox/sandbox-env.d.ts +77 -0
  430. package/dist/sandbox/sandbox-env.d.ts.map +1 -0
  431. package/dist/sandbox/sandbox-env.js +130 -0
  432. package/dist/sandbox/sandbox-env.js.map +1 -0
  433. package/dist/secret-encryption.d.ts +21 -0
  434. package/dist/secret-encryption.d.ts.map +1 -1
  435. package/dist/secret-encryption.js +31 -4
  436. package/dist/secret-encryption.js.map +1 -1
  437. package/dist/session/live-sessions.d.ts +11 -4
  438. package/dist/session/live-sessions.d.ts.map +1 -1
  439. package/dist/session/live-sessions.js +41 -10
  440. package/dist/session/live-sessions.js.map +1 -1
  441. package/dist/session/self-review-gate.d.ts +6 -4
  442. package/dist/session/self-review-gate.d.ts.map +1 -1
  443. package/dist/session/self-review-gate.js +9 -12
  444. package/dist/session/self-review-gate.js.map +1 -1
  445. package/dist/session/session-threads.d.ts +2 -3
  446. package/dist/session/session-threads.d.ts.map +1 -1
  447. package/dist/session/session-threads.js.map +1 -1
  448. package/dist/session/source-control-tools.d.ts +39 -13
  449. package/dist/session/source-control-tools.d.ts.map +1 -1
  450. package/dist/session/source-control-tools.js +55 -61
  451. package/dist/session/source-control-tools.js.map +1 -1
  452. package/dist/session/work-item-state-processor.d.ts +24 -0
  453. package/dist/session/work-item-state-processor.d.ts.map +1 -0
  454. package/dist/session/work-item-state-processor.js +275 -0
  455. package/dist/session/work-item-state-processor.js.map +1 -0
  456. package/dist/storage/domains/audit/actions.d.ts +2 -1
  457. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  458. package/dist/storage/domains/audit/actions.js +5 -4
  459. package/dist/storage/domains/audit/actions.js.map +1 -1
  460. package/dist/storage/domains/boards/base.d.ts +85 -32
  461. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  462. package/dist/storage/domains/boards/base.js +120 -131
  463. package/dist/storage/domains/boards/base.js.map +1 -1
  464. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  465. package/dist/storage/domains/boards/schemas.js +12 -0
  466. package/dist/storage/domains/boards/schemas.js.map +1 -1
  467. package/dist/storage/domains/channel-identity/base.d.ts +0 -4
  468. package/dist/storage/domains/channel-identity/base.d.ts.map +1 -1
  469. package/dist/storage/domains/channel-identity/base.js +0 -7
  470. package/dist/storage/domains/channel-identity/base.js.map +1 -1
  471. package/dist/storage/domains/intake/base.d.ts +5 -45
  472. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  473. package/dist/storage/domains/intake/base.js +11 -89
  474. package/dist/storage/domains/intake/base.js.map +1 -1
  475. package/dist/storage/domains/projects/base.d.ts +17 -9
  476. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  477. package/dist/storage/domains/projects/base.js +15 -7
  478. package/dist/storage/domains/projects/base.js.map +1 -1
  479. package/dist/storage/domains/sandbox-envs/base.d.ts +70 -0
  480. package/dist/storage/domains/sandbox-envs/base.d.ts.map +1 -0
  481. package/dist/storage/domains/sandbox-envs/base.js +227 -0
  482. package/dist/storage/domains/sandbox-envs/base.js.map +1 -0
  483. package/dist/storage/domains/work-items/base.d.ts +62 -22
  484. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  485. package/dist/storage/domains/work-items/base.js +231 -146
  486. package/dist/storage/domains/work-items/base.js.map +1 -1
  487. package/dist/storage/domains/work-items/board-version.d.ts +6 -2
  488. package/dist/storage/domains/work-items/board-version.d.ts.map +1 -1
  489. package/dist/storage/domains/work-items/board-version.js +20 -9
  490. package/dist/storage/domains/work-items/board-version.js.map +1 -1
  491. package/dist/storage/domains/work-items/cards.d.ts +28 -5
  492. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  493. package/dist/storage/domains/work-items/cards.js +156 -23
  494. package/dist/storage/domains/work-items/cards.js.map +1 -1
  495. package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
  496. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
  497. package/dist/storage/domains/work-items/legacy-review.js +109 -0
  498. package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
  499. package/dist/storage/domains/work-items/metrics.d.ts +12 -4
  500. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  501. package/dist/storage/domains/work-items/metrics.js +14 -32
  502. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  503. package/dist/storage/domains/work-items/work-item-schema.d.ts +4 -2
  504. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  505. package/dist/storage/domains/work-items/work-item-schema.js +59 -26
  506. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  507. package/dist/tools/approval-tools.d.ts.map +1 -1
  508. package/dist/tools/approval-tools.js +28 -9
  509. package/dist/tools/approval-tools.js.map +1 -1
  510. package/dist/tools/index.d.ts +1 -1
  511. package/dist/tools/index.js +1 -1
  512. package/dist/tools/index.js.map +1 -1
  513. package/dist/tools/messaging-tools.d.ts +3 -0
  514. package/dist/tools/messaging-tools.d.ts.map +1 -1
  515. package/dist/tools/messaging-tools.js +2 -1
  516. package/dist/tools/messaging-tools.js.map +1 -1
  517. package/dist/tools/read-tools.d.ts +8 -4
  518. package/dist/tools/read-tools.d.ts.map +1 -1
  519. package/dist/tools/read-tools.js +86 -37
  520. package/dist/tools/read-tools.js.map +1 -1
  521. package/dist/tools/reports.d.ts +1 -0
  522. package/dist/tools/reports.d.ts.map +1 -1
  523. package/dist/tools/reports.js +2 -1
  524. package/dist/tools/reports.js.map +1 -1
  525. package/dist/tools/run-watch.d.ts +1 -1
  526. package/dist/tools/run-watch.d.ts.map +1 -1
  527. package/dist/tools/run-watch.js +1 -0
  528. package/dist/tools/run-watch.js.map +1 -1
  529. package/dist/tools/sandbox-tools.js +1 -1
  530. package/dist/tools/session-tools.js +1 -1
  531. package/dist/tools/sessions-state-processor.d.ts +2 -0
  532. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  533. package/dist/tools/sessions-state-processor.js +4 -2
  534. package/dist/tools/sessions-state-processor.js.map +1 -1
  535. package/dist/tools/side-sessions.d.ts +2 -0
  536. package/dist/tools/side-sessions.d.ts.map +1 -1
  537. package/dist/tools/side-sessions.js +2 -1
  538. package/dist/tools/side-sessions.js.map +1 -1
  539. package/dist/tools/work-item-tools.d.ts +0 -3
  540. package/dist/tools/work-item-tools.d.ts.map +1 -1
  541. package/dist/tools/work-item-tools.js +10 -20
  542. package/dist/tools/work-item-tools.js.map +1 -1
  543. package/dist/work-item-branch.d.ts +13 -0
  544. package/dist/work-item-branch.d.ts.map +1 -1
  545. package/dist/work-item-branch.js +16 -1
  546. package/dist/work-item-branch.js.map +1 -1
  547. package/dist/work-items/create-work-item.d.ts +6 -0
  548. package/dist/work-items/create-work-item.d.ts.map +1 -1
  549. package/dist/work-items/create-work-item.js +28 -3
  550. package/dist/work-items/create-work-item.js.map +1 -1
  551. package/dist/work-items/description-context.d.ts +5 -0
  552. package/dist/work-items/description-context.d.ts.map +1 -0
  553. package/dist/work-items/description-context.js +17 -0
  554. package/dist/work-items/description-context.js.map +1 -0
  555. package/dist/work-items/providers/base.d.ts +4 -1
  556. package/dist/work-items/providers/base.d.ts.map +1 -1
  557. package/dist/work-items/providers/base.js +6 -1
  558. package/dist/work-items/providers/base.js.map +1 -1
  559. package/dist/work-items/providers/github.d.ts.map +1 -1
  560. package/dist/work-items/providers/github.js +2 -1
  561. package/dist/work-items/providers/github.js.map +1 -1
  562. package/dist/work-items/providers/gitlab.d.ts.map +1 -1
  563. package/dist/work-items/providers/gitlab.js +2 -1
  564. package/dist/work-items/providers/gitlab.js.map +1 -1
  565. package/dist/work-items/providers/jira.d.ts.map +1 -1
  566. package/dist/work-items/providers/jira.js +3 -2
  567. package/dist/work-items/providers/jira.js.map +1 -1
  568. package/dist/work-items/providers/linear.d.ts.map +1 -1
  569. package/dist/work-items/providers/linear.js +3 -2
  570. package/dist/work-items/providers/linear.js.map +1 -1
  571. package/dist/work-items/providers/types.d.ts +6 -0
  572. package/dist/work-items/providers/types.d.ts.map +1 -1
  573. package/dist/work-items/related-cards.d.ts +21 -0
  574. package/dist/work-items/related-cards.d.ts.map +1 -0
  575. package/dist/work-items/related-cards.js +45 -0
  576. package/dist/work-items/related-cards.js.map +1 -0
  577. package/dist/work-items/split-migration.d.ts.map +1 -1
  578. package/dist/work-items/split-migration.js +8 -8
  579. package/dist/work-items/split-migration.js.map +1 -1
  580. package/dist/workspace.d.ts +3 -1
  581. package/dist/workspace.d.ts.map +1 -1
  582. package/dist/workspace.js +122 -45
  583. package/dist/workspace.js.map +1 -1
  584. package/factory-skills/configure-factory-rules/SKILL.md +13 -11
  585. package/factory-skills/factory-build/SKILL.md +64 -0
  586. package/factory-skills/factory-gitlab-rereview/SKILL.md +4 -4
  587. package/factory-skills/factory-gitlab-review/SKILL.md +6 -6
  588. package/factory-skills/factory-plan/SKILL.md +8 -10
  589. package/factory-skills/factory-rereview/SKILL.md +74 -28
  590. package/factory-skills/factory-review/SKILL.md +85 -29
  591. package/factory-skills/factory-self-review/SKILL.md +32 -13
  592. package/factory-skills/factory-triage/SKILL.md +36 -32
  593. package/package.json +12 -12
  594. package/dist/boards/index.js.map +0 -1
  595. package/dist/boards/pull-request-review.d.ts +0 -14
  596. package/dist/boards/pull-request-review.d.ts.map +0 -1
  597. package/dist/boards/pull-request-review.js +0 -81
  598. package/dist/boards/pull-request-review.js.map +0 -1
  599. package/dist/boards/work-tool-rules.d.ts +0 -8
  600. package/dist/boards/work-tool-rules.d.ts.map +0 -1
  601. package/dist/boards/work-tool-rules.js +0 -19
  602. package/dist/boards/work-tool-rules.js.map +0 -1
  603. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts +0 -8
  604. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts.map +0 -1
  605. package/dist/integrations/slack/emoji-shortcodes.generated.js +0 -1984
  606. package/dist/integrations/slack/emoji-shortcodes.generated.js.map +0 -1
  607. package/dist/integrations/slack/emoji.d.ts +0 -3
  608. package/dist/integrations/slack/emoji.d.ts.map +0 -1
  609. package/dist/integrations/slack/emoji.js +0 -11
  610. package/dist/integrations/slack/emoji.js.map +0 -1
  611. package/dist/integrations/slack/feed-publisher.d.ts +0 -26
  612. package/dist/integrations/slack/feed-publisher.d.ts.map +0 -1
  613. package/dist/integrations/slack/feed-publisher.js +0 -43
  614. package/dist/integrations/slack/feed-publisher.js.map +0 -1
  615. package/dist/routes/attention-activity.d.ts +0 -23
  616. package/dist/routes/attention-activity.d.ts.map +0 -1
  617. package/dist/routes/attention-activity.js +0 -154
  618. package/dist/routes/attention-activity.js.map +0 -1
  619. package/dist/rules/resolve.d.ts +0 -15
  620. package/dist/rules/resolve.d.ts.map +0 -1
  621. package/dist/rules/resolve.js +0 -22
  622. package/dist/rules/resolve.js.map +0 -1
  623. package/dist/storage/domains/comments/activity.d.ts +0 -40
  624. package/dist/storage/domains/comments/activity.d.ts.map +0 -1
  625. package/dist/storage/domains/comments/activity.js +0 -93
  626. package/dist/storage/domains/comments/activity.js.map +0 -1
  627. package/dist/storage/domains/comments/actor.d.ts +0 -51
  628. package/dist/storage/domains/comments/actor.d.ts.map +0 -1
  629. package/dist/storage/domains/comments/actor.js +0 -37
  630. package/dist/storage/domains/comments/actor.js.map +0 -1
  631. package/dist/storage/domains/comments/base.d.ts +0 -245
  632. package/dist/storage/domains/comments/base.d.ts.map +0 -1
  633. package/dist/storage/domains/comments/base.js +0 -539
  634. package/dist/storage/domains/comments/base.js.map +0 -1
  635. package/dist/storage/domains/comments/domain.d.ts +0 -135
  636. package/dist/storage/domains/comments/domain.d.ts.map +0 -1
  637. package/dist/storage/domains/comments/domain.js +0 -284
  638. package/dist/storage/domains/comments/domain.js.map +0 -1
  639. package/dist/storage/domains/comments/feed-context.d.ts +0 -22
  640. package/dist/storage/domains/comments/feed-context.d.ts.map +0 -1
  641. package/dist/storage/domains/comments/feed-context.js +0 -88
  642. package/dist/storage/domains/comments/feed-context.js.map +0 -1
  643. package/dist/storage/domains/comments/feed-sync.d.ts +0 -21
  644. package/dist/storage/domains/comments/feed-sync.d.ts.map +0 -1
  645. package/dist/storage/domains/comments/feed-sync.js +0 -1
  646. package/dist/storage/domains/comments/parse.d.ts +0 -23
  647. package/dist/storage/domains/comments/parse.d.ts.map +0 -1
  648. package/dist/storage/domains/comments/parse.js +0 -89
  649. package/dist/storage/domains/comments/parse.js.map +0 -1
  650. package/dist/storage/domains/comments/routes.d.ts +0 -24
  651. package/dist/storage/domains/comments/routes.d.ts.map +0 -1
  652. package/dist/storage/domains/comments/routes.js +0 -299
  653. package/dist/storage/domains/comments/routes.js.map +0 -1
  654. package/dist/storage/domains/comments/schema.d.ts +0 -5
  655. package/dist/storage/domains/comments/schema.d.ts.map +0 -1
  656. package/dist/storage/domains/comments/schema.js +0 -178
  657. package/dist/storage/domains/comments/schema.js.map +0 -1
  658. package/dist/storage/domains/comments/wire.d.ts +0 -40
  659. package/dist/storage/domains/comments/wire.d.ts.map +0 -1
  660. package/dist/storage/domains/comments/wire.js +0 -36
  661. package/dist/storage/domains/comments/wire.js.map +0 -1
  662. package/factory-skills/factory-complete-issue/SKILL.md +0 -24
@@ -0,0 +1,77 @@
1
+ /**
2
+ * Sandbox environment variables: what a session sandbox's commands and builds
3
+ * get from the Factory's stored variables, and how a running sandbox picks up
4
+ * edits on its next command.
5
+ */
6
+ import type { FactorySandboxContext } from '@mastra/core/workspace';
7
+ import type { SandboxEnvStore } from '../storage/domains/sandbox-envs/base.js';
8
+ export interface SandboxEnv {
9
+ /** Variables every command in the sandbox gets. */
10
+ runtime: Record<string, string>;
11
+ /** Variables template builds and Factory-run setup commands get; never runtime commands. */
12
+ build: Record<string, string>;
13
+ /** Read before the values: an edit landing in between makes the next check reload. */
14
+ revision: string;
15
+ buildRevision: string;
16
+ }
17
+ /**
18
+ * The single place a sandbox's environment is resolved. v1 reads only the
19
+ * Factory-wide variables; personal and session layers merge in here later,
20
+ * with session over personal over Factory, so callers never change.
21
+ */
22
+ export declare function resolveSandboxEnv(store: Pick<SandboxEnvStore, 'resolve'>, scope: {
23
+ orgId: string;
24
+ projectId: string;
25
+ }): Promise<SandboxEnv>;
26
+ /**
27
+ * `resolveSandboxEnv` for session boot and setup: a failed read (a storage
28
+ * blip, a value encrypted with a removed key) is logged and yields no Factory
29
+ * variables, so it can't stop a session from starting. Its empty revision
30
+ * makes the first command's refresh try again.
31
+ */
32
+ export declare function resolveSandboxEnvOrEmpty(store: Pick<SandboxEnvStore, 'resolve'>, scope: {
33
+ orgId: string;
34
+ projectId: string;
35
+ }): Promise<SandboxEnv>;
36
+ /**
37
+ * The template-build fields of a sandbox context. Omitted when the Factory has
38
+ * no Build variables, so the template identity matches one built without them.
39
+ * Session boot and environment builds share this, so both name the same template.
40
+ */
41
+ export declare function sandboxBuildContext(env: SandboxEnv | undefined): Pick<FactorySandboxContext, 'buildEnv' | 'buildEnvRevision'>;
42
+ /**
43
+ * Replace every Build value that appears in provider or command output with
44
+ * `***`. Each value is also matched without its edge whitespace, since output
45
+ * often drops a pasted trailing space or newline. Longest first, so a value
46
+ * that contains another is masked whole.
47
+ */
48
+ export declare function maskSandboxEnvValues(text: string, env: Record<string, string> | undefined): string;
49
+ type EnvOverlay = Record<string, string | undefined>;
50
+ /**
51
+ * The Factory runtime values currently applied to a sandbox, so output from a
52
+ * command that ran in it (a failed teardown) can be masked without a storage read.
53
+ */
54
+ export declare function appliedSandboxEnv(sandbox: object): Record<string, string>;
55
+ export interface RefreshableSandbox {
56
+ ensureRunning?: () => Promise<void>;
57
+ setEnv?: (update: (env: EnvOverlay) => EnvOverlay) => void;
58
+ }
59
+ /**
60
+ * Apply the Factory's runtime variables to a sandbox's env overlay and keep
61
+ * them current: after every `ensureRunning()` (which every command path awaits
62
+ * before reading the overlay) the Factory revision is checked, and on a change
63
+ * the variables are reloaded and re-applied, so an add, edit or delete reaches
64
+ * the next command. Processes already running keep the env they started with.
65
+ *
66
+ * A key the sandbox already had (its host `env`) is remembered before Factory
67
+ * first writes it and restored when the Factory variable goes away. A refresh
68
+ * that fails is logged and the command runs with the env last applied.
69
+ */
70
+ export declare function attachSandboxEnvRefresh(sandbox: RefreshableSandbox, options: {
71
+ initial: Pick<SandboxEnv, 'runtime' | 'revision'>;
72
+ revision: () => Promise<string>;
73
+ load: () => Promise<Pick<SandboxEnv, 'runtime' | 'revision'>>;
74
+ onError?: (error: unknown) => void;
75
+ }): void;
76
+ export {};
77
+ //# sourceMappingURL=sandbox-env.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-env.d.ts","sourceRoot":"","sources":["../../src/sandbox/sandbox-env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE/E,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,EACvC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,UAAU,CAAC,CAGrB;AASD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,EACvC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,UAAU,GAAG,SAAS,GAC1B,IAAI,CAAC,qBAAqB,EAAE,UAAU,GAAG,kBAAkB,CAAC,CAG9D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CAQlG;AAED,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAIrD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzE;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,UAAU,KAAK,IAAI,CAAC;CAC5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE;IACP,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;IAClD,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,GACA,IAAI,CAmDN"}
@@ -0,0 +1,130 @@
1
+ // src/sandbox/sandbox-env.ts
2
+ /**
3
+ * The single place a sandbox's environment is resolved. v1 reads only the
4
+ * Factory-wide variables; personal and session layers merge in here later,
5
+ * with session over personal over Factory, so callers never change.
6
+ */
7
+ async function resolveSandboxEnv(store, scope) {
8
+ const { runtime, build, revision, buildRevision } = await store.resolve(scope.orgId, scope.projectId);
9
+ return {
10
+ runtime,
11
+ build,
12
+ revision,
13
+ buildRevision
14
+ };
15
+ }
16
+ function warnReadFailed(message, error) {
17
+ console.warn(`[Mastra Factory] ${message}`, { error: error instanceof Error ? error.message : String(error) });
18
+ }
19
+ /**
20
+ * `resolveSandboxEnv` for session boot and setup: a failed read (a storage
21
+ * blip, a value encrypted with a removed key) is logged and yields no Factory
22
+ * variables, so it can't stop a session from starting. Its empty revision
23
+ * makes the first command's refresh try again.
24
+ */
25
+ async function resolveSandboxEnvOrEmpty(store, scope) {
26
+ try {
27
+ return await resolveSandboxEnv(store, scope);
28
+ } catch (error) {
29
+ warnReadFailed("Could not read sandbox environment variables; starting without them", error);
30
+ return {
31
+ runtime: {},
32
+ build: {},
33
+ revision: "",
34
+ buildRevision: ""
35
+ };
36
+ }
37
+ }
38
+ /**
39
+ * The template-build fields of a sandbox context. Omitted when the Factory has
40
+ * no Build variables, so the template identity matches one built without them.
41
+ * Session boot and environment builds share this, so both name the same template.
42
+ */
43
+ function sandboxBuildContext(env) {
44
+ if (!env || Object.keys(env.build).length === 0) return {};
45
+ return {
46
+ buildEnv: env.build,
47
+ buildEnvRevision: env.buildRevision
48
+ };
49
+ }
50
+ /**
51
+ * Replace every Build value that appears in provider or command output with
52
+ * `***`. Each value is also matched without its edge whitespace, since output
53
+ * often drops a pasted trailing space or newline. Longest first, so a value
54
+ * that contains another is masked whole.
55
+ */
56
+ function maskSandboxEnvValues(text, env) {
57
+ if (!env) return text;
58
+ const values = new Set(Object.values(env).flatMap((value) => [value, value.trim()]));
59
+ let masked = text;
60
+ for (const value of [...values].sort((a, b) => b.length - a.length)) if (value) masked = masked.replaceAll(value, "***");
61
+ return masked;
62
+ }
63
+ const appliedBySandbox = /* @__PURE__ */ new WeakMap();
64
+ /**
65
+ * The Factory runtime values currently applied to a sandbox, so output from a
66
+ * command that ran in it (a failed teardown) can be masked without a storage read.
67
+ */
68
+ function appliedSandboxEnv(sandbox) {
69
+ return appliedBySandbox.get(sandbox)?.() ?? {};
70
+ }
71
+ /**
72
+ * Apply the Factory's runtime variables to a sandbox's env overlay and keep
73
+ * them current: after every `ensureRunning()` (which every command path awaits
74
+ * before reading the overlay) the Factory revision is checked, and on a change
75
+ * the variables are reloaded and re-applied, so an add, edit or delete reaches
76
+ * the next command. Processes already running keep the env they started with.
77
+ *
78
+ * A key the sandbox already had (its host `env`) is remembered before Factory
79
+ * first writes it and restored when the Factory variable goes away. A refresh
80
+ * that fails is logged and the command runs with the env last applied.
81
+ */
82
+ function attachSandboxEnvRefresh(sandbox, options) {
83
+ const setEnv = sandbox.setEnv?.bind(sandbox);
84
+ if (!setEnv) return;
85
+ const shadowed = /* @__PURE__ */ new Map();
86
+ let applied = {};
87
+ let appliedRevision = options.initial.revision;
88
+ const apply = (next) => {
89
+ setEnv((env) => {
90
+ const out = { ...env };
91
+ for (const key of Object.keys(applied)) {
92
+ if (Object.hasOwn(next, key)) continue;
93
+ const previous = shadowed.get(key);
94
+ shadowed.delete(key);
95
+ if (previous === void 0) delete out[key];
96
+ else out[key] = previous;
97
+ }
98
+ for (const [key, value] of Object.entries(next)) {
99
+ if (!Object.hasOwn(applied, key)) shadowed.set(key, env[key]);
100
+ out[key] = value;
101
+ }
102
+ return out;
103
+ });
104
+ applied = { ...next };
105
+ };
106
+ apply(options.initial.runtime);
107
+ appliedBySandbox.set(sandbox, () => applied);
108
+ const original = sandbox.ensureRunning?.bind(sandbox);
109
+ if (!original) return;
110
+ let inFlight;
111
+ const refresh = async () => {
112
+ if (await options.revision() === appliedRevision) return;
113
+ const next = await options.load();
114
+ apply(next.runtime);
115
+ appliedRevision = next.revision;
116
+ };
117
+ sandbox.ensureRunning = async () => {
118
+ await original();
119
+ inFlight ??= refresh().catch((error) => {
120
+ if (options.onError) options.onError(error);
121
+ else warnReadFailed("Could not refresh sandbox environment variables; using the last applied", error);
122
+ }).finally(() => {
123
+ inFlight = void 0;
124
+ });
125
+ await inFlight;
126
+ };
127
+ }
128
+ export { appliedSandboxEnv, attachSandboxEnvRefresh, maskSandboxEnvValues, resolveSandboxEnv, resolveSandboxEnvOrEmpty, sandboxBuildContext };
129
+
130
+ //# sourceMappingURL=sandbox-env.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-env.js","names":[],"sources":["../../src/sandbox/sandbox-env.ts"],"sourcesContent":["/**\n * Sandbox environment variables: what a session sandbox's commands and builds\n * get from the Factory's stored variables, and how a running sandbox picks up\n * edits on its next command.\n */\n\nimport type { FactorySandboxContext } from '@mastra/core/workspace';\nimport type { SandboxEnvStore } from '../storage/domains/sandbox-envs/base.js';\n\nexport interface SandboxEnv {\n /** Variables every command in the sandbox gets. */\n runtime: Record<string, string>;\n /** Variables template builds and Factory-run setup commands get; never runtime commands. */\n build: Record<string, string>;\n /** Read before the values: an edit landing in between makes the next check reload. */\n revision: string;\n buildRevision: string;\n}\n\n/**\n * The single place a sandbox's environment is resolved. v1 reads only the\n * Factory-wide variables; personal and session layers merge in here later,\n * with session over personal over Factory, so callers never change.\n */\nexport async function resolveSandboxEnv(\n store: Pick<SandboxEnvStore, 'resolve'>,\n scope: { orgId: string; projectId: string },\n): Promise<SandboxEnv> {\n const { runtime, build, revision, buildRevision } = await store.resolve(scope.orgId, scope.projectId);\n return { runtime, build, revision, buildRevision };\n}\n\nfunction warnReadFailed(message: string, error: unknown) {\n console.warn(`[Mastra Factory] ${message}`, {\n // Storage and decryption errors name no values.\n error: error instanceof Error ? error.message : String(error),\n });\n}\n\n/**\n * `resolveSandboxEnv` for session boot and setup: a failed read (a storage\n * blip, a value encrypted with a removed key) is logged and yields no Factory\n * variables, so it can't stop a session from starting. Its empty revision\n * makes the first command's refresh try again.\n */\nexport async function resolveSandboxEnvOrEmpty(\n store: Pick<SandboxEnvStore, 'resolve'>,\n scope: { orgId: string; projectId: string },\n): Promise<SandboxEnv> {\n try {\n return await resolveSandboxEnv(store, scope);\n } catch (error) {\n warnReadFailed('Could not read sandbox environment variables; starting without them', error);\n return { runtime: {}, build: {}, revision: '', buildRevision: '' };\n }\n}\n\n/**\n * The template-build fields of a sandbox context. Omitted when the Factory has\n * no Build variables, so the template identity matches one built without them.\n * Session boot and environment builds share this, so both name the same template.\n */\nexport function sandboxBuildContext(\n env: SandboxEnv | undefined,\n): Pick<FactorySandboxContext, 'buildEnv' | 'buildEnvRevision'> {\n if (!env || Object.keys(env.build).length === 0) return {};\n return { buildEnv: env.build, buildEnvRevision: env.buildRevision };\n}\n\n/**\n * Replace every Build value that appears in provider or command output with\n * `***`. Each value is also matched without its edge whitespace, since output\n * often drops a pasted trailing space or newline. Longest first, so a value\n * that contains another is masked whole.\n */\nexport function maskSandboxEnvValues(text: string, env: Record<string, string> | undefined): string {\n if (!env) return text;\n const values = new Set(Object.values(env).flatMap(value => [value, value.trim()]));\n let masked = text;\n for (const value of [...values].sort((a, b) => b.length - a.length)) {\n if (value) masked = masked.replaceAll(value, '***');\n }\n return masked;\n}\n\ntype EnvOverlay = Record<string, string | undefined>;\n\nconst appliedBySandbox = new WeakMap<object, () => Record<string, string>>();\n\n/**\n * The Factory runtime values currently applied to a sandbox, so output from a\n * command that ran in it (a failed teardown) can be masked without a storage read.\n */\nexport function appliedSandboxEnv(sandbox: object): Record<string, string> {\n return appliedBySandbox.get(sandbox)?.() ?? {};\n}\n\nexport interface RefreshableSandbox {\n ensureRunning?: () => Promise<void>;\n setEnv?: (update: (env: EnvOverlay) => EnvOverlay) => void;\n}\n\n/**\n * Apply the Factory's runtime variables to a sandbox's env overlay and keep\n * them current: after every `ensureRunning()` (which every command path awaits\n * before reading the overlay) the Factory revision is checked, and on a change\n * the variables are reloaded and re-applied, so an add, edit or delete reaches\n * the next command. Processes already running keep the env they started with.\n *\n * A key the sandbox already had (its host `env`) is remembered before Factory\n * first writes it and restored when the Factory variable goes away. A refresh\n * that fails is logged and the command runs with the env last applied.\n */\nexport function attachSandboxEnvRefresh(\n sandbox: RefreshableSandbox,\n options: {\n initial: Pick<SandboxEnv, 'runtime' | 'revision'>;\n revision: () => Promise<string>;\n load: () => Promise<Pick<SandboxEnv, 'runtime' | 'revision'>>;\n onError?: (error: unknown) => void;\n },\n): void {\n const setEnv = sandbox.setEnv?.bind(sandbox);\n if (!setEnv) return;\n // Values the overlay held under a key before Factory first wrote it.\n const shadowed = new Map<string, string | undefined>();\n let applied: Record<string, string> = {};\n let appliedRevision = options.initial.revision;\n\n const apply = (next: Record<string, string>) => {\n setEnv(env => {\n const out = { ...env };\n for (const key of Object.keys(applied)) {\n if (Object.hasOwn(next, key)) continue;\n const previous = shadowed.get(key);\n shadowed.delete(key);\n if (previous === undefined) delete out[key];\n else out[key] = previous;\n }\n for (const [key, value] of Object.entries(next)) {\n if (!Object.hasOwn(applied, key)) shadowed.set(key, env[key]);\n out[key] = value;\n }\n return out;\n });\n applied = { ...next };\n };\n apply(options.initial.runtime);\n appliedBySandbox.set(sandbox, () => applied);\n\n const original = sandbox.ensureRunning?.bind(sandbox);\n if (!original) return;\n let inFlight: Promise<void> | undefined;\n // Never calls ensureRunning itself, so a command inside `onStart` can't wait on its own start.\n const refresh = async () => {\n if ((await options.revision()) === appliedRevision) return;\n const next = await options.load();\n apply(next.runtime);\n appliedRevision = next.revision;\n };\n sandbox.ensureRunning = async () => {\n await original();\n inFlight ??= refresh()\n .catch(error => {\n if (options.onError) options.onError(error);\n else warnReadFailed('Could not refresh sandbox environment variables; using the last applied', error);\n })\n .finally(() => {\n inFlight = undefined;\n });\n await inFlight;\n };\n}\n"],"mappings":"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"}
@@ -15,6 +15,27 @@ export interface FactorySecretEncryptionConfig {
15
15
  primary: FactorySecretEncryptionKey;
16
16
  previous?: FactorySecretEncryptionKey[];
17
17
  }
18
+ /** A stored secret can't be read with the keys this instance was configured with. */
19
+ export declare class FactorySecretDecryptionError extends Error {
20
+ /** True when this instance has no key at all, rather than the wrong one. */
21
+ readonly missingKey: boolean;
22
+ name: string;
23
+ constructor(message: string,
24
+ /** True when this instance has no key at all, rather than the wrong one. */
25
+ missingKey?: boolean);
26
+ }
27
+ /**
28
+ * Client-safe copy for a storage failure caused by an encryption key problem,
29
+ * or `undefined` for any other failure (whose message may expose database
30
+ * internals and stays in the server log). `fix` marks env var names with backticks.
31
+ */
32
+ export declare function secretKeyProblem(error: unknown): {
33
+ title: string;
34
+ message: string;
35
+ fix: string;
36
+ } | undefined;
37
+ /** {@link secretKeyProblem} as one plain sentence, for API error messages. */
38
+ export declare function secretKeyMismatchHint(error: unknown): string | undefined;
18
39
  /**
19
40
  * Creates a versioned AES-256-GCM encryptor. The primary key is used for new
20
41
  * writes; previous keys remain decrypt-only until stored values are rotated.
@@ -1 +1 @@
1
- {"version":3,"file":"secret-encryption.d.ts","sourceRoot":"","sources":["../src/secret-encryption.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC;IACT,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,0BAA0B,CAAC;IACpC,QAAQ,CAAC,EAAE,0BAA0B,EAAE,CAAC;CACzC;AAgCD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,6BAA6B,GAAG,uBAAuB,CA+E5G;AAED,+EAA+E;AAC/E,wBAAgB,sCAAsC,IAAI,uBAAuB,CA+BhF"}
1
+ {"version":3,"file":"secret-encryption.d.ts","sourceRoot":"","sources":["../src/secret-encryption.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC;IACT,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,0BAA0B,CAAC;IACpC,QAAQ,CAAC,EAAE,0BAA0B,EAAE,CAAC;CACzC;AAWD,qFAAqF;AACrF,qBAAa,4BAA6B,SAAQ,KAAK;IAKnD,4EAA4E;IAC5E,QAAQ,CAAC,UAAU;IALZ,IAAI,SAAkC;IAE/C,YACE,OAAO,EAAE,MAAM;IACf,4EAA4E;IACnE,UAAU,UAAQ,EAG5B;CACF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAS5G;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGxE;AAuBD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,6BAA6B,GAAG,uBAAuB,CA+E5G;AAED,+EAA+E;AAC/E,wBAAgB,sCAAsC,IAAI,uBAAuB,CAgChF"}
@@ -10,6 +10,33 @@ function validateKey({ id, key }) {
10
10
  if (buffer.byteLength !== 32) throw new Error(`[FactorySecretEncryption] Key "${id}" must be exactly 32 bytes.`);
11
11
  return buffer;
12
12
  }
13
+ /** A stored secret can't be read with the keys this instance was configured with. */
14
+ var FactorySecretDecryptionError = class extends Error {
15
+ missingKey;
16
+ name = "FactorySecretDecryptionError";
17
+ constructor(message, missingKey = false) {
18
+ super(message);
19
+ this.missingKey = missingKey;
20
+ }
21
+ };
22
+ /**
23
+ * Client-safe copy for a storage failure caused by an encryption key problem,
24
+ * or `undefined` for any other failure (whose message may expose database
25
+ * internals and stays in the server log). `fix` marks env var names with backticks.
26
+ */
27
+ function secretKeyProblem(error) {
28
+ if (!(error instanceof FactorySecretDecryptionError)) return void 0;
29
+ return {
30
+ title: "Factory needs its encryption key",
31
+ message: error.missingKey ? "This deployment doesn't have one set." : "This deployment is using a different one than before.",
32
+ fix: "Set `FACTORY_CREDENTIAL_ENCRYPTION_KEY` and redeploy."
33
+ };
34
+ }
35
+ /** {@link secretKeyProblem} as one plain sentence, for API error messages. */
36
+ function secretKeyMismatchHint(error) {
37
+ const problem = secretKeyProblem(error);
38
+ return problem && `${problem.title}. ${problem.message} ${problem.fix.replaceAll("`", "")}`;
39
+ }
13
40
  function parseEnvelope(value) {
14
41
  let parsed;
15
42
  try {
@@ -68,7 +95,7 @@ function createFactorySecretEncryption(config) {
68
95
  }
69
96
  const envelope = parseEnvelope(value);
70
97
  const key = keys.get(envelope.keyId);
71
- if (!key) throw new Error(`[FactorySecretEncryption] Unknown key id "${envelope.keyId}".`);
98
+ if (!key) throw new FactorySecretDecryptionError(`[FactorySecretEncryption] Unknown key id "${envelope.keyId}".`);
72
99
  let decoded;
73
100
  try {
74
101
  const decipher = createDecipheriv(ALGORITHM, key, Buffer.from(envelope.iv, "base64url"));
@@ -76,7 +103,7 @@ function createFactorySecretEncryption(config) {
76
103
  const plaintext = Buffer.concat([decipher.update(Buffer.from(envelope.ciphertext, "base64url")), decipher.final()]).toString("utf8");
77
104
  decoded = JSON.parse(plaintext);
78
105
  } catch {
79
- throw new Error("[FactorySecretEncryption] Unable to decrypt encrypted value.");
106
+ throw new FactorySecretDecryptionError("[FactorySecretEncryption] Unable to decrypt encrypted value.");
80
107
  }
81
108
  const nested = await unwrapNestedEnvelope(decoded, depth);
82
109
  if (nested !== void 0) return {
@@ -125,7 +152,7 @@ function createPlaintextFactorySecretEncryption() {
125
152
  needsReencryption: true
126
153
  };
127
154
  }
128
- throw new Error("[FactorySecretEncryption] Value is encrypted, but this instance has no secret encryption key configured. Configure 'secretEncryption' with the same key on every Factory instance.");
155
+ throw new FactorySecretDecryptionError("[FactorySecretEncryption] Value is encrypted, but this instance has no secret encryption key configured. Configure 'secretEncryption' with the same key on every Factory instance.", true);
129
156
  }
130
157
  try {
131
158
  return {
@@ -141,6 +168,6 @@ function createPlaintextFactorySecretEncryption() {
141
168
  }
142
169
  };
143
170
  }
144
- export { createFactorySecretEncryption, createPlaintextFactorySecretEncryption };
171
+ export { FactorySecretDecryptionError, createFactorySecretEncryption, createPlaintextFactorySecretEncryption, secretKeyMismatchHint, secretKeyProblem };
145
172
 
146
173
  //# sourceMappingURL=secret-encryption.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"secret-encryption.js","names":[],"sources":["../src/secret-encryption.ts"],"sourcesContent":["import { createCipheriv, createDecipheriv } from 'node:crypto';\n\nconst ENVELOPE_PREFIX = 'mastra:factory-secret:v1:';\nconst ALGORITHM = 'aes-256-gcm';\nconst IV_BYTES = 12;\nconst MAX_NESTED_ENVELOPES = 4;\n\ninterface SecretEnvelopeV1 {\n keyId: string;\n iv: string;\n ciphertext: string;\n tag: string;\n}\n\nexport interface DecryptedFactorySecret<T> {\n value: T;\n needsReencryption: boolean;\n}\n\n/** Encrypts opaque JSON values before they cross the Factory storage boundary. */\nexport interface FactorySecretEncryption {\n encrypt<T>(value: T): Promise<string>;\n decrypt<T>(value: unknown): Promise<DecryptedFactorySecret<T>>;\n}\n\nexport interface FactorySecretEncryptionKey {\n id: string;\n key: Uint8Array;\n}\n\nexport interface FactorySecretEncryptionConfig {\n primary: FactorySecretEncryptionKey;\n previous?: FactorySecretEncryptionKey[];\n}\n\nfunction validateKey({ id, key }: FactorySecretEncryptionKey): Buffer {\n if (!id) throw new Error('[FactorySecretEncryption] Key id is required.');\n const buffer = Buffer.from(key);\n if (buffer.byteLength !== 32) {\n throw new Error(`[FactorySecretEncryption] Key \"${id}\" must be exactly 32 bytes.`);\n }\n return buffer;\n}\n\nfunction parseEnvelope(value: string): SecretEnvelopeV1 {\n let parsed: unknown;\n try {\n parsed = JSON.parse(Buffer.from(value.slice(ENVELOPE_PREFIX.length), 'base64url').toString('utf8'));\n } catch {\n throw new Error('[FactorySecretEncryption] Invalid encrypted value.');\n }\n\n if (\n !parsed ||\n typeof parsed !== 'object' ||\n typeof (parsed as SecretEnvelopeV1).keyId !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).iv !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).ciphertext !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).tag !== 'string'\n ) {\n throw new Error('[FactorySecretEncryption] Invalid encrypted value.');\n }\n return parsed as SecretEnvelopeV1;\n}\n\n/**\n * Creates a versioned AES-256-GCM encryptor. The primary key is used for new\n * writes; previous keys remain decrypt-only until stored values are rotated.\n */\nexport function createFactorySecretEncryption(config: FactorySecretEncryptionConfig): FactorySecretEncryption {\n const primaryKey = validateKey(config.primary);\n const keys = new Map<string, Buffer>([[config.primary.id, primaryKey]]);\n for (const previous of config.previous ?? []) {\n if (keys.has(previous.id)) throw new Error(`[FactorySecretEncryption] Duplicate key id \"${previous.id}\".`);\n keys.set(previous.id, validateKey(previous));\n }\n\n return {\n async encrypt<T>(value: T): Promise<string> {\n const iv = Buffer.from(globalThis.crypto.getRandomValues(new Uint8Array(IV_BYTES)));\n const cipher = createCipheriv(ALGORITHM, primaryKey, iv);\n const ciphertext = Buffer.concat([cipher.update(JSON.stringify(value), 'utf8'), cipher.final()]);\n const envelope: SecretEnvelopeV1 = {\n keyId: config.primary.id,\n iv: iv.toString('base64url'),\n ciphertext: ciphertext.toString('base64url'),\n tag: cipher.getAuthTag().toString('base64url'),\n };\n return `${ENVELOPE_PREFIX}${Buffer.from(JSON.stringify(envelope), 'utf8').toString('base64url')}`;\n },\n\n decrypt,\n };\n\n async function decrypt<T>(value: unknown, depth = 0): Promise<DecryptedFactorySecret<T>> {\n if (typeof value !== 'string') {\n return { value: structuredClone(value) as T, needsReencryption: true };\n }\n if (!value.startsWith(ENVELOPE_PREFIX)) {\n // JSON text written by the plaintext encryptor, or a raw pre-encryption\n // secret string. Decode it the same way the plaintext encryptor does so\n // migration encrypts the original value, not its JSON text.\n let parsed: unknown;\n try {\n parsed = JSON.parse(value);\n } catch {\n return { value: value as T, needsReencryption: true };\n }\n return { value: (await unwrapNestedEnvelope<T>(parsed, depth)) ?? (parsed as T), needsReencryption: true };\n }\n\n const envelope = parseEnvelope(value);\n const key = keys.get(envelope.keyId);\n if (!key) throw new Error(`[FactorySecretEncryption] Unknown key id \"${envelope.keyId}\".`);\n\n let decoded: unknown;\n try {\n const decipher = createDecipheriv(ALGORITHM, key, Buffer.from(envelope.iv, 'base64url'));\n decipher.setAuthTag(Buffer.from(envelope.tag, 'base64url'));\n const plaintext = Buffer.concat([\n decipher.update(Buffer.from(envelope.ciphertext, 'base64url')),\n decipher.final(),\n ]).toString('utf8');\n decoded = JSON.parse(plaintext);\n } catch {\n throw new Error('[FactorySecretEncryption] Unable to decrypt encrypted value.');\n }\n const nested = await unwrapNestedEnvelope<T>(decoded, depth);\n if (nested !== undefined) return { value: nested, needsReencryption: true };\n return { value: decoded as T, needsReencryption: envelope.keyId !== config.primary.id };\n }\n\n /**\n * Older plaintext encryptors treated an envelope as a raw legacy secret and\n * rewrote it as JSON text, which a keyed boot then re-encrypted. Peel those\n * layers back to the real value so the row is repaired on the next write.\n * A user-supplied secret can also look like an envelope, so anything that\n * does not decrypt with our keys is kept as the literal value.\n */\n async function unwrapNestedEnvelope<T>(value: unknown, depth: number): Promise<T | undefined> {\n if (typeof value !== 'string' || !value.startsWith(ENVELOPE_PREFIX)) return undefined;\n if (depth >= MAX_NESTED_ENVELOPES) return undefined;\n try {\n return (await decrypt<T>(value, depth + 1)).value;\n } catch {\n return undefined;\n }\n }\n}\n\n/** Explicit plaintext compatibility for local, no-auth Factory development. */\nexport function createPlaintextFactorySecretEncryption(): FactorySecretEncryption {\n return {\n async encrypt<T>(value: T): Promise<string> {\n return JSON.stringify(value);\n },\n async decrypt<T>(value: unknown): Promise<DecryptedFactorySecret<T>> {\n if (typeof value !== 'string') return { value: structuredClone(value) as T, needsReencryption: false };\n if (value.startsWith(ENVELOPE_PREFIX)) {\n // Never hand an envelope back as the secret, and never let migration\n // rewrite it as plaintext JSON: that corrupts the row for keyed instances.\n // A raw legacy secret can merely start with the prefix; keep those as-is.\n try {\n parseEnvelope(value);\n } catch {\n return { value: value as T, needsReencryption: true };\n }\n throw new Error(\n '[FactorySecretEncryption] Value is encrypted, but this instance has no secret encryption key configured. ' +\n \"Configure 'secretEncryption' with the same key on every Factory instance.\",\n );\n }\n try {\n return { value: JSON.parse(value) as T, needsReencryption: false };\n } catch {\n // Pre-encryption rows stored raw secret strings (e.g. a bare\n // `custom_providers.api_key`), not JSON. Treat the raw string as the\n // value and flag it so migration rewrites it in the current format.\n return { value: value as T, needsReencryption: true };\n }\n },\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"secret-encryption.js","names":[],"sources":["../src/secret-encryption.ts"],"sourcesContent":["import { createCipheriv, createDecipheriv } from 'node:crypto';\n\nconst ENVELOPE_PREFIX = 'mastra:factory-secret:v1:';\nconst ALGORITHM = 'aes-256-gcm';\nconst IV_BYTES = 12;\nconst MAX_NESTED_ENVELOPES = 4;\n\ninterface SecretEnvelopeV1 {\n keyId: string;\n iv: string;\n ciphertext: string;\n tag: string;\n}\n\nexport interface DecryptedFactorySecret<T> {\n value: T;\n needsReencryption: boolean;\n}\n\n/** Encrypts opaque JSON values before they cross the Factory storage boundary. */\nexport interface FactorySecretEncryption {\n encrypt<T>(value: T): Promise<string>;\n decrypt<T>(value: unknown): Promise<DecryptedFactorySecret<T>>;\n}\n\nexport interface FactorySecretEncryptionKey {\n id: string;\n key: Uint8Array;\n}\n\nexport interface FactorySecretEncryptionConfig {\n primary: FactorySecretEncryptionKey;\n previous?: FactorySecretEncryptionKey[];\n}\n\nfunction validateKey({ id, key }: FactorySecretEncryptionKey): Buffer {\n if (!id) throw new Error('[FactorySecretEncryption] Key id is required.');\n const buffer = Buffer.from(key);\n if (buffer.byteLength !== 32) {\n throw new Error(`[FactorySecretEncryption] Key \"${id}\" must be exactly 32 bytes.`);\n }\n return buffer;\n}\n\n/** A stored secret can't be read with the keys this instance was configured with. */\nexport class FactorySecretDecryptionError extends Error {\n override name = 'FactorySecretDecryptionError';\n\n constructor(\n message: string,\n /** True when this instance has no key at all, rather than the wrong one. */\n readonly missingKey = false,\n ) {\n super(message);\n }\n}\n\n/**\n * Client-safe copy for a storage failure caused by an encryption key problem,\n * or `undefined` for any other failure (whose message may expose database\n * internals and stays in the server log). `fix` marks env var names with backticks.\n */\nexport function secretKeyProblem(error: unknown): { title: string; message: string; fix: string } | undefined {\n if (!(error instanceof FactorySecretDecryptionError)) return undefined;\n return {\n title: 'Factory needs its encryption key',\n message: error.missingKey\n ? \"This deployment doesn't have one set.\"\n : 'This deployment is using a different one than before.',\n fix: 'Set `FACTORY_CREDENTIAL_ENCRYPTION_KEY` and redeploy.',\n };\n}\n\n/** {@link secretKeyProblem} as one plain sentence, for API error messages. */\nexport function secretKeyMismatchHint(error: unknown): string | undefined {\n const problem = secretKeyProblem(error);\n return problem && `${problem.title}. ${problem.message} ${problem.fix.replaceAll('`', '')}`;\n}\n\nfunction parseEnvelope(value: string): SecretEnvelopeV1 {\n let parsed: unknown;\n try {\n parsed = JSON.parse(Buffer.from(value.slice(ENVELOPE_PREFIX.length), 'base64url').toString('utf8'));\n } catch {\n throw new Error('[FactorySecretEncryption] Invalid encrypted value.');\n }\n\n if (\n !parsed ||\n typeof parsed !== 'object' ||\n typeof (parsed as SecretEnvelopeV1).keyId !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).iv !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).ciphertext !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).tag !== 'string'\n ) {\n throw new Error('[FactorySecretEncryption] Invalid encrypted value.');\n }\n return parsed as SecretEnvelopeV1;\n}\n\n/**\n * Creates a versioned AES-256-GCM encryptor. The primary key is used for new\n * writes; previous keys remain decrypt-only until stored values are rotated.\n */\nexport function createFactorySecretEncryption(config: FactorySecretEncryptionConfig): FactorySecretEncryption {\n const primaryKey = validateKey(config.primary);\n const keys = new Map<string, Buffer>([[config.primary.id, primaryKey]]);\n for (const previous of config.previous ?? []) {\n if (keys.has(previous.id)) throw new Error(`[FactorySecretEncryption] Duplicate key id \"${previous.id}\".`);\n keys.set(previous.id, validateKey(previous));\n }\n\n return {\n async encrypt<T>(value: T): Promise<string> {\n const iv = Buffer.from(globalThis.crypto.getRandomValues(new Uint8Array(IV_BYTES)));\n const cipher = createCipheriv(ALGORITHM, primaryKey, iv);\n const ciphertext = Buffer.concat([cipher.update(JSON.stringify(value), 'utf8'), cipher.final()]);\n const envelope: SecretEnvelopeV1 = {\n keyId: config.primary.id,\n iv: iv.toString('base64url'),\n ciphertext: ciphertext.toString('base64url'),\n tag: cipher.getAuthTag().toString('base64url'),\n };\n return `${ENVELOPE_PREFIX}${Buffer.from(JSON.stringify(envelope), 'utf8').toString('base64url')}`;\n },\n\n decrypt,\n };\n\n async function decrypt<T>(value: unknown, depth = 0): Promise<DecryptedFactorySecret<T>> {\n if (typeof value !== 'string') {\n return { value: structuredClone(value) as T, needsReencryption: true };\n }\n if (!value.startsWith(ENVELOPE_PREFIX)) {\n // JSON text written by the plaintext encryptor, or a raw pre-encryption\n // secret string. Decode it the same way the plaintext encryptor does so\n // migration encrypts the original value, not its JSON text.\n let parsed: unknown;\n try {\n parsed = JSON.parse(value);\n } catch {\n return { value: value as T, needsReencryption: true };\n }\n return { value: (await unwrapNestedEnvelope<T>(parsed, depth)) ?? (parsed as T), needsReencryption: true };\n }\n\n const envelope = parseEnvelope(value);\n const key = keys.get(envelope.keyId);\n if (!key) throw new FactorySecretDecryptionError(`[FactorySecretEncryption] Unknown key id \"${envelope.keyId}\".`);\n\n let decoded: unknown;\n try {\n const decipher = createDecipheriv(ALGORITHM, key, Buffer.from(envelope.iv, 'base64url'));\n decipher.setAuthTag(Buffer.from(envelope.tag, 'base64url'));\n const plaintext = Buffer.concat([\n decipher.update(Buffer.from(envelope.ciphertext, 'base64url')),\n decipher.final(),\n ]).toString('utf8');\n decoded = JSON.parse(plaintext);\n } catch {\n throw new FactorySecretDecryptionError('[FactorySecretEncryption] Unable to decrypt encrypted value.');\n }\n const nested = await unwrapNestedEnvelope<T>(decoded, depth);\n if (nested !== undefined) return { value: nested, needsReencryption: true };\n return { value: decoded as T, needsReencryption: envelope.keyId !== config.primary.id };\n }\n\n /**\n * Older plaintext encryptors treated an envelope as a raw legacy secret and\n * rewrote it as JSON text, which a keyed boot then re-encrypted. Peel those\n * layers back to the real value so the row is repaired on the next write.\n * A user-supplied secret can also look like an envelope, so anything that\n * does not decrypt with our keys is kept as the literal value.\n */\n async function unwrapNestedEnvelope<T>(value: unknown, depth: number): Promise<T | undefined> {\n if (typeof value !== 'string' || !value.startsWith(ENVELOPE_PREFIX)) return undefined;\n if (depth >= MAX_NESTED_ENVELOPES) return undefined;\n try {\n return (await decrypt<T>(value, depth + 1)).value;\n } catch {\n return undefined;\n }\n }\n}\n\n/** Explicit plaintext compatibility for local, no-auth Factory development. */\nexport function createPlaintextFactorySecretEncryption(): FactorySecretEncryption {\n return {\n async encrypt<T>(value: T): Promise<string> {\n return JSON.stringify(value);\n },\n async decrypt<T>(value: unknown): Promise<DecryptedFactorySecret<T>> {\n if (typeof value !== 'string') return { value: structuredClone(value) as T, needsReencryption: false };\n if (value.startsWith(ENVELOPE_PREFIX)) {\n // Never hand an envelope back as the secret, and never let migration\n // rewrite it as plaintext JSON: that corrupts the row for keyed instances.\n // A raw legacy secret can merely start with the prefix; keep those as-is.\n try {\n parseEnvelope(value);\n } catch {\n return { value: value as T, needsReencryption: true };\n }\n throw new FactorySecretDecryptionError(\n '[FactorySecretEncryption] Value is encrypted, but this instance has no secret encryption key configured. ' +\n \"Configure 'secretEncryption' with the same key on every Factory instance.\",\n true,\n );\n }\n try {\n return { value: JSON.parse(value) as T, needsReencryption: false };\n } catch {\n // Pre-encryption rows stored raw secret strings (e.g. a bare\n // `custom_providers.api_key`), not JSON. Treat the raw string as the\n // value and flag it so migration rewrites it in the current format.\n return { value: value as T, needsReencryption: true };\n }\n },\n };\n}\n"],"mappings":"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"}
@@ -1,4 +1,6 @@
1
1
  import type { AgentControllerEvent } from '@mastra/core/agent-controller';
2
+ import type { PubSub } from '@mastra/core/events';
3
+ import type { SourceControlSession } from '../storage/domains/source-control/base.js';
2
4
  /** The slice of a live session this registry needs: its id, its run, its parked tools, and who it works for. */
3
5
  export interface LiveSession {
4
6
  readonly identity: {
@@ -22,10 +24,14 @@ export interface LiveSession {
22
24
  };
23
25
  subscribe(listener: (event: AgentControllerEvent) => void): () => void;
24
26
  }
25
- interface SessionNotifier {
27
+ export interface SessionNotifier {
26
28
  onSessionCreated(listener: (session: LiveSession) => void): () => void;
27
29
  onSessionDeleted(listener: (session: LiveSession) => void): () => void;
28
30
  }
31
+ /** Where a session's Factory is written down for good: its live state can lose it, its row cannot. */
32
+ export interface SessionRows {
33
+ getBySessionId(sessionId: string): Promise<Pick<SourceControlSession, 'orgId' | 'factoryProjectId'> | null>;
34
+ }
29
35
  /** The tool a session has waited on longest, and since when (epoch ms). */
30
36
  export interface ParkedRun {
31
37
  toolName: string;
@@ -56,8 +62,9 @@ export declare class LiveSessions {
56
62
  sessionId: string;
57
63
  run: ParkedRun;
58
64
  }>;
59
- /** Fires when a session parks, is answered, or finishes a turn: whoever shows parked runs re-reads. */
60
- onParkedChanged(listener: (session: LiveSession) => void): () => void;
65
+ /** Fires when a session starts a run, parks, is answered, finishes a turn, or leaves its thread: whoever shows runs re-reads. */
66
+ onRunChanged(listener: (session: LiveSession) => void): () => void;
61
67
  }
62
- export {};
68
+ /** A run starting, parking, being answered or ending changes what boards show, so the registry bumps the project's feed. */
69
+ export declare function liveSessionsTouchingTheFeed(controller: SessionNotifier, eventBus: PubSub, rows: SessionRows): LiveSessions;
63
70
  //# sourceMappingURL=live-sessions.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"live-sessions.d.ts","sourceRoot":"","sources":["../../src/session/live-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,gHAAgH;AAChH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE;QAAE,KAAK,IAAI,MAAM,CAAA;KAAE,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE;QAAE,SAAS,IAAI,OAAO,CAAA;KAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE;QAAE,GAAG,IAAI,QAAQ,CAAC;YAAE,YAAY,CAAC,EAAE,MAAM,CAAC;YAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC1F,QAAQ,CAAC,YAAY,EAAE;QAAE,GAAG,IAAI;YAAE,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;IACpG,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACxE;AAED,UAAU,eAAe;IACvB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACxE;AAED,2EAA2E;AAC3E,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AASD;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;;IAMvB,YAAY,UAAU,EAAE,eAAe,EAStC;IAmBD,gEAAgE;IAChE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEpC;IAED,0FAA0F;IAC1F,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAS/C;IAED,wFAAwF;IACxF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,SAAS,CAAA;KAAE,CAAC,CAQ/E;IAED,uGAAuG;IACvG,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAGpE;CACF"}
1
+ {"version":3,"file":"live-sessions.d.ts","sourceRoot":"","sources":["../../src/session/live-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEtF,gHAAgH;AAChH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE;QAAE,KAAK,IAAI,MAAM,CAAA;KAAE,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE;QAAE,SAAS,IAAI,OAAO,CAAA;KAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE;QAAE,GAAG,IAAI,QAAQ,CAAC;YAAE,YAAY,CAAC,EAAE,MAAM,CAAC;YAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC1F,QAAQ,CAAC,YAAY,EAAE;QAAE,GAAG,IAAI;YAAE,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;IACpG,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACxE;AAED,sGAAsG;AACtG,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,kBAAkB,CAAC,GAAG,IAAI,CAAC,CAAC;CAC7G;AAED,2EAA2E;AAC3E,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAoBD;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;;IAMvB,YAAY,UAAU,EAAE,eAAe,EAStC;IAmBD,gEAAgE;IAChE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEpC;IAED,0FAA0F;IAC1F,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAS/C;IAED,wFAAwF;IACxF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,SAAS,CAAA;KAAE,CAAC,CAQ/E;IAED,iIAAiI;IACjI,YAAY,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAGjE;CACF;AAED,4HAA4H;AAC5H,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,eAAe,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,GAChB,YAAY,CAiBd"}
@@ -1,5 +1,16 @@
1
+ import { touchFeed } from "../feed-events.js";
1
2
  // src/session/live-sessions.ts
2
3
  /**
4
+ * Events after which the controller may list different runs for a session, beyond the parking ones.
5
+ * Leaving a thread drops the run the session started on it, and no `agent_end` reaches a session that has left.
6
+ */
7
+ const RUN_MAY_HAVE_CHANGED = /* @__PURE__ */ new Set([
8
+ "agent_start",
9
+ "thread_changed",
10
+ "thread_created",
11
+ "thread_deleted"
12
+ ]);
13
+ /**
3
14
  * The sessions this process has materialized, by session id.
4
15
  *
5
16
  * Membership comes from the controller's notifications rather than
@@ -14,17 +25,16 @@
14
25
  */
15
26
  var LiveSessions = class {
16
27
  #byId = /* @__PURE__ */ new Map();
17
- #parkedListeners = /* @__PURE__ */ new Set();
28
+ #runListeners = /* @__PURE__ */ new Set();
18
29
  /** A park stamp doubles as the receipt key, so two suspensions in one millisecond must not share one. */
19
30
  #lastParkStamp = 0;
20
31
  constructor(controller) {
21
32
  controller.onSessionCreated((session) => this.#track(session));
22
33
  controller.onSessionDeleted((session) => {
23
34
  const id = session.identity.getId();
24
- const wasParked = this.parked(id) !== void 0;
25
35
  this.#byId.get(id)?.unsubscribe();
26
36
  this.#byId.delete(id);
27
- if (wasParked) for (const listener of this.#parkedListeners) listener(session);
37
+ for (const listener of this.#runListeners) listener(session);
28
38
  });
29
39
  }
30
40
  #nextParkStamp() {
@@ -37,8 +47,8 @@ var LiveSessions = class {
37
47
  if (event.type === "tool_suspended") suspendedAt.set(event.toolCallId, this.#nextParkStamp());
38
48
  else if (event.type === "tool_suspension_cancelled") suspendedAt.delete(event.toolCallId);
39
49
  else if (event.type === "agent_end" && event.reason !== "suspended") suspendedAt.clear();
40
- else return;
41
- for (const listener of this.#parkedListeners) listener(session);
50
+ else if (!RUN_MAY_HAVE_CHANGED.has(event.type)) return;
51
+ for (const listener of this.#runListeners) listener(session);
42
52
  });
43
53
  this.#byId.set(session.identity.getId(), {
44
54
  session,
@@ -78,12 +88,33 @@ var LiveSessions = class {
78
88
  }
79
89
  return parked;
80
90
  }
81
- /** Fires when a session parks, is answered, or finishes a turn: whoever shows parked runs re-reads. */
82
- onParkedChanged(listener) {
83
- this.#parkedListeners.add(listener);
84
- return () => this.#parkedListeners.delete(listener);
91
+ /** Fires when a session starts a run, parks, is answered, finishes a turn, or leaves its thread: whoever shows runs re-reads. */
92
+ onRunChanged(listener) {
93
+ this.#runListeners.add(listener);
94
+ return () => this.#runListeners.delete(listener);
85
95
  }
86
96
  };
87
- export { LiveSessions };
97
+ /** A run starting, parking, being answered or ending changes what boards show, so the registry bumps the project's feed. */
98
+ function liveSessionsTouchingTheFeed(controller, eventBus, rows) {
99
+ const liveSessions = new LiveSessions(controller);
100
+ liveSessions.onRunChanged((session) => {
101
+ const { factoryOrgId, factoryProjectId } = session.state.get();
102
+ if (factoryOrgId && factoryProjectId) {
103
+ touchFeed(eventBus, {
104
+ orgId: factoryOrgId,
105
+ factoryProjectId
106
+ });
107
+ return;
108
+ }
109
+ rows.getBySessionId(session.identity.getId()).then((row) => {
110
+ if (row?.factoryProjectId) touchFeed(eventBus, {
111
+ orgId: row.orgId,
112
+ factoryProjectId: row.factoryProjectId
113
+ });
114
+ }).catch((error) => console.warn("[factory] Unable to find the board of a session run.", error));
115
+ });
116
+ return liveSessions;
117
+ }
118
+ export { LiveSessions, liveSessionsTouchingTheFeed };
88
119
 
89
120
  //# sourceMappingURL=live-sessions.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"live-sessions.js","names":[],"sources":["../../src/session/live-sessions.ts"],"sourcesContent":["import type { AgentControllerEvent } from '@mastra/core/agent-controller';\n\n/** The slice of a live session this registry needs: its id, its run, its parked tools, and who it works for. */\nexport interface LiveSession {\n readonly identity: { getId(): string };\n readonly run: { isRunning(): boolean };\n readonly state: { get(): Readonly<{ factoryOrgId?: string; factoryProjectId?: string }> };\n readonly displayState: { get(): { pendingSuspensions: ReadonlyMap<string, { toolName: string }> } };\n subscribe(listener: (event: AgentControllerEvent) => void): () => void;\n}\n\ninterface SessionNotifier {\n onSessionCreated(listener: (session: LiveSession) => void): () => void;\n onSessionDeleted(listener: (session: LiveSession) => void): () => void;\n}\n\n/** The tool a session has waited on longest, and since when (epoch ms). */\nexport interface ParkedRun {\n toolName: string;\n suspendedAt: number;\n}\n\ninterface TrackedSession {\n session: LiveSession;\n seenAt: number;\n suspendedAt: Map<string, number>;\n unsubscribe: () => void;\n}\n\n/**\n * The sessions this process has materialized, by session id.\n *\n * Membership comes from the controller's notifications rather than\n * `getSession`, which hands back the pending creation — awaiting it\n * from a request blocks for as long as the session takes to materialize its\n * sandbox, minutes on a cold clone. Notifications only fire once a session\n * exists, so a read never waits.\n *\n * Whether a session is *running* or *parked* is read from the session itself,\n * never tracked here: no missed run event can leave the answer stuck. Only the\n * moment each suspension arrived is kept, since the session does not date them.\n */\nexport class LiveSessions {\n readonly #byId = new Map<string, TrackedSession>();\n readonly #parkedListeners = new Set<(session: LiveSession) => void>();\n /** A park stamp doubles as the receipt key, so two suspensions in one millisecond must not share one. */\n #lastParkStamp = 0;\n\n constructor(controller: SessionNotifier) {\n controller.onSessionCreated(session => this.#track(session));\n controller.onSessionDeleted(session => {\n const id = session.identity.getId();\n const wasParked = this.parked(id) !== undefined;\n this.#byId.get(id)?.unsubscribe();\n this.#byId.delete(id);\n if (wasParked) for (const listener of this.#parkedListeners) listener(session);\n });\n }\n\n #nextParkStamp(): number {\n this.#lastParkStamp = Math.max(Date.now(), this.#lastParkStamp + 1);\n return this.#lastParkStamp;\n }\n\n #track(session: LiveSession): void {\n const suspendedAt = new Map<string, number>();\n const unsubscribe = session.subscribe(event => {\n if (event.type === 'tool_suspended') suspendedAt.set(event.toolCallId, this.#nextParkStamp());\n else if (event.type === 'tool_suspension_cancelled') suspendedAt.delete(event.toolCallId);\n else if (event.type === 'agent_end' && event.reason !== 'suspended') suspendedAt.clear();\n else return;\n for (const listener of this.#parkedListeners) listener(session);\n });\n this.#byId.set(session.identity.getId(), { session, seenAt: Date.now(), suspendedAt, unsubscribe });\n }\n\n /** Whether the session has an agent run in flight right now. */\n isRunning(sessionId: string): boolean {\n return this.#byId.get(sessionId)?.session.run.isRunning() ?? false;\n }\n\n /** The tool the session is parked on, oldest first, or nothing when no answer is owed. */\n parked(sessionId: string): ParkedRun | undefined {\n const tracked = this.#byId.get(sessionId);\n if (!tracked) return undefined;\n let oldest: ParkedRun | undefined;\n for (const [toolCallId, { toolName }] of tracked.session.displayState.get().pendingSuspensions) {\n const suspendedAt = tracked.suspendedAt.get(toolCallId) ?? tracked.seenAt;\n if (!oldest || suspendedAt < oldest.suspendedAt) oldest = { toolName, suspendedAt };\n }\n return oldest;\n }\n\n /** Every parked session of a project, so the inbox reads no card when nothing waits. */\n parkedIn(factoryProjectId: string): Array<{ sessionId: string; run: ParkedRun }> {\n const parked: Array<{ sessionId: string; run: ParkedRun }> = [];\n for (const [sessionId, tracked] of this.#byId) {\n if (tracked.session.state.get().factoryProjectId !== factoryProjectId) continue;\n const run = this.parked(sessionId);\n if (run) parked.push({ sessionId, run });\n }\n return parked;\n }\n\n /** Fires when a session parks, is answered, or finishes a turn: whoever shows parked runs re-reads. */\n onParkedChanged(listener: (session: LiveSession) => void): () => void {\n this.#parkedListeners.add(listener);\n return () => this.#parkedListeners.delete(listener);\n }\n}\n"],"mappings":";;;;;;;;;;;;;;AA0CA,IAAa,eAAb,MAA0B;CACxB,wBAAiB,IAAI,IAA4B;CACjD,mCAA4B,IAAI,IAAoC;;CAEpE,iBAAiB;CAEjB,YAAY,YAA6B;EACvC,WAAW,kBAAiB,YAAW,KAAK,OAAO,OAAO,CAAC;EAC3D,WAAW,kBAAiB,YAAW;GACrC,MAAM,KAAK,QAAQ,SAAS,MAAM;GAClC,MAAM,YAAY,KAAK,OAAO,EAAE,MAAM,KAAA;GACtC,KAAK,MAAM,IAAI,EAAE,CAAC,EAAE,YAAY;GAChC,KAAK,MAAM,OAAO,EAAE;GACpB,IAAI,WAAW,KAAK,MAAM,YAAY,KAAK,kBAAkB,SAAS,OAAO;EAC/E,CAAC;CACH;CAEA,iBAAyB;EACvB,KAAK,iBAAiB,KAAK,IAAI,KAAK,IAAI,GAAG,KAAK,iBAAiB,CAAC;EAClE,OAAO,KAAK;CACd;CAEA,OAAO,SAA4B;EACjC,MAAM,8BAAc,IAAI,IAAoB;EAC5C,MAAM,cAAc,QAAQ,WAAU,UAAS;GAC7C,IAAI,MAAM,SAAS,kBAAkB,YAAY,IAAI,MAAM,YAAY,KAAK,eAAe,CAAC;QACvF,IAAI,MAAM,SAAS,6BAA6B,YAAY,OAAO,MAAM,UAAU;QACnF,IAAI,MAAM,SAAS,eAAe,MAAM,WAAW,aAAa,YAAY,MAAM;QAClF;GACL,KAAK,MAAM,YAAY,KAAK,kBAAkB,SAAS,OAAO;EAChE,CAAC;EACD,KAAK,MAAM,IAAI,QAAQ,SAAS,MAAM,GAAG;GAAE;GAAS,QAAQ,KAAK,IAAI;GAAG;GAAa;EAAY,CAAC;CACpG;;CAGA,UAAU,WAA4B;EACpC,OAAO,KAAK,MAAM,IAAI,SAAS,CAAC,EAAE,QAAQ,IAAI,UAAU,KAAK;CAC/D;;CAGA,OAAO,WAA0C;EAC/C,MAAM,UAAU,KAAK,MAAM,IAAI,SAAS;EACxC,IAAI,CAAC,SAAS,OAAO,KAAA;EACrB,IAAI;EACJ,KAAK,MAAM,CAAC,YAAY,EAAE,eAAe,QAAQ,QAAQ,aAAa,IAAI,CAAC,CAAC,oBAAoB;GAC9F,MAAM,cAAc,QAAQ,YAAY,IAAI,UAAU,KAAK,QAAQ;GACnE,IAAI,CAAC,UAAU,cAAc,OAAO,aAAa,SAAS;IAAE;IAAU;GAAY;EACpF;EACA,OAAO;CACT;;CAGA,SAAS,kBAAwE;EAC/E,MAAM,SAAuD,CAAC;EAC9D,KAAK,MAAM,CAAC,WAAW,YAAY,KAAK,OAAO;GAC7C,IAAI,QAAQ,QAAQ,MAAM,IAAI,CAAC,CAAC,qBAAqB,kBAAkB;GACvE,MAAM,MAAM,KAAK,OAAO,SAAS;GACjC,IAAI,KAAK,OAAO,KAAK;IAAE;IAAW;GAAI,CAAC;EACzC;EACA,OAAO;CACT;;CAGA,gBAAgB,UAAsD;EACpE,KAAK,iBAAiB,IAAI,QAAQ;EAClC,aAAa,KAAK,iBAAiB,OAAO,QAAQ;CACpD;AACF"}
1
+ {"version":3,"file":"live-sessions.js","names":[],"sources":["../../src/session/live-sessions.ts"],"sourcesContent":["import type { AgentControllerEvent } from '@mastra/core/agent-controller';\nimport type { PubSub } from '@mastra/core/events';\n\nimport { touchFeed } from '../feed-events.js';\nimport type { SourceControlSession } from '../storage/domains/source-control/base.js';\n\n/** The slice of a live session this registry needs: its id, its run, its parked tools, and who it works for. */\nexport interface LiveSession {\n readonly identity: { getId(): string };\n readonly run: { isRunning(): boolean };\n readonly state: { get(): Readonly<{ factoryOrgId?: string; factoryProjectId?: string }> };\n readonly displayState: { get(): { pendingSuspensions: ReadonlyMap<string, { toolName: string }> } };\n subscribe(listener: (event: AgentControllerEvent) => void): () => void;\n}\n\nexport interface SessionNotifier {\n onSessionCreated(listener: (session: LiveSession) => void): () => void;\n onSessionDeleted(listener: (session: LiveSession) => void): () => void;\n}\n\n/** Where a session's Factory is written down for good: its live state can lose it, its row cannot. */\nexport interface SessionRows {\n getBySessionId(sessionId: string): Promise<Pick<SourceControlSession, 'orgId' | 'factoryProjectId'> | null>;\n}\n\n/** The tool a session has waited on longest, and since when (epoch ms). */\nexport interface ParkedRun {\n toolName: string;\n suspendedAt: number;\n}\n\ninterface TrackedSession {\n session: LiveSession;\n seenAt: number;\n suspendedAt: Map<string, number>;\n unsubscribe: () => void;\n}\n\n/**\n * Events after which the controller may list different runs for a session, beyond the parking ones.\n * Leaving a thread drops the run the session started on it, and no `agent_end` reaches a session that has left.\n */\nconst RUN_MAY_HAVE_CHANGED = new Set<AgentControllerEvent['type']>([\n 'agent_start',\n 'thread_changed',\n 'thread_created',\n 'thread_deleted',\n]);\n\n/**\n * The sessions this process has materialized, by session id.\n *\n * Membership comes from the controller's notifications rather than\n * `getSession`, which hands back the pending creation — awaiting it\n * from a request blocks for as long as the session takes to materialize its\n * sandbox, minutes on a cold clone. Notifications only fire once a session\n * exists, so a read never waits.\n *\n * Whether a session is *running* or *parked* is read from the session itself,\n * never tracked here: no missed run event can leave the answer stuck. Only the\n * moment each suspension arrived is kept, since the session does not date them.\n */\nexport class LiveSessions {\n readonly #byId = new Map<string, TrackedSession>();\n readonly #runListeners = new Set<(session: LiveSession) => void>();\n /** A park stamp doubles as the receipt key, so two suspensions in one millisecond must not share one. */\n #lastParkStamp = 0;\n\n constructor(controller: SessionNotifier) {\n controller.onSessionCreated(session => this.#track(session));\n controller.onSessionDeleted(session => {\n const id = session.identity.getId();\n this.#byId.get(id)?.unsubscribe();\n this.#byId.delete(id);\n // The controller resets the run before it reports the deletion, so the session can no longer say a board showed it.\n for (const listener of this.#runListeners) listener(session);\n });\n }\n\n #nextParkStamp(): number {\n this.#lastParkStamp = Math.max(Date.now(), this.#lastParkStamp + 1);\n return this.#lastParkStamp;\n }\n\n #track(session: LiveSession): void {\n const suspendedAt = new Map<string, number>();\n const unsubscribe = session.subscribe(event => {\n if (event.type === 'tool_suspended') suspendedAt.set(event.toolCallId, this.#nextParkStamp());\n else if (event.type === 'tool_suspension_cancelled') suspendedAt.delete(event.toolCallId);\n else if (event.type === 'agent_end' && event.reason !== 'suspended') suspendedAt.clear();\n else if (!RUN_MAY_HAVE_CHANGED.has(event.type)) return;\n for (const listener of this.#runListeners) listener(session);\n });\n this.#byId.set(session.identity.getId(), { session, seenAt: Date.now(), suspendedAt, unsubscribe });\n }\n\n /** Whether the session has an agent run in flight right now. */\n isRunning(sessionId: string): boolean {\n return this.#byId.get(sessionId)?.session.run.isRunning() ?? false;\n }\n\n /** The tool the session is parked on, oldest first, or nothing when no answer is owed. */\n parked(sessionId: string): ParkedRun | undefined {\n const tracked = this.#byId.get(sessionId);\n if (!tracked) return undefined;\n let oldest: ParkedRun | undefined;\n for (const [toolCallId, { toolName }] of tracked.session.displayState.get().pendingSuspensions) {\n const suspendedAt = tracked.suspendedAt.get(toolCallId) ?? tracked.seenAt;\n if (!oldest || suspendedAt < oldest.suspendedAt) oldest = { toolName, suspendedAt };\n }\n return oldest;\n }\n\n /** Every parked session of a project, so the inbox reads no card when nothing waits. */\n parkedIn(factoryProjectId: string): Array<{ sessionId: string; run: ParkedRun }> {\n const parked: Array<{ sessionId: string; run: ParkedRun }> = [];\n for (const [sessionId, tracked] of this.#byId) {\n if (tracked.session.state.get().factoryProjectId !== factoryProjectId) continue;\n const run = this.parked(sessionId);\n if (run) parked.push({ sessionId, run });\n }\n return parked;\n }\n\n /** Fires when a session starts a run, parks, is answered, finishes a turn, or leaves its thread: whoever shows runs re-reads. */\n onRunChanged(listener: (session: LiveSession) => void): () => void {\n this.#runListeners.add(listener);\n return () => this.#runListeners.delete(listener);\n }\n}\n\n/** A run starting, parking, being answered or ending changes what boards show, so the registry bumps the project's feed. */\nexport function liveSessionsTouchingTheFeed(\n controller: SessionNotifier,\n eventBus: PubSub,\n rows: SessionRows,\n): LiveSessions {\n const liveSessions = new LiveSessions(controller);\n liveSessions.onRunChanged(session => {\n const { factoryOrgId, factoryProjectId } = session.state.get();\n if (factoryOrgId && factoryProjectId) {\n touchFeed(eventBus, { orgId: factoryOrgId, factoryProjectId });\n return;\n }\n // Only a Factory run carries its project in state, and a recovered one can come back without it: its row names it.\n rows\n .getBySessionId(session.identity.getId())\n .then(row => {\n if (row?.factoryProjectId) touchFeed(eventBus, { orgId: row.orgId, factoryProjectId: row.factoryProjectId });\n })\n .catch(error => console.warn('[factory] Unable to find the board of a session run.', error));\n });\n return liveSessions;\n}\n"],"mappings":"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"}
@@ -1,13 +1,15 @@
1
1
  import type { RequestContext } from '@mastra/core/request-context';
2
- import type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';
2
+ import type { ProjectBoardSource } from '../boards/project-boards.js';
3
+ import type { BoardRegistry } from '../boards/registry.js';
3
4
  import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
4
5
  /**
5
- * The head self-review approved for the session's Work card, which a change request must open
6
- * at. `undefined` leaves the change request ungated; `null` blocks it until self-review approves.
6
+ * The head self-review approved for the session's card, which a change request must open at.
7
+ * `undefined` leaves the change request ungated (the card's board has no self-review phase);
8
+ * `null` blocks it until self-review approves.
7
9
  */
8
10
  export declare function selfReviewApprovedHead(options: {
9
11
  requestContext: RequestContext | undefined;
10
12
  workItems: WorkItemsStorage;
11
- projects: FactoryProjectsStorage;
13
+ boards: BoardRegistry | ProjectBoardSource;
12
14
  }): Promise<string | null | undefined>;
13
15
  //# sourceMappingURL=self-review-gate.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"self-review-gate.d.ts","sourceRoot":"","sources":["../../src/session/self-review-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,cAAc,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,sBAAsB,CAAC;CAClC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAmBrC"}
1
+ {"version":3,"file":"self-review-gate.d.ts","sourceRoot":"","sources":["../../src/session/self-review-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,cAAc,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC;CAC5C,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAerC"}